@llipe.com/dev-tasks 0.10.0 → 0.16.1

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 (620) hide show
  1. package/.claude/agents/developer.md +108 -35
  2. package/.claude/agents/github-ops.md +48 -4
  3. package/.claude/agents/housekeeping.md +44 -7
  4. package/.claude/agents/qa-engineer.md +45 -3
  5. package/.claude/agents/researcher.md +116 -0
  6. package/.claude/agents/technical-writer.md +61 -6
  7. package/.claude/agents/ux-engineer.md +1 -0
  8. package/.claude/agents/verifier.md +48 -6
  9. package/.claude/commands/developer.md +2 -266
  10. package/.claude/commands/infra-engineer.md +92 -0
  11. package/.claude/commands/planner.md +64 -28
  12. package/.claude/commands/product-engineer.md +58 -19
  13. package/.claude/commands/researcher.md +27 -0
  14. package/.claude/commands/technical-writer.md +1 -1
  15. package/.claude/hooks/branch-guard.sh +30 -0
  16. package/.claude/hooks/git-guard.sh +483 -22
  17. package/.claude/skills/activity-codebase-research/SKILL.md +151 -0
  18. package/.claude/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  19. package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
  20. package/.claude/skills/activity-grill/SKILL.md +150 -0
  21. package/.claude/skills/activity-init/SKILL.md +121 -71
  22. package/.claude/skills/activity-integration-test-implementation/SKILL.md +156 -0
  23. package/.claude/skills/activity-refine/SKILL.md +75 -15
  24. package/.claude/skills/activity-test-standards/SKILL.md +66 -0
  25. package/.claude/skills/aws-ops/SKILL.md +155 -0
  26. package/.claude/skills/deploy-ops/SKILL.md +121 -0
  27. package/.claude/skills/fly-ops/SKILL.md +138 -0
  28. package/.claude/skills/git-ops/SKILL.md +27 -7
  29. package/.claude/skills/implement/SKILL.md +49 -4
  30. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  31. package/.claude/skills/memo-cli-usage/SKILL.md +66 -13
  32. package/.claude/skills/plan/SKILL.md +43 -1
  33. package/.claude/skills/supabase-ops/SKILL.md +109 -0
  34. package/.github/agents/developer.agent.md +80 -18
  35. package/.github/agents/github-ops.agent.md +46 -4
  36. package/.github/agents/housekeeping.agent.md +43 -7
  37. package/.github/agents/infra-engineer.agent.md +139 -0
  38. package/.github/agents/planner.agent.md +45 -9
  39. package/.github/agents/product-engineer.agent.md +58 -19
  40. package/.github/agents/qa-engineer.agent.md +43 -4
  41. package/.github/agents/researcher.agent.md +115 -0
  42. package/.github/agents/technical-writer.agent.md +60 -6
  43. package/.github/agents/verifier.agent.md +46 -5
  44. package/.github/instructions/implement.instructions.md +49 -4
  45. package/.github/instructions/plan.instructions.md +43 -1
  46. package/.github/prompts/infra-engineer.prompt.md +12 -0
  47. package/.github/prompts/product-engineer-init.prompt.md +5 -6
  48. package/.github/prompts/researcher.prompt.md +28 -0
  49. package/.github/prompts/technical-writer.prompt.md +1 -1
  50. package/.github/skills/activity-codebase-research/SKILL.md +146 -0
  51. package/.github/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  52. package/.github/skills/activity-generate-spec/SKILL.md +34 -10
  53. package/.github/skills/activity-grill/SKILL.md +145 -0
  54. package/.github/skills/activity-init/SKILL.md +120 -70
  55. package/.github/skills/activity-integration-test-implementation/SKILL.md +156 -0
  56. package/.github/skills/activity-refine/SKILL.md +75 -15
  57. package/.github/skills/activity-test-standards/SKILL.md +66 -0
  58. package/.github/skills/aws-ops/SKILL.md +150 -0
  59. package/.github/skills/deploy-ops/SKILL.md +116 -0
  60. package/.github/skills/fly-ops/SKILL.md +133 -0
  61. package/.github/skills/git-ops/SKILL.md +27 -7
  62. package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
  63. package/.github/skills/memo-cli-usage/SKILL.md +66 -13
  64. package/.github/skills/supabase-ops/SKILL.md +104 -0
  65. package/.kiro/agents/developer.md +81 -19
  66. package/.kiro/agents/github-ops.md +46 -4
  67. package/.kiro/agents/housekeeping.md +44 -8
  68. package/.kiro/agents/infra-engineer.md +102 -0
  69. package/.kiro/agents/planner.md +53 -20
  70. package/.kiro/agents/product-engineer.md +61 -22
  71. package/.kiro/agents/qa-engineer.md +44 -5
  72. package/.kiro/agents/researcher.md +118 -0
  73. package/.kiro/agents/technical-writer.md +63 -9
  74. package/.kiro/agents/verifier.md +48 -7
  75. package/.kiro/skills/activity-codebase-research/SKILL.md +151 -0
  76. package/.kiro/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  77. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  78. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  79. package/.kiro/skills/activity-init/SKILL.md +121 -71
  80. package/.kiro/skills/activity-integration-test-implementation/SKILL.md +156 -0
  81. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  82. package/.kiro/skills/activity-test-standards/SKILL.md +66 -0
  83. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  84. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  85. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  86. package/.kiro/skills/git-ops/SKILL.md +27 -7
  87. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  88. package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
  89. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  90. package/.kiro/steering/implement.md +49 -4
  91. package/.kiro/steering/plan.md +43 -1
  92. package/AGENTS.md +88 -261
  93. package/AGENTS.md.template +124 -0
  94. package/CHANGELOG.md +196 -0
  95. package/CLAUDE.md +24 -18
  96. package/CLAUDE.md.template +103 -0
  97. package/README.md +168 -145
  98. package/TESTING.md +84 -140
  99. package/bundle-manifest.json +43 -2
  100. package/dist/bin/dev-tasks.js +65 -3
  101. package/dist/bin/dev-tasks.js.map +1 -1
  102. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  103. package/dist/bin/parse-args.d.ts.map +1 -0
  104. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  105. package/dist/bin/parse-args.js.map +1 -0
  106. package/dist/core/checks/decision-log-format.d.ts +44 -0
  107. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  108. package/dist/core/checks/decision-log-format.js +171 -0
  109. package/dist/core/checks/decision-log-format.js.map +1 -0
  110. package/dist/core/checks/docs-structure.d.ts +82 -0
  111. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  112. package/dist/core/checks/docs-structure.js +285 -0
  113. package/dist/core/checks/docs-structure.js.map +1 -0
  114. package/dist/core/checks/glossary.d.ts +178 -0
  115. package/dist/core/checks/glossary.d.ts.map +1 -0
  116. package/dist/core/checks/glossary.js +651 -0
  117. package/dist/core/checks/glossary.js.map +1 -0
  118. package/dist/core/checks/index.d.ts +19 -0
  119. package/dist/core/checks/index.d.ts.map +1 -0
  120. package/dist/core/checks/index.js +16 -0
  121. package/dist/core/checks/index.js.map +1 -0
  122. package/dist/core/checks/run.d.ts +22 -0
  123. package/dist/core/checks/run.d.ts.map +1 -0
  124. package/dist/core/checks/run.js +51 -0
  125. package/dist/core/checks/run.js.map +1 -0
  126. package/dist/core/distribution/doctor.d.ts +46 -1
  127. package/dist/core/distribution/doctor.d.ts.map +1 -1
  128. package/dist/core/distribution/doctor.js +161 -2
  129. package/dist/core/distribution/doctor.js.map +1 -1
  130. package/dist/core/distribution/index.d.ts +9 -3
  131. package/dist/core/distribution/index.d.ts.map +1 -1
  132. package/dist/core/distribution/index.js +5 -2
  133. package/dist/core/distribution/index.js.map +1 -1
  134. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  135. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  136. package/dist/core/distribution/install-if-absent.js +81 -0
  137. package/dist/core/distribution/install-if-absent.js.map +1 -0
  138. package/dist/core/distribution/install.d.ts.map +1 -1
  139. package/dist/core/distribution/install.js +5 -0
  140. package/dist/core/distribution/install.js.map +1 -1
  141. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  142. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  143. package/dist/core/distribution/migrate-docs.js +139 -0
  144. package/dist/core/distribution/migrate-docs.js.map +1 -0
  145. package/dist/core/distribution/profiles.d.ts +49 -0
  146. package/dist/core/distribution/profiles.d.ts.map +1 -1
  147. package/dist/core/distribution/profiles.js +45 -0
  148. package/dist/core/distribution/profiles.js.map +1 -1
  149. package/dist/core/distribution/update.d.ts +14 -0
  150. package/dist/core/distribution/update.d.ts.map +1 -1
  151. package/dist/core/distribution/update.js +77 -3
  152. package/dist/core/distribution/update.js.map +1 -1
  153. package/dist/core/distribution/workspace.d.ts +84 -0
  154. package/dist/core/distribution/workspace.d.ts.map +1 -0
  155. package/dist/core/distribution/workspace.js +276 -0
  156. package/dist/core/distribution/workspace.js.map +1 -0
  157. package/dist/core/exit-codes.d.ts +15 -35
  158. package/dist/core/exit-codes.d.ts.map +1 -1
  159. package/dist/core/exit-codes.js +15 -36
  160. package/dist/core/exit-codes.js.map +1 -1
  161. package/dist/core/index.d.ts +1 -6
  162. package/dist/core/index.d.ts.map +1 -1
  163. package/dist/core/index.js +1 -7
  164. package/dist/core/index.js.map +1 -1
  165. package/package.json +17 -32
  166. package/templates/claude/settings.json +48 -0
  167. package/templates/domain/ubiquitous-language.md +28 -0
  168. package/templates/infra/environments.yaml +16 -0
  169. package/templates/infra/redaction-patterns.txt +47 -0
  170. package/templates/runbooks/README.md +14 -0
  171. package/templates/runbooks/runbook-template.md +40 -0
  172. package/templates/scripts/deploy-status.sh +89 -0
  173. package/templates/scripts/deploy-verify.sh +85 -0
  174. package/templates/scripts/deploy.sh +284 -0
  175. package/templates/scripts/release.sh +170 -0
  176. package/templates/scripts/rollback.sh +109 -0
  177. package/templates/workflows/deploy-dev.yml +66 -0
  178. package/templates/workflows/deploy-prod.yml +66 -0
  179. package/templates/workflows/rollback.yml +77 -0
  180. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  181. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  182. package/dist/adapters/cli/catalog-build.js +0 -73
  183. package/dist/adapters/cli/catalog-build.js.map +0 -1
  184. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  185. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  186. package/dist/adapters/cli/catalog-query.js +0 -329
  187. package/dist/adapters/cli/catalog-query.js.map +0 -1
  188. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  189. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  190. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  191. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  192. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  193. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  194. package/dist/adapters/cli/catalog-validate.js +0 -122
  195. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  196. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  197. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  198. package/dist/adapters/cli/ctx-assemble.js +0 -293
  199. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  200. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  201. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  202. package/dist/adapters/cli/ctx-fetch.js +0 -267
  203. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  204. package/dist/adapters/cli/extract-all.d.ts +0 -31
  205. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  206. package/dist/adapters/cli/extract-all.js +0 -374
  207. package/dist/adapters/cli/extract-all.js.map +0 -1
  208. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  209. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  210. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  211. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  212. package/dist/adapters/cli/extract-component.d.ts +0 -24
  213. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  214. package/dist/adapters/cli/extract-component.js +0 -198
  215. package/dist/adapters/cli/extract-component.js.map +0 -1
  216. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  217. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  218. package/dist/adapters/cli/extract-detect.js +0 -98
  219. package/dist/adapters/cli/extract-detect.js.map +0 -1
  220. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  221. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  222. package/dist/adapters/cli/extract-openapi.js +0 -111
  223. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  224. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  225. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  226. package/dist/adapters/cli/extract-schema.js +0 -39
  227. package/dist/adapters/cli/extract-schema.js.map +0 -1
  228. package/dist/adapters/cli/index.d.ts +0 -6
  229. package/dist/adapters/cli/index.d.ts.map +0 -1
  230. package/dist/adapters/cli/index.js +0 -5
  231. package/dist/adapters/cli/index.js.map +0 -1
  232. package/dist/adapters/cli/init.d.ts +0 -37
  233. package/dist/adapters/cli/init.d.ts.map +0 -1
  234. package/dist/adapters/cli/init.js +0 -336
  235. package/dist/adapters/cli/init.js.map +0 -1
  236. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  237. package/dist/adapters/cli/parse-args.js.map +0 -1
  238. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  239. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  240. package/dist/adapters/cli/scope-gate.js +0 -157
  241. package/dist/adapters/cli/scope-gate.js.map +0 -1
  242. package/dist/adapters/cli/scope.d.ts +0 -26
  243. package/dist/adapters/cli/scope.d.ts.map +0 -1
  244. package/dist/adapters/cli/scope.js +0 -172
  245. package/dist/adapters/cli/scope.js.map +0 -1
  246. package/dist/adapters/cli/validate-component.d.ts +0 -24
  247. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  248. package/dist/adapters/cli/validate-component.js +0 -62
  249. package/dist/adapters/cli/validate-component.js.map +0 -1
  250. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  251. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  252. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  253. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  254. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  255. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  256. package/dist/adapters/cli/verify-drift.js +0 -103
  257. package/dist/adapters/cli/verify-drift.js.map +0 -1
  258. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  259. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  260. package/dist/adapters/cli/verify-impact.js +0 -119
  261. package/dist/adapters/cli/verify-impact.js.map +0 -1
  262. package/dist/adapters/mcp/index.d.ts +0 -5
  263. package/dist/adapters/mcp/index.d.ts.map +0 -1
  264. package/dist/adapters/mcp/index.js +0 -2
  265. package/dist/adapters/mcp/index.js.map +0 -1
  266. package/dist/bin/dt.d.ts +0 -7
  267. package/dist/bin/dt.d.ts.map +0 -1
  268. package/dist/bin/dt.js +0 -647
  269. package/dist/bin/dt.js.map +0 -1
  270. package/dist/core/catalog/build.d.ts +0 -143
  271. package/dist/core/catalog/build.d.ts.map +0 -1
  272. package/dist/core/catalog/build.js +0 -475
  273. package/dist/core/catalog/build.js.map +0 -1
  274. package/dist/core/catalog/checks/index.d.ts +0 -18
  275. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  276. package/dist/core/catalog/checks/index.js +0 -18
  277. package/dist/core/catalog/checks/index.js.map +0 -1
  278. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  279. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  280. package/dist/core/catalog/checks/v01-schema.js +0 -57
  281. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  282. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  283. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  284. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  285. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  286. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  287. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  288. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  289. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  290. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  291. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  292. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  293. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  294. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  295. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  296. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  297. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  298. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  299. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  300. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  301. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  302. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  303. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  304. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  305. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  306. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  307. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  308. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  309. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  310. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  311. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  312. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  313. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  315. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  316. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  317. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  319. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  320. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  321. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  322. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  323. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  324. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  325. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  326. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  327. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  328. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  329. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  330. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  331. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  332. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  333. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  334. package/dist/core/catalog/coverage.d.ts +0 -39
  335. package/dist/core/catalog/coverage.d.ts.map +0 -1
  336. package/dist/core/catalog/coverage.js +0 -62
  337. package/dist/core/catalog/coverage.js.map +0 -1
  338. package/dist/core/catalog/graph.d.ts +0 -49
  339. package/dist/core/catalog/graph.d.ts.map +0 -1
  340. package/dist/core/catalog/graph.js +0 -114
  341. package/dist/core/catalog/graph.js.map +0 -1
  342. package/dist/core/catalog/index-model.d.ts +0 -96
  343. package/dist/core/catalog/index-model.d.ts.map +0 -1
  344. package/dist/core/catalog/index-model.js +0 -8
  345. package/dist/core/catalog/index-model.js.map +0 -1
  346. package/dist/core/catalog/index.d.ts +0 -5
  347. package/dist/core/catalog/index.d.ts.map +0 -1
  348. package/dist/core/catalog/index.js +0 -2
  349. package/dist/core/catalog/index.js.map +0 -1
  350. package/dist/core/catalog/queries.d.ts +0 -69
  351. package/dist/core/catalog/queries.d.ts.map +0 -1
  352. package/dist/core/catalog/queries.js +0 -165
  353. package/dist/core/catalog/queries.js.map +0 -1
  354. package/dist/core/catalog/resolve.d.ts +0 -47
  355. package/dist/core/catalog/resolve.d.ts.map +0 -1
  356. package/dist/core/catalog/resolve.js +0 -318
  357. package/dist/core/catalog/resolve.js.map +0 -1
  358. package/dist/core/catalog/scaffold.d.ts +0 -31
  359. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  360. package/dist/core/catalog/scaffold.js +0 -141
  361. package/dist/core/catalog/scaffold.js.map +0 -1
  362. package/dist/core/catalog/validate-component.d.ts +0 -50
  363. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  364. package/dist/core/catalog/validate-component.js +0 -105
  365. package/dist/core/catalog/validate-component.js.map +0 -1
  366. package/dist/core/catalog/validate.d.ts +0 -71
  367. package/dist/core/catalog/validate.d.ts.map +0 -1
  368. package/dist/core/catalog/validate.js +0 -103
  369. package/dist/core/catalog/validate.js.map +0 -1
  370. package/dist/core/context/assemble.d.ts +0 -126
  371. package/dist/core/context/assemble.d.ts.map +0 -1
  372. package/dist/core/context/assemble.js +0 -197
  373. package/dist/core/context/assemble.js.map +0 -1
  374. package/dist/core/context/cache.d.ts +0 -60
  375. package/dist/core/context/cache.d.ts.map +0 -1
  376. package/dist/core/context/cache.js +0 -236
  377. package/dist/core/context/cache.js.map +0 -1
  378. package/dist/core/context/exit-codes.d.ts +0 -28
  379. package/dist/core/context/exit-codes.d.ts.map +0 -1
  380. package/dist/core/context/exit-codes.js +0 -28
  381. package/dist/core/context/exit-codes.js.map +0 -1
  382. package/dist/core/context/fetch.d.ts +0 -55
  383. package/dist/core/context/fetch.d.ts.map +0 -1
  384. package/dist/core/context/fetch.js +0 -112
  385. package/dist/core/context/fetch.js.map +0 -1
  386. package/dist/core/context/index.d.ts +0 -11
  387. package/dist/core/context/index.d.ts.map +0 -1
  388. package/dist/core/context/index.js +0 -8
  389. package/dist/core/context/index.js.map +0 -1
  390. package/dist/core/context/init.d.ts +0 -179
  391. package/dist/core/context/init.d.ts.map +0 -1
  392. package/dist/core/context/init.js +0 -532
  393. package/dist/core/context/init.js.map +0 -1
  394. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  395. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  396. package/dist/core/context/layers/architecture-layer.js +0 -24
  397. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  398. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  399. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  400. package/dist/core/context/layers/contracts-layer.js +0 -83
  401. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  402. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  403. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  404. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  405. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  406. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  407. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  408. package/dist/core/context/layers/flow-layer.js +0 -61
  409. package/dist/core/context/layers/flow-layer.js.map +0 -1
  410. package/dist/core/context/layers/index-layer.d.ts +0 -13
  411. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  412. package/dist/core/context/layers/index-layer.js +0 -77
  413. package/dist/core/context/layers/index-layer.js.map +0 -1
  414. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  415. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  416. package/dist/core/context/layers/primary-layer.js +0 -61
  417. package/dist/core/context/layers/primary-layer.js.map +0 -1
  418. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  419. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  420. package/dist/core/context/layers/secondary-layer.js +0 -52
  421. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  422. package/dist/core/context/session-lock.d.ts +0 -114
  423. package/dist/core/context/session-lock.d.ts.map +0 -1
  424. package/dist/core/context/session-lock.js +0 -90
  425. package/dist/core/context/session-lock.js.map +0 -1
  426. package/dist/core/context/tokens.d.ts +0 -35
  427. package/dist/core/context/tokens.d.ts.map +0 -1
  428. package/dist/core/context/tokens.js +0 -88
  429. package/dist/core/context/tokens.js.map +0 -1
  430. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  431. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  432. package/dist/core/extract/asyncapi/declared.js +0 -168
  433. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  434. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  435. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  436. package/dist/core/extract/asyncapi/index.js +0 -8
  437. package/dist/core/extract/asyncapi/index.js.map +0 -1
  438. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  439. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  440. package/dist/core/extract/asyncapi/payloads.js +0 -421
  441. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  442. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  443. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  444. package/dist/core/extract/asyncapi/topics.js +0 -368
  445. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  446. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  447. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  448. package/dist/core/extract/asyncapi/types.js +0 -5
  449. package/dist/core/extract/asyncapi/types.js.map +0 -1
  450. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  451. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  452. package/dist/core/extract/asyncapi/validate.js +0 -156
  453. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  454. package/dist/core/extract/component.d.ts +0 -204
  455. package/dist/core/extract/component.d.ts.map +0 -1
  456. package/dist/core/extract/component.js +0 -258
  457. package/dist/core/extract/component.js.map +0 -1
  458. package/dist/core/extract/detect.d.ts +0 -35
  459. package/dist/core/extract/detect.d.ts.map +0 -1
  460. package/dist/core/extract/detect.js +0 -89
  461. package/dist/core/extract/detect.js.map +0 -1
  462. package/dist/core/extract/index.d.ts +0 -12
  463. package/dist/core/extract/index.d.ts.map +0 -1
  464. package/dist/core/extract/index.js +0 -6
  465. package/dist/core/extract/index.js.map +0 -1
  466. package/dist/core/extract/ladder.d.ts +0 -79
  467. package/dist/core/extract/ladder.d.ts.map +0 -1
  468. package/dist/core/extract/ladder.js +0 -70
  469. package/dist/core/extract/ladder.js.map +0 -1
  470. package/dist/core/extract/openapi/index.d.ts +0 -43
  471. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  472. package/dist/core/extract/openapi/index.js +0 -142
  473. package/dist/core/extract/openapi/index.js.map +0 -1
  474. package/dist/core/extract/openapi/route1.d.ts +0 -36
  475. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  476. package/dist/core/extract/openapi/route1.js +0 -333
  477. package/dist/core/extract/openapi/route1.js.map +0 -1
  478. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  479. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  480. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  481. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  482. package/dist/core/extract/openapi/route2.d.ts +0 -69
  483. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  484. package/dist/core/extract/openapi/route2.js +0 -211
  485. package/dist/core/extract/openapi/route2.js.map +0 -1
  486. package/dist/core/extract/openapi/route3.d.ts +0 -26
  487. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  488. package/dist/core/extract/openapi/route3.js +0 -737
  489. package/dist/core/extract/openapi/route3.js.map +0 -1
  490. package/dist/core/extract/openapi/types.d.ts +0 -125
  491. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  492. package/dist/core/extract/openapi/types.js +0 -5
  493. package/dist/core/extract/openapi/types.js.map +0 -1
  494. package/dist/core/extract/openapi/validate.d.ts +0 -29
  495. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  496. package/dist/core/extract/openapi/validate.js +0 -200
  497. package/dist/core/extract/openapi/validate.js.map +0 -1
  498. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  499. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  500. package/dist/core/extract/orm/drizzle.js +0 -283
  501. package/dist/core/extract/orm/drizzle.js.map +0 -1
  502. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  503. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  504. package/dist/core/extract/orm/information-schema.js +0 -142
  505. package/dist/core/extract/orm/information-schema.js.map +0 -1
  506. package/dist/core/extract/orm/prisma.d.ts +0 -23
  507. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  508. package/dist/core/extract/orm/prisma.js +0 -234
  509. package/dist/core/extract/orm/prisma.js.map +0 -1
  510. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  511. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  512. package/dist/core/extract/orm/typeorm.js +0 -269
  513. package/dist/core/extract/orm/typeorm.js.map +0 -1
  514. package/dist/core/extract/orm/types.d.ts +0 -97
  515. package/dist/core/extract/orm/types.d.ts.map +0 -1
  516. package/dist/core/extract/orm/types.js +0 -6
  517. package/dist/core/extract/orm/types.js.map +0 -1
  518. package/dist/core/extract/prompt.d.ts +0 -21
  519. package/dist/core/extract/prompt.d.ts.map +0 -1
  520. package/dist/core/extract/prompt.js +0 -79
  521. package/dist/core/extract/prompt.js.map +0 -1
  522. package/dist/core/extract/provider.d.ts +0 -121
  523. package/dist/core/extract/provider.d.ts.map +0 -1
  524. package/dist/core/extract/provider.js +0 -6
  525. package/dist/core/extract/provider.js.map +0 -1
  526. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  527. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  528. package/dist/core/extract/providers/node-ts.js +0 -320
  529. package/dist/core/extract/providers/node-ts.js.map +0 -1
  530. package/dist/core/extract/render/schema-md.d.ts +0 -16
  531. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  532. package/dist/core/extract/render/schema-md.js +0 -140
  533. package/dist/core/extract/render/schema-md.js.map +0 -1
  534. package/dist/core/extract/report.d.ts +0 -125
  535. package/dist/core/extract/report.d.ts.map +0 -1
  536. package/dist/core/extract/report.js +0 -52
  537. package/dist/core/extract/report.js.map +0 -1
  538. package/dist/core/extract/schema.d.ts +0 -34
  539. package/dist/core/extract/schema.d.ts.map +0 -1
  540. package/dist/core/extract/schema.js +0 -146
  541. package/dist/core/extract/schema.js.map +0 -1
  542. package/dist/core/extract/workspaces.d.ts +0 -33
  543. package/dist/core/extract/workspaces.d.ts.map +0 -1
  544. package/dist/core/extract/workspaces.js +0 -193
  545. package/dist/core/extract/workspaces.js.map +0 -1
  546. package/dist/core/providers/index.d.ts +0 -6
  547. package/dist/core/providers/index.d.ts.map +0 -1
  548. package/dist/core/providers/index.js +0 -2
  549. package/dist/core/providers/index.js.map +0 -1
  550. package/dist/core/providers/tracker.d.ts +0 -74
  551. package/dist/core/providers/tracker.d.ts.map +0 -1
  552. package/dist/core/providers/tracker.js +0 -38
  553. package/dist/core/providers/tracker.js.map +0 -1
  554. package/dist/core/scope/calibration.d.ts +0 -25
  555. package/dist/core/scope/calibration.d.ts.map +0 -1
  556. package/dist/core/scope/calibration.js +0 -52
  557. package/dist/core/scope/calibration.js.map +0 -1
  558. package/dist/core/scope/closure.d.ts +0 -31
  559. package/dist/core/scope/closure.d.ts.map +0 -1
  560. package/dist/core/scope/closure.js +0 -68
  561. package/dist/core/scope/closure.js.map +0 -1
  562. package/dist/core/scope/gate.d.ts +0 -41
  563. package/dist/core/scope/gate.d.ts.map +0 -1
  564. package/dist/core/scope/gate.js +0 -165
  565. package/dist/core/scope/gate.js.map +0 -1
  566. package/dist/core/scope/index.d.ts +0 -18
  567. package/dist/core/scope/index.d.ts.map +0 -1
  568. package/dist/core/scope/index.js +0 -12
  569. package/dist/core/scope/index.js.map +0 -1
  570. package/dist/core/scope/partition.d.ts +0 -36
  571. package/dist/core/scope/partition.d.ts.map +0 -1
  572. package/dist/core/scope/partition.js +0 -78
  573. package/dist/core/scope/partition.js.map +0 -1
  574. package/dist/core/scope/prompt.d.ts +0 -39
  575. package/dist/core/scope/prompt.d.ts.map +0 -1
  576. package/dist/core/scope/prompt.js +0 -123
  577. package/dist/core/scope/prompt.js.map +0 -1
  578. package/dist/core/scope/scoping.d.ts +0 -52
  579. package/dist/core/scope/scoping.d.ts.map +0 -1
  580. package/dist/core/scope/scoping.js +0 -99
  581. package/dist/core/scope/scoping.js.map +0 -1
  582. package/dist/core/scope/types.d.ts +0 -77
  583. package/dist/core/scope/types.d.ts.map +0 -1
  584. package/dist/core/scope/types.js +0 -5
  585. package/dist/core/scope/types.js.map +0 -1
  586. package/dist/core/scope/validate.d.ts +0 -47
  587. package/dist/core/scope/validate.d.ts.map +0 -1
  588. package/dist/core/scope/validate.js +0 -90
  589. package/dist/core/scope/validate.js.map +0 -1
  590. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  591. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  592. package/dist/core/verify/asyncapi-diff.js +0 -209
  593. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  594. package/dist/core/verify/contract-diff.d.ts +0 -39
  595. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  596. package/dist/core/verify/contract-diff.js +0 -63
  597. package/dist/core/verify/contract-diff.js.map +0 -1
  598. package/dist/core/verify/drift.d.ts +0 -47
  599. package/dist/core/verify/drift.d.ts.map +0 -1
  600. package/dist/core/verify/drift.js +0 -122
  601. package/dist/core/verify/drift.js.map +0 -1
  602. package/dist/core/verify/impact.d.ts +0 -22
  603. package/dist/core/verify/impact.d.ts.map +0 -1
  604. package/dist/core/verify/impact.js +0 -93
  605. package/dist/core/verify/impact.js.map +0 -1
  606. package/dist/core/verify/index.d.ts +0 -10
  607. package/dist/core/verify/index.d.ts.map +0 -1
  608. package/dist/core/verify/index.js +0 -9
  609. package/dist/core/verify/index.js.map +0 -1
  610. package/dist/core/verify/openapi-diff.d.ts +0 -29
  611. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  612. package/dist/core/verify/openapi-diff.js +0 -291
  613. package/dist/core/verify/openapi-diff.js.map +0 -1
  614. package/dist/core/verify/types.d.ts +0 -138
  615. package/dist/core/verify/types.d.ts.map +0 -1
  616. package/dist/core/verify/types.js +0 -5
  617. package/dist/core/verify/types.js.map +0 -1
  618. package/schemas/component.schema.json +0 -203
  619. package/schemas/flow.schema.json +0 -75
  620. package/schemas/scope-output.schema.json +0 -62
