workspai 0.43.0

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

@@ -0,0 +1,229 @@
+{
+  "schemaVersion": "rapidkit-agent-customization-pack.v1",
+  "presets": {
+    "minimal": {
+      "meaning": "Generate the portable grounding index, AGENTS.md, and provider-specific lightweight instructions.",
+      "requiredOutputs": [
+        ".workspai/reports/INDEX.json",
+        ".workspai/reports/agent-customization-pack.json",
+        "AGENTS.md"
+      ]
+    },
+    "enterprise": {
+      "meaning": "Generate the full VS Code-native pack: instructions, prompts, skills, custom agents, and validation metadata.",
+      "requiredOutputs": [
+        ".workspai/reports/INDEX.json",
+        ".workspai/reports/agent-customization-pack.json",
+        "AGENTS.md",
+        ".github/instructions/workspai-workspace.instructions.md",
+        ".github/prompts/workspai-diagnose.prompt.md",
+        ".github/skills/workspai-workspace-intelligence/SKILL.md",
+        ".github/agents/workspai-advisor.agent.md",
+        ".workspai/reports/workspai-mcp-design.json",
+        ".workspai/reports/workspace-skills-index.json"
+      ]
+    }
+  },
+  "targets": {
+    "all": {
+      "meaning": "Generate every supported customization surface.",
+      "outputFamilies": [
+        "portable",
+        "vscode",
+        "copilot",
+        "cursor",
+        "claude"
+      ]
+    },
+    "vscode": {
+      "meaning": "Generate VS Code-native customizations for Copilot Chat and agent workflows.",
+      "outputFamilies": [
+        "instructions",
+        "prompts",
+        "skills",
+        "agents",
+        "hooks"
+      ]
+    },
+    "agents": {
+      "meaning": "Generate portable AGENTS.md grounding for any agent.",
+      "outputFamilies": [
+        "portable"
+      ]
+    },
+    "copilot": {
+      "meaning": "Generate GitHub Copilot instructions, prompts, and skills.",
+      "outputFamilies": [
+        "instructions",
+        "prompts",
+        "skills"
+      ]
+    },
+    "cursor": {
+      "meaning": "Generate Cursor rules.",
+      "outputFamilies": [
+        "rules"
+      ]
+    },
+    "claude": {
+      "meaning": "Generate Claude Code grounding files.",
+      "outputFamilies": [
+        "rules",
+        "portable"
+      ]
+    },
+    "codex": {
+      "meaning": "Use AGENTS.md and the report index as the Codex grounding layer.",
+      "outputFamilies": [
+        "portable"
+      ]
+    },
+    "orca": {
+      "meaning": "Use AGENTS.md and the report index as the Orca/Grok grounding layer.",
+      "outputFamilies": [
+        "portable"
+      ]
+    }
+  },
+  "standardAnswerContract": [
+    "Scope",
+    "Evidence",
+    "Diagnosis",
+    "Fix Plan",
+    "Run",
+    "Verify",
+    "Assumptions"
+  ],
+  "requiredReports": [
+    {
+      "path": ".workspai/reports/workspace-context-agent.json",
+      "label": "Agent context pack",
+      "required": true
+    },
+    {
+      "path": ".workspai/reports/workspace-skills-index.json",
+      "label": "Operational skills index",
+      "required": true
+    },
+    {
+      "path": ".workspai/reports/workspace-model.json",
+      "label": "Workspace model graph",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/doctor-last-run.json",
+      "label": "Workspace doctor",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/doctor-project-last-run.json",
+      "label": "Project doctor",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/doctor-remediation-plan-last-run.json",
+      "label": "Doctor remediation plan",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/artifact-remediation-plan-last-run.json",
+      "label": "Artifact remediation plan",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/doctor-fix-result-last-run.json",
+      "label": "Doctor fix result",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/analyze-last-run.json",
+      "label": "Workspace analyze",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/pipeline-last-run.json",
+      "label": "Governance pipeline",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/release-readiness-last-run.json",
+      "label": "Release readiness",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/workspace-impact-last-run.json",
+      "label": "Workspace impact",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/workspace-verify-last-run.json",
+      "label": "Workspace verify",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/workspace-model-snapshot.json",
+      "label": "Workspace model snapshot",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/workspace-model-diff-last-run.json",
+      "label": "Workspace model diff",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/workspace-explain-last-run.json",
+      "label": "Workspace explain",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/workspace-contract-verify-last-run.json",
+      "label": "Workspace contract verify",
+      "required": false
+    },
+    {
+      "path": ".workspai/reports/workspace-intelligence-history.json",
+      "label": "Workspace intelligence history",
+      "required": false
+    }
+  ],
+  "strictRules": [
+    "Required reports must exist.",
+    "Generated report paths must stay inside the workspace root.",
+    "Generated customization text must be English-only.",
+    "Agent answers must not claim pass, ready, or healthy without cited evidence.",
+    "Commands must distinguish display guidance from execution requests.",
+    "Agent hook files must be advisory and disabled by default unless the user explicitly enables them.",
+    "MCP design artifacts must stay read-mostly until write tools have explicit approval boundaries."
+  ],
+  "outputKinds": [
+    "report",
+    "grounding",
+    "instruction",
+    "prompt",
+    "skill",
+    "skill-resource",
+    "operational-skill",
+    "skills-index",
+    "explain-report",
+    "agent",
+    "rule",
+    "hook",
+    "mcp-design"
+  ],
+  "pathLayers": {
+    "l1CanonicalRoots": [
+      ".workspai/reports/",
+      ".workspai/skills/"
+    ],
+    "l2PrefixedMirrorRoots": [
+      ".github/",
+      ".cursor/",
+      ".claude/"
+    ],
+    "l3SharedIndustryFiles": [
+      "AGENTS.md",
+      ".github/copilot-instructions.md",
+      "CLAUDE.md"
+    ]
+  }
+}

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

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/analyze-last-run.v1.json",
+  "title": "RapidKit Analyze Last Run Evidence",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "workspacePath",
+    "workspaceDetected",
+    "summary",
+    "projects",
+    "findings",
+    "enterpriseControls"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "rapidkit-analyze-v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspacePath": { "type": "string", "minLength": 1 },
+    "workspaceDetected": { "type": "boolean" },
+    "profile": { "type": ["string", "null"] },
+    "summary": {
+      "type": "object",
+      "required": ["score", "verdict", "projectCount", "runtimeCount", "findings"],
+      "properties": {
+        "score": { "type": "number" },
+        "verdict": {
+          "enum": ["ready", "needs-attention", "blocked"]
+        },
+        "projectCount": { "type": "integer", "minimum": 0 },
+        "runtimeCount": { "type": "integer", "minimum": 0 },
+        "findings": {
+          "type": "object",
+          "required": ["fail", "warn", "info"],
+          "properties": {
+            "fail": { "type": "integer", "minimum": 0 },
+            "warn": { "type": "integer", "minimum": 0 },
+            "info": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
+    },
+    "runtimes": {
+      "type": "object",
+      "additionalProperties": { "type": "integer", "minimum": 0 }
+    },
+    "projects": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "dependencyGraph": {
+      "type": "object",
+      "properties": {
+        "status": { "enum": ["generated", "empty"] },
+        "edges": {
+          "type": "array",
+          "items": { "type": "object", "additionalProperties": true }
+        },
+        "topImpactedProjects": {
+          "type": "array",
+          "items": { "type": "object", "additionalProperties": true }
+        }
+      },
+      "additionalProperties": true
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "severity", "title", "detail", "target", "remediation"],
+        "properties": {
+          "id": { "type": "string" },
+          "severity": { "enum": ["info", "warn", "fail"] },
+          "title": { "type": "string" },
+          "detail": { "type": "string" },
+          "target": { "type": "string" },
+          "remediation": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "enterpriseControls": {
+      "type": "object",
+      "required": ["jsonReady", "ciGateCommand", "releaseGateCommand", "evidencePath"],
+      "properties": {
+        "jsonReady": { "type": "boolean" },
+        "ciGateCommand": { "type": "string" },
+        "releaseGateCommand": { "type": "string" },
+        "evidencePath": { "type": "string" }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/artifact-remediation-plan.v1.json

@@ -0,0 +1,163 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://rapidkit.dev/contracts/artifact-remediation-plan.v1.json",
+  "title": "RapidKit Artifact Remediation Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "generatedAt", "workspace", "source", "summary", "actions"],
+  "properties": {
+    "schemaVersion": {
+      "const": "artifact-remediation-plan-v1"
+    },
+    "generatedAt": {
+      "type": "string"
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string" },
+        "path": { "type": "string" }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["command", "reportsDir", "includeAbsolutePaths", "ciMode"],
+      "properties": {
+        "command": { "const": "workspace remediation-plan" },
+        "reportsDir": { "type": "string" },
+        "includeAbsolutePaths": { "type": "boolean" },
+        "ciMode": { "type": "boolean" }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "artifactsScanned",
+        "cardsCovered",
+        "totalActions",
+        "executableActions",
+        "risk"
+      ],
+      "properties": {
+        "artifactsScanned": { "type": "integer", "minimum": 0 },
+        "cardsCovered": { "type": "integer", "minimum": 0 },
+        "totalActions": { "type": "integer", "minimum": 0 },
+        "executableActions": { "type": "integer", "minimum": 0 },
+        "risk": { "$ref": "#/$defs/riskSummary" }
+      }
+    },
+    "actions": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/action" }
+    }
+  },
+  "$defs": {
+    "riskSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["safe", "guarded", "invasive"],
+      "properties": {
+        "safe": { "type": "integer", "minimum": 0 },
+        "guarded": { "type": "integer", "minimum": 0 },
+        "invasive": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "operation": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "path", "content", "overwrite"],
+          "properties": {
+            "type": { "const": "file-create" },
+            "path": { "type": "string" },
+            "content": { "type": "string" },
+            "overwrite": { "const": false }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "command", "cwd"],
+          "properties": {
+            "type": { "const": "run-command" },
+            "command": { "type": "string" },
+            "cwd": { "enum": ["workspace", "project"] }
+          }
+        }
+      ]
+    },
+    "action": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "artifactKind",
+        "cardId",
+        "title",
+        "order",
+        "phase",
+        "scope",
+        "status",
+        "mode",
+        "risk",
+        "requiresApproval",
+        "blocker",
+        "summary",
+        "verifyCommand",
+        "cwd",
+        "files",
+        "rollback",
+        "notes"
+      ],
+      "properties": {
+        "id": { "type": "string" },
+        "artifactKind": { "type": "string" },
+        "cardId": { "type": "string" },
+        "title": { "type": "string" },
+        "order": { "type": "integer", "minimum": 0 },
+        "phase": { "type": "string" },
+        "scope": { "enum": ["workspace", "project"] },
+        "status": { "enum": ["ready", "review-required", "blocked", "guidance-only"] },
+        "mode": {
+          "enum": [
+            "edit-file",
+            "run-command",
+            "refresh-evidence",
+            "verify-before-fix",
+            "manual-guidance"
+          ]
+        },
+        "risk": { "enum": ["safe", "guarded", "invasive"] },
+        "requiresApproval": { "type": "boolean" },
+        "blocker": { "type": "string" },
+        "summary": { "type": "string" },
+        "command": { "type": "string" },
+        "verifyCommand": { "type": "string" },
+        "cwd": { "enum": ["workspace", "project"] },
+        "files": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "operation": { "$ref": "#/$defs/operation" },
+        "rollback": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["available", "strategy"],
+          "properties": {
+            "available": { "type": "boolean" },
+            "strategy": { "enum": ["idempotent", "manual", "none"] }
+          }
+        },
+        "notes": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/contracts/backend-import-stack-parity.snapshot.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "backend-import-stack-parity-v1",
+  "frameworkToStack": {
+    "fastapi": "fastapi",
+    "django": "django",
+    "flask": "flask",
+    "python": "unknown",
+    "nestjs": "nestjs",
+    "express": "express",
+    "fastify": "unknown",
+    "koa": "koa",
+    "node": "unknown",
+    "gofiber": "go",
+    "gogin": "go",
+    "echo": "go",
+    "go": "go",
+    "springboot": "springboot",
+    "java": "unknown",
+    "rails": "rails",
+    "ruby": "unknown",
+    "dotnet": "dotnet",
+    "unknown": "unknown"
+  },
+  "runtimeToStack": {
+    "python": "unknown",
+    "node": "unknown",
+    "nodejs": "unknown",
+    "typescript": "unknown",
+    "go": "go",
+    "golang": "go",
+    "java": "unknown",
+    "ruby": "unknown",
+    "dotnet": "dotnet",
+    "csharp": "dotnet",
+    "unknown": "unknown"
+  }
+}

package/contracts/cli-log-event.v1.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/cli-log-event.v1.json",
+  "title": "Workspai CLI Log Event",
+  "description": "NDJSON stream events emitted on stderr when RAPIDKIT_LOG_FORMAT=json or --log-format json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "runId",
+    "timestamp",
+    "level",
+    "event",
+    "component",
+    "message"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "cli-log-event-v1"
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 8
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "level": {
+      "enum": ["debug", "info", "warn", "error"]
+    },
+    "event": {
+      "enum": ["log", "progress", "run.started", "run.completed", "run.failed"]
+    },
+    "component": {
+      "type": "string",
+      "minLength": 1
+    },
+    "message": {
+      "type": "string"
+    },
+    "command": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}