@lumenflow/core 3.2.0 → 3.2.2

package/dist/code-paths-overlap.js

@@ -0,0 +1,248 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Code Paths Overlap Detection
+ *
+ * Two-step algorithm for detecting code path conflicts between Work Units:
+ * 1. Static glob containment check (fast pre-filter using pattern matching)
+ * 2. Concrete file intersection (authoritative using filesystem)
+ *
+ * @module code-paths-overlap
+ */
+import { readFileSync, existsSync } from 'fs';
+import path from 'path';
+import { parseYAML } from './wu-yaml.js';
+import fg from 'fast-glob';
+import micromatch from 'micromatch';
+import { STATUS_SECTIONS, BACKLOG_SECTIONS, STRING_LITERALS } from './wu-constants.js';
+/**
+ * Check for code path overlap between two sets of glob patterns
+ *
+ * Uses two-step algorithm:
+ * - Static check: Fast pattern analysis to detect obvious containment
+ * - Concrete check: Filesystem-based expansion to find actual file intersection
+ *
+ * @param {string[]} claimingPaths - Glob patterns from WU being claimed
+ * @param {string[]} existingPaths - Glob patterns from in-progress WU
+ * @returns {{
+ *   overlaps: boolean,
+ *   type: 'none'|'concrete'|'ambiguous',
+ *   files: string[]
+ * }} Overlap detection result
+ *
+ * @example
+ * checkOverlap(['apps/web/**'], ['apps/web/prompts/**'])
+ * // => { overlaps: true, type: 'concrete', files: [...] }
+ */
+export function checkOverlap(claimingPaths, existingPaths) {
+    // Handle empty inputs
+    if (!claimingPaths || claimingPaths.length === 0) {
+        return { overlaps: false, type: 'none', files: [] };
+    }
+    if (!existingPaths || existingPaths.length === 0) {
+        return { overlaps: false, type: 'none', files: [] };
+    }
+    // Step 1: Static check (fast pre-filter)
+    // Check if UnsafeAny pattern pair has static containment
+    let hasStaticOverlap = false;
+    for (const claiming of claimingPaths) {
+        for (const existing of existingPaths) {
+            // Bidirectional check: A contains B OR B contains A
+            if (staticGlobContainment(claiming, existing) || staticGlobContainment(existing, claiming)) {
+                hasStaticOverlap = true;
+                break;
+            }
+        }
+        if (hasStaticOverlap)
+            break;
+    }
+    // Step 2: Concrete check (authoritative)
+    // Expand globs and find actual file intersection
+    const allFiles = new Set();
+    for (const claiming of claimingPaths) {
+        for (const existing of existingPaths) {
+            const result = concreteFileIntersection(claiming, existing);
+            if (result.overlaps) {
+                result.files.forEach((f) => allFiles.add(f));
+            }
+        }
+    }
+    const hasConcreteOverlap = allFiles.size > 0;
+    // Decision logic:
+    // - Both static and concrete → BLOCK (concrete overlap)
+    // - Static only, no concrete → WARN (ambiguous)
+    // - Neither → ALLOW (none)
+    if (hasConcreteOverlap) {
+        return {
+            overlaps: true,
+            type: 'concrete',
+            files: [...allFiles].sort(),
+        };
+    }
+    else if (hasStaticOverlap && !hasConcreteOverlap) {
+        return {
+            overlaps: false,
+            type: 'ambiguous',
+            files: [],
+        };
+    }
+    else {
+        return {
+            overlaps: false,
+            type: 'none',
+            files: [],
+        };
+    }
+}
+/**
+ * Find all in-progress WUs with overlapping code paths
+ *
+ * Reads status.md to find in-progress WUs, loads their code_paths,
+ * and checks for overlaps with the claiming WU's paths.
+ *
+ * @param {string} statusPath - Path to status.md file
+ * @param {string[]} claimingPaths - Glob patterns from WU being claimed
+ * @param {string} claimingWU - WU ID being claimed (excluded from check)
+ * @returns {{
+ *   conflicts: Array<{wuid: string, overlaps: string[]}>,
+ *   hasBlocker: boolean
+ * }} List of conflicting WUs and whether to block claim
+ *
+ * @example
+ * detectConflicts('docs/04-operations/tasks/status.md', ['apps/**'], 'WU-901')
+ * // => { conflicts: [{wuid: 'WU-900', overlaps: ['apps/web/foo.ts']}], hasBlocker: true }
+ */
+export function detectConflicts(statusPath, claimingPaths, claimingWU) {
+    // Handle empty claiming paths
+    if (!claimingPaths || claimingPaths.length === 0) {
+        return { conflicts: [], hasBlocker: false };
+    }
+    // Read status.md
+    const content = readFileSync(statusPath, { encoding: 'utf-8' });
+    const lines = content.split(STRING_LITERALS.NEWLINE);
+    // Find "## In Progress" section (handles both status.md and backlog.md formats)
+    const inProgressIdx = lines.findIndex((l) => {
+        const normalized = l.trim().toLowerCase();
+        return (normalized === STATUS_SECTIONS.IN_PROGRESS.toLowerCase() ||
+            normalized === BACKLOG_SECTIONS.IN_PROGRESS.toLowerCase() ||
+            normalized.startsWith('## in progress'));
+    });
+    if (inProgressIdx === -1) {
+        return { conflicts: [], hasBlocker: false };
+    }
+    // Find end of In Progress section (next ## heading or end of file)
+    let endIdx = lines.slice(inProgressIdx + 1).findIndex((l) => l.startsWith('## '));
+    if (endIdx === -1)
+        endIdx = lines.length - inProgressIdx - 1;
+    else
+        endIdx = inProgressIdx + 1 + endIdx;
+    // Extract section content
+    const section = lines.slice(inProgressIdx + 1, endIdx).join(STRING_LITERALS.NEWLINE);
+    // Check for "No items" marker
+    if (section.includes('No items currently in progress')) {
+        return { conflicts: [], hasBlocker: false };
+    }
+    // Extract WU IDs from links like [WU-334 — Title](wu/WU-334.yaml)
+    const wuLinkPattern = /\[([A-Z]+-\d+)\s*—\s*[^\]]+\]\([^)]+\)/gi;
+    const matches = [...section.matchAll(wuLinkPattern)];
+    if (matches.length === 0) {
+        return { conflicts: [], hasBlocker: false };
+    }
+    // Compute project root from statusPath
+    // statusPath is at docs/04-operations/tasks/status.md
+    const tasksDir = path.dirname(statusPath); // docs/04-operations/tasks
+    const operationsDir = path.dirname(tasksDir); // docs/04-operations
+    const docsDir = path.dirname(operationsDir); // docs
+    const projectRoot = path.dirname(docsDir); // project root
+    // Check each in-progress WU for overlaps
+    const conflicts = [];
+    for (const match of matches) {
+        const activeWuid = match[1]; // e.g., "WU-334"
+        // Skip claiming WU (shouldn't conflict with itself)
+        if (activeWuid === claimingWU) {
+            continue;
+        }
+        // Read WU YAML
+        const wuPath = path.join(projectRoot, 'docs', '04-operations', 'tasks', 'wu', `${activeWuid}.yaml`);
+        if (!existsSync(wuPath)) {
+            continue; // Skip if YAML doesn't exist
+        }
+        const wuContent = readFileSync(wuPath, { encoding: 'utf-8' });
+        const wuDoc = parseYAML(wuContent);
+        // Extract code_paths (skip if not defined)
+        const existingPaths = wuDoc?.code_paths;
+        if (!existingPaths || existingPaths.length === 0) {
+            continue;
+        }
+        // Check for overlap
+        const overlapResult = checkOverlap(claimingPaths, existingPaths);
+        // Only record concrete overlaps (block on real conflicts)
+        if (overlapResult.overlaps && overlapResult.type === 'concrete') {
+            conflicts.push({
+                wuid: activeWuid,
+                overlaps: overlapResult.files,
+            });
+        }
+    }
+    return {
+        conflicts,
+        hasBlocker: conflicts.length > 0,
+    };
+}
+/**
+ * Static glob containment check (internal helper)
+ *
+ * Tests if patternA contains patternB using glob semantics.
+ * Uses micromatch to convert globs to regex and test containment.
+ *
+ * @private
+ * @param {string} patternA - First glob pattern
+ * @param {string} patternB - Second glob pattern
+ * @returns {boolean} True if patternA contains patternB
+ *
+ * @example
+ * staticGlobContainment('apps/**', 'apps/web/**') // => true
+ * staticGlobContainment('apps/web/**', 'packages/**') // => false
+ */
+function staticGlobContainment(patternA, patternB) {
+    // Convert patternB to a test path by replacing wildcards
+    // Example: 'apps/web/**' → 'apps/web/test/file.ts'
+    const testPath = patternB.replace(/\*\*/g, 'test/nested').replace(/\*/g, 'testfile');
+    // Use micromatch to test if patternA would match this test path
+    // If patternA matches the test path, it contains patternB
+    return micromatch.isMatch(testPath, patternA);
+}
+/**
+ * Concrete file intersection using filesystem (internal helper)
+ *
+ * Expands glob patterns to real files using fast-glob,
+ * then computes Set intersection to find overlapping files.
+ *
+ * @private
+ * @param {string} patternA - First glob pattern
+ * @param {string} patternB - Second glob pattern
+ * @returns {{overlaps: boolean, files: string[]}} Intersection result
+ *
+ * @example
+ * concreteFileIntersection('apps/web/**', 'apps/web/prompts/**')
+ * // => { overlaps: true, files: ['apps/web/prompts/base.yaml'] }
+ */
+function concreteFileIntersection(patternA, patternB) {
+    // Expand globs to real files using fast-glob
+    // Use sync for simplicity (wu:claim is not performance-critical)
+    const filesA = new Set(fg.sync(patternA, {
+        dot: true, // Include dotfiles
+        ignore: ['node_modules/**', '.git/**'], // Exclude common bloat
+    }));
+    const filesB = new Set(fg.sync(patternB, {
+        dot: true,
+        ignore: ['node_modules/**', '.git/**'],
+    }));
+    // Compute intersection: files in both sets
+    const intersection = [...filesA].filter((file) => filesB.has(file));
+    return {
+        overlaps: intersection.length > 0,
+        files: intersection,
+    };
+}
+//# sourceMappingURL=code-paths-overlap.js.map

