@cleocode/core 2026.3.57 → 2026.3.58

package/dist/stats/index.js

@@ -0,0 +1,339 @@
+/**
+ * Statistics and analytics core module.
+ * @task T4535
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+/**
+ * Query audit_log entries from SQLite.
+ * Returns a flat array of rows with action, timestamp, and parsed after-status.
+ * @task T5338
+ */
+async function queryAuditEntries(cwd) {
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const { auditLog } = await import('../store/tasks-schema.js');
+        const db = await getDb(cwd ?? process.cwd());
+        const rows = await db
+            .select({
+            action: auditLog.action,
+            timestamp: auditLog.timestamp,
+            afterJson: auditLog.afterJson,
+        })
+            .from(auditLog)
+            .orderBy(auditLog.timestamp);
+        return rows.map((r) => {
+            let afterStatus;
+            if (r.afterJson) {
+                try {
+                    const after = JSON.parse(r.afterJson);
+                    afterStatus = after?.status;
+                }
+                catch {
+                    /* skip malformed */
+                }
+            }
+            return { action: r.action, timestamp: r.timestamp, afterStatus };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/** Period alias resolution. */
+function resolvePeriod(period) {
+    const aliases = {
+        today: 1,
+        t: 1,
+        week: 7,
+        w: 7,
+        month: 30,
+        m: 30,
+        quarter: 90,
+        q: 90,
+        year: 365,
+        y: 365,
+    };
+    const resolved = aliases[period];
+    if (resolved)
+        return resolved;
+    const num = parseInt(period, 10);
+    if (Number.isNaN(num) || num <= 0) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Invalid period: ${period}`);
+    }
+    return num;
+}
+/** Get project statistics. */
+export async function getProjectStats(opts, accessor) {
+    const periodDays = resolvePeriod(opts.period ?? '30');
+    const acc = accessor ?? (await getAccessor(opts.cwd));
+    const { tasks } = await acc.queryTasks({});
+    const pending = tasks.filter((t) => t.status === 'pending').length;
+    const active = tasks.filter((t) => t.status === 'active').length;
+    const done = tasks.filter((t) => t.status === 'done').length;
+    const blocked = tasks.filter((t) => t.status === 'blocked').length;
+    const cancelled = tasks.filter((t) => t.status === 'cancelled').length;
+    const totalActive = tasks.length;
+    const cutoff = new Date(Date.now() - periodDays * 86400000).toISOString();
+    // Read audit entries from SQLite audit_log (ADR-024, T5338)
+    const entries = await queryAuditEntries(opts.cwd);
+    const isCreate = (e) => e.action === 'task_created' || e.action === 'add';
+    const isComplete = (e) => e.action === 'task_completed' ||
+        e.action === 'complete' ||
+        (e.action === 'status_changed' && e.afterStatus === 'done');
+    const isArchive = (e) => e.action === 'task_archived' || e.action === 'archive';
+    const createdInPeriod = entries.filter((e) => isCreate(e) && e.timestamp >= cutoff).length;
+    const completedInPeriod = entries.filter((e) => isComplete(e) && e.timestamp >= cutoff).length;
+    const archivedInPeriod = entries.filter((e) => isArchive(e) && e.timestamp >= cutoff).length;
+    const completionRate = createdInPeriod > 0 ? Math.round((completedInPeriod / createdInPeriod) * 10000) / 100 : 0;
+    // All-time from direct DB counts (audit_log is incomplete — started after task creation history)
+    let totalCreated = 0;
+    let totalCompleted = 0;
+    let totalCancelled = 0;
+    let totalArchived = 0;
+    let archivedCompleted = 0;
+    let archivedCount = 0;
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const { count: dbCount, eq: dbEq, and: dbAnd } = await import('drizzle-orm');
+        const { tasks: tasksTable } = await import('../store/tasks-schema.js');
+        const db = await getDb(opts.cwd);
+        const statusRows = await db
+            .select({ status: tasksTable.status, c: dbCount() })
+            .from(tasksTable)
+            .groupBy(tasksTable.status)
+            .all();
+        const statusMap = {};
+        for (const row of statusRows) {
+            statusMap[row.status] = row.c;
+        }
+        archivedCount = statusMap['archived'] ?? 0;
+        totalCreated = Object.values(statusMap).reduce((sum, n) => sum + n, 0);
+        totalCancelled = statusMap['cancelled'] ?? 0;
+        totalArchived = archivedCount;
+        // Count archived tasks that were completed (archiveReason = 'completed')
+        const archivedDoneRow = await db
+            .select({ c: dbCount() })
+            .from(tasksTable)
+            .where(dbAnd(dbEq(tasksTable.status, 'archived'), dbEq(tasksTable.archiveReason, 'completed')))
+            .get();
+        archivedCompleted = archivedDoneRow?.c ?? 0;
+        // totalCompleted = currently done (not yet archived) + archived-as-completed
+        totalCompleted = (statusMap['done'] ?? 0) + archivedCompleted;
+    }
+    catch {
+        // fallback to audit_log counts if DB unavailable
+        totalCreated = entries.filter(isCreate).length;
+        totalCompleted = entries.filter(isComplete).length;
+        totalArchived = entries.filter(isArchive).length;
+    }
+    return {
+        currentState: {
+            pending,
+            active,
+            done,
+            blocked,
+            cancelled,
+            totalActive,
+            archived: archivedCount,
+            grandTotal: totalActive + archivedCount,
+        },
+        completionMetrics: {
+            periodDays,
+            completedInPeriod,
+            createdInPeriod,
+            completionRate,
+        },
+        activityMetrics: {
+            createdInPeriod,
+            completedInPeriod,
+            archivedInPeriod,
+        },
+        allTime: { totalCreated, totalCompleted, totalCancelled, totalArchived, archivedCompleted },
+    };
+}
+/** Priority numeric weights for ranking blocked tasks. */
+const PRIORITY_WEIGHT = {
+    critical: 4,
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+/** Labels that add urgency boost to blocked task ranking. */
+const URGENT_LABELS = new Set(['critical', 'blocker', 'bug']);
+/**
+ * Compute a ranking score for a blocked task.
+ * Higher score = more urgent = sort first.
+ */
+export function rankBlockedTask(task, allTasks, focusTask) {
+    let score = 0;
+    // (1) Priority weight: 10-40 points
+    score += (PRIORITY_WEIGHT[task.priority ?? 'low'] ?? 1) * 10;
+    // (2) Downstream impact: tasks whose depends array includes this task's id
+    const downstreamCount = allTasks.filter((t) => t.status !== 'done' && (t.depends ?? []).includes(task.id)).length;
+    score += downstreamCount * 5;
+    // (3) Age weight: capped at 30 days, 1 point per day
+    const ageMs = Date.now() - new Date(task.createdAt).getTime();
+    const ageDays = Math.min(Math.floor(ageMs / 86_400_000), 30);
+    score += ageDays;
+    // (4) Focus proximity boost (+15 if sibling/parent/child of focused task)
+    if (focusTask) {
+        const isFocusChild = task.parentId != null && task.parentId === focusTask.id;
+        const isFocusParent = focusTask.parentId != null && task.id === focusTask.parentId;
+        const isFocusSibling = task.parentId != null && task.parentId === focusTask.parentId;
+        if (isFocusChild || isFocusParent || isFocusSibling) {
+            score += 15;
+        }
+    }
+    // (5) Urgent label boost: +8 per urgent label
+    for (const label of task.labels ?? []) {
+        if (URGENT_LABELS.has(label.toLowerCase())) {
+            score += 8;
+        }
+    }
+    // (6) Staleness penalty: recently updated (< 3 days ago) may be actively worked
+    if (task.updatedAt) {
+        const updatedDaysAgo = (Date.now() - new Date(task.updatedAt).getTime()) / 86_400_000;
+        if (updatedDaysAgo < 3) {
+            score -= 10;
+        }
+    }
+    return score;
+}
+/** Priority sort order (lower number = higher priority = sort first). */
+const PRIORITY_ORDER = {
+    critical: 0,
+    high: 1,
+    medium: 2,
+    low: 3,
+};
+/** Get project dashboard data. */
+export async function getDashboard(opts, accessor) {
+    const acc = accessor ?? (await getAccessor(opts.cwd));
+    const { tasks } = await acc.queryTasks({});
+    const pending = tasks.filter((t) => t.status === 'pending').length;
+    const active = tasks.filter((t) => t.status === 'active').length;
+    const done = tasks.filter((t) => t.status === 'done').length;
+    const blocked = tasks.filter((t) => t.status === 'blocked').length;
+    const cancelled = tasks.filter((t) => t.status === 'cancelled').length;
+    const total = tasks.length;
+    // Query archived count directly from DB (loadTaskFile excludes archived rows)
+    let archived = 0;
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const { count: dbCount, eq: dbEq } = await import('drizzle-orm');
+        const { tasks: tasksTable } = await import('../store/tasks-schema.js');
+        const db = await getDb(opts.cwd);
+        const row = await db
+            .select({ c: dbCount() })
+            .from(tasksTable)
+            .where(dbEq(tasksTable.status, 'archived'))
+            .get();
+        archived = row?.c ?? 0;
+    }
+    catch {
+        // archived count unavailable; grandTotal will equal total
+    }
+    const meta = await acc.getMetaValue('project_meta');
+    const project = meta?.name ?? 'Unknown Project';
+    const currentPhase = meta?.currentPhase ?? null;
+    const focus = await acc.getMetaValue('focus_state');
+    const focusId = focus?.currentTask ?? null;
+    let focusTask = null;
+    if (focusId) {
+        focusTask = tasks.find((t) => t.id === focusId) ?? null;
+    }
+    const highPriority = tasks
+        .filter((t) => (t.priority === 'critical' || t.priority === 'high') &&
+        t.status !== 'done' &&
+        t.status !== 'cancelled')
+        .sort((a, b) => {
+        const pDiff = (PRIORITY_ORDER[a.priority ?? 'low'] ?? 9) - (PRIORITY_ORDER[b.priority ?? 'low'] ?? 9);
+        if (pDiff !== 0)
+            return pDiff;
+        return (a.createdAt ?? '').localeCompare(b.createdAt ?? '');
+    });
+    const blockedTasksLimitVal = opts.blockedTasksLimit ?? 10;
+    const allBlockedTasks = tasks.filter((t) => t.status === 'blocked');
+    const rankedBlocked = allBlockedTasks
+        .map((t) => ({ task: t, score: rankBlockedTask(t, tasks, focusTask) }))
+        .sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return (a.task.createdAt ?? '').localeCompare(b.task.createdAt ?? '');
+    })
+        .map((r) => r.task);
+    // Label aggregation (active tasks only — exclude cancelled)
+    const labelMap = {};
+    for (const t of tasks) {
+        if (t.status === 'cancelled')
+            continue;
+        for (const label of t.labels ?? []) {
+            labelMap[label] = (labelMap[label] ?? 0) + 1;
+        }
+    }
+    const topLabels = Object.entries(labelMap)
+        .map(([label, count]) => ({ label, count }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 8);
+    return {
+        project,
+        currentPhase,
+        summary: {
+            pending,
+            active,
+            blocked,
+            done,
+            cancelled,
+            total,
+            archived,
+            grandTotal: total + archived,
+        },
+        focus: { currentTask: focusId, task: focusTask },
+        highPriority: { count: highPriority.length, tasks: highPriority.slice(0, 5) },
+        blockedTasks: {
+            count: rankedBlocked.length,
+            limit: blockedTasksLimitVal,
+            tasks: rankedBlocked.slice(0, blockedTasksLimitVal),
+        },
+        topLabels,
+        periodDays: opts.period ?? 7,
+    };
+}
+/** Get completion history data. */
+export async function getCompletionHistory(opts) {
+    const allEntries = await queryAuditEntries(opts.cwd);
+    const days = opts.days ?? 30;
+    const cutoff = opts.since ?? new Date(Date.now() - days * 86400000).toISOString();
+    const endDate = opts.until ?? new Date().toISOString();
+    const completions = allEntries.filter((e) => (e.action === 'task_completed' ||
+        e.action === 'complete' ||
+        (e.action === 'status_changed' && e.afterStatus === 'done')) &&
+        e.timestamp >= cutoff &&
+        e.timestamp <= endDate);
+    // Group by date
+    const byDate = {};
+    for (const c of completions) {
+        const date = c.timestamp.split('T')[0];
+        byDate[date] = (byDate[date] ?? 0) + 1;
+    }
+    const dailyCounts = Object.entries(byDate)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([date, count]) => ({ date, count }));
+    const totalCompletions = completions.length;
+    const avgPerDay = days > 0 ? Math.round((totalCompletions / days) * 100) / 100 : 0;
+    const peakDay = dailyCounts.reduce((max, d) => (d.count > max.count ? d : max), {
+        date: '',
+        count: 0,
+    });
+    return {
+        period: { days, since: cutoff, until: endDate },
+        totalCompletions,
+        avgPerDay,
+        peakDay,
+        dailyCounts,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stats/index.js.map

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

package/dist/stats/workflow-telemetry.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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
+ */
+/** Per-rule compliance breakdown. */
+export interface WorkflowRuleMetric {
+    /** Rule identifier, e.g. WF-001. */
+    rule: string;
+    /** Human-readable rule description. */
+    description: string;
+    /** Total tasks or events that were subject to this rule. */
+    total: number;
+    /** Number that violated the rule. */
+    violations: number;
+    /** Compliance rate 0..1 (1 = fully compliant). */
+    complianceRate: number;
+}
+/** Full workflow compliance report. */
+export interface WorkflowComplianceReport {
+    /** ISO timestamp when metrics were computed. */
+    generatedAt: string;
+    /** Time window filtered (ISO cutoff) or null for all-time. */
+    since: string | null;
+    /** Overall compliance score 0..1 (average of all rule rates). */
+    overallScore: number;
+    /** Grade letter derived from overallScore. */
+    grade: string;
+    /** Per-rule breakdown. */
+    rules: WorkflowRuleMetric[];
+    /** Task-level violation samples (up to 20). */
+    violationSamples: Array<{
+        taskId: string;
+        rule: string;
+        detail: string;
+    }>;
+    /** Raw counts for context. */
+    summary: {
+        totalTasks: number;
+        completedTasks: number;
+        tasksWithAC: number;
+        tasksWithoutAC: number;
+        completionsInSession: number;
+        completionsOutsideSession: number;
+        tasksWithGates: number;
+        avgGatesSet: number;
+    };
+}
+/**
+ * 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)
+ */
+export declare function getWorkflowComplianceReport(opts: {
+    since?: string;
+    cwd?: string;
+}): Promise<WorkflowComplianceReport>;
+//# sourceMappingURL=workflow-telemetry.d.ts.map

package/dist/stats/workflow-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-telemetry.d.ts","sourceRoot":"","sources":["../../src/stats/workflow-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,+CAA+C;IAC/C,gBAAgB,EAAE,KAAK,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,8BAA8B;IAC9B,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,yBAAyB,EAAE,MAAM,CAAC;QAClC,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AA8JD;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA2PpC"}

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"}