@acidicsoil/portable-capabilities 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.15
+
+### Patch Changes
+
+- [#94](https://github.com/AcidicSoil/portable-capabilities/pull/94) [`abdfc16`](https://github.com/AcidicSoil/portable-capabilities/commit/abdfc16269795747b42b97a32b1b3c6d121f6830) Thanks [@AcidicSoil](https://github.com/AcidicSoil)! - Require complete runtime evidence for negotiated surfaces and gate automatic installation paths on usable location evidence.
+
+## 0.1.14
+
+### Patch Changes
+
+- [#91](https://github.com/AcidicSoil/portable-capabilities/pull/91) [`9eed159`](https://github.com/AcidicSoil/portable-capabilities/commit/9eed159a134a688765c574f76ae9610f585f6dbf) Thanks [@AcidicSoil](https://github.com/AcidicSoil)! - Emit the input schema referenced by generated skills and verify referenced resources are installed across supported runtimes.
+
 ## 0.1.13
 
 ### Patch Changes

package/dist-release/cli.js

@@ -3684,6 +3684,15 @@ function resolveRuntimeEvidence(claim4, runtimeVersion) {
     reason: !applicable ? "version-inapplicable" : !sufficientState ? "insufficient-evidence" : !verified ? "unverified" : !confident ? "low-confidence" : !sourceComplete ? "incomplete-source" : claim4.stability === "deprecated" ? "deprecated" : "usable"
   };
 }
+function areRuntimeEvidenceClaimsUsable(claimIds, runtimeId, claims, runtimeVersion) {
+  if (claimIds.length === 0) return false;
+  return claimIds.every((claimId) => {
+    const claim4 = claims.find(
+      (candidate) => candidate.id === claimId && candidate.runtimeId === runtimeId
+    );
+    return claim4 !== void 0 && resolveRuntimeEvidence(claim4, runtimeVersion).usableForAutomaticInstall;
+  });
+}
 
 // packages/compiler/src/negotiation/adapter-registry.ts
 var adapterIds = Object.freeze([
@@ -3706,7 +3715,9 @@ function negotiateCapability(artifact, descriptor, claims, version) {
   return artifact.invocationIntents.map((intent) => {
     const surface = descriptor.surfaces.find(
       (x) => x.semanticKind === intent && (x.versionRange === void 0 || isRuntimeVersionInRange(x.versionRange, version)) && x.evidenceClaimIds.some((claimId) => {
-        const claim4 = claims.find((candidate) => candidate.id === claimId);
+        const claim4 = claims.find(
+          (candidate) => candidate.id === claimId && candidate.runtimeId === descriptor.id
+        );
         return claim4 !== void 0 && resolveRuntimeEvidence(claim4, version).reason !== "version-inapplicable";
       })
     );
@@ -3723,8 +3734,12 @@ function negotiateCapability(artifact, descriptor, claims, version) {
         evidenceClaimIds: [],
         reason: "no matching surface"
       };
-    const related = claims.filter((c4) => surface.evidenceClaimIds.includes(c4.id));
-    const usable = related.length > 0 && related.every((c4) => resolveRuntimeEvidence(c4, version).usableForAutomaticInstall);
+    const usable = areRuntimeEvidenceClaimsUsable(
+      surface.evidenceClaimIds,
+      descriptor.id,
+      claims,
+      version
+    );
     const degraded = descriptor.degradation.find((d) => d.from === intent);
     return {
       intent,
@@ -3985,7 +4000,22 @@ function planSetup(request, artifact, descriptor, claims, ownershipManifest) {
     request.runtimeVersion
   );
   const projectionPlan = planProjection(artifact, descriptor.id, request.scope, negotiations);
-  const baseInstallationPlan = planInstallation(projectionPlan, descriptor, request.runtimeVersion);
+  const evidenceBackedDescriptor = {
+    ...descriptor,
+    locations: descriptor.locations.filter(
+      (location) => location.installation === "manual" || location.installation === "unsupported" || areRuntimeEvidenceClaimsUsable(
+        location.evidenceClaimIds,
+        descriptor.id,
+        policyClaims,
+        request.runtimeVersion
+      )
+    )
+  };
+  const baseInstallationPlan = planInstallation(
+    projectionPlan,
+    evidenceBackedDescriptor,
+    request.runtimeVersion
+  );
   const mutatingIntent = request.intent === "setup" || request.intent === "update";
   let installationPlan = mutatingIntent ? baseInstallationPlan : { ...baseInstallationPlan, operations: [] };
   if (request.intent === "remove") {
@@ -11733,7 +11763,7 @@ function writeEnvelope(envelope, format2) {
 }
 
 // packages/cli/src/release.ts
-var cliVersion = true ? "0.1.13" : createRequire(import.meta.url)("../../../package.json").version;
+var cliVersion = true ? "0.1.15" : createRequire(import.meta.url)("../../../package.json").version;
 
 // packages/adapters/src/antigravity/materialize.ts
 import { resolve as resolve2 } from "node:path";
@@ -15792,6 +15822,7 @@ function operationalContract(role) {
     resources: [
       roleFacet(role, "resources"),
       "Load [resource:resources/contract.json] for the complete role contract.",
+      "Load [resource:resources/input.schema.json] before interpreting capability inputs.",
       "Load [resource:resources/output.schema.json] before constructing the final output."
     ],
     ambiguityAndAbstention: [roleFacet(role, "ambiguity"), roleFacet(role, "abstention")],
@@ -15836,6 +15867,20 @@ async function loadCanonicalArtifact(catalogRoot, capabilityId) {
   if (isAbsolute3(schemaRelativePath) || schemaRelativePath.startsWith(".."))
     throw new Error(`Canonical output schema escapes catalog: ${role.output.schema}`);
   const schemaContent = await readFile6(schemaFile, "utf8");
+  const inputSchemaContent = `${JSON.stringify(
+    {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      type: "object",
+      properties: Object.fromEntries(
+        role.inputs.map((input) => [input.name, { description: input.description }])
+      ),
+      required: role.inputs.filter((input) => input.required).map((input) => input.name),
+      additionalProperties: true
+    },
+    null,
+    2
+  )}
+`;
   const contract = operationalContract(role);
   const contractContent = `${JSON.stringify(
     { ...role, output: { ...role.output, schema: "resources/output.schema.json" } },
@@ -15844,6 +15889,13 @@ async function loadCanonicalArtifact(catalogRoot, capabilityId) {
   )}
 `;
   const resources = [
+    resource(
+      file,
+      "role.inputs",
+      "resources/input.schema.json",
+      "application/schema+json",
+      inputSchemaContent
+    ),
     resource(
       file,
       role.output.schema,