@acidicsoil/portable-capabilities 0.1.7 → 0.1.8

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@acidicsoil/portable-capabilities",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Portable analytical capability compiler, runtime package generator, and CLI",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AcidicSoil/portable-capabilities.git"
+  },
   "type": "module",
   "bin": {
     "portable-capabilities": "./dist-release/cli.js"
@@ -15,14 +19,32 @@
     "node": ">=24.14.0",
     "pnpm": ">=11.1.0"
   },
+  "dependencies": {
+    "ajv": "8.20.0",
+    "yaml": "2.9.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.5",
+    "@changesets/changelog-github": "1.0.0",
+    "@changesets/cli": "2.29.7",
+    "@types/node": "24.1.0",
+    "@vitest/coverage-v8": "4.1.10",
+    "esbuild": "0.25.12",
+    "execa": "10.0.0",
+    "fast-check": "4.9.0",
+    "lefthook": "1.11.13",
+    "prettier": "3.6.2",
+    "tsx": "4.20.3",
+    "typescript": "5.8.3",
+    "vitest": "4.1.10"
+  },
   "scripts": {
-    "prepack": "node scripts/release/build-public-package.mjs",
-    "typecheck": "turbo run typecheck",
-    "test:run": "turbo run test",
+    "typecheck": "pnpm -r --if-present run typecheck",
+    "test:run": "pnpm typecheck && pnpm -r --if-present run test",
     "test:coverage": "vitest run --coverage",
-    "ci": "pnpm verify:tool-boundary && pnpm format:yaml:check && pnpm format:docs:check && pnpm turbo lint format-check typecheck test verify:reproducible && pnpm audit --prod --audit-level moderate",
-    "build": "turbo run build",
-    "lint": "turbo run lint",
+    "ci": "pnpm verify:rfc-governance && pnpm verify:tool-boundary && pnpm verify:ci-matrix && pnpm format:yaml:check && pnpm format:docs:check && pnpm lint && pnpm format-check && pnpm typecheck && pnpm test && pnpm verify:reproducible && pnpm audit --prod --audit-level moderate",
+    "build": "pnpm -r --if-present run build",
+    "lint": "pnpm -r --if-present run lint",
     "lint:fix": "biome lint --write .",
     "format": "biome format --write .",
     "format:check": "biome format .",
@@ -30,49 +52,22 @@
     "check:fix": "biome check --write .",
     "biome:ci": "biome ci .",
     "cli": "tsx packages/cli/src/entry.ts",
-    "verify:reproducible": "turbo run verify:reproducible",
-    "test": "turbo run test",
-    "format-check": "turbo run format-check",
+    "verify:reproducible": "pnpm typecheck && pnpm -r --if-present run test",
+    "test": "pnpm typecheck && pnpm -r --if-present run test",
+    "format-check": "pnpm -r --if-present run format-check",
     "format:yaml": "prettier --write \"pnpm-workspace.yaml\" \"pnpm-lock.yaml\" \"lefthook.yml\" \"packages/fixtures/data/**/*.{yaml,yml}\" \".github/workflows/*.{yaml,yml}\"",
     "format:yaml:check": "prettier --check \"pnpm-workspace.yaml\" \"pnpm-lock.yaml\" \"lefthook.yml\" \"packages/fixtures/data/**/*.{yaml,yml}\" \".github/workflows/*.{yaml,yml}\"",
     "verify:tool-boundary": "node scripts/verify-tool-boundary.mjs",
-    "verify:generated-drift": "node scripts/verify-generated-drift.mjs",
     "verify:ci-matrix": "node scripts/verify-ci-matrix.mjs",
-    "release:pack:verify": "node scripts/release/verify-pack.mjs && node scripts/release/verify-public-package.mjs",
-    "release:internal-cli-pack:verify": "node scripts/release/verify-pack.mjs",
+    "release:pack:verify": "pnpm changeset:status && node scripts/release/verify-public-package.mjs",
     "release:public-package:build": "node scripts/release/build-public-package.mjs",
     "changeset": "changeset",
     "changeset:status": "changeset status",
-    "release:cli:build": "node scripts/release/build-cli.mjs",
-    "release:bundles": "tsx scripts/release/generate-bundles.ts",
-    "release:bundles:verify": "node scripts/release/verify-bundles.mjs",
     "docs:verify": "node scripts/release/verify-docs.mjs",
     "release:verify": "node scripts/release/verify-clean-checkout.mjs",
-    "release:prepare": "bash scripts/release/publish.sh",
-    "release:publish": "bash scripts/release/publish.sh --publish --push",
+    "release:published:verify": "node scripts/release/verify-published-package.mjs",
     "format:docs": "prettier --write \"README.md\" \"CHANGELOG.md\" \"phase-6.1-milestone.md\" \"docs/**/*.md\" \"packages/**/*.md\" \".planning/**/*.md\" \".changeset/**/*.md\"",
     "format:docs:check": "prettier --check \"README.md\" \"CHANGELOG.md\" \"phase-6.1-milestone.md\" \"docs/**/*.md\" \"packages/**/*.md\" \".planning/**/*.md\" \".changeset/**/*.md\"",
-    "verify:runtime": "node scripts/verify-native-runtime.mjs",
-    "demo": "node scripts/demo.mjs"
-  },
-  "dependencies": {
-    "ajv": "8.20.0",
-    "yaml": "2.9.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "2.5.5",
-    "@changesets/cli": "2.29.7",
-    "@types/node": "24.1.0",
-    "@vitest/coverage-v8": "4.1.10",
-    "esbuild": "0.25.12",
-    "execa": "10.0.0",
-    "fast-check": "4.9.0",
-    "lefthook": "1.11.13",
-    "prettier": "3.6.2",
-    "tsx": "4.20.3",
-    "turbo": "2.5.6",
-    "typescript": "5.8.3",
-    "vitest": "4.1.10"
-  },
-  "packageManager": "pnpm@11.1.3"
-}
+    "verify:rfc-governance": "tsx scripts/verify-rfc-architecture-governance.ts"
+  }
+}

