opensquid 0.5.441 → 0.5.447

package/dist/project.js

@@ -1,281 +0,0 @@
-/**
- * Project identity — decouple project scope from filesystem path.
- *
- * Two artifacts work together:
- *
- *   1. **Local ID card** at `<project-root>/.opensquid/project.json` —
- *      stable identity that travels with the project across moves /
- *      renames. Contains `id` (human-friendly), `uuid` (machine-stable),
- *      `created_at`.
- *
- *   2. **Global registry** at `~/.opensquid/projects.json` — index of
- *      all known projects by uuid. Tracks `last_seen_path`,
- *      `last_seen_at`, `status` (active|deleted) so we can detect
- *      moves and prune deletes.
- *
- * State machine on `resolveProject(cwd)`:
- *
- *   - card present, registry agrees on path → **known**
- *   - card present, registry has different path for this uuid → **moved**
- *     (registry's old path may or may not still exist; we update both)
- *   - card absent → **new** (caller decides whether to auto-create)
- *
- * `pruneDeleted()` sweeps the registry: for each active entry whose
- * `last_seen_path` no longer exists on disk, flip status to "deleted".
- */
-import * as crypto from "node:crypto";
-import { promises as fs } from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { resolveDataRoot } from "./codex/store.js";
-// ---------------------------------------------------------------------
-// Paths
-// ---------------------------------------------------------------------
-const CARD_DIR = ".opensquid";
-const CARD_FILE = "project.json";
-const REGISTRY_FILE = "projects.json";
-/** Path to the registry file. */
-export function registryPath(dataRoot) {
-    return path.join(resolveDataRoot(dataRoot), REGISTRY_FILE);
-}
-/** Path the ID card WOULD live at for a given project root. */
-export function cardPathForRoot(projectRoot) {
-    return path.join(projectRoot, CARD_DIR, CARD_FILE);
-}
-// ---------------------------------------------------------------------
-// Card load / save
-// ---------------------------------------------------------------------
-/**
- * Walk up from `cwd` looking for a `.opensquid/project.json` card.
- * Stops at the filesystem root. Returns the card + the path the
- * card was found at, or null if no card exists in any ancestor.
- */
-export async function findProjectCard(cwd) {
-    let dir = path.resolve(cwd);
-    while (true) {
-        const candidate = path.join(dir, CARD_DIR, CARD_FILE);
-        try {
-            const raw = await fs.readFile(candidate, "utf8");
-            const parsed = JSON.parse(raw);
-            if (parsed && parsed.version === 1 && parsed.uuid && parsed.id) {
-                return { card: parsed, cardPath: candidate };
-            }
-        }
-        catch {
-            // ignore — keep walking up
-        }
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            return null;
-        dir = parent;
-    }
-}
-/**
- * Write a project card at `<projectRoot>/.opensquid/project.json`.
- * Refuses to overwrite an existing card unless `force` is set —
- * overwriting is a manual operation, not an accidental one.
- */
-export async function writeProjectCard(projectRoot, card, options = {}) {
-    const cardPath = cardPathForRoot(projectRoot);
-    try {
-        await fs.access(cardPath);
-        if (!options.force) {
-            throw new Error(`project card already exists at ${cardPath} (use force to overwrite)`);
-        }
-    }
-    catch (err) {
-        // Re-throw real errors; ENOENT means we proceed.
-        if (err.code !== "ENOENT" &&
-            !(err instanceof Error && err.message.includes("already exists"))) {
-            throw err;
-        }
-        if (err instanceof Error && err.message.includes("already exists"))
-            throw err;
-    }
-    await fs.mkdir(path.dirname(cardPath), { recursive: true });
-    await fs.writeFile(cardPath, JSON.stringify(card, null, 2) + "\n", "utf8");
-    return { cardPath };
-}
-// ---------------------------------------------------------------------
-// Registry load / save
-// ---------------------------------------------------------------------
-export async function loadRegistry(dataRoot) {
-    const p = registryPath(dataRoot);
-    try {
-        const raw = await fs.readFile(p, "utf8");
-        const parsed = JSON.parse(raw);
-        if (parsed && parsed.version === 1 && parsed.projects)
-            return parsed;
-    }
-    catch {
-        // missing or malformed — return a fresh registry
-    }
-    return { version: 1, projects: {} };
-}
-export async function saveRegistry(reg, dataRoot) {
-    const p = registryPath(dataRoot);
-    await fs.mkdir(path.dirname(p), { recursive: true });
-    await fs.writeFile(p, JSON.stringify(reg, null, 2) + "\n", "utf8");
-}
-// ---------------------------------------------------------------------
-// Resolve project state
-// ---------------------------------------------------------------------
-/**
- * Determine the project state for a given cwd.
- *
- * - Walks up from cwd for a card.
- * - Cross-references with the registry.
- * - Returns the state without mutating either file.
- *
- * `applyResolution` is the side-effect step: it updates the registry
- * based on the resolved state (and creates a card for `new` IF the
- * caller asks it to).
- */
-export async function resolveProject(cwd, options = {}) {
-    const found = await findProjectCard(cwd);
-    if (!found) {
-        const suggested = await suggestedIdForCwd(cwd);
-        return { kind: "new", project_root: null, suggested_id: suggested };
-    }
-    const reg = await loadRegistry(options.dataRoot);
-    const projectRoot = path.dirname(path.dirname(found.cardPath));
-    const entry = reg.projects[found.card.uuid];
-    if (!entry || entry.last_seen_path === projectRoot) {
-        return { kind: "known", card: found.card, cardPath: found.cardPath };
-    }
-    return {
-        kind: "moved",
-        card: found.card,
-        cardPath: found.cardPath,
-        from_path: entry.last_seen_path,
-    };
-}
-/**
- * Side-effecting companion to `resolveProject`. Updates the registry
- * (creating the card if asked for `new`). Idempotent.
- *
- * - `known`: bump `last_seen_at` only.
- * - `moved`: update `last_seen_path` + `last_seen_at`.
- * - `new`: if `autoCreate` is true, create a card at `cwd` + register
- *   it. Otherwise return null.
- */
-export async function applyResolution(cwd, resolved, options = {}) {
-    const dataRoot = options.dataRoot;
-    const now = new Date().toISOString();
-    const reg = await loadRegistry(dataRoot);
-    if (resolved.kind === "known") {
-        const entry = reg.projects[resolved.card.uuid];
-        if (entry) {
-            entry.last_seen_at = now;
-            entry.status = "active";
-        }
-        else {
-            const projectRoot = path.dirname(path.dirname(resolved.cardPath));
-            reg.projects[resolved.card.uuid] = {
-                id: resolved.card.id,
-                last_seen_path: projectRoot,
-                last_seen_at: now,
-                created_at: resolved.card.created_at,
-                status: "active",
-            };
-        }
-        await saveRegistry(reg, dataRoot);
-        return resolved.card;
-    }
-    if (resolved.kind === "moved") {
-        const projectRoot = path.dirname(path.dirname(resolved.cardPath));
-        reg.projects[resolved.card.uuid] = {
-            id: resolved.card.id,
-            last_seen_path: projectRoot,
-            last_seen_at: now,
-            created_at: reg.projects[resolved.card.uuid]?.created_at ?? resolved.card.created_at,
-            status: "active",
-        };
-        await saveRegistry(reg, dataRoot);
-        return resolved.card;
-    }
-    // kind === "new"
-    if (!options.autoCreate)
-        return null;
-    const id = options.id ?? resolved.suggested_id;
-    const uuid = crypto.randomUUID();
-    const created_at = now;
-    const card = { version: 1, id, uuid, created_at };
-    await writeProjectCard(path.resolve(cwd), card);
-    reg.projects[uuid] = {
-        id,
-        last_seen_path: path.resolve(cwd),
-        last_seen_at: now,
-        created_at,
-        status: "active",
-    };
-    await saveRegistry(reg, dataRoot);
-    return card;
-}
-// ---------------------------------------------------------------------
-// Registry maintenance
-// ---------------------------------------------------------------------
-/**
- * Mark registry entries as "deleted" when their `last_seen_path` no
- * longer exists on disk. Does NOT actually remove the entry — kept
- * for historical reference and so the user can see what they had.
- *
- * Returns the count of entries that flipped from active → deleted.
- */
-export async function pruneDeleted(dataRoot) {
-    const reg = await loadRegistry(dataRoot);
-    let swept = 0;
-    const removed_ids = [];
-    for (const [uuid, entry] of Object.entries(reg.projects)) {
-        if (entry.status !== "active")
-            continue;
-        try {
-            await fs.access(entry.last_seen_path);
-        }
-        catch {
-            entry.status = "deleted";
-            swept++;
-            removed_ids.push(entry.id);
-            void uuid;
-        }
-    }
-    if (swept > 0)
-        await saveRegistry(reg, dataRoot);
-    return { swept, removed_ids };
-}
-// ---------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------
-/**
- * Default-id heuristic: git toplevel basename if available, else cwd
- * basename, else "project".
- */
-async function suggestedIdForCwd(cwd) {
-    const gitTop = await gitToplevel(cwd);
-    if (gitTop)
-        return path.basename(gitTop);
-    const cwdName = path.basename(path.resolve(cwd));
-    return cwdName || "project";
-}
-async function gitToplevel(cwd) {
-    // Walk up looking for a `.git` directory.
-    let dir = path.resolve(cwd);
-    while (true) {
-        try {
-            const stat = await fs.stat(path.join(dir, ".git"));
-            if (stat.isDirectory())
-                return dir;
-        }
-        catch {
-            // keep walking
-        }
-        const parent = path.dirname(dir);
-        if (parent === dir) {
-            // tilde-fallback only used for tests where HOME might point at /
-            void os.homedir;
-            return null;
-        }
-        dir = parent;
-    }
-}
-//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../src.legacy/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA+CnD,wEAAwE;AACxE,QAAQ;AACR,wEAAwE;AAExE,MAAM,QAAQ,GAAG,YAAY,CAAC;AAC9B,MAAM,SAAS,GAAG,cAAc,CAAC;AACjC,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;AAC7D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AACrD,CAAC;AAED,wEAAwE;AACxE,mBAAmB;AACnB,wEAAwE;AAExE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW;IAEX,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;YAC9C,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;YAC/C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,IAAiB,EACjB,UAA+B,EAAE;IAEjC,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,2BAA2B,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iDAAiD;QACjD,IACG,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAChD,CAAC,CAAC,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EACjE,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAAE,MAAM,GAAG,CAAC;IAChF,CAAC;IACD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3E,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,wEAAwE;AACxE,uBAAuB;AACvB,wEAAwE;AAExE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAiB;IAClD,MAAM,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;QAC3C,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAa,EAAE,QAAiB;IACjE,MAAM,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED,wEAAwE;AACxE,wBAAwB;AACxB,wEAAwE;AAExE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,UAAiC,EAAE;IAEnC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,cAAc;KAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,QAAyB,EACzB,UAAoE,EAAE;IAEtE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC;YACzB,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBACjC,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE;gBACpB,cAAc,EAAE,WAAW;gBAC3B,YAAY,EAAE,GAAG;gBACjB,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU;gBACpC,MAAM,EAAE,QAAQ;aACjB,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACjC,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE;YACpB,cAAc,EAAE,WAAW;YAC3B,YAAY,EAAE,GAAG;YACjB,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU;YACpF,MAAM,EAAE,QAAQ;SACjB,CAAC;QACF,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC,YAAY,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,GAAG,CAAC;IACvB,MAAM,IAAI,GAAgB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC/D,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG;QACnB,EAAE;QACF,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QACjC,YAAY,EAAE,GAAG;QACjB,UAAU;QACV,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wEAAwE;AACxE,uBAAuB;AACvB,wEAAwE;AAExE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAiB;IAIlD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,SAAS;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;YACzB,KAAK,EAAE,CAAC;YACR,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3B,KAAK,IAAI,CAAC;QACZ,CAAC;IACH,CAAC;IACD,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,wEAAwE;AACxE,UAAU;AACV,wEAAwE;AAExE;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,GAAW;IACpC,0CAA0C;IAC1C,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,WAAW,EAAE;gBAAE,OAAO,GAAG,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,iEAAiE;YACjE,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/project.test.js

