workspai 0.43.0

package/contracts/workspace-intelligence/fact-freshness.v1.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/fact-freshness.v1.json",
+  "title": "RapidKit Fact Freshness Contract",
+  "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
+}

package/contracts/workspace-intelligence/studio-blocker-handoff.v1.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/studio-blocker-handoff.v1.json",
+  "title": "Workspai Studio Blocker Handoff",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "cardId",
+    "cardStatus",
+    "blockers",
+    "artifactPath",
+    "sourceCommand",
+    "scope"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "rapidkit-studio-blocker-handoff-v1"
+    },
+    "cardId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "cardLabel": {
+      "type": "string"
+    },
+    "cardStatus": {
+      "enum": ["pass", "warn", "fail", "missing"]
+    },
+    "blockers": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "artifactPath": {
+      "type": "string"
+    },
+    "sourceCommand": {
+      "type": "string"
+    },
+    "scope": {
+      "enum": ["workspace", "project"]
+    },
+    "stderrTail": {
+      "type": "string"
+    },
+    "exitCode": {
+      "type": ["integer", "null"]
+    },
+    "blockerSignature": {
+      "type": "string",
+      "minLength": 8
+    },
+    "commandRunCount": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "resolutionClass": {
+      "enum": [
+        "artifact-missing",
+        "command-failed-repeat",
+        "config-fixable",
+        "semantic-attention",
+        "unresolvable-without-human"
+      ]
+    },
+    "studioMode": {
+      "enum": ["FIX", "RUN_ONCE", "VERIFY_ONLY", "EXPLAIN"]
+    },
+    "incidentSummary": {
+      "type": "object",
+      "required": ["title", "phase", "primaryAction", "verifyRequired", "auditStatus"],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "phase": {
+          "enum": ["detect", "diagnose", "fix", "verify", "audit"]
+        },
+        "primaryAction": {
+          "type": "string",
+          "minLength": 1
+        },
+        "verifyRequired": {
+          "type": "boolean"
+        },
+        "auditStatus": {
+          "enum": ["not-started", "pending", "saved", "failed", "unknown"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "resolutionHints": {
+      "type": "array",
+      "items": {
+        "$ref": "blocker-resolution.v1.json"
+      }
+    },
+    "verifyCommand": {
+      "type": "string"
+    },
+    "verifyArtifact": {
+      "type": "string"
+    },
+    "handoffSource": {
+      "enum": ["repair", "artifacts", "advisor", "tree", "dashboard"]
+    },
+    "workspacePath": {
+      "type": "string"
+    },
+    "projectPath": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,142 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-context.v1.json",
+  "title": "Workspai Workspace Agent Context",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "agent",
+    "workspaceSummary",
+    "modelRef",
+    "workspace",
+    "scope",
+    "projects",
+    "safeCommands",
+    "validation"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-context.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "agent": {
+      "enum": ["generic", "codex", "claude", "cursor", "orca"]
+    },
+    "workspaceSummary": { "type": "string" },
+    "modelRef": { "type": "string" },
+    "workspace": {
+      "type": "object",
+      "required": ["name", "root", "type"],
+      "properties": {
+        "name": { "type": "string" },
+        "root": { "type": "string" },
+        "type": { "type": "string" },
+        "profile": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "scope": { "type": "object", "additionalProperties": true },
+    "projects": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "safeCommands": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "factFreshness": { "$ref": "#/$defs/factFreshnessSummary" },
+    "facts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/workspaceFact" }
+    },
+    "validation": {
+      "type": "object",
+      "required": ["status", "errors", "warnings"],
+      "properties": {
+        "status": {
+          "enum": ["passed", "warning", "failed"]
+        },
+        "errors": { "type": "integer", "minimum": 0 },
+        "warnings": { "type": "integer", "minimum": 0 }
+      },
+      "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-contract-verify.v1.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "workspace-contract-verify.v1",
+  "title": "Workspace contract verify evidence",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "status",
+    "contractPath",
+    "projectCount",
+    "checks",
+    "violations"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-contract-verify.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "status": {
+      "enum": ["passed", "failed"]
+    },
+    "contractPath": {
+      "type": "string"
+    },
+    "projectCount": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "checks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "status", "message"],
+        "properties": {
+          "id": { "type": "string" },
+          "status": { "enum": ["passed", "failed"] },
+          "message": { "type": "string" }
+        }
+      }
+    },
+    "violations": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/contracts/workspace-intelligence/workspace-dependency-graph.v1.json

@@ -0,0 +1,152 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-dependency-graph.v1.json",
+  "title": "Workspai Workspace Dependency Graph",
+  "description": "First-class, versioned dependency graph of inter-project relationships consumed by impact, verify, run --blast-radius, and risk weighting.",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "nodes", "edges", "stats"],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-dependency-graph.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "nodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "path"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "path": { "type": "string", "minLength": 1 },
+          "runtime": { "type": "string" },
+          "framework": { "type": "string" },
+          "kind": { "type": "string" },
+          "operationalProfile": {
+            "type": "object",
+            "required": ["weight", "score", "verificationPriority", "reasons", "centrality"],
+            "properties": {
+              "weight": { "enum": ["low", "medium", "high", "critical"] },
+              "score": { "type": "integer", "minimum": 0, "maximum": 100 },
+              "verificationPriority": { "enum": ["normal", "elevated", "strict"] },
+              "reasons": {
+                "type": "array",
+                "items": { "type": "string" }
+              },
+              "centrality": {
+                "type": "object",
+                "required": ["fanIn", "fanOut", "reach", "betweenness", "isHotspot"],
+                "properties": {
+                  "fanIn": { "type": "integer", "minimum": 0 },
+                  "fanOut": { "type": "integer", "minimum": 0 },
+                  "reach": { "type": "integer", "minimum": 0 },
+                  "betweenness": { "type": "number", "minimum": 0 },
+                  "isHotspot": { "type": "boolean" }
+                },
+                "additionalProperties": true
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "edges": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["from", "to", "kind", "source", "confidence", "evidence"],
+        "properties": {
+          "from": { "type": "string", "minLength": 1 },
+          "to": { "type": "string", "minLength": 1 },
+          "kind": {
+            "enum": [
+              "code-import",
+              "package-dep",
+              "event-pub-sub",
+              "service-dependsOn",
+              "shared-resource"
+            ]
+          },
+          "source": {
+            "enum": ["inferred", "contract", "manual"]
+          },
+          "confidence": {
+            "enum": ["high", "medium", "low"]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["file"],
+              "properties": {
+                "file": { "type": "string", "minLength": 1 },
+                "detail": { "type": "string" }
+              },
+              "additionalProperties": true
+            }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "stats": {
+      "type": "object",
+      "required": [
+        "nodeCount",
+        "edgeCount",
+        "inferredEdges",
+        "contractEdges",
+        "manualEdges",
+        "authoritativeEdges",
+        "lowConfidenceEdges",
+        "orphanCount",
+        "connectedNodeCount",
+        "density",
+        "edgeCoverageRatio",
+        "evidenceCoverageRatio",
+        "hotspotCount",
+        "hasCycle"
+      ],
+      "properties": {
+        "nodeCount": { "type": "integer", "minimum": 0 },
+        "edgeCount": { "type": "integer", "minimum": 0 },
+        "inferredEdges": { "type": "integer", "minimum": 0 },
+        "contractEdges": { "type": "integer", "minimum": 0 },
+        "manualEdges": { "type": "integer", "minimum": 0 },
+        "authoritativeEdges": { "type": "integer", "minimum": 0 },
+        "lowConfidenceEdges": { "type": "integer", "minimum": 0 },
+        "orphanCount": { "type": "integer", "minimum": 0 },
+        "connectedNodeCount": { "type": "integer", "minimum": 0 },
+        "density": { "type": "number", "minimum": 0 },
+        "edgeCoverageRatio": { "type": "number", "minimum": 0, "maximum": 1 },
+        "evidenceCoverageRatio": { "type": "number", "minimum": 0, "maximum": 1 },
+        "hotspotCount": { "type": "integer", "minimum": 0 },
+        "hasCycle": { "type": "boolean" }
+      },
+      "additionalProperties": true
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "severity", "message"],
+        "properties": {
+          "code": { "type": "string", "minLength": 1 },
+          "severity": { "enum": ["info", "warning", "error"] },
+          "message": { "type": "string", "minLength": 1 },
+          "recommendation": { "type": "string" },
+          "nodeIds": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 }
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

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

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-explain.v1.json",
+  "title": "Workspai Workspace Explain Report",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "workspacePath", "target", "summary", "sections"],
+  "properties": {
+    "schemaVersion": { "const": "workspace-explain.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "workspacePath": { "type": "string" },
+    "target": { "type": "object", "additionalProperties": true },
+    "summary": { "type": "string" },
+    "sections": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "body"],
+        "properties": {
+          "id": { "type": "string" },
+          "title": { "type": "string" },
+          "body": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "releaseRisk": { "type": "string" },
+    "blockingReasons": { "type": "array", "items": { "type": "string" } },
+    "resolutionHints": { "type": "array", "items": { "type": "object" } }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-impact.v1.json",
+  "title": "Workspai Workspace Impact",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "fromRef",
+    "diffRef",
+    "workspace",
+    "summary",
+    "affectedProjects",
+    "transitiveImpact",
+    "criticalPathHotspots",
+    "workspaceImpact",
+    "verificationPlan",
+    "agentBrief",
+    "diff"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-impact.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "fromRef": { "type": "string" },
+    "diffRef": { "type": "string" },
+    "workspace": {
+      "type": "object",
+      "required": ["name", "type"],
+      "properties": {
+        "name": { "type": "string" },
+        "profile": { "type": "string" },
+        "type": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "summary": {
+      "type": "object",
+      "required": [
+        "changed",
+        "risk",
+        "affectedProjects",
+        "workspaceItems",
+        "recommendedCommands",
+        "blastRadius"
+      ],
+      "properties": {
+        "changed": { "type": "boolean" },
+        "risk": {
+          "enum": ["none", "low", "medium", "high", "critical"]
+        },
+        "affectedProjects": { "type": "integer", "minimum": 0 },
+        "workspaceItems": { "type": "integer", "minimum": 0 },
+        "recommendedCommands": { "type": "integer", "minimum": 0 },
+        "blastRadius": {
+          "type": "object",
+          "required": ["directlyAffected", "transitivelyAffected", "maxDistance", "graphEdges"],
+          "properties": {
+            "directlyAffected": { "type": "integer", "minimum": 0 },
+            "transitivelyAffected": { "type": "integer", "minimum": 0 },
+            "maxDistance": { "type": "integer", "minimum": 0 },
+            "graphEdges": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "affectedProjects": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "transitiveImpact": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "criticalPathHotspots": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["project", "fanIn", "fanOut", "reach", "betweenness"],
+        "properties": {
+          "project": { "type": "string" },
+          "fanIn": { "type": "integer", "minimum": 0 },
+          "fanOut": { "type": "integer", "minimum": 0 },
+          "reach": { "type": "integer", "minimum": 0 },
+          "betweenness": { "type": "number", "minimum": 0 }
+        },
+        "additionalProperties": true
+      }
+    },
+    "workspaceImpact": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "verificationPlan": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "agentBrief": {
+      "type": "object",
+      "required": ["headline", "bullets", "unsafeAssumptions"],
+      "properties": {
+        "headline": { "type": "string" },
+        "bullets": { "type": "array", "items": { "type": "string" } },
+        "unsafeAssumptions": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "diff": {
+      "type": "object",
+      "required": ["schemaVersion"],
+      "properties": {
+        "schemaVersion": {
+          "const": "workspace-model-diff.v1"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}