workspai 0.45.0 → 0.47.0

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

@@ -9,6 +9,7 @@
     "agent",
     "workspaceSummary",
     "modelRef",
+    "knowledgeGraph",
     "intelligenceChain",
     "workspace",
     "scope",
@@ -29,6 +30,25 @@
     },
     "workspaceSummary": { "type": "string" },
     "modelRef": { "type": "string" },
+    "knowledgeGraph": {
+      "type": "object",
+      "required": ["artifact", "schemaVersion", "available", "queryCommands"],
+      "properties": {
+        "artifact": { "const": ".workspai/reports/workspace-knowledge-graph.json" },
+        "schemaVersion": { "const": "workspace-knowledge-graph.v1" },
+        "available": { "type": "boolean" },
+        "entityCount": { "type": "integer", "minimum": 0 },
+        "relationCount": { "type": "integer", "minimum": 0 },
+        "proofCount": { "type": "integer", "minimum": 0 },
+        "queryCommands": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "minItems": 3,
+          "uniqueItems": true
+        }
+      },
+      "additionalProperties": false
+    },
     "intelligenceChain": {
       "type": "object",
       "required": ["schemaVersion", "contractPath", "currentStep", "canonicalReadOrder"],

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

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/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",
+  "required": ["schemaVersion", "generatedAt", "workspacePath", "query", "graph", "methodology", "corpus", "retrieval", "savings"],
+  "properties": {
+    "schemaVersion": { "const": "workspace-graph-token-efficiency.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "workspacePath": { "type": "string", "minLength": 1 },
+    "query": { "type": "string", "minLength": 1 },
+    "graph": {
+      "type": "object",
+      "required": ["schemaVersion", "sourceArtifact", "sourceHash", "entityCount", "relationCount", "proofCount"],
+      "properties": {
+        "schemaVersion": { "const": "workspace-knowledge-graph.v1" },
+        "sourceArtifact": { "type": "string", "minLength": 1 },
+        "sourceHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "entityCount": { "type": "integer", "minimum": 0 },
+        "relationCount": { "type": "integer", "minimum": 0 },
+        "proofCount": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "methodology": {
+      "type": "object",
+      "required": ["id", "estimated", "charsPerToken", "claimBoundary"],
+      "properties": {
+        "id": { "const": "indexed-corpus-vs-bounded-retrieval.v1" },
+        "estimated": { "const": true },
+        "charsPerToken": { "const": 4 },
+        "claimBoundary": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "corpus": {
+      "type": "object",
+      "required": ["artifactCount", "characterCount", "estimatedTokens", "unreadableArtifacts"],
+      "properties": {
+        "artifactCount": { "type": "integer", "minimum": 0 },
+        "characterCount": { "type": "integer", "minimum": 0 },
+        "estimatedTokens": { "type": "integer", "minimum": 0 },
+        "unreadableArtifacts": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+      },
+      "additionalProperties": false
+    },
+    "retrieval": {
+      "type": "object",
+      "required": ["matchCount", "characterCount", "estimatedTokens", "truncated", "payload"],
+      "properties": {
+        "matchCount": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "characterCount": { "type": "integer", "minimum": 0 },
+        "estimatedTokens": { "type": "integer", "minimum": 0 },
+        "truncated": { "type": "boolean" },
+        "payload": { "$ref": "workspace-knowledge-search.v1.json" }
+      },
+      "additionalProperties": false
+    },
+    "savings": {
+      "type": "object",
+      "required": ["estimatedTokensAvoided", "reductionRatio", "reductionPercent"],
+      "properties": {
+        "estimatedTokensAvoided": { "type": "integer", "minimum": 0 },
+        "reductionRatio": { "type": "number", "minimum": 0 },
+        "reductionPercent": { "type": "number", "minimum": 0, "maximum": 100 }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,212 @@
+{
+  "$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",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "chainSchemaVersion",
+    "generatedAt",
+    "workspacePath",
+    "baselineCreated",
+    "preflight",
+    "status",
+    "exitCode",
+    "stages",
+    "artifactPath"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspace-intelligence-run.v1" },
+    "chainSchemaVersion": { "const": "workspai-workspace-intelligence-chain-v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "workspacePath": { "type": "string", "minLength": 1 },
+    "baselineCreated": { "type": "boolean" },
+    "preflight": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 2,
+      "prefixItems": [
+        {
+          "$ref": "#/$defs/preflight",
+          "type": "object",
+          "properties": {
+            "id": { "const": "sync" },
+            "status": { "enum": ["passed", "failed"] },
+            "result": { "enum": ["synchronized", "failed"] },
+            "artifacts": {
+              "const": [".workspai/workspace.contract.json", ".workspai/workspace-registry.v1.json"]
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/preflight",
+          "type": "object",
+          "properties": {
+            "id": { "const": "baseline" },
+            "status": { "enum": ["passed", "failed", "skipped"] },
+            "result": { "enum": ["created", "reused", "failed", "skipped"] },
+            "artifacts": {
+              "const": [".workspai/reports/workspace-model-snapshot.json"]
+            }
+          }
+        }
+      ],
+      "items": false
+    },
+    "status": { "enum": ["passed", "blocked", "failed"] },
+    "exitCode": { "enum": [0, 1, 2] },
+    "artifactPath": {
+      "const": ".workspai/reports/workspace-intelligence-run-last-run.json"
+    },
+    "stages": {
+      "type": "array",
+      "minItems": 11,
+      "maxItems": 11,
+      "prefixItems": [
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "model" },
+            "artifacts": {
+              "const": [
+                ".workspai/reports/workspace-model.json",
+                ".workspai/reports/workspace-knowledge-graph.json"
+              ]
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "diff" },
+            "artifacts": { "const": [".workspai/reports/workspace-model-diff-last-run.json"] }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "impact" },
+            "artifacts": { "const": [".workspai/reports/workspace-impact-last-run.json"] }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "doctor-evidence" },
+            "artifacts": { "const": [".workspai/reports/doctor-last-run.json"] }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "contract-evidence" },
+            "artifacts": { "const": [".workspai/reports/workspace-contract-verify-last-run.json"] }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "analyze-evidence" },
+            "artifacts": { "const": [".workspai/reports/analyze-last-run.json"] }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "readiness-evidence" },
+            "artifacts": { "const": [".workspai/reports/release-readiness-last-run.json"] }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "verify" },
+            "artifacts": {
+              "const": [
+                ".workspai/reports/workspace-verify-last-run.json",
+                ".workspai/reports/workspace-intelligence-history.json"
+              ]
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "context" },
+            "artifacts": { "const": [".workspai/reports/workspace-context-agent.json"] }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "agent-sync" },
+            "artifacts": {
+              "const": [
+                ".workspai/reports/INDEX.json",
+                ".workspai/reports/agent-customization-pack.json",
+                ".workspai/reports/workspace-skills-index.json",
+                "AGENTS.md"
+              ]
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/stage",
+          "type": "object",
+          "properties": {
+            "id": { "const": "explain" },
+            "artifacts": { "const": [".workspai/reports/workspace-explain-last-run.json"] }
+          }
+        }
+      ],
+      "items": false
+    }
+  },
+  "$defs": {
+    "preflight": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "status", "result", "durationMs", "artifacts", "message"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["passed", "failed", "skipped"] },
+        "result": { "enum": ["synchronized", "created", "reused", "failed", "skipped"] },
+        "durationMs": { "type": "integer", "minimum": 0 },
+        "artifacts": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "message": { "type": "string", "minLength": 1 }
+      }
+    },
+    "stage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "status", "durationMs", "artifacts", "exitCode", "message"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["passed", "blocked", "failed", "skipped"] },
+        "durationMs": { "type": "integer", "minimum": 0 },
+        "artifacts": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "exitCode": { "type": "integer", "minimum": 0 },
+        "message": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,200 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/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",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "workspace",
+    "base",
+    "head",
+    "entities",
+    "relations",
+    "proofs",
+    "impactedEntityIds",
+    "changedArtifacts",
+    "summary"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspace-knowledge-graph-change-overlay.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "workspace": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "profile": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "base": { "$ref": "#/$defs/graphRevision" },
+    "head": { "$ref": "#/$defs/graphRevision" },
+    "entities": {
+      "allOf": [
+        { "$ref": "#/$defs/changeSet" },
+        {
+          "properties": {
+            "added": {
+              "type": "array",
+              "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/entities/items" }
+            },
+            "removed": {
+              "type": "array",
+              "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/entities/items" }
+            },
+            "changed": { "type": "array", "items": { "$ref": "#/$defs/entityChange" } }
+          }
+        }
+      ]
+    },
+    "relations": {
+      "allOf": [
+        { "$ref": "#/$defs/changeSet" },
+        {
+          "properties": {
+            "added": {
+              "type": "array",
+              "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/relations/items" }
+            },
+            "removed": {
+              "type": "array",
+              "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/relations/items" }
+            },
+            "changed": { "type": "array", "items": { "$ref": "#/$defs/relationChange" } }
+          }
+        }
+      ]
+    },
+    "proofs": {
+      "allOf": [
+        { "$ref": "#/$defs/changeSet" },
+        {
+          "properties": {
+            "added": {
+              "type": "array",
+              "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/proofs/items" }
+            },
+            "removed": {
+              "type": "array",
+              "items": { "$ref": "workspace-knowledge-graph.v1.json#/properties/proofs/items" }
+            },
+            "changed": { "type": "array", "items": { "$ref": "#/$defs/proofChange" } }
+          }
+        }
+      ]
+    },
+    "impactedEntityIds": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "changedArtifacts": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
+      },
+      "uniqueItems": true
+    },
+    "summary": {
+      "type": "object",
+      "required": [
+        "entityAdds",
+        "entityRemovals",
+        "entityChanges",
+        "relationAdds",
+        "relationRemovals",
+        "relationChanges",
+        "proofAdds",
+        "proofRemovals",
+        "proofChanges",
+        "impactedEntities",
+        "changedArtifacts",
+        "risk"
+      ],
+      "properties": {
+        "entityAdds": { "type": "integer", "minimum": 0 },
+        "entityRemovals": { "type": "integer", "minimum": 0 },
+        "entityChanges": { "type": "integer", "minimum": 0 },
+        "relationAdds": { "type": "integer", "minimum": 0 },
+        "relationRemovals": { "type": "integer", "minimum": 0 },
+        "relationChanges": { "type": "integer", "minimum": 0 },
+        "proofAdds": { "type": "integer", "minimum": 0 },
+        "proofRemovals": { "type": "integer", "minimum": 0 },
+        "proofChanges": { "type": "integer", "minimum": 0 },
+        "impactedEntities": { "type": "integer", "minimum": 0 },
+        "changedArtifacts": { "type": "integer", "minimum": 0 },
+        "risk": { "enum": ["none", "low", "medium", "high"] }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "graphRevision": {
+      "type": "object",
+      "required": ["schemaVersion", "generatedAt", "fingerprint"],
+      "properties": {
+        "schemaVersion": { "const": "workspace-knowledge-graph.v1" },
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      },
+      "additionalProperties": false
+    },
+    "changeSet": {
+      "type": "object",
+      "required": ["added", "removed", "changed"]
+    },
+    "entityChange": {
+      "type": "object",
+      "required": ["id", "before", "after", "changedFields"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "before": { "$ref": "workspace-knowledge-graph.v1.json#/properties/entities/items" },
+        "after": { "$ref": "workspace-knowledge-graph.v1.json#/properties/entities/items" },
+        "changedFields": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "additionalProperties": false
+    },
+    "relationChange": {
+      "type": "object",
+      "required": ["id", "before", "after", "changedFields"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "before": { "$ref": "workspace-knowledge-graph.v1.json#/properties/relations/items" },
+        "after": { "$ref": "workspace-knowledge-graph.v1.json#/properties/relations/items" },
+        "changedFields": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "additionalProperties": false
+    },
+    "proofChange": {
+      "type": "object",
+      "required": ["id", "before", "after", "changedFields"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "before": { "$ref": "workspace-knowledge-graph.v1.json#/properties/proofs/items" },
+        "after": { "$ref": "workspace-knowledge-graph.v1.json#/properties/proofs/items" },
+        "changedFields": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}