@cleocode/core 2026.4.13 → 2026.4.14

package/dist/sessions/snapshot.js

@@ -1,213 +0,0 @@
-/**
- * Session snapshot serialization and restoration.
- *
- * Provides `serializeSession()` and `restoreSession()` for full session
- * state capture and hydration. Designed for CleoOS agent session persistence:
- * when an agent dies, CleoOS serializes the session snapshot, and when a new
- * agent connects, it restores the snapshot to resume seamlessly.
- *
- * The snapshot captures everything needed to resume work:
- * - Full session object (scope, taskWork, notes, stats)
- * - Handoff data (completed tasks, decisions, next suggested)
- * - Brain context (recent observations linked to this session)
- * - Active task state (current focus, blockers)
- *
- * @module sessions/snapshot
- */
-import { ExitCode } from '@cleocode/contracts';
-import { CleoError } from '../errors.js';
-import { getAccessor } from '../store/data-accessor.js';
-import { getDecisionLog } from './decisions.js';
-import { computeHandoff } from './handoff.js';
-// ============================================================================
-// Snapshot types
-// ============================================================================
-/** Version of the snapshot schema. Increment on breaking changes. */
-export const SNAPSHOT_VERSION = 1;
-// ============================================================================
-// Serialize
-// ============================================================================
-/**
- * Serialize a session into a complete snapshot.
- *
- * Captures the full session state including handoff data, decisions,
- * brain observations, and active task context. The result is a
- * JSON-serializable object that can be stored and later restored.
- *
- * @param projectRoot - Project root directory
- * @param options - Serialization options
- * @returns Complete session snapshot
- */
-export async function serializeSession(projectRoot, options = {}, accessor) {
-    const acc = accessor ?? (await getAccessor(projectRoot));
-    const maxObs = options.maxObservations ?? 10;
-    const maxDescLen = options.maxDescriptionLength ?? 500;
-    // Find the session
-    const sessions = await acc.loadSessions();
-    let session;
-    if (options.sessionId) {
-        session = sessions.find((s) => s.id === options.sessionId);
-    }
-    else {
-        // Find the active session
-        session = 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 '${options.sessionId}' not found`
-            : 'No active session to serialize', { fix: "Use 'cleo session list' to see available sessions" });
-    }
-    // Compute handoff data
-    const handoff = await computeHandoff(projectRoot, { sessionId: session.id });
-    // Get decisions
-    const decisionLog = await getDecisionLog(projectRoot, { sessionId: session.id });
-    const decisions = decisionLog.map((d) => ({
-        decision: d.decision,
-        rationale: d.rationale,
-        taskId: d.taskId,
-        recordedAt: d.timestamp ?? new Date().toISOString(),
-    }));
-    // Get brain observations linked to this session (best-effort)
-    let observations = [];
-    try {
-        const { searchBrainCompact } = await import('../memory/brain-retrieval.js');
-        const results = await searchBrainCompact(projectRoot, {
-            query: session.id,
-            limit: maxObs,
-            tables: ['observations'],
-        });
-        if (Array.isArray(results)) {
-            observations = results.map((r) => ({
-                id: r.id,
-                text: r.text ?? '',
-                type: r.type ?? 'discovery',
-                createdAt: r.createdAt ?? '',
-            }));
-        }
-    }
-    catch {
-        // Brain search is best-effort — snapshot works without it
-    }
-    // Get active task context
-    let activeTask = null;
-    if (session.taskWork?.taskId) {
-        try {
-            const { tasks } = await acc.queryTasks({});
-            const task = tasks.find((t) => t.id === session.taskWork?.taskId);
-            if (task) {
-                const desc = task.description ?? '';
-                activeTask = {
-                    taskId: task.id,
-                    title: task.title,
-                    status: task.status,
-                    priority: task.priority ?? 'medium',
-                    description: desc.length > maxDescLen ? desc.slice(0, maxDescLen) + '...' : desc,
-                    acceptance: Array.isArray(task.acceptance)
-                        ? task.acceptance.join('\n')
-                        : (task.acceptance ?? undefined),
-                };
-            }
-        }
-        catch {
-            // Task lookup is best-effort
-        }
-    }
-    // Compute duration
-    const startTime = new Date(session.startedAt).getTime();
-    const now = Date.now();
-    const durationMinutes = Math.round((now - startTime) / 60_000);
-    return {
-        version: SNAPSHOT_VERSION,
-        capturedAt: new Date().toISOString(),
-        session,
-        handoff,
-        decisions,
-        observations,
-        activeTask,
-        durationMinutes,
-    };
-}
-// ============================================================================
-// Restore
-// ============================================================================
-/**
- * Restore a session from a snapshot.
- *
- * Hydrates a session from a previously serialized snapshot. The session
- * is re-inserted into the sessions store and optionally activated.
- * Brain observations from the snapshot are NOT re-inserted (they already
- * exist in brain.db) — only the session state is restored.
- *
- * @param projectRoot - Project root directory
- * @param snapshot - The snapshot to restore from
- * @param options - Restoration options
- * @returns The restored session
- */
-export async function restoreSession(projectRoot, snapshot, options = {}, accessor) {
-    // Validate snapshot version
-    if (snapshot.version > SNAPSHOT_VERSION) {
-        throw new CleoError(ExitCode.VALIDATION_ERROR, `Snapshot version ${snapshot.version} is newer than supported version ${SNAPSHOT_VERSION}`, { fix: 'Upgrade @cleocode/core to a newer version that supports this snapshot format' });
-    }
-    const acc = accessor ?? (await getAccessor(projectRoot));
-    const activate = options.activate ?? true;
-    // Check for active session conflict
-    if (activate) {
-        const sessions = await acc.loadSessions();
-        const scope = snapshot.session.scope;
-        const activeConflict = sessions.find((s) => s.status === 'active' &&
-            s.scope.type === scope.type &&
-            s.scope.epicId === scope.epicId &&
-            s.id !== snapshot.session.id);
-        if (activeConflict) {
-            throw new CleoError(ExitCode.SCOPE_CONFLICT, `Active session '${activeConflict.id}' already exists for scope ${scope.type}${scope.epicId ? ':' + scope.epicId : ''}`, {
-                fix: `End the active session first with 'cleo session end' or restore without activating`,
-                alternatives: [
-                    { action: 'End conflicting session', command: 'cleo session end' },
-                    { action: 'Restore without activating', command: 'Restore with activate: false' },
-                ],
-            });
-        }
-    }
-    // Reconstruct the session
-    const restoredSession = {
-        ...snapshot.session,
-        status: activate ? 'active' : snapshot.session.status,
-        notes: [
-            ...(snapshot.session.notes ?? []),
-            `Restored from snapshot at ${new Date().toISOString()} (captured ${snapshot.capturedAt}, duration ${snapshot.durationMinutes}m)`,
-        ],
-        resumeCount: (snapshot.session.resumeCount ?? 0) + 1,
-    };
-    // Update agent if a new one is taking over
-    if (options.agent) {
-        restoredSession.agent = options.agent;
-        restoredSession.notes = [
-            ...(restoredSession.notes ?? []),
-            `Agent handoff: ${snapshot.session.agent ?? 'unknown'} → ${options.agent}`,
-        ];
-    }
-    // Store the handoff data for context
-    restoredSession.handoffJson = JSON.stringify(snapshot.handoff);
-    // Persist
-    await acc.upsertSingleSession(restoredSession);
-    // Dispatch hook (best-effort)
-    try {
-        const { hooks } = await import('../hooks/registry.js');
-        await hooks.dispatch('SessionStart', projectRoot, {
-            timestamp: new Date().toISOString(),
-            sessionId: restoredSession.id,
-            name: restoredSession.name,
-            scope: restoredSession.scope,
-            agent: restoredSession.agent,
-            restored: true,
-            snapshotCapturedAt: snapshot.capturedAt,
-        });
-    }
-    catch {
-        // Hooks are best-effort
-    }
-    return restoredSession;
-}
-//# sourceMappingURL=snapshot.js.map

package/dist/sessions/snapshot.js.map

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

package/dist/sessions/statusline-setup.js

@@ -1,85 +0,0 @@
-/**
- * Statusline setup helper - Claude Code status line integration.
- *
- * Checks and configures Claude Code status line for context monitoring.
- *
- * @task T4454
- * @epic T4454
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { getCleoHome } from '../paths.js';
-/** Inline Claude settings path to decouple from provider-specific paths (T5240). */
-function getClaudeSettingsPath() {
-    return (process.env['CLAUDE_SETTINGS'] ??
-        join(process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude'), 'settings.json'));
-}
-/**
- * Check if statusline integration is configured.
- * Returns the current integration status.
- */
-export function checkStatuslineIntegration() {
-    const settingsPath = getClaudeSettingsPath();
-    if (!existsSync(settingsPath))
-        return 'no_settings';
-    try {
-        const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-        const statusLine = settings.statusLine;
-        if (!statusLine?.type)
-            return 'not_configured';
-        if (statusLine.type !== 'command')
-            return 'custom_no_cleo';
-        const cmd = statusLine.command ?? '';
-        // Check if it's a CLEO statusline integration
-        if (cmd.includes('context-monitor.sh') ||
-            cmd.includes('cleo-statusline') ||
-            cmd.includes('.context-state.json') ||
-            cmd.includes('context-states')) {
-            return 'configured';
-        }
-        // Check if the script writes to CLEO state file
-        const scriptPath = cmd.startsWith('~') ? cmd.replace('~', homedir()) : cmd;
-        if (existsSync(scriptPath)) {
-            try {
-                const content = readFileSync(scriptPath, 'utf-8');
-                if (content.includes('context-state.json'))
-                    return 'configured';
-            }
-            catch {
-                /* unreadable */
-            }
-        }
-        return 'custom_no_cleo';
-    }
-    catch {
-        return 'no_settings';
-    }
-}
-/**
- * Get the statusline setup command for Claude Code settings.
- */
-export function getStatuslineConfig() {
-    const cleoHome = getCleoHome();
-    return {
-        statusLine: {
-            type: 'command',
-            command: join(cleoHome, 'lib', 'session', 'context-monitor.sh'),
-        },
-    };
-}
-/**
- * Get human-readable setup instructions.
- */
-export function getSetupInstructions() {
-    const settingsPath = getClaudeSettingsPath();
-    return [
-        'To enable context monitoring, add to your Claude Code settings:',
-        `File: ${settingsPath}`,
-        '',
-        JSON.stringify(getStatuslineConfig(), null, 2),
-        '',
-        'This enables real-time context window tracking in the CLI.',
-    ].join('\n');
-}
-//# sourceMappingURL=statusline-setup.js.map

package/dist/sessions/statusline-setup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"statusline-setup.js","sourceRoot":"","sources":["../../src/sessions/statusline-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,oFAAoF;AACpF,SAAS,qBAAqB;IAC5B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,eAAe,CAAC,CAChF,CAAC;AACJ,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,aAAa,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QAEvC,IAAI,CAAC,UAAU,EAAE,IAAI;YAAE,OAAO,gBAAgB,CAAC;QAC/C,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,gBAAgB,CAAC;QAE3D,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;QAErC,8CAA8C;QAC9C,IACE,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAClC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC/B,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACnC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAC9B,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,gDAAgD;QAChD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAE3E,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAClD,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;oBAAE,OAAO,YAAY,CAAC;YAClE,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,OAAO;QACL,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,CAAC;SAChE;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,OAAO;QACL,iEAAiE;QACjE,SAAS,YAAY,EAAE;QACvB,EAAE;QACF,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,EAAE;QACF,4DAA4D;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/sessions/types.js

@@ -1,8 +0,0 @@
-/**
- * Extended session types used by the engine/dispatch layer.
- *
- * @task T4782
- * @epic T4654
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/sessions/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/skills/agents/config.js

@@ -1,94 +0,0 @@
-/**
- * Agent configuration management.
- * Ports lib/skills/agent-config.sh.
- *
- * Reads agent definitions from AGENT.md files (YAML frontmatter)
- * and provides configuration accessors.
- *
- * @epic T4454
- * @task T4518
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { basename, join } from 'node:path';
-import { getProjectRoot } from '../../paths.js';
-import { parseFrontmatter } from '../discovery.js';
-// ============================================================================
-// Agent Config Resolution
-// ============================================================================
-/**
- * Get the agents directory path.
- * @task T4518
- */
-export function getAgentsDir(cwd) {
-    return join(getProjectRoot(cwd), 'agents');
-}
-/**
- * Parse an AGENT.md file into an AgentConfig.
- * AGENT.md uses the same YAML frontmatter format as SKILL.md.
- * @task T4518
- */
-export function parseAgentConfig(agentDir) {
-    const agentMdPath = join(agentDir, 'AGENT.md');
-    if (!existsSync(agentMdPath)) {
-        return null;
-    }
-    const content = readFileSync(agentMdPath, 'utf-8');
-    const fm = parseFrontmatter(content);
-    return {
-        name: fm.name || basename(agentDir),
-        description: fm.description || '',
-        model: fm.model,
-        allowedTools: fm.allowedTools,
-        customInstructions: extractBody(content),
-    };
-}
-/**
- * Load agent configuration by name.
- * Searches in the agents/ directory.
- * @task T4518
- */
-export function loadAgentConfig(agentName, cwd) {
-    const agentsDir = getAgentsDir(cwd);
-    const agentDir = join(agentsDir, agentName);
-    return parseAgentConfig(agentDir);
-}
-/**
- * Get the cleo-subagent configuration (universal executor).
- * @task T4518
- */
-export function getSubagentConfig(cwd) {
-    return loadAgentConfig('cleo-subagent', cwd);
-}
-/**
- * Check if an agent definition exists.
- * @task T4518
- */
-export function agentExists(agentName, cwd) {
-    const agentsDir = getAgentsDir(cwd);
-    const agentMdPath = join(agentsDir, agentName, 'AGENT.md');
-    return existsSync(agentMdPath);
-}
-// ============================================================================
-// Helpers
-// ============================================================================
-/**
- * Extract the body content after frontmatter.
- */
-function extractBody(content) {
-    const lines = content.split('\n');
-    let inFrontmatter = false;
-    let bodyStart = 0;
-    for (let i = 0; i < lines.length; i++) {
-        if (lines[i].trim() === '---') {
-            if (!inFrontmatter) {
-                inFrontmatter = true;
-            }
-            else {
-                bodyStart = i + 1;
-                break;
-            }
-        }
-    }
-    return lines.slice(bodyStart).join('\n').trim();
-}
-//# sourceMappingURL=config.js.map

package/dist/skills/agents/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/skills/agents/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE/C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAErC,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC;QACnC,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE;QACjC,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,YAAY,EAAE,EAAE,CAAC,YAAY;QAC7B,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,GAAY;IAC7D,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAE5C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,eAAe,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,GAAY;IACzD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/skills/agents/install.js

@@ -1,116 +0,0 @@
-/**
- * Agent installation functions.
- * Ports lib/skills/agents-install.sh.
- *
- * Installs agent configurations to the appropriate locations.
- *
- * @epic T4454
- * @task T4518
- */
-import { existsSync, mkdirSync, readdirSync, readlinkSync, symlinkSync, unlinkSync } from 'node:fs';
-import { platform } from 'node:os';
-import { basename, join } from 'node:path';
-import { getClaudeAgentsDir } from '../../paths.js';
-import { getAgentsDir } from './config.js';
-/**
- * Symlink type for directory symlinks.
- * On Windows, use 'junction' (no admin privileges required).
- * On Unix, use 'dir'.
- */
-const DIR_SYMLINK_TYPE = platform() === 'win32' ? 'junction' : 'dir';
-// ============================================================================
-// Agent Installation
-// ============================================================================
-/** Installation target directory. */
-function getAgentInstallDir() {
-    return getClaudeAgentsDir();
-}
-/**
- * Install a single agent via symlink.
- * @task T4518
- */
-export function installAgent(agentDir) {
-    const targetDir = getAgentInstallDir();
-    const agentName = basename(agentDir);
-    const targetPath = join(targetDir, agentName);
-    // Ensure target directory exists
-    if (!existsSync(targetDir)) {
-        mkdirSync(targetDir, { recursive: true });
-    }
-    // Check source exists
-    if (!existsSync(agentDir)) {
-        return { installed: false, path: targetPath, error: `Source not found: ${agentDir}` };
-    }
-    // Handle existing entry
-    if (existsSync(targetPath)) {
-        try {
-            const existing = readlinkSync(targetPath);
-            if (existing === agentDir) {
-                return { installed: true, path: targetPath }; // Already correct
-            }
-            // Different target, remove and re-link
-            unlinkSync(targetPath);
-        }
-        catch {
-            // Not a symlink, skip
-            return {
-                installed: false,
-                path: targetPath,
-                error: `Target exists and is not a symlink: ${targetPath}`,
-            };
-        }
-    }
-    try {
-        symlinkSync(agentDir, targetPath, DIR_SYMLINK_TYPE);
-        return { installed: true, path: targetPath };
-    }
-    catch (err) {
-        return { installed: false, path: targetPath, error: `Symlink failed: ${err}` };
-    }
-}
-/**
- * Install all agents from the project agents/ directory.
- * @task T4518
- */
-export function installAllAgents(cwd) {
-    const agentsDir = getAgentsDir(cwd);
-    const results = [];
-    if (!existsSync(agentsDir)) {
-        return results;
-    }
-    const entries = readdirSync(agentsDir);
-    for (const entry of entries) {
-        if (entry.startsWith('.'))
-            continue;
-        const agentDir = join(agentsDir, entry);
-        const agentMdPath = join(agentDir, 'AGENT.md');
-        if (!existsSync(agentMdPath))
-            continue;
-        const result = installAgent(agentDir);
-        results.push({
-            name: entry,
-            installed: result.installed,
-            error: result.error,
-        });
-    }
-    return results;
-}
-/**
- * Uninstall a single agent by removing its symlink.
- * @task T4518
- */
-export function uninstallAgent(agentName) {
-    const targetDir = getAgentInstallDir();
-    const targetPath = join(targetDir, agentName);
-    if (!existsSync(targetPath)) {
-        return false;
-    }
-    try {
-        unlinkSync(targetPath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=install.js.map

package/dist/skills/agents/install.js.map

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