@fractalsynapse/dsh-chapters 0.0.0-stage → 0.2.21

package/lib/save-core.js

@@ -0,0 +1,220 @@
+/**
+ * saveSession — the archive-only pipeline, ONE implementation (issue #47).
+ *
+ * Extracted verbatim from the `/chapters-save` command body so door 3 (the human
+ * command) and door 5 (subagent settlement) cannot drift: same watermark, same
+ * composition, same render + write + commit. Policy stays OUTSIDE this function —
+ * what to say to the human, whether to run enrichment now or queue it, whether to
+ * schedule a sync — because those differ per door by design; the ARCHIVE does not.
+ *
+ * Rules this honors (AGENTS.md): never trusts ranges it did not derive, anchors
+ * ONLY on `turn/end` (an interrupted tail is skipped, never half-archived), writes
+ * append-only with read-back verification, and stamps lineage from the durable
+ * header only (`RenderConfig.subagentOf` via `lineageOf`).
+ */
+import { composeChapters } from "./compose.js";
+import { deriveRanges } from "./continue-core.js";
+import { estimateTokens, oversizeRanges, renderChapter } from "./render.js";
+import { chapterTopics } from "./signature.js";
+import { makeArchiveFs, commitChapters } from "./store.js";
+import { releaseReservation, reserve, reservePlan as reservePlanNumber } from "./registry.js";
+/** One serialized read-allocate-write for a door that cannot use makeAllocator (same rule, #59). */
+async function reserveNumbers(store, sessionId, attemptId, count, plan = false) {
+    let numbers = [];
+    await store.mutate(sessionId, (state) => {
+        const r = plan ? reservePlanNumber(state, attemptId, count) : reserve(state, attemptId, count);
+        numbers = r.numbers;
+        return r.state;
+    });
+    return { numbers };
+}
+import { writeArchive, attemptKey } from "./archive.js";
+import { supersedeChapter } from "./repair.js";
+/**
+ * Split a range whose RENDERED size would blow past the oversize ceiling (#60, repair path only).
+ *
+ * The normal doors cut on `turn/end` and warn when a chapter is over `chapterTokenTarget`, because a
+ * boundary is around the corner and clipping is forbidden. A REPAIR span can be one gigantic turn — a
+ * delegated subagent whose single turn ran to 4 MB — where there IS no next boundary, and refusing it
+ * (the #59c gate) would leave the husk superseded-by-nothing. So the repair splits at EVENT boundaries
+ * inside the turn: nothing is truncated, every byte still lands in a chapter, and the TOC gains several
+ * consecutive ranges instead of one unreadable one. The rule that binds is completeness, not "one chapter
+ * per turn" — and a chapter nobody can `read` back is not an archive.
+ */
+function splitOversize(chapters, events, chapterTokenTarget, oversizeFactor) {
+    const ceiling = Math.floor(chapterTokenTarget * oversizeFactor);
+    const notes = [];
+    const out = [];
+    for (const c of chapters) {
+        const inRange = events.filter((e) => e.seq >= c.startSeq && e.seq <= c.endSeq);
+        const total = inRange.reduce((m, e) => m + estimateTokens(JSON.stringify(e.data ?? {})), 0);
+        if (total <= ceiling) {
+            out.push(c);
+            continue;
+        }
+        const parts = Math.ceil(total / ceiling);
+        const perPart = Math.ceil(inRange.length / parts);
+        let title = c.title;
+        for (let i = 0, n = 0; i < inRange.length; i += perPart, n++) {
+            const from = inRange[i].seq;
+            const to = inRange[Math.min(i + perPart, inRange.length) - 1].seq;
+            out.push({ ...c, title: n === 0 ? title : `${title} (part ${n + 1})`, startSeq: from, endSeq: to });
+        }
+        notes.push(`"${c.title}" (seqs ${c.startSeq}-${c.endSeq}) is ${total} est tokens in a single unfinished turn — split into ${parts} chapters at event boundaries (repair path; nothing truncated)`);
+    }
+    return { ranges: out, notes };
+}
+/**
+ * Force a repaired archive to cover exactly the span the finding named (#60). Composition may still cut
+ * it into topics - a cut is a chapter boundary, not a loss - but nothing may start above `fromSeq` or
+ * stop before the last completed turn inside the span, or the hole the finding reported stays open while
+ * the repair reports success.
+ */
+function clampSpan(chapters, fromSeq, toSeq, events) {
+    // Nothing to clamp: the span held no completed turn at all. Returning EMPTY is the honest answer —
+    // inventing a title here would fabricate a chapter, and an empty `records` makes the caller skip the
+    // supersede, which is exactly right: a record is never marked superseded without its replacement (#60).
+    if (chapters.length === 0)
+        return [];
+    const lastCompleted = events.reduce((m, e) => (e.type === 'turn/end' && e.seq <= toSeq && e.seq > m ? e.seq : m), fromSeq);
+    return chapters.map((c, i) => ({
+        ...c,
+        startSeq: i === 0 ? Math.min(c.startSeq, fromSeq) : Math.max(c.startSeq, chapters[i - 1].endSeq + 1),
+        endSeq: i === chapters.length - 1 ? lastCompleted : Math.min(c.endSeq, lastCompleted),
+    }));
+}
+export async function saveSession(a) {
+    const { events, sessionId, cwd, store, config } = a;
+    if (cwd === '')
+        throw new Error('saveSession: session has no workspace cwd — nowhere reachable to write');
+    if (sessionId === '')
+        throw new Error('saveSession: no session id to own the archive');
+    // A repair targets a span it chose; every other door archives the watermark tail up to the last
+    // completed turn. One pipeline, one difference (#60).
+    const anchor = a.span !== undefined ? a.span.toSeq : [...events].reverse().find((e) => e.type === 'turn/end')?.seq;
+    if (anchor === undefined) {
+        return { skipped: 'no-completed-turn', fromSeq: 0, anchor: -1, lastArchived: 0, priorChapters: 0, records: [], warnings: [] };
+    }
+    // Watermark: only archive what is newer than the last saved chapter.
+    const state = await store.get(sessionId);
+    const lastArchived = state.chapters.reduce((m, c) => Math.max(m, c.endSeq), 0);
+    const fromSeq = a.span !== undefined ? a.span.fromSeq : (lastArchived > 0 ? lastArchived + 1 : 0);
+    // A REPAIR span is deliberate re-derivation of seqs the watermark has already passed (#60): the
+    // nothing-new guard is about not re-archiving a tail, and would otherwise refuse to fix the hole a
+    // hollow chapter sits exactly on top of. The span caller has already decided what needs re-rendering.
+    if (a.span === undefined && fromSeq > 0 && anchor <= lastArchived) {
+        return { skipped: 'nothing-new', fromSeq, anchor, lastArchived, priorChapters: state.chapters.length, records: [], warnings: [] };
+    }
+    // Topic-sequential composition — same pipeline as fork/continue.
+    const composed = composeChapters(events, fromSeq, anchor, state.collections, {
+        mergeThreshold: config.mergeThreshold,
+        chapterLimit: config.chapterLimit,
+    });
+    let chapters = composed.chapters.length > 0
+        ? composed.chapters
+        : deriveRanges(events, anchor, config.chapterTokenTarget, fromSeq).chapters;
+    const repairNotes = [];
+    if (a.span !== undefined) {
+        // A repair's span is bounded by the finding, so force exactly that range: composition inside a hole
+        // may cut it into topics, and a cut is fine, but nothing may start above `fromSeq` or end below the
+        // last completed turn inside the span.
+        chapters = clampSpan(chapters, a.span.fromSeq, a.span.toSeq, events);
+        // A repair span may be one enormous turn; the oversize gate would refuse it and leave the husk
+        // un-replaced. Split inside it at event boundaries — see `splitOversize`.
+        const split = splitOversize(chapters, events, config.chapterTokenTarget, config.chapterOversizeFactor ?? 2);
+        chapters = split.ranges;
+        repairNotes.push(...split.notes);
+    }
+    // Render + write archive (same as runContinue steps 2-3, minus child creation).
+    const below = events.filter((e) => e.seq <= anchor);
+    const renderConfig = {
+        toolResultDeferFloorTokens: config.toolResultDeferFloorTokens,
+        chapterTokenTarget: config.chapterTokenTarget,
+        ...(config.planInlineChars !== undefined ? { planInlineChars: config.planInlineChars } : {}),
+        ...(config.callArgArtifactTokens !== undefined ? { callArgArtifactTokens: config.callArgArtifactTokens } : {}),
+        ...(a.subagentOf !== undefined && a.subagentOf !== '' ? { subagentOf: a.subagentOf } : {}),
+    };
+    const rendered = chapters.map((range) => renderChapter(below, range, renderConfig, [], chapterTopics(below, range.startSeq, range.endSeq)));
+    // #58 — NEVER commit an archive that rendered nothing. A `tool/call` is always preceded by an
+    // `assistant/message`, so a non-empty range with zero rendered messages is not a short
+    // conversation: it is a read that carried no payloads. The real instance was
+    // `sessionQuery.listEvents`, whose `SessionEventRecord` rows have `seq`/`type`/`time`/`surface`
+    // and no `data` — 12 children on this machine archived as `**unknown**` / `{}` / `0 B` shells.
+    // The refusal is BEFORE `writeArchive`, so no number is reserved and no file is written: a
+    // committed husk would poison the watermark (`max(endSeq)`), and the child could then never be
+    // re-archived without a repair (#60). Refuse with numbers, never truncate — AGENTS.md.
+    //
+    // AMENDED #60: the test is on the ARCHIVE, not on each chapter. A repair may split one enormous turn
+    // into consecutive parts, and a part holding only tool calls legitimately renders zero messages —
+    // refusing the whole re-read over that stranded five SAIP children's knowledge again, which is the
+    // opposite of what the gate protects. "No payloads anywhere" is the anomaly; `describeHollow` keeps
+    // naming every message-free part so it is never silent, and the single-chapter case (#58's instance)
+    // still refuses exactly as before.
+    const describeHollow = (r) => {
+        const un = r.stats.unrenderedSeqs;
+        return `"${r.range.title}" spans seqs ${r.range.startSeq}..${r.range.endSeq}: ${r.stats.events} events, `
+            + `${r.stats.toolCalls} tool calls, 0 rendered messages, ${un.length} unrendered`
+            + `${un.length > 0 ? ` (first: ${un.slice(0, 5).join(', ')})` : ''}`;
+    };
+    const hollow = rendered.filter((r) => r.stats.events > 0 && r.stats.messages === 0);
+    if (rendered.length > 0 && hollow.length === rendered.length) {
+        return {
+            skipped: 'payloadless',
+            fromSeq,
+            anchor,
+            lastArchived,
+            priorChapters: state.chapters.length,
+            records: [],
+            warnings: hollow.map((r) => `${describeHollow(r)} — the read carried event SHAPES but no payloads; nothing was reserved or written`),
+        };
+    }
+    // Parts that carry tool calls but no prose are reported and STILL archived (#60): "what was
+    // attempted" is half the record, and silence about it is the defect class this issue is named for.
+    const hollowNotes = hollow.map((r) => `${describeHollow(r)} — archived for its tool calls, not a payload failure`);
+    // #59: refuse before reserving anything, exactly like the payloadless gate — a spent number with no
+    // file behind it is the burned-reservation state this whole round is eliminating. The factor is
+    // config, never a literal: over `chapterTokenTarget` warns, over `target × factor` refuses.
+    const oversize = oversizeRanges(rendered, config.chapterTokenTarget, config.chapterOversizeFactor ?? 2);
+    if (oversize.errors.length > 0) {
+        return {
+            skipped: 'oversize', fromSeq, anchor, lastArchived,
+            priorChapters: state.chapters.length, records: [], warnings: oversize.errors,
+        };
+    }
+    const wrote = await writeArchive({
+        fs: makeArchiveFs(cwd),
+        allocator: {
+            // One section per allocation (#59) — identical semantics to makeAllocator, which is why the
+            // shared helper is used by every other door; this door had its own copy of the race.
+            async reserve(attemptId, count) {
+                const { numbers } = await reserveNumbers(store, sessionId, attemptId, count);
+                return numbers;
+            },
+            async reservePlan(attemptId, count) {
+                const { numbers } = await reserveNumbers(store, sessionId, attemptId, count, true);
+                return numbers;
+            },
+            async release(attemptId) {
+                await store.mutate(sessionId, (state) => releaseReservation(state, attemptId));
+            },
+        },
+        // raw value: makeArchiveFs roots RELATIVE paths at the session cwd and
+        // passes absolute ones through — resolving here would double-root relative stores
+        storeRoot: config.artifactStoreRoot,
+        cwd, // #69: records are stored workspace-relative
+        rootSessionId: state.rootSession,
+        chapters: rendered,
+        attemptId: attemptKey(sessionId, anchor, a.attemptSalt),
+    });
+    // Commit chapter records to session state so search index picks them up.
+    if (a.supersede !== undefined && wrote.records.length > 0) {
+        // Commit AND mark in one section: no reader can ever see the replacement without the old record
+        // marked, or the mark without its replacement (#60).
+        await store.mutate(sessionId, (fresh) => supersedeChapter(fresh, a.supersede.over, wrote.records, a.supersede.reason));
+    }
+    else {
+        await commitChapters(store, sessionId, wrote.records);
+    }
+    return { skipped: null, fromSeq, anchor, lastArchived, priorChapters: state.chapters.length, records: wrote.records, warnings: [...repairNotes, ...hollowNotes, ...oversize.indivisible, ...wrote.warnings] };
+}
+//# sourceMappingURL=save-core.js.map

