@webpresso/agent-kit 0.21.5 → 0.23.0

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

package/dist/esm/mutation/affected.js

@@ -0,0 +1,36 @@
+import { execSync } from 'node:child_process';
+/**
+ * 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 function runAffectedMutation() {
+    const base = process.env.GITHUB_BASE_REF ?? 'main';
+    const changed = execSync(`git diff --name-only origin/${base}...HEAD`)
+        .toString()
+        .trim()
+        .split('\n')
+        .filter(Boolean);
+    const affectedPkgs = new Set();
+    for (const file of changed) {
+        const match = file.match(/^(apps\/[^/]+|packages\/[^/]+)\//);
+        if (match)
+            affectedPkgs.add(match[1]);
+    }
+    if (affectedPkgs.size === 0) {
+        console.log('No affected packages — skipping mutation.');
+        return 0;
+    }
+    for (const pkg of affectedPkgs) {
+        try {
+            execSync(`pnpm --filter ./${pkg} mutation --if-present`, { stdio: 'inherit' });
+        }
+        catch {
+            return 1;
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=affected.js.map

package/dist/esm/package.json

@@ -51,6 +51,11 @@
     "#tool-runtime": "./tool-runtime/index.js",
     "#tool-runtime/*.js": "./tool-runtime/*.js",
     "#tool-runtime/*": "./tool-runtime/*.js",
+    "#wp-extension": "./wp-extension/index.js",
+    "#wp-extension/*.js": "./wp-extension/*.js",
+    "#wp-extension/*": "./wp-extension/*.js",
+    "#runtime/*.js": "./runtime/*.js",
+    "#runtime/*": "./runtime/*.js",
     "#output-transforms/*.js": "./output-transforms/*.js",
     "#output-transforms/*": "./output-transforms/*.js",
     "#lint/*.js": "./lint/*.js",

package/dist/esm/runtime/package-version.d.ts

@@ -0,0 +1,2 @@
+export declare function readOwnedPackageVersion(moduleUrl: string): string;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/esm/runtime/package-version.js

@@ -0,0 +1,43 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const ACCEPTED_PACKAGE_PREFIXES = ['@webpresso/agent-kit', 'webpresso'];
+const MAX_UPWARD_LEVELS = 8;
+function matchesOwnedPackageName(name) {
+    return (typeof name === 'string' &&
+        ACCEPTED_PACKAGE_PREFIXES.some((prefix) => name === prefix || name.startsWith(`${prefix}-`)));
+}
+function readVersionFromDir(startDir) {
+    let dir = path.resolve(startDir);
+    for (let i = 0; i < MAX_UPWARD_LEVELS; i++) {
+        const candidate = path.join(dir, 'package.json');
+        if (existsSync(candidate)) {
+            try {
+                const parsed = JSON.parse(readFileSync(candidate, 'utf8'));
+                if (matchesOwnedPackageName(parsed.name) && typeof parsed.version === 'string') {
+                    return parsed.version;
+                }
+            }
+            catch {
+                // keep walking
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+export function readOwnedPackageVersion(moduleUrl) {
+    const fromModule = readVersionFromDir(path.dirname(fileURLToPath(moduleUrl)));
+    if (fromModule)
+        return fromModule;
+    if (process.execPath) {
+        const fromExec = readVersionFromDir(path.dirname(process.execPath));
+        if (fromExec)
+            return fromExec;
+    }
+    return '0.0.0';
+}
+//# sourceMappingURL=package-version.js.map

package/dist/esm/test/command-builder.d.ts

@@ -1,4 +1,5 @@
 import type { ResolvedTestTarget } from './target-resolver.js';
+import { type ManagedRunnerOutputPolicy } from '#tool-runtime';
 export interface CommandConfig {
     command: string;
     args: string[];
@@ -6,6 +7,7 @@ export interface CommandConfig {
 }
 export type VpRunLogMode = 'interleaved' | 'labeled' | 'grouped';
 export interface TestCommandOptions {
+    cwd?: string;
     watch?: boolean;
     coverage?: boolean;
     testNamePattern?: string;
@@ -18,6 +20,7 @@ export interface TestCommandOptions {
     log?: VpRunLogMode;
     passthrough?: readonly string[];
     filterOutput?: boolean;
+    outputPolicy?: ManagedRunnerOutputPolicy;
 }
 export declare function buildTestCommand(target: ResolvedTestTarget, options?: TestCommandOptions): CommandConfig;
 export declare function buildVpTestCommand(filters: readonly string[], options?: TestCommandOptions): CommandConfig;

package/dist/esm/test/command-builder.js

@@ -1,5 +1,9 @@
 import { getManagedRunner } from '#tool-runtime';
+import { getPackageScript, isRecursiveWpScript, packageUsesVitest } from '#cli/package-scripts.js';
 export function buildTestCommand(target, options = {}) {
+    if (target.type === 'all' && shouldBypassRecursiveWpTest(options.cwd ?? process.cwd())) {
+        return buildVitestCommand([], options);
+    }
     if (target.type === 'file') {
         return buildVitestCommand(target.values, options);
     }
@@ -8,7 +12,7 @@ export function buildTestCommand(target, options = {}) {
 export function buildVpTestCommand(filters, options = {}) {
     const task = getVpTestTask(options);
     const resolvedFilters = filters.map((filter) => formatVpRunFilter(filter, task));
-    const explicitTargets = resolvedFilters.every(isExplicitVpTaskTarget);
+    const explicitTargets = resolvedFilters.length > 0 && resolvedFilters.every(isExplicitVpTaskTarget);
     const args = ['run', ...resolvedFilters];
     appendVpRunOptions(args, options);
     if (!explicitTargets) {
@@ -18,7 +22,9 @@ export function buildVpTestCommand(filters, options = {}) {
     if (passthrough.length > 0) {
         args.push('--', ...passthrough);
     }
-    const resolution = getManagedRunner('vp', { filterOutput: options.filterOutput });
+    const resolution = getManagedRunner('vp', {
+        outputPolicy: resolveOutputPolicy(options.outputPolicy, options.filterOutput),
+    });
     const env = buildVpRunEnv(options);
     const mergedArgs = [...resolution.args, ...args];
     return env
@@ -45,7 +51,9 @@ export function buildVitestCommand(files, options = {}) {
         args.push('--config', configFile);
     }
     args.push(...buildVitestPassthrough(options), ...testFiles);
-    const resolution = getManagedRunner('vitest', { filterOutput: options.filterOutput });
+    const resolution = getManagedRunner('vitest', {
+        outputPolicy: resolveOutputPolicy(options.outputPolicy, options.filterOutput),
+    });
     return { command: resolution.command, args: [...resolution.args, ...args] };
 }
 export function getVpTestTask(options) {
@@ -101,4 +109,15 @@ function buildVitestPassthrough(options) {
 function isVitestConfigFile(file) {
     return /^vitest(?:\.[\w-]+)?\.config\.(?:ts|mts|cts|js|mjs|cjs)$/u.test(file);
 }
+function resolveOutputPolicy(outputPolicy, filterOutput) {
+    if (outputPolicy)
+        return outputPolicy;
+    return filterOutput === false ? 'structured' : 'rtk-filtered';
+}
+function shouldBypassRecursiveWpTest(cwd) {
+    const testScript = getPackageScript(cwd, 'test');
+    if (!testScript || !isRecursiveWpScript(testScript, 'test'))
+        return false;
+    return packageUsesVitest(cwd);
+}
 //# sourceMappingURL=command-builder.js.map

package/dist/esm/tool-runtime/index.d.ts

@@ -1,5 +1,5 @@
-import { type ManagedRunnerResolution, type ResolveRunnerOptions } from './resolve-runner.js';
+import { type ManagedRunnerResolution, type ResolveRunnerOptions, type ManagedRunnerOutputPolicy } from './resolve-runner.js';
 export declare function getManagedRunner(tool: string, options?: ResolveRunnerOptions): ManagedRunnerResolution;
 export declare function clearManagedRunnerCache(): void;
-export type { ManagedRunnerResolution, ResolveRunnerOptions };
+export type { ManagedRunnerOutputPolicy, ManagedRunnerResolution, ResolveRunnerOptions };
 //# sourceMappingURL=index.d.ts.map