@ritualai/cli 0.36.11 → 0.36.14

package/dist/commands/lite.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liteCommand = liteCommand;
+const node_child_process_1 = require("node:child_process");
+const colors_1 = require("../lib/colors");
+const launch_1 = require("../lib/agents/launch");
+const onboarding_state_1 = require("../lib/onboarding-state");
+const prompt_1 = require("../lib/prompt");
+const worktree_1 = require("../lib/worktree");
+function repoRoot() {
+    try {
+        return (0, node_child_process_1.execSync)('git rev-parse --show-toplevel', { stdio: 'pipe', encoding: 'utf8' }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+async function liteCommand(askParts, opts) {
+    const ask = (askParts ?? []).join(' ').trim();
+    const launchable = (0, launch_1.resolveLaunchableAgents)();
+    if (launchable.length === 0) {
+        console.log('');
+        console.log(`  ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, 'The Ritual lite flow runs inside your coding agent.')}`);
+        console.log('  No terminal coding agent found (claude / agent / gemini / codex).');
+        console.log('  Install one, then re-run — or `ritual init` to wire up everything first.');
+        console.log('');
+        return;
+    }
+    const picked = await pickAgent(launchable, opts.agent);
+    if (!picked)
+        return;
+    // ── autonomous discovery worktree ─────────────────────────────────────
+    if (opts.worktree) {
+        if (!ask) {
+            console.error('  ✗ `ritual lite --worktree` needs an ask: ritual lite "<feature>" --worktree');
+            process.exitCode = 1;
+            return;
+        }
+        const root = repoRoot();
+        if (!root) {
+            console.error('  ✗ Not a git repo — a discovery worktree needs one. Run from inside the repo.');
+            process.exitCode = 1;
+            return;
+        }
+        const wt = (0, worktree_1.createDiscoveryWorktree)(root, ask);
+        if (!wt.ok) {
+            console.error(`  ✗ Couldn't create the discovery worktree: ${wt.error}`);
+            process.exitCode = 1;
+            return;
+        }
+        console.log('');
+        console.log(`  ${(0, colors_1.dim)('Discovery worktree')} ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, wt.branch)} ${(0, colors_1.dim)('→')} ${(0, colors_1.dim)(wt.worktreePath)}`);
+        console.log(`  ${(0, colors_1.dim)('Running')} ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, picked.name)} ${(0, colors_1.dim)('autonomously to a build brief — no code, agent-authored.')}`);
+        console.log('');
+        process.exitCode = (0, launch_1.launchAgent)(picked, `/ritual lite --worktree ${ask}`, {
+            cwd: wt.worktreePath,
+            headless: true,
+        });
+        return;
+    }
+    // ── normal (attended) lite ────────────────────────────────────────────
+    console.log('');
+    console.log(`  ${(0, colors_1.dim)('Launching')} ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, picked.name)} ${(0, colors_1.dim)('— the Ritual lite flow takes it from here.')}`);
+    console.log('');
+    process.exitCode = (0, launch_1.launchAgent)(picked, ask ? `/ritual lite ${ask}` : '/ritual lite');
+}
+async function pickAgent(launchable, forced) {
+    if (forced) {
+        const found = launchable.find((l) => l.providerId === forced);
+        if (!found) {
+            console.error(`  ✗ Agent "${forced}" isn't launchable from this shell.`);
+            console.error(`    Launchable here: ${launchable.map((l) => l.providerId).join(', ')}`);
+            process.exitCode = 1;
+            return null;
+        }
+        return found;
+    }
+    if (launchable.length === 1)
+        return launchable[0];
+    const state = (0, onboarding_state_1.readOnboardingState)();
+    const remembered = launchable.find((l) => l.providerId === state.preferredBuildAgent);
+    if (remembered)
+        return remembered;
+    if (!process.stdin.isTTY)
+        return launchable[0];
+    console.log('');
+    launchable.forEach((l, i) => console.log(`    ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, `${i + 1}. ${l.name}`)}`));
+    console.log('');
+    let answer;
+    try {
+        answer = await (0, prompt_1.prompt)(`  ${(0, colors_1.color)(colors_1.RITUAL_TEAL, '›')} press Enter to use ${launchable[0].name} — or pick a number: `);
+    }
+    catch {
+        console.log('\n  Cancelled.');
+        return null;
+    }
+    const n = Number.parseInt(answer.trim(), 10);
+    const chosen = Number.isInteger(n) && n >= 1 && n <= launchable.length ? launchable[n - 1] : launchable[0];
+    (0, onboarding_state_1.updateOnboardingState)({ preferredBuildAgent: chosen.providerId });
+    return chosen;
+}
+//# sourceMappingURL=lite.js.map

package/dist/commands/lite.js.map

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

package/dist/commands/project.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectCommand = projectCommand;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+const api_client_1 = require("../lib/api-client");
+const config_1 = require("../lib/config");
+const colors_1 = require("../lib/colors");
+const okf_projection_1 = require("../lib/okf-projection");
+function repoRoot() {
+    try {
+        return (0, node_child_process_1.execSync)('git rev-parse --show-toplevel', { stdio: 'pipe', encoding: 'utf8' }).trim();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+async function projectCommand(explorationId, opts) {
+    if (!explorationId) {
+        console.error('  ✗ Usage: ritual project <exploration-id> [--out <dir>]');
+        process.exitCode = 1;
+        return;
+    }
+    const token = await (0, config_1.getValidAccessToken)();
+    if (token.kind === 'not-signed-in') {
+        console.error('  ✗ Not signed in. Run `ritual login` first.');
+        process.exitCode = 1;
+        return;
+    }
+    if (token.kind === 're-auth-required') {
+        console.error(`  ✗ Session expired (${token.reason}). Run \`ritual login\` to re-auth.`);
+        process.exitCode = 1;
+        return;
+    }
+    const api = new api_client_1.ApiClient({ issuer: token.creds.issuer, accessToken: token.accessToken });
+    const id = encodeURIComponent(explorationId);
+    let exploration;
+    let briefContent = null;
+    let scopeContract = null;
+    let recommendations = [];
+    try {
+        exploration = await api.get(`/explorations/${id}/status`);
+    }
+    catch (err) {
+        console.error(`  ✗ Couldn't load exploration ${explorationId}: ${err.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    // Brief + scope contract (best-effort — a brief may not exist yet).
+    try {
+        const brief = await api.get(`/explorations/${id}/build-brief`);
+        briefContent = brief?.content ?? null;
+        scopeContract = brief?.scopeContractResolved ?? null;
+    }
+    catch {
+        /* no brief yet — projection still writes identity + recs */
+    }
+    // Recommendations (best-effort).
+    try {
+        recommendations = (await api.get(`/explorations/${id}/recommendations`)) ?? [];
+    }
+    catch {
+        recommendations = [];
+    }
+    const outDir = node_path_1.default.resolve(opts.out ?? node_path_1.default.join(repoRoot(), '.ritual'));
+    const data = {
+        exploration,
+        briefContent,
+        scopeContract,
+        recommendations,
+        generatedAt: new Date().toISOString(),
+    };
+    const written = (0, okf_projection_1.writeOkfProjection)(outDir, data);
+    console.log('');
+    console.log(`  ${(0, colors_1.dim)('Projected')} ${(0, colors_1.boldColor)(colors_1.RITUAL_TEAL, exploration.name ?? explorationId)} ${(0, colors_1.dim)('→')} ${(0, colors_1.dim)(outDir)}`);
+    written.forEach((f) => console.log(`    ${(0, colors_1.dim)('·')} .ritual/${f}`));
+    console.log('');
+}
+//# sourceMappingURL=project.js.map

package/dist/commands/project.js.map

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

package/dist/index.js

@@ -9,6 +9,8 @@ const whoami_1 = require("./commands/whoami");
 const refresh_1 = require("./commands/refresh");
 const init_1 = require("./commands/init");
 const build_1 = require("./commands/build");
+const lite_1 = require("./commands/lite");
+const project_1 = require("./commands/project");
 const doctor_1 = require("./commands/doctor");
 const uninstall_1 = require("./commands/uninstall");
 // 2026-05-15 (PR D) — `ritual status [--watch]` instant snapshot of
@@ -99,6 +101,25 @@ program
     .option('--agent <id>', 'Launch a specific agent (claude-code, cursor, gemini, codex)')
     .addHelpText('after', () => (0, help_style_1.ritualBuildExamplesHelp)())
     .action(build_1.buildCommand);
+// `ritual lite "<ask>" [--worktree]` — the fast / unattended counterpart.
+// Plain: launches the agent with `/ritual lite <ask>` (fewer pauses).
+// `--worktree`: spins a git worktree and runs `/ritual lite --worktree` HEADLESS
+// in it — the autonomous discovery worktree (runs to a build brief, no code).
+program
+    .command('lite [ask...]')
+    .description('Start a Ritual lite build (fewer pauses); --worktree runs autonomous discovery in a git worktree')
+    .option('--agent <id>', 'Launch a specific agent (claude-code, cursor, gemini, codex)')
+    .option('--worktree', 'Spin a git worktree and run autonomous discovery (to a build brief, no code) headless in it')
+    .action(lite_1.liteCommand);
+// `ritual project <exploration-id>` — materialize an exploration's reasoning
+// from the live graph into a `.ritual/` OKF projection (index + build-brief +
+// scope-contract + recommendations + log). The discovery worktree calls this
+// after the brief so the developer reads the reasoning as files on landing.
+program
+    .command('project <exploration-id>')
+    .description('Project an exploration’s reasoning into a local .ritual/ tree (build brief, scope contract, recommendations)')
+    .option('--out <dir>', 'Output directory (default: <repo>/.ritual)')
+    .action(project_1.projectCommand);
 const loginCmd = program
     .command('login')
     .description('Authenticate with Ritual via your browser')

package/dist/index.js.map

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

package/dist/lib/agents/launch.js

@@ -10,12 +10,14 @@ exports.AGENT_LAUNCHERS = [
         name: 'Claude Code',
         bins: ['claude'],
         args: (prompt) => [prompt],
+        headlessArgs: (prompt) => ['-p', prompt],
     },
     {
         providerId: 'cursor',
         name: 'Cursor CLI',
         bins: ['agent', 'cursor-agent'],
         args: (prompt) => [prompt],
+        headlessArgs: (prompt) => ['-p', prompt],
     },
     {
         providerId: 'gemini',
@@ -24,12 +26,14 @@ exports.AGENT_LAUNCHERS = [
         // -i / --prompt-interactive: start interactive WITH the prompt.
         // A bare positional prompt would run headless and exit.
         args: (prompt) => ['-i', prompt],
+        headlessArgs: (prompt) => [prompt],
     },
     {
         providerId: 'codex',
         name: 'Codex CLI',
         bins: ['codex'],
         args: (prompt) => [prompt],
+        headlessArgs: (prompt) => ['exec', prompt],
     },
 ];
 /** Providers we detect but cannot launch from a shell (IDE surfaces). */
@@ -55,16 +59,28 @@ function resolveLaunchableAgents() {
     for (const l of exports.AGENT_LAUNCHERS) {
         const bin = l.bins.find(binOnPath);
         if (bin)
-            out.push({ providerId: l.providerId, name: l.name, bin, args: l.args });
+            out.push({
+                providerId: l.providerId,
+                name: l.name,
+                bin,
+                args: l.args,
+                headlessArgs: l.headlessArgs,
+            });
     }
     return out;
 }
 /**
- * Spawn the agent interactively with the Ritual flow preloaded. stdio is
- * inherited — the agent takes over the terminal; we return its exit code.
+ * Spawn the agent with the Ritual flow preloaded. Interactive by default
+ * (stdio inherited — the agent takes over the terminal); `headless: true` runs
+ * it unattended to completion. `cwd` runs it in a different directory (a
+ * discovery worktree). Returns its exit code.
  */
-function launchAgent(agent, prompt) {
-    const result = (0, node_child_process_1.spawnSync)(agent.bin, agent.args(prompt), { stdio: 'inherit' });
+function launchAgent(agent, prompt, opts = {}) {
+    const argv = opts.headless ? agent.headlessArgs(prompt) : agent.args(prompt);
+    const result = (0, node_child_process_1.spawnSync)(agent.bin, argv, {
+        stdio: 'inherit',
+        ...(opts.cwd ? { cwd: opts.cwd } : {}),
+    });
     return result.status ?? 0;
 }
 //# sourceMappingURL=launch.js.map

package/dist/lib/agents/launch.js.map

@@ -1 +1 @@
-{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../src/lib/agents/launch.ts"],"names":[],"mappings":";;;AAmGA,0DAOC;AAMD,kCAGC;AAnHD,2DAAyD;AA2C5C,QAAA,eAAe,GAAoB;IAC/C;QACC,UAAU,EAAE,aAAa;QACzB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;KAC1B;IACD;QACC,UAAU,EAAE,QAAQ;QACpB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC;QAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;KAC1B;IACD;QACC,UAAU,EAAE,QAAQ;QACpB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,gEAAgE;QAChE,wDAAwD;QACxD,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;KAChC;IACD;QACC,UAAU,EAAE,OAAO;QACnB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,CAAC,OAAO,CAAC;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;KAC1B;CACD,CAAC;AAEF,yEAAyE;AAC5D,QAAA,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAU1E,SAAS,SAAS,CAAC,GAAW;IAC7B,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC/D,IAAA,6BAAQ,EAAC,GAAG,KAAK,IAAI,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB;IACtC,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,uBAAe,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,GAAG;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAsB,EAAE,MAAc;IACjE,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../src/lib/agents/launch.ts"],"names":[],"mappings":"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"}

package/dist/lib/okf-projection.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderIndex = renderIndex;
+exports.renderScopeContract = renderScopeContract;
+exports.renderBuildBrief = renderBuildBrief;
+exports.renderRecommendation = renderRecommendation;
+exports.renderLog = renderLog;
+exports.writeOkfProjection = writeOkfProjection;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const DO_NOT_EDIT = '<!-- GENERATED projection of the Ritual graph — DO NOT EDIT. Authoritative for portable context + identity; the live graph (ritual status / MCP) is authoritative for CURRENT state. Regenerate: ritual project <exploration-id>. -->';
+function autonomyBanner(e) {
+    return e.autonomousDiscovery
+        ? '> ⚠ **Autonomously discovered** — the answers behind this were agent-authored and **not human-reviewed**. Read with appropriate skepticism; you are the author of any code.\n'
+        : '';
+}
+function scopeSection(title, items) {
+    if (!items || items.length === 0)
+        return `## ${title}\n\n_(none)_\n`;
+    const lines = items.map((i) => `- ${(i.text ?? '').trim()}${i.id ? ` <sub>\`${i.id}\`</sub>` : ''}`);
+    return `## ${title}\n\n${lines.join('\n')}\n`;
+}
+function renderIndex(d) {
+    const e = d.exploration;
+    return [
+        DO_NOT_EDIT,
+        '',
+        `# ${e.name ?? 'Exploration'}`,
+        '',
+        autonomyBanner(e),
+        `- **Exploration:** \`${e.id ?? ''}\``,
+        `- **Job to be done:** ${e.workItemLabel ?? e.jtbd ?? '(unknown)'}`,
+        `- **Spawned via:** ${e.spawnOrigin ?? 'direct'}`,
+        `- **Recommendations:** ${e.recommendationCount ?? d.recommendations?.length ?? 0}`,
+        `- **Projected at:** ${d.generatedAt}`,
+        '',
+        '## Files',
+        '- [`build-brief.md`](./build-brief.md) — the implementation brief',
+        '- [`scope-contract.md`](./scope-contract.md) — in-scope / deferred / anti-goals',
+        '- [`recommendations/`](./recommendations) — the recommendations + reasoning',
+        '',
+        'Run `ritual status` (or the Ritual MCP) for live state — these files are a snapshot.',
+        '',
+    ].join('\n');
+}
+function renderScopeContract(d) {
+    const s = d.scopeContract ?? {};
+    return [
+        DO_NOT_EDIT,
+        '',
+        '# Scope contract (frozen)',
+        '',
+        scopeSection('In scope', s.inScope),
+        scopeSection('Discovery gates (resolve before/within the build)', s.discoveryGates),
+        scopeSection('Deferred (do NOT implement)', s.deferred),
+        scopeSection('Anti-goals (must NOT cross)', s.antiGoals),
+    ].join('\n');
+}
+function renderBuildBrief(d) {
+    const body = (d.briefContent ?? '').trim();
+    return [
+        DO_NOT_EDIT,
+        '',
+        autonomyBanner(d.exploration),
+        body || '_Build brief not available yet._',
+        '',
+    ].join('\n');
+}
+function renderRecommendation(r) {
+    return [
+        DO_NOT_EDIT,
+        '',
+        `# ${r.title ?? 'Recommendation'}`,
+        '',
+        `- **Status:** ${r.status ?? 'unknown'}`,
+        r.id ? `- **Id:** \`${r.id}\`` : '',
+        '',
+        (r.summary ?? r.content ?? '').trim() || '_(no summary)_',
+        '',
+    ]
+        .filter((l) => l !== '')
+        .join('\n');
+}
+function renderLog(d) {
+    return [
+        DO_NOT_EDIT,
+        '',
+        '# Log',
+        '',
+        `- ${d.generatedAt} — projected exploration \`${d.exploration.id ?? ''}\` into .ritual/ (ritual project).`,
+        '',
+    ].join('\n');
+}
+/** Filesystem-safe id for a per-rec filename. */
+function recFile(r, i) {
+    const id = (r.id ?? `rec-${i + 1}`).replace(/[^a-zA-Z0-9_-]/g, '');
+    return `${id || `rec-${i + 1}`}.md`;
+}
+/** Write the full `.ritual/` OKF projection tree. Returns the files written. */
+function writeOkfProjection(outDir, d) {
+    const written = [];
+    const write = (rel, content) => {
+        const full = node_path_1.default.join(outDir, rel);
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(full), { recursive: true });
+        node_fs_1.default.writeFileSync(full, content.endsWith('\n') ? content : `${content}\n`);
+        written.push(rel);
+    };
+    write('index.md', renderIndex(d));
+    write('build-brief.md', renderBuildBrief(d));
+    write('scope-contract.md', renderScopeContract(d));
+    write('log.md', renderLog(d));
+    (d.recommendations ?? []).forEach((r, i) => write(node_path_1.default.join('recommendations', recFile(r, i)), renderRecommendation(r)));
+    return written;
+}
+//# sourceMappingURL=okf-projection.js.map

package/dist/lib/okf-projection.js.map

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

package/dist/lib/worktree.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISCOVERY_WORKTREE_PREFIX = void 0;
+exports.slugFromAsk = slugFromAsk;
+exports.discoveryBranch = discoveryBranch;
+exports.discoveryWorktreePath = discoveryWorktreePath;
+exports.resolveDiscoveryWorktree = resolveDiscoveryWorktree;
+exports.createDiscoveryWorktree = createDiscoveryWorktree;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Discovery-worktree helpers (unchosen-options → discovery worktrees, 2026-06-14).
+ *
+ * When a developer parks an unchosen option for background discovery, the agent
+ * spins a git worktree and launches `/ritual lite --worktree` headless in it
+ * (autonomous discovery → build brief, no code). This module owns the
+ * deterministic naming + the `git worktree add`.
+ *
+ * The pure helpers (slug + path + branch derivation) are unit-tested; the
+ * `git`-touching `createDiscoveryWorktree` is the thin integration wrapper.
+ */
+/** Branch/path prefix for discovery worktrees. */
+exports.DISCOVERY_WORKTREE_PREFIX = 'ritual-discover';
+/**
+ * Deterministic, filesystem-safe slug from a free-text ask. Lowercased,
+ * non-alphanumerics collapsed to single dashes, trimmed, capped at 48 chars.
+ * Falls back to 'discovery' when the ask has no usable characters.
+ */
+function slugFromAsk(ask) {
+    const slug = (ask ?? '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 48)
+        .replace(/-+$/g, '');
+    return slug || 'discovery';
+}
+/** The branch name for a discovery worktree. */
+function discoveryBranch(slug) {
+    return `${exports.DISCOVERY_WORKTREE_PREFIX}/${slug}`;
+}
+/**
+ * Where the worktree checkout lives. A SIBLING of the repo (git forbids a
+ * worktree nested inside the main worktree), under `<repo>.<prefix>/<slug>`,
+ * so several discovery worktrees for one repo group together and never collide
+ * with the repo's own tree.
+ */
+function discoveryWorktreePath(repoRoot, slug) {
+    const parent = node_path_1.default.dirname(repoRoot);
+    const base = node_path_1.default.basename(repoRoot);
+    return node_path_1.default.join(parent, `${base}.${exports.DISCOVERY_WORKTREE_PREFIX}`, slug);
+}
+/** Resolve the (slug, branch, path) triple for an ask without touching git. */
+function resolveDiscoveryWorktree(repoRoot, ask) {
+    const slug = slugFromAsk(ask);
+    return {
+        slug,
+        branch: discoveryBranch(slug),
+        worktreePath: discoveryWorktreePath(repoRoot, slug),
+    };
+}
+/**
+ * Create the discovery worktree via `git worktree add <path> -b <branch>` off
+ * the current HEAD. Integration wrapper — the deterministic naming above is
+ * what's unit-tested. Returns ok:false with stderr on failure (e.g. the branch
+ * already exists / the path is occupied) so the caller can surface it.
+ */
+function createDiscoveryWorktree(repoRoot, ask) {
+    const wt = resolveDiscoveryWorktree(repoRoot, ask);
+    const result = (0, node_child_process_1.spawnSync)('git', ['worktree', 'add', wt.worktreePath, '-b', wt.branch], {
+        cwd: repoRoot,
+        stdio: 'pipe',
+        encoding: 'utf8',
+    });
+    if (result.status === 0) {
+        return { ...wt, ok: true };
+    }
+    return {
+        ...wt,
+        ok: false,
+        error: (result.stderr || result.error?.message || 'git worktree add failed').trim(),
+    };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/lib/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../src/lib/worktree.ts"],"names":[],"mappings":";;;;;;AAuBA,kCAQC;AAGD,0CAEC;AAQD,sDAIC;AASD,4DAOC;AAaD,0DAeC;AA5FD,2DAA+C;AAC/C,0DAA6B;AAE7B;;;;;;;;;;GAUG;AAEH,kDAAkD;AACrC,QAAA,yBAAyB,GAAG,iBAAiB,CAAC;AAE3D;;;;GAIG;AACH,SAAgB,WAAW,CAAC,GAAW;IACtC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;SACtB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtB,OAAO,IAAI,IAAI,WAAW,CAAC;AAC5B,CAAC;AAED,gDAAgD;AAChD,SAAgB,eAAe,CAAC,IAAY;IAC3C,OAAO,GAAG,iCAAyB,IAAI,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,QAAgB,EAAE,IAAY;IACnE,MAAM,MAAM,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,mBAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,iCAAyB,EAAE,EAAE,IAAI,CAAC,CAAC;AACxE,CAAC;AAQD,+EAA+E;AAC/E,SAAgB,wBAAwB,CAAC,QAAgB,EAAE,GAAW;IACrE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO;QACN,IAAI;QACJ,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC;QAC7B,YAAY,EAAE,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC;KACnD,CAAC;AACH,CAAC;AAOD;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,QAAgB,EAAE,GAAW;IACpE,MAAM,EAAE,GAAG,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,KAAK,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE;QACtF,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO;QACN,GAAG,EAAE;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,yBAAyB,CAAC,CAAC,IAAI,EAAE;KACnF,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ritualai/cli",
-  "version": "0.36.11",
+  "version": "0.36.14",
   "description": "Ritual CLI — scaffold AI coding agent skills + register MCP servers. Connects Claude Code, Cursor, Windsurf, Kiro, Gemini CLI, VS Code/Copilot, and Codex to Ritual Cloud.",
   "private": false,
   "license": "Apache-2.0",

package/skills/claude-code/ritual/.ritual-bundle.json

@@ -1,5 +1,5 @@
 {
-  "cliVersion": "0.36.11",
-  "builtAt": "2026-06-14T18:50:01.090Z",
-  "skillsHash": "39dbaf6dbdf9"
+  "cliVersion": "0.36.14",
+  "builtAt": "2026-06-14T21:33:31.224Z",
+  "skillsHash": "ee9a77046c96"
 }

package/skills/claude-code/ritual/SKILL.md

@@ -3,7 +3,7 @@ name: ritual
 description: "Use when an engineer wants a coding agent to plan or build a feature, refactor, or implementation-heavy change that depends on context the agent can't infer on its own — strategic intent, constraints, prior decisions, and trade-offs that live in the user's head. Ritual runs a structured exploration to surface that context through targeted discovery questions, combines it with codebase signals and prior explorations, and delivers a validated build brief (sub-problems, recommendations, dependencies) — additional context to fold into plan mode before the agent writes code. Prefer this over jumping straight to implementation or plan mode when the problem is ambiguous, cross-cutting, or has non-obvious constraints. Subcommands: build (full planning-to-sync cycle — default for new features), resume (continue an in-flight exploration), lineage (file-path KG history — what decisions shaped this code), context-pulse (readiness and context-debt scoring — is this safe to build yet?)."
 argument-hint: "[subcommand] <args>  (e.g. 'build Reduce T2 churn in Q3', 'resume', 'lineage src/checkout/views.py', 'context-pulse Add billing export')"
 user-invocable: true
-stamp: 39dbaf6dbdf9
+stamp: ee9a77046c96
 ---
 
 # /ritual

package/skills/claude-code/ritual/references/build-flow.md

@@ -554,7 +554,33 @@ Steps:
    f. **If the user picks one (1-N):**
       - Set the chosen candidate's `summary` as the `raw_input` for the rest of the flow.
       - **Skip Step 1.5 step 8 (overlap check)** — the user just picked from system suggestions explicitly grounded in workspace state; a fresh overlap pass would be redundant noise.
-      - Continue to Step 2 (template selection).
+      - **Run the unchosen-candidates gate (f.1) BEFORE continuing**, then continue to Step 2.
+
+<!-- skill-options:no-gate-change: f.1 is an OPTIONAL skippable sub-prompt nested in Step 1.5 step 6 (default skip); adds no tracked pause gate or Step header, so the structural fingerprint is unchanged (check-skill-options-contract green). -->
+   f.1 **Unchosen-candidates gate (2026-06-14, unchosen-options → discovery worktrees).** The candidates the user did NOT pick are paths worth not silently dropping. Render ONE compact, SKIPPABLE prompt — for each unchosen candidate, the user can spin up **discovery now** (a background worktree reasons it to a build brief) or **log it as a future job**. Promote DELIBERATELY: the default is to drop. (This gate is itself skipped in autonomous/worktree mode — never spawn discovery recursively.)
+
+      ```text
+      You picked #{k}. The other {M} — want to keep any going?
+        • `discover <nums>`  — spin up discovery NOW in a background git worktree: an agent reasons it
+                               end-to-end to a build brief (reasoning only, no code). e.g. `discover 1`
+        • `next-job <nums>`  — just log it as a future job (a draft exploration in this workspace; nothing runs)
+        • `skip`             — drop them (default)
+      ```
+
+      Resolve the reply, then continue to Step 2 for the picked candidate:
+      - **`discover <nums>`** → for each, run `ritual lite "{candidate.summary}" --worktree` **in the
+        BACKGROUND** (do not block the build — use your shell's background/async execution). It spins a
+        git worktree and runs autonomous discovery to a brief there; tell the user where (`<repo>.ritual-discover/<slug>`).
+        The result is an exploration with `spawn_origin: 'discovery_worktree'`; its brief is
+        agent-authored, not human-reviewed. (See `references/unchosen-options-discovery-worktrees.md` in `documents/architecture/`.)
+      - **`next-job <nums>`** → for each, call `mcp__ritual__create_exploration` with the candidate's
+        `title` as `name`, its `summary` as `problem_statement`, `spawn_origin: 'next_job'`, and NO
+        `agentic` flag — a NOT_STARTED draft that shows in the workspace roster as a future job. Cheap; nothing runs.
+      - **`skip` / no reply about them** → drop silently.
+
+      Keep it ONE prompt, never per-candidate pauses. If the user just proceeds without addressing it, treat as `skip`.
+
+   f.2 **Continue to Step 2 (template selection)** for the picked candidate.
 
    g. **If the user says "none" / "let me describe":** continue to Step 2 normally; treat as if they had originally picked "start fresh" with no raw_input yet (they'll provide one at Step 3-4 time).