@webpresso/agent-kit 0.21.5 → 0.23.0

package/dist/esm/build/release-policy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Release-time policy decisions for the publish pipeline.
+ *
+ * The per-platform native runtime packages (`@webpresso/agent-kit-runtime-*`)
+ * are a deferred capability: they are not yet created on the registry, the main
+ * package declares no `optionalDependencies` on them, and the plugin manifest
+ * still launches via the node entrypoint rather than a staged native `bin/wp`.
+ *
+ * Until that native-distribution work is intentionally activated, the release
+ * MUST NOT attempt to publish the matrix: a first-time `npm publish` of a
+ * never-created scoped package returns 404, which previously aborted the entire
+ * release before the main `@webpresso/agent-kit` package published (the root
+ * cause of the 0.22.x publish stall).
+ *
+ * The matrix publish is therefore gated behind an explicit opt-in. When the
+ * native-distribution feature lands, the release workflow sets
+ * `WP_PUBLISH_RUNTIME_MATRIX=1` (after bootstrapping the scoped packages on the
+ * registry) to turn it back on.
+ */
+export declare const PUBLISH_RUNTIME_MATRIX_ENV = "WP_PUBLISH_RUNTIME_MATRIX";
+/**
+ * Whether the release pipeline should build, stage, and publish the per-platform
+ * native runtime matrix. Defaults to `false` (matrix deferred); enabled only
+ * when `WP_PUBLISH_RUNTIME_MATRIX=1` is set explicitly.
+ */
+export declare function shouldPublishRuntimeMatrix(env: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=release-policy.d.ts.map

package/dist/esm/build/release-policy.js

@@ -0,0 +1,29 @@
+/**
+ * Release-time policy decisions for the publish pipeline.
+ *
+ * The per-platform native runtime packages (`@webpresso/agent-kit-runtime-*`)
+ * are a deferred capability: they are not yet created on the registry, the main
+ * package declares no `optionalDependencies` on them, and the plugin manifest
+ * still launches via the node entrypoint rather than a staged native `bin/wp`.
+ *
+ * Until that native-distribution work is intentionally activated, the release
+ * MUST NOT attempt to publish the matrix: a first-time `npm publish` of a
+ * never-created scoped package returns 404, which previously aborted the entire
+ * release before the main `@webpresso/agent-kit` package published (the root
+ * cause of the 0.22.x publish stall).
+ *
+ * The matrix publish is therefore gated behind an explicit opt-in. When the
+ * native-distribution feature lands, the release workflow sets
+ * `WP_PUBLISH_RUNTIME_MATRIX=1` (after bootstrapping the scoped packages on the
+ * registry) to turn it back on.
+ */
+export const PUBLISH_RUNTIME_MATRIX_ENV = 'WP_PUBLISH_RUNTIME_MATRIX';
+/**
+ * Whether the release pipeline should build, stage, and publish the per-platform
+ * native runtime matrix. Defaults to `false` (matrix deferred); enabled only
+ * when `WP_PUBLISH_RUNTIME_MATRIX=1` is set explicitly.
+ */
+export function shouldPublishRuntimeMatrix(env) {
+    return env[PUBLISH_RUNTIME_MATRIX_ENV] === '1';
+}
+//# sourceMappingURL=release-policy.js.map

package/dist/esm/build/runtime-targets.d.ts

@@ -0,0 +1,13 @@
+export interface RuntimeTarget {
+    readonly id: string;
+    readonly bunTarget: string;
+    readonly os: NodeJS.Platform;
+    readonly cpu: NodeJS.Architecture;
+    readonly packageName: string;
+}
+export declare const RUNTIME_BINARY_NAME = "wp";
+export declare const RUNTIME_TARGETS: readonly RuntimeTarget[];
+export declare function runtimeBinaryFilename(target: RuntimeTarget): string;
+export declare function runtimePackageDirName(packageName: string): string;
+export declare function resolveRuntimeTarget(platform?: NodeJS.Platform, arch?: NodeJS.Architecture): RuntimeTarget | undefined;
+//# sourceMappingURL=runtime-targets.d.ts.map

package/dist/esm/build/runtime-targets.js

@@ -0,0 +1,48 @@
+export const RUNTIME_BINARY_NAME = 'wp';
+export const RUNTIME_TARGETS = [
+    {
+        id: 'darwin-arm64',
+        bunTarget: 'bun-darwin-arm64',
+        os: 'darwin',
+        cpu: 'arm64',
+        packageName: '@webpresso/agent-kit-runtime-darwin-arm64',
+    },
+    {
+        id: 'darwin-x64',
+        bunTarget: 'bun-darwin-x64',
+        os: 'darwin',
+        cpu: 'x64',
+        packageName: '@webpresso/agent-kit-runtime-darwin-x64',
+    },
+    {
+        id: 'linux-x64',
+        bunTarget: 'bun-linux-x64',
+        os: 'linux',
+        cpu: 'x64',
+        packageName: '@webpresso/agent-kit-runtime-linux-x64',
+    },
+    {
+        id: 'linux-arm64',
+        bunTarget: 'bun-linux-arm64',
+        os: 'linux',
+        cpu: 'arm64',
+        packageName: '@webpresso/agent-kit-runtime-linux-arm64',
+    },
+    {
+        id: 'windows-x64',
+        bunTarget: 'bun-windows-x64',
+        os: 'win32',
+        cpu: 'x64',
+        packageName: '@webpresso/agent-kit-runtime-windows-x64',
+    },
+];
+export function runtimeBinaryFilename(target) {
+    return target.os === 'win32' ? `${RUNTIME_BINARY_NAME}.exe` : RUNTIME_BINARY_NAME;
+}
+export function runtimePackageDirName(packageName) {
+    return packageName.split('/').at(-1) ?? packageName;
+}
+export function resolveRuntimeTarget(platform = process.platform, arch = process.arch) {
+    return RUNTIME_TARGETS.find((target) => target.os === platform && target.cpu === arch);
+}
+//# sourceMappingURL=runtime-targets.js.map

package/dist/esm/cli/auto-update/detect-pm.d.ts

@@ -28,6 +28,21 @@ export interface DetectAbort {
 export type DetectResult = DetectSuccess | DetectAbort;
 export declare const PUBLIC_PACKAGE_NAME = "@webpresso/agent-kit";
 export declare const PUBLIC_NPM_REGISTRY = "https://registry.npmjs.org";
+/**
+ * Canonical global-install command for the public agent-kit.
+ *
+ * No `--registry` flag: npmjs.org is already the default registry, and a global
+ * `--registry` does NOT override a scoped `@webpresso:registry` mapping
+ * (npm/pnpm resolve the scope first). The flag was therefore redundant when no
+ * scope override exists and ineffective when one does. To force-public inside a
+ * repo that scopes `@webpresso` to a private registry, use the scoped form
+ * `--@webpresso:registry=${PUBLIC_NPM_REGISTRY}` instead.
+ *
+ * Exported so the `wp setup` self-update scaffolder reuses the exact same
+ * command (single source of truth — see `ensureAgentKitGlobal`).
+ */
+export declare function buildVpGlobalInstallCommand(): [string, ...string[]];
+export declare function formatLegacyCommandReplacementMessage(legacyCommand: string): string | null;
 /**
  * Detect whether argv1 is a symlink pointing into a supported source clone.
  * Returns the git worktree root if so, null otherwise.

package/dist/esm/cli/auto-update/detect-pm.js

@@ -20,17 +20,26 @@
 import { execFileSync } from 'node:child_process';
 import { realpathSync } from 'node:fs';
 import { delimiter, dirname, sep } from 'node:path';
+import { getLegacyAgentCommandReplacement } from '#cli/bundle/agent-command-inventory.js';
 export const PUBLIC_PACKAGE_NAME = '@webpresso/agent-kit';
 export const PUBLIC_NPM_REGISTRY = 'https://registry.npmjs.org';
-const VP_INSTALL_COMMAND = [
-    'vp',
-    'install',
-    '-g',
-    PUBLIC_PACKAGE_NAME,
-    '--',
-    '--registry',
-    PUBLIC_NPM_REGISTRY,
-];
+/**
+ * Canonical global-install command for the public agent-kit.
+ *
+ * No `--registry` flag: npmjs.org is already the default registry, and a global
+ * `--registry` does NOT override a scoped `@webpresso:registry` mapping
+ * (npm/pnpm resolve the scope first). The flag was therefore redundant when no
+ * scope override exists and ineffective when one does. To force-public inside a
+ * repo that scopes `@webpresso` to a private registry, use the scoped form
+ * `--@webpresso:registry=${PUBLIC_NPM_REGISTRY}` instead.
+ *
+ * Exported so the `wp setup` self-update scaffolder reuses the exact same
+ * command (single source of truth — see `ensureAgentKitGlobal`).
+ */
+export function buildVpGlobalInstallCommand() {
+    return ['vp', 'install', '-g', PUBLIC_PACKAGE_NAME];
+}
+const VP_INSTALL_COMMAND = buildVpGlobalInstallCommand();
 const INSTALL_COMMANDS = {
     npm: VP_INSTALL_COMMAND,
     pnpm: VP_INSTALL_COMMAND,
@@ -38,6 +47,12 @@ const INSTALL_COMMANDS = {
     bun: VP_INSTALL_COMMAND,
     vp: VP_INSTALL_COMMAND,
 };
+export function formatLegacyCommandReplacementMessage(legacyCommand) {
+    const replacement = getLegacyAgentCommandReplacement(legacyCommand);
+    if (replacement === null)
+        return null;
+    return `Legacy agent-kit command \`${legacyCommand}\` has a future replacement: \`${replacement}\`.`;
+}
 /**
  * Detect whether argv1 is a symlink pointing into a supported source clone.
  * Returns the git worktree root if so, null otherwise.

package/dist/esm/cli/auto-update/skip.js

@@ -37,7 +37,7 @@ export const CI_ENV_KEYS = [
     'DRONE',
     'JENKINS_URL',
 ];
-const SKIP_SUBCOMMANDS = new Set(['mcp']);
+const SKIP_SUBCOMMANDS = new Set(['mcp', 'hook']);
 export function shouldSkipUpdateCheck(env, argv) {
     if (hasInformationalFlag(argv))
         return true;
@@ -45,6 +45,8 @@ export function shouldSkipUpdateCheck(env, argv) {
         return true;
     if (env.WP_SKIP_UPDATE_CHECK === '1')
         return true;
+    if (isPackageLifecycleEnvironment(env))
+        return true;
     if (isCiEnvironment(env))
         return true;
     return false;
@@ -81,4 +83,10 @@ function isCiEnvironment(env) {
     }
     return false;
 }
+function isPackageLifecycleEnvironment(env) {
+    const lifecycleEvent = env.npm_lifecycle_event;
+    const packageJsonPath = env.npm_package_json;
+    return Boolean((lifecycleEvent && lifecycleEvent.trim().length > 0) ||
+        (packageJsonPath && packageJsonPath.trim().length > 0));
+}
 //# sourceMappingURL=skip.js.map

package/dist/esm/cli/bundle/agent-command-inventory.d.ts

@@ -0,0 +1,120 @@
+export type AgentCommandVisibility = 'public' | 'internal';
+export interface LegacyAgentCommandAlias {
+    legacyCommand: string;
+    replacementCommand: string;
+}
+export interface AgentCommandInventoryEntry {
+    id: string;
+    namespace: 'agent';
+    visibility: AgentCommandVisibility;
+    replacementCommand: string;
+    legacyAliases: readonly LegacyAgentCommandAlias[];
+}
+export declare const AGENT_COMMAND_INVENTORY: readonly [{
+    readonly id: "agent setup";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent setup";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp setup";
+        readonly replacementCommand: "webpresso agent setup";
+    }, {
+        readonly legacyCommand: "wp init";
+        readonly replacementCommand: "webpresso agent setup";
+    }];
+}, {
+    readonly id: "agent sync";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent sync";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp sync";
+        readonly replacementCommand: "webpresso agent sync";
+    }];
+}, {
+    readonly id: "agent audit";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent audit";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp audit";
+        readonly replacementCommand: "webpresso agent audit";
+    }];
+}, {
+    readonly id: "agent skills";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent skills";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp skill";
+        readonly replacementCommand: "webpresso agent skills";
+    }, {
+        readonly legacyCommand: "wp skills";
+        readonly replacementCommand: "webpresso agent skills";
+    }];
+}, {
+    readonly id: "agent docs lint";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent docs lint";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp docs";
+        readonly replacementCommand: "webpresso agent docs lint";
+    }, {
+        readonly legacyCommand: "wp docs lint";
+        readonly replacementCommand: "webpresso agent docs lint";
+    }];
+}, {
+    readonly id: "agent hooks doctor";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent hooks doctor";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp hooks";
+        readonly replacementCommand: "webpresso agent hooks doctor";
+    }, {
+        readonly legacyCommand: "wp hooks doctor";
+        readonly replacementCommand: "webpresso agent hooks doctor";
+    }, {
+        readonly legacyCommand: "wp doctor";
+        readonly replacementCommand: "webpresso agent hooks doctor";
+    }];
+}, {
+    readonly id: "agent blueprint";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent blueprint";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp blueprint";
+        readonly replacementCommand: "webpresso agent blueprint";
+    }];
+}, {
+    readonly id: "agent test";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent test";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp test";
+        readonly replacementCommand: "webpresso agent test";
+    }];
+}, {
+    readonly id: "agent e2e";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent e2e";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp e2e";
+        readonly replacementCommand: "webpresso agent e2e";
+    }];
+}, {
+    readonly id: "agent tech-debt";
+    readonly namespace: "agent";
+    readonly visibility: "public";
+    readonly replacementCommand: "webpresso agent tech-debt";
+    readonly legacyAliases: readonly [{
+        readonly legacyCommand: "wp tech-debt";
+        readonly replacementCommand: "webpresso agent tech-debt";
+    }];
+}];
+export declare function getLegacyAgentCommandReplacement(legacyCommand: string): string | null;
+//# sourceMappingURL=agent-command-inventory.d.ts.map

package/dist/esm/cli/bundle/agent-command-inventory.js

@@ -0,0 +1,100 @@
+export const AGENT_COMMAND_INVENTORY = [
+    {
+        id: 'agent setup',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent setup',
+        legacyAliases: [
+            { legacyCommand: 'wp setup', replacementCommand: 'webpresso agent setup' },
+            { legacyCommand: 'wp init', replacementCommand: 'webpresso agent setup' },
+        ],
+    },
+    {
+        id: 'agent sync',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent sync',
+        legacyAliases: [{ legacyCommand: 'wp sync', replacementCommand: 'webpresso agent sync' }],
+    },
+    {
+        id: 'agent audit',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent audit',
+        legacyAliases: [{ legacyCommand: 'wp audit', replacementCommand: 'webpresso agent audit' }],
+    },
+    {
+        id: 'agent skills',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent skills',
+        legacyAliases: [
+            { legacyCommand: 'wp skill', replacementCommand: 'webpresso agent skills' },
+            { legacyCommand: 'wp skills', replacementCommand: 'webpresso agent skills' },
+        ],
+    },
+    {
+        id: 'agent docs lint',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent docs lint',
+        legacyAliases: [
+            { legacyCommand: 'wp docs', replacementCommand: 'webpresso agent docs lint' },
+            { legacyCommand: 'wp docs lint', replacementCommand: 'webpresso agent docs lint' },
+        ],
+    },
+    {
+        id: 'agent hooks doctor',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent hooks doctor',
+        legacyAliases: [
+            { legacyCommand: 'wp hooks', replacementCommand: 'webpresso agent hooks doctor' },
+            { legacyCommand: 'wp hooks doctor', replacementCommand: 'webpresso agent hooks doctor' },
+            { legacyCommand: 'wp doctor', replacementCommand: 'webpresso agent hooks doctor' },
+        ],
+    },
+    {
+        id: 'agent blueprint',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent blueprint',
+        legacyAliases: [
+            { legacyCommand: 'wp blueprint', replacementCommand: 'webpresso agent blueprint' },
+        ],
+    },
+    {
+        id: 'agent test',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent test',
+        legacyAliases: [{ legacyCommand: 'wp test', replacementCommand: 'webpresso agent test' }],
+    },
+    {
+        id: 'agent e2e',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent e2e',
+        legacyAliases: [{ legacyCommand: 'wp e2e', replacementCommand: 'webpresso agent e2e' }],
+    },
+    {
+        id: 'agent tech-debt',
+        namespace: 'agent',
+        visibility: 'public',
+        replacementCommand: 'webpresso agent tech-debt',
+        legacyAliases: [
+            { legacyCommand: 'wp tech-debt', replacementCommand: 'webpresso agent tech-debt' },
+        ],
+    },
+];
+export function getLegacyAgentCommandReplacement(legacyCommand) {
+    const normalized = legacyCommand.trim().replace(/\s+/gu, ' ').toLowerCase();
+    for (const entry of AGENT_COMMAND_INVENTORY) {
+        for (const alias of entry.legacyAliases) {
+            if (alias.legacyCommand.toLowerCase() === normalized)
+                return alias.replacementCommand;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=agent-command-inventory.js.map

package/dist/esm/cli/bundle/index.d.ts

@@ -0,0 +1,17 @@
+import { type AgentCommandInventoryEntry } from '#cli/bundle/agent-command-inventory.js';
+export interface AgentBundleCommandDefinition {
+    readonly id: AgentCommandInventoryEntry['id'];
+    readonly namespace: AgentCommandInventoryEntry['namespace'];
+    readonly visibility: AgentCommandInventoryEntry['visibility'];
+    readonly replacementCommand: AgentCommandInventoryEntry['replacementCommand'];
+    readonly legacyAliases: AgentCommandInventoryEntry['legacyAliases'];
+}
+export interface AgentBundleDefinition {
+    readonly bundleId: 'agent-kit';
+    readonly commandRoot: 'agent';
+    readonly sourcePackage: '@webpresso/agent-kit';
+    readonly intendedHostPackage: '@repo/cli';
+    readonly commands: readonly AgentBundleCommandDefinition[];
+}
+export declare const AGENT_BUNDLE: AgentBundleDefinition;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/cli/bundle/index.js

@@ -0,0 +1,15 @@
+import { AGENT_COMMAND_INVENTORY, } from '#cli/bundle/agent-command-inventory.js';
+export const AGENT_BUNDLE = {
+    bundleId: 'agent-kit',
+    commandRoot: 'agent',
+    sourcePackage: '@webpresso/agent-kit',
+    intendedHostPackage: '@repo/cli',
+    commands: AGENT_COMMAND_INVENTORY.map((entry) => ({
+        id: entry.id,
+        namespace: entry.namespace,
+        visibility: entry.visibility,
+        replacementCommand: entry.replacementCommand,
+        legacyAliases: entry.legacyAliases,
+    })),
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/cli/cli.d.ts

@@ -5,7 +5,7 @@
  * Lazy-loads subcommand modules based on the first argv to keep startup
  * cheap. Modeled on apps/cli-wp/src/cli.ts.
  */
-declare const SUPPORTED_COMMANDS: readonly ["blueprint", "config", "roadmap", "sync", "audit", "compile", "rule", "skill", "skills", "docs", "setup", "init", "dev", "doctor", "err", "test", "e2e", "ci", "typecheck", "lint", "format", "tech-debt", "worktree", "mcp", "hooks", "gain", "bench"];
+declare const SUPPORTED_COMMANDS: readonly ["blueprint", "config", "roadmap", "sync", "audit", "compile", "rule", "skill", "skills", "docs", "setup", "init", "dev", "doctor", "err", "test", "e2e", "ci", "typecheck", "lint", "format", "tech-debt", "worktree", "mcp", "hook", "hooks", "gain", "bench", "install", "add", "remove", "update", "exec", "run"];
 export { SUPPORTED_COMMANDS };
 export declare function main(): Promise<number>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/esm/cli/cli.js

@@ -11,6 +11,7 @@ import { resolve as pathResolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { bootstrapAk } from './bootstrap.js';
 import { formatUnknownCommandError, normalizeArgv, readPackageVersion } from './utils.js';
+import { registerWpExtensions, resolveWpCommandAlias } from './wp-extensions.js';
 const VERSION = readPackageVersion(import.meta.url);
 const SUPPORTED_COMMANDS = [
     'blueprint',
@@ -37,9 +38,16 @@ const SUPPORTED_COMMANDS = [
     'tech-debt',
     'worktree',
     'mcp',
+    'hook',
     'hooks',
     'gain',
     'bench',
+    'install',
+    'add',
+    'remove',
+    'update',
+    'exec',
+    'run',
 ];
 const ROOT_HELP = [
     'Usage: wp [command] [options]',
@@ -52,6 +60,12 @@ const ROOT_HELP = [
     '  gain                  Show token savings from RTK — run after any AI session',
     '  sync                  Sync agent rules + skills across IDE surfaces (--kind, --check)',
     '  bench                 Run the session-memory benchmark harness',
+    '  install               Install dependencies through the managed vp facade',
+    '  add                   Add dependencies through the managed vp facade',
+    '  remove                Remove dependencies through the managed vp facade',
+    '  update                Update dependencies through the managed vp facade',
+    '  exec                  Run a binary through the managed vp facade',
+    '  run                   Run a package script through the managed vp facade',
     '',
     'Quality:',
     '  audit                 Run packaged audits (bundle budgets, repo guardrails, TPH, tech-debt)',
@@ -123,7 +137,17 @@ export async function main() {
         return 0;
     }
     await bootstrapAk(VERSION, argv);
-    switch (command) {
+    const extensionRuntime = await registerWpExtensions({
+        cli,
+        cwd: process.cwd(),
+        env: process.env,
+        hostVersion: VERSION,
+        baseCommands: [...SUPPORTED_COMMANDS],
+    });
+    for (const warning of extensionRuntime.warnings)
+        console.error(warning);
+    const resolvedCommand = resolveWpCommandAlias(command, extensionRuntime.aliasMap);
+    switch (resolvedCommand) {
         case 'blueprint': {
             const { registerBlueprintRouter } = await import('./commands/blueprint/router.js');
             registerBlueprintRouter(cli);
@@ -177,7 +201,7 @@ export async function main() {
         case 'setup':
         case 'init': {
             const { registerInitCommand } = await import('./commands/init/index.js');
-            registerInitCommand(cli, command);
+            registerInitCommand(cli, resolvedCommand);
             break;
         }
         case 'dev': {
@@ -235,6 +259,11 @@ export async function main() {
             registerMcpCommand(cli);
             break;
         }
+        case 'hook': {
+            const { registerHookCommand } = await import('./commands/hook.js');
+            registerHookCommand(cli);
+            break;
+        }
         case 'hooks': {
             const { registerHooksCommand } = await import('./commands/hooks.js');
             registerHooksCommand(cli);
@@ -250,20 +279,35 @@ export async function main() {
             registerBenchCommand(cli);
             break;
         }
+        case 'install':
+        case 'add':
+        case 'remove':
+        case 'update':
+        case 'exec':
+        case 'run': {
+            const { registerPackageManagerCommand } = await import('./commands/package-manager.js');
+            registerPackageManagerCommand(cli, resolvedCommand);
+            break;
+        }
         case 'worktree': {
             const { registerWorktreeRouter } = await import('./commands/worktree/router.js');
             registerWorktreeRouter(cli);
             break;
         }
         default: {
-            console.error(formatUnknownCommandError(command, SUPPORTED_COMMANDS));
-            return 1;
+            if (!resolvedCommand || !extensionRuntime.commandNames.includes(resolvedCommand)) {
+                console.error(formatUnknownCommandError(command, SUPPORTED_COMMANDS));
+                return 1;
+            }
         }
     }
     cli.help();
     cli.version(VERSION);
     try {
-        cli.parse(argv, { run: false });
+        const effectiveArgv = resolvedCommand && resolvedCommand !== command
+            ? [argv[0] ?? 'node', argv[1] ?? 'wp', resolvedCommand, ...argv.slice(3)]
+            : argv;
+        cli.parse(effectiveArgv, { run: false });
         const result = await cli.runMatchedCommand();
         return typeof result === 'number' ? result : 0;
     }

package/dist/esm/cli/commands/audit-core.d.ts

@@ -1,5 +1,5 @@
 import type { RepoAuditResult } from '#audit/repo-guardrails';
-export type AuditKind = 'tph' | 'tph-e2e' | 'bundle-budget' | 'commit-message' | 'blueprint-lifecycle' | 'roadmap-links' | 'docs-frontmatter' | 'catalog-drift' | 'package-surface' | 'agents' | 'tech-debt' | 'no-relative-parent-imports' | 'no-link-protocol' | 'vision' | 'bucket-boundary' | 'skill-sizes' | 'broken-refs' | 'memory-rotation' | 'gitignore-agent-surfaces' | 'memory-unified' | 'compile-drift' | 'architecture-drift' | 'absolute-path-policy' | 'agent-cost' | 'blueprint-db-consistency' | 'blueprint-lifecycle-sql' | 'tech-debt-cadence' | 'cross-repo-correlation' | 'ai-contracts' | 'mutation' | 'quality' | 'guardrails' | 'hook-surface' | 'no-relative-package-scripts';
+export type AuditKind = 'tph' | 'tph-e2e' | 'bundle-budget' | 'commit-message' | 'blueprint-lifecycle' | 'roadmap-links' | 'docs-frontmatter' | 'catalog-drift' | 'package-surface' | 'agents' | 'tech-debt' | 'no-relative-parent-imports' | 'no-link-protocol' | 'vision' | 'bucket-boundary' | 'skill-sizes' | 'broken-refs' | 'memory-rotation' | 'gitignore-agent-surfaces' | 'memory-unified' | 'compile-drift' | 'architecture-drift' | 'cloudflare-deploy-contract' | 'absolute-path-policy' | 'agent-cost' | 'blueprint-db-consistency' | 'blueprint-lifecycle-sql' | 'tech-debt-cadence' | 'cross-repo-correlation' | 'ai-contracts' | 'mutation' | 'quality' | 'guardrails' | 'hook-surface' | 'no-relative-package-scripts';
 export type AuditOutcome = {
     kind: 'invalid-usage';
     message: string;

package/dist/esm/cli/commands/audit.js

@@ -56,7 +56,9 @@ const REPO_AUDIT_REGISTRY = {
     'gitignore-agent-surfaces': async (root) => (await import('#audit/gitignore-agent-surfaces')).auditGitignoreAgentSurfaces(root),
     'memory-unified': async (root) => (await import('#audit/memory-unified')).auditMemoryUnified(root),
     'compile-drift': async (root) => (await import('#audit/compile-drift')).auditCompileDrift(root),
+    'no-legacy-cli-bin': async (root) => (await import('#audit/no-legacy-cli-bin')).auditNoLegacyCliBin(root),
     'architecture-drift': async (root) => (await import('#audit/architecture-drift')).auditArchitectureDrift(root),
+    'cloudflare-deploy-contract': async (root) => (await import('#audit/cloudflare-deploy-contract')).auditCloudflareDeployContract(root),
     'absolute-path-policy': async (root) => (await import('#audit/absolute-path-policy')).auditAbsolutePathPolicy(root),
     'agent-cost': async (root) => (await import('#audit/agent-cost')).auditAgentCost(root),
     'blueprint-db-consistency': async (root) => (await import('#audit/blueprint-db-consistency')).auditBlueprintDbConsistency(root),