@@ -0,0 +1,44 @@
1
+ /** A single format finding. */
2
+ export interface DecisionLogFinding {
3
+ /** Stable rule identifier, for grouping output. */
4
+ rule: "duplicate-id" | "invalid-phase" | "dangling-supersedes";
5
+ /** Repo-relative path of the file the finding is about. */
6
+ path: string;
7
+ /** One line, naming the row and the condition. */
8
+ message: string;
9
+ }
10
+ export interface DecisionLogResult {
11
+ /** Findings that fail the gate: duplicate ID, invalid Phase. */
12
+ failures: DecisionLogFinding[];
13
+ /** Findings that are reported and do not fail the gate: dangling Supersedes. */
14
+ staleness: DecisionLogFinding[];
15
+ }
16
+ interface Row {
17
+ id: string;
18
+ phase: string;
19
+ supersedes: string;
20
+ }
21
+ /**
22
+ * Parse every decision row out of one file's content. A file may hold
23
+ * several tables (WHAT phase, HOW phase, one per specification phase);
24
+ * each is read independently by its own header, and all rows are
25
+ * pooled — `ID` uniqueness and `Supersedes` resolution are file-wide,
26
+ * not per-table (the format has one ID space for the whole file).
27
+ */
28
+ export declare function parseDecisionRows(content: string): Row[];
29
+ /**
30
+ * Check one decision log's already-read content. `path` is the
31
+ * repo-relative path used only in finding messages.
32
+ */
33
+ export declare function checkDecisionLogContent(content: string, path: string): DecisionLogResult;
34
+ /**
35
+ * Check the decision-log format across a repository: every
36
+ * `workstream/decisions-*.md` file present.
37
+ *
38
+ * A repository with none reports nothing — not having adopted the
39
+ * grilling workflow yet is not a defect (mirrors docs-structure's
40
+ * no-`docs/runbooks/` behavior).
41
+ */
42
+ export declare function checkDecisionLogFormat(repoRoot: string): DecisionLogResult;
43
+ export {};
44
+ //# sourceMappingURL=decision-log-format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decision-log-format.d.ts","sourceRoot":"","sources":["../../../core/checks/decision-log-format.ts"],"names":[],"mappings":"AAyBA,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,qBAAqB,CAAC;IAC/D,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,gFAAgF;IAChF,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAUD,UAAU,GAAG;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,EAAE,CAoDxD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA2CxF;AAYD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAY1E"}
@@ -0,0 +1,171 @@
1
+ /**
2
+ * Decision-log format check (S-007; specification §14 "Format").
3
+ *
4
+ * Validates any `workstream/decisions-*.md` file against the row shape
5
+ * the log format already defines (specification §5, unchanged by this
6
+ * feature): `ID` is unique within the file, `Phase` is `WHAT` or `HOW`,
7
+ * and any `Supersedes` value resolves to an existing `ID` in the same
8
+ * file (the column is intra-file only — a value that happens to match
9
+ * another feature's `D-NN` is still dangling here).
10
+ *
11
+ * Uniqueness and `Phase` are hard failures. A dangling `Supersedes` is
12
+ * reported the same way docs-structure reports staleness (D-21's
13
+ * precedent): printed, not failed, so a decision log mid-session — a
14
+ * row citing a `Supersedes` ID not yet appended — never blocks
15
+ * legitimate work-in-progress (story S-007 Business Rules).
16
+ *
17
+ * Tables are hand-parsed over the one fixed row shape rather than with
18
+ * a general Markdown parser (`SIMPLICITY.md` A4, D-49's precedent):
19
+ * this module ships to consumers inside `dist/core/`, where
20
+ * devDependencies are absent, and a single flat table shape is a dozen
21
+ * lines to parse directly.
22
+ */
23
+ import { readFileSync, existsSync, readdirSync } from "node:fs";
24
+ import { join } from "node:path";
25
+ const VALID_PHASES = new Set(["WHAT", "HOW"]);
26
+ /** Values meaning "no Supersedes", not a reference to resolve. */
27
+ const NO_SUPERSEDES = new Set(["", "—", "-", "n/a"]);
28
+ /** Matches the `D-NN` token inside a Supersedes cell, e.g. `extends D-09`. */
29
+ const ID_TOKEN = /D-\d+/;
30
+ /** True for a Markdown table separator row: `| --- | :--- | ---: |`. */
31
+ function isSeparatorRow(line) {
32
+ return /^\|[\s:|-]+\|$/.test(line.trim());
33
+ }
34
+ /**
35
+ * Split a `| a | b | c |` row into cells, trimmed, dropping the leading
36
+ * and trailing empty cells the outer pipes produce.
37
+ */
38
+ function splitRow(line) {
39
+ const cells = line.split("|").map((c) => c.trim());
40
+ if (cells.length > 0 && cells[0] === "")
41
+ cells.shift();
42
+ if (cells.length > 0 && cells[cells.length - 1] === "")
43
+ cells.pop();
44
+ return cells;
45
+ }
46
+ /**
47
+ * Parse every decision row out of one file's content. A file may hold
48
+ * several tables (WHAT phase, HOW phase, one per specification phase);
49
+ * each is read independently by its own header, and all rows are
50
+ * pooled — `ID` uniqueness and `Supersedes` resolution are file-wide,
51
+ * not per-table (the format has one ID space for the whole file).
52
+ */
53
+ export function parseDecisionRows(content) {
54
+ const lines = content.split("\n");
55
+ const rows = [];
56
+ let idCol = -1;
57
+ let phaseCol = -1;
58
+ let supersedesCol = -1;
59
+ let inTable = false;
60
+ for (let i = 0; i < lines.length; i++) {
61
+ const line = lines[i];
62
+ const trimmed = line.trim();
63
+ if (!trimmed.startsWith("|")) {
64
+ inTable = false;
65
+ continue;
66
+ }
67
+ if (!inTable) {
68
+ // Candidate header row: the next non-empty line must be a
69
+ // separator row for this to be a table at all.
70
+ const next = lines[i + 1]?.trim() ?? "";
71
+ if (!isSeparatorRow(next))
72
+ continue;
73
+ const headerCells = splitRow(trimmed).map((c) => c.toLowerCase());
74
+ idCol = headerCells.indexOf("id");
75
+ phaseCol = headerCells.indexOf("phase");
76
+ supersedesCol = headerCells.indexOf("supersedes");
77
+ if (idCol === -1)
78
+ continue; // not a decision table
79
+ inTable = true;
80
+ i++; // consume the separator row too
81
+ continue;
82
+ }
83
+ if (isSeparatorRow(trimmed))
84
+ continue;
85
+ const cells = splitRow(trimmed);
86
+ const id = cells[idCol];
87
+ if (id === undefined || id.length === 0) {
88
+ inTable = false;
89
+ continue;
90
+ }
91
+ rows.push({
92
+ id,
93
+ phase: phaseCol === -1 ? "" : (cells[phaseCol] ?? ""),
94
+ supersedes: supersedesCol === -1 ? "" : (cells[supersedesCol] ?? ""),
95
+ });
96
+ }
97
+ return rows;
98
+ }
99
+ /**
100
+ * Check one decision log's already-read content. `path` is the
101
+ * repo-relative path used only in finding messages.
102
+ */
103
+ export function checkDecisionLogContent(content, path) {
104
+ const rows = parseDecisionRows(content);
105
+ const failures = [];
106
+ const staleness = [];
107
+ const seen = new Set();
108
+ const ids = new Set(rows.map((r) => r.id));
109
+ for (const row of rows) {
110
+ if (seen.has(row.id)) {
111
+ failures.push({
112
+ rule: "duplicate-id",
113
+ path,
114
+ message: `${path}: ID '${row.id}' appears more than once.`,
115
+ });
116
+ }
117
+ seen.add(row.id);
118
+ if (!VALID_PHASES.has(row.phase)) {
119
+ failures.push({
120
+ rule: "invalid-phase",
121
+ path,
122
+ message: `${path}: row '${row.id}' has Phase '${row.phase}', expected WHAT or HOW.`,
123
+ });
124
+ }
125
+ const supersedes = row.supersedes;
126
+ if (!NO_SUPERSEDES.has(supersedes)) {
127
+ // A cell may be exactly an ID ("D-01") or prose naming one
128
+ // ("extends D-09") — the log's own real rows use both. Resolve
129
+ // the embedded `D-NN` token, not the whole cell verbatim.
130
+ const token = supersedes.match(ID_TOKEN)?.[0];
131
+ if (token === undefined || !ids.has(token)) {
132
+ staleness.push({
133
+ rule: "dangling-supersedes",
134
+ path,
135
+ message: `${path}: row '${row.id}' has Supersedes '${supersedes}', which does not resolve to an ID in this file.`,
136
+ });
137
+ }
138
+ }
139
+ }
140
+ return { failures, staleness };
141
+ }
142
+ /** `workstream/decisions-*.md` files present in the repository. */
143
+ function decisionLogFiles(repoRoot) {
144
+ const dir = join(repoRoot, "workstream");
145
+ if (!existsSync(dir))
146
+ return [];
147
+ return readdirSync(dir, { withFileTypes: true })
148
+ .filter((e) => e.isFile() && e.name.startsWith("decisions-") && e.name.endsWith(".md"))
149
+ .map((e) => `workstream/${e.name}`)
150
+ .sort();
151
+ }
152
+ /**
153
+ * Check the decision-log format across a repository: every
154
+ * `workstream/decisions-*.md` file present.
155
+ *
156
+ * A repository with none reports nothing — not having adopted the
157
+ * grilling workflow yet is not a defect (mirrors docs-structure's
158
+ * no-`docs/runbooks/` behavior).
159
+ */
160
+ export function checkDecisionLogFormat(repoRoot) {
161
+ const failures = [];
162
+ const staleness = [];
163
+ for (const path of decisionLogFiles(repoRoot)) {
164
+ const content = readFileSync(join(repoRoot, path), "utf-8");
165
+ const result = checkDecisionLogContent(content, path);
166
+ failures.push(...result.failures);
167
+ staleness.push(...result.staleness);
168
+ }
169
+ return { failures, staleness };
170
+ }
171
+ //# sourceMappingURL=decision-log-format.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decision-log-format.js","sourceRoot":"","sources":["../../../core/checks/decision-log-format.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,82 @@
1
+ /**
2
+ * Docs-structure check (PRD AC-24, AC-32; S-004).
3
+ *
4
+ * Reads a repository and reports two kinds of finding, separately:
5
+ * `failures`, which fail the `lint` gate, and `staleness`, which is
6
+ * reported and does not (D-21 — a runbook nobody has re-verified in 90
7
+ * days is worth knowing about, but blocking a merge on the calendar
8
+ * teaches people to bump the date without re-running the procedure).
9
+ *
10
+ * The function reads the filesystem and writes nothing, and returns the
11
+ * same result for the same tree. That is the checkable form of AC-1's
12
+ * "pure", which was self-contradictory for a function whose whole job
13
+ * is reading files.
14
+ *
15
+ * TWO RULES THAT MUST NOT OVER-FIRE (AC-10). A check that reports
16
+ * failures on a correct tree gets disabled, so both are narrowed
17
+ * deliberately:
18
+ *
19
+ * 1. A link is resolved relative to the index that contains it, and a
20
+ * link to a directory is fine. Without this, `docs/README.md`'s
21
+ * links to `../README.md` and `requirements/` fail on a clean tree.
22
+ * 2. The omission rule is non-recursive: an index accounts for the
23
+ * files beside it, not for a subtree. Without this, the seven ADRs
24
+ * and four PRDs that no index lists individually are all flagged.
25
+ *
26
+ * Frontmatter is hand-parsed over the five fixed keys rather than with
27
+ * `yaml` (D-49). This module ships to consumers inside `dist/core/`,
28
+ * where devDependencies are absent, and the format is rigid enough that
29
+ * a parser is a dozen lines.
30
+ */
31
+ /** A single structural finding. */
32
+ export interface DocsStructureFinding {
33
+ /** Stable rule identifier, for grouping output. */
34
+ rule: "index-lists-missing" | "index-omits-file" | "runbook-filename" | "runbook-frontmatter" | "runbook-related" | "runbook-stale";
35
+ /** Repo-relative path of the file the finding is about. */
36
+ path: string;
37
+ /** One line, naming the file and the condition. */
38
+ message: string;
39
+ }
40
+ export interface DocsStructureResult {
41
+ /** Findings that fail the gate. */
42
+ failures: DocsStructureFinding[];
43
+ /** Findings that are reported and do not fail the gate (AC-6). */
44
+ staleness: DocsStructureFinding[];
45
+ }
46
+ export interface Frontmatter {
47
+ values: Record<string, string>;
48
+ related: string[];
49
+ }
50
+ /**
51
+ * Parse the five fixed keys from a `---`-delimited block.
52
+ *
53
+ * Exported so `test/unit/runbook-set.test.ts` uses the parser that ships
54
+ * rather than a copy of it. A duplicate drifts, and then ten runbooks
55
+ * stay green in one place while `lint` fails in the other.
56
+ *
57
+ * Three input shapes cost nothing to accept and are expensive to get
58
+ * wrong, because each one fails as "no frontmatter block" — a confident,
59
+ * wrong report on a file that is fine:
60
+ *
61
+ * - **CRLF.** Any checkout with `core.autocrlf=true` has it, and a
62
+ * `\n`-anchored parser calls every runbook malformed.
63
+ * - **A leading BOM.** Editors on Windows add one silently.
64
+ * - **`related` as a YAML block sequence**, quoted or not. The shipped
65
+ * template teaches the inline bracketed form, which is why this tree
66
+ * is green — but a consumer writing ordinary YAML would have had
67
+ * both the dangling-path rule and the escape-the-repo rule go
68
+ * silently blind, with the key still non-empty so the missing-key
69
+ * rule did not fire either.
70
+ *
71
+ * `related` is read as the span up to the next top-level key, so a list
72
+ * Prettier has wrapped across indented lines reads like an inline one.
73
+ */
74
+ export declare function parseFrontmatter(content: string): Frontmatter | null;
75
+ /**
76
+ * Check the documentation structure of a repository.
77
+ *
78
+ * A repository with no `docs/runbooks/` reports nothing for runbooks
79
+ * (AC-9): not having adopted runbooks is not a defect.
80
+ */
81
+ export declare function checkDocsStructure(repoRoot: string): DocsStructureResult;
82
+ //# sourceMappingURL=docs-structure.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs-structure.d.ts","sourceRoot":"","sources":["../../../core/checks/docs-structure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,IAAI,EACA,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,eAAe,CAAC;IACpB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,kEAAkE;IAClE,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AA0BD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA2BpE;AA8LD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAcxE"}
@@ -0,0 +1,285 @@
1
+ /**
2
+ * Docs-structure check (PRD AC-24, AC-32; S-004).
3
+ *
4
+ * Reads a repository and reports two kinds of finding, separately:
5
+ * `failures`, which fail the `lint` gate, and `staleness`, which is
6
+ * reported and does not (D-21 — a runbook nobody has re-verified in 90
7
+ * days is worth knowing about, but blocking a merge on the calendar
8
+ * teaches people to bump the date without re-running the procedure).
9
+ *
10
+ * The function reads the filesystem and writes nothing, and returns the
11
+ * same result for the same tree. That is the checkable form of AC-1's
12
+ * "pure", which was self-contradictory for a function whose whole job
13
+ * is reading files.
14
+ *
15
+ * TWO RULES THAT MUST NOT OVER-FIRE (AC-10). A check that reports
16
+ * failures on a correct tree gets disabled, so both are narrowed
17
+ * deliberately:
18
+ *
19
+ * 1. A link is resolved relative to the index that contains it, and a
20
+ * link to a directory is fine. Without this, `docs/README.md`'s
21
+ * links to `../README.md` and `requirements/` fail on a clean tree.
22
+ * 2. The omission rule is non-recursive: an index accounts for the
23
+ * files beside it, not for a subtree. Without this, the seven ADRs
24
+ * and four PRDs that no index lists individually are all flagged.
25
+ *
26
+ * Frontmatter is hand-parsed over the five fixed keys rather than with
27
+ * `yaml` (D-49). This module ships to consumers inside `dist/core/`,
28
+ * where devDependencies are absent, and the format is rigid enough that
29
+ * a parser is a dozen lines.
30
+ */
31
+ import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
32
+ import { join, resolve, dirname, relative, isAbsolute } from "node:path";
33
+ /** Indexes this check enforces, each accounting for the files beside it. */
34
+ const INDEXES = ["docs/README.md", "docs/runbooks/README.md"];
35
+ const RUNBOOK_FILENAME = /^runbook-[a-z0-9]+(-[a-z0-9]+)+\.md$/;
36
+ /**
37
+ * The scaffold `install` delivers into `docs/runbooks/`. It is a form to
38
+ * copy, not a procedure: its filename has one segment, its frontmatter
39
+ * holds angle-bracket placeholders, and its `related` paths are examples.
40
+ * Checked as a runbook it produces four failures in every consumer
41
+ * repository on the first `lint` after install — a check reporting
42
+ * failures on a correct tree, which is what AC-10 exists to prevent.
43
+ */
44
+ const TEMPLATE_FILENAME = "runbook-template.md";
45
+ const REQUIRED_KEYS = ["name", "trigger", "owner", "last_verified", "related"];
46
+ const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
47
+ const STALE_AFTER_DAYS = 90;
48
+ /** Markdown inline links: `[text](target)`. */
49
+ const LINK = /\[[^\]]*\]\(([^)]+)\)/g;
50
+ /**
51
+ * Parse the five fixed keys from a `---`-delimited block.
52
+ *
53
+ * Exported so `test/unit/runbook-set.test.ts` uses the parser that ships
54
+ * rather than a copy of it. A duplicate drifts, and then ten runbooks
55
+ * stay green in one place while `lint` fails in the other.
56
+ *
57
+ * Three input shapes cost nothing to accept and are expensive to get
58
+ * wrong, because each one fails as "no frontmatter block" — a confident,
59
+ * wrong report on a file that is fine:
60
+ *
61
+ * - **CRLF.** Any checkout with `core.autocrlf=true` has it, and a
62
+ * `\n`-anchored parser calls every runbook malformed.
63
+ * - **A leading BOM.** Editors on Windows add one silently.
64
+ * - **`related` as a YAML block sequence**, quoted or not. The shipped
65
+ * template teaches the inline bracketed form, which is why this tree
66
+ * is green — but a consumer writing ordinary YAML would have had
67
+ * both the dangling-path rule and the escape-the-repo rule go
68
+ * silently blind, with the key still non-empty so the missing-key
69
+ * rule did not fire either.
70
+ *
71
+ * `related` is read as the span up to the next top-level key, so a list
72
+ * Prettier has wrapped across indented lines reads like an inline one.
73
+ */
74
+ export function parseFrontmatter(content) {
75
+ // Normalize before matching, never after: every check below assumes
76
+ // LF and no BOM.
77
+ const text = content.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n");
78
+ if (!text.startsWith("---\n"))
79
+ return null;
80
+ const end = text.indexOf("\n---\n", 4);
81
+ if (end === -1)
82
+ return null;
83
+ const block = text.slice(4, end);
84
+ const values = {};
85
+ for (const line of block.split("\n")) {
86
+ const match = line.match(/^([a-z_]+):\s*(.*)$/);
87
+ if (match)
88
+ values[match[1]] = match[2].trim();
89
+ }
90
+ const at = block.search(/^related:/m);
91
+ let related = [];
92
+ if (at !== -1) {
93
+ const rest = block.slice(at + "related:".length);
94
+ const nextKey = rest.search(/^[a-z_]+:/m);
95
+ const span = nextKey === -1 ? rest : rest.slice(0, nextKey);
96
+ related = readRelatedList(span);
97
+ values["related"] = span.trim();
98
+ }
99
+ return { values, related };
100
+ }
101
+ /**
102
+ * Read the paths out of a `related` value in either form: an inline
103
+ * bracketed list, or a YAML block sequence of `- path` lines. Quotes are
104
+ * optional in both.
105
+ */
106
+ function readRelatedList(span) {
107
+ const quoted = [...span.matchAll(/["']([^"']+)["']/g)].map((m) => m[1]);
108
+ if (quoted.length > 0)
109
+ return quoted;
110
+ const items = [];
111
+ for (const line of span.split("\n")) {
112
+ const dashed = line.match(/^\s*-\s+(.+?)\s*$/);
113
+ if (dashed) {
114
+ items.push(dashed[1]);
115
+ continue;
116
+ }
117
+ // An inline bracketed list with no quotes: [a/b.sh, c/d.yml]
118
+ const inline = line.match(/^\s*\[(.+)\]\s*$/);
119
+ if (inline) {
120
+ items.push(...inline[1]
121
+ .split(",")
122
+ .map((x) => x.trim())
123
+ .filter((x) => x.length > 0));
124
+ }
125
+ }
126
+ return items;
127
+ }
128
+ /** Link targets worth resolving: not external, not a bare anchor. */
129
+ function isLocalLink(target) {
130
+ return !/^(https?:|mailto:|#)/.test(target);
131
+ }
132
+ function filesBeside(dir) {
133
+ return readdirSync(dir, { withFileTypes: true })
134
+ .filter((e) => e.isFile() &&
135
+ e.name.endsWith(".md") &&
136
+ e.name !== "README.md" &&
137
+ e.name !== TEMPLATE_FILENAME)
138
+ .map((e) => e.name)
139
+ .sort();
140
+ }
141
+ function checkIndex(repoRoot, indexRel) {
142
+ const indexPath = join(repoRoot, indexRel);
143
+ if (!existsSync(indexPath))
144
+ return [];
145
+ const content = readFileSync(indexPath, "utf-8");
146
+ const indexDir = dirname(indexPath);
147
+ const findings = [];
148
+ // Rule 1: every local link resolves to something that exists. A
149
+ // directory counts — `existsSync` is the whole test.
150
+ const linked = new Set();
151
+ for (const match of content.matchAll(LINK)) {
152
+ const target = match[1].split("#")[0].trim();
153
+ if (target.length === 0 || !isLocalLink(target))
154
+ continue;
155
+ linked.add(target);
156
+ if (!existsSync(resolve(indexDir, target))) {
157
+ findings.push({
158
+ rule: "index-lists-missing",
159
+ path: indexRel,
160
+ message: `${indexRel} links ${target}, which does not exist.`,
161
+ });
162
+ }
163
+ }
164
+ // Rule 2: every markdown file beside the index is mentioned by it.
165
+ // Non-recursive on purpose — see the header note.
166
+ for (const name of filesBeside(indexDir)) {
167
+ if (![...linked].some((t) => t === name || t.endsWith(`/${name}`))) {
168
+ findings.push({
169
+ rule: "index-omits-file",
170
+ path: `${dirname(indexRel)}/${name}`,
171
+ message: `${indexRel} does not list ${name}, which exists beside it.`,
172
+ });
173
+ }
174
+ }
175
+ return findings;
176
+ }
177
+ function checkRunbook(repoRoot, name) {
178
+ const rel = `docs/runbooks/${name}`;
179
+ const findings = [];
180
+ if (!RUNBOOK_FILENAME.test(name)) {
181
+ findings.push({
182
+ rule: "runbook-filename",
183
+ path: rel,
184
+ message: `${rel} does not match runbook-<verb>-<object>.md.`,
185
+ });
186
+ }
187
+ const parsed = parseFrontmatter(readFileSync(join(repoRoot, rel), "utf-8"));
188
+ if (parsed === null) {
189
+ findings.push({
190
+ rule: "runbook-frontmatter",
191
+ path: rel,
192
+ message: `${rel} has no frontmatter block.`,
193
+ });
194
+ return findings;
195
+ }
196
+ for (const key of REQUIRED_KEYS) {
197
+ if (parsed.values[key] === undefined || parsed.values[key].length === 0) {
198
+ findings.push({
199
+ rule: "runbook-frontmatter",
200
+ path: rel,
201
+ message: `${rel} is missing frontmatter key '${key}'.`,
202
+ });
203
+ }
204
+ }
205
+ const verified = parsed.values["last_verified"];
206
+ if (verified !== undefined && !ISO_DATE.test(verified)) {
207
+ findings.push({
208
+ rule: "runbook-frontmatter",
209
+ path: rel,
210
+ message: `${rel} has a last_verified that is not a YYYY-MM-DD date: '${verified}'.`,
211
+ });
212
+ }
213
+ for (const target of parsed.related) {
214
+ const full = resolve(repoRoot, target);
215
+ const back = relative(repoRoot, full);
216
+ if (back.startsWith("..") || isAbsolute(back)) {
217
+ findings.push({
218
+ rule: "runbook-related",
219
+ path: rel,
220
+ message: `${rel} names a related path outside the repository: ${target}.`,
221
+ });
222
+ }
223
+ else if (!existsSync(full)) {
224
+ findings.push({
225
+ rule: "runbook-related",
226
+ path: rel,
227
+ message: `${rel} names a related path that does not exist: ${target}.`,
228
+ });
229
+ }
230
+ }
231
+ return findings;
232
+ }
233
+ /** Days between an ISO date and now, floored. */
234
+ function daysSince(iso, now) {
235
+ const then = new Date(`${iso}T00:00:00Z`).getTime();
236
+ return Math.floor((now.getTime() - then) / 86_400_000);
237
+ }
238
+ function checkStaleness(repoRoot, name) {
239
+ const rel = `docs/runbooks/${name}`;
240
+ const parsed = parseFrontmatter(readFileSync(join(repoRoot, rel), "utf-8"));
241
+ const verified = parsed?.values["last_verified"];
242
+ if (verified === undefined || !ISO_DATE.test(verified))
243
+ return [];
244
+ const age = daysSince(verified, new Date());
245
+ if (age <= STALE_AFTER_DAYS)
246
+ return [];
247
+ return [
248
+ {
249
+ rule: "runbook-stale",
250
+ path: rel,
251
+ message: `${rel} was last verified ${verified} (${age} days ago, over ${STALE_AFTER_DAYS}).`,
252
+ },
253
+ ];
254
+ }
255
+ function runbookFiles(repoRoot) {
256
+ const dir = join(repoRoot, "docs/runbooks");
257
+ if (!existsSync(dir) || !statSync(dir).isDirectory())
258
+ return [];
259
+ return readdirSync(dir, { withFileTypes: true })
260
+ .filter((e) => e.isFile() &&
261
+ e.name.endsWith(".md") &&
262
+ e.name !== "README.md" &&
263
+ e.name !== TEMPLATE_FILENAME)
264
+ .map((e) => e.name)
265
+ .sort();
266
+ }
267
+ /**
268
+ * Check the documentation structure of a repository.
269
+ *
270
+ * A repository with no `docs/runbooks/` reports nothing for runbooks
271
+ * (AC-9): not having adopted runbooks is not a defect.
272
+ */
273
+ export function checkDocsStructure(repoRoot) {
274
+ const failures = [];
275
+ const staleness = [];
276
+ for (const indexRel of INDEXES) {
277
+ failures.push(...checkIndex(repoRoot, indexRel));
278
+ }
279
+ for (const name of runbookFiles(repoRoot)) {
280
+ failures.push(...checkRunbook(repoRoot, name));
281
+ staleness.push(...checkStaleness(repoRoot, name));
282
+ }
283
+ return { failures, staleness };
284
+ }
285
+ //# sourceMappingURL=docs-structure.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs-structure.js","sourceRoot":"","sources":["../../../core/checks/docs-structure.ts"],"names":[],"mappings":"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"}