workspai 0.58.0 → 0.59.0

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

@@ -0,0 +1,247 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/agent-bootstrap-receipt.v1.json",
+  "title": "Workspai Agent Bootstrap Receipt",
+  "description": "Portable per-session proof that an agent resolved canonical project evidence before broad source discovery.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "receiptId",
+    "status",
+    "requestedAgent",
+    "resolvedHost",
+    "project",
+    "workspace",
+    "entry",
+    "canonicalEvidence",
+    "activeGoal",
+    "requiredReadOrder",
+    "claims",
+    "checks",
+    "nextActions",
+    "integrity"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspai.agent-bootstrap-receipt.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "receiptId": { "$ref": "#/$defs/hash" },
+    "status": { "$ref": "#/$defs/status" },
+    "requestedAgent": {
+      "enum": [
+        "generic",
+        "codex",
+        "claude",
+        "gemini",
+        "qwen",
+        "kimi",
+        "grok",
+        "copilot",
+        "cursor",
+        "windsurf",
+        "amazon-q",
+        "all"
+      ]
+    },
+    "resolvedHost": {
+      "enum": [
+        "generic",
+        "codex",
+        "claude",
+        "gemini",
+        "qwen",
+        "kimi",
+        "grok",
+        "copilot",
+        "cursor",
+        "windsurf",
+        "amazon-q",
+        "all"
+      ]
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "relativePath"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "relativePath": { "$ref": "#/$defs/portablePath" },
+        "runtime": { "type": "string", "minLength": 1 },
+        "framework": { "type": "string", "minLength": 1 }
+      }
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "relationship",
+        "resolved",
+        "identityIsFilesystemPath",
+        "resolverCommand",
+        "portableUriScheme",
+        "resolvedPathPolicy"
+      ],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "relationship": {
+          "enum": ["managed", "adopted", "imported", "linked", "restored"]
+        },
+        "resolved": { "const": true },
+        "identityIsFilesystemPath": { "const": false },
+        "resolverCommand": { "const": "workspai project workspace status --json" },
+        "portableUriScheme": { "const": "workspace:" },
+        "resolvedPathPolicy": { "const": "runtime-private-never-persist" }
+      }
+    },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["artifact", "schemaVersion", "hostStatus", "entryFiles"],
+      "properties": {
+        "artifact": { "const": ".workspai/agent-entry.v1.json" },
+        "schemaVersion": { "const": "workspai.agent-entry.v1" },
+        "hostStatus": { "$ref": "#/$defs/status" },
+        "entryFiles": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/portablePath" }
+        }
+      }
+    },
+    "canonicalEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "projectContext",
+        "workspaceIndex",
+        "workspaceContext",
+        "workspaceModel",
+        "knowledgeGraph",
+        "modelFreshness",
+        "graphFreshness",
+        "graphMatchesModel",
+        "liveInputsValidated",
+        "blockerCount"
+      ],
+      "properties": {
+        "projectContext": { "const": ".workspai/reports/project-context-agent.json" },
+        "workspaceIndex": { "const": "workspace:.workspai/reports/INDEX.json" },
+        "workspaceContext": {
+          "const": "workspace:.workspai/reports/workspace-context-agent.json"
+        },
+        "workspaceModel": { "const": "workspace:.workspai/reports/workspace-model.json" },
+        "knowledgeGraph": {
+          "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
+        },
+        "modelFreshness": { "enum": ["fresh", "stale", "unknown", "missing"] },
+        "graphFreshness": { "enum": ["fresh", "stale", "unknown", "missing"] },
+        "graphMatchesModel": { "type": "boolean" },
+        "liveInputsValidated": { "type": "boolean" },
+        "blockerCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "activeGoal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["present", "appliesToProject", "status"],
+      "properties": {
+        "present": { "type": "boolean" },
+        "appliesToProject": { "type": "boolean" },
+        "status": { "enum": ["none", "ready", "stale", "invalid"] },
+        "id": { "type": "string", "minLength": 1 },
+        "objective": { "type": "string", "minLength": 1 },
+        "lifecycle": { "type": "string", "minLength": 1 },
+        "goalPack": { "$ref": "#/$defs/workspaceArtifact" },
+        "agentHandoff": { "$ref": "#/$defs/workspaceArtifact" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "status": { "const": "none" } } },
+          "then": { "properties": { "present": { "const": false } } }
+        },
+        {
+          "if": {
+            "properties": { "status": { "enum": ["ready", "stale", "invalid"] } }
+          },
+          "then": { "properties": { "present": { "const": true } } }
+        }
+      ]
+    },
+    "requiredReadOrder": {
+      "type": "array",
+      "minItems": 6,
+      "maxItems": 16,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "claims": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["architecture", "sourceInspection", "sourceMutation", "verification"],
+      "properties": {
+        "architecture": { "enum": ["allowed-with-citations", "prohibited"] },
+        "sourceInspection": { "const": "bounded-and-targeted" },
+        "sourceMutation": { "const": "governed-cli-transaction-only" },
+        "verification": { "const": "cli-evidence-only" }
+      }
+    },
+    "checks": {
+      "type": "array",
+      "minItems": 6,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "status", "message"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "status": { "enum": ["passed", "warning", "failed"] },
+          "message": { "type": "string", "minLength": 1 },
+          "artifact": { "$ref": "#/$defs/portablePath" }
+        }
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 8,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "algorithm",
+        "manifestHash",
+        "projectContextHash",
+        "payloadHash",
+        "portable",
+        "absolutePathsEmitted"
+      ],
+      "properties": {
+        "algorithm": { "const": "sha256" },
+        "manifestHash": { "$ref": "#/$defs/hash" },
+        "projectContextHash": { "$ref": "#/$defs/hash" },
+        "payloadHash": { "$ref": "#/$defs/hash" },
+        "portable": { "const": true },
+        "absolutePathsEmitted": { "const": false }
+      }
+    }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "status": { "enum": ["ready", "degraded", "blocked"] },
+    "portablePath": {
+      "type": "string",
+      "minLength": 1,
+      "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
+    },
+    "workspaceArtifact": {
+      "type": "string",
+      "pattern": "^workspace:\\.workspai/"
+    }
+  }
+}

