workspai 0.46.0 → 0.48.0

package/contracts/runtime-command-surface.v1.json

@@ -495,6 +495,22 @@
         "mirror"
       ]
     },
+    {
+      "invocation": "mirror status",
+      "summary": "Inspect mirror configuration, lock state, and cached artifact inventory.",
+      "canonicalArgv": [
+        "mirror",
+        "status"
+      ]
+    },
+    {
+      "invocation": "mirror sync",
+      "summary": "Synchronize governed mirror artifacts and publish integrity evidence.",
+      "canonicalArgv": [
+        "mirror",
+        "sync"
+      ]
+    },
     {
       "invocation": "modules",
       "summary": "List supported project modules and their runtime-specific capability state.",
@@ -744,6 +760,15 @@
         "agent-sync"
       ]
     },
+    {
+      "invocation": "workspace agent-sync --write",
+      "summary": "Publish the governed agent surface generation as a recoverable workspace transaction.",
+      "canonicalArgv": [
+        "workspace",
+        "agent-sync",
+        "--write"
+      ]
+    },
     {
       "invocation": "workspace agent-sync --write --json --preset enterprise",
       "summary": "Generate the enterprise agent-grounding pack, persist every governed artifact, and emit a structured result.",
@@ -792,6 +817,15 @@
         "contract"
       ]
     },
+    {
+      "invocation": "workspace contract sync",
+      "summary": "Reconcile discovered projects into the canonical workspace contract and registry summary.",
+      "canonicalArgv": [
+        "workspace",
+        "contract",
+        "sync"
+      ]
+    },
     {
       "invocation": "workspace contract verify --strict --json",
       "summary": "Strictly validate workspace contracts and emit a structured evidence artifact that blocks on violations.",
@@ -822,6 +856,82 @@
         "--json"
       ]
     },
+    {
+      "invocation": "workspace eval",
+      "summary": "Measure model usage, agent activity, cost provenance, and verified task outcomes without storing prompt or response bodies.",
+      "canonicalArgv": [
+        "workspace",
+        "eval",
+        "status",
+        "--json"
+      ],
+      "input": {
+        "transport": "stdin",
+        "mediaType": "application/json",
+        "required": false,
+        "schemaVersion": "model-usage-event.v1",
+        "contractPath": "contracts/workspace-intelligence/model-usage-event.v1.json"
+      },
+      "output": {
+        "defaultFormat": "human-or-json",
+        "modes": [
+          {
+            "selector": "init <task> [strategy] --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "record --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "status --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "report --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "compare --from <report> --json",
+            "format": "json",
+            "mediaType": "application/json"
+          }
+        ]
+      }
+    },
+    {
+      "invocation": "workspace eval init",
+      "summary": "Initialize one live, versioned Workspace Intelligence evaluation run for a fixed task and retrieval strategy.",
+      "canonicalArgv": [
+        "workspace",
+        "eval",
+        "init"
+      ]
+    },
+    {
+      "invocation": "workspace eval record --json",
+      "summary": "Validate one privacy-bounded usage or outcome event from stdin and append it to the live evaluation artifact.",
+      "canonicalArgv": [
+        "workspace",
+        "eval",
+        "record",
+        "--json"
+      ]
+    },
+    {
+      "invocation": "workspace eval report --json",
+      "summary": "Finalize the live evaluation into an authoritative last-run report for IDE, CI, and comparison consumers.",
+      "canonicalArgv": [
+        "workspace",
+        "eval",
+        "report",
+        "--json"
+      ]
+    },
     {
       "invocation": "workspace explain",
       "summary": "Explain a workspace relationship, project, or blocker from traceable model and evidence references.",
@@ -896,7 +1006,7 @@
     },
     {
       "invocation": "workspace graph",
-      "summary": "Render the current workspace dependency graph in a supported representation.",
+      "summary": "Query or export the evidence-backed workspace graph derived from the canonical model.",
       "canonicalArgv": [
         "workspace",
         "graph",
@@ -906,6 +1016,16 @@
       "output": {
         "defaultFormat": "human-or-json",
         "modes": [
+          {
+            "selector": "search <query> --limit <count> --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "benchmark <query> --limit <count> --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
           {
             "selector": "emit --json",
             "format": "json",
@@ -916,6 +1036,26 @@
             "format": "json",
             "mediaType": "application/json"
           },
+          {
+            "selector": "entities [kind] --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "evidence <id-or-unique-label> --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "path <from> <to> --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "overlay --from <graph> --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
           {
             "selector": "dot",
             "format": "raw-text",
@@ -925,6 +1065,21 @@
             "selector": "mermaid",
             "format": "raw-text",
             "mediaType": "text/vnd.mermaid"
+          },
+          {
+            "selector": "jsonld",
+            "format": "raw-text",
+            "mediaType": "application/ld+json"
+          },
+          {
+            "selector": "graphml",
+            "format": "raw-text",
+            "mediaType": "application/graphml+xml"
+          },
+          {
+            "selector": "gexf",
+            "format": "raw-text",
+            "mediaType": "application/gexf+xml"
           }
         ]
       }
@@ -1137,6 +1292,19 @@
         ]
       ]
     },
+    {
+      "artifactPath": ".workspai/reports/workspace-knowledge-graph.json",
+      "schemaVersion": "workspace-knowledge-graph.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-knowledge-graph.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "model",
+          "--json",
+          "--write"
+        ]
+      ]
+    },
     {
       "artifactPath": ".workspai/reports/workspace-model-snapshot.json",
       "schemaVersion": "workspace-model-snapshot.v1",
@@ -1345,6 +1513,53 @@
         ]
       ]
     },
