workspai 0.48.0 → 0.49.0

package/docs/workspace-operations.md

@@ -1,6 +1,8 @@
 # Workspace Operations
 
-Behavioral guide for import, adoption, snapshots, archives, contracts, collaboration bundles, and local infra sidecars.
+Use this guide to bring existing software into Workspai, move or share workspace
+state safely, and manage supporting local services. It explains what each
+operation changes before you run it.
 
 Command syntax: [commands-reference.md](./commands-reference.md).
 
@@ -8,8 +10,11 @@ Command syntax: [commands-reference.md](./commands-reference.md).
 
 Use `import` to copy or clone an existing project into a Workspai workspace.
 Use `adopt` when the project must stay where it already lives but should become
-visible to Workspai Workspace Intelligence. Core module commands remain limited
-to projects whose existing RapidKit metadata identifies a module-enabled kit.
+visible to Workspai. In both cases, the project becomes part of the shared
+system map, checks, and AI context.
+
+RapidKit Core module commands remain available only when existing project
+metadata identifies a kit that supports modules.
 
 ```bash
 npx workspai import ../orders-api
@@ -24,7 +29,8 @@ npx workspai adopt --json
 - Local folders are copied; git sources are cloned with shallow history.
 - Outside any workspace (no `--workspace`), Workspai creates or reuses the managed `workspai` workspace. New defaults use `~/.workspai/workspaces/workspai`; valid legacy candidates under `~/rapidkit/workspaces/workspai` and `~/Workspai/rapidkits/workspai` can still be reused.
 - Existing workspaces under legacy managed roots remain registered after upgrade.
-- CLI prints a next-step `cd ...` hint (`suggestedCdCommand` in JSON mode).
+- CLI prints the exact next `cd ...` step. JSON mode returns the same value as
+  `suggestedCdCommand`.
 - Failed workspace sync rolls back imported files and registry entries.
 
 ### Adopt behavior
@@ -38,7 +44,9 @@ npx workspai adopt --json
 ### JSON output (`--json`)
 
 - Import returns `workspacePath`, `workspaceResolution`, `defaultWorkspaceCreated`, `suggestedCdCommand`, and `importedProject`. The imported project includes its `source`.
-- Adopt returns `workspacePath`, `workspaceResolution`, `defaultWorkspaceCreated`, `wouldCreateDefaultWorkspace`, `dryRun`, and `adoptedProject`.
+- Adopt returns `workspacePath`, `workspaceResolution`,
+  `defaultWorkspaceCreated`, `wouldCreateDefaultWorkspace`,
+  `suggestedCdCommand`, `dryRun`, and `adoptedProject`.
 - Project results include detected `name`, `path`, `stack`, `runtime`, `framework`, `supportTier`, `moduleSupport`, and `confidence` where available.
 
 Imported projects receive `.workspai/import-readiness.json`. Adopted projects add frontend-aware detection for Next.js, React, Vite, Vue, Angular, SvelteKit, Nuxt, Astro, Remix, and Solid.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workspai",
-  "version": "0.48.0",
+  "version": "0.49.0",
   "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.",
   "keywords": [
@@ -35,13 +35,17 @@
     "generator",
     "scaffold"
   ],
-  "author": "RapidKit Labs",
+  "author": "Chistiq",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/rapidkitlabs/workspai.git",
+    "url": "git+https://github.com/chistiq/workspai.git",
     "directory": "packages/cli"
   },
+  "homepage": "https://www.workspai.com/",
+  "bugs": {
+    "url": "https://github.com/chistiq/workspai/issues"
+  },
   "bin": {
     "workspai": "dist/index.js"
   },
@@ -117,10 +121,11 @@
     "security:fix": "corepack npm audit fix",
     "metrics": "tsx scripts/metrics.ts",
     "validate:docs-examples": "node scripts/validate-doc-examples.mjs",
+    "check:github-release-notes": "node scripts/github-release-notes.mjs --check",
     "check:markdown-links": "node scripts/check-markdown-links.mjs",
     "check:docs-drift": "node scripts/docs-drift-guard.mjs",
     "smoke:readme": "node scripts/smoke-readme-commands.mjs",
-    "validate:docs": "corepack npm run check:markdown-links && corepack npm run check:docs-drift && corepack npm run validate:docs-examples && corepack npm run smoke:readme",
+    "validate:docs": "corepack npm run check:markdown-links && corepack npm run check:docs-drift && corepack npm run validate:docs-examples && corepack npm run check:github-release-notes && corepack npm run smoke:readme",
     "smoke:frontend-generators": "tsup && node scripts/smoke-frontend-generators.mjs",
     "smoke:frontend-generators:network": "tsup && node scripts/smoke-frontend-generators.mjs --execute",
     "sync:contracts": "node scripts/sync-contracts.mjs",

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

@@ -1,6 +1,6 @@
 # {{ project_name }}
 
-Domain-driven FastAPI service generated with [RapidKit Core](https://github.com/rapidkitlabs/rapidkit-core). It can be adopted into Workspai workspace intelligence when you want workspace-level context, evidence, and release governance.
+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
 

package/dist/autopilot-release-XGVXPOZI.js

@@ -1 +0,0 @@
-export{b as AUTOPILOT_RELEASE_ALIAS_FILENAME,a as AUTOPILOT_RELEASE_LAST_RUN_FILENAME,c as runAutopilotRelease}from'./chunk-5S3DJQEP.js';

package/dist/workspace-run-RLIYSOTN.js

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

package/dist/workspace-watch-3BPGLFLB.js

@@ -1 +0,0 @@
-import {a}from'./chunk-PRTR2DQ2.js';import {m as m$1}from'./chunk-37CVKXBD.js';import {b as b$1}from'./chunk-J5ENLXDF.js';import {a as a$1}from'./chunk-KB44JP4M.js';import P from'fs';var w="workspace-watch-event.v1";function b(t){return a$1(t,"contracts/workspace-watch-event.v1.json","Workspace watch event"),t}function g(t){return `${t.from}\0${t.to}\0${t.kind}`}function f(t){return (t.graph?.edges??[]).map(r=>({from:r.from,to:r.to,kind:r.kind}))}function m(t){let o=[...a(t).entries()].sort((a,n)=>a[0].localeCompare(n[0])).map(([a,n])=>({id:a,hash:n})),c=f(t).map(g).sort((a,n)=>a.localeCompare(n));return b$1({projects:o,edges:c})}function R(t,r){let o=a(r),c=t?a(t):new Map,a$1=[],n=[];for(let[e,s]of o.entries())c.has(e)?c.get(e)!==s&&a$1.push(e):n.push(e);let d=[];for(let e of c.keys())o.has(e)||d.push(e);let i=new Map(t?f(t).map(e=>[g(e),e]):[]),l=new Map(f(r).map(e=>[g(e),e])),p=[];for(let[e,s]of l.entries())i.has(e)||p.push(s);let h=[];for(let[e,s]of i.entries())l.has(e)||h.push(s);let u=(e,s)=>g(e).localeCompare(g(s));return a$1.sort((e,s)=>e.localeCompare(s)),n.sort((e,s)=>e.localeCompare(s)),d.sort((e,s)=>e.localeCompare(s)),p.sort(u),h.sort(u),{changedProjects:a$1,addedProjects:n,removedProjects:d,edgesAdded:p,edgesRemoved:h}}var k=class{model=null;sequence=0;rebuild;now;constructor(r,o){this.rebuild=o?.rebuild??(()=>m$1({...r})),this.now=o?.now??(()=>new Date);}get currentModel(){return this.model}async start(){let r=Date.now(),{model:o}=await this.rebuild();return this.model=o,this.buildEvent("ready","initial",null,o,Date.now()-r)}async pulse(){let r=Date.now(),o=this.model,{model:c,mode:a}=await this.rebuild(),n=this.buildEvent(this.hasStructuralChange(o,c)?"changed":"unchanged",a,o,c,Date.now()-r);return this.model=c,n}hasStructuralChange(r,o){return r?m(r)!==m(o):true}buildEvent(r,o,c,a,n){let d=R(c,a),i=m(a),l=c?m(c)!==i:true;return b({schemaVersion:w,kind:r,sequence:this.sequence++,timestamp:this.now().toISOString(),mode:o,modelHash:i,modelHashChanged:l,changedProjects:d.changedProjects,addedProjects:d.addedProjects,removedProjects:d.removedProjects,graph:{nodeCount:a.graph?.nodes.length??0,edgeCount:a.graph?.edges.length??0,edgesAdded:d.edgesAdded,edgesRemoved:d.edgesRemoved},durationMs:n})}},C=new Set([".git",".hg",".svn","node_modules",".venv","venv","dist","build","out","target","coverage","htmlcov",".next",".turbo",".cache"]),y=new Set(["reports","cache","tmp",".cache"]);function S(t){if(!t)return  false;let r=t.split(/[\\/]/).filter(Boolean);if(r.some(o=>C.has(o)))return  false;for(let o=0;o<r.length-1;o+=1)if((r[o]===".workspai"||r[o]===".rapidkit")&&y.has(r[o+1]))return  false;return  true}async function I(t){let r=new k(t.buildOptions,t.engineOptions),o=await r.start();if(t.emit(o),t.once)return;let c=t.debounceMs??250,a=t.selfWriteSuppressionMs??Math.max(400,c+150),n=null,d=false,i=false,l=0,p=async()=>{if(d){i=true;return}d=true;try{let e=await r.pulse();t.emit(e);}catch(e){t.emit(b({schemaVersion:w,kind:"error",sequence:-1,timestamp:new Date().toISOString(),mode:"full",modelHash:r.currentModel?m(r.currentModel):"",modelHashChanged:false,changedProjects:[],addedProjects:[],removedProjects:[],graph:{nodeCount:0,edgeCount:0,edgesAdded:[],edgesRemoved:[]},durationMs:0,error:e instanceof Error?e.message:String(e)}));}finally{d=false,l=Date.now()+a,i&&(i=false,p());}},h=e=>{S(e)&&(d||Date.now()<l||(n&&clearTimeout(n),n=setTimeout(()=>{n=null,p();},c)));};t.onProgress?.(`Watching ${t.workspacePath} for changes (Ctrl+C to stop).`);let u=P.watch(t.workspacePath,{recursive:true},(e,s)=>{typeof s=="string"?h(s):s&&h(Buffer.from(s).toString("utf8"));});await new Promise(e=>{let s=()=>{n&&clearTimeout(n),u.close(),e();};if(t.signal){if(t.signal.aborted){s();return}t.signal.addEventListener("abort",s,{once:true});}u.on("error",()=>s());});}export{w as WORKSPACE_WATCH_EVENT_SCHEMA_VERSION,k as WorkspaceWatchEngine,m as computeWatchModelHash,R as diffWatchModels,S as isWatchRelevantPath,I as runWorkspaceWatch};