workspai 0.43.1 → 0.44.0

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

@@ -0,0 +1,334 @@
+{
+  "schemaVersion": "workspai-published-contract-catalog-v1",
+  "contracts": {
+    "runtimeCommandSurface": {
+      "schemaVersion": "rapidkit-runtime-command-surface-v1",
+      "contractPath": "contracts/runtime-command-surface.v1.json",
+      "publication": "capability-contract"
+    },
+    "cliOperationResult": {
+      "schemaVersion": "workspai-cli-operation-result-v1",
+      "contractPath": "contracts/cli-operation-result.v1.json",
+      "publication": "json-schema"
+    },
+    "publishedContractCatalog": {
+      "schemaVersion": "workspai-published-contract-catalog-v1",
+      "contractPath": "contracts/published-contract-catalog.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceArchiveCapabilities": {
+      "schemaVersion": "workspai-workspace-archive-capabilities-v1",
+      "contractPath": "contracts/workspace-archive-capabilities.v1.json",
+      "publication": "capability-contract"
+    },
+    "workspaceArchiveManifest": {
+      "schemaVersion": "workspai-workspace-archive-manifest-v1",
+      "contractPath": "contracts/workspace-archive-manifest.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceArchiveOperationResult": {
+      "schemaVersion": "workspai-workspace-archive-operation-result-v1",
+      "contractPath": "contracts/workspace-archive-operation-result.v1.json",
+      "publication": "json-schema"
+    },
+    "projectEntryCapability": {
+      "schemaVersion": "workspai-project-entry-capability-v1",
+      "contractPath": "contracts/project-entry-capability.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceIntelligenceArchitecture": {
+      "schemaVersion": "workspai-workspace-intelligence-architecture-v1",
+      "contractPath": "contracts/workspace-intelligence-architecture.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceIntelligenceChain": {
+      "schemaVersion": "workspai-workspace-intelligence-chain-v1",
+      "contractPath": "contracts/workspace-intelligence-chain.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceIntelligenceArtifacts": {
+      "schemaVersion": {
+        "model": "workspace-model.v1",
+        "snapshot": "workspace-model-snapshot.v1",
+        "diff": "workspace-model-diff.v1",
+        "impact": "workspace-impact.v1",
+        "analyze": "rapidkit-analyze-v1",
+        "doctor": "doctor-workspace-evidence-v1",
+        "contractVerify": "workspace-contract-verify.v1",
+        "readiness": "release-readiness-v1",
+        "verify": "workspace-verify.v1",
+        "history": "workspace-intelligence-history.v1",
+        "agentContext": "workspace-context.v1",
+        "agentIndex": "rapidkit-agent-reports-index.v1",
+        "agentCustomizationPack": "rapidkit-agent-customization-pack.v1",
+        "skillsIndex": "workspace-skills-index.v1",
+        "agents": null,
+        "explain": "workspace-explain.v1"
+      },
+      "contractPath": null,
+      "publication": "embedded-type",
+      "artifacts": {
+        "model": {
+          "path": ".workspai/reports/workspace-model.json",
+          "schemaVersion": "workspace-model.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-model.v1.json"
+        },
+        "snapshot": {
+          "path": ".workspai/reports/workspace-model-snapshot.json",
+          "schemaVersion": "workspace-model-snapshot.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-model-snapshot.v1.json"
+        },
+        "diff": {
+          "path": ".workspai/reports/workspace-model-diff-last-run.json",
+          "schemaVersion": "workspace-model-diff.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-model-diff.v1.json"
+        },
+        "impact": {
+          "path": ".workspai/reports/workspace-impact-last-run.json",
+          "schemaVersion": "workspace-impact.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-impact.v1.json"
+        },
+        "analyze": {
+          "path": ".workspai/reports/analyze-last-run.json",
+          "schemaVersion": "rapidkit-analyze-v1",
+          "contractPath": "contracts/analyze-last-run.v1.json"
+        },
+        "doctor": {
+          "path": ".workspai/reports/doctor-last-run.json",
+          "schemaVersion": "doctor-workspace-evidence-v1",
+          "contractPath": "contracts/doctor-workspace-evidence.v1.json"
+        },
+        "contractVerify": {
+          "path": ".workspai/reports/workspace-contract-verify-last-run.json",
+          "schemaVersion": "workspace-contract-verify.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-contract-verify.v1.json"
+        },
+        "readiness": {
+          "path": ".workspai/reports/release-readiness-last-run.json",
+          "schemaVersion": "release-readiness-v1",
+          "contractPath": "contracts/release-readiness.v1.json"
+        },
+        "verify": {
+          "path": ".workspai/reports/workspace-verify-last-run.json",
+          "schemaVersion": "workspace-verify.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-verify.v1.json"
+        },
+        "history": {
+          "path": ".workspai/reports/workspace-intelligence-history.json",
+          "schemaVersion": "workspace-intelligence-history.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-intelligence-history.v1.json"
+        },
+        "agentContext": {
+          "path": ".workspai/reports/workspace-context-agent.json",
+          "schemaVersion": "workspace-context.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-context.v1.json"
+        },
+        "agentIndex": {
+          "path": ".workspai/reports/INDEX.json",
+          "schemaVersion": "rapidkit-agent-reports-index.v1",
+          "contractPath": "contracts/workspace-intelligence/agent-reports-index.v1.json"
+        },
+        "agentCustomizationPack": {
+          "path": ".workspai/reports/agent-customization-pack.json",
+          "schemaVersion": "rapidkit-agent-customization-pack.v1",
+          "contractPath": "contracts/workspace-intelligence/agent-customization-pack-report.v1.json"
+        },
+        "skillsIndex": {
+          "path": ".workspai/reports/workspace-skills-index.json",
+          "schemaVersion": "workspace-skills-index.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-skills-index.v1.json"
+        },
+        "agents": {
+          "path": "AGENTS.md",
+          "schemaVersion": null,
+          "contractPath": null
+        },
+        "explain": {
+          "path": ".workspai/reports/workspace-explain-last-run.json",
+          "schemaVersion": "workspace-explain.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-explain.v1.json"
+        }
+      }
+    },
+    "cliLogEvent": {
+      "schemaVersion": "cli-log-event-v1",
+      "contractPath": "contracts/cli-log-event.v1.json",
+      "publication": "json-schema"
+    },
+    "freshnessMetadata": {
+      "schemaVersion": "rapidkit-freshness-metadata-v1",
+      "contractPath": null,
+      "publication": "embedded-type"
+    },
+    "factFreshness": {
+      "schemaVersion": "rapidkit-fact-freshness-v1",
+      "contractPath": "contracts/workspace-intelligence/fact-freshness.v1.json",
+      "publication": "json-schema"
+    },
+    "blockerResolution": {
+      "schemaVersion": "rapidkit-blocker-resolution-v1",
+      "contractPath": "contracts/workspace-intelligence/blocker-resolution.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceModel": {
+      "schemaVersion": "workspace-model.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-model.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceImpact": {
+      "schemaVersion": "workspace-impact.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-impact.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceVerify": {
+      "schemaVersion": "workspace-verify.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-verify.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceContext": {
+      "schemaVersion": "workspace-context.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-context.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceDependencyGraph": {
+      "schemaVersion": "workspace-dependency-graph.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-dependency-graph.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceIntelligenceHistory": {
+      "schemaVersion": "workspace-intelligence-history.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-intelligence-history.v1.json",
+      "publication": "json-schema"
+    },
+    "agentCustomizationPackCapabilities": {
+      "schemaVersion": "workspai-agent-customization-pack-capabilities.v1",
+      "contractPath": "contracts/agent-customization-pack.v1.json",
+      "publication": "capability-contract"
+    },
+    "agentCustomizationPackReport": {
+      "schemaVersion": "rapidkit-agent-customization-pack.v1",
+      "contractPath": "contracts/workspace-intelligence/agent-customization-pack-report.v1.json",
+      "publication": "json-schema"
+    },
+    "agentReportsIndex": {
+      "schemaVersion": "rapidkit-agent-reports-index.v1",
+      "contractPath": "contracts/workspace-intelligence/agent-reports-index.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceOperationalSkill": {
+      "schemaVersion": "workspace-operational-skill.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-operational-skill.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceSkillsIndex": {
+      "schemaVersion": "workspace-skills-index.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-skills-index.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceExplain": {
+      "schemaVersion": "workspace-explain.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-explain.v1.json",
+      "publication": "json-schema"
+    },
+    "agentActionOutcome": {
+      "schemaVersion": "agent-action-outcome.v1",
+      "contractPath": "contracts/workspace-intelligence/agent-action-outcome.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorRemediationPlan": {
+      "schemaVersion": "doctor-remediation-plan-v2",
+      "contractPath": "contracts/doctor-remediation-plan.v2.json",
+      "publication": "json-schema"
+    },
+    "artifactRemediationPlan": {
+      "schemaVersion": "artifact-remediation-plan-v1",
+      "contractPath": "contracts/artifact-remediation-plan.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorFixResult": {
+      "schemaVersion": "rapidkit-doctor-fix-result-v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-fix-result.v1.json",
+      "publication": "json-schema"
+    },
+    "autopilotRelease": {
+      "schemaVersion": "autopilot-release-v1",
+      "contractPath": "contracts/autopilot-release.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceList": {
+      "schemaVersion": "rapidkit-workspace-list-v1",
+      "contractPath": "contracts/workspace-list.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceSync": {
+      "schemaVersion": "rapidkit-workspace-sync-v1",
+      "contractPath": "contracts/workspace-sync.v1.json",
+      "publication": "json-schema"
+    },
+    "compatibilityMatrix": {
+      "schemaVersion": "rapidkit.compatibility-matrix.v1",
+      "contractPath": "contracts/compatibility-matrix.v1.json",
+      "publication": "json-schema"
+    },
+    "mcpDesign": {
+      "schemaVersion": "workspai-mcp-design.v1",
+      "contractPath": "contracts/workspace-intelligence/mcp-design.v1.json",
+      "publication": "json-schema"
+    },
+    "agentHooks": {
+      "schemaVersion": "workspai-agent-hooks.v1",
+      "contractPath": "contracts/workspace-intelligence/agent-hooks.v1.json",
+      "publication": "json-schema"
+    },
+    "projectArchive": {
+      "schemaVersion": "rapidkit-project-archive-v1",
+      "contractPath": "contracts/project-archive.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceSnapshot": {
+      "schemaVersion": "rapidkit-workspace-snapshot-v1",
+      "contractPath": "contracts/workspace-snapshot.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceSnapshotV2": {
+      "schemaVersion": "rapidkit-workspace-snapshot-v2",
+      "contractPath": "contracts/workspace-snapshot.v2.json",
+      "publication": "json-schema"
+    },
+    "infraPlan": {
+      "schemaVersion": "rapidkit.infra-plan.v1",
+      "contractPath": "contracts/infra-plan.v1.json",
+      "publication": "json-schema"
+    },
+    "privateProductManifest": {
+      "schemaVersion": "rapidkit.private-product-manifest.v1",
+      "contractPath": "contracts/private-product-manifest.v1.json",
+      "publication": "json-schema"
+    },
+    "productFactoryPlan": {
+      "schemaVersion": "rapidkit.product-factory-plan.v1",
+      "contractPath": "contracts/product-factory-plan.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceModelCache": {
+      "schemaVersion": "workspace-model-cache.v1",
+      "contractPath": "contracts/workspace-model-cache.v1.json",
+      "publication": "json-schema"
+    },
+    "workspaceWatchEvent": {
+      "schemaVersion": "workspace-watch-event.v1",
+      "contractPath": "contracts/workspace-watch-event.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorProjectScan": {
+      "schemaVersion": "doctor-project-scan-v2",
+      "contractPath": "contracts/doctor-project-scan.v2.json",
+      "publication": "json-schema"
+    },
+    "doctorWorkspaceCache": {
+      "schemaVersion": "doctor-workspace-cache-v2",
+      "contractPath": "contracts/doctor-workspace-cache.v2.json",
+      "publication": "json-schema"
+    }
+  }
+}

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

@@ -82,6 +82,235 @@
     "why",
     "trace"
   ],
+  "workspaceIntelligenceRootCommands": [
+    "analyze",
+    "readiness",
+    "doctor",
+    "workspace"
+  ],
+  "workspaceIntelligenceExecution": [
+    {
+      "id": "model",
+      "argv": [
+        "workspace",
+        "model",
+        "--json",
+        "--write"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/workspace-model.json",
+          "schemaVersion": "workspace-model.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-model.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "diff",
+      "argv": [
+        "workspace",
+        "diff",
+        "--from",
+        ".workspai/reports/workspace-model-snapshot.json",
+        "--json"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/workspace-model-diff-last-run.json",
+          "schemaVersion": "workspace-model-diff.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-model-diff.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "impact",
+      "argv": [
+        "workspace",
+        "impact",
+        "--from",
+        ".workspai/reports/workspace-model-diff-last-run.json",
+        "--json"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/workspace-impact-last-run.json",
+          "schemaVersion": "workspace-impact.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-impact.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "doctor-evidence",
+      "argv": [
+        "doctor",
+        "workspace",
+        "--json"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/doctor-last-run.json",
+          "schemaVersion": "doctor-workspace-evidence-v1",
+          "contractPath": "contracts/doctor-workspace-evidence.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "contract-evidence",
+      "argv": [
+        "workspace",
+        "contract",
+        "verify",
+        "--strict",
+        "--json"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/workspace-contract-verify-last-run.json",
+          "schemaVersion": "workspace-contract-verify.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-contract-verify.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "analyze-evidence",
+      "argv": [
+        "analyze",
+        "--json"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/analyze-last-run.json",
+          "schemaVersion": "rapidkit-analyze-v1",
+          "contractPath": "contracts/analyze-last-run.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "readiness-evidence",
+      "argv": [
+        "readiness",
+        "--json"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/release-readiness-last-run.json",
+          "schemaVersion": "release-readiness-v1",
+          "contractPath": "contracts/release-readiness.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "verify",
+      "argv": [
+        "workspace",
+        "verify",
+        "--from-impact",
+        ".workspai/reports/workspace-impact-last-run.json",
+        "--json"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/workspace-verify-last-run.json",
+          "schemaVersion": "workspace-verify.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-verify.v1.json"
+        },
+        {
+          "path": ".workspai/reports/workspace-intelligence-history.json",
+          "schemaVersion": "workspace-intelligence-history.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-intelligence-history.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "context",
+      "argv": [
+        "workspace",
+        "context",
+        "--for-agent",
+        "--json",
+        "--write",
+        "--no-agent-sync"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/workspace-context-agent.json",
+          "schemaVersion": "workspace-context.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-context.v1.json"
+        }
+      ]
+    },
+    {
+      "id": "agent-sync",
+      "argv": [
+        "workspace",
+        "agent-sync",
+        "--write",
+        "--json",
+        "--preset",
+        "enterprise"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/INDEX.json",
+          "schemaVersion": "rapidkit-agent-reports-index.v1",
+          "contractPath": "contracts/workspace-intelligence/agent-reports-index.v1.json"
+        },
+        {
+          "path": ".workspai/reports/agent-customization-pack.json",
+          "schemaVersion": "rapidkit-agent-customization-pack.v1",
+          "contractPath": "contracts/workspace-intelligence/agent-customization-pack-report.v1.json"
+        },
+        {
+          "path": ".workspai/reports/workspace-skills-index.json",
+          "schemaVersion": "workspace-skills-index.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-skills-index.v1.json"
+        },
+        {
+          "path": "AGENTS.md",
+          "schemaVersion": null,
+          "contractPath": null
+        }
+      ]
+    },
+    {
+      "id": "explain",
+      "argv": [
+        "workspace",
+        "explain",
+        "release-blocked",
+        "--json",
+        "--write"
+      ],
+      "produces": [
+        {
+          "path": ".workspai/reports/workspace-explain-last-run.json",
+          "schemaVersion": "workspace-explain.v1",
+          "contractPath": "contracts/workspace-intelligence/workspace-explain.v1.json"
+        }
+      ]
+    }
+  ],
+  "jsonOperationResult": {
+    "schemaVersion": "workspai-cli-operation-result-v1",
+    "contractPath": "contracts/cli-operation-result.v1.json"
+  },
+  "workspaceArchive": {
+    "schemaVersion": "workspai-workspace-archive-capabilities-v1",
+    "contractPath": "contracts/workspace-archive-capabilities.v1.json",
+    "commands": [
+      "export",
+      "inspect",
+      "verify",
+      "doctor",
+      "hydrate"
+    ],
+    "flags": [
+      "--archive-compression <mode>",
+      "--max-download-size <size>",
+      "--max-expanded-size <size>",
+      "--download-timeout-ms <ms>"
+    ]
+  },
   "moduleSuggestionFrameworks": [
     "fastapi",
     "nestjs"
@@ -124,15 +353,15 @@
   ],
   "createPlanner": {
     "lanes": {
-      "native-create": {
+      "native": {
         "status": "available",
         "meaning": "Workspai owns the scaffold contract, marker, registry, doctor, bootstrap, and workspace model path."
       },
-      "external-create-adopt": {
-        "status": "planned",
-        "meaning": "A stable ecosystem generator exists, but Workspai does not yet own the post-create contract."
+      "official": {
+        "status": "available",
+        "meaning": "A stable ecosystem generator exists. Available entries run the official generator and then register the project; planned entries fall back to adopt/import."
       },
-      "adopt-only": {
+      "existing": {
         "status": "available",
         "meaning": "The project enters Workspace Intelligence through import/adopt, not native create."
       }
@@ -144,7 +373,9 @@
       "springboot.standard",
       "gofiber.standard",
       "gogin.standard",
-      "dotnet.webapi.clean",
+      "dotnet.webapi.clean"
+    ],
+    "officialCreate": [
       "frontend.nextjs",
       "frontend.remix",
       "frontend.vite-react",
@@ -155,16 +386,14 @@
       "frontend.nuxt",
       "frontend.angular",
       "frontend.astro",
-      "frontend.sveltekit"
-    ],
-    "externalCreateAdopt": [
+      "frontend.sveltekit",
       "wordpress-site",
       "wordpress-block",
       "laravel",
       "symfony",
       "rails"
     ],
-    "adoptOnlyRuntimes": [
+    "existingRuntimeSignals": [
       "php",
       "ruby",
       "rust",

package/contracts/version.v1.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/version.v1.json",
+  "title": "Workspai Version Contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "cli",
+    "version",
+    "node",
+    "platform",
+    "capabilitiesSchemaVersion",
+    "contracts",
+    "contractCatalog"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "rapidkit-version-v1"
+    },
+    "cli": {
+      "const": "workspai"
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "node": {
+      "type": "string",
+      "minLength": 1
+    },
+    "platform": {
+      "type": "string",
+      "minLength": 1
+    },
+    "capabilitiesSchemaVersion": {
+      "const": "rapidkit-command-capabilities-v1"
+    },
+    "contracts": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "contractCatalog": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  }
+}