reflectt-node 0.1.0

package/dist/suppression-ledger.js

@@ -0,0 +1,125 @@
+// SPDX-License-Identifier: Apache-2.0
+// Persistent suppression ledger for system message deduplication
+//
+// Tracks dedup keys (category + channel + content hash) in SQLite.
+// Prevents duplicate system messages within a configurable window (default 30m).
+import { createHash } from 'crypto';
+import { getDb } from './db.js';
+const DEFAULT_WINDOW_MS = 30 * 60 * 1000; // 30 minutes
+export class SuppressionLedger {
+    windowMs;
+    constructor(windowMs) {
+        this.windowMs = windowMs ?? DEFAULT_WINDOW_MS;
+    }
+    /**
+     * Compute a dedup key from category + channel + content.
+     * Content is normalized: timestamps, task IDs, and message IDs stripped.
+     */
+    computeDedupKey(category, channel, content) {
+        const normalized = content
+            .trim()
+            .toLowerCase()
+            .replace(/\b(msg-|task-|tcomment-|ins-|ref-)\S+/g, '')
+            .replace(/\d{13,}/g, '')
+            .replace(/\s+/g, ' ')
+            .slice(0, 300);
+        const raw = `${category}:${channel}:${normalized}`;
+        return createHash('sha256').update(raw).digest('hex').substring(0, 20);
+    }
+    /**
+     * Check if a message is a duplicate within the suppression window.
+     * If not a duplicate, records it in the ledger.
+     * If duplicate, increments the hit count and marks as suppressed.
+     */
+    check(opts) {
+        const dedup_key = this.computeDedupKey(opts.category, opts.channel, opts.content);
+        const now = Date.now();
+        const db = getDb();
+        const existing = db.prepare('SELECT * FROM suppression_ledger WHERE dedup_key = ?').get(dedup_key);
+        if (existing && (now - existing.last_seen_at) < this.windowMs) {
+            // Duplicate within window — update hit count
+            db.prepare('UPDATE suppression_ledger SET hit_count = hit_count + 1, last_seen_at = ?, suppressed = 1 WHERE dedup_key = ?').run(now, dedup_key);
+            return {
+                isDuplicate: true,
+                dedup_key,
+                existing: {
+                    ...existing,
+                    suppressed: true,
+                    hit_count: existing.hit_count + 1,
+                    last_seen_at: now,
+                },
+            };
+        }
+        // Not a duplicate (or outside window) — upsert
+        db.prepare(`
+      INSERT INTO suppression_ledger (dedup_key, category, channel, "from", content_preview, first_seen_at, last_seen_at, hit_count, suppressed, window_ms)
+      VALUES (?, ?, ?, ?, ?, ?, ?, 1, 0, ?)
+      ON CONFLICT(dedup_key) DO UPDATE SET
+        last_seen_at = excluded.last_seen_at,
+        hit_count = 1,
+        suppressed = 0,
+        "from" = excluded."from",
+        content_preview = excluded.content_preview,
+        window_ms = excluded.window_ms
+    `).run(dedup_key, opts.category, opts.channel, opts.from, opts.content.slice(0, 200), now, now, this.windowMs);
+        return { isDuplicate: false, dedup_key };
+    }
+    /**
+     * Get suppression statistics.
+     */
+    getStats() {
+        const db = getDb();
+        const now = Date.now();
+        const activeCutoff = now - this.windowMs;
+        const total = db.prepare('SELECT COUNT(*) as c FROM suppression_ledger').get().c;
+        const totalSuppressed = db.prepare('SELECT COUNT(*) as c FROM suppression_ledger WHERE suppressed = 1').get().c;
+        const totalHitsRow = db.prepare('SELECT COALESCE(SUM(hit_count), 0) as s FROM suppression_ledger').get();
+        const activeEntries = db.prepare('SELECT COUNT(*) as c FROM suppression_ledger WHERE last_seen_at >= ?').get(activeCutoff).c;
+        const byCatRows = db.prepare(`
+      SELECT category,
+        COUNT(*) as entries,
+        SUM(CASE WHEN suppressed = 1 THEN 1 ELSE 0 END) as suppressed,
+        SUM(hit_count) as hits
+      FROM suppression_ledger GROUP BY category
+    `).all();
+        const byChannelRows = db.prepare(`
+      SELECT channel,
+        COUNT(*) as entries,
+        SUM(CASE WHEN suppressed = 1 THEN 1 ELSE 0 END) as suppressed,
+        SUM(hit_count) as hits
+      FROM suppression_ledger GROUP BY channel
+    `).all();
+        return {
+            total_entries: total,
+            total_suppressed: totalSuppressed,
+            total_hits: totalHitsRow.s,
+            by_category: Object.fromEntries(byCatRows.map(r => [r.category, { entries: r.entries, suppressed: r.suppressed, hits: r.hits }])),
+            by_channel: Object.fromEntries(byChannelRows.map(r => [r.channel, { entries: r.entries, suppressed: r.suppressed, hits: r.hits }])),
+            window_ms: this.windowMs,
+            active_entries: activeEntries,
+        };
+    }
+    /**
+     * Prune old entries outside the window.
+     */
+    prune() {
+        const db = getDb();
+        const cutoff = Date.now() - this.windowMs * 10; // Keep 10x window for stats
+        const result = db.prepare('DELETE FROM suppression_ledger WHERE last_seen_at < ?').run(cutoff);
+        return result.changes;
+    }
+    /**
+     * Get window in ms.
+     */
+    getWindowMs() {
+        return this.windowMs;
+    }
+    /**
+     * Update window.
+     */
+    setWindowMs(ms) {
+        this.windowMs = ms;
+    }
+}
+export const suppressionLedger = new SuppressionLedger();
+//# sourceMappingURL=suppression-ledger.js.map

