@llipe.com/dev-tasks 0.11.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 +105 -43
- 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 +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 +44 -23
- package/.claude/commands/product-engineer.md +21 -9
- 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 +483 -22
- 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 +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 +70 -19
- 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 +25 -4
- package/.github/agents/product-engineer.agent.md +21 -9
- package/.github/agents/qa-engineer.agent.md +23 -11
- package/.github/agents/researcher.agent.md +25 -6
- 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 +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 +66 -13
- package/.github/skills/supabase-ops/SKILL.md +104 -0
- package/.kiro/agents/developer.md +71 -20
- 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 +33 -15
- package/.kiro/agents/product-engineer.md +24 -12
- package/.kiro/agents/qa-engineer.md +24 -12
- package/.kiro/agents/researcher.md +26 -7
- package/.kiro/agents/technical-writer.md +63 -9
- package/.kiro/agents/verifier.md +47 -6
- 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 +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 +60 -109
- package/AGENTS.md.template +124 -0
- package/CHANGELOG.md +163 -0
- package/CLAUDE.md +23 -18
- package/CLAUDE.md.template +103 -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,155 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: aws-ops
|
|
3
|
+
description: "AWS CLI command sets, resource tiers, cost inputs, backup and revert sources, and log table for infra-engineer. Use when planning or applying AWS infrastructure changes."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# AWS Operations (aws-ops)
|
|
7
|
+
|
|
8
|
+
Per-surface mechanism skill for `infra-engineer`. It supplies the AWS CLI command sets, resource tiers, cost inputs, backup and revert sources, and the AWS log table. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body. AWS has no native plan, so this skill provides the synthesized plan inputs: discovery commands, the delta, and the exact forward and revert commands per change kind.
|
|
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
|
+
## Tool declaration
|
|
15
|
+
|
|
16
|
+
| Field | Value |
|
|
17
|
+
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
18
|
+
| `name` | `aws` |
|
|
19
|
+
| `probe` | `aws --version` (expects `aws-cli/2.x`) |
|
|
20
|
+
| `floor` | AWS CLI `2.15` minimum; major `2.x` REQUIRED. A `1.x` install is `below-floor`. |
|
|
21
|
+
| `auth_probe` | `aws sts get-caller-identity --output json` |
|
|
22
|
+
| `remediation` | "Install AWS CLI v2 (`2.15`+) from the AWS docs and run `aws configure` or set a named profile; this skill never auto-installs and offers no v1 fallback." |
|
|
23
|
+
|
|
24
|
+
Any non-`ok` tool-check result blocks the phase with the remediation string. All parseable output uses `--output json`. Identity is asserted by comparing `Account` from `sts get-caller-identity` with the target environment's `aws.account_id`; a mismatch is `wrong-identity` and blocks.
|
|
25
|
+
|
|
26
|
+
## Resource tiers
|
|
27
|
+
|
|
28
|
+
| Tier | AWS resources |
|
|
29
|
+
| --------------- | --------------------------------------------------------------------------------------------------------------- |
|
|
30
|
+
| **foundation** | VPC, subnets, route tables, internet/NAT gateways, ECS cluster, ECR registry, IAM roles/trust, KMS keys |
|
|
31
|
+
| **application** | ECS service, task definition, target group, security group, Secrets Manager secret, ACM certificate, DNS record |
|
|
32
|
+
|
|
33
|
+
Foundation resources are **discovery-only**: this skill provides no apply commands for them. A foundation change is routed to the environment's `tier0_tool` (cdk, terraform, cloudformation) with `status: routed-to-<tool>`; the agent never writes foundation resources directly.
|
|
34
|
+
|
|
35
|
+
## Command sets per change kind
|
|
36
|
+
|
|
37
|
+
Every command references secrets by ARN or name, never by value. Forward and revert are paired so `rollback.sh` can be generated.
|
|
38
|
+
|
|
39
|
+
### Discover (read-only)
|
|
40
|
+
|
|
41
|
+
```sh
|
|
42
|
+
aws sts get-caller-identity --output json
|
|
43
|
+
aws ecs list-clusters --output json
|
|
44
|
+
aws ecs list-services --cluster "$CLUSTER" --output json
|
|
45
|
+
aws ecs describe-services --cluster "$CLUSTER" --services "$SVC" --output json
|
|
46
|
+
aws ecr describe-repositories --output json
|
|
47
|
+
aws elbv2 describe-target-groups --output json
|
|
48
|
+
aws elbv2 describe-target-health --target-group-arn "$TG_ARN" --output json
|
|
49
|
+
aws iam list-attached-role-policies --role-name "$ROLE" --output json
|
|
50
|
+
aws secretsmanager list-secrets --output json
|
|
51
|
+
aws acm list-certificates --output json
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### Build and push image (ECR)
|
|
55
|
+
|
|
56
|
+
- Forward:
|
|
57
|
+
```sh
|
|
58
|
+
aws ecr get-login-password --region "$REGION" | docker login --username AWS --password-stdin "$ACCOUNT.dkr.ecr.$REGION.amazonaws.com"
|
|
59
|
+
docker build -t "$REPO:$TAG" .
|
|
60
|
+
docker push "$ACCOUNT.dkr.ecr.$REGION.amazonaws.com/$REPO:$TAG"
|
|
61
|
+
```
|
|
62
|
+
- Revert: redeploy the previous image tag (see ECS below); images are immutable, so no delete is required for revert.
|
|
63
|
+
|
|
64
|
+
### Create and update ECS service and task definition
|
|
65
|
+
|
|
66
|
+
- Forward:
|
|
67
|
+
```sh
|
|
68
|
+
aws ecs register-task-definition --cli-input-json file://taskdef.json --output json
|
|
69
|
+
aws ecs update-service --cluster "$CLUSTER" --service "$SVC" --task-definition "$FAMILY:$REV" --output json
|
|
70
|
+
```
|
|
71
|
+
- Verify: `aws ecs describe-services --cluster "$CLUSTER" --services "$SVC" --query 'services[0].deployments' --output json` shows the new revision `PRIMARY` and `runningCount == desiredCount`.
|
|
72
|
+
- Revert: `aws ecs update-service --cluster "$CLUSTER" --service "$SVC" --task-definition "$FAMILY:$PREV_REV"` using the **previous task definition revision** recorded before the change.
|
|
73
|
+
|
|
74
|
+
### IAM policy create and attach
|
|
75
|
+
|
|
76
|
+
- Forward:
|
|
77
|
+
```sh
|
|
78
|
+
aws iam create-policy --policy-name "$NAME" --policy-document file://policy.json --output json
|
|
79
|
+
aws iam attach-role-policy --role-name "$ROLE" --policy-arn "$POLICY_ARN"
|
|
80
|
+
```
|
|
81
|
+
- Verify: `aws iam list-attached-role-policies --role-name "$ROLE"` includes the ARN.
|
|
82
|
+
- Revert (reverse order): `aws iam detach-role-policy --role-name "$ROLE" --policy-arn "$POLICY_ARN"` then `aws iam delete-policy --policy-arn "$POLICY_ARN"`.
|
|
83
|
+
|
|
84
|
+
### Secrets Manager (reference by ARN)
|
|
85
|
+
|
|
86
|
+
- Forward: `aws secretsmanager create-secret --name "$NAME" --secret-string file://value.json` or `put-secret-value`. Consumers reference the secret by its ARN in task definitions; the value is never read into a shell variable that is later echoed.
|
|
87
|
+
- Revert: `aws secretsmanager delete-secret --secret-id "$ARN" --recovery-window-in-days 7` (recoverable) or restore the prior version by `put-secret-value` from the source of truth, never from a transcript.
|
|
88
|
+
|
|
89
|
+
### ACM certificate request and DNS validation
|
|
90
|
+
|
|
91
|
+
- Forward:
|
|
92
|
+
```sh
|
|
93
|
+
aws acm request-certificate --domain-name "$FQDN" --validation-method DNS --output json
|
|
94
|
+
aws acm describe-certificate --certificate-arn "$CERT_ARN" --query 'Certificate.DomainValidationOptions' --output json
|
|
95
|
+
```
|
|
96
|
+
DNS validation records are added through the Cloudflare DNS step in the agent body.
|
|
97
|
+
- Revert: `aws acm delete-certificate --certificate-arn "$CERT_ARN"` once no listener references it.
|
|
98
|
+
|
|
99
|
+
### ALB target health and CloudWatch retention
|
|
100
|
+
|
|
101
|
+
```sh
|
|
102
|
+
aws elbv2 describe-target-health --target-group-arn "$TG_ARN" --output json
|
|
103
|
+
aws logs put-retention-policy --log-group-name "$LG" --retention-in-days 30
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
## Cost estimation
|
|
107
|
+
|
|
108
|
+
`plan.md` lists each resource with a monthly estimate and its source (the AWS pricing page URL or a `aws pricing get-products` call). The always-relevant cost list is stated on every AWS plan even when zero:
|
|
109
|
+
|
|
110
|
+
- **NAT gateway** — hourly + per-GB processing.
|
|
111
|
+
- **Application Load Balancer** — hourly + LCU.
|
|
112
|
+
- **RDS instance** — instance-hours + storage + backups.
|
|
113
|
+
- **EC2 / Fargate capacity** — vCPU and memory hours.
|
|
114
|
+
- **Interface VPC endpoints** — hourly per AZ + per-GB.
|
|
115
|
+
|
|
116
|
+
Any resource at or above the environment cost threshold is marked `APPROVAL REQUIRED` and approved by name.
|
|
117
|
+
|
|
118
|
+
## Backup commands and revert sources
|
|
119
|
+
|
|
120
|
+
| Change kind | Backup command (production, touches state) | Revert source |
|
|
121
|
+
| ---------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------- |
|
|
122
|
+
| RDS schema/data | `aws rds create-db-snapshot --db-instance-identifier "$DB" --db-snapshot-identifier "$SNAP"` | Restore snapshot to a new instance |
|
|
123
|
+
| S3 object change | Confirm versioning: `aws s3api get-bucket-versioning --bucket "$B"`; require `Enabled` before overwrite | Previous object version id |
|
|
124
|
+
| ECS deploy | Record current task definition revision | **Previous task definition revision** |
|
|
125
|
+
| Image deploy | Record current image tag | **Previous image tag** |
|
|
126
|
+
|
|
127
|
+
A production step with `touches state: yes` records the backup id and restore command in `result.md` before it applies.
|
|
128
|
+
|
|
129
|
+
## AWS log table
|
|
130
|
+
|
|
131
|
+
Every query is time-bounded and its output passes through the redaction pattern set before it reaches a transcript or file.
|
|
132
|
+
|
|
133
|
+
| Source | Command |
|
|
134
|
+
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
135
|
+
| CloudWatch Logs | `aws logs tail "$LG" --since "$START" --format short` |
|
|
136
|
+
| ECS task failure | `aws ecs describe-tasks --cluster "$CLUSTER" --tasks "$TASK" --query 'tasks[0].stoppedReason'` |
|
|
137
|
+
| ALB access logs | Query the S3 access-log prefix for the bounded window |
|
|
138
|
+
| Logs Insights | `aws logs start-query --log-group-name "$LG" --start-time "$S" --end-time "$E" --query-string ...` with a **bounded window** and stated scan scope before the billed query |
|
|
139
|
+
| VPC Flow Logs | Filtered by ENI and the bounded window |
|
|
140
|
+
| CloudTrail | `aws cloudtrail lookup-events --start-time "$S" --end-time "$E" --lookup-attributes ...` |
|
|
141
|
+
| GitHub Actions | `gh run view "$RUN" --log-failed` |
|
|
142
|
+
|
|
143
|
+
## Cost sweep categories (read-only)
|
|
144
|
+
|
|
145
|
+
- Unassociated Elastic IPs (`eip` addresses with no association).
|
|
146
|
+
- Available (unattached) EBS volumes.
|
|
147
|
+
- Stale EBS snapshots past a retention age.
|
|
148
|
+
- Idle NAT gateways with negligible processed bytes.
|
|
149
|
+
- Load balancers with no healthy targets.
|
|
150
|
+
- Zero-scaled ECS services still holding a load balancer.
|
|
151
|
+
- Resources whose `ExpiresAt` tag is in the past.
|
|
152
|
+
- Untagged resources missing environment/owner/ChangeId tags.
|
|
153
|
+
- CloudWatch log groups without a retention policy.
|
|
154
|
+
|
|
155
|
+
Sweep findings are reported, never remediated automatically.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: deploy-ops
|
|
3
|
+
description: "Deploy script contract, environment mapping, tag policy, deploy-target framing, and workflow scaffolding for infra-engineer. Use when planning or applying deploys, rollbacks, or releases."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Deploy Operations (deploy-ops)
|
|
7
|
+
|
|
8
|
+
Cross-surface mechanism skill for `infra-engineer`. It supplies the deploy **script contract**, the environment mapping table, the tag policy summary, the deploy-target framing, and the workflow scaffolding procedure. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body — and it contains no deploy logic itself: the logic lives in the `templates/scripts/*.sh` files, which this skill only documents and wires. The skill declares the tools `yq` and `gh`.
|
|
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
|
+
## Tool declaration
|
|
15
|
+
|
|
16
|
+
| Field | Value |
|
|
17
|
+
| ------------- | ------------------------------------------------------------------------------------------------------------------------- |
|
|
18
|
+
| `name` | `yq`, `gh` |
|
|
19
|
+
| `probe` | `yq --version`; `gh --version` |
|
|
20
|
+
| `floor` | `yq` 4.x (the mikefarah Go implementation); minimum `4.0`. A 3.x or Python `yq` is `below-floor`. `gh` any current 2.x. |
|
|
21
|
+
| `auth_probe` | `gh auth status` (for release/PR operations); `yq` needs no auth. |
|
|
22
|
+
| `remediation` | "Install `yq` 4.x from mikefarah/yq and `gh` from cli.github.com; this skill never auto-installs and offers no fallback." |
|
|
23
|
+
|
|
24
|
+
`yq` reads and resolves `infra/environments.yaml`; `gh` performs release and PR operations for the release flow. Every command references secrets by name, never by value, and every log or status query passes through the redaction pattern set before it reaches a transcript.
|
|
25
|
+
|
|
26
|
+
## Script contract
|
|
27
|
+
|
|
28
|
+
The deploy surface is a fixed set of `bash` scripts under `templates/scripts/`. Each is `set -euo pipefail`, supports `--help`, reads the environment definition from `infra/environments.yaml` via `yq`, and contains no environment names or secrets of its own.
|
|
29
|
+
|
|
30
|
+
| Script | Purpose | Mutates? | `--dry-run` | Exit codes |
|
|
31
|
+
| ------------------ | ------------------------------------------------------------ | -------- | ----------- | ------------------------------------------ |
|
|
32
|
+
| `deploy.sh` | Ordered deploy pipeline for one environment | yes | yes | 0 ok · 1 error · 2 blocked · 3 verify-fail |
|
|
33
|
+
| `deploy-verify.sh` | Post-deploy health check; prints the rollback line on fail | no | no | 0 healthy · 2 blocked · 3 fail |
|
|
34
|
+
| `rollback.sh` | Roll back to the previous good version from `infra/changes/` | yes | yes | 0 ok · 1 error · 2 blocked |
|
|
35
|
+
| `deploy-status.sh` | Read-only current status of an environment | no | n/a | 0 ok · 2 blocked |
|
|
36
|
+
| `release.sh` | Generalized changelog/version/tag/push release automation | yes | yes | 0 ok · 1 error · 2 blocked |
|
|
37
|
+
|
|
38
|
+
### `deploy.sh` ordered steps
|
|
39
|
+
|
|
40
|
+
`deploy.sh <env>` runs eight ordered steps and exits `2` on any blocked condition:
|
|
41
|
+
|
|
42
|
+
1. **preflight** — clean tree, ref rules, identity assertion.
|
|
43
|
+
2. **validate** — the project quality gate; **never** skippable by any flag.
|
|
44
|
+
3. **build** — artifact tagged `vX.Y.Z` (production) or `main-<short-sha>` (non-production).
|
|
45
|
+
4. **backup** — taken when the environment is production **and** the change migrates; **never** skipped for production.
|
|
46
|
+
5. **migrate** — with explicit confirmation for production.
|
|
47
|
+
6. **deploy** — via the detected deploy kind.
|
|
48
|
+
7. **verify** — delegates to `deploy-verify.sh`.
|
|
49
|
+
8. **record** — appends a change record under `infra/changes/`.
|
|
50
|
+
|
|
51
|
+
No `latest` mutable tag is ever a deploy target. The deploy kind is detected from the platform blocks present in the environment; `deploy.sh` refuses (`exit 2`) when the detection is ambiguous (more than one platform block and no explicit `deploy_kind`), per spec open question 3.
|
|
52
|
+
|
|
53
|
+
### Failure and rollback
|
|
54
|
+
|
|
55
|
+
`deploy-verify.sh` exits `3` on a failed health check and prints the exact `rollback.sh <env>` invocation to run next. `rollback.sh <env>` resolves the previous good version from `infra/changes/` with no manual lookup; `--to <version>` overrides the resolved version.
|
|
56
|
+
|
|
57
|
+
## Environment mapping table
|
|
58
|
+
|
|
59
|
+
Environment names and platform blocks are read from `infra/environments.yaml` via `yq`. A missing or template-status (`# status: template`) file exits `2`.
|
|
60
|
+
|
|
61
|
+
| Trigger / ref | Environment | Rule |
|
|
62
|
+
| ---------------------------- | ----------- | ----------------------------------------------------------------------------- |
|
|
63
|
+
| push to `main` | `dev` | non-production deploys `main` HEAD; artifact tagged `main-<short-sha>` |
|
|
64
|
+
| annotated tag `vX.Y.Z` | `prod` | production refuses any ref that is not an annotated tag on `main` |
|
|
65
|
+
| manual (`workflow_dispatch`) | any | dev is optional; installed only when a `production: false` environment exists |
|
|
66
|
+
|
|
67
|
+
## Tag policy summary
|
|
68
|
+
|
|
69
|
+
Tags are human-only and owned by the policy in `github-ops`: annotated `vX.Y.Z`, created on `main` only, immutable, no prerelease in v1. `deploy-ops` never creates, moves, or deletes a tag — `git-guard` rule 4 blocks agent tag operations deterministically. `release.sh` suggests the bump type from Conventional Commits and confirms it; production deploys consume the resulting annotated tag.
|
|
70
|
+
|
|
71
|
+
## Deploy-target framing
|
|
72
|
+
|
|
73
|
+
`deploy-ops` does not choose the platform for a consumer. It frames the decision so the operator (or `infra-engineer`) picks a **deploy target** deliberately, then records the choice in `infra/environments.yaml`.
|
|
74
|
+
|
|
75
|
+
| Decision input | Question the operator answers |
|
|
76
|
+
| ---------------- | -------------------------------------------------------------------- |
|
|
77
|
+
| compute platform | fly.io app, AWS ECS service, or another target? |
|
|
78
|
+
| data platform | is there a Supabase (or other) migration step to sequence? |
|
|
79
|
+
| environment tier | is this environment `production: true` or `false`? |
|
|
80
|
+
| ref discipline | does production consume an annotated tag, and does dev track `main`? |
|
|
81
|
+
| rollback source | is the previous good version recorded in `infra/changes/`? |
|
|
82
|
+
|
|
83
|
+
When two platform blocks are present with no explicit `deploy_kind`, the deploy target is ambiguous and `deploy.sh` refuses until the operator sets `deploy_kind`.
|
|
84
|
+
|
|
85
|
+
## Workflow scaffolding procedure
|
|
86
|
+
|
|
87
|
+
`deploy-ops` scaffolds the GitHub Actions workflow templates (`templates/workflows/`) into a consumer repo as recorded changes delivered by a draft PR — never applied silently.
|
|
88
|
+
|
|
89
|
+
1. Read `infra/environments.yaml`.
|
|
90
|
+
2. Install `deploy-dev.yml` **only when** an environment with `production: false` is declared.
|
|
91
|
+
3. Install `deploy-prod.yml` (triggered on the exact-semver tag, behind a required reviewer) and `rollback.yml` (`workflow_dispatch`) when a `production: true` environment exists.
|
|
92
|
+
4. Every workflow calls the canonical scripts only — no inline deploy logic.
|
|
93
|
+
5. Workflow edits are recorded changes; they are delivered by PR and reviewed by a human.
|
|
94
|
+
|
|
95
|
+
## `package.json` wrappers for JS/TS repos
|
|
96
|
+
|
|
97
|
+
For JavaScript/TypeScript repos only, `deploy-ops` generates thin `package.json` script wrappers so the deploy surface is reachable through the project's canonical script runner. The shell scripts remain the implementation; the wrappers are one-line delegations:
|
|
98
|
+
|
|
99
|
+
```jsonc
|
|
100
|
+
{
|
|
101
|
+
"scripts": {
|
|
102
|
+
"deploy": "bash templates/scripts/deploy.sh",
|
|
103
|
+
"deploy:verify": "bash templates/scripts/deploy-verify.sh",
|
|
104
|
+
"deploy:rollback": "bash templates/scripts/rollback.sh",
|
|
105
|
+
"deploy:status": "bash templates/scripts/deploy-status.sh",
|
|
106
|
+
"release": "bash templates/scripts/release.sh",
|
|
107
|
+
},
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Non-JS/TS repos call the scripts directly; no wrapper is generated.
|
|
112
|
+
|
|
113
|
+
## Human-only guard
|
|
114
|
+
|
|
115
|
+
`release.sh` and `deploy.sh prod` refuse to run when `CI` is set without `INFRA_HUMAN_APPROVED=1` exported by the protected-environment job, and refuse in a non-interactive agent context. This keeps release and production deploy decisions with a human even when the scripts run inside automation.
|
|
116
|
+
|
|
117
|
+
## Boundary rules
|
|
118
|
+
|
|
119
|
+
- No deploy logic lives in this skill or in a workflow; it lives only in `templates/scripts/*.sh`.
|
|
120
|
+
- No deploy targets a mutable `latest` tag.
|
|
121
|
+
- The agent never creates tags; tags are human-only per `github-ops`.
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fly-ops
|
|
3
|
+
description: "flyctl command sets, resource tiers, cost inputs, backup and revert sources, and log table for infra-engineer. Use when planning or applying fly.io infrastructure changes."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Fly.io Operations (fly-ops)
|
|
7
|
+
|
|
8
|
+
Per-surface mechanism skill for `infra-engineer`. It supplies the `flyctl` command sets, resource tiers, cost inputs, backup and revert sources, and the fly.io log table. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body. fly.io has release history (`fly releases`) that makes revert concrete and volume snapshots that make backup concrete, so it is the cheapest surface for the manual Phase 1 verification.
|
|
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
|
+
## Tool declaration
|
|
15
|
+
|
|
16
|
+
| Field | Value |
|
|
17
|
+
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
18
|
+
| `name` | `flyctl` |
|
|
19
|
+
| `probe` | `flyctl version` |
|
|
20
|
+
| `floor` | Current major release channel; minimum `0.3`. An older channel is `below-floor`. |
|
|
21
|
+
| `auth_probe` | `flyctl auth whoami` |
|
|
22
|
+
| `remediation` | "Install `flyctl` from fly.io and run `flyctl auth login` (or export `FLY_API_TOKEN`); this skill never auto-installs and offers no fallback." |
|
|
23
|
+
|
|
24
|
+
Use `--json` wherever `flyctl` supports it. Identity is asserted by comparing the authenticated org (from `flyctl auth whoami` / `flyctl orgs list --json`) with the target environment's `fly.org`; a mismatch is `wrong-identity` and blocks.
|
|
25
|
+
|
|
26
|
+
## Resource tiers
|
|
27
|
+
|
|
28
|
+
| Tier | Fly resources |
|
|
29
|
+
| --------------- | ----------------------------------------------------------------- |
|
|
30
|
+
| **foundation** | org |
|
|
31
|
+
| **application** | app, machine, volume, secret, certificate |
|
|
32
|
+
| **ephemeral** | throwaway apps, which carry an `ExpiresAt` tag and a cleanup step |
|
|
33
|
+
|
|
34
|
+
An ephemeral app without an `ExpiresAt` is a finding. Foundation (org) changes are routed, never written by this agent.
|
|
35
|
+
|
|
36
|
+
## Command sets per change kind
|
|
37
|
+
|
|
38
|
+
Every command references secrets by name, never by value.
|
|
39
|
+
|
|
40
|
+
### Discover (read-only)
|
|
41
|
+
|
|
42
|
+
```sh
|
|
43
|
+
flyctl auth whoami
|
|
44
|
+
flyctl apps list --json
|
|
45
|
+
flyctl status -a "$APP" --json
|
|
46
|
+
flyctl machine list -a "$APP" --json
|
|
47
|
+
flyctl volumes list -a "$APP" --json
|
|
48
|
+
flyctl secrets list -a "$APP"
|
|
49
|
+
flyctl certs list -a "$APP"
|
|
50
|
+
flyctl releases -a "$APP" --json
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### Create app
|
|
54
|
+
|
|
55
|
+
- Forward: `fly apps create "$APP" --org "$ORG"`
|
|
56
|
+
- Verify: `flyctl status -a "$APP" --json`
|
|
57
|
+
- Revert: `fly apps destroy "$APP" --yes` (requires the typed app name and environment name per the agent body).
|
|
58
|
+
|
|
59
|
+
### Deploy
|
|
60
|
+
|
|
61
|
+
- Forward: `fly deploy -a "$APP" --image "$IMAGE"` or a build then deploy:
|
|
62
|
+
```sh
|
|
63
|
+
fly deploy -a "$APP" --build-only --push --image-label "$TAG"
|
|
64
|
+
fly deploy -a "$APP" --image "registry.fly.io/$APP:$TAG"
|
|
65
|
+
```
|
|
66
|
+
- Verify: `flyctl status -a "$APP" --json` shows the new release healthy.
|
|
67
|
+
- Revert: `fly deploy -a "$APP" --image <previous>` using the previous image from `fly releases`.
|
|
68
|
+
|
|
69
|
+
### Secrets
|
|
70
|
+
|
|
71
|
+
- Forward: `fly secrets set KEY=value -a "$APP"` (value from its source of truth, never a transcript) / `fly secrets unset KEY -a "$APP"`.
|
|
72
|
+
- Revert: re-set the prior value from its source of truth; **never** reconstruct a secret from a transcript or log.
|
|
73
|
+
|
|
74
|
+
### Volumes
|
|
75
|
+
|
|
76
|
+
- Forward: `fly volumes create "$NAME" -a "$APP" --region "$REGION" --size "$GB"`.
|
|
77
|
+
- Backup: `fly volumes snapshots create "$VOL_ID"` before any production step touching a volume.
|
|
78
|
+
- Revert: restore from the recorded snapshot; `fly volumes destroy "$VOL_ID"` only after the typed confirmation.
|
|
79
|
+
|
|
80
|
+
### Certificates
|
|
81
|
+
|
|
82
|
+
- Forward: `fly certs add "$FQDN" -a "$APP"`; then `fly certs check "$FQDN" -a "$APP"`.
|
|
83
|
+
- Revert: `fly certs remove "$FQDN" -a "$APP" --yes`.
|
|
84
|
+
|
|
85
|
+
### Scale and machines
|
|
86
|
+
|
|
87
|
+
```sh
|
|
88
|
+
fly scale count "$N" -a "$APP"
|
|
89
|
+
fly scale vm "$SIZE" -a "$APP"
|
|
90
|
+
fly machine status "$MACHINE" -a "$APP" --json
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Revert for a scale change is the prior count/size recorded before the step.
|
|
94
|
+
|
|
95
|
+
### Destroy
|
|
96
|
+
|
|
97
|
+
`fly apps destroy "$APP" --yes` requires the operator to type both the app name and the environment name. A production foundation target is refused.
|
|
98
|
+
|
|
99
|
+
## Revert sources
|
|
100
|
+
|
|
101
|
+
- **Deploy:** `fly releases -a "$APP" --json` supplies the previous image; revert is `fly deploy --image <previous>`.
|
|
102
|
+
- **Secret:** re-set the prior value from its source of truth.
|
|
103
|
+
- **Volume:** the snapshot recorded as backup.
|
|
104
|
+
- **Scale/cert:** the prior value/record captured before the step.
|
|
105
|
+
|
|
106
|
+
## Backup
|
|
107
|
+
|
|
108
|
+
`fly volumes snapshots create "$VOL_ID"` runs before any production step that touches a volume; the snapshot id and the restore command are recorded in `result.md` before the step applies.
|
|
109
|
+
|
|
110
|
+
## Fly log table
|
|
111
|
+
|
|
112
|
+
Every query is time-bounded and its output passes through the redaction pattern set before it reaches a transcript or file.
|
|
113
|
+
|
|
114
|
+
| Source | Command |
|
|
115
|
+
| --------------- | ----------------------------------------- |
|
|
116
|
+
| App logs | `fly logs -a "$APP" --since "$START"` |
|
|
117
|
+
| App status | `fly status -a "$APP" --json` |
|
|
118
|
+
| Machine status | `fly machine status "$MACHINE" -a "$APP"` |
|
|
119
|
+
| Release history | `fly releases -a "$APP" --json` |
|
|
120
|
+
|
|
121
|
+
## Cost entries and sweep
|
|
122
|
+
|
|
123
|
+
Cost entries listed on every fly plan:
|
|
124
|
+
|
|
125
|
+
- **Machines** by size (shared/performance vCPU + memory).
|
|
126
|
+
- **Volumes** by GB.
|
|
127
|
+
- **Dedicated IPv4** addresses.
|
|
128
|
+
|
|
129
|
+
Sweep categories (read-only, reported never remediated):
|
|
130
|
+
|
|
131
|
+
- Stopped machines still holding volumes.
|
|
132
|
+
- Unattached volumes.
|
|
133
|
+
- Apps past their `ExpiresAt` tag.
|
|
134
|
+
|
|
135
|
+
## Boundary rules
|
|
136
|
+
|
|
137
|
+
- No AWS Secrets Manager entry for a fly-only workload; fly secrets stay on fly.
|
|
138
|
+
- `fly apps destroy` requires the typed app name and environment name.
|
|
@@ -39,7 +39,7 @@ git checkout -b <branch-name>
|
|
|
39
39
|
|
|
40
40
|
- Story branches: `story/<story-id>-<short-description>`
|
|
41
41
|
- Issue branches: `issue/<issue-number>-<short-description>`
|
|
42
|
-
- Integration branches: `
|
|
42
|
+
- Integration branches: `integration/<plan-id>-<short-description>`
|
|
43
43
|
|
|
44
44
|
### 2. Create Branch from Integration Branch
|
|
45
45
|
|
|
@@ -96,13 +96,13 @@ Before merging any PR or branch, verify:
|
|
|
96
96
|
|
|
97
97
|
Choose the appropriate strategy based on context:
|
|
98
98
|
|
|
99
|
-
| Strategy | When to Use | Command
|
|
100
|
-
| ---------------- | ----------------------------------------------------------------------------------- |
|
|
101
|
-
| **Squash merge** |
|
|
102
|
-
| **Merge commit** | Integration
|
|
103
|
-
| **Rebase merge** |
|
|
99
|
+
| Strategy | When to Use | Command |
|
|
100
|
+
| ---------------- | ----------------------------------------------------------------------------------- | ------------------------------------------- |
|
|
101
|
+
| **Squash merge** | Issue/story PRs → integration (planner) or `main` (user); delete the source branch. | `gh pr merge <pr> --squash --delete-branch` |
|
|
102
|
+
| **Merge commit** | Integration PRs → `main` (user); preserve the story history. | `gh pr merge <pr> --merge` |
|
|
103
|
+
| **Rebase merge** | Not part of the issue/story/integration policy; use only when explicitly approved. | `gh pr merge <pr> --rebase` |
|
|
104
104
|
|
|
105
|
-
**Default**:
|
|
105
|
+
**Default**: Issue/story PRs use squash with branch deletion; integration PRs use a merge commit. Planner handles integration targets, and the user handles `main`.
|
|
106
106
|
|
|
107
107
|
### 6. Resolve Merge Conflicts
|
|
108
108
|
|
|
@@ -197,6 +197,26 @@ git push --force-with-lease origin <branch-name>
|
|
|
197
197
|
|
|
198
198
|
**Never use** `git push --force` without `--with-lease`.
|
|
199
199
|
|
|
200
|
+
### 10. Tag Procedure (Human-Only)
|
|
201
|
+
|
|
202
|
+
Tags are the production deploy trigger and are created **only by a human**. Agents **MUST NOT** create, move, delete, or push tags; `git-guard` rule 4 enforces this. This section documents the procedure a human follows — it is not an agent action.
|
|
203
|
+
|
|
204
|
+
```bash
|
|
205
|
+
# Ensure you are on main at the exact release commit
|
|
206
|
+
git checkout main
|
|
207
|
+
git pull origin main
|
|
208
|
+
|
|
209
|
+
# Create an annotated, immutable release tag (exact semver only)
|
|
210
|
+
git tag -a v<major>.<minor>.<patch> -m "Release v<major>.<minor>.<patch>"
|
|
211
|
+
|
|
212
|
+
# Push the tag (triggers the production deploy workflow)
|
|
213
|
+
git push origin v<major>.<minor>.<patch>
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
Rules: annotated tags only (never lightweight), exact `v<major>.<minor>.<patch>` (no prerelease suffixes in v1), tag a commit on `main`, and never move or delete a pushed tag.
|
|
217
|
+
|
|
218
|
+
**Hotfix:** a hotfix ships as the next patch tag (`vX.Y.Z+1`) cut from `main` after the fix merges; never re-point or force-update an existing tag.
|
|
219
|
+
|
|
200
220
|
---
|
|
201
221
|
|
|
202
222
|
## Conflict Resolution Heuristics
|