@cbartens/bkit 5.0.3 → 5.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 (212) hide show
  1. package/.bkit/README.md +14 -10
  2. package/.bkit/core/.agents/docs.md +1 -0
  3. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +93 -0
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +137 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +72 -0
  6. package/.bkit/core/.agents/rules.md +10 -6
  7. package/.bkit/core/.agents/shortcuts.md +73 -0
  8. package/.bkit/core/.agents/skills.md +5 -3
  9. package/.bkit/core/.bkit/LICENSE.md +18 -140
  10. package/.bkit/core/.bkit/README.md +13 -9
  11. package/.bkit/core/.bkit/cloud.md +12 -15
  12. package/.bkit/core/.bkit/comparison.md +68 -16
  13. package/.bkit/core/.bkit/install.md +36 -11
  14. package/.bkit/core/.bkit/jsonl.md +0 -1
  15. package/.bkit/core/.bkit/prompts.md +83 -81
  16. package/.bkit/core/.bkit/providers.md +110 -28
  17. package/.bkit/core/.bkit/templates.md +42 -13
  18. package/.bkit/core/.bkit/workflows.md +64 -42
  19. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +4 -3
  20. package/.bkit/core/.claude/hooks/bkit-readguard.cjs +60 -0
  21. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +8 -6
  22. package/.bkit/core/.codex/hooks/bkit-readguard.cjs +58 -0
  23. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +12 -19
  24. package/.bkit/core/.cursor/hooks/bkit-readguard.cjs +59 -0
  25. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +73 -22
  26. package/.bkit/core/.opencode/plugin/bkit-readguard.js +126 -0
  27. package/.bkit/core/AGENTS.md +11 -0
  28. package/.bkit/core/docs/templates/bkit-audit-adoption.md +2 -2
  29. package/.bkit/core/docs/templates/bkit-plan.md +6 -3
  30. package/.bkit/core/engine/checks/after/auth.ts +32 -0
  31. package/.bkit/core/engine/checks/after/github.ts +4 -4
  32. package/.bkit/core/engine/checks/after/index.ts +36 -50
  33. package/.bkit/core/engine/checks/after/managed.ts +44 -1
  34. package/.bkit/core/engine/checks/before/index.ts +5 -4
  35. package/.bkit/core/engine/checks/before/mcp.ts +60 -54
  36. package/.bkit/core/engine/checks/status-holes.ts +1 -1
  37. package/.bkit/core/engine/checks/tips/catalogue.ts +356 -0
  38. package/.bkit/core/engine/checks/tips/detect.ts +144 -0
  39. package/.bkit/core/engine/checks/tips/index.ts +174 -0
  40. package/.bkit/core/engine/cli.ts +82 -18
  41. package/.bkit/core/engine/commands/install/check.ts +2 -0
  42. package/.bkit/core/engine/commands/install/doctor.ts +14 -1
  43. package/.bkit/core/engine/commands/install/install.ts +59 -9
  44. package/.bkit/core/engine/commands/install/uninstall.ts +59 -34
  45. package/.bkit/core/engine/commands/install/upgrade.ts +30 -28
  46. package/.bkit/core/engine/commands/launch.ts +33 -11
  47. package/.bkit/core/engine/commands/tips.ts +16 -0
  48. package/.bkit/core/engine/commands/workflow/prs.ts +20 -2
  49. package/.bkit/core/engine/commands/workflow/runs.ts +82 -18
  50. package/.bkit/core/engine/commands/workflow/runtime.ts +12 -0
  51. package/.bkit/core/engine/commands/workflow/steps.ts +1 -0
  52. package/.bkit/core/engine/commands/workflow/tests.ts +647 -4
  53. package/.bkit/core/engine/commands/workflow/workstreams.ts +4 -4
  54. package/.bkit/core/engine/install/cloud-env.ts +7 -21
  55. package/.bkit/core/engine/install/hosts.ts +21 -0
  56. package/.bkit/core/engine/install/managed-block.ts +36 -0
  57. package/.bkit/core/engine/install/manifest.ts +83 -5
  58. package/.bkit/core/engine/install/modules/antigravity.ts +266 -0
  59. package/.bkit/core/engine/install/modules/claude.ts +6 -6
  60. package/.bkit/core/engine/install/modules/cloud.ts +2 -2
  61. package/.bkit/core/engine/install/modules/codex.ts +8 -5
  62. package/.bkit/core/engine/install/modules/core.ts +30 -10
  63. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  64. package/.bkit/core/engine/install/modules/index.ts +33 -6
  65. package/.bkit/core/engine/install/modules/opencode.ts +4 -4
  66. package/.bkit/core/engine/install/payload-links.ts +6 -10
  67. package/.bkit/core/engine/install/placeholders.ts +1 -1
  68. package/.bkit/core/engine/install/version-file.ts +17 -9
  69. package/.bkit/core/engine/install/write.ts +68 -1
  70. package/.bkit/core/engine/ledgers/telemetry.ts +0 -2
  71. package/.bkit/core/engine/render/hosts.ts +174 -1
  72. package/.bkit/core/engine/render/models.ts +10 -0
  73. package/.bkit/core/engine/shared/package-roots.ts +8 -10
  74. package/.bkit/core/hooks/antigravity-hook.js +67 -0
  75. package/.bkit/core/hooks/gateguard-edit-payload.js +4 -4
  76. package/.bkit/core/hooks/gateguard-engine.js +16 -6
  77. package/.bkit/core/hooks/guardrails-read.js +23 -0
  78. package/.bkit/core/hooks/readguard-engine.js +259 -0
  79. package/.bkit/core/hooks/readguard-payload.js +67 -0
  80. package/.bkit/core/prompts/bkit-audit-generate.md +2 -1
  81. package/.bkit/core/prompts/bkit-build-challenge-1.md +2 -1
  82. package/.bkit/core/prompts/bkit-build-challenge-2.md +2 -1
  83. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +2 -1
  84. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +2 -1
  85. package/.bkit/core/prompts/bkit-build-challenge-tests.md +2 -1
  86. package/.bkit/core/prompts/bkit-build-install-skills.md +7 -5
  87. package/.bkit/core/prompts/bkit-build-plan-current.md +2 -1
  88. package/.bkit/core/prompts/bkit-build-plan-execute.md +6 -2
  89. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +2 -1
  90. package/.bkit/core/prompts/bkit-build-plan-verify.md +12 -4
  91. package/.bkit/core/prompts/bkit-build-summary.md +2 -1
  92. package/.bkit/core/prompts/bkit-debug-abort-handover.md +2 -1
  93. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +2 -1
  94. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +2 -1
  95. package/.bkit/core/prompts/bkit-debug-failure-soak.md +2 -1
  96. package/.bkit/core/prompts/bkit-debug-summary.md +2 -1
  97. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +2 -1
  98. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +2 -1
  99. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +2 -1
  100. package/.bkit/core/prompts/bkit-design-generate.md +10 -5
  101. package/.bkit/core/prompts/bkit-design-organise.md +2 -1
  102. package/.bkit/core/prompts/bkit-design-review-1.md +2 -1
  103. package/.bkit/core/prompts/bkit-design-review-2.md +2 -1
  104. package/.bkit/core/prompts/bkit-design-spike.md +2 -1
  105. package/.bkit/core/prompts/bkit-design-summary.md +2 -1
  106. package/.bkit/core/prompts/bkit-design-update.md +2 -1
  107. package/.bkit/core/prompts/bkit-plan-complexity-check.md +2 -1
  108. package/.bkit/core/prompts/bkit-plan-complexity-split.md +4 -3
  109. package/.bkit/core/prompts/bkit-plan-generate.md +2 -1
  110. package/.bkit/core/prompts/bkit-plan-review-1.md +2 -1
  111. package/.bkit/core/prompts/bkit-plan-review-2.md +2 -1
  112. package/.bkit/core/prompts/bkit-plan-review-3.md +2 -1
  113. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +3 -2
  114. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +3 -2
  115. package/.bkit/core/prompts/bkit-plan-summary.md +2 -1
  116. package/.bkit/core/prompts/bkit-plan-update.md +3 -2
  117. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +2 -1
  118. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +2 -1
  119. package/.bkit/core/prompts/bkit-ship-summary.md +2 -1
  120. package/.bkit/core/prompts/bkit-ship-update-docs.md +2 -1
  121. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +2 -1
  122. package/.bkit/core/prompts/bkit-utility-update-decisions.md +2 -1
  123. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +2 -1
  124. package/.bkit/core/prompts/bkit-utility-update-documentation.md +2 -1
  125. package/.bkit/core/prompts/bkit-utility-update-failures.md +2 -1
  126. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +2 -1
  127. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +4 -3
  128. package/.bkit/core/workflows/bkit-auto.md +1 -1
  129. package/.bkit/core/workflows/bkit-build.md +35 -21
  130. package/.bkit/core/workflows/bkit-debug.md +31 -22
  131. package/.bkit/core/workflows/bkit-design.md +83 -38
  132. package/.bkit/core/workflows/bkit-plan.md +10 -2
  133. package/.bkit/core/workflows/bkit-ship.md +10 -2
  134. package/.bkit/shared/.agents/plugins/bkit/hooks.json +36 -0
  135. package/.bkit/shared/.agents/plugins/bkit/plugin.json +5 -0
  136. package/.bkit/shared/.claude/settings.json +19 -0
  137. package/.bkit/shared/.codex/hooks.json +21 -0
  138. package/.bkit/shared/.cursor/hooks.json +6 -1
  139. package/.bkit/shared/.opencode/opencode.json +1 -1
  140. package/.bkit/shared/GEMINI.md +11 -0
  141. package/.bkit/shared/docs/deployments.md +1 -1
  142. package/.bkit/shared/docs/security.md +3 -3
  143. package/.bkit/shared/docs/testing.md +12 -1
  144. package/.bkit/templates/.github/dependabot.yml +6 -0
  145. package/.bkit/templates/.github/renovate.json5 +3 -3
  146. package/.bkit/templates/.github/workflows/bkit-ci.yml +24 -13
  147. package/.bkit/templates/.github/workflows/bkit-cloud.yml +5 -5
  148. package/.bkit/templates/.prettierignore +4 -1
  149. package/.bkit/templates/context/bkit-expo.md +22 -13
  150. package/.bkit/templates/context/bkit-github.md +20 -6
  151. package/.bkit/templates/context/bkit-inngest.md +10 -4
  152. package/.bkit/templates/context/bkit-maestro.md +5 -5
  153. package/.bkit/templates/context/bkit-playwright.md +3 -3
  154. package/.bkit/templates/context/bkit-sentry.md +6 -5
  155. package/.bkit/templates/context/bkit-stripe.md +31 -8
  156. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +65 -19
  157. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +34 -0
  158. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +33 -12
  159. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +54 -0
  160. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +2 -2
  161. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +76 -6
  162. package/.bkit/templates/slop-scan.config.json +10 -3
  163. package/CHANGELOG.md +62 -0
  164. package/LICENSE.md +21 -161
  165. package/README.md +66 -35
  166. package/dist/checks/after/auth.js +28 -0
  167. package/dist/checks/after/github.js +4 -4
  168. package/dist/checks/after/index.js +29 -45
  169. package/dist/checks/after/managed.js +41 -1
  170. package/dist/checks/before/index.js +5 -4
  171. package/dist/checks/before/mcp.js +53 -53
  172. package/dist/checks/status-holes.js +1 -1
  173. package/dist/checks/tips/catalogue.js +297 -0
  174. package/dist/checks/tips/detect.js +130 -0
  175. package/dist/checks/tips/index.js +146 -0
  176. package/dist/cli.js +68 -17
  177. package/dist/commands/install/check.js +2 -0
  178. package/dist/commands/install/doctor.js +9 -1
  179. package/dist/commands/install/install.js +49 -8
  180. package/dist/commands/install/uninstall.js +61 -34
  181. package/dist/commands/install/upgrade.js +31 -33
  182. package/dist/commands/launch.js +27 -11
  183. package/dist/commands/tips.js +10 -0
  184. package/dist/commands/workflow/prs.js +13 -1
  185. package/dist/commands/workflow/runs.js +74 -18
  186. package/dist/commands/workflow/runtime.js +8 -0
  187. package/dist/commands/workflow/steps.js +1 -0
  188. package/dist/commands/workflow/tests.js +541 -4
  189. package/dist/commands/workflow/workstreams.js +4 -4
  190. package/dist/install/cloud-env.js +3 -14
  191. package/dist/install/hosts.js +22 -0
  192. package/dist/install/managed-block.js +36 -0
  193. package/dist/install/manifest.js +79 -4
  194. package/dist/install/modules/antigravity.js +225 -0
  195. package/dist/install/modules/claude.js +6 -6
  196. package/dist/install/modules/cloud.js +2 -2
  197. package/dist/install/modules/codex.js +8 -5
  198. package/dist/install/modules/core.js +21 -6
  199. package/dist/install/modules/cursor.js +6 -6
  200. package/dist/install/modules/index.js +17 -6
  201. package/dist/install/modules/opencode.js +4 -4
  202. package/dist/install/payload-links.js +5 -5
  203. package/dist/install/placeholders.js +1 -1
  204. package/dist/install/version-file.js +12 -3
  205. package/dist/install/write.js +61 -2
  206. package/dist/render/hosts.js +149 -1
  207. package/dist/render/models.js +9 -0
  208. package/dist/shared/package-roots.js +8 -11
  209. package/package.json +8 -8
  210. package/.bkit/core/LICENSE.md +0 -149
  211. package/.bkit/shared/LICENSE.md +0 -22
  212. package/.bkit/templates/LICENSE.md +0 -22
