@ai-studio-3d/vyasa 0.1.0

package/dist/core/share/scrub.js

@@ -0,0 +1,198 @@
+/**
+ * Surgical confidentiality scrubber for Claude Code session JSONL, run on export.
+ *
+ * Primary effect (verified against real sessions): drops Claude Code's internal
+ * state records — `file-history-snapshot` (file backups), `last-prompt`,
+ * `ai-title`, etc. — which ship verbatim and are pure machine-state (and bloat).
+ * Defensively also strips sensitive-marker `<system-reminder>` spans IF any are
+ * persisted; note the CLAUDE.md/MEMORY.md/env injection is runtime-only and is
+ * NOT normally written to the transcript, so that path rarely fires in practice.
+ *
+ * Preserves the conversation, tool calls, the uuid/parentUuid chain (so `/resume`
+ * stays valid), attachments, and benign system-reminders (e.g. plan echoes).
+ * Operates at the raw-record level — NOT via the lossy canonical parsers.
+ */
+// Internal Claude Code state records, standalone (not part of the dialogue chain).
+const INTERNAL_DROP_TYPES = new Set([
+    'ai-title',
+    'agent-name',
+    'last-prompt',
+    'permission-mode',
+    'file-history-snapshot',
+    'queue-operation',
+]);
+// A <system-reminder> span is sensitive (→ stripped) only if it carries one of
+// these markers. Anything else (plan echoes, task reminders, tool guidance) is
+// benign and kept, so plans and useful context survive replication.
+const SENSITIVE_SR_MARKERS = [
+    '# claudeMd',
+    'Memory Index',
+    '# userEmail',
+    '# currentDate',
+    'This memory is', // recalled-memory staleness reminder
+];
+const SR_RE = /<system-reminder>[\s\S]*?<\/system-reminder>/g;
+const REDACTED = '[redacted before sharing]';
+export function scrubClaudeJsonl(raw, opts = {}) {
+    const redact = new Set(opts.redactUuids ?? []);
+    const report = {
+        metaRecordsDropped: {},
+        systemReminderSpansStripped: 0,
+        recordsEmptiedAndDropped: 0,
+        redactedRecords: 0,
+        bytesBefore: Buffer.byteLength(raw, 'utf8'),
+        bytesAfter: 0,
+    };
+    const dropParent = new Map(); // dropped uuid → its parentUuid
+    const kept = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        const type = typeof rec['type'] === 'string' ? rec['type'] : '';
+        const uuid = typeof rec['uuid'] === 'string' ? rec['uuid'] : '';
+        const parentUuid = (typeof rec['parentUuid'] === 'string' ? rec['parentUuid'] : null);
+        // 1. Drop internal-state record types.
+        if (INTERNAL_DROP_TYPES.has(type)) {
+            bump(report.metaRecordsDropped, type);
+            if (uuid)
+                dropParent.set(uuid, parentUuid);
+            continue;
+        }
+        // 2. Drop isMeta-flagged records (injected reminders).
+        if (rec['isMeta'] === true) {
+            bump(report.metaRecordsDropped, 'isMeta');
+            if (uuid)
+                dropParent.set(uuid, parentUuid);
+            continue;
+        }
+        // 3. Conversation records: strip sensitive SR spans (or redact in place).
+        if (type === 'user' || type === 'assistant' || type === 'system') {
+            const verdict = processConversationRecord(rec, type, uuid !== '' && redact.has(uuid), report);
+            if (verdict === 'drop') {
+                report.recordsEmptiedAndDropped += 1;
+                if (uuid)
+                    dropParent.set(uuid, parentUuid);
+                continue;
+            }
+            kept.push(rec);
+            continue;
+        }
+        // attachment + anything else not internal → keep verbatim (may be real content).
+        kept.push(rec);
+    }
+    // 4. Chain repair: re-point each kept record's parentUuid through dropped
+    //    ancestors to the nearest surviving record (or null).
+    for (const rec of kept) {
+        let p = (typeof rec['parentUuid'] === 'string' ? rec['parentUuid'] : null);
+        while (p != null && dropParent.has(p)) {
+            p = dropParent.get(p) ?? null;
+        }
+        if ('parentUuid' in rec)
+            rec['parentUuid'] = p;
+    }
+    const cleaned = kept.map((r) => JSON.stringify(r)).join('\n') + (kept.length ? '\n' : '');
+    report.bytesAfter = Buffer.byteLength(cleaned, 'utf8');
+    return { cleaned, report };
+}
+function bump(map, key) {
+    map[key] = (map[key] ?? 0) + 1;
+}
+/** Strip only sensitive-marker <system-reminder> spans; benign ones survive. */
+function stripSensitiveSR(text) {
+    let stripped = 0;
+    const out = text.replace(SR_RE, (span) => {
+        if (SENSITIVE_SR_MARKERS.some((m) => span.includes(m))) {
+            stripped += 1;
+            return '';
+        }
+        return span;
+    });
+    return { text: out, stripped };
+}
+function redactContent(content) {
+    if (typeof content === 'string')
+        return REDACTED;
+    if (Array.isArray(content)) {
+        return content.map((block) => {
+            if (!block || typeof block !== 'object')
+                return block;
+            const b = { ...block };
+            if (b['type'] === 'text')
+                b['text'] = REDACTED;
+            else if (b['type'] === 'tool_result')
+                b['content'] = REDACTED;
+            else if (b['type'] === 'tool_use')
+                b['input'] = { redacted: true };
+            return b;
+        });
+    }
+    return content;
+}
+/** Returns 'drop' if the record has no meaningful content left, else 'keep' (mutates rec). */
+function processConversationRecord(rec, type, redact, report) {
+    // System records carry content as a top-level string, not under message.
+    if (type === 'system') {
+        if (redact) {
+            rec['content'] = REDACTED;
+            report.redactedRecords += 1;
+            return 'keep';
+        }
+        if (typeof rec['content'] === 'string') {
+            const { text, stripped } = stripSensitiveSR(rec['content']);
+            report.systemReminderSpansStripped += stripped;
+            rec['content'] = text;
+            if (!text.trim())
+                return 'drop';
+        }
+        return 'keep';
+    }
+    const message = rec['message'];
+    if (!message)
+        return 'keep';
+    if (redact) {
+        message.content = redactContent(message.content);
+        report.redactedRecords += 1;
+        return 'keep';
+    }
+    const content = message.content;
+    if (typeof content === 'string') {
+        const { text, stripped } = stripSensitiveSR(content);
+        report.systemReminderSpansStripped += stripped;
+        message.content = text;
+        return text.trim() ? 'keep' : 'drop';
+    }
+    if (Array.isArray(content)) {
+        const out = [];
+        for (const block of content) {
+            if (!block || typeof block !== 'object') {
+                out.push(block);
+                continue;
+            }
+            const b = block;
+            if (b['type'] === 'text' && typeof b['text'] === 'string') {
+                const { text, stripped } = stripSensitiveSR(b['text']);
+                report.systemReminderSpansStripped += stripped;
+                if (text.trim()) {
+                    b['text'] = text;
+                    out.push(b);
+                }
+                // else: drop the now-empty (pure-injection) text block
+            }
+            else {
+                out.push(block); // tool_use / tool_result / thinking / etc. kept
+            }
+        }
+        message.content = out;
+        return out.length > 0 ? 'keep' : 'drop';
+    }
+    return 'keep';
+}
+//# sourceMappingURL=scrub.js.map

