@synapsor/runner 1.6.4 → 1.6.5

package/CHANGELOG.md

@@ -1,6 +1,28 @@
 # Changelog
 
-## 1.6.4 (prepared, not published)
+## 1.6.5 (prepared, not published)
+
+### Managed Claude Code and VS Code project MCP installs
+
+- Extends Runner's reviewed project MCP lifecycle from Cursor to Claude Code
+  and VS Code. `mcp install`, `mcp status`, and `mcp uninstall` now manage only
+  Runner's project-local entry in `.mcp.json` or `.vscode/mcp.json`.
+- Preserves unrelated servers and settings, creates backups, pins the exact
+  Runner package version, tracks ownership with an integrity marker, refuses
+  tampered or unowned entries, and keeps credentials and trusted scope out of
+  client configuration.
+- Preserves VS Code JSONC comments and trailing commas. Static status and a
+  real optional stdio `tools/list` launch check prove that each client receives
+  the same reviewed model-facing authority.
+- Makes onboarding, Workbench guidance, README positioning, host recipes, and
+  `doctor` client-neutral while retaining the existing Cursor lifecycle and
+  `--check-cursor` compatibility.
+
+Prepared package versions: `@synapsor/runner@1.6.5` and the optional
+`synapsor-runner@1.6.5` command alias. `@synapsor/spec@1.7.0` and
+`@synapsor/dsl@1.7.0` are unchanged. No package is published by this change.
+
+## 1.6.4 (published 2026-07-25)
 
 ### Review-correct onboarding and reviewed relationship paths
 
@@ -62,9 +84,9 @@
 - Adds one local, escaped, copy-exact DSL syntax highlighter for every
   Workbench DSL preview, with no CDN or unsafe HTML path, and gives activity,
   review, and apply detail the full available width on desktop and mobile.
-- Prepares `@synapsor/runner@1.6.4`, `@synapsor/spec@1.7.0`,
+- Published `@synapsor/runner@1.6.4`, `@synapsor/spec@1.7.0`,
   `@synapsor/dsl@1.7.0`, and the optional `synapsor-runner@1.6.4` command
-  alias. No package is published by this change.
+  alias.
 
 ## 1.6.3 (published 2026-07-24)
 

package/README.md

@@ -8,10 +8,10 @@
 
 **MCP connects the agent. Synapsor controls the commit.**
 
-Synapsor Runner is an open-source MCP runtime for Postgres and MySQL. It gives
-agents reviewed business actions, records proposed changes as exact Data PRs,
-and keeps credentials, activation, approval, and commit authority outside the
-model-facing surface.
+Synapsor Runner is an open-source MCP runtime for Postgres and MySQL. It lets
+agents ask bounded business questions of reviewed data and propose exact Data
+PRs, while keeping credentials, activation, approval, and commit authority
+outside the model-facing surface.
 
 ## Prove The Boundary In Four Seconds
 
@@ -72,19 +72,35 @@ writes off; broader paths require full review.
 [Database To First Safe Tool](docs/guided-onboarding.md) covers the complete
 path.
 
-## Ask Your First Real Question In Cursor
+## Ask Your First Real Question
 
-After activation, install only the local authoring entry in this Cursor project:
+Runner is host-neutral. These three paths execute the same typed plans against
+the same activated digest, trusted scope, suppression rules, budgets, and
+denials:
+
+1. **Workbench composer:** no MCP client, model, or API key. Choose only reviewed
+   measures, dimensions, filters, and time buckets.
+2. **Workbench Ask:** optional OpenAI, Anthropic, or loopback
+   OpenAI-compatible model after explicit digest-bound egress consent. Keys and
+   conversation history remain in memory; a loopback model keeps data local.
+3. **Any MCP client:** use a managed project installer for Cursor, Claude Code,
+   or VS Code, or a checked recipe for Claude Desktop, Codex, OpenAI Agents,
+   LangChain/LangGraph, Google ADK, LlamaIndex, and generic stdio.
+
+For a managed project, choose one:
 
 ```bash
-synapsor-runner mcp install cursor \
-  --project \
-  --authoring \
-  --project-root . \
-  --yes
+synapsor-runner mcp install cursor --project --authoring --project-root . --yes
+synapsor-runner mcp install claude-code --project --authoring --project-root . --yes
+synapsor-runner mcp install vscode --project --authoring --project-root . --yes
 ```
 
-Cursor sees exactly two temporary tools:
+Runner merges only its `synapsor` entry into `.cursor/mcp.json`, `.mcp.json`, or
+`.vscode/mcp.json`; it preserves other settings, backs up existing files, pins
+the exact Runner version, and writes no credentials. See
+[Client And Framework Recipes](docs/client-recipes.md).
+
+The selected client sees exactly two temporary tools:
 
 ```text
 app.describe_data
@@ -104,13 +120,10 @@ three activated one- or two-link many-to-one paths are supported; inactive or
 unsafe joins fail closed. This is descriptive analysis, not causation. See
 [Reviewed Relationships](docs/reviewed-relationships.md).
 
-### Optional: Ask In Workbench With Your Model
-
-The no-model composer remains the default. Optional local Workbench Ask can use
-OpenAI, Anthropic, or a tested OpenAI-compatible endpoint after explicit
-digest-bound egress consent. It can call only displayed reviewed tools; keys
-and history remain in memory, and writes remain proposals. See [Workbench
-Ask](docs/workbench-ask.md).
+This is bounded, governed analytics over reviewed measures, dimensions, time
+grains, and relationship paths, not a general BI dashboard or SQL surface.
+Protect turns a useful analysis into a named, digest-reviewed metric capability.
+See [Workbench Ask](docs/workbench-ask.md).
 
 ## Protect This Query
 
@@ -118,12 +131,12 @@ Choose a useful result without copying an ID. Runner freezes public DSL,
 canonical JSON, and tests under `synapsor/protected/drafts/`; the named
 capability starts disabled.
 
-After activation, Scoped Explore is disabled. Update Cursor to the production
-config:
+After activation, Scoped Explore is disabled. Update the selected project
+client to the production config:
 
 ```bash
-synapsor-runner mcp install cursor \
-  --project \
+CLIENT=claude-code # or cursor / vscode
+synapsor-runner mcp install "$CLIENT" --project \
   --config ./synapsor.runner.json \
   --store ./.synapsor/local.db \
   --yes

package/dist/cli.d.ts.map

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