agent-bober 0.12.0 → 0.15.0

package/dist/graph/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/graph/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,SAAS,EAEV,MAAM,YAAY,CAAC;AAepB,KAAK,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACxB;AAED,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB;;yCAEqC;IACrC,OAAO,CAAC,UAAU,CAAiC;gBAGhC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,kBAAkB,EAC7B,aAAa,EAAE,kBAAkB,EACjC,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,YAAY;IAGvC,qFAAqF;IACrF,SAAS,IAAI,IAAI;IAIjB;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;IAM5D,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;IAOvE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAM9E,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAapE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAI7D,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAIxC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAMxD,QAAQ,CACZ,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IA2BhD,OAAO,CAAC,QAAQ;IAqChB;;;OAGG;YACW,cAAc;IAqC5B,mFAAmF;YACrE,MAAM;IAIpB;+EAC2E;IAC3E,OAAO,CAAC,eAAe;IASvB,wDAAwD;YAC1C,cAAc;IAO5B,2FAA2F;IAC3F,OAAO,CAAC,QAAQ;YAaF,cAAc;CAY7B"}

package/dist/graph/client.js

@@ -0,0 +1,216 @@
+/**
+ * GraphClient — the single typed facade the rest of the harness imports.
+ *
+ * All methods return Promise<GraphResult<T>> and NEVER throw for expected
+ * failure modes. Callers branch on `.ok`. (ADR-3)
+ *
+ * Sandbox post-filter is a single chokepoint here — every NodeRef.file
+ * is validated via sandboxNodePath before returning to callers.
+ */
+import { sandboxNodePath } from "./sandbox.js";
+// Tokensave MCP tool catalog → GraphClient method mapping.
+// Names match the canonical tool catalog (per the project CLAUDE.md);
+// no `tokensave_` prefix.
+const TOOL = {
+    search: "semantic_search_nodes",
+    query: "query_graph",
+    impact: "get_impact_radius",
+    reviewContext: "get_review_context",
+    overview: "get_architecture_overview",
+    changes: "detect_changes",
+};
+export class GraphClient {
+    projectRoot;
+    mcpClient;
+    artifactStore;
+    fallback;
+    incidents;
+    config;
+    /** Session-level cached staleness verdict. Read once on first method call;
+     *  may be invalidated by markFresh() when GraphHookHandler (sprint 8)
+     *  signals a sync just completed. */
+    staleCache = null;
+    constructor(projectRoot, mcpClient, artifactStore, fallback, incidents, config) {
+        this.projectRoot = projectRoot;
+        this.mcpClient = mcpClient;
+        this.artifactStore = artifactStore;
+        this.fallback = fallback;
+        this.incidents = incidents;
+        this.config = config;
+    }
+    /** Invalidate the session staleness cache. Called by GraphHookHandler (sprint 8). */
+    markFresh() {
+        this.staleCache = { stale: false };
+    }
+    /**
+     * Return a user-facing FallbackHint for a given failure reason.
+     * Consumed by GraphMcpTools (sprint 4) to generate fallback guidance.
+     */
+    hintFor(reason, detail) {
+        return this.fallback.hint(reason, detail);
+    }
+    // ── Public API ──────────────────────────────────────────────────
+    async search(q, opts) {
+        return this.runWithSandbox(TOOL.search, { query: q, ...opts }, (raw) => {
+            const hits = raw.filter((h) => this.keepNode(h.node, "search"));
+            return hits;
+        });
+    }
+    async query(pattern, target) {
+        return this.runWithSandbox(TOOL.query, { pattern, target }, (raw) => {
+            return raw.filter((n) => this.keepNode(n, "query"));
+        });
+    }
+    async impact(target) {
+        return this.runWithSandbox(TOOL.impact, { target }, (raw) => {
+            const report = raw;
+            return {
+                root: report.root, // root may be out-of-sandbox but is informational only
+                affected: report.affected.filter((n) => this.keepNode(n, "impact")),
+                testsAffected: report.testsAffected.filter((n) => this.keepNode(n, "impact")),
+            };
+        });
+    }
+    async reviewContext(nodes) {
+        return this.runRaw(TOOL.reviewContext, { nodes });
+    }
+    async overview() {
+        return this.runRaw(TOOL.overview, {});
+    }
+    async changes(since) {
+        return this.runWithSandbox(TOOL.changes, { since }, (raw) => {
+            return raw.filter((n) => this.keepNode(n, "changes"));
+        });
+    }
+    async prefetch(queries) {
+        if (queries.length === 0)
+            return {};
+        const dispatched = queries.map((q) => this.dispatch(q));
+        const settled = await Promise.allSettled(dispatched);
+        const out = {};
+        for (let i = 0; i < queries.length; i++) {
+            const q = queries[i];
+            const s = settled[i];
+            if (s.status === "fulfilled") {
+                out[q.key] = s.value;
+            }
+            else {
+                // Should never happen because dispatch returns GraphResult,
+                // never throws — but defend just in case.
+                out[q.key] = {
+                    ok: false,
+                    reason: "GRAPH_ERROR",
+                    detail: s.reason instanceof Error ? s.reason.message : String(s.reason),
+                };
+            }
+        }
+        return out;
+    }
+    // ── Internals ──────────────────────────────────────────────────
+    dispatch(q) {
+        switch (q.op) {
+            case "search":
+                return this.search(q.args.q, q.args);
+            case "query":
+                return this.query(q.args.pattern, q.args.target);
+            case "impact":
+                return this.impact(q.args.target);
+            case "reviewContext":
+                return this.reviewContext(q.args.nodes);
+            case "overview":
+                return this.overview();
+            case "changes":
+                return this.changes(q.args.since);
+            default:
+                // exhaustiveness — TypeScript will complain if a PrefetchOp is added
+                // without a case here.
+                return Promise.resolve({
+                    ok: false,
+                    reason: "GRAPH_ERROR",
+                    detail: `unknown prefetch op: ${String(q.op)}`,
+                });
+        }
+    }
+    /**
+     * Common path for methods that need NodeRef sandbox filtering.
+     * Runs the MCP call, times it, narrows result, sandboxes nodes, returns GraphResult.
+     */
+    async runWithSandbox(tool, params, narrow) {
+        if (!this.config.enabled) {
+            return { ok: false, reason: "GRAPH_DISABLED", detail: "graph.enabled=false" };
+        }
+        const health = this.mcpClient.health();
+        if (health === "broken" || health === "restarting") {
+            return {
+                ok: false,
+                reason: "GRAPH_UNAVAILABLE",
+                detail: health === "broken" ? "engine breaker tripped" : "engine is restarting",
+            };
+        }
+        const stale = await this.checkStaleness();
+        const t0 = Date.now();
+        try {
+            const raw = await this.mcpClient.call(tool, params);
+            const data = narrow(raw);
+            // TODO(phase-2): map backend to 'binding' when EngineBinding ships.
+            const result = {
+                ok: true,
+                data,
+                backend: "mcp",
+                durationMs: Date.now() - t0,
+            };
+            if (stale)
+                result.stale = true;
+            return result;
+        }
+        catch (err) {
+            return this.toFailureResult(err);
+        }
+    }
+    /** Same as runWithSandbox but the result type is T with no NodeRef post-filter. */
+    async runRaw(tool, params) {
+        return this.runWithSandbox(tool, params, (raw) => raw);
+    }
+    /** Convert a makeGraphError-tagged Error from TokensaveMcpClient.call into a
+     *  GraphResult.ok=false. mcp-client.ts:58-63 sets .reason on the Error. */
+    toFailureResult(err) {
+        const reason = err?.reason ?? "GRAPH_ERROR";
+        const detail = err?.detail ??
+            (err instanceof Error ? err.message : String(err));
+        return { ok: false, reason, detail };
+    }
+    /** One-time staleness probe, cached for the session. */
+    async checkStaleness() {
+        if (this.staleCache === null) {
+            this.staleCache = await this.artifactStore.staleness();
+        }
+        return this.staleCache.stale;
+    }
+    /** Returns true if the node should be kept; false → silently dropped + incident logged. */
+    keepNode(node, source) {
+        if (!node || !node.file) {
+            void this.logSandboxDrop(node?.file ?? null, source);
+            return false;
+        }
+        const sb = sandboxNodePath(this.projectRoot, node.file);
+        if (!sb.ok) {
+            void this.logSandboxDrop(node.file, source);
+            return false;
+        }
+        return true;
+    }
+    async logSandboxDrop(file, source) {
+        try {
+            await this.incidents.append({
+                ts: new Date().toISOString(),
+                event: "sandbox-drop",
+                file: file ?? "<null>",
+                source,
+            });
+        }
+        catch {
+            // Incident-write failures must not break agent flow.
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/graph/client.js.map

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

package/dist/graph/fallback.d.ts

@@ -0,0 +1,13 @@
+import type { FallbackHint, GraphFailureReason } from "./types.js";
+export type FallbackMode = "gated" | "dual";
+/**
+ * Maps a GraphFailureReason to a user-facing FallbackHint.
+ * The hint tells the agent which non-graph tools to fall back to and
+ * whether retrying is worthwhile.
+ */
+export declare class GraphFallback {
+    private readonly mode;
+    constructor(mode?: FallbackMode);
+    hint(reason: GraphFailureReason, detail?: string): FallbackHint;
+}
+//# sourceMappingURL=fallback.d.ts.map

package/dist/graph/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/graph/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGnE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,YAAqB;IAExD,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;CAqDhE"}

package/dist/graph/fallback.js

@@ -0,0 +1,57 @@
+import { assertNever } from "./types.js";
+/**
+ * Maps a GraphFailureReason to a user-facing FallbackHint.
+ * The hint tells the agent which non-graph tools to fall back to and
+ * whether retrying is worthwhile.
+ */
+export class GraphFallback {
+    mode;
+    constructor(mode = "dual") {
+        this.mode = mode;
+    }
+    hint(reason, detail) {
+        switch (reason) {
+            case "GRAPH_DISABLED":
+                return {
+                    message: "Graph integration is disabled. Use filesystem tools instead." +
+                        (detail ? ` (${detail})` : ""),
+                    suggestedTools: ["grep", "glob", "read_file"],
+                    retryable: false,
+                };
+            case "GRAPH_UNAVAILABLE":
+                // In gated mode, grep/glob have been removed — only read_file remains.
+                // In dual mode, all filesystem tools are still on the role's tool surface.
+                return {
+                    message: "Graph engine is unavailable (subprocess down or breaker tripped)." +
+                        (detail ? ` (${detail})` : ""),
+                    suggestedTools: this.mode === "gated" ? ["read_file"] : ["grep", "glob", "read_file"],
+                    retryable: false,
+                };
+            case "GRAPH_STALE":
+                return {
+                    message: "Graph index is stale. Results may be missing recent edits. " +
+                        "Run `agent-bober graph sync` to refresh." +
+                        (detail ? ` (${detail})` : ""),
+                    suggestedTools: this.mode === "gated" ? ["graph_search"] : ["graph_search", "grep"],
+                    retryable: true,
+                };
+            case "GRAPH_TIMEOUT":
+                return {
+                    message: "Graph query timed out. Retry with a narrower query or fall back to filesystem search." +
+                        (detail ? ` (${detail})` : ""),
+                    suggestedTools: this.mode === "gated" ? ["read_file"] : ["grep", "read_file"],
+                    retryable: true,
+                };
+            case "GRAPH_ERROR":
+                return {
+                    message: "Graph engine returned an error." +
+                        (detail ? ` (${detail})` : ""),
+                    suggestedTools: this.mode === "gated" ? ["read_file"] : ["grep", "glob", "read_file"],
+                    retryable: false,
+                };
+            default:
+                return assertNever(reason);
+        }
+    }
+}
+//# sourceMappingURL=fallback.js.map

package/dist/graph/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../src/graph/fallback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzC;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAqB,MAAM;QAA3B,SAAI,GAAJ,IAAI,CAAuB;IAAG,CAAC;IAE5D,IAAI,CAAC,MAA0B,EAAE,MAAe;QAC9C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,gBAAgB;gBACnB,OAAO;oBACL,OAAO,EACL,8DAA8D;wBAC9D,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC;oBAC7C,SAAS,EAAE,KAAK;iBACjB,CAAC;YACJ,KAAK,mBAAmB;gBACtB,uEAAuE;gBACvE,2EAA2E;gBAC3E,OAAO;oBACL,OAAO,EACL,mEAAmE;wBACnE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChC,cAAc,EACZ,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC;oBACvE,SAAS,EAAE,KAAK;iBACjB,CAAC;YACJ,KAAK,aAAa;gBAChB,OAAO;oBACL,OAAO,EACL,6DAA6D;wBAC7D,0CAA0C;wBAC1C,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChC,cAAc,EACZ,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC;oBACrE,SAAS,EAAE,IAAI;iBAChB,CAAC;YACJ,KAAK,eAAe;gBAClB,OAAO;oBACL,OAAO,EACL,uFAAuF;wBACvF,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChC,cAAc,EACZ,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC;oBAC/D,SAAS,EAAE,IAAI;iBAChB,CAAC;YACJ,KAAK,aAAa;gBAChB,OAAO;oBACL,OAAO,EACL,iCAAiC;wBACjC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChC,cAAc,EACZ,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC;oBACvE,SAAS,EAAE,KAAK;iBACjB,CAAC;YACJ;gBACE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF"}

package/dist/graph/hook-handler.d.ts

@@ -0,0 +1,50 @@
+import type { TokensaveCli } from "./cli.js";
+import type { GraphArtifactStore } from "./artifact-store.js";
+import type { IncidentLog } from "./incidents.js";
+import type { GraphSection } from "../config/schema.js";
+/**
+ * Debounces PostToolUse Edit|Write events and forwards path batches to
+ * TokensaveCli.sync. Owns:
+ *   - In-memory Set<string> of pending paths (cap = config.hookQueueMax).
+ *   - A single debounce Timer (window = config.debounceMs).
+ *   - A 100ms poll loop reading .bober/graph/.hook-queue.jsonl.
+ *
+ * onPostToolUse is synchronous (fire-and-forget). flush() drains the queue
+ * with a 5000ms total budget — called from GraphPipelineLifecycle.stop()
+ * before the engine is killed.
+ */
+export declare class GraphHookHandler {
+    private readonly cli;
+    private readonly store;
+    private readonly incidents;
+    private readonly config;
+    private readonly queue;
+    private debounceTimer;
+    private pollTimer;
+    private overflowBatch;
+    private syncing;
+    private stopped;
+    private readonly queueFilePath;
+    private static readonly FLUSH_BUDGET_MS;
+    private static readonly POLL_INTERVAL_MS;
+    private static readonly OVERFLOW_EVICT;
+    private static readonly OVERFLOW_WARN_EVERY;
+    constructor(cli: TokensaveCli, store: GraphArtifactStore, incidents: IncidentLog, config: GraphSection, projectRoot: string);
+    /** Begin polling the IPC queue file. Called once at lifecycle start(). */
+    start(): void;
+    /**
+     * Synchronous fire-and-forget entry point.
+     * Adds paths to queue; resets debounce timer; on cap-overflow drops oldest.
+     * Returns immediately — NO awaits.
+     */
+    onPostToolUse(payload: {
+        paths: string[];
+    }): void;
+    /** Drain queue with FLUSH_BUDGET_MS total budget. Called from lifecycle.stop(). */
+    flush(): Promise<void>;
+    private evictOldest;
+    private runSync;
+    private markPending;
+    private drainIpcFile;
+}
+//# sourceMappingURL=hook-handler.d.ts.map

package/dist/graph/hook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler.d.ts","sourceRoot":"","sources":["../../src/graph/hook-handler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYxD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAczB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAhBzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAM;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAM;gBAG9B,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,YAAY,EACrC,WAAW,EAAE,MAAM;IAKrB,0EAA0E;IAC1E,KAAK,IAAI,IAAI;IASb;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAwCjD,mFAAmF;IAC7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B,OAAO,CAAC,WAAW;YASL,OAAO;YA4BP,WAAW;YAWX,YAAY;CAgC3B"}

package/dist/graph/hook-handler.js

@@ -0,0 +1,217 @@
+import { resolve } from "node:path";
+import { readFile, truncate } from "node:fs/promises";
+import { fileExists } from "../utils/fs.js";
+import { logger } from "../utils/logger.js";
+// ── GraphHookHandler ───────────────────────────────────────────────
+/**
+ * Debounces PostToolUse Edit|Write events and forwards path batches to
+ * TokensaveCli.sync. Owns:
+ *   - In-memory Set<string> of pending paths (cap = config.hookQueueMax).
+ *   - A single debounce Timer (window = config.debounceMs).
+ *   - A 100ms poll loop reading .bober/graph/.hook-queue.jsonl.
+ *
+ * onPostToolUse is synchronous (fire-and-forget). flush() drains the queue
+ * with a 5000ms total budget — called from GraphPipelineLifecycle.stop()
+ * before the engine is killed.
+ */
+export class GraphHookHandler {
+    cli;
+    store;
+    incidents;
+    config;
+    queue = new Set();
+    debounceTimer = null;
+    pollTimer = null;
+    overflowBatch = 0;
+    syncing = false;
+    stopped = false;
+    queueFilePath;
+    static FLUSH_BUDGET_MS = 5000;
+    static POLL_INTERVAL_MS = 100;
+    static OVERFLOW_EVICT = 10;
+    static OVERFLOW_WARN_EVERY = 10;
+    constructor(cli, store, incidents, config, projectRoot) {
+        this.cli = cli;
+        this.store = store;
+        this.incidents = incidents;
+        this.config = config;
+        this.queueFilePath = resolve(projectRoot, ".bober/graph/.hook-queue.jsonl");
+    }
+    /** Begin polling the IPC queue file. Called once at lifecycle start(). */
+    start() {
+        if (this.pollTimer)
+            return;
+        this.pollTimer = setInterval(() => {
+            this.drainIpcFile().catch(() => { });
+        }, GraphHookHandler.POLL_INTERVAL_MS);
+        // Unref so the interval does not prevent the process from exiting naturally.
+        this.pollTimer.unref?.();
+    }
+    /**
+     * Synchronous fire-and-forget entry point.
+     * Adds paths to queue; resets debounce timer; on cap-overflow drops oldest.
+     * Returns immediately — NO awaits.
+     */
+    onPostToolUse(payload) {
+        if (this.stopped)
+            return;
+        if (this.config.autoSync === false)
+            return;
+        if (!payload.paths?.length)
+            return;
+        for (const p of payload.paths)
+            this.queue.add(p);
+        // Overflow: queue.size > hookQueueMax → drop the oldest entries.
+        if (this.queue.size > this.config.hookQueueMax) {
+            const overflow = this.queue.size - this.config.hookQueueMax;
+            const dropCount = Math.max(overflow, GraphHookHandler.OVERFLOW_EVICT);
+            this.evictOldest(dropCount);
+            this.overflowBatch++;
+            // Fire-and-forget incident write — do NOT await
+            this.incidents
+                .append({
+                ts: new Date().toISOString(),
+                event: "debounce-overflow",
+                droppedCount: dropCount,
+                queueSize: this.queue.size,
+                currentPaths: Array.from(this.queue).slice(-10),
+            })
+                .catch(() => { });
+            if (this.overflowBatch % GraphHookHandler.OVERFLOW_WARN_EVERY === 0) {
+                logger.warn(`[graph] Hook queue overflow: dropped ${dropCount} oldest paths (batch ${this.overflowBatch})`);
+            }
+        }
+        // Reset / arm debounce timer.
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            this.runSync().catch(() => { });
+        }, this.config.debounceMs);
+        // Unref so the timer does not prevent the process from exiting naturally.
+        this.debounceTimer.unref?.();
+    }
+    /** Drain queue with FLUSH_BUDGET_MS total budget. Called from lifecycle.stop(). */
+    async flush() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.stopped = true;
+        // Drain IPC file one last time before draining queue.
+        await this.drainIpcFile().catch(() => { });
+        if (this.queue.size === 0)
+            return;
+        const start = Date.now();
+        try {
+            await Promise.race([this.runSync(), delay(GraphHookHandler.FLUSH_BUDGET_MS)]);
+        }
+        finally {
+            // Anything still in the queue → write to manifest.pendingFiles
+            if (this.queue.size > 0) {
+                await this.markPending(Array.from(this.queue));
+            }
+            logger.info(`[graph] HookHandler.flush completed in ${Date.now() - start}ms`);
+        }
+    }
+    // ── Internals ────────────────────────────────────────────────────
+    evictOldest(n) {
+        let count = 0;
+        for (const p of this.queue) {
+            if (count >= n)
+                break;
+            this.queue.delete(p);
+            count++;
+        }
+    }
+    async runSync() {
+        if (this.syncing)
+            return;
+        if (this.queue.size === 0)
+            return;
+        this.syncing = true;
+        const paths = Array.from(this.queue);
+        this.queue.clear();
+        try {
+            await this.cli.sync(paths, this.config.syncTimeoutMs);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/timed out/i.test(msg)) {
+                await this.incidents
+                    .append({
+                    ts: new Date().toISOString(),
+                    event: "hook-timeout",
+                    paths,
+                    timeoutMs: this.config.syncTimeoutMs,
+                })
+                    .catch(() => { });
+                await this.markPending(paths);
+            }
+            else {
+                logger.warn(`[graph] Hook sync failed (non-timeout): ${msg}`);
+            }
+        }
+        finally {
+            this.syncing = false;
+        }
+    }
+    async markPending(paths) {
+        try {
+            const existing = await this.store.readManifest();
+            if (!existing)
+                return;
+            const merged = Array.from(new Set([...(existing.pendingFiles ?? []), ...paths]));
+            await this.store.writeManifest({ ...existing, pendingFiles: merged });
+        }
+        catch {
+            // Manifest update is best-effort
+        }
+    }
+    async drainIpcFile() {
+        if (!(await fileExists(this.queueFilePath)))
+            return;
+        let raw;
+        try {
+            raw = await readFile(this.queueFilePath, "utf-8");
+        }
+        catch {
+            return;
+        }
+        if (!raw)
+            return;
+        // Truncate first so a concurrent hook-script append is not permanently lost.
+        // We accept one line of loss on truly simultaneous writes — this is fine
+        // because the hook script and this reader are on different processes.
+        try {
+            await truncate(this.queueFilePath, 0);
+        }
+        catch {
+            // ignore
+        }
+        for (const line of raw.split("\n")) {
+            const t = line.trim();
+            if (!t)
+                continue;
+            let rec;
+            try {
+                rec = JSON.parse(t);
+            }
+            catch {
+                continue;
+            }
+            if (!Array.isArray(rec.paths) || rec.paths.length === 0)
+                continue;
+            this.onPostToolUse({ paths: rec.paths });
+        }
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────
+function delay(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=hook-handler.js.map

package/dist/graph/hook-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler.js","sourceRoot":"","sources":["../../src/graph/hook-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAc5C,sEAAsE;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IAcR;IACA;IACA;IACA;IAhBF,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,aAAa,GAAyC,IAAI,CAAC;IAC3D,SAAS,GAA0C,IAAI,CAAC;IACxD,aAAa,GAAG,CAAC,CAAC;IAClB,OAAO,GAAG,KAAK,CAAC;IAChB,OAAO,GAAG,KAAK,CAAC;IACP,aAAa,CAAS;IAC/B,MAAM,CAAU,eAAe,GAAG,IAAI,CAAC;IACvC,MAAM,CAAU,gBAAgB,GAAG,GAAG,CAAC;IACvC,MAAM,CAAU,cAAc,GAAG,EAAE,CAAC;IACpC,MAAM,CAAU,mBAAmB,GAAG,EAAE,CAAC;IAEjD,YACmB,GAAiB,EACjB,KAAyB,EACzB,SAAsB,EACtB,MAAoB,EACrC,WAAmB;QAJF,QAAG,GAAH,GAAG,CAAc;QACjB,UAAK,GAAL,KAAK,CAAoB;QACzB,cAAS,GAAT,SAAS,CAAa;QACtB,WAAM,GAAN,MAAM,CAAc;QAGrC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,gCAAgC,CAAC,CAAC;IAC9E,CAAC;IAED,0EAA0E;IAC1E,KAAK;QACH,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtC,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QACtC,6EAA6E;QAC7E,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,OAA4B;QACxC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK;YAAE,OAAO;QAC3C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM;YAAE,OAAO;QAEnC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEjD,iEAAiE;QACjE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACtE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAC5B,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,gDAAgD;YAChD,IAAI,CAAC,SAAS;iBACX,MAAM,CAAC;gBACN,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,KAAK,EAAE,mBAAmB;gBAC1B,YAAY,EAAE,SAAS;gBACvB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;gBAC1B,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;aAChD,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,IAAI,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC,mBAAmB,KAAK,CAAC,EAAE,CAAC;gBACpE,MAAM,CAAC,IAAI,CACT,wCAAwC,SAAS,wBAAwB,IAAI,CAAC,aAAa,GAAG,CAC/F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,aAAa;YAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACjC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3B,0EAA0E;QAC1E,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC;IAC/B,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,sDAAsD;QACtD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAE1C,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAElC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC;gBAAS,CAAC;YACT,+DAA+D;YAC/D,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,0CAA0C,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,oEAAoE;IAE5D,WAAW,CAAC,CAAS;QAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK,IAAI,CAAC;gBAAE,MAAM;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACrB,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,SAAS;qBACjB,MAAM,CAAC;oBACN,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBAC5B,KAAK,EAAE,cAAc;oBACrB,KAAK;oBACL,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;iBACrC,CAAC;qBACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnB,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,KAAe;QACvC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YACjD,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACjF,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAAE,OAAO;QACpD,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,6EAA6E;QAC7E,yEAAyE;QACzE,sEAAsE;QACtE,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,IAAI,GAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAkB,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAClE,IAAI,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;;AAGH,sEAAsE;AAEtE,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/graph/incidents.d.ts

@@ -0,0 +1,59 @@
+export type IncidentEvent = {
+    ts: string;
+    event: "breaker-tripped";
+    restartCount: number;
+    windowMs: number;
+} | {
+    ts: string;
+    event: "restart";
+    pid: number | null;
+    exitCode: number | null;
+    signal: string | null;
+} | {
+    ts: string;
+    event: "start";
+    pid: number;
+} | {
+    ts: string;
+    event: "stop";
+    pid: number;
+    reason: "sigterm" | "sigkill" | "normal";
+} | {
+    ts: string;
+    event: "orphan-killed";
+    pid: number;
+} | {
+    ts: string;
+    event: "sandbox-drop";
+    file: string;
+    source: string;
+} | {
+    ts: string;
+    event: "preflight-failure";
+    role: string;
+    detail: string;
+} | {
+    ts: string;
+    event: "debounce-overflow";
+    droppedCount: number;
+    queueSize: number;
+    currentPaths: string[];
+} | {
+    ts: string;
+    event: "hook-timeout";
+    paths: string[];
+    timeoutMs: number;
+};
+/**
+ * Append-only writer for .bober/graph/incidents.jsonl.
+ *
+ * Each call writes a single newline-terminated JSON object.
+ * The directory is created defensively on each write, in case
+ * GraphArtifactStore.ensureLayout() has not been called yet.
+ */
+export declare class IncidentLog {
+    private readonly path;
+    constructor(projectRoot: string);
+    append(e: IncidentEvent): Promise<void>;
+}
+//# sourceMappingURL=incidents.d.ts.map

package/dist/graph/incidents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incidents.d.ts","sourceRoot":"","sources":["../../src/graph/incidents.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACpG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;CAAE,GACpF;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxE;IACE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,mBAAmB,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,GACD;IACE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAIN;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,WAAW,EAAE,MAAM;IAIzB,MAAM,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9C"}