@cleocode/core 2026.3.38 → 2026.3.39

package/dist/otel/index.js

@@ -1,126 +0,0 @@
-/**
- * OpenTelemetry token metrics core module.
- * @task T4535
- * @epic T4454
- */
-import { copyFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-function getProjectRoot() {
-    let dir = process.cwd();
-    while (dir !== '/') {
-        if (existsSync(join(dir, '.cleo', 'config.json')))
-            return dir;
-        dir = join(dir, '..');
-    }
-    return process.cwd();
-}
-function getTokenFilePath() {
-    return join(getProjectRoot(), '.cleo', 'metrics', 'TOKEN_USAGE.jsonl');
-}
-function readJsonlFile(filePath) {
-    if (!existsSync(filePath))
-        return [];
-    const content = readFileSync(filePath, 'utf-8').trim();
-    if (!content)
-        return [];
-    return content.split('\n').map((line) => JSON.parse(line));
-}
-/** Get token tracking status. */
-export async function getOtelStatus() {
-    const tokenFile = getTokenFilePath();
-    const entries = readJsonlFile(tokenFile);
-    const totalTokens = entries.reduce((sum, e) => sum + (e.estimated_tokens ?? 0), 0);
-    const manifestTokens = entries
-        .filter((e) => e.event_type === 'manifest_read' || e.event_type === 'manifest_query')
-        .reduce((sum, e) => sum + (e.estimated_tokens ?? 0), 0);
-    const fullFileTokens = entries
-        .filter((e) => e.event_type === 'full_file_read')
-        .reduce((sum, e) => sum + (e.estimated_tokens ?? 0), 0);
-    return {
-        file: tokenFile,
-        events: entries.length,
-        totalTokens,
-        breakdown: {
-            manifestReads: manifestTokens,
-            fullFileReads: fullFileTokens,
-            other: totalTokens - manifestTokens - fullFileTokens,
-        },
-    };
-}
-/** Get combined token usage summary. */
-export async function getOtelSummary() {
-    const tokenFile = getTokenFilePath();
-    const entries = readJsonlFile(tokenFile);
-    if (entries.length === 0) {
-        return { message: 'No token tracking data yet', events: 0 };
-    }
-    const totalTokens = entries.reduce((sum, e) => sum + (e.estimated_tokens ?? 0), 0);
-    const sessions = entries.filter((e) => e.event_type === 'session_start');
-    const spawns = entries.filter((e) => e.event_type !== 'session_start');
-    const byType = {};
-    for (const e of entries) {
-        const type = e.event_type ?? 'unknown';
-        if (!byType[type])
-            byType[type] = { count: 0, tokens: 0 };
-        byType[type].count++;
-        byType[type].tokens += e.estimated_tokens ?? 0;
-    }
-    return {
-        totalEvents: entries.length,
-        totalTokens,
-        sessions: {
-            count: sessions.length,
-            tokens: sessions.reduce((s, e) => s + (e.estimated_tokens ?? 0), 0),
-        },
-        spawns: {
-            count: spawns.length,
-            tokens: spawns.reduce((s, e) => s + (e.estimated_tokens ?? 0), 0),
-        },
-        byType: Object.entries(byType).map(([type, stats]) => ({ type, ...stats })),
-        file: tokenFile,
-    };
-}
-/** Get session-level token data. */
-export async function getOtelSessions(opts) {
-    const entries = readJsonlFile(getTokenFilePath());
-    let sessions = entries.filter((e) => e.event_type === 'session_start');
-    if (opts.session) {
-        sessions = sessions.filter((e) => {
-            const ctx = (e.context ?? {});
-            return ctx.session_id === opts.session;
-        });
-    }
-    if (opts.task) {
-        sessions = sessions.filter((e) => e.task_id === opts.task);
-    }
-    return { sessions, count: sessions.length };
-}
-/** Get spawn-level token data. */
-export async function getOtelSpawns(opts) {
-    const entries = readJsonlFile(getTokenFilePath());
-    let spawns = entries.filter((e) => e.event_type !== 'session_start');
-    if (opts.task) {
-        spawns = spawns.filter((e) => e.task_id === opts.task);
-    }
-    return { spawns, count: spawns.length };
-}
-/** Get real token usage from Claude Code API. */
-export async function getRealTokenUsage(_opts) {
-    // Real token usage requires OTel integration - return placeholder
-    return {
-        message: 'Real token usage requires OpenTelemetry configuration',
-        otelEnabled: process.env.CLAUDE_CODE_ENABLE_TELEMETRY === '1',
-    };
-}
-/** Clear token tracking data with backup. */
-export async function clearOtelData() {
-    const tokenFile = getTokenFilePath();
-    if (existsSync(tokenFile)) {
-        const backup = `${tokenFile}.backup-${new Date().toISOString().replace(/[:.]/g, '-')}`;
-        copyFileSync(tokenFile, backup);
-        writeFileSync(tokenFile, '');
-        return { message: 'Token tracking cleared', backup };
-    }
-    return { message: 'No token file to clear' };
-}
-//# sourceMappingURL=index.js.map

package/dist/otel/index.js.map

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

package/dist/output.d.ts

@@ -1,66 +0,0 @@
-/**
- * LAFS-compliant output formatter for CLEO V2.
- *
- * LAFS (LLM-Agent-First Schema) ensures all CLI output is
- * machine-parseable JSON by default, with optional human-readable modes.
- *
- * All envelopes are now full LAFS-compliant with $schema and _meta.
- * The backward-compatible shape (success + data, no _meta) has been removed.
- *
- * Types are re-exported from the canonical source in src/types/lafs.ts.
- *
- * @epic T4663
- * @task T4672
- */
-import type { LAFSPage, Warning } from '@cleocode/lafs-protocol';
-import type { LafsEnvelope, LafsError, LafsSuccess } from '@cleocode/contracts';
-import { CleoError } from './errors.js';
-export type { LafsSuccess, LafsError, LafsEnvelope };
-/**
- * Push a deprecation or informational warning into the current envelope.
- * Warnings are drained (consumed) by the next formatSuccess/formatError call.
- *
- * @task T4669
- * @epic T4663
- */
-export declare function pushWarning(warning: Warning): void;
-/**
- * Options for envelope formatting.
- *
- * @task T4668
- * @task T4670
- * @epic T4663
- */
-export interface FormatOptions {
-    operation?: string;
-    page?: LAFSPage;
-    extensions?: Record<string, unknown>;
-    /** MVI level to embed in the envelope _meta. Defaults to 'standard'. @task T4957 */
-    mvi?: import('@cleocode/lafs-protocol').MVILevel;
-}
-/**
- * Format a successful result as a full LAFS-conformant envelope.
- *
- * Always produces the full LAFSEnvelope with $schema and _meta.
- * When operation is omitted, defaults to 'cli.output'.
- * Supports optional page (T4668) and _extensions (T4670).
- *
- * @task T4672
- * @task T4668
- * @task T4670
- * @epic T4663
- */
-export declare function formatSuccess<T>(data: T, message?: string, operationOrOpts?: string | FormatOptions): string;
-/**
- * Format an error as a full LAFS-conformant envelope.
- *
- * Always produces the full LAFSEnvelope with $schema and _meta.
- * When operation is omitted, defaults to 'cli.output'.
- *
- * @task T4672
- * @epic T4663
- */
-export declare function formatError(error: CleoError, operation?: string): string;
-/** Format any result (success or error) as LAFS JSON. */
-export declare function formatOutput<T>(result: T | CleoError): string;
-//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAY,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAWrD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElD;AAeD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oFAAoF;IACpF,GAAG,CAAC,EAAE,OAAO,yBAAyB,EAAE,QAAQ,CAAC;CAClD;AAkCD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GAAG,aAAa,GACvC,MAAM,CAkBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CASxE;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,GAAG,MAAM,CAK7D"}

package/dist/output.js

@@ -1,132 +0,0 @@
-/**
- * LAFS-compliant output formatter for CLEO V2.
- *
- * LAFS (LLM-Agent-First Schema) ensures all CLI output is
- * machine-parseable JSON by default, with optional human-readable modes.
- *
- * All envelopes are now full LAFS-compliant with $schema and _meta.
- * The backward-compatible shape (success + data, no _meta) has been removed.
- *
- * Types are re-exported from the canonical source in src/types/lafs.ts.
- *
- * @epic T4663
- * @task T4672
- */
-import { randomUUID } from 'node:crypto';
-import { CleoError } from './errors.js';
-import { getCurrentSessionId } from './sessions/context-alert.js';
-/**
- * Accumulated warnings for the current request.
- * Reset on each formatSuccess/formatError call via drainWarnings().
- *
- * @task T4669
- * @epic T4663
- */
-const pendingWarnings = [];
-/**
- * Push a deprecation or informational warning into the current envelope.
- * Warnings are drained (consumed) by the next formatSuccess/formatError call.
- *
- * @task T4669
- * @epic T4663
- */
-export function pushWarning(warning) {
-    pendingWarnings.push(warning);
-}
-/**
- * Drain all pending warnings (returns and clears the queue).
- *
- * @task T4669
- * @epic T4663
- */
-function drainWarnings() {
-    if (pendingWarnings.length === 0)
-        return undefined;
-    const drained = [...pendingWarnings];
-    pendingWarnings.length = 0;
-    return drained;
-}
-/**
- * Create a LAFS-conformant _meta object for CLI envelopes.
- * Includes sessionId (T4702) and warnings (T4669) when present.
- *
- * @task T4700
- * @task T4702
- * @epic T4663
- */
-function createCliMeta(operation, mvi = 'standard') {
-    const warnings = drainWarnings();
-    const meta = {
-        specVersion: '1.2.3',
-        schemaVersion: '2026.2.1',
-        timestamp: new Date().toISOString(),
-        operation,
-        requestId: randomUUID(),
-        transport: 'cli',
-        strict: true,
-        mvi,
-        contextVersion: 1,
-        ...(warnings && { warnings }),
-    };
-    const sessionId = getCurrentSessionId();
-    if (sessionId) {
-        meta.sessionId = sessionId;
-    }
-    return meta;
-}
-/**
- * Format a successful result as a full LAFS-conformant envelope.
- *
- * Always produces the full LAFSEnvelope with $schema and _meta.
- * When operation is omitted, defaults to 'cli.output'.
- * Supports optional page (T4668) and _extensions (T4670).
- *
- * @task T4672
- * @task T4668
- * @task T4670
- * @epic T4663
- */
-export function formatSuccess(data, message, operationOrOpts) {
-    const opts = typeof operationOrOpts === 'string' ? { operation: operationOrOpts } : (operationOrOpts ?? {});
-    const envelope = {
-        $schema: 'https://lafs.dev/schemas/v1/envelope.schema.json',
-        _meta: createCliMeta(opts.operation ?? 'cli.output', opts.mvi),
-        success: true,
-        result: data,
-        ...(message && { message }),
-    };
-    if (opts.page) {
-        envelope['page'] = opts.page;
-    }
-    if (opts.extensions && Object.keys(opts.extensions).length > 0) {
-        envelope['_extensions'] = opts.extensions;
-    }
-    return JSON.stringify(envelope);
-}
-/**
- * Format an error as a full LAFS-conformant envelope.
- *
- * Always produces the full LAFSEnvelope with $schema and _meta.
- * When operation is omitted, defaults to 'cli.output'.
- *
- * @task T4672
- * @epic T4663
- */
-export function formatError(error, operation) {
-    const envelope = {
-        $schema: 'https://lafs.dev/schemas/v1/envelope.schema.json',
-        _meta: createCliMeta(operation ?? 'cli.output'),
-        success: false,
-        result: null,
-        error: error.toLAFSError(),
-    };
-    return JSON.stringify(envelope);
-}
-/** Format any result (success or error) as LAFS JSON. */
-export function formatOutput(result) {
-    if (result instanceof CleoError) {
-        return formatError(result);
-    }
-    return formatSuccess(result);
-}
-//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/pagination.d.ts

@@ -1,45 +0,0 @@
-/**
- * LAFS-compliant pagination utility for list commands.
- *
- * Wraps result arrays in LAFSPage offset pagination objects.
- * Supports both offset-based and cursor-based pagination modes.
- *
- * @task T4668
- * @epic T4663
- */
-import type { LAFSPage } from '@cleocode/lafs-protocol';
-/**
- * Input parameters for paginating a result set.
- *
- * @task T4668
- * @epic T4663
- */
-export interface PaginateInput {
-    /** Total number of items before pagination. */
-    total: number;
-    /** Number of items to return per page. */
-    limit?: number;
-    /** Number of items to skip. */
-    offset?: number;
-}
-/**
- * Create an LAFSPage object from pagination parameters.
- *
- * Returns mode:"none" when no pagination is requested (no limit/offset).
- * Returns mode:"offset" with hasMore/total when pagination is active.
- *
- * @task T4668
- * @epic T4663
- */
-export declare function createPage(input: PaginateInput): LAFSPage;
-/**
- * Apply pagination to an array of items and return the sliced result with page metadata.
- *
- * @task T4668
- * @epic T4663
- */
-export declare function paginate<T>(items: T[], limit?: number, offset?: number): {
-    items: T[];
-    page: LAFSPage;
-};
-//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAgC,MAAM,yBAAyB,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CAmBzD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAehC"}

package/dist/pagination.js

@@ -1,61 +0,0 @@
-/**
- * LAFS-compliant pagination utility for list commands.
- *
- * Wraps result arrays in LAFSPage offset pagination objects.
- * Supports both offset-based and cursor-based pagination modes.
- *
- * @task T4668
- * @epic T4663
- */
-/**
- * Default page size when limit is not specified.
- *
- * @task T4668
- */
-const DEFAULT_LIMIT = 50;
-/**
- * Create an LAFSPage object from pagination parameters.
- *
- * Returns mode:"none" when no pagination is requested (no limit/offset).
- * Returns mode:"offset" with hasMore/total when pagination is active.
- *
- * @task T4668
- * @epic T4663
- */
-export function createPage(input) {
-    const { total, limit, offset } = input;
-    // No pagination requested
-    if (limit === undefined && offset === undefined) {
-        return { mode: 'none' };
-    }
-    const effectiveLimit = limit ?? DEFAULT_LIMIT;
-    const effectiveOffset = offset ?? 0;
-    const hasMore = effectiveOffset + effectiveLimit < total;
-    return {
-        mode: 'offset',
-        limit: effectiveLimit,
-        offset: effectiveOffset,
-        hasMore,
-        total,
-    };
-}
-/**
- * Apply pagination to an array of items and return the sliced result with page metadata.
- *
- * @task T4668
- * @epic T4663
- */
-export function paginate(items, limit, offset) {
-    const total = items.length;
-    if (limit === undefined && offset === undefined) {
-        return { items, page: { mode: 'none' } };
-    }
-    const effectiveOffset = offset ?? 0;
-    const effectiveLimit = limit ?? DEFAULT_LIMIT;
-    const sliced = items.slice(effectiveOffset, effectiveOffset + effectiveLimit);
-    return {
-        items: sliced,
-        page: createPage({ total, limit: effectiveLimit, offset: effectiveOffset }),
-    };
-}
-//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;GAIG;AACH,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAEvC,0BAA0B;IAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAkB,CAAC;IAC1C,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,IAAI,aAAa,CAAC;IAC9C,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,eAAe,GAAG,cAAc,GAAG,KAAK,CAAC;IAEzD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,cAAc;QACrB,MAAM,EAAE,eAAe;QACvB,OAAO;QACP,KAAK;KACY,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAU,EACV,KAAc,EACd,MAAe;IAEf,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAE3B,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAkB,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,CAAC;IACpC,MAAM,cAAc,GAAG,KAAK,IAAI,aAAa,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC;IAE9E,OAAO;QACL,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;KAC5E,CAAC;AACJ,CAAC"}

package/dist/paths.d.ts

@@ -1,165 +0,0 @@
-/**
- * XDG-compliant path resolution for CLEO V2.
- *
- * Environment variables:
- *   CLEO_HOME   - Global installation directory (default: ~/.cleo)
- *   CLEO_DIR    - Project data directory (default: .cleo)
- *
- * @epic T4454
- * @task T4458
- */
-/**
- * Check if a CLEO project is initialized at the given root.
- * Checks for tasks.db.
- */
-export declare function isProjectInitialized(projectRoot?: string): boolean;
-/**
- * Get the global CLEO home directory.
- * Respects CLEO_HOME env var; otherwise uses the OS-appropriate data path
- * via env-paths (XDG_DATA_HOME on Linux, Library/Application Support on macOS,
- * %LOCALAPPDATA% on Windows).
- */
-export declare function getCleoHome(): string;
-/**
- * Get the global CLEO templates directory.
- */
-export declare function getCleoTemplatesDir(): string;
-/**
- * Get the global CLEO schemas directory.
- */
-export declare function getCleoSchemasDir(): string;
-/**
- * Get the global CLEO docs directory.
- */
-export declare function getCleoDocsDir(): string;
-/**
- * Get the project CLEO data directory (relative).
- * Respects CLEO_DIR env var, defaults to ".cleo".
- */
-export declare function getCleoDir(cwd?: string): string;
-/**
- * Get the absolute path to the project CLEO directory.
- */
-export declare function getCleoDirAbsolute(cwd?: string): string;
-/**
- * Get the project root from the CLEO directory.
- * Respects CLEO_ROOT env var, then derives from CLEO_DIR.
- * If CLEO_DIR is ".cleo", the project root is its parent.
- */
-export declare function getProjectRoot(cwd?: string): string;
-/**
- * Resolve a project-relative path to an absolute path.
- */
-export declare function resolveProjectPath(relativePath: string, cwd?: string): string;
-/**
- * Get the path to the project's tasks.db file (SQLite database).
- * @deprecated Use getAccessor() from './store/data-accessor.js' instead. This function
- *   returns the database file path for legacy compatibility, but all task data access
- *   should go through the DataAccessor interface to ensure proper SQLite interaction.
- *   Example:
- *     // OLD (deprecated):
- *     const taskPath = getTaskPath(cwd);
- *     const data = await readJsonFile<TaskFile>(taskPath);
- *     // NEW (correct):
- *     const accessor = await getAccessor(cwd);
- *     const data = await accessor.queryTasks({});
- */
-export declare function getTaskPath(cwd?: string): string;
-/**
- * Get the path to the project's config.json file.
- */
-export declare function getConfigPath(cwd?: string): string;
-/**
- * Get the path to the project's sessions.json file.
- */
-export declare function getSessionsPath(cwd?: string): string;
-/**
- * Get the path to the project's archive file.
- */
-export declare function getArchivePath(cwd?: string): string;
-/**
- * Get the path to the project's log file.
- * Canonical structured runtime log path (pino).
- * @task T4644
- */
-export declare function getLogPath(cwd?: string): string;
-/**
- * Get the backup directory for operational backups.
- */
-export declare function getBackupDir(cwd?: string): string;
-/**
- * Get the global config file path.
- */
-export declare function getGlobalConfigPath(): string;
-/**
- * Get the agent outputs directory (relative path) from config or default.
- *
- * Config lookup priority:
- *   1. config.agentOutputs.directory
- *   2. config.research.outputDir (deprecated)
- *   3. config.directories.agentOutputs (deprecated)
- *   4. Default: '.cleo/agent-outputs'
- *
- * @task T4700
- */
-export declare function getAgentOutputsDir(cwd?: string): string;
-/**
- * Get the absolute path to the agent outputs directory.
- * @task T4700
- */
-export declare function getAgentOutputsAbsolute(cwd?: string): string;
-/**
- * Get the absolute path to the MANIFEST.jsonl file.
- *
- * Checks config.agentOutputs.manifestFile for custom filename,
- * defaults to 'MANIFEST.jsonl'.
- *
- * @task T4700
- */
-export declare function getManifestPath(cwd?: string): string;
-/**
- * Get the absolute path to the MANIFEST.archive.jsonl file.
- * @task T4700
- */
-export declare function getManifestArchivePath(cwd?: string): string;
-/**
- * Check if a path is absolute (POSIX or Windows).
- */
-export declare function isAbsolutePath(path: string): boolean;
-/**
- * Get the OS log directory for CLEO global logs.
- * Linux: ~/.local/state/cleo | macOS: ~/Library/Logs/cleo | Windows: %LOCALAPPDATA%\cleo\Log
- */
-export declare function getCleoLogDir(): string;
-/**
- * Get the OS cache directory for CLEO.
- * Linux: ~/.cache/cleo | macOS: ~/Library/Caches/cleo | Windows: %LOCALAPPDATA%\cleo\Cache
- */
-export declare function getCleoCacheDir(): string;
-/**
- * Get the OS temp directory for CLEO ephemeral files.
- */
-export declare function getCleoTempDir(): string;
-/**
- * Get the OS config directory for CLEO.
- * Linux: ~/.config/cleo | macOS: ~/Library/Preferences/cleo | Windows: %APPDATA%\cleo\Config
- */
-export declare function getCleoConfigDir(): string;
-/**
- * Get the global agents hub directory.
- * Respects AGENTS_HOME env var, defaults to ~/.agents.
- */
-export declare function getAgentsHome(): string;
-/**
- * Get the Claude Code agents directory (~/.claude/agents by default).
- * @deprecated Use AdapterPathProvider.getAgentInstallDir() from the active adapter instead.
- */
-export declare function getClaudeAgentsDir(): string;
-/**
- * Get the claude-mem SQLite database path.
- * @deprecated Use AdapterPathProvider.getMemoryDbPath() from the active adapter instead.
- * Respects CLAUDE_MEM_DB env var, defaults to ~/.claude-mem/claude-mem.db.
- * This is a third-party tool path; homedir() is correct here (no env-paths standard).
- */
-export declare function getClaudeMemDbPath(): string;
-//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCvD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBpD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpD;AAMD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}