@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.
- package/.claude/agents/developer.md +108 -35
- package/.claude/agents/github-ops.md +48 -4
- package/.claude/agents/housekeeping.md +44 -7
- package/.claude/agents/qa-engineer.md +45 -3
- package/.claude/agents/researcher.md +116 -0
- package/.claude/agents/technical-writer.md +61 -6
- package/.claude/agents/ux-engineer.md +1 -0
- package/.claude/agents/verifier.md +48 -6
- package/.claude/commands/developer.md +2 -266
- package/.claude/commands/infra-engineer.md +92 -0
- package/.claude/commands/planner.md +64 -28
- package/.claude/commands/product-engineer.md +58 -19
- package/.claude/commands/researcher.md +27 -0
- package/.claude/commands/technical-writer.md +1 -1
- package/.claude/hooks/branch-guard.sh +30 -0
- package/.claude/hooks/git-guard.sh +483 -22
- package/.claude/skills/activity-codebase-research/SKILL.md +151 -0
- package/.claude/skills/activity-e2e-test-implementation/SKILL.md +156 -0
- package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
- package/.claude/skills/activity-grill/SKILL.md +150 -0
- package/.claude/skills/activity-init/SKILL.md +121 -71
- package/.claude/skills/activity-integration-test-implementation/SKILL.md +156 -0
- package/.claude/skills/activity-refine/SKILL.md +75 -15
- package/.claude/skills/activity-test-standards/SKILL.md +66 -0
- package/.claude/skills/aws-ops/SKILL.md +155 -0
- package/.claude/skills/deploy-ops/SKILL.md +121 -0
- package/.claude/skills/fly-ops/SKILL.md +138 -0
- package/.claude/skills/git-ops/SKILL.md +27 -7
- package/.claude/skills/implement/SKILL.md +49 -4
- package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.claude/skills/memo-cli-usage/SKILL.md +66 -13
- package/.claude/skills/plan/SKILL.md +43 -1
- package/.claude/skills/supabase-ops/SKILL.md +109 -0
- package/.github/agents/developer.agent.md +80 -18
- package/.github/agents/github-ops.agent.md +46 -4
- package/.github/agents/housekeeping.agent.md +43 -7
- package/.github/agents/infra-engineer.agent.md +139 -0
- package/.github/agents/planner.agent.md +45 -9
- package/.github/agents/product-engineer.agent.md +58 -19
- package/.github/agents/qa-engineer.agent.md +43 -4
- package/.github/agents/researcher.agent.md +115 -0
- package/.github/agents/technical-writer.agent.md +60 -6
- package/.github/agents/verifier.agent.md +46 -5
- package/.github/instructions/implement.instructions.md +49 -4
- package/.github/instructions/plan.instructions.md +43 -1
- package/.github/prompts/infra-engineer.prompt.md +12 -0
- package/.github/prompts/product-engineer-init.prompt.md +5 -6
- package/.github/prompts/researcher.prompt.md +28 -0
- package/.github/prompts/technical-writer.prompt.md +1 -1
- package/.github/skills/activity-codebase-research/SKILL.md +146 -0
- package/.github/skills/activity-e2e-test-implementation/SKILL.md +156 -0
- package/.github/skills/activity-generate-spec/SKILL.md +34 -10
- package/.github/skills/activity-grill/SKILL.md +145 -0
- package/.github/skills/activity-init/SKILL.md +120 -70
- package/.github/skills/activity-integration-test-implementation/SKILL.md +156 -0
- package/.github/skills/activity-refine/SKILL.md +75 -15
- package/.github/skills/activity-test-standards/SKILL.md +66 -0
- package/.github/skills/aws-ops/SKILL.md +150 -0
- package/.github/skills/deploy-ops/SKILL.md +116 -0
- package/.github/skills/fly-ops/SKILL.md +133 -0
- package/.github/skills/git-ops/SKILL.md +27 -7
- package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.github/skills/memo-cli-usage/SKILL.md +66 -13
- package/.github/skills/supabase-ops/SKILL.md +104 -0
- package/.kiro/agents/developer.md +81 -19
- package/.kiro/agents/github-ops.md +46 -4
- package/.kiro/agents/housekeeping.md +44 -8
- package/.kiro/agents/infra-engineer.md +102 -0
- package/.kiro/agents/planner.md +53 -20
- package/.kiro/agents/product-engineer.md +61 -22
- package/.kiro/agents/qa-engineer.md +44 -5
- package/.kiro/agents/researcher.md +118 -0
- package/.kiro/agents/technical-writer.md +63 -9
- package/.kiro/agents/verifier.md +48 -7
- package/.kiro/skills/activity-codebase-research/SKILL.md +151 -0
- package/.kiro/skills/activity-e2e-test-implementation/SKILL.md +156 -0
- package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
- package/.kiro/skills/activity-grill/SKILL.md +150 -0
- package/.kiro/skills/activity-init/SKILL.md +121 -71
- package/.kiro/skills/activity-integration-test-implementation/SKILL.md +156 -0
- package/.kiro/skills/activity-refine/SKILL.md +75 -15
- package/.kiro/skills/activity-test-standards/SKILL.md +66 -0
- package/.kiro/skills/aws-ops/SKILL.md +155 -0
- package/.kiro/skills/deploy-ops/SKILL.md +121 -0
- package/.kiro/skills/fly-ops/SKILL.md +138 -0
- package/.kiro/skills/git-ops/SKILL.md +27 -7
- package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
- package/.kiro/skills/supabase-ops/SKILL.md +109 -0
- package/.kiro/steering/implement.md +49 -4
- package/.kiro/steering/plan.md +43 -1
- package/AGENTS.md +88 -261
- package/AGENTS.md.template +124 -0
- package/CHANGELOG.md +196 -0
- package/CLAUDE.md +24 -18
- package/CLAUDE.md.template +103 -0
- package/README.md +168 -145
- package/TESTING.md +84 -140
- package/bundle-manifest.json +43 -2
- package/dist/bin/dev-tasks.js +65 -3
- package/dist/bin/dev-tasks.js.map +1 -1
- package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
- package/dist/bin/parse-args.d.ts.map +1 -0
- package/dist/{adapters/cli → bin}/parse-args.js +2 -18
- package/dist/bin/parse-args.js.map +1 -0
- package/dist/core/checks/decision-log-format.d.ts +44 -0
- package/dist/core/checks/decision-log-format.d.ts.map +1 -0
- package/dist/core/checks/decision-log-format.js +171 -0
- package/dist/core/checks/decision-log-format.js.map +1 -0
- package/dist/core/checks/docs-structure.d.ts +82 -0
- package/dist/core/checks/docs-structure.d.ts.map +1 -0
- package/dist/core/checks/docs-structure.js +285 -0
- package/dist/core/checks/docs-structure.js.map +1 -0
- package/dist/core/checks/glossary.d.ts +178 -0
- package/dist/core/checks/glossary.d.ts.map +1 -0
- package/dist/core/checks/glossary.js +651 -0
- package/dist/core/checks/glossary.js.map +1 -0
- package/dist/core/checks/index.d.ts +19 -0
- package/dist/core/checks/index.d.ts.map +1 -0
- package/dist/core/checks/index.js +16 -0
- package/dist/core/checks/index.js.map +1 -0
- package/dist/core/checks/run.d.ts +22 -0
- package/dist/core/checks/run.d.ts.map +1 -0
- package/dist/core/checks/run.js +51 -0
- package/dist/core/checks/run.js.map +1 -0
- package/dist/core/distribution/doctor.d.ts +46 -1
- package/dist/core/distribution/doctor.d.ts.map +1 -1
- package/dist/core/distribution/doctor.js +161 -2
- package/dist/core/distribution/doctor.js.map +1 -1
- package/dist/core/distribution/index.d.ts +9 -3
- package/dist/core/distribution/index.d.ts.map +1 -1
- package/dist/core/distribution/index.js +5 -2
- package/dist/core/distribution/index.js.map +1 -1
- package/dist/core/distribution/install-if-absent.d.ts +46 -0
- package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
- package/dist/core/distribution/install-if-absent.js +81 -0
- package/dist/core/distribution/install-if-absent.js.map +1 -0
- package/dist/core/distribution/install.d.ts.map +1 -1
- package/dist/core/distribution/install.js +5 -0
- package/dist/core/distribution/install.js.map +1 -1
- package/dist/core/distribution/migrate-docs.d.ts +64 -0
- package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
- package/dist/core/distribution/migrate-docs.js +139 -0
- package/dist/core/distribution/migrate-docs.js.map +1 -0
- package/dist/core/distribution/profiles.d.ts +49 -0
- package/dist/core/distribution/profiles.d.ts.map +1 -1
- package/dist/core/distribution/profiles.js +45 -0
- package/dist/core/distribution/profiles.js.map +1 -1
- package/dist/core/distribution/update.d.ts +14 -0
- package/dist/core/distribution/update.d.ts.map +1 -1
- package/dist/core/distribution/update.js +77 -3
- package/dist/core/distribution/update.js.map +1 -1
- package/dist/core/distribution/workspace.d.ts +84 -0
- package/dist/core/distribution/workspace.d.ts.map +1 -0
- package/dist/core/distribution/workspace.js +276 -0
- package/dist/core/distribution/workspace.js.map +1 -0
- package/dist/core/exit-codes.d.ts +15 -35
- package/dist/core/exit-codes.d.ts.map +1 -1
- package/dist/core/exit-codes.js +15 -36
- package/dist/core/exit-codes.js.map +1 -1
- package/dist/core/index.d.ts +1 -6
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +1 -7
- package/dist/core/index.js.map +1 -1
- package/package.json +17 -32
- package/templates/claude/settings.json +48 -0
- package/templates/domain/ubiquitous-language.md +28 -0
- package/templates/infra/environments.yaml +16 -0
- package/templates/infra/redaction-patterns.txt +47 -0
- package/templates/runbooks/README.md +14 -0
- package/templates/runbooks/runbook-template.md +40 -0
- package/templates/scripts/deploy-status.sh +89 -0
- package/templates/scripts/deploy-verify.sh +85 -0
- package/templates/scripts/deploy.sh +284 -0
- package/templates/scripts/release.sh +170 -0
- package/templates/scripts/rollback.sh +109 -0
- package/templates/workflows/deploy-dev.yml +66 -0
- package/templates/workflows/deploy-prod.yml +66 -0
- package/templates/workflows/rollback.yml +77 -0
- package/dist/adapters/cli/catalog-build.d.ts +0 -30
- package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-build.js +0 -73
- package/dist/adapters/cli/catalog-build.js.map +0 -1
- package/dist/adapters/cli/catalog-query.d.ts +0 -13
- package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-query.js +0 -329
- package/dist/adapters/cli/catalog-query.js.map +0 -1
- package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
- package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-scaffold.js +0 -46
- package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
- package/dist/adapters/cli/catalog-validate.d.ts +0 -35
- package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-validate.js +0 -122
- package/dist/adapters/cli/catalog-validate.js.map +0 -1
- package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
- package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
- package/dist/adapters/cli/ctx-assemble.js +0 -293
- package/dist/adapters/cli/ctx-assemble.js.map +0 -1
- package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
- package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
- package/dist/adapters/cli/ctx-fetch.js +0 -267
- package/dist/adapters/cli/ctx-fetch.js.map +0 -1
- package/dist/adapters/cli/extract-all.d.ts +0 -31
- package/dist/adapters/cli/extract-all.d.ts.map +0 -1
- package/dist/adapters/cli/extract-all.js +0 -374
- package/dist/adapters/cli/extract-all.js.map +0 -1
- package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
- package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
- package/dist/adapters/cli/extract-asyncapi.js +0 -142
- package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
- package/dist/adapters/cli/extract-component.d.ts +0 -24
- package/dist/adapters/cli/extract-component.d.ts.map +0 -1
- package/dist/adapters/cli/extract-component.js +0 -198
- package/dist/adapters/cli/extract-component.js.map +0 -1
- package/dist/adapters/cli/extract-detect.d.ts +0 -19
- package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
- package/dist/adapters/cli/extract-detect.js +0 -98
- package/dist/adapters/cli/extract-detect.js.map +0 -1
- package/dist/adapters/cli/extract-openapi.d.ts +0 -29
- package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
- package/dist/adapters/cli/extract-openapi.js +0 -111
- package/dist/adapters/cli/extract-openapi.js.map +0 -1
- package/dist/adapters/cli/extract-schema.d.ts +0 -15
- package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
- package/dist/adapters/cli/extract-schema.js +0 -39
- package/dist/adapters/cli/extract-schema.js.map +0 -1
- package/dist/adapters/cli/index.d.ts +0 -6
- package/dist/adapters/cli/index.d.ts.map +0 -1
- package/dist/adapters/cli/index.js +0 -5
- package/dist/adapters/cli/index.js.map +0 -1
- package/dist/adapters/cli/init.d.ts +0 -37
- package/dist/adapters/cli/init.d.ts.map +0 -1
- package/dist/adapters/cli/init.js +0 -336
- package/dist/adapters/cli/init.js.map +0 -1
- package/dist/adapters/cli/parse-args.d.ts.map +0 -1
- package/dist/adapters/cli/parse-args.js.map +0 -1
- package/dist/adapters/cli/scope-gate.d.ts +0 -25
- package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
- package/dist/adapters/cli/scope-gate.js +0 -157
- package/dist/adapters/cli/scope-gate.js.map +0 -1
- package/dist/adapters/cli/scope.d.ts +0 -26
- package/dist/adapters/cli/scope.d.ts.map +0 -1
- package/dist/adapters/cli/scope.js +0 -172
- package/dist/adapters/cli/scope.js.map +0 -1
- package/dist/adapters/cli/validate-component.d.ts +0 -24
- package/dist/adapters/cli/validate-component.d.ts.map +0 -1
- package/dist/adapters/cli/validate-component.js +0 -62
- package/dist/adapters/cli/validate-component.js.map +0 -1
- package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
- package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
- package/dist/adapters/cli/verify-contract-diff.js +0 -69
- package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
- package/dist/adapters/cli/verify-drift.d.ts +0 -24
- package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
- package/dist/adapters/cli/verify-drift.js +0 -103
- package/dist/adapters/cli/verify-drift.js.map +0 -1
- package/dist/adapters/cli/verify-impact.d.ts +0 -23
- package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
- package/dist/adapters/cli/verify-impact.js +0 -119
- package/dist/adapters/cli/verify-impact.js.map +0 -1
- package/dist/adapters/mcp/index.d.ts +0 -5
- package/dist/adapters/mcp/index.d.ts.map +0 -1
- package/dist/adapters/mcp/index.js +0 -2
- package/dist/adapters/mcp/index.js.map +0 -1
- package/dist/bin/dt.d.ts +0 -7
- package/dist/bin/dt.d.ts.map +0 -1
- package/dist/bin/dt.js +0 -647
- package/dist/bin/dt.js.map +0 -1
- package/dist/core/catalog/build.d.ts +0 -143
- package/dist/core/catalog/build.d.ts.map +0 -1
- package/dist/core/catalog/build.js +0 -475
- package/dist/core/catalog/build.js.map +0 -1
- package/dist/core/catalog/checks/index.d.ts +0 -18
- package/dist/core/catalog/checks/index.d.ts.map +0 -1
- package/dist/core/catalog/checks/index.js +0 -18
- package/dist/core/catalog/checks/index.js.map +0 -1
- package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
- package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
- package/dist/core/catalog/checks/v01-schema.js +0 -57
- package/dist/core/catalog/checks/v01-schema.js.map +0 -1
- package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
- package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
- package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
- package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
- package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
- package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
- package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
- package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
- package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
- package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
- package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
- package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
- package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
- package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
- package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
- package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
- package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
- package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
- package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
- package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
- package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
- package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
- package/dist/core/catalog/checks/v12-cycles.js +0 -28
- package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
- package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
- package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
- package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
- package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
- package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
- package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
- package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
- package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
- package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
- package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
- package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
- package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
- package/dist/core/catalog/checks/v18-low-payload.js +0 -33
- package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
- package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
- package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
- package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
- package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
- package/dist/core/catalog/coverage.d.ts +0 -39
- package/dist/core/catalog/coverage.d.ts.map +0 -1
- package/dist/core/catalog/coverage.js +0 -62
- package/dist/core/catalog/coverage.js.map +0 -1
- package/dist/core/catalog/graph.d.ts +0 -49
- package/dist/core/catalog/graph.d.ts.map +0 -1
- package/dist/core/catalog/graph.js +0 -114
- package/dist/core/catalog/graph.js.map +0 -1
- package/dist/core/catalog/index-model.d.ts +0 -96
- package/dist/core/catalog/index-model.d.ts.map +0 -1
- package/dist/core/catalog/index-model.js +0 -8
- package/dist/core/catalog/index-model.js.map +0 -1
- package/dist/core/catalog/index.d.ts +0 -5
- package/dist/core/catalog/index.d.ts.map +0 -1
- package/dist/core/catalog/index.js +0 -2
- package/dist/core/catalog/index.js.map +0 -1
- package/dist/core/catalog/queries.d.ts +0 -69
- package/dist/core/catalog/queries.d.ts.map +0 -1
- package/dist/core/catalog/queries.js +0 -165
- package/dist/core/catalog/queries.js.map +0 -1
- package/dist/core/catalog/resolve.d.ts +0 -47
- package/dist/core/catalog/resolve.d.ts.map +0 -1
- package/dist/core/catalog/resolve.js +0 -318
- package/dist/core/catalog/resolve.js.map +0 -1
- package/dist/core/catalog/scaffold.d.ts +0 -31
- package/dist/core/catalog/scaffold.d.ts.map +0 -1
- package/dist/core/catalog/scaffold.js +0 -141
- package/dist/core/catalog/scaffold.js.map +0 -1
- package/dist/core/catalog/validate-component.d.ts +0 -50
- package/dist/core/catalog/validate-component.d.ts.map +0 -1
- package/dist/core/catalog/validate-component.js +0 -105
- package/dist/core/catalog/validate-component.js.map +0 -1
- package/dist/core/catalog/validate.d.ts +0 -71
- package/dist/core/catalog/validate.d.ts.map +0 -1
- package/dist/core/catalog/validate.js +0 -103
- package/dist/core/catalog/validate.js.map +0 -1
- package/dist/core/context/assemble.d.ts +0 -126
- package/dist/core/context/assemble.d.ts.map +0 -1
- package/dist/core/context/assemble.js +0 -197
- package/dist/core/context/assemble.js.map +0 -1
- package/dist/core/context/cache.d.ts +0 -60
- package/dist/core/context/cache.d.ts.map +0 -1
- package/dist/core/context/cache.js +0 -236
- package/dist/core/context/cache.js.map +0 -1
- package/dist/core/context/exit-codes.d.ts +0 -28
- package/dist/core/context/exit-codes.d.ts.map +0 -1
- package/dist/core/context/exit-codes.js +0 -28
- package/dist/core/context/exit-codes.js.map +0 -1
- package/dist/core/context/fetch.d.ts +0 -55
- package/dist/core/context/fetch.d.ts.map +0 -1
- package/dist/core/context/fetch.js +0 -112
- package/dist/core/context/fetch.js.map +0 -1
- package/dist/core/context/index.d.ts +0 -11
- package/dist/core/context/index.d.ts.map +0 -1
- package/dist/core/context/index.js +0 -8
- package/dist/core/context/index.js.map +0 -1
- package/dist/core/context/init.d.ts +0 -179
- package/dist/core/context/init.d.ts.map +0 -1
- package/dist/core/context/init.js +0 -532
- package/dist/core/context/init.js.map +0 -1
- package/dist/core/context/layers/architecture-layer.d.ts +0 -13
- package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
- package/dist/core/context/layers/architecture-layer.js +0 -24
- package/dist/core/context/layers/architecture-layer.js.map +0 -1
- package/dist/core/context/layers/contracts-layer.d.ts +0 -13
- package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
- package/dist/core/context/layers/contracts-layer.js +0 -83
- package/dist/core/context/layers/contracts-layer.js.map +0 -1
- package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
- package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
- package/dist/core/context/layers/conventions-delta-layer.js +0 -37
- package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
- package/dist/core/context/layers/flow-layer.d.ts +0 -14
- package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
- package/dist/core/context/layers/flow-layer.js +0 -61
- package/dist/core/context/layers/flow-layer.js.map +0 -1
- package/dist/core/context/layers/index-layer.d.ts +0 -13
- package/dist/core/context/layers/index-layer.d.ts.map +0 -1
- package/dist/core/context/layers/index-layer.js +0 -77
- package/dist/core/context/layers/index-layer.js.map +0 -1
- package/dist/core/context/layers/primary-layer.d.ts +0 -16
- package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
- package/dist/core/context/layers/primary-layer.js +0 -61
- package/dist/core/context/layers/primary-layer.js.map +0 -1
- package/dist/core/context/layers/secondary-layer.d.ts +0 -19
- package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
- package/dist/core/context/layers/secondary-layer.js +0 -52
- package/dist/core/context/layers/secondary-layer.js.map +0 -1
- package/dist/core/context/session-lock.d.ts +0 -114
- package/dist/core/context/session-lock.d.ts.map +0 -1
- package/dist/core/context/session-lock.js +0 -90
- package/dist/core/context/session-lock.js.map +0 -1
- package/dist/core/context/tokens.d.ts +0 -35
- package/dist/core/context/tokens.d.ts.map +0 -1
- package/dist/core/context/tokens.js +0 -88
- package/dist/core/context/tokens.js.map +0 -1
- package/dist/core/extract/asyncapi/declared.d.ts +0 -19
- package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/declared.js +0 -168
- package/dist/core/extract/asyncapi/declared.js.map +0 -1
- package/dist/core/extract/asyncapi/index.d.ts +0 -12
- package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/index.js +0 -8
- package/dist/core/extract/asyncapi/index.js.map +0 -1
- package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
- package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/payloads.js +0 -421
- package/dist/core/extract/asyncapi/payloads.js.map +0 -1
- package/dist/core/extract/asyncapi/topics.d.ts +0 -27
- package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/topics.js +0 -368
- package/dist/core/extract/asyncapi/topics.js.map +0 -1
- package/dist/core/extract/asyncapi/types.d.ts +0 -129
- package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/types.js +0 -5
- package/dist/core/extract/asyncapi/types.js.map +0 -1
- package/dist/core/extract/asyncapi/validate.d.ts +0 -29
- package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/validate.js +0 -156
- package/dist/core/extract/asyncapi/validate.js.map +0 -1
- package/dist/core/extract/component.d.ts +0 -204
- package/dist/core/extract/component.d.ts.map +0 -1
- package/dist/core/extract/component.js +0 -258
- package/dist/core/extract/component.js.map +0 -1
- package/dist/core/extract/detect.d.ts +0 -35
- package/dist/core/extract/detect.d.ts.map +0 -1
- package/dist/core/extract/detect.js +0 -89
- package/dist/core/extract/detect.js.map +0 -1
- package/dist/core/extract/index.d.ts +0 -12
- package/dist/core/extract/index.d.ts.map +0 -1
- package/dist/core/extract/index.js +0 -6
- package/dist/core/extract/index.js.map +0 -1
- package/dist/core/extract/ladder.d.ts +0 -79
- package/dist/core/extract/ladder.d.ts.map +0 -1
- package/dist/core/extract/ladder.js +0 -70
- package/dist/core/extract/ladder.js.map +0 -1
- package/dist/core/extract/openapi/index.d.ts +0 -43
- package/dist/core/extract/openapi/index.d.ts.map +0 -1
- package/dist/core/extract/openapi/index.js +0 -142
- package/dist/core/extract/openapi/index.js.map +0 -1
- package/dist/core/extract/openapi/route1.d.ts +0 -36
- package/dist/core/extract/openapi/route1.d.ts.map +0 -1
- package/dist/core/extract/openapi/route1.js +0 -333
- package/dist/core/extract/openapi/route1.js.map +0 -1
- package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
- package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
- package/dist/core/extract/openapi/route2-introspect.js +0 -249
- package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
- package/dist/core/extract/openapi/route2.d.ts +0 -69
- package/dist/core/extract/openapi/route2.d.ts.map +0 -1
- package/dist/core/extract/openapi/route2.js +0 -211
- package/dist/core/extract/openapi/route2.js.map +0 -1
- package/dist/core/extract/openapi/route3.d.ts +0 -26
- package/dist/core/extract/openapi/route3.d.ts.map +0 -1
- package/dist/core/extract/openapi/route3.js +0 -737
- package/dist/core/extract/openapi/route3.js.map +0 -1
- package/dist/core/extract/openapi/types.d.ts +0 -125
- package/dist/core/extract/openapi/types.d.ts.map +0 -1
- package/dist/core/extract/openapi/types.js +0 -5
- package/dist/core/extract/openapi/types.js.map +0 -1
- package/dist/core/extract/openapi/validate.d.ts +0 -29
- package/dist/core/extract/openapi/validate.d.ts.map +0 -1
- package/dist/core/extract/openapi/validate.js +0 -200
- package/dist/core/extract/openapi/validate.js.map +0 -1
- package/dist/core/extract/orm/drizzle.d.ts +0 -20
- package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
- package/dist/core/extract/orm/drizzle.js +0 -283
- package/dist/core/extract/orm/drizzle.js.map +0 -1
- package/dist/core/extract/orm/information-schema.d.ts +0 -26
- package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
- package/dist/core/extract/orm/information-schema.js +0 -142
- package/dist/core/extract/orm/information-schema.js.map +0 -1
- package/dist/core/extract/orm/prisma.d.ts +0 -23
- package/dist/core/extract/orm/prisma.d.ts.map +0 -1
- package/dist/core/extract/orm/prisma.js +0 -234
- package/dist/core/extract/orm/prisma.js.map +0 -1
- package/dist/core/extract/orm/typeorm.d.ts +0 -22
- package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
- package/dist/core/extract/orm/typeorm.js +0 -269
- package/dist/core/extract/orm/typeorm.js.map +0 -1
- package/dist/core/extract/orm/types.d.ts +0 -97
- package/dist/core/extract/orm/types.d.ts.map +0 -1
- package/dist/core/extract/orm/types.js +0 -6
- package/dist/core/extract/orm/types.js.map +0 -1
- package/dist/core/extract/prompt.d.ts +0 -21
- package/dist/core/extract/prompt.d.ts.map +0 -1
- package/dist/core/extract/prompt.js +0 -79
- package/dist/core/extract/prompt.js.map +0 -1
- package/dist/core/extract/provider.d.ts +0 -121
- package/dist/core/extract/provider.d.ts.map +0 -1
- package/dist/core/extract/provider.js +0 -6
- package/dist/core/extract/provider.js.map +0 -1
- package/dist/core/extract/providers/node-ts.d.ts +0 -69
- package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
- package/dist/core/extract/providers/node-ts.js +0 -320
- package/dist/core/extract/providers/node-ts.js.map +0 -1
- package/dist/core/extract/render/schema-md.d.ts +0 -16
- package/dist/core/extract/render/schema-md.d.ts.map +0 -1
- package/dist/core/extract/render/schema-md.js +0 -140
- package/dist/core/extract/render/schema-md.js.map +0 -1
- package/dist/core/extract/report.d.ts +0 -125
- package/dist/core/extract/report.d.ts.map +0 -1
- package/dist/core/extract/report.js +0 -52
- package/dist/core/extract/report.js.map +0 -1
- package/dist/core/extract/schema.d.ts +0 -34
- package/dist/core/extract/schema.d.ts.map +0 -1
- package/dist/core/extract/schema.js +0 -146
- package/dist/core/extract/schema.js.map +0 -1
- package/dist/core/extract/workspaces.d.ts +0 -33
- package/dist/core/extract/workspaces.d.ts.map +0 -1
- package/dist/core/extract/workspaces.js +0 -193
- package/dist/core/extract/workspaces.js.map +0 -1
- package/dist/core/providers/index.d.ts +0 -6
- package/dist/core/providers/index.d.ts.map +0 -1
- package/dist/core/providers/index.js +0 -2
- package/dist/core/providers/index.js.map +0 -1
- package/dist/core/providers/tracker.d.ts +0 -74
- package/dist/core/providers/tracker.d.ts.map +0 -1
- package/dist/core/providers/tracker.js +0 -38
- package/dist/core/providers/tracker.js.map +0 -1
- package/dist/core/scope/calibration.d.ts +0 -25
- package/dist/core/scope/calibration.d.ts.map +0 -1
- package/dist/core/scope/calibration.js +0 -52
- package/dist/core/scope/calibration.js.map +0 -1
- package/dist/core/scope/closure.d.ts +0 -31
- package/dist/core/scope/closure.d.ts.map +0 -1
- package/dist/core/scope/closure.js +0 -68
- package/dist/core/scope/closure.js.map +0 -1
- package/dist/core/scope/gate.d.ts +0 -41
- package/dist/core/scope/gate.d.ts.map +0 -1
- package/dist/core/scope/gate.js +0 -165
- package/dist/core/scope/gate.js.map +0 -1
- package/dist/core/scope/index.d.ts +0 -18
- package/dist/core/scope/index.d.ts.map +0 -1
- package/dist/core/scope/index.js +0 -12
- package/dist/core/scope/index.js.map +0 -1
- package/dist/core/scope/partition.d.ts +0 -36
- package/dist/core/scope/partition.d.ts.map +0 -1
- package/dist/core/scope/partition.js +0 -78
- package/dist/core/scope/partition.js.map +0 -1
- package/dist/core/scope/prompt.d.ts +0 -39
- package/dist/core/scope/prompt.d.ts.map +0 -1
- package/dist/core/scope/prompt.js +0 -123
- package/dist/core/scope/prompt.js.map +0 -1
- package/dist/core/scope/scoping.d.ts +0 -52
- package/dist/core/scope/scoping.d.ts.map +0 -1
- package/dist/core/scope/scoping.js +0 -99
- package/dist/core/scope/scoping.js.map +0 -1
- package/dist/core/scope/types.d.ts +0 -77
- package/dist/core/scope/types.d.ts.map +0 -1
- package/dist/core/scope/types.js +0 -5
- package/dist/core/scope/types.js.map +0 -1
- package/dist/core/scope/validate.d.ts +0 -47
- package/dist/core/scope/validate.d.ts.map +0 -1
- package/dist/core/scope/validate.js +0 -90
- package/dist/core/scope/validate.js.map +0 -1
- package/dist/core/verify/asyncapi-diff.d.ts +0 -34
- package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
- package/dist/core/verify/asyncapi-diff.js +0 -209
- package/dist/core/verify/asyncapi-diff.js.map +0 -1
- package/dist/core/verify/contract-diff.d.ts +0 -39
- package/dist/core/verify/contract-diff.d.ts.map +0 -1
- package/dist/core/verify/contract-diff.js +0 -63
- package/dist/core/verify/contract-diff.js.map +0 -1
- package/dist/core/verify/drift.d.ts +0 -47
- package/dist/core/verify/drift.d.ts.map +0 -1
- package/dist/core/verify/drift.js +0 -122
- package/dist/core/verify/drift.js.map +0 -1
- package/dist/core/verify/impact.d.ts +0 -22
- package/dist/core/verify/impact.d.ts.map +0 -1
- package/dist/core/verify/impact.js +0 -93
- package/dist/core/verify/impact.js.map +0 -1
- package/dist/core/verify/index.d.ts +0 -10
- package/dist/core/verify/index.d.ts.map +0 -1
- package/dist/core/verify/index.js +0 -9
- package/dist/core/verify/index.js.map +0 -1
- package/dist/core/verify/openapi-diff.d.ts +0 -29
- package/dist/core/verify/openapi-diff.d.ts.map +0 -1
- package/dist/core/verify/openapi-diff.js +0 -291
- package/dist/core/verify/openapi-diff.js.map +0 -1
- package/dist/core/verify/types.d.ts +0 -138
- package/dist/core/verify/types.d.ts.map +0 -1
- package/dist/core/verify/types.js +0 -5
- package/dist/core/verify/types.js.map +0 -1
- package/schemas/component.schema.json +0 -203
- package/schemas/flow.schema.json +0 -75
- 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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"}
|