@savvy-web/mcp 1.3.2 → 1.3.4

package/resources/index.js

@@ -1,6 +1,7 @@
 import { renderCatalogMarkdown } from "./catalog.js";
 import { readDocBody } from "./load.js";
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
 
 //#region src/resources/index.ts
 const resourceName = (entry) => `silk_${entry.id.replace(/[^A-Za-z0-9]/g, "_")}`;
@@ -21,7 +22,15 @@ function registerAllResources(server, deps) {
 		text: renderCatalogMarkdown(manifest)
 	}] }));
 	const byUri = new Map(manifest.entries.map((e) => [e.uri, e]));
-	const readBody = (uri, relPath) => bodies ? bodies[uri] ?? "" : readDocBody(contentRoot, relPath);
+	const readBody = (uri, relPath) => {
+		if (bodies) return bodies[uri] ?? "";
+		try {
+			return readDocBody(contentRoot, relPath);
+		} catch (err) {
+			if (err?.code === "ENOENT") throw new McpError(ErrorCode.InvalidParams, `Resource not found: ${uri}`);
+			throw new McpError(ErrorCode.InternalError, `Failed to read resource: ${uri}`);
+		}
+	};
 	server.registerResource("silk_doc", new ResourceTemplate("silk://{+path}", { list: async () => ({ resources: manifest.entries.filter((e) => e.status !== "deprecated").map((e) => ({
 		name: resourceName(e),
 		uri: e.uri,

package/resources/schema.js

@@ -37,4 +37,4 @@ const decodeDocFrontMatter = Schema.decodeUnknown(DocFrontMatter);
 const decodeManifest = Schema.decodeUnknown(Manifest);
 
 //#endregion
-export { Manifest };
+export { Audience, DocFrontMatter, Manifest, ManifestEntry, Source, Status, Tier };

package/server.js

@@ -149,4 +149,4 @@ async function startMcpServer(ctx) {
 }
 
 //#endregion
-export { startMcpServer };
+export { buildServer, startMcpServer };

package/tools/biome-check.js

@@ -185,4 +185,4 @@ const runBiomeCheck = async (args, fallbackCwd) => {
 };
 
 //#endregion
-export { BiomeCheckAsMarkdown, BiomeCheckResult, runBiomeCheck };
+export { BiomeCheckAsMarkdown, BiomeCheckResult, BiomeDiagnostic, BiomeSeverity, buildBiomeResult, parseBiomeGitlab, runBiomeCheck };

package/tools/changeset-inspect.js

@@ -123,4 +123,4 @@ const changesetInspect = (args, fallbackCwd) => Effect.gen(function* () {
 });
 
 //#endregion
-export { ChangesetInspectAsMarkdown, ChangesetInspectResult, changesetInspect };
+export { ChangesetBranchResult, ChangesetClassifyResult, ChangesetConfigResult, ChangesetInspectAsMarkdown, ChangesetInspectResult, changesetInspect };

package/tools/changeset-validate.js

@@ -81,4 +81,4 @@ const changesetValidate = (args, fallbackCwd) => Effect.gen(function* () {
 });
 
 //#endregion
-export { ChangesetValidateAsMarkdown, ChangesetValidateResult, changesetValidate };
+export { ChangesetLintMessage, ChangesetValidateAsMarkdown, ChangesetValidateError, ChangesetValidateResult, changesetValidate };

package/tools/docs-search.js

@@ -6,7 +6,7 @@ import { ParseResult, Schema } from "effect";
 * The `silk_docs_search` MCP tool: a read-only Fuse-backed search over the
 * resource corpus. Takes a plain keyword/phrase query (no operator DSL),
 * returns ranked results with normalized higher-is-better confidence, and
-* never returns empty.
+* returns an empty result set for a real query that matches nothing.
 *
 * @packageDocumentation
 */
@@ -56,4 +56,4 @@ const runDocsSearch = (index, query, opts, logger) => {
 };
 
 //#endregion
-export { DocsSearchResult, DocsSearchResultAsMarkdown, runDocsSearch };
+export { DocsSearchHit, DocsSearchResult, DocsSearchResultAsMarkdown, formatDocsSearchMarkdown, runDocsSearch };

package/tools/turbo-inspect.js

@@ -110,4 +110,4 @@ const turboInspect = (args, fallbackCwd) => Effect.gen(function* () {
 });
 
 //#endregion
-export { TurboInspectAsMarkdown, TurboInspectResult, turboInspect };
+export { TurboAffectedResult, TurboCacheResult, TurboGraphResult, TurboInspectAsMarkdown, TurboInspectResult, turboInspect };

package/tools/workspace-info.js

@@ -89,4 +89,4 @@ const workspaceInfo = (base) => Effect.gen(function* () {
 });
 
 //#endregion
-export { WorkspaceInfoAsMarkdown, WorkspaceInfoResult, workspaceInfo };
+export { WorkspaceInfoAsMarkdown, WorkspaceInfoResult, WorkspaceSummary, formatWorkspaceInfoMarkdown, toWorkspaceInfoResult, workspaceInfo };

package/public/content/packages/rslib-builder/overview.md

@@ -1,68 +0,0 @@
----
-id: packages/rslib-builder/overview
-title: rslib-builder overview
-summary: Load when setting up or understanding the rslib-builder build for a Silk package.
-tier: packages
-source: hand
-tags: [build]
-priority: 0.5
-related: [standards/catalog-usage, standards/publishability]
----
-
-## What
-
-`@savvy-web/rslib-builder` is a zero-config rsbuild-based build tool for Silk Suite
-TypeScript packages. It reads a package's `exports` field to discover entry points,
-builds dev and production outputs, generates type declarations, and transforms the
-output `package.json` for publishing. A package opts in with a one-line
-`rslib.config.ts`.
-
-## API
-
-```typescript
-import { NodeLibraryBuilder } from "@savvy-web/rslib-builder";
-
-export default NodeLibraryBuilder.create({
-  externals: ["@rslib/core"], // optional: do not bundle these
-});
-```
-
-Entry points come from `package.json` `exports` (e.g. `"."` → `./src/index.ts`,
-`"./utils"` → `./src/utils/index.ts`). Peer dependencies are `@rslib/core` and
-`@typescript/native-preview`.
-
-## Layer
-
-Build scripts:
-
-```json
-{
-  "scripts": {
-    "build": "rslib build --env-mode dev",
-    "build:npm": "rslib build --env-mode npm"
-  }
-}
-```
-
-The dev build writes `dist/dev/` with bundled JS, source maps, declarations, and a
-transformed `package.json`. The npm build writes `dist/npm/` optimized for publish
-(no source maps, bundled declarations, a publish-ready `package.json`).
-
-## Usage
-
-The output `package.json` is transformed from source: export paths move from `.ts`
-to `.js`, type conditions are added to exports, pnpm `catalog:` references resolve
-to concrete versions, and the `files` array is generated. This is the mechanism
-behind the convention that a source `package.json` is `private: true` while its
-`publishConfig` declares publish intent — the builder flips `private` based on
-`publishConfig.access` at build time.
-
-First builds are slower due to cache warming; subsequent builds use `.rslib/cache/`.
-A common pitfall: relative imports must use `.js` extensions (the ESM requirement),
-or the build reports "cannot find module".
-
-## Related
-
-Dependency pinning the build resolves: `silk://standards/catalog-usage`. How
-`private` and `publishConfig` decide what publishes:
-`silk://standards/publishability`.