@cleocode/core 2026.6.13 → 2026.6.15

package/dist/llm/llm-queue-admit.d.ts

@@ -0,0 +1,118 @@
+/**
+ * **LLM-queue admit gate** — the Node-side gate for the supervisor's LLM-queue
+ * priority scheduler + per-provider rate governor (T11630 · AC1-AC4).
+ *
+ * The contended priority + rate state lives in the Rust arbiter
+ * (`crates/cleo-supervisor/src/llm_queue.rs`), exposed over `lease-ipc` v1.1 as
+ * the `queue_admit` → `queue_admit_result` verb. THIS module is the thin Node
+ * gate every outbound LLM call passes through immediately before it hits the
+ * wire: it asks the supervisor "may I admit this call?" and, on a `deferred`
+ * answer, backs off `retry_after_ms` and re-asks — a structured deferral, never
+ * a silent drop (AC4).
+ *
+ * ## Modes ({@link resolveLlmQueueMode})
+ *
+ * `CLEO_LLM_QUEUE_MODE` ∈ `{ supervisor | off }`, **default `off`** — mirrors
+ * {@link ../store/writer-lease.ts}'s `resolveLeaseMode()` shape:
+ *
+ * - `off` — pure pass-through: {@link llmQueueAdmit} returns `{ admitted: true }`
+ *   without touching the supervisor. The daemon is OFF by default in production,
+ *   so this is the shipping config: EVERY LLM call works with no supervisor.
+ * - `supervisor` — prefer the supervisor arbiter over the IPC socket; a
+ *   `deferred` result is honoured with a back-off + re-request. When the socket
+ *   is absent / refused / errors, the gate logs the demotion ONCE and degrades
+ *   to direct execution (`{ admitted: true }`) — a dead/absent arbiter must
+ *   NEVER block an LLM call.
+ *
+ * ## CRITICAL degrade-to-direct (headline correctness — AC4 inverse)
+ *
+ * Because the daemon stays OFF by default, the load-bearing path is the degrade:
+ * mode `off`, no socket, `E_LEASE_UNAVAILABLE`, or a connect-refused all resolve
+ * to `{ admitted: true }` and the caller executes the LLM call DIRECTLY. The
+ * supervisor is a pure OPTIMISATION; its absence is never an error.
+ *
+ * @module llm/llm-queue-admit
+ * @task T11630
+ * @epic T11625
+ * @see ../store/writer-lease.ts — the `resolveLeaseMode()` + log-once demotion this mirrors
+ * @see ../../../runtime/src/daemon/lease-ipc-client.ts — the v1.1 codec this mirrors (boundary: core cannot import runtime)
+ */
+import { type QueuePriorityClass } from '@cleocode/contracts';
+/** The LLM-queue admit gate mode. Resolved once per process; default `off`. */
+export type LlmQueueMode = 'supervisor' | 'off';
+/**
+ * The structured result of an admit gate decision. `admitted: true` means
+ * execute the LLM call now; the gate NEVER returns a "dropped" — an over-budget
+ * request is internally retried (with back-off) until admitted or the supervisor
+ * is found unavailable (then degrades to admitted-direct). AC4.
+ */
+export interface LlmAdmitResult {
+    /** Whether the LLM call may proceed (always `true` once this resolves). */
+    readonly admitted: true;
+    /**
+     * How the admission was decided — `direct` when no supervisor arbitrated
+     * (off-mode / degrade), `supervisor` when the arbiter granted it. Diagnostic
+     * only; both mean "go".
+     */
+    readonly via: 'direct' | 'supervisor';
+}
+/** Options for {@link llmQueueAdmit}. */
+export interface LlmQueueAdmitOptions {
+    /**
+     * Override the supervisor socket path. Defaults to
+     * `<cleoHome>/cleo-supervisor.sock` (or `$CLEO_SUPERVISOR_SOCKET`).
+     */
+    socketPath?: string;
+    /**
+     * Max wall-clock (ms) the gate will spend re-requesting a deferred admit
+     * before degrading to direct. Bounds the worst-case latency a starved call
+     * adds; on timeout the call proceeds (the supervisor budget is advisory, never
+     * a hard block on a real call). Default {@link DEFAULT_ADMIT_DEADLINE_MS}.
+     */
+    deadlineMs?: number;
+}
+/** Max wall-clock a deferred admit will be re-requested before degrading. */
+export declare const DEFAULT_ADMIT_DEADLINE_MS = 30000;
+/**
+ * Resolve the LLM-queue mode from `CLEO_LLM_QUEUE_MODE`, once per process.
+ *
+ * Unknown / unset values resolve to `'off'` — the production-safe default while
+ * the supervisor daemon is disabled. Mirrors `resolveLeaseMode()`.
+ *
+ * @returns The resolved {@link LlmQueueMode}.
+ * @task T11630
+ */
+export declare function resolveLlmQueueMode(): LlmQueueMode;
+/**
+ * Reset cached process-global state (mode + demotion flag). Tests only.
+ *
+ * @internal
+ */
+export declare function _resetLlmQueueStateForTest(): void;
+/**
+ * Gate an outbound LLM call through the supervisor's priority scheduler +
+ * per-provider rate governor (T11630). Call this immediately BEFORE executing
+ * the LLM request.
+ *
+ * - mode `off` (default) → returns `{ admitted: true, via: 'direct' }` with no
+ *   IPC. The shipping config.
+ * - mode `supervisor`, arbiter reachable → sends `queue_admit`; on `admitted`
+ *   returns immediately; on `deferred` awaits `retry_after_ms` and re-requests
+ *   until admitted or the deadline elapses (then degrades to direct — the budget
+ *   is advisory). AC4: a deferral is a structured wait, never a dropped call.
+ * - mode `supervisor`, arbiter UNreachable (no socket / connect-refused /
+ *   `E_LEASE_UNAVAILABLE` / any transport error) → logs the demotion once and
+ *   returns `{ admitted: true, via: 'direct' }`. A dead/absent supervisor MUST
+ *   NEVER block an LLM call.
+ *
+ * @param provider      - The provider id the call targets (rate budget is per-provider).
+ * @param priorityClass - The caller's priority class (lead > worker > background).
+ * @param estTokens     - The caller's estimate of the request's token cost.
+ * @param childId       - The child the call belongs to (in-flight tracking seam).
+ * @param opts          - Socket path + deadline overrides.
+ * @returns Always resolves to an `{ admitted: true }` result — never throws, never drops.
+ *
+ * @task T11630
+ */
+export declare function llmQueueAdmit(provider: string, priorityClass: QueuePriorityClass, estTokens: number, childId: string, opts?: LlmQueueAdmitOptions): Promise<LlmAdmitResult>;
+//# sourceMappingURL=llm-queue-admit.d.ts.map

