@rsaglobaltech/specgate 0.8.1

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 (494) hide show
  1. package/CHANGELOG.md +1016 -0
  2. package/README.md +148 -0
  3. package/bin/specgate.js +2 -0
  4. package/bin/specgate.ts +383 -0
  5. package/dist/bin/specgate.js +342 -0
  6. package/dist/bin/specgate.js.map +1 -0
  7. package/dist/packages/core/src/application/AddRequirementUseCase.js +24 -0
  8. package/dist/packages/core/src/application/AddRequirementUseCase.js.map +1 -0
  9. package/dist/packages/core/src/application/ArchiveChangeUseCase.js +185 -0
  10. package/dist/packages/core/src/application/ArchiveChangeUseCase.js.map +1 -0
  11. package/dist/packages/core/src/application/CheckAgainstLockUseCase.js +134 -0
  12. package/dist/packages/core/src/application/CheckAgainstLockUseCase.js.map +1 -0
  13. package/dist/packages/core/src/application/GenerateAgentPromptUseCase.js +25 -0
  14. package/dist/packages/core/src/application/GenerateAgentPromptUseCase.js.map +1 -0
  15. package/dist/packages/core/src/application/GeneratePlanUseCase.js +135 -0
  16. package/dist/packages/core/src/application/GeneratePlanUseCase.js.map +1 -0
  17. package/dist/packages/core/src/application/LinkRequirementUseCase.js +25 -0
  18. package/dist/packages/core/src/application/LinkRequirementUseCase.js.map +1 -0
  19. package/dist/packages/core/src/application/RemovePackUseCase.js +28 -0
  20. package/dist/packages/core/src/application/RemovePackUseCase.js.map +1 -0
  21. package/dist/packages/core/src/application/UpdateRequirementStatusUseCase.js +37 -0
  22. package/dist/packages/core/src/application/UpdateRequirementStatusUseCase.js.map +1 -0
  23. package/dist/packages/core/src/application/ValidateChangeUseCase.js +86 -0
  24. package/dist/packages/core/src/application/ValidateChangeUseCase.js.map +1 -0
  25. package/dist/packages/core/src/application/ValidateProjectUseCase.js +101 -0
  26. package/dist/packages/core/src/application/ValidateProjectUseCase.js.map +1 -0
  27. package/dist/packages/core/src/application/ports/IDomainPackRepository.js +3 -0
  28. package/dist/packages/core/src/application/ports/IDomainPackRepository.js.map +1 -0
  29. package/dist/packages/core/src/application/ports/IHarnessConfigRepository.js +3 -0
  30. package/dist/packages/core/src/application/ports/IHarnessConfigRepository.js.map +1 -0
  31. package/dist/packages/core/src/application/ports/ILockfileRepository.js +3 -0
  32. package/dist/packages/core/src/application/ports/ILockfileRepository.js.map +1 -0
  33. package/dist/packages/core/src/application/ports/IManifestRepository.js +3 -0
  34. package/dist/packages/core/src/application/ports/IManifestRepository.js.map +1 -0
  35. package/dist/packages/core/src/application/ports/IProjectRepository.js +3 -0
  36. package/dist/packages/core/src/application/ports/IProjectRepository.js.map +1 -0
  37. package/dist/packages/core/src/application/ports/IRequirementGraphRepository.js +3 -0
  38. package/dist/packages/core/src/application/ports/IRequirementGraphRepository.js.map +1 -0
  39. package/dist/packages/core/src/application/ports/ITraceabilityRepository.js +3 -0
  40. package/dist/packages/core/src/application/ports/ITraceabilityRepository.js.map +1 -0
  41. package/dist/packages/core/src/domain/AgentPrompt.js +79 -0
  42. package/dist/packages/core/src/domain/AgentPrompt.js.map +1 -0
  43. package/dist/packages/core/src/domain/ArchivePlan.js +26 -0
  44. package/dist/packages/core/src/domain/ArchivePlan.js.map +1 -0
  45. package/dist/packages/core/src/domain/AuthoringScope.js +48 -0
  46. package/dist/packages/core/src/domain/AuthoringScope.js.map +1 -0
  47. package/dist/packages/core/src/domain/ChangeTemplates.js +133 -0
  48. package/dist/packages/core/src/domain/ChangeTemplates.js.map +1 -0
  49. package/dist/packages/core/src/domain/CucumberMessages.js +256 -0
  50. package/dist/packages/core/src/domain/CucumberMessages.js.map +1 -0
  51. package/dist/packages/core/src/domain/DeclaredArtifacts.js +117 -0
  52. package/dist/packages/core/src/domain/DeclaredArtifacts.js.map +1 -0
  53. package/dist/packages/core/src/domain/DeltaSpec.js +219 -0
  54. package/dist/packages/core/src/domain/DeltaSpec.js.map +1 -0
  55. package/dist/packages/core/src/domain/Diagnostic.js +75 -0
  56. package/dist/packages/core/src/domain/Diagnostic.js.map +1 -0
  57. package/dist/packages/core/src/domain/DomainPack.js +62 -0
  58. package/dist/packages/core/src/domain/DomainPack.js.map +1 -0
  59. package/dist/packages/core/src/domain/EmptyAttempt.js +60 -0
  60. package/dist/packages/core/src/domain/EmptyAttempt.js.map +1 -0
  61. package/dist/packages/core/src/domain/FileChangeSet.js +37 -0
  62. package/dist/packages/core/src/domain/FileChangeSet.js.map +1 -0
  63. package/dist/packages/core/src/domain/Gherkin.js +272 -0
  64. package/dist/packages/core/src/domain/Gherkin.js.map +1 -0
  65. package/dist/packages/core/src/domain/GherkinDialects.js +97 -0
  66. package/dist/packages/core/src/domain/GherkinDialects.js.map +1 -0
  67. package/dist/packages/core/src/domain/GherkinQuality.js +160 -0
  68. package/dist/packages/core/src/domain/GherkinQuality.js.map +1 -0
  69. package/dist/packages/core/src/domain/GherkinTags.js +119 -0
  70. package/dist/packages/core/src/domain/GherkinTags.js.map +1 -0
  71. package/dist/packages/core/src/domain/GitSafety.js +77 -0
  72. package/dist/packages/core/src/domain/GitSafety.js.map +1 -0
  73. package/dist/packages/core/src/domain/HarnessConfig.js +58 -0
  74. package/dist/packages/core/src/domain/HarnessConfig.js.map +1 -0
  75. package/dist/packages/core/src/domain/HarnessReport.js +162 -0
  76. package/dist/packages/core/src/domain/HarnessReport.js.map +1 -0
  77. package/dist/packages/core/src/domain/HarnessRun.js +154 -0
  78. package/dist/packages/core/src/domain/HarnessRun.js.map +1 -0
  79. package/dist/packages/core/src/domain/InboundChange.js +127 -0
  80. package/dist/packages/core/src/domain/InboundChange.js.map +1 -0
  81. package/dist/packages/core/src/domain/Language.js +112 -0
  82. package/dist/packages/core/src/domain/Language.js.map +1 -0
  83. package/dist/packages/core/src/domain/Lockfile.js +64 -0
  84. package/dist/packages/core/src/domain/Lockfile.js.map +1 -0
  85. package/dist/packages/core/src/domain/PackContribution.js +106 -0
  86. package/dist/packages/core/src/domain/PackContribution.js.map +1 -0
  87. package/dist/packages/core/src/domain/PackDelta.js +298 -0
  88. package/dist/packages/core/src/domain/PackDelta.js.map +1 -0
  89. package/dist/packages/core/src/domain/PackSpec.js +481 -0
  90. package/dist/packages/core/src/domain/PackSpec.js.map +1 -0
  91. package/dist/packages/core/src/domain/ProfileMatch.js +87 -0
  92. package/dist/packages/core/src/domain/ProfileMatch.js.map +1 -0
  93. package/dist/packages/core/src/domain/Reconciliation.js +72 -0
  94. package/dist/packages/core/src/domain/Reconciliation.js.map +1 -0
  95. package/dist/packages/core/src/domain/RequirementGraph.js +197 -0
  96. package/dist/packages/core/src/domain/RequirementGraph.js.map +1 -0
  97. package/dist/packages/core/src/domain/RequirementPlan.js +85 -0
  98. package/dist/packages/core/src/domain/RequirementPlan.js.map +1 -0
  99. package/dist/packages/core/src/domain/RequirementReadiness.js +115 -0
  100. package/dist/packages/core/src/domain/RequirementReadiness.js.map +1 -0
  101. package/dist/packages/core/src/domain/RequirementSyntax.js +91 -0
  102. package/dist/packages/core/src/domain/RequirementSyntax.js.map +1 -0
  103. package/dist/packages/core/src/domain/ResumeState.js +115 -0
  104. package/dist/packages/core/src/domain/ResumeState.js.map +1 -0
  105. package/dist/packages/core/src/domain/RunBudget.js +103 -0
  106. package/dist/packages/core/src/domain/RunBudget.js.map +1 -0
  107. package/dist/packages/core/src/domain/SpecDiff.js +48 -0
  108. package/dist/packages/core/src/domain/SpecDiff.js.map +1 -0
  109. package/dist/packages/core/src/domain/SpecParser.js +406 -0
  110. package/dist/packages/core/src/domain/SpecParser.js.map +1 -0
  111. package/dist/packages/core/src/domain/SpecopsManifest.js +90 -0
  112. package/dist/packages/core/src/domain/SpecopsManifest.js.map +1 -0
  113. package/dist/packages/core/src/domain/TraceabilityFormat.js +317 -0
  114. package/dist/packages/core/src/domain/TraceabilityFormat.js.map +1 -0
  115. package/dist/packages/core/src/domain/TraceabilityMatrix.js +200 -0
  116. package/dist/packages/core/src/domain/TraceabilityMatrix.js.map +1 -0
  117. package/dist/packages/core/src/domain/TraceabilityMerge.js +180 -0
  118. package/dist/packages/core/src/domain/TraceabilityMerge.js.map +1 -0
  119. package/dist/packages/core/src/domain/ValidationReport.js +53 -0
  120. package/dist/packages/core/src/domain/ValidationReport.js.map +1 -0
  121. package/dist/packages/core/src/domain/ValueAnnotations.js +138 -0
  122. package/dist/packages/core/src/domain/ValueAnnotations.js.map +1 -0
  123. package/dist/packages/core/src/domain/WriteScope.js +155 -0
  124. package/dist/packages/core/src/domain/WriteScope.js.map +1 -0
  125. package/dist/packages/core/src/domain/YamlLite.js +226 -0
  126. package/dist/packages/core/src/domain/YamlLite.js.map +1 -0
  127. package/dist/packages/core/src/index.js +120 -0
  128. package/dist/packages/core/src/index.js.map +1 -0
  129. package/dist/packages/core/src/infrastructure/ChangeWorkspace.js +276 -0
  130. package/dist/packages/core/src/infrastructure/ChangeWorkspace.js.map +1 -0
  131. package/dist/packages/core/src/infrastructure/ConsoleReporter.js +19 -0
  132. package/dist/packages/core/src/infrastructure/ConsoleReporter.js.map +1 -0
  133. package/dist/packages/core/src/infrastructure/DirectorySnapshot.js +106 -0
  134. package/dist/packages/core/src/infrastructure/DirectorySnapshot.js.map +1 -0
  135. package/dist/packages/core/src/infrastructure/DiskDomainPackRepository.js +57 -0
  136. package/dist/packages/core/src/infrastructure/DiskDomainPackRepository.js.map +1 -0
  137. package/dist/packages/core/src/infrastructure/DiskHarnessConfigRepository.js +58 -0
  138. package/dist/packages/core/src/infrastructure/DiskHarnessConfigRepository.js.map +1 -0
  139. package/dist/packages/core/src/infrastructure/DiskLanguageRepository.js +69 -0
  140. package/dist/packages/core/src/infrastructure/DiskLanguageRepository.js.map +1 -0
  141. package/dist/packages/core/src/infrastructure/DiskLockfileRepository.js +64 -0
  142. package/dist/packages/core/src/infrastructure/DiskLockfileRepository.js.map +1 -0
  143. package/dist/packages/core/src/infrastructure/DiskManifestRepository.js +88 -0
  144. package/dist/packages/core/src/infrastructure/DiskManifestRepository.js.map +1 -0
  145. package/dist/packages/core/src/infrastructure/DiskPackDeltaRepository.js +138 -0
  146. package/dist/packages/core/src/infrastructure/DiskPackDeltaRepository.js.map +1 -0
  147. package/dist/packages/core/src/infrastructure/DiskPackRepository.js +130 -0
  148. package/dist/packages/core/src/infrastructure/DiskPackRepository.js.map +1 -0
  149. package/dist/packages/core/src/infrastructure/DiskProjectRepository.js +127 -0
  150. package/dist/packages/core/src/infrastructure/DiskProjectRepository.js.map +1 -0
  151. package/dist/packages/core/src/infrastructure/DiskRequirementGraphRepository.js +124 -0
  152. package/dist/packages/core/src/infrastructure/DiskRequirementGraphRepository.js.map +1 -0
  153. package/dist/packages/core/src/infrastructure/DiskTraceabilityRepository.js +53 -0
  154. package/dist/packages/core/src/infrastructure/DiskTraceabilityRepository.js.map +1 -0
  155. package/dist/packages/core/src/infrastructure/GitContributionStager.js +99 -0
  156. package/dist/packages/core/src/infrastructure/GitContributionStager.js.map +1 -0
  157. package/dist/packages/core/src/infrastructure/GitMergeDriver.js +103 -0
  158. package/dist/packages/core/src/infrastructure/GitMergeDriver.js.map +1 -0
  159. package/dist/packages/core/src/infrastructure/HarnessConfigFile.js +348 -0
  160. package/dist/packages/core/src/infrastructure/HarnessConfigFile.js.map +1 -0
  161. package/dist/packages/core/src/infrastructure/PackChangeDeposit.js +106 -0
  162. package/dist/packages/core/src/infrastructure/PackChangeDeposit.js.map +1 -0
  163. package/dist/packages/core/src/infrastructure/RemotePackResolver.js +181 -0
  164. package/dist/packages/core/src/infrastructure/RemotePackResolver.js.map +1 -0
  165. package/dist/packages/core/src/infrastructure/SpecopsConfigFile.js +94 -0
  166. package/dist/packages/core/src/infrastructure/SpecopsConfigFile.js.map +1 -0
  167. package/dist/packages/core/test/unit/authoring-scope.test.js +102 -0
  168. package/dist/packages/core/test/unit/authoring-scope.test.js.map +1 -0
  169. package/dist/packages/core/test/unit/change-templates.test.js +96 -0
  170. package/dist/packages/core/test/unit/change-templates.test.js.map +1 -0
  171. package/dist/packages/core/test/unit/cucumber-messages.test.js +232 -0
  172. package/dist/packages/core/test/unit/cucumber-messages.test.js.map +1 -0
  173. package/dist/packages/core/test/unit/declared-artifacts.test.js +124 -0
  174. package/dist/packages/core/test/unit/declared-artifacts.test.js.map +1 -0
  175. package/dist/packages/core/test/unit/empty-attempt.test.js +79 -0
  176. package/dist/packages/core/test/unit/empty-attempt.test.js.map +1 -0
  177. package/dist/packages/core/test/unit/gherkin-dialects.test.js +115 -0
  178. package/dist/packages/core/test/unit/gherkin-dialects.test.js.map +1 -0
  179. package/dist/packages/core/test/unit/gherkin-keyword-case.test.js +110 -0
  180. package/dist/packages/core/test/unit/gherkin-keyword-case.test.js.map +1 -0
  181. package/dist/packages/core/test/unit/gherkin-quality.test.js +151 -0
  182. package/dist/packages/core/test/unit/gherkin-quality.test.js.map +1 -0
  183. package/dist/packages/core/test/unit/gherkin-tags.test.js +127 -0
  184. package/dist/packages/core/test/unit/gherkin-tags.test.js.map +1 -0
  185. package/dist/packages/core/test/unit/git-safety.test.js +104 -0
  186. package/dist/packages/core/test/unit/git-safety.test.js.map +1 -0
  187. package/dist/packages/core/test/unit/harness-report.test.js +192 -0
  188. package/dist/packages/core/test/unit/harness-report.test.js.map +1 -0
  189. package/dist/packages/core/test/unit/harness-roles.test.js +86 -0
  190. package/dist/packages/core/test/unit/harness-roles.test.js.map +1 -0
  191. package/dist/packages/core/test/unit/inbound-change.test.js +145 -0
  192. package/dist/packages/core/test/unit/inbound-change.test.js.map +1 -0
  193. package/dist/packages/core/test/unit/matrix-dependencies.test.js +100 -0
  194. package/dist/packages/core/test/unit/matrix-dependencies.test.js.map +1 -0
  195. package/dist/packages/core/test/unit/profile-match.test.js +115 -0
  196. package/dist/packages/core/test/unit/profile-match.test.js.map +1 -0
  197. package/dist/packages/core/test/unit/reconciliation.test.js +112 -0
  198. package/dist/packages/core/test/unit/reconciliation.test.js.map +1 -0
  199. package/dist/packages/core/test/unit/requirement-readiness.test.js +161 -0
  200. package/dist/packages/core/test/unit/requirement-readiness.test.js.map +1 -0
  201. package/dist/packages/core/test/unit/resume-state.test.js +124 -0
  202. package/dist/packages/core/test/unit/resume-state.test.js.map +1 -0
  203. package/dist/packages/core/test/unit/run-budget.test.js +113 -0
  204. package/dist/packages/core/test/unit/run-budget.test.js.map +1 -0
  205. package/dist/packages/core/test/unit/traceability-merge.test.js +159 -0
  206. package/dist/packages/core/test/unit/traceability-merge.test.js.map +1 -0
  207. package/dist/packages/core/test/unit/validate-project.test.js +156 -0
  208. package/dist/packages/core/test/unit/validate-project.test.js.map +1 -0
  209. package/dist/packages/core/test/unit/value-annotations.test.js +149 -0
  210. package/dist/packages/core/test/unit/value-annotations.test.js.map +1 -0
  211. package/dist/packages/core/test/unit/write-scope.test.js +165 -0
  212. package/dist/packages/core/test/unit/write-scope.test.js.map +1 -0
  213. package/dist/packages/core/test/unit/yaml-lite.test.js +78 -0
  214. package/dist/packages/core/test/unit/yaml-lite.test.js.map +1 -0
  215. package/dist/scripts/adopt_project.js +11 -0
  216. package/dist/scripts/adopt_project.js.map +1 -0
  217. package/dist/scripts/agents/commands.js +100 -0
  218. package/dist/scripts/agents/commands.js.map +1 -0
  219. package/dist/scripts/agents/init.js +482 -0
  220. package/dist/scripts/agents/init.js.map +1 -0
  221. package/dist/scripts/alm/cli.js +154 -0
  222. package/dist/scripts/alm/cli.js.map +1 -0
  223. package/dist/scripts/alm/clients.js +30 -0
  224. package/dist/scripts/alm/clients.js.map +1 -0
  225. package/dist/scripts/alm/core.js +258 -0
  226. package/dist/scripts/alm/core.js.map +1 -0
  227. package/dist/scripts/alm/port.js +116 -0
  228. package/dist/scripts/alm/port.js.map +1 -0
  229. package/dist/scripts/alm/providers/azure.js +79 -0
  230. package/dist/scripts/alm/providers/azure.js.map +1 -0
  231. package/dist/scripts/alm/providers/github.js +124 -0
  232. package/dist/scripts/alm/providers/github.js.map +1 -0
  233. package/dist/scripts/alm/providers/http-client.js +47 -0
  234. package/dist/scripts/alm/providers/http-client.js.map +1 -0
  235. package/dist/scripts/alm/providers/index.js +107 -0
  236. package/dist/scripts/alm/providers/index.js.map +1 -0
  237. package/dist/scripts/alm/providers/jira.js +129 -0
  238. package/dist/scripts/alm/providers/jira.js.map +1 -0
  239. package/dist/scripts/bundle_pack.js +10 -0
  240. package/dist/scripts/bundle_pack.js.map +1 -0
  241. package/dist/scripts/change/archive.js +68 -0
  242. package/dist/scripts/change/archive.js.map +1 -0
  243. package/dist/scripts/change/artifacts.js +143 -0
  244. package/dist/scripts/change/artifacts.js.map +1 -0
  245. package/dist/scripts/change/cli.js +39 -0
  246. package/dist/scripts/change/cli.js.map +1 -0
  247. package/dist/scripts/change/delta.js +20 -0
  248. package/dist/scripts/change/delta.js.map +1 -0
  249. package/dist/scripts/change/instructions.js +339 -0
  250. package/dist/scripts/change/instructions.js.map +1 -0
  251. package/dist/scripts/ci_init.js +12 -0
  252. package/dist/scripts/ci_init.js.map +1 -0
  253. package/dist/scripts/cli/commands/alm/PullCommand.js +238 -0
  254. package/dist/scripts/cli/commands/alm/PullCommand.js.map +1 -0
  255. package/dist/scripts/cli/commands/change/ChangeCommand.js +867 -0
  256. package/dist/scripts/cli/commands/change/ChangeCommand.js.map +1 -0
  257. package/dist/scripts/cli/commands/config/CiInitCommand.js +144 -0
  258. package/dist/scripts/cli/commands/config/CiInitCommand.js.map +1 -0
  259. package/dist/scripts/cli/commands/config/CompletionCommand.js +160 -0
  260. package/dist/scripts/cli/commands/config/CompletionCommand.js.map +1 -0
  261. package/dist/scripts/cli/commands/config/ConfigInitCommand.js +108 -0
  262. package/dist/scripts/cli/commands/config/ConfigInitCommand.js.map +1 -0
  263. package/dist/scripts/cli/commands/config/ConfigSetCommand.js +166 -0
  264. package/dist/scripts/cli/commands/config/ConfigSetCommand.js.map +1 -0
  265. package/dist/scripts/cli/commands/config/GenAgentContractCommand.js +212 -0
  266. package/dist/scripts/cli/commands/config/GenAgentContractCommand.js.map +1 -0
  267. package/dist/scripts/cli/commands/harness/RunCommand.js +1922 -0
  268. package/dist/scripts/cli/commands/harness/RunCommand.js.map +1 -0
  269. package/dist/scripts/cli/commands/mcp/McpInstallCommand.js +114 -0
  270. package/dist/scripts/cli/commands/mcp/McpInstallCommand.js.map +1 -0
  271. package/dist/scripts/cli/commands/mcp/index.js +29 -0
  272. package/dist/scripts/cli/commands/mcp/index.js.map +1 -0
  273. package/dist/scripts/cli/commands/pack/BundlePackCommand.js +59 -0
  274. package/dist/scripts/cli/commands/pack/BundlePackCommand.js.map +1 -0
  275. package/dist/scripts/cli/commands/pack/ExpandDomainPackCommand.js +559 -0
  276. package/dist/scripts/cli/commands/pack/ExpandDomainPackCommand.js.map +1 -0
  277. package/dist/scripts/cli/commands/pack/InferPackCommand.js +304 -0
  278. package/dist/scripts/cli/commands/pack/InferPackCommand.js.map +1 -0
  279. package/dist/scripts/cli/commands/pack/InitPackCommand.js +368 -0
  280. package/dist/scripts/cli/commands/pack/InitPackCommand.js.map +1 -0
  281. package/dist/scripts/cli/commands/pack/LintPackCommand.js +631 -0
  282. package/dist/scripts/cli/commands/pack/LintPackCommand.js.map +1 -0
  283. package/dist/scripts/cli/commands/pack/pack-args.js +83 -0
  284. package/dist/scripts/cli/commands/pack/pack-args.js.map +1 -0
  285. package/dist/scripts/cli/commands/project/AdoptCommand.js +414 -0
  286. package/dist/scripts/cli/commands/project/AdoptCommand.js.map +1 -0
  287. package/dist/scripts/cli/commands/project/InitFromPackCommand.js +188 -0
  288. package/dist/scripts/cli/commands/project/InitFromPackCommand.js.map +1 -0
  289. package/dist/scripts/cli/commands/project/InitProjectCommand.js +791 -0
  290. package/dist/scripts/cli/commands/project/InitProjectCommand.js.map +1 -0
  291. package/dist/scripts/cli/commands/project/OnboardCommand.js +655 -0
  292. package/dist/scripts/cli/commands/project/OnboardCommand.js.map +1 -0
  293. package/dist/scripts/cli/commands/project/UpdateCommand.js +206 -0
  294. package/dist/scripts/cli/commands/project/UpdateCommand.js.map +1 -0
  295. package/dist/scripts/cli/commands/project/WizardCommand.js +166 -0
  296. package/dist/scripts/cli/commands/project/WizardCommand.js.map +1 -0
  297. package/dist/scripts/cli/commands/quality/DoctorCommand.js +553 -0
  298. package/dist/scripts/cli/commands/quality/DoctorCommand.js.map +1 -0
  299. package/dist/scripts/cli/commands/quality/FixCommand.js +201 -0
  300. package/dist/scripts/cli/commands/quality/FixCommand.js.map +1 -0
  301. package/dist/scripts/cli/commands/quality/LicenseCheckCommand.js +187 -0
  302. package/dist/scripts/cli/commands/quality/LicenseCheckCommand.js.map +1 -0
  303. package/dist/scripts/cli/commands/quality/ReportCommand.js +557 -0
  304. package/dist/scripts/cli/commands/quality/ReportCommand.js.map +1 -0
  305. package/dist/scripts/cli/commands/quality/ValidateSpecsCommand.js +764 -0
  306. package/dist/scripts/cli/commands/quality/ValidateSpecsCommand.js.map +1 -0
  307. package/dist/scripts/cli/commands/spec/DoneCommand.js +116 -0
  308. package/dist/scripts/cli/commands/spec/DoneCommand.js.map +1 -0
  309. package/dist/scripts/cli/commands/spec/PlanCommand.js +397 -0
  310. package/dist/scripts/cli/commands/spec/PlanCommand.js.map +1 -0
  311. package/dist/scripts/cli/commands/spec/ReqCommand.js +303 -0
  312. package/dist/scripts/cli/commands/spec/ReqCommand.js.map +1 -0
  313. package/dist/scripts/cli/commands/spec/StatusCommand.js +206 -0
  314. package/dist/scripts/cli/commands/spec/StatusCommand.js.map +1 -0
  315. package/dist/scripts/cli/commands/spec/StudioCommand.js +241 -0
  316. package/dist/scripts/cli/commands/spec/StudioCommand.js.map +1 -0
  317. package/dist/scripts/cli/commands/specops/ContributeCommand.js +313 -0
  318. package/dist/scripts/cli/commands/specops/ContributeCommand.js.map +1 -0
  319. package/dist/scripts/cli/commands/specops/DiffCommand.js +394 -0
  320. package/dist/scripts/cli/commands/specops/DiffCommand.js.map +1 -0
  321. package/dist/scripts/cli/commands/specops/SyncCommand.js +380 -0
  322. package/dist/scripts/cli/commands/specops/SyncCommand.js.map +1 -0
  323. package/dist/scripts/completion.js +24 -0
  324. package/dist/scripts/completion.js.map +1 -0
  325. package/dist/scripts/config_init.js +12 -0
  326. package/dist/scripts/config_init.js.map +1 -0
  327. package/dist/scripts/config_set.js +20 -0
  328. package/dist/scripts/config_set.js.map +1 -0
  329. package/dist/scripts/docs/blocks.js +137 -0
  330. package/dist/scripts/docs/blocks.js.map +1 -0
  331. package/dist/scripts/docs/build-site.js +425 -0
  332. package/dist/scripts/docs/build-site.js.map +1 -0
  333. package/dist/scripts/docs/nav.js +198 -0
  334. package/dist/scripts/docs/nav.js.map +1 -0
  335. package/dist/scripts/docs/record-terminal.js +477 -0
  336. package/dist/scripts/docs/record-terminal.js.map +1 -0
  337. package/dist/scripts/docs/terminal-storyboard.js +121 -0
  338. package/dist/scripts/docs/terminal-storyboard.js.map +1 -0
  339. package/dist/scripts/doctor.js +14 -0
  340. package/dist/scripts/doctor.js.map +1 -0
  341. package/dist/scripts/done.js +17 -0
  342. package/dist/scripts/done.js.map +1 -0
  343. package/dist/scripts/expand_domain_pack.js +18 -0
  344. package/dist/scripts/expand_domain_pack.js.map +1 -0
  345. package/dist/scripts/fix.js +12 -0
  346. package/dist/scripts/fix.js.map +1 -0
  347. package/dist/scripts/gen_agent_contract.js +14 -0
  348. package/dist/scripts/gen_agent_contract.js.map +1 -0
  349. package/dist/scripts/gen_mcp_tools.js +264 -0
  350. package/dist/scripts/gen_mcp_tools.js.map +1 -0
  351. package/dist/scripts/harness/init.js +358 -0
  352. package/dist/scripts/harness/init.js.map +1 -0
  353. package/dist/scripts/harness/prompt.js +18 -0
  354. package/dist/scripts/harness/prompt.js.map +1 -0
  355. package/dist/scripts/harness/report.js +323 -0
  356. package/dist/scripts/harness/report.js.map +1 -0
  357. package/dist/scripts/harness/run.js +33 -0
  358. package/dist/scripts/harness/run.js.map +1 -0
  359. package/dist/scripts/infer_pack.js +17 -0
  360. package/dist/scripts/infer_pack.js.map +1 -0
  361. package/dist/scripts/init_from_pack.js +16 -0
  362. package/dist/scripts/init_from_pack.js.map +1 -0
  363. package/dist/scripts/init_pack.js +16 -0
  364. package/dist/scripts/init_pack.js.map +1 -0
  365. package/dist/scripts/init_project.js +17 -0
  366. package/dist/scripts/init_project.js.map +1 -0
  367. package/dist/scripts/lib/agent.js +99 -0
  368. package/dist/scripts/lib/agent.js.map +1 -0
  369. package/dist/scripts/lib/capability-specs.js +80 -0
  370. package/dist/scripts/lib/capability-specs.js.map +1 -0
  371. package/dist/scripts/lib/command.js +17 -0
  372. package/dist/scripts/lib/command.js.map +1 -0
  373. package/dist/scripts/lib/diagnostics.js +62 -0
  374. package/dist/scripts/lib/diagnostics.js.map +1 -0
  375. package/dist/scripts/lib/monorepo-fanout.js +118 -0
  376. package/dist/scripts/lib/monorepo-fanout.js.map +1 -0
  377. package/dist/scripts/lib/placeholders.js +190 -0
  378. package/dist/scripts/lib/placeholders.js.map +1 -0
  379. package/dist/scripts/lib/project-root.js +124 -0
  380. package/dist/scripts/lib/project-root.js.map +1 -0
  381. package/dist/scripts/lib/requirement-graph.js +31 -0
  382. package/dist/scripts/lib/requirement-graph.js.map +1 -0
  383. package/dist/scripts/lib/surface.js +609 -0
  384. package/dist/scripts/lib/surface.js.map +1 -0
  385. package/dist/scripts/license_check.js +15 -0
  386. package/dist/scripts/license_check.js.map +1 -0
  387. package/dist/scripts/lint_pack.js +18 -0
  388. package/dist/scripts/lint_pack.js.map +1 -0
  389. package/dist/scripts/merge-traceability.js +106 -0
  390. package/dist/scripts/merge-traceability.js.map +1 -0
  391. package/dist/scripts/onboard.js +22 -0
  392. package/dist/scripts/onboard.js.map +1 -0
  393. package/dist/scripts/plan.js +17 -0
  394. package/dist/scripts/plan.js.map +1 -0
  395. package/dist/scripts/plugin/gate-hook.js +171 -0
  396. package/dist/scripts/plugin/gate-hook.js.map +1 -0
  397. package/dist/scripts/report.js +17 -0
  398. package/dist/scripts/report.js.map +1 -0
  399. package/dist/scripts/req.js +22 -0
  400. package/dist/scripts/req.js.map +1 -0
  401. package/dist/scripts/schema/cli.js +215 -0
  402. package/dist/scripts/schema/cli.js.map +1 -0
  403. package/dist/scripts/schema/registry.js +264 -0
  404. package/dist/scripts/schema/registry.js.map +1 -0
  405. package/dist/scripts/specops/add.js +180 -0
  406. package/dist/scripts/specops/add.js.map +1 -0
  407. package/dist/scripts/specops/against_lock.js +100 -0
  408. package/dist/scripts/specops/against_lock.js.map +1 -0
  409. package/dist/scripts/specops/as_change.js +49 -0
  410. package/dist/scripts/specops/as_change.js.map +1 -0
  411. package/dist/scripts/specops/contribute.js +24 -0
  412. package/dist/scripts/specops/contribute.js.map +1 -0
  413. package/dist/scripts/specops/diff.js +32 -0
  414. package/dist/scripts/specops/diff.js.map +1 -0
  415. package/dist/scripts/specops/lock.js +39 -0
  416. package/dist/scripts/specops/lock.js.map +1 -0
  417. package/dist/scripts/specops/manifest.js +90 -0
  418. package/dist/scripts/specops/manifest.js.map +1 -0
  419. package/dist/scripts/specops/remove.js +102 -0
  420. package/dist/scripts/specops/remove.js.map +1 -0
  421. package/dist/scripts/specops/sync.js +27 -0
  422. package/dist/scripts/specops/sync.js.map +1 -0
  423. package/dist/scripts/specops/verify.js +149 -0
  424. package/dist/scripts/specops/verify.js.map +1 -0
  425. package/dist/scripts/status.js +17 -0
  426. package/dist/scripts/status.js.map +1 -0
  427. package/dist/scripts/studio.js +14 -0
  428. package/dist/scripts/studio.js.map +1 -0
  429. package/dist/scripts/update.js +17 -0
  430. package/dist/scripts/update.js.map +1 -0
  431. package/dist/scripts/validate_specs.js +10 -0
  432. package/dist/scripts/validate_specs.js.map +1 -0
  433. package/examples/project.config.example +19 -0
  434. package/examples/project.yaml.example +17 -0
  435. package/package.json +105 -0
  436. package/templates/adopt/AI_RULES.md.tpl +27 -0
  437. package/templates/adopt/adr-readme.md.tpl +5 -0
  438. package/templates/adopt/baseline.feature.tpl +9 -0
  439. package/templates/adopt/spec.md.tpl +25 -0
  440. package/templates/adopt/traceability.md.tpl +11 -0
  441. package/templates/backend/AI_RULES.md.tpl +35 -0
  442. package/templates/backend/features/core/health.feature.tpl +7 -0
  443. package/templates/base/.devcontainer/devcontainer.json.tpl +18 -0
  444. package/templates/base/.dockerignore.tpl +11 -0
  445. package/templates/base/.env.dev.app.tpl +13 -0
  446. package/templates/base/.env.dev.infra.tpl +6 -0
  447. package/templates/base/.env.dev.tpl +16 -0
  448. package/templates/base/.env.example.tpl +17 -0
  449. package/templates/base/.env.feature.app.tpl +11 -0
  450. package/templates/base/.env.feature.infra.tpl +4 -0
  451. package/templates/base/.env.feature.tpl +16 -0
  452. package/templates/base/.env.prod.app.tpl +13 -0
  453. package/templates/base/.env.prod.infra.tpl +6 -0
  454. package/templates/base/.env.prod.tpl +16 -0
  455. package/templates/base/.github/workflows/specs.yml.tpl +26 -0
  456. package/templates/base/.gitignore.tpl +9 -0
  457. package/templates/base/.pre-commit-config.yaml.tpl +10 -0
  458. package/templates/base/AGENTS.md.tpl +32 -0
  459. package/templates/base/README.md.tpl +32 -0
  460. package/templates/base/docker-compose.yml.tpl +13 -0
  461. package/templates/base/docs/specs/adr/README.md.tpl +10 -0
  462. package/templates/base/docs/specs/aggregates.md.tpl +5 -0
  463. package/templates/base/docs/specs/commands.md.tpl +13 -0
  464. package/templates/base/docs/specs/domain-model.md.tpl +30 -0
  465. package/templates/base/docs/specs/events.md.tpl +5 -0
  466. package/templates/base/docs/specs/review-checklist.md.tpl +18 -0
  467. package/templates/base/docs/specs/runtime-environments.md.tpl +26 -0
  468. package/templates/base/docs/specs/status-model.md.tpl +16 -0
  469. package/templates/base/docs/specs/traceability.md.tpl +7 -0
  470. package/templates/base/docs/specs/use-cases.md.tpl +5 -0
  471. package/templates/base/spec.md.tpl +63 -0
  472. package/templates/ci/azure.yml.tpl +40 -0
  473. package/templates/ci/github.yml.tpl +40 -0
  474. package/templates/ci/gitlab.yml.tpl +21 -0
  475. package/templates/ci/jenkins.tpl +35 -0
  476. package/templates/contracts/AI_RULES.md.tpl +55 -0
  477. package/templates/contracts/asyncapi-stub.yaml.tpl +24 -0
  478. package/templates/contracts/contract-traceability.md.tpl +10 -0
  479. package/templates/contracts/openapi-stub.yaml.tpl +29 -0
  480. package/templates/contracts/pacts-gitkeep.tpl +0 -0
  481. package/templates/contracts/test-strategy.md.tpl +94 -0
  482. package/templates/frontend/AI_RULES.md.tpl +34 -0
  483. package/templates/frontend/features/core/health.feature.tpl +6 -0
  484. package/templates/harness/harness.config.yaml.tpl +74 -0
  485. package/templates/harness/prompt-prefix.md.tpl +60 -0
  486. package/templates/mobile/AI_RULES.md.tpl +56 -0
  487. package/templates/mobile/features/core/health.feature.tpl +7 -0
  488. package/templates/modules/auth/backend/registration_and_login.feature.tpl +10 -0
  489. package/templates/modules/auth/frontend/login.feature.tpl +5 -0
  490. package/templates/modules/billing/backend/billing_settlement.feature.tpl +5 -0
  491. package/templates/modules/billing/frontend/billing_summary.feature.tpl +5 -0
  492. package/templates/modules/dashboard/backend/dashboard_kpi.feature.tpl +5 -0
  493. package/templates/modules/dashboard/frontend/dashboard.feature.tpl +5 -0
  494. package/vendor/mermaid.min.js +3636 -0
