@lumenflow/core 1.3.0 → 1.3.3

package/dist/git-adapter.js

@@ -18,7 +18,7 @@
  */
 import { simpleGit } from 'simple-git';
 import { existsSync, rmSync } from 'node:fs';
-import { GIT_FLAGS } from './wu-constants.js';
+import { GIT_COMMANDS, GIT_FLAGS, GIT_REFS } from './wu-constants.js';
 // WU-2242: Runtime assertion helpers
 /**
  * Assert that a value is a non-empty string
@@ -117,6 +117,20 @@ export class GitAdapter {
         const result = await this.git.raw(['status', GIT_FLAGS.PORCELAIN]);
         return result.trim();
     }
+    /**
+     * Get unpushed commits (compared to upstream)
+     * @returns {Promise<string>} Oneline log output for unpushed commits
+     * @example
+     * await git.getUnpushedCommits(); // "abc123 fix: ...\n"
+     */
+    async getUnpushedCommits() {
+        const result = await this.git.raw([
+            GIT_COMMANDS.LOG,
+            GIT_REFS.UPSTREAM_RANGE,
+            GIT_FLAGS.ONELINE,
+        ]);
+        return result.trim();
+    }
     /**
      * Check if a branch exists
      * @param {string} branch - Branch name

package/dist/index.d.ts

@@ -40,4 +40,7 @@ export * from './dependency-guard.js';
 export * from './stamp-utils.js';
 export * from './lumenflow-config.js';
 export * from './lumenflow-config-schema.js';
+export * from './gates-config.js';
 export * from './branch-check.js';
+export * from './lumenflow-home.js';
+export * from './force-bypass-audit.js';

package/dist/index.js

@@ -59,5 +59,11 @@ export * from './stamp-utils.js';
 // Configuration
 export * from './lumenflow-config.js';
 export * from './lumenflow-config-schema.js';
+// Gates configuration (WU-1067)
+export * from './gates-config.js';
 // Branch check utilities
 export * from './branch-check.js';
+// WU-1062: External plan storage
+export * from './lumenflow-home.js';
+// WU-1070: Force bypass audit logging
+export * from './force-bypass-audit.js';

package/dist/lumenflow-config-schema.d.ts

@@ -67,6 +67,7 @@ export declare const WuConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Gates configuration
+ * Note: GatesExecutionConfigSchema is imported from gates-config.ts
  */
 export declare const GatesConfigSchema: z.ZodObject<{
     maxEslintWarnings: z.ZodDefault<z.ZodNumber>;
@@ -74,6 +75,38 @@ export declare const GatesConfigSchema: z.ZodObject<{
     minCoverage: z.ZodDefault<z.ZodNumber>;
     enableSafetyCriticalTests: z.ZodDefault<z.ZodBoolean>;
     enableInvariants: z.ZodDefault<z.ZodBoolean>;
+    execution: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodString>;
+        setup: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            continueOnError: z.ZodOptional<z.ZodBoolean>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>>;
+        format: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            continueOnError: z.ZodOptional<z.ZodBoolean>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>>;
+        lint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            continueOnError: z.ZodOptional<z.ZodBoolean>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>>;
+        typecheck: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            continueOnError: z.ZodOptional<z.ZodBoolean>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>>;
+        test: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            continueOnError: z.ZodOptional<z.ZodBoolean>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>>;
+        coverage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            threshold: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Memory layer configuration
@@ -227,6 +260,38 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
         minCoverage: z.ZodDefault<z.ZodNumber>;
         enableSafetyCriticalTests: z.ZodDefault<z.ZodBoolean>;
         enableInvariants: z.ZodDefault<z.ZodBoolean>;
+        execution: z.ZodOptional<z.ZodObject<{
+            preset: z.ZodOptional<z.ZodString>;
+            setup: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                continueOnError: z.ZodOptional<z.ZodBoolean>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>>;
+            format: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                continueOnError: z.ZodOptional<z.ZodBoolean>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>>;
+            lint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                continueOnError: z.ZodOptional<z.ZodBoolean>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>>;
+            typecheck: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                continueOnError: z.ZodOptional<z.ZodBoolean>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>>;
+            test: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                continueOnError: z.ZodOptional<z.ZodBoolean>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>>;
+            coverage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                threshold: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     memory: z.ZodDefault<z.ZodObject<{
         directory: z.ZodDefault<z.ZodString>;
@@ -344,6 +409,38 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
         minCoverage: number;
         enableSafetyCriticalTests: boolean;
         enableInvariants: boolean;
+        execution?: {
+            preset?: string;
+            setup?: string | {
+                command: string;
+                continueOnError?: boolean;
+                timeout?: number;
+            };
+            format?: string | {
+                command: string;
+                continueOnError?: boolean;
+                timeout?: number;
+            };
+            lint?: string | {
+                command: string;
+                continueOnError?: boolean;
+                timeout?: number;
+            };
+            typecheck?: string | {
+                command: string;
+                continueOnError?: boolean;
+                timeout?: number;
+            };
+            test?: string | {
+                command: string;
+                continueOnError?: boolean;
+                timeout?: number;
+            };
+            coverage?: string | {
+                command: string;
+                threshold?: number;
+            };
+        };
     };
     memory: {
         directory: string;

package/dist/lumenflow-config-schema.js

@@ -7,6 +7,8 @@
  * @module lumenflow-config-schema
  */
 import { z } from 'zod';
+// WU-1067: Import gates execution schema from canonical source
+import { GatesExecutionConfigSchema } from './gates-config.js';
 /**
  * Directory paths configuration
  */
@@ -110,6 +112,7 @@ export const WuConfigSchema = z.object({
 });
 /**
  * Gates configuration
+ * Note: GatesExecutionConfigSchema is imported from gates-config.ts
  */
 export const GatesConfigSchema = z.object({
     /** Maximum ESLint warnings allowed (default: 100) */
@@ -122,6 +125,12 @@ export const GatesConfigSchema = z.object({
     enableSafetyCriticalTests: z.boolean().default(true),
     /** Enable invariants check (default: true) */
     enableInvariants: z.boolean().default(true),
+    /**
+     * WU-1067: Config-driven gates execution
+     * Custom commands for each gate, with optional preset expansion.
+     * When set, gates runner uses these instead of hardcoded commands.
+     */
+    execution: GatesExecutionConfigSchema.optional(),
 });
 /**
  * Memory layer configuration

package/dist/lumenflow-home.d.ts

@@ -0,0 +1,130 @@
+/**
+ * LumenFlow Home Directory Resolution
+ *
+ * WU-1062: External plan storage and no-main-write mode
+ *
+ * Provides helpers for resolving the $LUMENFLOW_HOME directory and related paths.
+ * Plans are stored externally in $LUMENFLOW_HOME/plans/ instead of in the repo.
+ *
+ * Default: ~/.lumenflow/
+ * Override: Set $LUMENFLOW_HOME environment variable
+ *
+ * @module
+ */
+/**
+ * Environment variable name for LumenFlow home directory
+ */
+export declare const LUMENFLOW_HOME_ENV = "LUMENFLOW_HOME";
+/**
+ * Default LumenFlow home directory name
+ */
+export declare const DEFAULT_LUMENFLOW_DIR = ".lumenflow";
+/**
+ * Plans subdirectory name
+ */
+export declare const PLANS_SUBDIR = "plans";
+/**
+ * Custom protocol for external LumenFlow paths
+ */
+export declare const LUMENFLOW_PROTOCOL = "lumenflow://";
+/**
+ * Environment variable prefix for spec_refs
+ */
+export declare const LUMENFLOW_HOME_VAR_PREFIX = "$LUMENFLOW_HOME";
+/**
+ * Get the LumenFlow home directory path
+ *
+ * Resolution order:
+ * 1. $LUMENFLOW_HOME environment variable (with ~ expansion)
+ * 2. ~/.lumenflow/ default
+ *
+ * @returns {string} Absolute path to LumenFlow home directory
+ *
+ * @example
+ * // With LUMENFLOW_HOME=/custom/path
+ * getLumenflowHome() // '/custom/path'
+ *
+ * @example
+ * // With LUMENFLOW_HOME=~/.custom-lumenflow
+ * getLumenflowHome() // '/home/user/.custom-lumenflow'
+ *
+ * @example
+ * // Without LUMENFLOW_HOME set
+ * getLumenflowHome() // '/home/user/.lumenflow'
+ */
+export declare function getLumenflowHome(): string;
+/**
+ * Get the plans directory path
+ *
+ * Plans are stored in $LUMENFLOW_HOME/plans/
+ *
+ * @returns {string} Absolute path to plans directory
+ *
+ * @example
+ * getPlansDir() // '/home/user/.lumenflow/plans'
+ */
+export declare function getPlansDir(): string;
+/**
+ * Check if a path is an external (non-repo) path
+ *
+ * External paths include:
+ * - Paths starting with ~/
+ * - Paths starting with $LUMENFLOW_HOME
+ * - Paths using lumenflow:// protocol
+ * - Absolute paths (starting with /)
+ *
+ * @param {string} path - Path to check
+ * @returns {boolean} True if path is external
+ *
+ * @example
+ * isExternalPath('~/.lumenflow/plans/plan.md') // true
+ * isExternalPath('$LUMENFLOW_HOME/plans/plan.md') // true
+ * isExternalPath('lumenflow://plans/plan.md') // true
+ * isExternalPath('/home/user/.lumenflow/plans/plan.md') // true
+ * isExternalPath('docs/04-operations/plans/plan.md') // false
+ */
+export declare function isExternalPath(path: string): boolean;
+/**
+ * Normalize a spec_ref path by expanding variables and protocols
+ *
+ * Expands:
+ * - lumenflow://path -> $LUMENFLOW_HOME/path
+ * - ~/path -> /home/user/path
+ * - $LUMENFLOW_HOME/path -> actual LUMENFLOW_HOME value
+ *
+ * Repo-relative paths are returned unchanged.
+ *
+ * @param {string} specRef - Spec reference path
+ * @returns {string} Normalized absolute path or unchanged relative path
+ *
+ * @example
+ * normalizeSpecRef('lumenflow://plans/WU-1062-plan.md')
+ * // '/home/user/.lumenflow/plans/WU-1062-plan.md'
+ *
+ * @example
+ * normalizeSpecRef('docs/04-operations/plans/plan.md')
+ * // 'docs/04-operations/plans/plan.md' (unchanged)
+ */
+export declare function normalizeSpecRef(specRef: string): string;
+/**
+ * Get the full path for a plan file given a WU ID
+ *
+ * @param {string} wuId - Work Unit ID (e.g., 'WU-1062')
+ * @returns {string} Full path to the plan file
+ *
+ * @example
+ * getPlanPath('WU-1062')
+ * // '/home/user/.lumenflow/plans/WU-1062-plan.md'
+ */
+export declare function getPlanPath(wuId: string): string;
+/**
+ * Get the lumenflow:// protocol reference for a plan
+ *
+ * @param {string} wuId - Work Unit ID (e.g., 'WU-1062')
+ * @returns {string} Protocol reference (e.g., 'lumenflow://plans/WU-1062-plan.md')
+ *
+ * @example
+ * getPlanProtocolRef('WU-1062')
+ * // 'lumenflow://plans/WU-1062-plan.md'
+ */
+export declare function getPlanProtocolRef(wuId: string): string;

package/dist/lumenflow-home.js

@@ -0,0 +1,211 @@
+/**
+ * LumenFlow Home Directory Resolution
+ *
+ * WU-1062: External plan storage and no-main-write mode
+ *
+ * Provides helpers for resolving the $LUMENFLOW_HOME directory and related paths.
+ * Plans are stored externally in $LUMENFLOW_HOME/plans/ instead of in the repo.
+ *
+ * Default: ~/.lumenflow/
+ * Override: Set $LUMENFLOW_HOME environment variable
+ *
+ * @module
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { PATH_LITERALS, PATH_SLICE_LENGTHS, STRING_LITERALS } from './wu-constants.js';
+/**
+ * Environment variable name for LumenFlow home directory
+ */
+export const LUMENFLOW_HOME_ENV = 'LUMENFLOW_HOME';
+/**
+ * Default LumenFlow home directory name
+ */
+export const DEFAULT_LUMENFLOW_DIR = '.lumenflow';
+/**
+ * Plans subdirectory name
+ */
+export const PLANS_SUBDIR = 'plans';
+/**
+ * Custom protocol for external LumenFlow paths
+ */
+export const LUMENFLOW_PROTOCOL = 'lumenflow://';
+/**
+ * Environment variable prefix for spec_refs
+ */
+export const LUMENFLOW_HOME_VAR_PREFIX = '$LUMENFLOW_HOME';
+/**
+ * Expand ~ to user's home directory
+ *
+ * @param {string} path - Path that may contain ~
+ * @returns {string} Expanded path
+ */
+function expandTilde(path) {
+    if (path.startsWith(PATH_LITERALS.TILDE_PREFIX)) {
+        return join(homedir(), path.slice(PATH_SLICE_LENGTHS.TILDE_PREFIX_LENGTH));
+    }
+    if (path === PATH_LITERALS.TILDE) {
+        return homedir();
+    }
+    return path;
+}
+/**
+ * Remove trailing slashes from path
+ *
+ * @param {string} path - Path that may have trailing slashes
+ * @returns {string} Path without trailing slashes
+ */
+function removeTrailingSlash(path) {
+    return path.replace(PATH_LITERALS.TRAILING_SLASH_REGEX, STRING_LITERALS.EMPTY);
+}
+/**
+ * Get the LumenFlow home directory path
+ *
+ * Resolution order:
+ * 1. $LUMENFLOW_HOME environment variable (with ~ expansion)
+ * 2. ~/.lumenflow/ default
+ *
+ * @returns {string} Absolute path to LumenFlow home directory
+ *
+ * @example
+ * // With LUMENFLOW_HOME=/custom/path
+ * getLumenflowHome() // '/custom/path'
+ *
+ * @example
+ * // With LUMENFLOW_HOME=~/.custom-lumenflow
+ * getLumenflowHome() // '/home/user/.custom-lumenflow'
+ *
+ * @example
+ * // Without LUMENFLOW_HOME set
+ * getLumenflowHome() // '/home/user/.lumenflow'
+ */
+export function getLumenflowHome() {
+    const envValue = process.env[LUMENFLOW_HOME_ENV];
+    if (envValue) {
+        const expanded = expandTilde(envValue);
+        return removeTrailingSlash(expanded);
+    }
+    return join(homedir(), DEFAULT_LUMENFLOW_DIR);
+}
+/**
+ * Get the plans directory path
+ *
+ * Plans are stored in $LUMENFLOW_HOME/plans/
+ *
+ * @returns {string} Absolute path to plans directory
+ *
+ * @example
+ * getPlansDir() // '/home/user/.lumenflow/plans'
+ */
+export function getPlansDir() {
+    return join(getLumenflowHome(), PLANS_SUBDIR);
+}
+/**
+ * Check if a path is an external (non-repo) path
+ *
+ * External paths include:
+ * - Paths starting with ~/
+ * - Paths starting with $LUMENFLOW_HOME
+ * - Paths using lumenflow:// protocol
+ * - Absolute paths (starting with /)
+ *
+ * @param {string} path - Path to check
+ * @returns {boolean} True if path is external
+ *
+ * @example
+ * isExternalPath('~/.lumenflow/plans/plan.md') // true
+ * isExternalPath('$LUMENFLOW_HOME/plans/plan.md') // true
+ * isExternalPath('lumenflow://plans/plan.md') // true
+ * isExternalPath('/home/user/.lumenflow/plans/plan.md') // true
+ * isExternalPath('docs/04-operations/plans/plan.md') // false
+ */
+export function isExternalPath(path) {
+    // Check for tilde-prefixed paths
+    if (path.startsWith(PATH_LITERALS.TILDE_PREFIX)) {
+        return true;
+    }
+    // Check for environment variable reference
+    if (path.startsWith(LUMENFLOW_HOME_VAR_PREFIX)) {
+        return true;
+    }
+    // Check for lumenflow:// protocol
+    if (path.startsWith(LUMENFLOW_PROTOCOL)) {
+        return true;
+    }
+    // Check for absolute paths (starting with /)
+    if (path.startsWith(STRING_LITERALS.SLASH)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Normalize a spec_ref path by expanding variables and protocols
+ *
+ * Expands:
+ * - lumenflow://path -> $LUMENFLOW_HOME/path
+ * - ~/path -> /home/user/path
+ * - $LUMENFLOW_HOME/path -> actual LUMENFLOW_HOME value
+ *
+ * Repo-relative paths are returned unchanged.
+ *
+ * @param {string} specRef - Spec reference path
+ * @returns {string} Normalized absolute path or unchanged relative path
+ *
+ * @example
+ * normalizeSpecRef('lumenflow://plans/WU-1062-plan.md')
+ * // '/home/user/.lumenflow/plans/WU-1062-plan.md'
+ *
+ * @example
+ * normalizeSpecRef('docs/04-operations/plans/plan.md')
+ * // 'docs/04-operations/plans/plan.md' (unchanged)
+ */
+export function normalizeSpecRef(specRef) {
+    // Handle lumenflow:// protocol
+    if (specRef.startsWith(LUMENFLOW_PROTOCOL)) {
+        const relativePath = specRef.slice(LUMENFLOW_PROTOCOL.length);
+        return join(getLumenflowHome(), relativePath);
+    }
+    // Handle $LUMENFLOW_HOME variable
+    if (specRef.startsWith(LUMENFLOW_HOME_VAR_PREFIX)) {
+        const relativePath = specRef.slice(LUMENFLOW_HOME_VAR_PREFIX.length);
+        // Remove leading slash if present
+        const cleanPath = relativePath.startsWith(STRING_LITERALS.SLASH)
+            ? relativePath.slice(PATH_SLICE_LENGTHS.LEADING_SLASH_LENGTH)
+            : relativePath;
+        return join(getLumenflowHome(), cleanPath);
+    }
+    // Handle tilde expansion
+    if (specRef.startsWith(PATH_LITERALS.TILDE_PREFIX)) {
+        return expandTilde(specRef);
+    }
+    // Return relative paths unchanged
+    return specRef;
+}
+/**
+ * Get the full path for a plan file given a WU ID
+ *
+ * @param {string} wuId - Work Unit ID (e.g., 'WU-1062')
+ * @returns {string} Full path to the plan file
+ *
+ * @example
+ * getPlanPath('WU-1062')
+ * // '/home/user/.lumenflow/plans/WU-1062-plan.md'
+ */
+export function getPlanPath(wuId) {
+    const filename = `${wuId}${PATH_LITERALS.PLAN_FILE_SUFFIX}`;
+    return join(getPlansDir(), filename);
+}
+/**
+ * Get the lumenflow:// protocol reference for a plan
+ *
+ * @param {string} wuId - Work Unit ID (e.g., 'WU-1062')
+ * @returns {string} Protocol reference (e.g., 'lumenflow://plans/WU-1062-plan.md')
+ *
+ * @example
+ * getPlanProtocolRef('WU-1062')
+ * // 'lumenflow://plans/WU-1062-plan.md'
+ */
+export function getPlanProtocolRef(wuId) {
+    const filename = `${wuId}${PATH_LITERALS.PLAN_FILE_SUFFIX}`;
+    return `${LUMENFLOW_PROTOCOL}${PLANS_SUBDIR}${STRING_LITERALS.SLASH}${filename}`;
+}

package/dist/manual-test-validator.d.ts

@@ -18,6 +18,9 @@
  * Path prefixes for hex core code requiring automated tests.
  * These are the critical application layer paths.
  *
+ * WU-1068: Changed from @patientpath to @lumenflow for framework reusability.
+ * Project-specific patterns should be configured in .lumenflow.config.yaml.
+ *
  * @constant {string[]}
  */
 export declare const HEX_CORE_CODE_PATTERNS: readonly string[];

package/dist/manual-test-validator.js

@@ -20,7 +20,7 @@ import { TEST_TYPES, WU_TYPES } from './wu-constants.js';
  * Code file extensions that require automated tests.
  * @constant {string[]}
  */
-const CODE_EXTENSIONS = Object.freeze(['.js', '.ts', '.tsx', '.js']);
+const CODE_EXTENSIONS = Object.freeze(['.js', '.ts', '.tsx', '.mjs']);
 /**
  * Non-code file extensions (documentation, data, config).
  * @constant {string[]}
@@ -40,12 +40,15 @@ const CONFIG_PATTERNS = Object.freeze([
  * Path prefixes for hex core code requiring automated tests.
  * These are the critical application layer paths.
  *
+ * WU-1068: Changed from @patientpath to @lumenflow for framework reusability.
+ * Project-specific patterns should be configured in .lumenflow.config.yaml.
+ *
  * @constant {string[]}
  */
 export const HEX_CORE_CODE_PATTERNS = Object.freeze([
-    'packages/@patientpath/application/',
-    'packages/@patientpath/prompts/',
-    'packages/@patientpath/ports/',
+    'packages/@lumenflow/core/',
+    'packages/@lumenflow/cli/',
+    'packages/@lumenflow/agent/',
 ]);
 /**
  * @deprecated Lane-based exemptions removed in WU-2332.

package/dist/orphan-detector.d.ts

@@ -18,6 +18,7 @@
  * @see {@link tools/wu-claim.mjs} - Pre-flight orphan check
  * @see {@link tools/lib/git-adapter.mjs} - worktreeRemove with cleanup
  */
+import { existsSync } from 'node:fs';
 /**
  * Result of orphan detection
  * @typedef {object} OrphanDetectionResult
@@ -50,6 +51,21 @@ export declare function parseWorktreeList(porcelainOutput: string): WorktreeEntr
  * @returns {Promise<Set<string>>} Set of absolute paths tracked by git worktree
  */
 export declare function getTrackedWorktreePaths(projectRoot: any): 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: any, 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: any): Promise<any[]>;
 /**
  * Get list of directories in worktrees/ folder
  *

package/dist/orphan-detector.js

@@ -75,6 +75,30 @@ export async function getTrackedWorktreePaths(projectRoot) {
     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
  *

package/dist/prompt-linter.js

@@ -249,7 +249,8 @@ export async function lintPrompts(filePaths = [], mode = 'local', configPath = u
     const output = { quiet: options.quiet === true, verbose: options.verbose === true };
     // If no files provided, find all orchestrator prompt files (WU-676 scope only)
     if (filePaths.length === 0) {
-        const pattern = 'packages/@patientpath/prompts/orchestrator-*/**/*.yaml';
+        // WU-1068: Changed from @patientpath to generic ai/prompts for framework reusability
+        const pattern = 'ai/prompts/orchestrator-*/**/*.yaml';
         filePaths = await glob(pattern, { cwd: ROOT_DIR, absolute: true });
     }
     // Load previous metrics for delta calculation

package/dist/prompt-monitor.js

@@ -96,7 +96,9 @@ async function log(event, data) {
 async function monitor() {
     console.log('\n🌙 Nightly Prompt Monitor Starting...\n');
     // Find all prompt files
-    const pattern = 'packages/@patientpath/prompts/**/*.yaml';
+    // WU-1068: Changed from @patientpath to generic ai/prompts for framework reusability
+    // Projects should configure prompt paths in .lumenflow.config.yaml
+    const pattern = 'ai/prompts/**/*.yaml';
     const promptFiles = await glob(pattern, { cwd: ROOT_DIR, absolute: true });
     console.log(`Found ${promptFiles.length} prompt files to analyze\n`);
     // Load yesterday's metrics for delta calculation