package/dist/core/share/scrub.js.map

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

package/dist/core/share/tar.d.ts

@@ -0,0 +1,12 @@
+export interface TarEntryIn {
+    name: string;
+    data: Buffer;
+    mtimeMs: number;
+}
+export interface TarEntryOut {
+    name: string;
+    data: Buffer;
+}
+export declare function tarPack(entries: TarEntryIn[]): Buffer;
+export declare function tarUnpack(buf: Buffer): TarEntryOut[];
+//# sourceMappingURL=tar.d.ts.map

package/dist/core/share/tar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar.d.ts","sourceRoot":"","sources":["../../../src/core/share/tar.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAmCD,wBAAgB,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAUrD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CA6BpD"}

package/dist/core/share/tar.js

@@ -0,0 +1,78 @@
+// Minimal POSIX (USTAR) tar writer + reader. Avoids a dependency for a small, well-defined format.
+// Supports only what we need: regular files with names < 100 chars, sizes < 8 GB.
+function octalField(n, len) {
+    // Right-aligned, zero-padded, null-terminated octal. Last byte is '\0'.
+    const s = n.toString(8).padStart(len - 1, '0');
+    const b = Buffer.alloc(len, 0);
+    b.write(s, 0, 'ascii');
+    return b;
+}
+function buildHeader(name, size, mtimeSec) {
+    if (Buffer.byteLength(name, 'utf8') > 100) {
+        throw new Error(`tar: filename too long (max 100 bytes): ${name}`);
+    }
+    const buf = Buffer.alloc(512, 0);
+    buf.write(name, 0, 100, 'utf8');
+    octalField(0o644, 8).copy(buf, 100); // mode
+    octalField(0, 8).copy(buf, 108); // uid
+    octalField(0, 8).copy(buf, 116); // gid
+    octalField(size, 12).copy(buf, 124); // size
+    octalField(mtimeSec, 12).copy(buf, 136); // mtime
+    buf.fill(0x20, 148, 156); // checksum: spaces during calculation
+    buf[156] = 0x30; // typeflag '0' = regular file
+    buf.write('ustar\0', 257, 6, 'ascii');
+    buf.write('00', 263, 2, 'ascii');
+    let sum = 0;
+    for (let i = 0; i < 512; i++)
+        sum += buf[i];
+    // Checksum format: 6 octal digits, null byte, space (8 bytes total)
+    const sumStr = sum.toString(8).padStart(6, '0');
+    buf.write(sumStr, 148, 6, 'ascii');
+    buf[154] = 0x00;
+    buf[155] = 0x20;
+    return buf;
+}
+export function tarPack(entries) {
+    const parts = [];
+    for (const e of entries) {
+        parts.push(buildHeader(e.name, e.data.length, Math.floor(e.mtimeMs / 1000)));
+        parts.push(e.data);
+        const padLen = (512 - (e.data.length % 512)) % 512;
+        if (padLen > 0)
+            parts.push(Buffer.alloc(padLen, 0));
+    }
+    parts.push(Buffer.alloc(1024, 0)); // end-of-archive: two zero blocks
+    return Buffer.concat(parts);
+}
+export function tarUnpack(buf) {
+    const entries = [];
+    let offset = 0;
+    while (offset + 512 <= buf.length) {
+        const header = buf.subarray(offset, offset + 512);
+        // End-of-archive: a 512-byte zero block
+        let allZero = true;
+        for (let i = 0; i < 512; i++) {
+            if (header[i] !== 0) {
+                allZero = false;
+                break;
+            }
+        }
+        if (allZero)
+            break;
+        const nameRaw = header.toString('utf8', 0, 100);
+        const nullIdx = nameRaw.indexOf('\0');
+        const name = nullIdx >= 0 ? nameRaw.slice(0, nullIdx) : nameRaw;
+        const sizeStr = header.toString('ascii', 124, 136).split('\0')[0].trim();
+        const size = parseInt(sizeStr, 8);
+        if (!Number.isFinite(size) || size < 0) {
+            throw new Error(`tar: bad size field for entry "${name}": ${sizeStr}`);
+        }
+        offset += 512;
+        const data = Buffer.from(buf.subarray(offset, offset + size));
+        entries.push({ name, data });
+        const padded = Math.ceil(size / 512) * 512;
+        offset += padded;
+    }
+    return entries;
+}
+//# sourceMappingURL=tar.js.map

