@1aboveio/engineering-skills 0.0.0-stage → 0.1.0

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 (233) hide show
  1. package/README.md +28 -2
  2. package/package.json +33 -4
  3. package/skills/better-review/LICENSE +3 -0
  4. package/skills/better-review/SKILL.md +249 -0
  5. package/skills/better-review/agents/openai.yaml +9 -0
  6. package/skills/better-review/references/domain-hazards.md +53 -0
  7. package/skills/better-review/references/passes.md +147 -0
  8. package/skills/better-review/references/result.md +151 -0
  9. package/skills/better-review/release-check.mjs +93 -0
  10. package/skills/better-review/scripts/pr-context.mjs +212 -0
  11. package/skills/better-review/scripts/pr-context.test.mjs +168 -0
  12. package/skills/better-review/scripts/rereview-scope.mjs +503 -0
  13. package/skills/better-review/scripts/rereview-scope.test.mjs +587 -0
  14. package/skills/better-review/scripts/scan-diff.mjs +365 -0
  15. package/skills/better-review/scripts/scan-diff.test.mjs +414 -0
  16. package/skills/better-review/scripts/vendor-sync.test.mjs +96 -0
  17. package/skills/e2e-test/LICENSE +3 -0
  18. package/skills/e2e-test/SKILL.md +98 -0
  19. package/skills/e2e-test/assets/ci-gates.cloudbuild.yaml +24 -0
  20. package/skills/e2e-test/references/authoring/auth-flows.md +159 -0
  21. package/skills/e2e-test/references/authoring/playwright-config.md +73 -0
  22. package/skills/e2e-test/references/authoring/playwright-patterns.md +144 -0
  23. package/skills/e2e-test/references/ci-integration.md +25 -0
  24. package/skills/e2e-test/references/ci-playwright-container.md +290 -0
  25. package/skills/e2e-test/references/presentation-sweep.md +104 -0
  26. package/skills/e2e-test/references/reviewing.md +41 -0
  27. package/skills/e2e-test/references/route-manifest.md +51 -0
  28. package/skills/e2e-test/release-check.mjs +93 -0
  29. package/skills/e2e-test/scripts/detect-routes-nextjs.mjs +200 -0
  30. package/skills/e2e-test/scripts/presentation-checks.mjs +171 -0
  31. package/skills/e2e-test/scripts/presentation-checks.test.mjs +106 -0
  32. package/skills/e2e-test/scripts/presentation-perceivability.mjs +179 -0
  33. package/skills/e2e-test/scripts/presentation-perceivability.test.mjs +117 -0
  34. package/skills/e2e-test/scripts/presentation-reachability.mjs +154 -0
  35. package/skills/e2e-test/scripts/presentation-reachability.test.mjs +69 -0
  36. package/skills/e2e-test/scripts/presentation-render-health.mjs +141 -0
  37. package/skills/e2e-test/scripts/presentation-render-health.test.mjs +98 -0
  38. package/skills/e2e-test/scripts/presentation-sweep.mjs +147 -0
  39. package/skills/e2e-test/scripts/presentation-sweep.test.mjs +71 -0
  40. package/skills/e2e-test/scripts/presentation-temporal.mjs +127 -0
  41. package/skills/e2e-test/scripts/presentation-temporal.test.mjs +59 -0
  42. package/skills/e2e-test/scripts/project-route-manifest.mjs +82 -0
  43. package/skills/e2e-test/scripts/project-route-manifest.test.mjs +76 -0
  44. package/skills/e2e-test/scripts/validate-manifest.mjs +106 -0
  45. package/skills/engineering-runtime/LICENSE +3 -0
  46. package/skills/engineering-runtime/SKILL.md +11 -0
  47. package/skills/engineering-runtime/agents/openai.yaml +6 -0
  48. package/skills/engineering-runtime/coherence/workflow.json +597 -0
  49. package/skills/engineering-runtime/engineering-runtime.test.mjs +68 -0
  50. package/skills/engineering-runtime/release-check.mjs +93 -0
  51. package/skills/engineering-runtime/scripts/exact-head-artifact.mjs +131 -0
  52. package/skills/engineering-runtime/scripts/head-check-set.mjs +398 -0
  53. package/skills/engineering-runtime/scripts/invocation-policy.mjs +187 -0
  54. package/skills/engineering-runtime/scripts/invocation-policy.test.mjs +95 -0
  55. package/skills/engineering-runtime/scripts/main-module.mjs +79 -0
  56. package/skills/engineering-runtime/scripts/main-module.test.mjs +288 -0
  57. package/skills/engineering-runtime/scripts/mergify-yaml.mjs +11 -0
  58. package/skills/engineering-runtime/scripts/package-lock.json +43 -0
  59. package/skills/engineering-runtime/scripts/package.json +10 -0
  60. package/skills/engineering-runtime/scripts/required-check-plan.mjs +223 -0
  61. package/skills/engineering-runtime/scripts/required-check-plan.test.mjs +96 -0
  62. package/skills/engineering-runtime/scripts/review-completion.mjs +56 -0
  63. package/skills/engineering-runtime/scripts/workflow-coherence.mjs +595 -0
  64. package/skills/engineering-runtime/scripts/workflow-policy.mjs +189 -0
  65. package/skills/engineering-runtime/scripts/yaml-mapping.mjs +18 -0
  66. package/skills/ensure-coverage/LICENSE +3 -0
  67. package/skills/ensure-coverage/SKILL.md +129 -0
  68. package/skills/ensure-coverage/references/breadth/coverage-ledger.md +92 -0
  69. package/skills/ensure-coverage/references/breadth/inventory-contract.md +85 -0
  70. package/skills/ensure-coverage/references/breadth/surface-baseline.md +44 -0
  71. package/skills/ensure-coverage/references/breadth/surface-discovery.md +16 -0
  72. package/skills/ensure-coverage/references/depth/characterization.md +68 -0
  73. package/skills/ensure-coverage/references/depth/coverage.config.example.json +19 -0
  74. package/skills/ensure-coverage/references/depth/grading.md +35 -0
  75. package/skills/ensure-coverage/references/depth/mock-policy.md +57 -0
  76. package/skills/ensure-coverage/references/depth/test-smells.md +39 -0
  77. package/skills/ensure-coverage/references/enforcement/ci-contract.md +44 -0
  78. package/skills/ensure-coverage/references/examples/coverage-ledger.md +110 -0
  79. package/skills/ensure-coverage/references/examples/refund-flow.md +35 -0
  80. package/skills/ensure-coverage/references/presentation/axis.md +64 -0
  81. package/skills/ensure-coverage/references/process/audit-mode.md +27 -0
  82. package/skills/ensure-coverage/references/process/output-template.md +139 -0
  83. package/skills/ensure-coverage/references/process/test-strategy.md +56 -0
  84. package/skills/ensure-coverage/release-check.mjs +93 -0
  85. package/skills/ensure-coverage/schemas/coverage-config.schema.json +67 -0
  86. package/skills/ensure-coverage/schemas/coverage-file.schema.json +140 -0
  87. package/skills/ensure-coverage/scripts/README.md +99 -0
  88. package/skills/ensure-coverage/scripts/adapters/nextjs-inventory.mjs +182 -0
  89. package/skills/ensure-coverage/scripts/adapters/nextjs-inventory.test.mjs +96 -0
  90. package/skills/ensure-coverage/scripts/check-quarantine-expiry.mjs +105 -0
  91. package/skills/ensure-coverage/scripts/check-quarantine-expiry.test.mjs +47 -0
  92. package/skills/ensure-coverage/scripts/ci-audit.mjs +137 -0
  93. package/skills/ensure-coverage/scripts/ci-audit.test.mjs +86 -0
  94. package/skills/ensure-coverage/scripts/coverage-ledger.mjs +674 -0
  95. package/skills/ensure-coverage/scripts/coverage-ledger.test.mjs +447 -0
  96. package/skills/ensure-coverage/scripts/design-parity.mjs +591 -0
  97. package/skills/ensure-coverage/scripts/design-parity.test.mjs +552 -0
  98. package/skills/ensure-coverage/scripts/lint-tests.mjs +282 -0
  99. package/skills/ensure-coverage/scripts/lint-tests.test.mjs +289 -0
  100. package/skills/ensure-coverage/scripts/mock-policy-config.mjs +176 -0
  101. package/skills/ensure-coverage/scripts/mock-policy-config.test.mjs +119 -0
  102. package/skills/ensure-coverage/scripts/package.json +19 -0
  103. package/skills/golden-path/LICENSE +3 -0
  104. package/skills/golden-path/SKILL.md +230 -0
  105. package/skills/golden-path/agents/openai.yaml +3 -0
  106. package/skills/golden-path/assets/golden-paths.example.json +57 -0
  107. package/skills/golden-path/references/contract.md +239 -0
  108. package/skills/golden-path/references/migration.md +111 -0
  109. package/skills/golden-path/release-check.mjs +93 -0
  110. package/skills/golden-path/scripts/golden-path-core.mjs +1779 -0
  111. package/skills/golden-path/scripts/golden-path.mjs +6 -0
  112. package/skills/golden-path/scripts/golden-path.test.mjs +1457 -0
  113. package/skills/harness-runtime/LICENSE +3 -0
  114. package/skills/harness-runtime/SKILL.md +19 -0
  115. package/skills/harness-runtime/agents/openai.yaml +6 -0
  116. package/skills/harness-runtime/bin/discover-models.mjs +4 -0
  117. package/skills/harness-runtime/bin/model-catalog.mjs +4 -0
  118. package/skills/harness-runtime/contracts.md +15 -0
  119. package/skills/harness-runtime/discover-models.mjs +392 -0
  120. package/skills/harness-runtime/discover-models.test.mjs +363 -0
  121. package/skills/harness-runtime/fixtures/native-question-schemas.json +33 -0
  122. package/skills/harness-runtime/fixtures/question-responses.json +54 -0
  123. package/skills/harness-runtime/harness-runtime.test.mjs +967 -0
  124. package/skills/harness-runtime/index.mjs +767 -0
  125. package/skills/harness-runtime/model-catalog-seed.test.mjs +829 -0
  126. package/skills/harness-runtime/model-catalog.mjs +787 -0
  127. package/skills/harness-runtime/model-catalog.test.mjs +366 -0
  128. package/skills/harness-runtime/native-question-contracts.md +37 -0
  129. package/skills/harness-runtime/references/model-catalog-seed.json +408 -0
  130. package/skills/harness-runtime/references/model-catalog.md +57 -0
  131. package/skills/harness-runtime/release-check.mjs +93 -0
  132. package/skills/resolve-issues/LICENSE +3 -0
  133. package/skills/resolve-issues/SKILL.md +250 -0
  134. package/skills/resolve-issues/agents/openai.yaml +9 -0
  135. package/skills/resolve-issues/plugin-hooks.json +17 -0
  136. package/skills/resolve-issues/references/canary.md +28 -0
  137. package/skills/resolve-issues/references/ci.md +105 -0
  138. package/skills/resolve-issues/references/done.md +25 -0
  139. package/skills/resolve-issues/references/dropbox.md +90 -0
  140. package/skills/resolve-issues/references/expire.md +318 -0
  141. package/skills/resolve-issues/references/exploration.md +202 -0
  142. package/skills/resolve-issues/references/implementation.md +303 -0
  143. package/skills/resolve-issues/references/preflight.md +445 -0
  144. package/skills/resolve-issues/references/review.md +228 -0
  145. package/skills/resolve-issues/references/shared-modules.md +44 -0
  146. package/skills/resolve-issues/references/task-plan.md +264 -0
  147. package/skills/resolve-issues/release-check.mjs +93 -0
  148. package/skills/resolve-issues/scripts/cleanup-runs.mjs +364 -0
  149. package/skills/resolve-issues/scripts/cleanup-runs.test.mjs +280 -0
  150. package/skills/resolve-issues/scripts/discover-models.mjs +9 -0
  151. package/skills/resolve-issues/scripts/dropbox.mjs +473 -0
  152. package/skills/resolve-issues/scripts/dropbox.test.mjs +346 -0
  153. package/skills/resolve-issues/scripts/findings-reuse.mjs +98 -0
  154. package/skills/resolve-issues/scripts/findings-reuse.test.mjs +88 -0
  155. package/skills/resolve-issues/scripts/github-reviews.mjs +384 -0
  156. package/skills/resolve-issues/scripts/github-reviews.test.mjs +264 -0
  157. package/skills/resolve-issues/scripts/install-hooks.mjs +135 -0
  158. package/skills/resolve-issues/scripts/install-hooks.test.mjs +79 -0
  159. package/skills/resolve-issues/scripts/issue-tree.mjs +162 -0
  160. package/skills/resolve-issues/scripts/issue-tree.test.mjs +107 -0
  161. package/skills/resolve-issues/scripts/manual-invocation.test.mjs +14 -0
  162. package/skills/resolve-issues/scripts/model-catalog.mjs +9 -0
  163. package/skills/resolve-issues/scripts/next-actions-capacity.test.mjs +149 -0
  164. package/skills/resolve-issues/scripts/next-actions.mjs +856 -0
  165. package/skills/resolve-issues/scripts/next-actions.test.mjs +915 -0
  166. package/skills/resolve-issues/scripts/plan-sync.mjs +269 -0
  167. package/skills/resolve-issues/scripts/plan-sync.test.mjs +156 -0
  168. package/skills/resolve-issues/scripts/preflight-models.mjs +736 -0
  169. package/skills/resolve-issues/scripts/preflight-models.test.mjs +448 -0
  170. package/skills/resolve-issues/scripts/ready-check.mjs +185 -0
  171. package/skills/resolve-issues/scripts/ready-check.test.mjs +217 -0
  172. package/skills/resolve-issues/scripts/rehydrate.mjs +98 -0
  173. package/skills/resolve-issues/scripts/rehydrate.test.mjs +91 -0
  174. package/skills/resolve-issues/scripts/review-verdict.mjs +509 -0
  175. package/skills/resolve-issues/scripts/review-verdict.test.mjs +1060 -0
  176. package/skills/resolve-issues/scripts/size-check.mjs +492 -0
  177. package/skills/resolve-issues/scripts/size-check.test.mjs +458 -0
  178. package/skills/resolve-release/LICENSE +3 -0
  179. package/skills/resolve-release/SKILL.md +215 -0
  180. package/skills/resolve-release/agents/openai.yaml +8 -0
  181. package/skills/resolve-release/flows/cloud-run-canary.md +13 -0
  182. package/skills/resolve-release/flows/cloud-run.md +7 -0
  183. package/skills/resolve-release/flows/root-tag-npm.md +13 -0
  184. package/skills/resolve-release/flows/workspace-npm.md +22 -0
  185. package/skills/resolve-release/references/canary.md +51 -0
  186. package/skills/resolve-release/references/candidate.md +41 -0
  187. package/skills/resolve-release/references/cut.md +131 -0
  188. package/skills/resolve-release/references/dark-launch.md +66 -0
  189. package/skills/resolve-release/references/flows.md +150 -0
  190. package/skills/resolve-release/references/preflight.md +154 -0
  191. package/skills/resolve-release/references/prepared-metadata.md +260 -0
  192. package/skills/resolve-release/references/promotion.md +82 -0
  193. package/skills/resolve-release/references/publish.md +232 -0
  194. package/skills/resolve-release/references/workspace-npm.md +103 -0
  195. package/skills/resolve-release/release-check.mjs +93 -0
  196. package/skills/resolve-release/scripts/apply.mjs +212 -0
  197. package/skills/resolve-release/scripts/apply.test.mjs +99 -0
  198. package/skills/resolve-release/scripts/dark-flags.mjs +134 -0
  199. package/skills/resolve-release/scripts/dark-flags.test.mjs +100 -0
  200. package/skills/resolve-release/scripts/flow.mjs +500 -0
  201. package/skills/resolve-release/scripts/flow.test.mjs +340 -0
  202. package/skills/resolve-release/scripts/green-head.mjs +231 -0
  203. package/skills/resolve-release/scripts/green-head.test.mjs +101 -0
  204. package/skills/resolve-release/scripts/npm-version-absence.mjs +138 -0
  205. package/skills/resolve-release/scripts/npm-version-absence.test.mjs +426 -0
  206. package/skills/resolve-release/scripts/plan-npm.test.mjs +659 -0
  207. package/skills/resolve-release/scripts/plan-toml-boundary.test.mjs +317 -0
  208. package/skills/resolve-release/scripts/plan-uv.test.mjs +291 -0
  209. package/skills/resolve-release/scripts/plan.mjs +806 -0
  210. package/skills/resolve-release/scripts/plan.test.mjs +428 -0
  211. package/skills/rush-issues/LICENSE +3 -0
  212. package/skills/rush-issues/SKILL.md +58 -0
  213. package/skills/rush-issues/agents/openai.yaml +8 -0
  214. package/skills/rush-issues/rehydrate.mjs +10 -0
  215. package/skills/rush-issues/release-check.mjs +93 -0
  216. package/skills/rush-release/LICENSE +3 -0
  217. package/skills/rush-release/SKILL.md +35 -0
  218. package/skills/rush-release/agents/openai.yaml +8 -0
  219. package/skills/rush-release/release-check.mjs +93 -0
  220. package/skills/test-quality/LICENSE +3 -0
  221. package/skills/test-quality/SKILL.md +79 -0
  222. package/skills/test-quality/references/audit.md +80 -0
  223. package/skills/test-quality/references/lint.md +24 -0
  224. package/skills/test-quality/references/principles.md +143 -0
  225. package/skills/test-quality/references/testing-conventions.md +9 -0
  226. package/skills/test-quality/release-check.mjs +93 -0
  227. package/skills/test-quality/scripts/lint-tests.mjs +574 -0
  228. package/skills/test-quality/scripts/lint-tests.test.mjs +591 -0
  229. package/skills/test-quality/scripts/mock-policy-config.mjs +176 -0
  230. package/skills/test-quality/scripts/mock-policy-config.test.mjs +119 -0
  231. package/skills/test-quality/scripts/persist-conventions-core.mjs +116 -0
  232. package/skills/test-quality/scripts/persist-conventions.mjs +17 -0
  233. package/skills/test-quality/scripts/persist-conventions.test.mjs +104 -0
