@refrakt-md/mcp 0.11.0 → 0.11.2

package/dist/bin.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Stdio entry point for the refrakt MCP server.
+ *
+ * Usage:
+ *   refrakt-mcp [--cwd <path>]
+ *
+ * Reads the project root from `--cwd` (or `process.cwd()` by default), then
+ * starts the MCP server on stdio.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/bin.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * Stdio entry point for the refrakt MCP server.
+ *
+ * Usage:
+ *   refrakt-mcp [--cwd <path>]
+ *
+ * Reads the project root from `--cwd` (or `process.cwd()` by default), then
+ * starts the MCP server on stdio.
+ */
+import { runStdioServer } from './server.js';
+function parseArgs(argv) {
+    let cwd;
+    let help = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--cwd') {
+            cwd = argv[++i];
+            if (!cwd) {
+                console.error('Error: --cwd requires a path');
+                process.exit(1);
+            }
+        }
+        else if (a === '--help' || a === '-h') {
+            help = true;
+        }
+        else {
+            console.error(`Error: Unknown argument "${a}"`);
+            process.exit(1);
+        }
+    }
+    return { cwd, help };
+}
+const { cwd, help } = parseArgs(process.argv.slice(2));
+if (help) {
+    console.log(`
+Usage: refrakt-mcp [--cwd <path>]
+
+A Model Context Protocol server that wraps the refrakt CLI. Speaks JSON-RPC
+over stdio. Register it with your MCP client (Claude Desktop, Claude Code,
+Cursor, etc.) by adding to the client's config:
+
+  "refrakt": {
+    "command": "npx",
+    "args": ["-y", "@refrakt-md/mcp"]
+  }
+
+Options:
+  --cwd <path>     Project root the server operates against. Defaults to
+                   process.cwd(). Useful when the MCP client launches the
+                   server from a different directory.
+
+  --help, -h       Show this help message.
+`);
+    process.exit(0);
+}
+runStdioServer({ cwd }).catch((err) => {
+    process.stderr.write(`refrakt-mcp failed to start: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,SAAS,SAAS,CAAC,IAAc;IAChC,IAAI,GAAuB,CAAC;IAC5B,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YACnB,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC,GAAG,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC;QACF,CAAC;aAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACzC,IAAI,GAAG,IAAI,CAAC;QACb,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvD,IAAI,IAAI,EAAE,CAAC;IACV,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;CAkBZ,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/cli-bin.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resolve the path to the `@refrakt-md/cli` bin entry from the running MCP
+ * package. Used by both the CLI-shelling tool handlers and the resource
+ * handlers.
+ *
+ * Resolution order:
+ *   1. `@refrakt-md/cli/package.json` (works when the cli package exports it).
+ *   2. `@refrakt-md/cli/lib/plugins.js` (always exported); walk up to the
+ *      package root and append `dist/bin.js`.
+ *
+ * If both fail, throws a clear error rather than returning a bare `'refrakt'`
+ * string — that fallback used to silently produce confusing
+ * `Cannot find module '<cwd>/refrakt'` errors when execFileSync resolved the
+ * relative path against the user's cwd.
+ */
+export declare function resolveCliBin(): string;
+//# sourceMappingURL=cli-bin.d.ts.map

package/dist/cli-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-bin.d.ts","sourceRoot":"","sources":["../src/cli-bin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,wBAAgB,aAAa,IAAI,MAAM,CA2BtC"}

package/dist/cli-bin.js

@@ -0,0 +1,46 @@
+/**
+ * Resolve the path to the `@refrakt-md/cli` bin entry from the running MCP
+ * package. Used by both the CLI-shelling tool handlers and the resource
+ * handlers.
+ *
+ * Resolution order:
+ *   1. `@refrakt-md/cli/package.json` (works when the cli package exports it).
+ *   2. `@refrakt-md/cli/lib/plugins.js` (always exported); walk up to the
+ *      package root and append `dist/bin.js`.
+ *
+ * If both fail, throws a clear error rather than returning a bare `'refrakt'`
+ * string — that fallback used to silently produce confusing
+ * `Cannot find module '<cwd>/refrakt'` errors when execFileSync resolved the
+ * relative path against the user's cwd.
+ */
+import { createRequire } from 'node:module';
+import { resolve, dirname } from 'node:path';
+const require_ = createRequire(import.meta.url);
+let cached;
+export function resolveCliBin() {
+    if (cached)
+        return cached;
+    const errors = [];
+    try {
+        const pkgJsonPath = require_.resolve('@refrakt-md/cli/package.json');
+        cached = resolve(dirname(pkgJsonPath), 'dist', 'bin.js');
+        return cached;
+    }
+    catch (err) {
+        errors.push(`package.json: ${err.message}`);
+    }
+    try {
+        // `lib/plugins.js` is always declared in @refrakt-md/cli's exports map.
+        // From .../node_modules/@refrakt-md/cli/dist/lib/plugins.js, walk up two
+        // directories to reach the package root.
+        const pluginsPath = require_.resolve('@refrakt-md/cli/lib/plugins.js');
+        const pkgDir = dirname(dirname(dirname(pluginsPath)));
+        cached = resolve(pkgDir, 'dist', 'bin.js');
+        return cached;
+    }
+    catch (err) {
+        errors.push(`lib/plugins.js: ${err.message}`);
+    }
+    throw new Error(`Unable to resolve @refrakt-md/cli bin from MCP server. Tried:\n  - ${errors.join('\n  - ')}`);
+}
+//# sourceMappingURL=cli-bin.js.map

package/dist/cli-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-bin.js","sourceRoot":"","sources":["../src/cli-bin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEhD,IAAI,MAA0B,CAAC;AAE/B,MAAM,UAAU,aAAa;IAC5B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC;QACJ,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QACrE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,iBAAkB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC;QACJ,wEAAwE;QACxE,yEAAyE;QACzE,yCAAyC;QACzC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,mBAAoB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,KAAK,CACd,sEAAsE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAC7F,CAAC;AACH,CAAC"}

package/dist/detect.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Auto-detection for the MCP server.
+ *
+ * Inspects the working directory once at startup to figure out which
+ * tool groups should be exposed:
+ * - `plan` context: a `plan/` directory exists.
+ * - `site` context: `refrakt.config.json` declares one or more sites.
+ *
+ * Both can be active in the same project. Neither being active leaves the
+ * server with diagnostic-only tools.
+ */
+import { type DiscoveredPlugin } from '@refrakt-md/cli/lib/plugins.js';
+export interface DetectedPlanContext {
+    dir: string;
+    fileCount: number;
+}
+export interface DetectedSiteContext {
+    configPath: string;
+    sites: string[];
+    plugins: string[];
+}
+export interface DetectionResult {
+    cwd: string;
+    plan: DetectedPlanContext | null;
+    site: DetectedSiteContext | null;
+    plugins: DiscoveredPlugin[];
+    configSource: 'config-file' | 'autodetect';
+}
+export declare function detect(cwd?: string): Promise<DetectionResult>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAExF,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,YAAY,EAAE,aAAa,GAAG,YAAY,CAAC;CAC3C;AAED,wBAAsB,MAAM,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8ClF"}

package/dist/detect.js

@@ -0,0 +1,93 @@
+/**
+ * Auto-detection for the MCP server.
+ *
+ * Inspects the working directory once at startup to figure out which
+ * tool groups should be exposed:
+ * - `plan` context: a `plan/` directory exists.
+ * - `site` context: `refrakt.config.json` declares one or more sites.
+ *
+ * Both can be active in the same project. Neither being active leaves the
+ * server with diagnostic-only tools.
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadRefraktConfigWithRaw } from '@refrakt-md/transform/node';
+import { discoverPlugins } from '@refrakt-md/cli/lib/plugins.js';
+export async function detect(cwd = process.cwd()) {
+    const result = {
+        cwd,
+        plan: null,
+        site: null,
+        plugins: [],
+        configSource: 'autodetect',
+    };
+    const configPath = resolve(cwd, 'refrakt.config.json');
+    if (existsSync(configPath)) {
+        try {
+            const { normalized } = loadRefraktConfigWithRaw(configPath);
+            result.configSource = 'config-file';
+            const siteNames = Object.keys(normalized.sites);
+            if (siteNames.length > 0) {
+                result.site = {
+                    configPath,
+                    sites: siteNames,
+                    plugins: normalized.plugins ?? [],
+                };
+            }
+            if (normalized.plan?.dir) {
+                const planDir = resolve(cwd, normalized.plan.dir);
+                result.plan = describePlanDir(planDir);
+            }
+        }
+        catch {
+            // Malformed config — fall through to autodetect
+        }
+    }
+    // Autodetect plan/ if not declared in config
+    if (!result.plan) {
+        const planDir = resolve(cwd, 'plan');
+        if (existsSync(planDir) && safeIsDirectory(planDir)) {
+            result.plan = describePlanDir(planDir);
+        }
+    }
+    try {
+        result.plugins = await discoverPlugins({ cwd, warn: false });
+    }
+    catch {
+        // Discovery failures are non-fatal
+    }
+    return result;
+}
+function describePlanDir(dir) {
+    let fileCount = 0;
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!existsSync(current) || !safeIsDirectory(current))
+            continue;
+        try {
+            for (const entry of readdirSync(current)) {
+                const full = resolve(current, entry);
+                if (safeIsDirectory(full)) {
+                    stack.push(full);
+                }
+                else if (entry.endsWith('.md')) {
+                    fileCount++;
+                }
+            }
+        }
+        catch {
+            // keep counting what we can
+        }
+    }
+    return { dir, fileCount };
+}
+function safeIsDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @refrakt-md/mcp — Model Context Protocol server wrapping the refrakt CLI.
+ *
+ * Most users will install this and register `refrakt-mcp` (the bin entry) in
+ * their MCP client config. Programmatic consumers can import the server
+ * factory directly.
+ */
+export { createServer, runStdioServer } from './server.js';
+export type { CreateServerOptions } from './server.js';
+export { detect } from './detect.js';
+export type { DetectionResult, DetectedPlanContext, DetectedSiteContext } from './detect.js';
+export { CORE_TOOLS } from './tools/core.js';
+export type { McpTool } from './tools/core.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @refrakt-md/mcp — Model Context Protocol server wrapping the refrakt CLI.
+ *
+ * Most users will install this and register `refrakt-mcp` (the bin entry) in
+ * their MCP client config. Programmatic consumers can import the server
+ * factory directly.
+ */
+export { createServer, runStdioServer } from './server.js';
+export { detect } from './detect.js';
+export { CORE_TOOLS } from './tools/core.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MCP resources — read-only addressable data the server exposes.
+ *
+ * Resources mirror the read-only subset of the tool surface so MCP clients
+ * that prefer pull semantics (ReadResource) get equivalent data without a
+ * tool invocation.
+ *
+ * URI scheme:
+ *   refrakt://detect            — full detection result
+ *   refrakt://reference         — rune syntax reference (JSON)
+ *   refrakt://contracts         — structure contracts (JSON)
+ *   refrakt://rune/<name>       — identity transform output for one rune
+ *   refrakt://plan/index        — list of plan entities
+ *   refrakt://plan/<type>/<id>  — Markdoc source for one plan entity
+ *   refrakt://plan/status       — plan status payload
+ */
+export interface McpResource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+export interface ResourceContent {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+/** Static resource list — dynamic ones (e.g. refrakt://rune/<name>) are
+ *  surfaced via templated entries the client can complete. */
+export declare function listResources(ctx: {
+    cwd: string;
+    hasPlan: boolean;
+    hasSites: boolean;
+}): McpResource[];
+/** Read the contents of a resource by URI. Returns the text payload (always
+ *  JSON for now — markdown could be added later for plan entity reads). */
+export declare function readResource(uri: string, ctx: {
+    cwd: string;
+}): Promise<ResourceContent>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED;8DAC8D;AAC9D,wBAAgB,aAAa,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,EAAE,CA0CtG;AAED;2EAC2E;AAC3E,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAoD9F"}

package/dist/resources.js

@@ -0,0 +1,257 @@
+/**
+ * MCP resources — read-only addressable data the server exposes.
+ *
+ * Resources mirror the read-only subset of the tool surface so MCP clients
+ * that prefer pull semantics (ReadResource) get equivalent data without a
+ * tool invocation.
+ *
+ * URI scheme:
+ *   refrakt://detect            — full detection result
+ *   refrakt://reference         — rune syntax reference (JSON)
+ *   refrakt://contracts         — structure contracts (JSON)
+ *   refrakt://rune/<name>       — identity transform output for one rune
+ *   refrakt://plan/index        — list of plan entities
+ *   refrakt://plan/<type>/<id>  — Markdoc source for one plan entity
+ *   refrakt://plan/status       — plan status payload
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+/** Static resource list — dynamic ones (e.g. refrakt://rune/<name>) are
+ *  surfaced via templated entries the client can complete. */
+export function listResources(ctx) {
+    const list = [
+        {
+            uri: 'refrakt://detect',
+            name: 'detect',
+            description: 'Auto-detection summary for the current project (plan dir, sites, plugins).',
+            mimeType: 'application/json',
+        },
+    ];
+    if (ctx.hasSites) {
+        list.push({
+            uri: 'refrakt://reference',
+            name: 'reference',
+            description: 'Rune syntax reference for the active package set.',
+            mimeType: 'application/json',
+        }, {
+            uri: 'refrakt://contracts',
+            name: 'contracts',
+            description: 'Structure contracts for every rune in the active package set.',
+            mimeType: 'application/json',
+        });
+    }
+    if (ctx.hasPlan) {
+        list.push({
+            uri: 'refrakt://plan/index',
+            name: 'plan-index',
+            description: 'Index of all plan entities (id, type, status, file path).',
+            mimeType: 'application/json',
+        }, {
+            uri: 'refrakt://plan/status',
+            name: 'plan-status',
+            description: 'Plan status summary (counts, milestone progress).',
+            mimeType: 'application/json',
+        });
+    }
+    return list;
+}
+/** Read the contents of a resource by URI. Returns the text payload (always
+ *  JSON for now — markdown could be added later for plan entity reads). */
+export async function readResource(uri, ctx) {
+    if (uri === 'refrakt://detect') {
+        const { detect } = await import('./detect.js');
+        const result = await detect(ctx.cwd);
+        return jsonContent(uri, result);
+    }
+    if (uri === 'refrakt://reference') {
+        return jsonContent(uri, await invokeCli(['reference', '--format', 'json'], ctx.cwd));
+    }
+    if (uri === 'refrakt://contracts') {
+        const stdout = await invokeCliText(['contracts', '-o', '/dev/stdout'], ctx.cwd);
+        const start = stdout.indexOf('{');
+        if (start === -1)
+            throw resourceError(uri, 'contracts produced no JSON output');
+        return { uri, mimeType: 'application/json', text: stdout.slice(start).trim() };
+    }
+    if (uri.startsWith('refrakt://rune/')) {
+        const rest = uri.slice('refrakt://rune/'.length);
+        const [name, query] = rest.split('?');
+        if (!name)
+            throw resourceError(uri, 'missing rune name');
+        const args = ['inspect', name, '--json'];
+        if (query) {
+            for (const pair of query.split('&')) {
+                const [k, v] = pair.split('=');
+                if (!k)
+                    continue;
+                args.push(`--${k}=${v ?? ''}`);
+            }
+        }
+        return jsonContent(uri, await invokeCli(args, ctx.cwd));
+    }
+    if (uri === 'refrakt://plan/index') {
+        return jsonContent(uri, listPlanEntities(ctx.cwd));
+    }
+    if (uri === 'refrakt://plan/status') {
+        return jsonContent(uri, await invokeCli(['plan', 'status', '--format', 'json'], ctx.cwd));
+    }
+    if (uri.startsWith('refrakt://plan/')) {
+        // Single entity by type/id — refrakt://plan/work/WORK-001
+        const rest = uri.slice('refrakt://plan/'.length);
+        const slashIdx = rest.indexOf('/');
+        if (slashIdx === -1)
+            throw resourceError(uri, 'expected refrakt://plan/<type>/<id>');
+        const type = rest.slice(0, slashIdx);
+        const id = rest.slice(slashIdx + 1);
+        return readPlanEntity(uri, ctx.cwd, type, id);
+    }
+    throw resourceError(uri, `unknown resource URI`);
+}
+function listPlanEntities(cwd) {
+    const planDir = resolvePlanDir(cwd);
+    if (!planDir || !existsSync(planDir))
+        return { entities: [] };
+    const entities = [];
+    const stack = [planDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        try {
+            for (const entry of readdirSync(current)) {
+                const full = join(current, entry);
+                if (statSync(full).isDirectory()) {
+                    stack.push(full);
+                }
+                else if (entry.endsWith('.md')) {
+                    try {
+                        const text = readFileSync(full, 'utf-8');
+                        const meta = parseFrontMatter(text);
+                        if (meta) {
+                            entities.push({
+                                ...meta,
+                                file: full.slice(planDir.length + 1),
+                            });
+                        }
+                    }
+                    catch {
+                        // skip unreadable
+                    }
+                }
+            }
+        }
+        catch {
+            // skip unreadable directory
+        }
+    }
+    return { entities };
+}
+function parseFrontMatter(text) {
+    const match = text.match(/\{%\s*(work|bug|spec|decision|milestone)\s+([^%]+)%\}/);
+    if (!match)
+        return undefined;
+    const type = match[1];
+    const attrs = match[2];
+    const idMatch = attrs.match(/(?:id|name)="([^"]+)"/);
+    if (!idMatch)
+        return undefined;
+    const statusMatch = attrs.match(/status="([^"]+)"/);
+    return {
+        id: idMatch[1],
+        type,
+        ...(statusMatch ? { status: statusMatch[1] } : {}),
+    };
+}
+function readPlanEntity(uri, cwd, type, id) {
+    const planDir = resolvePlanDir(cwd);
+    if (!planDir || !existsSync(planDir))
+        throw resourceError(uri, 'plan directory not found');
+    // Look in plan/<type>s/ first (the convention), then anywhere under plan/.
+    const candidates = [
+        join(planDir, `${type}s`),
+        join(planDir, type),
+        planDir,
+    ];
+    for (const dir of candidates) {
+        if (!existsSync(dir))
+            continue;
+        const found = findEntityFile(dir, id);
+        if (found) {
+            return {
+                uri,
+                mimeType: 'text/markdown',
+                text: readFileSync(found, 'utf-8'),
+            };
+        }
+    }
+    throw resourceError(uri, `plan entity ${id} not found`);
+}
+function findEntityFile(dir, id) {
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        try {
+            for (const entry of readdirSync(current)) {
+                const full = join(current, entry);
+                try {
+                    if (statSync(full).isDirectory())
+                        stack.push(full);
+                    else if (entry.endsWith('.md') && entry.includes(id))
+                        return full;
+                }
+                catch {
+                    // skip
+                }
+            }
+        }
+        catch {
+            // skip
+        }
+    }
+    return undefined;
+}
+function resolvePlanDir(cwd) {
+    const configPath = resolve(cwd, 'refrakt.config.json');
+    if (existsSync(configPath)) {
+        try {
+            const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            if (config.plan?.dir)
+                return resolve(cwd, config.plan.dir);
+        }
+        catch {
+            // fall through to default
+        }
+    }
+    const fallback = resolve(cwd, 'plan');
+    return existsSync(fallback) ? fallback : undefined;
+}
+function jsonContent(uri, payload) {
+    return { uri, mimeType: 'application/json', text: JSON.stringify(payload, null, 2) };
+}
+function resourceError(uri, message) {
+    const err = new Error(`${message} (${uri})`);
+    err.errorCode = 'RESOURCE_FAILED';
+    return err;
+}
+/** CLI invocation that returns parsed JSON. */
+async function invokeCli(args, cwd) {
+    const text = await invokeCliText(args, cwd);
+    return JSON.parse(text);
+}
+/** CLI invocation that returns raw stdout text. */
+async function invokeCliText(args, cwd) {
+    const { execFileSync } = await import('node:child_process');
+    const { resolveCliBin } = await import('./cli-bin.js');
+    const bin = resolveCliBin();
+    try {
+        return execFileSync('node', [bin, ...args], {
+            encoding: 'utf-8',
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            maxBuffer: 50 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const stderr = (err.stderr ?? '').toString();
+        throw new Error(`refrakt ${args[0]} failed: ${stderr.trim() || err.message}`);
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,48 @@
+/**
+ * MCP server setup. Registers tools, hooks up the stdio transport, and
+ * dispatches incoming requests.
+ *
+ * The server reads `cwd` from process at start; a `--cwd <path>` flag on the
+ * bin handler can override it for clients that launch the server from outside
+ * the project root.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export interface CreateServerOptions {
+    cwd?: string;
+}
+export declare function createServer(options?: CreateServerOptions): Promise<Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>>;
+export declare function runStdioServer(options?: CreateServerOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAanE,MAAM,WAAW,mBAAmB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+FnE;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrF"}

package/dist/server.js

@@ -0,0 +1,108 @@
+/**
+ * MCP server setup. Registers tools, hooks up the stdio transport, and
+ * dispatches incoming requests.
+ *
+ * The server reads `cwd` from process at start; a `--cwd <path>` flag on the
+ * bin handler can override it for clients that launch the server from outside
+ * the project root.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { CORE_TOOLS } from './tools/core.js';
+import { loadPluginTools } from './tools/plugins.js';
+import { listResources, readResource } from './resources.js';
+import { detect } from './detect.js';
+export async function createServer(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    // Detection happens once at startup so we can both decide which resources
+    // to expose and surface the detection result on `tools/list` for clients
+    // that want to understand the project before invoking anything.
+    const detection = await detect(cwd);
+    const pluginTools = await loadPluginTools(cwd);
+    const tools = [...CORE_TOOLS, ...pluginTools];
+    const server = new Server({
+        name: '@refrakt-md/mcp',
+        version: '0.10.1',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: tools.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = tools.find((t) => t.name === request.params.name);
+        if (!tool) {
+            return {
+                isError: true,
+                content: [
+                    { type: 'text', text: `Unknown tool: ${request.params.name}` },
+                ],
+                _meta: {
+                    errorCode: 'UNKNOWN_TOOL',
+                    hint: `Available tools: ${tools.map((t) => t.name).join(', ')}`,
+                },
+            };
+        }
+        try {
+            const result = await tool.handler(request.params.arguments ?? {}, { cwd });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                    },
+                ],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            const error = err;
+            return {
+                isError: true,
+                content: [
+                    { type: 'text', text: error.message ?? 'Tool invocation failed' },
+                ],
+                _meta: {
+                    errorCode: error.errorCode ?? 'TOOL_FAILED',
+                    ...(error.hint ? { hint: error.hint } : {}),
+                },
+            };
+        }
+    });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: listResources({
+                cwd,
+                hasPlan: detection.plan !== null,
+                hasSites: detection.site !== null,
+            }),
+        };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        try {
+            const content = await readResource(request.params.uri, { cwd });
+            return { contents: [content] };
+        }
+        catch (err) {
+            const error = err;
+            throw new Error(error.message ?? 'Failed to read resource');
+        }
+    });
+    return server;
+}
+export async function runStdioServer(options = {}) {
+    const server = await createServer(options);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACN,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAgB,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAwB,MAAM,aAAa,CAAC;AAM3D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA+B,EAAE;IACnE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEzC,0EAA0E;IAC1E,yEAAyE;IACzE,gEAAgE;IAChE,MAAM,SAAS,GAAoB,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAc,CAAC,GAAG,UAAU,EAAE,GAAG,WAAW,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,IAAI,MAAM,CACxB;QACC,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,QAAQ;KACjB,EACD;QACC,YAAY,EAAE;YACb,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACb;KACD,CACD,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC3D,OAAO;YACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;aAC7B,CAAC,CAAC;SACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACR,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;iBACvE;gBACD,KAAK,EAAE;oBACN,SAAS,EAAE,cAAc;oBACzB,IAAI,EAAE,oBAAoB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAC/D;aACD,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3E,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC3E;iBACD;gBACD,iBAAiB,EAAE,MAA6C;aAChE,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,GAA8D,CAAC;YAC7E,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACR,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,wBAAwB,EAAE;iBAC1E;gBACD,KAAK,EAAE;oBACN,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,aAAa;oBAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC3C;aACD,CAAC;QACH,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QAC/D,OAAO;YACN,SAAS,EAAE,aAAa,CAAC;gBACxB,GAAG;gBACH,OAAO,EAAE,SAAS,CAAC,IAAI,KAAK,IAAI;gBAChC,QAAQ,EAAE,SAAS,CAAC,IAAI,KAAK,IAAI;aACjC,CAAC;SACF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACrE,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAChE,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,GAA2B,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,yBAAyB,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAA+B,EAAE;IACrE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/tools/core.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Core refrakt CLI tools, exposed as MCP tools.
+ *
+ * Each tool delegates to the same underlying logic the `refrakt` CLI uses,
+ * but produces structured JSON output suitable for MCP. Where the underlying
+ * CLI command prints to stdout (rather than returning data), the tool here
+ * captures stdout via a child-process spawn — the cost is one extra fork per
+ * call but it preserves the exact output the user would see.
+ */
+import type { JSONSchema7 } from '@refrakt-md/types';
+/** Shared shape exported by the MCP server for each registered tool. */
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema7;
+    handler: (input: unknown, ctx: {
+        cwd: string;
+    }) => Promise<unknown>;
+}
+export declare const referenceTool: McpTool;
+export declare const contractsTool: McpTool;
+export declare const inspectTool: McpTool;
+export declare const inspectListTool: McpTool;
+export declare const pluginsListTool: McpTool;
+export declare const detectTool: McpTool;
+export declare const CORE_TOOLS: McpTool[];
+//# sourceMappingURL=core.d.ts.map

package/dist/tools/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/tools/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,wEAAwE;AACxE,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAWD,eAAO,MAAM,aAAa,EAAE,OAwB3B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,OAsB3B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,OA8BzB,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,OAc7B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,OAO7B,CAAC;AAMF,eAAO,MAAM,UAAU,EAAE,OAQxB,CAAC;AAMF,eAAO,MAAM,UAAU,EAAE,OAAO,EAO/B,CAAC"}

package/dist/tools/core.js

@@ -0,0 +1,202 @@
+/**
+ * Core refrakt CLI tools, exposed as MCP tools.
+ *
+ * Each tool delegates to the same underlying logic the `refrakt` CLI uses,
+ * but produces structured JSON output suitable for MCP. Where the underlying
+ * CLI command prints to stdout (rather than returning data), the tool here
+ * captures stdout via a child-process spawn — the cost is one extra fork per
+ * call but it preserves the exact output the user would see.
+ */
+import { execFileSync } from 'node:child_process';
+import { resolveCliBin } from '../cli-bin.js';
+const siteProp = {
+    type: 'string',
+    description: 'Site name (required for multi-site projects).',
+};
+// ----------------------------------------------------------------------------
+// refrakt.reference  — emit the rune syntax reference
+// ----------------------------------------------------------------------------
+export const referenceTool = {
+    name: 'refrakt.reference',
+    description: 'Emit the rune syntax reference for the active package set. Useful for AI agents that need to know which runes are available and how to use them.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            format: { type: 'string', enum: ['markdown', 'json'], description: 'Output format. Default: json.' },
+            site: siteProp,
+            rune: { type: 'string', description: 'When set, emit reference for a single rune by name.' },
+        },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const o = input;
+        const args = ['reference'];
+        if (o.rune)
+            args.push(o.rune);
+        args.push('--format', o.format ?? 'json');
+        if (o.site)
+            args.push('--site', o.site);
+        const stdout = invokeCli(args, ctx.cwd);
+        return o.format === 'markdown'
+            ? { format: 'markdown', text: stdout }
+            : tryParseJson(stdout);
+    },
+};
+// ----------------------------------------------------------------------------
+// refrakt.contracts — generate structure contracts JSON
+// ----------------------------------------------------------------------------
+export const contractsTool = {
+    name: 'refrakt.contracts',
+    description: 'Generate the full structure contract for the active rune set: per-rune BEM block, modifiers, data attributes, structural elements. Useful for theme authors and CSS coverage tooling.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            site: siteProp,
+        },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const o = input;
+        const args = ['contracts', '-o', '/dev/stdout'];
+        if (o.site)
+            args.push('--site', o.site);
+        const stdout = invokeCli(args, ctx.cwd);
+        // `refrakt contracts -o /dev/stdout` writes the JSON contract to stdout
+        // followed by a "Written ..." line on stderr — we only want the JSON.
+        const start = stdout.indexOf('{');
+        if (start === -1)
+            throw new Error('contracts produced no JSON output');
+        return JSON.parse(stdout.slice(start));
+    },
+};
+// ----------------------------------------------------------------------------
+// refrakt.inspect — see the identity transform output for a rune
+// ----------------------------------------------------------------------------
+export const inspectTool = {
+    name: 'refrakt.inspect',
+    description: 'Show the identity transform output for a rune: the HTML it produces with BEM classes and data attributes for a given attribute set. Returns the JSON view (--json) so MCP clients can consume the structured contract.',
+    inputSchema: {
+        type: 'object',
+        required: ['rune'],
+        properties: {
+            rune: { type: 'string', description: 'Rune name (e.g. "hint", "hero").' },
+            attributes: {
+                type: 'object',
+                additionalProperties: { type: 'string' },
+                description: 'Rune attributes to set (e.g. { type: "warning" }).',
+            },
+            site: siteProp,
+        },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const o = input;
+        const args = ['inspect', o.rune, '--json'];
+        if (o.attributes) {
+            for (const [k, v] of Object.entries(o.attributes)) {
+                args.push(`--${k}=${v}`);
+            }
+        }
+        if (o.site)
+            args.push('--site', o.site);
+        const stdout = invokeCli(args, ctx.cwd);
+        return tryParseJson(stdout);
+    },
+};
+// ----------------------------------------------------------------------------
+// refrakt.inspect_list — list all available runes
+// ----------------------------------------------------------------------------
+export const inspectListTool = {
+    name: 'refrakt.inspect_list',
+    description: 'List every rune available in the active package set.',
+    inputSchema: {
+        type: 'object',
+        properties: { site: siteProp },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const o = input;
+        const args = ['inspect', '--list', '--json'];
+        if (o.site)
+            args.push('--site', o.site);
+        return tryParseJson(invokeCli(args, ctx.cwd));
+    },
+};
+// ----------------------------------------------------------------------------
+// refrakt.plugins_list — list installed plugins
+// ----------------------------------------------------------------------------
+export const pluginsListTool = {
+    name: 'refrakt.plugins_list',
+    description: 'List installed refrakt plugin packages with their commands and MCP schema availability.',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        return tryParseJson(invokeCli(['plugins', 'list', '--json'], ctx.cwd));
+    },
+};
+// ----------------------------------------------------------------------------
+// refrakt.detect — return the detection result (also exposed as a resource)
+// ----------------------------------------------------------------------------
+export const detectTool = {
+    name: 'refrakt.detect',
+    description: 'Report the detected refrakt context (plan dir, declared sites, installed plugins, config source).',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        const { detect } = await import('../detect.js');
+        return detect(ctx.cwd);
+    },
+};
+// ----------------------------------------------------------------------------
+// Aggregate set
+// ----------------------------------------------------------------------------
+export const CORE_TOOLS = [
+    detectTool,
+    pluginsListTool,
+    referenceTool,
+    contractsTool,
+    inspectTool,
+    inspectListTool,
+];
+// ----------------------------------------------------------------------------
+// Helpers
+// ----------------------------------------------------------------------------
+/** Resolve and invoke the refrakt CLI bin, returning stdout. Throws with the
+ *  CLI's stderr on non-zero exit so the MCP handler surfaces the user-facing
+ *  error message. */
+function invokeCli(args, cwd) {
+    const bin = resolveCliBin();
+    try {
+        return execFileSync('node', [bin, ...args], {
+            encoding: 'utf-8',
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            maxBuffer: 50 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const stderr = (err.stderr ?? '').toString();
+        const stdout = (err.stdout ?? '').toString();
+        const message = stderr || stdout || err.message;
+        const wrapped = new Error(`refrakt ${args[0]} failed: ${message.trim()}`);
+        wrapped.errorCode = 'CLI_INVOCATION_FAILED';
+        throw wrapped;
+    }
+}
+function tryParseJson(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        // Some CLI commands print extra lines around the JSON; pull the first
+        // JSON-shaped substring.
+        const start = trimmed.indexOf('{');
+        const arrStart = trimmed.indexOf('[');
+        const idx = start === -1 ? arrStart : arrStart === -1 ? start : Math.min(start, arrStart);
+        if (idx === -1)
+            return { raw: trimmed };
+        return JSON.parse(trimmed.slice(idx));
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/tools/core.js.map

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

package/dist/tools/plugins.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Plugin-contributed MCP tools.
+ *
+ * Each command from a discovered plugin (e.g. @refrakt-md/plan) becomes an
+ * MCP tool under `<namespace>.<name>`. Commands that declare an `mcpHandler`
+ * are invoked directly with the structured input. Commands without one fall
+ * back to argv-shimming: the handler receives an object, we serialize it into
+ * argv strings, and call the existing CLI handler.
+ */
+import type { McpTool } from './core.js';
+/** Discover installed plugins and convert each command into an MCP tool. */
+export declare function loadPluginTools(cwd: string): Promise<McpTool[]>;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/tools/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/tools/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,4EAA4E;AAC5E,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAWrE"}

package/dist/tools/plugins.js

@@ -0,0 +1,106 @@
+/**
+ * Plugin-contributed MCP tools.
+ *
+ * Each command from a discovered plugin (e.g. @refrakt-md/plan) becomes an
+ * MCP tool under `<namespace>.<name>`. Commands that declare an `mcpHandler`
+ * are invoked directly with the structured input. Commands without one fall
+ * back to argv-shimming: the handler receives an object, we serialize it into
+ * argv strings, and call the existing CLI handler.
+ */
+import { discoverPlugins } from '@refrakt-md/cli/lib/plugins.js';
+/** Commands that should not be exposed via MCP — long-running servers,
+ *  filesystem generators, etc. that don't fit the request/response model. */
+const EXCLUDED_COMMANDS = new Set([
+    'plan.serve',
+    'plan.build',
+]);
+/** Discover installed plugins and convert each command into an MCP tool. */
+export async function loadPluginTools(cwd) {
+    const discovered = await discoverPlugins({ cwd, warn: false });
+    const tools = [];
+    for (const plugin of discovered) {
+        for (const command of plugin.commands) {
+            const toolName = `${plugin.namespace}.${command.name}`;
+            if (EXCLUDED_COMMANDS.has(toolName))
+                continue;
+            tools.push(buildPluginTool(toolName, command));
+        }
+    }
+    return tools;
+}
+function buildPluginTool(name, command) {
+    const inputSchema = command.inputSchema ?? {
+        type: 'object',
+        additionalProperties: true,
+        description: 'Free-form arguments — this command has no inputSchema yet, so MCP cannot validate inputs.',
+    };
+    return {
+        name,
+        description: command.description,
+        inputSchema,
+        handler: async (input) => {
+            if (command.mcpHandler) {
+                return command.mcpHandler(input);
+            }
+            // Fallback: serialize the input as argv and invoke the legacy
+            // handler. Captures stdout via a simple buffer hack.
+            const args = inputToArgv(input);
+            const captured = await captureStdout(() => command.handler(args));
+            return tryParseJson(captured);
+        },
+    };
+}
+/** Translate a structured input object into a flat argv array suitable for
+ *  legacy `handler(args)` consumption. Boolean true → bare flag; everything
+ *  else → `--key`, `value` pair. Nested objects/arrays are JSON-stringified. */
+function inputToArgv(input) {
+    if (!input || typeof input !== 'object')
+        return [];
+    const args = [];
+    for (const [key, value] of Object.entries(input)) {
+        if (value === undefined || value === null)
+            continue;
+        if (value === true) {
+            args.push(`--${key}`);
+            continue;
+        }
+        if (value === false)
+            continue;
+        if (typeof value === 'string' || typeof value === 'number') {
+            args.push(`--${key}`, String(value));
+            continue;
+        }
+        args.push(`--${key}`, JSON.stringify(value));
+    }
+    return args;
+}
+/** Capture writes to process.stdout while running fn(). Restores stdout when
+ *  done. Used as the legacy-handler fallback because most plugin commands
+ *  print structured JSON to stdout when given `--format json`. */
+async function captureStdout(fn) {
+    const chunks = [];
+    const originalWrite = process.stdout.write.bind(process.stdout);
+    process.stdout.write = (chunk) => {
+        chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+        return true;
+    };
+    try {
+        await fn();
+    }
+    finally {
+        process.stdout.write = originalWrite;
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+function tryParseJson(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return { raw: trimmed };
+    }
+}
+//# sourceMappingURL=plugins.js.map

package/dist/tools/plugins.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@refrakt-md/mcp",
 	"description": "Model Context Protocol server wrapping the refrakt CLI",
-	"version": "0.11.0",
+	"version": "0.11.2",
 	"type": "module",
 	"license": "MIT",
 	"repository": {
@@ -33,9 +33,9 @@
 	},
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "^1.29.0",
-		"@refrakt-md/cli": "0.11.0",
-		"@refrakt-md/runes": "0.11.0",
-		"@refrakt-md/transform": "0.11.0",
-		"@refrakt-md/types": "0.11.0"
+		"@refrakt-md/cli": "0.11.2",
+		"@refrakt-md/runes": "0.11.2",
+		"@refrakt-md/transform": "0.11.2",
+		"@refrakt-md/types": "0.11.2"
 	}
 }