@cbartens/bkit 5.5.1 → 6.1.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/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -204,12 +204,12 @@ export function runCursorModule(ctx: ModuleContext): void {
|
|
|
204
204
|
|
|
205
205
|
// Generated copy-paste-ready Cursor Background Agents setup doc — `.cursor/bkit-cloud.md`.
|
|
206
206
|
// Twin of `.claude/bkit-cloud.md` (runClaudeModule): UNTRACKED + gitignored, inlines REAL
|
|
207
|
-
// secret values resolved from `.envrc`
|
|
208
|
-
//
|
|
209
|
-
//
|
|
210
|
-
//
|
|
211
|
-
//
|
|
212
|
-
if (!dryRun && writeCursorCloudDoc(process.cwd(), tokens
|
|
207
|
+
// secret values resolved from `.envrc` — the same tracker-independent set as the Claude
|
|
208
|
+
// doc. Never enters ws.writes / canonicalHashes / `bkit check` drift — values are
|
|
209
|
+
// machine-local and expected to differ. Skipped on dry-run (`bkit check`) so a read-only
|
|
210
|
+
// check never writes secrets. Upgrade regenerates it via the same helper (see runUpgrade
|
|
211
|
+
// caller).
|
|
212
|
+
if (!dryRun && writeCursorCloudDoc(process.cwd(), tokens)) {
|
|
213
213
|
console.log(
|
|
214
214
|
`${logPrefix} ${tag}cursor: .cursor/bkit-cloud.md (generated — gitignored, holds resolved secrets)`,
|
|
215
215
|
);
|
|
@@ -16,6 +16,7 @@ import { stampManagedVersion } from "../version-file.js";
|
|
|
16
16
|
import { applyOpencodeAgent, applyOpencodeCommand } from "../../render/hosts.js";
|
|
17
17
|
import type { PreflightFinding } from "../../checks/before/index.js";
|
|
18
18
|
import {
|
|
19
|
+
getBkitDocsRoot,
|
|
19
20
|
getCoreRoot,
|
|
20
21
|
getSharedRoot,
|
|
21
22
|
getWorkflowsRoot,
|
|
@@ -30,7 +31,17 @@ import { readBkitConfig } from "../../shared/settings.js";
|
|
|
30
31
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
31
32
|
import type { ModuleContext } from "./index.js";
|
|
32
33
|
import { BKIT_PREFIX, installFile, listMdFiles, removeOrphans, trackMirrorWrite } from "./core.js";
|
|
33
|
-
import {
|
|
34
|
+
import {
|
|
35
|
+
buildOpencodeModelLookup,
|
|
36
|
+
isOpencodeProvider,
|
|
37
|
+
opencodeProviderId,
|
|
38
|
+
} from "../../render/models.js";
|
|
39
|
+
|
|
40
|
+
/** The distinct models bkit's prompts.md § Models pins on one opencode gateway column. */
|
|
41
|
+
function shippedPins(provider: string): string {
|
|
42
|
+
const lookup = buildOpencodeModelLookup(path.join(getBkitDocsRoot(), "prompts.md"), provider);
|
|
43
|
+
return [...new Set(lookup.values())].join(", ");
|
|
44
|
+
}
|
|
34
45
|
|
|
35
46
|
export function renderOpencodeAgentsCommands(ctx: ModuleContext): string[] {
|
|
36
47
|
const { dryRun, opencodeModelLookup, effortMap, opencodeProvider, logPrefix } = ctx;
|
|
@@ -158,7 +169,7 @@ export function detectOpencodeYmlProviderDrift(cwd: string): PreflightFinding |
|
|
|
158
169
|
const ymlPath = path.join(cwd, ".github", "workflows", "opencode.yml");
|
|
159
170
|
if (!fs.existsSync(ymlPath)) return null;
|
|
160
171
|
|
|
161
|
-
// The installed provider — package.json `bkit.
|
|
172
|
+
// The installed provider — package.json `bkit.providers.opencode.default` is the authoritative record
|
|
162
173
|
// written on install. Absent/broken/unsupported → the null-guard below skips silently.
|
|
163
174
|
const provider = readBkitConfig(cwd).opencodeProvider;
|
|
164
175
|
if (!provider) return null;
|
|
@@ -267,7 +278,7 @@ export function renderOpencodeJson(
|
|
|
267
278
|
// Same "oauth": false reason as github: the API token in the header is the only auth
|
|
268
279
|
// bkit wires, so a bad one fails as a 401, not as an OAuth sign-in prompt.
|
|
269
280
|
mcpEntry =
|
|
270
|
-
'"jira": { "type": "remote", "url": "https://mcp.atlassian.com/v2/mcp", "oauth": false, "headers": { "Authorization": "Bearer {env:
|
|
281
|
+
'"jira": { "type": "remote", "url": "https://mcp.atlassian.com/v2/mcp", "oauth": false, "headers": { "Authorization": "Bearer {env:BKIT_JIRA_API_KEY}" } }';
|
|
271
282
|
} else {
|
|
272
283
|
mcpEntry = "";
|
|
273
284
|
}
|
|
@@ -516,8 +527,9 @@ export function runOpencodeModule(ctx: ModuleContext): void {
|
|
|
516
527
|
}
|
|
517
528
|
}
|
|
518
529
|
|
|
519
|
-
// --- bkit-gateguard.js / bkit-readguard.js — Tier-2 markered-text
|
|
520
|
-
|
|
530
|
+
// --- bkit-gateguard.js / bkit-readguard.js / bkit-rules.js — Tier-2 markered-text
|
|
531
|
+
// (slash-comment); see install/manifest.ts ---
|
|
532
|
+
for (const plugin of ["bkit-gateguard.js", "bkit-readguard.js", "bkit-rules.js"]) {
|
|
521
533
|
const opencodeCore = path.join(getCoreRoot(), ".opencode", "plugin");
|
|
522
534
|
const pluginSrc = path.join(opencodeCore, plugin);
|
|
523
535
|
const pluginDst = `.opencode/plugin/${plugin}`;
|
|
@@ -571,7 +583,7 @@ export function runOpencodeModule(ctx: ModuleContext): void {
|
|
|
571
583
|
` env — {env:KEY} placeholders in opencode.json resolve empty without this. Quit the\n` +
|
|
572
584
|
` running app first (a running instance ignores the new env).\n` +
|
|
573
585
|
` 4. Model IDs: all four providers (openrouter, ollama, opencode-zen, opencode-go) install ready-to-run curated per-agent pins. ` +
|
|
574
|
-
`Re-pin any agent via .bkit/prompts.md § Model Overrides or by probing the provider's live /v1/models — see .bkit/providers.md §
|
|
586
|
+
`Re-pin any agent via .bkit/prompts.md § Model Overrides or by probing the provider's live /v1/models — see .bkit/providers.md § Provider models. NOTE: every ollama pin (${shippedPins("ollama")}) needs a paid Ollama plan. opencode-go pins (${shippedPins("opencode-go")}) — prefer pins that stay within the Go 5h usage window; opencode-zen pins are existence-validated via models.dev (the /zen/v1/models REST probe cannot see Go-only models — models.dev is the source of truth).\n` +
|
|
575
587
|
` 5. Verify with: \`bkit doctor\` (credentials + tools) and \`bkit status\` (installed hosts + providers).`,
|
|
576
588
|
});
|
|
577
589
|
}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
// install/template-notes.ts — the old opening note above `<!-- bkit:start -->` in the
|
|
2
|
+
// installed doc templates (`docs/templates/bkit-*.md`).
|
|
3
|
+
//
|
|
4
|
+
// Each doc template opens its managed block with a `<!-- Note: … -->` comment, so every
|
|
5
|
+
// upgrade refreshes it. Installs from older releases still hold bkit's note above
|
|
6
|
+
// `<!-- bkit:start -->`, where upgrade never writes. This migration removes that copy
|
|
7
|
+
// when it is byte-identical to a wording bkit shipped. Any other text above the block is
|
|
8
|
+
// the consumer's and stays. Register: docs/migrations.md.
|
|
9
|
+
|
|
10
|
+
import * as fs from "node:fs";
|
|
11
|
+
import * as path from "node:path";
|
|
12
|
+
|
|
13
|
+
import { findLineAnchoredMarkers } from "./managed-block.js";
|
|
14
|
+
import { sha256 } from "./version-file.js";
|
|
15
|
+
import type { WriteSet } from "./write.js";
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* sha256 of each opening-note line a doc template carried above `<!-- bkit:start -->`,
|
|
19
|
+
* collected from the history of `.bkit/core/docs/templates/` and
|
|
20
|
+
* `.bkit/templates/docs/templates/`.
|
|
21
|
+
*/
|
|
22
|
+
export const RETIRED_TEMPLATE_NOTE_HASHES: ReadonlySet<string> = new Set([
|
|
23
|
+
// Audit templates, 5.0.0 – 5.2.2 ("Never overwrite.", `@bkit-audit-generate` last).
|
|
24
|
+
"09669d937bb36d23473bfd32b1b4c850ab16f9404fb292312d4ece03430ae2ff",
|
|
25
|
+
// Audit templates, 5.2.3 – 6.0.0 (adds the `bkit:anchor` sentence).
|
|
26
|
+
"eeefcc0b47e569bf12f7215f40ce4d42d68b596a0ccea5f8e6127eb95f98bc61",
|
|
27
|
+
// Audit templates, unreleased dev wording (`@bkit-audit-generate` first).
|
|
28
|
+
"771ac2789eb695e49c4973711eacda22faff474a99aa954bc4fbb800a0389f53",
|
|
29
|
+
// Plan template, 5.0.0 – 5.2.2 ("also stamped … recording its base commit").
|
|
30
|
+
"f412345a8898a9201434c57672d522d8b5c44cb3cf64e4bb12057908c0031c3a",
|
|
31
|
+
// Plan template, 5.2.3 – 6.0.0 (names `baseSha`, `baseRef`, `designPath`, `designBaseSha`).
|
|
32
|
+
"7a49df77a90aa9d32ff43d4187302f31656f7195041ce143defaf7e5effc4e17",
|
|
33
|
+
// Plan template, pre-5.0.0 dev wording, written as `<\!-- Note:` ("set once at design start").
|
|
34
|
+
"b8c53cd711194b363c69c84657a04ed2c6c8dba428b0ea13b6810e368b00c721",
|
|
35
|
+
// Plan template, unreleased dev wording (`@bkit-plan-generate` first).
|
|
36
|
+
"c4b2c520134881923aab16c41501ccc263bbb21662435b4813dd9bf6ad82764f",
|
|
37
|
+
]);
|
|
38
|
+
|
|
39
|
+
const START_MARKER = "<!-- bkit:start -->";
|
|
40
|
+
const TEMPLATES_DIR = path.join("docs", "templates");
|
|
41
|
+
const OWNED_TEMPLATE = /^bkit-.+\.md$/;
|
|
42
|
+
/** An opening-note line, in the form bkit wrote it or the escaped form one dev build wrote. */
|
|
43
|
+
const NOTE_LINE = /^<\\?!-- Note:/;
|
|
44
|
+
/** What every shipped note names: the report or plan folder, or the agent that fills it. */
|
|
45
|
+
const BKIT_NOTE_TEXT = /docs\/(?:audits|plans)\/\{YYYYMM\}|@bkit-/;
|
|
46
|
+
const BOM = "\uFEFF";
|
|
47
|
+
|
|
48
|
+
export interface TemplateNoteResult {
|
|
49
|
+
/** The file with every shipped note above `<!-- bkit:start -->` removed. */
|
|
50
|
+
content: string;
|
|
51
|
+
/** How many shipped note lines were removed. */
|
|
52
|
+
removed: number;
|
|
53
|
+
/**
|
|
54
|
+
* Note lines above `<!-- bkit:start -->` that match no shipped wording but name what a
|
|
55
|
+
* bkit note names, so they read as an edited bkit note. Kept as written, like every
|
|
56
|
+
* other unmatched line.
|
|
57
|
+
*/
|
|
58
|
+
edited: string[];
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Removes each line above the single `<!-- bkit:start -->` whose text is a note wording
|
|
63
|
+
* bkit shipped, with the blank line after it. When nothing else is left above the block,
|
|
64
|
+
* every blank line there goes too. Every other line is kept. A leading byte-order mark is
|
|
65
|
+
* kept. A file without exactly one line-anchored start marker is returned unchanged; that
|
|
66
|
+
* includes a file with CRLF line endings throughout, whose marker the finder does not see.
|
|
67
|
+
*/
|
|
68
|
+
export function stripRetiredTemplateNotes(content: string): TemplateNoteResult {
|
|
69
|
+
const bom = content.startsWith(BOM) ? BOM : "";
|
|
70
|
+
const body = content.slice(bom.length);
|
|
71
|
+
const starts = findLineAnchoredMarkers(body, START_MARKER);
|
|
72
|
+
if (starts.length !== 1) return { content, removed: 0, edited: [] };
|
|
73
|
+
// The last element is the start marker's own line up to the marker, so it always stays.
|
|
74
|
+
const lines = body.slice(0, starts[0]).split("\n");
|
|
75
|
+
const drop = new Set<number>();
|
|
76
|
+
const edited: string[] = [];
|
|
77
|
+
lines.forEach((line, i) => {
|
|
78
|
+
if (!NOTE_LINE.test(line)) return;
|
|
79
|
+
if (RETIRED_TEMPLATE_NOTE_HASHES.has(sha256(line.replace(/\r$/, "")))) {
|
|
80
|
+
drop.add(i);
|
|
81
|
+
if (i + 1 < lines.length - 1 && lines[i + 1]!.trim() === "") drop.add(i + 1);
|
|
82
|
+
} else if (BKIT_NOTE_TEXT.test(line)) {
|
|
83
|
+
edited.push(line);
|
|
84
|
+
}
|
|
85
|
+
});
|
|
86
|
+
if (drop.size === 0) return { content, removed: 0, edited };
|
|
87
|
+
const head = lines.filter((_, i) => !drop.has(i)).join("\n");
|
|
88
|
+
return {
|
|
89
|
+
content: bom + (head.trim() === "" ? "" : head) + body.slice(starts[0]),
|
|
90
|
+
removed: [...drop].filter((i) => NOTE_LINE.test(lines[i]!)).length,
|
|
91
|
+
edited,
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Absolute paths already named in this process. */
|
|
96
|
+
const warned = new Set<string>();
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Migration (installs up to 6.0.x, `docs/migrations.md`): for each installed
|
|
100
|
+
* `docs/templates/bkit-*.md`, removes bkit's old opening note above `<!-- bkit:start -->`.
|
|
101
|
+
* The removal is recorded in ws, so `bkit check` fails until upgrade runs. A note that
|
|
102
|
+
* matches no shipped wording is kept. When it names what a bkit note names, install, upgrade
|
|
103
|
+
* and `bkit check` print one line naming the file.
|
|
104
|
+
*/
|
|
105
|
+
export function migrateTemplateNotes(dryRun: boolean, ws: WriteSet, logPrefix: string): void {
|
|
106
|
+
if (!fs.lstatSync(TEMPLATES_DIR, { throwIfNoEntry: false })?.isDirectory()) return;
|
|
107
|
+
const tag = dryRun ? "[dry-run] " : "";
|
|
108
|
+
for (const name of fs.readdirSync(TEMPLATES_DIR).sort()) {
|
|
109
|
+
if (!OWNED_TEMPLATE.test(name)) continue;
|
|
110
|
+
const rel = path.join(TEMPLATES_DIR, name);
|
|
111
|
+
if (!fs.lstatSync(rel).isFile()) continue;
|
|
112
|
+
const result = stripRetiredTemplateNotes(fs.readFileSync(rel, "utf-8"));
|
|
113
|
+
// Upgrade runs this pass again as its closing dry-run check, so each file is named once.
|
|
114
|
+
const abs = path.resolve(rel);
|
|
115
|
+
if (result.edited.length > 0 && !warned.has(abs)) {
|
|
116
|
+
warned.add(abs);
|
|
117
|
+
const line = result.edited[0]!;
|
|
118
|
+
const shown = line.length > 80 ? `${line.slice(0, 80)}…` : line;
|
|
119
|
+
console.warn(
|
|
120
|
+
`${logPrefix} ${rel}: the note above \`<!-- bkit:start -->\` matches no note bkit shipped, so it was kept: ${shown} bkit's own note now sits inside the block, where upgrade refreshes it. If yours is an edited copy of bkit's old note, delete it.`,
|
|
121
|
+
);
|
|
122
|
+
}
|
|
123
|
+
if (result.removed === 0) continue;
|
|
124
|
+
if (!dryRun) fs.writeFileSync(rel, result.content, "utf-8");
|
|
125
|
+
if (!ws.writes.some((w) => w.path === rel)) ws.writes.push({ path: rel, action: "update" });
|
|
126
|
+
console.log(
|
|
127
|
+
`${logPrefix} ${tag}core: ${rel} — removed bkit's old note above \`<!-- bkit:start -->\` (it now sits inside the block)`,
|
|
128
|
+
);
|
|
129
|
+
}
|
|
130
|
+
}
|
|
@@ -16,6 +16,7 @@ import * as path from "node:path";
|
|
|
16
16
|
import * as crypto from "node:crypto";
|
|
17
17
|
import { parseJson } from "../shared/json.js";
|
|
18
18
|
import { getTemplatesRoot, templateRelPath } from "../shared/package-roots.js";
|
|
19
|
+
import { isSchemaLedger } from "../ledgers/migrate.js";
|
|
19
20
|
|
|
20
21
|
// ---------------------------------------------------------------------------
|
|
21
22
|
// Schema types
|
|
@@ -153,8 +154,9 @@ export function isConsumerModified(
|
|
|
153
154
|
* reads the file, uninstall deletes it — so an entry for an absent path is dead
|
|
154
155
|
* bookkeeping, and a file recreated at that path later would be misclassified as
|
|
155
156
|
* bkit-owned. A template-set path is never a file bkit owns: install copies it
|
|
156
|
-
* byte-for-byte into `.bkit/templates/` and never writes the consumer's own copy
|
|
157
|
-
*
|
|
157
|
+
* byte-for-byte into `.bkit/templates/` and never writes the consumer's own copy
|
|
158
|
+
* (bar the brand migrations, which rewrite it only where bkit's exact shipped old text matches,
|
|
159
|
+
* `docs/migrations.md`), so it must carry no ownership hash. Retired and renamed managed files leave such
|
|
158
160
|
* entries behind, and a pure merge would preserve them forever (the
|
|
159
161
|
* `.bkit/scripts/…` entry a #507 move left and the `scripts/graphify/**` +
|
|
160
162
|
* `scripts/serena/bkit-serena-mcp.sh` entries a #489 move left are the observed
|
|
@@ -184,14 +186,17 @@ export function mergeCanonicalHashes(
|
|
|
184
186
|
if (
|
|
185
187
|
!fs.existsSync(path.join(cwd, relPath)) ||
|
|
186
188
|
isRemoving(relPath) ||
|
|
187
|
-
isTemplateSetPath(relPath)
|
|
189
|
+
isTemplateSetPath(relPath) ||
|
|
190
|
+
isSchemaLedger(relPath)
|
|
188
191
|
) {
|
|
189
192
|
pruned++;
|
|
190
193
|
continue;
|
|
191
194
|
}
|
|
192
195
|
canonicalHashes[relPath] = hash;
|
|
193
196
|
}
|
|
194
|
-
|
|
197
|
+
// A ledger is append-only data a migration may rewrite, never a managed file.
|
|
198
|
+
const kept = Object.fromEntries(Object.entries(fresh).filter(([p]) => !isSchemaLedger(p)));
|
|
199
|
+
return { canonicalHashes: { ...canonicalHashes, ...kept }, pruned };
|
|
195
200
|
}
|
|
196
201
|
|
|
197
202
|
/** True when `dest` is a member of the package's copy-and-own template set. */
|
|
@@ -610,6 +610,11 @@ export function ensurePackageJsonScripts(
|
|
|
610
610
|
export interface WriteEntry {
|
|
611
611
|
path: string;
|
|
612
612
|
action: "write" | "update" | "append";
|
|
613
|
+
/**
|
|
614
|
+
* A copy-and-own file a brand migration rewrote (`docs/migrations.md`). It stays in the
|
|
615
|
+
* write set for dry-run parity and `bkit check`, and never gets a canonical hash.
|
|
616
|
+
*/
|
|
617
|
+
unhashed?: true;
|
|
613
618
|
}
|
|
614
619
|
|
|
615
620
|
export interface WriteSet {
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
// `bkit ledgers compact`: the five keyed ledgers rewritten to their fold winners
|
|
2
|
+
// (`.bkit/jsonl.md` § Compaction). A superseded same-identity row is dropped; the
|
|
3
|
+
// winner stays in place and gains `firstTs` + `updates` from every row of its entry,
|
|
4
|
+
// so age and recurrence survive the drop. Malformed, non-object, blank and keyless
|
|
5
|
+
// lines, and rows of kinds outside `AGED_KINDS`, stay byte-for-byte, as does a
|
|
6
|
+
// winner already carrying the right values, so a second run changes nothing. A
|
|
7
|
+
// union merge that brings dropped rows back is undone by the next run.
|
|
8
|
+
|
|
9
|
+
import * as fs from "node:fs";
|
|
10
|
+
import * as path from "node:path";
|
|
11
|
+
|
|
12
|
+
import { parseJson } from "../shared/json.js";
|
|
13
|
+
import {
|
|
14
|
+
APPEND_LEDGERS,
|
|
15
|
+
compareTs,
|
|
16
|
+
identity,
|
|
17
|
+
isAgedRow,
|
|
18
|
+
lineage,
|
|
19
|
+
normalize,
|
|
20
|
+
placeLineage,
|
|
21
|
+
type TelemetryEvent,
|
|
22
|
+
} from "./telemetry.js";
|
|
23
|
+
|
|
24
|
+
/** The ledgers compaction rewrites, by `--ledger` name. */
|
|
25
|
+
export const COMPACT_LEDGERS = {
|
|
26
|
+
knowledge: APPEND_LEDGERS.knowledge.file,
|
|
27
|
+
decisions: APPEND_LEDGERS.decisions.file,
|
|
28
|
+
deferrals: APPEND_LEDGERS.deferrals.file,
|
|
29
|
+
failures: APPEND_LEDGERS.failures.file,
|
|
30
|
+
issues: ".bkit/issues.jsonl",
|
|
31
|
+
} as const;
|
|
32
|
+
|
|
33
|
+
export type CompactLedger = keyof typeof COMPACT_LEDGERS;
|
|
34
|
+
|
|
35
|
+
export interface CompactCounts {
|
|
36
|
+
/** Lines holding a row this run folds. */
|
|
37
|
+
rows: number;
|
|
38
|
+
/** Superseded rows removed. */
|
|
39
|
+
dropped: number;
|
|
40
|
+
/** Winners whose `firstTs` / `updates` were set or corrected. */
|
|
41
|
+
stamped: number;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** A line's row when it is a JSON object, else undefined. */
|
|
45
|
+
function rowOf(body: string): Record<string, unknown> | undefined {
|
|
46
|
+
const parsed = parseJson(body);
|
|
47
|
+
const row = parsed.ok ? parsed.value : undefined;
|
|
48
|
+
return row !== null && typeof row === "object" && !Array.isArray(row)
|
|
49
|
+
? (row as Record<string, unknown>)
|
|
50
|
+
: undefined;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/** `text` with each entry's superseded rows dropped and its winner stamped, plus the counts. */
|
|
54
|
+
export function compactLedgerText(text: string): CompactCounts & { text: string } {
|
|
55
|
+
const lines = text.split("\n");
|
|
56
|
+
// `row` = the line read through `normalize`, as the fold reads it; `raw` = as written.
|
|
57
|
+
type Entry = { i: number; row: Record<string, unknown>; raw: Record<string, unknown> };
|
|
58
|
+
const groups = new Map<string, Entry[]>();
|
|
59
|
+
lines.forEach((line, i) => {
|
|
60
|
+
const body = line.replace(/\r$/, "");
|
|
61
|
+
if (body.trim() === "") return;
|
|
62
|
+
const raw = rowOf(body);
|
|
63
|
+
if (raw === undefined) return;
|
|
64
|
+
const row = normalize(raw);
|
|
65
|
+
if (!isAgedRow(row)) return;
|
|
66
|
+
const id = identity(row as TelemetryEvent);
|
|
67
|
+
groups.set(id, [...(groups.get(id) ?? []), { i, row, raw }]);
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
const drop = new Set<number>();
|
|
71
|
+
const replace = new Map<number, string>();
|
|
72
|
+
let rows = 0;
|
|
73
|
+
let stamped = 0;
|
|
74
|
+
for (const group of groups.values()) {
|
|
75
|
+
rows += group.length;
|
|
76
|
+
// The fold's winner: highest `ts`, the later line on a tie.
|
|
77
|
+
const winner = group.reduce((best, r) =>
|
|
78
|
+
compareTs({ ts: r.row["ts"] }, { ts: best.row["ts"] }) >= 0 ? r : best,
|
|
79
|
+
);
|
|
80
|
+
for (const r of group) if (r !== winner) drop.add(r.i);
|
|
81
|
+
const l = lineage(group.map((r) => r.row));
|
|
82
|
+
if (winner.row["firstTs"] === l.firstTs && winner.row["updates"] === l.updates) continue;
|
|
83
|
+
const crlf = (lines[winner.i] ?? "").endsWith("\r") ? "\r" : "";
|
|
84
|
+
replace.set(winner.i, JSON.stringify(placeLineage(winner.raw, l)) + crlf);
|
|
85
|
+
stamped++;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
const out = lines.flatMap((line, i) => (drop.has(i) ? [] : [replace.get(i) ?? line]));
|
|
89
|
+
return { text: out.join("\n"), rows, dropped: drop.size, stamped };
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export interface CompactResult extends CompactCounts {
|
|
93
|
+
ledger: CompactLedger;
|
|
94
|
+
file: string;
|
|
95
|
+
/** False when the file is absent, or `dryRun` / nothing to change left it as it was. */
|
|
96
|
+
written: boolean;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/**
|
|
100
|
+
* Compact each named ledger under `root`; with `dryRun`, only count. Writes via temp
|
|
101
|
+
* file + rename, and only when the text changes, so an interrupted run never leaves a
|
|
102
|
+
* torn ledger. A missing ledger is reported with zero counts.
|
|
103
|
+
*/
|
|
104
|
+
export function compactLedgers(
|
|
105
|
+
root: string,
|
|
106
|
+
ledgers: readonly CompactLedger[],
|
|
107
|
+
dryRun: boolean,
|
|
108
|
+
): CompactResult[] {
|
|
109
|
+
return ledgers.map((ledger) => {
|
|
110
|
+
const file = COMPACT_LEDGERS[ledger];
|
|
111
|
+
const abs = path.join(root, file);
|
|
112
|
+
if (!fs.lstatSync(abs, { throwIfNoEntry: false })?.isFile()) {
|
|
113
|
+
return { ledger, file, rows: 0, dropped: 0, stamped: 0, written: false };
|
|
114
|
+
}
|
|
115
|
+
const { text, ...counts } = compactLedgerText(fs.readFileSync(abs, "utf-8"));
|
|
116
|
+
const change = counts.dropped + counts.stamped > 0;
|
|
117
|
+
if (change && !dryRun) {
|
|
118
|
+
const tmp = `${abs}.bkit-compact.tmp`;
|
|
119
|
+
fs.writeFileSync(tmp, text, "utf-8");
|
|
120
|
+
fs.renameSync(tmp, abs);
|
|
121
|
+
}
|
|
122
|
+
return { ledger, file, ...counts, written: change && !dryRun };
|
|
123
|
+
});
|
|
124
|
+
}
|