@golden-frijoles/kit 0.43.0 → 1.0.0

package/README.md

@@ -15,7 +15,7 @@ npx -y @golden-frijoles/kit@<version> --root ../other build-order
   `Roadmap/00-ideas/BUILD-ORDER.md`.
 - **Your own copy wins.** If your project has `scripts/<name>.mjs`, the skills run that instead of the kit, so a
   deliberate fork keeps working. That's by name, so an unrelated `scripts/preflight.mjs` of your own would be run in
-  its place. Rename yours, or pass the script through `gf-kit` directly.
+  its place. Rename yours, or pass the script through `frijoles-kit` directly.
 - **Some files stay yours even when the kit runs:** `scripts/prose/cpo-persona.md`, `scripts/prose-lessons.md`,
   `scripts/cross-panel.prompt.md` and `scripts/doc-format.enforced.json` override the kit's defaults.
 - **Zero dependencies.** A script that drives another tool, like Playwright or a reviewer CLI, uses *your*

package/bin.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-// gf-kit — run one of the Golden Frijoles skills' scripts in the current project (golden-frijoles-plugin D1–D3).
+// frijoles-kit — run one of the Golden Frijoles skills' scripts in the current project (golden-frijoles-plugin D1–D3).
 //
-//   gf-kit <name> [args…]        run dist/<name>.mjs against the project you're standing in
-//   gf-kit --root <dir> <name>   …against <dir> instead (exported to the script as GF_PROJECT_ROOT)
-//   gf-kit --list                the scripts this kit carries
-//   gf-kit --version
+//   frijoles-kit <name> [args…]        run dist/<name>.mjs against the project you're standing in
+//   frijoles-kit --root <dir> <name>   …against <dir> instead (exported to the script as GF_PROJECT_ROOT)
+//   frijoles-kit --list                the scripts this kit carries
+//   frijoles-kit --version
 //
 // The script is SPAWNED, never imported: every entry guards `main()` behind an isMain check on process.argv[1]
 // and several end with process.exit, so an import() would silently run nothing. stdio, the exit code and a
@@ -26,7 +26,7 @@ export function listScripts(dist = DIST) {
     .sort();
 }
 
