myshell-tools 1.0.0 → 2.0.0-alpha.0

package/dist/commands/cost.js

@@ -0,0 +1,103 @@
+/**
+ * src/commands/cost.ts — `myshell-tools cost` spend-summary command.
+ *
+ * Reads the on-disk ledger, computes real totals, and prints an honest
+ * per-model breakdown together with a counterfactual "what if you had used
+ * the manager-tier flagship for every call?" comparison.
+ *
+ * Counterfactual (apples-to-apples)
+ * ---------------------------------
+ * The "Billed total" is the real amount from the ledger (includes caching and
+ * discounts). The counterfactual compares ONLY like-for-like list prices:
+ *   routed   = sum over entries of listPrice(entry.model) × entry tokens
+ *   flagship = sum over entries of listPrice(manager flagship) × entry tokens
+ *   multiplier = flagship / routed
+ * We never compare the cache-adjusted billed total against a list-price flagship
+ * estimate — that would understate flagship and mislead.
+ *
+ * Honesty contract: every figure comes from the real ledger; no values are
+ * fabricated. If the ledger is empty the command says so and returns 0.
+ */
+import { readLedger, summarizeLedger } from '../infra/ledger.js';
+import { getCheapestForTier, calculateCost, getModelPricing } from '../infra/pricing.js';
+import { bold, dim, cyan, divider, label } from '../ui/theme.js';
+// ---------------------------------------------------------------------------
+// Pure report builder — testable with hand-built LedgerEntry[]
+// ---------------------------------------------------------------------------
+/**
+ * Build the cost-report lines from a (possibly empty) ledger entry array.
+ *
+ * Pure function: no I/O, no process.exit, no Date/Math.random.
+ * Called by runCost after reading the real ledger, and by unit tests.
+ */
+export function formatCostReport(entries, color = false) {
+    if (entries.length === 0) {
+        return ['No usage recorded yet — run a task first.'];
+    }
+    const summary = summarizeLedger(entries);
+    const flagship = getCheapestForTier('manager');
+    // Apples-to-apples: price BOTH the models actually used AND the flagship on the
+    // SAME basis (list price × tokens). We do NOT compare the billed total (which
+    // includes caching/discounts) against a list-price flagship estimate.
+    let routedListUsd = 0;
+    let flagshipListUsd = 0;
+    for (const entry of entries) {
+        const entryPricing = getModelPricing(entry.provider, entry.model);
+        if (entryPricing) {
+            routedListUsd += calculateCost(entry.inputTokens, entry.outputTokens, entryPricing);
+        }
+        flagshipListUsd += calculateCost(entry.inputTokens, entry.outputTokens, flagship);
+    }
+    const lines = [];
+    lines.push(bold('myshell-tools cost', color));
+    lines.push(divider(color));
+    // ---- Summary ---------------------------------------------------------------
+    lines.push(`${label('Billed total', color)}: $${summary.totalUsd.toFixed(4)} ` +
+        `${dim('(as billed, incl. caching/discounts)', color)}`);
+    lines.push(`${label('Total calls', color)}: ${summary.calls}`);
+    lines.push(divider(color));
+    // ---- Per-model breakdown ---------------------------------------------------
+    lines.push(bold('Per-model breakdown', color));
+    for (const [model, ms] of Object.entries(summary.byModel)) {
+        const callStr = ms.calls === 1 ? '1 call' : `${ms.calls} calls`;
+        lines.push(`  ${cyan(model, color)}: ${callStr}, $${ms.usd.toFixed(4)}`);
+    }
+    lines.push(divider(color));
+    // ---- Counterfactual (list-price, token-for-token, apples-to-apples) --------
+    const flagshipLabel = `${flagship.model} (${flagship.tier} tier)`;
+    lines.push(bold('Counterfactual — list price, token-for-token', color));
+    lines.push(`${dim('Flagship model', color)}: ${flagshipLabel}` +
+        `  ${dim(`($${flagship.inputPer1M}/M in, $${flagship.outputPer1M}/M out)`, color)}`);
+    lines.push(`${label('Routed (models used)', color)}: $${routedListUsd.toFixed(4)}`);
+    lines.push(`${label('Always-flagship', color)}:      $${flagshipListUsd.toFixed(4)}`);
+    if (routedListUsd > 0 && flagshipListUsd > routedListUsd) {
+        const multiplier = flagshipListUsd / routedListUsd;
+        lines.push(`Routing saved you money: always-flagship would cost ${multiplier.toFixed(1)}x more ` +
+            `($${flagshipListUsd.toFixed(4)} vs $${routedListUsd.toFixed(4)} at list price).`);
+    }
+    else if (routedListUsd > 0) {
+        lines.push('Every call already used a flagship-tier (or pricier) model — no routing savings to show.');
+    }
+    else {
+        lines.push(dim('No priced models in the ledger — cannot compute a list-price comparison.', color));
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// I/O runner — called by cli.ts
+// ---------------------------------------------------------------------------
+/**
+ * Read the ledger for `cwd`, build the cost report, and write it to `out`.
+ *
+ * Returns 0 always (cost reporting is informational, not an error condition).
+ * Never calls process.exit — that is handled exclusively by src/cli.ts.
+ */
+export async function runCost(cwd, out) {
+    const entries = await readLedger(cwd);
+    const lines = formatCostReport(entries, out.color);
+    for (const line of lines) {
+        out.write(line + '\n');
+    }
+    return 0;
+}
+//# sourceMappingURL=cost.js.map

package/dist/commands/cost.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * src/commands/doctor.ts — `myshell-tools doctor` health-check command.
+ *
+ * Probes the runtime environment (providers, filesystem, pricing) and prints
+ * an honest, human-readable report to an OutputSink. All displayed data comes
+ * from real detection results — no fabricated values.
+ *
+ * Honesty contract: authentication status for Claude is labelled OPTIMISTIC
+ * because we cannot cheaply probe auth state without spending API quota.
+ */
+import type { OutputSink } from '../interface/render.js';
+import type { EnvironmentStatus } from '../providers/detect.js';
+export interface DoctorExtras {
+    readonly nodeVersion: string;
+    readonly stateWritable: boolean;
+    readonly pricingStale: boolean;
+}
+/**
+ * Build the doctor report lines from pre-collected data.
+ *
+ * Pure function: no I/O, no process.exit, no side effects.
+ * Used by runDoctor after it collects the real data, and by unit tests with
+ * hand-built inputs.
+ *
+ * @param env    - Full environment status (from detectEnvironment or a fake).
+ * @param extras - Supplemental runtime info (node version, write probe, etc.).
+ * @param color  - Whether to emit ANSI colour codes.
+ */
+export declare function buildDoctorReport(env: EnvironmentStatus, extras: DoctorExtras, color: boolean): string[];
+/**
+ * Detect the environment, probe I/O, build the report, and write it to `out`.
+ *
+ * Returns 0 when at least one provider is installed, 1 otherwise.
+ * Never calls process.exit — that is handled exclusively by src/cli.ts.
+ */
+export declare function runDoctor(out: OutputSink): Promise<number>;

package/dist/commands/doctor.js

@@ -0,0 +1,115 @@
+/**
+ * src/commands/doctor.ts — `myshell-tools doctor` health-check command.
+ *
+ * Probes the runtime environment (providers, filesystem, pricing) and prints
+ * an honest, human-readable report to an OutputSink. All displayed data comes
+ * from real detection results — no fabricated values.
+ *
+ * Honesty contract: authentication status for Claude is labelled OPTIMISTIC
+ * because we cannot cheaply probe auth state without spending API quota.
+ */
+import { access, mkdir, writeFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { detectEnvironment, getInstallCommand } from '../providers/detect.js';
+import { isPricingStale } from '../infra/pricing.js';
+import { bold, green, red, yellow, dim, divider, label } from '../ui/theme.js';
+/**
+ * Build the doctor report lines from pre-collected data.
+ *
+ * Pure function: no I/O, no process.exit, no side effects.
+ * Used by runDoctor after it collects the real data, and by unit tests with
+ * hand-built inputs.
+ *
+ * @param env    - Full environment status (from detectEnvironment or a fake).
+ * @param extras - Supplemental runtime info (node version, write probe, etc.).
+ * @param color  - Whether to emit ANSI colour codes.
+ */
+export function buildDoctorReport(env, extras, color) {
+    const lines = [];
+    lines.push(bold('myshell-tools doctor', color));
+    lines.push(divider(color));
+    // ---- Platform & Node -------------------------------------------------------
+    lines.push(`${label('Platform', color)}: ${env.platform}`);
+    lines.push(`${label('Node', color)}:     ${extras.nodeVersion}`);
+    // ---- .myshell-tools writability ---------------------------------------------------
+    const writableText = extras.stateWritable
+        ? green('writable', color)
+        : red('not writable', color);
+    lines.push(`${label('.myshell-tools dir', color)}: ${writableText}`);
+    // ---- Pricing staleness -----------------------------------------------------
+    const pricingText = extras.pricingStale
+        ? yellow('stale — consider updating myshell-tools', color)
+        : green('up to date', color);
+    lines.push(`${label('Pricing table', color)}: ${pricingText}`);
+    lines.push(divider(color));
+    // ---- Providers -------------------------------------------------------------
+    lines.push(bold('Providers', color));
+    for (const ps of [env.claude, env.codex]) {
+        if (ps.installed) {
+            const versionStr = ps.version !== null ? ps.version : 'unknown';
+            lines.push(`  ${green('✓', color)} ${bold(ps.id, color)} — installed, version: ${versionStr}`);
+            // Auth is optimistic for Claude; codex is always not-installed for now
+            if (ps.id === 'claude') {
+                lines.push(`    ${label('auth', color)}: ${dim('assumed; verified on first run', color)}`);
+            }
+        }
+        else {
+            lines.push(`  ${red('✗', color)} ${bold(ps.id, color)} — ${red('not installed', color)}`);
+            lines.push(`    ${dim(`Install: ${getInstallCommand(ps.id)}`, color)}`);
+        }
+    }
+    lines.push(divider(color));
+    // ---- Overall status --------------------------------------------------------
+    if (env.hasAnyProvider) {
+        lines.push(green('Ready — at least one provider is available.', color));
+    }
+    else {
+        lines.push(red('No providers found.', color) +
+            ' Install claude or codex to use myshell-tools.');
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// I/O runner — called by cli.ts
+// ---------------------------------------------------------------------------
+/**
+ * Probe the .myshell-tools directory for writability.
+ *
+ * Creates .myshell-tools/ if needed, writes a temp file, then removes it.
+ * Returns true when successful, false on any I/O error.
+ */
+async function probestateWritable(cwd) {
+    const stateDir = join(cwd, '.myshell-tools');
+    const probe = join(stateDir, '.doctor-probe');
+    try {
+        await mkdir(stateDir, { recursive: true });
+        await writeFile(probe, '');
+        await rm(probe, { force: true });
+        await access(stateDir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect the environment, probe I/O, build the report, and write it to `out`.
+ *
+ * Returns 0 when at least one provider is installed, 1 otherwise.
+ * Never calls process.exit — that is handled exclusively by src/cli.ts.
+ */
+export async function runDoctor(out) {
+    const env = await detectEnvironment();
+    const stateWritable = await probestateWritable(process.cwd());
+    const extras = {
+        nodeVersion: process.version,
+        stateWritable,
+        pricingStale: isPricingStale(),
+    };
+    const lines = buildDoctorReport(env, extras, out.color);
+    for (const line of lines) {
+        out.write(line + '\n');
+    }
+    return env.hasAnyProvider ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/core/assess.d.ts

@@ -0,0 +1,25 @@
+/**
+ * src/core/assess.ts — parse real confidence signals from model output.
+ *
+ * The model is instructed (via prompt.ts) to end its response with a JSON
+ * envelope on its own line:
+ *   {"confidence": 0.0-1.0, "escalate": true|false, "reason": "...", "needs_review": true|false}
+ *
+ * Honesty Contract: if the envelope is absent, truncated, or malformed we
+ * return confidence=null. We NEVER guess or fabricate a confidence number from
+ * keywords or heuristics (that was the v1 sin). This function must never throw
+ * on any input — it degrades gracefully on all malformed/garbage data.
+ *
+ * Pure module: no I/O, no time, no randomness.
+ */
+import type { Assessment } from './types.js';
+/**
+ * Parse a trailing JSON confidence envelope from `output`.
+ *
+ * Returns real parsed values when the envelope is present and valid.
+ * Returns `{ confidence: null, escalate: false, reason: 'no confidence envelope', needsReview: false }`
+ * when the envelope is absent or unparseable.
+ *
+ * @param output - The full text output from the model.
+ */
+export declare function assess(output: string): Assessment;

package/dist/core/assess.js

@@ -0,0 +1,142 @@
+/**
+ * src/core/assess.ts — parse real confidence signals from model output.
+ *
+ * The model is instructed (via prompt.ts) to end its response with a JSON
+ * envelope on its own line:
+ *   {"confidence": 0.0-1.0, "escalate": true|false, "reason": "...", "needs_review": true|false}
+ *
+ * Honesty Contract: if the envelope is absent, truncated, or malformed we
+ * return confidence=null. We NEVER guess or fabricate a confidence number from
+ * keywords or heuristics (that was the v1 sin). This function must never throw
+ * on any input — it degrades gracefully on all malformed/garbage data.
+ *
+ * Pure module: no I/O, no time, no randomness.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Attempt to extract the last JSON object from `text` that looks like a
+ * confidence envelope.  Returns the raw parsed object or null.
+ *
+ * Strategy: scan backwards for the last `{...}` block that contains at least
+ * the `confidence` key, then try to parse it.  This is robust to:
+ *  - trailing whitespace / newlines
+ *  - the model emitting extra text after the envelope (we pick the LAST match)
+ *  - duplicate envelopes (last one wins — the model may have regenerated it)
+ *  - garbage / truncated JSON elsewhere in the output
+ */
+function extractEnvelope(text) {
+    // Find all candidates: substrings that start with '{' and end with '}'
+    // We do this by iterating over all '{' positions and trying to match the
+    // closing '}', handling depth.  We collect all valid JSON objects and
+    // return the last one that has a 'confidence' key.
+    const candidates = [];
+    let i = 0;
+    while (i < text.length) {
+        const start = text.indexOf('{', i);
+        if (start === -1)
+            break;
+        // Walk forward tracking brace depth to find the matching '}'
+        let depth = 0;
+        let j = start;
+        let foundClose = false;
+        while (j < text.length) {
+            if (text[j] === '{') {
+                depth++;
+            }
+            else if (text[j] === '}') {
+                depth--;
+                if (depth === 0) {
+                    foundClose = true;
+                    break;
+                }
+            }
+            j++;
+        }
+        if (foundClose) {
+            const candidate = text.slice(start, j + 1);
+            try {
+                const parsed = JSON.parse(candidate);
+                if (parsed !== null &&
+                    typeof parsed === 'object' &&
+                    !Array.isArray(parsed) &&
+                    'confidence' in parsed) {
+                    candidates.push(parsed);
+                }
+            }
+            catch {
+                // Not valid JSON — skip
+            }
+        }
+        i = start + 1;
+    }
+    if (candidates.length === 0)
+        return null;
+    // Return the last valid envelope (handles duplicate/regenerated envelopes)
+    return candidates[candidates.length - 1] ?? null;
+}
+/**
+ * Clamp a number to [0, 1].
+ */
+function clamp01(n) {
+    return Math.min(1, Math.max(0, n));
+}
+/**
+ * Coerce an unknown value to boolean — any truthy value maps to true.
+ */
+function coerceBool(v) {
+    if (typeof v === 'boolean')
+        return v;
+    if (typeof v === 'number')
+        return v !== 0;
+    if (typeof v === 'string')
+        return v === 'true' || v === '1';
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a trailing JSON confidence envelope from `output`.
+ *
+ * Returns real parsed values when the envelope is present and valid.
+ * Returns `{ confidence: null, escalate: false, reason: 'no confidence envelope', needsReview: false }`
+ * when the envelope is absent or unparseable.
+ *
+ * @param output - The full text output from the model.
+ */
+export function assess(output) {
+    const NULL_RESULT = {
+        confidence: null,
+        escalate: false,
+        reason: 'no confidence envelope',
+        needsReview: false,
+    };
+    // Guard: never throw on any input
+    if (typeof output !== 'string' || output.length === 0) {
+        return NULL_RESULT;
+    }
+    let envelope;
+    try {
+        envelope = extractEnvelope(output);
+    }
+    catch {
+        return NULL_RESULT;
+    }
+    if (envelope === null) {
+        return NULL_RESULT;
+    }
+    // Validate confidence: must be a finite number
+    if (typeof envelope.confidence !== 'number' || !isFinite(envelope.confidence)) {
+        return NULL_RESULT;
+    }
+    const confidence = clamp01(envelope.confidence);
+    const escalate = coerceBool(envelope.escalate);
+    const needsReview = coerceBool(envelope.needs_review);
+    const reason = typeof envelope.reason === 'string' && envelope.reason.trim().length > 0
+        ? envelope.reason.trim()
+        : 'model provided no reason';
+    return { confidence, escalate, reason, needsReview };
+}
+//# sourceMappingURL=assess.js.map

package/dist/core/assess.js.map

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

package/dist/core/classify.d.ts

@@ -0,0 +1,19 @@
+/**
+ * src/core/classify.ts — pure task classification.
+ *
+ * Determines the orchestration tier and security risk level from a free-text
+ * task description using keyword/regex signals. No I/O, no time, no randomness.
+ *
+ * Honesty Contract: no fabricated confidence numbers are produced here.
+ * The rationale field names the matched signal so callers can audit decisions.
+ */
+import type { Classification } from './types.js';
+/**
+ * Classify a free-text `task` string into a {@link Classification}.
+ *
+ * Tier priority: manager > worker > ic (ic is the default).
+ * Risk priority: critical > high > medium > low (low is the default).
+ *
+ * @param task - The raw task description from the user.
+ */
+export declare function classify(task: string): Classification;

package/dist/core/classify.js

@@ -0,0 +1,80 @@
+/**
+ * src/core/classify.ts — pure task classification.
+ *
+ * Determines the orchestration tier and security risk level from a free-text
+ * task description using keyword/regex signals. No I/O, no time, no randomness.
+ *
+ * Honesty Contract: no fabricated confidence numbers are produced here.
+ * The rationale field names the matched signal so callers can audit decisions.
+ */
+// ---------------------------------------------------------------------------
+// Tier signal tables
+// ---------------------------------------------------------------------------
+/** Words that signal a manager-tier task (review, planning, architecture, security). */
+const MANAGER_WORDS = /\b(review|plan|design|architect|audit|security|threat|evaluate|assess|complex)\b/i;
+/** Words that signal a worker-tier task (read-only lookups, searches). */
+const WORKER_WORDS = /\b(find|search|grep|locate|list|read[-\s]only|lookup|scan|what\s+is)\b/i;
+// ---------------------------------------------------------------------------
+// Risk signal tables — highest match wins
+// ---------------------------------------------------------------------------
+/** Critical: auth / secrets / credentials / encryption artefacts. */
+const CRITICAL_RE = /\b(auth|credential|secret|password|token|key|encrypt|certificate)\b|\.env\b/i;
+/** High: payments, deploys, migrations, CI/CD, permissions, schema changes. */
+const HIGH_RE = /\b(login|payment|billing|deploy|migration|ci\/cd|permission|schema)\b/i;
+/** Medium: tests, configs, shared utilities, integrations. */
+const MEDIUM_RE = /\b(test|spec|config|integration|shared|util|lib)\b/i;
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Classify a free-text `task` string into a {@link Classification}.
+ *
+ * Tier priority: manager > worker > ic (ic is the default).
+ * Risk priority: critical > high > medium > low (low is the default).
+ *
+ * @param task - The raw task description from the user.
+ */
+export function classify(task) {
+    // --- Tier ---
+    let tier;
+    let tierSignal;
+    if (MANAGER_WORDS.test(task)) {
+        tier = 'manager';
+        const m = task.match(MANAGER_WORDS);
+        tierSignal = m ? `manager keyword '${m[0].toLowerCase()}'` : 'manager keyword';
+    }
+    else if (WORKER_WORDS.test(task)) {
+        tier = 'worker';
+        const m = task.match(WORKER_WORDS);
+        tierSignal = m ? `worker keyword '${m[0].toLowerCase()}'` : 'worker keyword';
+    }
+    else {
+        tier = 'ic';
+        tierSignal = 'no tier keyword matched — defaulting to ic';
+    }
+    // --- Risk ---
+    let risk;
+    let riskSignal;
+    if (CRITICAL_RE.test(task)) {
+        risk = 'critical';
+        const m = task.match(CRITICAL_RE);
+        riskSignal = `critical keyword '${m ? m[0].toLowerCase() : 'unknown'}'`;
+    }
+    else if (HIGH_RE.test(task)) {
+        risk = 'high';
+        const m = task.match(HIGH_RE);
+        riskSignal = `high keyword '${m ? m[0].toLowerCase() : 'unknown'}'`;
+    }
+    else if (MEDIUM_RE.test(task)) {
+        risk = 'medium';
+        const m = task.match(MEDIUM_RE);
+        riskSignal = `medium keyword '${m ? m[0].toLowerCase() : 'unknown'}'`;
+    }
+    else {
+        risk = 'low';
+        riskSignal = 'no risk keyword matched — defaulting to low';
+    }
+    const rationale = `tier: ${tierSignal}; risk: ${riskSignal}`;
+    return { tier, risk, rationale };
+}
+//# sourceMappingURL=classify.js.map

package/dist/core/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/core/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,wFAAwF;AACxF,MAAM,aAAa,GACjB,mFAAmF,CAAC;AAEtF,0EAA0E;AAC1E,MAAM,YAAY,GAChB,yEAAyE,CAAC;AAE5E,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,qEAAqE;AACrE,MAAM,WAAW,GACf,8EAA8E,CAAC;AAEjF,+EAA+E;AAC/E,MAAM,OAAO,GACX,wEAAwE,CAAC;AAE3E,8DAA8D;AAC9D,MAAM,SAAS,GACb,qDAAqD,CAAC;AAExD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,eAAe;IACf,IAAI,IAAU,CAAC;IACf,IAAI,UAAkB,CAAC;IAEvB,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,IAAI,GAAG,SAAS,CAAC;QACjB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACpC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACjF,CAAC;SAAM,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,GAAG,QAAQ,CAAC;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACnC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,IAAI,CAAC;QACZ,UAAU,GAAG,4CAA4C,CAAC;IAC5D,CAAC;IAED,eAAe;IACf,IAAI,IAAU,CAAC;IACf,IAAI,UAAkB,CAAC;IAEvB,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,IAAI,GAAG,UAAU,CAAC;QAClB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAClC,UAAU,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC;IAC1E,CAAC;SAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,IAAI,GAAG,MAAM,CAAC;QACd,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC;IACtE,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,IAAI,GAAG,QAAQ,CAAC;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,UAAU,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC;IACxE,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,KAAK,CAAC;QACb,UAAU,GAAG,6CAA6C,CAAC;IAC7D,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,UAAU,WAAW,UAAU,EAAE,CAAC;IAE7D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC"}

package/dist/core/escalate.d.ts

@@ -0,0 +1,32 @@
+/**
+ * src/core/escalate.ts — pure escalation helpers.
+ *
+ * Provides utilities for determining the next tier in the escalation chain
+ * and selecting a cross-vendor reviewer.
+ *
+ * Pure module: no I/O, no time, no randomness.
+ */
+import type { Tier } from './types.js';
+import type { ProviderId } from '../providers/port.js';
+/**
+ * Return the next tier up from the given tier, or null if already at the top.
+ *
+ * Chain: worker → ic → manager → null
+ *
+ * @param tier - The current orchestration tier.
+ */
+export declare function nextTierUp(tier: Tier): Tier | null;
+/**
+ * Pick a reviewer provider from the available list, preferring cross-vendor
+ * review over same-vendor review.
+ *
+ * Algorithm:
+ *  1. If `available` is empty, return null.
+ *  2. Prefer a provider with a DIFFERENT id than `primary` (cross-vendor review).
+ *  3. If all available are the same vendor as primary, return `primary` if it
+ *     is in `available`, else return null.
+ *
+ * @param available - Provider IDs that are currently reachable.
+ * @param primary   - The provider ID that ran the IC work being reviewed.
+ */
+export declare function pickReviewer(available: ProviderId[], primary: ProviderId): ProviderId | null;

package/dist/core/escalate.js

@@ -0,0 +1,57 @@
+/**
+ * src/core/escalate.ts — pure escalation helpers.
+ *
+ * Provides utilities for determining the next tier in the escalation chain
+ * and selecting a cross-vendor reviewer.
+ *
+ * Pure module: no I/O, no time, no randomness.
+ */
+// ---------------------------------------------------------------------------
+// Tier chain
+// ---------------------------------------------------------------------------
+/**
+ * Return the next tier up from the given tier, or null if already at the top.
+ *
+ * Chain: worker → ic → manager → null
+ *
+ * @param tier - The current orchestration tier.
+ */
+export function nextTierUp(tier) {
+    switch (tier) {
+        case 'worker':
+            return 'ic';
+        case 'ic':
+            return 'manager';
+        case 'manager':
+            return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Reviewer selection
+// ---------------------------------------------------------------------------
+/**
+ * Pick a reviewer provider from the available list, preferring cross-vendor
+ * review over same-vendor review.
+ *
+ * Algorithm:
+ *  1. If `available` is empty, return null.
+ *  2. Prefer a provider with a DIFFERENT id than `primary` (cross-vendor review).
+ *  3. If all available are the same vendor as primary, return `primary` if it
+ *     is in `available`, else return null.
+ *
+ * @param available - Provider IDs that are currently reachable.
+ * @param primary   - The provider ID that ran the IC work being reviewed.
+ */
+export function pickReviewer(available, primary) {
+    if (available.length === 0)
+        return null;
+    // Prefer a different vendor (cross-vendor review is the goal)
+    const crossVendor = available.find((id) => id !== primary);
+    if (crossVendor !== undefined)
+        return crossVendor;
+    // All available are same vendor — return primary if it's in the list
+    if (available.includes(primary))
+        return primary;
+    return null;
+}
+//# sourceMappingURL=escalate.js.map

package/dist/core/escalate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalate.js","sourceRoot":"","sources":["../../src/core/escalate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC;QACd,KAAK,IAAI;YACP,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,SAAuB,EAAE,OAAmB;IACvE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAExC,8DAA8D;IAC9D,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC3D,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAElD,qEAAqE;IACrE,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAEhD,OAAO,IAAI,CAAC;AACd,CAAC"}