@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-status-updater.js

@@ -0,0 +1,123 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Status.md Update Utilities
+ *
+ * Centralized status.md update functions (extracted from wu-done.ts)
+ * Refactored to use frontmatter-based section headings (no magic strings)
+ *
+ * Used by both main wu:done flow AND recovery mode (DRY principle)
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { parseBacklogFrontmatter } from './backlog-parser.js';
+import { getSectionHeadingsWithDefaults } from './section-headings.js';
+import { todayISO } from './date-utils.js';
+import { die, createError, ErrorCodes } from './error-handler.js';
+import { STRING_LITERALS } from './wu-constants.js';
+/**
+ * Remove WU from In Progress section (idempotent)
+ * Refactored from wu-done.ts line 471 to use frontmatter headings
+ *
+ * @param {string} statusPath - Path to status.md
+ * @param {string} id - WU ID
+ */
+export function updateStatusRemoveInProgress(statusPath, id) {
+    if (!existsSync(statusPath)) {
+        throw createError(ErrorCodes.FILE_NOT_FOUND, `Status file not found: ${statusPath}`, {
+            path: statusPath,
+            function: 'updateStatusRemoveInProgress',
+        });
+    }
+    // Use frontmatter parser to get configured section headings
+    const { frontmatter, markdown } = parseBacklogFrontmatter(statusPath);
+    const headings = getSectionHeadingsWithDefaults(frontmatter, 'status');
+    const rel = `wu/${id}.yaml`;
+    const lines = markdown.split(STRING_LITERALS.NEWLINE);
+    // Find In Progress section using configured heading
+    const startIdx = lines.findIndex((l) => l.trim() === headings.in_progress);
+    if (startIdx === -1) {
+        throw createError(ErrorCodes.SECTION_NOT_FOUND, `Could not find "${headings.in_progress}" section in ${statusPath}`, { path: statusPath, section: headings.in_progress, function: 'updateStatusRemoveInProgress' });
+    }
+    // Find section boundaries
+    let endIdx = lines.slice(startIdx + 1).findIndex((l) => l.startsWith('## '));
+    endIdx = endIdx === -1 ? lines.length - startIdx - 1 : startIdx + 1 + endIdx;
+    // Remove WU entry (idempotent - safe to call if already removed)
+    let removed = false;
+    for (let i = startIdx + 1; i < endIdx; i++) {
+        const line = lines[i];
+        if (line && (line.includes(rel) || line.includes(`[${id}`))) {
+            lines.splice(i, 1);
+            removed = true;
+            endIdx--;
+            i--; // Adjust index after splice
+        }
+    }
+    // Add placeholder if section is now empty
+    if (removed) {
+        const section = lines.slice(startIdx + 1, endIdx).filter((l) => l.trim() !== '');
+        if (section.length === 0) {
+            lines.splice(endIdx, 0, '', '(No items currently in progress)', '');
+        }
+    }
+    // Reconstruct file with frontmatter preservation
+    const raw = readFileSync(statusPath, { encoding: 'utf-8' });
+    const frontmatterMatch = raw.match(/^---\n[\s\S]*?\n---\n/);
+    const frontmatterText = frontmatterMatch ? frontmatterMatch[0] : '';
+    writeFileSync(statusPath, frontmatterText + lines.join(STRING_LITERALS.NEWLINE), {
+        encoding: 'utf-8',
+    });
+}
+/**
+ * Add WU to Completed section (idempotent - checks for duplicates)
+ * Refactored from wu-done.ts line 499 to use frontmatter headings
+ *
+ * @param {string} statusPath - Path to status.md
+ * @param {string} id - WU ID
+ * @param {string} title - WU title
+ */
+export function addToStatusCompleted(statusPath, id, title) {
+    if (!existsSync(statusPath)) {
+        throw createError(ErrorCodes.FILE_NOT_FOUND, `Status file not found: ${statusPath}`, {
+            path: statusPath,
+            function: 'addToStatusCompleted',
+        });
+    }
+    // Use frontmatter parser to get configured section headings
+    const { frontmatter, markdown } = parseBacklogFrontmatter(statusPath);
+    const headings = getSectionHeadingsWithDefaults(frontmatter, 'status');
+    const rel = `wu/${id}.yaml`;
+    const date = todayISO();
+    const completedEntry = `- [${id} — ${title}](${rel}) — ${date}`;
+    const lines = markdown.split(STRING_LITERALS.NEWLINE);
+    // Find Completed section using configured heading
+    const completedIdx = lines.findIndex((l) => l.trim() === headings.completed);
+    if (completedIdx === -1) {
+        die(`Could not find "${headings.completed}" section in ${statusPath}`);
+    }
+    // Idempotent check: skip if already in Completed section
+    const nextSectionIdx = lines.slice(completedIdx + 1).findIndex((l) => l.startsWith('## '));
+    const completedEndIdx = nextSectionIdx === -1 ? lines.length : completedIdx + 1 + nextSectionIdx;
+    const completedSection = lines.slice(completedIdx, completedEndIdx).join(STRING_LITERALS.NEWLINE);
+    if (completedSection.includes(`[${id}`)) {
+        console.log(`[wu-status-updater] ${id} already in Completed section (idempotent skip)`);
+        return;
+    }
+    // Insert at top of Completed section (after header, skipping empty lines)
+    let insertIdx = completedIdx + 1;
+    while (insertIdx < lines.length) {
+        const line = lines[insertIdx];
+        if (typeof line !== 'string' || line.trim() !== '') {
+            break;
+        }
+        insertIdx++;
+    }
+    lines.splice(insertIdx, 0, completedEntry);
+    // Reconstruct file with frontmatter preservation
+    const raw = readFileSync(statusPath, { encoding: 'utf-8' });
+    const frontmatterMatch = raw.match(/^---\n[\s\S]*?\n---\n/);
+    const frontmatterText = frontmatterMatch ? frontmatterMatch[0] : '';
+    writeFileSync(statusPath, frontmatterText + lines.join(STRING_LITERALS.NEWLINE), {
+        encoding: 'utf-8',
+    });
+}
+//# sourceMappingURL=wu-status-updater.js.map

