@webpresso/agent-kit 0.28.0 → 0.29.1

package/dist/esm/mcp/server.js

@@ -16,14 +16,29 @@ import { COMPILED_TOOL_REGISTRY } from './tools/_registry.js';
 import { readOwnedPackageVersion } from '#runtime/package-version.js';
 const SERVER_NAME = 'webpresso';
 const SERVER_VERSION = readOwnedPackageVersion(import.meta.url);
+function modulePathFromUrl(moduleUrl) {
+    try {
+        return fileURLToPath(moduleUrl);
+    }
+    catch {
+        return null;
+    }
+}
+export function isBunSingleFileModuleUrl(moduleUrl) {
+    const modulePath = modulePathFromUrl(moduleUrl);
+    return modulePath === '/$bunfs/root' || modulePath?.startsWith('/$bunfs/root/') === true;
+}
 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));
+    const modulePath = modulePathFromUrl(import.meta.url);
+    const here = dirname(modulePath ?? fileURLToPath(import.meta.url));
     return join(here, 'tools');
 }
-function resolveDefaultToolLoadMode() {
-    return process.env.WP_MCP_TOOL_MODE === 'registry' || process.env.WP_COMPILED_RUNTIME === '1'
+export function resolveDefaultToolLoadMode(moduleUrl = import.meta.url) {
+    return process.env.WP_MCP_TOOL_MODE === 'registry' ||
+        process.env.WP_COMPILED_RUNTIME === '1' ||
+        isBunSingleFileModuleUrl(moduleUrl)
         ? 'registry'
         : 'filesystem';
 }

package/dist/esm/mcp/tools/_shared/audit-kinds.d.ts

@@ -7,7 +7,7 @@
  * dependency-free module so the hook runtime, which runs on every tool call,
  * doesn't pull in the whole audit tool graph.
  */
-export declare const AUDIT_KINDS: readonly ["tph", "tph-e2e", "agents", "catalog-drift", "package-surface", "docs-frontmatter", "blueprint-lifecycle", "architecture-drift", "cloudflare-deploy-contract", "absolute-path-policy", "no-first-party-mjs", "roadmap-links", "bundle-budget", "commit-message", "tech-debt", "hook-surface", "ai-contracts", "no-relative-package-scripts", "toolchain-isolation"];
+export declare const AUDIT_KINDS: readonly ["tph", "tph-e2e", "agents", "catalog-drift", "package-surface", "docs-frontmatter", "blueprint-readme-drift", "blueprint-lifecycle", "architecture-drift", "cloudflare-deploy-contract", "absolute-path-policy", "no-first-party-mjs", "roadmap-links", "bundle-budget", "commit-message", "tech-debt", "hook-surface", "ai-contracts", "no-relative-package-scripts", "toolchain-isolation"];
 export type AuditKind = (typeof AUDIT_KINDS)[number];
 export declare function isAuditKind(value: string): value is AuditKind;
 //# sourceMappingURL=audit-kinds.d.ts.map

package/dist/esm/mcp/tools/_shared/audit-kinds.js

@@ -14,6 +14,7 @@ export const AUDIT_KINDS = [
     'catalog-drift',
     'package-surface',
     'docs-frontmatter',
+    'blueprint-readme-drift',
     'blueprint-lifecycle',
     'architecture-drift',
     'cloudflare-deploy-contract',

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

@@ -20,13 +20,14 @@ declare const inputSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         "no-relative-package-scripts": "no-relative-package-scripts";
         agents: "agents";
-        "hook-surface": "hook-surface";
         "tech-debt": "tech-debt";
+        "hook-surface": "hook-surface";
         tph: "tph";
         "tph-e2e": "tph-e2e";
         "catalog-drift": "catalog-drift";
         "package-surface": "package-surface";
         "docs-frontmatter": "docs-frontmatter";
+        "blueprint-readme-drift": "blueprint-readme-drift";
         "blueprint-lifecycle": "blueprint-lifecycle";
         "architecture-drift": "architecture-drift";
         "cloudflare-deploy-contract": "cloudflare-deploy-contract";

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

@@ -119,9 +119,19 @@ async function dispatch(input) {
                 details: auditResult,
             };
         }
+        case 'blueprint-readme-drift': {
+            const { auditBlueprintReadmeDrift } = await import('#audit/blueprint-readme-drift');
+            const auditResult = auditBlueprintReadmeDrift(input.cwd ?? input.directory ?? process.cwd());
+            return {
+                passed: auditResult.ok,
+                summary: summarizeRepoAudit(kind, auditResult),
+                kind,
+                details: auditResult,
+            };
+        }
         case 'blueprint-lifecycle': {
-            const { auditBlueprintLifecycle } = await import('#audit/repo-guardrails');
-            const auditResult = auditBlueprintLifecycle(input.cwd ?? input.directory ?? process.cwd());
+            const { auditBlueprintLifecycleSql } = await import('#audit/blueprint-lifecycle-sql');
+            const auditResult = await auditBlueprintLifecycleSql(input.cwd ?? input.directory ?? process.cwd());
             return {
                 passed: auditResult.ok,
                 summary: summarizeRepoAudit(kind, auditResult),
@@ -307,7 +317,7 @@ async function dispatch(input) {
 }
 const tool = {
     name: 'wp_audit',
-    description: 'Run a packaged repo audit. `kind` selects the audit (tph, tph-e2e, catalog-drift, docs-frontmatter, blueprint-lifecycle, architecture-drift, absolute-path-policy, no-first-party-mjs, roadmap-links, bundle-budget, commit-message, tech-debt, hook-surface, package-surface, no-relative-package-scripts). Returns {passed, kind, details}.',
+    description: 'Run a packaged repo audit. `kind` selects the audit (tph, tph-e2e, catalog-drift, docs-frontmatter, blueprint-readme-drift, blueprint-lifecycle, architecture-drift, absolute-path-policy, no-first-party-mjs, roadmap-links, bundle-budget, commit-message, tech-debt, hook-surface, package-surface, no-relative-package-scripts). Returns {passed, kind, details}.',
     inputSchema,
     outputSchema,
     annotations: {

package/dist/esm/package.json

@@ -18,6 +18,8 @@
     "#dev/*": "./dev/*.js",
     "#audit/*.js": "./audit/*.js",
     "#audit/*": "./audit/*.js",
+    "#build/*.js": "./build/*.js",
+    "#build/*": "./build/*.js",
     "#docs-linter/*.js": "./docs-linter/*.js",
     "#docs-linter/*": "./docs-linter/*.js",
     "#config/tsconfig/*.js": "./config/tsconfig/*",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpresso/agent-kit",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "private": false,
   "repository": {
     "type": "git",
@@ -30,7 +30,7 @@
   "license": "MIT",
   "preferGlobal": true,
   "bin": {
-    "wp": "bin/wp.js",
+    "wp": "bin/wp",
     "wp-pretool-guard": "bin/wp-pretool-guard.js",
     "wp-post-tool": "bin/wp-post-tool.js",
     "wp-stop-qa": "bin/wp-stop-qa.js",
@@ -46,8 +46,10 @@
     "docs-migrate": "bin/docs-migrate.js"
   },
   "files": [
-    "bin",
-    "dist",
+    "bin/wp",
+    "bin/runtime-manifest.json",
+    "bin/*.js",
+    "dist/esm",
     "!dist/**/*.map",
     "!dist/**/__integration__/**",
     "!dist/**/__mocks__/**",
@@ -83,6 +85,8 @@
     "#dev/*": "./src/dev/*.ts",
     "#audit/*.js": "./src/audit/*.ts",
     "#audit/*": "./src/audit/*.ts",
+    "#build/*.js": "./src/build/*.ts",
+    "#build/*": "./src/build/*.ts",
     "#docs-linter/*.js": "./src/docs-linter/*.ts",
     "#docs-linter/*": "./src/docs-linter/*.ts",
     "#config/tsconfig/*.js": "./src/config/tsconfig/*",
@@ -242,31 +246,36 @@
       "import": {
         "types": "./dist/esm/config/tsconfig/base.json",
         "default": "./dist/esm/config/tsconfig/base.json"
-      }
+      },
+      "default": "./dist/esm/config/tsconfig/base.json"
     },
     "./tsconfig/cloudflare.json": {
       "import": {
         "types": "./dist/esm/config/tsconfig/cloudflare.json",
         "default": "./dist/esm/config/tsconfig/cloudflare.json"
-      }
+      },
+      "default": "./dist/esm/config/tsconfig/cloudflare.json"
     },
     "./tsconfig/library.json": {
       "import": {
         "types": "./dist/esm/config/tsconfig/library.json",
         "default": "./dist/esm/config/tsconfig/library.json"
-      }
+      },
+      "default": "./dist/esm/config/tsconfig/library.json"
     },
     "./tsconfig/react-library.json": {
       "import": {
         "types": "./dist/esm/config/tsconfig/react-library.json",
         "default": "./dist/esm/config/tsconfig/react-library.json"
-      }
+      },
+      "default": "./dist/esm/config/tsconfig/react-library.json"
     },
     "./tsconfig/react-router.json": {
       "import": {
         "types": "./dist/esm/config/tsconfig/react-router.json",
         "default": "./dist/esm/config/tsconfig/react-router.json"
-      }
+      },
+      "default": "./dist/esm/config/tsconfig/react-router.json"
     },
     "./vitest/node": {
       "import": {
@@ -535,7 +544,7 @@
   },
   "scripts": {
     "setup:agent": "wp setup",
-    "build": "tshy && vp run chmod-bins && vp run link-self-bins",
+    "build": "tshy && bun src/build/normalize-tsconfig-json-exports.ts && vp run chmod-bins && vp run link-self-bins",
     "build:runtime-binaries": "bun scripts/build-runtime-binaries.ts",
     "stage:plugin-runtime": "bun scripts/stage-plugin-runtime-artifacts.ts",
     "postbuild": "vp run generate-skills && vp run sync-doc-templates",
@@ -710,10 +719,10 @@
     "@stryker-mutator/typescript-checker": "^9.6.1",
     "@playwright/test": "^1.55.0",
     "wrangler": "^4.50.0",
-    "@webpresso/agent-kit-runtime-darwin-arm64": "0.28.0",
-    "@webpresso/agent-kit-runtime-darwin-x64": "0.28.0",
-    "@webpresso/agent-kit-runtime-linux-x64": "0.28.0",
-    "@webpresso/agent-kit-runtime-linux-arm64": "0.28.0",
-    "@webpresso/agent-kit-runtime-windows-x64": "0.28.0"
+    "@webpresso/agent-kit-runtime-darwin-arm64": "0.29.1",
+    "@webpresso/agent-kit-runtime-darwin-x64": "0.29.1",
+    "@webpresso/agent-kit-runtime-linux-x64": "0.29.1",
+    "@webpresso/agent-kit-runtime-linux-arm64": "0.29.1",
+    "@webpresso/agent-kit-runtime-windows-x64": "0.29.1"
   }
 }

package/tsconfig/cloudflare.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
   "display": "Cloudflare Workers",
-  "extends": "./base.json",
+  "extends": "@webpresso/agent-kit/tsconfig/base.json",
   "compilerOptions": {
     "target": "ES2024",
     "lib": ["ES2024"],

package/tsconfig/library.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
   "display": "Library",
-  "extends": "./base.json",
+  "extends": "@webpresso/agent-kit/tsconfig/base.json",
   "compilerOptions": {
     "declaration": true,
     "declarationMap": true,

package/tsconfig/react-library.json

@@ -1,9 +1,10 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
   "display": "React Library",
-  "extends": "./library.json",
+  "extends": "@webpresso/agent-kit/tsconfig/library.json",
   "compilerOptions": {
     "lib": ["ES2024", "DOM", "DOM.Iterable"],
-    "jsx": "react-jsx"
+    "jsx": "react-jsx",
+    "types": ["react", "react-dom"]
   }
 }

package/tsconfig/react-router.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
   "display": "React Router v7",
-  "extends": "./webpresso.json",
+  "extends": "@webpresso/agent-kit/tsconfig/react-library.json",
   "compilerOptions": {
     "lib": ["ES2024", "DOM", "DOM.Iterable"],
     "jsx": "react-jsx",

package/dist/esm/blueprint/db/legacy-migration.d.ts

@@ -1,41 +0,0 @@
-/**
- * Legacy DB deprecation + migration (F12 / R10 / E12, Task 1.1).
- *
- * Pre-worktree-scoping, the projection DB lived at
- * `<cwd>/.agent/.blueprints.db`. Task 1.1 moves it under the worktree-scoped
- * state-root path. For git repos that still have the legacy file (and any
- * sibling `-wal` / `-shm` files from a crashed write), do the following on
- * first access:
- *
- *  1. Log a one-line deprecation pointing at the new path.
- *  2. If the destination does not exist, rename the legacy files to the new
- *     location. Sibling WAL/SHM are moved alongside the main DB.
- *  3. If the destination already exists, leave both untouched and surface a
- *     failure-style warning. Callers should not double-count.
- *
- * Memoized per-repo so repeated calls within a process touch disk once.
- */
-export declare const LEGACY_DB_SIBLINGS: readonly ["-wal", "-shm"];
-export type MigrationOutcome = 'migrated' | 'destination-exists' | 'no-legacy' | 'not-git';
-export interface MigrationResult {
-    readonly outcome: MigrationOutcome;
-    readonly legacyPath: string;
-    readonly destinationPath: string | null;
-    readonly movedSiblings: readonly string[];
-    readonly warning: string | null;
-}
-interface Logger {
-    warn(msg: string): void;
-}
-/**
- * Detect and (if safe) migrate a legacy `.agent/.blueprints.db` for `cwd`.
- *
- * Idempotent and memoized per `cwd`. Outside a git repo the function is a
- * no-op (returns `outcome: 'not-git'`) because the legacy path *is* the
- * canonical path in that case.
- */
-export declare function migrateLegacyAgentDb(cwd: string, logger?: Logger): MigrationResult;
-/** Test-only helper. */
-export declare function _clearMigrationMemoForTests(): void;
-export {};
-//# sourceMappingURL=legacy-migration.d.ts.map

package/dist/esm/blueprint/db/legacy-migration.js

@@ -1,122 +0,0 @@
-/**
- * Legacy DB deprecation + migration (F12 / R10 / E12, Task 1.1).
- *
- * Pre-worktree-scoping, the projection DB lived at
- * `<cwd>/.agent/.blueprints.db`. Task 1.1 moves it under the worktree-scoped
- * state-root path. For git repos that still have the legacy file (and any
- * sibling `-wal` / `-shm` files from a crashed write), do the following on
- * first access:
- *
- *  1. Log a one-line deprecation pointing at the new path.
- *  2. If the destination does not exist, rename the legacy files to the new
- *     location. Sibling WAL/SHM are moved alongside the main DB.
- *  3. If the destination already exists, leave both untouched and surface a
- *     failure-style warning. Callers should not double-count.
- *
- * Memoized per-repo so repeated calls within a process touch disk once.
- */
-import { existsSync, mkdirSync, renameSync } from 'node:fs';
-import path from 'node:path';
-import { LEGACY_AGENT_DIR, LEGACY_DB_FILENAME } from './paths.js';
-import { getSurfacePath, NotInGitRepoError } from '#paths/state-root.js';
-export const LEGACY_DB_SIBLINGS = ['-wal', '-shm'];
-const defaultLogger = {
-    warn(msg) {
-        process.stderr.write(`${msg}\n`);
-    },
-};
-const memo = new Map();
-function legacyDbPath(cwd) {
-    return path.join(cwd, LEGACY_AGENT_DIR, LEGACY_DB_FILENAME);
-}
-function moveOne(from, to) {
-    if (!existsSync(from))
-        return false;
-    renameSync(from, to);
-    return true;
-}
-function tryResolveDestination(cwd) {
-    // Call getSurfacePath directly (not resolveBlueprintProjectionDbPath) so
-    // we can distinguish "git repo, real worktree-scoped destination" from
-    // "non-git repo, legacy path IS canonical". The latter must not be treated
-    // as a migration target.
-    try {
-        return getSurfacePath('blueprints/blueprints.db', 'worktree', cwd);
-    }
-    catch (err) {
-        if (err instanceof NotInGitRepoError)
-            return null;
-        throw err;
-    }
-}
-/**
- * Detect and (if safe) migrate a legacy `.agent/.blueprints.db` for `cwd`.
- *
- * Idempotent and memoized per `cwd`. Outside a git repo the function is a
- * no-op (returns `outcome: 'not-git'`) because the legacy path *is* the
- * canonical path in that case.
- */
-export function migrateLegacyAgentDb(cwd, logger = defaultLogger) {
-    const cached = memo.get(cwd);
-    if (cached !== undefined)
-        return cached;
-    const legacy = legacyDbPath(cwd);
-    const result = computeMigration(cwd, legacy, logger);
-    memo.set(cwd, result);
-    return result;
-}
-function computeMigration(cwd, legacy, logger) {
-    if (!existsSync(legacy)) {
-        return {
-            outcome: 'no-legacy',
-            legacyPath: legacy,
-            destinationPath: null,
-            movedSiblings: [],
-            warning: null,
-        };
-    }
-    const destination = tryResolveDestination(cwd);
-    if (destination === null) {
-        // Non-git: legacy path IS canonical; nothing to migrate.
-        return {
-            outcome: 'not-git',
-            legacyPath: legacy,
-            destinationPath: null,
-            movedSiblings: [],
-            warning: null,
-        };
-    }
-    if (existsSync(destination)) {
-        const warning = `[blueprint] WARNING: legacy DB ${legacy} found but worktree DB already exists at ${destination}; leaving both untouched. Delete the legacy file once you have verified the new DB is current.`;
-        logger.warn(warning);
-        return {
-            outcome: 'destination-exists',
-            legacyPath: legacy,
-            destinationPath: destination,
-            movedSiblings: [],
-            warning,
-        };
-    }
-    logger.warn(`[blueprint] deprecated: ${legacy} → ${destination} (migrating; legacy .agent/.blueprints.db will be removed)`);
-    // Ensure the destination directory exists before renames.
-    mkdirSync(path.dirname(destination), { recursive: true });
-    moveOne(legacy, destination);
-    const movedSiblings = [];
-    for (const suffix of LEGACY_DB_SIBLINGS) {
-        const moved = moveOne(`${legacy}${suffix}`, `${destination}${suffix}`);
-        if (moved)
-            movedSiblings.push(suffix);
-    }
-    return {
-        outcome: 'migrated',
-        legacyPath: legacy,
-        destinationPath: destination,
-        movedSiblings,
-        warning: null,
-    };
-}
-/** Test-only helper. */
-export function _clearMigrationMemoForTests() {
-    memo.clear();
-}
-//# sourceMappingURL=legacy-migration.js.map