workspai 0.49.0 → 0.50.0

package/README.md

@@ -81,19 +81,27 @@ npx workspai adopt .
 ```
 
 `adopt` registers the project without moving or copying it. When run outside a
-workspace, it creates or reuses the minimal default workspace and prints the
-exact `Next shell step`.
+workspace, it creates or reuses the minimal default workspace and binds the
+project to it.
 
-### 3. Continue from the workspace root
+### 3. Continue from the project
 
-Without the VS Code extension, copy the printed `Next shell step` and continue
-in that workspace terminal:
+The project is now a first-class entry point into its Workspai workspace. Stay
+in the project directory and run:
 
 ```bash
-cd ~/.workspai/workspaces/workspai
+npx workspai project workspace status --json
 npx workspai workspace intelligence run --for-agent generic --strict --json
 ```
 
+Workspai resolves the canonical workspace through a validated machine-local
+link. That link is gitignored; portable project grounding and bounded agent
+context are written under the project's `.workspai/` directory. The project
+lens carries bounded topology, related projects, API/deployment/test surfaces,
+current blockers, proof paths, and model/graph freshness without copying the
+full workspace graph. You only need `--workspace <path>` when resolving an
+ambiguous or moved binding.
+
 `generic` creates vendor-neutral context. Use `codex`, `claude`, `cursor`, or
 `orca` when you want context shaped for that agent. Agent Sync also writes the
 shared files used by GitHub Copilot, VS Code, and `AGENTS.md` consumers without
@@ -117,6 +125,16 @@ The run saves its results so people and tools can inspect and reuse them:
 AGENTS.md
 ```
 
+Each registered project also receives:
+
+```text
+.workspai/
+├── workspace-link.local.json        # machine-local, gitignored
+├── PROJECT-GROUNDING.md             # portable entry guide
+└── reports/project-context-agent.json
+AGENTS.md                             # existing content preserved
+```
+
 For automation details, including exit codes and blocked results, see the
 [Unified runner guide](docs/workspace-intelligence-runner.md). A blocked result
 is useful evidence, not a crashed command.
@@ -135,6 +153,27 @@ cd ~/.workspai/workspaces/my-workspace
 npx workspai create project nextjs web --yes
 ```
 
+The project picker is organized by **Backend**, **Frontend**, **Desktop**, and
+**Extension**. In addition to the existing web and service starters, Workspai
+can create Axum, Tauri, Electron, VS Code extension, and Laravel projects:
+
+```bash
+npx workspai create project rust.axum api
+npx workspai create project desktop.tauri desktop-app
+npx workspai create project desktop.electron admin-console
+npx workspai create project extension.vscode editor-tools
+npx workspai create project php.laravel web-api
+```
+
+Axum is a deterministic Workspai-owned baseline. Tauri, Electron, VS Code, and
+Laravel use their ecosystem generator, after which Workspai writes canonical
+project metadata and joins the project to the same Model, Doctor, Graph, and
+agent-context pipeline. All available official generators request their latest
+stable channel, enforce Node engine compatibility, check required local
+toolchains, and record that policy in project evidence. Frontend remains a
+first-class project category rather than being folded into a generic Node
+project.
+
 From the `my-workspace` terminal, create a project, use `adopt` to link one in
 place, or use `import` to copy or clone one into the workspace. See
 [Creating Workspaces and Projects](docs/creating-workspaces-and-projects.md)
@@ -151,18 +190,16 @@ Workspai is the deterministic layer between source code and its consumers:
 ```text
 Code · packages · APIs · infrastructure · docs · CI · policies
                               │
-                   deterministic providers
-                              │
-                       facts + proofs
+             registration · detection · contract reconciliation
                               │
                   Canonical Workspace Model
-                       │              │
-                       │              └── Evidence-backed Knowledge Graph
-                       │                         │
-                       └──────────┬──────────────┘
-                                  │
+                              │
+               bounded providers · facts · proofs
+                              │
+               Evidence-backed Knowledge Graph
+                              │
                 diff · impact · verify · context · explain
-                                  │
+                              │
                Developers · CI · IDEs · MCP · AI agents
 ```
 
@@ -171,6 +208,7 @@ Code · packages · APIs · infrastructure · docs · CI · policies
 | **Model**             | What projects, runtimes, frameworks, commands, policies, contracts, and dependencies exist? |
 | **Snapshot and diff** | What changed between two known workspace states?                                            |
 | **Impact**            | Which projects and transitive dependents are affected?                                      |
+| **Doctor**            | Which runtime check failed, what graph evidence is related, and what should verify the fix? |
 | **Evidence**          | What do health, analysis, contracts, and readiness reports prove?                           |
 | **Verify**            | Is the affected workspace ready, blocked, stale, or missing evidence?                       |
 | **Context**           | What should developers, IDEs, and AI agents know before acting?                             |
@@ -285,6 +323,8 @@ reruns.
 | What you need                        | Command                                                                       |
 | ------------------------------------ | ----------------------------------------------------------------------------- |
 | Run affected project tests           | `npx workspai workspace run test --affected --blast-radius --json`            |
+| Measure one project's test coverage  | `npx workspai project coverage --run --target 80 --strict --json`             |
+| Diagnose one project                 | `npx workspai doctor project --json`                                          |
 | Run the release/governance gate      | `npx workspai pipeline --json --strict`                                       |
 | Run the canonical intelligence chain | `npx workspai workspace intelligence run --for-agent generic --strict --json` |
 
@@ -296,7 +336,7 @@ Other useful operational commands:
 
 ```bash
 npx workspai doctor workspace
