@cleocode/core 2026.3.38 → 2026.3.39

package/dist/lifecycle/rcasd-index.d.ts

@@ -1,168 +0,0 @@
-/**
- * RCASD-INDEX.json population and querying.
- *
- * Scans .cleo/rcasd/ and legacy .cleo/rcsd/ directories to build a master index of all RCASD
- * pipeline artifacts. Provides lookup functions for task-anchored artifacts,
- * specs, reports, and pipeline state.
- *
- * @task T4801
- * @epic T4798
- * @ref schemas/rcasd-index.schema.json (compat: rcsd-index.schema.json)
- */
-/** RCASD-INDEX.json top-level structure. */
-export interface RcasdIndex {
-    $schema: string;
-    _meta: IndexMeta;
-    authorities: Record<string, string>;
-    taskAnchored: Record<string, TaskAnchor>;
-    specs: SpecEntry[];
-    reports: ReportEntry[];
-    pipeline?: PipelineState;
-    recentChanges?: ChangeEntry[];
-}
-/** Index metadata. */
-export interface IndexMeta {
-    version: string;
-    lastUpdated: string;
-    totals: IndexTotals;
-    checksum?: string;
-}
-/** Aggregate counts. */
-export interface IndexTotals {
-    tasks: number;
-    specs: number;
-    reports: number;
-    activeResearch: number;
-    pendingConsensus: number;
-}
-/** Task-anchored RCASD artifact reference. */
-export interface TaskAnchor {
-    shortName: string;
-    directory: string;
-    spec?: string;
-    report?: string;
-    status?: 'active' | 'paused' | 'completed' | 'failed' | 'archived';
-    pipelineStage: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-/** Specification entry. */
-export interface SpecEntry {
-    file: string;
-    version: string;
-    status: 'DRAFT' | 'APPROVED' | 'ACTIVE' | 'IMMUTABLE' | 'DEPRECATED';
-    domain: string;
-    taskId: string;
-    lastUpdated: string;
-    category?: string;
-    shortName?: string;
-    synopsis?: string;
-}
-/** Report entry. */
-export interface ReportEntry {
-    file: string;
-    relatedSpec: string;
-    taskId: string;
-    progress: string;
-    lastUpdated: string;
-    phase?: string;
-    notes?: string;
-}
-/** Pipeline state. */
-export interface PipelineState {
-    activeOperations: PipelineOperation[];
-    queuedTasks: string[];
-    lastCompleted?: {
-        taskId: string;
-        stage: string;
-        completedAt: string;
-    };
-}
-/** Active pipeline operation. */
-export interface PipelineOperation {
-    operationId: string;
-    taskId: string;
-    stage: string;
-    startedAt: string;
-    progress?: number;
-    message?: string;
-}
-/** Change entry. */
-export interface ChangeEntry {
-    timestamp: string;
-    taskId: string;
-    changeType: string;
-    stage?: string;
-    description: string;
-}
-/**
- * Scan .cleo/rcasd/ and legacy .cleo/rcsd/ directories and build the RCASD index.
- *
- * Reads all _manifest.json files and any spec/report markdown files to
- * produce a complete index.
- *
- * @param cwd - Working directory
- * @returns Populated RcasdIndex
- * @task T4801
- */
-export declare function buildIndex(cwd?: string): RcasdIndex;
-/**
- * Write RCASD-INDEX.json to disk.
- *
- * @param index - The index to write
- * @param cwd - Working directory
- * @task T4801
- */
-export declare function writeIndex(index: RcasdIndex, cwd?: string): void;
-/**
- * Read RCASD-INDEX.json from disk.
- *
- * @param cwd - Working directory
- * @returns The index or null if not found
- * @task T4801
- */
-export declare function readIndex(cwd?: string): RcasdIndex | null;
-/**
- * Rebuild and write the index from current disk state.
- *
- * @param cwd - Working directory
- * @returns The rebuilt index
- * @task T4801
- */
-export declare function rebuildIndex(cwd?: string): RcasdIndex;
-/**
- * Get task anchor by task ID.
- *
- * @param taskId - The task ID to look up
- * @param cwd - Working directory
- * @returns TaskAnchor or null
- * @task T4801
- */
-export declare function getTaskAnchor(taskId: string, cwd?: string): TaskAnchor | null;
-/**
- * Find tasks by pipeline stage.
- *
- * @param stage - The pipeline stage to filter by
- * @param cwd - Working directory
- * @returns Array of [taskId, anchor] pairs
- * @task T4801
- */
-export declare function findByStage(stage: string, cwd?: string): Array<[string, TaskAnchor]>;
-/**
- * Find tasks by status.
- *
- * @param status - The status to filter by
- * @param cwd - Working directory
- * @returns Array of [taskId, anchor] pairs
- * @task T4801
- */
-export declare function findByStatus(status: 'active' | 'paused' | 'completed' | 'failed' | 'archived', cwd?: string): Array<[string, TaskAnchor]>;
-/**
- * Get index summary statistics.
- *
- * @param cwd - Working directory
- * @returns Index totals or null
- * @task T4801
- */
-export declare function getIndexTotals(cwd?: string): IndexTotals | null;
-//# sourceMappingURL=rcasd-index.d.ts.map

package/dist/lifecycle/rcasd-index.d.ts.map

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

package/dist/lifecycle/rcasd-index.js

@@ -1,326 +0,0 @@
-/**
- * RCASD-INDEX.json population and querying.
- *
- * Scans .cleo/rcasd/ and legacy .cleo/rcsd/ directories to build a master index of all RCASD
- * pipeline artifacts. Provides lookup functions for task-anchored artifacts,
- * specs, reports, and pipeline state.
- *
- * @task T4801
- * @epic T4798
- * @ref schemas/rcasd-index.schema.json (compat: rcsd-index.schema.json)
- */
-import { existsSync, mkdirSync, readdirSync } from 'node:fs';
-import { join } from 'node:path';
-import { readJsonFile, writeJsonFileAtomic } from '../store/file-utils.js';
-import { getCleoDirAbsolute } from '../paths.js';
-// =============================================================================
-// INDEX POPULATION
-// =============================================================================
-/**
- * Scan .cleo/rcasd/ and legacy .cleo/rcsd/ directories and build the RCASD index.
- *
- * Reads all _manifest.json files and any spec/report markdown files to
- * produce a complete index.
- *
- * @param cwd - Working directory
- * @returns Populated RcasdIndex
- * @task T4801
- */
-export function buildIndex(cwd) {
-    const cleoDir = getCleoDirAbsolute(cwd);
-    const lifecycleDirs = [join(cleoDir, 'rcasd'), join(cleoDir, 'rcsd')];
-    const seenTaskIds = new Set();
-    const taskAnchored = {};
-    const specs = [];
-    const reports = [];
-    let activeResearch = 0;
-    let pendingConsensus = 0;
-    let lastCompleted;
-    for (const lifecycleDir of lifecycleDirs) {
-        if (!existsSync(lifecycleDir)) {
-            continue;
-        }
-        const entries = readdirSync(lifecycleDir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isDirectory() || !entry.name.startsWith('T') || seenTaskIds.has(entry.name)) {
-                continue;
-            }
-            const taskId = entry.name;
-            seenTaskIds.add(taskId);
-            const taskDir = join(lifecycleDir, taskId);
-            // Read _manifest.json if it exists
-            const manifestPath = join(taskDir, '_manifest.json');
-            let manifest = null;
-            if (existsSync(manifestPath)) {
-                try {
-                    manifest = readJsonFile(manifestPath);
-                }
-                catch {
-                    // Skip corrupted manifests
-                    continue;
-                }
-            }
-            // Determine pipeline stage and status
-            const { currentStage, status } = determinePipelineState(manifest);
-            // Track research/consensus counts
-            if (manifest?.stages) {
-                const researchStatus = manifest.stages['research']?.status;
-                const consensusStatus = manifest.stages['consensus']?.status;
-                if (researchStatus && researchStatus !== 'completed' && researchStatus !== 'skipped') {
-                    activeResearch++;
-                }
-                if (researchStatus === 'completed' &&
-                    (!consensusStatus || consensusStatus === 'not_started' || consensusStatus === 'pending')) {
-                    pendingConsensus++;
-                }
-                // Track last completed
-                for (const [, stageData] of Object.entries(manifest.stages)) {
-                    if (stageData.status === 'completed' && stageData.completedAt) {
-                        if (!lastCompleted || stageData.completedAt > lastCompleted.completedAt) {
-                            lastCompleted = {
-                                taskId,
-                                stage: currentStage,
-                                completedAt: stageData.completedAt,
-                            };
-                        }
-                    }
-                }
-            }
-            // Scan for spec and report files
-            if (!existsSync(taskDir))
-                continue;
-            const files = readdirSync(taskDir).filter((f) => f.endsWith('.md'));
-            const specFile = files.find((f) => f.includes('-SPEC.md') || f.includes('_spec'));
-            const reportFile = files.find((f) => f.includes('-REPORT.md') || f.includes('_report') || f.includes('_research'));
-            // Derive short name from directory name
-            const shortName = deriveShortName(taskId, manifest?.title);
-            taskAnchored[taskId] = {
-                shortName,
-                directory: taskId,
-                spec: specFile,
-                report: reportFile,
-                status,
-                pipelineStage: currentStage,
-                updatedAt: new Date().toISOString(),
-            };
-            // Add spec entry if found
-            if (specFile) {
-                specs.push({
-                    file: specFile,
-                    version: '1.0.0',
-                    status: status === 'completed' ? 'ACTIVE' : 'DRAFT',
-                    domain: shortName,
-                    taskId,
-                    lastUpdated: new Date().toISOString(),
-                });
-            }
-            // Add report entry if found
-            if (reportFile) {
-                const relatedSpec = specFile || `${shortName}-SPEC.md`;
-                reports.push({
-                    file: reportFile,
-                    relatedSpec,
-                    taskId,
-                    progress: status === 'completed' ? '100%' : 'Varies',
-                    lastUpdated: new Date().toISOString(),
-                });
-            }
-        }
-    }
-    const now = new Date().toISOString();
-    return {
-        $schema: 'https://cleo-dev.com/schemas/v1/rcasd-index.schema.json',
-        _meta: {
-            version: '1.0.0',
-            lastUpdated: now,
-            totals: {
-                tasks: Object.keys(taskAnchored).length,
-                specs: specs.length,
-                reports: reports.length,
-                activeResearch,
-                pendingConsensus,
-            },
-        },
-        authorities: {},
-        taskAnchored,
-        specs,
-        reports,
-        pipeline: {
-            activeOperations: [],
-            queuedTasks: [],
-            lastCompleted,
-        },
-        recentChanges: [],
-    };
-}
-/**
- * Write RCASD-INDEX.json to disk.
- *
- * @param index - The index to write
- * @param cwd - Working directory
- * @task T4801
- */
-export function writeIndex(index, cwd) {
-    const cleoDir = getCleoDirAbsolute(cwd);
-    if (!existsSync(cleoDir)) {
-        mkdirSync(cleoDir, { recursive: true });
-    }
-    const indexPath = join(cleoDir, 'RCASD-INDEX.json');
-    writeJsonFileAtomic(indexPath, index);
-}
-/**
- * Read RCASD-INDEX.json from disk.
- *
- * @param cwd - Working directory
- * @returns The index or null if not found
- * @task T4801
- */
-export function readIndex(cwd) {
-    const cleoDir = getCleoDirAbsolute(cwd);
-    const indexPath = join(cleoDir, 'RCASD-INDEX.json');
-    if (!existsSync(indexPath)) {
-        return null;
-    }
-    try {
-        return readJsonFile(indexPath);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Rebuild and write the index from current disk state.
- *
- * @param cwd - Working directory
- * @returns The rebuilt index
- * @task T4801
- */
-export function rebuildIndex(cwd) {
-    const index = buildIndex(cwd);
-    writeIndex(index, cwd);
-    return index;
-}
-// =============================================================================
-// QUERYING
-// =============================================================================
-/**
- * Get task anchor by task ID.
- *
- * @param taskId - The task ID to look up
- * @param cwd - Working directory
- * @returns TaskAnchor or null
- * @task T4801
- */
-export function getTaskAnchor(taskId, cwd) {
-    const index = readIndex(cwd);
-    return index?.taskAnchored[taskId] ?? null;
-}
-/**
- * Find tasks by pipeline stage.
- *
- * @param stage - The pipeline stage to filter by
- * @param cwd - Working directory
- * @returns Array of [taskId, anchor] pairs
- * @task T4801
- */
-export function findByStage(stage, cwd) {
-    const index = readIndex(cwd);
-    if (!index)
-        return [];
-    return Object.entries(index.taskAnchored).filter(([, anchor]) => anchor.pipelineStage === stage);
-}
-/**
- * Find tasks by status.
- *
- * @param status - The status to filter by
- * @param cwd - Working directory
- * @returns Array of [taskId, anchor] pairs
- * @task T4801
- */
-export function findByStatus(status, cwd) {
-    const index = readIndex(cwd);
-    if (!index)
-        return [];
-    return Object.entries(index.taskAnchored).filter(([, anchor]) => anchor.status === status);
-}
-/**
- * Get index summary statistics.
- *
- * @param cwd - Working directory
- * @returns Index totals or null
- * @task T4801
- */
-export function getIndexTotals(cwd) {
-    const index = readIndex(cwd);
-    return index?._meta.totals ?? null;
-}
-// =============================================================================
-// INTERNAL HELPERS
-// =============================================================================
-/**
- * Determine the current pipeline stage and status from a manifest.
- * @task T4801
- */
-function determinePipelineState(manifest) {
-    if (!manifest?.stages) {
-        return { currentStage: 'initialized', status: 'active' };
-    }
-    // Walk stages in reverse order to find the most advanced completed stage
-    const stageOrder = [
-        'release',
-        'testing',
-        'validation',
-        'implementation',
-        'decomposition',
-        'specification',
-        'consensus',
-        'research',
-    ];
-    let mostAdvancedCompleted = null;
-    const hasFailed = false;
-    let hasBlocked = false;
-    for (const stageName of stageOrder) {
-        const stageData = manifest.stages[stageName];
-        if (!stageData)
-            continue;
-        if (stageData.status === 'completed') {
-            if (!mostAdvancedCompleted) {
-                mostAdvancedCompleted = stageName;
-            }
-        }
-        if (stageData.status === 'blocked')
-            hasBlocked = true;
-    }
-    // Determine current stage
-    const currentStage = mostAdvancedCompleted || 'research';
-    // Determine status
-    let status;
-    if (hasFailed) {
-        status = 'failed';
-    }
-    else if (hasBlocked) {
-        status = 'paused';
-    }
-    else if (mostAdvancedCompleted === 'release') {
-        status = 'completed';
-    }
-    else {
-        status = 'active';
-    }
-    return { currentStage, status };
-}
-/**
- * Derive a short kebab-case name from task ID and optional title.
- * @task T4801
- */
-function deriveShortName(taskId, title) {
-    if (title) {
-        return title
-            .toLowerCase()
-            .replace(/[^a-z0-9\s-]/g, '')
-            .replace(/\s+/g, '-')
-            .slice(0, 25);
-    }
-    return taskId.toLowerCase();
-}
-//# sourceMappingURL=rcasd-index.js.map

package/dist/lifecycle/rcasd-index.js.map

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

package/dist/lifecycle/rcasd-paths.d.ts

@@ -1,103 +0,0 @@
-/**
- * Canonical RCASD path helpers for provenance file management.
- *
- * All provenance artifacts live under `.cleo/rcasd/{epicId}/` with
- * stage subdirectories created on-demand.
- *
- * @task T5200
- * @epic T4798
- */
-/**
- * Strip suffixes from epic directory names.
- * E.g. `T4881_install-channels` -> `T4881`
- *
- * @param dirName - Directory name that may contain a suffix
- * @returns The normalized T#### epic ID
- */
-export declare function normalizeEpicId(dirName: string): string;
-/**
- * Get the absolute path to the `.cleo/rcasd/` base directory.
- *
- * @param cwd - Optional working directory override
- * @returns Absolute path to the rcasd base directory
- */
-export declare function getRcasdBaseDir(cwd?: string): string;
-/**
- * Get the absolute path to `.cleo/rcasd/{epicId}/`.
- * Uses the normalized epic ID (without suffixes).
- *
- * @param epicId - Epic identifier (e.g. `T4881`)
- * @param cwd - Optional working directory override
- * @returns Absolute path to the epic directory
- */
-export declare function getEpicDir(epicId: string, cwd?: string): string;
-/**
- * Search both `rcasd/` and legacy `rcsd/` for an existing epic directory.
- * Also checks suffixed directory names (e.g. `T4881_install-channels`
- * matches `T4881`).
- *
- * @param epicId - Epic identifier to search for
- * @param cwd - Optional working directory override
- * @returns Absolute path to the found directory, or null
- */
-export declare function findEpicDir(epicId: string, cwd?: string): string | null;
-/**
- * Get the stage subdirectory path for an epic.
- * Uses STAGE_SUBDIRS mapping, falling back to the raw stage name.
- *
- * @param epicId - Epic identifier
- * @param stage - Canonical stage name (e.g. `research`, `contribution`)
- * @param cwd - Optional working directory override
- * @returns Absolute path to the stage subdirectory
- */
-export declare function getStagePath(epicId: string, stage: string, cwd?: string): string;
-/**
- * Get the stage subdirectory path, creating it if it does not exist.
- *
- * @param epicId - Epic identifier
- * @param stage - Canonical stage name
- * @param cwd - Optional working directory override
- * @returns Absolute path to the (now existing) stage subdirectory
- */
-export declare function ensureStagePath(epicId: string, stage: string, cwd?: string): string;
-/**
- * Get the manifest path for an epic under the default rcasd directory.
- *
- * @param epicId - Epic identifier
- * @param cwd - Optional working directory override
- * @returns Absolute path to `.cleo/rcasd/{epicId}/_manifest.json`
- */
-export declare function getManifestPath(epicId: string, cwd?: string): string;
-/**
- * Search both `rcasd/` and `rcsd/` for an existing manifest file.
- * Checks suffixed directory names as well.
- *
- * @param epicId - Epic identifier
- * @param cwd - Optional working directory override
- * @returns Absolute path to the found manifest, or null
- */
-export declare function findManifestPath(epicId: string, cwd?: string): string | null;
-/**
- * Scan the rcasd root directory for loose `T####_*.md` files that are
- * not inside subdirectories.
- *
- * @param cwd - Optional working directory override
- * @returns Array of file info with extracted epic ID
- */
-export declare function getLooseResearchFiles(cwd?: string): Array<{
-    file: string;
-    epicId: string;
-    fullPath: string;
-}>;
-/**
- * List all epic directories across `rcasd/` and `rcsd/`.
- *
- * @param cwd - Optional working directory override
- * @returns Array of epic info with normalized IDs and original directory names
- */
-export declare function listEpicDirs(cwd?: string): Array<{
-    epicId: string;
-    dirName: string;
-    fullPath: string;
-}>;
-//# sourceMappingURL=rcasd-paths.d.ts.map

package/dist/lifecycle/rcasd-paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rcasd-paths.d.ts","sourceRoot":"","sources":["../../src/lifecycle/rcasd-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0BvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMnF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,CAAC,EAAE,MAAM,GACX,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,CAAC,EAAE,MAAM,GACX,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC9D"}