package/contracts/workspace-intelligence/agent-customization-pack-report.v1.json

@@ -27,7 +27,22 @@
     "targets": {
       "type": "array",
       "items": {
-        "enum": ["all", "vscode", "agents", "copilot", "cursor", "claude", "codex", "orca"]
+        "enum": [
+          "all",
+          "vscode",
+          "agents",
+          "copilot",
+          "cursor",
+          "claude",
+          "codex",
+          "gemini",
+          "qwen",
+          "kimi",
+          "grok",
+          "windsurf",
+          "amazon-q",
+          "orca"
+        ]
       }
     },
     "sourceReports": { "type": "array", "items": { "type": "string", "minLength": 1 } },

package/contracts/workspace-intelligence/goal-index.v1.json

@@ -35,7 +35,13 @@
           "goalPack": { "type": "string", "pattern": "^\\.workspai/goals/[^/]+/goal-pack\\.json$" },
           "agentHandoff": { "type": "string", "pattern": "^\\.workspai/goals/[^/]+/agent-handoff\\.json$" },
           "verifiedGoalId": { "type": "string", "minLength": 1 },
-          "repairTransactionId": { "type": "string", "minLength": 1 }
+          "repairTransactionId": { "type": "string", "minLength": 1 },
+          "repairTransactionIds": {
+            "type": "array",
+            "maxItems": 25,
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+          }
         },
         "additionalProperties": false
       }

package/contracts/workspace-intelligence/goal-pack.v1.json

@@ -216,7 +216,8 @@
         "hashSemantics": { "const": "canonical-json-v1" },
         "hash": { "$ref": "#/$defs/hash" },
         "generatedAt": { "type": "string", "format": "date-time" },
