@acidicsoil/portable-capabilities 0.1.10 → 0.1.15

package/dist-release/index.js

@@ -1997,13 +1997,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} source - expected values are default/config/env/cli/implied
        * @return {Command} `this` command for chaining
        */
-      setOptionValueWithSource(key, value, source3) {
+      setOptionValueWithSource(key, value, source2) {
         if (this._storeOptionsAsProperties) {
           this[key] = value;
         } else {
           this._optionValues[key] = value;
         }
-        this._optionValueSources[key] = source3;
+        this._optionValueSources[key] = source2;
         return this;
       }
       /**
@@ -2024,13 +2024,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {string}
        */
       getOptionValueSourceWithGlobals(key) {
-        let source3;
+        let source2;
         this._getCommandAndAncestors().forEach((cmd) => {
           if (cmd.getOptionValueSource(key) !== void 0) {
-            source3 = cmd.getOptionValueSource(key);
+            source2 = cmd.getOptionValueSource(key);
           }
         });
-        return source3;
+        return source2;
       }
       /**
        * Get user arguments from implied or explicit arguments.
@@ -2900,8 +2900,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const getErrorMessage = (option2) => {
           const bestOption = findBestOptionFromValue(option2);
           const optionKey = bestOption.attributeName();
-          const source3 = this.getOptionValueSource(optionKey);
-          if (source3 === "env") {
+          const source2 = this.getOptionValueSource(optionKey);
+          if (source2 === "env") {
             return `environment variable '${bestOption.envVar}'`;
           }
           return `option '${bestOption.flags}'`;
@@ -3784,10 +3784,10 @@ async function writeJournal(targetRoot, journal) {
   );
   await rename2(temporary, path9);
 }
-async function copyAtomically(source3, target, mode) {
+async function copyAtomically(source2, target, mode) {
   await mkdir2(dirname3(target), { recursive: true });
   const temporary = `${target}.pc-stage-${process.pid}`;
-  await copyFile(source3, temporary);
+  await copyFile(source2, temporary);
   await chmod(temporary, mode);
   await rename2(temporary, target);
 }
@@ -3970,13 +3970,13 @@ async function planReconciliation(options, manifest, desired) {
   return { writes, removes, preserved, nextManifest };
 }
 async function backupPath(targetRoot, transactionRoot, path9) {
-  const source3 = await assertNoSymlinkInPreparedPath(targetRoot, path9);
-  if (!await pathExists(source3)) return false;
+  const source2 = await assertNoSymlinkInPreparedPath(targetRoot, path9);
+  if (!await pathExists(source2)) return false;
   await assertNoSymlinkInPreparedPath(targetRoot, path9);
   const target = join3(transactionRoot, "backup", path9);
   await mkdir2(dirname3(target), { recursive: true });
   await assertNoSymlinkInPreparedPath(targetRoot, path9);
-  await copyFile(source3, target);
+  await copyFile(source2, target);
   return true;
 }
 async function restoreTransaction(targetRoot, transactionRoot, mutations, manifestHadOriginal, options) {
@@ -8143,11 +8143,11 @@ var getToStream = (destination7, to = "stdin") => {
   }
   return destinationStream;
 };
-var getFromStream = (source3, from = "stdout") => {
+var getFromStream = (source2, from = "stdout") => {
   const isWritable = false;
-  const { options, fileDescriptors } = SUBPROCESS_OPTIONS.get(source3);
+  const { options, fileDescriptors } = SUBPROCESS_OPTIONS.get(source2);
   const fdNumber = getFdNumber(fileDescriptors, from, isWritable);
-  const sourceStream = fdNumber === "all" ? source3.all : source3.stdio[fdNumber];
+  const sourceStream = fdNumber === "all" ? source2.all : source2.stdio[fdNumber];
   if (sourceStream === null || sourceStream === void 0) {
     throw new TypeError(getInvalidStdioOptionMessage(fdNumber, from, options, isWritable));
   }
@@ -9849,17 +9849,17 @@ var PASSTHROUGH_LISTENERS_PER_STREAM = 1;
 
 // node_modules/.pnpm/execa@10.0.0/node_modules/execa/lib/io/pipeline.js
 import { finished as finished3 } from "node:stream/promises";
-var pipeStreams = (source3, destination7) => {
-  source3.pipe(destination7);
-  onSourceFinish(source3, destination7);
-  onDestinationFinish(source3, destination7);
+var pipeStreams = (source2, destination7) => {
+  source2.pipe(destination7);
+  onSourceFinish(source2, destination7);
+  onDestinationFinish(source2, destination7);
 };
-var onSourceFinish = async (source3, destination7) => {
-  if (isStandardStream(source3) || isStandardStream(destination7)) {
+var onSourceFinish = async (source2, destination7) => {
+  if (isStandardStream(source2) || isStandardStream(destination7)) {
     return;
   }
   try {
-    await finished3(source3, { cleanup: true, readable: true, writable: false });
+    await finished3(source2, { cleanup: true, readable: true, writable: false });
   } catch {
   }
   endDestinationStream(destination7);
@@ -9869,19 +9869,19 @@ var endDestinationStream = (destination7) => {
     destination7.end();
   }
 };
-var onDestinationFinish = async (source3, destination7) => {
-  if (isStandardStream(source3) || isStandardStream(destination7)) {
+var onDestinationFinish = async (source2, destination7) => {
+  if (isStandardStream(source2) || isStandardStream(destination7)) {
     return;
   }
   try {
     await finished3(destination7, { cleanup: true, readable: false, writable: true });
   } catch {
   }
-  abortSourceStream(source3);
+  abortSourceStream(source2);
 };
-var abortSourceStream = (source3) => {
-  if (source3.readable) {
-    source3.destroy();
+var abortSourceStream = (source2) => {
+  if (source2.readable) {
+    source2.destroy();
   }
 };
 
@@ -10605,7 +10605,7 @@ var createWritableStream = (subprocess, writableOptions) => Writable3.toWeb(subp
 var createTransformStream = (subprocess, duplexOptions) => Duplex3.toWeb(subprocess.duplex(duplexOptions));
 
 // node_modules/.pnpm/execa@10.0.0/node_modules/execa/lib/pipe/pipe-arguments.js
-var normalizePipeArguments = ({ source: source3, sourcePromise, boundOptions, createNested }, ...pipeArguments) => {
+var normalizePipeArguments = ({ source: source2, sourcePromise, boundOptions, createNested }, ...pipeArguments) => {
   const startTime = getStartTime();
   const {
     destination: destination7,
@@ -10614,8 +10614,8 @@ var normalizePipeArguments = ({ source: source3, sourcePromise, boundOptions, cr
     from,
     unpipeSignal
   } = getDestinationStream(boundOptions, createNested, pipeArguments);
-  const { sourceStream, sourceError } = getSourceStream(source3, from);
-  const { options: sourceOptions, fileDescriptors } = SUBPROCESS_OPTIONS.get(source3);
+  const { sourceStream, sourceError } = getSourceStream(source2, from);
+  const { options: sourceOptions, fileDescriptors } = SUBPROCESS_OPTIONS.get(source2);
   return {
     sourcePromise,
     sourceStream,
@@ -10668,9 +10668,9 @@ var getDestination = (boundOptions, createNested, firstArgument, ...pipeArgument
   throw new TypeError(`The first argument must be a template string, an options object, or an Execa subprocess: ${firstArgument}`);
 };
 var mapDestinationArguments = ({ options }) => ({ options: { ...options, stdin: "pipe", piped: true } });
-var getSourceStream = (source3, from) => {
+var getSourceStream = (source2, from) => {
   try {
-    const sourceStream = getFromStream(source3, from);
+    const sourceStream = getFromStream(source2, from);
     return { sourceStream };
   } catch (error) {
     return { sourceError: error };
@@ -12153,6 +12153,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([
@@ -12175,7 +12184,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";
       })
     );
@@ -12192,8 +12203,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,
@@ -12454,7 +12469,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") {
@@ -12640,7 +12670,7 @@ async function resolveVerifiedCapabilityEntrypoint(options) {
 }
 
 // packages/cli/src/release.ts
-var cliVersion = true ? "0.1.10" : 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 resolve4 } from "node:path";
@@ -12799,7 +12829,7 @@ var antigravityRuntimeDescriptor = {
   schemaVersion: "1.0",
   id: "antigravity",
   aliases: ["google-antigravity", "antigravity-cli"],
-  supportedVersions: [">=2.0.0"],
+  supportedVersions: [">=1.1.4 <2.0.0"],
   locations: [
     {
       id: "antigravity-project-skills",
@@ -12898,11 +12928,11 @@ var antigravityRuntimeDescriptor = {
       evidenceState: "source-observed"
     },
     {
-      id: "antigravity-2.0-rules",
+      id: "antigravity-workspace-rules",
       semanticKind: "rule",
       integrationMode: "declarative",
       adapterId: markdown,
-      discovery: "2.0 workspace rules are discovered from .agents/rules.",
+      discovery: "Workspace rules may be discovered from .agents/rules when verified for a supported client.",
       invocation: "Rules apply according to their activation mode.",
       precedence: ["workspace", "global"],
       evidenceClaimIds: ["antigravity.cli.discovery.rules"],
@@ -12910,11 +12940,11 @@ var antigravityRuntimeDescriptor = {
       evidenceState: "source-observed"
     },
     {
-      id: "antigravity-2.0-agents",
+      id: "antigravity-workspace-agents",
       semanticKind: "agent",
       integrationMode: "declarative",
       adapterId: markdown,
-      discovery: "Custom agents are discovered from .agents/agents.",
+      discovery: "Workspace agents may be discovered from .agents/agents when verified for a supported client.",
       invocation: "Invoke through the native subagent interface.",
       precedence: ["workspace", "global"],
       evidenceClaimIds: ["antigravity.cli.discovery.agents"],
@@ -12922,11 +12952,11 @@ var antigravityRuntimeDescriptor = {
       evidenceState: "source-observed"
     },
     {
-      id: "antigravity-2.0-hooks",
+      id: "antigravity-workspace-hooks",
       semanticKind: "hook",
       integrationMode: "declarative",
       adapterId: hook,
-      discovery: "hooks.json is discovered at workspace scope.",
+      discovery: "Workspace hooks may be discovered from hooks.json when verified for a supported client.",
       invocation: "Hooks participate in native tool and invocation events.",
       precedence: ["workspace", "global", "plugin"],
       evidenceClaimIds: ["antigravity.cli.hooks"],
@@ -12934,11 +12964,11 @@ var antigravityRuntimeDescriptor = {
       evidenceState: "source-observed"
     },
     {
-      id: "antigravity-2.0-mcp",
+      id: "antigravity-workspace-mcp",
       semanticKind: "mcp",
       integrationMode: "declarative",
       adapterId: mcp,
-      discovery: "mcp_config.json is discovered at workspace scope.",
+      discovery: "Workspace MCP may be discovered from mcp_config.json when verified for a supported client.",
       invocation: "MCP servers are exposed as native tools.",
       precedence: ["workspace", "global"],
       evidenceClaimIds: ["antigravity.cli.mcp"],
@@ -12986,148 +13016,148 @@ var antigravityRuntimeDescriptor = {
 // packages/adapters/src/antigravity/runtime-evidence.ts
 import { createHash as createHash9 } from "node:crypto";
 var digest2 = (value) => createHash9("sha256").update(value).digest("hex");
-var retrievedAt = "2026-08-10T00:00:00.000Z";
-var source = "docs/RFC/runtime-capability-profiles-revised.md";
-var sourceClaim = (id, category, subject, assertion, locator, state = "source-observed", mode = "2.0") => ({
-  schemaVersion: "1.0",
-  id,
-  runtimeId: "antigravity",
-  category,
-  subject,
-  assertion,
-  versionRange: `product-mode:${mode}; >=2.0.0`,
-  sourceType: "official-source",
-  source,
-  sourceLocator: locator,
-  sourceDigest: digest2(`${id}:${assertion}:${locator}`),
-  state,
-  confidence: state === "unknown" ? "medium" : "high",
-  verificationStatus: state === "unknown" ? "unverified" : "verified",
-  stability: state === "unknown" ? "version-gated" : "stable",
-  verifiedAt: retrievedAt
-});
+var retrievedAt = "2026-08-15T00:00:00.000Z";
+var cliVersionRange = ">=1.1.4 <2.0.0";
+var cliDocs = "https://codelabs.developers.google.com/antigravity/how-to-create-agent-skills-for-antigravity-cli";
+var productDocs = "https://www.antigravity.google/product/antigravity-cli";
+var sourceClaim = (id, category, subject, assertion, locator, options = {}) => {
+  const state = options.state ?? "source-observed";
+  return {
+    schemaVersion: "1.0",
+    id,
+    runtimeId: "antigravity",
+    category,
+    subject,
+    assertion,
+    versionRange: options.versionRange ?? cliVersionRange,
+    sourceType: "official-docs",
+    source: options.source ?? cliDocs,
+    sourceLocator: locator,
+    sourceDigest: digest2(`${id}:${assertion}:${locator}`),
+    state,
+    confidence: state === "unknown" ? "low" : "high",
+    verificationStatus: state === "unknown" ? "unverified" : "verified",
+    stability: state === "unknown" ? "version-gated" : "stable",
+    verifiedAt: retrievedAt
+  };
+};
 var antigravityRuntimeEvidence = [
   sourceClaim(
     "antigravity.location.project-skills",
     "location",
     "workspace skill root",
-    "Antigravity discovers workspace skills beneath .agents/skills.",
-    "Section 9: .agents/skills/<name>/SKILL.md"
+    "Antigravity CLI discovers workspace skills beneath .agents/skills.",
+    "Skill location: .agents/skills/<skill-name>/SKILL.md"
   ),
   sourceClaim(
     "antigravity.location.project-rules",
     "location",
     "workspace rule root",
-    "Antigravity discovers workspace rules beneath .agents/rules.",
-    "Section 9: .agents/rules/*.md"
+    "The native workspace rule path is not established by the verified CLI skill documentation.",
+    "Workspace rule path: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.location.project-agents",
     "location",
     "workspace agent root",
-    "Antigravity discovers custom agents beneath .agents/agents.",
-    "Section 3: .agents/agents/<name>.md"
+    "The native workspace agent path is not established by the verified CLI skill documentation.",
+    "Workspace agent path: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.location.project-hooks",
     "location",
     "workspace hook config",
-    "Antigravity discovers workspace hooks from .agents/hooks.json.",
-    "Section 3: .agents/hooks.json"
+    "The native workspace hook path is not established by the verified CLI skill documentation.",
+    "Workspace hook path: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.location.project-mcp",
     "location",
     "workspace MCP config",
-    "Antigravity discovers workspace MCP servers from .agents/mcp_config.json.",
-    "Section 3: .agents/mcp_config.json"
+    "The native workspace MCP configuration path is not established by the verified CLI skill documentation.",
+    "Workspace MCP path: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.location.plugins",
     "location",
     "CLI plugin staging root",
-    "Antigravity CLI stages plugins beneath the documented Gemini plugin root.",
-    "Section 2: ~/.gemini/antigravity-cli/plugins/<plugin-name>/"
+    "The native CLI plugin staging path is not established by the verified CLI skill documentation.",
+    "CLI plugin staging path: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.workflow.storage",
     "location",
     "workflow storage",
     "Workflow physical storage path is not established by primary public documentation.",
-    "Section 9: workflow storage unknown",
-    "unknown"
+    "Workflow storage path: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.cli.discovery.skills",
     "discovery",
     "CLI skill discovery",
-    "Antigravity CLI discovers project skills from .agents/skills.",
-    "Section 3; CLI mode; source observation only",
-    "source-observed",
-    "cli"
+    "Antigravity CLI automatically discovers project skills from .agents/skills.",
+    "Skill discovery and /skills listing"
   ),
   sourceClaim(
     "antigravity.cli.invocation.skills",
     "invocation",
     "CLI skill invocation",
-    "Antigravity CLI skill invocation is documented but not runtime-observed.",
-    "Section 6; CLI mode; runtime unavailable",
-    "source-observed",
-    "cli"
+    "Antigravity CLI can list and invoke a discovered skill from the project workspace.",
+    "Launch with agy; invoke through the skill-aware CLI workflow"
   ),
   sourceClaim(
     "antigravity.ide.discovery.skills",
     "discovery",
     "IDE skill discovery",
-    "Antigravity IDE uses the shared .agents/skills workspace root.",
-    "Section 3; IDE mode; runtime unavailable",
-    "source-observed",
-    "ide"
+    "IDE skill discovery is not established by the verified CLI skill documentation.",
+    "IDE skill discovery: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.cli.discovery.rules",
     "discovery",
-    "2.0 rule discovery",
-    "Workspace rules are discovered from .agents/rules.",
-    "Section 3; Antigravity 2.0 mode",
-    "source-observed",
-    "2.0"
+    "workspace rule discovery",
+    "Workspace rule discovery is not established by the verified CLI skill documentation.",
+    "Workspace rule discovery: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.cli.discovery.agents",
     "discovery",
-    "2.0 agent discovery",
-    "Custom agents are discovered from .agents/agents.",
-    "Section 3; Antigravity 2.0 mode",
-    "source-observed",
-    "2.0"
+    "workspace agent discovery",
+    "Workspace agent discovery is not established by the verified CLI skill documentation.",
+    "Workspace agent discovery: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.cli.hooks",
     "hooks",
-    "2.0 hook registration",
-    "Workspace hooks use .agents/hooks.json and typed tool decisions.",
-    "Section 6; Antigravity 2.0 mode",
-    "source-observed",
-    "2.0"
+    "workspace hook registration",
+    "Workspace hook registration is not established by the verified CLI skill documentation.",
+    "Workspace hook registration: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.cli.mcp",
     "mcp",
-    "2.0 MCP registration",
-    "Workspace MCP uses .agents/mcp_config.json.",
-    "Section 3; Antigravity 2.0 mode",
-    "source-observed",
-    "2.0"
+    "workspace MCP registration",
+    "Workspace MCP registration is not established by the verified CLI skill documentation.",
+    "Workspace MCP registration: not established",
+    { source: productDocs, state: "unknown" }
   ),
   sourceClaim(
     "antigravity.cli.plugins",
     "plugin",
     "CLI plugin registration",
-    "CLI plugins require staged bundles with plugin.json.",
-    "Section 5; CLI mode",
-    "source-observed",
-    "cli"
+    "CLI plugin registration is not established by the verified CLI skill documentation.",
+    "CLI plugin registration: not established",
+    { source: productDocs, state: "unknown" }
   )
 ];
 
@@ -14197,7 +14227,7 @@ async function prepareDCodeMaterialization(plan, root) {
 
 // packages/adapters/src/dcode/runtime-descriptor.ts
 var markdown3 = "materialize-markdown";
-var source2 = "source-observed";
+var source = "source-observed";
 var dcodeRuntimeDescriptor = {
   schemaVersion: "1.0",
   id: "dcode",
@@ -14256,7 +14286,7 @@ var dcodeRuntimeDescriptor = {
       precedence: ["project"],
       evidenceClaimIds: ["dcode.discovery.cli-skill", "dcode.invocation.cli-skill"],
       stability: "stable",
-      evidenceState: source2
+      evidenceState: source
     },
     {
       id: "dcode-cli-instructions",
@@ -14268,7 +14298,7 @@ var dcodeRuntimeDescriptor = {
       precedence: ["project"],
       evidenceClaimIds: ["dcode.location.project-root"],
       stability: "stable",
-      evidenceState: source2
+      evidenceState: source
     },
     {
       id: "dcode-cli-sync-subagents",
@@ -14280,7 +14310,7 @@ var dcodeRuntimeDescriptor = {
       precedence: ["project", "user"],
       evidenceClaimIds: ["dcode.cli.sync-subagents"],
       stability: "version-gated",
-      evidenceState: source2
+      evidenceState: source
     },
     {
       id: "dcode-cli-memory",
@@ -14292,7 +14322,7 @@ var dcodeRuntimeDescriptor = {
       precedence: ["project", "user"],
       evidenceClaimIds: ["dcode.cli.memory"],
       stability: "version-gated",
-      evidenceState: source2
+      evidenceState: source
     },
     {
       id: "dcode-cli-mcp",
@@ -14304,7 +14334,7 @@ var dcodeRuntimeDescriptor = {
       precedence: ["project", "user"],
       evidenceClaimIds: ["dcode.cli.mcp"],
       stability: "version-gated",
-      evidenceState: source2
+      evidenceState: source
     },
     {
       id: "dcode-cli-configuration",
@@ -14316,7 +14346,7 @@ var dcodeRuntimeDescriptor = {
       precedence: ["project", "user"],
       evidenceClaimIds: ["dcode.cli.configuration"],
       stability: "version-gated",
-      evidenceState: source2
+      evidenceState: source
     },
     {
       id: "dcode-cli-advisory-hooks",
@@ -14328,7 +14358,7 @@ var dcodeRuntimeDescriptor = {
       precedence: ["project", "user"],
       evidenceClaimIds: ["dcode.hooks.advisory"],
       stability: "version-gated",
-      evidenceState: source2
+      evidenceState: source
     },
     {
       id: "dcode-sdk-tools",
@@ -14340,7 +14370,7 @@ var dcodeRuntimeDescriptor = {
       precedence: ["sdk"],
       evidenceClaimIds: ["dcode.sdk.tools"],
       stability: "version-gated",
-      evidenceState: source2
+      evidenceState: source
     },
     {
       id: "dcode-cli-async-subagents",
@@ -15992,7 +16022,8 @@ var piRuntimeDescriptor = {
 // packages/adapters/src/pi/runtime-evidence.ts
 import { createHash as createHash15 } from "node:crypto";
 var digest8 = (value) => createHash15("sha256").update(value).digest("hex");
-var observedAt2 = "2026-08-08T04:24:00-05:00";
+var observedAt2 = "2026-08-15T00:00:00.000Z";
+var skillsDocs = "https://pi.dev/docs/latest/skills";
 var piRuntimeEvidence = [
   {
     schemaVersion: "1.0",
@@ -16054,13 +16085,13 @@ var piRuntimeEvidence = [
     runtimeId: "pi",
     category: "discovery",
     subject: "native skill discovery",
-    assertion: "Pi natively discovers a project skill with extensions disabled.",
-    versionRange: "=0.64.0",
-    sourceType: "runtime-probe",
-    source: "pi",
-    sourceLocator: "packages/conformance/src/tracer/pi-native-evidence.json",
-    sourceDigest: digest8("Pi native discovery with extensions disabled"),
-    state: "runtime-observed",
+    assertion: "Pi discovers project skills beneath .pi/skills.",
+    versionRange: ">=0.64.0",
+    sourceType: "official-docs",
+    source: skillsDocs,
+    sourceLocator: "Project skills: .pi/skills/",
+    sourceDigest: digest8("Pi project skills .pi/skills official docs"),
+    state: "source-observed",
     confidence: "high",
     verificationStatus: "verified",
     stability: "stable",
@@ -16072,13 +16103,13 @@ var piRuntimeEvidence = [
     runtimeId: "pi",
     category: "invocation",
     subject: "native skill invocation",
-    assertion: "Pi invokes a discovered project skill with extensions disabled.",
-    versionRange: "=0.64.0",
-    sourceType: "runtime-probe",
-    source: "pi",
-    sourceLocator: "packages/conformance/src/tracer/pi-native-evidence.json",
-    sourceDigest: digest8("Pi native invocation with extensions disabled"),
-    state: "runtime-observed",
+    assertion: "Pi loads a discovered skill when its description matches the task or the user invokes /skill:name.",
+    versionRange: ">=0.64.0",
+    sourceType: "official-docs",
+    source: skillsDocs,
+    sourceLocator: "Skill loading and invocation: /skill:name",
+    sourceDigest: digest8("Pi skill invocation official docs"),
+    state: "source-observed",
     confidence: "high",
     verificationStatus: "verified",
     stability: "stable",
@@ -16225,6 +16256,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")],
@@ -16269,6 +16301,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" } },
@@ -16277,6 +16323,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,
@@ -16352,6 +16405,14 @@ function renderVerifiedUsage(preview, descriptor, claims, runtimeVersion) {
     return verified ? `${descriptor.id}: ${surface.invocation}` : `${descriptor.id}: native usage unavailable; use manual guidance`;
   });
 }
+function negotiationDiagnostics(previews) {
+  return previews.flatMap(
+    (preview) => preview.negotiations.filter((negotiation) => negotiation.installationMode !== "automatic").map((negotiation) => {
+      const evidence = negotiation.evidenceClaimIds.join(", ") || "no evidence claims";
+      return `${negotiation.intent}: ${negotiation.installationMode} (${negotiation.reason}) [${evidence}]`;
+    })
+  );
+}
 function composeInstallationPlan(previews, artifacts, runtimeId) {
   const first = previews[0]?.installationPlan;
   if (!first) throw new Error("at least one installation plan is required");
@@ -16444,15 +16505,17 @@ async function executeSetupSelection(request, artifacts, descriptor, claims, con
     const duplicatePath = prepared.mutations.map((mutation) => mutation.path).find((path9, index, paths) => paths.indexOf(path9) !== index);
     if (duplicatePath)
       throw new Error(`Selection produced duplicate prepared path: ${duplicatePath}`);
+    const preparedDiagnostics = [
+      ...prepared.diagnostics?.map(
+        (diagnostic6) => `${diagnostic6.kind}: ${diagnostic6.message}`
+      ) ?? [],
+      ...executionRequest.intent === "remove" ? [] : negotiationDiagnostics(previews)
+    ];
     return executePreparedInstallation({
       ...lifecycleOptions,
       preparedOperation: executionRequest.intent === "update" ? "upgrade" : executionRequest.intent === "remove" ? "remove" : "install",
       preparedMutations: prepared.mutations,
-      ...prepared.diagnostics ? {
-        preparedDiagnostics: prepared.diagnostics.map(
-          (diagnostic6) => `${diagnostic6.kind}: ${diagnostic6.message}`
-        )
-      } : {}
+      ...preparedDiagnostics.length > 0 ? { preparedDiagnostics } : {}
     });
   })() : await statusInstallation(targetRoot);
   return { request, previews, lifecycle };