@lumenflow/packs-software-delivery 4.24.0 → 5.0.0

package/dist/src/constants/wu-statuses.d.ts

@@ -0,0 +1,209 @@
+/**
+ * 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;
+};
+/**
+ * Canonical internal mapping for supported WU types.
+ *
+ * Exported consumers should import WU_TYPES/WU_TYPE_VALUES rather than relying
+ * on this internal literal object directly. Keeping this object literal-local
+ * lets us preserve the exact union for type derivation while widening the
+ * public WU_TYPES surface for backwards-compatible downstream consumers.
+ */
+declare const WU_TYPE_VALUE_BY_KEY: {
+    readonly FEATURE: "feature";
+    readonly BUG: "bug";
+    readonly DOCUMENTATION: "documentation";
+    readonly PROCESS: "process";
+    readonly TOOLING: "tooling";
+    readonly CHORE: "chore";
+    readonly REFACTOR: "refactor";
+};
+export type WUType = (typeof WU_TYPE_VALUE_BY_KEY)[keyof typeof WU_TYPE_VALUE_BY_KEY];
+export type WUTypeKey = keyof typeof WU_TYPE_VALUE_BY_KEY;
+/**
+ * WU type values
+ *
+ * WU-1281: Centralized from hardcoded strings in validators.
+ * Exposed as a widened record so existing consumers can treat individual
+ * entries as generic WUType values instead of overly narrow literals.
+ */
+export declare const WU_TYPES: Record<WUTypeKey, WUType>;
+/**
+ * Canonical WU type values in their intended display/help order.
+ *
+ * Consumers should iterate this array instead of retyping WU types.
+ */
+export declare const WU_TYPE_VALUES: readonly ["feature", "bug", "documentation", "process", "tooling", "chore", "refactor"];
+/**
+ * Canonical WU type metadata for help surfaces and validation consumers.
+ */
+export declare const WU_TYPE_DEFINITIONS: readonly [{
+    readonly key: "FEATURE";
+    readonly value: WUType;
+    readonly description: "Net-new user or system capability";
+}, {
+    readonly key: "BUG";
+    readonly value: WUType;
+    readonly description: "Broken or regressed behavior fix";
+}, {
+    readonly key: "DOCUMENTATION";
+    readonly value: WUType;
+    readonly description: "Documentation-only change";
+}, {
+    readonly key: "PROCESS";
+    readonly value: WUType;
+    readonly description: "Workflow or operating-process maintenance";
+}, {
+    readonly key: "TOOLING";
+    readonly value: WUType;
+    readonly description: "Tooling, automation, or developer-experience change";
+}, {
+    readonly key: "CHORE";
+    readonly value: WUType;
+    readonly description: "Repository upkeep or housekeeping change";
+}, {
+    readonly key: "REFACTOR";
+    readonly value: WUType;
+    readonly description: "Behavior-preserving code restructure";
+}];
+export type WUTypeDefinition = (typeof WU_TYPE_DEFINITIONS)[number];
+/**
+ * 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;
+};
+export {};
+//# sourceMappingURL=wu-statuses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wu-statuses.d.ts","sourceRoot":"","sources":["../../../src/constants/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;;;;;;;GAOG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;CAQhB,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AACtF,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAE9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,yFAQW,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwC7B,CAAC;AAEJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;;;;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/src/constants/wu-statuses.js

@@ -0,0 +1,245 @@
+// 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',
+};
+/**
+ * Canonical internal mapping for supported WU types.
+ *
+ * Exported consumers should import WU_TYPES/WU_TYPE_VALUES rather than relying
+ * on this internal literal object directly. Keeping this object literal-local
+ * lets us preserve the exact union for type derivation while widening the
+ * public WU_TYPES surface for backwards-compatible downstream consumers.
+ */
+const WU_TYPE_VALUE_BY_KEY = {
+    FEATURE: 'feature',
+    BUG: 'bug',
+    DOCUMENTATION: 'documentation',
+    PROCESS: 'process',
+    TOOLING: 'tooling',
+    CHORE: 'chore',
+    REFACTOR: 'refactor',
+};
+/**
+ * WU type values
+ *
+ * WU-1281: Centralized from hardcoded strings in validators.
+ * Exposed as a widened record so existing consumers can treat individual
+ * entries as generic WUType values instead of overly narrow literals.
+ */
+export const WU_TYPES = {
+    ...WU_TYPE_VALUE_BY_KEY,
+};
+/**
+ * Canonical WU type values in their intended display/help order.
+ *
+ * Consumers should iterate this array instead of retyping WU types.
+ */
+export const WU_TYPE_VALUES = [
+    WU_TYPE_VALUE_BY_KEY.FEATURE,
+    WU_TYPE_VALUE_BY_KEY.BUG,
+    WU_TYPE_VALUE_BY_KEY.DOCUMENTATION,
+    WU_TYPE_VALUE_BY_KEY.PROCESS,
+    WU_TYPE_VALUE_BY_KEY.TOOLING,
+    WU_TYPE_VALUE_BY_KEY.CHORE,
+    WU_TYPE_VALUE_BY_KEY.REFACTOR,
+];
+/**
+ * Canonical WU type metadata for help surfaces and validation consumers.
+ */
+export const WU_TYPE_DEFINITIONS = [
+    {
+        key: 'FEATURE',
+        value: WU_TYPES.FEATURE,
+        description: 'Net-new user or system capability',
+    },
+    {
+        key: 'BUG',
+        value: WU_TYPES.BUG,
+        description: 'Broken or regressed behavior fix',
+    },
+    {
+        key: 'DOCUMENTATION',
+        value: WU_TYPES.DOCUMENTATION,
+        description: 'Documentation-only change',
+    },
+    {
+        key: 'PROCESS',
+        value: WU_TYPES.PROCESS,
+        description: 'Workflow or operating-process maintenance',
+    },
+    {
+        key: 'TOOLING',
+        value: WU_TYPES.TOOLING,
+        description: 'Tooling, automation, or developer-experience change',
+    },
+    {
+        key: 'CHORE',
+        value: WU_TYPES.CHORE,
+        description: 'Repository upkeep or housekeeping change',
+    },
+    {
+        key: 'REFACTOR',
+        value: WU_TYPES.REFACTOR,
+        description: 'Behavior-preserving code restructure',
+    },
+];
+/**
+ * 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/src/constants/wu-statuses.js.map

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

package/dist/src/constants/wu-type-helpers.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * WU type/test helper predicates (WU-1444)
+ *
+ * Purpose: avoid duplicating policy via string literals across CLI/MCP.
+ */
+import { type WUType } from './wu-statuses.js';
+export declare function isWUType(type: unknown): type is WUType;
+export declare function isDocumentationType(type: unknown): boolean;
+export declare function isProcessType(type: unknown): boolean;
+export declare function isDocsOrProcessType(type: unknown): boolean;
+export type TestsLike = {
+    manual?: unknown;
+    unit?: unknown;
+    e2e?: unknown;
+    integration?: unknown;
+} | undefined;
+/**
+ * True when UnsafeAny supported test array has at least one item.
+ * Supports the canonical tests object shape from WU YAML.
+ */
+export declare function hasAnyTests(tests: TestsLike): boolean;
+/**
+ * True when tests.manual has at least one item.
+ * Used for early lifecycle enforcement where manual verification is mandatory.
+ */
+export declare function hasManualTests(tests: TestsLike): boolean;
+//# sourceMappingURL=wu-type-helpers.d.ts.map