-npx workspai setup <python|node|go|java|dotnet> [--warm-deps]
+npx workspai setup <python|node|go|java|dotnet|rust|php> [--warm-deps]
 npx workspai workspace list
 npx workspai cache <status|clear|prune|repair>
 npx workspai mirror <status|sync|verify|rotate>
@@ -328,6 +368,12 @@ developers, CI, IDEs, and agents reason over the same blast radius.
 
 ### Ground AI tools
 
+Workspai creates the initial model, graph, context, `AGENTS.md`, report index,
+skills, and supported agent/IDE files with the workspace. It refreshes them
+after successful project creation, adoption, import, or workspace connection.
+Run Agent Sync directly only when you want an explicit refresh or different
+targets/preset:
+
 ```bash
 npx workspai workspace agent-sync \
   --write \
@@ -346,6 +392,15 @@ and reproducible token-efficiency methodology, see the
 [Workspace Knowledge Graph guide](docs/workspace-knowledge-graph.md) and
 [Graph Benchmark Methodology](docs/graph-benchmark-methodology.md).
 
+The integrated CLI has one canonical direction: **Workspace Model → Knowledge
+Graph**. The model owns the workspace boundary and compact project topology;
+bounded providers enrich that inventory into proof-backed cross-domain
+relationships without writing back into the model. Both artifacts are published
+under one lock with rollback, and the graph contract fixes its source to
+`.workspai/reports/workspace-model.json` plus the model's stable structural
+SHA-256. Doctor, Context, MCP, and graph streaming reject a mismatched persisted
+graph.
+
 ## Outputs and Consumers
 
 Workspai separates human output, machine output, and durable cross-tool state:
@@ -399,18 +454,23 @@ tools without changing the source of truth:
 
 All onboarding routes feed the same Workspace Intelligence model.
 
-| Route            | Use it when                                       | Example                                                                                                  |
-| ---------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
-| Adopt            | Existing source should stay in place              | `npx workspai adopt /path/to/project --json`                                                             |
-| Import local     | Existing source should be copied into a workspace | `npx workspai import ../orders-api --workspace /path/to/workspace --json`                                |
-| Import Git       | A repository should be cloned into a workspace    | `npx workspai import https://github.com/acme/orders-api.git --git --workspace /path/to/workspace --json` |
-| Create workspace | You need a new governed boundary                  | `npx workspai create workspace my-workspace --profile polyglot --yes`                                    |
-| Create project   | You need a supported new scaffold                 | `npx workspai create project nextjs web --yes`                                                           |
-| Interactive      | You want Workspai to guide the choice             | `npx workspai create`                                                                                    |
-
-Adopt never moves or copies source. Create can use a Workspai-managed kit or an
-available official ecosystem generator. Unsupported native create requests are
-directed toward official tooling followed by adoption.
+| Route             | Use it when                                       | Example                                                                                                  |
+| ----------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| Adopt             | Existing source should stay in place              | `npx workspai adopt /path/to/project --json`                                                             |
+| Import local      | Existing source should be copied into a workspace | `npx workspai import ../orders-api --workspace /path/to/workspace --json`                                |
+| Import Git        | A repository should be cloned into a workspace    | `npx workspai import https://github.com/acme/orders-api.git --git --workspace /path/to/workspace --json` |
+| Connect workspace | An existing workspace should stay in place        | `npx workspai workspace connect /path/to/workspace --json`                                               |
+| Import workspace  | A portable workspace archive should become active | `npx workspai workspace import team.workspai-archive.zip --output ./team --json`                         |
+| Create workspace  | You need a new governed boundary                  | `npx workspai create workspace my-workspace --profile polyglot --yes`                                    |
+| Create project    | You need a supported new scaffold                 | `npx workspai create project nextjs web --yes`                                                           |
+| Interactive       | You want Workspai to guide the choice             | `npx workspai create`                                                                                    |
+
+Adopt and workspace connect never move or copy source. Project import copies or
+clones; workspace import verifies and materializes a portable archive before
+registration. `workspace hydrate` only extracts an archive and intentionally
+does not register it. Create can use a Workspai-managed kit or an available
+official ecosystem generator. Unsupported native create requests are directed
+toward official tooling followed by adoption.
 
 Detailed onboarding behavior:
 

