@lumenflow/packs-software-delivery 4.23.0 → 5.0.0

package/dist/src/domain/orchestration.schemas.js

@@ -0,0 +1,214 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Orchestration Domain Schemas
+ *
+ * Zod schemas for runtime validation of orchestration domain types.
+ * Single source of truth - types are inferred from these schemas.
+ *
+ * @module orchestration.schemas
+ * @see {@link ./orchestration.types.ts} - Types inferred from these schemas
+ * @see {@link ./orchestration.constants.ts} - Constants used in validation
+ */
+import { z } from 'zod';
+import { LANES, AGENT_NAMES, SEVERITY_LEVELS, AGENT_RESULT_STATUSES, TIMELINE_EVENT_TYPES, EVENT_SEVERITY_LEVELS, USER_CHOICE_OPTIONS, DOD_TOTAL, } from './orchestration.constants.js';
+/**
+ * Schema for the longest running WU information.
+ */
+const LongestRunningSchema = z.object({
+    wuId: z.string().min(1),
+    lane: z.enum(LANES),
+    durationMs: z.number().nonnegative(),
+});
+/**
+ * Schema for pending mandatory agent information.
+ */
+const PendingMandatorySchema = z.object({
+    wuId: z.string().min(1),
+    agent: z.enum(AGENT_NAMES),
+});
+/**
+ * Schema for active agent session (WU-1438).
+ */
+const ActiveSessionSchema = z.object({
+    sessionId: z.string().uuid(),
+    wuId: z.string().min(1),
+    started: z.string().datetime(),
+    contextTier: z.union([z.literal(1), z.literal(2), z.literal(3)]),
+    incidentsLogged: z.number().int().nonnegative(),
+});
+/**
+ * Schema for worktree with uncommitted changes (WU-1748).
+ * Used for cross-agent visibility of abandoned WU work.
+ */
+const WorktreeWithUncommittedChangesSchema = z.object({
+    /** WU ID extracted from worktree branch name */
+    wuId: z.string().min(1),
+    /** Worktree directory path */
+    worktreePath: z.string().min(1),
+    /** Number of uncommitted files */
+    uncommittedFileCount: z.number().int().nonnegative(),
+    /** Last git activity timestamp (ISO 8601) */
+    lastActivityTimestamp: z.string(),
+});
+/**
+ * Schema for global orchestration status.
+ * Shows high-level dashboard metrics at a glance.
+ */
+export const GlobalStatusSchema = z.object({
+    /** Number of WUs currently in progress */
+    activeWUs: z.number().int().nonnegative(),
+    /** Number of WUs completed in the last 24 hours */
+    completed24h: z.number().int().nonnegative(),
+    /** Number of currently blocked WUs */
+    blocked: z.number().int().nonnegative(),
+    /** Number of WUs with failing gates */
+    gatesFailing: z.number().int().nonnegative(),
+    /** Information about the longest running WU, or null if none active */
+    longestRunning: LongestRunningSchema.nullable(),
+    /** List of WUs with pending mandatory agents */
+    pendingMandatory: z.array(PendingMandatorySchema),
+    /** Current active agent session, or null if none (WU-1438) */
+    activeSession: ActiveSessionSchema.nullable(),
+    /** Worktrees with uncommitted changes for cross-agent visibility (WU-1748) */
+    worktreesWithUncommittedChanges: z.array(WorktreeWithUncommittedChangesSchema),
+});
+/**
+ * Schema for last run information within agent metrics.
+ */
+const LastRunSchema = z.object({
+    wuId: z.string().min(1),
+    timestamp: z.string().datetime(),
+    result: z.enum(['pass', 'fail']),
+});
+/**
+ * Schema for per-agent metrics.
+ * Tracks invocation counts, pass rates, and timing.
+ */
+export const AgentMetricSchema = z.object({
+    /** Total number of times this agent has been invoked */
+    invoked: z.number().int().nonnegative(),
+    /** Pass rate as percentage (0-100) */
+    passRate: z.number().min(0).max(100),
+    /** Average duration in milliseconds */
+    avgDurationMs: z.number().nonnegative(),
+    /** Information about the most recent run, or null if never run */
+    lastRun: LastRunSchema.nullable(),
+});
+/**
+ * Schema for WU progress tracking.
+ * Shows DoD progress and agent status per WU.
+ */
+export const WUProgressSchema = z.object({
+    /** Work Unit ID (e.g., "WU-1234") */
+    wuId: z.string().min(1),
+    /** Lane the WU is assigned to */
+    lane: z.enum(LANES),
+    /** Human-readable title of the WU */
+    title: z.string().min(1),
+    /** Current DoD checkpoint progress (0 to DOD_TOTAL) */
+    dodProgress: z.number().int().min(0).max(DOD_TOTAL),
+    /** Total DoD checkpoints (always DOD_TOTAL) */
+    dodTotal: z.literal(DOD_TOTAL),
+    /** Status of each agent that has been or should be run */
+    agents: z.record(z.string(), z.enum(AGENT_RESULT_STATUSES)),
+    /** Tufte-style headline sentence describing current state */
+    headline: z.string(),
+});
+/**
+ * Schema for timeline events.
+ * Records orchestration history for dashboard display.
+ */
+export const TimelineEventSchema = z.object({
+    /** ISO 8601 timestamp of the event */
+    timestamp: z.string().datetime(),
+    /** Type of orchestration event */
+    event: z.enum(TIMELINE_EVENT_TYPES),
+    /** Associated Work Unit ID */
+    wuId: z.string().min(1),
+    /** Human-readable event description */
+    detail: z.string(),
+    /** Visual severity for display */
+    severity: z.enum(EVENT_SEVERITY_LEVELS),
+});
+/**
+ * Schema for dashboard alerts.
+ * Highlights items requiring attention.
+ */
+export const AlertSchema = z.object({
+    /** Alert severity level */
+    severity: z.enum(SEVERITY_LEVELS),
+    /** Human-readable alert message */
+    message: z.string().min(1),
+    /** Associated Work Unit ID */
+    wuId: z.string().min(1),
+    /** Suggested action or command */
+    action: z.string().min(1),
+});
+/**
+ * Schema for orchestration suggestions.
+ * Recommendations for next actions.
+ */
+export const SuggestionSchema = z.object({
+    /** Unique suggestion identifier */
+    id: z.string().min(1),
+    /** Suggestion priority level */
+    priority: z.enum(SEVERITY_LEVELS),
+    /** Short action description */
+    action: z.string().min(1),
+    /** Reason for the suggestion */
+    reason: z.string().min(1),
+    /** CLI command to execute the suggestion */
+    command: z.string().min(1),
+});
+/**
+ * Schema for execution plan steps.
+ */
+const ExecutionStepSchema = z.object({
+    /** Execution order (1-based) */
+    order: z.number().int().positive(),
+    /** Agent to run (if applicable) */
+    agent: z.string().optional(),
+    /** Action to perform (if not an agent) */
+    action: z.string().optional(),
+    /** Step execution status */
+    status: z.enum(AGENT_RESULT_STATUSES),
+});
+/**
+ * Schema for execution plans.
+ * Proposed sequence of orchestration actions.
+ */
+export const ExecutionPlanSchema = z.object({
+    /** Work Unit ID this plan is for */
+    wuId: z.string().min(1),
+    /** Ordered list of steps to execute */
+    steps: z.array(ExecutionStepSchema),
+    /** Estimated token cost for the full plan */
+    estimatedTokens: z.number().int().nonnegative(),
+});
+/**
+ * Schema for user choices on execution plans.
+ */
+export const UserChoiceSchema = z.object({
+    /** User's choice */
+    choice: z.enum(USER_CHOICE_OPTIONS),
+    /** Modifications if choice is 'edit' */
+    modifications: z.array(z.string()).optional(),
+});
+/**
+ * Schema for complete dashboard data.
+ * Aggregates all data needed for dashboard rendering.
+ */
+export const DashboardDataSchema = z.object({
+    /** Global status metrics */
+    globalStatus: GlobalStatusSchema,
+    /** Per-agent metrics keyed by agent name */
+    agentMetrics: z.record(z.string(), AgentMetricSchema),
+    /** Progress for all active WUs */
+    wuProgress: z.array(WUProgressSchema),
+    /** Recent timeline events */
+    timeline: z.array(TimelineEventSchema),
+    /** Current alerts */
+    alerts: z.array(AlertSchema),
+});
+//# sourceMappingURL=orchestration.schemas.js.map

