coding-agent-skills 0.2.8

package/examples/upgrade-evidence/chain-fail.evidence.json

@@ -0,0 +1,155 @@
+{
+  "contractVersion": "1.0.0",
+  "validator": {
+    "name": "check-adapter-upgrade-chain",
+    "version": "0.2.3"
+  },
+  "invocation": {
+    "id": "example-chain-fail-001",
+    "timestamp": "2026-06-14T12:04:00Z"
+  },
+  "beforeProject": {
+    "reference": "before",
+    "declarationStatus": "present",
+    "validationStatus": "pass"
+  },
+  "afterProject": {
+    "reference": "after",
+    "declarationStatus": "present",
+    "validationStatus": "fail"
+  },
+  "coreVersions": {
+    "before": "0.1.4",
+    "after": "0.2.3"
+  },
+  "adapterIds": [
+    "fixture-chain-adapter"
+  ],
+  "adapterVersions": {
+    "before": [
+      {
+        "adapterId": "fixture-chain-adapter",
+        "version": "1.0.0"
+      }
+    ],
+    "after": [
+      {
+        "adapterId": "fixture-chain-adapter",
+        "version": "1.0.0"
+      }
+    ]
+  },
+  "adapterSchemaVersions": {
+    "before": "1.0.0",
+    "after": "1.0.0"
+  },
+  "supportedSkillIds": {
+    "before": [
+      "repo-map"
+    ],
+    "after": [
+      "repo-map"
+    ]
+  },
+  "skillCompatibility": {
+    "before": [
+      {
+        "adapterId": "fixture-chain-adapter",
+        "skillId": "repo-map",
+        "versions": [
+          "0.1.4"
+        ],
+        "mode": "audit-only"
+      }
+    ],
+    "after": []
+  },
+  "pinStatus": {
+    "before": "0.1.4",
+    "after": "0.2.3",
+    "result": "accepted",
+    "staleClassification": "none"
+  },
+  "compatibilityResult": {
+    "result": "fail",
+    "codes": [
+      "adapter-set-drift",
+      "after-project-invalid",
+      "restriction-weakening"
+    ]
+  },
+  "restrictionInheritanceResult": {
+    "result": "fail",
+    "codes": [
+      "restriction-weakening"
+    ]
+  },
+  "approvalRequirements": [],
+  "detectedRisks": [
+    {
+      "code": "adapter-set-drift",
+      "summary": "The installed adapter set changed across revisions."
+    },
+    {
+      "code": "after-project-invalid",
+      "summary": "The proposed project revision did not validate."
+    },
+    {
+      "code": "restriction-weakening",
+      "summary": "Inherited restrictions were weakened."
+    }
+  ],
+  "blockingFailures": [
+    {
+      "code": "adapter-set-drift",
+      "summary": "The installed adapter set changed across revisions."
+    },
+    {
+      "code": "after-project-invalid",
+      "summary": "The proposed project revision did not validate."
+    },
+    {
+      "code": "restriction-weakening",
+      "summary": "Inherited restrictions were weakened."
+    }
+  ],
+  "warnings": [],
+  "safeSummary": "The read-only compatibility check rejected 3 condition(s).",
+  "finalStatus": "fail",
+  "confidence": {
+    "level": "high",
+    "reason": "Both sanitized revision summaries and compatibility results were available."
+  },
+  "changedState": {
+    "changed": false,
+    "summary": "No project, adapter, Git, runtime, service, database, or remote state was changed."
+  },
+  "recommendedNextAction": "Resolve every blocking failure and rerun the read-only validation.",
+  "chainId": "example-rejected-chain",
+  "chainSummary": {
+    "revisionCount": 3,
+    "transitionCount": 2,
+    "passedTransitions": 1,
+    "failedTransitions": 1,
+    "steps": [
+      {
+        "stepIndex": 1,
+        "beforeRevision": "revision-1",
+        "afterRevision": "revision-2",
+        "status": "pass",
+        "codes": []
+      },
+      {
+        "stepIndex": 2,
+        "beforeRevision": "revision-2",
+        "afterRevision": "revision-3",
+        "status": "fail",
+        "codes": [
+          "adapter-set-drift",
+          "after-project-invalid",
+          "restriction-weakening"
+        ]
+      }
+    ]
+  }
+}

package/examples/upgrade-evidence/chain-fail.evidence.md

@@ -0,0 +1,14 @@
+# Failed Chain Evidence
+
+- Validator: `check-adapter-upgrade-chain` `0.2.3`
+- Revisions: 3
+- Transitions: 2
+- Failed transitions: 1
+- Compatibility: fail
+- Restriction inheritance: fail
+- Final status: fail
+- Changed state: false
+
+Blocking condition: inherited restrictions were weakened in one proposed revision.
+
+Recommended action: repair every blocking transition and rerun the read-only chain check.

