@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-consistency-detector.js

@@ -0,0 +1,410 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Consistency Detector (WU-2015)
+ *
+ * Error detection logic for WU state inconsistencies.
+ * Detects five types of inconsistencies without performing any repairs.
+ *
+ * Extracted from wu-consistency-checker.ts to isolate detection from
+ * repair orchestration and file manipulation.
+ *
+ * @see {@link ./wu-inconsistency-repairer.ts} Repair orchestration
+ * @see {@link ./wu-consistency-file-repairs.ts} File-level repairs
+ */
+import { readFile, readdir, access } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import path from 'node:path';
+import { parseYAML } from './wu-yaml.js';
+import { createWuPaths } from './wu-paths.js';
+import { CONSISTENCY_TYPES, CONSISTENCY_MESSAGES, WU_STATUS } from './wu-constants.js';
+import { createGitForPath } from './git-adapter.js';
+import { listTrackedWUStampIds } from './stamp-tracking.js';
+const UNKNOWN_WU_STATUS = 'unknown';
+function readOptionalStringField(value, fieldName) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const fieldValue = Reflect.get(value, fieldName);
+    return typeof fieldValue === 'string' ? fieldValue : undefined;
+}
+function parseWUConsistencyDoc(content) {
+    const parsed = parseYAML(content);
+    return {
+        status: readOptionalStringField(parsed, 'status'),
+        lane: readOptionalStringField(parsed, 'lane'),
+        title: readOptionalStringField(parsed, 'title'),
+        worktree_path: readOptionalStringField(parsed, 'worktree_path'),
+    };
+}
+/**
+ * Check a single WU for state inconsistencies
+ *
+ * @param {string} id - WU ID (e.g., 'WU-123')
+ * @param {string} [projectRoot=process.cwd()] - Project root directory
+ * @param {CheckWUConsistencyOptions} [options] - Optional precomputed context
+ * @returns {Promise<object>} Consistency report with valid, errors, and stats
+ */
+export async function checkWUConsistency(id, projectRoot = process.cwd(), options = {}) {
+    const errors = [];
+    const paths = createWuPaths({ projectRoot });
+    const wuPath = path.join(projectRoot, paths.WU(id));
+    const stampPath = path.join(projectRoot, paths.STAMP(id));
+    const backlogPath = path.join(projectRoot, paths.BACKLOG());
+    const statusPath = path.join(projectRoot, paths.STATUS());
+    // Handle missing WU YAML gracefully
+    try {
+        await access(wuPath, constants.R_OK);
+    }
+    catch {
+        return { valid: true, errors: [], stats: { wuExists: false } };
+    }
+    const wuContent = await readFile(wuPath, { encoding: 'utf-8' });
+    const wuDoc = parseWUConsistencyDoc(wuContent);
+    const yamlStatus = wuDoc.status || UNKNOWN_WU_STATUS;
+    const lane = wuDoc.lane || '';
+    const title = wuDoc.title || '';
+    const worktreePathFromYaml = wuDoc.worktree_path || '';
+    // Check stamp existence (guard against untracked local stamp artifacts)
+    let hasStampFile;
+    try {
+        await access(stampPath, constants.R_OK);
+        hasStampFile = true;
+    }
+    catch {
+        hasStampFile = false;
+    }
+    const trackedStampIds = options.trackedStampIds ??
+        (await listTrackedWUStampIds({ projectRoot, stampsDir: paths.STAMPS_DIR() }));
+    const hasStamp = hasStampFile && (trackedStampIds === null || trackedStampIds.has(id));
+    // Parse backlog sections
+    let backlogContent;
+    try {
+        backlogContent = await readFile(backlogPath, { encoding: 'utf-8' });
+    }
+    catch {
+        backlogContent = '';
+    }
+    const { inDone: backlogInDone, inProgress: backlogInProgress } = parseBacklogSections(backlogContent, id);
+    // Parse status.md sections
+    let statusContent;
+    try {
+        statusContent = await readFile(statusPath, { encoding: 'utf-8' });
+    }
+    catch {
+        statusContent = '';
+    }
+    const { inProgress: statusInProgress } = parseStatusSections(statusContent, id);
+    // Check for worktree
+    const normalizedId = id.toUpperCase();
+    const hasWorktree = options.activeWorktreeIds !== undefined
+        ? options.activeWorktreeIds !== null && options.activeWorktreeIds.has(normalizedId)
+        : await checkWorktreeExists(id, projectRoot);
+    const worktreePathExists = await checkWorktreePathExists(worktreePathFromYaml);
+    // Detection logic
+    // 1. YAML done but in status.md In Progress
+    if (yamlStatus === WU_STATUS.DONE && statusInProgress) {
+        errors.push({
+            type: CONSISTENCY_TYPES.YAML_DONE_STATUS_IN_PROGRESS,
+            wuId: id,
+            description: `WU ${id} has status '${WU_STATUS.DONE}' in YAML but still appears in status.md In Progress section`,
+            repairAction: 'Remove from status.md In Progress section',
+            canAutoRepair: true,
+        });
+    }
+    // 2. Backlog dual section (Done AND In Progress)
+    if (backlogInDone && backlogInProgress) {
+        errors.push({
+            type: CONSISTENCY_TYPES.BACKLOG_DUAL_SECTION,
+            wuId: id,
+            description: `WU ${id} appears in both Done and In Progress sections of backlog.md`,
+            repairAction: 'Remove from In Progress section (Done wins)',
+            canAutoRepair: true,
+        });
+    }
+    // 3. YAML done but no stamp
+    if (yamlStatus === WU_STATUS.DONE && !hasStamp) {
+        errors.push({
+            type: CONSISTENCY_TYPES.YAML_DONE_NO_STAMP,
+            wuId: id,
+            title,
+            description: `WU ${id} has status '${WU_STATUS.DONE}' but no stamp file exists`,
+            repairAction: 'Create stamp file',
+            canAutoRepair: true,
+        });
+    }
+    // 4. Orphan worktree for done WU
+    if (yamlStatus === WU_STATUS.DONE && hasWorktree) {
+        errors.push({
+            type: CONSISTENCY_TYPES.ORPHAN_WORKTREE_DONE,
+            wuId: id,
+            lane,
+            description: `WU ${id} has status '${WU_STATUS.DONE}' but still has an associated worktree`,
+            repairAction: 'Remove orphan worktree and lane branch',
+            canAutoRepair: true,
+        });
+    }
+    // 5. Stamp exists but YAML not done (inverse of YAML_DONE_NO_STAMP)
+    // This catches partial wu:done failures where stamp was created but YAML update failed
+    if (hasStamp && yamlStatus !== WU_STATUS.DONE) {
+        errors.push({
+            type: CONSISTENCY_TYPES.STAMP_EXISTS_YAML_NOT_DONE,
+            wuId: id,
+            title,
+            description: `WU ${id} has stamp file but YAML status is '${yamlStatus}' (not done)`,
+            repairAction: 'Update YAML to done+locked+completed',
+            canAutoRepair: true,
+        });
+    }
+    // 6. Claimed WU missing worktree directory
+    if (worktreePathFromYaml &&
+        !worktreePathExists &&
+        (yamlStatus === WU_STATUS.IN_PROGRESS || yamlStatus === WU_STATUS.BLOCKED)) {
+        errors.push({
+            type: CONSISTENCY_TYPES.MISSING_WORKTREE_CLAIMED,
+            wuId: id,
+            title,
+            description: CONSISTENCY_MESSAGES.MISSING_WORKTREE_CLAIMED(id, yamlStatus, worktreePathFromYaml),
+            repairAction: CONSISTENCY_MESSAGES.MISSING_WORKTREE_CLAIMED_REPAIR,
+            canAutoRepair: false,
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        stats: {
+            yamlStatus,
+            hasStamp,
+            backlogInDone,
+            backlogInProgress,
+            statusInProgress,
+            hasWorktree,
+            worktreePathExists,
+        },
+    };
+}
+/**
+ * Check all WUs for consistency
+ *
+ * @param {string} [projectRoot=process.cwd()] - Project root directory
+ * @returns {Promise<object>} Aggregated report with valid, errors, and checked count
+ */
+export async function checkAllWUConsistency(projectRoot = process.cwd()) {
+    const paths = createWuPaths({ projectRoot });
+    const wuDir = path.join(projectRoot, paths.WU_DIR());
+    try {
+        await access(wuDir, constants.R_OK);
+    }
+    catch {
+        return { valid: true, errors: [], checked: 0 };
+    }
+    const allErrors = [];
+    const wuFiles = (await readdir(wuDir)).filter((f) => /^WU-\d+\.yaml$/.test(f));
+    const trackedStampIds = await listTrackedWUStampIds({
+        projectRoot,
+        stampsDir: paths.STAMPS_DIR(),
+    });
+    const activeWorktreeIds = await listActiveWorktreeIds(projectRoot);
+    for (const file of wuFiles) {
+        const id = file.replace('.yaml', '');
+        const report = await checkWUConsistency(id, projectRoot, {
+            trackedStampIds,
+            activeWorktreeIds,
+        });
+        allErrors.push(...report.errors);
+    }
+    return {
+        valid: allErrors.length === 0,
+        errors: allErrors,
+        checked: wuFiles.length,
+    };
+}
+/**
+ * Check lane for orphan done WUs (pre-flight for wu:claim)
+ *
+ * @param {string} lane - Lane name to check
+ * @param {string} excludeId - WU ID to exclude from check (the one being claimed)
+ * @param {string} [projectRoot=process.cwd()] - Project root directory
+ * @returns {Promise<object>} Result with valid, orphans list, and reports
+ */
+export async function checkLaneForOrphanDoneWU(lane, excludeId, projectRoot = process.cwd()) {
+    const paths = createWuPaths({ projectRoot });
+    const wuDir = path.join(projectRoot, paths.WU_DIR());
+    const trackedStampIds = await listTrackedWUStampIds({
+        projectRoot,
+        stampsDir: paths.STAMPS_DIR(),
+    });
+    try {
+        await access(wuDir, constants.R_OK);
+    }
+    catch {
+        return { valid: true, orphans: [] };
+    }
+    const orphans = [];
+    const wuFiles = (await readdir(wuDir)).filter((f) => /^WU-\d+\.yaml$/.test(f));
+    for (const file of wuFiles) {
+        const id = file.replace('.yaml', '');
+        if (id === excludeId)
+            continue;
+        const wuPath = path.join(wuDir, file);
+        let wuContent;
+        try {
+            wuContent = await readFile(wuPath, { encoding: 'utf-8' });
+        }
+        catch {
+            // Skip unreadable files
+            continue;
+        }
+        let wuDoc;
+        try {
+            wuDoc = parseYAML(wuContent);
+        }
+        catch {
+            // Skip malformed YAML files - they're a separate issue
+            continue;
+        }
+        if (wuDoc?.lane === lane && wuDoc?.status === WU_STATUS.DONE) {
+            const report = await checkWUConsistency(id, projectRoot, { trackedStampIds });
+            if (!report.valid) {
+                orphans.push({ id, errors: report.errors });
+            }
+        }
+    }
+    return {
+        valid: orphans.length === 0,
+        orphans: orphans.map((o) => o.id),
+        reports: orphans,
+    };
+}
+// Internal helpers
+/**
+ * Parse backlog.md to find which sections contain a WU ID
+ *
+ * @param {string} content - Backlog file content
+ * @param {string} id - WU ID to search for
+ * @returns {object} Object with inDone and inProgress booleans
+ */
+function parseBacklogSections(content, id) {
+    const lines = content.split(/\r?\n/);
+    let inDone = false;
+    let inProgress = false;
+    let currentSection = null;
+    // Match exact WU YAML filename to prevent substring false positives
+    // e.g., WU-208 should not match lines containing WU-2087
+    const exactPattern = `(wu/${id}.yaml)`;
+    for (const line of lines) {
+        if (line.trim() === '## ✅ Done') {
+            currentSection = WU_STATUS.DONE;
+            continue;
+        }
+        if (line.trim() === '## 🔧 In progress') {
+            currentSection = WU_STATUS.IN_PROGRESS;
+            continue;
+        }
+        if (line.trim().startsWith('## ')) {
+            currentSection = null;
+            continue;
+        }
+        if (line.includes(exactPattern)) {
+            if (currentSection === WU_STATUS.DONE)
+                inDone = true;
+            if (currentSection === WU_STATUS.IN_PROGRESS)
+                inProgress = true;
+        }
+    }
+    return { inDone, inProgress };
+}
+/**
+ * Parse status.md to find if WU is in In Progress section
+ *
+ * @param {string} content - Status file content
+ * @param {string} id - WU ID to search for
+ * @returns {object} Object with inProgress boolean
+ */
+function parseStatusSections(content, id) {
+    const lines = content.split(/\r?\n/);
+    let inProgress = false;
+    let currentSection = null;
+    // Match exact WU YAML filename to prevent substring false positives
+    // e.g., WU-208 should not match lines containing WU-2087
+    const exactPattern = `(wu/${id}.yaml)`;
+    for (const line of lines) {
+        if (line.trim() === '## In Progress') {
+            currentSection = WU_STATUS.IN_PROGRESS;
+            continue;
+        }
+        if (line.trim().startsWith('## ')) {
+            currentSection = null;
+            continue;
+        }
+        if (currentSection === WU_STATUS.IN_PROGRESS && line.includes(exactPattern)) {
+            inProgress = true;
+        }
+    }
+    return { inProgress };
+}
+/**
+ * Check if a worktree exists for a given WU ID
+ *
+ * Uses word-boundary matching to avoid false positives where one WU ID
+ * is a prefix of another (e.g., WU-204 should not match wu-2049).
+ *
+ * @param {string} id - WU ID
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<boolean>} True if worktree exists
+ */
+async function checkWorktreeExists(id, projectRoot) {
+    try {
+        const git = createGitForPath(projectRoot);
+        const output = await git.worktreeList();
+        // Match WU ID followed by non-digit or end of string to prevent
+        // false positives (e.g., wu-204 matching wu-2049)
+        // eslint-disable-next-line security/detect-non-literal-regexp -- WU ID from internal state, not user input
+        const pattern = new RegExp(`${id.toLowerCase()}(?![0-9])`, 'i');
+        return pattern.test(output);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Precompute active WU IDs from git worktree list.
+ *
+ * Returns:
+ * - Set of normalized WU IDs (e.g. WU-1234) when query succeeds
+ * - null when git worktree listing is unavailable (caller should fall back)
+ */
+export async function listActiveWorktreeIds(projectRoot) {
+    try {
+        const git = createGitForPath(projectRoot);
+        const output = await git.worktreeList();
+        const matches = output.match(/\bwu-\d+\b/gi) ?? [];
+        const ids = new Set();
+        for (const match of matches) {
+            ids.add(match.toUpperCase());
+        }
+        return ids;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check whether a worktree path exists on disk
+ *
+ * @param {string} worktreePath - Worktree path from WU YAML
+ * @returns {Promise<boolean>} True if path exists
+ */
+async function checkWorktreePathExists(worktreePath) {
+    if (!worktreePath) {
+        return false;
+    }
+    try {
+        await access(worktreePath, constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=wu-consistency-detector.js.map

package/dist/wu-consistency-detector.js.map

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

package/dist/wu-consistency-file-repairs.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Result type for consistency repair operations.
+ *
+ * This is distinct from wu-state-store RepairResult (line-based corruption repair).
+ * WU consistency repairs are file-oriented and may be skipped intentionally.
+ */
+export interface WUConsistencyRepairResult {
+    success?: boolean;
+    skipped?: boolean;
+    reason?: string;
+    files?: string[];
+}
+export type RepairResult = WUConsistencyRepairResult;
+/**
+ * Create stamp file inside a micro-worktree (WU-1078)
+ *
+ * @param {string} id - WU ID
+ * @param {string} title - WU title
+ * @param {string} worktreePath - Path to the micro-worktree
+ * @returns {Promise<string[]>} List of files created (relative paths)
+ */
+export declare function createStampInWorktree(id: string, title: string, worktreePath: string): Promise<string[]>;
+/**
+ * Update WU YAML to done+locked+completed state inside a micro-worktree (WU-1078)
+ *
+ * Repairs STAMP_EXISTS_YAML_NOT_DONE by setting:
+ * - status: done
+ * - locked: true
+ * - completed: YYYY-MM-DD (today, unless already set)
+ *
+ * @param {string} id - WU ID
+ * @param {string} worktreePath - Path to the micro-worktree
+ * @param {string} projectRoot - Original project root (for reading source file)
+ * @returns {Promise<string[]>} List of files modified (relative paths)
+ */
+export declare function updateYamlToDoneInWorktree(id: string, worktreePath: string, projectRoot: string): Promise<string[]>;
+/**
+ * Derive WU status from event log entries
+ */
+export declare function deriveStatusFromEvents(eventsContent: string, wuId: string): string | undefined;
+/**
+ * Append reconciliation events (claim + complete) to the event store
+ * inside a micro-worktree
+ */
+export declare function appendReconciliationEventsInWorktree({ id, lane, title, projectRoot, worktreePath, }: {
+    id: string;
+    lane?: string;
+    title?: string;
+    projectRoot: string;
+    worktreePath: string;
+}): string[];
+/**
+ * Remove WU entry from a specific section in a markdown file inside a micro-worktree (WU-1078)
+ *
+ * @param {string} relFilePath - Relative path to the markdown file
+ * @param {string} id - WU ID to remove
+ * @param {string} sectionHeading - Section heading to target
+ * @param {string} worktreePath - Path to the micro-worktree
+ * @param {string} projectRoot - Original project root (for reading source file)
+ * @returns {Promise<string[]>} List of files modified (relative paths)
+ */
+export declare function removeWUFromSectionInWorktree(relFilePath: string, id: string, sectionHeading: string, worktreePath: string, projectRoot: string): Promise<string[]>;
+/**
+ * Remove orphan worktree for a done WU
+ *
+ * CRITICAL: This function includes safety guards to prevent data loss.
+ * See WU-1276 incident report for why these guards are essential.
+ *
+ * @param {string} id - WU ID
+ * @param {string} lane - Lane name
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<RepairResult>} Result with success, skipped, and reason
+ */
+export declare function removeOrphanWorktree(id: string, lane: string, projectRoot: string): Promise<RepairResult>;
+//# sourceMappingURL=wu-consistency-file-repairs.d.ts.map

package/dist/wu-consistency-file-repairs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-consistency-file-repairs.d.ts","sourceRoot":"","sources":["../src/wu-consistency-file-repairs.ts"],"names":[],"mappings":"AAiCA;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAGD,MAAM,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CA0DnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkC9F;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,EACnD,EAAE,EACF,IAAI,EACJ,KAAK,EACL,WAAW,EACX,YAAY,GACb,EAAE;IACD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,EAAE,CA+CX;AAED;;;;;;;;;GASG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CA6DnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CA8DvB"}