@cbartens/bkit 6.1.1 → 6.2.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 +14 -12
- package/.bkit/core/.agents/docs.md +1 -11
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +30 -9
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +25 -27
- package/.bkit/core/.agents/rules.md +22 -9
- package/.bkit/core/.bkit/README.md +13 -11
- package/.bkit/core/.bkit/authoring.md +58 -13
- package/.bkit/core/.bkit/cli.md +42 -32
- package/.bkit/core/.bkit/cloud.md +93 -30
- package/.bkit/core/.bkit/install.md +55 -16
- package/.bkit/core/.bkit/jsonl.md +24 -7
- package/.bkit/core/.bkit/pipeline.md +8 -8
- package/.bkit/core/.bkit/prompts.md +160 -43
- package/.bkit/core/.bkit/providers.md +97 -36
- package/.bkit/core/.bkit/templates.md +162 -34
- package/.bkit/core/.bkit/trackers.md +39 -6
- package/.bkit/core/.bkit/workflows.md +344 -136
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +50 -27
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +11 -11
- package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +13 -8
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +14 -25
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +20 -9
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +8 -8
- package/.bkit/core/.opencode/plugin/bkit-gateguard.js +14 -4
- package/.bkit/core/.opencode/plugin/bkit-guardrails.js +114 -0
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +30 -6
- package/.bkit/core/docs/templates/bkit-audit-agents.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +2 -2
- package/.bkit/core/docs/templates/bkit-audit-config.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-cost.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-database.md +3 -3
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +3 -3
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +32 -2
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-failures.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +2 -2
- package/.bkit/core/docs/templates/bkit-audit-gates.md +5 -3
- package/.bkit/core/docs/templates/bkit-audit-issues.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-llm.md +2 -2
- package/.bkit/core/docs/templates/bkit-audit-logs.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-models.md +2 -2
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +2 -2
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-repo.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-security.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-slop.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-testing.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-usability.md +1 -1
- package/.bkit/core/docs/templates/bkit-plan.md +38 -8
- package/.bkit/core/engine/checks/after/auth.ts +118 -47
- package/.bkit/core/engine/checks/after/github.ts +89 -37
- package/.bkit/core/engine/checks/after/index.ts +15 -3
- package/.bkit/core/engine/checks/after/tools.ts +245 -1
- package/.bkit/core/engine/checks/before/files.ts +59 -1
- package/.bkit/core/engine/checks/before/index.ts +8 -0
- package/.bkit/core/engine/checks/status-holes.ts +20 -26
- package/.bkit/core/engine/checks/tips/catalogue.ts +107 -10
- package/.bkit/core/engine/checks/tips/detect.ts +36 -3
- package/.bkit/core/engine/checks/tips/index.ts +1 -1
- package/.bkit/core/engine/cli.ts +13 -13
- package/.bkit/core/engine/commands/ci/ci.ts +64 -11
- package/.bkit/core/engine/commands/ci/push-gate.ts +101 -43
- package/.bkit/core/engine/commands/install/install.ts +28 -25
- package/.bkit/core/engine/commands/install/uninstall.ts +42 -30
- package/.bkit/core/engine/commands/install/upgrade.ts +14 -2
- package/.bkit/core/engine/commands/land.ts +2 -3
- package/.bkit/core/engine/commands/lib.ts +394 -39
- package/.bkit/core/engine/commands/registry.ts +1 -1
- package/.bkit/core/engine/commands/workflow/branches.ts +351 -78
- package/.bkit/core/engine/commands/workflow/challenge.ts +63 -14
- package/.bkit/core/engine/commands/workflow/context.ts +71 -10
- package/.bkit/core/engine/commands/workflow/counters.ts +298 -23
- package/.bkit/core/engine/commands/workflow/decisions.ts +260 -125
- package/.bkit/core/engine/commands/workflow/disk.ts +2 -1
- package/.bkit/core/engine/commands/workflow/feature-base.ts +66 -0
- package/.bkit/core/engine/commands/workflow/issues.ts +312 -17
- package/.bkit/core/engine/commands/workflow/junit.ts +204 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +904 -99
- package/.bkit/core/engine/commands/workflow/locks.ts +186 -29
- package/.bkit/core/engine/commands/workflow/loops.ts +87 -0
- package/.bkit/core/engine/commands/workflow/open-decision.ts +251 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +8 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +1 -1
- package/.bkit/core/engine/commands/workflow/prs.ts +311 -16
- package/.bkit/core/engine/commands/workflow/repo.ts +1 -1
- package/.bkit/core/engine/commands/workflow/run-facts.ts +6 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +877 -174
- package/.bkit/core/engine/commands/workflow/runtime.ts +12 -4
- package/.bkit/core/engine/commands/workflow/status.ts +324 -11
- package/.bkit/core/engine/commands/workflow/step-table.ts +41 -15
- package/.bkit/core/engine/commands/workflow/steps.ts +604 -29
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +1 -1
- package/.bkit/core/engine/commands/workflow/summary.ts +314 -8
- package/.bkit/core/engine/commands/workflow/tasks.ts +400 -27
- package/.bkit/core/engine/commands/workflow/tests-base.ts +319 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +138 -74
- package/.bkit/core/engine/commands/workflow/tests-jump.ts +93 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +815 -182
- package/.bkit/core/engine/commands/workflow/tracker.ts +1134 -137
- package/.bkit/core/engine/commands/workflow/workflows.ts +100 -72
- package/.bkit/core/engine/commands/workflow/worktrees.ts +421 -57
- package/.bkit/core/engine/install/cloud-env.ts +38 -10
- package/.bkit/core/engine/install/managed-block.ts +105 -0
- package/.bkit/core/engine/install/manifest.ts +7 -1
- package/.bkit/core/engine/install/modules/claude.ts +6 -2
- package/.bkit/core/engine/install/modules/cloud.ts +84 -95
- package/.bkit/core/engine/install/modules/codex.ts +10 -2
- package/.bkit/core/engine/install/modules/core.ts +148 -14
- package/.bkit/core/engine/install/modules/opencode.ts +18 -23
- package/.bkit/core/engine/install/network-allowlist.ts +8 -3
- package/.bkit/core/engine/install/project-docs.ts +650 -0
- package/.bkit/core/engine/install/template-copies.ts +58 -5
- package/.bkit/core/engine/install/write.ts +128 -7
- package/.bkit/core/engine/ledgers/journal.ts +18 -10
- package/.bkit/core/engine/ledgers/migrate.ts +20 -8
- package/.bkit/core/engine/ledgers/status.ts +604 -8
- package/.bkit/core/engine/ledgers/telemetry.ts +115 -13
- package/.bkit/core/engine/render/trackers.ts +3 -1
- package/.bkit/core/engine/shared/package-manager.ts +7 -3
- package/.bkit/core/engine/shared/settings.ts +12 -1
- package/.bkit/core/engine/shared/text.ts +14 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +1 -0
- package/.bkit/core/engine/tools/instructions.ts +116 -20
- package/.bkit/core/hooks/antigravity-hook.js +20 -4
- package/.bkit/core/hooks/gateguard-edit-payload.js +8 -5
- package/.bkit/core/hooks/gateguard-engine.js +249 -23
- package/.bkit/core/hooks/guardrails-deny.js +167 -0
- package/.bkit/core/hooks/guardrails-read.js +3 -3
- package/.bkit/core/hooks/guardrails-shell.js +1122 -167
- package/.bkit/core/hooks/guardrails-tiers.js +247 -176
- package/.bkit/core/hooks/preflight-tracker.sh +219 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +23 -6
- package/.bkit/core/prompts/bkit-build-challenge-1.md +5 -4
- package/.bkit/core/prompts/bkit-build-challenge-2.md +6 -5
- package/.bkit/core/prompts/bkit-build-install-skills.md +2 -2
- package/.bkit/core/prompts/bkit-build-plan-convert.md +21 -7
- package/.bkit/core/prompts/bkit-build-plan-current.md +5 -4
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +22 -17
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +16 -12
- package/.bkit/core/prompts/bkit-build-plan-tests.md +14 -10
- package/.bkit/core/prompts/bkit-build-plan-verify.md +21 -8
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +10 -5
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +22 -6
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +19 -3
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +22 -6
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +10 -7
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +3 -3
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +4 -4
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +3 -3
- package/.bkit/core/prompts/bkit-design-generate.md +6 -4
- package/.bkit/core/prompts/bkit-design-organise.md +4 -3
- package/.bkit/core/prompts/bkit-design-review-1.md +5 -4
- package/.bkit/core/prompts/bkit-design-review-2.md +6 -5
- package/.bkit/core/prompts/bkit-design-spike.md +4 -3
- package/.bkit/core/prompts/bkit-design-update.md +6 -4
- package/.bkit/core/prompts/bkit-plan-generate.md +35 -14
- package/.bkit/core/prompts/bkit-plan-review-1.md +9 -7
- package/.bkit/core/prompts/bkit-plan-review-2.md +9 -7
- package/.bkit/core/prompts/bkit-plan-scope-check.md +8 -6
- package/.bkit/core/prompts/bkit-plan-update.md +22 -8
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +11 -8
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +9 -5
- package/.bkit/core/prompts/bkit-ship-update-docs.md +26 -4
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +3 -3
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +10 -7
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +8 -5
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +31 -7
- package/.bkit/core/prompts/bkit-utility-update-failures.md +8 -5
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +10 -7
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +4 -4
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +4 -4
- package/.bkit/core/workflows/bkit-auto.md +23 -11
- package/.bkit/core/workflows/bkit-build.md +331 -100
- package/.bkit/core/workflows/bkit-debug.md +135 -64
- package/.bkit/core/workflows/bkit-design.md +58 -32
- package/.bkit/core/workflows/bkit-plan.md +73 -45
- package/.bkit/core/workflows/bkit-ship.md +233 -167
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +1 -1
- package/.bkit/shared/.bkit/.env.example +5 -0
- package/.bkit/shared/.claude/bkit-cloud.md +7 -7
- package/.bkit/shared/.claude/settings.json +5 -1
- package/.bkit/shared/.cursor/bkit-cloud.md +1 -1
- package/.bkit/shared/.cursor/hooks.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +11 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +27 -0
- package/.bkit/templates/.cursor/Dockerfile +7 -7
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +1 -1
- package/.bkit/templates/.github/dependabot.yml +5 -0
- package/.bkit/templates/.github/renovate.json5 +5 -3
- package/.bkit/templates/.github/workflows/bkit-ci.yml +11 -11
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +525 -161
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +2 -2
- package/.bkit/templates/.husky/pre-push +123 -6
- package/.bkit/templates/context/bkit-serena.md +1 -1
- package/.bkit/templates/docs/architecture.md +98 -0
- package/.bkit/templates/docs/capabilities.md +33 -37
- package/.bkit/templates/docs/components.md +142 -0
- package/.bkit/templates/docs/data-schema.md +87 -0
- package/.bkit/{shared → templates}/docs/deployments.md +128 -142
- package/.bkit/templates/docs/design.md +117 -0
- package/.bkit/templates/docs/noise.md +54 -0
- package/.bkit/templates/docs/observability.md +99 -0
- package/.bkit/templates/docs/security.md +137 -0
- package/.bkit/templates/docs/setup.md +93 -0
- package/.bkit/templates/docs/technology.md +70 -0
- package/.bkit/{shared → templates}/docs/testing.md +200 -87
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +511 -103
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +228 -35
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +270 -2
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +92 -63
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +59 -11
- package/.bkit/templates/slop-scan.config.json +2 -0
- package/CHANGELOG.md +64 -0
- package/DETAILS.md +24 -19
- package/README.md +1 -1
- package/dist/checks/after/auth.js +114 -46
- package/dist/checks/after/github.js +77 -35
- package/dist/checks/after/index.js +12 -3
- package/dist/checks/after/tools.js +224 -1
- package/dist/checks/before/files.js +59 -1
- package/dist/checks/before/index.js +7 -1
- package/dist/checks/status-holes.js +20 -21
- package/dist/checks/tips/catalogue.js +99 -10
- package/dist/checks/tips/detect.js +35 -3
- package/dist/checks/tips/index.js +1 -1
- package/dist/cli.js +13 -13
- package/dist/commands/ci/ci.js +56 -12
- package/dist/commands/ci/push-gate.js +79 -44
- package/dist/commands/install/install.js +23 -22
- package/dist/commands/install/uninstall.js +36 -30
- package/dist/commands/install/upgrade.js +10 -2
- package/dist/commands/land.js +2 -3
- package/dist/commands/lib.js +323 -25
- package/dist/commands/workflow/branches.js +312 -72
- package/dist/commands/workflow/challenge.js +66 -13
- package/dist/commands/workflow/context.js +46 -10
- package/dist/commands/workflow/counters.js +231 -23
- package/dist/commands/workflow/decisions.js +221 -106
- package/dist/commands/workflow/disk.js +2 -1
- package/dist/commands/workflow/feature-base.js +60 -0
- package/dist/commands/workflow/issues.js +243 -15
- package/dist/commands/workflow/junit.js +137 -0
- package/dist/commands/workflow/ledgers.js +726 -112
- package/dist/commands/workflow/locks.js +150 -29
- package/dist/commands/workflow/loops.js +67 -0
- package/dist/commands/workflow/open-decision.js +199 -0
- package/dist/commands/workflow/plan-blocks.js +6 -0
- package/dist/commands/workflow/plans.js +1 -1
- package/dist/commands/workflow/prs.js +272 -16
- package/dist/commands/workflow/repo.js +1 -1
- package/dist/commands/workflow/run-facts.js +6 -0
- package/dist/commands/workflow/runs.js +747 -155
- package/dist/commands/workflow/runtime.js +8 -4
- package/dist/commands/workflow/status.js +259 -13
- package/dist/commands/workflow/step-table.js +41 -15
- package/dist/commands/workflow/steps.js +530 -26
- package/dist/commands/workflow/summary-findings.js +1 -1
- package/dist/commands/workflow/summary.js +289 -8
- package/dist/commands/workflow/tasks.js +294 -27
- package/dist/commands/workflow/tests-base.js +266 -0
- package/dist/commands/workflow/tests-changed.js +130 -56
- package/dist/commands/workflow/tests-jump.js +77 -0
- package/dist/commands/workflow/tests.js +608 -131
- package/dist/commands/workflow/tracker.js +920 -112
- package/dist/commands/workflow/workflows.js +80 -59
- package/dist/commands/workflow/worktrees.js +387 -58
- package/dist/install/cloud-env.js +32 -10
- package/dist/install/managed-block.js +101 -0
- package/dist/install/manifest.js +7 -1
- package/dist/install/modules/claude.js +6 -2
- package/dist/install/modules/cloud.js +73 -86
- package/dist/install/modules/codex.js +9 -2
- package/dist/install/modules/core.js +133 -14
- package/dist/install/modules/opencode.js +18 -23
- package/dist/install/network-allowlist.js +8 -3
- package/dist/install/project-docs.js +551 -0
- package/dist/install/template-copies.js +55 -5
- package/dist/install/write.js +117 -5
- package/dist/ledgers/journal.js +10 -8
- package/dist/ledgers/migrate.js +20 -9
- package/dist/ledgers/status.js +461 -8
- package/dist/ledgers/telemetry.js +71 -13
- package/dist/render/trackers.js +3 -1
- package/dist/shared/package-manager.js +7 -2
- package/dist/shared/settings.js +8 -0
- package/dist/shared/text.js +13 -0
- package/dist/tools/instructions-sources.js +1 -0
- package/dist/tools/instructions.js +97 -24
- package/package.json +22 -15
- package/.bkit/core/hooks/preflight-linear.sh +0 -73
- package/.bkit/shared/docs/architecture.md +0 -16
- package/.bkit/shared/docs/data-schema.md +0 -16
- package/.bkit/shared/docs/design.md +0 -38
- package/.bkit/shared/docs/noise.md +0 -20
- package/.bkit/shared/docs/observability.md +0 -22
- package/.bkit/shared/docs/security.md +0 -62
- package/.bkit/shared/docs/setup.md +0 -52
- package/.bkit/shared/docs/technology.md +0 -15
- /package/.bkit/templates/{.lintstagedrc.json → lintstagedrc.example.json} +0 -0
- /package/.bkit/templates/{.prettierignore → prettierignore.example} +0 -0
|
@@ -4,6 +4,10 @@ import * as fs from "node:fs";
|
|
|
4
4
|
import * as path from "node:path";
|
|
5
5
|
import { spawnSync } from "node:child_process";
|
|
6
6
|
import { readPackageJson } from "../../shared/package-json.js";
|
|
7
|
+
import { readTextFile } from "../../shared/json.js";
|
|
8
|
+
import { getPkgRoot } from "../../shared/package-roots.js";
|
|
9
|
+
import { PROJECT_DOC_TOPICS, PROJECT_INDEX_PATH, findIndexedEquivalent, listIndexedEquivalents, inspectRepoFile, isInTreePath, legacyStarterTopic, normalizeLegacyText, projectDocPath, readProjectIndex, starterPath, } from "../../install/project-docs.js";
|
|
10
|
+
import { stripManagedWrapper } from "../../install/managed-block.js";
|
|
7
11
|
import { ciWorkflowPath, readBkitConfig } from "../../shared/settings.js";
|
|
8
12
|
import { DEP_UPDATER_NAMES, findDepUpdaterConfigs, } from "../../shared/dep-updater.js";
|
|
9
13
|
/** True when `cmd --version` runs (binary on PATH, exits 0). */
|
|
@@ -218,7 +222,7 @@ export function detectBkitStubs(cwd) {
|
|
|
218
222
|
severity: "advisory",
|
|
219
223
|
detect: `${ciRel} contains the bkit-stub:${stub.id} sentinel — a commented-in block shipped disabled by default.`,
|
|
220
224
|
action: `${stub.description}\n\n` +
|
|
221
|
-
`Before enabling a CI lane, read docs/testing.md § CI test tiers and docs/deployments.md (one run per branch, push base
|
|
225
|
+
`Before enabling a CI lane, read docs/testing.md § CI test tiers and docs/deployments.md (one run per branch, push base). The FULL CI SCAFFOLD REFERENCE in ${ciRel} is the job graph: needs, if, step names. Write the job from that graph and from those docs. Uncomment only a block that is already commented YAML or shell.\n\n` +
|
|
222
226
|
`Decide with the user: (a) enable — uncomment the YAML/shell block AND delete the \`# bkit-stub:${stub.id} — ...\` header line; (b) customise — adjust paths/secrets/conditions before uncommenting; (c) dismiss — delete the entire stub block (header + commented body).\n\n` +
|
|
223
227
|
`Until the sentinel is removed, this advisory fires every install / check.`,
|
|
224
228
|
});
|
|
@@ -333,3 +337,222 @@ export function buildDepUpdaterSetupAdvisory(cwd) {
|
|
|
333
337
|
'Use one updater, not both, and set `bkit.dependencies.updater` to its name (`"renovate"` or `"dependabot"`) in package.json. To silence this advisory, set it to `"none"`. See .bkit/templates.md.',
|
|
334
338
|
};
|
|
335
339
|
}
|
|
340
|
+
// ---------------------------------------------------------------------------
|
|
341
|
+
// Project documentation adoption and population
|
|
342
|
+
// ---------------------------------------------------------------------------
|
|
343
|
+
/**
|
|
344
|
+
* `docs/components.md` is checked beside the ten topics, at its own path only: an indexed
|
|
345
|
+
* equivalent does not count for it, and `bkit upgrade` adds no index row for it.
|
|
346
|
+
*/
|
|
347
|
+
const COMPONENTS_DOC = "components";
|
|
348
|
+
const COMPONENTS_DOC_PATH = `docs/${COMPONENTS_DOC}.md`;
|
|
349
|
+
/** How every hand-filled starter's introduction opens. A filled document no longer has it. */
|
|
350
|
+
const STARTER_OPENER = "> Starter document.";
|
|
351
|
+
/** Text of a starter: the package copy first, then the consumer's own copy. */
|
|
352
|
+
function readStarterText(cwd, name) {
|
|
353
|
+
const rel = name === COMPONENTS_DOC ? `.bkit/templates/${COMPONENTS_DOC_PATH}` : starterPath(name);
|
|
354
|
+
for (const base of [getPkgRoot(), cwd]) {
|
|
355
|
+
const read = readTextFile(path.join(base, rel));
|
|
356
|
+
if (read.ok)
|
|
357
|
+
return read.text;
|
|
358
|
+
}
|
|
359
|
+
return null;
|
|
360
|
+
}
|
|
361
|
+
/**
|
|
362
|
+
* Mechanical read of a project document: empty, an untouched starter, a document that still
|
|
363
|
+
* opens with the starter's introduction, headings only, or a candidate.
|
|
364
|
+
*/
|
|
365
|
+
function assessDocText(cwd, name, text) {
|
|
366
|
+
if (text.trim() === "")
|
|
367
|
+
return "empty";
|
|
368
|
+
const normalized = normalizeLegacyText(text);
|
|
369
|
+
const legacy = legacyStarterTopic(text);
|
|
370
|
+
if (legacy === name)
|
|
371
|
+
return "unpopulated";
|
|
372
|
+
const starter = readStarterText(cwd, name);
|
|
373
|
+
if (starter !== null && normalizeLegacyText(starter) === normalized)
|
|
374
|
+
return "unpopulated";
|
|
375
|
+
if (normalized.startsWith(STARTER_OPENER))
|
|
376
|
+
return "unpopulated";
|
|
377
|
+
// Headings, comments and rules only: nothing a project wrote.
|
|
378
|
+
const meaningful = normalized
|
|
379
|
+
.split("\n")
|
|
380
|
+
.map((l) => l.trim())
|
|
381
|
+
.filter((l) => l !== "" && !l.startsWith("#") && !/^<!--.*-->$/.test(l) && !/^[-*_|: ]+$/.test(l));
|
|
382
|
+
return meaningful.length === 0 ? "unpopulated" : "candidate";
|
|
383
|
+
}
|
|
384
|
+
/**
|
|
385
|
+
* Report the state of the ten project documents (`docs/architecture.md` ... `docs/setup.md`):
|
|
386
|
+
* the index missing, a document absent, empty, an untouched starter, still opening with the
|
|
387
|
+
* starter's introduction, present but unindexed, or unreadable. A document the index lists at
|
|
388
|
+
* another path (same basename, or a Scope cell `Equivalent to docs/<topic>.md`) counts for its
|
|
389
|
+
* topic. `docs/components.md` is reported too when it is absent or unfilled. Findings are
|
|
390
|
+
* advisories only and read no file outside the repository. A document that differs from every
|
|
391
|
+
* starter is a candidate for the agent to assess; the mechanical read makes no claim about
|
|
392
|
+
* what it covers.
|
|
393
|
+
*/
|
|
394
|
+
export function detectProjectDocs(cwd) {
|
|
395
|
+
const index = readProjectIndex(cwd);
|
|
396
|
+
const rows = index.status === "ok" ? index.rows : [];
|
|
397
|
+
const indexedPaths = new Set(rows.map((r) => r.path));
|
|
398
|
+
const missing = [];
|
|
399
|
+
const unpopulated = [];
|
|
400
|
+
const unindexed = [];
|
|
401
|
+
const unindexedWrapped = [];
|
|
402
|
+
const unindexedBlocked = [];
|
|
403
|
+
const duplicates = [];
|
|
404
|
+
const ambiguous = [];
|
|
405
|
+
const cleanup = [];
|
|
406
|
+
const componentsState = inspectRepoFile(cwd, COMPONENTS_DOC_PATH);
|
|
407
|
+
if (componentsState === "absent")
|
|
408
|
+
missing.push(COMPONENTS_DOC_PATH);
|
|
409
|
+
else if (componentsState !== "regular") {
|
|
410
|
+
ambiguous.push(`${COMPONENTS_DOC_PATH} (${componentsState.unsafe})`);
|
|
411
|
+
}
|
|
412
|
+
else {
|
|
413
|
+
const read = readTextFile(path.join(cwd, COMPONENTS_DOC_PATH));
|
|
414
|
+
if (!read.ok)
|
|
415
|
+
ambiguous.push(`${COMPONENTS_DOC_PATH} (it could not be read)`);
|
|
416
|
+
else if (assessDocText(cwd, COMPONENTS_DOC, read.text) !== "candidate") {
|
|
417
|
+
unpopulated.push(COMPONENTS_DOC_PATH);
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
for (const topic of PROJECT_DOC_TOPICS) {
|
|
421
|
+
const recommended = projectDocPath(topic);
|
|
422
|
+
const isUsableRow = (row) => isInTreePath(row) && inspectRepoFile(cwd, row) === "regular";
|
|
423
|
+
// The first valid same-topic row wins; when none is valid every candidate row is named.
|
|
424
|
+
const equivalent = findIndexedEquivalent(rows, topic, isUsableRow);
|
|
425
|
+
const candidates = listIndexedEquivalents(rows, topic);
|
|
426
|
+
const defaultState = inspectRepoFile(cwd, recommended);
|
|
427
|
+
let target = recommended;
|
|
428
|
+
if (defaultState === "absent") {
|
|
429
|
+
if (equivalent === null) {
|
|
430
|
+
if (candidates.length > 0) {
|
|
431
|
+
ambiguous.push(`${candidates.join(", ")} (${recommended}: every indexed row for it is unusable)`);
|
|
432
|
+
}
|
|
433
|
+
else {
|
|
434
|
+
missing.push(recommended);
|
|
435
|
+
}
|
|
436
|
+
continue;
|
|
437
|
+
}
|
|
438
|
+
target = equivalent;
|
|
439
|
+
}
|
|
440
|
+
if (!isInTreePath(target)) {
|
|
441
|
+
ambiguous.push(`${target} (${recommended}: it resolves outside the repository)`);
|
|
442
|
+
continue;
|
|
443
|
+
}
|
|
444
|
+
const state = target === recommended ? defaultState : inspectRepoFile(cwd, target);
|
|
445
|
+
if (state === "absent") {
|
|
446
|
+
missing.push(recommended);
|
|
447
|
+
continue;
|
|
448
|
+
}
|
|
449
|
+
if (state !== "regular") {
|
|
450
|
+
ambiguous.push(`${target} (${state.unsafe})`);
|
|
451
|
+
continue;
|
|
452
|
+
}
|
|
453
|
+
const read = readTextFile(path.join(cwd, target));
|
|
454
|
+
if (!read.ok) {
|
|
455
|
+
ambiguous.push(`${target} (it could not be read)`);
|
|
456
|
+
continue;
|
|
457
|
+
}
|
|
458
|
+
const wrapper = stripManagedWrapper(read.text);
|
|
459
|
+
if (wrapper.status === "ambiguous")
|
|
460
|
+
cleanup.push(`${target} (${wrapper.problem})`);
|
|
461
|
+
const assessed = assessDocText(cwd, topic, read.text);
|
|
462
|
+
if (assessed === "empty" || assessed === "unpopulated")
|
|
463
|
+
unpopulated.push(target);
|
|
464
|
+
else if (index.status === "ok" && !indexedPaths.has(target)) {
|
|
465
|
+
const covering = findIndexedEquivalent(rows, topic, (row) => isInTreePath(row) && inspectRepoFile(cwd, row) === "regular");
|
|
466
|
+
if (covering !== null && target === recommended)
|
|
467
|
+
duplicates.push(`${target} (beside ${covering})`);
|
|
468
|
+
else if (wrapper.status === "ambiguous")
|
|
469
|
+
unindexedWrapped.push(target);
|
|
470
|
+
else if ((index.unparsed ?? []).length > 0)
|
|
471
|
+
unindexedBlocked.push(target);
|
|
472
|
+
else
|
|
473
|
+
unindexed.push(target);
|
|
474
|
+
}
|
|
475
|
+
}
|
|
476
|
+
const findings = [];
|
|
477
|
+
if (index.status === "missing") {
|
|
478
|
+
findings.push({
|
|
479
|
+
id: "project-docs-index-missing",
|
|
480
|
+
severity: "advisory",
|
|
481
|
+
detect: `${PROJECT_INDEX_PATH} is absent, so agents have no list of the project's own documents to consult.`,
|
|
482
|
+
action: `Run \`bkit install\` to write ${PROJECT_INDEX_PATH}, then add a row under \`## Project Documents\` for each project document you keep. Until then agents warn and fall back to repository evidence.`,
|
|
483
|
+
});
|
|
484
|
+
}
|
|
485
|
+
else if (index.status === "unreadable") {
|
|
486
|
+
ambiguous.push(`${PROJECT_INDEX_PATH} (${index.reason})`);
|
|
487
|
+
}
|
|
488
|
+
else {
|
|
489
|
+
for (const row of index.unparsed ?? []) {
|
|
490
|
+
ambiguous.push(`${PROJECT_INDEX_PATH} (unreadable table row: ${row.slice(0, 80)})`);
|
|
491
|
+
}
|
|
492
|
+
}
|
|
493
|
+
if (missing.length > 0) {
|
|
494
|
+
findings.push({
|
|
495
|
+
id: "project-docs-missing",
|
|
496
|
+
severity: "advisory",
|
|
497
|
+
detect: `No project document covers: ${missing.join(", ")}.`,
|
|
498
|
+
action: `Copy the starter for each topic you want from \`.bkit/templates/docs/\` into \`docs/\`, fill it in from the repository, and add its row to \`## Project Documents\` in ${PROJECT_INDEX_PATH}. A document you already keep elsewhere counts: index it with \`Equivalent to <recommended path>\` in its Scope cell. Skip topics that do not apply. Fill the docs in the order of .bkit/templates.md § Project docs — adoption order.`,
|
|
499
|
+
});
|
|
500
|
+
}
|
|
501
|
+
if (unpopulated.length > 0) {
|
|
502
|
+
findings.push({
|
|
503
|
+
id: "project-docs-unpopulated",
|
|
504
|
+
severity: "advisory",
|
|
505
|
+
detect: `These project documents are empty, still hold only the shipped starter text, or still open with the starter's introduction: ${unpopulated.join(", ")}.`,
|
|
506
|
+
action: `Replace the placeholders in ${unpopulated.join(", ")} with project facts taken from the repository, then delete the introduction above the title. Or index an equivalent document that already holds the facts (\`Equivalent to <recommended path>\` in the Scope cell of ${PROJECT_INDEX_PATH}). Agents warn about these topics until the text changes. Fill the docs in the order of .bkit/templates.md § Project docs — adoption order.`,
|
|
507
|
+
});
|
|
508
|
+
}
|
|
509
|
+
if (unindexed.length > 0) {
|
|
510
|
+
findings.push({
|
|
511
|
+
id: "project-docs-unindexed",
|
|
512
|
+
severity: "advisory",
|
|
513
|
+
detect: `These project documents exist but ${PROJECT_INDEX_PATH} does not list them: ${unindexed.join(", ")}.`,
|
|
514
|
+
action: `Add a row for each to \`## Project Documents\` in ${PROJECT_INDEX_PATH}, or run \`bkit upgrade\` to register the default paths.`,
|
|
515
|
+
});
|
|
516
|
+
}
|
|
517
|
+
if (unindexedWrapped.length > 0) {
|
|
518
|
+
findings.push({
|
|
519
|
+
id: "project-docs-unindexed",
|
|
520
|
+
severity: "advisory",
|
|
521
|
+
detect: `These project documents exist but ${PROJECT_INDEX_PATH} does not list them, and bkit will not register them while their ownership wrapper stays: ${unindexedWrapped.join(", ")}.`,
|
|
522
|
+
action: `Remove the wrapper as the cleanup advisory describes, then add a row for each to \`## Project Documents\` in ${PROJECT_INDEX_PATH} (or run \`bkit upgrade\` once the wrapper is gone).`,
|
|
523
|
+
});
|
|
524
|
+
}
|
|
525
|
+
if (unindexedBlocked.length > 0) {
|
|
526
|
+
findings.push({
|
|
527
|
+
id: "project-docs-unindexed",
|
|
528
|
+
severity: "advisory",
|
|
529
|
+
detect: `These project documents exist but ${PROJECT_INDEX_PATH} does not list them, and bkit will not register them while a row of \`## Project Documents\` is unreadable: ${unindexedBlocked.join(", ")}.`,
|
|
530
|
+
action: `Repair or remove the unreadable row named in the ambiguous advisory, then add a row for each to \`## Project Documents\` in ${PROJECT_INDEX_PATH} (or run \`bkit upgrade\` once the row is repaired).`,
|
|
531
|
+
});
|
|
532
|
+
}
|
|
533
|
+
if (duplicates.length > 0) {
|
|
534
|
+
findings.push({
|
|
535
|
+
id: "project-docs-unindexed",
|
|
536
|
+
severity: "advisory",
|
|
537
|
+
detect: `These project documents exist but ${PROJECT_INDEX_PATH} lists another document for the same topic: ${duplicates.join(", ")}.`,
|
|
538
|
+
action: `bkit does not register them while the other document is indexed. Keep one: delete the unused file, or add a row for the second one by hand under \`## Project Documents\` in ${PROJECT_INDEX_PATH}.`,
|
|
539
|
+
});
|
|
540
|
+
}
|
|
541
|
+
if (cleanup.length > 0) {
|
|
542
|
+
findings.push({
|
|
543
|
+
id: "project-docs-cleanup",
|
|
544
|
+
severity: "advisory",
|
|
545
|
+
detect: `These project documents still carry a bkit ownership wrapper (\`<!-- bkit:start -->\` / \`<!-- bkit:end -->\` lines or the \`bkit:managed\` notice) that bkit could not remove safely: ${cleanup.join("; ")}.`,
|
|
546
|
+
action: `Edit each file by hand: delete the \`<!-- bkit:start -->\` and \`<!-- bkit:end -->\` lines and the \`bkit:managed\` notice line, keeping the text between them. These documents belong to the project now; bkit changes none of them itself.`,
|
|
547
|
+
});
|
|
548
|
+
}
|
|
549
|
+
if (ambiguous.length > 0) {
|
|
550
|
+
findings.push({
|
|
551
|
+
id: "project-docs-ambiguous",
|
|
552
|
+
severity: "advisory",
|
|
553
|
+
detect: `bkit did not read these project documents or the index: ${ambiguous.join("; ")}.`,
|
|
554
|
+
action: `Replace each with a regular file inside the repository (no symbolic link, no \`..\` path), or repair the \`## Project Documents\` table in ${PROJECT_INDEX_PATH}. bkit changes none of them itself.`,
|
|
555
|
+
});
|
|
556
|
+
}
|
|
557
|
+
return findings;
|
|
558
|
+
}
|
|
@@ -6,7 +6,7 @@ import { deepContains } from "../../install/write.js";
|
|
|
6
6
|
import { extractManagedBlock, stripManagedBlock } from "../../install/managed-block.js";
|
|
7
7
|
import { readTemplate } from "../../render/parts.js";
|
|
8
8
|
import { findTemplateSource, getPkgRoot } from "../../shared/package-roots.js";
|
|
9
|
-
import { parseJson } from "../../shared/json.js";
|
|
9
|
+
import { parseJson, readJsonFile } from "../../shared/json.js";
|
|
10
10
|
import { ciWorkflowPath } from "../../shared/settings.js";
|
|
11
11
|
/**
|
|
12
12
|
* Strip out content inside bkit-managed block markers (HTML and slash style).
|
|
@@ -98,6 +98,64 @@ export function detectPlaywrightReporterHostile(cwd) {
|
|
|
98
98
|
action: 'Drop the `--reporter=line` flag so `playwright.config.ts`\'s configured reporter chain runs (typically `[list, html, github, json]`). Verbose-aware pattern: have `test:e2e` read `VERBOSE_CI` and append `--trace=on` to its own `playwright test` call (e.g. `TRACE=; [ "$VERBOSE_CI" = "1" ] && TRACE=--trace=on; playwright test $TRACE`), then run it plainly as `pnpm test:e2e` — do NOT pass `--trace=on` through a turbo / pnpm `-- --trace=on` passthrough, which appends to the script string and breaks any test:e2e ending in a bash construct (fi / done / esac). Never pass `--reporter`. Note that `--video` and `--screenshot` are NOT Playwright CLI flags (they\'re `use:` keys in playwright.config.ts); the trace.zip already captures snapshots / network / console / source. Default-mode output stays clean via the config\'s `list` reporter.',
|
|
99
99
|
};
|
|
100
100
|
}
|
|
101
|
+
const OPENCODE_JSON_REL = path.join(".opencode", "opencode.json");
|
|
102
|
+
/** True for a `permission.bash` key of the legacy generated shape `curl *{host}*` / `wget *{host}*`. */
|
|
103
|
+
export function isOpencodeSubstringFetchKey(key) {
|
|
104
|
+
return /^(curl|wget) \*[^*\s]+\*$/.test(key);
|
|
105
|
+
}
|
|
106
|
+
/** Drop URL user-info and query / fragment text from a permission key before it is printed. */
|
|
107
|
+
export function redactUrlParts(text) {
|
|
108
|
+
return text.replace(/[^/@\s*]+@/g, "").replace(/[?#][^*\s]*/g, "?…");
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Advisory: `.opencode/opencode.json` `permission.bash` holds substring `curl` / `wget`
|
|
112
|
+
* allows that an earlier bkit install generated. No per-entry ownership record exists, so
|
|
113
|
+
* they are reported for owner review and never removed. Reads only; never writes.
|
|
114
|
+
*/
|
|
115
|
+
export function detectOpencodeSubstringFetchGrants(cwd) {
|
|
116
|
+
const read = readJsonFile(path.join(cwd, OPENCODE_JSON_REL));
|
|
117
|
+
if (!read.ok)
|
|
118
|
+
return null;
|
|
119
|
+
const root = read.value;
|
|
120
|
+
const permission = root && typeof root === "object" ? root.permission : undefined;
|
|
121
|
+
if (!permission || typeof permission !== "object")
|
|
122
|
+
return null;
|
|
123
|
+
const bash = permission.bash;
|
|
124
|
+
if (!bash || typeof bash !== "object" || Array.isArray(bash))
|
|
125
|
+
return null;
|
|
126
|
+
const keys = Object.entries(bash)
|
|
127
|
+
.filter(([k, v]) => v === "allow" && isOpencodeSubstringFetchKey(k))
|
|
128
|
+
.map(([k]) => redactUrlParts(k));
|
|
129
|
+
if (keys.length === 0)
|
|
130
|
+
return null;
|
|
131
|
+
return {
|
|
132
|
+
id: "opencode-substring-fetch-grants",
|
|
133
|
+
severity: "advisory",
|
|
134
|
+
detect: `${OPENCODE_JSON_REL} \`permission.bash\` holds substring fetch allows (${keys.map((k) => `\`${k}\``).join(", ")}). A glob over the command string also matches the host inside a query string or user-info part, so \`curl https://evil.example/?x=host\` runs without a prompt.`,
|
|
135
|
+
action: `Review each entry. If you did not add it, remove it from \`permission.bash\` in ${OPENCODE_JSON_REL}; shell \`curl\` / \`wget\` then fall back to the \`curl *\` / \`wget *\` ask. bkit no longer writes these entries and never removes them for you.`,
|
|
136
|
+
};
|
|
137
|
+
}
|
|
138
|
+
const CLOUD_BOOTSTRAP_REL = ".claude/hooks/bkit-cloud-bootstrap.sh";
|
|
139
|
+
const CLOUD_BOOTSTRAP_TEMPLATE_REL = ".bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh";
|
|
140
|
+
/**
|
|
141
|
+
* Advisory: an adopted `.claude/hooks/bkit-cloud-bootstrap.sh` never reads
|
|
142
|
+
* `BKIT_CLOUD_ALLOWLIST_FINGERPRINT`, so a stale cloud network allowlist goes unwarned.
|
|
143
|
+
* Matches the variable name, never byte identity, so a customised bootstrap that compares
|
|
144
|
+
* the variable its own way is accepted. Silent when no bootstrap is adopted. Reads only.
|
|
145
|
+
*/
|
|
146
|
+
export function detectCloudBootstrapFingerprintMissing(cwd) {
|
|
147
|
+
const abs = path.join(cwd, CLOUD_BOOTSTRAP_REL);
|
|
148
|
+
if (!fs.existsSync(abs))
|
|
149
|
+
return null;
|
|
150
|
+
if (fs.readFileSync(abs, "utf-8").includes("BKIT_CLOUD_ALLOWLIST_FINGERPRINT"))
|
|
151
|
+
return null;
|
|
152
|
+
return {
|
|
153
|
+
id: "cloud-bootstrap-fingerprint-missing",
|
|
154
|
+
severity: "advisory",
|
|
155
|
+
detect: `${CLOUD_BOOTSTRAP_REL} never reads \`BKIT_CLOUD_ALLOWLIST_FINGERPRINT\`, so a cloud session cannot warn when the network allowlist pasted into the cloud dashboard is stale.`,
|
|
156
|
+
action: `Copy the fingerprint block (the \`EXPECTED_FP\` section after the workspace-trust check) from ${CLOUD_BOOTSTRAP_TEMPLATE_REL} into ${CLOUD_BOOTSTRAP_REL}, or compare \`BKIT_CLOUD_ALLOWLIST_FINGERPRINT\` with the \`fingerprint\` in \`.bkit/allowlist.json\` your own way. Then set the variable in the cloud environment to the fingerprint printed in \`.claude/bkit-cloud.md\` § Network access.`,
|
|
157
|
+
};
|
|
158
|
+
}
|
|
101
159
|
/**
|
|
102
160
|
* Advisory: detect when a JSON file is missing content the template owns.
|
|
103
161
|
* Runs deepContains(template, consumerFile) — fires when ok=false.
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
15
15
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
16
16
|
import { detectBkitNotOnPath, detectMalformedPackageJson, detectNoPackageJson, detectNotGitRepo, detectInvalidAskSettings, detectBuildPublish, detectInvalidTaskCaps, detectTaskCapFormStale, detectUnmarkedPlans, } from "./repo.js";
|
|
17
|
-
import { MARKERED_TEXT_DRIFT_PATHS, detectGitignoreBlockDuplicates, detectPlaywrightReporterHostile, detectTier2JsonDrift, detectTier2TextDrift, } from "./files.js";
|
|
17
|
+
import { MARKERED_TEXT_DRIFT_PATHS, detectGitignoreBlockDuplicates, detectPlaywrightReporterHostile, detectOpencodeSubstringFetchGrants, detectCloudBootstrapFingerprintMissing, detectTier2JsonDrift, detectTier2TextDrift, } from "./files.js";
|
|
18
18
|
import { detectBkitVersionMajorDowngrade, detectBkitVersionPinStale } from "./version.js";
|
|
19
19
|
import { detectContextFetchContextMissing, detectContextFetchMissing, detectContextFetchProvisionMissing, detectContextFetchSourceNotEnabled, detectContextFetchUnbounded, } from "./context-fetch.js";
|
|
20
20
|
import { detectExtraMcpServers, detectMissingMcpServers } from "./mcp.js";
|
|
@@ -105,6 +105,12 @@ export function runPreflight(modules, cwd = process.cwd(), installingVersion, is
|
|
|
105
105
|
const playwrightReporterHostile = detectPlaywrightReporterHostile(cwd);
|
|
106
106
|
if (playwrightReporterHostile)
|
|
107
107
|
advisories.push(playwrightReporterHostile);
|
|
108
|
+
const opencodeSubstringGrants = detectOpencodeSubstringFetchGrants(cwd);
|
|
109
|
+
if (opencodeSubstringGrants)
|
|
110
|
+
advisories.push(opencodeSubstringGrants);
|
|
111
|
+
const cloudBootstrapFingerprint = detectCloudBootstrapFingerprintMissing(cwd);
|
|
112
|
+
if (cloudBootstrapFingerprint)
|
|
113
|
+
advisories.push(cloudBootstrapFingerprint);
|
|
108
114
|
const contextFetch = detectContextFetchMissing(cwd);
|
|
109
115
|
if (contextFetch)
|
|
110
116
|
advisories.push(contextFetch);
|
|
@@ -12,12 +12,10 @@
|
|
|
12
12
|
// Path-conditional expectations:
|
|
13
13
|
// - Path A (dev is ancestor): skips ship-conflict-resolve.
|
|
14
14
|
// - Path B (dev moved): includes ship-conflict-resolve.
|
|
15
|
-
// - MERGED-on-entry (Step 2 detects state=MERGED → Step
|
|
15
|
+
// - MERGED-on-entry (Step 2 detects state=MERGED → Step 11): skips the entire
|
|
16
16
|
// middle (base check, integrate, deferred-sweep, the pre-merge docs /
|
|
17
17
|
// summary / prune / bookkeeping-push steps, merge-pr).
|
|
18
18
|
// - Aborted (workflow-failed row present): no post-abort holes expected.
|
|
19
|
-
// - ship-failure-diagnose / ship-failure-remediate are NEVER mandatory — they
|
|
20
|
-
// appear only in the merge-retry loop.
|
|
21
19
|
//
|
|
22
20
|
// Usage (advisory CI step or manual):
|
|
23
21
|
// npx tsx .bkit/core/engine/checks/status-holes.ts <status.jsonl>...
|
|
@@ -48,19 +46,15 @@ export const SHIP_STEP_ORDER = [
|
|
|
48
46
|
"ship-prune-skills",
|
|
49
47
|
"ship-bookkeeping-push",
|
|
50
48
|
"ship-merge-pr",
|
|
51
|
-
"ship-failure-diagnose",
|
|
52
|
-
"ship-failure-remediate",
|
|
53
49
|
"ship-switch-to-dev",
|
|
54
50
|
"ship-close-workflow",
|
|
55
51
|
];
|
|
56
|
-
/** Steps that appear only in the merge-retry loop — never mandatory, never holes. */
|
|
57
|
-
const RETRY_LOOP_STEPS = new Set(["ship-failure-diagnose", "ship-failure-remediate"]);
|
|
58
52
|
/** The step that Path A skips (dev is ancestor → no integration needed). */
|
|
59
53
|
const PATH_B_ONLY_STEPS = new Set(["ship-conflict-resolve"]);
|
|
60
54
|
/**
|
|
61
55
|
* The steps a MERGED-on-entry resume skips entirely.
|
|
62
56
|
*
|
|
63
|
-
* bkit-ship.md Step 2 routes to Step
|
|
57
|
+
* bkit-ship.md Step 2 routes to Step 11 at sub-step 5 (`state` = MERGED), which
|
|
64
58
|
* is BEFORE sub-step 8 writes `ship-worktree-setup` + `ship-regression-guard` —
|
|
65
59
|
* so those two are absent too, not just the middle. The pre-merge docs,
|
|
66
60
|
* summary, prune and bookkeeping-push steps (6-8) ride the PR, so a PR that is
|
|
@@ -76,14 +70,16 @@ const MERGED_ON_ENTRY_SKIP = new Set([
|
|
|
76
70
|
"ship-prune-skills",
|
|
77
71
|
"ship-bookkeeping-push",
|
|
78
72
|
"ship-merge-pr",
|
|
79
|
-
// failure-diagnose/remediate are already in RETRY_LOOP_STEPS (never expected)
|
|
80
73
|
]);
|
|
81
74
|
/**
|
|
82
75
|
* Step rows an engine verb writes itself, keyed by noun + verb: `tests red` writes the
|
|
83
|
-
* `RED_STEP` row of `commands/workflow/tests.ts` inside build Step 7
|
|
76
|
+
* `RED_STEP` row of `commands/workflow/tests.ts` inside build Step 7, and a code step's
|
|
77
|
+
* `steps finish` the `TAKEOVER_STEP` row when its change contradicts a ticked task's test.
|
|
78
|
+
* Only keys with the workflow's own prefix count, so `steps finish` adds nothing elsewhere.
|
|
84
79
|
*/
|
|
85
80
|
const VERB_ROWS = {
|
|
86
81
|
"tests red": ["build-tests-red"],
|
|
82
|
+
"steps finish": ["build-takeover"],
|
|
87
83
|
};
|
|
88
84
|
// A step that reads a verb row (`counters derive --step=build-tests-red`) does not own it.
|
|
89
85
|
const VERB_ROW_KEYS = new Set(Object.values(VERB_ROWS).flat());
|
|
@@ -257,9 +253,12 @@ function stepWrites(text) {
|
|
|
257
253
|
});
|
|
258
254
|
return [...new Set(found)];
|
|
259
255
|
}
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
256
|
+
// `{key}-fix` beside `{key}` is the label a fix agent's gate run puts on its test-run rows
|
|
257
|
+
// (`build-holistic-gate-fix`), not a row key: no step writes a step row under it.
|
|
258
|
+
const stepKeys = (text) => {
|
|
259
|
+
const keys = new Set([...text.matchAll(STEP_KEY_RE)].filter((m) => !m[2]).map((m) => m[1]));
|
|
260
|
+
return [...keys].filter((k) => !(k.endsWith("-fix") && keys.has(k.slice(0, -"-fix".length))));
|
|
261
|
+
};
|
|
263
262
|
/** A step is conditional under a column-0 marker line anywhere in its section, or a `(Path X only)` heading. */
|
|
264
263
|
export function isConditionalSection(body) {
|
|
265
264
|
const lines = body.split("\n");
|
|
@@ -755,14 +754,14 @@ export function computeMandatoryForPath(path, sourceUniverse) {
|
|
|
755
754
|
const universe = new Set(sourceUniverse);
|
|
756
755
|
switch (path) {
|
|
757
756
|
case "PATH_A":
|
|
758
|
-
// Skip conflict-resolve
|
|
759
|
-
return new Set([...universe].filter((s) => !PATH_B_ONLY_STEPS.has(s)
|
|
757
|
+
// Skip conflict-resolve
|
|
758
|
+
return new Set([...universe].filter((s) => !PATH_B_ONLY_STEPS.has(s)));
|
|
760
759
|
case "PATH_B":
|
|
761
|
-
// Include conflict-resolve
|
|
762
|
-
return new Set(
|
|
760
|
+
// Include conflict-resolve
|
|
761
|
+
return new Set(universe);
|
|
763
762
|
case "MERGED_ON_ENTRY":
|
|
764
|
-
// Skip the entire middle
|
|
765
|
-
return new Set([...universe].filter((s) => !MERGED_ON_ENTRY_SKIP.has(s)
|
|
763
|
+
// Skip the entire middle
|
|
764
|
+
return new Set([...universe].filter((s) => !MERGED_ON_ENTRY_SKIP.has(s)));
|
|
766
765
|
case "COMPLETED":
|
|
767
766
|
// Non-ship runs derive their mandatory set from the contract (auditRun)
|
|
768
767
|
return new Set(universe);
|
|
@@ -800,8 +799,8 @@ export function detectHoles(observed, sourceUniverse, path) {
|
|
|
800
799
|
if (lastObservedIdx < 0)
|
|
801
800
|
return { missing: [], unexpected };
|
|
802
801
|
// For aborted runs, expected = everything before the last step, minus
|
|
803
|
-
//
|
|
804
|
-
const skipSet = new Set(
|
|
802
|
+
// conflict-resolve (unless it was observed)
|
|
803
|
+
const skipSet = new Set();
|
|
805
804
|
if (!observed.has("ship-conflict-resolve"))
|
|
806
805
|
skipSet.add("ship-conflict-resolve");
|
|
807
806
|
const missing = [];
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
// Text rules: `line`, `why`, `caution` and `ask` are for the person, in plain English, and
|
|
15
15
|
// never name an outside service — examples of specific services go in `steps`, which is
|
|
16
16
|
// for the agent. A template's benefit reads the same here, in its `.bkit/templates.md`
|
|
17
|
-
// section opener and in
|
|
17
|
+
// section opener and in `DETAILS.md` § Templates ready to adopt; change all three in
|
|
18
18
|
// the same commit.
|
|
19
19
|
//
|
|
20
20
|
// Detection rules: every `fires` is local (files, settings, environment) — no network. The
|
|
@@ -30,15 +30,43 @@ import { detectContextFetchMissing } from "../before/context-fetch.js";
|
|
|
30
30
|
import { detectBlankDotenvKeys, detectDirenvMissing, detectDirenvNotAllowed, detectMissingDotenv, isCloudOrCi, } from "../before/env.js";
|
|
31
31
|
import { detectGhMcpToken, hasGithubMcpServer } from "../after/auth.js";
|
|
32
32
|
import { buildTrackerSetupAdvisory } from "../after/github.js";
|
|
33
|
-
import { buildDepUpdaterSetupAdvisory } from "../after/tools.js";
|
|
33
|
+
import { buildDepUpdaterSetupAdvisory, detectProjectDocs } from "../after/tools.js";
|
|
34
34
|
import { detectInstalledHostModules } from "../../install/hosts.js";
|
|
35
35
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
36
|
-
import { anyWorkflowMentions, claudeSettingsHas, codexTopLevelHas, exists, hasJsTestRunner, hasLintStagedConfig, hasMcpServer, hasNewerBkit, hasTestLinter, hasUnsharedFriction, readsBkitText, unlockedMcpServers, } from "./detect.js";
|
|
36
|
+
import { anyWorkflowMentions, claudeSettingsHas, codexTopLevelHas, exists, hasJsTestRunner, hasLintStagedConfig, hasMcpServer, hasNoProjectGoals, hasProjectGoalsHeading, hasNewerBkit, hasTestLinter, hasUnsharedFriction, readsBkitText, unlockedMcpServers, } from "./detect.js";
|
|
37
37
|
const hosts = (cwd) => detectInstalledHostModules(cwd);
|
|
38
38
|
/** Every phase workflow. A value import of `COMPLY_PHASES` would cycle through cli.ts. */
|
|
39
39
|
export const ALL_WORKFLOWS = ["design", "plan", "build", "debug", "ship"];
|
|
40
40
|
/** Every `bkit tips --workflow=` context: the phase workflows, then the two agent closes. */
|
|
41
41
|
export const EVERY_CONTEXT = [...ALL_WORKFLOWS, "audit", "utility"];
|
|
42
|
+
const CLOUD_STEPS = "`.bkit/cloud.md`; `.bkit/templates.md` § Cloud-agent workflow and § Cursor.";
|
|
43
|
+
/** The `cloud` tip's `ask` / `steps` for the recorded `bkit.cloud.agent`. */
|
|
44
|
+
function cloudTipText(agent) {
|
|
45
|
+
const copy = "copy .bkit/templates/.github/workflows/bkit-cloud.yml to .github/workflows/bkit-cloud.yml";
|
|
46
|
+
const tail = "then tell me which dashboard settings are left.";
|
|
47
|
+
switch (agent) {
|
|
48
|
+
case "claude":
|
|
49
|
+
return {
|
|
50
|
+
ask: `Check my cloud-agent setup against .bkit/cloud.md: install the Claude GitHub App on the repo, ${copy} and .bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh to .claude/hooks/, run \`gh secret set BKIT_ANTHROPIC_API_KEY\` (or, keyless, \`gh variable set\` ANTHROPIC_FEDERATION_RULE_ID and ANTHROPIC_ORGANIZATION_ID from a Claude Console federation rule), ${tail}`,
|
|
51
|
+
steps: CLOUD_STEPS,
|
|
52
|
+
};
|
|
53
|
+
case "codex":
|
|
54
|
+
return {
|
|
55
|
+
ask: `Check my cloud-agent setup against .bkit/cloud.md: confirm bkit was installed with --codex, ${copy}, run \`gh secret set BKIT_OPENAI_API_KEY\`, ${tail}`,
|
|
56
|
+
steps: CLOUD_STEPS,
|
|
57
|
+
};
|
|
58
|
+
case "opencode":
|
|
59
|
+
return {
|
|
60
|
+
ask: `Check my cloud-agent setup against .bkit/cloud.md: ${copy}, set the opencode provider's BKIT_ API key as a repo secret (the name is in .bkit/cloud.md), ${tail}`,
|
|
61
|
+
steps: CLOUD_STEPS,
|
|
62
|
+
};
|
|
63
|
+
default:
|
|
64
|
+
return {
|
|
65
|
+
ask: `Check my cloud-agent setup against .bkit/cloud.md: copy .bkit/templates/.cursor/environment.json and .bkit/templates/.cursor/Dockerfile to .cursor/, ${tail}`,
|
|
66
|
+
steps: CLOUD_STEPS,
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
}
|
|
42
70
|
export const SETUP_TIPS = [
|
|
43
71
|
// --- current: is bkit itself up to date ---------------------------------------------
|
|
44
72
|
{
|
|
@@ -75,7 +103,9 @@ export const SETUP_TIPS = [
|
|
|
75
103
|
steps: "`.bkit/install.md` § Local env setup. The `github` server entry belongs in `.mcp.json` / `.cursor/mcp.json` (`.bkit/cloud.md` § MCP issue-tracker integration).",
|
|
76
104
|
advisories: ["gh-mcp-token-unset-shell", "gh-mcp-token-empty-shell"],
|
|
77
105
|
fires: (cwd) => readBkitConfig(cwd).issueTracker === "github" &&
|
|
78
|
-
(!hasGithubMcpServer(cwd) ||
|
|
106
|
+
(!hasGithubMcpServer(cwd) ||
|
|
107
|
+
// The pre-push hook's inner run unsets the .bkit/.env keys on purpose, so a missing token there is not real.
|
|
108
|
+
(!process.env.BKIT_PRE_PUSH_LOGGED && detectGhMcpToken(cwd) !== null)),
|
|
79
109
|
},
|
|
80
110
|
{
|
|
81
111
|
id: "bkit-env",
|
|
@@ -148,7 +178,7 @@ export const SETUP_TIPS = [
|
|
|
148
178
|
title: "Consistent formatting",
|
|
149
179
|
line: "There's no shared formatting setup, so reviews fill up with spacing changes that hide the real ones. Add Prettier with bkit's ignore file.",
|
|
150
180
|
why: "Prettier (a code formatter) makes every file follow the same layout. bkit's ignore file stops it reformatting bkit's own files, which would otherwise show up as false changes every time bkit updates.",
|
|
151
|
-
ask: 'Copy .bkit/templates
|
|
181
|
+
ask: 'Copy .bkit/templates/prettierignore.example to .prettierignore first, then run `pnpm add -D prettier` and add `"format:check": "prettier --check ."` to the package.json scripts.',
|
|
152
182
|
steps: "`.bkit/templates.md` § Prettier.",
|
|
153
183
|
fires: (cwd) => !exists(cwd, ".prettierignore"),
|
|
154
184
|
},
|
|
@@ -188,7 +218,7 @@ export const SETUP_TIPS = [
|
|
|
188
218
|
title: "Quick tidy-up on commit",
|
|
189
219
|
line: "The commit check has nothing to run. Add lint-staged so it tidies just the files you're committing.",
|
|
190
220
|
why: "It formats only the handful of files in each change, in about a second. Without it the commit check either does nothing or is slow enough that people start skipping it.",
|
|
191
|
-
ask: "Run `pnpm add -D lint-staged prettier` and copy .bkit/templates
|
|
221
|
+
ask: "Run `pnpm add -D lint-staged prettier` and copy .bkit/templates/lintstagedrc.example.json to .lintstagedrc.json.",
|
|
192
222
|
steps: "`.bkit/templates.md` § lint-staged.",
|
|
193
223
|
fires: (cwd) => !hasLintStagedConfig(cwd),
|
|
194
224
|
},
|
|
@@ -199,8 +229,9 @@ export const SETUP_TIPS = [
|
|
|
199
229
|
title: "Finish cloud setup",
|
|
200
230
|
line: "You've turned on cloud agents, but setup isn't finished, so cloud runs will stop partway. Finish the remaining steps.",
|
|
201
231
|
why: "With cloud agents, bkit runs on its own: a change that passes its checks gets shipped and one that fails gets investigated, with nobody at the keyboard. That only works once every piece is in place.",
|
|
202
|
-
ask: "Check my cloud-agent setup against .bkit/cloud.md: copy .bkit/templates/.github/workflows/bkit-cloud.yml to .github/workflows/bkit-cloud.yml
|
|
232
|
+
ask: "Check my cloud-agent setup against .bkit/cloud.md: copy .bkit/templates/.github/workflows/bkit-cloud.yml to .github/workflows/bkit-cloud.yml, set the agent's credential as a repo secret under its BKIT_ name, then tell me which dashboard settings are left.",
|
|
203
233
|
steps: "`.bkit/cloud.md`; `.bkit/templates.md` § Cloud-agent workflow and § Cursor.",
|
|
234
|
+
resolve: (cwd) => cloudTipText(readBkitConfig(cwd).cloudAgents),
|
|
204
235
|
fires: (cwd) => {
|
|
205
236
|
const cloud = readBkitConfig(cwd).cloudAgents;
|
|
206
237
|
if (cloud === "none")
|
|
@@ -291,6 +322,34 @@ export const SETUP_TIPS = [
|
|
|
291
322
|
steps: "`.bkit/templates.md` § graphify.",
|
|
292
323
|
fires: (cwd) => !exists(cwd, "scripts/graphify"),
|
|
293
324
|
},
|
|
325
|
+
{
|
|
326
|
+
id: "project-docs",
|
|
327
|
+
workflows: ["design", "plan", "build"],
|
|
328
|
+
title: "Project docs",
|
|
329
|
+
line: "Fill the project docs in waves, because each doc reads facts the earlier ones record.",
|
|
330
|
+
why: "Agents read your architecture, testing and security docs before they plan and build. A doc that is missing or still holds the starter text gives them nothing to go on, so they guess from the code each time.",
|
|
331
|
+
caution: "Ignoring either the missing-doc advisory or the unfilled-doc advisory also silences this tip and the other advisory.",
|
|
332
|
+
ask: "Fill in my project docs in the order of .bkit/templates.md § Project docs — adoption order: copy each missing starter from .bkit/templates/docs/ to docs/, fill it from the repository, and add its row to .agents/docs.md.",
|
|
333
|
+
steps: "`.bkit/templates.md` § Project docs — adoption order.",
|
|
334
|
+
advisories: ["project-docs-missing", "project-docs-unpopulated"],
|
|
335
|
+
fires: (cwd) => detectProjectDocs(cwd).some((f) => f.id === "project-docs-missing" || f.id === "project-docs-unpopulated"),
|
|
336
|
+
},
|
|
337
|
+
{
|
|
338
|
+
id: "project-goals",
|
|
339
|
+
workflows: ["design", "plan"],
|
|
340
|
+
title: "Project goals",
|
|
341
|
+
line: "Agents have rules but no goals, so when two options both fit the rules they choose by guesswork. Write down what this project optimises for.",
|
|
342
|
+
why: "Design and plan agents choose between options on every run. The rules say what is allowed, not what matters most here, so each agent weighs speed, cost and polish its own way.",
|
|
343
|
+
ask: "Add a `## Project Goals` section to .agents/rules.md, between Project Rules and Project Settings, with a few goals in priority order. Ask me what this project optimises for first.",
|
|
344
|
+
steps: "`.bkit/prompts.md` § Special Behaviors, where the Project Goals row sits.",
|
|
345
|
+
resolve: (cwd) => ({
|
|
346
|
+
ask: hasProjectGoalsHeading(cwd)
|
|
347
|
+
? "Fill the `## Project Goals` section that already exists in .agents/rules.md instead of adding a second one, with a few goals in priority order. Ask me what this project optimises for first."
|
|
348
|
+
: "Add a `## Project Goals` section to .agents/rules.md, between Project Rules and Project Settings, with a few goals in priority order. Ask me what this project optimises for first.",
|
|
349
|
+
steps: "`.bkit/prompts.md` § Special Behaviors, where the Project Goals row sits.",
|
|
350
|
+
}),
|
|
351
|
+
fires: hasNoProjectGoals,
|
|
352
|
+
},
|
|
294
353
|
{
|
|
295
354
|
id: "dependabot-renovate",
|
|
296
355
|
workflows: ["ship", "audit"],
|
|
@@ -358,6 +417,36 @@ export const SETUP_TIPS = [
|
|
|
358
417
|
return ["bkit ci min-push", "--update=", "bkit ci push-gate"].some((part) => !hook.includes(part));
|
|
359
418
|
},
|
|
360
419
|
},
|
|
420
|
+
{
|
|
421
|
+
id: "pre-push-pr-conflict",
|
|
422
|
+
workflows: ["plan", "ship"],
|
|
423
|
+
title: "Stop a push whose PR no longer merges",
|
|
424
|
+
line: "Your pre-push hook runs the whole gate even when the branch's open PR conflicts with its base, and CI never starts.",
|
|
425
|
+
why: "The newer hook looks up the open PR once, fetches its base and trial-merges the pushed commit. A conflict stops the push in seconds and names the files; a lookup or fetch that cannot answer only warns.",
|
|
426
|
+
ask: "Paste the `Open-PR lookup` block (above the CI-suppressor guard, which now reads the PR number from it) and the `PR conflict` block (before `pnpm bkit check`) of .bkit/templates/.husky/pre-push into .husky/pre-push, and add the `PUSH_BRANCH_SHA` line of its stdin loop: without it the check never runs.",
|
|
427
|
+
steps: "`.bkit/templates.md` § Git hooks.",
|
|
428
|
+
fires: (cwd) => {
|
|
429
|
+
if (!exists(cwd, ".husky/pre-push"))
|
|
430
|
+
return false;
|
|
431
|
+
const hook = fs.readFileSync(path.join(cwd, ".husky/pre-push"), "utf-8");
|
|
432
|
+
return !hook.includes("merge-tree") || !hook.includes("PUSH_BRANCH_SHA=");
|
|
433
|
+
},
|
|
434
|
+
},
|
|
435
|
+
{
|
|
436
|
+
id: "pre-push-direnv",
|
|
437
|
+
workflows: ["plan", "ship"],
|
|
438
|
+
title: "Load .envrc when the pre-push hook runs",
|
|
439
|
+
line: "Your pre-push hook runs the gate without your .envrc variables when the shell that pushed never loaded them.",
|
|
440
|
+
why: "The newer hook runs its logged inner run through `direnv exec .`, so the gate always sees the repo's variables, and an untrusted .envrc stops the push in seconds with the fix instead of failing deep in the gate. The unset loops right after that block keep the fixed list of bkit tooling keys (BKIT_GH_TOKEN, ...), and every key `.bkit/.env` names, out of the gate and its log, however they were loaded.",
|
|
441
|
+
ask: "Replace the log block of .husky/pre-push (the `BKIT_PRE_PUSH_LOGGED` block) and the `.bkit/.env` unset block that follows it with the ones in .bkit/templates/.husky/pre-push.",
|
|
442
|
+
steps: "`.bkit/templates.md` § Git hooks.",
|
|
443
|
+
fires: (cwd) => {
|
|
444
|
+
if (!exists(cwd, ".husky/pre-push") || !exists(cwd, ".envrc"))
|
|
445
|
+
return false;
|
|
446
|
+
const hook = fs.readFileSync(path.join(cwd, ".husky/pre-push"), "utf-8");
|
|
447
|
+
return !hook.includes("direnv exec");
|
|
448
|
+
},
|
|
449
|
+
},
|
|
361
450
|
{
|
|
362
451
|
id: "disk-prune",
|
|
363
452
|
workflows: ALL_WORKFLOWS,
|
|
@@ -373,10 +462,10 @@ export const SETUP_TIPS = [
|
|
|
373
462
|
{
|
|
374
463
|
id: "share-friction",
|
|
375
464
|
title: "Tell bkit what slowed you down",
|
|
376
|
-
line: "Your workflows
|
|
465
|
+
line: "Your workflows logged problems its makers never see. Send them with your stats as one issue.",
|
|
377
466
|
why: "Workflows note every place bkit got in the way: a command that failed, rework, a manual step. Those notes stay in this repo, so the people who fix bkit never learn about them. One report from you is how they reach the fix list.",
|
|
378
|
-
caution: "bkit's
|
|
379
|
-
ask: "Share this repo's bkit friction and stats
|
|
467
|
+
caution: "bkit's issues are public. Your agent strips project names, paths and links first.",
|
|
468
|
+
ask: "Share this repo's bkit friction and stats as one issue per .bkit/README.md § Share friction with bkit. Show me the exact text; post only after I say yes.",
|
|
380
469
|
steps: "`.bkit/README.md` § Share friction with bkit.",
|
|
381
470
|
fires: hasUnsharedFriction,
|
|
382
471
|
},
|