@manishbht/helpcode 0.2.3 → 0.3.5

package/dist/src/core/cockpitHtml.js

@@ -0,0 +1,395 @@
+/**
+ * Cockpit HTML view — `helpcode cockpit --html`.
+ *
+ * Reproduces the original orchestration-cockpit mockup's mission-control layout
+ * (1fr 2fr 1fr grid: flanking LLM panels, central orchestrator + metrics +
+ * pipeline, bottom row of activity/routing panels), filled with REAL data from
+ * the sous-chef event log where we have it.
+ *
+ * Honesty principle: workers that actually ran (local qwen, remote Gemini) are
+ * shown live. Panels for providers/features we haven't built (DeepSeek, Kimi,
+ * Claude-as-orchestrated, the autonomous pipeline, complexity-based routing)
+ * are rendered faithfully to the mockup but marked "demo" — a vision view with
+ * real data layered in as we build, not theatre passed off as live.
+ *
+ * View-model shaping is separated from HTML string-building for unit testing.
+ */
+import { summariseWorkers, sessionMetrics } from './cockpit.js';
+const RECENT_CAP = 12;
+function tierLabel(kind) {
+    switch (kind) {
+        case 'local': return 'local';
+        case 'remote': return 'free-tier';
+        case 'principal': return 'paid';
+        case 'deterministic': return 'code';
+    }
+}
+function comingCatalogue() {
+    return [
+        { name: 'Complexity scorer', note: 'route by task difficulty (mockup: 0.87 vs 0.75 threshold)' },
+        { name: 'Cross-model review', note: 'one model reviews another before it reaches you' },
+        { name: 'More providers', note: 'DeepSeek, Groq, Kimi — each just another SousChef' },
+        { name: 'Live quota bars', note: 'real per-provider free-tier usage tracking' },
+    ];
+}
+export function buildCockpitViewModel(log) {
+    const workers = summariseWorkers(log).map(w => ({
+        model: w.model ?? tierLabel(w.kind),
+        kind: w.kind,
+        tierLabel: tierLabel(w.kind),
+        events: w.eventsThisSession,
+        lastSummary: w.lastSummary,
+        quotaUsed: w.quotaUsed,
+    }));
+    const recent = [...log]
+        .sort((a, b) => a.at.localeCompare(b.at))
+        .slice(-RECENT_CAP)
+        .map(e => ({
+        time: e.at.slice(11, 16),
+        who: e.model ?? tierLabel(e.worker),
+        summary: e.summary,
+        outcome: e.outcome,
+    }));
+    // CLI shell lines: render the real event stream as helpcode terminal output.
+    const cli = buildCliLines(log);
+    return {
+        workers,
+        metrics: sessionMetrics(log),
+        recent,
+        cli,
+        coming: comingCatalogue(),
+        generatedAt: new Date().toISOString(),
+    };
+}
+/** Map the verb for a task, for terminal-style output. */
+function taskVerb(task) {
+    switch (task) {
+        case 'file_selection': return 'select';
+        case 'output_triage': return 'triage';
+        case 'decomposition': return 'plan';
+        default: return 'prep';
+    }
+}
+/** Turn the real event log into helpcode-shell-style terminal lines. */
+export function buildCliLines(log) {
+    if (log.length === 0) {
+        return [
+            { kind: 'prefix', text: '$ helpcode ask "..."' },
+            { kind: 'dim', text: '  no sous-chef activity yet this session' },
+            { kind: 'dim', text: '  run helpcode ask / plan to put the kitchen to work' },
+        ];
+    }
+    const recent = [...log].sort((a, b) => a.at.localeCompare(b.at)).slice(-8);
+    const lines = [];
+    for (const e of recent) {
+        const who = e.model ?? tierLabel(e.worker);
+        const verb = taskVerb(e.task);
+        if (e.outcome === 'ok') {
+            lines.push({ kind: 'ok', text: `  \u2714 ${verb} \u2192 ${who} (${tierLabel(e.worker)}) \u00b7 ${e.summary}` });
+        }
+        else if (e.outcome === 'escalated') {
+            lines.push({ kind: 'warn', text: `  \u2191 ${verb} escalated \u2192 principal \u00b7 ${e.summary}` });
+        }
+        else {
+            lines.push({ kind: 'dim', text: `  \u00b7 ${verb} fell back \u2192 ${who} \u00b7 ${e.summary}` });
+        }
+    }
+    return lines;
+}
+// --- HTML rendering -------------------------------------------------------
+function esc(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function badgeFor(kind) {
+    if (kind === 'remote')
+        return { cls: 'badge-free', label: 'free' };
+    if (kind === 'principal')
+        return { cls: 'badge-paid', label: 'paid' };
+    if (kind === 'deterministic')
+        return { cls: 'badge-demo', label: 'code' };
+    return { cls: 'badge-active', label: 'local' };
+}
+/** A live worker panel (real data), color-coded by worker kind. */
+function livePanel(p) {
+    const b = badgeFor(p.kind);
+    // Panel border/glow encodes worker kind: local=cyan(working), remote=green, code=amber.
+    const stateClass = p.kind === 'local' ? 'working'
+        : p.kind === 'remote' ? 'remote-active'
+            : p.kind === 'deterministic' ? 'fallback-active'
+                : 'active';
+    // Task chip colour by the kind of work last done (inferred from summary).
+    const chipClass = /triag/i.test(p.lastSummary ?? '') ? 'reviewing'
+        : /step|breakdown|plan/i.test(p.lastSummary ?? '') ? 'plan'
+            : 'writing';
+    // Token/usage bar colour by level (matches the original's green/amber/red).
+    let fillClass = 'green';
+    let pct;
+    if (p.quotaUsed !== null) {
+        pct = Math.round(p.quotaUsed * 100);
+        fillClass = pct > 80 ? 'red' : pct > 50 ? 'amber' : 'green';
+    }
+    else {
+        pct = Math.min(100, p.events * 20);
+    }
+    const barLabel = p.quotaUsed !== null
+        ? `<span>quota</span><span>${pct}%</span>`
+        : `<span>tasks</span><span>${p.events}</span>`;
+    return `
+    <div class="llm-panel ${stateClass}">
+      <div class="panel-header">
+        <span class="panel-name">${esc(p.model)}</span>
+        <span class="panel-tier badge ${b.cls}">${b.label}</span>
+      </div>
+      <div class="token-bar-wrap"><div class="token-label">${barLabel}</div><div class="token-bar"><div class="token-fill ${fillClass}" style="width:${pct}%"></div></div></div>
+      <div class="task-chip ${chipClass}">${p.events} task(s) · ${esc(p.tierLabel)}</div>
+      <div class="panel-log">
+        <div class="log-line"><span class="log-msg ok">${p.lastSummary ? esc(p.lastSummary) : 'idle'}</span></div>
+      </div>
+    </div>`;
+}
+/** A demo panel for an unbuilt provider — faithful to the mockup, marked demo. */
+function demoPanel(name, tier, note) {
+    const cls = tier === 'paid' ? 'badge-paid' : 'badge-free';
+    // The paid tier is the principal (Claude) — give it the brick glow, not greyed.
+    const panelClass = tier === 'paid' ? 'principal' : 'demo';
+    return `
+    <div class="llm-panel ${panelClass}">
+      <span class="demo-tag">demo</span>
+      <div class="panel-header">
+        <span class="panel-name">${esc(name)}</span>
+        <span class="panel-tier badge ${cls}">${tier}</span>
+      </div>
+      <div class="token-bar-wrap"><div class="token-label"><span>${tier === 'paid' ? 'principal' : 'quota'}</span><span>—</span></div><div class="token-bar"><div class="token-fill ${tier === 'paid' ? 'red' : 'green'}" style="width:0%"></div></div></div>
+      <div class="task-chip idle">${tier === 'paid' ? 'copy-paste · you stay in the loop' : 'not yet built'}</div>
+      <div class="panel-log"><div class="log-line"><span class="log-msg">${esc(note)}</span></div></div>
+    </div>`;
+}
+function feedRows(items) {
+    if (items.length === 0) {
+        return '<div class="demo-overlay">No activity yet — run helpcode ask / plan</div>';
+    }
+    return items.map(i => {
+        const cls = i.outcome === 'ok' ? 'ok' : i.outcome === 'escalated' ? 'warn' : '';
+        return `<div class="feed-row"><span class="log-ts">${esc(i.time)}</span><span class="log-msg ${cls}">${esc(i.who)}</span><span class="log-msg">${esc(i.summary)}</span></div>`;
+    }).join('');
+}
+export function renderCockpitHtml(vm) {
+    const m = vm.metrics;
+    // Real workers fill the left column (up to 2); a third real worker (or demo) goes right.
+    const live = vm.workers.map(livePanel);
+    const leftPanels = live.slice(0, 2).join('') || demoPanel('helpcode-local', 'free', 'run a task to populate');
+    const rightPanels = [
+        live[2] ?? demoPanel('Claude', 'paid', 'the principal · your copy-paste brain'),
+        demoPanel('DeepSeek v3', 'free', 'second free provider — coming'),
+    ].join('');
+    const realCount = vm.workers.length;
+    const css = `*{box-sizing:border-box;margin:0;padding:0}
+:root{
+  --bg:#0a0c10;--bg2:#111318;--bg3:#181b22;--bg4:#1e2129;
+  --border:#ffffff14;--border2:#ffffff22;--border3:#ffffff33;
+  --text:#e8eaf0;--text2:#9aa0b0;--text3:#5a6070;
+  --green:#22c55e;--green2:#16a34a;--green-dim:#052e16;
+  --amber:#f59e0b;--amber-dim:#1c1200;
+  --blue:#3b82f6;--blue-dim:#0a1628;
+  --purple:#a78bfa;--purple-dim:#1a1040;
+  --cyan:#06b6d4;--cyan-dim:#042830;
+  --red:#ef4444;--red-dim:#1c0a0a;
+  --brick:#cc785c;--brick2:#da7756;--brick-dim:#2a1610;
+  --font-mono:'JetBrains Mono','Fira Mono','Courier New',monospace;
+}
+body{background:var(--bg);color:var(--text);font-family:'system-ui',sans-serif;font-size:13px;min-height:800px;padding:12px;display:flex;flex-direction:column;gap:8px}
+.sr-only{position:absolute;width:1px;height:1px;overflow:hidden}
+.topbar{display:flex;align-items:center;justify-content:space-between;padding:8px 12px;background:var(--bg2);border:0.5px solid var(--border);border-radius:8px}
+.topbar-left{display:flex;align-items:center;gap:12px}
+.logo{font-size:15px;font-weight:500;letter-spacing:-0.3px}
+.logo span{color:var(--brick2)}
+.badge{font-size:10px;padding:2px 7px;border-radius:4px;font-weight:500;letter-spacing:0.3px}
+.badge-free{background:var(--green-dim);color:var(--green);border:0.5px solid var(--green2)}
+.badge-paid{background:var(--brick-dim);color:var(--brick2);border:0.5px solid var(--brick)}
+.badge-active{background:var(--blue-dim);color:var(--blue);border:0.5px solid #185fa5}
+.badge-demo{background:var(--bg3);color:var(--text3);border:0.5px solid var(--border2)}
+.topbar-right{display:flex;align-items:center;gap:8px}
+.dot{width:7px;height:7px;border-radius:50%;background:var(--green)}
+.dot.amber{background:var(--amber)}
+.dot.pulse{animation:pulse 2s ease-in-out infinite}
+@keyframes pulse{0%,100%{opacity:1}50%{opacity:.4}}
+.status-text{font-size:11px;color:var(--text2)}
+.cockpit{display:grid;grid-template-columns:1fr 2fr 1fr;grid-template-rows:auto auto;gap:8px;flex:1}
+.llm-panel{background:var(--bg2);border:0.5px solid var(--border);border-radius:8px;padding:10px;display:flex;flex-direction:column;gap:6px;min-height:160px;position:relative}
+.llm-panel.active{border-color:var(--border2)}
+.llm-panel.working{border-color:var(--cyan);box-shadow:0 0 0 1px var(--cyan-dim)}
+.llm-panel.remote-active{border-color:var(--green2);box-shadow:0 0 0 1px var(--green-dim)}
+.llm-panel.fallback-active{border-color:var(--amber);box-shadow:0 0 0 1px var(--amber-dim)}
+.llm-panel.principal{border-color:var(--brick);box-shadow:0 0 0 1px var(--brick-dim);opacity:.7}
+.llm-panel.demo{opacity:.5}
+.demo-tag{position:absolute;top:8px;right:8px;font-size:8px;padding:1px 5px;border-radius:3px;background:var(--bg4);color:var(--text3);border:0.5px solid var(--border2);text-transform:uppercase;letter-spacing:.5px}
+.panel-header{display:flex;align-items:center;justify-content:space-between}
+.panel-name{font-size:11px;font-weight:500;color:var(--text2);letter-spacing:0.4px;text-transform:uppercase}
+.panel-tier{font-size:9px;padding:1px 5px;border-radius:3px}
+.token-bar-wrap{display:flex;flex-direction:column;gap:2px}
+.token-label{display:flex;justify-content:space-between;font-size:9px;color:var(--text3)}
+.token-bar{height:3px;background:var(--bg4);border-radius:2px;overflow:hidden}
+.token-fill{height:100%;border-radius:2px;transition:width 1.2s ease}
+.token-fill.green{background:var(--green)}
+.token-fill.amber{background:var(--amber)}
+.token-fill.blue{background:var(--blue)}
+.token-fill.red{background:var(--red)}
+.panel-log{flex:1;font-family:var(--font-mono);font-size:9px;color:var(--text3);line-height:1.6;overflow:hidden;display:flex;flex-direction:column;padding-top:2px}
+.log-line{display:flex;gap:4px}
+.log-ts{color:var(--text3);flex-shrink:0}
+.log-msg{color:var(--text2)}
+.log-msg.ok{color:var(--green)}
+.log-msg.warn{color:var(--amber)}
+.log-msg.info{color:var(--cyan)}
+.task-chip{display:inline-flex;align-items:center;gap:4px;font-size:9px;padding:2px 6px;border-radius:3px;margin-top:2px;border:0.5px solid}
+.task-chip.writing{background:var(--blue-dim);color:var(--blue);border-color:var(--blue)}
+.task-chip.reviewing{background:var(--purple-dim);color:var(--purple);border-color:var(--purple)}
+.task-chip.plan{background:var(--cyan-dim);color:var(--cyan);border-color:var(--cyan)}
+.task-chip.idle{background:var(--bg3);color:var(--text3);border-color:var(--border)}
+.center-col{display:flex;flex-direction:column;gap:8px}
+.orchestrator{background:var(--bg2);border:0.5px solid var(--border2);border-radius:8px;padding:10px;display:flex;flex-direction:column;gap:8px;position:relative}
+.orch-header{display:flex;align-items:center;justify-content:space-between}
+.orch-title{font-size:12px;font-weight:500;color:var(--cyan)}
+.orch-subtitle{font-size:10px;color:var(--text3)}
+.pipeline{display:flex;flex-direction:column;gap:4px}
+.pipe-row{display:flex;align-items:center;gap:6px;padding:5px 8px;background:var(--bg3);border-radius:5px;border:0.5px solid var(--border)}
+.pipe-num{font-size:9px;color:var(--text3);width:14px;flex-shrink:0;font-family:var(--font-mono)}
+.pipe-name{font-size:10px;color:var(--text);flex:1;font-weight:500}
+.pipe-assign{font-size:9px;color:var(--text3)}
+.pipe-status{font-size:9px;padding:1px 5px;border-radius:3px;flex-shrink:0;font-weight:500}
+.pipe-status.done{background:var(--green-dim);color:var(--green)}
+.pipe-status.queued{background:var(--bg4);color:var(--text3)}
+.pipe-arrow{font-size:8px;color:var(--text3);flex-shrink:0}
+.metrics-row{display:grid;grid-template-columns:repeat(4,1fr);gap:6px}
+.metric{background:var(--bg3);border-radius:6px;padding:7px 10px;display:flex;flex-direction:column;gap:2px}
+.metric-label{font-size:9px;color:var(--text3);text-transform:uppercase;letter-spacing:0.4px}
+.metric-val{font-size:17px;font-weight:500;color:var(--text);line-height:1}
+.metric-sub{font-size:9px;color:var(--text3)}
+.metric-val.green{color:var(--green)}
+.metric-val.amber{color:var(--amber)}
+.metric-val.blue{color:var(--blue)}
+.metric-val.purple{color:var(--purple)}
+.cli-panel{background:var(--bg2);border:0.5px solid var(--border);border-radius:8px;padding:10px;flex:1;display:flex;flex-direction:column}
+.cli-header{font-size:10px;color:var(--text3);margin-bottom:6px;display:flex;align-items:center;gap:6px}
+.cli-dot{width:6px;height:6px;border-radius:50%}
+.cli-output{flex:1;font-family:var(--font-mono);font-size:10px;line-height:1.7;color:var(--text2);overflow:hidden}
+.cli-line-prefix{color:var(--cyan)}
+.cli-line-ok{color:var(--green)}
+.cli-line-warn{color:var(--amber)}
+.cli-line-dim{color:var(--text3)}
+.cli-input-row{display:flex;align-items:center;gap:6px;margin-top:8px;border-top:0.5px solid var(--border);padding-top:8px}
+.cli-prompt{font-family:var(--font-mono);font-size:10px;color:var(--cyan);flex-shrink:0}
+.cli-input{flex:1;background:transparent;border:none;outline:none;font-family:var(--font-mono);font-size:10px;color:var(--text3)}
+@keyframes blink{0%,100%{opacity:1}50%{opacity:0}}
+.cursor{animation:blink 1s step-end infinite;color:var(--cyan)}
+.bottom-row{display:grid;grid-template-columns:1fr 2fr 1fr;gap:8px}
+.side-panel{background:var(--bg2);border:0.5px solid var(--border);border-radius:8px;padding:10px;display:flex;flex-direction:column;gap:6px;position:relative}
+.side-panel.live{border-left:2px solid var(--green)}
+.side-panel.routing{border-left:2px solid var(--cyan)}
+.side-panel.roadmap{border-left:2px solid var(--text3);opacity:.7}
+.side-title{font-size:10px;font-weight:500;color:var(--text2);display:flex;align-items:center;gap:5px}
+.feed-row{display:flex;gap:6px;font-size:9px;padding:3px 0;border-bottom:0.5px solid var(--border);font-family:var(--font-mono)}
+.feed-row:last-child{border-bottom:none}
+.router-rule{display:flex;align-items:center;gap:6px;font-size:9px;padding:4px 6px;background:var(--bg3);border-radius:4px}
+.router-cond{color:var(--text2);flex:1}
+.router-then{color:var(--cyan)}
+.router-arrow{color:var(--text3)}
+.demo-overlay{font-size:8px;color:var(--text3);text-align:center;padding-top:4px;font-style:italic}
+@keyframes spin{to{transform:rotate(360deg)}}
+.spinner{display:inline-block;animation:spin 1s linear infinite;font-size:10px}
+footer{color:var(--text3);font-size:10px;margin-top:4px;padding:8px 4px;text-align:center}`;
+    return `<!DOCTYPE html>
+<html lang="en"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>helpcode cockpit</title>
+<style>${css}</style></head>
+<body>
+<h2 class="sr-only">helpcode cockpit — sous-chef kitchen, real activity plus roadmap</h2>
+
+<div class="topbar">
+  <div class="topbar-left">
+    <span class="logo">help<span>code</span></span>
+    <span class="badge badge-active">cockpit</span>
+    <span class="badge badge-free">${realCount} worker(s) active</span>
+  </div>
+  <div class="topbar-right">
+    <div class="dot pulse"></div>
+    <span class="status-text">${m.totalEvents} prep task(s) this session · ~${m.estTokensSaved} principal tokens saved</span>
+  </div>
+</div>
+
+<div class="cockpit">
+  <div style="display:flex;flex-direction:column;gap:8px">${leftPanels}</div>
+
+  <div class="center-col">
+    <div class="metrics-row">
+      <div class="metric"><span class="metric-label">prep tasks</span><span class="metric-val blue">${m.totalEvents}</span><span class="metric-sub">this session</span></div>
+      <div class="metric"><span class="metric-label">escalated</span><span class="metric-val amber">${m.escalations}</span><span class="metric-sub">to principal</span></div>
+      <div class="metric"><span class="metric-label">fell back</span><span class="metric-val purple">${m.fallbacks}</span><span class="metric-sub">to cheaper</span></div>
+      <div class="metric"><span class="metric-label">tokens saved</span><span class="metric-val green">~${m.estTokensSaved}</span><span class="metric-sub">principal</span></div>
+    </div>
+
+    <div class="orchestrator">
+      <span class="demo-tag">demo</span>
+      <div class="orch-header">
+        <div>
+          <div class="orch-title">orchestrator · autonomous pipeline</div>
+          <div class="orch-subtitle">vision: decompose → assign → escalate (not yet built)</div>
+        </div>
+        <span class="badge badge-demo">roadmap</span>
+      </div>
+      <div class="pipeline">
+        <div class="pipe-row"><span class="pipe-num">01</span><span class="pipe-name">decompose task → subtasks</span><span class="pipe-assign">local</span><span class="pipe-arrow">→</span><span class="pipe-status done">live</span></div>
+        <div class="pipe-row"><span class="pipe-num">02</span><span class="pipe-name">assign by complexity score</span><span class="pipe-assign">router</span><span class="pipe-arrow">→</span><span class="pipe-status queued">coming</span></div>
+        <div class="pipe-row"><span class="pipe-num">03</span><span class="pipe-name">cross-model review</span><span class="pipe-assign">peer</span><span class="pipe-arrow">→</span><span class="pipe-status queued">coming</span></div>
+        <div class="pipe-row"><span class="pipe-num">04</span><span class="pipe-name">escalate hard subtasks → principal</span><span class="pipe-assign">you (paste)</span><span class="pipe-arrow">→</span><span class="pipe-status queued">coming</span></div>
+      </div>
+    </div>
+
+    <div class="cli-panel">
+      <div class="cli-header">
+        <div class="cli-dot" style="background:#ef4444"></div>
+        <div class="cli-dot" style="background:#f59e0b"></div>
+        <div class="cli-dot" style="background:#22c55e"></div>
+        <span style="margin-left:6px;font-size:10px;color:var(--text3)">helpcode · sous-chef shell · live</span>
+      </div>
+      <div class="cli-output">
+        \${vm.cli.map(l => \`<div class="cli-line-\${l.kind}">\${esc(l.text)}</div>\`).join('')}
+      </div>
+      <div class="cli-input-row">
+        <span class="cli-prompt">\u276f</span>
+        <span class="cli-input">helpcode cockpit<span class="cursor">_</span></span>
+      </div>
+    </div>
+  </div>
+
+  <div style="display:flex;flex-direction:column;gap:8px">${rightPanels}</div>
+</div>
+
+<div class="bottom-row">
+  <div class="side-panel live">
+    <div class="side-title">recent activity · live</div>
+    ${feedRows(vm.recent)}
+  </div>
+
+  <div class="side-panel routing">
+    <span class="demo-tag">part live</span>
+    <div class="side-title">routing rules · current policy</div>
+    <div class="router-rule"><span class="router-cond">no code, no key</span><span class="router-arrow">→</span><span class="router-then">local only (live)</span></div>
+    <div class="router-rule"><span class="router-cond">key, no opt-in</span><span class="router-arrow">→</span><span class="router-then">remote: decomposition only (live)</span></div>
+    <div class="router-rule"><span class="router-cond">allowRemoteCode on</span><span class="router-arrow">→</span><span class="router-then">remote: code tasks too (live)</span></div>
+    <div class="router-rule"><span class="router-cond">complexity &gt; threshold</span><span class="router-arrow">→</span><span class="router-then">escalate to principal (coming)</span></div>
+    <div class="demo-overlay">first three rules are live; complexity routing is roadmap</div>
+  </div>
+
+  <div class="side-panel roadmap">
+    <span class="demo-tag">demo</span>
+    <div class="side-title">roadmap</div>
+    ${vm.coming.map(c => `<div class="router-rule"><span class="router-cond">${esc(c.name)}</span></div>`).join('')}
+  </div>
+</div>
+
+<footer>helpcode · principal + sous-chefs · live panels reflect this project's real activity; "demo" panels show the roadmap. generated ${esc(vm.generatedAt.slice(0, 16).replace('T', ' '))}</footer>
+</body></html>`;
+}
+//# sourceMappingURL=cockpitHtml.js.map

package/dist/src/core/cockpitHtml.js.map

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

package/dist/src/core/consent.d.ts

@@ -0,0 +1,20 @@
+/**
+ * One-time consent notice for sending source code to a remote free tier (v0.3.2).
+ *
+ * The privacy gate (core/souschef.ts) decides whether a task MAY go remote. This
+ * module decides whether to SHOW THE USER A NOTICE the first time code actually
+ * leaves the machine to a free tier — informed consent, per the design doc.
+ *
+ * The notice fires when ALL of:
+ *   - allowRemoteCode is on (the user opted in)
+ *   - the task is code-bearing (not decomposition, which never sends code)
+ *   - we haven't already shown it (tracked in state)
+ */
+import { SousChefTask } from '../types.js';
+export interface RemoteCodeNoticeInput {
+    allowRemoteCode: boolean;
+    task: SousChefTask;
+    alreadyShown: boolean;
+}
+export declare function shouldShowRemoteCodeNotice(input: RemoteCodeNoticeInput): boolean;
+export declare function remoteCodeNoticeText(model: string): string;

package/dist/src/core/consent.js

@@ -0,0 +1,34 @@
+/**
+ * One-time consent notice for sending source code to a remote free tier (v0.3.2).
+ *
+ * The privacy gate (core/souschef.ts) decides whether a task MAY go remote. This
+ * module decides whether to SHOW THE USER A NOTICE the first time code actually
+ * leaves the machine to a free tier — informed consent, per the design doc.
+ *
+ * The notice fires when ALL of:
+ *   - allowRemoteCode is on (the user opted in)
+ *   - the task is code-bearing (not decomposition, which never sends code)
+ *   - we haven't already shown it (tracked in state)
+ */
+/** Code-bearing tasks — these send source code, unlike decomposition. */
+function isCodeBearing(task) {
+    return task !== 'decomposition';
+}
+export function shouldShowRemoteCodeNotice(input) {
+    if (!input.allowRemoteCode)
+        return false;
+    if (!isCodeBearing(input.task))
+        return false;
+    if (input.alreadyShown)
+        return false;
+    return true;
+}
+export function remoteCodeNoticeText(model) {
+    return [
+        'Heads up: allowRemoteCode is on, so helpcode is about to send source code',
+        `to a remote free tier (${model}). Free-tier providers may use your inputs to`,
+        'train their models. Only proceed if you accept your code leaving this machine.',
+        'Disable any time by setting "allowRemoteCode": false in .helpcode/project.json.',
+    ].join('\n');
+}
+//# sourceMappingURL=consent.js.map

package/dist/src/core/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../../src/core/consent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,yEAAyE;AACzE,SAAS,aAAa,CAAC,IAAkB;IACvC,OAAO,IAAI,KAAK,eAAe,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAA4B;IACrE,IAAI,CAAC,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO;QACL,2EAA2E;QAC3E,0BAA0B,KAAK,+CAA+C;QAC9E,gFAAgF;QAChF,iFAAiF;KAClF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/core/decompose.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Task decomposition (v0.3.1) — the third local sous-chef task.
+ *
+ * A big, sprawling task ("add auth: login, logout, reset, sessions") produces a
+ * sprawling brief and a sprawling Claude reply. Decomposition asks the local
+ * model to break it into ordered, focused sub-steps, so the principal can be
+ * given ONE step at a time.
+ *
+ * CRITICAL constraint (from the design doc): decomposition PROPOSES, the human
+ * APPROVES. It never autonomously runs the steps. `helpcode plan` prints the
+ * breakdown and stops. This keeps helpcode in-the-loop, not an autonomous agent.
+ *
+ * Unlike selection (keyword fallback) and triage (truncation fallback), there
+ * is no sensible deterministic fallback for decomposition — you can't split a
+ * task into meaningful steps without understanding it. So if the local model
+ * is unavailable, decomposition honestly reports ok=false and the user just
+ * proceeds with their task as a single unit. Doing nothing is the safe fallback.
+ */
+import { OllamaSettings } from '../types.js';
+export interface DecompositionResult {
+    ok: boolean;
+    /** Ordered sub-steps (empty if ok is false). */
+    steps: string[];
+    /** If ok is false, why. Empty otherwise. */
+    reason: string;
+}
+type GenerateImpl = (host: string, model: string, prompt: string, opts?: {
+    timeoutMs?: number;
+}) => Promise<string>;
+export interface DecomposeDeps {
+    generateImpl?: GenerateImpl;
+}
+export declare function buildDecompositionPrompt(task: string): string;
+/**
+ * Parse a numbered/bulleted list of steps from the model's response. Tolerant
+ * of prose around the list, various markers (1. / 1) / -), and markdown bold.
+ */
+export declare function parseDecomposition(response: string): string[];
+/**
+ * Decompose a task using the local model. Proposes only — never runs anything.
+ * ok=false when: ollama disabled, model failed, or the result was a single step
+ * (i.e. decomposition added no value). The caller then just proceeds normally.
+ */
+export declare function decomposeTask(task: string, ollama: OllamaSettings, deps?: DecomposeDeps): Promise<DecompositionResult>;
+export {};

package/dist/src/core/decompose.js

@@ -0,0 +1,86 @@
+/**
+ * Task decomposition (v0.3.1) — the third local sous-chef task.
+ *
+ * A big, sprawling task ("add auth: login, logout, reset, sessions") produces a
+ * sprawling brief and a sprawling Claude reply. Decomposition asks the local
+ * model to break it into ordered, focused sub-steps, so the principal can be
+ * given ONE step at a time.
+ *
+ * CRITICAL constraint (from the design doc): decomposition PROPOSES, the human
+ * APPROVES. It never autonomously runs the steps. `helpcode plan` prints the
+ * breakdown and stops. This keeps helpcode in-the-loop, not an autonomous agent.
+ *
+ * Unlike selection (keyword fallback) and triage (truncation fallback), there
+ * is no sensible deterministic fallback for decomposition — you can't split a
+ * task into meaningful steps without understanding it. So if the local model
+ * is unavailable, decomposition honestly reports ok=false and the user just
+ * proceeds with their task as a single unit. Doing nothing is the safe fallback.
+ */
+import { generate, OllamaError } from './ollama.js';
+export function buildDecompositionPrompt(task) {
+    return [
+        'Break the following software task into a short ordered list of focused,',
+        'self-contained sub-steps. Each step should be something that could be',
+        'tackled in a single round with a coding assistant. Aim for 2-6 steps.',
+        'If the task is already small enough, return a single step.',
+        '',
+        'Respond ONLY with a numbered list, one step per line, no preamble:',
+        '  1. first step',
+        '  2. second step',
+        '',
+        `TASK: ${task}`,
+    ].join('\n');
+}
+/**
+ * Parse a numbered/bulleted list of steps from the model's response. Tolerant
+ * of prose around the list, various markers (1. / 1) / -), and markdown bold.
+ */
+export function parseDecomposition(response) {
+    const steps = [];
+    for (const rawLine of response.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        // Match a leading list marker: "1." / "1)" / "-" / "*"
+        const m = line.match(/^(?:\d+[.)]|[-*])\s+(.*)$/);
+        if (!m)
+            continue;
+        let text = m[1].trim();
+        // Strip surrounding markdown emphasis (**bold**, *italic*, `code`)
+        text = text.replace(/\*\*(.*?)\*\*/g, '$1')
+            .replace(/\*(.*?)\*/g, '$1')
+            .replace(/`(.*?)`/g, '$1')
+            .trim();
+        if (text)
+            steps.push(text);
+    }
+    return steps;
+}
+/**
+ * Decompose a task using the local model. Proposes only — never runs anything.
+ * ok=false when: ollama disabled, model failed, or the result was a single step
+ * (i.e. decomposition added no value). The caller then just proceeds normally.
+ */
+export async function decomposeTask(task, ollama, deps = {}) {
+    if (!ollama.enabled) {
+        return { ok: false, steps: [], reason: 'local model not enabled' };
+    }
+    const generateImpl = deps.generateImpl ?? generate;
+    let response;
+    try {
+        response = await generateImpl(ollama.host, ollama.model, buildDecompositionPrompt(task), { timeoutMs: ollama.timeoutMs });
+    }
+    catch (e) {
+        const why = e instanceof OllamaError ? e.message : e.message;
+        return { ok: false, steps: [], reason: `local model failed: ${why}` };
+    }
+    const steps = parseDecomposition(response);
+    if (steps.length === 0) {
+        return { ok: false, steps: [], reason: 'no steps parsed from model output' };
+    }
+    if (steps.length === 1) {
+        return { ok: false, steps, reason: 'task came back as a single step — not worth decomposing' };
+    }
+    return { ok: true, steps, reason: '' };
+}
+//# sourceMappingURL=decompose.js.map

package/dist/src/core/decompose.js.map

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