cgraphx 1.1.0

package/dist/telemetry/index.js

@@ -0,0 +1,541 @@
+"use strict";
+/**
+ * Anonymous usage telemetry — client side.
+ *
+ * The contract for what may be collected lives in docs/design/telemetry.md
+ * (and user-facing TELEMETRY.md); the ingest endpoint that enforces it is
+ * public at telemetry-worker/. This module honors four invariants:
+ *
+ * 1. Zero hot-path cost: recording is an in-memory increment. Disk writes are
+ *    a tiny synchronous append at process exit (works under `process.exit()`,
+ *    where `beforeExit` never fires); network sends happen opportunistically
+ *    (startup of long-running commands, daemon interval, bounded await at the
+ *    end of install/init) and are fire-and-forget everywhere else.
+ * 2. Zero stdout: stdio is the MCP protocol channel. Notices and debug output
+ *    go to stderr only.
+ * 3. Off is off: when disabled, nothing is recorded, nothing is sent, and no
+ *    socket is opened — there is no "opted out" ping. Turning telemetry off
+ *    also deletes any buffered, unsent data.
+ * 4. Fail silent: offline, endpoint down, disk full — every failure mode is
+ *    silence, never a retry loop, never an error surfaced to the user/agent.
+ *
+ * Usage counts aggregate locally into per-day rollups; only *completed* (UTC)
+ * days are sent, so volume scales with active machines, not with tool calls.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Telemetry = exports.TELEMETRY_DOCS = exports.TELEMETRY_ENDPOINT = void 0;
+exports.bucketFileCount = bucketFileCount;
+exports.bucketDuration = bucketDuration;
+exports.recordIndexEvent = recordIndexEvent;
+exports.getTelemetry = getTelemetry;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const crypto_1 = require("crypto");
+exports.TELEMETRY_ENDPOINT = 'https://telemetry.getcodegraph.com/v1/events';
+exports.TELEMETRY_DOCS = 'https://github.com/smdnkB/cgraphx/blob/main/TELEMETRY.md';
+// v2: dropped the `sqlite_backend` field from the `index` event — node:sqlite is
+// now the only backend (the better-sqlite3-native / wasm-fallback split is gone),
+// so the value was a constant carrying no signal. See TELEMETRY.md.
+const SCHEMA_VERSION = 2;
+const MAX_BUFFER_BYTES = 256 * 1024;
+const MAX_EVENTS_PER_REQUEST = 100;
+const DEFAULT_FLUSH_TIMEOUT_MS = 1500;
+/** A crashed sender's claimed file is merged back after this long. */
+const STALE_CLAIM_MS = 60 * 60_000;
+/** Coarse buckets — exact counts are deliberately not collected. */
+function bucketFileCount(n) {
+    if (n < 100)
+        return '<100';
+    if (n < 1000)
+        return '100-1k';
+    if (n < 10000)
+        return '1k-10k';
+    return '10k+';
+}
+function bucketDuration(ms) {
+    if (ms < 10_000)
+        return '<10s';
+    if (ms < 60_000)
+        return '10-60s';
+    if (ms < 300_000)
+        return '1-5m';
+    return '5m+';
+}
+/**
+ * Shared "a full index completed" event (CLI init/index + installer local
+ * init): language names and coarse buckets only — never paths, file names,
+ * or exact counts. Structurally typed so callers don't need engine imports.
+ */
+function recordIndexEvent(cg, result) {
+    try {
+        const languages = Object.entries(cg.getStats().filesByLanguage)
+            .filter(([, count]) => count > 0)
+            .map(([lang]) => lang);
+        getTelemetry().recordLifecycle('index', {
+            languages,
+            file_count_bucket: bucketFileCount(result.filesIndexed),
+            duration_bucket: bucketDuration(result.durationMs),
+        });
+    }
+    catch {
+        /* telemetry must never break indexing */
+    }
+}
+// One process-level 'exit' listener for ALL instances (in practice: the
+// singleton) — N instances must not mean N listeners on process.
+const exitInstances = new Set();
+let exitListenerRegistered = false;
+function registerForExit(instance) {
+    exitInstances.add(instance);
+    if (!exitListenerRegistered) {
+        exitListenerRegistered = true;
+        // 'exit' fires under process.exit() too (unlike beforeExit); handlers must
+        // be synchronous — persistSync is a single small file write.
+        process.on('exit', () => {
+            for (const i of exitInstances)
+                i.persistSync();
+        });
+    }
+}
+class Telemetry {
+    dir;
+    fetchImpl;
+    now;
+    env;
+    writeStderr;
+    counts = new Map();
+    events = [];
+    installExitHook;
+    exitHookInstalled = false;
+    configCache; // undefined = not read yet
+    intervalHandle = null;
+    constructor(opts = {}) {
+        this.dir = opts.dir ?? path.join(os.homedir(), '.cgraphx');
+        this.fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+        this.now = opts.now ?? (() => new Date());
+        this.env = opts.env ?? process.env;
+        this.writeStderr = opts.stderr ?? ((line) => process.stderr.write(line));
+        this.installExitHook = opts.installExitHook ?? true;
+    }
+    // ---------------------------------------------------------------- consent
+    get configPath() {
+        return path.join(this.dir, 'telemetry.json');
+    }
+    get queuePath() {
+        return path.join(this.dir, 'telemetry-queue.jsonl');
+    }
+    /**
+     * Resolution order (first match wins) — keep in sync with TELEMETRY.md:
+     * DO_NOT_TRACK=1 > CGRAPHX_TELEMETRY=0|1 > stored config > default on.
+     */
+    getStatus() {
+        const config = this.readConfig();
+        const machineId = config?.machine_id ?? null;
+        const dnt = this.env.DO_NOT_TRACK;
+        if (dnt !== undefined && dnt !== '' && dnt !== '0' && dnt.toLowerCase() !== 'false') {
+            return { enabled: false, decidedBy: 'DO_NOT_TRACK', machineId, configPath: this.configPath };
+        }
+        const forced = this.env.CGRAPHX_TELEMETRY;
+        if (forced !== undefined && forced !== '') {
+            const on = forced !== '0' && forced.toLowerCase() !== 'false';
+            return { enabled: on, decidedBy: 'CGRAPHX_TELEMETRY', machineId, configPath: this.configPath };
+        }
+        if (config) {
+            return { enabled: config.enabled, decidedBy: 'config', machineId, configPath: this.configPath };
+        }
+        return { enabled: true, decidedBy: 'default', machineId, configPath: this.configPath };
+    }
+    isEnabled() {
+        return this.getStatus().enabled;
+    }
+    /**
+     * Persist an explicit user choice (installer toggle or `codegraph
+     * telemetry on|off`). Turning telemetry off also deletes any buffered,
+     * unsent data — off means off.
+     */
+    setEnabled(enabled, source) {
+        const existing = this.readConfig();
+        this.writeConfig({
+            enabled,
+            machine_id: existing?.machine_id ?? (0, crypto_1.randomUUID)(),
+            consent_source: source,
+            first_run_notice_shown: true,
+            updated_at: this.now().toISOString(),
+        });
+        if (!enabled) {
+            try {
+                fs.rmSync(this.queuePath, { force: true });
+            }
+            catch { /* fail silent */ }
+        }
+    }
+    /** True once any consent decision (or the first-run notice) is on disk. */
+    hasStoredChoice() {
+        return this.readConfig() !== null;
+    }
+    // -------------------------------------------------------------- recording
+    /** In-memory increment — safe on the MCP tool-call hot path. */
+    recordUsage(kind, name, ok, client) {
+        if (!this.isEnabled())
+            return;
+        const day = this.utcDay();
+        const cn = client?.name?.slice(0, 64);
+        const cv = client?.version?.slice(0, 32);
+        const key = [day, kind, name, cn ?? '', cv ?? ''].join('');
+        const line = this.counts.get(key);
+        if (line) {
+            line.c += 1;
+            if (!ok)
+                line.e += 1;
+        }
+        else {
+            const fresh = { v: SCHEMA_VERSION, d: day, k: kind, n: name.slice(0, 64), c: 1, e: ok ? 0 : 1 };
+            if (cn)
+                fresh.cn = cn;
+            if (cv)
+                fresh.cv = cv;
+            this.counts.set(key, fresh);
+        }
+        this.ensureExitHook();
+    }
+    /** install / index / uninstall — buffered like everything else. */
+    recordLifecycle(event, props) {
+        if (!this.isEnabled())
+            return;
+        this.events.push({ v: SCHEMA_VERSION, ev: event, ts: this.now().toISOString(), props });
+        this.ensureExitHook();
+    }
+    // ---------------------------------------------------------------- sending
+    /**
+     * Fire-and-forget send of everything sendable. Never throws, never logs
+     * above debug. Safe to call at startup of long-running commands.
+     */
+    maybeFlush() {
+        void this.flushNow().catch(() => { });
+    }
+    /**
+     * Drain in-memory state to the buffer, then send completed-day rollups and
+     * lifecycle events. Bounded by `timeoutMs`; leftovers stay buffered for the
+     * next process. Awaited only where latency is invisible (install/init).
+     */
+    async flushNow(timeoutMs = DEFAULT_FLUSH_TIMEOUT_MS) {
+        if (!this.isEnabled())
+            return;
+        try {
+            this.persistSync();
+            this.recoverStaleClaims();
+            const claim = this.claimQueue();
+            if (!claim)
+                return;
+            const { claimPath, lines } = claim;
+            const today = this.utcDay();
+            const sendable = [];
+            const keep = [];
+            for (const line of lines) {
+                if ('ev' in line)
+                    sendable.push(line);
+                else if (line.d < today)
+                    sendable.push(line);
+                else
+                    keep.push(line);
+            }
+            let failed = [];
+            if (sendable.length > 0) {
+                // Consent gate: the one-time notice precedes the FIRST bytes that
+                // ever leave the machine (and mints the machine id). Recording only
+                // buffers locally, so it stays silent — this lets the installer show
+                // its explicit consent toggle before any notice can fire, instead of
+                // the preAction usage count pre-empting it. An explicit installer/CLI
+                // choice sets first_run_notice_shown and suppresses this permanently.
+                this.firstRunNotice();
+                failed = await this.send(sendable, timeoutMs);
+            }
+            // Whatever didn't go out returns to the queue (append — writers may
+            // have created a fresh queue file while we held the claim).
+            const back = [...failed, ...keep];
+            if (back.length > 0)
+                this.appendLines(back);
+            try {
+                fs.rmSync(claimPath, { force: true });
+            }
+            catch { /* fail silent */ }
+        }
+        catch {
+            /* fail silent */
+        }
+    }
+    /**
+     * Periodic flush for long-lived processes (MCP daemon / serve). Unref'd so
+     * it never keeps the process alive.
+     */
+    startInterval(everyMs = 6 * 60 * 60_000) {
+        if (this.intervalHandle || !this.isEnabled())
+            return;
+        this.maybeFlush();
+        this.intervalHandle = setInterval(() => this.maybeFlush(), everyMs);
+        this.intervalHandle.unref();
+    }
+    stopInterval() {
+        if (this.intervalHandle) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = null;
+        }
+    }
+    // -------------------------------------------------------------- internals
+    utcDay() {
+        return this.now().toISOString().slice(0, 10);
+    }
+    readConfig() {
+        if (this.configCache !== undefined)
+            return this.configCache;
+        try {
+            const raw = JSON.parse(fs.readFileSync(this.configPath, 'utf8'));
+            this.configCache = typeof raw.machine_id === 'string' && typeof raw.enabled === 'boolean' ? raw : null;
+        }
+        catch {
+            this.configCache = null;
+        }
+        return this.configCache;
+    }
+    writeConfig(config) {
+        try {
+            fs.mkdirSync(this.dir, { recursive: true, mode: 0o700 });
+            fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2) + '\n');
+            this.configCache = config;
+        }
+        catch {
+            /* fail silent */
+        }
+    }
+    /**
+     * Default-on consent is gated by a one-time stderr notice (interactive
+     * installs record their choice explicitly and never reach this).
+     */
+    firstRunNotice() {
+        const config = this.readConfig();
+        if (config?.first_run_notice_shown)
+            return;
+        if (!config) {
+            this.writeConfig({
+                enabled: true,
+                machine_id: (0, crypto_1.randomUUID)(),
+                consent_source: 'default-notice',
+                first_run_notice_shown: true,
+                updated_at: this.now().toISOString(),
+            });
+        }
+        else {
+            this.writeConfig({ ...config, first_run_notice_shown: true, updated_at: this.now().toISOString() });
+        }
+        this.writeStderr(`cgraphx collects anonymous usage stats (no code, paths, or names) — ` +
+            `"cgraphx telemetry off" or CGRAPHX_TELEMETRY=0 disables. Details: ${exports.TELEMETRY_DOCS}\n`);
+    }
+    /**
+     * Synchronous, tiny, exit-safe: drain in-memory deltas to the JSONL queue.
+     * Runs on `process.on('exit')`, so it must never be async or slow.
+     */
+    persistSync() {
+        if (this.counts.size === 0 && this.events.length === 0)
+            return;
+        const lines = [...this.counts.values(), ...this.events];
+        this.counts.clear();
+        this.events = [];
+        // Re-check at persist time: `codegraph telemetry off` mid-process must not
+        // have its own invocation resurrect the queue file at exit.
+        if (!this.isEnabled())
+            return;
+        this.appendLines(lines);
+    }
+    appendLines(lines) {
+        try {
+            fs.mkdirSync(this.dir, { recursive: true, mode: 0o700 });
+            const payload = lines.map((l) => JSON.stringify(l)).join('\n') + '\n';
+            // Cap the buffer: drop oldest lines first (telemetry is best-effort —
+            // bounded disk use beats completeness).
+            let existing = '';
+            try {
+                existing = fs.readFileSync(this.queuePath, 'utf8');
+            }
+            catch { /* no queue yet */ }
+            let combined = existing + payload;
+            if (combined.length > MAX_BUFFER_BYTES) {
+                combined = combined.slice(combined.length - MAX_BUFFER_BYTES);
+                combined = combined.slice(combined.indexOf('\n') + 1); // drop the partial first line
+            }
+            fs.writeFileSync(this.queuePath, combined);
+        }
+        catch {
+            /* fail silent */
+        }
+    }
+    /**
+     * Atomically claim the queue for sending (rename). Concurrent processes
+     * can't double-send; a crash mid-send leaves a claim file that
+     * `recoverStaleClaims` merges back after an hour.
+     */
+    claimQueue() {
+        const claimPath = path.join(this.dir, `telemetry-queue.sending.${process.pid}.jsonl`);
+        try {
+            fs.renameSync(this.queuePath, claimPath);
+        }
+        catch {
+            return null; // no queue, or another process just claimed it
+        }
+        const lines = [];
+        try {
+            for (const raw of fs.readFileSync(claimPath, 'utf8').split('\n')) {
+                if (!raw.trim())
+                    continue;
+                try {
+                    const parsed = JSON.parse(raw);
+                    if (parsed && typeof parsed === 'object' && parsed.v === SCHEMA_VERSION)
+                        lines.push(parsed);
+                }
+                catch {
+                    /* skip corrupt line */
+                }
+            }
+        }
+        catch {
+            /* unreadable claim — treat as empty; file removed by caller */
+        }
+        return { claimPath, lines };
+    }
+    recoverStaleClaims() {
+        try {
+            const cutoff = this.now().getTime() - STALE_CLAIM_MS;
+            for (const name of fs.readdirSync(this.dir)) {
+                if (!name.startsWith('telemetry-queue.sending.'))
+                    continue;
+                const full = path.join(this.dir, name);
+                try {
+                    if (fs.statSync(full).mtimeMs < cutoff) {
+                        const content = fs.readFileSync(full, 'utf8');
+                        fs.rmSync(full, { force: true });
+                        if (content.trim())
+                            fs.appendFileSync(this.queuePath, content.endsWith('\n') ? content : content + '\n');
+                    }
+                }
+                catch {
+                    /* fail silent */
+                }
+            }
+        }
+        catch {
+            /* fail silent */
+        }
+    }
+    /** Returns the lines that did NOT make it out (to be re-queued). */
+    async send(lines, timeoutMs) {
+        const config = this.readConfig();
+        if (!config)
+            return [];
+        const events = lines.map((line) => 'ev' in line
+            ? { event: line.ev, ts: line.ts, props: line.props }
+            : {
+                event: 'usage_rollup',
+                ts: `${line.d}T12:00:00.000Z`,
+                props: {
+                    kind: line.k,
+                    name: line.n,
+                    count: line.c,
+                    error_count: line.e,
+                    ...(line.cn ? { client_name: line.cn } : {}),
+                    ...(line.cv ? { client_version: line.cv } : {}),
+                },
+            });
+        const envelope = {
+            machine_id: config.machine_id,
+            codegraph_version: this.packageVersion(),
+            os: process.platform,
+            arch: process.arch,
+            node_major: parseInt(process.versions.node.split('.')[0] ?? '0', 10),
+            ci: this.env.CI !== undefined && this.env.CI !== '' && this.env.CI !== '0' && this.env.CI !== 'false',
+            schema_version: SCHEMA_VERSION,
+        };
+        const endpoint = this.env.CGRAPHX_TELEMETRY_ENDPOINT || exports.TELEMETRY_ENDPOINT;
+        for (let i = 0; i < events.length; i += MAX_EVENTS_PER_REQUEST) {
+            const chunk = events.slice(i, i + MAX_EVENTS_PER_REQUEST);
+            const body = JSON.stringify({ ...envelope, events: chunk });
+            this.debug(`POST ${endpoint} (${chunk.length} events)`);
+            try {
+                // Any response — 204, 4xx, anything — is final. No retries.
+                await this.fetchImpl(endpoint, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json' },
+                    body,
+                    signal: AbortSignal.timeout(timeoutMs),
+                });
+            }
+            catch (err) {
+                this.debug(`send failed: ${String(err)}`);
+                return lines.slice(i); // network failure: re-queue this chunk + the rest
+            }
+        }
+        return [];
+    }
+    packageVersion() {
+        try {
+            // dist/telemetry/index.js → ../../package.json (same layout in src/ for tests via tsx)
+            const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', '..', 'package.json'), 'utf8'));
+            return pkg.version ?? '0.0.0';
+        }
+        catch {
+            return '0.0.0';
+        }
+    }
+    ensureExitHook() {
+        if (this.exitHookInstalled || !this.installExitHook)
+            return;
+        this.exitHookInstalled = true;
+        registerForExit(this);
+    }
+    debug(msg) {
+        if (this.env.CGRAPHX_TELEMETRY_DEBUG === '1') {
+            this.writeStderr(`[codegraph telemetry] ${msg}\n`);
+        }
+    }
+}
+exports.Telemetry = Telemetry;
+// Process-wide singleton — app code goes through this; tests construct their own.
+let singleton = null;
+function getTelemetry() {
+    if (!singleton)
+        singleton = new Telemetry();
+    return singleton;
+}
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBH,0CAKC;AAED,wCAKC;AAOD,4CAgBC;AA6cD,oCAGC;AAzgBD,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,mCAAoC;AAEvB,QAAA,kBAAkB,GAAG,8CAA8C,CAAC;AACpE,QAAA,cAAc,GAAG,0DAA0D,CAAC;AAEzF,iFAAiF;AACjF,kFAAkF;AAClF,oEAAoE;AACpE,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC;AACpC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,sEAAsE;AACtE,MAAM,cAAc,GAAG,EAAE,GAAG,MAAM,CAAC;AAKnC,oEAAoE;AACpE,SAAgB,eAAe,CAAC,CAAS;IACvC,IAAI,CAAC,GAAG,GAAG;QAAE,OAAO,MAAM,CAAC;IAC3B,IAAI,CAAC,GAAG,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,CAAC,GAAG,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,MAAM,CAAC;IAC/B,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,EAAE,GAAG,OAAO;QAAE,OAAO,MAAM,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAC9B,EAA+D,EAC/D,MAAoD;IAEpD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,eAAe,CAAC;aAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACzB,YAAY,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE;YACtC,SAAS;YACT,iBAAiB,EAAE,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC;YACvD,eAAe,EAAE,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;IAC3C,CAAC;AACH,CAAC;AAqDD,wEAAwE;AACxE,iEAAiE;AACjE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAa,CAAC;AAC3C,IAAI,sBAAsB,GAAG,KAAK,CAAC;AACnC,SAAS,eAAe,CAAC,QAAmB;IAC1C,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,sBAAsB,GAAG,IAAI,CAAC;QAC9B,2EAA2E;QAC3E,6DAA6D;QAC7D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACtB,KAAK,MAAM,CAAC,IAAI,aAAa;gBAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAa,SAAS;IACH,GAAG,CAAS;IACZ,SAAS,CAA0B;IACnC,GAAG,CAAa;IAChB,GAAG,CAAoB;IACvB,WAAW,CAAyB;IAE7C,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IACtC,MAAM,GAAgB,EAAE,CAAC;IAChB,eAAe,CAAU;IAClC,iBAAiB,GAAG,KAAK,CAAC;IAC1B,WAAW,CAAgC,CAAC,2BAA2B;IACvE,cAAc,GAA0B,IAAI,CAAC;IAErD,YAAY,OAAyB,EAAE;QACrC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC;QACpD,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IACtD,CAAC;IAED,2EAA2E;IAE3E,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;QAClC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;YACpF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/F,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC1C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAC1C,MAAM,EAAE,GAAG,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACjG,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QAClG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACzF,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAgB,EAAE,MAA2B;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC;YACf,OAAO;YACP,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,IAAA,mBAAU,GAAE;YAChD,cAAc,EAAE,MAAM;YACtB,sBAAsB,EAAE,IAAI;YAC5B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC;gBAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC;IACpC,CAAC;IAED,2EAA2E;IAE3E,gEAAgE;IAChE,WAAW,CAAC,IAAe,EAAE,IAAY,EAAE,EAAW,EAAE,MAAmB;QACzE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YACZ,IAAI,CAAC,EAAE;gBAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAc,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3G,IAAI,EAAE;gBAAE,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;YACtB,IAAI,EAAE;gBAAE,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,mEAAmE;IACnE,eAAe,CAAC,KAAqB,EAAE,KAA8B;QACnE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,2EAA2E;IAE3E;;;OAGG;IACH,UAAU;QACR,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAqB,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,YAAoB,wBAAwB;QACzD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QAC9B,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAiB,EAAE,CAAC;YAClC,MAAM,IAAI,GAAiB,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,IAAI,IAAI;oBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;qBACjC,IAAI,IAAI,CAAC,CAAC,GAAG,KAAK;oBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;oBACxC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,IAAI,MAAM,GAAiB,EAAE,CAAC;YAC9B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,kEAAkE;gBAClE,oEAAoE;gBACpE,qEAAqE;gBACrE,qEAAqE;gBACrE,sEAAsE;gBACtE,sEAAsE;gBACtE,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAChD,CAAC;YACD,oEAAoE;YACpE,4DAA4D;YAC5D,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC;gBAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,UAAkB,CAAC,GAAG,EAAE,GAAG,MAAM;QAC7C,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QACrD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;QACpE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,YAAY;QACV,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,2EAA2E;IAEnE,MAAM;QACZ,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAe,CAAC;YAC/E,IAAI,CAAC,WAAW,GAAG,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACzG,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,WAAW,CAAC,MAAkB;QACpC,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACzD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC1E,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,cAAc;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,MAAM,EAAE,sBAAsB;YAAE,OAAO;QAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,WAAW,CAAC;gBACf,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,IAAA,mBAAU,GAAE;gBACxB,cAAc,EAAE,gBAAgB;gBAChC,sBAAsB,EAAE,IAAI;gBAC5B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,CAAC,WAAW,CACd,sEAAsE;YACtE,qEAAqE,sBAAc,IAAI,CACxF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/D,MAAM,KAAK,GAAiB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,2EAA2E;QAC3E,4DAA4D;QAC5D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QAC9B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAEO,WAAW,CAAC,KAAmB;QACrC,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACtE,sEAAsE;YACtE,wCAAwC;YACxC,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC;gBAAC,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YACxF,IAAI,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;YAClC,IAAI,QAAQ,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBACvC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;gBAC9D,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B;YACvF,CAAC;YACD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,UAAU;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,2BAA2B,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;QACtF,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,CAAC,+CAA+C;QAC9D,CAAC;QACD,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;oBAAE,SAAS;gBAC1B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;oBAC7C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,CAAC,KAAK,cAAc;wBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9F,CAAC;gBAAC,MAAM,CAAC;oBACP,uBAAuB;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAEO,kBAAkB;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC;YACrD,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,0BAA0B,CAAC;oBAAE,SAAS;gBAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC;oBACH,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC;wBACvC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;wBAC9C,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;wBACjC,IAAI,OAAO,CAAC,IAAI,EAAE;4BAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;oBAC3G,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,iBAAiB;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED,oEAAoE;IAC5D,KAAK,CAAC,IAAI,CAAC,KAAmB,EAAE,SAAiB;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,IAAI,IAAI,IAAI;YACV,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;YACpD,CAAC,CAAC;gBACE,KAAK,EAAE,cAAc;gBACrB,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,gBAAgB;gBAC7B,KAAK,EAAE;oBACL,IAAI,EAAE,IAAI,CAAC,CAAC;oBACZ,IAAI,EAAE,IAAI,CAAC,CAAC;oBACZ,KAAK,EAAE,IAAI,CAAC,CAAC;oBACb,WAAW,EAAE,IAAI,CAAC,CAAC;oBACnB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChD;aACF,CACN,CAAC;QACF,MAAM,QAAQ,GAAG;YACf,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,iBAAiB,EAAE,IAAI,CAAC,cAAc,EAAE;YACxC,EAAE,EAAE,OAAO,CAAC,QAAQ;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;YACpE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,OAAO;YACrG,cAAc,EAAE,cAAc;SAC/B,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,0BAA0B,IAAI,0BAAkB,CAAC;QAC3E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,sBAAsB,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,sBAAsB,CAAC,CAAC;YAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,KAAK,CAAC,QAAQ,QAAQ,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC,CAAC;YACxD,IAAI,CAAC;gBACH,4DAA4D;gBAC5D,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE;oBAC7B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI;oBACJ,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;iBACvC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,kDAAkD;YAC3E,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC;YACH,uFAAuF;YACvF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC;YAC1H,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO;QAC5D,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,eAAe,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,GAAW;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,EAAE,CAAC;YAC7C,IAAI,CAAC,WAAW,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF;AAnYD,8BAmYC;AAED,kFAAkF;AAClF,IAAI,SAAS,GAAqB,IAAI,CAAC;AAEvC,SAAgB,YAAY;IAC1B,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/timeline/bash-semantics.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Bash command semantic classification (spec §4.2 / B-3).
+ *
+ * PostToolUse Bash events carry a `command` string in tool_args and a stdout
+ * blob in tool_response. Most commands are noise (ls / cat / grep / git status),
+ * but four categories carry high-signal structure worth surfacing as discrete
+ * fields instead of a raw stdout blob:
+ *
+ *   - test       — vitest / jest / npm test / pytest / go test / cargo test ...
+ *                  parse `passing` / `failing` / `Tests run` / `ok` / `FAILED`
+ *   - build      — npm run build / tsc / webpack / mvn package / cargo build ...
+ *                  exit_code 0 → pass=1, fail=0; otherwise pass=0, fail=1
+ *   - lint       — eslint / prettier / ruff / golangci-lint ...
+ *                  parse `error` / `warning` / `problem`
+ *   - git_write  — git push / git commit
+ *                  exit_code 0 → pass=1, fail=0
+ *
+ * The category is decided by COMMAND prefix match (the tool the user invoked);
+ * pass/fail counts come from stdout parsing for the category's known formats.
+ * If the category matches but the stdout format is unknown, we still return
+ * the category — pass/fail stay undefined (caller omits them).
+ *
+ * Boundary with git_commit events: a `git commit` made in Bash is classified
+ * here as `git_write` (marks "user pushed/committed via shell"); the actual
+ * commit metadata (hash / insertions / deletions) is captured separately by
+ * the post-commit hook's git_commit event. The two are complementary, not
+ * overlapping — this category never duplicates commit line counts.
+ *
+ * Returns null for any command that doesn't match a known category — callers
+ * silently fall back to the plain stdout_preview Bash summary.
+ */
+export type BashCategory = 'test' | 'build' | 'lint' | 'git_write';
+export interface BashSemantics {
+    category: BashCategory;
+    pass?: number;
+    fail?: number;
+    duration_ms?: number;
+}
+export interface DetectBashSemanticsInput {
+    command: string;
+    stdout?: string;
+    exit_code?: number;
+}
+/**
+ * Detect the semantic category of a Bash command and parse structured
+ * pass/fail counts from stdout when the format is known.
+ *
+ * Returns null when the command doesn't match any recognized category —
+ * callers should fall back to the plain Bash stdout_preview summary.
+ */
+export declare function detectBashSemantics(input: DetectBashSemanticsInput): BashSemantics | null;
+//# sourceMappingURL=bash-semantics.d.ts.map

package/dist/timeline/bash-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-semantics.d.ts","sourceRoot":"","sources":["../../src/timeline/bash-semantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,aAAa,GAAG,IAAI,CAsDzF"}