@@ -1,287 +0,0 @@
-import * as crypto from "node:crypto";
-import { promises as fs } from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { applyResolution, cardPathForRoot, findProjectCard, loadRegistry, pruneDeleted, resolveProject, saveRegistry, writeProjectCard, } from "./project.js";
-let tmpRoot;
-let tmpHome;
-beforeEach(async () => {
-    const uniq = crypto.randomUUID();
-    tmpRoot = path.join(os.tmpdir(), `oscli-project-cwd-${uniq}`);
-    tmpHome = path.join(os.tmpdir(), `oscli-project-home-${uniq}`);
-    await fs.mkdir(tmpRoot, { recursive: true });
-    await fs.mkdir(tmpHome, { recursive: true });
-});
-afterEach(async () => {
-    await fs.rm(tmpRoot, { recursive: true, force: true });
-    await fs.rm(tmpHome, { recursive: true, force: true });
-});
-// ---------------------------------------------------------------------
-// findProjectCard
-// ---------------------------------------------------------------------
-describe("findProjectCard", () => {
-    it("returns null when no card in any ancestor", async () => {
-        expect(await findProjectCard(tmpRoot)).toBeNull();
-    });
-    it("finds a card at cwd", async () => {
-        const card = {
-            version: 1,
-            id: "x",
-            uuid: "u-1",
-            created_at: "2026-05-15T00:00:00Z",
-        };
-        await writeProjectCard(tmpRoot, card);
-        const found = await findProjectCard(tmpRoot);
-        expect(found?.card.uuid).toBe("u-1");
-    });
-    it("walks up to find a card at an ancestor", async () => {
-        const card = {
-            version: 1,
-            id: "x",
-            uuid: "u-1",
-            created_at: "2026-05-15T00:00:00Z",
-        };
-        await writeProjectCard(tmpRoot, card);
-        const deep = path.join(tmpRoot, "src", "nested", "deep");
-        await fs.mkdir(deep, { recursive: true });
-        const found = await findProjectCard(deep);
-        expect(found?.card.uuid).toBe("u-1");
-        expect(found?.cardPath).toBe(cardPathForRoot(tmpRoot));
-    });
-    it("ignores malformed card files", async () => {
-        await fs.mkdir(path.join(tmpRoot, ".opensquid"), { recursive: true });
-        await fs.writeFile(cardPathForRoot(tmpRoot), "{not valid json", "utf8");
-        expect(await findProjectCard(tmpRoot)).toBeNull();
-    });
-});
-// ---------------------------------------------------------------------
-// writeProjectCard
-// ---------------------------------------------------------------------
-describe("writeProjectCard", () => {
-    it("creates the .opensquid/project.json file", async () => {
-        const card = {
-            version: 1,
-            id: "x",
-            uuid: "u-1",
-            created_at: "now",
-        };
-        const res = await writeProjectCard(tmpRoot, card);
-        expect(res.cardPath).toBe(cardPathForRoot(tmpRoot));
-        const read = await fs.readFile(res.cardPath, "utf8");
-        expect(JSON.parse(read).uuid).toBe("u-1");
-    });
-    it("refuses to overwrite without force", async () => {
-        const card = {
-            version: 1,
-            id: "x",
-            uuid: "u-1",
-            created_at: "now",
-        };
-        await writeProjectCard(tmpRoot, card);
-        await expect(writeProjectCard(tmpRoot, card)).rejects.toThrow(/already exists/);
-    });
-    it("overwrites with force=true", async () => {
-        const v1 = {
-            version: 1,
-            id: "x",
-            uuid: "u-1",
-            created_at: "now",
-        };
-        await writeProjectCard(tmpRoot, v1);
-        const v2 = { ...v1, id: "y" };
-        await writeProjectCard(tmpRoot, v2, { force: true });
-        const found = await findProjectCard(tmpRoot);
-        expect(found?.card.id).toBe("y");
-    });
-});
-// ---------------------------------------------------------------------
-// resolveProject — state machine
-// ---------------------------------------------------------------------
-describe("resolveProject state machine", () => {
-    it("returns 'new' when no card exists", async () => {
-        const r = await resolveProject(tmpRoot, { dataRoot: tmpHome });
-        expect(r.kind).toBe("new");
-        if (r.kind === "new") {
-            expect(r.suggested_id).toBe(path.basename(tmpRoot));
-        }
-    });
-    it("returns 'known' when card exists at path that matches registry", async () => {
-        const card = {
-            version: 1,
-            id: "x",
-            uuid: "u-1",
-            created_at: "now",
-        };
-        await writeProjectCard(tmpRoot, card);
-        // Apply once so registry knows the path.
-        await applyResolution(tmpRoot, await resolveProject(tmpRoot, { dataRoot: tmpHome }), {
-            dataRoot: tmpHome,
-        });
-        const r = await resolveProject(tmpRoot, { dataRoot: tmpHome });
-        expect(r.kind).toBe("known");
-    });
-    it("returns 'moved' when card exists at NEW path but registry has DIFFERENT path", async () => {
-        // Create card at tmpRoot, register it there.
-        const card = {
-            version: 1,
-            id: "x",
-            uuid: "u-1",
-            created_at: "now",
-        };
-        await writeProjectCard(tmpRoot, card);
-        await applyResolution(tmpRoot, await resolveProject(tmpRoot, { dataRoot: tmpHome }), {
-            dataRoot: tmpHome,
-        });
-        // Simulate move: write the same card at a new path, leave registry as-is.
-        const newRoot = path.join(os.tmpdir(), `oscli-moved-${crypto.randomUUID()}`);
-        await fs.mkdir(newRoot, { recursive: true });
-        try {
-            await writeProjectCard(newRoot, card);
-            const r = await resolveProject(newRoot, { dataRoot: tmpHome });
-            expect(r.kind).toBe("moved");
-            if (r.kind === "moved") {
-                expect(r.from_path).toBe(tmpRoot);
-            }
-        }
-        finally {
-            await fs.rm(newRoot, { recursive: true, force: true });
-        }
-    });
-});
-// ---------------------------------------------------------------------
-// applyResolution
-// ---------------------------------------------------------------------
-describe("applyResolution", () => {
-    it("auto-creates card on 'new' when autoCreate=true", async () => {
-        const r = await resolveProject(tmpRoot, { dataRoot: tmpHome });
-        expect(r.kind).toBe("new");
-        const card = await applyResolution(tmpRoot, r, {
-            dataRoot: tmpHome,
-            autoCreate: true,
-        });
-        expect(card).not.toBeNull();
-        expect(card?.id).toBe(path.basename(tmpRoot));
-        // Card persisted on disk.
-        const found = await findProjectCard(tmpRoot);
-        expect(found?.card.uuid).toBe(card?.uuid);
-        // Registry has it.
-        const reg = await loadRegistry(tmpHome);
-        expect(reg.projects[card.uuid].last_seen_path).toBe(tmpRoot);
-    });
-    it("returns null on 'new' when autoCreate=false (default)", async () => {
-        const r = await resolveProject(tmpRoot, { dataRoot: tmpHome });
-        const card = await applyResolution(tmpRoot, r, { dataRoot: tmpHome });
-        expect(card).toBeNull();
-        expect(await findProjectCard(tmpRoot)).toBeNull();
-    });
-    it("custom --id overrides the suggested default on auto-create", async () => {
-        const r = await resolveProject(tmpRoot, { dataRoot: tmpHome });
-        const card = await applyResolution(tmpRoot, r, {
-            dataRoot: tmpHome,
-            autoCreate: true,
-            id: "custom-name",
-        });
-        expect(card?.id).toBe("custom-name");
-    });
-    it("updates registry path on 'moved'", async () => {
-        // Create card + register at tmpRoot.
-        const card = {
-            version: 1,
-            id: "x",
-            uuid: "u-mov",
-            created_at: "now",
-        };
-        await writeProjectCard(tmpRoot, card);
-        await applyResolution(tmpRoot, await resolveProject(tmpRoot, { dataRoot: tmpHome }), {
-            dataRoot: tmpHome,
-        });
-        // Move: same card at a new path.
-        const newRoot = path.join(os.tmpdir(), `oscli-moved-${crypto.randomUUID()}`);
-        await fs.mkdir(newRoot, { recursive: true });
-        try {
-            await writeProjectCard(newRoot, card);
-            const r = await resolveProject(newRoot, { dataRoot: tmpHome });
-            expect(r.kind).toBe("moved");
-            await applyResolution(newRoot, r, { dataRoot: tmpHome });
-            const reg = await loadRegistry(tmpHome);
-            expect(reg.projects["u-mov"].last_seen_path).toBe(newRoot);
-        }
-        finally {
-            await fs.rm(newRoot, { recursive: true, force: true });
-        }
-    });
-    it("preserves created_at across registry updates", async () => {
-        const card = {
-            version: 1,
-            id: "x",
-            uuid: "u-1",
-            created_at: "2020-01-01T00:00:00Z",
-        };
-        await writeProjectCard(tmpRoot, card);
-        await applyResolution(tmpRoot, await resolveProject(tmpRoot, { dataRoot: tmpHome }), {
-            dataRoot: tmpHome,
-        });
-        const reg1 = await loadRegistry(tmpHome);
-        const firstCreatedAt = reg1.projects["u-1"].created_at;
-        // Second invocation shouldn't change created_at even when last_seen_at moves.
-        await applyResolution(tmpRoot, await resolveProject(tmpRoot, { dataRoot: tmpHome }), {
-            dataRoot: tmpHome,
-        });
-        const reg2 = await loadRegistry(tmpHome);
-        expect(reg2.projects["u-1"].created_at).toBe(firstCreatedAt);
-    });
-});
-// ---------------------------------------------------------------------
-// pruneDeleted
-// ---------------------------------------------------------------------
-describe("pruneDeleted", () => {
-    it("flips entries whose last_seen_path no longer exists", async () => {
-        // Set up two entries: one path exists, one doesn't.
-        const goneRoot = path.join(os.tmpdir(), `oscli-gone-${crypto.randomUUID()}`);
-        await fs.mkdir(goneRoot);
-        await saveRegistry({
-            version: 1,
-            projects: {
-                alive: {
-                    id: "alive",
-                    last_seen_path: tmpRoot,
-                    last_seen_at: "2026-05-15T00:00:00Z",
-                    created_at: "2026-05-15T00:00:00Z",
-                    status: "active",
-                },
-                gone: {
-                    id: "gone",
-                    last_seen_path: goneRoot,
-                    last_seen_at: "2026-05-15T00:00:00Z",
-                    created_at: "2026-05-15T00:00:00Z",
-                    status: "active",
-                },
-            },
-        }, tmpHome);
-        // Delete the path for "gone" so it'll be flagged.
-        await fs.rm(goneRoot, { recursive: true, force: true });
-        const res = await pruneDeleted(tmpHome);
-        expect(res.swept).toBe(1);
-        expect(res.removed_ids).toEqual(["gone"]);
-        const reg = await loadRegistry(tmpHome);
-        expect(reg.projects.alive.status).toBe("active");
-        expect(reg.projects.gone.status).toBe("deleted");
-    });
-    it("does not touch already-deleted entries", async () => {
-        await saveRegistry({
-            version: 1,
-            projects: {
-                ghost: {
-                    id: "ghost",
-                    last_seen_path: "/nonexistent/path",
-                    last_seen_at: "2026-05-15T00:00:00Z",
-                    created_at: "2026-05-15T00:00:00Z",
-                    status: "deleted",
-                },
-            },
-        }, tmpHome);
-        const res = await pruneDeleted(tmpHome);
-        expect(res.swept).toBe(0);
-    });
-});

