workspai 0.55.0 → 0.56.0

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

@@ -73,6 +73,94 @@
             "overwrite": { "const": false }
           }
         },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "path", "lines", "ensureNewline"],
+          "properties": {
+            "type": { "const": "file-append" },
+            "path": { "type": "string" },
+            "lines": { "type": "array", "items": { "type": "string" } },
+            "ensureNewline": { "type": "boolean" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "sourcePath", "path", "overwrite"],
+          "properties": {
+            "type": { "const": "file-copy" },
+            "sourcePath": { "type": "string" },
+            "path": { "type": "string" },
+            "overwrite": { "const": false }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "path", "scriptName", "scriptValue"],
+          "properties": {
+            "type": { "const": "package-json-script" },
+            "path": { "type": "string" },
+            "scriptName": { "type": "string" },
+            "scriptValue": { "type": "string" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "path", "edits"],
+          "properties": {
+            "type": { "const": "json-edit" },
+            "path": { "type": "string" },
+            "edits": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["pointer", "value"],
+                "properties": {
+                  "pointer": { "type": "string" },
+                  "value": { "type": ["string", "number", "boolean", "null"] }
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "path", "keys"],
+          "properties": {
+            "type": { "const": "env-key-add" },
+            "path": { "type": "string" },
+            "keys": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["name", "value"],
+                "properties": {
+                  "name": { "type": "string" },
+                  "value": { "type": "string" },
+                  "comment": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "path", "target", "command", "phony"],
+          "properties": {
+            "type": { "const": "makefile-target" },
+            "path": { "type": "string" },
+            "target": { "type": "string" },
+            "command": { "type": "string" },
+            "phony": { "type": "boolean" }
+          }
+        },
         {
           "type": "object",
           "additionalProperties": false,
@@ -164,7 +252,15 @@
       "allOf": [
         {
           "if": { "properties": { "kind": { "const": "dependency-security" } } },
-          "then": { "properties": { "completion": { "type": "object", "properties": { "auditClean": { "const": true } }, "required": ["auditClean"] } } }
+          "then": {
+            "properties": {
+              "completion": {
+                "type": "object",
+                "properties": { "auditClean": { "const": true } },
+                "required": ["auditClean"]
+              }
+            }
+          }
         },
         {
           "if": { "properties": { "kind": { "const": "dependency-materialization" } } },
@@ -173,7 +269,11 @@
             "properties": {
               "sourceMutationRequired": { "const": false },
               "observableState": { "const": "runtime-dependency-tree" },
-              "completion": { "type": "object", "properties": { "installedTreePresent": { "const": true } }, "required": ["installedTreePresent"] }
+              "completion": {
+                "type": "object",
+                "properties": { "installedTreePresent": { "const": true } },
+                "required": ["installedTreePresent"]
+              }
             }
           }
         }
@@ -190,6 +290,9 @@
         "order",
         "phase",
         "scope",
+        "findingId",
+        "findingStatus",
+        "causalKey",
         "status",
         "mode",
         "risk",
@@ -213,6 +316,11 @@
         "projectName": { "type": "string", "minLength": 1 },
         "projectPath": { "type": "string", "minLength": 1 },
         "sourceStepId": { "type": "string", "minLength": 1 },
+        "findingId": { "type": "string", "minLength": 1 },
+        "findingStatus": {
+          "enum": ["blocking", "advisory", "informational", "unknown"]
+        },
+        "causalKey": { "type": "string", "minLength": 1 },
         "dependsOn": {
           "type": "array",
           "items": { "type": "string", "minLength": 1 }

package/contracts/cli-runtime-command-inventory.v1.snapshot.json

@@ -377,9 +377,13 @@
           "attributeName": "project"
         },
         {
-          "flags": "--json",
+          "flags": "--json [mode]",
           "attributeName": "json"
         },
+        {
+          "flags": "--fresh",
+          "attributeName": "fresh"
+        },
         {
           "flags": "--strict",
           "attributeName": "strict"
@@ -403,6 +407,22 @@
         {
           "flags": "--apply",
           "attributeName": "apply"
+        },
+        {
+          "flags": "--runtime <runtime>",
+          "attributeName": "runtime"
+        },
+        {
+          "flags": "--framework <framework>",
+          "attributeName": "framework"
+        },
+        {
+          "flags": "--validate",
+          "attributeName": "validate"
+        },
+        {
+          "flags": "--write",
+          "attributeName": "write"
         }
       ]
     },
@@ -1280,6 +1300,10 @@
           "flags": "--limit <count>",
           "attributeName": "limit"
         },
+        {
+          "flags": "--refresh-graph",
+          "attributeName": "refreshGraph"
+        },
         {
           "flags": "--cache",
           "attributeName": "cache"
@@ -1396,6 +1420,10 @@
           "flags": "--parallel",
           "attributeName": "parallel"
         },
+        {
+          "flags": "--runtime <runtime>",
+          "attributeName": "runtime"
+        },
         {
           "flags": "--max-workers <count>",
           "attributeName": "maxWorkers"

package/contracts/doctor-project-evidence.v1.json

@@ -43,6 +43,9 @@
         "graphDiagnosis": {
           "$ref": "https://workspai.dev/schemas/workspace-intelligence/doctor-graph-diagnosis.v1.json"
         },
+        "diagnosis": {
+          "$ref": "https://workspai.dev/schemas/workspace-intelligence/doctor-diagnosis.v1.json"
+        },
         "verdict": { "enum": ["passed", "attention", "blocked"] },
         "probeSummary": { "$ref": "#/$defs/probeSummary" }
       },
@@ -51,6 +54,7 @@
     "summary": {
       "type": "object",
       "properties": {
+        "counts": { "$ref": "#/$defs/counts" },
         "scopeProvenance": { "type": "object", "additionalProperties": true },
         "verdict": { "enum": ["passed", "attention", "blocked"] },
         "probeSummary": { "$ref": "#/$defs/probeSummary" },
@@ -68,6 +72,10 @@
     "policyProfile": { "$ref": "#/$defs/policyProfile" }
   },
   "$defs": {
+    "counts": {
+      "type": "object",
+      "additionalProperties": { "type": "integer", "minimum": 0 }
+    },
     "dependencyAudit": {
       "type": "object",
       "required": [
@@ -391,6 +399,7 @@
         "status": { "enum": ["pass", "warn", "fail"] },
         "severity": { "enum": ["info", "warn", "error"] },
         "scope": { "type": "string" },
+        "applicability": { "enum": ["applicable", "not-applicable", "unknown"] },
         "reason": { "type": "string" },
         "recommendation": { "type": "string" },
         "freshness": { "$ref": "#/$defs/freshness" },
@@ -530,7 +539,15 @@
       "allOf": [
         {
           "if": { "properties": { "kind": { "const": "dependency-security" } } },
-          "then": { "properties": { "completion": { "type": "object", "properties": { "auditClean": { "const": true } }, "required": ["auditClean"] } } }
+          "then": {
+            "properties": {
+              "completion": {
+                "type": "object",
+                "properties": { "auditClean": { "const": true } },
+                "required": ["auditClean"]
+              }
+            }
+          }
         },
         {
           "if": { "properties": { "kind": { "const": "dependency-materialization" } } },
@@ -539,7 +556,11 @@
             "properties": {
               "sourceMutationRequired": { "const": false },
               "observableState": { "const": "runtime-dependency-tree" },
-              "completion": { "type": "object", "properties": { "installedTreePresent": { "const": true } }, "required": ["installedTreePresent"] }
+              "completion": {
+                "type": "object",
+                "properties": { "installedTreePresent": { "const": true } },
+                "required": ["installedTreePresent"]
+              }
             }
           }
         }
@@ -625,6 +646,51 @@
         "command": { "type": "string" },
         "phony": { "type": "boolean" }
       },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "file-create" } } },
+          "then": {
+            "required": ["content", "overwrite"],
+            "properties": { "content": {}, "overwrite": { "const": false } }
+          }
+        },
+        {
+          "if": { "properties": { "type": { "const": "file-append" } } },
+          "then": {
+            "required": ["lines", "ensureNewline"],
+            "properties": { "lines": {}, "ensureNewline": {} }
+          }
+        },
+        {
+          "if": { "properties": { "type": { "const": "file-copy" } } },
+          "then": {
+            "required": ["sourcePath", "overwrite"],
+            "properties": { "sourcePath": {}, "overwrite": { "const": false } }
+          }
+        },
+        {
+          "if": { "properties": { "type": { "const": "package-json-script" } } },
+          "then": {
+            "required": ["scriptName", "scriptValue"],
+            "properties": { "scriptName": {}, "scriptValue": {} }
+          }
+        },
+        {
+          "if": { "properties": { "type": { "const": "json-edit" } } },
+          "then": { "required": ["edits"], "properties": { "edits": {} } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "env-key-add" } } },
+          "then": { "required": ["keys"], "properties": { "keys": {} } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "makefile-target" } } },
+          "then": {
+            "required": ["target", "command", "phony"],
+            "properties": { "target": {}, "command": {}, "phony": {} }
+          }
+        }
+      ],
       "additionalProperties": false
     }
   },

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