package/schemas/canonical-artifact.schema.json

@@ -0,0 +1,220 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://portable-capabilities.dev/schemas/canonical-artifact/1.0",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "kind",
+    "title",
+    "inputs",
+    "outputs",
+    "requiredOutcomes",
+    "forbiddenOutcomes",
+    "effects",
+    "resources",
+    "invocationIntents",
+    "topologyRequirements",
+    "evidenceRequirements",
+    "allowedDegradation",
+    "directBaseline"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "kind": {
+      "enum": ["skill", "agent", "command", "workflow", "rule", "hook", "tool", "resource"]
+    },
+    "title": {
+      "type": "string"
+    },
+    "inputs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "outputs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "requiredOutcomes": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/outcome"
+      }
+    },
+    "forbiddenOutcomes": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/outcome"
+      }
+    },
+    "effects": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "resources": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "invocationIntents": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string"
+      }
+    },
+    "topologyRequirements": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "evidenceRequirements": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "allowedDegradation": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "directBaseline": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "invocationIntent",
+        "steps",
+        "requiredOutcomes",
+        "forbiddenOutcomes",
+        "requiredResources",
+        "optionalSurfaceIndependent"
+      ],
+      "properties": {
+        "invocationIntent": {
+          "type": "string"
+        },
+        "steps": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        },
+        "requiredOutcomes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "forbiddenOutcomes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "requiredResources": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "optionalSurfaceIndependent": {
+          "const": true
+        }
+      }
+    },
+    "optionalSurfaceIds": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "operationalContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "activation",
+        "inputs",
+        "procedure",
+        "decisions",
+        "resources",
+        "ambiguityAndAbstention",
+        "stopConditions",
+        "outputConstruction",
+        "validation",
+        "examples"
+      ],
+      "properties": {
+        "activation": { "$ref": "#/$defs/nonEmptyStringList" },
+        "inputs": { "$ref": "#/$defs/nonEmptyStringList" },
+        "procedure": { "$ref": "#/$defs/nonEmptyStringList" },
+        "decisions": { "$ref": "#/$defs/nonEmptyStringList" },
+        "resources": { "$ref": "#/$defs/nonEmptyStringList" },
+        "ambiguityAndAbstention": { "$ref": "#/$defs/nonEmptyStringList" },
+        "stopConditions": { "$ref": "#/$defs/nonEmptyStringList" },
+        "outputConstruction": { "$ref": "#/$defs/nonEmptyStringList" },
+        "validation": { "$ref": "#/$defs/nonEmptyStringList" },
+        "examples": { "$ref": "#/$defs/nonEmptyStringList" }
+      }
+    },
+    "resourceFiles": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/resourceFile"
+      }
+    }
+  },
+  "$defs": {
+    "outcome": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "description"],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    },
+    "nonEmptyStringList": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "resourceFile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sourceFile", "canonicalPath", "packagePath", "mediaType", "content", "digest"],
+      "properties": {
+        "sourceFile": { "type": "string", "minLength": 1 },
+        "canonicalPath": { "type": "string", "minLength": 1 },
+        "packagePath": { "type": "string", "minLength": 1 },
+        "mediaType": { "type": "string", "minLength": 1 },
+        "content": { "type": "string" },
+        "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      }
+    }
+  }
+}

package/schemas/runtime-descriptor.schema.json

