workspai 0.61.0 → 0.63.0

package/README.md

@@ -38,7 +38,7 @@ Here is what you get:
 | **Health & Readiness** | Doctor checks, verification gates, and release posture based on evidence, not guesses |
 | **Agent Context** | Bounded, focused instructions so AI tools read what they need, not the entire repo |
 | **Agent Rules** | Ready-to-use grounding for Cursor, Copilot, Claude, Codex, Gemini, and more |
-| **Agent Skills** | Dynamic, project-aware operational skills (diagnose, repair, release) generated from real workspace state |
+| **Agent Skills** | Runtime-, polyglot-, test-, and delivery-aware operational playbooks, with portable `SKILL.md` projections where the host supports Agent Skills |
 | **MCP Server** | 14 read-oriented tools so MCP clients can query evidence, graph, blockers, and context live |
 
 `generic` is the safe default when you do not yet know which agent will use the
@@ -63,7 +63,9 @@ your-workspace/                              # ── Workspace level ──
 │   │   ├── INDEX.json                       # evidence inventory & read order
 │   │   └── ...                              # impact, doctor, analyze, explain, etc.
 │   └── skills/                              # generated operational skills
-│       └── workspai-*.md                    # diagnose, upgrade, release, etc.
+│       ├── workspai-release-readiness.md     # always available
+│       ├── workspai-node-runtime-validation.md  # only when Node is detected
+│       └── workspai-polyglot-change-validation.md # only for multi-runtime workspaces
 │
 │  # Workspace-level agent grounding (per host):
 ├── AGENTS.md · CLAUDE.md · GEMINI.md · QWEN.md
