@libar-dev/architect 1.0.0-pre.3

package/dist/config/resolve-config.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern ConfigResolver
+ * @architect-status active
+ * @architect-arch-layer application
+ * @architect-arch-context config
+ * @architect-arch-role service
+ * @architect-uses ProjectConfigTypes, ArchitectFactory, ConfigurationDefaults
+ * @architect-used-by ConfigLoader
+ *
+ * ## Config Resolution
+ *
+ * Resolves a raw `ArchitectProjectConfig` into a fully-resolved `ResolvedConfig`
+ * with all defaults applied, stubs merged into TypeScript sources, and context inference
+ * rules prepended to defaults.
+ *
+ * ### Architecture
+ *
+ * ```
+ * ArchitectProjectConfig (user-authored)
+ *     |
+ *     v
+ * resolveProjectConfig() -- creates instance, merges sources, applies defaults
+ *     |
+ *     v
+ * ResolvedConfig { instance, project, isDefault, configPath }
+ * ```
+ *
+ * ### When to Use
+ *
+ * - Called by `loadProjectConfig()` after Zod validation succeeds
+ * - Called directly in tests to resolve a config without file I/O
+ * - `createDefaultResolvedConfig()` provides a fallback when no config file exists
+ */
+import type { ArchitectProjectConfig, ResolvedConfig } from './project-config.js';
+/**
+ * Resolves a raw project config into a fully-resolved config with all defaults applied.
+ *
+ * Resolution steps:
+ * 1. Create taxonomy instance from preset/override fields
+ * 2. Merge stub globs into TypeScript sources
+ * 3. Apply output defaults (directory, overwrite)
+ * 4. Default generators to `['patterns']`
+ * 5. Prepend user context inference rules before defaults
+ * 6. Carry forward remaining fields with defaults
+ *
+ * @param raw - The raw project configuration (post-Zod validation)
+ * @param options - Optional resolution options
+ * @returns Fully resolved configuration ready for use by orchestrator and CLIs
+ */
+export declare function resolveProjectConfig(raw: ArchitectProjectConfig, options: {
+    readonly configPath: string;
+}): ResolvedConfig;
+/**
+ * Creates a default resolved config for when no config file is found.
+ *
+ * Uses the libar-generic preset with empty sources and standard defaults.
+ * The `isDefault` flag is set to `true` so consumers can detect that
+ * no user config was loaded.
+ *
+ * @returns A default ResolvedConfig with empty sources and standard defaults
+ */
+export declare function createDefaultResolvedConfig(): ResolvedConfig;
+//# sourceMappingURL=resolve-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/config/resolve-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EACV,sBAAsB,EAEtB,cAAc,EAGf,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,sBAAsB,EAC3B,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvC,cAAc,CAuEhB;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CA4B5D"}

package/dist/config/resolve-config.js