@@ -219,7 +219,15 @@
       "allOf": [
         {
           "if": { "properties": { "kind": { "const": "dependency-security" } } },
-          "then": { "properties": { "completion": { "type": "object", "properties": { "auditClean": { "const": true } }, "required": ["auditClean"] } } }
+          "then": {
+            "properties": {
+              "completion": {
+                "type": "object",
+                "properties": { "auditClean": { "const": true } },
+                "required": ["auditClean"]
+              }
+            }
+          }
         },
         {
           "if": { "properties": { "kind": { "const": "dependency-materialization" } } },
@@ -228,7 +236,11 @@
             "properties": {
               "sourceMutationRequired": { "const": false },
               "observableState": { "const": "runtime-dependency-tree" },
-              "completion": { "type": "object", "properties": { "installedTreePresent": { "const": true } }, "required": ["installedTreePresent"] }
+              "completion": {
+                "type": "object",
+                "properties": { "installedTreePresent": { "const": true } },
+                "required": ["installedTreePresent"]
+              }
             }
           }
         }
@@ -461,6 +473,7 @@
         "kind",
         "risk",
         "executable",
+        "findingStatus",
         "files",
         "preview",
         "diffPreview",
@@ -531,6 +544,17 @@
         "issueId": {
           "type": "string"
         },