-/** Pure — split gf-kit's own flags from the script's. Only flags BEFORE the script name belong to gf-kit. */
+/** Pure — split frijoles-kit's own flags from the script's. Only flags BEFORE the script name belong to frijoles-kit. */
 export function parseArgs(argv) {
   const out = { root: null, list: false, version: false, help: false, name: null, rest: [] };
   for (let i = 0; i < argv.length; i++) {
@@ -51,7 +51,18 @@ export function parseArgs(argv) {
   return out;
 }
 
-const USAGE = 'usage: gf-kit [--root <dir>] <script> [args…]   ·   gf-kit --list   ·   gf-kit --version';
+const USAGE = 'usage: frijoles-kit [--root <dir>] <script> [args…]   ·   frijoles-kit --list   ·   frijoles-kit --version';
+
+/**
+ * plugin-1-0 D2 — started as the old name `gf-kit`? One line on stderr (stdout is a script's own output, often parsed),
+ * until the date `scripts/check-deprecations.mjs` enforces. Pure, so the test pins it.
+ */
+export function deprecatedNameNotice(invokedPath) {
+  const name = String(invokedPath ?? '').split(/[\\/]/).pop() ?? '';
+  // Unix only: npm's Windows shims start `node …\\bin.mjs`, so argv[1] is the entry file there (verifier, #324).
+  if (name !== 'gf-kit') return null;
+  return 'gf-kit is now frijoles-kit. gf-kit stops working on 2026-12-31 (or in kit 1.1.0).\n';
+}
 
 function main(argv) {
   const args = parseArgs(argv);
@@ -69,12 +80,12 @@ function main(argv) {
     return args.help ? 0 : 2;
   }
   if (args.root === '') {
-    process.stderr.write('gf-kit: --root needs a directory\n');
+    process.stderr.write('frijoles-kit: --root needs a directory\n');
     return 2;
   }
   // A plain name from the list only — never a path, so nothing outside dist/ can be reached through it.
   if (!scripts.includes(args.name)) {
-    process.stderr.write(`gf-kit: no script "${args.name}". This kit carries:\n  ${scripts.join('\n  ')}\n`);
+    process.stderr.write(`frijoles-kit: no script "${args.name}". This kit carries:\n  ${scripts.join('\n  ')}\n`);
     return 2;
   }
   const env = { ...process.env };
@@ -83,21 +94,21 @@ function main(argv) {
     // re-resolved against that cwd in every child (fresh review of #45: pmo-report read zero rows, silently).
     const root = resolve(args.root);
     if (!existsSync(root)) {
-      process.stderr.write(`gf-kit: --root ${args.root}: no such directory\n`);
+      process.stderr.write(`frijoles-kit: --root ${args.root}: no such directory\n`);
       return 2;
     }
     env.GF_PROJECT_ROOT = root;
   }
   const run = spawnSync(process.execPath, [join(DIST, `${args.name}.mjs`), ...args.rest], { stdio: 'inherit', env });
   if (run.error) {
-    process.stderr.write(`gf-kit: could not start ${args.name}: ${run.error.message}\n`);
+    process.stderr.write(`frijoles-kit: could not start ${args.name}: ${run.error.message}\n`);
     return 1;
   }
   if (run.signal) process.kill(process.pid, run.signal);
   return run.status ?? 1;
 }
 
-// npm installs `gf-kit` as a symlink in node_modules/.bin, so compare real paths on both sides.
+// npm installs `frijoles-kit` as a symlink in node_modules/.bin, so compare real paths on both sides.
 const isMain = (() => {
   try {
     return !!process.argv[1] && realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
@@ -105,4 +116,8 @@ const isMain = (() => {
     return false;
   }
 })();
-if (isMain) process.exitCode = main(process.argv.slice(2));
+if (isMain) {
+  const notice = deprecatedNameNotice(process.argv[1]);
+  if (notice) process.stderr.write(notice);
+  process.exitCode = main(process.argv.slice(2));
+}

package/dist/build-order.mjs

@@ -18,7 +18,7 @@ import { execFileSync } from 'node:child_process';
 import { readFileSync, writeFileSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
-import { STAGES, groupByStage } from './lib/stage.mjs';
+import { STAGES, groupByStage, stageWord } from './lib/stage.mjs';
 import { projectRoot } from './lib/project-root.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -78,7 +78,7 @@ function render(rows) {
   out.push('# Build order — the six stages');
   out.push('');
   out.push(`> **Generated ${now} — do not hand-edit.** One stage per initiative, decided in one place`);
-  out.push('> (`scripts/lib/stage.mjs`): To groom · Grooming · Ready to build · Building · QA · Shipped.');
+  out.push(`> (\`scripts/lib/stage.mjs\`): ${STAGES.map(stageWord).join(' · ')}.`);
   if (LIVE) {
     out.push('> **Live:** Building and QA come from git and GitHub as of this run. Printed, never written.');
   } else {
@@ -89,7 +89,7 @@ function render(rows) {
   for (const stage of STAGES) {
     const list = columns[stage];
     if (LIVE_ONLY.has(stage) && !LIVE) {
-      out.push(`## ${stage} — live only`);
+      out.push(`## ${stageWord(stage)} — live only`);
       out.push('');
       out.push(
         `_${STAGE_NOTE[stage]}. Not in this committed file: \`node scripts/build-order.mjs --live\` or the Hub board._`
@@ -97,7 +97,7 @@ function render(rows) {
       out.push('');
       continue;
     }
-    out.push(`## ${stage} (${list.length})`);
+    out.push(`## ${stageWord(stage)} (${list.length})`);
     out.push('');
     out.push(`_${STAGE_NOTE[stage]}._`);
     out.push('');
@@ -126,7 +126,7 @@ if (unfunded.length) {
 }
 
 // Scaffolded ⇒ funded (fund-at-approval D8). A live bet — an epic scaffolded or in progress, or a queued seed — must
-// name the cycle that paid for it, and that cycle must be a file in Roadmap/bets/. `groom` funds a bet at its approval
+// name the cycle that paid for it, and that cycle must be a file in Roadmap/bets/. `refine` funds a bet at its approval
 // gate (`fund.mjs`), in the same commit as the scaffold, so this only fails on work that skipped the gate.
 const BETS = join(REPO, 'Roadmap', 'bets');
 const cycleOf = (v) => String(v).replace(/^Roadmap\/bets\//, '').replace(/\.md$/, '');
@@ -139,7 +139,7 @@ const unpaid = liveBets.filter((r) => !paidBy(r));
 if (unpaid.length) {
   console.error('Live bets with no funding record (`underwritten_by:` must name a Roadmap/bets/<cycle>.md):');
   for (const r of unpaid) console.error(`  - ${r.doc_link}${r.underwritten_by ? ` — no Roadmap/bets/${cycleOf(r.underwritten_by)}.md` : ''}`);
-  console.error('Fund it at the approval gate: node "$GROOM/fund.mjs" --slug <slug> --displaced "<…>" --next | --after <slug>');
+  console.error('Fund it at the approval gate: node "$REFINE/fund.mjs" --slug <slug> --displaced "<…>" --next | --after <slug>');
   process.exit(1);
 }
 

package/dist/build-state.mjs

@@ -61,7 +61,7 @@ import { parseJournal, JOURNAL_BRANCH, JOURNAL_PATH } from './lib/session-journa
 import { branchCandidates, parseBranch } from './lib/work-branch.mjs';
 import { buildRows } from './roadmap-extract.mjs';
 import { gatherFacts } from './lib/stage-facts.mjs';
-import { STAGES, groupByStage } from './lib/stage.mjs';
+import { STAGES, groupByStage, stageWord } from './lib/stage.mjs';
 import { getKey } from './lib/config.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -927,14 +927,13 @@ function stageParts(state) {
 }
 
 // build-view-upgrade D3 — the stage as a track, in lib/stage.mjs's words. `To groom` shows only when it is the stage.
-const TRACK_WORDS = { 'To groom': 'Backlog', 'Ready to build': 'Ready' };
 export const TRACK_MARK = '◉';
 
 /** `Grooming ─ Ready ─ ◉ Building ─ QA ─ Shipped` for a stage; `◉ Locking` in Building's place while locking. */
 export function stageTrack(stage, locking = false) {
   return STAGES.filter((s) => s !== 'To groom' || stage === 'To groom')
     .map((s) => {
-      const word = s === 'Building' && locking ? 'Locking' : (TRACK_WORDS[s] ?? s);
+      const word = s === 'Building' && locking ? 'Locking' : stageWord(s);
       return s === stage ? `${TRACK_MARK} ${word}` : word;
     })
     .join(' ─ ');

package/dist/cold-read.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// cold-read.mjs — the deterministic half of the `cold-read` skill: the brief, the run, the seal and the compare
+// cold-read.mjs — the deterministic half of the cold-read chapter of the `strategy` skill: the brief, the run, the seal and the compare
 // (coaches-v2 D2–D4).
 //
 //   node scripts/cold-read.mjs brief [--out <file>]   print the agent's brief (the exclusion list is in it); --out
@@ -316,7 +316,7 @@ function run(root) {
       err: 'cold-read: no other model family reachable (codex is not installed). Run the brief with a same-family agent and record `family: claude (same family)`.',
     };
   }
-  // Codex reads the repository it is started in. Under `gf-kit --root <dir>` that is not this process's cwd, so move
+  // Codex reads the repository it is started in. Under `frijoles-kit --root <dir>` that is not this process's cwd, so move
   // there first: otherwise it reads one repo and the read is sealed into another's strategy folder (review of #314).
   process.chdir(root);
   const r = tryCodex(brief, '');

package/dist/cold-read.prompt.md

@@ -8,7 +8,9 @@ the end, says where it goes.
 Skip these, and anything whose purpose is positioning, brand, messaging, landing copy or a strategy method:
 
 - `Roadmap/00-strategy/` (all of it): the makers' own strategy and any earlier cold read
-- any `pmf-narrative`, `north-star`, `risk-validation` or `cold-read` skill folder: the coaching methods
+- the `strategy` skill folder (and, on an older install, any `pmf-narrative`, `north-star`, `risk-validation` or
+  `cold-read` skill folder), and the `refine` skill's `references/coaching.md` and `references/strategy.md`: the
+  coaching methods
 - `references/`, `brand/`, landing-page and marketing copy, positioning or messaging modules
 - `.env*`, secrets, `node_modules/`, `.git/`
 

package/dist/config.mjs

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
-// config.mjs — `gf-kit config`: read and change golden-frijoles.config.json (golden-frijoles-plugin S4.1, D10).
+// config.mjs — `frijoles-kit config`: read and change golden-frijoles.config.json (golden-frijoles-plugin S4.1, D10).
 //
-//   gf-kit config list [--json]            every section's effective value, where it came from, any duplicates
-//   gf-kit config get <key> [--json]       one key's effective value (or its registry default)
-//   gf-kit config set <key> <value>        write one key; <value> is parsed as JSON when it is valid JSON
-//   gf-kit config migrate [--dry-run]      fold the legacy files into golden-frijoles.config.json (never edits them)
+//   frijoles-kit config list [--json]            every section's effective value, where it came from, any duplicates
+//   frijoles-kit config get <key> [--json]       one key's effective value (or its registry default)
+//   frijoles-kit config set <key> <value>        write one key; <value> is parsed as JSON when it is valid JSON
+//   frijoles-kit config migrate [--dry-run]      fold the legacy files into golden-frijoles.config.json (never edits them)
 //
 // A thin front end: every rule (precedence, the secret guard, what migrate folds) lives in lib/config.mjs, which the
-// `gf` CLI imports too. Exit 0 ok · 1 usage · 2 configuration error (a malformed file, a secret, an unknown section).
+// `frijoles` CLI imports too. Exit 0 ok · 1 usage · 2 configuration error (a malformed file, a secret, an unknown section).
 
 import { realpathSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { CONFIG_FILENAME, ConfigError, getKey, loadConfig, migrate, setKey } from './lib/config.mjs';
 
-const USAGE = 'usage: gf-kit config list|get <key>|set <key> <value>|migrate [--dry-run] [--json]';
+const USAGE = 'usage: frijoles-kit config list|get <key>|set <key> <value>|migrate [--dry-run] [--json]';
 
 /** Pure — a CLI value: JSON when it parses (true, 3, ["a"], null), otherwise the literal string. */
 export function parseValue(text) {
@@ -63,7 +63,7 @@ export function main(argv, { out = (s) => process.stdout.write(s), err = (s) =>
     }
   } catch (e) {
     if (e instanceof ConfigError) {
-      err(`gf-kit config: ${e.message}\n`);
+      err(`frijoles-kit config: ${e.message}\n`);
       return 2;
     }
     throw e;

package/dist/cross-panel.prompt.md

@@ -24,7 +24,7 @@
 ---
 
 You are an **advisory second-opinion reviewer** from a different model family than the agent that is
-grooming this plan. You are reviewing a **proposed plan** — a scope/seed doc for a feature, bug, spike,
+refining this plan. You are reviewing a **proposed plan** — a scope/seed doc for a feature, bug, spike,
 or chore — **before** it gets sliced into an epic and built. Your job is to catch the architecture blind
 spots a same-family planner would miss, while the plan is still cheap to change.
 
@@ -80,7 +80,7 @@ confirm (or kill) your "already modeled / not modeled" assumption.
 ## LENS: architect-pragmatist
 You are the **ship-it pragmatist.** Your question on every line: *what is the thinnest thing that actually
 works and ships, and is this plan over-built for v1?* Push hard on:
-- **Can we already do this today?** (LEARNINGS / the groom skill's "can we already do this?" stage.) Sort
+- **Can we already do this today?** (LEARNINGS / the refine skill's "can we already do this?" stage.) Sort
   the ask into *already-possible* (existing features + the right messaging/positioning — no build),
   *light-enhancement* (a small story or copy/config change on an existing feature), or *genuinely-new*.
   If buckets 1–2 hit the outcome, say so loudly — that's the win. A plan that builds net-new when copy +

package/dist/cross-review.mjs

@@ -109,7 +109,7 @@ export function promptPathFor(lens) {
 
 const BANNER =
   '> **Cross-agent review — every finding is fixed, or answered on this PR, before merge. This does not authorize one.** ' +
-  'CI and the risk-tier merge rule remain the only merge authority. A fresh `pr-reviewer` pass covers context independence; ' +
+  'CI and the risk-tier merge rule remain the only merge authority. A fresh `verifier` pass covers context independence; ' +
   'this is the family-independence pass: one single-pass read by a model family that did not build the diff.';
 
 const HELP = `cross-review.mjs — the cross-agent judgment-layer review for a PR diff.

package/dist/cross-review.prompt.md

@@ -2,7 +2,7 @@
   cross-review.prompt.md — the ONE shared reviewer prompt, read by BOTH readers.
 
   • `scripts/cross-review.mjs` (the external CLI pass) sends everything below the first `---`.
-  • The fresh `pr-reviewer` subagent reads *Shared bar*, *What to check* and *Project rules*, and ignores
+  • The fresh `verifier` subagent reads *Shared bar*, *What to check* and *Project rules*, and ignores
     *CLI reader only*.
 
   One prompt, two independent readers, no drift: that is the whole design (ways-of-work-lean-pass D8).

package/dist/doc-format.enforced.json

@@ -1,4 +1,4 @@
 {
-  "$comment": "Which Roadmap docs `node scripts/doc-format.mjs --check` FAILS on (everything else is reported, not enforced). A trailing \"/\" makes a prefix. A new project enforces all of Roadmap/ — nothing predates the groom templates. A project adopting this late lists files as each area is swept.",
+  "$comment": "Which Roadmap docs `node scripts/doc-format.mjs --check` FAILS on (everything else is reported, not enforced). A trailing \"/\" makes a prefix. A new project enforces all of Roadmap/ — nothing predates the refine templates. A project adopting this late lists files as each area is swept.",
   "enforced": ["Roadmap/"]
 }

package/dist/doc-format.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // doc-format.mjs — check Roadmap/ epic docs (README.md, sprint-N.md, RETROSPECTIVE.md) against the
-// canonical shape: the `groom` plugin's scaffolding templates (golden-frijoles/skills,
-// skills/groom/templates/) — proven canonical in the project this was ported from by a zero-drift
+// canonical shape: the `refine` plugin's scaffolding templates (golden-frijoles/skills,
+// skills/refine/templates/) — proven canonical in the project this was ported from by a zero-drift
 // control group (81 seeds, one authoring path, identical shape; epic READMEs drift because they get
 // hand-edited after scaffolding, away from the template). dobby-foundation's CI renders a scaffolded
 // epic and runs this checker over it, so the producer validates its own templates.
@@ -392,7 +392,7 @@ export function checkRetrospective(content) {
     // long as the italic markup actually closes somewhere (immediately after the date, or at the end
     // of the line). Require: starts with the italic-open + "Closed:" + a real date, and a closing "_"
     // appears somewhere after that.
-    // The canonical groom scaffold intentionally has no close date yet. Accept its literal sentinel:
+    // The canonical refine scaffold intentionally has no close date yet. Accept its literal sentinel:
     // treating an unbuilt epic as closed would make roadmap-to-notion derive a false Shipped state.
     const isScaffoldPlaceholder = trimmed === '_Closed: <date>_';
     const startsWithDate = /^_Closed:\s*\d{4}-\d{2}-\d{2}/.test(trimmed);

package/dist/doc-hygiene.mjs

@@ -3,7 +3,7 @@
 // candidates in LEARNINGS.md + the README poster. ADVISORY ONLY: this script never edits any
 // Roadmap doc — it only reads them and (unless --check) writes ONE new dated report file under
 // Roadmap/00-ideas/. Every flagged candidate is a hint for a human/model to verify, not a verdict —
-// see the `doc-hygiene` skill (`golden-frijoles` plugin, golden-frijoles marketplace) for the
+// see Step 4 of scripts/routines/roadmap-hygiene.prompt.md for the
 // judgment pass this script's output feeds.
 //
 //   node scripts/doc-hygiene.mjs             # print the report + write Roadmap/00-ideas/DOC-HYGIENE-REPORT-<date>.md
@@ -211,12 +211,12 @@ function buildReport() {
   const date = new Date().toISOString().slice(0, 10);
   const lines = [];
   lines.push(
-    `<!-- Advisory artifact from the doc-hygiene skill (scripts/doc-hygiene.mjs). Findings are proposals`,
+    `<!-- Advisory artifact from the doc-hygiene pass (the roadmap-hygiene routine, step 4) (scripts/doc-hygiene.mjs). Findings are proposals`,
     `     only — no LEARNINGS.md/README.md content was changed by this script. -->`,
     '',
     `# Doc hygiene report — ${date}`,
     '',
-    '🧹 **doc-hygiene skill.** Advisory only — review by hand; nothing here gates or auto-edits.',
+    '🧹 **doc-hygiene pass (the roadmap-hygiene routine, step 4).** Advisory only — review by hand; nothing here gates or auto-edits.',
     '',
     '## Always-read set size',
     ''

package/dist/emit-epic-kickoff.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// emit-epic-kickoff.mjs — print the finished, paste-ready EPIC-MODE kickoff for a groomed epic.
+// emit-epic-kickoff.mjs — print the finished, paste-ready EPIC-MODE kickoff for a refined epic.
 //
 // ── Why this exists ──────────────────────────────────────────────────────────────────────────────────
 // Epic mode — one orchestrated run across a whole epic, sprint files as internal integration boundaries
@@ -28,12 +28,12 @@
 //   npx -y @golden-frijoles/kit emit-epic-kickoff --list [--repo-root <path>]   # the epics a kickoff can start
 //                                       # (live-build-view S2.4): `scaffolded` or `in-progress`, build order first
 //
-// The kickoff's one home is `/build <slug>` (the plugin's mod runs groom's vendored copy of THIS file and fills the
+// The kickoff's one home is `/build <slug>` (the plugin's mod runs refine's vendored copy of THIS file and fills the
 // prompt with its output); hosts without the mod run it through the kit. It is never saved to a file — the epic docs
 // are the state, regenerate it.
 //
 // One source, three homes (kickoff-generator-path C1): this file ships in the kit, a project spawned from the template
-// carries it in `scripts/`, and the groom skill holds a byte-identical copy in `vendor/` (render-hook-vendor.mjs).
+// carries it in `scripts/`, and the refine skill holds a byte-identical copy in `vendor/` (render-hook-vendor.mjs).
 
 import { readFileSync, readdirSync, existsSync, realpathSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
@@ -108,7 +108,7 @@ export function listEpics(repoRoot, { read = (p) => readFileSync(p, 'utf8'), exi
 
 /** The list as printed: one epic per line, the slug first so it can be typed after `/build `. */
 export function formatEpicList(epics) {
-  if (!epics.length) return 'No scaffolded or in-progress epics under Roadmap/ — groom one first.';
+  if (!epics.length) return 'No scaffolded or in-progress epics under Roadmap/ — refine one first.';
   return epics.map((e) => `${e.slug}  ${e.title}  (${e.status}${e.build_order !== null ? `, #${e.build_order}` : ''})`).join('\n');
 }
 

package/dist/emit-kickoff.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-// emit-kickoff.mjs — print the finished, paste-ready Stage-8 Claude Code kickoff for a groomed
-// sprint. Planning-only helper for the `groom` skill (Stage 8). The invariant preamble (the
+// emit-kickoff.mjs — print the finished, paste-ready Stage-8 Claude Code kickoff for a refined
+// sprint. Planning-only helper for the `refine` skill (Stage 8). The invariant preamble (the
 // orientation reads, plan-mode, escalate-don't-guess triggers, etc.) lives in
 // `templates/kickoff.md` — this script's whole point is that boilerplate stops being retyped by
 // hand per sprint; only the sprint-specific delta (epic title, sprint number + its own title,
@@ -10,7 +10,7 @@
 //   npx -y @golden-frijoles/kit emit-kickoff --epic <slug> --sprint N [--repo-root <path>]
 //
 // One source, three homes (kickoff-generator-path C1): this file ships in the kit, a project spawned from the template
-// carries it in `scripts/`, and the groom skill holds a byte-identical copy in `vendor/` (render-hook-vendor.mjs).
+// carries it in `scripts/`, and the refine skill holds a byte-identical copy in `vendor/` (render-hook-vendor.mjs).
 // The template is read from this file's own directory, which is the kit root in all three.
 //
 // Resolves the epic dir by SEARCHING Roadmap/*/<slug>/ under the project root (lib/kickoff-cli.mjs) — the
@@ -19,7 +19,7 @@
 // headings), then substitutes into templates/kickoff.md and prints the result to stdout.
 //
 // It does NOT write any file — this is a read + print tool, same "advisory, editorial control
-// stays with the caller" stance as the other groom/cross-agent scripts in this repo.
+// stays with the caller" stance as the other refine/cross-agent scripts in this repo.
 
 import { readFileSync, existsSync, realpathSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';

package/dist/epic-actuals.mjs

@@ -660,7 +660,7 @@ export async function pushUsage({
     return { sent: 0, reason: `config unreadable — ${err && err.message ? err.message : err}` };
   }
   if (setting !== 'on')
-    return { sent: 0, reason: 'off — spend.telemetry is not on (gf-kit config set spend.telemetry on)' };
+    return { sent: 0, reason: 'off — spend.telemetry is not on (frijoles-kit config set spend.telemetry on)' };
   // The throttle counts ATTEMPTS, not successes: a persistent 401 or 429 retries every 10 minutes, not every minute.
   const last = Math.max(index.pushed_at ?? -Infinity, index.push_attempt_at ?? -Infinity);
   if (throttle && Number.isFinite(last) && now - last < PUSH_EVERY_MS)

package/dist/epic-read.mjs

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 // epic-read.mjs — read an epic's result on its read date: draft the verdict with its evidence; write it on approval.
 //
-//   node scripts/epic-read.mjs --epic <slug>                               # fetches the number through gf, drafts
+//   node scripts/epic-read.mjs --epic <slug>                               # fetches the number through frijoles, drafts
 //   node scripts/epic-read.mjs --epic <slug> --experiment smart-defaults   # … and cites the A/B decision record
 //   node scripts/epic-read.mjs --epic <slug> --actual 72 --evidence north-star:invoices_paid_on_time@2026-11-04
 //   node scripts/epic-read.mjs --epic <slug> --evidence "traffic too low (n = 18)"          # no number: unclear
 //   node scripts/epic-read.mjs --epic <slug> --verdict proven --evidence https://…           # an owner verdict
 //   … --write                                                              # the approval: stamp verdict_* into the README
-//   options: --project <slug> (gf's; default: the remembered one) · --today YYYY-MM-DD (default: today, UTC)
-//            · --repo-root <dir> · --json · GF_BIN=<path to gf> (default: gf on PATH)
+//   options: --project <slug> (frijoles's; default: the remembered one) · --today YYYY-MM-DD (default: today, UTC)
+//            · --repo-root <dir> · --json · GF_BIN=<path to frijoles> (default: frijoles on PATH)
 //
 // ── The shape (result-record D8) ─────────────────────────────────────────────────────────────────────────────────
 // The agent does the legwork, the owner decides. Without `--write` this prints a draft and the exact command that
@@ -25,11 +25,11 @@
 //   • An epic shipped with no target can be read too — an owner verdict and its evidence, one epic per run.
 //
 // ── The agent fetches the number (result-record S3, D17) ─────────────────────────────────────────────────────────
-// With a target and no `--actual`, this runs `gf north-star readings <target_metric> --to <today> --json` and takes
+// With a target and no `--actual`, this runs `frijoles north-star readings <target_metric> --to <today> --json` and takes
 // `latest`: the actual is its value, the evidence `north-star:<input>@<its day>`. A reading dated before the epic shipped
-// is no evidence for it. `--experiment <key>` also runs `gf experiments decision <key> --json`; a recorded decision
-// becomes the evidence, `ab:<key>`. gf is spawned without a shell (`$GF_BIN`, else `gf` on PATH), so a shell alias of
-// the same name never applies. `--actual` / `--evidence` still win: they are the owner's word. No gf, not signed in, no
+// is no evidence for it. `--experiment <key>` also runs `frijoles experiments decision <key> --json`; a recorded decision
+// becomes the evidence, `ab:<key>`. frijoles is spawned without a shell (`$GF_BIN`, else `frijoles` on PATH), so a shell alias of
+// the same name never applies. `--actual` / `--evidence` still win: they are the owner's word. No frijoles, not signed in, no
 // project chosen, or any failure is one "could not fetch (why)" line, and the read asks the owner as before — it never
 // fails because the platform is not linked. Grounded is now "the readings route knows this input".
 
@@ -138,17 +138,22 @@ export function planRead({ fm, shippedAt, shipped, today, actual = null, evidenc
   return { state: 'ready', target, drafted, owner, fields, late, readDate, derived };
 }
 
-/** Run one `gf … --json` and read its single JSON document. Never throws; `why` says what went wrong in words. */
+/** Run one `frijoles … --json` and read its single JSON document. Never throws; `why` says what went wrong in words. */
 export function runGf(args, { env = process.env, spawnFn = spawnSync } = {}) {
-  const bin = env.GF_BIN || 'gf';
-  const res = spawnFn(bin, [...args, '--json'], { encoding: 'utf8', timeout: 30_000, env, shell: false });
+  // `frijoles` since CLI 1.0; `gf` is the name an older install still has (plugin-1-0 D2). GF_BIN pins one.
+  const bins = env.GF_BIN ? [env.GF_BIN] : ['frijoles', 'gf'];
+  let res = null;
+  for (const bin of bins) {
+    res = spawnFn(bin, [...args, '--json'], { encoding: 'utf8', timeout: 30_000, env, shell: false });
+    if (res.error?.code !== 'ENOENT') break; // only "not installed under this name" tries the next name
+  }
   if (res.error)
     return {
       ok: false,
       why:
         res.error.code === 'ENOENT'
-          ? 'gf is not installed (npm i -g @golden-frijoles/cli, then gf login)'
-          : `gf did not run: ${res.error.message}`,
+          ? 'frijoles is not installed (npm i -g @golden-frijoles/cli, then frijoles login)'
+          : `frijoles did not run: ${res.error.message}`,
     };
   let body = null;
   try {
@@ -157,13 +162,13 @@ export function runGf(args, { env = process.env, spawnFn = spawnSync } = {}) {
     body = null;
   }
   if (body && body.ok === true) return { ok: true, body };
-  if (res.status === 2) return { ok: false, code: 'unauthorized', why: 'gf is not signed in (run gf login)' };
+  if (res.status === 2) return { ok: false, code: 'unauthorized', why: 'frijoles is not signed in (run frijoles login)' };
   const code = body?.code ?? null;
-  return { ok: false, code, why: body?.error ?? `gf exited ${res.status}` };
+  return { ok: false, code, why: body?.error ?? `frijoles exited ${res.status}` };
 }
 
 /**
- * The number and its evidence, fetched through gf (D17). Pure apart from the injected `run`.
+ * The number and its evidence, fetched through frijoles (D17). Pure apart from the injected `run`.
  * Returns `{ fetched, actual?, evidence?, reading?, decision?, grounded, why? }`.
  */
 export function fetchEvidence({ metric, experiment = null, today, shippedAt, project = null, run }) {
@@ -214,12 +219,12 @@ export function renderPlan(plan, { slug, fetched, write, written }) {
       out.push(`  not grounded: ${t.metric} is not one of the project's North Star inputs`);
     if (fetched.fetched)
       out.push(
-        `  fetched:  ${fig(fetched.reading.value)} on ${longDay(fetched.reading.date)} (gf north-star readings)`
+        `  fetched:  ${fig(fetched.reading.value)} on ${longDay(fetched.reading.date)} (frijoles north-star readings)`
       );
     else if (fetched.why) out.push(`  could not fetch the number: ${fetched.why}`);
     if (fetched.decision)
       out.push(
-        `  decision: ${fetched.decision.outcome ?? 'recorded'}${fetched.decision.chosenVariantKey ? ` (${fetched.decision.chosenVariantKey})` : ''} (gf experiments decision)`
+        `  decision: ${fetched.decision.outcome ?? 'recorded'}${fetched.decision.chosenVariantKey ? ` (${fetched.decision.chosenVariantKey})` : ''} (frijoles experiments decision)`
       );
     else if (fetched.decisionWhy) out.push(`  decision: ${fetched.decisionWhy}`);
   }

package/dist/init.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-// init.mjs — `gf-kit init`: adopt any repo by writing the Roadmap/ skeleton (golden-frijoles-plugin S3.2, D2).
+// init.mjs — `frijoles-kit init`: adopt any repo by writing the Roadmap/ skeleton (golden-frijoles-plugin S3.2, D2).
 //
 //   node scripts/init.mjs             # write the skeleton into projectRoot(); never overwrite a file
 //
 // ── Why ───────────────────────────────────────────────────────────────────────────────────────
-// A stranger who pastes the install prompt into an EXISTING repo gets the plugin, but `groom` needs
+// A stranger who pastes the install prompt into an EXISTING repo gets the plugin, but `refine` needs
 // somewhere to write on day one — `Roadmap/README.md`, `WAYS-OF-WORKING.md`, `LEARNINGS.md`, and the
-// `00-ideas/` funnel. `gf-kit init` is that one step: it writes the same skeleton a project spawned
+// `00-ideas/` funnel. `frijoles-kit init` is that one step: it writes the same skeleton a project spawned
 // from `template/` already has, into any repo, copied or installed (D2's two roots).
 //
 // ── Where the skeleton's SOURCE lives ─────────────────────────────────────────────────────────
@@ -45,7 +45,7 @@ import { dirname, join, resolve } from 'node:path';
 import { isInstalled, kitRoot, projectRoot } from './lib/project-root.mjs';
 
 /**
- * The Roadmap skeleton `gf-kit init` writes, relative both to its source root (template/, or
+ * The Roadmap skeleton `frijoles-kit init` writes, relative both to its source root (template/, or
  * kit/dist/skeleton/ once built) and to the project it writes into. ONE list: `build-kit.mjs` reads
  * this export to populate `kit/dist/skeleton/`, so there is no second copy of the file names to drift.
  */
@@ -104,7 +104,7 @@ export function initSkeleton({
 }
 
 /**
- * True when `project` resolves to the operator's own home directory — the one place `gf-kit init`
+ * True when `project` resolves to the operator's own home directory — the one place `frijoles-kit init`
  * must never write, even though `projectRoot()`'s walk-up can legitimately land there (a non-git
  * folder under a dotfiles repo tracked at `$HOME`). Pure given its injected `home`.
  */
@@ -116,7 +116,7 @@ function main() {
   const project = projectRoot();
   if (isHomeDirectory({ project })) {
     console.error(
-      `gf-kit init: refusing to run — the resolved project root is your home directory (${project}).\n` +
+      `frijoles-kit init: refusing to run — the resolved project root is your home directory (${project}).\n` +
         '  This usually means no Roadmap/ or .git was found between the current directory and $HOME,\n' +
         '  and $HOME itself is a git repo (a dotfiles checkout, for example). Run this from inside a\n' +
         '  real project — a directory with its own .git — or pass --root explicitly.'
@@ -124,7 +124,7 @@ function main() {
     return 2;
   }
   const { wrote, skipped } = initSkeleton({ project, log: (line) => console.log(line) });
-  console.log(`gf-kit init: ${wrote.length} written, ${skipped.length} already present.`);
+  console.log(`frijoles-kit init: ${wrote.length} written, ${skipped.length} already present.`);
   return 0;
 }
 

package/dist/intent-match.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// intent-match.mjs — how well a groomed pitch captured the ask it was written from (intent-match S1, D9–D15).
+// intent-match.mjs — how well a refined pitch captured the ask it was written from (intent-match S1, D9–D15).
 //
 //   node scripts/intent-match.mjs <seed.md>             print the score, the band and a route for each gap
 //   node scripts/intent-match.mjs <seed.md> --json      the same, as JSON on stdout (the report goes to stderr)
@@ -7,27 +7,27 @@
 //   node scripts/intent-match.mjs <seed.md> --no-route  skip the second call that routes each gap to an artifact
 //
 // ── ADVISORY, NEVER A GATE (D1) ──────────────────────────────────────────────────────────────────────────────
-// The score can add a step to a groom; it never blocks a scaffold and never removes the product owner's approval.
+// The score can add a step to a refinement; it never blocks a scaffold and never removes the product owner's approval.
 // Nothing reads the exit code as a verdict: 0 means "scored", 2 means "could not look", 1 means a usage error.
 //
 // ── ONE STATISTIC PER QUESTION (D2, D11) ─────────────────────────────────────────────────────────────────────
 // Each signal is one number over Jev Noul/Score answers, so a later calibration can fit weights and bands without
 // re-asking anything (the jev-reanchor spike's lesson). Coverage in = mean P(true) over the ask's claims; coverage
 // out = mean P(true) over the pitch's acceptance criteria; clarity = mean Score ÷ 3 over the same criteria;
-// teach-back = the product owner's answer to groom's Stage 1 mirror (yes 1 · partly 0.5 · no 0). The total is
+// teach-back = the product owner's answer to refine's Stage 1 mirror (yes 1 · partly 0.5 · no 0). The total is
 // 100 × the equal-weight mean of the signals PRESENT, and it always says "uncalibrated" and which signals it used:
 // the 80 / 60 bands are placeholders until `intent-outcomes` has twenty answered epics to fit them against.
 //
 // ── THREE STATES, NEVER TWO ──────────────────────────────────────────────────────────────────────────────────
 // No key, `jev.egress` not `true`, a state over Jev's budget, a timeout or a malformed answer all print "could not
-// look" and NO number. A partial score dressed as a whole one is worse than none: it is the number a groom would
+// look" and NO number. A partial score dressed as a whole one is worse than none: it is the number a refinement would
 // quote. The pitch is never truncated to fit — `askJev` refuses an over-budget state, and so do we.
 //
 // ── NOT A JEV RAIL (C2) ──────────────────────────────────────────────────────────────────────────────────────
 // A rail (`review`, `prose`) is a guard with a regex to fall back to and an off/shadow/jev switch. This decides
 // nothing and has no fallback, so it only reads `jev.egress` and `jev.model`: egress must be an explicit `true`.
 //
-// The seed format this parses is the contract in the epic README's D9 (and groom's `templates/scope-seed.md`):
+// The seed format this parses is the contract in the epic README's D9 (and refine's `templates/scope-seed.md`):
 // `## The ask, as given` → `### Claims` (a numbered list) → `**Teach-back:** yes | partly | no`, and the list under
 // the first `## Acceptance…` heading. Zero deps — Node 18+.
 
@@ -60,7 +60,7 @@ export const BANDS = Object.freeze([
   { min: 0, label: 'sketch or spike first' },
 ]);
 
-/** The artifacts a gap can be routed to (D14) — the visuals rule (groom Stage 4.6) draws from the same words. */
+/** The artifacts a gap can be routed to (D14) — the visuals rule (refine Stage 4.6) draws from the same words. */
 export const ROUTES = Object.freeze({
   copy_deck: 'copy deck',
   wireframe: 'wireframe',