package/lib/save-core.js.map

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

package/lib/search.d.ts

@@ -0,0 +1,112 @@
+import { type IndexEntry } from './indexing.ts';
+export interface SearchResult {
+    score: number;
+    date: string;
+    kind: 'chapter' | 'rule' | 'plan';
+    title: string;
+    path: string;
+    /** S5 stitch view: every member file behind a coherented entry. */
+    paths?: string[];
+    topics: string[];
+}
+export interface SearchOutcome {
+    results: SearchResult[];
+    /** Every match found (results may be a packed prefix of this). */
+    total: number;
+    shown: number;
+    budget: {
+        requested: number;
+        used: number;
+        remaining: number;
+    };
+    line: string;
+}
+/** Term-hit score: topic hits 2x, title 1x, summary 1x. Zero = no match, full stop. */
+export declare function baseScore(entry: IndexEntry, terms: readonly string[], summary: string): number;
+/**
+ * The full score: term hits plus a recency tie-break. Recency ONLY breaks
+ * ties between real matches — a fresh mtime must never rank an entry that
+ * matches no term (that would surface unrelated fresh files on any query).
+ */
+export declare function scoreEntry(entry: IndexEntry, terms: readonly string[], now: number, summary: string): number;
+/**
+ * CodeGraph symbol boost: when a search query contains tokens matching
+ * symbols stored in a chapter's frontmatter, add a bounded bonus. This
+ * breaks ties toward structurally-relevant chapters without ever ranking
+ * a non-matching entry above a matching one.
+ *
+ * @param bonusPerMatch — per-symbol bonus (default 0.2, capped at 1.0 total)
+ */
+export declare function codegraphBoost(entry: IndexEntry, terms: readonly string[], bonusPerMatch?: number): number;
+/** Load the corpus from a clone directory: chapters + rules, frontmatter-parsed. */
+export declare function loadCorpus(cloneDir: string): {
+    entries: IndexEntry[];
+    summaries: Map<string, string>;
+};
+/**
+ * The search itself: score, sort (score desc, then path for determinism),
+ * format lines `score | date | kind | title | path (topics: …)`, and pack
+ * lines to the requested token budget. The agent sees `total` vs `shown` so
+ * it can re-request with a larger budget — no silent truncation.
+ */
+export declare function searchKnowledge(cloneDir: string, query: string, maxTokens: number, opts?: {
+    now?: number;
+    projectKey?: string;
+    harnessId?: string;
+    rulesCoreBonus?: number;
+}): SearchOutcome;
+/**
+ * The ranking and packing shared by BOTH corpora — the pool mirror and the local
+ * store. Kept as one function on purpose: two scorers is how a "works in the pool,
+ * empty at home" divergence would be born, and the only difference between the two
+ * doors is where the entries came from.
+ */
+export declare function rankEntries(entries: IndexEntry[], summaries: Map<string, string>, terms: string[], now: number, coreRuleIds: Set<string> | null, rulesCoreBonus: number, maxTokens: number): {
+    results: SearchResult[];
+    total: number;
+    shown: number;
+    budget: {
+        requested: number;
+        used: number;
+        remaining: number;
+    };
+    line: string;
+};
+/**
+ * The SAME corpus read straight off the workspace store, for the case that matters
+ * most and was previously unanswered: a project with NO pool linked. Every chapter,
+ * every `kind: plan` document and every rule already exists under the store root —
+ * indexed by nothing but their own frontmatter — and until now `chapters_search`
+ * returned an empty list there, so a session that asked "what did we plan about X"
+ * was told to go link a remote instead of being told the truth it already had.
+ *
+ * Paths come back relative to the workspace (`<storeRoot>/<session>/chapters/…`), so
+ * a result opens with the `read` tool with no translation, which is the whole point
+ * of a citation. Scope is stated by the caller, not assumed: this is this machine's
+ * store, not the shared pool, and the result note says so.
+ */
+export declare function buildLocalCorpus(storeRoot: string): {
+    entries: IndexEntry[];
+    summaries: Map<string, string>;
+};
+/**
+ * Search THIS machine's store (no pool required). Returns the same shape as
+ * `searchKnowledge`, plus `empty` so the caller can tell "nothing matched" apart
+ * from "nothing to match against" — those two feel identical to a session and are
+ * completely different facts about the workspace.
+ */
+export declare function searchLocalStore(storeRoot: string, query: string, maxTokens: number, opts?: {
+    rulesCoreBonus?: number;
+}): {
+    results: SearchResult[];
+    total: number;
+    shown: number;
+    budget: {
+        requested: number;
+        used: number;
+        remaining: number;
+    };
+    line: string;
+    documents: number;
+    empty: boolean;
+};

