workspai 0.45.0 → 0.46.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (135) hide show
  1. package/README.md +242 -516
  2. package/contracts/cli-runtime-command-inventory.v1.snapshot.json +4 -0
  3. package/contracts/extension-cli-compatibility.v1.json +3 -2
  4. package/contracts/published-contract-catalog.v1.json +7 -1
  5. package/contracts/runtime-command-surface.v1.json +41 -6
  6. package/contracts/workspace-archive-capabilities.v1.json +17 -6
  7. package/contracts/workspace-intelligence/studio-blocker-handoff.v1.json +4 -0
  8. package/contracts/workspace-intelligence/workspace-intelligence-run.v1.json +207 -0
  9. package/contracts/workspace-intelligence-architecture.v1.json +1 -1
  10. package/contracts/workspace-intelligence-chain.v1.json +37 -1
  11. package/dist/analyze-BEBEZSZK.js +1 -0
  12. package/dist/{artifact-remediation-plan-WLZGROUU.js → artifact-remediation-plan-FFQSESAM.js} +1 -1
  13. package/dist/autopilot-release-WUR4CQIT.js +1 -0
  14. package/dist/chunk-2G7FASAO.js +2 -0
  15. package/dist/{chunk-5GNT4RJI.js → chunk-4EPHWD27.js} +1 -1
  16. package/dist/{chunk-J4AICQFB.js → chunk-4LGXSBCN.js} +1 -1
  17. package/dist/chunk-52PBRX7F.js +1 -0
  18. package/dist/{chunk-2QOWRBQD.js → chunk-6IIZJQLV.js} +1 -1
  19. package/dist/{chunk-HYJK7W3B.js → chunk-CVHMUSRX.js} +1 -1
  20. package/dist/{chunk-7UZVOYF5.js → chunk-DIPD72H4.js} +1 -1
  21. package/dist/chunk-EFYHGCGX.js +2 -0
  22. package/dist/chunk-EYJ2CQSK.js +1 -0
  23. package/dist/chunk-FPJNWPKU.js +1 -0
  24. package/dist/{chunk-JP25YL3J.js → chunk-FTY7GGXJ.js} +2 -2
  25. package/dist/chunk-FWRXA435.js +2 -0
  26. package/dist/chunk-FXQJX34Z.js +1 -0
  27. package/dist/chunk-HDURFXW5.js +2 -0
  28. package/dist/chunk-HMUKBW2S.js +4 -0
  29. package/dist/{chunk-DXPU4DDV.js → chunk-J5PIZCAU.js} +92 -78
  30. package/dist/{chunk-6ZENXBMG.js → chunk-K4WNYXKK.js} +7 -7
  31. package/dist/chunk-MER6ZBN2.js +13 -0
  32. package/dist/chunk-N7DV5L7C.js +1 -0
  33. package/dist/{chunk-P424XYHP.js → chunk-PRBVYW3T.js} +1 -1
  34. package/dist/{chunk-WANW4QA4.js → chunk-QA5BGEQW.js} +1 -1
  35. package/dist/chunk-QZLIURER.js +13 -0
  36. package/dist/{chunk-P7SCWJFG.js → chunk-RIEF2DDX.js} +1 -1
  37. package/dist/{chunk-V2H2KRMZ.js → chunk-SXMTSV5M.js} +1 -1
  38. package/dist/chunk-SXPY523X.js +1 -0
  39. package/dist/{chunk-XIVFLY6G.js → chunk-UQWOVV6V.js} +1 -1
  40. package/dist/chunk-V3LRQZ36.js +1 -0
  41. package/dist/chunk-VFDM65IE.js +80 -0
  42. package/dist/{chunk-KU4S7RCM.js → chunk-WPEEC5BX.js} +1 -1
  43. package/dist/chunk-WYFPXTTS.js +2 -0
  44. package/dist/{chunk-K63BSU56.js → chunk-YUATNVOT.js} +62 -51
  45. package/dist/{chunk-OOOPYUL2.js → chunk-ZKAI3PJE.js} +1 -1
  46. package/dist/{create-KFR6FLRT.js → create-WCV3L6XH.js} +1 -1
  47. package/dist/doctor-5BWM2EMJ.js +1 -0
  48. package/dist/{dotnet-webapi-clean-BYUUHX5Y.js → dotnet-webapi-clean-6TVFBTVI.js} +20 -20
  49. package/dist/{gofiber-standard-B6UK5GR7.js → gofiber-standard-2BL7GWZB.js} +1 -1
  50. package/dist/{gogin-standard-BXU44VEM.js → gogin-standard-XGP3KBXA.js} +1 -1
  51. package/dist/index.d.ts +88 -13
  52. package/dist/index.js +327 -324
  53. package/dist/pipeline-ORIWVVYM.js +5 -0
  54. package/dist/{platform-capabilities-YICBF4FA.js → platform-capabilities-2B4QMZXE.js} +1 -1
  55. package/dist/{pythonRapidkitExec-UJYIB6FL.js → pythonRapidkitExec-CVCIK225.js} +1 -1
  56. package/dist/{springboot-standard-PEHDKH2L.js → springboot-standard-JJNUID6M.js} +6 -6
  57. package/dist/workspace-7OXW5YTJ.js +1 -0
  58. package/dist/{workspace-agent-sync-G5YVI3BJ.js → workspace-agent-sync-O4IA6VOA.js} +1 -1
  59. package/dist/workspace-archive-H74NBBNW.js +10 -0
  60. package/dist/{workspace-context-E3UFWL5X.js → workspace-context-R7IPUBPG.js} +1 -1
  61. package/dist/workspace-contract-HKCMOMFE.js +1 -0
  62. package/dist/workspace-explain-GOPQYTPQ.js +1 -0
  63. package/dist/workspace-explain-contract-SVFJAAEI.js +1 -0
  64. package/dist/{workspace-feedback-YY6WQPWQ.js → workspace-feedback-REOS36ZZ.js} +1 -1
  65. package/dist/{workspace-foundation-3C2DLCVI.js → workspace-foundation-KXT4QI5O.js} +1 -1
  66. package/dist/{workspace-history-VF3CHDYQ.js → workspace-history-OGOVSKZG.js} +1 -1
  67. package/dist/{workspace-intelligence-3GG7GEDQ.js → workspace-intelligence-7IESQSXY.js} +1 -1
  68. package/dist/workspace-intelligence-runner-6GJ5M4HB.js +1 -0
  69. package/dist/{workspace-mcp-serve-MJMUV4RY.js → workspace-mcp-serve-FRVWBO36.js} +1 -1
  70. package/dist/{workspace-model-NG45SRM5.js → workspace-model-PPYX7B4S.js} +1 -1
  71. package/dist/workspace-python-engine-state-2MLKJYQG.js +2 -0
  72. package/dist/workspace-registry-summary-SZ46R5PD.js +1 -0
  73. package/dist/workspace-run-V3KKHTVF.js +1 -0
  74. package/dist/{workspace-verify-ZNT6JX7D.js → workspace-verify-MFQ7IXGD.js} +1 -1
  75. package/dist/{workspace-watch-W47T4RX2.js → workspace-watch-SOPZHRWA.js} +1 -1
  76. package/docs/AI_DYNAMIC_INTEGRATION.md +29 -33
  77. package/docs/AI_FEATURES.md +18 -27
  78. package/docs/AI_QUICKSTART.md +7 -4
  79. package/docs/DEVELOPMENT.md +5 -5
  80. package/docs/From Code to Shared Understanding.png +0 -0
  81. package/docs/OPEN_SOURCE_USER_SCENARIOS.md +23 -2
  82. package/docs/OPTIMIZATION_GUIDE.md +19 -51
  83. package/docs/PACKAGE_MANAGER_POLICY.md +4 -1
  84. package/docs/README.md +30 -3
  85. package/docs/SECURITY.md +13 -6
  86. package/docs/SETUP.md +6 -3
  87. package/docs/UTILITIES.md +8 -20
  88. package/docs/WORKSPACE_MARKER_SPEC.md +27 -20
  89. package/docs/ci-workflows.md +19 -5
  90. package/docs/commands-reference.md +37 -9
  91. package/docs/config-file-guide.md +64 -247
  92. package/docs/contracts/ARTIFACT_CATALOG.md +14 -2
  93. package/docs/contracts/CLI_LOG_EVENT_STREAM.md +1 -1
  94. package/docs/contracts/README.md +5 -2
  95. package/docs/contracts/RUNTIME_ACCEPTANCE_MATRIX.md +4 -4
  96. package/docs/contracts/RUNTIME_SUPPORT_MATRIX.md +14 -10
  97. package/docs/creating-workspaces-and-projects.md +649 -0
  98. package/docs/doctor-command.md +5 -4
  99. package/docs/examples/ci-agent-grounding.yml +16 -10
  100. package/docs/from-code-to-shared-understanding.md +69 -38
  101. package/docs/workspace-intelligence-runner.md +186 -0
  102. package/docs/workspace-operations.md +29 -11
  103. package/docs/workspace-run.md +4 -1
  104. package/package.json +9 -8
  105. package/rapidkit.config.example.cjs +5 -5
  106. package/scripts/enforce-package-manager.cjs +1 -1
  107. package/scripts/prepack-enterprise.mjs +4 -0
  108. package/workspai.config.example.cjs +12 -47
  109. package/dist/analyze-YLV7NVLF.js +0 -1
  110. package/dist/autopilot-release-YBN3SWAA.js +0 -1
  111. package/dist/chunk-2K3GYCPS.js +0 -1
  112. package/dist/chunk-42G2OK64.js +0 -1
  113. package/dist/chunk-5AKYMAIL.js +0 -1
  114. package/dist/chunk-5PVEQ6CZ.js +0 -13
  115. package/dist/chunk-6AA3WWQZ.js +0 -2
  116. package/dist/chunk-7RIWU5TZ.js +0 -1
  117. package/dist/chunk-BJLE5CH7.js +0 -4
  118. package/dist/chunk-G3H5R3RR.js +0 -1
  119. package/dist/chunk-IMUU5Q2V.js +0 -13
  120. package/dist/chunk-KPPGZCUW.js +0 -78
  121. package/dist/chunk-LCRROMRR.js +0 -2
  122. package/dist/chunk-QWU2CZBG.js +0 -2
  123. package/dist/chunk-XZGVNGRB.js +0 -1
  124. package/dist/chunk-ZWO6K24C.js +0 -2
  125. package/dist/doctor-YJDM5XBH.js +0 -1
  126. package/dist/imported-projects-registry-FOIE27WT.js +0 -1
  127. package/dist/pipeline-FEDYO3IA.js +0 -5
  128. package/dist/workspace-PLXOO6ST.js +0 -1
  129. package/dist/workspace-archive-EEGLHZDW.js +0 -10
  130. package/dist/workspace-contract-LQJDZV36.js +0 -1
  131. package/dist/workspace-explain-G74ZIF23.js +0 -1
  132. package/dist/workspace-explain-contract-KT757JGQ.js +0 -1
  133. package/dist/workspace-python-engine-state-MTWIIZPY.js +0 -2
  134. package/dist/workspace-registry-summary-JM2XY52C.js +0 -1
  135. package/dist/workspace-run-WEQYIERE.js +0 -1