package/dist/code-paths-overlap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-paths-overlap.js","sourceRoot":"","sources":["../src/code-paths-overlap.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEvF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,aAAwB,EAAE,aAAwB;IAC7E,sBAAsB;IACtB,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,yCAAyC;IACzC,yDAAyD;IACzD,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,oDAAoD;YACpD,IAAI,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC3F,gBAAgB,GAAG,IAAI,CAAC;gBACxB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,gBAAgB;YAAE,MAAM;IAC9B,CAAC;IAED,yCAAyC;IACzC,iDAAiD;IACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IAE7C,kBAAkB;IAClB,wDAAwD;IACxD,gDAAgD;IAChD,2BAA2B;IAC3B,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC;SAAM,IAAI,gBAAgB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACnD,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAqB,EACrB,aAAwB,EACxB,UAAqB;IAErB,8BAA8B;IAC9B,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,iBAAiB;IACjB,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAErD,gFAAgF;IAChF,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1C,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO,CACL,UAAU,KAAK,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE;YACxD,UAAU,KAAK,gBAAgB,CAAC,WAAW,CAAC,WAAW,EAAE;YACzD,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC,CACxC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,mEAAmE;IACnE,IAAI,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,aAAa,GAAG,CAAC,CAAC;;QACxD,MAAM,GAAG,aAAa,GAAG,CAAC,GAAG,MAAM,CAAC;IAEzC,0BAA0B;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAErF,8BAA8B;IAC9B,IAAI,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,kEAAkE;IAClE,MAAM,aAAa,GAAG,0CAA0C,CAAC;IACjE,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAErD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,uCAAuC;IACvC,sDAAsD;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,2BAA2B;IACtE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB;IACnE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO;IACpD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;IAE1D,yCAAyC;IACzC,MAAM,SAAS,GAAG,EAAE,CAAC;IACrB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB;QAE9C,oDAAoD;QACpD,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,eAAe;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,WAAW,EACX,MAAM,EACN,eAAe,EACf,OAAO,EACP,IAAI,EACJ,GAAG,UAAU,OAAO,CACrB,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,6BAA6B;QACzC,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAqC,CAAC;QAEvE,2CAA2C;QAC3C,MAAM,aAAa,GAAG,KAAK,EAAE,UAAU,CAAC;QACxC,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,SAAS;QACX,CAAC;QAED,oBAAoB;QACpB,MAAM,aAAa,GAAG,YAAY,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAEjE,0DAA0D;QAC1D,IAAI,aAAa,CAAC,QAAQ,IAAI,aAAa,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAChE,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,aAAa,CAAC,KAAK;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS;QACT,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,qBAAqB,CAAC,QAAmB,EAAE,QAAmB;IACrE,yDAAyD;IACzD,mDAAmD;IACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAErF,gEAAgE;IAChE,0DAA0D;IAC1D,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,wBAAwB,CAAC,QAAmB,EAAE,QAAmB;IACxE,6CAA6C;IAC7C,iEAAiE;IACjE,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;QAChB,GAAG,EAAE,IAAI,EAAE,mBAAmB;QAC9B,MAAM,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,uBAAuB;KAChE,CAAC,CACH,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;QAChB,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC;KACvC,CAAC,CACH,CAAC;IAEF,2CAA2C;IAC3C,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpE,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC;QACjC,KAAK,EAAE,YAAY;KACpB,CAAC;AACJ,CAAC"}

