@cleocode/cleo 2026.2.5

package/dist/core/sessions/index.js

@@ -0,0 +1,244 @@
+/**
+ * Session management operations.
+ * @task T4463
+ * @epic T4454
+ */
+import { randomBytes } from 'node:crypto';
+import { readJson, saveJson } from '../../store/json.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getSessionsPath, getBackupDir } from '../paths.js';
+/**
+ * Parse a scope string into a SessionScope.
+ * @task T4463
+ */
+export function parseScope(scopeStr) {
+    if (scopeStr === 'global') {
+        return { type: 'global' };
+    }
+    const match = scopeStr.match(/^epic:(T\d+)$/);
+    if (match) {
+        return { type: 'epic', epicId: match[1] };
+    }
+    throw new CleoError(ExitCode.SCOPE_INVALID, `Invalid scope format: ${scopeStr}. Use 'epic:T###' or 'global'.`);
+}
+/**
+ * Generate a session ID.
+ * @task T4463
+ */
+function generateSessionId() {
+    return `session-${Date.now()}-${randomBytes(3).toString('hex')}`;
+}
+/**
+ * Read or create sessions file.
+ * @task T4463
+ */
+async function readSessions(cwd, accessor) {
+    if (accessor) {
+        const data = await accessor.loadSessions();
+        if (data && data.sessions)
+            return data;
+        return {
+            version: '1.0.0',
+            sessions: [],
+            _meta: {
+                schemaVersion: '1.0.0',
+                lastUpdated: new Date().toISOString(),
+            },
+        };
+    }
+    const sessionsPath = getSessionsPath(cwd);
+    const data = await readJson(sessionsPath);
+    if (data)
+        return data;
+    return {
+        version: '1.0.0',
+        sessions: [],
+        _meta: {
+            schemaVersion: '1.0.0',
+            lastUpdated: new Date().toISOString(),
+        },
+    };
+}
+/**
+ * Save sessions file.
+ * @task T4463
+ */
+async function saveSessions(data, cwd, accessor) {
+    data._meta.lastUpdated = new Date().toISOString();
+    if (accessor) {
+        await accessor.saveSessions(data);
+        return;
+    }
+    const sessionsPath = getSessionsPath(cwd);
+    const backupDir = getBackupDir(cwd);
+    await saveJson(sessionsPath, data, { backupDir });
+}
+/**
+ * Start a new session.
+ * @task T4463
+ */
+export async function startSession(options, cwd, accessor) {
+    const scope = parseScope(options.scope);
+    const data = await readSessions(cwd, accessor);
+    // Check for conflicting active sessions
+    const activeSessions = data.sessions.filter(s => s.status === 'active');
+    for (const active of activeSessions) {
+        if (active.scope.type === scope.type &&
+            active.scope.epicId === scope.epicId) {
+            throw new CleoError(ExitCode.SCOPE_CONFLICT, `Active session already exists for scope ${options.scope}: ${active.id}`, {
+                fix: `Resume with 'cleo session resume ${active.id}' or end it first`,
+                alternatives: [
+                    { action: 'Resume existing', command: `cleo session resume ${active.id}` },
+                    { action: 'End existing', command: `cleo session end` },
+                ],
+            });
+        }
+    }
+    const session = {
+        id: generateSessionId(),
+        name: options.name,
+        status: 'active',
+        scope,
+        taskWork: {
+            taskId: options.startTask ?? null,
+            setAt: options.startTask ? new Date().toISOString() : null,
+        },
+        focus: {
+            taskId: options.startTask ?? null,
+            setAt: options.startTask ? new Date().toISOString() : null,
+        },
+        startedAt: new Date().toISOString(),
+        agent: options.agent ?? null,
+        notes: [],
+        tasksCompleted: [],
+        tasksCreated: [],
+    };
+    data.sessions.push(session);
+    await saveSessions(data, cwd, accessor);
+    return session;
+}
+/**
+ * End a session.
+ * @task T4463
+ */
+export async function endSession(options = {}, cwd, accessor) {
+    const data = await readSessions(cwd, accessor);
+    let session;
+    if (options.sessionId) {
+        session = data.sessions.find(s => s.id === options.sessionId);
+    }
+    else {
+        // Find most recent active session
+        session = data.sessions
+            .filter(s => s.status === 'active')
+            .sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime())[0];
+    }
+    if (!session) {
+        throw new CleoError(ExitCode.SESSION_NOT_FOUND, options.sessionId
+            ? `Session not found: ${options.sessionId}`
+            : 'No active session found', { fix: "Use 'cleo session list' to see available sessions" });
+    }
+    if (session.status !== 'active') {
+        throw new CleoError(ExitCode.SESSION_NOT_FOUND, `Session ${session.id} is already ${session.status}`);
+    }
+    session.status = 'ended';
+    session.endedAt = new Date().toISOString();
+    if (options.note) {
+        if (!session.notes)
+            session.notes = [];
+        session.notes.push(options.note);
+    }
+    await saveSessions(data, cwd, accessor);
+    return session;
+}
+/**
+ * Get current session status.
+ * @task T4463
+ */
+export async function sessionStatus(cwd, accessor) {
+    const data = await readSessions(cwd, accessor);
+    const active = data.sessions
+        .filter(s => s.status === 'active')
+        .sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime())[0];
+    return active ?? null;
+}
+/**
+ * Resume an existing session.
+ * @task T4463
+ */
+export async function resumeSession(sessionId, cwd, accessor) {
+    const data = await readSessions(cwd, accessor);
+    const session = data.sessions.find(s => s.id === sessionId);
+    if (!session) {
+        throw new CleoError(ExitCode.SESSION_NOT_FOUND, `Session not found: ${sessionId}`, { fix: "Use 'cleo session list' to see available sessions" });
+    }
+    if (session.status === 'active') {
+        return session; // Already active
+    }
+    if (session.status === 'orphaned' || session.status === 'ended') {
+        session.status = 'active';
+        session.endedAt = null;
+        if (!session.notes)
+            session.notes = [];
+        session.notes.push(`Resumed at ${new Date().toISOString()}`);
+        await saveSessions(data, cwd, accessor);
+    }
+    return session;
+}
+/**
+ * List sessions with optional filtering.
+ * @task T4463
+ */
+export async function listSessions(options = {}, cwd, accessor) {
+    const data = await readSessions(cwd, accessor);
+    let sessions = data.sessions;
+    if (options.status) {
+        sessions = sessions.filter(s => s.status === options.status);
+    }
+    // Sort by start time, most recent first
+    sessions.sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime());
+    if (options.limit) {
+        sessions = sessions.slice(0, options.limit);
+    }
+    return sessions;
+}
+/**
+ * Garbage collect old sessions.
+ * Marks orphaned sessions that have been active too long.
+ * @task T4463
+ */
+export async function gcSessions(maxAgeHours = 24, cwd, accessor) {
+    const data = await readSessions(cwd, accessor);
+    const now = Date.now();
+    const maxAgeMs = maxAgeHours * 60 * 60 * 1000;
+    const orphaned = [];
+    const removed = [];
+    for (const session of data.sessions) {
+        if (session.status === 'active') {
+            const age = now - new Date(session.startedAt).getTime();
+            if (age > maxAgeMs) {
+                session.status = 'orphaned';
+                session.endedAt = new Date().toISOString();
+                orphaned.push(session.id);
+            }
+        }
+    }
+    // Remove very old ended/orphaned sessions (> 30 days)
+    const thirtyDaysMs = 30 * 24 * 60 * 60 * 1000;
+    data.sessions = data.sessions.filter(s => {
+        if (s.status === 'active')
+            return true;
+        const endedAt = s.endedAt ? new Date(s.endedAt).getTime() : new Date(s.startedAt).getTime();
+        if (now - endedAt > thirtyDaysMs) {
+            removed.push(s.id);
+            return false;
+        }
+        return true;
+    });
+    if (orphaned.length > 0 || removed.length > 0) {
+        await saveSessions(data, cwd, accessor);
+    }
+    return { orphaned, removed };
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/sessions/session-enforcement.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Session enforcement - require active sessions for write operations.
+ *
+ * Part of the Epic-Bound Session architecture. Enforces that write operations
+ * (add, update, complete) require an active session when multi-session mode
+ * is enabled.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Enforcement modes. */
+export type EnforcementMode = 'strict' | 'warn' | 'none';
+/** Get the current enforcement mode. */
+export declare function getEnforcementMode(cwd?: string): EnforcementMode;
+/** Check if session enforcement is enabled. */
+export declare function isSessionEnforcementEnabled(cwd?: string): boolean;
+/** Session info for enforcement checks. */
+export interface ActiveSessionInfo {
+    id: string;
+    name: string;
+    scope: {
+        type: string;
+        epicId?: string;
+    };
+}
+/** Get active session info. Returns null if no active session. */
+export declare function getActiveSessionInfo(cwd?: string): Promise<ActiveSessionInfo | null>;
+/** Enforcement result. */
+export interface EnforcementResult {
+    allowed: boolean;
+    mode: EnforcementMode;
+    session: ActiveSessionInfo | null;
+    warning?: string;
+}
+/**
+ * Require an active session for write operations.
+ * In strict mode, throws if no session is active.
+ * In warn mode, returns a warning but allows the operation.
+ * In none mode, always allows.
+ */
+export declare function requireActiveSession(operation: string, cwd?: string): Promise<EnforcementResult>;
+/**
+ * Validate that a task is within the current session's scope.
+ * Only enforced when multi-session mode is enabled and a session is active.
+ */
+export declare function validateTaskInScope(taskId: string, taskEpicId?: string, cwd?: string): Promise<{
+    inScope: boolean;
+    warning?: string;
+}>;
+//# sourceMappingURL=session-enforcement.d.ts.map

package/dist/core/sessions/session-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-enforcement.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/session-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2BH,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAahE;AAED,+CAA+C;AAC/C,wBAAgB,2BAA2B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,kEAAkE;AAClE,wBAAsB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAS1F;AAED,0BAA0B;AAC1B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAmC5B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCjD"}

package/dist/core/sessions/session-enforcement.js

@@ -0,0 +1,139 @@
+/**
+ * Session enforcement - require active sessions for write operations.
+ *
+ * Part of the Epic-Bound Session architecture. Enforces that write operations
+ * (add, update, complete) require an active session when multi-session mode
+ * is enabled.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCleoDir } from '../paths.js';
+import { sessionStatus } from './index.js';
+/** Synchronous config value reader. */
+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;
+    }
+}
+/** Get the current enforcement mode. */
+export function getEnforcementMode(cwd) {
+    try {
+        // Check if multi-session is enabled
+        const multiEnabled = readConfigValueSync('multiSession.enabled', false, cwd);
+        if (!multiEnabled)
+            return 'none';
+        // Get enforcement mode from config
+        const mode = readConfigValueSync('session.enforcement', 'strict', cwd);
+        if (mode === 'strict' || mode === 'warn' || mode === 'none')
+            return mode;
+        return 'strict'; // Default
+    }
+    catch {
+        return 'none';
+    }
+}
+/** Check if session enforcement is enabled. */
+export function isSessionEnforcementEnabled(cwd) {
+    return getEnforcementMode(cwd) !== 'none';
+}
+/** Get active session info. Returns null if no active session. */
+export async function getActiveSessionInfo(cwd) {
+    const session = await sessionStatus(cwd);
+    if (!session)
+        return null;
+    return {
+        id: session.id,
+        name: session.name,
+        scope: session.scope,
+    };
+}
+/**
+ * Require an active session for write operations.
+ * In strict mode, throws if no session is active.
+ * In warn mode, returns a warning but allows the operation.
+ * In none mode, always allows.
+ */
+export async function requireActiveSession(operation, cwd) {
+    const mode = getEnforcementMode(cwd);
+    if (mode === 'none') {
+        return { allowed: true, mode, session: null };
+    }
+    const session = await getActiveSessionInfo(cwd);
+    if (session) {
+        return { allowed: true, mode, session };
+    }
+    // No active session
+    if (mode === 'strict') {
+        throw new CleoError(ExitCode.SESSION_REQUIRED, `Operation '${operation}' requires an active session`, {
+            fix: "Start a session with 'cleo session start --scope epic:T### --auto-start --name \"Work\"'",
+            alternatives: [
+                { action: 'Start session', command: 'cleo session start --scope epic:T001 --auto-start --name "Work"' },
+                { action: 'List sessions', command: 'cleo session list' },
+            ],
+        });
+    }
+    // Warn mode
+    return {
+        allowed: true,
+        mode,
+        session: null,
+        warning: `No active session for operation '${operation}'. Consider starting one.`,
+    };
+}
+/**
+ * Validate that a task is within the current session's scope.
+ * Only enforced when multi-session mode is enabled and a session is active.
+ */
+export async function validateTaskInScope(taskId, taskEpicId, cwd) {
+    const mode = getEnforcementMode(cwd);
+    if (mode === 'none')
+        return { inScope: true };
+    const session = await getActiveSessionInfo(cwd);
+    if (!session)
+        return { inScope: true }; // No session = no scope enforcement
+    // Global scope allows everything
+    if (session.scope.type === 'global')
+        return { inScope: true };
+    // Epic scope: task must be within the session's epic
+    if (session.scope.type === 'epic' && session.scope.epicId) {
+        const epicId = session.scope.epicId;
+        // Task is the epic itself or is a child
+        if (taskId === epicId || taskEpicId === epicId) {
+            return { inScope: true };
+        }
+        if (mode === 'strict') {
+            throw new CleoError(ExitCode.TASK_NOT_IN_SCOPE, `Task ${taskId} is not in scope of session ${session.id} (epic: ${epicId})`, {
+                fix: `Focus on tasks within epic ${epicId} or start a new session`,
+                alternatives: [
+                    { action: 'View session', command: `cleo session status` },
+                    { action: 'End session', command: `cleo session end` },
+                ],
+            });
+        }
+        return {
+            inScope: false,
+            warning: `Task ${taskId} is outside session scope (epic: ${epicId})`,
+        };
+    }
+    return { inScope: true };
+}
+//# sourceMappingURL=session-enforcement.js.map