package/dist/rag/backends/loop_engine.d.ts

@@ -1,61 +0,0 @@
-/**
- * Loop-engine RAG backend — routes RagBackend through the engine daemon's
- * JSON-RPC API (memory.search + memory.create) via the T.4 UDS singleton.
- *
- * Quality: `mode: 'hybrid'` invokes engine-side RRF fusion (K=60, Cormack
- * et al. 2009) — drop-in equivalent to opensquid's `src/rag/rrf.ts:65`
- * per T.1.JJ. No TS-side fusion needed; engine does it server-side over a
- * larger native vector index than libsql's DiskANN.
- *
- * Critical design locks (T.1.B + T.1.#6):
- *
- *  1. **storeLesson → memory.create is INTENTIONAL, not a bug.** Routing
- *     here through `lesson.create` would force every recall-pool write
- *     through the wedge gate's 24h + applied_count=3 + external_signal
- *     promotion requirements (per T.1.F — unsatisfiable in a single
- *     write call, breaks unit tests). RagBackend.storeLesson semantically
- *     stores a recallable memory, NOT a wedge-gated lesson; lesson
- *     lifecycle is a separate surface added in T.6.
- *
- *  2. **Description synthesis is mandatory.** `memory.create` rejects
- *     empty `description` (T.1.B INVALID_PARAMS -32602). Synthesized
- *     from first sentence → first 80 chars → ultimate fallback. Lesson
- *     shape doesn't carry a description field today, so we derive it.
- *
- *  3. **`include_body: true` on every recall.** memory.search's default
- *     `body_preview` is truncated to 240 chars (engine serve.rs); without
- *     this flag RecallHit.lesson.content gets cut mid-sentence.
- *
- *  4. **Source vocab mapping at the boundary.** Engine speaks
- *     `'semantic' | 'text' | 'both'`; RagBackend's RecallHit speaks
- *     `'semantic' | 'lexical' | 'fused'`. The adapter table is the
- *     single point of translation — DO NOT leak engine vocab past it.
- *
- *  5. **Engine schema gap.** `memory.create` doesn't preserve tags /
- *     source / author / createdAt today (T.8 follow-up filed). For v1
- *     we send `description` + `content` only; lesson metadata round-trips
- *     via the Lesson defaults applied by `src/functions/rag.ts:122-145`.
- *
- *  6. **No daemon lifecycle here.** `EngineClient` connects via the T.4
- *     `acquireOrSpawnEngine()` singleton transparently — zero per-call
- *     subprocess cost, cross-session shared engine.
- *
- * Imports from: ../../engine/client.js, ../ollama_client.js, ../types.js.
- * Imported by: src/rag/backend_factory.ts.
- */
-import { EngineClient } from '../../engine/client.js';
-import type { RagBackend } from '../types.js';
-export interface LoopEngineBackendOpts {
-    /** Injected client for tests; production uses the singleton-backed default. */
-    client?: EngineClient;
-    /** Recall mode. 'hybrid' = engine semantic+text+RRF (default, matches
-     *  libsql-qwen3 quality per T.1.JJ). 'semantic' = vector only. 'text' =
-     *  pure text-match. */
-    mode?: 'semantic' | 'text' | 'hybrid';
-    /** Ollama URL for embed() — only used when a rule asks for a raw vector
-     *  via the `embed` primitive. Engine handles embedding internally for
-     *  memory.create + memory.search. */
-    ollamaUrl?: string;
-}
-export declare function loopEngineBackend(opts?: LoopEngineBackendOpts): RagBackend;
-//# sourceMappingURL=loop_engine.d.ts.map

package/dist/rag/backends/loop_engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loop_engine.d.ts","sourceRoot":"","sources":["../../../src/rag/backends/loop_engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,EAAgB,YAAY,EAAY,MAAM,wBAAwB,CAAC;AAK9E,OAAO,KAAK,EAAwB,UAAU,EAAa,MAAM,aAAa,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;2BAEuB;IACvB,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IACtC;;yCAEqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,qBAA0B,GAAG,UAAU,CAgF9E"}