reflectt-node 0.1.0

package/dist/reflection-automation.js

@@ -0,0 +1,350 @@
+// SPDX-License-Identifier: Apache-2.0
+// Reflection automation — nudges agents to self-reflect after task completion
+// and on idle cadence. Tracks reflection SLA per agent.
+import { getDb } from './db.js';
+import { taskManager } from './tasks.js';
+import { routeMessage } from './messageRouter.js';
+import { policyManager } from './policy.js';
+// ── State ──
+const pendingNudges = [];
+const lastNudgeAt = {};
+// ── Table ──
+export function ensureReflectionTrackingTable() {
+    const db = getDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS reflection_tracking (
+      agent TEXT PRIMARY KEY,
+      last_reflection_at INTEGER,
+      last_nudge_at INTEGER,
+      tasks_done_since_reflection INTEGER NOT NULL DEFAULT 0,
+      updated_at INTEGER NOT NULL
+    );
+  `);
+}
+// ── Core: task completion hook ──
+/**
+ * Called when a task transitions to done. Queues a reflection nudge.
+ */
+export function onTaskDone(task) {
+    const config = getConfig();
+    if (!config.enabled)
+        return;
+    const agent = task.assignee;
+    if (!agent)
+        return;
+    if (config.agents.length > 0 && !config.agents.includes(agent))
+        return;
+    // Increment tasks-done counter
+    ensureReflectionTrackingTable();
+    const db = getDb();
+    db.prepare(`
+    INSERT INTO reflection_tracking (agent, tasks_done_since_reflection, updated_at)
+    VALUES (?, 1, ?)
+    ON CONFLICT(agent) DO UPDATE SET
+      tasks_done_since_reflection = tasks_done_since_reflection + 1,
+      updated_at = ?
+  `).run(agent, Date.now(), Date.now());
+    // Queue nudge after delay
+    const nudgeAt = Date.now() + config.postTaskDelayMin * 60_000;
+    pendingNudges.push({
+        agent,
+        taskId: task.id,
+        taskTitle: task.title,
+        taskStatus: task.status,
+        doneAt: Date.now(),
+        nudgeAt,
+    });
+}
+/**
+ * Called when a reflection is submitted. Resets the agent's tracking.
+ */
+export function onReflectionSubmitted(agent) {
+    ensureReflectionTrackingTable();
+    const db = getDb();
+    db.prepare(`
+    INSERT INTO reflection_tracking (agent, last_reflection_at, tasks_done_since_reflection, updated_at)
+    VALUES (?, ?, 0, ?)
+    ON CONFLICT(agent) DO UPDATE SET
+      last_reflection_at = ?,
+      tasks_done_since_reflection = 0,
+      updated_at = ?
+  `).run(agent, Date.now(), Date.now(), Date.now(), Date.now());
+}
+// ── Tick: process pending nudges + idle checks ──
+/**
+ * Called periodically (e.g., every 5 min by board health worker).
+ * Fires queued post-task nudges and checks idle reflection SLA.
+ */
+export async function tickReflectionNudges() {
+    const config = getConfig();
+    if (!config.enabled)
+        return { postTaskNudges: 0, idleNudges: 0, total: 0 };
+    let postTaskNudges = 0;
+    let idleNudges = 0;
+    const now = Date.now();
+    const cooldownMs = config.cooldownMin * 60_000;
+    // Process pending post-task nudges
+    const ready = pendingNudges.filter(n => now >= n.nudgeAt);
+    for (const nudge of ready) {
+        const idx = pendingNudges.indexOf(nudge);
+        if (idx >= 0)
+            pendingNudges.splice(idx, 1);
+        // Check cooldown
+        if (lastNudgeAt[nudge.agent] && now - lastNudgeAt[nudge.agent] < cooldownMs)
+            continue;
+        // Check if agent already reflected since task completion
+        const tracking = getAgentTracking(nudge.agent);
+        if (tracking && tracking.last_reflection_at && tracking.last_reflection_at > nudge.doneAt)
+            continue;
+        await sendPostTaskNudge(nudge.agent, nudge.taskId, nudge.taskTitle, config, nudge.taskStatus);
+        lastNudgeAt[nudge.agent] = now;
+        postTaskNudges++;
+    }
+    // Check idle reflection SLA
+    // v1.1 autonomy hardening: include agents that are *tracked* (have reflection_tracking rows)
+    // even if they currently have no active tasks. This reduces human-trigger dependence.
+    const agents = getNudgeAgents(config);
+    const nudgeNeverReflected = config.nudgeNeverReflected !== false; // default true
+    for (const agent of agents) {
+        if (lastNudgeAt[agent] && now - lastNudgeAt[agent] < cooldownMs)
+            continue;
+        // Seed tracking row for newly discovered agents
+        ensureAgentTracking(agent);
+        const tracking = getAgentTracking(agent);
+        const lastReflection = tracking?.last_reflection_at || 0;
+        const cadenceHours = config.roleCadenceHours[agent] || config.idleReflectionHours;
+        let shouldNudge = false;
+        let hoursSinceDisplay = 0;
+        if (lastReflection > 0) {
+            // Has reflected before — check if overdue
+            const hoursSince = (now - lastReflection) / (1000 * 60 * 60);
+            if (hoursSince >= cadenceHours) {
+                shouldNudge = true;
+                hoursSinceDisplay = Math.floor(hoursSince);
+            }
+        }
+        else if (nudgeNeverReflected) {
+            // Never reflected — check if tracking row is old enough (seeded_at)
+            const seededAt = tracking?.updated_at || 0;
+            const hoursSinceSeeded = seededAt > 0 ? (now - seededAt) / (1000 * 60 * 60) : cadenceHours;
+            if (hoursSinceSeeded >= cadenceHours) {
+                shouldNudge = true;
+                hoursSinceDisplay = Math.floor(hoursSinceSeeded);
+            }
+        }
+        if (shouldNudge) {
+            await sendIdleNudge(agent, hoursSinceDisplay, tracking?.tasks_done_since_reflection || 0, config);
+            lastNudgeAt[agent] = now;
+            // Record nudge in DB
+            ensureReflectionTrackingTable();
+            const db = getDb();
+            db.prepare(`
+        INSERT INTO reflection_tracking (agent, last_nudge_at, tasks_done_since_reflection, updated_at)
+        VALUES (?, ?, 0, ?)
+        ON CONFLICT(agent) DO UPDATE SET
+          last_nudge_at = ?,
+          updated_at = ?
+      `).run(agent, now, now, now, now);
+            idleNudges++;
+        }
+    }
+    return { postTaskNudges, idleNudges, total: postTaskNudges + idleNudges };
+}
+// ── SLA reporting ──
+export function getReflectionSLAs() {
+    ensureReflectionTrackingTable();
+    const db = getDb();
+    const config = getConfig();
+    const now = Date.now();
+    // Merge active agents + agents with tracking rows (union)
+    const activeAgents = config.agents.length > 0 ? config.agents : getActiveAgents(config.excludeAgents);
+    const trackedRows = db.prepare('SELECT agent FROM reflection_tracking').all();
+    const trackedAgents = trackedRows.map(r => r.agent);
+    // Union, filtered by exclude patterns
+    const excludeSet = new Set((config.excludeAgents || []).map(a => a.toLowerCase()));
+    const allAgents = new Set([...activeAgents, ...trackedAgents]);
+    const agents = [...allAgents].filter(agent => {
+        const lower = agent.toLowerCase();
+        if (excludeSet.has(lower))
+            return false;
+        return !DEFAULT_EXCLUDE_PATTERNS.some(p => p.test(agent));
+    });
+    const slas = [];
+    for (const agent of agents) {
+        const tracking = getAgentTracking(agent);
+        const lastReflection = tracking?.last_reflection_at || null;
+        const cadenceHours = config.roleCadenceHours[agent] || config.idleReflectionHours;
+        let hoursOverdue = null;
+        let status = 'healthy';
+        if (lastReflection) {
+            const hoursSince = (now - lastReflection) / (1000 * 60 * 60);
+            if (hoursSince >= cadenceHours * 1.5) {
+                status = 'overdue';
+                hoursOverdue = Math.round((hoursSince - cadenceHours) * 10) / 10;
+            }
+            else if (hoursSince >= cadenceHours) {
+                status = 'due';
+                hoursOverdue = Math.round((hoursSince - cadenceHours) * 10) / 10;
+            }
+        }
+        else {
+            // Never reflected
+            status = 'overdue';
+        }
+        slas.push({
+            agent,
+            lastReflectionAt: lastReflection,
+            lastNudgeAt: tracking?.last_nudge_at || null,
+            tasksDoneSinceLastReflection: tracking?.tasks_done_since_reflection || 0,
+            hoursOverdue,
+            status,
+        });
+    }
+    return slas.sort((a, b) => {
+        const order = { overdue: 0, due: 1, healthy: 2 };
+        return order[a.status] - order[b.status];
+    });
+}
+// ── Nudge messages ──
+async function sendPostTaskNudge(agent, taskId, taskTitle, config, taskStatus) {
+    const isBlocked = taskStatus === 'blocked';
+    const msg = isBlocked
+        ? `🪞 Reflection nudge: @${agent}, "${taskTitle}" (${taskId}) is blocked. ` +
+            `Take 2 min to reflect — what's blocking you, what did you try, and what would unblock it? ` +
+            `Submit via POST /reflections with your observations.`
+        : `🪞 Reflection nudge: @${agent}, you just completed "${taskTitle}" (${taskId}). ` +
+            `Take 2 min to reflect — what went well, what was painful, and what would you change? ` +
+            `Submit via POST /reflections with your observations.`;
+    try {
+        await routeMessage({
+            from: 'system',
+            content: msg,
+            category: 'watchdog-alert',
+            severity: 'info',
+            forceChannel: config.channel || 'general',
+        });
+    }
+    catch { /* chat may not be available */ }
+}
+async function sendIdleNudge(agent, hoursSince, tasksDone, config) {
+    const taskNote = tasksDone > 0 ? ` You've completed ${tasksDone} task(s) since your last reflection.` : '';
+    const msg = `🪞 Reflection due: @${agent}, it's been ${hoursSince}h since your last reflection.${taskNote} ` +
+        `Take a moment to capture what you've learned. Submit via POST /reflections.`;
+    try {
+        await routeMessage({
+            from: 'system',
+            content: msg,
+            category: 'watchdog-alert',
+            severity: 'warning',
+            forceChannel: config.channel || 'general',
+        });
+    }
+    catch { /* chat may not be available */ }
+}
+// ── Helpers ──
+function getConfig() {
+    const policy = policyManager.get();
+    return policy.reflectionNudge ?? {
+        enabled: true,
+        postTaskDelayMin: 5,
+        idleReflectionHours: 8,
+        cooldownMin: 60,
+        agents: [],
+        channel: 'general',
+        roleCadenceHours: {},
+        excludeAgents: [],
+        nudgeNeverReflected: true,
+    };
+}
+function getAgentTracking(agent) {
+    ensureReflectionTrackingTable();
+    const db = getDb();
+    return db.prepare('SELECT * FROM reflection_tracking WHERE agent = ?').get(agent);
+}
+/**
+ * Ensure an agent has a tracking row (seed on first discovery).
+ * This enables idle nudges for agents who have never reflected.
+ */
+function ensureAgentTracking(agent) {
+    ensureReflectionTrackingTable();
+    const db = getDb();
+    db.prepare(`
+    INSERT OR IGNORE INTO reflection_tracking (agent, tasks_done_since_reflection, updated_at)
+    VALUES (?, 0, ?)
+  `).run(agent, Date.now());
+}
+/** Patterns that indicate non-real agents (test fixtures, system, etc.) */
+const DEFAULT_EXCLUDE_PATTERNS = [
+    /^test-/i,
+    /^proof-/i,
+    /^lane-/i,
+    /^unassigned$/i,
+    /^system$/i,
+    /^bot$/i,
+];
+function getActiveAgents(excludeList) {
+    // Get agents that have tasks in doing/todo/validating
+    const tasks = taskManager.listTasks({});
+    const agents = new Set();
+    for (const t of tasks) {
+        if (t.assignee && ['doing', 'todo', 'validating'].includes(t.status)) {
+            agents.add(t.assignee);
+        }
+    }
+    // Filter out test/system agents
+    const excludeSet = new Set((excludeList || []).map(a => a.toLowerCase()));
+    return [...agents].filter(agent => {
+        const lower = agent.toLowerCase();
+        if (excludeSet.has(lower))
+            return false;
+        return !DEFAULT_EXCLUDE_PATTERNS.some(p => p.test(agent));
+    });
+}
+/**
+ * Return list of agents eligible for reflection nudges.
+ *
+ * If policy specifies an explicit agent allowlist, that is used.
+ * Otherwise we take the union of:
+ * - agents with active tasks (doing/todo/validating)
+ * - agents with reflection tracking rows (previously reflected / previously nudged)
+ *
+ * This closes a real autonomy gap: an agent can drift out of the active-task set,
+ * stop reflecting, and never get nudged — requiring a human to re-trigger them.
+ */
+function getNudgeAgents(config) {
+    ensureReflectionTrackingTable();
+    const db = getDb();
+    const tracked = db.prepare('SELECT agent FROM reflection_tracking').all()
+        .map(r => String(r.agent));
+    // Allowlist semantics: if policy specifies explicit agents[], treat it as strict.
+    // Only when agents[] is empty do we auto-discover and union in tracked rows.
+    const hasAllowlist = config.agents.length > 0;
+    const base = hasAllowlist
+        ? config.agents
+        : getActiveAgents(config.excludeAgents);
+    const all = hasAllowlist
+        ? base
+        : [...new Set([...base, ...tracked])];
+    const excludeSet = new Set((config.excludeAgents || []).map(a => a.toLowerCase()));
+    return all.filter(agent => {
+        const lower = agent.toLowerCase();
+        if (excludeSet.has(lower))
+            return false;
+        return !DEFAULT_EXCLUDE_PATTERNS.some(p => p.test(agent));
+    });
+}
+// ── Test helpers ──
+export function _clearReflectionTracking() {
+    try {
+        const db = getDb();
+        db.prepare('DELETE FROM reflection_tracking').run();
+    }
+    catch { /* table may not exist */ }
+    pendingNudges.length = 0;
+    for (const key of Object.keys(lastNudgeAt))
+        delete lastNudgeAt[key];
+}
+export function _getPendingNudges() {
+    return [...pendingNudges];
+}
+//# sourceMappingURL=reflection-automation.js.map

