@cleocode/cleo 2026.2.5

package/dist/core/skills/validation.js.map

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

package/dist/core/skills/version.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Skills version tracking.
+ *
+ * CAAMP's skills-lock is the PRIMARY source of truth for skill versions.
+ * CLEO's local installed-skills.json is kept as a synchronous cache
+ * and fallback for when CAAMP's async lock file is unavailable.
+ *
+ * Write operations record to BOTH CAAMP lock and CLEO local tracking.
+ * Read operations check CAAMP lock first, CLEO local second.
+ *
+ * @epic T4454
+ * @task T4521
+ * @task T4680
+ */
+import type { InstalledSkillsFile } from './types.js';
+/**
+ * Read the installed skills file (CLEO local cache).
+ * @task T4521
+ */
+export declare function readInstalledSkills(): InstalledSkillsFile;
+/**
+ * Save the installed skills file (CLEO local cache).
+ * @task T4521
+ */
+export declare function saveInstalledSkills(data: InstalledSkillsFile): void;
+/**
+ * Initialize the installed skills file if it doesn't exist.
+ * @task T4521
+ */
+export declare function initInstalledSkills(): InstalledSkillsFile;
+/**
+ * Record a skill version after installation.
+ * Writes to BOTH CAAMP lock (primary) and CLEO local cache (fallback).
+ *
+ * @task T4521
+ * @task T4680
+ */
+export declare function recordSkillVersion(name: string, version: string, sourcePath: string, symlinkPath: string): void;
+/**
+ * Get the installed version of a skill from CLEO's local cache.
+ * Synchronous fallback - prefer getInstalledVersionAsync() for accurate results.
+ * @task T4521
+ */
+export declare function getInstalledVersion(name: string): string | null;
+/**
+ * Get the installed version of a skill.
+ * Checks CAAMP's lock file first (primary), falls back to CLEO local cache.
+ *
+ * @task T4521
+ * @task T4680
+ */
+export declare function getInstalledVersionAsync(name: string): Promise<string | null>;
+/**
+ * Check for skill updates using CAAMP's lock-based update checker.
+ * Falls back to manifest comparison if CAAMP check is unavailable.
+ *
+ * @task T4521
+ * @task T4680
+ */
+export declare function checkSkillUpdates(cwd?: string): Array<{
+    name: string;
+    installedVersion: string;
+    availableVersion: string;
+    needsUpdate: boolean;
+}>;
+/**
+ * Check if a single skill needs an update via CAAMP's lock-based checker.
+ * Async because it reads the CAAMP lock file.
+ *
+ * @task T4680
+ */
+export declare function checkSkillUpdateAsync(name: string): Promise<{
+    needsUpdate: boolean;
+    currentVersion?: string;
+    latestVersion?: string;
+}>;
+/**
+ * Apply skill updates (record new versions).
+ * @task T4521
+ */
+export declare function applySkillUpdates(updates: Array<{
+    name: string;
+    version: string;
+    sourcePath: string;
+    symlinkPath: string;
+}>): number;
+//# sourceMappingURL=version.d.ts.map

package/dist/core/skills/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/core/skills/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAyBtD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CAkBzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAUnE;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CAMzD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,IAAI,CA4BN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/D;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAenF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC,CAqCD;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,CAaD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GACzF,MAAM,CASR"}

package/dist/core/skills/version.js

