@swarmdo/cli 1.4.8 → 1.5.0

package/dist/src/memory-vault/watch.d.ts

@@ -0,0 +1,32 @@
+/**
+ * watch.ts — debounced change collection for vault auto-sync (phase 2 of the
+ * dual-plane memory strategy: edit notes in Obsidian, they sync back to the
+ * vector DB as you save).
+ *
+ * Editors fire bursts of fs events per save (write + rename + metadata);
+ * the collector coalesces them into one flush after a quiet window, filters
+ * to real notes (.md, not INDEX.md, not dotfiles), and hands relative paths
+ * to the sync callback. Pure timing via an injectable scheduler so tests run
+ * on fake clocks.
+ */
+export interface Scheduler {
+    set(fn: () => void, ms: number): unknown;
+    clear(handle: unknown): void;
+}
+/** Should this relative path participate in a sync? */
+export declare function isSyncablePath(relPath: string): boolean;
+export declare class ChangeCollector {
+    private readonly flush;
+    private readonly quietMs;
+    private readonly scheduler;
+    private pending;
+    private handle;
+    constructor(flush: (paths: string[]) => void, quietMs?: number, scheduler?: Scheduler);
+    /** Record a change; (re)arms the quiet-window timer. */
+    add(relPath: string): void;
+    /** Flush immediately (shutdown path). No-op when empty. */
+    drain(): void;
+    get size(): number;
+    private fire;
+}
+//# sourceMappingURL=watch.d.ts.map

package/dist/src/memory-vault/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/memory-vault/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAOD,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAiB;gBAGZ,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,EAChC,OAAO,SAAO,EACd,SAAS,GAAE,SAAyB;IAGvD,wDAAwD;IACxD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO1B,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,IAAI;CAOb"}

package/dist/src/memory-vault/watch.js

