@lumenflow/cli 5.5.0 → 5.7.14

package/packs/software-delivery/src/constants/wu-statuses.ts

@@ -1,287 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-
-/**
- * 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',
-};
-
-export type WUStatus = (typeof WU_STATUS)[keyof typeof WU_STATUS];
-
-/**
- * Display-only fallback labels for non-canonical status values.
- */
-export const WU_STATUS_FALLBACK = {
-  UNKNOWN: 'unknown',
-} as const;
-
-export type WUStatusDisplay =
-  | WUStatus
-  | (typeof WU_STATUS_FALLBACK)[keyof typeof WU_STATUS_FALLBACK];
-
-const WU_STATUS_SET = new Set<string>(Object.values(WU_STATUS));
-
-/**
- * Type guard for canonical WU statuses.
- */
-export function isWUStatus(value: unknown): value is WUStatus {
-  return typeof value === 'string' && WU_STATUS_SET.has(value);
-}
-
-/**
- * Resolve arbitrary status values to canonical WU statuses.
- */
-export function resolveWUStatus(value: unknown, fallback: WUStatus = WU_STATUS.READY): WUStatus {
-  return isWUStatus(value) ? value : fallback;
-}
-
-/**
- * Resolve status values for logs/UI where unknown is an allowed display state.
- */
-export function getWUStatusDisplay(value: unknown): WUStatusDisplay {
-  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: readonly string[] = [
-  WU_STATUS.IN_PROGRESS,
-  WU_STATUS.BLOCKED,
-] as const;
-
-/**
- * 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: readonly string[] = [WU_STATUS.IN_PROGRESS] as const;
-
-/**
- * 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',
-} as const;
-
-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 const WU_TYPES: Record<WUTypeKey, WUType> = {
-  ...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,
-] as const satisfies readonly WUType[];
-
-/**
- * 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',
-  },
-] as const satisfies readonly {
-  key: WUTypeKey;
-  value: WUType;
-  description: string;
-}[];
-
-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 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',
-} as const;
-
-/**
- * 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'] as const;
-
-/**
- * Test type keys
- *
- * WU-1281: Centralized from hardcoded keys in validators
- */
-export const TEST_TYPES = {
-  UNIT: 'unit',
-  E2E: 'e2e',
-  MANUAL: 'manual',
-  INTEGRATION: 'integration',
-};

package/packs/software-delivery/src/constants/wu-type-helpers.ts

@@ -1,67 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-/**
- * 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, type WUType } from './wu-statuses.js';
-
-function isNonEmptyArray(value: unknown): value is unknown[] {
-  return Array.isArray(value) && value.length > 0;
-}
-
-const WU_TYPE_SET = new Set<string>(WU_TYPE_VALUES);
-
-export function isWUType(type: unknown): type is WUType {
-  return typeof type === 'string' && WU_TYPE_SET.has(type);
-}
-
-export function isDocumentationType(type: unknown): boolean {
-  return typeof type === 'string' && type === WU_TYPES.DOCUMENTATION;
-}
-
-export function isProcessType(type: unknown): boolean {
-  return typeof type === 'string' && type === WU_TYPES.PROCESS;
-}
-
-export function isDocsOrProcessType(type: unknown): boolean {
-  return isDocumentationType(type) || isProcessType(type);
-}
-
-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 function hasAnyTests(tests: TestsLike): boolean {
-  if (!tests || typeof tests !== 'object') return false;
-
-  const t = tests as Record<string, unknown>;
-  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: TestsLike): boolean {
-  if (!tests || typeof tests !== 'object') return false;
-  const t = tests as Record<string, unknown>;
-  return isNonEmptyArray(t[TEST_TYPES.MANUAL]);
-}

package/packs/software-delivery/src/constants/wu-ui-constants.ts

@@ -1,267 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-
-/**
- * UI and Display Constants
- *
- * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
- * Contains backlog sections, status sections, log prefixes, emoji, box drawing,
- * display limits, string literals, YAML options, and readiness UI.
- *
- * @module wu-ui-constants
- */
-
-/**
- * Backlog section headings (with emojis)
- *
- * These match the frontmatter config in backlog.md
- */
-export const BACKLOG_SECTIONS = {
-  READY: '## 🚀 Ready (pull from here)',
-  IN_PROGRESS: '## 🔧 In progress',
-  BLOCKED: '## ⛔ Blocked',
-  DONE: '## ✅ Done',
-};
-
-/**
- * Backlog bullet format types (WU-1444)
- *
- * Used by BacklogManager to format list items in each section.
- * Each format produces a different markdown bullet style.
- */
-export const BACKLOG_BULLET_FORMAT = {
-  /** Ready format: '- [ ] [WU-ID -- Title](link)' */
-  READY: 'ready',
-  /** Progress format: '- [WU-ID -- Title](link)' */
-  PROGRESS: 'progress',
-  /** Blocked format: '- [ ] [WU-ID -- Title](link) -- Reason' */
-  BLOCKED: 'blocked',
-  /** Done format: '- [x] [WU-ID -- Title](link) (YYYY-MM-DD)' */
-  DONE: 'done',
-};
-
-/**
- * Status.md section headings (simpler format)
- */
-export const STATUS_SECTIONS = {
-  IN_PROGRESS: '## In Progress',
-  BLOCKED: '## Blocked',
-  COMPLETED: '## Completed',
-};
-
-/**
- * Log prefixes for wu- scripts
- *
- * Consistent prefixes for console output
- */
-export const LOG_PREFIX = {
-  DONE: '[wu-done]',
-  CLAIM: '[wu-claim]',
-  CREATE: '[wu:create]',
-  EDIT: '[wu:edit]',
-  DELETE: '[wu:delete]',
-  BLOCK: '[wu-block]',
-  UNBLOCK: '[wu-unblock]',
-  UNLOCK_LANE: '[wu-unlock-lane]',
-  CLEANUP: '[wu-cleanup]',
-  PRUNE: '[wu-prune]',
-  REPAIR: '[wu:repair]',
-  CONSISTENCY: '[wu-consistency]',
-  PREFLIGHT: '[wu-preflight]',
-  INITIATIVE_PLAN: '[initiative:plan]',
-  PLAN_CREATE: '[plan:create]',
-  PLAN_LINK: '[plan:link]',
-  PLAN_EDIT: '[plan:edit]',
-  PLAN_PROMOTE: '[plan:promote]',
-  ESCALATE: '[wu:escalate]',
-};
-
-/**
- * Emoji constants for consistent console output
- *
- * WU-1281: Centralized from hardcoded emojis across wu-* scripts
- */
-export const EMOJI = {
-  SUCCESS: '✅',
-  FAILURE: '❌',
-  WARNING: '⚠️',
-  INFO: 'ℹ️',
-  BLOCKED: '⛔',
-  ROCKET: '🚀',
-  WRENCH: '🔧',
-  TARGET: '🎯',
-  MEMO: '📝',
-  FOLDER: '📍',
-};
-
-/**
- * Box drawing characters for console output
- *
- * Emergency fix (Session 2): Centralized to eliminate sonarjs/no-duplicate-string errors
- * Used for recovery dialogs and error boxes in wu-* scripts
- */
-export const BOX = {
-  /** Top border: ╔══...══╗ (66 chars inside + corners = 68 total) */
-  TOP: '╔══════════════════════════════════════════════════════════════════╗',
-
-  /** Middle separator: ╠══...══╣ */
-  MID: '╠══════════════════════════════════════════════════════════════════╣',
-
-  /** Bottom border: ╚══...══╝ */
-  BOT: '╚══════════════════════════════════════════════════════════════════╝',
-
-  /** Side border for content lines */
-  SIDE: '║',
-};
-
-/**
- * UI display constants
- *
- * WU-1281: Centralized from hardcoded values in wu-done.ts
- */
-export const UI = {
-  /** Width for error/info boxes in console output */
-  ERROR_BOX_WIDTH: 70,
-
-  /** Number of lines to show in status file preview */
-  STATUS_PREVIEW_LINES: 5,
-};
-
-/**
- * Display limits for CLI output (WU-1068)
- *
- * Centralized limits for truncating display strings to avoid magic numbers.
- */
-export const DISPLAY_LIMITS = {
-  /** Maximum items to show in lists before truncating */
-  LIST_ITEMS: 5,
-  /** Maximum items to show in short lists */
-  SHORT_LIST: 3,
-  /** Maximum characters for content preview */
-  CONTENT_PREVIEW: 200,
-  /** Maximum characters for short preview */
-  SHORT_PREVIEW: 60,
-  /** Maximum characters for title display */
-  TITLE: 50,
-  /** Maximum characters for truncated title */
-  TRUNCATED_TITLE: 40,
-  /** Maximum characters for command preview */
-  CMD_PREVIEW: 60,
-  /** Maximum lines to preview from files */
-  FILE_LINES: 10,
-  /** Maximum commits to show in lists */
-  COMMITS: 50,
-  /** Maximum overlaps to display */
-  OVERLAPS: 3,
-};
-
-/**
- * YAML serialization options
- *
- * Centralized from duplicated { lineWidth: 100 } across wu-* scripts (WU-1256).
- * Use with yaml stringify() options.
- */
-export const YAML_OPTIONS = {
-  /** Standard line width for YAML dump (100 chars) */
-  LINE_WIDTH: 100,
-
-  /** No line wrapping (-1 disables wrapping) */
-  NO_WRAP: -1,
-};
-
-/**
- * Process argv indices (WU-1068)
- *
- * Centralized indices for process.argv access to eliminate magic numbers.
- * In Node.js: argv[0] = node, argv[1] = script, argv[2+] = args
- */
-export const ARGV_INDICES = {
-  /** Node executable path */
-  NODE: 0,
-  /** Script path */
-  SCRIPT: 1,
-  /** First user argument */
-  FIRST_ARG: 2,
-  /** Second user argument */
-  SECOND_ARG: 3,
-};
-
-/**
- * String formatting constants
- *
- * Centralized string literals for consistent formatting across scripts.
- * Eliminates hardcoded '\n', ' ', etc. throughout the codebase.
- */
-export const STRING_LITERALS = {
-  /** Newline character */
-  NEWLINE: '\n',
-
-  /** Double newline (paragraph separator) */
-  DOUBLE_NEWLINE: '\n\n',
-
-  /** Space character */
-  SPACE: ' ',
-
-  /** Empty string */
-  EMPTY: '',
-
-  /** Tab character */
-  TAB: '\t',
-
-  /** Comma separator */
-  COMMA: ',',
-
-  /** Colon separator */
-  COLON: ':',
-
-  /** Dash/hyphen */
-  DASH: '-',
-
-  /** Forward slash */
-  SLASH: '/',
-};
-
-/**
- * Readiness summary UI constants (WU-1620)
- *
- * Constants for the readiness summary box displayed after wu:create and wu:edit.
- * Provides visual feedback on whether WU is ready for wu:claim.
- *
- * @see tools/wu-create.ts - displayReadinessSummary()
- * @see tools/wu-edit.ts - displayReadinessSummary()
- */
-export const READINESS_UI = {
-  /** Box width (inner content area) */
-  BOX_WIDTH: 50,
-
-  /** Box drawing characters */
-  BOX: {
-    TOP_LEFT: '┌',
-    TOP_RIGHT: '┐',
-    BOTTOM_LEFT: '└',
-    BOTTOM_RIGHT: '┘',
-    HORIZONTAL: '─',
-    VERTICAL: '│',
-  },
-
-  /** Status messages */
-  MESSAGES: {
-    READY_YES: '✅ Ready to claim: YES',
-    READY_NO: '⚠️  Ready to claim: NO',
-    MISSING_HEADER: 'Missing:',
-    BULLET: '•',
-  },
-
-  /** Error truncation length */
-  ERROR_MAX_LENGTH: 46,
-  ERROR_TRUNCATE_LENGTH: 43,
-  TRUNCATION_SUFFIX: '...',
-
-  /** Padding calculations (relative to BOX_WIDTH) */
-  PADDING: {
-    READY_YES: 27, // 50 - len("... Ready to claim: YES") - 1
-    READY_NO: 28, // 50 - len("...  Ready to claim: NO") - 1
-    MISSING_HEADER: 41, // 50 - len("Missing:") - 1
-    ERROR_BULLET: 45, // 50 - len("  ... ") - 1
-  },
-};

package/packs/software-delivery/src/constants/wu-validation-constants.ts

@@ -1,73 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-
-/**
- * WU Validation Constants (WU-1243)
- *
- * Centralizes magic numbers for lane inference and incident validation.
- * Extracted from lane-inference.ts and agent-incidents.ts for DRY compliance.
- *
- * @module wu-validation-constants
- */
-
-/**
- * Lane inference scoring weights.
- * Code path matches are weighted higher than keywords because
- * file paths are more reliable signals for lane classification.
- *
- * The 10:3 ratio (~3.3x) reflects that a code path match is approximately
- * 3x more indicative of the correct lane than a keyword match.
- */
-export const WEIGHTS = {
-  /** Weight for code path pattern matches (more reliable signal) */
-  CODE_PATH_MATCH: 10,
-  /** Weight for keyword matches in description (less specific signal) */
-  KEYWORD_MATCH: 3,
-};
-
-/**
- * Confidence score configuration for lane inference.
- *
- * WU-2438: Changed from percentage-based (0-100) to absolute scoring.
- * Raw scores (sum of WEIGHTS) are now returned directly.
- * Higher score = better match, regardless of config size.
- */
-export const CONFIDENCE = {
-  /** Minimum confidence value (no matches) */
-  MIN: 0,
-  /** Maximum confidence value (legacy, kept for backward compatibility) */
-  MAX: 100,
-  /**
-   * Minimum confidence threshold to return a suggestion.
-   * Set to 0 to always return best match (even low confidence).
-   * Note: With absolute scoring, this threshold is compared against raw scores.
-   */
-  THRESHOLD: 0,
-};
-
-/**
- * String length validation limits for incident logging.
- * Prevents abuse while allowing meaningful content.
- */
-export const VALIDATION_LIMITS = {
-  /** Minimum title length (prevents truncated/empty titles) */
-  TITLE_MIN: 5,
-  /** Maximum title length (keeps logs readable) */
-  TITLE_MAX: 100,
-  /** Minimum description length (prevents one-liners) */
-  DESCRIPTION_MIN: 10,
-  /** Maximum description length (prevents unbounded logging) */
-  DESCRIPTION_MAX: 2000,
-};
-
-/**
- * Valid incident categories for agent issue logging.
- * Duplicated from agent-incidents.ts z.enum for use in default arrays.
- */
-export const INCIDENT_CATEGORIES = [
-  'workflow',
-  'tooling',
-  'confusion',
-  'violation',
-  'error',
-] as const;

package/packs/software-delivery/src/domain/index.ts

@@ -1,5 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-export * from './orchestration.types.js';
-export * from './orchestration.schemas.js';
-export * from './orchestration.constants.js';