workspai 0.64.0 → 0.66.0

package/contracts/workspace-contract.v1.json

@@ -31,7 +31,20 @@
           "runtime": { "type": "string", "minLength": 1 },
           "framework": { "type": "string", "minLength": 1 },
           "kit": { "type": "string", "minLength": 1 },
-          "modules": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+          "governance": {
+            "type": "object",
+            "properties": {
+              "ci": { "$ref": "#/$defs/governanceControl" },
+              "release": { "$ref": "#/$defs/governanceControl" },
+              "ownership": { "$ref": "#/$defs/governanceControl" }
+            },
+            "additionalProperties": false
+          },
+          "modules": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "uniqueItems": true
+          },
           "ports": {
             "type": "array",
             "items": {
@@ -49,7 +62,11 @@
             "type": "object",
             "required": ["owns", "apis", "publishes", "consumes", "dependsOn", "env"],
             "properties": {
-              "owns": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+              "owns": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
               "apis": {
                 "type": "array",
                 "items": {
@@ -62,10 +79,26 @@
                   "additionalProperties": false
                 }
               },
-              "publishes": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
-              "consumes": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
-              "dependsOn": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
-              "env": { "type": "array", "items": { "type": "string", "pattern": "^[A-Z_][A-Z0-9_]*$" }, "uniqueItems": true }
+              "publishes": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
+              "consumes": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
+              "dependsOn": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
+              "env": {
+                "type": "array",
+                "items": { "type": "string", "pattern": "^[A-Z_][A-Z0-9_]*$" },
+                "uniqueItems": true
+              }
             },
             "additionalProperties": false
           }
@@ -74,5 +107,17 @@
       }
     }
   },
+  "$defs": {
+    "governanceControl": {
+      "type": "object",
+      "required": ["mode"],
+      "properties": {
+        "mode": { "enum": ["repository", "external"] },
+        "provider": { "type": "string", "minLength": 1 },
+        "reference": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    }
+  },
   "additionalProperties": false
 }

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

@@ -10,6 +10,8 @@
     "generatedAt",
     "receiptId",
     "status",
+    "statusScope",
+    "readiness",
     "requestedAgent",
     "resolvedHost",
     "project",
@@ -28,6 +30,18 @@
     "generatedAt": { "type": "string", "format": "date-time" },
     "receiptId": { "$ref": "#/$defs/hash" },
     "status": { "$ref": "#/$defs/status" },
+    "statusScope": { "const": "agent-grounding" },
+    "readiness": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["agentGrounding", "architectureEvidence", "projectEnvironment", "release"],
+      "properties": {
+        "agentGrounding": { "$ref": "#/$defs/status" },
+        "architectureEvidence": { "$ref": "#/$defs/status" },
+        "projectEnvironment": { "enum": ["ready", "degraded", "blocked"] },
+        "release": { "enum": ["not-verified", "degraded", "blocked"] }
+      }
+    },
     "requestedAgent": {
       "enum": [
         "generic",
@@ -127,6 +141,9 @@
       ],
       "properties": {
         "projectContext": { "const": ".workspai/reports/project-context-agent.json" },
+        "projectKnowledgeGraph": {
+          "const": ".workspai/reports/project-knowledge-graph-reference.json"
+        },
         "workspaceIndex": { "const": "workspace:.workspai/reports/INDEX.json" },
         "workspaceContext": {
           "const": "workspace:.workspai/reports/workspace-context-agent.json"

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

@@ -9,8 +9,10 @@
     "workspaceRoot",
     "status",
     "mode",
+    "runtime",
     "safety",
-    "candidateTools"
+    "candidateTools",
+    "plannedTools"
   ],
   "properties": {
     "schemaVersion": {
@@ -25,11 +27,50 @@
       "minLength": 1
     },
     "status": {
-      "const": "design-only"
+      "const": "implemented"
     },
     "mode": {
       "const": "read-mostly"
     },
+    "runtime": {
+      "type": "object",
+      "required": [
+        "command",
+        "transport",
+        "lifecycle",
+        "supportedProtocolVersions",
+        "structuredContent",
+        "toolExecutionErrors"
+      ],
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "transport": {
+          "const": "stdio-jsonrpc"
+        },
+        "lifecycle": {
+          "const": "dual-era"
+        },
+        "supportedProtocolVersions": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+          },
+          "uniqueItems": true,
+          "minItems": 1
+        },
+        "structuredContent": {
+          "const": true
+        },
+        "toolExecutionErrors": {
+          "const": true
+        }
+      },
+      "additionalProperties": false
+    },
     "safety": {
       "type": "object"
     },
@@ -38,6 +79,12 @@
       "items": {
         "type": "object"
       }
+    },
+    "plannedTools": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
     }
   },
   "additionalProperties": true

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

