@lumenflow/cli 5.5.0 → 5.7.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (229) hide show
  1. package/README.md +41 -40
  2. package/dist/db-journal-recover.js +400 -0
  3. package/dist/db-journal-recover.js.map +1 -0
  4. package/dist/docs-sync.js +8 -3
  5. package/dist/docs-sync.js.map +1 -1
  6. package/dist/doctor.js +11 -0
  7. package/dist/doctor.js.map +1 -1
  8. package/dist/gate-defaults.js +37 -0
  9. package/dist/gate-defaults.js.map +1 -1
  10. package/dist/gates/monolithic-file-contention-guard.js +167 -0
  11. package/dist/gates/monolithic-file-contention-guard.js.map +1 -0
  12. package/dist/gates/prod-migration-drift.js +207 -0
  13. package/dist/gates/prod-migration-drift.js.map +1 -0
  14. package/dist/gates/test-over-deletion-guard.js +280 -0
  15. package/dist/gates/test-over-deletion-guard.js.map +1 -0
  16. package/dist/gates-runners.js +44 -3
  17. package/dist/gates-runners.js.map +1 -1
  18. package/dist/gates.js +3 -2
  19. package/dist/gates.js.map +1 -1
  20. package/dist/hooks/config-resolver.js +16 -1
  21. package/dist/hooks/config-resolver.js.map +1 -1
  22. package/dist/hooks/dirty-guard.js +43 -2
  23. package/dist/hooks/dirty-guard.js.map +1 -1
  24. package/dist/hooks/git-status-parser.js +22 -8
  25. package/dist/hooks/git-status-parser.js.map +1 -1
  26. package/dist/init-templates.js +241 -0
  27. package/dist/init-templates.js.map +1 -1
  28. package/dist/init.js +122 -16
  29. package/dist/init.js.map +1 -1
  30. package/dist/lumenflow-setup.js +144 -0
  31. package/dist/lumenflow-setup.js.map +1 -0
  32. package/dist/lumenflow-upgrade.js +43 -1
  33. package/dist/lumenflow-upgrade.js.map +1 -1
  34. package/dist/mem-create.js +10 -1
  35. package/dist/mem-create.js.map +1 -1
  36. package/dist/mem-signal.js +21 -4
  37. package/dist/mem-signal.js.map +1 -1
  38. package/dist/orchestrate-initiative.js +28 -3
  39. package/dist/orchestrate-initiative.js.map +1 -1
  40. package/dist/public-manifest.js +17 -7
  41. package/dist/public-manifest.js.map +1 -1
  42. package/dist/release.js +53 -18
  43. package/dist/release.js.map +1 -1
  44. package/dist/wu-done-gates.js +13 -9
  45. package/dist/wu-done-gates.js.map +1 -1
  46. package/dist/wu-done.js +14 -2
  47. package/dist/wu-done.js.map +1 -1
  48. package/dist/wu-edit-operations.js +74 -0
  49. package/dist/wu-edit-operations.js.map +1 -1
  50. package/dist/wu-edit-validators.js +58 -0
  51. package/dist/wu-edit-validators.js.map +1 -1
  52. package/dist/wu-edit.js +106 -4
  53. package/dist/wu-edit.js.map +1 -1
  54. package/dist/wu-prep.js +57 -9
  55. package/dist/wu-prep.js.map +1 -1
  56. package/dist/wu-recover.js +6 -0
  57. package/dist/wu-recover.js.map +1 -1
  58. package/dist/wu-release.js +120 -2
  59. package/dist/wu-release.js.map +1 -1
  60. package/dist/wu-sizing-validation.js +47 -17
  61. package/dist/wu-sizing-validation.js.map +1 -1
  62. package/dist/wu-status.js +33 -0
  63. package/dist/wu-status.js.map +1 -1
  64. package/package.json +13 -12
  65. package/packs/agent-runtime/package.json +1 -1
  66. package/packs/sidekick/package.json +1 -1
  67. package/packs/software-delivery/package.json +1 -1
  68. package/templates/core/AGENTS.md.template +67 -3
  69. package/templates/core/LUMENFLOW.md.template +196 -47
  70. package/dist/distribution-preflight.js +0 -230
  71. package/dist/distribution-preflight.js.map +0 -1
  72. package/packs/agent-runtime/agent-heartbeat.ts +0 -163
  73. package/packs/agent-runtime/auto-session-integration.ts +0 -888
  74. package/packs/agent-runtime/capability-factory.ts +0 -104
  75. package/packs/agent-runtime/constants.ts +0 -21
  76. package/packs/agent-runtime/delegation-registry-schema.ts +0 -220
  77. package/packs/agent-runtime/delegation-registry-store.ts +0 -269
  78. package/packs/agent-runtime/delegation-tree.ts +0 -328
  79. package/packs/agent-runtime/index.ts +0 -20
  80. package/packs/agent-runtime/manifest.ts +0 -348
  81. package/packs/agent-runtime/memory-coordination-contract.ts +0 -86
  82. package/packs/agent-runtime/orchestration.ts +0 -2027
  83. package/packs/agent-runtime/pack-registration.ts +0 -110
  84. package/packs/agent-runtime/policy-factory.ts +0 -165
  85. package/packs/agent-runtime/remote-controls/index.ts +0 -7
  86. package/packs/agent-runtime/remote-controls/operations.ts +0 -405
  87. package/packs/agent-runtime/remote-controls/port.ts +0 -48
  88. package/packs/agent-runtime/remote-controls/state-store.ts +0 -258
  89. package/packs/agent-runtime/remote-controls/types.ts +0 -105
  90. package/packs/agent-runtime/session-schema.ts +0 -467
  91. package/packs/agent-runtime/tool-impl/agent-turn-tools.ts +0 -793
  92. package/packs/agent-runtime/tool-impl/index.ts +0 -6
  93. package/packs/agent-runtime/tool-impl/provider-adapters.ts +0 -1245
  94. package/packs/agent-runtime/tool-impl/remote-controls.mock.ts +0 -256
  95. package/packs/agent-runtime/tool-impl/remote-controls.ts +0 -273
  96. package/packs/agent-runtime/tools/index.ts +0 -4
  97. package/packs/agent-runtime/tools/types.ts +0 -47
  98. package/packs/agent-runtime/turn-lifecycle-events.ts +0 -590
  99. package/packs/agent-runtime/types.ts +0 -128
  100. package/packs/agent-runtime/vitest.config.ts +0 -11
  101. package/packs/sidekick/channel-ingress.ts +0 -137
  102. package/packs/sidekick/constants.ts +0 -10
  103. package/packs/sidekick/index.ts +0 -8
  104. package/packs/sidekick/manifest-schema.ts +0 -49
  105. package/packs/sidekick/manifest.ts +0 -512
  106. package/packs/sidekick/pack-registration.ts +0 -110
  107. package/packs/sidekick/policy-factory.ts +0 -38
  108. package/packs/sidekick/sidekick-events.ts +0 -694
  109. package/packs/sidekick/src/adapters/cloud-queue.ts +0 -101
  110. package/packs/sidekick/src/adapters/control-plane-bridge.adapter.ts +0 -386
  111. package/packs/sidekick/src/adapters/filesystem-bridge.adapter.ts +0 -228
  112. package/packs/sidekick/src/domain/channel.types.ts +0 -64
  113. package/packs/sidekick/src/ports/channel-bridge.port.ts +0 -92
  114. package/packs/sidekick/src/routines/commit.ts +0 -74
  115. package/packs/sidekick/tool-impl/channel-tools.ts +0 -577
  116. package/packs/sidekick/tool-impl/channel-transports.ts +0 -75
  117. package/packs/sidekick/tool-impl/index.ts +0 -29
  118. package/packs/sidekick/tool-impl/memory-tools.ts +0 -290
  119. package/packs/sidekick/tool-impl/routine-commit.ts +0 -102
  120. package/packs/sidekick/tool-impl/routine-tools.ts +0 -440
  121. package/packs/sidekick/tool-impl/runtime-context.ts +0 -28
  122. package/packs/sidekick/tool-impl/shared.ts +0 -125
  123. package/packs/sidekick/tool-impl/storage.ts +0 -325
  124. package/packs/sidekick/tool-impl/system-tools.ts +0 -160
  125. package/packs/sidekick/tool-impl/task-tools.ts +0 -506
  126. package/packs/sidekick/tools/channel-tools.ts +0 -53
  127. package/packs/sidekick/tools/index.ts +0 -9
  128. package/packs/sidekick/tools/memory-tools.ts +0 -53
  129. package/packs/sidekick/tools/routine-tools.ts +0 -53
  130. package/packs/sidekick/tools/system-tools.ts +0 -47
  131. package/packs/sidekick/tools/task-tools.ts +0 -61
  132. package/packs/sidekick/tools/types.ts +0 -57
  133. package/packs/sidekick/vitest.config.ts +0 -11
  134. package/packs/software-delivery/constants.ts +0 -10
  135. package/packs/software-delivery/extensions.ts +0 -140
  136. package/packs/software-delivery/gate-policies.ts +0 -134
  137. package/packs/software-delivery/index.ts +0 -8
  138. package/packs/software-delivery/manifest-schema.ts +0 -268
  139. package/packs/software-delivery/manifest.ts +0 -657
  140. package/packs/software-delivery/pack-registration.ts +0 -113
  141. package/packs/software-delivery/src/commands/index.ts +0 -5
  142. package/packs/software-delivery/src/config/delivery-review-contract.ts +0 -256
  143. package/packs/software-delivery/src/config/env-accessors.ts +0 -66
  144. package/packs/software-delivery/src/config/index.ts +0 -8
  145. package/packs/software-delivery/src/config/normalize-config-keys.ts +0 -9
  146. package/packs/software-delivery/src/config/schemas/lumenflow-config-schema-types.ts +0 -460
  147. package/packs/software-delivery/src/config/workspace-reader.ts +0 -375
  148. package/packs/software-delivery/src/constants/backlog-patterns.ts +0 -31
  149. package/packs/software-delivery/src/constants/client-ids.ts +0 -19
  150. package/packs/software-delivery/src/constants/config-contract.ts +0 -7
  151. package/packs/software-delivery/src/constants/docs-layout-presets.ts +0 -50
  152. package/packs/software-delivery/src/constants/duration-constants.ts +0 -20
  153. package/packs/software-delivery/src/constants/gate-constants.ts +0 -32
  154. package/packs/software-delivery/src/constants/index.ts +0 -29
  155. package/packs/software-delivery/src/constants/lock-constants.ts +0 -35
  156. package/packs/software-delivery/src/constants/object-guards.ts +0 -12
  157. package/packs/software-delivery/src/constants/section-headings.ts +0 -107
  158. package/packs/software-delivery/src/constants/wu-cli-constants.ts +0 -500
  159. package/packs/software-delivery/src/constants/wu-domain-constants.ts +0 -466
  160. package/packs/software-delivery/src/constants/wu-git-constants.ts +0 -7
  161. package/packs/software-delivery/src/constants/wu-id-format.ts +0 -327
  162. package/packs/software-delivery/src/constants/wu-paths-constants.ts +0 -384
  163. package/packs/software-delivery/src/constants/wu-statuses.ts +0 -287
  164. package/packs/software-delivery/src/constants/wu-type-helpers.ts +0 -67
  165. package/packs/software-delivery/src/constants/wu-ui-constants.ts +0 -267
  166. package/packs/software-delivery/src/constants/wu-validation-constants.ts +0 -73
  167. package/packs/software-delivery/src/domain/index.ts +0 -5
  168. package/packs/software-delivery/src/domain/orchestration.constants.ts +0 -166
  169. package/packs/software-delivery/src/domain/orchestration.schemas.ts +0 -238
  170. package/packs/software-delivery/src/domain/orchestration.types.ts +0 -176
  171. package/packs/software-delivery/src/methodology/incremental-test.ts +0 -122
  172. package/packs/software-delivery/src/methodology/index.ts +0 -6
  173. package/packs/software-delivery/src/methodology/manual-test-validator.ts +0 -292
  174. package/packs/software-delivery/src/policy/coverage-gate.ts +0 -270
  175. package/packs/software-delivery/src/policy/gates-agent-mode.ts +0 -223
  176. package/packs/software-delivery/src/policy/gates-config-internal.ts +0 -121
  177. package/packs/software-delivery/src/policy/gates-config.ts +0 -300
  178. package/packs/software-delivery/src/policy/gates-coverage.ts +0 -356
  179. package/packs/software-delivery/src/policy/gates-presets.ts +0 -134
  180. package/packs/software-delivery/src/policy/gates-schemas.ts +0 -173
  181. package/packs/software-delivery/src/policy/index.ts +0 -22
  182. package/packs/software-delivery/src/policy/package-manager-resolver.ts +0 -319
  183. package/packs/software-delivery/src/policy/resolve-policy.ts +0 -601
  184. package/packs/software-delivery/src/ports/config.ports.ts +0 -90
  185. package/packs/software-delivery/src/ports/dashboard-renderer.port.ts +0 -125
  186. package/packs/software-delivery/src/ports/index.ts +0 -10
  187. package/packs/software-delivery/src/ports/sync-validator.ports.ts +0 -59
  188. package/packs/software-delivery/src/ports/wu-helpers.ports.ts +0 -168
  189. package/packs/software-delivery/src/ports/wu-state.ports.ts +0 -241
  190. package/packs/software-delivery/src/primitives/index.ts +0 -5
  191. package/packs/software-delivery/src/runtime/index.ts +0 -6
  192. package/packs/software-delivery/src/runtime/work-classifier.ts +0 -561
  193. package/packs/software-delivery/src/sandbox/index.ts +0 -10
  194. package/packs/software-delivery/src/sandbox/sandbox-allowlist.ts +0 -118
  195. package/packs/software-delivery/src/sandbox/sandbox-backend-linux.ts +0 -88
  196. package/packs/software-delivery/src/sandbox/sandbox-backend-macos.ts +0 -154
  197. package/packs/software-delivery/src/sandbox/sandbox-backend-windows.ts +0 -47
  198. package/packs/software-delivery/src/sandbox/sandbox-profile.ts +0 -153
  199. package/packs/software-delivery/src/schemas/index.ts +0 -5
  200. package/packs/software-delivery/src/state/date-utils.ts +0 -158
  201. package/packs/software-delivery/src/state/index.ts +0 -15
  202. package/packs/software-delivery/src/state/state-machine.ts +0 -119
  203. package/packs/software-delivery/src/state/wu-doc-types.ts +0 -51
  204. package/packs/software-delivery/src/state/wu-paths.ts +0 -381
  205. package/packs/software-delivery/src/state/wu-schema.ts +0 -1139
  206. package/packs/software-delivery/src/state/wu-state-schema.ts +0 -255
  207. package/packs/software-delivery/src/state/wu-yaml.ts +0 -338
  208. package/packs/software-delivery/tool-impl/agent-tools.ts +0 -263
  209. package/packs/software-delivery/tool-impl/delegation-tools.ts +0 -66
  210. package/packs/software-delivery/tool-impl/flow-metrics-tools.ts +0 -219
  211. package/packs/software-delivery/tool-impl/git-runner.ts +0 -113
  212. package/packs/software-delivery/tool-impl/git-tools.ts +0 -316
  213. package/packs/software-delivery/tool-impl/index.ts +0 -15
  214. package/packs/software-delivery/tool-impl/initiative-orchestration-tools.ts +0 -720
  215. package/packs/software-delivery/tool-impl/lane-lock.ts +0 -246
  216. package/packs/software-delivery/tool-impl/memory-tools.ts +0 -470
  217. package/packs/software-delivery/tool-impl/pending-runtime-tools.ts +0 -21
  218. package/packs/software-delivery/tool-impl/runtime-cli-adapter.ts +0 -329
  219. package/packs/software-delivery/tool-impl/runtime-native-tools.ts +0 -687
  220. package/packs/software-delivery/tool-impl/worker-loader.ts +0 -52
  221. package/packs/software-delivery/tool-impl/worktree-tools.ts +0 -46
  222. package/packs/software-delivery/tool-impl/wu-lifecycle-tools.ts +0 -807
  223. package/packs/software-delivery/tools/delegation-tools.ts +0 -23
  224. package/packs/software-delivery/tools/git-tools.ts +0 -55
  225. package/packs/software-delivery/tools/index.ts +0 -8
  226. package/packs/software-delivery/tools/lane-lock-tool.ts +0 -37
  227. package/packs/software-delivery/tools/types.ts +0 -71
  228. package/packs/software-delivery/tools/worktree-tools.ts +0 -49
  229. package/packs/software-delivery/vitest.config.ts +0 -11
