@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,421 @@
|
|
|
1
|
+
// The measured blocks of a workflow run's `outcome` row (`.bkit/core/.bkit/jsonl.md`
|
|
2
|
+
// § Shared blocks): lines, steps, ci, plan and build, from git, the run's
|
|
3
|
+
// `status.jsonl` rows and its log folder. bkit's unshipped harvest script
|
|
4
|
+
// (`scripts/harvest/bkit-harvest.mjs`) computes the same blocks for its `run` rows, with the same rules.
|
|
5
|
+
import { createHash } from "node:crypto";
|
|
6
|
+
import * as fs from "node:fs";
|
|
7
|
+
import * as path from "node:path";
|
|
8
|
+
import { foldFrom, } from "../../ledgers/telemetry.js";
|
|
9
|
+
import { parseJson, readDirNames, readJsonFile, readTextFile } from "../../shared/json.js";
|
|
10
|
+
import { git } from "../lib.js";
|
|
11
|
+
import { appendLedgerRows } from "./ledgers.js";
|
|
12
|
+
import { readStatusEvents } from "./status.js";
|
|
13
|
+
import { parsePlanBlocks } from "./plan-blocks.js";
|
|
14
|
+
import { readTestFirst } from "./tests.js";
|
|
15
|
+
const msOf = (iso) => (typeof iso === "string" ? Date.parse(iso) : NaN);
|
|
16
|
+
/** Minutes to one decimal. */
|
|
17
|
+
export const minutesOf = (ms) => Math.round(ms / 6000) / 10;
|
|
18
|
+
/** `start` to `end`, unix ms. */
|
|
19
|
+
export function timeBlock(start, end) {
|
|
20
|
+
return { start, end, totalMinutes: minutesOf(end - start) };
|
|
21
|
+
}
|
|
22
|
+
/** Left out of a run's line counts: plans and run logs, and the ledgers. */
|
|
23
|
+
const LINES_EXCLUDE = [
|
|
24
|
+
":(exclude)docs/plans/**",
|
|
25
|
+
":(exclude,glob)docs/*.jsonl",
|
|
26
|
+
":(exclude,glob).bkit/*.jsonl",
|
|
27
|
+
];
|
|
28
|
+
const TEST_PATH = /(^|\/)(__tests__|tests?|spec|e2e)\/|[._-](test|spec)\.[^/]+$|_test\.[^/]+$|(^|\/)test_[^/]+\.py$/i;
|
|
29
|
+
const DOCS_PATH = /\.mdx?$|(^|\/)docs\//i;
|
|
30
|
+
/** `code`, `tests` or `docs`, from a changed file's path. */
|
|
31
|
+
export const lineClass = (file) => TEST_PATH.test(file) ? "tests" : DOCS_PATH.test(file) ? "docs" : "code";
|
|
32
|
+
/**
|
|
33
|
+
* Lines changed from `first` to `last`, cut at each merge on the first-parent
|
|
34
|
+
* chain (a dev sync) so merged-in work is not counted, each stretch diffed on its
|
|
35
|
+
* own. Null when git lacks either commit or `first` is not an ancestor of `last`.
|
|
36
|
+
*/
|
|
37
|
+
export function runLines(cwd, first, last) {
|
|
38
|
+
if (!first || !last)
|
|
39
|
+
return null;
|
|
40
|
+
if (git(cwd, ["merge-base", "--is-ancestor", first, last]) === null)
|
|
41
|
+
return null;
|
|
42
|
+
const chain = git(cwd, [
|
|
43
|
+
"rev-list",
|
|
44
|
+
"--first-parent",
|
|
45
|
+
"--reverse",
|
|
46
|
+
"--parents",
|
|
47
|
+
`${first}..${last}`,
|
|
48
|
+
]);
|
|
49
|
+
if (chain === null)
|
|
50
|
+
return null;
|
|
51
|
+
const stretches = [];
|
|
52
|
+
let from = first;
|
|
53
|
+
for (const line of chain.split("\n").filter(Boolean)) {
|
|
54
|
+
const [sha, parent, ...merged] = line.split(" ");
|
|
55
|
+
if (merged.length === 0)
|
|
56
|
+
continue;
|
|
57
|
+
stretches.push([from, parent]);
|
|
58
|
+
from = sha;
|
|
59
|
+
}
|
|
60
|
+
stretches.push([from, last]);
|
|
61
|
+
const blank = () => ({ added: 0, deleted: 0, files: 0 });
|
|
62
|
+
const parts = { code: blank(), tests: blank(), docs: blank() };
|
|
63
|
+
for (const [a, b] of stretches) {
|
|
64
|
+
if (a === b)
|
|
65
|
+
continue;
|
|
66
|
+
const stat = git(cwd, ["diff", "--numstat", a, b, "--", ".", ...LINES_EXCLUDE]);
|
|
67
|
+
if (stat === null)
|
|
68
|
+
return null;
|
|
69
|
+
for (const line of stat.split("\n").filter(Boolean)) {
|
|
70
|
+
const [added, deleted, file] = line.split("\t");
|
|
71
|
+
const c = parts[lineClass(file ?? "")];
|
|
72
|
+
c.files++;
|
|
73
|
+
// Binary files: `-` for both counts.
|
|
74
|
+
if (added !== "-") {
|
|
75
|
+
c.added += Number(added);
|
|
76
|
+
c.deleted += Number(deleted);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
const sum = (k) => parts.code[k] + parts.tests[k] + parts.docs[k];
|
|
81
|
+
const added = sum("added");
|
|
82
|
+
const deleted = sum("deleted");
|
|
83
|
+
return {
|
|
84
|
+
total: { added, deleted, changed: added + deleted, files: sum("files") },
|
|
85
|
+
...parts,
|
|
86
|
+
merges: stretches.length - 1,
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
/** The run's status rows of `workflow` from its start row on, in `at` order. */
|
|
90
|
+
export function runStatusRows(events, workflow, startAt) {
|
|
91
|
+
return events
|
|
92
|
+
.filter((e) => e.workflow === workflow && typeof e.at === "string" && e.at >= startAt)
|
|
93
|
+
.sort((a, b) => msOf(a.at) - msOf(b.at));
|
|
94
|
+
}
|
|
95
|
+
/** Per step: its step-done rows and the minutes since the row before each, `MARK_ROWS` skipped. */
|
|
96
|
+
export function stepsBlock(all) {
|
|
97
|
+
const rows = all.filter((r) => !MARK_ROWS.has(r.type));
|
|
98
|
+
const ms = {};
|
|
99
|
+
for (let i = 1; i < rows.length; i++) {
|
|
100
|
+
const r = rows[i];
|
|
101
|
+
if (r.type !== "step-done" || typeof r.step !== "string")
|
|
102
|
+
continue;
|
|
103
|
+
const s = (ms[r.step] ??= { n: 0, ms: 0 });
|
|
104
|
+
s.n++;
|
|
105
|
+
s.ms += Math.max(0, msOf(r.at) - msOf(rows[i - 1].at));
|
|
106
|
+
}
|
|
107
|
+
const byStep = Object.fromEntries(Object.entries(ms).map(([k, v]) => [k, { n: v.n, totalMinutes: minutesOf(v.ms) }]));
|
|
108
|
+
const parts = Object.values(byStep);
|
|
109
|
+
return {
|
|
110
|
+
total: {
|
|
111
|
+
n: parts.reduce((a, p) => a + p.n, 0),
|
|
112
|
+
totalMinutes: Math.round(parts.reduce((a, p) => a + p.totalMinutes, 0) * 10) / 10,
|
|
113
|
+
},
|
|
114
|
+
byStep,
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
/** Every close step's CI dispatch, in order. */
|
|
118
|
+
export function ciList(rows) {
|
|
119
|
+
return rows
|
|
120
|
+
.filter((r) => r.type === "step-done" && /-close-workflow$/.test(String(r.step ?? "")))
|
|
121
|
+
.map((r) => r.ciDispatch)
|
|
122
|
+
.filter((d) => d !== undefined && d !== null)
|
|
123
|
+
.map((d) => ciEntry(d));
|
|
124
|
+
}
|
|
125
|
+
/** One `ciDispatch` value as a `ci` entry. */
|
|
126
|
+
export function ciEntry(d) {
|
|
127
|
+
return {
|
|
128
|
+
status: typeof d.outcome === "string" ? d.outcome : null,
|
|
129
|
+
reason: typeof d.reason === "string" ? d.reason : null,
|
|
130
|
+
attempts: typeof d.attempts === "number" ? d.attempts : null,
|
|
131
|
+
};
|
|
132
|
+
}
|
|
133
|
+
const kbOf = (file) => Math.round(fs.statSync(file).size / 1024);
|
|
134
|
+
/**
|
|
135
|
+
* Per task group, per task: its TEST FIRST tests and distinct test files; null when the
|
|
136
|
+
* task has no such field.
|
|
137
|
+
*/
|
|
138
|
+
export function planTasks(text) {
|
|
139
|
+
return parsePlanBlocks(text).groups.map((g) => readTestFirst(text, g.group).map((s) => s.kind === "test"
|
|
140
|
+
? { tests: s.tests.length, testFiles: new Set(s.tests.map((t) => t.test)).size }
|
|
141
|
+
: s.kind === "missing"
|
|
142
|
+
? { tests: null, testFiles: null }
|
|
143
|
+
: { tests: 0, testFiles: 0 }));
|
|
144
|
+
}
|
|
145
|
+
/** The plan file the run worked from, absolute: `[{FID}-plan.md]`, [] when it does not exist. */
|
|
146
|
+
export function planFiles(tree, month, fid) {
|
|
147
|
+
const file = path.join(tree, "docs", "plans", month, `${fid}-plan.md`);
|
|
148
|
+
return fs.existsSync(file) ? [file] : [];
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* The plan the run worked from: `{FID}-plan.md`, its tasks per group. `source` is
|
|
152
|
+
* `converted` when the FID's status rows hold a `build-plan-convert` step row, else
|
|
153
|
+
* `file`. Undefined when no plan file exists.
|
|
154
|
+
*/
|
|
155
|
+
export function planBlock(tree, month, fid, events) {
|
|
156
|
+
const [file] = planFiles(tree, month, fid);
|
|
157
|
+
if (file === undefined)
|
|
158
|
+
return undefined;
|
|
159
|
+
const groups = planTasks(fs.readFileSync(file, "utf-8")).map((tasks) => ({ tasks }));
|
|
160
|
+
const converted = events.some((e) => e.type === "step-done" && e.workflow === "build" && e.step === "build-plan-convert");
|
|
161
|
+
return {
|
|
162
|
+
source: converted ? "converted" : "file",
|
|
163
|
+
total: { tasks: groups.reduce((a, g) => a + g.tasks.length, 0), kb: kbOf(file) },
|
|
164
|
+
groups,
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
/** A task `bkit challenge merge` appended: its severity field. Planned tasks carry none. */
|
|
168
|
+
const APPENDED_SEVERITY = /\*\*Severity:\*\*\s*(CRITICAL|HIGH|MEDIUM|LOW)\b/;
|
|
169
|
+
const field = (r, k) => (r[k] === undefined ? null : r[k]);
|
|
170
|
+
const num = (v) => (typeof v === "number" ? v : null);
|
|
171
|
+
const str = (v) => (typeof v === "string" ? v : null);
|
|
172
|
+
/**
|
|
173
|
+
* Build-only facts from the run's step rows and its log folder: every verify and
|
|
174
|
+
* gaps-remediate round, the holistic verify, the challenge and the groups' red runs.
|
|
175
|
+
* Challenge findings are counted once a `build-challenge` row
|
|
176
|
+
* exists: CRITICAL / HIGH / MEDIUM from the tasks `challenge merge` appended to
|
|
177
|
+
* `plans`, LOW from its `build-challenge` rows among `deferrals` (the run's rows). The
|
|
178
|
+
* challenge block carries the latest `challenge-gate` row's size as `gate`, when one exists.
|
|
179
|
+
*/
|
|
180
|
+
export function buildBlock(rows, plans, deferrals) {
|
|
181
|
+
const steps = rows.filter((r) => r.type === "step-done");
|
|
182
|
+
const verify = steps
|
|
183
|
+
.filter((r) => r.step === "build-plan-verify")
|
|
184
|
+
.map((r) => ({
|
|
185
|
+
group: field(r, "group"),
|
|
186
|
+
attempt: field(r, "attempt"),
|
|
187
|
+
verdict: field(r, "verdict"),
|
|
188
|
+
failures: field(r, "failures"),
|
|
189
|
+
}));
|
|
190
|
+
const gapsRemediate = steps
|
|
191
|
+
.filter((r) => r.step === "build-plan-gaps-remediate")
|
|
192
|
+
.map((r) => ({
|
|
193
|
+
group: field(r, "group"),
|
|
194
|
+
attempt: field(r, "attempt"),
|
|
195
|
+
verdict: field(r, "verdict"),
|
|
196
|
+
strategy: field(r, "strategy"),
|
|
197
|
+
}));
|
|
198
|
+
const lastOf = (step) => steps.filter((r) => r.step === step).at(-1);
|
|
199
|
+
const hol = lastOf("build-plan-verify-holistic");
|
|
200
|
+
const ch = lastOf("build-challenge");
|
|
201
|
+
// `challenge-gate` rows are not fold events: read them as plain status rows.
|
|
202
|
+
const gate = rows
|
|
203
|
+
.filter((r) => r.type === "challenge-gate")
|
|
204
|
+
.at(-1);
|
|
205
|
+
let findings = null;
|
|
206
|
+
if (ch !== undefined) {
|
|
207
|
+
const f = { CRITICAL: 0, HIGH: 0, MEDIUM: 0, LOW: 0 };
|
|
208
|
+
for (const file of plans.filter((p) => fs.existsSync(p)))
|
|
209
|
+
for (const t of parsePlanBlocks(fs.readFileSync(file, "utf-8")).tasks) {
|
|
210
|
+
const sev = APPENDED_SEVERITY.exec(t.text)?.[1];
|
|
211
|
+
if (sev !== undefined && sev !== "LOW")
|
|
212
|
+
f[sev]++;
|
|
213
|
+
}
|
|
214
|
+
f.LOW = new Set(deferrals
|
|
215
|
+
.filter((r) => r.kind === "deferral" &&
|
|
216
|
+
r.severity === "LOW" &&
|
|
217
|
+
r.by?.step === "build-challenge")
|
|
218
|
+
.map((r) => String(r.key))).size;
|
|
219
|
+
findings = { total: f.CRITICAL + f.HIGH + f.MEDIUM + f.LOW, ...f };
|
|
220
|
+
}
|
|
221
|
+
return {
|
|
222
|
+
verify,
|
|
223
|
+
gapsRemediate,
|
|
224
|
+
holistic: hol ? { verdict: str(hol.verdict), failures: num(hol.failures) } : null,
|
|
225
|
+
challenge: ch
|
|
226
|
+
? {
|
|
227
|
+
verdict: str(ch.verdict),
|
|
228
|
+
findings,
|
|
229
|
+
...(gate === undefined
|
|
230
|
+
? {}
|
|
231
|
+
: {
|
|
232
|
+
gate: {
|
|
233
|
+
size: str(gate.size),
|
|
234
|
+
linesChanged: num(gate.linesChanged),
|
|
235
|
+
filesChanged: num(gate.filesChanged),
|
|
236
|
+
skipped: gate.skipped === true,
|
|
237
|
+
},
|
|
238
|
+
}),
|
|
239
|
+
}
|
|
240
|
+
: null,
|
|
241
|
+
redTests: steps.filter((r) => r.step === "build-tests-red").length,
|
|
242
|
+
};
|
|
243
|
+
}
|
|
244
|
+
/**
|
|
245
|
+
* Claude Code sets `CLAUDE_CODE_SESSION_ID` in the environment of every shell command its
|
|
246
|
+
* session runs, so `bkit workflows close` (run by the workflow's own session) knows whose
|
|
247
|
+
* transcripts hold the run's subagents.
|
|
248
|
+
*/
|
|
249
|
+
export function claudeTranscripts(env, home) {
|
|
250
|
+
return {
|
|
251
|
+
sessionId: env.CLAUDE_CODE_SESSION_ID,
|
|
252
|
+
claudeDir: env.CLAUDE_CONFIG_DIR || path.join(home, ".claude"),
|
|
253
|
+
};
|
|
254
|
+
}
|
|
255
|
+
const SESSION_ID = /^[0-9A-Za-z][0-9A-Za-z_-]*$/;
|
|
256
|
+
/**
|
|
257
|
+
* The chat a host runs this command in, or undefined when the host names none. Claude Code
|
|
258
|
+
* only: it sets `CLAUDE_CODE_SESSION_ID`; nothing in this repo confirms a variable naming the
|
|
259
|
+
* chat on Codex, opencode, Cursor or Antigravity.
|
|
260
|
+
*/
|
|
261
|
+
export function hostChat(env) {
|
|
262
|
+
const id = env.CLAUDE_CODE_SESSION_ID;
|
|
263
|
+
return id !== undefined && SESSION_ID.test(id) ? { platform: "claude-code", id } : undefined;
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* A chat's fingerprint on `session` status rows: `fp:` + the first 12 hex of
|
|
267
|
+
* sha256(`<platform>:<chat id>`), the same as the harvest's fingerprint of its `chat` row key.
|
|
268
|
+
*/
|
|
269
|
+
export const chatFingerprint = (platform, id) => `fp:${createHash("sha256").update(`${platform}:${id}`).digest("hex").slice(0, 12)}`;
|
|
270
|
+
/**
|
|
271
|
+
* Status rows that mark a moment rather than the end of a piece of work: step minutes skip
|
|
272
|
+
* them. A `test-run` row lands just before its step's own row, so the run counts toward it.
|
|
273
|
+
*/
|
|
274
|
+
export const MARK_ROWS = new Set([
|
|
275
|
+
"session",
|
|
276
|
+
"owner-pause",
|
|
277
|
+
"owner-answer",
|
|
278
|
+
"test-run",
|
|
279
|
+
"engine-call",
|
|
280
|
+
"completeness",
|
|
281
|
+
]);
|
|
282
|
+
/** The `session` fingerprints on the run's status rows, in row order, each once. */
|
|
283
|
+
export function runChats(rows) {
|
|
284
|
+
const out = [];
|
|
285
|
+
for (const r of rows)
|
|
286
|
+
if (r.type === "session" && typeof r.session === "string" && !out.includes(r.session))
|
|
287
|
+
out.push(r.session);
|
|
288
|
+
return out;
|
|
289
|
+
}
|
|
290
|
+
/** One Claude Code subagent transcript's model calls: `[ms, context]` each, or null when unreadable. */
|
|
291
|
+
function subagentCalls(file) {
|
|
292
|
+
const read = readTextFile(file);
|
|
293
|
+
if (!read.ok)
|
|
294
|
+
return null;
|
|
295
|
+
const calls = [];
|
|
296
|
+
for (const line of read.text.split("\n")) {
|
|
297
|
+
const parsed = line.trim() === "" ? null : parseJson(line);
|
|
298
|
+
if (parsed === null || !parsed.ok)
|
|
299
|
+
continue;
|
|
300
|
+
const d = parsed.value;
|
|
301
|
+
if (d === null || typeof d !== "object")
|
|
302
|
+
continue;
|
|
303
|
+
const m = d.message;
|
|
304
|
+
// `<synthetic>`: a message Claude Code wrote itself (an API error notice), not a model call.
|
|
305
|
+
if (d.type !== "assistant" || typeof m !== "object" || m === null)
|
|
306
|
+
continue;
|
|
307
|
+
if (m.model === "<synthetic>")
|
|
308
|
+
continue;
|
|
309
|
+
const at = msOf(d.timestamp);
|
|
310
|
+
if (!Number.isFinite(at))
|
|
311
|
+
continue;
|
|
312
|
+
const u = (m.usage ?? {});
|
|
313
|
+
const n = (k) => (typeof u[k] === "number" ? u[k] : 0);
|
|
314
|
+
calls.push([
|
|
315
|
+
at,
|
|
316
|
+
n("input_tokens") + n("cache_creation_input_tokens") + n("cache_read_input_tokens"),
|
|
317
|
+
]);
|
|
318
|
+
}
|
|
319
|
+
return calls;
|
|
320
|
+
}
|
|
321
|
+
/**
|
|
322
|
+
* The run's subagents' context peaks per agent type, from every Claude Code chat that ran
|
|
323
|
+
* it: the chat running the close, and each chat whose fingerprint `chats` holds (the run's
|
|
324
|
+
* `session` rows). Transcripts: `<claudeDir>/projects/<project>/<session>/subagents/agent-*.jsonl`,
|
|
325
|
+
* each with its `agent-*.meta.json` naming the agent type (`unknown` without one). Each model
|
|
326
|
+
* call goes by its own timestamp: a subagent counts in `runs` when one of its calls falls in
|
|
327
|
+
* [startMs, endMs], and `peak` is the largest of those calls. Context of one model call =
|
|
328
|
+
* input + cache write + cache read tokens, the same sum the harvest's `contextPeak` takes.
|
|
329
|
+
* Undefined when no chat is known, no transcript is found or no subagent called the model
|
|
330
|
+
* in the run. Never throws: a folder or transcript that cannot be read counts as absent.
|
|
331
|
+
*
|
|
332
|
+
* Claude Code only. The other hosts bkit renders for record nothing here:
|
|
333
|
+
* - Cursor keeps no token counts in its local chats (the harvest reads them and finds none).
|
|
334
|
+
* - Codex (`~/.codex/sessions/.../rollout-*.jsonl`, `token_count` events) and opencode
|
|
335
|
+
* (`~/.local/share/opencode/opencode.db`) keep token counts, but nothing in this repo
|
|
336
|
+
* confirms an environment variable naming the running session, so a close cannot tell its
|
|
337
|
+
* own run's transcripts from another chat's.
|
|
338
|
+
* - Antigravity keeps protobuf in SQLite whose token fields nothing in this repo documents.
|
|
339
|
+
*/
|
|
340
|
+
export function agentContextBlock(startMs, endMs, src, chats = []) {
|
|
341
|
+
const sid = src.sessionId !== undefined && SESSION_ID.test(src.sessionId) ? src.sessionId : null;
|
|
342
|
+
const wanted = new Set(chats);
|
|
343
|
+
if (sid === null && wanted.size === 0)
|
|
344
|
+
return undefined;
|
|
345
|
+
const projects = path.join(src.claudeDir, "projects");
|
|
346
|
+
const top = readDirNames(projects);
|
|
347
|
+
if (!top.ok)
|
|
348
|
+
return undefined;
|
|
349
|
+
const files = [];
|
|
350
|
+
for (const p of top.names.sort()) {
|
|
351
|
+
const names = readDirNames(path.join(projects, p));
|
|
352
|
+
for (const name of names.ok ? names.names.sort() : []) {
|
|
353
|
+
if (!SESSION_ID.test(name))
|
|
354
|
+
continue;
|
|
355
|
+
if (name !== sid && !wanted.has(chatFingerprint("claude-code", name)))
|
|
356
|
+
continue;
|
|
357
|
+
const dir = path.join(projects, p, name, "subagents");
|
|
358
|
+
const subs = readDirNames(dir);
|
|
359
|
+
for (const f of subs.ok ? subs.names.sort() : [])
|
|
360
|
+
if (f.endsWith(".jsonl"))
|
|
361
|
+
files.push(path.join(dir, f));
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
const byAgent = {};
|
|
365
|
+
for (const file of files) {
|
|
366
|
+
const inRun = (subagentCalls(file) ?? []).filter(([at]) => at >= startMs && at <= endMs);
|
|
367
|
+
if (inRun.length === 0)
|
|
368
|
+
continue;
|
|
369
|
+
const meta = readJsonFile(file.slice(0, -".jsonl".length) + ".meta.json");
|
|
370
|
+
const type = meta.ok ? meta.value?.agentType : undefined;
|
|
371
|
+
const a = (byAgent[typeof type === "string" && type !== "" ? type : "unknown"] ??= {
|
|
372
|
+
peak: 0,
|
|
373
|
+
runs: 0,
|
|
374
|
+
});
|
|
375
|
+
a.runs++;
|
|
376
|
+
a.peak = Math.max(a.peak, ...inRun.map(([, c]) => c));
|
|
377
|
+
}
|
|
378
|
+
return Object.keys(byAgent).length === 0 ? undefined : { host: "claude-code", byAgent };
|
|
379
|
+
}
|
|
380
|
+
/**
|
|
381
|
+
* After the close's CI dispatch: append the run's `outcome` row again with the
|
|
382
|
+
* dispatch added to `ci`, and `ending` `close-failed` when CI never started
|
|
383
|
+
* (`unresolved`). The run is the last `workflow-done` row of `workflow` in
|
|
384
|
+
* `status`; its `parentSha` names the outcome row. The newer row supersedes the
|
|
385
|
+
* close's under fold. Best-effort: a missing row or a refused append is logged.
|
|
386
|
+
*/
|
|
387
|
+
export function restateOutcome(tree, status, workflow, dispatch, log) {
|
|
388
|
+
const done = readStatusEvents(status)
|
|
389
|
+
.filter((e) => e.type === "workflow-done" && e.workflow === workflow)
|
|
390
|
+
.sort((a, b) => (a.at < b.at ? -1 : a.at > b.at ? 1 : 0))
|
|
391
|
+
.at(-1);
|
|
392
|
+
const sha = done?.parentSha;
|
|
393
|
+
if (typeof sha !== "string") {
|
|
394
|
+
log(`[bkit-telemetry] no ${workflow} workflow-done row with parentSha — outcome not restated`);
|
|
395
|
+
return false;
|
|
396
|
+
}
|
|
397
|
+
const stats = path.join(tree, ".bkit", "stats.jsonl");
|
|
398
|
+
const outcome = fs.existsSync(stats)
|
|
399
|
+
? [...foldFrom([stats]).state.values()]
|
|
400
|
+
.filter((e) => e.kind === "outcome" && e.by?.workflow === workflow && e.run?.parentSha === sha)
|
|
401
|
+
.at(-1)
|
|
402
|
+
: undefined;
|
|
403
|
+
if (outcome === undefined) {
|
|
404
|
+
log(`[bkit-telemetry] no ${workflow} outcome row for ${sha.slice(0, 12)} — outcome not restated`);
|
|
405
|
+
return false;
|
|
406
|
+
}
|
|
407
|
+
const { schema: _s, ts: _t, bkit: _b, ...draft } = outcome;
|
|
408
|
+
const entry = ciEntry(dispatch);
|
|
409
|
+
const ci = [...(draft.ci ?? []), entry];
|
|
410
|
+
try {
|
|
411
|
+
appendLedgerRows(tree, "stats", [
|
|
412
|
+
{ ...draft, ending: entry.status === "unresolved" ? "close-failed" : "done", ci },
|
|
413
|
+
]);
|
|
414
|
+
return true;
|
|
415
|
+
}
|
|
416
|
+
catch (err) {
|
|
417
|
+
// Telemetry never gates a dispatch: report the refused append and carry on.
|
|
418
|
+
log(`[bkit-telemetry] outcome not restated: ${err.message}`);
|
|
419
|
+
return false;
|
|
420
|
+
}
|
|
421
|
+
}
|