rapidkit 0.42.1 → 0.42.3

package/dist/{pipeline-PX6ZUINW.js → pipeline-YT57V6AL.js}

@@ -1,4 +1,4 @@
-import {a as a$1}from'./chunk-MQGVCTUL.js';import {c as c$1}from'./chunk-CXWWNQDF.js';import {c}from'./chunk-WKCBS5DC.js';import {b}from'./chunk-JN6R5UP4.js';import {a as a$2}from'./chunk-7V7C6GXV.js';import {f,e}from'./chunk-PCXSTKZ5.js';import {a}from'./chunk-KMUWWZRT.js';import c$2 from'chalk';import D from'fs-extra';import u from'path';function C(t){return t===0?"pass":t===2?"warn":"fail"}function M(t){return t.some(s=>s.status==="fail")?"blocked":t.some(s=>s.status==="warn")?"needs-attention":"ready"}function F(t,s){if(s)return 3;let a=t.some(i=>i.status==="fail"),r=t.some(i=>i.status==="warn");return a?1:r?2:0}async function j(t){let s=await b(t,true),a=false;try{let{syncWorkspaceContract:r}=await import('./workspace-contract-OO4GMENV.js');await r({workspacePath:t}),a=true;}catch{a=false;}return {sync:s,contractSynced:a}}async function G(t={}){let s=u.resolve(t.workspacePath??process.cwd()),a$3=a(s);if(!a$3)throw new Error("No RapidKit workspace found in current directory or parents");let r=[],i=[],l=false,p,y,m,f$1=Date.now();try{let{sync:e,contractSynced:n}=await j(a$3),o=e.workspaceFound&&(e.added.length>0||e.skipped>=0)||e.workspaceFound?"pass":"warn";r.push({name:"sync",status:o,durationMs:Date.now()-f$1,summary:e.workspaceFound?`registry sync complete (${e.added.length} added, ${e.skipped} existing)${n?", contract synced":""}`:"workspace not registered in global registry; contract sync attempted"}),e.workspaceFound||i.push("workspace registry entry missing \u2014 run rapidkit create workspace or register manually");}catch(e){l=true,r.push({name:"sync",status:"fail",durationMs:Date.now()-f$1,summary:`sync failed: ${e instanceof Error?e.message:String(e)}`}),i.push("workspace sync stage failed");}let w=Date.now();try{let e=await c({workspace:true,json:true,quiet:true,strict:t.strict===true,ci:t.strict!==true}),n=C(e),o=u.join(a$3,".rapidkit","reports","doctor-last-run.json");r.push({name:"doctor",status:n,durationMs:Date.now()-w,summary:n==="pass"?"doctor workspace passed":n==="warn"?"doctor workspace reported warnings":"doctor workspace did not pass",exitCode:e,evidencePath:o}),n==="fail"?i.push("doctor workspace gate failed"):n==="warn"&&i.push("doctor workspace reported warnings");}catch(e){l=true,r.push({name:"doctor",status:"fail",durationMs:Date.now()-w,summary:`doctor failed: ${e instanceof Error?e.message:String(e)}`}),i.push("doctor workspace stage failed");}if(t.skipAnalyze)r.push({name:"analyze",status:"skipped",durationMs:0,summary:"analyze stage skipped"});else {let e=Date.now();try{let n=await a$1({workspacePath:a$3,json:true,strict:t.strict===true});p=u.join(a$3,".rapidkit","reports","analyze-last-run.json");let o=n.summary.verdict==="blocked"?"fail":n.summary.verdict==="needs-attention"?"warn":"pass";r.push({name:"analyze",status:o,durationMs:Date.now()-e,summary:`analyze verdict: ${n.summary.verdict} (score ${n.summary.score}/100)`,evidencePath:p}),o==="fail"?i.push("analyze reported blocked verdict"):o==="warn"&&i.push("analyze reported needs-attention verdict");}catch(n){l=true,r.push({name:"analyze",status:"fail",durationMs:Date.now()-e,summary:`analyze failed: ${n instanceof Error?n.message:String(n)}`}),i.push("analyze stage failed");}}let h=Date.now();try{let e=await a$2({startPath:a$3,writeReport:true,skipVerify:t.skipVerify===true});y=e.evidencePath;let n=e.overallStatus==="pass"?"pass":e.overallStatus==="warn"?"warn":"fail";r.push({name:"readiness",status:n,durationMs:Date.now()-h,summary:`readiness overall: ${e.overallStatus}`,evidencePath:e.evidencePath}),n==="fail"?i.push(...e.blockingReasons.map(o=>`readiness: ${o}`)):n==="warn"&&i.push(...e.gates.filter(o=>o.status==="warn").map(o=>`readiness warn: ${o.gate}: ${o.summary}`));}catch(e){l=true,r.push({name:"readiness",status:"fail",durationMs:Date.now()-h,summary:`readiness failed: ${e instanceof Error?e.message:String(e)}`}),i.push("readiness stage failed");}if(t.skipAutopilot)r.push({name:"autopilot",status:"skipped",durationMs:0,summary:"autopilot stage skipped"});else {let e=Date.now(),n=t.autopilotMode??"audit";try{let o=await c$1({workspacePath:a$3,mode:n,json:true,skipPipelineStages:true});m=o.artifacts.reportPath;let P=o.summary.verdict==="approved"?"pass":o.summary.verdict==="partial"?"warn":"fail";r.push({name:"autopilot",status:P,durationMs:Date.now()-e,summary:`autopilot ${n}: ${o.summary.verdict}`,exitCode:o.summary.exitCode,evidencePath:m}),P!=="pass"&&i.push(...o.blockingReasons.slice(0,5));}catch(o){l=true,r.push({name:"autopilot",status:"fail",durationMs:Date.now()-e,summary:`autopilot failed: ${o instanceof Error?o.message:String(o)}`}),i.push("autopilot release stage failed");}}let z=M(r),k=F(r,l),g=u.join(a$3,".rapidkit","reports","pipeline-last-run.json"),d={schemaVersion:"rapidkit-pipeline-v1",generatedAt:new Date().toISOString(),workspacePath:a$3,summary:{verdict:z,exitCode:k,stagesPassed:r.filter(e=>e.status==="pass").length,stagesWarn:r.filter(e=>e.status==="warn").length,stagesFailed:r.filter(e=>e.status==="fail").length},stages:r,blockingReasons:[...new Set(i)],artifacts:{reportPath:g,analyzeEvidencePath:p,readinessEvidencePath:y,autopilotEvidencePath:m}};if(t.writeReport!==false){await D.ensureDir(u.dirname(g));let e$1=f(d,{commandId:"workspacePipeline",exitCode:k,generatedAt:d.generatedAt,blockers:d.blockingReasons,runId:e()});await D.writeJSON(g,e$1,{spaces:2});}if(t.writeReport!==false&&t.noAgentSync!==true&&process.env.RAPIDKIT_NO_AGENT_SYNC!=="1"&&t.agentSync!==false)try{let{syncWorkspaceAgentGrounding:e}=await import('./workspace-agent-sync-XD32GG5V.js'),n=await e({workspacePath:a$3,write:true,refreshContext:true,strict:false});d.agentGrounding={indexPath:n.indexPath,writtenFiles:n.writtenFiles,blockers:n.blockers};}catch{}return d}async function X(t){let s;try{s=await G(t);}catch(a){let r=a instanceof Error?a.message:String(a);t.json?console.log(JSON.stringify({schemaVersion:"rapidkit-pipeline-error-v1",ok:false,error:{message:r}},null,2)):console.log(c$2.red(`Pipeline failed: ${r}`)),process.exit(1);}if(t.json)console.log(JSON.stringify(s,null,2));else {console.log(c$2.bold.cyan(`
+import {a as a$1}from'./chunk-MQGVCTUL.js';import {c as c$1}from'./chunk-MWVOWE5T.js';import {c}from'./chunk-WKCBS5DC.js';import {b}from'./chunk-4SYXFC4M.js';import {a as a$2}from'./chunk-7V7C6GXV.js';import {f,e}from'./chunk-PCXSTKZ5.js';import {a}from'./chunk-KMUWWZRT.js';import c$2 from'chalk';import D from'fs-extra';import u from'path';function C(t){return t===0?"pass":t===2?"warn":"fail"}function M(t){return t.some(s=>s.status==="fail")?"blocked":t.some(s=>s.status==="warn")?"needs-attention":"ready"}function F(t,s){if(s)return 3;let a=t.some(i=>i.status==="fail"),r=t.some(i=>i.status==="warn");return a?1:r?2:0}async function j(t){let s=await b(t,true),a=false;try{let{syncWorkspaceContract:r}=await import('./workspace-contract-OO4GMENV.js');await r({workspacePath:t}),a=true;}catch{a=false;}return {sync:s,contractSynced:a}}async function G(t={}){let s=u.resolve(t.workspacePath??process.cwd()),a$3=a(s);if(!a$3)throw new Error("No RapidKit workspace found in current directory or parents");let r=[],i=[],l=false,p,y,m,f$1=Date.now();try{let{sync:e,contractSynced:n}=await j(a$3),o=e.workspaceFound&&(e.added.length>0||e.skipped>=0)||e.workspaceFound?"pass":"warn";r.push({name:"sync",status:o,durationMs:Date.now()-f$1,summary:e.workspaceFound?`registry sync complete (${e.added.length} added, ${e.skipped} existing)${n?", contract synced":""}`:"workspace not registered in global registry; contract sync attempted"}),e.workspaceFound||i.push("workspace registry entry missing \u2014 run rapidkit create workspace or register manually");}catch(e){l=true,r.push({name:"sync",status:"fail",durationMs:Date.now()-f$1,summary:`sync failed: ${e instanceof Error?e.message:String(e)}`}),i.push("workspace sync stage failed");}let w=Date.now();try{let e=await c({workspace:true,json:true,quiet:true,strict:t.strict===true,ci:t.strict!==true}),n=C(e),o=u.join(a$3,".rapidkit","reports","doctor-last-run.json");r.push({name:"doctor",status:n,durationMs:Date.now()-w,summary:n==="pass"?"doctor workspace passed":n==="warn"?"doctor workspace reported warnings":"doctor workspace did not pass",exitCode:e,evidencePath:o}),n==="fail"?i.push("doctor workspace gate failed"):n==="warn"&&i.push("doctor workspace reported warnings");}catch(e){l=true,r.push({name:"doctor",status:"fail",durationMs:Date.now()-w,summary:`doctor failed: ${e instanceof Error?e.message:String(e)}`}),i.push("doctor workspace stage failed");}if(t.skipAnalyze)r.push({name:"analyze",status:"skipped",durationMs:0,summary:"analyze stage skipped"});else {let e=Date.now();try{let n=await a$1({workspacePath:a$3,json:true,strict:t.strict===true});p=u.join(a$3,".rapidkit","reports","analyze-last-run.json");let o=n.summary.verdict==="blocked"?"fail":n.summary.verdict==="needs-attention"?"warn":"pass";r.push({name:"analyze",status:o,durationMs:Date.now()-e,summary:`analyze verdict: ${n.summary.verdict} (score ${n.summary.score}/100)`,evidencePath:p}),o==="fail"?i.push("analyze reported blocked verdict"):o==="warn"&&i.push("analyze reported needs-attention verdict");}catch(n){l=true,r.push({name:"analyze",status:"fail",durationMs:Date.now()-e,summary:`analyze failed: ${n instanceof Error?n.message:String(n)}`}),i.push("analyze stage failed");}}let h=Date.now();try{let e=await a$2({startPath:a$3,writeReport:true,skipVerify:t.skipVerify===true});y=e.evidencePath;let n=e.overallStatus==="pass"?"pass":e.overallStatus==="warn"?"warn":"fail";r.push({name:"readiness",status:n,durationMs:Date.now()-h,summary:`readiness overall: ${e.overallStatus}`,evidencePath:e.evidencePath}),n==="fail"?i.push(...e.blockingReasons.map(o=>`readiness: ${o}`)):n==="warn"&&i.push(...e.gates.filter(o=>o.status==="warn").map(o=>`readiness warn: ${o.gate}: ${o.summary}`));}catch(e){l=true,r.push({name:"readiness",status:"fail",durationMs:Date.now()-h,summary:`readiness failed: ${e instanceof Error?e.message:String(e)}`}),i.push("readiness stage failed");}if(t.skipAutopilot)r.push({name:"autopilot",status:"skipped",durationMs:0,summary:"autopilot stage skipped"});else {let e=Date.now(),n=t.autopilotMode??"audit";try{let o=await c$1({workspacePath:a$3,mode:n,json:true,skipPipelineStages:true});m=o.artifacts.reportPath;let P=o.summary.verdict==="approved"?"pass":o.summary.verdict==="partial"?"warn":"fail";r.push({name:"autopilot",status:P,durationMs:Date.now()-e,summary:`autopilot ${n}: ${o.summary.verdict}`,exitCode:o.summary.exitCode,evidencePath:m}),P!=="pass"&&i.push(...o.blockingReasons.slice(0,5));}catch(o){l=true,r.push({name:"autopilot",status:"fail",durationMs:Date.now()-e,summary:`autopilot failed: ${o instanceof Error?o.message:String(o)}`}),i.push("autopilot release stage failed");}}let z=M(r),k=F(r,l),g=u.join(a$3,".rapidkit","reports","pipeline-last-run.json"),d={schemaVersion:"rapidkit-pipeline-v1",generatedAt:new Date().toISOString(),workspacePath:a$3,summary:{verdict:z,exitCode:k,stagesPassed:r.filter(e=>e.status==="pass").length,stagesWarn:r.filter(e=>e.status==="warn").length,stagesFailed:r.filter(e=>e.status==="fail").length},stages:r,blockingReasons:[...new Set(i)],artifacts:{reportPath:g,analyzeEvidencePath:p,readinessEvidencePath:y,autopilotEvidencePath:m}};if(t.writeReport!==false){await D.ensureDir(u.dirname(g));let e$1=f(d,{commandId:"workspacePipeline",exitCode:k,generatedAt:d.generatedAt,blockers:d.blockingReasons,runId:e()});await D.writeJSON(g,e$1,{spaces:2});}if(t.writeReport!==false&&t.noAgentSync!==true&&process.env.RAPIDKIT_NO_AGENT_SYNC!=="1"&&t.agentSync!==false)try{let{syncWorkspaceAgentGrounding:e}=await import('./workspace-agent-sync-XD32GG5V.js'),n=await e({workspacePath:a$3,write:true,refreshContext:true,strict:false});d.agentGrounding={indexPath:n.indexPath,writtenFiles:n.writtenFiles,blockers:n.blockers};}catch{}return d}async function X(t){let s;try{s=await G(t);}catch(a){let r=a instanceof Error?a.message:String(a);t.json?console.log(JSON.stringify({schemaVersion:"rapidkit-pipeline-error-v1",ok:false,error:{message:r}},null,2)):console.log(c$2.red(`Pipeline failed: ${r}`)),process.exit(1);}if(t.json)console.log(JSON.stringify(s,null,2));else {console.log(c$2.bold.cyan(`
 \u{1F517} RapidKit Governance Pipeline
 `)),console.log(c$2.bold(`Workspace: ${c$2.cyan(u.basename(s.workspacePath))}`)),console.log(c$2.gray(`Path: ${s.workspacePath}`)),console.log(c$2.white(`Verdict: ${s.summary.verdict}  Exit: ${s.summary.exitCode}  (${s.summary.stagesPassed} pass / ${s.summary.stagesWarn} warn / ${s.summary.stagesFailed} fail)`));for(let a of s.stages){let r=a.status==="pass"?c$2.green("PASS"):a.status==="warn"?c$2.yellow("WARN"):a.status==="skipped"?c$2.gray("SKIP"):c$2.red("FAIL");console.log(` - ${a.name}: ${r} ${a.summary}`);}if(s.blockingReasons.length>0){console.log(c$2.bold(`
 Blocking reasons:`));for(let a of s.blockingReasons.slice(0,8))console.log(c$2.gray(`  \u2022 ${a}`));}console.log(c$2.gray(`

package/dist/{workspace-MPKEUHFP.js → workspace-NJFK6DAP.js}

@@ -1 +1 @@
-export{e as createProject,d as createWorkspace,g as createWorkspaceShareBundle,f as listWorkspaces,c as registerProjectInWorkspace,a as registerWorkspace,b as syncWorkspaceProjects}from'./chunk-JN6R5UP4.js';
+export{e as createProject,d as createWorkspace,g as createWorkspaceShareBundle,f as listWorkspaces,c as registerProjectInWorkspace,a as registerWorkspace,b as syncWorkspaceProjects}from'./chunk-4SYXFC4M.js';

package/dist/{workspace-foundation-2OVUZXPT.js → workspace-foundation-OTL2RSZP.js}

@@ -1 +1 @@
-import {b}from'./chunk-NN3IV4U6.js';import {a}from'./chunk-2LBPX5K3.js';import c from'path';import u from'fs-extra';async function W(t,r){let o=await a(t),d=o?.name||c.basename(t),n,i=c.join(t,".python-version");if(await u.pathExists(i)){let a=(await u.readFile(i,"utf-8")).trim();a&&(n=a);}let e=r?.profile||"polyglot",m=e==="python-only"||e==="polyglot"||e==="enterprise",f=r?.installMethod||o?.metadata?.npm?.installMethod||(m?"poetry":"venv"),s=await b(t,{workspaceName:d,installMethod:f,pythonVersion:n,profile:e,writeMarker:true,writeGitignore:true,onlyIfMissing:!r?.force}),{publishWorkspaceRegistrySummary:y}=await import('./workspace-registry-summary-X5WRUU3T.js');return await y(t),{workspacePath:t,created:s,status:s.length>0?"passed":"skipped"}}export{W as ensureWorkspaceFoundation};
+import {b}from'./chunk-LK66ATAQ.js';import {a}from'./chunk-2LBPX5K3.js';import c from'path';import u from'fs-extra';async function W(t,r){let o=await a(t),d=o?.name||c.basename(t),n,i=c.join(t,".python-version");if(await u.pathExists(i)){let a=(await u.readFile(i,"utf-8")).trim();a&&(n=a);}let e=r?.profile||"polyglot",m=e==="python-only"||e==="polyglot"||e==="enterprise",f=r?.installMethod||o?.metadata?.npm?.installMethod||(m?"poetry":"venv"),s=await b(t,{workspaceName:d,installMethod:f,pythonVersion:n,profile:e,writeMarker:true,writeGitignore:true,onlyIfMissing:!r?.force}),{publishWorkspaceRegistrySummary:y}=await import('./workspace-registry-summary-X5WRUU3T.js');return await y(t),{workspacePath:t,created:s,status:s.length>0?"passed":"skipped"}}export{W as ensureWorkspaceFoundation};

package/dist/workspace-run-BV2PIE3Y.js

@@ -0,0 +1 @@
+export{a as runWorkspaceStage}from'./chunk-YVTVFYSI.js';export{a as WORKSPACE_RUN_LAST_REPORT_FILENAME}from'./chunk-64RTZBHU.js';

package/docs/AI_DYNAMIC_INTEGRATION.md

@@ -1,5 +1,9 @@
 # 🔄 Dynamic AI Integration with Python Core
 
+> [!NOTE]
+> Legacy `rapidkit` compatibility documentation. For new projects, use
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 > **Date:** January 1, 2026  
 > **Implementation:** Dynamic module catalog fetching from Python Core
 
@@ -258,7 +262,7 @@ $ rapidkit ai recommend "blockchain integration"
    Try more general terms (e.g., "storage" instead of "blockchain")
 
 3. Request feature:
-   https://github.com/rapidkitlabs/rapidkit/issues
+   https://github.com/chistiq/rapidkit/issues
 ```
 
 ---

package/docs/AI_EXAMPLES.md

@@ -1,5 +1,9 @@
 # 🎯 AI Examples - Real-World Use Cases
 
+> [!NOTE]
+> Legacy `rapidkit` compatibility documentation. For new projects, use
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 Complete examples showing how to use RapidKit AI for different scenarios.
 
 ## 📱 Example 1: Building a Social Media App
@@ -416,4 +420,4 @@ npx rapidkit dev
 
 ---
 
-**Need help?** Open an issue: https://github.com/rapidkitlabs/rapidkit-npm/issues
+**Need help?** Open an issue: https://github.com/chistiq/rapidkit-npm/issues

package/docs/AI_FEATURES.md

@@ -1,5 +1,9 @@
 # 🤖 RapidKit AI Features
 
+> [!NOTE]
+> Legacy `rapidkit` compatibility documentation. For new projects, use
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 AI-powered module recommendations using OpenAI embeddings to help you build faster.
 
 ## 🚀 Quick Start
@@ -391,7 +395,7 @@ npx rapidkit config show
    ```
 
 3. **Report issue:**
-   - GitHub: https://github.com/rapidkitlabs/rapidkit-npm/issues
+   - GitHub: https://github.com/chistiq/rapidkit-npm/issues
    - Include: error message, OS, Node version, command used
 
 ## 📚 Commands Reference
@@ -457,4 +461,4 @@ MIT - See [LICENSE](../LICENSE)
 
 ---
 
-**Questions?** Open an issue on [GitHub](https://github.com/rapidkitlabs/rapidkit-npm/issues)
+**Questions?** Open an issue on [GitHub](https://github.com/chistiq/rapidkit-npm/issues)

package/docs/AI_QUICKSTART.md

@@ -1,5 +1,9 @@
 # 🚀 AI Features - Quick Start Guide
 
+> [!NOTE]
+> Legacy `rapidkit` compatibility documentation. For new projects, use
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 Get started with RapidKit AI recommendations in 60 seconds!
 
 ## Option 1: Zero-Config Start (Recommended) ⚡

package/docs/MIGRATING_TO_WORKSPAI.md

@@ -0,0 +1,139 @@
+# Migrating from RapidKit npm to Workspai
+
+This guide is for users who already run the legacy `rapidkit` npm CLI. New
+projects should begin directly with [Workspai](https://github.com/chistiq/workspai).
+
+## What changes
+
+| RapidKit compatibility surface | Workspai canonical surface |
+| --- | --- |
+| Package and command: `rapidkit` | Package and command: `workspai` |
+| Project/workspace metadata: `.rapidkit/**` | Canonical metadata: `.workspai/**` |
+| Managed workspaces: `~/rapidkit/workspaces/**` | Managed workspaces: `~/.workspai/workspaces/**` |
+| Legacy documentation in this repository | Current documentation at [workspai.dev](https://www.workspai.dev/) |
+
+Your source repository does not need to move. Workspai can adopt it in place
+and create the canonical metadata through supported commands.
+
+## Before migration
+
+1. Commit or back up the source project.
+2. Record the RapidKit workspace and project paths used by CI or scripts.
+3. Keep the existing `.rapidkit` metadata until the Workspai result has been
+   verified.
+4. Do not rename `.rapidkit` to `.workspai` manually.
+
+## One existing project
+
+Run from the project directory:
+
+```bash
+cd /path/to/your-project
+npx workspai adopt . --json
+```
+
+The JSON response reports the selected workspace and the next `cd` command. If
+no workspace is selected, Workspai creates or reuses:
+
+```text
+~/.workspai/workspaces/workspai
+```
+
+Move to that workspace and build current evidence:
+
+```bash
+cd ~/.workspai/workspaces/workspai
+npx workspai workspace intelligence run \
+  --for-agent generic \
+  --strict \
+  --json
+```
+
+The first run may report missing, stale, or blocking evidence. Follow the cited
+producer or source fix; do not edit generated reports to manufacture readiness.
+
+## Several projects in one system
+
+Create a named workspace:
+
+```bash
+npx workspai create workspace my-workspace --profile minimal --yes
+```
+
+Adopt each existing project without copying it:
+
+```bash
+cd /path/to/frontend
+npx workspai adopt . \
+  --workspace "$HOME/.workspai/workspaces/my-workspace" \
+  --name frontend
+
+cd /path/to/api
+npx workspai adopt . \
+  --workspace "$HOME/.workspai/workspaces/my-workspace" \
+  --name api
+```
+
+Then run the intelligence chain from
+`~/.workspai/workspaces/my-workspace`.
+
+## CI migration
+
+Replace the package and command first; keep the decision boundary explicit:
+
+```yaml
+- uses: actions/setup-node@v4
+  with:
+    node-version: '20.20.0'
+    cache: npm
+
+- run: npm ci
+- run: npx workspai workspace intelligence run --for-agent generic --strict --json
+```
+
+Archive the governed outputs your workflow consumes, especially:
+
+```text
+.workspai/workspace.contract.json
+.workspai/reports/INDEX.json
+.workspai/reports/workspace-intelligence-run-last-run.json
+.workspai/reports/workspace-context-agent.json
+```
+
+Do not silently rewrite a CI consumer from `.rapidkit` to `.workspai`; update it
+to the corresponding Workspai artifact contract and validate its schema.
+
+## Agent and IDE migration
+
+Run the canonical chain before asking an agent to reason across projects. The
+generated `AGENTS.md`, grounding, report index, bounded graph queries, and MCP
+surface give compatible agents a current evidence path without loading the
+complete workspace into every prompt.
+
+Use `--for-agent generic` for portable output. Select a specific target only
+when the consumer needs its native integration surface.
+
+## Verification checklist
+
+- The source projects remain at their original paths.
+- The Workspai workspace contract lists every intended project.
+- `.workspai/reports/INDEX.json` points to current artifacts.
+- The Workspace Model and Knowledge Graph come from the same current revision.
+- CI reads `.workspai` artifacts rather than renamed `.rapidkit` files.
+- Agent surfaces were regenerated from Workspai evidence.
+- Existing RapidKit automation remains available until the replacement path is
+  verified.
+
+## Rollback
+
+Adoption does not relocate source code. If migration validation fails, keep the
+existing RapidKit automation active, preserve the Workspai reports for
+diagnosis, and correct the Workspai workspace or CI configuration. Avoid
+deleting either metadata tree until the migration is accepted.
+
+## Current references
+
+- [Workspai CLI repository](https://github.com/chistiq/workspai)
+- [Workspai documentation](https://www.workspai.dev/)
+- [Workspai product](https://www.workspai.com/)
+- [RapidKit compatibility documentation](./README.md)

package/docs/OPEN_SOURCE_USER_SCENARIOS.md

@@ -1,5 +1,9 @@
 # RapidKit Practical User Scenarios (Open Source Edition)
 
+> [!NOTE]
+> Legacy `rapidkit` compatibility documentation. For new projects, use
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 Practical workflows for OSS teams using the npm CLI. Command syntax: [commands-reference.md](./commands-reference.md). Import/adopt details: [workspace-operations.md](./workspace-operations.md).
 
 ## Scenario 0 — Existing project (adopt or import)

package/docs/OPTIMIZATION_GUIDE.md

@@ -1,5 +1,9 @@
 # Optimization Guide
 
+> [!NOTE]
+> Legacy `rapidkit` compatibility documentation. For new projects, use
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 Optimization ideas for the RapidKit npm CLI codebase.
 
 **Users:** [../README.md](../README.md) · [OPEN_SOURCE_USER_SCENARIOS.md](./OPEN_SOURCE_USER_SCENARIOS.md) · [Documentation index](./README.md)

package/docs/README.md

@@ -1,6 +1,14 @@
-# RapidKit NPM — Documentation Index
+# RapidKit npm compatibility documentation
 
-Hub for user and contributor documentation. Start with the [main README](../README.md) for install and quickstarts.
+> [!IMPORTANT]
+> These documents describe the legacy `rapidkit` compatibility CLI and its
+> `.rapidkit` artifacts. New users and new integrations should use
+> [Workspai](https://github.com/chistiq/workspai) and the current documentation
+> at [workspai.dev](https://www.workspai.dev/).
+
+Use this index when maintaining an existing RapidKit installation or helping a
+team migrate safely. Start with the [main README](../README.md) and
+[migration guide](./MIGRATING_TO_WORKSPAI.md).
 
 ## Table of contents
 
@@ -15,6 +23,7 @@ Hub for user and contributor documentation. Start with the [main README](../READ
 
 | Document | Description |
 | --- | --- |
+| [MIGRATING_TO_WORKSPAI.md](./MIGRATING_TO_WORKSPAI.md) | Canonical package, workspace, CI, agent, and rollback migration path |
 | [commands-reference.md](./commands-reference.md) | Full CLI syntax, profiles, and policy keys |
 | [workspace-operations.md](./workspace-operations.md) | Import, adopt, snapshots, archives, contracts, infra |
 | [workspace-run.md](./workspace-run.md) | Polyglot fleet orchestration (`workspace run`) |
@@ -26,7 +35,7 @@ Hub for user and contributor documentation. Start with the [main README](../READ
 | [WORKSPACE_MARKER_SPEC.md](./WORKSPACE_MARKER_SPEC.md) | Workspace marker format |
 | [PACKAGE_MANAGER_POLICY.md](./PACKAGE_MANAGER_POLICY.md) | npm-only policy for this repository |
 
-**Common tasks**
+**Legacy maintenance tasks**
 
 - Adopt an existing repo: [workspace-operations.md#import-and-adoption](./workspace-operations.md#import-and-adoption)
 - Scaffold a frontend app: [commands-reference.md](./commands-reference.md) (`create project nextjs <name>`)

package/docs/UTILITIES.md

@@ -1,5 +1,9 @@
 # Utilities Documentation
 
+> [!NOTE]
+> Legacy `rapidkit` compatibility documentation. For new projects, use
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 Internal cache and performance helpers for the npm CLI codebase.
 
 **End-user commands:** [doctor-command.md](./doctor-command.md) · [OPEN_SOURCE_USER_SCENARIOS.md](./OPEN_SOURCE_USER_SCENARIOS.md) · [../README.md](../README.md)

package/docs/WORKSPACE_MARKER_SPEC.md

@@ -1,5 +1,10 @@
 # RapidKit Workspace Marker Specification
 
+> [!NOTE]
+> Legacy `.rapidkit` compatibility specification. New integrations should use
+> [Workspai](https://www.workspai.dev/) and canonical `.workspai` contracts. See
+> the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 ## Overview
 
 The `.rapidkit-workspace` file is the standardized marker that identifies a RapidKit workspace. It uses a **metadata layer architecture** that allows multiple tools (npm CLI, VS Code Extension, Python Core, etc.) to add their own metadata while preserving a consistent core structure.

package/docs/commands-reference.md

@@ -1,5 +1,10 @@
 # Commands Reference
 
+> [!NOTE]
+> This reference documents the legacy `rapidkit` compatibility command. New
+> scripts should use [Workspai](https://www.workspai.dev/). See the
+> [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 Complete CLI syntax for the RapidKit npm wrapper. For behavior and workflows, see [workspace-operations.md](./workspace-operations.md) and [OPEN_SOURCE_USER_SCENARIOS.md](./OPEN_SOURCE_USER_SCENARIOS.md).
 
 ## Workspace lifecycle

package/docs/config-file-guide.md

@@ -1,5 +1,9 @@
 # 📖 RapidKit Config File Guide
 
+> [!NOTE]
+> Legacy `rapidkit` compatibility documentation. For new projects, use
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 ## 🎯 Purpose of `rapidkit.config.js`
 
 The `rapidkit.config.js` file is an **optional configuration file** that allows you to define default settings for creating workspaces and projects.

package/docs/create-planner-capabilities.md

@@ -1,5 +1,10 @@
 # Create Planner Capabilities
 
+> [!NOTE]
+> This document preserves the legacy RapidKit planner contract for compatibility
+> consumers. New creation flows belong to [Workspai](https://www.workspai.dev/).
+> See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 RapidKit is a Workspace Intelligence platform, not a blind scaffold wrapper.
 The create planner separates project creation into three lanes so developers,
 CI, and AI agents share the same expectations.

package/docs/doctor-command.md

@@ -1,5 +1,10 @@
 # RapidKit Doctor Command
 
+> [!NOTE]
+> This page documents the legacy `rapidkit doctor` compatibility surface. New
+> projects should use [Workspai](https://www.workspai.dev/). See the
+> [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 `doctor` checks health for the npm wrapper environment in system, workspace, or project scope.
 
 **Related:** [workspace-operations.md](./workspace-operations.md) · [commands-reference.md](./commands-reference.md) · [Documentation index](./README.md)

package/docs/from-code-to-shared-understanding.md

@@ -1,5 +1,10 @@
 # From Code to Shared Understanding
 
+> [!NOTE]
+> Historical RapidKit architecture documentation retained for compatibility.
+> Current Workspace Intelligence architecture is maintained in
+> [Workspai](https://www.workspai.dev/). See the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 How RapidKit transforms projects and repositories into workspace intelligence for developers, CI, and AI agents.
 
 This Mermaid diagram is kept in the internal documentation because GitHub renders it correctly. The main npm README uses a PNG version of the same diagram so it remains visible on npm package pages.
@@ -43,4 +48,3 @@ flowchart TB
     Evidence --> CI
     Evidence --> Agents
 ```
-

package/docs/workspace-operations.md

@@ -1,5 +1,10 @@
 # Workspace Operations
 
+> [!NOTE]
+> This page documents legacy `.rapidkit` workspace operations. New workspaces
+> should use [Workspai](https://www.workspai.dev/) and `.workspai` contracts. See
+> the [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 Behavioral guide for import, adoption, snapshots, archives, contracts, collaboration bundles, and local infra sidecars.
 
 Command syntax: [commands-reference.md](./commands-reference.md).

package/docs/workspace-run.md

@@ -1,5 +1,10 @@
 # Workspace Run — Polyglot Fleet Orchestration
 
+> [!NOTE]
+> Legacy `rapidkit workspace run` compatibility documentation. New integrations
+> should use [Workspai](https://www.workspai.dev/). See the
+> [migration guide](./MIGRATING_TO_WORKSPAI.md).
+
 `workspace run` executes CI-safe stages (`init`, `test`, `build`, `start`) across discovered projects in a workspace. Command syntax is in [commands-reference.md](./commands-reference.md).
 
 ## Quick start

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "rapidkit",
-  "version": "0.42.1",
+  "version": "0.42.3",
   "type": "module",
-  "description": "Open-source workspace intelligence CLI for software systems: create, adopt, govern, verify, and align polyglot workspaces for humans, CI, IDEs, and AI agents.",
+  "description": "Legacy RapidKit npm compatibility CLI for existing users and migration to Workspai. New projects should use the workspai package.",
   "keywords": [
     "rapidkit",
     "workspai",
@@ -27,11 +27,15 @@
     "generator",
     "scaffold"
   ],
-  "author": "RapidKit Team",
+  "author": "Chistiq",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/rapidkitlabs/rapidkit-npm.git"
+    "url": "git+https://github.com/chistiq/rapidkit-npm.git"
+  },
+  "homepage": "https://www.getrapidkit.com/",
+  "bugs": {
+    "url": "https://github.com/chistiq/rapidkit-npm/issues"
   },
   "bin": {
     "rapidkit": "dist/index.js",
@@ -76,6 +80,7 @@
     "generate:contracts": "node scripts/generate-shared-contracts.mjs",
     "check:generated-contracts": "node scripts/generate-shared-contracts.mjs --check",
     "check:agent-customization-drift": "node scripts/check-agent-customization-drift.mjs",
+    "check:brand": "node scripts/check-brand-contract.mjs",
     "validate:contracts": "npm run check:shared-contracts && vitest run src/__tests__/contracts/",
     "test:parity-contract": "npm run check:shared-contracts && vitest run src/__tests__/contracts/import-stack-parity.snapshot.test.ts",
     "test:watch": "vitest",
@@ -96,7 +101,7 @@
     "format": "prettier --write \"src/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\"",
     "typecheck": "tsc --noEmit",
-    "validate": "npm run typecheck && npm run lint && npm run format:check && npm test",
+    "validate": "npm run check:brand && npm run typecheck && npm run lint && npm run format:check && npm test",
     "security": "npm audit --audit-level=moderate",
     "security:fix": "npm audit fix",
     "metrics": "npx tsx scripts/metrics.ts",
@@ -113,7 +118,7 @@
     "analyze": "npm run build && node scripts/analyze-dist.mjs",
     "size-check": "npm run build && size-limit",
     "bench": "npx tsx scripts/benchmarks.ts",
-    "quality": "npm run typecheck && npm run lint && npm run format:check && npm test && npm run size-check && npm run security && npm run validate:docs && npm run smoke:frontend-generators && npm run check:contracts && npm run check:shared-contracts && npm run check:parity-snapshot && npm run check:agent-customization-drift",
+    "quality": "npm run check:brand && npm run typecheck && npm run lint && npm run format:check && npm test && npm run size-check && npm run security && npm run validate:docs && npm run smoke:frontend-generators && npm run check:contracts && npm run check:shared-contracts && npm run check:parity-snapshot && npm run check:agent-customization-drift",
     "act-matrix": "act -P ubuntu-latest=ghcr.io/catthehacker/ubuntu:act-22.04 -P macos-latest=ghcr.io/catthehacker/ubuntu:act-22.04 -P windows-latest=ghcr.io/catthehacker/ubuntu:act-22.04 --pull=false -j build-test-matrix",
     "release:dry": "bash scripts/release.sh --no-publish --yes --allow-dirty",
     "release:patch": "bash scripts/release.sh patch",

package/templates/kits/fastapi-ddd/README.md.j2

@@ -1,11 +1,11 @@
 # {{ project_name }}
 
-Domain-driven FastAPI service generated with [RapidKit](https://github.com/rapidkitlabs/rapidkit-core).
+Domain-driven FastAPI service generated with [RapidKit Core](https://github.com/chistiq/rapidkit-core). It can be adopted into Workspai workspace intelligence when you want workspace-level context, evidence, and release governance.
 
 ## Quick start
 
 ```bash
-# Load the project-aware RapidKit CLI (adds .rapidkit/rapidkit to PATH)
+# Load the project-local RapidKit Core launcher (adds .rapidkit/rapidkit to PATH)
 source .rapidkit/activate
 
 # Bootstrap dependencies (creates .venv + installs Poetry deps)
@@ -22,7 +22,7 @@ make test
 # Run the service
 make dev
 
-# Use the RapidKit CLI helpers when you prefer auto-detected environments
+# Use RapidKit Core helpers when you prefer auto-detected environments
 rapidkit dev
 rapidkit lint
 rapidkit test
@@ -37,7 +37,7 @@ make audit
 
 > Lockfiles are generated automatically during scaffolding. Set `RAPIDKIT_SKIP_LOCKS=1` (or `RAPIDKIT_GENERATE_LOCKS=0`) before running `rapidkit create` if you want to skip the lockfile attempt.
 
-> Need to see every RapidKit CLI command? Run `rapidkit --help` or check the CLI reference in the docs for the full catalog.
+> Need to see every project-local RapidKit Core command? Run `rapidkit --help`. If this project is part of a Workspai workspace, run `npx workspai --help` from the workspace root for workspace intelligence commands.
 
 ## Project structure
 
@@ -99,7 +99,7 @@ health endpoint and the application factory.
 
 ## Local development
 
-- `rapidkit init` bootstraps dependencies via the project-local CLI (run it after sourcing `.rapidkit/activate`).
+- `rapidkit init` bootstraps dependencies via the project-local RapidKit Core launcher (run it after sourcing `.rapidkit/activate`).
 - `make init` is an optional alias for `rapidkit init` when you prefer Make targets.
 - `make install` re-runs `rapidkit init` unless `SKIP_INIT=1` is set and refreshes developer tooling such as pre-commit hooks.
 - `./bootstrap.sh` copies `.env.example` to `.env` (when missing) and runs `SKIP_INIT=1 make install` for you.
@@ -107,7 +107,7 @@ health endpoint and the application factory.
 - `make lint`, `make typecheck`, and `make test` (or `rapidkit lint` / `rapidkit test`) are thin wrappers around Ruff, mypy, and pytest for consistent CI parity.
 - `make audit` runs `pip-audit` and `npm audit` to surface vulnerable dependencies early.
 
-Pre-commit is configured with Ruff, Black, mypy, and hygiene hooks; `./bootstrap.sh` installs them automatically (or run `SKIP_INIT=1 make install`). Use the RapidKit CLI variants when you need it to auto-discover the right virtual environment inside automation scripts.
+Pre-commit is configured with Ruff, Black, mypy, and hygiene hooks; `./bootstrap.sh` installs them automatically (or run `SKIP_INIT=1 make install`). Use the RapidKit Core variants when you need them to auto-discover the right virtual environment inside automation scripts.
 
 <!-- <<<inject:module-snippet>>> -->
 

package/templates/kits/fastapi-ddd/pyproject.toml.j2

@@ -17,21 +17,21 @@ help = "src.cli:help_cmd"
 
 [tool.poetry.dependencies]
 python = "^{{ python_version }}"
-fastapi = "^0.128.0"
-uvicorn = { extras = ["standard"], version = "^0.40.0" }
+fastapi = "^0.139.0"
+uvicorn = { extras = ["standard"], version = "^0.50.2" }
 pydantic = "^2.12.5"
 {% if has_settings -%}
-pydantic-settings = { version = "^2.12.0", extras = ["yaml"] }
+pydantic-settings = { version = "^2.14.2", extras = ["yaml"] }
 {% endif %}
 # <<<inject:poetry-dependencies>>>
 
 [tool.poetry.group.dev.dependencies]
-pytest = "^9.0.2"
+pytest = "^9.0.3"
 pytest-asyncio = "^1.3.0"
 pytest-cov = "^7.0.0"
 httpx = "^0.28.1"
 ruff = "^0.14.10"
-black = "^25.12.0"
+black = "^26.3.1"
 isort = "^7.0.0"
 mypy = "^1.19.1"
 build = "^1.3.0"

package/templates/kits/fastapi-ddd/src/cli.py.j2

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """Project CLI wrapper for {{ project_name }} (DDD edition).
 
-Prefer a per-project CLI in `.rapidkit/cli.py` when present. Otherwise
+Prefer a per-project RapidKit Core wrapper in `.rapidkit/cli.py` when present. Otherwise
 provide helpful guidance to the developer rather than guessing environment
 details.
 """
@@ -14,7 +14,7 @@ from typing import Optional
 
 
 def _missing_cli(name: str) -> None:
-    print(f"❌ Missing project-local CLI (.rapidkit/cli.py) - can't run '{name}'")
+    print(f"❌ Missing project-local RapidKit Core wrapper (.rapidkit/cli.py) - can't run '{name}'")
     print("💡 If you're a new user run: rapidkit init  # create venv + install deps")
     sys.exit(127)
 
@@ -35,7 +35,7 @@ def _load_project_cli_module() -> Optional[object]:
 _mod = _load_project_cli_module()
 
 
-# Default placeholders -- call `_missing_cli` if the project-local CLI isn't
+# Default placeholders -- call `_missing_cli` if the project-local RapidKit Core wrapper isn't
 # available. These are real functions so linters don't complain.
 def init() -> None:
     _missing_cli("init")