package/dist/core/share/tar.js.map

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

package/dist/core/tags/index.d.ts

@@ -0,0 +1,48 @@
+import Database from 'better-sqlite3';
+/**
+ * Session user-metadata: freeform tags + custom name override.
+ *
+ * Stored in the FK-free `session_meta` / `session_tags` tables (migration 0009) so they
+ * survive ingest's `INSERT OR REPLACE INTO sessions` cascade. This module owns all reads
+ * and writes; server routes stay thin over it.
+ */
+export declare class TagError extends Error {
+    readonly status: number;
+    constructor(msg: string, status?: number);
+}
+/** Canonical tag form — single source of truth, reused by writes, the filter, and tests. */
+export declare function normalizeTag(raw: string): string;
+export interface SessionMeta {
+    /** Resolved display name (precedence applied). */
+    name: string;
+    /** Raw vyasa override (null if unset) — for the edit field. */
+    customName: string | null;
+    /** Normalized tags, sorted. */
+    tags: string[];
+}
+interface NameRow {
+    custom_name: string | null;
+    claude_custom_title: string | null;
+    claude_ai_title: string | null;
+    project: string | null;
+    id: string;
+}
+/** Display-name precedence: override → /rename → ai-title → project → short id. */
+export declare function resolveName(row: NameRow): string;
+export declare function setSessionName(db: Database.Database, sessionId: string, name: string | null): void;
+export declare function setTags(db: Database.Database, sessionId: string, tags: string[]): string[];
+/** Restore name + tags from a bundle on import — works even before the session is indexed (FK-free).
+ *  Defensive: the manifest is an untrusted input (someone else's bundle), so validate field types
+ *  here rather than trusting them — a bad type must not crash import after the JSONL is already placed. */
+export declare function restoreSessionMeta(db: Database.Database, sessionId: string, meta: {
+    customName?: unknown;
+    tags?: unknown;
+}): void;
+export declare function getTags(db: Database.Database, sessionId: string): string[];
+export declare function getSessionMeta(db: Database.Database, sessionId: string): SessionMeta;
+export declare function listAllTags(db: Database.Database): Array<{
+    tag: string;
+    count: number;
+}>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/core/tags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/tags/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAErC;;;;;;GAMG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBACX,GAAG,EAAE,MAAM,EAAE,MAAM,SAAM;CAKtC;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,UAAU,OAAO;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,EAAE,EAAE,MAAM,CAAA;CACX;AAQD,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQhD;AAOD,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQlG;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAG1F;AAcD;;2GAE2G;AAC3G,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7C,IAAI,CAaN;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAG1E;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAuBpF;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAIxF"}

