@lumenflow/core 3.1.3 → 3.2.1

package/dist/spawn-template-assembler.js

@@ -0,0 +1,111 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file spawn-template-assembler.ts
+ * WU-2012: Extracted from wu-spawn.ts
+ *
+ * Template loading, assembly, and context building for spawn prompts.
+ *
+ * Single responsibility: Load templates from .lumenflow/templates/ and
+ * assemble them for spawn prompts, with graceful fallback to hardcoded sections.
+ *
+ * @module spawn-template-assembler
+ */
+import { loadManifest, loadTemplatesWithOverrides, assembleTemplates, } from './template-loader.js';
+/**
+ * WU-1192: Truncation prevention constants (consolidated from CLI)
+ *
+ * These constants help detect when spawn output has been truncated during
+ * copy-paste operations or context loading. The warning banner alerts users
+ * to the truncation risk, and the end sentinel allows verification that
+ * the full output was received.
+ */
+export const TRUNCATION_WARNING_BANNER = `<!-- LUMENFLOW_TRUNCATION_WARNING -->
+<!--
+  \u26a0\ufe0f CRITICAL: DO NOT TRUNCATE THIS OUTPUT
+
+  This spawn prompt MUST be copied verbatim. Truncation causes:
+  - Missing constraints (agents ignore safety rules)
+  - Missing TDD directives (agents skip tests)
+  - Degraded agent performance
+
+  VERIFICATION: The output MUST end with: <!-- LUMENFLOW_SPAWN_END -->
+  If you don't see that sentinel at the end, the output was truncated.
+-->
+`;
+export const SPAWN_END_SENTINEL = '<!-- LUMENFLOW_SPAWN_END -->';
+/**
+ * WU-1253/WU-1291: Try to assemble spawn prompt sections from templates.
+ *
+ * This function loads templates from .lumenflow/templates/ and assembles
+ * them according to the manifest order. Client-specific overrides are
+ * supported via templates.{client}/ directories.
+ *
+ * **Decision (WU-1291)**: Template system is ACTIVATED. This function is called
+ * by generateTaskInvocation() and generateCodexPrompt() to attempt template-based
+ * generation. If it returns null (templates missing, manifest invalid, or assembly
+ * fails), callers fall back to hardcoded generator functions.
+ *
+ * @param baseDir - Project root directory
+ * @param clientName - Client name for overrides (e.g., 'claude', 'cursor')
+ * @param context - Context for token replacement and condition evaluation
+ * @returns Assembled template content, or null if templates unavailable
+ */
+export function tryAssembleSpawnTemplates(baseDir, clientName, context) {
+    try {
+        const manifest = loadManifest(baseDir);
+        const templates = loadTemplatesWithOverrides(baseDir, clientName);
+        if (templates.size === 0) {
+            return null;
+        }
+        return assembleTemplates(templates, manifest, context);
+    }
+    catch {
+        // Template loading failed - return null for hardcoded fallback (intentional)
+        return null;
+    }
+}
+/**
+ * Build template context from WU document.
+ *
+ * @param doc - WU YAML document
+ * @param id - WU ID
+ * @returns Context for template assembly
+ */
+export function buildTemplateContext(doc, id) {
+    const lane = doc.lane || '';
+    const laneParent = lane.split(':')[0]?.trim() || '';
+    return {
+        WU_ID: id,
+        LANE: lane,
+        TYPE: (doc.type || 'feature').toLowerCase(),
+        TITLE: doc.title || '',
+        DESCRIPTION: doc.description || '',
+        WORKTREE_PATH: doc.worktree_path || '',
+        laneParent,
+        // Add lowercase aliases for condition evaluation
+        type: (doc.type || 'feature').toLowerCase(),
+        lane,
+        worktreePath: doc.worktree_path || '',
+    };
+}
+/**
+ * WU-1261: Build template context with resolved policy fields.
+ *
+ * Extends buildTemplateContext() with policy.testing and policy.architecture
+ * fields for template condition evaluation.
+ *
+ * @param doc - WU YAML document
+ * @param id - WU ID
+ * @param policy - Resolved policy from resolvePolicy()
+ * @returns Context for template assembly with policy fields
+ */
+export function buildTemplateContextWithPolicy(doc, id, policy) {
+    const baseContext = buildTemplateContext(doc, id);
+    return {
+        ...baseContext,
+        'policy.testing': policy.testing,
+        'policy.architecture': policy.architecture,
+    };
+}
+//# sourceMappingURL=spawn-template-assembler.js.map

