@webpresso/agent-kit 0.28.0 → 0.29.1

package/dist/esm/cli/commands/init/index.js

@@ -8,7 +8,6 @@
  */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { basename, dirname, join, relative } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { isTelemetryEnabled, reportTthw } from '#telemetry/setup-tthw';
 import { readPackageVersion } from '#cli/utils';
 import { resolveBlueprintRoot } from '#utils/blueprint-root';
@@ -26,6 +25,7 @@ import { GENERATED_PATHS_BLOCK, patchGitignore, untrackGeneratedGitignoredPaths,
 import { scaffoldAgentsMd } from './scaffold-agents-md.js';
 import { scaffoldBlueprints } from './scaffold-blueprints.js';
 import { scaffoldDocs } from './scaffold-docs.js';
+import { resolveAgentKitPackageRoot } from './package-root.js';
 import { BASE_KIT_QUALITY_TARGETS, collectRuntimeContractGuidance, scaffoldBaseKit, } from './scaffold-base-kit.js';
 import { scaffoldMonorepoNav } from './scaffold-monorepo-nav.js';
 import { REQUIRED_CORE_CAPABILITIES, auditHostSkillVisibility, parseAgentHosts, serializeHostVisibility, summarizeHostVisibility, } from './host-visibility.js';
@@ -75,23 +75,14 @@ export const EXIT_SUCCESS = 0;
 export const EXIT_SETUP_FAIL = 1;
 export const EXIT_USER_ABORT = 2;
 export const EXIT_WRITE_FAIL = 3;
-export function resolveCatalogDir() {
-    // The `catalog/` directory is bundled alongside `package.json` in the
-    // published tarball (see `files` in package.json). To locate it at both
-    // development time (src/cli/commands/init/index.ts) and at runtime (dist/cli.js),
-    // we walk up from this module looking for the nearest package.json.
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let depth = 0; depth < 8; depth++) {
-        if (existsSync(join(dir, 'package.json'))) {
-            const candidate = join(dir, 'catalog');
-            if (existsSync(candidate))
-                return candidate;
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
+export function resolveCatalogDir(options = {}) {
+    // The published native `bin/wp` binary executes from its own on-disk path,
+    // while the bundled module URL can resolve inside Bun's virtual filesystem.
+    // Probe both the module location and the real executable path so packed
+    // installs still find the shipped `catalog/` directory.
+    const root = resolveAgentKitPackageRoot({ ...options, requireCatalog: true });
+    if (root)
+        return join(root, 'catalog');
     throw new Error('wp init: could not locate the webpresso catalog directory. The package may be broken.');
 }
 function inferBlueprintsDirOverride(repoRoot, existingConfig) {
@@ -184,7 +175,10 @@ export async function runInit(flags) {
     const presets = parsePresets(flags.with);
     let selectedHosts;
     try {
-        selectedHosts = parseAgentHosts(flags.host);
+        selectedHosts =
+            flags.host === undefined
+                ? (existingConfig?.hosts?.selected ?? parseAgentHosts(undefined))
+                : parseAgentHosts(flags.host);
     }
     catch (error) {
         console.error(error instanceof Error ? error.message : String(error));
@@ -557,6 +551,10 @@ export async function runInit(flags) {
                     console.warn(`  agent-kit global: ⚠ \`${agentKitGlobalResult.command.join(' ')}\` exited with ${agentKitGlobalResult.exitCode}; ` +
                         'the existing global binary is unchanged. Re-run `wp setup` once the registry is reachable.');
                     break;
+                case 'agent-kit-global-staging-failed':
+                    console.warn(`  agent-kit global: ⚠ native bin/wp staging failed (${agentKitGlobalResult.reason}); ` +
+                        'the Claude plugin may keep using the previous cached launcher until the runtime package is rebuilt/reinstalled.');
+                    break;
             }
         }
         const claudePluginResult = ensureClaudeCodeUserPlugin({

package/dist/esm/cli/commands/init/package-root.d.ts

@@ -0,0 +1,20 @@
+export interface ResolveAgentKitPackageRootOptions {
+    readonly moduleUrl?: string;
+    readonly execPath?: string;
+    readonly argv0?: string;
+    readonly argv1?: string;
+    readonly pathEnv?: string;
+    readonly pathExtEnv?: string;
+    readonly platform?: NodeJS.Platform;
+    readonly requireCatalog?: boolean;
+}
+export declare function isAgentKitPackageRoot(dir: string, options?: {
+    readonly requireCatalog?: boolean;
+}): boolean;
+export declare function findAgentKitPackageRoot(startPath: string | undefined, options?: {
+    readonly requireCatalog?: boolean;
+    readonly platform?: NodeJS.Platform;
+}): string | null;
+export declare function resolveAgentKitPackageRoot(options?: ResolveAgentKitPackageRootOptions): string | null;
+export declare function resolveAgentKitPackageRootOrThrow(errorMessage: string, options?: ResolveAgentKitPackageRootOptions): string;
+//# sourceMappingURL=package-root.d.ts.map

package/dist/esm/cli/commands/init/package-root.js

@@ -0,0 +1,110 @@
+import { existsSync } from 'node:fs';
+import { isAbsolute, join, posix, win32 } from 'node:path';
+import { fileURLToPath } from 'node:url';
+function existingModulePath(moduleUrl) {
+    if (typeof moduleUrl !== 'string' || moduleUrl.length === 0)
+        return null;
+    try {
+        return fileURLToPath(moduleUrl);
+    }
+    catch {
+        return null;
+    }
+}
+function isRunnablePath(path) {
+    if (typeof path !== 'string' || path.length === 0)
+        return false;
+    return isAbsolute(path) || win32.isAbsolute(path) || path.includes('/') || path.includes('\\');
+}
+function pathModuleForPlatform(platform) {
+    return platform === 'win32' ? win32 : posix;
+}
+function pathDelimiterForPlatform(platform) {
+    return platform === 'win32' ? ';' : ':';
+}
+function resolveBinOnPath(binName, pathEnv, options = {}) {
+    if (binName.length === 0 || typeof pathEnv !== 'string' || pathEnv.length === 0)
+        return null;
+    const platform = options.platform ?? process.platform;
+    const pathExtEnv = options.pathExtEnv ?? process.env.PATHEXT;
+    const pathModule = pathModuleForPlatform(platform);
+    const candidates = platform === 'win32' && !/\.[^./\\]+$/u.test(binName)
+        ? [
+            binName,
+            ...(typeof pathExtEnv === 'string' && pathExtEnv.length > 0
+                ? pathExtEnv
+                    .split(';')
+                    .map((entry) => entry.trim())
+                    .filter((entry) => entry.length > 0)
+                    .map((entry) => `${binName}${entry.toLowerCase()}`)
+                : [`${binName}.exe`, `${binName}.cmd`, `${binName}.bat`]),
+        ]
+        : [binName];
+    for (const entry of pathEnv.split(pathDelimiterForPlatform(platform))) {
+        if (entry.length === 0)
+            continue;
+        for (const binCandidate of candidates) {
+            for (const candidate of new Set([pathModule.join(entry, binCandidate), join(entry, binCandidate)])) {
+                if (existsSync(candidate))
+                    return candidate;
+            }
+        }
+    }
+    return null;
+}
+export function isAgentKitPackageRoot(dir, options = {}) {
+    if (!existsSync(join(dir, 'package.json')))
+        return false;
+    if (options.requireCatalog === true && !existsSync(join(dir, 'catalog')))
+        return false;
+    return (existsSync(join(dir, 'bin', 'wp')) ||
+        existsSync(join(dir, 'bin', 'wp.cmd')) ||
+        existsSync(join(dir, 'bin', 'wp.exe')) ||
+        existsSync(join(dir, 'bin', 'wp.js')) ||
+        existsSync(join(dir, '.claude-plugin', 'plugin.json')) ||
+        existsSync(join(dir, 'src', 'cli', 'cli.ts')) ||
+        existsSync(join(dir, 'dist', 'esm', 'cli', 'cli.js')));
+}
+export function findAgentKitPackageRoot(startPath, options = {}) {
+    if (!isRunnablePath(startPath))
+        return null;
+    const platform = options.platform ?? process.platform;
+    const pathModule = pathModuleForPlatform(platform);
+    let dir = pathModule.dirname(startPath);
+    for (let depth = 0; depth < 10; depth++) {
+        if (isAgentKitPackageRoot(dir, options))
+            return dir;
+        const parent = pathModule.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+export function resolveAgentKitPackageRoot(options = {}) {
+    const modulePath = existingModulePath(options.moduleUrl ?? import.meta.url);
+    const execPath = options.execPath ?? process.execPath;
+    const argv0 = options.argv0 ?? process.argv[0];
+    const argv1 = options.argv1 ?? process.argv[1];
+    const pathEnv = options.pathEnv ?? process.env.PATH;
+    const platform = options.platform ?? process.platform;
+    const pathModule = pathModuleForPlatform(platform);
+    const pathResolvedBin = resolveBinOnPath(pathModule.basename(argv0 || 'wp'), pathEnv, {
+        pathExtEnv: options.pathExtEnv,
+        platform,
+    });
+    const requireCatalog = options.requireCatalog;
+    for (const startPath of [modulePath, argv1, execPath, pathResolvedBin, argv0]) {
+        const root = findAgentKitPackageRoot(startPath ?? undefined, { requireCatalog, platform });
+        if (root)
+            return root;
+    }
+    return null;
+}
+export function resolveAgentKitPackageRootOrThrow(errorMessage, options = {}) {
+    const root = resolveAgentKitPackageRoot(options);
+    if (root)
+        return root;
+    throw new Error(errorMessage);
+}
+//# sourceMappingURL=package-root.js.map

package/dist/esm/cli/commands/init/scaffold-base-kit.js

@@ -38,7 +38,11 @@ const TEMPLATE_MAP = [
     ],
     ['.husky/pre-commit.tmpl', '.husky/pre-commit'],
     ['.husky/commit-msg.tmpl', '.husky/commit-msg'],
-    ['.github/workflows/ci.webpresso.yml.tmpl', '.github/workflows/ci.webpresso.yml'],
+    [
+        '.github/actions/setup-webpresso/action.yml.tmpl',
+        '.github/actions/setup-webpresso/action.yml',
+    ],
+    ['.github/workflows/ci.yml.tmpl', '.github/workflows/ci.yml'],
     ['test/.gitkeep.tmpl', 'test/.gitkeep'],
     ['e2e/.gitkeep.tmpl', 'e2e/.gitkeep'],
 ];

package/dist/esm/cli/commands/init/scaffolders/agent-hooks/index.d.ts

@@ -1,4 +1,5 @@
 import { type MergeOptions, type MergeResult } from '#cli/commands/init/merge';
+import { type ResolveAgentKitPackageRootOptions } from '#cli/commands/init/package-root';
 import type { CodexAppServerApi } from '#codex/app-server/types.js';
 import { type SyncCodexHookTrustResult } from './codex-trust-sync.js';
 type HookEntry = {
@@ -63,6 +64,8 @@ export interface ScaffoldAgentHooksResult {
     codex: MergeResult;
     claudeUser: MergeResult;
 }
+export type ResolvePackageRootForHookLaunchersOptions = ResolveAgentKitPackageRootOptions;
+export declare function resolvePackageRootForHookLaunchers(options?: ResolvePackageRootForHookLaunchersOptions): string;
 export declare function scaffoldAgentHooks(input: ScaffoldAgentHooksInput): Promise<ScaffoldAgentHooksResult>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/cli/commands/init/scaffolders/agent-hooks/index.js

@@ -11,15 +11,16 @@
  */
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { join, resolve } from 'node:path';
 import { isHookName } from '#cli/commands/hook.js';
 import { patchJsonFile } from '#cli/commands/init/merge';
+import { resolveAgentKitPackageRootOrThrow, } from '#cli/commands/init/package-root';
 import { CodexAppServerClient } from '#codex/app-server/client.js';
 import { normalizeGlobalCodexHooksFile, resolveBinaryOnPath, } from '#cli/commands/init/scaffolders/agent-hooks/codex-global-normalize';
 import { isPresetOwnedGlobalCodexHook } from './codex-global-ownership.js';
 import { syncCodexHookTrustWithAppServer, } from './codex-trust-sync.js';
 import { buildSkillTag, extractSkillHooks, isTaggedSkillHook, } from './skill-hooks.js';
+import { resolveRuntimeTarget, runtimePackageDirName } from '#build/runtime-targets.js';
 // Claude Code uses $CLAUDE_PROJECT_DIR. Codex hook runners can execute while the
 // active session cwd points at a sibling repo, so Codex hook commands must be
 // path-stable and not depend on the caller's cwd.
@@ -609,31 +610,14 @@ function resolveProjectHookBinPath(repoRoot, binName) {
     return resolve(repoRoot, 'node_modules', '@webpresso', 'agent-kit', 'bin', `${binName}.js`);
 }
 function resolvePackageHookBin(binName) {
-    return join(resolvePackageRoot(), 'bin', `${binName}.js`);
+    return join(resolvePackageRootForHookLaunchers(), 'bin', `${binName}.js`);
 }
-function resolvePackageRoot() {
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let depth = 0; depth < 10; depth++) {
-        if (existsSync(join(dir, 'package.json')) && existsSync(join(dir, 'bin', 'wp.js'))) {
-            return dir;
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    throw new Error('wp setup: could not locate @webpresso/agent-kit package root for hook launchers.');
+export function resolvePackageRootForHookLaunchers(options = {}) {
+    return resolveAgentKitPackageRootOrThrow('wp setup: could not locate @webpresso/agent-kit package root for hook launchers.', options);
 }
-// Consumer-side runtime package directory for the current platform. Mirrors the
-// canonical target table in `src/build/runtime-targets.ts`; kept inline here to
-// avoid a deep cross-tree import for a small lookup. If that target list ever
-// changes, update both. Returns undefined for platforms with no compiled
-// runtime package.
 function compiledRuntimePackageDir() {
-    const osLabel = process.platform === 'win32' ? 'windows' : process.platform;
-    const id = `${osLabel}-${process.arch}`;
-    const known = new Set(['darwin-arm64', 'darwin-x64', 'linux-x64', 'linux-arm64', 'windows-x64']);
-    return known.has(id) ? `agent-kit-runtime-${id}` : undefined;
+    const target = resolveRuntimeTarget();
+    return target ? runtimePackageDirName(target.packageName) : undefined;
 }
 /**
  * Absolute path to the consumer's self-contained compiled `wp` binary, when the

package/dist/esm/cli/commands/init/scaffolders/agent-kit-global/index.d.ts

@@ -37,12 +37,17 @@ export interface EnsureAgentKitGlobalInput {
     argv1?: string;
     /** DI seam for source/git-clone detection. */
     detectGit?: (argv1: string) => string | null;
+    /** DI seam for tests/global installs; defaults to the package root owning argv1/import. */
+    packageRoot?: string;
+    /** DI seam for staging-root fallback when argv1 cannot be mapped back to the owning package. */
+    resolvePackageRootForStaging?: (argv1: string) => string | null;
     /** DI seam for spinner. Defaults to noop when !process.stdout.isTTY. */
     spinnerFactory?: SpinnerFactory;
 }
 export type EnsureAgentKitGlobalResult = {
     kind: 'agent-kit-global-updated';
     command: readonly string[];
+    stagedBin?: string;
 } | {
     kind: 'agent-kit-global-skipped-dry-run';
 } | {
@@ -57,6 +62,10 @@ export type EnsureAgentKitGlobalResult = {
     kind: 'agent-kit-global-failed';
     exitCode: number;
     command: readonly string[];
+} | {
+    kind: 'agent-kit-global-staging-failed';
+    reason: string;
+    command: readonly string[];
 };
 /**
  * Refresh the single global `@webpresso/agent-kit` install via `vp install -g`.

package/dist/esm/cli/commands/init/scaffolders/agent-kit-global/index.js

@@ -25,10 +25,58 @@
  * warn-only contract as the codex-cli scaffolder).
  */
 import { spawnSync } from 'node:child_process';
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, statSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { findAgentKitPackageRoot, resolveAgentKitPackageRoot, } from '#cli/commands/init/package-root';
 import { makeNoopSpinnerFactory } from '#cli/commands/init/scaffolders/spinner';
 import { buildVpGlobalInstallCommand, detectGitInstall, PUBLIC_PACKAGE_NAME, } from '#cli/auto-update/detect-pm.js';
 const NO_VP_HINT = 'vp (vite-plus) is not on PATH; cannot refresh the global ' +
     `${PUBLIC_PACKAGE_NAME}. Install vite-plus, then re-run \`wp setup\`.`;
+function resolvePackageRootForStaging(argv1) {
+    const fromArgv = argv1.length > 0 ? findAgentKitPackageRoot(argv1) : null;
+    if (fromArgv)
+        return fromArgv;
+    return resolveAgentKitPackageRoot({ moduleUrl: import.meta.url });
+}
+function runtimeFilename(manifest, target) {
+    const binaryName = manifest.binaryName ?? 'wp';
+    return target.os === 'win32' ? `${binaryName}.exe` : binaryName;
+}
+function runtimePackageDirName(packageName) {
+    return packageName.split('/').at(-1) ?? packageName;
+}
+function resolveHostRuntimeBinary(packageRoot) {
+    const manifestPath = join(packageRoot, 'bin', 'runtime-manifest.json');
+    if (!existsSync(manifestPath))
+        return null;
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    const target = manifest.targets?.find((candidate) => candidate.os === process.platform && candidate.cpu === process.arch);
+    if (!target?.id || !target.packageName)
+        return null;
+    const filename = runtimeFilename(manifest, target);
+    const candidates = [
+        join(packageRoot, 'bin', 'runtime', target.id, filename),
+        join(packageRoot, 'dist', 'runtime', target.id, filename),
+        join(packageRoot, '..', runtimePackageDirName(target.packageName), 'bin', filename),
+        join(packageRoot, 'node_modules', '@webpresso', runtimePackageDirName(target.packageName), 'bin', filename),
+    ];
+    const source = candidates.find((candidate) => existsSync(candidate));
+    return source ? { source, targetId: target.id } : null;
+}
+function stageHostRuntimeLauncher(packageRoot) {
+    const runtime = resolveHostRuntimeBinary(packageRoot);
+    if (!runtime)
+        return null;
+    const destination = join(packageRoot, 'bin', 'wp');
+    mkdirSync(dirname(destination), { recursive: true });
+    copyFileSync(runtime.source, destination);
+    chmodSync(destination, 0o755);
+    const stat = statSync(destination);
+    if (!stat.isFile()) {
+        throw new Error(`staged ${destination} for ${runtime.targetId} is not a regular file`);
+    }
+    return destination;
+}
 /**
  * Refresh the single global `@webpresso/agent-kit` install via `vp install -g`.
  */
@@ -58,7 +106,37 @@ export function ensureAgentKitGlobal(input) {
         spinner.fail('agent-kit global refresh failed');
         return { kind: 'agent-kit-global-failed', exitCode: install.status ?? -1, command };
     }
+    let stagedBin;
+    const packageRoot = input.packageRoot ??
+        (input.resolvePackageRootForStaging ?? resolvePackageRootForStaging)(argv1);
+    if (!packageRoot) {
+        spinner.fail('agent-kit native launcher staging failed');
+        return {
+            kind: 'agent-kit-global-staging-failed',
+            reason: 'could not resolve the owning @webpresso/agent-kit package root for staging',
+            command,
+        };
+    }
+    try {
+        stagedBin = stageHostRuntimeLauncher(packageRoot) ?? undefined;
+        if (!stagedBin) {
+            spinner.fail('agent-kit native launcher staging failed');
+            return {
+                kind: 'agent-kit-global-staging-failed',
+                reason: `could not resolve a host runtime binary under ${packageRoot}`,
+                command,
+            };
+        }
+    }
+    catch (error) {
+        spinner.fail('agent-kit native launcher staging failed');
+        return {
+            kind: 'agent-kit-global-staging-failed',
+            reason: error instanceof Error ? error.message : String(error),
+            command,
+        };
+    }
     spinner.succeed('agent-kit global up to date');
-    return { kind: 'agent-kit-global-updated', command };
+    return { kind: 'agent-kit-global-updated', command, stagedBin };
 }
 //# sourceMappingURL=index.js.map

package/dist/esm/cli/commands/init/scaffolders/claude-rules/index.js

@@ -4,9 +4,9 @@
  */
 import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, readlinkSync, rmSync, symlinkSync, writeFileSync, } from 'node:fs';
 import { dirname, join, relative } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { readConfig } from '#cli/commands/init/config';
 import { readPackageJson } from '#cli/commands/init/detect-consumer';
+import { resolveAgentKitPackageRootOrThrow } from '#cli/commands/init/package-root';
 function detectMode(repoRoot) {
     const pkg = readPackageJson(repoRoot).info;
     if (pkg?.name === 'webpresso') {
@@ -58,17 +58,7 @@ function writeOverrideRule(targetPath, sourcePath, options) {
     return { targetPath, action: 'drifted' };
 }
 function resolveCurrentPackageRoot() {
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let depth = 0; depth < 8; depth++) {
-        if (existsSync(join(dir, 'package.json')) && existsSync(join(dir, 'catalog'))) {
-            return dir;
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    throw new Error('wp init: could not locate the webpresso package root for claude-rules fallback.');
+    return resolveAgentKitPackageRootOrThrow('wp init: could not locate the webpresso package root for claude-rules fallback.', { requireCatalog: true });
 }
 export function scaffoldClaudeRules(input) {
     const { repoRoot, options } = input;

package/dist/esm/cli/commands/init/scaffolders/subagents/index.js

@@ -1,7 +1,7 @@
 import { existsSync, lstatSync, mkdirSync, readdirSync, readlinkSync, rmSync, symlinkSync, } from 'node:fs';
 import { dirname, join, relative } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { readPackageJson } from '#cli/commands/init/detect-consumer';
+import { resolveAgentKitPackageRootOrThrow } from '#cli/commands/init/package-root';
 function detectMode(repoRoot) {
     const pkg = readPackageJson(repoRoot).info;
     if (pkg?.name === 'webpresso') {
@@ -24,17 +24,7 @@ function detectMode(repoRoot) {
     };
 }
 function resolveCurrentPackageRoot() {
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let depth = 0; depth < 8; depth++) {
-        if (existsSync(join(dir, 'package.json')) && existsSync(join(dir, 'catalog'))) {
-            return dir;
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    throw new Error('wp init: could not locate the webpresso package root for subagents fallback.');
+    return resolveAgentKitPackageRootOrThrow('wp init: could not locate the webpresso package root for subagents fallback.', { requireCatalog: true });
 }
 export function scaffoldSubagents(input) {
     const { repoRoot, options } = input;

package/dist/esm/config/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/dist/esm/config/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/dist/esm/config/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/dist/esm/config/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/dev/restore-dev-links/index.js

@@ -20,11 +20,11 @@
  * to fail in CI. Postinstall is the only seam that runs deterministically
  * after install, doesn't touch the lockfile, and is observable enough to debug.
  */
-import { lstatSync, mkdirSync, readlinkSync, realpathSync, renameSync, symlinkSync, unlinkSync, } from 'node:fs';
+import { lstatSync, mkdirSync, readlinkSync, renameSync, symlinkSync, unlinkSync, } from 'node:fs';
 import { existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { STATE_FILE_RELATIVE_PATH, readDevLinkState } from '#dev/dev-link-state';
+import { isDirectEntrypoint } from '#hooks/shared/direct-entrypoint';
 export function restoreDevLinks(options = {}) {
     const cwd = options.cwd ?? process.cwd();
     const stdout = options.stdout ?? process.stdout;
@@ -95,8 +95,7 @@ function timestamp() {
     const d = new Date();
     return `${d.getFullYear()}${pad2(d.getMonth() + 1)}${pad2(d.getDate())}-${pad2(d.getHours())}${pad2(d.getMinutes())}${pad2(d.getSeconds())}`;
 }
-if (process.argv[1] &&
-    realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1])) {
+if (isDirectEntrypoint(import.meta.url)) {
     const result = restoreDevLinks();
     process.exit(result.exitCode);
 }

package/dist/esm/docs-linter/blueprint-plan.js

@@ -24,7 +24,7 @@ const EXECUTABLE_BLUEPRINT_STATUSES = new Set([
     'completed',
     'archived',
 ]);
-const TASK_STATUSES = new Set(['todo', 'in_progress', 'blocked', 'done']);
+const TASK_STATUSES = new Set(['todo', 'in-progress', 'blocked', 'done', 'dropped']);
 /**
  * Find tasks using ### (3 hashes) instead of #### (4 hashes).
  * Exported for testability.
@@ -282,7 +282,7 @@ function createTaskStatusInvalidError(filePath, taskId, status) {
         file: filePath,
         severity: 'error',
         source: 'blueprint-format',
-        message: `Task ${taskId} has invalid status "${status}". Use only: todo, in_progress, blocked, done.`,
+        message: `Task ${taskId} has invalid status "${status}". Use only: todo, in-progress, blocked, done, dropped.`,
         ruleId: 'blueprint-task-status-invalid',
     };
 }
@@ -318,7 +318,7 @@ function createCompletedRequiresAllDoneError(filePath, taskId, taskStatus) {
         file: filePath,
         severity: 'error',
         source: 'blueprint-format',
-        message: `Blueprint status is completed but task ${taskId} is "${taskStatus}" (expected "done").`,
+        message: `Blueprint status is completed but task ${taskId} is "${taskStatus}" (expected "done" or "dropped").`,
         ruleId: 'blueprint-completed-requires-all-done',
     };
 }
@@ -330,6 +330,48 @@ function validateLifecycleContract(filePath, content) {
         errors.push(createBlueprintStatusError(filePath, status ?? '(missing)'));
         return errors;
     }
+    if (status !== 'draft') {
+        const title = frontmatter?.title?.trim();
+        const owner = frontmatter?.owner?.trim();
+        const complexity = extractComplexity(content);
+        const lastUpdated = frontmatter?.last_updated?.trim();
+        if (!title) {
+            errors.push({
+                file: filePath,
+                severity: 'error',
+                source: 'blueprint-format',
+                message: 'Blueprint is missing required frontmatter field: title.',
+                ruleId: 'blueprint-title-required',
+            });
+        }
+        if (!owner) {
+            errors.push({
+                file: filePath,
+                severity: 'error',
+                source: 'blueprint-format',
+                message: 'Blueprint is missing required frontmatter field: owner.',
+                ruleId: 'blueprint-owner-required',
+            });
+        }
+        if (!['XS', 'S', 'M', 'L', 'XL'].includes(complexity)) {
+            errors.push({
+                file: filePath,
+                severity: 'error',
+                source: 'blueprint-format',
+                message: `Blueprint complexity "${complexity}" is invalid. Use only: XS, S, M, L, XL.`,
+                ruleId: 'blueprint-complexity-invalid',
+            });
+        }
+        if (!lastUpdated || !/^\d{4}-\d{2}-\d{2}$/.test(lastUpdated.replace(/^['"]|['"]$/g, ''))) {
+            errors.push({
+                file: filePath,
+                severity: 'error',
+                source: 'blueprint-format',
+                message: 'Blueprint is missing valid frontmatter field: last_updated (YYYY-MM-DD).',
+                ruleId: 'blueprint-last-updated-required',
+            });
+        }
+    }
     const taskBlocks = extractTaskBlocks(content);
     for (const task of taskBlocks) {
         const statusMatch = task.section.match(/\*\*Status:\*\*\s*(.+)/i);
@@ -364,7 +406,7 @@ function validateLifecycleContract(filePath, content) {
             if (!taskStatus || !TASK_STATUSES.has(taskStatus)) {
                 continue;
             }
-            if (taskStatus !== 'done') {
+            if (taskStatus !== 'done' && taskStatus !== 'dropped') {
                 errors.push(createCompletedRequiresAllDoneError(filePath, task.id, taskStatus));
             }
         }

package/dist/esm/hooks/check-dev-link/index.js

@@ -13,10 +13,10 @@
  * instead of the live source declared in `.webpresso/webpresso-dev-link.json`.
  * Always exits 0; never blocks session start.
  */
-import { readlinkSync, realpathSync } from 'node:fs';
+import { readlinkSync } from 'node:fs';
 import { join } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { STATE_FILE_RELATIVE_PATH, readDevLinkState } from '#dev/dev-link-state';
+import { isDirectEntrypoint } from '#hooks/shared/direct-entrypoint';
 export function detectDevLinkBreakage(options = {}) {
     const cwd = options.cwd ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
     const state = readDevLinkState(cwd);
@@ -78,8 +78,7 @@ export async function main() {
         process.stdout.write(`${out}\n`);
     process.exit(0);
 }
-if (process.argv[1] &&
-    realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1])) {
+if (isDirectEntrypoint(import.meta.url)) {
     void main();
 }
 // Re-export so tests can stub the state file path if needed in future.