@@ -66,6 +66,9 @@
       "properties": {
         "projectContext": { "const": ".workspai/reports/project-context-agent.json" },
         "projectGrounding": { "const": ".workspai/PROJECT-GROUNDING.md" },
+        "projectKnowledgeGraph": {
+          "const": ".workspai/reports/project-knowledge-graph-reference.json"
+        },
         "goalIndex": { "const": "workspace:.workspai/goals/index.json" },
         "workspaceIndex": { "const": "workspace:.workspai/reports/INDEX.json" },
         "workspaceContext": {

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

@@ -29,6 +29,9 @@
           "enum": ["managed", "adopted", "imported", "linked", "restored"]
         },
         "contract": { "const": "workspace:.workspai/workspace.contract.json" },
+        "projectKnowledgeGraph": {
+          "const": ".workspai/reports/project-knowledge-graph-reference.json"
+        },
         "model": { "const": "workspace:.workspai/reports/workspace-model.json" },
         "knowledgeGraph": {
           "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
@@ -108,6 +111,7 @@
         "framework": { "type": "string" },
         "kit": { "type": "string" },
         "supportTier": { "type": "string" },
+        "governance": { "$ref": "#/$defs/projectGovernance" },
         "commands": {
           "type": "object",
           "required": ["supported", "unsupported", "fleetStages"],
@@ -139,6 +143,7 @@
         "relationsByKind",
         "languages",
         "semantic",
+        "projection",
         "relatedProjects",
         "freshness",
         "topology",
@@ -199,6 +204,41 @@
           },
           "additionalProperties": false
         },
+        "projection": {
+          "description": "Observable bounds for the representative entity projection. Counts remain exhaustive; omitted entities are available through bounded graph search.",
+          "type": "object",
+          "required": [
+            "mode",
+            "maxEntities",
+            "byteBudget",
+            "selectedBytes",
+            "eligibleCount",
+            "selectedCount",
+            "omittedCount",
+            "selectedByKind",
+            "omittedByKind",
+            "continuationCommand"
+          ],
+          "properties": {
+            "mode": { "const": "stratified-byte-bounded" },
+            "maxEntities": { "type": "integer", "minimum": 1 },
+            "byteBudget": { "type": "integer", "minimum": 1 },
+            "selectedBytes": { "type": "integer", "minimum": 0 },
+            "eligibleCount": { "type": "integer", "minimum": 0 },
+            "selectedCount": { "type": "integer", "minimum": 0 },
+            "omittedCount": { "type": "integer", "minimum": 0 },
+            "selectedByKind": {
+              "type": "object",
+              "additionalProperties": { "type": "integer", "minimum": 0 }
+            },
+            "omittedByKind": {
+              "type": "object",
+              "additionalProperties": { "type": "integer", "minimum": 1 }
+            },
+            "continuationCommand": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
         "relatedProjects": {
           "type": "array",
           "items": { "type": "string" },
@@ -222,12 +262,12 @@
             "dependencies": {
               "type": "array",
               "items": { "$ref": "#/$defs/topologyRelation" },
-              "maxItems": 128
+              "maxItems": 16
             },
             "dependents": {
               "type": "array",
               "items": { "$ref": "#/$defs/topologyRelation" },
-              "maxItems": 128
+              "maxItems": 16
             }
           },
           "additionalProperties": false
@@ -266,7 +306,7 @@
             "decisions": { "$ref": "#/$defs/entityList" },
             "ports": {
               "type": "array",
-              "maxItems": 32,
+              "maxItems": 8,
               "items": { "$ref": "#/$defs/port" }
             }
           },
@@ -274,6 +314,7 @@
         },
         "diagnostics": {
           "type": "array",
+          "maxItems": 16,
           "items": {
             "type": "object",
             "required": ["code", "severity", "message"],
@@ -293,23 +334,24 @@
       "type": "object",
       "required": ["readOrder", "projectProofArtifacts", "relations", "proofs"],
       "properties": {
-        "readOrder": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "readOrder": { "type": "array", "maxItems": 12, "items": { "type": "string" }, "uniqueItems": true },
         "projectProofArtifacts": {
           "type": "array",
           "items": {
             "type": "string",
             "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
           },
-          "uniqueItems": true
+          "uniqueItems": true,
+          "maxItems": 24
         },
         "relations": {
           "type": "array",
-          "maxItems": 128,
+          "maxItems": 16,
           "items": { "$ref": "#/$defs/relation" }
         },
         "proofs": {
           "type": "array",
-          "maxItems": 128,
+          "maxItems": 16,
           "items": { "$ref": "#/$defs/proof" }
         }
       },
@@ -383,6 +425,7 @@
         "requiredReadOrder": {
           "type": "array",
           "minItems": 4,
+          "maxItems": 10,
           "uniqueItems": true,
           "items": { "type": "string", "minLength": 1 }
         },
@@ -424,6 +467,34 @@
     }
   },
   "$defs": {
+    "governanceControl": {
+      "type": "object",
+      "required": ["status", "provider", "evidence", "reference"],
+      "properties": {
+        "status": {
+          "enum": ["repository", "external-declared", "external-observed", "unknown"]
+        },
+        "provider": { "type": ["string", "null"] },
+        "evidence": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "reference": { "type": ["string", "null"] }
+      },
+      "additionalProperties": false
+    },
+    "projectGovernance": {
+      "type": "object",
+      "required": ["schemaVersion", "ci", "release", "ownership"],
+      "properties": {
+        "schemaVersion": { "const": "workspai.project-governance.v1" },
+        "ci": { "$ref": "#/$defs/governanceControl" },
+        "release": { "$ref": "#/$defs/governanceControl" },
+        "ownership": { "$ref": "#/$defs/governanceControl" }
+      },
+      "additionalProperties": false
+    },
     "portableString": {
       "type": "string",
       "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }

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

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/project-knowledge-graph-reference.v1.json",
+  "title": "Workspai Project Knowledge Graph Reference",
+  "description": "Portable, integrity-bound project reference to the canonical workspace Knowledge Graph.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "generatedAt", "project", "canonical", "summary", "integrity"],
+  "properties": {
+    "schemaVersion": { "const": "project-knowledge-graph-reference.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": { "name": { "type": "string", "minLength": 1 } }
+    },
+    "canonical": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["graph", "boundedQuery", "sourceHash", "projectionHash"],
+      "properties": {
+        "graph": { "const": "workspace:.workspai/reports/workspace-knowledge-graph.json" },
+        "boundedQuery": { "type": "string", "minLength": 1 },
+        "sourceHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "projectionHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["entityCount", "relationCount", "proofCount"],
+      "properties": {
+        "entityCount": { "type": "integer", "minimum": 0 },
+        "relationCount": { "type": "integer", "minimum": 0 },
+        "proofCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["algorithm", "payloadHash", "portable", "absolutePathsEmitted"],
+      "properties": {
+        "algorithm": { "const": "sha256" },
+        "payloadHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "portable": { "const": true },
+        "absolutePathsEmitted": { "const": false }
+      }
+    }
+  }
+}

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

@@ -50,7 +50,15 @@
               "type": "array",
               "items": {
                 "type": "object",
-                "required": ["kind", "id", "strategy", "hash", "fileCount", "fileLimit", "truncated"],
+                "required": [
+                  "kind",
+                  "id",
+                  "strategy",
+                  "hash",
+                  "fileCount",
+                  "fileLimit",
+                  "truncated"
+                ],
                 "properties": {
                   "kind": { "enum": ["workspace", "project"] },
                   "id": { "type": "string", "minLength": 1 },
@@ -58,7 +66,33 @@
                   "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
                   "fileCount": { "type": "integer", "minimum": 0 },
                   "fileLimit": { "type": "integer", "minimum": 1 },
-                  "truncated": { "type": "boolean" }
+                  "truncated": { "type": "boolean" },
+                  "eligibleFileCount": { "type": "integer", "minimum": 0 },
+                  "eligibleFileCountExact": { "type": "boolean" },
+                  "inventoryMode": { "enum": ["complete", "emergency-bounded"] },
+                  "inventoryStrategy": {
+                    "enum": ["git-index-worktree-v1", "filesystem-bfs-v1"]
+                  },
+                  "selection": {
+                    "type": "object",
+                    "required": [
+                      "strategy",
+                      "semanticFileCount",
+                      "semanticFileBudget",
+                      "deepFileCount",
+                      "deepFileBudget",
+                      "sourceExtractionFileBudget"
+                    ],
+                    "properties": {
+                      "strategy": { "const": "component-language-round-robin-v1" },
+                      "semanticFileCount": { "type": "integer", "minimum": 0 },
+                      "semanticFileBudget": { "type": "integer", "minimum": 1 },
+                      "deepFileCount": { "type": "integer", "minimum": 0 },
+                      "deepFileBudget": { "type": "integer", "minimum": 1 },
+                      "sourceExtractionFileBudget": { "type": "integer", "minimum": 1 }
+                    },
+                    "additionalProperties": false
+                  }
                 },
                 "additionalProperties": false
               }
@@ -252,7 +286,37 @@
           "discoveredEntities": { "type": "integer", "minimum": 0 },
           "discoveredRelations": { "type": "integer", "minimum": 0 },
           "proofCount": { "type": "integer", "minimum": 0 },
-          "diagnostics": { "type": "array", "items": { "type": "string" } }
+          "diagnostics": { "type": "array", "items": { "type": "string" } },
+          "inputCoverage": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "scope",
+                "scopeId",
+                "tier",
+                "status",
+                "eligibleFiles",
+                "suppliedFiles",
+                "selectionStrategy"
+              ],
+              "properties": {
+                "scope": { "enum": ["workspace", "project"] },
+                "scopeId": { "type": "string", "minLength": 1 },
+                "tier": {
+                  "enum": ["complete-inventory", "adaptive-semantic", "adaptive-deep", "derived"]
+                },
+                "status": { "enum": ["complete", "bounded", "not-applicable"] },
+                "eligibleFiles": { "type": "integer", "minimum": 0 },
+                "suppliedFiles": { "type": "integer", "minimum": 0 },
+                "fileBudget": { "type": "integer", "minimum": 1 },
+                "selectionStrategy": {
+                  "enum": ["complete", "component-language-round-robin-v1", "derived"]
+                }
+              },
+              "additionalProperties": false
+            }
+          }
         },
         "additionalProperties": false
       }