+        "diagnosisFindingId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "causalKey": {
+          "type": "string",
+          "minLength": 1
+        },
+        "findingStatus": {
+          "enum": ["blocking", "advisory", "informational", "unknown"]
+        },
         "issueClass": {
           "enum": [
             "dependency",
@@ -572,6 +596,9 @@
         "operation": {
           "$ref": "#/$defs/repairOperation"
         },
+        "invocation": {
+          "$ref": "#/$defs/commandInvocation"
+        },
         "strategy": {
           "type": "array",
           "items": { "$ref": "#/$defs/repairStrategyStage" }

package/contracts/doctor-workspace-evidence.v1.json

@@ -47,6 +47,9 @@
           "graphDiagnosis": {
             "$ref": "https://workspai.dev/schemas/workspace-intelligence/doctor-graph-diagnosis.v1.json"
           },
+          "diagnosis": {
+            "$ref": "https://workspai.dev/schemas/workspace-intelligence/doctor-diagnosis.v1.json"
+          },
           "verdict": { "enum": ["passed", "attention", "blocked"] },
           "probeSummary": { "$ref": "#/$defs/probeSummary" }
         },
@@ -57,6 +60,7 @@
       "type": "object",
       "required": ["totalProjects", "totalIssues", "hasSystemErrors"],
       "properties": {
+        "counts": { "$ref": "#/$defs/counts" },
         "totalProjects": { "type": "integer", "minimum": 0 },
         "totalIssues": { "type": "integer", "minimum": 0 },
         "projectAdvisoryWarningProjects": { "type": "integer", "minimum": 0 },
@@ -78,6 +82,10 @@
     "policyProfile": { "$ref": "#/$defs/policyProfile" }
   },
   "$defs": {
+    "counts": {
+      "type": "object",
+      "additionalProperties": { "type": "integer", "minimum": 0 }
+    },
     "dependencyAudit": {
       "type": "object",
       "required": [
@@ -401,6 +409,7 @@
         "status": { "enum": ["pass", "warn", "fail"] },
         "severity": { "enum": ["info", "warn", "error"] },
         "scope": { "type": "string" },
+        "applicability": { "enum": ["applicable", "not-applicable", "unknown"] },
         "reason": { "type": "string" },
         "recommendation": { "type": "string" },
         "freshness": { "$ref": "#/$defs/freshness" },
@@ -540,7 +549,15 @@
       "allOf": [
         {
           "if": { "properties": { "kind": { "const": "dependency-security" } } },
-          "then": { "properties": { "completion": { "type": "object", "properties": { "auditClean": { "const": true } }, "required": ["auditClean"] } } }
+          "then": {
+            "properties": {
+              "completion": {
+                "type": "object",
+                "properties": { "auditClean": { "const": true } },
+                "required": ["auditClean"]
+              }
+            }
+          }
         },
         {
           "if": { "properties": { "kind": { "const": "dependency-materialization" } } },
@@ -549,7 +566,11 @@
             "properties": {
               "sourceMutationRequired": { "const": false },
               "observableState": { "const": "runtime-dependency-tree" },
-              "completion": { "type": "object", "properties": { "installedTreePresent": { "const": true } }, "required": ["installedTreePresent"] }
+              "completion": {
+                "type": "object",
+                "properties": { "installedTreePresent": { "const": true } },
+                "required": ["installedTreePresent"]
+              }
             }
           }
         }
@@ -635,6 +656,51 @@
         "command": { "type": "string" },
         "phony": { "type": "boolean" }
       },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "file-create" } } },
+          "then": {
+            "required": ["content", "overwrite"],
+            "properties": { "content": {}, "overwrite": { "const": false } }
+          }
+        },
+        {
+          "if": { "properties": { "type": { "const": "file-append" } } },
+          "then": {
+            "required": ["lines", "ensureNewline"],
+            "properties": { "lines": {}, "ensureNewline": {} }
+          }
+        },
+        {
+          "if": { "properties": { "type": { "const": "file-copy" } } },
+          "then": {
+            "required": ["sourcePath", "overwrite"],
+            "properties": { "sourcePath": {}, "overwrite": { "const": false } }
+          }
+        },
+        {
+          "if": { "properties": { "type": { "const": "package-json-script" } } },
+          "then": {
+            "required": ["scriptName", "scriptValue"],
+            "properties": { "scriptName": {}, "scriptValue": {} }
+          }
+        },
+        {
+          "if": { "properties": { "type": { "const": "json-edit" } } },
+          "then": { "required": ["edits"], "properties": { "edits": {} } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "env-key-add" } } },
+          "then": { "required": ["keys"], "properties": { "keys": {} } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "makefile-target" } } },
+          "then": {
+            "required": ["target", "command", "phony"],
+            "properties": { "target": {}, "command": {}, "phony": {} }
+          }
+        }
+      ],
       "additionalProperties": false
     }
   },