package/lib/search.js

@@ -0,0 +1,282 @@
+/**
+ * Knowledge search (knowledge-repo.md §8): a DETERMINISTIC scorer over the
+ * mirrored corpus (the clone is the corpus — it holds local + pulled files),
+ * packed to a token budget the AGENT chooses (it knows its window; we
+ * measure with the project's one estimator). No model in the loop, ever —
+ * reproducible, inspectable, and free.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { entryFromChapter } from "./indexing.js";
+function entryBody(text) {
+    const i = text.indexOf('\n---\n');
+    return i === -1 ? '' : text.slice(i + 5).trim();
+}
+import { estimateTokens } from "./render.js";
+import { collectMirrorRules } from "./rules.js";
+import { stitchFragments } from "./indexing.js";
+const DAY = 24 * 60 * 60 * 1000;
+const tokenize = (text) => text.toLowerCase().split(/[^a-z0-9/._-]+/).filter((t) => t.length >= 2 && t !== 'the' && t !== 'and');
+const recencyBonus = (mtime, now) => {
+    if (mtime === undefined)
+        return 0;
+    const ageDays = (now - mtime) / DAY;
+    if (ageDays <= 30)
+        return 1;
+    if (ageDays <= 180)
+        return 0.5;
+    return 0;
+};
+/** Term-hit score: topic hits 2x, title 1x, summary 1x. Zero = no match, full stop. */
+export function baseScore(entry, terms, summary) {
+    let score = 0;
+    for (const t of terms) {
+        if (entry.topics.some((topic) => topic.toLowerCase().includes(t)))
+            score += 2;
+        if (entry.category !== undefined && entry.category.toLowerCase().includes(t))
+            score += 1.5;
+        if (entry.title.toLowerCase().includes(t))
+            score += 1;
+        if (summary.toLowerCase().includes(t))
+            score += 1;
+    }
+    return score;
+}
+/**
+ * The full score: term hits plus a recency tie-break. Recency ONLY breaks
+ * ties between real matches — a fresh mtime must never rank an entry that
+ * matches no term (that would surface unrelated fresh files on any query).
+ */
+export function scoreEntry(entry, terms, now, summary) {
+    const base = baseScore(entry, terms, summary);
+    return base === 0 ? 0 : base + recencyBonus(entry.mtime, now);
+}
+/**
+ * CodeGraph symbol boost: when a search query contains tokens matching
+ * symbols stored in a chapter's frontmatter, add a bounded bonus. This
+ * breaks ties toward structurally-relevant chapters without ever ranking
+ * a non-matching entry above a matching one.
+ *
+ * @param bonusPerMatch — per-symbol bonus (default 0.2, capped at 1.0 total)
+ */
+export function codegraphBoost(entry, terms, bonusPerMatch = 0.2) {
+    if (entry.codegraphSymbols === undefined || entry.codegraphSymbols.length === 0)
+        return 0;
+    if (terms.length === 0)
+        return 0;
+    let matched = 0;
+    for (const t of terms) {
+        for (const sym of entry.codegraphSymbols) {
+            // Case-insensitive substring match: query term "auth" matches symbol "authenticate".
+            if (sym.toLowerCase().includes(t) || t.includes(sym.toLowerCase())) {
+                matched++;
+                break; // one match per term
+            }
+        }
+    }
+    return Math.min(matched * bonusPerMatch, 1.0);
+}
+/** Load the corpus from a clone directory: chapters + rules, frontmatter-parsed. */
+export function loadCorpus(cloneDir) {
+    const entries = [];
+    const summaries = new Map();
+    // rel paths mirror the REPO layout (chapters/<key>/…, rules/<key>/…) so
+    // search results are directly readable paths and project scoping is a
+    // prefix match on the second path segment.
+    const collect = (top, kind) => {
+        const root = path.join(cloneDir, top);
+        if (!fs.existsSync(root))
+            return;
+        const walk = (dir, rel) => {
+            for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+                const p = path.join(dir, e.name);
+                if (e.isDirectory()) {
+                    walk(p, rel === '' ? e.name : path.join(rel, e.name));
+                    continue;
+                }
+                if (e.name.endsWith('.md')) {
+                    const relPath = rel === '' ? e.name : path.join(rel, e.name);
+                    const text = fs.readFileSync(p, 'utf8');
+                    const entry = entryFromChapter(path.join(top, relPath), text, fs.statSync(p).mtimeMs);
+                    // A plan document declares its own kind in frontmatter and lives in the
+                    // chapters/ tree — the directory must not flatten it back to 'chapter',
+                    // or "search the plans" would be impossible (plans-carriage § 11).
+                    entries.push({ ...entry, kind: entry.kind === 'plan' ? 'plan' : kind });
+                    const fm = /^---[\s\S]*?summary:\s*(.*)$/m.exec(text);
+                    if (fm !== null)
+                        summaries.set(entry.path, fm[1].trim().replace(/^"|"$/g, ''));
+                    // P3: rules carry no summary field — their BODY is the scannable
+                    // surface; score terms against it like a chapter's summary
+                    else if (entry.kind === 'rule')
+                        summaries.set(entry.path, entryBody(text).slice(0, 500));
+                }
+            }
+        };
+        walk(root, '');
+    };
+    collect('chapters', 'chapter');
+    collect('rules', 'rule');
+    return { entries: stitchFragments(entries), summaries }; // S5: search sees stitched views too
+}
+/**
+ * The search itself: score, sort (score desc, then path for determinism),
+ * format lines `score | date | kind | title | path (topics: …)`, and pack
+ * lines to the requested token budget. The agent sees `total` vs `shown` so
+ * it can re-request with a larger budget — no silent truncation.
+ */
+export function searchKnowledge(cloneDir, query, maxTokens, opts = {}) {
+    const now = opts.now ?? Date.now();
+    const terms = tokenize(query);
+    // P3 §8: rules that THIS machine approved get a small, explicit bonus —
+    // computed here (per-machine), never baked into the shared index shards.
+    let coreRuleIds = null;
+    if (opts.harnessId !== undefined && opts.rulesCoreBonus !== undefined && opts.rulesCoreBonus > 0) {
+        try {
+            coreRuleIds = new Set(collectMirrorRules(cloneDir, opts.projectKey ?? '', opts.harnessId)
+                .filter((r) => r.status === 'core').map((r) => r.relPath));
+        }
+        catch {
+            coreRuleIds = null;
+        }
+    }
+    if (terms.length === 0) {
+        return { results: [], total: 0, shown: 0, budget: { requested: maxTokens, used: 0, remaining: maxTokens }, line: '' };
+    }
+    const { entries, summaries } = loadCorpus(cloneDir);
+    const scoped = opts.projectKey !== undefined
+        ? entries.filter((e) => e.path.startsWith(`chapters/${opts.projectKey}`) || e.path.startsWith(`rules/${opts.projectKey}`))
+        : entries;
+    return rankEntries(scoped, summaries, terms, now, coreRuleIds, opts.rulesCoreBonus ?? 0, maxTokens);
+}
+/**
+ * The ranking and packing shared by BOTH corpora — the pool mirror and the local
+ * store. Kept as one function on purpose: two scorers is how a "works in the pool,
+ * empty at home" divergence would be born, and the only difference between the two
+ * doors is where the entries came from.
+ */
+export function rankEntries(entries, summaries, terms, now, coreRuleIds, rulesCoreBonus, maxTokens) {
+    const scored = entries
+        .map((e) => ({
+        e,
+        score: scoreEntry(e, terms, now, summaries.get(e.path) ?? '')
+            + (coreRuleIds !== null && e.kind === 'rule' && coreRuleIds.has(e.path) ? rulesCoreBonus : 0)
+            + codegraphBoost(e, terms),
+    }))
+        .filter((x) => x.score > 0)
+        .sort((a, b) => b.score - a.score || (a.e.path < b.e.path ? -1 : 1));
+    const results = scored.map((x) => ({
+        score: Number(x.score.toFixed(2)),
+        date: x.e.mtime !== undefined ? new Date(x.e.mtime).toISOString().slice(0, 10) : '----',
+        kind: x.e.kind,
+        title: x.e.title,
+        path: x.e.path,
+        ...(x.e.paths !== undefined ? { paths: x.e.paths } : {}),
+        topics: x.e.topics,
+    }));
+    const lines = [];
+    let used = 0;
+    for (const r of results) {
+        const line = `${r.score.toFixed(2)} | ${r.date} | ${r.kind} | ${r.title} | ${r.path}${r.paths !== undefined && r.paths.length > 1 ? ` [+${r.paths.length - 1} stitched part(s)]` : ''}${r.topics.length > 0 ? ` (topics: ${r.topics.join(', ')})` : ''}`;
+        const cost = estimateTokens(line);
+        if (lines.length > 0 && used + cost > maxTokens)
+            break;
+        lines.push(line);
+        used += cost;
+    }
+    return {
+        results: results.slice(0, lines.length),
+        total: results.length,
+        shown: lines.length,
+        budget: { requested: maxTokens, used, remaining: Math.max(0, maxTokens - used) },
+        line: lines.join('\n'),
+    };
+}
+/**
+ * The SAME corpus read straight off the workspace store, for the case that matters
+ * most and was previously unanswered: a project with NO pool linked. Every chapter,
+ * every `kind: plan` document and every rule already exists under the store root —
+ * indexed by nothing but their own frontmatter — and until now `chapters_search`
+ * returned an empty list there, so a session that asked "what did we plan about X"
+ * was told to go link a remote instead of being told the truth it already had.
+ *
+ * Paths come back relative to the workspace (`<storeRoot>/<session>/chapters/…`), so
+ * a result opens with the `read` tool with no translation, which is the whole point
+ * of a citation. Scope is stated by the caller, not assumed: this is this machine's
+ * store, not the shared pool, and the result note says so.
+ */
+export function buildLocalCorpus(storeRoot) {
+    const entries = [];
+    const summaries = new Map();
+    if (!fs.existsSync(storeRoot))
+        return { entries, summaries };
+    const addFile = (abs, rel) => {
+        let text;
+        try {
+            text = fs.readFileSync(abs, 'utf8');
+        }
+        catch {
+            return;
+        }
+        const entry = entryFromChapter(rel, text, fs.statSync(abs).mtimeMs);
+        entries.push(entry);
+        const fm = /^---[\s\S]*?summary:\s*(.*)$/m.exec(text);
+        if (fm !== null)
+            summaries.set(entry.path, fm[1].trim().replace(/^"|"$/g, ''));
+        else if (entry.kind !== 'chapter')
+            summaries.set(entry.path, entryBody(text).slice(0, 500));
+    };
+    const walk = (dir, rel, leaf) => {
+        let items;
+        try {
+            items = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of items) {
+            const abs = path.join(dir, e.name);
+            const r = rel === '' ? e.name : `${rel}/${e.name}`;
+            if (e.isDirectory()) {
+                walk(abs, r, leaf);
+                continue;
+            }
+            if (e.name.endsWith('.md'))
+                addFile(abs, path.posix.join(leaf, r));
+        }
+    };
+    for (const top of fs.readdirSync(storeRoot, { withFileTypes: true })) {
+        if (!top.isDirectory())
+            continue;
+        if (top.name === 'artifacts')
+            continue; // blobs are queried by chapters_artifact, not indexed twice
+        const abs = path.join(storeRoot, top.name);
+        if (top.name === 'rules') {
+            walk(abs, '', 'rules');
+            continue;
+        }
+        // a session tree: chapters/ holds transcript chapters AND plan documents
+        const chapters = path.join(abs, 'chapters');
+        if (fs.existsSync(chapters))
+            walk(chapters, '', path.posix.join(top.name, 'chapters'));
+        const rules = path.join(abs, 'rules');
+        if (fs.existsSync(rules))
+            walk(rules, '', path.posix.join(top.name, 'rules'));
+    }
+    return { entries, summaries };
+}
+/**
+ * Search THIS machine's store (no pool required). Returns the same shape as
+ * `searchKnowledge`, plus `empty` so the caller can tell "nothing matched" apart
+ * from "nothing to match against" — those two feel identical to a session and are
+ * completely different facts about the workspace.
+ */
+export function searchLocalStore(storeRoot, query, maxTokens, opts = {}) {
+    const { entries, summaries } = buildLocalCorpus(storeRoot);
+    const terms = tokenize(query);
+    if (terms.length === 0) {
+        return { results: [], total: 0, shown: 0, budget: { requested: maxTokens, used: 0, remaining: maxTokens }, line: '', documents: entries.length, empty: entries.length === 0 };
+    }
+    const ranked = rankEntries(entries, summaries, terms, Date.now(), null, opts.rulesCoreBonus ?? 0, maxTokens);
+    return { ...ranked, documents: entries.length, empty: entries.length === 0 };
+}
+//# sourceMappingURL=search.js.map

