@baoanaz/cviauto-core 0.6.5

package/dist/mem/internal/paths.js

@@ -0,0 +1,97 @@
+/**
+ * Default home-based session roots for the persisted-session adapters.
+ *
+ * `HOME` is captured once at module load — consumers that need to point the
+ * adapters at a fake home (tests) must mock `node:os` before importing any
+ * mem module.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+export const HOME = os.homedir();
+export const CLAUDE_PROJECTS = path.join(HOME, ".claude", "projects");
+export const CODEX_SESSIONS = path.join(HOME, ".codex", "sessions");
+function expandHome(p) {
+    if (p === "~")
+        return HOME;
+    if (p.startsWith(`~${path.sep}`))
+        return path.join(HOME, p.slice(2));
+    if (p.startsWith("~/"))
+        return path.join(HOME, p.slice(2));
+    return p;
+}
+export const PI_AGENT_DIR = expandHome(process.env.PI_CODING_AGENT_DIR ?? path.join(HOME, ".pi", "agent"));
+export const PI_SESSIONS = expandHome(process.env.PI_CODING_AGENT_SESSION_DIR ??
+    path.join(PI_AGENT_DIR, "sessions"));
+function readPiSettingsSessionDir() {
+    const settingsFile = path.join(PI_AGENT_DIR, "settings.json");
+    try {
+        const raw = JSON.parse(fs.readFileSync(settingsFile, "utf8"));
+        if (!raw || typeof raw !== "object" || Array.isArray(raw))
+            return undefined;
+        const sessionDir = raw.sessionDir;
+        return typeof sessionDir === "string" && sessionDir.trim()
+            ? expandHome(sessionDir)
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Claude sanitizes a cwd into its on-disk project dir name by replacing
+ * every path separator (`/` and Windows `\`), drive colon (`:`), `_`, and `.`
+ * with `-`. Confirmed empirically against `~/.claude/projects/`:
+ * `/Users/x/.codex/...` → `-Users-x--codex-...`, `snap_note` → `snap-note`. */
+export function claudeProjectDirFromCwd(cwd) {
+    return path.join(CLAUDE_PROJECTS, cwd.replace(/[/\\:_.]/g, "-"));
+}
+/** Pi encodes a cwd as `--<resolved-cwd-with-separators-as-dashes>--`. */
+export function piProjectDirFromCwd(cwd) {
+    const resolvedCwd = path.resolve(cwd);
+    const safePath = `--${resolvedCwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
+    return path.join(path.join(PI_AGENT_DIR, "sessions"), safePath);
+}
+/** Discover Pi session roots visible from the current process. */
+export function piSessionRoots() {
+    const roots = [path.join(PI_AGENT_DIR, "sessions"), PI_SESSIONS];
+    const settingsSessionDir = readPiSettingsSessionDir();
+    if (settingsSessionDir)
+        roots.push(settingsSessionDir);
+    const seen = new Set();
+    const out = [];
+    for (const root of roots) {
+        const normalized = path.resolve(root);
+        if (seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        out.push(root);
+    }
+    return out;
+}
+/** Lazy stack-based recursive file walk — yields every file path under
+ * `root`. Missing roots and unreadable directories are skipped silently. */
+export function* walkDir(root) {
+    if (!fs.existsSync(root))
+        return;
+    const stack = [root];
+    while (stack.length) {
+        const cur = stack.pop();
+        if (cur === undefined)
+            break;
+        let entries;
+        try {
+            entries = fs.readdirSync(cur, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const p = path.join(cur, e.name);
+            if (e.isDirectory())
+                stack.push(p);
+            else if (e.isFile())
+                yield p;
+        }
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/mem/internal/paths.js.map

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

package/dist/mem/phase.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `task.py` command parsing and brainstorm-window slicing.
+ *
+ * Pure logic only — boundary signals are recovered from raw shell-call strings;
+ * the per-platform raw-JSONL pass that produces those strings lives in the
+ * adapters.
+ */
+import type { BrainstormWindow, ParsedTaskPyCommand, TaskPyEvent } from "./types.js";
+/**
+ * Find ALL `task.py create|start` invocations in a single Bash command string.
+ * A real Bash invocation can contain several (e.g.
+ * `SMOKE=$(task.py create …); task.py start "$SMOKE"`). Returned in source
+ * order; each entry's args are bounded to the next `task.py` invocation or
+ * end-of-line.
+ *
+ * False-positive guard: `task.py` must appear at the start of the command,
+ * after whitespace, or after a path separator — never embedded inside a flag
+ * value like `--slug=task.py-create-foo`.
+ */
+export declare function parseTaskPyCommandsAll(cmd: string): ParsedTaskPyCommand[];
+/** Single-result wrapper — returns the first occurrence, or `null` if none. */
+export declare function parseTaskPyCommand(cmd: string): ParsedTaskPyCommand | null;
+/** Best-effort shell-arg splitter: respects `"…"` / `'…'` quoting, splits on
+ * whitespace, treats `;`, `|`, `&`, `(`, `)` as token boundaries, and strips
+ * trailing shell-meta cruft (`)};&|>`) from each token. Not a full POSIX
+ * parser — sufficient for pulling slugs / paths out of `task.py` invocations. */
+export declare function splitShellArgs(s: string): string[];
+/** Derive a slug from a `start` task-dir path like
+ * `.cviauto/tasks/05-08-mem-phase-slice/` → `mem-phase-slice` (the `MM-DD-`
+ * date prefix is stripped so it matches a `--slug` on the paired `create`). */
+export declare function slugFromTaskDir(p: string | undefined): string | undefined;
+/**
+ * Pair `create` → `start` events into brainstorm windows.
+ *
+ * Pairing strategy:
+ *   1. Slug match wins regardless of position.
+ *   2. FIFO fallback: remaining creates pair with the next unmatched start
+ *      appearing after them in event order.
+ *   3. Unmatched create → `[create, totalTurns)`.
+ *   4. Unmatched start  → `[0, start)`.
+ *
+ * Windows are sorted by `startTurn` ascending for stable output ordering.
+ */
+export declare function buildBrainstormWindows(events: readonly TaskPyEvent[], totalTurns: number): BrainstormWindow[];
+//# sourceMappingURL=phase.d.ts.map

package/dist/mem/phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/mem/phase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAgCzE;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAG1E;AAqCD;;;iFAGiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAmClD;AAED;;+EAE+E;AAC/E,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,UAAU,EAAE,MAAM,GACjB,gBAAgB,EAAE,CA2EpB"}

package/dist/mem/phase.js

@@ -0,0 +1,220 @@
+/**
+ * `task.py` command parsing and brainstorm-window slicing.
+ *
+ * Pure logic only — boundary signals are recovered from raw shell-call strings;
+ * the per-platform raw-JSONL pass that produces those strings lives in the
+ * adapters.
+ */
+/**
+ * Find ALL `task.py create|start` invocations in a single Bash command string.
+ * A real Bash invocation can contain several (e.g.
+ * `SMOKE=$(task.py create …); task.py start "$SMOKE"`). Returned in source
+ * order; each entry's args are bounded to the next `task.py` invocation or
+ * end-of-line.
+ *
+ * False-positive guard: `task.py` must appear at the start of the command,
+ * after whitespace, or after a path separator — never embedded inside a flag
+ * value like `--slug=task.py-create-foo`.
+ */
+export function parseTaskPyCommandsAll(cmd) {
+    if (typeof cmd !== "string" || cmd.length === 0)
+        return [];
+    const all = [];
+    const findRe = /(^|[\s/\\])task\.py\s+(create|start)(?:\s+|$)/g;
+    const matches = [];
+    for (const m of cmd.matchAll(findRe)) {
+        const action = m[2];
+        const bodyStart = m.index + m[0].length;
+        matches.push({ action, bodyStart });
+    }
+    for (let i = 0; i < matches.length; i++) {
+        const cur = matches[i];
+        if (!cur)
+            continue;
+        const next = matches[i + 1];
+        const slice = cmd.slice(cur.bodyStart, next?.bodyStart ?? cmd.length);
+        const restRaw = (slice.split("\n")[0] ?? "").trim();
+        // Reject prose-embedded matches: a bare alphanumeric word followed by
+        // another all-letters word is English prose, not a real invocation.
+        if (/^[A-Za-z][A-Za-z0-9_-]*\s+[A-Za-z]{2,}\b/.test(restRaw))
+            continue;
+        const parsed = parseRestOfTaskPyCommand(cur.action, restRaw);
+        if (cur.action === "create" &&
+            parsed.action === "create" &&
+            !parsed.slug &&
+            !parsed.titleArg)
+            continue;
+        if (cur.action === "start" && parsed.action === "start" && !parsed.taskDir)
+            continue;
+        all.push(parsed);
+    }
+    return all;
+}
+/** Single-result wrapper — returns the first occurrence, or `null` if none. */
+export function parseTaskPyCommand(cmd) {
+    const all = parseTaskPyCommandsAll(cmd);
+    return all[0] ?? null;
+}
+function parseRestOfTaskPyCommand(action, restRaw) {
+    if (action === "create") {
+        const args = splitShellArgs(restRaw);
+        let slug;
+        let titleArg;
+        for (let i = 0; i < args.length; i++) {
+            const a = args[i];
+            if (a === undefined)
+                continue;
+            if (a === "--slug" || a === "-s") {
+                slug = args[i + 1];
+                i++;
+                continue;
+            }
+            if (a.startsWith("--slug=")) {
+                slug = a.slice("--slug=".length);
+                continue;
+            }
+            if (a.startsWith("-"))
+                continue;
+            titleArg ??= a;
+        }
+        return { action: "create", slug, titleArg };
+    }
+    const args = splitShellArgs(restRaw);
+    let taskDir;
+    for (const a of args) {
+        if (a.startsWith("-"))
+            continue;
+        taskDir = a;
+        break;
+    }
+    return { action: "start", taskDir };
+}
+/** Best-effort shell-arg splitter: respects `"…"` / `'…'` quoting, splits on
+ * whitespace, treats `;`, `|`, `&`, `(`, `)` as token boundaries, and strips
+ * trailing shell-meta cruft (`)};&|>`) from each token. Not a full POSIX
+ * parser — sufficient for pulling slugs / paths out of `task.py` invocations. */
+export function splitShellArgs(s) {
+    const out = [];
+    let cur = "";
+    let quote = null;
+    const flush = () => {
+        if (!cur)
+            return;
+        const cleaned = cur.replace(/[)};&|>]+$/, "");
+        if (cleaned)
+            out.push(cleaned);
+        cur = "";
+    };
+    for (const ch of s) {
+        if (quote) {
+            if (ch === quote) {
+                quote = null;
+                continue;
+            }
+            cur += ch;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            continue;
+        }
+        if (/\s/.test(ch)) {
+            flush();
+            continue;
+        }
+        if (ch === ";" || ch === "|" || ch === "&" || ch === "(" || ch === ")") {
+            flush();
+            continue;
+        }
+        cur += ch;
+    }
+    flush();
+    return out;
+}
+/** Derive a slug from a `start` task-dir path like
+ * `.cviauto/tasks/05-08-mem-phase-slice/` → `mem-phase-slice` (the `MM-DD-`
+ * date prefix is stripped so it matches a `--slug` on the paired `create`). */
+export function slugFromTaskDir(p) {
+    if (!p)
+        return undefined;
+    const norm = p.replace(/\\+/g, "/").replace(/\/+$/g, "");
+    const parts = norm.split("/").filter(Boolean);
+    const last = parts[parts.length - 1];
+    if (last === undefined)
+        return undefined;
+    return last.replace(/^\d{2}-\d{2}-/, "");
+}
+/**
+ * Pair `create` → `start` events into brainstorm windows.
+ *
+ * Pairing strategy:
+ *   1. Slug match wins regardless of position.
+ *   2. FIFO fallback: remaining creates pair with the next unmatched start
+ *      appearing after them in event order.
+ *   3. Unmatched create → `[create, totalTurns)`.
+ *   4. Unmatched start  → `[0, start)`.
+ *
+ * Windows are sorted by `startTurn` ascending for stable output ordering.
+ */
+export function buildBrainstormWindows(events, totalTurns) {
+    const creates = events
+        .map((e, i) => ({ e, i }))
+        .filter(({ e }) => e.action === "create");
+    const starts = events
+        .map((e, i) => ({ e, i }))
+        .filter(({ e }) => e.action === "start");
+    const usedStartIdx = new Set();
+    const usedCreateIdx = new Set();
+    const windows = [];
+    let windowCounter = 0;
+    // Pass 1: pair by slug match.
+    for (const { e: createEv, i: ci } of creates) {
+        if (!createEv.slug)
+            continue;
+        const matchIdx = starts.findIndex(({ e, i }) => !usedStartIdx.has(i) && slugFromTaskDir(e.taskDir) === createEv.slug);
+        if (matchIdx === -1)
+            continue;
+        const startEntry = starts[matchIdx];
+        if (!startEntry)
+            continue;
+        usedStartIdx.add(startEntry.i);
+        usedCreateIdx.add(ci);
+        pushWindow(windows, createEv.turnIndex, startEntry.e.turnIndex, createEv.slug, ++windowCounter);
+    }
+    // Pass 2: FIFO pair remaining creates with later starts.
+    for (const { e: createEv, i: ci } of creates) {
+        if (usedCreateIdx.has(ci))
+            continue;
+        const pairedStart = starts.find(({ i }) => !usedStartIdx.has(i) && i > ci);
+        if (pairedStart) {
+            usedStartIdx.add(pairedStart.i);
+            usedCreateIdx.add(ci);
+            const slug = createEv.slug ?? slugFromTaskDir(pairedStart.e.taskDir);
+            pushWindow(windows, createEv.turnIndex, pairedStart.e.turnIndex, slug, ++windowCounter);
+        }
+        else {
+            usedCreateIdx.add(ci);
+            pushWindow(windows, createEv.turnIndex, totalTurns, createEv.slug, ++windowCounter);
+        }
+    }
+    // Pass 3: unmatched starts → [0, start).
+    for (const { e: startEv, i } of starts) {
+        if (usedStartIdx.has(i))
+            continue;
+        pushWindow(windows, 0, startEv.turnIndex, slugFromTaskDir(startEv.taskDir), ++windowCounter);
+    }
+    windows.sort((a, b) => a.startTurn - b.startTurn);
+    return windows;
+}
+function pushWindow(windows, startTurn, endTurn, slug, counter) {
+    // Guard against malformed windows (start before create due to event
+    // interleave) rather than emitting a negative slice.
+    if (endTurn < startTurn)
+        return;
+    windows.push({
+        label: slug ?? `window-${counter}`,
+        startTurn,
+        endTurn,
+    });
+}
+//# sourceMappingURL=phase.js.map

package/dist/mem/phase.js.map

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

package/dist/mem/projects.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Project aggregation: distinct session cwds with last-active timestamp and
+ * per-platform counts.
+ */
+import type { ListMemProjectsOptions, MemProjectSummary } from "./types.js";
+/**
+ * Aggregate distinct project cwds across every platform. Always scans
+ * globally (cwd scoping is dropped) — `since` / `until` / `platform` still
+ * apply. Results are sorted by `last_active` descending; the caller decides
+ * any display cap.
+ */
+export declare function listMemProjects(options?: ListMemProjectsOptions): MemProjectSummary[];
+//# sourceMappingURL=projects.d.ts.map

package/dist/mem/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/mem/projects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,iBAAiB,EAAE,CA0BrB"}

package/dist/mem/projects.js

@@ -0,0 +1,37 @@
+/**
+ * Project aggregation: distinct session cwds with last-active timestamp and
+ * per-platform counts.
+ */
+import { listAll, resolveFilter, WIDE_LIMIT } from "./sessions.js";
+/**
+ * Aggregate distinct project cwds across every platform. Always scans
+ * globally (cwd scoping is dropped) — `since` / `until` / `platform` still
+ * apply. Results are sorted by `last_active` descending; the caller decides
+ * any display cap.
+ */
+export function listMemProjects(options) {
+    const f = resolveFilter(options?.filter);
+    const all = listAll({ ...f, cwd: undefined, limit: WIDE_LIMIT });
+    const byCwd = new Map();
+    for (const s of all) {
+        if (!s.cwd)
+            continue;
+        const ts = s.updated ?? s.created ?? "";
+        let agg = byCwd.get(s.cwd);
+        if (!agg) {
+            agg = {
+                cwd: s.cwd,
+                last_active: ts,
+                sessions: 0,
+                by_platform: { claude: 0, codex: 0, opencode: 0, pi: 0 },
+            };
+            byCwd.set(s.cwd, agg);
+        }
+        agg.sessions++;
+        agg.by_platform[s.platform]++;
+        if (ts > agg.last_active)
+            agg.last_active = ts;
+    }
+    return [...byCwd.values()].sort((a, b) => b.last_active.localeCompare(a.last_active));
+}
+//# sourceMappingURL=projects.js.map

package/dist/mem/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/mem/projects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGnE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgC;IAEhC,MAAM,CAAC,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAEjE,MAAM,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,GAAG;YAAE,SAAS;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QACxC,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG;gBACJ,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE;aACzD,CAAC;YACF,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxB,CAAC;QACD,GAAG,CAAC,QAAQ,EAAE,CAAC;QACf,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,IAAI,EAAE,GAAG,GAAG,CAAC,WAAW;YAAE,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACvC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAC3C,CAAC;AACJ,CAAC"}

package/dist/mem/search.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Search scoring and text matching over cleaned dialogue.
+ */
+import type { DialogueTurn, SearchHit } from "./types.js";
+/**
+ * Weighted-density relevance score:
+ *   `(3 * userCount + asstCount) / totalTurns`
+ * Higher = the session is more topically concentrated on the query AND the
+ * user themselves brought it up (user hits weighted ×3 — the user's own words
+ * anchor "what they actually cared about"; assistant elaboration is downstream
+ * noise). Normalized by `totalTurns` so a tight short session can outrank a
+ * sprawling long one.
+ */
+export declare function relevanceScore(h: SearchHit): number;
+/** Find the paragraph-aligned chunk surrounding a hit position. A "chunk" is
+ * the contiguous text bounded by the nearest blank-line breaks (`\n\n`) on
+ * either side. If the natural paragraph exceeds `maxChars`, fall back to a
+ * centered char window — and report the truncation so callers can mark it. */
+export declare function chunkAround(text: string, hitIdx: number, maxChars: number): {
+    start: number;
+    end: number;
+    truncated: boolean;
+};
+/**
+ * Multi-token AND grep over cleaned dialogue. Whitespace-split tokens; a turn
+ * matches iff every token (case-insensitive) appears in it. `count` is the
+ * total occurrence count across all tokens within matching turns. Excerpts are
+ * paragraph-aligned chunks around each hit, deduped by chunk start; user-role
+ * chunks are listed before assistant chunks.
+ */
+export declare function searchInDialogue(turns: readonly DialogueTurn[], kw: string, maxExcerpts?: number, chunkChars?: number): SearchHit;
+//# sourceMappingURL=search.d.ts.map

package/dist/mem/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/mem/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAiB,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAGnD;AAED;;;8EAG8E;AAC9E,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAYpD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,EAAE,EAAE,MAAM,EACV,WAAW,SAAI,EACf,UAAU,SAAM,GACf,SAAS,CAqFX"}

package/dist/mem/search.js

@@ -0,0 +1,125 @@
+/**
+ * Search scoring and text matching over cleaned dialogue.
+ */
+/**
+ * Weighted-density relevance score:
+ *   `(3 * userCount + asstCount) / totalTurns`
+ * Higher = the session is more topically concentrated on the query AND the
+ * user themselves brought it up (user hits weighted ×3 — the user's own words
+ * anchor "what they actually cared about"; assistant elaboration is downstream
+ * noise). Normalized by `totalTurns` so a tight short session can outrank a
+ * sprawling long one.
+ */
+export function relevanceScore(h) {
+    if (h.totalTurns === 0)
+        return 0;
+    return (3 * h.userCount + h.asstCount) / h.totalTurns;
+}
+/** Find the paragraph-aligned chunk surrounding a hit position. A "chunk" is
+ * the contiguous text bounded by the nearest blank-line breaks (`\n\n`) on
+ * either side. If the natural paragraph exceeds `maxChars`, fall back to a
+ * centered char window — and report the truncation so callers can mark it. */
+export function chunkAround(text, hitIdx, maxChars) {
+    const startPara = text.lastIndexOf("\n\n", hitIdx);
+    let start = startPara === -1 ? 0 : startPara + 2;
+    const endPara = text.indexOf("\n\n", hitIdx);
+    let end = endPara === -1 ? text.length : endPara;
+    let truncated = false;
+    if (end - start > maxChars) {
+        start = Math.max(0, hitIdx - Math.floor(maxChars / 2));
+        end = Math.min(text.length, hitIdx + Math.ceil(maxChars / 2));
+        truncated = true;
+    }
+    return { start, end, truncated };
+}
+/**
+ * Multi-token AND grep over cleaned dialogue. Whitespace-split tokens; a turn
+ * matches iff every token (case-insensitive) appears in it. `count` is the
+ * total occurrence count across all tokens within matching turns. Excerpts are
+ * paragraph-aligned chunks around each hit, deduped by chunk start; user-role
+ * chunks are listed before assistant chunks.
+ */
+export function searchInDialogue(turns, kw, maxExcerpts = 3, chunkChars = 400) {
+    const tokens = kw.toLowerCase().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0) {
+        return {
+            count: 0,
+            userCount: 0,
+            asstCount: 0,
+            totalTurns: turns.length,
+            excerpts: [],
+        };
+    }
+    let userCount = 0;
+    let asstCount = 0;
+    const userExcerpts = [];
+    const asstExcerpts = [];
+    for (const t of turns) {
+        const hay = t.text.toLowerCase();
+        if (!tokens.every((tok) => hay.includes(tok)))
+            continue;
+        const hitPositions = [];
+        const tokenFreq = new Map();
+        let turnHits = 0;
+        for (const tok of tokens) {
+            let from = 0;
+            let n = 0;
+            while (true) {
+                const idx = hay.indexOf(tok, from);
+                if (idx === -1)
+                    break;
+                n++;
+                turnHits++;
+                hitPositions.push({ idx, tok });
+                from = idx + tok.length;
+            }
+            tokenFreq.set(tok, n);
+        }
+        if (t.role === "user")
+            userCount += turnHits;
+        else
+            asstCount += turnHits;
+        hitPositions.sort((a, b) => a.idx - b.idx);
+        const candidates = [];
+        const seenStarts = new Set();
+        for (const { idx, tok } of hitPositions) {
+            const { start, end, truncated } = chunkAround(t.text, idx, chunkChars);
+            if (seenStarts.has(start))
+                continue;
+            seenStarts.add(start);
+            const slice = hay.slice(start, end);
+            const coverage = tokens.filter((tk) => slice.includes(tk)).length;
+            const rarity = 1 / (tokenFreq.get(tok) ?? 1);
+            candidates.push({ start, end, truncated, coverage, rarity });
+        }
+        candidates.sort((a, b) => {
+            if (b.coverage !== a.coverage)
+                return b.coverage - a.coverage;
+            if (b.rarity !== a.rarity)
+                return b.rarity - a.rarity;
+            return a.start - b.start;
+        });
+        for (const c of candidates) {
+            let snippet = t.text.slice(c.start, c.end).trim();
+            if (c.truncated) {
+                if (c.start > 0)
+                    snippet = "…" + snippet;
+                if (c.end < t.text.length)
+                    snippet += "…";
+            }
+            (t.role === "user" ? userExcerpts : asstExcerpts).push({
+                role: t.role,
+                snippet,
+            });
+        }
+    }
+    const excerpts = [...userExcerpts, ...asstExcerpts].slice(0, maxExcerpts);
+    return {
+        count: userCount + asstCount,
+        userCount,
+        asstCount,
+        totalTurns: turns.length,
+        excerpts,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/mem/search.js.map

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

package/dist/mem/sessions.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Session orchestration: source fan-out, platform dispatch, sub-agent child
+ * merging, session lookup, phase slicing, and the public `listMemSessions`,
+ * `searchMemSessions`, and `extractMemDialogue` entry points.
+ */
+import type { DialogueTurn, ExtractMemDialogueOptions, ListMemSessionsOptions, MemExtractResult, MemFilter, MemSearchResult, MemSessionInfo, SearchMemSessionsOptions } from "./types.js";
+/** Internal wide limit — `limit` only caps display; search recall and session
+ * lookup must scan everything. */
+export declare const WIDE_LIMIT = 1000000;
+/** Thrown by `readMemContext` / `extractMemDialogue` when the requested
+ * session id cannot be resolved. */
+export declare class MemSessionNotFoundError extends Error {
+    readonly sessionId: string;
+    constructor(sessionId: string);
+}
+/** Fill platform / limit defaults so internal helpers see a complete filter. */
+export declare function resolveFilter(filter?: MemFilter): MemFilter;
+/** Fan out to every in-scope platform, merge by recency, cap at `f.limit`. */
+export declare function listAll(f: MemFilter): MemSessionInfo[];
+declare function extractDialogue(s: MemSessionInfo): DialogueTurn[];
+/** Build a parent → descendants index (transitively flattened) for OpenCode
+ * sub-agent chains. Other platforms have no native `parent_id`. */
+declare function buildChildIndex(sessions: readonly MemSessionInfo[]): Map<string, MemSessionInfo[]>;
+/** Resolve a session by exact id or id prefix, scanning every project. */
+export declare function findSessionById(id: string, f: MemFilter): MemSessionInfo | undefined;
+/** List session metadata across Claude / Codex / OpenCode / Pi, sorted by
+ * recency and capped at the filter's `limit` (default 50). */
+export declare function listMemSessions(options?: ListMemSessionsOptions): MemSessionInfo[];
+/** Multi-token AND grep over cleaned dialogue across all matching sessions,
+ * ranked by weighted-density relevance. `matches` is capped at the filter's
+ * `limit`; `totalMatches` is the full match count. */
+export declare function searchMemSessions(options: SearchMemSessionsOptions): MemSearchResult;
+/** Dump cleaned dialogue for one session, optionally sliced by brainstorm
+ * phase and filtered by a multi-token AND `grep`. */
+export declare function extractMemDialogue(options: ExtractMemDialogueOptions): MemExtractResult;
+export { extractDialogue, buildChildIndex };
+//# sourceMappingURL=sessions.d.ts.map