@lumenflow/core 3.1.3 → 3.2.1

package/dist/orphan-detector.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Orphan Worktree Detector (WU-1476)
+ *
+ * Detects orphan directories in worktrees/ that are not tracked by git worktree.
+ * Orphan directories can occur when wu:done fails mid-workflow due to:
+ * - Backlog sync issues
+ * - Formatting errors
+ * - Typecheck failures
+ * - Recovery mode interruptions
+ *
+ * Multi-layer defense strategy:
+ * - Layer 1: Explicit cleanup in git-adapter.worktreeRemove()
+ * - Layer 2: Orphan detection in wu:prune (this module)
+ * - Layer 3: Pre-flight check in wu:claim
+ * - Layer 4: Manual utility wu:cleanup-orphans
+ *
+ * @see {@link packages/@lumenflow/cli/src/wu-prune.ts} - Primary consumer
+ * @see {@link packages/@lumenflow/cli/src/wu-claim.ts} - Pre-flight orphan check
+ * @see {@link packages/@lumenflow/cli/src/lib/git-adapter.ts} - worktreeRemove with cleanup
+ */
+import { existsSync } from 'node:fs';
+/**
+ * Result of orphan detection
+ * @typedef {object} OrphanDetectionResult
+ * @property {string[]} orphans - List of orphan directory paths (absolute)
+ * @property {string[]} tracked - List of tracked worktree paths (absolute)
+ * @property {string[]} errors - List of error messages encountered during detection
+ */
+/**
+ * Parsed worktree entry from git worktree list --porcelain
+ */
+interface WorktreeEntry {
+    /** Absolute path to worktree */
+    path: string;
+    /** HEAD commit SHA */
+    head?: string;
+    /** Branch name (without refs/heads/ prefix) */
+    branch?: string;
+}
+/**
+ * Parse git worktree list --porcelain output into structured entries
+ *
+ * @param {string} porcelainOutput - Output from git worktree list --porcelain
+ * @returns {WorktreeEntry[]} Parsed worktree entries
+ */
+export declare function parseWorktreeList(porcelainOutput: string): WorktreeEntry[];
+/**
+ * Get set of tracked worktree paths from git
+ *
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @returns {Promise<Set<string>>} Set of absolute paths tracked by git worktree
+ */
+export declare function getTrackedWorktreePaths(projectRoot: UnsafeAny): Promise<Set<string>>;
+/**
+ * Identify tracked worktrees that are missing on disk
+ *
+ * @param {string[]} trackedPaths - Absolute paths from git worktree list
+ * @param {(path: string) => boolean} [existsFn] - Optional fs.existsSync override
+ * @returns {string[]} Missing worktree paths
+ */
+export declare function getMissingWorktreesFromTracked(trackedPaths: UnsafeAny, existsFn?: typeof existsSync): any[];
+/**
+ * Detect tracked worktrees that are missing on disk
+ *
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @returns {Promise<string[]>} Missing tracked worktree paths
+ */
+export declare function detectMissingTrackedWorktrees(projectRoot: UnsafeAny): Promise<any[]>;
+/**
+ * Get list of directories in worktrees/ folder
+ *
+ * @param {string} projectRoot - Absolute path to project root
+ * @returns {string[]} List of absolute paths to directories in worktrees/
+ */
+export declare function getWorktreeDirectories(projectRoot: UnsafeAny): string[];
+/**
+ * Detect orphan worktree directories
+ *
+ * Compares directories in worktrees/ against git worktree list to find
+ * directories that exist on disk but are not tracked by git.
+ *
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @returns {Promise<OrphanDetectionResult>} Detection result with orphans and tracked paths
+ */
+export declare function detectOrphanWorktrees(projectRoot: UnsafeAny): Promise<{
+    orphans: string[];
+    tracked: string[];
+    errors: string[];
+}>;
+/**
+ * Check if a specific worktree path is an orphan
+ *
+ * Used by wu:claim for pre-flight checks before creating a worktree.
+ *
+ * @param {string} worktreePath - Absolute path to check
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @returns {Promise<boolean>} True if the path exists but is not tracked by git
+ */
+export declare function isOrphanWorktree(worktreePath: UnsafeAny, projectRoot: UnsafeAny): Promise<boolean>;
+/**
+ * Options for removing orphan directories
+ */
+export interface RemoveOrphanDirectoryOptions {
+    /** If true, don't actually remove */
+    dryRun?: boolean;
+}
+/**
+ * Remove an orphan directory
+ *
+ * Safely removes an orphan worktree directory from disk.
+ * Only removes directories that are confirmed orphans.
+ *
+ * @param {string} orphanPath - Absolute path to orphan directory
+ * @param {RemoveOrphanDirectoryOptions} [options] - Options
+ * @returns {Promise<{removed: boolean, path: string, error?: string}>} Result
+ */
+export declare function removeOrphanDirectory(orphanPath: UnsafeAny, options?: RemoveOrphanDirectoryOptions): Promise<{
+    removed: boolean;
+    path: any;
+    error: string;
+    dryRun?: undefined;
+} | {
+    removed: boolean;
+    path: any;
+    dryRun: boolean;
+    error?: undefined;
+} | {
+    removed: boolean;
+    path: any;
+    error?: undefined;
+    dryRun?: undefined;
+}>;
+/**
+ * Clean up all orphan directories
+ *
+ * Detects and removes all orphan worktree directories.
+ *
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @param {RemoveOrphanDirectoryOptions} [options] - Options
+ * @returns {Promise<{detected: number, removed: number, errors: string[]}>} Summary
+ */
+export declare function cleanupOrphanDirectories(projectRoot: UnsafeAny, options?: RemoveOrphanDirectoryOptions): Promise<{
+    detected: number;
+    removed: number;
+    errors: string[];
+}>;
+export {};
+//# sourceMappingURL=orphan-detector.d.ts.map

