diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml index 258d777e..b184026f 100644 --- a/.github/FUNDING.yml +++ b/.github/FUNDING.yml @@ -1 +1 @@ -github: raiseCatError +github: [raiseCatError] diff --git a/AGENTS.md b/AGENTS.md index 8ae9ad42..87c493d5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -62,8 +62,8 @@ Released (0.16.0): a real ShellAdapter with zsh, Fish and Bash 4.4+ backends ([d - Installs are typed argv shown before confirmation; special installers are never run by NMSh. - Chroma never reaches generated external artifacts. -## Current surfaces (v0.17.0 release candidate) -Theme Studio (`/theme`), Theme Bridge (`/theme-bridge`), `/providers`, `/tools` with filesystem-detected shell frameworks, `/configure`, `/tmux` Config Studio, `/integrations`, `/dotfiles`, the Oh My Posh provider, and Keep Awake (`/caffeinate`, `/awake`, `/zoomies`, with composer-edge, Status Strip, idle-reminder and screensaver presentation). Context Engine fact metadata, native module routing and Context Rail are also implemented. See CHANGELOG.md → 0.17.0; tagging and publication are pending. +## Current surfaces (released in v0.17.0) +Theme Studio (`/theme`), Theme Bridge (`/theme-bridge`), `/providers`, `/tools` with filesystem-detected shell frameworks, `/configure`, `/tmux` Config Studio, `/integrations`, `/dotfiles`, the Oh My Posh provider, and Keep Awake (`/caffeinate`, `/awake`, `/zoomies`, with composer-edge, Status Strip, idle-reminder and screensaver presentation). Context Engine fact metadata, native module routing and Context Rail are also implemented. See CHANGELOG.md → 0.17.0. ## Testing / verification During implementation, run focused affected tests. Use `npm run verify:fast` for @@ -124,9 +124,9 @@ Key references: - [ARCHITECTURE.md](ARCHITECTURE.md) — the human-readable architecture overview (runtime and data flows, repository map); deeper detail in `docs/architecture/` and `docs/design/` - [ROADMAP.md](ROADMAP.md) — product direction and issue index - [GitHub Issues](https://github.com/raiseCatError/notMyShell/issues) — actionable work -- [v0.16.0 Release](https://github.com/raiseCatError/notMyShell/releases/tag/v0.16.0) — current stable release +- [v0.17.0 Release](https://github.com/raiseCatError/notMyShell/releases/tag/v0.17.0) — current stable release - [PR #303](https://github.com/raiseCatError/notMyShell/pull/303) — the merged cumulative v0.16 release -- [PR #322](https://github.com/raiseCatError/notMyShell/pull/322) — merged checkpoint on master; package 0.17.0 is the release candidate, not yet tagged or published +- [PR #322](https://github.com/raiseCatError/notMyShell/pull/322) — merged checkpoint on master; included in the published v0.17.0 release - [GitHub Project](https://github.com/users/raiseCatError/projects/1) — live development status board - [docs/architecture/terminal-stack.md](docs/architecture/terminal-stack.md) — terminology and stack model - [docs/design/structured-execution.md](docs/design/structured-execution.md) — v0.2.0 design decisions diff --git a/CHANGELOG.md b/CHANGELOG.md index 7f18462d..a9813d9b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -82,7 +82,7 @@ Context Engine, Themes & Discovery: native context routing and Rail foundations, ### Updates and sessions - **Automatic updates** (Automatic / Notify only / Off, Daily or Weekly). New installs default to Automatic / Daily; saved Daily/Weekly checks migrate to Notify only and Off stays Off. Automatic prepares a verified stable release only where `/update apply`'s own checks pass, with the same build verification and rollback; the running session keeps its version. Status shows Running version, Latest, Mode and State. -- Homebrew install provenance prevents the source-checkout updater from mutating the Cellar. Homebrew distribution is still being prepared and is not yet available; publishing remains disabled. +- Homebrew install provenance prevents the source-checkout updater from mutating the Cellar. Homebrew distribution is now available through `brew install raiseCatError/tap/nmsh`; automated publishing from this repository remains disabled. - Detached sessions can be ended from the startup picker with `X` and confirmation; the transcript is archived and stays in `/resume`. ## [0.16.0] - 2026-10-04 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index dc252d88..12728a8c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -20,8 +20,8 @@ Before starting work, check: - **[ARCHITECTURE.md](ARCHITECTURE.md)** — how the pieces fit together; start here before changing a subsystem - **[ROADMAP.md](ROADMAP.md)** — product direction and what is planned - **[GitHub Issues](https://github.com/raiseCatError/notMyShell/issues)** — concrete actionable work; acceptance criteria in each issue are authoritative -- **[v0.16.0 Release](https://github.com/raiseCatError/notMyShell/releases/tag/v0.16.0)** — current stable release -- **[PR #322](https://github.com/raiseCatError/notMyShell/pull/322)** — merged master checkpoint for the v0.17.0 release candidate (tagging and publication pending; see [ROADMAP.md](ROADMAP.md)) +- **[v0.17.0 Release](https://github.com/raiseCatError/notMyShell/releases/tag/v0.17.0)** — current stable release +- **[PR #322](https://github.com/raiseCatError/notMyShell/pull/322)** — merged master checkpoint for the published v0.17.0 release (see [ROADMAP.md](ROADMAP.md)) - **GitHub Project** — [NMSh Development](https://github.com/users/raiseCatError/projects/1) — live development status board ## Branch Model diff --git a/README.md b/README.md index 9708e6e4..cd24424b 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ **notMyShell (NMSh)** runs your real zsh, Bash or Fish in a persistent session and gives it a better front end: a composer that stays put, semantic highlighting, a readable transcript, live command feedback, sessions that survive closing the window, and themes that can reach the tools you use. -Latest published stable release: [v0.16.0 — Sessions, Agents & Portability](https://github.com/raiseCatError/notMyShell/releases/tag/v0.16.0). The `master` branch contains the prepared **v0.17.0 — Context Engine, Themes & Discovery** release candidate; tagging and publication are pending. See the [changelog](CHANGELOG.md#0170---2026-10-06) for its implemented scope. +Latest published stable release: [v0.17.0 — Context Engine, Themes & Discovery](https://github.com/raiseCatError/notMyShell/releases/tag/v0.17.0). The `master` branch includes this released work. See the [changelog](CHANGELOG.md#0170---2026-10-06) for its implemented scope. ## See notMyShell in motion @@ -64,7 +64,7 @@ NMSh is a **frontend**. Your shell stays underneath and does what it always did: The current engineering focus is NMSh's native module ecosystem: trusted capabilities resolve contextual facts, modules turn those facts into presentation, and a Surface Router places them in the Main Prompt, Context Rail or Right Context. -The v0.17.0 release candidate implements fact metadata, native module routing and the Context Rail. Installable, declarative Context Packs are upcoming; they are not an executable plugin API. Entering a repository must never execute arbitrary repository-controlled code through context discovery. +v0.17.0 implements fact metadata, native module routing and the Context Rail. Installable, declarative Context Packs are upcoming; they are not an executable plugin API. Entering a repository must never execute arbitrary repository-controlled code through context discovery. Read the [Context Modules guide](docs/architecture/context-modules.md) for the implemented surfaces, discovery boundaries and pack direction, or the [roadmap](ROADMAP.md#current-engineering-focus--native-modules-and-context-engine) for what remains. @@ -103,9 +103,7 @@ The gallery uses wide, opaque recordings from the real NMSh build, with a dispos ### Homebrew -> Homebrew support is being prepared for v0.17.0. These instructions are not available yet; use the source installation below until the published formula has passed installation, formula tests and interactive startup validation. - -Homebrew is the recommended install method on macOS once the v0.17.0 formula is published and validated. +Homebrew is the recommended install method on macOS. ```sh brew install raiseCatError/tap/nmsh diff --git a/ROADMAP.md b/ROADMAP.md index c21d0db4..cc92de70 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -4,23 +4,23 @@ | | | |---|---| -| **Current release** | [v0.16.0 — Sessions, Agents & Portability](https://github.com/raiseCatError/notMyShell/releases/tag/v0.16.0) — released | -| **Prepared release candidate** | v0.17.0 — Context Engine, Themes & Discovery; on `master`, tagging and publication pending | -| **Current engineering focus** | [#305 — Native modules / Context Engine](https://github.com/raiseCatError/notMyShell/issues/305); foundation and Context Rail implemented on `master` in the v0.17.0 release candidate | -| **Included in the release candidate** | Theme Studio, Theme Bridge, tool configuration, shell frameworks, Keep Awake and Context Engine foundation; merged through [PR #322](https://github.com/raiseCatError/notMyShell/pull/322), see CHANGELOG → 0.17.0 | +| **Current release** | [v0.17.0 — Context Engine, Themes & Discovery](https://github.com/raiseCatError/notMyShell/releases/tag/v0.17.0) — released | +| **macOS distribution** | Homebrew: `brew install raiseCatError/tap/nmsh`; source installation remains available | +| **Current engineering focus** | [#305 — Native modules / Context Engine](https://github.com/raiseCatError/notMyShell/issues/305); foundation and Context Rail implemented on `master` in the v0.17.0 release | +| **Included in v0.17.0** | Theme Studio, Theme Bridge, tool configuration, shell frameworks, Keep Awake and Context Engine foundation; merged through [PR #322](https://github.com/raiseCatError/notMyShell/pull/322), see CHANGELOG → 0.17.0 | | **Unscheduled** | [Future / Backlog](https://github.com/raiseCatError/notMyShell/milestone/7) | | **Development branch** | `dev` | | **Project board** | [NMSh Development](https://github.com/users/raiseCatError/projects/1) | -GitHub issues define actionable remaining work. Closed issues represent completed work, not a promise that future refinements are finished. The latest published release is 0.16.0; the package on `master` is the 0.17.0 release candidate. +GitHub issues define actionable remaining work. Closed issues represent completed work, not a promise that future refinements are finished. The latest published release and package version are 0.17.0. ## Current engineering focus — native modules and Context Engine -The primary current direction is [#305](https://github.com/raiseCatError/notMyShell/issues/305): a native module ecosystem built around **Capability → Fact → Module → Surface Router → presentation surfaces**. The [Context Modules guide](docs/architecture/context-modules.md) explains the public model. The foundation is in the v0.17.0 release candidate on `master`; the broader module ecosystem remains ongoing. +The primary current direction is [#305](https://github.com/raiseCatError/notMyShell/issues/305): a native module ecosystem built around **Capability → Fact → Module → Surface Router → presentation surfaces**. The [Context Modules guide](docs/architecture/context-modules.md) explains the public model. The foundation is in the v0.17.0 release on `master`; the broader module ecosystem remains ongoing. | State | Scope | |---|---| -| Implemented in the v0.17.0 release candidate | Typed fact metadata and privacy filtering; trusted bounded metadata/Git collection; the first-party module registry; Main Prompt / Right Context / Context Rail routing; Rail geometry, priority fitting and shared previews | +| Implemented in the v0.17.0 release | Typed fact metadata and privacy filtering; trusted bounded metadata/Git collection; the first-party module registry; Main Prompt / Right Context / Context Rail routing; Rail geometry, priority fitting and shared previews | | Preserved | Existing Native module order, visibility and left/right placement; real zsh/Bash/Fish sessions; prompt snapshots and fullscreen passthrough | | Upcoming | General capability scheduling and fuller fact migration; a bounded expansion of useful first-party modules; installable declarative Context Packs with validation and policy | | Deferred | Status Strip module routing and any executable extension tier; no finalized public pack API | @@ -144,7 +144,7 @@ The work formerly planned as v0.8–v0.15 ships together with v0.16 in one cumul | Ask & Local Understanding | Deterministic Ask, optional local model (Auto by default, never downloads without a Yes), `/llm` | | Appearance | `/appearance` hub; Clean and Rich motion rendering with per-rendering tuning; cursor effects with a capability matrix; Setup Cat as the complete customization entry point; grouped Config and Status | -## Release candidate — v0.17 Context Engine, Themes & Discovery +## Released — v0.17 Context Engine, Themes & Discovery [Milestone #15](https://github.com/raiseCatError/notMyShell/milestone/15). Code and automated coverage for `Relevant here`, package-manager plans with bulk install, activation detection, host profiles, Linux/WSL hardening, automatic update staging and startup session kill. Physical validation in iTerm2, Kitty, WezTerm, Linux and WSL 2 is tracked as a separate `needs-human-test` follow-up and does not block the release. @@ -160,7 +160,7 @@ The work formerly planned as v0.8–v0.15 ships together with v0.16 in one cumul | Release | Theme | Tracker | |---|---|---| -| v0.18.0 | Theme Bridge and semantic terminal integration | [#304](https://github.com/raiseCatError/notMyShell/issues/304), core Theme Bridge and host semantics are included in the v0.17.0 release candidate; remaining refinements follow in focused slices. Still deferred: terminal title ownership (OSC 0/2), delta custom styles, terminal emulator and editor base-theme takeover. | +| v0.18.0 | Theme Bridge and semantic terminal integration | [#304](https://github.com/raiseCatError/notMyShell/issues/304), core Theme Bridge and host semantics are included in the v0.17.0 release; remaining refinements follow in focused slices. Still deferred: terminal title ownership (OSC 0/2), delta custom styles, terminal emulator and editor base-theme takeover. | | v0.19.0 | NMSh Native module ecosystem: capability scheduling beyond the v0.17.0 Context Engine foundation and Rail, a bounded first-party module expansion and declarative packs | [#305](https://github.com/raiseCatError/notMyShell/issues/305) | ## Backlog — future, unscheduled diff --git a/docs/architecture/context-modules.md b/docs/architecture/context-modules.md index d44ee63b..5fe29edc 100644 --- a/docs/architecture/context-modules.md +++ b/docs/architecture/context-modules.md @@ -5,8 +5,8 @@ present useful context about that session and workspace without taking over shel execution. The Context Engine is the current engineering direction for sharing that context across NMSh's presentation surfaces. -This guide describes the v0.17.0 release candidate on `master`; tagging and -publication are pending. The latest published stable release remains v0.16.0. +This guide describes the implementation released in v0.17.0, the latest +published stable release. Installable Context Packs are a direction, not an available public extension API. ## From capability to presentation diff --git a/llms.txt b/llms.txt index f3841796..28949e25 100644 --- a/llms.txt +++ b/llms.txt @@ -1,6 +1,6 @@ # notMyShell (NMSh) -Latest published stable release: v0.16.0. Master contains the v0.17.0 release candidate; tagging and publication are pending (see CHANGELOG.md). +Latest published stable release: v0.17.0 (see CHANGELOG.md). Homebrew is the recommended macOS install: brew install raiseCatError/tap/nmsh. Source installation remains available. notMyShell is a terminal frontend that runs on top of a real persistent shell instead of replacing the shell. @@ -57,7 +57,7 @@ navigation. NMSh bridges to it (/open, /open-diff) and does not clone it. - nmsh config export/import, nmsh uninstall, nmsh doctor - NMSH_DETERMINISTIC=1 for repeatable presentation in tests and VHS demos -## Native modules / Context Engine (v0.17.0 release candidate) +## Native modules / Context Engine (v0.17.0 release) Current engineering focus: Capability → immutable Fact → Module → Surface Router → Main Prompt / Context Rail / Right Context. Core services own bounded collection; @@ -66,7 +66,7 @@ freshness, trust, sensitivity and persistence policy. The Rail is live frontend geometry, separate from transcript snapshots and the right-context anchor. The first-party module registry, fact adapter and surface routing are implemented -on master in the v0.17.0 release candidate. Installable declarative Context Packs, broader +on master in the v0.17.0 release. Installable declarative Context Packs, broader capability scheduling and Status Strip module routing remain upcoming. No finalized pack SDK or executable plugin API is available. Repository entry must never execute arbitrary repo-controlled code through discovery; metadata is parser-only and