@manishbht/helpcode 0.2.3 → 0.3.4

package/dist/src/core/souschef.js

@@ -0,0 +1,55 @@
+/**
+ * The sous-chef layer (v0.3.2) — makes local and remote workers interchangeable
+ * behind one interface, with a privacy gate and cheapest-capable-first routing.
+ *
+ * Design doc: docs/v0.3.2-remote-souschef-design.md
+ *
+ * The privacy gate is the load-bearing rule: a REMOTE free-tier worker may only
+ * receive data the user has accepted leaving the machine. By default that means
+ * decomposition only (input is the task description, not code). A per-project
+ * `allowRemoteCode` opt-in lets consenting users route code-bearing tasks too.
+ *
+ * Routing is cheapest-capable-first: local before remote. A remote worker is
+ * only chosen when (a) the privacy gate permits the task, (b) no local worker
+ * can handle it, and (c) the worker's own canHandle() says yes (e.g. has quota).
+ */
+/**
+ * The privacy gate. Which tasks may a REMOTE worker receive?
+ * - decomposition: always (input is the user's task description, no code)
+ * - everything else: only if the project opted into allowRemoteCode
+ *
+ * Local workers are never gated by this — code never leaves the machine.
+ */
+export function isRemoteAllowedForTask(task, allowRemoteCode) {
+    if (task === 'decomposition')
+        return true;
+    return allowRemoteCode;
+}
+/**
+ * Can this specific worker handle this task, accounting for privacy AND the
+ * worker's own availability veto?
+ */
+export function canWorkerHandle(worker, task, ctx) {
+    if (worker.kind === 'remote' && !isRemoteAllowedForTask(task, ctx.allowRemoteCode)) {
+        return false;
+    }
+    return worker.canHandle(task, ctx);
+}
+/**
+ * Pick the cheapest capable worker. Local workers are cheaper than remote, so
+ * they're preferred; within a kind, the first in the list wins (stable order).
+ * Returns null if nothing can handle the task.
+ */
+export function pickWorker(workers, task, ctx) {
+    const capable = workers.filter(w => canWorkerHandle(w, task, ctx));
+    if (capable.length === 0)
+        return null;
+    // local (cheaper) before remote; preserve input order within a kind.
+    const localFirst = [...capable].sort((a, b) => {
+        if (a.kind === b.kind)
+            return 0;
+        return a.kind === 'local' ? -1 : 1;
+    });
+    return localFirst[0];
+}
+//# sourceMappingURL=souschef.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"souschef.js","sourceRoot":"","sources":["../../../src/core/souschef.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiCH;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAkB,EAClB,eAAwB;IAExB,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAgB,EAChB,IAAkB,EAClB,GAAkB;IAElB,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACnF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,OAAmB,EACnB,IAAkB,EAClB,GAAkB;IAElB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,qEAAqE;IACrE,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5C,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

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

@@ -4,8 +4,20 @@
  * State is intentionally readable JSON. Users can `cat` it to see exactly
  * what helpcode is thinking. No black-box memory.
  */
-import { AgentState, CurrentTask } from '../types.js';
+import { AgentState, CurrentTask, SousChefEvent } from '../types.js';
 export declare function loadState(cwd?: string): AgentState;
 export declare function saveState(state: AgentState, cwd?: string): void;
+/**
+ * Append a sous-chef event to an in-memory state object (capped). Use this
+ * when the caller already holds a loaded state and will saveState() itself —
+ * avoids the read-modify-write clobber of two independent load/save cycles.
+ */
+export declare function appendSousChefEvent(state: AgentState, event: SousChefEvent): void;
+/**
+ * Append a sous-chef event and persist immediately. Use this only when the
+ * caller does NOT already hold a state it will save (standalone recording).
+ * If you have a loaded state, prefer appendSousChefEvent + your own saveState.
+ */
+export declare function recordSousChefEvent(event: SousChefEvent, cwd?: string): void;
 export declare function createTask(description: string): CurrentTask;
 export declare function resetState(cwd?: string): void;

package/dist/src/core/state.js

