@libar-dev/architect 1.0.0-pre.3 → 1.0.0-pre.5

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

@@ -1,65 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,150 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,81 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,22 +0,0 @@
-/**
- * @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

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

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

@@ -1,90 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,167 +0,0 @@
-/**
- * @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

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