@a1hvdy/cc-openclaw 0.24.0 → 0.25.1

package/dist/src/channels/telegram-mirror/plan-attachment.js

@@ -0,0 +1,138 @@
+/**
+ * src/channels/telegram-mirror/plan-attachment.ts — v0.25.0 M9.
+ *
+ * When Claude emits ExitPlanMode (the plan-mode tool call), the mirror
+ * uploads the plan body as a .md document attachment with two inline
+ * buttons (Approve / Reject). Decision: ADR-006 — sendDocument over
+ * editMessageMedia. Rationale: sendDocument is simpler, has the larger
+ * size limit, and matches A1's on-disk plan-file convention.
+ *
+ * Approve → callback payload `{ action: 'plan-approve', planId }` resolves
+ * to model input "approved" which the engine bridge feeds to the running
+ * session.
+ *
+ * Reject → two-phase. The first tap stashes a pending-reject for the chat;
+ * the next non-slash inbound message becomes the rejection feedback payload
+ * "<plan rejected>\n<feedback text>". A tap-then-tap-Reject again clears
+ * the pending state silently.
+ *
+ * Risk references: R-3 (callback_data 64-byte cap) — payloads here route
+ * through CallbackMap exactly like M3's keyboard.
+ */
+/**
+ * Compose the slug-prefixed plan filename. Sanitises non-filename chars
+ * so the Telegram upload always succeeds.
+ */
+export function planFilename(slug) {
+    const safe = (slug ?? 'session').replace(/[^a-z0-9-_]/gi, '-').slice(0, 40);
+    // Fall back to "session" when the sanitised slug contains no alphanumeric
+    // characters (e.g. input was empty or all separators) — avoids surfacing
+    // an inscrutable "plan-----.md" filename to the user.
+    const effective = /[a-z0-9]/i.test(safe) ? safe : 'session';
+    return `plan-${effective}.md`;
+}
+/**
+ * Build a sendDocument action carrying the plan + the Approve/Reject
+ * inline keyboard. The callback ids are minted into the supplied
+ * CallbackMap; payloads include a fresh planId so multiple in-flight
+ * plans on the same chat don't collide.
+ */
+export function buildPlanAttachment(opts) {
+    const planId = opts.planId ?? `plan-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const filename = planFilename(opts.event.slug);
+    const approveCb = opts.callbackMap.create({ action: 'plan-approve', planId });
+    const rejectCb = opts.callbackMap.create({ action: 'plan-reject', planId });
+    const inline_keyboard = [
+        [
+            { text: '✅ Approve', callback_data: approveCb },
+            { text: '✖ Reject', callback_data: rejectCb },
+        ],
+    ];
+    return {
+        planId,
+        action: {
+            type: 'sendDocument',
+            chat_id: opts.chatId,
+            filename,
+            content: opts.event.plan,
+            caption: opts.event.caption ?? 'Plan ready — Approve or Reject below.',
+            reply_markup: { inline_keyboard },
+        },
+    };
+}
+/**
+ * Tracks the (chatId → pending-reject) state for two-phase rejection.
+ * The dispatch layer pokes startPending on a Reject tap and consumeFeedback
+ * on the next non-slash inbound. Pending-state TTL prevents a half-open
+ * rejection from corrupting later turns.
+ */
+export class RejectFeedbackTracker {
+    pending = new Map();
+    ttlMs;
+    now;
+    constructor(opts = {}) {
+        this.ttlMs = opts.ttlMs ?? 10 * 60_000;
+        this.now = opts.now ?? Date.now;
+    }
+    /**
+     * Mark a chat as having tapped Reject and waiting for feedback. If a
+     * prior pending exists, it is replaced (the user re-tapped on a newer plan).
+     */
+    startPending(chatId, planId) {
+        this.pending.set(chatId, { chatId, planId, pendingSince: this.now() });
+    }
+    /**
+     * Returns true when the chat has a non-stale pending-reject.
+     */
+    isPending(chatId) {
+        return this.peek(chatId) !== undefined;
+    }
+    /**
+     * Consume the next inbound text as the rejection feedback. Returns a
+     * formatted payload that the engine bridge feeds to openai-compat as a
+     * single user-message, or undefined when no pending state exists.
+     *
+     * Payload shape: "<plan rejected: planId>\n<feedback text>" — the
+     * "<plan rejected>" sentinel lets the model recognise this as
+     * rejection feedback (not a new turn).
+     */
+    consumeFeedback(chatId, feedback) {
+        const p = this.peek(chatId);
+        if (!p)
+            return undefined;
+        this.pending.delete(chatId);
+        return `<plan rejected: ${p.planId}>\n${feedback}`;
+    }
+    /**
+     * Drop the pending state without consuming feedback (e.g. user taps
+     * Reject twice, or types another slash command in the interim).
+     */
+    cancel(chatId) {
+        return this.pending.delete(chatId);
+    }
+    /**
+     * Inspect pending without consuming. Filters expired entries.
+     */
+    peek(chatId) {
+        const p = this.pending.get(chatId);
+        if (!p)
+            return undefined;
+        if (this.now() - p.pendingSince > this.ttlMs) {
+            this.pending.delete(chatId);
+            return undefined;
+        }
+        return p;
+    }
+    clear() {
+        this.pending.clear();
+    }
+}
+/**
+ * Helper: format the approve payload as engine input. Kept as a function
+ * (not a constant) so future variants — e.g. caching a planId reference —
+ * have a single place to extend.
+ */
+export function formatApprovePayload(planId) {
+    return `<plan approved: ${planId}>`;
+}
+//# sourceMappingURL=plan-attachment.js.map

package/dist/src/channels/telegram-mirror/plan-attachment.js.map

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

package/dist/src/channels/telegram-mirror/quota-reader.d.ts

@@ -0,0 +1,41 @@
+/**
+ * src/channels/telegram-mirror/quota-reader.ts — v0.25.0 M4 stub.
+ *
+ * Minimal QuotaSnapshot interface and a zero-valued reader so /cost in M4
+ * has something to render. M11 replaces the stub with a wire-up to the
+ * production status-tee-reader.ts that the existing /cost handler in the
+ * legacy live card already consumes.
+ *
+ * Decision-link: M11 owns threshold-notification + detail-view wiring;
+ * keeping the surface here in M4 isolates the command-handler layer from
+ * the status-tee read path (so M11 can swap implementations without
+ * touching commands.ts).
+ */
+export interface QuotaPerDay {
+    /** YYYY-MM-DD */
+    date: string;
+    /** 0..100 — percentage of the daily Max 20x window consumed. */
+    percent: number;
+}
+export interface QuotaSnapshot {
+    /** Current Max 20x consumption as 0..100 percent. */
+    maxPercent: number;
+    /** Weekly burn in USD (extra_usage overage tracked separately by status-tee). */
+    weeklyBurn: number;
+    /** Sessions ranked by token consumption (top-5). */
+    topSessions: Array<{
+        slug: string;
+        tokens: number;
+    }>;
+    /** Per-day rollup, most-recent-first (capped at 7). */
+    perDayRollup: QuotaPerDay[];
+}
+export interface QuotaReader {
+    read(): QuotaSnapshot;
+}
+/**
+ * Stub reader for M4 — returns a known-zero snapshot. M11 replaces this
+ * with a wire to status-tee-reader.ts. Tests can pass their own reader
+ * directly to the cost command for fixture-based assertions.
+ */
+export declare const stubQuotaReader: QuotaReader;

package/dist/src/channels/telegram-mirror/quota-reader.js

@@ -0,0 +1,29 @@
+/**
+ * src/channels/telegram-mirror/quota-reader.ts — v0.25.0 M4 stub.
+ *
+ * Minimal QuotaSnapshot interface and a zero-valued reader so /cost in M4
+ * has something to render. M11 replaces the stub with a wire-up to the
+ * production status-tee-reader.ts that the existing /cost handler in the
+ * legacy live card already consumes.
+ *
+ * Decision-link: M11 owns threshold-notification + detail-view wiring;
+ * keeping the surface here in M4 isolates the command-handler layer from
+ * the status-tee read path (so M11 can swap implementations without
+ * touching commands.ts).
+ */
+/**
+ * Stub reader for M4 — returns a known-zero snapshot. M11 replaces this
+ * with a wire to status-tee-reader.ts. Tests can pass their own reader
+ * directly to the cost command for fixture-based assertions.
+ */
+export const stubQuotaReader = {
+    read() {
+        return {
+            maxPercent: 0,
+            weeklyBurn: 0,
+            topSessions: [],
+            perDayRollup: [],
+        };
+    },
+};
+//# sourceMappingURL=quota-reader.js.map

package/dist/src/channels/telegram-mirror/quota-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-reader.js","sourceRoot":"","sources":["../../../../src/channels/telegram-mirror/quota-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwBH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI;QACF,OAAO;YACL,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/channels/telegram-mirror/sessions-keyboard.d.ts

@@ -0,0 +1,84 @@
+/**
+ * src/channels/telegram-mirror/sessions-keyboard.ts — v0.25.0 M3.
+ *
+ * Builds the inline keyboard for /sessions. Pure function — takes a row
+ * list + page index + a CallbackMap, returns Telegram's inline_keyboard
+ * shape. Caller is responsible for sending/editing the surrounding
+ * Telegram message via the dispatch layer.
+ *
+ * Decision refs:
+ *   • ADR-003 — slug ↔ sessionName comes from session-registry; the row
+ *     list here is a denormalised SessionRow because the keyboard also
+ *     needs live state + lastUsedAt, which the registry doesn't track
+ *     (state lives in session-manager, time-since lives in the registry's
+ *     lastUsedAt). The handler in M4 stitches them together.
+ *   • ADR-004 — every callback_data slot is a CallbackMap id, not a raw
+ *     JSON payload. Keeps every button under the 64-byte cap by design.
+ *   • ADR-005 — page size is 8; 9th row is "▶ More" when more pages exist.
+ */
+import type { CallbackMap } from './callback-mapping.js';
+export declare const SESSIONS_PAGE_SIZE = 8;
+export type SessionState = 'running' | 'stopped' | 'idle';
+export interface SessionRow {
+    slug: string;
+    sessionName: string;
+    state: SessionState;
+    /** ISO timestamp — the registry's lastUsedAt. */
+    lastUsedAt: string;
+}
+export interface InlineButton {
+    text: string;
+    callback_data: string;
+}
+export interface SessionsKeyboardResult {
+    inline_keyboard: InlineButton[][];
+    /** Zero-indexed page rendered. */
+    page: number;
+    /** Total page count (≥ 1 even when rows is empty). */
+    pageCount: number;
+    /** True when there is at least one page after the rendered one. */
+    hasMore: boolean;
+}
+/**
+ * Compact relative-time string for a row's lastUsedAt.
+ *   < 60s   →  "<1m"
+ *   < 1h    →  "Nm"
+ *   < 1d    →  "Nh"
+ *   else    →  "Nd"
+ * Designed to fit in 4 chars so the row stays narrow on phone Telegram.
+ */
+export declare function formatLastActivity(lastUsedAt: string, now?: number): string;
+/**
+ * Format a row label.  "cc-openclaw · 🟢 · 2m"
+ */
+export declare function formatSessionRowLabel(row: SessionRow, now?: number): string;
+export interface SessionsKeyboardOpts {
+    rows: SessionRow[];
+    /** Zero-indexed page; clamped into [0, pageCount-1]. */
+    page?: number;
+    callbackMap: CallbackMap;
+    /** Override clock for tests. */
+    now?: number;
+}
+/**
+ * Build the full /sessions inline keyboard. Layout:
+ *
+ *   Row 1..N    session rows (one button each)        (N ≤ 8)
+ *   Row N+1     "▶ More" — only when hasMore===true
+ *   Row last    "➕ New" "🗑 Stop" "✖ Close"          (always)
+ *
+ * Every button's callback_data is a CallbackMap id pointing at a payload:
+ *   session row →  { action: 'switch', slug }
+ *   ▶ More       →  { action: 'page', page: N+1 }
+ *   ➕ New       →  { action: 'new' }
+ *   🗑 Stop      →  { action: 'stop' }
+ *   ✖ Close      →  { action: 'close' }
+ */
+export declare function buildSessionsKeyboard(opts: SessionsKeyboardOpts): SessionsKeyboardResult;
+/**
+ * Helper: every button's callback_data must fit in 64 UTF-8 bytes per
+ * Telegram's API. We enforce this at build time as a defense-in-depth
+ * check — even an 8-char id is well under, but a future refactor that
+ * stuffs raw JSON would silently break Telegram without this assertion.
+ */
+export declare function assertCallbackDataBudget(keyboard: SessionsKeyboardResult): void;

package/dist/src/channels/telegram-mirror/sessions-keyboard.js

@@ -0,0 +1,113 @@
+/**
+ * src/channels/telegram-mirror/sessions-keyboard.ts — v0.25.0 M3.
+ *
+ * Builds the inline keyboard for /sessions. Pure function — takes a row
+ * list + page index + a CallbackMap, returns Telegram's inline_keyboard
+ * shape. Caller is responsible for sending/editing the surrounding
+ * Telegram message via the dispatch layer.
+ *
+ * Decision refs:
+ *   • ADR-003 — slug ↔ sessionName comes from session-registry; the row
+ *     list here is a denormalised SessionRow because the keyboard also
+ *     needs live state + lastUsedAt, which the registry doesn't track
+ *     (state lives in session-manager, time-since lives in the registry's
+ *     lastUsedAt). The handler in M4 stitches them together.
+ *   • ADR-004 — every callback_data slot is a CallbackMap id, not a raw
+ *     JSON payload. Keeps every button under the 64-byte cap by design.
+ *   • ADR-005 — page size is 8; 9th row is "▶ More" when more pages exist.
+ */
+export const SESSIONS_PAGE_SIZE = 8;
+const STATE_EMOJI = {
+    running: '🟢',
+    stopped: '⚫',
+    idle: '🟡',
+};
+/**
+ * Compact relative-time string for a row's lastUsedAt.
+ *   < 60s   →  "<1m"
+ *   < 1h    →  "Nm"
+ *   < 1d    →  "Nh"
+ *   else    →  "Nd"
+ * Designed to fit in 4 chars so the row stays narrow on phone Telegram.
+ */
+export function formatLastActivity(lastUsedAt, now = Date.now()) {
+    const t = new Date(lastUsedAt).getTime();
+    if (!Number.isFinite(t))
+        return '?';
+    const ms = Math.max(0, now - t);
+    if (ms < 60_000)
+        return '<1m';
+    if (ms < 3_600_000)
+        return `${Math.floor(ms / 60_000)}m`;
+    if (ms < 86_400_000)
+        return `${Math.floor(ms / 3_600_000)}h`;
+    return `${Math.floor(ms / 86_400_000)}d`;
+}
+/**
+ * Format a row label.  "cc-openclaw · 🟢 · 2m"
+ */
+export function formatSessionRowLabel(row, now = Date.now()) {
+    return `${row.slug} · ${STATE_EMOJI[row.state]} · ${formatLastActivity(row.lastUsedAt, now)}`;
+}
+/**
+ * Build the full /sessions inline keyboard. Layout:
+ *
+ *   Row 1..N    session rows (one button each)        (N ≤ 8)
+ *   Row N+1     "▶ More" — only when hasMore===true
+ *   Row last    "➕ New" "🗑 Stop" "✖ Close"          (always)
+ *
+ * Every button's callback_data is a CallbackMap id pointing at a payload:
+ *   session row →  { action: 'switch', slug }
+ *   ▶ More       →  { action: 'page', page: N+1 }
+ *   ➕ New       →  { action: 'new' }
+ *   🗑 Stop      →  { action: 'stop' }
+ *   ✖ Close      →  { action: 'close' }
+ */
+export function buildSessionsKeyboard(opts) {
+    const { rows, callbackMap, now = Date.now() } = opts;
+    const pageCount = Math.max(1, Math.ceil(rows.length / SESSIONS_PAGE_SIZE));
+    const page = Math.min(Math.max(0, opts.page ?? 0), pageCount - 1);
+    const start = page * SESSIONS_PAGE_SIZE;
+    const slice = rows.slice(start, start + SESSIONS_PAGE_SIZE);
+    const hasMore = page < pageCount - 1;
+    const inline_keyboard = [];
+    for (const row of slice) {
+        inline_keyboard.push([
+            {
+                text: formatSessionRowLabel(row, now),
+                callback_data: callbackMap.create({ action: 'switch', slug: row.slug }),
+            },
+        ]);
+    }
+    if (hasMore) {
+        inline_keyboard.push([
+            {
+                text: '▶ More',
+                callback_data: callbackMap.create({ action: 'page', page: page + 1 }),
+            },
+        ]);
+    }
+    inline_keyboard.push([
+        { text: '➕ New', callback_data: callbackMap.create({ action: 'new' }) },
+        { text: '🗑 Stop', callback_data: callbackMap.create({ action: 'stop' }) },
+        { text: '✖ Close', callback_data: callbackMap.create({ action: 'close' }) },
+    ]);
+    return { inline_keyboard, page, pageCount, hasMore };
+}
+/**
+ * Helper: every button's callback_data must fit in 64 UTF-8 bytes per
+ * Telegram's API. We enforce this at build time as a defense-in-depth
+ * check — even an 8-char id is well under, but a future refactor that
+ * stuffs raw JSON would silently break Telegram without this assertion.
+ */
+export function assertCallbackDataBudget(keyboard) {
+    for (const row of keyboard.inline_keyboard) {
+        for (const btn of row) {
+            const bytes = Buffer.byteLength(btn.callback_data, 'utf8');
+            if (bytes > 64) {
+                throw new Error(`[cc-openclaw/telegram-mirror/sessions-keyboard] callback_data exceeds 64-byte cap (${bytes}b) on button "${btn.text}"`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=sessions-keyboard.js.map

package/dist/src/channels/telegram-mirror/sessions-keyboard.js.map

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

package/dist/src/channels/telegram-mirror/soak-log.d.ts

@@ -0,0 +1,98 @@
+/**
+ * src/channels/telegram-mirror/soak-log.ts — v0.25.0 M14.
+ *
+ * Daily JSONL incident + activity log for the 2-week soak (M14 → M15
+ * cutover gate). Writes append-only rows to
+ *   workspace/memory/mirror-soak-<YYYY-MM-DD>.jsonl
+ * per PRP §5 M14. The file rolls at UTC midnight (date-stamped path).
+ *
+ * Three row types per spec:
+ *   • laptop-check       — A1 self-reports opened-laptop-today via /soak-check.
+ *   • failure-incident   — fires once per M12 handler invocation in soak.
+ *   • slash-invocation   — one row per slash command dispatch.
+ *
+ * Idempotency: a single laptop-check per UTC day. recordLaptopCheck()
+ * returns false on the second call within a day so the /soak-check
+ * handler can surface "already recorded today" UX rather than logging
+ * duplicates.
+ *
+ * Decision-link: this file is the only filesystem-touching mirror module
+ * outside session-registry (M1). Both share the atomic-write-via-rename
+ * idiom; soak-log appends so it doesn't need the tmpfile dance, but the
+ * path resolution is the same shape.
+ */
+export type SoakRow = SoakLaptopCheckRow | SoakFailureRow | SoakSlashRow;
+export interface SoakLaptopCheckRow {
+    ts: string;
+    type: 'laptop-check';
+    openedLaptop: boolean;
+}
+export interface SoakFailureRow {
+    ts: string;
+    type: 'failure-incident';
+    mode: string;
+    chatId: string | number;
+    info?: unknown;
+}
+export interface SoakSlashRow {
+    ts: string;
+    type: 'slash-invocation';
+    cmd: string;
+    chatId: string | number;
+}
+export interface SoakLoggerOptions {
+    /** Override base dir for tests (defaults to ~/.openclaw/workspace/memory). */
+    dir?: string;
+    /** Override clock for tests. */
+    now?: () => Date;
+}
+export declare class SoakLogger {
+    private readonly dir;
+    private readonly now;
+    constructor(opts?: SoakLoggerOptions);
+    /**
+     * Absolute path of today's JSONL file. Honors the configured clock.
+     */
+    pathForToday(): string;
+    /**
+     * Append a row to today's file. Creates the parent directory if missing.
+     * Each row is `JSON.stringify(row) + '\n'`.
+     */
+    append(row: SoakRow): void;
+    /**
+     * Read all rows for today (parsing each line). Returns [] when the
+     * file is missing OR when every line is malformed.
+     */
+    readToday(): SoakRow[];
+    /**
+     * Returns true iff a laptop-check row has already been written today.
+     * Used by /soak-check's once-per-day gate.
+     */
+    hasLaptopCheckToday(): boolean;
+    /**
+     * Idempotent laptop-check writer. Returns true when the row was
+     * persisted, false when a check was already recorded today.
+     */
+    recordLaptopCheck(openedLaptop: boolean): boolean;
+    /**
+     * Failure-incident logger — called by the dispatcher when a M12
+     * handler fires. The info payload is opaque JSON; the schema is
+     * per-mode and lives in the handler's documentation.
+     */
+    recordFailure(mode: string, chatId: string | number, info?: unknown): void;
+    /**
+     * Slash-invocation logger — called once per dispatchCommand call by
+     * the dispatcher (M5+). Cheap to record and lets the soak surface
+     * which commands A1 actually uses on phone.
+     */
+    recordSlash(cmd: string, chatId: string | number): void;
+    /**
+     * Count rows by type for the day — used by M15's "5/7 no-laptop days"
+     * gate without having to ship a separate aggregator.
+     */
+    countByType(): {
+        'laptop-check': number;
+        'failure-incident': number;
+        'slash-invocation': number;
+    };
+}

package/dist/src/channels/telegram-mirror/soak-log.js

@@ -0,0 +1,136 @@
+/**
+ * src/channels/telegram-mirror/soak-log.ts — v0.25.0 M14.
+ *
+ * Daily JSONL incident + activity log for the 2-week soak (M14 → M15
+ * cutover gate). Writes append-only rows to
+ *   workspace/memory/mirror-soak-<YYYY-MM-DD>.jsonl
+ * per PRP §5 M14. The file rolls at UTC midnight (date-stamped path).
+ *
+ * Three row types per spec:
+ *   • laptop-check       — A1 self-reports opened-laptop-today via /soak-check.
+ *   • failure-incident   — fires once per M12 handler invocation in soak.
+ *   • slash-invocation   — one row per slash command dispatch.
+ *
+ * Idempotency: a single laptop-check per UTC day. recordLaptopCheck()
+ * returns false on the second call within a day so the /soak-check
+ * handler can surface "already recorded today" UX rather than logging
+ * duplicates.
+ *
+ * Decision-link: this file is the only filesystem-touching mirror module
+ * outside session-registry (M1). Both share the atomic-write-via-rename
+ * idiom; soak-log appends so it doesn't need the tmpfile dance, but the
+ * path resolution is the same shape.
+ */
+import { appendFileSync, readFileSync, existsSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+function defaultDir() {
+    return join(homedir(), '.openclaw', 'workspace', 'memory');
+}
+function ymd(d) {
+    return d.toISOString().slice(0, 10); // YYYY-MM-DD (UTC)
+}
+export class SoakLogger {
+    dir;
+    now;
+    constructor(opts = {}) {
+        this.dir = opts.dir ?? defaultDir();
+        this.now = opts.now ?? (() => new Date());
+    }
+    /**
+     * Absolute path of today's JSONL file. Honors the configured clock.
+     */
+    pathForToday() {
+        return join(this.dir, `mirror-soak-${ymd(this.now())}.jsonl`);
+    }
+    /**
+     * Append a row to today's file. Creates the parent directory if missing.
+     * Each row is `JSON.stringify(row) + '\n'`.
+     */
+    append(row) {
+        const path = this.pathForToday();
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, JSON.stringify(row) + '\n');
+    }
+    /**
+     * Read all rows for today (parsing each line). Returns [] when the
+     * file is missing OR when every line is malformed.
+     */
+    readToday() {
+        const path = this.pathForToday();
+        if (!existsSync(path))
+            return [];
+        const raw = readFileSync(path, 'utf8');
+        const out = [];
+        for (const line of raw.split('\n')) {
+            if (!line.trim())
+                continue;
+            try {
+                out.push(JSON.parse(line));
+            }
+            catch {
+                /* skip malformed line — defensive */
+            }
+        }
+        return out;
+    }
+    /**
+     * Returns true iff a laptop-check row has already been written today.
+     * Used by /soak-check's once-per-day gate.
+     */
+    hasLaptopCheckToday() {
+        return this.readToday().some((r) => r.type === 'laptop-check');
+    }
+    /**
+     * Idempotent laptop-check writer. Returns true when the row was
+     * persisted, false when a check was already recorded today.
+     */
+    recordLaptopCheck(openedLaptop) {
+        if (this.hasLaptopCheckToday())
+            return false;
+        this.append({
+            ts: this.now().toISOString(),
+            type: 'laptop-check',
+            openedLaptop,
+        });
+        return true;
+    }
+    /**
+     * Failure-incident logger — called by the dispatcher when a M12
+     * handler fires. The info payload is opaque JSON; the schema is
+     * per-mode and lives in the handler's documentation.
+     */
+    recordFailure(mode, chatId, info) {
+        this.append({
+            ts: this.now().toISOString(),
+            type: 'failure-incident',
+            mode,
+            chatId,
+            info,
+        });
+    }
+    /**
+     * Slash-invocation logger — called once per dispatchCommand call by
+     * the dispatcher (M5+). Cheap to record and lets the soak surface
+     * which commands A1 actually uses on phone.
+     */
+    recordSlash(cmd, chatId) {
+        this.append({
+            ts: this.now().toISOString(),
+            type: 'slash-invocation',
+            cmd,
+            chatId,
+        });
+    }
+    /**
+     * Count rows by type for the day — used by M15's "5/7 no-laptop days"
+     * gate without having to ship a separate aggregator.
+     */
+    countByType() {
+        const out = { 'laptop-check': 0, 'failure-incident': 0, 'slash-invocation': 0 };
+        for (const r of this.readToday())
+            out[r.type] += 1;
+        return out;
+    }
+}
+//# sourceMappingURL=soak-log.js.map

package/dist/src/channels/telegram-mirror/soak-log.js.map

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