workspai 0.46.0 → 0.48.0

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-evaluation-comparison.v1.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/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",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "taskAligned",
+    "current",
+    "baseline",
+    "delta",
+    "comparableOutcome"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspace-intelligence-evaluation-comparison.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "taskAligned": { "type": "boolean" },
+    "current": { "$ref": "#/$defs/run" },
+    "baseline": { "$ref": "#/$defs/run" },
+    "delta": {
+      "type": "object",
+      "required": ["tokens", "reductionPercent", "modelCalls", "toolCalls", "latencyMs"],
+      "properties": {
+        "tokens": { "type": "number" },
+        "reductionPercent": { "type": ["number", "null"] },
+        "modelCalls": { "type": "number" },
+        "toolCalls": { "type": "number" },
+        "latencyMs": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "comparableOutcome": { "type": "boolean" }
+  },
+  "$defs": {
+    "run": {
+      "type": "object",
+      "required": ["runId", "strategy", "tokens", "verified", "status"],
+      "properties": {
+        "runId": { "type": "string", "minLength": 1 },
+        "strategy": {
+          "enum": ["full-corpus", "grep", "vector", "graph", "workspace-intelligence", "custom"]
+        },
+        "tokens": { "type": "integer", "minimum": 0 },
+        "verified": { "type": "boolean" },
+        "status": { "enum": ["passed", "failed", "blocked", "unknown"] }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/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",
+  "required": ["schemaVersion", "runId", "sessionId", "status", "startedAt", "updatedAt", "workspace", "configuration", "methodology", "events", "summary"],
+  "properties": {
+    "schemaVersion": { "const": "workspace-intelligence-evaluation.v1" },
+    "runId": { "type": "string", "minLength": 1 },
+    "sessionId": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["live", "completed", "aborted"] },
+    "startedAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "completedAt": { "type": "string", "format": "date-time" },
+    "workspace": {
+      "type": "object",
+      "required": ["name", "path"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "path": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "configuration": {
+      "type": "object",
+      "required": ["taskId", "strategy"],
+      "properties": {
+        "taskId": { "type": "string", "minLength": 1 },
+        "strategy": { "enum": ["full-corpus", "grep", "vector", "graph", "workspace-intelligence", "custom"] },
+        "provider": { "type": "string", "minLength": 1 },
+        "model": { "type": "string", "minLength": 1 },
+        "temperature": { "type": "number" },
+        "baselineRunId": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "methodology": {
+      "type": "object",
+      "required": ["id", "claimBoundary"],
+      "properties": {
+        "id": { "const": "provider-usage-and-verified-outcome.v1" },
+        "claimBoundary": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "events": {
+      "type": "array",
+      "items": { "$ref": "model-usage-event.v1.json" }
+    },
+    "summary": {
+      "type": "object",
+      "required": ["modelCalls", "toolCalls", "tokenSources", "tokens", "latencyMs", "costs", "outcome", "efficiency"],
+      "properties": {
+        "modelCalls": { "type": "integer", "minimum": 0 },
+        "toolCalls": { "type": "integer", "minimum": 0 },
+        "tokenSources": {
+          "type": "object",
+          "required": ["providerReported", "tokenizerCounted", "estimated", "unavailable"],
+          "properties": {
+            "providerReported": { "type": "integer", "minimum": 0 },
+            "tokenizerCounted": { "type": "integer", "minimum": 0 },
+            "estimated": { "type": "integer", "minimum": 0 },
+            "unavailable": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        },
+        "tokens": {
+          "type": "object",
+          "required": ["input", "output", "cachedInput", "reasoning", "observedTotal"],
+          "properties": {
+            "input": { "type": "integer", "minimum": 0 },
+            "output": { "type": "integer", "minimum": 0 },
+            "cachedInput": { "type": "integer", "minimum": 0 },
+            "reasoning": { "type": "integer", "minimum": 0 },
+            "observedTotal": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        },
+        "latencyMs": { "type": "number", "minimum": 0 },
+        "costs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["currency", "amount", "providerReported", "estimated"],
+            "properties": {
+              "currency": { "type": "string", "pattern": "^[A-Z]{3}$" },
+              "amount": { "type": "number", "minimum": 0 },
+              "providerReported": { "type": "number", "minimum": 0 },
+              "estimated": { "type": "number", "minimum": 0 }
+            },
+            "additionalProperties": false
+          }
+        },
+        "outcome": {
+          "type": "object",
+          "required": ["status", "verified", "blockersResolved"],
+          "properties": {
+            "status": { "enum": ["passed", "failed", "blocked", "unknown"] },
+            "verified": { "type": "boolean" },
+            "blockersResolved": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        },
+        "efficiency": {
+          "type": "object",
+          "required": ["tokensPerVerifiedOutcome", "noProgressDecisions", "repeatedArtifactReads"],
+          "properties": {
+            "tokensPerVerifiedOutcome": { "type": ["number", "null"], "minimum": 0 },
+            "noProgressDecisions": { "type": "integer", "minimum": 0 },
+            "repeatedArtifactReads": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -69,7 +69,12 @@
           "type": "object",
           "properties": {
             "id": { "const": "model" },
-            "artifacts": { "const": [".workspai/reports/workspace-model.json"] }
+            "artifacts": {
+              "const": [
+                ".workspai/reports/workspace-model.json",
+                ".workspai/reports/workspace-knowledge-graph.json"
+              ]
+            }
           }
         },
         {

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
+}