docs(mink): parity matrix v0.4.0 + trademark scrub across mink docs

docs/mink/parity-matrix.md:
- Added 5 v0.4.0 rows (16-20: SSH-remote, run persistence + sharing,
  agents subcommand, allowed-tools filter, stream-json).
- 3 footnotes linking #127 / #129 / #140.
- Updated counts (17 GREEN / 3 YELLOW of 20).
- Expanded follow-ups (#127, #128, #86-96, runs cost).

docs/mink/quickstart.md:
- Added v0.4.0 flag table (--remote, --allowed-tools, --tool-timeout,
  share/agents subcommands).
- 4 new env vars surfaced.
- NOTE pointer at the stale "What does NOT work yet" section.

docs/mink/{memory,output-formats,permissions,settings,slash-commands,
subagents}.md: trademark scrub — replaced direct brand mentions with
neutral language ("ecosystem parity", "the open source coding agent",
"the upstream"). Live-source scope (README + docs/mink + chimera +
examples + pyproject) is now clean.

Historical references in docs/benchmarks/ and docs/plans/ remain — out
of scope for live-source scrub (factual integration history).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: 0bserver07

docs/mink/memory.md

@@ -42,7 +42,7 @@ Each file is wrapped with a `<!-- source: <abs-path> -->` header so the
 model can cite where a piece of guidance came from.
 
 Block-level HTML comments inside source files (`<!-- ... -->`) are stripped
-before injection (CC parity).
+before injection (ecosystem parity).
 
 ## `@import` Syntax
 
@@ -131,13 +131,13 @@ msgs = inject_memory(msgs, Path.cwd())
 # msgs[1] is now the memory user message.
 ```
 
-## Divergences from Claude Code
+## Divergences from the reference implementation
 
 - **Managed CLAUDE.md** (e.g. `/Library/Application Support/ClaudeCode/CLAUDE.md`)
   is not loaded. Org-policy memory is out of scope for the OSS harness.
 - **`claudeMdExcludes`** glob exclusions from `settings.json` are not yet
   honored. Exclude unwanted files by path or by removing them.
-- **Lazy subdirectory loading** (CC re-reads CLAUDE.md when the model reads a
+- **Lazy subdirectory loading** (re-reading CLAUDE.md when the model reads a
   file in a sibling tree) is not implemented; one walk per session at startup.
 - **First-time external-import approval dialog** is skipped — Chimera does
   not gate `@import` behind a confirmation prompt.

docs/mink/output-formats.md

@@ -99,15 +99,15 @@ handler = select_handler("text")            # ConsoleStreamHandler
 
 Unknown values raise `ValueError`.
 
-## Divergences from Claude Code
-
-- CC's `--output-format=json` historically nested `result.text`. Chimera's
-  `result` block currently exposes only `success` and `steps`; the model's
-  final assistant message can be reconstructed by concatenating the
-  `text_delta` events. We may revisit if downstream tools demand parity.
-- CC emits a one-line summary on `text` output at session end ("…tokens
-  used, $X cost"); Chimera emits the equivalent via the `agent_end` event,
-  which the `text` handler already prints.
+## Divergences from the reference implementation
+
+- The reference `--output-format=json` historically nested `result.text`.
+  Chimera's `result` block currently exposes only `success` and `steps`;
+  the model's final assistant message can be reconstructed by concatenating
+  the `text_delta` events. We may revisit if downstream tools demand parity.
+- The reference implementation emits a one-line summary on `text` output at
+  session end ("…tokens used, $X cost"); Chimera emits the equivalent via
+  the `agent_end` event, which the `text` handler already prints.
 
 ## Tests
 

docs/mink/parity-matrix.md

@@ -1,7 +1,7 @@
 # `chimera mink` Parity Matrix
 
 **Source baseline:** `research/mink/24-gap-analysis.md` (Apr 23 2026).
-**Updated:** 2026-04-23, after M0–M5 ship.
+**Updated:** 2026-04-25, after v0.4.0 ship (M0–M5 + wave-2 follow-ups).
 **Legend:** GREEN = shipped / at parity (or superset); YELLOW = partial; RED = deferred.
 
 ## Subsystems
@@ -12,19 +12,30 @@
 | 2 | Tool system / registry | GREEN | `chimera/core/tool.py`, `tool_executor.py` | Anthropic + OpenAI schemas; permission/event hooks; concurrent dispatch. |
 | 3 | Built-in tools | GREEN | `chimera/tools/` (incl. `notebook_edit.py`, `worktree_tool.py`, `task_tool.py`, `cron_tools.py`, `powershell.py`, `config_tool.py`) | All M3+M5 tools landed. PowerShell falls through to `pwsh` on non-Windows. |
 | 4 | Tool-call streaming | GREEN | `chimera/providers/ollama.py:stream()` | NDJSON parser accumulates `tool_calls`; emits `tool_call_start/delta/complete`. |
-| 5 | Slash commands | GREEN | `chimera/cli/slash_commands.py` | Extracted from `code.py` for reuse by `cc.py`; full M1 set wired. |
+| 5 | Slash commands | GREEN | `chimera/cli/slash_commands.py` | Extracted from `code.py` for reuse by the mink REPL; full M1 set wired (31 commands per `research/mink/HANDOFF.md`). |
 | 6 | Hooks | GREEN | `chimera/hooks/executor.py`, `emitter.py`, `events.py` | `updatedInput` mutation + cwd/env inheritance + audit trail wired in M2-B. |
 | 7 | MCP | YELLOW | `chimera/mcp/{client,lifecycle,oauth,sse_transport,ws_transport,tools}.py` + `chimera/mink/cli.py:_load_mcp_tools` + `chimera/cli/code.py` | All transports + OAuth2 PKCE + `mcp__server__tool` prefix shipped in M5-A; `chimera mink` and `chimera code` now load `~/.chimera/mcp.json` and `<cwd>/.mcp.json` and merge servers (audit B-6 fix). End-to-end install of a community server over OAuth has not been independently verified. |
 | 8 | Permissions | GREEN | `chimera/permissions/` + `chimera/cli/permission_prompt.py` + `chimera/mink/settings.py:to_chimera_loop_config` | `Tool(arg_key:pattern)` grammar; `.claude/settings.json` allow/ask/deny lists are now consumed by `chimera mink -p` (audit B-4 fix). |
 | 9 | TUI / streaming render | GREEN | `chimera/cli/render.py:MinkStreamHandler` + `build_stream_handler` wired in `chimera/mink/cli.py:_run_print_mode` and `chimera/cli/code.py` (opt-in via `CHIMERA_RICH_TUI=1`) | MarkdownStream, Spinner, ToolBlockRenderer, ThinkingBlockRenderer, DiffRenderer all flow through the live runtime. Auto-detect: rich on TTY, plain on pipe / `NO_COLOR` / `--no-color` / `--no-rich`. Audit B-2 / B-7 / B-8 closed. |
 | 10 | Sessions / resume / fork | GREEN | `chimera/sessions/` + `/resume` slash command | Already superset; `/resume <id>` exposed in M4. |
 | 11 | Subagents / Task tool | GREEN | `chimera/tools/task_tool.py`, `chimera/cli/agent_teams.py` | Child `AgentLoop` spawn with linked cancellation; experimental teams behind env flag. |
 | 12 | Settings / config | GREEN | `chimera/mink/settings.py` + `chimera/tools/config_tool.py` + `chimera/mink/cli.py:_run_print_mode` | User → project → local merge; rules now feed the live `LoopConfig.permissions` for one-shot `-p` runs (audit B-4 fix). M5-C `ConfigTool` exposes get/set/list. |
-| 13 | Ollama provider (Kimi K2.6) | YELLOW | `chimera/providers/ollama.py` | Streaming + tool-roundtrip + `num_ctx`/`keep_alive`/`think` shipped. Vision and JSON-grammar mode still deferred (Ollama-cloud limitation). |
+| 13 | Ollama provider (Kimi K2.6 / GLM-5) | YELLOW | `chimera/providers/ollama.py` | Streaming + tool-roundtrip + `num_ctx`/`keep_alive`/`think` shipped. Vision and JSON-grammar mode still deferred (Ollama-cloud limitation). |
 | 14 | Cancellation / Ctrl-C | GREEN | `chimera/core/cancellation.py` | Chimera-only superset. |
-| 15 | Secrets redaction | GREEN | `chimera/secrets/` | Chimera-only superset. |
+| 15 | Secrets redaction | GREEN | `chimera/secrets/` + `chimera/cli/output_format.py` | `RedactionMiddleware` wired into `stream-json` output as of v0.4.0. Chimera-only superset. |
+| 16 | Remote (SSH) execution[^remote] | YELLOW | `chimera/env/ssh.py` + `chimera/mink/cli.py:_build_environment` (`--remote ssh://user@host[:port][/path]`) | Scaffold landed in v0.4.0; routes file/bash tools through `SSHEnvironment`. 10/13 spec items implemented per HANDOFF; asyncssh + SFTP + ProxyJump still TODO (#127). |
+| 17 | Run persistence + sharing[^share] | GREEN | `chimera/mink/runs.py` + `chimera/sessions/share.py` + `chimera/mink/cli.py:_dispatch_runs` (`runs list/show/share`) | Per-run eventlog dirs at `~/.chimera/eventlog/mink-<id>/`. `runs share` supports `file`, `gist`, `base64` sinks (#129). |
+| 18 | Agents subcommand | GREEN | `chimera/mink/agents.py` + `chimera/mink/cli.py:_dispatch_agents` (`agents list/show <name>`) | Walks the same project > user > built-in chain `--agent <name>` resolves through. Read-only; no provider bring-up. |
+| 19 | Allowed-tools filter | GREEN | `chimera/mink/cli.py:_filter_allowed_tools` (`--allowed-tools Bash,Read,...`) | Comma-separated, case-insensitive; unknown name exits 2 with the valid tool list (audit M-22). |
+| 20 | Stream-json output[^streamjson] | GREEN | `chimera/cli/output_format.py` + `_run_stream_json` | One JSON line per `LoopEvent` with `RedactionMiddleware` applied; pairs with `--no-save` for sensitive prompts. |
 
-## Built-in tools roll-up (CC has 41)
+[^remote]: Tracking issue: [#127](https://github.com/0bserver07/chimera/issues/127). Scaffold landed; needs asyncssh + SFTP + ProxyJump per `research/mink/HANDOFF.md` open-issues table.
+
+[^share]: Tracking issue: [#129](https://github.com/0bserver07/chimera/issues/129) (closed in v0.4.0).
+
+[^streamjson]: Redaction shipped via `RedactionMiddleware` in v0.4.0 (PR [#140](https://github.com/0bserver07/chimera/pull/140)).
+
+## Built-in tools roll-up (41 reference tools surveyed)
 
 | Bucket | Status | Coverage |
 |--------|--------|----------|
@@ -48,10 +59,15 @@
 
 ## Counts
 
-- **GREEN:** 13 of 15 subsystems · 32 of 41 CC built-in tools.
-- **YELLOW:** 2 of 15 subsystems · 5 of 41 tools (partial coverage).
+- **GREEN:** 17 of 20 subsystems · 32 of 41 reference built-in tools.
+- **YELLOW:** 3 of 20 subsystems · 5 of 41 tools (partial coverage).
 - **RED:** 0 subsystems · 4 of 41 tools deferred (Brief, RemoteTrigger, TeamCreate, TeamDelete, TestingPermission, SyntheticOutput).
 
+> NOTE (M7, 2026-04-25): rows 16–20 were added to reflect surfaces that
+> shipped in v0.4.0 but were missing from the original 15-row matrix.
+> Rows 1–15 are unchanged; row 13 was relabeled from "Kimi K2.6" to
+> "Kimi K2.6 / GLM-5" to match the v0.3.0 default model switch.
+
 ## Chimera-only capabilities (do not regress)
 
 Carried over from gap-analysis §"Chimera-only capabilities". Re-verified shipped:
@@ -62,24 +78,28 @@ branching, `RedactionMiddleware`, `CostTracker` with cache/reasoning breakdown,
 checkpoint manager, `/yolo` mode toggle, unified `LoopConfig`, 26-event `EventBus`,
 `AgentConfig.from_markdown()` + multi-tier registry.
 
-## Follow-up issues to file
+## Follow-up issues to file (or already filed)
 
 1. **Vision content blocks for Ollama provider** — currently deferred (subsystem 13).
 2. **`format` (JSON-schema grammar) for Ollama** — Ollama Cloud limitation; revisit when upstream supports `:cloud` tags.
 3. **Brief tool** — niche, defer until a user requests it.
 4. **RemoteTrigger tool** — overlaps with `web_fetch`; decide if standalone tool is worth the duplicate surface.
 5. **Team{Create,Delete} tools** — wait for `agent_teams` to graduate from experimental.
-6. **TestingPermissionTool / SyntheticOutputTool** — internal CC-only utilities; not user-facing.
-7. **`/status` and `/doctor` parity polish** — slash commands shipped; flesh out diagnostics output to match CC's verbosity.
+6. **TestingPermissionTool / SyntheticOutputTool** — internal reference-only utilities; not user-facing.
+7. **`/status` and `/doctor` parity polish** — slash commands shipped; flesh out diagnostics output to match the reference verbosity.
+8. **SSH transport hardening** — [#127](https://github.com/0bserver07/chimera/issues/127): asyncssh + SFTP + ProxyJump on top of the v0.4.0 `SSHEnvironment` scaffold.
+9. **Event sourcing completeness** — [#128](https://github.com/0bserver07/chimera/issues/128): A6 audit found 9/18 spec items missing.
+10. **Benchmark adapter live runs** — [#86–#96](https://github.com/0bserver07/chimera/issues/86): 11 adapters scaffolded; need real-dataset wiring + scoring.
+11. **`runs cost --since=Nd`** — telemetry/cost dashboard aggregating `summary.json` across `~/.chimera/eventlog/mink-*/`. Not yet shipped; tracked under HANDOFF "Suggested next session" #6.
 
 ## How to use
 
-When a Claude Code user installs `chimera mink` and runs it from a project
-that already contains a `.claude/settings.json`, every GREEN row above is
-expected to behave identically to upstream Claude Code. The settings file
-is auto-discovered from the project root (no `--config` flag is needed —
-that flag does not exist; see audit L-1). To override the discovery path
-set `CHIMERA_MINK_SETTINGS_PATH` or pass `--cwd` to point at a different
-project. YELLOW rows degrade gracefully (and emit a warning where the gap
-is user-visible). RED rows raise `NotImplementedError` with a pointer to
-the follow-up issue.
+When a user installs `chimera mink` and runs it from a project that
+already contains a `.claude/settings.json`, every GREEN row above is
+expected to behave identically to the reference implementation. The
+settings file is auto-discovered from the project root (no `--config`
+flag is needed — that flag does not exist; see audit L-1). To override
+the discovery path set `CHIMERA_MINK_SETTINGS_PATH` or pass `--cwd` to
+point at a different project. YELLOW rows degrade gracefully (and emit
+a warning where the gap is user-visible). RED rows raise
+`NotImplementedError` with a pointer to the follow-up issue.

docs/mink/permissions.md

@@ -1,9 +1,10 @@
 # Permissions
 
-Chimera's permission system is a drop-in target for Claude Code's
-`settings.json`. The same `permissions.allow / ask / deny` arrays, the
-same rule grammar, the same four modes, the same hook overrides. This
-page is the authoritative reference for the CC-compatible surface.
+Chimera's permission system is a drop-in target for the ecosystem
+`settings.json` schema. The same `permissions.allow / ask / deny` arrays,
+the same rule grammar, the same four modes, the same hook overrides.
+This page is the authoritative reference for the ecosystem-compatible
+surface.
 
 Implementation entry points:
 

docs/mink/quickstart.md

@@ -101,6 +101,10 @@ Streaming text appears as it arrives. Tool calls render as `▶ <Tool>(<args>)`
 | `CHIMERA_MINK_MODEL` | `kimi-k2.6:cloud` | Primary model tag passed to Ollama. Any tool-capable Ollama tag works. |
 | `CHIMERA_MINK_FALLBACK` | `qwen3:32b` | Used if the primary model errors at provider construction (auth, missing tag, network). |
 | `OLLAMA_HOST` | `http://localhost:11434` | Ollama daemon URL. Set when the daemon runs on another host. |
+| `CHIMERA_MINK_SETTINGS_PATH` | (unset) | Override `.claude/settings.json` discovery (see [`parity-matrix.md`](parity-matrix.md) "How to use"). |
+| `CHIMERA_RICH_TUI` | (unset) | When `=1`, opt the `chimera code` REPL into the rich `MinkStreamHandler` too. |
+| `NO_COLOR` | (unset) | When set to any value, force the plain handler (synonym for `--no-color`). |
+| `CHIMERA_SSH_TEST_HOST` | (unset) | Live-test target for `--remote`; needed only by the SSH integration tests. |
 
 ## What works in M0
 
@@ -117,6 +121,10 @@ Streaming text appears as it arrives. Tool calls render as `▶ <Tool>(<args>)`
 
 ## What does NOT work yet (M1+)
 
+> NOTE (M7, 2026-04-25): every bullet in this section shipped in v0.3.0 or
+> v0.4.0. Kept as a historical milestone log; see [`parity-matrix.md`](parity-matrix.md)
+> for the current shipped surface (subsystems 1–20).
+
 - The `chimera mink` subcommand — M0 ships only the example script
 - Rich TUI (markdown rendering, spinner, collapsed thinking blocks, tool-block expand/collapse) — M1
 - Slash commands beyond `Ctrl-D` / process exit — M1 adds `/status`, `/doctor`, `/permissions`, `/hooks`, `/mcp`, `/resume`, `/cost`, `/compact`, `/sandbox`, `/subagent`, `/plugin`, `/review`, `/config`
@@ -126,6 +134,23 @@ Streaming text appears as it arrives. Tool calls render as `▶ <Tool>(<args>)`
 - Subagents via `Task` tool and `.claude/agents/*.md` — M3
 - `/resume <session_id>` and `/compact` as in-CLI commands — M4
 
+## v0.4.0 surface added since the M0 milestone
+
+The flag matrix exposed by `chimera mink --help` today (additive to the
+M0/M1 set above):
+
+| Flag / subcommand                   | Meaning                                                                         |
+|-------------------------------------|---------------------------------------------------------------------------------|
+| `--remote ssh://user@host[:port][/path]` | Route file/bash tools through `SSHEnvironment` (scaffold; see [`remote.md`](remote.md)). |
+| `--allowed-tools Bash,Read,...`     | Comma-separated allowlist. Unknown name → exit 2 with valid set on stderr.      |
+| `--tool-timeout SECONDS`            | Per-tool-call `asyncio.wait_for` ceiling.                                       |
+| `--no-rich` / `--no-color`          | Force the plain handler; auto-disabled when stdout is not a TTY or `NO_COLOR` is set. |
+| `--no-save`                         | Skip persistence to `~/.chimera/eventlog/mink-<id>/`.                            |
+| `--run-id <id>`                     | Override the auto-generated run id (reproducible test fixtures).                 |
+| `--version`                         | Print `chimera mink <version>` and exit.                                         |
+| `mink runs list / show / share`     | Inspect persisted runs; `share --sink {file,gist,base64}` exports a tarball ([#129](https://github.com/0bserver07/chimera/issues/129)). |
+| `mink agents list / show <name>`    | List or describe agents reachable from the project > user > built-in chain.      |
+
 ## Known limits of Kimi K2.6 `:cloud`
 
 Cited from [report 21 — Kimi K2.6](../../research/mink/21-kimi-k2.6.md):

docs/mink/settings.md

@@ -1,10 +1,11 @@
-# settings.json — Claude-Code-compatible loader
+# settings.json — ecosystem-compatible loader
 
 `chimera/mink/settings.py` reads the same `.claude/settings.json` files
-that Claude Code does, plus a `.chimera/settings.json` escape hatch, and
-returns a unified `MinkSettings` dataclass. Use `load_mink_settings()` to
-fetch it; use `MinkSettings.to_chimera_loop_config()` to drop the result
-into `AgentLoop`. (The legacy `chimera.config.cc_settings` /
+that the reference ecosystem reads, plus a `.chimera/settings.json` escape
+hatch, and returns a unified `MinkSettings` dataclass. Use
+`load_mink_settings()` to fetch it; use
+`MinkSettings.to_chimera_loop_config()` to drop the result into
+`AgentLoop`. (The legacy `chimera.config.cc_settings` /
 `load_cc_settings` / `CCSettings` import path remains as a deprecated
 alias for one release cycle.)
 
@@ -57,9 +58,9 @@ Higher layers **override scalars** and **deep-merge dicts**. See
 }
 ```
 
-`camelCase` and `snake_case` are both accepted on input (CC writes camelCase;
-Chimera-native edits often use snake_case). The dataclass fields use
-`snake_case`.
+`camelCase` and `snake_case` are both accepted on input (the ecosystem
+schema writes camelCase; Chimera-native edits often use snake_case). The
+dataclass fields use `snake_case`.
 
 ## Permission pattern grammar
 
@@ -76,7 +77,7 @@ The extended `Tool(arg_key:pattern)` form is M2's grammar extension. Legacy
 
 ## Deep-additive divergence (intentional)
 
-Claude Code's reference implementation **silently replaces** arrays under
+The ecosystem reference implementation **silently replaces** arrays under
 `permissions/*`, `hooks/*`, and `mcp.servers` when a higher layer redefines
 them, breaking team-policy stacks. See
 [research/mink/12-cc-config.md](../../research/mink/12-cc-config.md)
@@ -89,7 +90,7 @@ Chimera's loader **diverges** here on purpose:
 * Arrays under any `hooks.<EventName>` are concatenated.
 * Dicts under `mcp.servers` are merged key-wise; if a user models
   `mcp.servers` as a list, lists are also concatenated.
-* All other arrays are last-write-wins (CC parity).
+* All other arrays are last-write-wins (ecosystem parity).
 * All dicts are merged recursively.
 * All scalars are last-write-wins.
 

docs/mink/slash-commands.md

@@ -2,7 +2,7 @@
 
 The `chimera mink` REPL ships with 30 built-in slash commands (registered in
 `chimera/cli/slash_commands.py`). Nineteen are ported one-to-one from the
-existing `chimera code` REPL; eleven are new in M1 to reach Claude Code
+existing `chimera code` REPL; eleven are new in M1 to reach ecosystem
 parity. The dispatcher is `chimera.cli.slash_commands.dispatch(line,
 session, env, out)`; tab completion uses `COMMAND_NAMES`.
 
@@ -105,7 +105,7 @@ calls share state. `enable` and `disable` are aliases for
 Runs `git diff HEAD` in the cwd, hands the diff to
 `ReviewOrchestrator(provider=session.provider).run(diff)`, and prints
 the (truncated) result. Bails early on empty diffs or missing `git`
-binary. Useful as a parity surface for Claude Code's `/review`.
+binary. Useful as a parity surface for the ecosystem `/review`.
 
 ### /config
 Prefers `chimera.mink.settings.load_mink_settings()` (added in M2).