package/dist/suppression-ledger.js.map

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

package/dist/system-loop-state.d.ts

@@ -0,0 +1,4 @@
+export type SystemLoopName = 'idle_nudge' | 'cadence_watchdog' | 'mention_rescue' | 'reflection_pipeline' | 'board_health';
+export declare function recordSystemLoopTick(name: SystemLoopName, now?: number): void;
+export declare function getSystemLoopTicks(): Record<SystemLoopName, number>;
+//# sourceMappingURL=system-loop-state.d.ts.map

package/dist/system-loop-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-loop-state.d.ts","sourceRoot":"","sources":["../src/system-loop-state.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,kBAAkB,GAClB,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,CAAA;AAElB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,SAAa,GAAG,IAAI,CAWjF;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAqBnE"}

package/dist/system-loop-state.js

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Persisted loop tick timestamps (SQLite) so /health/system can prove that
+ * timers/watchdogs are actually firing (and not just configured).
+ */
+import { getDb } from './db.js';
+export function recordSystemLoopTick(name, now = Date.now()) {
+    const db = getDb();
+    try {
+        db.prepare(`INSERT INTO system_loop_ticks (name, last_tick_at)
+       VALUES (?, ?)
+       ON CONFLICT(name) DO UPDATE SET last_tick_at = excluded.last_tick_at`).run(name, now);
+    }
+    catch {
+        // Best-effort: DB may be unavailable in some unit test contexts.
+    }
+}
+export function getSystemLoopTicks() {
+    const db = getDb();
+    const out = {
+        idle_nudge: 0,
+        cadence_watchdog: 0,
+        mention_rescue: 0,
+        reflection_pipeline: 0,
+        board_health: 0,
+    };
+    try {
+        const rows = db.prepare('SELECT name, last_tick_at FROM system_loop_ticks').all();
+        for (const r of rows) {
+            const name = String(r.name);
+            if (name in out)
+                out[name] = Number(r.last_tick_at || 0);
+        }
+    }
+    catch {
+        // ignore
+    }
+    return out;
+}
+//# sourceMappingURL=system-loop-state.js.map

package/dist/system-loop-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-loop-state.js","sourceRoot":"","sources":["../src/system-loop-state.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAS/B,MAAM,UAAU,oBAAoB,CAAC,IAAoB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACzE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,IAAI,CAAC;QACH,EAAE,CAAC,OAAO,CACR;;4EAEsE,CACvE,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,MAAM,GAAG,GAAmC;QAC1C,UAAU,EAAE,CAAC;QACb,gBAAgB,EAAE,CAAC;QACnB,cAAc,EAAE,CAAC;QACjB,mBAAmB,EAAE,CAAC;QACtB,YAAY,EAAE,CAAC;KAChB,CAAA;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC,GAAG,EAAmD,CAAA;QAClI,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAmB,CAAA;YAC7C,IAAI,IAAI,IAAI,GAAG;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/taskCommentIngest.d.ts

