@lumenflow/core 3.2.0 → 3.2.1

package/dist/domain/context.schemas.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Context Schemas
+ *
+ * WU-1093: INIT-002 Phase 1 - Define ports and domain schemas
+ *
+ * Zod schemas for context-related types in the context-aware validation system.
+ * Types are inferred from Zod schemas using z.infer<> for single source of truth.
+ *
+ * @module domain/context.schemas
+ */
+import { z } from 'zod';
+/**
+ * Location type enum values
+ *
+ * Mirrors CONTEXT_VALIDATION.LOCATION_TYPES from wu-constants.ts
+ */
+export declare const LOCATION_TYPE_VALUES: readonly ["main", "worktree", "detached", "unknown"];
+/**
+ * LocationType enum for use in code
+ *
+ * Provides named constants for location types to avoid magic string literals.
+ *
+ * @example
+ * import { LocationType } from '@lumenflow/core';
+ *
+ * if (location.type === LocationType.MAIN) {
+ *   // In main checkout
+ * }
+ */
+export declare const LocationType: {
+    /** Main checkout (not a worktree) */
+    readonly MAIN: "main";
+    /** Inside a worktree */
+    readonly WORKTREE: "worktree";
+    /** Detached HEAD state */
+    readonly DETACHED: "detached";
+    /** Unknown location (not a git repo or error) */
+    readonly UNKNOWN: "unknown";
+};
+/**
+ * Schema for location types
+ */
+export declare const LocationTypeSchema: z.ZodEnum<{
+    unknown: "unknown";
+    worktree: "worktree";
+    main: "main";
+    detached: "detached";
+}>;
+/**
+ * Schema for location context
+ *
+ * Captures where the command is being run from and related paths.
+ */
+export declare const LocationContextSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        unknown: "unknown";
+        worktree: "worktree";
+        main: "main";
+        detached: "detached";
+    }>;
+    cwd: z.ZodString;
+    gitRoot: z.ZodString;
+    mainCheckout: z.ZodString;
+    worktreeName: z.ZodNullable<z.ZodString>;
+    worktreeWuId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for git state
+ *
+ * Captures the current git state relevant to command execution.
+ */
+export declare const GitStateSchema: z.ZodObject<{
+    branch: z.ZodNullable<z.ZodString>;
+    isDetached: z.ZodBoolean;
+    isDirty: z.ZodBoolean;
+    hasStaged: z.ZodBoolean;
+    ahead: z.ZodNumber;
+    behind: z.ZodNumber;
+    tracking: z.ZodNullable<z.ZodString>;
+    modifiedFiles: z.ZodArray<z.ZodString>;
+    hasError: z.ZodBoolean;
+    errorMessage: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for WU state result
+ *
+ * Result of reading WU state from YAML and state store.
+ */
+export declare const WuStateResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodString;
+    lane: z.ZodString;
+    title: z.ZodString;
+    yamlPath: z.ZodString;
+    isConsistent: z.ZodBoolean;
+    inconsistencyReason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for session state
+ *
+ * Session state for active WU work.
+ */
+export declare const SessionStateSchema: z.ZodObject<{
+    isActive: z.ZodBoolean;
+    sessionId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for unified WU context
+ *
+ * Captures all environmental state relevant to command execution.
+ */
+export declare const WuContextSchema: z.ZodObject<{
+    location: z.ZodObject<{
+        type: z.ZodEnum<{
+            unknown: "unknown";
+            worktree: "worktree";
+            main: "main";
+            detached: "detached";
+        }>;
+        cwd: z.ZodString;
+        gitRoot: z.ZodString;
+        mainCheckout: z.ZodString;
+        worktreeName: z.ZodNullable<z.ZodString>;
+        worktreeWuId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    git: z.ZodObject<{
+        branch: z.ZodNullable<z.ZodString>;
+        isDetached: z.ZodBoolean;
+        isDirty: z.ZodBoolean;
+        hasStaged: z.ZodBoolean;
+        ahead: z.ZodNumber;
+        behind: z.ZodNumber;
+        tracking: z.ZodNullable<z.ZodString>;
+        modifiedFiles: z.ZodArray<z.ZodString>;
+        hasError: z.ZodBoolean;
+        errorMessage: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    wu: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodString;
+        lane: z.ZodString;
+        title: z.ZodString;
+        yamlPath: z.ZodString;
+        isConsistent: z.ZodBoolean;
+        inconsistencyReason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    session: z.ZodObject<{
+        isActive: z.ZodBoolean;
+        sessionId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    worktreeGit: z.ZodOptional<z.ZodObject<{
+        branch: z.ZodNullable<z.ZodString>;
+        isDetached: z.ZodBoolean;
+        isDirty: z.ZodBoolean;
+        hasStaged: z.ZodBoolean;
+        ahead: z.ZodNumber;
+        behind: z.ZodNumber;
+        tracking: z.ZodNullable<z.ZodString>;
+        modifiedFiles: z.ZodArray<z.ZodString>;
+        hasError: z.ZodBoolean;
+        errorMessage: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocationType = (typeof LocationType)[keyof typeof LocationType];
+export type LocationContext = z.infer<typeof LocationContextSchema>;
+export type GitState = z.infer<typeof GitStateSchema>;
+export type WuStateResult = z.infer<typeof WuStateResultSchema>;
+export type SessionState = z.infer<typeof SessionStateSchema>;
+export type WuContext = z.infer<typeof WuContextSchema>;
+//# sourceMappingURL=context.schemas.d.ts.map

package/dist/domain/context.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.schemas.d.ts","sourceRoot":"","sources":["../../src/domain/context.schemas.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,sDAAuD,CAAC;AAEzF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY;IACvB,qCAAqC;;IAErC,wBAAwB;;IAExB,0BAA0B;;IAE1B,iDAAiD;;CAEzC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;EAA+B,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAahC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;iBAqBzB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;iBAe9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;iBAK7B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqB1B,CAAC;AAIH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAC5E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/domain/context.schemas.js

@@ -0,0 +1,151 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Context Schemas
+ *
+ * WU-1093: INIT-002 Phase 1 - Define ports and domain schemas
+ *
+ * Zod schemas for context-related types in the context-aware validation system.
+ * Types are inferred from Zod schemas using z.infer<> for single source of truth.
+ *
+ * @module domain/context.schemas
+ */
+import { z } from 'zod';
+/**
+ * Location type enum values
+ *
+ * Mirrors CONTEXT_VALIDATION.LOCATION_TYPES from wu-constants.ts
+ */
+export const LOCATION_TYPE_VALUES = ['main', 'worktree', 'detached', 'unknown'];
+/**
+ * LocationType enum for use in code
+ *
+ * Provides named constants for location types to avoid magic string literals.
+ *
+ * @example
+ * import { LocationType } from '@lumenflow/core';
+ *
+ * if (location.type === LocationType.MAIN) {
+ *   // In main checkout
+ * }
+ */
+export const LocationType = {
+    /** Main checkout (not a worktree) */
+    MAIN: 'main',
+    /** Inside a worktree */
+    WORKTREE: 'worktree',
+    /** Detached HEAD state */
+    DETACHED: 'detached',
+    /** Unknown location (not a git repo or error) */
+    UNKNOWN: 'unknown',
+};
+/**
+ * Schema for location types
+ */
+export const LocationTypeSchema = z.enum(LOCATION_TYPE_VALUES);
+/**
+ * Schema for location context
+ *
+ * Captures where the command is being run from and related paths.
+ */
+export const LocationContextSchema = z.object({
+    /** Location type: 'main', 'worktree', 'detached', or 'unknown' */
+    type: LocationTypeSchema,
+    /** Absolute path to current working directory */
+    cwd: z.string(),
+    /** Absolute path to git root (top-level of working tree) */
+    gitRoot: z.string(),
+    /** Absolute path to main checkout (primary repo) */
+    mainCheckout: z.string(),
+    /** Worktree name if in a worktree (e.g., 'framework-core-wu-1090') */
+    worktreeName: z.string().nullable(),
+    /** WU ID extracted from worktree path (e.g., 'WU-1090') */
+    worktreeWuId: z.string().nullable(),
+});
+/**
+ * Schema for git state
+ *
+ * Captures the current git state relevant to command execution.
+ */
+export const GitStateSchema = z.object({
+    /** Current branch name (null if detached) */
+    branch: z.string().nullable(),
+    /** Whether HEAD is detached */
+    isDetached: z.boolean(),
+    /** Whether working tree has uncommitted changes */
+    isDirty: z.boolean(),
+    /** Whether there are staged changes */
+    hasStaged: z.boolean(),
+    /** Commits ahead of tracking branch */
+    ahead: z.number().int().min(0),
+    /** Commits behind tracking branch */
+    behind: z.number().int().min(0),
+    /** Tracking branch (e.g., 'origin/main') */
+    tracking: z.string().nullable(),
+    /** List of modified files */
+    modifiedFiles: z.array(z.string()),
+    /** Whether an error occurred reading state */
+    hasError: z.boolean(),
+    /** Error message if hasError is true */
+    errorMessage: z.string().nullable(),
+});
+/**
+ * Schema for WU state result
+ *
+ * Result of reading WU state from YAML and state store.
+ */
+export const WuStateResultSchema = z.object({
+    /** WU ID (uppercase, e.g., 'WU-1090') */
+    id: z.string(),
+    /** Current status from YAML */
+    status: z.string(),
+    /** Lane name */
+    lane: z.string(),
+    /** WU title */
+    title: z.string(),
+    /** Absolute path to WU YAML file */
+    yamlPath: z.string(),
+    /** Whether YAML and state store are consistent */
+    isConsistent: z.boolean(),
+    /** Reason for inconsistency if not consistent */
+    inconsistencyReason: z.string().nullable(),
+});
+/**
+ * Schema for session state
+ *
+ * Session state for active WU work.
+ */
+export const SessionStateSchema = z.object({
+    /** Whether a session is active */
+    isActive: z.boolean(),
+    /** Session ID if active */
+    sessionId: z.string().nullable(),
+});
+/**
+ * Schema for unified WU context
+ *
+ * Captures all environmental state relevant to command execution.
+ */
+export const WuContextSchema = z.object({
+    /** Location context (main vs worktree) */
+    location: LocationContextSchema,
+    /** Git state (branch, dirty, staged, ahead/behind) */
+    git: GitStateSchema,
+    /** WU state (null if no WU specified) */
+    wu: WuStateResultSchema.nullable(),
+    /** Session state */
+    session: SessionStateSchema,
+    /**
+     * Git state of the WU's worktree (WU-1092).
+     *
+     * When running wu:done from main checkout, we need to check the worktree's
+     * git state, not main's. This field is populated when:
+     * - Running from main checkout (location.type === 'main')
+     * - A WU is specified (wu !== null)
+     * - WU has an active worktree (status === 'in_progress')
+     *
+     * If undefined, predicates should fall back to checking `git.isDirty`.
+     */
+    worktreeGit: GitStateSchema.optional(),
+});
+//# sourceMappingURL=context.schemas.js.map

package/dist/domain/context.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.schemas.js","sourceRoot":"","sources":["../../src/domain/context.schemas.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAEzF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,qCAAqC;IACrC,IAAI,EAAE,MAAM;IACZ,wBAAwB;IACxB,QAAQ,EAAE,UAAU;IACpB,0BAA0B;IAC1B,QAAQ,EAAE,UAAU;IACpB,iDAAiD;IACjD,OAAO,EAAE,SAAS;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,kEAAkE;IAClE,IAAI,EAAE,kBAAkB;IACxB,iDAAiD;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,4DAA4D;IAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,oDAAoD;IACpD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,sEAAsE;IACtE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,2DAA2D;IAC3D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,6CAA6C;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,+BAA+B;IAC/B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,mDAAmD;IACnD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,uCAAuC;IACvC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,uCAAuC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,qCAAqC;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,6BAA6B;IAC7B,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,wCAAwC;IACxC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,yCAAyC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,+BAA+B;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,gBAAgB;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,eAAe;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,oCAAoC;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,kDAAkD;IAClD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,iDAAiD;IACjD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,kCAAkC;IAClC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,2BAA2B;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,0CAA0C;IAC1C,QAAQ,EAAE,qBAAqB;IAC/B,sDAAsD;IACtD,GAAG,EAAE,cAAc;IACnB,yCAAyC;IACzC,EAAE,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IAClC,oBAAoB;IACpB,OAAO,EAAE,kBAAkB;IAC3B;;;;;;;;;;OAUG;IACH,WAAW,EAAE,cAAc,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

package/dist/domain/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Domain Schemas Index
+ *
+ * WU-1093: INIT-002 Phase 1 - Define ports and domain schemas
+ *
+ * Re-exports all domain schemas and types for the context-aware validation system.
+ *
+ * @module domain
+ */
+export * from './context.schemas.js';
+export { VALIDATION_ERROR_CODE_VALUES, ValidationErrorCodeSchema, PREDICATE_SEVERITY_VALUES, PredicateSeveritySchema, ValidationErrorSchema, ValidationWarningSchema, ValidationResultSchema, CommandPredicateConfigSchema, CommandDefinitionConfigSchema, type ValidationErrorCode, type PredicateSeverity, type ValidationError, type ValidationWarning, type ValidationResult, type CommandPredicateConfig, type CommandDefinitionConfig, } from './validation.schemas.js';
+export * from './recovery.schemas.js';
+export * from './orchestration.schemas.js';
+export * from './orchestration.constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAIH,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAIjC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC"}

package/dist/domain/index.js

@@ -0,0 +1,23 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Domain Schemas Index
+ *
+ * WU-1093: INIT-002 Phase 1 - Define ports and domain schemas
+ *
+ * Re-exports all domain schemas and types for the context-aware validation system.
+ *
+ * @module domain
+ */
+// Context schemas (primary definitions for location, git, wu state)
+// Includes LocationType enum constant
+export * from './context.schemas.js';
+// Validation schemas (excludes re-exports from context.schemas)
+export { VALIDATION_ERROR_CODE_VALUES, ValidationErrorCodeSchema, PREDICATE_SEVERITY_VALUES, PredicateSeveritySchema, ValidationErrorSchema, ValidationWarningSchema, ValidationResultSchema, CommandPredicateConfigSchema, CommandDefinitionConfigSchema, } from './validation.schemas.js';
+// Recovery schemas
+// Includes RecoveryIssueCode and RecoveryActionType enum constants
+export * from './recovery.schemas.js';
+// Orchestration schemas (existing)
+export * from './orchestration.schemas.js';
+export * from './orchestration.constants.js';
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;GAQG;AAEH,oEAAoE;AACpE,sCAAsC;AACtC,cAAc,sBAAsB,CAAC;AAErC,gEAAgE;AAChE,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,GAQ9B,MAAM,yBAAyB,CAAC;AAEjC,mBAAmB;AACnB,mEAAmE;AACnE,cAAc,uBAAuB,CAAC;AAEtC,mCAAmC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC"}

package/dist/domain/orchestration.constants.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Total number of Definition of Done checkpoints.
+ * Used by dashboard to show DoD progress (X/11).
+ */
+export declare const DOD_TOTAL = 11;
+/**
+ * Valid lane names in the LumenFlow system.
+ * Used for type-safe lane validation.
+ *
+ * Note: This should match the lanes defined in workspace.yaml.
+ * These are LumenFlow framework lanes, not application-specific lanes.
+ */
+export declare const LANES: readonly ["Framework: Core", "Framework: CLI", "Framework: Memory", "Framework: Agent", "Framework: Metrics", "Framework: Initiatives", "Framework: Shims", "Operations: Infrastructure", "Operations: CI/CD", "Content: Documentation"];
+/** Type for valid lane names */
+export type Lane = (typeof LANES)[number];
+/**
+ * Known agent names in the orchestration system.
+ * Includes both mandatory (Tier 1) and suggested (Tier 2) agents.
+ *
+ * Note: These are LumenFlow framework agents defined in .claude/agents/.
+ * Application-specific agents should be configured separately.
+ */
+export declare const AGENT_NAMES: readonly ["general-purpose", "lumenflow-pm", "test-engineer", "code-reviewer", "bug-triage", "lumenflow-enforcer", "lumenflow-doc-sync"];
+/** Type for agent names */
+export type AgentName = (typeof AGENT_NAMES)[number];
+/**
+ * Alert severity levels for dashboard display.
+ * HIGH = action required immediately
+ * MEDIUM = action suggested
+ * LOW = informational
+ */
+export declare const SEVERITY_LEVELS: readonly ["high", "medium", "low"];
+/** Type for severity levels */
+export type SeverityLevel = (typeof SEVERITY_LEVELS)[number];
+/**
+ * Default timeline window for dashboard display (hours).
+ */
+export declare const TIMELINE_WINDOW_HOURS = 24;
+/**
+ * Maximum alerts to display in dashboard.
+ */
+export declare const MAX_ALERTS_DISPLAY = 10;
+/**
+ * Agent result statuses for WU progress tracking.
+ */
+export declare const AGENT_RESULT_STATUSES: readonly ["pending", "pass", "fail", "skipped"];
+/** Type for agent result statuses */
+export type AgentResultStatus = (typeof AGENT_RESULT_STATUSES)[number];
+/**
+ * Timeline event types for orchestration history.
+ */
+export declare const TIMELINE_EVENT_TYPES: readonly ["claim", "done", "block", "agent", "gates"];
+/** Type for timeline event types */
+export type TimelineEventType = (typeof TIMELINE_EVENT_TYPES)[number];
+/**
+ * Event severity levels for timeline display.
+ */
+export declare const EVENT_SEVERITY_LEVELS: readonly ["info", "warning", "error"];
+/** Type for event severity levels */
+export type EventSeverityLevel = (typeof EVENT_SEVERITY_LEVELS)[number];
+/**
+ * User choice options for execution plan confirmation.
+ */
+export declare const USER_CHOICE_OPTIONS: readonly ["approve", "reject", "edit"];
+/** Type for user choice options */
+export type UserChoiceOption = (typeof USER_CHOICE_OPTIONS)[number];
+/**
+ * Mandatory agent names (subset of AGENT_NAMES)
+ *
+ * Note: For LumenFlow framework development, mandatory agents are not currently
+ * enforced since this is a workflow framework, not an application with domain-specific concerns.
+ * Projects using LumenFlow can define their own mandatory agents in their config.
+ *
+ * The test-engineer and code-reviewer agents are suggested but not mandatory.
+ */
+export declare const MANDATORY_AGENT_NAMES: readonly [];
+/** Type for mandatory agent names */
+export type MandatoryAgentName = (typeof MANDATORY_AGENT_NAMES)[number];
+/**
+ * Mandatory agent triggers - glob patterns that indicate when agents must be invoked.
+ * Uses minimatch patterns (NOT regex) for file path matching.
+ *
+ * Note: For LumenFlow framework development, this is empty since we don't have
+ * application-specific concerns. Projects using LumenFlow
+ * should configure their own triggers based on their domain requirements.
+ *
+ * Example application-specific triggers (configure in your project):
+ * - security-auditor: supabase/migrations/**, auth/**, rls/**
+ * - llm-reviewer: prompts/**, llm/**
+ *
+ * Usage:
+ * ```typescript
+ * import { minimatch } from 'minimatch';
+ * const triggers = MANDATORY_TRIGGERS['my-agent'];
+ * const shouldTrigger = triggers?.some(pattern => minimatch(filePath, pattern));
+ * ```
+ */
+export declare const MANDATORY_TRIGGERS: Record<string, readonly string[]>;
+/**
+ * File system paths for metrics collection.
+ * Used by FileSystemMetricsCollector to avoid hardcoded strings.
+ */
+export declare const FILESYSTEM_PATHS: {
+    WU_DIR: string;
+    STATUS_FILE: string;
+    BACKLOG_FILE: string;
+    TELEMETRY_DIR: string;
+    STAMPS_DIR: string;
+    SESSION_FILE: string;
+};
+//# sourceMappingURL=orchestration.constants.d.ts.map

package/dist/domain/orchestration.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.constants.d.ts","sourceRoot":"","sources":["../../src/domain/orchestration.constants.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,0OAWR,CAAC;AAEX,gCAAgC;AAChC,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,0IAQd,CAAC;AAEX,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,oCAAqC,CAAC;AAElE,+BAA+B;AAC/B,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,qBAAqB,iDAAkD,CAAC;AAErF,qCAAqC;AACrC,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,oBAAoB,uDAAwD,CAAC;AAE1F,oCAAoC;AACpC,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,qBAAqB,uCAAwC,CAAC;AAE3E,qCAAqC;AACrC,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,mBAAmB,wCAAyC,CAAC;AAE1E,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,aAAc,CAAC;AAEjD,qCAAqC;AACrC,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAGhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAC"}

package/dist/domain/orchestration.constants.js

@@ -0,0 +1,130 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Orchestration Domain Constants
+ *
+ * Centralised constants for the agent orchestration dashboard.
+ * Avoids magic numbers and hardcoded strings throughout the orchestration layer.
+ *
+ * @module orchestration.constants
+ * @see {@link ../ports/dashboard-renderer.port.ts} - Uses these constants
+ * @see {@link ../ports/metrics-collector.port.ts} - Uses these constants
+ */
+import { DIRECTORIES, LUMENFLOW_PATHS } from '../wu-constants.js';
+/**
+ * Total number of Definition of Done checkpoints.
+ * Used by dashboard to show DoD progress (X/11).
+ */
+export const DOD_TOTAL = 11;
+/**
+ * Valid lane names in the LumenFlow system.
+ * Used for type-safe lane validation.
+ *
+ * Note: This should match the lanes defined in workspace.yaml.
+ * These are LumenFlow framework lanes, not application-specific lanes.
+ */
+export const LANES = [
+    'Framework: Core',
+    'Framework: CLI',
+    'Framework: Memory',
+    'Framework: Agent',
+    'Framework: Metrics',
+    'Framework: Initiatives',
+    'Framework: Shims',
+    'Operations: Infrastructure',
+    'Operations: CI/CD',
+    'Content: Documentation',
+];
+/**
+ * Known agent names in the orchestration system.
+ * Includes both mandatory (Tier 1) and suggested (Tier 2) agents.
+ *
+ * Note: These are LumenFlow framework agents defined in .claude/agents/.
+ * Application-specific agents should be configured separately.
+ */
+export const AGENT_NAMES = [
+    'general-purpose',
+    'lumenflow-pm',
+    'test-engineer',
+    'code-reviewer',
+    'bug-triage',
+    'lumenflow-enforcer',
+    'lumenflow-doc-sync',
+];
+/**
+ * Alert severity levels for dashboard display.
+ * HIGH = action required immediately
+ * MEDIUM = action suggested
+ * LOW = informational
+ */
+export const SEVERITY_LEVELS = ['high', 'medium', 'low'];
+/**
+ * Default timeline window for dashboard display (hours).
+ */
+export const TIMELINE_WINDOW_HOURS = 24;
+/**
+ * Maximum alerts to display in dashboard.
+ */
+export const MAX_ALERTS_DISPLAY = 10;
+/**
+ * Agent result statuses for WU progress tracking.
+ */
+export const AGENT_RESULT_STATUSES = ['pending', 'pass', 'fail', 'skipped'];
+/**
+ * Timeline event types for orchestration history.
+ */
+export const TIMELINE_EVENT_TYPES = ['claim', 'done', 'block', 'agent', 'gates'];
+/**
+ * Event severity levels for timeline display.
+ */
+export const EVENT_SEVERITY_LEVELS = ['info', 'warning', 'error'];
+/**
+ * User choice options for execution plan confirmation.
+ */
+export const USER_CHOICE_OPTIONS = ['approve', 'reject', 'edit'];
+/**
+ * Mandatory agent names (subset of AGENT_NAMES)
+ *
+ * Note: For LumenFlow framework development, mandatory agents are not currently
+ * enforced since this is a workflow framework, not an application with domain-specific concerns.
+ * Projects using LumenFlow can define their own mandatory agents in their config.
+ *
+ * The test-engineer and code-reviewer agents are suggested but not mandatory.
+ */
+export const MANDATORY_AGENT_NAMES = [];
+/**
+ * Mandatory agent triggers - glob patterns that indicate when agents must be invoked.
+ * Uses minimatch patterns (NOT regex) for file path matching.
+ *
+ * Note: For LumenFlow framework development, this is empty since we don't have
+ * application-specific concerns. Projects using LumenFlow
+ * should configure their own triggers based on their domain requirements.
+ *
+ * Example application-specific triggers (configure in your project):
+ * - security-auditor: supabase/migrations/**, auth/**, rls/**
+ * - llm-reviewer: prompts/**, llm/**
+ *
+ * Usage:
+ * ```typescript
+ * import { minimatch } from 'minimatch';
+ * const triggers = MANDATORY_TRIGGERS['my-agent'];
+ * const shouldTrigger = triggers?.some(pattern => minimatch(filePath, pattern));
+ * ```
+ */
+export const MANDATORY_TRIGGERS = {
+// No mandatory triggers for LumenFlow framework development.
+// Projects should configure their own triggers based on their domain.
+};
+/**
+ * File system paths for metrics collection.
+ * Used by FileSystemMetricsCollector to avoid hardcoded strings.
+ */
+export const FILESYSTEM_PATHS = {
+    WU_DIR: DIRECTORIES.WU_DIR,
+    STATUS_FILE: DIRECTORIES.STATUS_PATH,
+    BACKLOG_FILE: DIRECTORIES.BACKLOG_PATH,
+    TELEMETRY_DIR: LUMENFLOW_PATHS.TELEMETRY,
+    STAMPS_DIR: LUMENFLOW_PATHS.STAMPS_DIR,
+    SESSION_FILE: LUMENFLOW_PATHS.SESSION_CURRENT,
+};
+//# sourceMappingURL=orchestration.constants.js.map

package/dist/domain/orchestration.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.constants.js","sourceRoot":"","sources":["../../src/domain/orchestration.constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,iBAAiB;IACjB,gBAAgB;IAChB,mBAAmB;IACnB,kBAAkB;IAClB,oBAAoB;IACpB,wBAAwB;IACxB,kBAAkB;IAClB,4BAA4B;IAC5B,mBAAmB;IACnB,wBAAwB;CAChB,CAAC;AAKX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,eAAe;IACf,YAAY;IACZ,oBAAoB;IACpB,oBAAoB;CACZ,CAAC;AAKX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AAKlE;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAKrF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAK1F;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAK3E;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAK1E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAW,CAAC;AAKjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsC;AACnE,6DAA6D;AAC7D,sEAAsE;CACvE,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,WAAW,CAAC,MAAM;IAC1B,WAAW,EAAE,WAAW,CAAC,WAAW;IACpC,YAAY,EAAE,WAAW,CAAC,YAAY;IACtC,aAAa,EAAE,eAAe,CAAC,SAAS;IACxC,UAAU,EAAE,eAAe,CAAC,UAAU;IACtC,YAAY,EAAE,eAAe,CAAC,eAAe;CAC9C,CAAC"}