@forwardimpact/libwiki 0.2.34 → 0.3.0

package/README.md

@@ -14,15 +14,15 @@ storyboards. `libwiki` keeps that wiki coherent across sessions — agents boot
 from it, write decisions back, send memos to each other, and audit the
 result against a declarative rule set.
 
-The primary interface is the `fit-wiki` CLI. The library also exposes a few
+The primary interface is the `gemba-wiki` CLI. The library also exposes a few
 helpers for programmatic use.
 
 ## Getting started
 
 ```sh
-npx fit-wiki init
-npx fit-wiki boot --agent staff-engineer
-npx fit-wiki audit
+npx gemba-wiki init
+npx gemba-wiki boot --agent staff-engineer
+npx gemba-wiki audit
 ```
 
 ## CLI
@@ -36,7 +36,7 @@ sweep that runs without `--agent`.
 ### `boot` — start a session
 
 ```sh
-npx fit-wiki boot --agent staff-engineer [--format json|markdown]
+npx gemba-wiki boot --agent staff-engineer [--format json|markdown]
 ```
 
 Print the on-boot digest for the agent: own priorities, cross-cutting
@@ -45,9 +45,9 @@ priorities, active claims, storyboard items, inbox count.
 ### `log` — record decisions, notes, done
 
 ```sh
-npx fit-wiki log decision --agent X --surveyed "..." --chosen "..." --rationale "..."
-npx fit-wiki log note     --agent X --field "PR Status" --body "merged"
-npx fit-wiki log done     --agent X
+npx gemba-wiki log decision --agent X --surveyed "..." --chosen "..." --rationale "..."
+npx gemba-wiki log note     --agent X --field "PR Status" --body "merged"
+npx gemba-wiki log done     --agent X
 ```
 
 Appends to `wiki/<agent>-YYYY-WVV.md`. Auto-rotates to `*-partN.md` when the
@@ -56,9 +56,9 @@ line budget would be exceeded.
 ### `claim` / `release` — coordinate work
 
 ```sh
-npx fit-wiki claim   --agent X --target spec-NNNN --branch claude/spec-NNNN
-npx fit-wiki release --agent X --target spec-NNNN
-npx fit-wiki release --expired
+npx gemba-wiki claim   --agent X --target spec-NNNN --branch claude/spec-NNNN
+npx gemba-wiki release --agent X --target spec-NNNN
+npx gemba-wiki release --expired
 ```
 
 Maintains the `## Active Claims` table in `MEMORY.md`. Duplicates refused;
@@ -68,10 +68,10 @@ claim is a short-lived "shipping this now" assertion, not a lease.
 ### `inbox` — triage memos
 
 ```sh
-npx fit-wiki inbox list    --agent X
-npx fit-wiki inbox ack     --agent X --index 0
-npx fit-wiki inbox promote --agent X --index 0 [--owner X]
-npx fit-wiki inbox drop    --agent X --index 0
+npx gemba-wiki inbox list    --agent X
+npx gemba-wiki inbox ack     --agent X --index 0
+npx gemba-wiki inbox promote --agent X --index 0 [--owner X]
+npx gemba-wiki inbox drop    --agent X --index 0
 ```
 
 Reads bullets under the `<!-- memo:inbox -->` marker in the agent's summary.
@@ -80,8 +80,8 @@ Reads bullets under the `<!-- memo:inbox -->` marker in the agent's summary.
 ### `memo` — cross-team coordination
 
 ```sh
-npx fit-wiki memo --from X --to Y   --message "audit d642ff0c"
-npx fit-wiki memo --from X --to all --message "new XmR baseline"
+npx gemba-wiki memo --from X --to Y   --message "audit d642ff0c"
+npx gemba-wiki memo --from X --to all --message "new XmR baseline"
 ```
 
 Inserts a bullet `- YYYY-MM-DD from **X**: ...` after the recipient's
@@ -90,7 +90,7 @@ Inserts a bullet `- YYYY-MM-DD from **X**: ...` after the recipient's
 ### `audit` — verify wiki state
 
 ```sh
-npx fit-wiki audit [--format text|json]
+npx gemba-wiki audit [--format text|json]
 ```
 
 Runs a declarative catalogue of rules across the wiki. Exits 0 on pass, 1
@@ -107,7 +107,7 @@ Each finding carries a stable `id` for filtering. The catalogue lives in
 ### `rotate` — force a part split
 
 ```sh
-npx fit-wiki rotate --agent X
+npx gemba-wiki rotate --agent X
 ```
 
 Renames the current weekly log to the next `-partN.md` and starts a fresh
@@ -116,7 +116,7 @@ main file.
 ### `refresh` — re-render storyboard blocks
 
 ```sh
-npx fit-wiki refresh [storyboard-path]
+npx gemba-wiki refresh [storyboard-path]
 ```
 
 Re-renders `<!-- xmr:metric:csv-path -->` and `<!-- obstacles:open[:Nd] -->`
