@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.
- package/.bkit/README.md +14 -10
- package/.bkit/core/.agents/docs.md +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +93 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +137 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +72 -0
- package/.bkit/core/.agents/rules.md +10 -6
- package/.bkit/core/.agents/shortcuts.md +73 -0
- package/.bkit/core/.agents/skills.md +5 -3
- package/.bkit/core/.bkit/LICENSE.md +18 -140
- package/.bkit/core/.bkit/README.md +13 -9
- package/.bkit/core/.bkit/cloud.md +12 -15
- package/.bkit/core/.bkit/comparison.md +68 -16
- package/.bkit/core/.bkit/install.md +36 -11
- package/.bkit/core/.bkit/jsonl.md +0 -1
- package/.bkit/core/.bkit/prompts.md +83 -81
- package/.bkit/core/.bkit/providers.md +110 -28
- package/.bkit/core/.bkit/templates.md +42 -13
- package/.bkit/core/.bkit/workflows.md +64 -42
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +4 -3
- package/.bkit/core/.claude/hooks/bkit-readguard.cjs +60 -0
- package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +8 -6
- package/.bkit/core/.codex/hooks/bkit-readguard.cjs +58 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +12 -19
- package/.bkit/core/.cursor/hooks/bkit-readguard.cjs +59 -0
- package/.bkit/core/.opencode/plugin/bkit-gateguard.js +73 -22
- package/.bkit/core/.opencode/plugin/bkit-readguard.js +126 -0
- package/.bkit/core/AGENTS.md +11 -0
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +2 -2
- package/.bkit/core/docs/templates/bkit-plan.md +6 -3
- package/.bkit/core/engine/checks/after/auth.ts +32 -0
- package/.bkit/core/engine/checks/after/github.ts +4 -4
- package/.bkit/core/engine/checks/after/index.ts +36 -50
- package/.bkit/core/engine/checks/after/managed.ts +44 -1
- package/.bkit/core/engine/checks/before/index.ts +5 -4
- package/.bkit/core/engine/checks/before/mcp.ts +60 -54
- package/.bkit/core/engine/checks/status-holes.ts +1 -1
- package/.bkit/core/engine/checks/tips/catalogue.ts +356 -0
- package/.bkit/core/engine/checks/tips/detect.ts +144 -0
- package/.bkit/core/engine/checks/tips/index.ts +174 -0
- package/.bkit/core/engine/cli.ts +82 -18
- package/.bkit/core/engine/commands/install/check.ts +2 -0
- package/.bkit/core/engine/commands/install/doctor.ts +14 -1
- package/.bkit/core/engine/commands/install/install.ts +59 -9
- package/.bkit/core/engine/commands/install/uninstall.ts +59 -34
- package/.bkit/core/engine/commands/install/upgrade.ts +30 -28
- package/.bkit/core/engine/commands/launch.ts +33 -11
- package/.bkit/core/engine/commands/tips.ts +16 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +20 -2
- package/.bkit/core/engine/commands/workflow/runs.ts +82 -18
- package/.bkit/core/engine/commands/workflow/runtime.ts +12 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +1 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +647 -4
- package/.bkit/core/engine/commands/workflow/workstreams.ts +4 -4
- package/.bkit/core/engine/install/cloud-env.ts +7 -21
- package/.bkit/core/engine/install/hosts.ts +21 -0
- package/.bkit/core/engine/install/managed-block.ts +36 -0
- package/.bkit/core/engine/install/manifest.ts +83 -5
- package/.bkit/core/engine/install/modules/antigravity.ts +266 -0
- package/.bkit/core/engine/install/modules/claude.ts +6 -6
- package/.bkit/core/engine/install/modules/cloud.ts +2 -2
- package/.bkit/core/engine/install/modules/codex.ts +8 -5
- package/.bkit/core/engine/install/modules/core.ts +30 -10
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/index.ts +33 -6
- package/.bkit/core/engine/install/modules/opencode.ts +4 -4
- package/.bkit/core/engine/install/payload-links.ts +6 -10
- package/.bkit/core/engine/install/placeholders.ts +1 -1
- package/.bkit/core/engine/install/version-file.ts +17 -9
- package/.bkit/core/engine/install/write.ts +68 -1
- package/.bkit/core/engine/ledgers/telemetry.ts +0 -2
- package/.bkit/core/engine/render/hosts.ts +174 -1
- package/.bkit/core/engine/render/models.ts +10 -0
- package/.bkit/core/engine/shared/package-roots.ts +8 -10
- package/.bkit/core/hooks/antigravity-hook.js +67 -0
- package/.bkit/core/hooks/gateguard-edit-payload.js +4 -4
- package/.bkit/core/hooks/gateguard-engine.js +16 -6
- package/.bkit/core/hooks/guardrails-read.js +23 -0
- package/.bkit/core/hooks/readguard-engine.js +259 -0
- package/.bkit/core/hooks/readguard-payload.js +67 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +2 -1
- package/.bkit/core/prompts/bkit-build-challenge-1.md +2 -1
- package/.bkit/core/prompts/bkit-build-challenge-2.md +2 -1
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +2 -1
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +2 -1
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +2 -1
- package/.bkit/core/prompts/bkit-build-install-skills.md +7 -5
- package/.bkit/core/prompts/bkit-build-plan-current.md +2 -1
- package/.bkit/core/prompts/bkit-build-plan-execute.md +6 -2
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +2 -1
- package/.bkit/core/prompts/bkit-build-plan-verify.md +12 -4
- package/.bkit/core/prompts/bkit-build-summary.md +2 -1
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +2 -1
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +2 -1
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +2 -1
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +2 -1
- package/.bkit/core/prompts/bkit-debug-summary.md +2 -1
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +2 -1
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +2 -1
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +2 -1
- package/.bkit/core/prompts/bkit-design-generate.md +10 -5
- package/.bkit/core/prompts/bkit-design-organise.md +2 -1
- package/.bkit/core/prompts/bkit-design-review-1.md +2 -1
- package/.bkit/core/prompts/bkit-design-review-2.md +2 -1
- package/.bkit/core/prompts/bkit-design-spike.md +2 -1
- package/.bkit/core/prompts/bkit-design-summary.md +2 -1
- package/.bkit/core/prompts/bkit-design-update.md +2 -1
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +2 -1
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +4 -3
- package/.bkit/core/prompts/bkit-plan-generate.md +2 -1
- package/.bkit/core/prompts/bkit-plan-review-1.md +2 -1
- package/.bkit/core/prompts/bkit-plan-review-2.md +2 -1
- package/.bkit/core/prompts/bkit-plan-review-3.md +2 -1
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +3 -2
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +3 -2
- package/.bkit/core/prompts/bkit-plan-summary.md +2 -1
- package/.bkit/core/prompts/bkit-plan-update.md +3 -2
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +2 -1
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +2 -1
- package/.bkit/core/prompts/bkit-ship-summary.md +2 -1
- package/.bkit/core/prompts/bkit-ship-update-docs.md +2 -1
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +2 -1
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +2 -1
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +2 -1
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +2 -1
- package/.bkit/core/prompts/bkit-utility-update-failures.md +2 -1
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +2 -1
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +4 -3
- package/.bkit/core/workflows/bkit-auto.md +1 -1
- package/.bkit/core/workflows/bkit-build.md +35 -21
- package/.bkit/core/workflows/bkit-debug.md +31 -22
- package/.bkit/core/workflows/bkit-design.md +83 -38
- package/.bkit/core/workflows/bkit-plan.md +10 -2
- package/.bkit/core/workflows/bkit-ship.md +10 -2
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +36 -0
- package/.bkit/shared/.agents/plugins/bkit/plugin.json +5 -0
- package/.bkit/shared/.claude/settings.json +19 -0
- package/.bkit/shared/.codex/hooks.json +21 -0
- package/.bkit/shared/.cursor/hooks.json +6 -1
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/GEMINI.md +11 -0
- package/.bkit/shared/docs/deployments.md +1 -1
- package/.bkit/shared/docs/security.md +3 -3
- package/.bkit/shared/docs/testing.md +12 -1
- package/.bkit/templates/.github/dependabot.yml +6 -0
- package/.bkit/templates/.github/renovate.json5 +3 -3
- package/.bkit/templates/.github/workflows/bkit-ci.yml +24 -13
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +5 -5
- package/.bkit/templates/.prettierignore +4 -1
- package/.bkit/templates/context/bkit-expo.md +22 -13
- package/.bkit/templates/context/bkit-github.md +20 -6
- package/.bkit/templates/context/bkit-inngest.md +10 -4
- package/.bkit/templates/context/bkit-maestro.md +5 -5
- package/.bkit/templates/context/bkit-playwright.md +3 -3
- package/.bkit/templates/context/bkit-sentry.md +6 -5
- package/.bkit/templates/context/bkit-stripe.md +31 -8
- package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +65 -19
- package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +34 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +33 -12
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +54 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +2 -2
- package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +76 -6
- package/.bkit/templates/slop-scan.config.json +10 -3
- package/CHANGELOG.md +62 -0
- package/LICENSE.md +21 -161
- package/README.md +66 -35
- package/dist/checks/after/auth.js +28 -0
- package/dist/checks/after/github.js +4 -4
- package/dist/checks/after/index.js +29 -45
- package/dist/checks/after/managed.js +41 -1
- package/dist/checks/before/index.js +5 -4
- package/dist/checks/before/mcp.js +53 -53
- package/dist/checks/status-holes.js +1 -1
- package/dist/checks/tips/catalogue.js +297 -0
- package/dist/checks/tips/detect.js +130 -0
- package/dist/checks/tips/index.js +146 -0
- package/dist/cli.js +68 -17
- package/dist/commands/install/check.js +2 -0
- package/dist/commands/install/doctor.js +9 -1
- package/dist/commands/install/install.js +49 -8
- package/dist/commands/install/uninstall.js +61 -34
- package/dist/commands/install/upgrade.js +31 -33
- package/dist/commands/launch.js +27 -11
- package/dist/commands/tips.js +10 -0
- package/dist/commands/workflow/prs.js +13 -1
- package/dist/commands/workflow/runs.js +74 -18
- package/dist/commands/workflow/runtime.js +8 -0
- package/dist/commands/workflow/steps.js +1 -0
- package/dist/commands/workflow/tests.js +541 -4
- package/dist/commands/workflow/workstreams.js +4 -4
- package/dist/install/cloud-env.js +3 -14
- package/dist/install/hosts.js +22 -0
- package/dist/install/managed-block.js +36 -0
- package/dist/install/manifest.js +79 -4
- package/dist/install/modules/antigravity.js +225 -0
- package/dist/install/modules/claude.js +6 -6
- package/dist/install/modules/cloud.js +2 -2
- package/dist/install/modules/codex.js +8 -5
- package/dist/install/modules/core.js +21 -6
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/index.js +17 -6
- package/dist/install/modules/opencode.js +4 -4
- package/dist/install/payload-links.js +5 -5
- package/dist/install/placeholders.js +1 -1
- package/dist/install/version-file.js +12 -3
- package/dist/install/write.js +61 -2
- package/dist/render/hosts.js +149 -1
- package/dist/render/models.js +9 -0
- package/dist/shared/package-roots.js +8 -11
- package/package.json +8 -8
- package/.bkit/core/LICENSE.md +0 -149
- package/.bkit/shared/LICENSE.md +0 -22
- 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=<
|
|
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=<
|
|
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 --
|
|
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 +
|
|
472
|
-
blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
|
|
473
|
-
the bkit:gate:* / bkit:deps:* package.json scripts every workflow
|
|
474
|
-
missing, never overwritten, left by uninstall). The tool scripts those
|
|
475
|
-
(typecheck, lint, format:check, lint:prose, slop:delta) and their devDeps are
|
|
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,
|
|
496
|
-
(.agents/skills/bkit-*/). Codex loads project-local
|
|
497
|
-
.codex/ layer is trusted — until then
|
|
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
|
-
"
|
|
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
|
|
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
|
|
406
|
-
|
|
407
|
-
|
|
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
|
|
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) {
|