@savvy-web/mcp 1.1.2 → 1.2.0

package/README.md

@@ -44,7 +44,10 @@ 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.
-- `changeset_inspect` — read-only changeset analysis for release work: `mode=branch` diffs the current branch against its base and attributes every changed file to its owning package, `mode=config` surfaces the resolved `.changeset/config.json` with its release surfaces, version files and ignore list. It never writes a changeset. Backed by the same `silk-effects` changeset services the `savvy` CLI uses.
+- `changeset_inspect` — read-only changeset analysis for release work: `mode=branch` diffs the current branch against its base and attributes every changed file to its owning package, `mode=config` surfaces the resolved `.changeset/config.json` with its release surfaces, version files and ignore list, and `mode=classify` reports how the branch's pending changesets classify each package's bump. It never writes a changeset. Backed by the same `silk-effects` changeset services the `savvy` CLI uses.
+- `changeset_validate` — read-only validation of the files in a changeset directory against the section-aware rules, returning typed diagnostics (file, rule, line, column, message) plus an ok flag and error count. Use it instead of shelling out to `savvy changeset lint`.
+- `changeset_preview` — read-only preview of the next release: it runs the genuine changesets engine over the pending changesets and returns each package's version bump (old to new) plus the rendered CHANGELOG block, exactly as it would ship. It never mutates the repo. Backed by the same `silk-effects` release planner the `savvy changeset version` command applies.
+- `biome_check` — run Biome over a path and get structured diagnostics back: `mode=check` (lint, format and organize-imports) or `mode=lint`. Unlike the other tools it can mutate — pass `write` for safe fixes or `unsafe` for unsafe ones (both git-reversible) — so it returns the same diagnostics the Biome LSP surfaces for files you have edited.
 
 ## Resources
 

package/index.d.ts

