@lumenflow/core 3.3.0 → 3.5.0

package/dist/delegation-registry-store.js

@@ -17,6 +17,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { validateDelegationEvent, generateDelegationId, DelegationStatus, } from './delegation-registry-schema.js';
+import { createError, ErrorCodes } from './error-handler.js';
 /** Delegation registry file name constant */
 export const DELEGATION_REGISTRY_FILE_NAME = 'delegation-registry.jsonl';
 /**
@@ -97,7 +98,7 @@ export class DelegationRegistryStore {
                 parsed = JSON.parse(line);
             }
             catch (error) {
-                throw new Error(`Malformed JSON on line ${i + 1}: ${error.message}`, { cause: error });
+                throw createError(ErrorCodes.PARSE_ERROR, `Malformed JSON on line ${i + 1}: ${error.message}`);
             }
             // Validate against schema
             const validation = validateDelegationEvent(parsed);
@@ -105,7 +106,7 @@ export class DelegationRegistryStore {
                 const issues = validation.error.issues
                     .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
                     .join(', ');
-                throw new Error(`Validation error on line ${i + 1}: ${issues}`);
+                throw createError(ErrorCodes.VALIDATION_ERROR, `Validation error on line ${i + 1}: ${issues}`);
             }
             const event = validation.data;
             // Apply event to state (latest event for same ID wins)
@@ -153,7 +154,7 @@ export class DelegationRegistryStore {
             const issues = validation.error.issues
                 .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
                 .join(', ');
-            throw new Error(`Validation error: ${issues}`);
+            throw createError(ErrorCodes.VALIDATION_ERROR, `Validation error: ${issues}`);
         }
         const line = JSON.stringify(event) + '\n';
         // Ensure parent directory exists before appending
@@ -204,7 +205,7 @@ export class DelegationRegistryStore {
     async updateStatus(delegationId, status) {
         const existing = this.delegations.get(delegationId);
         if (!existing) {
-            throw new Error(`Delegation ID ${delegationId} not found`);
+            throw createError(ErrorCodes.DELEGATION_NOT_FOUND, `Delegation ID ${delegationId} not found`);
         }
         const event = {
             ...existing,
@@ -229,7 +230,7 @@ export class DelegationRegistryStore {
     async recordPickup(delegationId, pickedUpBy, pickedUpAt) {
         const existing = this.delegations.get(delegationId);
         if (!existing) {
-            throw new Error(`Delegation ID ${delegationId} not found`);
+            throw createError(ErrorCodes.DELEGATION_NOT_FOUND, `Delegation ID ${delegationId} not found`);
         }
         const event = {
             ...existing,

package/dist/delegation-registry-store.js.map

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

package/dist/dependency-guard.d.ts

@@ -22,7 +22,7 @@ export declare const DEPENDENCY_MUTATING_COMMANDS: string[];
  * isDependencyMutatingCommand('pnpm run test'); // false
  * isDependencyMutatingCommand('npm install'); // false (not pnpm)
  */
-export declare function isDependencyMutatingCommand(command: UnsafeAny): boolean;
+export declare function isDependencyMutatingCommand(command: string): boolean;
 /**
  * Build a blocking message for dependency-mutating commands on main.
  *
@@ -33,7 +33,7 @@ export declare function isDependencyMutatingCommand(command: UnsafeAny): boolean
  * const message = buildDependencyBlockMessage('pnpm add react');
  * // Returns multi-line message with guidance
  */
-export declare function buildDependencyBlockMessage(command: UnsafeAny): string;
+export declare function buildDependencyBlockMessage(command: string): string;
 /**
  * Log prefix for dependency guard output
  */

package/dist/dependency-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-guard.d.ts","sourceRoot":"","sources":["../src/dependency-guard.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,UASxC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,SAAS,WA2C7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,SAAS,UA6C7D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"dependency-guard.d.ts","sourceRoot":"","sources":["../src/dependency-guard.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,UASxC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,WA2C1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,UA8C1D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAiB,CAAC"}

package/dist/dependency-guard.js

