@cleocode/core 2026.4.9 → 2026.4.12

package/dist/repair.js

@@ -0,0 +1,130 @@
+/**
+ * Repair functions for fixable data integrity issues — SQLite era.
+ *
+ * Each function performs a direct Drizzle SQL update (no in-memory TaskFile mutation).
+ * Used by both `upgrade` and `validate --fix`.
+ *
+ * @task T4862
+ */
+/**
+ * Set size='medium' on tasks that have no size value.
+ * Operates directly on the SQLite tasks table.
+ */
+export async function repairMissingSizes(cwd, dryRun) {
+    const { getDb } = await import('./store/sqlite.js');
+    const { tasks } = await import('./store/tasks-schema.js');
+    const { isNull } = await import('drizzle-orm');
+    const db = await getDb(cwd);
+    const affected = await db.select({ id: tasks.id }).from(tasks).where(isNull(tasks.size));
+    if (affected.length === 0) {
+        return {
+            action: 'fix_missing_sizes',
+            status: 'skipped',
+            details: 'No tasks missing size field',
+        };
+    }
+    if (dryRun) {
+        return {
+            action: 'fix_missing_sizes',
+            status: 'preview',
+            details: `Would set size='medium' for ${affected.length} task(s)`,
+        };
+    }
+    await db.update(tasks).set({ size: 'medium' }).where(isNull(tasks.size));
+    return {
+        action: 'fix_missing_sizes',
+        status: 'applied',
+        details: `Set size='medium' for ${affected.length} task(s)`,
+    };
+}
+/**
+ * Set completedAt=now() on done/cancelled tasks that are missing a completedAt timestamp.
+ * Operates directly on the SQLite tasks table.
+ */
+export async function repairMissingCompletedAt(cwd, dryRun) {
+    const { getDb } = await import('./store/sqlite.js');
+    const { tasks } = await import('./store/tasks-schema.js');
+    const { sql } = await import('drizzle-orm');
+    const db = await getDb(cwd);
+    const affected = await db
+        .select({ id: tasks.id })
+        .from(tasks)
+        .where(sql `(${tasks.status} = 'done' OR ${tasks.status} = 'cancelled') AND ${tasks.completedAt} IS NULL`);
+    if (affected.length === 0) {
+        return {
+            action: 'fix_completed_at',
+            status: 'skipped',
+            details: 'No done/cancelled tasks missing completedAt',
+        };
+    }
+    if (dryRun) {
+        return {
+            action: 'fix_completed_at',
+            status: 'preview',
+            details: `Would set completedAt for ${affected.length} done/cancelled task(s)`,
+        };
+    }
+    const now = new Date().toISOString();
+    await db
+        .update(tasks)
+        .set({ completedAt: now })
+        .where(sql `(${tasks.status} = 'done' OR ${tasks.status} = 'cancelled') AND ${tasks.completedAt} IS NULL`);
+    return {
+        action: 'fix_completed_at',
+        status: 'applied',
+        details: `Set completedAt for ${affected.length} done/cancelled task(s)`,
+    };
+}
+/**
+ * Detect and add missing required columns on the tasks table.
+ * Uses PRAGMA table_info to check actual schema vs required columns.
+ *
+ * @see https://github.com/anthropics/cleo/issues/63
+ */
+export async function repairMissingColumns(cwd, dryRun) {
+    const { getDb } = await import('./store/sqlite.js');
+    const db = await getDb(cwd);
+    // getDb() already calls ensureRequiredColumns(), so if we get here
+    // the column should exist. But we still report the action for visibility.
+    const { sql } = await import('drizzle-orm');
+    const columns = db.all(sql `PRAGMA table_info(tasks)`);
+    const existingCols = new Set(columns.map((c) => c.name));
+    const missingCols = ['pipeline_stage'].filter((c) => !existingCols.has(c));
+    if (missingCols.length === 0) {
+        return {
+            action: 'fix_missing_columns',
+            status: 'skipped',
+            details: 'All required columns present on tasks table',
+        };
+    }
+    if (dryRun) {
+        return {
+            action: 'fix_missing_columns',
+            status: 'preview',
+            details: `Would add missing column(s): ${missingCols.join(', ')}`,
+        };
+    }
+    // Columns should already be added by ensureRequiredColumns() in getDb(),
+    // but apply again defensively.
+    for (const col of missingCols) {
+        db.run(sql.raw(`ALTER TABLE tasks ADD COLUMN ${col} text`));
+    }
+    return {
+        action: 'fix_missing_columns',
+        status: 'applied',
+        details: `Added missing column(s): ${missingCols.join(', ')}`,
+    };
+}
+/**
+ * Run all repair functions.
+ * Returns all actions taken (or previewed in dry-run mode).
+ */
+export async function runAllRepairs(cwd, dryRun) {
+    const [sizes, completedAt, columns] = await Promise.all([
+        repairMissingSizes(cwd, dryRun),
+        repairMissingCompletedAt(cwd, dryRun),
+        repairMissingColumns(cwd, dryRun),
+    ]);
+    return [sizes, completedAt, columns];
+}
+//# sourceMappingURL=repair.js.map

