@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,9 +1,9 @@
|
|
|
1
|
-
<!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
|
|
2
|
-
|
|
3
1
|
<!-- bkit:start -->
|
|
4
2
|
|
|
5
3
|
{{BKIT_MANAGED_MARKER}}
|
|
6
4
|
|
|
5
|
+
<!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
|
|
6
|
+
|
|
7
7
|
# Repo Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
@@ -11,145 +11,217 @@
|
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> -
|
|
18
|
-
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
19
|
-
> - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
|
|
20
|
-
> - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
|
|
21
|
-
> - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
|
|
22
|
-
> - NEVER delete, prune, push, drop a stash, or rewrite history; name the command, do not run it.
|
|
23
|
-
> - NEVER copy a secret or personal-data value into the report; name the file and line.
|
|
24
|
-
> - Name the machine. Local leftovers absent on a fresh checkout stay `Not Checked`.
|
|
14
|
+
> - NEVER delete, prune, push, drop a stash or rewrite history. Name the command in the finding, and leave it unrun.
|
|
15
|
+
> - NEVER copy a secret, token, key or personal-data value into the report. Name the file and line instead.
|
|
16
|
+
> - Name the machine.
|
|
17
|
+
> - Local leftovers that a fresh checkout does not have stay `Not Checked`.
|
|
25
18
|
|
|
26
19
|
## Universal Instructions
|
|
27
20
|
|
|
28
21
|
### Context & Goals
|
|
29
22
|
|
|
30
|
-
Every task leaves a worktree, branch, stash
|
|
23
|
+
Every task leaves a worktree, branch, stash or scratch directory behind, and removing them is nothing's job. Stale copies look like live work, and search and agents read them. A leftover that something keeps producing is a bug in that producer. Worse, cleanup by age deletes the only copy of unpushed work. The goal is that every leftover is judged before anything is called removable, and that a producer which keeps writing leftovers is named as the bug.
|
|
31
24
|
|
|
32
|
-
**Applies when:** a git checkout.
|
|
25
|
+
**Applies when:** the project is a git checkout. **If** it is not → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
33
26
|
|
|
34
|
-
**Cadence:**
|
|
27
|
+
**Cadence:** Run once a month. Run an extra pass after a burst of parallel agent work, because that is when worktrees and branches pile up fastest.
|
|
35
28
|
|
|
36
|
-
**Anchor Standards:**
|
|
29
|
+
**Anchor Standards:**
|
|
37
30
|
|
|
38
|
-
- OpenSSF Scorecard checks; record the version
|
|
31
|
+
- OpenSSF Scorecard checks; record the version.
|
|
39
32
|
- OpenSSF OSPS Baseline, the version marked current.
|
|
40
|
-
- Host branch rulesets (e.g
|
|
41
|
-
- Secret scanning push protection (e.g
|
|
42
|
-
- Secret scanners (e.g
|
|
43
|
-
- Repository size tool (e.g
|
|
44
|
-
- Workspace dependency-version linter (e.g
|
|
33
|
+
- Host branch rulesets (e.g., GitHub rulesets, GitLab protected branches).
|
|
34
|
+
- Secret scanning push protection (e.g., GitHub secret scanning, GitLab secret push protection).
|
|
35
|
+
- Secret scanners (e.g., gitleaks, TruffleHog); record versions.
|
|
36
|
+
- Repository size tool (e.g., git-sizer); record version.
|
|
37
|
+
- Workspace dependency-version linter (e.g., sherif, syncpack); record version.
|
|
45
38
|
- RFC 9116 `security.txt`.
|
|
46
39
|
|
|
47
40
|
### Scope
|
|
48
41
|
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
42
|
+
- List worktrees, local and remote branches, stashes, tags and stale pull requests.
|
|
43
|
+
- List ignored and untracked leftovers, including scratch directories and files stranded at the root.
|
|
44
|
+
- Scan leftovers and history for secrets and personal data, and record names only.
|
|
45
|
+
- Check the tracked layout: size, history size, toolchain agreement, accidental publish, attributes, placement, naming and contribution scaffolding.
|
|
46
|
+
- Check the repository posture: a scorecard subset, branch protection, security settings, the disclosure route and accumulating installations.
|
|
54
47
|
|
|
55
48
|
### Out of Scope
|
|
56
49
|
|
|
57
50
|
<!-- prettier-ignore -->
|
|
58
51
|
| Excluded item | Why | Where it belongs |
|
|
59
52
|
| --- | --- | --- |
|
|
60
|
-
| Code or config nothing reaches |
|
|
61
|
-
| Whether a doc is true |
|
|
62
|
-
| Dependency-update bot branches |
|
|
63
|
-
| Workflow token permissions, pinned actions, dangerous workflow |
|
|
64
|
-
| People, 2FA, deploy keys, long-lived tokens |
|
|
65
|
-
| Actions secrets and variables; settings versus docs |
|
|
66
|
-
| Personal-data lifecycle |
|
|
67
|
-
| Deleting, moving, pruning, or pushing |
|
|
53
|
+
| Code or config nothing reaches | The dead-code sweep owns it | `bkit-audit-dead-code` |
|
|
54
|
+
| Whether a doc is true | The documentation sweep owns it | `bkit-audit-documentation` |
|
|
55
|
+
| Dependency-update bot branches | The dependency sweep owns them | `bkit-audit-dependencies` |
|
|
56
|
+
| Workflow token permissions, pinned actions, dangerous workflow | The security sweep owns them | `bkit-audit-security` |
|
|
57
|
+
| People, 2FA, deploy keys, long-lived tokens | The security sweep owns them | `bkit-audit-security` |
|
|
58
|
+
| Actions secrets and variables; settings versus docs | The config sweep owns them | `bkit-audit-config` |
|
|
59
|
+
| Personal-data lifecycle | The privacy sweep owns it | `bkit-audit-privacy` |
|
|
60
|
+
| Deleting, moving, pruning, or pushing | The audit only reports | A plan made from this report |
|
|
68
61
|
|
|
69
62
|
### Verdicts
|
|
70
63
|
|
|
71
|
-
- **REMOVE:** provably safe
|
|
72
|
-
- **RESCUE:** holds work that exists nowhere else (unpushed commits, uncommitted worktree edits, a stash whose changes are on no branch). Name what it holds and who would know.
|
|
73
|
-
- **MOVE:** kept, but in the wrong place or
|
|
74
|
-
- **KEEP:** in use. Say what uses it.
|
|
75
|
-
- **ASK:** cannot tell
|
|
76
|
-
- **OTHER:** fits
|
|
64
|
+
- **REMOVE:** it is provably safe to remove: merged by ancestry, patch-equivalent on the integration branch (`git cherry` shows only `-`), its pull request merged, or a regenerable artefact (build output, cache, coverage, test results).
|
|
65
|
+
- **RESCUE:** it holds work that exists nowhere else (unpushed commits, uncommitted worktree edits, a stash whose changes are on no branch). Name what it holds and who would know. The next step is to push it, or to drop it on purpose. It is at least `HIGH`.
|
|
66
|
+
- **MOVE:** it is kept, but it sits in the wrong place or has a misleading name.
|
|
67
|
+
- **KEEP:** it is in use. Say what uses it.
|
|
68
|
+
- **ASK:** the evidence cannot tell. Name who would know.
|
|
69
|
+
- **OTHER:** it fits no other verdict. Say why. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
|
|
77
70
|
|
|
78
|
-
**Two traps
|
|
71
|
+
**Two traps:** A squash merge stays ahead of the integration branch by ancestry, so check the pull request and `git cherry`, never `git branch --merged` alone. A worktree whose branch is fully merged can still hold uncommitted edits, so run `git status --porcelain` before REMOVE.
|
|
79
72
|
|
|
80
73
|
### Pre-Flight / Dependencies
|
|
81
74
|
|
|
82
|
-
**Checkpoint:** Check off all core items. Check conditional items only when applicable. Each item: available → tool and version; missing → fallback, gap in `Not Checked`, fix in `Process Improvements`. Unnamed gap reads as passed. never abort for a missing capability.
|
|
83
|
-
|
|
84
|
-
**Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
|
|
85
|
-
|
|
86
75
|
#### Core
|
|
87
76
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
- [ ] **
|
|
91
|
-
- [ ] **
|
|
92
|
-
- [ ] **Host API:** Steps 4, 8 — read-only, e.g. `gh api`. Fallback: local git only; remote branches, pull requests, and settings `Not Checked`.
|
|
93
|
-
- [ ] **Web:** Step 10 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
77
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
78
|
+
- [ ] **Git:** Steps 2-7, 9 — the local checkout, worktrees, branches and stashes. Fallback: there is none. **If** there is no checkout → write `N/A`, then **STOP**.
|
|
79
|
+
- [ ] **Host API:** Steps 4, 8 — read-only host reads (e.g., `gh api`). Fallback: use local git only, and mark remote branches, pull requests and settings `Not Checked`.
|
|
80
|
+
- [ ] **Web:** Step 10 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
94
81
|
|
|
95
82
|
#### Conditional
|
|
96
83
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
- [ ] **
|
|
100
|
-
- [ ] **
|
|
101
|
-
- [ ] **Dependency Version Linter:** Workspaces → Step 7 — e.g. sherif, syncpack. Fallback: diff manifests by reading.
|
|
102
|
-
- [ ] **Scorecard:** Host exposes one → Step 8 — e.g. OpenSSF Scorecard, read-only token. Fallback: settings API only; scores `Not Checked`.
|
|
84
|
+
- [ ] **Secret Scanners:** **If** there are leftovers or history → Steps 6-7 — secret scans (e.g., gitleaks, TruffleHog). Fallback: pattern search, and mark the verified-credential check `Not Checked`. Write the reports outside the repo.
|
|
85
|
+
- [ ] **Repo Sizer:** **If** history size is measured → Step 7 — history size (e.g., git-sizer). Fallback: read blob sizes with `git rev-list`.
|
|
86
|
+
- [ ] **Dependency Version Linter:** **If** the repo has workspaces → Step 7 — version drift across workspaces (e.g., sherif, syncpack). Fallback: diff the manifests by reading them.
|
|
87
|
+
- [ ] **Scorecard:** **If** the host exposes one → Step 8 — check scores (e.g., OpenSSF Scorecard, with a read-only token). Fallback: use the settings API only, and mark the scores `Not Checked`.
|
|
103
88
|
|
|
104
89
|
### 🔒 Gate 1: Prerequisites Check
|
|
105
90
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
109
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
91
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
92
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
110
93
|
|
|
111
94
|
### Probe Steps
|
|
112
95
|
|
|
113
|
-
- [ ] **Step 1 — Previous Run:**
|
|
114
|
-
- [ ] **Step 2 — Checkout:** Name machine and checkout. Worktrees, stashes
|
|
115
|
-
- [ ] **Step 3 — Worktrees:** `git worktree list --porcelain`.
|
|
116
|
-
- [ ] **Step 4 — Branches:**
|
|
117
|
-
- [ ] **Step 5 — Stashes:** `git stash list` with dates, then `git stash show --stat` for each. Check whether changes already landed on integration branch.
|
|
118
|
-
- [ ] **Step 6 — Leftovers:**
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
-
|
|
122
|
-
-
|
|
123
|
-
-
|
|
96
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
97
|
+
- [ ] **Step 2 — Checkout:** Name the machine and the checkout. Worktrees, stashes and scratch directories are local, so a fresh cloud checkout sees none of them. Say so, rather than calling them clean. Remote branches and pull requests are shared, and every run checks them. **Done when:** `Checked` holds the machine, the checkout, and which surfaces are local-only.
|
|
98
|
+
- [ ] **Step 3 — Worktrees:** Run `git worktree list --porcelain`. For each worktree, record its branch, ahead/behind the integration branch, `git cherry`, pull-request state, uncommitted changes (`git status --porcelain`), last commit date and size (`du -sh`). **If** a worktree is locked, **or** has files modified in the last day → give it KEEP or ASK, never REMOVE, because an agent may still be running. Also run `git worktree prune --dry-run` for entries whose directory is gone. Never prune for real. **Done when:** `Worktrees` has one row per entry with its verdict, and the totals are in `Totals`.
|
|
99
|
+
- [ ] **Step 4 — Branches:** For local branches, list those merged by ancestry, those merged by squash (pull request merged, or `git cherry` all `-`), those whose upstream is gone, and agent-prefix branches with no worktree. For remote branches, list every branch other than integration, production and the dependency-update bot's, with its pull-request state. Record whether delete-on-merge is on. When it is off, a merged pull request leaves its branch behind. For an unmerged branch with no pull request, every commit is RESCUE until shown otherwise. List open pull requests with no activity for 30 days, and old drafts. List tags that no release or deploy uses. **Done when:** `Branches` has one row per item with its verdict, and the counts are in `Totals`.
|
|
100
|
+
- [ ] **Step 5 — Stashes:** Run `git stash list` with dates, then `git stash show --stat` for each stash. Check whether the changes already landed on the integration branch. For a stash that a commit hook created when it failed, the commit was usually retried, so verify before REMOVE. **Done when:** `Stashes` has one row per stash with its verdict.
|
|
101
|
+
- [ ] **Step 6 — Leftovers:** List untracked files (`git status --porcelain`) and ignored files (`git ls-files --others --ignored --exclude-standard --directory`), each with its size.
|
|
102
|
+
- **If** an open issue or plan references a leftover → KEEP, whatever its group.
|
|
103
|
+
- Sort the rest into groups:
|
|
104
|
+
- Regenerable files (dependencies, task cache, coverage, test results, native build folders, tool caches) are safe to REMOVE, so report their size.
|
|
105
|
+
- Group hand-made files (notes, plans, backups, logs, scripts in the scratch directory) by age and type.
|
|
106
|
+
- For a file something produced and did not clean up, the leftover is REMOVE, and the producer is the finding.
|
|
107
|
+
- For a file stranded at the root, find the writer.
|
|
108
|
+
- **If** a tool defaults to the root → point it elsewhere.
|
|
109
|
+
- In the ignore file, find rules that match nothing, and leftovers that are untracked because no rule covers them.
|
|
110
|
+
- Scan for secrets and personal data before any MOVE or REMOVE on the scratch directory, the root or plan logs, and write the scanner reports outside the repo. Personal-data hits are only candidates, because test fixtures carry fake addresses.
|
|
111
|
+
- A real hit in a tracked file is not fixed by removing the file, because it stays in history. Name the file and line, NEVER the value.
|
|
112
|
+
- For hooks, check that the hooks path resolves to the hook directory, that each hook is executable, and that the install script installs them. A checkout where hooks silently do not run looks clean here while it skips every pre-commit control.
|
|
113
|
+
|
|
114
|
+
**Done when:** `Leftovers` is grouped with verdicts, the scan result is named, and the sizes are in `Totals`.
|
|
115
|
+
|
|
116
|
+
- [ ] **Step 7 — Layout:** Read where tracked files belong, and find the misfits.
|
|
117
|
+
- Size:
|
|
118
|
+
- Find the largest blobs at `HEAD`. Committed generated output and logs are MOVE or REMOVE candidates.
|
|
119
|
+
- Record the pack size as a series.
|
|
120
|
+
- History size:
|
|
121
|
+
- A deleted file still grows clones, so measure it with the repository sizer, or with blob sizes across all refs.
|
|
122
|
+
- **If** images or logs are the cause → recommend large-file storage or an ignore rule.
|
|
123
|
+
- A history rewrite is the owner's call (ASK).
|
|
124
|
+
- Secrets in history:
|
|
125
|
+
- Scan all refs, and list every sensitive file ever added (example env files are expected).
|
|
126
|
+
- A verified live credential is `CRITICAL`, and rotation comes first, because a rewrite does not reach existing clones.
|
|
127
|
+
- Name the file and commit, NEVER the value.
|
|
128
|
+
- Toolchain agreement:
|
|
129
|
+
- Compare the runtime pin, engine field, package-manager field, CI setup, host build image and native build config.
|
|
130
|
+
- Run the workspace dependency-version linter for drift across workspaces or a catalog bypass.
|
|
131
|
+
- Docs against files goes to the documentation audit, and this step compares files with each other.
|
|
132
|
+
- Accidental publish: check that every workspace package not meant for a registry is marked unpublishable (e.g., npm `private: true`, Cargo `publish = false`), and that the root states the licence position.
|
|
133
|
+
- Attributes: check end-of-line settings, linguist marks on generated files so review diffs collapse them, binary marks on images, and an editor config that agrees with the formatter.
|
|
134
|
+
- Placement: find root files that belong to an app or package, finished one-off scripts, drafts beside the final doc, unlinked archive folders and near-empty packages.
|
|
135
|
+
- Naming: find folders and files that break their neighbours' conventions.
|
|
136
|
+
- Contribution scaffolding:
|
|
137
|
+
- Check that the owners file, the pull-request and issue templates and the contributing note are present and true.
|
|
138
|
+
- Whether the team needs them is the owner's call (ASK).
|
|
139
|
+
- A template that describes a process nobody follows is MOVE or REMOVE.
|
|
140
|
+
- Owners file:
|
|
141
|
+
- Propose that paths which weaken a gate when edited require human review.
|
|
142
|
+
- Once the file exists, the host's owners-errors API must return none.
|
|
143
|
+
- An unimported file goes to the dead-code audit, and a doc that is wrong rather than misplaced goes to the documentation audit.
|
|
144
|
+
|
|
145
|
+
**Done when:** `Layout` has its rows, and the pack size and largest history blobs are in `Totals`.
|
|
146
|
+
|
|
147
|
+
- [ ] **Step 8 — Posture:** The config audit compares settings with the docs, and this step compares them with the anchor standards.
|
|
148
|
+
- Read that audit's latest report first, and do not duplicate its findings.
|
|
149
|
+
- Every run checks shared settings, local or cloud.
|
|
150
|
+
- Scorecard:
|
|
151
|
+
- Record each check's score as a series.
|
|
152
|
+
- Keep binary artifacts, branch protection, code review, dependency-update tool and security policy here.
|
|
153
|
+
- Token permissions, pinned dependencies and dangerous workflow go to `bkit-audit-security`.
|
|
154
|
+
- Branch protection (integration, production):
|
|
155
|
+
- Check that a pull request is required, that a required check is required, that force-push and deletion are blocked, and that merges are squash-only or history is linear.
|
|
156
|
+
- Read the bypass list, and compare it with the production-merge-requires-PR rule.
|
|
157
|
+
- Security settings:
|
|
158
|
+
- Check that secret scanning and push protection are on, and who may bypass push protection. Push protection blocks at the server, where a hook bypass does not reach.
|
|
159
|
+
- On a private repo, push protection may need a paid secret-protection plan.
|
|
160
|
+
- **If** the plan excludes it → say so.
|
|
161
|
+
- Also check dependency alerts, private vulnerability reporting, a read-only default automation token, and that automation creating or approving pull requests is off.
|
|
162
|
+
- Disclosure: check for a security policy or private vulnerability reporting, and for `/.well-known/security.txt` on the production web origin, with the RFC contact and expiry fields and the expiry still ahead.
|
|
163
|
+
- People, 2FA, deploy keys and long-lived tokens go to the security audit, and automation secrets and variables go to the config audit.
|
|
164
|
+
- Read their latest reports, and confirm that 2FA enforcement is recorded.
|
|
165
|
+
- List accumulators the way branches are listed: installed apps and their permissions, webhooks and environments. An over-scoped app, or a webhook to an unused service, is REMOVE or ASK.
|
|
166
|
+
|
|
167
|
+
**Done when:** `Posture` marks each setting met, finding or not applicable, and the scores are in `Totals`.
|
|
168
|
+
|
|
169
|
+
- [ ] **Step 9 — Verify:** Git state changes hourly.
|
|
170
|
+
- Record when each check ran, and re-check every RESCUE and REMOVE at the end.
|
|
171
|
+
- Give no finding without evidence someone can check again: the command and its output, or `file:line`.
|
|
172
|
+
- Name each destination, and do not act on it. The one exception is the `docs/failures.jsonl` rows, which this run writes.
|
|
173
|
+
- Destinations:
|
|
174
|
+
- REMOVE → the exact command the next step would run, batched for one review.
|
|
175
|
+
- RESCUE → what it holds, who would know, and the decision: push and open a pull request, or drop it on purpose.
|
|
176
|
+
- MOVE → the move, and every reference to update.
|
|
177
|
+
- ASK → who would know, and the question.
|
|
178
|
+
- OTHER → why no verdict fits.
|
|
179
|
+
- A leftover something keeps producing → a `docs/failures.jsonl` row against the producer.
|
|
180
|
+
- A missing or stale ignore rule → the line to add or remove.
|
|
181
|
+
- Code or config nothing reaches → `bkit-audit-dead-code`.
|
|
182
|
+
- A doc that is wrong, not misplaced → `bkit-audit-documentation`.
|
|
183
|
+
- A dependency-bot branch → `bkit-audit-dependencies`.
|
|
184
|
+
- A secret in history, a log or a leftover → `bkit-audit-security`, with rotation first and the file and commit only.
|
|
185
|
+
- Personal data in a log or leftover → `bkit-audit-privacy`.
|
|
186
|
+
- A repository setting below the standard → the setting to change, for the owner.
|
|
187
|
+
- A repository setting that drifted from its doc → `bkit-audit-config`.
|
|
188
|
+
- A workflow-level scorecard failure → `bkit-audit-security`.
|
|
189
|
+
- Toolchain versions that disagree → the file to change.
|
|
190
|
+
- A host setting that disagrees → `bkit-audit-config`.
|
|
191
|
+
- Dependency versions that disagree → `bkit-audit-dependencies`.
|
|
192
|
+
|
|
193
|
+
**Done when:** every RESCUE and REMOVE is re-checked, with its time, verdict and destination.
|
|
194
|
+
|
|
195
|
+
- [ ] **Step 10 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per Scorecard check, and one per baseline control in the sets this audit touches (e.g., OSPS-AC, OSPS-BR-07, OSPS-GV, OSPS-LE, OSPS-VM), each marked checked (naming the step), not applicable (saying why) or finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
|
|
196
|
+
- [ ] **Step 11 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches the repository itself: new top-level files and folders, workspaces, ignore and attribute files, hooks, branch and ruleset settings, host apps, webhooks, environments, and anything new that writes to the scratch directory or the root. (b) In a bounded pass of about 30 minutes, note what a senior platform engineer would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
|
|
124
197
|
|
|
125
198
|
### 🔒 Gate 2: Probes Check
|
|
126
199
|
|
|
127
|
-
**
|
|
128
|
-
|
|
129
|
-
- [ ] **
|
|
130
|
-
- [ ] **
|
|
131
|
-
- [ ] **
|
|
132
|
-
- [ ] **
|
|
133
|
-
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
200
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
201
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
202
|
+
- [ ] **No values:** no secret or personal-data value appears anywhere in the report.
|
|
203
|
+
- [ ] **Nothing removed:** no worktree, branch, stash, file or remote ref was deleted.
|
|
204
|
+
- [ ] **Nothing pushed:** nothing was pushed.
|
|
205
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
134
206
|
|
|
135
207
|
## Findings
|
|
136
208
|
|
|
137
209
|
<!-- prettier-ignore -->
|
|
138
210
|
| Severity | Use |
|
|
139
211
|
| --- | --- |
|
|
140
|
-
| `CRITICAL` |
|
|
141
|
-
| `HIGH` | RESCUE
|
|
142
|
-
| `MEDIUM` |
|
|
143
|
-
| `LOW` |
|
|
212
|
+
| `CRITICAL` | A verified live credential in history, a log or a leftover. Rotation comes first, because a history rewrite does not reach existing clones |
|
|
213
|
+
| `HIGH` | RESCUE: work that one cleanup command would lose. Unverified secret material in history |
|
|
214
|
+
| `MEDIUM` | A leftover that a test or script keeps producing. Toolchain versions that disagree. A repository setting below the standard |
|
|
215
|
+
| `LOW` | A regenerable cache, reported by size. Naming drift. Contribution scaffolding the owner must decide on |
|
|
144
216
|
|
|
145
|
-
|
|
217
|
+
Within a severity, list live credentials first, then RESCUE, before REMOVE.
|
|
146
218
|
|
|
147
219
|
<!-- prettier-ignore -->
|
|
148
220
|
| ID | Severity | Verdict | Location | Evidence | Expected |
|
|
149
221
|
| --- | --- | --- | --- | --- | --- |
|
|
150
222
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
151
223
|
|
|
152
|
-
|
|
224
|
+
**If** the run finds nothing → write one row: `None`.
|
|
153
225
|
|
|
154
226
|
## Report
|
|
155
227
|
|
|
@@ -218,17 +290,17 @@ PENDING
|
|
|
218
290
|
|
|
219
291
|
### 🔒 Gate 3: Report Check
|
|
220
292
|
|
|
221
|
-
**
|
|
222
|
-
|
|
223
|
-
- [ ] **
|
|
224
|
-
- [ ] **
|
|
225
|
-
- [ ] **Series:** `Totals` beside previous report's numbers, or
|
|
226
|
-
- [ ] **Writes:** only this report
|
|
227
|
-
- [ ] **
|
|
228
|
-
- [ ] **
|
|
229
|
-
- [ ] **
|
|
230
|
-
|
|
231
|
-
|
|
293
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
294
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
295
|
+
- [ ] **Machine:** `Summary` names the machine.
|
|
296
|
+
- [ ] **Checkout:** `Summary` names the checkout.
|
|
297
|
+
- [ ] **Series:** the report shows `Totals` beside the previous report's numbers, or marks the run as baseline.
|
|
298
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
299
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
300
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
301
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
302
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
303
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
232
304
|
|
|
233
305
|
<!-- bkit:end -->
|
|
234
306
|
|