framein 0.0.4 → 0.0.5

package/dist/recipe.js

@@ -1,55 +1,55 @@
-// Frame Recipe (F-LOOP-8, ADR-0008): a VENDOR-NEUTRAL task protocol (feature/bugfix/ship) that we
-// COMPILE/PROJECT onto each CLI's native features — NOT "run a Claude skill inside Codex" (that's a
-// category error, ADR-0002/0004). The same numbered protocol body is emitted for every agent; only
-// the header naming the agent's native mechanism differs. Shared state stays in framein MCP + ledger.
-import { PLAIN } from './ui/theme.js';
-export const RECIPES = [
-    { name: 'feature', trigger: 'feature', steps: [
-            { role: 'lead', action: 'define_contract' },
-            { role: 'implementer', action: 'implement' },
-            { action: 'run_validation', required: ['tests', 'build'] },
-            { role: 'reviewer', action: 'blocker_review', readOnly: true },
-            { role: 'implementer', action: 'resolve_findings' },
-            { action: 'human_approval' },
-        ] },
-    { name: 'bugfix', trigger: 'bugfix', steps: [
-            { role: 'implementer', action: 'reproduce' },
-            { role: 'reviewer', action: 'root_cause', readOnly: true },
-            { role: 'implementer', action: 'minimal_fix' },
-            { action: 'run_validation', required: ['regression_test'] },
-            { action: 'human_approval' },
-        ] },
-    { name: 'ship', trigger: 'ship', steps: [
-            { action: 'verify_changes', required: ['tests', 'build'] },
-            { action: 'risk_check' },
-            { role: 'explainer', action: 'ownership_brief' },
-            { action: 'human_approval' },
-        ] },
-];
-// How each CLI expresses a recipe natively (we project onto these; we do not cross-execute).
-const NATIVE_MECHANISM = {
-    claude: 'a Claude Skill + hooks + subagent guidance',
-    codex: 'a Codex skill / plugin / workflow',
-    gemini: 'a Gemini extension / skill / hooks',
-};
-export function listRecipes() { return RECIPES; }
-export function getRecipe(name) { return RECIPES.find((r) => r.name === name); }
-function stepLines(r) {
-    return r.steps.map((s, i) => {
-        const who = s.role ? `[${s.role}] ` : '';
-        const ro = s.readOnly ? ' (read-only)' : '';
-        const req = s.required ? ` — required: ${s.required.join(', ')}` : '';
-        return `${i + 1}. ${who}${s.action}${ro}${req}`;
-    });
-}
-export function renderRecipe(r, ui = PLAIN) {
-    return [ui.tone(`recipe: ${r.name} (trigger: ${r.trigger})`, 'muted'), ...stepLines(r)].join('\n');
-}
-/** Project a recipe onto one agent's native mechanism. Body (numbered steps) is identical per agent. */
-export function compileRecipe(r, agent) {
-    return [
-        `# ${r.name} — compiled for ${agent} as ${NATIVE_MECHANISM[agent]}`,
-        ...stepLines(r),
-        'Shared state: framein MCP + task ledger (the contract, decisions, and validation results all agents read).',
-    ].join('\n');
-}
+// Frame Recipe (F-LOOP-8, ADR-0008): a VENDOR-NEUTRAL task protocol (feature/bugfix/ship) that we
+// COMPILE/PROJECT onto each CLI's native features — NOT "run a Claude skill inside Codex" (that's a
+// category error, ADR-0002/0004). The same numbered protocol body is emitted for every agent; only
+// the header naming the agent's native mechanism differs. Shared state stays in framein MCP + ledger.
+import { PLAIN } from './ui/theme.js';
+export const RECIPES = [
+    { name: 'feature', trigger: 'feature', steps: [
+            { role: 'lead', action: 'define_contract' },
+            { role: 'implementer', action: 'implement' },
+            { action: 'run_validation', required: ['tests', 'build'] },
+            { role: 'reviewer', action: 'blocker_review', readOnly: true },
+            { role: 'implementer', action: 'resolve_findings' },
+            { action: 'human_approval' },
+        ] },
+    { name: 'bugfix', trigger: 'bugfix', steps: [
+            { role: 'implementer', action: 'reproduce' },
+            { role: 'reviewer', action: 'root_cause', readOnly: true },
+            { role: 'implementer', action: 'minimal_fix' },
+            { action: 'run_validation', required: ['regression_test'] },
+            { action: 'human_approval' },
+        ] },
+    { name: 'ship', trigger: 'ship', steps: [
+            { action: 'verify_changes', required: ['tests', 'build'] },
+            { action: 'risk_check' },
+            { role: 'explainer', action: 'ownership_brief' },
+            { action: 'human_approval' },
+        ] },
+];
+// How each CLI expresses a recipe natively (we project onto these; we do not cross-execute).
+const NATIVE_MECHANISM = {
+    claude: 'a Claude Skill + hooks + subagent guidance',
+    codex: 'a Codex skill / plugin / workflow',
+    gemini: 'a Gemini extension / skill / hooks',
+};
+export function listRecipes() { return RECIPES; }
+export function getRecipe(name) { return RECIPES.find((r) => r.name === name); }
+function stepLines(r) {
+    return r.steps.map((s, i) => {
+        const who = s.role ? `[${s.role}] ` : '';
+        const ro = s.readOnly ? ' (read-only)' : '';
+        const req = s.required ? ` — required: ${s.required.join(', ')}` : '';
+        return `${i + 1}. ${who}${s.action}${ro}${req}`;
+    });
+}
+export function renderRecipe(r, ui = PLAIN) {
+    return [ui.tone(`recipe: ${r.name} (trigger: ${r.trigger})`, 'muted'), ...stepLines(r)].join('\n');
+}
+/** Project a recipe onto one agent's native mechanism. Body (numbered steps) is identical per agent. */
+export function compileRecipe(r, agent) {
+    return [
+        `# ${r.name} — compiled for ${agent} as ${NATIVE_MECHANISM[agent]}`,
+        ...stepLines(r),
+        'Shared state: framein MCP + task ledger (the contract, decisions, and validation results all agents read).',
+    ].join('\n');
+}