@@ -84,7 +84,7 @@ declare class DocIndex {
 //#region src/context.d.ts
 /** The long-lived runtime, the project working directory, and the resource layer. */
 interface McpContext {
-  readonly runtime: ManagedRuntime.ManagedRuntime<SilkWorkspaceAnalyzer | WorkspaceRoot | Turbo.TurboInspector | Changesets.BranchAnalyzer | Changesets.ConfigInspector, WorkspaceDiscoveryError>;
+  readonly runtime: ManagedRuntime.ManagedRuntime<SilkWorkspaceAnalyzer | WorkspaceRoot | Turbo.TurboInspector | Changesets.BranchAnalyzer | Changesets.ConfigInspector | Changesets.ReleasePlanner, WorkspaceDiscoveryError>;
   readonly cwd: string;
   readonly docIndex: DocIndex;
   readonly manifest: Manifest;
@@ -94,16 +94,17 @@ interface McpContext {
 //#region src/runtime.d.ts
 /**
  * The MCP runtime layer. Provides `SilkWorkspaceAnalyzer`, `WorkspaceRoot`,
- * `Turbo.TurboInspector`, `Changesets.BranchAnalyzer`, and
- * `Changesets.ConfigInspector`; requires `CommandExecutor` + `FileSystem` +
- * `Path` from the host's platform layer (`NodeContext.layer` in bin.ts).
+ * `Turbo.TurboInspector`, `Changesets.BranchAnalyzer`,
+ * `Changesets.ConfigInspector`, and `Changesets.ReleasePlanner`; requires
+ * `CommandExecutor` + `FileSystem` + `Path` from the host's platform layer
+ * (`NodeContext.layer` in bin.ts).
  *
  * `TurboInspectorLive` is fed its own `ToolDiscoveryLive`, whose
  * `PackageManagerDetector` + `WorkspaceRoot` requirements are satisfied by
  * {@link DepsLive}; the leftover `CommandExecutor` + `FileSystem` flow up to the
  * host platform layer.
  */
-declare const SilkRuntimeLive: Layer.Layer<import("@savvy-web/silk-effects").SilkWorkspaceAnalyzer | import("workspaces-effect").WorkspaceRoot | Turbo.TurboInspector | Changesets.BranchAnalyzer | Changesets.ConfigInspector, import("workspaces-effect").WorkspaceDiscoveryError, import("@effect/platform/FileSystem").FileSystem | import("@effect/platform/Path").Path | import("@effect/platform/CommandExecutor").CommandExecutor>;
+declare const SilkRuntimeLive: Layer.Layer<import("@savvy-web/silk-effects").SilkWorkspaceAnalyzer | import("workspaces-effect").WorkspaceRoot | Turbo.TurboInspector | Changesets.BranchAnalyzer | Changesets.ConfigInspector | Changesets.ReleasePlanner, import("workspaces-effect").WorkspaceDiscoveryError, import("@effect/platform/FileSystem").FileSystem | import("@effect/platform/Path").Path | import("@effect/platform/CommandExecutor").CommandExecutor>;
 //#endregion
 //#region src/server.d.ts
 /** Build the server and connect it over stdio. */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/mcp",
-	"version": "1.1.2",
+	"version": "1.2.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",
@@ -36,7 +36,7 @@
 		"@effect/rpc": "^0.75.1",
 		"@effect/sql": "^0.51.1",
 		"@modelcontextprotocol/sdk": "^1.29.0",
-		"@savvy-web/silk-effects": "1.3.1",
+		"@savvy-web/silk-effects": "1.4.0",
 		"effect": "^3.21.3",
 		"fuse.js": "^7.4.0",
 		"workspaces-effect": "^1.2.0",

package/runtime.js

@@ -22,12 +22,13 @@ import { WorkspaceRootLive, WorkspacesLive } from "workspaces-effect";
 * cross-feed sibling layers.
 */
 const DepsLive = Layer.mergeAll(WorkspacesLive, ChangesetConfigReaderLive, TagStrategyLive, VersioningStrategyLive.pipe(Layer.provide(ChangesetConfigReaderLive)));
-const InspectorAndAnalyzerLive = Changesets.BranchAnalyzerLive.pipe(Layer.provideMerge(Changesets.ConfigInspectorLive));
+const InspectorAndAnalyzerLive = Changesets.BranchAnalyzerLive.pipe(Layer.provideMerge(Changesets.ReleasePlannerLive), Layer.provideMerge(Changesets.ConfigInspectorLive));
 /**
 * The MCP runtime layer. Provides `SilkWorkspaceAnalyzer`, `WorkspaceRoot`,
-* `Turbo.TurboInspector`, `Changesets.BranchAnalyzer`, and
-* `Changesets.ConfigInspector`; requires `CommandExecutor` + `FileSystem` +
-* `Path` from the host's platform layer (`NodeContext.layer` in bin.ts).
+* `Turbo.TurboInspector`, `Changesets.BranchAnalyzer`,
+* `Changesets.ConfigInspector`, and `Changesets.ReleasePlanner`; requires
+* `CommandExecutor` + `FileSystem` + `Path` from the host's platform layer
+* (`NodeContext.layer` in bin.ts).
 *
 * `TurboInspectorLive` is fed its own `ToolDiscoveryLive`, whose
 * `PackageManagerDetector` + `WorkspaceRoot` requirements are satisfied by

package/server.js

@@ -3,6 +3,7 @@ import { stderrQueryLogger } from "./resources/query-log.js";
 import { effectToZodSchema } from "./schema/effect-to-zod.js";
 import { BiomeCheckAsMarkdown, BiomeCheckResult, runBiomeCheck } from "./tools/biome-check.js";
 import { ChangesetInspectAsMarkdown, ChangesetInspectResult, changesetInspect } from "./tools/changeset-inspect.js";
+import { ChangesetPreviewAsMarkdown, ChangesetPreviewResult, changesetPreview } from "./tools/changeset-preview.js";
 import { ChangesetValidateAsMarkdown, ChangesetValidateResult, changesetValidate } from "./tools/changeset-validate.js";
 import { DocsSearchResult, DocsSearchResultAsMarkdown, runDocsSearch } from "./tools/docs-search.js";
 import { TurboInspectAsMarkdown, TurboInspectResult, turboInspect } from "./tools/turbo-inspect.js";
@@ -111,6 +112,15 @@ function buildServer(ctx) {
 		const data = await ctx.runtime.runPromise(changesetValidate(args, ctx.cwd));
 		return structuredResult(Schema.decodeSync(ChangesetValidateAsMarkdown)(data), data);
 	});
+	server.registerTool("changeset_preview", {
+		description: "Read-only preview of the next release. Runs the genuine changesets engine over the pending changesets and returns each package's version bump (old -> new) plus the rendered CHANGELOG block (dependency tables included), exactly as it would ship. Does not modify the repo. Prefer this over hand-merging changeset files.",
+		inputSchema: { cwd: z.optional(z.string()).describe("Directory to resolve the workspace root from.") },
+		outputSchema: effectToZodSchema(ChangesetPreviewResult),
+		annotations: { readOnlyHint: true }
+	}, async (args) => {
+		const data = await ctx.runtime.runPromise(changesetPreview(args, ctx.cwd));
+		return structuredResult(Schema.decodeSync(ChangesetPreviewAsMarkdown)(data), data);
+	});
 	server.registerTool("biome_check", {
 		description: "Run Biome over a path and get structured diagnostics back. mode=check (default; lint + format + organize-imports) or mode=lint. Set write=true to apply safe fixes (--write), unsafe=true for unsafe fixes (--write --unsafe). Prefer this over shelling out to biome; the LSP already covers files you've edited. Returns markdown in content[] and a typed object in structuredContent. NOTE: with write/unsafe this tool MUTATES files (git-reversible).",
 		inputSchema: {

package/tools/changeset-preview.js

@@ -0,0 +1,52 @@
+import { Changesets } from "@savvy-web/silk-effects";
+import { Effect, ParseResult, Schema } from "effect";
+import { WorkspaceRoot } from "workspaces-effect";
+
+//#region src/tools/changeset-preview.ts
+/**
+* The `changeset_preview` MCP tool: a read-only preview of the next release's
+* CHANGELOG, produced by the genuine changesets engine via silk-effects'
+* ReleasePlanner. Structured result + one-way markdown transform. Read-only.
+*
+* @packageDocumentation
+*/
+/** The `changeset_preview` result — the silk-effects preview shape. */
+const ChangesetPreviewResult = Changesets.ChangesetPreviewSchema.annotations({
+	identifier: "ChangesetPreviewResult",
+	title: "changeset_preview result",
+	description: "Read-only preview of the next release: version bumps + rendered CHANGELOG blocks."
+});
+/** Render a value as an inert markdown code span (escapes backticks/backslashes). */
+const mdInline = (value) => `\`${value.replace(/[`\\]/g, "\\$&")}\``;
+/** Render the structured preview as a markdown transcript. */
+const renderMarkdown = (data) => {
+	if (data.releases.length === 0) return "# changeset preview\n\nNo pending changesets.";
+	const lines = [
+		`# changeset preview${data.preMode ? ` (pre: ${data.preMode})` : ""}`,
+		``,
+		`## Version bumps`,
+		``
+	];
+	lines.push(`| Package | Old | New | Bump |`, `| --- | --- | --- | --- |`);
+	for (const r of data.releases) lines.push(`| ${mdInline(r.name)} | ${r.oldVersion} | ${r.newVersion} | ${r.type} |`);
+	lines.push(``, `## Release notes`, ``);
+	for (const r of data.releases) lines.push(`### ${mdInline(r.name)}`, ``, r.changelogEntry, ``);
+	return lines.join("\n").trimEnd();
+};
+/** One-way transform: result to markdown. Encoding back is forbidden. */
+const ChangesetPreviewAsMarkdown = Schema.transformOrFail(ChangesetPreviewResult, Schema.String, {
+	strict: true,
+	decode: (data) => ParseResult.succeed(renderMarkdown(data)),
+	encode: (text, _options, ast) => ParseResult.fail(new ParseResult.Forbidden(ast, text, "ChangesetPreviewAsMarkdown is one-way: markdown cannot be parsed back."))
+});
+/**
+* Effect handler: resolve the workspace root, then render the preview via
+* ReleasePlanner. Mirrors `changesetInspect`.
+*/
+const changesetPreview = (args, fallbackCwd) => Effect.gen(function* () {
+	const root = yield* (yield* WorkspaceRoot).find(args.cwd ?? fallbackCwd);
+	return yield* (yield* Changesets.ReleasePlanner).preview(root);
+});
+
+//#endregion
+export { ChangesetPreviewAsMarkdown, ChangesetPreviewResult, changesetPreview };