@lumenflow/core 3.2.0 → 3.2.1

package/dist/context/git-state-reader.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Git state information for WU operations.
+ *
+ * Captures the current git state relevant to command execution.
+ */
+export interface GitState {
+    /** Current branch name (null if detached) */
+    branch: string | null;
+    /** Whether HEAD is detached */
+    isDetached: boolean;
+    /** Whether working tree has uncommitted changes */
+    isDirty: boolean;
+    /** Whether there are staged changes */
+    hasStaged: boolean;
+    /** Commits ahead of tracking branch */
+    ahead: number;
+    /** Commits behind tracking branch */
+    behind: number;
+    /** Tracking branch (e.g., 'origin/main') */
+    tracking: string | null;
+    /** List of modified files */
+    modifiedFiles: string[];
+    /** Whether an error occurred reading state */
+    hasError: boolean;
+    /** Error message if hasError is true */
+    errorMessage: string | null;
+}
+/**
+ * Read current git state using simple-git library.
+ *
+ * Uses git status to efficiently gather all state in one operation.
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @returns Promise<GitState> - Current git state
+ */
+export declare function readGitState(cwd?: string): Promise<GitState>;
+//# sourceMappingURL=git-state-reader.d.ts.map

package/dist/context/git-state-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-state-reader.d.ts","sourceRoot":"","sources":["../../src/context/git-state-reader.ts"],"names":[],"mappings":"AAqBA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsCjF"}

package/dist/context/git-state-reader.js

@@ -0,0 +1,64 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Git State Reader for WU Context
+ *
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ *
+ * Reads git state including:
+ * - Current branch
+ * - Dirty working tree (uncommitted changes)
+ * - Staged changes
+ * - Ahead/behind tracking branch
+ *
+ * Uses simple-git library (NOT execSync) per library-first mandate.
+ *
+ * @module
+ */
+import { simpleGit } from 'simple-git';
+/**
+ * Read current git state using simple-git library.
+ *
+ * Uses git status to efficiently gather all state in one operation.
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @returns Promise<GitState> - Current git state
+ */
+export async function readGitState(cwd = process.cwd()) {
+    try {
+        const git = simpleGit(cwd);
+        const status = await git.status();
+        // Determine if working tree is dirty
+        const isDirty = !status.isClean();
+        // Check for staged changes - simple-git provides staged array
+        const hasStaged = status.staged.length > 0;
+        return {
+            branch: status.current,
+            isDetached: status.detached === true,
+            isDirty,
+            hasStaged,
+            ahead: status.ahead,
+            behind: status.behind,
+            tracking: status.tracking,
+            modifiedFiles: status.modified || [],
+            hasError: false,
+            errorMessage: null,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            branch: null,
+            isDetached: false,
+            isDirty: false,
+            hasStaged: false,
+            ahead: 0,
+            behind: 0,
+            tracking: null,
+            modifiedFiles: [],
+            hasError: true,
+            errorMessage: message,
+        };
+    }
+}
+//# sourceMappingURL=git-state-reader.js.map

package/dist/context/git-state-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-state-reader.js","sourceRoot":"","sources":["../../src/context/git-state-reader.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AA8BvD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAc,SAAS,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;QAElC,qCAAqC;QACrC,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAElC,8DAA8D;QAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAE3C,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,OAAO;YACtB,UAAU,EAAE,MAAM,CAAC,QAAQ,KAAK,IAAI;YACpC,OAAO;YACP,SAAS;YACT,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;YACpC,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,EAAE;YACjB,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,OAAO;SACtB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/context/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Context Module
+ *
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ *
+ * Exports:
+ * - Location resolution (main vs worktree detection)
+ * - Git state reading (branch, dirty, staged, ahead/behind)
+ * - WU state reading (YAML + state store)
+ * - Context computation (unified context model)
+ *
+ * @module
+ */
+export * from './location-resolver.js';
+export * from './git-state-reader.js';
+export * from './wu-state-reader.js';
+export * from './context-computer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,20 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Context Module
+ *
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ *
+ * Exports:
+ * - Location resolution (main vs worktree detection)
+ * - Git state reading (branch, dirty, staged, ahead/behind)
+ * - WU state reading (YAML + state store)
+ * - Context computation (unified context model)
+ *
+ * @module
+ */
+export * from './location-resolver.js';
+export * from './git-state-reader.js';
+export * from './wu-state-reader.js';
+export * from './context-computer.js';
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;GAYG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/context/location-resolver.d.ts