package/dist/src/domain/orchestration.schemas.js.map

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

package/dist/src/domain/orchestration.types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Orchestration Domain Types
+ *
+ * TypeScript types inferred from Zod schemas.
+ * Single source of truth - schemas validate at runtime, types at compile time.
+ *
+ * @module orchestration.types
+ * @see {@link ./orchestration.schemas.ts} - Schemas these types are inferred from
+ * @see {@link ./orchestration.constants.ts} - Constants and derived types
+ */
+import type { z } from 'zod';
+import type { GlobalStatusSchema, AgentMetricSchema, WUProgressSchema, TimelineEventSchema, AlertSchema, SuggestionSchema, ExecutionPlanSchema, UserChoiceSchema, DashboardDataSchema } from './orchestration.schemas.js';
+export type { Lane, AgentName, SeverityLevel, AgentResultStatus, TimelineEventType, EventSeverityLevel, UserChoiceOption, MandatoryAgentName, } from './orchestration.constants.js';
+export { LANES, AGENT_NAMES, SEVERITY_LEVELS, AGENT_RESULT_STATUSES, TIMELINE_EVENT_TYPES, EVENT_SEVERITY_LEVELS, USER_CHOICE_OPTIONS, MANDATORY_AGENT_NAMES, } from './orchestration.constants.js';
+/**
+ * Global orchestration status.
+ * Shows high-level dashboard metrics at a glance.
+ *
+ * @example
+ * const status: GlobalStatus = {
+ *   activeWUs: 2,
+ *   completed24h: 5,
+ *   blocked: 1,
+ *   gatesFailing: 0,
+ *   longestRunning: { wuId: 'WU-1234', lane: 'Intelligence', durationMs: 2700000 },
+ *   pendingMandatory: [{ wuId: 'WU-1235', agent: 'security-auditor' }],
+ * };
+ */
+export type GlobalStatus = z.infer<typeof GlobalStatusSchema>;
+/**
+ * Per-agent metrics for dashboard display.
+ * Tracks invocation counts, pass rates, and timing.
+ *
+ * @example
+ * const metric: AgentMetric = {
+ *   invoked: 3,
+ *   passRate: 100,
+ *   avgDurationMs: 120000,
+ *   lastRun: { wuId: 'WU-1234', timestamp: '2025-01-15T10:00:00Z', result: 'pass' },
+ * };
+ */
+export type AgentMetric = z.infer<typeof AgentMetricSchema>;
+/**
+ * Work Unit progress for dashboard display.
+ * Shows DoD progress and agent status per WU.
+ *
+ * @example
+ * const progress: WUProgress = {
+ *   wuId: 'WU-1234',
+ *   lane: 'Intelligence',
+ *   title: 'LLM Classification Feature',
+ *   dodProgress: 8,
+ *   dodTotal: 11,
+ *   agents: { 'llm-reviewer': 'pass', 'code-reviewer': 'pending' },
+ *   headline: 'Blocked on code-reviewer - awaiting approval',
+ * };
+ */
+export type WUProgress = z.infer<typeof WUProgressSchema>;
+/**
+ * Timeline event for orchestration history.
+ * Records key events for dashboard display.
+ *
+ * @example
+ * const event: TimelineEvent = {
+ *   timestamp: '2025-01-15T09:00:00Z',
+ *   event: 'claim',
+ *   wuId: 'WU-1234',
+ *   detail: 'Claimed for Intelligence lane',
+ *   severity: 'info',
+ * };
+ */
+export type TimelineEvent = z.infer<typeof TimelineEventSchema>;
+/**
+ * Dashboard alert for items requiring attention.
+ *
+ * @example
+ * const alert: Alert = {
+ *   severity: 'high',
+ *   message: 'Mandatory agent not yet invoked',
+ *   wuId: 'WU-1235',
+ *   action: 'Run security-auditor before wu:done',
+ * };
+ */
+export type Alert = z.infer<typeof AlertSchema>;
+/**
+ * Orchestration suggestion for next actions.
+ *
+ * @example
+ * const suggestion: Suggestion = {
+ *   id: 'sug-001',
+ *   priority: 'high',
+ *   action: 'Run security-auditor',
+ *   reason: 'WU touches auth paths',
+ *   command: 'pnpm orchestrate:run security-auditor',
+ * };
+ */
+export type Suggestion = z.infer<typeof SuggestionSchema>;
+/**
+ * Execution plan for proposed orchestration actions.
+ *
+ * @example
+ * const plan: ExecutionPlan = {
+ *   wuId: 'WU-1234',
+ *   steps: [
+ *     { order: 1, agent: 'llm-reviewer', status: 'pending' },
+ *     { order: 2, action: 'gates', status: 'pending' },
+ *   ],
+ *   estimatedTokens: 5000,
+ * };
+ */
+export type ExecutionPlan = z.infer<typeof ExecutionPlanSchema>;
+/**
+ * User choice on execution plan confirmation.
+ *
+ * @example
+ * const choice: UserChoice = { choice: 'approve' };
+ * const editChoice: UserChoice = { choice: 'edit', modifications: ['Skip step 2'] };
+ */
+export type UserChoice = z.infer<typeof UserChoiceSchema>;
+/**
+ * Complete dashboard data aggregating all metrics.
+ * This is the main data structure passed to renderers.
+ *
+ * @example
+ * const data: DashboardData = {
+ *   globalStatus: { ... },
+ *   agentMetrics: { 'security-auditor': { ... } },
+ *   wuProgress: [{ ... }],
+ *   timeline: [{ ... }],
+ *   alerts: [{ ... }],
+ * };
+ */
+export type DashboardData = z.infer<typeof DashboardDataSchema>;
+//# sourceMappingURL=orchestration.types.d.ts.map