package/dist/rescue.js

@@ -1,38 +1,38 @@
-// Rescue Mode (F-LOOP-3, ADR-0008): promote the anomaly detector from a side feature to a
-// flagship. When the ledger shows a repair loop, assemble a rescue report — the signals, the last
-// green checkpoint, and three options (diagnose / rewind / continue) — and NEVER act automatically.
-// Pure logic; the actual model diagnosis (option A) and the git rewind (option B) live in cli.ts.
-import { PLAIN } from './ui/theme.js';
-const short = (sha) => sha.slice(0, 7);
-export function buildRescue(signals, opts = {}) {
-    const triggered = signals.length > 0;
-    const options = [];
-    if (triggered) {
-        const who = opts.reviewer ?? 'the reviewer role';
-        options.push({ key: 'A', label: `Ask ${who} to diagnose without editing` });
-        if (opts.lastGreen) {
-            options.push({ key: 'B', label: `Rewind to checkpoint ${short(opts.lastGreen.sha)}${opts.lastGreen.label ? ` (${opts.lastGreen.label})` : ''}` });
-        }
-        options.push({ key: opts.lastGreen ? 'C' : 'B', label: 'Continue with the current agent' });
-    }
-    return { triggered, signals, lastGreen: opts.lastGreen, reviewer: opts.reviewer, options };
-}
-export function renderRescue(report, ui = PLAIN) {
-    if (!report.triggered)
-        return 'No repair loop detected. (rescue is anomaly-triggered — ADR-0005)';
-    const lines = [ui.tone('Framein detected a repair loop.', 'danger'), ''];
-    for (const s of report.signals)
-        lines.push(`  ${ui.tone(ui.sym.warn, 'warning')} ${s.message}`);
-    lines.push('');
-    if (report.lastGreen) {
-        lines.push(`Last green checkpoint: ${short(report.lastGreen.sha)}${report.lastGreen.label ? ` (${report.lastGreen.label})` : ''}`);
-    }
-    else {
-        lines.push('No green checkpoint recorded (run `frame checkpoint` at a known-good state).');
-    }
-    lines.push('', 'Recommended:');
-    for (const o of report.options)
-        lines.push(`  ${ui.tone(o.key, 'brand')}. ${o.label}`);
-    lines.push('', ui.tone('No action taken automatically.', 'muted'));
-    return lines.join('\n');
-}
+// Rescue Mode (F-LOOP-3, ADR-0008): promote the anomaly detector from a side feature to a
+// flagship. When the ledger shows a repair loop, assemble a rescue report — the signals, the last
+// green checkpoint, and three options (diagnose / rewind / continue) — and NEVER act automatically.
+// Pure logic; the actual model diagnosis (option A) and the git rewind (option B) live in cli.ts.
+import { PLAIN } from './ui/theme.js';
+const short = (sha) => sha.slice(0, 7);
+export function buildRescue(signals, opts = {}) {
+    const triggered = signals.length > 0;
+    const options = [];
+    if (triggered) {
+        const who = opts.reviewer ?? 'the reviewer role';
+        options.push({ key: 'A', label: `Ask ${who} to diagnose without editing` });
+        if (opts.lastGreen) {
+            options.push({ key: 'B', label: `Rewind to checkpoint ${short(opts.lastGreen.sha)}${opts.lastGreen.label ? ` (${opts.lastGreen.label})` : ''}` });
+        }
+        options.push({ key: opts.lastGreen ? 'C' : 'B', label: 'Continue with the current agent' });
+    }
+    return { triggered, signals, lastGreen: opts.lastGreen, reviewer: opts.reviewer, options };
+}
+export function renderRescue(report, ui = PLAIN) {
+    if (!report.triggered)
+        return 'No repair loop detected. (rescue is anomaly-triggered — ADR-0005)';
+    const lines = [ui.tone('Framein detected a repair loop.', 'danger'), ''];
+    for (const s of report.signals)
+        lines.push(`  ${ui.tone(ui.sym.warn, 'warning')} ${s.message}`);
+    lines.push('');
+    if (report.lastGreen) {
+        lines.push(`Last green checkpoint: ${short(report.lastGreen.sha)}${report.lastGreen.label ? ` (${report.lastGreen.label})` : ''}`);
+    }
+    else {
+        lines.push('No green checkpoint recorded (run `frame checkpoint` at a known-good state).');
+    }
+    lines.push('', 'Recommended:');
+    for (const o of report.options)
+        lines.push(`  ${ui.tone(o.key, 'brand')}. ${o.label}`);
+    lines.push('', ui.tone('No action taken automatically.', 'muted'));
+    return lines.join('\n');
+}