package/dist/orphan-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-detector.d.ts","sourceRoot":"","sources":["../src/orphan-detector.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAyB,UAAU,EAAU,MAAM,SAAS,CAAC;AAKpE;;;;;;GAMG;AAEH;;GAEG;AACH,UAAU,aAAa;IACrB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,EAAE,CAmC1E;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,SAAS,wBAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,oBAAa,SAK5F;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,WAAW,EAAE,SAAS,kBAIzE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,SAAS,YAe5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,SAAS;;;;GAyBjE;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,oBASrF;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,SAAS,EACrB,OAAO,GAAE,4BAAiC;;;;;;;;;;;;;;;GA0C3C;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,SAAS,EACtB,OAAO,GAAE,4BAAiC;;;;GAqB3C"}

package/dist/orphan-detector.js

@@ -0,0 +1,253 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Orphan Worktree Detector (WU-1476)
+ *
+ * Detects orphan directories in worktrees/ that are not tracked by git worktree.
+ * Orphan directories can occur when wu:done fails mid-workflow due to:
+ * - Backlog sync issues
+ * - Formatting errors
+ * - Typecheck failures
+ * - Recovery mode interruptions
+ *
+ * Multi-layer defense strategy:
+ * - Layer 1: Explicit cleanup in git-adapter.worktreeRemove()
+ * - Layer 2: Orphan detection in wu:prune (this module)
+ * - Layer 3: Pre-flight check in wu:claim
+ * - Layer 4: Manual utility wu:cleanup-orphans
+ *
+ * @see {@link packages/@lumenflow/cli/src/wu-prune.ts} - Primary consumer
+ * @see {@link packages/@lumenflow/cli/src/wu-claim.ts} - Pre-flight orphan check
+ * @see {@link packages/@lumenflow/cli/src/lib/git-adapter.ts} - worktreeRemove with cleanup
+ */
+import { readdirSync, statSync, existsSync, rmSync } from 'node:fs';
+import path from 'node:path';
+import { getGitForCwd, createGitForPath } from './git-adapter.js';
+import { STRING_LITERALS, DEFAULTS } from './wu-constants.js';
+/**
+ * Parse git worktree list --porcelain output into structured entries
+ *
+ * @param {string} porcelainOutput - Output from git worktree list --porcelain
+ * @returns {WorktreeEntry[]} Parsed worktree entries
+ */
+export function parseWorktreeList(porcelainOutput) {
+    if (!porcelainOutput || porcelainOutput.trim() === '') {
+        return [];
+    }
+    const worktrees = [];
+    const lines = porcelainOutput.split(STRING_LITERALS.NEWLINE);
+    let current = {};
+    for (const line of lines) {
+        if (line.startsWith('worktree ')) {
+            if (current.path) {
+                worktrees.push(current);
+            }
+            current = { path: line.substring(9).trim() };
+        }
+        else if (line.startsWith('HEAD ')) {
+            current.head = line.substring(5).trim();
+        }
+        else if (line.startsWith('branch ')) {
+            const fullRef = line.substring(7).trim();
+            // Extract branch name from refs/heads/...
+            current.branch = fullRef.replace(/^refs\/heads\//, '');
+        }
+        else if (line === '') {
+            if (current.path) {
+                worktrees.push(current);
+            }
+            current = {};
+        }
+    }
+    // Handle final entry without trailing newline
+    if (current.path) {
+        worktrees.push(current);
+    }
+    return worktrees;
+}
+/**
+ * Get set of tracked worktree paths from git
+ *
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @returns {Promise<Set<string>>} Set of absolute paths tracked by git worktree
+ */
+export async function getTrackedWorktreePaths(projectRoot) {
+    const git = projectRoot ? createGitForPath(projectRoot) : getGitForCwd();
+    const output = await git.worktreeList();
+    const entries = parseWorktreeList(output);
+    return new Set(entries.map((e) => e.path));
+}
+/**
+ * Identify tracked worktrees that are missing on disk
+ *
+ * @param {string[]} trackedPaths - Absolute paths from git worktree list
+ * @param {(path: string) => boolean} [existsFn] - Optional fs.existsSync override
+ * @returns {string[]} Missing worktree paths
+ */
+export function getMissingWorktreesFromTracked(trackedPaths, existsFn = existsSync) {
+    if (!Array.isArray(trackedPaths)) {
+        return [];
+    }
+    return trackedPaths.filter((trackedPath) => !existsFn(trackedPath));
+}
+/**
+ * Detect tracked worktrees that are missing on disk
+ *
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @returns {Promise<string[]>} Missing tracked worktree paths
+ */
+export async function detectMissingTrackedWorktrees(projectRoot) {
+    const root = projectRoot || process.cwd();
+    const tracked = await getTrackedWorktreePaths(root);
+    return getMissingWorktreesFromTracked([...tracked]);
+}
+/**
+ * Get list of directories in worktrees/ folder
+ *
+ * @param {string} projectRoot - Absolute path to project root
+ * @returns {string[]} List of absolute paths to directories in worktrees/
+ */
+export function getWorktreeDirectories(projectRoot) {
+    const worktreesDir = path.join(projectRoot, DEFAULTS.WORKTREES_DIR);
+    if (!existsSync(worktreesDir)) {
+        return [];
+    }
+    try {
+        const entries = readdirSync(worktreesDir, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => path.join(worktreesDir, entry.name));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Detect orphan worktree directories
+ *
+ * Compares directories in worktrees/ against git worktree list to find
+ * directories that exist on disk but are not tracked by git.
+ *
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @returns {Promise<OrphanDetectionResult>} Detection result with orphans and tracked paths
+ */
+export async function detectOrphanWorktrees(projectRoot) {
+    const errors = [];
+    const root = projectRoot || process.cwd();
+    // Get paths tracked by git worktree
+    let trackedPaths;
+    try {
+        trackedPaths = await getTrackedWorktreePaths(root);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        errors.push(`Failed to get git worktree list: ${message}`);
+        return { orphans: [], tracked: [], errors };
+    }
+    // Get directories on disk
+    const diskDirectories = getWorktreeDirectories(root);
+    // Find orphans: directories that exist but aren't tracked
+    const orphans = diskDirectories.filter((dir) => !trackedPaths.has(dir));
+    return {
+        orphans,
+        tracked: [...trackedPaths],
+        errors,
+    };
+}
+/**
+ * Check if a specific worktree path is an orphan
+ *
+ * Used by wu:claim for pre-flight checks before creating a worktree.
+ *
+ * @param {string} worktreePath - Absolute path to check
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @returns {Promise<boolean>} True if the path exists but is not tracked by git
+ */
+export async function isOrphanWorktree(worktreePath, projectRoot) {
+    // If directory doesn't exist, it's not an orphan
+    if (!existsSync(worktreePath)) {
+        return false;
+    }
+    // Check if path is in the tracked set
+    const trackedPaths = await getTrackedWorktreePaths(projectRoot);
+    return !trackedPaths.has(worktreePath);
+}
+/**
+ * Remove an orphan directory
+ *
+ * Safely removes an orphan worktree directory from disk.
+ * Only removes directories that are confirmed orphans.
+ *
+ * @param {string} orphanPath - Absolute path to orphan directory
+ * @param {RemoveOrphanDirectoryOptions} [options] - Options
+ * @returns {Promise<{removed: boolean, path: string, error?: string}>} Result
+ */
+export async function removeOrphanDirectory(orphanPath, options = {}) {
+    const { dryRun = false } = options;
+    // Verify it exists
+    if (!existsSync(orphanPath)) {
+        return { removed: false, path: orphanPath, error: 'Directory does not exist' };
+    }
+    // Verify it's a directory
+    try {
+        const stat = statSync(orphanPath);
+        if (!stat.isDirectory()) {
+            return { removed: false, path: orphanPath, error: 'Path is not a directory' };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { removed: false, path: orphanPath, error: `Failed to stat: ${message}` };
+    }
+    // Verify it's in worktrees/ directory (safety check)
+    const basename = path.basename(path.dirname(orphanPath));
+    if (basename !== DEFAULTS.WORKTREES_DIR) {
+        return {
+            removed: false,
+            path: orphanPath,
+            error: `Safety check failed: not in ${DEFAULTS.WORKTREES_DIR}/ directory`,
+        };
+    }
+    if (dryRun) {
+        return { removed: false, path: orphanPath, dryRun: true };
+    }
+    // Remove the directory
+    try {
+        rmSync(orphanPath, { recursive: true, force: true });
+        return { removed: true, path: orphanPath };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { removed: false, path: orphanPath, error: `Failed to remove: ${message}` };
+    }
+}
+/**
+ * Clean up all orphan directories
+ *
+ * Detects and removes all orphan worktree directories.
+ *
+ * @param {string} [projectRoot] - Project root directory (defaults to cwd)
+ * @param {RemoveOrphanDirectoryOptions} [options] - Options
+ * @returns {Promise<{detected: number, removed: number, errors: string[]}>} Summary
+ */
+export async function cleanupOrphanDirectories(projectRoot, options = {}) {
+    const { dryRun = false } = options;
+    const result = await detectOrphanWorktrees(projectRoot);
+    const errors = [...result.errors];
+    let removed = 0;
+    for (const orphanPath of result.orphans) {
+        const removeResult = await removeOrphanDirectory(orphanPath, { dryRun });
+        if (removeResult.removed) {
+            removed++;
+        }
+        else if (removeResult.error) {
+            errors.push(`${orphanPath}: ${removeResult.error}`);
+        }
+    }
+    return {
+        detected: result.orphans.length,
+        removed,
+        errors,
+    };
+}
+//# sourceMappingURL=orphan-detector.js.map

package/dist/orphan-detector.js.map

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

package/dist/pack-authoring-template-engine.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export declare const PACK_AUTHORING_TEMPLATE_IDS: {
+    readonly FILE_READ_TEXT: "file.read_text";
+    readonly FILE_WRITE_TEXT: "file.write_text";
+    readonly HTTP_GET_JSON: "http.get_json";
+};
+export type PackAuthoringTemplateId = (typeof PACK_AUTHORING_TEMPLATE_IDS)[keyof typeof PACK_AUTHORING_TEMPLATE_IDS];
+export declare const PackAuthorTemplateConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    template_id: z.ZodLiteral<"file.read_text">;
+    tool_name: z.ZodString;
+    scope_pattern: z.ZodString;
+    max_bytes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    template_id: z.ZodLiteral<"file.write_text">;
+    tool_name: z.ZodString;
+    scope_pattern: z.ZodString;
+    max_bytes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    template_id: z.ZodLiteral<"http.get_json">;
+    tool_name: z.ZodString;
+    allowed_urls: z.ZodArray<z.ZodString>;
+    timeout_ms: z.ZodDefault<z.ZodNumber>;
+    max_bytes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>], "template_id">;
+export type PackAuthorTemplateConfig = z.infer<typeof PackAuthorTemplateConfigSchema>;
+export declare const PackAuthoringRequestSchema: z.ZodObject<{
+    pack_id: z.ZodString;
+    version: z.ZodString;
+    task_types: z.ZodArray<z.ZodString>;
+    templates: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        template_id: z.ZodLiteral<"file.read_text">;
+        tool_name: z.ZodString;
+        scope_pattern: z.ZodString;
+        max_bytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        template_id: z.ZodLiteral<"file.write_text">;
+        tool_name: z.ZodString;
+        scope_pattern: z.ZodString;
+        max_bytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        template_id: z.ZodLiteral<"http.get_json">;
+        tool_name: z.ZodString;
+        allowed_urls: z.ZodArray<z.ZodString>;
+        timeout_ms: z.ZodDefault<z.ZodNumber>;
+        max_bytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>], "template_id">>;
+}, z.core.$strict>;
+export type PackAuthoringRequest = z.infer<typeof PackAuthoringRequestSchema>;
+export interface PackAuthoringArtifacts {
+    manifest_yaml: string;
+    files: Record<string, string>;
+}
+export declare function generatePackAuthoringArtifacts(input: unknown): PackAuthoringArtifacts;
+//# sourceMappingURL=pack-authoring-template-engine.d.ts.map

package/dist/pack-authoring-template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-authoring-template-engine.d.ts","sourceRoot":"","sources":["../src/pack-authoring-template-engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAkHjF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;mCAIzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;kBAwBnC,CAAC;AAEL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAQ9E,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAqVD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CA2BrF"}