@cleocode/core 2026.4.13 → 2026.4.14

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 { getCleoDirAbsolute } from '../paths.js';
-import { readJsonFile, writeJsonFileAtomic } from '../store/file-utils.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.js

@@ -1,220 +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
- */
-import { existsSync, mkdirSync, readdirSync } from 'node:fs';
-import { join } from 'node:path';
-import { getCleoDirAbsolute } from '../paths.js';
-// Stage subdirectory names (mapped from canonical stage names in stages.ts)
-const STAGE_SUBDIRS = {
-    research: 'research',
-    consensus: 'consensus',
-    architecture_decision: 'architecture',
-    specification: 'specification',
-    decomposition: 'decomposition',
-    contribution: 'contributions',
-};
-const LIFECYCLE_DATA_DIRS = ['rcasd', 'rcsd'];
-const DEFAULT_DIR = 'rcasd';
-// Pattern for epic IDs: T followed by one or more digits
-const EPIC_ID_PATTERN = /^(T\d+)/;
-/**
- * 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 function normalizeEpicId(dirName) {
-    const match = dirName.match(EPIC_ID_PATTERN);
-    return match ? match[1] : dirName;
-}
-/**
- * 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 function getRcasdBaseDir(cwd) {
-    return join(getCleoDirAbsolute(cwd), DEFAULT_DIR);
-}
-/**
- * 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 function getEpicDir(epicId, cwd) {
-    const normalized = normalizeEpicId(epicId);
-    return join(getCleoDirAbsolute(cwd), DEFAULT_DIR, normalized);
-}
-/**
- * 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 function findEpicDir(epicId, cwd) {
-    const normalized = normalizeEpicId(epicId);
-    const cleoDir = getCleoDirAbsolute(cwd);
-    for (const dirName of LIFECYCLE_DATA_DIRS) {
-        const baseDir = join(cleoDir, dirName);
-        if (!existsSync(baseDir))
-            continue;
-        // Check exact match first
-        const exactPath = join(baseDir, normalized);
-        if (existsSync(exactPath))
-            return exactPath;
-        // Check suffixed directories
-        try {
-            const entries = readdirSync(baseDir, { withFileTypes: true });
-            for (const entry of entries) {
-                if (entry.isDirectory() && normalizeEpicId(entry.name) === normalized) {
-                    return join(baseDir, entry.name);
-                }
-            }
-        }
-        catch {
-            // Directory not readable, skip
-        }
-    }
-    return 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 function getStagePath(epicId, stage, cwd) {
-    const subdir = STAGE_SUBDIRS[stage] ?? stage;
-    return join(getEpicDir(epicId, cwd), subdir);
-}
-/**
- * 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 function ensureStagePath(epicId, stage, cwd) {
-    const path = getStagePath(epicId, stage, cwd);
-    if (!existsSync(path)) {
-        mkdirSync(path, { recursive: true });
-    }
-    return path;
-}
-/**
- * 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 function getManifestPath(epicId, cwd) {
-    return join(getEpicDir(epicId, cwd), '_manifest.json');
-}
-/**
- * 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 function findManifestPath(epicId, cwd) {
-    const epicDir = findEpicDir(epicId, cwd);
-    if (!epicDir)
-        return null;
-    const manifestPath = join(epicDir, '_manifest.json');
-    return existsSync(manifestPath) ? manifestPath : 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 function getLooseResearchFiles(cwd) {
-    const baseDir = getRcasdBaseDir(cwd);
-    if (!existsSync(baseDir))
-        return [];
-    const results = [];
-    const looseFilePattern = /^(T\d+)_.+\.md$/;
-    try {
-        const entries = readdirSync(baseDir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isFile())
-                continue;
-            const match = entry.name.match(looseFilePattern);
-            if (match) {
-                results.push({
-                    file: entry.name,
-                    epicId: match[1],
-                    fullPath: join(baseDir, entry.name),
-                });
-            }
-        }
-    }
-    catch {
-        // Directory not readable
-    }
-    return results;
-}
-/**
- * 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 function listEpicDirs(cwd) {
-    const cleoDir = getCleoDirAbsolute(cwd);
-    const results = [];
-    const seen = new Set();
-    for (const dirName of LIFECYCLE_DATA_DIRS) {
-        const baseDir = join(cleoDir, dirName);
-        if (!existsSync(baseDir))
-            continue;
-        try {
-            const entries = readdirSync(baseDir, { withFileTypes: true });
-            for (const entry of entries) {
-                if (!entry.isDirectory())
-                    continue;
-                const normalized = normalizeEpicId(entry.name);
-                // Only include directories that look like epic IDs
-                if (!EPIC_ID_PATTERN.test(entry.name))
-                    continue;
-                // Deduplicate: prefer the first occurrence (rcasd over rcsd)
-                const key = `${normalized}:${entry.name}`;
-                if (seen.has(key))
-                    continue;
-                seen.add(key);
-                results.push({
-                    epicId: normalized,
-                    dirName: entry.name,
-                    fullPath: join(baseDir, entry.name),
-                });
-            }
-        }
-        catch {
-            // Directory not readable
-        }
-    }
-    return results;
-}
-//# sourceMappingURL=rcasd-paths.js.map

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

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