-        "modelHash": { "$ref": "#/$defs/hash" }
+        "modelHash": { "$ref": "#/$defs/hash" },
+        "inputHash": { "$ref": "#/$defs/hash" }
       },
       "additionalProperties": false
     },

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

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/workspace-intelligence/project-agent-entry.v1.json",
+  "title": "Workspai Project Agent Entry",
+  "description": "Portable host-discovery and canonical-first entry contract for an adopted or managed project.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "project",
+    "workspace",
+    "canonical",
+    "protocol",
+    "hosts",
+    "integrity"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspai.agent-entry.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "relativePath"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "relativePath": { "$ref": "#/$defs/portablePath" },
+        "runtime": { "type": "string", "minLength": 1 },
+        "framework": { "type": "string", "minLength": 1 }
+      }
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "relationship",
+        "localBinding",
+        "identityIsFilesystemPath",
+        "resolverCommand",
+        "portableUriScheme",
+        "resolvedPathPolicy"
+      ],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "relationship": {
+          "enum": ["managed", "adopted", "imported", "linked", "restored"]
+        },
+        "localBinding": { "const": ".workspai/workspace-link.local.json" },
+        "identityIsFilesystemPath": { "const": false },
+        "resolverCommand": { "const": "workspai project workspace status --json" },
+        "portableUriScheme": { "const": "workspace:" },
+        "resolvedPathPolicy": { "const": "runtime-private-never-persist" }
+      }
+    },
+    "canonical": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "projectContext",
+        "projectGrounding",
+        "goalIndex",
+        "workspaceIndex",
+        "workspaceContext",
+        "workspaceModel",
+        "knowledgeGraph"
+      ],
+      "properties": {
+        "projectContext": { "const": ".workspai/reports/project-context-agent.json" },
+        "projectGrounding": { "const": ".workspai/PROJECT-GROUNDING.md" },
+        "goalIndex": { "const": "workspace:.workspai/goals/index.json" },
+        "workspaceIndex": { "const": "workspace:.workspai/reports/INDEX.json" },
+        "workspaceContext": {
+          "const": "workspace:.workspai/reports/workspace-context-agent.json"
+        },
+        "workspaceModel": { "const": "workspace:.workspai/reports/workspace-model.json" },
+        "knowledgeGraph": {
+          "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
+        }
+      }
+    },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "bootstrapCommand",
+        "verifyCommand",
+        "requiredReadOrder",
+        "sourcePolicy",
+        "degradedMode"
+      ],
+      "properties": {
+        "mode": { "const": "canonical-first" },
+        "bootstrapCommand": { "type": "string", "minLength": 1 },
+        "verifyCommand": { "type": "string", "minLength": 1 },
+        "requiredReadOrder": {
+          "type": "array",
+          "minItems": 6,
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "sourcePolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "liveSourceAuthority",
+            "workspaceEvidenceAuthority",
+            "broadScanBeforeBootstrap",
+            "sourceMutation",
+            "verificationClaims"
+          ],
+          "properties": {
+            "liveSourceAuthority": { "const": "exact-implementation" },
+            "workspaceEvidenceAuthority": { "const": "identity-topology-readiness-goals" },
+            "broadScanBeforeBootstrap": { "const": false },
+            "sourceMutation": { "const": "governed-only" },
+            "verificationClaims": { "const": "cli-evidence-only" }
+          }
+        },
+        "degradedMode": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "discloseMissingEvidence",
+            "allowCompleteArchitectureClaims",
+            "allowReadOnlySourceInspection"
+          ],
+          "properties": {
+            "discloseMissingEvidence": { "const": true },
+            "allowCompleteArchitectureClaims": { "const": false },
+            "allowReadOnlySourceInspection": { "const": true }
+          }
+        }
+      }
+    },
+    "hosts": {
+      "type": "array",
+      "minItems": 11,
+      "maxItems": 11,
+      "items": { "$ref": "#/$defs/host" }
+    },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "algorithm",
+        "projectContextHash",
+        "payloadHash",
+        "portable",
+        "absolutePathsEmitted"
+      ],
+      "properties": {
+        "algorithm": { "const": "sha256" },
+        "projectContextHash": { "$ref": "#/$defs/hash" },
+        "payloadHash": { "$ref": "#/$defs/hash" },
+        "portable": { "const": true },
+        "absolutePathsEmitted": { "const": false }
+      }
+    }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "portablePath": {
+      "type": "string",
+      "minLength": 1,
+      "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
+    },
+    "host": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "discovery", "entryFiles", "status", "managed"],
+      "properties": {
+        "id": {
+          "enum": [
+            "generic",
+            "codex",
+            "claude",
+            "gemini",
+            "qwen",
+            "kimi",
+            "grok",
+            "copilot",
+            "cursor",
+            "windsurf",
+            "amazon-q"
+          ]
+        },
+        "discovery": { "enum": ["native", "adapter", "portable-fallback"] },
+        "entryFiles": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 3,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/portablePath" }
+        },
+        "status": { "enum": ["ready", "degraded", "blocked"] },
+        "managed": { "type": "boolean" },
+        "reason": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

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

@@ -28,17 +28,28 @@
         "relationship": {
           "enum": ["managed", "adopted", "imported", "linked", "restored"]
         },