@@ -284,18 +348,59 @@
           "type": "object",
           "required": [
             "apiImplementation",
+            "apiRuntimeRegistration",
             "projectTests",
             "projectDeployment",
             "projectOwnership"
           ],
           "properties": {
             "apiImplementation": { "$ref": "#/$defs/bindingCoverage" },
+            "apiRuntimeRegistration": { "$ref": "#/$defs/bindingCoverage" },
             "projectTests": { "$ref": "#/$defs/bindingCoverage" },
             "projectDeployment": { "$ref": "#/$defs/bindingCoverage" },
             "projectOwnership": { "$ref": "#/$defs/bindingCoverage" }
           },
           "additionalProperties": false
         },
+        "completeness": {
+          "type": "object",
+          "required": ["status", "inventory", "providers"],
+          "properties": {
+            "status": { "enum": ["complete", "bounded"] },
+            "inventory": {
+              "type": "object",
+              "required": [
+                "scopeCount",
+                "completeScopes",
+                "boundedScopes",
+                "eligibleFiles",
+                "indexedFiles",
+                "eligibleFileCountExact"
+              ],
+              "properties": {
+                "scopeCount": { "type": "integer", "minimum": 0 },
+                "completeScopes": { "type": "integer", "minimum": 0 },
+                "boundedScopes": { "type": "integer", "minimum": 0 },
+                "eligibleFiles": { "type": "integer", "minimum": 0 },
+                "indexedFiles": { "type": "integer", "minimum": 0 },
+                "eligibleFileCountExact": { "type": "boolean" }
+              },
+              "additionalProperties": false
+            },
+            "providers": {
+              "type": "object",
+              "required": ["complete", "bounded", "notApplicable", "failed"],
+              "properties": {
+                "complete": { "type": "integer", "minimum": 0 },
+                "bounded": { "type": "integer", "minimum": 0 },
+                "notApplicable": { "type": "integer", "minimum": 0 },
+                "failed": { "type": "integer", "minimum": 0 }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
         "portable": { "const": true },
         "secretValuesEmitted": { "const": false }
       },

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

@@ -47,6 +47,7 @@
               "extension",
               "service",
               "worker",
+              "platform",
               "library",
               "infra",
               "docs",
@@ -63,6 +64,7 @@
               "frontend",
               "desktop",
               "extension",
+              "platform",
               "library",
               "infrastructure",
               "documentation",
@@ -92,6 +94,7 @@
               "desktop",
               "extension",
               "worker",
+              "platform",
               "library",
               "infra",
               "docs",
@@ -105,13 +108,15 @@
               "frontend",
               "desktop",
               "extension",
+              "platform",
               "library",
               "infrastructure",
               "documentation",
               "quality",
               "unknown"
             ]
-          }
+          },
+          "governance": { "$ref": "#/$defs/projectGovernance" }
         },
         "additionalProperties": true
       }
@@ -135,6 +140,28 @@
     "build": { "$ref": "#/$defs/buildProvenance" }
   },
   "$defs": {
+    "projectGovernance": {
+      "type": "object",
+      "required": ["schemaVersion", "ci", "release", "ownership"],
+      "properties": {
+        "schemaVersion": { "const": "workspai.project-governance.v1" },
+        "ci": { "$ref": "#/$defs/governanceControl" },
+        "release": { "$ref": "#/$defs/governanceControl" },
+        "ownership": { "$ref": "#/$defs/governanceControl" }
+      },
+      "additionalProperties": false
+    },
+    "governanceControl": {
+      "type": "object",
+      "required": ["status", "provider", "evidence", "reference"],
+      "properties": {
+        "status": { "enum": ["repository", "external-declared", "external-observed", "unknown"] },
+        "provider": { "type": ["string", "null"] },
+        "evidence": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "reference": { "type": ["string", "null"] }
+      },
+      "additionalProperties": false
+    },
     "buildProvenance": {
       "type": "object",
       "description": "Non-structural provenance for the model command execution. It is excluded from the canonical workspace-model hash.",