@webpresso/agent-kit 0.21.5 → 0.24.0

package/dist/esm/hooks/shared/routing-block.js

@@ -8,6 +8,7 @@ export const WP_ROUTING_BLOCK = `<wp_routing>
   <description>
     Use the wp_* MCP tools for all test, lint, typecheck, qa, audit, local CI act,
     and Cloudflare Worker tail operations.
+    If a wp_* MCP tool is stale or unavailable, use the matching wp CLI command.
     If context-mode plugin routing is present, let it own ctx_* data-processing nudges.
     These tools return structured, summary-first results and keep output concise.
   </description>
@@ -55,7 +56,7 @@ export const WP_ROUTING_BLOCK = `<wp_routing>
     <tool name="wp_test">
       <category>dev-workflow</category>
       <trigger>running tests, verifying test suite, check if tests pass</trigger>
-      <forbidden>just test, pnpm test, vitest</forbidden>
+      <forbidden>just test, pnpm test, vitest, npx vitest, npm exec -- vitest, yarn vitest, bunx vitest, node ./node_modules/vitest/vitest.mjs</forbidden>
     </tool>
     <tool name="wp_e2e">
       <category>dev-workflow</category>
@@ -65,12 +66,12 @@ export const WP_ROUTING_BLOCK = `<wp_routing>
     <tool name="wp_lint">
       <category>dev-workflow</category>
       <trigger>linting, code style checks, lint errors</trigger>
-      <forbidden>just lint, oxlint</forbidden>
+      <forbidden>just lint, oxlint, node ./node_modules/oxlint/bin/oxlint</forbidden>
     </tool>
     <tool name="wp_typecheck">
       <category>dev-workflow</category>
       <trigger>type checking, TypeScript errors, type errors</trigger>
-      <forbidden>tsc</forbidden>
+      <forbidden>tsc, node ./node_modules/typescript/bin/tsc</forbidden>
     </tool>
     <tool name="wp_qa">
       <category>dev-workflow</category>
@@ -102,6 +103,11 @@ export const WP_ROUTING_BLOCK = `<wp_routing>
     <rule>Context-mode owns ctx_* routing when that plugin is installed.</rule>
   </ownership_boundary>
 