package/dist/spawn-template-assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-template-assembler.js","sourceRoot":"","sources":["../src/spawn-template-assembler.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;GAUG;AAEH,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,iBAAiB,GAElB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;CAYxC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,UAAkB,EAClB,OAAwB;IAExB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,0BAA0B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAElE,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAA4B,EAAE,EAAU;IAC3E,MAAM,IAAI,GAAI,GAAG,CAAC,IAAe,IAAI,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEpD,OAAO;QACL,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,CAAE,GAAG,CAAC,IAAe,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE;QACvD,KAAK,EAAG,GAAG,CAAC,KAAgB,IAAI,EAAE;QAClC,WAAW,EAAG,GAAG,CAAC,WAAsB,IAAI,EAAE;QAC9C,aAAa,EAAG,GAAG,CAAC,aAAwB,IAAI,EAAE;QAClD,UAAU;QACV,iDAAiD;QACjD,IAAI,EAAE,CAAE,GAAG,CAAC,IAAe,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE;QACvD,IAAI;QACJ,YAAY,EAAG,GAAG,CAAC,aAAwB,IAAI,EAAE;KAClD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC5C,GAA4B,EAC5B,EAAU,EACV,MAAsB;IAEtB,MAAM,WAAW,GAAG,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAElD,OAAO;QACL,GAAG,WAAW;QACd,gBAAgB,EAAE,MAAM,CAAC,OAAO;QAChC,qBAAqB,EAAE,MAAM,CAAC,YAAY;KAC3C,CAAC;AACJ,CAAC"}