package/dist/src/constants/wu-type-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-type-helpers.d.ts","sourceRoot":"","sources":["../../../src/constants/wu-type-helpers.ts"],"names":[],"mappings":";AAGA;;;;GAIG;AAEH,OAAO,EAAwC,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQrF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED,MAAM,MAAM,SAAS,GACjB;IACE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACD,SAAS,CAAC;AAEd;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAUrD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAIxD"}

package/dist/src/constants/wu-type-helpers.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU type/test helper predicates (WU-1444)
+ *
+ * Purpose: avoid duplicating policy via string literals across CLI/MCP.
+ */
+import { TEST_TYPES, WU_TYPES, WU_TYPE_VALUES } from './wu-statuses.js';
+function isNonEmptyArray(value) {
+    return Array.isArray(value) && value.length > 0;
+}
+const WU_TYPE_SET = new Set(WU_TYPE_VALUES);
+export function isWUType(type) {
+    return typeof type === 'string' && WU_TYPE_SET.has(type);
+}
+export function isDocumentationType(type) {
+    return typeof type === 'string' && type === WU_TYPES.DOCUMENTATION;
+}
+export function isProcessType(type) {
+    return typeof type === 'string' && type === WU_TYPES.PROCESS;
+}
+export function isDocsOrProcessType(type) {
+    return isDocumentationType(type) || isProcessType(type);
+}
+/**
+ * True when UnsafeAny supported test array has at least one item.
+ * Supports the canonical tests object shape from WU YAML.
+ */
+export function hasAnyTests(tests) {
+    if (!tests || typeof tests !== 'object')
+        return false;
+    const t = tests;
+    return (isNonEmptyArray(t[TEST_TYPES.MANUAL]) ||
+        isNonEmptyArray(t[TEST_TYPES.UNIT]) ||
+        isNonEmptyArray(t[TEST_TYPES.E2E]) ||
+        isNonEmptyArray(t[TEST_TYPES.INTEGRATION]));
+}
+/**
+ * True when tests.manual has at least one item.
+ * Used for early lifecycle enforcement where manual verification is mandatory.
+ */
+export function hasManualTests(tests) {
+    if (!tests || typeof tests !== 'object')
+        return false;
+    const t = tests;
+    return isNonEmptyArray(t[TEST_TYPES.MANUAL]);
+}
+//# sourceMappingURL=wu-type-helpers.js.map

package/dist/src/constants/wu-type-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-type-helpers.js","sourceRoot":"","sources":["../../../src/constants/wu-type-helpers.ts"],"names":[],"mappings":";AACA,iCAAiC;AACjC,yCAAyC;AACzC;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AAErF,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;AAEpD,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,CAAC,aAAa,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAWD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAClC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/C,CAAC"}