@@ -0,0 +1,241 @@
+/**
+ * Skills version tracking.
+ *
+ * CAAMP's skills-lock is the PRIMARY source of truth for skill versions.
+ * CLEO's local installed-skills.json is kept as a synchronous cache
+ * and fallback for when CAAMP's async lock file is unavailable.
+ *
+ * Write operations record to BOTH CAAMP lock and CLEO local tracking.
+ * Read operations check CAAMP lock first, CLEO local second.
+ *
+ * @epic T4454
+ * @task T4521
+ * @task T4680
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { getTrackedSkills as caampGetTrackedSkills, recordSkillInstall as caampRecordSkillInstall, checkSkillUpdate as caampCheckSkillUpdate, } from '@cleocode/caamp';
+import { getCleoHome, getProjectRoot } from '../paths.js';
+// ============================================================================
+// Paths
+// ============================================================================
+/**
+ * Get the installed skills tracking file path (CLEO local cache).
+ */
+function getInstalledSkillsPath() {
+    return join(getCleoHome(), 'installed-skills.json');
+}
+/**
+ * Get the source manifest.json path (from the CLEO repo).
+ */
+function getSourceManifestPath(cwd) {
+    const root = process.env['CLEO_ROOT'] ?? getProjectRoot(cwd);
+    return join(root, 'skills', 'manifest.json');
+}
+// ============================================================================
+// CLEO Local Cache Operations
+// ============================================================================
+/**
+ * Read the installed skills file (CLEO local cache).
+ * @task T4521
+ */
+export function readInstalledSkills() {
+    const path = getInstalledSkillsPath();
+    if (existsSync(path)) {
+        try {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            // Corrupt file, return empty
+        }
+    }
+    return {
+        _meta: {
+            version: '1.0.0',
+            lastUpdated: new Date().toISOString(),
+        },
+        skills: {},
+    };
+}
+/**
+ * Save the installed skills file (CLEO local cache).
+ * @task T4521
+ */
+export function saveInstalledSkills(data) {
+    const path = getInstalledSkillsPath();
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    data._meta.lastUpdated = new Date().toISOString();
+    writeFileSync(path, JSON.stringify(data, null, 2), 'utf-8');
+}
+// ============================================================================
+// Version Tracking (CAAMP primary, CLEO local fallback)
+// ============================================================================
+/**
+ * Initialize the installed skills file if it doesn't exist.
+ * @task T4521
+ */
+export function initInstalledSkills() {
+    const existing = readInstalledSkills();
+    if (Object.keys(existing.skills).length === 0) {
+        saveInstalledSkills(existing);
+    }
+    return existing;
+}
+/**
+ * Record a skill version after installation.
+ * Writes to BOTH CAAMP lock (primary) and CLEO local cache (fallback).
+ *
+ * @task T4521
+ * @task T4680
+ */
+export function recordSkillVersion(name, version, sourcePath, symlinkPath) {
+    // Write to CLEO local cache (synchronous, always succeeds)
+    const data = readInstalledSkills();
+    data.skills[name] = {
+        name,
+        version,
+        installedAt: new Date().toISOString(),
+        sourcePath,
+        symlinkPath,
+    };
+    saveInstalledSkills(data);
+    // Write to CAAMP lock (async, best-effort)
+    // Fire-and-forget: CAAMP lock is the primary source but we don't
+    // block synchronous callers. Next async read will pick it up.
+    caampRecordSkillInstall(name, name, // scopedName
+    sourcePath, // source
+    'local', // sourceType
+    [], // agents (populated by CAAMP during actual install)
+    symlinkPath, // canonicalPath
+    true, // isGlobal
+    undefined, // projectDir
+    version).catch(() => {
+        // CAAMP lock write failed - CLEO local cache is the fallback
+    });
+}
+/**
+ * Get the installed version of a skill from CLEO's local cache.
+ * Synchronous fallback - prefer getInstalledVersionAsync() for accurate results.
+ * @task T4521
+ */
+export function getInstalledVersion(name) {
+    const data = readInstalledSkills();
+    return data.skills[name]?.version ?? null;
+}
+/**
+ * Get the installed version of a skill.
+ * Checks CAAMP's lock file first (primary), falls back to CLEO local cache.
+ *
+ * @task T4521
+ * @task T4680
+ */
+export async function getInstalledVersionAsync(name) {
+    // Check CAAMP's lock file first (primary source of truth)
+    try {
+        const tracked = await caampGetTrackedSkills();
+        const entry = tracked[name];
+        if (entry?.version)
+            return entry.version;
+    }
+    catch {
+        // CAAMP lock file not available, fall through to local cache
+    }
+    // Fallback: check CLEO's local tracking
+    const localVersion = getInstalledVersion(name);
+    if (localVersion)
+        return localVersion;
+    return null;
+}
+/**
+ * Check for skill updates using CAAMP's lock-based update checker.
+ * Falls back to manifest comparison if CAAMP check is unavailable.
+ *
+ * @task T4521
+ * @task T4680
+ */
+export function checkSkillUpdates(cwd) {
+    const manifestPath = getSourceManifestPath(cwd);
+    if (!existsSync(manifestPath))
+        return [];
+    let manifest;
+    try {
+        const data = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+        manifest = data.skills ?? [];
+    }
+    catch {
+        return [];
+    }
+    const installed = readInstalledSkills();
+    const updates = [];
+    for (const skill of manifest) {
+        const name = skill.dirName ?? skill.name ?? '';
+        if (!name)
+            continue;
+        const available = skill.version ?? '0.0.0';
+        const current = installed.skills[name]?.version ?? '0.0.0';
+        const needsUpdate = compareVersions(available, current) > 0;
+        updates.push({
+            name,
+            installedVersion: current,
+            availableVersion: available,
+            needsUpdate,
+        });
+    }
+    return updates;
+}
+/**
+ * Check if a single skill needs an update via CAAMP's lock-based checker.
+ * Async because it reads the CAAMP lock file.
+ *
+ * @task T4680
+ */
+export async function checkSkillUpdateAsync(name) {
+    try {
+        const result = await caampCheckSkillUpdate(name);
+        return {
+            needsUpdate: result.hasUpdate,
+            currentVersion: result.currentVersion,
+            latestVersion: result.latestVersion,
+        };
+    }
+    catch {
+        // CAAMP check unavailable, fall back to local
+        const local = getInstalledVersion(name);
+        return { needsUpdate: false, currentVersion: local ?? undefined };
+    }
+}
+/**
+ * Apply skill updates (record new versions).
+ * @task T4521
+ */
+export function applySkillUpdates(updates) {
+    let applied = 0;
+    for (const update of updates) {
+        recordSkillVersion(update.name, update.version, update.sourcePath, update.symlinkPath);
+        applied++;
+    }
+    return applied;
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Compare two version strings (X.Y.Z format, works for both semver and CalVer).
+ * Returns: positive if a > b, negative if a < b, 0 if equal.
+ */
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        if (va !== vb)
+            return va - vb;
+    }
+    return 0;
+}
+//# sourceMappingURL=version.js.map

