@lumenflow/packs-software-delivery 4.24.0 → 5.0.0

package/dist/src/policy/resolve-policy.js.map

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

package/dist/src/ports/config.ports.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Configuration Ports (WU-2020)
+ *
+ * Focused interfaces for injecting configuration sections into command
+ * handlers and service functions. These replace module-level getConfig()
+ * calls with explicit parameter injection (DIP compliance).
+ *
+ * Each interface extracts the minimum config surface needed by its
+ * consumers, following the Interface Segregation Principle (ISP).
+ *
+ * @module ports/config
+ */
+/**
+ * Git-related configuration for branch checks and worktree operations.
+ *
+ * Consumers: branch-check.ts, micro-worktree-shared.ts, micro-worktree.ts
+ */
+export interface IGitConfig {
+    readonly mainBranch: string;
+    readonly defaultRemote: string;
+    readonly requireRemote: boolean;
+    readonly laneBranchPrefix?: string;
+    readonly agentBranchPatterns?: string[];
+    readonly agentBranchPatternsOverride?: string[];
+    readonly disableAgentPatternRegistry?: boolean;
+    readonly pushRetry?: {
+        readonly enabled: boolean;
+        readonly retries: number;
+        readonly min_delay_ms: number;
+        readonly max_delay_ms: number;
+        readonly jitter: boolean;
+    };
+}
+/**
+ * Directory paths configuration for WU file resolution.
+ *
+ * Consumers: wu-paths.ts, wu-list.ts, spawn-task-builder.ts
+ */
+export interface IDirectoriesConfig {
+    readonly wuDir: string;
+    readonly initiativesDir: string;
+    readonly backlogPath: string;
+    readonly statusPath: string;
+    readonly worktrees: string;
+    readonly stampsDir?: string;
+    readonly plansDir: string;
+    readonly templatesDir: string;
+    readonly onboardingDir: string;
+    readonly skillsDir: string;
+    readonly agentsDir: string;
+    readonly memoryBank: string;
+    readonly safeGitPath: string;
+}
+/**
+ * State paths configuration for store directory resolution.
+ *
+ * Consumers: wu-paths.ts, wu-backlog-updater.ts
+ */
+export interface IStateConfig {
+    readonly base: string;
+    readonly stampsDir: string;
+    readonly stateDir: string;
+}
+/**
+ * Minimal config interface for path-resolution consumers.
+ *
+ * Consumers that only need directory and state paths should depend
+ * on this interface rather than the full LumenFlowConfig.
+ */
+export interface IPathsConfig {
+    readonly directories: IDirectoriesConfig;
+    readonly state: IStateConfig;
+}
+/**
+ * Minimal config interface for git-operation consumers.
+ *
+ * Consumers that only need git configuration should depend on this
+ * interface rather than the full LumenFlowConfig.
+ */
+export interface IGitOperationConfig {
+    readonly git: IGitConfig;
+}
+//# sourceMappingURL=config.ports.d.ts.map

package/dist/src/ports/config.ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.ports.d.ts","sourceRoot":"","sources":["../../../src/ports/config.ports.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;CAC1B"}

package/dist/src/ports/config.ports.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export {};
+//# sourceMappingURL=config.ports.js.map

package/dist/src/ports/config.ports.js.map

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

