@nanonets/graft 0.24.1 → 0.25.0

package/dist/init/claude-call.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The Claude Code to run: `claude` on PATH, else a standalone install's copy,
+ * else the newest copy the VS Code, Cursor, VS Code Insiders or Windsurf
+ * extension keeps. Someone who only uses the extension has no `claude` on
+ * PATH, and without this their past sessions are never read. Null when
+ * there's none.
+ */
+export declare function claudeBin(home?: string, onPath?: () => boolean): string | null;
+/** Whether there's a Claude Code to run, on PATH or not. */
+export declare function hasClaude(home?: string): boolean;
+/** Why Claude Code gave no answer. */
+export type ClaudeFailure = "not_signed_in" | "not_installed" | "timed_out" | "refused" | "failed";
+/** What one call came back with: the findings, or why there are none (with Claude Code's own short words, when it said any). */
+export type ClaudeAnswer<T> = {
+    ok: true;
+    findings: T[];
+    costUsd?: number;
+} | {
+    ok: false;
+    why: ClaudeFailure;
+    said?: string;
+};
+/**
+ * One headless Claude Code call with the person's own login: no tools, no MCP
+ * servers, no slash commands, nothing saved as a session (so this run never
+ * shows up as a past session), from a scratch folder so no repo's CLAUDE.md or
+ * hooks load. `TRAIL_NO_HOOKS` keeps trail's own user-level hooks quiet too.
+ * The caller brings its system prompt and schema, with `findings` at the top.
+ * Never rejects: a failure comes back with its reason.
+ */
+export declare function callClaude<T>(bin: string, prompt: string, model: string, timeoutMs: number, ask: {
+    system: string;
+    schema: object;
+}): Promise<ClaudeAnswer<T>>;
+/** `callClaude` for callers that only need the answer: null when there's none. */
+export declare function askClaude<T>(bin: string, prompt: string, model: string, timeoutMs: number, ask: {
+    system: string;
+    schema: object;
+}): Promise<{
+    findings: T[];
+    costUsd?: number;
+} | null>;
+/**
+ * Why `what` couldn't be read, in plain words with what to do about it.
+ * "couldn't read" never stands alone: the reason comes first.
+ */
+export declare function whyLine(f: {
+    why: ClaudeFailure;
+    said?: string;
+}, what: string): string;
+//# sourceMappingURL=claude-call.d.ts.map

package/dist/init/claude-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-call.d.ts","sourceRoot":"","sources":["../../src/init/claude-call.ts"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAkB,EAAE,MAAM,GAAE,MAAM,OAAsB,GAAG,MAAM,GAAG,IAAI,CAqBvG;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnG,gIAAgI;AAChI,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,aAAa,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAoC/H;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CA+D1B;AAED,kFAAkF;AAClF,wBAAsB,SAAS,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC,OAAO,CAAC;IAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAGrD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBtF"}

package/dist/init/claude-call.js

