@jungjaehoon/mama-os 0.20.1 → 0.22.0

package/dist/operator/situation-report.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SituationReporter = exports.OPERATOR_FULL_REPORT_TAG = void 0;
+/**
+ * Machine frame tag prepended to the FULL report prompt so the report-run wiring can tell a full
+ * report from a digest for tool-use auditing (report-run.ts). Kagemusha frames its scheduled full
+ * report with the same bracketed-tag convention (report-prompts.ts buildFullReportPrompt).
+ */
+exports.OPERATOR_FULL_REPORT_TAG = '[operator_full_report]';
+/** Deterministic prompt-size bounds (mind memory + prompt length; see plan design decision 4). */
+const MAX_EXCERPTS_PER_CHANNEL = 5;
+const MAX_EXCERPT_CHARS = 160;
+const MAX_CHANNELS_IN_PROMPT = 12;
+const MAX_RECALLED = 20;
+/** Machine trailer the agent appends; stripped before the owner sees the report. */
+const USED_TRIGGERS_PATTERN = /\n?^USED_TRIGGERS:\s*(.*)\s*$/im;
+class SituationReporter {
+    windowByChannel = new Map();
+    windowTotal = 0;
+    fireAgg = new Map();
+    authored = 0;
+    recalled = new Map(); // topic -> content (deduped, bounded)
+    opts;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    /** Fold a batch of drained events into the bounded per-channel window. */
+    recordWindow(events) {
+        for (const e of events) {
+            const w = this.windowByChannel.get(e.channelId) ?? { count: 0, excerpts: [] };
+            w.count += 1;
+            const text = e.content.trim();
+            if (text) {
+                w.excerpts.push(text.slice(0, MAX_EXCERPT_CHARS));
+                if (w.excerpts.length > MAX_EXCERPTS_PER_CHANNEL) {
+                    w.excerpts.shift();
+                }
+            }
+            this.windowByChannel.set(e.channelId, w);
+            this.windowTotal += 1;
+        }
+    }
+    /** Fold one fire into the aggregate; merge the memory it recalled (agent-query-driven). */
+    recordFire(activity) {
+        const key = `${activity.triggerId}|${activity.channelId}`;
+        const agg = this.fireAgg.get(key) ?? {
+            triggerId: activity.triggerId,
+            kind: activity.kind,
+            channelId: activity.channelId,
+            count: 0,
+            topics: new Set(),
+        };
+        agg.count += 1;
+        for (const r of activity.recalled) {
+            agg.topics.add(r.topic);
+            if (!this.recalled.has(r.topic) && this.recalled.size < MAX_RECALLED) {
+                this.recalled.set(r.topic, r.content.slice(0, MAX_EXCERPT_CHARS));
+            }
+        }
+        this.fireAgg.set(key, agg);
+    }
+    recordAuthored(count) {
+        this.authored += count;
+    }
+    /** Any window events, fires, or authored triggers accumulated since the last reset. */
+    hasActivity() {
+        return this.windowTotal > 0 || this.fireAgg.size > 0 || this.authored > 0;
+    }
+    /**
+     * Agent composes the report from the aggregate; sink delivers it. Returns true if a report was
+     * sent, false if there was nothing to say or the agent suppressed it (NOTHING).
+     */
+    async report(askAgent, output, mode) {
+        // M2.1: the scheduled FULL report is a duty report - it composes even on an empty window
+        // (the owner relies on it arriving; a quiet window is itself the news). Digests stay gated.
+        if (mode !== 'full' && !this.hasActivity())
+            return false;
+        const raw = (await askAgent(this.buildPrompt(mode))).trim();
+        if (raw === '' || /^NOTHING\b/i.test(raw)) {
+            this.reset(); // agent judged nothing worth reporting - drop the buffer quietly
+            return false;
+        }
+        // Parse + strip the USED_TRIGGERS machine trailer (the owner never sees it)
+        // and validate the ids against THIS window's fires (no hallucinated credit).
+        const match = raw.match(USED_TRIGGERS_PATTERN);
+        const text = raw.replace(USED_TRIGGERS_PATTERN, '').trim();
+        let cited = [];
+        if (match) {
+            const windowIds = new Set([...this.fireAgg.values()].map((f) => f.triggerId));
+            cited = [
+                ...new Set(match[1]
+                    .split(',')
+                    .map((id) => id.trim())
+                    .filter((id) => id.length > 0 && id.toLowerCase() !== 'none' && windowIds.has(id))),
+            ];
+        }
+        if (text === '') {
+            this.reset(); // trailer-only reply: nothing was delivered, so no credit either
+            return false;
+        }
+        await output.send(text); // throws loudly on failure; buffer kept for retry (no-fallback)
+        // Credit only AFTER a successful send: success means "cited in a DELIVERED
+        // report". Crediting before send would double-count on the retry path
+        // (send throws -> buffer kept -> next cadence re-cites the same fires).
+        if (cited.length > 0) {
+            this.opts.recordTriggerUse?.(cited);
+        }
+        this.reset();
+        return true;
+    }
+    reset() {
+        this.windowByChannel.clear();
+        this.windowTotal = 0;
+        this.fireAgg.clear();
+        this.authored = 0;
+        this.recalled.clear();
+    }
+    /** Public for testability. Aggregate window + fire activity + recalled memory -> agent prompt. */
+    buildPrompt(mode) {
+        const channels = [...this.windowByChannel.entries()].sort((a, b) => b[1].count - a[1].count);
+        const shown = channels.slice(0, MAX_CHANNELS_IN_PROMPT);
+        const windowLines = shown.map(([channelId, w]) => `- ${channelId}: ${w.count} msg(s); recent: ${w.excerpts.join(' | ') || '(none)'}`);
+        if (channels.length > shown.length) {
+            const restCount = channels.slice(shown.length).reduce((n, [, w]) => n + w.count, 0);
+            windowLines.push(`- (+${channels.length - shown.length} more channel(s), ${restCount} msg(s))`);
+        }
+        const fireLines = [...this.fireAgg.values()].map((f) => `- trigger "${f.kind}" [id: ${f.triggerId}] fired ${f.count}x on ${f.channelId}; recalled: ${[...f.topics].join(', ') || '(none)'}`);
+        const memoryLines = [...this.recalled.entries()].map(([topic, content]) => `- ${topic}: ${content}`);
+        // Resolve the gather lines only for the FULL report - the digest framing never renders
+        // them, so a zero-arg PROVIDER must not be invoked (it may do real gather work) just to
+        // build a digest prompt. The guard below stays anchored on the RESOLVED array: a zero-arg
+        // provider's `.length` is its arity (0), so guarding on the raw opts value would compile
+        // cleanly and silently drop the ENTIRE gather block on every production report.
+        const gatherLines = mode === 'full'
+            ? typeof this.opts.selfGatherLines === 'function'
+                ? this.opts.selfGatherLines()
+                : (this.opts.selfGatherLines ?? [])
+            : [];
+        // M2.1 posture: the full report is a DUTY report (always arrives - a quiet window is
+        // reported as quiet, the aliveness signal owners rely on); the digest defaults to briefing
+        // and keeps NOTHING only for pure noise.
+        const framing = mode === 'full'
+            ? [
+                exports.OPERATOR_FULL_REPORT_TAG,
+                'You are the operator agent. Write your scheduled FULLER situation report for your owner',
+                'covering the whole window below (multiple channels, since the last full report). Group',
+                "what recurred, what is new, and what needs the owner's attention. Plain language, no",
+                'markdown tables. This scheduled report must ALWAYS arrive: if the window was quiet,',
+                'say so in one or two lines instead of skipping.',
+                "Structure the report with these sections (render the headings in the owner's language;",
+                'omit a section only when it is truly empty):',
+                '1) Key situation  2) Action required  3) Decisions needed  4) Pipeline  5) Next actions',
+                ...(gatherLines.length > 0
+                    ? [
+                        '',
+                        'Before writing, ACTIVELY gather current context by CALLING your gateway tools.',
+                        'Emit each call as a fenced tool_call JSON block and wait for the result before',
+                        'the next call. The block format is exactly:',
+                        '```tool_call',
+                        '{"name": "kagemusha_tasks", "input": {"status": "in_progress"}}',
+                        '```',
+                        'Gather with these gateway tool calls:',
+                        ...gatherLines.map((line) => `- ${line}`),
+                        'These gateway tools are NOT native or deferred CLI tools: ToolSearch cannot',
+                        'load them and will find nothing. Invoke them ONLY as fenced tool_call JSON',
+                        'blocks in your reply text - do not search for them, and do not fall back to',
+                        'Bash or curl against any API.',
+                        'Use ONLY these gateway tool_call blocks to gather. Do NOT read log files,',
+                        'databases, or the filesystem with Bash, Read, or other native tools - those are',
+                        'not the task board and will make the report wrong. Your gateway tool findings',
+                        'are the primary source; the window summary below is only a hint.',
+                        '',
+                        'After gathering, if the window contains a durable decision or lesson worth',
+                        'keeping, persist exactly ONE with a gateway tool_call to mama_save (type',
+                        '"decision", with topic, decision, reasoning). Only save when it is genuinely',
+                        'durable; skip the save otherwise. This is your judgement, not a requirement.',
+                    ]
+                    : []),
+                ...(this.opts.boardPublishLines && this.opts.boardPublishLines.length > 0
+                    ? ['', ...this.opts.boardPublishLines]
+                    : []),
+            ]
+            : [
+                'You are the operator agent. Write a SHORT proactive digest for your owner about the',
+                'situation below - what happened, what recurred, and what the owner may want to look at.',
+                '2-6 lines, plain language, no markdown tables. Default to sending the brief when there',
+                'is meaningful activity; reply exactly NOTHING only if this window is pure noise',
+                '(duplicates, bot chatter) with nothing the owner could act on.',
+            ];
+        return [
+            ...framing,
+            // Attribution discipline (owner feedback: the only quality complaint on day-1
+            // reports was merged sender/room identities).
+            'Attribute people and rooms EXACTLY as they appear in the source lines: a channel/room',
+            'name is never a person, and a sender is never a room. If you cannot tell who said',
+            'something, write "(sender unclear)" instead of guessing or merging names.',
+            // G2 success signal: machine trailer, stripped before delivery.
+            'After the report body, add ONE final line exactly in this form:',
+            'USED_TRIGGERS: <comma-separated ids of the fired triggers (from [id: ...] in the fire',
+            'activity below) whose fire or recalled memory you actually drew on>, or',
+            'USED_TRIGGERS: none if you drew on none. This line is machine-read and stripped',
+            'before the owner sees the report.',
+            'Reply in the language the owner uses on these channels if you can tell; otherwise English.',
+            // Local wall-clock, not UTC: the first live report stamped itself in UTC because the
+            // agent had no local time reference (Kagemusha injects local time the same way).
+            `Current local time: ${new Date().toLocaleString()}. Use LOCAL time in the report, never UTC.`,
+            '',
+            'Window (per channel; excerpts truncated):',
+            ...(windowLines.length > 0 ? windowLines : ['- (no channel messages this window)']),
+            '',
+            `Triggers newly authored this window: ${this.authored}`,
+            'Fire activity:',
+            ...(fireLines.length > 0 ? fireLines : ['- (no triggers fired this window)']),
+            '',
+            'Memory your triggers surfaced this window:',
+            ...(memoryLines.length > 0 ? memoryLines : ['- (none)']),
+        ].join('\n');
+    }
+}
+exports.SituationReporter = SituationReporter;
+//# sourceMappingURL=situation-report.js.map