@@ -66,7 +66,7 @@ export function isDependencyMutatingCommand(command) {
     const parts = trimmed.split(/\s+/);
     // Find the first non-flag argument after 'pnpm'
     for (let i = 1; i < parts.length; i++) {
-        const part = parts[i];
+        const part = parts[i] ?? '';
         // Skip flags (start with -)
         if (part.startsWith('-')) {
             // Handle --filter=value format
@@ -100,8 +100,9 @@ export function buildDependencyBlockMessage(command) {
     const parts = command.trim().split(/\s+/);
     let subcommand = '';
     for (let i = 1; i < parts.length; i++) {
-        if (!parts[i].startsWith('-')) {
-            subcommand = parts[i];
+        const part = parts[i] ?? '';
+        if (!part.startsWith('-')) {
+            subcommand = part;
             break;
         }
     }

package/dist/dependency-guard.js.map

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

package/dist/docs-layout-presets.d.ts

@@ -0,0 +1,29 @@
+export declare const DOCS_LAYOUT_PRESETS: {
+    readonly simple: {
+        readonly operations: string;
+        readonly tasks: string;
+        readonly onboarding: string;
+        readonly quickRefLink: `${string}/quick-ref-commands.md`;
+        readonly completeGuidePath: `${string}/lumenflow-complete.md`;
+        readonly quickRefPath: `${string}/quick-ref-commands.md`;
+        readonly startingPromptPath: `${string}/starting-prompt.md`;
+        readonly sizingGuidePath: `${string}/wu-sizing-guide.md`;
+        readonly governancePath: `${string}/governance/project-governance.md`;
+    };
+    readonly arc42: {
+        readonly operations: string;
+        readonly tasks: string;
+        readonly onboarding: string;
+        readonly quickRefLink: `${string}/quick-ref-commands.md`;
+        readonly completeGuidePath: `${string}/lumenflow-complete.md`;
+        readonly quickRefPath: `${string}/quick-ref-commands.md`;
+        readonly startingPromptPath: `${string}/starting-prompt.md`;
+        readonly sizingGuidePath: `${string}/wu-sizing-guide.md`;
+        readonly governancePath: `${string}/governance/project-governance.md`;
+    };
+};
+export type DocsLayoutType = keyof typeof DOCS_LAYOUT_PRESETS;
+export type DocsLayoutPreset = (typeof DOCS_LAYOUT_PRESETS)[DocsLayoutType];
+export declare const DEFAULT_DOCS_LAYOUT: DocsLayoutType;
+export declare function getDocsLayoutPreset(layout: DocsLayoutType): DocsLayoutPreset;
+//# sourceMappingURL=docs-layout-presets.d.ts.map

package/dist/docs-layout-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-layout-presets.d.ts","sourceRoot":"","sources":["../src/docs-layout-presets.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;CAGtB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,cAAc,CAAC,CAAC;AAE5E,eAAO,MAAM,mBAAmB,EAAE,cAAyB,CAAC;AAE5D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAE5E"}

package/dist/docs-layout-presets.js

@@ -0,0 +1,38 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Canonical docs layout presets used across scaffolding and defaults.
+ *
+ * Keeping presets in one place avoids path-literal drift between:
+ * - schema defaults
+ * - init docs-structure mapping
+ * - runtime prompt/path helpers
+ */
+function buildDocsLayout(operations, tasks) {
+    const frameworkRoot = `${operations}/_frameworks/lumenflow`;
+    const onboarding = `${frameworkRoot}/agent/onboarding`;
+    return {
+        operations,
+        tasks,
+        onboarding,
+        quickRefLink: `${onboarding}/quick-ref-commands.md`,
+        completeGuidePath: `${frameworkRoot}/lumenflow-complete.md`,
+        quickRefPath: `${onboarding}/quick-ref-commands.md`,
+        startingPromptPath: `${onboarding}/starting-prompt.md`,
+        sizingGuidePath: `${frameworkRoot}/wu-sizing-guide.md`,
+        governancePath: `${operations}/governance/project-governance.md`,
+    };
+}
+const DOCS_ROOT = 'docs';
+const SIMPLE_TASKS_PATH = `${DOCS_ROOT}/tasks`;
+const ARC42_OPERATIONS_PATH = [DOCS_ROOT, '04-operations'].join('/');
+const ARC42_TASKS_PATH = [ARC42_OPERATIONS_PATH, 'tasks'].join('/');
+export const DOCS_LAYOUT_PRESETS = {
+    simple: buildDocsLayout(DOCS_ROOT, SIMPLE_TASKS_PATH),
+    arc42: buildDocsLayout(ARC42_OPERATIONS_PATH, ARC42_TASKS_PATH),
+};
+export const DEFAULT_DOCS_LAYOUT = 'simple';
+export function getDocsLayoutPreset(layout) {
+    return DOCS_LAYOUT_PRESETS[layout];
+}
+//# sourceMappingURL=docs-layout-presets.js.map

package/dist/docs-layout-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-layout-presets.js","sourceRoot":"","sources":["../src/docs-layout-presets.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;GAOG;AAEH,SAAS,eAAe,CAAC,UAAkB,EAAE,KAAa;IACxD,MAAM,aAAa,GAAG,GAAG,UAAU,wBAAwB,CAAC;IAC5D,MAAM,UAAU,GAAG,GAAG,aAAa,mBAAmB,CAAC;IAEvD,OAAO;QACL,UAAU;QACV,KAAK;QACL,UAAU;QACV,YAAY,EAAE,GAAG,UAAU,wBAAwB;QACnD,iBAAiB,EAAE,GAAG,aAAa,wBAAwB;QAC3D,YAAY,EAAE,GAAG,UAAU,wBAAwB;QACnD,kBAAkB,EAAE,GAAG,UAAU,qBAAqB;QACtD,eAAe,EAAE,GAAG,aAAa,qBAAqB;QACtD,cAAc,EAAE,GAAG,UAAU,mCAAmC;KACxD,CAAC;AACb,CAAC;AAED,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,iBAAiB,GAAG,GAAG,SAAS,QAAQ,CAAC;AAC/C,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrE,MAAM,gBAAgB,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACrD,KAAK,EAAE,eAAe,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;CACvD,CAAC;AAKX,MAAM,CAAC,MAAM,mBAAmB,GAAmB,QAAQ,CAAC;AAE5D,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/docs-path-validator.d.ts

@@ -4,9 +4,9 @@
  * @param {string[]} stagedFiles - Array of file paths
  * @returns {{valid: boolean, violations: string[]}} - Validation result
  */
-export declare function validateDocsOnly(stagedFiles: UnsafeAny): {
+export declare function validateDocsOnly(stagedFiles: string[]): {
     valid: boolean;
-    violations: any[];
+    violations: string[];
 };
 /**
  * Get a human-readable description of allowed paths

package/dist/docs-path-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-path-validator.d.ts","sourceRoot":"","sources":["../src/docs-path-validator.ts"],"names":[],"mappings":";AAwEA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,SAAS;;;EAWtD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,WAWzC"}
+{"version":3,"file":"docs-path-validator.d.ts","sourceRoot":"","sources":["../src/docs-path-validator.ts"],"names":[],"mappings":";AAmEA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE;;;EAYrD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,WAWzC"}

package/dist/docs-path-validator.js

@@ -25,22 +25,18 @@
 import path from 'node:path';
 import { WU_EVENTS_FILE_NAME } from './wu-state-store.js';
 import { LUMENFLOW_PATHS, DIRECTORIES, FILE_EXTENSIONS, STRING_LITERALS } from './wu-constants.js';
+import { getDocsOnlyPrefixes } from './file-classifiers.js';
 const POSIX = path.posix;
-const DOCS_ONLY_PREFIXES = Object.freeze([
-    DIRECTORIES.DOCS,
-    DIRECTORIES.AI,
-    DIRECTORIES.CLAUDE,
-    DIRECTORIES.MEMORY_BANK,
-]);
 const TOOLS_TESTS_PREFIX = `${POSIX.join(DIRECTORIES.TOOLS, '__tests__')}${STRING_LITERALS.SLASH}`;
 const STAMPS_PREFIX = `${LUMENFLOW_PATHS.STAMPS_DIR}${STRING_LITERALS.SLASH}`;
 const WU_EVENTS_PATH = POSIX.join(LUMENFLOW_PATHS.STATE_DIR, WU_EVENTS_FILE_NAME);
 /**
  * Check if a file path is allowed for docs-only WUs
  * @param {string} filePath - The file path to validate
+ * @param {readonly string[]} docsOnlyPrefixes - Config-driven docs path prefixes
  * @returns {boolean} - True if the path is allowed
  */
-function isAllowedPath(filePath) {
+function isAllowedPath(filePath, docsOnlyPrefixes) {
     if (!filePath)
         return false;
     if (filePath === WU_EVENTS_PATH)
@@ -55,7 +51,7 @@ function isAllowedPath(filePath) {
     }
     if (filePath.endsWith(FILE_EXTENSIONS.MARKDOWN))
         return true;
-    for (const prefix of DOCS_ONLY_PREFIXES) {
+    for (const prefix of docsOnlyPrefixes) {
         if (filePath.startsWith(prefix)) {
             return true;
         }
@@ -68,9 +64,10 @@ function isAllowedPath(filePath) {
  * @returns {{valid: boolean, violations: string[]}} - Validation result
  */
 export function validateDocsOnly(stagedFiles) {
+    const docsOnlyPrefixes = getDocsOnlyPrefixes();
     const violations = [];
     for (const file of stagedFiles) {
-        if (!isAllowedPath(file)) {
+        if (!isAllowedPath(file, docsOnlyPrefixes)) {
             violations.push(file);
         }
     }

package/dist/docs-path-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs-path-validator.js","sourceRoot":"","sources":["../src/docs-path-validator.ts"],"names":[],"mappings":";AACA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEnG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;AAEzB,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,WAAW,CAAC,IAAI;IAChB,WAAW,CAAC,EAAE;IACd,WAAW,CAAC,MAAM;IAClB,WAAW,CAAC,WAAW;CACxB,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC;AACnG,MAAM,aAAa,GAAG,GAAG,eAAe,CAAC,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC;AAC9E,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AAElF;;;;GAIG;AACH,SAAS,aAAa,CAAC,QAAmB;IACxC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,IAAI,QAAQ,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAE7C,IAAI,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,GAAG,eAAe,CAAC,KAAK,YAAY,eAAe,CAAC,KAAK,EAAE,CAAC;QACjF,OAAO,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7D,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACxC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAsB;IACrD,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QAC9B,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;;;;;;;uBAOc,mBAAmB;;+CAEK,CAAC;AAChD,CAAC"}
+{"version":3,"file":"docs-path-validator.js","sourceRoot":"","sources":["../src/docs-path-validator.ts"],"names":[],"mappings":";AACA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;AAEzB,MAAM,kBAAkB,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC;AACnG,MAAM,aAAa,GAAG,GAAG,eAAe,CAAC,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC;AAC9E,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AAElF;;;;;GAKG;AACH,SAAS,aAAa,CAAC,QAAgB,EAAE,gBAAmC;IAC1E,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,IAAI,QAAQ,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAE7C,IAAI,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,GAAG,eAAe,CAAC,KAAK,YAAY,eAAe,CAAC,KAAK,EAAE,CAAC;QACjF,OAAO,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7D,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAqB;IACpD,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC;YAC3C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QAC9B,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;;;;;;;uBAOc,mBAAmB;;+CAEK,CAAC;AAChD,CAAC"}

package/dist/domain/index.d.ts

@@ -10,6 +10,7 @@
 export * from './context.schemas.js';
 export { VALIDATION_ERROR_CODE_VALUES, ValidationErrorCodeSchema, PREDICATE_SEVERITY_VALUES, PredicateSeveritySchema, ValidationErrorSchema, ValidationWarningSchema, ValidationResultSchema, CommandPredicateConfigSchema, CommandDefinitionConfigSchema, type ValidationErrorCode, type PredicateSeverity, type ValidationError, type ValidationWarning, type ValidationResult, type CommandPredicateConfig, type CommandDefinitionConfig, } from './validation.schemas.js';
 export * from './recovery.schemas.js';
+export { ok, fail, unwrap, unwrapOr, mapResult, tryCatch, tryCatchAsync, type Result, type Success, type Failure, } from './result.js';
 export * from './orchestration.schemas.js';
 export * from './orchestration.constants.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAIH,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAIjC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAIH,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAIjC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACL,EAAE,EACF,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,aAAa,EACb,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,KAAK,OAAO,GACb,MAAM,aAAa,CAAC;AAGrB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC"}

package/dist/domain/index.js

@@ -17,6 +17,8 @@ export { VALIDATION_ERROR_CODE_VALUES, ValidationErrorCodeSchema, PREDICATE_SEVE
 // Recovery schemas
 // Includes RecoveryIssueCode and RecoveryActionType enum constants
 export * from './recovery.schemas.js';
+// Result type (WU-2128: Standardize error return contracts)
+export { ok, fail, unwrap, unwrapOr, mapResult, tryCatch, tryCatchAsync, } from './result.js';
 // Orchestration schemas (existing)
 export * from './orchestration.schemas.js';
 export * from './orchestration.constants.js';

package/dist/domain/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;GAQG;AAEH,oEAAoE;AACpE,sCAAsC;AACtC,cAAc,sBAAsB,CAAC;AAErC,gEAAgE;AAChE,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,GAQ9B,MAAM,yBAAyB,CAAC;AAEjC,mBAAmB;AACnB,mEAAmE;AACnE,cAAc,uBAAuB,CAAC;AAEtC,mCAAmC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;GAQG;AAEH,oEAAoE;AACpE,sCAAsC;AACtC,cAAc,sBAAsB,CAAC;AAErC,gEAAgE;AAChE,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,GAQ9B,MAAM,yBAAyB,CAAC;AAEjC,mBAAmB;AACnB,mEAAmE;AACnE,cAAc,uBAAuB,CAAC;AAEtC,4DAA4D;AAC5D,OAAO,EACL,EAAE,EACF,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,aAAa,GAId,MAAM,aAAa,CAAC;AAErB,mCAAmC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC"}

package/dist/domain/result.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Result Type - Discriminated Union for Error Contracts
+ *
+ * WU-2128: Standardize error return contracts
+ *
+ * Contract:
+ * - Ports THROW on failure (boundary contracts at the hexagonal architecture edge)
+ * - Adapters RETURN Result<T, E> (no exceptions in adapter layer)
+ * - CLI command handlers CATCH and format errors for user output
+ *
+ * This module defines the canonical Result<T, E> discriminated union type
+ * used by adapter implementations. It follows the same pattern as the
+ * existing ParseResult<T> in test-baseline.ts but with a generic error type.
+ *
+ * @module domain/result
+ */
+/**
+ * Success variant of the Result type.
+ */
+export interface Success<T> {
+    readonly ok: true;
+    readonly value: T;
+}
+/**
+ * Failure variant of the Result type.
+ */
+export interface Failure<E> {
+    readonly ok: false;
+    readonly error: E;
+}
+/**
+ * Discriminated union representing either a successful value or an error.
+ *
+ * Adapters return Result<T, E> instead of throwing exceptions.
+ * This enables predictable error handling without try-catch in calling code.
+ *
+ * @typeParam T - The success value type
+ * @typeParam E - The error type (defaults to Error)
+ *
+ * @example
+ * ```typescript
+ * // Adapter returning Result
+ * async resolveLocation(cwd?: string): Promise<Result<LocationContext>> {
+ *   try {
+ *     const location = await this.resolveLocationFn(cwd);
+ *     return ok(location);
+ *   } catch (error) {
+ *     return fail(error instanceof Error ? error : new Error(String(error)));
+ *   }
+ * }
+ *
+ * // Consumer using Result
+ * const result = await adapter.resolveLocation();
+ * if (result.ok) {
+ *   console.log(result.value.type); // 'main' | 'worktree'
+ * } else {
+ *   console.error(result.error.message);
+ * }
+ * ```
+ */
+export type Result<T, E = Error> = Success<T> | Failure<E>;
+/**
+ * Create a Success result.
+ *
+ * @param value - The success value
+ * @returns A Success<T> instance
+ */
+export declare function ok<T>(value: T): Success<T>;
+/**
+ * Create a Failure result.
+ *
+ * @param error - The error value
+ * @returns A Failure<E> instance
+ */
+export declare function fail<E = Error>(error: E): Failure<E>;
+/**
+ * Unwrap a Result, throwing the error if it is a Failure.
+ *
+ * Useful at port boundaries where the contract is to throw.
+ *
+ * @param result - The Result to unwrap
+ * @returns The success value
+ * @throws The error value if Result is a Failure
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * Unwrap a Result with a default value for the Failure case.
+ *
+ * @param result - The Result to unwrap
+ * @param defaultValue - The value to return if Result is a Failure
+ * @returns The success value or the default value
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/**
+ * Map the success value of a Result.
+ *
+ * @param result - The Result to map
+ * @param fn - The mapping function
+ * @returns A new Result with the mapped value, or the original Failure
+ */
+export declare function mapResult<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+/**
+ * Wrap a throwing function into a Result-returning function.
+ *
+ * @param fn - A function that may throw
+ * @returns A Result containing the return value or the caught error
+ */
+export declare function tryCatch<T>(fn: () => T): Result<T, Error>;
+/**
+ * Wrap an async throwing function into a Result-returning function.
+ *
+ * @param fn - An async function that may throw
+ * @returns A Promise<Result> containing the return value or the caught error
+ */
+export declare function tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>>;
+//# sourceMappingURL=result.d.ts.map

package/dist/domain/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/domain/result.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AAMH;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAM3D;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEpD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAKpD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAKvE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAK1F;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAMzD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAMtF"}

package/dist/domain/result.js

@@ -0,0 +1,96 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// =============================================================================
+// Constructor Functions
+// =============================================================================
+/**
+ * Create a Success result.
+ *
+ * @param value - The success value
+ * @returns A Success<T> instance
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Create a Failure result.
+ *
+ * @param error - The error value
+ * @returns A Failure<E> instance
+ */
+export function fail(error) {
+    return { ok: false, error };
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Unwrap a Result, throwing the error if it is a Failure.
+ *
+ * Useful at port boundaries where the contract is to throw.
+ *
+ * @param result - The Result to unwrap
+ * @returns The success value
+ * @throws The error value if Result is a Failure
+ */
+export function unwrap(result) {
+    if (result.ok) {
+        return result.value;
+    }
+    throw result.error;
+}
+/**
+ * Unwrap a Result with a default value for the Failure case.
+ *
+ * @param result - The Result to unwrap
+ * @param defaultValue - The value to return if Result is a Failure
+ * @returns The success value or the default value
+ */
+export function unwrapOr(result, defaultValue) {
+    if (result.ok) {
+        return result.value;
+    }
+    return defaultValue;
+}
+/**
+ * Map the success value of a Result.
+ *
+ * @param result - The Result to map
+ * @param fn - The mapping function
+ * @returns A new Result with the mapped value, or the original Failure
+ */
+export function mapResult(result, fn) {
+    if (result.ok) {
+        return ok(fn(result.value));
+    }
+    return result;
+}
+/**
+ * Wrap a throwing function into a Result-returning function.
+ *
+ * @param fn - A function that may throw
+ * @returns A Result containing the return value or the caught error
+ */
+export function tryCatch(fn) {
+    try {
+        return ok(fn());
+    }
+    catch (error) {
+        return fail(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+/**
+ * Wrap an async throwing function into a Result-returning function.
+ *
+ * @param fn - An async function that may throw
+ * @returns A Promise<Result> containing the return value or the caught error
+ */
+export async function tryCatchAsync(fn) {
+    try {
+        return ok(await fn());
+    }
+    catch (error) {
+        return fail(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/domain/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/domain/result.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAuEzC,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAY,KAAQ;IACtC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAO,MAAoB;IAC/C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAU,MAAoB,EAAE,EAAmB;IAC1E,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAI,EAAW;IACrC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,EAAoB;IACzD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/domain/validation.schemas.d.ts

@@ -21,8 +21,8 @@ export declare const VALIDATION_ERROR_CODE_VALUES: readonly ["WRONG_LOCATION", "
  * Schema for validation error codes
  */
 export declare const ValidationErrorCodeSchema: z.ZodEnum<{
-    WRONG_LOCATION: "WRONG_LOCATION";
     WU_NOT_FOUND: "WU_NOT_FOUND";
+    WRONG_LOCATION: "WRONG_LOCATION";
     WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
     WRONG_WU_STATUS: "WRONG_WU_STATUS";
     LANE_OCCUPIED: "LANE_OCCUPIED";
@@ -51,8 +51,8 @@ export declare const PredicateSeveritySchema: z.ZodEnum<{
  */
 export declare const ValidationErrorSchema: z.ZodObject<{
     code: z.ZodEnum<{
-        WRONG_LOCATION: "WRONG_LOCATION";
         WU_NOT_FOUND: "WU_NOT_FOUND";
+        WRONG_LOCATION: "WRONG_LOCATION";
         WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
         WRONG_WU_STATUS: "WRONG_WU_STATUS";
         LANE_OCCUPIED: "LANE_OCCUPIED";
@@ -84,8 +84,8 @@ export declare const ValidationResultSchema: z.ZodObject<{
     valid: z.ZodBoolean;
     errors: z.ZodArray<z.ZodObject<{
         code: z.ZodEnum<{
-            WRONG_LOCATION: "WRONG_LOCATION";
             WU_NOT_FOUND: "WU_NOT_FOUND";
+            WRONG_LOCATION: "WRONG_LOCATION";
             WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
             WRONG_WU_STATUS: "WRONG_WU_STATUS";
             LANE_OCCUPIED: "LANE_OCCUPIED";