package/dist/stamp-status-validator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * List of parent-only lanes that are deprecated (legacy).
+ * WUs with these lanes are considered legacy artifacts and may have stamp-status mismatches.
+ * Modern WUs should use sub-lanes like "Operations: Tooling".
+ *
+ * @type {readonly string[]}
+ */
+export declare const LEGACY_PARENT_ONLY_LANES: readonly string[];
+/**
+ * Check if a lane is a deprecated parent-only lane (no sub-lane specified).
+ *
+ * @param {string|null|undefined} lane - The lane to check
+ * @returns {boolean} True if the lane is a parent-only legacy lane
+ *
+ * @example
+ * isLegacyParentOnlyLane('Intelligence') // true
+ * isLegacyParentOnlyLane('Operations: Tooling') // false
+ */
+export declare function isLegacyParentOnlyLane(lane: UnsafeAny): boolean;
+/**
+ * Check if a WU is a legacy artifact with stamp-status mismatch.
+ *
+ * A legacy stamped WU is one that:
+ * - Has a .done stamp file
+ * - Has a status that is NOT 'done'
+ *
+ * These WUs are historical artifacts from before validation was strict,
+ * and should be exempted from the stamp-status consistency check.
+ *
+ * @param {object} wu - The parsed WU YAML object
+ * @param {string} wu.id - WU ID (e.g., 'WU-100')
+ * @param {string} wu.status - WU status (e.g., 'done', 'cancelled', 'ready')
+ * @param {Set<string>} stampedIds - Set of WU IDs that have .done stamp files
+ * @returns {boolean} True if this is a legacy stamped WU with mismatch
+ *
+ * @example
+ * const stampedIds = new Set(['WU-100', 'WU-101']);
+ * isLegacyStampedWU({ id: 'WU-100', status: 'cancelled' }, stampedIds) // true
+ * isLegacyStampedWU({ id: 'WU-100', status: 'done' }, stampedIds) // false (no mismatch)
+ * isLegacyStampedWU({ id: 'WU-999', status: 'cancelled' }, stampedIds) // false (no stamp)
+ */
+export declare function isLegacyStampedWU(wu: UnsafeAny, stampedIds: UnsafeAny): boolean;
+/**
+ * Check if a WU ID is exempted from stamp-status validation via config.
+ *
+ * The workspace.yaml can specify exemptions for known historical
+ * artifacts that cannot be fixed (e.g., WU-307, WU-311, WU-1152).
+ *
+ * @param {string} id - WU ID to check
+ * @param {string[]|null|undefined} exemptions - List of exempted WU IDs from config
+ * @returns {boolean} True if the WU is exempted
+ *
+ * @example
+ * isExemptedFromStampStatusCheck('WU-307', ['WU-307', 'WU-311']) // true
+ * isExemptedFromStampStatusCheck('WU-999', ['WU-307', 'WU-311']) // false
+ */
+export declare function isExemptedFromStampStatusCheck(id: UnsafeAny, exemptions: UnsafeAny): boolean;
+/**
+ * Determine if a WU should be exempted from stamp-status validation.
+ *
+ * A WU is exempted if:
+ * 1. It's explicitly listed in the config exemptions, OR
+ * 2. It's a legacy stamped WU (has stamp but status != done) AND has a legacy parent-only lane
+ *
+ * @param {object} wu - The parsed WU YAML object
+ * @param {Set<string>} stampedIds - Set of WU IDs that have .done stamp files
+ * @param {string[]} exemptions - List of exempted WU IDs from config
+ * @returns {{ exempted: boolean, reason: string|null }} Whether exempted and why
+ */
+export declare function shouldExemptFromStampStatusCheck(wu: UnsafeAny, stampedIds: UnsafeAny, exemptions?: never[]): {
+    exempted: boolean;
+    reason: string;
+} | {
+    exempted: boolean;
+    reason: null;
+};
+//# sourceMappingURL=stamp-status-validator.d.ts.map

package/dist/stamp-status-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-status-validator.d.ts","sourceRoot":"","sources":["../src/stamp-status-validator.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,mBAMnC,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,WAUrD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,WAwBrE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,WAMlF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,SAAS,EACrB,UAAU,UAAK;;;;;;EAkBhB"}

package/dist/stamp-status-validator.js