@@ -0,0 +1,34 @@
+import { type LocationType } from '../wu-constants.js';
+/**
+ * Location context information for WU operations.
+ *
+ * Captures where the command is being run from and related paths.
+ */
+export interface LocationContext {
+    /** Location type: 'main', 'worktree', 'detached', or 'unknown' */
+    type: LocationType;
+    /** Absolute path to current working directory */
+    cwd: string;
+    /** Absolute path to git root (top-level of working tree) */
+    gitRoot: string;
+    /** Absolute path to main checkout (primary repo) */
+    mainCheckout: string;
+    /** Worktree name if in a worktree (e.g., 'framework-core-wu-1090') */
+    worktreeName: string | null;
+    /** WU ID extracted from worktree path (e.g., 'WU-1090') */
+    worktreeWuId: string | null;
+}
+/**
+ * Resolve current location context using simple-git library.
+ *
+ * Detection logic:
+ * 1. Use simple-git revparse to find git root and git dir
+ * 2. If .git is a file (not dir), we're in a worktree
+ * 3. Parse worktree path to extract WU ID
+ * 4. Find main checkout via simple-git worktree list
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @returns Promise<LocationContext> - Resolved location context
+ */
+export declare function resolveLocation(cwd?: string): Promise<LocationContext>;
+//# sourceMappingURL=location-resolver.d.ts.map

package/dist/context/location-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location-resolver.d.ts","sourceRoot":"","sources":["../../src/context/location-resolver.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIrF;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,IAAI,EAAE,YAAY,CAAC;IACnB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4C3F"}

package/dist/context/location-resolver.js

