reflectt-node 0.1.0

package/dist/index.js

@@ -0,0 +1,306 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * reflectt-node - Local node server for agent communication via OpenClaw
+ *
+ * Entry point
+ */
+import { createServer } from './server.js';
+import { serverConfig, isDev, openclawConfig, DATA_DIR } from './config.js';
+import { acquirePidLock, releasePidLock, getPidPath } from './pidlock.js';
+import { startCloudIntegration, stopCloudIntegration, isCloudConfigured, watchConfigForCloudChanges, stopConfigWatcher } from './cloud.js';
+import { stopConfigWatch } from './assignment.js';
+import { getDb, closeDb } from './db.js';
+import { startTeamConfigLinter, stopTeamConfigLinter } from './team-config.js';
+// OpenClaw connection is optional — server works for chat/tasks without it
+/**
+ * Build-freshness check: warn if dist/ is older than src/
+ * Prevents silently running stale compiled code after source changes.
+ */
+import { statSync, readdirSync, existsSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { hostname as osHostname } from 'os';
+import { randomBytes } from 'crypto';
+function checkBuildFreshness() {
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        const distDir = dirname(thisFile);
+        const srcDir = join(distDir, '..', 'src');
+        // Find newest src file
+        let newestSrc = 0;
+        try {
+            const srcFiles = readdirSync(srcDir).filter(f => f.endsWith('.ts'));
+            for (const f of srcFiles) {
+                const mtime = statSync(join(srcDir, f)).mtimeMs;
+                if (mtime > newestSrc)
+                    newestSrc = mtime;
+            }
+        }
+        catch {
+            return;
+        } // src dir not accessible, skip
+        // Find this dist file's mtime
+        const distMtime = statSync(thisFile).mtimeMs;
+        if (newestSrc > distMtime + 1000) { // 1s tolerance
+            const ageSec = Math.round((newestSrc - distMtime) / 1000);
+            console.warn(`⚠️  Build may be stale: src/ is ${ageSec}s newer than dist/. Run \`npm run build\` to recompile.`);
+        }
+    }
+    catch {
+        // Non-fatal — skip check if anything goes wrong
+    }
+}
+/**
+ * Docker identity isolation: detect if mounted volumes contain another team's
+ * config and warn/block to prevent identity inheritance.
+ */
+function checkDockerIdentity() {
+    const isDocker = existsSync('/.dockerenv') || process.env.REFLECTT_HOME === '/data';
+    if (!isDocker)
+        return;
+    const reflecttHome = process.env.REFLECTT_HOME || '/data';
+    // Check for inherited OpenClaw config
+    const openclawConfigPath = join(reflecttHome, '.openclaw', 'openclaw.json');
+    if (existsSync(openclawConfigPath)) {
+        try {
+            const raw = JSON.parse(readFileSync(openclawConfigPath, 'utf-8'));
+            const gatewayToken = raw?.gateway?.auth?.token;
+            const agentId = raw?.agentId;
+            // If there's an inherited identity with a gateway token, warn
+            if (gatewayToken && agentId) {
+                console.warn('');
+                console.warn('⚠️  Inherited identity detected in mounted volume!');
+                console.warn(`   Agent ID: ${agentId}`);
+                console.warn('   This Docker instance may appear as another team\'s agent.');
+                console.warn('');
+                console.warn('   To use a fresh identity:');
+                console.warn('     1. Remove the mounted .openclaw directory, or');
+                console.warn('     2. Set OPENCLAW_AGENT_ID=my-docker-agent in docker-compose.yml');
+                console.warn('');
+            }
+        }
+        catch {
+            // Config exists but can't be parsed — not a problem
+        }
+    }
+    // Check for inherited cloud credentials
+    const cloudConfigPath = join(reflecttHome, 'config.json');
+    if (existsSync(cloudConfigPath)) {
+        try {
+            const raw = JSON.parse(readFileSync(cloudConfigPath, 'utf-8'));
+            const hostName = raw?.cloud?.hostName;
+            const hostId = raw?.cloud?.hostId;
+            const credential = raw?.cloud?.credential;
+            if (hostId && credential) {
+                const explicitName = process.env.REFLECTT_HOST_NAME;
+                if (!explicitName) {
+                    console.warn('');
+                    console.warn('⚠️  Inherited cloud registration detected!');
+                    console.warn(`   Host: ${hostName || 'unknown'} (${hostId})`);
+                    console.warn('   This Docker instance will appear as an existing host in the cloud dashboard.');
+                    console.warn('');
+                    console.warn('   To register as a new host:');
+                    console.warn('     1. Set REFLECTT_HOST_NAME=my-docker-host in docker-compose.yml');
+                    console.warn('     2. Generate a new join token in the cloud dashboard');
+                    console.warn('     3. Set REFLECTT_HOST_TOKEN=<new-token> in docker-compose.yml');
+                    console.warn('');
+                }
+            }
+        }
+        catch {
+            // Config exists but can't be parsed
+        }
+    }
+    // Generate a fresh agent identity if none is explicitly set
+    if (!process.env.OPENCLAW_AGENT_ID) {
+        const hn = osHostname();
+        const shortId = randomBytes(3).toString('hex');
+        const defaultId = `docker-${hn}-${shortId}`;
+        process.env.OPENCLAW_AGENT_ID = defaultId;
+        console.log(`🆔 Docker identity: ${defaultId} (set OPENCLAW_AGENT_ID to override)`);
+    }
+}
+/**
+ * Docker bootstrap check: detect container environment and print
+ * actionable guidance when required configuration is missing.
+ */
+function checkDockerBootstrap() {
+    const isDocker = existsSync('/.dockerenv') || process.env.REFLECTT_HOME === '/data';
+    if (!isDocker)
+        return;
+    const hasGatewayUrl = !!process.env.OPENCLAW_GATEWAY_URL;
+    const hasGatewayToken = !!process.env.OPENCLAW_GATEWAY_TOKEN;
+    if (!hasGatewayUrl && !hasGatewayToken) {
+        console.log('');
+        console.log('┌──────────────────────────────────────────────────────────┐');
+        console.log('│  📋 Docker Quick Start                                  │');
+        console.log('├──────────────────────────────────────────────────────────┤');
+        console.log('│                                                          │');
+        console.log('│  reflectt-node is running standalone (no OpenClaw).      │');
+        console.log('│  The dashboard, tasks, and API work fine without it.     │');
+        console.log('│                                                          │');
+        console.log('│  To connect to OpenClaw (for agent messaging):           │');
+        console.log('│                                                          │');
+        console.log('│  1. Set env vars in docker-compose.yml:                  │');
+        console.log('│     OPENCLAW_GATEWAY_URL=ws://host.docker.internal:18789 │');
+        console.log('│     OPENCLAW_GATEWAY_TOKEN=your_token_here               │');
+        console.log('│                                                          │');
+        console.log('│  2. Restart: docker-compose up -d                        │');
+        console.log('│                                                          │');
+        console.log('│  Get your token: openclaw gateway token                  │');
+        console.log('│  Full guide: https://reflectt.ai/bootstrap               │');
+        console.log('└──────────────────────────────────────────────────────────┘');
+        console.log('');
+    }
+    else if (hasGatewayUrl && !hasGatewayToken) {
+        console.warn('');
+        console.warn('⚠️  OPENCLAW_GATEWAY_URL is set but OPENCLAW_GATEWAY_TOKEN is missing.');
+        console.warn('   Connection will fail without a valid token.');
+        console.warn('   Get your token: openclaw gateway token');
+        console.warn('   Then add to docker-compose.yml:');
+        console.warn('     OPENCLAW_GATEWAY_TOKEN=your_token_here');
+        console.warn('');
+    }
+}
+async function main() {
+    console.log('🚀 Starting reflectt-node...');
+    // Build-freshness check (non-blocking)
+    checkBuildFreshness();
+    // Docker identity isolation (must run before bootstrap)
+    checkDockerIdentity();
+    // Docker bootstrap guidance (non-blocking)
+    checkDockerBootstrap();
+    // Dev-mode port guard: prevent dev servers from hijacking production port
+    const PRODUCTION_PORT = 4445;
+    if (isDev && serverConfig.port === PRODUCTION_PORT) {
+        console.error(`\n🚫 BLOCKED: Cannot run dev server on port ${PRODUCTION_PORT} — that's the production port.`);
+        console.error(`   Use a different port: PORT=${PRODUCTION_PORT + 1} npm run dev`);
+        console.error(`   Or set NODE_ENV=production if this IS the production server.\n`);
+        process.exit(1);
+    }
+    // Acquire PID lock — kills any previous instance and resolves port conflicts
+    // Use port-specific lockfile to avoid cross-port conflicts
+    const pidPath = getPidPath(serverConfig.port);
+    const lockResult = acquirePidLock(serverConfig.port, pidPath);
+    if (lockResult.killedPrevious) {
+        console.log(`   Replaced previous instance (pid ${lockResult.previousPid})`);
+    }
+    if (lockResult.portConflictPids.length > 0) {
+        console.log(`   Resolved ${lockResult.portConflictPids.length} port conflict(s)`);
+    }
+    try {
+        // Initialize SQLite database (WAL mode, auto-migration from JSONL)
+        const db = getDb();
+        console.log(`📦 SQLite database initialized (WAL mode)`);
+        // Initialize vector search (sqlite-vec) — optional, degrades gracefully
+        try {
+            const { initVectorSearch } = await import('./db.js');
+            initVectorSearch();
+        }
+        catch {
+            console.warn('⚠️  Vector search not available (sqlite-vec not installed)');
+        }
+        // Team config linter (TEAM.md + TEAM-ROLES.yaml + TEAM-STANDARDS.md)
+        startTeamConfigLinter();
+        const app = await createServer();
+        await app.listen({
+            port: serverConfig.port,
+            host: serverConfig.host,
+        });
+        const baseUrl = `http://${serverConfig.host}:${serverConfig.port}`;
+        console.log(`✅ Server running at ${baseUrl}`);
+        console.log(`   - Dashboard: ${baseUrl}/dashboard`);
+        console.log(`   - REST API: ${baseUrl}`);
+        console.log(`   - WebSocket: ws://${serverConfig.host}:${serverConfig.port}/chat/ws`);
+        console.log(`   - Health: ${baseUrl}/health`);
+        console.log(`   - PID: ${process.pid}`);
+        // OpenClaw gateway status
+        if (openclawConfig.gatewayToken) {
+            console.log(`🔗 OpenClaw gateway: configured (${openclawConfig.gatewayUrl})`);
+        }
+        else {
+            console.log('⚠️  OpenClaw gateway: not configured');
+            console.log('   To connect agents, set OPENCLAW_GATEWAY_URL and OPENCLAW_GATEWAY_TOKEN');
+            console.log('   Get your token: openclaw gateway token');
+            console.log('   Guide: https://reflectt.ai/bootstrap');
+        }
+        // Cloud integration (checks env vars + config.json for credentials)
+        if (isCloudConfigured()) {
+            // Non-blocking: don't prevent server from starting if cloud is down
+            startCloudIntegration().catch(err => {
+                console.warn(`☁️  Cloud integration error: ${err?.message || err}`);
+            });
+        }
+        else {
+            console.log('☁️  Cloud integration: disabled (run `reflectt host connect` to enable)');
+            // Watch config.json so we auto-connect when agent enrolls
+            watchConfigForCloudChanges();
+        }
+        // First-boot seeding: if no agents and no tasks, create starter team + welcome task
+        try {
+            const { taskManager } = await import('./tasks.js');
+            const { createStarterTeam } = await import('./starter-team.js');
+            const allTasks = taskManager.listTasks({});
+            const agentsDir = join(DATA_DIR, 'agents');
+            const hasAgents = existsSync(agentsDir) && readdirSync(agentsDir).filter(f => !f.startsWith('.')).length > 0;
+            if (allTasks.length === 0 && !hasAgents) {
+                console.log('🌱 First boot detected — seeding starter team…');
+                const result = await createStarterTeam();
+                console.log(`   Created agents: ${result.created.join(', ') || 'none (already exist)'}`);
+                // Create a welcome task so the dashboard isn't empty
+                taskManager.createTask({
+                    status: 'todo',
+                    createdBy: 'system',
+                    title: 'Welcome to reflectt-node — explore the dashboard and connect your agents',
+                    description: [
+                        '## Getting Started',
+                        '',
+                        'Your reflectt-node is running! Here\'s what to do next:',
+                        '',
+                        '1. **Connect OpenClaw agents** — set `OPENCLAW_GATEWAY_URL` and `OPENCLAW_GATEWAY_TOKEN`',
+                        '2. **Explore the dashboard** — visit `/dashboard` to see tasks, agents, and chat',
+                        '3. **Try the API** — `GET /capabilities` lists every endpoint',
+                        '4. **Connect to the cloud** — `reflectt host connect --join-token <token>`',
+                        '',
+                        'When done, move this task to `done`. Your first task cycle is complete!',
+                    ].join('\n'),
+                    priority: 'P2',
+                    assignee: 'builder',
+                    reviewer: 'ops',
+                    done_criteria: [
+                        'Dashboard loads and shows this task',
+                        'At least one agent connected via OpenClaw',
+                    ],
+                    metadata: { source: 'first-boot', reflection_exempt: true, reflection_exempt_reason: 'Auto-created welcome task' },
+                });
+                console.log('   Created welcome task');
+            }
+        }
+        catch (err) {
+            // Non-blocking — don't prevent server from starting
+            console.warn(`⚠️  First-boot seeding: ${err?.message || err}`);
+        }
+        // Graceful shutdown
+        const shutdown = async (signal) => {
+            console.log(`\n${signal} received, shutting down...`);
+            stopConfigWatch();
+            stopConfigWatcher();
+            stopCloudIntegration();
+            stopTeamConfigLinter();
+            closeDb();
+            releasePidLock(pidPath);
+            await app.close();
+            process.exit(0);
+        };
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        process.on('SIGINT', () => shutdown('SIGINT'));
+    }
+    catch (err) {
+        releasePidLock(pidPath);
+        console.error('Failed to start server:', err);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/insight-mutation.d.ts

@@ -0,0 +1,32 @@
+import { type Insight, type InsightStatus } from './insights.js';
+export interface InsightMutationAuditEntry {
+    timestamp: number;
+    insightId: string;
+    actor: string;
+    reason: string;
+    changes: Array<{
+        field: string;
+        before: unknown;
+        after: unknown;
+    }>;
+    context: string;
+}
+export declare function recordInsightMutation(entry: InsightMutationAuditEntry): Promise<void>;
+export declare function getRecentInsightMutationAudits(limit?: number): InsightMutationAuditEntry[];
+export declare function _clearInsightMutationAuditLog(): void;
+export interface InsightPatchRequest {
+    actor: string;
+    reason: string;
+    status?: InsightStatus;
+    cluster_key?: string;
+    metadata?: {
+        notes?: string;
+        cluster_key_override?: string;
+    };
+}
+export declare function patchInsightById(insightId: string, patch: InsightPatchRequest): {
+    success: boolean;
+    insight?: Insight;
+    error?: string;
+};
+//# sourceMappingURL=insight-mutation.d.ts.map

package/dist/insight-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-mutation.d.ts","sourceRoot":"","sources":["../src/insight-mutation.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAMlF,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAClE,OAAO,EAAE,MAAM,CAAA;CAChB;AAKD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3F;AAED,wBAAgB,8BAA8B,CAAC,KAAK,SAAK,GAAG,yBAAyB,EAAE,CAEtF;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAID,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAC9B,CAAA;CACF;AA6BD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgHvI"}

package/dist/insight-mutation.js

@@ -0,0 +1,160 @@
+// SPDX-License-Identifier: Apache-2.0
+// Minimal admin-only insight mutation helpers (cluster re-key + status close)
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { getDb, safeJsonParse, safeJsonStringify } from './db.js';
+import { DATA_DIR } from './config.js';
+import { INSIGHT_STATUSES } from './insights.js';
+// ── Audit log ─────────────────────────────────────────────────────────────
+const AUDIT_FILE = process.env.REFLECTT_INSIGHT_MUTATION_AUDIT_FILE || path.join(DATA_DIR, 'insight-mutation-audit.jsonl');
+const auditEntries = [];
+const MAX_IN_MEMORY = 2000;
+export async function recordInsightMutation(entry) {
+    auditEntries.push(entry);
+    if (auditEntries.length > MAX_IN_MEMORY) {
+        auditEntries.splice(0, auditEntries.length - MAX_IN_MEMORY);
+    }
+    // Best-effort append-only JSONL
+    try {
+        await fs.mkdir(path.dirname(AUDIT_FILE), { recursive: true });
+        await fs.appendFile(AUDIT_FILE, JSON.stringify(entry) + '\n', 'utf-8');
+    }
+    catch (err) {
+        // Don't block mutations on audit I/O failure
+        console.error('[InsightMutationAudit] Failed to write audit entry:', err);
+    }
+}
+export function getRecentInsightMutationAudits(limit = 50) {
+    return auditEntries.slice(-Math.max(1, Math.min(limit, 500)));
+}
+export function _clearInsightMutationAuditLog() {
+    auditEntries.splice(0, auditEntries.length);
+}
+function parseClusterKeyString(clusterKey) {
+    const parts = clusterKey.split('::').map(p => p.trim()).filter(Boolean);
+    if (parts.length !== 3)
+        return null;
+    const [workflow_stage, failure_family, impacted_unit] = parts;
+    if (!workflow_stage || !failure_family || !impacted_unit)
+        return null;
+    return { workflow_stage, failure_family, impacted_unit };
+}
+function diff(before, after) {
+    const changes = [];
+    const fields = [
+        'status',
+        'cluster_key',
+        'workflow_stage',
+        'failure_family',
+        'impacted_unit',
+        'metadata',
+        'updated_at',
+    ];
+    for (const field of fields) {
+        const b = before[field];
+        const a = after[field];
+        if (JSON.stringify(b) !== JSON.stringify(a))
+            changes.push({ field: String(field), before: b, after: a });
+    }
+    return changes;
+}
+export function patchInsightById(insightId, patch) {
+    const db = getDb();
+    if (!patch.actor?.trim())
+        return { success: false, error: 'actor is required' };
+    if (!patch.reason?.trim())
+        return { success: false, error: 'reason is required' };
+    const row = db.prepare('SELECT * FROM insights WHERE id = ?').get(insightId);
+    if (!row)
+        return { success: false, error: 'Insight not found' };
+    // Defer to rowToInsight mapping via getInsight to keep consistent shapes.
+    const current = db.prepare('SELECT * FROM insights WHERE id = ?').get(insightId);
+    const before = {
+        id: current.id,
+        cluster_key: current.cluster_key,
+        workflow_stage: current.workflow_stage,
+        failure_family: current.failure_family,
+        impacted_unit: current.impacted_unit,
+        title: current.title,
+        status: current.status,
+        score: current.score,
+        priority: current.priority,
+        reflection_ids: safeJsonParse(current.reflection_ids) ?? [],
+        independent_count: current.independent_count,
+        evidence_refs: safeJsonParse(current.evidence_refs) ?? [],
+        authors: safeJsonParse(current.authors) ?? [],
+        promotion_readiness: current.promotion_readiness,
+        recurring_candidate: current.recurring_candidate === 1,
+        cooldown_until: current.cooldown_until,
+        cooldown_reason: current.cooldown_reason,
+        severity_max: current.severity_max,
+        task_id: current.task_id ?? null,
+        metadata: safeJsonParse(current.metadata),
+        created_at: current.created_at,
+        updated_at: current.updated_at,
+    };
+    // Validate status
+    if (patch.status !== undefined) {
+        if (!INSIGHT_STATUSES.includes(patch.status)) {
+            return { success: false, error: `Invalid status. Allowed: ${INSIGHT_STATUSES.join(', ')}` };
+        }
+    }
+    // Validate cluster key
+    let parsedKey = null;
+    if (patch.cluster_key !== undefined) {
+        parsedKey = parseClusterKeyString(patch.cluster_key);
+        if (!parsedKey)
+            return { success: false, error: 'Invalid cluster_key. Expected "stage::family::unit"' };
+    }
+    // Merge metadata (allowlist only)
+    // Preserve NULL unless metadata was explicitly provided.
+    const beforeMetaStr = (current.metadata ?? null);
+    const baseMeta = before.metadata ?? undefined;
+    const nextMeta = { ...(baseMeta ?? {}) };
+    const shouldWriteMetadata = !!patch.metadata;
+    if (patch.metadata) {
+        if (patch.metadata.notes !== undefined)
+            nextMeta.notes = patch.metadata.notes;
+        if (patch.metadata.cluster_key_override !== undefined)
+            nextMeta.cluster_key_override = patch.metadata.cluster_key_override;
+    }
+    const nextMetaStr = shouldWriteMetadata ? safeJsonStringify(nextMeta) : beforeMetaStr;
+    const now = Date.now();
+    const nextStatus = patch.status ?? before.status;
+    const nextClusterKey = patch.cluster_key ?? before.cluster_key;
+    const nextWorkflowStage = parsedKey?.workflow_stage ?? before.workflow_stage;
+    const nextFailureFamily = parsedKey?.failure_family ?? before.failure_family;
+    const nextImpactedUnit = parsedKey?.impacted_unit ?? before.impacted_unit;
+    db.prepare(`
+    UPDATE insights SET
+      status = ?,
+      cluster_key = ?,
+      workflow_stage = ?,
+      failure_family = ?,
+      impacted_unit = ?,
+      metadata = ?,
+      updated_at = ?
+    WHERE id = ?
+  `).run(nextStatus, nextClusterKey, nextWorkflowStage, nextFailureFamily, nextImpactedUnit, nextMetaStr, now, insightId);
+    const updated = db.prepare('SELECT * FROM insights WHERE id = ?').get(insightId);
+    const after = {
+        ...before,
+        status: updated.status,
+        cluster_key: updated.cluster_key,
+        workflow_stage: updated.workflow_stage,
+        failure_family: updated.failure_family,
+        impacted_unit: updated.impacted_unit,
+        metadata: safeJsonParse(updated.metadata),
+        updated_at: updated.updated_at,
+    };
+    void recordInsightMutation({
+        timestamp: now,
+        insightId,
+        actor: patch.actor,
+        reason: patch.reason,
+        changes: diff(before, after),
+        context: 'PATCH /insights/:id',
+    });
+    return { success: true, insight: after };
+}
+//# sourceMappingURL=insight-mutation.js.map

package/dist/insight-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-mutation.js","sourceRoot":"","sources":["../src/insight-mutation.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,8EAA8E;AAE9E,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAoC,MAAM,eAAe,CAAA;AAElF,6EAA6E;AAE7E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAA;AAW1H,MAAM,YAAY,GAAgC,EAAE,CAAA;AACpD,MAAM,aAAa,GAAG,IAAI,CAAA;AAE1B,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAgC;IAC1E,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,IAAI,YAAY,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACxC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,GAAG,aAAa,CAAC,CAAA;IAC7D,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7D,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;IACxE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,6CAA6C;QAC7C,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,GAAG,CAAC,CAAA;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAK,GAAG,EAAE;IACvD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;AAC7C,CAAC;AAeD,SAAS,qBAAqB,CAAC,UAAkB;IAC/C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnC,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,aAAa,CAAC,GAAG,KAAK,CAAA;IAC7D,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IACrE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AAC1D,CAAC;AAED,SAAS,IAAI,CAAC,MAAe,EAAE,KAAc;IAC3C,MAAM,OAAO,GAA8D,EAAE,CAAA;IAC7E,MAAM,MAAM,GAAyB;QACnC,QAAQ;QACR,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,eAAe;QACf,UAAU;QACV,YAAY;KACb,CAAA;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QACvB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1G,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,KAA0B;IAC5E,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAElB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAA;IAC/E,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAA;IAEjF,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAQ,CAAA;IACnF,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAA;IAE/D,0EAA0E;IAC1E,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAQ,CAAA;IACvF,MAAM,MAAM,GAAY;QACtB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,aAAa,CAAW,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE;QACrE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,aAAa,EAAE,aAAa,CAAW,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE;QACnE,OAAO,EAAE,aAAa,CAAW,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;QACvD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,KAAK,CAAC;QACtD,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,QAAQ,EAAE,aAAa,CAA0B,OAAO,CAAC,QAAQ,CAAC;QAClE,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;KACT,CAAA;IAEvB,kBAAkB;IAClB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAa,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;QAC7F,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,SAAS,GAAqF,IAAI,CAAA;IACtG,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACpD,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAA;IACzG,CAAC;IAED,kCAAkC;IAClC,yDAAyD;IACzD,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAkB,CAAA;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAA;IAC7C,MAAM,QAAQ,GAA4B,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAA;IACjE,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAA;IAC5C,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAA;QAC7E,IAAI,KAAK,CAAC,QAAQ,CAAC,oBAAoB,KAAK,SAAS;YAAE,QAAQ,CAAC,oBAAoB,GAAG,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAA;IAC5H,CAAC;IACD,MAAM,WAAW,GAAG,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAA;IAErF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,IAAK,MAAM,CAAC,MAAwB,CAAA;IACnE,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAA;IAC9D,MAAM,iBAAiB,GAAG,SAAS,EAAE,cAAc,IAAI,MAAM,CAAC,cAAc,CAAA;IAC5E,MAAM,iBAAiB,GAAG,SAAS,EAAE,cAAc,IAAI,MAAM,CAAC,cAAc,CAAA;IAC5E,MAAM,gBAAgB,GAAG,SAAS,EAAE,aAAa,IAAI,MAAM,CAAC,aAAa,CAAA;IAEzE,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;GAUV,CAAC,CAAC,GAAG,CACJ,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,GAAG,EACH,SAAS,CACV,CAAA;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAQ,CAAA;IACvF,MAAM,KAAK,GAAY;QACrB,GAAG,MAAM;QACT,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE,aAAa,CAA0B,OAAO,CAAC,QAAQ,CAAC;QAClE,UAAU,EAAE,OAAO,CAAC,UAAU;KACT,CAAA;IAEvB,KAAK,qBAAqB,CAAC;QACzB,SAAS,EAAE,GAAG;QACd,SAAS;QACT,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;QAC5B,OAAO,EAAE,qBAAqB;KAC/B,CAAC,CAAA;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AAC1C,CAAC"}

package/dist/insight-promotion.d.ts

@@ -0,0 +1,89 @@
+/** Required contract fields for promoted tasks */
+export interface PromotionContract {
+    /** Task owner/assignee */
+    owner: string;
+    /** Reviewer for the task */
+    reviewer: string;
+    /** Estimated completion time */
+    eta: string;
+    /** How to verify the fix worked */
+    acceptance_check: string;
+    /** What artifact must be produced as proof */
+    artifact_proof_requirement: string;
+    /** When to check in on progress */
+    next_checkpoint_eta: string;
+}
+export interface PromotionInput {
+    insight_id: string;
+    contract: PromotionContract;
+    /** Override title (defaults to insight title) */
+    title?: string;
+    /** Override description */
+    description?: string;
+    /** Priority override (defaults to insight priority) */
+    priority?: 'P0' | 'P1' | 'P2' | 'P3';
+    /** Team id */
+    team_id?: string;
+}
+export interface PromotionResult {
+    success: boolean;
+    task_id?: string;
+    insight_id: string;
+    audit_id?: string;
+    error?: string;
+}
+export interface PromotionAudit {
+    id: string;
+    insight_id: string;
+    task_id: string;
+    promoted_by: string;
+    contract: PromotionContract;
+    insight_snapshot: {
+        score: number;
+        priority: string;
+        reflection_count: number;
+        independent_count: number;
+        severity_max: string | null;
+        cluster_key: string;
+    };
+    created_at: number;
+}
+export interface RecurringCandidate {
+    insight_id: string;
+    cluster_key: string;
+    failure_family: string;
+    impacted_unit: string;
+    reflection_count: number;
+    reopened_count: number;
+    score: number;
+    priority: string;
+    severity_max: string | null;
+    suggested_owner: string | null;
+    suggested_lane: string | null;
+    reason: string;
+}
+export interface PromotionValidation {
+    valid: boolean;
+    errors?: string[];
+}
+export declare function validatePromotionInput(body: unknown): PromotionValidation;
+/**
+ * Promote an insight into a board task.
+ */
+export declare function promoteInsight(input: PromotionInput, promotedBy: string): Promise<PromotionResult>;
+export declare function ensurePromotionAuditTable(): void;
+export declare function getPromotionAuditByInsight(insightId: string): PromotionAudit | null;
+export declare function listPromotionAudits(limit?: number): PromotionAudit[];
+/**
+ * Generate recurring task candidates from insights that show persistent patterns.
+ *
+ * Criteria:
+ *   - recurring_candidate = true (insight was reopened or has 4+ reflections)
+ *   - status is promoted or cooldown (active insights)
+ *   - Not already promoted to a task
+ *
+ * Per-lane assignment: maps failure_family + impacted_unit to agent roles.
+ */
+export declare function generateRecurringCandidates(): RecurringCandidate[];
+export declare function _clearPromotionAudits(): void;
+//# sourceMappingURL=insight-promotion.d.ts.map

package/dist/insight-promotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-promotion.d.ts","sourceRoot":"","sources":["../src/insight-promotion.ts"],"names":[],"mappings":"AAeA,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,8CAA8C;IAC9C,0BAA0B,EAAE,MAAM,CAAA;IAClC,mCAAmC;IACnC,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACpC,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,gBAAgB,EAAE;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,CAAA;QACxB,iBAAiB,EAAE,MAAM,CAAA;QACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAID,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,CA8BzE;AAID;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA6ExG;AA0BD,wBAAgB,yBAAyB,IAAI,IAAI,CAehD;AAyBD,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAcnF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAK,GAAG,cAAc,EAAE,CAahE;AAID;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,IAAI,kBAAkB,EAAE,CAsClE;AA2CD,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C"}