@@ -9,11 +9,14 @@ import * as path from 'path';
 import { HelpcodeError, ErrorCode } from '../lib/errors.js';
 const STATE_DIR = '.helpcode';
 const STATE_FILE = path.join(STATE_DIR, 'state.json');
+/** Keep the sous-chef log bounded so state.json stays small. */
+const MAX_SOUSCHEF_EVENTS = 50;
 function emptyState() {
     return {
-        version: 1,
+        version: 2,
         currentTask: null,
         history: [],
+        sousChefLog: [],
     };
 }
 export function loadState(cwd = process.cwd()) {
@@ -23,10 +26,7 @@ export function loadState(cwd = process.cwd()) {
     }
     try {
         const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
-        if (parsed.version !== 1) {
-            throw new HelpcodeError(ErrorCode.STATE_ERROR, `Unknown state version: ${parsed.version}`, 'This state was written by a different helpcode version. Run `helpcode reset` to start fresh.');
-        }
-        return parsed;
+        return migrate(parsed);
     }
     catch (e) {
         if (e instanceof HelpcodeError)
@@ -34,6 +34,27 @@ export function loadState(cwd = process.cwd()) {
         throw new HelpcodeError(ErrorCode.STATE_ERROR, `Could not parse state file: ${e.message}`, 'Run `helpcode reset` to start fresh (this won\'t touch your code).');
     }
 }
+/**
+ * Migrate older state forward. v1 had no sousChefLog; we add an empty one and
+ * bump the version rather than erroring, so existing installs keep working.
+ */
+function migrate(parsed) {
+    if (parsed.version === 2) {
+        // Defensive: ensure the log array exists even if hand-edited away.
+        if (!Array.isArray(parsed.sousChefLog))
+            parsed.sousChefLog = [];
+        return parsed;
+    }
+    if (parsed.version === 1) {
+        return {
+            version: 2,
+            currentTask: parsed.currentTask ?? null,
+            history: Array.isArray(parsed.history) ? parsed.history : [],
+            sousChefLog: [],
+        };
+    }
+    throw new HelpcodeError(ErrorCode.STATE_ERROR, `Unknown state version: ${parsed.version}`, 'This state was written by a newer helpcode. Upgrade, or run `helpcode reset`.');
+}
 export function saveState(state, cwd = process.cwd()) {
     const dir = path.join(cwd, STATE_DIR);
     if (!fs.existsSync(dir))
@@ -43,6 +64,27 @@ export function saveState(state, cwd = process.cwd()) {
     fs.writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf-8');
     fs.renameSync(tmp, file);
 }
+/**
+ * Append a sous-chef event to an in-memory state object (capped). Use this
+ * when the caller already holds a loaded state and will saveState() itself —
+ * avoids the read-modify-write clobber of two independent load/save cycles.
+ */
+export function appendSousChefEvent(state, event) {
+    state.sousChefLog.push(event);
+    if (state.sousChefLog.length > MAX_SOUSCHEF_EVENTS) {
+        state.sousChefLog = state.sousChefLog.slice(-MAX_SOUSCHEF_EVENTS);
+    }
+}
+/**
+ * Append a sous-chef event and persist immediately. Use this only when the
+ * caller does NOT already hold a state it will save (standalone recording).
+ * If you have a loaded state, prefer appendSousChefEvent + your own saveState.
+ */
+export function recordSousChefEvent(event, cwd = process.cwd()) {
+    const state = loadState(cwd);
+    appendSousChefEvent(state, event);
+    saveState(state, cwd);
+}
 export function createTask(description) {
     const now = new Date().toISOString();
     return {

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

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

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

@@ -16,8 +16,10 @@ import { OllamaSettings } from '../types.js';
 export interface TriageResult {
     /** The compacted output to put in the brief. */
     text: string;
-    /** True if the local model produced the summary; false if fallback. */
+    /** True if a model (local or remote) produced the summary; false if fallback. */
     triaged: boolean;
+    /** True if the remote model produced it (for the cockpit). */
+    remote?: boolean;
 }
 type GenerateImpl = (host: string, model: string, prompt: string, opts?: {
     timeoutMs?: number;
@@ -25,6 +27,12 @@ type GenerateImpl = (host: string, model: string, prompt: string, opts?: {
 export interface TriageDeps {
     /** Injectable model call for testing. Defaults to the real Ollama client. */
     generateImpl?: GenerateImpl;
+    /**
+     * Optional remote-model fallback (prompt → text). Supplied by the caller ONLY
+     * when allowRemoteCode is on and a key is present (triage output is
+     * code-bearing). Tried after local fails, before deterministic truncation.
+     */
+    remoteGenerate?: (prompt: string) => Promise<string>;
 }
 /** Is this output worth sending to the model? Long, and Ollama enabled. */
 export declare function shouldTriage(output: string, ollama: Pick<OllamaSettings, 'enabled'>): boolean;
@@ -32,6 +40,11 @@ export declare function buildTriagePrompt(output: string): string;
 /**
  * Triage command output. Returns a compacted version plus whether the model
  * was used. Never throws — any failure falls back to deterministic truncation.
+ *
+ * Order: local model → remote model (if provided; privacy-gated by the caller)
+ * → deterministic truncation. `deps.remoteGenerate` is supplied by the caller
+ * only when allowRemoteCode is on and a key is present — triage output can
+ * contain code, so it's code-bearing.
  */
 export declare function triageOutput(output: string, ollama: OllamaSettings, deps?: TriageDeps): Promise<TriageResult>;
 export {};

package/dist/src/core/triage.js

@@ -41,6 +41,11 @@ export function buildTriagePrompt(output) {
 /**
  * Triage command output. Returns a compacted version plus whether the model
  * was used. Never throws — any failure falls back to deterministic truncation.
+ *
+ * Order: local model → remote model (if provided; privacy-gated by the caller)
+ * → deterministic truncation. `deps.remoteGenerate` is supplied by the caller
+ * only when allowRemoteCode is on and a key is present — triage output can
+ * contain code, so it's code-bearing.
  */
 export async function triageOutput(output, ollama, deps = {}) {
     // Short output, or triage disabled: return as-is or truncate, no model.
@@ -51,19 +56,32 @@ export async function triageOutput(output, ollama, deps = {}) {
             : output;
         return { text, triaged: false };
     }
+    const prompt = buildTriagePrompt(output);
+    // 1. Local model (cheapest).
     const generateImpl = deps.generateImpl ?? generate;
     try {
-        const summary = await generateImpl(ollama.host, ollama.model, buildTriagePrompt(output), { timeoutMs: ollama.timeoutMs });
+        const summary = await generateImpl(ollama.host, ollama.model, prompt, { timeoutMs: ollama.timeoutMs });
         if (summary && summary.trim().length > 0) {
             return { text: summary.trim(), triaged: true };
         }
-        // Empty model result: fall back.
-        return { text: truncateLines(output, FALLBACK_MAX_LINES, 'lines'), triaged: false };
     }
     catch (e) {
-        // Transport/timeout/etc.: fall back to deterministic truncation.
         void (e instanceof OllamaError);
-        return { text: truncateLines(output, FALLBACK_MAX_LINES, 'lines'), triaged: false };
+        // fall through to remote / deterministic
+    }
+    // 2. Remote model, if the caller provided one (privacy-gated upstream).
+    if (deps.remoteGenerate) {
+        try {
+            const summary = await deps.remoteGenerate(prompt);
+            if (summary && summary.trim().length > 0) {
+                return { text: summary.trim(), triaged: true, remote: true };
+            }
+        }
+        catch {
+            // fall through to deterministic
+        }
     }
+    // 3. Deterministic truncation — always works.
+    return { text: truncateLines(output, FALLBACK_MAX_LINES, 'lines'), triaged: false };
 }
 //# sourceMappingURL=triage.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"triage.js","sourceRoot":"","sources":["../../../src/core/triage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,iEAAiE;AACjE,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,6CAA6C;AAC7C,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAqB9B,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,MAAuC;IAEvC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,sBAAsB,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO;QACL,6EAA6E;QAC7E,wEAAwE;QACxE,gEAAgE;QAChE,gCAAgC;QAChC,yFAAyF;QACzF,gDAAgD;QAChD,EAAE;QACF,gBAAgB;QAChB,MAAM;QACN,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,MAAsB,EACtB,OAAmB,EAAE;IAErB,wEAAwE;IACxE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC/C,MAAM,IAAI,GAAG,SAAS,GAAG,kBAAkB;YACzC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC;YACpD,CAAC,CAAC,MAAM,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,KAAK,EACZ,iBAAiB,CAAC,MAAM,CAAC,EACzB,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAChC,CAAC;QACF,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QACD,iCAAiC;QACjC,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACtF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,iEAAiE;QACjE,KAAK,CAAC,CAAC,YAAY,WAAW,CAAC,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACtF,CAAC;AACH,CAAC"}
+{"version":3,"file":"triage.js","sourceRoot":"","sources":["../../../src/core/triage.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -1,12 +1,13 @@
 /**
  * helpcode — CLI router.
  *
- * Six commands, kept deliberately small:
- *   init    detect project and set up .helpcode/
- *   ask     compose a prompt for Claude.ai
- *   apply   apply Claude's reply
- *   run     run a shell command, get compact output
- *   status  show current state
- *   reset   clear state
+ * Commands, kept deliberately small:
+ *   init     detect project and set up .helpcode/
+ *   ask      compose a prompt for Claude.ai
+ *   apply    apply Claude's reply
+ *   run      run a shell command, get compact output
+ *   status   show current state
+ *   cockpit  show the sous-chef kitchen this session (v0.3)
+ *   reset    clear state
  */
 export declare function run(argv: string[]): Promise<number>;

package/dist/src/index.js

@@ -1,23 +1,26 @@
 /**
  * helpcode — CLI router.
  *
- * Six commands, kept deliberately small:
- *   init    detect project and set up .helpcode/
- *   ask     compose a prompt for Claude.ai
- *   apply   apply Claude's reply
- *   run     run a shell command, get compact output
- *   status  show current state
- *   reset   clear state
+ * Commands, kept deliberately small:
+ *   init     detect project and set up .helpcode/
+ *   ask      compose a prompt for Claude.ai
+ *   apply    apply Claude's reply
+ *   run      run a shell command, get compact output
+ *   status   show current state
+ *   cockpit  show the sous-chef kitchen this session (v0.3)
+ *   reset    clear state
  */
 import { handleInit } from './commands/init.js';
 import { handleAsk } from './commands/ask.js';
 import { handleApply } from './commands/apply.js';
 import { handleRun } from './commands/run.js';
 import { handleStatus } from './commands/status.js';
+import { handlePlan } from './commands/plan.js';
+import { handleCockpit } from './commands/cockpit.js';
 import { handleReset } from './commands/reset.js';
 import { HelpcodeError } from './lib/errors.js';
 import { c, log } from './lib/ui.js';
-const VERSION = '0.2.3';
+const VERSION = '0.3.4';
 const HELP = `helpcode v${VERSION}
 
 A local agent that makes Claude.ai conversations efficient enough to ship
@@ -32,9 +35,11 @@ COMMANDS:
        --files <paths...>      include specific files (skips auto-selection)
        --no-llm                force keyword selection even if Ollama is on
        --explain-selection     show why each file was chosen
+  plan "<task>"              Propose an ordered breakdown of a big task (local model)
   apply [--yes] [--dry-run]  Apply Claude's pasted reply (from stdin)
   run "<command>"            Run a shell command, get compact output
   status                     Show current task and state
+  cockpit [--html] [--out F]  Show the kitchen; --html writes a visual cockpit
   reset [--yes]              Clear state (project config is untouched)
 
 GLOBAL FLAGS:
@@ -66,6 +71,10 @@ export async function run(argv) {
                     explainSelection: rest.includes('--explain-selection'),
                 });
             }
+            case 'plan': {
+                const task = rest.filter(a => !a.startsWith('--')).join(' ');
+                return await handlePlan(task);
+            }
             case 'apply':
                 return await handleApply({
                     yes: rest.includes('--yes'),
@@ -78,6 +87,10 @@ export async function run(argv) {
             }
             case 'status':
                 return await handleStatus();
+            case 'cockpit': {
+                const out = extractFlagValues(rest, '--out')[0];
+                return await handleCockpit({ html: rest.includes('--html'), out });
+            }
             case 'reset':
                 return await handleReset({ yes: rest.includes('--yes') });
             default:

package/dist/src/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/src/types.d.ts

@@ -19,6 +19,24 @@ export interface ProjectConfig {
     createdAt: string;
     /** Optional local-LLM (Ollama) settings for smarter file selection (v0.2). */
     ollama?: OllamaSettings;
+    /** Optional remote free-tier sous-chef settings (v0.3.2). */
+    remote?: RemoteSettings;
+}
+/**
+ * Remote free-tier sous-chef configuration (v0.3.2). Opt-in by presence of an
+ * API key (env var or .helpcode/keys.json) — this block only carries the
+ * privacy preference, never the key itself (keys must never touch project.json).
+ */
+export interface RemoteSettings {
+    /**
+     * Allow code-bearing tasks (file selection, output triage) to be sent to a
+     * remote FREE-TIER provider, whose terms may use inputs to train their models.
+     * Default false: by default only decomposition (task description, no code)
+     * goes remote. Flip to true ONLY if you accept your source code leaving the
+     * machine to a free tier. A one-time notice is shown the first time it takes
+     * effect.
+     */
+    allowRemoteCode: boolean;
 }
 /** Local-LLM configuration. Opt-in; absent or disabled = heuristic only. */
 export interface OllamaSettings {
@@ -36,10 +54,23 @@ export type TaskStatus = 'idle' | 'awaiting_paste' | 'applying' | 'testing' | 'r
 /** The agent's memory across CLI invocations. Stored at .helpcode/state.json. */
 export interface AgentState {
     /** Schema version so we can migrate later without breaking installs. */
-    version: 1;
+    version: 2;
     currentTask: CurrentTask | null;
     /** History of resolved tasks (summary only, not full content). */
     history: TaskHistoryEntry[];
+    /**
+     * Rolling log of sous-chef work this session (v0.3). The cockpit reads this;
+     * the tasks (and future engine) append to it. Capped to a recent window so
+     * the state file stays small.
+     */
+    sousChefLog: SousChefEvent[];
+    /** One-time UI flags (e.g. consent notices already shown). Optional. */
+    flags?: StateFlags;
+}
+/** One-time flags persisted so we don't repeat notices. All optional. */
+export interface StateFlags {
+    /** True once the "sending code to a free tier" notice has been shown. */
+    remoteCodeNoticeShown?: boolean;
 }
 export interface CurrentTask {
     id: string;
@@ -68,3 +99,35 @@ export interface TaskHistoryEntry {
     resolvedAt: string;
     iterations: number;
 }
+/** Who did a unit of prep work. */
+export type WorkerKind = 'local' | 'remote' | 'deterministic' | 'principal';
+/** A prep task helpcode knows how to route to a worker. */
+export type SousChefTask = 'file_selection' | 'output_triage' | 'decomposition' | 'other';
+/** One recorded unit of work, written by whoever performed it. */
+export interface SousChefEvent {
+    /** ISO timestamp. */
+    at: string;
+    /** Which prep task. */
+    task: SousChefTask;
+    /** Who did it. */
+    worker: WorkerKind;
+    /** Model tag if a model did it (e.g. "qwen2.5-coder:7b"), else null. */
+    model: string | null;
+    /** One-line human-readable summary of what happened. */
+    summary: string;
+    /** Did this work succeed, or fall back to a cheaper worker? */
+    outcome: 'ok' | 'fallback' | 'escalated';
+    /** Rough estimate of principal tokens this prep saved, if known. */
+    estTokensSaved: number | null;
+}
+/** Per-worker rolling status for the cockpit panels. */
+export interface WorkerStatus {
+    kind: WorkerKind;
+    model: string | null;
+    /** Free-tier quota used 0..1, if the worker has a quota (remote). null = N/A. */
+    quotaUsed: number | null;
+    /** Count of events this session. */
+    eventsThisSession: number;
+    /** Last summary line, for the panel log. */
+    lastSummary: string | null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manishbht/helpcode",
-  "version": "0.2.3",
+  "version": "0.3.4",
   "description": "A local agent that makes Claude.ai conversations efficient enough to ship real projects on a Pro subscription.",
   "type": "module",
   "main": "dist/src/index.js",