+    {
+      "artifactPath": ".workspai/reports/workspace-intelligence-evaluation-live.json",
+      "schemaVersion": "workspace-intelligence-evaluation.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-intelligence-evaluation.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "eval",
+          "init"
+        ],
+        [
+          "workspace",
+          "eval",
+          "record",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-intelligence-evaluation-last-run.json",
+      "schemaVersion": "workspace-intelligence-evaluation.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-intelligence-evaluation.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "eval",
+          "report",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/workspace.contract.json",
+      "schemaVersion": 1,
+      "contractPath": "contracts/workspace-contract.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "sync"
+        ],
+        [
+          "workspace",
+          "contract",
+          "sync"
+        ]
+      ]
+    },
     {
       "artifactPath": ".workspai/cache/workspace-model.v1.json",
       "schemaVersion": "workspace-model-cache.v1",
@@ -1367,6 +1582,70 @@
         ]
       ]
     },
+    {
+      "artifactPath": ".workspai/compatibility-matrix.json",
+      "schemaVersion": "rapidkit.compatibility-matrix.v1",
+      "contractPath": "contracts/compatibility-matrix.v1.json",
+      "producerCommands": [
+        [
+          "bootstrap"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/doctor-workspace-cache.json",
+      "schemaVersion": "doctor-workspace-cache-v2",
+      "contractPath": "contracts/doctor-workspace-cache.v2.json",
+      "producerCommands": [
+        [
+          "doctor",
+          "workspace"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/bootstrap-compliance.latest.json",
+      "schemaVersion": "bootstrap-compliance.v1",
+      "contractPath": "contracts/bootstrap-compliance.v1.json",
+      "producerCommands": [
+        [
+          "bootstrap"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/mirror-ops.latest.json",
+      "schemaVersion": "mirror-ops.v1",
+      "contractPath": "contracts/mirror-ops.v1.json",
+      "producerCommands": [
+        [
+          "mirror",
+          "status"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/transparency-evidence.latest.json",
+      "schemaVersion": "transparency-evidence.v1",
+      "contractPath": "contracts/transparency-evidence.v1.json",
+      "producerCommands": [
+        [
+          "mirror",
+          "sync"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/share-bundle.json",
+      "schemaVersion": "1.1",
+      "contractPath": "contracts/workspace-share-bundle.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "share"
+        ]
+      ]
+    },
     {
       "artifactPath": ".workspai/reports/doctor-project-last-run.json",
       "schemaVersion": "doctor-project-evidence-v1",
@@ -1458,7 +1737,13 @@
       "artifactPath": ".workspai/reports/workspai-mcp-design.json",
       "schemaVersion": "workspai-mcp-design.v1",
       "contractPath": "contracts/workspace-intelligence/mcp-design.v1.json",
-      "producerCommands": []
+      "producerCommands": [
+        [
+          "workspace",
+          "agent-sync",
+          "--write"
+        ]
+      ]
     },
     {
       "artifactPath": ".workspai/reports/workspace-why-last-run.json",
@@ -1525,6 +1810,7 @@
     "why",
     "trace",
     "feedback",
+    "eval",
     "mcp",
     "policy",
     "contract",
@@ -1553,6 +1839,7 @@
     "why",
     "trace",
     "feedback",
+    "eval",
     "mcp"
   ],
   "workspaceIntelligenceRootCommands": [
@@ -1575,6 +1862,11 @@
           "path": ".workspai/reports/workspace-model.json",
           "schemaVersion": "workspace-model.v1",
           "contractPath": "contracts/workspace-intelligence/workspace-model.v1.json"
+        },
+        {
+          "path": ".workspai/reports/workspace-knowledge-graph.json",
+          "schemaVersion": "workspace-knowledge-graph.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-knowledge-graph.v1.json"
         }
       ]
     },

package/contracts/transparency-evidence.v1.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/transparency-evidence.v1.json",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "records"],
+  "properties": {
+    "schemaVersion": { "const": "transparency-evidence.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "environment": { "type": ["string", "null"] },
+    "records": { "type": "array", "items": { "type": "object" } }
+  },
+  "additionalProperties": true
+}

package/contracts/workspace-contract.v1.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-contract.v1.json",
+  "title": "Workspai Workspace Contract",
+  "type": "object",
+  "required": ["schemaVersion", "kind", "generatedAt", "workspace", "projects"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "rapidkit.workspace.contract" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "workspace": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "profile": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "projects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug", "relativePath", "modules", "ports", "contracts"],
+        "properties": {
+          "slug": { "type": "string", "minLength": 1 },
+          "relativePath": { "type": "string", "minLength": 1 },
+          "source": { "enum": ["workspace", "local-folder", "git-url", "adopted-local"] },
+          "relationship": { "enum": ["imported", "adopted"] },
+          "externalPath": { "type": "string", "minLength": 1 },
+          "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 },
+          "ports": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["name", "port", "protocol"],
+              "properties": {
+                "name": { "type": "string", "minLength": 1 },
+                "port": { "type": "integer", "minimum": 1, "maximum": 65535 },
+                "protocol": { "enum": ["http", "https", "grpc", "tcp", "udp"] }
+              },
+              "additionalProperties": false
+            }
+          },
+          "contracts": {
+            "type": "object",
+            "required": ["owns", "apis", "publishes", "consumes", "dependsOn", "env"],
+            "properties": {
+              "owns": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+              "apis": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": ["name", "basePath"],
+                  "properties": {
+                    "name": { "type": "string", "minLength": 1 },
+                    "basePath": { "type": "string", "pattern": "^/" }
+                  },
+                  "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 }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/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",
+  "required": ["schemaVersion", "eventId", "recordedAt", "kind"],
+  "properties": {
+    "schemaVersion": { "const": "model-usage-event.v1" },
+    "eventId": { "type": "string", "minLength": 1 },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "kind": { "enum": ["model-call", "tool-call", "outcome", "milestone"] },
+    "stage": { "type": "string", "minLength": 1 },
+    "modelCall": {
+      "type": "object",
+      "required": ["provider", "model", "source", "inputTokens", "outputTokens", "cachedInputTokens", "reasoningTokens", "latencyMs"],
+      "properties": {
+        "provider": { "type": "string", "minLength": 1 },
+        "model": { "type": "string", "minLength": 1 },
+        "source": { "enum": ["provider-reported", "tokenizer-counted", "estimated", "unavailable"] },
+        "tokenizer": { "type": "string", "minLength": 1 },
+        "inputTokens": { "type": ["integer", "null"], "minimum": 0 },
+        "outputTokens": { "type": ["integer", "null"], "minimum": 0 },
+        "cachedInputTokens": { "type": ["integer", "null"], "minimum": 0 },
+        "reasoningTokens": { "type": ["integer", "null"], "minimum": 0 },
+        "latencyMs": { "type": ["number", "null"], "minimum": 0 },
+        "promptHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "responseHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "cost": {
+          "type": "object",
+          "required": ["amount", "currency", "source"],
+          "properties": {
+            "amount": { "type": "number", "minimum": 0 },
+            "currency": { "type": "string", "pattern": "^[A-Z]{3}$" },
+            "source": { "enum": ["provider-reported", "catalog-estimated"] }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "toolCall": {
+      "type": "object",
+      "required": ["tool", "result", "changedSource", "durationMs"],
+      "properties": {
+        "tool": { "type": "string", "minLength": 1 },
+        "result": { "enum": ["passed", "failed", "blocked", "skipped"] },
+        "changedSource": { "type": "boolean" },
+        "durationMs": { "type": ["number", "null"], "minimum": 0 },
+        "artifact": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "outcome": {
+      "type": "object",
+      "required": ["status", "verified", "blockersResolved"],
+      "properties": {
+        "status": { "enum": ["passed", "failed", "blocked", "unknown"] },
+        "verified": { "type": "boolean" },
+        "blockersResolved": { "type": "integer", "minimum": 0 },
+        "summary": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "milestone": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "detail": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    }
+  },
+  "allOf": [
+    { "if": { "properties": { "kind": { "const": "model-call" } } }, "then": { "properties": { "modelCall": {} }, "required": ["modelCall"] } },
+    { "if": { "properties": { "kind": { "const": "tool-call" } } }, "then": { "properties": { "toolCall": {} }, "required": ["toolCall"] } },
+    { "if": { "properties": { "kind": { "const": "outcome" } } }, "then": { "properties": { "outcome": {} }, "required": ["outcome"] } },
+    { "if": { "properties": { "kind": { "const": "milestone" } } }, "then": { "properties": { "milestone": {} }, "required": ["milestone"] } }
+  ],
+  "additionalProperties": false
+}

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