workspai 0.49.0 → 0.51.0

package/contracts/ingestion-result.v1.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/contracts/ingestion-result.v1.json",
+  "title": "Workspai Ingestion Result v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "plan",
+    "writtenFiles",
+    "registered",
+    "verified",
+    "warnings"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspai.ingestion-result.v1"
+    },
+    "status": {
+      "enum": [
+        "passed",
+        "preview",
+        "failed"
+      ]
+    },
+    "plan": {
+      "$ref": "https://workspai.dev/contracts/ingestion-plan.v1.json"
+    },
+    "workspacePath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "projectPath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "writtenFiles": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    },
+    "registered": {
+      "type": "boolean"
+    },
+    "verified": {
+      "type": "boolean"
+    },
+    "warnings": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/contracts/mirror-ops.v1.json

@@ -1,6 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/mirror-ops.v1.json",
+  "$id": "https://workspai.dev/schemas/mirror-ops.v1.json",
+  "title": "Workspai Mirror Operation Evidence",
   "type": "object",
   "required": ["schemaVersion", "command", "action", "result", "timestamp", "workspacePath", "mirror"],
   "properties": {

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/pipeline-last-run.v1.json",
-  "title": "RapidKit Governance Pipeline Last Run",
+  "$id": "https://workspai.dev/schemas/pipeline-last-run.v1.json",
+  "title": "Workspai Governance Pipeline Last Run",
   "type": "object",
   "required": [
     "schemaVersion",

package/contracts/private-product-manifest.v1.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/private-product-manifest.v1.json",
+  "title": "Workspai Private Product Manifest",
   "type": "object",
   "required": [
     "schemaVersion",

package/contracts/product-factory-plan.v1.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/product-factory-plan.v1.json",
+  "title": "Workspai Product Factory Plan",
   "type": "object",
   "required": [
     "schemaVersion",

package/contracts/project-archive.v1.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/project-archive.v1.json",
+  "title": "Workspai Project Archive Manifest",
   "type": "object",
   "required": [
     "schema",

package/contracts/project-entry-capability.v1.json

@@ -23,10 +23,9 @@
     {
       "id": "import",
       "status": "available",
-      "purpose": "Attach an existing project, repository folder, or imported path to a workspace inventory.",
+      "purpose": "Copy a local project or clone a repository into workspace-owned source.",
       "commands": [
-        "import",
-        "workspace import"
+        "import"
       ]
     }
   ],

package/contracts/project-test-coverage.v1.json

@@ -0,0 +1,189 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/contracts/project-test-coverage.v1.json",
+  "title": "Workspai Project Test Coverage Evidence",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "status",
+    "project",
+    "runtime",
+    "runner",
+    "target",
+    "metrics",
+    "files",
+    "lowCoverageFiles",
+    "source",
+    "execution",
+    "diagnostics",
+    "artifactPaths"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "workspai.project-test-coverage.v1" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "status": { "enum": ["passed", "below-target", "unavailable", "failed"] },
+    "project": {
+      "type": "object",
+      "required": ["id", "name", "path", "workspacePath"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "name": { "type": "string", "minLength": 1 },
+        "path": { "type": "string", "minLength": 1 },
+        "workspacePath": { "type": ["string", "null"] }
+      },
+      "additionalProperties": false
+    },
+    "runtime": {
+      "enum": [
+        "node",
+        "bun",
+        "deno",
+        "python",
+        "go",
+        "java",
+        "dotnet",
+        "rust",
+        "php",
+        "ruby",
+        "elixir",
+        "clojure",
+        "scala",
+        "kotlin",
+        "c",
+        "cpp",
+        "unknown"
+      ]
+    },
+    "runner": { "type": ["string", "null"] },
+    "target": {
+      "type": "object",
+      "required": ["metric", "percent"],
+      "properties": {
+        "metric": { "enum": ["lines", "branches", "functions", "statements"] },
+        "percent": { "type": "integer", "minimum": 0, "maximum": 100 }
+      },
+      "additionalProperties": false
+    },
+    "metrics": {
+      "type": "object",
+      "properties": {
+        "lines": { "$ref": "#/$defs/metric" },
+        "branches": { "$ref": "#/$defs/metric" },
+        "functions": { "$ref": "#/$defs/metric" },
+        "statements": { "$ref": "#/$defs/metric" }
+      },
+      "additionalProperties": false
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "metrics"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "metrics": {
+            "type": "object",
+            "properties": {
+              "lines": { "$ref": "#/$defs/metric" },
+              "branches": { "$ref": "#/$defs/metric" },
+              "functions": { "$ref": "#/$defs/metric" },
+              "statements": { "$ref": "#/$defs/metric" }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "lowCoverageFiles": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "percent", "uncovered"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "percent": { "type": ["number", "null"], "minimum": 0, "maximum": 100 },
+          "uncovered": { "type": "integer", "minimum": 0 }
+        },
+        "additionalProperties": false
+      }
+    },
+    "source": {
+      "type": "object",
+      "required": ["format", "path", "sha256"],
+      "properties": {
+        "format": {
+          "enum": [
+            "istanbul-json",
+            "coverage-py-json",
+            "lcov",
+            "go-coverprofile",
+            "jacoco-xml",
+            "cobertura-xml",
+            "clover-xml",
+            "scoverage-xml",
+            "simplecov-json",
+            "llvm-cov-json",
+            "unknown"
+          ]
+        },
+        "path": { "type": ["string", "null"] },
+        "sha256": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }
+      },
+      "additionalProperties": false
+    },
+    "execution": {
+      "type": "object",
+      "required": ["requested", "invocations", "exitCodes", "durationMs"],
+      "properties": {
+        "requested": { "type": "boolean" },
+        "invocations": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/invocation" }
+        },
+        "exitCodes": {
+          "type": "array",
+          "items": { "type": "integer", "minimum": 0 }
+        },
+        "durationMs": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "diagnostics": { "type": "array", "items": { "type": "string" } },
+    "artifactPaths": {
+      "type": "object",
+      "required": ["project", "workspaceLatest", "workspaceProject"],
+      "properties": {
+        "project": { "type": "string", "minLength": 1 },
+        "workspaceLatest": { "type": ["string", "null"] },
+        "workspaceProject": { "type": ["string", "null"] }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "metric": {
+      "type": "object",
+      "required": ["total", "covered", "skipped", "percent"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 },
+        "covered": { "type": "integer", "minimum": 0 },
+        "skipped": { "type": "integer", "minimum": 0 },
+        "percent": { "type": ["number", "null"], "minimum": 0, "maximum": 100 }
+      },
+      "additionalProperties": false
+    },
+    "invocation": {
+      "type": "object",
+      "required": ["cwd", "executable", "args"],
+      "properties": {
+        "cwd": { "type": "string", "minLength": 1 },
+        "executable": { "type": "string", "minLength": 1 },
+        "args": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/project-workspace-link.v1.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/project-workspace-link.v1.json",
+  "title": "Workspai Project Workspace Link",
+  "description": "Machine-local, gitignored binding from a Workspai project to its canonical workspace. Absolute paths are permitted only in this local contract.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "kind",
+    "generatedAt",
+    "state",
+    "workspace",
+    "project",
+    "integrity"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "project-workspace-link.v1" },
+    "kind": { "const": "workspai.project-workspace-link" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "state": { "const": "active" },
+    "workspace": {
+      "type": "object",
+      "required": ["name", "root", "marker", "contract"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "root": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?:/|[A-Za-z]:[\\\\/])",
+          "description": "Machine-local absolute workspace path. This file must remain gitignored."
+        },
+        "marker": {
+          "enum": [".workspai-workspace", ".workspai/workspace.json"]
+        },
+        "contract": { "const": ".workspai/workspace.contract.json" }
+      },
+      "additionalProperties": false
+    },
+    "project": {
+      "type": "object",
+      "required": ["name", "relativePath", "relationship"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "relativePath": {
+          "type": "string",
+          "minLength": 1,
+          "not": { "pattern": "(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$)|^(?:/|[A-Za-z]:[\\\\/])" }
+        },
+        "relationship": {
+          "enum": ["managed", "adopted", "imported", "linked", "restored"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "integrity": {
+      "type": "object",
+      "required": ["algorithm", "binding"],
+      "properties": {
+        "algorithm": { "const": "sha256" },
+        "binding": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/project-workspace-resolution.v1.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/schemas/project-workspace-resolution.v1.json",
+  "title": "Workspai Project Workspace Resolution",
+  "description": "Machine-readable result of resolving or repairing a project's canonical Workspai workspace binding.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "status",
+    "workspacePath",
+    "projectPath",
+    "source",
+    "recovered",
+    "linkPath",
+    "nextCommand"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "project-workspace-resolution.v1" },
+    "status": { "const": "resolved" },
+    "workspacePath": { "type": "string", "minLength": 1 },
+    "projectPath": { "type": "string", "minLength": 1 },
+    "source": { "enum": ["explicit", "parent", "local-link", "registry"] },
+    "recovered": { "type": "boolean" },
+    "linkPath": { "type": "string", "minLength": 1 },
+    "nextCommand": { "type": "string", "minLength": 1 }
+  },
+  "additionalProperties": false
+}

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

@@ -41,11 +41,56 @@
       "contractPath": "contracts/workspace-archive-operation-result.v1.json",
       "publication": "json-schema"
     },
+    "ingestionPlan": {
+      "schemaVersion": "workspai.ingestion-plan.v1",
+      "contractPath": "contracts/ingestion-plan.v1.json",
+      "publication": "json-schema"
+    },
+    "ingestionResult": {
+      "schemaVersion": "workspai.ingestion-result.v1",
+      "contractPath": "contracts/ingestion-result.v1.json",
+      "publication": "json-schema"
+    },
     "projectEntryCapability": {
       "schemaVersion": "workspai-project-entry-capability-v1",
       "contractPath": "contracts/project-entry-capability.v1.json",
       "publication": "json-schema"
     },
+    "projectWorkspaceLink": {
+      "schemaVersion": "project-workspace-link.v1",
+      "contractPath": "contracts/project-workspace-link.v1.json",
+      "publication": "json-schema"
+    },
+    "projectWorkspaceResolution": {
+      "schemaVersion": "project-workspace-resolution.v1",
+      "contractPath": "contracts/project-workspace-resolution.v1.json",
+      "publication": "json-schema"
+    },
+    "projectContextAgent": {
+      "schemaVersion": "project-context-agent.v1",
+      "contractPath": "contracts/workspace-intelligence/project-context-agent.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorProjectEvidence": {
+      "schemaVersion": "doctor-project-evidence-v1",
+      "contractPath": "contracts/doctor-project-evidence.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorWorkspaceEvidence": {
+      "schemaVersion": "doctor-workspace-evidence-v1",
+      "contractPath": "contracts/doctor-workspace-evidence.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorGraphDiagnosis": {
+      "schemaVersion": "doctor-graph-diagnosis.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-graph-diagnosis.v1.json",
+      "publication": "json-schema"
+    },
+    "projectTestCoverage": {
+      "schemaVersion": "workspai.project-test-coverage.v1",
+      "contractPath": "contracts/project-test-coverage.v1.json",
+      "publication": "json-schema"
+    },
     "workspaceIntelligenceArchitecture": {
       "schemaVersion": "workspai-workspace-intelligence-architecture-v1",
       "contractPath": "contracts/workspace-intelligence-architecture.v1.json",

package/contracts/release-readiness.v1.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://getrapidkit.com/schemas/release-readiness.v1.json",
-  "title": "RapidKit Release Readiness Evidence",
+  "$id": "https://workspai.dev/schemas/release-readiness.v1.json",
+  "title": "Workspai Release Readiness Evidence",
   "type": "object",
   "required": [
     "schemaVersion",