package/contracts/analyze-last-run.v1.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/analyze-last-run.v1.json",
-  "title": "RapidKit Analyze Last Run Evidence",
+  "$id": "https://workspai.dev/schemas/analyze-last-run.v1.json",
+  "title": "Workspai Analyze Last Run Evidence",
   "type": "object",
   "required": [
     "schemaVersion",

package/contracts/artifact-remediation-plan.v1.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://rapidkit.dev/contracts/artifact-remediation-plan.v1.json",
-  "title": "RapidKit Artifact Remediation Plan",
+  "$id": "https://workspai.dev/contracts/artifact-remediation-plan.v1.json",
+  "title": "Workspai Artifact Remediation Plan",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "generatedAt", "workspace", "source", "summary", "actions"],
@@ -35,13 +35,7 @@
     "summary": {
       "type": "object",
       "additionalProperties": false,
-      "required": [
-        "artifactsScanned",
-        "cardsCovered",
-        "totalActions",
-        "executableActions",
-        "risk"
-      ],
+      "required": ["artifactsScanned", "cardsCovered", "totalActions", "executableActions", "risk"],
       "properties": {
         "artifactsScanned": { "type": "integer", "minimum": 0 },
         "cardsCovered": { "type": "integer", "minimum": 0 },

package/contracts/autopilot-release.v1.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/autopilot-release.v1.json",
+  "title": "Workspai Autopilot Release Evidence",
   "type": "object",
   "required": [
     "schemaVersion",

package/contracts/bootstrap-compliance.v1.json

@@ -1,6 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/bootstrap-compliance.v1.json",
+  "$id": "https://workspai.dev/schemas/bootstrap-compliance.v1.json",
+  "title": "Workspai Bootstrap Compliance Evidence",
   "type": "object",
   "required": ["schemaVersion", "command", "timestamp", "result", "checks"],
   "properties": {

package/contracts/cli-log-event.v1.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/cli-log-event.v1.json",
+  "$id": "https://workspai.dev/schemas/cli-log-event.v1.json",
   "title": "Workspai CLI Log Event",
   "description": "NDJSON stream events emitted on stderr when RAPIDKIT_LOG_FORMAT=json or --log-format json",
   "type": "object",

package/contracts/cli-runtime-command-inventory.v1.snapshot.json

@@ -31,6 +31,10 @@
           "flags": "--enable-modules",
           "attributeName": "enableModules"
         },
+        {
+          "flags": "--project-grounding <mode>",
+          "attributeName": "projectGrounding"
+        },
         {
           "flags": "--dry-run",
           "attributeName": "dryRun"
@@ -432,6 +436,10 @@
           "flags": "--enable-modules",
           "attributeName": "enableModules"
         },
+        {
+          "flags": "--project-grounding <mode>",
+          "attributeName": "projectGrounding"
+        },
         {
           "flags": "--git",
           "attributeName": "git"
@@ -836,6 +844,41 @@
         }
       ]
     },
+    {
+      "path": [
+        "project",
+        "coverage"
+      ],
+      "command": "coverage",
+      "parent": "project",
+      "registrationKind": "commander",
+      "aliases": [],
+      "description": "Inspect or run runtime-native test coverage and publish normalized project evidence",
+      "hidden": false,
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--project <path>",
+          "attributeName": "project"
+        },
+        {
+          "flags": "--target <percent>",
+          "attributeName": "target"
+        },
+        {
+          "flags": "--run",
+          "attributeName": "run"
+        },
+        {
+          "flags": "--strict",
+          "attributeName": "strict"
+        },
+        {
+          "flags": "--json",
+          "attributeName": "json"
+        }
+      ]
+    },
     {
       "path": [
         "project",
@@ -926,6 +969,39 @@
         }
       ]
     },
+    {
+      "path": [
+        "project",
+        "workspace"
+      ],
+      "command": "workspace",
+      "parent": "project",
+      "registrationKind": "commander",
+      "aliases": [],
+      "description": "Show or repair the canonical workspace binding for the current Workspai project",
+      "hidden": false,
+      "arguments": [
+        {
+          "name": "action",
+          "required": false,
+          "variadic": false
+        }
+      ],
+      "options": [
+        {
+          "flags": "--workspace <path>",
+          "attributeName": "workspace"
+        },
+        {
+          "flags": "--project <path>",
+          "attributeName": "project"
+        },
+        {
+          "flags": "--json",
+          "attributeName": "json"
+        }
+      ]
+    },
     {
       "path": [
         "readiness"
@@ -1240,6 +1316,10 @@
           "flags": "--preset <preset>",
           "attributeName": "preset"
         },
+        {
+          "flags": "--project-grounding <mode>",
+          "attributeName": "projectGrounding"
+        },
         {
           "flags": "--refresh-context",
           "attributeName": "refreshContext"

package/contracts/compatibility-matrix.v1.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/compatibility-matrix.v1.json",
+  "title": "Workspai Compatibility Matrix",
   "type": "object",
   "required": [
     "schemaVersion",