@cleocode/core 2026.4.7 → 2026.4.11

package/dist/sessions/assumptions.js

@@ -0,0 +1,54 @@
+/**
+ * Assumption recording for session audit trail.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+import { randomBytes } from 'node:crypto';
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+/**
+ * Record an assumption made during a session.
+ * Appends to .cleo/audit/assumptions.jsonl (creates dir if needed).
+ * Throws if required params are missing or invalid.
+ */
+export async function recordAssumption(projectRoot, params) {
+    if (!params?.assumption) {
+        throw new CleoError(ExitCode.INVALID_INPUT, 'assumption is required');
+    }
+    if (!params?.confidence || !['high', 'medium', 'low'].includes(params.confidence)) {
+        throw new CleoError(ExitCode.INVALID_INPUT, 'confidence must be one of: high, medium, low');
+    }
+    const accessor = await getAccessor(projectRoot);
+    const activeSession = await accessor.getActiveSession();
+    const sessionId = params.sessionId || activeSession?.id || 'default';
+    const id = `asm-${randomBytes(8).toString('hex')}`;
+    const now = new Date().toISOString();
+    const record = {
+        id,
+        sessionId,
+        taskId: params.taskId || null,
+        assumption: params.assumption,
+        confidence: params.confidence,
+        validatedAt: null,
+        timestamp: now,
+    };
+    const auditDir = join(projectRoot, '.cleo', 'audit');
+    if (!existsSync(auditDir)) {
+        mkdirSync(auditDir, { recursive: true });
+    }
+    const assumptionsPath = join(auditDir, 'assumptions.jsonl');
+    appendFileSync(assumptionsPath, JSON.stringify(record) + '\n', 'utf-8');
+    return {
+        id,
+        sessionId,
+        taskId: params.taskId || null,
+        assumption: params.assumption,
+        confidence: params.confidence,
+        timestamp: now,
+    };
+}
+//# sourceMappingURL=assumptions.js.map

package/dist/sessions/assumptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assumptions.js","sourceRoot":"","sources":["../../src/sessions/assumptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAUxD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,MAA8B;IAE9B,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,UAAU,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,8CAA8C,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,gBAAgB,EAAE,CAAC;IAExD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,aAAa,EAAE,EAAE,IAAI,SAAS,CAAC;IACrE,MAAM,EAAE,GAAG,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,MAAM,GAAqB;QAC/B,EAAE;QACF,SAAS;QACT,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAC5D,cAAc,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAExE,OAAO;QACL,EAAE;QACF,SAAS;QACT,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC"}

package/dist/sessions/briefing.js