package/examples/upgrade-evidence/chain-pass.evidence.json

@@ -0,0 +1,156 @@
+{
+  "contractVersion": "1.0.0",
+  "validator": {
+    "name": "check-adapter-upgrade-chain",
+    "version": "0.2.3"
+  },
+  "invocation": {
+    "id": "example-chain-pass-001",
+    "timestamp": "2026-06-14T12:03:00Z"
+  },
+  "beforeProject": {
+    "reference": "before",
+    "declarationStatus": "present",
+    "validationStatus": "pass"
+  },
+  "afterProject": {
+    "reference": "after",
+    "declarationStatus": "present",
+    "validationStatus": "pass"
+  },
+  "coreVersions": {
+    "before": "0.1.4",
+    "after": "0.2.3"
+  },
+  "adapterIds": [
+    "fixture-chain-adapter"
+  ],
+  "adapterVersions": {
+    "before": [
+      {
+        "adapterId": "fixture-chain-adapter",
+        "version": "1.0.0"
+      }
+    ],
+    "after": [
+      {
+        "adapterId": "fixture-chain-adapter",
+        "version": "1.0.0"
+      }
+    ]
+  },
+  "adapterSchemaVersions": {
+    "before": "1.0.0",
+    "after": "1.0.0"
+  },
+  "supportedSkillIds": {
+    "before": [
+      "repo-map"
+    ],
+    "after": [
+      "repo-map"
+    ]
+  },
+  "skillCompatibility": {
+    "before": [
+      {
+        "adapterId": "fixture-chain-adapter",
+        "skillId": "repo-map",
+        "versions": [
+          "0.1.4"
+        ],
+        "mode": "audit-only"
+      }
+    ],
+    "after": [
+      {
+        "adapterId": "fixture-chain-adapter",
+        "skillId": "repo-map",
+        "versions": [
+          "0.2.3"
+        ],
+        "mode": "audit-only"
+      }
+    ]
+  },
+  "pinStatus": {
+    "before": "0.1.4",
+    "after": "0.2.3",
+    "result": "accepted",
+    "staleClassification": "none"
+  },
+  "compatibilityResult": {
+    "result": "pass",
+    "codes": []
+  },
+  "restrictionInheritanceResult": {
+    "result": "pass",
+    "codes": []
+  },
+  "approvalRequirements": [],
+  "detectedRisks": [],
+  "blockingFailures": [],
+  "warnings": [],
+  "safeSummary": "The read-only compatibility check passed without applying changes.",
+  "finalStatus": "pass",
+  "confidence": {
+    "level": "high",
+    "reason": "Both sanitized revision summaries and compatibility results were available."
+  },
+  "changedState": {
+    "changed": false,
+    "summary": "No project, adapter, Git, runtime, service, database, or remote state was changed."
+  },
+  "recommendedNextAction": "Request human approval before adopting this upgrade in a real project.",
+  "chainId": "example-safe-chain",
+  "chainSummary": {
+    "revisionCount": 7,
+    "transitionCount": 6,
+    "passedTransitions": 6,
+    "failedTransitions": 0,
+    "steps": [
+      {
+        "stepIndex": 1,
+        "beforeRevision": "revision-1",
+        "afterRevision": "revision-2",
+        "status": "pass",
+        "codes": []
+      },
+      {
+        "stepIndex": 2,
+        "beforeRevision": "revision-2",
+        "afterRevision": "revision-3",
+        "status": "pass",
+        "codes": []
+      },
+      {
+        "stepIndex": 3,
+        "beforeRevision": "revision-3",
+        "afterRevision": "revision-4",
+        "status": "pass",
+        "codes": []
+      },
+      {
+        "stepIndex": 4,
+        "beforeRevision": "revision-4",
+        "afterRevision": "revision-5",
+        "status": "pass",
+        "codes": []
+      },
+      {
+        "stepIndex": 5,
+        "beforeRevision": "revision-5",
+        "afterRevision": "revision-6",
+        "status": "pass",
+        "codes": []
+      },
+      {
+        "stepIndex": 6,
+        "beforeRevision": "revision-6",
+        "afterRevision": "revision-7",
+        "status": "pass",
+        "codes": []
+      }
+    ]
+  }
+}

package/examples/upgrade-evidence/stale-pin.evidence.json