@@ -0,0 +1,138 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @fileoverview Stamp-status validation utilities
+ *
+ * WU-1781: Provides utilities to detect and handle legacy WUs with stamp-status mismatches.
+ *
+ * The problem: WUs with .done stamps but non-done status (e.g., cancelled, ready) cause
+ * wu:validate to fail, which blocks husky pre-push and prevents wu:done from completing.
+ *
+ * The solution: Detect these legacy artifacts and exempt them from validation to prevent
+ * deadlocks, while still enforcing validation on new/active WUs.
+ */
+import { WU_STATUS } from './wu-constants.js';
+/**
+ * List of parent-only lanes that are deprecated (legacy).
+ * WUs with these lanes are considered legacy artifacts and may have stamp-status mismatches.
+ * Modern WUs should use sub-lanes like "Operations: Tooling".
+ *
+ * @type {readonly string[]}
+ */
+export const LEGACY_PARENT_ONLY_LANES = Object.freeze([
+    'Intelligence',
+    'Core Systems',
+    'Operations',
+    'Experience',
+    'Discovery',
+]);
+/**
+ * Check if a lane is a deprecated parent-only lane (no sub-lane specified).
+ *
+ * @param {string|null|undefined} lane - The lane to check
+ * @returns {boolean} True if the lane is a parent-only legacy lane
+ *
+ * @example
+ * isLegacyParentOnlyLane('Intelligence') // true
+ * isLegacyParentOnlyLane('Operations: Tooling') // false
+ */
+export function isLegacyParentOnlyLane(lane) {
+    if (!lane || typeof lane !== 'string') {
+        return false;
+    }
+    const normalizedLane = lane.trim();
+    // Check if it's an exact match to a parent-only lane (case-insensitive)
+    const lowerLane = normalizedLane.toLowerCase();
+    return LEGACY_PARENT_ONLY_LANES.some((parentLane) => parentLane.toLowerCase() === lowerLane);
+}
+/**
+ * Check if a WU is a legacy artifact with stamp-status mismatch.
+ *
+ * A legacy stamped WU is one that:
+ * - Has a .done stamp file
+ * - Has a status that is NOT 'done'
+ *
+ * These WUs are historical artifacts from before validation was strict,
+ * and should be exempted from the stamp-status consistency check.
+ *
+ * @param {object} wu - The parsed WU YAML object
+ * @param {string} wu.id - WU ID (e.g., 'WU-100')
+ * @param {string} wu.status - WU status (e.g., 'done', 'cancelled', 'ready')
+ * @param {Set<string>} stampedIds - Set of WU IDs that have .done stamp files
+ * @returns {boolean} True if this is a legacy stamped WU with mismatch
+ *
+ * @example
+ * const stampedIds = new Set(['WU-100', 'WU-101']);
+ * isLegacyStampedWU({ id: 'WU-100', status: 'cancelled' }, stampedIds) // true
+ * isLegacyStampedWU({ id: 'WU-100', status: 'done' }, stampedIds) // false (no mismatch)
+ * isLegacyStampedWU({ id: 'WU-999', status: 'cancelled' }, stampedIds) // false (no stamp)
+ */
+export function isLegacyStampedWU(wu, stampedIds) {
+    if (!wu || !wu.id || !stampedIds) {
+        return false;
+    }
+    // Must have a stamp
+    const hasStamp = stampedIds.has(wu.id);
+    if (!hasStamp) {
+        return false;
+    }
+    // Must have a status that is NOT done
+    const status = wu.status;
+    if (!status || typeof status !== 'string') {
+        return false;
+    }
+    // If status is 'done', this is a normal WU (no mismatch)
+    if (status.toLowerCase() === WU_STATUS.DONE) {
+        return false;
+    }
+    // Has stamp + status != done = legacy mismatch
+    return true;
+}
+/**
+ * Check if a WU ID is exempted from stamp-status validation via config.
+ *
+ * The workspace.yaml can specify exemptions for known historical
+ * artifacts that cannot be fixed (e.g., WU-307, WU-311, WU-1152).
+ *
+ * @param {string} id - WU ID to check
+ * @param {string[]|null|undefined} exemptions - List of exempted WU IDs from config
+ * @returns {boolean} True if the WU is exempted
+ *
+ * @example
+ * isExemptedFromStampStatusCheck('WU-307', ['WU-307', 'WU-311']) // true
+ * isExemptedFromStampStatusCheck('WU-999', ['WU-307', 'WU-311']) // false
+ */
+export function isExemptedFromStampStatusCheck(id, exemptions) {
+    if (!id || !exemptions || !Array.isArray(exemptions)) {
+        return false;
+    }
+    return exemptions.includes(id);
+}
+/**
+ * Determine if a WU should be exempted from stamp-status validation.
+ *
+ * A WU is exempted if:
+ * 1. It's explicitly listed in the config exemptions, OR
+ * 2. It's a legacy stamped WU (has stamp but status != done) AND has a legacy parent-only lane
+ *
+ * @param {object} wu - The parsed WU YAML object
+ * @param {Set<string>} stampedIds - Set of WU IDs that have .done stamp files
+ * @param {string[]} exemptions - List of exempted WU IDs from config
+ * @returns {{ exempted: boolean, reason: string|null }} Whether exempted and why
+ */
+export function shouldExemptFromStampStatusCheck(wu, stampedIds, exemptions = []) {
+    const id = wu?.id;
+    // Check config exemption first
+    if (isExemptedFromStampStatusCheck(id, exemptions)) {
+        return { exempted: true, reason: 'config exemption' };
+    }
+    // Check if it's a legacy stamped WU with a legacy lane
+    if (isLegacyStampedWU(wu, stampedIds)) {
+        const lane = wu.lane;
+        if (isLegacyParentOnlyLane(lane)) {
+            return { exempted: true, reason: 'legacy parent-only lane with stamp' };
+        }
+    }
+    return { exempted: false, reason: null };
+}
+//# sourceMappingURL=stamp-status-validator.js.map

