@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
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
// ledgers/journal.ts — the dispatch seam's row primitives.
|
|
2
|
+
//
|
|
3
|
+
// `commands/lib.ts` `runCommand` writes two kinds of row while a workflow run is
|
|
4
|
+
// active: an `engine-call` row in the run's `status.jsonl` (one per bkit command
|
|
5
|
+
// dispatched, except one git launched or one made while the run's repo has a rebase
|
|
6
|
+
// paused) and a `friction` row in the run's own `.bkit/friction.jsonl` (one per
|
|
7
|
+
// unexpected non-zero exit). `status row --type=owner-pause` writes a `human-confirm`
|
|
8
|
+
// friction row through the same append. This module builds and appends them. It is a leaf:
|
|
9
|
+
// it imports only `node:*`, `../shared/json.js`, `./status.js` and `./telemetry.js`, never a `commands/**`
|
|
10
|
+
// module, so `lib.ts` can import it without a cycle. The caller passes in the exit
|
|
11
|
+
// codes that are declared routing (`SHARED_EXIT_CODES` plus the verb's own).
|
|
12
|
+
//
|
|
13
|
+
// Every export is synchronous and never throws; a write returns a result object the
|
|
14
|
+
// caller logs and swallows, so the journal can never change a command's exit code.
|
|
15
|
+
|
|
16
|
+
import * as fs from "node:fs";
|
|
17
|
+
import * as path from "node:path";
|
|
18
|
+
|
|
19
|
+
import { parseJson } from "../shared/json.js";
|
|
20
|
+
import { appendLine, statusTimestamp } from "./status.js";
|
|
21
|
+
import {
|
|
22
|
+
APPEND_LEDGERS,
|
|
23
|
+
SCHEMA,
|
|
24
|
+
compareTs,
|
|
25
|
+
mintTs,
|
|
26
|
+
resolveRepoSlug,
|
|
27
|
+
validate,
|
|
28
|
+
writerProblem,
|
|
29
|
+
} from "./telemetry.js";
|
|
30
|
+
|
|
31
|
+
export type JournalResult = { ok: true } | { ok: false; error: string };
|
|
32
|
+
|
|
33
|
+
/** The kill switch: `BKIT_ENGINE_JOURNAL=off` keeps the seam from writing any row. */
|
|
34
|
+
export function journalEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
|
|
35
|
+
return env["BKIT_ENGINE_JOURNAL"] !== "off";
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* True when git launched this process: git exports `GIT_EXEC_PATH` to every hook
|
|
40
|
+
* (pre-commit, commit-msg, post-commit, pre-push, post-checkout, post-merge, ...) and
|
|
41
|
+
* to the children it spawns, and a plain shell does not set it.
|
|
42
|
+
*/
|
|
43
|
+
export function launchedByGit(env: NodeJS.ProcessEnv = process.env): boolean {
|
|
44
|
+
const value = env["GIT_EXEC_PATH"];
|
|
45
|
+
return value !== undefined && value !== "";
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* True while the repo holding `dir` has a rebase paused: its git dir holds `rebase-merge`
|
|
50
|
+
* or `rebase-apply`. A worktree's `.git` file names its own git dir. A row appended then
|
|
51
|
+
* leaves a tracked `status.jsonl` with an unstaged change, and `git rebase --continue`
|
|
52
|
+
* refuses to go on.
|
|
53
|
+
*/
|
|
54
|
+
export function rebasePaused(dir: string): boolean {
|
|
55
|
+
for (let at = path.resolve(dir); ; at = path.dirname(at)) {
|
|
56
|
+
const dotGit = path.join(at, ".git");
|
|
57
|
+
if (fs.existsSync(dotGit)) {
|
|
58
|
+
let gitDir = dotGit;
|
|
59
|
+
if (fs.statSync(dotGit).isFile()) {
|
|
60
|
+
const named = /^gitdir:\s*(.+)$/m.exec(fs.readFileSync(dotGit, "utf-8"))?.[1]?.trim();
|
|
61
|
+
if (named === undefined) return false;
|
|
62
|
+
gitDir = path.resolve(at, named);
|
|
63
|
+
}
|
|
64
|
+
return ["rebase-merge", "rebase-apply"].some((d) => fs.existsSync(path.join(gitDir, d)));
|
|
65
|
+
}
|
|
66
|
+
if (path.dirname(at) === at) return false;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/** Flag names in `argv` (`--name=value` and `--name value` both give `name`); values are never kept. */
|
|
71
|
+
function flagNames(argv: readonly string[]): string[] {
|
|
72
|
+
const names = argv
|
|
73
|
+
.filter((arg) => arg.startsWith("--") && arg.length > 2)
|
|
74
|
+
.map((arg) => {
|
|
75
|
+
const eq = arg.indexOf("=");
|
|
76
|
+
return arg.slice(2, eq === -1 ? undefined : eq);
|
|
77
|
+
});
|
|
78
|
+
return [...new Set(names)];
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
export type EngineCallRow = {
|
|
82
|
+
type: "engine-call";
|
|
83
|
+
workflow: string;
|
|
84
|
+
at: string;
|
|
85
|
+
noun: string;
|
|
86
|
+
verb: string;
|
|
87
|
+
/** Flag names only, never values. */
|
|
88
|
+
flags: string[];
|
|
89
|
+
};
|
|
90
|
+
|
|
91
|
+
/** The `status.jsonl` row recording that a bkit command was dispatched. `flags` is the raw argv after the verb. */
|
|
92
|
+
export function engineCallRow(input: {
|
|
93
|
+
workflow: string;
|
|
94
|
+
at?: string;
|
|
95
|
+
noun: string;
|
|
96
|
+
verb: string;
|
|
97
|
+
flags: readonly string[];
|
|
98
|
+
}): EngineCallRow {
|
|
99
|
+
return {
|
|
100
|
+
type: "engine-call",
|
|
101
|
+
workflow: input.workflow,
|
|
102
|
+
at: input.at ?? statusTimestamp(),
|
|
103
|
+
noun: input.noun,
|
|
104
|
+
verb: input.verb,
|
|
105
|
+
flags: flagNames(input.flags),
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/** True when `code` (null = the command threw) is not a declared routing exit. */
|
|
110
|
+
export function shouldRecordFriction(
|
|
111
|
+
code: number | null,
|
|
112
|
+
excludedCodes: ReadonlySet<number>,
|
|
113
|
+
): boolean {
|
|
114
|
+
return code === null || !excludedCodes.has(code);
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/**
|
|
118
|
+
* Dedup key `<noun>-<verb>/<step>`. The identity-gated prune truncates a friction
|
|
119
|
+
* key at about 68 characters, so two longer keys with one prefix collide; the key
|
|
120
|
+
* stays under KEY_LIMIT by clipping the step.
|
|
121
|
+
*/
|
|
122
|
+
export function frictionKey(noun: string, verb: string, step: string): string {
|
|
123
|
+
const head = `${noun}-${verb}/`;
|
|
124
|
+
return head + step.slice(0, Math.max(0, KEY_LIMIT - head.length));
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
const KEY_LIMIT = 60;
|
|
128
|
+
|
|
129
|
+
/** `bkit.version` from `<bookRoot>/.bkit/version`; "unknown" when unreadable. */
|
|
130
|
+
function pinnedVersion(bookRoot: string): string {
|
|
131
|
+
const file = path.join(bookRoot, ".bkit", "version");
|
|
132
|
+
if (!fs.existsSync(file)) return "unknown";
|
|
133
|
+
const hit = /"pinnedVersion"\s*:\s*"([^"]+)"/.exec(fs.readFileSync(file, "utf-8"));
|
|
134
|
+
return hit?.[1] ?? "unknown";
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* The `tool-failure` friction row for an unexpected exit. `by.step` is the failing
|
|
139
|
+
* command's own `--step=` value, else the `<noun>-<verb>` sentinel, so it is never
|
|
140
|
+
* empty. `run` carries `parentSha` only when it resolved.
|
|
141
|
+
*/
|
|
142
|
+
export function frictionRow(input: {
|
|
143
|
+
workflow: string;
|
|
144
|
+
step?: string;
|
|
145
|
+
noun: string;
|
|
146
|
+
verb: string;
|
|
147
|
+
code: number | null;
|
|
148
|
+
bookRoot: string;
|
|
149
|
+
parentSha?: string;
|
|
150
|
+
}): Record<string, unknown> {
|
|
151
|
+
const step = input.step && input.step !== "" ? input.step : `${input.noun}-${input.verb}`;
|
|
152
|
+
const how = input.code === null ? "threw an unhandled error" : `exited ${input.code}`;
|
|
153
|
+
const row: Record<string, unknown> = {
|
|
154
|
+
schema: SCHEMA,
|
|
155
|
+
ts: mintTs(),
|
|
156
|
+
kind: "friction",
|
|
157
|
+
key: frictionKey(input.noun, input.verb, step),
|
|
158
|
+
repo: resolveRepoSlug(input.bookRoot) || "unknown/repo",
|
|
159
|
+
bkit: { version: pinnedVersion(input.bookRoot) },
|
|
160
|
+
by: { workflow: input.workflow, step },
|
|
161
|
+
category: "tool-failure",
|
|
162
|
+
scope: "bkit-repo",
|
|
163
|
+
severity: "MEDIUM",
|
|
164
|
+
summary: `bkit ${input.noun} ${input.verb} ${how}`,
|
|
165
|
+
description: `\`bkit ${input.noun} ${input.verb}\` ${how} at ${step}; the code is not one the command declares as routing.`,
|
|
166
|
+
source: "orchestrator",
|
|
167
|
+
status: "OPEN",
|
|
168
|
+
};
|
|
169
|
+
if (input.parentSha !== undefined && input.parentSha !== "") {
|
|
170
|
+
row["run"] = { parentSha: input.parentSha };
|
|
171
|
+
}
|
|
172
|
+
return row;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
/**
|
|
176
|
+
* The `human-confirm` friction row for an owner pause (`status row --type=owner-pause`).
|
|
177
|
+
* `key` is `owner-pause/<workflow>.<reason>`, or `owner-pause/<workflow>` with no
|
|
178
|
+
* reason, clipped to KEY_LIMIT. `run` carries `parentSha` only when it resolved.
|
|
179
|
+
*/
|
|
180
|
+
export function pauseFrictionRow(input: {
|
|
181
|
+
workflow: string;
|
|
182
|
+
reason?: string;
|
|
183
|
+
bookRoot: string;
|
|
184
|
+
parentSha?: string;
|
|
185
|
+
}): Record<string, unknown> {
|
|
186
|
+
const point =
|
|
187
|
+
input.reason !== undefined && input.reason !== ""
|
|
188
|
+
? `${input.workflow}.${input.reason}`
|
|
189
|
+
: input.workflow;
|
|
190
|
+
const row: Record<string, unknown> = {
|
|
191
|
+
schema: SCHEMA,
|
|
192
|
+
ts: mintTs(),
|
|
193
|
+
kind: "friction",
|
|
194
|
+
key: `owner-pause/${point}`.slice(0, KEY_LIMIT),
|
|
195
|
+
repo: resolveRepoSlug(input.bookRoot) || "unknown/repo",
|
|
196
|
+
bkit: { version: pinnedVersion(input.bookRoot) },
|
|
197
|
+
by: { workflow: input.workflow, step: "owner-pause" },
|
|
198
|
+
category: "human-confirm",
|
|
199
|
+
scope: "bkit-repo",
|
|
200
|
+
severity: "LOW",
|
|
201
|
+
summary: `${input.workflow} paused for the owner at ${point}`,
|
|
202
|
+
description: `The ${input.workflow} workflow stopped and asked the owner (\`owner-pause\` at ${point}).`,
|
|
203
|
+
source: "orchestrator",
|
|
204
|
+
status: "OPEN",
|
|
205
|
+
};
|
|
206
|
+
if (input.parentSha !== undefined && input.parentSha !== "") {
|
|
207
|
+
row["run"] = { parentSha: input.parentSha };
|
|
208
|
+
}
|
|
209
|
+
return row;
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/** Append one `engine-call` row to a run's `status.jsonl`. */
|
|
213
|
+
export function appendJournalRow(file: string, row: EngineCallRow): JournalResult {
|
|
214
|
+
try {
|
|
215
|
+
fs.appendFileSync(file, appendLine(row));
|
|
216
|
+
return { ok: true };
|
|
217
|
+
} catch (err) {
|
|
218
|
+
return { ok: false, error: (err as Error).message };
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* Append a friction row to `<bookRoot>/.bkit/friction.jsonl` with `recurrenceCount` 1.
|
|
224
|
+
* A recurrence appends the same-`key` fold winner again with a later `ts`, its
|
|
225
|
+
* `recurrenceCount` raised by one and `lastConfirmed` = that `ts`. No line is
|
|
226
|
+
* ever rewritten, so a row another writer appends meanwhile is kept.
|
|
227
|
+
*/
|
|
228
|
+
export function appendFrictionRow(bookRoot: string, row: Record<string, unknown>): JournalResult {
|
|
229
|
+
const checked = validate(row);
|
|
230
|
+
if (!checked.ok) return { ok: false, error: checked.reason ?? "invalid friction row" };
|
|
231
|
+
const who = writerProblem(row);
|
|
232
|
+
if (who !== undefined) return { ok: false, error: who };
|
|
233
|
+
const file = path.join(bookRoot, APPEND_LEDGERS.friction.file);
|
|
234
|
+
try {
|
|
235
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
236
|
+
const text = fs.existsSync(file) ? fs.readFileSync(file, "utf-8") : "";
|
|
237
|
+
const prior = latestSameKey(text, row["key"]);
|
|
238
|
+
const next = prior === undefined ? { ...row, recurrenceCount: 1 } : recurrence(prior, row);
|
|
239
|
+
fs.appendFileSync(
|
|
240
|
+
file,
|
|
241
|
+
`${text !== "" && !text.endsWith("\n") ? "\n" : ""}${JSON.stringify(next)}\n`,
|
|
242
|
+
);
|
|
243
|
+
return { ok: true };
|
|
244
|
+
} catch (err) {
|
|
245
|
+
return { ok: false, error: (err as Error).message };
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
/**
|
|
250
|
+
* The row recording one more occurrence of `prior`: its fields with a `ts` later
|
|
251
|
+
* than its own, the raised count and `lastConfirmed`. A `CLOSED` prior reopens with
|
|
252
|
+
* `row`'s `status`, so a fixed failure that comes back reaches triage again. Falls
|
|
253
|
+
* back to `row`'s fields when `prior`'s no longer validate.
|
|
254
|
+
*/
|
|
255
|
+
function recurrence(
|
|
256
|
+
prior: Record<string, unknown>,
|
|
257
|
+
row: Record<string, unknown>,
|
|
258
|
+
): Record<string, unknown> {
|
|
259
|
+
const count = typeof prior["recurrenceCount"] === "number" ? prior["recurrenceCount"] : 1;
|
|
260
|
+
const ts =
|
|
261
|
+
typeof prior["ts"] === "number" && (row["ts"] as number) <= prior["ts"]
|
|
262
|
+
? mintTs(prior["ts"])
|
|
263
|
+
: row["ts"];
|
|
264
|
+
const raised = { recurrenceCount: count + 1, lastConfirmed: ts };
|
|
265
|
+
const reopened = prior["status"] === "CLOSED" ? { status: row["status"] } : {};
|
|
266
|
+
const carried = { ...prior, ts, ...raised, ...reopened };
|
|
267
|
+
return validate(carried).ok ? carried : { ...row, ts, ...raised };
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
/** The same-`key` friction row in `text` that `fold` keeps: highest `ts`, the later line on a tie. */
|
|
271
|
+
function latestSameKey(text: string, key: unknown): Record<string, unknown> | undefined {
|
|
272
|
+
let best: Record<string, unknown> | undefined;
|
|
273
|
+
for (const line of text.split("\n")) {
|
|
274
|
+
if (!line.includes(JSON.stringify(key))) continue;
|
|
275
|
+
const parsed = readRow(line);
|
|
276
|
+
if (parsed?.["kind"] !== "friction" || parsed["key"] !== key) continue;
|
|
277
|
+
if (best === undefined || compareTs({ ts: parsed["ts"] }, { ts: best["ts"] }) >= 0) {
|
|
278
|
+
best = parsed;
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
return best;
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
function readRow(line: string): Record<string, unknown> | undefined {
|
|
285
|
+
const parsed = parseJson(line);
|
|
286
|
+
if (!parsed.ok) return undefined;
|
|
287
|
+
const value = parsed.value;
|
|
288
|
+
return value !== null && typeof value === "object" && !Array.isArray(value)
|
|
289
|
+
? (value as Record<string, unknown>)
|
|
290
|
+
: undefined;
|
|
291
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
// Ledger rows written before `schema: 2` rewritten in place into the schema-2 shape
|
|
2
|
+
// (`docs/migrations.md`). Each line goes through `normalize`; a line that already
|
|
3
|
+
// carries `schema`, does not parse, or is not a JSON object stays byte-for-byte,
|
|
4
|
+
// so a second run changes nothing. Readers still normalize: a union merge can
|
|
5
|
+
// bring an old line back from a branch that predates the rewrite, beside its
|
|
6
|
+
// rewritten copy. The next run drops such a line instead of rewriting it twice.
|
|
7
|
+
|
|
8
|
+
import * as fs from "node:fs";
|
|
9
|
+
import * as path from "node:path";
|
|
10
|
+
|
|
11
|
+
import { parseJson } from "../shared/json.js";
|
|
12
|
+
import { normalize } from "./telemetry.js";
|
|
13
|
+
|
|
14
|
+
/** Every repo ledger whose rows carry the shared top section (`.bkit/jsonl.md`). */
|
|
15
|
+
export const SCHEMA_LEDGERS = [
|
|
16
|
+
".bkit/stats.jsonl",
|
|
17
|
+
".bkit/friction.jsonl",
|
|
18
|
+
".bkit/issues.jsonl",
|
|
19
|
+
"docs/decisions.jsonl",
|
|
20
|
+
"docs/deferrals.jsonl",
|
|
21
|
+
"docs/failures.jsonl",
|
|
22
|
+
"docs/knowledge.jsonl",
|
|
23
|
+
] as const;
|
|
24
|
+
|
|
25
|
+
/** True for a repo ledger path: append-only data, never a bkit-managed file. */
|
|
26
|
+
export const isSchemaLedger = (relPath: string): boolean =>
|
|
27
|
+
(SCHEMA_LEDGERS as readonly string[]).includes(relPath.split(path.sep).join("/"));
|
|
28
|
+
|
|
29
|
+
/** A line's row when it is a JSON object, else undefined. */
|
|
30
|
+
function rowOf(body: string): Record<string, unknown> | undefined {
|
|
31
|
+
const parsed = parseJson(body);
|
|
32
|
+
const row = parsed.ok ? parsed.value : undefined;
|
|
33
|
+
return row !== null && typeof row === "object" && !Array.isArray(row)
|
|
34
|
+
? (row as Record<string, unknown>)
|
|
35
|
+
: undefined;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* `text` with every pre-schema row rewritten; `rewritten` counts the lines changed.
|
|
40
|
+
* A pre-schema row whose rewrite is already a schema line of `text` is dropped and
|
|
41
|
+
* counted in `dropped`: it is that row's copy from an unmigrated branch.
|
|
42
|
+
*/
|
|
43
|
+
export function migrateLedgerText(text: string): {
|
|
44
|
+
text: string;
|
|
45
|
+
rewritten: number;
|
|
46
|
+
dropped: number;
|
|
47
|
+
} {
|
|
48
|
+
let rewritten = 0;
|
|
49
|
+
let dropped = 0;
|
|
50
|
+
const bodies = text.split("\n").map((line) => line.replace(/\r$/, ""));
|
|
51
|
+
const present = new Set(bodies.filter((b) => rowOf(b)?.["schema"] !== undefined));
|
|
52
|
+
const lines = text.split("\n").flatMap((line, i) => {
|
|
53
|
+
const body = bodies[i] ?? "";
|
|
54
|
+
if (body.trim() === "") return [line];
|
|
55
|
+
const row = rowOf(body);
|
|
56
|
+
if (row === undefined || row["schema"] !== undefined) return [line];
|
|
57
|
+
const next = JSON.stringify(normalize(row));
|
|
58
|
+
if (present.has(next)) {
|
|
59
|
+
dropped++;
|
|
60
|
+
return [];
|
|
61
|
+
}
|
|
62
|
+
rewritten++;
|
|
63
|
+
return [next + line.slice(body.length)];
|
|
64
|
+
});
|
|
65
|
+
return { text: lines.join("\n"), rewritten, dropped };
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* Rewrite (or drop, as {@link migrateLedgerText} does) the pre-schema rows of every {@link SCHEMA_LEDGERS} file under `root`;
|
|
70
|
+
* with `dryRun`, only count them. Returns the files that have (or had) such rows,
|
|
71
|
+
* with their line counts. Writes via temp file + rename, so an interrupted run
|
|
72
|
+
* never leaves a torn ledger.
|
|
73
|
+
*/
|
|
74
|
+
export function migrateLedgers(
|
|
75
|
+
root: string,
|
|
76
|
+
dryRun: boolean,
|
|
77
|
+
): Array<{ file: string; rewritten: number; dropped: number }> {
|
|
78
|
+
const out: Array<{ file: string; rewritten: number; dropped: number }> = [];
|
|
79
|
+
for (const file of SCHEMA_LEDGERS) {
|
|
80
|
+
const abs = path.join(root, file);
|
|
81
|
+
if (!fs.lstatSync(abs, { throwIfNoEntry: false })?.isFile()) continue;
|
|
82
|
+
const { text, rewritten, dropped } = migrateLedgerText(fs.readFileSync(abs, "utf-8"));
|
|
83
|
+
if (rewritten + dropped === 0) continue;
|
|
84
|
+
if (!dryRun) {
|
|
85
|
+
const tmp = `${abs}.bkit-migrate.tmp`;
|
|
86
|
+
fs.writeFileSync(tmp, text, "utf-8");
|
|
87
|
+
fs.renameSync(tmp, abs);
|
|
88
|
+
}
|
|
89
|
+
out.push({ file, rewritten, dropped });
|
|
90
|
+
}
|
|
91
|
+
return out;
|
|
92
|
+
}
|