@ritualai/cli 0.7.15 → 0.8.0

package/dist/lib/final-cta-box.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * Final CTA box — last screen of `ritual init` in compact mode.
+ *
+ * Two-column "Ready to ship" panel that lands RIGHT after the
+ * build-flow explainer (which is the "here's what /ritual build
+ * does" payoff). Its job: turn the FTUE into action.
+ *
+ *   LEFT column  — primary CTA. Per-agent restart instructions
+ *                  (only the agents we actually wired this run),
+ *                  then the literal command to ask their coding
+ *                  agent next: `/ritual build "<your feature>"`.
+ *
+ *   RIGHT column — "more info — invoke when you want it" menu of
+ *                  secondary commands. By NOT printing the details
+ *                  by default, we keep the CTA scannable; the user
+ *                  knows what to type if they want depth.
+ *
+ * Why a separate file: the box helpers (top/padded/bottom) +
+ * stripAnsi + column-padding math are ~50 lines and they recur
+ * across the FTUE panels. Better to factor here so each new panel
+ * can `import { boxTop, boxPadded, boxBottom }` rather than copy-
+ * pasting. Composable. If we add more panels we lift these into
+ * `box.ts`.
+ *
+ * Width: 110 chars. Deliberately matches `welcome-banner.ts` so
+ * the FTUE is visually bookended — same frame at the open as the
+ * close. The two FTUE-middle explainers (workspace + build-flow)
+ * use the narrower 78-char frame because their bodies need to
+ * breathe vertically rather than horizontally.
+ *
+ * Non-TTY / narrow terminal fallback: caller is expected to choose
+ * `printFinalCtaBoxTerse` instead — same content, no chrome.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printFinalCtaBox = printFinalCtaBox;
+exports.printFinalCtaBoxTerse = printFinalCtaBoxTerse;
+exports.boxTop = boxTop;
+exports.boxBottom = boxBottom;
+const colors_1 = require("./colors");
+/** Width target. Matches welcome-banner.ts so FTUE is bookended. */
+const W = 110;
+/** Left column width (CTA). Sized for the longest restart bullet
+ *  ("VS Code: Cmd+Shift+P → \"Developer: Reload Window\"" = ~50 chars
+ *  after the bullet indent) PLUS the 4-char `⚠  ` warning marker
+ *  + warning text. Sized once here so the whole frame doesn't shift
+ *  if we add an agent later — easier than per-row truncation. */
+const LEFT_W = 64;
+/**
+ * Render the final CTA box to stdout. Caller chooses whether to
+ * invoke this (compact mode) or the verbose-mode 3 print blocks.
+ */
+function printFinalCtaBox(opts) {
+    const titleBar = (0, colors_1.color)(colors_1.RITUAL_TEAL, '─ ready to ship ');
+    const top = boxTop(W, titleBar);
+    const bottom = boxBottom(W);
+    const leftLines = renderLeftColumn(opts);
+    const rightLines = renderRightColumn();
+    // Pad both columns to the same row count so the inner divider
+    // reads cleanly top-to-bottom.
+    const rows = Math.max(leftLines.length, rightLines.length);
+    while (leftLines.length < rows)
+        leftLines.push('');
+    while (rightLines.length < rows)
+        rightLines.push('');
+    const divider = (0, colors_1.color)(colors_1.RITUAL_TEAL, '│');
+    const rightW = W - LEFT_W - 3; // minus 3 dividers (outer + inner + outer)
+    const lines = [];
+    lines.push(top);
+    lines.push(twoColRow('', '', divider));
+    for (let i = 0; i < rows; i++) {
+        const l = padDisplay(leftLines[i], LEFT_W);
+        const r = padDisplay(rightLines[i], rightW);
+        lines.push(`${divider}${l}${divider}${r}${divider}`);
+    }
+    lines.push(twoColRow('', '', divider));
+    lines.push(bottom);
+    for (const ln of lines)
+        process.stdout.write(ln + '\n');
+}
+/**
+ * Narrow-terminal fallback (TTY-styled). Renders the same content
+ * as the rich 110-wide box but stacked vertically with a single
+ * accent-color rule between sections instead of split columns —
+ * fits at any width ≥ 78 cols. Honors NO_COLOR / non-TTY via the
+ * `color/dim/boldColor` helpers (they auto-degrade to plain text).
+ *
+ * Fires when stdout columns are between 78 and 99, OR when stdout
+ * isn't a TTY (CI / piped output) — the colors collapse to plain
+ * text in that path.
+ */
+function printFinalCtaBoxTerse(opts) {
+    const out = process.stdout.write.bind(process.stdout);
+    const rule = (label) => `  ${(0, colors_1.color)(colors_1.RITUAL_TEAL, '─')} ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, label)}`;
+    const amber = [0xe0, 0xa8, 0x4f];
+    out('\n');
+    out(`  ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, 'ready to ship')}\n`);
+    out('\n');
+    if (opts.insideClaudeWarning) {
+        out(`  ${(0, colors_1.boldColor)(amber, '⚠  ' + opts.insideClaudeWarning)}\n`);
+        out('\n');
+    }
+    out(`${rule('1. restart your coding agents')}\n`);
+    for (const line of restartLinesFor(opts.wiredAgentNames)) {
+        out(`     ${(0, colors_1.dim)('•')} ${line}\n`);
+    }
+    out('\n');
+    out(`${rule('2. ask your coding agent')}\n`);
+    out(`     ${(0, colors_1.color)(colors_1.RITUAL_TEAL, '›')} /ritual build "<your feature>"\n`);
+    out('\n');
+    out(`  ${(0, colors_1.dim)('more info — invoke when you want it:')}\n`);
+    const pairs = [
+        ['ritual init --verbose', 'what was wired up · paths · key info'],
+        ['ritual doctor', 'verify the MCP connection · diagnose'],
+        ['ritual graph status', 'see what\'s in this workspace'],
+    ];
+    const colW = Math.max(...pairs.map(([c]) => c.length));
+    for (const [cmd, desc] of pairs) {
+        out(`    ${(0, colors_1.color)(colors_1.RITUAL_TEAL, cmd.padEnd(colW))}  ${(0, colors_1.dim)('— ' + desc)}\n`);
+    }
+    out('\n');
+}
+// ─── column content ──────────────────────────────────────────────────────────
+function renderLeftColumn(opts) {
+    const lines = [];
+    if (opts.insideClaudeWarning) {
+        // ⚠ warning belongs on the LEFT (CTA side) because the user
+        // has to act on it before the CTA below it works. Bold so it
+        // doesn't get lost in the chrome.
+        lines.push(`  ${(0, colors_1.boldColor)([0xe0, 0xa8, 0x4f], '⚠  ' + opts.insideClaudeWarning)}`);
+        lines.push('');
+    }
+    lines.push(`  ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, '1. restart your coding agents')}`);
+    for (const r of restartLinesFor(opts.wiredAgentNames)) {
+        lines.push(`     ${(0, colors_1.dim)('•')} ${r}`);
+    }
+    lines.push('');
+    lines.push(`  ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, '2. ask your coding agent')}`);
+    lines.push('');
+    lines.push(`     ${(0, colors_1.color)(colors_1.RITUAL_TEAL, '›')} /ritual build "<your feature>"`);
+    return lines;
+}
+function renderRightColumn() {
+    // Each secondary command is a 2-row pair: command name (cyan
+    // accent) + one-line description (dim). Blank rows between pairs
+    // so the eye groups them; matches the rhythm of `gh help` output.
+    const pairs = [
+        ['ritual init --verbose', 'what was wired up · paths · key info'],
+        ['ritual doctor', 'verify the MCP connection · diagnose'],
+        ['ritual graph status', 'see what\'s in this workspace'],
+    ];
+    const lines = [
+        `  ${(0, colors_1.dim)('more info — invoke when you want it:')}`,
+        '',
+    ];
+    for (let i = 0; i < pairs.length; i++) {
+        const [cmd, desc] = pairs[i];
+        lines.push(`    ${(0, colors_1.color)(colors_1.RITUAL_TEAL, cmd)}`);
+        lines.push(`    ${(0, colors_1.dim)(desc)}`);
+        if (i < pairs.length - 1)
+            lines.push('');
+    }
+    return lines;
+}
+/**
+ * Build the per-agent restart bullets. Recognizes the agent names
+ * we actually ship for (Claude Code, Cursor, Windsurf, Kiro, etc.)
+ * and uses the documented one-keystroke restart action for each;
+ * falls through to a generic "restart Agent X" for anything we
+ * don't have a specific gesture for.
+ */
+function restartLinesFor(agentNames) {
+    if (agentNames.length === 0) {
+        return ['restart your coding agent so it loads the MCP server'];
+    }
+    return agentNames.map((name) => {
+        switch (name) {
+            case 'Claude Code':
+                return 'Claude Code: exit any session, then run `claude` again';
+            case 'Cursor':
+                return 'Cursor: Cmd-Q, then reopen';
+            case 'Windsurf':
+                return 'Windsurf: restart the app';
+            case 'Kiro':
+                return 'Kiro: restart the app';
+            case 'Gemini CLI':
+                return 'Gemini CLI: start a fresh `gemini` session';
+            case 'VS Code (Copilot)':
+                return 'VS Code: Cmd+Shift+P → "Developer: Reload Window"';
+            case 'Codex':
+                return 'Codex: start a fresh `codex` session';
+            default:
+                return `${name}: restart so it loads the MCP server`;
+        }
+    });
+}
+// ─── shared box / padding helpers ───────────────────────────────────────────
+function boxTop(width, title) {
+    const stripped = stripAnsi(title);
+    const fillWidth = width - stripped.length - 4;
+    return (0, colors_1.color)(colors_1.RITUAL_TEAL, '╭') + ' ' + title + ' ' + (0, colors_1.color)(colors_1.RITUAL_TEAL, '─'.repeat(Math.max(0, fillWidth)) + '╮');
+}
+function boxBottom(width) {
+    // Inner ┴ where the column divider was — same shape as
+    // welcome-banner so the two frames look related.
+    const left = '─'.repeat(LEFT_W);
+    const right = '─'.repeat(Math.max(0, width - LEFT_W - 3));
+    return (0, colors_1.color)(colors_1.RITUAL_TEAL, `╰${left}┴${right}╯`);
+}
+function twoColRow(left, right, divider) {
+    const rightW = W - LEFT_W - 3;
+    return `${divider}${padDisplay(left, LEFT_W)}${divider}${padDisplay(right, rightW)}${divider}`;
+}
+function padDisplay(s, width) {
+    const visLen = stripAnsi(s).length;
+    if (visLen >= width)
+        return s;
+    return s + ' '.repeat(width - visLen);
+}
+function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*m/g, '');
+}
+//# sourceMappingURL=final-cta-box.js.map

