workspai 0.65.0 → 0.66.0

package/README.md

@@ -64,10 +64,13 @@ your-workspace/                         # canonical system boundary
 ├── AGENTS.md · CLAUDE.md · GEMINI.md · QWEN.md
 ├── .cursor/ · .claude/ · .github/ · .agents/ # host-native projections
 ├── nova-api/
+│   ├── .agents/skills/workspai-*/SKILL.md # portable project Skill wrappers
 │   └── .workspai/
 │       ├── agent-entry.v1.json         # canonical project entry
 │       ├── workspace-link.local.json   # machine-local binding
-│       └── reports/project-context-agent.json
+│       └── reports/
+│           ├── project-context-agent.json
+│           └── project-knowledge-graph-reference.json
 └── summit-web/                         # same project-level boundary
 ```
 

package/contracts/agent-customization-pack.v1.json

@@ -52,9 +52,10 @@
       ]
     },
     "agents": {
-      "meaning": "Generate portable AGENTS.md grounding for any agent.",
+      "meaning": "Generate portable AGENTS.md grounding and .agents/skills projections.",
       "outputFamilies": [
-        "portable"
+        "portable",
+        "skills"
       ]
     },
     "copilot": {
@@ -281,6 +282,7 @@
       ".workspai/skills/"
     ],
     "l2PrefixedMirrorRoots": [
+      ".agents/",
       ".github/",
       ".cursor/",
       ".claude/",

package/contracts/analyze-last-run.v1.json

@@ -26,8 +26,16 @@
     "profile": { "type": ["string", "null"] },
     "summary": {
       "type": "object",
-      "required": ["score", "verdict", "projectCount", "runtimeCount", "findings"],
+      "required": [
+        "score",
+        "verdict",
+        "projectCount",
+        "runtimeCount",
+        "findings"
+      ],
       "properties": {
+        "statusScope": { "const": "source-structure" },
+        "releaseReadiness": { "const": "not-evaluated" },
         "score": { "type": "number" },
         "verdict": {
           "enum": ["ready", "needs-attention", "blocked"]

package/contracts/cli-runtime-command-inventory.v1.snapshot.json

@@ -727,6 +727,98 @@
         }
       ]
     },
+    {
+      "path": [
+        "live"
+      ],
+      "command": "live",
+      "parent": null,
+      "registrationKind": "commander",
+      "aliases": [],
+      "description": "Open a live cross-terminal execution graph for Workspai activity",
+      "hidden": false,
+      "arguments": [
+        {
+          "name": "target",
+          "required": false,
+          "variadic": false
+        }
+      ],
+      "options": [
+        {
+          "flags": "--global",
+          "attributeName": "global"
+        },
+        {
+          "flags": "--run <runId>",
+          "attributeName": "run"
+        },
+        {
+          "flags": "--once",
+          "attributeName": "once"
+        },
+        {
+          "flags": "--json",
+          "attributeName": "json"
+        },
+        {
+          "flags": "--refresh-ms <milliseconds>",
+          "attributeName": "refreshMs"
+        },
+        {
+          "flags": "--max-runs <count>",
+          "attributeName": "maxRuns"
+        },
+        {
+          "flags": "--max-scopes <count>",
+          "attributeName": "maxScopes"
+        },
+        {
+          "flags": "--classic",
+          "attributeName": "classic"
+        },
+        {
+          "flags": "--no-color",
+          "attributeName": "color"
+        },
+        {
+          "flags": "--no-motion",
+          "attributeName": "motion"
+        },
+        {
+          "flags": "--ascii",
+          "attributeName": "ascii"
+        },
+        {
+          "flags": "--accessible",
+          "attributeName": "accessible"
+        },
+        {
+          "flags": "--capture <file>",
+          "attributeName": "capture"
+        },
+        {
+          "flags": "--capture-preset <preset>",
+          "attributeName": "capturePreset"
+        },
+        {
+          "flags": "--capture-theme <theme>",
+          "attributeName": "captureTheme"
+        },
+        {
+          "flags": "--no-capture-redact",
+          "attributeName": "captureRedact"
+        },
+        {
+          "flags": "--replay <runId>",
+          "attributeName": "replay"
+        },
+        {
+          "flags": "--replay-speed <multiplier>",
+          "attributeName": "replaySpeed"
+        }
+      ]
+    },
     {
       "path": [
         "mirror"
@@ -1469,6 +1561,22 @@
           "flags": "--scan-depth <count>",
           "attributeName": "scanDepth"
         },
+        {
+          "flags": "--graph-inventory-limit <count>",
+          "attributeName": "graphInventoryLimit"
+        },
+        {
+          "flags": "--graph-semantic-budget <count>",
+          "attributeName": "graphSemanticBudget"
+        },
+        {
+          "flags": "--graph-deep-budget <count>",
+          "attributeName": "graphDeepBudget"
+        },
+        {
+          "flags": "--graph-source-budget <count>",
+          "attributeName": "graphSourceBudget"
+        },
         {
           "flags": "--limit <count>",
           "attributeName": "limit"
@@ -1597,6 +1705,10 @@
           "flags": "--parallel",
           "attributeName": "parallel"
         },
+        {
+          "flags": "--plan",
+          "attributeName": "plan"
+        },
         {
           "flags": "--runtime <runtime>",
           "attributeName": "runtime"
@@ -1707,6 +1819,7 @@
     "goal",
     "import",
     "infra",
+    "live",
     "mirror",
     "pipeline",
     "product",

package/contracts/extension-cli-compatibility.v1.json

@@ -18,6 +18,7 @@
     "projectWorkspaceLink": "project-workspace-link.v1",
     "projectWorkspaceResolution": "project-workspace-resolution.v1",
     "projectContextAgent": "project-context-agent.v1",
+    "projectKnowledgeGraphReference": "project-knowledge-graph-reference.v1",
     "projectAgentEntry": "workspai.agent-entry.v1",
     "agentBootstrapReceipt": "workspai.agent-bootstrap-receipt.v1",
     "doctorProjectEvidence": "doctor-project-evidence-v1",
@@ -63,6 +64,7 @@
       "repairTransaction": "workspai.workspace-repair-transaction.v1"
     },
     "cliLogEvent": "cli-log-event-v1",
+    "workspaceActivityEvent": "workspace-activity-event.v1",
     "freshnessMetadata": "rapidkit-freshness-metadata-v1",
     "factFreshness": "rapidkit-fact-freshness-v1",
     "blockerResolution": "rapidkit-blocker-resolution-v1",

package/contracts/published-contract-catalog.v1.json

@@ -76,6 +76,11 @@
       "contractPath": "contracts/workspace-intelligence/project-context-agent.v1.json",
       "publication": "json-schema"
     },
+    "projectKnowledgeGraphReference": {
+      "schemaVersion": "project-knowledge-graph-reference.v1",
+      "contractPath": "contracts/workspace-intelligence/project-knowledge-graph-reference.v1.json",
+      "publication": "json-schema"
+    },
     "projectAgentEntry": {
       "schemaVersion": "workspai.agent-entry.v1",
       "contractPath": "contracts/workspace-intelligence/project-agent-entry.v1.json",
@@ -321,6 +326,11 @@
       "contractPath": "contracts/cli-log-event.v1.json",
       "publication": "json-schema"
     },
+    "workspaceActivityEvent": {
+      "schemaVersion": "workspace-activity-event.v1",
+      "contractPath": "contracts/workspace-activity-event.v1.json",
+      "publication": "json-schema"
+    },
     "freshnessMetadata": {
       "schemaVersion": "rapidkit-freshness-metadata-v1",
       "contractPath": null,

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

@@ -51,6 +51,7 @@
     "goal",
     "agent",
     "snapshot",
+    "live",
     "bootstrap",
     "setup",
     "cache",
@@ -557,6 +558,13 @@
         "list"
       ]
     },
+    {
+      "invocation": "live",
+      "summary": "Render the versioned cross-terminal execution graph for Workspai runs in the current project or workspace.",
+      "canonicalArgv": [
+        "live"
+      ]
+    },
     {
       "invocation": "merge",
       "summary": "Combine supported governed configuration or project state through the owning runtime operation.",
@@ -1901,6 +1909,32 @@
         ]
       ]
     },
+    {
+      "artifactPath": ".workspai/reports/project-knowledge-graph-reference.json",
+      "schemaVersion": "project-knowledge-graph-reference.v1",
+      "contractPath": "contracts/workspace-intelligence/project-knowledge-graph-reference.v1.json",
+      "producerCommands": [
+        [
+          "adopt"
+        ],
+        [
+          "import"
+        ],
+        [
+          "workspace",
+          "model"
+        ],
+        [
+          "workspace",
+          "sync"
+        ],
+        [
+          "workspace",
+          "intelligence",
+          "run"
+        ]
+      ]
+    },
     {
       "artifactPath": ".workspai/agent-entry.v1.json",
       "schemaVersion": "workspai.agent-entry.v1",
@@ -3213,8 +3247,8 @@
     },
     {
       "id": "contract",
-      "usage": "workspai workspace contract [init|inspect|verify|graph] [--strict] [--json]",
-      "summary": "Create, inspect, verify, or project the workspace contract.",
+      "usage": "workspai workspace contract [init|inspect|sync|verify|graph] [--strict] [--json]",
+      "summary": "Create, inspect, synchronize, verify, or project the workspace contract.",
       "options": [
         {
           "flag": "--workspace",
@@ -3240,11 +3274,13 @@
       "subactions": [
         "init",
         "inspect",
+        "sync",
         "verify",
         "graph"
       ],
       "artifact": ".workspai/workspace.contract.json",
       "examples": [
+        "workspai workspace contract sync --strict --json",
         "workspai workspace contract verify --strict --json",
         "workspai workspace contract graph --json"
       ]
@@ -3496,6 +3532,14 @@
           "flag": "--scope",
           "description": "Limit the operation to a bounded scope such as project:<name>."
         },
+        {
+          "flag": "--plan",
+          "description": "Resolve lifecycle commands without executing project code."
+        },
+        {
+          "flag": "--runtime",
+          "description": "Limit lifecycle planning or execution to one detected runtime family."
+        },
         {
           "flag": "--affected",
           "description": "Run only projects affected by the selected Git change."
@@ -3542,6 +3586,7 @@
       ],
       "artifact": ".workspai/reports/workspace-run-last.json",
       "examples": [
+        "workspai workspace run test --scope project:api --plan --runtime ruby --json",
         "workspai workspace run test --affected --blast-radius --strict",
         "workspai workspace run build --parallel --max-workers 4 --json"
       ]

package/contracts/workspace-activity-event.v1.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/contracts/workspace-activity-event.v1.json",
+  "title": "Workspai Workspace Activity Event",
+  "description": "Local-first operational activity emitted by Workspai commands. Activity is observational and does not by itself establish evidence or decision authority.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "eventId",
+    "sequence",
+    "timestamp",
+    "runId",
+    "scope",
+    "kind",
+    "status",
+    "component",
+    "message"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspace-activity-event.v1" },
+    "eventId": { "type": "string", "minLength": 8 },
+    "sequence": { "type": "integer", "minimum": 1 },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "runId": { "type": "string", "minLength": 8 },
+    "parentRunId": { "type": "string", "minLength": 8 },
+    "spanId": { "type": "string", "minLength": 1 },
+    "parentSpanId": { "type": "string", "minLength": 1 },
+    "causationId": { "type": "string", "minLength": 1 },
+    "correlationId": { "type": "string", "minLength": 1 },
+    "scope": {
+      "type": "object",
+      "required": ["kind", "id", "label", "portable"],
+      "properties": {
+        "kind": { "enum": ["ephemeral-project", "project", "workspace"] },
+        "id": { "type": "string", "minLength": 8 },
+        "label": { "type": "string", "minLength": 1 },
+        "portable": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "kind": {
+      "enum": [
+        "run.started",
+        "run.completed",
+        "run.failed",
+        "run.cancelled",
+        "block.planned",
+        "block.started",
+        "block.progress",
+        "block.completed",
+        "block.failed",
+        "block.blocked",
+        "block.skipped",
+        "edge.declared",
+        "operation.started",
+        "operation.completed",
+        "operation.failed",
+        "touch.planned",
+        "touch.observed",
+        "artifact.published",
+        "artifact.rejected",
+        "warning.detected"
+      ]
+    },
+    "status": {
+      "enum": [
+        "planned",
+        "running",
+        "succeeded",
+        "warned",
+        "blocked",
+        "failed",
+        "cancelled",
+        "skipped",
+        "rolled-back"
+      ]
+    },
+    "component": { "type": "string", "minLength": 1 },
+    "message": { "type": "string", "minLength": 1 },
+    "blockId": { "type": "string", "minLength": 1 },
+    "attempt": { "type": "integer", "minimum": 1 },
+    "origin": {
+      "type": "object",
+      "required": ["id", "kind", "label"],
+      "properties": {
+        "id": { "type": "string", "minLength": 8 },
+        "kind": { "enum": ["project", "workspace-root"] },
+        "label": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "projectId": { "type": "string", "minLength": 1 },
+    "durationMs": { "type": "number", "minimum": 0 },
+    "progress": {
+      "type": "object",
+      "properties": {
+        "completed": { "type": "number", "minimum": 0 },
+        "total": { "type": "number", "minimum": 0 },
+        "percent": { "type": "number", "minimum": 0, "maximum": 100 },
+        "iteration": { "type": "number", "minimum": 0 },
+        "iterations": { "type": "number", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "target": {
+      "type": "object",
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "enum": ["file", "directory", "artifact", "process", "workspace", "project", "other"]
+        },
+        "locator": { "type": "string" },
+        "operation": { "type": "string" },
+        "provenance": { "enum": ["authoritative", "observed", "inferred"] }
+      },
+      "additionalProperties": false
+    },
+    "edge": {
+      "type": "object",
+      "required": ["id", "fromBlockId", "toBlockId", "kind"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "fromBlockId": { "type": "string", "minLength": 1 },
+        "toBlockId": { "type": "string", "minLength": 1 },
+        "kind": { "enum": ["sequence", "parallel", "gate", "handoff"] }
+      },
+      "additionalProperties": false
+    },
+    "attributes": { "type": "object", "additionalProperties": true }
+  },
+  "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": {