package/dist/stamp-status-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-status-validator.js","sourceRoot":"","sources":["../src/stamp-status-validator.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,cAAc;IACd,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,WAAW;CACZ,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAe;IACpD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAEnC,wEAAwE;IACxE,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAa,EAAE,UAAqB;IACpE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sCAAsC;IACtC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;IACzB,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yDAAyD;IACzD,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+CAA+C;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,8BAA8B,CAAC,EAAa,EAAE,UAAqB;IACjF,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gCAAgC,CAC9C,EAAa,EACb,UAAqB,EACrB,UAAU,GAAG,EAAE;IAEf,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IAElB,+BAA+B;IAC/B,IAAI,8BAA8B,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACxD,CAAC;IAED,uDAAuD;IACvD,IAAI,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC;QACrB,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC"}

package/dist/stamp-tracking.d.ts

@@ -0,0 +1,12 @@
+interface TrackedStampOptions {
+    projectRoot: string;
+    stampsDir: string;
+    gitRaw?: (args: string[]) => Promise<string>;
+}
+/**
+ * Return tracked WU stamp IDs from git index.
+ * Returns null when git query is unavailable so callers can safely fall back.
+ */
+export declare function listTrackedWUStampIds({ projectRoot, stampsDir, gitRaw, }: TrackedStampOptions): Promise<Set<string> | null>;
+export {};
+//# sourceMappingURL=stamp-tracking.d.ts.map

package/dist/stamp-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-tracking.d.ts","sourceRoot":"","sources":["../src/stamp-tracking.ts"],"names":[],"mappings":"AAMA,UAAU,mBAAmB;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAeD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,WAAW,EACX,SAAS,EACT,MAAM,GACP,EAAE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAmBnD"}

package/dist/stamp-tracking.js