package/dist/operator/situation-report.js.map

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

package/dist/operator/task-ledger.d.ts

@@ -0,0 +1,96 @@
+/**
+ * TaskLedger - the operator-owned native work-item ledger (M8 Task 0.1).
+ *
+ * Ports the SHAPE of Kagemusha's proven task store (11 columns: id/title/status/
+ * priority/deadline/source/auto_created/confirmed/timestamps) plus `assignee`
+ * and an idempotency key. Implements the pre-existing `TaskSource` interface
+ * (operator-interfaces.ts) so the board projects ONE task model, not two.
+ *
+ * Reconcile runs create/update rows through the task_create/task_update gateway
+ * tools; the pipeline board slot is a projection of `list({order:
+ * 'deadline_priority'})`. The AGENT makes every judgment about what becomes a
+ * task; this store only persists.
+ *
+ * Schema-extension note: CREATE TABLE IF NOT EXISTS is a no-op on existing
+ * tables. Any post-ship column addition needs an explicit ALTER TABLE guarded
+ * by a PRAGMA table_info check, added to runMigration().
+ *
+ * The db handle is SHARED with TriggerRegistry and owned by the caller
+ * (start.ts opens and closes it once) - deliberately no close() here.
+ */
+import type { SQLiteDatabase } from '../sqlite.js';
+import type { OperatorTask, TaskSource } from './operator-interfaces.js';
+export declare const TASK_STATUSES: readonly ["pending", "in_progress", "review", "blocked", "done", "cancelled"];
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+export declare const TASK_PRIORITIES: readonly ["high", "normal", "low"];
+export type TaskPriority = (typeof TASK_PRIORITIES)[number];
+/** Extended record: satisfies OperatorTask (numeric deadline) and carries the ISO original. */
+export interface TaskRecord extends OperatorTask {
+    status: TaskStatus;
+    priority: TaskPriority;
+    /** ISO YYYY-MM-DD as stored; `deadline` (OperatorTask) is its UTC-midnight epoch ms. */
+    deadlineIso: string | null;
+    assignee: string | null;
+    sourceChannel: string | null;
+    sourceEventId: string | null;
+    latestEvent: string | null;
+    autoCreated: boolean;
+    confirmed: boolean;
+}
+export interface CreateTaskInput {
+    title: string;
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    assignee?: string;
+    /** ISO YYYY-MM-DD */
+    deadline?: string;
+    /** channelKey: "<connector>:<channelId>" */
+    source_channel?: string;
+    /** Idempotency key from the connector event; duplicate (channel, event) UPSERTS. */
+    source_event_id?: string;
+    latest_event?: string;
+    confirmed?: boolean;
+}
+export interface UpdateTaskInput {
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    assignee?: string | null;
+    deadline?: string | null;
+    latest_event?: string;
+    confirmed?: boolean;
+    title?: string;
+}
+export interface ListTasksFilter {
+    status?: TaskStatus;
+    channel?: string;
+    search?: string;
+    limit?: number;
+    /** 'deadline_priority' = deadline asc NULLS LAST, then high>normal>low, then id. */
+    order?: 'deadline_priority' | 'updated';
+}
+export declare class TaskLedger implements TaskSource {
+    private db;
+    constructor(db: SQLiteDatabase);
+    private runMigration;
+    /** TaskSource conformance: open items in canonical board order. */
+    getTasks(): OperatorTask[];
+    countOpenUnconfirmed(): number;
+    list(filter?: ListTasksFilter): TaskRecord[];
+    getById(id: number): TaskRecord | null;
+    /**
+     * Create a task. Idempotent under at-least-once delivery: a duplicate
+     * (source_channel, source_event_id) UPSERTS - the existing row gets the new
+     * latest_event (and title stays) instead of a near-duplicate row appearing.
+     */
+    create(input: CreateTaskInput): TaskRecord;
+    update(id: number, patch: UpdateTaskInput): TaskRecord;
+    /** Stable hash over ordered rows - the Phase-2 verifier's ledger snapshot. */
+    payloadHash(): string;
+    /** contract_no_update: silence as a verifiable judgment, scoped to one reconcile run. */
+    recordNoUpdate(scope: string, reason: string): {
+        id: number;
+    };
+    /** Max no-update note id, optionally scoped - the verifier's note snapshot. */
+    maxNoUpdateId(scope?: string): number;
+}
+//# sourceMappingURL=task-ledger.d.ts.map