package/dist/color-support.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Get the current color level.
+ * @returns Color level 0-3 (0 = no colors, 3 = full 16m colors)
+ */
+export declare function getColorLevel(): number;
+/**
+ * Initialize color support respecting NO_COLOR and FORCE_COLOR standards.
+ * Call this before UnsafeAny colored output.
+ *
+ * Priority order:
+ * 1. NO_COLOR env var (always wins, per spec)
+ * 2. --no-color CLI flag
+ * 3. FORCE_COLOR env var
+ * 4. Default chalk detection
+ *
+ * @param argv - Command line arguments (defaults to process.argv)
+ * @see https://no-color.org/
+ * @see https://github.com/chalk/chalk#supportscolor
+ */
+export declare function initColorSupport(argv?: string[]): void;
+//# sourceMappingURL=color-support.d.ts.map

package/dist/color-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-support.d.ts","sourceRoot":"","sources":["../src/color-support.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,IAAI,CA8BpE"}

package/dist/color-support.js

@@ -0,0 +1,67 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file color-support.ts
+ * Color control for CLI commands (WU-1085)
+ *
+ * Respects standard environment variables and CLI flags:
+ * - NO_COLOR: Disable colors (https://no-color.org/)
+ * - FORCE_COLOR: Override color level 0-3 (chalk standard)
+ * - --no-color: CLI flag to disable colors
+ *
+ * @see https://no-color.org/
+ * @see https://github.com/chalk/chalk#supportscolor
+ */
+import chalk from 'chalk';
+/** Internal storage for color level (allows testing without chalk singleton issues) */
+let currentColorLevel = chalk.level;
+/**
+ * Get the current color level.
+ * @returns Color level 0-3 (0 = no colors, 3 = full 16m colors)
+ */
+export function getColorLevel() {
+    return currentColorLevel;
+}
+/**
+ * Initialize color support respecting NO_COLOR and FORCE_COLOR standards.
+ * Call this before UnsafeAny colored output.
+ *
+ * Priority order:
+ * 1. NO_COLOR env var (always wins, per spec)
+ * 2. --no-color CLI flag
+ * 3. FORCE_COLOR env var
+ * 4. Default chalk detection
+ *
+ * @param argv - Command line arguments (defaults to process.argv)
+ * @see https://no-color.org/
+ * @see https://github.com/chalk/chalk#supportscolor
+ */
+export function initColorSupport(argv = process.argv) {
+    // NO_COLOR standard (https://no-color.org/)
+    // "When set (to UnsafeAny value, including empty string), it should disable colors"
+    if (process.env.NO_COLOR !== undefined) {
+        chalk.level = 0;
+        currentColorLevel = 0;
+        return;
+    }
+    // CLI --no-color flag
+    if (argv.includes('--no-color')) {
+        chalk.level = 0;
+        currentColorLevel = 0;
+        return;
+    }
+    // FORCE_COLOR override (chalk standard)
+    // Values: 0 = no color, 1 = basic, 2 = 256, 3 = 16m
+    if (process.env.FORCE_COLOR !== undefined) {
+        const level = parseInt(process.env.FORCE_COLOR, 10);
+        if (!isNaN(level) && level >= 0 && level <= 3) {
+            chalk.level = level;
+            currentColorLevel = level;
+        }
+        // Invalid values are ignored, keep default
+        return;
+    }
+    // Use chalk's default detection
+    currentColorLevel = chalk.level;
+}
+//# sourceMappingURL=color-support.js.map

package/dist/color-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-support.js","sourceRoot":"","sources":["../src/color-support.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,uFAAuF;AACvF,IAAI,iBAAiB,GAAW,KAAK,CAAC,KAAK,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiB,OAAO,CAAC,IAAI;IAC5D,4CAA4C;IAC5C,oFAAoF;IACpF,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACvC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;QAChB,iBAAiB,GAAG,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAED,sBAAsB;IACtB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;QAChB,iBAAiB,GAAG,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAED,wCAAwC;IACxC,oDAAoD;IACpD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,KAAK,GAAG,KAAsB,CAAC;YACrC,iBAAiB,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,2CAA2C;QAC3C,OAAO;IACT,CAAC;IAED,gCAAgC;IAChC,iBAAiB,GAAG,KAAK,CAAC,KAAK,CAAC;AAClC,CAAC"}

package/dist/commands-logger.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Command logging constants (WU-1552)
+ *
+ * User types and outcome values for audit trail logging.
+ */
+export declare const COMMAND_LOG: {
+    /** User types: who initiated the command */
+    USER: {
+        AGENT: string;
+        HUMAN: string;
+        UNKNOWN: string;
+    };
+    /** Outcome values: what happened to the command */
+    OUTCOME: {
+        ALLOWED: string;
+        BLOCKED: string;
+        UNKNOWN: string;
+    };
+};
+/**
+ * Options for logging git commands (WU-1552)
+ */
+export interface LogGitCommandOptions {
+    /** User type: 'agent' | 'human' | 'unknown' */
+    user?: string;
+    /** Command outcome: 'allowed' | 'blocked' */
+    outcome?: string;
+}
+/**
+ * Log a git command to the commands log
+ * @param {string[]} args - Git command arguments (e.g., ['status'], ['add', '.'])
+ * @param {string} logPath - Path to log file (defaults to .lumenflow/commands.log)
+ * @param {LogGitCommandOptions} options - Additional logging options (WU-1552)
+ */
+export declare function logGitCommand(args: UnsafeAny, logPath?: string, options?: LogGitCommandOptions): void;
+/**
+ * Parse a log entry line into structured data
+ * Supports both v1 (4 fields) and v2 (6 fields) formats.
+ *
+ * @param {string} line - Log line to parse
+ * @returns {{timestamp: string, command: string, branch: string, worktree: string, user: string, outcome: string} | null}
+ */
+export declare function parseLogEntry(line: UnsafeAny): {
+    timestamp: any;
+    command: any;
+    branch: any;
+    worktree: any;
+    user: any;
+    outcome: any;
+} | null;
+/**
+ * Scan log for violations within a session window
+ * @param {string} logPath - Path to commands log
+ * @param {number} windowMinutes - Session window in minutes (default 60)
+ * @returns {Array<{timestamp: string, command: string, branch: string, worktree: string}>}
+ */
+export declare function scanLogForViolations(logPath?: string, windowMinutes?: number): {
+    timestamp: any;
+    command: any;
+    branch: any;
+    worktree: any;
+    user: any;
+    outcome: any;
+}[];
+/**
+ * Rotate log by removing entries older than retention period
+ * @param {string} logPath - Path to commands log
+ * @param {number} retentionDays - Number of days to keep (default 7)
+ */
+export declare function rotateLog(logPath?: string, retentionDays?: number): void;
+//# sourceMappingURL=commands-logger.d.ts.map

package/dist/commands-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-logger.d.ts","sourceRoot":"","sources":["../src/commands-logger.ts"],"names":[],"mappings":"AA0CA;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,4CAA4C;;;;;;IAM5C,mDAAmD;;;;;;CAMpD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,OAAO,SAAmB,EAC1B,OAAO,GAAE,oBAAyB,QAmCnC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS;;;;;;;SAwD5C;AAgDD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,SAAmB,EAAE,aAAa,SAAK;;;;;;;IAmClF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,SAAmB,EAAE,aAAa,SAAI,QA8BtE"}