@ashlr/hub 2.2.0 → 3.0.1

package/dist/cli/eval-fixtures.js

@@ -0,0 +1,38 @@
+/**
+ * M44 — fixed eval fixtures.
+ *
+ * A small, deterministic set of SHORT, self-contained coding/reasoning goals a
+ * 7B-class local model can attempt without any engineer tools. Used by the
+ * `ashlr eval` harness to compare the agent loop with adaptive prompts OFF vs
+ * ON and prove the M41–M43 uplift.
+ *
+ * Keep these tool-free-friendly (no file I/O, no repo context) so a run can
+ * complete on a bare local provider with `{ tools: false }`.
+ */
+export const EVAL_FIXTURES = [
+    {
+        id: 'palindrome',
+        goal: 'Write a TypeScript function `isPalindrome(s: string): boolean` and show its code.',
+    },
+    {
+        id: 'debounce-explain',
+        goal: 'Explain in exactly 3 bullet points what a debounce function does.',
+    },
+    {
+        id: 'fizzbuzz',
+        goal: 'Write a JavaScript function that prints FizzBuzz for numbers 1 to 15. Show the code.',
+    },
+    {
+        id: 'reverse-words',
+        goal: 'Write a Python function `reverse_words(s: str) -> str` that reverses the order of words in a sentence. Show the code.',
+    },
+    {
+        id: 'http-vs-https',
+        goal: 'In 2 sentences, explain the difference between HTTP and HTTPS.',
+    },
+    {
+        id: 'sum-array',
+        goal: 'Write a one-line TypeScript expression that sums an array of numbers named `xs`.',
+    },
+];
+//# sourceMappingURL=eval-fixtures.js.map

package/dist/cli/eval-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval-fixtures.js","sourceRoot":"","sources":["../../src/cli/eval-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,mFAAmF;KAC1F;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,mEAAmE;KAC1E;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,sFAAsF;KAC7F;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,uHAAuH;KAC9H;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,gEAAgE;KACvE;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,kFAAkF;KACzF;CACF,CAAC"}

package/dist/cli/eval.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `ashlr eval` — M44 local-agent eval harness.
+ *
+ * Runs a fixed set of small coding/reasoning goals (see eval-fixtures.ts)
+ * through the hub's own agent loop TWICE per fixture — once with adaptive
+ * prompts OFF, once ON — and reports per-fixture metrics (steps-to-done,
+ * status, tokens). This is the "proof" milestone for the M41–M43 uplift.
+ *
+ * Adaptive prompts are toggled via the ASHLR_ADAPTIVE_PROMPTS env var, which
+ * adaptivePromptsEnabled(cfg) reads FIRST (before cfg.models.adaptivePrompts).
+ *
+ *   ashlr eval [--budget N] [--limit N] [--json]
+ *
+ * Exit codes:
+ *   0  always (even when no local model — prints a clear hint and returns 0)
+ */
+/** Per-fixture result after running OFF then ON. */
+export interface EvalRow {
+    id: string;
+    goal: string;
+    /** Steps taken with adaptive prompts OFF. */
+    stepsOff: number;
+    /** Steps taken with adaptive prompts ON. */
+    stepsOn: number;
+    /** Whether the OFF run reached status 'done'. */
+    doneOff: boolean;
+    /** Whether the ON run reached status 'done'. */
+    doneOn: boolean;
+    /** Total tokens (in+out) for the OFF run. */
+    tokensOff: number;
+    /** Total tokens (in+out) for the ON run. */
+    tokensOn: number;
+    /** Set when the fixture failed to run at all (caught error). */
+    error?: string;
+}
+/** Aggregate over all rows. */
+export interface EvalSummary {
+    fixtures: number;
+    totalStepsOff: number;
+    totalStepsOn: number;
+    doneOff: number;
+    doneOn: number;
+    totalTokensOff: number;
+    totalTokensOn: number;
+    errors: number;
+}
+/** Aggregate EvalRows into a summary. Pure. */
+export declare function summarize(rows: EvalRow[]): EvalSummary;
+/**
+ * Render a plain (no-color) eval table + summary as a string. Pure — does no
+ * I/O, takes no color dependencies, so it's deterministic and unit-testable.
+ *
+ * Columns: id | off(done/steps/tokens) | on(done/steps/tokens).
+ */
+export declare function formatEvalTable(rows: EvalRow[]): string;
+export declare function cmdEval(args: string[]): Promise<number>;

package/dist/cli/eval.js