@@ -0,0 +1,377 @@
+/**
+ * Session briefing computation.
+ *
+ * Aggregates session-start context from multiple sources for quick agent
+ * orientation. This is the READ side of the handoff/briefing pair.
+ *
+ * Data sources:
+ * - Last session handoff (session.handoff)
+ * - Current focus (tasks.current)
+ * - Top-N next tasks (tasks.next leverage-scored)
+ * - Open bugs (tasks with origin:bug-report or label:bug)
+ * - Blocked tasks (tasks.blockers)
+ * - Active epics status (tasks.tree filtered)
+ * - Pipeline stage data (from T4912)
+ *
+ * @task T4916
+ * @epic T4914
+ */
+import { getAccessor } from '../store/data-accessor.js';
+import { depsReady } from '../tasks/deps-ready.js';
+import { getLastHandoff } from './handoff.js';
+const PRIORITY_SCORE = {
+    critical: 100,
+    high: 75,
+    medium: 50,
+    low: 25,
+};
+/**
+ * Compute the complete session briefing.
+ * Aggregates data from all 6+ sources.
+ */
+export async function computeBriefing(projectRoot, options = {}) {
+    const accessor = await getAccessor(projectRoot);
+    const { tasks } = await accessor.queryTasks({});
+    const focus = (await accessor.getMetaValue('focus_state'));
+    // Build task map for quick lookups
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    // Determine scope
+    const scopeFilter = await parseScope(options.scope, accessor);
+    // Compute in-scope task IDs (undefined = all tasks in scope)
+    const scopeTaskIds = getScopeTaskIdSet(scopeFilter, tasks);
+    // 1. Last session handoff
+    const lastSession = await computeLastSession(projectRoot, scopeFilter);
+    // 2. Current active task
+    const currentTaskInfo = computeCurrentTask(focus, taskMap);
+    // 3. Next tasks (leverage-scored)
+    const nextTasks = computeNextTasks(tasks, taskMap, focus, {
+        maxTasks: options.maxNextTasks ?? 5,
+        scopeTaskIds,
+    });
+    // 4. Open bugs
+    const openBugs = computeOpenBugs(tasks, taskMap, {
+        maxBugs: options.maxBugs ?? 10,
+        scopeTaskIds,
+    });
+    // 5. Blocked tasks
+    const blockedTasks = computeBlockedTasks(tasks, taskMap, {
+        maxBlocked: options.maxBlocked ?? 10,
+        scopeTaskIds,
+    });
+    // 6. Active epics
+    const activeEpics = computeActiveEpics(tasks, taskMap, {
+        maxEpics: options.maxEpics ?? 5,
+        scopeTaskIds,
+    });
+    // 7. Pipeline stage (optional - may not be available)
+    const pipelineStage = await computePipelineStage(focus);
+    // 8. Brain memory context (optional, best-effort)
+    let memoryContext;
+    try {
+        const { getSessionMemoryContext } = await import('../memory/session-memory.js');
+        memoryContext = await getSessionMemoryContext(projectRoot, scopeFilter);
+    }
+    catch {
+        // Brain memory not available -- proceed without
+    }
+    // Compute warnings
+    const warnings = [];
+    if (currentTaskInfo?.blockedBy?.length) {
+        warnings.push(`Focused task ${currentTaskInfo.id} is blocked by: ${currentTaskInfo.blockedBy.join(', ')}`);
+    }
+    return {
+        lastSession,
+        currentTask: currentTaskInfo,
+        nextTasks,
+        openBugs,
+        blockedTasks,
+        activeEpics,
+        ...(pipelineStage && { pipelineStage }),
+        ...(warnings.length > 0 && { warnings }),
+        ...(memoryContext && { memoryContext }),
+    };
+}
+/**
+ * Parse scope string into filter config.
+ * Uses getActiveSession() to auto-detect scope when no explicit scope is provided.
+ */
+async function parseScope(scopeStr, accessor) {
+    if (!scopeStr) {
+        // Auto-detect from active session
+        const activeSession = await accessor.getActiveSession();
+        if (activeSession?.scope?.type === 'epic') {
+            return { type: 'epic', epicId: activeSession.scope.rootTaskId };
+        }
+        if (activeSession?.scope?.type === 'global') {
+            return { type: 'global' };
+        }
+        return undefined;
+    }
+    if (scopeStr === 'global') {
+        return { type: 'global' };
+    }
+    const match = scopeStr.match(/^epic:(T\d+)$/);
+    if (match) {
+        return { type: 'epic', epicId: match[1] };
+    }
+    return undefined;
+}
+/**
+ * Compute the set of in-scope task IDs for briefing filtering.
+ * Returns undefined for global/unscoped (meaning all tasks are in scope).
+ */
+function getScopeTaskIdSet(scopeFilter, tasks) {
+    if (!scopeFilter || scopeFilter.type === 'global') {
+        return undefined; // All tasks in scope
+    }
+    const rootId = scopeFilter.epicId;
+    if (!rootId)
+        return undefined;
+    const taskIds = new Set();
+    const addDescendants = (taskId) => {
+        taskIds.add(taskId);
+        for (const t of tasks) {
+            if (t.parentId === taskId) {
+                addDescendants(t.id);
+            }
+        }
+    };
+    addDescendants(rootId);
+    return taskIds;
+}
+/**
+ * Compute last session info with handoff data.
+ */
+async function computeLastSession(projectRoot, scopeFilter) {
+    try {
+        const scope = scopeFilter ? { type: scopeFilter.type, epicId: scopeFilter.epicId } : undefined;
+        const handoffResult = await getLastHandoff(projectRoot, scope);
+        if (!handoffResult)
+            return null;
+        const { sessionId, handoff } = handoffResult;
+        // Load sessions to get endedAt
+        const accessor = await getAccessor(projectRoot);
+        const allSessions = await accessor.loadSessions();
+        const session = allSessions.find((s) => s.id === sessionId);
+        if (!session || !session.endedAt)
+            return null;
+        // Calculate duration if startedAt is available
+        let duration = 0;
+        if (session.startedAt) {
+            duration = Math.round((new Date(session.endedAt).getTime() - new Date(session.startedAt).getTime()) / 60000);
+        }
+        return {
+            endedAt: session.endedAt,
+            duration,
+            handoff,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Compute current active task from task file.
+ */
+function computeCurrentTask(focus, taskMap) {
+    const focusTaskId = focus?.currentTask;
+    if (!focusTaskId)
+        return null;
+    const task = taskMap.get(focusTaskId);
+    if (!task)
+        return null;
+    const info = {
+        id: task.id,
+        title: task.title,
+        status: task.status,
+    };
+    // Check for unresolved dependencies on the focused task
+    if (task.depends?.length) {
+        const unresolved = task.depends.filter((depId) => {
+            const dep = taskMap.get(depId);
+            return dep && dep.status !== 'done' && dep.status !== 'cancelled';
+        });
+        if (unresolved.length > 0) {
+            info.blockedBy = unresolved;
+        }
+    }
+    return info;
+}
+/**
+ * Compute leverage for a task.
+ */
+function calculateLeverage(taskId, taskMap) {
+    let leverage = 0;
+    for (const task of taskMap.values()) {
+        const t = task;
+        if (t.depends?.includes(taskId)) {
+            leverage++;
+        }
+    }
+    return leverage;
+}
+/**
+ * Compute next tasks sorted by leverage and score.
+ */
+function computeNextTasks(tasks, taskMap, focus, options) {
+    const pendingTasks = tasks.filter((t) => {
+        const task = t;
+        return (task.status === 'pending' && (!options.scopeTaskIds || options.scopeTaskIds.has(task.id)));
+    });
+    const scored = [];
+    const currentPhase = focus?.currentPhase;
+    for (const task of pendingTasks) {
+        const t = task;
+        if (!depsReady(t.depends, taskMap))
+            continue;
+        const leverage = calculateLeverage(t.id, taskMap);
+        let score = PRIORITY_SCORE[t.priority || 'medium'] ?? 50;
+        // Phase alignment bonus
+        if (currentPhase && t.phase === currentPhase) {
+            score += 20;
+        }
+        // Dependencies satisfied bonus
+        if (t.depends && t.depends.length > 0) {
+            score += 10;
+        }
+        // Age bonus
+        if (t.createdAt) {
+            const ageMs = Date.now() - new Date(t.createdAt).getTime();
+            const ageDays = ageMs / (1000 * 60 * 60 * 24);
+            if (ageDays > 7) {
+                score += Math.min(15, Math.floor(ageDays / 7));
+            }
+        }
+        // Leverage bonus
+        if (leverage > 0) {
+            score += leverage * 5;
+        }
+        scored.push({ id: t.id, title: t.title, leverage, score });
+    }
+    // Sort by score descending
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, options.maxTasks);
+}
+/**
+ * Compute open bugs.
+ */
+function computeOpenBugs(tasks, _taskMap, options) {
+    const bugs = [];
+    for (const task of tasks) {
+        const t = task;
+        const isBug = t.origin === 'bug-report' || t.labels?.includes('bug');
+        const isOpen = t.status !== 'done' && t.status !== 'cancelled';
+        if (isBug && isOpen && (!options.scopeTaskIds || options.scopeTaskIds.has(t.id))) {
+            bugs.push({
+                id: t.id,
+                title: t.title,
+                priority: t.priority || 'medium',
+            });
+        }
+    }
+    // Sort by priority
+    const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+    bugs.sort((a, b) => (priorityOrder[a.priority] ?? 99) - (priorityOrder[b.priority] ?? 99));
+    return bugs.slice(0, options.maxBugs);
+}
+/**
+ * Compute blocked tasks.
+ */
+function computeBlockedTasks(tasks, taskMap, options) {
+    const blocked = [];
+    for (const task of tasks) {
+        const t = task;
+        if (options.scopeTaskIds && !options.scopeTaskIds.has(t.id))
+            continue;
+        const blockedBy = [];
+        // Check blocked status
+        if (t.status === 'blocked' && t.blockedBy) {
+            blockedBy.push(t.blockedBy);
+        }
+        // Check unresolved dependencies
+        if (t.depends && t.depends.length > 0) {
+            for (const depId of t.depends) {
+                const dep = taskMap.get(depId);
+                if (dep && dep.status !== 'done' && dep.status !== 'cancelled') {
+                    if (!blockedBy.includes(depId)) {
+                        blockedBy.push(depId);
+                    }
+                }
+            }
+        }
+        if (blockedBy.length > 0) {
+            blocked.push({
+                id: t.id,
+                title: t.title,
+                blockedBy,
+            });
+        }
+    }
+    return blocked.slice(0, options.maxBlocked);
+}
+/**
+ * Compute active epics.
+ */
+function computeActiveEpics(tasks, taskMap, options) {
+    const epics = [];
+    for (const task of tasks) {
+        const t = task;
+        if (options.scopeTaskIds && !options.scopeTaskIds.has(t.id))
+            continue;
+        if (t.type === 'epic' && t.status === 'active') {
+            const completionPercent = calculateEpicCompletion(t.id, taskMap);
+            epics.push({
+                id: t.id,
+                title: t.title,
+                completionPercent,
+            });
+        }
+    }
+    // Sort by completion (ascending - less complete first)
+    epics.sort((a, b) => a.completionPercent - b.completionPercent);
+    return epics.slice(0, options.maxEpics);
+}
+/**
+ * Calculate completion percentage for an epic.
+ */
+function calculateEpicCompletion(epicId, taskMap) {
+    let totalTasks = 0;
+    let completedTasks = 0;
+    // Collect all descendant tasks
+    const collectTasks = (parentId) => {
+        for (const task of taskMap.values()) {
+            const t = task;
+            if (t.parentId === parentId) {
+                totalTasks++;
+                if (t.status === 'done' || t.status === 'cancelled') {
+                    completedTasks++;
+                }
+                collectTasks(t.id);
+            }
+        }
+    };
+    collectTasks(epicId);
+    return totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+}
+/**
+ * Compute pipeline stage info from task file metadata.
+ */
+async function computePipelineStage(focus) {
+    const taskId = focus?.currentTask;
+    if (!taskId)
+        return undefined;
+    try {
+        const { getPipeline } = await import('../lifecycle/pipeline.js');
+        const pipeline = await getPipeline(taskId);
+        if (!pipeline)
+            return undefined;
+        return {
+            currentStage: pipeline.currentStage,
+            stageStatus: pipeline.isActive ? 'active' : (pipeline.status ?? 'completed'),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=briefing.js.map

package/dist/sessions/briefing.js.map

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

package/dist/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