@@ -0,0 +1,150 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern ConfigResolver
+ * @architect-status active
+ * @architect-arch-layer application
+ * @architect-arch-context config
+ * @architect-arch-role service
+ * @architect-uses ProjectConfigTypes, ArchitectFactory, ConfigurationDefaults
+ * @architect-used-by ConfigLoader
+ *
+ * ## Config Resolution
+ *
+ * Resolves a raw `ArchitectProjectConfig` into a fully-resolved `ResolvedConfig`
+ * with all defaults applied, stubs merged into TypeScript sources, and context inference
+ * rules prepended to defaults.
+ *
+ * ### Architecture
+ *
+ * ```
+ * ArchitectProjectConfig (user-authored)
+ *     |
+ *     v
+ * resolveProjectConfig() -- creates instance, merges sources, applies defaults
+ *     |
+ *     v
+ * ResolvedConfig { instance, project, isDefault, configPath }
+ * ```
+ *
+ * ### When to Use
+ *
+ * - Called by `loadProjectConfig()` after Zod validation succeeds
+ * - Called directly in tests to resolve a config without file I/O
+ * - `createDefaultResolvedConfig()` provides a fallback when no config file exists
+ */
+import { DEFAULT_CONTEXT_INFERENCE_RULES } from './defaults.js';
+import { createArchitect } from './factory.js';
+/**
+ * Resolves a raw project config into a fully-resolved config with all defaults applied.
+ *
+ * Resolution steps:
+ * 1. Create taxonomy instance from preset/override fields
+ * 2. Merge stub globs into TypeScript sources
+ * 3. Apply output defaults (directory, overwrite)
+ * 4. Default generators to `['patterns']`
+ * 5. Prepend user context inference rules before defaults
+ * 6. Carry forward remaining fields with defaults
+ *
+ * @param raw - The raw project configuration (post-Zod validation)
+ * @param options - Optional resolution options
+ * @returns Fully resolved configuration ready for use by orchestrator and CLIs
+ */
+export function resolveProjectConfig(raw, options) {
+    // 1. Create taxonomy instance from preset/override fields
+    const instanceOptions = {};
+    if (raw.preset !== undefined) {
+        instanceOptions.preset = raw.preset;
+    }
+    if (raw.tagPrefix !== undefined) {
+        instanceOptions.tagPrefix = raw.tagPrefix;
+    }
+    if (raw.fileOptInTag !== undefined) {
+        instanceOptions.fileOptInTag = raw.fileOptInTag;
+    }
+    if (raw.categories !== undefined) {
+        instanceOptions.categories = raw.categories;
+    }
+    const instance = createArchitect(instanceOptions);
+    // 2. Resolve sources — merge stubs into typescript
+    const typescript = [
+        ...(raw.sources?.typescript ?? []),
+        ...(raw.sources?.stubs ?? []),
+    ];
+    const features = raw.sources?.features ?? [];
+    const exclude = raw.sources?.exclude ?? [];
+    const sources = {
+        typescript,
+        features,
+        exclude,
+    };
+    // 3. Resolve output — apply defaults
+    const output = {
+        directory: raw.output?.directory ?? 'docs/architecture',
+        overwrite: raw.output?.overwrite ?? false,
+    };
+    // 4. Resolve generators — default to ['patterns']
+    const generators = raw.generators ?? ['patterns'];
+    // 5. Resolve context inference rules — prepend user rules to defaults
+    const contextInferenceRules = [
+        ...(raw.contextInferenceRules ?? []),
+        ...DEFAULT_CONTEXT_INFERENCE_RULES,
+    ];
+    // 6. Copy remaining fields with defaults
+    const generatorOverrides = raw.generatorOverrides ?? {};
+    const workflowPath = raw.workflowPath ?? null;
+    // 7. Reference document configs (explicit opt-in, empty by default)
+    const referenceDocConfigs = raw.referenceDocConfigs ?? [];
+    const project = {
+        sources,
+        output,
+        generators,
+        generatorOverrides,
+        contextInferenceRules,
+        workflowPath,
+        ...(raw.codecOptions !== undefined && { codecOptions: raw.codecOptions }),
+        referenceDocConfigs,
+    };
+    return {
+        instance,
+        project,
+        isDefault: false,
+        configPath: options.configPath,
+    };
+}
+/**
+ * Creates a default resolved config for when no config file is found.
+ *
+ * Uses the libar-generic preset with empty sources and standard defaults.
+ * The `isDefault` flag is set to `true` so consumers can detect that
+ * no user config was loaded.
+ *
+ * @returns A default ResolvedConfig with empty sources and standard defaults
+ */
+export function createDefaultResolvedConfig() {
+    const instance = createArchitect();
+    const sources = {
+        typescript: [],
+        features: [],
+        exclude: [],
+    };
+    const project = {
+        sources,
+        output: {
+            directory: 'docs/architecture',
+            overwrite: false,
+        },
+        generators: ['patterns'],
+        generatorOverrides: {},
+        contextInferenceRules: [...DEFAULT_CONTEXT_INFERENCE_RULES],
+        workflowPath: null,
+        referenceDocConfigs: [],
+    };
+    return {
+        instance,
+        project,
+        isDefault: true,
+        configPath: undefined,
+    };
+}
+//# sourceMappingURL=resolve-config.js.map