@@ -0,0 +1,283 @@
+/**
+ * `ashlr eval` — M44 local-agent eval harness.
+ *
+ * Runs a fixed set of small coding/reasoning goals (see eval-fixtures.ts)
+ * through the hub's own agent loop TWICE per fixture — once with adaptive
+ * prompts OFF, once ON — and reports per-fixture metrics (steps-to-done,
+ * status, tokens). This is the "proof" milestone for the M41–M43 uplift.
+ *
+ * Adaptive prompts are toggled via the ASHLR_ADAPTIVE_PROMPTS env var, which
+ * adaptivePromptsEnabled(cfg) reads FIRST (before cfg.models.adaptivePrompts).
+ *
+ *   ashlr eval [--budget N] [--limit N] [--json]
+ *
+ * Exit codes:
+ *   0  always (even when no local model — prints a clear hint and returns 0)
+ */
+import { EVAL_FIXTURES } from './eval-fixtures.js';
+import { makeColors, isTty, pad } from './ui.js';
+const { bold, dim, yellow, red, cyan, gray } = makeColors(isTty());
+// ---------------------------------------------------------------------------
+// Pure helpers — exported for unit testing
+// ---------------------------------------------------------------------------
+/** Aggregate EvalRows into a summary. Pure. */
+export function summarize(rows) {
+    const s = {
+        fixtures: rows.length,
+        totalStepsOff: 0,
+        totalStepsOn: 0,
+        doneOff: 0,
+        doneOn: 0,
+        totalTokensOff: 0,
+        totalTokensOn: 0,
+        errors: 0,
+    };
+    for (const r of rows) {
+        s.totalStepsOff += r.stepsOff;
+        s.totalStepsOn += r.stepsOn;
+        s.totalTokensOff += r.tokensOff;
+        s.totalTokensOn += r.tokensOn;
+        if (r.doneOff)
+            s.doneOff++;
+        if (r.doneOn)
+            s.doneOn++;
+        if (r.error)
+            s.errors++;
+    }
+    return s;
+}
+/**
+ * Render a plain (no-color) eval table + summary as a string. Pure — does no
+ * I/O, takes no color dependencies, so it's deterministic and unit-testable.
+ *
+ * Columns: id | off(done/steps/tokens) | on(done/steps/tokens).
+ */
+export function formatEvalTable(rows) {
+    const idW = Math.max(8, ...rows.map((r) => r.id.length));
+    const cell = (s, w) => s + ' '.repeat(Math.max(0, w - s.length));
+    const num = (n) => String(n);
+    const doneMark = (b) => (b ? 'done' : 'fail');
+    const lines = [];
+    lines.push('Adaptive prompts: OFF vs ON');
+    lines.push('');
+    lines.push(`${cell('id', idW)}  ${cell('off:done', 10)} ${cell('off:steps', 10)} ${cell('off:tok', 10)}  ` +
+        `${cell('on:done', 10)} ${cell('on:steps', 10)} ${cell('on:tok', 10)}`);
+    lines.push('-'.repeat(idW + 2 + 33 + 2 + 33));
+    for (const r of rows) {
+        if (r.error) {
+            lines.push(`${cell(r.id, idW)}  ERROR: ${r.error}`);
+            continue;
+        }
+        lines.push(`${cell(r.id, idW)}  ` +
+            `${cell(doneMark(r.doneOff), 10)} ${cell(num(r.stepsOff), 10)} ${cell(num(r.tokensOff), 10)}  ` +
+            `${cell(doneMark(r.doneOn), 10)} ${cell(num(r.stepsOn), 10)} ${cell(num(r.tokensOn), 10)}`);
+    }
+    const s = summarize(rows);
+    lines.push('');
+    lines.push(`TOTAL  fixtures=${s.fixtures}  done OFF=${s.doneOff}/${s.fixtures} ON=${s.doneOn}/${s.fixtures}  ` +
+        `steps OFF=${s.totalStepsOff} ON=${s.totalStepsOn}  ` +
+        `tokens OFF=${s.totalTokensOff} ON=${s.totalTokensOn}` +
+        (s.errors ? `  errors=${s.errors}` : ''));
+    return lines.join('\n');
+}
+const DEFAULT_EVAL_BUDGET = 4000;
+function parseEvalArgs(args) {
+    const result = { budget: DEFAULT_EVAL_BUDGET, json: false };
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--json') {
+            result.json = true;
+            i++;
+        }
+        else if (arg === '--budget') {
+            const v = Number(args[++i]);
+            if (!Number.isFinite(v) || v <= 0) {
+                result.usageError = '--budget requires a positive number';
+                return result;
+            }
+            result.budget = Math.floor(v);
+            i++;
+        }
+        else if (arg === '--limit') {
+            const v = Number(args[++i]);
+            if (!Number.isFinite(v) || v <= 0) {
+                result.usageError = '--limit requires a positive number';
+                return result;
+            }
+            result.limit = Math.floor(v);
+            i++;
+        }
+        else {
+            result.usageError = `unknown flag: ${arg}`;
+            return result;
+        }
+    }
+    return result;
+}
+function buildOpts(budget) {
+    // noCapture lives on the run.ts parse layer (not on RunOptions), so we attach
+    // it via the same extra-prop escape hatch the CLI uses; it's ignored if unread.
+    const opts = {
+        budget: { maxTokens: budget },
+        parallel: 1,
+        tools: false,
+        json: true,
+        noMemory: true,
+        noCapture: true,
+    };
+    return opts;
+}
+/**
+ * Run a single fixture twice. Any failure is caught and recorded on the row —
+ * one bad fixture never aborts the whole eval.
+ */
+async function evalFixture(fixture, cfg, budget, runGoal) {
+    const row = {
+        id: fixture.id,
+        goal: fixture.goal,
+        stepsOff: 0,
+        stepsOn: 0,
+        doneOff: false,
+        doneOn: false,
+        tokensOff: 0,
+        tokensOn: 0,
+    };
+    const prev = process.env.ASHLR_ADAPTIVE_PROMPTS;
+    try {
+        // ── OFF ────────────────────────────────────────────────────────────────
+        process.env.ASHLR_ADAPTIVE_PROMPTS = '0';
+        const off = await runGoal(fixture.goal, cfg, buildOpts(budget));
+        row.stepsOff = off.usage.steps;
+        row.doneOff = off.status === 'done';
+        row.tokensOff = off.usage.tokensIn + off.usage.tokensOut;
+        // ── ON ─────────────────────────────────────────────────────────────────
+        process.env.ASHLR_ADAPTIVE_PROMPTS = '1';
+        const on = await runGoal(fixture.goal, cfg, buildOpts(budget));
+        row.stepsOn = on.usage.steps;
+        row.doneOn = on.status === 'done';
+        row.tokensOn = on.usage.tokensIn + on.usage.tokensOut;
+    }
+    catch (err) {
+        row.error = err instanceof Error ? err.message : String(err);
+    }
+    finally {
+        // Restore the env var to its pre-fixture value.
+        if (prev === undefined)
+            delete process.env.ASHLR_ADAPTIVE_PROMPTS;
+        else
+            process.env.ASHLR_ADAPTIVE_PROMPTS = prev;
+    }
+    return row;
+}
+// ---------------------------------------------------------------------------
+// `ashlr eval` — main
+// ---------------------------------------------------------------------------
+export async function cmdEval(args) {
+    if (args[0] === '--help' || args[0] === '-h' || args[0] === 'help') {
+        printEvalHelp();
+        return 0;
+    }
+    const parsed = parseEvalArgs(args);
+    if (parsed.usageError) {
+        process.stderr.write(red('error: ') + parsed.usageError + '\n');
+        return 2;
+    }
+    // Load config.
+    let cfg;
+    try {
+        const { loadConfig } = await import('../core/config.js');
+        cfg = loadConfig();
+    }
+    catch (err) {
+        process.stderr.write(red('error: ') + 'Failed to load config: ' +
+            (err instanceof Error ? err.message : String(err)) + '\n');
+        return 1;
+    }
+    // Guard: a local provider must be reachable. getActiveClient throws when no
+    // local provider is up (and allowCloud:false). If so, the eval cannot run —
+    // print a clear hint and return 0 (graceful, not an error).
+    try {
+        const { getActiveClient } = await import('../core/run/provider-client.js');
+        await getActiveClient(cfg, { allowCloud: false });
+    }
+    catch {
+        const msg = 'eval needs a local model — start Ollama or LM Studio, then re-run `ashlr eval`.';
+        if (parsed.json) {
+            process.stdout.write(JSON.stringify({ skipped: true, reason: msg }) + '\n');
+        }
+        else {
+            process.stdout.write('\n  ' + yellow('eval skipped: ') + msg + '\n\n');
+        }
+        return 0;
+    }
+    // Load orchestrator.
+    let runGoal;
+    try {
+        const mod = await import('../core/run/orchestrator.js');
+        runGoal = mod.runGoal;
+    }
+    catch (err) {
+        process.stderr.write(red('error: ') + 'Failed to load orchestrator: ' +
+            (err instanceof Error ? err.message : String(err)) + '\n');
+        return 1;
+    }
+    const fixtures = parsed.limit ? EVAL_FIXTURES.slice(0, parsed.limit) : EVAL_FIXTURES;
+    if (!parsed.json) {
+        process.stderr.write(seInfo(`running ${fixtures.length} fixture(s) × 2 (adaptive OFF/ON), budget ${parsed.budget} tok each\n`));
+    }
+    const rows = [];
+    for (const fixture of fixtures) {
+        if (!parsed.json) {
+            process.stderr.write(seInfo(`  • ${fixture.id} …\n`));
+        }
+        const row = await evalFixture(fixture, cfg, parsed.budget, runGoal);
+        rows.push(row);
+    }
+    // Output.
+    if (parsed.json) {
+        process.stdout.write(JSON.stringify({ rows, summary: summarize(rows) }, null, 2) + '\n');
+    }
+    else {
+        console.log('');
+        console.log(bold('  ashlr eval') + dim(' — M44 adaptive-prompt proof'));
+        console.log('');
+        for (const line of formatEvalTable(rows).split('\n')) {
+            console.log('  ' + line);
+        }
+        console.log('');
+    }
+    return 0;
+}
+// stderr progress helper (kept terse; cyan when TTY)
+function seInfo(s) {
+    return process.stderr.isTTY ? cyan(s) : s;
+}
+function printEvalHelp() {
+    console.log('');
+    console.log(bold('  ashlr eval') + dim(' — local-agent eval harness (M44)'));
+    console.log('');
+    console.log('  ' + bold('Usage:'));
+    console.log('');
+    console.log(`    ashlr eval [--budget N] [--limit N] [--json]`);
+    console.log('');
+    console.log('  ' + bold('Options:'));
+    console.log('');
+    const opts = [
+        ['--budget N', `Max tokens per run (default: ${DEFAULT_EVAL_BUDGET}).`],
+        ['--limit N', 'Only run the first N fixtures.'],
+        ['--json', 'Emit JSON { rows, summary } instead of a table.'],
+    ];
+    const w = Math.max(...opts.map(([o]) => o.length));
+    for (const [o, d] of opts) {
+        console.log(`    ${cyan(pad(o, w))}  ${d}`);
+    }
+    console.log('');
+    console.log('  ' + bold('What it does:'));
+    console.log('');
+    console.log(`    ${gray('Runs a fixed fixture set through the agent loop twice each —')}`);
+    console.log(`    ${gray('adaptive prompts OFF then ON — and reports steps/done/tokens.')}`);
+    console.log(`    ${gray('Needs a local model (Ollama / LM Studio); skips cleanly if none.')}`);
+    console.log('');
+}
+//# sourceMappingURL=eval.js.map