@@ -0,0 +1,323 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ /**
4
+ * `specgate harness report` — what the harness has actually cost.
5
+ *
6
+ * Two numbers decide whether agent roles, retries and parallelism are worth
7
+ * paying for, and neither was measurable before the run ledger existed:
8
+ *
9
+ * **cost per delivered requirement** — wall-clock, because an agent is any
10
+ * shell command and only the agent knows what it spent in tokens; and
11
+ * **first-attempt success rate** — the one that says whether a retry ladder
12
+ * is buying anything or just spending three times as much on the same
13
+ * mistake.
14
+ *
15
+ * Reads `.harness/runs/*.json`, which `harness run` writes. No network, no
16
+ * git, no agent: this command only ever reads.
17
+ */
18
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
19
+ if (k2 === undefined) k2 = k;
20
+ var desc = Object.getOwnPropertyDescriptor(m, k);
21
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
22
+ desc = { enumerable: true, get: function() { return m[k]; } };
23
+ }
24
+ Object.defineProperty(o, k2, desc);
25
+ }) : (function(o, m, k, k2) {
26
+ if (k2 === undefined) k2 = k;
27
+ o[k2] = m[k];
28
+ }));
29
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
30
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
31
+ }) : function(o, v) {
32
+ o["default"] = v;
33
+ });
34
+ var __importStar = (this && this.__importStar) || (function () {
35
+ var ownKeys = function(o) {
36
+ ownKeys = Object.getOwnPropertyNames || function (o) {
37
+ var ar = [];
38
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
39
+ return ar;
40
+ };
41
+ return ownKeys(o);
42
+ };
43
+ return function (mod) {
44
+ if (mod && mod.__esModule) return mod;
45
+ var result = {};
46
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
47
+ __setModuleDefault(result, mod);
48
+ return result;
49
+ };
50
+ })();
51
+ Object.defineProperty(exports, "__esModule", { value: true });
52
+ exports.FALSE_FAILURES_FILE = void 0;
53
+ exports.parseArgs = parseArgs;
54
+ exports.readRuns = readRuns;
55
+ exports.readFalseFailures = readFalseFailures;
56
+ exports.appendFalseFailure = appendFalseFailure;
57
+ exports.summarise = summarise;
58
+ exports.main = main;
59
+ const fs = __importStar(require("node:fs"));
60
+ const path = __importStar(require("node:path"));
61
+ const project_root_1 = require("../lib/project-root");
62
+ const agent_1 = require("../lib/agent");
63
+ const diagnostics_1 = require("../lib/diagnostics");
64
+ const run_1 = require("./run");
65
+ const HarnessConfigFile_1 = require("../../packages/core/src/infrastructure/HarnessConfigFile");
66
+ const HarnessReport_1 = require("../../packages/core/src/domain/HarnessReport");
67
+ /**
68
+ * Where a person's "the gate was wrong about this one" is kept.
69
+ *
70
+ * Append-only, one JSON object per line, because that is what survives a
71
+ * process dying mid-write — the same reason the run ledger is one file per run.
72
+ */
73
+ exports.FALSE_FAILURES_FILE = ".harness/false-failures.jsonl";
74
+ const COLOR = process.stdout.isTTY && process.env.NO_COLOR === undefined && process.env.TERM !== "dumb";
75
+ const c = {
76
+ reset: COLOR ? "\x1b[0m" : "",
77
+ bold: COLOR ? "\x1b[1m" : "",
78
+ dim: COLOR ? "\x1b[2m" : "",
79
+ green: COLOR ? "\x1b[32m" : "",
80
+ yellow: COLOR ? "\x1b[33m" : "",
81
+ };
82
+ function usage() {
83
+ process.stdout.write(`\n ${c.bold}📈 harness report${c.reset} ${c.dim}— what the harness has cost${c.reset}\n\n` +
84
+ ` ${c.bold}USAGE${c.reset}\n` +
85
+ ` specgate harness report [--project-dir <path>] [--last <n>] [--json]\n\n` +
86
+ ` ${c.bold}OPTIONS${c.reset}\n` +
87
+ ` --last <n> Only the n most recent runs.\n` +
88
+ ` --json Machine-readable summary.\n` +
89
+ ` --mark-false-failure <REQ-NNN> --reason "..."\n` +
90
+ ` Record that the gate rejected good work. Nothing the\n` +
91
+ ` harness stores can tell a real failure from a false\n` +
92
+ ` one — only a person can, so the ratio stays unknown\n` +
93
+ ` until somebody marks one.\n\n`);
94
+ }
95
+ function parseArgs(argv) {
96
+ const opts = {
97
+ projectDir: ".",
98
+ json: (0, agent_1.wantsJson)(argv),
99
+ last: null,
100
+ markFalseFailure: null,
101
+ reason: "",
102
+ };
103
+ for (let i = 0; i < argv.length; i += 1) {
104
+ const a = argv[i];
105
+ if (a === "--project-dir" && argv[i + 1])
106
+ opts.projectDir = argv[++i];
107
+ else if (a === "--last" && argv[i + 1]) {
108
+ const n = Number(argv[++i]);
109
+ if (!Number.isInteger(n) || n < 1)
110
+ throw new Error("--last must be a positive integer");
111
+ opts.last = n;
112
+ }
113
+ else if (a === "--mark-false-failure" && argv[i + 1]) {
114
+ const req = argv[++i];
115
+ if (!/^REQ-\d+$/.test(req)) {
116
+ throw new Error(`--mark-false-failure expects REQ-NNN, got: ${req}`);
117
+ }
118
+ opts.markFalseFailure = req;
119
+ }
120
+ else if (a === "--reason" && argv[i + 1]) {
121
+ opts.reason = argv[++i];
122
+ }
123
+ else if (a === "--json" || a === "--format") {
124
+ if (a === "--format")
125
+ i += 1;
126
+ }
127
+ else if (a === "--help" || a === "-h") {
128
+ usage();
129
+ process.exit(0);
130
+ }
131
+ else if (a.startsWith("-")) {
132
+ throw new Error(`Unknown flag: ${a}`);
133
+ }
134
+ }
135
+ // A mark without a reason is a number nobody can audit later. The whole point
136
+ // of this metric is that a person looked; the reason is what they saw.
137
+ if (opts.markFalseFailure && !opts.reason.trim()) {
138
+ throw new Error('--mark-false-failure needs --reason "why the gate was wrong"');
139
+ }
140
+ return opts;
141
+ }
142
+ /** Read the ledger, newest first, skipping anything that is not a run record. */
143
+ function readRuns(projectDir, last) {
144
+ const dir = path.join(projectDir, run_1.RUNS_DIR);
145
+ if (!fs.existsSync(dir))
146
+ return [];
147
+ const runs = [];
148
+ for (const name of fs.readdirSync(dir).sort().reverse()) {
149
+ if (!name.endsWith(".json"))
150
+ continue;
151
+ try {
152
+ const parsed = JSON.parse(fs.readFileSync(path.join(dir, name), "utf8"));
153
+ if (parsed && Array.isArray(parsed.results))
154
+ runs.push(parsed);
155
+ }
156
+ catch {
157
+ // A half-written record is not worth failing a read-only report over.
158
+ }
159
+ if (last !== null && runs.length >= last)
160
+ break;
161
+ }
162
+ return runs;
163
+ }
164
+ /**
165
+ * The aggregation itself lives in `core/domain/HarnessReport`: it is arithmetic
166
+ * over records, and keeping it out of here is what lets it be tested without
167
+ * writing a ledger to disk. This wrapper is kept because the run tests import
168
+ * it by name.
169
+ */
170
+ /** The marks a person has left, or none. */
171
+ function readFalseFailures(projectDir) {
172
+ const file = path.join(projectDir, ...exports.FALSE_FAILURES_FILE.split("/"));
173
+ if (!fs.existsSync(file))
174
+ return [];
175
+ try {
176
+ return (0, HarnessReport_1.parseFalseFailures)(fs.readFileSync(file, "utf8"));
177
+ }
178
+ catch {
179
+ return [];
180
+ }
181
+ }
182
+ /** Append one mark. Append-only, so a killed process loses at most its own line. */
183
+ function appendFalseFailure(projectDir, mark) {
184
+ const file = path.join(projectDir, ...exports.FALSE_FAILURES_FILE.split("/"));
185
+ fs.mkdirSync(path.dirname(file), { recursive: true });
186
+ fs.appendFileSync(file, `${JSON.stringify(mark)}\n`, "utf8");
187
+ }
188
+ function summarise(runs, falseFailures = [], costPerRunHint = {}) {
189
+ return (0, HarnessReport_1.summariseRuns)(runs, falseFailures, costPerRunHint);
190
+ }
191
+ function human(ms) {
192
+ if (ms < 1000)
193
+ return `${ms}ms`;
194
+ if (ms < 60_000)
195
+ return `${(ms / 1000).toFixed(1)}s`;
196
+ return `${Math.floor(ms / 60_000)}m ${Math.round((ms % 60_000) / 1000)}s`;
197
+ }
198
+ function render(summary) {
199
+ const label = (text) => text.padEnd(26);
200
+ const pct = (v) => (v === null ? "—" : `${Math.round(v * 100)}%`);
201
+ process.stdout.write(`\n ${c.bold}📈 harness report${c.reset} ${c.dim}(${summary.runs} run(s))${c.reset}\n\n` +
202
+ ` ${label("requirements attempted")}${summary.requirementsAttempted}\n` +
203
+ ` ${c.green}${label("passed")}${c.reset}${summary.passed}\n` +
204
+ ` ${label("failed")}${summary.failed}\n` +
205
+ ` ${label("blocked")}${summary.blocked}\n\n` +
206
+ ` ${c.bold}${label("first attempt worked")}${c.reset}${pct(summary.firstAttemptRate)}` +
207
+ ` ${c.dim}(${summary.firstAttemptPasses} of ${summary.passed} passes)${c.reset}\n` +
208
+ ` ${c.bold}${label("cost per delivered REQ")}${c.reset}` +
209
+ `${summary.msPerDelivered === null ? "—" : human(summary.msPerDelivered)}` +
210
+ ` ${c.dim}wall-clock, failed attempts included${c.reset}\n`);
211
+ if (summary.estimatedCost) {
212
+ const { total, covered, uncovered } = summary.estimatedCost;
213
+ process.stdout.write(` ${label("estimated spend")}${total.toFixed(2)}` +
214
+ ` ${c.dim}declared by profile, not measured` +
215
+ (uncovered > 0 ? ` — ${uncovered} of ${covered + uncovered} attempts have no hint` : "") +
216
+ `${c.reset}\n`);
217
+ }
218
+ if (summary.stages.length > 0) {
219
+ // Where the gate rejects, which is the question C2 exists to answer. Read
220
+ // from every attempt, not from each requirement's final result: one that
221
+ // passed on attempt 3 still failed twice, and those two are the interesting
222
+ // ones.
223
+ process.stdout.write(`\n ${c.dim}where attempts ended${c.reset}\n`);
224
+ for (const s of summary.stages) {
225
+ const label = HarnessReport_1.STAGE_LABELS[s.stage] || s.stage;
226
+ const mark = s.stage === "pass" ? c.green : c.yellow;
227
+ process.stdout.write(` ${mark}${String(s.count).padStart(4)}${c.reset} ${label} ${c.dim}[${s.stage}]${c.reset}\n`);
228
+ }
229
+ }
230
+ if (summary.exhausted.length > 0) {
231
+ process.stdout.write(`\n ${c.dim}spent every attempt and delivered nothing${c.reset}\n`);
232
+ for (const r of summary.exhausted.slice(0, 5)) {
233
+ process.stdout.write(` ${c.yellow}${r.requirement.padEnd(10)}${c.reset} ${human(r.durationMs).padStart(8)}` +
234
+ ` ${c.dim}${r.attempts} attempt(s)${c.reset}\n`);
235
+ }
236
+ }
237
+ if (summary.timeline.length > 1) {
238
+ const first = summary.timeline[0].startedAt.slice(0, 10);
239
+ const last = summary.timeline[summary.timeline.length - 1].startedAt.slice(0, 10);
240
+ process.stdout.write(`\n ${c.dim}runs over time${c.reset}\n ${(0, HarnessReport_1.sparkline)(summary.timeline)}` +
241
+ ` ${c.dim}${first} → ${last}${c.reset}\n`);
242
+ }
243
+ if (summary.failed > 0) {
244
+ process.stdout.write(`\n ${c.bold}${label("failures that were real")}${c.reset}` +
245
+ `${pct(summary.realFailureRate)}` +
246
+ (summary.realFailureRate === null
247
+ ? ` ${c.dim}nothing recorded can tell a real failure from a gate that was\n` +
248
+ `${" ".repeat(30)}wrong — mark one: specgate harness report\n` +
249
+ `${" ".repeat(30)}--mark-false-failure REQ-NNN --reason "..."${c.reset}\n`
250
+ : ` ${c.dim}${summary.falseFailures} marked as the gate's fault${c.reset}\n`));
251
+ }
252
+ if (summary.worst.length > 0) {
253
+ process.stdout.write(`\n ${c.dim}slowest${c.reset}\n`);
254
+ for (const r of summary.worst) {
255
+ const mark = r.result === "pass" ? c.green : c.yellow;
256
+ process.stdout.write(` ${mark}${r.requirement.padEnd(10)}${c.reset} ${human(r.durationMs).padStart(8)}` +
257
+ ` ${c.dim}${r.attempts} attempt(s), ${r.result}${c.reset}\n`);
258
+ }
259
+ }
260
+ process.stdout.write("\n");
261
+ }
262
+ function main(argv) {
263
+ let opts;
264
+ const io = (0, agent_1.agentIo)((0, agent_1.wantsJson)(argv));
265
+ try {
266
+ opts = parseArgs(argv);
267
+ }
268
+ catch (err) {
269
+ io.usage({ report: null }, [
270
+ (0, diagnostics_1.error)("usage", err instanceof Error ? err.message : String(err), {
271
+ fix: "See `specgate harness report --help`.",
272
+ }),
273
+ ]);
274
+ return;
275
+ }
276
+ let projectDir;
277
+ try {
278
+ projectDir = (0, project_root_1.resolveProjectDir)(opts.projectDir, { requireSentinel: true });
279
+ }
280
+ catch (err) {
281
+ io.fail({ report: null }, [
282
+ (0, diagnostics_1.error)("no_project", err instanceof Error ? err.message : String(err), {
283
+ fix: "Run from inside a spec-driven project, or pass --project-dir.",
284
+ }),
285
+ ]);
286
+ return;
287
+ }
288
+ if (opts.markFalseFailure) {
289
+ appendFalseFailure(projectDir, {
290
+ requirement: opts.markFalseFailure,
291
+ reason: opts.reason.trim(),
292
+ markedAt: new Date().toISOString(),
293
+ });
294
+ process.stdout.write(`\n ${c.green}✔${c.reset} ${opts.markFalseFailure} marked as a false failure.\n` +
295
+ ` ${c.dim}${opts.reason.trim()}${c.reset}\n\n`);
296
+ }
297
+ const runs = readRuns(projectDir, opts.last);
298
+ if (runs.length === 0) {
299
+ io.emit({ report: summarise([], []), status: [] }, () => {
300
+ process.stdout.write(`\n ${c.dim}No runs recorded yet. \`specgate harness run\` writes one per run.${c.reset}\n\n`);
301
+ });
302
+ process.exit(agent_1.EXIT.OK);
303
+ }
304
+ // C1: what each profile declares a run of it costs. Read from the project's
305
+ // own profiles, and absent unless somebody wrote one.
306
+ // Read from `.harness/profiles.yaml` directly, not through the config
307
+ // reader: a project may declare profiles and never write a
308
+ // `harness.config.yaml`, and going via the config made the estimate silently
309
+ // absent there.
310
+ let costHints = {};
311
+ try {
312
+ costHints = (0, HarnessConfigFile_1.readCostHints)(projectDir);
313
+ }
314
+ catch {
315
+ /* a broken profiles file is `harness run`'s problem, not this read-only command's */
316
+ }
317
+ const summary = summarise(runs, readFalseFailures(projectDir), costHints);
318
+ io.emit({ report: summary, status: [] }, () => render(summary));
319
+ process.exit(agent_1.EXIT.OK);
320
+ }
321
+ if (require.main === module)
322
+ main(process.argv.slice(2));
323
+ //# sourceMappingURL=report.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"report.js","sourceRoot":"","sources":["../../../scripts/harness/report.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEH,8BAsCC;AAGD,4BAgBC;AASD,8CAQC;AAGD,gDAIC;AAED,8BAMC;AA6FD,oBAgEC;AAtTD,4CAA8B;AAC9B,gDAAkC;AAElC,sDAAwD;AACxD,wCAAwD;AACxD,oDAA2C;AAC3C,+BAAiC;AACjC,gGAAyF;AACzF,gFAQsD;AAItD;;;;;GAKG;AACU,QAAA,mBAAmB,GAAG,+BAA+B,CAAC;AAEnE,MAAM,KAAK,GACT,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC5F,MAAM,CAAC,GAAG;IACR,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;IAC7B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;IAC5B,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;IAC3B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;IAC9B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;CAChC,CAAC;AAYF,SAAS,KAAK;IACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,8BAA8B,CAAC,CAAC,KAAK,MAAM;QAC3F,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,KAAK,IAAI;QAC9B,8EAA8E;QAC9E,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,KAAK,IAAI;QAChC,0DAA0D;QAC1D,uDAAuD;QACvD,qDAAqD;QACrD,kFAAkF;QAClF,iFAAiF;QACjF,iFAAiF;QACjF,yDAAyD,CAC5D,CAAC;AACJ,CAAC;AAED,SAAgB,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAyB;QACjC,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,IAAA,iBAAS,EAAC,IAAI,CAAC;QACrB,IAAI,EAAE,IAAI;QACV,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,EAAE;KACX,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,eAAe,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aACjE,IAAI,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACxF,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,KAAK,sBAAsB,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,8CAA8C,GAAG,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,UAAU;gBAAE,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACxC,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,8EAA8E;IAC9E,uEAAuE;IACvE,IAAI,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AACjF,SAAgB,QAAQ,CAAC,UAAkB,EAAE,IAAmB;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACzE,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;YAAE,MAAM;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,4CAA4C;AAC5C,SAAgB,iBAAiB,CAAC,UAAkB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,2BAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,IAAA,kCAAkB,EAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,SAAgB,kBAAkB,CAAC,UAAkB,EAAE,IAAsB;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,2BAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,SAAgB,SAAS,CACvB,IAAe,EACf,gBAAoC,EAAE,EACtC,iBAAyC,EAAE;IAE3C,OAAO,IAAA,6BAAa,EAAC,IAAI,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;AAC5E,CAAC;AAED,SAAS,MAAM,CAAC,OAA6B;IAC3C,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,WAAW,CAAC,CAAC,KAAK,MAAM;QACxF,OAAO,KAAK,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,qBAAqB,IAAI;QAC1E,OAAO,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,IAAI;QAC/D,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI;QAC3C,OAAO,KAAK,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,MAAM;QAC/C,OAAO,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE;QACzF,KAAK,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,kBAAkB,OAAO,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC,KAAK,IAAI;QACnF,OAAO,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE;QAC3D,GAAG,OAAO,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;QAC1E,KAAK,CAAC,CAAC,GAAG,uCAAuC,CAAC,CAAC,KAAK,IAAI,CAC/D,CAAC;IAEF,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,KAAK,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YAClD,KAAK,CAAC,CAAC,GAAG,mCAAmC;YAC7C,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,OAAO,OAAO,GAAG,SAAS,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,GAAG,CAAC,CAAC,KAAK,IAAI,CACjB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,0EAA0E;QAC1E,yEAAyE;QACzE,4EAA4E;QAC5E,QAAQ;QACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACrE,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,4BAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;YAC/C,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CACjG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,4CAA4C,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC1F,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;gBACvF,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,cAAc,CAAC,CAAC,KAAK,IAAI,CACnD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,KAAK,SAAS,IAAA,yBAAS,EAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACxE,KAAK,CAAC,CAAC,GAAG,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,CAC7C,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE;YAC1D,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;YACjC,CAAC,OAAO,CAAC,eAAe,KAAK,IAAI;gBAC/B,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,iEAAiE;oBAC3E,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,6CAA6C;oBAC9D,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,8CAA8C,CAAC,CAAC,KAAK,IAAI;gBAC5E,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,aAAa,8BAA8B,CAAC,CAAC,KAAK,IAAI,CAAC,CACnF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACxD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;gBACnF,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAgB,IAAI,CAAC,IAAc;IACjC,IAAI,IAA0B,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAA,eAAO,EAAC,IAAA,iBAAS,EAAC,IAAI,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YACzB,IAAA,mBAAK,EAAC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBAC/D,GAAG,EAAE,uCAAuC;aAC7C,CAAC;SACH,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,IAAA,gCAAiB,EAAC,IAAI,CAAC,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YACxB,IAAA,mBAAK,EAAC,YAAY,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBACpE,GAAG,EAAE,+DAA+D;aACrE,CAAC;SACH,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,kBAAkB,CAAC,UAAU,EAAE;YAC7B,WAAW,EAAE,IAAI,CAAC,gBAAgB;YAClC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAC1B,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,gBAAgB,+BAA+B;YAChF,QAAQ,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,MAAM,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,CAAC,GAAG,qEAAqE,CAAC,CAAC,KAAK,MAAM,CAC/F,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,YAAI,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,4EAA4E;IAC5E,sDAAsD;IACtD,sEAAsE;IACtE,2DAA2D;IAC3D,6EAA6E;IAC7E,gBAAgB;IAChB,IAAI,SAAS,GAA2B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,SAAS,GAAG,IAAA,iCAAa,EAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,qFAAqF;IACvF,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,iBAAiB,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;IAC1E,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,YAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;IAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}
@@ -0,0 +1,33 @@
1
+ "use strict";
2
+ /**
3
+ * `specgate harness run` — re-export of the command and of the decisions it makes.
4
+ *
5
+ * The command lives in `scripts/cli/commands/harness/RunCommand`; command
6
+ * substitution, the gate-output hint and the dependency scheduling are domain
7
+ * (`core/domain/HarnessRun`), which is what lets the scheduler be tested
8
+ * without a git repository and an agent. Kept as one import site for
9
+ * `harness report` and the run tests.
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.scheduleLevels = exports.filterHint = exports.substituteGateCommand = exports.substituteAgentCommand = exports.RUNS_DIR = exports.runLevels = exports.printReport = exports.setJsonMode = exports.parseArgs = exports.RunCommand = void 0;
13
+ const RunCommand_1 = require("../cli/commands/harness/RunCommand");
14
+ var RunCommand_2 = require("../cli/commands/harness/RunCommand");
15
+ Object.defineProperty(exports, "RunCommand", { enumerable: true, get: function () { return RunCommand_2.RunCommand; } });
16
+ Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return RunCommand_2.parseArgs; } });
17
+ Object.defineProperty(exports, "setJsonMode", { enumerable: true, get: function () { return RunCommand_2.setJsonMode; } });
18
+ Object.defineProperty(exports, "printReport", { enumerable: true, get: function () { return RunCommand_2.printReport; } });
19
+ Object.defineProperty(exports, "runLevels", { enumerable: true, get: function () { return RunCommand_2.runLevels; } });
20
+ Object.defineProperty(exports, "RUNS_DIR", { enumerable: true, get: function () { return RunCommand_2.RUNS_DIR; } });
21
+ var HarnessRun_1 = require("../../packages/core/src/domain/HarnessRun");
22
+ Object.defineProperty(exports, "substituteAgentCommand", { enumerable: true, get: function () { return HarnessRun_1.substituteAgentCommand; } });
23
+ Object.defineProperty(exports, "substituteGateCommand", { enumerable: true, get: function () { return HarnessRun_1.substituteGateCommand; } });
24
+ Object.defineProperty(exports, "filterHint", { enumerable: true, get: function () { return HarnessRun_1.filterHint; } });
25
+ Object.defineProperty(exports, "scheduleLevels", { enumerable: true, get: function () { return HarnessRun_1.scheduleLevels; } });
26
+ // This file is what the command registry spawns, so it stays the entry point.
27
+ if (require.main === module) {
28
+ new RunCommand_1.RunCommand(process.argv.slice(2)).execute().catch((err) => {
29
+ (0, RunCommand_1.error)(err && err.message ? err.message : String(err));
30
+ process.exit(1);
31
+ });
32
+ }
33
+ //# sourceMappingURL=run.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run.js","sourceRoot":"","sources":["../../../scripts/harness/run.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mEAAuE;AAEvE,iEAQ4C;AAP1C,wGAAA,UAAU,OAAA;AACV,uGAAA,SAAS,OAAA;AACT,yGAAA,WAAW,OAAA;AACX,yGAAA,WAAW,OAAA;AACX,uGAAA,SAAS,OAAA;AACT,sGAAA,QAAQ,OAAA;AAIV,wEAMmD;AALjD,oHAAA,sBAAsB,OAAA;AACtB,mHAAA,qBAAqB,OAAA;AACrB,wGAAA,UAAU,OAAA;AACV,4GAAA,cAAc,OAAA;AAIhB,8EAA8E;AAC9E,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,uBAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAQ,EAAE,EAAE;QACjE,IAAA,kBAAK,EAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,17 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.renderYamlFragment = exports.inferModel = exports.extractEventNames = exports.collectRequirementIds = exports.toPascalCase = exports.parseFeatureFile = exports.parseArgs = exports.InferPackCommand = void 0;
5
+ const InferPackCommand_1 = require("./cli/commands/pack/InferPackCommand");
6
+ Object.defineProperty(exports, "InferPackCommand", { enumerable: true, get: function () { return InferPackCommand_1.InferPackCommand; } });
7
+ Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return InferPackCommand_1.parseArgs; } });
8
+ Object.defineProperty(exports, "parseFeatureFile", { enumerable: true, get: function () { return InferPackCommand_1.parseFeatureFile; } });
9
+ Object.defineProperty(exports, "toPascalCase", { enumerable: true, get: function () { return InferPackCommand_1.toPascalCase; } });
10
+ Object.defineProperty(exports, "collectRequirementIds", { enumerable: true, get: function () { return InferPackCommand_1.collectRequirementIds; } });
11
+ Object.defineProperty(exports, "extractEventNames", { enumerable: true, get: function () { return InferPackCommand_1.extractEventNames; } });
12
+ Object.defineProperty(exports, "inferModel", { enumerable: true, get: function () { return InferPackCommand_1.inferModel; } });
13
+ Object.defineProperty(exports, "renderYamlFragment", { enumerable: true, get: function () { return InferPackCommand_1.renderYamlFragment; } });
14
+ if (require.main === module) {
15
+ new InferPackCommand_1.InferPackCommand(process.argv.slice(2)).execute();
16
+ }
17
+ //# sourceMappingURL=infer_pack.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"infer_pack.js","sourceRoot":"","sources":["../../scripts/infer_pack.ts"],"names":[],"mappings":";;;;AACA,2EAU8C;AAG5C,iGAZA,mCAAgB,OAYA;AAChB,0FAZA,4BAAS,OAYA;AACT,iGAZA,mCAAgB,OAYA;AAChB,6FAZA,+BAAY,OAYA;AACZ,sGAZA,wCAAqB,OAYA;AACrB,kGAZA,oCAAiB,OAYA;AACjB,2FAZA,6BAAU,OAYA;AACV,mGAZA,qCAAkB,OAYA;AAIpB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,mCAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACxD,CAAC"}
@@ -0,0 +1,16 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.newestProjectIn = exports.parseReference = exports.InitFromPackCommand = void 0;
5
+ exports.main = main;
6
+ const InitFromPackCommand_1 = require("./cli/commands/project/InitFromPackCommand");
7
+ Object.defineProperty(exports, "InitFromPackCommand", { enumerable: true, get: function () { return InitFromPackCommand_1.InitFromPackCommand; } });
8
+ Object.defineProperty(exports, "parseReference", { enumerable: true, get: function () { return InitFromPackCommand_1.parseReference; } });
9
+ Object.defineProperty(exports, "newestProjectIn", { enumerable: true, get: function () { return InitFromPackCommand_1.newestProjectIn; } });
10
+ function main(argv) {
11
+ new InitFromPackCommand_1.InitFromPackCommand(argv).execute();
12
+ }
13
+ if (require.main === module) {
14
+ new InitFromPackCommand_1.InitFromPackCommand(process.argv.slice(2)).execute();
15
+ }
16
+ //# sourceMappingURL=init_from_pack.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init_from_pack.js","sourceRoot":"","sources":["../../scripts/init_from_pack.ts"],"names":[],"mappings":";;;;AASA,oBAEC;AAVD,oFAIoD;AAE3C,oGALP,yCAAmB,OAKO;AAAE,+FAJ5B,oCAAc,OAI4B;AAAE,gGAH5C,qCAAe,OAG4C;AAE7D,SAAgB,IAAI,CAAC,IAAc;IACjC,IAAI,yCAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,yCAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3D,CAAC"}
@@ -0,0 +1,16 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.templatesFor = exports.buildContractsPackYaml = exports.buildBackendOrFrontendPackYaml = exports.buildPackYaml = exports.slugify = exports.parseArgs = exports.InitPackCommand = void 0;
5
+ const InitPackCommand_1 = require("./cli/commands/pack/InitPackCommand");
6
+ Object.defineProperty(exports, "InitPackCommand", { enumerable: true, get: function () { return InitPackCommand_1.InitPackCommand; } });
7
+ Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return InitPackCommand_1.parseArgs; } });
8
+ Object.defineProperty(exports, "slugify", { enumerable: true, get: function () { return InitPackCommand_1.slugify; } });
9
+ Object.defineProperty(exports, "buildPackYaml", { enumerable: true, get: function () { return InitPackCommand_1.buildPackYaml; } });
10
+ Object.defineProperty(exports, "buildBackendOrFrontendPackYaml", { enumerable: true, get: function () { return InitPackCommand_1.buildBackendOrFrontendPackYaml; } });
11
+ Object.defineProperty(exports, "buildContractsPackYaml", { enumerable: true, get: function () { return InitPackCommand_1.buildContractsPackYaml; } });
12
+ Object.defineProperty(exports, "templatesFor", { enumerable: true, get: function () { return InitPackCommand_1.templatesFor; } });
13
+ if (require.main === module) {
14
+ new InitPackCommand_1.InitPackCommand(process.argv.slice(2)).execute();
15
+ }
16
+ //# sourceMappingURL=init_pack.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init_pack.js","sourceRoot":"","sources":["../../scripts/init_pack.ts"],"names":[],"mappings":";;;;AACA,yEAQ6C;AAG3C,gGAVA,iCAAe,OAUA;AACf,0FAVA,2BAAS,OAUA;AACT,wFAVA,yBAAO,OAUA;AACP,8FAVA,+BAAa,OAUA;AACb,+GAVA,gDAA8B,OAUA;AAC9B,uGAVA,wCAAsB,OAUA;AACtB,6FAVA,8BAAY,OAUA;AAGd,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,iCAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACvD,CAAC"}
@@ -0,0 +1,17 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.validateConfig = exports.parseConfigYaml = exports.parseConfigKeyValue = exports.parseConfig = exports.parseArgs = exports.KNOWN_KEYS = exports.PROJECT_TYPES = exports.InitProjectCommand = void 0;
5
+ const InitProjectCommand_1 = require("./cli/commands/project/InitProjectCommand");
6
+ Object.defineProperty(exports, "InitProjectCommand", { enumerable: true, get: function () { return InitProjectCommand_1.InitProjectCommand; } });
7
+ Object.defineProperty(exports, "PROJECT_TYPES", { enumerable: true, get: function () { return InitProjectCommand_1.PROJECT_TYPES; } });
8
+ Object.defineProperty(exports, "KNOWN_KEYS", { enumerable: true, get: function () { return InitProjectCommand_1.KNOWN_KEYS; } });
9
+ Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return InitProjectCommand_1.parseArgs; } });
10
+ Object.defineProperty(exports, "parseConfig", { enumerable: true, get: function () { return InitProjectCommand_1.parseConfig; } });
11
+ Object.defineProperty(exports, "parseConfigKeyValue", { enumerable: true, get: function () { return InitProjectCommand_1.parseConfigKeyValue; } });
12
+ Object.defineProperty(exports, "parseConfigYaml", { enumerable: true, get: function () { return InitProjectCommand_1.parseConfigYaml; } });
13
+ Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return InitProjectCommand_1.validateConfig; } });
14
+ if (require.main === module) {
15
+ new InitProjectCommand_1.InitProjectCommand(process.argv.slice(2)).execute();
16
+ }
17
+ //# sourceMappingURL=init_project.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init_project.js","sourceRoot":"","sources":["../../scripts/init_project.ts"],"names":[],"mappings":";;;;AACA,kFASmD;AAGjD,mGAXA,uCAAkB,OAWA;AAClB,8FAXA,kCAAa,OAWA;AACb,2FAXA,+BAAU,OAWA;AACV,0FAXA,8BAAS,OAWA;AACT,4FAXA,gCAAW,OAWA;AACX,oGAXA,wCAAmB,OAWA;AACnB,gGAXA,oCAAe,OAWA;AACf,+FAXA,mCAAc,OAWA;AAGhB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,uCAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC1D,CAAC"}
@@ -0,0 +1,99 @@
1
+ "use strict";
2
+ /**
3
+ * The machine-facing half of every command, in one place.
4
+ *
5
+ * ADR-0017 fixes the contract: one JSON document on stdout per invocation,
6
+ * prose to stderr, failures carrying the command's null-shape, camelCase keys,
7
+ * and a fixed exit-code table. This module is the only implementation of it —
8
+ * before it existed, `change` had its own copy and nothing else complied.
9
+ *
10
+ * A command wires itself in with three calls:
11
+ *
12
+ * const io = agentIo(argv.includes("--json"));
13
+ * io.emit({ plan }, () => renderHumanPlan(plan));
14
+ * io.fail({ plan: null }, [error("no_project", "…", { fix: "…" })]);
15
+ */
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ exports.EXIT = void 0;
18
+ exports.wantsJson = wantsJson;
19
+ exports.agentIo = agentIo;
20
+ const diagnostics_1 = require("./diagnostics");
21
+ /**
22
+ * Exit codes are part of the published contract — an agent branches on them
23
+ * before it parses anything. Success covers advisory warnings: a warning the
24
+ * caller may ignore is not a failure.
25
+ */
26
+ exports.EXIT = Object.freeze({
27
+ OK: 0,
28
+ FAILURE: 1,
29
+ USAGE: 2,
30
+ MISSING_PREREQUISITE: 3,
31
+ CANCELLED: 130,
32
+ });
33
+ /**
34
+ * `--json` and `--format json` mean the same thing. The second spelling
35
+ * predates the contract (`plan --format json`) and keeps working: breaking it
36
+ * would break every pipeline that already uses it.
37
+ */
38
+ function wantsJson(argv) {
39
+ const args = argv || [];
40
+ if (args.includes("--json"))
41
+ return true;
42
+ const i = args.indexOf("--format");
43
+ return i !== -1 && args[i + 1] === "json";
44
+ }
45
+ function writeJson(document) {
46
+ process.stdout.write(`${JSON.stringify(document, null, 2)}\n`);
47
+ }
48
+ function agentIo(json) {
49
+ return {
50
+ json: Boolean(json),
51
+ /**
52
+ * Success. In JSON mode the payload is emitted with a `status` array of
53
+ * diagnostics — empty when there is nothing to report, populated when the
54
+ * command succeeded but has advisory warnings.
55
+ */
56
+ emit(payload, renderHuman) {
57
+ if (json) {
58
+ writeJson({ ...payload, status: payload.status || [] });
59
+ }
60
+ else if (renderHuman) {
61
+ renderHuman();
62
+ }
63
+ },
64
+ /**
65
+ * Failure, exit 1. The null-shape matters: a consumer never has to tell
66
+ * "the command failed" apart from "the command printed nothing", because
67
+ * the document has the same keys either way.
68
+ */
69
+ fail(nullShape, diags) {
70
+ if (json) {
71
+ writeJson({ ...nullShape, status: diags });
72
+ }
73
+ else {
74
+ (0, diagnostics_1.printDiagnostics)(diags);
75
+ }
76
+ process.exit(exports.EXIT.FAILURE);
77
+ },
78
+ /** A malformed invocation — unknown flag, missing argument. Exit 2. */
79
+ usage(nullShape, diags) {
80
+ if (json) {
81
+ writeJson({ ...nullShape, status: diags });
82
+ }
83
+ else {
84
+ (0, diagnostics_1.printDiagnostics)(diags);
85
+ }
86
+ process.exit(exports.EXIT.USAGE);
87
+ },
88
+ /**
89
+ * Emit, then exit 1 if any diagnostic is an error. For commands that are
90
+ * themselves gates: `validate` reports and fails in the same breath.
91
+ */
92
+ emitAndGate(payload, renderHuman) {
93
+ this.emit(payload, renderHuman);
94
+ if ((0, diagnostics_1.hasErrors)(payload.status || []))
95
+ process.exit(exports.EXIT.FAILURE);
96
+ },
97
+ };
98
+ }
99
+ //# sourceMappingURL=agent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../scripts/lib/agent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAuBH,8BAKC;AA4BD,0BAkDC;AAxGD,+CAA4D;AAG5D;;;;GAIG;AACU,QAAA,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,CAAC;IACL,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,oBAAoB,EAAE,CAAC;IACvB,SAAS,EAAE,GAAG;CACf,CAAC,CAAC;AAEH;;;;GAIG;AACH,SAAgB,SAAS,CAAC,IAAI;IAC5B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC;AAC5C,CAAC;AAED,SAAS,SAAS,CAAC,QAAuB;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAwBD,SAAgB,OAAO,CAAC,IAAa;IACnC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;QAEnB;;;;WAIG;QACH,IAAI,CAAC,OAAsB,EAAE,WAAwB;YACnD,IAAI,IAAI,EAAE,CAAC;gBACT,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1D,CAAC;iBAAM,IAAI,WAAW,EAAE,CAAC;gBACvB,WAAW,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAED;;;;WAIG;QACH,IAAI,CAAC,SAAwB,EAAE,KAAmB;YAChD,IAAI,IAAI,EAAE,CAAC;gBACT,SAAS,CAAC,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,IAAA,8BAAgB,EAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,YAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAED,uEAAuE;QACvE,KAAK,CAAC,SAAwB,EAAE,KAAmB;YACjD,IAAI,IAAI,EAAE,CAAC;gBACT,SAAS,CAAC,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,IAAA,8BAAgB,EAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,YAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAED;;;WAGG;QACH,WAAW,CAAC,OAAsB,EAAE,WAAwB;YAC1D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAChC,IAAI,IAAA,uBAAS,EAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,YAAI,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC"}