@ritualai/cli 0.25.0 → 0.36.8

package/dist/lib/build-flow-explainer.js

@@ -1,226 +0,0 @@
-"use strict";
-/**
- * Build-flow explainer — onboarding screen #3 of 3.
- *
- * Shown once per machine on first `ritual init` (gated by
- * onboarding-state.ts), AFTER the persona picker and workspace
- * explainer. Teaches the user the end-to-end shape of /ritual build:
- *
- *   1. Ritual zone (5 phases): problem scope → discovery →
- *      agentic run → explainable recommendations → build brief
- *   2. Handover: the build brief becomes the input for the user's
- *      coding agent. This is the most important conceptual beat —
- *      it's where Ritual ends and the user's familiar tools resume.
- *   3. Coding-agent zone: whichever agents we detected on this
- *      machine (Claude Code / Cursor / Copilot / etc.) consume the
- *      brief. Empty list → render the "any coding agent" pill.
- *   4. PR zone: what lands in the PR thanks to having gone through
- *      the flow (code + rationale + decisions + tests).
- *   5. Close-the-loop: `/ritual sync` feeds the PR outcome back into
- *      the workspace knowledge graph so the next exploration starts
- *      with the prior implementation already accounted for.
- *
- * Vocabulary (locked 2026-05-19):
- *   - problem scope, discovery, agentic run, explainable
- *     recommendations, build brief, handover, coding agent,
- *     pull request, /ritual sync, workspace knowledge graph
- *   - Header: "from prompt to PR, without context drift"
- *   - Footer: "planning inherits validated context · no copy-paste"
- *
- * Non-TTY fallback: terse multi-line summary via
- * printBuildFlowExplainerTerse(). Caller checks tty + onboarding
- * state before invoking the rich version.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.printBuildFlowExplainer = printBuildFlowExplainer;
-exports.printBuildFlowExplainerTerse = printBuildFlowExplainerTerse;
-const colors_1 = require("./colors");
-const persona_samples_1 = require("./persona-samples");
-/** Width target. Matches welcome-banner + workspace-explainer. */
-const BOX_WIDTH = 78;
-/** Accent used for the handover divider + coding-agent zone. The
- *  contrast against the persona accent is what makes the handover
- *  visually legible: Ritual zone in persona color, agent zone in
- *  amber, PR zone in green. Tuned to read on dark + light themes. */
-const HANDOVER_AMBER = [0xe0, 0xa8, 0x4f];
-const PR_GREEN = [0x60, 0xc7, 0x70];
-/**
- * Render the build-flow explainer to stdout. Always renders (caller
- * decides whether to skip based on TTY + onboarding-state).
- *
- * Rich version assumes ≥80-char terminal width. For narrower
- * terminals, callers should prefer printBuildFlowExplainerTerse().
- */
-function printBuildFlowExplainer(opts) {
-    const persona = (0, persona_samples_1.findPersona)(opts.personaSlug) ?? persona_samples_1.GENERIC_PERSONA;
-    const accent = persona.accent;
-    const lines = [];
-    // Title bar
-    lines.push(box.top(BOX_WIDTH, (0, colors_1.color)(accent, '─ /ritual build ─ from prompt to PR, without context drift ')));
-    lines.push(box.padded(BOX_WIDTH, ''));
-    // ─── Zone 1: Ritual phases ─────────────────────────────────────────
-    lines.push(box.padded(BOX_WIDTH, `  ${(0, colors_1.boldColor)(accent, 'ritual — plan with context')}`));
-    lines.push(box.padded(BOX_WIDTH, ''));
-    for (const row of renderPhaseChain(accent)) {
-        lines.push(box.padded(BOX_WIDTH, '  ' + row));
-    }
-    lines.push(box.padded(BOX_WIDTH, ''));
-    // ─── Zone 2: Handover ──────────────────────────────────────────────
-    lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.color)(HANDOVER_AMBER, '↓ handover — the build brief becomes the input prompt')));
-    lines.push(box.padded(BOX_WIDTH, ''));
-    // ─── Zone 3: Coding-agent zone ─────────────────────────────────────
-    lines.push(box.padded(BOX_WIDTH, `  ${(0, colors_1.boldColor)(HANDOVER_AMBER, 'your coding agent — implement with that context')}`));
-    lines.push(box.padded(BOX_WIDTH, ''));
-    for (const row of renderAgentZone(opts.detectedAgents)) {
-        lines.push(box.padded(BOX_WIDTH, '  ' + row));
-    }
-    lines.push(box.padded(BOX_WIDTH, ''));
-    // ─── Zone 4: PR contents ───────────────────────────────────────────
-    lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.color)(PR_GREEN, '↓ ships as a pull request that carries the why, not just the what')));
-    lines.push(box.padded(BOX_WIDTH, ''));
-    for (const row of renderPrZone()) {
-        lines.push(box.padded(BOX_WIDTH, '  ' + row));
-    }
-    lines.push(box.padded(BOX_WIDTH, ''));
-    // ─── Zone 5: Close the loop ────────────────────────────────────────
-    lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.color)(colors_1.RITUAL_TEAL, '↺ /ritual sync — feed the PR back into the workspace knowledge graph')));
-    lines.push(box.padded(BOX_WIDTH, `      ${(0, colors_1.dim)('next exploration starts with this implementation already in context')}`));
-    lines.push(box.padded(BOX_WIDTH, ''));
-    // Footer slogan
-    lines.push(box.padded(BOX_WIDTH, `  ${(0, colors_1.dim)('planning inherits validated context · no copy-paste')}`));
-    lines.push(box.padded(BOX_WIDTH, ''));
-    lines.push(box.bottom(BOX_WIDTH));
-    for (const line of lines) {
-        process.stdout.write(line + '\n');
-    }
-}
-/**
- * Terse fallback for non-TTY or narrow terminals. No colors, no
- * boxes — just the teaching, in linear form.
- */
-function printBuildFlowExplainerTerse(opts) {
-    const agentList = opts.detectedAgents.length > 0
-        ? opts.detectedAgents.join(', ')
-        : 'your coding agent';
-    process.stdout.write('\n  /ritual build — from prompt to PR, without context drift\n\n');
-    process.stdout.write('  Plan (Ritual):\n');
-    process.stdout.write('    problem scope → discovery → agentic run → recommendations → build brief\n');
-    process.stdout.write('\n');
-    process.stdout.write(`  Handover: the build brief becomes the input prompt for ${agentList}.\n`);
-    process.stdout.write('\n');
-    process.stdout.write('  PR includes: the code change, the rationale, decisions, anti-goals, tests.\n');
-    process.stdout.write('\n');
-    process.stdout.write('  /ritual sync — feed the PR back into the workspace knowledge graph,\n');
-    process.stdout.write('  so the next exploration starts with this implementation in context.\n');
-    process.stdout.write('\n');
-    process.stdout.write('  planning inherits validated context · no copy-paste\n');
-    process.stdout.write('\n');
-}
-// ─── helpers ────────────────────────────────────────────────────────────────
-/**
- * The 5 Ritual phases rendered as a chain of pill-shaped chips with
- * arrows between them. Fits in a single row at BOX_WIDTH-4 = 74 cols.
- *
- * Phase widths are tuned so the row totals to <= 74 chars including
- * separators. If you add a phase, re-measure or wrap onto two rows.
- */
-function renderPhaseChain(accent) {
-    // Each phase rendered as a chip. The full 5-chip chain is ~91
-    // chars visible — too wide for the 74-char inner budget — so we
-    // wrap it onto 2 rows. Row 1: scope → discovery → agentic-run.
-    // Row 2: → recommendations → build-brief. The leading-arrow on
-    // row 2 makes the continuation read naturally.
-    const phases = [
-        'problem scope',
-        'discovery',
-        'agentic run',
-        'recommendations',
-        'build brief',
-    ];
-    const descriptors = [
-        'what + why',
-        'open questions',
-        'parallel answers',
-        'with rationale',
-        'code-ready',
-    ];
-    const chip = (p) => (0, colors_1.color)(accent, `( ${p} )`);
-    const arrow = (0, colors_1.dim)(' → ');
-    const row1 = [chip(phases[0]), chip(phases[1]), chip(phases[2])].join(arrow);
-    const row2 = '  ' + arrow + [chip(phases[3]), chip(phases[4])].join(arrow);
-    // Descriptor block — one phase per line so we don't have to
-    // column-align under the (variable-width) chips. Reads as a
-    // glossary block under the chain.
-    const descriptorLines = phases.map((p, i) => (0, colors_1.dim)(`  · ${p}: ${descriptors[i]}`));
-    return [row1, row2, '', ...descriptorLines];
-}
-/**
- * The coding-agent zone. If we detected agents, render their names
- * as chips; otherwise render a single generic pill.
- */
-function renderAgentZone(detected) {
-    if (detected.length === 0) {
-        return [
-            (0, colors_1.color)(HANDOVER_AMBER, '( any coding agent )') +
-                (0, colors_1.dim)('  ←  no agent detected on this machine yet — that\'s fine'),
-        ];
-    }
-    // Up to 4 chips on the first line; overflow chips wrap to a second
-    // line. Tuned for the common 1-2 agent case (Claude Code + Cursor).
-    const chips = detected.map((name) => (0, colors_1.color)(HANDOVER_AMBER, `( ${name} )`));
-    const lines = [];
-    let current = '';
-    const sep = (0, colors_1.dim)('  ');
-    for (const chip of chips) {
-        const candidate = current ? current + sep + chip : chip;
-        if (visibleLength(candidate) > BOX_WIDTH - 8 && current) {
-            lines.push(current);
-            current = chip;
-        }
-        else {
-            current = candidate;
-        }
-    }
-    if (current)
-        lines.push(current);
-    lines.push((0, colors_1.dim)('each consumes the build brief — uses it as the input prompt to implement'));
-    return lines;
-}
-/** What the resulting pull request carries — the value of the flow. */
-function renderPrZone() {
-    return [
-        (0, colors_1.color)(PR_GREEN, '( pull request )'),
-        (0, colors_1.dim)('  ✓ the code change'),
-        (0, colors_1.dim)('  ✓ the rationale — which recommendation, which decisions'),
-        (0, colors_1.dim)('  ✓ the anti-goals you set (so reviewers see what was out of scope)'),
-        (0, colors_1.dim)('  ✓ links back to the exploration so the why is one click away'),
-    ];
-}
-// ─── shared box / text utilities ────────────────────────────────────────────
-const box = {
-    top(width, title) {
-        const stripped = stripAnsi(title);
-        const fillWidth = width - stripped.length - 4;
-        return `╭ ${title} ${'─'.repeat(Math.max(0, fillWidth))}╮`;
-    },
-    bottom(width) {
-        return '╰' + '─'.repeat(width - 2) + '╯';
-    },
-    padded(width, content) {
-        const stripped = stripAnsi(content);
-        const pad = ' '.repeat(Math.max(0, width - 2 - stripped.length));
-        return `│${content}${pad}│`;
-    },
-};
-/** Strip ANSI escape sequences so padding math is correct. */
-function stripAnsi(s) {
-    // eslint-disable-next-line no-control-regex
-    return s.replace(/\x1b\[[0-9;]*m/g, '');
-}
-/** Visible length = char count after stripping ANSI. Used by the
- *  coding-agent zone's chip-wrapping (avoids overflowing a row of
- *  detected agents past BOX_WIDTH-8). */
-function visibleLength(s) {
-    return stripAnsi(s).length;
-}
-//# sourceMappingURL=build-flow-explainer.js.map

package/dist/lib/build-flow-explainer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-flow-explainer.js","sourceRoot":"","sources":["../../src/lib/build-flow-explainer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;AAkCH,0DAqDC;AAMD,oEAkBC;AA7GD,qCAA8D;AAC9D,uDAAiE;AAcjE,kEAAkE;AAClE,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB;;;qEAGqE;AACrE,MAAM,cAAc,GAA6B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACpE,MAAM,QAAQ,GAA6B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,SAAgB,uBAAuB,CAAC,IAA+B;IACtE,MAAM,OAAO,GAAG,IAAA,6BAAW,EAAC,IAAI,CAAC,WAAW,CAAC,IAAI,iCAAe,CAAC;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,YAAY;IACZ,KAAK,CAAC,IAAI,CACT,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAA,cAAK,EAAC,MAAM,EAAE,6DAA6D,CAAC,CAAC,CAChG,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtC,sEAAsE;IACtE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,IAAA,kBAAS,EAAC,MAAM,EAAE,4BAA4B,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1F,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtC,sEAAsE;IACtE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,IAAA,cAAK,EAAC,cAAc,EAAE,uDAAuD,CAAC,CAAC,CAAC,CAAC;IACzH,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtC,sEAAsE;IACtE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,IAAA,kBAAS,EAAC,cAAc,EAAE,iDAAiD,CAAC,EAAE,CAAC,CAAC,CAAC;IACvH,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtC,sEAAsE;IACtE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,IAAA,cAAK,EAAC,QAAQ,EAAE,mEAAmE,CAAC,CAAC,CAAC,CAAC;IAC/H,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtC,sEAAsE;IACtE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,IAAA,cAAK,EAAC,oBAAW,EAAE,sEAAsE,CAAC,CAAC,CAAC,CAAC;IACrI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,IAAA,YAAG,EAAC,qEAAqE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzH,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtC,gBAAgB;IAChB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,IAAA,YAAG,EAAC,qDAAqD,CAAC,EAAE,CAAC,CAAC,CAAC;IACrG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,SAAgB,4BAA4B,CAAC,IAA+B;IAC3E,MAAM,SAAS,GACd,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,CAAC,CAAC,mBAAmB,CAAC;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACzF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACtG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4DAA4D,SAAS,KAAK,CAAC,CAAC;IACjG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACvG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAChG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAChG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAChF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,MAAgC;IACzD,8DAA8D;IAC9D,gEAAgE;IAChE,+DAA+D;IAC/D,+DAA+D;IAC/D,+CAA+C;IAC/C,MAAM,MAAM,GAAG;QACd,eAAe;QACf,WAAW;QACX,aAAa;QACb,iBAAiB;QACjB,aAAa;KACb,CAAC;IACF,MAAM,WAAW,GAAG;QACnB,YAAY;QACZ,gBAAgB;QAChB,kBAAkB;QAClB,gBAAgB;QAChB,YAAY;KACZ,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAA,cAAK,EAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAA,YAAG,EAAC,KAAK,CAAC,CAAC;IAEzB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE3E,4DAA4D;IAC5D,4DAA4D;IAC5D,kCAAkC;IAClC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CACjC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAA,YAAG,EAAC,OAAO,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5C,CAAC;IAEF,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,QAAkB;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACN,IAAA,cAAK,EAAC,cAAc,EAAE,sBAAsB,CAAC;gBAC5C,IAAA,YAAG,EAAC,2DAA2D,CAAC;SACjE,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,oEAAoE;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,cAAK,EAAC,cAAc,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,GAAG,GAAG,IAAA,YAAG,EAAC,IAAI,CAAC,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,IAAI,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,CAAC;YACP,OAAO,GAAG,SAAS,CAAC;QACrB,CAAC;IACF,CAAC;IACD,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CACT,IAAA,YAAG,EAAC,0EAA0E,CAAC,CAC/E,CAAC;IACF,OAAO,KAAK,CAAC;AACd,CAAC;AAED,uEAAuE;AACvE,SAAS,YAAY;IACpB,OAAO;QACN,IAAA,cAAK,EAAC,QAAQ,EAAE,kBAAkB,CAAC;QACnC,IAAA,YAAG,EAAC,qBAAqB,CAAC;QAC1B,IAAA,YAAG,EAAC,2DAA2D,CAAC;QAChE,IAAA,YAAG,EAAC,qEAAqE,CAAC;QAC1E,IAAA,YAAG,EAAC,gEAAgE,CAAC;KACrE,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E,MAAM,GAAG,GAAG;IACX,GAAG,CAAC,KAAa,EAAE,KAAa;QAC/B,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC;IAC5D,CAAC;IACD,MAAM,CAAC,KAAa;QACnB,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAC1C,CAAC;IACD,MAAM,CAAC,KAAa,EAAE,OAAe;QACpC,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,OAAO,IAAI,OAAO,GAAG,GAAG,GAAG,CAAC;IAC7B,CAAC;CACD,CAAC;AAEF,8DAA8D;AAC9D,SAAS,SAAS,CAAC,CAAS;IAC3B,4CAA4C;IAC5C,OAAO,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;yCAEyC;AACzC,SAAS,aAAa,CAAC,CAAS;IAC/B,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5B,CAAC"}

package/dist/lib/persona-picker.js

@@ -1,171 +0,0 @@
-"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

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