+  <hook_diagnostics>
+    <rule>Prefer wp hook &lt;name&gt; over direct wp-&lt;hook-bin&gt; calls when a wp hook command exists.</rule>
+    <rule>Direct wp-* hook bins remain generated-hook runtime internals, not recommended agent diagnostics.</rule>
+  </hook_diagnostics>
+
   <package_guidance>
     <rule>Consumers add @webpresso/agent-kit and import config helpers through @webpresso/agent-kit/* subpath exports such as @webpresso/agent-kit/oxlint, @webpresso/agent-kit/vitest/node, @webpresso/agent-kit/test-preset, @webpresso/agent-kit/e2e-preset, @webpresso/agent-kit/tsconfig/base.json, @webpresso/agent-kit/docs-lint, @webpresso/agent-kit/stryker, @webpresso/agent-kit/launch, and @webpresso/agent-kit/workers-test.</rule>
     <rule>Do not recommend adding retired split agent config packages for consumer projects; keep wp_* MCP tool names and wp-* hook bin names unchanged.</rule>
@@ -114,9 +120,16 @@ export const WP_ROUTING_BLOCK = `<wp_routing>
     <command>just qa</command>
     <command>just lint-md</command>
     <command>vitest</command>
+    <command>npx vitest</command>
+    <command>npm exec -- vitest</command>
+    <command>yarn vitest</command>
+    <command>bunx vitest</command>
+    <command>node ./node_modules/vitest/vitest.mjs</command>
     <command>oxlint</command>
+    <command>node ./node_modules/oxlint/bin/oxlint</command>
     <command>markdownlint-cli2</command>
     <command>tsc</command>
+    <command>node ./node_modules/typescript/bin/tsc</command>
     <command>act</command>
     <command>vp exec act</command>
     <command>pnpm exec act</command>
@@ -133,7 +146,8 @@ export const WP_ROUTING_BLOCK = `<wp_routing>
   </output_format>
 
   <fallback>
-    When MCP tools are unavailable, use just recipes directly and keep output brief.
+    When MCP tools are unavailable or stale, use the matching wp CLI command and keep output brief.
+    Do not fall through to raw tool bins under node_modules when a wp wrapper exists.
     .omx is runtime/state only; it is not a direct hook surface.
   </fallback>
 </wp_routing>`;

package/dist/esm/hooks/shared/validators/blueprint.js

@@ -26,6 +26,9 @@ export function shouldSkipFile(filePath) {
     if (!filePath)
         return false;
     const normalized = filePath.startsWith('/') ? filePath.slice(1) : filePath;
+    if (normalized.startsWith('blueprints/') || normalized.startsWith('webpresso/blueprints/')) {
+        return false;
+    }
     return SKIP_PATTERNS.some((pattern) => pattern.test(normalized));
 }
 export function getSkipReason(filePath) {

package/dist/esm/hooks/stop/qa-changed-files.d.ts

@@ -11,4 +11,5 @@ export type StopHookResult = {
     systemMessage: string;
 };
 export declare function formatStopHookOutput(result: StopHookResult): string;
+export declare function main(): Promise<void>;
 //# sourceMappingURL=qa-changed-files.d.ts.map

package/dist/esm/hooks/stop/qa-changed-files.js

@@ -85,12 +85,15 @@ export function runQaChecks(qaFiles, projectDir) {
 export function formatStopHookOutput(result) {
     return JSON.stringify(result);
 }
-if (process.argv[1] &&
-    realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1])) {
+export async function main() {
     runHook(
     // `Stop` is latency-sensitive and user-visible. Until webpresso grows a
     // deferred execution plane, broad typecheck/test sweeps stay off the hot
     // path instead of shelling synchronously at turn end.
     (_input) => null, formatStopHookOutput);
 }
+if (process.argv[1] &&
+    realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1])) {
+    void main();
+}
 //# sourceMappingURL=qa-changed-files.js.map

package/dist/esm/lint/index.js

@@ -93,7 +93,7 @@ export async function runLint(options = {}) {
     else {
         lintArgs.push('.');
     }
-    const resolution = getManagedRunner('vp', { filterOutput: false });
+    const resolution = getManagedRunner('vp', { outputPolicy: 'structured' });
     const vpOutcome = await runCommand(resolution.command, [...resolution.args, ...lintArgs], runOptions);
     if (isRunFailure(vpOutcome)) {
         return {

package/dist/esm/mcp/auto-discover.d.ts

@@ -61,5 +61,7 @@ export interface ToolDescriptor {
 export interface ToolRegistrar {
     registerTool(name: string, description: string, jsonSchema: Record<string, unknown>, outputSchema: Record<string, unknown> | undefined, handler: ToolHandler, annotations?: ToolAnnotations): void;
 }
+export declare function registerToolDescriptor(server: ToolRegistrar, descriptor: ToolDescriptor): ToolDescriptor;
+export declare function registerToolDescriptors(server: ToolRegistrar, descriptors: readonly ToolDescriptor[]): ToolDescriptor[];
 export declare function discoverTools(server: ToolRegistrar, toolsDir: string): Promise<ToolDescriptor[]>;
 //# sourceMappingURL=auto-discover.d.ts.map

package/dist/esm/mcp/auto-discover.js

@@ -15,9 +15,20 @@ import { extname, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { z } from 'zod';
 import { zodToJsonSchema } from 'zod-to-json-schema';
+export function registerToolDescriptor(server, descriptor) {
+    const jsonSchema = toJsonSchema(descriptor.inputSchema);
+    const outputSchema = descriptor.outputSchema ? toJsonSchema(descriptor.outputSchema) : undefined;
+    server.registerTool(descriptor.name, descriptor.description, jsonSchema, outputSchema, descriptor.handler, descriptor.annotations);
+    return descriptor;
+}
+export function registerToolDescriptors(server, descriptors) {
+    return descriptors.map((descriptor) => registerToolDescriptor(server, descriptor));
+}
 const SKIP_SUFFIXES = ['.test.ts', '.test.js', '.integration.test.ts', '.integration.test.js'];
 const SUPPORTED_EXTENSIONS = new Set(['.ts', '.js', '.mjs', '.cjs']);
 function shouldSkip(file) {
+    if (file.startsWith('_'))
+        return true;
     if (file.endsWith('.d.ts') || file.endsWith('.d.ts.map'))
         return true;
     if (file.endsWith('.js.map') || file.endsWith('.ts.map'))
@@ -82,7 +93,7 @@ function toJsonSchema(schema) {
 }
 export async function discoverTools(server, toolsDir) {
     const entries = await readdir(toolsDir, { withFileTypes: true });
-    const registered = [];
+    const loaded = [];
     for (const entry of entries) {
         if (!entry.isFile())
             continue;
@@ -98,11 +109,8 @@ export async function discoverTools(server, toolsDir) {
         if (typeof descriptor.name !== 'string' || typeof descriptor.handler !== 'function') {
             throw new Error(`Tool file ${fullPath} default export is malformed (missing name or handler)`);
         }
-        const jsonSchema = toJsonSchema(descriptor.inputSchema);
-        const outputSchema = descriptor.outputSchema ? toJsonSchema(descriptor.outputSchema) : undefined;
-        server.registerTool(descriptor.name, descriptor.description, jsonSchema, outputSchema, descriptor.handler, descriptor.annotations);
-        registered.push(descriptor);
+        loaded.push(descriptor);
     }
-    return registered;
+    return registerToolDescriptors(server, loaded);
 }
 //# sourceMappingURL=auto-discover.js.map

package/dist/esm/mcp/blueprint-server.js

@@ -23,6 +23,7 @@ import { openDb } from '#db/connection.js';
 import { resolveBlueprintProjectionDbPath } from '#db/paths.js';
 import { findTemplate } from '#db/templates.js';
 import { resolveBlueprintRoot } from '#utils/blueprint-root.js';
+import { getBlueprintDocumentPaths } from '#utils/document-paths.js';
 import { evidenceListSchema, canonicalizeEvidenceList } from '#evidence.js';
 import { checkFreshness, readCurrentHead, readProjectionMetadata } from '#freshness.js';
 import { applyVerification, assertAllTasksHaveCanonicalPassingEvidence, readTaskVerification, } from '#verification.js';
@@ -251,10 +252,10 @@ async function reIngest(cwd) {
     await reIngestProjection(cwd);
 }
 async function persistBlueprintMarkdown(input) {
-    const { projectCwd, slug, overviewPath, markdown } = input;
-    mkdirSync(path.dirname(overviewPath), { recursive: true });
+    const { projectCwd, slug, blueprintPath, markdown } = input;
+    mkdirSync(path.dirname(blueprintPath), { recursive: true });
     parseBlueprint(markdown, slug);
-    writeFileSync(overviewPath, markdown, 'utf8');
+    writeFileSync(blueprintPath, markdown, 'utf8');
     await reIngest(projectCwd);
     const refreshed = getCurrentProjectBlueprint(projectCwd, slug);
     if (!refreshed.blueprint) {
@@ -264,9 +265,11 @@ async function persistBlueprintMarkdown(input) {
 }
 function findBlueprintDir(blueprintRoot, slug, states) {
     for (const state of states) {
-        const d = path.join(blueprintRoot, state, slug);
-        if (existsSync(d))
-            return { dir: d, state };
+        const paths = getBlueprintDocumentPaths(blueprintRoot, state, slug);
+        if (existsSync(paths.flat))
+            return { dir: path.dirname(paths.flat), path: paths.flat, shape: 'flat', state };
+        if (existsSync(paths.directory))
+            return { dir: paths.directory, path: paths.folder, shape: 'folder', state };
     }
     return null;
 }
@@ -557,7 +560,7 @@ async function handleNew(cwd, raw) {
     }
     const b = bytes(template);
     const slug = titleToSlug(title);
-    const targetPath = path.join(resolveBlueprintRoot(cwd), 'draft', slug, '_overview.md');
+    const targetPath = getBlueprintDocumentPaths(resolveBlueprintRoot(cwd), 'draft', slug).flat;
     // Platform-first path: push event to register the blueprint before returning the scaffold.
     // Iron rule: resolveSyncAdapter() returns null when WP_BLUEPRINT_PLATFORM_DISABLED=1.
     const adapter = await resolveSyncAdapter(cwd);
@@ -886,7 +889,7 @@ async function handleTaskVerify(projectResolver, cwd, raw) {
     if (!found) {
         return err('wp_blueprint_task_verify failed', `Blueprint "${slug}" not found in any state directory`);
     }
-    const filePath = path.join(found.dir, '_overview.md');
+    const filePath = found.path;
     if (!existsSync(filePath)) {
         return err('wp_blueprint_task_verify failed', `Blueprint overview not found at ${filePath}`);
     }
@@ -981,8 +984,8 @@ async function handlePromote(projectResolver, cwd, raw) {
     const found = findBlueprintDir(root, slug, ALL_STATES);
     if (!found)
         return err('wp_blueprint_promote failed', `Blueprint "${slug}" not found in any state directory`);
-    const { dir: currentDir, state: currentState } = found;
-    const overviewPath = path.join(currentDir, '_overview.md');
+    const { state: currentState } = found;
+    const overviewPath = found.path;
     if (to_state === 'completed') {
         try {
             assertBlueprintCanComplete(overviewPath, slug);
@@ -1085,7 +1088,7 @@ async function handleFinalize(projectResolver, cwd, raw) {
         return err('wp_blueprint_finalize failed', `Blueprint "${slug}" not found`);
     }
     try {
-        assertBlueprintCanComplete(path.join(found.dir, '_overview.md'), slug);
+        assertBlueprintCanComplete(found.path, slug);
     }
     catch (error) {
         return err('wp_blueprint_finalize refused', toStr(error));
@@ -1807,14 +1810,14 @@ async function handleBlueprintPut(projectResolver, cwd, raw) {
         return err('wp_blueprint_put refused', `New blueprint "${slug}" must start in "draft"; use wp_blueprint_transition for later lifecycle moves.`);
     }
     const overviewPath = found
-        ? path.join(found.dir, '_overview.md')
-        : path.join(root, document.status, slug, '_overview.md');
+        ? found.path
+        : getBlueprintDocumentPaths(root, document.status, slug).flat;
     try {
         const markdown = renderBlueprintMarkdownFromDocument(slug, document);
         const blueprint = await persistBlueprintMarkdown({
             projectCwd,
             slug,
-            overviewPath,
+            blueprintPath: overviewPath,
             markdown,
         });
         const payload = {
@@ -1904,7 +1907,7 @@ async function handleBlueprintTransition(projectResolver, cwd, raw) {
 async function applyLocalBlueprintTransition(input) {
     const { projectCwd, slug, to_state, found } = input;
     const root = resolveBlueprintRoot(projectCwd);
-    const overviewPath = path.join(found.dir, '_overview.md');
+    const overviewPath = found.path;
     const parsed = runValidate(overviewPath);
     if (!parsed.valid) {
         throw new Error(parsed.gaps.join('; '));
@@ -1918,13 +1921,15 @@ async function applyLocalBlueprintTransition(input) {
         progress: formatBlueprintProgress(currentBlueprint.tasks.length, currentBlueprint.tasks.filter((task) => task.status === 'done').length, currentBlueprint.tasks.filter((task) => task.status === 'blocked').length),
     });
     parseBlueprint(updated, slug);
-    const destDir = path.join(root, to_state, slug);
-    mkdirSync(path.dirname(destDir), { recursive: true });
+    const destination = getBlueprintDocumentPaths(root, to_state, slug);
+    mkdirSync(path.dirname(found.shape === 'flat' ? destination.flat : destination.directory), {
+        recursive: true,
+    });
     let finalOverviewPath = overviewPath;
     if (found.state !== to_state) {
         const { renameSync } = await import('node:fs');
-        renameSync(found.dir, destDir);
-        finalOverviewPath = path.join(destDir, '_overview.md');
+        renameSync(found.shape === 'flat' ? overviewPath : found.dir, found.shape === 'flat' ? destination.flat : destination.directory);
+        finalOverviewPath = found.shape === 'flat' ? destination.flat : destination.folder;
     }
     writeFileSync(finalOverviewPath, updated, 'utf8');
     await reIngest(projectCwd);
@@ -1960,10 +1965,9 @@ async function handleBlueprintCreate(projectResolver, cwd, raw) {
     const today = new Date().toISOString().split('T')[0] ?? '';
     const slug = titleToSlug(title);
     const root = resolveBlueprintRoot(projectCwd);
-    const targetDir = path.join(root, 'draft', slug);
-    const overviewPath = path.join(targetDir, '_overview.md');
+    const overviewPath = getBlueprintDocumentPaths(root, 'draft', slug).flat;
     try {
-        mkdirSync(targetDir, { recursive: true });
+        mkdirSync(path.dirname(overviewPath), { recursive: true });
         const content = BLUEPRINT_TEMPLATE.replace(/{TITLE}/g, title)
             .replace(/{COMPLEXITY}/g, complexity)
             .replace(/{DATE}/g, today)
@@ -1971,7 +1975,7 @@ async function handleBlueprintCreate(projectResolver, cwd, raw) {
         await persistBlueprintMarkdown({
             projectCwd,
             slug,
-            overviewPath,
+            blueprintPath: overviewPath,
             markdown: content,
         });
         const b = bytes(content);
@@ -2083,12 +2087,12 @@ export async function registerBlueprintTools(registrar, cwd, projectResolver = c
             next_action: nextActionOutputSchema,
         },
     }, (r) => handleBlueprintTransition(projectResolver, cwd, r), { title: 'Blueprint Transition', destructiveHint: false, openWorldHint: false });
-    registrar.registerTool('wp_blueprint_validate', 'Validate _overview.md structure. Returns { valid, gaps }. Must pass before wp_blueprint_promote.', { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] }, undefined, (r) => handleValidate(cwd, r), { title: 'Blueprint Validate', readOnlyHint: false, openWorldHint: false });
+    registrar.registerTool('wp_blueprint_validate', 'Validate canonical blueprint markdown structure (`<slug>.md` or `<slug>/_overview.md`). Returns { valid, gaps }. Must pass before wp_blueprint_promote.', { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] }, undefined, (r) => handleValidate(cwd, r), { title: 'Blueprint Validate', readOnlyHint: false, openWorldHint: false });
     registrar.registerTool('wp_blueprint_task_next', 'Return the next ready task (all deps done). Accepts optional project_id for nested-workspace disambiguation. Returns { summary, task }.', {
         type: 'object',
         properties: { blueprint: { type: 'string' }, project_id: { type: 'string' } },
     }, undefined, (r) => handleTaskNext(projectResolver, cwd, r), { title: 'Blueprint Task Next', readOnlyHint: true, openWorldHint: false });
-    registrar.registerTool('wp_blueprint_task_advance', 'Advance task status. Edits _overview.md and re-syncs DB. Accepts optional request_id for idempotent retries and optional head_at_ingest from wp_blueprint_get/wp_blueprint_list to reject stale writes. Returns { summary, old_status, new_status, idempotent }.', {
+    registrar.registerTool('wp_blueprint_task_advance', 'Advance task status. Edits the canonical blueprint markdown and re-syncs DB. Accepts optional request_id for idempotent retries and optional head_at_ingest from wp_blueprint_get/wp_blueprint_list to reject stale writes. Returns { summary, old_status, new_status, idempotent }.', {
         type: 'object',
         properties: {
             project_id: { type: 'string' },
@@ -2206,7 +2210,7 @@ export async function registerBlueprintTools(registrar, cwd, projectResolver = c
         },
         required: [...summaryEnvelopeOutputSchema.required, 'chunks', 'total_bytes', 'project_id'],
     }, (r) => handleBlueprintContext(projectResolver, cwd, r), { title: 'Blueprint Context', readOnlyHint: true, openWorldHint: false });
-    registrar.registerTool('wp_blueprint_create', 'Create a new blueprint markdown under blueprints/draft/<slug>/_overview.md and re-ingest. Accepts optional request_id for idempotent retries and optional head_at_ingest from wp_blueprint_projects/wp_blueprint_list to reject stale writes. Returns { slug, path, next_action, idempotent }.', {
+    registrar.registerTool('wp_blueprint_create', 'Create a new blueprint markdown under blueprints/draft/<slug>.md by default (folder-shaped `<slug>/_overview.md` remains supported elsewhere) and re-ingest. Accepts optional request_id for idempotent retries and optional head_at_ingest from wp_blueprint_projects/wp_blueprint_list to reject stale writes. Returns { slug, path, next_action, idempotent }.', {
         type: 'object',
         properties: {
             project_id: { type: 'string' },

package/dist/esm/mcp/cli.js

@@ -12,18 +12,26 @@ import { createServer } from './server.js';
 export async function runStdioServer() {
     const server = await createServer();
     const transport = new StdioServerTransport();
+    const settle = Promise.withResolvers();
     let shuttingDown = false;
     const shutdown = async () => {
         if (shuttingDown)
             return;
         shuttingDown = true;
         deleteSentinel();
+        try {
+            await transport.close();
+        }
+        catch {
+            /* ignore transport close errors during shutdown */
+        }
         try {
             await server.close();
         }
         catch {
             /* ignore close errors during shutdown */
         }