package/dist/src/domain/orchestration.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.types.d.ts","sourceRoot":"","sources":["../../../src/domain/orchestration.types.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EACV,IAAI,EACJ,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,KAAK,EACL,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/src/domain/orchestration.types.js

@@ -0,0 +1,5 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// Re-export const values as well
+export { LANES, AGENT_NAMES, SEVERITY_LEVELS, AGENT_RESULT_STATUSES, TIMELINE_EVENT_TYPES, EVENT_SEVERITY_LEVELS, USER_CHOICE_OPTIONS, MANDATORY_AGENT_NAMES, } from './orchestration.constants.js';
+//# sourceMappingURL=orchestration.types.js.map

package/dist/src/domain/orchestration.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.types.js","sourceRoot":"","sources":["../../../src/domain/orchestration.types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAsCzC,iCAAiC;AACjC,OAAO,EACL,KAAK,EACL,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}

package/dist/src/methodology/incremental-test.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Glob patterns to exclude slow integration/golden tests from changed runs.
+ * @type {string[]}
+ */
+export declare const VITEST_CHANGED_EXCLUDES: readonly string[];
+/**
+ * File extensions considered executable code for test runs.
+ * @type {string[]}
+ */
+export declare const CODE_FILE_EXTENSIONS: readonly string[];
+/**
+ * Check if a path points to a code file that should trigger full tests.
+ *
+ * @param {string} filePath - Path to check
+ * @returns {boolean} True if the path has a code extension
+ */
+export declare function isCodeFilePath(filePath: string): boolean;
+/**
+ * Options for building Vitest changed args
+ */
+interface BuildVitestChangedArgsOptions {
+    /** Base branch for diff */
+    baseBranch?: string;
+}
+/**
+ * Build Vitest CLI args for --changed runs.
+ *
+ * @param {BuildVitestChangedArgsOptions} [options]
+ * @returns {string[]} Vitest args for changed test runs
+ */
+export declare function buildVitestChangedArgs(options?: BuildVitestChangedArgsOptions): string[];
+export {};
+//# sourceMappingURL=incremental-test.d.ts.map

