coding-agent-skills 0.2.13 → 0.2.15

package/tests/fixtures/deployment-preflight/adapter-project/deploy/netlify.toml

@@ -0,0 +1,3 @@
+[build]
+publish = "dist"
+command = "npm run build"

package/tests/fixtures/deployment-preflight/adapter-project/ignored/render.yaml

@@ -0,0 +1,3 @@
+services:
+  - type: web
+    name: ignored-service

package/tests/fixtures/deployment-preflight/adapter-project/package.json

@@ -0,0 +1,5 @@
+{
+  "scripts": {
+    "deploy": "netlify deploy"
+  }
+}

package/tests/fixtures/deployment-preflight/static-project/Dockerfile

@@ -0,0 +1,2 @@
+FROM node:20-alpine
+CMD ["node", "src/index.js"]

package/tests/fixtures/deployment-preflight/static-project/README.md

@@ -0,0 +1,3 @@
+# Deployment Preflight Static Fixture
+
+Synthetic project used to verify static deployment readiness mapping.

package/tests/fixtures/deployment-preflight/static-project/docs/deployment.md

@@ -0,0 +1,4 @@
+# Deployment Notes
+
+Deployments use synthetic Cloudflare-style configuration. Production values are not stored
+in this fixture.

package/tests/fixtures/deployment-preflight/static-project/package.json

@@ -0,0 +1,6 @@
+{
+  "scripts": {
+    "deploy": "wrangler deploy",
+    "preview": "wrangler pages dev"
+  }
+}

package/tests/fixtures/deployment-preflight/static-project/src/index.js

@@ -0,0 +1 @@
+export const handler = () => "ok";

package/tests/fixtures/deployment-preflight/static-project/wrangler.toml

@@ -0,0 +1,3 @@
+name = "synthetic-worker"
+compatibility_date = "2026-07-03"
+main = "src/index.js"

package/tests/fixtures/github-handoff/adapter-project/.coding-agent/adapters/github-handoff-fixture/adapter.json

@@ -0,0 +1,56 @@
+{
+  "adapterId": "github-handoff-fixture",
+  "adapterVersion": "1.0.0",
+  "project": {
+    "id": "fixture-github-handoff",
+    "detection": {
+      "rootMarkers": [
+        {"kind": "file", "path": "package.json"},
+        {"kind": "file", "path": "README.md"}
+      ],
+      "maximumDepth": 1,
+      "scope": "declared-project-root",
+      "requireApprovalOutsideScope": true
+    }
+  },
+  "supportedSkills": [
+    {
+      "id": "github-handoff",
+      "compatibleVersions": ["0.2.3", "0.2.x"],
+      "declaredMode": "audit-only"
+    }
+  ],
+  "extensions": {
+    "safeReadPaths": ["README.md", "package.json", "src"],
+    "ignoredPaths": ["node_modules", "dist", "build", "tmp"],
+    "documentationPrecedence": ["README.md"],
+    "commandAliases": [],
+    "safeStatusCommands": [],
+    "requiredEvidence": ["branch state", "HEAD", "working-tree state", "changed-file summary", "handoff summary"],
+    "expectedRuntimeManagers": [],
+    "expectedPackageManagers": ["npm"]
+  },
+  "approvalRequirements": [],
+  "inheritance": {
+    "sharedRestrictions": "required",
+    "deniedOperationCategories": [
+      "file-write",
+      "package-install",
+      "deployment",
+      "git-mutation",
+      "unrestricted-scan",
+      "secret-read",
+      "process-mutation",
+      "service-mutation",
+      "migration-apply",
+      "privileged-api"
+    ],
+    "allowRestrictionRemoval": false,
+    "allowModeOverride": false,
+    "allowFailureSuppression": false,
+    "allowCompletionOverride": false,
+    "allowSecretExposure": false,
+    "allowRequiredEvidenceRemoval": false,
+    "allowScopeExpansionWithoutApproval": false
+  }
+}

package/tests/fixtures/github-handoff/adapter-project/.coding-agent/skills.json

