@getarbiter/cli 0.5.0
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/CHANGELOG.md +713 -0
- package/LICENSE +202 -0
- package/NOTICE +31 -0
- package/PRIVACY.md +111 -0
- package/README.md +237 -0
- package/THIRD_PARTY_LICENSES.md +472 -0
- package/dist/.src-manifest.json +1 -0
- package/dist/capabilities/host-probe.js +3 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +87 -0
- package/dist/commands/adopt-policy.js +3 -0
- package/dist/commands/configure-interactive.js +3 -0
- package/dist/commands/configure.js +5 -0
- package/dist/commands/cross-model-review.js +3 -0
- package/dist/commands/diff.js +20 -0
- package/dist/commands/doc-set.js +3 -0
- package/dist/commands/doctor/clean.js +2 -0
- package/dist/commands/doctor/fail-open-census.js +12 -0
- package/dist/commands/doctor/health.js +11 -0
- package/dist/commands/doctor/prove-gates.js +13 -0
- package/dist/commands/doctor/recover-lock.js +12 -0
- package/dist/commands/doctor/repair-state.js +6 -0
- package/dist/commands/doctor/tool-pin-extract.js +4 -0
- package/dist/commands/doctor/tool-pins.js +9 -0
- package/dist/commands/doctor-interactive.js +2 -0
- package/dist/commands/doctor.js +2 -0
- package/dist/commands/explain.js +19 -0
- package/dist/commands/gate-exec.js +4 -0
- package/dist/commands/gold-audit.js +14 -0
- package/dist/commands/graph.js +5 -0
- package/dist/commands/init/build-arbiter-config.js +1 -0
- package/dist/commands/init/generate.js +42 -0
- package/dist/commands/init/github-setup.js +5 -0
- package/dist/commands/init/maturity-gates.js +10 -0
- package/dist/commands/init/resolve-config.js +3 -0
- package/dist/commands/init/toolchain.js +10 -0
- package/dist/commands/init/types.js +1 -0
- package/dist/commands/init.js +17 -0
- package/dist/commands/method-interactive.js +4 -0
- package/dist/commands/method.js +11 -0
- package/dist/commands/obsidian.js +2 -0
- package/dist/commands/plugin.js +8 -0
- package/dist/commands/pr-merged.js +2 -0
- package/dist/commands/retire-policy.js +3 -0
- package/dist/commands/review-diff.js +3 -0
- package/dist/commands/settings.js +7 -0
- package/dist/commands/ship-config.js +2 -0
- package/dist/commands/ship-profile.js +2 -0
- package/dist/commands/ship-review.js +1 -0
- package/dist/commands/ship-tier.js +2 -0
- package/dist/commands/ship-train.js +2 -0
- package/dist/commands/task-mark.js +2 -0
- package/dist/commands/task-note.js +3 -0
- package/dist/commands/task-record-red.js +2 -0
- package/dist/commands/task-record-tech-debt.js +4 -0
- package/dist/commands/task-ship.js +3 -0
- package/dist/commands/task-state.js +6 -0
- package/dist/commands/task.js +59 -0
- package/dist/commands/update.js +60 -0
- package/dist/commands/upgrade-level-interactive.js +2 -0
- package/dist/commands/upgrade-level.js +7 -0
- package/dist/commands/verify-plan.js +8 -0
- package/dist/commands/verify-tdd.js +2 -0
- package/dist/commands/verify.js +7 -0
- package/dist/commands/wizard/coherence.js +1 -0
- package/dist/commands/worktree-prune.js +4 -0
- package/dist/commands/worktree.js +39 -0
- package/dist/compatibility/cross-language-matrix.json +540 -0
- package/dist/compatibility/index.d.ts +4 -0
- package/dist/compatibility/index.js +2 -0
- package/dist/compatibility/matcher.js +1 -0
- package/dist/compatibility/matrix.json +27 -0
- package/dist/compatibility/parsers.d.ts +38 -0
- package/dist/compatibility/parsers.js +1 -0
- package/dist/compatibility/probe.d.ts +41 -0
- package/dist/compatibility/probe.js +4 -0
- package/dist/compatibility/report.js +2 -0
- package/dist/compatibility/schema.d.ts +80 -0
- package/dist/compatibility/schema.js +1 -0
- package/dist/compatibility/skills-matrix.json +98 -0
- package/dist/compatibility/skills-validator.d.ts +30 -0
- package/dist/compatibility/skills-validator.js +4 -0
- package/dist/compatibility/tooling-proposals.json +5 -0
- package/dist/config/arbiter-ignore.js +3 -0
- package/dist/config/collaboration-mode-defaults.js +1 -0
- package/dist/config/diff.js +1 -0
- package/dist/config/env-overrides.js +3 -0
- package/dist/config/env-registry.js +2 -0
- package/dist/config/levels.js +1 -0
- package/dist/config/migrations/index.js +2 -0
- package/dist/config/migrations/v0-to-v1.js +2 -0
- package/dist/config/migrations/v1-to-v2.js +2 -0
- package/dist/config/migrations/v2-to-v3.js +2 -0
- package/dist/config/migrations/v3-to-v4.js +2 -0
- package/dist/config/override-resolver.js +2 -0
- package/dist/config/resolve-project-config.js +2 -0
- package/dist/config/resolve-project-name.js +2 -0
- package/dist/config/schema.d.ts +480 -0
- package/dist/config/schema.js +1 -0
- package/dist/config/test-pyramid-profiles.js +1 -0
- package/dist/config/thresholds.js +2 -0
- package/dist/conformance/dimensions.js +3 -0
- package/dist/conformance/engine.js +7 -0
- package/dist/conformance/gate-proofs.js +4 -0
- package/dist/conformance/shared.js +2 -0
- package/dist/detectors/axis.js +1 -0
- package/dist/detectors/build.js +2 -0
- package/dist/detectors/existing.js +2 -0
- package/dist/detectors/external-model.js +2 -0
- package/dist/detectors/framework.js +2 -0
- package/dist/detectors/git.js +11 -0
- package/dist/detectors/github.js +2 -0
- package/dist/detectors/lanes.js +5 -0
- package/dist/detectors/language-hooks.js +117 -0
- package/dist/detectors/language.js +2 -0
- package/dist/detectors/package-manager.js +2 -0
- package/dist/detectors/package.js +2 -0
- package/dist/detectors/scaffold-wiring.js +2 -0
- package/dist/detectors/workflow-collision.js +4 -0
- package/dist/evidence/gate-binding.js +4 -0
- package/dist/evidence/git-checks.js +3 -0
- package/dist/evidence/load.js +2 -0
- package/dist/evidence/provenance.js +2 -0
- package/dist/evidence/summary.js +2 -0
- package/dist/evidence/tdd-reexecute.js +2 -0
- package/dist/evidence/tdd.js +4 -0
- package/dist/experimental/index.js +2 -0
- package/dist/experimental/parse-argv.js +2 -0
- package/dist/experimental/registry.js +2 -0
- package/dist/generators/agents-claude.js +2 -0
- package/dist/generators/agents-md.js +2 -0
- package/dist/generators/anti-drift-validators.js +3 -0
- package/dist/generators/anti-proforma.js +2 -0
- package/dist/generators/api-e2e.js +2 -0
- package/dist/generators/api-middleware.js +2 -0
- package/dist/generators/archunit.js +2 -0
- package/dist/generators/audit-toolchain.js +2 -0
- package/dist/generators/auth.js +2 -0
- package/dist/generators/behavioral-tests.js +2 -0
- package/dist/generators/boundaries.js +2 -0
- package/dist/generators/check-all.js +2 -0
- package/dist/generators/check-stack-conformity.js +2 -0
- package/dist/generators/ci-five-lane.js +2 -0
- package/dist/generators/ci-tier.js +2 -0
- package/dist/generators/claude.js +3 -0
- package/dist/generators/codex-hooks.js +2 -0
- package/dist/generators/codex-known-limitations.js +2 -0
- package/dist/generators/codex.js +15 -0
- package/dist/generators/commit-footer.js +2 -0
- package/dist/generators/compliance-menu.js +2 -0
- package/dist/generators/compliance.js +2 -0
- package/dist/generators/conformance.js +2 -0
- package/dist/generators/contract-testing.js +2 -0
- package/dist/generators/coverage.js +2 -0
- package/dist/generators/debt-gates.js +24 -0
- package/dist/generators/debt-ratchet.js +2 -0
- package/dist/generators/derived-class.js +2 -0
- package/dist/generators/doc-set.js +4 -0
- package/dist/generators/docs.js +2 -0
- package/dist/generators/duplication.js +2 -0
- package/dist/generators/e2e-constitution.js +2 -0
- package/dist/generators/env-template.js +2 -0
- package/dist/generators/evidence-retention.js +2 -0
- package/dist/generators/feature-matrix.js +2 -0
- package/dist/generators/frontend-governance.js +2 -0
- package/dist/generators/frontend-quality.js +2 -0
- package/dist/generators/gap.js +2 -0
- package/dist/generators/gdpr.js +2 -0
- package/dist/generators/githooks.js +2 -0
- package/dist/generators/github-setup.js +2 -0
- package/dist/generators/github.js +2 -0
- package/dist/generators/gitignore.js +2 -0
- package/dist/generators/global-invariants.js +3 -0
- package/dist/generators/go-boundaries.js +2 -0
- package/dist/generators/gold-kit.js +2 -0
- package/dist/generators/infra.js +2 -0
- package/dist/generators/integration-testing.js +7 -0
- package/dist/generators/iso27001.js +2 -0
- package/dist/generators/iso9001.js +2 -0
- package/dist/generators/labels.js +2 -0
- package/dist/generators/local-wrapper.js +2 -0
- package/dist/generators/modulith.js +2 -0
- package/dist/generators/mutation.js +2 -0
- package/dist/generators/observability.js +2 -0
- package/dist/generators/operations.js +2 -0
- package/dist/generators/perf-k6.js +2 -0
- package/dist/generators/pharma.js +2 -0
- package/dist/generators/playwright-python.js +2 -0
- package/dist/generators/playwright-ts.js +2 -0
- package/dist/generators/pr-tooling.js +2 -0
- package/dist/generators/python-boundaries.js +2 -0
- package/dist/generators/quality.js +2 -0
- package/dist/generators/registry.js +2 -0
- package/dist/generators/regulated.js +2 -0
- package/dist/generators/resilience.js +2 -0
- package/dist/generators/risk-register.js +2 -0
- package/dist/generators/root.js +2 -0
- package/dist/generators/rust-boundaries.js +2 -0
- package/dist/generators/safety-class.js +2 -0
- package/dist/generators/security.js +2 -0
- package/dist/generators/seed.js +2 -0
- package/dist/generators/self-validation.js +2 -0
- package/dist/generators/ship-driver.js +2 -0
- package/dist/generators/skill-names.json +17 -0
- package/dist/generators/skills.js +2 -0
- package/dist/generators/smoke-journeys.js +2 -0
- package/dist/generators/solo-exception.js +2 -0
- package/dist/generators/ssot.js +2 -0
- package/dist/generators/stride-enforcement.js +2 -0
- package/dist/generators/suppressions.js +2 -0
- package/dist/generators/test-pyramid-manifest.js +3 -0
- package/dist/generators/test-taxonomy.js +2 -0
- package/dist/generators/wiki.js +2 -0
- package/dist/github/branch-protection.js +2 -0
- package/dist/github/classify-gh-error.js +2 -0
- package/dist/github/labels.js +2 -0
- package/dist/github/project-board.js +2 -0
- package/dist/graph/builders/adr.js +4 -0
- package/dist/graph/builders/ast.js +3 -0
- package/dist/graph/builders/canon.js +2 -0
- package/dist/graph/builders/evidence.js +2 -0
- package/dist/graph/builders/inv.js +1 -0
- package/dist/graph/builders/req.js +3 -0
- package/dist/graph/builders/test-nodes.js +3 -0
- package/dist/graph/builders/utils.js +2 -0
- package/dist/graph/load.js +2 -0
- package/dist/graph/model.js +2 -0
- package/dist/graph/query.js +3 -0
- package/dist/graph/store.js +1 -0
- package/dist/i18n/en.json +293 -0
- package/dist/i18n/index.js +4 -0
- package/dist/i18n/types.js +2 -0
- package/dist/integrations/companions.js +2 -0
- package/dist/integrations/external-review.js +10 -0
- package/dist/integrations/plugin-schema.js +2 -0
- package/dist/integrations/skill-detector.js +7 -0
- package/dist/integrations/skills-matrix.js +2 -0
- package/dist/integrations/types.d.ts +23 -0
- package/dist/integrations/types.js +2 -0
- package/dist/internal/cli-deprecation-registry.js +2 -0
- package/dist/internal/deprecate.js +3 -0
- package/dist/internal/experimental-warn.js +3 -0
- package/dist/invariants/catalog.d.ts +2 -0
- package/dist/invariants/catalog.js +1 -0
- package/dist/invariants/filter.d.ts +28 -0
- package/dist/invariants/filter.js +1 -0
- package/dist/invariants/index.d.ts +4 -0
- package/dist/invariants/index.js +2 -0
- package/dist/invariants/tiers.js +1 -0
- package/dist/invariants/types.d.ts +1 -0
- package/dist/invariants/types.js +1 -0
- package/dist/kit/applicability.js +3 -0
- package/dist/kit/audit-report.js +3 -0
- package/dist/kit/brownfield-detect.js +4 -0
- package/dist/kit/canonical-mapping.json +1 -0
- package/dist/kit/catalog.js +2 -0
- package/dist/kit/catalog.json +1 -0
- package/dist/kit/derived.json +1 -0
- package/dist/kit/emit-issues.js +8 -0
- package/dist/kit/measure.js +5 -0
- package/dist/kit/redaction.js +3 -0
- package/dist/kit/schema.js +2 -0
- package/dist/kit/taxonomy.js +2 -0
- package/dist/kit/thresholds.d.ts +12 -0
- package/dist/kit/thresholds.js +2 -0
- package/dist/kit/wave-engine.js +1 -0
- package/dist/recipes/loader.js +6 -0
- package/dist/recipes/schema.js +2 -0
- package/dist/risk/classifier.js +2 -0
- package/dist/risk/sha-check.js +2 -0
- package/dist/state/backups.js +2 -0
- package/dist/state/envelope.js +2 -0
- package/dist/state/generated-manifest.js +3 -0
- package/dist/state/manifest-key.js +2 -0
- package/dist/state/migrations/index.js +1 -0
- package/dist/state/migrations/v0-to-v1.js +2 -0
- package/dist/state/retired-renders.js +2 -0
- package/dist/templates/.nvmrc.ejs +1 -0
- package/dist/templates/HANDOFF.template.md +45 -0
- package/dist/templates/__tests__/contract/error-shape.contract.test.ts.ejs +47 -0
- package/dist/templates/agents-md/AGENTS.md.ejs +517 -0
- package/dist/templates/api-e2e/README.md.ejs +33 -0
- package/dist/templates/api-e2e/go-httptest.go.ejs +43 -0
- package/dist/templates/api-e2e/java-restassured.java.ejs +28 -0
- package/dist/templates/api-e2e/kotlin-restassured.kt.ejs +30 -0
- package/dist/templates/api-e2e/manifest.json.ejs +8 -0
- package/dist/templates/api-e2e/postman.collection.json.ejs +30 -0
- package/dist/templates/api-e2e/python-httpx.py.ejs +17 -0
- package/dist/templates/api-e2e/run.sh.ejs +61 -0
- package/dist/templates/api-e2e/ts-supertest.test.ts.ejs +18 -0
- package/dist/templates/archunit/AntiCyclicTest.java.ejs +29 -0
- package/dist/templates/archunit/AntiProformaExempt.java.ejs +35 -0
- package/dist/templates/archunit/AntiProformaTest.java.ejs +104 -0
- package/dist/templates/archunit/ArchitectureTest.java.ejs +87 -0
- package/dist/templates/archunit/DependencyFlowTest.java.ejs +55 -0
- package/dist/templates/archunit/DomainPurityTest.java.ejs +47 -0
- package/dist/templates/archunit/NamingConventionsTest.java.ejs +54 -0
- package/dist/templates/archunit/NoH2ArchTest.java.ejs +30 -0
- package/dist/templates/archunit/NoMockMvcTest.java.ejs +71 -0
- package/dist/templates/archunit/PortsIndependenceTest.java.ejs +55 -0
- package/dist/templates/archunit/RestAssuredArchTest.java.ejs +32 -0
- package/dist/templates/archunit/RestAssuredBaseIT.java.ejs +66 -0
- package/dist/templates/archunit/TestCoverageArchTest.java.ejs +29 -0
- package/dist/templates/archunit/arch-test-deps-maven.md.ejs +42 -0
- package/dist/templates/archunit/arch-test-deps.gradle.ejs +14 -0
- package/dist/templates/audit/gdpr/check-gdpr-controls.mjs.ejs +102 -0
- package/dist/templates/audit/gdpr/controls-to-gates.md.ejs +42 -0
- package/dist/templates/audit/gdpr/data-flow-map.md.ejs +30 -0
- package/dist/templates/audit/gdpr/dpia.md.ejs +45 -0
- package/dist/templates/audit/generic/audit-gate-rules.md.ejs +24 -0
- package/dist/templates/audit/generic/audit-trail-policy.md.ejs +38 -0
- package/dist/templates/audit/iso27001/iso27001-controls-gate-map.md.ejs +60 -0
- package/dist/templates/auth/setup.md.ejs +661 -0
- package/dist/templates/behavioral-tests/ExampleBehavioralTest.java.ejs +67 -0
- package/dist/templates/behavioral-tests/TESTING_POLICY.md.ejs +116 -0
- package/dist/templates/behavioral-tests/bdd/ExampleBddIT.java.ejs +19 -0
- package/dist/templates/behavioral-tests/bdd/ExampleSteps.java.ejs +61 -0
- package/dist/templates/behavioral-tests/bdd/example.feature.ejs +14 -0
- package/dist/templates/behavioral-tests/bdd/example.steps.ts.ejs +37 -0
- package/dist/templates/behavioral-tests/bdd/example_bdd_test.rs.ejs +64 -0
- package/dist/templates/behavioral-tests/bdd/example_test.go.ejs +80 -0
- package/dist/templates/behavioral-tests/bdd/test_example_bdd.py.ejs +47 -0
- package/dist/templates/behavioral-tests/eslint-playwright.json.ejs +10 -0
- package/dist/templates/behavioral-tests/eslint.config.playwright.mjs.ejs +29 -0
- package/dist/templates/behavioral-tests/example.behavioral.test.ts.ejs +47 -0
- package/dist/templates/behavioral-tests/example_behavioral_test.go.ejs +51 -0
- package/dist/templates/behavioral-tests/example_behavioral_test.rs.ejs +47 -0
- package/dist/templates/behavioral-tests/test_example_behavioral.py.ejs +40 -0
- package/dist/templates/boundaries/.eslintrc-boundaries.cjs.ejs +81 -0
- package/dist/templates/boundaries/.eslintrc-frontend-spa.cjs.ejs +79 -0
- package/dist/templates/boundaries/.importlinter.ejs +48 -0
- package/dist/templates/boundaries/check-boundaries-go.mjs.ejs +94 -0
- package/dist/templates/boundaries/check-boundaries-python.mjs.ejs +118 -0
- package/dist/templates/boundaries/check-boundaries-rust.mjs.ejs +111 -0
- package/dist/templates/boundaries/check-boundaries.mjs.ejs +34 -0
- package/dist/templates/boundaries/clippy.toml.ejs +50 -0
- package/dist/templates/boundaries/deny.toml.ejs +56 -0
- package/dist/templates/boundaries/eslint.config.boundaries.mjs.ejs +112 -0
- package/dist/templates/boundaries/eslint.config.frontend-spa.mjs.ejs +93 -0
- package/dist/templates/boundaries/golangci-boundaries.yml.ejs +70 -0
- package/dist/templates/boundaries/ruff-boundaries.toml.ejs +32 -0
- package/dist/templates/claude/CLAUDE.md.ejs +78 -0
- package/dist/templates/claude/agents/agent-write-classes.json +30 -0
- package/dist/templates/claude/agents/bridge-reviewer.md.ejs +68 -0
- package/dist/templates/claude/agents/codebase-scanner.md.ejs +69 -0
- package/dist/templates/claude/agents/context-checker.md.ejs +73 -0
- package/dist/templates/claude/agents/red-team.md.ejs +134 -0
- package/dist/templates/claude/commands/close-gold-gap.md.ejs +43 -0
- package/dist/templates/claude/commands/drain.md.ejs +81 -0
- package/dist/templates/claude/commands/gold-audit.md.ejs +43 -0
- package/dist/templates/claude/commands/impact.md.ejs +39 -0
- package/dist/templates/claude/commands/levelup.md.ejs +61 -0
- package/dist/templates/claude/commands/ship.md.ejs +902 -0
- package/dist/templates/claude/commands/tabletop.md.ejs +46 -0
- package/dist/templates/claude/commands/task.md.ejs +87 -0
- package/dist/templates/claude/commands/wt-close.md.ejs +58 -0
- package/dist/templates/claude/commands/wt-list.md.ejs +48 -0
- package/dist/templates/claude/commands/wt-open.md.ejs +61 -0
- package/dist/templates/claude/commands/wt-prune.md.ejs +38 -0
- package/dist/templates/claude/hooks/check-circular-deps.mjs.ejs +56 -0
- package/dist/templates/claude/hooks/check-no-orphan-todo.mjs.ejs +45 -0
- package/dist/templates/claude/hooks/check-no-pii.mjs.ejs +121 -0
- package/dist/templates/claude/hooks/check-no-placeholders.mjs.ejs +71 -0
- package/dist/templates/claude/hooks/check-no-skipped-tests.mjs +80 -0
- package/dist/templates/claude/hooks/check-no-unused-exports.mjs +62 -0
- package/dist/templates/claude/hooks/closer-mode-guard.mjs.ejs +102 -0
- package/dist/templates/claude/hooks/debug-state-on-failure.mjs.ejs +98 -0
- package/dist/templates/claude/hooks/enforce-gate-before-pr.mjs +142 -0
- package/dist/templates/claude/hooks/enforce-read-only.mjs +28 -0
- package/dist/templates/claude/hooks/exitplanmode-banner.mjs.ejs +43 -0
- package/dist/templates/claude/hooks/guard-done-evidence.mjs.ejs +85 -0
- package/dist/templates/claude/hooks/guard-task-completion.mjs.ejs +56 -0
- package/dist/templates/claude/hooks/hooks.mjs.ejs +127 -0
- package/dist/templates/claude/hooks/lib.mjs.ejs +523 -0
- package/dist/templates/claude/hooks/post-brainstorm-stop.mjs +48 -0
- package/dist/templates/claude/hooks/post-commit-check.mjs.ejs +65 -0
- package/dist/templates/claude/hooks/post-commit-checklists/go/backend.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/go/docs.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/go/frontend.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/java/backend.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/java/docs.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/java/frontend.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/python/backend.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/python/docs.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/python/frontend.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/rust/backend.ejs +5 -0
- package/dist/templates/claude/hooks/post-commit-checklists/rust/docs.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/rust/frontend.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/ts/backend.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/ts/docs.ejs +4 -0
- package/dist/templates/claude/hooks/post-commit-checklists/ts/frontend.ejs +5 -0
- package/dist/templates/claude/hooks/post-edit-dispatch.mjs.ejs +73 -0
- package/dist/templates/claude/hooks/post-subagent-release.mjs +80 -0
- package/dist/templates/claude/hooks/pre-compact.mjs.ejs +79 -0
- package/dist/templates/claude/hooks/pre-edit-plan-anchor.mjs.ejs +225 -0
- package/dist/templates/claude/hooks/pre-edit-ssot-guard.mjs +204 -0
- package/dist/templates/claude/hooks/pre-spawn-worktree-guard.mjs +129 -0
- package/dist/templates/claude/hooks/skill-forced-eval.mjs.ejs +281 -0
- package/dist/templates/claude/hooks/stop-dangerous.mjs +86 -0
- package/dist/templates/claude/hooks/stop-evidence-guard.mjs.ejs +245 -0
- package/dist/templates/claude/hooks/stop-finding-loss.mjs.ejs +168 -0
- package/dist/templates/claude/hooks/wiki-on-commit.mjs.ejs +38 -0
- package/dist/templates/claude/knowledge-map.json.ejs +26 -0
- package/dist/templates/claude/rules/05-agent-lifecycle.md +7 -0
- package/dist/templates/claude/rules/25-todo-folder-policy.md +5 -0
- package/dist/templates/claude/rules/40-context-economy.md +32 -0
- package/dist/templates/claude/rules/45-mcp-fallback.md +25 -0
- package/dist/templates/claude/rules/50-batch-execution.md +75 -0
- package/dist/templates/claude/rules/55-brainstorm-terminal-state.md +44 -0
- package/dist/templates/claude/rules/60-incidental-capture.md +43 -0
- package/dist/templates/claude/rules/75-impact-vault-reading.md +43 -0
- package/dist/templates/claude/rules/90-exec-protocol.md.ejs +40 -0
- package/dist/templates/claude/rules/95-closer-mode.md +45 -0
- package/dist/templates/claude/settings.json.ejs +165 -0
- package/dist/templates/claude/skills/architect-review/SKILL.md.ejs +82 -0
- package/dist/templates/claude/skills/brainstorming/SKILL.md.ejs +86 -0
- package/dist/templates/claude/skills/clean-code/SKILL.md.ejs +39 -0
- package/dist/templates/claude/skills/close-gold-gap/SKILL.md.ejs +58 -0
- package/dist/templates/claude/skills/codebase-audit/SKILL.md.ejs +88 -0
- package/dist/templates/claude/skills/configure/SKILL.md.ejs +72 -0
- package/dist/templates/claude/skills/epic-decompose/SKILL.md.ejs +86 -0
- package/dist/templates/claude/skills/gold-audit/SKILL.md.ejs +91 -0
- package/dist/templates/claude/skills/impact/SKILL.md.ejs +104 -0
- package/dist/templates/claude/skills/levelup/SKILL.md.ejs +146 -0
- package/dist/templates/claude/skills/tabletop/SKILL.md.ejs +118 -0
- package/dist/templates/claude/skills/tdd/SKILL.md.ejs +157 -0
- package/dist/templates/claude/skills/understand-code/SKILL.md.ejs +93 -0
- package/dist/templates/claude/skills/verification/SKILL.md.ejs +68 -0
- package/dist/templates/claude/skills/wave-drain/SKILL.md.ejs +491 -0
- package/dist/templates/codex/CODEX.md.ejs +140 -0
- package/dist/templates/codex/codex-adapter.mjs +132 -0
- package/dist/templates/codex/config.toml.ejs +189 -0
- package/dist/templates/compliance/compliance-mapping.md.ejs +124 -0
- package/dist/templates/compliance/compliance-menu.md.ejs +89 -0
- package/dist/templates/contract-testing/CONTRACTS_POLICY.md.ejs +30 -0
- package/dist/templates/contract-testing/api-snapshots/config-keys-baseline.json.ejs +1 -0
- package/dist/templates/contract-testing/api-snapshots/config-response-baseline.json.ejs +1 -0
- package/dist/templates/contract-testing/api-snapshots/enum-values-baseline.json.ejs +1 -0
- package/dist/templates/contract-testing/api-snapshots/error-shape-baseline.json.ejs +6 -0
- package/dist/templates/contract-testing/api-snapshots/openapi-baseline.json.ejs +12 -0
- package/dist/templates/contract-testing/api-snapshots/openapi-content-types-baseline.json.ejs +3 -0
- package/dist/templates/contract-testing/api-snapshots/openapi-paths-baseline.json.ejs +1 -0
- package/dist/templates/contract-testing/api-snapshots/openapi-required-fields-baseline.json.ejs +1 -0
- package/dist/templates/contract-testing/api-snapshots/openapi-response-status-baseline.json.ejs +3 -0
- package/dist/templates/contract-testing/api-snapshots/test-snapshot.json.ejs +4 -0
- package/dist/templates/contract-testing/env/.env.pact.ejs +4 -0
- package/dist/templates/contract-testing/graphql/GraphqlSchemaTest.java.ejs +29 -0
- package/dist/templates/contract-testing/graphql/graphql-inspector.test.ts.ejs +20 -0
- package/dist/templates/contract-testing/graphql/graphql_schema_test.go.ejs +27 -0
- package/dist/templates/contract-testing/graphql/graphql_schema_test.rs.ejs +27 -0
- package/dist/templates/contract-testing/graphql/test_graphql_schema.py.ejs +21 -0
- package/dist/templates/contract-testing/grpc/GrpcContractTest.java.ejs +23 -0
- package/dist/templates/contract-testing/grpc/buf-breaking.yml.ejs +6 -0
- package/dist/templates/contract-testing/grpc/buf.yaml.ejs +11 -0
- package/dist/templates/contract-testing/grpc/grpc-contract.test.ts.ejs +16 -0
- package/dist/templates/contract-testing/grpc/grpc_contract_test.go.ejs +22 -0
- package/dist/templates/contract-testing/grpc/grpc_contract_test.rs.ejs +22 -0
- package/dist/templates/contract-testing/grpc/test_grpc_contract.py.ejs +18 -0
- package/dist/templates/contract-testing/message-queue/SchemaRegistryCheckIT.java.ejs +44 -0
- package/dist/templates/contract-testing/message-queue/schema-registry-check.ts.ejs +42 -0
- package/dist/templates/contract-testing/message-queue/schema_registry_test.go.ejs +71 -0
- package/dist/templates/contract-testing/message-queue/schema_registry_test.rs.ejs +61 -0
- package/dist/templates/contract-testing/message-queue/test_schema_registry.py.ejs +31 -0
- package/dist/templates/contract-testing/pact-samples/assignment-response.json.ejs +7 -0
- package/dist/templates/contract-testing/pact-samples/availability-response.json.ejs +13 -0
- package/dist/templates/contract-testing/pact-samples/availability-rule-response.json.ejs +8 -0
- package/dist/templates/contract-testing/pact-samples/capacity-response.json.ejs +11 -0
- package/dist/templates/contract-testing/pact-samples/fully-booked-response.json.ejs +6 -0
- package/dist/templates/contract-testing/pact-samples/schedule-override-response.json.ejs +7 -0
- package/dist/templates/contract-testing/rest-owned/PactVerificationIT.java.ejs +31 -0
- package/dist/templates/contract-testing/rest-owned/pact-consumer.test.ts.ejs +36 -0
- package/dist/templates/contract-testing/rest-owned/pact-deps.gradle.ejs +15 -0
- package/dist/templates/contract-testing/rest-owned/pact_consumer_test.go.ejs +48 -0
- package/dist/templates/contract-testing/rest-owned/pact_consumer_test.rs.ejs +23 -0
- package/dist/templates/contract-testing/rest-owned/test_pact_consumer.py.ejs +35 -0
- package/dist/templates/contract-testing/rest-public/OpenApiDiffIT.java.ejs +44 -0
- package/dist/templates/contract-testing/rest-public/export-openapi-java.gradle.ejs +13 -0
- package/dist/templates/contract-testing/rest-public/export-openapi.mjs.ejs +21 -0
- package/dist/templates/contract-testing/rest-public/export_openapi.go.ejs +30 -0
- package/dist/templates/contract-testing/rest-public/export_openapi.py.ejs +27 -0
- package/dist/templates/contract-testing/rest-public/export_openapi.rs.ejs +32 -0
- package/dist/templates/contract-testing/rest-public/openapi-diff.ts.ejs +42 -0
- package/dist/templates/contract-testing/rest-public/openapi_diff_test.go.ejs +35 -0
- package/dist/templates/contract-testing/rest-public/openapi_diff_test.rs.ejs +36 -0
- package/dist/templates/contract-testing/rest-public/test_openapi_diff.py.ejs +32 -0
- package/dist/templates/coverage/.coveragerc.ejs +26 -0
- package/dist/templates/coverage/.tarpaulin.toml.ejs +30 -0
- package/dist/templates/coverage/Cargo.toml.profile.release.ejs +24 -0
- package/dist/templates/coverage/jacoco-maven-setup.md.ejs +72 -0
- package/dist/templates/coverage/jacoco.gradle.ejs +49 -0
- package/dist/templates/coverage/kover.gradle.ejs +35 -0
- package/dist/templates/coverage/vitest.browser.config.ts.ejs +47 -0
- package/dist/templates/coverage/vitest.config.ts.ejs +47 -0
- package/dist/templates/docs/CODING_STANDARDS.md.ejs +81 -0
- package/dist/templates/docs/FEATURE_MATRIX.md.ejs +84 -0
- package/dist/templates/docs/GAP.md.ejs +58 -0
- package/dist/templates/docs/ISO27001_ANNEX_A.md.ejs +144 -0
- package/dist/templates/docs/MASTER_TEST_PLAN.md.ejs +52 -0
- package/dist/templates/docs/POST_MERGE_REVIEW_TEMPLATE.md.ejs +63 -0
- package/dist/templates/docs/SECURE_CODING_CHECKLIST.md.ejs +61 -0
- package/dist/templates/docs/adr/ADR-000_template.md.ejs +28 -0
- package/dist/templates/docs/bugs/bug-analysis.md.ejs +47 -0
- package/dist/templates/docs/bugs/bug-report.md.ejs +51 -0
- package/dist/templates/docs/bugs/bug-verification.md.ejs +42 -0
- package/dist/templates/docs/runbooks/deployment.md.ejs +119 -0
- package/dist/templates/docs/runbooks/prod-checklist.md.ejs +90 -0
- package/dist/templates/docs/runbooks/rollback.md.ejs +124 -0
- package/dist/templates/docs/runbooks/troubleshooting.md.ejs +130 -0
- package/dist/templates/docs/skeletons/arc42-canvas.md.ejs +46 -0
- package/dist/templates/docs/skeletons/arc42-full.md.ejs +59 -0
- package/dist/templates/docs/skeletons/decision-registry.md.ejs +38 -0
- package/dist/templates/docs/skeletons/er-model.md.ejs +19 -0
- package/dist/templates/docs/skeletons/glossary.md.ejs +8 -0
- package/dist/templates/docs/skeletons/governance.md.ejs +13 -0
- package/dist/templates/docs/skeletons/slo.md.ejs +21 -0
- package/dist/templates/docs/skeletons/technical-debt.md.ejs +8 -0
- package/dist/templates/docs/skeletons/test-strategy.md.ejs +14 -0
- package/dist/templates/docs/skeletons/threat-model-4q.md.ejs +20 -0
- package/dist/templates/docs/skeletons/threat-model-stride.md.ejs +22 -0
- package/dist/templates/docs/specs/atomic-task-list.md.ejs +57 -0
- package/dist/templates/docs/steering/product.md.ejs +44 -0
- package/dist/templates/docs/steering/structure.md.ejs +49 -0
- package/dist/templates/docs/steering/tech.md.ejs +53 -0
- package/dist/templates/documentation/cli-catalog.md.ejs +21 -0
- package/dist/templates/e2e/E2E_CONSTITUTION.md.ejs +77 -0
- package/dist/templates/e2e/playwright-python/conftest.py.ejs +22 -0
- package/dist/templates/e2e/playwright-python/run_axe.py.ejs +99 -0
- package/dist/templates/e2e/playwright-python/test_a11y.py.ejs +38 -0
- package/dist/templates/e2e/playwright-python/test_smoke.py.ejs +28 -0
- package/dist/templates/e2e/playwright-ts/a11y.spec.ts.ejs +20 -0
- package/dist/templates/e2e/playwright-ts/render-smoke.spec.ts.ejs +90 -0
- package/dist/templates/e2e/playwright-ts/run-axe.ts.ejs +74 -0
- package/dist/templates/e2e/smoke-journeys/journeys.spec.ts.ejs +53 -0
- package/dist/templates/evidence-files.json.ejs +13 -0
- package/dist/templates/frontend/FE_DESIGN_PRINCIPLES.md.ejs +115 -0
- package/dist/templates/frontend/FRONTEND_CONSTITUTION.md.ejs +170 -0
- package/dist/templates/frontend/design-tokens.json.ejs +107 -0
- package/dist/templates/frontend/vrt-setup.md.ejs +83 -0
- package/dist/templates/githooks/commit-msg.ejs +60 -0
- package/dist/templates/githooks/pre-commit.ejs +95 -0
- package/dist/templates/githooks/pre-push.ejs +251 -0
- package/dist/templates/githooks/setup-hooks.sh.ejs +8 -0
- package/dist/templates/github/PULL_REQUEST_TEMPLATE.md +37 -0
- package/dist/templates/github/PULL_REQUEST_TEMPLATE.md.ejs +52 -0
- package/dist/templates/github/actions/build-cache/action.yml.ejs +84 -0
- package/dist/templates/github/actions/nas-ssh/action.yml.ejs +53 -0
- package/dist/templates/github/actions/setup-java-maven/action.yml.ejs +53 -0
- package/dist/templates/github/actions/setup-node-pnpm/action.yml.ejs +39 -0
- package/dist/templates/github/actions/sign-and-attest/action.yml.ejs +53 -0
- package/dist/templates/github/dependabot.yml.ejs +66 -0
- package/dist/templates/github/extended-ci-paths.txt.ejs +38 -0
- package/dist/templates/github/issue-templates/bug-report.yml +72 -0
- package/dist/templates/github/issue-templates/compliance-item.yml.ejs +75 -0
- package/dist/templates/github/issue-templates/config.yml +2 -0
- package/dist/templates/github/issue-templates/epic.yml +66 -0
- package/dist/templates/github/issue-templates/feature-request.yml +24 -0
- package/dist/templates/github/issue-templates/task-brief.yml.ejs +125 -0
- package/dist/templates/github/labels.yml.ejs +161 -0
- package/dist/templates/github/scripts/sticky-failure-issue.sh.ejs +61 -0
- package/dist/templates/github/workflows/01-pr-fast.yml.ejs +1089 -0
- package/dist/templates/github/workflows/02-pr-extended.yml.ejs +512 -0
- package/dist/templates/github/workflows/03-human-approval.yml.ejs +76 -0
- package/dist/templates/github/workflows/04-deploy-test.yml.ejs +425 -0
- package/dist/templates/github/workflows/05-release.yml.ejs +813 -0
- package/dist/templates/github/workflows/06-nightly-lite.yml.ejs +125 -0
- package/dist/templates/github/workflows/06-nightly.yml.ejs +25 -0
- package/dist/templates/github/workflows/07-weekly-lite.yml.ejs +221 -0
- package/dist/templates/github/workflows/07-weekly.yml.ejs +23 -0
- package/dist/templates/github/workflows/08-monthly.yml.ejs +23 -0
- package/dist/templates/github/workflows/09-heartbeat.yml.ejs +268 -0
- package/dist/templates/github/workflows/10-deploy-prod.yml.ejs +144 -0
- package/dist/templates/github/workflows/11-k6-on-demand.yml.ejs +43 -0
- package/dist/templates/github/workflows/12-mutation-scheduled.yml.ejs +100 -0
- package/dist/templates/github/workflows/13-archunit-extended.yml.ejs +33 -0
- package/dist/templates/github/workflows/14-license-scan.yml.ejs +45 -0
- package/dist/templates/github/workflows/15-codeql.yml.ejs +117 -0
- package/dist/templates/github/workflows/16-frontend-quality.yml.ejs +154 -0
- package/dist/templates/github/workflows/17-ossf-scorecard.yml.ejs +46 -0
- package/dist/templates/github/workflows/18-frontend-lane.yml.ejs +50 -0
- package/dist/templates/github/workflows/_ai-draft-check.yml.ejs +44 -0
- package/dist/templates/github/workflows/_contract-postman.yml.ejs +93 -0
- package/dist/templates/github/workflows/_cosign-copy/aws-ecs.ejs +90 -0
- package/dist/templates/github/workflows/_cosign-copy/azure-container-app.ejs +97 -0
- package/dist/templates/github/workflows/_cosign-copy/gcp-cloud-run.ejs +102 -0
- package/dist/templates/github/workflows/_cosign-copy/ghcr.ejs +76 -0
- package/dist/templates/github/workflows/_cosign-copy/nas-compose.ejs +69 -0
- package/dist/templates/github/workflows/_deploy/aws-ecs.ejs +78 -0
- package/dist/templates/github/workflows/_deploy/azure-container-app.ejs +59 -0
- package/dist/templates/github/workflows/_deploy/gcp-cloud-run.ejs +71 -0
- package/dist/templates/github/workflows/_deploy/ghcr.ejs +19 -0
- package/dist/templates/github/workflows/_deploy/nas-compose.ejs +45 -0
- package/dist/templates/github/workflows/_k6-runner.yml.ejs +107 -0
- package/dist/templates/github/workflows/_label-on-approve.yml.ejs +44 -0
- package/dist/templates/github/workflows/_label-sync.yml.ejs +58 -0
- package/dist/templates/github/workflows/_monthly.yml.ejs +343 -0
- package/dist/templates/github/workflows/_nightly.yml.ejs +826 -0
- package/dist/templates/github/workflows/_notify.yml.ejs +96 -0
- package/dist/templates/github/workflows/_partials/macos-keychain-bypass.ejs +6 -0
- package/dist/templates/github/workflows/_partials/macos-keychain-restore.ejs +6 -0
- package/dist/templates/github/workflows/_partials/scheduled-heavy-jobs.ejs +117 -0
- package/dist/templates/github/workflows/_partials/sigstore-preflight.ejs +8 -0
- package/dist/templates/github/workflows/_partials/trivy-fs-java.ejs +27 -0
- package/dist/templates/github/workflows/_post-merge-notify.yml.ejs +228 -0
- package/dist/templates/github/workflows/_pr-staleness.yml.ejs +85 -0
- package/dist/templates/github/workflows/_shared-security.yml.ejs +132 -0
- package/dist/templates/github/workflows/_sigstore-retry-sign.yml.ejs +102 -0
- package/dist/templates/github/workflows/_weekly.yml.ejs +313 -0
- package/dist/templates/github/workflows/drift-shadow.yml.ejs +51 -0
- package/dist/templates/github/workflows/five-lane/ci.yml.ejs +54 -0
- package/dist/templates/github/workflows/five-lane/nightly.yml.ejs +70 -0
- package/dist/templates/github/workflows/five-lane/release.yml.ejs +53 -0
- package/dist/templates/github/workflows/five-lane/weekly.yml.ejs +72 -0
- package/dist/templates/github/workflows/issue-state.yml.ejs +93 -0
- package/dist/templates/global-invariants/GLOBAL_INVARIANTS.md.ejs +34 -0
- package/dist/templates/governance/RACI.md.ejs +21 -0
- package/dist/templates/governance/ci-mental-model.md.ejs +268 -0
- package/dist/templates/governance/contract-integrity-policy.md.ejs +116 -0
- package/dist/templates/governance/enterprise-compliance-baseline.md.ejs +111 -0
- package/dist/templates/governance/evidence-retention.md.ejs +43 -0
- package/dist/templates/governance/gdpr-erasure-runbook.md.ejs +165 -0
- package/dist/templates/governance/qa-audit-phases.md.ejs +129 -0
- package/dist/templates/governance/risk-assessment-template.md.ejs +105 -0
- package/dist/templates/governance/risk-register.md.ejs +76 -0
- package/dist/templates/governance/solo-dev-exception.md.ejs +96 -0
- package/dist/templates/governance/validation-evidence.md.ejs +131 -0
- package/dist/templates/infra/azure/containerapp.tpl.yaml.ejs +74 -0
- package/dist/templates/infra/nas-compose/deploy.sh.ejs +114 -0
- package/dist/templates/integration-testing/AbstractIntegrationTest.java.ejs +36 -0
- package/dist/templates/integration-testing/NoH2ArchTest.java.ejs +24 -0
- package/dist/templates/integration-testing/conftest.py.ejs +20 -0
- package/dist/templates/integration-testing/db_fixture.rs.ejs +48 -0
- package/dist/templates/integration-testing/eslint-no-fake-db.json.ejs +19 -0
- package/dist/templates/integration-testing/eslint.config.no-fake-db.mjs.ejs +46 -0
- package/dist/templates/integration-testing/main_test.go.ejs +53 -0
- package/dist/templates/integration-testing/main_test_sqlite.go.ejs +37 -0
- package/dist/templates/integration-testing/test-setup.ts.ejs +26 -0
- package/dist/templates/integration-testing/testcontainers-deps.gradle.ejs +9 -0
- package/dist/templates/java/DeprecationInterceptor.java.ejs +50 -0
- package/dist/templates/java/archunit-hexagonal.ejs +69 -0
- package/dist/templates/java/modulith/ApplicationModulesTest.java.ejs +21 -0
- package/dist/templates/java/modulith/modulith-deps.gradle.ejs +13 -0
- package/dist/templates/java/modulith/modulith-maven-setup.md.ejs +21 -0
- package/dist/templates/java/pharma/AuditEvent.java.ejs +138 -0
- package/dist/templates/java/pharma/AuditMapper.java.ejs +60 -0
- package/dist/templates/java/pharma/archunit-pharma.ejs +128 -0
- package/dist/templates/kit/GLOBAL_KIT.md.ejs +11 -0
- package/dist/templates/kit/dim.md.ejs +33 -0
- package/dist/templates/llms-txt.config.json.ejs +22 -0
- package/dist/templates/local-wrapper/.env.example.ejs +15 -0
- package/dist/templates/local-wrapper/Makefile.ejs +44 -0
- package/dist/templates/local-wrapper/run.sh.ejs +5 -0
- package/dist/templates/middleware/410-gone-handler.ts.ejs +41 -0
- package/dist/templates/middleware/correlation-id.ts.ejs +32 -0
- package/dist/templates/middleware/deprecation.ts.ejs +45 -0
- package/dist/templates/middleware/error-handler.ts.ejs +73 -0
- package/dist/templates/middleware/payload-size-limit.ts.ejs +51 -0
- package/dist/templates/mutation/README.md.ejs +67 -0
- package/dist/templates/mutation/cargo-mutants.toml.ejs +9 -0
- package/dist/templates/mutation/mutmut-config.toml.ejs +7 -0
- package/dist/templates/mutation/parse-mutants.mjs.ejs +44 -0
- package/dist/templates/mutation/parse-mutmut.py.ejs +44 -0
- package/dist/templates/mutation/pitest-l2-setup.md.ejs +66 -0
- package/dist/templates/mutation/pitest-maven-setup.md.ejs +64 -0
- package/dist/templates/mutation/pitest.gradle.ejs +23 -0
- package/dist/templates/mutation/stryker.conf.json.ejs +17 -0
- package/dist/templates/observability/setup.md.ejs +495 -0
- package/dist/templates/operations/handbook.md.ejs +217 -0
- package/dist/templates/perf/bundle-budget.json.ejs +29 -0
- package/dist/templates/perf/k6/reports/csv-report.py.ejs +91 -0
- package/dist/templates/perf/k6/reports/html-report.py.ejs +114 -0
- package/dist/templates/perf/k6/reports/json-report.py.ejs +74 -0
- package/dist/templates/perf/k6/scenarios/breakpoint.js.ejs +26 -0
- package/dist/templates/perf/k6/scenarios/burst.js.ejs +43 -0
- package/dist/templates/perf/k6/scenarios/endurance.js.ejs +36 -0
- package/dist/templates/perf/k6/scenarios/load.js.ejs +26 -0
- package/dist/templates/perf/k6/scenarios/ramp-down.js.ejs +29 -0
- package/dist/templates/perf/k6/scenarios/ramp-up.js.ejs +32 -0
- package/dist/templates/perf/k6/scenarios/smoke.js.ejs +23 -0
- package/dist/templates/perf/k6/scenarios/soak.js.ejs +26 -0
- package/dist/templates/perf/k6/scenarios/spike.js.ejs +29 -0
- package/dist/templates/perf/k6/scenarios/steady-state.js.ejs +31 -0
- package/dist/templates/perf/k6/scenarios/stress.js.ejs +29 -0
- package/dist/templates/perf/k6/scenarios/volume.js.ejs +36 -0
- package/dist/templates/perf/k6/seed/test-data.sql.ejs +59 -0
- package/dist/templates/perf/lighthouserc.json.ejs +41 -0
- package/dist/templates/quality/iso9001/CAPA_LOG.md.ejs +36 -0
- package/dist/templates/quality/iso9001/DOCUMENT_CONTROL.md.ejs +36 -0
- package/dist/templates/quality/iso9001/REQUIREMENTS_TRACEABILITY.md.ejs +61 -0
- package/dist/templates/regulated/overlay.json.ejs +26 -0
- package/dist/templates/regulated/regulated-overlay.md.ejs +40 -0
- package/dist/templates/resilience/RESILIENCE.md.ejs +310 -0
- package/dist/templates/root/.gitignore.ejs +85 -0
- package/dist/templates/root/CODEOWNERS.ejs +18 -0
- package/dist/templates/root/CONTRIBUTING.md.ejs +62 -0
- package/dist/templates/root/SECURITY.md.ejs +19 -0
- package/dist/templates/root/TEST_TAXONOMY.md.ejs +100 -0
- package/dist/templates/root/commitlint.config.js.ejs +4 -0
- package/dist/templates/root/docs/METHOD/CANONICAL_PATHS.md.ejs +24 -0
- package/dist/templates/root/docs/METHOD/ENGINEERING_DEFAULTS.md.ejs +136 -0
- package/dist/templates/root/docs/METHOD/KNOWLEDGE_MAP.md.ejs +90 -0
- package/dist/templates/root/docs/METHOD/PATTERNS_CATALOG.md.ejs +51 -0
- package/dist/templates/root/docs/METHOD/REUSE_REGISTRY.md.ejs +26 -0
- package/dist/templates/root/docs/METHOD/REUSE_REGISTRY_SPEC.md.ejs +80 -0
- package/dist/templates/root/docs/METHOD/SSOT_CORE_SET.md.ejs +62 -0
- package/dist/templates/root/docs/METHOD/TRACK_ROUTER.md.ejs +39 -0
- package/dist/templates/root/docs/SYSTEM/CANON.md.ejs +359 -0
- package/dist/templates/root/docs/SYSTEM/FAIL_CLOSED.md.ejs +171 -0
- package/dist/templates/root/editorconfig.ejs +39 -0
- package/dist/templates/root/tsconfig.json.ejs +21 -0
- package/dist/templates/rust/clippy.toml.ejs +14 -0
- package/dist/templates/schemas/milestone.schema.json.ejs +164 -0
- package/dist/templates/schemas/rtm-verdict.schema.json.ejs +52 -0
- package/dist/templates/schemas/source-record.schema.json.ejs +91 -0
- package/dist/templates/schemas/tabletop-evidence.schema.json.ejs +53 -0
- package/dist/templates/schemas/use-case.schema.json.ejs +59 -0
- package/dist/templates/scripts/apply-branch-protection.mjs.ejs +70 -0
- package/dist/templates/scripts/audit-toolchain.mjs.ejs +112 -0
- package/dist/templates/scripts/bg-run.sh.ejs +59 -0
- package/dist/templates/scripts/capacity-probe.mjs.ejs +147 -0
- package/dist/templates/scripts/capture-debt-baseline.mjs.ejs +99 -0
- package/dist/templates/scripts/check-acceptance.mjs.ejs +298 -0
- package/dist/templates/scripts/check-action-pins.mjs.ejs +215 -0
- package/dist/templates/scripts/check-agent-return.mjs.ejs +177 -0
- package/dist/templates/scripts/check-all.mjs.ejs +1746 -0
- package/dist/templates/scripts/check-anti-fake-green.mjs.ejs +80 -0
- package/dist/templates/scripts/check-anti-proforma.mjs.ejs +547 -0
- package/dist/templates/scripts/check-api-e2e.mjs.ejs +106 -0
- package/dist/templates/scripts/check-arc42-slots.mjs.ejs +25 -0
- package/dist/templates/scripts/check-assertion-delta.mjs.ejs +287 -0
- package/dist/templates/scripts/check-audit-dry-pass.mjs.ejs +176 -0
- package/dist/templates/scripts/check-bundle-size.mjs.ejs +151 -0
- package/dist/templates/scripts/check-canonical-paths.mjs.ejs +39 -0
- package/dist/templates/scripts/check-ci-tiers.mjs.ejs +111 -0
- package/dist/templates/scripts/check-claude-md-lint.mjs.ejs +142 -0
- package/dist/templates/scripts/check-collab-mode-wired.mjs.ejs +60 -0
- package/dist/templates/scripts/check-commit-footer-rationale.mjs.ejs +170 -0
- package/dist/templates/scripts/check-constraint-scan.mjs.ejs +681 -0
- package/dist/templates/scripts/check-consumer-audit.mjs.ejs +414 -0
- package/dist/templates/scripts/check-continue-on-error.mjs.ejs +227 -0
- package/dist/templates/scripts/check-cross-model-review.mjs.ejs +458 -0
- package/dist/templates/scripts/check-decision-registry.mjs.ejs +101 -0
- package/dist/templates/scripts/check-doc-freshness.mjs.ejs +17 -0
- package/dist/templates/scripts/check-doc-links.mjs.ejs +98 -0
- package/dist/templates/scripts/check-doc-set.mjs.ejs +18 -0
- package/dist/templates/scripts/check-docs.mjs.ejs +71 -0
- package/dist/templates/scripts/check-domain-api-surface.mjs.ejs +80 -0
- package/dist/templates/scripts/check-drift.mjs.ejs +167 -0
- package/dist/templates/scripts/check-duplication.mjs.ejs +45 -0
- package/dist/templates/scripts/check-e2e-escalation.mjs.ejs +199 -0
- package/dist/templates/scripts/check-e2e-quarantine.mjs.ejs +68 -0
- package/dist/templates/scripts/check-emission-parity.mjs.ejs +91 -0
- package/dist/templates/scripts/check-exit-code-contract.mjs.ejs +138 -0
- package/dist/templates/scripts/check-fail-closed-audit.mjs.ejs +389 -0
- package/dist/templates/scripts/check-fe-boundaries.mjs.ejs +184 -0
- package/dist/templates/scripts/check-feature-matrix.mjs.ejs +835 -0
- package/dist/templates/scripts/check-frontend-lane.mjs.ejs +73 -0
- package/dist/templates/scripts/check-grace-window.mjs.ejs +102 -0
- package/dist/templates/scripts/check-handoff-doc.mjs.ejs +192 -0
- package/dist/templates/scripts/check-hook-routing.mjs.ejs +224 -0
- package/dist/templates/scripts/check-image-pins.mjs.ejs +90 -0
- package/dist/templates/scripts/check-inline-suppressions.mjs.ejs +153 -0
- package/dist/templates/scripts/check-iso9001.mjs.ejs +146 -0
- package/dist/templates/scripts/check-knowledge-map.mjs.ejs +49 -0
- package/dist/templates/scripts/check-local-ci-parity.mjs.ejs +382 -0
- package/dist/templates/scripts/check-m16-handoff.mjs.ejs +112 -0
- package/dist/templates/scripts/check-merge-method.mjs.ejs +92 -0
- package/dist/templates/scripts/check-milestones.mjs.ejs +678 -0
- package/dist/templates/scripts/check-min-test-execution.mjs.ejs +225 -0
- package/dist/templates/scripts/check-muted-test.mjs.ejs +270 -0
- package/dist/templates/scripts/check-no-stub-redirects.mjs.ejs +154 -0
- package/dist/templates/scripts/check-no-tracked-artifacts.mjs.ejs +134 -0
- package/dist/templates/scripts/check-oracle-discrimination.mjs.ejs +244 -0
- package/dist/templates/scripts/check-pii-scan.mjs.ejs +67 -0
- package/dist/templates/scripts/check-pipe-tee-hazard.mjs.ejs +85 -0
- package/dist/templates/scripts/check-pr-size-gate.mjs.ejs +85 -0
- package/dist/templates/scripts/check-refutation-verdicts.mjs.ejs +256 -0
- package/dist/templates/scripts/check-regulated-overlay.mjs.ejs +158 -0
- package/dist/templates/scripts/check-render-smoke.mjs.ejs +100 -0
- package/dist/templates/scripts/check-reuse-registry.mjs.ejs +44 -0
- package/dist/templates/scripts/check-review-completion.mjs.ejs +708 -0
- package/dist/templates/scripts/check-safety-adopt-ratchet.mjs.ejs +142 -0
- package/dist/templates/scripts/check-secret-presence.mjs.ejs +191 -0
- package/dist/templates/scripts/check-secret-scan.mjs.ejs +82 -0
- package/dist/templates/scripts/check-skip-critical-e2e.mjs.ejs +142 -0
- package/dist/templates/scripts/check-smoke-journeys.mjs.ejs +272 -0
- package/dist/templates/scripts/check-solo-reactivation.mjs.ejs +102 -0
- package/dist/templates/scripts/check-sources.mjs.ejs +245 -0
- package/dist/templates/scripts/check-ssot-core.mjs.ejs +45 -0
- package/dist/templates/scripts/check-stack-conformity.mjs.ejs +160 -0
- package/dist/templates/scripts/check-stride-traceability.mjs.ejs +101 -0
- package/dist/templates/scripts/check-suppression-expiry.mjs.ejs +79 -0
- package/dist/templates/scripts/check-suppression-rationale.mjs.ejs +76 -0
- package/dist/templates/scripts/check-suppressions.mjs.ejs +150 -0
- package/dist/templates/scripts/check-tabletop-evidence.mjs.ejs +499 -0
- package/dist/templates/scripts/check-tdd-evidence.mjs.ejs +381 -0
- package/dist/templates/scripts/check-test-naming.mjs.ejs +151 -0
- package/dist/templates/scripts/check-test-pyramid.mjs.ejs +170 -0
- package/dist/templates/scripts/check-test-scope-tier.mjs.ejs +208 -0
- package/dist/templates/scripts/check-tier-coverage.mjs.ejs +71 -0
- package/dist/templates/scripts/check-todo-max-age.mjs.ejs +205 -0
- package/dist/templates/scripts/check-touched-vs-manifest.mjs.ejs +179 -0
- package/dist/templates/scripts/check-unwired-guards.mjs.ejs +367 -0
- package/dist/templates/scripts/check-use-cases.mjs.ejs +345 -0
- package/dist/templates/scripts/check-validator-helptext.mjs.ejs +80 -0
- package/dist/templates/scripts/check-wiki-lint.mjs.ejs +162 -0
- package/dist/templates/scripts/check-workflow-docs-sync.mjs.ejs +91 -0
- package/dist/templates/scripts/check-workflow-job-naming.mjs.ejs +102 -0
- package/dist/templates/scripts/check-workflow-perms.mjs.ejs +54 -0
- package/dist/templates/scripts/check-workflow-runners.mjs.ejs +87 -0
- package/dist/templates/scripts/check-workflow-sha-pinning.mjs.ejs +89 -0
- package/dist/templates/scripts/check-workflow-test-integrity.mjs.ejs +235 -0
- package/dist/templates/scripts/checks/check-rust-no-unsafe.mjs.ejs +58 -0
- package/dist/templates/scripts/checks/check-rust-no-unwrap.mjs.ejs +61 -0
- package/dist/templates/scripts/ci-classify-changes.mjs.ejs +119 -0
- package/dist/templates/scripts/conformance.mjs.ejs +37 -0
- package/dist/templates/scripts/constraint-map.json.ejs +25 -0
- package/dist/templates/scripts/debt-lib.mjs.ejs +1015 -0
- package/dist/templates/scripts/debt-report.mjs.ejs +199 -0
- package/dist/templates/scripts/domain-api-surface.json.ejs +23 -0
- package/dist/templates/scripts/done-evidence.mjs.ejs +359 -0
- package/dist/templates/scripts/evidence-collect.mjs.ejs +264 -0
- package/dist/templates/scripts/evidence-prune.mjs.ejs +96 -0
- package/dist/templates/scripts/evidence-rotate.mjs.ejs +53 -0
- package/dist/templates/scripts/evidence-writer.sh.ejs +220 -0
- package/dist/templates/scripts/gate-registry.yml.ejs +286 -0
- package/dist/templates/scripts/gen-doc-index.mjs.ejs +19 -0
- package/dist/templates/scripts/gen-gap.mjs.ejs +153 -0
- package/dist/templates/scripts/gen-llms-txt.mjs.ejs +18 -0
- package/dist/templates/scripts/gen-wiki.mjs.ejs +196 -0
- package/dist/templates/scripts/gh-cleanup-expired-artifacts.mjs.ejs +134 -0
- package/dist/templates/scripts/gold-audit.mjs.ejs +19 -0
- package/dist/templates/scripts/i18n-literal-scanner.mjs.ejs +175 -0
- package/dist/templates/scripts/ingest-zap-report.mjs.ejs +107 -0
- package/dist/templates/scripts/inject-pact-samples.sh.ejs +96 -0
- package/dist/templates/scripts/issue-readiness.mjs.ejs +84 -0
- package/dist/templates/scripts/knowledge-map-update.mjs.ejs +32 -0
- package/dist/templates/scripts/lib/acceptance-criteria.mjs.ejs +213 -0
- package/dist/templates/scripts/lib/agent-return-validate.mjs.ejs +481 -0
- package/dist/templates/scripts/lib/coverage-gate.mjs.ejs +54 -0
- package/dist/templates/scripts/lib/e2e-reliability.mjs.ejs +207 -0
- package/dist/templates/scripts/lib/ephemeral-server.mjs.ejs +148 -0
- package/dist/templates/scripts/lib/evidence-binding.mjs.ejs +140 -0
- package/dist/templates/scripts/lib/exact-sha-policy.mjs.ejs +233 -0
- package/dist/templates/scripts/lib/gate-args.mjs.ejs +20 -0
- package/dist/templates/scripts/lib/gate-evidence.mjs.ejs +622 -0
- package/dist/templates/scripts/lib/gate-mutex.mjs.ejs +340 -0
- package/dist/templates/scripts/lib/glob-walk.mjs.ejs +148 -0
- package/dist/templates/scripts/lib/run-helpers.mjs.ejs +416 -0
- package/dist/templates/scripts/lib/seed-common.sh.ejs +105 -0
- package/dist/templates/scripts/lib/waiter-count.mjs.ejs +62 -0
- package/dist/templates/scripts/muted-tests-baseline.json.ejs +4 -0
- package/dist/templates/scripts/optional-emissions.json.ejs +117 -0
- package/dist/templates/scripts/oracle-discrimination-baseline.json.ejs +6 -0
- package/dist/templates/scripts/pid-watch.sh.ejs +78 -0
- package/dist/templates/scripts/pii-scan.mjs.ejs +125 -0
- package/dist/templates/scripts/pr-merge-watch.mjs.ejs +445 -0
- package/dist/templates/scripts/record-agent-return.mjs.ejs +279 -0
- package/dist/templates/scripts/record-journey-evidence.mjs.ejs +69 -0
- package/dist/templates/scripts/rework-log.mjs.ejs +172 -0
- package/dist/templates/scripts/run-postman-tests.sh.ejs +112 -0
- package/dist/templates/scripts/schemas/agent-return-external.schema.json +74 -0
- package/dist/templates/scripts/schemas/agent-return.schema.json.ejs +181 -0
- package/dist/templates/scripts/schemas/cross-model-dispatch.schema.json +95 -0
- package/dist/templates/scripts/seed-test-data.sh.ejs +99 -0
- package/dist/templates/scripts/self-validation.mjs.ejs +126 -0
- package/dist/templates/scripts/setup-repo.sh.ejs +78 -0
- package/dist/templates/scripts/spotbugs-baseline.json.ejs +4 -0
- package/dist/templates/scripts/test-gate-layering.mjs.ejs +92 -0
- package/dist/templates/scripts/validate-api-snapshots.mjs.ejs +86 -0
- package/dist/templates/scripts/validate-k6-scenarios.mjs.ejs +96 -0
- package/dist/templates/scripts/validate-openapi-field-types.mjs.ejs +124 -0
- package/dist/templates/scripts/validate-postman-collection.mjs.ejs +159 -0
- package/dist/templates/scripts/verify-fe-coverage.mjs.ejs +138 -0
- package/dist/templates/scripts/verify-i18n-parity.mjs.ejs +114 -0
- package/dist/templates/scripts/verify-module-coverage.mjs.ejs +207 -0
- package/dist/templates/scripts/verify-mutation-baseline.mjs.ejs +209 -0
- package/dist/templates/scripts/verify-spotbugs.mjs.ejs +216 -0
- package/dist/templates/scripts/verify-tokens.mjs.ejs +177 -0
- package/dist/templates/security/RISK_ASSESSMENT.md.ejs +35 -0
- package/dist/templates/security/STRIDE.md.ejs +24 -0
- package/dist/templates/security/gitleaks.toml.ejs +21 -0
- package/dist/templates/security/zap/baseline-auth.context.ejs +58 -0
- package/dist/templates/security/zap/rules.tsv.ejs +100 -0
- package/dist/templates/ship/TICK_PROMPT.md.ejs +55 -0
- package/dist/templates/ship/supervisor.sh.ejs +46 -0
- package/dist/templates/smoke-journeys/manifest.json.ejs +1 -0
- package/dist/templates/sonar-project.properties.ejs +25 -0
- package/dist/templates/standards/doc-profile.ejs +27 -0
- package/dist/templates/standards/gold-doc-set.yml.ejs +528 -0
- package/dist/templates/standards/gold-registry.java.yml.ejs +266 -0
- package/dist/templates/standards/gold-registry.typescript.yml.ejs +104 -0
- package/dist/templates/standards/gold-registry.yml.ejs +119 -0
- package/dist/templates/standards/thresholds.yml.ejs +86 -0
- package/dist/templates/static-analysis/.dependency-cruiser.cjs.ejs +78 -0
- package/dist/templates/static-analysis/.golangci.yml.ejs +70 -0
- package/dist/templates/static-analysis/.shellcheckrc.ejs +13 -0
- package/dist/templates/static-analysis/.yamllint.yml.ejs +41 -0
- package/dist/templates/static-analysis/checkstyle.xml.ejs +83 -0
- package/dist/templates/static-analysis/detekt.yml.ejs +26 -0
- package/dist/templates/static-analysis/eslint.config.mjs.ejs +54 -0
- package/dist/templates/static-analysis/eslint.config.static.mjs.ejs +38 -0
- package/dist/templates/static-analysis/eslintrc-static.json.ejs +30 -0
- package/dist/templates/static-analysis/jscpd.json.ejs +25 -0
- package/dist/templates/static-analysis/knip.json.ejs +26 -0
- package/dist/templates/static-analysis/pmd-ruleset.xml.ejs +92 -0
- package/dist/templates/static-analysis/prettierignore.ejs +59 -0
- package/dist/templates/static-analysis/prettierrc.json.ejs +10 -0
- package/dist/templates/static-analysis/requirements-dev.txt.ejs +11 -0
- package/dist/templates/static-analysis/ruff.toml.ejs +40 -0
- package/dist/templates/static-analysis/rustfmt.toml.ejs +3 -0
- package/dist/templates/static-analysis/spotbugs-exclude.xml.ejs +120 -0
- package/dist/templates/static-analysis/spotbugs.gradle.ejs +18 -0
- package/dist/templates/static-analysis/spotless.gradle.ejs +38 -0
- package/dist/templates/static-analysis/stylelintrc.json.ejs +16 -0
- package/dist/templates/suppressions/archunit-baseline.json.ejs +1 -0
- package/dist/templates/suppressions/consumer-audit-allowlist.json.ejs +1 -0
- package/dist/templates/suppressions/gitleaksignore.ejs +20 -0
- package/dist/templates/suppressions/pii-allowlist.json.ejs +1 -0
- package/dist/templates/suppressions/suppressions-schema.json.ejs +39 -0
- package/dist/templates/suppressions/trivyignore.ejs +17 -0
- package/dist/templates/testing/test-taxonomy.md.ejs +120 -0
- package/dist/test/example.behavioral.test.js +2 -0
- package/dist/types/memory.d.ts +19 -0
- package/dist/types/memory.js +1 -0
- package/dist/types/plan.d.ts +102 -0
- package/dist/types/plan.js +2 -0
- package/dist/types/plugin.d.ts +45 -0
- package/dist/types/plugin.js +1 -0
- package/dist/utils/canon-loader.js +2 -0
- package/dist/utils/channel.js +1 -0
- package/dist/utils/config.d.ts +79 -0
- package/dist/utils/config.js +5 -0
- package/dist/utils/confirm-downgrade.js +5 -0
- package/dist/utils/env.js +2 -0
- package/dist/utils/error-catalog.js +2 -0
- package/dist/utils/errors.js +2 -0
- package/dist/utils/evidence-log.js +3 -0
- package/dist/utils/file-lock.js +2 -0
- package/dist/utils/first-run.js +8 -0
- package/dist/utils/fs.js +3 -0
- package/dist/utils/github-issue-helper.js +4 -0
- package/dist/utils/gradle.js +21 -0
- package/dist/utils/json-output.js +2 -0
- package/dist/utils/logger-config.js +4 -0
- package/dist/utils/logger.js +3 -0
- package/dist/utils/maturity-check.js +2 -0
- package/dist/utils/pkg.js +3 -0
- package/dist/utils/platform.js +2 -0
- package/dist/utils/plugin-loader.js +2 -0
- package/dist/utils/plugin-worker.js +2 -0
- package/dist/utils/prettier-format.js +2 -0
- package/dist/utils/profiler.js +2 -0
- package/dist/utils/render.js +2 -0
- package/dist/utils/replay.js +3 -0
- package/dist/utils/run-cli.js +6 -0
- package/dist/utils/run-id.js +3 -0
- package/dist/utils/safe-read.js +2 -0
- package/dist/utils/task-id.js +2 -0
- package/dist/utils/today.js +2 -0
- package/dist/utils/tty.js +2 -0
- package/dist/utils/walk-dir.js +2 -0
- package/dist/verify/rules/drive-by-scope.js +1 -0
- package/dist/verify/rules/orphan-todos.js +1 -0
- package/dist/verify/rules/registry.js +1 -0
- package/dist/verify/rules/skip-patterns.js +1 -0
- package/dist/verify/rules/types.d.ts +15 -0
- package/dist/verify/rules/types.js +1 -0
- package/dist/verify/rules/ui-language.js +1 -0
- package/dist/verify/run.js +3 -0
- package/dist/wizard/archetype-defaults.js +1 -0
- package/dist/wizard/presets.js +1 -0
- package/dist/wizard/prompts.js +44 -0
- package/dist/wizard/types.d.ts +637 -0
- package/dist/wizard/types.js +1 -0
- package/dist/worktree/harvest.js +2 -0
- package/dist/worktree/links.js +2 -0
- package/dist/worktree/paths.js +2 -0
- package/dist/worktree/validate.js +3 -0
- package/package.json +124 -0
- package/scripts/check-arc42-slots.mjs +738 -0
- package/scripts/check-doc-freshness.mjs +236 -0
- package/scripts/check-doc-set.mjs +243 -0
- package/scripts/check-doc-style.mjs +228 -0
- package/scripts/gold-audit.mjs +319 -0
- package/scripts/lib/doc-gate-allowlist.mjs +123 -0
- package/scripts/lib/doc-set-resolve.mjs +274 -0
- package/scripts/lib/glob-walk.mjs +148 -0
- package/scripts/lib/gold-audit-lib.mjs +1260 -0
- package/scripts/lib/run-helpers.mjs +413 -0
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
# Operations Handbook — <%= projectName %>
|
|
2
|
+
|
|
3
|
+
<!-- arbiter-managed: operations-handbook (#717) -->
|
|
4
|
+
|
|
5
|
+
This handbook defines the operational baseline for **<%= projectName %>**: observability signals,
|
|
6
|
+
on-call protocol, release gates, and runbook structure.
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## 1. Four-Signal Observability (RED / USE)
|
|
11
|
+
|
|
12
|
+
Every service dashboard must track these four signals at all times.
|
|
13
|
+
|
|
14
|
+
| Signal | Metric type | Alert threshold | Measurement |
|
|
15
|
+
| ------------ | ----------- | --------------- | ----------------------------- |
|
|
16
|
+
| **Latency** | Histogram | p95 > SLA budget | Request duration (ms) |
|
|
17
|
+
| **Traffic** | Counter | Spike > 3× baseline | Requests per second |
|
|
18
|
+
| **Errors** | Counter | Error rate > 1% | 5xx + client-abort count |
|
|
19
|
+
| **Saturation** | Gauge | CPU > 80% or queue depth | Resource utilisation % |
|
|
20
|
+
|
|
21
|
+
### SLA Budgets
|
|
22
|
+
|
|
23
|
+
Define service-level objectives below. Tighten during hardening phases.
|
|
24
|
+
|
|
25
|
+
| Endpoint class | p50 target | p95 target | p99 target |
|
|
26
|
+
| -------------- | ---------- | ---------- | ---------- |
|
|
27
|
+
| Read (GET) | 50 ms | 200 ms | 500 ms |
|
|
28
|
+
| Write (POST/PUT) | 100 ms | 500 ms | 1 000 ms |
|
|
29
|
+
| Background job | — | 30 s | 5 min |
|
|
30
|
+
|
|
31
|
+
### Alert Routing
|
|
32
|
+
|
|
33
|
+
- **P1 (service down / error rate > 5%)** → PagerDuty immediately, wake on-call
|
|
34
|
+
- **P2 (p95 latency > 2× budget / error rate 1–5%)** → Slack `#ops-alerts`, respond within 30 min
|
|
35
|
+
- **P3 (saturation trend / minor degradation)** → Slack `#ops-alerts`, address next business day
|
|
36
|
+
<% if (archetype === 'backend-web-db' || archetype === 'data-pipeline') { %>
|
|
37
|
+
|
|
38
|
+
### Database Signals
|
|
39
|
+
|
|
40
|
+
Additional signals for data-store health:
|
|
41
|
+
|
|
42
|
+
| Signal | Metric | Alert threshold |
|
|
43
|
+
| ---------------- | ------------------- | --------------- |
|
|
44
|
+
| Connection pool | Active / max ratio | > 80% for 5 min |
|
|
45
|
+
| Query latency | p99 query time | > 1 s |
|
|
46
|
+
| Replication lag | Replica offset (ms) | > 500 ms |
|
|
47
|
+
| Disk usage | Storage % | > 75% |
|
|
48
|
+
<% } %><% if (archetype === 'frontend-spa') { %>
|
|
49
|
+
|
|
50
|
+
### Frontend Signals
|
|
51
|
+
|
|
52
|
+
Additional signals for client-side health:
|
|
53
|
+
|
|
54
|
+
| Signal | Metric | Alert threshold |
|
|
55
|
+
| ----------- | --------------- | --------------- |
|
|
56
|
+
| Core Web Vitals | LCP, FID, CLS | LCP > 2.5 s |
|
|
57
|
+
| JS error rate | Uncaught errors | > 0.1% sessions |
|
|
58
|
+
| Bundle size | gzipped bytes | > 10% growth |
|
|
59
|
+
<% } %>
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 2. On-Call Protocol
|
|
64
|
+
|
|
65
|
+
### Escalation Chain
|
|
66
|
+
|
|
67
|
+
1. **Primary on-call** — first to respond; owns incident until resolved or escalated
|
|
68
|
+
2. **Secondary on-call** — escalated after 15 min without response
|
|
69
|
+
3. **Engineering lead** — escalated for P1 incidents exceeding 30 min MTTR
|
|
70
|
+
4. **Stakeholder notification** — for P1 impacting external users, notify within 60 min
|
|
71
|
+
|
|
72
|
+
### Incident Lifecycle
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
Alert fires
|
|
76
|
+
→ Acknowledge (< 5 min for P1)
|
|
77
|
+
→ Diagnose (use runbooks below)
|
|
78
|
+
→ Mitigate (restore service first, root-cause later)
|
|
79
|
+
→ Resolve + post-incident report (within 48 h for P1/P2)
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Communication
|
|
83
|
+
|
|
84
|
+
- War room: `#incident-<YYYY-MM-DD>` Slack channel (create on P1)
|
|
85
|
+
- Status page: update every 15 min during active P1
|
|
86
|
+
- Post-mortem: blameless, filed within 48 h, linked from incident ticket
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 3. Release Candidate Checklist
|
|
91
|
+
|
|
92
|
+
Run this checklist before every production deploy.
|
|
93
|
+
|
|
94
|
+
### Pre-Deploy Gates
|
|
95
|
+
|
|
96
|
+
- [ ] `node scripts/check-all.mjs L2` passes on release branch
|
|
97
|
+
- [ ] All open P1/P2 bugs triaged (none blocking release)
|
|
98
|
+
- [ ] Database migrations tested on staging with production-size dataset
|
|
99
|
+
- [ ] Rollback procedure documented and tested
|
|
100
|
+
- [ ] On-call notified of deploy window
|
|
101
|
+
- [ ] Feature flags set to safe defaults (new features behind flag)
|
|
102
|
+
- [ ] Changelog updated (`CHANGELOG.md` or release notes)
|
|
103
|
+
<% if (archetype === 'backend-web-db') { %>
|
|
104
|
+
- [ ] Load test run against staging (k6 / Gatling) — passes SLA budget
|
|
105
|
+
- [ ] API contract tests pass (Pact / Spring Cloud Contract)
|
|
106
|
+
<% } %><% if (archetype === 'data-pipeline') { %>
|
|
107
|
+
- [ ] Schema migration backward-compatible (old producers/consumers unaffected)
|
|
108
|
+
- [ ] Data backfill plan documented if required
|
|
109
|
+
<% } %>
|
|
110
|
+
|
|
111
|
+
### Deploy Steps
|
|
112
|
+
|
|
113
|
+
1. Announce deploy in `#deployments`: `[DEPLOY] <%= projectName %> vX.Y.Z — window: HH:MM–HH:MM UTC`
|
|
114
|
+
2. Tag release: `git tag vX.Y.Z && git push --tags`
|
|
115
|
+
3. Trigger CI deploy pipeline (do not deploy manually)
|
|
116
|
+
4. Monitor dashboards for 15 min post-deploy
|
|
117
|
+
5. Announce completion or rollback in `#deployments`
|
|
118
|
+
|
|
119
|
+
### Rollback Triggers
|
|
120
|
+
|
|
121
|
+
Roll back immediately if:
|
|
122
|
+
|
|
123
|
+
- Error rate exceeds 2% for 2+ minutes post-deploy
|
|
124
|
+
- p95 latency exceeds 2× SLA budget for 5+ minutes
|
|
125
|
+
- Any P1 alert fires within 30 min of deploy
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## 4. Runbook Library
|
|
130
|
+
|
|
131
|
+
### Template: Service Degradation
|
|
132
|
+
|
|
133
|
+
**Symptoms:** p95 latency elevated; error rate rising; alerts firing
|
|
134
|
+
|
|
135
|
+
**Diagnosis:**
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
# Check recent deployments
|
|
139
|
+
git log --oneline -10
|
|
140
|
+
|
|
141
|
+
# Check error logs (last 15 min)
|
|
142
|
+
# Replace with your log provider CLI
|
|
143
|
+
grep "ERROR" logs/app.log | tail -100
|
|
144
|
+
|
|
145
|
+
# Check resource saturation
|
|
146
|
+
# Replace with your monitoring CLI
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
**Mitigations (in order):**
|
|
150
|
+
|
|
151
|
+
1. If recent deploy: roll back immediately
|
|
152
|
+
2. Restart affected pods/processes (if stateless)
|
|
153
|
+
3. Scale horizontally if saturation is root cause
|
|
154
|
+
4. Enable circuit-breaker if upstream dependency is failing
|
|
155
|
+
5. Escalate to engineering lead if not resolved within 15 min
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
<% if (archetype === 'backend-web-db' || archetype === 'data-pipeline') { %>
|
|
159
|
+
|
|
160
|
+
### Template: Database Issues
|
|
161
|
+
|
|
162
|
+
**Symptoms:** query latency spike; connection pool exhausted; replication lag
|
|
163
|
+
|
|
164
|
+
**Diagnosis:**
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
# Check slow queries (PostgreSQL example)
|
|
168
|
+
SELECT query, calls, mean_exec_time
|
|
169
|
+
FROM pg_stat_statements
|
|
170
|
+
ORDER BY mean_exec_time DESC
|
|
171
|
+
LIMIT 10;
|
|
172
|
+
|
|
173
|
+
# Check connection pool
|
|
174
|
+
SELECT count(*), state FROM pg_stat_activity GROUP BY state;
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
**Mitigations:**
|
|
178
|
+
|
|
179
|
+
1. Kill long-running queries blocking others
|
|
180
|
+
2. Scale connection pool if within bounds
|
|
181
|
+
3. Add read replica if replication lag is root cause
|
|
182
|
+
4. Page DBA if escalation required
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
<% } %>
|
|
186
|
+
|
|
187
|
+
### Template: Dependency Failure
|
|
188
|
+
|
|
189
|
+
**Symptoms:** timeouts/errors to external service; circuit-breaker open
|
|
190
|
+
|
|
191
|
+
**Diagnosis:**
|
|
192
|
+
|
|
193
|
+
1. Check external service status page
|
|
194
|
+
2. Check network connectivity from service pods
|
|
195
|
+
3. Review circuit-breaker metrics
|
|
196
|
+
|
|
197
|
+
**Mitigations:**
|
|
198
|
+
|
|
199
|
+
1. Enable fallback mode (degrade gracefully, disable non-critical features)
|
|
200
|
+
2. Cache last-known-good responses if safe
|
|
201
|
+
3. Notify stakeholders if user-visible
|
|
202
|
+
4. Wait for upstream recovery or escalate to vendor
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## 5. Capacity Planning
|
|
207
|
+
|
|
208
|
+
Review quarterly. Trigger immediate review if any metric crosses 70% of limit.
|
|
209
|
+
|
|
210
|
+
| Resource | Current baseline | 70% trigger | 100% limit | Action at trigger |
|
|
211
|
+
| ---------- | ---------------- | ----------- | ---------- | ----------------------- |
|
|
212
|
+
| CPU | — | 56 cores | 80 cores | Add node or right-size |
|
|
213
|
+
| Memory | — | 56 GB | 80 GB | Add node or right-size |
|
|
214
|
+
| Storage | — | 700 GB | 1 TB | Expand volume |
|
|
215
|
+
| DB connections | — | 140 | 200 | Scale pool or add replica |
|
|
216
|
+
|
|
217
|
+
_Update this table during each quarterly review._
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://bundlesize.io/schema",
|
|
3
|
+
"$description": <%- JSON.stringify(`Bundle size budgets for ${projectName}. Generated by arbiter (#1127). Enforced by scripts/check-bundle-size.mjs.`) %>,
|
|
4
|
+
"budgets": [
|
|
5
|
+
{
|
|
6
|
+
"name": "main bundle (JS)",
|
|
7
|
+
"path": "dist/assets/*.js",
|
|
8
|
+
"maxSize": "250kb",
|
|
9
|
+
"maxGzipSize": "75kb"
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"name": "vendor chunk (JS)",
|
|
13
|
+
"path": "dist/assets/vendor-*.js",
|
|
14
|
+
"maxSize": "400kb",
|
|
15
|
+
"maxGzipSize": "120kb"
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"name": "main styles (CSS)",
|
|
19
|
+
"path": "dist/assets/*.css",
|
|
20
|
+
"maxSize": "50kb",
|
|
21
|
+
"maxGzipSize": "12kb"
|
|
22
|
+
}
|
|
23
|
+
],
|
|
24
|
+
"totals": {
|
|
25
|
+
"maxTotalJsSize": "600kb",
|
|
26
|
+
"maxTotalJsGzipSize": "180kb",
|
|
27
|
+
"maxTotalCssSize": "100kb"
|
|
28
|
+
}
|
|
29
|
+
}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# k6 CSV report generator — flattens k6 summary metrics into tabular CSV (#895)
|
|
3
|
+
import csv
|
|
4
|
+
import json
|
|
5
|
+
import sys
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
from datetime import datetime
|
|
8
|
+
|
|
9
|
+
RESULTS_DIR = Path("perf/k6/results")
|
|
10
|
+
OUTPUT_FILE = RESULTS_DIR / "k6-report.csv"
|
|
11
|
+
|
|
12
|
+
FIELDS = [
|
|
13
|
+
"generated_at",
|
|
14
|
+
"scenario",
|
|
15
|
+
"passed",
|
|
16
|
+
"total_requests",
|
|
17
|
+
"error_rate",
|
|
18
|
+
"avg_ms",
|
|
19
|
+
"min_ms",
|
|
20
|
+
"med_ms",
|
|
21
|
+
"max_ms",
|
|
22
|
+
"p90_ms",
|
|
23
|
+
"p95_ms",
|
|
24
|
+
"p99_ms",
|
|
25
|
+
"thresholds_total",
|
|
26
|
+
"thresholds_failed",
|
|
27
|
+
]
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def extract_row(name: str, summary: dict, generated_at: str) -> dict:
|
|
31
|
+
metrics = summary.get("metrics", {})
|
|
32
|
+
dur = metrics.get("http_req_duration", {}).get("values", {})
|
|
33
|
+
failed_rate = metrics.get("http_req_failed", {}).get("values", {}).get("rate", 0)
|
|
34
|
+
total_reqs = int(metrics.get("http_reqs", {}).get("values", {}).get("count", 0))
|
|
35
|
+
|
|
36
|
+
thresholds_total = 0
|
|
37
|
+
thresholds_failed = 0
|
|
38
|
+
all_passed = True
|
|
39
|
+
for metric_val in metrics.values():
|
|
40
|
+
for passed in metric_val.get("thresholds", {}).values():
|
|
41
|
+
thresholds_total += 1
|
|
42
|
+
if not passed:
|
|
43
|
+
thresholds_failed += 1
|
|
44
|
+
all_passed = False
|
|
45
|
+
|
|
46
|
+
return {
|
|
47
|
+
"generated_at": generated_at,
|
|
48
|
+
"scenario": name,
|
|
49
|
+
"passed": "true" if all_passed else "false",
|
|
50
|
+
"total_requests": total_reqs,
|
|
51
|
+
"error_rate": round(failed_rate, 6),
|
|
52
|
+
"avg_ms": round(dur.get("avg", 0), 2),
|
|
53
|
+
"min_ms": round(dur.get("min", 0), 2),
|
|
54
|
+
"med_ms": round(dur.get("med", 0), 2),
|
|
55
|
+
"max_ms": round(dur.get("max", 0), 2),
|
|
56
|
+
"p90_ms": round(dur.get("p(90)", 0), 2),
|
|
57
|
+
"p95_ms": round(dur.get("p(95)", 0), 2),
|
|
58
|
+
"p99_ms": round(dur.get("p(99)", 0), 2),
|
|
59
|
+
"thresholds_total": thresholds_total,
|
|
60
|
+
"thresholds_failed": thresholds_failed,
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
def main() -> int:
|
|
65
|
+
RESULTS_DIR.mkdir(parents=True, exist_ok=True)
|
|
66
|
+
summaries = list(RESULTS_DIR.glob("*-summary.json"))
|
|
67
|
+
if not summaries:
|
|
68
|
+
print("No summary files found in", RESULTS_DIR, file=sys.stderr)
|
|
69
|
+
return 1
|
|
70
|
+
|
|
71
|
+
generated_at = datetime.utcnow().isoformat(timespec="seconds") + "Z"
|
|
72
|
+
rows = []
|
|
73
|
+
for path in sorted(summaries):
|
|
74
|
+
name = path.stem.replace("-summary", "")
|
|
75
|
+
try:
|
|
76
|
+
data = json.loads(path.read_text())
|
|
77
|
+
rows.append(extract_row(name, data, generated_at))
|
|
78
|
+
except Exception as exc: # noqa: BLE001
|
|
79
|
+
print(f"Warning: could not parse {path}: {exc}", file=sys.stderr)
|
|
80
|
+
|
|
81
|
+
with OUTPUT_FILE.open("w", newline="") as fh:
|
|
82
|
+
writer = csv.DictWriter(fh, fieldnames=FIELDS)
|
|
83
|
+
writer.writeheader()
|
|
84
|
+
writer.writerows(rows)
|
|
85
|
+
|
|
86
|
+
print(f"CSV report written to {OUTPUT_FILE}")
|
|
87
|
+
return 0
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
if __name__ == "__main__":
|
|
91
|
+
sys.exit(main())
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# k6 HTML report generator — reads k6 JSON summary files and emits an HTML report (#895)
|
|
3
|
+
import json
|
|
4
|
+
import os
|
|
5
|
+
import sys
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
from datetime import datetime
|
|
8
|
+
|
|
9
|
+
RESULTS_DIR = Path("perf/k6/results")
|
|
10
|
+
OUTPUT_FILE = RESULTS_DIR / "k6-report.html"
|
|
11
|
+
|
|
12
|
+
HTML_TEMPLATE = """<!DOCTYPE html>
|
|
13
|
+
<html lang="en">
|
|
14
|
+
<head>
|
|
15
|
+
<meta charset="UTF-8">
|
|
16
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
17
|
+
<title>k6 Performance Report</title>
|
|
18
|
+
<style>
|
|
19
|
+
body {{ font-family: system-ui, sans-serif; margin: 2rem; background: #f8f9fa; }}
|
|
20
|
+
h1 {{ color: #1a1a2e; }}
|
|
21
|
+
.scenario {{ background: white; border-radius: 8px; padding: 1.5rem; margin-bottom: 1rem;
|
|
22
|
+
box-shadow: 0 2px 4px rgba(0,0,0,0.1); }}
|
|
23
|
+
.metric {{ display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 0.5rem; margin-top: 1rem; }}
|
|
24
|
+
.metric-box {{ background: #f0f4ff; border-radius: 4px; padding: 0.5rem; text-align: center; }}
|
|
25
|
+
.metric-value {{ font-size: 1.5rem; font-weight: bold; color: #3b5bdb; }}
|
|
26
|
+
.pass {{ color: #2f9e44; }} .fail {{ color: #c92a2a; }}
|
|
27
|
+
table {{ width: 100%; border-collapse: collapse; margin-top: 1rem; }}
|
|
28
|
+
th, td {{ padding: 0.5rem; text-align: left; border-bottom: 1px solid #e9ecef; }}
|
|
29
|
+
th {{ background: #e7f5ff; }}
|
|
30
|
+
</style>
|
|
31
|
+
</head>
|
|
32
|
+
<body>
|
|
33
|
+
<h1>k6 Performance Report</h1>
|
|
34
|
+
<p>Generated: {generated_at}</p>
|
|
35
|
+
{scenarios_html}
|
|
36
|
+
</body>
|
|
37
|
+
</html>"""
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
def _fmt_ms(val: float) -> str:
|
|
41
|
+
return f"{val:.1f}ms"
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def _threshold_status(metrics: dict) -> list[tuple[str, bool]]:
|
|
45
|
+
results = []
|
|
46
|
+
for key, val in metrics.items():
|
|
47
|
+
thresholds = val.get("thresholds", {})
|
|
48
|
+
for thr_key, passed in thresholds.items():
|
|
49
|
+
results.append((f"{key} — {thr_key}", passed))
|
|
50
|
+
return results
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def render_scenario(name: str, summary: dict) -> str:
|
|
54
|
+
metrics = summary.get("metrics", {})
|
|
55
|
+
dur = metrics.get("http_req_duration", {})
|
|
56
|
+
values = dur.get("values", {})
|
|
57
|
+
p95 = values.get("p(95)", 0)
|
|
58
|
+
p99 = values.get("p(99)", 0)
|
|
59
|
+
avg = values.get("avg", 0)
|
|
60
|
+
failed = metrics.get("http_req_failed", {}).get("values", {}).get("rate", 0)
|
|
61
|
+
total_reqs = int(metrics.get("http_reqs", {}).get("values", {}).get("count", 0))
|
|
62
|
+
|
|
63
|
+
thresholds = _threshold_status(metrics)
|
|
64
|
+
all_passed = all(ok for _, ok in thresholds)
|
|
65
|
+
status_cls = "pass" if all_passed else "fail"
|
|
66
|
+
status_txt = "PASS" if all_passed else "FAIL"
|
|
67
|
+
|
|
68
|
+
thr_rows = "".join(
|
|
69
|
+
f'<tr><td>{t}</td><td class="{("pass" if ok else "fail")}">'
|
|
70
|
+
f'{"PASS" if ok else "FAIL"}</td></tr>'
|
|
71
|
+
for t, ok in thresholds
|
|
72
|
+
)
|
|
73
|
+
|
|
74
|
+
return f"""
|
|
75
|
+
<div class="scenario">
|
|
76
|
+
<h2>{name} — <span class="{status_cls}">{status_txt}</span></h2>
|
|
77
|
+
<div class="metric">
|
|
78
|
+
<div class="metric-box"><div class="metric-value">{_fmt_ms(avg)}</div>avg latency</div>
|
|
79
|
+
<div class="metric-box"><div class="metric-value">{_fmt_ms(p95)}</div>p95 latency</div>
|
|
80
|
+
<div class="metric-box"><div class="metric-value">{_fmt_ms(p99)}</div>p99 latency</div>
|
|
81
|
+
<div class="metric-box"><div class="metric-value">{total_reqs}</div>total requests</div>
|
|
82
|
+
<div class="metric-box"><div class="metric-value">{failed*100:.2f}%</div>error rate</div>
|
|
83
|
+
</div>
|
|
84
|
+
<table><tr><th>Threshold</th><th>Result</th></tr>{thr_rows}</table>
|
|
85
|
+
</div>"""
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
def main() -> int:
|
|
89
|
+
RESULTS_DIR.mkdir(parents=True, exist_ok=True)
|
|
90
|
+
summaries = list(RESULTS_DIR.glob("*-summary.json"))
|
|
91
|
+
if not summaries:
|
|
92
|
+
print("No summary files found in", RESULTS_DIR, file=sys.stderr)
|
|
93
|
+
return 1
|
|
94
|
+
|
|
95
|
+
scenarios_html = ""
|
|
96
|
+
for path in sorted(summaries):
|
|
97
|
+
name = path.stem.replace("-summary", "")
|
|
98
|
+
try:
|
|
99
|
+
data = json.loads(path.read_text())
|
|
100
|
+
scenarios_html += render_scenario(name, data)
|
|
101
|
+
except Exception as exc: # noqa: BLE001
|
|
102
|
+
print(f"Warning: could not parse {path}: {exc}", file=sys.stderr)
|
|
103
|
+
|
|
104
|
+
html = HTML_TEMPLATE.format(
|
|
105
|
+
generated_at=datetime.utcnow().isoformat(timespec="seconds") + "Z",
|
|
106
|
+
scenarios_html=scenarios_html or "<p>No data available.</p>",
|
|
107
|
+
)
|
|
108
|
+
OUTPUT_FILE.write_text(html)
|
|
109
|
+
print(f"HTML report written to {OUTPUT_FILE}")
|
|
110
|
+
return 0
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
if __name__ == "__main__":
|
|
114
|
+
sys.exit(main())
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# k6 JSON report aggregator — merges k6 summary files into a single structured report (#895)
|
|
3
|
+
import json
|
|
4
|
+
import sys
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
from datetime import datetime
|
|
7
|
+
|
|
8
|
+
RESULTS_DIR = Path("perf/k6/results")
|
|
9
|
+
OUTPUT_FILE = RESULTS_DIR / "k6-report.json"
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def extract_scenario_summary(name: str, summary: dict) -> dict:
|
|
13
|
+
metrics = summary.get("metrics", {})
|
|
14
|
+
dur = metrics.get("http_req_duration", {}).get("values", {})
|
|
15
|
+
failed_rate = metrics.get("http_req_failed", {}).get("values", {}).get("rate", 0)
|
|
16
|
+
total_reqs = int(metrics.get("http_reqs", {}).get("values", {}).get("count", 0))
|
|
17
|
+
|
|
18
|
+
thresholds: dict[str, bool] = {}
|
|
19
|
+
all_passed = True
|
|
20
|
+
for metric_name, metric_val in metrics.items():
|
|
21
|
+
for thr_key, passed in metric_val.get("thresholds", {}).items():
|
|
22
|
+
thresholds[f"{metric_name}:{thr_key}"] = passed
|
|
23
|
+
if not passed:
|
|
24
|
+
all_passed = False
|
|
25
|
+
|
|
26
|
+
return {
|
|
27
|
+
"scenario": name,
|
|
28
|
+
"passed": all_passed,
|
|
29
|
+
"total_requests": total_reqs,
|
|
30
|
+
"error_rate": round(failed_rate, 6),
|
|
31
|
+
"latency_ms": {
|
|
32
|
+
"avg": round(dur.get("avg", 0), 2),
|
|
33
|
+
"min": round(dur.get("min", 0), 2),
|
|
34
|
+
"med": round(dur.get("med", 0), 2),
|
|
35
|
+
"max": round(dur.get("max", 0), 2),
|
|
36
|
+
"p90": round(dur.get("p(90)", 0), 2),
|
|
37
|
+
"p95": round(dur.get("p(95)", 0), 2),
|
|
38
|
+
"p99": round(dur.get("p(99)", 0), 2),
|
|
39
|
+
},
|
|
40
|
+
"thresholds": thresholds,
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def main() -> int:
|
|
45
|
+
RESULTS_DIR.mkdir(parents=True, exist_ok=True)
|
|
46
|
+
summaries = list(RESULTS_DIR.glob("*-summary.json"))
|
|
47
|
+
if not summaries:
|
|
48
|
+
print("No summary files found in", RESULTS_DIR, file=sys.stderr)
|
|
49
|
+
return 1
|
|
50
|
+
|
|
51
|
+
scenarios = []
|
|
52
|
+
for path in sorted(summaries):
|
|
53
|
+
name = path.stem.replace("-summary", "")
|
|
54
|
+
try:
|
|
55
|
+
data = json.loads(path.read_text())
|
|
56
|
+
scenarios.append(extract_scenario_summary(name, data))
|
|
57
|
+
except Exception as exc: # noqa: BLE001
|
|
58
|
+
print(f"Warning: could not parse {path}: {exc}", file=sys.stderr)
|
|
59
|
+
|
|
60
|
+
overall_passed = all(s["passed"] for s in scenarios)
|
|
61
|
+
report = {
|
|
62
|
+
"generated_at": datetime.utcnow().isoformat(timespec="seconds") + "Z",
|
|
63
|
+
"overall_passed": overall_passed,
|
|
64
|
+
"scenario_count": len(scenarios),
|
|
65
|
+
"scenarios": scenarios,
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
OUTPUT_FILE.write_text(json.dumps(report, indent=2))
|
|
69
|
+
print(f"JSON report written to {OUTPUT_FILE}")
|
|
70
|
+
return 0 if overall_passed else 1
|
|
71
|
+
|
|
72
|
+
|
|
73
|
+
if __name__ == "__main__":
|
|
74
|
+
sys.exit(main())
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
// k6 breakpoint test — ramp up until the system breaks (#895)
|
|
2
|
+
import { check, sleep } from 'k6'
|
|
3
|
+
import http from 'k6/http'
|
|
4
|
+
|
|
5
|
+
export const options = {
|
|
6
|
+
executor: 'ramping-arrival-rate',
|
|
7
|
+
stages: [
|
|
8
|
+
{ duration: '2h', target: 20000 },
|
|
9
|
+
],
|
|
10
|
+
preAllocatedVUs: 1000,
|
|
11
|
+
maxVUs: 5000,
|
|
12
|
+
thresholds: {
|
|
13
|
+
// intentionally lenient — goal is to find the limit, not pass SLA
|
|
14
|
+
http_req_failed: ['rate<0.5'],
|
|
15
|
+
},
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
const BASE_URL = __ENV.K6_BASE_URL || 'http://localhost:8080'
|
|
19
|
+
|
|
20
|
+
export default function () {
|
|
21
|
+
const res = http.get(`${BASE_URL}/api/v1/resource`)
|
|
22
|
+
check(res, {
|
|
23
|
+
'responded': (r) => r.status > 0,
|
|
24
|
+
})
|
|
25
|
+
sleep(0.1)
|
|
26
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
// k6 burst test — short bursts of extreme traffic followed by idle periods (#895)
|
|
2
|
+
import { check, sleep } from 'k6'
|
|
3
|
+
import http from 'k6/http'
|
|
4
|
+
|
|
5
|
+
export const options = {
|
|
6
|
+
scenarios: {
|
|
7
|
+
burst: {
|
|
8
|
+
executor: 'ramping-vus',
|
|
9
|
+
stages: [
|
|
10
|
+
// Burst 1
|
|
11
|
+
{ duration: '10s', target: 500 },
|
|
12
|
+
{ duration: '30s', target: 500 },
|
|
13
|
+
{ duration: '10s', target: 10 },
|
|
14
|
+
// Idle
|
|
15
|
+
{ duration: '1m', target: 10 },
|
|
16
|
+
// Burst 2
|
|
17
|
+
{ duration: '10s', target: 500 },
|
|
18
|
+
{ duration: '30s', target: 500 },
|
|
19
|
+
{ duration: '10s', target: 10 },
|
|
20
|
+
// Idle
|
|
21
|
+
{ duration: '1m', target: 10 },
|
|
22
|
+
// Burst 3
|
|
23
|
+
{ duration: '10s', target: 500 },
|
|
24
|
+
{ duration: '30s', target: 500 },
|
|
25
|
+
{ duration: '10s', target: 0 },
|
|
26
|
+
],
|
|
27
|
+
},
|
|
28
|
+
},
|
|
29
|
+
thresholds: {
|
|
30
|
+
http_req_failed: ['rate<0.05'],
|
|
31
|
+
http_req_duration: ['p(95)<1500'],
|
|
32
|
+
},
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
const BASE_URL = __ENV.K6_BASE_URL || 'http://localhost:8080'
|
|
36
|
+
|
|
37
|
+
export default function () {
|
|
38
|
+
const res = http.get(`${BASE_URL}/api/v1/resource`)
|
|
39
|
+
check(res, {
|
|
40
|
+
'status is 2xx or 429': (r) => (r.status >= 200 && r.status < 300) || r.status === 429,
|
|
41
|
+
})
|
|
42
|
+
sleep(0.5)
|
|
43
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
// k6 endurance test — 24-hour sustained load to detect slow degradation (#895)
|
|
2
|
+
import { check, sleep } from 'k6'
|
|
3
|
+
import http from 'k6/http'
|
|
4
|
+
import { Counter, Trend } from 'k6/metrics'
|
|
5
|
+
|
|
6
|
+
const degradation = new Trend('response_time_trend', true)
|
|
7
|
+
const slowRequests = new Counter('slow_requests')
|
|
8
|
+
|
|
9
|
+
export const options = {
|
|
10
|
+
stages: [
|
|
11
|
+
{ duration: '5m', target: 30 },
|
|
12
|
+
{ duration: '23h50m', target: 30 },
|
|
13
|
+
{ duration: '5m', target: 0 },
|
|
14
|
+
],
|
|
15
|
+
thresholds: {
|
|
16
|
+
http_req_failed: ['rate<0.01'],
|
|
17
|
+
http_req_duration: ['p(95)<600'],
|
|
18
|
+
response_time_trend: ['p(95)<600'],
|
|
19
|
+
slow_requests: ['count<100'],
|
|
20
|
+
},
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
const BASE_URL = __ENV.K6_BASE_URL || 'http://localhost:8080'
|
|
24
|
+
|
|
25
|
+
export default function () {
|
|
26
|
+
const res = http.get(`${BASE_URL}/api/v1/resource`)
|
|
27
|
+
degradation.add(res.timings.duration)
|
|
28
|
+
if (res.timings.duration > 500) {
|
|
29
|
+
slowRequests.add(1)
|
|
30
|
+
}
|
|
31
|
+
check(res, {
|
|
32
|
+
'status is 200': (r) => r.status === 200,
|
|
33
|
+
'no degradation > 500ms': (r) => r.timings.duration < 500,
|
|
34
|
+
})
|
|
35
|
+
sleep(2)
|
|
36
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
// k6 load test — normal expected load (#895)
|
|
2
|
+
import { check, sleep } from 'k6'
|
|
3
|
+
import http from 'k6/http'
|
|
4
|
+
|
|
5
|
+
export const options = {
|
|
6
|
+
stages: [
|
|
7
|
+
{ duration: '2m', target: 50 },
|
|
8
|
+
{ duration: '5m', target: 50 },
|
|
9
|
+
{ duration: '2m', target: 0 },
|
|
10
|
+
],
|
|
11
|
+
thresholds: {
|
|
12
|
+
http_req_failed: ['rate<0.01'],
|
|
13
|
+
http_req_duration: ['p(95)<500', 'p(99)<1500'],
|
|
14
|
+
},
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
const BASE_URL = __ENV.K6_BASE_URL || 'http://localhost:8080'
|
|
18
|
+
|
|
19
|
+
export default function () {
|
|
20
|
+
const res = http.get(`${BASE_URL}/api/v1/resource`)
|
|
21
|
+
check(res, {
|
|
22
|
+
'status is 200 or 204': (r) => r.status === 200 || r.status === 204,
|
|
23
|
+
'response time < 500ms': (r) => r.timings.duration < 500,
|
|
24
|
+
})
|
|
25
|
+
sleep(1)
|
|
26
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
// k6 ramp-down test — decrease load gradually to verify graceful scale-down (#895)
|
|
2
|
+
import { check, sleep } from 'k6'
|
|
3
|
+
import http from 'k6/http'
|
|
4
|
+
|
|
5
|
+
export const options = {
|
|
6
|
+
stages: [
|
|
7
|
+
{ duration: '30s', target: 100 },
|
|
8
|
+
{ duration: '1m', target: 90 },
|
|
9
|
+
{ duration: '1m', target: 70 },
|
|
10
|
+
{ duration: '1m', target: 50 },
|
|
11
|
+
{ duration: '1m', target: 30 },
|
|
12
|
+
{ duration: '1m', target: 10 },
|
|
13
|
+
{ duration: '30s', target: 0 },
|
|
14
|
+
],
|
|
15
|
+
thresholds: {
|
|
16
|
+
http_req_failed: ['rate<0.01'],
|
|
17
|
+
http_req_duration: ['p(95)<500'],
|
|
18
|
+
},
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
const BASE_URL = __ENV.K6_BASE_URL || 'http://localhost:8080'
|
|
22
|
+
|
|
23
|
+
export default function () {
|
|
24
|
+
const res = http.get(`${BASE_URL}/api/v1/resource`)
|
|
25
|
+
check(res, {
|
|
26
|
+
'status is 200': (r) => r.status === 200,
|
|
27
|
+
})
|
|
28
|
+
sleep(1)
|
|
29
|
+
}
|