package/contracts/extension-cli-compatibility.v1.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "rapidkit-extension-cli-compatibility.v1",
   "cli": "workspai",
-  "minimumVerifiedCliVersion": "0.55.0",
+  "minimumVerifiedCliVersion": "0.56.0",
   "publishedContractSchemas": {
     "workspaceContract": 1,
     "runtimeCommandSurface": "rapidkit-runtime-command-surface-v1",
@@ -20,6 +20,11 @@
     "doctorProjectEvidence": "doctor-project-evidence-v1",
     "doctorWorkspaceEvidence": "doctor-workspace-evidence-v1",
     "doctorGraphDiagnosis": "doctor-graph-diagnosis.v1",
+    "doctorDiagnosis": "workspai.doctor-diagnosis.v1",
+    "doctorCapabilities": "workspai.doctor-capabilities.v1",
+    "doctorValidation": "workspai.doctor-validation.v1",
+    "doctorReceipt": "workspai.doctor-receipt.v1",
+    "doctorSummary": "workspai.doctor-summary.v1",
     "projectTestCoverage": "workspai.project-test-coverage.v1",
     "verifiedGoal": "workspai.verified-goal.v1",
     "verifiedGoalStatus": "workspai.verified-goal-status.v1",

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

@@ -86,6 +86,31 @@
       "contractPath": "contracts/workspace-intelligence/doctor-graph-diagnosis.v1.json",
       "publication": "json-schema"
     },