@@ -0,0 +1,117 @@
+{
+  "contractVersion": "1.0.0",
+  "validator": {
+    "name": "check-adapter-upgrade",
+    "version": "0.2.3"
+  },
+  "invocation": {
+    "id": "example-stale-pin-001",
+    "timestamp": "2026-06-14T12:01:00Z"
+  },
+  "beforeProject": {
+    "reference": "before",
+    "declarationStatus": "present",
+    "validationStatus": "pass"
+  },
+  "afterProject": {
+    "reference": "after",
+    "declarationStatus": "present",
+    "validationStatus": "pass"
+  },
+  "coreVersions": {
+    "before": "0.2.2",
+    "after": "0.2.2"
+  },
+  "adapterIds": [
+    "fixture-upgrade-adapter"
+  ],
+  "adapterVersions": {
+    "before": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "version": "1.0.0"
+      }
+    ],
+    "after": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "version": "1.0.0"
+      }
+    ]
+  },
+  "adapterSchemaVersions": {
+    "before": "1.0.0",
+    "after": "1.0.0"
+  },
+  "supportedSkillIds": {
+    "before": [
+      "repo-map"
+    ],
+    "after": [
+      "repo-map"
+    ]
+  },
+  "skillCompatibility": {
+    "before": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "skillId": "repo-map",
+        "versions": [
+          "0.2.2"
+        ],
+        "mode": "audit-only"
+      }
+    ],
+    "after": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "skillId": "repo-map",
+        "versions": [
+          "0.2.2"
+        ],
+        "mode": "audit-only"
+      }
+    ]
+  },
+  "pinStatus": {
+    "before": "0.2.2",
+    "after": "0.2.2",
+    "result": "stale",
+    "staleClassification": "stale-exact-pin"
+  },
+  "compatibilityResult": {
+    "result": "fail",
+    "codes": [
+      "stale-exact-pin"
+    ]
+  },
+  "restrictionInheritanceResult": {
+    "result": "pass",
+    "codes": []
+  },
+  "approvalRequirements": [],
+  "detectedRisks": [
+    {
+      "code": "stale-exact-pin",
+      "summary": "The exact core pin is stale."
+    }
+  ],
+  "blockingFailures": [
+    {
+      "code": "stale-exact-pin",
+      "summary": "The exact core pin is stale."
+    }
+  ],
+  "warnings": [],
+  "safeSummary": "The read-only compatibility check rejected 1 condition(s).",
+  "finalStatus": "fail",
+  "confidence": {
+    "level": "high",
+    "reason": "Both sanitized revision summaries and compatibility results were available."
+  },
+  "changedState": {
+    "changed": false,
+    "summary": "No project, adapter, Git, runtime, service, database, or remote state was changed."
+  },
+  "recommendedNextAction": "Resolve every blocking failure and rerun the read-only validation."
+}

package/examples/upgrade-evidence/unsafe-upgrade.evidence.json

@@ -0,0 +1,128 @@
+{
+  "contractVersion": "1.0.0",
+  "validator": {
+    "name": "check-adapter-upgrade",
+    "version": "0.2.3"
+  },
+  "invocation": {
+    "id": "example-unsafe-upgrade-001",
+    "timestamp": "2026-06-14T12:02:00Z"
+  },
+  "beforeProject": {
+    "reference": "before",
+    "declarationStatus": "present",
+    "validationStatus": "pass"
+  },
+  "afterProject": {
+    "reference": "after",
+    "declarationStatus": "present",
+    "validationStatus": "fail"
+  },
+  "coreVersions": {
+    "before": "0.2.2",
+    "after": "0.2.3"
+  },
+  "adapterIds": [
+    "fixture-upgrade-adapter"
+  ],
+  "adapterVersions": {
+    "before": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "version": "1.0.0"
+      }
+    ],
+    "after": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "version": "1.0.0"
+      }
+    ]
+  },
+  "adapterSchemaVersions": {
+    "before": "1.0.0",
+    "after": "1.0.0"
+  },
+  "supportedSkillIds": {
+    "before": [
+      "repo-map"
+    ],
+    "after": [
+      "repo-map"
+    ]
+  },
+  "skillCompatibility": {
+    "before": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "skillId": "repo-map",
+        "versions": [
+          "0.2.2"
+        ],
+        "mode": "audit-only"
+      }
+    ],
+    "after": []
+  },
+  "pinStatus": {
+    "before": "0.2.2",
+    "after": "0.2.3",
+    "result": "accepted",
+    "staleClassification": "none"
+  },
+  "compatibilityResult": {
+    "result": "fail",
+    "codes": [
+      "adapter-set-drift",
+      "after-project-invalid",
+      "restriction-weakening"
+    ]
+  },
+  "restrictionInheritanceResult": {
+    "result": "fail",
+    "codes": [
+      "restriction-weakening"
+    ]
+  },
+  "approvalRequirements": [],
+  "detectedRisks": [
+    {
+      "code": "adapter-set-drift",
+      "summary": "The installed adapter set changed across revisions."
+    },
+    {
+      "code": "after-project-invalid",
+      "summary": "The proposed project revision did not validate."
+    },
+    {
+      "code": "restriction-weakening",
+      "summary": "Inherited restrictions were weakened."
+    }
+  ],
+  "blockingFailures": [
+    {
+      "code": "adapter-set-drift",
+      "summary": "The installed adapter set changed across revisions."
+    },
+    {
+      "code": "after-project-invalid",
+      "summary": "The proposed project revision did not validate."
+    },
+    {
+      "code": "restriction-weakening",
+      "summary": "Inherited restrictions were weakened."
+    }
+  ],
+  "warnings": [],
+  "safeSummary": "The read-only compatibility check rejected 3 condition(s).",
+  "finalStatus": "fail",
+  "confidence": {
+    "level": "high",
+    "reason": "Both sanitized revision summaries and compatibility results were available."
+  },
+  "changedState": {
+    "changed": false,
+    "summary": "No project, adapter, Git, runtime, service, database, or remote state was changed."
+  },
+  "recommendedNextAction": "Resolve every blocking failure and rerun the read-only validation."
+}