package/dist/core/skills/version.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * Statistics and analytics core module.
+ * @task T4535
+ * @epic T4454
+ */
+import type { DataAccessor } from '../../store/data-accessor.js';
+/** Get project statistics. */
+export declare function getProjectStats(opts: {
+    period?: string;
+    verbose?: boolean;
+    cwd?: string;
+}, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+/** Get project dashboard data. */
+export declare function getDashboard(opts: {
+    compact?: boolean;
+    period?: number;
+    showCharts?: boolean;
+    sections?: string[];
+    verbose?: boolean;
+    quiet?: boolean;
+    cwd?: string;
+}, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+/** Get completion history data. */
+export declare function getCompletionHistory(opts: {
+    days?: number;
+    since?: string;
+    until?: string;
+    cwd?: string;
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/stats/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAoBjE,8BAA8B;AAC9B,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8D5D;AAED,kCAAkC;AAClC,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmD5D;AAED,mCAAmC;AACnC,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuCnC"}

package/dist/core/stats/index.js

@@ -0,0 +1,152 @@
+/**
+ * Statistics and analytics core module.
+ * @task T4535
+ * @epic T4454
+ */
+import { readJson, readLogEntries } from '../../store/json.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getTodoPath, getLogPath } from '../paths.js';
+/** 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 (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 data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJson(getTodoPath(opts.cwd));
+    if (!data) {
+        throw new CleoError(ExitCode.CONFIG_ERROR, 'Not in a CLEO project. Run cleo init first.');
+    }
+    const tasks = data.tasks ?? [];
+    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 totalActive = tasks.length;
+    const cutoff = new Date(Date.now() - periodDays * 86400000).toISOString();
+    // Read log for period metrics (handles hybrid JSON/JSONL format)
+    const entries = await readLogEntries(getLogPath(opts.cwd));
+    // Match both legacy (action: "task_created") and status_changed entries
+    const isCreate = (e) => e.action === 'task_created';
+    const isComplete = (e) => e.action === 'task_completed' ||
+        (e.action === 'status_changed' && e.after?.status === 'done');
+    const isArchive = (e) => e.action === 'task_archived';
+    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 log
+    const totalCreated = entries.filter(isCreate).length;
+    const totalCompleted = entries.filter(isComplete).length;
+    const totalArchived = entries.filter(isArchive).length;
+    return {
+        currentState: { pending, active, done, blocked, totalActive },
+        completionMetrics: {
+            periodDays,
+            completedInPeriod,
+            createdInPeriod,
+            completionRate,
+        },
+        activityMetrics: {
+            createdInPeriod,
+            completedInPeriod,
+            archivedInPeriod,
+        },
+        allTime: { totalCreated, totalCompleted, totalArchived },
+    };
+}
+/** Get project dashboard data. */
+export async function getDashboard(opts, accessor) {
+    const data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJson(getTodoPath(opts.cwd));
+    if (!data) {
+        throw new CleoError(ExitCode.CONFIG_ERROR, 'Not in a CLEO project. Run cleo init first.');
+    }
+    const tasks = data.tasks ?? [];
+    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 total = tasks.length;
+    const project = data.project?.name ?? 'Unknown Project';
+    const currentPhase = data.project?.currentPhase ?? null;
+    const focusId = data.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');
+    const blockedTasks = tasks.filter(t => t.status === 'blocked');
+    // Label aggregation
+    const labelMap = {};
+    for (const t of tasks) {
+        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, total },
+        focus: { currentTask: focusId, task: focusTask },
+        highPriority: { count: highPriority.length, tasks: highPriority.slice(0, 5) },
+        blockedTasks: { count: blockedTasks.length, tasks: blockedTasks },
+        topLabels,
+        periodDays: opts.period ?? 7,
+    };
+}
+/** Get completion history data. */
+export async function getCompletionHistory(opts) {
+    const allEntries = await readLogEntries(getLogPath(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 === 'status_changed' && e.after?.status === '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/core/stats/index.js.map

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

package/dist/core/task-work/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Task work management operations (start/stop/current).
+ * @task T4462
+ * @task T4750
+ * @epic T4454
+ */
+import type { DataAccessor } from '../../store/data-accessor.js';
+/** Result of getting current task. */
+export interface TaskCurrentResult {
+    currentTask: string | null;
+    currentPhase: string | null;
+    sessionNote: string | null;
+    nextAction: string | null;
+}
+/** Result of starting work on a task. */
+export interface TaskStartResult {
+    taskId: string;
+    taskTitle: string;
+    previousTask: string | null;
+}
+/** Task work history entry. */
+export interface TaskWorkHistoryEntry {
+    taskId: string;
+    timestamp: string;
+}
+/**
+ * Show current task work state.
+ * @task T4462
+ * @task T4750
+ */
+export declare function currentTask(cwd?: string, accessor?: DataAccessor): Promise<TaskCurrentResult>;
+/**
+ * Start working on a specific task.
+ * @task T4462
+ * @task T4750
+ */
+export declare function startTask(taskId: string, cwd?: string, accessor?: DataAccessor): Promise<TaskStartResult>;
+/**
+ * Stop working on the current task.
+ * @task T4462
+ * @task T4750
+ */
+export declare function stopTask(cwd?: string, accessor?: DataAccessor): Promise<{
+    previousTask: string | null;
+}>;
+/**
+ * Get task work history from session notes.
+ * @task T4462
+ * @task T4750
+ */
+export declare function getWorkHistory(cwd?: string, accessor?: DataAccessor): Promise<TaskWorkHistoryEntry[]>;
+/** @deprecated Use TaskCurrentResult instead. */
+export type FocusShowResult = TaskCurrentResult;
+/** @deprecated Use TaskStartResult instead. */
+export type FocusSetResult = TaskStartResult;
+/** @deprecated Use TaskWorkHistoryEntry instead. */
+export type FocusHistoryEntry = TaskWorkHistoryEntry;
+/** @deprecated Use currentTask() instead. */
+export declare const showFocus: typeof currentTask;
+/** @deprecated Use startTask() instead. */
+export declare const setFocus: typeof startTask;
+/** @deprecated Use stopTask() instead. */
+export declare const clearFocus: typeof stopTask;
+/** @deprecated Use getWorkHistory() instead. */
+export declare const getFocusHistory: typeof getWorkHistory;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/task-work/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/task-work/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,+BAA+B;AAC/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAanG;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA+D/G;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAiC9G;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoB3G;AAID,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAChD,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAC7C,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAErD,6CAA6C;AAC7C,eAAO,MAAM,SAAS,oBAAc,CAAC;AACrC,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,kBAAY,CAAC;AAClC,0CAA0C;AAC1C,eAAO,MAAM,UAAU,iBAAW,CAAC;AACnC,gDAAgD;AAChD,eAAO,MAAM,eAAe,uBAAiB,CAAC"}