workspai 0.49.0 → 0.51.0

package/contracts/workspace-intelligence/doctor-graph-diagnosis.v1.json

@@ -0,0 +1,208 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/doctor-graph-diagnosis.v1.json",
+  "title": "Workspai Doctor Graph Diagnosis",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "status",
+    "claimBoundary",
+    "graph",
+    "project",
+    "summary",
+    "findings",
+    "diagnostics"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "doctor-graph-diagnosis.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "status": {
+      "enum": [
+        "available",
+        "graph-missing",
+        "model-missing",
+        "stale",
+        "project-unresolved",
+        "invalid"
+      ]
+    },
+    "claimBoundary": { "type": "string", "minLength": 1 },
+    "graph": {
+      "type": "object",
+      "required": ["artifact"],
+      "properties": {
+        "artifact": { "const": ".workspai/reports/workspace-knowledge-graph.json" },
+        "schemaVersion": { "type": "string" },
+        "sourceArtifact": { "type": "string" },
+        "sourceHash": { "type": "string" },
+        "entityCount": { "type": "integer", "minimum": 0 },
+        "relationCount": { "type": "integer", "minimum": 0 },
+        "proofCount": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "project": {
+      "type": "object",
+      "required": ["name", "path"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "path": { "type": "string" },
+        "entityId": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "summary": {
+      "type": "object",
+      "required": [
+        "findingCount",
+        "rootEntityCount",
+        "affectedEntityCount",
+        "verificationTargetCount",
+        "proofPathCount",
+        "subjectCount",
+        "unresolvedSubjectCount",
+        "unknownCount"
+      ],
+      "properties": {
+        "findingCount": { "type": "integer", "minimum": 0 },
+        "rootEntityCount": { "type": "integer", "minimum": 0 },
+        "affectedEntityCount": { "type": "integer", "minimum": 0 },
+        "verificationTargetCount": { "type": "integer", "minimum": 0 },
+        "proofPathCount": { "type": "integer", "minimum": 0 },
+        "subjectCount": { "type": "integer", "minimum": 0 },
+        "unresolvedSubjectCount": { "type": "integer", "minimum": 0 },
+        "unknownCount": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" }
+    },
+    "diagnostics": { "type": "array", "items": { "type": "string" } }
+  },
+  "$defs": {
+    "entityRef": {
+      "type": "object",
+      "required": ["id", "kind", "label"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "kind": {
+          "enum": [
+            "workspace",
+            "project",
+            "service",
+            "api",
+            "endpoint",
+            "schema",
+            "package",
+            "module",
+            "file",
+            "symbol",
+            "database",
+            "queue",
+            "container",
+            "deployment",
+            "pipeline",
+            "environment",
+            "document",
+            "decision",
+            "test-suite",
+            "owner"
+          ]
+        },
+        "label": { "type": "string", "minLength": 1 },
+        "projectId": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "hop": {
+      "type": "object",
+      "required": ["from", "to", "relationId", "kind", "direction", "proofIds"],
+      "properties": {
+        "from": { "type": "string", "minLength": 1 },
+        "to": { "type": "string", "minLength": 1 },
+        "relationId": { "type": "string", "minLength": 1 },
+        "kind": {
+          "enum": [
+            "contains",
+            "defines",
+            "imports",
+            "depends-on",
+            "exposes",
+            "implements",
+            "calls",
+            "reads-from",
+            "writes-to",
+            "publishes",
+            "consumes",
+            "deploys",
+            "runs-on",
+            "routes-to",
+            "documents",
+            "decided-by",
+            "tests",
+            "owns",
+            "generated-by",
+            "configured-by",
+            "references"
+          ]
+        },
+        "direction": { "enum": ["forward", "reverse"] },
+        "proofIds": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "proofPath": {
+      "type": "object",
+      "required": ["from", "to", "entityPath", "hops", "proofIds"],
+      "properties": {
+        "from": { "type": "string", "minLength": 1 },
+        "to": { "type": "string", "minLength": 1 },
+        "entityPath": { "type": "array", "items": { "type": "string" } },
+        "hops": { "type": "array", "items": { "$ref": "#/$defs/hop" } },
+        "proofIds": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "finding": {
+      "type": "object",
+      "required": [
+        "issueId",
+        "issueClass",
+        "status",
+        "reason",
+        "scope",
+        "subjects",
+        "unresolvedSubjects",
+        "rootEntities",
+        "affectedEntities",
+        "verificationTargets",
+        "proofPaths",
+        "sourceArtifacts",
+        "unknowns"
+      ],
+      "properties": {
+        "issueId": { "type": "string", "minLength": 1 },
+        "issueClass": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["warn", "fail"] },
+        "reason": { "type": "string", "minLength": 1 },
+        "scope": { "const": "structural-impact-candidates" },
+        "subjects": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "unresolvedSubjects": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "rootEntities": { "type": "array", "items": { "$ref": "#/$defs/entityRef" } },
+        "affectedEntities": { "type": "array", "items": { "$ref": "#/$defs/entityRef" } },
+        "verificationTargets": { "type": "array", "items": { "$ref": "#/$defs/entityRef" } },
+        "proofPaths": { "type": "array", "items": { "$ref": "#/$defs/proofPath" } },
+        "sourceArtifacts": { "type": "array", "items": { "type": "string" } },
+        "unknowns": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/workspace-intelligence/fact-freshness.v1.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/fact-freshness.v1.json",
-  "title": "RapidKit Fact Freshness Contract",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/fact-freshness.v1.json",
+  "title": "Workspai Fact Freshness Contract",
   "type": "object",
   "required": [
     "schemaVersion",

package/contracts/workspace-intelligence/mcp-design.v1.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/mcp-design.v1.json",
+  "title": "Workspai MCP Design",
   "type": "object",
   "required": [
     "schemaVersion",

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/model-usage-event.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/model-usage-event.v1.json",
   "title": "Workspai Model and Agent Usage Event",
   "description": "A privacy-bounded usage observation. Prompt and response bodies are deliberately excluded; consumers may provide hashes instead.",
   "type": "object",

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

@@ -0,0 +1,360 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/project-context-agent.v1.json",
+  "title": "Workspai Project Context for Agents",
+  "description": "Portable, bounded project lens derived from the canonical Workspace Model and evidence-backed Knowledge Graph.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "workspace",
+    "project",
+    "intelligence",
+    "evidence",
+    "blockers",
+    "commands",
+    "integrity"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "project-context-agent.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "workspace": {
+      "type": "object",
+      "required": ["name", "relationship", "contract", "model", "knowledgeGraph", "access"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "profile": { "type": "string" },
+        "relationship": {
+          "enum": ["managed", "adopted", "imported", "linked", "restored"]
+        },
+        "contract": { "const": ".workspai/workspace.contract.json" },
+        "model": { "const": ".workspai/reports/workspace-model.json" },
+        "knowledgeGraph": {
+          "const": ".workspai/reports/workspace-knowledge-graph.json"
+        },
+        "access": {
+          "type": "object",
+          "required": ["localBinding", "canonicalEvidenceAvailableAtGeneration"],
+          "properties": {
+            "localBinding": { "const": ".workspai/workspace-link.local.json" },
+            "canonicalEvidenceAvailableAtGeneration": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "project": {
+      "type": "object",
+      "required": ["name", "relativePath", "commands", "importantFiles"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "relativePath": {
+          "type": "string",
+          "minLength": 1,
+          "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
+        },
+        "kind": { "type": "string" },
+        "runtime": { "type": "string" },
+        "framework": { "type": "string" },
+        "kit": { "type": "string" },
+        "supportTier": { "type": "string" },
+        "commands": {
+          "type": "object",
+          "required": ["supported", "unsupported", "fleetStages"],
+          "properties": {
+            "supported": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+            "unsupported": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+            "fleetStages": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+          },
+          "additionalProperties": false
+        },
+        "importantFiles": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
+          },
+          "uniqueItems": true
+        }
+      },
+      "additionalProperties": false
+    },
+    "intelligence": {
+      "type": "object",
+      "required": [
+        "entityCount",
+        "relationCount",
+        "proofCount",
+        "entitiesByKind",
+        "relationsByKind",
+        "relatedProjects",
+        "freshness",
+        "topology",
+        "surfaces",
+        "diagnostics"
+      ],
+      "properties": {
+        "modelGeneratedAt": { "type": "string", "format": "date-time" },
+        "graphGeneratedAt": { "type": "string", "format": "date-time" },
+        "graphModelHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "entityCount": { "type": "integer", "minimum": 0 },
+        "relationCount": { "type": "integer", "minimum": 0 },
+        "proofCount": { "type": "integer", "minimum": 0 },
+        "entitiesByKind": {
+          "type": "object",
+          "additionalProperties": { "type": "integer", "minimum": 0 }
+        },
+        "relationsByKind": {
+          "type": "object",
+          "additionalProperties": { "type": "integer", "minimum": 0 }
+        },
+        "relatedProjects": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true
+        },
+        "freshness": {
+          "type": "object",
+          "required": ["model", "graph", "graphMatchesModel"],
+          "properties": {
+            "model": { "enum": ["fresh", "stale", "unknown", "missing"] },
+            "graph": { "enum": ["fresh", "stale", "unknown", "missing"] },
+            "graphMatchesModel": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        },
+        "topology": {
+          "type": "object",
+          "required": ["status", "dependencies", "dependents"],
+          "properties": {
+            "status": { "enum": ["proven", "unproven", "unavailable"] },
+            "dependencies": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/topologyRelation" },
+              "maxItems": 128
+            },
+            "dependents": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/topologyRelation" },
+              "maxItems": 128
+            }
+          },
+          "additionalProperties": false
+        },
+        "surfaces": {
+          "type": "object",
+          "required": [
+            "services",
+            "apis",
+            "endpoints",
+            "dataStores",
+            "deployments",
+            "pipelines",
+            "tests",
+            "owners",
+            "decisions",
+            "ports"
+          ],
+          "properties": {
+            "services": { "$ref": "#/$defs/entityList" },
+            "apis": { "$ref": "#/$defs/entityList" },
+            "endpoints": { "$ref": "#/$defs/entityList" },
+            "dataStores": { "$ref": "#/$defs/entityList" },
+            "deployments": { "$ref": "#/$defs/entityList" },
+            "pipelines": { "$ref": "#/$defs/entityList" },
+            "tests": { "$ref": "#/$defs/entityList" },
+            "owners": { "$ref": "#/$defs/entityList" },
+            "decisions": { "$ref": "#/$defs/entityList" },
+            "ports": {
+              "type": "array",
+              "maxItems": 32,
+              "items": { "$ref": "#/$defs/port" }
+            }
+          },
+          "additionalProperties": false
+        },
+        "diagnostics": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["code", "severity", "message"],
+            "properties": {
+              "code": { "type": "string" },
+              "severity": { "type": "string" },
+              "message": { "type": "string" },
+              "recommendation": { "type": "string" }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "evidence": {
+      "type": "object",
+      "required": ["readOrder", "projectProofArtifacts", "relations", "proofs"],
+      "properties": {
+        "readOrder": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "projectProofArtifacts": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
+          },
+          "uniqueItems": true
+        },
+        "relations": {
+          "type": "array",
+          "maxItems": 128,
+          "items": { "$ref": "#/$defs/relation" }
+        },
+        "proofs": {
+          "type": "array",
+          "maxItems": 128,
+          "items": { "$ref": "#/$defs/proof" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "blockers": {
+      "type": "array",
+      "maxItems": 32,
+      "items": { "$ref": "#/$defs/blocker" }
+    },
+    "commands": {
+      "type": "object",
+      "required": ["refresh", "verify", "graphSearch", "doctor", "workspaceStatus"],
+      "properties": {
+        "refresh": { "type": "string", "minLength": 1 },
+        "verify": { "type": "string", "minLength": 1 },
+        "graphSearch": { "type": "string", "minLength": 1 },
+        "doctor": { "type": "string", "minLength": 1 },
+        "workspaceStatus": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "integrity": {
+      "type": "object",
+      "required": ["algorithm", "payloadHash", "portable", "absolutePathsEmitted"],
+      "properties": {
+        "algorithm": { "const": "sha256" },
+        "modelHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "payloadHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "portable": { "const": true },
+        "absolutePathsEmitted": { "const": false }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "portableString": {
+      "type": "string",
+      "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
+    },
+    "topologyRelation": {
+      "type": "object",
+      "required": ["project", "kind", "source", "confidence", "evidence"],
+      "properties": {
+        "project": { "type": "string", "minLength": 1 },
+        "kind": { "type": "string", "minLength": 1 },
+        "source": { "type": "string", "minLength": 1 },
+        "confidence": { "type": "string", "minLength": 1 },
+        "evidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/portableString" },
+          "uniqueItems": true
+        }
+      },
+      "additionalProperties": false
+    },
+    "entityList": {
+      "type": "array",
+      "maxItems": 32,
+      "items": { "$ref": "#/$defs/entity" }
+    },
+    "entity": {
+      "type": "object",
+      "required": ["id", "kind", "label", "attributes", "proofIds"],
+      "properties": {
+        "id": { "type": "string" },
+        "kind": { "type": "string" },
+        "label": { "type": "string" },
+        "attributes": { "type": "object", "additionalProperties": true },
+        "proofIds": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+      },
+      "additionalProperties": false
+    },
+    "port": {
+      "type": "object",
+      "required": ["entityId", "label", "attribute", "value"],
+      "properties": {
+        "entityId": { "type": "string" },
+        "label": { "type": "string" },
+        "attribute": { "type": "string" },
+        "value": true
+      },
+      "additionalProperties": false
+    },
+    "relation": {
+      "type": "object",
+      "required": [
+        "id",
+        "from",
+        "to",
+        "kind",
+        "derivation",
+        "trust",
+        "confidence",
+        "proofIds"
+      ],
+      "properties": {
+        "id": { "type": "string" },
+        "from": { "type": "string" },
+        "to": { "type": "string" },
+        "kind": { "type": "string" },
+        "derivation": { "type": "string" },
+        "trust": { "type": "string" },
+        "confidence": { "type": "string" },
+        "proofIds": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+      },
+      "additionalProperties": false
+    },
+    "proof": {
+      "type": "object",
+      "required": [
+        "id",
+        "provider",
+        "artifact",
+        "derivation",
+        "trust",
+        "confidence",
+        "freshness"
+      ],
+      "properties": {
+        "id": { "type": "string" },
+        "provider": { "type": "string" },
+        "artifact": { "$ref": "#/$defs/portableString" },
+        "pointer": { "type": "string" },
+        "line": { "type": "integer", "minimum": 1 },
+        "derivation": { "type": "string" },
+        "trust": { "type": "string" },
+        "confidence": { "type": "string" },
+        "freshness": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "blocker": {
+      "type": "object",
+      "required": ["source", "severity", "message"],
+      "properties": {
+        "source": { "type": "string" },
+        "severity": { "enum": ["warning", "error"] },
+        "message": { "type": "string" },
+        "code": { "type": "string" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/studio-blocker-handoff.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/studio-blocker-handoff.v1.json",
   "title": "Workspai Studio Blocker Handoff",
   "type": "object",
   "required": [

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

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

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

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "workspace-contract-verify.v1",
-  "title": "Workspace contract verify evidence",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-contract-verify.v1.json",
+  "title": "Workspai Workspace Contract Verify Evidence",
   "type": "object",
   "additionalProperties": true,
   "required": [

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-dependency-graph.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-dependency-graph.v1.json",
   "title": "Workspai Workspace Dependency Graph",
   "description": "First-class, versioned dependency graph of inter-project relationships consumed by impact, verify, run --blast-radius, and risk weighting.",
   "type": "object",

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-explain.v1.json",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/workspace-explain.v1.json",
   "title": "Workspai Workspace Explain Report",
   "type": "object",
   "required": ["schemaVersion", "generatedAt", "workspacePath", "target", "summary", "sections"],

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/workspace-graph-stream.v1.json",
+  "$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",

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",