package/dist/core/sessions/session-enforcement.js.map

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

package/dist/core/sessions/session-migration.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Session migration - migrate existing projects to Epic-Bound Session system.
+ *
+ * Automatically migrates existing single-session projects to the new
+ * multi-session architecture when any session command is run.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/**
+ * Check if migration is needed for Epic-Bound Sessions.
+ * Returns true if migration is needed, false if already migrated.
+ */
+export declare function needsSessionMigration(cwd?: string): Promise<boolean>;
+/**
+ * Migrate existing single-session to multi-session format.
+ * Creates sessions.json with proper structure and enables multi-session in config.
+ */
+export declare function migrateToEpicSessions(cwd?: string): Promise<{
+    migrated: boolean;
+    actions: string[];
+}>;
+/**
+ * Check migration status and return a summary.
+ */
+export declare function getMigrationStatus(cwd?: string): Promise<{
+    needsMigration: boolean;
+    sessionsFileExists: boolean;
+    multiSessionEnabled: boolean;
+}>;
+//# sourceMappingURL=session-migration.d.ts.map

package/dist/core/sessions/session-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-migration.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/session-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0B1E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CAmDD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9D,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC,CAoBD"}

package/dist/core/sessions/session-migration.js

@@ -0,0 +1,122 @@
+/**
+ * Session migration - migrate existing projects to Epic-Bound Session system.
+ *
+ * Automatically migrates existing single-session projects to the new
+ * multi-session architecture when any session command is run.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCleoDir } from '../paths.js';
+import { readJson, saveJson } from '../../store/json.js';
+/**
+ * Check if migration is needed for Epic-Bound Sessions.
+ * Returns true if migration is needed, false if already migrated.
+ */
+export async function needsSessionMigration(cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const sessionsFile = join(cleoDir, 'sessions.json');
+    const configFile = join(cleoDir, 'config.json');
+    // If sessions.json exists with valid structure, no migration needed
+    if (existsSync(sessionsFile)) {
+        try {
+            const data = JSON.parse(readFileSync(sessionsFile, 'utf-8'));
+            if (data.version)
+                return false;
+        }
+        catch {
+            // Invalid JSON, needs migration
+        }
+    }
+    // Config has multiSession but no sessions.json => partial migration
+    if (existsSync(configFile)) {
+        try {
+            const config = JSON.parse(readFileSync(configFile, 'utf-8'));
+            if (config.multiSession?.enabled !== undefined)
+                return true;
+        }
+        catch {
+            // Invalid config
+        }
+    }
+    return true;
+}
+/**
+ * Migrate existing single-session to multi-session format.
+ * Creates sessions.json with proper structure and enables multi-session in config.
+ */
+export async function migrateToEpicSessions(cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const sessionsPath = join(cleoDir, 'sessions.json');
+    const configPath = join(cleoDir, 'config.json');
+    const actions = [];
+    // Create sessions.json if missing
+    if (!existsSync(sessionsPath)) {
+        const initialData = {
+            version: '1.0.0',
+            sessions: [],
+            _meta: {
+                schemaVersion: '1.0.0',
+                lastUpdated: new Date().toISOString(),
+            },
+        };
+        await saveJson(sessionsPath, initialData);
+        actions.push('Created sessions.json');
+    }
+    else {
+        // Validate existing sessions.json
+        const data = await readJson(sessionsPath);
+        if (data && !data.version) {
+            const migrated = {
+                version: '1.0.0',
+                sessions: data.sessions ?? [],
+                _meta: {
+                    schemaVersion: '1.0.0',
+                    lastUpdated: new Date().toISOString(),
+                },
+            };
+            await saveJson(sessionsPath, migrated);
+            actions.push('Migrated sessions.json to v1.0.0 format');
+        }
+    }
+    // Enable multiSession in config
+    if (existsSync(configPath)) {
+        try {
+            const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            if (!config.multiSession) {
+                config.multiSession = { enabled: true };
+                await saveJson(configPath, config);
+                actions.push('Enabled multiSession in config.json');
+            }
+        }
+        catch {
+            // Config issue, skip
+        }
+    }
+    return { migrated: actions.length > 0, actions };
+}
+/**
+ * Check migration status and return a summary.
+ */
+export async function getMigrationStatus(cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const sessionsPath = join(cleoDir, 'sessions.json');
+    const configPath = join(cleoDir, 'config.json');
+    const sessionsFileExists = existsSync(sessionsPath);
+    let multiSessionEnabled = false;
+    if (existsSync(configPath)) {
+        try {
+            const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            multiSessionEnabled = config.multiSession?.enabled === true;
+        }
+        catch { /* */ }
+    }
+    return {
+        needsMigration: await needsSessionMigration(cwd),
+        sessionsFileExists,
+        multiSessionEnabled,
+    };
+}
+//# sourceMappingURL=session-migration.js.map

package/dist/core/sessions/session-migration.js.map

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

package/dist/core/sessions/statusline-setup.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Statusline setup helper - Claude Code status line integration.
+ *
+ * Checks and configures Claude Code status line for context monitoring.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Statusline integration status. */
+export type StatuslineStatus = 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings';
+/**
+ * Check if statusline integration is configured.
+ * Returns the current integration status.
+ */
+export declare function checkStatuslineIntegration(): StatuslineStatus;
+/**
+ * Get the statusline setup command for Claude Code settings.
+ */
+export declare function getStatuslineConfig(): Record<string, unknown>;
+/**
+ * Get human-readable setup instructions.
+ */
+export declare function getSetupInstructions(): string;
+//# sourceMappingURL=statusline-setup.d.ts.map

package/dist/core/sessions/statusline-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-setup.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/statusline-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAElG;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAwC7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C"}