@@ -0,0 +1,43 @@
+export type TaskCommentProvenance = {
+    source_channel?: string;
+    sender_id?: string;
+    original_message_id?: string;
+    integration?: string;
+    [k: string]: unknown;
+};
+export type TaskCommentReject = {
+    attempted_task_param: string;
+    resolved_task_id?: string | null;
+    author?: string | null;
+    content?: string | null;
+    reason: 'task_not_found' | 'invalid_task_refs' | 'other';
+    details?: Record<string, unknown>;
+    provenance?: TaskCommentProvenance;
+    timestamp?: number;
+};
+export declare function ensureTaskCommentRejectTable(): void;
+export declare function recordTaskCommentReject(input: TaskCommentReject): {
+    id: string;
+};
+export interface TaskCommentRejectRow {
+    id: string;
+    attempted_task_param: string;
+    resolved_task_id: string | null;
+    author: string | null;
+    content: string | null;
+    reason: string;
+    details: string | null;
+    provenance: string | null;
+    timestamp: number;
+}
+/** Query the reject ledger with optional filters. */
+export declare function listTaskCommentRejects(opts?: {
+    limit?: number;
+    reason?: string;
+    author?: string;
+    since?: number;
+}): {
+    rejects: TaskCommentRejectRow[];
+    total: number;
+};
+//# sourceMappingURL=taskCommentIngest.d.ts.map

package/dist/taskCommentIngest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskCommentIngest.d.ts","sourceRoot":"","sources":["../src/taskCommentIngest.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,OAAO,CAAA;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAkBnD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAuBhF;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qDAAqD;AACrD,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG;IAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA6BrD"}