package/dist/src/ports/dashboard-renderer.port.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Dashboard Renderer Port
+ *
+ * Hexagonal Architecture - Output Port
+ * Defines the contract for rendering orchestration dashboard data to UnsafeAny UI.
+ * This abstraction allows the application layer to remain independent of
+ * specific rendering implementations.
+ *
+ * Current Implementations:
+ * - TerminalDashboardRenderer (WU-1322) - ASCII/ANSI terminal output
+ *
+ * Future Implementations:
+ * - WebDashboardRenderer - Browser-based UI
+ * - VSCodeWebviewRenderer - VS Code extension panel
+ *
+ * SOLID Principles:
+ * - Dependency Inversion: Use cases depend on this abstraction, not concrete renderers
+ * - Interface Segregation: Focused on rendering, no data fetching concerns
+ * - Open/Closed: New renderers can be added without modifying existing code
+ *
+ * @module dashboard-renderer.port
+ * @see {@link ../domain/orchestration.types.ts} - Types used in this interface
+ * @see {@link ../../adapters/terminal-renderer.adapter.ts} - Terminal implementation (WU-1322)
+ */
+import type { DashboardData, Suggestion, ExecutionPlan, UserChoice } from '../domain/orchestration.types.js';
+/**
+ * Dashboard Renderer Port Interface
+ *
+ * Implementers must provide methods to render all dashboard sections
+ * and handle user interactions for execution plan approval.
+ *
+ * @example
+ * // Implementing a custom renderer
+ * class CustomRenderer implements IDashboardRenderer {
+ *   render(data: DashboardData): void {
+ *     // Render global status, agent metrics, WU progress, timeline, alerts
+ *   }
+ *
+ *   renderSuggestions(suggestions: Suggestion[]): void {
+ *     // Display prioritised suggestions
+ *   }
+ *
+ *   renderPlan(plan: ExecutionPlan): Promise<UserChoice> {
+ *     // Show plan and get user approval
+ *   }
+ *
+ *   clear(): void {
+ *     // Clear previous output
+ *   }
+ * }
+ *
+ * @example
+ * // Using in a use case
+ * class GetDashboardDataUseCase {
+ *   constructor(
+ *     private readonly renderer: IDashboardRenderer,
+ *     private readonly collector: IMetricsCollector,
+ *   ) {}
+ *
+ *   async execute(): Promise<void> {
+ *     const data = await this.collectData();
+ *     this.renderer.render(data);
+ *   }
+ * }
+ */
+export interface IDashboardRenderer {
+    /**
+     * Render the complete dashboard with all sections.
+     *
+     * Sections to render:
+     * 1. Global Status - Active WUs, completed, blocked, gates failing
+     * 2. Agent Small Multiples - Per-agent metrics comparison
+     * 3. WU Progress - DoD progress bars with agent status
+     * 4. Timeline - Recent orchestration events
+     * 5. Alerts - Items requiring attention
+     *
+     * @param data - Complete dashboard data from metrics collector
+     */
+    render(data: DashboardData): void;
+    /**
+     * Render a list of prioritised suggestions.
+     *
+     * Suggestions should be displayed with:
+     * - Priority indicator (HIGH/MEDIUM/LOW)
+     * - Action description
+     * - Reason for suggestion
+     * - Command to execute
+     *
+     * @param suggestions - Ordered list of suggestions (highest priority first)
+     */
+    renderSuggestions(suggestions: Suggestion[]): void;
+    /**
+     * Render an execution plan and get user approval.
+     *
+     * Should display:
+     * - WU being executed
+     * - Ordered list of steps
+     * - Estimated token cost
+     * - Approval prompt (approve/reject/edit)
+     *
+     * @param plan - Proposed execution plan
+     * @returns User's choice (approve, reject, or edit with modifications)
+     */
+    renderPlan(plan: ExecutionPlan): Promise<UserChoice>;
+    /**
+     * Clear UnsafeAny previous dashboard output.
+     *
+     * Used before re-rendering to prevent stale data display.
+     * Implementation depends on output medium (e.g., clear terminal, DOM update).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=dashboard-renderer.port.d.ts.map

package/dist/src/ports/dashboard-renderer.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-renderer.port.d.ts","sourceRoot":"","sources":["../../../src/ports/dashboard-renderer.port.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,EACX,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAElC;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEnD;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAErD;;;;;OAKG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/src/ports/dashboard-renderer.port.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export {};
+//# sourceMappingURL=dashboard-renderer.port.js.map

package/dist/src/ports/dashboard-renderer.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-renderer.port.js","sourceRoot":"","sources":["../../../src/ports/dashboard-renderer.port.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC"}

package/dist/src/ports/index.d.ts

@@ -0,0 +1,5 @@
+export * from './wu-state.ports.js';
+export * from './sync-validator.ports.js';
+export * from './wu-helpers.ports.js';
+export * from './config.ports.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ports/index.ts"],"names":[],"mappings":"AAMA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/src/ports/index.js

@@ -0,0 +1,10 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// Barrel for pack-local port contracts. Populated by Layer 4 of INIT-058.
+// WU-2699: moved wu-state.ports, sync-validator.ports from @lumenflow/core.
+// WU-2716: moved wu-helpers.ports, config.ports from @lumenflow/core.
+export * from './wu-state.ports.js';
+export * from './sync-validator.ports.js';
+export * from './wu-helpers.ports.js';
+export * from './config.ports.js';
+//# sourceMappingURL=index.js.map

package/dist/src/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,0EAA0E;AAC1E,4EAA4E;AAC5E,sEAAsE;AACtE,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/src/ports/sync-validator.ports.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Sync Validator Port Interfaces
+ *
+ * Canonical git adapter contract for main-branch sync validation helpers.
+ *
+ * @module ports/sync-validator
+ */
+import type { IGitAdapter } from '@lumenflow/host/git/git-validator.ports';
+/**
+ * Canonical git adapter shape for sync validation operations.
+ */
+export interface ISyncValidatorGitAdapter {
+    fetch: IGitAdapter['fetch'];
+    getCommitHash: IGitAdapter['getCommitHash'];
+    revList: IGitAdapter['revList'];
+}
+/**
+ * WU-2208: Git adapter shape for remote-aware WU ID generation.
+ *
+ * Extends the sync validator contract with tree listing and file content
+ * retrieval at a specific git ref (e.g., origin/main). Designed to
+ * accommodate future cloud `allocateWuId()` by keeping the interface
+ * narrow and async.
+ */
+export interface IWuIdGitAdapter {
+    /** Fetch remote refs (e.g., origin main). */
+    fetch: IGitAdapter['fetch'];
+    /**
+     * List file/directory names at a given ref and tree path.
+     *
+     * Equivalent to: git ls-tree --name-only <ref> <path>/
+     * Returns an array of filenames (not full paths) within the directory.
+     * Returns empty array if the path does not exist at the given ref.
+     *
+     * @param ref - Git ref (e.g., 'origin/main')
+     * @param path - Directory path relative to repo root (e.g., 'docs/operations/tasks/wu')
+     * @returns Array of filenames in the directory at the given ref
+     */
+    listTreeAtRef(ref: string, path: string): Promise<string[]>;
+    /**
+     * Show a file's content at a given ref.
+     *
+     * Equivalent to: git show <ref>:<path>
+     * Returns empty string if the file does not exist at the given ref.
+     *
+     * @param ref - Git ref (e.g., 'origin/main')
+     * @param path - File path relative to repo root
+     * @returns File content as string, or empty string if not found
+     */
+    showFileAtRef(ref: string, path: string): Promise<string>;
+}
+//# sourceMappingURL=sync-validator.ports.d.ts.map

package/dist/src/ports/sync-validator.ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-validator.ports.d.ts","sourceRoot":"","sources":["../../../src/ports/sync-validator.ports.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,aAAa,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAC5C,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAE5B;;;;;;;;;;OAUG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5D;;;;;;;;;OASG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D"}

package/dist/src/ports/sync-validator.ports.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export {};
+//# sourceMappingURL=sync-validator.ports.js.map

package/dist/src/ports/sync-validator.ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-validator.ports.js","sourceRoot":"","sources":["../../../src/ports/sync-validator.ports.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC"}

package/dist/src/ports/wu-helpers.ports.d.ts

@@ -0,0 +1,157 @@
+/**
+ * WU Helpers Port Interfaces
+ *
+ * WU-1102: INIT-003 Phase 2b - Port interfaces for WU helper modules
+ *
+ * Hexagonal Architecture - Input Ports:
+ * These abstractions allow external users to inject custom implementations
+ * for WU lifecycle operations.
+ *
+ * @module ports/wu-helpers
+ */
+import type { ISyncValidatorGitAdapter } from './sync-validator.ports.js';
+/**
+ * Git adapter interface for ensureOnMain and ensureMainUpToDate operations
+ */
+export interface IWuGitAdapter extends Pick<ISyncValidatorGitAdapter, 'fetch' | 'getCommitHash'> {
+    /**
+     * Get the current git branch name
+     * @returns Promise resolving to branch name
+     */
+    getCurrentBranch(): Promise<string>;
+}
+/**
+ * WU status check result
+ */
+export interface IWuStatusCheckResult {
+    /** Whether the operation is allowed */
+    allowed: boolean;
+    /** Current WU status */
+    status: string | null;
+    /** Error message if not allowed */
+    error: string | null;
+}
+/**
+ * Branch validation result
+ */
+export interface IBranchValidationResult {
+    /** Whether the branch name is valid */
+    valid: boolean;
+    /** Lane name (kebab-case) or null */
+    lane: string | null;
+    /** WU ID (uppercase) or null */
+    wuid: string | null;
+    /** Error message if invalid */
+    error: string | null;
+}
+/**
+ * WU YAML reader interface
+ */
+export interface IWuYamlReader {
+    /**
+     * Read and parse WU YAML file
+     * @param wuPath - Path to WU YAML file
+     * @param expectedId - Expected WU ID for validation
+     * @returns Parsed WU document
+     */
+    readWU(wuPath: string, expectedId: string): unknown;
+    /**
+     * Read YAML file without ID validation
+     * @param yamlPath - Path to YAML file
+     * @returns Parsed document
+     */
+    readWURaw(yamlPath: string): unknown;
+}
+/**
+ * WU YAML writer interface
+ */
+export interface IWuYamlWriter {
+    /**
+     * Write WU document to file
+     * @param wuPath - Path to WU YAML file
+     * @param doc - Document to write
+     */
+    writeWU(wuPath: string, doc: unknown): void;
+}
+export type { IWuStateStore } from './wu-state.ports.js';
+/**
+ * WU checkpoint interface
+ */
+export interface IWuCheckpointManager {
+    /**
+     * Create a pre-gates checkpoint
+     */
+    createPreGatesCheckpoint(params: {
+        wuId: string;
+        worktreePath: string;
+        branchName: string;
+        gatesPassed?: boolean;
+    }, options?: {
+        baseDir?: string;
+    }): Promise<{
+        checkpointId: string;
+        gatesPassed: boolean;
+    }>;
+    /**
+     * Mark checkpoint as gates passed
+     * @param wuId - WU identifier
+     * @returns True if updated
+     */
+    markGatesPassed(wuId: string, options?: {
+        baseDir?: string;
+    }): boolean;
+    /**
+     * Get checkpoint for a WU
+     * @param wuId - WU identifier
+     * @returns Checkpoint or null
+     */
+    getCheckpoint(wuId: string, options?: {
+        baseDir?: string;
+    }): {
+        gatesPassed: boolean;
+        worktreeHeadSha: string;
+    } | null;
+    /**
+     * Clear checkpoint
+     * @param wuId - WU identifier
+     */
+    clearCheckpoint(wuId: string, options?: {
+        baseDir?: string;
+    }): void;
+    /**
+     * Check if gates can be skipped
+     */
+    canSkipGates(wuId: string, options?: {
+        baseDir?: string;
+        currentHeadSha?: string;
+    }): {
+        canSkip: boolean;
+        reason?: string;
+    };
+}
+/**
+ * WU paths interface
+ */
+export interface IWuPaths {
+    /** Get path to WU YAML file */
+    WU(id: string): string;
+    /** Get path to WU directory */
+    WU_DIR(): string;
+    /** Get path to status.md */
+    STATUS(): string;
+    /** Get path to backlog.md */
+    BACKLOG(): string;
+    /** Get path to stamps directory */
+    STAMPS_DIR(): string;
+    /** Get path to WU done stamp file */
+    STAMP(id: string): string;
+    /** Get path to state directory */
+    STATE_DIR(): string;
+    /** Get path to initiatives directory */
+    INITIATIVES_DIR(): string;
+    /** Get path to initiative YAML file */
+    INITIATIVE(id: string): string;
+    /** Get path to worktrees directory */
+    WORKTREES_DIR(): string;
+}
+//# sourceMappingURL=wu-helpers.ports.d.ts.map

package/dist/src/ports/wu-helpers.ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-helpers.ports.d.ts","sourceRoot":"","sources":["../../../src/ports/wu-helpers.ports.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,eAAe,CAAC;IAC9F;;;OAGG;IACH,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mCAAmC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gCAAgC;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAEpD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C;AAID,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,wBAAwB,CACtB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,EACzF,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE3D;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAEvE;;;;OAIG;IACH,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE5D;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAEpE;;OAEG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACtD;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvB,+BAA+B;IAC/B,MAAM,IAAI,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,MAAM,IAAI,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,OAAO,IAAI,MAAM,CAAC;IAElB,mCAAmC;IACnC,UAAU,IAAI,MAAM,CAAC;IAErB,qCAAqC;IACrC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B,kCAAkC;IAClC,SAAS,IAAI,MAAM,CAAC;IAEpB,wCAAwC;IACxC,eAAe,IAAI,MAAM,CAAC;IAE1B,uCAAuC;IACvC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/B,sCAAsC;IACtC,aAAa,IAAI,MAAM,CAAC;CACzB"}

package/dist/src/ports/wu-helpers.ports.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export {};
+//# sourceMappingURL=wu-helpers.ports.js.map

package/dist/src/ports/wu-helpers.ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-helpers.ports.js","sourceRoot":"","sources":["../../../src/ports/wu-helpers.ports.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC"}