@@ -1,601 +0,0 @@
1
- // Copyright (c) 2026 Hellmai Ltd
2
- // SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
3
-
4
- /**
5
- * Resolve Policy - Single Source of Truth for Methodology Decisions
6
- *
7
- * WU-1259: Provides a unified policy resolver that both wu:spawn and gates use.
8
- *
9
- * This module:
10
- * - Defines the methodology.* config schema
11
- * - Implements resolvePolicy() to produce ResolvedPolicy
12
- * - Applies precedence: template defaults -> methodology.overrides -> explicit gates.* -> CLI flags
13
- *
14
- * @module resolve-policy
15
- */
16
-
17
- import { z } from 'zod';
18
- import { WU_TYPES, WU_TYPE_VALUES, type WUType } from '../constants/wu-statuses.js';
19
-
20
- /**
21
- * Testing methodology options
22
- */
23
- export const TESTING_METHODOLOGY = {
24
- TDD: 'tdd',
25
- TEST_AFTER: 'test-after',
26
- NONE: 'none',
27
- } as const;
28
-
29
- export type TestingMethodology = (typeof TESTING_METHODOLOGY)[keyof typeof TESTING_METHODOLOGY];
30
-
31
- /**
32
- * Architecture methodology options
33
- */
34
- export const ARCHITECTURE_METHODOLOGY = {
35
- HEXAGONAL: 'hexagonal',
36
- LAYERED: 'layered',
37
- NONE: 'none',
38
- } as const;
39
-
40
- export type ArchitectureMethodology =
41
- (typeof ARCHITECTURE_METHODOLOGY)[keyof typeof ARCHITECTURE_METHODOLOGY];
42
-
43
- /**
44
- * Coverage mode options
45
- */
46
- export const COVERAGE_MODE = {
47
- BLOCK: 'block',
48
- WARN: 'warn',
49
- OFF: 'off',
50
- } as const;
51
-
52
- export type CoverageMode = (typeof COVERAGE_MODE)[keyof typeof COVERAGE_MODE];
53
-
54
- /**
55
- * Zod schema for testing methodology enum
56
- */
57
- export const TestingMethodologySchema = z.enum(['tdd', 'test-after', 'none']);
58
-
59
- /**
60
- * Zod schema for architecture methodology enum
61
- */
62
- export const ArchitectureMethodologySchema = z.enum(['hexagonal', 'layered', 'none']);
63
-
64
- /**
65
- * Zod schema for coverage mode enum
66
- */
67
- export const CoverageModeSchema = z.enum(['block', 'warn', 'off']);
68
-
69
- /**
70
- * WU-2905: Default test-file glob patterns for the tdd_diff_evidence gate.
71
- *
72
- * These globs identify files that count as "test evidence" in a branch diff
73
- * for the default TS/JS toolchain. Mirrors the regex set in
74
- * `@lumenflow/core/file-classifiers.ts:TEST_FILE_PATTERNS` (the legacy regex
75
- * form historically used by the gate consumer in wu:prep). When a workspace
76
- * overrides `tdd_diff_evidence.test_file_patterns`, the gate uses the
77
- * override exclusively (no merge) so non-TS/JS toolchains (.NET, Python,
78
- * Go, ...) get a clean opt-in without inheriting TS/JS bias.
79
- */
80
- export const DEFAULT_TDD_DIFF_TEST_FILE_PATTERNS: readonly string[] = Object.freeze([
81
- '**/*.test.ts',
82
- '**/*.test.tsx',
83
- '**/*.test.js',
84
- '**/*.test.jsx',
85
- '**/*.test.mjs',
86
- '**/*.spec.ts',
87
- '**/*.spec.tsx',
88
- '**/*.spec.js',
89
- '**/*.spec.jsx',
90
- '**/*.spec.mjs',
91
- '**/__tests__/**',
92
- '**/*.test-utils.*',
93
- '**/*.mock.*',
94
- ]);
95
-
96
- /**
97
- * WU-2905: Default code file extensions for the tdd_diff_evidence gate.
98
- *
99
- * Determines which changed files count as production code that requires
100
- * accompanying test evidence. Mirrors the historic constant in
101
- * `methodology/incremental-test.ts:CODE_FILE_EXTENSIONS`.
102
- */
103
- export const DEFAULT_TDD_DIFF_CODE_FILE_EXTENSIONS: readonly string[] = Object.freeze([
104
- '.ts',
105
- '.tsx',
106
- '.js',
107
- '.jsx',
108
- '.cjs',
109
- '.mts',
110
- '.cts',
111
- ]);
112
-
113
- export const TddDiffEvidenceConfigSchema = z.object({
114
- mode: CoverageModeSchema.optional(),
115
- applies_to_types: z.array(z.enum(WU_TYPE_VALUES)).min(1).optional(),
116
- exempt_paths: z.array(z.string().min(1)).optional(),
117
- /**
118
- * WU-2905: Optional glob patterns identifying test files for the
119
- * tdd_diff_evidence gate. When omitted, defaults to TS/JS patterns
120
- * (DEFAULT_TDD_DIFF_TEST_FILE_PATTERNS). When set, REPLACES the defaults so
121
- * non-TS/JS consumers can supply only their language's test patterns
122
- * (e.g. ['**\/*Tests.cs', '**\/Test*.cs'] for C# xUnit/NUnit/MSTest).
123
- */
124
- test_file_patterns: z.array(z.string().min(1)).min(1).optional(),
125
- /**
126
- * WU-2905: Optional file extensions identifying production code files for
127
- * the tdd_diff_evidence gate. When omitted, defaults to TS/JS extensions
128
- * (DEFAULT_TDD_DIFF_CODE_FILE_EXTENSIONS). When set, REPLACES the defaults
129
- * (e.g. ['.cs'] for C#, ['.py'] for Python, ['.go'] for Go).
130
- */
131
- code_file_extensions: z.array(z.string().min(1)).min(1).optional(),
132
- });
133
-
134
- export type TddDiffEvidenceConfig = z.infer<typeof TddDiffEvidenceConfigSchema>;
135
-
136
- /**
137
- * WU-2650: Commit-order (RED-first) policy schema.
138
- *
139
- * Sibling to TddDiffEvidenceConfigSchema. Where the diff-evidence policy
140
- * checks that tests EXIST somewhere in the branch diff, this policy checks
141
- * that tests APPEARED BEFORE (or alongside) the runtime code in commit order.
142
- *
143
- * Defaults: when methodology.testing = 'tdd', mode resolves to 'block'.
144
- * Otherwise 'off'. applies_to_types defaults to [feature, bug] so docs /
145
- * chore / process / tooling / refactor WUs bypass automatically.
146
- */
147
- export const TddOrderingConfigSchema = z.object({
148
- mode: CoverageModeSchema.optional(),
149
- applies_to_types: z.array(z.enum(WU_TYPE_VALUES)).min(1).optional(),
150
- min_runtime_loc_per_commit_without_tests: z.number().int().positive().optional(),
151
- grace_commits: z.number().int().nonnegative().optional(),
152
- exempt_paths: z.array(z.string().min(1)).optional(),
153
- });
154
-
155
- export type TddOrderingConfig = z.infer<typeof TddOrderingConfigSchema>;
156
-
157
- /**
158
- * Methodology overrides schema
159
- *
160
- * These allow tweaking template defaults without changing methodology.
161
- */
162
- export const MethodologyOverridesSchema = z.object({
163
- /** Override the default coverage threshold from the testing methodology */
164
- coverage_threshold: z.number().min(0).max(100).optional(),
165
- /** Override the default coverage mode from the testing methodology */
166
- coverage_mode: CoverageModeSchema.optional(),
167
- });
168
-
169
- export type MethodologyOverrides = z.infer<typeof MethodologyOverridesSchema>;
170
-
171
- /**
172
- * WU-1899: Work classification UI pattern configuration
173
- *
174
- * Allows extending default UI detection patterns with project-specific
175
- * code path patterns and lane hints. Custom values EXTEND defaults,
176
- * they do not replace them.
177
- *
178
- * @example
179
- * ```yaml
180
- * methodology:
181
- * work_classification:
182
- * ui:
183
- * code_path_patterns:
184
- * - 'src/widgets/*.tsx'
185
- * lane_hints:
186
- * - 'Design'
187
- * ```
188
- */
189
- export const WorkClassificationUiSchema = z.object({
190
- /**
191
- * Additional glob patterns for detecting UI work via code paths.
192
- * These extend the built-in defaults (CSS, SCSS, LESS, components, pages, etc.).
193
- * Uses minimatch glob syntax.
194
- */
195
- code_path_patterns: z.array(z.string()).optional(),
196
-
197
- /**
198
- * Additional lane parent hints for detecting UI work.
199
- * These extend the built-in defaults (Experience, Frontend, UI, Design).
200
- * Matched case-insensitively against the lane parent (part before the colon).
201
- */
202
- lane_hints: z.array(z.string()).optional(),
203
- });
204
-
205
- /** WU-1899: TypeScript type for work classification UI config */
206
- export type WorkClassificationUi = z.infer<typeof WorkClassificationUiSchema>;
207
-
208
- /**
209
- * WU-1899: Work classification configuration schema
210
- *
211
- * Controls signal-based work domain detection for code-path-aware
212
- * UI/backend/docs/infra classification.
213
- *
214
- * @example
215
- * ```yaml
216
- * methodology:
217
- * work_classification:
218
- * ui:
219
- * code_path_patterns:
220
- * - 'src/widgets/*.tsx'
221
- * lane_hints:
222
- * - 'Design'
223
- * ```
224
- */
225
- export const WorkClassificationConfigSchema = z.object({
226
- /** UI detection pattern overrides (extend defaults) */
227
- ui: WorkClassificationUiSchema.optional(),
228
- });
229
-
230
- /** WU-1899: TypeScript type for work classification config */
231
- export type WorkClassificationSchemaConfig = z.infer<typeof WorkClassificationConfigSchema>;
232
-
233
- /**
234
- * Main methodology configuration schema
235
- *
236
- * Config example in workspace.yaml:
237
- * ```yaml
238
- * methodology:
239
- * testing: 'tdd' # tdd | test-after | none
240
- * architecture: 'hexagonal' # hexagonal | layered | none
241
- * overrides:
242
- * coverage_threshold: 85 # Override TDD's default 90%
243
- * coverage_mode: 'warn' # Override TDD's default 'block'
244
- * work_classification:
245
- * ui:
246
- * code_path_patterns:
247
- * - 'src/widgets/*.tsx'
248
- * lane_hints:
249
- * - 'Design'
250
- * ```
251
- */
252
- export const MethodologyConfigSchema = z.object({
253
- /** Testing methodology (default: 'tdd') */
254
- testing: TestingMethodologySchema.default('tdd'),
255
- /** Architecture methodology (default: 'hexagonal') */
256
- architecture: ArchitectureMethodologySchema.default('hexagonal'),
257
- /** Optional overrides for template defaults */
258
- overrides: MethodologyOverridesSchema.optional(),
259
- /**
260
- * WU-1899: Work classification configuration.
261
- * Extends default signal patterns for UI/backend/docs/infra detection.
262
- * Custom patterns extend defaults, they do not replace them.
263
- */
264
- work_classification: WorkClassificationConfigSchema.optional(),
265
- });
266
-
267
- export type MethodologyConfig = z.infer<typeof MethodologyConfigSchema>;
268
-
269
- /**
270
- * Template defaults by testing methodology
271
- *
272
- * These define the baseline behavior for each testing approach.
273
- *
274
- * | Methodology | Coverage Threshold | Coverage Mode | Tests Required |
275
- * |-------------|-------------------|---------------|----------------|
276
- * | tdd | 90% | block | true |
277
- * | test-after | 70% | warn | true |
278
- * | none | 0% | off | false |
279
- */
280
- interface TestingTemplateDefaults {
281
- coverage_threshold: number;
282
- coverage_mode: CoverageMode;
283
- tests_required: boolean;
284
- }
285
-
286
- const DEFAULT_TDD_DIFF_APPLIES_TO_TYPES = [
287
- WU_TYPES.FEATURE,
288
- WU_TYPES.BUG,
289
- ] as const satisfies readonly WUType[];
290
- const DEFAULT_TDD_DIFF_EXEMPT_PATHS: readonly string[] = [];
291
-
292
- const TESTING_TEMPLATE_DEFAULTS: Record<TestingMethodology, TestingTemplateDefaults> = {
293
- tdd: {
294
- coverage_threshold: 90,
295
- coverage_mode: 'block',
296
- tests_required: true,
297
- },
298
- 'test-after': {
299
- coverage_threshold: 70,
300
- coverage_mode: 'warn',
301
- tests_required: true,
302
- },
303
- none: {
304
- coverage_threshold: 0,
305
- coverage_mode: 'off',
306
- tests_required: false,
307
- },
308
- };
309
-
310
- /**
311
- * The resolved policy used by wu:spawn and gates
312
- *
313
- * This is the single source of truth for methodology decisions.
314
- * All consumers (spawn prompts, gate runners, etc.) should use this type.
315
- */
316
- export interface ResolvedPolicy {
317
- /** Active testing methodology */
318
- testing: TestingMethodology;
319
- /** Active architecture methodology */
320
- architecture: ArchitectureMethodology;
321
- /** Resolved coverage threshold (0-100) */
322
- coverage_threshold: number;
323
- /** Resolved coverage mode */
324
- coverage_mode: CoverageMode;
325
- /** Whether tests are required for completion */
326
- tests_required: boolean;
327
- /** Resolved TDD diff evidence applicability */
328
- tdd_diff_evidence: TddDiffEvidencePolicy;
329
- /** WU-2650: Resolved commit-order (RED-first) policy */
330
- tdd_ordering: TddOrderingPolicy;
331
- }
332
-
333
- export interface TddDiffEvidencePolicy {
334
- mode: CoverageMode;
335
- applies_to_types: WUType[];
336
- exempt_paths: string[];
337
- /**
338
- * WU-2905: Resolved glob patterns identifying test files. Always
339
- * populated — falls back to DEFAULT_TDD_DIFF_TEST_FILE_PATTERNS when the
340
- * workspace does not override.
341
- */
342
- test_file_patterns: string[];
343
- /**
344
- * WU-2905: Resolved file extensions identifying production code files.
345
- * Always populated — falls back to DEFAULT_TDD_DIFF_CODE_FILE_EXTENSIONS
346
- * when the workspace does not override.
347
- */
348
- code_file_extensions: string[];
349
- }
350
-
351
- /**
352
- * WU-2650: Resolved commit-order policy.
353
- */
354
- export interface TddOrderingPolicy {
355
- mode: CoverageMode;
356
- applies_to_types: WUType[];
357
- min_runtime_loc_per_commit_without_tests: number;
358
- grace_commits: number;
359
- exempt_paths: string[];
360
- }
361
-
362
- /**
363
- * WU-2650: Default threshold for "non-trivial runtime LOC" in a single commit
364
- * before the commit-order gate flags a missing preceding test commit.
365
- *
366
- * Rationale: WU-2641 committed 1198 LOC of runtime ahead of tests. 50 is low
367
- * enough to catch meaningful feature work but high enough to ignore small
368
- * config-only edits and typo fixes.
369
- */
370
- const DEFAULT_TDD_ORDERING_MIN_RUNTIME_LOC = 50;
371
- const DEFAULT_TDD_ORDERING_GRACE_COMMITS = 0;
372
-
373
- /**
374
- * Options for resolvePolicy
375
- */
376
- export interface ResolvePolicyOptions {
377
- /**
378
- * Raw config object before Zod defaults were applied.
379
- * Used to detect explicit vs default values for gates.* fields.
380
- *
381
- * When provided, only EXPLICIT gates.* settings override methodology.
382
- * When not provided, UnsafeAny gates.* value (including defaults) overrides methodology.
383
- */
384
- rawConfig?: {
385
- gates?: {
386
- minCoverage?: number;
387
- enableCoverage?: boolean;
388
- tdd_diff_evidence?: TddDiffEvidenceConfig;
389
- tdd_ordering?: TddOrderingConfig;
390
- };
391
- };
392
- }
393
-
394
- interface PolicyConfigInput {
395
- methodology?: MethodologyConfig;
396
- gates: {
397
- minCoverage: number;
398
- enableCoverage: boolean;
399
- tdd_diff_evidence?: TddDiffEvidenceConfig;
400
- tdd_ordering?: TddOrderingConfig;
401
- };
402
- }
403
-
404
- function resolveDefaultTddDiffEvidenceMode(testing: TestingMethodology): CoverageMode {
405
- return testing === TESTING_METHODOLOGY.TDD ? COVERAGE_MODE.BLOCK : COVERAGE_MODE.OFF;
406
- }
407
-
408
- function cloneWuTypes(value: readonly WUType[] | undefined): WUType[] {
409
- return [...(value ?? DEFAULT_TDD_DIFF_APPLIES_TO_TYPES)];
410
- }
411
-
412
- function cloneExemptPaths(value: readonly string[] | undefined): string[] {
413
- return [...(value ?? DEFAULT_TDD_DIFF_EXEMPT_PATHS)];
414
- }
415
-
416
- function cloneTestFilePatterns(value: readonly string[] | undefined): string[] {
417
- return [...(value ?? DEFAULT_TDD_DIFF_TEST_FILE_PATTERNS)];
418
- }
419
-
420
- function cloneCodeFileExtensions(value: readonly string[] | undefined): string[] {
421
- return [...(value ?? DEFAULT_TDD_DIFF_CODE_FILE_EXTENSIONS)];
422
- }
423
-
424
- function resolveTddDiffEvidencePolicy(
425
- testing: TestingMethodology,
426
- config: TddDiffEvidenceConfig | undefined,
427
- ): TddDiffEvidencePolicy {
428
- return {
429
- mode: config?.mode ?? resolveDefaultTddDiffEvidenceMode(testing),
430
- applies_to_types: cloneWuTypes(config?.applies_to_types),
431
- exempt_paths: cloneExemptPaths(config?.exempt_paths),
432
- test_file_patterns: cloneTestFilePatterns(config?.test_file_patterns),
433
- code_file_extensions: cloneCodeFileExtensions(config?.code_file_extensions),
434
- };
435
- }
436
-
437
- /**
438
- * WU-2650: Resolve the commit-order policy. Defaults mirror the diff-evidence
439
- * policy: enforce under TDD, off otherwise; applies to feature/bug only.
440
- */
441
- function resolveTddOrderingPolicyInternal(
442
- testing: TestingMethodology,
443
- config: TddOrderingConfig | undefined,
444
- ): TddOrderingPolicy {
445
- return {
446
- mode: config?.mode ?? resolveDefaultTddDiffEvidenceMode(testing),
447
- applies_to_types: cloneWuTypes(config?.applies_to_types),
448
- min_runtime_loc_per_commit_without_tests:
449
- config?.min_runtime_loc_per_commit_without_tests ?? DEFAULT_TDD_ORDERING_MIN_RUNTIME_LOC,
450
- grace_commits: config?.grace_commits ?? DEFAULT_TDD_ORDERING_GRACE_COMMITS,
451
- exempt_paths: cloneExemptPaths(config?.exempt_paths),
452
- };
453
- }
454
-
455
- /**
456
- * Resolve the effective policy from configuration
457
- *
458
- * Precedence (highest to lowest):
459
- * 1. CLI flags (not handled here - handled by command layer)
460
- * 2. Explicit gates.* configuration (only if rawConfig provided to detect explicit vs default)
461
- * 3. methodology.overrides
462
- * 4. methodology template defaults
463
- *
464
- * This ensures backwards compatibility: existing users with explicit
465
- * gates.* config see no change, while new users can use methodology
466
- * config for a higher-level abstraction.
467
- *
468
- * @param config - The full LumenFlow configuration
469
- * @param options - Options including rawConfig for explicit detection
470
- * @returns The resolved policy for use by wu:spawn and gates
471
- *
472
- * @example
473
- * ```typescript
474
- * import { getConfig } from './lumenflow-config.js';
475
- * import { resolvePolicy } from './resolve-policy.js';
476
- *
477
- * const config = getConfig();
478
- * const policy = resolvePolicy(config);
479
- *
480
- * console.log(policy.coverage_threshold); // 90 (or configured value)
481
- * console.log(policy.testing); // 'tdd' (or configured value)
482
- * ```
483
- *
484
- * @example With raw config for explicit detection
485
- * ```typescript
486
- * const rawConfig = { methodology: { testing: 'test-after' } };
487
- * const config = parseConfig(rawConfig);
488
- * const policy = resolvePolicy(config, { rawConfig });
489
- * // policy.coverage_threshold will be 70 (test-after template default)
490
- * // because gates.minCoverage wasn't EXPLICITLY set
491
- * ```
492
- */
493
- export function resolvePolicy(
494
- config: PolicyConfigInput,
495
- options: ResolvePolicyOptions = {},
496
- ): ResolvedPolicy {
497
- const { rawConfig } = options;
498
-
499
- // Parse methodology config (provides defaults if not specified)
500
- const methodology = MethodologyConfigSchema.parse(config.methodology ?? {});
501
-
502
- // Get template defaults based on testing methodology
503
- const templateDefaults = TESTING_TEMPLATE_DEFAULTS[methodology.testing];
504
-
505
- // Layer 1: Start with template defaults
506
- let coverage_threshold = templateDefaults.coverage_threshold;
507
- let coverage_mode = templateDefaults.coverage_mode;
508
- const tests_required = templateDefaults.tests_required;
509
-
510
- // Layer 2: Apply methodology.overrides (if specified)
511
- if (methodology.overrides?.coverage_threshold !== undefined) {
512
- coverage_threshold = methodology.overrides.coverage_threshold;
513
- }
514
- if (methodology.overrides?.coverage_mode !== undefined) {
515
- coverage_mode = methodology.overrides.coverage_mode;
516
- }
517
-
518
- // Layer 3: Apply explicit gates.* configuration (highest precedence)
519
- // This ensures backwards compatibility with existing gates config
520
- //
521
- // Key insight: We only want EXPLICIT gates.* to override methodology.
522
- // If rawConfig is provided, we check if gates values were explicitly set.
523
- // If rawConfig is NOT provided (legacy mode), we check if methodology
524
- // was specified - if so, methodology controls unless gates differ from default.
525
-
526
- const gates = config.gates;
527
-
528
- // Determine if gates.minCoverage was explicitly set
529
- const gatesMinCoverageExplicit =
530
- rawConfig !== undefined ? rawConfig.gates?.minCoverage !== undefined : false;
531
-
532
- // Determine if gates.enableCoverage was explicitly set
533
- const gatesEnableCoverageExplicit =
534
- rawConfig !== undefined ? rawConfig.gates?.enableCoverage !== undefined : false;
535
-
536
- // Apply gates.minCoverage only if explicitly set, or if no methodology was specified
537
- // (for backwards compatibility with pre-methodology configs)
538
- const methodologySpecified = config.methodology !== undefined;
539
-
540
- if (gatesMinCoverageExplicit || (!methodologySpecified && rawConfig === undefined)) {
541
- // gates.minCoverage overrides methodology coverage_threshold
542
- coverage_threshold = gates.minCoverage;
543
- }
544
-
545
- // gates.enableCoverage: false effectively sets coverage_mode to 'off'
546
- if (gatesEnableCoverageExplicit || (!methodologySpecified && rawConfig === undefined)) {
547
- if (gates?.enableCoverage === false) {
548
- coverage_mode = 'off';
549
- }
550
- }
551
-
552
- const tdd_diff_evidence = resolveTddDiffEvidencePolicy(
553
- methodology.testing,
554
- config.gates?.tdd_diff_evidence,
555
- );
556
-
557
- const tdd_ordering = resolveTddOrderingPolicyInternal(
558
- methodology.testing,
559
- config.gates?.tdd_ordering,
560
- );
561
-
562
- return {
563
- testing: methodology.testing,
564
- architecture: methodology.architecture,
565
- coverage_threshold,
566
- coverage_mode,
567
- tests_required,
568
- tdd_diff_evidence,
569
- tdd_ordering,
570
- };
571
- }
572
-
573
- /**
574
- * Create a default resolved policy
575
- *
576
- * Convenience function for when no config is available.
577
- * Returns strict TDD defaults.
578
- */
579
- export function getDefaultPolicy(): ResolvedPolicy {
580
- return {
581
- testing: 'tdd',
582
- architecture: 'hexagonal',
583
- coverage_threshold: 90,
584
- coverage_mode: 'block',
585
- tests_required: true,
586
- tdd_diff_evidence: {
587
- mode: COVERAGE_MODE.BLOCK,
588
- applies_to_types: [...DEFAULT_TDD_DIFF_APPLIES_TO_TYPES],
589
- exempt_paths: [...DEFAULT_TDD_DIFF_EXEMPT_PATHS],
590
- test_file_patterns: [...DEFAULT_TDD_DIFF_TEST_FILE_PATTERNS],
591
- code_file_extensions: [...DEFAULT_TDD_DIFF_CODE_FILE_EXTENSIONS],
592
- },
593
- tdd_ordering: {
594
- mode: COVERAGE_MODE.BLOCK,
595
- applies_to_types: [...DEFAULT_TDD_DIFF_APPLIES_TO_TYPES],
596
- min_runtime_loc_per_commit_without_tests: DEFAULT_TDD_ORDERING_MIN_RUNTIME_LOC,
597
- grace_commits: DEFAULT_TDD_ORDERING_GRACE_COMMITS,
598
- exempt_paths: [...DEFAULT_TDD_DIFF_EXEMPT_PATHS],
599
- },
600
- };
601
- }
@@ -1,90 +0,0 @@
1
- // Copyright (c) 2026 Hellmai Ltd
2
- // SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
3
-
4
- /**
5
- * Configuration Ports (WU-2020)
6
- *
7
- * Focused interfaces for injecting configuration sections into command
8
- * handlers and service functions. These replace module-level getConfig()
9
- * calls with explicit parameter injection (DIP compliance).
10
- *
11
- * Each interface extracts the minimum config surface needed by its
12
- * consumers, following the Interface Segregation Principle (ISP).
13
- *
14
- * @module ports/config
15
- */
16
-
17
- /**
18
- * Git-related configuration for branch checks and worktree operations.
19
- *
20
- * Consumers: branch-check.ts, micro-worktree-shared.ts, micro-worktree.ts
21
- */
22
- export interface IGitConfig {
23
- readonly mainBranch: string;
24
- readonly defaultRemote: string;
25
- readonly requireRemote: boolean;
26
- readonly laneBranchPrefix?: string;
27
- readonly agentBranchPatterns?: string[];
28
- readonly agentBranchPatternsOverride?: string[];
29
- readonly disableAgentPatternRegistry?: boolean;
30
- readonly pushRetry?: {
31
- readonly enabled: boolean;
32
- readonly retries: number;
33
- readonly min_delay_ms: number;
34
- readonly max_delay_ms: number;
35
- readonly jitter: boolean;
36
- };
37
- }
38
-
39
- /**
40
- * Directory paths configuration for WU file resolution.
41
- *
42
- * Consumers: wu-paths.ts, wu-list.ts, spawn-task-builder.ts
43
- */
44
- export interface IDirectoriesConfig {
45
- readonly wuDir: string;
46
- readonly initiativesDir: string;
47
- readonly backlogPath: string;
48
- readonly statusPath: string;
49
- readonly worktrees: string;
50
- readonly stampsDir?: string;
51
- readonly plansDir: string;
52
- readonly templatesDir: string;
53
- readonly onboardingDir: string;
54
- readonly skillsDir: string;
55
- readonly agentsDir: string;
56
- readonly memoryBank: string;
57
- readonly safeGitPath: string;
58
- }
59
-
60
- /**
61
- * State paths configuration for store directory resolution.
62
- *
63
- * Consumers: wu-paths.ts, wu-backlog-updater.ts
64
- */
65
- export interface IStateConfig {
66
- readonly base: string;
67
- readonly stampsDir: string;
68
- readonly stateDir: string;
69
- }
70
-
71
- /**
72
- * Minimal config interface for path-resolution consumers.
73
- *
74
- * Consumers that only need directory and state paths should depend
75
- * on this interface rather than the full LumenFlowConfig.
76
- */
77
- export interface IPathsConfig {
78
- readonly directories: IDirectoriesConfig;
79
- readonly state: IStateConfig;
80
- }
81
-
82
- /**
83
- * Minimal config interface for git-operation consumers.
84
- *
85
- * Consumers that only need git configuration should depend on this
86
- * interface rather than the full LumenFlowConfig.
87
- */
88
- export interface IGitOperationConfig {
89
- readonly git: IGitConfig;
90
- }