@cleocode/core 2026.4.9 → 2026.4.12

package/dist/lifecycle/evidence.js

@@ -0,0 +1,180 @@
+/**
+ * Evidence recording for RCASD lifecycle stages.
+ *
+ * Records provenance evidence (files, URLs, manifests) linked to
+ * lifecycle stages in SQLite.
+ *
+ * @task T5200
+ * @epic T4798
+ */
+import { basename, relative } from 'node:path';
+import { getLogger } from '../logger.js';
+import { getCleoDirAbsolute } from '../paths.js';
+import * as schema from '../store/tasks-schema.js';
+const log = getLogger('lifecycle:evidence');
+// =============================================================================
+// RECORD EVIDENCE
+// =============================================================================
+/**
+ * Record an evidence artifact linked to a lifecycle stage.
+ *
+ * Writes to the SQLite `lifecycle_evidence` table.
+ *
+ * @param epicId - Epic task ID (e.g. 'T4881')
+ * @param stage - Canonical stage name (e.g. 'research')
+ * @param uri - URI of the evidence artifact
+ * @param type - Evidence type: 'file', 'url', or 'manifest'
+ * @param options - Optional agent and description
+ * @returns The created evidence record
+ */
+export async function recordEvidence(epicId, stage, uri, type, options) {
+    const now = new Date().toISOString();
+    const stageId = `stage-${epicId}-${stage}`;
+    const id = `evidence-${epicId}-${stage}-${Date.now()}`;
+    const record = {
+        id,
+        stageId,
+        uri,
+        type,
+        recordedAt: now,
+        recordedBy: options?.agent,
+        description: options?.description,
+    };
+    // SQLite write (best-effort)
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const db = await getDb(options?.cwd);
+        await db
+            .insert(schema.lifecycleEvidence)
+            .values({
+            id,
+            stageId,
+            uri,
+            type,
+            recordedAt: now,
+            recordedBy: options?.agent ?? null,
+            description: options?.description ?? null,
+        })
+            .run();
+    }
+    catch (err) {
+        log.warn({ err }, 'Failed to write evidence to SQLite');
+    }
+    return record;
+}
+// =============================================================================
+// GET EVIDENCE
+// =============================================================================
+/**
+ * Query evidence records for an epic, optionally filtered by stage.
+ *
+ * @param epicId - Epic task ID
+ * @param stage - Optional stage name filter
+ * @param cwd - Optional working directory
+ * @returns Array of evidence records
+ */
+export async function getEvidence(epicId, stage, cwd) {
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const { eq, like } = await import('drizzle-orm');
+        const db = await getDb(cwd);
+        let rows;
+        if (stage) {
+            const stageId = `stage-${epicId}-${stage}`;
+            rows = await db
+                .select()
+                .from(schema.lifecycleEvidence)
+                .where(eq(schema.lifecycleEvidence.stageId, stageId))
+                .all();
+        }
+        else {
+            const stageIdPrefix = `stage-${epicId}-`;
+            rows = await db
+                .select()
+                .from(schema.lifecycleEvidence)
+                .where(like(schema.lifecycleEvidence.stageId, `${stageIdPrefix}%`))
+                .all();
+        }
+        return rows.map((row) => ({
+            id: row.id,
+            stageId: row.stageId,
+            uri: row.uri,
+            type: row.type,
+            recordedAt: row.recordedAt,
+            recordedBy: row.recordedBy ?? undefined,
+            description: row.description ?? undefined,
+        }));
+    }
+    catch (err) {
+        log.warn({ err }, 'Failed to query evidence');
+        return [];
+    }
+}
+// =============================================================================
+// LINK PROVENANCE
+// =============================================================================
+/**
+ * Convenience wrapper to record a file as provenance evidence.
+ *
+ * Converts the file path to a URI relative to the `.cleo/` directory,
+ * sets the type to 'file', and extracts a description from the filename.
+ *
+ * @param epicId - Epic task ID
+ * @param stage - Canonical stage name
+ * @param filePath - Absolute or relative path to the file
+ * @param cwd - Optional working directory
+ * @returns The created evidence record
+ */
+export async function linkProvenance(epicId, stage, filePath, cwd) {
+    const cleoDir = getCleoDirAbsolute(cwd);
+    const relativeUri = relative(cleoDir, filePath).replaceAll('\\', '/');
+    const description = basename(filePath);
+    return recordEvidence(epicId, stage, relativeUri, 'file', {
+        description,
+        cwd,
+    });
+}
+// =============================================================================
+// EVIDENCE SUMMARY
+// =============================================================================
+/**
+ * Aggregate evidence counts per stage for an epic.
+ *
+ * @param epicId - Epic task ID
+ * @param cwd - Optional working directory
+ * @returns Array of per-stage summaries with type breakdowns
+ */
+export async function getEvidenceSummary(epicId, cwd) {
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const { like } = await import('drizzle-orm');
+        const db = await getDb(cwd);
+        const stageIdPrefix = `stage-${epicId}-`;
+        const rows = await db
+            .select()
+            .from(schema.lifecycleEvidence)
+            .where(like(schema.lifecycleEvidence.stageId, `${stageIdPrefix}%`))
+            .all();
+        // Group by stage
+        const stageMap = new Map();
+        for (const row of rows) {
+            const stage = row.stageId.replace(stageIdPrefix, '');
+            if (!stageMap.has(stage)) {
+                stageMap.set(stage, { count: 0, types: { file: 0, url: 0, manifest: 0 } });
+            }
+            const entry = stageMap.get(stage);
+            entry.count++;
+            entry.types[row.type]++;
+        }
+        return Array.from(stageMap.entries()).map(([stage, data]) => ({
+            stage,
+            count: data.count,
+            types: data.types,
+        }));
+    }
+    catch (err) {
+        log.warn({ err }, 'Failed to get evidence summary');
+        return [];
+    }
+}
+//# sourceMappingURL=evidence.js.map