package/dist/src/methodology/incremental-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-test.d.ts","sourceRoot":"","sources":["../../../src/methodology/incremental-test.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,mBAA8D,CAAC;AAEnG;;;GAGG;AACH,eAAO,MAAM,oBAAoB,mBAS/B,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,WAO9C;AAED;;GAEG;AACH,UAAU,6BAA6B;IACrC,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,6BAAkC,YAgBjF"}

package/dist/src/methodology/incremental-test.js

@@ -0,0 +1,73 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file incremental-test.ts
+ * @description Helpers for Vitest --changed execution
+ *
+ * WU-1920: Add incremental test execution to gates
+ * WU-2504: Use Vitest --changed instead of custom file diff logic
+ */
+import { GIT_REFS } from '../constants/wu-git-constants.js';
+// WU-2790 follow-up: the software-delivery pack cannot import from
+// @lumenflow/core (pack import-boundary enforcement restricts packs to
+// @lumenflow/kernel + Node built-ins). Vitest --changed's base branch
+// therefore stays on the pack's own GIT_REFS constant. If the host
+// workspace reconfigures software_delivery.git.mainBranch, incremental
+// test selection here falls back to origin/main — slightly over-selects
+// when running --changed, but preserves correctness. Proper fix requires
+// relocating the integration-target resolver into kernel; tracked
+// separately as a pack-boundary follow-up.
+/**
+ * Glob patterns to exclude slow integration/golden tests from changed runs.
+ * @type {string[]}
+ */
+export const VITEST_CHANGED_EXCLUDES = Object.freeze(['**/*.integration.*', '**/golden-*.test.*']);
+/**
+ * File extensions considered executable code for test runs.
+ * @type {string[]}
+ */
+export const CODE_FILE_EXTENSIONS = Object.freeze([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.js',
+    '.cjs',
+    '.mts',
+    '.cts',
+]);
+/**
+ * Check if a path points to a code file that should trigger full tests.
+ *
+ * @param {string} filePath - Path to check
+ * @returns {boolean} True if the path has a code extension
+ */
+export function isCodeFilePath(filePath) {
+    if (!filePath || typeof filePath !== 'string') {
+        return false;
+    }
+    const normalized = filePath.replace(/\\/g, '/').toLowerCase();
+    return CODE_FILE_EXTENSIONS.some((ext) => normalized.endsWith(ext));
+}
+/**
+ * Build Vitest CLI args for --changed runs.
+ *
+ * @param {BuildVitestChangedArgsOptions} [options]
+ * @returns {string[]} Vitest args for changed test runs
+ */
+export function buildVitestChangedArgs(options = {}) {
+    const { baseBranch = GIT_REFS.ORIGIN_MAIN } = options;
+    const args = [
+        '--changed',
+        baseBranch,
+        '--run',
+        '--passWithNoTests',
+        '--maxWorkers=1',
+        '--teardownTimeout=30000',
+    ];
+    for (const pattern of VITEST_CHANGED_EXCLUDES) {
+        args.push(`--exclude='${pattern}'`);
+    }
+    return args;
+}
+//# sourceMappingURL=incremental-test.js.map