package/dist/lib/final-cta-box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-cta-box.js","sourceRoot":"","sources":["../../src/lib/final-cta-box.ts"],"names":[],"mappings":"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"}

package/dist/lib/gitignore-update.js

@@ -42,12 +42,15 @@ const END_MARKER = '# End: ritual init';
 /**
  * Returns the gitignore entry for a single provider — the project
  * skill dir with a trailing slash so git treats it as a directory
- * match.
+ * match. Returns null for MCP-only agents (no projectSkillDir),
+ * which the caller should filter out before assembling the block.
  */
 function entryForProvider(provider) {
     // projectSkillDir is e.g. `.claude/skills` or `.cursor/rules`.
     // We ignore only the `ritual/` SKILL package under it — the
     // user's own custom rules/skills siblings stay tracked.
+    if (!provider.projectSkillDir)
+        return null;
     return `${provider.projectSkillDir}/ritual/`;
 }
 /**
@@ -58,6 +61,7 @@ function entryForProvider(provider) {
 function buildBlock(scaffoldedProviders) {
     const entries = scaffoldedProviders
         .map(entryForProvider)
+        .filter((e) => e !== null)
         // Sort so the block's contents are deterministic regardless of
         // detect()-order changes between releases. Makes diffs in
         // people's `.gitignore` files signal-not-noise.
@@ -103,9 +107,14 @@ function replaceOrAppendBlock(body, newBlock) {
 function updateProjectGitignore(projectRoot, scaffoldedProviders) {
     const gitignorePath = (0, node_path_1.join)(projectRoot, '.gitignore');
     const preExisting = (0, node_fs_1.existsSync)(gitignorePath);
-    const entries = scaffoldedProviders.map(entryForProvider).sort();
-    // No-op fast path: nothing to ignore.
-    if (scaffoldedProviders.length === 0) {
+    const entries = scaffoldedProviders
+        .map(entryForProvider)
+        .filter((e) => e !== null)
+        .sort();
+    // No-op fast path: nothing to ignore (either no providers
+    // scaffolded at all, or all of them are MCP-only with no
+    // project-local skill dir).
+    if (entries.length === 0) {
         return { gitignorePath, preExisting, entries, changed: false };
     }
     const currentBody = preExisting ? (0, node_fs_1.readFileSync)(gitignorePath, 'utf8') : '';

package/dist/lib/gitignore-update.js.map

@@ -1 +1 @@
-{"version":3,"file":"gitignore-update.js","sourceRoot":"","sources":["../../src/lib/gitignore-update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gitignore-update.js","sourceRoot":"","sources":["../../src/lib/gitignore-update.ts"],"names":[],"mappings":"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"}

package/dist/lib/onboarding-state.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Per-machine onboarding state.
+ *
+ * Tracks whether the three FTUE screens (persona picker, workspace
+ * explainer, build-flow explainer) have been shown on this machine.
+ * We want the explainers to teach the mental model ONCE per machine,
+ * not every time someone runs `ritual init` in a new repo — by the
+ * time you're cloning your second project we'd just be in your way.
+ *
+ * Storage shape (`~/.config/ritual/onboarding.json`):
+ *   {
+ *     "version": 1,
+ *     "personaPickedAt": "2026-05-19T20:01:00Z",
+ *     "personaSlug": "backend-services",
+ *     "workspaceExplainerSeenAt": "2026-05-19T20:01:12Z",
+ *     "buildFlowExplainerSeenAt": "2026-05-19T20:01:25Z"
+ *   }
+ *
+ * Each field is optional and additive — we only set it once that
+ * screen has been shown (and, for the picker, confirmed). Missing
+ * fields are treated as "not yet seen". This makes the schema
+ * forward-compatible: adding a screen #4 in a later release just
+ * means a new field that's missing on existing installs.
+ *
+ * Why a separate file from `credentials.json`:
+ *   - We want to be able to reset onboarding (`ritual init
+ *     --re-onboard`) without nuking the user's auth tokens.
+ *   - This file is non-secret — losing it just means we re-onboard
+ *     once, never a security issue. Different blast radius from
+ *     credentials, so different file.
+ *
+ * Why per-MACHINE not per-PROJECT:
+ *   - The persona is a "what kind of work do you do" question, not
+ *     "what kind of work does this repo support". You're the same
+ *     dev across all your repos.
+ *   - The explainers are mental-model teaching — once you've seen
+ *     them, you've seen them.
+ *   - Project-level overrides still work via `.ritual/config.json`
+ *     (the per-project persona override picks up here as fallback
+ *     when the project file doesn't set one explicitly).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readOnboardingState = readOnboardingState;
+exports.updateOnboardingState = updateOnboardingState;
+exports.shouldShowPersonaPicker = shouldShowPersonaPicker;
+exports.shouldShowWorkspaceExplainer = shouldShowWorkspaceExplainer;
+exports.shouldShowBuildFlowExplainer = shouldShowBuildFlowExplainer;
+exports.resetOnboardingState = resetOnboardingState;
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+/** Bump if the on-disk schema changes incompatibly. */
+const CURRENT_VERSION = 1;
+/**
+ * Resolve the onboarding-state file path. Honors `XDG_CONFIG_HOME`
+ * for the same reasons as `config.ts` — Linux dotfile convention +
+ * clean override seam for tests.
+ *
+ * Evaluated lazily on each call so tests can mutate env between
+ * sub-tests without needing to reset the module cache.
+ */
+function onboardingPath() {
+    const xdg = process.env.XDG_CONFIG_HOME;
+    const base = xdg && xdg.length > 0 ? xdg : (0, node_path_1.join)((0, node_os_1.homedir)(), '.config');
+    return (0, node_path_1.join)(base, 'ritual', 'onboarding.json');
+}
+/**
+ * Read the current state. Returns an empty object (with the right
+ * version) when the file doesn't exist or is corrupt — corruption
+ * here is a "show the screens again" outcome, never a hard error,
+ * because the worst case is we onboard the user a second time.
+ */
+function readOnboardingState() {
+    const path = onboardingPath();
+    if (!(0, node_fs_1.existsSync)(path))
+        return { version: CURRENT_VERSION };
+    try {
+        const raw = (0, node_fs_1.readFileSync)(path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== CURRENT_VERSION) {
+            // Future schema bumps land here — for now we treat any
+            // mismatch as "fresh state" rather than try to migrate.
+            return { version: CURRENT_VERSION };
+        }
+        return { ...parsed, version: CURRENT_VERSION };
+    }
+    catch {
+        return { version: CURRENT_VERSION };
+    }
+}
+/**
+ * Merge `patch` into the existing on-disk state and persist. We
+ * always read-then-write rather than blind-overwrite so a partial
+ * patch (e.g. "mark workspace explainer seen") doesn't blow away
+ * unrelated fields (persona pick) written by an earlier screen.
+ */
+function updateOnboardingState(patch) {
+    const current = readOnboardingState();
+    const next = { ...current, ...patch, version: CURRENT_VERSION };
+    persist(next);
+    return next;
+}
+/**
+ * Convenience predicates the init flow uses to decide whether to
+ * render each screen. Centralized here so the gating policy lives
+ * in one place — if we later decide the workspace explainer should
+ * re-show after a year or after a major version bump, we change
+ * the predicate, not every call site.
+ */
+function shouldShowPersonaPicker(state) {
+    return !state.personaPickedAt;
+}
+function shouldShowWorkspaceExplainer(state) {
+    return !state.workspaceExplainerSeenAt;
+}
+function shouldShowBuildFlowExplainer(state) {
+    return !state.buildFlowExplainerSeenAt;
+}
+/**
+ * Wipe the on-disk state. Used by `ritual init --re-onboard` (a
+ * support escape hatch for "I want to see the intro again"). We
+ * write `{}` instead of unlinking so file permissions / SELinux
+ * contexts / Windows ACLs aren't disturbed.
+ */
+function resetOnboardingState() {
+    persist({ version: CURRENT_VERSION });
+}
+// ─── internal ──────────────────────────────────────────────────────────────
+function persist(state) {
+    const path = onboardingPath();
+    const dir = (0, node_path_1.join)(path, '..');
+    if (!(0, node_fs_1.existsSync)(dir))
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    // 0600 on the file so we don't widen access just because the
+    // parent dir is group-readable. Onboarding state isn't secret
+    // but there's no reason to make it world-visible either.
+    (0, node_fs_1.writeFileSync)(path, JSON.stringify(state, null, 2), { encoding: 'utf-8', mode: 0o600 });
+}
+//# sourceMappingURL=onboarding-state.js.map

