coding-agent-skills 0.2.14 → 0.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.md +31 -1
  3. package/ROADMAP.md +7 -2
  4. package/bin/coding-agent-skills +340 -2
  5. package/docs/adapters/README.md +21 -0
  6. package/docs/adapters/project-installation.md +14 -0
  7. package/docs/adapters/real-project-adoption.md +2 -2
  8. package/docs/architecture/README.md +3 -2
  9. package/docs/release/README.md +13 -10
  10. package/docs/release/npm-package.md +27 -2
  11. package/docs/safety/README.md +6 -1
  12. package/docs/testing/README.md +16 -0
  13. package/docs/usage/README.md +59 -5
  14. package/examples/command-policies/deployment-preflight.json +70 -0
  15. package/examples/evidence-packs/deployment-preflight.json +60 -0
  16. package/examples/manifests/deployment-preflight.json +14 -0
  17. package/examples/workflows/deployment-preflight.md +8 -0
  18. package/package.json +2 -1
  19. package/runs/skill-runs.md +36 -0
  20. package/schemas/project-adapter-installation.schema.json +2 -0
  21. package/schemas/project-adapter.schema.json +2 -0
  22. package/scripts/lib/deployment-preflight.mjs +655 -0
  23. package/scripts/lib/pack-rules.mjs +11 -2
  24. package/scripts/render-deployment-preflight.mjs +9 -0
  25. package/scripts/test-pack.mjs +151 -1
  26. package/scripts/validate-pack.mjs +5 -2
  27. package/skills/deployment-preflight/SKILL.md +89 -0
  28. package/skills/deployment-preflight/adapter-interface.md +17 -0
  29. package/skills/deployment-preflight/agents/openai.yaml +3 -0
  30. package/skills/deployment-preflight/checklist.md +7 -0
  31. package/skills/deployment-preflight/evidence-template.md +19 -0
  32. package/skills/deployment-preflight/examples.md +11 -0
  33. package/skills/deployment-preflight/failure-modes.md +11 -0
  34. package/tests/fixtures/deployment-preflight/adapter-project/.coding-agent/adapters/deployment-preflight-fixture/adapter.json +56 -0
  35. package/tests/fixtures/deployment-preflight/adapter-project/.coding-agent/skills.json +23 -0
  36. package/tests/fixtures/deployment-preflight/adapter-project/README.md +3 -0
  37. package/tests/fixtures/deployment-preflight/adapter-project/deploy/netlify.toml +3 -0
  38. package/tests/fixtures/deployment-preflight/adapter-project/ignored/render.yaml +3 -0
  39. package/tests/fixtures/deployment-preflight/adapter-project/package.json +5 -0
  40. package/tests/fixtures/deployment-preflight/static-project/Dockerfile +2 -0
  41. package/tests/fixtures/deployment-preflight/static-project/README.md +3 -0
  42. package/tests/fixtures/deployment-preflight/static-project/docs/deployment.md +4 -0
  43. package/tests/fixtures/deployment-preflight/static-project/package.json +6 -0
  44. package/tests/fixtures/deployment-preflight/static-project/src/index.js +1 -0
  45. package/tests/fixtures/deployment-preflight/static-project/wrangler.toml +3 -0
  46. package/tests/fixtures/triggers/cases.json +13 -1
  47. package/tests/trigger/README.md +2 -0
  48. package/work-ledger.md +33 -8
package/work-ledger.md CHANGED
@@ -4,14 +4,16 @@
4
4
 
5
5
  - Repository: `coding-agent-skills`
6
6
  - Branch: `main`