@@ -0,0 +1,23 @@
+{
+  "declarationVersion": "1.0.0",
+  "projectId": "fixture-github-handoff",
+  "adapterRoot": ".coding-agent/adapters",
+  "adapterSchemaVersion": "1.0.0",
+  "core": {
+    "id": "coding-agent-skills",
+    "expectedVersion": "0.2.3",
+    "versionPin": ">=0.2.3 <0.3.0"
+  },
+  "compatibleSkillIds": ["github-handoff"],
+  "adapters": [
+    {
+      "id": "github-handoff-fixture",
+      "version": "1.0.0",
+      "skillIds": ["github-handoff"]
+    }
+  ],
+  "validationCommand": "node <shared-core>/scripts/validate-project-adapters.mjs <project-root>",
+  "evidenceOutput": ".coding-agent/evidence",
+  "approvalPolicyReference": ".coding-agent/approval-policy.md",
+  "noSecrets": true
+}

package/tests/fixtures/github-handoff/adapter-project/README.md

@@ -0,0 +1,3 @@
+# GitHub Handoff Adapter Fixture
+
+Synthetic adapter-enabled project used to test handoff metadata.

package/tests/fixtures/github-handoff/adapter-project/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "github-handoff-adapter-fixture",
+  "private": true
+}

package/tests/fixtures/github-handoff/adapter-project/src/index.js

@@ -0,0 +1 @@
+export const adapterFixture = "github-handoff";

package/tests/fixtures/github-handoff/static-project/README.md

@@ -0,0 +1,3 @@
+# GitHub Handoff Static Fixture
+
+Synthetic project used to test local Git handoff summaries.

package/tests/fixtures/github-handoff/static-project/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "github-handoff-static-fixture",
+  "private": true
+}

package/tests/fixtures/github-handoff/static-project/src/index.js

@@ -0,0 +1 @@
+export const fixture = "github-handoff";

package/tests/fixtures/triggers/cases.json

@@ -79,6 +79,30 @@
       "expectedSkill": "migration-review",
       "notSkills": ["deployment-preflight", "runtime-truth"]
     },
