@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-done-messages.js

@@ -0,0 +1,191 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file wu-done-messages.ts
+ * @description Constants and message templates for wu-done operations
+ * WU-1159: Eliminate string literals (DRY/SOLID compliance)
+ * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.ts
+ *
+ * All log messages, error messages, and text templates extracted to constants.
+ * Prevents duplication and makes text maintainable.
+ */
+import { LOG_PREFIX, EMOJI, REMOTES, BRANCHES } from './wu-constants.js';
+// Re-export LOG_PREFIX for backwards compatibility
+export { LOG_PREFIX };
+function formatUnknownError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Recovery mode messages (WU-1159)
+ */
+export const RECOVERY = {
+    DETECTED: `${LOG_PREFIX.DONE} ${EMOJI.WARNING} RECOVERY MODE: Status is already "done" but worktree exists.`,
+    RESUMING: `${LOG_PREFIX.DONE} ${EMOJI.WARNING} Resuming cleanup to complete the WU...`,
+    EXPLANATION: `${LOG_PREFIX.DONE} This typically happens when a previous wu:done crashed mid-completion.`,
+    CREATING_STAMP: `${LOG_PREFIX.DONE} Creating missing stamp file...`,
+    STAMP_CREATED: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Stamp file created`,
+    UPDATING_YAML: `${LOG_PREFIX.DONE} Updating WU YAML to ensure completion markers...`,
+    YAML_UPDATED: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} WU YAML updated with completion markers`,
+    UPDATING_DOCS: `${LOG_PREFIX.DONE} Ensuring status.md and backlog.md are updated...`,
+    DOCS_UPDATED: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Documentation files verified`,
+    COMMITTING: `${LOG_PREFIX.DONE} Committing recovery changes to prevent data loss...`,
+    COMMIT_SUCCESS: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Recovery changes committed to main`,
+    COMMIT_FAILED: (error) => `${LOG_PREFIX.DONE} ${EMOJI.WARNING} Could not commit recovery changes: ${formatUnknownError(error)} (metadata still on disk)`,
+    MARKERS_VERIFIED: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Recovery mode: All completion markers verified`,
+    PROCEEDING_CLEANUP: `${LOG_PREFIX.DONE} Proceeding to cleanup (worktree removal and branch deletion)...`,
+    SUCCESS: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Recovery mode successful - zombie state cleaned up`,
+};
+/**
+ * Worktree operations
+ */
+export const WORKTREE = {
+    REMOVED: (path) => `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Removed worktree ${path}`,
+    NOT_FOUND: `${LOG_PREFIX.DONE} Worktree not found; skipping removal`,
+    REMOVE_FAILED: (path, error) => `${LOG_PREFIX.DONE} Could not remove worktree ${path}: ${formatUnknownError(error)}`,
+    PRESERVED_PR_MODE: `${LOG_PREFIX.DONE} ${EMOJI.WARNING} Worktree preserved (PR mode - run wu:cleanup after PR merge)`,
+};
+/**
+ * Branch operations
+ */
+export const BRANCH = {
+    DELETED_LOCAL: (branch) => `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Deleted local branch ${branch}`,
+    DELETED_REMOTE: (branch) => `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Deleted remote branch ${branch}`,
+    DELETE_FAILED: (branch, error) => `${LOG_PREFIX.DONE} Could not delete branch ${branch}: ${formatUnknownError(error)}`,
+    DELETE_REMOTE_FAILED: (error) => `${LOG_PREFIX.DONE} Could not delete remote branch: ${formatUnknownError(error)}`,
+    PRESERVED_PR_MODE: `${LOG_PREFIX.DONE} ${EMOJI.WARNING} Branch preserved (PR mode - delete manually after merge)`,
+};
+/**
+ * Completion messages
+ */
+export const COMPLETION = {
+    SUCCESS_HEADER: (id, title) => `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Marked done, pushed, and cleaned up.\n- WU: ${id} — ${title}`,
+    TRANSACTION_COMMIT: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Transaction COMMIT - all steps succeeded (WU-755)`,
+};
+/**
+ * State transition errors
+ */
+export const STATE_TRANSITION = {
+    VALIDATION_FAILED: (error) => `State transition validation failed: ${formatUnknownError(error)}`,
+};
+/**
+ * Auto-rebase messages (WU-1303)
+ */
+export const REBASE = {
+    STARTING: (branch, mainBranch) => `${LOG_PREFIX.DONE} ${EMOJI.WRENCH} Auto-rebasing ${branch} onto ${mainBranch}...`,
+    SUCCESS: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Auto-rebase completed successfully`,
+    FAILED: (error) => `${LOG_PREFIX.DONE} ${EMOJI.FAILURE} Auto-rebase failed: ${formatUnknownError(error)}`,
+    ABORTED: `${LOG_PREFIX.DONE} ${EMOJI.INFO} Rebase aborted - worktree left clean`,
+    MANUAL_FIX: (worktreePath, remote, mainBranch, branch) => `Auto-rebase failed due to conflicts.\n\n` +
+        `Manual resolution required:\n` +
+        `  1. cd ${worktreePath}\n` +
+        `  2. git fetch ${remote} ${mainBranch}\n` +
+        `  3. git rebase ${remote}/${mainBranch}\n` +
+        `  4. Resolve conflicts and run: git rebase --continue\n` +
+        `  5. git push --force-with-lease ${remote} ${branch}\n` +
+        `  6. Return to main checkout and retry: pnpm wu:done --id <WU-ID>`,
+};
+/**
+ * Pre-flight check messages (WU-755, WU-1303, WU-1370)
+ */
+export const PREFLIGHT = {
+    RUNNING: `\n${LOG_PREFIX.DONE} Running pre-flight checks (WU-755)...`,
+    BRANCH_BEHIND: (commitsBehind, threshold) => `${LOG_PREFIX.DONE} ${EMOJI.INFO} Branch is ${commitsBehind} commits behind main (threshold: ${threshold})`,
+    // WU-1370: Graduated drift warning messages
+    BRANCH_DRIFT_INFO: (commitsBehind) => `${LOG_PREFIX.DONE} ${EMOJI.INFO} Branch is ${commitsBehind} commits behind main. Consider rebasing to reduce merge conflicts.`,
+    BRANCH_DRIFT_WARNING: (commitsBehind) => `${LOG_PREFIX.DONE} ${EMOJI.WARNING} Branch is ${commitsBehind} commits behind main. Rebase recommended before completing.`,
+    DIVERGENCE_DETECTED: (commitCount) => `${LOG_PREFIX.DONE} ${EMOJI.WARNING} Branch divergence detected: main is ${commitCount} commit(s) ahead`,
+    NO_DIVERGENCE: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Pre-flight: No branch divergence (main has not advanced)`,
+    NO_CONFLICTS: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Pre-flight: No merge conflicts detected`,
+    ALREADY_MERGED: `\n${LOG_PREFIX.DONE} ${EMOJI.INFO} Branch already merged to main - proceeding with metadata-only completion`,
+    ALREADY_MERGED_EXPLANATION: `         This is normal when code was merged via emergency fix or manual merge.`,
+    BRANCH_INFO: (branch, branchTip, mergeBase, mainHead) => `${LOG_PREFIX.DONE} ${EMOJI.INFO} Branch ${branch} is already merged to main\n` +
+        `         Branch tip: ${branchTip}\n` +
+        `         Merge-base: ${mergeBase}\n` +
+        `         Main HEAD:  ${mainHead}`,
+    BRANCH_DRIFT_ERROR: (mainAhead, threshold, remote, mainBranch) => `⚠️  BRANCH DRIFT DETECTED (WU-755 pre-flight check)\n\n` +
+        `Your branch is ${mainAhead} commits behind main (threshold: ${threshold} commits).\n` +
+        `This increases risk of merge conflicts at completion.\n\n` +
+        `REQUIRED: Rebase your branch before completing:\n` +
+        `  1. cd into your worktree\n` +
+        `  2. Run: git fetch ${remote} ${mainBranch} && git rebase ${remote}/${mainBranch}\n` +
+        `  3. Resolve conflicts that arise\n` +
+        `  4. Return to main checkout and retry: pnpm wu:done --id <WU-ID>`,
+    DIVERGENCE_ERROR: (commitCount, remote, mainBranch, branch) => `⚠️  BRANCH DIVERGENCE DETECTED (emergency fix protection)\n\n` +
+        `Main has advanced ${commitCount} commit(s) since your branch was created.\n` +
+        `Fast-forward merge is impossible.\n\n` +
+        `REQUIRED: Rebase your branch onto current main:\n` +
+        `  1. cd into your worktree\n` +
+        `  2. Fetch latest main: git fetch ${remote} ${mainBranch}\n` +
+        `  3. Rebase onto main: git rebase ${remote}/${mainBranch}\n` +
+        `  4. Force-push lane branch: git push --force-with-lease ${remote} ${branch}\n` +
+        `  5. Return to main checkout and retry`,
+    CONFLICT_ERROR: (remote = REMOTES.ORIGIN, mainBranch = BRANCHES.MAIN) => `⚠️  MERGE CONFLICTS DETECTED (WU-755 pre-flight check)\n\n` +
+        `Cannot complete WU - merge conflicts found between main and your branch.\n\n` +
+        `REQUIRED: Resolve conflicts before completing:\n` +
+        `  1. cd into your worktree\n` +
+        `  2. Run: git fetch ${remote} ${mainBranch} && git rebase ${remote}/${mainBranch}\n` +
+        `  3. Resolve conflicts that arise during rebase\n` +
+        `  4. Run: git rebase --continue after resolving each conflict\n` +
+        `  5. Return to main checkout and retry`,
+    // WU-1384: Merge commit detection for linear history enforcement
+    MERGE_COMMITS_DETECTED: (count) => `${LOG_PREFIX.DONE} ${EMOJI.WARNING} Detected ${count} merge commit(s) in lane branch (GitHub requires linear history)`,
+    MERGE_COMMITS_REBASING: `${LOG_PREFIX.DONE} ${EMOJI.WRENCH} Rebasing to eliminate merge commits and maintain linear history...`,
+    NO_MERGE_COMMITS: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Pre-flight: No merge commits in branch (linear history)`,
+    // WU-1456: Empty merge detection - prevents completing WUs with no actual work
+    EMPTY_MERGE_WARNING: (commitCount) => `\n${LOG_PREFIX.DONE} ⚠️  WARNING: Only ${commitCount} commit(s) on lane branch beyond claim.\n` +
+        `         This may indicate no code changes were committed before running wu:done.\n` +
+        `         If this is intentional (docs-only or metadata update), you may proceed.\n` +
+        `         Otherwise, check that your changes were committed in the worktree.\n`,
+    EMPTY_MERGE_CHECK: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Pre-flight: Branch has work commits beyond claim`,
+    // WU-1460: code_paths blocker - prevents completing WUs with code_paths defined but files not modified
+    CODE_PATHS_NOT_MODIFIED: (missingFiles) => `Cannot complete WU - code_paths files were NOT modified in committed changes.\n\n` +
+        `This WU defines code_paths that should have been implemented:\n` +
+        missingFiles.map((filePath) => `  - ${filePath}`).join('\n') +
+        `\n\nThis error prevents completing a WU without actually committing the code.\n` +
+        `The worktree would be deleted and your work would be lost.\n\n` +
+        `REQUIRED: Commit your code changes before running wu:done:\n` +
+        `  1. cd into your worktree\n` +
+        `  2. git add <your files>\n` +
+        `  3. git commit -m "feat: <description>"\n` +
+        `  4. Return to main and retry: pnpm wu:done --id <WU-ID>`,
+    CODE_PATHS_VERIFIED: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Pre-flight: code_paths files modified in commits`,
+};
+/**
+ * Merge operation messages (WU-1303)
+ */
+export const MERGE = {
+    STARTING: (_branch) => `\n${LOG_PREFIX.DONE} Merging lane branch to main (metadata + code)...`,
+    BRANCH_MERGE: (branch) => `\n${LOG_PREFIX.DONE} Merging branch ${branch} to main (fast-forward only)...`,
+    SUCCESS: (branch) => `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Merged ${branch} successfully (fast-forward)`,
+    ATOMIC_SUCCESS: `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Metadata and code merged to main atomically`,
+    FF_FAILED_RETRY: `${LOG_PREFIX.DONE} ${EMOJI.WARNING} Fast-forward failed, updating main and retrying...`,
+    UPDATED_MAIN: (remote) => `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Updated main from ${remote}, retrying merge...`,
+    PUSHED: (remote, mainBranch) => `${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Pushed to ${remote}/${mainBranch}`,
+    FF_MERGE_ERROR: (branch, mergeError, pullError, remote = REMOTES.ORIGIN, mainBranch = BRANCHES.MAIN) => `Fast-forward merge failed and retry with git pull also failed.\n\n` +
+        `Original merge error: ${formatUnknownError(mergeError)}\n` +
+        `Pull error: ${formatUnknownError(pullError)}\n\n` +
+        `Manual fix required:\n` +
+        `  1. git pull ${remote} ${mainBranch}\n` +
+        `  2. Resolve conflicts\n` +
+        `  3. Switch to your worktree and rebase onto ${mainBranch}\n` +
+        `  4. Return to main checkout and retry`,
+    FF_DIVERGED_ERROR: (branch, originalError, mainBranch = BRANCHES.MAIN) => `Fast-forward merge failed for ${branch}.\n\n` +
+        `This means your branch has diverged from ${mainBranch}.\n` +
+        `To fix:\n` +
+        `  1. Switch to your worktree: cd <worktree-path>\n` +
+        `  2. Rebase onto ${mainBranch}: git rebase ${mainBranch}\n` +
+        `  3. Return to main checkout and retry`,
+    FF_FAILED_NON_DIVERGED_ERROR: (branch, originalError, mainBranch = BRANCHES.MAIN) => `Fast-forward merge failed for ${branch}, but ${mainBranch} is an ancestor.\n\n` +
+        `This indicates the merge did not fail due to divergence.\n` +
+        `Underlying git error: ${formatUnknownError(originalError)}\n\n` +
+        `Next steps:\n` +
+        `  1. Re-run: pnpm wu:done --id <WU-ID>\n` +
+        `  2. If it repeats, check for concurrent git activity and retry after a short wait`,
+};
+/**
+ * Pre-push gate messages (WU-1303)
+ */
+export const PREPUSH = {
+    WORKTREE_SKIP: '[pre-push] Worktree detected - skipping gates (validated at merge via wu:done)',
+};
+//# sourceMappingURL=wu-done-messages.js.map

package/dist/wu-done-messages.js.map

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

package/dist/wu-done-metadata.d.ts

@@ -0,0 +1,123 @@
+import type { WUTransaction } from './wu-transaction.js';
+interface CommitProvenance {
+    branch?: string;
+    worktreePath?: string;
+}
+interface DoneMetadataDoc extends Record<string, unknown> {
+    status?: string;
+    locked?: boolean;
+    completed_at?: string;
+    completed?: string;
+}
+interface ValidateMetadataFilesParams {
+    statusPath: string;
+    backlogPath: string;
+}
+interface UpdateMetadataFilesParams extends ValidateMetadataFilesParams {
+    id: string;
+    title: string;
+    doc: DoneMetadataDoc;
+    wuPath: string;
+}
+interface CollectMetadataToTransactionParams extends ValidateMetadataFilesParams {
+    id: string;
+    title: string;
+    doc: DoneMetadataDoc;
+    wuPath: string;
+    stampPath: string;
+    transaction: WUTransaction;
+    projectRoot?: string | null;
+}
+interface GitAddAdapter {
+    add: (filePaths: string[]) => Promise<unknown>;
+    raw: (args: string[]) => Promise<unknown>;
+}
+interface StageAndFormatMetadataParams {
+    id: string;
+    wuPath: string;
+    statusPath: string;
+    backlogPath: string;
+    stampsDir: string;
+    initiativePath?: string | null;
+    gitAdapter?: GitAddAdapter | null;
+    repoRoot?: string | null;
+}
+/**
+ * Generate commit message for WU completion
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
+ * @param {string} id - WU ID (e.g., "WU-1215")
+ * @param {string} title - WU title
+ * @param {number} maxLength - Maximum commit header length from commitlint config
+ * @returns {string} Formatted commit message
+ * @throws {Error} If generated message exceeds maxLength
+ */
+export declare function generateCommitMessage(id: string, title: string, maxLength?: number, provenance?: CommitProvenance): string;
+/**
+ * Validate that required metadata files exist before updating
+ * WU-1275: Fail fast before mutations to prevent partial state
+ *
+ * @param {object} params - Parameters object
+ * @param {string} params.statusPath - Path to status.md file
+ * @param {string} params.backlogPath - Path to backlog.md file
+ * @throws {WUError} If UnsafeAny required file is missing
+ */
+export declare function validateMetadataFilesExist({ statusPath, backlogPath, }: ValidateMetadataFilesParams): void;
+/**
+ * Update all metadata files for WU completion
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
+ * WU-1572: Made async for WUStateStore integration
+ * @param {object} params - Parameters object
+ * @param {string} params.id - WU ID
+ * @param {string} params.title - WU title
+ * @param {object} params.doc - WU YAML document to update
+ * @param {string} params.wuPath - Path to WU YAML file
+ * @param {string} params.statusPath - Path to status.md file
+ * @param {string} params.backlogPath - Path to backlog.md file
+ */
+export declare function updateMetadataFiles({ id, title, doc, wuPath, statusPath, backlogPath, }: UpdateMetadataFilesParams): Promise<void>;
+/**
+ * Collect metadata updates to a transaction (WU-1369: Atomic pattern)
+ *
+ * This is the atomic version of updateMetadataFiles.
+ * Instead of writing files immediately, it collects all changes
+ * into a WUTransaction object for atomic commit.
+ *
+ * Usage:
+ * ```js
+ * const tx = new WUTransaction(id);
+ * collectMetadataToTransaction({ id, title, doc, wuPath, statusPath, backlogPath, stampPath, transaction: tx });
+ * // All changes are now in tx.pendingWrites
+ * // Validate, then commit or abort
+ * tx.commit();
+ * ```
+ *
+ * @param {object} params - Parameters object
+ * @param {string} params.id - WU ID
+ * @param {string} params.title - WU title
+ * @param {object} params.doc - WU YAML document to update (will be mutated)
+ * @param {string} params.wuPath - Path to WU YAML file
+ * @param {string} params.statusPath - Path to status.md file
+ * @param {string} params.backlogPath - Path to backlog.md file
+ * @param {string} params.stampPath - Path to stamp file
+ * @param {WUTransaction} params.transaction - Transaction to add writes to
+ * @param {string} [params.projectRoot] - Repository root for config/path resolution
+ */
+export declare function collectMetadataToTransaction({ id, title, doc, wuPath, statusPath, backlogPath, stampPath, transaction, projectRoot, }: CollectMetadataToTransactionParams): Promise<void>;
+/**
+ * Stage and format metadata files
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
+ * WU-1541: Added optional gitAdapter and repoRoot params to avoid process.chdir dependency
+ * @param {object} params - Parameters object
+ * @param {string} params.id - WU ID (for error reporting)
+ * @param {string} params.wuPath - Path to WU YAML file
+ * @param {string} params.statusPath - Path to status.md file
+ * @param {string} params.backlogPath - Path to backlog.md file
+ * @param {string} params.stampsDir - Path to stamps directory
+ * @param {string} [params.initiativePath] - Optional parent initiative YAML path
+ * @param {object} [params.gitAdapter] - Git adapter instance (WU-1541: explicit instead of getGitForCwd)
+ * @param {string} [params.repoRoot] - Absolute repo root path for resolving relative paths
+ * @throws {Error} If formatting fails
+ */
+export declare function stageAndFormatMetadata({ id, wuPath, statusPath, backlogPath, stampsDir, initiativePath, gitAdapter, repoRoot, }: StageAndFormatMetadataParams): Promise<void>;
+export {};
+//# sourceMappingURL=wu-done-metadata.d.ts.map

package/dist/wu-done-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-metadata.d.ts","sourceRoot":"","sources":["../src/wu-done-metadata.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgCzD,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,eAAgB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,2BAA2B;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,yBAA0B,SAAQ,2BAA2B;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kCAAmC,SAAQ,2BAA2B;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,aAAa,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,UAAU,4BAA4B;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,SAAS,SAA8B,EACvC,UAAU,GAAE,gBAAqB,GAChC,MAAM,CAsCR;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,UAAU,EACV,WAAW,GACZ,EAAE,2BAA2B,GAAG,IAAI,CAiBpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,EAAE,EACF,KAAK,EACL,GAAG,EACH,MAAM,EACN,UAAU,EACV,WAAW,GACZ,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,wBAAsB,4BAA4B,CAAC,EACjD,EAAE,EACF,KAAK,EACL,GAAG,EACH,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAkB,GACnB,EAAE,kCAAkC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,EAAE,EACF,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,cAAqB,EACrB,UAAiB,EACjB,QAAe,GAChB,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC9C"}

package/dist/wu-done-metadata.js

@@ -0,0 +1,240 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Metadata update helpers for wu:done.
+ */
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { exec as execCallback } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getGitForCwd } from './git-adapter.js';
+import { updateStatusRemoveInProgress, addToStatusCompleted } from './wu-status-updater.js';
+import { moveWUToDoneBacklog } from './wu-backlog-updater.js';
+import { createStamp } from './stamp-utils.js';
+import { WU_EVENTS_FILE_NAME } from './wu-state-store.js';
+import { computeWUYAMLContent, computeStatusContentFromMergedState, computeBacklogContent, computeWUEventsContentAfterComplete, computeStampContent, } from './wu-transaction-collectors.js';
+import { computeInitiativeSyncWriteOnWUComplete } from './wu-done-initiative-sync.js';
+import { DEFAULTS, LOG_PREFIX, EMOJI, PKG_MANAGER, SCRIPTS, PRETTIER_FLAGS, LUMENFLOW_PATHS, WU_STATUS, } from './wu-constants.js';
+import { applyExposureDefaults } from './wu-done-validation.js';
+import { createFileNotFoundError, createValidationError } from './wu-done-errors.js';
+import { writeWU } from './wu-yaml.js';
+import { normalizeToDateString } from './date-utils.js';
+import { findProjectRoot } from './lumenflow-config.js';
+import { getErrorMessage } from './error-handler.js';
+const execAsync = promisify(execCallback);
+/**
+ * Generate commit message for WU completion
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
+ * @param {string} id - WU ID (e.g., "WU-1215")
+ * @param {string} title - WU title
+ * @param {number} maxLength - Maximum commit header length from commitlint config
+ * @returns {string} Formatted commit message
+ * @throws {Error} If generated message exceeds maxLength
+ */
+export function generateCommitMessage(id, title, maxLength = DEFAULTS.MAX_COMMIT_SUBJECT, provenance = {}) {
+    const prefix = `wu(${id.toLowerCase()}): done - `;
+    const safe = String(title).trim().toLowerCase().replace(/\s+/g, ' ');
+    const room = Math.max(0, maxLength - prefix.length);
+    const short = safe.length > room ? `${safe.slice(0, room - 1)}…` : safe;
+    const msg = `${prefix}${short}`;
+    if (msg.length > maxLength) {
+        const error = new Error(`Commit message too long (${msg.length}/${maxLength}).\n` +
+            `Fix: Shorten WU title\n` +
+            `Current title: "${title}" (${title.length} chars)\n` +
+            `Suggested max: ~${maxLength - prefix.length} chars`);
+        error.code = 'COMMIT_MESSAGE_TOO_LONG';
+        error.data = {
+            title,
+            titleLength: title.length,
+            messageLength: msg.length,
+            maxLength,
+            suggestedMax: maxLength - prefix.length,
+        };
+        throw error;
+    }
+    const trailers = [];
+    if (provenance.branch) {
+        trailers.push(`Worktree-Branch: ${provenance.branch}`);
+    }
+    if (provenance.worktreePath) {
+        trailers.push(`Worktree-Path: ${provenance.worktreePath}`);
+    }
+    if (trailers.length === 0) {
+        return msg;
+    }
+    return `${msg}\n\n${trailers.join('\n')}`;
+}
+/**
+ * Validate that required metadata files exist before updating
+ * WU-1275: Fail fast before mutations to prevent partial state
+ *
+ * @param {object} params - Parameters object
+ * @param {string} params.statusPath - Path to status.md file
+ * @param {string} params.backlogPath - Path to backlog.md file
+ * @throws {WUError} If UnsafeAny required file is missing
+ */
+export function validateMetadataFilesExist({ statusPath, backlogPath, }) {
+    const missing = [];
+    if (!existsSync(statusPath)) {
+        missing.push(`Status: ${statusPath}`);
+    }
+    if (!existsSync(backlogPath)) {
+        missing.push(`Backlog: ${backlogPath}`);
+    }
+    if (missing.length > 0) {
+        throw createFileNotFoundError(`Required metadata files missing:\n  ${missing.join('\n  ')}\n\nCannot complete WU - verify worktree has latest metadata files.`, { missingFiles: missing });
+    }
+}
+/**
+ * Update all metadata files for WU completion
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
+ * WU-1572: Made async for WUStateStore integration
+ * @param {object} params - Parameters object
+ * @param {string} params.id - WU ID
+ * @param {string} params.title - WU title
+ * @param {object} params.doc - WU YAML document to update
+ * @param {string} params.wuPath - Path to WU YAML file
+ * @param {string} params.statusPath - Path to status.md file
+ * @param {string} params.backlogPath - Path to backlog.md file
+ */
+export async function updateMetadataFiles({ id, title, doc, wuPath, statusPath, backlogPath, }) {
+    // WU-1275: Fail fast before UnsafeAny mutations
+    validateMetadataFilesExist({ statusPath, backlogPath });
+    const exposureUpdate = applyExposureDefaults(doc);
+    if (exposureUpdate.applied) {
+        console.log(`${LOG_PREFIX.DONE} ${EMOJI.INFO} Auto-set exposure to ${exposureUpdate.exposure} for ${id}`);
+    }
+    // Update WU YAML (mark as done, lock, set completion timestamp)
+    const completedAt = new Date().toISOString();
+    doc.status = WU_STATUS.DONE;
+    doc.locked = true;
+    doc.completed_at = completedAt;
+    doc.completed = normalizeToDateString(doc.completed ?? completedAt) ?? completedAt.slice(0, 10);
+    writeWU(wuPath, doc);
+    // Update status.md (remove from In Progress, add to Completed)
+    updateStatusRemoveInProgress(statusPath, id);
+    addToStatusCompleted(statusPath, id, title);
+    // Update backlog.md (move to Done section)
+    // WU-1572: Now async for state store integration
+    await moveWUToDoneBacklog(backlogPath, id, title);
+    // Create completion stamp
+    createStamp({ id, title });
+}
+/**
+ * Collect metadata updates to a transaction (WU-1369: Atomic pattern)
+ *
+ * This is the atomic version of updateMetadataFiles.
+ * Instead of writing files immediately, it collects all changes
+ * into a WUTransaction object for atomic commit.
+ *
+ * Usage:
+ * ```js
+ * const tx = new WUTransaction(id);
+ * collectMetadataToTransaction({ id, title, doc, wuPath, statusPath, backlogPath, stampPath, transaction: tx });
+ * // All changes are now in tx.pendingWrites
+ * // Validate, then commit or abort
+ * tx.commit();
+ * ```
+ *
+ * @param {object} params - Parameters object
+ * @param {string} params.id - WU ID
+ * @param {string} params.title - WU title
+ * @param {object} params.doc - WU YAML document to update (will be mutated)
+ * @param {string} params.wuPath - Path to WU YAML file
+ * @param {string} params.statusPath - Path to status.md file
+ * @param {string} params.backlogPath - Path to backlog.md file
+ * @param {string} params.stampPath - Path to stamp file
+ * @param {WUTransaction} params.transaction - Transaction to add writes to
+ * @param {string} [params.projectRoot] - Repository root for config/path resolution
+ */
+// WU-1574: Made async for computeBacklogContent
+export async function collectMetadataToTransaction({ id, title, doc, wuPath, statusPath, backlogPath, stampPath, transaction, projectRoot = null, }) {
+    // WU-1369: Fail fast before UnsafeAny computations
+    validateMetadataFilesExist({ statusPath, backlogPath });
+    const exposureUpdate = applyExposureDefaults(doc);
+    if (exposureUpdate.applied) {
+        console.log(`${LOG_PREFIX.DONE} ${EMOJI.INFO} Auto-set exposure to ${exposureUpdate.exposure} for ${id}`);
+    }
+    // Compute WU YAML content (mutates doc, returns YAML string)
+    const wuYAMLContent = computeWUYAMLContent(doc);
+    transaction.addWrite(wuPath, wuYAMLContent, 'WU YAML');
+    // Compute status.md content (WU-1319: now uses merged state)
+    const statusContent = await computeStatusContentFromMergedState(backlogPath, id);
+    transaction.addWrite(statusPath, statusContent, 'status.md');
+    // Compute backlog.md content (WU-1574: now async)
+    const backlogContent = await computeBacklogContent(backlogPath, id, title);
+    transaction.addWrite(backlogPath, backlogContent, 'backlog.md');
+    const wuEventsUpdate = await computeWUEventsContentAfterComplete(backlogPath, id);
+    if (wuEventsUpdate) {
+        transaction.addWrite(wuEventsUpdate.eventsPath, wuEventsUpdate.content, 'wu-events.jsonl');
+    }
+    const resolvedProjectRoot = projectRoot ?? findProjectRoot(path.dirname(backlogPath));
+    const initiativeSyncWrite = computeInitiativeSyncWriteOnWUComplete({
+        wuId: id,
+        wuDoc: doc,
+        projectRoot: resolvedProjectRoot,
+    });
+    if (initiativeSyncWrite) {
+        transaction.addWrite(initiativeSyncWrite.initiativePath, initiativeSyncWrite.content, 'initiative YAML');
+    }
+    // Compute stamp content
+    const stampContent = computeStampContent(id, title);
+    transaction.addWrite(stampPath, stampContent, 'completion stamp');
+    console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Collected ${transaction.size} metadata updates for atomic commit`);
+}
+/**
+ * Stage and format metadata files
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
+ * WU-1541: Added optional gitAdapter and repoRoot params to avoid process.chdir dependency
+ * @param {object} params - Parameters object
+ * @param {string} params.id - WU ID (for error reporting)
+ * @param {string} params.wuPath - Path to WU YAML file
+ * @param {string} params.statusPath - Path to status.md file
+ * @param {string} params.backlogPath - Path to backlog.md file
+ * @param {string} params.stampsDir - Path to stamps directory
+ * @param {string} [params.initiativePath] - Optional parent initiative YAML path
+ * @param {object} [params.gitAdapter] - Git adapter instance (WU-1541: explicit instead of getGitForCwd)
+ * @param {string} [params.repoRoot] - Absolute repo root path for resolving relative paths
+ * @throws {Error} If formatting fails
+ */
+export async function stageAndFormatMetadata({ id, wuPath, statusPath, backlogPath, stampsDir, initiativePath = null, gitAdapter = null, repoRoot = null, }) {
+    // WU-1541: Use explicit gitAdapter if provided, otherwise fall back to getGitForCwd()
+    // This eliminates the dependency on process.chdir() having been called beforehand
+    const gitCwd = gitAdapter ?? getGitForCwd();
+    // WU-1541: Use repoRoot for absolute path resolution if provided,
+    // otherwise fall back to relative path (legacy behavior for callers that still use chdir)
+    const wuEventsPath = repoRoot
+        ? path.join(repoRoot, LUMENFLOW_PATHS.STATE_DIR, WU_EVENTS_FILE_NAME)
+        : path.join(LUMENFLOW_PATHS.STATE_DIR, WU_EVENTS_FILE_NAME);
+    const filesToStage = [wuPath, statusPath, backlogPath];
+    if (initiativePath) {
+        filesToStage.push(initiativePath);
+    }
+    if (existsSync(wuEventsPath)) {
+        filesToStage.push(wuEventsPath);
+    }
+    await gitCwd.add(filesToStage);
+    // WU-1653: Force-add stamps to override .gitignore (stamps must always be tracked)
+    await gitCwd.raw(['add', '--force', stampsDir]);
+    // Format documentation
+    console.log(`${LOG_PREFIX.DONE} Formatting auto-generated documentation...`);
+    try {
+        const filesToFormat = [wuPath, statusPath, backlogPath];
+        if (initiativePath) {
+            filesToFormat.push(initiativePath);
+        }
+        const prettierTargets = filesToFormat.map((file) => `"${file}"`).join(' ');
+        const prettierCmd = `${PKG_MANAGER} ${SCRIPTS.PRETTIER} ${PRETTIER_FLAGS.WRITE} ${prettierTargets}`;
+        await execAsync(prettierCmd);
+        await gitCwd.add(filesToFormat);
+        console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Documentation formatted`);
+    }
+    catch (err) {
+        const errorMessage = getErrorMessage(err);
+        throw createValidationError(`Failed to format documentation: ${errorMessage}`, {
+            wuId: id,
+            error: errorMessage,
+        });
+    }
+}
+//# sourceMappingURL=wu-done-metadata.js.map

package/dist/wu-done-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-metadata.js","sourceRoot":"","sources":["../src/wu-done-metadata.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;GAEG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,oBAAoB,EACpB,mCAAmC,EACnC,qBAAqB,EACrB,mCAAmC,EACnC,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sCAAsC,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EACL,QAAQ,EACR,UAAU,EACV,KAAK,EACL,WAAW,EACX,OAAO,EACP,cAAc,EACd,eAAe,EACf,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;AAoD1C;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAU,EACV,KAAa,EACb,SAAS,GAAG,QAAQ,CAAC,kBAAkB,EACvC,aAA+B,EAAE;IAEjC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC;IAEhC,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GAA8D,IAAI,KAAK,CAChF,4BAA4B,GAAG,CAAC,MAAM,IAAI,SAAS,MAAM;YACvD,yBAAyB;YACzB,mBAAmB,KAAK,MAAM,KAAK,CAAC,MAAM,WAAW;YACrD,mBAAmB,SAAS,GAAG,MAAM,CAAC,MAAM,QAAQ,CACvD,CAAC;QACF,KAAK,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACvC,KAAK,CAAC,IAAI,GAAG;YACX,KAAK;YACL,WAAW,EAAE,KAAK,CAAC,MAAM;YACzB,aAAa,EAAE,GAAG,CAAC,MAAM;YACzB,SAAS;YACT,YAAY,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM;SACxC,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,oBAAoB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,kBAAkB,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,GAAG,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,UAAU,EACV,WAAW,GACiB;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,uBAAuB,CAC3B,uCAAuC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,qEAAqE,EAChI,EAAE,YAAY,EAAE,OAAO,EAAE,CAC1B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,EAAE,EACF,KAAK,EACL,GAAG,EACH,MAAM,EACN,UAAU,EACV,WAAW,GACe;IAC1B,gDAAgD;IAChD,0BAA0B,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;IAExD,MAAM,cAAc,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CACT,GAAG,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,yBAAyB,cAAc,CAAC,QAAQ,QAAQ,EAAE,EAAE,CAC7F,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC;IAC5B,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;IAClB,GAAG,CAAC,YAAY,GAAG,WAAW,CAAC;IAC/B,GAAG,CAAC,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,SAAS,IAAI,WAAW,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAErB,+DAA+D;IAC/D,4BAA4B,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC7C,oBAAoB,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAE5C,2CAA2C;IAC3C,iDAAiD;IACjD,MAAM,mBAAmB,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAElD,0BAA0B;IAC1B,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,EACjD,EAAE,EACF,KAAK,EACL,GAAG,EACH,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAW,GAAG,IAAI,GACiB;IACnC,mDAAmD;IACnD,0BAA0B,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;IAExD,MAAM,cAAc,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CACT,GAAG,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,yBAAyB,cAAc,CAAC,QAAQ,QAAQ,EAAE,EAAE,CAC7F,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,MAAM,aAAa,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAChD,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IAEvD,6DAA6D;IAC7D,MAAM,aAAa,GAAG,MAAM,mCAAmC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACjF,WAAW,CAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IAE7D,kDAAkD;IAClD,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3E,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;IAEhE,MAAM,cAAc,GAAG,MAAM,mCAAmC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAClF,IAAI,cAAc,EAAE,CAAC;QACnB,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,mBAAmB,GAAG,WAAW,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACtF,MAAM,mBAAmB,GAAG,sCAAsC,CAAC;QACjE,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,mBAAmB;KACjC,CAAC,CAAC;IACH,IAAI,mBAAmB,EAAE,CAAC;QACxB,WAAW,CAAC,QAAQ,CAClB,mBAAmB,CAAC,cAAc,EAClC,mBAAmB,CAAC,OAAO,EAC3B,iBAAiB,CAClB,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,MAAM,YAAY,GAAG,mBAAmB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACpD,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;IAElE,OAAO,CAAC,GAAG,CACT,GAAG,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,cAAc,WAAW,CAAC,IAAI,qCAAqC,CACvG,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAC3C,EAAE,EACF,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,cAAc,GAAG,IAAI,EACrB,UAAU,GAAG,IAAI,EACjB,QAAQ,GAAG,IAAI,GACc;IAC7B,sFAAsF;IACtF,kFAAkF;IAClF,MAAM,MAAM,GAAG,UAAU,IAAI,YAAY,EAAE,CAAC;IAE5C,kEAAkE;IAClE,0FAA0F;IAC1F,MAAM,YAAY,GAAG,QAAQ;QAC3B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,SAAS,EAAE,mBAAmB,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,cAAc,EAAE,CAAC;QACnB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC/B,mFAAmF;IACnF,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAEhD,uBAAuB;IACvB,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,6CAA6C,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QACxD,IAAI,cAAc,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,eAAe,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3E,MAAM,WAAW,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;QACpG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;QAC7B,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,qBAAqB,CAAC,mCAAmC,YAAY,EAAE,EAAE;YAC7E,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}