workspai 0.44.0 → 0.46.0

package/dist/index.d.ts

@@ -1,9 +1,23 @@
 #!/usr/bin/env node
+import { Command } from 'commander';
+
 declare const PROJECT_COMMANDS_CORE_FALLBACK: readonly ["lint", "format", "docs"];
 
 declare const COMMAND_CAPABILITIES_SCHEMA_VERSION: "rapidkit-command-capabilities-v1";
 declare const VERSION_CONTRACT_SCHEMA_VERSION: "rapidkit-version-v1";
 
+declare const NPM_ONLY_MANUAL_HANDLER_COMMANDS: readonly ["bootstrap", "setup", "cache", "mirror"];
+
+interface AdoptProjectFilePreimage {
+    path: string;
+    contents: Buffer | null;
+}
+interface AdoptProjectRollbackSnapshot {
+    workspacePath: string;
+    projectPath: string;
+    files: AdoptProjectFilePreimage[];
+}
+
 declare function getPublishedContractVersions(): {
     autopilotRelease: "autopilot-release-v1";
     workspaceList: "rapidkit-workspace-list-v1";
@@ -22,6 +36,7 @@ declare function getPublishedContractVersions(): {
     doctorProjectScan: "doctor-project-scan-v2";
     doctorWorkspaceCache: "doctor-workspace-cache-v2";
     runtimeCommandSurface: string;
+    cliRuntimeCommandInventory: "workspai-cli-runtime-command-inventory-v1";
     cliOperationResult: "workspai-cli-operation-result-v1";
     publishedContractCatalog: "workspai-published-contract-catalog-v1";
     workspaceArchiveCapabilities: "workspai-workspace-archive-capabilities-v1";
@@ -47,6 +62,7 @@ declare function getPublishedContractVersions(): {
         readonly skillsIndex: "workspace-skills-index.v1";
         readonly agents: null;
         readonly explain: "workspace-explain.v1";
+        readonly intelligenceRun: "workspace-intelligence-run.v1";
     };
     cliLogEvent: "cli-log-event-v1";
     freshnessMetadata: "rapidkit-freshness-metadata-v1";
@@ -73,9 +89,9 @@ declare function getPublishedContractCatalog(): {
     [k: string]: {
         artifacts?: {
             [k: string]: {
-                path: ".workspai/reports/workspace-model.json" | ".workspai/reports/workspace-model-snapshot.json" | ".workspai/reports/workspace-model-diff-last-run.json" | ".workspai/reports/workspace-impact-last-run.json" | ".workspai/reports/analyze-last-run.json" | ".workspai/reports/doctor-last-run.json" | ".workspai/reports/workspace-contract-verify-last-run.json" | ".workspai/reports/release-readiness-last-run.json" | ".workspai/reports/workspace-verify-last-run.json" | ".workspai/reports/workspace-intelligence-history.json" | ".workspai/reports/workspace-context-agent.json" | ".workspai/reports/INDEX.json" | ".workspai/reports/agent-customization-pack.json" | ".workspai/reports/workspace-skills-index.json" | "AGENTS.md" | ".workspai/reports/workspace-explain-last-run.json";
-                schemaVersion: "workspace-model.v1" | "workspace-model-snapshot.v1" | "workspace-model-diff.v1" | "workspace-impact.v1" | "rapidkit-analyze-v1" | "doctor-workspace-evidence-v1" | "workspace-contract-verify.v1" | "release-readiness-v1" | "workspace-verify.v1" | "workspace-intelligence-history.v1" | "workspace-context.v1" | "rapidkit-agent-reports-index.v1" | "rapidkit-agent-customization-pack.v1" | "workspace-skills-index.v1" | "workspace-explain.v1" | null;
-                contractPath: "contracts/workspace-intelligence/workspace-model.v1.json" | "contracts/workspace-intelligence/workspace-model-snapshot.v1.json" | "contracts/workspace-intelligence/workspace-model-diff.v1.json" | "contracts/workspace-intelligence/workspace-impact.v1.json" | "contracts/analyze-last-run.v1.json" | "contracts/doctor-workspace-evidence.v1.json" | "contracts/workspace-intelligence/workspace-contract-verify.v1.json" | "contracts/release-readiness.v1.json" | "contracts/workspace-intelligence/workspace-verify.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-history.v1.json" | "contracts/workspace-intelligence/workspace-context.v1.json" | "contracts/workspace-intelligence/agent-reports-index.v1.json" | "contracts/workspace-intelligence/agent-customization-pack-report.v1.json" | "contracts/workspace-intelligence/workspace-skills-index.v1.json" | "contracts/workspace-intelligence/workspace-explain.v1.json" | null;
+                path: ".workspai/reports/workspace-model.json" | ".workspai/reports/workspace-model-snapshot.json" | ".workspai/reports/workspace-model-diff-last-run.json" | ".workspai/reports/workspace-impact-last-run.json" | ".workspai/reports/analyze-last-run.json" | ".workspai/reports/doctor-last-run.json" | ".workspai/reports/workspace-contract-verify-last-run.json" | ".workspai/reports/release-readiness-last-run.json" | ".workspai/reports/workspace-verify-last-run.json" | ".workspai/reports/workspace-intelligence-history.json" | ".workspai/reports/workspace-context-agent.json" | ".workspai/reports/INDEX.json" | ".workspai/reports/agent-customization-pack.json" | ".workspai/reports/workspace-skills-index.json" | "AGENTS.md" | ".workspai/reports/workspace-explain-last-run.json" | ".workspai/reports/workspace-intelligence-run-last-run.json";
+                schemaVersion: "workspace-model.v1" | "workspace-model-snapshot.v1" | "workspace-model-diff.v1" | "workspace-impact.v1" | "rapidkit-analyze-v1" | "doctor-workspace-evidence-v1" | "workspace-contract-verify.v1" | "release-readiness-v1" | "workspace-verify.v1" | "workspace-intelligence-history.v1" | "workspace-context.v1" | "rapidkit-agent-reports-index.v1" | "rapidkit-agent-customization-pack.v1" | "workspace-skills-index.v1" | "workspace-explain.v1" | "workspace-intelligence-run.v1" | null;
+                contractPath: "contracts/workspace-intelligence/workspace-model.v1.json" | "contracts/workspace-intelligence/workspace-model-snapshot.v1.json" | "contracts/workspace-intelligence/workspace-model-diff.v1.json" | "contracts/workspace-intelligence/workspace-impact.v1.json" | "contracts/analyze-last-run.v1.json" | "contracts/doctor-workspace-evidence.v1.json" | "contracts/workspace-intelligence/workspace-contract-verify.v1.json" | "contracts/release-readiness.v1.json" | "contracts/workspace-intelligence/workspace-verify.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-history.v1.json" | "contracts/workspace-intelligence/workspace-context.v1.json" | "contracts/workspace-intelligence/agent-reports-index.v1.json" | "contracts/workspace-intelligence/agent-customization-pack-report.v1.json" | "contracts/workspace-intelligence/workspace-skills-index.v1.json" | "contracts/workspace-intelligence/workspace-explain.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-run.v1.json" | null;
             };
         } | undefined;
         schemaVersion: string | {
@@ -95,16 +111,45 @@ declare function getPublishedContractCatalog(): {
             readonly skillsIndex: "workspace-skills-index.v1";
             readonly agents: null;
             readonly explain: "workspace-explain.v1";
+            readonly intelligenceRun: "workspace-intelligence-run.v1";
         };
         contractPath: string | null;
         publication: "capability-contract" | "json-schema" | "embedded-type";
     };
 };
 
+declare const NPM_ONLY_SCOPED_COMMANDS: readonly (readonly string[])[];
+declare const NPM_ONLY_TOP_LEVEL_COMMANDS: readonly string[];
+
+type BridgeFailureCode = 'PYTHON_NOT_FOUND' | 'BRIDGE_VENV_BOOTSTRAP_FAILED' | 'BRIDGE_VENV_CREATE_FAILED' | 'BRIDGE_PIP_BOOTSTRAP_FAILED';
+declare function bridgeFailureCode(err: unknown): BridgeFailureCode | null;
+declare function resolveInvokedCliName(argv?: string[]): 'workspai' | 'rapidkit';
+declare function normalizeFallbackTemplate(kit: string): 'fastapi' | 'nestjs' | null;
+declare function readFlagValue(argv: string[], flag: string): string | undefined;
+declare function parseMaxWorkersOption(raw: string | undefined): number | undefined;
+declare function hostPythonCandidates(): string[];
+declare function buildDelegationEnvForInit(): NodeJS.ProcessEnv;
+declare function commandAvailable(command: string, cwd: string): Promise<boolean>;
+type InferredRuntime = 'python' | 'node' | 'go' | 'java' | 'dotnet' | null;
+declare function inferRuntimeByFiles(targetPath: string): Promise<InferredRuntime>;
+interface PythonProjectOrchestrationDependencies {
+    runCommand?: typeof runCommandInCwd;
+    pythonCandidates?: readonly string[];
+}
+declare function createWorkspaceVenv(workspacePath: string, dependencies?: PythonProjectOrchestrationDependencies): Promise<number>;
+declare function createProjectVenv(projectPath: string, dependencies?: PythonProjectOrchestrationDependencies): Promise<number>;
+declare function ensurePythonProjectUsesLocalVenv(projectPath: string, dependencies?: PythonProjectOrchestrationDependencies): Promise<number>;
+declare function installPythonDependenciesWithPipFallback(projectPath: string, dependencies?: PythonProjectOrchestrationDependencies): Promise<number>;
+declare function validateNpmKitFlags(kitId: string, args: readonly string[]): string | null;
+declare function runCreateFallback(args: string[], reasonCode: BridgeFailureCode): Promise<number>;
 declare function handleCreateOrFallback(args: string[]): Promise<number>;
-declare const NPM_ONLY_TOP_LEVEL_COMMANDS: readonly ["analyze", "readiness", "doctor", "workspace", "autopilot", "pipeline", "import", "adopt", "snapshot", "bootstrap", "setup", "cache", "mirror", "ai", "config", "product", "infra", "shell", "commands"];
-declare const NPM_ONLY_SCOPED_COMMANDS: readonly [readonly ["project", "commands"], readonly ["project", "archives"], readonly ["project", "archive"], readonly ["project", "restore"], readonly ["project", "delete"]];
 declare const WRAPPER_ORCHESTRATED_PROJECT_COMMANDS: readonly ["init"];
+declare function isNpmOnlyTopLevelCommand(command: string | undefined): boolean;
+declare function isNpmOnlyScopedCommand(args: readonly string[]): boolean;
+declare function isNpmOnlyInvocation(args: readonly string[]): boolean;
+declare function isNpmOnlyParseDirectCommand(command: string | undefined): boolean;
+declare function isNpmOnlyParseDirectInvocation(args: readonly string[]): boolean;
+declare function isNpmOnlyManualHandlerCommand(command: string | undefined): command is (typeof NPM_ONLY_MANUAL_HANDLER_COMMANDS)[number];
 declare function isNpmExecInvocation(env?: NodeJS.ProcessEnv): boolean;
 
 declare function getVersionContract(): {
@@ -132,6 +177,7 @@ declare function getVersionContract(): {
         doctorProjectScan: "doctor-project-scan-v2";
         doctorWorkspaceCache: "doctor-workspace-cache-v2";
         runtimeCommandSurface: string;
+        cliRuntimeCommandInventory: "workspai-cli-runtime-command-inventory-v1";
         cliOperationResult: "workspai-cli-operation-result-v1";
         publishedContractCatalog: "workspai-published-contract-catalog-v1";
         workspaceArchiveCapabilities: "workspai-workspace-archive-capabilities-v1";
@@ -157,6 +203,7 @@ declare function getVersionContract(): {
             readonly skillsIndex: "workspace-skills-index.v1";
             readonly agents: null;
             readonly explain: "workspace-explain.v1";
+            readonly intelligenceRun: "workspace-intelligence-run.v1";
         };
         cliLogEvent: "cli-log-event-v1";
         freshnessMetadata: "rapidkit-freshness-metadata-v1";
@@ -183,9 +230,9 @@ declare function getVersionContract(): {
         [k: string]: {
             artifacts?: {
                 [k: string]: {
-                    path: ".workspai/reports/workspace-model.json" | ".workspai/reports/workspace-model-snapshot.json" | ".workspai/reports/workspace-model-diff-last-run.json" | ".workspai/reports/workspace-impact-last-run.json" | ".workspai/reports/analyze-last-run.json" | ".workspai/reports/doctor-last-run.json" | ".workspai/reports/workspace-contract-verify-last-run.json" | ".workspai/reports/release-readiness-last-run.json" | ".workspai/reports/workspace-verify-last-run.json" | ".workspai/reports/workspace-intelligence-history.json" | ".workspai/reports/workspace-context-agent.json" | ".workspai/reports/INDEX.json" | ".workspai/reports/agent-customization-pack.json" | ".workspai/reports/workspace-skills-index.json" | "AGENTS.md" | ".workspai/reports/workspace-explain-last-run.json";
-                    schemaVersion: "workspace-model.v1" | "workspace-model-snapshot.v1" | "workspace-model-diff.v1" | "workspace-impact.v1" | "rapidkit-analyze-v1" | "doctor-workspace-evidence-v1" | "workspace-contract-verify.v1" | "release-readiness-v1" | "workspace-verify.v1" | "workspace-intelligence-history.v1" | "workspace-context.v1" | "rapidkit-agent-reports-index.v1" | "rapidkit-agent-customization-pack.v1" | "workspace-skills-index.v1" | "workspace-explain.v1" | null;
-                    contractPath: "contracts/workspace-intelligence/workspace-model.v1.json" | "contracts/workspace-intelligence/workspace-model-snapshot.v1.json" | "contracts/workspace-intelligence/workspace-model-diff.v1.json" | "contracts/workspace-intelligence/workspace-impact.v1.json" | "contracts/analyze-last-run.v1.json" | "contracts/doctor-workspace-evidence.v1.json" | "contracts/workspace-intelligence/workspace-contract-verify.v1.json" | "contracts/release-readiness.v1.json" | "contracts/workspace-intelligence/workspace-verify.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-history.v1.json" | "contracts/workspace-intelligence/workspace-context.v1.json" | "contracts/workspace-intelligence/agent-reports-index.v1.json" | "contracts/workspace-intelligence/agent-customization-pack-report.v1.json" | "contracts/workspace-intelligence/workspace-skills-index.v1.json" | "contracts/workspace-intelligence/workspace-explain.v1.json" | null;
+                    path: ".workspai/reports/workspace-model.json" | ".workspai/reports/workspace-model-snapshot.json" | ".workspai/reports/workspace-model-diff-last-run.json" | ".workspai/reports/workspace-impact-last-run.json" | ".workspai/reports/analyze-last-run.json" | ".workspai/reports/doctor-last-run.json" | ".workspai/reports/workspace-contract-verify-last-run.json" | ".workspai/reports/release-readiness-last-run.json" | ".workspai/reports/workspace-verify-last-run.json" | ".workspai/reports/workspace-intelligence-history.json" | ".workspai/reports/workspace-context-agent.json" | ".workspai/reports/INDEX.json" | ".workspai/reports/agent-customization-pack.json" | ".workspai/reports/workspace-skills-index.json" | "AGENTS.md" | ".workspai/reports/workspace-explain-last-run.json" | ".workspai/reports/workspace-intelligence-run-last-run.json";
+                    schemaVersion: "workspace-model.v1" | "workspace-model-snapshot.v1" | "workspace-model-diff.v1" | "workspace-impact.v1" | "rapidkit-analyze-v1" | "doctor-workspace-evidence-v1" | "workspace-contract-verify.v1" | "release-readiness-v1" | "workspace-verify.v1" | "workspace-intelligence-history.v1" | "workspace-context.v1" | "rapidkit-agent-reports-index.v1" | "rapidkit-agent-customization-pack.v1" | "workspace-skills-index.v1" | "workspace-explain.v1" | "workspace-intelligence-run.v1" | null;
+                    contractPath: "contracts/workspace-intelligence/workspace-model.v1.json" | "contracts/workspace-intelligence/workspace-model-snapshot.v1.json" | "contracts/workspace-intelligence/workspace-model-diff.v1.json" | "contracts/workspace-intelligence/workspace-impact.v1.json" | "contracts/analyze-last-run.v1.json" | "contracts/doctor-workspace-evidence.v1.json" | "contracts/workspace-intelligence/workspace-contract-verify.v1.json" | "contracts/release-readiness.v1.json" | "contracts/workspace-intelligence/workspace-verify.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-history.v1.json" | "contracts/workspace-intelligence/workspace-context.v1.json" | "contracts/workspace-intelligence/agent-reports-index.v1.json" | "contracts/workspace-intelligence/agent-customization-pack-report.v1.json" | "contracts/workspace-intelligence/workspace-skills-index.v1.json" | "contracts/workspace-intelligence/workspace-explain.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-run.v1.json" | null;
                 };
             } | undefined;
             schemaVersion: string | {
@@ -205,12 +252,42 @@ declare function getVersionContract(): {
                 readonly skillsIndex: "workspace-skills-index.v1";
                 readonly agents: null;
                 readonly explain: "workspace-explain.v1";
+                readonly intelligenceRun: "workspace-intelligence-run.v1";
             };
             contractPath: string | null;
             publication: "capability-contract" | "json-schema" | "embedded-type";
         };
     };
 };
+type RuntimeCommandInventoryPayload = {
+    schemaVersion: string;
+    commands: Array<{
+        path: string[];
+        command: string;
+        parent: string | null;
+        registrationKind: 'commander' | 'manual-handler';
+        aliases: string[];
+        description: string;
+        hidden: boolean;
+        arguments: Array<{
+            name: string;
+            required: boolean;
+            variadic: boolean;
+        }>;
+        options: Array<{
+            flags: string;
+            attributeName: string | null;
+        }>;
+    }>;
+    topLevelCommands: string[];
+    integrity: {
+        ok: boolean;
+        registeredButUndeclared: string[];
+        declaredButUnregistered: string[];
+        registeredScopedButUndeclared: string[];
+        declaredScopedButUnregistered: string[];
+    };
+};
 declare function getGlobalCommandCapabilities(): {
     schemaVersion: "rapidkit-command-capabilities-v1";
     scope: string;
@@ -235,6 +312,7 @@ declare function getGlobalCommandCapabilities(): {
         doctorProjectScan: "doctor-project-scan-v2";
         doctorWorkspaceCache: "doctor-workspace-cache-v2";
         runtimeCommandSurface: string;
+        cliRuntimeCommandInventory: "workspai-cli-runtime-command-inventory-v1";
         cliOperationResult: "workspai-cli-operation-result-v1";
         publishedContractCatalog: "workspai-published-contract-catalog-v1";
         workspaceArchiveCapabilities: "workspai-workspace-archive-capabilities-v1";
@@ -260,6 +338,7 @@ declare function getGlobalCommandCapabilities(): {
             readonly skillsIndex: "workspace-skills-index.v1";
             readonly agents: null;
             readonly explain: "workspace-explain.v1";
+            readonly intelligenceRun: "workspace-intelligence-run.v1";
         };
         cliLogEvent: "cli-log-event-v1";
         freshnessMetadata: "rapidkit-freshness-metadata-v1";
@@ -286,9 +365,9 @@ declare function getGlobalCommandCapabilities(): {
         [k: string]: {
             artifacts?: {
                 [k: string]: {
-                    path: ".workspai/reports/workspace-model.json" | ".workspai/reports/workspace-model-snapshot.json" | ".workspai/reports/workspace-model-diff-last-run.json" | ".workspai/reports/workspace-impact-last-run.json" | ".workspai/reports/analyze-last-run.json" | ".workspai/reports/doctor-last-run.json" | ".workspai/reports/workspace-contract-verify-last-run.json" | ".workspai/reports/release-readiness-last-run.json" | ".workspai/reports/workspace-verify-last-run.json" | ".workspai/reports/workspace-intelligence-history.json" | ".workspai/reports/workspace-context-agent.json" | ".workspai/reports/INDEX.json" | ".workspai/reports/agent-customization-pack.json" | ".workspai/reports/workspace-skills-index.json" | "AGENTS.md" | ".workspai/reports/workspace-explain-last-run.json";
-                    schemaVersion: "workspace-model.v1" | "workspace-model-snapshot.v1" | "workspace-model-diff.v1" | "workspace-impact.v1" | "rapidkit-analyze-v1" | "doctor-workspace-evidence-v1" | "workspace-contract-verify.v1" | "release-readiness-v1" | "workspace-verify.v1" | "workspace-intelligence-history.v1" | "workspace-context.v1" | "rapidkit-agent-reports-index.v1" | "rapidkit-agent-customization-pack.v1" | "workspace-skills-index.v1" | "workspace-explain.v1" | null;
-                    contractPath: "contracts/workspace-intelligence/workspace-model.v1.json" | "contracts/workspace-intelligence/workspace-model-snapshot.v1.json" | "contracts/workspace-intelligence/workspace-model-diff.v1.json" | "contracts/workspace-intelligence/workspace-impact.v1.json" | "contracts/analyze-last-run.v1.json" | "contracts/doctor-workspace-evidence.v1.json" | "contracts/workspace-intelligence/workspace-contract-verify.v1.json" | "contracts/release-readiness.v1.json" | "contracts/workspace-intelligence/workspace-verify.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-history.v1.json" | "contracts/workspace-intelligence/workspace-context.v1.json" | "contracts/workspace-intelligence/agent-reports-index.v1.json" | "contracts/workspace-intelligence/agent-customization-pack-report.v1.json" | "contracts/workspace-intelligence/workspace-skills-index.v1.json" | "contracts/workspace-intelligence/workspace-explain.v1.json" | null;
+                    path: ".workspai/reports/workspace-model.json" | ".workspai/reports/workspace-model-snapshot.json" | ".workspai/reports/workspace-model-diff-last-run.json" | ".workspai/reports/workspace-impact-last-run.json" | ".workspai/reports/analyze-last-run.json" | ".workspai/reports/doctor-last-run.json" | ".workspai/reports/workspace-contract-verify-last-run.json" | ".workspai/reports/release-readiness-last-run.json" | ".workspai/reports/workspace-verify-last-run.json" | ".workspai/reports/workspace-intelligence-history.json" | ".workspai/reports/workspace-context-agent.json" | ".workspai/reports/INDEX.json" | ".workspai/reports/agent-customization-pack.json" | ".workspai/reports/workspace-skills-index.json" | "AGENTS.md" | ".workspai/reports/workspace-explain-last-run.json" | ".workspai/reports/workspace-intelligence-run-last-run.json";
+                    schemaVersion: "workspace-model.v1" | "workspace-model-snapshot.v1" | "workspace-model-diff.v1" | "workspace-impact.v1" | "rapidkit-analyze-v1" | "doctor-workspace-evidence-v1" | "workspace-contract-verify.v1" | "release-readiness-v1" | "workspace-verify.v1" | "workspace-intelligence-history.v1" | "workspace-context.v1" | "rapidkit-agent-reports-index.v1" | "rapidkit-agent-customization-pack.v1" | "workspace-skills-index.v1" | "workspace-explain.v1" | "workspace-intelligence-run.v1" | null;
+                    contractPath: "contracts/workspace-intelligence/workspace-model.v1.json" | "contracts/workspace-intelligence/workspace-model-snapshot.v1.json" | "contracts/workspace-intelligence/workspace-model-diff.v1.json" | "contracts/workspace-intelligence/workspace-impact.v1.json" | "contracts/analyze-last-run.v1.json" | "contracts/doctor-workspace-evidence.v1.json" | "contracts/workspace-intelligence/workspace-contract-verify.v1.json" | "contracts/release-readiness.v1.json" | "contracts/workspace-intelligence/workspace-verify.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-history.v1.json" | "contracts/workspace-intelligence/workspace-context.v1.json" | "contracts/workspace-intelligence/agent-reports-index.v1.json" | "contracts/workspace-intelligence/agent-customization-pack-report.v1.json" | "contracts/workspace-intelligence/workspace-skills-index.v1.json" | "contracts/workspace-intelligence/workspace-explain.v1.json" | "contracts/workspace-intelligence/workspace-intelligence-run.v1.json" | null;
                 };
             } | undefined;
             schemaVersion: string | {
@@ -308,6 +387,7 @@ declare function getGlobalCommandCapabilities(): {
                 readonly skillsIndex: "workspace-skills-index.v1";
                 readonly agents: null;
                 readonly explain: "workspace-explain.v1";
+                readonly intelligenceRun: "workspace-intelligence-run.v1";
             };
             contractPath: string | null;
             publication: "capability-contract" | "json-schema" | "embedded-type";
@@ -320,11 +400,16 @@ declare function getGlobalCommandCapabilities(): {
     };
     workspace: {
         command: string;
-        subcommands: ("init" | "import" | "snapshot" | "archive" | "model" | "diff" | "impact" | "verify" | "explain" | "list" | "sync" | "registry" | "foundation" | "graph" | "watch" | "context" | "agent-sync" | "remediation-plan" | "why" | "trace" | "feedback" | "mcp" | "policy" | "contract" | "share" | "export" | "hydrate" | "run")[];
-        intelligenceSubcommands: ("snapshot" | "model" | "diff" | "impact" | "verify" | "explain" | "context" | "agent-sync" | "remediation-plan" | "why" | "trace")[];
+        subcommands: ("archive" | "snapshot" | "list" | "import" | "init" | "model" | "diff" | "impact" | "verify" | "explain" | "sync" | "registry" | "foundation" | "intelligence" | "graph" | "watch" | "context" | "agent-sync" | "remediation-plan" | "why" | "trace" | "feedback" | "mcp" | "policy" | "contract" | "share" | "export" | "hydrate" | "run")[];
+        intelligenceSubcommands: ("snapshot" | "model" | "diff" | "impact" | "verify" | "explain" | "intelligence" | "graph" | "watch" | "context" | "agent-sync" | "remediation-plan" | "why" | "trace" | "feedback" | "mcp" | "contract")[];
     };
     commandMap: any;
+    runtimeInventory: RuntimeCommandInventoryPayload;
 };
+declare function hasWorkspaceRootMarkers(targetDir: string): boolean;
+declare function findContextFileUp(start: string): string | null;
+declare function findWorkspaceMarkerUp(start: string): string | null;
+declare function findWorkspaceUp(start: string): string | null;
 interface DoctorWorkspaceShadowDiagnostic {
     detected: boolean;
     candidatePath?: string;
@@ -334,6 +419,16 @@ declare function detectWindowsDoctorWorkspaceShadow(params: {
     scope?: string;
     workspaceFlag?: boolean | string;
 }, cwd?: string, platform?: NodeJS.Platform): Promise<DoctorWorkspaceShadowDiagnostic>;
+declare function findLegacyWorkspaceUp(start: string): string | null;
+type WorkspacePolicyRuleKey = 'enforce_workspace_marker' | 'enforce_toolchain_lock' | 'disallow_untrusted_tool_sources' | 'enforce_compatibility_matrix' | 'require_mirror_lock_for_offline';
+declare function replaceOrInsertTopLevelPolicyLine(content: string, key: string, value: string): string;
+declare function replaceOrInsertRulePolicyLine(content: string, key: WorkspacePolicyRuleKey, value: boolean): string;
+declare function defaultWorkspacePolicyYaml(): string;
+declare function parsePolicyBooleanLiteral(value: string): boolean | null;
+declare function runCommandInCwd(command: string, commandArgs: string[], cwd: string, options?: {
+    timeoutMs?: number;
+}): Promise<number>;
+declare function parseNodeEvalScript(script: string): string | null;
 declare function handleImportCommand(source: string, options: {
     workspace?: string;
     name?: string;
@@ -354,14 +449,27 @@ declare function handleAdoptCommand(source: string | undefined, options: {
     syncWorkspaceProjects?: (workspacePath: string) => Promise<void>;
     registerWorkspace?: (workspacePath: string, workspaceName: string) => Promise<void>;
     registerProjectInWorkspace?: (workspacePath: string, projectName: string, projectPath: string) => Promise<void>;
-    rollbackAdoptedProjectImport?: (workspacePath: string, projectPath: string, previousProjectJson: Record<string, unknown> | null) => Promise<void>;
+    rollbackAdoptedProjectImport?: (workspacePath: string, projectPath: string, snapshot: AdoptProjectRollbackSnapshot) => Promise<void>;
 }): Promise<number>;
 declare function installWorkspaceDependencies(workspacePath: string): Promise<number>;
+declare function handleGoInit(projectPath: string): Promise<number>;
+declare function handleNodeCommand(action: 'init' | 'dev' | 'test' | 'build' | 'start' | 'lint' | 'format', projectPath: string): Promise<number>;
+declare function handleJavaCommand(action: 'init' | 'dev' | 'test' | 'build' | 'start' | 'lint' | 'format', projectPath: string): Promise<number>;
 declare function handleBootstrapCommand(args: string[], initRunner?: (nextArgs: string[]) => Promise<number>): Promise<number>;
 declare function handleSetupCommand(args: string[]): Promise<number>;
+declare function parseCacheConfig(content: string): {
+    strategy: string;
+    prune_on_bootstrap: boolean;
+    self_heal: boolean;
+    verify_integrity: boolean;
+};
 declare function handleCacheCommand(args: string[]): Promise<number>;
 declare function handleMirrorCommand(args: string[]): Promise<number>;
 declare function handleInitCommand(args: string[]): Promise<number>;
+declare function checkStrictPolicyPreflightForDelegation(cwd: string): Promise<string[]>;
+declare const program: Command;
 declare function shouldForwardToCore(args: string[]): Promise<boolean>;
+declare function printHelp(): void;
+declare function bootstrapCli(): Promise<void>;
 
-export { COMMAND_CAPABILITIES_SCHEMA_VERSION, type DoctorWorkspaceShadowDiagnostic, NPM_ONLY_SCOPED_COMMANDS, NPM_ONLY_TOP_LEVEL_COMMANDS, PROJECT_COMMANDS_CORE_FALLBACK, VERSION_CONTRACT_SCHEMA_VERSION, WRAPPER_ORCHESTRATED_PROJECT_COMMANDS, detectWindowsDoctorWorkspaceShadow, getGlobalCommandCapabilities, getPublishedContractCatalog, getPublishedContractVersions, getVersionContract, handleAdoptCommand, handleBootstrapCommand, handleCacheCommand, handleCreateOrFallback, handleImportCommand, handleInitCommand, handleMirrorCommand, handleSetupCommand, installWorkspaceDependencies, isNpmExecInvocation, shouldForwardToCore };
+export { type BridgeFailureCode, COMMAND_CAPABILITIES_SCHEMA_VERSION, type DoctorWorkspaceShadowDiagnostic, NPM_ONLY_SCOPED_COMMANDS, NPM_ONLY_TOP_LEVEL_COMMANDS, PROJECT_COMMANDS_CORE_FALLBACK, type PythonProjectOrchestrationDependencies, VERSION_CONTRACT_SCHEMA_VERSION, WRAPPER_ORCHESTRATED_PROJECT_COMMANDS, bootstrapCli, bridgeFailureCode, buildDelegationEnvForInit, checkStrictPolicyPreflightForDelegation, commandAvailable, createProjectVenv, createWorkspaceVenv, defaultWorkspacePolicyYaml, detectWindowsDoctorWorkspaceShadow, ensurePythonProjectUsesLocalVenv, findContextFileUp, findLegacyWorkspaceUp, findWorkspaceMarkerUp, findWorkspaceUp, getGlobalCommandCapabilities, getPublishedContractCatalog, getPublishedContractVersions, getVersionContract, handleAdoptCommand, handleBootstrapCommand, handleCacheCommand, handleCreateOrFallback, handleGoInit, handleImportCommand, handleInitCommand, handleJavaCommand, handleMirrorCommand, handleNodeCommand, handleSetupCommand, hasWorkspaceRootMarkers, hostPythonCandidates, inferRuntimeByFiles, installPythonDependenciesWithPipFallback, installWorkspaceDependencies, isNpmExecInvocation, isNpmOnlyInvocation, isNpmOnlyManualHandlerCommand, isNpmOnlyParseDirectCommand, isNpmOnlyParseDirectInvocation, isNpmOnlyScopedCommand, isNpmOnlyTopLevelCommand, normalizeFallbackTemplate, parseCacheConfig, parseMaxWorkersOption, parseNodeEvalScript, parsePolicyBooleanLiteral, printHelp, program, readFlagValue, replaceOrInsertRulePolicyLine, replaceOrInsertTopLevelPolicyLine, resolveInvokedCliName, runCommandInCwd, runCreateFallback, shouldForwardToCore, validateNpmKitFlags };