@neurodock/cli 0.1.2 → 0.4.3

package/README.md

@@ -1,14 +1,17 @@
 # @neurodock/cli
 
-The `neurodock` installer and diagnostic CLI.
+The `neurodock` installer and diagnostic CLI for [NeuroDock](https://neurodock.org/) — a local-first cognitive substrate for neurodivergent professionals.
 
-Status: Phase 1 (v0.1 developer preview).
+Status: **v0.4.3**.
 
 ## Quickstart
 
 ```bash
-# From a published package once it lands on npm:
-npx neurodock init
+# From a published package:
+npx --yes @neurodock/cli install-all
+
+# Or step-by-step, also from npm:
+npx --yes @neurodock/cli init
 
 # From a fresh clone of the monorepo:
 pnpm install
@@ -16,22 +19,55 @@ pnpm --filter @neurodock/cli build
 node packages/cli/dist/index.js init
 ```
 
-`neurodock init` wires three Python MCP servers (chronometric, cognitive-graph,
-task-fractionator) into every MCP-aware client it can detect.
+`neurodock init` wires five Python MCP servers (chronometric,
+cognitive-graph, task-fractionator, translation, guardrail) into every
+MCP-aware client it can detect. A sixth, the optional native messaging
+host, is wired separately via `neurodock host install`.
 
-**Prerequisite:** the CLI does not install Python deps for you. From a clone
-run `uv sync` (or `pip install -e packages/mcp-chronometric` etc.) so the
-`neurodock-mcp-*` console entry points are on `$PATH` for `uv run`. From a
-published install this matures into `uv tool install neurodock-mcp-*`.
+**Prerequisite:** the CLI does not install Python deps for you unless you
+use `install-all`. From a clone run `uv sync` (or
+`pip install -e packages/mcp-chronometric` etc.) so the
+`neurodock-mcp-*` console entry points are on `$PATH`. From a published
+install, `install-all` runs the `pip install` step automatically.
 
 ## Commands
 
-| Command | What it does |
-|---|---|
-| `neurodock init` | Install MCP servers into Claude Desktop / Claude Code / Cursor. |
-| `neurodock doctor` | Diagnose your install — profile validity, client wiring, tool availability. |
-| `neurodock profile validate` | Validate `~/.neurodock/profile.yaml` against the v0.1 schema. |
-| `neurodock profile show` | Print the resolved profile with loader defaults applied. |
+| Command                      | What it does                                                                                                               |
+| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `neurodock install-all`      | One-command first-time install: pip-install the six servers, wire every detected client, copy the starter profile.         |
+| `neurodock init`             | Install MCP servers into Claude Desktop / Claude Code / Cursor (the wiring half of `install-all`).                         |
+| `neurodock doctor`           | Diagnose your install — profile validity, client wiring, tool availability.                                                |
+| `neurodock validate`         | Schema-validate a profile file (`~/.neurodock/profile.yaml` by default).                                                   |
+| `neurodock update`           | Re-run install adapters; rewrite stale NeuroDock MCP entries in client configs. Non-NeuroDock entries are preserved.       |
+| `neurodock uninstall`        | Reverse `init` — remove NeuroDock MCP entries from each client config. Optionally purge `~/.neurodock/`.                   |
+| `neurodock examples`         | Print a copy-pasteable prompt cheat-sheet that exercises every wired NeuroDock MCP tool.                                   |
+| `neurodock host install`     | Register the optional Chrome Native Messaging host so the browser extension can read `~/.neurodock/profile.yaml` directly. |
+| `neurodock host uninstall`   | Remove all NeuroDock native-host manifests and registry pointers.                                                          |
+| `neurodock profile show`     | Print the resolved profile with loader defaults applied.                                                                   |
+| `neurodock profile validate` | Validate `~/.neurodock/profile.yaml` against the v0.1 schema.                                                              |
+| `neurodock plugin add`       | Install a plugin from a local directory into `~/.neurodock/plugins/`.                                                      |
+| `neurodock plugin remove`    | Uninstall a plugin (alias: `plugin uninstall`).                                                                            |
+| `neurodock plugin list`      | List installed plugins and their enabled state. `--json` for scripting.                                                    |
+| `neurodock plugin enable`    | Activate an installed plugin (writes a `.enabled` marker file).                                                            |
+| `neurodock plugin disable`   | Deactivate an installed plugin without deleting its files.                                                                 |
+| `neurodock plugin validate`  | Schema-validate a plugin manifest without installing.                                                                      |
+
+### `neurodock install-all`
+
+```
+neurodock install-all [--client=claude-desktop|claude-code|cursor|all] \
+                      [--profile=minimal|example] \
+                      [--installer=uv|pip|auto] \
+                      [--skip-install] [--yes] [--dry-run]
+```
+
+Single-command first-time install. Prefers `uv` if it is on PATH; falls
+back to `python -m pip`. After install, verifies each server entrypoint
+is on PATH with `<command> --help`, then delegates to `init` to wire
+clients.
+
+Exit codes: `0` ok, `1` an entrypoint is missing from PATH after
+install, `2` init failed.
 
 ### `neurodock init`
 
@@ -50,21 +86,98 @@ What `init` does, in order:
 
 1. Detects supported clients per platform (see "Detection locations" below).
 2. Copies `profile.example.yaml` or `profile.minimal.yaml` to `~/.neurodock/profile.yaml` if it does not already exist. Sets `identity.display_name` from `$USER` / `%USERNAME%`.
-3. Adds three `mcpServers` entries (`neurodock-chronometric`, `neurodock-cognitive-graph`, `neurodock-task-fractionator`) to each detected client's config.
+3. Adds `mcpServers` entries for each NeuroDock server to each detected client's config.
 4. Preserves all unrelated keys, comments, and unknown server entries already in those configs.
 
 Idempotent. Re-running with no changes is a no-op. Collisions on a previous
 key are skipped unless `--yes` is supplied.
 
+### `neurodock validate` / `update` / `uninstall`
+
+```
+neurodock validate [--file <path>] [--strict]
+neurodock update [--client <id>] [--dry-run]
+neurodock uninstall [--client <id>] [--yes] [--purge] [--dry-run]
+```
+
+`validate` runs Ajv against `profile.schema.json` and reports field-path
+violations. `update` rewrites stale NeuroDock MCP entries (version drift,
+command/args/cwd changes); non-NeuroDock entries round-trip untouched.
+`uninstall` removes NeuroDock entries from every detected client config;
+asks (interactively) whether to delete `~/.neurodock/profile.yaml` and
+`~/.neurodock/cognitive-graph.sqlite` (default: no). `--purge` deletes
+those without prompting.
+
+### `neurodock examples`
+
+```
+neurodock examples [--server <name>] [--json]
+```
+
+Detects which NeuroDock servers are wired across all detected client
+configs and prints 2–3 example prompts per server, each annotated with
+the underlying tool name. `--server` filters to one server; `--json`
+emits machine-readable output. Honors `NO_COLOR` / `FORCE_COLOR`.
+
 ### Detection locations
 
-| Client | Platform | Path |
-|---|---|---|
-| Claude Desktop | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Claude Desktop | Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
-| Claude Desktop | Linux | `~/.config/Claude/claude_desktop_config.json` |
-| Claude Code | All | `./.claude/settings.json` (project, preferred) then `~/.claude/settings.json` (user) |
-| Cursor | All | `./.cursor/mcp.json` (project, preferred) then `~/.cursor/mcp.json` (user) |
+| Client         | Platform | Path                                                                                 |
+| -------------- | -------- | ------------------------------------------------------------------------------------ |
+| Claude Desktop | macOS    | `~/Library/Application Support/Claude/claude_desktop_config.json`                    |
+| Claude Desktop | Windows  | `%APPDATA%\Claude\claude_desktop_config.json`                                        |
+| Claude Desktop | Linux    | `~/.config/Claude/claude_desktop_config.json`                                        |
+| Claude Code    | All      | `./.claude/settings.json` (project, preferred) then `~/.claude/settings.json` (user) |
+| Cursor         | All      | `./.cursor/mcp.json` (project, preferred) then `~/.cursor/mcp.json` (user)           |
+
+### `neurodock host install` / `uninstall`
+
+```
+neurodock host install [--extension-id <id>]
+neurodock host uninstall
+```
+
+`host install` registers `com.neurodock.profile` (a Chrome Native
+Messaging host shipped as `@neurodock/native-host`) with every supported
+browser on the machine. After install, the browser extension reads and
+writes `~/.neurodock/profile.yaml` directly instead of maintaining a
+duplicate in `chrome.storage.local`.
+
+`--extension-id` is repeatable. Pass the published extension id once it
+is allocated by the store; while the package is unpublished the default
+is a placeholder.
+
+The host is OPTIONAL. The extension keeps working without it — the
+popup just shows `Profile sync: extension-local`.
+
+### `neurodock profile show` / `validate`
+
+```
+neurodock profile show
+neurodock profile validate [--file <path>]
+```
+
+`show` prints the resolved profile with loader defaults applied (per
+ADR 0004 §15). `validate` runs Ajv against the profile schema.
+
+### `neurodock plugin` group
+
+```
+neurodock plugin add <source> [--yes] [--dry-run] [--force]
+neurodock plugin remove <name> [--yes] [--dry-run]
+neurodock plugin list [--json]
+neurodock plugin enable <name>
+neurodock plugin disable <name>
+neurodock plugin validate <source> [--json]
+```
+
+`add` validates `plugin.yaml` against `plugin.schema.json` before copying
+into `~/.neurodock/plugins/<name>/`. Enablement is tracked via a
+`.enabled` marker file inside each plugin directory — the substrate's
+filesystem walk treats marker presence as the single source of truth
+(per ADR 0007).
+
+Exit codes for `add`: `0` ok, `1` source invalid, `2` already installed
+without `--force`, `3` schema validation failure.
 
 ### Profile precedence
 
@@ -94,7 +207,17 @@ node dist/index.js --help
 - All loader defaults live in `src/profile/defaults.ts` and mirror
   `profile.schema.json` — JSON Schema validation does not apply defaults
   itself, so the loader does.
-- No telemetry, no remote calls, no auto-install of Python packages.
+- No telemetry, no remote calls. `install-all` is the only command that
+  shells out to a package manager, and it does so only when invoked.
+
+## Links
+
+- **Home:** [neurodock.org](https://neurodock.org/)
+- **Documentation:** [docs.neurodock.org](https://docs.neurodock.org/)
+- **Repository:** [github.com/tlennon-ie/neurodock](https://github.com/tlennon-ie/neurodock) (monorepo; this package lives at `packages/cli/`)
+- **Issues:** [github.com/tlennon-ie/neurodock/issues](https://github.com/tlennon-ie/neurodock/issues)
+- **Changelog:** [`packages/cli/CHANGELOG.md`](https://github.com/tlennon-ie/neurodock/blob/main/packages/cli/CHANGELOG.md)
+- **Manifesto + ethics:** [`MANIFESTO.md`](https://github.com/tlennon-ie/neurodock/blob/main/MANIFESTO.md), [`ETHICS.md`](https://github.com/tlennon-ie/neurodock/blob/main/ETHICS.md)
 
 ## License
 

package/dist/clients/claude-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/clients/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,eAAO,MAAM,iBAAiB,EAAE,aAgB/B,CAAC"}
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/clients/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,eAAO,MAAM,iBAAiB,EAAE,aAkB/B,CAAC"}

package/dist/clients/claude-code.js

@@ -11,7 +11,9 @@ export const claudeCodeAdapter = {
     },
     shapeConfig(existing, mcpServers) {
         const base = isObject(existing) ? { ...existing } : {};
-        const prev = isObject(base["mcpServers"]) ? base["mcpServers"] : {};
+        const prev = isObject(base["mcpServers"])
+            ? base["mcpServers"]
+            : {};
         base["mcpServers"] = { ...prev, ...mcpServers };
         return base;
     },

package/dist/clients/claude-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/clients/claude-code.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,EAAE,EAAE,aAAa;IACjB,WAAW,EAAE,aAAa;IAC1B,WAAW,CAAC,GAAG;QACb,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO;YACL,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;SACpC,CAAC;IACJ,CAAC;IACD,WAAW,CAAC,QAAQ,EAAE,UAAU;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,YAAY,CAAoC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/clients/claude-code.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,EAAE,EAAE,aAAa;IACjB,WAAW,EAAE,aAAa;IAC1B,WAAW,CAAC,GAAG;QACb,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO;YACL,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;SACpC,CAAC;IACJ,CAAC;IACD,WAAW,CAAC,QAAQ,EAAE,UAAU;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACvC,CAAC,CAAE,IAAI,CAAC,YAAY,CAAoC;YACxD,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/clients/claude-desktop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../src/clients/claude-desktop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,eAAO,MAAM,oBAAoB,EAAE,aAYlC,CAAC"}
+{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../src/clients/claude-desktop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,eAAO,MAAM,oBAAoB,EAAE,aAclC,CAAC"}

package/dist/clients/claude-desktop.js

@@ -7,7 +7,9 @@ export const claudeDesktopAdapter = {
     },
     shapeConfig(existing, mcpServers) {
         const base = isObject(existing) ? { ...existing } : {};
-        const prev = isObject(base["mcpServers"]) ? base["mcpServers"] : {};
+        const prev = isObject(base["mcpServers"])
+            ? base["mcpServers"]
+            : {};
         base["mcpServers"] = { ...prev, ...mcpServers };
         return base;
     },

package/dist/clients/claude-desktop.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-desktop.js","sourceRoot":"","sources":["../../src/clients/claude-desktop.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,EAAE,EAAE,gBAAgB;IACpB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,CAAC,GAAG;QACb,OAAO,CAAC,EAAE,IAAI,EAAE,uBAAuB,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,WAAW,CAAC,QAAQ,EAAE,UAAU;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,YAAY,CAAoC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"claude-desktop.js","sourceRoot":"","sources":["../../src/clients/claude-desktop.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,EAAE,EAAE,gBAAgB;IACpB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,CAAC,GAAG;QACb,OAAO,CAAC,EAAE,IAAI,EAAE,uBAAuB,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,WAAW,CAAC,QAAQ,EAAE,UAAU;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACvC,CAAC,CAAE,IAAI,CAAC,YAAY,CAAoC;YACxD,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/clients/cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/clients/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,eAAO,MAAM,aAAa,EAAE,aAgB3B,CAAC"}
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/clients/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,eAAO,MAAM,aAAa,EAAE,aAkB3B,CAAC"}

package/dist/clients/cursor.js

@@ -11,7 +11,9 @@ export const cursorAdapter = {
     },
     shapeConfig(existing, mcpServers) {
         const base = isObject(existing) ? { ...existing } : {};
-        const prev = isObject(base["mcpServers"]) ? base["mcpServers"] : {};
+        const prev = isObject(base["mcpServers"])
+            ? base["mcpServers"]
+            : {};
         base["mcpServers"] = { ...prev, ...mcpServers };
         return base;
     },

package/dist/clients/cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/clients/cursor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,QAAQ;IACrB,WAAW,CAAC,GAAG;QACb,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO;YACL,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;SACpC,CAAC;IACJ,CAAC;IACD,WAAW,CAAC,QAAQ,EAAE,UAAU;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,YAAY,CAAoC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/clients/cursor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,QAAQ;IACrB,WAAW,CAAC,GAAG;QACb,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO;YACL,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;SACpC,CAAC;IACJ,CAAC;IACD,WAAW,CAAC,QAAQ,EAAE,UAAU;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACvC,CAAC,CAAE,IAAI,CAAC,YAAY,CAAoC;YACxD,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/clients/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAKjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IAC9D,iEAAiE;IACjE,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC;CACrF;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,aAAa,CAIpD,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,aAAa,CAMtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAKjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IAC9D,iEAAiE;IACjE,WAAW,CACT,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GACzC,OAAO,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,aAAa,CAIpD,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,aAAa,CAMtD"}

package/dist/clients/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgB5C,MAAM,CAAC,MAAM,WAAW,GAAiC;IACvD,oBAAoB;IACpB,iBAAiB;IACjB,aAAa;CACd,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,EAAY;IACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAmB5C,MAAM,CAAC,MAAM,WAAW,GAAiC;IACvD,oBAAoB;IACpB,iBAAiB;IACjB,aAAa;CACd,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,EAAY;IACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,CA8EvD"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,CAqFvD"}

package/dist/commands/doctor.js

@@ -10,7 +10,7 @@ export async function runDoctor() {
     const checks = [];
     checks.push(checkNodeVersion());
     checks.push(checkCommandAvailable("uv", ["--version"]));
-    checks.push(checkCommandAvailable("python3", ["--version"], "python3 or python >= 3.11"));
+    checks.push(checkPython());
     // Profile presence + validity.
     const pPath = profilePath(env);
     if (!existsSync(pPath)) {
@@ -32,7 +32,9 @@ export async function runDoctor() {
                 checks.push({
                     name: "Profile schema valid",
                     status: "FAIL",
-                    detail: result.violations.map((v) => `${v.path}: ${v.message}`).join("; "),
+                    detail: result.violations
+                        .map((v) => `${v.path}: ${v.message}`)
+                        .join("; "),
                 });
             }
         }
@@ -95,13 +97,66 @@ function checkNodeVersion() {
 function checkCommandAvailable(cmd, args, label) {
     const name = label ?? `${cmd} available`;
     try {
-        const out = execFileSync(cmd, args, { stdio: ["ignore", "pipe", "pipe"], timeout: 4000 });
+        const out = execFileSync(cmd, args, {
+            stdio: ["ignore", "pipe", "pipe"],
+            timeout: 4000,
+        });
         const text = out.toString().trim().split("\n")[0] ?? "";
         return { name, status: "PASS", detail: text };
     }
     catch (err) {
-        const detail = err instanceof Error ? err.message.split("\n")[0] ?? "unknown error" : String(err);
+        const detail = err instanceof Error
+            ? err.message.split("\n")[0] ?? "unknown error"
+            : String(err);
         return { name, status: "FAIL", detail };
     }
 }
+const PYTHON_CANDIDATES = [
+    // Most Unix installs (and explicit pyenv shims).
+    { cmd: "python3", args: ["--version"] },
+    // Most Windows installs (and Conda / venvs everywhere).
+    { cmd: "python", args: ["--version"] },
+    // Windows Python launcher selecting >=3.x.
+    { cmd: "py", args: ["-3", "--version"] },
+];
+function checkPython() {
+    const name = "Python >= 3.11";
+    const errors = [];
+    for (const { cmd, args } of PYTHON_CANDIDATES) {
+        try {
+            const out = execFileSync(cmd, args, {
+                stdio: ["ignore", "pipe", "pipe"],
+                timeout: 4000,
+            });
+            const text = out.toString().trim().split("\n")[0] ?? "";
+            const match = text.match(/(\d+)\.(\d+)/);
+            if (!match) {
+                errors.push(`${cmd}: unexpected version output "${text}"`);
+                continue;
+            }
+            const major = Number(match[1]);
+            const minor = Number(match[2]);
+            const tooOld = major < 3 || (major === 3 && minor < 11);
+            const detail = `${cmd} ${match[0]} (${text})`;
+            return tooOld
+                ? {
+                    name,
+                    status: "FAIL",
+                    detail: `${detail} is below 3.11. Upgrade Python.`,
+                }
+                : { name, status: "PASS", detail };
+        }
+        catch (err) {
+            const message = err instanceof Error
+                ? err.message.split("\n")[0] ?? "unknown error"
+                : String(err);
+            errors.push(`${cmd}: ${message}`);
+        }
+    }
+    return {
+        name,
+        status: "FAIL",
+        detail: `No Python interpreter found on PATH (tried python3, python, py -3). Errors: ${errors.join("; ")}`,
+    };
+}
 //# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/examples.d.ts

@@ -0,0 +1,28 @@
+import { readEnv } from "../lib/env.js";
+export type ServerName = "neurodock-chronometric" | "neurodock-cognitive-graph" | "neurodock-task-fractionator" | "neurodock-translation" | "neurodock-guardrail";
+export interface ExamplePrompt {
+    readonly prompt: string;
+    readonly tool: string;
+}
+export interface ServerExamples {
+    readonly server: ServerName;
+    readonly label: string;
+    readonly prompts: ReadonlyArray<ExamplePrompt>;
+}
+export interface ExamplesOptions {
+    readonly server?: string;
+    readonly json: boolean;
+}
+export interface ExamplesResult {
+    /** which servers are wired anywhere across detected client configs */
+    readonly wired: ReadonlyArray<ServerName>;
+    readonly groups: ReadonlyArray<ServerExamples>;
+    readonly messages: ReadonlyArray<string>;
+}
+export interface ExamplesDependencies {
+    readonly envOverrides?: Parameters<typeof readEnv>[0];
+    /** Override the color check (defaults to colorEnabled() from env). */
+    readonly colorEnabled?: () => boolean;
+}
+export declare function runExamples(options: ExamplesOptions, deps?: ExamplesDependencies): Promise<ExamplesResult>;
+//# sourceMappingURL=examples.d.ts.map

package/dist/commands/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../src/commands/examples.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAgB,MAAM,eAAe,CAAC;AAItD,MAAM,MAAM,UAAU,GAClB,wBAAwB,GACxB,2BAA2B,GAC3B,6BAA6B,GAC7B,uBAAuB,GACvB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;CACvC;AAoGD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,cAAc,CAAC,CA+DzB"}

package/dist/commands/examples.js

@@ -0,0 +1,168 @@
+import { readFileSync } from "node:fs";
+import chalk from "chalk";
+import { readEnv, colorEnabled } from "../lib/env.js";
+import { detectClients } from "../lib/paths.js";
+import { parseJsonSafely } from "../lib/json-patch.js";
+const ALL_GROUPS = [
+    {
+        server: "neurodock-chronometric",
+        label: "mcp-chronometric (time, sessions, energy zone)",
+        prompts: [
+            {
+                prompt: "What time is it and what's my energy zone?",
+                tool: "get_time_context",
+            },
+            {
+                prompt: "Start a session — I'm working on emails for the next 30 minutes.",
+                tool: "mark_session_start",
+            },
+            {
+                prompt: "I'm done. End my session and summarise what I got through.",
+                tool: "mark_session_end",
+            },
+        ],
+    },
+    {
+        server: "neurodock-cognitive-graph",
+        label: "mcp-cognitive-graph (memory, facts, decisions)",
+        prompts: [
+            {
+                prompt: "Remember: my dev box is Windows 11, Python 3.11, Node 22.",
+                tool: "record_fact",
+            },
+            {
+                prompt: "What do you know about my dev environment?",
+                tool: "recall_entity",
+            },
+            {
+                prompt: "What decisions have I made about the auth refactor in the last 30 days?",
+                tool: "recall_decisions",
+            },
+            {
+                prompt: "Give me a weekly rollup on the marketing site project.",
+                tool: "weekly_rollup",
+            },
+        ],
+    },
+    {
+        server: "neurodock-task-fractionator",
+        label: "mcp-task-fractionator (decompose goals, pick next step)",
+        prompts: [
+            {
+                prompt: "Decompose this goal into atomic tasks with a PT3H budget: 'Get the changelog ready for v1.0.'",
+                tool: "decompose",
+            },
+            {
+                prompt: "What should I do next on the auth refactor?",
+                tool: "next_one",
+            },
+        ],
+    },
+    {
+        server: "neurodock-translation",
+        label: "mcp-translation (incoming/outgoing tone, meeting briefs)",
+        prompts: [
+            {
+                prompt: "Translate this incoming Slack message — what is the explicit ask and what's the subtext: 'Hey, can we revisit the timeline next week?'",
+                tool: "translate_incoming",
+            },
+            {
+                prompt: "Tone-check this PR comment before I send it: 'this needs a rewrite — let me know'",
+                tool: "check_tone",
+            },
+            {
+                prompt: "Rewrite this for a 'warm' register without losing the technical detail: 'Fix the GraphQL N+1 in /api/users.'",
+                tool: "rewrite_outgoing",
+            },
+            {
+                prompt: "Brief this 30-minute meeting transcript — pull out my asks, others' asks, decisions, and ambiguous items. [paste transcript]",
+                tool: "brief_meeting",
+            },
+        ],
+    },
+    {
+        server: "neurodock-guardrail",
+        label: "mcp-guardrail (rumination + loop checks — mostly invoked via skills)",
+        prompts: [
+            {
+                prompt: "Check whether my last 5 questions about Postgres count as a rumination loop: [list of questions]",
+                tool: "check_rumination",
+            },
+        ],
+    },
+];
+export async function runExamples(options, deps = {}) {
+    const env = readEnv(deps.envOverrides ?? {});
+    const messages = [];
+    // Probe which servers are wired across all detected client configs.
+    const wired = detectWiredServers(env);
+    // Filter by --server if supplied.
+    const requested = options.server ?? null;
+    if (requested !== null && !isKnownServer(requested)) {
+        messages.push(`Unknown --server '${requested}'. Known: ${ALL_GROUPS.map((g) => g.server).join(", ")}.`);
+        return { wired, groups: [], messages };
+    }
+    const groups = ALL_GROUPS.filter((g) => {
+        if (requested !== null && g.server !== requested)
+            return false;
+        return wired.includes(g.server);
+    });
+    if (groups.length === 0) {
+        if (requested !== null) {
+            messages.push(`Server '${requested}' is not wired in any detected MCP client config.`);
+            messages.push("Run 'neurodock init' (or 'neurodock install-all') to wire it.");
+        }
+        else {
+            messages.push("No NeuroDock servers detected in any client config.");
+            messages.push("Run 'neurodock init' (or 'neurodock install-all') to wire them.");
+        }
+        return { wired, groups: [], messages };
+    }
+    if (options.json) {
+        messages.push(JSON.stringify({ wired, groups }, null, 2));
+        return { wired, groups, messages };
+    }
+    // Pretty output.
+    const useColor = (deps.colorEnabled ?? colorEnabled)();
+    for (const g of groups) {
+        messages.push("");
+        messages.push(useColor ? chalk.bold(g.label) : g.label);
+        for (const p of g.prompts) {
+            const promptLine = useColor
+                ? chalk.cyan(`"${p.prompt}"`)
+                : `"${p.prompt}"`;
+            const toolLine = useColor ? chalk.dim(`→ ${p.tool}`) : `→ ${p.tool}`;
+            messages.push(`  ${promptLine}`);
+            messages.push(`    ${toolLine}`);
+        }
+    }
+    messages.push("");
+    messages.push(`Wired servers: ${wired.join(", ") || "(none)"}`);
+    return { wired, groups, messages };
+}
+function detectWiredServers(env) {
+    const detections = detectClients(env).filter((d) => d.exists);
+    const seen = new Set();
+    for (const d of detections) {
+        try {
+            const raw = readFileSync(d.path, "utf8");
+            const parsed = parseJsonSafely(raw);
+            if (!parsed.ok)
+                continue;
+            const cfg = (parsed.value ?? {});
+            for (const key of Object.keys(cfg.mcpServers ?? {})) {
+                if (isKnownServer(key))
+                    seen.add(key);
+            }
+        }
+        catch {
+            // unreadable config: skip silently.
+        }
+    }
+    // Preserve canonical order from ALL_GROUPS so output is deterministic.
+    return ALL_GROUPS.map((g) => g.server).filter((s) => seen.has(s));
+}
+function isKnownServer(key) {
+    return ALL_GROUPS.some((g) => g.server === key);
+}
+//# sourceMappingURL=examples.js.map