@lumenflow/core 4.23.0 → 5.0.0

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

@@ -33,7 +33,7 @@ export * from './schemas/agents-config.js';
 export * from './schemas/lanes-config.js';
 export * from './schemas/cloud-config.js';
 export * from './schemas/operational-config.js';
-export type { MethodologyConfig, MethodologyOverrides, WorkClassificationUi, WorkClassificationSchemaConfig, } from './resolve-policy.js';
+export type { MethodologyConfig, MethodologyOverrides, WorkClassificationUi, WorkClassificationSchemaConfig, } from '@lumenflow/packs-software-delivery/policy/resolve-policy';
 /**
  * Complete LumenFlow configuration schema
  *
@@ -113,8 +113,8 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
         defaultType: z.ZodDefault<z.ZodString>;
         brief: z.ZodDefault<z.ZodObject<{
             policyMode: z.ZodDefault<z.ZodEnum<{
-                manual: "manual";
                 off: "off";
+                manual: "manual";
                 auto: "auto";
                 required: "required";
             }>>;
@@ -139,9 +139,26 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
         enableInvariants: z.ZodDefault<z.ZodBoolean>;
         tdd_diff_evidence: z.ZodOptional<z.ZodObject<{
             mode: z.ZodOptional<z.ZodEnum<{
-                block: "block";
+                off: "off";
                 warn: "warn";
+                block: "block";
+            }>>;
+            applies_to_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                feature: "feature";
+                bug: "bug";
+                documentation: "documentation";
+                process: "process";
+                tooling: "tooling";
+                chore: "chore";
+                refactor: "refactor";
+            }>>>;
+            exempt_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        tdd_ordering: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodOptional<z.ZodEnum<{
                 off: "off";
+                warn: "warn";
+                block: "block";
             }>>;
             applies_to_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 feature: "feature";
@@ -152,6 +169,8 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
                 chore: "chore";
                 refactor: "refactor";
             }>>>;
+            min_runtime_loc_per_commit_without_tests: z.ZodOptional<z.ZodNumber>;
+            grace_commits: z.ZodOptional<z.ZodNumber>;
             exempt_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
         execution: z.ZodOptional<z.ZodObject<{
@@ -197,18 +216,18 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
         ignore_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
         lane_health: z.ZodDefault<z.ZodEnum<{
-            warn: "warn";
-            off: "off";
             error: "error";
+            off: "off";
+            warn: "warn";
         }>>;
         co_change: z.ZodDefault<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             trigger_patterns: z.ZodArray<z.ZodString>;
             require_patterns: z.ZodArray<z.ZodString>;
             severity: z.ZodDefault<z.ZodEnum<{
-                warn: "warn";
-                off: "off";
                 error: "error";
+                off: "off";
+                warn: "warn";
             }>>;
             guidance: z.ZodOptional<z.ZodString>;
             guidance_ref: z.ZodOptional<z.ZodString>;
@@ -218,9 +237,9 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
             trigger_patterns: z.ZodArray<z.ZodString>;
             command: z.ZodString;
             severity: z.ZodDefault<z.ZodEnum<{
-                warn: "warn";
-                off: "off";
                 error: "error";
+                off: "off";
+                warn: "warn";
             }>>;
             guidance: z.ZodOptional<z.ZodString>;
             guidance_ref: z.ZodOptional<z.ZodString>;
@@ -258,9 +277,9 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
                 interval_tool_calls: z.ZodDefault<z.ZodNumber>;
             }, z.core.$strip>>;
             require_checkpoint_for_done: z.ZodDefault<z.ZodEnum<{
-                block: "block";
-                warn: "warn";
                 off: "off";
+                warn: "warn";
+                block: "block";
             }>>;
         }, z.core.$strip>>;
         decay: z.ZodOptional<z.ZodObject<{
@@ -319,13 +338,22 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
             principles: z.ZodDefault<z.ZodArray<z.ZodString>>;
             notes: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        stream_watchdog: z.ZodOptional<z.ZodObject<{
+            timeout_seconds: z.ZodDefault<z.ZodNumber>;
+            heartbeat_cadence_seconds: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        monitor_quality_signals: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            min_runtime_loc: z.ZodDefault<z.ZodNumber>;
+            grace_minutes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     experimental: z.ZodDefault<z.ZodObject<{
         context_validation: z.ZodDefault<z.ZodBoolean>;
         validation_mode: z.ZodDefault<z.ZodEnum<{
-            warn: "warn";
-            off: "off";
             error: "error";
+            off: "off";
+            warn: "warn";
         }>>;
         show_next_steps: z.ZodDefault<z.ZodBoolean>;
         recovery_command: z.ZodDefault<z.ZodBoolean>;
@@ -357,9 +385,9 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
         overrides: z.ZodOptional<z.ZodObject<{
             coverage_threshold: z.ZodOptional<z.ZodNumber>;
             coverage_mode: z.ZodOptional<z.ZodEnum<{
-                block: "block";
                 warn: "warn";
                 off: "off";
+                block: "block";
             }>>;
         }, z.core.$strip>>;
         work_classification: z.ZodOptional<z.ZodObject<{
@@ -396,9 +424,9 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
             wip_limit: z.ZodOptional<z.ZodNumber>;
             wip_justification: z.ZodOptional<z.ZodString>;
             lock_policy: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
-                none: "none";
                 all: "all";
                 active: "active";
+                none: "none";
             }>>>;
             code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
@@ -407,9 +435,9 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
             wip_limit: z.ZodOptional<z.ZodNumber>;
             wip_justification: z.ZodOptional<z.ZodString>;
             lock_policy: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
-                none: "none";
                 all: "all";
                 active: "active";
+                none: "none";
             }>>>;
             code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
@@ -418,9 +446,9 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
             wip_limit: z.ZodOptional<z.ZodNumber>;
             wip_justification: z.ZodOptional<z.ZodString>;
             lock_policy: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
-                none: "none";
                 all: "all";
                 active: "active";
+                none: "none";
             }>>>;
             code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
@@ -521,7 +549,7 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
         defaultStatus: string;
         defaultType: string;
         brief: {
-            policyMode: "manual" | "off" | "auto" | "required";
+            policyMode: "off" | "manual" | "auto" | "required";
             freshnessMinutes: number;
         };
     };
@@ -550,19 +578,19 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
             typecheck?: string | undefined;
             format?: string | undefined;
         };
-        lane_health: "warn" | "off" | "error";
+        lane_health: "error" | "off" | "warn";
         co_change: {
             name: string;
             trigger_patterns: string[];
             require_patterns: string[];
-            severity: "warn" | "off" | "error";
+            severity: "error" | "off" | "warn";
             guidance?: string | undefined;
             guidance_ref?: string | undefined;
         }[];
         conditional_commands: {
             trigger_patterns: string[];
             command: string;
-            severity: "warn" | "off" | "error";
+            severity: "error" | "off" | "warn";
             name?: string | undefined;
             guidance?: string | undefined;
             guidance_ref?: string | undefined;
@@ -573,8 +601,15 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
             skip_types: string[];
         };
         tdd_diff_evidence?: {
-            mode?: "block" | "warn" | "off" | undefined;
+            mode?: "off" | "warn" | "block" | undefined;
+            applies_to_types?: ("feature" | "bug" | "documentation" | "process" | "tooling" | "chore" | "refactor")[] | undefined;
+            exempt_paths?: string[] | undefined;
+        } | undefined;
+        tdd_ordering?: {
+            mode?: "off" | "warn" | "block" | undefined;
             applies_to_types?: ("feature" | "bug" | "documentation" | "process" | "tooling" | "chore" | "refactor")[] | undefined;
+            min_runtime_loc_per_commit_without_tests?: number | undefined;
+            grace_commits?: number | undefined;
             exempt_paths?: string[] | undefined;
         } | undefined;
         execution?: {
@@ -637,7 +672,7 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
                 enabled: boolean;
                 interval_tool_calls: number;
             };
-            require_checkpoint_for_done: "block" | "warn" | "off";
+            require_checkpoint_for_done: "off" | "warn" | "block";
         } | undefined;
         decay?: {
             enabled: boolean;
@@ -690,10 +725,19 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
             principles: string[];
             notes?: string | undefined;
         };
+        stream_watchdog?: {
+            timeout_seconds: number;
+            heartbeat_cadence_seconds: number;
+        } | undefined;
+        monitor_quality_signals?: {
+            enabled: boolean;
+            min_runtime_loc: number;
+            grace_minutes: number;
+        } | undefined;
     };
     experimental: {
         context_validation: boolean;
-        validation_mode: "warn" | "off" | "error";
+        validation_mode: "error" | "off" | "warn";
         show_next_steps: boolean;
         recovery_command: boolean;
     };
@@ -720,11 +764,11 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
     test_runner: "vitest" | "jest" | "mocha";
     build_command: string;
     methodology?: {
-        testing: "tdd" | "test-after" | "none";
+        testing: "none" | "tdd" | "test-after";
         architecture: "none" | "hexagonal" | "layered";
         overrides?: {
             coverage_threshold?: number | undefined;
-            coverage_mode?: "block" | "warn" | "off" | undefined;
+            coverage_mode?: "off" | "warn" | "block" | undefined;
         } | undefined;
         work_classification?: {
             ui?: {
@@ -746,21 +790,21 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
         } | undefined;
         definitions?: {
             name: string;
-            lock_policy: "none" | "all" | "active";
+            lock_policy: "all" | "active" | "none";
             wip_limit?: number | undefined;
             wip_justification?: string | undefined;
             code_paths?: string[] | undefined;
         }[] | undefined;
         engineering?: {
             name: string;
-            lock_policy: "none" | "all" | "active";
+            lock_policy: "all" | "active" | "none";
             wip_limit?: number | undefined;
             wip_justification?: string | undefined;
             code_paths?: string[] | undefined;
         }[] | undefined;
         business?: {
             name: string;
-            lock_policy: "none" | "all" | "active";
+            lock_policy: "all" | "active" | "none";
             wip_limit?: number | undefined;
             wip_justification?: string | undefined;
             code_paths?: string[] | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"lumenflow-config-schema.d.ts","sourceRoot":"","sources":["../src/lumenflow-config-schema.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAyBhD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkEhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,OAAY,GAAG,eAAe,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAElD"}
+{"version":3,"file":"lumenflow-config-schema.d.ts","sourceRoot":"","sources":["../src/lumenflow-config-schema.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAyBhD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,0DAA0D,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkEhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,OAAY,GAAG,eAAe,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAElD"}

package/dist/lumenflow-config-schema.js

@@ -25,7 +25,7 @@
  */
 import { z } from 'zod';
 // WU-1259: Import methodology config schema for resolvePolicy()