package/dist/config/resolve-config.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern ConfigurationTypes
+ * @architect-status completed
+ * @architect-arch-layer domain
+ * @architect-arch-context config
+ * @architect-extract-shapes ArchitectConfig, ArchitectInstance, RegexBuilders
+ *
+ * ## Configuration Types
+ *
+ * Type definitions for the Architect configuration system.
+ * Provides fully type-safe configuration with generics to preserve literal types from presets.
+ *
+ * ### When to Use
+ *
+ * - When defining custom presets or configurations
+ * - When creating type-safe factory functions
+ * - When extending the configuration system
+ */
+import type { TagRegistry } from '../validation-schemas/tag-registry.js';
+import type { CategoryDefinition } from '../taxonomy/categories.js';
+import type { MetadataTagDefinitionForRegistry } from '../taxonomy/registry-builder.js';
+import type { ContextInferenceRule } from '../generators/pipeline/context-inference.js';
+/**
+ * Configuration for creating an Architect instance.
+ * Uses generics to preserve literal types from presets.
+ */
+export interface ArchitectConfig {
+    /** Tag prefix for directives (e.g., "@architect-") */
+    readonly tagPrefix: string;
+    /** File-level opt-in tag (e.g., "@architect") */
+    readonly fileOptInTag: string;
+    /** Category definitions for pattern classification */
+    readonly categories: readonly CategoryDefinition[];
+    /** Optional metadata tag definitions */
+    readonly metadataTags?: readonly MetadataTagDefinitionForRegistry[];
+    /**
+     * Optional context inference rules for auto-inferring bounded context from file paths.
+     *
+     * When provided, these rules are merged with the default rules. User-provided rules
+     * take precedence over defaults (applied first in the rule list).
+     *
+     * @example
+     * ```typescript
+     * contextInferenceRules: [
+     *   { pattern: 'packages/orders/**', context: 'orders' },
+     *   { pattern: 'packages/inventory/**', context: 'inventory' },
+     * ]
+     * ```
+     */
+    readonly contextInferenceRules?: readonly ContextInferenceRule[];
+}
+/**
+ * Instance returned by createArchitect with configured registry
+ */
+export interface ArchitectInstance {
+    /** The fully configured tag registry */
+    readonly registry: TagRegistry;
+    /** Regex builders for tag detection */
+    readonly regexBuilders: RegexBuilders;
+}
+/**
+ * Regex builders for tag detection
+ *
+ * Provides type-safe regex operations for detecting and normalizing tags
+ * based on the configured tag prefix.
+ */
+export interface RegexBuilders {
+    /** Pattern to match file-level opt-in (e.g., /** @architect *\/) */
+    readonly fileOptInPattern: RegExp;
+    /** Pattern to match directives (e.g., @architect-pattern, @architect-status) */
+    readonly directivePattern: RegExp;
+    /** Check if content has the file-level opt-in marker */
+    hasFileOptIn(content: string): boolean;
+    /** Check if content has any doc directives */
+    hasDocDirectives(content: string): boolean;
+    /** Normalize a tag by removing @ and prefix (e.g., "@architect-pattern" -> "pattern") */
+    normalizeTag(tag: string): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC;AACxF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAExF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACpE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,wDAAwD;IACxD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,8CAA8C;IAC9C,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,yFAAyF;IACzF,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC"}

package/dist/config/types.js

@@ -0,0 +1,22 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern ConfigurationTypes
+ * @architect-status completed
+ * @architect-arch-layer domain
+ * @architect-arch-context config
+ * @architect-extract-shapes ArchitectConfig, ArchitectInstance, RegexBuilders
+ *
+ * ## Configuration Types
+ *
+ * Type definitions for the Architect configuration system.
+ * Provides fully type-safe configuration with generics to preserve literal types from presets.
+ *
+ * ### When to Use
+ *
+ * - When defining custom presets or configurations
+ * - When creating type-safe factory functions
+ * - When extending the configuration system
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/config/workflow-loader.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @architect
+ * @architect-config
+ * @architect-pattern WorkflowLoader
+ * @architect-status completed
+ * @architect-arch-layer infrastructure
+ * @architect-arch-context config
+ * @architect-arch-role infrastructure
+ * @architect-uses WorkflowConfigSchema, CodecUtils
+ * @architect-used-by GeneratorOrchestrator, SectionHelpers
+ *
+ * ## WorkflowLoader - Workflow Configuration Loading
+ *
+ * Provides the default 6-phase workflow as an inline constant and loads
+ * custom workflow overrides from JSON files via `--workflow <path>`.
+ *
+ * ### When to Use
+ *
+ * - Use `loadDefaultWorkflow()` at pipeline startup (synchronous, infallible)
+ * - Use `loadWorkflowFromPath()` for custom `--workflow <file>` overrides
+ */
+import { Result } from '../types/result.js';
+import { type LoadedWorkflow, type WorkflowConfig } from '../validation-schemas/workflow-config.js';
+/**
+ * Workflow load error
+ *
+ * Describes why workflow loading failed, with detailed validation errors
+ * if the failure was due to invalid schema.
+ */
+export interface WorkflowLoadError {
+    /** Error type identifier */
+    type: 'workflow-load-error';
+    /** Path or name of the workflow that failed to load */
+    source: string;
+    /** Human-readable error message */
+    message: string;
+    /** Detailed Zod validation errors if schema validation failed */
+    validationErrors?: string[];
+}
+/**
+ * Load workflow configuration from a specific file path
+ *
+ * @param configPath - Absolute or relative path to workflow JSON file
+ * @param source - Source identifier for error messages (defaults to path)
+ * @returns Result with LoadedWorkflow or error details
+ *
+ * @example
+ * ```typescript
+ * const result = await loadWorkflowFromPath("/path/to/custom-workflow.json");
+ * if (result.ok) {
+ *   const workflow = result.value;
+ * }
+ * ```
+ */
+export declare function loadWorkflowFromPath(configPath: string, source?: string): Promise<Result<LoadedWorkflow, WorkflowLoadError>>;
+/**
+ * Load the default workflow (6-phase-standard)
+ *
+ * Returns the standard USDP 6-phase workflow from an inline constant.
+ * Synchronous and infallible — no file I/O, no error handling needed.
+ *
+ * DD-4: Returns LoadedWorkflow synchronously (not Promise).
+ *
+ * @returns LoadedWorkflow for 6-phase-standard
+ *
+ * @example
+ * ```typescript
+ * const workflow = loadDefaultWorkflow();
+ * const emoji = workflow.statusMap.get("completed")?.emoji; // "\u2705"
+ * ```
+ */
+export declare function loadDefaultWorkflow(): LoadedWorkflow;
+/**
+ * Format workflow load error for console display
+ *
+ * @param error - Workflow load error
+ * @returns Formatted error message for console output
+ *
+ * @example
+ * ```typescript
+ * const result = await loadWorkflowFromPath("/path/to/custom.json");
+ * if (!result.ok) {
+ *   console.error(formatWorkflowLoadError(result.error));
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export declare function formatWorkflowLoadError(error: WorkflowLoadError): string;
+export type { LoadedWorkflow, WorkflowConfig };
+//# sourceMappingURL=workflow-loader.d.ts.map

package/dist/config/workflow-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-loader.d.ts","sourceRoot":"","sources":["../../src/config/workflow-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,0CAA0C,CAAC;AAQlD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAkCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC,CAqDpD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CASxE;AAGD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}

package/dist/config/workflow-loader.js

@@ -0,0 +1,167 @@
+/**
+ * @architect
+ * @architect-config
+ * @architect-pattern WorkflowLoader
+ * @architect-status completed
+ * @architect-arch-layer infrastructure
+ * @architect-arch-context config
+ * @architect-arch-role infrastructure
+ * @architect-uses WorkflowConfigSchema, CodecUtils
+ * @architect-used-by GeneratorOrchestrator, SectionHelpers
+ *
+ * ## WorkflowLoader - Workflow Configuration Loading
+ *
+ * Provides the default 6-phase workflow as an inline constant and loads
+ * custom workflow overrides from JSON files via `--workflow <path>`.
+ *
+ * ### When to Use
+ *
+ * - Use `loadDefaultWorkflow()` at pipeline startup (synchronous, infallible)
+ * - Use `loadWorkflowFromPath()` for custom `--workflow <file>` overrides
+ */
+import * as fs from 'fs/promises';
+import { Result } from '../types/result.js';
+import { WorkflowConfigSchema, createLoadedWorkflow, } from '../validation-schemas/workflow-config.js';
+import { createJsonInputCodec } from '../validation-schemas/codec-utils.js';
+/**
+ * Codec for parsing and validating workflow configuration JSON
+ */
+const WorkflowConfigCodec = createJsonInputCodec(WorkflowConfigSchema);
+/**
+ * Default workflow configuration (6-phase USDP standard)
+ *
+ * Inline constant using the 4 canonical statuses from ADR-001.
+ * Replaces the deleted catalogue/workflows/6-phase-standard.json.
+ *
+ * DD-1: Inline constant in workflow-loader.ts, not preset integration.
+ * DD-2: Satisfies existing WorkflowConfig type — no new types needed.
+ */
+const DEFAULT_WORKFLOW_CONFIG = Object.freeze({
+    name: '6-phase-standard',
+    version: '1.0.0',
+    statuses: [
+        { name: 'roadmap', emoji: '\u{1F4CB}' },
+        { name: 'active', emoji: '\u{1F6A7}' },
+        { name: 'completed', emoji: '\u2705' },
+        { name: 'deferred', emoji: '\u23F8\uFE0F' },
+    ],
+    phases: [
+        { name: 'Inception', order: 1 },
+        { name: 'Elaboration', order: 2 },
+        { name: 'Session', order: 3 },
+        { name: 'Construction', order: 4 },
+        { name: 'Validation', order: 5 },
+        { name: 'Retrospective', order: 6 },
+    ],
+    defaultStatus: 'roadmap',
+});
+/** Pre-computed LoadedWorkflow singleton — avoids rebuilding Maps on every call */
+const DEFAULT_LOADED_WORKFLOW = createLoadedWorkflow(DEFAULT_WORKFLOW_CONFIG);
+/**
+ * Load workflow configuration from a specific file path
+ *
+ * @param configPath - Absolute or relative path to workflow JSON file
+ * @param source - Source identifier for error messages (defaults to path)
+ * @returns Result with LoadedWorkflow or error details
+ *
+ * @example
+ * ```typescript
+ * const result = await loadWorkflowFromPath("/path/to/custom-workflow.json");
+ * if (result.ok) {
+ *   const workflow = result.value;
+ * }
+ * ```
+ */
+export async function loadWorkflowFromPath(configPath, source) {
+    const errorSource = source ?? configPath;
+    // Read file
+    let content;
+    try {
+        content = await fs.readFile(configPath, 'utf-8');
+    }
+    catch (error) {
+        // Handle file read errors
+        if (error instanceof Error && 'code' in error) {
+            const nodeError = error;
+            if (nodeError.code === 'ENOENT') {
+                return Result.err({
+                    type: 'workflow-load-error',
+                    source: errorSource,
+                    message: `Workflow file not found: ${configPath}`,
+                });
+            }
+            if (nodeError.code === 'EACCES') {
+                return Result.err({
+                    type: 'workflow-load-error',
+                    source: errorSource,
+                    message: `Permission denied reading workflow: ${configPath}`,
+                });
+            }
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return Result.err({
+            type: 'workflow-load-error',
+            source: errorSource,
+            message: `Failed to load workflow: ${message}`,
+        });
+    }
+    // Parse and validate using codec (handles $schema stripping automatically)
+    const parseResult = WorkflowConfigCodec.parse(content, errorSource);
+    if (!parseResult.ok) {
+        const error = {
+            type: 'workflow-load-error',
+            source: errorSource,
+            message: parseResult.error.message,
+        };
+        if (parseResult.error.validationErrors) {
+            error.validationErrors = parseResult.error.validationErrors;
+        }
+        return Result.err(error);
+    }
+    // Create LoadedWorkflow with lookup maps
+    const workflow = createLoadedWorkflow(parseResult.value);
+    return Result.ok(workflow);
+}
+/**
+ * Load the default workflow (6-phase-standard)
+ *
+ * Returns the standard USDP 6-phase workflow from an inline constant.
+ * Synchronous and infallible — no file I/O, no error handling needed.
+ *
+ * DD-4: Returns LoadedWorkflow synchronously (not Promise).
+ *
+ * @returns LoadedWorkflow for 6-phase-standard
+ *
+ * @example
+ * ```typescript
+ * const workflow = loadDefaultWorkflow();
+ * const emoji = workflow.statusMap.get("completed")?.emoji; // "\u2705"
+ * ```
+ */
+export function loadDefaultWorkflow() {
+    return DEFAULT_LOADED_WORKFLOW;
+}
+/**
+ * Format workflow load error for console display
+ *
+ * @param error - Workflow load error
+ * @returns Formatted error message for console output
+ *
+ * @example
+ * ```typescript
+ * const result = await loadWorkflowFromPath("/path/to/custom.json");
+ * if (!result.ok) {
+ *   console.error(formatWorkflowLoadError(result.error));
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export function formatWorkflowLoadError(error) {
+    const lines = [`Workflow error: ${error.message}`, `  Source: ${error.source}`];
+    if (error.validationErrors && error.validationErrors.length > 0) {
+        lines.push('  Validation errors:');
+        lines.push(...error.validationErrors);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=workflow-loader.js.map

package/dist/config/workflow-loader.js.map

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