reflectt-node 0.1.0

package/dist/insight-promotion.js

@@ -0,0 +1,278 @@
+// SPDX-License-Identifier: Apache-2.0
+// Insight → Task promotion workflow + recurring candidate generation
+//
+// Converts qualified insights into board tasks with required contract fields.
+// Records audit trail and generates recurring candidates per role lane.
+import { getDb, safeJsonStringify, safeJsonParse } from './db.js';
+import { taskManager } from './tasks.js';
+import { getInsight } from './insights.js';
+import { getAgentRoles, suggestAssignee } from './assignment.js';
+export function validatePromotionInput(body) {
+    const errors = [];
+    if (!body || typeof body !== 'object') {
+        return { valid: false, errors: ['Request body must be a JSON object'] };
+    }
+    const b = body;
+    if (typeof b.insight_id !== 'string' || !b.insight_id) {
+        errors.push('insight_id is required');
+    }
+    if (!b.contract || typeof b.contract !== 'object') {
+        errors.push('contract object is required');
+    }
+    else {
+        const c = b.contract;
+        const contractFields = ['owner', 'reviewer', 'eta', 'acceptance_check', 'artifact_proof_requirement', 'next_checkpoint_eta'];
+        for (const field of contractFields) {
+            if (typeof c[field] !== 'string' || !c[field].trim()) {
+                errors.push(`contract.${field} is required and must be a non-empty string`);
+            }
+        }
+    }
+    if (b.priority !== undefined && !['P0', 'P1', 'P2', 'P3'].includes(b.priority)) {
+        errors.push('priority must be P0, P1, P2, or P3');
+    }
+    return errors.length > 0 ? { valid: false, errors } : { valid: true };
+}
+// ── Promotion ──
+/**
+ * Promote an insight into a board task.
+ */
+export async function promoteInsight(input, promotedBy) {
+    const insight = getInsight(input.insight_id);
+    if (!insight) {
+        return { success: false, insight_id: input.insight_id, error: 'Insight not found' };
+    }
+    if (insight.status === 'closed') {
+        return { success: false, insight_id: input.insight_id, error: 'Cannot promote a closed insight' };
+    }
+    // Check if already promoted to a task
+    const existingAudit = getPromotionAuditByInsight(input.insight_id);
+    if (existingAudit) {
+        return {
+            success: false,
+            insight_id: input.insight_id,
+            task_id: existingAudit.task_id,
+            error: `Insight already promoted to task ${existingAudit.task_id}`,
+        };
+    }
+    const contract = input.contract;
+    const priority = input.priority ?? insight.priority;
+    // Build task description from insight data
+    const description = input.description ?? buildTaskDescription(insight, contract);
+    const title = input.title ?? `[Insight] ${insight.title}`;
+    const task = await taskManager.createTask({
+        title,
+        description,
+        status: 'todo',
+        assignee: contract.owner,
+        reviewer: contract.reviewer,
+        done_criteria: [
+            contract.acceptance_check,
+            `Artifact: ${contract.artifact_proof_requirement}`,
+            `Checkpoint: ${contract.next_checkpoint_eta}`,
+        ],
+        createdBy: promotedBy,
+        priority,
+        tags: ['insight-promoted', insight.failure_family],
+        metadata: {
+            source_insight: input.insight_id,
+            promotion_contract: contract,
+            eta: contract.eta,
+            cluster_key: insight.cluster_key,
+            severity_max: insight.severity_max,
+            reflection_count: insight.reflection_ids.length,
+        },
+        ...(input.team_id ? { teamId: input.team_id } : {}),
+    });
+    // Record audit
+    const audit = recordPromotionAudit(insight, task.id, promotedBy, contract);
+    // Update insight metadata
+    const db = getDb();
+    db.prepare(`
+    UPDATE insights SET
+      metadata = ?,
+      updated_at = ?
+    WHERE id = ?
+  `).run(safeJsonStringify({ promoted_task_id: task.id, promoted_at: Date.now(), promoted_by: promotedBy }), Date.now(), insight.id);
+    // TODO: emit insight:task_promoted event when EventType supports it
+    return {
+        success: true,
+        task_id: task.id,
+        insight_id: insight.id,
+        audit_id: audit.id,
+    };
+}
+function buildTaskDescription(insight, contract) {
+    return [
+        `## Origin`,
+        `Promoted from insight \`${insight.id}\` (${insight.cluster_key})`,
+        ``,
+        `**Score:** ${insight.score}/10 | **Priority:** ${insight.priority} | **Severity:** ${insight.severity_max ?? 'unset'}`,
+        `**Reflections:** ${insight.reflection_ids.length} from ${insight.independent_count} author(s)`,
+        `**Evidence:** ${insight.evidence_refs.join(', ')}`,
+        ``,
+        `## Problem`,
+        insight.title,
+        ``,
+        `## Contract`,
+        `- **Owner:** ${contract.owner}`,
+        `- **Reviewer:** ${contract.reviewer}`,
+        `- **ETA:** ${contract.eta}`,
+        `- **Acceptance:** ${contract.acceptance_check}`,
+        `- **Artifact:** ${contract.artifact_proof_requirement}`,
+        `- **Checkpoint:** ${contract.next_checkpoint_eta}`,
+    ].join('\n');
+}
+// ── Audit ──
+export function ensurePromotionAuditTable() {
+    const db = getDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS promotion_audits (
+      id TEXT PRIMARY KEY,
+      insight_id TEXT NOT NULL,
+      task_id TEXT NOT NULL,
+      promoted_by TEXT NOT NULL,
+      contract TEXT NOT NULL,          -- JSON
+      insight_snapshot TEXT NOT NULL,   -- JSON
+      created_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_promotion_audits_insight ON promotion_audits(insight_id);
+    CREATE INDEX IF NOT EXISTS idx_promotion_audits_task ON promotion_audits(task_id);
+  `);
+}
+function recordPromotionAudit(insight, taskId, promotedBy, contract) {
+    ensurePromotionAuditTable();
+    const db = getDb();
+    const id = `paudit-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    const now = Date.now();
+    const snapshot = {
+        score: insight.score,
+        priority: insight.priority,
+        reflection_count: insight.reflection_ids.length,
+        independent_count: insight.independent_count,
+        severity_max: insight.severity_max,
+        cluster_key: insight.cluster_key,
+    };
+    db.prepare(`
+    INSERT INTO promotion_audits (id, insight_id, task_id, promoted_by, contract, insight_snapshot, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `).run(id, insight.id, taskId, promotedBy, safeJsonStringify(contract), safeJsonStringify(snapshot), now);
+    return { id, insight_id: insight.id, task_id: taskId, promoted_by: promotedBy, contract, insight_snapshot: snapshot, created_at: now };
+}
+export function getPromotionAuditByInsight(insightId) {
+    ensurePromotionAuditTable();
+    const db = getDb();
+    const row = db.prepare('SELECT * FROM promotion_audits WHERE insight_id = ? ORDER BY created_at DESC LIMIT 1').get(insightId);
+    if (!row)
+        return null;
+    return {
+        id: row.id,
+        insight_id: row.insight_id,
+        task_id: row.task_id,
+        promoted_by: row.promoted_by,
+        contract: safeJsonParse(row.contract),
+        insight_snapshot: safeJsonParse(row.insight_snapshot),
+        created_at: row.created_at,
+    };
+}
+export function listPromotionAudits(limit = 50) {
+    ensurePromotionAuditTable();
+    const db = getDb();
+    const rows = db.prepare('SELECT * FROM promotion_audits ORDER BY created_at DESC LIMIT ?').all(limit);
+    return rows.map(row => ({
+        id: row.id,
+        insight_id: row.insight_id,
+        task_id: row.task_id,
+        promoted_by: row.promoted_by,
+        contract: safeJsonParse(row.contract),
+        insight_snapshot: safeJsonParse(row.insight_snapshot),
+        created_at: row.created_at,
+    }));
+}
+// ── Recurring candidate generation ──
+/**
+ * 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 function generateRecurringCandidates() {
+    const db = getDb();
+    ensurePromotionAuditTable();
+    // Get recurring insights that haven't been promoted to tasks yet
+    const rows = db.prepare(`
+    SELECT i.* FROM insights i
+    LEFT JOIN promotion_audits pa ON pa.insight_id = i.id
+    WHERE i.recurring_candidate = 1
+      AND i.status IN ('promoted', 'cooldown', 'candidate')
+      AND pa.id IS NULL
+    ORDER BY i.score DESC
+  `).all();
+    const roles = getAgentRoles();
+    const candidates = [];
+    for (const row of rows) {
+        const reflectionIds = safeJsonParse(row.reflection_ids) ?? [];
+        const suggested = suggestOwnerForInsight(row.failure_family, row.impacted_unit, roles);
+        candidates.push({
+            insight_id: row.id,
+            cluster_key: row.cluster_key,
+            failure_family: row.failure_family,
+            impacted_unit: row.impacted_unit,
+            reflection_count: reflectionIds.length,
+            reopened_count: 0, // not tracked in current schema, inferred from recurring_candidate
+            score: row.score,
+            priority: row.priority,
+            severity_max: row.severity_max,
+            suggested_owner: suggested.owner,
+            suggested_lane: suggested.lane,
+            reason: buildRecurringReason(row, reflectionIds.length),
+        });
+    }
+    return candidates;
+}
+function suggestOwnerForInsight(failureFamily, impactedUnit, roles) {
+    // Map failure families to likely role affinities
+    const tagHints = [failureFamily, impactedUnit];
+    for (const role of roles) {
+        const matches = role.affinityTags.some(tag => tagHints.some(hint => hint.toLowerCase().includes(tag.toLowerCase()) || tag.toLowerCase().includes(hint.toLowerCase())));
+        if (matches) {
+            return { owner: role.name, lane: role.role };
+        }
+    }
+    // Fallback: try suggestAssignee with a synthetic task
+    try {
+        const suggestion = suggestAssignee({ title: `Fix ${failureFamily} issue in ${impactedUnit}` }, []);
+        if (suggestion?.suggested) {
+            const matchedRole = roles.find(r => r.name === suggestion.suggested);
+            return { owner: suggestion.suggested, lane: matchedRole?.role ?? null };
+        }
+    }
+    catch {
+        // assignment module may not be loaded
+    }
+    return { owner: null, lane: null };
+}
+function buildRecurringReason(row, reflectionCount) {
+    const parts = [];
+    if (reflectionCount >= 4)
+        parts.push(`${reflectionCount} reflections filed`);
+    if (row.severity_max === 'critical' || row.severity_max === 'high')
+        parts.push(`max severity: ${row.severity_max}`);
+    parts.push(`score: ${row.score}/10`);
+    return parts.length > 0 ? parts.join(', ') : 'recurring pattern detected';
+}
+// ── Test helpers ──
+export function _clearPromotionAudits() {
+    try {
+        const db = getDb();
+        db.prepare('DELETE FROM promotion_audits').run();
+    }
+    catch {
+        // Table may not exist
+    }
+}
+//# sourceMappingURL=insight-promotion.js.map

package/dist/insight-promotion.js.map

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

package/dist/insight-task-bridge.d.ts

@@ -0,0 +1,77 @@
+import { type Event } from './events.js';
+import { type Insight } from './insights.js';
+export interface OwnershipGuardrailConfig {
+    /** When true, avoid assigning auto-created tasks to sole insight author */
+    enabled: boolean;
+    /** When sole author IS assigned (no alternatives), require non-author reviewer */
+    requireNonAuthorReviewer: boolean;
+    /** Override: teams can disable the guardrail entirely */
+    teamOverrides?: Record<string, boolean>;
+}
+export interface AssignmentDecision {
+    assignee: string;
+    reviewer: string;
+    /** Why this assignment was chosen */
+    reason: string;
+    /** Whether the guardrail fired */
+    guardrailApplied: boolean;
+    /** Whether sole-author fallback was used (guardrail wanted to avoid but couldn't) */
+    soleAuthorFallback: boolean;
+    /** Candidates considered (for audit) */
+    candidatesConsidered: string[];
+    /** Authors of the insight */
+    insightAuthors: string[];
+}
+export interface BridgeConfig {
+    enabled: boolean;
+    autoCreateSeverities: string[];
+    defaultReviewer: string;
+    defaultEtaDays: number;
+    assignableAgents: string[];
+    ownershipGuardrail: OwnershipGuardrailConfig;
+}
+export interface BridgeStats {
+    tasksAutoCreated: number;
+    insightsTriaged: number;
+    duplicatesSkipped: number;
+    errors: number;
+    lastEventAt: number | null;
+}
+/**
+ * Update bridge config at runtime (e.g., from policy or API).
+ */
+export declare function configureBridge(partial: Partial<BridgeConfig>): void;
+declare function handlePromotedInsight(event: Event): Promise<void>;
+export declare function isFeatureRequest(insight: Insight): boolean;
+/**
+ * Resolve assignee + reviewer with ownership guardrail.
+ *
+ * Policy:
+ * 1. If guardrail enabled and insight has single author:
+ *    a. Use suggestAssignee (scoring engine) excluding the author
+ *    b. If no non-author candidate available → fallback to author, but require non-author reviewer
+ * 2. If multi-author: normal suggestAssignee routing (authors are valid candidates)
+ * 3. Decision is fully recorded for audit trail
+ */
+export declare function resolveAssignment(insight: Insight, teamId?: string): AssignmentDecision;
+export interface TriageDecision {
+    id: string;
+    insight_id: string;
+    action: 'approve' | 'dismiss';
+    reviewer: string;
+    rationale: string;
+    outcome_task_id: string | null;
+    previous_status: string;
+    new_status: string;
+    timestamp: number;
+}
+export declare function ensureTriageAuditTable(): void;
+export declare function recordTriageDecision(decision: Omit<TriageDecision, 'id'>): TriageDecision;
+export declare function getTriageAudit(insightId?: string, limit?: number): TriageDecision[];
+export declare function startInsightTaskBridge(): void;
+export declare function stopInsightTaskBridge(): void;
+export declare function getInsightTaskBridgeStats(): BridgeStats;
+export declare function _resetBridgeStats(): void;
+export declare function getBridgeConfig(): BridgeConfig;
+export { handlePromotedInsight as _handlePromotedInsight };
+//# sourceMappingURL=insight-task-bridge.d.ts.map

package/dist/insight-task-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-task-bridge.d.ts","sourceRoot":"","sources":["../src/insight-task-bridge.ts"],"names":[],"mappings":"AAYA,OAAO,EAAY,KAAK,KAAK,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAmC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AAO7E,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAA;IAChB,kFAAkF;IAClF,wBAAwB,EAAE,OAAO,CAAA;IACjC,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,gBAAgB,EAAE,OAAO,CAAA;IACzB,qFAAqF;IACrF,kBAAkB,EAAE,OAAO,CAAA;IAC3B,wCAAwC;IACxC,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,6BAA6B;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,kBAAkB,EAAE,wBAAwB,CAAA;CAC7C;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AA0BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAKpE;AAID,iBAAe,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhE;AAsID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAgB1D;AAuED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAgIvF;AA6ED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAiB7C;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,cAAc,CASzF;AAED,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE,CAS/E;AAID,wBAAgB,sBAAsB,IAAI,IAAI,CAa7C;AAgDD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,yBAAyB,IAAI,WAAW,CAEvD;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,OAAO,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,CAAA"}