@cbartens/bkit 6.1.0 → 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.
Files changed (317) hide show
  1. package/.bkit/README.md +14 -12
  2. package/.bkit/core/.agents/docs.md +1 -11
  3. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +30 -9
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +25 -27
  5. package/.bkit/core/.agents/rules.md +22 -9
  6. package/.bkit/core/.bkit/README.md +13 -11
  7. package/.bkit/core/.bkit/authoring.md +58 -13
  8. package/.bkit/core/.bkit/cli.md +43 -33
  9. package/.bkit/core/.bkit/cloud.md +93 -30
  10. package/.bkit/core/.bkit/install.md +55 -16
  11. package/.bkit/core/.bkit/jsonl.md +24 -7
  12. package/.bkit/core/.bkit/pipeline.md +8 -8
  13. package/.bkit/core/.bkit/prompts.md +160 -43
  14. package/.bkit/core/.bkit/providers.md +99 -36
  15. package/.bkit/core/.bkit/templates.md +167 -37
  16. package/.bkit/core/.bkit/trackers.md +39 -6
  17. package/.bkit/core/.bkit/workflows.md +344 -136
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +50 -27
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +11 -11
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +13 -8
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +14 -25
  22. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +20 -9
  23. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +8 -8
  24. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +14 -4
  25. package/.bkit/core/.opencode/plugin/bkit-guardrails.js +114 -0
  26. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +1 -1
  27. package/.bkit/core/docs/templates/bkit-audit-adoption.md +30 -6
  28. package/.bkit/core/docs/templates/bkit-audit-agents.md +1 -1
  29. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +1 -1
  30. package/.bkit/core/docs/templates/bkit-audit-analytics.md +1 -1
  31. package/.bkit/core/docs/templates/bkit-audit-annotations.md +1 -1
  32. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +1 -1
  33. package/.bkit/core/docs/templates/bkit-audit-app-store.md +1 -1
  34. package/.bkit/core/docs/templates/bkit-audit-architecture.md +1 -1
  35. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +2 -2
  36. package/.bkit/core/docs/templates/bkit-audit-config.md +3 -2
  37. package/.bkit/core/docs/templates/bkit-audit-cost.md +1 -1
  38. package/.bkit/core/docs/templates/bkit-audit-coverage.md +1 -1
  39. package/.bkit/core/docs/templates/bkit-audit-database.md +3 -3
  40. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +1 -1
  41. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +1 -1
  42. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +3 -3
  43. package/.bkit/core/docs/templates/bkit-audit-documentation.md +32 -2
  44. package/.bkit/core/docs/templates/bkit-audit-duplication.md +1 -1
  45. package/.bkit/core/docs/templates/bkit-audit-failures.md +1 -1
  46. package/.bkit/core/docs/templates/bkit-audit-flakes.md +2 -2
  47. package/.bkit/core/docs/templates/bkit-audit-gates.md +5 -3
  48. package/.bkit/core/docs/templates/bkit-audit-issues.md +1 -1
  49. package/.bkit/core/docs/templates/bkit-audit-llm.md +2 -2
  50. package/.bkit/core/docs/templates/bkit-audit-logs.md +1 -1
  51. package/.bkit/core/docs/templates/bkit-audit-models.md +2 -2
  52. package/.bkit/core/docs/templates/bkit-audit-privacy.md +1 -1
  53. package/.bkit/core/docs/templates/bkit-audit-prompts.md +1 -1
  54. package/.bkit/core/docs/templates/bkit-audit-red-team.md +2 -2
  55. package/.bkit/core/docs/templates/bkit-audit-reliability.md +3 -2
  56. package/.bkit/core/docs/templates/bkit-audit-repo.md +1 -1
  57. package/.bkit/core/docs/templates/bkit-audit-security.md +1 -1
  58. package/.bkit/core/docs/templates/bkit-audit-slop.md +1 -1
  59. package/.bkit/core/docs/templates/bkit-audit-testing.md +3 -2
  60. package/.bkit/core/docs/templates/bkit-audit-usability.md +1 -1
  61. package/.bkit/core/docs/templates/bkit-plan.md +38 -8
  62. package/.bkit/core/engine/checks/after/auth.ts +118 -47
  63. package/.bkit/core/engine/checks/after/github.ts +161 -37
  64. package/.bkit/core/engine/checks/after/index.ts +18 -3
  65. package/.bkit/core/engine/checks/after/tools.ts +245 -1
  66. package/.bkit/core/engine/checks/before/files.ts +59 -1
  67. package/.bkit/core/engine/checks/before/index.ts +8 -0
  68. package/.bkit/core/engine/checks/status-holes.ts +20 -26
  69. package/.bkit/core/engine/checks/tips/catalogue.ts +107 -10
  70. package/.bkit/core/engine/checks/tips/detect.ts +36 -3
  71. package/.bkit/core/engine/checks/tips/index.ts +1 -1
  72. package/.bkit/core/engine/cli.ts +13 -13
  73. package/.bkit/core/engine/commands/ci/ci.ts +124 -19
  74. package/.bkit/core/engine/commands/ci/push-gate.ts +101 -43
  75. package/.bkit/core/engine/commands/install/doctor.ts +5 -5
  76. package/.bkit/core/engine/commands/install/install.ts +28 -25
  77. package/.bkit/core/engine/commands/install/uninstall.ts +42 -30
  78. package/.bkit/core/engine/commands/install/upgrade.ts +14 -2
  79. package/.bkit/core/engine/commands/land.ts +2 -3
  80. package/.bkit/core/engine/commands/lib.ts +394 -39
  81. package/.bkit/core/engine/commands/registry.ts +1 -1
  82. package/.bkit/core/engine/commands/workflow/branches.ts +351 -78
  83. package/.bkit/core/engine/commands/workflow/challenge.ts +63 -14
  84. package/.bkit/core/engine/commands/workflow/context.ts +71 -10
  85. package/.bkit/core/engine/commands/workflow/counters.ts +298 -23
  86. package/.bkit/core/engine/commands/workflow/decisions.ts +260 -125
  87. package/.bkit/core/engine/commands/workflow/disk.ts +2 -1
  88. package/.bkit/core/engine/commands/workflow/feature-base.ts +66 -0
  89. package/.bkit/core/engine/commands/workflow/issues.ts +312 -17
  90. package/.bkit/core/engine/commands/workflow/junit.ts +204 -0
  91. package/.bkit/core/engine/commands/workflow/ledgers.ts +904 -99
  92. package/.bkit/core/engine/commands/workflow/locks.ts +186 -29
  93. package/.bkit/core/engine/commands/workflow/loops.ts +87 -0
  94. package/.bkit/core/engine/commands/workflow/open-decision.ts +251 -0
  95. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +8 -0
  96. package/.bkit/core/engine/commands/workflow/plans.ts +1 -1
  97. package/.bkit/core/engine/commands/workflow/prs.ts +311 -16
  98. package/.bkit/core/engine/commands/workflow/repo.ts +1 -1
  99. package/.bkit/core/engine/commands/workflow/run-facts.ts +6 -0
  100. package/.bkit/core/engine/commands/workflow/runs.ts +877 -174
  101. package/.bkit/core/engine/commands/workflow/runtime.ts +12 -4
  102. package/.bkit/core/engine/commands/workflow/status.ts +324 -11
  103. package/.bkit/core/engine/commands/workflow/step-table.ts +41 -15
  104. package/.bkit/core/engine/commands/workflow/steps.ts +604 -29
  105. package/.bkit/core/engine/commands/workflow/summary-findings.ts +1 -1
  106. package/.bkit/core/engine/commands/workflow/summary.ts +314 -8
  107. package/.bkit/core/engine/commands/workflow/tasks.ts +400 -27
  108. package/.bkit/core/engine/commands/workflow/tests-base.ts +319 -0
  109. package/.bkit/core/engine/commands/workflow/tests-changed.ts +138 -74
  110. package/.bkit/core/engine/commands/workflow/tests-jump.ts +93 -0
  111. package/.bkit/core/engine/commands/workflow/tests.ts +815 -182
  112. package/.bkit/core/engine/commands/workflow/tracker.ts +1134 -137
  113. package/.bkit/core/engine/commands/workflow/workflows.ts +100 -72
  114. package/.bkit/core/engine/commands/workflow/worktrees.ts +421 -57
  115. package/.bkit/core/engine/install/cloud-env.ts +38 -10
  116. package/.bkit/core/engine/install/managed-block.ts +105 -0
  117. package/.bkit/core/engine/install/manifest.ts +7 -1
  118. package/.bkit/core/engine/install/modules/claude.ts +6 -2
  119. package/.bkit/core/engine/install/modules/cloud.ts +84 -95
  120. package/.bkit/core/engine/install/modules/codex.ts +10 -2
  121. package/.bkit/core/engine/install/modules/core.ts +202 -26
  122. package/.bkit/core/engine/install/modules/opencode.ts +18 -23
  123. package/.bkit/core/engine/install/network-allowlist.ts +8 -3
  124. package/.bkit/core/engine/install/project-docs.ts +650 -0
  125. package/.bkit/core/engine/install/template-copies.ts +58 -5
  126. package/.bkit/core/engine/install/write.ts +128 -7
  127. package/.bkit/core/engine/ledgers/journal.ts +18 -10
  128. package/.bkit/core/engine/ledgers/migrate.ts +20 -8
  129. package/.bkit/core/engine/ledgers/status.ts +604 -8
  130. package/.bkit/core/engine/ledgers/telemetry.ts +115 -13
  131. package/.bkit/core/engine/render/trackers.ts +46 -11
  132. package/.bkit/core/engine/shared/package-manager.ts +7 -3
  133. package/.bkit/core/engine/shared/settings.ts +12 -1
  134. package/.bkit/core/engine/shared/text.ts +14 -0
  135. package/.bkit/core/engine/tools/instructions-sources.ts +1 -0
  136. package/.bkit/core/engine/tools/instructions.ts +116 -20
  137. package/.bkit/core/hooks/antigravity-hook.js +20 -4
  138. package/.bkit/core/hooks/gateguard-edit-payload.js +8 -5
  139. package/.bkit/core/hooks/gateguard-engine.js +249 -23
  140. package/.bkit/core/hooks/guardrails-deny.js +167 -0
  141. package/.bkit/core/hooks/guardrails-read.js +3 -3
  142. package/.bkit/core/hooks/guardrails-shell.js +1122 -167
  143. package/.bkit/core/hooks/guardrails-tiers.js +247 -176
  144. package/.bkit/core/hooks/preflight-tracker.sh +219 -0
  145. package/.bkit/core/prompts/bkit-audit-generate.md +23 -6
  146. package/.bkit/core/prompts/bkit-build-challenge-1.md +5 -4
  147. package/.bkit/core/prompts/bkit-build-challenge-2.md +6 -5
  148. package/.bkit/core/prompts/bkit-build-install-skills.md +2 -2
  149. package/.bkit/core/prompts/bkit-build-plan-convert.md +21 -7
  150. package/.bkit/core/prompts/bkit-build-plan-current.md +5 -4
  151. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +22 -17
  152. package/.bkit/core/prompts/bkit-build-plan-tasks.md +16 -12
  153. package/.bkit/core/prompts/bkit-build-plan-tests.md +14 -10
  154. package/.bkit/core/prompts/bkit-build-plan-verify.md +21 -8
  155. package/.bkit/core/prompts/bkit-debug-abort-handover.md +10 -5
  156. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +22 -6
  157. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +19 -3
  158. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +22 -6
  159. package/.bkit/core/prompts/bkit-debug-failure-soak.md +10 -7
  160. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +3 -3
  161. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +4 -4
  162. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +3 -3
  163. package/.bkit/core/prompts/bkit-design-generate.md +6 -4
  164. package/.bkit/core/prompts/bkit-design-organise.md +4 -3
  165. package/.bkit/core/prompts/bkit-design-review-1.md +5 -4
  166. package/.bkit/core/prompts/bkit-design-review-2.md +6 -5
  167. package/.bkit/core/prompts/bkit-design-spike.md +4 -3
  168. package/.bkit/core/prompts/bkit-design-update.md +6 -4
  169. package/.bkit/core/prompts/bkit-plan-generate.md +35 -14
  170. package/.bkit/core/prompts/bkit-plan-review-1.md +9 -7
  171. package/.bkit/core/prompts/bkit-plan-review-2.md +9 -7
  172. package/.bkit/core/prompts/bkit-plan-scope-check.md +8 -6
  173. package/.bkit/core/prompts/bkit-plan-update.md +22 -8
  174. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +11 -8
  175. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +9 -5
  176. package/.bkit/core/prompts/bkit-ship-update-docs.md +26 -4
  177. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +3 -3
  178. package/.bkit/core/prompts/bkit-utility-update-decisions.md +10 -7
  179. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +8 -5
  180. package/.bkit/core/prompts/bkit-utility-update-documentation.md +31 -7
  181. package/.bkit/core/prompts/bkit-utility-update-failures.md +8 -5
  182. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +10 -7
  183. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +4 -4
  184. package/.bkit/core/prompts/bkit-utility-update-tracker.md +4 -4
  185. package/.bkit/core/workflows/bkit-auto.md +23 -11
  186. package/.bkit/core/workflows/bkit-build.md +331 -100
  187. package/.bkit/core/workflows/bkit-debug.md +135 -64
  188. package/.bkit/core/workflows/bkit-design.md +58 -32
  189. package/.bkit/core/workflows/bkit-plan.md +73 -45
  190. package/.bkit/core/workflows/bkit-ship.md +233 -167
  191. package/.bkit/shared/.agents/plugins/bkit/hooks.json +1 -1
  192. package/.bkit/shared/.bkit/.env.example +5 -0
  193. package/.bkit/shared/.claude/bkit-cloud.md +7 -7
  194. package/.bkit/shared/.claude/settings.json +5 -1
  195. package/.bkit/shared/.cursor/bkit-cloud.md +1 -1
  196. package/.bkit/shared/.cursor/hooks.json +1 -1
  197. package/.bkit/shared/.opencode/opencode.json +11 -2
  198. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +27 -0
  199. package/.bkit/templates/.cursor/Dockerfile +7 -7
  200. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +1 -1
  201. package/.bkit/templates/.github/dependabot.yml +5 -0
  202. package/.bkit/templates/.github/renovate.json5 +5 -3
  203. package/.bkit/templates/.github/workflows/bkit-ci.yml +11 -11
  204. package/.bkit/templates/.github/workflows/bkit-cloud.yml +525 -161
  205. package/.bkit/templates/.github/workflows/bkit-renovate.yml +2 -2
  206. package/.bkit/templates/.husky/pre-push +123 -6
  207. package/.bkit/templates/context/bkit-serena.md +1 -1
  208. package/.bkit/templates/context/bkit-vercel.md +103 -59
  209. package/.bkit/templates/docs/architecture.md +98 -0
  210. package/.bkit/templates/docs/capabilities.md +33 -37
  211. package/.bkit/templates/docs/components.md +142 -0
  212. package/.bkit/templates/docs/data-schema.md +87 -0
  213. package/.bkit/{shared → templates}/docs/deployments.md +128 -142
  214. package/.bkit/templates/docs/design.md +117 -0
  215. package/.bkit/templates/docs/noise.md +54 -0
  216. package/.bkit/templates/docs/observability.md +99 -0
  217. package/.bkit/templates/docs/security.md +137 -0
  218. package/.bkit/templates/docs/setup.md +93 -0
  219. package/.bkit/templates/docs/technology.md +70 -0
  220. package/.bkit/{shared → templates}/docs/testing.md +200 -87
  221. package/.bkit/templates/scripts/ci/bkit-check-accepted-divergences.mjs +1 -6
  222. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +511 -103
  223. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +314 -28
  224. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +500 -1
  225. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  226. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +91 -62
  227. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +59 -11
  228. package/.bkit/templates/slop-scan.config.json +2 -0
  229. package/CHANGELOG.md +79 -0
  230. package/DETAILS.md +661 -0
  231. package/README.md +73 -604
  232. package/dist/checks/after/auth.js +114 -46
  233. package/dist/checks/after/github.js +138 -35
  234. package/dist/checks/after/index.js +16 -4
  235. package/dist/checks/after/tools.js +224 -1
  236. package/dist/checks/before/files.js +59 -1
  237. package/dist/checks/before/index.js +7 -1
  238. package/dist/checks/status-holes.js +20 -21
  239. package/dist/checks/tips/catalogue.js +99 -10
  240. package/dist/checks/tips/detect.js +35 -3
  241. package/dist/checks/tips/index.js +1 -1
  242. package/dist/cli.js +13 -13
  243. package/dist/commands/ci/ci.js +113 -20
  244. package/dist/commands/ci/push-gate.js +79 -44
  245. package/dist/commands/install/doctor.js +5 -5
  246. package/dist/commands/install/install.js +23 -22
  247. package/dist/commands/install/uninstall.js +36 -30
  248. package/dist/commands/install/upgrade.js +10 -2
  249. package/dist/commands/land.js +2 -3
  250. package/dist/commands/lib.js +323 -25
  251. package/dist/commands/workflow/branches.js +312 -72
  252. package/dist/commands/workflow/challenge.js +66 -13
  253. package/dist/commands/workflow/context.js +46 -10
  254. package/dist/commands/workflow/counters.js +231 -23
  255. package/dist/commands/workflow/decisions.js +221 -106
  256. package/dist/commands/workflow/disk.js +2 -1
  257. package/dist/commands/workflow/feature-base.js +60 -0
  258. package/dist/commands/workflow/issues.js +243 -15
  259. package/dist/commands/workflow/junit.js +137 -0
  260. package/dist/commands/workflow/ledgers.js +726 -112
  261. package/dist/commands/workflow/locks.js +150 -29
  262. package/dist/commands/workflow/loops.js +67 -0
  263. package/dist/commands/workflow/open-decision.js +199 -0
  264. package/dist/commands/workflow/plan-blocks.js +6 -0
  265. package/dist/commands/workflow/plans.js +1 -1
  266. package/dist/commands/workflow/prs.js +272 -16
  267. package/dist/commands/workflow/repo.js +1 -1
  268. package/dist/commands/workflow/run-facts.js +6 -0
  269. package/dist/commands/workflow/runs.js +747 -155
  270. package/dist/commands/workflow/runtime.js +8 -4
  271. package/dist/commands/workflow/status.js +259 -13
  272. package/dist/commands/workflow/step-table.js +41 -15
  273. package/dist/commands/workflow/steps.js +530 -26
  274. package/dist/commands/workflow/summary-findings.js +1 -1
  275. package/dist/commands/workflow/summary.js +289 -8
  276. package/dist/commands/workflow/tasks.js +294 -27
  277. package/dist/commands/workflow/tests-base.js +266 -0
  278. package/dist/commands/workflow/tests-changed.js +130 -56
  279. package/dist/commands/workflow/tests-jump.js +77 -0
  280. package/dist/commands/workflow/tests.js +608 -131
  281. package/dist/commands/workflow/tracker.js +920 -112
  282. package/dist/commands/workflow/workflows.js +80 -59
  283. package/dist/commands/workflow/worktrees.js +387 -58
  284. package/dist/install/cloud-env.js +32 -10
  285. package/dist/install/managed-block.js +101 -0
  286. package/dist/install/manifest.js +7 -1
  287. package/dist/install/modules/claude.js +6 -2
  288. package/dist/install/modules/cloud.js +73 -86
  289. package/dist/install/modules/codex.js +9 -2
  290. package/dist/install/modules/core.js +190 -27
  291. package/dist/install/modules/opencode.js +18 -23
  292. package/dist/install/network-allowlist.js +8 -3
  293. package/dist/install/project-docs.js +551 -0
  294. package/dist/install/template-copies.js +55 -5
  295. package/dist/install/write.js +117 -5
  296. package/dist/ledgers/journal.js +10 -8
  297. package/dist/ledgers/migrate.js +20 -9
  298. package/dist/ledgers/status.js +461 -8
  299. package/dist/ledgers/telemetry.js +71 -13
  300. package/dist/render/trackers.js +21 -12
  301. package/dist/shared/package-manager.js +7 -2
  302. package/dist/shared/settings.js +8 -0
  303. package/dist/shared/text.js +13 -0
  304. package/dist/tools/instructions-sources.js +1 -0
  305. package/dist/tools/instructions.js +97 -24
  306. package/package.json +23 -15
  307. package/.bkit/core/hooks/preflight-linear.sh +0 -73
  308. package/.bkit/shared/docs/architecture.md +0 -16
  309. package/.bkit/shared/docs/data-schema.md +0 -16
  310. package/.bkit/shared/docs/design.md +0 -38
  311. package/.bkit/shared/docs/noise.md +0 -20
  312. package/.bkit/shared/docs/observability.md +0 -22
  313. package/.bkit/shared/docs/security.md +0 -62
  314. package/.bkit/shared/docs/setup.md +0 -52
  315. package/.bkit/shared/docs/technology.md +0 -15
  316. /package/.bkit/templates/{.lintstagedrc.json → lintstagedrc.example.json} +0 -0
  317. /package/.bkit/templates/{.prettierignore → prettierignore.example} +0 -0