@@ -0,0 +1,179 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Location Resolver for WU Context
+ *
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ *
+ * Detects whether the current working directory is:
+ * - Main checkout (primary repo clone)
+ * - Worktree (isolated workspace for a WU)
+ * - Detached HEAD
+ * - Unknown (not a git repository)
+ *
+ * Uses simple-git library (NOT execSync) per library-first mandate.
+ *
+ * @module
+ */
+import { simpleGit } from 'simple-git';
+import { statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { CONTEXT_VALIDATION, PATTERNS } from '../wu-constants.js';
+const { LOCATION_TYPES } = CONTEXT_VALIDATION;
+/**
+ * Resolve current location context using simple-git library.
+ *
+ * Detection logic:
+ * 1. Use simple-git revparse to find git root and git dir
+ * 2. If .git is a file (not dir), we're in a worktree
+ * 3. Parse worktree path to extract WU ID
+ * 4. Find main checkout via simple-git worktree list
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @returns Promise<LocationContext> - Resolved location context
+ */
+export async function resolveLocation(cwd = process.cwd()) {
+    const resolvedCwd = resolve(cwd);
+    try {
+        const git = simpleGit(resolvedCwd);
+        // Get git root and git dir using simple-git revparse
+        const gitRoot = (await git.revparse(['--show-toplevel'])).trim();
+        const _gitDir = (await git.revparse(['--git-dir'])).trim();
+        // Detect if we're in a worktree (in worktrees, .git is a file not a dir)
+        // WU-1223: Fixed - check .git in gitRoot, not the gitDir path returned by rev-parse
+        const isWorktree = isGitDirFile(resolve(gitRoot, '.git'));
+        const mainCheckout = isWorktree ? await findMainCheckout(git) : gitRoot;
+        // Parse worktree info
+        const worktreeName = isWorktree ? parseWorktreeName(gitRoot, mainCheckout) : null;
+        const worktreeWuId = worktreeName ? parseWuIdFromWorktree(worktreeName) : null;
+        // Check if HEAD is detached (WU-1096)
+        const isDetached = await isHeadDetached(git);
+        // Determine location type
+        const type = determineLocationType(gitRoot, mainCheckout, isWorktree, isDetached);
+        return {
+            type,
+            cwd: resolvedCwd,
+            gitRoot,
+            mainCheckout,
+            worktreeName,
+            worktreeWuId,
+        };
+    }
+    catch {
+        // Not a git repository or other error
+        return {
+            type: LOCATION_TYPES.UNKNOWN,
+            cwd: resolvedCwd,
+            gitRoot: resolvedCwd,
+            mainCheckout: resolvedCwd,
+            worktreeName: null,
+            worktreeWuId: null,
+        };
+    }
+}
+/**
+ * Check if git dir is a file (worktree) vs directory (main checkout)
+ *
+ * In a main checkout, .git is a directory containing the repository data.
+ * In a worktree, .git is a file that points to the main .git directory.
+ */
+function isGitDirFile(gitDir) {
+    try {
+        const stat = statSync(gitDir);
+        return stat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find main checkout path using simple-git worktree list
+ *
+ * The first worktree listed is always the main checkout.
+ */
+async function findMainCheckout(git) {
+    try {
+        // simple-git doesn't have direct worktree support, use raw command
+        const result = await git.raw(['worktree', 'list', '--porcelain']);
+        // First worktree listed is always the main checkout
+        // Format: "worktree /path/to/repo\nHEAD ...\nbranch ...\n\nworktree ..."
+        const match = result.match(/^worktree (.+)$/m);
+        return match?.[1] ?? process.cwd();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+/**
+ * Extract worktree name from path
+ *
+ * @example
+ * parseWorktreeName('/repo/worktrees/framework-core-wu-1090', '/repo')
+ * // Returns 'framework-core-wu-1090'
+ */
+function parseWorktreeName(gitRoot, mainCheckout) {
+    // Remove main checkout prefix to get relative path
+    let relativePath = gitRoot;
+    if (gitRoot.startsWith(mainCheckout)) {
+        relativePath = gitRoot.slice(mainCheckout.length);
+    }
+    // Remove leading slashes
+    relativePath = relativePath.replace(/^\/+/, '');
+    // The worktree name is the last path component
+    const parts = relativePath.split('/');
+    const lastPart = parts[parts.length - 1];
+    return lastPart || null;
+}
+/**
+ * Extract WU ID from worktree name
+ *
+ * Uses PATTERNS.WU_ID_EXTRACT_CI (case-insensitive) from wu-constants.ts
+ * because worktree names use lowercase (e.g., 'framework-core-wu-1090').
+ *
+ * @example
+ * parseWuIdFromWorktree('framework-core-wu-1090') // 'WU-1090'
+ * parseWuIdFromWorktree('some-feature') // null
+ */
+function parseWuIdFromWorktree(worktreeName) {
+    // Use case-insensitive pattern for worktree names
+    const match = worktreeName.match(PATTERNS.WU_ID_EXTRACT_CI);
+    return match ? match[0].toUpperCase() : null;
+}
+/**
+ * Check if HEAD is detached using git symbolic-ref
+ *
+ * WU-1096: Detect detached HEAD state and return DETACHED location type.
+ *
+ * When HEAD is attached to a branch, `git symbolic-ref HEAD` returns
+ * the ref name (e.g., 'refs/heads/main'). When detached, it fails
+ * with 'fatal: ref HEAD is not a symbolic ref'.
+ *
+ * @param git - SimpleGit instance
+ * @returns Promise<boolean> - true if HEAD is detached
+ */
+async function isHeadDetached(git) {
+    try {
+        // git symbolic-ref HEAD succeeds when HEAD is attached to a branch
+        await git.raw(['symbolic-ref', 'HEAD']);
+        return false; // HEAD is attached
+    }
+    catch {
+        // git symbolic-ref HEAD fails when HEAD is detached
+        return true;
+    }
+}
+/**
+ * Determine location type from context
+ *
+ * WU-1096: Added isDetached parameter to detect detached HEAD state.
+ */
+function determineLocationType(gitRoot, mainCheckout, isWorktree, isDetached = false) {
+    if (isWorktree)
+        return LOCATION_TYPES.WORKTREE;
+    if (isDetached)
+        return LOCATION_TYPES.DETACHED;
+    if (gitRoot === mainCheckout)
+        return LOCATION_TYPES.MAIN;
+    return LOCATION_TYPES.UNKNOWN;
+}
+//# sourceMappingURL=location-resolver.js.map

package/dist/context/location-resolver.js.map

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

package/dist/context/wu-state-reader.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Result of reading WU state.
+ */
+export interface WuStateResult {
+    /** WU ID (uppercase, e.g., 'WU-1090') */
+    id: string;
+    /** Current status from YAML */
+    status: string;
+    /** Lane name */
+    lane: string;
+    /** WU title */
+    title: string;
+    /** Absolute path to WU YAML file */
+    yamlPath: string;
+    /** WU-1683: Path to linked plan file */
+    plan?: string;
+    /** Whether YAML and state store are consistent */
+    isConsistent: boolean;
+    /** Reason for inconsistency if not consistent */
+    inconsistencyReason: string | null;
+}
+/**
+ * Read WU state from YAML and detect inconsistencies.
+ *
+ * @param wuId - WU ID (e.g., 'WU-1090' or 'wu-1090')
+ * @param repoRoot - Repository root path
+ * @returns WuStateResult or null if WU not found
+ */
+export declare function readWuState(wuId: string, repoRoot: string): Promise<WuStateResult | null>;
+//# sourceMappingURL=wu-state-reader.d.ts.map

package/dist/context/wu-state-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-state-reader.d.ts","sourceRoot":"","sources":["../../src/context/wu-state-reader.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAqBD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA0F/F"}

package/dist/context/wu-state-reader.js

@@ -0,0 +1,126 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU State Reader for WU Context
+ *
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ *
+ * Reads WU state from YAML file and optionally cross-references
+ * with state store for inconsistency detection.
+ *
+ * @module
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { parse as parseYaml } from 'yaml';
+import { WU_PATHS } from '../wu-paths.js';
+/**
+ * Normalize WU ID to uppercase format.
+ */
+function normalizeWuId(id) {
+    const upper = id.toUpperCase();
+    // Ensure it starts with WU-
+    if (upper.startsWith('WU-'))
+        return upper;
+    return `WU-${upper.replace(/^WU-?/i, '')}`;
+}
+/**
+ * Build the path to WU YAML file.
+ * WU-1301: Uses config-based paths instead of hardcoded DIRECTORIES.
+ */
+function getWuYamlPath(wuId, repoRoot) {
+    const normalizedId = normalizeWuId(wuId);
+    return join(repoRoot, WU_PATHS.WU(normalizedId));
+}
+/**
+ * Read WU state from YAML and detect inconsistencies.
+ *
+ * @param wuId - WU ID (e.g., 'WU-1090' or 'wu-1090')
+ * @param repoRoot - Repository root path
+ * @returns WuStateResult or null if WU not found
+ */
+export async function readWuState(wuId, repoRoot) {
+    const normalizedId = normalizeWuId(wuId);
+    const yamlPath = getWuYamlPath(normalizedId, repoRoot);
+    // Check if YAML exists
+    if (!existsSync(yamlPath)) {
+        return null;
+    }
+    try {
+        // Read and parse YAML
+        const content = readFileSync(yamlPath, 'utf8');
+        const yaml = parseYaml(content);
+        if (!yaml || typeof yaml !== 'object') {
+            return null;
+        }
+        // Extract fields with defaults
+        const status = yaml.status || 'unknown';
+        const lane = yaml.lane || '';
+        const title = yaml.title || '';
+        // WU-1683: Extract plan field
+        const plan = typeof yaml.plan === 'string' ? yaml.plan : undefined;
+        // WU-1755: Check worktree for divergent status.
+        // When run from main, the YAML may show 'ready' while the worktree branch
+        // has 'in_progress'. Uses execFileSync for safety (no shell injection).
+        let isConsistent = true;
+        let inconsistencyReason = null;
+        let effectiveStatus = status;
+        try {
+            // eslint-disable-next-line sonarjs/no-os-command-from-path -- git resolved from PATH; workflow tooling requires git
+            const worktreeList = execFileSync('git', ['worktree', 'list', '--porcelain'], {
+                encoding: 'utf-8',
+                cwd: repoRoot,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            const wuIdLower = normalizedId.toLowerCase();
+            const lines = worktreeList.split('\n');
+            let worktreeBranch;
+            for (const line of lines) {
+                if (line.startsWith('branch ') && line.toLowerCase().includes(wuIdLower)) {
+                    worktreeBranch = line.replace('branch refs/heads/', '').trim();
+                    break;
+                }
+            }
+            if (worktreeBranch) {
+                const yamlRelPath = WU_PATHS.WU(normalizedId);
+                try {
+                    // eslint-disable-next-line sonarjs/no-os-command-from-path -- git resolved from PATH; workflow tooling requires git
+                    const branchContent = execFileSync('git', ['show', `${worktreeBranch}:${yamlRelPath}`], {
+                        encoding: 'utf-8',
+                        cwd: repoRoot,
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                    });
+                    const branchYaml = parseYaml(branchContent);
+                    const branchStatus = branchYaml?.status;
+                    if (branchStatus && branchStatus !== status) {
+                        isConsistent = false;
+                        inconsistencyReason = `Main shows '${status}' but worktree branch (${worktreeBranch}) shows '${branchStatus}'`;
+                        effectiveStatus = branchStatus;
+                    }
+                }
+                catch {
+                    // Branch doesn't have the YAML file yet
+                }
+            }
+        }
+        catch {
+            // git worktree list failed — not in a git repo or git not available
+        }
+        return {
+            id: normalizedId,
+            status: effectiveStatus,
+            lane,
+            title,
+            yamlPath,
+            ...(plan && { plan }),
+            isConsistent,
+            inconsistencyReason,
+        };
+    }
+    catch {
+        // Parse error or read error
+        return null;
+    }
+}
+//# sourceMappingURL=wu-state-reader.js.map

package/dist/context/wu-state-reader.js.map

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