@savvy-web/mcp 0.3.0 → 0.4.0

package/README.md

@@ -43,6 +43,7 @@ npx @modelcontextprotocol/inspector savvy-mcp .
 
 - `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.
+- `turbo_inspect` — read-only Turborepo inspection over `turbo --dry`: diagnose a task's per-package cache hits, derive the task graph or list the packages affected by recent changes. It never runs a task. Backed by the same `silk-effects` `Turbo` inspector an agent would otherwise drive by hand.
 
 ## Resources
 

package/bin/savvy-mcp.js

@@ -1,153 +1,47 @@
 #!/usr/bin/env node
-import { NodeContext } from "@effect/platform-node";
+import { SilkRuntimeLive } from "../runtime.js";
+import { loadManifest, readDocBody, resolveContentRoot } from "../resources/load.js";
+import { startMcpServer } from "../server.js";
+import { DocIndex } from "../resources/doc-index.js";
 import { Layer, ManagedRuntime } from "effect";
-import fuse_0 from "fuse.js";
-import { loadManifest, readDocBody, resolveContentRoot, startMcpServer, SilkRuntimeLive } from "../547.js";
-const STOP_WORDS = new Set([
-    "how",
-    "do",
-    "i",
-    "the",
-    "a",
-    "an",
-    "to",
-    "of",
-    "in",
-    "for",
-    "is",
-    "what",
-    "when",
-    "use"
-]);
-const FUSE_THRESHOLD = 0.6;
-const confidenceLabel = (confidence)=>confidence >= 0.6 ? "high" : confidence >= 0.4 ? "medium" : "low";
-const toRanked = (item, score, matches)=>({
-        item,
-        confidence: 1 - (score ?? 1),
-        matchedOn: matches.map((m)=>m.key ?? "")
-    });
-class DocIndex {
-    fuse;
-    entries;
-    byUri;
-    constructor(fuse, entries, byUri){
-        this.fuse = fuse;
-        this.entries = entries;
-        this.byUri = byUri;
-    }
-    static fromManifest(manifest, bodies) {
-        const entries = manifest.entries.filter((e)=>"deprecated" !== e.status).map((e)=>({
-                ...e,
-                body: bodies[e.uri] ?? ""
-            }));
-        const fuse = new fuse_0(entries, {
-            useExtendedSearch: true,
-            ignoreLocation: true,
-            includeScore: true,
-            includeMatches: true,
-            minMatchCharLength: 2,
-            threshold: FUSE_THRESHOLD,
-            keys: [
-                {
-                    name: "title",
-                    weight: 0.55
-                },
-                {
-                    name: "tags",
-                    weight: 0.3
-                },
-                {
-                    name: "summary",
-                    weight: 0.12
-                },
-                {
-                    name: "body",
-                    weight: 0.03
-                }
-            ]
-        });
-        const byUri = new Map(entries.map((e)=>[
-                e.uri,
-                e
-            ]));
-        return new DocIndex(fuse, entries, byUri);
-    }
-    search(query, opts = {}) {
-        const limit = opts.limit ?? 10;
-        const tokens = query.toLowerCase().split(/\s+/).filter((t)=>t.length >= 2 && !STOP_WORDS.has(t));
-        const raw = tokens.length > 0 ? this.fuse.search(tokens.map((t)=>`'${t}`).join(" | ")) : [];
-        const filteredByTier = opts.tier ? raw.filter((r)=>r.item.tier === opts.tier) : raw;
-        const ranked = filteredByTier.length > 0 ? filteredByTier.map((r)=>toRanked(r.item, r.score, r.matches ?? [])) : this.fallback(opts.tier);
-        ranked.sort((a, b)=>b.confidence - a.confidence || (b.item.priority ?? 0.5) - (a.item.priority ?? 0.5));
-        const present = new Set(ranked.map((r)=>r.item.uri));
-        const seeAlso = [];
-        for (const r of ranked.slice(0, 3))for (const rel of r.item.related){
-            const uri = rel.startsWith("silk://") ? rel : `silk://${rel}`;
-            if (present.has(uri)) continue;
-            const neighbor = this.byUri.get(uri);
-            if (neighbor) {
-                present.add(uri);
-                seeAlso.push({
-                    item: neighbor,
-                    confidence: 0,
-                    matchedOn: [
-                        "related"
-                    ]
-                });
-            }
-        }
-        return [
-            ...ranked,
-            ...seeAlso
-        ].slice(0, limit).map(({ item, confidence, matchedOn })=>({
-                uri: item.uri,
-                title: item.title,
-                summary: item.summary,
-                tags: item.tags,
-                tier: item.tier,
-                confidence: Number(confidence.toFixed(3)),
-                confidenceLabel: confidenceLabel(confidence),
-                matchedOn: [
-                    ...new Set(matchedOn)
-                ].filter(Boolean),
-                related: item.related
-            }));
-    }
-    fallback(tier) {
-        return this.entries.filter((e)=>tier ? e.tier === tier : true).slice().sort((a, b)=>(b.priority ?? 0.5) - (a.priority ?? 0.5)).slice(0, 5).map((item)=>({
-                item,
-                confidence: 0,
-                matchedOn: []
-            }));
-    }
-}
+import { NodeContext } from "@effect/platform-node";
+
+//#region src/bin.ts
+/**
+* Binary entrypoint for the `savvy-mcp` server.
+*
+* Resolves the project working directory, builds the long-lived runtime, and
+* starts the MCP server over stdio.
+*
+* @internal
+*/
+/* v8 ignore start -- process bootstrap; covered by server.smoke.test.ts */
 function resolveProjectDir() {
-    const argv = process.argv[2];
-    const fromArgv = void 0 !== argv && argv.trim().length > 0 && !(argv.startsWith("${") && argv.endsWith("}")) ? argv.trim() : void 0;
-    return fromArgv ?? process.env.SAVVY_MCP_PROJECT_DIR ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
+	const argv = process.argv[2];
+	return (argv !== void 0 && argv.trim().length > 0 && !(argv.startsWith("${") && argv.endsWith("}")) ? argv.trim() : void 0) ?? process.env.SAVVY_MCP_PROJECT_DIR ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
 }
 async function main() {
-    const cwd = resolveProjectDir();
-    const appLayer = SilkRuntimeLive.pipe(Layer.provide(NodeContext.layer));
-    const runtime = ManagedRuntime.make(appLayer);
-    const contentRoot = resolveContentRoot();
-    const manifest = loadManifest(contentRoot);
-    const bodies = Object.fromEntries(manifest.entries.map((e)=>[
-            e.uri,
-            readDocBody(contentRoot, e.uri.replace(/^silk:\/\//, ""))
-        ]));
-    const docIndex = DocIndex.fromManifest(manifest, bodies);
-    const ctx = {
-        runtime,
-        cwd,
-        docIndex,
-        manifest,
-        contentRoot
-    };
-    process.stderr.write(`[savvy-mcp] starting in ${cwd}\n`);
-    await startMcpServer(ctx);
+	const cwd = resolveProjectDir();
+	const appLayer = SilkRuntimeLive.pipe(Layer.provide(NodeContext.layer));
+	const runtime = ManagedRuntime.make(appLayer);
+	const contentRoot = resolveContentRoot();
+	const manifest = loadManifest(contentRoot);
+	const bodies = Object.fromEntries(manifest.entries.map((e) => [e.uri, readDocBody(contentRoot, e.uri.replace(/^silk:\/\//, ""))]));
+	const ctx = {
+		runtime,
+		cwd,
+		docIndex: DocIndex.fromManifest(manifest, bodies),
+		manifest,
+		contentRoot
+	};
+	process.stderr.write(`[savvy-mcp] starting in ${cwd}\n`);
+	await startMcpServer(ctx);
 }
-main().catch((err)=>{
-    process.stderr.write(`savvy-mcp: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
-    process.exit(1);
+main().catch((err) => {
+	process.stderr.write(`savvy-mcp: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+	process.exit(1);
 });
+/* v8 ignore stop */
+
+//#endregion
+export {  };

package/package.json

@@ -1,82 +1,44 @@
 {
-  "name": "@savvy-web/mcp",
-  "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",
-  "bugs": {
-    "url": "https://github.com/savvy-web/systems/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/savvy-web/systems.git",
-    "directory": "packages/mcp"
-  },
-  "license": "MIT",
-  "author": {
-    "name": "C. Spencer Beggs",
-    "email": "spencer@savvyweb.systems",
-    "url": "https://savvyweb.systems"
-  },
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "import": "./index.js"
-    }
-  },
-  "bin": {
-    "savvy-mcp": "bin/savvy-mcp.js"
-  },
-  "files": [
-    "!mcp.api.json",
-    "!tsconfig.json",
-    "!tsdoc.json",
-    "547.js",
-    "README.md",
-    "bin/savvy-mcp.js",
-    "index.d.ts",
-    "index.js",
-    "package.json",
-    "resources",
-    "resources/content/_templates/guides.md",
-    "resources/content/_templates/packages.md",
-    "resources/content/_templates/standards.md",
-    "resources/content/guides/api-docs-from-api-extractor.md",
-    "resources/content/guides/building-a-github-action.md",
-    "resources/content/guides/choosing-a-builder.md",
-    "resources/content/guides/llm-friendly-json-schemas.md",
-    "resources/content/manifest.json",
-    "resources/content/packages/cli/command-tree.md",
-    "resources/content/packages/cli/init-and-check.md",
-    "resources/content/packages/mcp/resource-taxonomy.md",
-    "resources/content/packages/rslib-builder/overview.md",
-    "resources/content/packages/silk-effects/index.md",
-    "resources/content/packages/silk-effects/managed-section.md",
-    "resources/content/packages/silk-effects/platform-layers.md",
-    "resources/content/packages/silk/export-map.md",
-    "resources/content/packages/silk/install-and-setup.md",
-    "resources/content/standards/api-model-pipeline.md",
-    "resources/content/standards/catalog-usage.md",
-    "resources/content/standards/changeset-discipline.md",
-    "resources/content/standards/changeset-format.md",
-    "resources/content/standards/commit-contract.md",
-    "resources/content/standards/dependency-conventions.md",
-    "resources/content/standards/linting-conventions.md",
-    "resources/content/standards/publishability.md",
-    "resources/content/standards/semver.md",
-    "resources/content/standards/test-classification.md",
-    "resources/content/tags.json",
-    "tsdoc-metadata.json"
-  ],
-  "dependencies": {
-    "@effect/platform": "^0.96.1",
-    "@effect/platform-node": "^0.106.0",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@savvy-web/silk-effects": "0.6.0",
-    "effect": "^3.21.2",
-    "fuse.js": "^7.4.0",
-    "workspaces-effect": "^1.1.0",
-    "zod": "^4.4.3"
-  }
+	"name": "@savvy-web/mcp",
+	"version": "0.4.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",
+	"bugs": {
+		"url": "https://github.com/savvy-web/systems/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/savvy-web/systems.git",
+		"directory": "packages/mcp"
+	},
+	"license": "MIT",
+	"author": {
+		"name": "C. Spencer Beggs",
+		"email": "spencer@savvyweb.systems",
+		"url": "https://savvyweb.systems"
+	},
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./index.d.ts",
+			"import": "./index.js"
+		}
+	},
+	"bin": {
+		"savvy-mcp": "bin/savvy-mcp.js"
+	},
+	"files": [
+		"public"
+	],
+	"dependencies": {
+		"@effect/platform": "^0.96.1",
+		"@effect/platform-node": "^0.106.0",
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"@savvy-web/silk-effects": "1.0.0",
+		"effect": "^3.21.2",
+		"fuse.js": "^7.4.0",
+		"workspaces-effect": "^1.1.0",
+		"zod": "^4.4.3"
+	}
 }