@savvy-web/mcp 0.2.0 → 0.3.0

package/README.md

@@ -0,0 +1,58 @@
+# @savvy-web/mcp
+
+[![npm](https://img.shields.io/npm/v/@savvy-web%2Fmcp?label=npm&color=cb3837)](https://www.npmjs.com/package/@savvy-web/mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-4caf50.svg)](https://opensource.org/licenses/MIT)
+
+The `savvy-mcp` [Model Context Protocol](https://modelcontextprotocol.io/) server. It serves [Silk Suite](https://github.com/savvy-web/systems) tooling and library knowledge to coding agents as structured tools and a curated documentation corpus, so an agent can read workspace facts and Silk docs instead of parsing console output or guessing.
+
+## Install
+
+```bash
+npm install --save-dev @savvy-web/mcp
+# or
+pnpm add -D @savvy-web/mcp
+```
+
+The Silk Suite Claude Code plugins spawn this server for you, so you rarely install it directly. Installing [`@savvy-web/silk`](https://www.npmjs.com/package/@savvy-web/silk) also brings it in.
+
+## Quick start
+
+The server speaks MCP over stdio and is meant to be spawned by an MCP client. A client declares it like this:
+
+```json
+{
+  "mcpServers": {
+    "savvy-mcp": {
+      "command": "savvy-mcp",
+      "args": ["."]
+    }
+  }
+}
+```
+
+The single positional argument is the project directory; if omitted, the server resolves it from `SAVVY_MCP_PROJECT_DIR`, then `CLAUDE_PROJECT_DIR`, then the current working directory.
+
+To exercise it by hand during development, run it through the MCP inspector:
+
+```bash
+npx @modelcontextprotocol/inspector savvy-mcp .
+# opens the inspector UI against a live savvy-mcp instance
+```
+
+## Tools
+
+- `workspace_info` — returns a flat, structured projection of the workspace analysis: linked and fixed package groups as name arrays plus resolved registry targets. Backed by the same `silk-effects` analyzer the `savvy` CLI uses.
+- `silk_docs_search` — ranks documents in the corpus against a plain keyword or phrase query and returns hits with a normalized confidence score plus a high/medium/low label. It never returns empty: when nothing matches, it falls back to the priority-ordered top results.
+
+## Resources
+
+The server exposes a curated markdown corpus behind the `silk://` URI scheme:
+
+- `silk://catalog` — a single fixed resource listing every document grouped by tier with a "load when …" hint. The agent's mandated first read.
+- `silk://{+path}` — a template resolving any document by its stable id, covering Silk development standards (`silk://standards/<topic>`), per-package API and usage docs (`silk://packages/<pkg>/<topic>`) and conceptual guides (`silk://guides/<slug>`).
+
+Per-package API-reference docs under `silk://packages/<pkg>/api/*` are generated from API Extractor models and shipped with the package.
+
+## License
+
+[MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@savvy-web/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "description": "The savvy MCP server — Silk Suite tooling and library knowledge for coding agents",
   "homepage": "https://github.com/savvy-web/systems/tree/main/packages/mcp",
@@ -33,6 +33,7 @@
     "!tsconfig.json",
     "!tsdoc.json",
     "547.js",
+    "README.md",
     "bin/savvy-mcp.js",
     "index.d.ts",
     "index.js",

package/resources/content/manifest.json

@@ -20,7 +20,7 @@
 				"packages/rslib-builder/overview"
 			],
 			"uri": "silk://guides/api-docs-from-api-extractor",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "guides/building-a-github-action",
@@ -42,7 +42,7 @@
 				"standards/api-model-pipeline"
 			],
 			"uri": "silk://guides/building-a-github-action",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "guides/choosing-a-builder",
@@ -62,7 +62,7 @@
 				"packages/rslib-builder/overview"
 			],
 			"uri": "silk://guides/choosing-a-builder",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "guides/llm-friendly-json-schemas",
@@ -82,7 +82,7 @@
 				"packages/mcp/resource-taxonomy"
 			],
 			"uri": "silk://guides/llm-friendly-json-schemas",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/cli/command-tree",
@@ -103,7 +103,7 @@
 				"packages/silk/install-and-setup"
 			],
 			"uri": "silk://packages/cli/command-tree",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/cli/init-and-check",
@@ -125,7 +125,7 @@
 				"packages/silk/install-and-setup"
 			],
 			"uri": "silk://packages/cli/init-and-check",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/mcp/resource-taxonomy",