package/dist/core/tags/index.js

@@ -0,0 +1,113 @@
+/**
+ * Session user-metadata: freeform tags + custom name override.
+ *
+ * Stored in the FK-free `session_meta` / `session_tags` tables (migration 0009) so they
+ * survive ingest's `INSERT OR REPLACE INTO sessions` cascade. This module owns all reads
+ * and writes; server routes stay thin over it.
+ */
+export class TagError extends Error {
+    status;
+    constructor(msg, status = 400) {
+        super(msg);
+        this.name = 'TagError';
+        this.status = status;
+    }
+}
+/** Canonical tag form — single source of truth, reused by writes, the filter, and tests. */
+export function normalizeTag(raw) {
+    return raw.trim().toLowerCase().replace(/\s+/g, ' ');
+}
+const truthy = (s) => {
+    if (typeof s !== 'string')
+        return null;
+    const t = s.trim();
+    return t.length > 0 ? s : null;
+};
+/** Display-name precedence: override → /rename → ai-title → project → short id. */
+export function resolveName(row) {
+    return (truthy(row.custom_name) ??
+        truthy(row.claude_custom_title) ??
+        truthy(row.claude_ai_title) ??
+        truthy(row.project) ??
+        row.id.slice(0, 8));
+}
+function assertSessionExists(db, sessionId) {
+    const row = db.prepare('SELECT 1 FROM sessions WHERE id = ?').get(sessionId);
+    if (!row)
+        throw new TagError(`session not found: ${sessionId}`, 404);
+}
+export function setSessionName(db, sessionId, name) {
+    assertSessionExists(db, sessionId);
+    const value = name != null && name.trim().length > 0 ? name.trim() : null;
+    db.prepare(`
+    INSERT INTO session_meta (session_id, custom_name)
+    VALUES (?, ?)
+    ON CONFLICT(session_id) DO UPDATE SET custom_name = excluded.custom_name, updated_at = datetime('now')
+  `).run(sessionId, value);
+}
+export function setTags(db, sessionId, tags) {
+    assertSessionExists(db, sessionId);
+    return writeTags(db, sessionId, tags);
+}
+/** Shared tag-write (no existence check) used by setTags + restoreSessionMeta. */
+function writeTags(db, sessionId, tags) {
+    const normalized = Array.from(new Set(tags.map(normalizeTag).filter((t) => t.length > 0))).sort();
+    const del = db.prepare('DELETE FROM session_tags WHERE session_id = ?');
+    const ins = db.prepare('INSERT OR IGNORE INTO session_tags (session_id, tag) VALUES (?, ?)');
+    db.transaction(() => {
+        del.run(sessionId);
+        for (const tag of normalized)
+            ins.run(sessionId, tag);
+    })();
+    return normalized;
+}
+/** Restore name + tags from a bundle on import — works even before the session is indexed (FK-free).
+ *  Defensive: the manifest is an untrusted input (someone else's bundle), so validate field types
+ *  here rather than trusting them — a bad type must not crash import after the JSONL is already placed. */
+export function restoreSessionMeta(db, sessionId, meta) {
+    const name = typeof meta.customName === 'string' && meta.customName.trim().length > 0
+        ? meta.customName.trim()
+        : null;
+    if (name) {
+        db.prepare(`
+      INSERT INTO session_meta (session_id, custom_name)
+      VALUES (?, ?)
+      ON CONFLICT(session_id) DO UPDATE SET custom_name = excluded.custom_name, updated_at = datetime('now')
+    `).run(sessionId, name);
+    }
+    const tags = Array.isArray(meta.tags) ? meta.tags.filter((t) => typeof t === 'string') : [];
+    if (tags.length > 0)
+        writeTags(db, sessionId, tags);
+}
+export function getTags(db, sessionId) {
+    return db.prepare('SELECT tag FROM session_tags WHERE session_id = ? ORDER BY tag').all(sessionId)
+        .map((r) => r.tag);
+}
+export function getSessionMeta(db, sessionId) {
+    const row = db.prepare(`
+    SELECT s.id AS id, s.project AS project,
+           m.custom_name AS custom_name, m.claude_custom_title AS claude_custom_title, m.claude_ai_title AS claude_ai_title
+    FROM sessions s LEFT JOIN session_meta m ON m.session_id = s.id
+    WHERE s.id = ?
+  `).get(sessionId);
+    // Session may not be indexed yet (e.g. just-imported bundle) — fall back to the meta row alone.
+    if (!row) {
+        const m = db.prepare('SELECT custom_name, claude_custom_title, claude_ai_title FROM session_meta WHERE session_id = ?')
+            .get(sessionId);
+        const nameRow = {
+            custom_name: m?.custom_name ?? null,
+            claude_custom_title: m?.claude_custom_title ?? null,
+            claude_ai_title: m?.claude_ai_title ?? null,
+            project: null,
+            id: sessionId,
+        };
+        return { name: resolveName(nameRow), customName: nameRow.custom_name, tags: getTags(db, sessionId) };
+    }
+    return { name: resolveName(row), customName: row.custom_name, tags: getTags(db, sessionId) };
+}
+export function listAllTags(db) {
+    return db.prepare(`
+    SELECT tag, COUNT(*) AS count FROM session_tags GROUP BY tag ORDER BY count DESC, tag ASC
+  `).all();
+}
+//# sourceMappingURL=index.js.map