package/dist/reflection-automation.js.map

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

package/dist/reflections.d.ts

@@ -0,0 +1,65 @@
+export declare const ROLE_TYPES: readonly ["human", "agent", "team"];
+export type RoleType = (typeof ROLE_TYPES)[number];
+export declare const SEVERITY_LEVELS: readonly ["low", "medium", "high", "critical"];
+export type SeverityLevel = (typeof SEVERITY_LEVELS)[number];
+export interface ReflectionInput {
+    pain: string;
+    impact: string;
+    evidence: string[];
+    went_well: string;
+    suspected_why: string;
+    proposed_fix: string;
+    confidence: number;
+    role_type: RoleType;
+    author: string;
+    severity?: SeverityLevel;
+    task_id?: string;
+    tags?: string[];
+    team_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Reflection extends ReflectionInput {
+    id: string;
+    created_at: number;
+    updated_at: number;
+}
+export interface ValidationResult {
+    valid: boolean;
+    data: ReflectionInput;
+    errors?: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+export declare function validateReflection(body: unknown): ValidationResult;
+export declare function createReflection(input: ReflectionInput): Reflection;
+export declare function getReflection(id: string): Reflection | null;
+export interface ReflectionListOpts {
+    author?: string;
+    role_type?: string;
+    severity?: string;
+    task_id?: string;
+    team_id?: string;
+    since?: number;
+    before?: number;
+    limit?: number;
+    offset?: number;
+}
+export declare function listReflections(opts?: ReflectionListOpts): Reflection[];
+export declare function countReflections(opts?: Omit<ReflectionListOpts, 'limit' | 'offset'>): number;
+export declare function reflectionStats(): {
+    total: number;
+    by_role_type: Record<string, number>;
+    by_severity: Record<string, number>;
+    by_author: Record<string, number>;
+};
+/**
+ * Best-effort duplicate counter for a canonical reflection.
+ * Used by POST /reflections dedup to leave an audit trail without creating new rows.
+ */
+export declare function recordReflectionDuplicate(canonicalReflectionId: string, duplicateAt?: number, signature?: string): {
+    ok: boolean;
+    count: number;
+};
+export declare function _clearReflectionStore(): void;
+//# sourceMappingURL=reflections.d.ts.map

package/dist/reflections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflections.d.ts","sourceRoot":"","sources":["../src/reflections.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,UAAU,qCAAsC,CAAA;AAC7D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAElD,eAAO,MAAM,eAAe,gDAAiD,CAAA;AAC7E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAI5D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,QAAQ,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,eAAe,CAAA;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAuFlE;AAsDD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CA8CnE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAI3D;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,kBAAuB,GAAG,UAAU,EAAE,CAsB3E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,QAAQ,CAAM,GAAG,MAAM,CAgBhG;AAED,wBAAgB,eAAe,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAcjK;AA8DD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,qBAAqB,EAAE,MAAM,EAC7B,WAAW,GAAE,MAAmB,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA4BhC;AAID,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C"}