@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
|
@@ -1,57 +1,109 @@
|
|
|
1
|
-
// commands/analysis.ts —
|
|
1
|
+
// commands/analysis.ts — the computations behind `bkit stats` (commands/stats.ts) and the
|
|
2
|
+
// cross-repo section of the harvest report (scripts/harvest/, bkit's checkout only).
|
|
2
3
|
//
|
|
3
4
|
// Provides:
|
|
4
5
|
// 1. Counts/rates/elapsed-time over telemetry rows.
|
|
5
|
-
// 2. Size↔outcome regression (
|
|
6
|
-
//
|
|
7
|
-
// 3. Dispatch-size threshold computation
|
|
8
|
-
// 4. `
|
|
9
|
-
// (model-self-report
|
|
6
|
+
// 2. Size↔outcome regression (error rate per `lines.total.added` bucket) over
|
|
7
|
+
// `kind:"outcome"` rows.
|
|
8
|
+
// 3. Dispatch-size threshold computation, printed by `bkit stats` and the harvest report.
|
|
9
|
+
// 4. `counter.source` trust labelling: each outcome row is joined to its `counter` row
|
|
10
|
+
// (model-self-report or shell-bus).
|
|
10
11
|
// 5. Per-rule compliance rate over `kind:"compliance"` rows.
|
|
11
|
-
// 6. Per-`
|
|
12
|
+
// 6. Per-`bkit.version` release-attributed regression.
|
|
12
13
|
//
|
|
13
|
-
//
|
|
14
|
-
//
|
|
15
|
-
//
|
|
14
|
+
// Rows are read folded, so rows written without `schema` arrive in the current shape.
|
|
15
|
+
//
|
|
16
|
+
// Every figure built from `outcome`, `counter` or `compliance` rows is computed twice: once over
|
|
17
|
+
// the rows workflow closes wrote, once over the rows a direct chat wrote (`by.workflow`
|
|
18
|
+
// `utility`). No figure adds the two together.
|
|
16
19
|
//
|
|
17
20
|
// All computation is advisory + inform-only; never gates any workflow.
|
|
18
21
|
// See DE-34 for the shared-entrypoint + crash-isolation contract.
|
|
19
|
-
import
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
22
|
+
import { AGENT_CONTEXT_CAP, UNJUSTIFIED_REASON, foldFrom, } from "../ledgers/telemetry.js";
|
|
23
|
+
// ---------------------------------------------------------------------------
|
|
24
|
+
// Counts / rates summary
|
|
25
|
+
// ---------------------------------------------------------------------------
|
|
26
|
+
/** `by.workflow` of a row a direct chat wrote, outside any workflow run. */
|
|
27
|
+
export const UTILITY_WORKFLOW = "utility";
|
|
28
|
+
export const ROW_SOURCES = ["workflow", "utility"];
|
|
29
|
+
export function rowSource(row) {
|
|
30
|
+
return row.by?.workflow === UTILITY_WORKFLOW ? "utility" : "workflow";
|
|
31
|
+
}
|
|
23
32
|
export function computeCounts(events) {
|
|
24
33
|
const byKind = {};
|
|
25
34
|
const byWorkflow = {};
|
|
26
35
|
const byRepo = {};
|
|
27
36
|
for (const ev of events) {
|
|
28
|
-
byKind[ev.kind]
|
|
29
|
-
|
|
37
|
+
(byKind[ev.kind] ??= { workflow: 0, utility: 0 })[rowSource(ev)]++;
|
|
38
|
+
const workflow = ev.by?.workflow ?? "unknown";
|
|
39
|
+
byWorkflow[workflow] = (byWorkflow[workflow] ?? 0) + 1;
|
|
30
40
|
byRepo[ev.repo] = (byRepo[ev.repo] ?? 0) + 1;
|
|
31
41
|
}
|
|
32
42
|
return { total: events.length, byKind, byWorkflow, byRepo };
|
|
33
43
|
}
|
|
44
|
+
/** Over the rows that carry `time.totalMinutes`. */
|
|
34
45
|
export function computeElapsedStats(rows) {
|
|
35
|
-
|
|
46
|
+
const durations = rows
|
|
47
|
+
.map((r) => r.time?.totalMinutes)
|
|
48
|
+
.filter((m) => typeof m === "number")
|
|
49
|
+
.sort((a, b) => a - b);
|
|
50
|
+
if (durations.length === 0) {
|
|
36
51
|
return {
|
|
37
52
|
count: 0,
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
53
|
+
totalMinutes: 0,
|
|
54
|
+
meanMinutes: 0,
|
|
55
|
+
minMinutes: 0,
|
|
56
|
+
maxMinutes: 0,
|
|
57
|
+
p50Minutes: 0,
|
|
43
58
|
};
|
|
44
59
|
}
|
|
45
|
-
const durations = rows.map((r) => r.durationSeconds).sort((a, b) => a - b);
|
|
46
60
|
const total = durations.reduce((s, v) => s + v, 0);
|
|
47
|
-
const p50 = durations[Math.floor(durations.length / 2)] ?? 0;
|
|
48
61
|
return {
|
|
49
|
-
count:
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
62
|
+
count: durations.length,
|
|
63
|
+
totalMinutes: total,
|
|
64
|
+
meanMinutes: total / durations.length,
|
|
65
|
+
minMinutes: durations[0] ?? 0,
|
|
66
|
+
maxMinutes: durations[durations.length - 1] ?? 0,
|
|
67
|
+
p50Minutes: durations[Math.floor(durations.length / 2)] ?? 0,
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
/** Over the outcome rows whose `build.challenge.gate` is set. */
|
|
71
|
+
export function computeChallengeGate(rows) {
|
|
72
|
+
const out = { runs: 0, small: 0, large: 0 };
|
|
73
|
+
for (const r of rows) {
|
|
74
|
+
const gate = r.build?.challenge?.gate;
|
|
75
|
+
if (gate === undefined)
|
|
76
|
+
continue;
|
|
77
|
+
out.runs++;
|
|
78
|
+
if (gate.skipped)
|
|
79
|
+
out.small++;
|
|
80
|
+
else
|
|
81
|
+
out.large++;
|
|
82
|
+
}
|
|
83
|
+
return out;
|
|
84
|
+
}
|
|
85
|
+
/** Each agent type's context peak over the outcome rows' `context` blocks, against `cap`. */
|
|
86
|
+
export function computeAgentContext(rows, cap = AGENT_CONTEXT_CAP) {
|
|
87
|
+
const by = {};
|
|
88
|
+
let recorded = 0;
|
|
89
|
+
for (const r of rows) {
|
|
90
|
+
if (r.context === undefined)
|
|
91
|
+
continue;
|
|
92
|
+
recorded++;
|
|
93
|
+
for (const [agent, a] of Object.entries(r.context.byAgent)) {
|
|
94
|
+
const e = (by[agent] ??= { agent, subagents: 0, runs: 0, peak: 0, overCap: 0 });
|
|
95
|
+
e.subagents += a.runs;
|
|
96
|
+
e.runs++;
|
|
97
|
+
e.peak = Math.max(e.peak, a.peak);
|
|
98
|
+
if (a.peak > cap)
|
|
99
|
+
e.overCap++;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
return {
|
|
103
|
+
cap,
|
|
104
|
+
outcomes: rows.length,
|
|
105
|
+
recorded,
|
|
106
|
+
byAgent: Object.values(by).sort((a, b) => b.peak - a.peak || a.agent.localeCompare(b.agent)),
|
|
55
107
|
};
|
|
56
108
|
}
|
|
57
109
|
const SIZE_BUCKETS = [
|
|
@@ -64,7 +116,7 @@ const SIZE_BUCKETS = [
|
|
|
64
116
|
/**
|
|
65
117
|
* Per-run NEW failures = this row's cumulative total minus the previous row's.
|
|
66
118
|
*
|
|
67
|
-
* `
|
|
119
|
+
* `ledgers.failures.repo` is the repo's CUMULATIVE distinct-failure count at close.
|
|
68
120
|
*
|
|
69
121
|
* Previous = the newest outcome row for the SAME repo strictly before this one; the
|
|
70
122
|
* first row for a repo has no predecessor, so its total IS its delta.
|
|
@@ -75,25 +127,22 @@ export function newFailuresThisRun(row, allRows) {
|
|
|
75
127
|
const previous = allRows
|
|
76
128
|
.filter((r) => r.repo === row.repo && r.ts < row.ts)
|
|
77
129
|
.sort((a, b) => b.ts - a.ts)[0];
|
|
130
|
+
const failures = (r) => r.ledgers?.failures?.repo ?? 0;
|
|
78
131
|
if (!previous)
|
|
79
|
-
return row
|
|
80
|
-
return Math.max(0, row
|
|
81
|
-
}
|
|
82
|
-
function isErrorRun(row, allRows) {
|
|
83
|
-
return ((row.ciTrySuccess !== undefined && row.ciTrySuccess > 1) ||
|
|
84
|
-
(row.correctiveCommits !== undefined && row.correctiveCommits > 0) ||
|
|
85
|
-
(row.reviewIterations !== undefined && row.reviewIterations > 1) ||
|
|
86
|
-
newFailuresThisRun(row, allRows) > 0);
|
|
132
|
+
return failures(row);
|
|
133
|
+
return Math.max(0, failures(row) - failures(previous));
|
|
87
134
|
}
|
|
135
|
+
const isErrorRun = (row, allRows) => newFailuresThisRun(row, allRows) > 0;
|
|
88
136
|
/** Identity of one workflow run: the key the close writes on both its counter and outcome rows. */
|
|
89
137
|
function runKey(row) {
|
|
90
|
-
|
|
138
|
+
const sha = row.run?.parentSha;
|
|
139
|
+
return sha ? JSON.stringify([row.repo, row.by?.workflow, sha]) : undefined;
|
|
91
140
|
}
|
|
92
141
|
export function computeRegression(rows, counterRows) {
|
|
93
142
|
const shellBusRuns = new Set();
|
|
94
143
|
for (const c of counterRows) {
|
|
95
144
|
const key = runKey(c);
|
|
96
|
-
if (c.
|
|
145
|
+
if (c.counter?.source === "shell-bus" && key !== undefined)
|
|
97
146
|
shellBusRuns.add(key);
|
|
98
147
|
}
|
|
99
148
|
const buckets = SIZE_BUCKETS.map((b) => ({
|
|
@@ -115,8 +164,8 @@ export function computeRegression(rows, counterRows) {
|
|
|
115
164
|
else {
|
|
116
165
|
modelSelfReportCount++;
|
|
117
166
|
}
|
|
118
|
-
// Bucket by
|
|
119
|
-
const lines = row.
|
|
167
|
+
// Bucket by lines added
|
|
168
|
+
const lines = row.lines?.total?.added ?? 0;
|
|
120
169
|
for (const bucket of buckets) {
|
|
121
170
|
if (lines >= bucket.minLines && lines <= bucket.maxLines) {
|
|
122
171
|
bucket.count++;
|
|
@@ -150,14 +199,15 @@ export function computeRegression(rows, counterRows) {
|
|
|
150
199
|
export function computeComplianceRates(rows) {
|
|
151
200
|
const byRule = {};
|
|
152
201
|
for (const row of rows) {
|
|
153
|
-
|
|
154
|
-
|
|
202
|
+
const id = row.rule?.id ?? "unknown";
|
|
203
|
+
if (!byRule[id]) {
|
|
204
|
+
byRule[id] = { passCount: 0, failCount: 0, naCount: 0, totalCount: 0 };
|
|
155
205
|
}
|
|
156
|
-
const r = byRule[
|
|
206
|
+
const r = byRule[id];
|
|
157
207
|
r.totalCount++;
|
|
158
|
-
if (row.
|
|
208
|
+
if (row.rule?.verdict === "pass")
|
|
159
209
|
r.passCount++;
|
|
160
|
-
else if (row.
|
|
210
|
+
else if (row.rule?.verdict === "fail")
|
|
161
211
|
r.failCount++;
|
|
162
212
|
else
|
|
163
213
|
r.naCount++;
|
|
@@ -171,20 +221,21 @@ export function computeComplianceRates(rows) {
|
|
|
171
221
|
export function computeVersionCompliance(rows) {
|
|
172
222
|
const byVersion = {};
|
|
173
223
|
for (const row of rows) {
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
224
|
+
const version = row.bkit?.version ?? "unknown";
|
|
225
|
+
if (!byVersion[version])
|
|
226
|
+
byVersion[version] = { pass: 0, total: 0 };
|
|
227
|
+
const v = byVersion[version];
|
|
177
228
|
v.total++;
|
|
178
|
-
if (row.
|
|
229
|
+
if (row.rule?.verdict === "pass")
|
|
179
230
|
v.pass++;
|
|
180
231
|
}
|
|
181
232
|
return Object.entries(byVersion)
|
|
182
|
-
.map(([
|
|
183
|
-
|
|
233
|
+
.map(([version, { pass, total }]) => ({
|
|
234
|
+
version,
|
|
184
235
|
passRate: total > 0 ? pass / total : 0,
|
|
185
236
|
totalRuns: total,
|
|
186
237
|
}))
|
|
187
|
-
.sort((a, b) => a.
|
|
238
|
+
.sort((a, b) => a.version.localeCompare(b.version, undefined, { numeric: true }));
|
|
188
239
|
}
|
|
189
240
|
/**
|
|
190
241
|
* Unjustified-rate per `(subagent, model)`.
|
|
@@ -196,8 +247,8 @@ export function computeVersionCompliance(rows) {
|
|
|
196
247
|
export function computeDeferralDiscipline(rows) {
|
|
197
248
|
const byWriter = {};
|
|
198
249
|
for (const row of rows) {
|
|
199
|
-
const writer = row.subagent ?? (row.workflow ? `${row.workflow} (orchestrator)` : "unattributed");
|
|
200
|
-
const model = row.model ?? "unknown";
|
|
250
|
+
const writer = row.by?.subagent ?? (row.by?.workflow ? `${row.by.workflow} (orchestrator)` : "unattributed");
|
|
251
|
+
const model = row.by?.model ?? "unknown";
|
|
201
252
|
const id = `${writer}\u0000${model}`;
|
|
202
253
|
if (!byWriter[id])
|
|
203
254
|
byWriter[id] = { writer, model, total: 0, unjustifiedCount: 0, byReason: {} };
|
|
@@ -222,64 +273,91 @@ export function computeDeferralDiscipline(rows) {
|
|
|
222
273
|
b.total - a.total ||
|
|
223
274
|
a.writer.localeCompare(b.writer));
|
|
224
275
|
}
|
|
225
|
-
export function
|
|
276
|
+
export function computeRunFigures(outcomeRows, counterRows, complianceRows) {
|
|
277
|
+
return {
|
|
278
|
+
outcomes: outcomeRows.length,
|
|
279
|
+
compliance: complianceRows.length,
|
|
280
|
+
elapsed: computeElapsedStats(outcomeRows),
|
|
281
|
+
regression: computeRegression(outcomeRows, counterRows),
|
|
282
|
+
complianceRates: computeComplianceRates(complianceRows),
|
|
283
|
+
versionCompliance: computeVersionCompliance(complianceRows),
|
|
284
|
+
challengeGate: computeChallengeGate(outcomeRows),
|
|
285
|
+
agentContext: computeAgentContext(outcomeRows),
|
|
286
|
+
};
|
|
287
|
+
}
|
|
288
|
+
function runFigureLines(label, f) {
|
|
289
|
+
const p = `[bkit-analysis] [${label}]`;
|
|
290
|
+
const lines = [`${p} Run outcomes: ${f.outcomes} | Compliance rows: ${f.compliance}`];
|
|
291
|
+
const { elapsed, regression, challengeGate, complianceRates, versionCompliance } = f;
|
|
292
|
+
if (elapsed.count > 0) {
|
|
293
|
+
lines.push(`${p} Duration (min): mean=${elapsed.meanMinutes.toFixed(1)} | p50=${elapsed.p50Minutes.toFixed(1)} | min=${elapsed.minMinutes} | max=${elapsed.maxMinutes}`);
|
|
294
|
+
}
|
|
295
|
+
lines.push(`${p} #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`);
|
|
296
|
+
for (const b of regression.buckets) {
|
|
297
|
+
if (b.count > 0) {
|
|
298
|
+
lines.push(` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`);
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
lines.push(`${p} counter.source trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted)`);
|
|
302
|
+
if (challengeGate.runs > 0) {
|
|
303
|
+
lines.push(`${p} Build challenge size: ${challengeGate.small} small (challenge-1 skipped) | ${challengeGate.large} large, of ${challengeGate.runs} runs`);
|
|
304
|
+
}
|
|
305
|
+
if (complianceRates.length > 0) {
|
|
306
|
+
lines.push(`${p} Per-rule compliance rates:`);
|
|
307
|
+
for (const r of complianceRates) {
|
|
308
|
+
lines.push(` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`);
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
if (versionCompliance.length > 0) {
|
|
312
|
+
lines.push(`${p} Per-bkit.version compliance:`);
|
|
313
|
+
for (const v of versionCompliance) {
|
|
314
|
+
lines.push(` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
return lines;
|
|
318
|
+
}
|
|
319
|
+
/** Analyse the folded rows of `paths`, leaving out rows of `skipKinds`. */
|
|
320
|
+
export function runAnalysis(paths, skipKinds = new Set()) {
|
|
226
321
|
const { state, rowCount, malformedLineCount } = foldFrom(paths);
|
|
227
|
-
const events = [...state.values()];
|
|
228
|
-
const
|
|
229
|
-
|
|
230
|
-
|
|
322
|
+
const events = [...state.values()].filter((ev) => !skipKinds.has(ev.kind));
|
|
323
|
+
const grouped = () => ({
|
|
324
|
+
outcome: [],
|
|
325
|
+
counter: [],
|
|
326
|
+
compliance: [],
|
|
327
|
+
});
|
|
328
|
+
const bySource = {
|
|
329
|
+
workflow: grouped(),
|
|
330
|
+
utility: grouped(),
|
|
331
|
+
};
|
|
231
332
|
const deferralRows = [];
|
|
232
333
|
for (const ev of events) {
|
|
334
|
+
const g = bySource[rowSource(ev)];
|
|
233
335
|
if (ev.kind === "outcome") {
|
|
234
|
-
|
|
336
|
+
g.outcome.push(ev);
|
|
235
337
|
}
|
|
236
338
|
else if (ev.kind === "counter") {
|
|
237
|
-
|
|
339
|
+
g.counter.push(ev);
|
|
238
340
|
}
|
|
239
341
|
else if (ev.kind === "compliance") {
|
|
240
|
-
|
|
342
|
+
g.compliance.push(ev);
|
|
241
343
|
}
|
|
242
344
|
else if (ev.kind === "deferral") {
|
|
243
345
|
deferralRows.push(ev);
|
|
244
346
|
}
|
|
245
347
|
}
|
|
246
348
|
const counts = computeCounts(events);
|
|
247
|
-
const
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
349
|
+
const runs = {
|
|
350
|
+
workflow: computeRunFigures(bySource.workflow.outcome, bySource.workflow.counter, bySource.workflow.compliance),
|
|
351
|
+
utility: computeRunFigures(bySource.utility.outcome, bySource.utility.counter, bySource.utility.compliance),
|
|
352
|
+
};
|
|
251
353
|
const deferralDiscipline = computeDeferralDiscipline(deferralRows);
|
|
252
354
|
const reportLines = [
|
|
253
355
|
`[bkit-analysis] Telemetry rows: ${rowCount} | malformed: ${malformedLineCount}`,
|
|
254
356
|
`[bkit-analysis] Kinds: ${JSON.stringify(counts.byKind)}`,
|
|
255
357
|
`[bkit-analysis] Workflows: ${JSON.stringify(counts.byWorkflow)}`,
|
|
256
|
-
|
|
358
|
+
...runFigureLines("workflow", runs.workflow),
|
|
359
|
+
...runFigureLines(UTILITY_WORKFLOW, runs.utility),
|
|
257
360
|
];
|
|
258
|
-
if (elapsed.count > 0) {
|
|
259
|
-
reportLines.push(`[bkit-analysis] Duration (s): mean=${elapsed.meanSeconds.toFixed(0)} | p50=${elapsed.p50Seconds.toFixed(0)} | min=${elapsed.minSeconds} | max=${elapsed.maxSeconds}`);
|
|
260
|
-
}
|
|
261
|
-
// Regression report
|
|
262
|
-
reportLines.push(`[bkit-analysis] #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} linesAdded):`);
|
|
263
|
-
for (const b of regression.buckets) {
|
|
264
|
-
if (b.count > 0) {
|
|
265
|
-
reportLines.push(` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`);
|
|
266
|
-
}
|
|
267
|
-
}
|
|
268
|
-
reportLines.push(`[bkit-analysis] counterSource trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted, pre-P3)`);
|
|
269
|
-
// Compliance rates
|
|
270
|
-
if (complianceRates.length > 0) {
|
|
271
|
-
reportLines.push(`[bkit-analysis] Per-rule compliance rates:`);
|
|
272
|
-
for (const r of complianceRates) {
|
|
273
|
-
reportLines.push(` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`);
|
|
274
|
-
}
|
|
275
|
-
}
|
|
276
|
-
// Version compliance
|
|
277
|
-
if (versionCompliance.length > 0) {
|
|
278
|
-
reportLines.push(`[bkit-analysis] Per-bkitVersion compliance:`);
|
|
279
|
-
for (const v of versionCompliance) {
|
|
280
|
-
reportLines.push(` v${v.bkitVersion}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
|
|
281
|
-
}
|
|
282
|
-
}
|
|
283
361
|
// Deferral discipline — who defers work they should have finished.
|
|
284
362
|
if (deferralDiscipline.length > 0) {
|
|
285
363
|
const totals = deferralDiscipline.reduce((acc, d) => ({ total: acc.total + d.total, unjust: acc.unjust + d.unjustifiedCount }), { total: 0, unjust: 0 });
|
|
@@ -292,50 +370,5 @@ export function runAnalysis(paths) {
|
|
|
292
370
|
reportLines.push(` ${d.writer} [${d.model}]: ${d.unjustifiedCount}/${d.total} unjustified (${(d.unjustifiedRate * 100).toFixed(1)}%) | ${reasons}`);
|
|
293
371
|
}
|
|
294
372
|
}
|
|
295
|
-
return {
|
|
296
|
-
counts,
|
|
297
|
-
elapsed,
|
|
298
|
-
regression,
|
|
299
|
-
complianceRates,
|
|
300
|
-
versionCompliance,
|
|
301
|
-
deferralDiscipline,
|
|
302
|
-
reportLines,
|
|
303
|
-
};
|
|
304
|
-
}
|
|
305
|
-
// analysis — cross-repo analysis CLI.
|
|
306
|
-
// Reports counts/rates/elapsed-time, size↔outcome regression, per-rule compliance
|
|
307
|
-
// rate, dispatch-size threshold, counterSource trust labelling. Advisory + inform-only.
|
|
308
|
-
// See DE-34 for the shared-entrypoint + crash-isolation contract.
|
|
309
|
-
export function runAnalysisCommand() {
|
|
310
|
-
try {
|
|
311
|
-
const cwd = process.cwd();
|
|
312
|
-
// Analyse: bkit's own stats.jsonl + harvested consumer rows.
|
|
313
|
-
// Harvest dest is sourced from the constant, NOT re-spelled here.
|
|
314
|
-
const statsPath = path.join(cwd, ".bkit", "stats.jsonl");
|
|
315
|
-
const harvestStatsPath = path.join(cwd, HARVEST_DEST_DIR, "stats.jsonl");
|
|
316
|
-
const harvestFrictionPath = path.join(cwd, HARVEST_DEST_DIR, "friction.jsonl");
|
|
317
|
-
const frictionPath = path.join(cwd, ".bkit", "friction.jsonl");
|
|
318
|
-
// deferrals is LOCAL-only: harvest takes it count-only (prose never leaves the
|
|
319
|
-
// consumer), so the discipline rate is this repo's own writers, not a fleet view.
|
|
320
|
-
const deferralsPath = path.join(cwd, "docs", "deferrals.jsonl");
|
|
321
|
-
const paths = [
|
|
322
|
-
statsPath,
|
|
323
|
-
harvestStatsPath,
|
|
324
|
-
harvestFrictionPath,
|
|
325
|
-
frictionPath,
|
|
326
|
-
deferralsPath,
|
|
327
|
-
].filter((p) => fs.existsSync(p));
|
|
328
|
-
if (paths.length === 0) {
|
|
329
|
-
console.log("[bkit-analysis] No telemetry files found. Run `bkit harvest` first, or accumulate telemetry via bkit workflows.");
|
|
330
|
-
return;
|
|
331
|
-
}
|
|
332
|
-
const report = runAnalysis(paths);
|
|
333
|
-
for (const line of report.reportLines) {
|
|
334
|
-
console.log(line);
|
|
335
|
-
}
|
|
336
|
-
}
|
|
337
|
-
catch (err) {
|
|
338
|
-
const msg = err instanceof Error ? err.message : String(err);
|
|
339
|
-
console.error(`[bkit-analysis] analysis error (fail-open): ${msg}`);
|
|
340
|
-
}
|
|
373
|
+
return { counts, runs, deferralDiscipline, reportLines };
|
|
341
374
|
}
|