@@ -0,0 +1,338 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://portable-capabilities.dev/schemas/runtime-descriptor/1.0",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "aliases",
+    "supportedVersions",
+    "locations",
+    "surfaces",
+    "configuration",
+    "managedHooks",
+    "extensionEvents",
+    "ownership",
+    "degradation"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string"
+    },
+    "aliases": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "supportedVersions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "locations": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "artifactKind",
+          "scope",
+          "evidenceClaimIds",
+          "installation",
+          "registration",
+          "uninstall"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "artifactKind": {
+            "type": "string"
+          },
+          "scope": {
+            "enum": ["user", "project"]
+          },
+          "pathTemplate": {
+            "type": "string"
+          },
+          "environmentOverride": {
+            "type": "string"
+          },
+          "evidenceClaimIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "installation": {
+            "enum": ["automatic", "approval-required", "manual", "unsupported"]
+          },
+          "registration": {
+            "enum": ["discovery", "structured-config", "plugin-manager", "manual"]
+          },
+          "uninstall": {
+            "enum": ["automatic", "manual", "unsupported"]
+          }
+        }
+      }
+    },
+    "surfaces": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "semanticKind",
+          "integrationMode",
+          "adapterId",
+          "discovery",
+          "invocation",
+          "precedence",
+          "evidenceClaimIds",
+          "stability",
+          "evidenceState"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "semanticKind": {
+            "type": "string"
+          },
+          "integrationMode": {
+            "enum": ["declarative", "imperative", "hybrid", "manual-only"]
+          },
+          "adapterId": {
+            "type": "string"
+          },
+          "discovery": {
+            "type": "string"
+          },
+          "invocation": {
+            "type": "string"
+          },
+          "precedence": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "evidenceClaimIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "stability": {
+            "enum": ["stable", "experimental", "version-gated", "deprecated"]
+          },
+          "evidenceState": {
+            "enum": ["documented", "source-observed", "runtime-observed", "inferred", "unknown"]
+          }
+        }
+      }
+    },
+    "configuration": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "format",
+          "locationId",
+          "mutation",
+          "ownership",
+          "uninstall",
+          "evidenceClaimIds"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "format": {
+            "enum": ["json", "yaml", "toml", "text"]
+          },
+          "evidenceClaimIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "locationId": {
+            "type": "string"
+          },
+          "mutation": {
+            "enum": ["replace-owned", "merge-object", "append-section", "manual"]
+          },
+          "registrationKey": {
+            "type": "string"
+          },
+          "ownership": {
+            "enum": ["entry", "section", "whole-file"]
+          },
+          "uninstall": {
+            "enum": ["remove-owned-entry", "remove-owned-section", "manual"]
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "managedHooks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "event",
+          "payloadShape",
+          "ordering",
+          "blocking",
+          "failureMode",
+          "mutationAllowed",
+          "registration",
+          "uninstall",
+          "evidenceClaimIds"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "event": {
+            "type": "string"
+          },
+          "payloadShape": {
+            "type": "string"
+          },
+          "ordering": {
+            "enum": ["before", "after", "priority", "unspecified"]
+          },
+          "timeoutMs": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "blocking": {
+            "type": "boolean"
+          },
+          "failureMode": {
+            "enum": ["fail-open", "fail-closed", "report-only"]
+          },
+          "mutationAllowed": {
+            "type": "boolean"
+          },
+          "registration": {
+            "enum": ["config", "command", "plugin", "manual"]
+          },
+          "uninstall": {
+            "enum": ["automatic", "manual"]
+          },
+          "evidenceClaimIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "extensionEvents": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "event",
+          "payloadShape",
+          "ordering",
+          "blocking",
+          "failureMode",
+          "mutationAllowed",
+          "registration",
+          "uninstall",
+          "evidenceClaimIds"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "event": {
+            "type": "string"
+          },
+          "payloadShape": {
+            "type": "string"
+          },
+          "ordering": {
+            "enum": ["before", "after", "priority", "unspecified"]
+          },
+          "timeoutMs": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "blocking": {
+            "type": "boolean"
+          },
+          "failureMode": {
+            "enum": ["fail-open", "fail-closed", "report-only"]
+          },
+          "mutationAllowed": {
+            "type": "boolean"
+          },
+          "registration": {
+            "enum": ["extension-api", "plugin-api", "manual"]
+          },
+          "uninstall": {
+            "enum": ["automatic", "manual"]
+          },
+          "evidenceClaimIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "ownership": {
+      "type": "object",
+      "required": ["uninstallSupported"],
+      "properties": {
+        "uninstallSupported": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "degradation": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["from", "to", "lostSemantics"],
+        "properties": {
+          "from": {
+            "type": "string"
+          },
+          "to": {
+            "type": "string"
+          },
+          "lostSemantics": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  }
+}