@@ -0,0 +1,146 @@
1
+ // checks/tips/index.ts — collect the firing setup tips and render them for `bkit tips`, the
2
+ // console checklist and `.bkit/advisories.md`. Catalogue + priority: ./catalogue.ts.
3
+ import { ignoredAdvisoryIds, } from "../after/suppression.js";
4
+ import { SETUP_TIPS } from "./catalogue.js";
5
+ /** Tips `bkit tips` prints without `--all` or `--workflow`. */
6
+ export const TIPS_CAP = 3;
7
+ /** Tips a workflow prints at its close (`bkit tips --workflow=<name>`). */
8
+ export const WORKFLOW_TIPS_CAP = 1;
9
+ /** Section heading in the console checklist and `.bkit/advisories.md`. */
10
+ export const SETUP_TIPS_HEADING = "Setup tips";
11
+ /** Opening line of `bkit tips` output, by how many tips it prints. */
12
+ export const tipsIntro = (n) => n === 1 ? "Setup tip for a smoother next run:" : "Setup tips for a smoother next run:";
13
+ /** Where the full tip list lives. */
14
+ export const TIPS_DETAILS_POINTER = "Details for every tip: .bkit/advisories.md § Setup tips (refreshed by `bkit check`).";
15
+ /** Intro of the Setup tips section: who reads which field, and how to silence a tip. */
16
+ export const TIPS_SECTION_INTRO = "Things not set up yet, most useful first. For the person: each tip says what goes wrong today and a sentence to ask your agent. For an AI agent: follow each tip's Agent steps unless the person declines it. Silence a tip by adding its id to `bkit.ignoreAdvisories` in package.json. Full template catalogue: .bkit/templates.md.";
17
+ /** True when advisory `id` matches catalogue pattern `pattern` (trailing `*` = prefix). */
18
+ export function matchesAdvisory(pattern, id) {
19
+ return pattern.endsWith("*") ? id.startsWith(pattern.slice(0, -1)) : id === pattern;
20
+ }
21
+ /** True when `ignored` names the tip's id or any advisory id it reuses. */
22
+ export function isTipSilenced(tip, ignored) {
23
+ if (ignored.has(tip.id))
24
+ return true;
25
+ const patterns = tip.advisories ?? [];
26
+ return [...ignored].some((id) => patterns.some((p) => matchesAdvisory(p, id)));
27
+ }
28
+ /** Every firing tip in priority order, minus the ones the root package.json silences. */
29
+ export function collectTips(cwd, catalogue = SETUP_TIPS) {
30
+ const ignored = ignoredAdvisoryIds(cwd);
31
+ const tips = [];
32
+ const suppressed = [];
33
+ for (const tip of catalogue) {
34
+ if (!tip.fires(cwd))
35
+ continue;
36
+ if (isTipSilenced(tip, ignored))
37
+ suppressed.push({ id: tip.id, scope: "." });
38
+ else
39
+ tips.push(tip);
40
+ }
41
+ return { tips, suppressed };
42
+ }
43
+ /**
44
+ * Drop advisory findings whose tip the root package.json silenced, so one
45
+ * `bkit.ignoreAdvisories` entry silences a tip and the advisories it reuses. Blockers are
46
+ * never dropped.
47
+ */
48
+ export function dropTipSilencedAdvisories(findings, cwd, onSuppressed, catalogue = SETUP_TIPS) {
49
+ const ignored = ignoredAdvisoryIds(cwd);
50
+ if (ignored.size === 0)
51
+ return findings;
52
+ const patterns = catalogue
53
+ .filter((tip) => isTipSilenced(tip, ignored))
54
+ .flatMap((tip) => tip.advisories ?? []);
55
+ return findings.filter((f) => {
56
+ if (f.severity !== "advisory" || !patterns.some((p) => matchesAdvisory(p, f.id)))
57
+ return true;
58
+ onSuppressed?.({ id: f.id, scope: "." });
59
+ return false;
60
+ });
61
+ }
62
+ /** One tip as numbered terminal lines: title, then line, ask and caution indented. */
63
+ function tipTextLines(tip, n) {
64
+ const lines = [`${n}. ${tip.title}`, ` ${tip.line}`, ` Ask your agent: "${tip.ask}"`];
65
+ if (tip.caution)
66
+ lines.push(` Caution: ${tip.caution}`);
67
+ return lines;
68
+ }
69
+ /** One tip as markdown paragraphs for a workflow's `## Setup Tips` section. */
70
+ function tipMarkdownLines(tip) {
71
+ const lines = [`**${tip.title}.** ${tip.line}`, "", `Ask your agent: "${tip.ask}"`];
72
+ if (tip.caution)
73
+ lines.push("", `Caution: ${tip.caution}`);
74
+ return lines;
75
+ }
76
+ /**
77
+ * `tips` with the ones that matter in `workflow` first, each group in catalogue order.
78
+ * Comms tips name every workflow, so they stay first everywhere.
79
+ */
80
+ export function orderForWorkflow(tips, workflow) {
81
+ const own = tips.filter((t) => t.workflows?.includes(workflow));
82
+ return [...own, ...tips.filter((t) => !own.includes(t))];
83
+ }
84
+ /**
85
+ * `bkit tips` output, then where the rest live. `""` when no tip fires.
86
+ * - `workflow`: the `WORKFLOW_TIPS_CAP` tips that matter most in that workflow, as
87
+ * markdown paragraphs with no intro or numbers — the workflow appends them under its
88
+ * own `## Setup Tips` heading.
89
+ * - neither: the top `TIPS_CAP` tips as a numbered terminal list.
90
+ * - `all`: every tip as a numbered list (in the workflow's order when `workflow` is set).
91
+ */
92
+ export function formatTips(tips, opts = {}) {
93
+ if (tips.length === 0)
94
+ return "";
95
+ const ordered = opts.workflow ? orderForWorkflow(tips, opts.workflow) : [...tips];
96
+ const cap = opts.workflow ? WORKFLOW_TIPS_CAP : TIPS_CAP;
97
+ const shown = opts.all ? ordered : ordered.slice(0, cap);
98
+ const rest = tips.length - shown.length;
99
+ const more = rest > 0 ? `${rest} more: \`bkit tips --all\`. ` : "";
100
+ if (opts.workflow && !opts.all) {
101
+ const lines = [];
102
+ for (const tip of shown)
103
+ lines.push(...tipMarkdownLines(tip), "");
104
+ lines.push(`${more}${TIPS_DETAILS_POINTER}`);
105
+ return lines.join("\n");
106
+ }
107
+ const lines = [tipsIntro(shown.length), ""];
108
+ shown.forEach((tip, i) => lines.push(...tipTextLines(tip, i + 1), ""));
109
+ if (more)
110
+ lines.push(more.trimEnd());
111
+ lines.push(TIPS_DETAILS_POINTER);
112
+ return lines.join("\n");
113
+ }
114
+ /** The Setup tips block of the console checklist. `[]` when no tip fires. */
115
+ export function setupTipsChecklistLines(tips) {
116
+ if (tips.length === 0)
117
+ return [];
118
+ const lines = [`--- ${SETUP_TIPS_HEADING} ---`, TIPS_SECTION_INTRO, ""];
119
+ tips.forEach((tip, i) => {
120
+ lines.push(`${i + 1}. ${tip.title} (${tip.id})`);
121
+ lines.push(` ${tip.line}`);
122
+ lines.push(` Why: ${tip.why}`);
123
+ if (tip.caution)
124
+ lines.push(` Caution: ${tip.caution}`);
125
+ lines.push(` Ask your agent: "${tip.ask}"`);
126
+ lines.push(` Agent steps: ${tip.steps}`);
127
+ lines.push("");
128
+ });
129
+ return lines;
130
+ }
131
+ /** The `## Setup tips` section of `.bkit/advisories.md`. `[]` when no tip fires. */
132
+ export function setupTipsMarkdownLines(tips) {
133
+ if (tips.length === 0)
134
+ return [];
135
+ const lines = [`## ${SETUP_TIPS_HEADING}`, "", `> ${TIPS_SECTION_INTRO}`, ""];
136
+ tips.forEach((tip, i) => {
137
+ lines.push(`### ${i + 1}. ${tip.title} (\`${tip.id}\`)`, "");
138
+ lines.push(tip.line, "");
139
+ lines.push(`**Why:** ${tip.why}`, "");
140
+ if (tip.caution)
141
+ lines.push(`**Caution:** ${tip.caution}`, "");
142
+ lines.push(`**Ask your agent:** "${tip.ask}"`, "");
143
+ lines.push(`**Agent steps:** ${tip.steps}`, "");
144
+ });
145
+ return lines;
146
+ }
package/dist/cli.js CHANGED
@@ -13,6 +13,7 @@ import { runComplyCommand } from "./commands/comply.js";
13
13
  import { runHarvestCommand } from "./commands/harvest.js";