@@ -0,0 +1,66 @@
+/**
+ * watch.ts — debounced change collection for vault auto-sync (phase 2 of the
+ * dual-plane memory strategy: edit notes in Obsidian, they sync back to the
+ * vector DB as you save).
+ *
+ * Editors fire bursts of fs events per save (write + rename + metadata);
+ * the collector coalesces them into one flush after a quiet window, filters
+ * to real notes (.md, not INDEX.md, not dotfiles), and hands relative paths
+ * to the sync callback. Pure timing via an injectable scheduler so tests run
+ * on fake clocks.
+ */
+const realScheduler = {
+    set: (fn, ms) => setTimeout(fn, ms),
+    clear: (h) => clearTimeout(h),
+};
+/** Should this relative path participate in a sync? */
+export function isSyncablePath(relPath) {
+    const base = relPath.split('/').pop() ?? relPath;
+    if (!base.endsWith('.md'))
+        return false;
+    if (base === 'INDEX.md')
+        return false;
+    if (relPath.split('/').some((seg) => seg.startsWith('.')))
+        return false;
+    return true;
+}
+export class ChangeCollector {
+    flush;
+    quietMs;
+    scheduler;
+    pending = new Set();
+    handle = null;
+    constructor(flush, quietMs = 1500, scheduler = realScheduler) {
+        this.flush = flush;
+        this.quietMs = quietMs;
+        this.scheduler = scheduler;
+    }
+    /** Record a change; (re)arms the quiet-window timer. */
+    add(relPath) {
+        if (!isSyncablePath(relPath))
+            return;
+        this.pending.add(relPath);
+        if (this.handle !== null)
+            this.scheduler.clear(this.handle);
+        this.handle = this.scheduler.set(() => this.fire(), this.quietMs);
+    }
+    /** Flush immediately (shutdown path). No-op when empty. */
+    drain() {
+        if (this.handle !== null)
+            this.scheduler.clear(this.handle);
+        this.handle = null;
+        this.fire();
+    }
+    get size() {
+        return this.pending.size;
+    }
+    fire() {
+        this.handle = null;
+        if (this.pending.size === 0)
+            return;
+        const batch = [...this.pending].sort();
+        this.pending.clear();
+        this.flush(batch);
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/src/memory-vault/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/memory-vault/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,aAAa,GAAc;IAC/B,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAmB,CAAC;CAChD,CAAC;AAEF,uDAAuD;AACvD,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC;IACjD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,eAAe;IAKP;IACA;IACA;IANX,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5B,MAAM,GAAY,IAAI,CAAC;IAE/B,YACmB,KAAgC,EAChC,UAAU,IAAI,EACd,YAAuB,aAAa;QAFpC,UAAK,GAAL,KAAK,CAA2B;QAChC,YAAO,GAAP,OAAO,CAAO;QACd,cAAS,GAAT,SAAS,CAA2B;IACpD,CAAC;IAEJ,wDAAwD;IACxD,GAAG,CAAC,OAAe;QACjB,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YAAE,OAAO;QACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,2DAA2D;IAC3D,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACpC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;CACF"}

package/dist/src/providers/openrouter-config.d.ts

@@ -0,0 +1,91 @@
+/**
+ * openrouter-config.ts — configurable OpenRouter model pool for swarms.
+ *
+ * The execution core has dispatched to OpenRouter since #2042, but only via
+ * env vars and a single default slug. This module makes the integration
+ * CONFIGURABLE: users declare the OpenRouter models they want their agent
+ * swarms to draw from in swarmdo.config.json, each mapped to a routing tier,
+ * and the router selects among same-tier candidates by Thompson sampling —
+ * the concrete consumer for the ADR-149 per-modelId priors.
+ *
+ *   "openrouter": {
+ *     "enabled": true,
+ *     "models": [
+ *       { "id": "meta-llama/llama-3.3-70b-instruct", "tier": "haiku" },
+ *       { "id": "deepseek/deepseek-chat",            "tier": "sonnet" },
+ *       { "id": "anthropic/claude-opus-4-5",         "tier": "opus" }
+ *     ],
+ *     "defaultModel": "anthropic/claude-sonnet-4-6"
+ *   }
+ *
+ * Everything here is pure (validation, filtering, sampling with injectable
+ * randomness) except loadOpenRouterConfig, a thin fs reader.
+ */
+export type RoutingTier = 'haiku' | 'sonnet' | 'opus';
+export interface OpenRouterModelEntry {
+    /** OpenRouter slug, e.g. 'meta-llama/llama-3.3-70b-instruct' */
+    id: string;
+    /** Which routing tier this model can serve. Untiered models are only
+     * reachable as defaultModel or by explicit slug. */
+    tier?: RoutingTier;
+    /** Free-form operator note (why it's in the pool, cost expectations…) */
+    note?: string;
+}
+export interface OpenRouterConfig {
+    enabled: boolean;
+    /** env var holding the key (default OPENROUTER_API_KEY) */
+    apiKeyEnv: string;
+    baseUrl: string;
+    defaultModel?: string;
+    models: OpenRouterModelEntry[];
+}
+export interface ParseResult {
+    config: OpenRouterConfig;
+    /** human-readable reasons for every entry/field that was dropped */
+    warnings: string[];
+}
+/** OpenRouter slugs are provider/model paths ('org/name[:variant]'). */
+export declare function isOpenRouterSlug(model: string | undefined | null): boolean;
+/** Validate the raw `openrouter` config section. Tolerant at the boundary:
+ * bad entries are dropped with a warning, never thrown. */
+export declare function parseOpenRouterConfig(raw: unknown): ParseResult;
+/** Models eligible to serve a tier. */
+export declare function modelsForTier(cfg: OpenRouterConfig, tier: RoutingTier): OpenRouterModelEntry[];
+export interface BetaPrior {
+    alpha: number;
+    beta: number;
+}
+export type BetaSampler = (alpha: number, beta: number) => number;
+/** Default Beta sampler via two Gamma(α,1)/Gamma(β,1) draws (Marsaglia-Tsang
+ * for shape ≥ 1, boost trick below 1). Deterministic tests inject their own. */
+export declare const defaultBetaSampler: BetaSampler;
+export interface PickInput {
+    cfg: OpenRouterConfig;
+    tier: RoutingTier;
+    /** per-modelId Beta priors (ADR-149 shape) — absent models get uniform Beta(1,1) */
+    priors?: Record<string, BetaPrior>;
+    sample?: BetaSampler;
+}
+export interface PickResult {
+    model: string;
+    reason: string;
+    candidates: number;
+}
+/** Thompson-sample a concrete OpenRouter model for a tier from the
+ * user-configured pool. Returns null when disabled or no tier candidates. */
+export declare function pickOpenRouterModel({ cfg, tier, priors, sample }: PickInput): PickResult | null;
+export interface ResolveInput extends Omit<PickInput, 'tier'> {
+    /** caller-supplied model: OpenRouter slug passes through; tier word routes via the pool */
+    requested?: string;
+    tier?: RoutingTier;
+}
+/** Full precedence for the execution path:
+ *  explicit slug > tier pick from the configured pool > config defaultModel > null. */
+export declare function resolveOpenRouterModel({ requested, tier, cfg, priors, sample }: ResolveInput): {
+    model: string;
+    source: string;
+} | null;
+/** Thin reader: swarmdo.config.json's `openrouter` section from cwd (or an
+ * ancestor repo root). Absent/broken files yield the disabled default. */
+export declare function loadOpenRouterConfig(cwd?: string): ParseResult;
+//# sourceMappingURL=openrouter-config.d.ts.map

package/dist/src/providers/openrouter-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter-config.d.ts","sourceRoot":"","sources":["../../../src/providers/openrouter-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAGtD,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX;wDACoD;IACpD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AASD,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAE1E;AAED;2DAC2D;AAC3D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CA0C/D;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,oBAAoB,EAAE,CAE9F;AAED,MAAM,WAAW,SAAS;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAElE;gFACgF;AAChF,eAAO,MAAM,kBAAkB,EAAE,WAiBhC,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;6EAC6E;AAC7E,wBAAgB,mBAAmB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAmB/F;AAED,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3D,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;uFACuF;AACvF,wBAAgB,sBAAsB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUvI;AAED;0EAC0E;AAC1E,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAsB,GAAG,WAAW,CAY7E"}

package/dist/src/providers/openrouter-config.js

@@ -0,0 +1,186 @@
+/**
+ * openrouter-config.ts — configurable OpenRouter model pool for swarms.
+ *
+ * The execution core has dispatched to OpenRouter since #2042, but only via
+ * env vars and a single default slug. This module makes the integration
+ * CONFIGURABLE: users declare the OpenRouter models they want their agent
+ * swarms to draw from in swarmdo.config.json, each mapped to a routing tier,
+ * and the router selects among same-tier candidates by Thompson sampling —
+ * the concrete consumer for the ADR-149 per-modelId priors.
+ *
+ *   "openrouter": {
+ *     "enabled": true,
+ *     "models": [
+ *       { "id": "meta-llama/llama-3.3-70b-instruct", "tier": "haiku" },
+ *       { "id": "deepseek/deepseek-chat",            "tier": "sonnet" },
+ *       { "id": "anthropic/claude-opus-4-5",         "tier": "opus" }
+ *     ],
+ *     "defaultModel": "anthropic/claude-sonnet-4-6"
+ *   }
+ *
+ * Everything here is pure (validation, filtering, sampling with injectable
+ * randomness) except loadOpenRouterConfig, a thin fs reader.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const TIERS = ['haiku', 'sonnet', 'opus'];
+const DEFAULTS = {
+    enabled: false,
+    apiKeyEnv: 'OPENROUTER_API_KEY',
+    baseUrl: 'https://openrouter.ai/api',
+    models: [],
+};
+/** OpenRouter slugs are provider/model paths ('org/name[:variant]'). */
+export function isOpenRouterSlug(model) {
+    return typeof model === 'string' && /^[\w.-]+\/[\w.:-]+$/.test(model);
+}
+/** Validate the raw `openrouter` config section. Tolerant at the boundary:
+ * bad entries are dropped with a warning, never thrown. */
+export function parseOpenRouterConfig(raw) {
+    const warnings = [];
+    if (raw === undefined || raw === null)
+        return { config: { ...DEFAULTS }, warnings };
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        return { config: { ...DEFAULTS }, warnings: ['openrouter: expected an object — section ignored'] };
+    }
+    const o = raw;
+    const config = { ...DEFAULTS, models: [] };
+    config.enabled = o.enabled === true;
+    if (typeof o.apiKeyEnv === 'string' && o.apiKeyEnv.trim())
+        config.apiKeyEnv = o.apiKeyEnv.trim();
+    if (typeof o.baseUrl === 'string' && /^https?:\/\//.test(o.baseUrl))
+        config.baseUrl = o.baseUrl.replace(/\/$/, '');
+    else if (o.baseUrl !== undefined)
+        warnings.push('openrouter.baseUrl: not an http(s) URL — using default');
+    if (typeof o.defaultModel === 'string' && isOpenRouterSlug(o.defaultModel))
+        config.defaultModel = o.defaultModel;
+    else if (o.defaultModel !== undefined)
+        warnings.push(`openrouter.defaultModel: "${String(o.defaultModel)}" is not an OpenRouter slug (org/model) — ignored`);
+    const rawModels = Array.isArray(o.models) ? o.models : [];
+    if (o.models !== undefined && !Array.isArray(o.models))
+        warnings.push('openrouter.models: expected an array — ignored');
+    const seen = new Set();
+    for (const [i, m] of rawModels.entries()) {
+        if (typeof m === 'string') {
+            // shorthand: bare slug, no tier
+            if (isOpenRouterSlug(m) && !seen.has(m)) {
+                config.models.push({ id: m });
+                seen.add(m);
+            }
+            else
+                warnings.push(`openrouter.models[${i}]: "${m}" is not a valid slug or is a duplicate — dropped`);
+            continue;
+        }
+        if (!m || typeof m !== 'object') {
+            warnings.push(`openrouter.models[${i}]: not an object — dropped`);
+            continue;
+        }
+        const e = m;
+        if (typeof e.id !== 'string' || !isOpenRouterSlug(e.id)) {
+            warnings.push(`openrouter.models[${i}]: missing/invalid id (want 'org/model' slug) — dropped`);
+            continue;
+        }
+        if (seen.has(e.id)) {
+            warnings.push(`openrouter.models[${i}]: duplicate id "${e.id}" — dropped`);
+            continue;
+        }
+        const entry = { id: e.id };
+        if (e.tier !== undefined) {
+            if (typeof e.tier === 'string' && TIERS.includes(e.tier))
+                entry.tier = e.tier;
+            else {
+                warnings.push(`openrouter.models[${i}]: tier "${String(e.tier)}" not in ${TIERS.join('|')} — entry kept untiered`);
+            }
+        }
+        if (typeof e.note === 'string')
+            entry.note = e.note;
+        config.models.push(entry);
+        seen.add(e.id);
+    }
+    return { config, warnings };
+}
+/** Models eligible to serve a tier. */
+export function modelsForTier(cfg, tier) {
+    return cfg.models.filter((m) => m.tier === tier);
+}
+/** Default Beta sampler via two Gamma(α,1)/Gamma(β,1) draws (Marsaglia-Tsang
+ * for shape ≥ 1, boost trick below 1). Deterministic tests inject their own. */
+export const defaultBetaSampler = (alpha, beta) => {
+    const gamma = (shape) => {
+        if (shape < 1)
+            return gamma(shape + 1) * Math.pow(Math.random() || 1e-12, 1 / shape);
+        const d = shape - 1 / 3;
+        const c = 1 / Math.sqrt(9 * d);
+        for (;;) {
+            const u1 = Math.random() || 1e-12;
+            const u2 = Math.random() || 1e-12;
+            const n = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+            const v = Math.pow(1 + c * n, 3);
+            if (v <= 0)
+                continue;
+            if (Math.log(u2) < 0.5 * n * n + d - d * v + d * Math.log(v))
+                return d * v;
+        }
+    };
+    const a = gamma(alpha);
+    const b = gamma(beta);
+    return a / (a + b || 1e-12);
+};
+/** Thompson-sample a concrete OpenRouter model for a tier from the
+ * user-configured pool. Returns null when disabled or no tier candidates. */
+export function pickOpenRouterModel({ cfg, tier, priors, sample }) {
+    if (!cfg.enabled)
+        return null;
+    const candidates = modelsForTier(cfg, tier);
+    if (candidates.length === 0)
+        return null;
+    if (candidates.length === 1) {
+        return { model: candidates[0].id, reason: `only configured ${tier}-tier model`, candidates: 1 };
+    }
+    const draw = sample ?? defaultBetaSampler;
+    let best = null;
+    for (const c of candidates) {
+        const p = priors?.[c.id] ?? { alpha: 1, beta: 1 };
+        const score = draw(Math.max(p.alpha, 1e-9), Math.max(p.beta, 1e-9));
+        if (!best || score > best.score)
+            best = { id: c.id, score };
+    }
+    return {
+        model: best.id,
+        reason: `Thompson pick among ${candidates.length} configured ${tier}-tier models`,
+        candidates: candidates.length,
+    };
+}
+/** Full precedence for the execution path:
+ *  explicit slug > tier pick from the configured pool > config defaultModel > null. */
+export function resolveOpenRouterModel({ requested, tier, cfg, priors, sample }) {
+    if (isOpenRouterSlug(requested))
+        return { model: requested, source: 'explicit' };
+    const effectiveTier = tier ?? (requested && TIERS.includes(requested) ? requested : undefined);
+    if (effectiveTier) {
+        const picked = pickOpenRouterModel({ cfg, tier: effectiveTier, priors, sample });
+        if (picked)
+            return { model: picked.model, source: picked.reason };
+    }
+    if (cfg.enabled && cfg.defaultModel)
+        return { model: cfg.defaultModel, source: 'config defaultModel' };
+    return null;
+}
+/** Thin reader: swarmdo.config.json's `openrouter` section from cwd (or an
+ * ancestor repo root). Absent/broken files yield the disabled default. */
+export function loadOpenRouterConfig(cwd = process.cwd()) {
+    for (const dir of [cwd, path.resolve(cwd, '..'), path.resolve(cwd, '../..')]) {
+        const p = path.join(dir, 'swarmdo.config.json');
+        try {
+            if (!fs.existsSync(p))
+                continue;
+            const parsed = JSON.parse(fs.readFileSync(p, 'utf8'));
+            return parseOpenRouterConfig(parsed?.openrouter);
+        }
+        catch {
+            return { config: { ...DEFAULTS }, warnings: [`openrouter: failed to read ${p} — integration disabled`] };
+        }
+    }
+    return { config: { ...DEFAULTS }, warnings: [] };
+}
+//# sourceMappingURL=openrouter-config.js.map

package/dist/src/providers/openrouter-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter-config.js","sourceRoot":"","sources":["../../../src/providers/openrouter-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,KAAK,GAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AA2B7D,MAAM,QAAQ,GAAqB;IACjC,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,oBAAoB;IAC/B,OAAO,EAAE,2BAA2B;IACpC,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED;2DAC2D;AAC3D,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC;IACpF,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,kDAAkD,CAAC,EAAE,CAAC;IACrG,CAAC;IACD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,MAAM,GAAqB,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7D,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;IACpC,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACjG,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;SAC9G,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IAC1G,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,IAAI,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC;QAAE,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;SAC5G,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,mDAAmD,CAAC,CAAC;IAE7J,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IACxH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,gCAAgC;YAChC,IAAI,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;gBAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;;gBACnF,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,mDAAmD,CAAC,CAAC;YACtG,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,4BAA4B,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACjH,MAAM,CAAC,GAAG,CAA4B,CAAC;QACvC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,yDAAyD,CAAC,CAAC;YAC/F,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC7G,MAAM,KAAK,GAAyB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAmB,CAAC;iBACxF,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,YAAY,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YAAC,CAAC;QAC9H,CAAC;QACD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAAC,GAAqB,EAAE,IAAiB;IACpE,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACnD,CAAC;AAKD;gFACgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IAC7D,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE;QACtC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;QACrF,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,SAAS,CAAC;YACR,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC;YAClC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC;YAClC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YACpE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YACrB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC,CAAC;IACF,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;AAC9B,CAAC,CAAC;AAgBF;6EAC6E;AAC7E,MAAM,UAAU,mBAAmB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAa;IAC1E,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,mBAAmB,IAAI,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAClG,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,IAAI,kBAAkB,CAAC;IAC1C,IAAI,IAAI,GAAyC,IAAI,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK;YAAE,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO;QACL,KAAK,EAAE,IAAK,CAAC,EAAE;QACf,MAAM,EAAE,uBAAuB,UAAU,CAAC,MAAM,eAAe,IAAI,cAAc;QACjF,UAAU,EAAE,UAAU,CAAC,MAAM;KAC9B,CAAC;AACJ,CAAC;AAQD;uFACuF;AACvF,MAAM,UAAU,sBAAsB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAgB;IAC3F,IAAI,gBAAgB,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,SAAmB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC3F,MAAM,aAAa,GACjB,IAAI,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAE,SAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5F,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,IAAI,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACvG,OAAO,IAAI,CAAC;AACd,CAAC;AAED;0EAC0E;AAC1E,MAAM,UAAU,oBAAoB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC9D,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;gBAAE,SAAS;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACtD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,8BAA8B,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAC3G,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACnD,CAAC"}

package/dist/src/release/release.d.ts

@@ -0,0 +1,72 @@
+/**
+ * release.ts — plan the whole swarmdo release train as data.
+ *
+ * The proven flow (first executed by hand for v1.4.8) is nine steps: bump the
+ * version trio + lockfile, sync the doc version strings, commit+push, build,
+ * stage the self-contained @swarmdo/cli, publish both packages, verify the
+ * registry, tag, and cut a GitHub release with `swarmdo changelog` notes.
+ * This module turns that into a PURE planner — inputs in, an ordered list of
+ * typed steps out — so the plan is unit-testable and the command layer only
+ * interprets steps (dry-run prints them; --confirm executes them).
+ */
+export interface ReleaseInput {
+    /** current version from v3/@swarmdo/cli/package.json (trio source of truth) */
+    current: string;
+    /** 'patch' | 'minor' | 'major' | explicit 'x.y.z' */
+    bump: string;
+    /** absolute repo root */
+    repoRoot: string;
+    /** skip npm publish steps (still bumps/commits/tags) */
+    skipPublish?: boolean;
+    /** skip the gh release step */
+    skipGhRelease?: boolean;
+    /** skip the live-site deploy (docs-sync rule says DON'T unless the release truly has zero user-facing surface) */
+    skipSite?: boolean;
+}
+export type ReleaseStep = {
+    kind: 'bump-json';
+    file: string;
+    version: string;
+} | {
+    kind: 'bump-lock';
+    file: string;
+    version: string;
+} | {
+    kind: 'sync-docs';
+    version: string;
+    files: string[];
+} | {
+    kind: 'exec';
+    title: string;
+    cmd: string;
+    args: string[];
+    cwd: string;
+} | {
+    kind: 'verify-npm';
+    packages: string[];
+    version: string;
+} | {
+    kind: 'gh-release';
+    tag: string;
+    notesFrom: string;
+} | {
+    kind: 'deploy-site';
+    version: string;
+};
+export interface ReleasePlan {
+    current: string;
+    next: string;
+    tag: string;
+    steps: ReleaseStep[];
+}
+export declare function parseVersion(v: string): [number, number, number];
+export declare function nextVersion(current: string, bump: string): string;
+/** The version trio + lockfile, relative to the repo root. */
+export declare const TRIO_FILES: string[];
+export declare const LOCK_FILE = "package-lock.json";
+/** Docs whose version strings ride along with every release. */
+export declare const DOC_FILES: string[];
+export declare function planRelease(input: ReleaseInput): ReleasePlan;
+/** One-line human rendering of a step (for the dry-run plan). */
+export declare function renderStep(s: ReleaseStep): string;
+//# sourceMappingURL=release.d.ts.map

package/dist/src/release/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/release/release.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kHAAkH;IAClH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAGtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAID,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAIhE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAajE;AAED,8DAA8D;AAC9D,eAAO,MAAM,UAAU,UAItB,CAAC;AACF,eAAO,MAAM,SAAS,sBAAsB,CAAC;AAC7C,gEAAgE;AAChE,eAAO,MAAM,SAAS,UAAmD,CAAC;AAE1E,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAgC5D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAUjD"}

package/dist/src/release/release.js

@@ -0,0 +1,86 @@
+/**
+ * release.ts — plan the whole swarmdo release train as data.
+ *
+ * The proven flow (first executed by hand for v1.4.8) is nine steps: bump the
+ * version trio + lockfile, sync the doc version strings, commit+push, build,
+ * stage the self-contained @swarmdo/cli, publish both packages, verify the
+ * registry, tag, and cut a GitHub release with `swarmdo changelog` notes.
+ * This module turns that into a PURE planner — inputs in, an ordered list of
+ * typed steps out — so the plan is unit-testable and the command layer only
+ * interprets steps (dry-run prints them; --confirm executes them).
+ */
+const SEMVER = /^(\d+)\.(\d+)\.(\d+)$/;
+export function parseVersion(v) {
+    const m = SEMVER.exec(v.trim());
+    if (!m)
+        throw new Error(`not a stable semver version: "${v}" (expected x.y.z)`);
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+export function nextVersion(current, bump) {
+    const [maj, min, pat] = parseVersion(current);
+    switch (bump) {
+        case 'patch': return `${maj}.${min}.${pat + 1}`;
+        case 'minor': return `${maj}.${min + 1}.0`;
+        case 'major': return `${maj + 1}.0.0`;
+        default: {
+            const [nmaj, nmin, npat] = parseVersion(bump); // throws on junk
+            const cmp = nmaj - maj || nmin - min || npat - pat;
+            if (cmp <= 0)
+                throw new Error(`explicit version ${bump} must be greater than current ${current}`);
+            return bump;
+        }
+    }
+}
+/** The version trio + lockfile, relative to the repo root. */
+export const TRIO_FILES = [
+    'v3/@swarmdo/cli/package.json',
+    'package.json',
+    'swarmdo/package.json',
+];
+export const LOCK_FILE = 'package-lock.json';
+/** Docs whose version strings ride along with every release. */
+export const DOC_FILES = ['CLAUDE.md', 'README.md', 'website/index.html'];
+export function planRelease(input) {
+    const next = nextVersion(input.current, input.bump);
+    const tag = `v${next}`;
+    const root = input.repoRoot;
+    const cli = `${root}/v3/@swarmdo/cli`;
+    const steps = [];
+    for (const f of TRIO_FILES)
+        steps.push({ kind: 'bump-json', file: f, version: next });
+    steps.push({ kind: 'bump-lock', file: LOCK_FILE, version: next });
+    steps.push({ kind: 'sync-docs', version: next, files: DOC_FILES });
+    steps.push({ kind: 'exec', title: 'commit release', cmd: 'git', args: ['commit', '-am', `release: ${tag}`], cwd: root });
+    steps.push({ kind: 'exec', title: 'push main', cmd: 'git', args: ['push', 'origin', 'main'], cwd: root });
+    if (!input.skipPublish) {
+        steps.push({ kind: 'exec', title: 'build @swarmdo/cli', cmd: 'npm', args: ['run', 'build'], cwd: cli });
+        steps.push({ kind: 'exec', title: 'stage standalone cli', cmd: 'node', args: ['scripts/build-standalone.mjs'], cwd: cli });
+        // NOTE: publish runs from INSIDE dist-standalone — `npm publish <folder>`
+        // from the package dir would trip the intentional prepublishOnly guard
+        steps.push({ kind: 'exec', title: 'publish @swarmdo/cli', cmd: 'npm', args: ['publish'], cwd: `${cli}/dist-standalone` });
+        steps.push({ kind: 'exec', title: 'publish swarmdo umbrella', cmd: 'npm', args: ['publish'], cwd: root });
+        steps.push({ kind: 'verify-npm', packages: ['@swarmdo/cli', 'swarmdo'], version: next });
+    }
+    steps.push({ kind: 'exec', title: 'tag', cmd: 'git', args: ['tag', tag, 'main'], cwd: root });
+    steps.push({ kind: 'exec', title: 'push tag', cmd: 'git', args: ['push', 'origin', tag], cwd: root });
+    if (!input.skipGhRelease) {
+        steps.push({ kind: 'gh-release', tag, notesFrom: `v${input.current}` });
+    }
+    if (!input.skipSite) {
+        steps.push({ kind: 'deploy-site', version: next });
+    }
+    return { current: input.current, next, tag, steps };
+}
+/** One-line human rendering of a step (for the dry-run plan). */
+export function renderStep(s) {
+    switch (s.kind) {
+        case 'bump-json': return `bump ${s.file} → ${s.version}`;
+        case 'bump-lock': return `bump ${s.file} (version + packages."") → ${s.version}`;
+        case 'sync-docs': return `sync version strings → ${s.version} in ${s.files.join(', ')}`;
+        case 'exec': return `${s.title}:  ${s.cmd} ${s.args.join(' ')}  (${s.cwd})`;
+        case 'verify-npm': return `verify npm: ${s.packages.join(', ')} @latest === ${s.version}`;
+        case 'gh-release': return `gh release ${s.tag} with \`swarmdo changelog\` notes since ${s.notesFrom}`;
+        case 'deploy-site': return `deploy website → SwarmDo/swarmdo.com (copy working copy, push, curl-verify swarmdo.com serves ${s.version})`;
+    }
+}
+//# sourceMappingURL=release.js.map

package/dist/src/release/release.js.map

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

package/dist/src/resilience/backoff.d.ts

@@ -0,0 +1,23 @@
+/**
+ * backoff.ts — exponential backoff with full jitter for retryable provider
+ * failures (429 / 5xx / timeouts).
+ *
+ * The ADR-149 fallback chain retried instantly; a provider-level 429 is
+ * usually account-wide, so an immediate re-call burns the attempt. Standard
+ * remedy (AWS architecture blog, anthropic SDK internals): exponential base
+ * with FULL jitter, capped. Pure — the jitter source is injectable so tests
+ * are deterministic.
+ */
+export interface BackoffOptions {
+    /** first-attempt base delay (default 1000ms) */
+    baseMs?: number;
+    /** hard cap per delay (default 8000ms) */
+    capMs?: number;
+    /** jitter source mapping an upper bound to a value in [0, bound); injectable for tests */
+    jitter?: (boundMs: number) => number;
+}
+/** Delay before retry `attempt` (0-based): full-jitter exp backoff. */
+export declare function computeBackoffMs(attempt: number, opts?: BackoffOptions): number;
+export declare function isRetryableError(errText: string | null | undefined): boolean;
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/src/resilience/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../../src/resilience/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM,CAMnF;AAQD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5E;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/src/resilience/backoff.js

@@ -0,0 +1,30 @@
+/**
+ * backoff.ts — exponential backoff with full jitter for retryable provider
+ * failures (429 / 5xx / timeouts).
+ *
+ * The ADR-149 fallback chain retried instantly; a provider-level 429 is
+ * usually account-wide, so an immediate re-call burns the attempt. Standard
+ * remedy (AWS architecture blog, anthropic SDK internals): exponential base
+ * with FULL jitter, capped. Pure — the jitter source is injectable so tests
+ * are deterministic.
+ */
+/** Delay before retry `attempt` (0-based): full-jitter exp backoff. */
+export function computeBackoffMs(attempt, opts = {}) {
+    const base = opts.baseMs ?? 1000;
+    const cap = opts.capMs ?? 8000;
+    const jitter = opts.jitter ?? ((bound) => Math.random() * bound);
+    const bound = Math.min(cap, base * 2 ** Math.max(0, attempt));
+    return Math.floor(jitter(bound));
+}
+/** Retryable-failure classifier shared with the fallback chain. */
+// \b only guards the numeric codes ('5031' must not match); the word classes
+// match as substrings because providers emit snake_case ('overloaded_error',
+// 'rate_limited') where \b fails before the underscore
+const RETRYABLE = /\b(429|500|502|503|504)\b|timeout|overloaded|rate.?limit|ECONNRESET|ETIMEDOUT/i;
+export function isRetryableError(errText) {
+    return RETRYABLE.test(errText ?? '');
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=backoff.js.map

package/dist/src/resilience/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../../src/resilience/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAuB,EAAE;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,mEAAmE;AACnE,6EAA6E;AAC7E,6EAA6E;AAC7E,uDAAuD;AACvD,MAAM,SAAS,GAAG,gFAAgF,CAAC;AAEnG,MAAM,UAAU,gBAAgB,CAAC,OAAkC;IACjE,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}