workspai 0.59.1 → 0.60.1

package/README.md

@@ -106,6 +106,8 @@ Describe the outcome in plain language from the adopted project:
 
 ```bash
 npx workspai goal "Raise test coverage to 85%" --for-agent generic
+# In a polyglot scope, choose interactively or bind a canonical runtime:
+npx workspai goal "Raise test coverage to 85%" --runtime cpp --for-agent generic
 # Or pursue feature, defect, refactor, performance, documentation, or
 # system-understanding outcomes in the same governed flow.
 npx workspai goal "Add retry with exponential backoff" --for-agent generic
@@ -123,6 +125,9 @@ control. The command prepares governed work; it does not edit source or claim
 that the outcome is complete. Exact coverage, dependency-security, and release
 Goals have deterministic CLI verifiers; other outcomes retain CLI safety and
 rollback while the consumer performs an evidence-backed outcome review.
+Multi-project scope and polyglot runtime choices are explicit. Interactive
+users get bounded choices from the canonical Workspace Model; automation gets
+a machine-readable decision and can use `--scope` and `--runtime`.
 
 ![Workspai turns a plain-language objective into a governed Goal Pack](https://raw.githubusercontent.com/chistiq/workspai/main/packages/cli/docs/workspai-goal-readme-cli.gif)
 

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

@@ -504,6 +504,10 @@
           "flags": "--scope <scope>",
           "attributeName": "scope"
         },
+        {
+          "flags": "--runtime <runtime>",
+          "attributeName": "runtime"
+        },
         {
           "flags": "--for-agent <consumer>",
           "attributeName": "forAgent"

package/contracts/extension-cli-compatibility.v1.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "rapidkit-extension-cli-compatibility.v1",
   "cli": "workspai",
-  "minimumVerifiedCliVersion": "0.58.0",
+  "minimumVerifiedCliVersion": "0.60.1",
   "publishedContractSchemas": {
     "workspaceContract": 1,
     "runtimeCommandSurface": "rapidkit-runtime-command-surface-v1",

package/contracts/workspace-intelligence/goal-agent-handoff.v1.json

@@ -3,7 +3,22 @@
   "$id": "https://workspai.dev/schemas/workspace-intelligence/goal-agent-handoff.v1.json",
   "title": "Workspai Goal Agent Handoff",
   "type": "object",
-  "required": ["schemaVersion", "goalId", "goalFingerprint", "generatedAt", "consumer", "state", "objective", "scope", "discovery", "retrieval", "evidence", "guardrails", "workflow", "renewal"],
+  "required": [
+    "schemaVersion",
+    "goalId",
+    "goalFingerprint",
+    "generatedAt",
+    "consumer",
+    "state",
+    "objective",
+    "scope",
+    "discovery",
+    "retrieval",
+    "evidence",
+    "guardrails",
+    "workflow",
+    "renewal"
+  ],
   "properties": {
     "schemaVersion": { "const": "workspai.goal-agent-handoff.v1" },
     "goalId": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{7,95}$" },
@@ -16,10 +31,46 @@
       "type": "object",
       "required": ["kind", "projects", "selectionSource"],
       "properties": {
-        "kind": { "enum": ["workspace", "project"] },
-        "projects": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
-        "selectionSource": { "enum": ["workspace", "invocation-project", "explicit"] }
+        "kind": { "enum": ["workspace", "project", "project-set"] },
+        "projects": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "selectionSource": {
+          "enum": [
+            "workspace",
+            "single-project-workspace",
+            "invocation-project",
+            "explicit",
+            "interactive"
+          ]
+        },
+        "resolution": { "enum": ["selected", "selection-required"] }
       },
+      "allOf": [
+        {
+          "if": { "properties": { "kind": { "const": "project" } } },
+          "then": { "properties": { "projects": { "type": "array", "maxItems": 1 } } }
+        },
+        {
+          "if": { "properties": { "kind": { "const": "project-set" } } },
+          "then": { "properties": { "projects": { "type": "array", "minItems": 2 } } }
+        },
+        {
+          "if": {
+            "properties": { "resolution": { "const": "selection-required" } },
+            "required": ["resolution"]
+          },
+          "then": {
+            "properties": {
+              "kind": { "const": "workspace" },
+              "selectionSource": { "const": "workspace" }
+            }
+          }
+        }
+      ],
       "additionalProperties": false
     },
     "evidence": {
@@ -51,7 +102,12 @@
       "properties": {
         "index": { "const": ".workspai/goals/index.json" },
         "statusCommand": { "type": "string", "pattern": "^workspai goal --status " },
-        "requiredReads": { "type": "array", "minItems": 3, "items": { "type": "string", "pattern": "^\\.workspai/" }, "uniqueItems": true }
+        "requiredReads": {
+          "type": "array",
+          "minItems": 3,
+          "items": { "type": "string", "pattern": "^\\.workspai/" },
+          "uniqueItems": true
+        }
       },
       "additionalProperties": false
     },
@@ -61,12 +117,37 @@
       "properties": {
         "status": { "enum": ["grounded", "partial", "empty"] },
         "strategy": { "const": "deterministic-category-v1" },
-        "queries": { "type": "array", "minItems": 1, "maxItems": 3, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
-        "anchors": { "type": "array", "maxItems": 20, "items": { "type": "object", "required": ["entityId", "kind", "label", "proofIds"], "properties": { "entityId": { "type": "string" }, "kind": { "type": "string" }, "label": { "type": "string" }, "proofIds": { "type": "array", "items": { "type": "string" }, "uniqueItems": true } }, "additionalProperties": false } }
+        "queries": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 3,
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "anchors": {
+          "type": "array",
+          "maxItems": 20,
+          "items": {
+            "type": "object",
+            "required": ["entityId", "kind", "label", "proofIds"],
+            "properties": {
+              "entityId": { "type": "string" },
+              "kind": { "type": "string" },
+              "label": { "type": "string" },
+              "proofIds": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+            },
+            "additionalProperties": false
+          }
+        }
       },
       "additionalProperties": false
     },
-    "guardrails": { "type": "array", "minItems": 5, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+    "guardrails": {
+      "type": "array",
+      "minItems": 5,
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
     "workflow": {
       "type": "array",
       "minItems": 5,

package/contracts/workspace-intelligence/goal-index.v1.json

@@ -12,28 +12,97 @@
       "type": "array",
       "items": {
         "type": "object",
-        "required": ["id", "fingerprint", "objective", "category", "state", "lifecycle", "scope", "createdAt", "updatedAt", "goalPack", "agentHandoff"],
+        "required": [
+          "id",
+          "fingerprint",
+          "objective",
+          "category",
+          "state",
+          "lifecycle",
+          "scope",
+          "createdAt",
+          "updatedAt",
+          "goalPack",
+          "agentHandoff"
+        ],
         "properties": {
           "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{7,95}$" },
           "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
           "objective": { "type": "string", "minLength": 1, "maxLength": 2000 },
-          "category": { "enum": ["release-readiness", "dependency-security", "test-coverage", "defect-repair", "feature-change", "refactor", "performance", "documentation", "system-understanding"] },
+          "category": {
+            "enum": [
+              "release-readiness",
+              "dependency-security",
+              "test-coverage",
+              "defect-repair",
+              "feature-change",
+              "refactor",
+              "performance",
+              "documentation",
+              "system-understanding"
+            ]
+          },
           "state": { "enum": ["ready-to-plan", "needs-confirmation", "needs-evidence", "blocked"] },
-          "lifecycle": { "enum": ["planned", "active", "cancelled", "verification-ready", "verified", "failed"] },
+          "lifecycle": {
+            "enum": ["planned", "active", "cancelled", "verification-ready", "verified", "failed"]
+          },
           "scope": {
             "type": "object",
             "required": ["kind", "projects", "selectionSource"],
             "properties": {
-              "kind": { "enum": ["workspace", "project"] },
-              "projects": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
-              "selectionSource": { "enum": ["workspace", "invocation-project", "explicit"] }
+              "kind": { "enum": ["workspace", "project", "project-set"] },
+              "projects": {
+                "type": "array",
+                "minItems": 1,
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
+              "selectionSource": {
+                "enum": [
+                  "workspace",
+                  "single-project-workspace",
+                  "invocation-project",
+                  "explicit",
+                  "interactive"
+                ]
+              },
+              "resolution": { "enum": ["selected", "selection-required"] }
             },
+            "allOf": [
+              {
+                "if": { "properties": { "kind": { "const": "project" } } },
+                "then": {
+                  "properties": { "projects": { "type": "array", "maxItems": 1 } }
+                }
+              },
+              {
+                "if": { "properties": { "kind": { "const": "project-set" } } },
+                "then": {
+                  "properties": { "projects": { "type": "array", "minItems": 2 } }
+                }
+              },
+              {
+                "if": {
+                  "properties": { "resolution": { "const": "selection-required" } },
+                  "required": ["resolution"]
+                },
+                "then": {
+                  "properties": {
+                    "kind": { "const": "workspace" },
+                    "selectionSource": { "const": "workspace" }
+                  }
+                }
+              }
+            ],
             "additionalProperties": false
           },
           "createdAt": { "type": "string", "format": "date-time" },
           "updatedAt": { "type": "string", "format": "date-time" },
           "goalPack": { "type": "string", "pattern": "^\\.workspai/goals/[^/]+/goal-pack\\.json$" },
-          "agentHandoff": { "type": "string", "pattern": "^\\.workspai/goals/[^/]+/agent-handoff\\.json$" },
+          "agentHandoff": {
+            "type": "string",
+            "pattern": "^\\.workspai/goals/[^/]+/agent-handoff\\.json$"
+          },
           "verifiedGoalId": { "type": "string", "minLength": 1 },
           "repairTransactionId": { "type": "string", "minLength": 1 },
           "repairTransactionIds": {
@@ -41,6 +110,30 @@
             "maxItems": 25,
             "uniqueItems": true,
             "items": { "type": "string", "minLength": 1 }
+          },
+          "verificationReceipt": {
+            "type": "object",
+            "required": [
+              "verifiedGoalId",
+              "attempt",
+              "statusHash",
+              "modelHash",
+              "graphFingerprint",
+              "graphFingerprintSemantics",
+              "recordedAt"
+            ],
+            "properties": {
+              "verifiedGoalId": { "type": "string", "minLength": 1 },
+              "attempt": { "type": "integer", "minimum": 1 },
+              "statusHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+              "modelHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+              "graphFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+              "graphFingerprintSemantics": {
+                "enum": ["workspace-knowledge-graph-inputs-v1", "canonical-json-v1"]
+              },
+              "recordedAt": { "type": "string", "format": "date-time" }
+            },
+            "additionalProperties": false
           }
         },
         "additionalProperties": false

package/contracts/workspace-intelligence/goal-lifecycle-result.v1.json

@@ -28,7 +28,9 @@
             "schemaVersion": { "const": "workspai.goal-pack.v1" },
             "id": { "type": "string" },
             "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
-            "state": { "enum": ["ready-to-plan", "needs-confirmation", "needs-evidence", "blocked"] }
+            "state": {
+              "enum": ["ready-to-plan", "needs-confirmation", "needs-evidence", "blocked"]
+            }
           }
         },
         { "type": "null" }
@@ -71,15 +73,57 @@
           ]
         },
         "state": { "enum": ["ready-to-plan", "needs-confirmation", "needs-evidence", "blocked"] },
-        "lifecycle": { "enum": ["planned", "active", "cancelled", "verification-ready", "verified", "failed"] },
+        "lifecycle": {
+          "enum": ["planned", "active", "cancelled", "verification-ready", "verified", "failed"]
+        },
         "scope": {
           "type": "object",
           "required": ["kind", "projects", "selectionSource"],
           "properties": {
-            "kind": { "enum": ["workspace", "project"] },
-            "projects": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
-            "selectionSource": { "enum": ["workspace", "invocation-project", "explicit"] }
+            "kind": { "enum": ["workspace", "project", "project-set"] },
+            "projects": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "type": "string", "minLength": 1 },
+              "uniqueItems": true
+            },
+            "selectionSource": {
+              "enum": [
+                "workspace",
+                "single-project-workspace",
+                "invocation-project",
+                "explicit",
+                "interactive"
+              ]
+            },
+            "resolution": { "enum": ["selected", "selection-required"] }
           },
+          "allOf": [
+            {
+              "if": { "properties": { "kind": { "const": "project" } } },
+              "then": {
+                "properties": { "projects": { "type": "array", "maxItems": 1 } }
+              }
+            },
+            {
+              "if": { "properties": { "kind": { "const": "project-set" } } },
+              "then": {
+                "properties": { "projects": { "type": "array", "minItems": 2 } }
+              }
+            },
+            {
+              "if": {
+                "properties": { "resolution": { "const": "selection-required" } },
+                "required": ["resolution"]
+              },
+              "then": {
+                "properties": {
+                  "kind": { "const": "workspace" },
+                  "selectionSource": { "const": "workspace" }
+                }
+              }
+            }
+          ],
           "additionalProperties": false
         },
         "createdAt": { "type": "string", "format": "date-time" },
@@ -87,7 +131,31 @@
         "goalPack": { "type": "string" },
         "agentHandoff": { "type": "string" },
         "verifiedGoalId": { "type": "string" },
-        "repairTransactionId": { "type": "string" }
+        "repairTransactionId": { "type": "string" },
+        "verificationReceipt": {
+          "type": "object",
+          "required": [
+            "verifiedGoalId",
+            "attempt",
+            "statusHash",
+            "modelHash",
+            "graphFingerprint",
+            "graphFingerprintSemantics",
+            "recordedAt"
+          ],
+          "properties": {
+            "verifiedGoalId": { "type": "string", "minLength": 1 },
+            "attempt": { "type": "integer", "minimum": 1 },
+            "statusHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "modelHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "graphFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "graphFingerprintSemantics": {
+              "enum": ["workspace-knowledge-graph-inputs-v1", "canonical-json-v1"]
+            },
+            "recordedAt": { "type": "string", "format": "date-time" }
+          },
+          "additionalProperties": false
+        }
       },
       "additionalProperties": false
     }