package/dist/wu-status-updater.js.map

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

package/dist/wu-statuses.d.ts

@@ -0,0 +1,154 @@
+/**
+ * WU Status Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains WU status values, groups, exposure types, claimed modes, and incident severity.
+ *
+ * @module wu-statuses
+ */
+/**
+ * WU status values
+ *
+ * Centralized status strings to avoid magic strings in wu-* scripts.
+ * Includes both canonical statuses and legacy variants found in YAML files.
+ */
+export declare const WU_STATUS: {
+    TODO: string;
+    READY: string;
+    BACKLOG: string;
+    IN_PROGRESS: string;
+    BLOCKED: string;
+    DONE: string;
+    COMPLETED: string;
+    CANCELLED: string;
+    ABANDONED: string;
+    DEFERRED: string;
+    CLOSED: string;
+    SUPERSEDED: string;
+};
+export type WUStatus = (typeof WU_STATUS)[keyof typeof WU_STATUS];
+/**
+ * Display-only fallback labels for non-canonical status values.
+ */
+export declare const WU_STATUS_FALLBACK: {
+    readonly UNKNOWN: "unknown";
+};
+export type WUStatusDisplay = WUStatus | (typeof WU_STATUS_FALLBACK)[keyof typeof WU_STATUS_FALLBACK];
+/**
+ * Type guard for canonical WU statuses.
+ */
+export declare function isWUStatus(value: unknown): value is WUStatus;
+/**
+ * Resolve arbitrary status values to canonical WU statuses.
+ */
+export declare function resolveWUStatus(value: unknown, fallback?: WUStatus): WUStatus;
+/**
+ * Resolve status values for logs/UI where unknown is an allowed display state.
+ */
+export declare function getWUStatusDisplay(value: unknown): WUStatusDisplay;
+/**
+ * WU-1540: Protected WU statuses for cleanup and signal protection.
+ *
+ * WUs in these statuses should NOT have their signals, memory, or state
+ * cleaned up. Both in_progress and blocked WUs need protection because
+ * blocked WUs will resume work after the blocker is resolved.
+ *
+ * Used by: wu-done-auto-cleanup.ts, signal-cleanup.ts, state-cleanup.ts
+ */
+export declare const PROTECTED_WU_STATUSES: readonly string[];
+/**
+ * WU-1540: Progressable WU statuses for initiative advancement.
+ *
+ * Only WUs in these statuses indicate active work that should trigger
+ * initiative status progression (e.g., draft -> in_progress).
+ * Blocked WUs are explicitly excluded because a blocked WU does not
+ * represent forward progress on the initiative.
+ *
+ * Used by: initiative-validation.ts (shouldProgressInitiativeStatus)
+ */
+export declare const PROGRESSABLE_WU_STATUSES: readonly string[];
+/**
+ * WU status groups for state management (WU-1742)
+ *
+ * Used by state-bootstrap.ts to categorize YAML statuses.
+ */
+export declare const WU_STATUS_GROUPS: {
+    /** Statuses representing unclaimed work (not tracked in state store) */
+    UNCLAIMED: string[];
+    /** Terminal statuses (all map to 'done' in state store) */
+    TERMINAL: string[];
+};
+/**
+ * WU claimed workspace modes
+ *
+ * Centralized workspace mode strings for wu:claim operations.
+ */
+export declare const CLAIMED_MODES: {
+    /** Standard worktree mode (isolated worktree per WU) */
+    WORKTREE: string;
+    /** Branch-only mode (no worktree, direct branch work) */
+    BRANCH_ONLY: string;
+    /** Worktree PR mode (worktree with manual PR workflow) */
+    WORKTREE_PR: string;
+    /** Branch PR mode (no worktree, PR-based completion for cloud agents) */
+    BRANCH_PR: string;
+};
+/**
+ * Agent incident severity levels
+ *
+ * Centralized severity strings for agent incident reporting.
+ */
+export declare const INCIDENT_SEVERITY: {
+    BLOCKER: string;
+    MAJOR: string;
+    MINOR: string;
+    INFO: string;
+};
+/**
+ * WU type values
+ *
+ * WU-1281: Centralized from hardcoded strings in validators
+ */
+export declare const WU_TYPES: {
+    DOCUMENTATION: string;
+    PROCESS: string;
+    FEATURE: string;
+    TOOLING: string;
+    BUG: string;
+};
+/**
+ * WU exposure values (WU-1998)
+ *
+ * Defines how a WU exposes its functionality to users.
+ * Used to ensure backend features have corresponding UI coverage.
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - Schema validation
+ * @see {@link packages/linters/wu-schema-linter.ts} - Linter validation
+ */
+export declare const WU_EXPOSURE: {
+    /** User-facing UI changes (pages, components, widgets) */
+    readonly UI: "ui";
+    /** API endpoints that are called by UI or external clients */
+    readonly API: "api";
+    /** Backend-only changes (no user visibility) */
+    readonly BACKEND_ONLY: "backend-only";
+    /** Documentation changes only */
+    readonly DOCUMENTATION: "documentation";
+};
+/**
+ * Array of valid exposure values for schema validation
+ * Note: Defined as tuple for Zod enum compatibility
+ */
+export declare const WU_EXPOSURE_VALUES: readonly ["ui", "api", "backend-only", "documentation"];
+/**
+ * Test type keys
+ *
+ * WU-1281: Centralized from hardcoded keys in validators
+ */
+export declare const TEST_TYPES: {
+    UNIT: string;
+    E2E: string;
+    MANUAL: string;
+    INTEGRATION: string;
+};
+//# sourceMappingURL=wu-statuses.d.ts.map