+        settle.resolve();
     };
     process.on('SIGINT', () => {
         void shutdown().then(() => process.exit(0));
@@ -31,8 +39,21 @@ export async function runStdioServer() {
     process.on('SIGTERM', () => {
         void shutdown().then(() => process.exit(0));
     });
+    process.stdin.on('end', () => {
+        void shutdown();
+    });
+    process.stdin.on('close', () => {
+        void shutdown();
+    });
+    transport.onclose = () => {
+        void shutdown();
+    };
+    transport.onerror = () => {
+        void shutdown();
+    };
     await server.connect(transport);
     writeSentinel();
+    await settle.promise;
 }
 import { realpathSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';

package/dist/esm/mcp/runners/test.js

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { globSync } from 'glob';
+import { getPackageScript, isRecursiveWpScript, packageUsesVitest } from '#cli/package-scripts.js';
 import { isRunFailure, runCommand as runSharedCommand } from '#mcp/tools/_shared/run-command';
 // Keep the runner's own deadline comfortably below common MCP client call
 // ceilings so slow suites fail fast with a structured `timedOut` payload
@@ -55,6 +56,14 @@ export async function runTests(input) {
     if (workspaceShardRuns && workspaceShardRuns.length > 0) {
         return runScopedSequence(cwd, workspaceShardRuns, input, workspaceSharding);
     }
+    if (shouldBypassWorkspaceTestScript(cwd)) {
+        const result = await runCommand('vp', ['exec', '--', 'vitest', 'run', '--reporter=json', '--no-color'], {
+            ...input,
+            cwd,
+            timeoutMs: commandTimeoutMs,
+        });
+        return withFailureScope(result, 'workspace vitest command');
+    }
     const result = await runCommand('vp', ['run', 'test'], {
         ...input,
         cwd,
@@ -222,6 +231,12 @@ function hasRootVitestTestScript(cwd) {
     const testScript = scripts.test;
     return typeof testScript === 'string' && /\bvitest\b/.test(testScript);
 }
+function shouldBypassWorkspaceTestScript(cwd) {
+    const testScript = getPackageScript(cwd, 'test');
+    if (!testScript || !isRecursiveWpScript(testScript, 'test'))
+        return false;
+    return packageUsesVitest(cwd);
+}
 function discoverVitestFiles(cwd) {
     return globSync(VITEST_DEFAULT_INCLUDE, {
         cwd,

package/dist/esm/mcp/server.d.ts

@@ -7,6 +7,7 @@
  * — no edits required here.
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export type ToolLoadMode = 'filesystem' | 'registry';
 export interface CreateServerOptions {
     /**
      * Directory to scan for tool descriptors. Defaults to `./tools` relative to
@@ -14,6 +15,12 @@ export interface CreateServerOptions {
      * `vp run build`.
      */
     toolsDir?: string;
+    /**
+     * Tool loading strategy. Use `registry` for compiled runtime execution where
+     * runtime directory scans are unsafe, and `filesystem` for dev/test disk
+     * discovery.
+     */
+    toolLoadMode?: ToolLoadMode;
     /**
      * Repo working directory passed through to the blueprint structured-store
      * registrar (Task 2.1). Defaults to `process.cwd()`. Tests inject a tmpdir.

package/dist/esm/mcp/server.js

@@ -8,42 +8,25 @@
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { CallToolRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, RootsListChangedNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { discoverTools, } from './auto-discover.js';
+import { discoverTools, registerToolDescriptors, } from './auto-discover.js';
 import { registerBlueprintServer } from './blueprint-server.js';
+import { COMPILED_TOOL_REGISTRY } from './tools/_registry.js';
+import { readOwnedPackageVersion } from '#runtime/package-version.js';
 const SERVER_NAME = 'webpresso';
-// Walk upward from this module's location until we find package.json. Works
-// for both src/mcp/server.ts (dev) and dist/esm/mcp/server.js (built) without
-// hardcoding asymmetric `../../..` counts.
-const MAX_UPWARD_LEVELS = 8;
-function readPackageVersion() {
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < MAX_UPWARD_LEVELS; i++) {
-        const candidate = join(dir, 'package.json');
-        if (existsSync(candidate)) {
-            const pkg = JSON.parse(readFileSync(candidate, 'utf-8'));
-            // Some build outputs emit a marker `package.json` (e.g. `{ "type": "module" }`)
-            // without a version. Skip those and keep walking so we land on the real
-            // package root, instead of throwing the moment we see any package.json.
-            if (typeof pkg.version === 'string' && pkg.version.length > 0)
-                return pkg.version;
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    throw new Error('Cannot locate a versioned package.json relative to webpresso MCP server module');
-}
-const SERVER_VERSION = readPackageVersion();
+const SERVER_VERSION = readOwnedPackageVersion(import.meta.url);
 function defaultToolsDir() {
     // import.meta.url resolves to either src/mcp/server.ts (dev/test via vitest)
     // or dist/esm/mcp/server.js (built). The tools directory is colocated.
     const here = dirname(fileURLToPath(import.meta.url));
     return join(here, 'tools');
 }
+function resolveDefaultToolLoadMode() {
+    return process.env.WP_MCP_TOOL_MODE === 'registry' || process.env.WP_COMPILED_RUNTIME === '1'
+        ? 'registry'
+        : 'filesystem';
+}
 export async function createServer(options = {}) {
     const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, {
         capabilities: {
@@ -60,7 +43,13 @@ export async function createServer(options = {}) {
             tools.set(name, { name, description, inputSchema, outputSchema, handler, annotations });
         },
     };
-    await discoverTools(registrar, options.toolsDir ?? defaultToolsDir());
+    const toolLoadMode = options.toolLoadMode ?? resolveDefaultToolLoadMode();
+    if (toolLoadMode === 'registry') {
+        registerToolDescriptors(registrar, COMPILED_TOOL_REGISTRY);
+    }
+    else {
+        await discoverTools(registrar, options.toolsDir ?? defaultToolsDir());
+    }
     // Task 2.1: register the blueprint structured-store tools AFTER auto-discover
     // so any tool-name collision surfaces here as a thrown error rather than
     // silent shadowing. Roots are looked up lazily via `server.listRoots()`; the

package/dist/esm/mcp/tools/_registry.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDescriptor } from '#mcp/auto-discover';
+export declare const COMPILED_TOOL_REGISTRY: readonly ToolDescriptor[];
+//# sourceMappingURL=_registry.d.ts.map

package/dist/esm/mcp/tools/_registry.js

@@ -0,0 +1,21 @@
+import audit from './audit.js';
+import ciAct from './ci-act.js';
+import e2e from './e2e.js';
+import format from './format.js';
+import lint from './lint.js';
+import qa from './qa.js';
+import test from './test.js';
+import typecheck from './typecheck.js';
+import workerTail from './worker-tail.js';
+export const COMPILED_TOOL_REGISTRY = [
+    audit,
+    ciAct,
+    e2e,
+    format,
+    lint,
+    qa,
+    test,
+    typecheck,
+    workerTail,
+];
+//# sourceMappingURL=_registry.js.map

package/dist/esm/mcp/tools/audit.d.ts

@@ -32,6 +32,7 @@ declare const inputSchema: z.ZodObject<{
         "catalog-drift": "catalog-drift";
         "package-surface": "package-surface";
         "architecture-drift": "architecture-drift";
+        "cloudflare-deploy-contract": "cloudflare-deploy-contract";
         "absolute-path-policy": "absolute-path-policy";
         "ai-contracts": "ai-contracts";
     }>;

package/dist/esm/mcp/tools/audit.js

@@ -28,6 +28,7 @@ const KINDS = [
     'docs-frontmatter',
     'blueprint-lifecycle',
     'architecture-drift',
+    'cloudflare-deploy-contract',
     'absolute-path-policy',
     'roadmap-links',
     'bundle-budget',
@@ -155,6 +156,16 @@ async function dispatch(input) {
                 details: auditResult,
             };
         }
+        case 'cloudflare-deploy-contract': {
+            const { auditCloudflareDeployContract } = await import('#audit/cloudflare-deploy-contract');
+            const auditResult = await auditCloudflareDeployContract(input.cwd ?? input.directory ?? process.cwd());
+            return {
+                passed: auditResult.ok,
+                summary: summarizeRepoAudit(kind, auditResult),
+                kind,
+                details: auditResult,
+            };
+        }
         case 'absolute-path-policy': {
             const { auditAbsolutePathPolicy } = await import('#audit/absolute-path-policy');
             const auditResult = auditAbsolutePathPolicy(input.cwd ?? input.directory ?? process.cwd());

package/dist/esm/mcp/tools/e2e.d.ts

@@ -12,8 +12,8 @@ declare const inputSchema: z.ZodObject<{
     suite: z.ZodOptional<z.ZodString>;
     runner: z.ZodOptional<z.ZodEnum<{
         command: "command";
-        vitest: "vitest";
         playwright: "playwright";
+        vitest: "vitest";
     }>>;
     config: z.ZodOptional<z.ZodString>;
     files: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;

package/dist/esm/mcp/tools/typecheck.js

@@ -14,6 +14,7 @@ import { join } from 'node:path';
 import { globSync } from 'glob';
 import { z } from 'zod';
 import { applyOutputTransform } from '#output-transforms/index';
+import { getManagedRunner } from '#tool-runtime';
 import { resolveProjectRoot } from './_shared/project-root.js';
 import { createSummaryOutputSchema, createSummaryResult } from './_shared/result.js';
 import { isRunFailure, runCommand } from './_shared/run-command.js';
@@ -143,11 +144,12 @@ const tool = {
         // current resolution treats each entry as a relative path either way.
         const workspaceGlobs = targets ? readWorkspaceGlobs(cwd) : null;
         const runs = [];
+        const resolution = getManagedRunner('tsc', { outputPolicy: 'structured' });
         if (targets) {
             for (const pkg of targets) {
                 const resolvedTarget = resolveTypecheckTarget(cwd, pkg, workspaceGlobs);
                 const tsconfig = join(resolvedTarget, 'tsconfig.json');
-                const outcome = await runCommand('tsc', ['--noEmit', '-p', tsconfig], runOptions);
+                const outcome = await runCommand(resolution.command, [...resolution.args, '--noEmit', '-p', tsconfig], runOptions);
                 if (isRunFailure(outcome)) {
                     throw outcome.error;
                 }
@@ -155,7 +157,7 @@ const tool = {
             }
         }
         else {
-            const outcome = await runCommand('tsc', ['--noEmit'], runOptions);
+            const outcome = await runCommand(resolution.command, [...resolution.args, '--noEmit'], runOptions);
             if (isRunFailure(outcome)) {
                 throw outcome.error;
             }

package/dist/esm/mutation/affected.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Run Stryker only on packages changed vs. the base branch.
+ * Returns 0 on success, 1 if any package fails its break threshold.
+ *
+ * Reads GITHUB_BASE_REF (set by GitHub Actions on pull_request events) to
+ * determine the base branch; falls back to "main".
+ */
+export declare function runAffectedMutation(): 0 | 1;
+//# sourceMappingURL=affected.d.ts.map