package/dist/cli/eval.js.map

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

package/dist/cli/fleet.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `ashlr fleet` — M49 fleet control plane + observability CLI.
+ *
+ * Subcommands:
+ *   fleet status [--json]
+ *       Print a READ-ONLY snapshot of the whole fleet: daemon liveness +
+ *       today's spend, per-backend recent dispatches + quota, queue size,
+ *       proposal counts (pending / frontier-pending / applied), recent
+ *       auto-merges, and the kill-switch (paused) state. Never mutates.
+ *   fleet pause
+ *       Engage the global kill switch (setKill(true)) — same effect as
+ *       `ashlr daemon stop`'s kill: any running loop halts on its next tick and
+ *       nothing autonomous dispatches until resumed. Idempotent.
+ *   fleet resume
+ *       Release the kill switch (setKill(false)). Idempotent.
+ *
+ * Pause/resume are the ONLY mutations here, and they touch ONLY the kill-switch
+ * sentinel (no repo, no spend, no proposals). `fleet status` is fully read-only.
+ */
+import type { FleetStatus } from '../core/fleet/status.js';
+/**
+ * Render a FleetStatus as a plain (no-color) multi-line string. Pure and
+ * deterministic — does no I/O and takes no color dependency, so it is fully
+ * unit-testable.
+ */
+export declare function formatFleetStatus(s: FleetStatus): string;
+export declare function cmdFleet(args: string[]): Promise<number>;