package/dist/lib/onboarding-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-state.js","sourceRoot":"","sources":["../../src/lib/onboarding-state.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;;AA6CH,kDAeC;AAQD,sDAKC;AASD,0DAEC;AACD,oEAEC;AACD,oEAEC;AAQD,oDAEC;AAlGD,qCAAkC;AAClC,yCAAiC;AACjC,qCAA6E;AAE7E,uDAAuD;AACvD,MAAM,eAAe,GAAG,CAAC,CAAC;AAkB1B;;;;;;;GAOG;AACH,SAAS,cAAc;IACtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACxC,MAAM,IAAI,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,gBAAI,EAAC,IAAA,iBAAO,GAAE,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,IAAA,gBAAI,EAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB;IAClC,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3D,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA6B,CAAC;QAC3D,IAAI,MAAM,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;YACxC,uDAAuD;YACvD,wDAAwD;YACxD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACrC,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,KAA+B;IACpE,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,IAAI,GAAoB,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACjF,OAAO,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,uBAAuB,CAAC,KAAsB;IAC7D,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;AAC/B,CAAC;AACD,SAAgB,4BAA4B,CAAC,KAAsB;IAClE,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC;AACxC,CAAC;AACD,SAAgB,4BAA4B,CAAC,KAAsB;IAClE,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,8EAA8E;AAE9E,SAAS,OAAO,CAAC,KAAsB;IACtC,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAA,oBAAU,EAAC,GAAG,CAAC;QAAE,IAAA,mBAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,6DAA6D;IAC7D,8DAA8D;IAC9D,yDAAyD;IACzD,IAAA,uBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC"}