-import { MethodologyConfigSchema } from './resolve-policy.js';
+import { MethodologyConfigSchema } from '@lumenflow/packs-software-delivery/policy/resolve-policy';
 // --- Re-export per-section schemas and types ---
 export * from './schemas/workspace-config.js';
 export * from './schemas/directories-config.js';

package/dist/lumenflow-config-schema.js.map

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

package/dist/lumenflow-config.d.ts

@@ -1,32 +1,14 @@
 /// <reference path="./types.d.ts" />
 import { type LumenFlowConfig } from './lumenflow-config-schema.js';
-/** Canonical workspace config file name (workspace-first architecture) */
-export { GIT_DIRECTORY_NAME, GIT_WORKTREES_SENTINEL, WORKSPACE_CONFIG_FILE_NAME, } from './config-contract.js';
-/** WU-2185: Re-export routing constants for config:set workspace-aware routing */
-export { WORKSPACE_ROOT_KEYS, WRITABLE_ROOT_KEYS, MANAGED_ROOT_KEYS, type WorkspaceRootKey, } from './config-contract.js';
-/** Presence of canonical workspace config in a project root. */
-export interface ConfigFilePresence {
-    workspaceConfigExists: boolean;
-}
+export { findProjectRoot, getConfigFilePresence, getWorkspaceInitCommand, getDocsGenerateCommand, resolvePath, type ConfigFilePresence, } from '@lumenflow/host/workspace-config/lumenflow-config';
+export { GIT_DIRECTORY_NAME, GIT_WORKTREES_SENTINEL, WORKSPACE_CONFIG_FILE_NAME, WORKSPACE_ROOT_KEYS, WRITABLE_ROOT_KEYS, MANAGED_ROOT_KEYS, type WorkspaceRootKey, } from '@lumenflow/kernel/primitives/workspace-constants';
 /**
- * Detect whether canonical workspace config file exists.
+ * Get LumenFlow configuration (typed).
  *
- * @param projectRoot - Project root directory
- * @returns File presence booleans for canonical workspace config file
- */
-export declare function getConfigFilePresence(projectRoot: string): ConfigFilePresence;
-/**
- * Find project root by looking for workspace.yaml, then .git
- *
- * @param startDir - Directory to start searching from
- * @returns Project root path or current working directory
- */
-export declare function findProjectRoot(startDir?: string): string;
-/**
- * Get LumenFlow configuration
+ * Wraps host's raw loader with Zod parsing via `LumenFlowConfigSchema`.
  *
  * Resolution order:
- * 1. `workspace.yaml` → `software_delivery` block (canonical)
+ * 1. `workspace.yaml` → `software_delivery` block (canonical, via host)
  * 2. defaults from schema
  *
  * @param options - Options for loading config
@@ -41,7 +23,8 @@ export declare function getConfig(options?: {
     strictWorkspace?: boolean;
 }): LumenFlowConfig;
 /**
- * Get the project root directory
+ * Get the project root directory. Prefers the core-side cache populated by
+ * `getConfig(...)`; otherwise delegates to host's loader.
  *
  * @returns Cached project root or finds it
  */