package/dist/cli/fleet.js

@@ -0,0 +1,222 @@
+/**
+ * `ashlr fleet` — M49 fleet control plane + observability CLI.
+ *
+ * Subcommands:
+ *   fleet status [--json]
+ *       Print a READ-ONLY snapshot of the whole fleet: daemon liveness +
+ *       today's spend, per-backend recent dispatches + quota, queue size,
+ *       proposal counts (pending / frontier-pending / applied), recent
+ *       auto-merges, and the kill-switch (paused) state. Never mutates.
+ *   fleet pause
+ *       Engage the global kill switch (setKill(true)) — same effect as
+ *       `ashlr daemon stop`'s kill: any running loop halts on its next tick and
+ *       nothing autonomous dispatches until resumed. Idempotent.
+ *   fleet resume
+ *       Release the kill switch (setKill(false)). Idempotent.
+ *
+ * Pause/resume are the ONLY mutations here, and they touch ONLY the kill-switch
+ * sentinel (no repo, no spend, no proposals). `fleet status` is fully read-only.
+ */
+import { makeColors, isTty } from './ui.js';
+const { bold, dim, green, red, yellow, cyan } = makeColors(isTty());
+// ---------------------------------------------------------------------------
+// Pure formatter — exported for unit testing (no I/O, no color deps).
+// ---------------------------------------------------------------------------
+/**
+ * Render a FleetStatus as a plain (no-color) multi-line string. Pure and
+ * deterministic — does no I/O and takes no color dependency, so it is fully
+ * unit-testable.
+ */
+export function formatFleetStatus(s) {
+    const lines = [];
+    const pausedTag = s.killed ? '  [PAUSED — kill switch engaged]' : '';
+    lines.push('Fleet status' + pausedTag);
+    lines.push('');
+    // Daemon
+    lines.push(`Daemon:    ${s.daemon.running ? 'running' : 'stopped'}`);
+    lines.push(`  last tick:     ${s.daemon.lastTickAt ?? '—'}`);
+    lines.push(`  spend today:   $${s.daemon.todaySpentUsd.toFixed(4)}`);
+    lines.push('');
+    // Backends
+    lines.push('Backends:');
+    if (s.backends.length === 0) {
+        lines.push('  (none)');
+    }
+    else {
+        const nameW = Math.max(8, ...s.backends.map((b) => b.backend.length));
+        for (const b of s.backends) {
+            const name = b.backend + ' '.repeat(Math.max(0, nameW - b.backend.length));
+            lines.push(`  ${name}  dispatches(24h)=${b.dispatchesRecent}  quota=${b.quota}`);
+        }
+    }
+    lines.push('');
+    // Queue
+    lines.push(`Queue:     ${s.queue.backlogItems} backlog item(s)`);
+    lines.push('');
+    // Proposals
+    lines.push('Proposals:');
+    lines.push(`  pending:           ${s.proposals.pending}`);
+    lines.push(`  frontier pending:  ${s.proposals.frontierPending}`);
+    lines.push(`  applied:           ${s.proposals.applied}`);
+    lines.push('');
+    // Merges
+    lines.push(`Merges:    ${s.merges.recent} auto-merge(s) in last 24h`);
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Config loader (lazy, graceful)
+// ---------------------------------------------------------------------------
+async function loadCfg() {
+    try {
+        const { loadConfig } = await import('../core/config.js');
+        return loadConfig();
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Subcommand: status (READ-ONLY)
+// ---------------------------------------------------------------------------
+async function cmdFleetStatus(jsonMode) {
+    const cfg = await loadCfg();
+    if (!cfg) {
+        process.stderr.write(red('error: ') + 'failed to load config.\n');
+        return 1;
+    }
+    let status;
+    try {
+        const { buildFleetStatus } = await import('../core/fleet/status.js');
+        status = await buildFleetStatus(cfg);
+    }
+    catch (err) {
+        process.stderr.write(red('error: ') + 'failed to build fleet status: ' +
+            (err instanceof Error ? err.message : String(err)) + '\n');
+        return 1;
+    }
+    if (jsonMode) {
+        process.stdout.write(JSON.stringify(status, null, 2) + '\n');
+        return 0;
+    }
+    console.log('');
+    console.log(bold('  ashlr fleet') + dim(' — control plane + observability'));
+    console.log('');
+    for (const line of formatFleetStatus(status).split('\n')) {
+        // Colorize the paused banner line; leave the rest plain.
+        if (line.includes('[PAUSED'))
+            console.log('  ' + yellow(line));
+        else
+            console.log('  ' + line);
+    }
+    console.log('');
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Subcommands: pause / resume (kill-switch only)
+// ---------------------------------------------------------------------------
+async function setKillSwitch(on) {
+    try {
+        const { setKill } = await import('../core/sandbox/policy.js');
+        setKill(on);
+    }
+    catch (err) {
+        process.stderr.write(red('error: ') + 'failed to toggle kill switch: ' +
+            (err instanceof Error ? err.message : String(err)) + '\n');
+        return 1;
+    }
+    console.log('');
+    if (on) {
+        console.log(green('  ✓ fleet paused') + dim(' — kill switch engaged.'));
+        console.log(dim('  Any running loop halts on its next tick; nothing autonomous dispatches.'));
+        console.log(dim('  Resume with `ashlr fleet resume`.'));
+    }
+    else {
+        console.log(green('  ✓ fleet resumed') + dim(' — kill switch released.'));
+        console.log(dim('  The daemon may dispatch again on its next tick (if running).'));
+    }
+    console.log('');
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Main dispatch
+// ---------------------------------------------------------------------------
+/**
+ * M59: a conservative starter `cfg.foundry` block. Installed backends +
+ * OS confinement on + auto-merge OFF. No mergeAuthority models are guessed (the
+ * user pins those); no API engines are added (they need keys). Adding more is
+ * config-only — see docs/FOUNDRY-CONFIG.md.
+ */
+function starterFoundry() {
+    return {
+        allowedBackends: ['builtin', 'claude', 'codex', 'hermes'],
+        confinement: { '*': { mode: 'os', networkEgress: false, onUnsupported: 'fallback' } },
+        autoMerge: { enabled: false },
+    };
+}
+/**
+ * `ashlr fleet init [--write]` — print (default) or merge (--write, only when
+ * absent) a starter cfg.foundry. NEVER overwrites an existing foundry block.
+ */
+async function cmdFleetInit(args) {
+    const write = args.includes('--write');
+    const { loadConfig, saveConfig, CONFIG_PATH } = await import('../core/config.js');
+    const cfg = loadConfig();
+    const block = { foundry: starterFoundry() };
+    if (!write) {
+        console.log('');
+        console.log(dim('  # Starter cfg.foundry — merge into ' + CONFIG_PATH));
+        console.log(dim('  # Full reference: docs/FOUNDRY-CONFIG.md'));
+        console.log(JSON.stringify(block, null, 2));
+        console.log('');
+        console.log(dim('  Re-run `ashlr fleet init --write` to merge it (only when foundry is absent).'));
+        return 0;
+    }
+    if (cfg.foundry) {
+        console.error(yellow('note: ') +
+            'cfg.foundry already present in ' +
+            CONFIG_PATH +
+            ' — not overwriting. Edit it by hand (see docs/FOUNDRY-CONFIG.md).');
+        return 1;
+    }
+    cfg.foundry = starterFoundry();
+    saveConfig(cfg);
+    console.log(green('✓ ') +
+        'wrote a starter cfg.foundry to ' +
+        CONFIG_PATH +
+        ' (auto-merge OFF; set provider keys + pass --allow-cloud to use API backends).');
+    return 0;
+}
+export async function cmdFleet(args) {
+    const [sub, ...rest] = args;
+    if (sub === '--help' || sub === '-h' || sub === 'help' || sub === undefined) {
+        printFleetHelp();
+        return 0;
+    }
+    switch (sub) {
+        case 'status':
+            return cmdFleetStatus(rest.includes('--json'));
+        case 'init':
+            return cmdFleetInit(rest);
+        case 'pause':
+            return setKillSwitch(true);
+        case 'resume':
+            return setKillSwitch(false);
+        default:
+            process.stderr.write(red('error: ') + `unknown fleet subcommand: ${sub}\n`);
+            printFleetHelp();
+            return 2;
+    }
+}
+function printFleetHelp() {
+    console.log('');
+    console.log(bold('  ashlr fleet') + dim(' — fleet control plane + observability (M49)'));
+    console.log('');
+    console.log('  ' + bold('Usage:'));
+    console.log('');
+    console.log(`    ashlr fleet status [--json]   ${cyan('# read-only fleet snapshot')}`);
+    console.log(`    ashlr fleet init [--write]    ${cyan('# print/merge a starter cfg.foundry')}`);
+    console.log(`    ashlr fleet pause             ${cyan('# engage kill switch (pause fleet)')}`);
+    console.log(`    ashlr fleet resume            ${cyan('# release kill switch (resume fleet)')}`);
+    console.log('');
+}
+//# sourceMappingURL=fleet.js.map

package/dist/cli/fleet.js.map

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