+    {
+      "id": "github-handoff-report",
+      "prompt": "Prepare a GitHub handoff report from local branch state and changed files without pushing.",
+      "expectedSkill": "github-handoff",
+      "notSkills": ["git-preflight", "build-verify"]
+    },
+    {
+      "id": "github-handoff-pr-evidence",
+      "prompt": "Summarize handoff evidence for a future PR without creating the pull request.",
+      "expectedSkill": "github-handoff",
+      "notSkills": ["runtime-truth", "deployment-preflight"]
+    },
+    {
+      "id": "deployment-preflight-static",
+      "prompt": "Run a deployment preflight and map static deployment config, docs, and package script keys without deploying.",
+      "expectedSkill": "deployment-preflight",
+      "notSkills": ["runtime-truth", "build-verify"]
+    },
+    {
+      "id": "deployment-preflight-readiness",
+      "prompt": "Map deployment readiness evidence before release, but do not call provider APIs or run builds.",
+      "expectedSkill": "deployment-preflight",
+      "notSkills": ["github-handoff", "migration-review"]
+    },
     {
       "id": "build-after-implementation",
       "prompt": "The implementation is finished. Run the existing typecheck, tests, and build.",
@@ -131,7 +155,7 @@
       "id": "negative-deploy",
       "prompt": "Deploy this application to production.",
       "expectedSkill": null,
-      "notSkills": ["repo-map", "route-trace", "env-audit", "secret-audit", "api-contract-audit", "migration-review", "build-verify", "git-preflight", "runtime-truth", "llm-drift-control"]
+      "notSkills": ["repo-map", "route-trace", "env-audit", "secret-audit", "api-contract-audit", "migration-review", "github-handoff", "deployment-preflight", "build-verify", "git-preflight", "runtime-truth", "llm-drift-control"]
     },
     {
       "id": "negative-install",
@@ -143,7 +167,7 @@
       "id": "negative-publish",
       "prompt": "Commit these files and publish the branch.",
       "expectedSkill": null,
-      "notSkills": ["git-preflight"]
+      "notSkills": ["git-preflight", "github-handoff"]
     },
     {
       "id": "negative-restart",

package/tests/trigger/README.md

@@ -12,6 +12,10 @@
   build verification.
 - Static migration/schema review must trigger `migration-review`, not runtime truth,
   deployment, or migration execution.
+- Local GitHub handoff evidence must trigger `github-handoff`, not publication,
+  pull request creation, or Git mutation.
+- Static deployment readiness mapping must trigger `deployment-preflight`, not deployment,
+  provider API calls, or runtime mutation.
 - Local validation must trigger `build-verify` only when project-native checks are requested.
 - Git readiness must trigger `git-preflight`, not publication.
 - Process/listener/health questions must trigger `runtime-truth`, not restart behavior.

package/work-ledger.md

@@ -4,13 +4,13 @@
 
 - Repository: `coding-agent-skills`
 - Branch: `main`
-- Pilot skills: `repo-map`, `route-trace`, `env-audit`, `secret-audit`, `api-contract-audit`, `migration-review`, `build-verify`, `git-preflight`, `runtime-truth`, `llm-drift-control`
+- Pilot skills: `repo-map`, `route-trace`, `env-audit`, `secret-audit`, `api-contract-audit`, `migration-review`, `github-handoff`, `deployment-preflight`, `build-verify`, `git-preflight`, `runtime-truth`, `llm-drift-control`
 - Adapter discovery, project adapter installation, stale-pin detection, upgrade evidence, compatibility-chain validation, evidence-bundle verification, retention policy, provenance design, archive-report rendering, archive-index fixtures, retention-expiry advisory reporting, and detached-signature verification planning are implemented.
 - Real-project adapter adoption readiness is documented as a planning-only approval gate.
 - First external project-owned adapter adoption completed for `/home/oneclickwebsitedesignfactory/tax-lien-platform` at candidate commit `c548b1a6cbb3455a70b89d0e301e22435bfccac9`.
 - The adopted adapter is `repo-map` only, docs/metadata-only, and contains no commands, runtime checks, build/test/package behavior, platform/deployment behavior, or secret-aware behavior.
 - The shared repository does not contain real adapter manifests; real project adapters remain owned by their project repositories.
-- Public npm package release `v0.2.13` exposes the dependency-free
+- Public npm package release `v0.2.15` exposes the dependency-free
   `coding-agent-skills` CLI under MIT license.
 - `route-trace` is implemented as an audit-only static route tracing skill.
 - `env-audit` is implemented as an audit-only value-free environment variable name mapping
@@ -20,19 +20,22 @@
   skill.
 - `migration-review` is implemented as an audit-only static migration and schema evidence
   review skill.
+- `github-handoff` is implemented as an audit-only local Git handoff evidence skill.
+- `deployment-preflight` is implemented as an audit-only static deployment readiness
+  evidence skill.
 - Builder-mode approval: complete the remaining read-only skill wave for
   `coding-agent-skills` itself. Real-world project execution constraints remain unchanged.
 
 ## Last Completed Version
 
-`v0.2.13`
+`v0.2.15`
 
 ## Current Recommended Milestone
 
-The `migration-review` public npm release is in progress under builder-mode approval.
+The `deployment-preflight` public npm release is in progress under builder-mode approval.
 Continue the remaining read-only skill wave one release at a time unless a real safety,
 validation, publication, or authentication boundary appears. The next approved wave item is
-`github-handoff-skill`.
+`cloudflare-preflight-skill`.
 
 ## Allowed Next Actions
 
@@ -104,12 +107,31 @@ No next runner command is currently queued.
 
 No autonomous maintainer-loop run has been recorded yet.
 
+### 2026-07-03T13:00:00Z
+
+- Latest tag observed: `v0.2.13`
+- Implemented milestone: `github-handoff` audit-only local Git handoff evidence skill and CLI command.
+- Required permission: `builder-mode-skill-implementation`
+- Validation result: passed; `v0.2.14` commit, tag, npm publication, registry smoke, npm exec, and GitHub Release completed
+- Next recommended milestone: continue builder-mode wave with `deployment-preflight-skill`
+  after `v0.2.14` publication completes.
+
+### 2026-07-03T14:00:00Z
+
+- Latest tag observed: `v0.2.14`
+- Implemented milestone: `deployment-preflight` audit-only static deployment readiness
+  evidence skill and CLI command.
+- Required permission: `builder-mode-skill-implementation`
+- Validation result: pass pending final publication evidence
+- Next recommended milestone: continue builder-mode wave with `cloudflare-preflight-skill`
+  after `v0.2.15` publication completes.
+
 ### 2026-07-03T12:00:00Z
 
 - Latest tag observed: `v0.2.12`
 - Implemented milestone: `migration-review` audit-only static migration and schema evidence review skill and CLI command.
 - Required permission: `builder-mode-skill-implementation`
-- Validation result: pass pending final publication evidence
+- Validation result: passed; `v0.2.13` commit, tag, npm publication, registry smoke, npm exec, and GitHub Release completed
 - Next recommended milestone: continue builder-mode wave with `github-handoff-skill`
   after `v0.2.13` publication completes.