package/dist/roles.js

@@ -1,61 +1,61 @@
-// Role presets + routing score function (PRD section 5.2).
-// Vendor-role mapping is NOT hardcoded: these are defaults the user can override.
-import { AGENTS, ROLES } from './types.js';
-/** Runtime guard: is `x` one of the three first-class agents? */
-export function isAgent(x) {
-    return AGENTS.includes(x);
-}
-/** Runtime guard: is `x` one of the five role presets? */
-export function isRole(x) {
-    return ROLES.includes(x);
-}
-export const DEFAULT_ROLE_PRIORITY = {
-    lead: ['claude', 'codex'],
-    implementer: ['claude', 'codex'],
-    reviewer: ['codex', 'claude'],
-    explainer: ['gemini', 'claude'],
-    researcher: ['gemini', 'claude'],
-};
-/** Compliance rule (PRD non-goal): consumer Gemini login is not permitted. */
-export function isForbiddenAuth(agent, auth) {
-    return agent === 'gemini' && auth === 'consumer-login';
-}
-/** Repo-local routing bonus: reward local success, penalize local quota trouble (F-LOOP-7). */
-export function repoBonus(st) {
-    if (!st || st.delegations === 0)
-        return 0;
-    const successRate = (st.delegations - st.failures) / st.delegations; // 0..1
-    return successRate * 2 - st.quotaHits * 0.5;
-}
-export const POLICY_PENALTY = Number.POSITIVE_INFINITY;
-// score = roleFit + quotaScore - failurePenalty - costPenalty
-// forbidden auth combos => -Infinity (never selected).
-export function scoreAgent(agent, ctx) {
-    const auth = ctx.authMode[agent];
-    if (auth && isForbiddenAuth(agent, auth))
-        return -POLICY_PENALTY;
-    if (ctx.unavailable?.[agent])
-        return -POLICY_PENALTY; // quota-exhausted / down => fail over to another agent
-    const priority = (ctx.rolePriority ?? DEFAULT_ROLE_PRIORITY)[ctx.role] ?? [];
-    const idx = priority.indexOf(agent);
-    const roleFit = idx === -1 ? 0 : priority.length - idx;
-    const quota = ctx.remainingQuota?.[agent];
-    const quotaScore = quota === undefined ? 1 : quota * 2;
-    const failurePenalty = (ctx.recentFailures?.[agent] ?? 0) * 1.5;
-    const costPenalty = ctx.costBand?.[agent] ?? 0;
-    return roleFit + quotaScore + repoBonus(ctx.repoStats?.[agent]) - failurePenalty - costPenalty;
-}
-export function selectAgent(candidates, ctx) {
-    let best = null;
-    let bestScore = -POLICY_PENALTY;
-    for (const a of candidates) {
-        const s = scoreAgent(a, ctx);
-        if (s === -POLICY_PENALTY)
-            continue;
-        if (best === null || s > bestScore) {
-            best = a;
-            bestScore = s;
-        }
-    }
-    return best;
-}
+// Role presets + routing score function (PRD section 5.2).
+// Vendor-role mapping is NOT hardcoded: these are defaults the user can override.
+import { AGENTS, ROLES } from './types.js';
+/** Runtime guard: is `x` one of the three first-class agents? */
+export function isAgent(x) {
+    return AGENTS.includes(x);
+}
+/** Runtime guard: is `x` one of the five role presets? */
+export function isRole(x) {
+    return ROLES.includes(x);
+}
+export const DEFAULT_ROLE_PRIORITY = {
+    lead: ['claude', 'codex'],
+    implementer: ['claude', 'codex'],
+    reviewer: ['codex', 'claude'],
+    explainer: ['gemini', 'claude'],
+    researcher: ['gemini', 'claude'],
+};
+/** Compliance rule (PRD non-goal): consumer Gemini login is not permitted. */
+export function isForbiddenAuth(agent, auth) {
+    return agent === 'gemini' && auth === 'consumer-login';
+}
+/** Repo-local routing bonus: reward local success, penalize local quota trouble (F-LOOP-7). */
+export function repoBonus(st) {
+    if (!st || st.delegations === 0)
+        return 0;
+    const successRate = (st.delegations - st.failures) / st.delegations; // 0..1
+    return successRate * 2 - st.quotaHits * 0.5;
+}
+export const POLICY_PENALTY = Number.POSITIVE_INFINITY;
+// score = roleFit + quotaScore - failurePenalty - costPenalty
+// forbidden auth combos => -Infinity (never selected).
+export function scoreAgent(agent, ctx) {
+    const auth = ctx.authMode[agent];
+    if (auth && isForbiddenAuth(agent, auth))
+        return -POLICY_PENALTY;
+    if (ctx.unavailable?.[agent])
+        return -POLICY_PENALTY; // quota-exhausted / down => fail over to another agent
+    const priority = (ctx.rolePriority ?? DEFAULT_ROLE_PRIORITY)[ctx.role] ?? [];
+    const idx = priority.indexOf(agent);
+    const roleFit = idx === -1 ? 0 : priority.length - idx;
+    const quota = ctx.remainingQuota?.[agent];
+    const quotaScore = quota === undefined ? 1 : quota * 2;
+    const failurePenalty = (ctx.recentFailures?.[agent] ?? 0) * 1.5;
+    const costPenalty = ctx.costBand?.[agent] ?? 0;
+    return roleFit + quotaScore + repoBonus(ctx.repoStats?.[agent]) - failurePenalty - costPenalty;
+}
+export function selectAgent(candidates, ctx) {
+    let best = null;
+    let bestScore = -POLICY_PENALTY;
+    for (const a of candidates) {
+        const s = scoreAgent(a, ctx);
+        if (s === -POLICY_PENALTY)
+            continue;
+        if (best === null || s > bestScore) {
+            best = a;
+            bestScore = s;
+        }
+    }
+    return best;
+}

