@cbartens/bkit 0.0.0-stage → 5.0.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/.bkit/README.md +417 -0
- package/.bkit/core/.agents/context.md +95 -0
- package/.bkit/core/.agents/docs.md +62 -0
- package/.bkit/core/.agents/rules.md +147 -0
- package/.bkit/core/.agents/skills.md +43 -0
- package/.bkit/core/.bkit/LICENSE.md +151 -0
- package/.bkit/core/.bkit/README.md +417 -0
- package/.bkit/core/.bkit/cloud.md +493 -0
- package/.bkit/core/.bkit/comparison.md +321 -0
- package/.bkit/core/.bkit/install.md +401 -0
- package/.bkit/core/.bkit/jsonl.md +497 -0
- package/.bkit/core/.bkit/prompts.md +474 -0
- package/.bkit/core/.bkit/providers.md +598 -0
- package/.bkit/core/.bkit/templates.md +470 -0
- package/.bkit/core/.bkit/trackers.md +95 -0
- package/.bkit/core/.bkit/workflows.md +1550 -0
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
- package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
- package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
- package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
- package/.bkit/core/AGENTS.md +77 -0
- package/.bkit/core/LICENSE.md +149 -0
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
- package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
- package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
- package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
- package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
- package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
- package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
- package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
- package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
- package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
- package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
- package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
- package/.bkit/core/docs/templates/bkit-plan.md +476 -0
- package/.bkit/core/engine/checks/after/auth.ts +149 -0
- package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
- package/.bkit/core/engine/checks/after/github.ts +424 -0
- package/.bkit/core/engine/checks/after/index.ts +530 -0
- package/.bkit/core/engine/checks/after/managed.ts +217 -0
- package/.bkit/core/engine/checks/after/suppression.ts +53 -0
- package/.bkit/core/engine/checks/after/tools.ts +427 -0
- package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
- package/.bkit/core/engine/checks/before/env.ts +187 -0
- package/.bkit/core/engine/checks/before/files.ts +204 -0
- package/.bkit/core/engine/checks/before/index.ts +206 -0
- package/.bkit/core/engine/checks/before/mcp.ts +127 -0
- package/.bkit/core/engine/checks/before/repo.ts +77 -0
- package/.bkit/core/engine/checks/before/version.ts +67 -0
- package/.bkit/core/engine/checks/status-holes.ts +479 -0
- package/.bkit/core/engine/cli.ts +867 -0
- package/.bkit/core/engine/commands/analysis.ts +550 -0
- package/.bkit/core/engine/commands/ci/ci.ts +483 -0
- package/.bkit/core/engine/commands/comply.ts +415 -0
- package/.bkit/core/engine/commands/harvest.ts +459 -0
- package/.bkit/core/engine/commands/install/check.ts +70 -0
- package/.bkit/core/engine/commands/install/doctor.ts +254 -0
- package/.bkit/core/engine/commands/install/install.ts +550 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
- package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
- package/.bkit/core/engine/commands/launch.ts +139 -0
- package/.bkit/core/engine/commands/lib.ts +495 -0
- package/.bkit/core/engine/commands/registry.ts +53 -0
- package/.bkit/core/engine/commands/setup/setup.ts +184 -0
- package/.bkit/core/engine/commands/telemetry.ts +32 -0
- package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
- package/.bkit/core/engine/commands/workflow/context.ts +961 -0
- package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
- package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
- package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
- package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
- package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
- package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
- package/.bkit/core/engine/commands/workflow/status.ts +455 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
- package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
- package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
- package/.bkit/core/engine/install/cloud-env.ts +924 -0
- package/.bkit/core/engine/install/managed-block.ts +212 -0
- package/.bkit/core/engine/install/manifest.ts +448 -0
- package/.bkit/core/engine/install/modules/claude.ts +362 -0
- package/.bkit/core/engine/install/modules/cloud.ts +173 -0
- package/.bkit/core/engine/install/modules/codex.ts +219 -0
- package/.bkit/core/engine/install/modules/core.ts +620 -0
- package/.bkit/core/engine/install/modules/cursor.ts +231 -0
- package/.bkit/core/engine/install/modules/index.ts +242 -0
- package/.bkit/core/engine/install/modules/opencode.ts +573 -0
- package/.bkit/core/engine/install/payload-links.ts +150 -0
- package/.bkit/core/engine/install/placeholders.ts +108 -0
- package/.bkit/core/engine/install/template-copies.ts +119 -0
- package/.bkit/core/engine/install/version-file.ts +284 -0
- package/.bkit/core/engine/install/write.ts +467 -0
- package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
- package/.bkit/core/engine/ledgers/status.ts +213 -0
- package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
- package/.bkit/core/engine/render/hosts.ts +372 -0
- package/.bkit/core/engine/render/models.ts +323 -0
- package/.bkit/core/engine/render/parts.ts +38 -0
- package/.bkit/core/engine/render/trackers.ts +170 -0
- package/.bkit/core/engine/shared/egress.ts +345 -0
- package/.bkit/core/engine/shared/json.ts +16 -0
- package/.bkit/core/engine/shared/log-prefix.ts +9 -0
- package/.bkit/core/engine/shared/package-json.ts +29 -0
- package/.bkit/core/engine/shared/package-manager.ts +38 -0
- package/.bkit/core/engine/shared/package-roots.ts +163 -0
- package/.bkit/core/engine/shared/protected-paths.ts +164 -0
- package/.bkit/core/engine/shared/settings.ts +72 -0
- package/.bkit/core/engine/shared/timeouts.ts +20 -0
- package/.bkit/core/engine/tools/wording.ts +748 -0
- package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
- package/.bkit/core/hooks/gateguard-engine.js +193 -0
- package/.bkit/core/hooks/guardrails-shell.js +154 -0
- package/.bkit/core/hooks/guardrails-tiers.js +68 -0
- package/.bkit/core/hooks/preflight-linear.sh +73 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
- package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
- package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
- package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
- package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
- package/.bkit/core/prompts/bkit-build-summary.md +93 -0
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
- package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
- package/.bkit/core/prompts/bkit-design-generate.md +110 -0
- package/.bkit/core/prompts/bkit-design-organise.md +85 -0
- package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
- package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
- package/.bkit/core/prompts/bkit-design-spike.md +97 -0
- package/.bkit/core/prompts/bkit-design-summary.md +106 -0
- package/.bkit/core/prompts/bkit-design-update.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
- package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
- package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
- package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
- package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
- package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
- package/.bkit/core/prompts/bkit-plan-update.md +68 -0
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
- package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
- package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
- package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
- package/.bkit/core/workflows/bkit-auto.md +121 -0
- package/.bkit/core/workflows/bkit-build.md +802 -0
- package/.bkit/core/workflows/bkit-debug.md +649 -0
- package/.bkit/core/workflows/bkit-design.md +495 -0
- package/.bkit/core/workflows/bkit-plan.md +510 -0
- package/.bkit/core/workflows/bkit-ship.md +650 -0
- package/.bkit/shared/.bkit/.env.example +86 -0
- package/.bkit/shared/.claude/bkit-cloud.md +117 -0
- package/.bkit/shared/.claude/settings.json +88 -0
- package/.bkit/shared/.codex/hooks.json +26 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
- package/.bkit/shared/.cursor/hooks.json +26 -0
- package/.bkit/shared/.cursor/mcp.json +15 -0
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
- package/.bkit/shared/.gitattributes +37 -0
- package/.bkit/shared/.mcp.json +16 -0
- package/.bkit/shared/.opencode/opencode.json +62 -0
- package/.bkit/shared/CLAUDE.md +11 -0
- package/.bkit/shared/LICENSE.md +22 -0
- package/.bkit/shared/docs/architecture.md +19 -0
- package/.bkit/shared/docs/data-schema.md +19 -0
- package/.bkit/shared/docs/deployments.md +433 -0
- package/.bkit/shared/docs/design.md +39 -0
- package/.bkit/shared/docs/noise.md +19 -0
- package/.bkit/shared/docs/observability.md +25 -0
- package/.bkit/shared/docs/security.md +42 -0
- package/.bkit/shared/docs/setup.md +30 -0
- package/.bkit/shared/docs/technology.md +18 -0
- package/.bkit/shared/docs/testing.md +413 -0
- package/.bkit/shared/gitignore +97 -0
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -0
- package/.bkit/templates/.cursor/Dockerfile +68 -0
- package/.bkit/templates/.cursor/environment.json +6 -0
- package/.bkit/templates/.cursor/settings.json +11 -0
- package/.bkit/templates/.envrc +7 -0
- package/.bkit/templates/.github/dependabot.yml +52 -0
- package/.bkit/templates/.github/renovate.json5 +224 -0
- package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -0
- package/.bkit/templates/.graphifyignore +108 -0
- package/.bkit/templates/.husky/pre-commit +16 -0
- package/.bkit/templates/.husky/pre-push +91 -0
- package/.bkit/templates/.lintstagedrc.json +3 -0
- package/.bkit/templates/.prettierignore +41 -0
- package/.bkit/templates/.serena/project.yml +243 -0
- package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
- package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
- package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
- package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
- package/.bkit/templates/.vale.ini +67 -0
- package/.bkit/templates/LICENSE.md +22 -0
- package/.bkit/templates/context/bkit-cloudrun.md +84 -0
- package/.bkit/templates/context/bkit-expo.md +186 -0
- package/.bkit/templates/context/bkit-github.md +79 -0
- package/.bkit/templates/context/bkit-inngest.md +45 -0
- package/.bkit/templates/context/bkit-maestro.md +76 -0
- package/.bkit/templates/context/bkit-playwright.md +62 -0
- package/.bkit/templates/context/bkit-resend.md +36 -0
- package/.bkit/templates/context/bkit-sentry.md +65 -0
- package/.bkit/templates/context/bkit-serena.md +33 -0
- package/.bkit/templates/context/bkit-stripe.md +36 -0
- package/.bkit/templates/context/bkit-supabase.md +59 -0
- package/.bkit/templates/context/bkit-tavily.md +49 -0
- package/.bkit/templates/context/bkit-vercel.md +64 -0
- package/.bkit/templates/docs/capabilities.md +72 -0
- package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
- package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
- package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
- package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
- package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
- package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
- package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
- package/.bkit/templates/slop-scan.config.json +120 -0
- package/CHANGELOG.md +1503 -0
- package/LICENSE.md +161 -0
- package/README.md +184 -2
- package/dist/checks/after/auth.js +140 -0
- package/dist/checks/after/ci-yml.js +681 -0
- package/dist/checks/after/github.js +400 -0
- package/dist/checks/after/index.js +431 -0
- package/dist/checks/after/managed.js +187 -0
- package/dist/checks/after/suppression.js +39 -0
- package/dist/checks/after/tools.js +351 -0
- package/dist/checks/before/context-fetch.js +426 -0
- package/dist/checks/before/env.js +163 -0
- package/dist/checks/before/files.js +187 -0
- package/dist/checks/before/index.js +162 -0
- package/dist/checks/before/mcp.js +111 -0
- package/dist/checks/before/repo.js +71 -0
- package/dist/checks/before/version.js +60 -0
- package/dist/checks/status-holes.js +393 -0
- package/dist/cli.js +688 -0
- package/dist/commands/analysis.js +325 -0
- package/dist/commands/ci/ci.js +438 -0
- package/dist/commands/comply.js +310 -0
- package/dist/commands/harvest.js +354 -0
- package/dist/commands/install/check.js +61 -0
- package/dist/commands/install/doctor.js +209 -0
- package/dist/commands/install/install.js +475 -0
- package/dist/commands/install/uninstall.js +839 -0
- package/dist/commands/install/upgrade.js +782 -0
- package/dist/commands/launch.js +118 -0
- package/dist/commands/lib.js +363 -0
- package/dist/commands/registry.js +50 -0
- package/dist/commands/setup/setup.js +158 -0
- package/dist/commands/telemetry.js +29 -0
- package/dist/commands/workflow/branches.js +1265 -0
- package/dist/commands/workflow/context.js +846 -0
- package/dist/commands/workflow/counters.js +227 -0
- package/dist/commands/workflow/fids.js +224 -0
- package/dist/commands/workflow/issues.js +585 -0
- package/dist/commands/workflow/ledgers.js +472 -0
- package/dist/commands/workflow/locks.js +364 -0
- package/dist/commands/workflow/prs.js +904 -0
- package/dist/commands/workflow/repo.js +199 -0
- package/dist/commands/workflow/roadmap.js +495 -0
- package/dist/commands/workflow/runs.js +1717 -0
- package/dist/commands/workflow/runtime.js +257 -0
- package/dist/commands/workflow/skills.js +110 -0
- package/dist/commands/workflow/status.js +392 -0
- package/dist/commands/workflow/steps.js +1093 -0
- package/dist/commands/workflow/tests.js +144 -0
- package/dist/commands/workflow/workflows.js +1342 -0
- package/dist/commands/workflow/workstreams.js +141 -0
- package/dist/commands/workflow/worktrees.js +473 -0
- package/dist/install/cloud-env.js +818 -0
- package/dist/install/managed-block.js +182 -0
- package/dist/install/manifest.js +376 -0
- package/dist/install/modules/claude.js +288 -0
- package/dist/install/modules/cloud.js +151 -0
- package/dist/install/modules/codex.js +193 -0
- package/dist/install/modules/core.js +531 -0
- package/dist/install/modules/cursor.js +186 -0
- package/dist/install/modules/index.js +152 -0
- package/dist/install/modules/opencode.js +504 -0
- package/dist/install/payload-links.js +119 -0
- package/dist/install/placeholders.js +87 -0
- package/dist/install/template-copies.js +106 -0
- package/dist/install/version-file.js +204 -0
- package/dist/install/write.js +342 -0
- package/dist/ledgers/clamp-log.js +27 -0
- package/dist/ledgers/status.js +156 -0
- package/dist/ledgers/telemetry.js +637 -0
- package/dist/render/hosts.js +339 -0
- package/dist/render/models.js +288 -0
- package/dist/render/parts.js +33 -0
- package/dist/render/trackers.js +135 -0
- package/dist/shared/egress.js +299 -0
- package/dist/shared/json.js +16 -0
- package/dist/shared/log-prefix.js +7 -0
- package/dist/shared/package-json.js +22 -0
- package/dist/shared/package-manager.js +32 -0
- package/dist/shared/package-roots.js +145 -0
- package/dist/shared/protected-paths.js +153 -0
- package/dist/shared/settings.js +44 -0
- package/dist/shared/timeouts.js +19 -0
- package/dist/tools/wording.js +680 -0
- package/package.json +101 -4
|
@@ -0,0 +1,478 @@
|
|
|
1
|
+
// bkit locks acquire|release — the per-feature workflow lock and the dev lock.
|
|
2
|
+
//
|
|
3
|
+
// workflow `docs/plans/{month}/logs/{fid}/.lock`: one phase workflow per feature
|
|
4
|
+
// at a time. A lock left behind is reclaimed as soon as its holder is
|
|
5
|
+
// idle: its run is not IN_PROGRESS, or stepped no sooner than 30 minutes
|
|
6
|
+
// ago. The lock file's own age is not checked.
|
|
7
|
+
// dev `.bkit/.dev.lock` in the main checkout: held across every checkout /
|
|
8
|
+
// commit / push of `dev` there. Acquire waits a bounded time; the shell
|
|
9
|
+
// releases it from `trap ... EXIT`.
|
|
10
|
+
//
|
|
11
|
+
// Both write one line, `{at} {workflow} {fid} {token}`. Release removes only a lock
|
|
12
|
+
// this caller owns (same token, else same workflow and feature), so a Failure Path
|
|
13
|
+
// that never got the lock cannot delete the holder's.
|
|
14
|
+
|
|
15
|
+
import { randomBytes } from "node:crypto";
|
|
16
|
+
import * as fs from "node:fs";
|
|
17
|
+
import * as path from "node:path";
|
|
18
|
+
|
|
19
|
+
import {
|
|
20
|
+
fold,
|
|
21
|
+
lastRun,
|
|
22
|
+
statusTimestamp,
|
|
23
|
+
type StatusEvent,
|
|
24
|
+
type WorkflowRun,
|
|
25
|
+
} from "../../ledgers/status.js";
|
|
26
|
+
import {
|
|
27
|
+
CommandError,
|
|
28
|
+
EXIT,
|
|
29
|
+
git,
|
|
30
|
+
parseJson,
|
|
31
|
+
repoRoot,
|
|
32
|
+
statusRelPath,
|
|
33
|
+
utcMonth,
|
|
34
|
+
type CommandSpec,
|
|
35
|
+
type FlagSpec,
|
|
36
|
+
type RunContext,
|
|
37
|
+
} from "../lib.js";
|
|
38
|
+
import { TIMEOUTS } from "../../shared/timeouts.js";
|
|
39
|
+
import { str } from "./status.js";
|
|
40
|
+
|
|
41
|
+
/** A workflow lock whose holder shows no sign of life for this long is stale. */
|
|
42
|
+
export const WORKFLOW_LOCK_IDLE_S = 1800;
|
|
43
|
+
/** Seconds between dev-lock attempts while it is busy. */
|
|
44
|
+
export const DEV_LOCK_POLL_S = 5;
|
|
45
|
+
|
|
46
|
+
/** Exit code: the feature has logs in more than one month bucket. */
|
|
47
|
+
export const EXIT_SPLIT_BUCKET = 7;
|
|
48
|
+
/** Exit code: the lock belongs to another owner and was left in place. */
|
|
49
|
+
export const EXIT_NOT_OWNER = 4;
|
|
50
|
+
/** Exit code: the lock file is still there after removing it. */
|
|
51
|
+
export const EXIT_REMOVE_FAILED = 5;
|
|
52
|
+
|
|
53
|
+
const KINDS = ["workflow", "dev"] as const;
|
|
54
|
+
type Kind = (typeof KINDS)[number];
|
|
55
|
+
|
|
56
|
+
// ---------------------------------------------------------------------------
|
|
57
|
+
// Paths
|
|
58
|
+
// ---------------------------------------------------------------------------
|
|
59
|
+
|
|
60
|
+
const MONTH_DIR = /^[0-9]{6}$/;
|
|
61
|
+
|
|
62
|
+
/** Month buckets under `docs/plans/` that hold logs for `fid`, oldest first. */
|
|
63
|
+
export function monthBuckets(root: string, fid: string): string[] {
|
|
64
|
+
const plans = path.join(root, "docs", "plans");
|
|
65
|
+
if (!fs.existsSync(plans)) return [];
|
|
66
|
+
return fs
|
|
67
|
+
.readdirSync(plans)
|
|
68
|
+
.filter(
|
|
69
|
+
(m) =>
|
|
70
|
+
MONTH_DIR.test(m) &&
|
|
71
|
+
fs.statSync(path.join(plans, m, "logs", fid), { throwIfNoEntry: false })?.isDirectory(),
|
|
72
|
+
)
|
|
73
|
+
.sort();
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* The feature's month bucket: `--month` when given, else the one bucket its logs
|
|
78
|
+
* are already in, else this UTC month. A feature split across buckets is refused.
|
|
79
|
+
*/
|
|
80
|
+
export function resolveMonth(root: string, fid: string, month: string | undefined): string {
|
|
81
|
+
if (month !== undefined) {
|
|
82
|
+
if (!MONTH_DIR.test(month)) throw new CommandError(EXIT.USAGE, "--month must be YYYYMM");
|
|
83
|
+
return month;
|
|
84
|
+
}
|
|
85
|
+
const buckets = monthBuckets(root, fid);
|
|
86
|
+
if (buckets.length > 1) {
|
|
87
|
+
throw new CommandError(
|
|
88
|
+
EXIT_SPLIT_BUCKET,
|
|
89
|
+
`${fid} has logs in more than one month bucket (${buckets.join(", ")}) — consolidate into a single bucket, then re-run`,
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
return buckets[0] ?? utcMonth();
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* Root the workflow books its logs under: the main checkout, except ship in a
|
|
97
|
+
* runtime that does not push to dev, which books on the branch being shipped.
|
|
98
|
+
*/
|
|
99
|
+
export function lockRoot(cwd: string, workflow: string, devPushes: boolean): string {
|
|
100
|
+
const root = repoRoot(cwd);
|
|
101
|
+
if (workflow !== "ship" || devPushes) return root;
|
|
102
|
+
return git(cwd, ["rev-parse", "--show-toplevel"]) ?? root;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
export const workflowLockPath = (bookRoot: string, month: string, fid: string) =>
|
|
106
|
+
path.join(bookRoot, "docs", "plans", month, "logs", fid, ".lock");
|
|
107
|
+
|
|
108
|
+
export const devLockPath = (root: string) => path.join(root, ".bkit", ".dev.lock");
|
|
109
|
+
|
|
110
|
+
// ---------------------------------------------------------------------------
|
|
111
|
+
// Lock file
|
|
112
|
+
// ---------------------------------------------------------------------------
|
|
113
|
+
|
|
114
|
+
export interface Holder {
|
|
115
|
+
line: string;
|
|
116
|
+
at?: string;
|
|
117
|
+
workflow?: string;
|
|
118
|
+
fid?: string;
|
|
119
|
+
token?: string;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
export function readHolder(file: string): Holder | undefined {
|
|
123
|
+
if (!fs.existsSync(file)) return undefined;
|
|
124
|
+
const line = fs.readFileSync(file, "utf-8").trim();
|
|
125
|
+
const [at, workflow, fid, token] = line.split(/\s+/);
|
|
126
|
+
return { line, at, workflow, fid, token };
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** Create `file` only if absent (`set -C`); false when someone else holds it. */
|
|
130
|
+
function tryCreate(file: string, line: string): boolean {
|
|
131
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
132
|
+
const fd = openExclusive(file);
|
|
133
|
+
if (fd === undefined) return false;
|
|
134
|
+
fs.writeSync(fd, `${line}\n`);
|
|
135
|
+
fs.closeSync(fd);
|
|
136
|
+
return true;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
function openExclusive(file: string): number | undefined {
|
|
140
|
+
try {
|
|
141
|
+
return fs.openSync(file, "wx");
|
|
142
|
+
} catch (err) {
|
|
143
|
+
// EEXIST is the expected "someone holds it" answer; anything else is a real error.
|
|
144
|
+
if ((err as NodeJS.ErrnoException).code === "EEXIST") return undefined;
|
|
145
|
+
throw err;
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
const ageSeconds = (file: string, now: number): number | undefined => {
|
|
150
|
+
const st = fs.statSync(file, { throwIfNoEntry: false });
|
|
151
|
+
return st === undefined ? undefined : Math.floor((now - st.mtimeMs) / 1000);
|
|
152
|
+
};
|
|
153
|
+
|
|
154
|
+
const newToken = () => randomBytes(4).toString("hex");
|
|
155
|
+
|
|
156
|
+
const lockLine = (workflow: string, fid: string, token: string) =>
|
|
157
|
+
`${statusTimestamp()} ${workflow} ${fid} ${token}`;
|
|
158
|
+
|
|
159
|
+
/** The caller owns the lock: same token when it gave one, else same workflow and feature. */
|
|
160
|
+
export function owns(holder: Holder, who: { workflow: string; fid: string; token?: string }) {
|
|
161
|
+
if (who.token !== undefined) return holder.token === who.token;
|
|
162
|
+
return holder.workflow === who.workflow && (holder.fid === undefined || holder.fid === who.fid);
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
// ---------------------------------------------------------------------------
|
|
166
|
+
// Workflow lock
|
|
167
|
+
// ---------------------------------------------------------------------------
|
|
168
|
+
|
|
169
|
+
export interface WorkflowLockResult {
|
|
170
|
+
path: string;
|
|
171
|
+
month: string;
|
|
172
|
+
token: string;
|
|
173
|
+
/** A left-behind lock this acquire removed, and why; null when there was none. */
|
|
174
|
+
reclaimed: { holder: string; reason: "finished" | "stale" | "orphaned" } | null;
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/** Why a held workflow lock is still live, or why it may be reclaimed. */
|
|
178
|
+
function liveReason(
|
|
179
|
+
root: string,
|
|
180
|
+
bookRoot: string,
|
|
181
|
+
month: string,
|
|
182
|
+
fid: string,
|
|
183
|
+
holder: Holder,
|
|
184
|
+
now: number,
|
|
185
|
+
): { live: string } | { reason: "finished" | "stale" | "orphaned" } {
|
|
186
|
+
const rel = statusRelPath(month, fid);
|
|
187
|
+
const worktreeCopy = path.join(root, ".worktrees", fid, rel);
|
|
188
|
+
const own = fs.existsSync(worktreeCopy) ? worktreeCopy : path.join(bookRoot, rel);
|
|
189
|
+
const run =
|
|
190
|
+
holder.workflow === undefined ? undefined : lastRun(readRunsLenient(own), holder.workflow);
|
|
191
|
+
const lastAt = run?.steps.at(-1)?.at;
|
|
192
|
+
if (run?.status === "IN_PROGRESS" && lastAt) {
|
|
193
|
+
const idle = Math.floor((now - Date.parse(lastAt)) / 1000);
|
|
194
|
+
if (idle < WORKFLOW_LOCK_IDLE_S) return { live: `idle ${idle}s` };
|
|
195
|
+
}
|
|
196
|
+
if (run === undefined) return { reason: "orphaned" };
|
|
197
|
+
return { reason: run.status === "IN_PROGRESS" ? "stale" : "finished" };
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* Fold a status log for the lock cross-check. A missing or malformed log shows no
|
|
202
|
+
* run: there is no evidence the holder is alive, so the lock is reclaimed.
|
|
203
|
+
*/
|
|
204
|
+
function readRunsLenient(file: string): WorkflowRun[] {
|
|
205
|
+
if (!fs.existsSync(file)) return [];
|
|
206
|
+
const raw = fs.readFileSync(file, "utf-8").trim();
|
|
207
|
+
const events: StatusEvent[] = [];
|
|
208
|
+
for (const line of raw.split("\n").map((l) => l.trim())) {
|
|
209
|
+
if (line === "") continue;
|
|
210
|
+
const parsed = parseJson(line);
|
|
211
|
+
if (!parsed.ok) return [];
|
|
212
|
+
events.push(parsed.value as StatusEvent);
|
|
213
|
+
}
|
|
214
|
+
return fold(events);
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
export function acquireWorkflowLock(opts: {
|
|
218
|
+
cwd: string;
|
|
219
|
+
workflow: string;
|
|
220
|
+
fid: string;
|
|
221
|
+
month?: string;
|
|
222
|
+
devPushes: boolean;
|
|
223
|
+
log: (m: string) => void;
|
|
224
|
+
}): WorkflowLockResult {
|
|
225
|
+
const root = repoRoot(opts.cwd);
|
|
226
|
+
const month = resolveMonth(root, opts.fid, opts.month);
|
|
227
|
+
const bookRoot = lockRoot(opts.cwd, opts.workflow, opts.devPushes);
|
|
228
|
+
const file = workflowLockPath(bookRoot, month, opts.fid);
|
|
229
|
+
const token = newToken();
|
|
230
|
+
const line = lockLine(opts.workflow, opts.fid, token);
|
|
231
|
+
if (tryCreate(file, line)) return { path: file, month, token, reclaimed: null };
|
|
232
|
+
|
|
233
|
+
const holder = readHolder(file) ?? { line: "" };
|
|
234
|
+
const verdict = liveReason(root, bookRoot, month, opts.fid, holder, Date.now());
|
|
235
|
+
if ("live" in verdict) {
|
|
236
|
+
throw new CommandError(
|
|
237
|
+
EXIT.NO,
|
|
238
|
+
`workflow already running for ${opts.fid} (workflow=${holder.workflow ?? "?"}, ${verdict.live})`,
|
|
239
|
+
);
|
|
240
|
+
}
|
|
241
|
+
opts.log(`reclaiming ${verdict.reason} lock for ${opts.fid}: ${holder.line}`);
|
|
242
|
+
fs.rmSync(file, { force: true });
|
|
243
|
+
if (!tryCreate(file, line)) throw new CommandError(EXIT.NO, `lock contended for ${opts.fid}`);
|
|
244
|
+
return { path: file, month, token, reclaimed: { holder: holder.line, reason: verdict.reason } };
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
// ---------------------------------------------------------------------------
|
|
248
|
+
// Dev lock
|
|
249
|
+
// ---------------------------------------------------------------------------
|
|
250
|
+
|
|
251
|
+
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
|
|
252
|
+
|
|
253
|
+
export async function acquireDevLock(opts: {
|
|
254
|
+
cwd: string;
|
|
255
|
+
workflow: string;
|
|
256
|
+
fid: string;
|
|
257
|
+
deadlineS: number;
|
|
258
|
+
log: (m: string) => void;
|
|
259
|
+
}): Promise<{ path: string; token: string; reclaimed: string | null; waitedS: number }> {
|
|
260
|
+
const file = devLockPath(repoRoot(opts.cwd));
|
|
261
|
+
const token = newToken();
|
|
262
|
+
const start = Date.now();
|
|
263
|
+
const deadline = start + opts.deadlineS * 1000;
|
|
264
|
+
let reclaimed: string | null = null;
|
|
265
|
+
for (;;) {
|
|
266
|
+
if (tryCreate(file, lockLine(opts.workflow, opts.fid, token))) {
|
|
267
|
+
return { path: file, token, reclaimed, waitedS: Math.round((Date.now() - start) / 1000) };
|
|
268
|
+
}
|
|
269
|
+
const now = Date.now();
|
|
270
|
+
const age = ageSeconds(file, now);
|
|
271
|
+
if (age === undefined) continue; // released between the attempt and the stat
|
|
272
|
+
if (age >= TIMEOUTS.SHIP_DEV_LOCK_STALE_S) {
|
|
273
|
+
reclaimed = readHolder(file)?.line ?? "";
|
|
274
|
+
opts.log(`reclaiming stale dev lock (${age}s old): ${reclaimed}`);
|
|
275
|
+
fs.rmSync(file, { force: true });
|
|
276
|
+
continue;
|
|
277
|
+
}
|
|
278
|
+
if (now >= deadline) {
|
|
279
|
+
throw new CommandError(
|
|
280
|
+
EXIT.NO,
|
|
281
|
+
`dev lock held by: ${readHolder(file)?.line ?? "?"} — serialise this run or use a separate clone`,
|
|
282
|
+
);
|
|
283
|
+
}
|
|
284
|
+
await sleep(Math.min(DEV_LOCK_POLL_S * 1000, deadline - now));
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
// ---------------------------------------------------------------------------
|
|
289
|
+
// Release
|
|
290
|
+
// ---------------------------------------------------------------------------
|
|
291
|
+
|
|
292
|
+
export interface ReleaseResult {
|
|
293
|
+
path: string;
|
|
294
|
+
existed: boolean;
|
|
295
|
+
released: boolean;
|
|
296
|
+
/** The lock line left in place because another owner holds it; null otherwise. */
|
|
297
|
+
heldBy: string | null;
|
|
298
|
+
/** The caller's lock is still there after removing it. */
|
|
299
|
+
removeFailed: boolean;
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/**
|
|
303
|
+
* Remove a lock this caller owns. Missing is fine (already released); another
|
|
304
|
+
* owner's lock is left in place and reported.
|
|
305
|
+
*/
|
|
306
|
+
export function releaseLock(
|
|
307
|
+
file: string,
|
|
308
|
+
who: { workflow: string; fid: string; token?: string },
|
|
309
|
+
): ReleaseResult {
|
|
310
|
+
const holder = readHolder(file);
|
|
311
|
+
const result = { path: file, existed: false, released: false, heldBy: null, removeFailed: false };
|
|
312
|
+
if (holder === undefined) return result;
|
|
313
|
+
if (!owns(holder, who)) return { ...result, existed: true, heldBy: holder.line };
|
|
314
|
+
fs.rmSync(file, { force: true });
|
|
315
|
+
const left = fs.existsSync(file);
|
|
316
|
+
return { ...result, existed: true, released: !left, removeFailed: left };
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
// ---------------------------------------------------------------------------
|
|
320
|
+
// Command
|
|
321
|
+
// ---------------------------------------------------------------------------
|
|
322
|
+
|
|
323
|
+
const KIND_FLAG: FlagSpec = {
|
|
324
|
+
name: "kind",
|
|
325
|
+
type: "string",
|
|
326
|
+
required: true,
|
|
327
|
+
help: "workflow (per-feature .lock) or dev (.bkit/.dev.lock)",
|
|
328
|
+
};
|
|
329
|
+
const LOCK_WORKFLOW_FLAG: FlagSpec = {
|
|
330
|
+
name: "workflow",
|
|
331
|
+
type: "string",
|
|
332
|
+
required: true,
|
|
333
|
+
help: "workflow name: design, plan, build, debug, ship (written into the lock)",
|
|
334
|
+
};
|
|
335
|
+
const FID_FLAG: FlagSpec = { name: "fid", type: "string", required: true, help: "feature id" };
|
|
336
|
+
const MONTH_FLAG: FlagSpec = {
|
|
337
|
+
name: "month",
|
|
338
|
+
type: "string",
|
|
339
|
+
help: "workflow kind: month bucket YYYYMM (default: the feature's bucket, else this UTC month)",
|
|
340
|
+
};
|
|
341
|
+
const DEV_PUSHES_FLAG: FlagSpec = {
|
|
342
|
+
name: "dev-pushes",
|
|
343
|
+
type: "boolean",
|
|
344
|
+
help: "ship only: this runtime pushes to dev (lock lives in the main checkout)",
|
|
345
|
+
};
|
|
346
|
+
|
|
347
|
+
function kindOf(ctx: RunContext): Kind {
|
|
348
|
+
const kind = String(ctx.flags.kind);
|
|
349
|
+
if (!(KINDS as readonly string[]).includes(kind))
|
|
350
|
+
throw new CommandError(EXIT.USAGE, "--kind must be workflow or dev");
|
|
351
|
+
return kind as Kind;
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
function deadlineOf(ctx: RunContext): number {
|
|
355
|
+
const raw = str(ctx.flags.deadline);
|
|
356
|
+
if (raw === undefined) return TIMEOUTS.SHIP_DEV_LOCK_ACQUIRE_DEADLINE_S;
|
|
357
|
+
if (!/^[0-9]+$/.test(raw))
|
|
358
|
+
throw new CommandError(EXIT.USAGE, `--deadline must be whole seconds, got "${raw}"`);
|
|
359
|
+
return Number(raw);
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
export const locksCommand: CommandSpec = {
|
|
363
|
+
noun: "locks",
|
|
364
|
+
summary: "Acquire and release the per-feature workflow lock and the dev lock.",
|
|
365
|
+
verbs: {
|
|
366
|
+
acquire: {
|
|
367
|
+
summary: "Take a lock: workflow (reclaims a dead holder's) or dev (bounded wait).",
|
|
368
|
+
flags: [
|
|
369
|
+
KIND_FLAG,
|
|
370
|
+
LOCK_WORKFLOW_FLAG,
|
|
371
|
+
FID_FLAG,
|
|
372
|
+
MONTH_FLAG,
|
|
373
|
+
DEV_PUSHES_FLAG,
|
|
374
|
+
{
|
|
375
|
+
name: "deadline",
|
|
376
|
+
type: "string",
|
|
377
|
+
help: `dev kind: seconds to wait for a busy lock (default ${TIMEOUTS.SHIP_DEV_LOCK_ACQUIRE_DEADLINE_S})`,
|
|
378
|
+
},
|
|
379
|
+
],
|
|
380
|
+
output: {
|
|
381
|
+
kind: "workflow or dev",
|
|
382
|
+
path: "absolute path of the lock file",
|
|
383
|
+
token: "this holder's token; pass it to release",
|
|
384
|
+
month: "workflow kind: the month bucket (null for dev)",
|
|
385
|
+
reclaimed:
|
|
386
|
+
"workflow kind: {holder, reason: finished|stale|orphaned}; dev kind: the stale line; null when none",
|
|
387
|
+
waitedS: "dev kind: seconds spent waiting (null for workflow)",
|
|
388
|
+
},
|
|
389
|
+
exitCodes: {
|
|
390
|
+
[EXIT_SPLIT_BUCKET]: "workflow kind: the feature has logs in more than one month bucket",
|
|
391
|
+
},
|
|
392
|
+
run: async (ctx) => {
|
|
393
|
+
const kind = kindOf(ctx);
|
|
394
|
+
const workflow = String(ctx.flags.workflow);
|
|
395
|
+
const fid = String(ctx.flags.fid);
|
|
396
|
+
if (kind === "workflow") {
|
|
397
|
+
if (ctx.flags.deadline !== undefined)
|
|
398
|
+
throw new CommandError(EXIT.USAGE, "--deadline applies to --kind=dev only");
|
|
399
|
+
const lock = acquireWorkflowLock({
|
|
400
|
+
cwd: ctx.cwd,
|
|
401
|
+
workflow,
|
|
402
|
+
fid,
|
|
403
|
+
month: str(ctx.flags.month),
|
|
404
|
+
devPushes: ctx.flags.devPushes === true,
|
|
405
|
+
log: ctx.log,
|
|
406
|
+
});
|
|
407
|
+
ctx.emit({ kind, ...lock, waitedS: null });
|
|
408
|
+
return EXIT.OK;
|
|
409
|
+
}
|
|
410
|
+
const lock = await acquireDevLock({
|
|
411
|
+
cwd: ctx.cwd,
|
|
412
|
+
workflow,
|
|
413
|
+
fid,
|
|
414
|
+
deadlineS: deadlineOf(ctx),
|
|
415
|
+
log: ctx.log,
|
|
416
|
+
});
|
|
417
|
+
ctx.emit({ kind, ...lock, month: null });
|
|
418
|
+
return EXIT.OK;
|
|
419
|
+
},
|
|
420
|
+
},
|
|
421
|
+
release: {
|
|
422
|
+
summary: "Remove a lock this caller owns; another owner's lock is left in place.",
|
|
423
|
+
flags: [
|
|
424
|
+
KIND_FLAG,
|
|
425
|
+
LOCK_WORKFLOW_FLAG,
|
|
426
|
+
FID_FLAG,
|
|
427
|
+
MONTH_FLAG,
|
|
428
|
+
DEV_PUSHES_FLAG,
|
|
429
|
+
{
|
|
430
|
+
name: "token",
|
|
431
|
+
type: "string",
|
|
432
|
+
help: "the token acquire returned (default: match workflow and fid)",
|
|
433
|
+
},
|
|
434
|
+
],
|
|
435
|
+
output: {
|
|
436
|
+
kind: "workflow or dev",
|
|
437
|
+
path: "absolute path of the lock file",
|
|
438
|
+
existed: "a lock file was there",
|
|
439
|
+
released: "this call removed it",
|
|
440
|
+
heldBy: "the other owner's lock line when it was left in place, else null",
|
|
441
|
+
},
|
|
442
|
+
exitCodes: {
|
|
443
|
+
[EXIT_SPLIT_BUCKET]:
|
|
444
|
+
"workflow kind without --month: the feature has logs in more than one month bucket",
|
|
445
|
+
[EXIT_NOT_OWNER]: "the lock belongs to another owner and was left in place",
|
|
446
|
+
[EXIT_REMOVE_FAILED]: "the lock file is still there after removing it",
|
|
447
|
+
},
|
|
448
|
+
run: (ctx) => {
|
|
449
|
+
const kind = kindOf(ctx);
|
|
450
|
+
const who = {
|
|
451
|
+
workflow: String(ctx.flags.workflow),
|
|
452
|
+
fid: String(ctx.flags.fid),
|
|
453
|
+
token: str(ctx.flags.token),
|
|
454
|
+
};
|
|
455
|
+
const root = repoRoot(ctx.cwd);
|
|
456
|
+
const file =
|
|
457
|
+
kind === "dev"
|
|
458
|
+
? devLockPath(root)
|
|
459
|
+
: workflowLockPath(
|
|
460
|
+
lockRoot(ctx.cwd, who.workflow, ctx.flags.devPushes === true),
|
|
461
|
+
resolveMonth(root, who.fid, str(ctx.flags.month)),
|
|
462
|
+
who.fid,
|
|
463
|
+
);
|
|
464
|
+
const { removeFailed, ...result } = releaseLock(file, who);
|
|
465
|
+
ctx.emit({ kind, ...result });
|
|
466
|
+
if (removeFailed) {
|
|
467
|
+
ctx.log(`lock removal failed: ${file}`);
|
|
468
|
+
return EXIT_REMOVE_FAILED;
|
|
469
|
+
}
|
|
470
|
+
if (result.heldBy !== null) {
|
|
471
|
+
ctx.log(`${file} belongs to another owner, left in place: ${result.heldBy}`);
|
|
472
|
+
return EXIT_NOT_OWNER;
|
|
473
|
+
}
|
|
474
|
+
return EXIT.OK;
|
|
475
|
+
},
|
|
476
|
+
},
|
|
477
|
+
},
|
|
478
|
+
};
|