@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,149 +1,147 @@
|
|
|
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
|
# Agent Config Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:**
|
|
10
|
+
> **Purpose:** For each coding-agent host: instruction loading, permissions, hooks, tool servers, agent definitions and model pins — and the hosts agree, bkit-shipped gates included.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> -
|
|
18
|
-
> -
|
|
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 print or copy a token, key, or secret value; names, scopes, and presence only.
|
|
23
|
-
> - never run `bkit install` / `bkit upgrade`.
|
|
24
|
-
> - never call a tool-server tool; listing its tools only.
|
|
25
|
-
> - Name the machine. User-level / local-override config absent on a fresh checkout → `Not Checked`.
|
|
14
|
+
> - NEVER print or copy a token, key or secret value. Record names, scopes and presence only.
|
|
15
|
+
> - Do not run `bkit install` / `bkit upgrade`.
|
|
16
|
+
> - Do not call a tool-server tool. Only list its tools.
|
|
17
|
+
> - Name the machine the audit runs on.
|
|
18
|
+
> - **If** user-level or local-override config is absent because the checkout is fresh → mark it `Not Checked`.
|
|
26
19
|
|
|
27
20
|
## Universal Instructions
|
|
28
21
|
|
|
29
22
|
### Context & Goals
|
|
30
23
|
|
|
31
|
-
Each agent host reads its own permissions, hooks, tool servers
|
|
24
|
+
Each agent host reads its own permissions, hooks, tool servers and model picks, and nobody reviews them as config. A broad allow rule lands in a one-line diff, a local override lives on one laptop, and a tool server holds a write token nobody scoped. The failure this audit targets is an agent doing something that one host's config would have blocked, because the host it ran in was configured differently. Examples: force-push is denied in one host and allowed in another; a tool server holds an admin token where read access would do; a hook is wired, but its script is not executable, so it never fires; or an issue body tells an agent with push rights to push, and nothing but prompt text stops it.
|
|
32
25
|
|
|
33
|
-
**Applies when:** repo carries config for
|
|
26
|
+
**Applies when:** the repo carries config for at least one coding agent (e.g., `AGENTS.md`, `.claude/`, `.cursor/`, `.codex/`, `.opencode/`, `.mcp.json`), or anyone works on it with one. **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
34
27
|
|
|
35
|
-
**Cadence:**
|
|
28
|
+
**Cadence:** Run once a month. Run an extra pass after adding an agent host or tool server, after a bkit upgrade, and after a change to a permission, hook or tool-server file.
|
|
36
29
|
|
|
37
|
-
**Anchor Standards:**
|
|
30
|
+
**Anchor Standards:**
|
|
38
31
|
|
|
39
|
-
- OWASP Top 10 for Agentic Applications, 2026 (ASI01
|
|
40
|
-
- Tool-server specification authorization and security best practices (e.g
|
|
32
|
+
- OWASP Top 10 for Agentic Applications, 2026 (ASI01-ASI10).
|
|
33
|
+
- Tool-server specification authorization and security best practices (e.g., Model Context Protocol). Record the specification date read.
|
|
41
34
|
- OpenSSF Security-Focused Guide for AI Code Assistant Instructions.
|
|
42
|
-
- Each host's settings, permission, sandbox
|
|
43
|
-
- bkit, when installed: `.bkit/README.md` § File ownership — permissions and hooks bkit writes
|
|
35
|
+
- Each host's settings, permission, sandbox and hook reference (e.g., Claude Code, Cursor, Codex, opencode). Record the date read.
|
|
36
|
+
- bkit, when installed: `.bkit/README.md` § File ownership — the permissions and hooks bkit writes for each host.
|
|
44
37
|
|
|
45
38
|
### Scope
|
|
46
39
|
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
40
|
+
- List the hosts in use.
|
|
41
|
+
- For each host, list the config files it loads per layer (managed policy, user, repo, local override), and their precedence.
|
|
42
|
+
- List the instruction files each host loads.
|
|
43
|
+
- Check permissions: allow / ask / deny, the default approval mode, the sandbox and the fetch allowlist, and their parity across hosts.
|
|
44
|
+
- Check that hooks and guard scripts are wired and runnable, that they fire, and how they fail.
|
|
45
|
+
- Inventory the tool servers for each host: transport, pinning, credential source and scope, pre-approved writes, unused servers and tool-description changes.
|
|
46
|
+
- Check agent definitions, commands and skills: tool allowlists, model pins and sources.
|
|
47
|
+
- Check for secrets in agent config and in env files that agents load.
|
|
48
|
+
- Map untrusted input: text outsiders can write that each agent reads, what that agent can do in the same session, and what stops a planted instruction.
|
|
49
|
+
- **If** bkit is installed → check that its shipped permissions and hooks agree across hosts.
|
|
56
50
|
|
|
57
51
|
### Out of Scope
|
|
58
52
|
|
|
59
53
|
<!-- prettier-ignore -->
|
|
60
54
|
| Excluded item | Why | Where it belongs |
|
|
61
55
|
| --- | --- | --- |
|
|
62
|
-
| Instruction files
|
|
63
|
-
| Model calls the product makes; tool servers the product exposes | LLM sweep | `bkit-audit-llm` |
|
|
64
|
-
| Whether product prompts are clear, well structured
|
|
65
|
-
|
|
|
66
|
-
| CI workflow token permissions
|
|
67
|
-
| Worktrees, branches
|
|
68
|
-
| Hosted environment variables, dashboards, repository rulesets |
|
|
69
|
-
| Agent and model spend |
|
|
70
|
-
| Whether a sweep here should become a gate |
|
|
71
|
-
| bkit install state: version, `bkit check`, `bkit doctor`, hosts installed, managed blocks, templates adopted and wired | bkit adoption sweep | `bkit-audit-adoption` |
|
|
72
|
-
| Changing config, or running `bkit install` / `bkit upgrade` |
|
|
56
|
+
| Instruction files that contradict each other; the size of always-loaded files | The documentation sweep owns them | `bkit-audit-documentation` |
|
|
57
|
+
| Model calls the product makes; tool servers the product exposes | The LLM sweep owns them | `bkit-audit-llm` |
|
|
58
|
+
| Whether product prompts are clear, well structured and fit their model | The prompt sweep owns it | `bkit-audit-prompts` |
|
|
59
|
+
| The product's model registry, deprecations and fallback chains | The model sweep owns them | `bkit-audit-models` |
|
|
60
|
+
| CI workflow token permissions and pinned actions; rotating a leaked secret | The security sweep owns them | `bkit-audit-security` |
|
|
61
|
+
| Worktrees, branches and stashes agents leave behind; version-control hooks | The repo sweep owns them | `bkit-audit-repo` |
|
|
62
|
+
| Hosted environment variables, dashboards, repository rulesets | The config sweep owns them | `bkit-audit-config` |
|
|
63
|
+
| Agent and model spend | The cost sweep owns it | `bkit-audit-cost` |
|
|
64
|
+
| Whether a sweep here should become a gate | The gate sweep owns it | `bkit-audit-gates` |
|
|
65
|
+
| bkit install state: version, `bkit check`, `bkit doctor`, hosts installed, managed blocks, templates adopted and wired | The bkit adoption sweep owns it | `bkit-audit-adoption` |
|
|
66
|
+
| Changing config, or running `bkit install` / `bkit upgrade` | The audit only reports | A plan made from this report |
|
|
73
67
|
|
|
74
68
|
### Pre-Flight / Dependencies
|
|
75
69
|
|
|
76
|
-
**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.
|
|
77
|
-
|
|
78
|
-
**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.
|
|
79
|
-
|
|
80
70
|
#### Core
|
|
81
71
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
- [ ] **
|
|
85
|
-
- [ ] **
|
|
86
|
-
- [ ] **Effective Config:** Steps 2, 4, 6 — host's merged-config view where offered (e.g. `claude mcp list`, a host's permissions or MCP panel). Fallback: files + documented precedence by hand; effective state = hypothesis.
|
|
87
|
-
- [ ] **Web:** Steps 7, 11 — anchor standards, host references, live model catalogues. Fallback: versions recorded as unread; model pins `Not Checked`.
|
|
72
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
73
|
+
- [ ] **Checkout:** Steps 2-10 — the repo-level agent config. Fallback: none. **If** there is no checkout → write `N/A`, then **STOP**.
|
|
74
|
+
- [ ] **Effective Config:** Steps 2, 4, 6 — the host's merged-config view, where it offers one (e.g., `claude mcp list`, a host's permissions or MCP panel). Fallback: work out the effective state by hand from the files and the documented precedence, and treat it as a hypothesis.
|
|
75
|
+
- [ ] **Web:** Steps 7, 11 — the anchor standards, host references and live model catalogues. Fallback: record the versions as unread, and mark model pins `Not Checked`.
|
|
88
76
|
|
|
89
77
|
#### Conditional
|
|
90
78
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
- [ ] **
|
|
94
|
-
- [ ] **Managed Policy:** Org-managed agent policy → Step 2 — policy file or admin console, read-only. Fallback: `Not Checked`; name who holds it.
|
|
95
|
-
- [ ] **Token Scopes:** Tool servers or hooks use credentials → Step 6 — scopes, value never printed (e.g. `gh auth status`, the `X-OAuth-Scopes` response header, provider token introspection). Fallback: scopes `Not Checked`.
|
|
79
|
+
- [ ] **Machine Config:** **If** the audit runs on a developer machine → Steps 2, 4, 6, 8 — the user-level and local-override files (e.g., `~/.claude/settings.json`, `.claude/settings.local.json`, `~/.cursor/mcp.json`, `~/.codex/config.toml`). Fallback: check the repo level only, and mark the machine layers `Not Checked`.
|
|
80
|
+
- [ ] **Managed Policy:** **If** the org manages agent policy → Step 2 — the policy file or admin console, read-only. Fallback: `Not Checked`, naming who holds it.
|
|
81
|
+
- [ ] **Token Scopes:** **If** tool servers or hooks use credentials → Step 6 — the scopes, NEVER printing the value (e.g., `gh auth status`, the `X-OAuth-Scopes` response header, provider token introspection). Fallback: mark scopes `Not Checked`.
|
|
96
82
|
|
|
97
83
|
### 🔒 Gate 1: Prerequisites Check
|
|
98
84
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
102
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
85
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
86
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
103
87
|
|
|
104
88
|
### Probe Steps
|
|
105
89
|
|
|
106
|
-
- [ ] **Step 1 — Previous Run:**
|
|
107
|
-
- [ ] **Step 2 — Hosts and Layers:** Name machine and checkout.
|
|
108
|
-
- [ ] **Step 3 — Instructions:**
|
|
109
|
-
- [ ] **Step 4 — Permissions:**
|
|
110
|
-
- [ ] **Step 5 — Hooks:**
|
|
111
|
-
- [ ] **Step 6 — Tool Servers:**
|
|
112
|
-
- [ ] **Step 7 — Agents and Models:**
|
|
113
|
-
- [ ] **Step 8 — Secrets:**
|
|
114
|
-
- [ ] **Step 9 — Untrusted Input:**
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
90
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
91
|
+
- [ ] **Step 2 — Hosts and Layers:** Name the machine and the checkout. List the hosts that have repo config or are in team use (e.g., Claude Code, Cursor, Codex, opencode). For each host, record the config file at each layer (managed policy, user, repo shared, repo local override, flags / env) and the documented precedence. Record these as findings: config for a host nobody uses; a host in use with no repo config; and a local-override file that is tracked or not ignored. **If** the checkout is a fresh cloud checkout with no user or local layer → say so, and do not call it clean. **Done when:** `Hosts` holds one row per host and layer: file · present · tracked / ignored · precedence.
|
|
92
|
+
- [ ] **Step 3 — Instructions:** For each host, list the instruction files it loads at session start (e.g., `AGENTS.md`, `CLAUDE.md`, always-applied IDE rule files, per-directory files, imports). Record these as findings: a host that reaches no shared rules; and a rule file or import that points to a missing path. Contradictions and size go to `bkit-audit-documentation`. **Done when:** `Instructions` holds one row per host: files loaded · shared rules reached yes / no.
|
|
93
|
+
- [ ] **Step 4 — Permissions:** For each host and layer, record allow / ask / deny, the default approval mode, the sandbox mode and the fetch / network allowlist. Record these as findings: a wildcard shell allow; an allow for an interpreter that runs arbitrary text (e.g., `bash -c`, `node -e`, `python -c`); a deny overridden by a broader allow with higher precedence; an approval-bypass mode in shared config outside a sandbox; and a fetch allowlist wider than needed under each host's matching rules (e.g., apex vs subdomain). Build the `Parity` matrix: for each action and host, name what blocks it — deny rule / hook / sandbox / prompt prose only / nothing. Cover at least these actions: force push, history rewrite, branch delete, hook skip (e.g., `--no-verify`), merge or push to a protected branch, publish / release, delete outside the working tree, credential-file read (e.g., `.env*`), fetch to an unlisted host, and a tool-server write to a shared or production system. Record these as findings: an action blocked in one host and open in another; and an action blocked by prompt prose only. **Done when:** `Permissions` holds one row per host and layer, and `Parity` has no empty cell.
|
|
94
|
+
- [ ] **Step 5 — Hooks:** For each host, record each wired hook's event, matcher and command. Check that the script exists, is executable and has its interpreter present. Fire test: send a synthetic tool-call payload on stdin, and record the exit code or decision. **If** a hook writes anything (telemetry, logs, state) → read it, and do not run it. Record these as findings: the sole blocker for a `Parity` row fails open on a crash, a timeout or a missing dependency; and a matcher misses a tool that does the same action (e.g., a tool server's shell tool). **Done when:** `Hooks` holds one row per hook: wired · runnable · fires on fixture · fail mode.
|
|
95
|
+
- [ ] **Step 6 — Tool Servers:** For each host, record each tool server (e.g., MCP): layer, transport (local command / remote URL), package pinned or floating (e.g., `npx -y pkg@latest`), publisher, credential source (env var name vs literal), credential scope vs need, toolsets enabled vs used, and write tools pre-approved. List its tools, and hash their names and descriptions. Record these as findings: a floating package; the same server set up differently across hosts (token, toolsets, URL); a server no workflow uses; and a hash that changed since the previous run with no version change. **Done when:** `Tool Servers` holds one row per server and host, with hashes recorded.
|
|
96
|
+
- [ ] **Step 7 — Agents and Models:** For each host, list the agent definitions, commands and skills / plugins. For each agent, compare its tool allowlist with its role, and its model pin with the provider's live catalogue. Never infer a pin's validity from version digits. For each skill or plugin, record its source, its pinned version and whether it ships scripts. Record these as findings: write tools on a read-only role; a dead pin; a floating alias; the same agent on different model classes across hosts, undocumented; and a skill of unknown source that ships scripts. **Done when:** `Agents` holds one row per agent and host, and skills are listed.
|
|
97
|
+
- [ ] **Step 8 — Secrets:** Read the agent config and the env files agents load (e.g., `.envrc`, tool-server env files, the agent-tooling env file). Record these as findings: a literal token in a tracked file (file and line, NEVER the value); an env file that is not ignored; and an app credential in the agent-tooling env. An agent's read of credential files goes to the Step 4 `Parity` matrix. **Done when:** `Secrets` holds one row per file.
|
|
98
|
+
- [ ] **Step 9 — Untrusted Input:** For each agent, command, skill and automated agent run (CI job, scheduled or comment-triggered session) from Step 7, record:
|
|
99
|
+
- (a) the text it reads that someone outside the team can write (e.g., issue / PR body and comments, fork commit messages, PR checkout files, CI logs, fetched pages, dependency READMEs and changelogs, tool-server results, inbound mail)
|
|
100
|
+
- (b) what it can do in the same session (shell, file write, push, merge, publish, tracker or tool-server write, outbound fetch), from Steps 4, 6, 7
|
|
101
|
+
- (c) what stops a planted instruction: deny rule / hook / sandbox / human approval / read-only agent handing a summary to a separate writer / prompt prose only / nothing
|
|
102
|
+
- (d) who can start the run (e.g., issue label, `@`-mention, comment command, `pull_request_target`).
|
|
103
|
+
- Read how prompts fence and label untrusted text as data. Prose is defence in depth, never the stop.
|
|
104
|
+
- Exfiltration means the same session holds a secret or private data and reaches a host or surface an outsider reads (fetch allowlist, tracker comment, PR body, public commit).
|
|
105
|
+
- Record these as findings:
|
|
106
|
+
- (a) together with write, push or shell, where the stop is prompt prose only or nothing (ASI01, LLM01)
|
|
107
|
+
- (a) together with a secret or private data and an outbound path an outsider can read
|
|
108
|
+
- an outsider able to start a run that holds write credentials
|
|
109
|
+
- Product model calls go to `bkit-audit-llm`.
|
|
110
|
+
|
|
111
|
+
**Done when:** `Untrusted Input` holds one row per agent: untrusted sources · capabilities · who starts it · stop · verdict.
|
|
112
|
+
|
|
113
|
+
- [ ] **Step 10 — bkit Gates:** **If** `.bkit/version` is absent → skip the step explicitly, with evidence. **If** it is present → for each installed bkit host, check that every permission and hook bkit writes (`.bkit/README.md` § File ownership) appears in Steps 4-5 and in `Parity`. **If** the same bkit gate is enforced in one host and open in another → the fix is upstream in bkit. Version, drift, hosts with no bkit install, managed blocks and templates go to `bkit-audit-adoption`. **Done when:** `bkit` lists the bkit gates per host with a verdict, or records the skip with evidence.
|
|
114
|
+
- [ ] **Step 11 — 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 agentic risk (ASI01-ASI10), one per tool-server security best practice and one per assistant-instructions guide recommendation this audit touches, 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.
|
|
115
|
+
- [ ] **Step 12 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches agent config: settings, hooks, tool-server files, agent definitions, skills, instruction load paths or the bkit version. (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 (agent incidents, new `docs/failures.jsonl` rows, friction logs), 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`.
|
|
118
116
|
|
|
119
117
|
### 🔒 Gate 2: Probes Check
|
|
120
118
|
|
|
121
|
-
**
|
|
122
|
-
|
|
123
|
-
- [ ] **
|
|
124
|
-
- [ ] **
|
|
125
|
-
- [ ] **No
|
|
126
|
-
- [ ] **
|
|
127
|
-
- [ ] **Gate 2
|
|
119
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
120
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
121
|
+
- [ ] **No secrets:** no token, key, or secret value appears anywhere in the report.
|
|
122
|
+
- [ ] **Config untouched:** no agent config, hook, tool-server file, agent definition or bkit-managed file changed.
|
|
123
|
+
- [ ] **No install:** no `bkit install` / `bkit upgrade` was run.
|
|
124
|
+
- [ ] **No tool calls:** no tool-server tool was called.
|
|
125
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
128
126
|
|
|
129
127
|
## Findings
|
|
130
128
|
|
|
131
129
|
<!-- prettier-ignore -->
|
|
132
130
|
| Severity | Use |
|
|
133
131
|
| --- | --- |
|
|
134
|
-
| `CRITICAL` |
|
|
135
|
-
| `HIGH` |
|
|
136
|
-
| `MEDIUM` |
|
|
137
|
-
| `LOW` | Naming drift
|
|
132
|
+
| `CRITICAL` | A live credential in tracked agent config. An outsider can start an agent run that reads their text and holds write or push credentials, with no structural stop. An unprompted production write through a tool server in shared config. An approval-bypass mode in shared config outside a sandbox |
|
|
133
|
+
| `HIGH` | An action blocked in one host and open in another. An action blocked by prompt prose only. An agent reads untrusted text and can write, push or run shell, with no structural stop. An agent reads untrusted text, holds a secret or private data, and reaches a host an outsider can read. The sole blocking hook never fires or fails open. A tool-server credential with write or admin access where read would do. An allow for an arbitrary interpreter. A floating tool-server package |
|
|
134
|
+
| `MEDIUM` | An unused host config or tool server. A tool description changed with no version change. A dead model pin, or one inconsistent across hosts. A tracked local override. Agent tools beyond its role |
|
|
135
|
+
| `LOW` | Naming drift with no behaviour change. A doc that is wrong about agent config while the config is right |
|
|
138
136
|
|
|
139
|
-
|
|
137
|
+
Within a severity, list production writes first, then credentials, then parity gaps.
|
|
140
138
|
|
|
141
139
|
<!-- prettier-ignore -->
|
|
142
140
|
| ID | Severity | Host | Location | Evidence | Expected |
|
|
143
141
|
| --- | --- | --- | --- | --- | --- |
|
|
144
142
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
145
143
|
|
|
146
|
-
|
|
144
|
+
**If** the run finds nothing → write one row: `None`.
|
|
147
145
|
|
|
148
146
|
## Report
|
|
149
147
|
|
|
@@ -224,17 +222,17 @@ PENDING
|
|
|
224
222
|
|
|
225
223
|
### 🔒 Gate 3: Report Check
|
|
226
224
|
|
|
227
|
-
**
|
|
228
|
-
|
|
229
|
-
- [ ] **
|
|
230
|
-
- [ ] **
|
|
231
|
-
- [ ] **Series:** `Parity` and tool-server hashes diffed against previous report's, or marked baseline.
|
|
232
|
-
- [ ] **Writes:** only this report
|
|
233
|
-
- [ ] **
|
|
234
|
-
- [ ] **
|
|
235
|
-
- [ ] **
|
|
236
|
-
|
|
237
|
-
|
|
225
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
226
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
227
|
+
- [ ] **Machine:** `Summary` names the machine.
|
|
228
|
+
- [ ] **Hosts read:** `Summary` names the hosts read.
|
|
229
|
+
- [ ] **Series:** `Parity` and the tool-server hashes are diffed against the previous report's, or the run is marked baseline.
|
|
230
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
231
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
232
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
233
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
234
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
235
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
238
236
|
|
|
239
237
|
<!-- bkit:end -->
|
|
240
238
|
|