@@ -0,0 +1,199 @@
+/**
+ * Asking the person's own Claude Code, headless, for `trail init`: finding a
+ * copy to run and making the one call.
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+import { flatLine } from "../notes/flatten.js";
+/** Whether `claude` (Claude Code) is on PATH. */
+function claudeOnPath() {
+    const r = spawnSync("claude", ["--version"], { stdio: "ignore", timeout: 10_000 });
+    return r.status === 0;
+}
+/** `[2, 1, 296]` from `anthropic.claude-code-2.1.296-darwin-arm64`; null for anything else. */
+function extensionVersion(name) {
+    const m = /^anthropic\.claude-code-(\d+)\.(\d+)\.(\d+)/.exec(name);
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+}
+/**
+ * The Claude Code to run: `claude` on PATH, else a standalone install's copy,
+ * else the newest copy the VS Code, Cursor, VS Code Insiders or Windsurf
+ * extension keeps. Someone who only uses the extension has no `claude` on
+ * PATH, and without this their past sessions are never read. Null when
+ * there's none.
+ */
+export function claudeBin(home = homedir(), onPath = claudeOnPath) {
+    if (onPath())
+        return "claude";
+    const exe = process.platform === "win32" ? "claude.exe" : "claude";
+    for (const p of [join(home, ".local", "bin", exe), join(home, ".claude", "local", exe)])
+        if (existsSync(p))
+            return p;
+    const copies = [];
+    for (const editor of [".vscode", ".cursor", ".vscode-insiders", ".windsurf"]) {
+        const dir = join(home, editor, "extensions");
+        let names = [];
+        try {
+            names = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            const version = extensionVersion(name);
+            const path = join(dir, name, "resources", "native-binary", exe);
+            if (version && existsSync(path))
+                copies.push({ version, path });
+        }
+    }
+    copies.sort((a, b) => b.version[0] - a.version[0] || b.version[1] - a.version[1] || b.version[2] - a.version[2]);
+    return copies[0]?.path ?? null;
+}
+/** Whether there's a Claude Code to run, on PATH or not. */
+export function hasClaude(home) {
+    return claudeBin(home) !== null;
+}
+/** The CLI's words for a login that's missing or expired. */
+const NOT_SIGNED_IN = /not logged in|please run \/login|log ?in again|failed to authenticate|authentication|oauth|invalid api key|unauthori[sz]ed|\b401\b/i;
+/** The CLI's words when it ran but won't do this one: limits, credit, a refusal. */
+const REFUSED = /limit|quota|credit|balance|overloaded|refus|not allowed|policy|can't help|cannot help/i;
+const SAID_CHARS = 80;
+/** How long a call past its time gets to stop on SIGTERM before it's killed. */
+const KILL_GRACE_MS = 2000;
+/** Claude Code's own message, on one short line, or undefined. A usage limit's reset stamp (`…|1760000000`) is left off. */
+function saidOf(text) {
+    const line = text.replace(/\|\d{9,}\b/g, "").replace(/\s+/g, " ").trim();
+    if (!line)
+        return undefined;
+    return line.length > SAID_CHARS ? `${line.slice(0, SAID_CHARS - 1)}…` : line;
+}
+/** Why a finished call gave no findings, from its JSON result or its plain output. */
+function failureOf(out, err) {
+    let result = "";
+    try {
+        const r = JSON.parse(out);
+        // A run that broke mid-way lists its errors instead of a result.
+        const errors = Array.isArray(r.errors) ? r.errors.filter((e) => typeof e === "string") : [];
+        result = typeof r.result === "string" && r.result ? r.result : errors.join("; ");
+        if (r.api_error_status === 401)
+            return { why: "not_signed_in" };
+        if (!r.is_error && !NOT_SIGNED_IN.test(result))
+            return { why: "refused", ...(saidOf(result) ? { said: saidOf(result) } : {}) };
+    }
+    catch {
+        result = `${out}\n${err}`;
+    }
+    if (NOT_SIGNED_IN.test(result) || NOT_SIGNED_IN.test(err))
+        return { why: "not_signed_in" };
+    const said = saidOf(result) ?? saidOf(err);
+    if (REFUSED.test(result))
+        return { why: "refused", ...(said ? { said } : {}) };
+    return { why: "failed", ...(said ? { said } : {}) };
+}
+/**
+ * One headless Claude Code call with the person's own login: no tools, no MCP
+ * servers, no slash commands, nothing saved as a session (so this run never
+ * shows up as a past session), from a scratch folder so no repo's CLAUDE.md or
+ * hooks load. `TRAIL_NO_HOOKS` keeps trail's own user-level hooks quiet too.
+ * The caller brings its system prompt and schema, with `findings` at the top.
+ * Never rejects: a failure comes back with its reason.
+ */
+export function callClaude(bin, prompt, model, timeoutMs, ask) {
+    return new Promise((done) => {
+        const args = [
+            "-p",
+            "--model", model,
+            "--output-format", "json",
+            "--json-schema", JSON.stringify(ask.schema),
+            "--system-prompt", ask.system,
+            "--tools", "",
+            "--strict-mcp-config",
+            "--no-session-persistence",
+            "--disable-slash-commands",
+        ];
+        let finished = false;
+        const finish = (answer) => {
+            if (finished)
+                return;
+            finished = true;
+            clearTimeout(timer);
+            done(answer);
+        };
+        let timedOut = false;
+        let timer;
+        let child;
+        try {
+            child = spawn(bin, args, { cwd: tmpdir(), env: { ...process.env, TRAIL_NO_HOOKS: "1" }, stdio: ["pipe", "pipe", "pipe"] });
+        }
+        catch (e) {
+            finish({ ok: false, why: e?.code === "ENOENT" ? "not_installed" : "failed" });
+            return;
+        }
+        let out = "";
+        let err = "";
+        timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+            // One that ignores the signal is killed, and init goes on either way: it never hangs here.
+            setTimeout(() => {
+                child.kill("SIGKILL");
+                child.stdout.destroy();
+                child.stderr.destroy();
+                finish({ ok: false, why: "timed_out" });
+            }, KILL_GRACE_MS).unref();
+        }, timeoutMs);
+        child.stdout.on("data", (b) => (out += b.toString("utf8")));
+        // Only a little of stderr: enough for the CLI's own reason, never a whole log.
+        child.stderr.on("data", (b) => {
+            if (err.length < 4096)
+                err += b.toString("utf8");
+        });
+        child.on("error", (e) => finish({ ok: false, why: e?.code === "ENOENT" || e?.code === "EACCES" ? "not_installed" : "failed" }));
+        child.on("close", () => {
+            if (timedOut)
+                return finish({ ok: false, why: "timed_out" });
+            try {
+                const r = JSON.parse(out);
+                if (!r.is_error && r.structured_output) {
+                    return finish({ ok: true, findings: r.structured_output.findings ?? [], ...(typeof r.total_cost_usd === "number" ? { costUsd: r.total_cost_usd } : {}) });
+                }
+            }
+            catch {
+                /* not JSON: the CLI's own words say why */
+            }
+            finish({ ok: false, ...failureOf(out, err) });
+        });
+        child.stdin.on("error", () => { });
+        child.stdin.end(prompt);
+    });
+}
+/** `callClaude` for callers that only need the answer: null when there's none. */
+export async function askClaude(bin, prompt, model, timeoutMs, ask) {
+    const a = await callClaude(bin, prompt, model, timeoutMs, ask);
+    return a.ok ? { findings: a.findings, ...(a.costUsd !== undefined ? { costUsd: a.costUsd } : {}) } : null;
+}
+/**
+ * Why `what` couldn't be read, in plain words with what to do about it.
+ * "couldn't read" never stands alone: the reason comes first.
+ */
+export function whyLine(f, what) {
+    // Plain `trail init` won't look back again once it has, so every retry points at --look-back; Claude Code's own
+    // words are one flat line of at most 80 characters, double quotes made single (as the naming call's, b6 review).
+    const said = f.said ? flatLine(f.said, 80).replace(/["\u201c\u201d]/g, "'") : "";
+    const again = "To try again: trail init --look-back";
+    switch (f.why) {
+        case "not_signed_in":
+            return `Claude Code isn't signed in on this terminal, so trail couldn't read ${what}. Run claude auth login, then trail init --look-back.`;
+        case "not_installed":
+            return `Claude Code isn't installed on this machine, so trail couldn't read ${what}. Install it, then run trail init --look-back.`;
+        case "timed_out":
+            return `Claude Code took longer than 3 minutes to answer, so trail stopped reading ${what}. ${again}`;
+        case "refused":
+            return `Claude Code said no${said ? ` ("${said}")` : ""}, so trail couldn't read ${what}. ${again}`;
+        default:
+            return `Claude Code stopped with an error${said ? ` ("${said}")` : ""}, so trail couldn't read ${what}. ${again}`;
+    }
+}
+//# sourceMappingURL=claude-call.js.map

package/dist/init/claude-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-call.js","sourceRoot":"","sources":["../../src/init/claude-call.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,iDAAiD;AACjD,SAAS,YAAY;IACnB,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,+FAA+F;AAC/F,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,CAAC,GAAG,6CAA6C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,OAAO,EAAE,EAAE,SAAwB,YAAY;IACtF,IAAI,MAAM,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnE,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAAE,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACrH,MAAM,MAAM,GAA0C,EAAE,CAAC;IACzD,KAAK,MAAM,MAAM,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,CAAC,EAAE,CAAC;QAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QAC7C,IAAI,KAAK,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;YAChE,IAAI,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;IACvH,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;AACjC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAClC,CAAC;AAQD,6DAA6D;AAC7D,MAAM,aAAa,GAAG,qIAAqI,CAAC;AAC5J,oFAAoF;AACpF,MAAM,OAAO,GAAG,wFAAwF,CAAC;AACzG,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,gFAAgF;AAChF,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,4HAA4H;AAC5H,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/E,CAAC;AAED,sFAAsF;AACtF,SAAS,SAAS,CAAC,GAAW,EAAE,GAAW;IACzC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2F,CAAC;QACpH,iEAAiE;QACjE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,CAAC,gBAAgB,KAAK,GAAG;YAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC;QAChE,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACjI,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC;IAC3F,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/E,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,MAAc,EACd,KAAa,EACb,SAAiB,EACjB,GAAuC;IAEvC,OAAO,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG;YACX,IAAI;YACJ,SAAS,EAAE,KAAK;YAChB,iBAAiB,EAAE,MAAM;YACzB,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAC3C,iBAAiB,EAAE,GAAG,CAAC,MAAM;YAC7B,SAAS,EAAE,EAAE;YACb,qBAAqB;YACrB,0BAA0B;YAC1B,0BAA0B;SAC3B,CAAC;QACF,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,MAAM,GAAG,CAAC,MAAuB,EAAE,EAAE;YACzC,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,CAAC;QACf,CAAC,CAAC;QACF,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,KAAgD,CAAC;QACrD,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7H,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAG,CAA2B,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzG,OAAO;QACT,CAAC;QACD,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,2FAA2F;YAC3F,UAAU,CAAC,GAAG,EAAE;gBACd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtB,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;YAC1C,CAAC,EAAE,aAAa,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpE,+EAA+E;QAC/E,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACpC,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI;gBAAE,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAwB,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACvJ,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,IAAI,QAAQ;gBAAE,OAAO,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4F,CAAC;gBACrH,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;oBACvC,OAAO,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,IAAI,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC5J,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2CAA2C;YAC7C,CAAC;YACD,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,MAAc,EACd,KAAa,EACb,SAAiB,EACjB,GAAuC;IAEvC,MAAM,CAAC,GAAG,MAAM,UAAU,CAAI,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAClE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAwC,EAAE,IAAY;IAC5E,gHAAgH;IAChH,iHAAiH;IACjH,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;QACd,KAAK,eAAe;YAClB,OAAO,wEAAwE,IAAI,uDAAuD,CAAC;QAC7I,KAAK,eAAe;YAClB,OAAO,uEAAuE,IAAI,gDAAgD,CAAC;QACrI,KAAK,WAAW;YACd,OAAO,8EAA8E,IAAI,KAAK,KAAK,EAAE,CAAC;QACxG,KAAK,SAAS;YACZ,OAAO,sBAAsB,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,4BAA4B,IAAI,KAAK,KAAK,EAAE,CAAC;QACtG;YACE,OAAO,oCAAoC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,4BAA4B,IAAI,KAAK,KAAK,EAAE,CAAC;IACtH,CAAC;AACH,CAAC"}

package/dist/init/discover-worker.d.ts

@@ -0,0 +1,18 @@
+import { type LookBackOpts, type LookBackResult } from "./look-back-mine.js";
+import { type Discovery } from "./sessions.js";
+/** `discoverSessions(repo, home, now, env)` in a worker thread, under the Trail home `env` names. Never rejects. */
+export declare function discoverOffThread(repo: string, home: string, env?: NodeJS.ProcessEnv): Promise<Discovery>;
+type Progress = NonNullable<LookBackOpts["onProgress"]>;
+/**
+ * The no-model look-back (design 4.1 to 4.5) in a worker: discovery, replay, miners, how-tos and candidates, with
+ * progress every 2 s. Never rejects: a worker that can't start (or can't load this module) runs it here; one that dies or overruns its cap by
+ * 30 s gives an empty look-back that says so.
+ */
+export declare function lookBackOffThread(dir: string, opts: {
+    env: NodeJS.ProcessEnv;
+    capMs: number;
+    skills: boolean;
+    onProgress?: Progress;
+}): Promise<LookBackResult>;
+export {};
+//# sourceMappingURL=discover-worker.d.ts.map

package/dist/init/discover-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-worker.d.ts","sourceRoot":"","sources":["../../src/init/discover-worker.ts"],"names":[],"mappings":"AAQA,OAAO,EAAY,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAQjE,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,SAAS,CAAC,CAsBtH;AAED,KAAK,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAC5G,UAAU,CAAC,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA6ClD"}

package/dist/init/discover-worker.js

@@ -0,0 +1,111 @@
+/**
+ * Discovery and the look-back off the main thread: `trail init` keeps wiring
+ * and building the graph (and its spinner keeps turning) while a worker
+ * reads the transcripts. The worker is this same module, started on its own
+ * file; anything that goes wrong with the thread falls back to reading on
+ * the main thread.
+ */
+import { isMainThread, parentPort, workerData, Worker } from "node:worker_threads";
+import { lookBack } from "./look-back-mine.js";
+import { discoverSessions } from "./sessions.js";
+const TAG = "trailDiscover";
+const LOOK = "trailLookBack";
+/** Past the cap, how long the main thread waits for the worker's answer before it gives up on it. */
+const GRACE_MS = 30_000;
+/** `discoverSessions(repo, home, now, env)` in a worker thread, under the Trail home `env` names. Never rejects. */
+export function discoverOffThread(repo, home, env = process.env) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (d) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(d);
+        };
+        const here = () => {
+            if (!settled)
+                done(discoverSessions(repo, home, new Date(), env));
+        };
+        let worker;
+        try {
+            worker = new Worker(new URL(import.meta.url), { workerData: { [TAG]: { repo, home, env: { ...env } } } });
+        }
+        catch {
+            setImmediate(here);
+            return;
+        }
+        worker.once("message", (d) => done(d));
+        worker.once("error", here);
+        worker.once("exit", here);
+    });
+}
+/**
+ * The no-model look-back (design 4.1 to 4.5) in a worker: discovery, replay, miners, how-tos and candidates, with
+ * progress every 2 s. Never rejects: a worker that can't start (or can't load this module) runs it here; one that dies or overruns its cap by
+ * 30 s gives an empty look-back that says so.
+ */
+export function lookBackOffThread(dir, opts) {
+    const { onProgress, ...plain } = opts;
+    const empty = (why) => ({
+        sessions: [], skipped: [], days: 0, from: null, to: null, parent: 0, candidates: [], alreadyKept: { here: 0, elsewhere: [] }, howtos: [], ms: 0,
+        errors: [`couldn't read your past sessions this time (${why})`],
+    });
+    return new Promise((resolve) => {
+        let settled = false;
+        let timer;
+        const done = (lb) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            resolve(lb);
+        };
+        let worker;
+        try {
+            worker = new Worker(new URL(import.meta.url), { workerData: { [LOOK]: { dir, opts: { ...plain, env: { ...plain.env } } } } });
+        }
+        catch {
+            setImmediate(() => done(lookBack(dir, opts)));
+            return;
+        }
+        timer = setTimeout(() => {
+            done(empty("out of time"));
+            void worker.terminate();
+        }, Math.max(0, opts.capMs) + GRACE_MS);
+        timer.unref?.();
+        worker.on("message", (m) => {
+            if (m?.progress && onProgress) {
+                try {
+                    onProgress(m.progress);
+                }
+                catch { /* a progress line never stops the look-back */ }
+            }
+            if (m?.done)
+                done(m.done);
+        });
+        worker.once("error", (e) => {
+            // A worker that can't load this module (Node 20 runs a .ts source only on the main thread) never started: run it here.
+            if (e?.code === "ERR_UNKNOWN_FILE_EXTENSION") {
+                if (!settled)
+                    done(lookBack(dir, opts));
+                return;
+            }
+            done(empty(e instanceof Error ? e.message.slice(0, 80) : "the reader stopped"));
+        });
+        worker.once("exit", () => done(empty("the reader stopped")));
+    });
+}
+if (!isMainThread && workerData && typeof workerData === "object") {
+    const data = workerData;
+    if (TAG in data) {
+        const { repo, home, env } = data[TAG];
+        parentPort?.postMessage(discoverSessions(repo, home, new Date(), env ?? process.env));
+    }
+    else if (LOOK in data) {
+        const { dir, opts } = data[LOOK];
+        const lb = lookBack(dir, { ...opts, onProgress: (p) => parentPort?.postMessage({ progress: p }) });
+        parentPort?.postMessage({ done: lb });
+    }
+}
+//# sourceMappingURL=discover-worker.js.map