package/dist/select.js

@@ -1,50 +1,50 @@
-// Pure core for the zero-dep arrow-key picker. The raw-mode stdin loop + ANSI redraw live in cli.ts
-// (promptSelect); this module is the testable reducer: (state, keypress) -> next state OR a terminal
-// action. No npm deps, no I/O. `index` always refers to the CURRENTLY VISIBLE (filtered) list.
-/** Case-insensitive substring filter over label + hint + value. Order preserved. */
-export function filterItems(items, query) {
-    const q = query.trim().toLowerCase();
-    if (!q)
-        return items;
-    return items.filter((it) => `${it.label} ${it.hint ?? ''} ${it.value}`.toLowerCase().includes(q));
-}
-export function initSelect(items) {
-    return { items, query: '', index: 0 };
-}
-/** Pure reducer. Returns the next state (kind 'move') or a terminal action ('accept' | 'cancel'). */
-export function reduceSelectKey(state, key) {
-    const visible = filterItems(state.items, state.query);
-    const n = visible.length;
-    const idx = n ? Math.min(state.index, n - 1) : 0;
-    if (key.ctrl && key.name === 'c')
-        return { kind: 'cancel' };
-    if (key.name === 'escape')
-        return { kind: 'cancel' };
-    if (key.name === 'return' || key.name === 'enter') {
-        return n ? { kind: 'accept', value: visible[idx].value } : { kind: 'move', state };
-    }
-    if (key.name === 'up')
-        return { kind: 'move', state: { ...state, index: n ? (idx - 1 + n) % n : 0 } };
-    if (key.name === 'down')
-        return { kind: 'move', state: { ...state, index: n ? (idx + 1) % n : 0 } };
-    if (key.name === 'backspace')
-        return { kind: 'move', state: { ...state, query: state.query.slice(0, -1), index: 0 } };
-    // A single printable character extends the type-to-filter query (control sequences are ignored).
-    const ch = key.sequence;
-    if (ch && ch.length === 1 && ch >= ' ' && !key.ctrl) {
-        return { kind: 'move', state: { ...state, query: state.query + ch, index: 0 } };
-    }
-    return { kind: 'move', state };
-}
-/** Pure renderer: the lines to draw (no ANSI; the I/O layer colors them). First line is the label. */
-export function renderSelectLines(label, state, marker = '>') {
-    const visible = filterItems(state.items, state.query);
-    const head = state.query ? `${label}  (filter: ${state.query})` : label;
-    if (!visible.length)
-        return [head, '  (no matches — backspace to clear)'];
-    const idx = Math.min(state.index, visible.length - 1);
-    return [head, ...visible.map((it, i) => {
-            const hint = it.hint ? `   ${it.hint}` : '';
-            return `${i === idx ? `${marker} ` : '  '}${it.label}${hint}`;
-        })];
-}
+// Pure core for the zero-dep arrow-key picker. The raw-mode stdin loop + ANSI redraw live in cli.ts
+// (promptSelect); this module is the testable reducer: (state, keypress) -> next state OR a terminal
+// action. No npm deps, no I/O. `index` always refers to the CURRENTLY VISIBLE (filtered) list.
+/** Case-insensitive substring filter over label + hint + value. Order preserved. */
+export function filterItems(items, query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return items;
+    return items.filter((it) => `${it.label} ${it.hint ?? ''} ${it.value}`.toLowerCase().includes(q));
+}
+export function initSelect(items) {
+    return { items, query: '', index: 0 };
+}
+/** Pure reducer. Returns the next state (kind 'move') or a terminal action ('accept' | 'cancel'). */
+export function reduceSelectKey(state, key) {
+    const visible = filterItems(state.items, state.query);
+    const n = visible.length;
+    const idx = n ? Math.min(state.index, n - 1) : 0;
+    if (key.ctrl && key.name === 'c')
+        return { kind: 'cancel' };
+    if (key.name === 'escape')
+        return { kind: 'cancel' };
+    if (key.name === 'return' || key.name === 'enter') {
+        return n ? { kind: 'accept', value: visible[idx].value } : { kind: 'move', state };
+    }
+    if (key.name === 'up')
+        return { kind: 'move', state: { ...state, index: n ? (idx - 1 + n) % n : 0 } };
+    if (key.name === 'down')
+        return { kind: 'move', state: { ...state, index: n ? (idx + 1) % n : 0 } };
+    if (key.name === 'backspace')
+        return { kind: 'move', state: { ...state, query: state.query.slice(0, -1), index: 0 } };
+    // A single printable character extends the type-to-filter query (control sequences are ignored).
+    const ch = key.sequence;
+    if (ch && ch.length === 1 && ch >= ' ' && !key.ctrl) {
+        return { kind: 'move', state: { ...state, query: state.query + ch, index: 0 } };
+    }
+    return { kind: 'move', state };
+}
+/** Pure renderer: the lines to draw (no ANSI; the I/O layer colors them). First line is the label. */
+export function renderSelectLines(label, state, marker = '>') {
+    const visible = filterItems(state.items, state.query);
+    const head = state.query ? `${label}  (filter: ${state.query})` : label;
+    if (!visible.length)
+        return [head, '  (no matches — backspace to clear)'];
+    const idx = Math.min(state.index, visible.length - 1);
+    return [head, ...visible.map((it, i) => {
+            const hint = it.hint ? `   ${it.hint}` : '';
+            return `${i === idx ? `${marker} ` : '  '}${it.label}${hint}`;
+        })];
+}