package/dist/core/tags/index.js.map

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

package/dist/core/today/index.d.ts

@@ -0,0 +1,25 @@
+import Database from 'better-sqlite3';
+export interface SessionWasteSummary {
+    sessionId: string;
+    project: string;
+    costCents: number;
+    /** Total tokens this session (input + output + cache) — the nudge leads with this, not dollars. */
+    tokens: number;
+    totalWasteCents: number;
+    /** Largest single waste cause for this session, or null if none. */
+    top: {
+        category: string;
+        amountCents: number;
+        anchorMsgIdx: number | null;
+        cause: string;
+    } | null;
+}
+/**
+ * Per-session waste rollup. Reads the persisted `waste_attributions` (populated by
+ * computeAllWaste), so run computeAllWaste first if you need fresh numbers.
+ *
+ * Shared by the terminal nudge and (Phase 3a) the Today view — single source of
+ * truth so the nudge and the dashboard never disagree.
+ */
+export declare function summarizeSessionWaste(db: Database.Database, sessionId: string): SessionWasteSummary | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/today/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/today/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAErC,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,mGAAmG;IACnG,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,GAAG,EAAE;QACH,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,KAAK,EAAE,MAAM,CAAA;KACd,GAAG,IAAI,CAAA;CACT;AASD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CA+B1G"}