-        "contract": { "const": ".workspai/workspace.contract.json" },
-        "model": { "const": ".workspai/reports/workspace-model.json" },
+        "contract": { "const": "workspace:.workspai/workspace.contract.json" },
+        "model": { "const": "workspace:.workspai/reports/workspace-model.json" },
         "knowledgeGraph": {
-          "const": ".workspai/reports/workspace-knowledge-graph.json"
+          "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
         },
         "access": {
           "type": "object",
-          "required": ["localBinding", "canonicalEvidenceAvailableAtGeneration"],
+          "required": [
+            "localBinding",
+            "canonicalEvidenceAvailableAtGeneration",
+            "identityIsFilesystemPath",
+            "resolverCommand",
+            "portableUriScheme",
+            "resolvedPathPolicy"
+          ],
           "properties": {
             "localBinding": { "const": ".workspai/workspace-link.local.json" },
-            "canonicalEvidenceAvailableAtGeneration": { "type": "boolean" }
+            "canonicalEvidenceAvailableAtGeneration": { "type": "boolean" },
+            "identityIsFilesystemPath": { "const": false },
+            "resolverCommand": { "const": "workspai project workspace status --json" },
+            "portableUriScheme": { "const": "workspace:" },
+            "resolvedPathPolicy": { "const": "runtime-private-never-persist" }
           },
           "additionalProperties": false
         }
@@ -283,6 +294,7 @@
       "required": [
         "enforcement",
         "mandatoryPreflight",
+        "workspaceLocator",
         "workspaceEvidenceRequiredFor",
         "requiredReadOrder",
         "degradedMode"
@@ -293,8 +305,30 @@
           "type": "object",
           "required": ["command", "successCondition"],
           "properties": {
-            "command": { "const": "npx workspai project workspace status --json" },
-            "successCondition": { "const": "resolved" }
+            "command": {
+              "const": "workspai agent bootstrap --for-agent generic --strict --json"
+            },
+            "successCondition": { "const": "ready" }
+          },
+          "additionalProperties": false
+        },
+        "workspaceLocator": {
+          "type": "object",
+          "required": [
+            "command",
+            "successCondition",
+            "outputClassification",
+            "persistence",
+            "disclosure",
+            "portableUriScheme"
+          ],
+          "properties": {
+            "command": { "const": "workspai project workspace status --json" },
+            "successCondition": { "const": "resolved" },
+            "outputClassification": { "const": "machine-local" },
+            "persistence": { "const": "forbidden" },
+            "disclosure": { "const": "forbidden" },
+            "portableUriScheme": { "const": "workspace:" }
           },
           "additionalProperties": false
         },
@@ -408,16 +442,7 @@
     },
     "relation": {
       "type": "object",
-      "required": [
-        "id",
-        "from",
-        "to",
-        "kind",
-        "derivation",
-        "trust",
-        "confidence",
-        "proofIds"
-      ],
+      "required": ["id", "from", "to", "kind", "derivation", "trust", "confidence", "proofIds"],
       "properties": {
         "id": { "type": "string" },
         "from": { "type": "string" },
@@ -432,15 +457,7 @@
     },
     "proof": {
       "type": "object",
-      "required": [
-        "id",
-        "provider",
-        "artifact",
-        "derivation",
-        "trust",
-        "confidence",
-        "freshness"
-      ],
+      "required": ["id", "provider", "artifact", "derivation", "trust", "confidence", "freshness"],
       "properties": {
         "id": { "type": "string" },
         "provider": { "type": "string" },

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

@@ -26,7 +26,20 @@
       "format": "date-time"
     },
     "agent": {
-      "enum": ["generic", "codex", "claude", "cursor", "orca"]
+      "enum": [
+        "generic",
+        "codex",
+        "claude",
+        "cursor",
+        "gemini",
+        "qwen",
+        "kimi",
+        "grok",
+        "copilot",
+        "windsurf",
+        "amazon-q",
+        "orca"
+      ]
     },
     "workspaceSummary": { "type": "string" },
     "modelRef": { "type": "string" },

package/contracts/workspace-intelligence/workspace-repair-transaction.v1.json

@@ -122,7 +122,8 @@
       "required": ["planHash", "sourceEvidenceHash"],
       "properties": {
         "planHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
-        "sourceEvidenceHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+        "sourceEvidenceHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "closureHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
       }
     }
   },
@@ -244,7 +245,19 @@
         },
         "artifact": { "const": ".workspai/reports/workspace-intelligence-run-last-run.json" },
         "exitCode": { "type": ["integer", "null"] },
-        "summary": { "type": "string" }
+        "summary": { "type": "string" },
+        "sourceBinding": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["modelHash", "modelHashSemantics", "graphHash", "graphHashSemantics", "graphInputHash"],
+          "properties": {
+            "modelHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "modelHashSemantics": { "const": "workspace-model-structural-v1" },
+            "graphHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "graphHashSemantics": { "const": "canonical-json-v1" },
+            "graphInputHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+          }
+        }
       }
     },
     "decision": {