@cleocode/core 2026.3.41 → 2026.3.43

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

@@ -0,0 +1,168 @@
+/**
+ * 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

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

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

@@ -0,0 +1,103 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}