@@ -55,19 +38,12 @@ export declare function getProjectRoot(): string;
  *
  * Also useful in tests that manipulate workspace.yaml between assertions.
  *
+ * Clears both core's typed cache and host's project-root cache so downstream
+ * primitive calls see a fresh state.
+ *
  * @see WU-2126
  */
 export declare function clearConfigCache(): void;
-export declare function getWorkspaceInitCommand(projectRoot?: string): string;
-export declare function getDocsGenerateCommand(projectRoot?: string): string;
-/**
- * Resolve a path relative to project root
- *
- * @param relativePath - Relative path from config
- * @param projectRoot - Optional project root override
- * @returns Absolute path
- */
-export declare function resolvePath(relativePath: string, projectRoot?: string): string;
 /**
  * Get resolved paths for common directories
  *

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

@@ -1 +1 @@
-{"version":3,"file":"lumenflow-config.d.ts","sourceRoot":"","sources":["../src/lumenflow-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lumenflow-config.d.ts","sourceRoot":"","sources":["../src/lumenflow-config.ts"],"names":[],"mappings":"AA8BA,OAAO,EACL,KAAK,eAAe,EAMrB,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,mDAAmD,CAAC;AAE3D,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,kDAAkD,CAAC;AAe1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,eAAe,CAoCjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAChE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;CACrB,CA4BA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CA2CA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,IAAI,CA+DN;AAGD,YAAY,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACV,eAAe,EACf,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,GACX,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAIhE,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/lumenflow-config.js

@@ -1,121 +1,45 @@
 // Copyright (c) 2026 Hellmai Ltd
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
- * LumenFlow Configuration Loader
+ * LumenFlow Configuration — typed wrapper + shim.
  *
- * Loads and manages LumenFlow configuration from workspace.yaml
- * (`software_delivery` block).
+ * WU-2684 (INIT-058 L4b): The raw workspace-config loader primitives were relocated
+ * to `@lumenflow/host/workspace-config/lumenflow-config`. This module stays at
+ * `@lumenflow/core/lumenflow-config` as a thin re-export shim plus the typed
+ * helpers (`getConfig`, `getResolvedPaths`, `validateConfigFile`, `createSampleConfig`,
+ * `clearConfigCache`) that require the pack-coupled `LumenFlowConfigSchema`. External
+ * import paths (`@lumenflow/core/config`) are unchanged.
  *
  * @module lumenflow-config
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as yaml from 'yaml';
+import { findProjectRoot, getProjectRoot as getHostProjectRoot, clearProjectRootCache, loadWorkspaceSoftwareDeliveryConfig, getConfigFilePresence, LUMENFLOW_CONFIG_WARNING_PREFIX as CONFIG_WARNING_PREFIX, } from '@lumenflow/host/workspace-config/lumenflow-config';
+import { getWorkspaceInitCommand } from '@lumenflow/host/workspace-config/lumenflow-config';
+import { normalizeConfigKeys } from '@lumenflow/kernel/primitives/normalize-config-keys';
+import { asRecord } from '@lumenflow/kernel/primitives/object-guards';
 import { parseConfig, getDefaultConfig, validateConfig, WorkspaceV2ExtensionsSchema, WORKSPACE_V2_KEYS, } from './lumenflow-config-schema.js';
-import { GIT_DIRECTORY_NAME, WORKSPACE_CONFIG_FILE_NAME } from './config-contract.js';
-import { normalizeConfigKeys } from './normalize-config-keys.js';
-import { asRecord } from './object-guards.js';
-import { createError, ErrorCodes } from './error-handler.js';
-import { resolvePackageManager } from './package-manager-resolver.js';
-/** Canonical workspace config file name (workspace-first architecture) */
-export { GIT_DIRECTORY_NAME, GIT_WORKTREES_SENTINEL, WORKSPACE_CONFIG_FILE_NAME, } from './config-contract.js';
-/** WU-2185: Re-export routing constants for config:set workspace-aware routing */
-export { WORKSPACE_ROOT_KEYS, WRITABLE_ROOT_KEYS, MANAGED_ROOT_KEYS, } from './config-contract.js';
-/** Shared UTF-8 encoding literal for file reads/writes */
+import { WORKSPACE_CONFIG_FILE_NAME } from '@lumenflow/kernel/primitives/workspace-constants';
+import { createError, ErrorCodes } from '@lumenflow/kernel/primitives/error-handler';
+// --- Re-exports for API stability ---
+export { findProjectRoot, getConfigFilePresence, getWorkspaceInitCommand, getDocsGenerateCommand, resolvePath, } from '@lumenflow/host/workspace-config/lumenflow-config';
+export { GIT_DIRECTORY_NAME, GIT_WORKTREES_SENTINEL, WORKSPACE_CONFIG_FILE_NAME, WORKSPACE_ROOT_KEYS, WRITABLE_ROOT_KEYS, MANAGED_ROOT_KEYS, } from '@lumenflow/kernel/primitives/workspace-constants';
+// --- Typed-config layer (schema-parsing) ---
 const UTF8_ENCODING = 'utf8';