@@ -7,8 +7,9 @@
7
7
  // - "byte-equal-text" : delete only if unchanged since bkit wrote it (canonicalHashes)
8
8
  // 2. package.json: the `bkit` install-state block (full/core uninstall). Scripts and
9
9
  // devDeps are the consumer's — the bkit:gate:* names included — and are left alone.
10
- // 2b. docs/ (full/core uninstall): bkit's managed block stripped from every installed
11
- // `docs/*.md`, the owned `docs/templates/bkit-*.md` deleted.
10
+ // 2b. docs/ (full/core uninstall): the owned `docs/templates/bkit-*.md` deleted. The ten
11
+ // project documents (`docs/architecture.md` …) and their `Project Documents` index rows
12
+ // belong to the project and stay.
12
13
  // 3. .agents/ mirror files (bkit-prefix .md files in .claude/ .cursor/)
13
14
  //
14
15
  // Flags:
@@ -44,7 +45,6 @@ import {
44
45
  import {
45
46
  getBkitDocsRoot,
46
47
  getPkgRoot,
47
- getSharedRoot,
48
48
  findTemplateSource,
49
49
  TEMPLATE_COPIES_DIR,
50
50
  } from "../../shared/package-roots.js";
@@ -66,10 +66,10 @@ import {
66
66
  CLAUDE_CLOUD_RELPATH,
67
67
  CODEX_CLOUD_RELPATH,
68
68
  CURSOR_CLOUD_RELPATH,
69
- resolveClaudeDerivedAllows,
70
69
  } from "../../install/cloud-env.js";
71
70
  import type { ModuleFlag, UninstallFlags } from "../../cli.js";
72
71
  import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
72
+ import { isOpencodeSubstringFetchKey, redactUrlParts } from "../../checks/before/files.js";
73
73
  import { type McpServerMapKey, unusedTrackerMcpServers } from "../../checks/before/mcp.js";
74
74
 
75
75
  // ---------------------------------------------------------------------------
@@ -385,26 +385,6 @@ const CORE_TEMPLATE_DOCTRINE: ManifestEntry[] = [
385
385
  { path: ".bkit/lite.md", format: "markered-text", module: "core" },
386
386
  ];
387
387
 
388
- /**
389
- * The top-level `docs/*.md` the core payload pass installs: each carries bkit's managed
390
- * block (`bkit:start` / `bkit:end`, managed marker inside), so uninstall strips the block
391
- * and keeps the consumer's content, exactly like `.agents/*.md`. The payload's
392
- * `shared/docs/` holds only these block docs; `docs/capabilities.md` is a template
393
- * (copied, never installed) and is left alone.
394
- */
395
- function coreDocEntries(): ManifestEntry[] {
396
- const dir = path.join(getSharedRoot(), "docs");
397
- if (!fs.existsSync(dir)) return [];
398
- return fs
399
- .readdirSync(dir, { withFileTypes: true })
400
- .filter((e) => e.isFile() && e.name.endsWith(".md"))
401
- .map((e): ManifestEntry => ({
402
- path: path.join("docs", e.name),
403
- format: "markered-text",
404
- module: "core",
405
- }));
406
- }
407
-
408
388
  /** Prefix of the bkit-owned files under `docs/templates/`; uninstall deletes them whole. */
409
389
  const DOCS_TEMPLATES_DIR = path.join("docs", "templates");
410
390
  const isOwnedDocsTemplate = (name: string) => name.startsWith("bkit-") && name.endsWith(".md");
@@ -423,7 +403,7 @@ export function buildDecisionTable(
423
403
 
424
404
  const entries = [
425
405
  ...getInstallManifest(moduleList),
426
- ...(moduleList.includes("core") ? [...CORE_TEMPLATE_DOCTRINE, ...coreDocEntries()] : []),
406
+ ...(moduleList.includes("core") ? CORE_TEMPLATE_DOCTRINE : []),
427
407
  ];
428
408
 
429
409
  // The hash of every owned file as bkit last wrote it.
@@ -649,6 +629,11 @@ export async function runUninstall(
649
629
  }
650
630
  }
651
631
 
632
+ // The grants bkit wrote into `.claude/settings.json`, read before the loop below deletes
633
+ // `.bkit/version` on a full or core uninstall.
634
+ const claudeAllowDerived =
635
+ readBkitVersion(path.join(ctx.cwd, ".bkit", "version"))?.claudeAllowDerived ?? [];
636
+
652
637
  const table = buildDecisionTable(moduleList, ctx);
653
638
  result.decisions = table;
654
639
 
@@ -727,19 +712,18 @@ export async function runUninstall(
727
712
  // the resolved network allowlist and `mcp__…` grants per declared MCP
728
713
  // server (enrichClaudeSettingsAllows). Stripping
729
714
  // against the RAW template leaves those grants behind as if the consumer
730
- // had added them. Recompute the same set — the very function that produced
731
- // them — and treat it as part of the template, exactly as the opencode.json
732
- // sentinel render above does.
715
+ // had added them. `.bkit/version` records exactly the rows install wrote
716
+ // (`claudeAllowDerived`); treat them as part of the template. A derived-looking
717
+ // row the record lacks has unknown ownership: it stays and is listed for review.
733
718
  if (summary.file === path.join(".claude", "settings.json")) {
734
719
  const perms = templateDoc.permissions;
735
720
  if (perms !== null && typeof perms === "object" && !Array.isArray(perms)) {
736
721
  const permsObj = perms as Record<string, JsonValue>;
737
722
  const allow = permsObj.allow;
738
723
  if (Array.isArray(allow)) {
739
- const enriched = resolveClaudeDerivedAllows(ctx.cwd);
740
724
  permsObj.allow = [
741
725
  ...allow,
742
- ...enriched.filter((e) => !allow.includes(e)),
726
+ ...claudeAllowDerived.filter((e) => !allow.includes(e)),
743
727
  ] as JsonValue;
744
728
  }
745
729
  }
@@ -749,6 +733,34 @@ export async function runUninstall(
749
733
  : isOpencodeJson
750
734
  ? stripOpencodeJsonScope(consumerDoc, templatePath, ctx.cwd)
751
735
  : stripTier2JsonScope(consumerDoc, templateDoc);
736
+ if (summary.file === path.join(".claude", "settings.json")) {
737
+ const remaining = (stripped.permissions as { allow?: unknown } | undefined)?.allow;
738
+ if (Array.isArray(remaining)) {
739
+ for (const row of remaining) {
740
+ if (
741
+ typeof row === "string" &&
742
+ /^(WebFetch\(domain:|mcp__)/.test(row) &&
743
+ !claudeAllowDerived.includes(row)
744
+ ) {
745
+ console.log(
746
+ `${ctx.logPrefix} review: ${summary.file} keeps ${row} — .bkit/version does not record it as bkit-written; remove it by hand if bkit added it`,
747
+ );
748
+ }
749
+ }
750
+ }
751
+ }
752
+ if (isOpencodeJson) {
753
+ const bash = (stripped.permission as { bash?: unknown } | undefined)?.bash;
754
+ if (bash !== null && typeof bash === "object" && !Array.isArray(bash)) {
755
+ for (const [key, value] of Object.entries(bash as Record<string, unknown>)) {
756
+ if (value === "allow" && isOpencodeSubstringFetchKey(key)) {
757
+ console.log(
758
+ `${ctx.logPrefix} review: ${summary.file} keeps legacy substring grant \`${redactUrlParts(key)}\` in permission.bash — remove it by hand if you did not add it`,
759
+ );
760
+ }
761
+ }
762
+ }
763
+ }
752
764
  const strippedJson = JSON.stringify(stripped, null, 2) + "\n";
753
765
  if (Object.keys(stripped).length === 0) {
754
766
  // All keys were bkit-owned → delete file
@@ -61,6 +61,7 @@ import { readBkitConfig } from "../../shared/settings.js";
61
61
  import { detectInstalledHostModules } from "../../install/hosts.js";
62
62
  import { detectInstalledModules } from "./check.js";
63
63
  import { remapTemplateDest } from "../../install/template-copies.js";
64
+ import { syncProjectDocs } from "../../install/project-docs.js";
64
65
  import {
65
66
  CLAUDE_CLOUD_RELPATH,
66
67
  CODEX_CLOUD_RELPATH,
@@ -70,7 +71,11 @@ import {
70
71
  writeCursorCloudDoc,
71
72
  writeCursorCliPermissionsArtifact,
72
73
  } from "../../install/cloud-env.js";
73
- import { syncTemplateCopies, formatTemplateChanges } from "../../install/template-copies.js";
74
+ import {
75
+ syncTemplateCopies,
76
+ formatTemplateChanges,
77
+ warnMissingLintStagedConfig,
78
+ } from "../../install/template-copies.js";
74
79
  import { formatPayloadLinkChanges, syncPayloadLinks } from "../../install/payload-links.js";
75
80
  import { renderOpencodeJson, reconcileOpencodeJson } from "../../install/modules/opencode.js";
76
81
  import { type ModuleContext, renderManagedOutputs } from "../../install/modules/index.js";
@@ -811,7 +816,7 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
811
816
  dryRun: upgradeFlags.dryRun,
812
817
  ws: { writes: [] },
813
818
  });
814
- const templateReport = formatTemplateChanges(templateChanges);
819
+ const templateReport = formatTemplateChanges(templateChanges, process.cwd());
815
820
  if (templateReport) console.log(`${LOG_PREFIX} ${templateReport}`);
816
821
 
817
822
  // Payload view links — the same sync install runs (`.bkit/core` + `.bkit/shared`
@@ -1017,6 +1022,11 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
1017
1022
  }
1018
1023
  }
1019
1024
 
1025
+ // Project documents belong to the project: remove a legacy ownership wrapper and register each
1026
+ // present document in `Project Documents` (a dry run only prints the preview). They carry no
1027
+ // hash, so nothing here feeds `.bkit/version`.
1028
+ syncProjectDocs(process.cwd(), { dryRun: upgradeFlags.dryRun });
1029
+
1020
1030
  // Refresh canonicalHashes (from resulting on-disk content) AND bump pinnedVersion
1021
1031
  // to the version we just upgraded TO, so the next `bkit check` has nothing to write.
1022
1032
  // Called unconditionally (non-dry-run) so the pin bumps even when every file was a
@@ -1059,6 +1069,8 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
1059
1069
  );
1060
1070
 
1061
1071
  // `.bkit/advisories.md` describes the upgraded repo, not the last install or check.
1072
+ // A real upgrade prints the missing-lint-staged line through the advisories; a dry run prints it here.
1073
+ if (upgradeFlags.dryRun) warnMissingLintStagedConfig(process.cwd(), LOG_PREFIX);
1062
1074
  if (!upgradeFlags.dryRun) await runUpgradeAdvisories();
1063
1075
 
1064
1076
  // Non-interactive mode: exit non-zero on conflicts
@@ -17,9 +17,8 @@ import { gitEnv } from "../ledgers/telemetry.js";
17
17
  import { readBkitConfig } from "../shared/settings.js";
18
18
  import { readPackageJson } from "../shared/package-json.js";
19
19
  import { installCommand } from "../shared/package-manager.js";
20
- import { minPushPathspecs } from "./ci/ci.js";
20
+ import { minPushOutside, minPushPathspecs } from "./ci/ci.js";
21
21
  import { requiredPushGate, runPushGate } from "./ci/push-gate.js";
22
- import { changedOutside } from "./workflow/ledgers.js";
23
22
 
24
23
  const REMOTE = "origin";
25
24
  const UPSTREAM = `${REMOTE}/${DEV}`;
@@ -195,7 +194,7 @@ function checkLanding(root: string, dir: string, base: string, log: (line: strin
195
194
  throw new CommandError(EXIT.NO, "landing checkout is not clean — nothing pushed");
196
195
  if (!readPackageJson(dir).ok)
197
196
  throw new CommandError(EXIT.NO, "landing package.json is unreadable — nothing pushed");
198
- const diff = changedOutside(dir, base, head!, minPushPathspecs(readBkitConfig(dir)));
197
+ const diff = minPushOutside(dir, base, head!, minPushPathspecs(readBkitConfig(dir)));
199
198
  if (!diff.ok) throw new CommandError(EXIT.NO, `cannot classify landing: ${diff.stderr}`);
200
199
  const gate = diff.outside.length === 0 ? "bkit:gate:min" : requiredPushGate(dir);
201
200
  if (!gate) throw new CommandError(EXIT.NO, "landing has no declared full gate — nothing pushed");