package/dist/src/methodology/incremental-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-test.js","sourceRoot":"","sources":["../../../src/methodology/incremental-test.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,mEAAmE;AACnE,uEAAuE;AACvE,sEAAsE;AACtE,mEAAmE;AACnE,uEAAuE;AACvE,wEAAwE;AACxE,yEAAyE;AACzE,kEAAkE;AAClE,2CAA2C;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEnG;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAyC,EAAE;IAChF,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC;IACtD,MAAM,IAAI,GAAG;QACX,WAAW;QACX,UAAU;QACV,OAAO;QACP,mBAAmB;QACnB,gBAAgB;QAChB,yBAAyB;KAC1B,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,uBAAuB,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,cAAc,OAAO,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/methodology/index.d.ts

@@ -0,0 +1,3 @@
+export * from './manual-test-validator.js';
+export * from './incremental-test.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/methodology/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/methodology/index.ts"],"names":[],"mappings":"AAIA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC"}

package/dist/src/methodology/index.js

@@ -0,0 +1,6 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// WU-2683 (INIT-058 L4): Methodology cohort barrel — re-export relocated modules.
+export * from './manual-test-validator.js';
+export * from './incremental-test.js';
+//# sourceMappingURL=index.js.map

package/dist/src/methodology/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/methodology/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,kFAAkF;AAClF,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC"}