@@ -145,7 +145,7 @@
 				"packages/silk-effects/"
 			],
 			"uri": "silk://packages/mcp/resource-taxonomy",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/rslib-builder/overview",
@@ -166,7 +166,7 @@
 				"standards/publishability"
 			],
 			"uri": "silk://packages/rslib-builder/overview",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/silk/export-map",
@@ -186,7 +186,7 @@
 				"packages/silk/install-and-setup"
 			],
 			"uri": "silk://packages/silk/export-map",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/silk/install-and-setup",
@@ -208,7 +208,7 @@
 				"packages/cli/init-and-check"
 			],
 			"uri": "silk://packages/silk/install-and-setup",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/silk-effects/",
@@ -231,7 +231,7 @@
 				"standards/publishability"
 			],
 			"uri": "silk://packages/silk-effects/",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/silk-effects/managed-section",
@@ -253,7 +253,7 @@
 				"packages/silk-effects/platform-layers"
 			],
 			"uri": "silk://packages/silk-effects/managed-section",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "packages/silk-effects/platform-layers",
@@ -275,7 +275,7 @@
 				"packages/silk-effects/managed-section"
 			],
 			"uri": "silk://packages/silk-effects/platform-layers",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/api-model-pipeline",
@@ -296,7 +296,7 @@
 				"packages/mcp/resource-taxonomy"
 			],
 			"uri": "silk://standards/api-model-pipeline",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/catalog-usage",
@@ -317,7 +317,7 @@
 				"standards/publishability"
 			],
 			"uri": "silk://standards/catalog-usage",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/changeset-discipline",
@@ -339,7 +339,7 @@
 				"standards/publishability"
 			],
 			"uri": "silk://standards/changeset-discipline",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/changeset-format",
@@ -359,7 +359,7 @@
 				"standards/changeset-discipline"
 			],
 			"uri": "silk://standards/changeset-format",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/commit-contract",
@@ -381,7 +381,7 @@
 				"standards/changeset-discipline"
 			],
 			"uri": "silk://standards/commit-contract",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/dependency-conventions",
@@ -402,7 +402,7 @@
 				"standards/catalog-usage"
 			],
 			"uri": "silk://standards/dependency-conventions",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/linting-conventions",
@@ -422,7 +422,7 @@
 				"standards/test-classification"
 			],
 			"uri": "silk://standards/linting-conventions",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/publishability",
@@ -443,7 +443,7 @@
 				"standards/catalog-usage"
 			],
 			"uri": "silk://standards/publishability",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/semver",
@@ -463,7 +463,7 @@
 				"standards/changeset-discipline"
 			],
 			"uri": "silk://standards/semver",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		},
 		{
 			"id": "standards/test-classification",
@@ -483,7 +483,7 @@
 				"standards/linting-conventions"
 			],
 			"uri": "silk://standards/test-classification",
-			"lastModified": "2026-06-02T07:25:00Z"
+			"lastModified": "2026-06-03T00:56:24-04:00"
 		}
 	]
 }

package/resources/content/packages/cli/init-and-check.md

@@ -23,8 +23,10 @@ Both orchestrators sequence the three per-tool handlers and short-circuit on the
 first failure. They live at `src/commands/init.ts` and `src/commands/check.ts`. The
 per-tool handlers are injected rather than imported inline, so the orchestration
 logic — the sequencing and short-circuit — is unit-testable without standing up the
-full runtime. Per-tool `init` and `check` stay reachable under their namespaces
-(`savvy changeset init`, `savvy lint check`, and so on).
+full runtime. There is no per-tool setup or validation entry point: `savvy init`
+and `savvy check` are the only ones. The namespaced groups expose the remaining
+per-tool operations instead (`savvy changeset lint`, `savvy lint fmt`,
+`savvy commit hook ...`, and so on).
 
 ## Layer
 

package/resources/content/standards/changeset-format.md

@@ -128,4 +128,5 @@ commits to changelog entries.
 The discipline rules governing when a changeset is required are at
 `silk://standards/changeset-discipline`. The `changeset-style` Claude Code skill
 carries worked examples for all three content-depth tiers. The `changeset-check`
-skill validates files against CSH001–CSH005 via `savvy changeset check`.
+skill validates files against CSH001–CSH005 via `savvy changeset lint` (or
+`savvy changeset validate-file <file>` for a single file).