package/dist/init/discover-worker.js.map

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

package/dist/init/handover.d.ts

@@ -0,0 +1,16 @@
+import { type PendingItem } from './init-record.js';
+import type { InitItem } from './types.js';
+/**
+ * A pending item as the relay shows it again: its plain name, or the person's line read now by its pointer (title ''
+ * when that line is gone). Shared with `trail keep`, which names the same items.
+ */
+export declare function pendingAsItem(p: PendingItem, env: NodeJS.ProcessEnv): InitItem;
+/**
+ * The context to add at this session's start, or null. Writes the record: `handedAt` and `handover` the first time;
+ * `pending` dropped when another session already had it. Never throws.
+ */
+export declare function initHandover(repoKey: string, session: {
+    id: string;
+    transcriptPath: string | null;
+}, env?: NodeJS.ProcessEnv, now?: Date): string | null;
+//# sourceMappingURL=handover.d.ts.map

package/dist/init/handover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handover.d.ts","sourceRoot":"","sources":["../../src/init/handover.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAyD,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM3G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,CAW9E;AAUD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EACxI,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAkCvC"}

package/dist/init/handover.js

@@ -0,0 +1,92 @@
+/**
+ * The init handover (design 3.1 step 10, 4.8, J02 leg C), for b7's
+ * SessionStart to call: when a relay's list waits unanswered, the next
+ * interactive session in this repo gets the same list once, numbers
+ * unchanged, titles rebuilt from the record (a preference's line read again
+ * by its pointer), and the record notes that session and its transcript's
+ * size, from which the keep gate reads (R22). A later session says nothing
+ * and drops the list: its items become never-shown (P10).
+ *
+ * Light on purpose (it runs inside the SessionStart budget): the record, at
+ * most 5 positioned reads, no replay or compile. When a list waits to be
+ * handed over, the session's own transcript tail is read once (keep-list's
+ * `findList`): the session that showed the list, resumed, is not handed it
+ * again (fix-lab5).
+ */
+import { statSync } from 'node:fs';
+import { directive } from '../skills/directive-words.js';
+import { HOOK_RECORD_WAIT_MS, readInitRecord, updateInitRecord } from './init-record.js';
+import { leadWords, replyNamesList } from './keep-answer.js';
+import { isInitCommand } from './keep-gate.js';
+import { findList, typedLine } from './keep-list.js';
+import { prefText } from './prefs.js';
+import { fill, INIT_COPY, relayBlock, repoNameOf } from './review-screen.js';
+/**
+ * A pending item as the relay shows it again: its plain name, or the person's line read now by its pointer (title ''
+ * when that line is gone). Shared with `trail keep`, which names the same items.
+ */
+export function pendingAsItem(p, env) {
+    let title = p.plainName;
+    if (p.kind === 'preference') {
+        const ref = p.pref?.refs[0];
+        const text = ref ? typedLine(ref, env) : null;
+        title = text ? prefText(text).slice(0, 120) : '';
+    }
+    return {
+        ...p, title, description: '', evidence: [], rank: 0, nameWords: p.kind === 'preference' ? leadWords(title) : p.nameWords,
+        ...(p.skill ? { skill: { src: p.skill.src, ...(p.skill.branches ? { branches: p.skill.branches } : {}) } } : {}),
+    };
+}
+/** This session's transcript already holds a clean `trail init` call's list naming every pending item. */
+function holdsList(path, all) {
+    if (!path)
+        return false;
+    const found = findList(path, isInitCommand, null);
+    const list = found?.list;
+    return !!list && list.via === 'init-call' && replyNamesList(list.text, all.map((i) => ({ n: i.n, nameWords: i.nameWords })));
+}
+/**
+ * The context to add at this session's start, or null. Writes the record: `handedAt` and `handover` the first time;
+ * `pending` dropped when another session already had it. Never throws.
+ */
+export function initHandover(repoKey, session, env = process.env, now = new Date()) {
+    try {
+        const r = readInitRecord(repoKey, env);
+        if (!r.pending.length || !r.shownAt || !r.pendingFrom)
+            return null;
+        if (r.handedAt) {
+            if (r.handover?.session !== session.id) {
+                updateInitRecord(repoKey, (x) => {
+                    x.pending = [];
+                    x.pendingFrom = null;
+                    x.shownAt = null;
+                    x.handedAt = null;
+                    x.handover = null;
+                }, env, HOOK_RECORD_WAIT_MS);
+            }
+            return null;
+        }
+        const items = r.pending.slice(0, 5).map((p) => pendingAsItem(p, env)).filter((x) => x.title !== '');
+        if (!items.length)
+            return null;
+        // fix-lab5: the session that showed this list, resumed (every `claude -p` turn is one), already holds it. Handing
+        // it over again would make the person's next typed line read as before the list. Another session still gets it.
+        if (holdsList(session.transcriptPath, r.pending.map((p) => pendingAsItem(p, env))))
+            return null;
+        let offset = 0;
+        try {
+            offset = session.transcriptPath ? statSync(session.transcriptPath).size : 0;
+        }
+        catch { /* no transcript yet: from its start */ }
+        updateInitRecord(repoKey, (x) => {
+            x.handedAt = now.toISOString();
+            x.handover = { session: session.id, offset };
+        }, env, HOOK_RECORD_WAIT_MS);
+        const block = relayBlock(items, repoNameOf(repoKey), true);
+        return [directive(null, fill(INIT_COPY.handover, { k: items.length })), ...block.slice(1)].join('\n');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=handover.js.map

package/dist/init/handover.js.map

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

package/dist/init/howtos.d.ts

@@ -0,0 +1,20 @@
+import type { JobClass } from '../trace/types.js';
+/** Reads ~/.claude/projects/<key>/memory/*.md for each discovered project key. Never writes. */
+export declare function readHowtos(projectKeys: string[], claudeHome: string): Array<{
+    file: string;
+    text: string;
+}>;
+/**
+ * Evidence for a skill candidate: the first how-to with a paragraph that names one of the job's programs and one of
+ * its words (`npm publish` with release). The file name, or null.
+ */
+export declare function howtoDescribes(h: Array<{
+    file: string;
+    text: string;
+}>, job: JobClass, programs: string[]): string | null;
+/** True when a how-to line already says the preference (content-word Jaccard 0.5, 4.4 step 5). */
+export declare function howtoKnows(h: Array<{
+    file: string;
+    text: string;
+}>, prefText: string): boolean;
+//# sourceMappingURL=howtos.d.ts.map

package/dist/init/howtos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"howtos.d.ts","sourceRoot":"","sources":["../../src/init/howtos.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA8BlD,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB3G;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAWzH;AAED,kGAAkG;AAClG,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO9F"}