@@ -0,0 +1,767 @@
1
+ const HARNESSES = new Set(['pi', 'codex', 'claude-code']);
2
+ const COMPLETENESS = new Set(['partial', 'full']);
3
+ const RUNTIME_MODEL_SOURCES = new Set(['current-turn', 'runtime-enumeration']);
4
+
5
+ export const HARNESS_RUNTIME_ERROR_CODES = Object.freeze({
6
+ INVALID_CAPABILITIES: 'invalid-capabilities',
7
+ INVALID_QUESTION: 'invalid-question',
8
+ INVALID_ANSWERS: 'invalid-answers',
9
+ INVALID_MODEL_AVAILABILITY: 'invalid-model-availability',
10
+ CAPABILITY_UNAVAILABLE: 'capability-unavailable',
11
+ UNSUPPORTED_QUESTION: 'unsupported-question',
12
+ FALLBACK_FORBIDDEN: 'fallback-forbidden',
13
+ });
14
+
15
+ function deepFreeze(value) {
16
+ if (value && typeof value === 'object' && !Object.isFrozen(value)) {
17
+ for (const child of Object.values(value)) deepFreeze(child);
18
+ Object.freeze(value);
19
+ }
20
+ return value;
21
+ }
22
+
23
+ function clone(value) {
24
+ return structuredClone(value);
25
+ }
26
+
27
+ export class HarnessRuntimeError extends Error {
28
+ constructor(code, message, details = {}) {
29
+ super(message);
30
+ this.name = 'HarnessRuntimeError';
31
+ this.code = code;
32
+ this.details = deepFreeze(clone(details));
33
+ }
34
+ }
35
+
36
+ export class CapabilityUnavailableError extends HarnessRuntimeError {
37
+ constructor(capability, details = {}) {
38
+ super(
39
+ HARNESS_RUNTIME_ERROR_CODES.CAPABILITY_UNAVAILABLE,
40
+ `Required harness capability is unavailable: ${capability}`,
41
+ { ...details, capability },
42
+ );
43
+ this.name = 'CapabilityUnavailableError';
44
+ this.capability = capability;
45
+ }
46
+ }
47
+
48
+ export class UnsupportedQuestionError extends HarnessRuntimeError {
49
+ constructor(reason, details = {}) {
50
+ super(
51
+ HARNESS_RUNTIME_ERROR_CODES.UNSUPPORTED_QUESTION,
52
+ `Question cannot be represented by the selected native adapter: ${reason}`,
53
+ { ...details, reason },
54
+ );
55
+ this.name = 'UnsupportedQuestionError';
56
+ this.reason = reason;
57
+ }
58
+ }
59
+
60
+ export const QUESTION_ADAPTER_PRIORITY = Object.freeze([
61
+ 'ask_user_question',
62
+ 'request_user_input',
63
+ 'AskUserQuestion',
64
+ ]);
65
+
66
+ export const QUESTION_FALLBACK_POLICY = deepFreeze({
67
+ noNativeQuestionTool: {
68
+ freeText: 'concise-free-text-only',
69
+ multipleChoice: 'forbidden',
70
+ },
71
+ unsupportedMultiSelect: 'error',
72
+ secretInput: 'error',
73
+ });
74
+
75
+ function isRecord(value) {
76
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
77
+ }
78
+
79
+ function hasExactFields(value, required, optional = []) {
80
+ if (!isRecord(value)) return false;
81
+ const allowed = new Set([...required, ...optional]);
82
+ return required.every((field) => Object.hasOwn(value, field))
83
+ && Object.keys(value).every((field) => allowed.has(field));
84
+ }
85
+
86
+ function nonEmptyString(value) {
87
+ return typeof value === 'string' && value.trim().length > 0;
88
+ }
89
+
90
+ function stringList(value, { allowEmpty = true } = {}) {
91
+ return Array.isArray(value)
92
+ && (allowEmpty || value.length > 0)
93
+ && value.every(nonEmptyString)
94
+ && new Set(value).size === value.length;
95
+ }
96
+
97
+ function invalid(code, label, details = {}) {
98
+ throw new HarnessRuntimeError(code, `Invalid harness runtime ${label}.`, details);
99
+ }
100
+
101
+ export function defineCurrentTurnCapabilities(value) {
102
+ if (!hasExactFields(value, ['nativeTools', 'spawnModelIds'])
103
+ || !stringList(value.nativeTools)
104
+ || !stringList(value.spawnModelIds)) {
105
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_CAPABILITIES, 'current-turn capabilities');
106
+ }
107
+ return deepFreeze(clone(value));
108
+ }
109
+
110
+ function validOption(option) {
111
+ return hasExactFields(option, ['id', 'label'], ['description'])
112
+ && nonEmptyString(option.id)
113
+ && nonEmptyString(option.label)
114
+ && (option.description === undefined || nonEmptyString(option.description));
115
+ }
116
+
117
+ export function defineQuestionSpec(value) {
118
+ if (!hasExactFields(
119
+ value,
120
+ ['id', 'header', 'prompt'],
121
+ ['options', 'recommendationOrder', 'multiSelect', 'secret'],
122
+ ) || !nonEmptyString(value.id)
123
+ || !nonEmptyString(value.header)
124
+ || !nonEmptyString(value.prompt)) {
125
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question');
126
+ }
127
+
128
+ const options = value.options ?? [];
129
+ const optionIds = options.map((option) => option?.id);
130
+ const recommendationOrder = value.recommendationOrder ?? [];
131
+ if (!Array.isArray(options)
132
+ || !options.every(validOption)
133
+ || new Set(optionIds).size !== optionIds.length
134
+ || !stringList(recommendationOrder)
135
+ || recommendationOrder.some((id) => !optionIds.includes(id))
136
+ || (value.multiSelect !== undefined && typeof value.multiSelect !== 'boolean')
137
+ || (value.secret !== undefined && typeof value.secret !== 'boolean')) {
138
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question', { questionId: value.id });
139
+ }
140
+
141
+ return deepFreeze({
142
+ id: value.id,
143
+ header: value.header,
144
+ prompt: value.prompt,
145
+ options: clone(options),
146
+ recommendationOrder: clone(recommendationOrder),
147
+ multiSelect: value.multiSelect ?? false,
148
+ secret: value.secret ?? false,
149
+ });
150
+ }
151
+
152
+ function orderedQuestionOptions(question) {
153
+ const byId = new Map(question.options.map((option) => [option.id, option]));
154
+ return [
155
+ ...question.recommendationOrder.map((id) => byId.get(id)),
156
+ ...question.options.filter((option) => !question.recommendationOrder.includes(option.id)),
157
+ ];
158
+ }
159
+
160
+ function answerMappings(batch, optionLabel = (_question, option) => option.label) {
161
+ return batch.map((question) => ({
162
+ questionId: question.id,
163
+ prompt: question.prompt,
164
+ multiSelect: question.multiSelect,
165
+ options: orderedQuestionOptions(question).map((option) => ({
166
+ id: option.id,
167
+ label: optionLabel(question, option),
168
+ })),
169
+ }));
170
+ }
171
+
172
+ function validateNativeOptionLabels(question, adapter, optionLabel = (_question, option) => option.label) {
173
+ const nativeOptions = orderedQuestionOptions(question).map((option) => ({
174
+ id: option.id,
175
+ label: optionLabel(question, option),
176
+ }));
177
+ const labels = new Map();
178
+ for (const option of nativeOptions) {
179
+ const existingId = labels.get(option.label);
180
+ if (existingId !== undefined) {
181
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question', {
182
+ reason: 'native-option-label-collision',
183
+ adapter,
184
+ questionId: question.id,
185
+ label: option.label,
186
+ optionIds: [existingId, option.id],
187
+ });
188
+ }
189
+ labels.set(option.label, option.id);
190
+ }
191
+ return nativeOptions;
192
+ }
193
+
194
+ function claudeMultiAnswerMappings(options) {
195
+ const mappings = [];
196
+ for (let mask = 1; mask < (1 << options.length); mask += 1) {
197
+ const subset = options.filter((_, index) => mask & (1 << index));
198
+ for (const candidate of permutations(subset)) {
199
+ mappings.push({
200
+ answer: candidate.map((option) => option.label).join(', '),
201
+ optionIds: candidate.map((option) => option.id),
202
+ });
203
+ }
204
+ }
205
+ return mappings;
206
+ }
207
+
208
+ function validateClaudeMultiAnswerFormats(question, nativeOptions) {
209
+ if (!question.multiSelect) return;
210
+ const formats = new Map();
211
+ for (const mapping of claudeMultiAnswerMappings(nativeOptions)) {
212
+ const existing = formats.get(mapping.answer);
213
+ if (existing !== undefined
214
+ && JSON.stringify(existing) !== JSON.stringify(mapping.optionIds)) {
215
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question', {
216
+ reason: 'native-answer-format-collision',
217
+ adapter: 'claude-code',
218
+ questionId: question.id,
219
+ answer: mapping.answer,
220
+ optionIdSets: [existing, mapping.optionIds],
221
+ });
222
+ }
223
+ formats.set(mapping.answer, mapping.optionIds);
224
+ }
225
+ }
226
+
227
+ function validateQuestionBatch(values) {
228
+ if (!Array.isArray(values) || values.length === 0) {
229
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question batch', {
230
+ reason: 'empty-question-batch',
231
+ });
232
+ }
233
+ const questions = values.map(defineQuestionSpec);
234
+ const duplicateId = questions.find((question, index) =>
235
+ questions.findIndex((candidate) => candidate.id === question.id) !== index);
236
+ if (duplicateId) {
237
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question batch', {
238
+ reason: 'duplicate-question-id',
239
+ questionId: duplicateId.id,
240
+ });
241
+ }
242
+ const duplicatePrompt = questions.find((question, index) =>
243
+ questions.findIndex((candidate) => candidate.prompt === question.prompt) !== index);
244
+ if (duplicatePrompt) {
245
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question batch', {
246
+ reason: 'duplicate-question-prompt',
247
+ questionId: duplicatePrompt.id,
248
+ });
249
+ }
250
+ return questions;
251
+ }
252
+
253
+ function validatePiQuestion(question) {
254
+ if (question.secret) {
255
+ throw new UnsupportedQuestionError('secret-input', { adapter: 'pi', questionId: question.id });
256
+ }
257
+ if (question.header.length > 16) {
258
+ throw new UnsupportedQuestionError('header-too-long', {
259
+ adapter: 'pi',
260
+ questionId: question.id,
261
+ maximum: 16,
262
+ });
263
+ }
264
+ if (question.options.length < 2 || question.options.length > 4) {
265
+ throw new UnsupportedQuestionError('option-count', {
266
+ adapter: 'pi',
267
+ questionId: question.id,
268
+ minimum: 2,
269
+ maximum: 4,
270
+ });
271
+ }
272
+ const duplicateLabel = question.options.find((option, index) =>
273
+ question.options.findIndex((candidate) => candidate.label === option.label) !== index);
274
+ if (duplicateLabel) {
275
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question', {
276
+ reason: 'duplicate-option-label',
277
+ questionId: question.id,
278
+ label: duplicateLabel.label,
279
+ });
280
+ }
281
+ validateNativeOptionLabels(question, 'pi');
282
+ for (const option of question.options) {
283
+ if (['Other', 'Type something.', 'Next'].includes(option.label)) {
284
+ throw new UnsupportedQuestionError('reserved-option-label', {
285
+ adapter: 'pi',
286
+ questionId: question.id,
287
+ optionId: option.id,
288
+ label: option.label,
289
+ });
290
+ }
291
+ if (option.description === undefined) {
292
+ throw new UnsupportedQuestionError('option-description-required', {
293
+ adapter: 'pi',
294
+ questionId: question.id,
295
+ optionId: option.id,
296
+ });
297
+ }
298
+ if (option.label.length > 60) {
299
+ throw new UnsupportedQuestionError('option-label-too-long', {
300
+ adapter: 'pi',
301
+ questionId: question.id,
302
+ optionId: option.id,
303
+ maximum: 60,
304
+ });
305
+ }
306
+ }
307
+ }
308
+
309
+ function chunk(values, size) {
310
+ const batches = [];
311
+ for (let index = 0; index < values.length; index += size) {
312
+ batches.push(values.slice(index, index + size));
313
+ }
314
+ return batches;
315
+ }
316
+
317
+ function batchingResult(calls) {
318
+ return {
319
+ required: calls.length > 1,
320
+ reason: calls.length > 1 ? 'adapter-capacity' : null,
321
+ callCount: calls.length,
322
+ };
323
+ }
324
+
325
+ function planPiQuestions(questions) {
326
+ for (const question of questions) validatePiQuestion(question);
327
+ const calls = chunk(questions, 4).map((batch, index) => ({
328
+ index,
329
+ questionIds: batch.map((question) => question.id),
330
+ answerMappings: answerMappings(batch),
331
+ payload: {
332
+ questions: batch.map((question) => ({
333
+ question: question.prompt,
334
+ header: question.header,
335
+ options: orderedQuestionOptions(question).map((option) => ({
336
+ label: option.label,
337
+ description: option.description,
338
+ })),
339
+ multiSelect: question.multiSelect,
340
+ })),
341
+ },
342
+ }));
343
+ return deepFreeze({
344
+ kind: 'native',
345
+ adapter: 'pi',
346
+ toolName: 'ask_user_question',
347
+ capacity: 4,
348
+ requiresMultipleCalls: calls.length > 1,
349
+ batching: batchingResult(calls),
350
+ calls,
351
+ });
352
+ }
353
+
354
+ function validateNativeOptions(question, adapter, maximum) {
355
+ if (question.options.length < 2 || question.options.length > maximum) {
356
+ throw new UnsupportedQuestionError('option-count', {
357
+ adapter,
358
+ questionId: question.id,
359
+ minimum: 2,
360
+ maximum,
361
+ });
362
+ }
363
+ const duplicateLabel = question.options.find((option, index) =>
364
+ question.options.findIndex((candidate) => candidate.label === option.label) !== index);
365
+ if (duplicateLabel) {
366
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION, 'question', {
367
+ reason: 'duplicate-option-label',
368
+ questionId: question.id,
369
+ label: duplicateLabel.label,
370
+ });
371
+ }
372
+ const missingDescription = question.options.find((option) => option.description === undefined);
373
+ if (missingDescription) {
374
+ throw new UnsupportedQuestionError('option-description-required', {
375
+ adapter,
376
+ questionId: question.id,
377
+ optionId: missingDescription.id,
378
+ });
379
+ }
380
+ }
381
+
382
+ function codexOptionLabel(question, option) {
383
+ return question.recommendationOrder[0] === option.id
384
+ ? `${option.label} (Recommended)`
385
+ : option.label;
386
+ }
387
+
388
+ function planCodexQuestions(questions) {
389
+ for (const question of questions) {
390
+ if (question.secret) {
391
+ throw new UnsupportedQuestionError('secret-input', {
392
+ adapter: 'codex',
393
+ questionId: question.id,
394
+ });
395
+ }
396
+ if (question.multiSelect) {
397
+ throw new UnsupportedQuestionError('multi-select', {
398
+ adapter: 'codex',
399
+ questionId: question.id,
400
+ });
401
+ }
402
+ if (!/^[a-z][a-z0-9_]*$/.test(question.id)) {
403
+ throw new UnsupportedQuestionError('invalid-question-id', {
404
+ adapter: 'codex',
405
+ questionId: question.id,
406
+ format: 'snake_case',
407
+ });
408
+ }
409
+ if (question.header.length > 12) {
410
+ throw new UnsupportedQuestionError('header-too-long', {
411
+ adapter: 'codex',
412
+ questionId: question.id,
413
+ maximum: 12,
414
+ });
415
+ }
416
+ validateNativeOptions(question, 'codex', 3);
417
+ validateNativeOptionLabels(question, 'codex', codexOptionLabel);
418
+ }
419
+ const calls = chunk(questions, 3).map((batch, index) => ({
420
+ index,
421
+ questionIds: batch.map((question) => question.id),
422
+ answerMappings: answerMappings(batch, codexOptionLabel),
423
+ payload: {
424
+ questions: batch.map((question) => ({
425
+ id: question.id,
426
+ header: question.header,
427
+ question: question.prompt,
428
+ options: orderedQuestionOptions(question).map((option) => ({
429
+ label: codexOptionLabel(question, option),
430
+ description: option.description,
431
+ })),
432
+ })),
433
+ },
434
+ }));
435
+ return deepFreeze({
436
+ kind: 'native',
437
+ adapter: 'codex',
438
+ toolName: 'request_user_input',
439
+ capacity: 3,
440
+ requiresMultipleCalls: calls.length > 1,
441
+ batching: batchingResult(calls),
442
+ calls,
443
+ });
444
+ }
445
+
446
+ function planClaudeQuestions(questions) {
447
+ for (const question of questions) {
448
+ if (question.secret) {
449
+ throw new UnsupportedQuestionError('secret-input', {
450
+ adapter: 'claude-code',
451
+ questionId: question.id,
452
+ });
453
+ }
454
+ if (question.header.length > 12) {
455
+ throw new UnsupportedQuestionError('header-too-long', {
456
+ adapter: 'claude-code',
457
+ questionId: question.id,
458
+ maximum: 12,
459
+ });
460
+ }
461
+ validateNativeOptions(question, 'claude-code', 4);
462
+ const nativeOptions = validateNativeOptionLabels(question, 'claude-code');
463
+ validateClaudeMultiAnswerFormats(question, nativeOptions);
464
+ }
465
+ const calls = chunk(questions, 4).map((batch, index) => ({
466
+ index,
467
+ questionIds: batch.map((question) => question.id),
468
+ answerMappings: answerMappings(batch),
469
+ payload: {
470
+ questions: batch.map((question) => ({
471
+ question: question.prompt,
472
+ header: question.header,
473
+ options: orderedQuestionOptions(question).map((option) => ({
474
+ label: option.label,
475
+ description: option.description,
476
+ })),
477
+ multiSelect: question.multiSelect,
478
+ })),
479
+ },
480
+ }));
481
+ return deepFreeze({
482
+ kind: 'native',
483
+ adapter: 'claude-code',
484
+ toolName: 'AskUserQuestion',
485
+ capacity: 4,
486
+ requiresMultipleCalls: calls.length > 1,
487
+ batching: batchingResult(calls),
488
+ calls,
489
+ });
490
+ }
491
+
492
+ function planQuestionFallback(capabilities, questions) {
493
+ const secret = questions.find((question) => question.secret);
494
+ if (secret) {
495
+ throw new UnsupportedQuestionError('secret-input', {
496
+ adapter: null,
497
+ questionId: secret.id,
498
+ });
499
+ }
500
+ const multiSelect = questions.find((question) => question.multiSelect);
501
+ if (multiSelect) {
502
+ throw new UnsupportedQuestionError('multi-select', {
503
+ adapter: null,
504
+ questionId: multiSelect.id,
505
+ });
506
+ }
507
+ const hasOptions = questions.some((question) => question.options.length > 0);
508
+ const oneFreeTextQuestion = questions.length === 1 && !hasOptions;
509
+ return deepFreeze({
510
+ kind: 'fallback',
511
+ adapter: null,
512
+ reason: 'no-supported-native-question-tool',
513
+ decision: oneFreeTextQuestion
514
+ ? 'concise-free-text'
515
+ : 'textual-multiple-choice-forbidden',
516
+ freeText: oneFreeTextQuestion
517
+ ? {
518
+ allowed: true,
519
+ questionId: questions[0].id,
520
+ prompt: questions[0].prompt,
521
+ }
522
+ : {
523
+ allowed: false,
524
+ reason: hasOptions ? 'logical-question-has-options' : 'multiple-questions',
525
+ },
526
+ textualMultipleChoice: {
527
+ allowed: false,
528
+ reason: QUESTION_FALLBACK_POLICY.noNativeQuestionTool.multipleChoice,
529
+ },
530
+ availableTools: clone(capabilities.nativeTools),
531
+ });
532
+ }
533
+
534
+ export function planStructuredQuestions(capabilitiesValue, questionValues) {
535
+ const capabilities = defineCurrentTurnCapabilities(capabilitiesValue);
536
+ const questions = validateQuestionBatch(questionValues);
537
+ if (capabilities.nativeTools.includes('ask_user_question')) {
538
+ return planPiQuestions(questions);
539
+ }
540
+ if (capabilities.nativeTools.includes('request_user_input')) {
541
+ return planCodexQuestions(questions);
542
+ }
543
+ if (capabilities.nativeTools.includes('AskUserQuestion')) {
544
+ return planClaudeQuestions(questions);
545
+ }
546
+ return planQuestionFallback(capabilities, questions);
547
+ }
548
+
549
+ function invalidAnswers(reason, details = {}) {
550
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_ANSWERS, 'question answers', {
551
+ reason,
552
+ ...details,
553
+ });
554
+ }
555
+
556
+ function mappedOption(mapping, label) {
557
+ const matches = mapping.options.filter((option) => option.label === label);
558
+ if (matches.length > 1) {
559
+ invalidAnswers('ambiguous-option-label', {
560
+ questionId: mapping.questionId,
561
+ answer: label,
562
+ optionIds: matches.map((option) => option.id),
563
+ });
564
+ }
565
+ return matches[0];
566
+ }
567
+
568
+ function mapSingleAnswer(mapping, value, { custom = true } = {}) {
569
+ if (!nonEmptyString(value)) invalidAnswers('empty-answer', { questionId: mapping.questionId });
570
+ const option = mappedOption(mapping, value);
571
+ if (option) return option.id;
572
+ if (custom) return value;
573
+ invalidAnswers('unknown-option-label', { questionId: mapping.questionId, answer: value });
574
+ }
575
+
576
+ function requireCompleteAnswers(call, answers) {
577
+ const missingQuestionIds = call.answerMappings
578
+ .map((mapping) => mapping.questionId)
579
+ .filter((questionId) => !Object.hasOwn(answers, questionId));
580
+ if (missingQuestionIds.length > 0) {
581
+ invalidAnswers('incomplete-native-response', {
582
+ callIndex: call.index,
583
+ missingQuestionIds,
584
+ });
585
+ }
586
+ return answers;
587
+ }
588
+
589
+ function normalizePiResponse(call, response) {
590
+ if (!isRecord(response) || !isRecord(response.details)
591
+ || !Array.isArray(response.details.answers)
592
+ || response.details.cancelled !== false) {
593
+ invalidAnswers('malformed-pi-response', { callIndex: call.index });
594
+ }
595
+ const answers = {};
596
+ const seenIndexes = new Set();
597
+ for (const nativeAnswer of response.details.answers) {
598
+ if (!isRecord(nativeAnswer)
599
+ || !Number.isInteger(nativeAnswer.questionIndex)
600
+ || seenIndexes.has(nativeAnswer.questionIndex)) {
601
+ invalidAnswers('malformed-pi-answer', { callIndex: call.index });
602
+ }
603
+ const mapping = call.answerMappings[nativeAnswer.questionIndex];
604
+ if (!mapping || nativeAnswer.question !== mapping.prompt) {
605
+ invalidAnswers('unknown-pi-question', { callIndex: call.index });
606
+ }
607
+ seenIndexes.add(nativeAnswer.questionIndex);
608
+ if (nativeAnswer.kind === 'multi') {
609
+ if (!mapping.multiSelect
610
+ || !Array.isArray(nativeAnswer.selected)
611
+ || nativeAnswer.selected.length === 0
612
+ || !nativeAnswer.selected.every(nonEmptyString)) {
613
+ invalidAnswers('malformed-pi-multi-answer', { questionId: mapping.questionId });
614
+ }
615
+ answers[mapping.questionId] = nativeAnswer.selected.map((label) =>
616
+ mapSingleAnswer(mapping, label, { custom: false }));
617
+ } else if (nativeAnswer.kind === 'option') {
618
+ answers[mapping.questionId] = [
619
+ mapSingleAnswer(mapping, nativeAnswer.answer, { custom: false }),
620
+ ];
621
+ } else if (nativeAnswer.kind === 'custom') {
622
+ if (!nonEmptyString(nativeAnswer.answer)) {
623
+ invalidAnswers('empty-answer', { questionId: mapping.questionId });
624
+ }
625
+ answers[mapping.questionId] = [nativeAnswer.answer];
626
+ } else {
627
+ invalidAnswers('unknown-pi-answer-kind', { questionId: mapping.questionId });
628
+ }
629
+ }
630
+ return requireCompleteAnswers(call, answers);
631
+ }
632
+
633
+ function normalizeCodexResponse(call, response) {
634
+ if (!hasExactFields(response, ['answers']) || !isRecord(response.answers)) {
635
+ invalidAnswers('malformed-codex-response', { callIndex: call.index });
636
+ }
637
+ const mappings = new Map(call.answerMappings.map((mapping) => [mapping.questionId, mapping]));
638
+ const answers = {};
639
+ for (const [questionId, nativeAnswer] of Object.entries(response.answers)) {
640
+ const mapping = mappings.get(questionId);
641
+ if (!mapping || !hasExactFields(nativeAnswer, ['answers'])
642
+ || !stringList(nativeAnswer.answers, { allowEmpty: false })
643
+ || nativeAnswer.answers.length !== 1) {
644
+ invalidAnswers('malformed-codex-answer', { callIndex: call.index, questionId });
645
+ }
646
+ answers[questionId] = nativeAnswer.answers.map((value) => mapSingleAnswer(mapping, value));
647
+ }
648
+ return requireCompleteAnswers(call, answers);
649
+ }
650
+
651
+ function permutations(values) {
652
+ if (values.length === 0) return [[]];
653
+ return values.flatMap((value, index) =>
654
+ permutations(values.filter((_, candidateIndex) => candidateIndex !== index))
655
+ .map((rest) => [value, ...rest]));
656
+ }
657
+
658
+ function parseClaudeMultiAnswer(mapping, value) {
659
+ const matches = claudeMultiAnswerMappings(mapping.options)
660
+ .filter((candidate) => candidate.answer === value)
661
+ .map((candidate) => candidate.optionIds);
662
+ const unique = [...new Map(matches.map((match) => [JSON.stringify(match), match])).values()];
663
+ if (unique.length > 1) {
664
+ invalidAnswers('ambiguous-claude-multi-answer', { questionId: mapping.questionId });
665
+ }
666
+ return unique[0] ?? [value];
667
+ }
668
+
669
+ function normalizeClaudeResponse(call, response) {
670
+ if (!isRecord(response) || !isRecord(response.answers)) {
671
+ invalidAnswers('malformed-claude-response', { callIndex: call.index });
672
+ }
673
+ const mappings = new Map(call.answerMappings.map((mapping) => [mapping.prompt, mapping]));
674
+ const answers = {};
675
+ for (const [prompt, value] of Object.entries(response.answers)) {
676
+ const mapping = mappings.get(prompt);
677
+ if (!mapping || !nonEmptyString(value)) {
678
+ invalidAnswers('malformed-claude-answer', { callIndex: call.index, prompt });
679
+ }
680
+ answers[mapping.questionId] = mapping.multiSelect
681
+ ? parseClaudeMultiAnswer(mapping, value)
682
+ : [mapSingleAnswer(mapping, value)];
683
+ }
684
+ return requireCompleteAnswers(call, answers);
685
+ }
686
+
687
+ function responseCancelled(adapter, response) {
688
+ if (isRecord(response) && response.cancelled === true) return true;
689
+ return adapter === 'pi'
690
+ && isRecord(response)
691
+ && isRecord(response.details)
692
+ && response.details.cancelled === true;
693
+ }
694
+
695
+ export function normalizeQuestionResponses(plan, nativeResponses) {
696
+ if (!isRecord(plan) || plan.kind !== 'native'
697
+ || !['pi', 'codex', 'claude-code'].includes(plan.adapter)
698
+ || !Array.isArray(plan.calls)) {
699
+ invalidAnswers('invalid-question-plan');
700
+ }
701
+ if (!Array.isArray(nativeResponses) || nativeResponses.length !== plan.calls.length) {
702
+ invalidAnswers('response-count', {
703
+ expected: plan.calls.length,
704
+ actual: Array.isArray(nativeResponses) ? nativeResponses.length : null,
705
+ });
706
+ }
707
+ if (nativeResponses.some((response) => responseCancelled(plan.adapter, response))) {
708
+ return defineQuestionAnswers({});
709
+ }
710
+ const answers = {};
711
+ for (let index = 0; index < plan.calls.length; index += 1) {
712
+ const call = plan.calls[index];
713
+ const response = nativeResponses[index];
714
+ const normalized = plan.adapter === 'pi'
715
+ ? normalizePiResponse(call, response)
716
+ : plan.adapter === 'codex'
717
+ ? normalizeCodexResponse(call, response)
718
+ : normalizeClaudeResponse(call, response);
719
+ for (const [questionId, values] of Object.entries(normalized)) {
720
+ if (Object.hasOwn(answers, questionId)) {
721
+ invalidAnswers('duplicate-question-answer', { questionId });
722
+ }
723
+ answers[questionId] = values;
724
+ }
725
+ }
726
+ return defineQuestionAnswers(answers);
727
+ }
728
+
729
+ export function defineQuestionAnswers(value) {
730
+ if (!isRecord(value)
731
+ || Object.entries(value).some(([questionId, answers]) =>
732
+ !nonEmptyString(questionId) || !stringList(answers, { allowEmpty: false }))) {
733
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_ANSWERS, 'question answers');
734
+ }
735
+ return deepFreeze(clone(value));
736
+ }
737
+
738
+ function validModel(model) {
739
+ return hasExactFields(model, ['id', 'sources'])
740
+ && nonEmptyString(model.id)
741
+ && stringList(model.sources, { allowEmpty: false });
742
+ }
743
+
744
+ export function defineModelAvailability(value) {
745
+ if (!hasExactFields(value, ['harness', 'completeness', 'models'])
746
+ || !HARNESSES.has(value.harness)
747
+ || !COMPLETENESS.has(value.completeness)
748
+ || !Array.isArray(value.models)
749
+ || !value.models.every(validModel)
750
+ || new Set(value.models.map((model) => model.id)).size !== value.models.length) {
751
+ invalid(HARNESS_RUNTIME_ERROR_CODES.INVALID_MODEL_AVAILABILITY, 'model availability');
752
+ }
753
+
754
+ const runtimeEnumerated = value.models.some((model) =>
755
+ model.sources.some((source) => RUNTIME_MODEL_SOURCES.has(source)));
756
+ if (value.completeness === 'full'
757
+ && ['codex', 'claude-code'].includes(value.harness)
758
+ && !runtimeEnumerated) {
759
+ invalid(
760
+ HARNESS_RUNTIME_ERROR_CODES.INVALID_MODEL_AVAILABILITY,
761
+ 'model availability',
762
+ { reason: 'static-config-is-not-complete', harness: value.harness },
763
+ );
764
+ }
765
+
766
+ return deepFreeze(clone(value));
767
+ }