@cleocode/cleo 2026.2.5

package/dist/core/roadmap/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Roadmap generation core module.
+ * @task T4538
+ * @epic T4454
+ */
+import type { DataAccessor } from '../../store/data-accessor.js';
+/** Get roadmap from pending epics and CHANGELOG history. */
+export declare function getRoadmap(opts: {
+    includeHistory?: boolean;
+    upcomingOnly?: boolean;
+    cwd?: string;
+}, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/roadmap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/roadmap/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,4DAA4D;AAC5D,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyD5D"}

package/dist/core/roadmap/index.js

@@ -0,0 +1,63 @@
+/**
+ * Roadmap generation core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJson } from '../../store/json.js';
+import { getTodoPath } from '../paths.js';
+/** Get roadmap from pending epics and CHANGELOG history. */
+export async function getRoadmap(opts, accessor) {
+    const data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJson(getTodoPath(opts.cwd));
+    const tasks = data?.tasks ?? [];
+    // 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
+    let 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;
+            let match;
+            while ((match = versionRegex.exec(content)) !== null) {
+                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/core/roadmap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/roadmap/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAIhC,EAAE,QAAuB;IACxB,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,QAAQ,CAAW,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IAEhC,sBAAsB;IACtB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;QAC5C,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE;QAC3C,CAAC,CAAC,SAAS,CAAC;IAEd,qDAAqD;IACrD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1D,wBAAwB;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAEzD,+BAA+B;IAC/B,IAAI,cAAc,GAA6C,EAAE,CAAC;IAClE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACtE,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,YAAY,GAAG,uEAAuE,CAAC;YAC7F,IAAI,KAAK,CAAC;YACV,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBACrD,cAAc,CAAC,IAAI,CAAC;oBAClB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE;oBAClB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjC,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM;QACzD,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;KACxF,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,cAAc;QACd,QAAQ;QACR,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,cAAc,EAAE,CAAC;QAC9C,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;QAChE,OAAO,EAAE;YACP,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,UAAU,EAAE,KAAK,CAAC,MAAM;SACzB;KACF,CAAC;AACJ,CAAC"}

package/dist/core/schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * JSON Schema validation engine using ajv.
+ * @epic T4454
+ * @task T4458
+ */
+/**
+ * Validate data against a JSON Schema object.
+ * Throws CleoError on validation failure.
+ */
+export declare function validateAgainstSchema(data: unknown, schema: Record<string, unknown>, schemaId?: string): void;
+/**
+ * Load a JSON Schema file and validate data against it.
+ */
+export declare function validateAgainstSchemaFile(data: unknown, schemaPath: string): Promise<void>;
+/**
+ * Check if data is valid against a schema without throwing.
+ * Returns an array of error messages (empty if valid).
+ */
+export declare function checkSchema(data: unknown, schema: Record<string, unknown>): string[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiCH;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAqBN;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,EAAE,CAUV"}

package/dist/core/schema.js

@@ -0,0 +1,75 @@
+/**
+ * JSON Schema validation engine using ajv.
+ * @epic T4454
+ * @task T4458
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import AjvModule from 'ajv';
+import addFormatsModule from 'ajv-formats';
+import { readJson } from '../store/json.js';
+import { CleoError } from './errors.js';
+import { ExitCode } from '../types/exit-codes.js';
+// Handle ESM/CJS interop for Ajv and ajv-formats
+const Ajv = AjvModule.default ?? AjvModule;
+const addFormats = addFormatsModule.default ?? addFormatsModule;
+/** Singleton ajv instance. */
+let ajvInstance = null;
+function getAjv() {
+    if (!ajvInstance) {
+        ajvInstance = new Ajv({
+            allErrors: true,
+            strict: false,
+            allowUnionTypes: true,
+        });
+        addFormats(ajvInstance);
+    }
+    return ajvInstance;
+}
+/** Compiled schema cache. */
+const schemaCache = new Map();
+/**
+ * Validate data against a JSON Schema object.
+ * Throws CleoError on validation failure.
+ */
+export function validateAgainstSchema(data, schema, schemaId) {
+    const ajv = getAjv();
+    const cacheKey = schemaId ?? JSON.stringify(schema);
+    let validate = schemaCache.get(cacheKey);
+    if (!validate) {
+        validate = ajv.compile(schema);
+        schemaCache.set(cacheKey, validate);
+    }
+    if (!validate(data)) {
+        const errors = validate.errors
+            ?.map((e) => `${e.instancePath || '/'}: ${e.message}`)
+            .join('; ');
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Schema validation failed: ${errors ?? 'unknown error'}`);
+    }
+}
+/**
+ * Load a JSON Schema file and validate data against it.
+ */
+export async function validateAgainstSchemaFile(data, schemaPath) {
+    const schema = await readJson(schemaPath);
+    if (!schema) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Schema file not found: ${schemaPath}`);
+    }
+    validateAgainstSchema(data, schema, schemaPath);
+}
+/**
+ * Check if data is valid against a schema without throwing.
+ * Returns an array of error messages (empty if valid).
+ */
+export function checkSchema(data, schema) {
+    try {
+        validateAgainstSchema(data, schema);
+        return [];
+    }
+    catch (err) {
+        if (err instanceof CleoError) {
+            return [err.message];
+        }
+        return [String(err)];
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uDAAuD;AAEvD,OAAO,SAAS,MAAM,KAAK,CAAC;AAC5B,OAAO,gBAAgB,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,iDAAiD;AACjD,MAAM,GAAG,GAAI,SAAiB,CAAC,OAAO,IAAI,SAAS,CAAC;AACpD,MAAM,UAAU,GAAI,gBAAwB,CAAC,OAAO,IAAI,gBAAgB,CAAC;AAEzE,8BAA8B;AAC9B,IAAI,WAAW,GAAQ,IAAI,CAAC;AAE5B,SAAS,MAAM;IACb,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,GAAG,CAAC;YACpB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,KAAK;YACb,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QACH,UAAU,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,6BAA6B;AAC7B,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAa,EACb,MAA+B,EAC/B,QAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEpD,IAAI,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAqB,CAAC;QACnD,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM;YAC5B,EAAE,GAAG,CAAC,CAAC,CAA8C,EAAE,EAAE,CACvD,GAAG,CAAC,CAAC,YAAY,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,CACzC;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,6BAA6B,MAAM,IAAI,eAAe,EAAE,CACzD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAAa,EACb,UAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAA0B,UAAU,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,SAAS,EAClB,0BAA0B,UAAU,EAAE,CACvC,CAAC;IACJ,CAAC;IACD,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,IAAa,EACb,MAA+B;IAE/B,IAAI,CAAC;QACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/core/sequence/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Task ID sequence management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import type { DataAccessor } from '../../store/data-accessor.js';
+/** Show current sequence state. */
+export declare function showSequence(cwd?: string): Promise<Record<string, unknown>>;
+/** Check sequence integrity. */
+export declare function checkSequence(cwd?: string, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+/** Repair result with proper typing. */
+export interface RepairResult {
+    repaired: boolean;
+    message: string;
+    counter: number;
+    oldCounter?: number;
+    newCounter?: number;
+}
+/** Repair sequence if behind. */
+export declare function repairSequence(cwd?: string, accessor?: DataAccessor): Promise<RepairResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/sequence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/sequence/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA8BjE,mCAAmC;AACnC,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWjF;AAED,gCAAgC;AAChC,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8B3G;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iCAAiC;AACjC,wBAAsB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAuCjG"}

package/dist/core/sequence/index.js

@@ -0,0 +1,108 @@
+/**
+ * Task ID sequence management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJson } from '../../store/json.js';
+import { getTaskPath, getArchivePath } from '../paths.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+function getSequencePath(cwd) {
+    return join(cwd ?? process.cwd(), '.cleo', '.sequence.json');
+}
+function readSequence(cwd) {
+    const path = getSequencePath(cwd);
+    if (!existsSync(path))
+        return null;
+    return JSON.parse(readFileSync(path, 'utf-8'));
+}
+function getMaxIdFromTasks(tasks) {
+    let max = 0;
+    for (const t of tasks) {
+        const match = t.id.match(/^T(\d+)$/);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > max)
+                max = num;
+        }
+    }
+    return max;
+}
+/** Show current sequence state. */
+export async function showSequence(cwd) {
+    const seq = readSequence(cwd);
+    if (!seq) {
+        throw new CleoError(ExitCode.NOT_FOUND, 'Sequence file not found');
+    }
+    return {
+        counter: seq.counter,
+        lastId: seq.lastId,
+        checksum: seq.checksum,
+        nextId: `T${seq.counter + 1}`,
+    };
+}
+/** Check sequence integrity. */
+export async function checkSequence(cwd, accessor) {
+    const seq = readSequence(cwd);
+    if (!seq) {
+        throw new CleoError(ExitCode.NOT_FOUND, 'Sequence file not found');
+    }
+    const todoData = accessor
+        ? await accessor.loadTaskFile()
+        : await readJson(getTaskPath(cwd));
+    const archiveData = accessor
+        ? await accessor.loadArchive()
+        : await readJson(getArchivePath(cwd));
+    const allTasks = [
+        ...(todoData?.tasks ?? []),
+        ...(archiveData?.archivedTasks ?? []),
+    ];
+    const maxId = getMaxIdFromTasks(allTasks);
+    const valid = seq.counter >= maxId;
+    return {
+        counter: seq.counter,
+        maxIdInData: maxId,
+        valid,
+        ...(valid ? {} : {
+            issue: `Counter (${seq.counter}) is behind max ID (T${maxId})`,
+            fix: 'Run cleo sequence repair',
+        }),
+    };
+}
+/** Repair sequence if behind. */
+export async function repairSequence(cwd, accessor) {
+    const seqPath = getSequencePath(cwd);
+    const seq = readSequence(cwd);
+    const todoData = accessor
+        ? await accessor.loadTaskFile()
+        : await readJson(getTaskPath(cwd));
+    const archiveData = accessor
+        ? await accessor.loadArchive()
+        : await readJson(getArchivePath(cwd));
+    const allTasks = [
+        ...(todoData?.tasks ?? []),
+        ...(archiveData?.archivedTasks ?? []),
+    ];
+    const maxId = getMaxIdFromTasks(allTasks);
+    const oldCounter = seq?.counter ?? 0;
+    if (oldCounter >= maxId) {
+        return { repaired: false, message: 'Sequence already valid', counter: oldCounter, oldCounter, newCounter: oldCounter };
+    }
+    const newCounter = maxId;
+    const newSeq = {
+        counter: newCounter,
+        lastId: `T${newCounter}`,
+        checksum: `repair-${Date.now()}`,
+    };
+    writeFileSync(seqPath, JSON.stringify(newSeq, null, 2));
+    return {
+        repaired: true,
+        counter: newCounter,
+        oldCounter,
+        newCounter,
+        message: `Sequence repaired: ${oldCounter} -> ${newCounter}`,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/sequence/index.js.map

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

package/dist/core/sessions/context-alert.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Context window threshold crossing alerts.
+ *
+ * Detects when context usage crosses warning/caution/critical/emergency
+ * thresholds and emits alerts. Supports suppression and per-command filtering.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Context alert thresholds (percentage of context window). */
+export declare const THRESHOLDS: {
+    readonly WARNING: 70;
+    readonly CAUTION: 85;
+    readonly CRITICAL: 90;
+    readonly EMERGENCY: 95;
+};
+/** Alert level names. */
+export type AlertLevel = 'warning' | 'caution' | 'critical' | 'emergency';
+/** Get the current session ID. */
+export declare function getCurrentSessionId(cwd?: string): string | null;
+/** Get context state file path for a session. */
+export declare function getContextStatePath(sessionId?: string, cwd?: string): string;
+/** Read context state for a session. Returns null if stale or missing. */
+export declare function readContextState(sessionId?: string, cwd?: string): Record<string, unknown> | null;
+/** Determine the threshold level for a given percentage. */
+export declare function getThresholdLevel(percentage: number): AlertLevel | null;
+/**
+ * Determine if we should alert based on threshold crossing.
+ * Returns the alert level if a new threshold was crossed, null otherwise.
+ */
+export declare function shouldAlert(currentPct: number, lastAlertedPct?: number, minThreshold?: AlertLevel): AlertLevel | null;
+/** Alert result from check_context_alert. */
+export interface AlertCheckResult {
+    alerted: boolean;
+    level: AlertLevel | null;
+    percentage: number;
+    currentTokens: number;
+    maxTokens: number;
+    action: string | null;
+}
+/** Get recommended action for an alert level. */
+export declare function getRecommendedAction(percentage: number): string | null;
+/**
+ * Main function to check and determine if an alert should fire.
+ * Non-blocking - always returns a result.
+ */
+export declare function checkContextAlert(currentCommand?: string, cwd?: string): AlertCheckResult;
+//# sourceMappingURL=context-alert.d.ts.map

package/dist/core/sessions/context-alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-alert.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/context-alert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH,+DAA+D;AAC/D,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,yBAAyB;AACzB,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAgB1E,kCAAkC;AAClC,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ/D;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBhC;AAyBD,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAMvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,MAAU,EAC1B,YAAY,GAAE,UAAsB,GACnC,UAAU,GAAG,IAAI,CAcnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,iDAAiD;AACjD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,CAAC,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,MAAM,GACX,gBAAgB,CAoElB"}

package/dist/core/sessions/context-alert.js

@@ -0,0 +1,222 @@
+/**
+ * Context window threshold crossing alerts.
+ *
+ * Detects when context usage crosses warning/caution/critical/emergency
+ * thresholds and emits alerts. Supports suppression and per-command filtering.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCleoDir } from '../paths.js';
+/** Synchronous config value reader (avoids async config pipeline for sync functions). */
+function readConfigValueSync(path, defaultValue, cwd) {
+    try {
+        const configPath = join(getCleoDir(cwd), 'config.json');
+        if (!existsSync(configPath))
+            return defaultValue;
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        const keys = path.split('.');
+        let value = config;
+        for (const key of keys) {
+            if (value == null || typeof value !== 'object')
+                return defaultValue;
+            value = value[key];
+        }
+        return value ?? defaultValue;
+    }
+    catch {
+        return defaultValue;
+    }
+}
+/** Context alert thresholds (percentage of context window). */
+export const THRESHOLDS = {
+    WARNING: 70,
+    CAUTION: 85,
+    CRITICAL: 90,
+    EMERGENCY: 95,
+};
+/** Alert level ordering for comparison. */
+const LEVEL_ORDER = ['warning', 'caution', 'critical', 'emergency'];
+function getAlertStateFile(cwd) {
+    return join(getCleoDir(cwd), '.context-alert-state.json');
+}
+/** Get the current session ID. */
+export function getCurrentSessionId(cwd) {
+    if (process.env.CLEO_SESSION)
+        return process.env.CLEO_SESSION;
+    const sessionFile = join(getCleoDir(cwd), '.current-session');
+    if (existsSync(sessionFile)) {
+        return readFileSync(sessionFile, 'utf-8').trim() || null;
+    }
+    return null;
+}
+/** Get context state file path for a session. */
+export function getContextStatePath(sessionId, cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const sid = sessionId ?? getCurrentSessionId(cwd);
+    if (sid) {
+        const statesDir = join(cleoDir, 'context-states');
+        const sessionFile = join(statesDir, `context-state-${sid}.json`);
+        if (existsSync(sessionFile))
+            return sessionFile;
+    }
+    return join(cleoDir, '.context-state.json');
+}
+/** Read context state for a session. Returns null if stale or missing. */
+export function readContextState(sessionId, cwd) {
+    const statePath = getContextStatePath(sessionId, cwd);
+    if (!existsSync(statePath))
+        return null;
+    try {
+        const state = JSON.parse(readFileSync(statePath, 'utf-8'));
+        const timestamp = state.timestamp;
+        const staleAfterMs = state.staleAfterMs ?? 5000;
+        if (timestamp) {
+            const ageMs = Date.now() - new Date(timestamp).getTime();
+            if (ageMs > staleAfterMs)
+                return null;
+        }
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+/** Read the last alerted state. */
+function readAlertState(cwd) {
+    const file = getAlertStateFile(cwd);
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Update the last alerted state. */
+function updateAlertState(percentage, level, cwd) {
+    const file = getAlertStateFile(cwd);
+    const state = {
+        lastAlertedLevel: percentage,
+        thresholdLevel: level,
+        lastAlertedAt: new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'),
+    };
+    writeFileSync(file, JSON.stringify(state, null, 2));
+}
+/** Determine the threshold level for a given percentage. */
+export function getThresholdLevel(percentage) {
+    if (percentage >= THRESHOLDS.EMERGENCY)
+        return 'emergency';
+    if (percentage >= THRESHOLDS.CRITICAL)
+        return 'critical';
+    if (percentage >= THRESHOLDS.CAUTION)
+        return 'caution';
+    if (percentage >= THRESHOLDS.WARNING)
+        return 'warning';
+    return null;
+}
+/**
+ * Determine if we should alert based on threshold crossing.
+ * Returns the alert level if a new threshold was crossed, null otherwise.
+ */
+export function shouldAlert(currentPct, lastAlertedPct = 0, minThreshold = 'warning') {
+    const currentLevel = getThresholdLevel(currentPct);
+    if (!currentLevel)
+        return null;
+    // Check if current level meets minimum threshold
+    const currentIdx = LEVEL_ORDER.indexOf(currentLevel);
+    const minIdx = LEVEL_ORDER.indexOf(minThreshold);
+    if (currentIdx < minIdx)
+        return null;
+    // Determine last alerted level
+    const lastLevel = getThresholdLevel(lastAlertedPct);
+    if (currentLevel !== lastLevel)
+        return currentLevel;
+    return null;
+}
+/** Get recommended action for an alert level. */
+export function getRecommendedAction(percentage) {
+    if (percentage >= THRESHOLDS.EMERGENCY)
+        return 'IMMEDIATE: ct session end --note "..."';
+    if (percentage >= THRESHOLDS.CRITICAL)
+        return 'Recommended: ct session end --note "..."';
+    if (percentage >= THRESHOLDS.CAUTION)
+        return 'Consider: ct archive; ct session suspend';
+    if (percentage >= THRESHOLDS.WARNING)
+        return 'Monitor: Consider session cleanup soon';
+    return null;
+}
+/**
+ * Main function to check and determine if an alert should fire.
+ * Non-blocking - always returns a result.
+ */
+export function checkContextAlert(currentCommand, cwd) {
+    const noAlert = {
+        alerted: false,
+        level: null,
+        percentage: 0,
+        currentTokens: 0,
+        maxTokens: 0,
+        action: null,
+    };
+    // Check if context alerts are enabled
+    try {
+        const enabled = readConfigValueSync('contextAlerts.enabled', true, cwd);
+        if (!enabled)
+            return noAlert;
+        // Check trigger commands
+        if (currentCommand) {
+            const triggerCommands = readConfigValueSync('contextAlerts.triggerCommands', [], cwd);
+            if (triggerCommands.length > 0 && !triggerCommands.includes(currentCommand)) {
+                return noAlert;
+            }
+        }
+    }
+    catch {
+        // Config not available, continue with defaults
+    }
+    // Check session
+    const sessionId = getCurrentSessionId(cwd);
+    if (!sessionId)
+        return noAlert;
+    // Read context state
+    const contextState = readContextState(sessionId, cwd);
+    if (!contextState)
+        return noAlert;
+    const cw = contextState.contextWindow;
+    const currentPct = cw?.percentage ?? 0;
+    const currentTokens = cw?.currentTokens ?? 0;
+    const maxTokens = cw?.maxTokens ?? 200000;
+    // Check suppress duration
+    const alertState = readAlertState(cwd);
+    const lastAlertedPct = alertState?.lastAlertedLevel ?? 0;
+    try {
+        const suppressDuration = readConfigValueSync('contextAlerts.suppressDuration', 0, cwd);
+        if (suppressDuration > 0 && alertState?.lastAlertedAt) {
+            const ageSeconds = (Date.now() - new Date(alertState.lastAlertedAt).getTime()) / 1000;
+            if (ageSeconds < suppressDuration)
+                return noAlert;
+        }
+    }
+    catch {
+        // Config not available
+    }
+    // Check for threshold crossing
+    const level = shouldAlert(currentPct, lastAlertedPct);
+    if (!level)
+        return noAlert;
+    // Update state
+    updateAlertState(currentPct, level, cwd);
+    return {
+        alerted: true,
+        level,
+        percentage: currentPct,
+        currentTokens,
+        maxTokens,
+        action: getRecommendedAction(currentPct),
+    };
+}
+//# sourceMappingURL=context-alert.js.map

package/dist/core/sessions/context-alert.js.map

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

package/dist/core/sessions/context-monitor.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Context monitor - reads Claude Code context window JSON and writes state.
+ *
+ * Used by the status line integration to track context window usage.
+ * Receives JSON via stdin from Claude Code and writes state files.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Context window input from Claude Code. */
+export interface ContextWindowInput {
+    context_window: {
+        context_window_size?: number;
+        current_usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            cache_creation_input_tokens?: number;
+            cache_read_input_tokens?: number;
+        };
+    };
+}
+/** Context status derived from input. */
+export type ContextStatus = 'ok' | 'warning' | 'caution' | 'critical' | 'emergency';
+/** Determine status from percentage. */
+export declare function getContextStatusFromPercentage(percentage: number): ContextStatus;
+/**
+ * Process context window input and write state file.
+ * Returns the status line string for display.
+ */
+export declare function processContextInput(input: ContextWindowInput, cwd?: string): Promise<string>;
+//# sourceMappingURL=context-monitor.d.ts.map

package/dist/core/sessions/context-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-monitor.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/context-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE;QACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,aAAa,CAAC,EAAE;YACd,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,2BAA2B,CAAC,EAAE,MAAM,CAAC;YACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;SAClC,CAAC;KACH,CAAC;CACH;AAED,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpF,wCAAwC;AACxC,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAMhF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAwDjB"}