@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
package/.bkit/shared/gitignore
CHANGED
|
@@ -50,6 +50,9 @@ docs/plans/*/logs/**/.rebase-failed
|
|
|
50
50
|
# Cursor background-agent runtime marker
|
|
51
51
|
.bkit/.runtime-cursor
|
|
52
52
|
|
|
53
|
+
# Provision recipes that failed in this cloud environment (`bkit context provision`)
|
|
54
|
+
.bkit/.unavailable
|
|
55
|
+
|
|
53
56
|
.bkit/.roadmap-shortlist.json
|
|
54
57
|
.bkit/.roadmap-reverse-sync.json
|
|
55
58
|
|
|
@@ -57,12 +60,13 @@ docs/plans/*/logs/**/.rebase-failed
|
|
|
57
60
|
.claude/scheduled_tasks.lock
|
|
58
61
|
|
|
59
62
|
# Cloud setup docs — `bkit install` inlines resolved .envrc secrets; never commit.
|
|
60
|
-
# One per host: .claude/bkit-cloud.md (Claude Code web), .cursor/bkit-cloud.md (Cursor
|
|
63
|
+
# One per host: .claude/bkit-cloud.md (Claude Code web), .cursor/bkit-cloud.md (Cursor Cloud Agents), .codex/bkit-cloud.md (Codex Cloud)
|
|
61
64
|
.claude/bkit-cloud.md
|
|
62
65
|
.cursor/bkit-cloud.md
|
|
66
|
+
.codex/bkit-cloud.md
|
|
63
67
|
|
|
64
68
|
# Claude native worktrees (isolation:worktree / EnterWorktree) — transient full-tree
|
|
65
|
-
# copies; ignore or slop:delta double-counts the checkout
|
|
69
|
+
# copies; ignore or bkit:slop:delta double-counts the checkout
|
|
66
70
|
.claude/worktrees/
|
|
67
71
|
|
|
68
72
|
# cursor / opencode — no project-local worktree or runtime dir to ignore.
|
|
@@ -128,28 +128,27 @@ fi
|
|
|
128
128
|
# bkit runs whatever `context-fetch:provision` recipe each block carries (self-guarded with
|
|
129
129
|
# `command -v <cli> || <install>`), so no stack name is baked into bkit. Runs every session
|
|
130
130
|
# (a no-op once the CLI is present); the web setup script bakes the same recipes into its
|
|
131
|
-
# snapshot, so this is the gh-runner + resumed-session path. `bkit context
|
|
132
|
-
#
|
|
133
|
-
#
|
|
134
|
-
#
|
|
131
|
+
# snapshot, so this is the gh-runner + resumed-session path. `bkit context provision`
|
|
132
|
+
# (installed by the `pnpm install` above) runs the same region the setup scripts inline:
|
|
133
|
+
# each recipe on its own, a failure named with its last error line, and the failures listed
|
|
134
|
+
# in .bkit/.unavailable. See .agents/context.md.
|
|
135
135
|
if [ -f .agents/context.md ]; then
|
|
136
136
|
BKIT="$REPO_ROOT/node_modules/.bin/bkit"
|
|
137
|
-
if [ ! -x "$BKIT" ]
|
|
138
|
-
log "context-fetch provisioning: SKIPPED — bkit (node_modules/.bin/bkit)
|
|
137
|
+
if [ ! -x "$BKIT" ]; then
|
|
138
|
+
log "context-fetch provisioning: SKIPPED — bkit (node_modules/.bin/bkit) is missing. Fix: a working 'pnpm install'."
|
|
139
139
|
else
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
log "provisioning context-fetch CLIs from .agents/context.md"
|
|
143
|
-
# pnpm refuses `add -g` unless its global-bin dir is on PATH (corepack pnpm skips
|
|
144
|
-
# `pnpm setup`); export it so `pnpm add -g` provision recipes don't self-skip. Mirrors
|
|
145
|
-
# the web setup script's provision region, which bkit's install engine renders.
|
|
146
|
-
export PNPM_HOME="${PNPM_HOME:-$HOME/.local/share/pnpm}"
|
|
147
|
-
export PATH="$PNPM_HOME:$PNPM_HOME/bin:$PATH"
|
|
148
|
-
printf '%s\n' "$PROVISION" | bash || log "context-fetch CLI provisioning failed (non-blocking)"
|
|
149
|
-
fi
|
|
140
|
+
log "provisioning from .agents/context.md (bkit context provision)"
|
|
141
|
+
"$BKIT" context provision >/dev/null || log "bkit context provision did not run (non-blocking)"
|
|
150
142
|
fi
|
|
151
143
|
fi
|
|
152
144
|
|
|
145
|
+
# SessionStart stdout is added to the session's context: tell the agent what setup could
|
|
146
|
+
# not provide, so it treats those as absent instead of retrying their install.
|
|
147
|
+
if [ -s .bkit/.unavailable ]; then
|
|
148
|
+
printf 'Cloud setup could not provide these in this session (setup failed; treat them as absent, do not retry the install):\n'
|
|
149
|
+
cat .bkit/.unavailable
|
|
150
|
+
fi
|
|
151
|
+
|
|
153
152
|
# --- Per-repo install steps -------------------------------------------------
|
|
154
153
|
# Add your own steps here. Examples:
|
|
155
154
|
#
|
|
@@ -18,13 +18,17 @@ FROM ubuntu:26.04@sha256:2260313b31c8c011cd2eebe728008efac1b3982be73eb71348ea264
|
|
|
18
18
|
# --- Consumer-owned: base system + Node ------------------------------------
|
|
19
19
|
# bkit's toolchain assumes curl, ca-certificates, and Node >=24 are on PATH
|
|
20
20
|
# before the bkit toolchain section runs. Pin Node to match your repo's `engines.node`.
|
|
21
|
+
# apt packages here and below carry no version: they track the pinned base release,
|
|
22
|
+
# security updates included. `pkg=<version>` pins break rebuilds once Ubuntu drops
|
|
23
|
+
# the superseded version from its mirrors; tools whose version matters are pinned
|
|
24
|
+
# and checksum-checked outside apt.
|
|
21
25
|
RUN apt-get update && apt-get install -y --no-install-recommends \
|
|
22
26
|
curl ca-certificates xz-utils \
|
|
23
27
|
&& rm -rf /var/lib/apt/lists/*
|
|
24
28
|
# Node — nodejs.org tarball checked against SHASUMS256.txt (linux-x64).
|
|
25
29
|
# renovate: datasource=node-version depName=node
|
|
26
|
-
ARG NODE_VERSION=24.
|
|
27
|
-
ARG NODE_SHA256=
|
|
30
|
+
ARG NODE_VERSION=24.22.1
|
|
31
|
+
ARG NODE_SHA256=6c172a9ab6718f7b801fb5a7bd486af2ee5e32758086a04b84fcce2aa77095e6
|
|
28
32
|
RUN cd /tmp \
|
|
29
33
|
&& curl -fsSLO --retry 3 --retry-all-errors "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64.tar.xz" \
|
|
30
34
|
&& echo "${NODE_SHA256} node-v${NODE_VERSION}-linux-x64.tar.xz" | sha256sum -c - \
|
|
@@ -43,18 +47,18 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
|
|
|
43
47
|
|
|
44
48
|
# gh CLI — git push, PR ops, CI cache lookup. Release tarball checked against the release's checksums.txt.
|
|
45
49
|
# renovate: datasource=github-releases depName=cli/cli
|
|
46
|
-
ARG GH_VERSION=2.
|
|
47
|
-
ARG GH_SHA256=
|
|
50
|
+
ARG GH_VERSION=2.103.0
|
|
51
|
+
ARG GH_SHA256=fdd768eb70f6409f80fcfa9f3a1c0adf0fc98d827ab3ce0bed2ac22762c5d786
|
|
48
52
|
RUN cd /tmp \
|
|
49
53
|
&& curl -fsSLO --retry 3 --retry-all-errors "https://github.com/cli/cli/releases/download/v${GH_VERSION}/gh_${GH_VERSION}_linux_amd64.tar.gz" \
|
|
50
54
|
&& echo "${GH_SHA256} gh_${GH_VERSION}_linux_amd64.tar.gz" | sha256sum -c - \
|
|
51
55
|
&& tar -xzf "gh_${GH_VERSION}_linux_amd64.tar.gz" -C /usr/local/bin --strip-components=2 "gh_${GH_VERSION}_linux_amd64/bin/gh" \
|
|
52
56
|
&& rm -f "gh_${GH_VERSION}_linux_amd64.tar.gz"
|
|
53
57
|
|
|
54
|
-
# vale — `pnpm lint:prose`. Version pinned for snapshot reproducibility; tarball checked before extract.
|
|
58
|
+
# vale — `pnpm bkit:lint:prose`. Version pinned for snapshot reproducibility; tarball checked before extract.
|
|
55
59
|
# renovate: datasource=github-releases depName=errata-ai/vale
|
|
56
|
-
ARG VALE_VERSION=3.
|
|
57
|
-
ARG VALE_SHA256=
|
|
60
|
+
ARG VALE_VERSION=3.24.0
|
|
61
|
+
ARG VALE_SHA256=867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214
|
|
58
62
|
RUN cd /tmp \
|
|
59
63
|
&& curl -fsSLO --retry 3 --retry-all-errors "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz" \
|
|
60
64
|
&& echo "${VALE_SHA256} vale_${VALE_VERSION}_Linux_64-bit.tar.gz" | sha256sum -c - \
|
|
@@ -64,7 +68,7 @@ RUN cd /tmp \
|
|
|
64
68
|
|
|
65
69
|
# pnpm — corepack-pinned to match `packageManager` in package.json.
|
|
66
70
|
# renovate: datasource=npm depName=pnpm
|
|
67
|
-
ARG PNPM_VERSION=10.34.
|
|
71
|
+
ARG PNPM_VERSION=10.34.7
|
|
68
72
|
RUN corepack enable && corepack prepare "pnpm@${PNPM_VERSION}" --activate
|
|
69
73
|
|
|
70
74
|
# --- Consumer extensions ---------------------------------------------------
|
|
@@ -9,10 +9,12 @@ body:
|
|
|
9
9
|
attributes:
|
|
10
10
|
value: |
|
|
11
11
|
Next step:
|
|
12
|
-
-
|
|
13
|
-
-
|
|
12
|
+
- **If** a test or CI run already fails → run `/bkit-debug #<issue number>` on the branch the fix should land on. Debug commits to the branch it runs on.
|
|
13
|
+
- **If** nothing fails yet → run `/bkit-debug #<issue number> [repro]`. It writes a test that fails the way this report describes, then fixes the code until the test passes. **If** no test fails → it stops and says so.
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
**If** the bug is intermittent → add `[soak]`. Debug then works one step per attempt, either adding logging or trying one fix, instead of one diagnosis and one fix:
|
|
16
|
+
- With `[repro]` → the test it writes repeats the scenario until it fails.
|
|
17
|
+
- Without `[repro]` → soak starts only from a test or CI run that already fails. **If** every test passes → the run writes its summary and changes no code.
|
|
16
18
|
- type: textarea
|
|
17
19
|
id: failing
|
|
18
20
|
attributes:
|
|
@@ -37,7 +39,7 @@ body:
|
|
|
37
39
|
id: steps
|
|
38
40
|
attributes:
|
|
39
41
|
label: Steps to reproduce
|
|
40
|
-
description: Numbered
|
|
42
|
+
description: Numbered steps from a clean start.
|
|
41
43
|
placeholder: |
|
|
42
44
|
1.
|
|
43
45
|
2.
|
|
@@ -56,22 +58,22 @@ body:
|
|
|
56
58
|
id: area
|
|
57
59
|
attributes:
|
|
58
60
|
label: Affected area
|
|
59
|
-
description: The route, command, file or module that misbehaves. Files named here are treated as what to fix
|
|
61
|
+
description: The route, command, file or module that misbehaves. Files named here are treated as what to fix. Files seen only in a stack trace are not.
|
|
60
62
|
- type: textarea
|
|
61
63
|
id: where
|
|
62
64
|
attributes:
|
|
63
65
|
label: Where and when
|
|
64
|
-
description:
|
|
66
|
+
description: The environment (for example production or preview), the version or commit, when it was first and last seen in UTC, and the last version that worked.
|
|
65
67
|
- type: textarea
|
|
66
68
|
id: evidence
|
|
67
69
|
attributes:
|
|
68
70
|
label: Evidence
|
|
69
|
-
description: Logs, error-tracker IDs or links, screenshots.
|
|
71
|
+
description: Logs, error-tracker IDs or links, and screenshots.
|
|
70
72
|
- type: textarea
|
|
71
73
|
id: references
|
|
72
74
|
attributes:
|
|
73
75
|
label: References
|
|
74
|
-
description: Related issues with their
|
|
76
|
+
description: Related issues with their titles, the feature that introduced the bug, and ledger rows by `key`. Nothing fetches these, so write exact keys and numbers that agents can search for.
|
|
75
77
|
placeholder: |
|
|
76
78
|
Related: #<number> — <its title>
|
|
77
79
|
Introduced by: 41-csv-import
|
|
@@ -8,24 +8,23 @@ body:
|
|
|
8
8
|
- type: markdown
|
|
9
9
|
attributes:
|
|
10
10
|
value: |
|
|
11
|
-
Write this as the plan
|
|
12
|
-
- `/bkit-plan #<issue number>` turns
|
|
13
|
-
- `/bkit-build #<issue number>`
|
|
14
|
-
- `build:lite` builds from this issue too but checks nothing: no failing-test proof, gates, PR or CI.
|
|
11
|
+
Write this issue as the plan. A build with no plan converts this issue into one.
|
|
12
|
+
- `/bkit-plan #<issue number>` turns this issue into a checked plan. The build then proves each **TEST FIRST** test fails before its code exists.
|
|
13
|
+
- `/bkit-build #<issue number>` converts this issue into a plan, then builds it. It proves each **TEST FIRST** test fails before its code exists.
|
|
15
14
|
|
|
16
|
-
Keep the title short
|
|
15
|
+
Keep the title short, because it names the feature folder. Nothing ticks boxes in an issue.
|
|
17
16
|
- type: textarea
|
|
18
17
|
id: narrative
|
|
19
18
|
attributes:
|
|
20
19
|
label: Narrative
|
|
21
|
-
description: One or two sentences from the user's side
|
|
20
|
+
description: One or two sentences from the user's side, saying what they do and what they get back.
|
|
22
21
|
validations:
|
|
23
22
|
required: true
|
|
24
23
|
- type: textarea
|
|
25
24
|
id: success-criteria
|
|
26
25
|
attributes:
|
|
27
26
|
label: Success Criteria
|
|
28
|
-
description: Up to five outcomes you can observe that prove it works.
|
|
27
|
+
description: Up to five outcomes you can observe that prove it works. List outcomes, not steps.
|
|
29
28
|
placeholder: |
|
|
30
29
|
- A user who saves an item sees it in the list within 2s
|
|
31
30
|
validations:
|
|
@@ -44,7 +43,7 @@ body:
|
|
|
44
43
|
attributes:
|
|
45
44
|
label: Derived Test Matrix
|
|
46
45
|
description: |
|
|
47
|
-
One row per behaviour above, each covered by exactly one task.
|
|
46
|
+
One row per behaviour above, each covered by exactly one task. The type is the lowest tier that really exercises the behaviour, named as in `docs/testing.md`: Unit, Integration, E2E, @live (golden) or fresh-DB replay. The test must fail when the behaviour breaks.
|
|
48
47
|
placeholder: |
|
|
49
48
|
| Test description | Type | Target file |
|
|
50
49
|
| --- | --- | --- |
|
|
@@ -56,16 +55,50 @@ body:
|
|
|
56
55
|
attributes:
|
|
57
56
|
label: Tasks
|
|
58
57
|
description: |
|
|
59
|
-
|
|
58
|
+
List the tasks in build order. The preferred shape is the same group and task blocks a plan uses:
|
|
59
|
+
- Each group holds up to `bkit.workflows.tasks.maxPerGroup` tasks (default 5) and `bkit.workflows.tasks.maxTestsPerGroup` **TEST FIRST** tests (default 25).
|
|
60
|
+
- Each task is a block. Task numbers are unique across the issue.
|
|
61
|
+
- **CREATE** / **READ** / **UPDATE** / **DELETE**: one line per file the task touches, as `` `symbol` in `file`: what to do `` or `` `file`: what to do ``.
|
|
62
|
+
- **DEPENDS ON**: the numbers of the tasks it builds on, in the same group or an earlier one.
|
|
63
|
+
- **DONE WHEN**: a check you can verify in the code. For example, a file exists, a test passes, or a behaviour is observable.
|
|
64
|
+
- **TEST FIRST**: the matrix tests that fail before the code exists. A task has 1 to `bkit.workflows.tasks.maxTestsPerTask` tests (default 10), across up to `bkit.workflows.tasks.maxTestFilesPerTask` test files (default 3). Write one line each, as `` `test file` `test name` fails on what goes wrong ``.
|
|
65
|
+
- **If** the task is docs, config, a pure refactor, or covered by E2E / @live only → write `n/a — reason` under **TEST FIRST**.
|
|
66
|
+
- **TEST EXCEPTION**: written only by the owner. It lists the tests you accept without a proven red, each written as in **TEST FIRST** and ending `— reason`. It counts once it is committed alone in the plan.
|
|
67
|
+
- A **TEST EXCEPTION** written here is a request. The build copies it word for word and does not honour it until the owner confirms it at the build's Decision Pause, where Accept rewrites it with the owner's reason and date.
|
|
68
|
+
|
|
69
|
+
Free text works too. The build converts it.
|
|
70
|
+
|
|
71
|
+
A plan file for this issue wins. Once one exists, the build reads its tasks only from the plan, never from here.
|
|
60
72
|
placeholder: |
|
|
61
|
-
|
|
73
|
+
<!-- bkit:group 1 start -->
|
|
74
|
+
### TASK GROUP 1: Saving items
|
|
75
|
+
<!-- bkit:task 1 start -->
|
|
76
|
+
- [ ] **TASK 1:** Refuse an empty item name
|
|
77
|
+
- **UPDATE:** `saveItem` in `path/to/items`: refuse an empty name
|
|
78
|
+
- **READ:** `path/to/list`: where saved items show
|
|
79
|
+
- **DONE WHEN:** saving an empty name stores nothing and shows why
|
|
80
|
+
- **TEST FIRST:**
|
|
81
|
+
- `path/to/list.test` `rejects an empty name` fails on an empty name being saved
|
|
82
|
+
<!-- bkit:task 1 end -->
|
|
83
|
+
<!-- bkit:task 2 start -->
|
|
84
|
+
- [ ] **TASK 2:** Show saved items in the list
|
|
85
|
+
- **CREATE:** `path/to/list-row`: one row per saved item
|
|
86
|
+
- **DELETE:** `ItemPreview` in `path/to/list`: replaced by the new row
|
|
87
|
+
- **DEPENDS ON:** 1
|
|
88
|
+
- **DONE WHEN:** a saved item appears in the list
|
|
89
|
+
- **TEST FIRST:**
|
|
90
|
+
- `path/to/list.test` `shows a saved item` fails on the list staying empty
|
|
91
|
+
- **TEST EXCEPTION:**
|
|
92
|
+
- `path/to/list.test` `shows a saved item` — the old preview already shows saved items, so it cannot fail first
|
|
93
|
+
<!-- bkit:task 2 end -->
|
|
94
|
+
<!-- bkit:group 1 end -->
|
|
62
95
|
validations:
|
|
63
96
|
required: true
|
|
64
97
|
- type: textarea
|
|
65
98
|
id: open-questions
|
|
66
99
|
attributes:
|
|
67
100
|
label: Open Questions & Assumptions
|
|
68
|
-
description:
|
|
101
|
+
description: List each one with its options, your recommendation, and the default if nobody answers.
|
|
69
102
|
- type: textarea
|
|
70
103
|
id: breaking-changes
|
|
71
104
|
attributes:
|
|
@@ -81,7 +114,7 @@ body:
|
|
|
81
114
|
attributes:
|
|
82
115
|
label: References
|
|
83
116
|
description: |
|
|
84
|
-
The plan reads `**Parent design:**` and `**Audit reports:**` lines
|
|
117
|
+
The plan reads the `**Parent design:**` and `**Audit reports:**` lines. The build refuses to start while an issue in the blocked-by block is open. Write these lines and the blocked-by block exactly as shown. Nothing fetches the other references, so use exact paths, ledger `key`s, and issue numbers with their titles.
|
|
85
118
|
placeholder: |
|
|
86
119
|
**Parent design:** [42-offline-sync-design.md](https://github.com/<owner>/<repo>/blob/dev/docs/plans/202610/42-offline-sync-design.md)
|
|
87
120
|
**Audit reports:** docs/audits/202610/security.md (findings security-3, security-5)
|
|
@@ -8,7 +8,7 @@ body:
|
|
|
8
8
|
- type: markdown
|
|
9
9
|
attributes:
|
|
10
10
|
value: |
|
|
11
|
-
Next step: `/bkit-design #<issue number>`. Design asks only what this issue leaves open, so every decision you settle here is one question fewer. Keep the title short
|
|
11
|
+
Next step: `/bkit-design #<issue number>`. Design asks only about what this issue leaves open, so every decision you settle here is one question fewer. Keep the title short. It names the feature folder, and it is not read as input.
|
|
12
12
|
- type: textarea
|
|
13
13
|
id: problem
|
|
14
14
|
attributes:
|
|
@@ -27,7 +27,7 @@ body:
|
|
|
27
27
|
id: success-criteria
|
|
28
28
|
attributes:
|
|
29
29
|
label: Success criteria
|
|
30
|
-
description: Up to five outcomes you could measure.
|
|
30
|
+
description: Up to five outcomes you could measure. List outcomes, not steps.
|
|
31
31
|
placeholder: |
|
|
32
32
|
- A user who saves an item sees it in the list within 2s
|
|
33
33
|
- type: textarea
|
|
@@ -49,7 +49,7 @@ body:
|
|
|
49
49
|
id: references
|
|
50
50
|
attributes:
|
|
51
51
|
label: References
|
|
52
|
-
description: Related issues with their
|
|
52
|
+
description: Related issues with their titles, earlier attempts, docs paths, and ledger rows by `key`. Nothing fetches these, so write exact paths and keys that agents can search for.
|
|
53
53
|
placeholder: |
|
|
54
54
|
Related: #<number> — <its title>
|
|
55
55
|
Docs: docs/architecture.md § Sync
|
|
@@ -35,12 +35,17 @@
|
|
|
35
35
|
// `dev`'s config over `main`'s for dev-targeted runs, so config edits on `dev`
|
|
36
36
|
// apply to them. This option is itself read from `main`, so it needs one merge
|
|
37
37
|
// to `main` before dev-side config edits apply.
|
|
38
|
+
// The merge appends list options (`customManagers`, `packageRules`) instead of
|
|
39
|
+
// replacing them: each custom manager runs twice, so the dashboard lists its
|
|
40
|
+
// files twice and the run logs "Cannot find replaceString" for the second pass.
|
|
41
|
+
// PRs still open once. A rule deleted on `dev` keeps applying until `main` drops it.
|
|
38
42
|
// See docs/deployments.md § Dependency updaters.
|
|
39
43
|
useBaseBranchConfig: "merge",
|
|
40
44
|
|
|
41
|
-
// Weekly batched runs
|
|
42
|
-
//
|
|
43
|
-
|
|
45
|
+
// Weekly batched runs: every hour of Monday (UTC). The daily bkit-renovate.yml cron
|
|
46
|
+
// can start hours after its set time, so a window of a few hours would miss it.
|
|
47
|
+
// CVE-driven updates are not held to this schedule (`osvVulnerabilityAlerts` below).
|
|
48
|
+
schedule: ["* * * * 1"],
|
|
44
49
|
timezone: "UTC",
|
|
45
50
|
|
|
46
51
|
// CVE alerts → Renovate opens a PR immediately, outside the weekly schedule.
|
|
@@ -71,10 +76,11 @@
|
|
|
71
76
|
|
|
72
77
|
// Lockfile maintenance — picks up indirect-dependency updates that a
|
|
73
78
|
// direct-dependency bump alone wouldn't catch. Monthly: it rewrites the whole
|
|
74
|
-
// lockfile, so a weekly PR is mostly churn.
|
|
79
|
+
// lockfile, so a weekly PR is mostly churn. Every hour of the 1st (UTC), for the
|
|
80
|
+
// same late-start reason as `schedule` above.
|
|
75
81
|
lockFileMaintenance: {
|
|
76
82
|
enabled: true,
|
|
77
|
-
schedule: ["
|
|
83
|
+
schedule: ["* * 1 * *"],
|
|
78
84
|
},
|
|
79
85
|
|
|
80
86
|
// Rebase a Renovate PR only when it conflicts. The default re-bases every open PR
|
|
@@ -123,7 +129,8 @@
|
|
|
123
129
|
// bash "$RUNNER_TEMP/download-actionlint.bash" 1.7.12 (installer-script version argument)
|
|
124
130
|
// Pins paired with a checksum (Vale, gh, jq, Node, actionlint) get the new VERSION
|
|
125
131
|
// from Renovate, but the sha256 beside it stays old: update it by hand in the same
|
|
126
|
-
// PR, or the install fails closed.
|
|
132
|
+
// PR, or the install fails closed. CI's Check Pinned Checksums step (`bkit ci pins`)
|
|
133
|
+
// fails the PR until it matches. See the NOTE in the docker images rule below.
|
|
127
134
|
// ─────────────────────────────────────────────────────────────────────
|
|
128
135
|
customManagers: [
|
|
129
136
|
{
|
|
@@ -294,6 +301,27 @@
|
|
|
294
301
|
groupName: "docker images",
|
|
295
302
|
automerge: false,
|
|
296
303
|
},
|
|
304
|
+
|
|
305
|
+
// ─────────────────────────────────────────────────────────────────────
|
|
306
|
+
// Pins the `customManagers` entry finds (Dockerfile, bkit-cloud.md, workflows,
|
|
307
|
+
// scripts) land in ONE reviewed PR, so their hand-edited checksums are fixed
|
|
308
|
+
// once. The Dockerfile pnpm pin instead joins the non-major group, so it moves
|
|
309
|
+
// in the same PR as `packageManager` in package.json.
|
|
310
|
+
// ─────────────────────────────────────────────────────────────────────
|
|
311
|
+
{
|
|
312
|
+
matchManagers: ["custom.regex"],
|
|
313
|
+
groupName: "pinned tools",
|
|
314
|
+
automerge: false,
|
|
315
|
+
},
|
|
316
|
+
{
|
|
317
|
+
matchManagers: ["custom.regex"],
|
|
318
|
+
matchDepNames: ["pnpm"],
|
|
319
|
+
matchUpdateTypes: ["minor", "patch"],
|
|
320
|
+
groupName: "non-major dependencies",
|
|
321
|
+
automerge: true,
|
|
322
|
+
automergeType: "pr",
|
|
323
|
+
platformAutomerge: true,
|
|
324
|
+
},
|
|
297
325
|
],
|
|
298
326
|
|
|
299
327
|
// Where to send PRs. `dev` per baseBranchPatterns above.
|