workspai 0.48.0 → 0.50.0

package/contracts/workspace-intelligence/workspace-graph-stream.v1.json

@@ -0,0 +1,262 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-graph-stream.v1.json",
+  "title": "Workspai Workspace Graph Stream",
+  "description": "Transport-neutral, revision-safe events for hydrating and incrementally updating a Workspace Knowledge Graph consumer.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "type",
+    "workspaceId",
+    "sessionId",
+    "generation",
+    "revision",
+    "modelHash",
+    "graphHash",
+    "generatedAt",
+    "causationId",
+    "correlationId",
+    "payload"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspace-graph-stream.v1" },
+    "type": {
+      "enum": [
+        "graph.snapshot",
+        "graph.delta",
+        "graph.provider-progress",
+        "graph.quality-changed",
+        "graph.proof-invalidated",
+        "graph.resync-required",
+        "graph.paused",
+        "graph.complete",
+        "graph.heartbeat",
+        "graph.error"
+      ]
+    },
+    "workspaceId": { "type": "string", "minLength": 1 },
+    "sessionId": { "type": "string", "minLength": 1 },
+    "generation": { "type": "integer", "minimum": 0 },
+    "baseRevision": { "type": "integer", "minimum": 0 },
+    "baseModelHash": { "$ref": "#/$defs/hash" },
+    "baseGraphHash": { "$ref": "#/$defs/hash" },
+    "revision": { "type": "integer", "minimum": 0 },
+    "modelHash": { "$ref": "#/$defs/hash" },
+    "graphHash": { "$ref": "#/$defs/hash" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "causationId": { "type": "string", "minLength": 1 },
+    "correlationId": { "type": "string", "minLength": 1 },
+    "payload": { "type": "object" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "type": { "const": "graph.snapshot" } } },
+      "then": {
+        "properties": {
+          "payload": { "$ref": "#/$defs/snapshotPayload" },
+          "baseRevision": false,
+          "baseModelHash": false,
+          "baseGraphHash": false
+        }
+      }
+    },
+    {
+      "if": { "properties": { "type": { "const": "graph.delta" } } },
+      "then": {
+        "required": ["baseRevision", "baseModelHash", "baseGraphHash"],
+        "properties": { "payload": { "$ref": "#/$defs/deltaPayload" } }
+      }
+    },
+    {
+      "if": { "properties": { "type": { "const": "graph.provider-progress" } } },
+      "then": { "properties": { "payload": { "$ref": "#/$defs/providerProgressPayload" } } }
+    },
+    {
+      "if": { "properties": { "type": { "const": "graph.quality-changed" } } },
+      "then": { "properties": { "payload": { "$ref": "#/$defs/qualityPayload" } } }
+    },
+    {
+      "if": { "properties": { "type": { "const": "graph.proof-invalidated" } } },
+      "then": { "properties": { "payload": { "$ref": "#/$defs/proofInvalidatedPayload" } } }
+    },
+    {
+      "if": { "properties": { "type": { "const": "graph.resync-required" } } },
+      "then": { "properties": { "payload": { "$ref": "#/$defs/resyncPayload" } } }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": { "enum": ["graph.paused", "graph.complete", "graph.heartbeat"] }
+        }
+      },
+      "then": { "properties": { "payload": { "$ref": "#/$defs/controlPayload" } } }
+    },
+    {
+      "if": { "properties": { "type": { "const": "graph.error" } } },
+      "then": { "properties": { "payload": { "$ref": "#/$defs/errorPayload" } } }
+    }
+  ],
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "id": { "type": "string", "minLength": 1 },
+    "snapshotPayload": {
+      "type": "object",
+      "required": ["graph"],
+      "properties": {
+        "graph": { "$ref": "workspace-knowledge-graph.v1.json" },
+        "reason": { "enum": ["initial", "refresh", "recovery", "schema-transition"] }
+      },
+      "additionalProperties": false
+    },
+    "deltaPayload": {
+      "type": "object",
+      "required": [
+        "entitiesAdded",
+        "entitiesUpdated",
+        "entitiesRemoved",
+        "relationsAdded",
+        "relationsUpdated",
+        "relationsRemoved",
+        "proofsAdded",
+        "proofsUpdated",
+        "proofsRemoved",
+        "providersUpdated",
+        "diagnostics"
+      ],
+      "properties": {
+        "entitiesAdded": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/entities/items" }
+        },
+        "entitiesUpdated": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/entities/items" }
+        },
+        "entitiesRemoved": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/id" },
+          "uniqueItems": true
+        },
+        "relationsAdded": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/relations/items" }
+        },
+        "relationsUpdated": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/relations/items" }
+        },
+        "relationsRemoved": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/id" },
+          "uniqueItems": true
+        },
+        "proofsAdded": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/proofs/items" }
+        },
+        "proofsUpdated": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/proofs/items" }
+        },
+        "proofsRemoved": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/id" },
+          "uniqueItems": true
+        },
+        "providersUpdated": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/providers/items" }
+        },
+        "quality": {
+          "oneOf": [
+            { "type": "null" },
+            { "$ref": "workspace-knowledge-graph.v1.json#/properties/quality" }
+          ]
+        },
+        "diagnostics": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/diagnostics/items" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "providerProgressPayload": {
+      "type": "object",
+      "required": ["providerId", "status"],
+      "properties": {
+        "providerId": { "$ref": "#/$defs/id" },
+        "status": { "enum": ["queued", "running", "passed", "partial", "skipped", "failed"] },
+        "completed": { "type": "integer", "minimum": 0 },
+        "total": { "type": "integer", "minimum": 0 },
+        "message": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "qualityPayload": {
+      "type": "object",
+      "required": ["quality"],
+      "properties": {
+        "quality": { "$ref": "workspace-knowledge-graph.v1.json#/properties/quality" },
+        "diagnostics": {
+          "type": "array",
+          "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/diagnostics/items" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "proofInvalidatedPayload": {
+      "type": "object",
+      "required": ["proofIds", "reason"],
+      "properties": {
+        "proofIds": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/id" },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "reason": { "type": "string", "minLength": 1 },
+        "entityIds": { "type": "array", "items": { "$ref": "#/$defs/id" }, "uniqueItems": true },
+        "relationIds": { "type": "array", "items": { "$ref": "#/$defs/id" }, "uniqueItems": true }
+      },
+      "additionalProperties": false
+    },
+    "resyncPayload": {
+      "type": "object",
+      "required": ["reason"],
+      "properties": {
+        "reason": {
+          "enum": [
+            "revision-gap",
+            "identity-mismatch",
+            "generation-regression",
+            "schema-unsupported",
+            "hash-discontinuity",
+            "validation-failed",
+            "queue-overflow"
+          ]
+        },
+        "expectedRevision": { "type": "integer", "minimum": 0 },
+        "receivedBaseRevision": { "type": "integer", "minimum": 0 },
+        "message": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "controlPayload": {
+      "type": "object",
+      "properties": { "reason": { "type": "string" }, "message": { "type": "string" } },
+      "additionalProperties": false
+    },
+    "errorPayload": {
+      "type": "object",
+      "required": ["code", "message", "recoverable"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 },
+        "recoverable": { "type": "boolean" },
+        "providerId": { "type": "string" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/workspace-intelligence/workspace-graph-token-efficiency.v1.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-graph-token-efficiency.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-graph-token-efficiency.v1.json",
   "title": "Workspai Graph Retrieval Token-Efficiency Report",
   "description": "A reproducible character-based estimate comparing readable proof-source text with one bounded graph retrieval payload. It is not an answer-quality or billing claim.",
   "type": "object",

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-impact.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-impact.v1.json",
   "title": "Workspai Workspace Impact",
   "type": "object",
   "required": [

package/contracts/workspace-intelligence/workspace-intelligence-evaluation-comparison.v1.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-intelligence-evaluation-comparison.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-intelligence-evaluation-comparison.v1.json",
   "title": "Workspai Workspace Intelligence Evaluation Comparison",
   "description": "A task-aligned comparison between two provenance-aware Workspace Intelligence evaluation runs.",
   "type": "object",

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-intelligence-evaluation.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-intelligence-evaluation.v1.json",
   "title": "Workspai Workspace Intelligence Evaluation",
   "description": "A live or finalized, provenance-aware measurement of model usage, agent activity, and verified task outcome.",
   "type": "object",

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-intelligence-history.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-intelligence-history.v1.json",
   "title": "Workspai Workspace Intelligence History",
   "type": "object",
   "required": ["schemaVersion", "retention", "entries"],

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://rapidkit.dev/contracts/workspace-intelligence/workspace-intelligence-run.v1.json",
-  "title": "Workspace Intelligence Run",
+  "$id": "https://workspai.dev/contracts/workspace-intelligence/workspace-intelligence-run.v1.json",
+  "title": "Workspai Workspace Intelligence Run",
   "type": "object",
   "additionalProperties": false,
   "required": [

package/contracts/workspace-intelligence/workspace-knowledge-graph-change-overlay.v1.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-knowledge-graph-change-overlay.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-knowledge-graph-change-overlay.v1.json",
   "title": "Workspai Workspace Knowledge Graph Change Overlay",
   "description": "Portable graph-to-graph entity and relation changes with bounded impact and proof artifact projection.",
   "type": "object",

package/contracts/workspace-intelligence/workspace-knowledge-graph.v1.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-knowledge-graph.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-knowledge-graph.v1.json",
   "title": "Workspai Evidence-backed Workspace Knowledge Graph",
-  "description": "Portable, provider-neutral workspace entities, relations and proof paths with the canonical project dependency topology embedded as a projection.",
+  "description": "Portable, provider-neutral workspace entities, relations and proof paths derived from and structurally bound to the canonical Workspace Model. The embedded project topology is the model's graph projection.",
   "type": "object",
   "required": [
     "schemaVersion",
@@ -24,10 +24,20 @@
       "type": "object",
       "required": ["kind", "artifact", "hashAlgorithm", "hash"],
       "properties": {
-        "kind": { "enum": ["workspace-model", "workspace-contract", "workspace-sources"] },
-        "artifact": { "type": "string", "minLength": 1 },
+        "kind": {
+          "const": "workspace-model",
+          "description": "The canonical Workspace Model is the sole source-of-truth authority for an integrated CLI knowledge graph."
+        },
+        "artifact": {
+          "const": ".workspai/reports/workspace-model.json",
+          "description": "Canonical model artifact whose stable structural projection is identified by source.hash."
+        },
         "hashAlgorithm": { "const": "sha256" },
-        "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+        "hash": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$",
+          "description": "SHA-256 of the stable structural Workspace Model projection. Volatile timestamps, run correlation, live evidence and freshness fields are intentionally excluded."
+        }
       },
       "additionalProperties": false
     },
@@ -234,6 +244,22 @@
         "providerSuccessRatio": { "type": "number", "minimum": 0, "maximum": 1 },
         "conflictCount": { "type": "integer", "minimum": 0 },
         "unknownCount": { "type": "integer", "minimum": 0 },
+        "bindingCoverage": {
+          "type": "object",
+          "required": [
+            "apiImplementation",
+            "projectTests",
+            "projectDeployment",
+            "projectOwnership"
+          ],
+          "properties": {
+            "apiImplementation": { "$ref": "#/$defs/bindingCoverage" },
+            "projectTests": { "$ref": "#/$defs/bindingCoverage" },
+            "projectDeployment": { "$ref": "#/$defs/bindingCoverage" },
+            "projectOwnership": { "$ref": "#/$defs/bindingCoverage" }
+          },
+          "additionalProperties": false
+        },
         "portable": { "const": true },
         "secretValuesEmitted": { "const": false }
       },
@@ -256,5 +282,22 @@
       }
     }
   },
+  "$defs": {
+    "bindingCoverage": {
+      "type": "object",
+      "required": ["eligibleCount", "boundCount", "unknownCount", "coverageRatio"],
+      "properties": {
+        "eligibleCount": { "type": "integer", "minimum": 0 },
+        "boundCount": { "type": "integer", "minimum": 0 },
+        "unknownCount": { "type": "integer", "minimum": 0 },
+        "coverageRatio": {
+          "type": ["number", "null"],
+          "minimum": 0,
+          "maximum": 1
+        }
+      },
+      "additionalProperties": false
+    }
+  },
   "additionalProperties": false
 }

package/contracts/workspace-intelligence/workspace-knowledge-search.v1.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-knowledge-search.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-knowledge-search.v1.json",
   "title": "Workspai Bounded Knowledge Graph Search",
   "description": "A deterministic, bounded, proof-carrying retrieval projection intended for agents, MCP clients, IDEs, and CI consumers.",
   "type": "object",

package/contracts/workspace-intelligence/workspace-model-diff.v1.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-model-diff.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-model-diff.v1.json",
   "title": "Workspai Workspace Model Diff",
   "type": "object",
   "required": [

package/contracts/workspace-intelligence/workspace-model-snapshot.v1.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-model-snapshot.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-model-snapshot.v1.json",
   "title": "Workspai Workspace Model Snapshot",
   "type": "object",
   "required": ["schemaVersion", "generatedAt", "modelHash", "modelRef", "model"],

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-model.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-model.v1.json",
   "title": "Workspai Workspace Intelligence Model",
   "type": "object",
   "required": [
@@ -34,7 +34,46 @@
       },
       "additionalProperties": true
     },
-    "identity": { "type": "object", "additionalProperties": true },
+    "identity": {
+      "type": "object",
+      "properties": {
+        "surfaces": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "backend",
+              "frontend",
+              "desktop",
+              "extension",
+              "service",
+              "worker",
+              "library",
+              "infra",
+              "docs",
+              "test-suite",
+              "unknown"
+            ]
+          }
+        },
+        "categories": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "backend",
+              "frontend",
+              "desktop",
+              "extension",
+              "library",
+              "infrastructure",
+              "documentation",
+              "quality",
+              "unknown"
+            ]
+          }
+        }
+      },
+      "additionalProperties": true
+    },
     "summary": { "type": "object", "additionalProperties": true },
     "factFreshness": { "$ref": "#/$defs/factFreshnessSummary" },
     "facts": {
@@ -43,20 +82,73 @@
     },
     "projects": {
       "type": "array",
-      "items": { "type": "object", "additionalProperties": true }
+      "items": {
+        "type": "object",
+        "properties": {
+          "kind": {
+            "enum": [
+              "backend",
+              "frontend",
+              "desktop",
+              "extension",
+              "worker",
+              "library",
+              "infra",
+              "docs",
+              "test-suite",
+              "unknown"
+            ]
+          },
+          "category": {
+            "enum": [
+              "backend",
+              "frontend",
+              "desktop",
+              "extension",
+              "library",
+              "infrastructure",
+              "documentation",
+              "quality",
+              "unknown"
+            ]
+          }
+        },
+        "additionalProperties": true
+      }
     },
     "contracts": { "type": "object", "additionalProperties": true },