package/dist/wu-statuses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-statuses.d.ts","sourceRoot":"","sources":["../src/wu-statuses.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;CAmBrB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;CAErB,CAAC;AAEX,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAIjE;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,QAA0B,GAAG,QAAQ,CAE9F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAElE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAGzC,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAAqC,CAAC;AAE5F;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;IAC3B,wEAAwE;;IAGxE,2DAA2D;;CAU5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB,wDAAwD;;IAGxD,yDAAyD;;IAGzD,0DAA0D;;IAG1D,yEAAyE;;CAE1E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;CAK7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMpB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;IACtB,0DAA0D;;IAG1D,8DAA8D;;IAG9D,gDAAgD;;IAGhD,iCAAiC;;CAEzB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yDAA0D,CAAC;AAE1F;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;CAKtB,CAAC"}

package/dist/wu-statuses.js

@@ -0,0 +1,176 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Status Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains WU status values, groups, exposure types, claimed modes, and incident severity.
+ *
+ * @module wu-statuses
+ */
+/**
+ * WU status values
+ *
+ * Centralized status strings to avoid magic strings in wu-* scripts.
+ * Includes both canonical statuses and legacy variants found in YAML files.
+ */
+export const WU_STATUS = {
+    // Unclaimed statuses (not yet entered state machine)
+    // WU-1374: Legacy backlog status value
+    TODO: 'todo',
+    READY: 'ready', // Canonical unclaimed status
+    BACKLOG: 'backlog', // Legacy variant of ready
+    // Active statuses (in state machine)
+    IN_PROGRESS: 'in_progress',
+    BLOCKED: 'blocked',
+    // Terminal statuses (work finished, no further transitions)
+    DONE: 'done', // Canonical terminal status
+    COMPLETED: 'completed', // Legacy variant of done
+    CANCELLED: 'cancelled',
+    ABANDONED: 'abandoned',
+    DEFERRED: 'deferred',
+    CLOSED: 'closed',
+    SUPERSEDED: 'superseded',
+};
+/**
+ * Display-only fallback labels for non-canonical status values.
+ */
+export const WU_STATUS_FALLBACK = {
+    UNKNOWN: 'unknown',
+};
+const WU_STATUS_SET = new Set(Object.values(WU_STATUS));
+/**
+ * Type guard for canonical WU statuses.
+ */
+export function isWUStatus(value) {
+    return typeof value === 'string' && WU_STATUS_SET.has(value);
+}
+/**
+ * Resolve arbitrary status values to canonical WU statuses.
+ */
+export function resolveWUStatus(value, fallback = WU_STATUS.READY) {
+    return isWUStatus(value) ? value : fallback;
+}
+/**
+ * Resolve status values for logs/UI where unknown is an allowed display state.
+ */
+export function getWUStatusDisplay(value) {
+    return isWUStatus(value) ? value : WU_STATUS_FALLBACK.UNKNOWN;
+}
+/**
+ * WU-1540: Protected WU statuses for cleanup and signal protection.
+ *
+ * WUs in these statuses should NOT have their signals, memory, or state
+ * cleaned up. Both in_progress and blocked WUs need protection because
+ * blocked WUs will resume work after the blocker is resolved.
+ *
+ * Used by: wu-done-auto-cleanup.ts, signal-cleanup.ts, state-cleanup.ts
+ */
+export const PROTECTED_WU_STATUSES = [
+    WU_STATUS.IN_PROGRESS,
+    WU_STATUS.BLOCKED,
+];
+/**
+ * WU-1540: Progressable WU statuses for initiative advancement.
+ *
+ * Only WUs in these statuses indicate active work that should trigger
+ * initiative status progression (e.g., draft -> in_progress).
+ * Blocked WUs are explicitly excluded because a blocked WU does not
+ * represent forward progress on the initiative.
+ *
+ * Used by: initiative-validation.ts (shouldProgressInitiativeStatus)
+ */
+export const PROGRESSABLE_WU_STATUSES = [WU_STATUS.IN_PROGRESS];
+/**
+ * WU status groups for state management (WU-1742)
+ *
+ * Used by state-bootstrap.ts to categorize YAML statuses.
+ */
+export const WU_STATUS_GROUPS = {
+    /** Statuses representing unclaimed work (not tracked in state store) */
+    UNCLAIMED: [WU_STATUS.READY, WU_STATUS.TODO, WU_STATUS.BACKLOG],
+    /** Terminal statuses (all map to 'done' in state store) */
+    TERMINAL: [
+        WU_STATUS.DONE,
+        WU_STATUS.COMPLETED,
+        WU_STATUS.CANCELLED,
+        WU_STATUS.ABANDONED,
+        WU_STATUS.DEFERRED,
+        WU_STATUS.CLOSED,
+        WU_STATUS.SUPERSEDED,
+    ],
+};
+/**
+ * WU claimed workspace modes
+ *
+ * Centralized workspace mode strings for wu:claim operations.
+ */
+export const CLAIMED_MODES = {
+    /** Standard worktree mode (isolated worktree per WU) */
+    WORKTREE: 'worktree',
+    /** Branch-only mode (no worktree, direct branch work) */
+    BRANCH_ONLY: 'branch-only',
+    /** Worktree PR mode (worktree with manual PR workflow) */
+    WORKTREE_PR: 'worktree-pr',
+    /** Branch PR mode (no worktree, PR-based completion for cloud agents) */
+    BRANCH_PR: 'branch-pr',
+};
+/**
+ * Agent incident severity levels
+ *
+ * Centralized severity strings for agent incident reporting.
+ */
+export const INCIDENT_SEVERITY = {
+    BLOCKER: 'blocker',
+    MAJOR: 'major',
+    MINOR: 'minor',
+    INFO: 'info',
+};
+/**
+ * WU type values
+ *
+ * WU-1281: Centralized from hardcoded strings in validators
+ */
+export const WU_TYPES = {
+    DOCUMENTATION: 'documentation',
+    PROCESS: 'process',
+    FEATURE: 'feature',
+    TOOLING: 'tooling',
+    BUG: 'bug',
+};
+/**
+ * WU exposure values (WU-1998)
+ *
+ * Defines how a WU exposes its functionality to users.
+ * Used to ensure backend features have corresponding UI coverage.
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - Schema validation
+ * @see {@link packages/linters/wu-schema-linter.ts} - Linter validation
+ */
+export const WU_EXPOSURE = {
+    /** User-facing UI changes (pages, components, widgets) */
+    UI: 'ui',
+    /** API endpoints that are called by UI or external clients */
+    API: 'api',
+    /** Backend-only changes (no user visibility) */
+    BACKEND_ONLY: 'backend-only',
+    /** Documentation changes only */
+    DOCUMENTATION: 'documentation',
+};
+/**
+ * Array of valid exposure values for schema validation
+ * Note: Defined as tuple for Zod enum compatibility
+ */
+export const WU_EXPOSURE_VALUES = ['ui', 'api', 'backend-only', 'documentation'];
+/**
+ * Test type keys
+ *
+ * WU-1281: Centralized from hardcoded keys in validators
+ */
+export const TEST_TYPES = {
+    UNIT: 'unit',
+    E2E: 'e2e',
+    MANUAL: 'manual',
+    INTEGRATION: 'integration',
+};
+//# sourceMappingURL=wu-statuses.js.map