-/** Warning prefix for config-loading diagnostics */
-const WARNING_PREFIX = '[lumenflow-config]';
-const WORKSPACE_INIT_SCRIPT = 'workspace:init';
-const DOCS_GENERATE_SCRIPT = 'docs:generate';
-const WORKSPACE_INIT_ARGS = ['--yes'];
 /** Canonical workspace section that stores software-delivery config */
 const WORKSPACE_CONFIG_SECTION = WORKSPACE_V2_KEYS.SOFTWARE_DELIVERY;
-/**
- * Detect whether canonical workspace config file exists.
- *
- * @param projectRoot - Project root directory
- * @returns File presence booleans for canonical workspace config file
- */
-export function getConfigFilePresence(projectRoot) {
-    return {
-        workspaceConfigExists: fs.existsSync(path.join(projectRoot, WORKSPACE_CONFIG_FILE_NAME)),
-    };
-}
-/** Cached config instance */
+/** Cached typed config instance */
 let cachedConfig = null;
-/** Cached project root */
+/** Cached project root (typed-cache side; host keeps its own cache). */
 let cachedProjectRoot = null;
 /**
- * Parse YAML content and coerce it to a plain record.
- *
- * @param content - Raw YAML text
- * @returns Parsed object record, or null when parsed content is not an object
- */
-function parseYamlRecord(content) {
-    return asRecord(yaml.parse(content));
-}
-/**
- * Find project root by looking for workspace.yaml, then .git
+ * Get LumenFlow configuration (typed).
  *
- * @param startDir - Directory to start searching from
- * @returns Project root path or current working directory
- */
-export function findProjectRoot(startDir = process.cwd()) {
-    let currentDir = path.resolve(startDir);
-    const filesystemRoot = path.parse(currentDir).root;
-    while (true) {
-        if (fs.existsSync(path.join(currentDir, WORKSPACE_CONFIG_FILE_NAME))) {
-            return currentDir;
-        }
-        if (fs.existsSync(path.join(currentDir, GIT_DIRECTORY_NAME))) {
-            return currentDir;
-        }
-        if (currentDir === filesystemRoot) {
-            break;
-        }
-        currentDir = path.dirname(currentDir);
-    }
-    return process.cwd();
-}
-/**
- * Load config from canonical workspace.yaml `software_delivery` block.
- *
- * @param projectRoot - Project root directory
- * @returns Parsed software-delivery config object, or null when unavailable/invalid
- */
-function loadWorkspaceSoftwareDeliveryConfig(projectRoot) {
-    const workspacePath = path.join(projectRoot, WORKSPACE_CONFIG_FILE_NAME);
-    if (!fs.existsSync(workspacePath)) {
-        return null;
-    }
-    try {
-        const content = fs.readFileSync(workspacePath, UTF8_ENCODING);
-        const workspaceData = parseYamlRecord(content);
-        if (!workspaceData) {
-            console.warn(`${WARNING_PREFIX} ${WORKSPACE_CONFIG_FILE_NAME} does not contain a valid object root.`);
-            return null;
-        }
-        const parsedExtensions = WorkspaceV2ExtensionsSchema.safeParse(workspaceData);
-        if (!parsedExtensions.success) {
-            const hasSoftwareDeliveryError = parsedExtensions.error.issues.some((issue) => issue.path[0] === WORKSPACE_V2_KEYS.SOFTWARE_DELIVERY);
-            if (hasSoftwareDeliveryError) {
-                console.warn(`${WARNING_PREFIX} ${WORKSPACE_CONFIG_FILE_NAME} is missing a valid ${WORKSPACE_V2_KEYS.SOFTWARE_DELIVERY} block.`);
-            }
-            return null;
-        }
-        // WU-1765: Normalize snake_case YAML keys to camelCase before Zod parsing.
-        return normalizeConfigKeys(parsedExtensions.data[WORKSPACE_V2_KEYS.SOFTWARE_DELIVERY]);
-    }
-    catch (error) {
-        console.warn(`${WARNING_PREFIX} Failed to parse ${WORKSPACE_CONFIG_FILE_NAME}:`, error instanceof Error ? error.message : String(error));
-        return null;
-    }
-}
-/**
- * Get LumenFlow configuration
+ * Wraps host's raw loader with Zod parsing via `LumenFlowConfigSchema`.
  *
  * Resolution order:
- * 1. `workspace.yaml` → `software_delivery` block (canonical)
+ * 1. `workspace.yaml` → `software_delivery` block (canonical, via host)
  * 2. defaults from schema
  *
  * @param options - Options for loading config
@@ -126,26 +50,21 @@ function loadWorkspaceSoftwareDeliveryConfig(projectRoot) {
  */
 export function getConfig(options = {}) {
     const { projectRoot: overrideRoot, reload = false, strictWorkspace = false } = options;
-    // Use cached config if available and not reloading
     if (cachedConfig && !reload && !overrideRoot) {
         return cachedConfig;
     }
-    // Find or use provided project root
     const projectRoot = overrideRoot || findProjectRoot();
     const { workspaceConfigExists } = getConfigFilePresence(projectRoot);
     if (strictWorkspace && !workspaceConfigExists) {
-        throw createError(ErrorCodes.CONFIG_ERROR, `${WARNING_PREFIX} Missing ${WORKSPACE_CONFIG_FILE_NAME}. ` +
+        throw createError(ErrorCodes.CONFIG_ERROR, `${CONFIG_WARNING_PREFIX} Missing ${WORKSPACE_CONFIG_FILE_NAME}. ` +
             `Run \`${getWorkspaceInitCommand(projectRoot)}\` to scaffold workspace config.`);
     }
-    // Canonical workspace-first load path (INIT-033 hard cut)
     const workspaceConfig = loadWorkspaceSoftwareDeliveryConfig(projectRoot);
     if (strictWorkspace && workspaceConfigExists && !workspaceConfig) {
-        throw createError(ErrorCodes.CONFIG_ERROR, `${WARNING_PREFIX} ${WORKSPACE_CONFIG_FILE_NAME} exists but is invalid. ` +
+        throw createError(ErrorCodes.CONFIG_ERROR, `${CONFIG_WARNING_PREFIX} ${WORKSPACE_CONFIG_FILE_NAME} exists but is invalid. ` +
             `Ensure \`${WORKSPACE_CONFIG_SECTION}\` contains valid configuration values.`);
     }
-    // Parse with defaults
     const config = parseConfig(workspaceConfig ?? {});
-    // Cache if using default project root
     if (!overrideRoot) {
         cachedConfig = config;
         cachedProjectRoot = projectRoot;
@@ -153,7 +72,8 @@ export function getConfig(options = {}) {
     return config;
 }
 /**
- * Get the project root directory
+ * Get the project root directory. Prefers the core-side cache populated by
+ * `getConfig(...)`; otherwise delegates to host's loader.
  *
  * @returns Cached project root or finds it
  */
@@ -161,7 +81,7 @@ export function getProjectRoot() {
     if (cachedProjectRoot) {
         return cachedProjectRoot;
     }
-    cachedProjectRoot = findProjectRoot();
+    cachedProjectRoot = getHostProjectRoot();
     return cachedProjectRoot;
 }
 /**
@@ -173,45 +93,15 @@ export function getProjectRoot() {
  *
  * Also useful in tests that manipulate workspace.yaml between assertions.
  *
+ * Clears both core's typed cache and host's project-root cache so downstream
+ * primitive calls see a fresh state.
+ *
  * @see WU-2126
  */
 export function clearConfigCache() {
     cachedConfig = null;
     cachedProjectRoot = null;
-}
-function formatScriptCommand(packageManager, scriptName, args = []) {
-    switch (packageManager) {
-        case 'npm':
-            return args.length > 0
-                ? `npm run ${scriptName} -- ${args.join(' ')}`
-                : `npm run ${scriptName}`;
-        case 'yarn':
-            return args.length > 0 ? `yarn ${scriptName} ${args.join(' ')}` : `yarn ${scriptName}`;
-        case 'bun':
-            return args.length > 0 ? `bun run ${scriptName} ${args.join(' ')}` : `bun run ${scriptName}`;
-        case 'pnpm':
-        default:
-            return args.length > 0 ? `pnpm ${scriptName} ${args.join(' ')}` : `pnpm ${scriptName}`;
-    }
-}
-export function getWorkspaceInitCommand(projectRoot = getProjectRoot()) {
-    return formatScriptCommand(resolvePackageManager(projectRoot), WORKSPACE_INIT_SCRIPT, [
-        ...WORKSPACE_INIT_ARGS,
-    ]);
-}
-export function getDocsGenerateCommand(projectRoot = getProjectRoot()) {
-    return formatScriptCommand(resolvePackageManager(projectRoot), DOCS_GENERATE_SCRIPT);
-}
-/**
- * Resolve a path relative to project root
- *
- * @param relativePath - Relative path from config
- * @param projectRoot - Optional project root override
- * @returns Absolute path
- */
-export function resolvePath(relativePath, projectRoot) {
-    const root = projectRoot || getProjectRoot();
-    return path.join(root, relativePath);
+    clearProjectRootCache();
 }
 /**
  * Get resolved paths for common directories
@@ -262,7 +152,7 @@ export function validateConfigFile(configPath) {
     }
     try {
         const content = fs.readFileSync(configPath, UTF8_ENCODING);
-        const parsedRecord = parseYamlRecord(content);
+        const parsedRecord = asRecord(yaml.parse(content));
         if (!parsedRecord) {
             return { valid: false, errors: ['Root YAML value must be an object'] };
         }