7
- - Pilot skills: `repo-map`, `route-trace`, `env-audit`, `secret-audit`, `api-contract-audit`, `migration-review`, `github-handoff`, `build-verify`, `git-preflight`, `runtime-truth`, `llm-drift-control`
7
+ - 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`
8
8
  - 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.
9
9
  - Real-project adapter adoption readiness is documented as a planning-only approval gate.
10
10
  - First external project-owned adapter adoption completed for `/home/oneclickwebsitedesignfactory/tax-lien-platform` at candidate commit `c548b1a6cbb3455a70b89d0e301e22435bfccac9`.
11
11
  - 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.
12
12
  - The shared repository does not contain real adapter manifests; real project adapters remain owned by their project repositories.
13
- - Public npm package release `v0.2.14` exposes the dependency-free
13
+ - Public npm package release `v0.2.16` exposes the dependency-free
14
14
  `coding-agent-skills` CLI under MIT license.
15
+ - `v0.2.16` adds optional OpenClaw-compatible `--json` output and documented
16
+ exit-code semantics for every public CLI command.
15
17
  - `route-trace` is implemented as an audit-only static route tracing skill.
16
18
  - `env-audit` is implemented as an audit-only value-free environment variable name mapping
17
19
  skill.
@@ -21,19 +23,21 @@
21
23
  - `migration-review` is implemented as an audit-only static migration and schema evidence
22
24
  review skill.
23
25
  - `github-handoff` is implemented as an audit-only local Git handoff evidence skill.
26
+ - `deployment-preflight` is implemented as an audit-only static deployment readiness
27
+ evidence skill.
24
28
  - Builder-mode approval: complete the remaining read-only skill wave for
25
29
  `coding-agent-skills` itself. Real-world project execution constraints remain unchanged.
26
30
 
27
31
  ## Last Completed Version
28
32
 
29
- `v0.2.14`
33
+ `v0.2.16`
30
34
 
31
35
  ## Current Recommended Milestone
32
36
 
33
- The `github-handoff` public npm release is in progress under builder-mode approval.
34
- Continue the remaining read-only skill wave one release at a time unless a real safety,
35
- validation, publication, or authentication boundary appears. The next approved wave item is
36
- `deployment-preflight-skill`.
37
+ The OpenClaw-compatible JSON output contract is the current release milestone. After
38
+ `v0.2.16` is published and verified, continue the remaining read-only skill wave one
39
+ release at a time unless a real safety, validation, publication, or authentication
40
+ boundary appears. The next approved wave item remains `cloudflare-preflight-skill`.
37
41
 
38
42
  ## Allowed Next Actions
39
43
 
@@ -110,10 +114,31 @@ No autonomous maintainer-loop run has been recorded yet.
110
114
  - Latest tag observed: `v0.2.13`
111
115
  - Implemented milestone: `github-handoff` audit-only local Git handoff evidence skill and CLI command.
112
116
  - Required permission: `builder-mode-skill-implementation`
113
- - Validation result: pass pending final publication evidence
117
+ - Validation result: passed; `v0.2.14` commit, tag, npm publication, registry smoke, npm exec, and GitHub Release completed
114
118
  - Next recommended milestone: continue builder-mode wave with `deployment-preflight-skill`
115
119
  after `v0.2.14` publication completes.
116
120
 
121
+ ### 2026-07-03T14:00:00Z
122
+
123
+ - Latest tag observed: `v0.2.14`
124
+ - Implemented milestone: `deployment-preflight` audit-only static deployment readiness
125
+ evidence skill and CLI command.
126
+ - Required permission: `builder-mode-skill-implementation`
127
+ - Validation result: passed; `v0.2.15` commit, tag, npm publication, registry smoke,
128
+ npm exec, and GitHub Release completed
129
+ - Next recommended milestone: implement the OpenClaw-compatible JSON output and exit-code
130
+ contract before continuing to `cloudflare-preflight-skill`.
131
+
132
+ ### 2026-07-03T15:00:00Z
133
+
134
+ - Latest tag observed: `v0.2.15`
135
+ - Implemented milestone: OpenClaw-compatible optional `--json` output and documented
136
+ exit-code semantics for every public CLI command.
137
+ - Required permission: `orchestrator-output-contract`
138
+ - Validation result: pass pending final release validation matrix
139
+ - Next recommended milestone: continue builder-mode wave with `cloudflare-preflight-skill`
140
+ after `v0.2.16` publication completes.
141
+
117
142
  ### 2026-07-03T12:00:00Z
118
143
 
119
144
  - Latest tag observed: `v0.2.12`