14
14
  import { runAnalysisCommand } from "./commands/analysis.js";
15
15
  import { runTelemetryCommand } from "./commands/telemetry.js";
16
+ import { runTipsCommand } from "./commands/tips.js";
16
17
  import { runUpgradeCommand } from "./commands/install/upgrade.js";
17
18
  import { runUninstallCommand } from "./commands/install/uninstall.js";
18
19
  import { runInstall } from "./commands/install/install.js";
@@ -41,6 +42,7 @@ export const CLASSIC_VERBS = new Set([
41
42
  "harvest",
42
43
  "analysis",
43
44
  "telemetry",
45
+ "tips",
44
46
  "cursor",
45
47
  "opencode",
46
48
  "help",
@@ -70,9 +72,9 @@ export function parseComplyPhase(value) {
70
72
  // Bare module-flag tokens accepted on the CLI. `opencode` (value-bearing) is
71
73
  // intercepted by a dedicated branch in parseArgs before this set is consulted; the
72
74
  // generic check only ever validates claude/cursor/codex. `full`, `core` and `cloud`
73
- // are NOT accepted as bare flags: use `--auto=<claude|cursor>`; core is implicit.
75
+ // are NOT accepted as bare flags: use `--auto=<variant>`; core is implicit.
74
76
  // There is no dependency-updater flag. Copy an example; CI warns when none is present.
75
- const MODULE_FLAGS = new Set(["claude", "cursor", "opencode", "codex"]);
77
+ const MODULE_FLAGS = new Set(["claude", "cursor", "opencode", "codex", "antigravity"]);
76
78
  // ALL_MODULES — every non-opt-in module, core first. Used to expand a bare/full
77
79
  // uninstall (which additionally pulls in the opt-in add-ons below for zero footprint).
78
80
  const ALL_MODULES = ["core", "claude", "cursor"];
@@ -158,6 +160,10 @@ export function parseArgs(argv) {
158
160
  verb = "telemetry";
159
161
  args.shift();
160
162
  }
163
+ else if (firstArg === "tips") {
164
+ verb = "tips";
165
+ args.shift();
166
+ }
161
167
  else if (firstArg === "cursor" || firstArg === "opencode") {
162
168
  verb = firstArg;
163
169
  args.shift();
@@ -186,6 +192,8 @@ export function parseArgs(argv) {
186
192
  let opencodeProvider = null;
187
193
  let complyPhase = null;
188
194
  let telemetrySubverb = null;
195
+ let tipsAll = false;
196
+ let tipsWorkflow = null;
189
197
  // For `telemetry` verb: extract the sub-verb from the first remaining positional arg
190
198
  if (verb === "telemetry") {
191
199
  const subVerbArg = args[0];
@@ -244,7 +252,7 @@ export function parseArgs(argv) {
244
252
  console.error(`[bkit] --phase requires a value: --phase=<${COMPLY_PHASES.join("|")}>. Run \`bkit help\` for usage.`);
245
253
  process.exit(1);
246
254
  }
247
- // Value-bearing flag: --auto=<claude|cursor> — cloud-agent (auto-dispatch) lane;
255
+ // Value-bearing flag: --auto=<variant> (CLOUD_VARIANTS) — cloud-agent (auto-dispatch) lane;
248
256
  // sets the internal `cloud` module. Bare `--auto` (no variant) is accepted only on
249
257
  // uninstall (variant read from package.json).
250
258
  if (flag === "auto") {
@@ -284,6 +292,10 @@ export function parseArgs(argv) {
284
292
  console.error(`[bkit] --codex takes no value (got ${JSON.stringify("--" + flag)}). Codex CLI runs on one gateway (openai), so the flag is bare: --codex. Only --opencode is provider-pluggable.`);
285
293
  process.exit(1);
286
294
  }
295
+ if (flag.startsWith("antigravity=")) {
296
+ console.error(`[bkit] --antigravity takes no value (got ${JSON.stringify("--" + flag)}). Antigravity runs on one gateway (google), so the flag is bare: --antigravity. Only --opencode is provider-pluggable.`);
297
+ process.exit(1);
298
+ }
287
299
  if (flag.startsWith("opencode=")) {
288
300
  const rawValue = flag.slice("opencode=".length);
289
301
  if (!rawValue) {
@@ -298,6 +310,21 @@ export function parseArgs(argv) {
298
310
  moduleFlags.add("opencode");
299
311
  continue;
300
312
  }
313
+ // Tips-only flags: --all prints every firing tip; --workflow=<name> puts the tips that
314
+ // matter in that workflow first and prints one.
315
+ if (flag === "all" && verb === "tips") {
316
+ tipsAll = true;
317
+ continue;
318
+ }
319
+ if (flag.startsWith("workflow=") && verb === "tips") {
320
+ const value = flag.slice("workflow=".length);
321
+ tipsWorkflow = parseComplyPhase(value);
322
+ if (tipsWorkflow === null) {
323
+ console.error(`[bkit] Unknown workflow: "${value}". Valid values: ${COMPLY_PHASES.join(", ")}`);
324
+ process.exit(1);
325
+ }
326
+ continue;
327
+ }
301
328
  // Uninstall-specific flags (accepted for all verbs that use them)
302
329
  if (flag === "dry-run") {
303
330
  uninstallFlags.dryRun = true;
@@ -382,6 +409,8 @@ export function parseArgs(argv) {
382
409
  opencodeProvider,
383
410
  complyPhase,
384
411
  telemetrySubverb,
412
+ tipsAll,
413
+ tipsWorkflow,
385
414
  };
386
415
  }
387
416
  export function printUsage() {
@@ -391,7 +420,8 @@ Usage:
391
420
  bkit install <module-flags> Install (or re-sync) the named modules + the implicit
392
421
  core foundation. At least one module flag is REQUIRED —
393
422
  a bare \`bkit install\` errors (name the modules below).
394
- Hosts compose: --claude --cursor --codex --opencode=<provider>.
423
+ Hosts compose: --claude --cursor --codex --antigravity
424
+ --opencode=<provider>.
395
425
  bkit check Dry-run — drift-check everything already installed (no
396
426
  module flags). Exits 1 when a managed file needs
397
427
  re-rendering. Copies under .bkit/templates/ are refreshed by
@@ -418,6 +448,13 @@ Usage:
418
448
  targeted uninstall leaves core untouched.
419
449
  bkit doctor Read-only preflight + post-install advisory replay.
420
450
  Diagnose token surfaces and config drift. Exits 0.
451
+ bkit tips [--workflow=<name>] [--all]
452
+ Setup tips: what this repo has not set up yet, most useful
453
+ first, each with a sentence to ask your agent. Top three
454
+ by default; --workflow=design|plan|build|debug|ship puts
455
+ the tips that matter there first and prints one (each
456
+ workflow runs this at its close); --all lists every one.
457
+ Local checks only. Exits 0.
421
458
  bkit status Read-only host/provider status. Reports current host+provider
422
459
  (sampled from .opencode/opencode.json, .claude/, .cursor/).
423
460
  Writes nothing. Exits 0.
@@ -468,12 +505,12 @@ Usage:
468
505
 
469
506
  Core (implicit — no flag; installed/upgraded on every install):
470
507
  AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
471
- .agents/docs.md + .agents/skills.md managed blocks, .gitignore + .gitattributes managed
472
- blocks, docs/, .bkit/*.md, .bkit/version, the template copies in .bkit/templates/, and
473
- the bkit:gate:* / bkit:deps:* package.json scripts every workflow runs (added when
474
- missing, never overwritten, left by uninstall). The tool scripts those gates chain
475
- (typecheck, lint, format:check, lint:prose, slop:delta) and their devDeps are yours
476
- to add: see .bkit/templates.md.
508
+ .agents/docs.md + .agents/shortcuts.md + .agents/skills.md managed blocks, .gitignore +
509
+ .gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
510
+ .bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
511
+ runs (added when missing, never overwritten, left by uninstall). The tool scripts those
512
+ gates chain (typecheck, lint, format:check, lint:prose, slop:delta) and their devDeps are
513
+ yours to add: see .bkit/templates.md.
477
514
 
478
515
  Module flags (composable; symmetric install ↔ uninstall):
479
516
  --claude .claude/agents/ + .claude/commands/ (byte-identical mirror) + CLAUDE.md
@@ -487,14 +524,22 @@ Module flags (composable; symmetric install ↔ uninstall):
487
524
  Provider value is REQUIRED. Supported: openrouter, ollama,
488
525
  opencode-zen, opencode-go (opencode-native gateways;
489
526
  auth via BKIT_OPENCODE_API_KEY).
490
- Ships .opencode/** (agents, commands, opencode.json, bkit-gateguard.js).
527
+ Ships .opencode/** (agents, commands, opencode.json, bkit-gateguard.js,
528
+ bkit-readguard.js).
491
529
  Configure your provider key; verify with \`bkit doctor\`. All installed
492
530
  providers tracked in bkit.opencodeProviders.
493
531
  --codex Codex CLI host. BARE flag — takes no value: Codex runs on one gateway
494
532
  (openai), so only --opencode is provider-pluggable. Ships .codex/agents/*.toml
495
- + .codex/hooks.json + .codex/hooks/bkit-gateguard.cjs, plus the workflow skills
496
- (.agents/skills/bkit-*/). Codex loads project-local hooks ONLY once the
497
- .codex/ layer is trusted — until then GateGuard is installed and never fires.
533
+ + .codex/hooks.json + .codex/hooks/bkit-{gateguard,guardrails,readguard}.cjs,
534
+ plus the workflow skills (.agents/skills/bkit-*/). Codex loads project-local
535
+ hooks ONLY once the .codex/ layer is trusted — until then they never fire.
536
+ --antigravity Google Antigravity IDE host. BARE flag — takes no value: Antigravity runs
537
+ on one gateway (google). Installs as a workspace PLUGIN at
538
+ .agents/plugins/bkit/ — plugin.json + skills/bkit-*/SKILL.md (workflow
539
+ skills) + agents/bkit-*.md (subagent prompts) + hooks.json + hooks/*.cjs,
540
+ keeping .agents/ root Codex's. Plus root GEMINI.md. There is no native
541
+ subagent tool: the orchestrator loads each prompt with view_file and runs
542
+ it in-session.
498
543
 
499
544
  Dependency updaters (copy an example and own it):
500
545
  .bkit/templates/.github/renovate.json5
@@ -538,6 +583,8 @@ Uninstall flags:
538
583
  Examples:
539
584
  bkit install --claude .claude/** + CLAUDE.md + core.
540
585
  bkit install --claude --cursor Both hosts + core.
586
+ bkit install --codex Codex CLI host (agents + workflow skills + hooks).
587
+ bkit install --antigravity Google Antigravity host (workspace plugin under .agents/plugins/bkit/ + GEMINI.md).
541
588
  bkit install --opencode=opencode-zen opencode host (Zen built-in gateway, additive).
542
589
  bkit install --opencode=opencode-go opencode host (Go built-in gateway, additive).
543
590
  bkit install --opencode=openrouter add openrouter alongside an opencode gateway.
@@ -586,8 +633,8 @@ function commandsUsage() {
586
633
  export function validateModuleFlagsForVerb(verb, moduleFlags) {
587
634
  if (verb === "install" && moduleFlags.size === 0) {
588
635
  return ("[bkit] `bkit install` requires at least one module flag. Name what to install: " +
589
- "--claude, --cursor, --codex, --opencode=<provider> (plus opt-in " +
590
- "--auto=<claude|cursor>). Run `bkit help` for usage.");
636
+ "--claude, --cursor, --codex, --antigravity, --opencode=<provider> (plus opt-in " +
637
+ `--auto=<${CLOUD_VARIANTS.join("|")}>). Run \`bkit help\` for usage.`);
591
638
  }
592
639
  if ((verb === "check" || verb === "upgrade") && moduleFlags.size > 0) {
593
640
  return (`[bkit] \`bkit ${verb}\` takes no module flags — it operates on everything already ` +
@@ -608,7 +655,7 @@ export async function main() {
608
655
  process.exitCode = commandExit;
609
656
  return;
610
657
  }
611
- const { verb, modules, moduleFlags, uninstallFlags, upgradeFlags, tracker, cloudVariant, opencodeProvider, complyPhase, telemetrySubverb, } = parseArgs(process.argv.slice(2));
658
+ const { verb, modules, moduleFlags, uninstallFlags, upgradeFlags, tracker, cloudVariant, opencodeProvider, complyPhase, telemetrySubverb, tipsAll, tipsWorkflow, } = parseArgs(process.argv.slice(2));
612
659
  // A bare `bkit` (no arguments) means no command was given: print usage and exit non-zero
613
660
  // (2 = usage error), distinct from an explicit `bkit help` / `--help` (verb "help"), which
614
661
  // prints the same usage and exits 0. parseArgs still defaults no-args to the "help" verb.
@@ -636,6 +683,10 @@ export async function main() {
636
683
  runTelemetryCommand(telemetrySubverb, complyPhase);
637
684
  return;
638
685
  }
686
+ if (verb === "tips") {
687
+ runTipsCommand(tipsAll, tipsWorkflow);
688
+ return;
689
+ }
639
690
  // Launcher verbs — exec the GUI app binary with .bkit/.env merged into the env
640
691
  // so that MCP token placeholders (BKIT_GH_TOKEN, BKIT_OPENCODE_API_KEY, …) resolve correctly
641
692
  // even when launched from the Dock/Finder (macOS GUI-isolation).
@@ -30,6 +30,8 @@ export function detectInstalledModules(cwd) {
30
30
  mods.add("opencode");
31
31
  if (fs.existsSync(path.join(cwd, ".codex", "agents")))
32
32
  mods.add("codex");
33
+ if (fs.existsSync(path.join(cwd, ".agents", "plugins", "bkit", "plugin.json")))
34
+ mods.add("antigravity");
33
35
  return mods;
34
36
  }
35
37
  // Check mode: exit-1 on drift (totalWrites > 0). runInstall emits the banner first.
@@ -8,6 +8,7 @@ import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
8
8
  import { getCoreRoot, getSharedRoot, getTemplatesRoot } from "../../shared/package-roots.js";
9
9
  import { runPreflight } from "../../checks/before/index.js";
10
10
  import { runPostInstallCheck, formatChecklist, writeAdvisoriesArtifact, } from "../../checks/after/index.js";
11
+ import { collectTips } from "../../checks/tips/index.js";
11
12
  import { parseDotenv } from "../../install/cloud-env.js";
12
13
  /**
13
14
  * `bkit status` — read-only host/provider status.
@@ -80,17 +81,21 @@ export function runStatus(cwd, logPrefix) {
80
81
  // --- codex host ---
81
82
  const codexDir = path.join(cwd, ".codex");
82
83
  const codexPresent = fs.existsSync(codexDir);
84
+ // --- antigravity host ---
85
+ const antigravityPresent = fs.existsSync(path.join(cwd, ".agents", "plugins", "bkit", "plugin.json"));
83
86
  const opencodeStatus = opencodePresent
84
87
  ? `INSTALLED (${providerLabel}: ${opencodeProviderDisplay} / model: ${opencodeModel})`
85
88
  : "absent (run: bkit install --opencode=<provider>)";
86
89
  console.log(`${logPrefix} opencode: ${opencodeStatus}`);
87
90
  console.log(`${logPrefix} codex: ${codexPresent ? "INSTALLED (provider: openai)" : "absent (run: bkit install --codex)"}`);
91
+ console.log(`${logPrefix} antigravity: ${antigravityPresent ? "INSTALLED (provider: google)" : "absent (run: bkit install --antigravity)"}`);
88
92
  // --- summary ---
89
93
  const installedHosts = [
90
94
  claudePresent ? "claude" : null,
91
95
  cursorPresent ? "cursor" : null,
92
96
  opencodePresent ? "opencode" : null,
93
97
  codexPresent ? "codex" : null,
98
+ antigravityPresent ? "antigravity" : null,
94
99
  ].filter(Boolean);
95
100
  console.log(`${logPrefix} Installed hosts: ${installedHosts.length > 0 ? installedHosts.join(", ") : "none"}`);
96
101
  }
@@ -114,7 +119,9 @@ export async function runDoctor(modules, opencodeProvider) {
114
119
  });
115
120
  }
116
121
  }
117
- const banner = formatChecklist(allFindings, suppressed);
122
+ const { tips, suppressed: suppressedTips } = collectTips(process.cwd());
123
+ suppressed.push(...suppressedTips);
124
+ const banner = formatChecklist(allFindings, suppressed, tips);
118
125
  if (banner) {
119
126
  console.log(banner);
120
127
  }
@@ -127,6 +134,7 @@ export async function runDoctor(modules, opencodeProvider) {
127
134
  version: getInstallingVersion(),
128
135
  logPrefix: LOG_PREFIX,
129
136
  suppressed,
137
+ tips,
130
138
  });
131
139
  // opencode host diagnostics: report required tools and cred presence per provider.
132
140
  // Never echoes key values — only reports present/absent.
@@ -10,9 +10,10 @@ import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
10
10
  import { detectInstalledModules, reportCheckDrift } from "./check.js";
11
11
  import { runPreflight } from "../../checks/before/index.js";
12
12
  import { formatChecklist, readChangelogVersionDelta, runPostInstallCheck, writeAdvisoriesArtifact, } from "../../checks/after/index.js";
13
+ import { collectTips } from "../../checks/tips/index.js";
13
14
  import { findMissingOwnedHooks, detectOwnedHookMissing } from "../../checks/after/managed.js";
14
15
  import { resolveTokens } from "../../install/placeholders.js";
15
- import { parseModelLookup, applyModelOverrides, buildOpencodeModelLookup, parseEffortMap, } from "../../render/models.js";
16
+ import { parseModelLookup, applyModelOverrides, buildOpencodeModelLookup, buildAntigravityModelLookup, parseEffortMap, } from "../../render/models.js";
16
17
  import { getBkitDocsRoot } from "../../shared/package-roots.js";
17
18
  import { runUninstall } from "./uninstall.js";
18
19
  // ---------------------------------------------------------------------------
@@ -88,6 +89,8 @@ export function modulesToCliFlags(mods, opencodeProvider, cloudVariant) {
88
89
  out.push(`--opencode=${opencodeProvider ?? "<provider>"}`);
89
90
  if (mods.has("codex"))
90
91
  out.push("--codex");
92
+ if (mods.has("antigravity"))
93
+ out.push("--antigravity");
91
94
  if (mods.has("cloud"))
92
95
  out.push(`--auto=${cloudVariant ?? "<variant>"}`);
93
96
  return out.join(" ");
@@ -180,6 +183,19 @@ export function detectOpencodeProviders(cwd) {
180
183
  }
181
184
  return [];
182
185
  }
186
+ /**
187
+ * Re-run Phase 1 detection after the writes. The Phase 1 advisory seeds (the first
188
+ * `seedCount` entries of `current`) are replaced by the fresh ones; advisories pushed by
189
+ * modules during dispatch are kept. Fresh blockers are returned so the caller fails on them.
190
+ */
191
+ export function refreshPreflightAfterWrites(modules, cwd, issueTracker, seedCount, current) {
192
+ const moduleAdvisories = current.slice(seedCount);
193
+ const fresh = runPreflight(modules, cwd, undefined, issueTracker);
194
+ return {
195
+ advisories: [...fresh.advisories, ...moduleAdvisories],
196
+ blockers: fresh.blockers,
197
+ };
198
+ }
183
199
  /** `bkit install`, and `bkit check` (the same pipeline, dry-run). */
184
200
  export async function runInstall(args) {
185
201
  const { verb, modules, tracker, cloudVariant, opencodeProvider, uninstallFlags } = args;
@@ -246,6 +262,7 @@ export async function runInstall(args) {
246
262
  let modelLookup = new Map();
247
263
  let opencodeModelLookup = new Map();
248
264
  let codexModelLookup = new Map();
265
+ let antigravityModelLookup = new Map();
249
266
  let effortMap = new Map();
250
267
  const promptsMdPath = path.join(getBkitDocsRoot(), "prompts.md");
251
268
  const consumerPromptsMdPath = path.join(process.cwd(), ".bkit", "prompts.md");
@@ -281,12 +298,20 @@ export async function runInstall(args) {
281
298
  }
282
299
  applyModelOverrides(codexModelLookup, "openai", consumerPromptsMdPath);
283
300
  }
301
+ if (effectiveModules.has("antigravity")) {
302
+ // Antigravity is nullary — one gateway (`google`), so there is nothing to detect.
303
+ try {
304
+ antigravityModelLookup = buildAntigravityModelLookup(promptsMdPath);
305
+ }
306
+ catch {
307
+ // Not fatal — antigravity module will fail per-file if a model is missing
308
+ }
309
+ applyModelOverrides(antigravityModelLookup, "google", consumerPromptsMdPath);
310
+ }
284
311
  effortMap = parseEffortMap(promptsMdPath);
285
312
  }
286
313
  // Seed preflight advisories into ctx so modules can accumulate into the same list.
287
- const advisories = [
288
- ...preflightAdvisories,
289
- ];
314
+ const advisories = [...preflightAdvisories];
290
315
  const ws = { writes: [] };
291
316
  const postDispatch = [];
292
317
  // Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4) — see
@@ -359,6 +384,7 @@ export async function runInstall(args) {
359
384
  modelLookup,
360
385
  opencodeModelLookup,
361
386
  codexModelLookup,
387
+ antigravityModelLookup,
362
388
  effortMap,
363
389
  opencodeProvider: renderOpencodeProvider,
364
390
  advisories,
@@ -369,6 +395,13 @@ export async function runInstall(args) {
369
395
  cloudVariant,
370
396
  // Stamped into every rendered agent + command as the managed-version marker.
371
397
  version: getInstallingVersion(),
398
+ // Full host set for this run: dispatched ∪ already-on-disk. Read by the Antigravity
399
+ // module to warn when Codex is also installed (both hosts' `bkit-*` workflow skills
400
+ // then surface in Antigravity's skill selector).
401
+ installedModules: new Set([
402
+ ...effectiveModules,
403
+ ...detectInstalledModules(process.cwd()),
404
+ ]),
372
405
  };
373
406
  // --- Phase 2: Install (current behaviour — dispatch modules) ---
374
407
  // check dispatches the detected installed set; install dispatches the resolved set.
@@ -401,10 +434,11 @@ export async function runInstall(args) {
401
434
  // banner above. `check` (dryRun) wrote nothing, so its Phase 1 findings already describe
402
435
  // the current state and are kept as-is. Module-accumulated advisories (pushed during
403
436
  // dispatch) are preserved; only the Phase 1 seeds are replaced, in their original order.
437
+ let postWriteBlockers = [];
404
438
  if (!dryRun) {
405
- const moduleAdvisories = advisories.slice(preflightAdvisories.length);
406
- const { advisories: freshPreflightAdvisories } = runPreflight(effectiveModules, process.cwd(), undefined, issueTracker);
407
- ctx.advisories = [...freshPreflightAdvisories, ...moduleAdvisories];
439
+ const refreshed = refreshPreflightAfterWrites(effectiveModules, process.cwd(), issueTracker, preflightAdvisories.length, advisories);
440
+ ctx.advisories = refreshed.advisories;
441
+ postWriteBlockers = refreshed.blockers;
408
442
  }
409
443
  // --- Phase 3: Post-install checks (re-detect + unified output) ---
410
444
  // Runs for both install AND check — detectors are read-only, so check produces
@@ -424,13 +458,19 @@ export async function runInstall(args) {
424
458
  }
425
459
  const suppressed = [];
426
460
  const postFindings = runPostInstallCheck(ctx.advisories, process.cwd(), suppressed);
461
+ if (postWriteBlockers.length > 0) {
462
+ console.log(`${LOG_PREFIX} Preflight blockers appeared after the writes — files are already written; fix the blocker and re-run.`);
463
+ postFindings.unshift(...postWriteBlockers);
464
+ }
427
465
  // check only: install has just written every hook file of the modules it dispatched, and a
428
466
  // missing bkit-cloud-bootstrap.sh after `install --claude` is not that run's fault.
429
467
  const missingHooks = dryRun ? findMissingOwnedHooks(process.cwd(), effectiveModules) : [];
430
468
  const missingHooksFinding = detectOwnedHookMissing(missingHooks);
431
469
  if (missingHooksFinding)
432
470
  postFindings.push(missingHooksFinding);
433
- const banner = formatChecklist(postFindings, suppressed);
471
+ const { tips, suppressed: suppressedTips } = collectTips(process.cwd());
472
+ suppressed.push(...suppressedTips);
473
+ const banner = formatChecklist(postFindings, suppressed, tips);
434
474
  if (banner)
435
475
  console.log(banner);
436
476
  writeAdvisoriesArtifact(postFindings, {
@@ -439,6 +479,7 @@ export async function runInstall(args) {
439
479
  version: getInstallingVersion(),
440
480
  logPrefix: LOG_PREFIX,
441
481
  suppressed,
482
+ tips,
442
483
  });
443
484
  // Check mode: exit 1 on drift (see reportCheckDrift).
444
485
  if (dryRun) {