opensquid 0.5.395

package/dist/setup/cli/cost.js.map

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

package/dist/setup/cli/cost_state.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Cost-CLI persistence helpers (CLI.8) — split out of cost.ts for the
+ * file-size budget.
+ *
+ * Three concerns:
+ *
+ *   1. `defaultConfigPath` / `readSubscriptionPools` — load configured
+ *      subscription pools from `~/.opensquid/config.yaml` (`subscription_pools:`
+ *      block keyed by tier). Empty file / missing block → empty record (the
+ *      CLI surfaces this as "no pools configured" rather than crashing —
+ *      `cost subscriptions` should still print a clean message before any
+ *      pools have been declared). Malformed YAML throws (no silent fail-open).
+ *
+ *   2. `CostRoutingLog` — libsql-backed audit table for AUTO.7 `CostRouter`
+ *      routing decisions. The router itself takes a caller-wired
+ *      `audit: (entry) => void` sink (see `src/models/cost_router.ts`); the
+ *      daemon wires that sink to `CostRoutingLog.append`. The CLI's
+ *      `cost routing` / `cost` (default summary) read from this table.
+ *
+ *      Schema mirrors the `CostRoutingAuditEntry` shape: (tier, alias,
+ *      success, reason, timestamp). Idempotent `CREATE TABLE IF NOT EXISTS`
+ *      on first init — matches the AUTO.2 `rate_limit_buckets` + CLI.5
+ *      `audit_log` posture (no versioned migration framework in opensquid
+ *      yet).
+ *
+ *   3. `formatTimestamp` — re-exports `audit_state.ts`'s ISO formatter to
+ *      keep cost-side imports inside one helper file. Same precedent as
+ *      `cache.ts` importing `parseDurationToMs` from `audit_state.ts`.
+ *
+ * Imports from: node:fs/promises, yaml, @libsql/client,
+ *   ../../models/cost_router, ../../runtime/paths.
+ * Imported by: src/setup/cli/cost.ts + src/setup/cli/cost.test.ts.
+ */
+import { formatTimestamp } from './audit_state.js';
+import type { Client } from '@libsql/client';
+import type { CostTier, SubscriptionPool } from '../../models/cost_router.js';
+export { formatTimestamp };
+/** Per-tier subscription pools as declared in `~/.opensquid/config.yaml`. */
+export type SubscriptionPoolsByTier = Partial<Record<CostTier, SubscriptionPool[]>>;
+export declare const defaultConfigPath: () => string;
+/** Read configured pools. Missing file / missing block → empty record. */
+export declare function readSubscriptionPools(path: string): Promise<SubscriptionPoolsByTier>;
+/**
+ * libsql-backed log of `CostRouter.pick()` decisions. The daemon wires
+ * `CostRouter`'s `audit:` sink to `append`; the CLI reads via `recent`.
+ *
+ * `success` stored as 0/1 (SQLite has no boolean). `reason` is the
+ * machine-readable cause when `success=false` (`empty_tier` |
+ * `all_rate_limited`).
+ */
+export interface CostRoutingRow {
+    id: number;
+    occurredAtMs: number;
+    tier: CostTier;
+    alias: string | null;
+    success: boolean;
+    reason: string | null;
+}
+export declare class CostRoutingLog {
+    private readonly db;
+    private initialized;
+    constructor(db: Client);
+    init(): Promise<void>;
+    /** Append one decision. `occurredAtMs` from caller-supplied clock. */
+    append(entry: {
+        occurredAtMs: number;
+        tier: CostTier;
+        alias: string | null;
+        success: boolean;
+        reason?: string | null;
+    }): Promise<void>;
+    /** Most-recent N decisions, newest-first. */
+    recent(limit: number): Promise<CostRoutingRow[]>;
+    /** Aggregate row counts per (tier, alias). Used by the default `cost`
+     *  summary verb to render pool usage across tiers. */
+    summary(): Promise<SummaryRow[]>;
+}
+export interface SummaryRow {
+    tier: CostTier;
+    alias: string;
+    picks: number;
+}
+export declare function renderSummary(rows: readonly SummaryRow[]): string;
+export declare function renderRouting(rows: readonly CostRoutingRow[]): string;
+export declare function renderSubscriptions(pools: SubscriptionPoolsByTier): string;
+//# sourceMappingURL=cost_state.d.ts.map