package/dist/llm/llm-queue-admit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-queue-admit.d.ts","sourceRoot":"","sources":["../../src/llm/llm-queue-admit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAO7B,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,KAAK,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY,CAAC;CACvC;AAED,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAwBhD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAKlD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,kBAAkB,EACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAiDzB"}

package/dist/llm/llm-queue-admit.js

@@ -0,0 +1,275 @@
+/**
+ * **LLM-queue admit gate** — the Node-side gate for the supervisor's LLM-queue
+ * priority scheduler + per-provider rate governor (T11630 · AC1-AC4).
+ *
+ * The contended priority + rate state lives in the Rust arbiter
+ * (`crates/cleo-supervisor/src/llm_queue.rs`), exposed over `lease-ipc` v1.1 as
+ * the `queue_admit` → `queue_admit_result` verb. THIS module is the thin Node
+ * gate every outbound LLM call passes through immediately before it hits the
+ * wire: it asks the supervisor "may I admit this call?" and, on a `deferred`
+ * answer, backs off `retry_after_ms` and re-asks — a structured deferral, never
+ * a silent drop (AC4).
+ *
+ * ## Modes ({@link resolveLlmQueueMode})
+ *
+ * `CLEO_LLM_QUEUE_MODE` ∈ `{ supervisor | off }`, **default `off`** — mirrors
+ * {@link ../store/writer-lease.ts}'s `resolveLeaseMode()` shape:
+ *
+ * - `off` — pure pass-through: {@link llmQueueAdmit} returns `{ admitted: true }`
+ *   without touching the supervisor. The daemon is OFF by default in production,
+ *   so this is the shipping config: EVERY LLM call works with no supervisor.
+ * - `supervisor` — prefer the supervisor arbiter over the IPC socket; a
+ *   `deferred` result is honoured with a back-off + re-request. When the socket
+ *   is absent / refused / errors, the gate logs the demotion ONCE and degrades
+ *   to direct execution (`{ admitted: true }`) — a dead/absent arbiter must
+ *   NEVER block an LLM call.
+ *
+ * ## CRITICAL degrade-to-direct (headline correctness — AC4 inverse)
+ *
+ * Because the daemon stays OFF by default, the load-bearing path is the degrade:
+ * mode `off`, no socket, `E_LEASE_UNAVAILABLE`, or a connect-refused all resolve
+ * to `{ admitted: true }` and the caller executes the LLM call DIRECTLY. The
+ * supervisor is a pure OPTIMISATION; its absence is never an error.
+ *
+ * @module llm/llm-queue-admit
+ * @task T11630
+ * @epic T11625
+ * @see ../store/writer-lease.ts — the `resolveLeaseMode()` + log-once demotion this mirrors
+ * @see ../../../runtime/src/daemon/lease-ipc-client.ts — the v1.1 codec this mirrors (boundary: core cannot import runtime)
+ */
+import { connect } from 'node:net';
+import { join } from 'node:path';
+import { LEASE_IPC_PROTOCOL_VERSION, LeaseIpcRequestEnvelopeSchema, LeaseIpcResponseEnvelopeSchema, } from '@cleocode/contracts';
+import { getCleoHome } from '@cleocode/paths';
+import { getLogger } from '../logger.js';
+/** The supervisor IPC socket filename — MUST equal `SOCKET_NAME` in the Rust `crates/cleo-supervisor/src/paths.rs`. */
+const SUPERVISOR_SOCKET_NAME = 'cleo-supervisor.sock';
+/** Max wall-clock a deferred admit will be re-requested before degrading. */
+export const DEFAULT_ADMIT_DEADLINE_MS = 30_000;
+/** Connect timeout for the supervisor socket (ms). A slow/absent socket degrades fast. */
+const CONNECT_TIMEOUT_MS = 250;
+/** Per-request read timeout for a `queue_admit_result` (ms). */
+const REQUEST_TIMEOUT_MS = 2_000;
+/** Cap on a single deferral back-off so a misconfigured window cannot wedge a call. */
+const MAX_RETRY_BACKOFF_MS = 5_000;
+/**
+ * Lazily-memoized module logger (import-time-side-effect-free — matches the
+ * `writer-lease.ts` deferral pattern so a mocked import graph never hits a TDZ).
+ */
+let _log = null;
+function log() {
+    if (_log === null)
+        _log = getLogger('llm-queue-admit');
+    return _log;
+}
+let _cachedMode = null;
+let _supervisorDemotionLogged = false;
+/**
+ * Resolve the LLM-queue mode from `CLEO_LLM_QUEUE_MODE`, once per process.
+ *
+ * Unknown / unset values resolve to `'off'` — the production-safe default while
+ * the supervisor daemon is disabled. Mirrors `resolveLeaseMode()`.
+ *
+ * @returns The resolved {@link LlmQueueMode}.
+ * @task T11630
+ */
+export function resolveLlmQueueMode() {
+    if (_cachedMode !== null)
+        return _cachedMode;
+    const raw = process.env.CLEO_LLM_QUEUE_MODE;
+    _cachedMode = raw === 'supervisor' ? 'supervisor' : 'off';
+    return _cachedMode;
+}
+/**
+ * Reset cached process-global state (mode + demotion flag). Tests only.
+ *
+ * @internal
+ */
+export function _resetLlmQueueStateForTest() {
+    _cachedMode = null;
+    _supervisorDemotionLogged = false;
+}
+/** Log the supervisor→direct demotion AT MOST once per process. */
+function logDemotionOnce(reason) {
+    if (_supervisorDemotionLogged)
+        return;
+    _supervisorDemotionLogged = true;
+    log().info(`CLEO_LLM_QUEUE_MODE=supervisor but the LLM-queue arbiter is unavailable ` +
+        `(${reason}); degrading to direct LLM execution for the process lifetime.`);
+}
+/** The default supervisor socket path: `$CLEO_SUPERVISOR_SOCKET` or `<cleoHome>/cleo-supervisor.sock`. */
+function defaultSocketPath() {
+    const override = process.env.CLEO_SUPERVISOR_SOCKET;
+    if (override !== undefined && override.length > 0)
+        return override;
+    return join(getCleoHome(), SUPERVISOR_SOCKET_NAME);
+}
+/** The "execute directly" result — the load-bearing degrade path. */
+const ADMITTED_DIRECT = { admitted: true, via: 'direct' };
+/** Async sleep that yields the event loop. */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, Math.max(0, Math.round(ms))));
+}
+/**
+ * Gate an outbound LLM call through the supervisor's priority scheduler +
+ * per-provider rate governor (T11630). Call this immediately BEFORE executing
+ * the LLM request.
+ *
+ * - mode `off` (default) → returns `{ admitted: true, via: 'direct' }` with no
+ *   IPC. The shipping config.
+ * - mode `supervisor`, arbiter reachable → sends `queue_admit`; on `admitted`
+ *   returns immediately; on `deferred` awaits `retry_after_ms` and re-requests
+ *   until admitted or the deadline elapses (then degrades to direct — the budget
+ *   is advisory). AC4: a deferral is a structured wait, never a dropped call.
+ * - mode `supervisor`, arbiter UNreachable (no socket / connect-refused /
+ *   `E_LEASE_UNAVAILABLE` / any transport error) → logs the demotion once and
+ *   returns `{ admitted: true, via: 'direct' }`. A dead/absent supervisor MUST
+ *   NEVER block an LLM call.
+ *
+ * @param provider      - The provider id the call targets (rate budget is per-provider).
+ * @param priorityClass - The caller's priority class (lead > worker > background).
+ * @param estTokens     - The caller's estimate of the request's token cost.
+ * @param childId       - The child the call belongs to (in-flight tracking seam).
+ * @param opts          - Socket path + deadline overrides.
+ * @returns Always resolves to an `{ admitted: true }` result — never throws, never drops.
+ *
+ * @task T11630
+ */
+export async function llmQueueAdmit(provider, priorityClass, estTokens, childId, opts = {}) {
+    if (resolveLlmQueueMode() === 'off') {
+        return ADMITTED_DIRECT;
+    }
+    const socketPath = opts.socketPath ?? defaultSocketPath();
+    const deadline = Date.now() + (opts.deadlineMs ?? DEFAULT_ADMIT_DEADLINE_MS);
+    for (;;) {
+        let result;
+        try {
+            result = await sendQueueAdmit(socketPath, {
+                kind: 'queue_admit',
+                provider,
+                priority_class: priorityClass,
+                est_tokens: Math.max(0, Math.trunc(estTokens)),
+                child_id: childId,
+            });
+        }
+        catch (err) {
+            // Any transport failure (ENOENT, ECONNREFUSED, timeout, malformed frame)
+            // → the arbiter is unavailable; degrade to direct (AC4 inverse).
+            logDemotionOnce(err instanceof Error ? err.message : String(err));
+            return ADMITTED_DIRECT;
+        }
+        if ('unavailable' in result) {
+            // The supervisor answered E_LEASE_UNAVAILABLE (arbiter not wired) →
+            // degrade to direct.
+            logDemotionOnce(result.reason);
+            return ADMITTED_DIRECT;
+        }
+        if (result.disposition === 'admitted') {
+            return { admitted: true, via: 'supervisor' };
+        }
+        // Deferred — structured back-off then re-request (AC4: never a silent drop).
+        if (Date.now() >= deadline) {
+            // The budget is advisory; a real call must not be blocked indefinitely.
+            // Past the deadline, proceed (degrade to direct) rather than starve.
+            log().debug({ provider, priorityClass, queuePosition: result.queue_position }, 'llm-queue admit deadline exceeded while deferred; proceeding directly');
+            return ADMITTED_DIRECT;
+        }
+        const backoff = Math.min(MAX_RETRY_BACKOFF_MS, Math.max(1, result.retry_after_ms));
+        await sleep(backoff);
+    }
+}
+/**
+ * Send ONE `queue_admit` over a fresh supervisor socket connection and resolve
+ * the typed `queue_admit_result` (or a sentinel when the arbiter answered
+ * `E_LEASE_UNAVAILABLE`). Connection-per-request keeps the gate stateless and
+ * transport failures isolated; the socket is closed before resolution.
+ *
+ * Encodes the request envelope + decodes the response line through the SAME
+ * `@cleocode/contracts` v1.1 Zod schemas the runtime `lease-ipc-client` uses —
+ * core cannot import `@cleocode/runtime` (cycle), so it mirrors the codec here.
+ *
+ * @throws On any transport error (connect refused, ENOENT, timeout, malformed frame).
+ */
+function sendQueueAdmit(socketPath, request) {
+    return new Promise((resolve, reject) => {
+        const id = `qa-${process.pid}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+        const envelope = LeaseIpcRequestEnvelopeSchema.parse({
+            protocol_version: LEASE_IPC_PROTOCOL_VERSION,
+            id,
+            direction: 'request',
+            request,
+        });
+        const line = `${JSON.stringify(envelope)}\n`;
+        let settled = false;
+        let buffer = '';
+        const socket = connect(socketPath);
+        const cleanup = () => {
+            socket.removeAllListeners();
+            socket.destroy();
+        };
+        const fail = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(err);
+        };
+        const succeed = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(value);
+        };
+        socket.setTimeout(REQUEST_TIMEOUT_MS);
+        // A connect that does not complete within the bound is a degrade signal.
+        const connectTimer = setTimeout(() => fail(new Error('supervisor connect timeout')), CONNECT_TIMEOUT_MS);
+        socket.on('connect', () => {
+            clearTimeout(connectTimer);
+            socket.write(line);
+        });
+        socket.on('timeout', () => fail(new Error('supervisor request timeout')));
+        socket.on('error', (err) => {
+            clearTimeout(connectTimer);
+            fail(err);
+        });
+        socket.on('close', () => {
+            if (!settled)
+                fail(new Error('supervisor closed the connection before responding'));
+        });
+        socket.on('data', (chunk) => {
+            buffer += chunk.toString('utf8');
+            const nl = buffer.indexOf('\n');
+            if (nl < 0)
+                return; // wait for a full NDJSON line
+            const raw = buffer.slice(0, nl);
+            let json;
+            try {
+                json = JSON.parse(raw);
+            }
+            catch (cause) {
+                fail(new Error(`malformed lease-ipc frame: ${cause instanceof Error ? cause.message : cause}`));
+                return;
+            }
+            const parsed = LeaseIpcResponseEnvelopeSchema.safeParse(json);
+            if (!parsed.success) {
+                fail(new Error(`off-contract lease-ipc response: ${parsed.error.message}`));
+                return;
+            }
+            const { response } = parsed.data;
+            if (response.kind === 'queue_admit_result') {
+                succeed(response);
+                return;
+            }
+            if (response.kind === 'error') {
+                // E_LEASE_UNAVAILABLE (arbiter not wired) or any arbiter error →
+                // treat as "supervisor cannot arbitrate"; the caller degrades to direct.
+                succeed({ unavailable: true, reason: `${response.code}: ${response.message}` });
+                return;
+            }
+            // Any other kind on a queue_admit correlation is a protocol violation.
+            fail(new Error(`unexpected lease-ipc response kind for queue_admit: ${response.kind}`));
+        });
+    });
+}
+//# sourceMappingURL=llm-queue-admit.js.map

package/dist/llm/llm-queue-admit.js.map

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

package/dist/llm/local-model-fit.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Local-model fit ranking for Ollama-backed open-weight models (T11982).
+ *
+ * ## Purpose
+ *
+ * Given the current machine's hardware (RAM, VRAM), rank 2–3 curated
+ * open-weight models that are actually likely to run well. This is the
+ * `cleo llm fit` wizard building block — it powers T11983's one-keypress
+ * pull+connect flow.
+ *
+ * ## Vendor-vs-inspire decision (llmfit)
+ *
+ * Evaluated `github.com/AlexsJones/llmfit` (MIT, Go, ~400 LOC). The library
+ * is a standalone Go binary — not a TS/ESM package. Its key contribution is
+ * the IDEA: use RAM thresholds to gate model selection, prefer VRAM when
+ * available, and produce a ranked list with human-readable reasons. We
+ * **vendor the IDEA** (TS-native re-implementation) rather than shelling out
+ * to a Go binary or adding a cross-language dependency. The model thresholds
+ * below are independently calibrated from Ollama's documentation and the
+ * Hugging Face model cards, not copy-pasted from llmfit.
+ *
+ * ## Gate-13 compliance
+ *
+ * This module:
+ * - MUST NOT construct any transport or SDK client.
+ * - MUST NOT read `process.env.*_API_KEY` directly.
+ * - MUST NOT define a new `resolveLLMFor*` function.
+ * - MUST NOT hardcode model-id literals in logic — all model IDs come from
+ *   the {@link LOCAL_MODEL_CANDIDATES} data table.
+ *
+ * The hardware detection (`os.totalmem`, `os.freemem`, `/proc/meminfo`,
+ * `nvidia-smi`) is plain system inspection — not covered by Gate-13 (which
+ * governs LLM resolution / transport construction).
+ *
+ * Ollama liveness re-uses {@link probeOllamaAlive} from
+ * `cross-provider-selector.ts` (no duplication). The `/api/tags` fetch is
+ * a vanilla HTTP call to localhost, not a transport construction.
+ *
+ * @module llm/local-model-fit
+ * @task T11982
+ * @epic T11671
+ */
+/**
+ * A single entry in the curated open-weight model catalog.
+ *
+ * These values are calibrated from Ollama model pages and Hugging Face cards.
+ * Quantisation notes describe the default GGUF quantisation level pulled by
+ * `ollama pull <model>`.
+ */
+export interface LocalModelCandidate {
+    /** Ollama model tag (used verbatim in `ollama pull <modelTag>`). */
+    readonly modelTag: string;
+    /** Human-readable display name. */
+    readonly displayName: string;
+    /** Model family (for grouping in the wizard). */
+    readonly family: 'gemma4' | 'qwen3' | 'llama3.2' | 'qwen2.5-coder' | 'phi4';
+    /** Minimum RAM required to run (worst-case, CPU inference), in GiB. */
+    readonly minRamGb: number;
+    /** Recommended RAM for comfortable CPU inference, in GiB. */
+    readonly recommendedRamGb: number;
+    /** Minimum VRAM required for GPU acceleration, in GiB (0 = CPU-only model). */
+    readonly minVramGb: number;
+    /** Recommended VRAM for full GPU offload, in GiB (0 = CPU-only model). */
+    readonly recommendedVramGb: number;
+    /** Approximate model size on disk (for download size estimation), in GiB. */
+    readonly diskSizeGb: number;
+    /** Default quantisation pulled by `ollama pull` (informational). */
+    readonly quantNote: string;
+    /**
+     * Whether this model is intended for code tasks (true) or general use (false).
+     * Shown as a tag in the wizard.
+     */
+    readonly codeSpecialist: boolean;
+    /**
+     * Context window in tokens.
+     * Used to surface context-length as a selection criterion.
+     */
+    readonly contextLengthK: number;
+}
+/**
+ * Curated candidate table. These are the ONLY models `rankLocalModelFit`
+ * can recommend — expand this table to add new models.
+ *
+ * Exclusions:
+ * - `qwen2:0.5b` — proof-of-life only; deliberately absent from this list.
+ *
+ * @task T11982
+ */
+export declare const LOCAL_MODEL_CANDIDATES: ReadonlyArray<LocalModelCandidate>;
+/**
+ * VRAM detection result.
+ *
+ * VRAM detection is best-effort and graceful — the field is `null` when no
+ * GPU is detected (nvidia-smi absent, no Apple Silicon heuristic, etc.).
+ */
+export interface VramInfo {
+    /** Total VRAM in bytes, or null if detection failed. */
+    totalBytes: number | null;
+    /** Free VRAM in bytes, or null if detection failed. */
+    freeBytes: number | null;
+    /** Detection method used. */
+    method: 'nvidia-smi' | 'rocm-smi' | 'apple-unified' | 'none';
+}
+/**
+ * Full hardware snapshot used by the ranking algorithm.
+ */
+export interface HardwareSnapshot {
+    /** Total system RAM in bytes (from `os.totalmem()`). */
+    totalRamBytes: number;
+    /**
+     * Available RAM in bytes.
+     * Linux: from `/proc/meminfo` `MemAvailable` (more accurate than `os.freemem`).
+     * Other platforms: `os.freemem()`.
+     */
+    availableRamBytes: number;
+    /** VRAM information (best-effort, never throws). */
+    vram: VramInfo;
+    /** Detected platform. */
+    platform: string;
+}
+/**
+ * Capture a full hardware snapshot.
+ *
+ * Never throws — VRAM detection failures degrade gracefully to `null`.
+ *
+ * @param overrides - Override fields for testing (avoids OS calls in unit tests).
+ * @returns A hardware snapshot describing this machine's capabilities.
+ *
+ * @task T11982
+ */
+export declare function captureHardwareSnapshot(overrides?: {
+    totalRamBytes?: number;
+    availableRamBytes?: number;
+    vram?: VramInfo;
+    platform?: string;
+}): Promise<HardwareSnapshot>;
+/**
+ * A model already pulled and available locally in Ollama.
+ */
+export interface OllamaPulledModel {
+    /** Tag as returned by `/api/tags`. */
+    name: string;
+    /** Parameter size string (e.g. `"3.1B"`). */
+    parameterSize: string;
+    /** Quantisation level (e.g. `"Q4_K_M"`). */
+    quantizationLevel: string;
+    /** Model family (e.g. `"qwen2"`). */
+    family: string;
+}
+/**
+ * Fetch the list of locally-pulled models from Ollama's `/api/tags` endpoint.
+ *
+ * Uses the HTTP API (not shelling out) — Gate-13 does not govern plain `fetch`
+ * calls to localhost.
+ *
+ * @param baseUrl - Ollama base URL (default `http://localhost:11434`).
+ * @param fetchFn - Injectable `fetch` for testing (defaults to global `fetch`).
+ * @returns Array of pulled models, or empty array if Ollama is not reachable.
+ *
+ * @task T11982
+ */
+export declare function listOllamaPulledModels(baseUrl?: string, fetchFn?: typeof fetch): Promise<OllamaPulledModel[]>;
+/**
+ * Hard RAM floor below which no local model recommendation is made.
+ * Machines under this threshold are steered toward cloud providers instead.
+ */
+export declare const LOCAL_FIT_FLOOR_GB = 4;
+/**
+ * A ranked local model fit result.
+ */
+export interface LocalModelFitResult {
+    /** The candidate model. */
+    candidate: LocalModelCandidate;
+    /**
+     * Overall fit score (higher is better).
+     * Used to rank candidates — not surfaced directly in the wizard UI.
+     */
+    score: number;
+    /**
+     * Whether this model is already pulled in the local Ollama installation.
+     * Models that are already pulled get a score boost (prefer not re-downloading).
+     */
+    alreadyPulled: boolean;
+    /**
+     * Human-readable fit reasons (bullet list for wizard display).
+     * Examples: "fits in 10GB VRAM", "already pulled", "recommended for 8GB RAM".
+     */
+    reasons: string[];
+    /**
+     * Fit tier:
+     * - `'excellent'` — hardware is well above requirements; full GPU offload expected.
+     * - `'good'`      — hardware meets recommended threshold; runs well.
+     * - `'marginal'`  — hardware meets minimum; expect slower inference.
+     */
+    fitTier: 'excellent' | 'good' | 'marginal';
+    /**
+     * The `ollama pull <pullCommand>` string for this model.
+     */
+    pullCommand: string;
+}
+/**
+ * Output envelope returned by {@link rankLocalModelFit}.
+ */
+export interface LocalModelFitEnvelope {
+    /** Hardware snapshot used for ranking. */
+    hardware: {
+        totalRamGb: number;
+        availableRamGb: number;
+        vramTotalGb: number | null;
+        vramFreeGb: number | null;
+        vramMethod: VramInfo['method'];
+    };
+    /** Whether Ollama was detected as running. */
+    ollamaRunning: boolean;
+    /** Models already available in the local Ollama installation. */
+    pulledModels: OllamaPulledModel[];
+    /**
+     * Ranked 2–3 best-fit candidates.
+     * Empty when hardware is below the 4 GB floor.
+     */
+    recommendations: LocalModelFitResult[];
+    /**
+     * Human-readable explanation when no recommendations are available.
+     * null when recommendations is non-empty.
+     */
+    noRecommendationReason: string | null;
+}
+/**
+ * Rank the 2–3 best-fit local open-weight models for this machine.
+ *
+ * ## Floor
+ *
+ * Machines with total RAM below {@link LOCAL_FIT_FLOOR_GB} (4 GB) receive no
+ * recommendations. This deliberately excludes `qwen2:0.5b` (proof-of-life
+ * only) — it is absent from {@link LOCAL_MODEL_CANDIDATES}.
+ *
+ * ## Algorithm
+ *
+ *   1. Capture hardware snapshot.
+ *   2. Probe Ollama liveness and fetch the pulled-models list.
+ *   3. Filter candidates to those whose `minRamGb` ≤ total RAM.
+ *   4. Score remaining candidates (VRAM fit + RAM comfort + already-pulled bonus).
+ *   5. Return the top 3 (or fewer), ordered by score descending.
+ *
+ * @param opts - Override hardware snapshot for testing.
+ * @returns Fit envelope with ranked candidates.
+ *
+ * @task T11982
+ */
+export declare function rankLocalModelFit(opts?: {
+    /** Override the hardware snapshot (for testing). */
+    hardwareOverride?: Parameters<typeof captureHardwareSnapshot>[0];
+    /** Override Ollama base URL. */
+    ollamaBaseUrl?: string;
+    /** Injectable fetch for testing. */
+    fetchFn?: typeof fetch;
+    /** Override pulled models list (for testing). */
+    pulledModelsOverride?: OllamaPulledModel[];
+}): Promise<LocalModelFitEnvelope>;
+//# sourceMappingURL=local-model-fit.d.ts.map

package/dist/llm/local-model-fit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-model-fit.d.ts","sourceRoot":"","sources":["../../src/llm/local-model-fit.ts"],"names":[],"mappings":"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"}