coding-agent-skills 0.2.8 → 0.2.9

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 (54) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +4 -0
  3. package/ROADMAP.md +6 -3
  4. package/bin/coding-agent-skills +8 -1
  5. package/docs/adapters/README.md +17 -0
  6. package/docs/adapters/project-installation.md +14 -1
  7. package/docs/adapters/real-project-adoption.md +2 -2
  8. package/docs/architecture/README.md +4 -1
  9. package/docs/release/README.md +10 -8
  10. package/docs/release/npm-package.md +7 -4
  11. package/docs/safety/README.md +5 -1
  12. package/docs/testing/README.md +8 -0
  13. package/docs/usage/README.md +13 -5
  14. package/examples/command-policies/route-trace.json +72 -0
  15. package/examples/evidence-packs/route-trace.json +55 -0
  16. package/examples/manifests/route-trace.json +14 -0
  17. package/examples/workflows/route-trace.md +20 -0
  18. package/package.json +2 -1
  19. package/runs/skill-runs.md +27 -0
  20. package/schemas/project-adapter-installation.schema.json +5 -3
  21. package/schemas/project-adapter.schema.json +2 -0
  22. package/scripts/lib/pack-rules.mjs +11 -2
  23. package/scripts/lib/route-trace.mjs +785 -0
  24. package/scripts/render-route-trace.mjs +8 -0
  25. package/scripts/test-pack.mjs +89 -1
  26. package/scripts/validate-pack.mjs +5 -2
  27. package/skills/route-trace/SKILL.md +58 -0
  28. package/skills/route-trace/adapter-interface.md +20 -0
  29. package/skills/route-trace/agents/openai.yaml +4 -0
  30. package/skills/route-trace/checklist.md +11 -0
  31. package/skills/route-trace/evidence-template.md +18 -0
  32. package/skills/route-trace/examples.md +32 -0
  33. package/skills/route-trace/failure-modes.md +9 -0
  34. package/tests/fixtures/route-trace/adapter-project/.coding-agent/adapters/route-trace-fixture/adapter.json +59 -0
  35. package/tests/fixtures/route-trace/adapter-project/.coding-agent/skills.json +23 -0
  36. package/tests/fixtures/route-trace/adapter-project/README.md +3 -0
  37. package/tests/fixtures/route-trace/adapter-project/app/api/items/route.ts +3 -0
  38. package/tests/fixtures/route-trace/adapter-project/package.json +5 -0
  39. package/tests/fixtures/route-trace/adapter-project/pages/index.tsx +3 -0
  40. package/tests/fixtures/route-trace/adapter-project/src/routes.ts +3 -0
  41. package/tests/fixtures/route-trace/static-project/.env.example +1 -0
  42. package/tests/fixtures/route-trace/static-project/README.md +3 -0
  43. package/tests/fixtures/route-trace/static-project/app/api/users/route.ts +3 -0
  44. package/tests/fixtures/route-trace/static-project/app/blog/[slug]/page.tsx +3 -0
  45. package/tests/fixtures/route-trace/static-project/app/page.tsx +3 -0
  46. package/tests/fixtures/route-trace/static-project/package.json +5 -0
  47. package/tests/fixtures/route-trace/static-project/pages/about.tsx +3 -0
  48. package/tests/fixtures/route-trace/static-project/pages/api/hello.ts +3 -0
  49. package/tests/fixtures/route-trace/static-project/server/routes.ts +4 -0
  50. package/tests/fixtures/route-trace/static-project/src/route-config.ts +4 -0
  51. package/tests/fixtures/route-trace/static-project/src/router.tsx +10 -0
  52. package/tests/fixtures/triggers/cases.json +13 -1
  53. package/tests/trigger/README.md +1 -0
  54. package/work-ledger.md +19 -7
package/scripts/lib/pack-rules.mjs CHANGED
@@ -1,5 +1,6 @@
1
1
  export const PILOT_SKILLS = [
2
2
  "repo-map",
3
+ "route-trace",
3
4
  "build-verify",
4
5
  "git-preflight",
5
6
  "runtime-truth",
@@ -11,6 +12,7 @@ export const PREVIOUS_PILOT_VERSION = "0.2.2";
11
12
 
12
13
  export const AUDIT_ONLY_SKILLS = [
13
14
  "repo-map",
15
+ "route-trace",
14
16
  "git-preflight",
15
17
  "runtime-truth",
16
18
  "llm-drift-control",
@@ -362,6 +364,13 @@ export function classifyTrigger(prompt) {
362
364
  ) {
363
365
  return "build-verify";
364
366
  }
367
+ if (
368
+ /\b(?:route trace|trace.*routes?|route surface|routes?.*static|api route files?|next\.js routes?|react router|express routes?|fastify routes?|hono routes?)\b/.test(
369
+ text,
370
+ )
371
+ ) {
372
+ return "route-trace";
373
+ }
365
374
  if (
366
375
  /\b(?:unfamiliar repository|canonical repository root|canonical repo|map the current packages|map this repository|identify its entry points|nested directory)\b/.test(
367
376
  text,
@@ -503,7 +512,7 @@ function classifySegment(segment, options = {}) {
503
512
  }
504
513
  if (
505
514
  executable === "node" &&
506
- !/^node\s+(?:--check\b|--test\b|scripts\/(?:validate-pack|validate-maintainer-loop|validate-adapters|validate-project-adapters|check-adapter-upgrade|check-adapter-upgrade-chain|verify-evidence-bundle|render-evidence-archive-report|render-adapter-repo-map|test-pack)\.mjs\b)/.test(
515
+ !/^node\s+(?:--check\b|--test\b|scripts\/(?:validate-pack|validate-maintainer-loop|validate-adapters|validate-project-adapters|check-adapter-upgrade|check-adapter-upgrade-chain|verify-evidence-bundle|render-evidence-archive-report|render-adapter-repo-map|render-route-trace|test-pack)\.mjs\b)/.test(
507
516
  segment,
508
517
  )
509
518
  ) {
@@ -513,7 +522,7 @@ function classifySegment(segment, options = {}) {
513
522
  ["coding-agent-skills", "bin/coding-agent-skills", "./bin/coding-agent-skills"].includes(
514
523
  executable,
515
524
  ) &&
516
- !/^(?:\.\/)?(?:bin\/)?coding-agent-skills\s+(?:validate-pack|validate-project\s+\S+|repo-map\s+\S+|validate-adapters\s+\S+|help|--help|-h)\s*$/.test(
525
+ !/^(?:\.\/)?(?:bin\/)?coding-agent-skills\s+(?:validate-pack|validate-project\s+\S+|repo-map\s+\S+|route-trace\s+\S+|validate-adapters\s+\S+|help|--help|-h)\s*$/.test(
517
526
  segment,
518
527
  )
519
528
  ) {