package/lib/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAmB,MAAM,eAAe,CAAA;AACjE,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACjC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACjD,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAsB/C,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAE/B,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAY,EAAE,CAC1C,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,CAAC,CAAA;AAEvG,MAAM,YAAY,GAAG,CAAC,KAAyB,EAAE,GAAW,EAAU,EAAE;IACtE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAA;IACjC,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;IACnC,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,CAAC,CAAA;IAC3B,IAAI,OAAO,IAAI,GAAG;QAAE,OAAO,GAAG,CAAA;IAC9B,OAAO,CAAC,CAAA;AACV,CAAC,CAAA;AAED,uFAAuF;AACvF,MAAM,UAAU,SAAS,CAAC,KAAiB,EAAE,KAAwB,EAAE,OAAe;IACpF,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAA;QAC7E,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,GAAG,CAAA;QAC1F,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAA;QACrD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB,EAAE,KAAwB,EAAE,GAAW,EAAE,OAAe;IAClG,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAC7C,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,KAAwB,EAAE,aAAa,GAAG,GAAG;IAC7F,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACzF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAChC,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YACzC,qFAAqF;YACrF,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACnE,OAAO,EAAE,CAAA;gBACT,MAAK,CAAC,qBAAqB;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,aAAa,EAAE,GAAG,CAAC,CAAA;AAC/C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,OAAO,GAAiB,EAAE,CAAA;IAChC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC3C,wEAAwE;IACxE,sEAAsE;IACtE,2CAA2C;IAC3C,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,IAAwB,EAAE,EAAE;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;QACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAM;QAChC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE;YACxC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;gBAChC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBAAC,IAAI,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBAAC,SAAQ;gBAAC,CAAC;gBACxF,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3B,MAAM,OAAO,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;oBAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;oBACvC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;oBACrF,wEAAwE;oBACxE,wEAAwE;oBACxE,mEAAmE;oBACnE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;oBACvE,MAAM,EAAE,GAAG,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACrD,IAAI,EAAE,KAAK,IAAI;wBAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;oBAC/E,iEAAiE;oBACjE,2DAA2D;yBACtD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;wBAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;gBAC1F,CAAC;YACH,CAAC;QACH,CAAC,CAAA;QACD,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAChB,CAAC,CAAA;IACD,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IAC9B,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACxB,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA,CAAC,qCAAqC;AAC/F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,KAAa,EACb,SAAiB,EACjB,OAA2F,EAAE;IAE7F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7B,wEAAwE;IACxE,yEAAyE;IACzE,IAAI,WAAW,GAAuB,IAAI,CAAA;IAC1C,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QACjG,IAAI,CAAC;YACH,WAAW,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC;iBACtF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;QAC9D,CAAC;QAAC,MAAM,CAAC;YAAC,WAAW,GAAG,IAAI,CAAA;QAAC,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;IACvH,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,KAAK,SAAS;QAC1C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1H,CAAC,CAAC,OAAO,CAAA;IACX,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,SAAS,CAAC,CAAA;AACrG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,OAAqB,EACrB,SAA8B,EAC9B,KAAe,EACf,GAAW,EACX,WAA+B,EAC/B,cAAsB,EACtB,SAAiB;IAEjB,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,CAAC;QACD,KAAK,EAAE,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;cACzD,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;cAC3F,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC;KAC7B,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtE,MAAM,OAAO,GAAmB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM;QACvF,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QACd,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK;QAChB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QACd,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM;KACnB,CAAC,CAAC,CAAA;IACH,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;QACxP,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,GAAG,SAAS;YAAE,MAAK;QACtD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,IAAI,IAAI,IAAI,CAAA;IACd,CAAC;IACD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC;QACvC,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,EAAE;QAChF,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;KACvB,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,OAAO,GAAiB,EAAE,CAAA;IAChC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IAC5D,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,GAAW,EAAQ,EAAE;QACjD,IAAI,IAAY,CAAA;QAChB,IAAI,CAAC;YAAC,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAM;QAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;QACnE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,MAAM,EAAE,GAAG,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,IAAI,EAAE,KAAK,IAAI;YAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;aAC1E,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAC7F,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,IAAY,EAAQ,EAAE;QAC5D,IAAI,KAAkB,CAAA;QACtB,IAAI,CAAC;YAAC,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAM;QAAC,CAAC;QAC7E,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;YAClC,MAAM,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;YAClD,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;gBAAC,SAAQ;YAAC,CAAC;YACrD,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACpE,CAAC;IACH,CAAC,CAAA;IACD,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE;YAAE,SAAQ;QAChC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;YAAE,SAAQ,CAAC,4DAA4D;QACnG,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1C,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;QAC9D,yEAAyE;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAA;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACrC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,KAAa,EACb,SAAiB,EACjB,OAAoC,EAAE;IAEtC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;IAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAA;IAC/K,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,SAAS,CAAC,CAAA;IAC5G,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAA;AAC9E,CAAC"}