framein 0.0.4 → 0.0.6

package/dist/delegate.js

@@ -1,64 +1,71 @@
-// Headless delegation (ADR-0007 B-2). The PRIMARY way framein pulls another role into a session:
-// drive each CLI's non-interactive print mode over child_process pipes — NO PTY. This sidesteps the
-// Windows ConPTY/node-pty risk and keeps zero runtime deps. Human-in-the-loop attach uses Node's
-// built-in `stdio:'inherit'` (interactiveCommand below) — a programmatic PTY (node-pty) is
-// deliberately not used (ADR-0009). These builders are pure; the spawn lives in cli.ts and is
-// live-verified against real claude/codex/gemini.
-import { DEFAULT_ROLE_PRIORITY } from './roles.js';
-/**
- * Non-interactive one-shot invocation for each agent (prompt via stdin, response on stdout).
- * `opts.trustFlags` (from trustPlan, F-TRUST) are FIXED per-agent permission-bypass flags appended
- * to argv — still no user input there, so it stays shell-safe under shell:true.
- */
-export function buildInvocation(agent, prompt, opts = {}) {
-    const trust = opts.trustFlags ?? [];
-    switch (agent) {
-        case 'claude': return { command: 'claude', args: ['-p', ...trust], stdin: prompt };
-        case 'codex': return { command: 'codex', args: ['exec', '--skip-git-repo-check', ...trust], stdin: prompt }; // exec refuses untrusted/non-git dirs otherwise
-        // gemini -p takes the prompt as a value and APPENDS stdin; `--prompt=` (empty) + stdin keeps the
-        // prompt off argv (shell-safe), `--skip-trust` is required for headless untrusted dirs. Verified.
-        case 'gemini': return { command: 'gemini', args: ['--prompt=', '--skip-trust', ...trust], stdin: prompt };
-        default: {
-            const _exhaustive = agent;
-            throw new Error(`unknown agent: ${String(_exhaustive)}`);
-        }
-    }
-}
-/** Which agent runs a role: the explicit assignment, else the role's default-priority head. */
-export function resolveAgent(roles, role) {
-    return roles[role] ?? DEFAULT_ROLE_PRIORITY[role][0];
-}
-/** The fixed shell command (flags only, no user input) that runDelegated runs with shell:true. */
-export function invocationCommand(inv) {
-    return [inv.command, ...inv.args].join(' ');
-}
-/**
- * The bare interactive command for an agent — launched with stdio:'inherit' so the human drives the
- * agent's own TUI directly, inside the already-synced frame (ADR-0007 B-2 interactive path, zero-dep).
- * A true programmatic PTY (read/inject/resize the agent's terminal) would need node-pty — a native
- * runtime dependency that breaks framein's zero-dep invariant (ADR-0003) — and framein observes via
- * the store/ledger, not by screen-scraping a TTY, so it is deliberately NOT used.
- */
-// `resume` re-enters the agent's MOST RECENT session in this cwd (handoff continuity, F-CAPSULE/ADR-0009):
-// claude `--continue`, codex `resume --last`, gemini `--resume`. framein decides re-entry from its own
-// ledger (a prior enter/return for this agent) — it never scrapes the printed session id (ADR-0009).
-export function interactiveCommand(agent, resume = false, trustFlags = []) {
-    // F-TRUST placement: codex `resume` is a SUBCOMMAND, so top-level bypass flags must come BEFORE it
-    // (`codex --full-auto resume --last`); appending after the subcommand makes codex reject them. claude
-    // `--continue` and gemini `--resume` are plain flags, so trust flags can follow.
-    const t = trustFlags.length ? ` ${trustFlags.join(' ')}` : '';
-    switch (agent) {
-        case 'claude': return `claude${resume ? ' --continue' : ''}${t}`;
-        case 'codex': return `codex${t}${resume ? ' resume --last' : ''}`;
-        case 'gemini': return `gemini${resume ? ' --resume' : ''}${t}`;
-        default: {
-            const _exhaustive = agent;
-            throw new Error(`unknown agent: ${String(_exhaustive)}`);
-        }
-    }
-}
-/** Human-readable preview for `--show`: the fixed command + a peek at the stdin prompt. */
-export function renderInvocation(inv) {
-    const peek = inv.stdin.length > 60 ? inv.stdin.slice(0, 60) + '…' : inv.stdin;
-    return `${invocationCommand(inv)}  ⟵ stdin: ${JSON.stringify(peek)}`;
-}
+// Headless delegation (ADR-0007 B-2). The PRIMARY way framein pulls another role into a session:
+// drive each CLI's non-interactive print mode over child_process pipes — NO PTY. This sidesteps the
+// Windows ConPTY/node-pty risk and keeps zero runtime deps. Human-in-the-loop attach uses Node's
+// built-in `stdio:'inherit'` (interactiveCommand below) — a programmatic PTY (node-pty) is
+// deliberately not used (ADR-0009). These builders are pure; the spawn lives in cli.ts and is
+// live-verified against real claude/codex/gemini.
+import { DEFAULT_ROLE_PRIORITY } from './roles.js';
+export const HANDOFF_START_PROMPT = 'Framein handoff: run `framein capsule` first, restate the current task contract briefly, then continue from the local facts. Do not ask the user to re-explain context.';
+/**
+ * Non-interactive one-shot invocation for each agent (prompt via stdin, response on stdout).
+ * `opts.trustFlags` (from trustPlan, F-TRUST) are FIXED per-agent permission-bypass flags appended
+ * to argv — still no user input there, so it stays shell-safe under shell:true.
+ */
+export function buildInvocation(agent, prompt, opts = {}) {
+    const trust = opts.trustFlags ?? [];
+    switch (agent) {
+        case 'claude': return { command: 'claude', args: ['-p', ...trust], stdin: prompt };
+        case 'codex': return { command: 'codex', args: ['exec', '--skip-git-repo-check', ...trust], stdin: prompt }; // exec refuses untrusted/non-git dirs otherwise
+        // gemini -p takes the prompt as a value and APPENDS stdin; `--prompt=` (empty) + stdin keeps the
+        // prompt off argv (shell-safe), `--skip-trust` is required for headless untrusted dirs. Verified.
+        case 'gemini': return { command: 'gemini', args: ['--prompt=', '--skip-trust', ...trust], stdin: prompt };
+        default: {
+            const _exhaustive = agent;
+            throw new Error(`unknown agent: ${String(_exhaustive)}`);
+        }
+    }
+}
+/** Which agent runs a role: the explicit assignment, else the role's default-priority head. */
+export function resolveAgent(roles, role) {
+    return roles[role] ?? DEFAULT_ROLE_PRIORITY[role][0];
+}
+/** The fixed shell command (flags only, no user input) that runDelegated runs with shell:true. */
+export function invocationCommand(inv) {
+    return [inv.command, ...inv.args].join(' ');
+}
+/**
+ * The bare interactive command for an agent — launched with stdio:'inherit' so the human drives the
+ * agent's own TUI directly, inside the already-synced frame (ADR-0007 B-2 interactive path, zero-dep).
+ * A true programmatic PTY (read/inject/resize the agent's terminal) would need node-pty — a native
+ * runtime dependency that breaks framein's zero-dep invariant (ADR-0003) — and framein observes via
+ * the store/ledger, not by screen-scraping a TTY, so it is deliberately NOT used.
+ */
+// `resume` re-enters the agent's MOST RECENT session in this cwd (handoff continuity, F-CAPSULE/ADR-0009):
+// claude `--continue`, codex `resume --last`, gemini `--resume`. framein decides re-entry from its own
+// ledger (a prior enter/return for this agent) — it never scrapes the printed session id (ADR-0009).
+function shellQuote(arg) {
+    if (process.platform === 'win32')
+        return `"${arg.replace(/"/g, '\\"')}"`;
+    return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+export function interactiveCommand(agent, resume = false, trustFlags = [], initialPrompt) {
+    // F-TRUST placement: codex `resume` is a SUBCOMMAND, so top-level bypass flags must come BEFORE it
+    // (`codex --full-auto resume --last`); appending after the subcommand makes codex reject them. claude
+    // `--continue` and gemini `--resume` are plain flags, so trust flags can follow.
+    const t = trustFlags.length ? ` ${trustFlags.join(' ')}` : '';
+    const p = initialPrompt ? ` ${shellQuote(initialPrompt)}` : '';
+    switch (agent) {
+        case 'claude': return `claude${resume ? ' --continue' : ''}${t}${p}`;
+        case 'codex': return `codex${t}${resume ? ' resume --last' : ''}${p}`;
+        case 'gemini': return `gemini${resume ? ' --resume' : ''}${t}${initialPrompt ? ` --prompt-interactive${p}` : ''}`;
+        default: {
+            const _exhaustive = agent;
+            throw new Error(`unknown agent: ${String(_exhaustive)}`);
+        }
+    }
+}
+/** Human-readable preview for `--show`: the fixed command + a peek at the stdin prompt. */
+export function renderInvocation(inv) {
+    const peek = inv.stdin.length > 60 ? inv.stdin.slice(0, 60) + '…' : inv.stdin;
+    return `${invocationCommand(inv)}  ⟵ stdin: ${JSON.stringify(peek)}`;
+}

package/dist/disagree.js

@@ -1,85 +1,106 @@
-// Disagreement Protocol (F-LOOP-5, ADR-0008): bound model-vs-model debate so it converges instead
-// of looping. A proposal is met with at most `maxRounds` blocking challenges; the reviewer returns
-// CLAIMS + a required change (never edits — the lead keeps control); no agreement after the cap
-// escalates to the human with exactly two options. Pure state machine; the model-authored content
-// of each turn is the deferred live path.
-import { PLAIN } from './ui/theme.js';
-export const MAX_ROUNDS = 2;
-export function newDebate(topic, proposal, maxRounds = MAX_ROUNDS) {
-    return { topic, entries: [{ kind: 'proposal', proposal }], maxRounds };
-}
-export function challengeCount(d) {
-    return d.entries.filter((e) => e.kind === 'challenge').length;
-}
-function leadPosition(d) {
-    for (let i = d.entries.length - 1; i >= 0; i--) {
-        const e = d.entries[i];
-        if (e.kind === 'revision')
-            return e.revision.text || d.topic;
-        if (e.kind === 'proposal')
-            return e.proposal.text;
-    }
-    return d.topic;
-}
-function reviewerRequirement(d) {
-    for (let i = d.entries.length - 1; i >= 0; i--) {
-        const e = d.entries[i];
-        if (e.kind === 'challenge' && e.challenge.verdict === 'challenge')
-            return e.challenge.requiredChange ?? e.challenge.claim;
-    }
-    return undefined;
-}
-export function debateStatus(d) {
-    const last = d.entries[d.entries.length - 1];
-    const rounds = challengeCount(d);
-    const escalate = () => ({
-        state: 'escalate',
-        reason: `no agreement after ${rounds} round${rounds === 1 ? '' : 's'} (max ${d.maxRounds})`,
-        options: [`A: ${leadPosition(d)}`, `B: ${reviewerRequirement(d) ?? 'reviewer change'}`],
-    });
-    if (!last || last.kind === 'proposal')
-        return { state: 'awaiting-challenge' };
-    if (last.kind === 'challenge') {
-        if (last.challenge.verdict === 'accept')
-            return { state: 'resolved', how: 'accepted-by-reviewer' };
-        if (rounds >= d.maxRounds)
-            return escalate();
-        return { state: 'awaiting-revision', required: last.challenge.requiredChange };
-    }
-    // last is a revision
-    if (last.revision.accepted)
-        return { state: 'resolved', how: 'lead-accepted' };
-    if (rounds >= d.maxRounds)
-        return escalate();
-    return { state: 'awaiting-challenge' };
-}
-export function renderDebate(d, ui = PLAIN) {
-    const lines = [`Debate: ${d.topic}`, ''];
-    for (const e of d.entries) {
-        if (e.kind === 'proposal')
-            lines.push(`proposal${e.proposal.by ? ` (${e.proposal.by})` : ''}: ${e.proposal.text}`);
-        else if (e.kind === 'challenge') {
-            const c = e.challenge;
-            lines.push(c.verdict === 'accept'
-                ? `challenge${c.by ? ` (${c.by})` : ''}: accept`
-                : `challenge${c.by ? ` (${c.by})` : ''}: ${c.claim ?? ''}${c.requiredChange ? ` → require: ${c.requiredChange}` : ''}`);
-        }
-        else {
-            lines.push(`revision: ${e.revision.accepted ? 'accepted' : 'rejected'}${e.revision.text ? ` — ${e.revision.text}` : ''}`);
-        }
-    }
-    lines.push('');
-    const st = debateStatus(d);
-    if (st.state === 'resolved')
-        lines.push(ui.tone(`Resolved (${st.how}).`, 'success'));
-    else if (st.state === 'escalate') {
-        lines.push(ui.tone(`Escalate to human — ${st.reason}:`, 'warning'));
-        for (const o of st.options)
-            lines.push(`  ${o}`);
-    }
-    else if (st.state === 'awaiting-revision')
-        lines.push(ui.tone(`Awaiting lead revision${st.required ? ` (required: ${st.required})` : ''}.`, 'info'));
-    else
-        lines.push(ui.tone('Awaiting reviewer challenge.', 'info'));
-    return lines.join('\n');
-}
+// Disagreement Protocol (F-LOOP-5, ADR-0008): bound model-vs-model debate so it converges instead
+// of looping. A proposal is met with at most `maxRounds` blocking challenges; the reviewer returns
+// CLAIMS + a required change (never edits — the lead keeps control); no agreement after the cap
+// escalates to the human with exactly two options. Pure state machine; the model-authored content
+// of each turn is the deferred live path.
+import { PLAIN } from './ui/theme.js';
+export const MAX_ROUNDS = 2;
+export function newDebate(topic, proposal, maxRounds = MAX_ROUNDS) {
+    return { topic, entries: [{ kind: 'proposal', proposal }], maxRounds };
+}
+export function challengeCount(d) {
+    return d.entries.filter((e) => e.kind === 'challenge').length;
+}
+function leadPosition(d) {
+    for (let i = d.entries.length - 1; i >= 0; i--) {
+        const e = d.entries[i];
+        if (e.kind === 'revision')
+            return e.revision.text || d.topic;
+        if (e.kind === 'response')
+            return e.response.proposedRevision ?? e.response.text ?? d.topic;
+        if (e.kind === 'proposal')
+            return e.proposal.text;
+    }
+    return d.topic;
+}
+function reviewerRequirement(d) {
+    for (let i = d.entries.length - 1; i >= 0; i--) {
+        const e = d.entries[i];
+        if (e.kind === 'challenge' && e.challenge.verdict === 'challenge')
+            return e.challenge.requiredChange ?? e.challenge.claim;
+    }
+    return undefined;
+}
+export function debateStatus(d) {
+    const last = d.entries[d.entries.length - 1];
+    const rounds = challengeCount(d);
+    const escalate = () => ({
+        state: 'escalate',
+        reason: `no agreement after ${rounds} round${rounds === 1 ? '' : 's'} (max ${d.maxRounds})`,
+        options: [`A: ${leadPosition(d)}`, `B: ${reviewerRequirement(d) ?? 'reviewer change'}`],
+    });
+    if (!last || last.kind === 'proposal')
+        return { state: 'awaiting-challenge' };
+    if (last.kind === 'challenge') {
+        if (last.challenge.verdict === 'accept')
+            return { state: 'resolved', how: 'accepted-by-reviewer' };
+        if (rounds >= d.maxRounds)
+            return escalate();
+        return { state: 'awaiting-revision', required: last.challenge.requiredChange };
+    }
+    if (last.kind === 'response') {
+        if (rounds >= d.maxRounds)
+            return escalate();
+        return { state: 'awaiting-decision', required: reviewerRequirement(d) };
+    }
+    // last is a revision
+    if (last.revision.accepted)
+        return { state: 'resolved', how: 'lead-accepted' };
+    if (rounds >= d.maxRounds)
+        return escalate();
+    return { state: 'awaiting-challenge' };
+}
+export function renderDebate(d, ui = PLAIN) {
+    const lines = [`Debate: ${d.topic}`, ''];
+    for (const e of d.entries) {
+        if (e.kind === 'proposal')
+            lines.push(`proposal${e.proposal.by ? ` (${e.proposal.by})` : ''}: ${e.proposal.text}`);
+        else if (e.kind === 'challenge') {
+            const c = e.challenge;
+            lines.push(c.verdict === 'accept'
+                ? `challenge${c.by ? ` (${c.by})` : ''}: accept`
+                : `challenge${c.by ? ` (${c.by})` : ''}: ${c.claim ?? ''}${c.requiredChange ? ` → require: ${c.requiredChange}` : ''}`);
+            if (c.basis?.length)
+                lines.push(`  basis: ${c.basis.join(', ')}`);
+            if (c.missingEvidence?.length)
+                lines.push(`  missing_evidence: ${c.missingEvidence.join('; ')}`);
+        }
+        else if (e.kind === 'response') {
+            const r = e.response;
+            lines.push(`response${r.by ? ` (${r.by})` : ''}: ${r.text}`);
+            if (r.proposedRevision)
+                lines.push(`  proposed_revision: ${r.proposedRevision}`);
+            if (r.acceptsRequiredChange !== undefined)
+                lines.push(`  accepts_required_change: ${r.acceptsRequiredChange ? 'yes' : 'no'}`);
+        }
+        else {
+            lines.push(`revision: ${e.revision.accepted ? 'accepted' : 'rejected'}${e.revision.text ? ` — ${e.revision.text}` : ''}`);
+        }
+    }
+    lines.push('');
+    const st = debateStatus(d);
+    if (st.state === 'resolved')
+        lines.push(ui.tone(`Resolved (${st.how}).`, 'success'));
+    else if (st.state === 'escalate') {
+        lines.push(ui.tone(`Escalate to human — ${st.reason}:`, 'warning'));
+        for (const o of st.options)
+            lines.push(`  ${o}`);
+    }
+    else if (st.state === 'awaiting-decision')
+        lines.push(ui.tone(`Awaiting lead decision${st.required ? ` (reviewer requires: ${st.required})` : ''}.`, 'info'));
+    else if (st.state === 'awaiting-revision')
+        lines.push(ui.tone(`Awaiting lead revision${st.required ? ` (required: ${st.required})` : ''}.`, 'info'));
+    else
+        lines.push(ui.tone('Awaiting reviewer challenge.', 'info'));
+    return lines.join('\n');
+}

package/dist/wrappers.js

@@ -1,63 +1,62 @@
-// Native command wrappers (ADR-0010/0011). LOGIC-LESS: each wrapper just runs `<bin> <verb> [--json]`
-// and presents the result — the single source of truth stays the framein engine (no per-host logic →
-// no drift). Pure generators; the CLI (`fr integrations`) writes them. Namespace = `fr` (ADR-0011):
-// Claude/Gemini `/fr:<verb>`, Codex `$fr-<verb>` (a SKILL.md skill — Codex's `/prompts` are deprecated).
-// Each host's surface syntax differs by design (ADR-0010 rejected forcing one syntax); only the verb +
-// `fr` namespace are unified. Files carry PROVENANCE so uninstall only removes our own.
-export const WRAP_VERBS = [
-    { verb: 'start', json: false, desc: 'Start a Task Contract (what "done" means)' },
-    { verb: 'verify', json: true, desc: 'Validation Gate: build/test vs the contract' },
-    { verb: 'ship', json: true, desc: 'Ship gate: readiness + commit/deploy guidance' },
-    { verb: 'rescue', json: true, desc: 'Detect a repair loop and propose options' },
-    { verb: 'status', json: true, desc: 'Show framein state' },
-    { verb: 'challenge', json: false, run: true, independent: true, desc: 'Get an INDEPENDENT model\'s verdict on a proposal (a different model reviews)' },
-    { verb: 'risk', json: true, desc: 'Blast Radius: risk level + required gates for the change' },
-    { verb: 'task', json: false, desc: 'Task Contract: show / amend the definition of done' },
-    { verb: 'capsule', json: false, desc: 'Task Capsule: handoff-free continuity snapshot' },
-    { verb: 'decide', json: false, desc: 'Resolve an open reviewer debate (accept / reject)' },
-];
-export const PROVENANCE = 'generated-by: framein (fr integrations) — do not edit; regenerate with `fr integrations install`';
-// host = the agent this wrapper runs inside; passed as `--by <host>` for `independent` verbs so framein
-// can pick a reviewer that is NOT this agent.
-const cmd = (bin, v, host) => `${bin} ${v.verb}${v.json ? ' --json' : ''}${v.run ? ' --run' : ''}${v.independent ? ` --by ${host}` : ''}`;
-export function genClaudeCommand(v, bin = 'framein') {
-    const content = [
-        '---',
-        `description: ${v.desc}`,
-        `allowed-tools: Bash(${bin}:*)`,
-        `# ${PROVENANCE}`,
-        '---',
-        '',
-        `Run \`!${cmd(bin, v, 'claude')} $ARGUMENTS\` and present the result to the user clearly.`,
-        '',
-    ].join('\n');
-    return { path: `.claude/commands/fr/${v.verb}.md`, content };
-}
-export function genGeminiCommand(v, bin = 'framein') {
-    const content = [
-        `# ${PROVENANCE}`,
-        `description = ${JSON.stringify(v.desc)}`,
-        `prompt = ${JSON.stringify(`Run framein and present the result:\n!{${cmd(bin, v, 'gemini')} {{args}}}`)}`,
-        '',
-    ].join('\n');
-    return { path: `.gemini/commands/fr/${v.verb}.toml`, content };
-}
-/** Codex skill — invoked as `$fr-<verb>` (Codex skills live in .codex/skills/<name>/SKILL.md and are
- *  triggered with `$<name>`; the older `/prompts:` path is deprecated, ADR-0010). */
-export function genCodexSkill(v, bin = 'framein') {
-    const content = [
-        '---',
-        `name: fr-${v.verb}`,
-        `description: ${JSON.stringify(v.desc)}`,
-        `# ${PROVENANCE}`,
-        '---',
-        '',
-        `Run \`${cmd(bin, v, 'codex')} $ARGUMENTS\` and present the result to the user clearly.`,
-        '',
-    ].join('\n');
-    return { path: `.codex/skills/fr-${v.verb}/SKILL.md`, content };
-}
-export function wrapperFiles(host, bin = 'framein') {
-    const gen = host === 'claude' ? genClaudeCommand : host === 'gemini' ? genGeminiCommand : genCodexSkill;
-    return WRAP_VERBS.map((v) => gen(v, bin));
-}
+// Native command wrappers (ADR-0010/0011). LOGIC-LESS: each wrapper just runs `<bin> <verb> [--json]`
+// and presents the result — the single source of truth stays the framein engine (no per-host logic →
+// no drift). Pure generators; the CLI (`fr integrations`) writes them. Namespace = `fr` (ADR-0011):
+// Claude/Gemini `/fr:<verb>`, Codex `$fr-<verb>` (a SKILL.md skill under `.agents/skills`).
+// Each host's surface syntax differs by design (ADR-0010 rejected forcing one syntax); only the verb +
+// `fr` namespace are unified. Files carry PROVENANCE so uninstall only removes our own.
+export const WRAP_VERBS = [
+    { verb: 'start', json: false, desc: 'When beginning work: start or reset the Task Contract that defines done' },
+    { verb: 'verify', json: true, desc: 'Before claiming done: run build/test validation against the contract' },
+    { verb: 'ship', json: true, desc: 'Before ship: check readiness, risk, commit, and deploy guidance' },
+    { verb: 'rescue', json: true, desc: 'When stuck in a repair loop: detect thrash and show recovery options' },
+    { verb: 'status', json: true, desc: 'When reorienting: show current roles, lock, and Framein state' },
+    { verb: 'challenge', json: false, run: true, independent: true, desc: 'When stuck or before accepting a risky plan: ask a different model to challenge it' },
+    { verb: 'risk', json: true, desc: 'Before editing sensitive areas: inspect blast radius and required gates' },
+    { verb: 'task', json: false, desc: 'When scope changes: show or amend the task contract and definition of done' },
+    { verb: 'capsule', json: false, desc: 'For handoff, switch, session compaction, or quota: prepare the next lead' },
+    { verb: 'decide', json: false, desc: 'After challenge: accept or reject the reviewer objection and record the decision' },
+];
+export const PROVENANCE = 'generated-by: framein (fr integrations) — do not edit; regenerate with `fr integrations install`';
+// host = the agent this wrapper runs inside; passed as `--by <host>` for `independent` verbs so framein
+// can pick a reviewer that is NOT this agent.
+const cmd = (bin, v, host) => `${bin} ${v.verb}${v.json ? ' --json' : ''}${v.run ? ' --run' : ''}${v.independent ? ` --by ${host}` : ''}`;
+export function genClaudeCommand(v, bin = 'framein') {
+    const content = [
+        '---',
+        `description: ${v.desc}`,
+        `allowed-tools: Bash(${bin}:*)`,
+        `# ${PROVENANCE}`,
+        '---',
+        '',
+        `Run \`!${cmd(bin, v, 'claude')} $ARGUMENTS\` and present the result to the user clearly.`,
+        '',
+    ].join('\n');
+    return { path: `.claude/commands/fr/${v.verb}.md`, content };
+}
+export function genGeminiCommand(v, bin = 'framein') {
+    const content = [
+        `# ${PROVENANCE}`,
+        `description = ${JSON.stringify(v.desc)}`,
+        `prompt = ${JSON.stringify(`Run framein and present the result:\n!{${cmd(bin, v, 'gemini')} {{args}}}`)}`,
+        '',
+    ].join('\n');
+    return { path: `.gemini/commands/fr/${v.verb}.toml`, content };
+}
+/** Codex skill — invoked as `$fr-<verb>` (repo skills live in .agents/skills/<name>/SKILL.md). */
+export function genCodexSkill(v, bin = 'framein') {
+    const content = [
+        '---',
+        `name: fr-${v.verb}`,
+        `description: ${JSON.stringify(v.desc)}`,
+        `# ${PROVENANCE}`,
+        '---',
+        '',
+        `Run \`${cmd(bin, v, 'codex')} $ARGUMENTS\` and present the result to the user clearly.`,
+        '',
+    ].join('\n');
+    return { path: `.agents/skills/fr-${v.verb}/SKILL.md`, content };
+}
+export function wrapperFiles(host, bin = 'framein') {
+    const gen = host === 'claude' ? genClaudeCommand : host === 'gemini' ? genGeminiCommand : genCodexSkill;
+    return WRAP_VERBS.map((v) => gen(v, bin));
+}

package/package.json

@@ -1,49 +1,50 @@
-{
-  "name": "framein",
-  "version": "0.0.4",
-  "description": "Local work frame for Claude, Codex, Gemini, and AI coding agents.",
-  "type": "module",
-  "homepage": "https://www.framein.dev",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/framein-dev/framein.git"
-  },
-  "bugs": {
-    "url": "https://github.com/framein-dev/framein/issues"
-  },
-  "keywords": [
-    "ai",
-    "agents",
-    "cli",
-    "claude",
-    "codex",
-    "gemini",
-    "validation"
-  ],
-  "bin": {
-    "framein": "dist/bin.js",
-    "fr": "dist/bin.js",
-    "frame": "dist/bin.js"
-  },
+{
+  "name": "framein",
+  "version": "0.0.6",
+  "description": "Local work-state layer beneath AI coding agents and harnesses.",
+  "type": "module",
+  "homepage": "https://www.framein.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/framein-dev/framein.git"
+  },
+  "bugs": {
+    "url": "https://github.com/framein-dev/framein/issues"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "cli",
+    "claude",
+    "codex",
+    "gemini",
+    "agent-harness",
+    "validation"
+  ],
+  "bin": {
+    "framein": "dist/bin.js",
+    "fr": "dist/bin.js",
+    "frame": "dist/bin.js"
+  },
   "files": [
     "dist/**/*.js",
     "!dist/**/*.test.js"
   ],
-  "scripts": {
-    "build": "tsc",
-    "build:sea": "npm run build && node scripts/build-sea.mjs",
-    "test": "npm run build && node --no-warnings --test \"dist/**/*.test.js\"",
-    "framein": "node --no-warnings dist/cli.js",
-    "frame": "node --no-warnings dist/cli.js"
-  },
-  "engines": {
-    "node": ">=22.5.0"
-  },
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^26.0.0",
-    "esbuild": "^0.28.1",
-    "postject": "^1.0.0-alpha.6",
-    "typescript": "^6.0.3"
-  }
-}
+  "scripts": {
+    "build": "tsc",
+    "build:sea": "npm run build && node scripts/build-sea.mjs",
+    "test": "npm run build && node --no-warnings --test \"dist/**/*.test.js\"",
+    "framein": "node --no-warnings dist/cli.js",
+    "frame": "node --no-warnings dist/cli.js"
+  },
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "esbuild": "^0.28.1",
+    "postject": "^1.0.0-alpha.6",
+    "typescript": "^6.0.3"
+  }
+}