package/dist/lifecycle/evidence.js.map

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

package/dist/lifecycle/frontmatter.js

@@ -0,0 +1,363 @@
+/**
+ * YAML frontmatter parser/writer for RCASD provenance files.
+ *
+ * Provides Obsidian-like backlinks via YAML frontmatter blocks
+ * (delimited by `---`). No YAML library dependency — uses
+ * simple key-value parsing for the supported fields.
+ *
+ * @task T5200
+ * @epic T4798
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { getRcasdBaseDir } from './rcasd-paths.js';
+// =============================================================================
+// PARSING
+// =============================================================================
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?/;
+/**
+ * Parse a simple YAML value string into a typed value.
+ * Handles quoted strings, booleans, null, and bare strings.
+ */
+function parseScalar(value) {
+    const trimmed = value.trim();
+    // Quoted strings — strip quotes
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    // Booleans
+    if (trimmed === 'true')
+        return true;
+    if (trimmed === 'false')
+        return false;
+    // Null
+    if (trimmed === 'null' || trimmed === '~')
+        return null;
+    return trimmed;
+}
+/**
+ * Parse YAML frontmatter content (the text between `---` delimiters)
+ * into a FrontmatterMetadata object.
+ *
+ * Supports:
+ * - Top-level scalar fields: `key: value`
+ * - Top-level array of objects: `related:` followed by `  - type: X\n    path: Y`
+ */
+function parseYamlContent(yaml) {
+    const result = {};
+    const lines = yaml.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Skip blank lines
+        if (line.trim() === '') {
+            i++;
+            continue;
+        }
+        // Top-level key: value
+        const kvMatch = line.match(/^(\w[\w-]*)\s*:\s*(.*)/);
+        if (!kvMatch) {
+            i++;
+            continue;
+        }
+        const key = kvMatch[1];
+        const inlineValue = kvMatch[2].trim();
+        // If value is present inline, it's a scalar
+        if (inlineValue !== '') {
+            const parsed = parseScalar(inlineValue);
+            result[key] = parsed === null ? undefined : parsed;
+            i++;
+            continue;
+        }
+        // Value is empty — check for array items on subsequent lines
+        const items = [];
+        i++;
+        while (i < lines.length) {
+            const nextLine = lines[i];
+            // Blank line within array block — skip
+            if (nextLine.trim() === '') {
+                i++;
+                continue;
+            }
+            // Array item start: `  - key: value`
+            const itemMatch = nextLine.match(/^\s+-\s+(\w[\w-]*)\s*:\s*(.*)/);
+            if (!itemMatch) {
+                // Not an array item — we've exited the array block
+                break;
+            }
+            const itemObj = {};
+            const firstKey = itemMatch[1];
+            const firstValue = parseScalar(itemMatch[2]);
+            itemObj[firstKey] = firstValue === null ? undefined : firstValue;
+            i++;
+            // Read continuation lines for this array item (indented key: value, no `-`)
+            while (i < lines.length) {
+                const contLine = lines[i];
+                // Must be indented but NOT start a new array item
+                const contMatch = contLine.match(/^\s{4,}(\w[\w-]*)\s*:\s*(.*)/);
+                if (!contMatch)
+                    break;
+                const contKey = contMatch[1];
+                const contValue = parseScalar(contMatch[2]);
+                itemObj[contKey] = contValue === null ? undefined : contValue;
+                i++;
+            }
+            items.push(itemObj);
+        }
+        if (items.length > 0) {
+            result[key] = items;
+        }
+    }
+    return result;
+}
+/**
+ * Parse YAML frontmatter from a markdown string.
+ *
+ * Finds the YAML block delimited by `---` at the start of the file,
+ * parses key-value pairs, and returns the structured metadata plus
+ * the remaining body content.
+ *
+ * @param content - Full markdown file content
+ * @returns Parsed frontmatter, body, and raw YAML block
+ */
+export function parseFrontmatter(content) {
+    const match = content.match(FRONTMATTER_RE);
+    if (!match) {
+        return {
+            frontmatter: null,
+            body: content,
+            raw: '',
+        };
+    }
+    const raw = match[0];
+    const yamlContent = match[1];
+    const body = content.slice(raw.length);
+    return {
+        frontmatter: parseYamlContent(yamlContent),
+        body,
+        raw,
+    };
+}
+// =============================================================================
+// SERIALIZATION
+// =============================================================================
+/**
+ * Serialize a scalar value for YAML output.
+ * Wraps strings containing special characters in quotes.
+ */
+function serializeScalar(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'boolean')
+        return String(value);
+    const str = String(value);
+    // Quote strings that contain YAML-special characters
+    if (str.includes(':') || str.includes('#') || str.includes('{') || str.includes('}')) {
+        return `"${str.replace(/"/g, '\\"')}"`;
+    }
+    return str;
+}
+/**
+ * Convert a FrontmatterMetadata object to a YAML frontmatter string.
+ *
+ * Output format:
+ * ```
+ * ---
+ * epic: T4881
+ * stage: research
+ * related:
+ *   - type: consensus
+ *     path: ../consensus/consensus-report.md
+ * created: 2026-02-15
+ * ---
+ * ```
+ *
+ * @param metadata - The frontmatter metadata to serialize
+ * @returns YAML frontmatter string including `---` delimiters
+ */
+export function serializeFrontmatter(metadata) {
+    const lines = ['---'];
+    // Ordered keys: epic, stage, task first, then related, then dates, then rest
+    const orderedKeys = ['epic', 'stage', 'task'];
+    const dateKeys = ['created', 'updated'];
+    const processedKeys = new Set();
+    // Write ordered keys first
+    for (const key of orderedKeys) {
+        if (key in metadata && metadata[key] !== undefined) {
+            lines.push(`${key}: ${serializeScalar(metadata[key])}`);
+            processedKeys.add(key);
+        }
+    }
+    // Write related array
+    if (metadata.related && metadata.related.length > 0) {
+        lines.push('related:');
+        for (const link of metadata.related) {
+            const entries = Object.entries(link).filter(([_, v]) => v !== undefined);
+            if (entries.length === 0)
+                continue;
+            const [firstKey, firstValue] = entries[0];
+            lines.push(`  - ${firstKey}: ${serializeScalar(firstValue)}`);
+            for (let i = 1; i < entries.length; i++) {
+                const [k, v] = entries[i];
+                lines.push(`    ${k}: ${serializeScalar(v)}`);
+            }
+        }
+        processedKeys.add('related');
+    }
+    // Write date keys
+    for (const key of dateKeys) {
+        if (key in metadata && metadata[key] !== undefined) {
+            lines.push(`${key}: ${serializeScalar(metadata[key])}`);
+            processedKeys.add(key);
+        }
+    }
+    // Write remaining keys
+    for (const [key, value] of Object.entries(metadata)) {
+        if (processedKeys.has(key))
+            continue;
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            // Generic array serialization
+            lines.push(`${key}:`);
+            for (const item of value) {
+                if (typeof item === 'object' && item !== null) {
+                    const entries = Object.entries(item).filter(([_, v]) => v !== undefined);
+                    if (entries.length === 0)
+                        continue;
+                    const [firstKey, firstValue] = entries[0];
+                    lines.push(`  - ${firstKey}: ${serializeScalar(firstValue)}`);
+                    for (let j = 1; j < entries.length; j++) {
+                        const [k, v] = entries[j];
+                        lines.push(`    ${k}: ${serializeScalar(v)}`);
+                    }
+                }
+                else {
+                    lines.push(`  - ${serializeScalar(item)}`);
+                }
+            }
+        }
+        else {
+            lines.push(`${key}: ${serializeScalar(value)}`);
+        }
+    }
+    lines.push('---');
+    return lines.join('\n') + '\n';
+}
+// =============================================================================
+// CONTENT MANIPULATION
+// =============================================================================
+/**
+ * Add or replace YAML frontmatter in markdown content.
+ *
+ * If the content already has a frontmatter block, it is replaced.
+ * Otherwise the YAML block is prepended.
+ *
+ * @param content - Original markdown content
+ * @param metadata - Frontmatter metadata to set
+ * @returns Updated content with new frontmatter
+ */
+export function addFrontmatter(content, metadata) {
+    const parsed = parseFrontmatter(content);
+    const serialized = serializeFrontmatter(metadata);
+    if (parsed.frontmatter !== null) {
+        // Replace existing frontmatter
+        return serialized + parsed.body;
+    }
+    // Prepend new frontmatter
+    return serialized + content;
+}
+// =============================================================================
+// BUILDERS
+// =============================================================================
+/**
+ * Convenience builder for common frontmatter patterns.
+ *
+ * Auto-sets `updated` to the current ISO date string.
+ *
+ * @param epicId - Epic identifier (e.g. `T4881`)
+ * @param stage - RCASD stage name (e.g. `research`)
+ * @param options - Optional fields: task, related links, created date
+ * @returns A FrontmatterMetadata object ready for serialization
+ */
+export function buildFrontmatter(epicId, stage, options) {
+    const now = new Date().toISOString().split('T')[0];
+    const metadata = {
+        epic: epicId,
+        stage,
+    };
+    if (options?.task) {
+        metadata.task = options.task;
+    }
+    if (options?.related && options.related.length > 0) {
+        metadata.related = options.related;
+    }
+    metadata.created = options?.created ?? now;
+    metadata.updated = now;
+    return metadata;
+}
+// =============================================================================
+// BACKLINKS
+// =============================================================================
+/**
+ * Scan all markdown files in `.cleo/rcasd/` for files that reference
+ * the given epic+stage combination via their `related` frontmatter links.
+ *
+ * This enables "what links here?" queries (Obsidian-style backlinks).
+ *
+ * @param epicId - Epic identifier to search for
+ * @param stage - Stage name to search for
+ * @param cwd - Optional working directory override
+ * @returns Array of files with matching related links
+ */
+export function getBacklinks(epicId, stage, cwd) {
+    const baseDir = getRcasdBaseDir(cwd);
+    if (!existsSync(baseDir))
+        return [];
+    const results = [];
+    const targetPattern = `${epicId}/${stage}`;
+    scanDirectory(baseDir, baseDir, targetPattern, epicId, stage, results);
+    return results;
+}
+/**
+ * Recursively scan a directory for markdown files with matching backlinks.
+ */
+function scanDirectory(dir, baseDir, targetPattern, epicId, stage, results) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            scanDirectory(fullPath, baseDir, targetPattern, epicId, stage, results);
+            continue;
+        }
+        if (!entry.name.endsWith('.md'))
+            continue;
+        let content;
+        try {
+            content = readFileSync(fullPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const parsed = parseFrontmatter(content);
+        if (!parsed.frontmatter?.related)
+            continue;
+        for (const link of parsed.frontmatter.related) {
+            const matchesPath = link.path?.includes(targetPattern);
+            const matchesId = link.id === epicId && link.type === stage;
+            const matchesEpicStage = parsed.frontmatter.epic === epicId && link.type === stage;
+            if (matchesPath || matchesId || matchesEpicStage) {
+                const relPath = relative(baseDir, fullPath);
+                results.push({ file: relPath, link });
+            }
+        }
+    }
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/lifecycle/frontmatter.js.map

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