package/examples/upgrade-evidence/valid-upgrade.evidence.json

@@ -0,0 +1,105 @@
+{
+  "contractVersion": "1.0.0",
+  "validator": {
+    "name": "check-adapter-upgrade",
+    "version": "0.2.3"
+  },
+  "invocation": {
+    "id": "example-valid-upgrade-001",
+    "timestamp": "2026-06-14T12:00:00Z"
+  },
+  "beforeProject": {
+    "reference": "before",
+    "declarationStatus": "present",
+    "validationStatus": "pass"
+  },
+  "afterProject": {
+    "reference": "after",
+    "declarationStatus": "present",
+    "validationStatus": "pass"
+  },
+  "coreVersions": {
+    "before": "0.2.2",
+    "after": "0.2.3"
+  },
+  "adapterIds": [
+    "fixture-upgrade-adapter"
+  ],
+  "adapterVersions": {
+    "before": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "version": "1.0.0"
+      }
+    ],
+    "after": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "version": "1.0.0"
+      }
+    ]
+  },
+  "adapterSchemaVersions": {
+    "before": "1.0.0",
+    "after": "1.0.0"
+  },
+  "supportedSkillIds": {
+    "before": [
+      "repo-map"
+    ],
+    "after": [
+      "repo-map"
+    ]
+  },
+  "skillCompatibility": {
+    "before": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "skillId": "repo-map",
+        "versions": [
+          "0.2.2"
+        ],
+        "mode": "audit-only"
+      }
+    ],
+    "after": [
+      {
+        "adapterId": "fixture-upgrade-adapter",
+        "skillId": "repo-map",
+        "versions": [
+          "0.2.3"
+        ],
+        "mode": "audit-only"
+      }
+    ]
+  },
+  "pinStatus": {
+    "before": "0.2.2",
+    "after": "0.2.3",
+    "result": "accepted",
+    "staleClassification": "none"
+  },
+  "compatibilityResult": {
+    "result": "pass",
+    "codes": []
+  },
+  "restrictionInheritanceResult": {
+    "result": "pass",
+    "codes": []
+  },
+  "approvalRequirements": [],
+  "detectedRisks": [],
+  "blockingFailures": [],
+  "warnings": [],
+  "safeSummary": "The read-only compatibility check passed without applying changes.",
+  "finalStatus": "pass",
+  "confidence": {
+    "level": "high",
+    "reason": "Both sanitized revision summaries and compatibility results were available."
+  },
+  "changedState": {
+    "changed": false,
+    "summary": "No project, adapter, Git, runtime, service, database, or remote state was changed."
+  },
+  "recommendedNextAction": "Request human approval before adopting this upgrade in a real project."
+}

package/examples/upgrade-evidence/valid-upgrade.evidence.md

@@ -0,0 +1,13 @@
+# Valid Upgrade Evidence
+
+- Validator: `check-adapter-upgrade` `0.2.3`
+- Core transition: `0.2.2` to `0.2.3`
+- Pin status: accepted
+- Compatibility: pass
+- Restriction inheritance: pass
+- Final status: pass
+- Changed state: false
+
+Safe summary: the read-only compatibility check passed without applying changes.
+
+Recommended action: request human approval before adopting the upgrade in a real project.

package/examples/workflows/README.md

@@ -0,0 +1,3 @@
+# Workflow Examples
+
+Each workflow shows safe sequencing and the minimum evidence needed before completion.