workspai 0.43.0

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

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-intelligence-history.v1.json",
+  "title": "Workspai Workspace Intelligence History",
+  "type": "object",
+  "required": ["schemaVersion", "retention", "entries"],
+  "properties": {
+    "schemaVersion": { "const": "workspace-intelligence-history.v1" },
+    "retention": { "type": "integer", "minimum": 1 },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["generatedAt"],
+        "properties": {
+          "generatedAt": { "type": "string", "format": "date-time" },
+          "kind": { "enum": ["verify", "agent-action", "doctor-fix"] },
+          "verdict": { "enum": ["ready", "needs-attention", "blocked"] },
+          "risk": { "type": "string" },
+          "affectedProjects": { "type": "integer", "minimum": 0 },
+          "freshness": { "enum": ["fresh", "stale", "unknown"] },
+          "gatePassed": { "type": "boolean" },
+          "blockingReasons": { "type": "integer", "minimum": 0 },
+          "policyViolations": { "type": "integer", "minimum": 0 },
+          "actionId": { "type": "string" },
+          "scope": { "type": "string" },
+          "summary": { "type": "string" },
+          "outcome": { "enum": ["ok", "failed"] },
+          "evidenceSha256": { "type": "string" },
+          "applied": { "type": "integer", "minimum": 0 },
+          "failed": { "type": "integer", "minimum": 0 },
+          "skipped": { "type": "integer", "minimum": 0 },
+          "remainingBlockers": { "type": "integer", "minimum": 0 }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/workspace-intelligence/workspace-model-diff.v1.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-model-diff.v1.json",
+  "title": "Workspai Workspace Model Diff",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "fromRef",
+    "toRef",
+    "fromHash",
+    "toHash",
+    "summary",
+    "changes",
+    "currentModel"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-model-diff.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "fromRef": { "type": "string" },
+    "toRef": { "type": "string" },
+    "fromHash": { "type": "string" },
+    "toHash": { "type": "string" },
+    "summary": {
+      "type": "object",
+      "required": [
+        "changed",
+        "addedProjects",
+        "removedProjects",
+        "changedProjects",
+        "workspaceChanges",
+        "validationChanges",
+        "gitChangedFiles"
+      ],
+      "properties": {
+        "changed": { "type": "boolean" },
+        "addedProjects": { "type": "integer", "minimum": 0 },
+        "removedProjects": { "type": "integer", "minimum": 0 },
+        "changedProjects": { "type": "integer", "minimum": 0 },
+        "workspaceChanges": { "type": "integer", "minimum": 0 },
+        "validationChanges": { "type": "integer", "minimum": 0 },
+        "gitChangedFiles": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "git": {
+      "type": "object",
+      "required": ["available", "dirty", "changedFiles", "untrackedFiles", "deletedFiles"],
+      "properties": {
+        "available": { "type": "boolean" },
+        "ref": { "type": "string" },
+        "branch": { "type": "string" },
+        "commit": { "type": "string" },
+        "dirty": { "type": "boolean" },
+        "changedFiles": { "type": "integer", "minimum": 0 },
+        "untrackedFiles": { "type": "integer", "minimum": 0 },
+        "deletedFiles": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "changes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["type", "severity", "target", "message"],
+        "properties": {
+          "type": {
+            "enum": [
+              "project.added",
+              "project.removed",
+              "project.changed",
+              "workspace.changed",
+              "validation.changed",
+              "git.file.changed",
+              "git.untracked",
+              "git.deleted"
+            ]
+          },
+          "severity": {
+            "enum": ["info", "warning", "critical"]
+          },
+          "target": { "type": "string" },
+          "message": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "currentModel": {
+      "type": "object",
+      "required": ["schemaVersion"],
+      "properties": {
+        "schemaVersion": {
+          "const": "workspace-model.v1"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/workspace-intelligence/workspace-model-snapshot.v1.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-model-snapshot.v1.json",
+  "title": "Workspai Workspace Model Snapshot",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "modelHash", "modelRef", "model"],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-model-snapshot.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "modelHash": {
+      "type": "string",
+      "minLength": 64,
+      "maxLength": 64
+    },
+    "modelRef": {
+      "type": "string",
+      "minLength": 1
+    },
+    "model": {
+      "type": "object",
+      "required": ["schemaVersion"],
+      "properties": {
+        "schemaVersion": {
+          "const": "workspace-model.v1"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

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

@@ -0,0 +1,135 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-model.v1.json",
+  "title": "Workspai Workspace Intelligence Model",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "workspace",
+    "identity",
+    "summary",
+    "projects",
+    "contracts",
+    "evidence",
+    "discovery",
+    "policies"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-model.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspace": {
+      "type": "object",
+      "required": ["name", "root", "type"],
+      "properties": {
+        "name": { "type": "string" },
+        "root": { "type": "string" },
+        "type": { "type": "string" },
+        "profile": { "type": "string" }
+      },
+      "additionalProperties": true
+    },
+    "identity": { "type": "object", "additionalProperties": true },
+    "summary": { "type": "object", "additionalProperties": true },
+    "factFreshness": { "$ref": "#/$defs/factFreshnessSummary" },
+    "facts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/workspaceFact" }
+    },
+    "projects": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "contracts": { "type": "object", "additionalProperties": true },
+    "graph": {
+      "type": "object",
+      "description": "First-class inferred dependency graph (workspace-dependency-graph.v1). Additive/optional.",
+      "additionalProperties": true
+    },
+    "evidence": { "type": "object", "additionalProperties": true },
+    "discovery": { "type": "object", "additionalProperties": true },
+    "policies": { "type": "object", "additionalProperties": true },
+    "validation": { "type": "object", "additionalProperties": true }
+  },
+  "$defs": {
+    "factFreshness": {
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "kind",
+        "category",
+        "generatedAt",
+        "ttlSeconds",
+        "status",
+        "verifyBeforeUse",
+        "reason"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "rapidkit-fact-freshness-v1" },
+        "kind": {
+          "enum": ["durable", "derived", "evidence-backed", "live", "verify-before-use"]
+        },
+        "category": { "enum": ["structure", "verification", "state"] },
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "ttlSeconds": { "type": ["integer", "null"], "minimum": 0 },
+        "expiresAt": { "type": "string", "format": "date-time" },
+        "status": { "enum": ["fresh", "stale", "unknown"] },
+        "verifyBeforeUse": { "type": "boolean" },
+        "sourceArtifact": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "inputsHash": { "type": "string" },
+        "reason": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "workspaceFact": {
+      "type": "object",
+      "required": ["id", "label", "scope", "value", "freshness"],
+      "properties": {
+        "id": { "type": "string" },
+        "label": { "type": "string" },
+        "scope": {
+          "enum": ["workspace", "project", "evidence", "policy", "contract", "command", "graph"]
+        },
+        "project": { "type": "string" },
+        "value": true,
+        "freshness": { "$ref": "#/$defs/factFreshness" }
+      },
+      "additionalProperties": false
+    },
+    "factFreshnessSummary": {
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "generatedAt",
+        "status",
+        "totalFacts",
+        "staleFacts",
+        "unknownFacts",
+        "liveFacts",
+        "verifyBeforeUseFacts",
+        "byKind",
+        "byCategory"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "rapidkit-fact-freshness-v1" },
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "status": { "enum": ["fresh", "stale", "unknown"] },
+        "totalFacts": { "type": "integer", "minimum": 0 },
+        "staleFacts": { "type": "integer", "minimum": 0 },
+        "unknownFacts": { "type": "integer", "minimum": 0 },
+        "liveFacts": { "type": "integer", "minimum": 0 },
+        "verifyBeforeUseFacts": { "type": "integer", "minimum": 0 },
+        "byKind": { "type": "object", "additionalProperties": { "type": "integer" } },
+        "byCategory": { "type": "object", "additionalProperties": { "type": "integer" } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/workspace-intelligence/workspace-operational-skill.v1.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-operational-skill.v1.json",
+  "title": "Workspai Workspace Operational Skill",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "skillId",
+    "canonicalPath",
+    "title",
+    "triggers",
+    "requiredReports",
+    "scopedProjects",
+    "verificationCommands",
+    "answerContractSections",
+    "markdown"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspace-operational-skill.v1" },
+    "skillId": { "type": "string", "minLength": 1 },
+    "canonicalPath": { "type": "string", "pattern": "^\\.workspai/skills/[^/]+\\.md$" },
+    "title": { "type": "string" },
+    "triggers": { "type": "array", "items": { "type": "string" } },
+    "requiredReports": { "type": "array", "items": { "type": "string" } },
+    "scopedProjects": { "type": "array", "items": { "type": "string" } },
+    "verificationCommands": { "type": "array", "items": { "type": "string" } },
+    "answerContractSections": {
+      "type": "array",
+      "items": {
+        "enum": ["Scope", "Evidence", "Diagnosis", "Fix Plan", "Run", "Verify", "Assumptions"]
+      }
+    },
+    "promptStem": { "type": "string" },
+    "markdown": { "type": "string" }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-skills-index.v1.json",
+  "title": "Workspai Workspace Skills Index",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "inputsHash", "skills"],
+  "properties": {
+    "schemaVersion": { "const": "workspace-skills-index.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "inputsHash": { "type": "string", "minLength": 8 },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["skillId", "path", "schemaVersion", "title"],
+        "properties": {
+          "skillId": { "type": "string" },
+          "path": { "type": "string" },
+          "schemaVersion": { "type": "string" },
+          "title": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,213 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-verify.v1.json",
+  "title": "Workspai Workspace Verify Last Run",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "workspacePath",
+    "mode",
+    "impact",
+    "summary",
+    "steps",
+    "missingEvidence",
+    "blockingReasons",
+    "verificationPlan",
+    "affectedSubgraph",
+    "graphIntegrity",
+    "freshness",
+    "policyMode",
+    "policyViolations"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-verify.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspacePath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "mode": {
+      "const": "evidence"
+    },
+    "fromImpactRef": { "type": "string" },
+    "scope": { "type": "string" },
+    "impact": {
+      "type": "object",
+      "required": ["changed", "risk", "affectedProjects", "recommendedCommands"],
+      "properties": {
+        "changed": { "type": "boolean" },
+        "risk": {
+          "enum": ["none", "low", "medium", "high", "critical"]
+        },
+        "affectedProjects": { "type": "integer", "minimum": 0 },
+        "recommendedCommands": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "summary": {
+      "type": "object",
+      "required": [
+        "verdict",
+        "exitCode",
+        "stepsPassed",
+        "stepsWarn",
+        "stepsFailed",
+        "stepsMissing",
+        "stepsSkipped"
+      ],
+      "properties": {
+        "verdict": {
+          "enum": ["ready", "needs-attention", "blocked"]
+        },
+        "exitCode": {
+          "enum": [0, 1, 2]
+        },
+        "stepsPassed": { "type": "integer", "minimum": 0 },
+        "stepsWarn": { "type": "integer", "minimum": 0 },
+        "stepsFailed": { "type": "integer", "minimum": 0 },
+        "stepsMissing": { "type": "integer", "minimum": 0 },
+        "stepsSkipped": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "steps": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "label", "scope", "command", "status", "required", "message"],
+        "properties": {
+          "id": { "type": "string" },
+          "label": { "type": "string" },
+          "scope": {
+            "enum": ["workspace", "project"]
+          },
+          "project": { "type": "string" },
+          "status": {
+            "enum": ["pass", "warn", "fail", "missing", "skipped"]
+          },
+          "required": { "type": "boolean" },
+          "evidencePath": { "type": "string" },
+          "message": { "type": "string" },
+          "command": { "type": "object", "additionalProperties": true }
+        },
+        "additionalProperties": true
+      }
+    },
+    "missingEvidence": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "blockingReasons": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "verificationPlan": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "affectedSubgraph": {
+      "type": "object",
+      "required": [
+        "totalProjects",
+        "directlyChanged",
+        "transitiveDependents",
+        "covered",
+        "uncovered",
+        "unverifiable"
+      ],
+      "properties": {
+        "totalProjects": { "type": "integer", "minimum": 0 },
+        "directlyChanged": { "type": "array", "items": { "type": "string" } },
+        "transitiveDependents": { "type": "array", "items": { "type": "string" } },
+        "covered": { "type": "array", "items": { "type": "string" } },
+        "uncovered": { "type": "array", "items": { "type": "string" } },
+        "unverifiable": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "graphIntegrity": {
+      "type": "object",
+      "required": ["ok", "cycles", "danglingEdges", "orphans", "stats"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "cycles": {
+          "type": "array",
+          "items": { "type": "array", "items": { "type": "string" } }
+        },
+        "danglingEdges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["from", "to", "kind", "missing"],
+            "properties": {
+              "from": { "type": "string" },
+              "to": { "type": "string" },
+              "kind": { "type": "string" },
+              "missing": { "enum": ["from", "to", "both"] }
+            },
+            "additionalProperties": true
+          }
+        },
+        "orphans": { "type": "array", "items": { "type": "string" } },
+        "stats": {
+          "type": "object",
+          "required": [
+            "nodeCount",
+            "edgeCount",
+            "cycleCount",
+            "danglingCount",
+            "orphanCount"
+          ],
+          "properties": {
+            "nodeCount": { "type": "integer", "minimum": 0 },
+            "edgeCount": { "type": "integer", "minimum": 0 },
+            "cycleCount": { "type": "integer", "minimum": 0 },
+            "danglingCount": { "type": "integer", "minimum": 0 },
+            "orphanCount": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "freshness": {
+      "type": "object",
+      "required": ["verdict", "baseline", "changed", "added", "removed", "projectHashes"],
+      "properties": {
+        "verdict": { "enum": ["fresh", "stale", "unknown"] },
+        "baseline": { "enum": ["none", "recorded"] },
+        "changed": { "type": "array", "items": { "type": "string" } },
+        "added": { "type": "array", "items": { "type": "string" } },
+        "removed": { "type": "array", "items": { "type": "string" } },
+        "projectHashes": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "policyMode": { "type": "string" },
+    "policyViolations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["source", "severity", "code", "message"],
+        "properties": {
+          "source": { "enum": ["model", "contract"] },
+          "severity": { "enum": ["error", "warning"] },
+          "code": { "type": "string" },
+          "message": { "type": "string" },
+          "target": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": true
+}