package/dist/src/methodology/manual-test-validator.d.ts

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * Manual Test Escape Hatch Validator
+ *
+ * WU-1433: Restricts manual-only tests for WUs touching hex core code.
+ * WU-2332: Require automated tests for all code files, remove lane exemptions.
+ *
+ * Implementation WUs must have at least one automated test (unit/e2e/integration).
+ *
+ * Exemptions:
+ * - type: documentation only
+ * - code_paths containing only documentation/config files (no code files)
+ * - WU-2273: notes containing tdd-exception: marker (explicit opt-out)
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-done-validators.ts} - Integration point
+ * @see {@link config.directories.completeGuidePath} - TDD requirements
+ */
+/** Minimal WU document shape for test validation */
+interface WuDocForTests {
+    type?: string;
+    code_paths?: unknown;
+    tests?: unknown;
+    test_paths?: unknown;
+    notes?: unknown;
+}
+/**
+ * Path prefixes for hex core code requiring automated tests.
+ * These are the critical application layer paths.
+ *
+ * WU-1068: Changed from @exampleapp to @lumenflow for framework reusability.
+ * Project-specific patterns should be configured in workspace.yaml.
+ *
+ * @constant {string[]}
+ */
+export declare const HEX_CORE_CODE_PATTERNS: readonly string[];
+/**
+ * @deprecated Lane-based exemptions removed in WU-2332.
+ * Test requirements are now based on file types, not lanes.
+ * Kept for backward compatibility but no longer used.
+ * @constant {string[]}
+ */
+export declare const EXEMPT_LANES: readonly never[];
+/**
+ * WU types exempt from automated test requirement.
+ * Only 'documentation' type is exempt - actual code changes require automated tests.
+ *
+ * @constant {string[]}
+ */
+export declare const EXEMPT_TYPES: readonly import("../constants/wu-statuses.js").WUType[];
+/**
+ * Determine if a file path represents a code file requiring automated tests.
+ *
+ * Code files are those with extensions like .ts, .ts, .tsx, .js
+ * EXCEPT config files (vitest.config.ts, .eslintrc.js, etc.)
+ *
+ * @param {string} filePath - File path to check
+ * @returns {boolean} True if the file is a code file requiring tests
+ */
+export declare function isCodeFile(filePath: string): boolean;
+/**
+ * Check if code_paths contains any hex core code.
+ *
+ * @param {string[]|null|undefined} codePaths - Array of file paths from WU YAML
+ * @returns {boolean} True if any path is in hex core layer
+ */
+export declare function containsHexCoreCode(codePaths: unknown): boolean;
+/**
+ * Check if a WU is exempt from automated test requirement.
+ *
+ * WU-2332: Only type: 'documentation' is exempt.
+ * WU-2273: Also exempt if notes contain tdd-exception: marker,
+ * aligning wu:done with wu:prep behavior.
+ *
+ * Lane-based exemptions have been removed - test requirements
+ * are now based on file types in code_paths.
+ *
+ * @param {object} doc - WU YAML document
+ * @returns {boolean} True if WU is exempt
+ */
+export declare function isExemptFromAutomatedTests(doc: WuDocForTests | null | undefined): boolean;
+/**
+ * Validate automated test requirement for WU.
+ *
+ * WU-2332: Requirements are based on file types, not lanes.
+ * - WUs with ANY code files in code_paths must have automated tests
+ * - WUs with only docs/config files can use manual-only tests
+ * - type: 'documentation' is always exempt
+ *
+ * @param {object} doc - WU YAML document
+ * @returns {{ valid: boolean, errors: string[] }} Validation result
+ */
+export declare function validateAutomatedTestRequirement(doc: WuDocForTests | null | undefined): {
+    valid: boolean;
+    errors: string[];
+};
+export {};
+//# sourceMappingURL=manual-test-validator.d.ts.map

package/dist/src/methodology/manual-test-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-test-validator.d.ts","sourceRoot":"","sources":["../../../src/methodology/manual-test-validator.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;;;;;;GAeG;AAMH,oDAAoD;AACpD,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyBD;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,mBAIjC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,YAAY,kBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,yDAA0C,CAAC;AAYpE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,WA0B1C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,WASrD;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,WAe/E;AAuCD;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS;;;EAuCrF"}