package/dist/taskCommentIngest.js

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: Apache-2.0
+// Task-comment ingestion observability + reject ledger
+import { getDb, safeJsonStringify } from './db.js';
+export function ensureTaskCommentRejectTable() {
+    const db = getDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS task_comment_ingest_rejects (
+      id TEXT PRIMARY KEY,
+      attempted_task_param TEXT NOT NULL,
+      resolved_task_id TEXT,
+      author TEXT,
+      content TEXT,
+      reason TEXT NOT NULL,
+      details TEXT,
+      provenance TEXT,
+      timestamp INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_task_comment_rejects_ts ON task_comment_ingest_rejects(timestamp);
+    CREATE INDEX IF NOT EXISTS idx_task_comment_rejects_reason ON task_comment_ingest_rejects(reason);
+    CREATE INDEX IF NOT EXISTS idx_task_comment_rejects_author ON task_comment_ingest_rejects(author);
+  `);
+}
+export function recordTaskCommentReject(input) {
+    ensureTaskCommentRejectTable();
+    const db = getDb();
+    const now = input.timestamp ?? Date.now();
+    const id = `tcrej-${now}-${Math.random().toString(36).slice(2, 10)}`;
+    db.prepare(`
+    INSERT INTO task_comment_ingest_rejects (
+      id, attempted_task_param, resolved_task_id, author, content, reason, details, provenance, timestamp
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, input.attempted_task_param, input.resolved_task_id ?? null, input.author ?? null, input.content ?? null, input.reason, safeJsonStringify(input.details ?? null), safeJsonStringify(input.provenance ?? null), now);
+    return { id };
+}
+/** Query the reject ledger with optional filters. */
+export function listTaskCommentRejects(opts) {
+    ensureTaskCommentRejectTable();
+    const db = getDb();
+    const limit = Math.min(opts?.limit ?? 50, 200);
+    const conditions = [];
+    const params = [];
+    if (opts?.reason) {
+        conditions.push('reason = ?');
+        params.push(opts.reason);
+    }
+    if (opts?.author) {
+        conditions.push('author = ?');
+        params.push(opts.author);
+    }
+    if (opts?.since) {
+        conditions.push('timestamp >= ?');
+        params.push(opts.since);
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const total = db.prepare(`SELECT COUNT(*) as cnt FROM task_comment_ingest_rejects ${where}`).get(...params).cnt;
+    const rows = db.prepare(`SELECT * FROM task_comment_ingest_rejects ${where} ORDER BY timestamp DESC LIMIT ?`).all(...params, limit);
+    return { rejects: rows, total };
+}
+//# sourceMappingURL=taskCommentIngest.js.map

package/dist/taskCommentIngest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskCommentIngest.js","sourceRoot":"","sources":["../src/taskCommentIngest.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,uDAAuD;AAEvD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAsBlD,MAAM,UAAU,4BAA4B;IAC1C,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;GAeP,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,4BAA4B,EAAE,CAAA;IAC9B,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;IACzC,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;IAEpE,EAAE,CAAC,OAAO,CAAC;;;;GAIV,CAAC,CAAC,GAAG,CACJ,EAAE,EACF,KAAK,CAAC,oBAAoB,EAC1B,KAAK,CAAC,gBAAgB,IAAI,IAAI,EAC9B,KAAK,CAAC,MAAM,IAAI,IAAI,EACpB,KAAK,CAAC,OAAO,IAAI,IAAI,EACrB,KAAK,CAAC,MAAM,EACZ,iBAAiB,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,EACxC,iBAAiB,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,EAC3C,GAAG,CACJ,CAAA;IAED,OAAO,EAAE,EAAE,EAAE,CAAA;AACf,CAAC;AAcD,qDAAqD;AACrD,MAAM,UAAU,sBAAsB,CAAC,IAKtC;IACC,4BAA4B,EAAE,CAAA;IAC9B,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;IAC9C,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAc,EAAE,CAAA;IAE5B,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QACjC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAE9E,MAAM,KAAK,GAAI,EAAE,CAAC,OAAO,CAAC,2DAA2D,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAqB,CAAC,GAAG,CAAA;IAEpI,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB,6CAA6C,KAAK,kCAAkC,CACrF,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAA2B,CAAA;IAEjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AACjC,CAAC"}

package/dist/taskPrecheck.d.ts

@@ -0,0 +1,20 @@
+export type PrecheckSeverity = 'error' | 'warning' | 'info';
+export interface PrecheckItem {
+    field: string;
+    severity: PrecheckSeverity;
+    message: string;
+    hint?: string;
+    autoDefault?: unknown;
+}
+export interface PrecheckResult {
+    taskId: string;
+    currentStatus: string;
+    targetStatus: string;
+    ready: boolean;
+    items: PrecheckItem[];
+    autoDefaults: Record<string, unknown>;
+    template: Record<string, unknown> | null;
+}
+export declare function runPrecheck(taskId: string, targetStatus: string): PrecheckResult;
+export declare function applyAutoDefaults(taskId: string, targetStatus: string, metadata: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=taskPrecheck.d.ts.map

package/dist/taskPrecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskPrecheck.d.ts","sourceRoot":"","sources":["../src/taskPrecheck.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAE3D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACzC;AAcD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,CAiRhF;AAID,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB"}

package/dist/taskPrecheck.js

@@ -0,0 +1,329 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Task Transition Precheck
+ *
+ * Surfaces required fields BEFORE a status transition attempt,
+ * so agents don't get rejected at gate time.
+ *
+ * Also provides auto-defaults for common fields (ETA, artifact path).
+ */
+import { taskManager } from './tasks.js';
+import { policyManager } from './policy.js';
+// ── Default ETA by priority ────────────────────────────────────────────────
+const DEFAULT_ETA_BY_PRIORITY = {
+    P0: '~30m',
+    P1: '~2h',
+    P2: '~4h',
+    P3: '~1d',
+    P4: '~3d',
+};
+// ── Precheck ───────────────────────────────────────────────────────────────
+export function runPrecheck(taskId, targetStatus) {
+    const task = taskManager.getTask(taskId);
+    if (!task) {
+        return {
+            taskId,
+            currentStatus: 'unknown',
+            targetStatus,
+            ready: false,
+            items: [{ field: 'task', severity: 'error', message: `Task ${taskId} not found` }],
+            autoDefaults: {},
+            template: null,
+        };
+    }
+    const items = [];
+    const autoDefaults = {};
+    const meta = task.metadata || {};
+    // ── Common gates (all non-todo statuses) ────────────────────────────
+    if (targetStatus !== 'todo') {
+        if (!task.done_criteria || task.done_criteria.length === 0) {
+            items.push({
+                field: 'done_criteria',
+                severity: 'error',
+                message: 'done_criteria required (at least 1 item)',
+                hint: 'Add specific, verifiable completion criteria.',
+            });
+        }
+        if (!task.reviewer?.trim()) {
+            items.push({
+                field: 'reviewer',
+                severity: 'error',
+                message: 'reviewer required before starting work',
+                hint: 'Assign a reviewer who can validate the work.',
+            });
+        }
+        // Warn-only: lane + surface metadata (routing + ownership discipline)
+        // Do not hard-block yet — just surface what to add.
+        if (!String(meta.lane || '').trim()) {
+            items.push({
+                field: 'metadata.lane',
+                severity: 'warning',
+                message: 'metadata.lane missing (recommended for routing + lane ownership)',
+                hint: 'Set metadata.lane to one of: design | product | infra | ops | growth',
+            });
+        }
+        if (!String(meta.surface || '').trim()) {
+            items.push({
+                field: 'metadata.surface',
+                severity: 'warning',
+                message: 'metadata.surface missing (recommended for routing + priority triage)',
+                hint: 'Set metadata.surface to one of: reflectt-node | reflectt-cloud-app | reflectt.ai | infra',
+            });
+        }
+    }
+    // ── doing ───────────────────────────────────────────────────────────
+    if (targetStatus === 'doing') {
+        const eta = meta.eta;
+        if (!eta?.trim()) {
+            const defaultEta = DEFAULT_ETA_BY_PRIORITY[task.priority || 'P2'] || '~4h';
+            items.push({
+                field: 'metadata.eta',
+                severity: 'warning',
+                message: `ETA required. Auto-default available: "${defaultEta}" (based on ${task.priority || 'P2'} priority)`,
+                hint: 'Provide explicit ETA or accept the auto-default.',
+                autoDefault: defaultEta,
+            });
+            autoDefaults['metadata.eta'] = defaultEta;
+        }
+    }
+    // ── validating ──────────────────────────────────────────────────────
+    if (targetStatus === 'validating') {
+        // Detect non-code task (explicit flag or lane-based)
+        const handoff = meta.review_handoff;
+        const isNonCode = handoff?.non_code === true || handoff?.doc_only === true || handoff?.config_only === true;
+        // Artifact path
+        const artifactPath = meta.artifact_path;
+        if (!artifactPath?.trim()) {
+            const suggestedPath = `process/TASK-${taskId.split('-').pop()}.md`;
+            items.push({
+                field: 'metadata.artifact_path',
+                severity: isNonCode ? 'warning' : 'error',
+                message: isNonCode ? 'artifact_path recommended' : 'artifact_path required under process/',
+                hint: `Suggested: "${suggestedPath}"`,
+                autoDefault: suggestedPath,
+            });
+            autoDefaults['metadata.artifact_path'] = suggestedPath;
+        }
+        else if (!isNonCode && !artifactPath.startsWith('process/')) {
+            items.push({
+                field: 'metadata.artifact_path',
+                severity: 'error',
+                message: 'artifact_path must be under process/ (repo-relative)',
+            });
+        }
+        // Review handoff (reuse handoff from above)
+        if (!handoff) {
+            items.push({
+                field: 'metadata.review_handoff',
+                severity: 'error',
+                message: 'review_handoff object required for validating transition',
+                hint: 'Must include: task_id, known_caveats. For code tasks: also artifact_path, test_proof, pr_url, commit_sha. For non-code tasks: set non_code=true.',
+            });
+        }
+        else {
+            if (!handoff.task_id) {
+                items.push({ field: 'metadata.review_handoff.task_id', severity: 'error', message: 'task_id required in review_handoff' });
+            }
+            else if (handoff.task_id !== taskId) {
+                items.push({ field: 'metadata.review_handoff.task_id', severity: 'error', message: `task_id must match: expected "${taskId}"` });
+            }
+            if (!isNonCode && !handoff.artifact_path) {
+                items.push({ field: 'metadata.review_handoff.artifact_path', severity: 'error', message: 'artifact_path required in review_handoff (or set non_code=true)' });
+            }
+            if (!isNonCode && !handoff.test_proof) {
+                items.push({ field: 'metadata.review_handoff.test_proof', severity: 'error', message: 'test_proof required (e.g. "vitest run: 206 pass") — or set non_code=true' });
+            }
+            if (handoff.known_caveats === undefined) {
+                items.push({ field: 'metadata.review_handoff.known_caveats', severity: 'error', message: 'known_caveats required (use "none" if none)' });
+            }
+            const isDocOnly = handoff.doc_only === true;
+            const isConfigOnly = handoff.config_only === true;
+            if (!isNonCode && !isDocOnly && !isConfigOnly) {
+                if (!handoff.pr_url) {
+                    items.push({ field: 'metadata.review_handoff.pr_url', severity: 'error', message: 'PR URL required (or set doc_only/config_only/non_code=true)' });
+                }
+                if (!handoff.commit_sha) {
+                    items.push({ field: 'metadata.review_handoff.commit_sha', severity: 'error', message: 'commit SHA required (or set doc_only/config_only/non_code=true)' });
+                }
+            }
+        }
+        // QA bundle
+        const qaBundle = meta.qa_bundle;
+        if (!qaBundle) {
+            items.push({
+                field: 'metadata.qa_bundle',
+                severity: 'warning',
+                message: 'qa_bundle recommended for validating (summary, artifact_links, checks, lane, changed_files, screenshot_proof)',
+                hint: 'Include: { summary, artifact_links: [], checks: [], lane, pr_link, commit_shas: [], changed_files: [], screenshot_proof: [] }',
+            });
+        }
+        else {
+            if (!qaBundle.summary)
+                items.push({ field: 'metadata.qa_bundle.summary', severity: 'warning', message: 'qa_bundle.summary recommended' });
+            if (!Array.isArray(qaBundle.checks) || qaBundle.checks.length === 0) {
+                items.push({ field: 'metadata.qa_bundle.checks', severity: 'warning', message: 'qa_bundle.checks recommended (e.g. ["tsc clean", "vitest 206 pass"])' });
+            }
+            if (!Array.isArray(qaBundle.changed_files) || qaBundle.changed_files.length === 0) {
+                items.push({ field: 'metadata.qa_bundle.changed_files', severity: 'warning', message: 'qa_bundle.changed_files recommended' });
+            }
+        }
+        // Duplicate-closure contract
+        // If a task is being closed/validated as a "duplicate", we must include a canonical reference
+        // (PR/commit/task id) so reviewers aren't asked to approve an N/A proof packet.
+        const isDuplicateClosure = (typeof meta.auto_close_reason === 'string' && meta.auto_close_reason.toLowerCase().includes('duplicate')) ||
+            Boolean(meta.duplicate_of) ||
+            (meta.qa_bundle && meta.qa_bundle.lane === 'duplicate-closure');
+        if (isDuplicateClosure) {
+            const dupeOf = meta.duplicate_of;
+            const canonicalPr = (meta.canonical_pr || meta.canonicalPr);
+            const canonicalCommit = (meta.canonical_commit || meta.canonicalCommit);
+            if (!dupeOf?.trim()) {
+                items.push({
+                    field: 'metadata.duplicate_of',
+                    severity: 'error',
+                    message: 'duplicate closure requires duplicate_of (canonical task id)',
+                    hint: "Set metadata.duplicate_of to the canonical task id you're duplicating (e.g. task-...).",
+                });
+            }
+            const hasCanonicalRef = (typeof canonicalPr === 'string' && canonicalPr.startsWith('http')) ||
+                (typeof handoff?.pr_url === 'string' && handoff.pr_url.startsWith('http'));
+            if (!hasCanonicalRef) {
+                items.push({
+                    field: 'metadata.canonical_pr',
+                    severity: 'error',
+                    message: 'duplicate closure requires a canonical PR link (canonical_pr or review_handoff.pr_url)',
+                    hint: 'Provide the shipped PR URL that satisfies the done criteria.',
+                });
+            }
+            const hasCommitRef = (typeof canonicalCommit === 'string' && canonicalCommit.length >= 7) ||
+                (typeof handoff?.commit_sha === 'string' && (handoff.commit_sha.length >= 7));
+            if (!hasCommitRef) {
+                items.push({
+                    field: 'metadata.canonical_commit',
+                    severity: 'warning',
+                    message: 'duplicate closure should include a canonical commit SHA (canonical_commit or review_handoff.commit_sha)',
+                    hint: 'Include a commit SHA so reviewers can trace the exact shipped state.',
+                });
+            }
+        }
+    }
+    // ── done ────────────────────────────────────────────────────────────
+    if (targetStatus === 'done') {
+        if (!meta.reviewer_approved) {
+            items.push({
+                field: 'metadata.reviewer_approved',
+                severity: 'error',
+                message: 'reviewer_approved must be true before marking done',
+            });
+        }
+        if (!meta.artifact_path && !meta.artifacts) {
+            items.push({
+                field: 'metadata.artifact_path',
+                severity: 'error',
+                message: 'artifact_path or artifacts required for done status',
+            });
+        }
+    }
+    // ── Ready-queue floor warning ────────────────────────────────────────
+    if ((targetStatus === 'validating' || targetStatus === 'done') && task.assignee) {
+        const policy = policyManager.get();
+        const rqf = policy.readyQueueFloor;
+        if (rqf?.enabled && rqf.agents.includes(task.assignee)) {
+            const todoTasks = taskManager.listTasks({ status: 'todo', assignee: task.assignee });
+            const unblockedTodo = todoTasks.filter(t => {
+                const blocked = t.metadata?.blocked_by;
+                if (!blocked)
+                    return true;
+                const blocker = taskManager.getTask(blocked);
+                return !blocker || blocker.status === 'done';
+            });
+            // This task is leaving the queue, so effective count will drop
+            const effectiveReady = unblockedTodo.length;
+            const hasOverride = task.metadata?.readyQueueOverride === true;
+            if (effectiveReady < rqf.minReady && !hasOverride) {
+                const enforce = rqf.enforceBlock !== false; // default to enforced
+                items.push({
+                    field: 'readyQueueFloor',
+                    severity: enforce ? 'error' : 'warning',
+                    message: `Ready queue will be ${effectiveReady}/${rqf.minReady} after this transition. ${enforce ? 'Blocked: queue more tasks for @' + task.assignee + ' before closing.' : 'Ensure next tasks are queued for @' + task.assignee + '.'}`,
+                    hint: enforce
+                        ? 'Next-task-before-close rule: assign at least ' + rqf.minReady + ' todo tasks to @' + task.assignee + ' before this task can move to ' + targetStatus + '. Override with metadata.readyQueueOverride=true.'
+                        : 'Create/assign more todo tasks to maintain engineering lane throughput.',
+                });
+            }
+        }
+    }
+    // ── Build template ──────────────────────────────────────────────────
+    const template = buildTemplate(task, targetStatus, autoDefaults);
+    const hasErrors = items.some(i => i.severity === 'error');
+    return {
+        taskId,
+        currentStatus: task.status,
+        targetStatus,
+        ready: !hasErrors,
+        items,
+        autoDefaults,
+        template,
+    };
+}
+// ── Auto-defaults application ──────────────────────────────────────────────
+export function applyAutoDefaults(taskId, targetStatus, metadata) {
+    const task = taskManager.getTask(taskId);
+    if (!task)
+        return metadata;
+    const result = { ...metadata };
+    // Auto-fill ETA for doing
+    if (targetStatus === 'doing' && !result.eta) {
+        const priority = task.priority || 'P2';
+        result.eta = DEFAULT_ETA_BY_PRIORITY[priority] || '~4h';
+    }
+    // Auto-fill artifact_path for validating
+    if (targetStatus === 'validating' && !result.artifact_path) {
+        const shortId = taskId.split('-').pop();
+        result.artifact_path = `process/TASK-${shortId}.md`;
+    }
+    return result;
+}
+// ── Template builder ───────────────────────────────────────────────────────
+function buildTemplate(task, targetStatus, autoDefaults) {
+    const shortId = task.id.split('-').pop();
+    if (targetStatus === 'doing') {
+        return {
+            status: 'doing',
+            metadata: {
+                eta: autoDefaults['metadata.eta'] || '<required>',
+                branch: `link/task-${shortId}`,
+            },
+        };
+    }
+    if (targetStatus === 'validating') {
+        return {
+            status: 'validating',
+            metadata: {
+                artifact_path: autoDefaults['metadata.artifact_path'] || `process/TASK-${shortId}.md`,
+                review_handoff: {
+                    task_id: task.id,
+                    repo: 'reflectt/reflectt-node',
+                    pr_url: '<required: https://github.com/reflectt/reflectt-node/pull/NNN>',
+                    commit_sha: '<required: 7+ hex chars>',
+                    artifact_path: `process/TASK-${shortId}.md`,
+                    test_proof: '<required: e.g. "vitest run: 206 pass, tsc clean">',
+                    known_caveats: '<required: "none" or description>',
+                },
+                qa_bundle: {
+                    summary: '<recommended>',
+                    artifact_links: ['<PR URL>'],
+                    checks: ['<e.g. tsc clean>', '<vitest NNN pass>'],
+                    lane: '<feature name>',
+                    pr_link: '<PR URL>',
+                    commit_shas: ['<sha>'],
+                    changed_files: ['<file1>', '<file2>'],
+                    screenshot_proof: ['<test output summary>'],
+                },
+            },
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=taskPrecheck.js.map