package/dist/operator/task-ledger.d.ts.map

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

package/dist/operator/task-ledger.js

@@ -0,0 +1,277 @@
+"use strict";
+/**
+ * TaskLedger - the operator-owned native work-item ledger (M8 Task 0.1).
+ *
+ * Ports the SHAPE of Kagemusha's proven task store (11 columns: id/title/status/
+ * priority/deadline/source/auto_created/confirmed/timestamps) plus `assignee`
+ * and an idempotency key. Implements the pre-existing `TaskSource` interface
+ * (operator-interfaces.ts) so the board projects ONE task model, not two.
+ *
+ * Reconcile runs create/update rows through the task_create/task_update gateway
+ * tools; the pipeline board slot is a projection of `list({order:
+ * 'deadline_priority'})`. The AGENT makes every judgment about what becomes a
+ * task; this store only persists.
+ *
+ * Schema-extension note: CREATE TABLE IF NOT EXISTS is a no-op on existing
+ * tables. Any post-ship column addition needs an explicit ALTER TABLE guarded
+ * by a PRAGMA table_info check, added to runMigration().
+ *
+ * The db handle is SHARED with TriggerRegistry and owned by the caller
+ * (start.ts opens and closes it once) - deliberately no close() here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskLedger = exports.TASK_PRIORITIES = exports.TASK_STATUSES = void 0;
+const node_crypto_1 = require("node:crypto");
+exports.TASK_STATUSES = [
+    'pending',
+    'in_progress',
+    'review',
+    'blocked',
+    'done',
+    'cancelled',
+];
+exports.TASK_PRIORITIES = ['high', 'normal', 'low'];
+const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+function isoToEpochMs(iso) {
+    if (!iso)
+        return null;
+    const ms = Date.parse(`${iso}T00:00:00Z`);
+    return Number.isNaN(ms) ? null : ms;
+}
+function assertEnum(value, allowed, field) {
+    if (!allowed.includes(value)) {
+        throw new Error(`${field} must be one of ${allowed.join('|')}, got: ${value}`);
+    }
+}
+function assertIsoDate(value, field) {
+    const match = ISO_DATE_PATTERN.exec(value);
+    if (!match) {
+        throw new Error(`${field} must be an ISO date (YYYY-MM-DD), got: ${value}`);
+    }
+    const [year, month, day] = value.split('-').map(Number);
+    const date = new Date(Date.UTC(year, month - 1, day));
+    const isRoundTrip = date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+    if (!isRoundTrip) {
+        throw new Error(`${field} must be an ISO date (YYYY-MM-DD), got: ${value}`);
+    }
+}
+function rowToRecord(row) {
+    return {
+        id: row.id,
+        title: row.title,
+        status: row.status,
+        priority: row.priority,
+        deadline: isoToEpochMs(row.deadline),
+        deadlineIso: row.deadline,
+        assignee: row.assignee,
+        sourceChannel: row.source_channel,
+        sourceEventId: row.source_event_id,
+        latestEvent: row.latest_event,
+        autoCreated: row.auto_created === 1,
+        confirmed: row.confirmed === 1,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+class TaskLedger {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.runMigration();
+    }
+    runMigration() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS operator_tasks (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        title TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'pending'
+          CHECK (status IN ('pending','in_progress','review','blocked','done','cancelled')),
+        priority TEXT NOT NULL DEFAULT 'normal' CHECK (priority IN ('high','normal','low')),
+        assignee TEXT,
+        deadline TEXT,
+        source_channel TEXT,
+        source_event_id TEXT,
+        latest_event TEXT,
+        auto_created INTEGER NOT NULL DEFAULT 1,
+        confirmed INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_operator_tasks_source
+        ON operator_tasks(source_channel, source_event_id)
+        WHERE source_event_id IS NOT NULL;
+      CREATE INDEX IF NOT EXISTS idx_operator_tasks_status ON operator_tasks(status);
+      CREATE INDEX IF NOT EXISTS idx_operator_tasks_deadline ON operator_tasks(deadline);
+
+      CREATE TABLE IF NOT EXISTS operator_no_update_notes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        scope TEXT NOT NULL,
+        reason TEXT NOT NULL,
+        created_at INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_operator_no_update_scope
+        ON operator_no_update_notes(scope, id);
+    `);
+    }
+    /** TaskSource conformance: open items in canonical board order. */
+    getTasks() {
+        return this.list({ order: 'deadline_priority' });
+    }
+    countOpenUnconfirmed() {
+        const row = this.db
+            .prepare(`SELECT COUNT(*) AS count
+         FROM operator_tasks
+         WHERE auto_created = 1
+           AND confirmed = 0
+           AND status NOT IN ('done', 'cancelled')`)
+            .get();
+        return row.count;
+    }
+    list(filter = {}) {
+        const where = [];
+        const params = [];
+        if (filter.status) {
+            where.push('status = ?');
+            params.push(filter.status);
+        }
+        if (filter.channel) {
+            where.push('source_channel = ?');
+            params.push(filter.channel);
+        }
+        if (filter.search) {
+            where.push('(title LIKE ? OR latest_event LIKE ? OR assignee LIKE ?)');
+            const like = `%${filter.search}%`;
+            params.push(like, like, like);
+        }
+        const order = filter.order === 'updated'
+            ? 'updated_at DESC, id DESC'
+            : // deadline asc NULLS LAST, then priority high>normal>low, then id.
+                // LIMIT applies AFTER ordering so the true top-N is returned.
+                `CASE WHEN deadline IS NULL THEN 1 ELSE 0 END ASC, deadline ASC,
+           CASE priority WHEN 'high' THEN 0 WHEN 'normal' THEN 1 ELSE 2 END ASC, id ASC`;
+        const rawLimit = Number(filter.limit);
+        const limit = Number.isFinite(rawLimit) ? Math.max(1, Math.min(200, Math.floor(rawLimit))) : 50;
+        const rows = this.db
+            .prepare(`SELECT * FROM operator_tasks
+         ${where.length > 0 ? `WHERE ${where.join(' AND ')}` : ''}
+         ORDER BY ${order}
+         LIMIT ?`)
+            .all(...params, limit);
+        return rows.map(rowToRecord);
+    }
+    getById(id) {
+        const row = this.db.prepare(`SELECT * FROM operator_tasks WHERE id = ?`).get(id);
+        return row ? rowToRecord(row) : null;
+    }
+    /**
+     * Create a task. Idempotent under at-least-once delivery: a duplicate
+     * (source_channel, source_event_id) UPSERTS - the existing row gets the new
+     * latest_event (and title stays) instead of a near-duplicate row appearing.
+     */
+    create(input) {
+        if (!input.title || input.title.trim() === '') {
+            throw new Error('task title must be a non-empty string');
+        }
+        if (input.status !== undefined)
+            assertEnum(input.status, exports.TASK_STATUSES, 'status');
+        if (input.priority !== undefined)
+            assertEnum(input.priority, exports.TASK_PRIORITIES, 'priority');
+        if (input.deadline !== undefined)
+            assertIsoDate(input.deadline, 'deadline');
+        const now = Date.now();
+        if (input.source_channel && input.source_event_id) {
+            const existing = this.db
+                .prepare(`SELECT * FROM operator_tasks WHERE source_channel = ? AND source_event_id = ?`)
+                .get(input.source_channel, input.source_event_id);
+            if (existing) {
+                // Upsert carries every provided field EXCEPT title (the original naming
+                // stays stable across retries; movement and state updates flow through).
+                return this.update(existing.id, {
+                    ...(input.status !== undefined ? { status: input.status } : {}),
+                    ...(input.priority !== undefined ? { priority: input.priority } : {}),
+                    ...(input.assignee !== undefined ? { assignee: input.assignee } : {}),
+                    ...(input.deadline !== undefined ? { deadline: input.deadline } : {}),
+                    ...(input.confirmed !== undefined ? { confirmed: input.confirmed } : {}),
+                    ...(input.latest_event !== undefined ? { latest_event: input.latest_event } : {}),
+                });
+            }
+        }
+        const result = this.db
+            .prepare(`INSERT INTO operator_tasks
+           (title, status, priority, assignee, deadline, source_channel, source_event_id,
+            latest_event, auto_created, confirmed, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(input.title.trim(), input.status ?? 'pending', input.priority ?? 'normal', input.assignee ?? null, input.deadline ?? null, input.source_channel ?? null, input.source_event_id ?? null, input.latest_event ?? null, 1, input.confirmed ? 1 : 0, now, now);
+        const created = this.getById(Number(result.lastInsertRowid));
+        if (!created)
+            throw new Error('task_create: inserted row could not be read back');
+        return created;
+    }
+    update(id, patch) {
+        const existing = this.getById(id);
+        if (!existing)
+            throw new Error(`task_update: no task with id ${id}`);
+        if (patch.status !== undefined)
+            assertEnum(patch.status, exports.TASK_STATUSES, 'status');
+        if (patch.priority !== undefined)
+            assertEnum(patch.priority, exports.TASK_PRIORITIES, 'priority');
+        if (patch.deadline !== undefined && patch.deadline !== null) {
+            assertIsoDate(patch.deadline, 'deadline');
+        }
+        if (patch.title !== undefined && patch.title.trim() === '') {
+            throw new Error('task title must be a non-empty string');
+        }
+        const sets = ['updated_at = ?'];
+        const params = [Date.now()];
+        const assign = (column, value) => {
+            sets.push(`${column} = ?`);
+            params.push(value);
+        };
+        if (patch.title !== undefined)
+            assign('title', patch.title.trim());
+        if (patch.status !== undefined)
+            assign('status', patch.status);
+        if (patch.priority !== undefined)
+            assign('priority', patch.priority);
+        if (patch.assignee !== undefined)
+            assign('assignee', patch.assignee);
+        if (patch.deadline !== undefined)
+            assign('deadline', patch.deadline);
+        if (patch.latest_event !== undefined)
+            assign('latest_event', patch.latest_event);
+        if (patch.confirmed !== undefined)
+            assign('confirmed', patch.confirmed ? 1 : 0);
+        this.db.prepare(`UPDATE operator_tasks SET ${sets.join(', ')} WHERE id = ?`).run(...params, id);
+        return this.getById(id);
+    }
+    /** Stable hash over ordered rows - the Phase-2 verifier's ledger snapshot. */
+    payloadHash() {
+        const rows = this.db
+            .prepare(`SELECT id, title, status, priority, assignee, deadline, latest_event, confirmed,
+                updated_at
+         FROM operator_tasks ORDER BY id ASC`)
+            .all();
+        return (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(rows)).digest('hex');
+    }
+    /** contract_no_update: silence as a verifiable judgment, scoped to one reconcile run. */
+    recordNoUpdate(scope, reason) {
+        if (!scope || !reason) {
+            throw new Error('contract_no_update requires both scope and reason');
+        }
+        const result = this.db
+            .prepare(`INSERT INTO operator_no_update_notes (scope, reason, created_at) VALUES (?, ?, ?)`)
+            .run(scope, reason, Date.now());
+        return { id: Number(result.lastInsertRowid) };
+    }
+    /** Max no-update note id, optionally scoped - the verifier's note snapshot. */
+    maxNoUpdateId(scope) {
+        const row = (scope
+            ? this.db
+                .prepare(`SELECT MAX(id) AS max_id FROM operator_no_update_notes WHERE scope = ?`)
+                .get(scope)
+            : this.db.prepare(`SELECT MAX(id) AS max_id FROM operator_no_update_notes`).get());
+        return row.max_id ?? 0;
+    }
+}
+exports.TaskLedger = TaskLedger;
+//# sourceMappingURL=task-ledger.js.map

package/dist/operator/task-ledger.js.map

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