@@ -87,9 +89,9 @@ your-workspace/                              # ── Workspace level ──
 └── summit-web/                              # (same structure per project)
 ```
 
-Your agent reads `workspace-context-agent.json` at the workspace level for system-wide
-awareness, then `agent-entry.v1.json` at the project level for scoped context. Two reads
-instead of scanning thousands of files.
+Your agent starts with `agent-entry.v1.json`, compact workspace context, and the Skills
+index; it then retrieves only task-scoped Graph evidence and targeted source. No broad
+scan or complete Graph load is needed for ordinary work.
 
 ![Workspai CLI adopting and analyzing the gRPC repository](https://raw.githubusercontent.com/chistiq/workspai/main/packages/cli/docs/workspai-grpc-readme-cli.gif)
 

package/contracts/studio-card-repair-capabilities.v1.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "workspai.studio-card-repair-capabilities.v1",
-  "invariant": "A card repair starts with its declared repairPolicy but every unresolved policy path transfers to governed causal source repair. It closes only after its exact producer refreshes, its selected causal action set is absent, and aggregate Workspace Verify completes without an execution failure. Unrelated workspace blockers are reported separately and do not reopen the selected card.",
+  "invariant": "An aggregate card is a presentation boundary, never a mutation boundary. Blocking findings form a deterministic sequential causal queue; each CLI transaction owns exactly one causal finding family and one canonical project unless declared dependencies require a bounded cross-project closure. Advisory and informational findings never widen that queue. A card repair starts with its declared repairPolicy but every unresolved policy path transfers to governed causal source repair. After each exact target closes, fresh evidence selects the next target. The card closes only after its exact producer refreshes, no selected causal action remains, and aggregate Workspace Verify completes without an execution failure. Unrelated workspace blockers are reported separately and do not reopen the selected card.",
   "cards": [
     {
       "cardId": "doctor",
@@ -11,6 +11,8 @@
       "verifyArtifact": ".workspai/reports/doctor-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "diagnose-and-repair",
       "remediationArtifacts": [
@@ -27,6 +29,8 @@
       "verifyArtifact": ".workspai/reports/doctor-project-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "diagnose-and-repair",
       "remediationArtifacts": [
@@ -43,6 +47,8 @@
       "verifyArtifact": ".workspai/reports/pipeline-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": [
@@ -58,6 +64,8 @@
       "verifyArtifact": ".workspai/reports/analyze-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": [
@@ -73,6 +81,8 @@
       "verifyArtifact": ".workspai/reports/release-readiness-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": [
@@ -88,6 +98,8 @@
       "verifyArtifact": ".workspai/reports/bootstrap-compliance.latest.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": [
@@ -103,6 +115,8 @@
       "verifyArtifact": ".workspai/workspace-registry.v1.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -116,6 +130,8 @@
       "verifyArtifact": ".workspai/workspace.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -129,6 +145,8 @@
       "verifyArtifact": ".workspai/reports/workspace-contract-verify-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": []
@@ -142,6 +160,8 @@
       "verifyArtifact": ".workspai/reports/autopilot-release-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": []
@@ -155,6 +175,8 @@
       "verifyArtifact": ".workspai/reports/workspace-run-last.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": [
@@ -170,6 +192,8 @@
       "verifyArtifact": ".workspai/toolchain.lock",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": []
@@ -183,6 +207,8 @@
       "verifyArtifact": ".workspai/reports/doctor-project-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "diagnose-and-repair",
       "remediationArtifacts": [
@@ -198,6 +224,8 @@
       "verifyArtifact": ".workspai/reports/snapshot-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -211,6 +239,8 @@
       "verifyArtifact": ".workspai/reports/workspace-model.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -224,6 +254,8 @@
       "verifyArtifact": ".workspai/reports/workspace-model-snapshot.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -237,6 +269,8 @@
       "verifyArtifact": ".workspai/reports/workspace-model-diff-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -250,6 +284,8 @@
       "verifyArtifact": ".workspai/reports/workspace-impact-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -263,6 +299,8 @@
       "verifyArtifact": ".workspai/reports/workspace-intelligence-run-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": []
@@ -276,6 +314,8 @@
       "verifyArtifact": ".workspai/reports/workspace-verify-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": [
@@ -291,6 +331,8 @@
       "verifyArtifact": ".workspai/reports/workspace-explain-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -304,6 +346,8 @@
       "verifyArtifact": ".workspai/reports/workspace-why-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -317,6 +361,8 @@
       "verifyArtifact": ".workspai/reports/workspace-trace-last-run.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -330,6 +376,8 @@
       "verifyArtifact": ".workspai/reports/workspace-model.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -343,6 +391,8 @@
       "verifyArtifact": ".workspai/reports/workspace-context-agent.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -356,6 +406,8 @@
       "verifyArtifact": ".workspai/reports/agent-customization-pack.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -369,6 +421,8 @@
       "verifyArtifact": ".workspai/reports/share-bundle.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -382,6 +436,8 @@
       "verifyArtifact": ".workspai/archive-manifest.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -395,6 +451,8 @@
       "verifyArtifact": ".workspai/reports/mirror-ops.latest.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -408,6 +466,8 @@
       "verifyArtifact": ".workspai/cache-config.yml",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "refresh-producer",
       "remediationArtifacts": []
@@ -421,6 +481,8 @@
       "verifyArtifact": ".workspai/policies.yml",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": []
@@ -434,6 +496,8 @@
       "verifyArtifact": ".workspai/reports/infra-plan.json",
       "aggregateVerifyCommand": "npx workspai workspace verify --json",
       "targetClosure": "exact-producer-and-causal-action-set",
+      "aggregateRepair": "sequential-causal-queue",
+      "transactionScope": "one-causal-finding-family",
       "workspacePosture": "reported-separately",
       "repairPolicy": "source-repair-then-produce",
       "remediationArtifacts": []

package/contracts/workspace-intelligence/agent-bootstrap-receipt.v1.json

@@ -119,8 +119,6 @@
         "projectContext",
         "workspaceIndex",
         "workspaceContext",
-        "workspaceModel",
-        "knowledgeGraph",
         "modelFreshness",
         "graphFreshness",
         "graphMatchesModel",
@@ -137,12 +135,42 @@
         "knowledgeGraph": {
           "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
         },
+        "workspaceSkillsIndex": {
+          "const": "workspace:.workspai/reports/workspace-skills-index.json"
+        },
+        "boundedGraphSearch": {
+          "const": "command:workspai workspace graph search <task-query> --scope project:<project> --limit 12 --json"
+        },
         "modelFreshness": { "enum": ["fresh", "stale", "unknown", "missing"] },
         "graphFreshness": { "enum": ["fresh", "stale", "unknown", "missing"] },
         "graphMatchesModel": { "type": "boolean" },
         "liveInputsValidated": { "type": "boolean" },
         "blockerCount": { "type": "integer", "minimum": 0 }
-      }
+      },
+      "anyOf": [
+        {
+          "properties": {
+            "workspaceModel": {
+              "const": "workspace:.workspai/reports/workspace-model.json"
+            },
+            "knowledgeGraph": {
+              "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
+            }
+          },
+          "required": ["workspaceModel", "knowledgeGraph"]
+        },
+        {
+          "properties": {
+            "workspaceSkillsIndex": {
+              "const": "workspace:.workspai/reports/workspace-skills-index.json"
+            },
+            "boundedGraphSearch": {
+              "const": "command:workspai workspace graph search <task-query> --scope project:<project> --limit 12 --json"
+            }
+          },
+          "required": ["workspaceSkillsIndex", "boundedGraphSearch"]
+        }
+      ]
     },
     "activeGoal": {
       "type": "object",

package/contracts/workspace-intelligence/agent-customization-pack-report.v1.json

@@ -22,7 +22,11 @@
   "properties": {
     "schemaVersion": { "const": "rapidkit-agent-customization-pack.v1" },
     "generatedAt": { "type": "string", "format": "date-time" },
-    "workspaceRoot": { "type": "string", "minLength": 1 },
+    "workspaceRoot": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Portable workspace identity (workspace:<name>), never a machine-local filesystem path."
+    },
     "preset": { "enum": ["minimal", "enterprise"] },
     "targets": {
       "type": "array",

package/contracts/workspace-intelligence/agent-reports-index.v1.json

@@ -18,7 +18,11 @@
   "properties": {
     "schemaVersion": { "const": "rapidkit-agent-reports-index.v1" },
     "generatedAt": { "type": "string", "format": "date-time" },
-    "workspaceRoot": { "type": "string", "minLength": 1 },
+    "workspaceRoot": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Portable workspace identity (workspace:<name>), never a machine-local filesystem path."
+    },
     "intelligenceChain": {
       "type": "object",
       "additionalProperties": false,

package/contracts/workspace-intelligence/project-agent-entry.v1.json

@@ -61,9 +61,7 @@
         "projectGrounding",
         "goalIndex",
         "workspaceIndex",
-        "workspaceContext",
-        "workspaceModel",
-        "knowledgeGraph"
+        "workspaceContext"
       ],
       "properties": {
         "projectContext": { "const": ".workspai/reports/project-context-agent.json" },
@@ -76,8 +74,38 @@
         "workspaceModel": { "const": "workspace:.workspai/reports/workspace-model.json" },
         "knowledgeGraph": {
           "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
+        },
+        "workspaceSkillsIndex": {
+          "const": "workspace:.workspai/reports/workspace-skills-index.json"
+        },
+        "boundedGraphSearch": {
+          "const": "command:workspai workspace graph search <task-query> --scope project:<project> --limit 12 --json"
         }
-      }
+      },
+      "anyOf": [
+        {
+          "properties": {
+            "workspaceModel": {
+              "const": "workspace:.workspai/reports/workspace-model.json"
+            },
+            "knowledgeGraph": {
+              "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
+            }
+          },
+          "required": ["workspaceModel", "knowledgeGraph"]
+        },
+        {
+          "properties": {
+            "workspaceSkillsIndex": {
+              "const": "workspace:.workspai/reports/workspace-skills-index.json"
+            },
+            "boundedGraphSearch": {
+              "const": "command:workspai workspace graph search <task-query> --scope project:<project> --limit 12 --json"
+            }
+          },
+          "required": ["workspaceSkillsIndex", "boundedGraphSearch"]
+        }
+      ]
     },
     "protocol": {
       "type": "object",

package/contracts/workspace-intelligence/project-context-agent.v1.json

@@ -21,7 +21,7 @@
     "generatedAt": { "type": "string", "format": "date-time" },
     "workspace": {
       "type": "object",
-      "required": ["name", "relationship", "contract", "model", "knowledgeGraph", "access"],
+      "required": ["name", "relationship", "contract", "access"],
       "properties": {
         "name": { "type": "string", "minLength": 1 },
         "profile": { "type": "string" },
@@ -33,6 +33,14 @@
         "knowledgeGraph": {
           "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
         },
+        "index": { "const": "workspace:.workspai/reports/INDEX.json" },
+        "context": {
+          "const": "workspace:.workspai/reports/workspace-context-agent.json"
+        },
+        "skillsIndex": {
+          "const": "workspace:.workspai/reports/workspace-skills-index.json"
+        },
+        "boundedGraphSearch": { "type": "string", "minLength": 1 },
         "access": {
           "type": "object",
           "required": [
@@ -54,7 +62,31 @@
           "additionalProperties": false
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "properties": {
+            "model": { "const": "workspace:.workspai/reports/workspace-model.json" },
+            "knowledgeGraph": {
+              "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
+            }
+          },
+          "required": ["model", "knowledgeGraph"]
+        },
+        {
+          "properties": {
+            "index": { "const": "workspace:.workspai/reports/INDEX.json" },
+            "context": {
+              "const": "workspace:.workspai/reports/workspace-context-agent.json"
+            },
+            "skillsIndex": {
+              "const": "workspace:.workspai/reports/workspace-skills-index.json"
+            },
+            "boundedGraphSearch": { "type": "string", "minLength": 1 }
+          },
+          "required": ["index", "context", "skillsIndex", "boundedGraphSearch"]
+        }
+      ]
     },
     "project": {
       "type": "object",

package/contracts/workspace-intelligence/studio-blocker-handoff.v1.json

@@ -64,6 +64,34 @@
         "additionalProperties": false
       }
     },
+    "selectedTarget": {
+      "type": "object",
+      "description": "One immutable causal finding target selected from an aggregate card for the next CLI-owned transaction.",
+      "required": ["findingId", "actionIds", "repairMode", "sourceMutation"],
+      "properties": {
+        "findingId": { "type": "string", "minLength": 1 },
+        "causalKey": { "type": "string", "minLength": 1 },
+        "actionIds": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "sourcePaths": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "projectName": { "type": "string", "minLength": 1 },
+        "projectPath": { "type": "string", "minLength": 1 },
+        "repairMode": {
+          "enum": ["edit-file", "run-command", "refresh-evidence", "verify-before-fix", "manual-guidance"]
+        },
+        "sourceMutation": { "enum": ["required", "allowed", "forbidden"] },
+        "verifyCommand": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
     "artifactPath": {
       "type": "string"
     },

package/contracts/workspace-intelligence/workspace-context.v1.json

@@ -78,7 +78,10 @@
       "required": ["name", "root", "type"],
       "properties": {
         "name": { "type": "string" },
-        "root": { "type": "string" },
+        "root": {
+          "type": "string",
+          "description": "Portable workspace identity (workspace:<name>), never a machine-local filesystem path."
+        },
         "type": { "type": "string" },
         "profile": { "type": "string" }
       },

package/contracts/workspace-intelligence-chain.v1.json

@@ -1263,14 +1263,13 @@
     "agents": {
       "canonicalReadOrder": [
         ".workspai/reports/INDEX.json",
+        ".workspai/goals/index.json",
+        ".workspai/reports/goal-pack-last-run.json",
         ".workspai/reports/workspace-context-agent.json",
+        ".workspai/reports/workspace-skills-index.json",
         ".workspai/reports/workspace-verify-last-run.json",
         ".workspai/reports/workspace-impact-last-run.json",
-        ".workspai/reports/workspace-explain-last-run.json",
-        ".workspai/reports/workspace-model.json",
-        ".workspai/reports/workspace-knowledge-graph.json",
-        ".workspai/reports/agent-customization-pack.json",
-        ".workspai/reports/workspace-skills-index.json"
+        ".workspai/reports/workspace-explain-last-run.json"
       ],
       "entrypoints": [
         "AGENTS.md",

package/dist/{artifact-remediation-plan-HPNQTNJ2.js → artifact-remediation-plan-XIQNI35L.js}

@@ -1 +1 @@
-export{a as buildArtifactRemediationPlan,b as writeArtifactRemediationPlan}from'./chunk-7DSYI7YN.js';
+export{a as buildArtifactRemediationPlan,b as writeArtifactRemediationPlan}from'./chunk-WRQWVSBJ.js';

package/dist/autopilot-release-NUQKFKKK.js

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

package/dist/{chunk-NJ6WJ7VU.js → chunk-2LLMKTMO.js}

@@ -1,4 +1,4 @@
-import {a as a$1}from'./chunk-JMFCMPWI.js';import {a as a$4}from'./chunk-QJCCZLOF.js';import {a as a$2,e as e$1}from'./chunk-W6FHVXNL.js';import {d,a,e as e$2}from'./chunk-CCDGHPEJ.js';import {e,h}from'./chunk-NZ3WZYD5.js';import a$3 from'chalk';import re from'fs';import b from'path';import {execa}from'execa';var V="autopilot-release-last-run.json",G="autopilot-release.json";function $(r){try{return JSON.parse(r)}catch{return null}}function Se(r){let e=b.resolve(r),n=a$4(e);if(!n)throw new Error("No Workspai workspace found in current directory or parents");return n}async function S(r,e){let n=process.argv[1];if(!n)return {exitCode:1,stdout:"",stderr:"RapidKit entrypoint is unavailable for autopilot execution.",crashed:true};try{let o=await execa(process.execPath,[n,...r],{cwd:e,reject:false,env:{...process.env,RAPIDKIT_AUTOPILOT_CHILD:"1"}});return {exitCode:Number(o.exitCode??1),stdout:o.stdout,stderr:o.stderr,crashed:false}}catch(o){return {exitCode:1,stdout:"",stderr:o instanceof Error?o.message:String(o),crashed:true}}}function oe(r){let e=r.toLowerCase();return e==="pass"?"pass":e==="warn"?"warn":e==="fail"?"fail":"warn"}function ae(r){return r.summary.failed>0||r.gates.results.some(e=>e.status==="fail")?"fail":r.gates.results.some(e=>e.status==="warn")?"warn":"pass"}function be(r){let e=r.filter(o=>o.status!=="skipped");if(e.length===0)return 100;let n=e.reduce((o,t)=>t.status==="pass"?o+1:t.status==="warn"?o+.6:o,0);return Math.round(n/e.length*100)}function Ae(r){return r.executionError?["Re-run: npx workspai autopilot release --mode audit --json","Inspect .workspai/reports/autopilot-release-last-run.json for execution failure details"]:r.blockers.length>0?["Run: npx workspai doctor workspace --plan","Run: npx workspai readiness --json --strict","Run: npx workspai workspace run test --affected --strict"]:r.hasWarnings&&r.mode!=="enforce"?["Review warning-level findings in autopilot report","Optionally run: npx workspai autopilot release --mode safe-fix"]:["Workspace is release-ready based on current autopilot policy"]}async function xe(r,e){await re.promises.mkdir(b.dirname(r),{recursive:true}),await re.promises.writeFile(r,`${JSON.stringify(e,null,2)}
+import {a as a$1}from'./chunk-QA62UOE4.js';import {a as a$4}from'./chunk-QJCCZLOF.js';import {a as a$2,e as e$1}from'./chunk-W6FHVXNL.js';import {d,a,e as e$2}from'./chunk-CCDGHPEJ.js';import {e,h}from'./chunk-NZ3WZYD5.js';import a$3 from'chalk';import re from'fs';import b from'path';import {execa}from'execa';var V="autopilot-release-last-run.json",G="autopilot-release.json";function $(r){try{return JSON.parse(r)}catch{return null}}function Se(r){let e=b.resolve(r),n=a$4(e);if(!n)throw new Error("No Workspai workspace found in current directory or parents");return n}async function S(r,e){let n=process.argv[1];if(!n)return {exitCode:1,stdout:"",stderr:"RapidKit entrypoint is unavailable for autopilot execution.",crashed:true};try{let o=await execa(process.execPath,[n,...r],{cwd:e,reject:false,env:{...process.env,RAPIDKIT_AUTOPILOT_CHILD:"1"}});return {exitCode:Number(o.exitCode??1),stdout:o.stdout,stderr:o.stderr,crashed:false}}catch(o){return {exitCode:1,stdout:"",stderr:o instanceof Error?o.message:String(o),crashed:true}}}function oe(r){let e=r.toLowerCase();return e==="pass"?"pass":e==="warn"?"warn":e==="fail"?"fail":"warn"}function ae(r){return r.summary.failed>0||r.gates.results.some(e=>e.status==="fail")?"fail":r.gates.results.some(e=>e.status==="warn")?"warn":"pass"}function be(r){let e=r.filter(o=>o.status!=="skipped");if(e.length===0)return 100;let n=e.reduce((o,t)=>t.status==="pass"?o+1:t.status==="warn"?o+.6:o,0);return Math.round(n/e.length*100)}function Ae(r){return r.executionError?["Re-run: npx workspai autopilot release --mode audit --json","Inspect .workspai/reports/autopilot-release-last-run.json for execution failure details"]:r.blockers.length>0?["Run: npx workspai doctor workspace --plan","Run: npx workspai readiness --json --strict","Run: npx workspai workspace run test --affected --strict"]:r.hasWarnings&&r.mode!=="enforce"?["Review warning-level findings in autopilot report","Optionally run: npx workspai autopilot release --mode safe-fix"]:["Workspace is release-ready based on current autopilot policy"]}async function xe(r,e){await re.promises.mkdir(b.dirname(r),{recursive:true}),await re.promises.writeFile(r,`${JSON.stringify(e,null,2)}
 `,"utf-8");}async function ze(r){let e$3=Se(r.workspacePath),n=r.mode,o=[],t=[],L,H,N,q,Q,X=0,f=false,I=0,_=0,W=-1,T=-1,c="skipped",d$1="skipped",ne=n==="enforce"?["doctor","workspace","--json","--strict"]:["doctor","workspace","--json","--ci"];if(r.skipPipelineStages)o.push({name:"doctor-workspace",status:"skipped",durationMs:0,summary:"doctor stage skipped (pipeline already executed)"},{name:"analyze",status:"skipped",durationMs:0,summary:"analyze stage skipped (pipeline already executed)"},{name:"readiness",status:"skipped",durationMs:0,summary:"readiness stage skipped (pipeline already executed)"});else {let s=Date.now(),l=await S([...ne],e$3),m=Date.now()-s;if(c="pass",l.crashed)c="fail",f=true,t.push(`doctor workspace execution error: ${l.stderr||"unknown error"}`);else if(l.exitCode===1)c="fail",t.push("doctor workspace command failed or reported errors");else if(l.exitCode===2)c="warn",t.push("doctor workspace reported warnings");else if(l.exitCode!==0)c="fail",t.push("doctor workspace command failed");else {let p=$(l.stdout),E=p&&p.healthScore&&typeof p.healthScore=="object"?p.healthScore:{},k=Number(E.errors??0),C=Number(E.warnings??0);Number.isFinite(k)&&k>0?(c="fail",t.push(`doctor workspace reports ${k} error(s)`)):Number.isFinite(C)&&C>0&&(c="warn");}W=o.push({name:"doctor-workspace",status:c,durationMs:m,summary:c==="pass"?"doctor workspace passed":c==="warn"?"doctor workspace reported warnings":"doctor workspace reported errors"})-1,n==="enforce"&&c==="warn"&&t.push("doctor workspace reported warnings under enforce mode");let g=Date.now(),w=await S(["analyze","--json"],e$3),P=Date.now()-g;H=await d(e$3,e.analyze)??a(e$3,e.analyze);let i="pass";if(w.crashed)i="fail",f=true,t.push(`analyze execution error: ${w.stderr||"unknown error"}`);else if(w.exitCode!==0)i=w.exitCode===2?"warn":"fail",t.push(w.exitCode===2?"analyze reported needs-attention verdict":"analyze command failed or reported blocked verdict");else {let p=$(w.stdout),E=p&&p.summary&&typeof p.summary=="object"?p.summary:{},k=String(E.verdict??"ready");k==="blocked"?(i="fail",t.push("analyze reported blocked verdict")):k==="needs-attention"&&(i="warn");}o.push({name:"analyze",status:i,durationMs:P,summary:i==="pass"?"analyze passed":i==="warn"?"analyze reported needs-attention":"analyze reported blocked verdict"}),n==="enforce"&&i==="warn"&&t.push("analyze reported warnings under enforce mode");let v=Date.now(),h=await S(["readiness","--json"],e$3),y=Date.now()-v;if(d$1="fail",h.crashed)d$1="fail",f=true,t.push(`readiness execution error: ${h.stderr||"unknown error"}`);else if(h.exitCode!==0)d$1="fail",t.push("readiness command failed");else {let p=$(h.stdout),E=String(p?.overallStatus??"fail");if(d$1=oe(E),typeof p?.evidencePath=="string"&&p.evidencePath.trim().length>0&&(L=p.evidencePath),d$1==="fail"){let k=Array.isArray(p?.blockingReasons)?p?.blockingReasons.filter(C=>typeof C=="string"):[];k.length>0?t.push(...k.map(C=>`readiness: ${C}`)):t.push("readiness overall status is fail");}}T=o.push({name:"readiness",status:d$1,durationMs:y,summary:`readiness overall status is ${d$1}`})-1,n==="enforce"&&d$1==="warn"&&t.push("readiness reported warnings under enforce mode");}let ie=Date.now(),D=await S(["doctor","workspace","--plan","--json"],e$3),le=Date.now()-ie,R="warn";if(D.crashed)R="fail",f=true,t.push(`doctor remediation plan execution error: ${D.stderr||"unknown error"}`);else if(D.exitCode!==0)R="fail",t.push("doctor remediation plan command failed");else {let s=$(D.stdout),l=s&&s.remediationPlan&&typeof s.remediationPlan=="object"?s.remediationPlan:null,m=Number(l?.totalSteps??0),g=Number(l?.executableSteps??0);Number.isFinite(m)&&m>0&&(I=m),Number.isFinite(g)&&g>0&&(_=g),Number.isFinite(m)&&m===0?R="pass":R="warn";}if(o.push({name:"remediation-plan",status:R,durationMs:le,summary:R==="pass"?"no remediation steps required":"remediation steps available"}),n==="enforce"&&R==="warn"&&t.push("remediation plan has pending steps under enforce mode"),n==="safe-fix"){let s=Date.now(),l=await S(["doctor","workspace","--apply"],e$3),m=Date.now()-s,g=l.crashed||l.exitCode!==0?"fail":"pass";if(l.crashed)f=true,t.push(`doctor remediation apply execution error: ${l.stderr||"unknown error"}`);else if(g==="fail")t.push("doctor remediation apply failed");else {X=_>0?_:I>0?I:1;let w=await S(["doctor","workspace","--json"],e$3);if(w.crashed)c="fail",f=true,t.push(`post-apply doctor execution error: ${w.stderr||"unknown error"}`);else if(w.exitCode!==0)c="fail",t.push("post-apply doctor workspace command failed");else {let i=$(w.stdout),v=i&&i.healthScore&&typeof i.healthScore=="object"?i.healthScore:{},h=Number(v.errors??0),y=Number(v.warnings??0);Number.isFinite(h)&&h>0?(c="fail",t.push(`post-apply doctor reports ${h} error(s)`)):Number.isFinite(y)&&y>0?c="warn":c="pass";}W>=0&&(o[W].status=c,o[W].summary=`doctor workspace post-apply status is ${c}`);let P=await S(["readiness","--json"],e$3);if(P.crashed)d$1="fail",f=true,t.push(`post-apply readiness execution error: ${P.stderr||"unknown error"}`);else if(P.exitCode!==0)d$1="fail",t.push("post-apply readiness command failed");else {let i=$(P.stdout),v=String(i?.overallStatus??"fail");if(d$1=oe(v),typeof i?.evidencePath=="string"&&i.evidencePath.trim().length>0&&(L=i.evidencePath),d$1==="fail"){let h=Array.isArray(i?.blockingReasons)?i?.blockingReasons.filter(y=>typeof y=="string"):[];h.length>0?t.push(...h.map(y=>`post-apply readiness: ${y}`)):t.push("post-apply readiness overall status is fail");}}T>=0&&(o[T].status=d$1,o[T].summary=`readiness post-apply overall status is ${d$1}`);}o.push({name:"remediation-apply",status:g,durationMs:m,summary:g==="pass"?"safe remediation apply completed":"safe remediation apply failed"});}else o.push({name:"remediation-apply",status:"skipped",durationMs:0,summary:"remediation apply is skipped for this mode"});let ce=Date.now(),A="pass",x="workspace test/build completed for selected projects";try{let s=await a$1({workspacePath:e$3,stage:"test",affected:true,since:r.since,parallel:r.parallel,maxWorkers:r.maxWorkers,strict:true,json:true,enforceGates:false});N=a(e$3,b.join(".workspai","reports",a$2)),await e$1(e$3,s),q=N;let l=ae(s);if(l==="fail")A="fail",x="workspace test stage failed for selected projects",t.push("workspace run test failed for selected projects");else {l==="warn"&&(A="warn",x="workspace test stage completed with warnings",n==="enforce"&&t.push("workspace run test reported warnings under enforce mode"));let m=await a$1({workspacePath:e$3,stage:"build",affected:true,since:r.since,parallel:r.parallel,maxWorkers:r.maxWorkers,strict:true,json:true,enforceGates:false});await e$1(e$3,m),Q=N;let g=ae(m);g==="fail"?(A="fail",x="workspace build stage failed for selected projects",t.push("workspace run build failed for selected projects")):g==="warn"&&(A="warn",x="workspace test/build completed with warnings",n==="enforce"&&t.push("workspace run test/build reported warnings under enforce mode"));}}catch(s){A="fail",x="workspace test/build orchestration failed",f=true,t.push(`workspace run orchestration error: ${s instanceof Error?s.message:String(s)}`);}let pe=Date.now()-ce;o.push({name:"workspace-run-test-build",status:A,durationMs:pe,summary:x});let M=o.filter(s=>s.status==="warn").length,ue=o.filter(s=>s.status==="fail").length,F=n==="enforce"?o.some(s=>s.status==="warn"||s.status==="fail"):ue>0,j=[...new Set(t)],O=f||F?Math.max(1,j.length):0,de=O>0?j:[],fe=O===0?j:[],me=be(o),ge=f||F?"blocked":M>0?"partial":"approved",we=f?3:F?1:M>0?2:0,he=Ae({mode:n,executionError:f,blockers:j,hasWarnings:M>0}),Y=a(e$3,".workspai/reports"),ke=b.join(Y,V),ye=b.join(Y,G),u={schemaVersion:h.autopilotReleaseLastRun.schemaVersion,generatedAt:new Date().toISOString(),workspacePath:e$3,mode:n,summary:{releaseScore:me,verdict:ge,blockers:O,warnings:M,safeFixesApplied:X,manualActions:j.length,exitCode:we},stages:o,blockingReasons:de,warningReasons:fe,nextActions:he,artifacts:{reportPath:ke,aliasEvidencePath:ye,analyzeEvidencePath:H,readinessEvidencePath:L,workspaceRunEvidencePath:N,workspaceRunTestPath:q,workspaceRunBuildPath:Q},enterpriseControls:{jsonReady:true,evidencePath:`.workspai/reports/${V}`,aliasEvidencePath:`.workspai/reports/${G}`}};if(await e$2(e$3,`.workspai/reports/${V}`,u),await e$2(e$3,`.workspai/reports/${G}`,u),r.output&&await xe(b.resolve(r.output),u),!r.json){console.log(a$3.bold.cyan(`
 \u{1F680} Workspai Autopilot Release
 `)),console.log(a$3.bold(`Workspace: ${a$3.cyan(b.basename(e$3))}`)),console.log(a$3.gray(`Path: ${e$3}`)),console.log(a$3.white(`Mode: ${n}`)),console.log(a$3.white(`Verdict: ${u.summary.verdict==="approved"?a$3.green("approved"):u.summary.verdict==="partial"?a$3.yellow("partial"):a$3.red("blocked")}`)),console.log(a$3.white(`Release score: ${u.summary.releaseScore}`));for(let s of u.stages){let l=s.status==="pass"?a$3.green("PASS"):s.status==="warn"?a$3.yellow("WARN"):s.status==="skipped"?a$3.gray("SKIP"):a$3.red("FAIL");console.log(` - ${s.name}: ${l} ${s.summary} (${s.durationMs}ms)`);}if(u.blockingReasons.length>0){console.log(a$3.bold.red(`