package/dist/wu-statuses.js.map

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

package/dist/wu-transaction-collectors.d.ts

@@ -0,0 +1,111 @@
+import type { WUDocBase as WUDoc } from './wu-doc-types.js';
+interface CollectMetadataParams {
+    doc: WUDoc;
+    id: string;
+    title: string;
+    wuPath: string;
+    statusPath: string;
+    backlogPath: string;
+    stampPath: string;
+}
+interface MetadataUpdate {
+    path: string;
+    content: string;
+    description: string;
+}
+export interface CollectedMetadataUpdates {
+    wuYAML: MetadataUpdate;
+    status: MetadataUpdate;
+    backlog: MetadataUpdate;
+    stamp: MetadataUpdate;
+}
+/**
+ * Compute WU YAML content for done state
+ *
+ * Updates the document in-place and returns the YAML string.
+ * Does NOT write to disk.
+ *
+ * @param {object} doc - WU YAML document (will be mutated)
+ * @returns {string} YAML content string
+ */
+export declare function computeWUYAMLContent(doc: WUDoc): string;
+/**
+ * Compute updated status.md content
+ *
+ * Removes WU from In Progress section and adds to Completed section.
+ * Returns the new file content without writing.
+ *
+ * @param {string} statusPath - Path to status.md
+ * @param {string} id - WU ID
+ * @param {string} title - WU title
+ * @returns {string} New status.md content
+ * @throws {Error} If file not found or section not found
+ */
+export declare function computeStatusContent(statusPath: string, id: string, title: string): string;
+/**
+ * Compute wu-events.jsonl content after completing a WU.
+ *
+ * WU-1145: Now merges with origin/main to preserve concurrent changes.
+ * This prevents loss of WU entries when multiple WUs are completed concurrently.
+ *
+ * @param {string} backlogPath - Path to backlog.md
+ * @param {string} wuId - WU ID being completed
+ * @returns {Promise<{eventsPath: string, content: string} | null>}
+ */
+export declare function computeWUEventsContentAfterComplete(backlogPath: string, wuId: string): Promise<{
+    eventsPath: string;
+    content: string;
+} | null>;
+/**
+ * Compute updated backlog.md content
+ *
+ * WU-1574: Simplified to generate from state store
+ * WU-1145: Now merges with origin/main to preserve concurrent changes
+ *
+ * @param {string} backlogPath - Path to backlog.md
+ * @param {string} id - WU ID to mark complete
+ * @param {string} _title - WU title (unused - state store has it)
+ * @returns {Promise<string>} New backlog.md content
+ */
+export declare function computeBacklogContent(backlogPath: string, id: string, _title: string): Promise<string>;
+/**
+ * Compute updated status.md content from merged state store
+ *
+ * WU-1319: Generates status.md from merged state (origin/main + worktree events)
+ * instead of editing the local file snapshot. This prevents reintroducing
+ * stale "In Progress" entries when concurrent WUs complete on main.
+ *
+ * @param {string} backlogPath - Path to backlog.md (used to find state dir)
+ * @param {string} id - WU ID to mark complete
+ * @returns {Promise<string>} New status.md content
+ */
+export declare function computeStatusContentFromMergedState(backlogPath: string, id: string): Promise<string>;
+/**
+ * Compute stamp file content
+ *
+ * @param {string} id - WU ID
+ * @param {string} title - WU title
+ * @returns {string} Stamp content
+ */
+export declare function computeStampContent(id: string, title: string): string;
+/**
+ * Collect all metadata updates for a transaction
+ * WU-1574: Made async for computeBacklogContent
+ * WU-1319: Made status.md generation use merged state
+ *
+ * Convenience function that computes all file contents at once.
+ * Returns an object with all computed content.
+ *
+ * @param {object} params - Parameters
+ * @param {object} params.doc - WU YAML document (will be mutated)
+ * @param {string} params.id - WU ID
+ * @param {string} params.title - WU title
+ * @param {string} params.wuPath - Path to WU YAML
+ * @param {string} params.statusPath - Path to status.md
+ * @param {string} params.backlogPath - Path to backlog.md
+ * @param {string} params.stampPath - Path to stamp file
+ * @returns {Promise<object>} Object with content for each file
+ */
+export declare function collectMetadataUpdates({ doc, id, title, wuPath, statusPath, backlogPath, stampPath, }: CollectMetadataParams): Promise<CollectedMetadataUpdates>;
+export {};
+//# sourceMappingURL=wu-transaction-collectors.d.ts.map

package/dist/wu-transaction-collectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-transaction-collectors.d.ts","sourceRoot":"","sources":["../src/wu-transaction-collectors.ts"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE5D,UAAU,qBAAqB;IAC7B,GAAG,EAAE,KAAK,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAWvD;AAsFD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgE1F;AAED;;;;;;;;;GASG;AACH,wBAAsB,mCAAmC,CACvD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAGzD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mCAAmC,CACvD,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,GAAG,EACH,EAAE,EACF,KAAK,EACL,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,GACV,EAAE,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAwB3D"}