@@ -0,0 +1,43 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import path from 'node:path';
+import { createGitForPath } from './git-adapter.js';
+function toPosixPath(value) {
+    return value.split(path.sep).join('/');
+}
+function stampIdFromFilePath(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    const fileName = path.posix.basename(normalized);
+    if (!fileName.startsWith('WU-') || !fileName.endsWith('.done')) {
+        return null;
+    }
+    return fileName.slice(0, -'.done'.length);
+}
+/**
+ * Return tracked WU stamp IDs from git index.
+ * Returns null when git query is unavailable so callers can safely fall back.
+ */
+export async function listTrackedWUStampIds({ projectRoot, stampsDir, gitRaw, }) {
+    try {
+        const raw = gitRaw ?? ((args) => createGitForPath(projectRoot).raw(args));
+        const stampsDirRelative = path.isAbsolute(stampsDir)
+            ? path.relative(projectRoot, stampsDir)
+            : stampsDir;
+        const pathspec = `${toPosixPath(stampsDirRelative)}/WU-*.done`;
+        const output = await raw(['ls-files', '--', pathspec]);
+        const tracked = new Set();
+        for (const line of output.split('\n')) {
+            const value = line.trim();
+            if (!value)
+                continue;
+            const id = stampIdFromFilePath(value);
+            if (id)
+                tracked.add(id);
+        }
+        return tracked;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=stamp-tracking.js.map

package/dist/stamp-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-tracking.js","sourceRoot":"","sources":["../src/stamp-tracking.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQpD,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,WAAW,EACX,SAAS,EACT,MAAM,GACc;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,IAAc,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACpF,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;YACvC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,QAAQ,GAAG,GAAG,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC;QAC/D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,MAAM,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,EAAE;gBAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/stamp-utils.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Stamp format error types (WU-2242)
+ * @readonly
+ * @enum {string}
+ */
+export declare const STAMP_FORMAT_ERRORS: Readonly<{
+    /** Stamp file is empty or contains only whitespace */
+    EMPTY_FILE: "EMPTY_FILE";
+    /** Missing WU identifier line (format: WU WU-123 (em dash) Title) */
+    MISSING_WU_LINE: "MISSING_WU_LINE";
+    /** Missing Completed: YYYY-MM-DD line */
+    MISSING_COMPLETED_LINE: "MISSING_COMPLETED_LINE";
+    /** Date is not in valid YYYY-MM-DD format or is invalid */
+    INVALID_DATE_FORMAT: "INVALID_DATE_FORMAT";
+    /** WU ID in stamp does not match expected ID */
+    WU_ID_MISMATCH: "WU_ID_MISMATCH";
+}>;
+/**
+ * Validate that a date string is a valid ISO date (YYYY-MM-DD)
+ *
+ * WU-1006: Uses date-fns parse() and isValid() instead of manual parseInt parsing
+ * Library-First principle: leverage well-known libraries over brittle custom code
+ *
+ * @param {string} dateStr - Date string in YYYY-MM-DD format
+ * @returns {boolean} True if date is valid
+ */
+export declare function isValidDateString(dateStr: string): boolean;
+interface CreateStampParams {
+    id: string;
+    title: string;
+}
+interface CreateStampResult {
+    created: boolean;
+    path: string;
+    reason?: 'already_exists';
+}
+/**
+ * Create stamp file (idempotent - safe to call multiple times)
+ *
+ * @param {object} params - Parameters
+ * @param {string} params.id - WU ID (e.g., 'WU-123')
+ * @param {string} params.title - WU title
+ * @returns {object} Result { created: boolean, path: string, reason?: string }
+ */
+export declare function createStamp({ id, title }: CreateStampParams): CreateStampResult;
+/**
+ * Validate stamp exists
+ *
+ * @param {string} stampPath - Path to stamp file
+ * @returns {boolean} True if stamp exists
+ */
+export declare function validateStamp(stampPath: string): boolean;
+/**
+ * Get stamp path using WU_PATHS (consistent with codebase)
+ *
+ * @param {string} id - WU ID
+ * @returns {string} Absolute path to stamp file
+ */
+export declare function getStampPath(id: string): string;
+/**
+ * Validate stamp file format (WU-2242)
+ *
+ * Expected format:
+ * ```
+ * WU WU-123 (em dash) Title here
+ * Completed: 2025-12-31
+ * ```
+ *
+ * @param {string} wuId - WU ID (e.g., 'WU-123')
+ * @param {string} [projectRoot=process.cwd()] - Project root directory
+ * @returns {Promise<{valid: boolean, errors: string[], missing?: boolean}>}
+ */
+export declare function validateStampFormat(wuId: string, projectRoot?: string): Promise<{
+    valid: boolean;
+    errors: string[];
+    missing?: boolean;
+}>;
+/**
+ * Parsed stamp metadata
+ */
+interface StampMetadata {
+    wuId?: string;
+    title?: string;
+    completedDate?: string;
+}
+/**
+ * Parse stamp content to extract metadata
+ *
+ * @param {string} content - Stamp file content
+ * @returns {StampMetadata}
+ */
+export declare function parseStampContent(content: string): StampMetadata;
+export {};
+//# sourceMappingURL=stamp-utils.d.ts.map

package/dist/stamp-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-utils.d.ts","sourceRoot":"","sources":["../src/stamp-utils.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;IAC9B,sDAAsD;;IAEtD,qEAAqE;;IAErE,yCAAyC;;IAEzC,2DAA2D;;IAE3D,gDAAgD;;EAEhD,CAAC;AAQH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU1D;AAYD,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,iBAAiB,GAAG,iBAAiB,CAmB/E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AA0DD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,WAAW,SAAgB,GAC1B,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAwClE;AAED;;GAEG;AACH,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAiChE"}