@@ -128,9 +128,9 @@ deterministic refresh.
 ### `init` / `push` / `pull` — wiki working tree
 
 ```sh
-npx fit-wiki init [--wiki-root wiki] [--skills-dir .claude/skills]
-npx fit-wiki push
-npx fit-wiki pull
+npx gemba-wiki init [--wiki-root wiki] [--skills-dir .claude/skills]
+npx gemba-wiki push
+npx gemba-wiki pull
 ```
 
 `init` clones the wiki repo if missing, scaffolds Active Claims in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libwiki",
-  "version": "0.2.34",
+  "version": "0.3.0",
   "description": "Wiki lifecycle for agent teams — persistent memory, declarative integrity audits, and a collision ledger so coordination survives across sessions and parallel work.",
   "keywords": [
     "wiki",
@@ -31,14 +31,12 @@
   "main": "./src/index.js",
   "exports": {
     ".": "./src/index.js",
-    "./bin/fit-wiki.js": "./bin/fit-wiki.js"
-  },
-  "bin": {
-    "fit-wiki": "./bin/fit-wiki.js"
+    "./wiki-sync.js": "./src/wiki-sync.js",
+    "./util/wiki-dir.js": "./src/util/wiki-dir.js",
+    "./cli-definition.js": "./src/cli-definition.js"
   },
   "files": [
     "src/**/*.js",
-    "bin/**/*.js",
     "README.md"
   ],
   "scripts": {
@@ -47,11 +45,11 @@
   "dependencies": {
     "@forwardimpact/libcli": "^0.1.0",
     "@forwardimpact/libconfig": "^0.1.77",
-    "@forwardimpact/libharness": "^1.0.0",
+    "@forwardimpact/libharness": "^3.0.0",
     "@forwardimpact/libpreflight": "^0.1.0",
     "@forwardimpact/libtelemetry": "^0.1.47",
     "@forwardimpact/libutil": "^0.1.0",
-    "@forwardimpact/libxmr": "^2.0.0"
+    "@forwardimpact/libxmr": "^3.0.0"
   },
   "devDependencies": {
     "@forwardimpact/libmock": "^0.1.0"

package/src/audit/rules.js

@@ -94,7 +94,7 @@ export const RULES = [
     when: (s) => s.h2s.includes("Message Inbox"),
     check: containsLine(MEMO_INBOX_MARKER),
     message: () => `Missing ${MEMO_INBOX_MARKER} marker`,
-    hint: "add the marker directly below the '## Message Inbox' heading so `fit-wiki memo` can find it",
+    hint: "add the marker directly below the '## Message Inbox' heading so `gemba-wiki memo` can find it",
   },
   {
     id: "summary.open-blockers-last",
@@ -148,7 +148,7 @@ export const RULES = [
     check: lineBudget(WEEKLY_LOG_LINE_BUDGET),
     message: (_s, r) => `${r.value} lines (limit ${WEEKLY_LOG_LINE_BUDGET})`,
     hint: (s) =>
-      `run \`bunx fit-wiki rotate --agent ${s.agentPrefix}\` to seal this file as a sealed part and start a fresh weekly log`,
+      `run \`bunx gemba-wiki rotate --agent ${s.agentPrefix}\` to seal this file as a sealed part and start a fresh weekly log`,
   },
   {
     id: "weekly-log.word-budget",
@@ -158,7 +158,7 @@ export const RULES = [
     check: wordBudget(WEEKLY_LOG_WORD_BUDGET),
     message: (_s, r) => `${r.value} words (limit ${WEEKLY_LOG_WORD_BUDGET})`,
     hint: (s) =>
-      `run \`bunx fit-wiki rotate --agent ${s.agentPrefix}\` to seal this file as a sealed part and start a fresh weekly log`,
+      `run \`bunx gemba-wiki rotate --agent ${s.agentPrefix}\` to seal this file as a sealed part and start a fresh weekly log`,
   },
   {
     id: "weekly-log.h1-agent-matches-filename",
@@ -176,7 +176,7 @@ export const RULES = [
     check: headingGrammarDrift,
     message: (_s, r) =>
       `Entry heading '${r.observed}' does not match the dated grammar`,
-    hint: "weekly-log entry headings must be '## YYYY-MM-DD'; open entries with `fit-wiki log decision/note`, which emit a conforming heading the rotation seam-finder can split",
+    hint: "weekly-log entry headings must be '## YYYY-MM-DD'; open entries with `gemba-wiki log decision/note`, which emit a conforming heading the rotation seam-finder can split",
   },
   {
     id: "decision-block.heading-within-5",
@@ -191,7 +191,7 @@ export const RULES = [
       r.nearMiss
         ? `Entry opens with '${r.nearMiss}'; the heading must be exactly '${DECISION_HEADING}' — move the suffix into the body`
         : `Entry lacks a line that is exactly '${DECISION_HEADING}'`,
-    hint: `open each '## YYYY-MM-DD' entry with \`fit-wiki log decision\`, which emits a line containing exactly '${DECISION_HEADING}' (no suffix — the check is an exact match); put the one-line summary in the body below it, drawn from the entry's own narrative — do not invent rationale the entry does not support`,
+    hint: `open each '## YYYY-MM-DD' entry with \`gemba-wiki log decision\`, which emits a line containing exactly '${DECISION_HEADING}' (no suffix — the check is an exact match); put the one-line summary in the body below it, drawn from the entry's own narrative — do not invent rationale the entry does not support`,
   },
 
   // -- Weekly logs (sealed parts) --
@@ -211,7 +211,7 @@ export const RULES = [
     check: headingGrammarDrift,
     message: (_s, r) =>
       `Entry heading '${r.observed}' does not match the dated grammar`,
-    hint: "weekly-log entry headings must be '## YYYY-MM-DD'; open entries with `fit-wiki log decision/note`, which emit a conforming heading the rotation seam-finder can split",
+    hint: "weekly-log entry headings must be '## YYYY-MM-DD'; open entries with `gemba-wiki log decision/note`, which emit a conforming heading the rotation seam-finder can split",
   },
   {
     id: "weekly-log-part.line-budget",
@@ -220,7 +220,7 @@ export const RULES = [
     remediation: "rotate",
     check: lineBudget(WEEKLY_LOG_LINE_BUDGET),
     message: (_s, r) => `${r.value} lines (limit ${WEEKLY_LOG_LINE_BUDGET})`,
-    hint: "`bunx fit-wiki fix` re-bisects an over-budget part at its day-section seams and, for a lone over-cap day, at its '### ' block seams; only a single '### ' block that alone exceeds the budget remains for a human to shorten",
+    hint: "`bunx gemba-wiki fix` re-bisects an over-budget part at its day-section seams and, for a lone over-cap day, at its '### ' block seams; only a single '### ' block that alone exceeds the budget remains for a human to shorten",
   },
   {
     id: "weekly-log-part.word-budget",
@@ -229,7 +229,7 @@ export const RULES = [
     remediation: "rotate",
     check: wordBudget(WEEKLY_LOG_WORD_BUDGET),
     message: (_s, r) => `${r.value} words (limit ${WEEKLY_LOG_WORD_BUDGET})`,
-    hint: "`bunx fit-wiki fix` re-bisects an over-budget part at its day-section seams and, for a lone over-cap day, at its '### ' block seams; only a single '### ' block that alone exceeds the budget remains for a human to shorten",
+    hint: "`bunx gemba-wiki fix` re-bisects an over-budget part at its day-section seams and, for a lone over-cap day, at its '### ' block seams; only a single '### ' block that alone exceeds the budget remains for a human to shorten",
   },
   {
     id: "weekly-log-part.h1-agent-matches-filename",
@@ -273,7 +273,7 @@ export const RULES = [
     severity: "fail",
     check: exists,
     message: () => "MEMORY.md not found",
-    hint: "run `bunx fit-wiki init` to scaffold the canonical sections",
+    hint: "run `bunx gemba-wiki init` to scaffold the canonical sections",
   },
   {
     id: "memory.line-budget",
@@ -371,7 +371,7 @@ export const RULES = [
     severity: "warn",
     check: expired,
     message: (s) => `${s.agent}/${s.target} expired ${s.expires_at}`,
-    hint: "run `bunx fit-wiki refresh` (or `release --expired`) to clear expired claims",
+    hint: "run `bunx gemba-wiki refresh` (or `release --expired`) to clear expired claims",
   },
 
   // -- Storyboards --

package/src/audit/scopes.js

@@ -27,7 +27,7 @@ const NON_SUMMARY_PREFIXES = [
   "downstream-",
   "memory-protocol-",
   "kata-interview-",
-  "fit-trace-",
+  "gemba-trace-",
 ];
 
 function listMdFiles(wikiRoot, fs) {

package/src/cli-definition.js

@@ -14,7 +14,7 @@ import { runFixCommand } from "./commands/fix.js";
 import { runLedgerCommand } from "./commands/ledger.js";
 
 /**
- * Build the `fit-wiki` libcli definition. Agent identity is never resolved from
+ * Build the `gemba-wiki` libcli definition. Agent identity is never resolved from
  * the environment: agent-scoped subcommands require an explicit `--agent`
  * (`--from` for `memo`) and fail closed without it, so this module carries no
  * ambient agent identity. The version is resolved by libcli's `createCli` from
@@ -47,7 +47,7 @@ export function createDefinition() {
   };
 
   return {
-    name: "fit-wiki",
+    name: "gemba-wiki",
     description: "Wiki lifecycle management for the Kata agent system",
     commands: [
       {
@@ -348,21 +348,21 @@ export function createDefinition() {
       },
     },
     examples: [
-      "fit-wiki boot --agent staff-engineer",
-      'fit-wiki log decision --agent staff-engineer --surveyed "..." --chosen "..." --rationale "..."',
-      "fit-wiki claim --agent staff-engineer --target spec-NNNN --branch claude/...",
-      "fit-wiki release --agent staff-engineer --target spec-NNNN",
-      "fit-wiki inbox list --agent staff-engineer",
-      "fit-wiki rotate --agent staff-engineer",
-      "fit-wiki audit",
-      "fit-wiki curate",
-      "fit-wiki fix",
-      'fit-wiki memo --from staff-engineer --to security-engineer --message "audit d642ff0c"',
-      "fit-wiki refresh",
-      "fit-wiki product-mix",
-      "fit-wiki init",
-      "fit-wiki push",
-      "fit-wiki pull",
+      "gemba-wiki boot --agent staff-engineer",
+      'gemba-wiki log decision --agent staff-engineer --surveyed "..." --chosen "..." --rationale "..."',
+      "gemba-wiki claim --agent staff-engineer --target spec-NNNN --branch claude/...",
+      "gemba-wiki release --agent staff-engineer --target spec-NNNN",
+      "gemba-wiki inbox list --agent staff-engineer",
+      "gemba-wiki rotate --agent staff-engineer",
+      "gemba-wiki audit",
+      "gemba-wiki curate",
+      "gemba-wiki fix",
+      'gemba-wiki memo --from staff-engineer --to security-engineer --message "audit d642ff0c"',
+      "gemba-wiki refresh",
+      "gemba-wiki product-mix",
+      "gemba-wiki init",
+      "gemba-wiki push",
+      "gemba-wiki pull",
     ],
     documentation: [
       {

package/src/commands/boot.js

@@ -46,7 +46,7 @@ export function runBootCommand(ctx) {
   const options = ctx.options;
   const resolved = requireAgentFlag(options, {
     command: "boot",
-    example: "fit-wiki boot --agent staff-engineer",
+    example: "gemba-wiki boot --agent staff-engineer",
   });
   if (!resolved.ok) return resolved;
   const agent = resolved.agent;

package/src/commands/claim.js

@@ -150,7 +150,7 @@ export async function runClaimCommand(ctx) {
   const resolved = requireAgentFlag(options, {
     command: "claim",
     example:
-      "fit-wiki claim --agent staff-engineer --target spec-NNNN --branch claude/...",
+      "gemba-wiki claim --agent staff-engineer --target spec-NNNN --branch claude/...",
   });
   if (!resolved.ok) return resolved;
   const agent = resolved.agent;
@@ -245,7 +245,7 @@ export async function runReleaseCommand(ctx) {
 
   const resolved = requireAgentFlag(options, {
     command: "release",
-    example: "fit-wiki release --agent staff-engineer --target spec-NNNN",
+    example: "gemba-wiki release --agent staff-engineer --target spec-NNNN",
   });
   if (!resolved.ok) return resolved;
   const agent = resolved.agent;

package/src/commands/curate.js

@@ -19,7 +19,7 @@ const TITLE = "Wiki curation: shared-state audit findings";
 // GitHub rejects an issue or comment body over 65536 characters. Keep the whole
 // body under a margin below that so the preamble, JSON fence, and truncation
 // notice always fit. When the findings overflow, the body carries the first N
-// that fit plus a count; the full list stays reproducible via `fit-wiki audit`.
+// that fit plus a count; the full list stays reproducible via `gemba-wiki audit`.
 const MAX_BODY = 65000;
 
 /**
@@ -39,7 +39,7 @@ function buildBody(findingsJson, { shown, total } = {}) {
   ];
   if (total != null && shown != null && shown < total) {
     lines.push(
-      `Showing ${shown} of ${total} findings — the body was truncated to fit GitHub's comment limit. Run \`fit-wiki audit\` for the full list.`,
+      `Showing ${shown} of ${total} findings — the body was truncated to fit GitHub's comment limit. Run \`gemba-wiki audit\` for the full list.`,
       "",
     );
   }

package/src/commands/fix.js

@@ -122,7 +122,7 @@ function sealMainLog(agent, { wikiRoot, today, projectRoot, fs, out, err }) {
       );
     }
   } catch (e) {
-    err(`fit-wiki fix: rotate failed for ${agent}: ${e.message}\n`);
+    err(`gemba-wiki fix: rotate failed for ${agent}: ${e.message}\n`);
   }
 }
 
@@ -164,7 +164,7 @@ function resealPart(partPath, { fs, projectRoot, out, err }) {
     }
   } catch (e) {
     err(
-      `fit-wiki fix: rebisect failed for ` +
+      `gemba-wiki fix: rebisect failed for ` +
         `${path.relative(projectRoot, partPath)}: ${e.message}\n`,
     );
   }
@@ -193,7 +193,7 @@ function rebisectOverBudgetParts(findings, deps) {
 /** Report findings that need human judgment — never auto-fixed. */
 function reportFlags(err, flagFindings, projectRoot) {
   err(
-    `fit-wiki fix: ${flagFindings.length} finding(s) need human judgment ` +
+    `gemba-wiki fix: ${flagFindings.length} finding(s) need human judgment ` +
       `(not auto-fixable):\n` +
       emitFindingsText(flagFindings, { cwd: projectRoot }),
   );
@@ -209,10 +209,10 @@ function reportFlags(err, flagFindings, projectRoot) {
 function isFatalError(result, round, err) {
   if (!result.error) return false;
   if (!result.sessionId) {
-    err(`fit-wiki fix: agent run failed: ${result.error.message}\n`);
+    err(`gemba-wiki fix: agent run failed: ${result.error.message}\n`);
     return true;
   }
-  err(`fit-wiki fix: round ${round} agent error: ${result.error.message}\n`);
+  err(`gemba-wiki fix: round ${round} agent error: ${result.error.message}\n`);
   return false;
 }
 
@@ -265,7 +265,7 @@ async function runAgentRounds(runner, agentFindings, deps) {
   }
 
   err(
-    `fit-wiki fix: ${agentFindings.length} finding(s) remain after ` +
+    `gemba-wiki fix: ${agentFindings.length} finding(s) remain after ` +
       `${MAX_ROUNDS} round(s):\n` +
       emitFindingsText(agentFindings, { cwd: projectRoot }),
   );

package/src/commands/inbox.js

@@ -13,7 +13,7 @@ function paths(runtime, options) {
   const wikiRoot = resolveWikiRoot(runtime, options);
   const resolved = requireAgentFlag(options, {
     command: "inbox",
-    example: "fit-wiki inbox list --agent staff-engineer",
+    example: "gemba-wiki inbox list --agent staff-engineer",
   });
   if (!resolved.ok) return { error: resolved };
   const agent = resolved.agent;

package/src/commands/init.js

@@ -32,7 +32,7 @@ function scaffoldActiveClaims(runtime, memoryPath) {
     ACTIVE_CLAIMS_HEADING,
     "",
     "In-flight work claimed by an agent. Row present = active; row absent = settled.",
-    "Writers: `fit-wiki claim`, `fit-wiki release`. Reader: `fit-wiki boot`.",
+    "Writers: `gemba-wiki claim`, `gemba-wiki release`. Reader: `gemba-wiki boot`.",
     "",
     ACTIVE_CLAIMS_TABLE_HEADER,
     ACTIVE_CLAIMS_TABLE_SEPARATOR,

package/src/commands/ledger.js

@@ -181,7 +181,7 @@ async function verify(env, options) {
 const SUBS = { allocate, rebuild, verify };
 
 /**
- * `fit-wiki ledger <allocate|rebuild|verify>` — the allocation procedure that
+ * `gemba-wiki ledger <allocate|rebuild|verify>` — the allocation procedure that
  * keeps identity off the merge-contested page. Allocation publishes an anchor
  * comment to the obstacle issue with no projection write at allocation time;
  * rebuild and verify project the anchor record onto the ledger page and MEMORY

package/src/commands/log.js

@@ -19,7 +19,7 @@ function commonContext(runtime, options) {
   const resolved = requireAgentFlag(options, {
     command: "log",
     example:
-      'fit-wiki log decision --agent staff-engineer --chosen "..." --rationale "..."',
+      'gemba-wiki log decision --agent staff-engineer --chosen "..." --rationale "..."',
   });
   if (!resolved.ok) return { error: resolved };
   const wikiRoot = resolveWikiRoot(runtime, options);

package/src/commands/memo.js

@@ -72,7 +72,7 @@ export function runMemoCommand(ctx) {
     command: "memo",
     flag: "--from",
     example:
-      'fit-wiki memo --from staff-engineer --to security-engineer --message "..."',
+      'gemba-wiki memo --from staff-engineer --to security-engineer --message "..."',
   });
   if (!resolved.ok) return resolved;
   const sender = resolved.agent;

package/src/commands/product-mix.js

@@ -76,7 +76,7 @@ function countByLabel(prs) {
  * Emit the product-vs-internal mix of merged PRs as a `product_share` metric
  * row. Counts PRs merged in `[since, until]` by their `product` / `internal`
  * label and appends `product_share = round(product / (product + internal) *
- * 100)` to `wiki/metrics/product-mix/<YYYY>.csv` via the `fit-xmr record` write
+ * 100)` to `wiki/metrics/product-mix/<YYYY>.csv` via the `gemba-xmr record` write
  * path. Deterministic — re-running over the same merged PRs yields the same
  * value. A window with no labeled merged PRs emits no row (avoids a 0/0 ratio).
  */
@@ -117,7 +117,7 @@ export async function runProductMixCommand(ctx) {
 
   const share = Math.round((product / total) * 100);
   const recordArgs = [
-    "fit-xmr",
+    "gemba-xmr",
     "record",
     "--skill",
     "product-mix",
@@ -142,7 +142,7 @@ export async function runProductMixCommand(ctx) {
 
   const recordResult = await runtime.subprocess.run("npx", recordArgs, { cwd });
   if (recordResult.exitCode !== 0) {
-    logger.warn("product-mix", "fit-xmr record failed");
+    logger.warn("product-mix", "gemba-xmr record failed");
   }
   return { ok: true };
 }

package/src/commands/rotate.js

@@ -15,7 +15,7 @@ export function runRotateCommand(ctx) {
   const options = ctx.options;
   const resolved = requireAgentFlag(options, {
     command: "rotate",
-    example: "fit-wiki rotate --agent staff-engineer",
+    example: "gemba-wiki rotate --agent staff-engineer",
   });
   if (!resolved.ok) return resolved;
   const agent = resolved.agent;

package/src/constants.js

@@ -94,7 +94,7 @@ export const CARRY_SURFACE_H1_RE = /^# (.+) — Carries$/;
 export const CARRY_CLEARANCE_MARKER_RE = /\*\*Carry-clearance:\*\*/;
 
 // Storyboard marker syntax. An open or close marker tolerates optional trailing
-// text after the tag (typically an inline "Do not edit. Generated from fit-wiki
+// text after the tag (typically an inline "Do not edit. Generated from gemba-wiki
 // refresh." notice). One home so the marker scanner (marker-scanner.js) and the
 // audit's balance check (audit/rules.js) cannot drift on the syntax.
 // Capture groups: 1 metric, 2 csvPath, 3 optional prior-read anchor date. The
@@ -110,7 +110,7 @@ export const ISSUE_CLOSE_RE =
 
 // Materialized per-agent experiments surface. A distinct marker
 // kind from `experiments:open` — it carries attributed, sanitized items plus a
-// last-successful-sync stamp, and is read offline by `fit-wiki boot`. One home
+// last-successful-sync stamp, and is read offline by `gemba-wiki boot`. One home
 // so the scanner (marker-scanner.js), the refresh renderer (commands/refresh.js),
 // the boot parser (boot.js), and the audit balance check (audit/rules.js) cannot
 // drift on the syntax.

package/src/ledger/projection.js

@@ -72,7 +72,7 @@ export function renderLedgerPage(
   const lines = [
     "# Parallel-Collision Ledger",
     "",
-    "Derived projection of the allocation-anchor record. Rebuilt by `fit-wiki ledger rebuild`; do not hand-edit identifiers here — allocate at an anchor.",
+    "Derived projection of the allocation-anchor record. Rebuilt by `gemba-wiki ledger rebuild`; do not hand-edit identifiers here — allocate at an anchor.",
     "",
     ...renderKindSections(fold),
     ...renderConflicts(fold, labelMode),

package/src/storyboard-skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Storyboard skeleton — the minimal, valid storyboard file `fit-wiki refresh`
+ * Storyboard skeleton — the minimal, valid storyboard file `gemba-wiki refresh`
  * writes when the current-month board does not yet exist. It carries only the
  * structural surface libwiki owns: the five Toyota Kata sections and the
  * generic `obstacles`/`experiments` issue-list marker blocks that refresh

package/src/wiki-sync.js

@@ -319,7 +319,7 @@ export class WikiSync {
    *
    * The commit is always pathspec-scoped: with `paths` the scope is the
    * caller's declared write-set, and without `paths` it is the session's own
-   * dirty set (`#dirtyPaths`, the `fit-wiki push` contract under per-session
+   * dirty set (`#dirtyPaths`, the `gemba-wiki push` contract under per-session
    * checkout isolation). The whole-tree `add -A` sweep is gone, so foreign
    * content on undeclared paths is never staged and the stale fast-forward
    * eraser it carried no longer exists; the rebase runs with --autostash
@@ -465,7 +465,7 @@ export class WikiSync {
     ).changed;
     // Attribute the commit's write-set. A caller that knows
     // its narrower write-set passes `paths` (the claim/release path, scoped to
-    // MEMORY.md). The session-close `fit-wiki push` passes none and the
+    // MEMORY.md). The session-close `gemba-wiki push` passes none and the
     // write-set is the session's own dirty set, read from the working tree —
     // correct because the canonical mechanism runs it in a per-session isolated
     // checkout where the dirty set holds no foreign content. The whole-tree
@@ -638,7 +638,7 @@ export class WikiSync {
     const files = [...new Set(gate.refusals.map((r) => r.file))].join(", ");
     return new WikiPushFailure(
       PUSH_REASONS.BUDGET,
-      "fit-wiki: refusing to push — it would introduce or deepen a budget " +
+      "gemba-wiki: refusing to push — it would introduce or deepen a budget " +
         `breach in ${files} (${lead.ruleId}: ${lead.value} vs baseline ` +
         `${lead.baseline}). Trim your own content or surface the carried ` +
         "content to its owner, then re-push; your work is committed locally.",
@@ -682,7 +682,7 @@ export class WikiSync {
     });
     throw new WikiPushFailure(
       PUSH_REASONS.RESIDUE_CONFLICT,
-      "fit-wiki: refusing to push — a foreign writer's residue conflicted " +
+      "gemba-wiki: refusing to push — a foreign writer's residue conflicted " +
         "on the autostash pop; your stash is preserved at " +
         `${stashSha || "refs/stash"} (git stash list). Resolve or pop it ` +
         "from the true tip.",
@@ -736,8 +736,8 @@ export class WikiSync {
     // No-intent path: fail loud rather than discard the remote side (D2).
     throw new WikiPushFailure(
       PUSH_REASONS.CONFLICT,
-      "fit-wiki: refusing to push — rebase conflict with the remote. " +
-        "Resolve or retry from the true tip (fit-wiki pull, then push).",
+      "gemba-wiki: refusing to push — rebase conflict with the remote. " +
+        "Resolve or retry from the true tip (gemba-wiki pull, then push).",
     );
   }
 
@@ -923,7 +923,7 @@ export class WikiSync {
     if (this.#rebaseInProgress()) {
       throw new WikiPushFailure(
         PUSH_REASONS.PRECONDITION,
-        "fit-wiki: refusing to act — a rebase is in progress. Resolve or " +
+        "gemba-wiki: refusing to act — a rebase is in progress. Resolve or " +
           "abort it before retrying; your uncommitted edit is preserved.",
       );
     }
@@ -1061,7 +1061,7 @@ export class WikiSync {
       this.#reportConservation("refusal");
       throw new WikiPushFailure(
         PUSH_REASONS.CONSERVATION,
-        "fit-wiki: refusing to push — it would drop another writer's " +
+        "gemba-wiki: refusing to push — it would drop another writer's " +
           `content in ${file} that is present on the remote. Pull and ` +
           "re-apply, or declare the removal if it is deliberate.",
       );
@@ -1176,7 +1176,7 @@ export class WikiSync {
   }
 
   #sidecarPath() {
-    return path.join(this.#wikiDir, ".git", "fit-wiki-removal-intent");
+    return path.join(this.#wikiDir, ".git", "gemba-wiki-removal-intent");
   }
 
   /** Read the clone-local removal-intent sidecar (declared deliberate removals). */
@@ -1226,7 +1226,7 @@ export class WikiSync {
         reason: PUSH_REASONS.TRANSPORT,
         error: new WikiPushFailure(
           PUSH_REASONS.TRANSPORT,
-          "fit-wiki: push failed at transport (network or credentials). " +
+          "gemba-wiki: push failed at transport (network or credentials). " +
             "Your work is committed locally; retry when connectivity returns.",
         ),
       };
@@ -1240,7 +1240,7 @@ export class WikiSync {
         reason: PUSH_REASONS.TRANSPORT,
         error: new WikiPushFailure(
           PUSH_REASONS.TRANSPORT,
-          "fit-wiki: push did not land and the remote could not be observed " +
+          "gemba-wiki: push did not land and the remote could not be observed " +
             "(network or credentials). Your work is committed locally.",
         ),
       };
@@ -1250,8 +1250,8 @@ export class WikiSync {
       reason: PUSH_REASONS.REJECTED,
       error: new WikiPushFailure(
         PUSH_REASONS.REJECTED,
-        "fit-wiki: push rejected — the remote advanced. Rerun from the true " +
-          "tip (fit-wiki pull, then push).",
+        "gemba-wiki: push rejected — the remote advanced. Rerun from the true " +
+          "tip (gemba-wiki pull, then push).",
       ),
     };
   }
@@ -1309,7 +1309,7 @@ export class WikiSync {
     if ((await this.#git.headBranch({ cwd })) !== BRANCH) {
       throw new AncestryRefusal(
         "unverifiable",
-        "fit-wiki: refusing to publish — HEAD is detached, so the configured " +
+        "gemba-wiki: refusing to publish — HEAD is detached, so the configured " +
           "branch would be pushed instead of your work. Re-clone the wiki.",
       );
     }
@@ -1325,7 +1325,7 @@ export class WikiSync {
       } catch {
         throw new AncestryRefusal(
           "unverifiable",
-          "fit-wiki: refusing to publish — could not observe the remote to " +
+          "gemba-wiki: refusing to publish — could not observe the remote to " +
             "verify ancestry; the local change is not published.",
         );
       }
@@ -1345,7 +1345,7 @@ export class WikiSync {
       } catch {
         throw new AncestryRefusal(
           "unverifiable",
-          "fit-wiki: refusing to publish — could not fetch the remote branch " +
+          "gemba-wiki: refusing to publish — could not fetch the remote branch " +
             "to verify ancestry; the local change is not published.",
         );
       }
@@ -1355,7 +1355,7 @@ export class WikiSync {
     if (!(await this.#git.refExists("HEAD", { cwd }))) {
       throw new AncestryRefusal(
         "unrelated",
-        "fit-wiki: refusing to publish — HEAD is unborn but the remote " +
+        "gemba-wiki: refusing to publish — HEAD is unborn but the remote " +
           "branch exists. Re-clone the wiki.",
       );
     }
@@ -1367,7 +1367,7 @@ export class WikiSync {
     if (!this.#isShallow()) {
       throw new AncestryRefusal(
         "unrelated",
-        "fit-wiki: refusing to publish — local history is unrelated to the " +
+        "gemba-wiki: refusing to publish — local history is unrelated to the " +
           "remote branch. Re-clone the wiki.",
       );
     }
@@ -1377,14 +1377,14 @@ export class WikiSync {
     if (deepen.exitCode !== 0) {
       throw new AncestryRefusal(
         "unverifiable",
-        "fit-wiki: refusing to publish — could not deepen history to verify " +
+        "gemba-wiki: refusing to publish — could not deepen history to verify " +
           "ancestry; the local change is not published.",
       );
     }
     if (await this.#git.mergeBaseExists(REMOTE_BRANCH, "HEAD", { cwd })) return;
     throw new AncestryRefusal(
       "unrelated",
-      "fit-wiki: refusing to publish — local history is unrelated to the " +
+      "gemba-wiki: refusing to publish — local history is unrelated to the " +
         "remote branch (confirmed against full history). Re-clone the wiki.",
     );
   }

package/bin/fit-wiki.js

@@ -1,94 +0,0 @@
-#!/usr/bin/env node
-
-import "@forwardimpact/libpreflight/node22";
-
-import { createDefaultRuntime } from "@forwardimpact/libutil/runtime";
-import { GitClient } from "@forwardimpact/libutil/git-client";
-import { GhClient } from "@forwardimpact/libutil/gh-client";
-import { createScriptConfig } from "@forwardimpact/libconfig";
-import { createCli } from "@forwardimpact/libcli";
-import { createLogger } from "@forwardimpact/libtelemetry";
-import { WikiSync } from "../src/wiki-sync.js";
-import {
-  resolveProjectRoot,
-  resolveWikiRoot,
-  wikiExists,
-} from "../src/util/wiki-dir.js";
-import { createDefinition } from "../src/cli-definition.js";
-
-// Commands that mutate or sync the remote wiki need a constructed WikiSync
-// (and its config-backed token resolver); the rest run against the local tree.
-const NEEDS_WIKI_SYNC = new Set(["claim", "release", "push", "pull", "init"]);
-
-// The ledger command reads and writes the allocation-anchor surface (the
-// obstacle issue's comments) over the GitHub API, so it needs a GhClient.
-const NEEDS_GH_CLIENT = new Set(["ledger"]);
-
-async function main() {
-  const runtime = createDefaultRuntime();
-  const definition = createDefinition();
-  const cli = createCli(definition, {
-    runtime,
-    packageJsonUrl: new URL("../package.json", import.meta.url),
-  });
-
-  const parsed = cli.parse(runtime.proc.argv.slice(2));
-  if (!parsed) return runtime.proc.exit(0); // --help / --version already printed
-
-  const { positionals } = parsed;
-  if (positionals.length === 0) {
-    cli.showHelp();
-    return runtime.proc.exit(0);
-  }
-
-  const command = positionals[0];
-  if (!definition.commands.some((c) => c.name === command)) {
-    cli.usageError(`unknown command "${command}"`);
-    return runtime.proc.exit(2);
-  }
-
-  // Every command except `init` operates on an existing wiki tree. When it is
-  // absent (e.g. a fresh worktree where bootstrap.sh never ran), degrade
-  // gracefully: warn and exit 0 so the session Stop hook and other callers do
-  // not fail loudly. `init` is exempt — it creates the tree.
-  if (command !== "init") {
-    const wikiDir = resolveWikiRoot(runtime, parsed.values);
-    if (!wikiExists(runtime, wikiDir)) {
-      createLogger("wiki", runtime).warn(
-        command,
-        `no wiki at ${wikiDir}; skipping (run \`fit-wiki init\` to create one)`,
-      );
-      return runtime.proc.exit(0);
-    }
-  }
-
-  const gitClient = new GitClient({ runtime });
-  let wikiSync;
-  if (NEEDS_WIKI_SYNC.has(command)) {
-    const projectRoot = resolveProjectRoot(runtime);
-    const wikiDir = resolveWikiRoot(runtime, parsed.values);
-    const config = await createScriptConfig("wiki");
-    wikiSync = new WikiSync({
-      runtime,
-      gitClient,
-      wikiDir,
-      parentDir: projectRoot,
-      resolveToken: () => config.ghToken(),
-    });
-  }
-
-  let ghClient;
-  if (NEEDS_GH_CLIENT.has(command)) {
-    ghClient = new GhClient({ runtime });
-  }
-
-  const result = await cli.dispatch(parsed, {
-    deps: { runtime, wikiSync, gitClient, ghClient },
-  });
-
-  const envelope = result ?? { ok: true };
-  if (!envelope.ok && envelope.error) cli.usageError(envelope.error);
-  runtime.proc.exit(envelope.ok ? 0 : (envelope.code ?? 1));
-}
-
-main();