package/dist/setup/cli/cost_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost_state.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/cost_state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AASH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,6EAA6E;AAC7E,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;AAEpF,eAAO,MAAM,iBAAiB,QAAO,MAA+C,CAAC;AAErF,0EAA0E;AAC1E,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAqC1F;AAkBD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAkBD,qBAAa,cAAc;IAEb,OAAO,CAAC,QAAQ,CAAC,EAAE;IAD/B,OAAO,CAAC,WAAW,CAAS;gBACC,EAAE,EAAE,MAAM;IAEjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,sEAAsE;IAChE,MAAM,CAAC,KAAK,EAAE;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,QAAQ,CAAC;QACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG,OAAO,CAAC,IAAI,CAAC;IAejB,6CAA6C;IACvC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA2BtD;0DACsD;IAChD,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;CAevC;AAMD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAMjE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAkBrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAW1E"}

package/dist/setup/cli/cost_state.js

@@ -0,0 +1,223 @@
+/**
+ * Cost-CLI persistence helpers (CLI.8) — split out of cost.ts for the
+ * file-size budget.
+ *
+ * Three concerns:
+ *
+ *   1. `defaultConfigPath` / `readSubscriptionPools` — load configured
+ *      subscription pools from `~/.opensquid/config.yaml` (`subscription_pools:`
+ *      block keyed by tier). Empty file / missing block → empty record (the
+ *      CLI surfaces this as "no pools configured" rather than crashing —
+ *      `cost subscriptions` should still print a clean message before any
+ *      pools have been declared). Malformed YAML throws (no silent fail-open).
+ *
+ *   2. `CostRoutingLog` — libsql-backed audit table for AUTO.7 `CostRouter`
+ *      routing decisions. The router itself takes a caller-wired
+ *      `audit: (entry) => void` sink (see `src/models/cost_router.ts`); the
+ *      daemon wires that sink to `CostRoutingLog.append`. The CLI's
+ *      `cost routing` / `cost` (default summary) read from this table.
+ *
+ *      Schema mirrors the `CostRoutingAuditEntry` shape: (tier, alias,
+ *      success, reason, timestamp). Idempotent `CREATE TABLE IF NOT EXISTS`
+ *      on first init — matches the AUTO.2 `rate_limit_buckets` + CLI.5
+ *      `audit_log` posture (no versioned migration framework in opensquid
+ *      yet).
+ *
+ *   3. `formatTimestamp` — re-exports `audit_state.ts`'s ISO formatter to
+ *      keep cost-side imports inside one helper file. Same precedent as
+ *      `cache.ts` importing `parseDurationToMs` from `audit_state.ts`.
+ *
+ * Imports from: node:fs/promises, yaml, @libsql/client,
+ *   ../../models/cost_router, ../../runtime/paths.
+ * Imported by: src/setup/cli/cost.ts + src/setup/cli/cost.test.ts.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { OPENSQUID_HOME } from '../../runtime/paths.js';
+import { formatTimestamp } from './audit_state.js';
+export { formatTimestamp };
+export const defaultConfigPath = () => join(OPENSQUID_HOME(), 'config.yaml');
+/** Read configured pools. Missing file / missing block → empty record. */
+export async function readSubscriptionPools(path) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return {};
+        throw e;
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (e) {
+        throw new Error(`config.yaml is malformed (${path}): ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (parsed === null || parsed === undefined)
+        return {};
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`config.yaml must be a mapping (${path})`);
+    }
+    const pools = parsed.subscription_pools;
+    if (pools === undefined || pools === null)
+        return {};
+    if (typeof pools !== 'object' || Array.isArray(pools)) {
+        throw new Error(`config.yaml: \`subscription_pools\` must be a mapping (${path})`);
+    }
+    const result = {};
+    for (const tier of ['cheap', 'balanced', 'premium']) {
+        const list = pools[tier];
+        if (list === undefined)
+            continue;
+        if (!Array.isArray(list)) {
+            throw new Error(`config.yaml: \`subscription_pools.${tier}\` must be a list (${path})`);
+        }
+        result[tier] = list
+            .filter((p) => typeof p === 'object' && p !== null)
+            .map((p) => normalizePool(p));
+    }
+    return result;
+}
+function normalizePool(p) {
+    const base = {
+        alias: typeof p.alias === 'string' ? p.alias : '',
+        provider: typeof p.provider === 'string' ? p.provider : '',
+        model: typeof p.model === 'string' ? p.model : '',
+    };
+    if (typeof p.rateLimit === 'object' && p.rateLimit !== null) {
+        const rl = p.rateLimit;
+        const rpm = Number(rl.rpm);
+        if (Number.isFinite(rpm)) {
+            base.rateLimit = typeof rl.tpm === 'number' ? { rpm, tpm: rl.tpm } : { rpm };
+        }
+    }
+    return base;
+}
+const CREATE_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS cost_routing_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    occurred_at_ms INTEGER NOT NULL,
+    tier TEXT NOT NULL,
+    alias TEXT,
+    success INTEGER NOT NULL,
+    reason TEXT
+  );
+`;
+const CREATE_INDEX_SQL = `
+  CREATE INDEX IF NOT EXISTS idx_cost_routing_occurred
+    ON cost_routing_log(occurred_at_ms);
+`;
+export class CostRoutingLog {
+    db;
+    initialized = false;
+    constructor(db) {
+        this.db = db;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        await this.db.execute(CREATE_TABLE_SQL);
+        await this.db.execute(CREATE_INDEX_SQL);
+        this.initialized = true;
+    }
+    /** Append one decision. `occurredAtMs` from caller-supplied clock. */
+    async append(entry) {
+        await this.init();
+        await this.db.execute({
+            sql: `INSERT INTO cost_routing_log (occurred_at_ms, tier, alias, success, reason)
+            VALUES (?, ?, ?, ?, ?)`,
+            args: [
+                entry.occurredAtMs,
+                entry.tier,
+                entry.alias,
+                entry.success ? 1 : 0,
+                entry.reason ?? null,
+            ],
+        });
+    }
+    /** Most-recent N decisions, newest-first. */
+    async recent(limit) {
+        await this.init();
+        const rs = await this.db.execute({
+            sql: `SELECT id, occurred_at_ms, tier, alias, success, reason
+            FROM cost_routing_log
+            ORDER BY occurred_at_ms DESC, id DESC
+            LIMIT ?`,
+            args: [Math.max(1, Math.floor(limit))],
+        });
+        return rs.rows.map((r) => ({
+            id: Number(r.id),
+            occurredAtMs: Number(r.occurred_at_ms),
+            tier: String(r.tier),
+            alias: r.alias === null ||
+                r.alias === undefined
+                ? null
+                : String(r.alias),
+            success: Number(r.success) === 1,
+            reason: r.reason === null ||
+                r.reason === undefined
+                ? null
+                : String(r.reason),
+        }));
+    }
+    /** Aggregate row counts per (tier, alias). Used by the default `cost`
+     *  summary verb to render pool usage across tiers. */
+    async summary() {
+        await this.init();
+        const rs = await this.db.execute(`SELECT tier, alias, COUNT(*) AS picks
+       FROM cost_routing_log
+       WHERE success = 1 AND alias IS NOT NULL
+       GROUP BY tier, alias
+       ORDER BY tier ASC, picks DESC`);
+        return rs.rows.map((r) => ({
+            tier: String(r.tier),
+            alias: String(r.alias),
+            picks: Number(r.picks),
+        }));
+    }
+}
+function pad(s, w) {
+    if (s.length >= w)
+        return s.slice(0, w - 1) + ' ';
+    return s + ' '.repeat(w - s.length);
+}
+export function renderSummary(rows) {
+    const lines = [pad('TIER', 12) + pad('ALIAS', 24) + pad('PICKS', 10)];
+    for (const r of rows) {
+        lines.push(pad(r.tier, 12) + pad(r.alias, 24) + pad(String(r.picks), 10));
+    }
+    return lines.join('\n');
+}
+export function renderRouting(rows) {
+    const lines = [
+        pad('TIMESTAMP', 28) +
+            pad('TIER', 10) +
+            pad('ALIAS', 20) +
+            pad('STATUS', 10) +
+            pad('REASON', 22),
+    ];
+    for (const r of rows) {
+        lines.push(pad(formatTimestamp(r.occurredAtMs), 28) +
+            pad(r.tier, 10) +
+            pad(r.alias ?? '-', 20) +
+            pad(r.success ? 'picked' : 'failed', 10) +
+            pad(r.reason ?? '-', 22));
+    }
+    return lines.join('\n');
+}
+export function renderSubscriptions(pools) {
+    const lines = [
+        pad('TIER', 12) + pad('ALIAS', 24) + pad('PROVIDER', 14) + pad('MODEL', 28),
+    ];
+    for (const tier of ['cheap', 'balanced', 'premium']) {
+        const list = pools[tier] ?? [];
+        for (const p of list) {
+            lines.push(pad(tier, 12) + pad(p.alias, 24) + pad(p.provider, 14) + pad(p.model, 28));
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cost_state.js.map

package/dist/setup/cli/cost_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost_state.js","sourceRoot":"","sources":["../../../src/setup/cli/cost_state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKnD,OAAO,EAAE,eAAe,EAAE,CAAC;AAK3B,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,aAAa,CAAC,CAAC;AAErF,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAC9D,MAAM,CAAC,CAAC;IACV,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACpF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACvD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,KAAK,GAAI,MAA2C,CAAC,kBAAkB,CAAC;IAC9E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,GAAG,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAI,KAAiC,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,sBAAsB,IAAI,GAAG,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI;aAChB,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;aAChF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,CAA0B;IAC/C,MAAM,IAAI,GAAqB;QAC7B,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACjD,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC1D,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;KAClD,CAAC;IACF,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC5D,MAAM,EAAE,GAAG,CAAC,CAAC,SAA6C,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAmBD,MAAM,gBAAgB,GAAG;;;;;;;;;CASxB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;CAGxB,CAAC;AAEF,MAAM,OAAO,cAAc;IAEI;IADrB,WAAW,GAAG,KAAK,CAAC;IAC5B,YAA6B,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;IAE3C,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,MAAM,CAAC,KAMZ;QACC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;YACpB,GAAG,EAAE;mCACwB;YAC7B,IAAI,EAAE;gBACJ,KAAK,CAAC,YAAY;gBAClB,KAAK,CAAC,IAAI;gBACV,KAAK,CAAC,KAAK;gBACX,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrB,KAAK,CAAC,MAAM,IAAI,IAAI;aACrB;SACF,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;YAC/B,GAAG,EAAE;;;oBAGS;YACd,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;SACvC,CAAC,CAAC;QACH,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,MAAM,CAAE,CAA6B,CAAC,EAAE,CAAC;YAC7C,YAAY,EAAE,MAAM,CAAE,CAA6B,CAAC,cAAc,CAAC;YACnE,IAAI,EAAE,MAAM,CAAE,CAA6B,CAAC,IAAI,CAAa;YAC7D,KAAK,EACF,CAA6B,CAAC,KAAK,KAAK,IAAI;gBAC5C,CAA6B,CAAC,KAAK,KAAK,SAAS;gBAChD,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,MAAM,CAAE,CAA6B,CAAC,KAAK,CAAC;YAClD,OAAO,EAAE,MAAM,CAAE,CAA6B,CAAC,OAAO,CAAC,KAAK,CAAC;YAC7D,MAAM,EACH,CAA6B,CAAC,MAAM,KAAK,IAAI;gBAC7C,CAA6B,CAAC,MAAM,KAAK,SAAS;gBACjD,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,MAAM,CAAE,CAA6B,CAAC,MAAM,CAAC;SACpD,CAAC,CAAC,CAAC;IACN,CAAC;IAED;0DACsD;IACtD,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAC9B;;;;qCAI+B,CAChC,CAAC;QACF,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,MAAM,CAAE,CAA6B,CAAC,IAAI,CAAa;YAC7D,KAAK,EAAE,MAAM,CAAE,CAA6B,CAAC,KAAK,CAAC;YACnD,KAAK,EAAE,MAAM,CAAE,CAA6B,CAAC,KAAK,CAAC;SACpD,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAYD,SAAS,GAAG,CAAC,CAAS,EAAE,CAAS;IAC/B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAClD,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA2B;IACvD,MAAM,KAAK,GAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAChF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA+B;IAC3D,MAAM,KAAK,GAAa;QACtB,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;YAClB,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YACf,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAChB,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;YACjB,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;KACpB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CACR,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;YACtC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACf,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,EAAE,CAAC;YACvB,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;YACxC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,EAAE,CAAC,CAC3B,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA8B;IAChE,MAAM,KAAK,GAAa;QACtB,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;KAC5E,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/setup/cli/doctor.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `opensquid doctor hooks` — health check for Claude Code hook wiring (G.2).
+ *
+ * Reads `~/.claude/settings.json` + `<cwd>/.claude/settings.json`, finds
+ * opensquid-managed hook entries (regex `/opensquid-hook|opensquid.*anti-drift/`),
+ * spawns each with a canonical Claude Code event payload, checks STDERR for
+ * the `[opensquid-dispatch]` marker. Marker absence = silent-no-op (the G.1
+ * root-cause failure mode). Exit 0 if all green, 1 if any red (CI-friendly).
+ *
+ * Security gate: NEVER spawns a command the shared ownership predicate
+ * (`isOpensquidHookCommand`, settings-writer.ts) doesn't claim —
+ * non-matching entries SKIPPED with note ("not opensquid-managed").
+ * D9-guard prompt-type hooks SKIPPED ("non-spawnable hook type").
+ *
+ * Engine-vocabulary discipline: consumer-side file — knows about Claude
+ * Code's settings.json + hook events. Runtime stays harness-agnostic.
+ *
+ * Imported by: src/cli.ts.
+ */
+import type { Command } from 'commander';
+type Status = 'green' | 'red' | 'skipped';
+export interface DoctorResult {
+    scope: 'user' | 'project';
+    event: string;
+    command: string;
+    status: Status;
+    reason: string;
+}
+export interface DoctorOptions {
+    userSettingsPath: string;
+    projectSettingsPath: string;
+    /** Override for unit tests — defaults to spawning real subprocesses. */
+    spawnProbe?: (command: string, stdin: string) => Promise<{
+        exitCode: number;
+        stderr: string;
+    }>;
+}
+/** CHS.1 — the codex-hooks section lines (pure in the path argument). */
+export declare function checkCodexHooks(path: string): Promise<string[]>;
+/** Pure runner — disk + spawn injectable for tests. */
+export declare function runDoctorHooks(opts: DoctorOptions): Promise<DoctorResult[]>;
+/** Pretty-print to stdout. Returns the number of RED results (caller maps to
+ * process exit code). */
+export declare function printReport(results: DoctorResult[]): number;
+export declare function registerDoctor(program: Command): void;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/setup/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEzC,KAAK,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChG;AAED,yEAAyE;AACzE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BrE;AAED,uDAAuD;AACvD,wBAAsB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA+CjF;AA+FD;yBACyB;AACzB,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAa3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4FrD"}