+    "projectTopology": {
+      "type": "object",
+      "description": "Canonical compact project dependency topology (workspace-dependency-graph.v1).",
+      "additionalProperties": true
+    },
     "graph": {
       "type": "object",
-      "description": "First-class inferred dependency graph (workspace-dependency-graph.v1). Additive/optional.",
+      "deprecated": true,
+      "description": "Deprecated compatibility alias for projectTopology. Producers must emit identical content during the v1 migration window.",
       "additionalProperties": true
     },
     "evidence": { "type": "object", "additionalProperties": true },
     "discovery": { "type": "object", "additionalProperties": true },
     "policies": { "type": "object", "additionalProperties": true },
-    "validation": { "type": "object", "additionalProperties": true }
+    "validation": { "type": "object", "additionalProperties": true },
+    "build": { "$ref": "#/$defs/buildProvenance" }
   },
   "$defs": {
+    "buildProvenance": {
+      "type": "object",
+      "description": "Non-structural provenance for the model command execution. It is excluded from the canonical workspace-model hash.",
+      "required": ["schemaVersion", "mode", "outcome", "engineStatus"],
+      "properties": {
+        "schemaVersion": { "const": "workspace-model-build.v1" },
+        "mode": { "enum": ["full", "cache", "incremental"] },
+        "outcome": { "enum": ["rebuilt", "partially-reused", "reused"] },
+        "engineStatus": {
+          "enum": ["disabled", "miss", "hit", "full", "incremental", "unchanged"]
+        }
+      },
+      "additionalProperties": false
+    },
     "factFreshness": {
       "type": "object",
       "required": [

package/contracts/workspace-intelligence/workspace-operational-skill.v1.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-operational-skill.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-operational-skill.v1.json",
   "title": "Workspai Workspace Operational Skill",
   "type": "object",
   "required": [

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-skills-index.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-skills-index.v1.json",
   "title": "Workspai Workspace Skills Index",
   "type": "object",
   "required": ["schemaVersion", "generatedAt", "inputsHash", "skills"],

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-verify.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-verify.v1.json",
   "title": "Workspai Workspace Verify Last Run",
   "type": "object",
   "required": [