@lumenflow/core 4.11.0 → 4.12.1

package/dist/wu-id-format.js

@@ -0,0 +1,252 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU ID Format Primitives (WU-2552)
+ *
+ * Canonical zero-padded WU ID primitives. All ID formatting, parsing,
+ * and regex construction flows through this module so that width, strict
+ * mode, and prefix can be centrally configured via workspace.yaml
+ * `software_delivery.wu_id.{width,strict,prefix}`.
+ *
+ * Design principles:
+ * - Pure functions, no I/O, no config reads (caller supplies config).
+ * - Hardcoded choices: separator '-', lowercase digits, padding char '0',
+ *   starting number 1, gap-fill policy 'never reuse'.
+ * - `wuIdRegex` is intentionally permissive (matches both padded and unpadded
+ *   digit counts) so that consumers scanning files for legacy + canonical
+ *   IDs stay backward compatible during the transition. Strict canonical
+ *   form is enforced separately via `isCanonicalWuId`.
+ *
+ * @module wu-id-format
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { createError, ErrorCodes } from './error-handler.js';
+import { getConfig } from './lumenflow-config.js';
+/** Minimum allowed zero-padding width. */
+export const WU_ID_WIDTH_MIN = 1;
+/** Maximum allowed zero-padding width. */
+export const WU_ID_WIDTH_MAX = 6;
+/**
+ * Prefix validation pattern: uppercase letter start, followed by 1-9 more
+ * uppercase-alphanumeric characters, terminated by a dash. Matches 'WU-',
+ * 'TASK-', 'STORY-', 'TICKET-', 'JIRA123-'. Rejects lowercase, missing dash,
+ * single-char prefixes, and over-long prefixes.
+ */
+export const WU_ID_PREFIX_PATTERN = /^[A-Z][A-Z0-9]{1,9}-$/;
+/** Default WU ID configuration. */
+export const WU_ID_DEFAULTS = Object.freeze({
+    width: 4,
+    strict: true,
+    prefix: 'WU-',
+});
+/**
+ * Validate and resolve a partial WU ID config against the defaults.
+ *
+ * @throws {Error} If width is not an integer in [1, 6] or prefix does not
+ *   match {@link WU_ID_PREFIX_PATTERN}.
+ */
+export function validateWuIdConfig(partial = {}) {
+    const width = partial.width ?? WU_ID_DEFAULTS.width;
+    const strict = partial.strict ?? WU_ID_DEFAULTS.strict;
+    const prefix = partial.prefix ?? WU_ID_DEFAULTS.prefix;
+    if (!Number.isInteger(width) || width < WU_ID_WIDTH_MIN || width > WU_ID_WIDTH_MAX) {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `Invalid wu_id.width: ${String(width)}. Must be an integer between ${WU_ID_WIDTH_MIN} and ${WU_ID_WIDTH_MAX}.`);
+    }
+    if (typeof prefix !== 'string' || !WU_ID_PREFIX_PATTERN.test(prefix)) {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `Invalid wu_id.prefix: "${String(prefix)}". Must match ${WU_ID_PREFIX_PATTERN} (e.g., 'WU-', 'TASK-', 'STORY-').`);
+    }
+    return { width, strict, prefix };
+}
+/**
+ * Format an integer as a canonical WU ID.
+ *
+ * Zero-pads to the configured width. If the integer exceeds 10^width, the
+ * result is wider than width (overflow is preserved, never truncated).
+ *
+ * @throws {Error} If n is not a positive integer.
+ */
+export function formatWuId(n, config = {}) {
+    if (!Number.isInteger(n) || n < 1) {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `Invalid WU number: ${String(n)}. Must be a positive integer.`);
+    }
+    const { width, prefix } = validateWuIdConfig(config);
+    return `${prefix}${String(n).padStart(width, '0')}`;
+}
+/**
+ * Parse a WU ID (or YAML/stamp filename) into its prefix and numeric parts.
+ *
+ * Returns null for any input that does not match the configured prefix or
+ * does not carry a positive integer body. Accepts both canonical padded and
+ * legacy unpadded forms.
+ *
+ * Strips `.yaml` and `.done` extensions before parsing.
+ */
+export function parseWuId(id, config = {}) {
+    if (typeof id !== 'string' || id.length === 0) {
+        return null;
+    }
+    const { prefix } = validateWuIdConfig(config);
+    const stripped = id.replace(/\.(yaml|done)$/, '');
+    if (!stripped.startsWith(prefix)) {
+        return null;
+    }
+    const body = stripped.slice(prefix.length);
+    if (!/^\d+$/.test(body)) {
+        return null;
+    }
+    const num = parseInt(body, 10);
+    if (!Number.isFinite(num) || num < 1) {
+        return null;
+    }
+    return { prefix, num };
+}
+/**
+ * Build an anchored regex that matches WU IDs (both padded and unpadded
+ * digit counts) for the configured prefix. Intended for file scans and
+ * consumers that previously hardcoded `/^WU-\d+$/`.
+ *
+ * Strict canonical-form enforcement lives in {@link isCanonicalWuId}, not here.
+ */
+export function wuIdRegex(config = {}) {
+    // eslint-disable-next-line security/detect-non-literal-regexp -- prefix escaped
+    return new RegExp(`^${wuIdBodyPattern(config)}$`);
+}
+/**
+ * Return an unanchored pattern string (for embedding in longer regexes)
+ * that matches the WU id body — the configured prefix followed by one
+ * or more digits. Consumers that previously hardcoded `WU-\\d+` inside
+ * a larger regex should use this helper so prefix configuration
+ * (`software_delivery.wu_id.prefix`) is honored.
+ *
+ * The pattern does NOT include anchors; callers decide whether to
+ * anchor with `^`/`$` or embed in a path/substring match.
+ */
+export function wuIdBodyPattern(config = {}) {
+    const { prefix } = validateWuIdConfig(config);
+    const escaped = prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return `${escaped}\\d+`;
+}
+/**
+ * Return true if the given string is a canonical WU ID for the configured
+ * width and prefix. Canonical means:
+ * - Prefix matches.
+ * - Digit body is at least `width` characters long.
+ * - The digit body is not shorter than width (no unpadded legacy).
+ * - Overflow (body wider than width) is allowed so the sequence never truncates.
+ */
+export function isCanonicalWuId(id, config = {}) {
+    const { width, prefix } = validateWuIdConfig(config);
+    if (typeof id !== 'string' || !id.startsWith(prefix)) {
+        return false;
+    }
+    const body = id.slice(prefix.length);
+    if (!/^\d+$/.test(body)) {
+        return false;
+    }
+    return body.length >= width;
+}
+/**
+ * Canonicalize a (possibly legacy) WU ID to the canonical form for the
+ * configured width. Returns null for unparseable input or prefix mismatch.
+ *
+ * Already-canonical IDs are returned unchanged. Overflow IDs (wider than
+ * width) are preserved.
+ */
+export function canonicalizeWuId(id, config = {}) {
+    const parsed = parseWuId(id, config);
+    if (!parsed) {
+        return null;
+    }
+    return formatWuId(parsed.num, config);
+}
+/**
+ * Load the canonical WU id config from workspace.yaml
+ * `software_delivery.wu_id.{width,strict,prefix}`.
+ *
+ * Falls back to {@link WU_ID_DEFAULTS} when the block is absent, so
+ * existing repos without any wu_id config continue to see WU- prefixed
+ * ids (backward compatible) with the only visible change being
+ * zero-padding on newly-generated ids.
+ *
+ * @param options.projectRoot - Optional override for the project root.
+ */
+export function loadWuIdConfig(options = {}) {
+    const config = getConfig(options.projectRoot ? { projectRoot: options.projectRoot } : {});
+    const wuIdBlock = config.wuId;
+    return validateWuIdConfig(wuIdBlock ?? {});
+}
+/**
+ * Scan every existing WU id integer across the yaml directory, stamps
+ * directory, and event log. Used by wu:create for integer-level
+ * collision detection so `WU-14` and `WU-0014` can never coexist.
+ *
+ * Results are deduplicated across sources. Entries whose prefix does
+ * not match the configured prefix are ignored. Extension suffixes
+ * (`.yaml`, `.done`) are stripped before parsing.
+ */
+export function scanExistingWuNumbers(input, config = {}) {
+    const result = new Set();
+    const addFromEntries = (entries) => {
+        for (const entry of entries) {
+            const parsed = parseWuId(entry, config);
+            if (parsed) {
+                result.add(parsed.num);
+            }
+        }
+    };
+    if (existsSync(input.wuDir)) {
+        addFromEntries(readdirSync(input.wuDir));
+    }
+    if (existsSync(input.stampsDir)) {
+        addFromEntries(readdirSync(input.stampsDir));
+    }
+    if (existsSync(input.eventsPath)) {
+        try {
+            const content = readFileSync(input.eventsPath, { encoding: 'utf-8' });
+            for (const line of content.split('\n')) {
+                const trimmed = line.trim();
+                if (trimmed.length === 0)
+                    continue;
+                try {
+                    const event = JSON.parse(trimmed);
+                    for (const candidate of [event.wuId, event.from, event.to]) {
+                        if (typeof candidate === 'string') {
+                            const parsed = parseWuId(candidate, config);
+                            if (parsed) {
+                                result.add(parsed.num);
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // Ignore malformed lines; the events file is allowed to have gaps.
+                }
+            }
+        }
+        catch {
+            // Read errors fall through; caller treats this as "no known ids".
+        }
+    }
+    return result;
+}
+/**
+ * Returns true when `num` is already present in the given set.
+ * Thin wrapper for call-site readability at the wu:create integration point.
+ */
+export function integerCollides(existing, num) {
+    return existing.has(num);
+}
+/**
+ * Returns true when the given WU number is within the width-exhaustion
+ * warning band (>= 90% of 10^width) but still below the width ceiling.
+ *
+ * Numbers that already exceed the width capacity return false so the
+ * warning only fires once, not on every subsequent overflow id.
+ */
+export function isWidthExhaustionWarning(num, config = {}) {
+    const { width } = validateWuIdConfig(config);
+    const capacity = Math.pow(10, width);
+    const threshold = capacity * 0.9;
+    return num >= threshold && num < capacity;
+}
+//# sourceMappingURL=wu-id-format.js.map

package/dist/wu-id-format.js.map

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

package/dist/wu-rename-projection.d.ts

@@ -0,0 +1,62 @@
+/// <reference path="./types.d.ts" />
+/**
+ * WU Rename Projection (WU-2552)
+ *
+ * Read-side helper that walks a wu-events log and returns a function
+ * resolving any original WU id to its current canonical id after zero
+ * or more `wu_renamed` events.
+ *
+ * Event sourcing discipline:
+ * - History is append-only. Historical events keep their original wuId.
+ * - This projection is the read-side resolution view, not a rewrite.
+ * - Rename chains are transitive: A -> B -> C means resolve(A) === 'C'.
+ *
+ * Consumers:
+ * - {@link ./wu-state-indexer.ts} applies events in rename-resolved order.
+ * - {@link ./backlog-generator.ts} displays current canonical ids only.
+ *
+ * @module wu-rename-projection
+ */
+import type { WUEvent } from './wu-state-schema.js';
+/** A single rename link recorded in the event log. */
+export interface RenameLink {
+    /** Original WU id (what it was called before the rename). */
+    from: string;
+    /** New WU id (what it is called after the rename). */
+    to: string;
+    /** Optional human reason supplied at wu:rename time. */
+    reason?: string;
+    /** ISO-8601 timestamp of the rename event. */
+    timestamp: string;
+}
+/** Result of building a rename projection from an event log. */
+export interface RenameProjection {
+    /**
+     * Resolve an original (possibly stale) WU id to its current canonical id.
+     * If the id is not part of any rename chain, it is returned unchanged.
+     */
+    resolve(wuId: string): string;
+    /** List every rename link discovered, in event-log order. */
+    getAllRenames(): RenameLink[];
+}
+/**
+ * Walk the event log and return a {@link RenameProjection}.
+ *
+ * Algorithm:
+ * 1. Iterate events in order. For each `wu_renamed` event, compose the link
+ *    into the transitive map. If an earlier rename produced `from`, update
+ *    its target to `to` so the chain collapses on lookup.
+ * 2. Store all raw rename links for audit/debugging via getAllRenames().
+ *
+ * The returned projection is pure; callers may retain it or throw it away.
+ */
+export declare function buildRenameProjection(events: readonly WUEvent[]): RenameProjection;
+/**
+ * Convenience wrapper: build a projection and resolve a single id.
+ *
+ * Use this when you only need one lookup. For multiple lookups against the
+ * same event log, call {@link buildRenameProjection} once and keep the
+ * projection.
+ */
+export declare function resolveRenamedWuId(events: readonly WUEvent[], wuId: string): string;
+//# sourceMappingURL=wu-rename-projection.d.ts.map

package/dist/wu-rename-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-rename-projection.d.ts","sourceRoot":"","sources":["../src/wu-rename-projection.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,sBAAsB,CAAC;AAGpE,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,aAAa,IAAI,UAAU,EAAE,CAAC;CAC/B;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,gBAAgB,CAwClF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnF"}

package/dist/wu-rename-projection.js

@@ -0,0 +1,66 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { WU_EVENT_TYPE } from './wu-state-schema.js';
+function isRenameEvent(event) {
+    return event.type === WU_EVENT_TYPE.WU_RENAMED;
+}
+/**
+ * Walk the event log and return a {@link RenameProjection}.
+ *
+ * Algorithm:
+ * 1. Iterate events in order. For each `wu_renamed` event, compose the link
+ *    into the transitive map. If an earlier rename produced `from`, update
+ *    its target to `to` so the chain collapses on lookup.
+ * 2. Store all raw rename links for audit/debugging via getAllRenames().
+ *
+ * The returned projection is pure; callers may retain it or throw it away.
+ */
+export function buildRenameProjection(events) {
+    // Direct map: original id -> current id after all observed renames.
+    const forward = new Map();
+    // Raw rename links in order.
+    const links = [];
+    for (const event of events) {
+        if (!isRenameEvent(event)) {
+            continue;
+        }
+        const { from, to } = event;
+        const link = {
+            from,
+            to,
+            timestamp: event.timestamp,
+            ...(typeof event.reason === 'string' && event.reason.length > 0
+                ? { reason: event.reason }
+                : {}),
+        };
+        links.push(link);
+        // Compose: any prior entry whose target equals `from` now targets `to`.
+        // This keeps resolve() O(1) without recursive lookup at query time.
+        for (const [key, value] of forward) {
+            if (value === from) {
+                forward.set(key, to);
+            }
+        }
+        // Record the link itself; if already present, the final target wins.
+        forward.set(from, to);
+    }
+    return {
+        resolve(wuId) {
+            return forward.get(wuId) ?? wuId;
+        },
+        getAllRenames() {
+            return [...links];
+        },
+    };
+}
+/**
+ * Convenience wrapper: build a projection and resolve a single id.
+ *
+ * Use this when you only need one lookup. For multiple lookups against the
+ * same event log, call {@link buildRenameProjection} once and keep the
+ * projection.
+ */
+export function resolveRenamedWuId(events, wuId) {
+    return buildRenameProjection(events).resolve(wuId);
+}
+//# sourceMappingURL=wu-rename-projection.js.map

package/dist/wu-rename-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-rename-projection.js","sourceRoot":"","sources":["../src/wu-rename-projection.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAsBzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAyBrD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,UAAU,CAAC;AACjD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA0B;IAC9D,oEAAoE;IACpE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,6BAA6B;IAC7B,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC;QAC3B,MAAM,IAAI,GAAe;YACvB,IAAI;YACJ,EAAE;YACF,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,CAAC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBAC7D,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;gBAC1B,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjB,wEAAwE;QACxE,oEAAoE;QACpE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACnC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,qEAAqE;QACrE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,OAAO;QACL,OAAO,CAAC,IAAY;YAClB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QACnC,CAAC;QACD,aAAa;YACX,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B,EAAE,IAAY;IACzE,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/wu-state-indexer.d.ts

@@ -13,15 +13,38 @@ export declare class WUStateIndexer {
     private byStatus;
     private byLane;
     private byParent;
+    /**
+     * Live rename map (WU-2552): original id -> current id after renames.
+     * Populated incrementally as wu_renamed events are applied.
+     * Used to route subsequent events referencing stale ids to their
+     * current canonical target.
+     */
+    private renameMap;
     constructor();
     /**
      * Clear all in-memory state and indexes.
      */
     clear(): void;
+    /**
+     * Resolve a (possibly stale) WU id to its current canonical id after
+     * any applied renames. Returns the input id unchanged when no rename
+     * chain maps it.
+     */
+    resolveRenamedWuId(wuId: string): string;
     /**
      * Apply an event to the in-memory state.
      */
     applyEvent(event: WUEvent): void;
+    /**
+     * Move WU state from an old id to a new id and record the rename link.
+     *
+     * - If no state exists under `from`, only the rename link is recorded
+     *   (handles the replay-only case where the CLI command appended an
+     *   event without having had an in-memory slot to move).
+     * - Any prior rename target that resolved to `from` is collapsed to `to`
+     *   so the live map stays flat.
+     */
+    private _applyRename;
     /**
      * Get current in-memory state for a WU.
      */

package/dist/wu-state-indexer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wu-state-indexer.d.ts","sourceRoot":"","sources":["../src/wu-state-indexer.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGjF,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAA2B;;IAS3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAuDhC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIlD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIxC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIpC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAI5C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,SAAS;CA+BlB"}
+{"version":3,"file":"wu-state-indexer.d.ts","sourceRoot":"","sources":["../src/wu-state-indexer.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGjF,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAA2B;IAC3C;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAAsB;;IAUvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAoEhC;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAmCpB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIlD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIxC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIpC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAI5C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,SAAS;CA+BlB"}

package/dist/wu-state-indexer.js

@@ -24,11 +24,19 @@ export class WUStateIndexer {
     byStatus;
     byLane;
     byParent;
+    /**
+     * Live rename map (WU-2552): original id -> current id after renames.
+     * Populated incrementally as wu_renamed events are applied.
+     * Used to route subsequent events referencing stale ids to their
+     * current canonical target.
+     */
+    renameMap;
     constructor() {
         this.wuState = new Map();
         this.byStatus = new Map();
         this.byLane = new Map();
         this.byParent = new Map();
+        this.renameMap = new Map();
     }
     /**
      * Clear all in-memory state and indexes.
@@ -38,12 +46,25 @@ export class WUStateIndexer {
         this.byStatus.clear();
         this.byLane.clear();
         this.byParent.clear();
+        this.renameMap.clear();
+    }
+    /**
+     * Resolve a (possibly stale) WU id to its current canonical id after
+     * any applied renames. Returns the input id unchanged when no rename
+     * chain maps it.
+     */
+    resolveRenamedWuId(wuId) {
+        return this.renameMap.get(wuId) ?? wuId;
     }
     /**
      * Apply an event to the in-memory state.
      */
     applyEvent(event) {
-        const { wuId, type } = event;
+        const { type } = event;
+        // WU-2552: Route every event's wuId through the live rename map so that
+        // historical events referencing ids that were later renamed land on the
+        // correct current-state slot.
+        const wuId = this.resolveRenamedWuId(event.wuId);
         if (type === WU_EVENT_TYPE.CREATE || type === WU_EVENT_TYPE.CLAIM) {
             // Discriminated union narrows to CreateEvent | ClaimEvent (both have lane/title)
             this._setState(wuId, WU_STATUS.IN_PROGRESS, event.lane, event.title);
@@ -77,7 +98,7 @@ export class WUStateIndexer {
         }
         if (type === WU_EVENT_TYPE.DELEGATION) {
             // Discriminated union narrows to DelegationEvent (has parentWuId)
-            const { parentWuId } = event;
+            const parentWuId = this.resolveRenamedWuId(event.parentWuId);
             if (!this.byParent.has(parentWuId)) {
                 this.byParent.set(parentWuId, new Set());
             }
@@ -87,6 +108,53 @@ export class WUStateIndexer {
         // WU-1080: Handle release event - transitions from in_progress to ready
         if (type === WU_EVENT_TYPE.RELEASE) {
             this._transitionToStatus(wuId, WU_STATUS.READY);
+            return;
+        }
+        // WU-2552: Handle wu_renamed event - move any existing state from
+        // `from` to `to` and record the rename in the live map so subsequent
+        // events referencing `from` land on `to`.
+        if (type === WU_EVENT_TYPE.WU_RENAMED) {
+            this._applyRename(event.from, event.to);
+        }
+    }
+    /**
+     * Move WU state from an old id to a new id and record the rename link.
+     *
+     * - If no state exists under `from`, only the rename link is recorded
+     *   (handles the replay-only case where the CLI command appended an
+     *   event without having had an in-memory slot to move).
+     * - Any prior rename target that resolved to `from` is collapsed to `to`
+     *   so the live map stays flat.
+     */
+    _applyRename(from, to) {
+        // Collapse prior chains: anything that targeted `from` now targets `to`.
+        for (const [key, value] of this.renameMap) {
+            if (value === from) {
+                this.renameMap.set(key, to);
+            }
+        }
+        this.renameMap.set(from, to);
+        const existing = this.wuState.get(from);
+        if (!existing) {
+            // Nothing to move; the live map update alone is sufficient.
+            return;
+        }
+        // Move the state entry and update indexes.
+        this.wuState.delete(from);
+        const statusSet = this.byStatus.get(existing.status);
+        statusSet?.delete(from);
+        const laneSet = this.byLane.get(existing.lane);
+        laneSet?.delete(from);
+        this._setState(to, existing.status, existing.lane, existing.title);
+        const moved = this.wuState.get(to);
+        if (moved && existing.completedAt) {
+            moved.completedAt = existing.completedAt;
+        }
+        if (moved && existing.lastCheckpoint) {
+            moved.lastCheckpoint = existing.lastCheckpoint;
+        }
+        if (moved && existing.lastCheckpointNote) {
+            moved.lastCheckpointNote = existing.lastCheckpointNote;
         }
     }
     /**

package/dist/wu-state-indexer.js.map

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

package/dist/wu-state-schema.d.ts

@@ -19,8 +19,9 @@ import { z } from 'zod';
  * - checkpoint: Progress checkpoint (WU-1748: cross-agent visibility)
  * - delegation: WU delegated from parent (WU-1947: parent-child relationships)
  * - release: WU released (WU-1080: transitions from in_progress to ready for orphan recovery)
+ * - wu_renamed: WU id canonicalized or normalized (WU-2552: append-only rename, never rewrites history)
  */
-export declare const WU_EVENT_TYPES: readonly ["create", "claim", "block", "unblock", "complete", "checkpoint", "delegation", "release"];
+export declare const WU_EVENT_TYPES: readonly ["create", "claim", "block", "unblock", "complete", "checkpoint", "delegation", "release", "wu_renamed"];
 /** Type for WU event types */
 export type WUEventType = (typeof WU_EVENT_TYPES)[number];
 /**
@@ -38,6 +39,7 @@ export declare const WU_EVENT_TYPE: Readonly<{
     CHECKPOINT: "checkpoint";
     DELEGATION: "delegation";
     RELEASE: "release";
+    WU_RENAMED: "wu_renamed";
 }>;
 /**
  * WU status values (matches LumenFlow state machine)
@@ -132,6 +134,28 @@ export declare const ReleaseEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"release">;
     reason: z.ZodString;
 }, z.core.$strip>;
+/**
+ * WU renamed event schema (WU-2552: canonical WU IDs)
+ *
+ * Records a WU id change without rewriting history. Historical events
+ * before the rename keep their original wuId field (audit trail intact).
+ * Projections use {@link buildRenameProjection} to resolve an original id
+ * to its current canonical id.
+ *
+ * Invariants:
+ * - `wuId` field mirrors `from` so filter-by-wuId still returns this event
+ *   for queries about the original id.
+ * - `from` and `to` accept any WU ID matching WU_PATTERNS.WU_ID, which is
+ *   intentionally permissive (matches both padded and unpadded legacy IDs).
+ */
+export declare const WURenamedEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"wu_renamed">;
+    from: z.ZodString;
+    to: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /**
  * Union schema for all event types
  */
@@ -179,6 +203,13 @@ export declare const WUEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     type: z.ZodLiteral<"release">;
     reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"wu_renamed">;
+    from: z.ZodString;
+    to: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;
 /**
  * TypeScript types inferred from schemas
@@ -191,6 +222,7 @@ export type CompleteEvent = z.infer<typeof CompleteEventSchema>;
 export type CheckpointEvent = z.infer<typeof CheckpointEventSchema>;
 export type DelegationEvent = z.infer<typeof DelegationEventSchema>;
 export type ReleaseEvent = z.infer<typeof ReleaseEventSchema>;
+export type WURenamedEvent = z.infer<typeof WURenamedEventSchema>;
 export type WUEvent = z.infer<typeof WUEventSchema>;
 /**
  * Validates WU event data against schema
@@ -250,5 +282,12 @@ export declare function validateWUEvent(data: unknown): z.ZodSafeParseResult<{
     timestamp: string;
     type: "release";
     reason: string;
+} | {
+    wuId: string;
+    timestamp: string;
+    type: "wu_renamed";
+    from: string;
+    to: string;
+    reason?: string | undefined;
 }>;
 //# sourceMappingURL=wu-state-schema.d.ts.map