@cleocode/core 2026.4.9 → 2026.4.12

package/dist/stats/workflow-telemetry.js

@@ -0,0 +1,400 @@
+/**
+ * Workflow Telemetry Module — Agent Workflow Compliance Metrics
+ *
+ * Computes compliance metrics for WF-001 through WF-005 workflow rules
+ * defined in T063. Queries existing data from tasks, sessions, and audit_log
+ * tables — no new infrastructure required.
+ *
+ * Metrics produced:
+ *   - AC compliance rate:      % of tasks with ≥3 acceptance criteria
+ *   - Session compliance rate: % of task completions that occurred within a session
+ *   - Gate compliance rate:    Average verification gates set per completed task
+ *   - Workflow violations:     Count of tasks that bypassed WF rules
+ *
+ * @task T065
+ * @epic T056
+ */
+import { getLogger } from '../logger.js';
+const log = getLogger('workflow-telemetry');
+// ---------------------------------------------------------------------------
+// DB helpers
+// ---------------------------------------------------------------------------
+async function queryTasks(cwd, since) {
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const { tasks } = await import('../store/tasks-schema.js');
+        const { and, gte } = await import('drizzle-orm');
+        const db = await getDb(cwd);
+        const conditions = [];
+        if (since) {
+            // Include tasks created or completed since the cutoff
+            conditions.push(gte(tasks.createdAt, since));
+        }
+        const rows = await db
+            .select({
+            id: tasks.id,
+            status: tasks.status,
+            acceptanceJson: tasks.acceptanceJson,
+            verificationJson: tasks.verificationJson,
+            sessionId: tasks.sessionId,
+            completedAt: tasks.completedAt,
+            createdAt: tasks.createdAt,
+        })
+            .from(tasks)
+            .where(conditions.length > 0 ? and(...conditions) : undefined)
+            .all();
+        return rows;
+    }
+    catch (err) {
+        log.warn({ err }, 'Failed to query tasks for workflow telemetry');
+        return [];
+    }
+}
+async function queryCompletionAuditRows(cwd, since) {
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const { auditLog } = await import('../store/tasks-schema.js');
+        const { and, gte } = await import('drizzle-orm');
+        const db = await getDb(cwd);
+        // Completion events: action = 'task_completed' OR 'complete'
+        // OR operation = 'complete' in dispatch layer
+        const conditions = [];
+        if (since)
+            conditions.push(gte(auditLog.timestamp, since));
+        const allRows = await db
+            .select({
+            action: auditLog.action,
+            timestamp: auditLog.timestamp,
+            taskId: auditLog.taskId,
+            sessionId: auditLog.sessionId,
+            afterJson: auditLog.afterJson,
+            operation: auditLog.operation,
+            domain: auditLog.domain,
+        })
+            .from(auditLog)
+            .where(conditions.length > 0 ? and(...conditions) : undefined)
+            .orderBy(auditLog.timestamp)
+            .all();
+        // Filter to completion events only
+        return allRows.filter((row) => {
+            const isComplete = row.action === 'task_completed' ||
+                row.action === 'complete' ||
+                (row.operation === 'complete' && row.domain === 'tasks');
+            // Also catch status_changed → done
+            if (!isComplete && row.afterJson) {
+                try {
+                    const after = JSON.parse(row.afterJson);
+                    return after?.status === 'done';
+                }
+                catch {
+                    return false;
+                }
+            }
+            return isComplete;
+        });
+    }
+    catch (err) {
+        log.warn({ err }, 'Failed to query audit log for workflow telemetry');
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Metric helpers
+// ---------------------------------------------------------------------------
+function parseAcceptanceCriteria(acceptanceJson) {
+    if (!acceptanceJson)
+        return [];
+    try {
+        const parsed = JSON.parse(acceptanceJson);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function parseVerification(verificationJson) {
+    if (!verificationJson)
+        return null;
+    try {
+        return JSON.parse(verificationJson);
+    }
+    catch {
+        return null;
+    }
+}
+function countTrueGates(gates) {
+    if (!gates || typeof gates !== 'object')
+        return 0;
+    return Object.values(gates).filter((v) => v === true).length;
+}
+function gradeFromScore(score) {
+    if (score >= 0.95)
+        return 'A+';
+    if (score >= 0.9)
+        return 'A';
+    if (score >= 0.8)
+        return 'B';
+    if (score >= 0.7)
+        return 'C';
+    if (score >= 0.6)
+        return 'D';
+    return 'F';
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Compute workflow compliance metrics from existing task, session, and audit data.
+ *
+ * Rules evaluated:
+ *   WF-001: Tasks MUST have ≥3 acceptance criteria (T058)
+ *   WF-002: Task completions MUST occur within an active session (T059)
+ *   WF-003: Completed tasks SHOULD have verification gates set (T061)
+ *   WF-004: Tasks with verification SHOULD have all 3 gates set
+ *   WF-005: Tasks MUST have session binding on creation (non-epic)
+ *
+ * @remarks
+ * Derives all metrics from existing audit_log and tasks tables — no new
+ * tracking infrastructure is required.
+ *
+ * @param opts - Report options
+ * @param opts.since - ISO 8601 date string to filter metrics from
+ * @param opts.cwd - Working directory for database resolution
+ * @returns Compliance report with per-rule pass/fail counts and overall rate
+ *
+ * @example
+ * ```ts
+ * const report = await getWorkflowComplianceReport({ cwd: '/my/project' });
+ * console.log(report.overall.passRate); // e.g. 0.85
+ * ```
+ */
+export async function getWorkflowComplianceReport(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const since = opts.since ?? null;
+    const generatedAt = new Date().toISOString();
+    const [allTasks, completionEvents] = await Promise.all([
+        queryTasks(cwd, since),
+        queryCompletionAuditRows(cwd, since),
+    ]);
+    // Include all tasks in WF checks. Epics will naturally show 0 AC criteria
+    // which counts as a violation — this is acceptable since epics should also
+    // have AC defined. The raw task query does not include the type column to
+    // keep the query minimal, so we don't filter by type here.
+    const nonEpicTasks = allTasks;
+    const completedTasks = allTasks.filter((t) => t.status === 'done' || t.completedAt != null);
+    // -------------------------------------------------------------------------
+    // WF-001: AC compliance — tasks with ≥3 acceptance criteria
+    // -------------------------------------------------------------------------
+    const wf001Violations = [];
+    let tasksWithAC = 0;
+    let tasksWithoutAC = 0;
+    for (const task of nonEpicTasks) {
+        const ac = parseAcceptanceCriteria(task.acceptanceJson);
+        if (ac.length >= 3) {
+            tasksWithAC++;
+        }
+        else {
+            tasksWithoutAC++;
+            if (wf001Violations.length < 10) {
+                wf001Violations.push({
+                    taskId: task.id,
+                    rule: 'WF-001',
+                    detail: `has ${ac.length} AC item(s), needs ≥3`,
+                });
+            }
+        }
+    }
+    const wf001Total = nonEpicTasks.length;
+    const wf001Rate = wf001Total > 0 ? tasksWithAC / wf001Total : 1;
+    // -------------------------------------------------------------------------
+    // WF-002: Session compliance — completions that occurred inside a session
+    // -------------------------------------------------------------------------
+    const wf002Violations = [];
+    let completionsInSession = 0;
+    let completionsOutsideSession = 0;
+    for (const event of completionEvents) {
+        if (event.sessionId && event.sessionId !== 'unknown' && event.sessionId !== 'system') {
+            completionsInSession++;
+        }
+        else {
+            completionsOutsideSession++;
+            if (wf002Violations.length < 5) {
+                wf002Violations.push({
+                    taskId: event.taskId ?? 'unknown',
+                    rule: 'WF-002',
+                    detail: 'task completed outside an active session',
+                });
+            }
+        }
+    }
+    const wf002Total = completionEvents.length;
+    const wf002Rate = wf002Total > 0 ? completionsInSession / wf002Total : 1;
+    // -------------------------------------------------------------------------
+    // WF-003: Gate compliance — completed tasks with verification initialized
+    // -------------------------------------------------------------------------
+    const wf003Violations = [];
+    let tasksWithGates = 0;
+    let tasksWithoutGates = 0;
+    let totalGatesSet = 0;
+    let gateTaskCount = 0;
+    for (const task of completedTasks) {
+        const verification = parseVerification(task.verificationJson);
+        if (verification) {
+            tasksWithGates++;
+            const gates = (verification.gates ?? {});
+            const setCount = countTrueGates(gates);
+            totalGatesSet += setCount;
+            gateTaskCount++;
+        }
+        else {
+            tasksWithoutGates++;
+            if (wf003Violations.length < 5) {
+                wf003Violations.push({
+                    taskId: task.id,
+                    rule: 'WF-003',
+                    detail: 'completed without verification gates',
+                });
+            }
+        }
+    }
+    const wf003Total = completedTasks.length;
+    const wf003Rate = wf003Total > 0 ? tasksWithGates / wf003Total : 1;
+    const avgGatesSet = gateTaskCount > 0 ? Math.round((totalGatesSet / gateTaskCount) * 100) / 100 : 0;
+    // -------------------------------------------------------------------------
+    // WF-004: Full gate compliance — tasks with verification where all 3 gates are set
+    // -------------------------------------------------------------------------
+    const wf004Violations = [];
+    let allGatesSet = 0;
+    let partialGates = 0;
+    for (const task of completedTasks) {
+        const verification = parseVerification(task.verificationJson);
+        if (!verification)
+            continue; // Already captured in WF-003
+        const gates = (verification.gates ?? {});
+        const setCount = countTrueGates(gates);
+        const totalGates = Object.keys(gates).length;
+        if (totalGates > 0 && setCount === totalGates) {
+            allGatesSet++;
+        }
+        else if (totalGates > 0) {
+            partialGates++;
+            if (wf004Violations.length < 5) {
+                wf004Violations.push({
+                    taskId: task.id,
+                    rule: 'WF-004',
+                    detail: `only ${setCount}/${totalGates} verification gates set`,
+                });
+            }
+        }
+    }
+    const wf004Total = tasksWithGates;
+    const wf004Rate = wf004Total > 0 ? allGatesSet / wf004Total : 1;
+    // -------------------------------------------------------------------------
+    // WF-005: Session binding on creation — tasks with sessionId set
+    // -------------------------------------------------------------------------
+    const wf005Violations = [];
+    let tasksWithSessionBinding = 0;
+    let tasksWithoutSessionBinding = 0;
+    for (const task of nonEpicTasks) {
+        if (task.sessionId && task.sessionId !== 'unknown' && task.sessionId !== 'system') {
+            tasksWithSessionBinding++;
+        }
+        else {
+            tasksWithoutSessionBinding++;
+            if (wf005Violations.length < 5) {
+                wf005Violations.push({
+                    taskId: task.id,
+                    rule: 'WF-005',
+                    detail: 'created without session binding',
+                });
+            }
+        }
+    }
+    const wf005Total = nonEpicTasks.length;
+    const wf005Rate = wf005Total > 0 ? tasksWithSessionBinding / wf005Total : 1;
+    // -------------------------------------------------------------------------
+    // Aggregate
+    // -------------------------------------------------------------------------
+    const rules = [
+        {
+            rule: 'WF-001',
+            description: 'Tasks must have ≥3 acceptance criteria',
+            total: wf001Total,
+            violations: tasksWithoutAC,
+            complianceRate: Math.round(wf001Rate * 10000) / 10000,
+        },
+        {
+            rule: 'WF-002',
+            description: 'Task completions must occur within an active session',
+            total: wf002Total,
+            violations: completionsOutsideSession,
+            complianceRate: Math.round(wf002Rate * 10000) / 10000,
+        },
+        {
+            rule: 'WF-003',
+            description: 'Completed tasks should have verification gates initialized',
+            total: wf003Total,
+            violations: tasksWithoutGates,
+            complianceRate: Math.round(wf003Rate * 10000) / 10000,
+        },
+        {
+            rule: 'WF-004',
+            description: 'Verification gates should all be marked passed before completion',
+            total: wf004Total,
+            violations: partialGates,
+            complianceRate: Math.round(wf004Rate * 10000) / 10000,
+        },
+        {
+            rule: 'WF-005',
+            description: 'Tasks must be created with active session binding',
+            total: wf005Total,
+            violations: tasksWithoutSessionBinding,
+            complianceRate: Math.round(wf005Rate * 10000) / 10000,
+        },
+    ];
+    // Overall score: weighted average (MUST rules count double vs SHOULD)
+    // WF-001, WF-002, WF-005 are MUST; WF-003, WF-004 are SHOULD
+    const mustWeight = 2;
+    const shouldWeight = 1;
+    const wf001w = wf001Total > 0 ? mustWeight : 0;
+    const wf002w = wf002Total > 0 ? mustWeight : 0;
+    const wf003w = wf003Total > 0 ? shouldWeight : 0;
+    const wf004w = wf004Total > 0 ? shouldWeight : 0;
+    const wf005w = wf005Total > 0 ? mustWeight : 0;
+    const totalWeight = wf001w + wf002w + wf003w + wf004w + wf005w;
+    const overallScore = totalWeight > 0
+        ? (wf001w * wf001Rate +
+            wf002w * wf002Rate +
+            wf003w * wf003Rate +
+            wf004w * wf004Rate +
+            wf005w * wf005Rate) /
+            totalWeight
+        : 1;
+    const roundedScore = Math.round(overallScore * 10000) / 10000;
+    const violationSamples = [
+        ...wf001Violations,
+        ...wf002Violations,
+        ...wf003Violations,
+        ...wf004Violations,
+        ...wf005Violations,
+    ].slice(0, 20);
+    return {
+        generatedAt,
+        since,
+        overallScore: roundedScore,
+        grade: gradeFromScore(roundedScore),
+        rules,
+        violationSamples,
+        summary: {
+            totalTasks: allTasks.length,
+            completedTasks: completedTasks.length,
+            tasksWithAC,
+            tasksWithoutAC,
+            completionsInSession,
+            completionsOutsideSession,
+            tasksWithGates,
+            avgGatesSet,
+        },
+    };
+}
+//# sourceMappingURL=workflow-telemetry.js.map

package/dist/stats/workflow-telemetry.js.map

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

package/dist/sticky/archive.js

@@ -0,0 +1,47 @@
+/**
+ * Sticky Note Archival
+ *
+ * Archives sticky notes (soft delete).
+ *
+ * @task T5280
+ * @epic T5267
+ */
+import { getBrainAccessor } from '../store/brain-accessor.js';
+/**
+ * Convert database row to StickyNote interface.
+ */
+function rowToStickyNote(row) {
+    return {
+        id: row.id,
+        content: row.content,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt ?? undefined,
+        tags: row.tagsJson ? JSON.parse(row.tagsJson) : [],
+        status: row.status,
+        convertedTo: row.convertedToJson ? JSON.parse(row.convertedToJson) : undefined,
+        color: row.color ?? undefined,
+        priority: row.priority ?? undefined,
+        sourceType: row.sourceType ?? 'sticky-note',
+    };
+}
+/**
+ * Archive a sticky note.
+ *
+ * @param id - Sticky note ID
+ * @param projectRoot - Project root path
+ * @returns The archived sticky note or null if not found
+ */
+export async function archiveSticky(id, projectRoot) {
+    const accessor = await getBrainAccessor(projectRoot);
+    const sticky = await accessor.getStickyNote(id);
+    if (!sticky) {
+        return null;
+    }
+    await accessor.updateStickyNote(id, {
+        status: 'archived',
+    });
+    // Fetch updated record
+    const updated = await accessor.getStickyNote(id);
+    return updated ? rowToStickyNote(updated) : null;
+}
+//# sourceMappingURL=archive.js.map

package/dist/sticky/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/sticky/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAI9D;;GAEG;AACH,SAAS,eAAe,CAAC,GAAuB;IAC9C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;QACrC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QAClD,MAAM,EAAE,GAAG,CAAC,MAA8B;QAC1C,WAAW,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9E,KAAK,EAAG,GAAG,CAAC,KAA6B,IAAI,SAAS;QACtD,QAAQ,EAAG,GAAG,CAAC,QAAmC,IAAI,SAAS;QAC/D,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,aAAa;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAU,EAAE,WAAmB;IACjE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE;QAClC,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC"}