@llipe.com/dev-tasks 0.11.0 → 0.16.2
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 +138 -62
- package/.claude/agents/github-ops.md +48 -4
- package/.claude/agents/housekeeping.md +44 -7
- package/.claude/agents/qa-engineer.md +24 -11
- package/.claude/agents/researcher.md +26 -6
- package/.claude/agents/technical-writer.md +64 -7
- package/.claude/agents/ux-engineer.md +1 -0
- package/.claude/agents/verifier.md +63 -6
- package/.claude/commands/developer.md +2 -266
- package/.claude/commands/infra-engineer.md +92 -0
- package/.claude/commands/planner.md +98 -29
- package/.claude/commands/product-engineer.md +69 -11
- package/.claude/commands/researcher.md +4 -5
- package/.claude/commands/technical-writer.md +1 -1
- package/.claude/hooks/branch-guard.sh +30 -0
- package/.claude/hooks/git-guard.sh +573 -24
- package/.claude/skills/activity-codebase-research/SKILL.md +4 -11
- 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-refine/SKILL.md +75 -15
- package/.claude/skills/activity-test-standards/SKILL.md +25 -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 +61 -12
- package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.claude/skills/memo-cli-usage/SKILL.md +68 -13
- package/.claude/skills/plan/SKILL.md +43 -1
- package/.claude/skills/supabase-ops/SKILL.md +109 -0
- package/.github/agents/developer.agent.md +103 -38
- 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 +79 -10
- package/.github/agents/product-engineer.agent.md +69 -11
- package/.github/agents/qa-engineer.agent.md +23 -11
- package/.github/agents/researcher.agent.md +25 -6
- package/.github/agents/technical-writer.agent.md +63 -7
- package/.github/agents/verifier.agent.md +61 -5
- package/.github/instructions/implement.instructions.md +61 -12
- 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 +4 -5
- package/.github/prompts/technical-writer.prompt.md +1 -1
- package/.github/skills/activity-codebase-research/SKILL.md +4 -16
- 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-refine/SKILL.md +75 -15
- package/.github/skills/activity-test-standards/SKILL.md +25 -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 +68 -13
- package/.github/skills/supabase-ops/SKILL.md +104 -0
- package/.kiro/agents/developer.md +104 -39
- 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 +87 -21
- package/.kiro/agents/product-engineer.md +72 -14
- package/.kiro/agents/qa-engineer.md +24 -12
- package/.kiro/agents/researcher.md +26 -7
- package/.kiro/agents/technical-writer.md +66 -10
- package/.kiro/agents/verifier.md +62 -6
- package/.kiro/hooks/scripts/git-guard.sh +96 -10
- package/.kiro/skills/activity-codebase-research/SKILL.md +4 -11
- 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-refine/SKILL.md +75 -15
- package/.kiro/skills/activity-test-standards/SKILL.md +25 -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 +68 -13
- package/.kiro/skills/supabase-ops/SKILL.md +109 -0
- package/.kiro/steering/implement.md +61 -12
- package/.kiro/steering/plan.md +43 -1
- package/AGENTS.md +67 -114
- package/AGENTS.md.template +126 -0
- package/CHANGELOG.md +182 -0
- package/CLAUDE.md +25 -19
- package/CLAUDE.md.template +104 -0
- package/README.md +168 -146
- package/TESTING.md +84 -148
- 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/.claude/skills/activity-contract-validation/SKILL.md +0 -167
- package/.github/skills/activity-contract-validation/SKILL.md +0 -167
- package/.kiro/skills/activity-contract-validation/SKILL.md +0 -167
- 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,66 @@
|
|
|
1
|
+
# templates/workflows/deploy-prod.yml
|
|
2
|
+
#
|
|
3
|
+
# Consumer-owned production deploy workflow, delivered by infra-engineer via
|
|
4
|
+
# deploy-ops. Fires only on an exact-semver annotated release tag and runs
|
|
5
|
+
# behind the GitHub `production` environment, whose required reviewer stops the
|
|
6
|
+
# job until a human approves. It deploys by calling the canonical
|
|
7
|
+
# templates/scripts/deploy.sh prod — no inline aws/flyctl/supabase deploy logic.
|
|
8
|
+
#
|
|
9
|
+
# Prune the tool setup steps your target does not use when you scaffold this.
|
|
10
|
+
|
|
11
|
+
name: Deploy prod
|
|
12
|
+
|
|
13
|
+
on:
|
|
14
|
+
push:
|
|
15
|
+
tags:
|
|
16
|
+
- "v[0-9]+.[0-9]+.[0-9]+"
|
|
17
|
+
|
|
18
|
+
# OIDC for AWS role assumption; no long-lived cloud keys in the repo.
|
|
19
|
+
permissions:
|
|
20
|
+
contents: read
|
|
21
|
+
id-token: write
|
|
22
|
+
|
|
23
|
+
concurrency:
|
|
24
|
+
group: deploy-prod
|
|
25
|
+
cancel-in-progress: false
|
|
26
|
+
|
|
27
|
+
jobs:
|
|
28
|
+
deploy-prod:
|
|
29
|
+
name: Deploy production environment
|
|
30
|
+
runs-on: ubuntu-latest
|
|
31
|
+
# Required reviewer on this environment holds the job until a human approves.
|
|
32
|
+
environment: production
|
|
33
|
+
|
|
34
|
+
steps:
|
|
35
|
+
- name: Checkout repository
|
|
36
|
+
uses: actions/checkout@v4
|
|
37
|
+
with:
|
|
38
|
+
fetch-depth: 0 # scripts assert the tag is annotated and on main
|
|
39
|
+
|
|
40
|
+
# ── Tool setup (version-pinned; prune what you do not use) ──────────────
|
|
41
|
+
- name: Configure AWS credentials (OIDC)
|
|
42
|
+
uses: aws-actions/configure-aws-credentials@v4
|
|
43
|
+
with:
|
|
44
|
+
role-to-assume: ${{ secrets.AWS_DEPLOY_ROLE_ARN }}
|
|
45
|
+
aws-region: ${{ vars.AWS_REGION }}
|
|
46
|
+
|
|
47
|
+
- name: Set up flyctl
|
|
48
|
+
uses: superfly/flyctl-actions/setup-flyctl@v1
|
|
49
|
+
|
|
50
|
+
- name: Set up Supabase CLI
|
|
51
|
+
uses: supabase/setup-cli@v1
|
|
52
|
+
with:
|
|
53
|
+
version: latest
|
|
54
|
+
|
|
55
|
+
- name: Set up yq
|
|
56
|
+
uses: mikefarah/yq@v4
|
|
57
|
+
|
|
58
|
+
# ── Deploy via the canonical script only ────────────────────────────────
|
|
59
|
+
# The human-only guard requires INFRA_HUMAN_APPROVED=1; the protected
|
|
60
|
+
# environment reviewer approval is what authorizes this run.
|
|
61
|
+
- name: Deploy prod
|
|
62
|
+
env:
|
|
63
|
+
FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
|
|
64
|
+
SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
|
|
65
|
+
INFRA_HUMAN_APPROVED: "1"
|
|
66
|
+
run: bash templates/scripts/deploy.sh prod
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# templates/workflows/rollback.yml
|
|
2
|
+
#
|
|
3
|
+
# Consumer-owned rollback workflow, delivered by infra-engineer via deploy-ops.
|
|
4
|
+
# Dispatched on demand (workflow_dispatch) with an environment input, it rolls
|
|
5
|
+
# an environment back to its previous good version by calling the canonical
|
|
6
|
+
# templates/scripts/rollback.sh — no inline aws/flyctl/supabase logic.
|
|
7
|
+
#
|
|
8
|
+
# When the `environment` input names a production environment, the job runs
|
|
9
|
+
# behind the GitHub `production` environment reviewer. Prune the tool setup
|
|
10
|
+
# steps your target does not use when you scaffold this.
|
|
11
|
+
|
|
12
|
+
name: Rollback
|
|
13
|
+
|
|
14
|
+
on:
|
|
15
|
+
workflow_dispatch:
|
|
16
|
+
inputs:
|
|
17
|
+
environment:
|
|
18
|
+
description: "Environment to roll back (must exist in infra/environments.yaml)"
|
|
19
|
+
required: true
|
|
20
|
+
type: string
|
|
21
|
+
to_version:
|
|
22
|
+
description: "Optional explicit version to roll back to (defaults to previous good)"
|
|
23
|
+
required: false
|
|
24
|
+
type: string
|
|
25
|
+
|
|
26
|
+
permissions:
|
|
27
|
+
contents: read
|
|
28
|
+
id-token: write
|
|
29
|
+
|
|
30
|
+
concurrency:
|
|
31
|
+
group: rollback-${{ github.event.inputs.environment }}
|
|
32
|
+
cancel-in-progress: false
|
|
33
|
+
|
|
34
|
+
jobs:
|
|
35
|
+
rollback:
|
|
36
|
+
name: Roll back ${{ github.event.inputs.environment }}
|
|
37
|
+
runs-on: ubuntu-latest
|
|
38
|
+
# Rollbacks of production run behind the same reviewer gate as deploys.
|
|
39
|
+
environment: production
|
|
40
|
+
|
|
41
|
+
steps:
|
|
42
|
+
- name: Checkout repository
|
|
43
|
+
uses: actions/checkout@v4
|
|
44
|
+
with:
|
|
45
|
+
fetch-depth: 0 # rollback.sh resolves the previous good version from history
|
|
46
|
+
|
|
47
|
+
# ── Tool setup (version-pinned; prune what you do not use) ──────────────
|
|
48
|
+
- name: Configure AWS credentials (OIDC)
|
|
49
|
+
uses: aws-actions/configure-aws-credentials@v4
|
|
50
|
+
with:
|
|
51
|
+
role-to-assume: ${{ secrets.AWS_DEPLOY_ROLE_ARN }}
|
|
52
|
+
aws-region: ${{ vars.AWS_REGION }}
|
|
53
|
+
|
|
54
|
+
- name: Set up flyctl
|
|
55
|
+
uses: superfly/flyctl-actions/setup-flyctl@v1
|
|
56
|
+
|
|
57
|
+
- name: Set up Supabase CLI
|
|
58
|
+
uses: supabase/setup-cli@v1
|
|
59
|
+
with:
|
|
60
|
+
version: latest
|
|
61
|
+
|
|
62
|
+
- name: Set up yq
|
|
63
|
+
uses: mikefarah/yq@v4
|
|
64
|
+
|
|
65
|
+
# ── Roll back via the canonical script only ─────────────────────────────
|
|
66
|
+
- name: Roll back
|
|
67
|
+
env:
|
|
68
|
+
FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
|
|
69
|
+
SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
|
|
70
|
+
INFRA_HUMAN_APPROVED: "1"
|
|
71
|
+
ROLLBACK_TO_VERSION: ${{ github.event.inputs.to_version }}
|
|
72
|
+
run: |
|
|
73
|
+
if [ -n "${ROLLBACK_TO_VERSION}" ]; then
|
|
74
|
+
bash templates/scripts/rollback.sh "${{ github.event.inputs.environment }}" --to "${ROLLBACK_TO_VERSION}"
|
|
75
|
+
else
|
|
76
|
+
bash templates/scripts/rollback.sh "${{ github.event.inputs.environment }}"
|
|
77
|
+
fi
|
|
@@ -1,167 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: activity-contract-validation
|
|
3
|
-
description: "Validate API contracts against implementation using dt verify (contract-diff, impact, drift). Detects breaking changes, consumer impact, and spec-to-code staleness. Use when checking API boundary integrity."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Activity: Contract Validation
|
|
7
|
-
|
|
8
|
-
Detect API spec drift, breaking changes, and consumer impact using the `dt verify` family. This skill wires existing extraction and verification tooling into the QA path.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
> **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
|
|
13
|
-
|
|
14
|
-
## Goal
|
|
15
|
-
|
|
16
|
-
Detect misalignment between API specifications and implementation before it reaches consumers. Contract validation checks the boundary — it does not test internal behavior.
|
|
17
|
-
|
|
18
|
-
Consult `/TESTING.md` first. Its Contract Validation layer boundary governs.
|
|
19
|
-
|
|
20
|
-
## Contract Validation Boundary
|
|
21
|
-
|
|
22
|
-
- **MUST** validate the API boundary (endpoints, schemas, events) against the specification.
|
|
23
|
-
- **MUST NOT** test internal business logic — that belongs at Layer 1 or 2.
|
|
24
|
-
- **MUST NOT** require a running server — operates on static specs and source analysis.
|
|
25
|
-
- **MAY** complement live testing but is not a substitute for E2E.
|
|
26
|
-
|
|
27
|
-
## Part 1 — Prerequisite Detection
|
|
28
|
-
|
|
29
|
-
### Check `dt` availability
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
which dt && dt --version
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
- If `dt` is not found: emit `SKIPPED(dt not installed)` and provide manual instructions.
|
|
36
|
-
- If `dt` is found but not configured for the repo: emit `SKIPPED(dt not configured — run dt init)`.
|
|
37
|
-
|
|
38
|
-
### Detect API specifications
|
|
39
|
-
|
|
40
|
-
Search the repository for:
|
|
41
|
-
|
|
42
|
-
- `openapi.yaml`, `openapi.json`, `swagger.yaml`, `swagger.json` (or under `docs/`, `api/`, `specs/`)
|
|
43
|
-
- `asyncapi.yaml`, `asyncapi.json`
|
|
44
|
-
- `component.json` (dt-managed extraction output)
|
|
45
|
-
|
|
46
|
-
If no specs found: emit `SKIPPED(no OpenAPI or AsyncAPI spec found in repository)`.
|
|
47
|
-
|
|
48
|
-
## Part 2 — Contract Diff (Breaking Change Detection)
|
|
49
|
-
|
|
50
|
-
Run against the base branch to detect breaking changes introduced by the current work:
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
dt verify contract-diff --base origin/main --head HEAD
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### Findings classification
|
|
57
|
-
|
|
58
|
-
| Exit code | Meaning | Severity |
|
|
59
|
-
| --------- | ------------------------- | -------- |
|
|
60
|
-
| 0 | No breaking changes | — |
|
|
61
|
-
| 8 | Breaking changes detected | Critical |
|
|
62
|
-
| 1 | Execution error | Blocked |
|
|
63
|
-
|
|
64
|
-
### Report format
|
|
65
|
-
|
|
66
|
-
For each breaking change found:
|
|
67
|
-
|
|
68
|
-
```markdown
|
|
69
|
-
| Finding | Severity | Path | Description |
|
|
70
|
-
| ------- | -------- | ------------------------------- | ------------------------------------------ |
|
|
71
|
-
| BREAK-1 | critical | POST /api/orders → request body | Required field `customerId` removed |
|
|
72
|
-
| BREAK-2 | major | GET /api/users → response | Field `email` type changed string → object |
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
## Part 3 — Impact Analysis (Consumer Enumeration)
|
|
76
|
-
|
|
77
|
-
When breaking changes are detected, identify affected consumers:
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
dt verify impact --contract <contract-id>
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
Report:
|
|
84
|
-
|
|
85
|
-
- List of consumers that depend on the changed contract.
|
|
86
|
-
- Per consumer: which endpoints/events they consume.
|
|
87
|
-
- Recommendation: notify consumers, or validate with consumer-driven tests.
|
|
88
|
-
|
|
89
|
-
## Part 4 — Drift Detection (Spec-to-Implementation Staleness)
|
|
90
|
-
|
|
91
|
-
Check whether the specification and implementation have diverged:
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
dt verify drift [--id <component-id>]
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### Drift types
|
|
98
|
-
|
|
99
|
-
| Type | Description | Severity |
|
|
100
|
-
| --------------- | ----------------------------------------------- | -------- |
|
|
101
|
-
| Spec-ahead | Spec documents endpoints not in code | Major |
|
|
102
|
-
| Code-ahead | Code has endpoints not in spec | Major |
|
|
103
|
-
| Stale | Spec not updated in >90 days while code changed | Minor |
|
|
104
|
-
| Schema-mismatch | Response shape differs from spec | Critical |
|
|
105
|
-
|
|
106
|
-
### Report format
|
|
107
|
-
|
|
108
|
-
Same risk-ranked table format as `activity-coverage-gap-analysis`:
|
|
109
|
-
|
|
110
|
-
```markdown
|
|
111
|
-
| Finding | Severity | Component | Description | Days since spec update |
|
|
112
|
-
| ------- | -------- | ------------ | ---------------------------------------------- | ---------------------- |
|
|
113
|
-
| DRIFT-1 | critical | api-gateway | Response schema mismatch: /api/orders | — |
|
|
114
|
-
| DRIFT-2 | major | api-gateway | 12 endpoints in code, 8 in spec | — |
|
|
115
|
-
| DRIFT-3 | minor | auth-service | Spec unchanged 120 days, 14 code commits since | 120 |
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
## Part 5 — Integration with Coverage Gate
|
|
119
|
-
|
|
120
|
-
Contract validation findings **MUST** be reported alongside coverage in the `coverage_gate` path:
|
|
121
|
-
|
|
122
|
-
- Breaking changes → block completion (critical findings).
|
|
123
|
-
- Drift findings → report but do not block (route to follow-up or drift-reconciliation).
|
|
124
|
-
- No spec found → skip with reason (does not count as a gap).
|
|
125
|
-
|
|
126
|
-
### Aggregated output
|
|
127
|
-
|
|
128
|
-
```markdown
|
|
129
|
-
## Contract Validation Summary
|
|
130
|
-
|
|
131
|
-
- **Spec detected:** OpenAPI 3.1 at `api/openapi.yaml`
|
|
132
|
-
- **Breaking changes:** 0 | **Drift findings:** 2 | **Impact:** N/A
|
|
133
|
-
- **Status:** PASS (no breaking changes)
|
|
134
|
-
|
|
135
|
-
### Drift Findings (non-blocking)
|
|
136
|
-
|
|
137
|
-
| ... |
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
## Fallback — Manual Validation
|
|
141
|
-
|
|
142
|
-
When `dt` is not installed, provide these manual steps:
|
|
143
|
-
|
|
144
|
-
1. **Diff specs manually:** compare `api/openapi.yaml` across branches.
|
|
145
|
-
2. **Check for undocumented endpoints:** search route handlers not in the spec.
|
|
146
|
-
3. **Schema validation:** run `npx @redocly/cli lint api/openapi.yaml` or equivalent.
|
|
147
|
-
4. **Consumer notification:** manually identify consumers from project documentation.
|
|
148
|
-
|
|
149
|
-
## Output
|
|
150
|
-
|
|
151
|
-
- `dt` availability status
|
|
152
|
-
- Spec detection result (type, path, version)
|
|
153
|
-
- Breaking changes (count, details, severity)
|
|
154
|
-
- Consumer impact (when applicable)
|
|
155
|
-
- Drift findings (count, details, severity, days since update)
|
|
156
|
-
- Aggregated status for `coverage_gate` integration
|
|
157
|
-
- Manual fallback instructions (when `dt` unavailable)
|
|
158
|
-
|
|
159
|
-
## Final Instructions
|
|
160
|
-
|
|
161
|
-
1. You **MUST** check `dt` availability before attempting verification.
|
|
162
|
-
2. You **MUST** emit `SKIPPED` with a reason when prerequisites are missing.
|
|
163
|
-
3. You **MUST** classify findings by severity using the tables above.
|
|
164
|
-
4. You **MUST** report breaking changes as critical findings that block completion.
|
|
165
|
-
5. You **MUST** report drift as non-blocking findings for follow-up.
|
|
166
|
-
6. You **MUST NOT** test internal business logic — contract validation is boundary-only.
|
|
167
|
-
7. You **MUST NOT** install `dt` or any dependency — detect and recommend only.
|
|
@@ -1,167 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: activity-contract-validation
|
|
3
|
-
description: "Validate API contracts against implementation using dt verify (contract-diff, impact, drift). Detects breaking changes, consumer impact, and spec-to-code staleness. Use when checking API boundary integrity."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Activity: Contract Validation
|
|
7
|
-
|
|
8
|
-
Detect API spec drift, breaking changes, and consumer impact using the `dt verify` family. This skill wires existing extraction and verification tooling into the QA path.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
> **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
|
|
13
|
-
|
|
14
|
-
## Goal
|
|
15
|
-
|
|
16
|
-
Detect misalignment between API specifications and implementation before it reaches consumers. Contract validation checks the boundary — it does not test internal behavior.
|
|
17
|
-
|
|
18
|
-
Consult `/TESTING.md` first. Its Contract Validation layer boundary governs.
|
|
19
|
-
|
|
20
|
-
## Contract Validation Boundary
|
|
21
|
-
|
|
22
|
-
- **MUST** validate the API boundary (endpoints, schemas, events) against the specification.
|
|
23
|
-
- **MUST NOT** test internal business logic — that belongs at Layer 1 or 2.
|
|
24
|
-
- **MUST NOT** require a running server — operates on static specs and source analysis.
|
|
25
|
-
- **MAY** complement live testing but is not a substitute for E2E.
|
|
26
|
-
|
|
27
|
-
## Part 1 — Prerequisite Detection
|
|
28
|
-
|
|
29
|
-
### Check `dt` availability
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
which dt && dt --version
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
- If `dt` is not found: emit `SKIPPED(dt not installed)` and provide manual instructions.
|
|
36
|
-
- If `dt` is found but not configured for the repo: emit `SKIPPED(dt not configured — run dt init)`.
|
|
37
|
-
|
|
38
|
-
### Detect API specifications
|
|
39
|
-
|
|
40
|
-
Search the repository for:
|
|
41
|
-
|
|
42
|
-
- `openapi.yaml`, `openapi.json`, `swagger.yaml`, `swagger.json` (or under `docs/`, `api/`, `specs/`)
|
|
43
|
-
- `asyncapi.yaml`, `asyncapi.json`
|
|
44
|
-
- `component.json` (dt-managed extraction output)
|
|
45
|
-
|
|
46
|
-
If no specs found: emit `SKIPPED(no OpenAPI or AsyncAPI spec found in repository)`.
|
|
47
|
-
|
|
48
|
-
## Part 2 — Contract Diff (Breaking Change Detection)
|
|
49
|
-
|
|
50
|
-
Run against the base branch to detect breaking changes introduced by the current work:
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
dt verify contract-diff --base origin/main --head HEAD
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### Findings classification
|
|
57
|
-
|
|
58
|
-
| Exit code | Meaning | Severity |
|
|
59
|
-
| --------- | ------------------------- | -------- |
|
|
60
|
-
| 0 | No breaking changes | — |
|
|
61
|
-
| 8 | Breaking changes detected | Critical |
|
|
62
|
-
| 1 | Execution error | Blocked |
|
|
63
|
-
|
|
64
|
-
### Report format
|
|
65
|
-
|
|
66
|
-
For each breaking change found:
|
|
67
|
-
|
|
68
|
-
```markdown
|
|
69
|
-
| Finding | Severity | Path | Description |
|
|
70
|
-
| ------- | -------- | ------------------------------- | ------------------------------------------ |
|
|
71
|
-
| BREAK-1 | critical | POST /api/orders → request body | Required field `customerId` removed |
|
|
72
|
-
| BREAK-2 | major | GET /api/users → response | Field `email` type changed string → object |
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
## Part 3 — Impact Analysis (Consumer Enumeration)
|
|
76
|
-
|
|
77
|
-
When breaking changes are detected, identify affected consumers:
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
dt verify impact --contract <contract-id>
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
Report:
|
|
84
|
-
|
|
85
|
-
- List of consumers that depend on the changed contract.
|
|
86
|
-
- Per consumer: which endpoints/events they consume.
|
|
87
|
-
- Recommendation: notify consumers, or validate with consumer-driven tests.
|
|
88
|
-
|
|
89
|
-
## Part 4 — Drift Detection (Spec-to-Implementation Staleness)
|
|
90
|
-
|
|
91
|
-
Check whether the specification and implementation have diverged:
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
dt verify drift [--id <component-id>]
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### Drift types
|
|
98
|
-
|
|
99
|
-
| Type | Description | Severity |
|
|
100
|
-
| --------------- | ----------------------------------------------- | -------- |
|
|
101
|
-
| Spec-ahead | Spec documents endpoints not in code | Major |
|
|
102
|
-
| Code-ahead | Code has endpoints not in spec | Major |
|
|
103
|
-
| Stale | Spec not updated in >90 days while code changed | Minor |
|
|
104
|
-
| Schema-mismatch | Response shape differs from spec | Critical |
|
|
105
|
-
|
|
106
|
-
### Report format
|
|
107
|
-
|
|
108
|
-
Same risk-ranked table format as `activity-coverage-gap-analysis`:
|
|
109
|
-
|
|
110
|
-
```markdown
|
|
111
|
-
| Finding | Severity | Component | Description | Days since spec update |
|
|
112
|
-
| ------- | -------- | ------------ | ---------------------------------------------- | ---------------------- |
|
|
113
|
-
| DRIFT-1 | critical | api-gateway | Response schema mismatch: /api/orders | — |
|
|
114
|
-
| DRIFT-2 | major | api-gateway | 12 endpoints in code, 8 in spec | — |
|
|
115
|
-
| DRIFT-3 | minor | auth-service | Spec unchanged 120 days, 14 code commits since | 120 |
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
## Part 5 — Integration with Coverage Gate
|
|
119
|
-
|
|
120
|
-
Contract validation findings **MUST** be reported alongside coverage in the `coverage_gate` path:
|
|
121
|
-
|
|
122
|
-
- Breaking changes → block completion (critical findings).
|
|
123
|
-
- Drift findings → report but do not block (route to follow-up or drift-reconciliation).
|
|
124
|
-
- No spec found → skip with reason (does not count as a gap).
|
|
125
|
-
|
|
126
|
-
### Aggregated output
|
|
127
|
-
|
|
128
|
-
```markdown
|
|
129
|
-
## Contract Validation Summary
|
|
130
|
-
|
|
131
|
-
- **Spec detected:** OpenAPI 3.1 at `api/openapi.yaml`
|
|
132
|
-
- **Breaking changes:** 0 | **Drift findings:** 2 | **Impact:** N/A
|
|
133
|
-
- **Status:** PASS (no breaking changes)
|
|
134
|
-
|
|
135
|
-
### Drift Findings (non-blocking)
|
|
136
|
-
|
|
137
|
-
| ... |
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
## Fallback — Manual Validation
|
|
141
|
-
|
|
142
|
-
When `dt` is not installed, provide these manual steps:
|
|
143
|
-
|
|
144
|
-
1. **Diff specs manually:** compare `api/openapi.yaml` across branches.
|
|
145
|
-
2. **Check for undocumented endpoints:** search route handlers not in the spec.
|
|
146
|
-
3. **Schema validation:** run `npx @redocly/cli lint api/openapi.yaml` or equivalent.
|
|
147
|
-
4. **Consumer notification:** manually identify consumers from project documentation.
|
|
148
|
-
|
|
149
|
-
## Output
|
|
150
|
-
|
|
151
|
-
- `dt` availability status
|
|
152
|
-
- Spec detection result (type, path, version)
|
|
153
|
-
- Breaking changes (count, details, severity)
|
|
154
|
-
- Consumer impact (when applicable)
|
|
155
|
-
- Drift findings (count, details, severity, days since update)
|
|
156
|
-
- Aggregated status for `coverage_gate` integration
|
|
157
|
-
- Manual fallback instructions (when `dt` unavailable)
|
|
158
|
-
|
|
159
|
-
## Final Instructions
|
|
160
|
-
|
|
161
|
-
1. You **MUST** check `dt` availability before attempting verification.
|
|
162
|
-
2. You **MUST** emit `SKIPPED` with a reason when prerequisites are missing.
|
|
163
|
-
3. You **MUST** classify findings by severity using the tables above.
|
|
164
|
-
4. You **MUST** report breaking changes as critical findings that block completion.
|
|
165
|
-
5. You **MUST** report drift as non-blocking findings for follow-up.
|
|
166
|
-
6. You **MUST NOT** test internal business logic — contract validation is boundary-only.
|
|
167
|
-
7. You **MUST NOT** install `dt` or any dependency — detect and recommend only.
|
|
@@ -1,167 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: activity-contract-validation
|
|
3
|
-
description: "Validate API contracts against implementation using dt verify (contract-diff, impact, drift). Detects breaking changes, consumer impact, and spec-to-code staleness. Use when checking API boundary integrity."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Activity: Contract Validation
|
|
7
|
-
|
|
8
|
-
Detect API spec drift, breaking changes, and consumer impact using the `dt verify` family. This skill wires existing extraction and verification tooling into the QA path.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
> **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
|
|
13
|
-
|
|
14
|
-
## Goal
|
|
15
|
-
|
|
16
|
-
Detect misalignment between API specifications and implementation before it reaches consumers. Contract validation checks the boundary — it does not test internal behavior.
|
|
17
|
-
|
|
18
|
-
Consult `/TESTING.md` first. Its Contract Validation layer boundary governs.
|
|
19
|
-
|
|
20
|
-
## Contract Validation Boundary
|
|
21
|
-
|
|
22
|
-
- **MUST** validate the API boundary (endpoints, schemas, events) against the specification.
|
|
23
|
-
- **MUST NOT** test internal business logic — that belongs at Layer 1 or 2.
|
|
24
|
-
- **MUST NOT** require a running server — operates on static specs and source analysis.
|
|
25
|
-
- **MAY** complement live testing but is not a substitute for E2E.
|
|
26
|
-
|
|
27
|
-
## Part 1 — Prerequisite Detection
|
|
28
|
-
|
|
29
|
-
### Check `dt` availability
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
which dt && dt --version
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
- If `dt` is not found: emit `SKIPPED(dt not installed)` and provide manual instructions.
|
|
36
|
-
- If `dt` is found but not configured for the repo: emit `SKIPPED(dt not configured — run dt init)`.
|
|
37
|
-
|
|
38
|
-
### Detect API specifications
|
|
39
|
-
|
|
40
|
-
Search the repository for:
|
|
41
|
-
|
|
42
|
-
- `openapi.yaml`, `openapi.json`, `swagger.yaml`, `swagger.json` (or under `docs/`, `api/`, `specs/`)
|
|
43
|
-
- `asyncapi.yaml`, `asyncapi.json`
|
|
44
|
-
- `component.json` (dt-managed extraction output)
|
|
45
|
-
|
|
46
|
-
If no specs found: emit `SKIPPED(no OpenAPI or AsyncAPI spec found in repository)`.
|
|
47
|
-
|
|
48
|
-
## Part 2 — Contract Diff (Breaking Change Detection)
|
|
49
|
-
|
|
50
|
-
Run against the base branch to detect breaking changes introduced by the current work:
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
dt verify contract-diff --base origin/main --head HEAD
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### Findings classification
|
|
57
|
-
|
|
58
|
-
| Exit code | Meaning | Severity |
|
|
59
|
-
| --------- | ------------------------- | -------- |
|
|
60
|
-
| 0 | No breaking changes | — |
|
|
61
|
-
| 8 | Breaking changes detected | Critical |
|
|
62
|
-
| 1 | Execution error | Blocked |
|
|
63
|
-
|
|
64
|
-
### Report format
|
|
65
|
-
|
|
66
|
-
For each breaking change found:
|
|
67
|
-
|
|
68
|
-
```markdown
|
|
69
|
-
| Finding | Severity | Path | Description |
|
|
70
|
-
| ------- | -------- | ------------------------------- | ------------------------------------------ |
|
|
71
|
-
| BREAK-1 | critical | POST /api/orders → request body | Required field `customerId` removed |
|
|
72
|
-
| BREAK-2 | major | GET /api/users → response | Field `email` type changed string → object |
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
## Part 3 — Impact Analysis (Consumer Enumeration)
|
|
76
|
-
|
|
77
|
-
When breaking changes are detected, identify affected consumers:
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
dt verify impact --contract <contract-id>
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
Report:
|
|
84
|
-
|
|
85
|
-
- List of consumers that depend on the changed contract.
|
|
86
|
-
- Per consumer: which endpoints/events they consume.
|
|
87
|
-
- Recommendation: notify consumers, or validate with consumer-driven tests.
|
|
88
|
-
|
|
89
|
-
## Part 4 — Drift Detection (Spec-to-Implementation Staleness)
|
|
90
|
-
|
|
91
|
-
Check whether the specification and implementation have diverged:
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
dt verify drift [--id <component-id>]
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### Drift types
|
|
98
|
-
|
|
99
|
-
| Type | Description | Severity |
|
|
100
|
-
| --------------- | ----------------------------------------------- | -------- |
|
|
101
|
-
| Spec-ahead | Spec documents endpoints not in code | Major |
|
|
102
|
-
| Code-ahead | Code has endpoints not in spec | Major |
|
|
103
|
-
| Stale | Spec not updated in >90 days while code changed | Minor |
|
|
104
|
-
| Schema-mismatch | Response shape differs from spec | Critical |
|
|
105
|
-
|
|
106
|
-
### Report format
|
|
107
|
-
|
|
108
|
-
Same risk-ranked table format as `activity-coverage-gap-analysis`:
|
|
109
|
-
|
|
110
|
-
```markdown
|
|
111
|
-
| Finding | Severity | Component | Description | Days since spec update |
|
|
112
|
-
| ------- | -------- | ------------ | ---------------------------------------------- | ---------------------- |
|
|
113
|
-
| DRIFT-1 | critical | api-gateway | Response schema mismatch: /api/orders | — |
|
|
114
|
-
| DRIFT-2 | major | api-gateway | 12 endpoints in code, 8 in spec | — |
|
|
115
|
-
| DRIFT-3 | minor | auth-service | Spec unchanged 120 days, 14 code commits since | 120 |
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
## Part 5 — Integration with Coverage Gate
|
|
119
|
-
|
|
120
|
-
Contract validation findings **MUST** be reported alongside coverage in the `coverage_gate` path:
|
|
121
|
-
|
|
122
|
-
- Breaking changes → block completion (critical findings).
|
|
123
|
-
- Drift findings → report but do not block (route to follow-up or drift-reconciliation).
|
|
124
|
-
- No spec found → skip with reason (does not count as a gap).
|
|
125
|
-
|
|
126
|
-
### Aggregated output
|
|
127
|
-
|
|
128
|
-
```markdown
|
|
129
|
-
## Contract Validation Summary
|
|
130
|
-
|
|
131
|
-
- **Spec detected:** OpenAPI 3.1 at `api/openapi.yaml`
|
|
132
|
-
- **Breaking changes:** 0 | **Drift findings:** 2 | **Impact:** N/A
|
|
133
|
-
- **Status:** PASS (no breaking changes)
|
|
134
|
-
|
|
135
|
-
### Drift Findings (non-blocking)
|
|
136
|
-
|
|
137
|
-
| ... |
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
## Fallback — Manual Validation
|
|
141
|
-
|
|
142
|
-
When `dt` is not installed, provide these manual steps:
|
|
143
|
-
|
|
144
|
-
1. **Diff specs manually:** compare `api/openapi.yaml` across branches.
|
|
145
|
-
2. **Check for undocumented endpoints:** search route handlers not in the spec.
|
|
146
|
-
3. **Schema validation:** run `npx @redocly/cli lint api/openapi.yaml` or equivalent.
|
|
147
|
-
4. **Consumer notification:** manually identify consumers from project documentation.
|
|
148
|
-
|
|
149
|
-
## Output
|
|
150
|
-
|
|
151
|
-
- `dt` availability status
|
|
152
|
-
- Spec detection result (type, path, version)
|
|
153
|
-
- Breaking changes (count, details, severity)
|
|
154
|
-
- Consumer impact (when applicable)
|
|
155
|
-
- Drift findings (count, details, severity, days since update)
|
|
156
|
-
- Aggregated status for `coverage_gate` integration
|
|
157
|
-
- Manual fallback instructions (when `dt` unavailable)
|
|
158
|
-
|
|
159
|
-
## Final Instructions
|
|
160
|
-
|
|
161
|
-
1. You **MUST** check `dt` availability before attempting verification.
|
|
162
|
-
2. You **MUST** emit `SKIPPED` with a reason when prerequisites are missing.
|
|
163
|
-
3. You **MUST** classify findings by severity using the tables above.
|
|
164
|
-
4. You **MUST** report breaking changes as critical findings that block completion.
|
|
165
|
-
5. You **MUST** report drift as non-blocking findings for follow-up.
|
|
166
|
-
6. You **MUST NOT** test internal business logic — contract validation is boundary-only.
|
|
167
|
-
7. You **MUST NOT** install `dt` or any dependency — detect and recommend only.
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* CLI handler for `dt catalog build --registry <path> [--concurrency 8] [--json]`.
|
|
3
|
-
*
|
|
4
|
-
* Aggregates component manifests from a registry and generates catalog/index.yaml.
|
|
5
|
-
* Idempotent: nothing written when nothing changed.
|
|
6
|
-
* Exit codes: 0 = success, 3 = partial failure (some repos errored).
|
|
7
|
-
*/
|
|
8
|
-
export interface CatalogBuildOptions {
|
|
9
|
-
json: boolean;
|
|
10
|
-
registry?: string;
|
|
11
|
-
concurrency?: number;
|
|
12
|
-
catalogDir?: string;
|
|
13
|
-
}
|
|
14
|
-
export interface CatalogBuildOutput {
|
|
15
|
-
success: boolean;
|
|
16
|
-
written: boolean;
|
|
17
|
-
components_count: number;
|
|
18
|
-
errors_count: number;
|
|
19
|
-
errors: Array<{
|
|
20
|
-
repo: string;
|
|
21
|
-
error: string;
|
|
22
|
-
}>;
|
|
23
|
-
generated_at: string;
|
|
24
|
-
}
|
|
25
|
-
/**
|
|
26
|
-
* Run the `dt catalog build` command.
|
|
27
|
-
* Returns the process exit code: 0 if all repos succeeded, 3 if partial failure.
|
|
28
|
-
*/
|
|
29
|
-
export declare function runCatalogBuild(options: CatalogBuildOptions): Promise<number>;
|
|
30
|
-
//# sourceMappingURL=catalog-build.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"catalog-build.d.ts","sourceRoot":"","sources":["../../../adapters/cli/catalog-build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDnF"}
|