package/dist/repair.js.map

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

package/dist/research/index.js

@@ -0,0 +1,2 @@
+export * from '../memory/index.js';
+//# sourceMappingURL=index.js.map

package/dist/research/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/roadmap/index.js

@@ -0,0 +1,59 @@
+/**
+ * Roadmap generation core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getAccessor } from '../store/data-accessor.js';
+/** Get roadmap from pending epics and CHANGELOG history. */
+export async function getRoadmap(opts, accessor) {
+    const acc = accessor ?? (await getAccessor(opts.cwd));
+    const { tasks } = await acc.queryTasks({});
+    // Get current version
+    const versionPath = join(opts.cwd ?? process.cwd(), 'VERSION');
+    const currentVersion = existsSync(versionPath)
+        ? readFileSync(versionPath, 'utf-8').trim()
+        : 'unknown';
+    // Find epics (tasks that are parents of other tasks)
+    const childParentIds = new Set(tasks.filter((t) => t.parentId).map((t) => t.parentId));
+    const epics = tasks.filter((t) => childParentIds.has(t.id));
+    // Group epics by status
+    const pending = epics.filter((e) => e.status !== 'done');
+    const completed = epics.filter((e) => e.status === 'done');
+    // Parse CHANGELOG if requested
+    const releaseHistory = [];
+    if (opts.includeHistory) {
+        const changelogPath = join(opts.cwd ?? process.cwd(), 'CHANGELOG.md');
+        if (existsSync(changelogPath)) {
+            const content = readFileSync(changelogPath, 'utf-8');
+            const versionRegex = /^##\s+\[?v?(\d+\.\d+\.\d+[^\]]*)\]?\s*[-(]?\s*(\d{4}-\d{2}-\d{2})?/gm;
+            for (const match of content.matchAll(versionRegex)) {
+                releaseHistory.push({
+                    version: match[1],
+                    date: match[2] ?? 'unknown',
+                });
+            }
+        }
+    }
+    const upcoming = pending.map((e) => ({
+        id: e.id,
+        title: e.title,
+        status: e.status,
+        priority: e.priority,
+        phase: e.phase,
+        childCount: tasks.filter((t) => t.parentId === e.id).length,
+        completedChildren: tasks.filter((t) => t.parentId === e.id && t.status === 'done').length,
+    }));
+    return {
+        currentVersion,
+        upcoming,
+        ...(opts.includeHistory && { releaseHistory }),
+        ...(opts.includeHistory && { completedEpics: completed.length }),
+        summary: {
+            totalUpcoming: upcoming.length,
+            totalTasks: tasks.length,
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/roadmap/index.js.map

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