package/dist/core/today/index.js

@@ -0,0 +1,42 @@
+// Plain-language cause labels for the terminal nudge (no jargon — swarm feedback).
+const CAUSE = {
+    'cache-miss': 'low cache reuse',
+    'wrong-model': 'Opus on a simple task',
+    abandoned: 'abandoned mid-task',
+};
+/**
+ * Per-session waste rollup. Reads the persisted `waste_attributions` (populated by
+ * computeAllWaste), so run computeAllWaste first if you need fresh numbers.
+ *
+ * Shared by the terminal nudge and (Phase 3a) the Today view — single source of
+ * truth so the nudge and the dashboard never disagree.
+ */
+export function summarizeSessionWaste(db, sessionId) {
+    const s = db
+        .prepare(`SELECT id, project, total_cost_cents,
+                     (total_input_tokens + total_output_tokens + total_cache_creation + total_cache_read) AS tokens
+              FROM sessions WHERE id = ?`)
+        .get(sessionId);
+    if (!s)
+        return null;
+    const rows = db
+        .prepare(`SELECT category, amount_cents, anchor_msg_idx
+       FROM waste_attributions WHERE session_id = ?
+       ORDER BY amount_cents DESC`)
+        .all(sessionId);
+    // Categories overlap (an abandoned session's whole cost already includes any
+    // cache-miss/wrong-model overpay within it), so the naive sum can exceed what
+    // was actually spent. Cap at session cost — you can never waste more than you paid.
+    const rawSum = rows.reduce((acc, r) => acc + r.amount_cents, 0);
+    const totalWasteCents = Math.min(rawSum, s.total_cost_cents);
+    const top = rows[0]
+        ? {
+            category: rows[0].category,
+            amountCents: rows[0].amount_cents,
+            anchorMsgIdx: rows[0].anchor_msg_idx,
+            cause: CAUSE[rows[0].category] ?? rows[0].category,
+        }
+        : null;
+    return { sessionId, project: s.project, costCents: s.total_cost_cents, tokens: s.tokens ?? 0, totalWasteCents, top };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/today/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/today/index.ts"],"names":[],"mappings":"AAkBA,mFAAmF;AACnF,MAAM,KAAK,GAA2B;IACpC,YAAY,EAAE,iBAAiB;IAC/B,aAAa,EAAE,uBAAuB;IACtC,SAAS,EAAE,oBAAoB;CAChC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAqB,EAAE,SAAiB;IAC5E,MAAM,CAAC,GAAG,EAAE;SACT,OAAO,CAAC;;yCAE4B,CAAC;SACrC,GAAG,CAAC,SAAS,CAA0F,CAAA;IAC1G,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAEnB,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;kCAE4B,CAC7B;SACA,GAAG,CAAC,SAAS,CAAqF,CAAA;IAErG,6EAA6E;IAC7E,8EAA8E;IAC9E,oFAAoF;IACpF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;IAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAA;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC;YACE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ;YAC1B,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY;YACjC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc;YACpC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ;SACnD;QACH,CAAC,CAAC,IAAI,CAAA;IAER,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,CAAA;AACtH,CAAC"}

package/dist/core/waste/abandoned.d.ts

@@ -0,0 +1,12 @@
+import Database from 'better-sqlite3';
+import type { WasteAttribution } from '../schema/index.js';
+/**
+ * Detects two sub-cases of abandoned sessions:
+ *  A) Short sessions (≤ 60s) with no resumption in the same project within 24h.
+ *  B) Sessions where the last assistant message has a pending tool_use but no
+ *     subsequent user message with a tool_result.
+ *
+ * Sub-case B takes precedence over A if both match.
+ */
+export declare function detectAbandoned(db: Database.Database): WasteAttribution[];
+//# sourceMappingURL=abandoned.d.ts.map

package/dist/core/waste/abandoned.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abandoned.d.ts","sourceRoot":"","sources":["../../../src/core/waste/abandoned.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAoD1D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,gBAAgB,EAAE,CAkGzE"}