package/dist/index.d.ts CHANGED
@@ -1,9 +1,23 @@
1
1
  #!/usr/bin/env node
2
+ import { Command } from 'commander';
3
+
2
4
  declare const PROJECT_COMMANDS_CORE_FALLBACK: readonly ["lint", "format", "docs"];
3
5
 
4
6
  declare const COMMAND_CAPABILITIES_SCHEMA_VERSION: "rapidkit-command-capabilities-v1";
5
7
  declare const VERSION_CONTRACT_SCHEMA_VERSION: "rapidkit-version-v1";
6
8
 
9
+ declare const NPM_ONLY_MANUAL_HANDLER_COMMANDS: readonly ["bootstrap", "setup", "cache", "mirror"];
10
+
11
+ interface AdoptProjectFilePreimage {
12
+ path: string;
13
+ contents: Buffer | null;
14
+ }
15
+ interface AdoptProjectRollbackSnapshot {
16
+ workspacePath: string;
17
+ projectPath: string;
18
+ files: AdoptProjectFilePreimage[];
19
+ }
20
+
7
21
  declare function getPublishedContractVersions(): {
8
22
  autopilotRelease: "autopilot-release-v1";
9
23
  workspaceList: "rapidkit-workspace-list-v1";
@@ -48,6 +62,7 @@ declare function getPublishedContractVersions(): {
48
62
  readonly skillsIndex: "workspace-skills-index.v1";
49
63
  readonly agents: null;
50
64
  readonly explain: "workspace-explain.v1";
65
+ readonly intelligenceRun: "workspace-intelligence-run.v1";
51
66
  };
52
67
  cliLogEvent: "cli-log-event-v1";
53
68
  freshnessMetadata: "rapidkit-freshness-metadata-v1";
@@ -74,9 +89,9 @@ declare function getPublishedContractCatalog(): {
74
89
  [k: string]: {
75
90
  artifacts?: {
76
91
  [k: string]: {
77
- 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";
78
- 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;
79
- 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;
92
+ 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";
93
+ 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;
94
+ 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;
80
95
  };
81
96
  } | undefined;
82
97
  schemaVersion: string | {
@@ -96,6 +111,7 @@ declare function getPublishedContractCatalog(): {
96
111
  readonly skillsIndex: "workspace-skills-index.v1";
97
112
  readonly agents: null;
98
113
  readonly explain: "workspace-explain.v1";
114
+ readonly intelligenceRun: "workspace-intelligence-run.v1";
99
115
  };
100
116
  contractPath: string | null;
101
117
  publication: "capability-contract" | "json-schema" | "embedded-type";
@@ -104,8 +120,36 @@ declare function getPublishedContractCatalog(): {
104
120
 
105
121
  declare const NPM_ONLY_SCOPED_COMMANDS: readonly (readonly string[])[];
106
122
  declare const NPM_ONLY_TOP_LEVEL_COMMANDS: readonly string[];
123
+
124
+ type BridgeFailureCode = 'PYTHON_NOT_FOUND' | 'BRIDGE_VENV_BOOTSTRAP_FAILED' | 'BRIDGE_VENV_CREATE_FAILED' | 'BRIDGE_PIP_BOOTSTRAP_FAILED';
125
+ declare function bridgeFailureCode(err: unknown): BridgeFailureCode | null;
126
+ declare function resolveInvokedCliName(argv?: string[]): 'workspai' | 'rapidkit';
127
+ declare function normalizeFallbackTemplate(kit: string): 'fastapi' | 'nestjs' | null;
128
+ declare function readFlagValue(argv: string[], flag: string): string | undefined;
129
+ declare function parseMaxWorkersOption(raw: string | undefined): number | undefined;
130
+ declare function hostPythonCandidates(): string[];
131
+ declare function buildDelegationEnvForInit(): NodeJS.ProcessEnv;
132
+ declare function commandAvailable(command: string, cwd: string): Promise<boolean>;
133
+ type InferredRuntime = 'python' | 'node' | 'go' | 'java' | 'dotnet' | null;
134
+ declare function inferRuntimeByFiles(targetPath: string): Promise<InferredRuntime>;
135
+ interface PythonProjectOrchestrationDependencies {
136
+ runCommand?: typeof runCommandInCwd;
137
+ pythonCandidates?: readonly string[];
138
+ }
139
+ declare function createWorkspaceVenv(workspacePath: string, dependencies?: PythonProjectOrchestrationDependencies): Promise<number>;
140
+ declare function createProjectVenv(projectPath: string, dependencies?: PythonProjectOrchestrationDependencies): Promise<number>;
141
+ declare function ensurePythonProjectUsesLocalVenv(projectPath: string, dependencies?: PythonProjectOrchestrationDependencies): Promise<number>;
142
+ declare function installPythonDependenciesWithPipFallback(projectPath: string, dependencies?: PythonProjectOrchestrationDependencies): Promise<number>;
143
+ declare function validateNpmKitFlags(kitId: string, args: readonly string[]): string | null;
144
+ declare function runCreateFallback(args: string[], reasonCode: BridgeFailureCode): Promise<number>;
107
145
  declare function handleCreateOrFallback(args: string[]): Promise<number>;
108
146
  declare const WRAPPER_ORCHESTRATED_PROJECT_COMMANDS: readonly ["init"];
147
+ declare function isNpmOnlyTopLevelCommand(command: string | undefined): boolean;
148
+ declare function isNpmOnlyScopedCommand(args: readonly string[]): boolean;
149
+ declare function isNpmOnlyInvocation(args: readonly string[]): boolean;
150
+ declare function isNpmOnlyParseDirectCommand(command: string | undefined): boolean;
151
+ declare function isNpmOnlyParseDirectInvocation(args: readonly string[]): boolean;
152
+ declare function isNpmOnlyManualHandlerCommand(command: string | undefined): command is (typeof NPM_ONLY_MANUAL_HANDLER_COMMANDS)[number];
109
153
  declare function isNpmExecInvocation(env?: NodeJS.ProcessEnv): boolean;
110
154
 
111
155
  declare function getVersionContract(): {
@@ -159,6 +203,7 @@ declare function getVersionContract(): {
159
203
  readonly skillsIndex: "workspace-skills-index.v1";
160
204
  readonly agents: null;
161
205
  readonly explain: "workspace-explain.v1";
206
+ readonly intelligenceRun: "workspace-intelligence-run.v1";
162
207
  };
163
208
  cliLogEvent: "cli-log-event-v1";
164
209
  freshnessMetadata: "rapidkit-freshness-metadata-v1";
@@ -185,9 +230,9 @@ declare function getVersionContract(): {
185
230
  [k: string]: {
186
231
  artifacts?: {
187
232
  [k: string]: {
188
- 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";
189
- 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;
190
- 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;
233
+ 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";
234
+ 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;
235
+ 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;
191
236
  };
192
237
  } | undefined;
193
238
  schemaVersion: string | {
@@ -207,6 +252,7 @@ declare function getVersionContract(): {
207
252
  readonly skillsIndex: "workspace-skills-index.v1";
208
253
  readonly agents: null;
209
254
  readonly explain: "workspace-explain.v1";
255
+ readonly intelligenceRun: "workspace-intelligence-run.v1";
210
256
  };
211
257
  contractPath: string | null;
212
258
  publication: "capability-contract" | "json-schema" | "embedded-type";
@@ -292,6 +338,7 @@ declare function getGlobalCommandCapabilities(): {
292
338
  readonly skillsIndex: "workspace-skills-index.v1";
293
339
  readonly agents: null;
294
340
  readonly explain: "workspace-explain.v1";
341
+ readonly intelligenceRun: "workspace-intelligence-run.v1";
295
342
  };
296
343
  cliLogEvent: "cli-log-event-v1";
297
344
  freshnessMetadata: "rapidkit-freshness-metadata-v1";
@@ -318,9 +365,9 @@ declare function getGlobalCommandCapabilities(): {
318
365
  [k: string]: {
319
366
  artifacts?: {
320
367
  [k: string]: {
321
- 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";
322
- 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;
323
- 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;
368
+ 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";
369
+ 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;
370
+ 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;
324
371
  };
325
372
  } | undefined;
326
373
  schemaVersion: string | {
@@ -340,6 +387,7 @@ declare function getGlobalCommandCapabilities(): {
340
387
  readonly skillsIndex: "workspace-skills-index.v1";
341
388
  readonly agents: null;
342
389
  readonly explain: "workspace-explain.v1";
390
+ readonly intelligenceRun: "workspace-intelligence-run.v1";
343
391
  };
344
392
  contractPath: string | null;
345
393
  publication: "capability-contract" | "json-schema" | "embedded-type";
@@ -352,12 +400,16 @@ declare function getGlobalCommandCapabilities(): {
352
400
  };
353
401
  workspace: {
354
402
  command: string;
355
- subcommands: ("archive" | "snapshot" | "list" | "import" | "init" | "model" | "diff" | "impact" | "verify" | "explain" | "sync" | "registry" | "foundation" | "graph" | "watch" | "context" | "agent-sync" | "remediation-plan" | "why" | "trace" | "feedback" | "mcp" | "policy" | "contract" | "share" | "export" | "hydrate" | "run")[];
356
- intelligenceSubcommands: ("snapshot" | "model" | "diff" | "impact" | "verify" | "explain" | "graph" | "watch" | "context" | "agent-sync" | "remediation-plan" | "why" | "trace" | "feedback" | "mcp" | "contract")[];
403
+ 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")[];
404
+ intelligenceSubcommands: ("snapshot" | "model" | "diff" | "impact" | "verify" | "explain" | "intelligence" | "graph" | "watch" | "context" | "agent-sync" | "remediation-plan" | "why" | "trace" | "feedback" | "mcp" | "contract")[];
357
405
  };
358
406
  commandMap: any;
359
407
  runtimeInventory: RuntimeCommandInventoryPayload;
360
408
  };
409
+ declare function hasWorkspaceRootMarkers(targetDir: string): boolean;
410
+ declare function findContextFileUp(start: string): string | null;
411
+ declare function findWorkspaceMarkerUp(start: string): string | null;
412
+ declare function findWorkspaceUp(start: string): string | null;
361
413
  interface DoctorWorkspaceShadowDiagnostic {
362
414
  detected: boolean;
363
415
  candidatePath?: string;
@@ -367,6 +419,16 @@ declare function detectWindowsDoctorWorkspaceShadow(params: {
367
419
  scope?: string;
368
420
  workspaceFlag?: boolean | string;
369
421
  }, cwd?: string, platform?: NodeJS.Platform): Promise<DoctorWorkspaceShadowDiagnostic>;
422
+ declare function findLegacyWorkspaceUp(start: string): string | null;
423
+ type WorkspacePolicyRuleKey = 'enforce_workspace_marker' | 'enforce_toolchain_lock' | 'disallow_untrusted_tool_sources' | 'enforce_compatibility_matrix' | 'require_mirror_lock_for_offline';
424
+ declare function replaceOrInsertTopLevelPolicyLine(content: string, key: string, value: string): string;
425
+ declare function replaceOrInsertRulePolicyLine(content: string, key: WorkspacePolicyRuleKey, value: boolean): string;
426
+ declare function defaultWorkspacePolicyYaml(): string;
427
+ declare function parsePolicyBooleanLiteral(value: string): boolean | null;
428
+ declare function runCommandInCwd(command: string, commandArgs: string[], cwd: string, options?: {
429
+ timeoutMs?: number;
430
+ }): Promise<number>;
431
+ declare function parseNodeEvalScript(script: string): string | null;
370
432
  declare function handleImportCommand(source: string, options: {
371
433
  workspace?: string;
372
434
  name?: string;
@@ -387,14 +449,27 @@ declare function handleAdoptCommand(source: string | undefined, options: {
387
449
  syncWorkspaceProjects?: (workspacePath: string) => Promise<void>;
388
450
  registerWorkspace?: (workspacePath: string, workspaceName: string) => Promise<void>;
389
451
  registerProjectInWorkspace?: (workspacePath: string, projectName: string, projectPath: string) => Promise<void>;
390
- rollbackAdoptedProjectImport?: (workspacePath: string, projectPath: string, previousProjectJson: Record<string, unknown> | null) => Promise<void>;
452
+ rollbackAdoptedProjectImport?: (workspacePath: string, projectPath: string, snapshot: AdoptProjectRollbackSnapshot) => Promise<void>;
391
453
  }): Promise<number>;
392
454
  declare function installWorkspaceDependencies(workspacePath: string): Promise<number>;
455
+ declare function handleGoInit(projectPath: string): Promise<number>;
456
+ declare function handleNodeCommand(action: 'init' | 'dev' | 'test' | 'build' | 'start' | 'lint' | 'format', projectPath: string): Promise<number>;
457
+ declare function handleJavaCommand(action: 'init' | 'dev' | 'test' | 'build' | 'start' | 'lint' | 'format', projectPath: string): Promise<number>;
393
458
  declare function handleBootstrapCommand(args: string[], initRunner?: (nextArgs: string[]) => Promise<number>): Promise<number>;
394
459
  declare function handleSetupCommand(args: string[]): Promise<number>;
460
+ declare function parseCacheConfig(content: string): {
461
+ strategy: string;
462
+ prune_on_bootstrap: boolean;
463
+ self_heal: boolean;
464
+ verify_integrity: boolean;
465
+ };
395
466
  declare function handleCacheCommand(args: string[]): Promise<number>;
396
467
  declare function handleMirrorCommand(args: string[]): Promise<number>;
397
468
  declare function handleInitCommand(args: string[]): Promise<number>;
469
+ declare function checkStrictPolicyPreflightForDelegation(cwd: string): Promise<string[]>;
470
+ declare const program: Command;
398
471
  declare function shouldForwardToCore(args: string[]): Promise<boolean>;
472
+ declare function printHelp(): void;
473
+ declare function bootstrapCli(): Promise<void>;
399
474
 
400
- 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 };
475
+ 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 };