opensquid 0.5.395

package/dist/engine/types.d.ts

@@ -0,0 +1,402 @@
+/**
+ * Wire-shape types for loop-engine JSON-RPC.
+ *
+ * Mirrors the shapes defined in engine/src/serve.rs at HEAD (engine v0.5.4).
+ * Drift-corrected per T.1 audit findings (B, D, E, G):
+ *   - LessonCreateParams gets v1.1 (`pack_id`, `seed_as_promoted`) +
+ *     v1.2 (`external_id`) fields.
+ *   - LessonCreateResult.authored_by output is `'user' | 'pack' | 'agent'`
+ *     (not `'llm'` — engine renders Llm as `"agent"` on the wire per
+ *     `authorship_str()` in serve.rs:830-836).
+ *   - MemorySearchParams includes `mode: 'semantic' | 'text' | 'hybrid'`
+ *     (engine does server-side RRF fusion in `'hybrid'` mode).
+ *   - MemorySearchHit field is `similarity` (NOT `score`); `source` is
+ *     optional and present only on hybrid results.
+ *   - ManifestAssembleParams defaults `statuses` to `["active"]` which is
+ *     unreachable via the public API per T.1.HH — opensquid MUST always
+ *     pass an explicit `statuses: ["promoted"]` or `["pending","promoted"]`.
+ *
+ * No runtime code lives here — pure type module.
+ */
+/** MemoryScope wire shape (engine `MemoryScope` serde). */
+export type MemoryScope = 'user' | 'global' | {
+    team: string;
+} | {
+    skill: string;
+} | {
+    project: string;
+};
+/** Scope filter for memory search/list (engine `ScopeFilterWire` serde). */
+export type ScopeFilterWire = {
+    kind: 'exact';
+    scope: MemoryScope;
+} | {
+    kind: 'kind';
+    kind_name: 'user' | 'team' | 'skill' | 'project' | 'global';
+} | {
+    kind: 'any_of';
+    scopes: MemoryScope[];
+};
+/**
+ * Memory provenance block. All fields optional; engine YAML omits absent
+ * fields via `skip_serializing_if`, so partial blocks round-trip cleanly.
+ *
+ * Privacy: `session_id` is opaque (hashed first 8 chars); `cwd_basename`
+ * is the last path segment only.
+ */
+export interface MemoryOrigin {
+    host?: string;
+    session_id?: string;
+    model?: string;
+    cwd_basename?: string;
+    written_at?: string;
+}
+/**
+ * Engine `LessonCreateParams` per serve.rs:317-344 (v1.1 + v1.2 surface).
+ *
+ * Validation rules enforced server-side:
+ *  - `authored_by === 'pack'` AND missing/empty `pack_id` → -32602
+ *  - `seed_as_promoted: true` AND `authored_by !== 'pack'` → -32602
+ *
+ * Wire INPUT: anything other than `'user' | 'pack'` for `authored_by`
+ * silently maps to `Llm` (engine default).
+ */
+export interface LessonCreateParams {
+    description: string;
+    body: string;
+    evidence?: string[];
+    authored_by?: 'user' | 'pack';
+    /** Required when `authored_by === 'pack'`. */
+    pack_id?: string;
+    /** v1.2 UPSERT lookup key; pack-authored only. */
+    external_id?: string;
+    /** v1.1 gate bypass; pack-authored only. */
+    seed_as_promoted?: boolean;
+}
+/**
+ * Engine `LessonCreateResult` per serve.rs:458-473.
+ * Wire OUTPUT: `Llm → "agent"` (NOT `"llm"`).
+ */
+export interface LessonCreateResult {
+    id: string;
+    status: 'pending' | 'promoted';
+    authored_by: 'user' | 'pack' | 'agent';
+    pack_id?: string;
+    external_id?: string;
+    created_at: string;
+    /** v1.2: true on UPSERT hit (existing row reused). */
+    updated: boolean;
+}
+export interface LessonRecallHit {
+    kind: 'lesson';
+    id: string;
+    description: string;
+    status: string;
+    body_preview: string;
+    similarity: number;
+    applied_count: number;
+}
+export interface LessonRecallResult {
+    query: string;
+    returned: number;
+    results: LessonRecallHit[];
+}
+export interface LessonListRow {
+    id: string;
+    description: string;
+    status: string;
+    authored_by: string;
+    pack_id: string | null;
+    external_id: string | null;
+    applied_count: number;
+    thumbs_up_count: number;
+    thumbs_down_count: number;
+    created_at: string;
+    updated_at: string | null;
+}
+export interface LessonListResult {
+    total: number;
+    limit: number;
+    offset: number;
+    returned: number;
+    results: LessonListRow[];
+}
+/**
+ * Engine `MemorySearchParams` per serve.rs:935-967.
+ *
+ * `mode: 'hybrid'` is the load-bearing v0.5 addition — engine fuses
+ * semantic + text via Cormack et al. 2009 RRF (k=60) SERVER-SIDE,
+ * eliminating the need for a TS-side lexical leg (T.1.B + T.1.JJ).
+ */
+export interface MemorySearchParams {
+    query: string;
+    limit?: number;
+    include_body?: boolean;
+    scope_filter?: ScopeFilterWire;
+    mode?: 'semantic' | 'text' | 'hybrid';
+    /** Clamped to [0, 1] server-side. Applied to RAW scores BEFORE RRF merge. */
+    min_similarity?: number;
+}
+export interface MemorySearchHit {
+    kind: 'memory';
+    id: string;
+    description: string;
+    /** 240-char preview by default; FULL body when `include_body: true`. */
+    body_preview: string;
+    /** Rounded to 3 decimals. Engine field is `similarity` — NOT `score`. */
+    similarity: number;
+    /** Present only in hybrid mode. */
+    source?: 'semantic' | 'text' | 'both';
+}
+export interface MemorySearchResult {
+    query: string;
+    returned: number;
+    results: MemorySearchHit[];
+}
+/**
+ * Engine `ManifestAssembleParams` per serve.rs:1363-1390.
+ *
+ * `statuses` default is `["active"]` — UNREACHABLE via public lesson API
+ * (T.1.HH). Always pass `["promoted"]` or `["pending","promoted"]`.
+ *
+ * `record_applied` default is `true` — SIDE EFFECT: bumps `applied_count`
+ * + `last_applied_at` per surfaced lesson. This is the path lessons
+ * accumulate toward gate's `min_applied_count >= 3`. Pass `false` for
+ * read-only callers.
+ */
+export interface ManifestAssembleParams {
+    statuses?: ('pending' | 'active' | 'promoted' | 'superseded' | 'discarded')[];
+    lesson_limit?: number;
+    body_preview_len?: number;
+    annotate_with_gate?: boolean;
+    record_applied?: boolean;
+    memory_query?: string;
+    memory_limit?: number;
+    memory_scope_filter?: ScopeFilterWire;
+}
+export interface ManifestActiveLesson {
+    id: string;
+    description: string;
+    status: string;
+    body_preview: string;
+    applied_count: number;
+    last_applied_at: string | null;
+    target_skill: string | null;
+    gate?: {
+        kind: 'promote' | 'block';
+        reason_count: number;
+    };
+}
+export interface ManifestMemory {
+    id: string;
+    description: string;
+    body_preview: string;
+    similarity: number;
+}
+export interface ManifestAssembleResult {
+    active_lessons: ManifestActiveLesson[];
+    memories: ManifestMemory[];
+    /** v1.4 returns empty arrays — deferred to a later engine release. */
+    active_skills: unknown[];
+    active_personas: unknown[];
+    active_teams: unknown[];
+    assembly_stats: {
+        assembled_at: string;
+        total_listed: number;
+        skipped_count: number;
+        gate_skip_count: number;
+        record_applied_failures: number;
+        memories_returned: number | null;
+        memory_search_failures: number;
+        session_section_skips: number;
+    };
+}
+export interface CreateMemoryResult {
+    id: string;
+    description: string;
+    created_at: string;
+    scope: MemoryScope;
+    origin?: MemoryOrigin | null;
+}
+export interface GetMemoryResult {
+    id: string;
+    description: string;
+    /** FULL body, no truncation. */
+    content: string;
+    created_at: string;
+    scope: MemoryScope;
+    origin?: MemoryOrigin | null;
+    /**
+     * Reverse-citation count enforcing user-immunity (T.1.E -32003).
+     * A host MUST check this is `0` before force-deleting (force bypasses
+     * the engine guard). Added to `memory.get` for CMP.4's per-predecessor
+     * immunity gate.
+     */
+    consumed_by_user_lessons: number;
+    /** Predecessor ids when this is a compressed memory; `[]` for raw. */
+    derived_from: string[];
+}
+export interface MemoryListRow {
+    id: string;
+    description: string;
+    scope: MemoryScope;
+    origin: MemoryOrigin | null;
+    created_at: string;
+    updated_at: string | null;
+    /** Reverse-citation count enforcing user-immunity (T.1.E -32003). */
+    consumed_by_user_lessons: number;
+}
+export interface MemoryListResult {
+    total: number;
+    limit: number;
+    offset: number;
+    returned: number;
+    results: MemoryListRow[];
+}
+export interface TaskLogPhaseResult {
+    ok: true;
+    task_id: string;
+    phase: string;
+    newly_recorded: boolean;
+}
+export interface TaskGetLedgerResult {
+    task_id: string;
+    phases_logged: string[];
+    entries: {
+        phase: string;
+        logged_at: string;
+        note: string | null;
+    }[];
+}
+export interface LessonPromoteResult {
+    ok: true;
+    id: string;
+    gate: 'passed';
+    status: 'promoted';
+    from: string;
+    /**
+     * Cited MEMORY ids from the promoted lesson's causal narrative (the
+     * `EvidenceRef::Memory` evidence refs; quote refs excluded). The
+     * compression-candidate collector (CMP.3) nominates these as
+     * compression candidates. May be `[]` (a lesson with no memory
+     * citations). Added in engine commit "lesson.promote returns
+     * cited_memory_ids".
+     */
+    cited_memory_ids?: string[];
+}
+export interface LessonDiscardResult {
+    ok: true;
+    id: string;
+    status: 'discarded';
+    from: string;
+    reason?: string;
+}
+export interface LessonCaptureFeedbackResult {
+    ok: true;
+    id: string;
+    status: string;
+    thumbs_up_count: number;
+    thumbs_down_count: number;
+    external_signal_sources: string[];
+}
+export interface LessonSupersedeResult {
+    ok: true;
+    old_id: string;
+    new_id: string;
+    old_status: string;
+}
+export interface MemoryUpdateResult {
+    ok: true;
+    id: string;
+    description: string;
+    created_at: string;
+    updated_at: string;
+    scope: MemoryScope;
+    origin?: MemoryOrigin | null;
+}
+export interface MemoryDeleteResult {
+    ok: true;
+    id: string;
+    forced: boolean;
+}
+/**
+ * Engine `memory.compress` params per serve.rs `MemoryCompressParams`.
+ *
+ * `ids` is the explicit compression window — the host (which owns the
+ * satisfaction probe + candidate collection) decides what to compress;
+ * the engine never auto-selects. `max_tokens` / `temperature` default
+ * to the engine's `CompressionConfig::default` when omitted.
+ */
+export interface CompressParams {
+    ids: string[];
+    max_tokens?: number;
+    temperature?: number;
+}
+/**
+ * Engine `memory.compress` result — the new compressed memory `Mc`.
+ *
+ * `derived_from` carries the predecessor ids (the trace the engine
+ * chases via `get_by_id_chasing_derived_from` so recall still surfaces
+ * `Mc` after predecessors are deleted). `consumed_by_user_lessons` is
+ * the SUM across predecessors — `> 0` means the gist inherited a
+ * user-lesson citation and the predecessors are user-immune.
+ */
+export interface CompressResult {
+    id: string;
+    description: string;
+    derived_from: string[];
+    consumed_by_user_lessons: number;
+}
+/**
+ * Engine `memory.recompute_citations` result — drift stats from a
+ * citation-counter recompute sweep. `counters_repaired > 0` means the
+ * live state had drifted from ground truth; `orphan_citations > 0`
+ * means a cited memory + its forward `derived_from` successors are all
+ * gone (audit-trail integrity compromised — the host should investigate).
+ */
+export interface RecomputeCitationsResult {
+    lessons_scanned: number;
+    memories_recomputed: number;
+    counters_repaired: number;
+    orphan_citations: number;
+}
+/**
+ * Engine `memory.consolidate` params per serve.rs
+ * `MemoryConsolidateParams`.
+ *
+ * `ids` is the explicit window (the host decides what to consolidate).
+ * `recall_k` is the recall-replay top-k the engine uses to VERIFY that
+ * the minted `Mc` preserves each predecessor's recall before any
+ * deletion; defaults to the engine's `DEFAULT_CONSOLIDATE_RECALL_K`.
+ * `max_tokens` / `temperature` tune the internal compression step.
+ */
+export interface ConsolidateParams {
+    ids: string[];
+    max_tokens?: number;
+    temperature?: number;
+    recall_k?: number;
+}
+/**
+ * Engine `memory.consolidate` result — the atomic verify+gated-delete
+ * outcome. The engine GUARANTEES the D2 safety contract (verify +
+ * immunity + fail-closed) internally; this is the report.
+ *
+ * - `mc_id`: the minted compressed memory. `null` only if compression
+ *   itself failed (no `Mc` exists). Present even when `verified` is
+ *   `false` — `Mc` then sits alongside the (undeleted) predecessors.
+ * - `deleted`: predecessor ids force-deleted. Non-empty ONLY when
+ *   `verified === true` (and excludes any user-cited predecessor).
+ * - `kept_immune`: predecessors KEPT because they are user-cited
+ *   (`consumed_by_user_lessons > 0`); the `derived_from` chain still
+ *   links them to `Mc`.
+ * - `verified`: the recall-replay gate passed for ALL predecessors AND
+ *   compression succeeded. `false` ⇒ fail-closed (nothing deleted); the
+ *   host surfaces a drift event.
+ */
+export interface ConsolidateResult {
+    mc_id: string | null;
+    deleted: string[];
+    kept_immune: string[];
+    verified: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/types.d.ts.map

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

package/dist/engine/types.js

@@ -0,0 +1,22 @@
+/**
+ * Wire-shape types for loop-engine JSON-RPC.
+ *
+ * Mirrors the shapes defined in engine/src/serve.rs at HEAD (engine v0.5.4).
+ * Drift-corrected per T.1 audit findings (B, D, E, G):
+ *   - LessonCreateParams gets v1.1 (`pack_id`, `seed_as_promoted`) +
+ *     v1.2 (`external_id`) fields.
+ *   - LessonCreateResult.authored_by output is `'user' | 'pack' | 'agent'`
+ *     (not `'llm'` — engine renders Llm as `"agent"` on the wire per
+ *     `authorship_str()` in serve.rs:830-836).
+ *   - MemorySearchParams includes `mode: 'semantic' | 'text' | 'hybrid'`
+ *     (engine does server-side RRF fusion in `'hybrid'` mode).
+ *   - MemorySearchHit field is `similarity` (NOT `score`); `source` is
+ *     optional and present only on hybrid results.
+ *   - ManifestAssembleParams defaults `statuses` to `["active"]` which is
+ *     unreachable via the public API per T.1.HH — opensquid MUST always
+ *     pass an explicit `statuses: ["promoted"]` or `["pending","promoted"]`.
+ *
+ * No runtime code lives here — pure type module.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/engine-binary-resolver.js

@@ -0,0 +1,110 @@
+/**
+ * Bundled-binary resolver for the loop-engine subprocess (v0.6c).
+ *
+ * Pattern: esbuild / biomejs / swc — main opensquid package declares 6
+ * platform-specific packages as `optionalDependencies`; each one ships
+ * a single binary at `bin/loop-engine` (or `.exe` on Windows). npm's
+ * `os`/`cpu` fields cause the wrong-platform packages to skip install,
+ * so on any given host exactly one optional dep is present and provides
+ * the right binary.
+ *
+ * Runtime path:
+ *   1. Map `(process.platform, process.arch)` → optional-dep name.
+ *   2. Try `createRequire(import.meta.url).resolve(...)` on that
+ *      package's `bin/loop-engine`. Returns absolute path if installed.
+ *   3. If not installed (npm `--no-optional`, wrong-platform install,
+ *      local pre-publish dev), return `null`. Caller falls back to the
+ *      pre-existing discovery chain in `config.ts`.
+ *
+ * Why a separate module: the resolver is pure (no fs writes, no async),
+ * and isolating it makes it trivially unit-testable + future
+ * postinstall-script-friendly. Keeps `config.ts` focused on the legacy
+ * env/config/path chain.
+ */
+import { createRequire } from "node:module";
+import * as path from "node:path";
+/**
+ * Supported targets and their optional-dep package names. Stays in sync
+ * with `optionalDependencies` in the main package.json and with the
+ * matrix in `loop-engine/.github/workflows/release.yml`. If you change
+ * any of those, change all three.
+ */
+const PACKAGE_FOR_PLATFORM = {
+    "darwin-x64": "opensquid-engine-darwin-x64",
+    "darwin-arm64": "opensquid-engine-darwin-arm64",
+    "linux-x64": "opensquid-engine-linux-x64",
+    "linux-arm64": "opensquid-engine-linux-arm64",
+    "win32-x64": "opensquid-engine-win32-x64",
+    "win32-arm64": "opensquid-engine-win32-arm64",
+};
+const BIN_NAME_FOR_PLATFORM = {
+    "darwin-x64": "loop-engine",
+    "darwin-arm64": "loop-engine",
+    "linux-x64": "loop-engine",
+    "linux-arm64": "loop-engine",
+    "win32-x64": "loop-engine.exe",
+    "win32-arm64": "loop-engine.exe",
+};
+/**
+ * Compute the (platform, arch) tuple for the current process. Wrapped
+ * for unit testability — tests inject a synthetic probe.
+ */
+export function currentPlatform() {
+    return { platform: process.platform, arch: process.arch };
+}
+/**
+ * Look up the optional-dep package name for a given platform. Returns
+ * `null` when the (platform, arch) pair isn't in the supported matrix.
+ */
+export function packageForPlatform(probe) {
+    const key = `${probe.platform}-${probe.arch}`;
+    return PACKAGE_FOR_PLATFORM[key] ?? null;
+}
+/**
+ * Look up the binary filename for a given platform (`.exe` on Windows).
+ */
+export function binaryNameForPlatform(probe) {
+    const key = `${probe.platform}-${probe.arch}`;
+    return BIN_NAME_FOR_PLATFORM[key] ?? null;
+}
+/**
+ * Resolve the bundled binary path via the optional-dep mechanism.
+ *
+ * Returns `null` when:
+ *   - the current (platform, arch) isn't in the supported matrix,
+ *   - the optional dep isn't installed (pre-publish dev, npm
+ *     `--no-optional`, wrong-platform install), or
+ *   - the dep is installed but the expected `bin/<name>` file is missing
+ *     (broken publish — diagnostic-only; caller falls through).
+ *
+ * Resolution is synchronous + side-effect-free. Safe to call before any
+ * async work in the spawn path.
+ */
+export function resolveBundledEngineBin(probe = currentPlatform()) {
+    const pkg = packageForPlatform(probe);
+    const binName = binaryNameForPlatform(probe);
+    if (!pkg || !binName)
+        return null;
+    // createRequire(import.meta.url) gives us a node-resolution function
+    // anchored at this file's location — which is what we want since the
+    // optional deps are installed alongside the main package's node_modules.
+    const req = createRequire(import.meta.url);
+    try {
+        // We resolve the package's package.json (always present) and append
+        // the binary path. Resolving `${pkg}/bin/<name>` directly would
+        // require the binary to be listed in `exports` or `bin`, which we
+        // intentionally don't do (the binary is opaque to node's loader).
+        const pkgJson = req.resolve(`${pkg}/package.json`);
+        // pkgJson = /absolute/path/to/node_modules/<pkg>/package.json
+        // binary  = /absolute/path/to/node_modules/<pkg>/bin/<name>
+        // v0.6c audit fix (H1): use path.join not string slice. On Windows
+        // require.resolve returns `\` separators; slicing on "/package.json".length
+        // would silently mis-strip the suffix and concatenating with "/bin/..."
+        // would mix separators. path.dirname + path.join is the portable primitive.
+        return path.join(path.dirname(pkgJson), "bin", binName);
+    }
+    catch {
+        // MODULE_NOT_FOUND — optional dep wasn't installed for this host.
+        return null;
+    }
+}

package/dist/engine-binary-resolver.test.js

@@ -0,0 +1,61 @@
+import { describe, expect, it } from "vitest";
+import { binaryNameForPlatform, currentPlatform, packageForPlatform, resolveBundledEngineBin, } from "./engine-binary-resolver.js";
+describe("packageForPlatform", () => {
+    it("maps darwin-arm64 → opensquid-engine-darwin-arm64", () => {
+        expect(packageForPlatform({ platform: "darwin", arch: "arm64" })).toBe("opensquid-engine-darwin-arm64");
+    });
+    it("maps darwin-x64 → opensquid-engine-darwin-x64", () => {
+        expect(packageForPlatform({ platform: "darwin", arch: "x64" })).toBe("opensquid-engine-darwin-x64");
+    });
+    it("maps linux-x64 → opensquid-engine-linux-x64", () => {
+        expect(packageForPlatform({ platform: "linux", arch: "x64" })).toBe("opensquid-engine-linux-x64");
+    });
+    it("maps linux-arm64 → opensquid-engine-linux-arm64", () => {
+        expect(packageForPlatform({ platform: "linux", arch: "arm64" })).toBe("opensquid-engine-linux-arm64");
+    });
+    it("maps win32-x64 → opensquid-engine-win32-x64", () => {
+        expect(packageForPlatform({ platform: "win32", arch: "x64" })).toBe("opensquid-engine-win32-x64");
+    });
+    it("maps win32-arm64 → opensquid-engine-win32-arm64", () => {
+        expect(packageForPlatform({ platform: "win32", arch: "arm64" })).toBe("opensquid-engine-win32-arm64");
+    });
+    it("returns null for unsupported platform (freebsd)", () => {
+        expect(packageForPlatform({ platform: "freebsd", arch: "x64" })).toBeNull();
+    });
+    it("returns null for unsupported arch (ppc64)", () => {
+        expect(packageForPlatform({ platform: "linux", arch: "ppc64" })).toBeNull();
+    });
+});
+describe("binaryNameForPlatform", () => {
+    it("returns loop-engine on unix", () => {
+        expect(binaryNameForPlatform({ platform: "darwin", arch: "arm64" })).toBe("loop-engine");
+        expect(binaryNameForPlatform({ platform: "linux", arch: "x64" })).toBe("loop-engine");
+    });
+    it("returns loop-engine.exe on windows", () => {
+        expect(binaryNameForPlatform({ platform: "win32", arch: "x64" })).toBe("loop-engine.exe");
+        expect(binaryNameForPlatform({ platform: "win32", arch: "arm64" })).toBe("loop-engine.exe");
+    });
+    it("returns null for unsupported platform", () => {
+        expect(binaryNameForPlatform({ platform: "aix", arch: "x64" })).toBeNull();
+    });
+});
+describe("currentPlatform", () => {
+    it("returns the live process platform + arch", () => {
+        const probe = currentPlatform();
+        expect(probe.platform).toBe(process.platform);
+        expect(probe.arch).toBe(process.arch);
+    });
+});
+describe("resolveBundledEngineBin", () => {
+    it("returns null for unsupported platform (no map entry → no resolve attempt)", () => {
+        expect(resolveBundledEngineBin({ platform: "haiku", arch: "x64" })).toBeNull();
+    });
+    it("returns null when the optional dep isn't installed for the current platform", () => {
+        // Pre-publish: none of the opensquid-engine-* packages exist in
+        // node_modules. The resolver must not throw — it must return null
+        // so callers fall through to the legacy discovery chain. After
+        // publish, this assertion would flip; the test stays correct as a
+        // pre-publish guarantee.
+        expect(resolveBundledEngineBin()).toBeNull();
+    });
+});

package/dist/engine-cli.js

@@ -0,0 +1,60 @@
+/**
+ * `opensquid engine <subcommand>` — engine binary management.
+ *
+ * Subcommands:
+ *   doctor             — show the resolved engine binary + how it was
+ *                        discovered (env / config / search / PATH)
+ *   set-path <path>    — persist an explicit engine binary path in
+ *                        ~/.opensquid/config.json
+ *   forget             — clear the persisted path; force re-discovery
+ *                        on next start
+ */
+import { forgetEngineBin, loadConfig, resolveEngineBin, setEngineBin } from "./config.js";
+export class EngineCliError extends Error {
+    hint;
+    constructor(message, hint) {
+        super(message);
+        this.hint = hint;
+        this.name = "EngineCliError";
+    }
+}
+async function cmdDoctor() {
+    console.log(`[opensquid engine doctor]`);
+    const env = process.env.OPENSQUID_ENGINE_BIN?.trim();
+    console.log(`  env OPENSQUID_ENGINE_BIN: ${env ?? "(unset)"}`);
+    const config = await loadConfig();
+    console.log(`  config.engine_bin:        ${config.engine_bin ?? "(unset)"}`);
+    if (config.engine_bin_resolved_at) {
+        console.log(`  resolved at:              ${config.engine_bin_resolved_at}`);
+    }
+    const resolved = await resolveEngineBin();
+    console.log(`  resolved binary:          ${resolved ?? "(none — not found)"}`);
+    if (!resolved) {
+        console.log(`  hint: run \`opensquid engine set-path <path>\` to fix.`);
+    }
+}
+async function cmdSetPath(args) {
+    const target = args[0];
+    if (!target) {
+        throw new EngineCliError("usage: opensquid engine set-path <path>", "pass the path to a loop-engine release binary");
+    }
+    const res = await setEngineBin(target);
+    console.log(`[opensquid engine set-path] persisted: ${res.resolved}`);
+}
+async function cmdForget() {
+    await forgetEngineBin();
+    console.log(`[opensquid engine forget] cleared persisted engine_bin`);
+}
+export async function runEngineCli(cmd, argv) {
+    switch (cmd) {
+        case "doctor":
+            await cmdDoctor();
+            return;
+        case "set-path":
+            await cmdSetPath(argv);
+            return;
+        case "forget":
+            await cmdForget();
+            return;
+    }
+}