+    "doctorDiagnosis": {
+      "schemaVersion": "workspai.doctor-diagnosis.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-diagnosis.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorCapabilities": {
+      "schemaVersion": "workspai.doctor-capabilities.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-capabilities.v1.json",
+      "publication": "capability-contract"
+    },
+    "doctorValidation": {
+      "schemaVersion": "workspai.doctor-validation.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-validation.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorReceipt": {
+      "schemaVersion": "workspai.doctor-receipt.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-receipt.v1.json",
+      "publication": "json-schema"
+    },
+    "doctorSummary": {
+      "schemaVersion": "workspai.doctor-summary.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-summary.v1.json",
+      "publication": "json-schema"
+    },
     "projectTestCoverage": {
       "schemaVersion": "workspai.project-test-coverage.v1",
       "contractPath": "contracts/project-test-coverage.v1.json",

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

@@ -362,6 +362,25 @@
         "doctor"
       ]
     },
+    {
+      "invocation": "doctor capabilities --validate --write",
+      "summary": "Validate every registered Doctor adapter and persist the governed capability and validation artifacts in the selected workspace.",
+      "canonicalArgv": [
+        "doctor",
+        "capabilities",
+        "--validate",
+        "--write"
+      ]
+    },
+    {
+      "invocation": "doctor capabilities --write",
+      "summary": "Persist the canonical Doctor capability matrix as a governed workspace artifact.",
+      "canonicalArgv": [
+        "doctor",
+        "capabilities",
+        "--write"
+      ]
+    },
     {
       "invocation": "doctor project",
       "summary": "Diagnose the current project and emit structured project evidence.",
@@ -1874,6 +1893,31 @@
         ]
       ]
     },
+    {
+      "artifactPath": ".workspai/reports/doctor-capabilities.json",
+      "schemaVersion": "workspai.doctor-capabilities.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-capabilities.v1.json",
+      "producerCommands": [
+        [
+          "doctor",
+          "capabilities",
+          "--write"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/doctor-validation-last-run.json",
+      "schemaVersion": "workspai.doctor-validation.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-validation.v1.json",
+      "producerCommands": [
+        [
+          "doctor",
+          "capabilities",
+          "--validate",
+          "--write"
+        ]
+      ]
+    },
     {
       "artifactPath": ".workspai/reports/bootstrap-compliance.latest.json",
       "schemaVersion": "bootstrap-compliance.v1",
@@ -1928,6 +1972,21 @@
         ]
       ]
     },
+    {
+      "artifactPath": ".workspai/reports/doctor-receipt-last-run.json",
+      "schemaVersion": "workspai.doctor-receipt.v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-receipt.v1.json",
+      "producerCommands": [
+        [
+          "doctor",
+          "workspace"
+        ],
+        [
+          "doctor",
+          "project"
+        ]
+      ]
+    },
     {
       "artifactPath": ".workspai/reports/project-test-coverage-last-run.json",
       "schemaVersion": "workspai.project-test-coverage.v1",
@@ -2536,6 +2595,10 @@
           "flag": "--limit",
           "description": "Bound graph query results (1–100)."
         },
+        {
+          "flag": "--refresh-graph",
+          "description": "Bypass the compatible persisted graph and rebuild from live sources."
+        },
         {
           "flag": "--include-paths",
           "description": "Include absolute filesystem paths."