package/dist/lib/persona-picker.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * Persona picker — onboarding screen #1 of 3.
+ *
+ * Shown once per machine on first `ritual init` (gated by
+ * onboarding-state.ts). Determines two downstream things:
+ *
+ *   1. The default template `/ritual build` will reach for. Persona
+ *      slug equals the template's schema.id, so a user who picks
+ *      "Backend Services" gets the backend-services Engineering
+ *      template by default — they can still override per build.
+ *   2. The accent + framing used in screens #2 and #3 so the whole
+ *      onboarding cohort feels personal.
+ *
+ * UI version (this file): numbered-list with color accents, chip
+ * tags ("APIs · workers · idempotency"), and a "see more" gate so
+ * we surface the 5 most-common personas first and the long tail
+ * only when asked. This is the pragmatic version; an Ink-based
+ * card UI is a polish pass we can layer on later without changing
+ * the contract here.
+ *
+ * Non-TTY fallback: returns `null` immediately. Callers must check
+ * `process.stdin.isTTY` before invoking the interactive version —
+ * see init.ts for the pattern. The seed value can also be supplied
+ * via `--persona <slug>` on the command line for CI bootstrapping.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__test = void 0;
+exports.pickPersona = pickPersona;
+const colors_1 = require("./colors");
+const prompt_1 = require("./prompt");
+const persona_samples_1 = require("./persona-samples");
+/**
+ * Run the persona picker. Returns the picked persona, or `null` if
+ * the user skipped explicitly (entered empty / "skip" / etc).
+ *
+ * Throws on non-TTY stdin (Node's readline doesn't support it). The
+ * caller must gate on `process.stdin.isTTY` first.
+ */
+async function pickPersona(opts = {}) {
+    const featured = orderByFeatured(persona_samples_1.PERSONA_SAMPLES, persona_samples_1.FEATURED_PERSONA_SLUGS);
+    let showingAll = opts.showAll ?? false;
+    let visibleCount = showingAll ? featured.length : Math.min(persona_samples_1.FEATURED_PERSONA_SLUGS.length, featured.length);
+    printHeader();
+    printPersonaList(featured.slice(0, visibleCount));
+    // Initial prompt: number, "more", or skip
+    while (true) {
+        const answer = (await (0, prompt_1.prompt)(formatPickPrompt(visibleCount, showingAll))).trim();
+        if (!answer || answer.toLowerCase() === 'skip') {
+            process.stdout.write('\n' + (0, colors_1.dim)('  no persona set — /ritual build will ask you per exploration.') + '\n\n');
+            return null;
+        }
+        // Allow "more" to expand the list (one-way; once expanded, the
+        // long-tail personas are shown until pick / skip).
+        if (answer.toLowerCase() === 'more' && !showingAll) {
+            const tail = featured.slice(visibleCount);
+            process.stdout.write('\n');
+            printPersonaList(tail, visibleCount);
+            showingAll = true;
+            visibleCount = featured.length;
+            continue;
+        }
+        const idx = parseChoice(answer, featured.length);
+        if (idx === null) {
+            process.stdout.write((0, colors_1.dim)(`  didn't recognize "${answer}" — try a number, "more", or "skip".`) + '\n');
+            continue;
+        }
+        const picked = featured[idx];
+        process.stdout.write('\n  ' +
+            (0, colors_1.boldColor)(picked.accent, `✓ ${picked.label}`) +
+            (0, colors_1.dim)(`  ·  default template for /ritual build`) +
+            '\n\n');
+        return { slug: picked.slug, label: picked.label };
+    }
+}
+// ─── rendering ──────────────────────────────────────────────────────────────
+function printHeader() {
+    const lines = [
+        '',
+        '  ' + (0, colors_1.boldColor)(colors_1.RITUAL_TEAL, 'What kind of code do you work on most?'),
+        '  ' + (0, colors_1.dim)('you can always change this later — it\'s a default, not a lock-in.'),
+        '',
+    ];
+    for (const l of lines)
+        process.stdout.write(l + '\n');
+}
+/**
+ * Render a list of personas as `N) Label   tag · tag · tag`.
+ *
+ * `startIndex` is the 0-based index of the FIRST persona in the slice,
+ * so when we render the long-tail after "more", the numbering continues
+ * from where the featured list left off (6, 7, 8…).
+ */
+function printPersonaList(personas, startIndex = 0) {
+    const numWidth = String(startIndex + personas.length).length;
+    const labelWidth = Math.max(...personas.map((p) => p.label.length));
+    for (let i = 0; i < personas.length; i++) {
+        const p = personas[i];
+        const n = String(startIndex + i + 1).padStart(numWidth, ' ');
+        const label = (0, colors_1.boldColor)(p.accent, p.label.padEnd(labelWidth, ' '));
+        const tags = p.caresAbout.slice(0, 4).join(' · ');
+        process.stdout.write(`  ${(0, colors_1.color)(p.accent, n + ')')} ${label}  ${(0, colors_1.dim)(tags)}\n`);
+    }
+    process.stdout.write('\n');
+}
+function formatPickPrompt(visibleCount, showingAll) {
+    const hint = showingAll
+        ? `pick a number (1-${visibleCount}), or "skip"`
+        : `pick a number (1-${visibleCount}), "more" to see the rest, or "skip"`;
+    return `  ${(0, colors_1.dim)(hint)}\n  ${(0, colors_1.color)(colors_1.RITUAL_TEAL, '›')} `;
+}
+// ─── helpers ────────────────────────────────────────────────────────────────
+/**
+ * Reorder `samples` so the featured slugs come first (in the order
+ * given by `featuredSlugs`) and the rest follow in their natural
+ * order. Defensive against missing slugs — if a featured slug has no
+ * matching sample, we just skip it.
+ */
+function orderByFeatured(samples, featuredSlugs) {
+    const bySlug = new Map(samples.map((s) => [s.slug, s]));
+    const featured = [];
+    for (const slug of featuredSlugs) {
+        const s = bySlug.get(slug);
+        if (s)
+            featured.push(s);
+    }
+    const tail = samples.filter((s) => !featuredSlugs.includes(s.slug));
+    return [...featured, ...tail];
+}
+/**
+ * Parse a user's text answer into a 0-based index into the full
+ * persona list. Returns null if the answer doesn't resolve. We
+ * accept 1-based numbers (matching the rendered list) and a tiny
+ * set of label aliases — "backend", "frontend" — for hand-typers.
+ *
+ * Exported (alongside `orderByFeatured`) under `__test` so the spec
+ * can exercise parsing without spinning up readline. Not part of the
+ * public API; treat the underscore prefix as the contract.
+ */
+function parseChoice(answer, listLength) {
+    const trimmed = answer.trim().toLowerCase();
+    // Empty input is never a match — defense-in-depth even though
+    // the caller short-circuits "" as "skip". Without this, the
+    // substring loop below would resolve "" against every label.
+    if (!trimmed)
+        return null;
+    const asNumber = Number(trimmed);
+    if (Number.isInteger(asNumber) && asNumber >= 1 && asNumber <= listLength) {
+        return asNumber - 1;
+    }
+    // Word aliases — substring match against label or shortLabel. We
+    // keep this loose because the picker isn't latency-sensitive and
+    // it's friendlier than rejecting "frontend" because the label is
+    // "Frontend Web".
+    for (let i = 0; i < persona_samples_1.PERSONA_SAMPLES.length; i++) {
+        const p = persona_samples_1.PERSONA_SAMPLES[i];
+        if (trimmed === p.slug ||
+            p.label.toLowerCase().includes(trimmed) ||
+            p.shortLabel.toLowerCase() === trimmed) {
+            return i;
+        }
+    }
+    return null;
+}
+/**
+ * Test seam — internal pure helpers exported solely for unit
+ * coverage. Do not consume from non-spec code; the underscore
+ * prefix is the contract.
+ */
+exports.__test = { parseChoice, orderByFeatured };
+//# sourceMappingURL=persona-picker.js.map

package/dist/lib/persona-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-picker.js","sourceRoot":"","sources":["../../src/lib/persona-picker.ts"],"names":[],"mappings":"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"}