forgecraft-mcp 1.3.2 → 1.6.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 (254) hide show
  1. package/README.md +2 -2
  2. package/dist/analyzers/anchors/anchor-loader.d.ts +47 -0
  3. package/dist/analyzers/anchors/anchor-loader.d.ts.map +1 -0
  4. package/dist/analyzers/anchors/anchor-loader.js +113 -0
  5. package/dist/analyzers/anchors/anchor-loader.js.map +1 -0
  6. package/dist/analyzers/anti-pattern.d.ts.map +1 -1
  7. package/dist/analyzers/anti-pattern.js +38 -26
  8. package/dist/analyzers/anti-pattern.js.map +1 -1
  9. package/dist/analyzers/completeness-helpers.d.ts +5 -0
  10. package/dist/analyzers/completeness-helpers.d.ts.map +1 -1
  11. package/dist/analyzers/completeness-helpers.js +17 -0
  12. package/dist/analyzers/completeness-helpers.js.map +1 -1
  13. package/dist/analyzers/completeness.d.ts.map +1 -1
  14. package/dist/analyzers/completeness.js +4 -4
  15. package/dist/analyzers/completeness.js.map +1 -1
  16. package/dist/analyzers/gs-scorer.d.ts +3 -1
  17. package/dist/analyzers/gs-scorer.d.ts.map +1 -1
  18. package/dist/analyzers/gs-scorer.js +5 -2
  19. package/dist/analyzers/gs-scorer.js.map +1 -1
  20. package/dist/analyzers/scorers/composable-scorer.d.ts +4 -2
  21. package/dist/analyzers/scorers/composable-scorer.d.ts.map +1 -1
  22. package/dist/analyzers/scorers/composable-scorer.js +50 -2
  23. package/dist/analyzers/scorers/composable-scorer.js.map +1 -1
  24. package/dist/analyzers/scorers/executable-scorer.d.ts +3 -2
  25. package/dist/analyzers/scorers/executable-scorer.d.ts.map +1 -1
  26. package/dist/analyzers/scorers/executable-scorer.js +64 -4
  27. package/dist/analyzers/scorers/executable-scorer.js.map +1 -1
  28. package/dist/analyzers/scorers/scorer-utils.d.ts +5 -3
  29. package/dist/analyzers/scorers/scorer-utils.d.ts.map +1 -1
  30. package/dist/analyzers/scorers/scorer-utils.js +34 -9
  31. package/dist/analyzers/scorers/scorer-utils.js.map +1 -1
  32. package/dist/analyzers/scorers/self-describing-scorer.d.ts +7 -4
  33. package/dist/analyzers/scorers/self-describing-scorer.d.ts.map +1 -1
  34. package/dist/analyzers/scorers/self-describing-scorer.js +17 -18
  35. package/dist/analyzers/scorers/self-describing-scorer.js.map +1 -1
  36. package/dist/artifacts/commit-hooks.d.ts +1 -1
  37. package/dist/artifacts/commit-hooks.d.ts.map +1 -1
  38. package/dist/artifacts/commit-hooks.js +2 -0
  39. package/dist/artifacts/commit-hooks.js.map +1 -1
  40. package/dist/cli/commands.d.ts +35 -1
  41. package/dist/cli/commands.d.ts.map +1 -1
  42. package/dist/cli/commands.js +109 -2
  43. package/dist/cli/commands.js.map +1 -1
  44. package/dist/cli/help.d.ts.map +1 -1
  45. package/dist/cli/help.js +7 -0
  46. package/dist/cli/help.js.map +1 -1
  47. package/dist/cli.d.ts.map +1 -1
  48. package/dist/cli.js +10 -1
  49. package/dist/cli.js.map +1 -1
  50. package/dist/disciplines/catalog.d.ts +16 -0
  51. package/dist/disciplines/catalog.d.ts.map +1 -0
  52. package/dist/disciplines/catalog.js +196 -0
  53. package/dist/disciplines/catalog.js.map +1 -0
  54. package/dist/disciplines/runner.d.ts +13 -0
  55. package/dist/disciplines/runner.d.ts.map +1 -0
  56. package/dist/disciplines/runner.js +35 -0
  57. package/dist/disciplines/runner.js.map +1 -0
  58. package/dist/registry/remote-gates.js +1 -1
  59. package/dist/registry/remote-gates.js.map +1 -1
  60. package/dist/sentinel/detect.d.ts +41 -0
  61. package/dist/sentinel/detect.d.ts.map +1 -0
  62. package/dist/sentinel/detect.js +122 -0
  63. package/dist/sentinel/detect.js.map +1 -0
  64. package/dist/sentinel/write.d.ts +54 -0
  65. package/dist/sentinel/write.d.ts.map +1 -0
  66. package/dist/sentinel/write.js +75 -0
  67. package/dist/sentinel/write.js.map +1 -0
  68. package/dist/shared/cnt-health.d.ts.map +1 -1
  69. package/dist/shared/cnt-health.js +12 -4
  70. package/dist/shared/cnt-health.js.map +1 -1
  71. package/dist/shared/config.d.ts +8 -0
  72. package/dist/shared/config.d.ts.map +1 -1
  73. package/dist/shared/config.js +23 -0
  74. package/dist/shared/config.js.map +1 -1
  75. package/dist/shared/project-gates-helpers.d.ts +9 -0
  76. package/dist/shared/project-gates-helpers.d.ts.map +1 -1
  77. package/dist/shared/project-gates-helpers.js +35 -0
  78. package/dist/shared/project-gates-helpers.js.map +1 -1
  79. package/dist/shared/result-utils.d.ts +27 -0
  80. package/dist/shared/result-utils.d.ts.map +1 -0
  81. package/dist/shared/result-utils.js +41 -0
  82. package/dist/shared/result-utils.js.map +1 -0
  83. package/dist/shared/types/config.d.ts +7 -1
  84. package/dist/shared/types/config.d.ts.map +1 -1
  85. package/dist/shared/types/gates.d.ts +28 -0
  86. package/dist/shared/types/gates.d.ts.map +1 -1
  87. package/dist/shared/types/project.d.ts +66 -0
  88. package/dist/shared/types/project.d.ts.map +1 -1
  89. package/dist/shared/types/project.js.map +1 -1
  90. package/dist/shared/types/verify.d.ts +51 -1
  91. package/dist/shared/types/verify.d.ts.map +1 -1
  92. package/dist/shared/types/verify.js +37 -1
  93. package/dist/shared/types/verify.js.map +1 -1
  94. package/dist/tools/advise-session-advisor.d.ts +16 -0
  95. package/dist/tools/advise-session-advisor.d.ts.map +1 -0
  96. package/dist/tools/advise-session-advisor.js +89 -0
  97. package/dist/tools/advise-session-advisor.js.map +1 -0
  98. package/dist/tools/advise-session-signals.d.ts +21 -0
  99. package/dist/tools/advise-session-signals.d.ts.map +1 -0
  100. package/dist/tools/advise-session-signals.js +113 -0
  101. package/dist/tools/advise-session-signals.js.map +1 -0
  102. package/dist/tools/advise-session.d.ts +22 -0
  103. package/dist/tools/advise-session.d.ts.map +1 -0
  104. package/dist/tools/advise-session.js +31 -0
  105. package/dist/tools/advise-session.js.map +1 -0
  106. package/dist/tools/change-request.d.ts +53 -0
  107. package/dist/tools/change-request.d.ts.map +1 -0
  108. package/dist/tools/change-request.js +375 -0
  109. package/dist/tools/change-request.js.map +1 -0
  110. package/dist/tools/check-cascade-contracts.d.ts +13 -0
  111. package/dist/tools/check-cascade-contracts.d.ts.map +1 -1
  112. package/dist/tools/check-cascade-contracts.js +73 -2
  113. package/dist/tools/check-cascade-contracts.js.map +1 -1
  114. package/dist/tools/check-cascade.d.ts +4 -3
  115. package/dist/tools/check-cascade.d.ts.map +1 -1
  116. package/dist/tools/check-cascade.js +30 -12
  117. package/dist/tools/check-cascade.js.map +1 -1
  118. package/dist/tools/check-spec-consistency.d.ts +25 -0
  119. package/dist/tools/check-spec-consistency.d.ts.map +1 -0
  120. package/dist/tools/check-spec-consistency.js +339 -0
  121. package/dist/tools/check-spec-consistency.js.map +1 -0
  122. package/dist/tools/check-t4.d.ts +54 -0
  123. package/dist/tools/check-t4.d.ts.map +1 -0
  124. package/dist/tools/check-t4.js +305 -0
  125. package/dist/tools/check-t4.js.map +1 -0
  126. package/dist/tools/close-cycle-helpers.d.ts +21 -2
  127. package/dist/tools/close-cycle-helpers.d.ts.map +1 -1
  128. package/dist/tools/close-cycle-helpers.js +66 -10
  129. package/dist/tools/close-cycle-helpers.js.map +1 -1
  130. package/dist/tools/close-cycle.d.ts +2 -2
  131. package/dist/tools/close-cycle.d.ts.map +1 -1
  132. package/dist/tools/close-cycle.js +342 -4
  133. package/dist/tools/close-cycle.js.map +1 -1
  134. package/dist/tools/consolidate-status.d.ts +112 -0
  135. package/dist/tools/consolidate-status.d.ts.map +1 -0
  136. package/dist/tools/consolidate-status.js +356 -0
  137. package/dist/tools/consolidate-status.js.map +1 -0
  138. package/dist/tools/executable-gates.d.ts +52 -0
  139. package/dist/tools/executable-gates.d.ts.map +1 -0
  140. package/dist/tools/executable-gates.js +332 -0
  141. package/dist/tools/executable-gates.js.map +1 -0
  142. package/dist/tools/forgecraft-dispatch-extended.d.ts.map +1 -1
  143. package/dist/tools/forgecraft-dispatch-extended.js +75 -0
  144. package/dist/tools/forgecraft-dispatch-extended.js.map +1 -1
  145. package/dist/tools/forgecraft-dispatch.d.ts.map +1 -1
  146. package/dist/tools/forgecraft-dispatch.js +21 -0
  147. package/dist/tools/forgecraft-dispatch.js.map +1 -1
  148. package/dist/tools/forgecraft-router.d.ts +8 -0
  149. package/dist/tools/forgecraft-router.d.ts.map +1 -1
  150. package/dist/tools/forgecraft-router.js +21 -1
  151. package/dist/tools/forgecraft-router.js.map +1 -1
  152. package/dist/tools/forgecraft-schema-params.d.ts +61 -4
  153. package/dist/tools/forgecraft-schema-params.d.ts.map +1 -1
  154. package/dist/tools/forgecraft-schema-params.js +95 -0
  155. package/dist/tools/forgecraft-schema-params.js.map +1 -1
  156. package/dist/tools/forgecraft-schema.d.ts +62 -5
  157. package/dist/tools/forgecraft-schema.d.ts.map +1 -1
  158. package/dist/tools/forgecraft-schema.js +24 -0
  159. package/dist/tools/forgecraft-schema.js.map +1 -1
  160. package/dist/tools/gate-violations.d.ts +59 -0
  161. package/dist/tools/gate-violations.d.ts.map +1 -0
  162. package/dist/tools/gate-violations.js +152 -0
  163. package/dist/tools/gate-violations.js.map +1 -0
  164. package/dist/tools/generate-adr.js +6 -6
  165. package/dist/tools/generate-adr.js.map +1 -1
  166. package/dist/tools/generate-env-probe.d.ts +49 -0
  167. package/dist/tools/generate-env-probe.d.ts.map +1 -0
  168. package/dist/tools/generate-env-probe.js +365 -0
  169. package/dist/tools/generate-env-probe.js.map +1 -0
  170. package/dist/tools/generate-harness.d.ts +52 -0
  171. package/dist/tools/generate-harness.d.ts.map +1 -0
  172. package/dist/tools/generate-harness.js +333 -0
  173. package/dist/tools/generate-harness.js.map +1 -0
  174. package/dist/tools/generate-roadmap.d.ts +1 -1
  175. package/dist/tools/generate-roadmap.d.ts.map +1 -1
  176. package/dist/tools/generate-roadmap.js +38 -4
  177. package/dist/tools/generate-roadmap.js.map +1 -1
  178. package/dist/tools/generate-session-prompt.d.ts +4 -4
  179. package/dist/tools/generate-session-prompt.d.ts.map +1 -1
  180. package/dist/tools/generate-session-prompt.js +66 -16
  181. package/dist/tools/generate-session-prompt.js.map +1 -1
  182. package/dist/tools/generate-slo-probe.d.ts +53 -0
  183. package/dist/tools/generate-slo-probe.d.ts.map +1 -0
  184. package/dist/tools/generate-slo-probe.js +366 -0
  185. package/dist/tools/generate-slo-probe.js.map +1 -0
  186. package/dist/tools/layer-status-gates.d.ts +24 -0
  187. package/dist/tools/layer-status-gates.d.ts.map +1 -0
  188. package/dist/tools/layer-status-gates.js +151 -0
  189. package/dist/tools/layer-status-gates.js.map +1 -0
  190. package/dist/tools/layer-status.d.ts +133 -0
  191. package/dist/tools/layer-status.d.ts.map +1 -0
  192. package/dist/tools/layer-status.js +593 -0
  193. package/dist/tools/layer-status.js.map +1 -0
  194. package/dist/tools/postcondition-coverage.d.ts +57 -0
  195. package/dist/tools/postcondition-coverage.d.ts.map +1 -0
  196. package/dist/tools/postcondition-coverage.js +256 -0
  197. package/dist/tools/postcondition-coverage.js.map +1 -0
  198. package/dist/tools/probe-runners.d.ts +21 -0
  199. package/dist/tools/probe-runners.d.ts.map +1 -0
  200. package/dist/tools/probe-runners.js +246 -0
  201. package/dist/tools/probe-runners.js.map +1 -0
  202. package/dist/tools/probe-templates.d.ts +27 -0
  203. package/dist/tools/probe-templates.d.ts.map +1 -0
  204. package/dist/tools/probe-templates.js +279 -0
  205. package/dist/tools/probe-templates.js.map +1 -0
  206. package/dist/tools/propose-session.d.ts +28 -0
  207. package/dist/tools/propose-session.d.ts.map +1 -0
  208. package/dist/tools/propose-session.js +333 -0
  209. package/dist/tools/propose-session.js.map +1 -0
  210. package/dist/tools/roadmap-builder.d.ts +34 -1
  211. package/dist/tools/roadmap-builder.d.ts.map +1 -1
  212. package/dist/tools/roadmap-builder.js +153 -11
  213. package/dist/tools/roadmap-builder.js.map +1 -1
  214. package/dist/tools/run-env-probe.d.ts +57 -0
  215. package/dist/tools/run-env-probe.d.ts.map +1 -0
  216. package/dist/tools/run-env-probe.js +270 -0
  217. package/dist/tools/run-env-probe.js.map +1 -0
  218. package/dist/tools/run-harness.d.ts +52 -0
  219. package/dist/tools/run-harness.d.ts.map +1 -0
  220. package/dist/tools/run-harness.js +279 -0
  221. package/dist/tools/run-harness.js.map +1 -0
  222. package/dist/tools/run-slo-probe.d.ts +50 -0
  223. package/dist/tools/run-slo-probe.d.ts.map +1 -0
  224. package/dist/tools/run-slo-probe.js +281 -0
  225. package/dist/tools/run-slo-probe.js.map +1 -0
  226. package/dist/tools/scaffold-writer.d.ts.map +1 -1
  227. package/dist/tools/scaffold-writer.js +4 -0
  228. package/dist/tools/scaffold-writer.js.map +1 -1
  229. package/dist/tools/session-prompt-builders.d.ts +20 -0
  230. package/dist/tools/session-prompt-builders.d.ts.map +1 -1
  231. package/dist/tools/session-prompt-builders.js +111 -14
  232. package/dist/tools/session-prompt-builders.js.map +1 -1
  233. package/dist/tools/session-prompt-sections.d.ts +4 -2
  234. package/dist/tools/session-prompt-sections.d.ts.map +1 -1
  235. package/dist/tools/session-prompt-sections.js +22 -10
  236. package/dist/tools/session-prompt-sections.js.map +1 -1
  237. package/dist/tools/setup-monitoring.d.ts +41 -0
  238. package/dist/tools/setup-monitoring.d.ts.map +1 -0
  239. package/dist/tools/setup-monitoring.js +364 -0
  240. package/dist/tools/setup-monitoring.js.map +1 -0
  241. package/dist/tools/verify-formatter.d.ts.map +1 -1
  242. package/dist/tools/verify-formatter.js +15 -1
  243. package/dist/tools/verify-formatter.js.map +1 -1
  244. package/dist/tools/verify.d.ts.map +1 -1
  245. package/dist/tools/verify.js +3 -0
  246. package/dist/tools/verify.js.map +1 -1
  247. package/package.json +11 -2
  248. package/templates/api/harness/uc-template.hurl +20 -0
  249. package/templates/docs-manifest.yaml +224 -0
  250. package/templates/game/harness/uc-template.sim.ts +29 -0
  251. package/templates/universal/claude-md-blocks/layer-navigation.md +20 -0
  252. package/templates/universal/claude-md-blocks/nfr-contracts.md +22 -0
  253. package/templates/universal/hooks.yaml +212 -20
  254. package/templates/web-react/harness/uc-template.spec.ts +35 -0
@@ -0,0 +1,52 @@
1
+ /**
2
+ * generate_harness tool handler.
3
+ *
4
+ * Reads UC specs from docs/use-cases.md and probe blueprints from
5
+ * .forgecraft/harness/uc-NNN.yaml, then scaffolds executable probe files
6
+ * in tests/harness/. Idempotent: skips existing files unless force=true.
7
+ */
8
+ import { z } from "zod";
9
+ import type { ToolResult } from "../shared/types.js";
10
+ export declare const generateHarnessSchema: z.ZodObject<{
11
+ project_dir: z.ZodString;
12
+ uc_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
13
+ force: z.ZodOptional<z.ZodBoolean>;
14
+ }, "strip", z.ZodTypeAny, {
15
+ project_dir: string;
16
+ force?: boolean | undefined;
17
+ uc_ids?: string[] | undefined;
18
+ }, {
19
+ project_dir: string;
20
+ force?: boolean | undefined;
21
+ uc_ids?: string[] | undefined;
22
+ }>;
23
+ export type GenerateHarnessInput = z.infer<typeof generateHarnessSchema>;
24
+ export interface ProbeSpec {
25
+ uc: string;
26
+ title: string;
27
+ action?: string;
28
+ probes?: Array<{
29
+ id: string;
30
+ type: string;
31
+ scenario?: string;
32
+ description?: string;
33
+ }>;
34
+ }
35
+ export type ProbeType = "playwright" | "api_call" | "hurl" | "graphql" | "file_system" | "mcp_call" | "headless_sim" | "db_query" | "message_queue" | "performance" | "websocket" | "log_assertion" | "a11y" | "contract_consumer" | "contract_provider" | "grpc" | "security_scan";
36
+ export interface GenerateResult {
37
+ ucId: string;
38
+ title: string;
39
+ status: "generated" | "skipped" | "no_spec";
40
+ probeFile?: string;
41
+ probeType?: string;
42
+ reason?: string;
43
+ }
44
+ export interface ErrorCase {
45
+ name: string;
46
+ slug: string;
47
+ description: string;
48
+ }
49
+ export declare function extensionForType(probeType: ProbeType): string;
50
+ export declare function parseErrorCases(ucSection: string): ErrorCase[];
51
+ export declare function generateHarnessHandler(args: GenerateHarnessInput): Promise<ToolResult>;
52
+ //# sourceMappingURL=generate-harness.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-harness.d.ts","sourceRoot":"","sources":["../../src/tools/generate-harness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAehC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIzE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,UAAU,GACV,MAAM,GACN,SAAS,GACT,aAAa,GACb,UAAU,GACV,cAAc,GACd,UAAU,GACV,eAAe,GACf,aAAa,GACb,WAAW,GACX,eAAe,GACf,MAAM,GACN,mBAAmB,GACnB,mBAAmB,GACnB,MAAM,GACN,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AA6BD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAoC7D;AAID,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,CAyB9D;AA4JD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CAkHrB"}
@@ -0,0 +1,333 @@
1
+ /**
2
+ * generate_harness tool handler.
3
+ *
4
+ * Reads UC specs from docs/use-cases.md and probe blueprints from
5
+ * .forgecraft/harness/uc-NNN.yaml, then scaffolds executable probe files
6
+ * in tests/harness/. Idempotent: skips existing files unless force=true.
7
+ */
8
+ import { z } from "zod";
9
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
10
+ import { join, resolve } from "node:path";
11
+ import yaml from "js-yaml";
12
+ import { parseUseCases } from "./layer-status.js";
13
+ import { generateProbeContent } from "./probe-templates.js";
14
+ // ── Schema ───────────────────────────────────────────────────────────
15
+ export const generateHarnessSchema = z.object({
16
+ project_dir: z.string().describe("Absolute path to the project root."),
17
+ uc_ids: z
18
+ .array(z.string())
19
+ .optional()
20
+ .describe("Specific UC ids to generate probes for (e.g. ['UC-001', 'UC-003']). " +
21
+ "If omitted, generates for all UCs with harness specs."),
22
+ force: z
23
+ .boolean()
24
+ .optional()
25
+ .describe("Overwrite existing probe files. Default: false — skip UCs that already have probe files."),
26
+ });
27
+ // ── Tag → probe type mapping ──────────────────────────────────────────
28
+ const TAG_PROBE_MAP = {
29
+ "WEB-REACT": "playwright",
30
+ "WEB-STATIC": "playwright",
31
+ API: "api_call",
32
+ GAME: "headless_sim",
33
+ CLI: "file_system",
34
+ DATABASE: "db_query",
35
+ "DATA-PIPELINE": "db_query",
36
+ REALTIME: "websocket",
37
+ SOCIAL: "websocket",
38
+ FINTECH: "performance",
39
+ HEALTHCARE: "a11y",
40
+ HIPAA: "a11y",
41
+ };
42
+ function defaultProbeTypeForTags(tags) {
43
+ for (const tag of tags) {
44
+ const mapped = TAG_PROBE_MAP[tag];
45
+ if (mapped)
46
+ return mapped;
47
+ }
48
+ return "file_system";
49
+ }
50
+ // ── Probe file extension mapping ──────────────────────────────────────
51
+ export function extensionForType(probeType) {
52
+ switch (probeType) {
53
+ case "playwright":
54
+ return ".spec.ts";
55
+ case "api_call":
56
+ case "hurl":
57
+ return ".hurl";
58
+ case "graphql":
59
+ return ".graphql.hurl";
60
+ case "headless_sim":
61
+ return ".sim.ts";
62
+ case "db_query":
63
+ return ".db.sh";
64
+ case "message_queue":
65
+ return ".mq.sh";
66
+ case "performance":
67
+ return ".k6.js";
68
+ case "websocket":
69
+ return ".ws.sh";
70
+ case "log_assertion":
71
+ return ".log.sh";
72
+ case "a11y":
73
+ return ".a11y.spec.ts";
74
+ case "contract_consumer":
75
+ return ".consumer.test.ts";
76
+ case "contract_provider":
77
+ return ".provider.test.ts";
78
+ case "grpc":
79
+ return ".grpc.sh";
80
+ case "security_scan":
81
+ return ".zap.sh";
82
+ case "mcp_call":
83
+ case "file_system":
84
+ default:
85
+ return ".sh";
86
+ }
87
+ }
88
+ // ── Error case parsing ────────────────────────────────────────────────
89
+ export function parseErrorCases(ucSection) {
90
+ const errorCasesMatch = /\*\*Error Cases\*\*:([\s\S]*?)(?=\n\*\*|\n##|$)/i.exec(ucSection);
91
+ if (!errorCasesMatch)
92
+ return [];
93
+ const errorBlock = errorCasesMatch[1];
94
+ const cases = [];
95
+ const linePattern = /^\s+-\s+(.+?):\s*(.+)$/gm;
96
+ let m;
97
+ while ((m = linePattern.exec(errorBlock)) !== null) {
98
+ const name = m[1].trim();
99
+ const description = m[2].trim();
100
+ const slug = name
101
+ .toLowerCase()
102
+ .replace(/`/g, "")
103
+ .replace(/_/g, "-")
104
+ .replace(/[^a-z0-9\s-]/g, "")
105
+ .trim()
106
+ .replace(/\s+/g, "-")
107
+ .replace(/-+/g, "-");
108
+ cases.push({ name, slug, description });
109
+ }
110
+ return cases;
111
+ }
112
+ function readUcDetails(projectDir, ucId) {
113
+ const useCasesPath = join(projectDir, "docs", "use-cases.md");
114
+ const fallback = {
115
+ precondition: "(see use case)",
116
+ postcondition: "(see use case)",
117
+ steps: [],
118
+ errorCases: [],
119
+ };
120
+ if (!existsSync(useCasesPath))
121
+ return fallback;
122
+ try {
123
+ const content = readFileSync(useCasesPath, "utf-8");
124
+ const ucPattern = new RegExp(`##\\s+${ucId}:[\\s\\S]*?(?=\\n##\\s+UC-|$)`, "i");
125
+ const match = ucPattern.exec(content);
126
+ if (!match)
127
+ return fallback;
128
+ const section = match[0];
129
+ const preMatch = /\*\*Precondition\*\*:\s*(.+)/i.exec(section);
130
+ const postMatch = /\*\*Postcondition\*\*:\s*(.+)/i.exec(section);
131
+ const steps = [];
132
+ const stepPattern = /^\s+\d+\.\s+(.+)$/gm;
133
+ let m;
134
+ while ((m = stepPattern.exec(section)) !== null) {
135
+ steps.push(m[1].trim());
136
+ }
137
+ return {
138
+ precondition: preMatch ? preMatch[1].trim() : "(see use case)",
139
+ postcondition: postMatch ? postMatch[1].trim() : "(see use case)",
140
+ steps,
141
+ errorCases: parseErrorCases(section),
142
+ };
143
+ }
144
+ catch {
145
+ return fallback;
146
+ }
147
+ }
148
+ // ── Probe spec reader ─────────────────────────────────────────────────
149
+ function readProbeSpec(projectDir, ucId) {
150
+ const specPath = join(projectDir, ".forgecraft", "harness", `${ucId.toLowerCase()}.yaml`);
151
+ if (!existsSync(specPath))
152
+ return null;
153
+ try {
154
+ const raw = readFileSync(specPath, "utf-8");
155
+ return yaml.load(raw);
156
+ }
157
+ catch {
158
+ return null;
159
+ }
160
+ }
161
+ const PROBE_TYPE_PRIORITY = [
162
+ "playwright",
163
+ "a11y",
164
+ "api_call",
165
+ "hurl",
166
+ "graphql",
167
+ "headless_sim",
168
+ "db_query",
169
+ "message_queue",
170
+ "performance",
171
+ "websocket",
172
+ "log_assertion",
173
+ "contract_consumer",
174
+ "contract_provider",
175
+ "grpc",
176
+ "security_scan",
177
+ "mcp_call",
178
+ "file_system",
179
+ ];
180
+ function detectProbeType(spec, tags) {
181
+ const types = (spec.probes ?? []).map((p) => p.type);
182
+ if (types.length > 0) {
183
+ for (const pt of PROBE_TYPE_PRIORITY) {
184
+ if (types.includes(pt))
185
+ return pt;
186
+ }
187
+ return types[0];
188
+ }
189
+ return defaultProbeTypeForTags(tags);
190
+ }
191
+ // ── Tags reader ───────────────────────────────────────────────────────
192
+ function readProjectTags(projectDir) {
193
+ const yamlPath = join(projectDir, "forgecraft.yaml");
194
+ if (!existsSync(yamlPath))
195
+ return [];
196
+ try {
197
+ const raw = readFileSync(yamlPath, "utf-8");
198
+ const parsed = yaml.load(raw);
199
+ return parsed?.tags ?? [];
200
+ }
201
+ catch {
202
+ return [];
203
+ }
204
+ }
205
+ // ── Probe file writer ─────────────────────────────────────────────────
206
+ function writeProbeFile(harnessDir, fileName, content, force, ucId, title, probeType, results) {
207
+ const filePath = join(harnessDir, fileName);
208
+ if (existsSync(filePath) && !force) {
209
+ results.push({
210
+ ucId,
211
+ title,
212
+ status: "skipped",
213
+ probeFile: `tests/harness/${fileName}`,
214
+ probeType,
215
+ reason: "already exists",
216
+ });
217
+ return;
218
+ }
219
+ try {
220
+ writeFileSync(filePath, content, "utf-8");
221
+ results.push({
222
+ ucId,
223
+ title,
224
+ status: "generated",
225
+ probeFile: `tests/harness/${fileName}`,
226
+ probeType,
227
+ });
228
+ }
229
+ catch (err) {
230
+ results.push({
231
+ ucId,
232
+ title,
233
+ status: "no_spec",
234
+ reason: `write failed: ${String(err)}`,
235
+ });
236
+ }
237
+ }
238
+ // ── Handler ───────────────────────────────────────────────────────────
239
+ export async function generateHarnessHandler(args) {
240
+ const projectDir = resolve(args.project_dir);
241
+ const force = args.force ?? false;
242
+ const useCasesPath = join(projectDir, "docs", "use-cases.md");
243
+ let ucs = [];
244
+ if (existsSync(useCasesPath)) {
245
+ try {
246
+ ucs = parseUseCases(readFileSync(useCasesPath, "utf-8"));
247
+ }
248
+ catch {
249
+ /* leave empty */
250
+ }
251
+ }
252
+ const targetUcIds = args.uc_ids
253
+ ? new Set(args.uc_ids.map((id) => id.toUpperCase()))
254
+ : null;
255
+ const filteredUcs = targetUcIds
256
+ ? ucs.filter((uc) => targetUcIds.has(uc.id.toUpperCase()))
257
+ : ucs;
258
+ const tags = readProjectTags(projectDir);
259
+ const harnessDir = join(projectDir, "tests", "harness");
260
+ try {
261
+ mkdirSync(harnessDir, { recursive: true });
262
+ }
263
+ catch {
264
+ /* ignore */
265
+ }
266
+ const results = [];
267
+ for (const uc of filteredUcs) {
268
+ const spec = readProbeSpec(projectDir, uc.id);
269
+ if (!spec) {
270
+ results.push({ ucId: uc.id, title: uc.title, status: "no_spec" });
271
+ continue;
272
+ }
273
+ const probeType = detectProbeType(spec, tags);
274
+ const ext = extensionForType(probeType);
275
+ const legacyFileName = `${uc.id.toLowerCase()}${ext}`;
276
+ const happyFileName = `${uc.id.toLowerCase()}-happy${ext}`;
277
+ const targetHappyFile = existsSync(join(harnessDir, legacyFileName))
278
+ ? legacyFileName
279
+ : happyFileName;
280
+ const details = readUcDetails(projectDir, uc.id);
281
+ const happyContent = generateProbeContent(uc.id, uc.title, probeType, details, "happy");
282
+ writeProbeFile(harnessDir, targetHappyFile, happyContent, force, uc.id, uc.title, probeType, results);
283
+ // Generate error probes from UC error cases
284
+ for (const errorCase of details.errorCases) {
285
+ const errorFileName = `${uc.id.toLowerCase()}-error-${errorCase.slug}${ext}`;
286
+ const errorDetails = { ...details, postcondition: errorCase.description };
287
+ const errorContent = generateProbeContent(uc.id, uc.title, probeType, errorDetails, "error");
288
+ writeProbeFile(harnessDir, errorFileName, errorContent, force, uc.id, uc.title, probeType, results);
289
+ }
290
+ }
291
+ const ucsWithoutSpec = ucs.filter((uc) => !existsSync(join(projectDir, ".forgecraft", "harness", `${uc.id.toLowerCase()}.yaml`)));
292
+ const generated = results.filter((r) => r.status === "generated");
293
+ const skipped = results.filter((r) => r.status === "skipped");
294
+ const noSpec = results.filter((r) => r.status === "no_spec");
295
+ return {
296
+ content: [
297
+ {
298
+ type: "text",
299
+ text: formatReport(generated, skipped, noSpec, ucsWithoutSpec.length),
300
+ },
301
+ ],
302
+ };
303
+ }
304
+ function formatReport(generated, skipped, noSpec, totalNoSpec) {
305
+ const lines = [
306
+ "## Harness Generation Report",
307
+ "",
308
+ `Generated: ${generated.length} probe files`,
309
+ `Skipped: ${skipped.length} (already exist, use force=true to overwrite)`,
310
+ `No spec: ${totalNoSpec} (no .forgecraft/harness/uc-NNN.yaml — run layer_status to see gaps)`,
311
+ ];
312
+ if (generated.length > 0) {
313
+ lines.push("", "### Generated");
314
+ for (const r of generated) {
315
+ lines.push(`- ✅ ${r.probeFile} (${r.probeType}, ${r.ucId}: ${r.title})`);
316
+ }
317
+ }
318
+ if (skipped.length > 0) {
319
+ lines.push("", "### Skipped (exist)");
320
+ for (const r of skipped) {
321
+ lines.push(`- ⏭ ${r.probeFile} (${r.ucId}: ${r.title})`);
322
+ }
323
+ }
324
+ if (noSpec.length > 0) {
325
+ lines.push("", "### No Harness Spec");
326
+ for (const r of noSpec) {
327
+ lines.push(`- ❌ ${r.ucId}: ${r.title} — create .forgecraft/harness/${r.ucId.toLowerCase()}.yaml first`);
328
+ }
329
+ }
330
+ lines.push("", "Next: implement the TODO sections in each generated file.", "Run: npx forgecraft run_harness --project_dir .");
331
+ return lines.join("\n");
332
+ }
333
+ //# sourceMappingURL=generate-harness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-harness.js","sourceRoot":"","sources":["../../src/tools/generate-harness.ts"],"names":[],"mappings":"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"}
@@ -7,7 +7,7 @@
7
7
  * generate_session_prompt). Idempotent — refuses to overwrite an existing roadmap.
8
8
  */
9
9
  import { z } from "zod";
10
- export { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, formatRmId, } from "./roadmap-builder.js";
10
+ export { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, buildExecutableBringUpStub, buildExecutableVerifyStub, formatRmId, formatExId, EXECUTABLE_SPRINT_HEADER, } from "./roadmap-builder.js";
11
11
  export declare const generateRoadmapSchema: z.ZodObject<{
12
12
  project_dir: z.ZodString;
13
13
  }, "strip", z.ZodTypeAny, {
@@ -1 +1 @@
1
- {"version":3,"file":"generate-roadmap.d.ts","sourceRoot":"","sources":["../../src/tools/generate-roadmap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAI9B,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAIrE;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CAsFrB"}
1
+ {"version":3,"file":"generate-roadmap.d.ts","sourceRoot":"","sources":["../../src/tools/generate-roadmap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,UAAU,EACV,UAAU,EACV,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAI9B,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAIrE;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CAkIrB"}
@@ -10,8 +10,10 @@ import { z } from "zod";
10
10
  import { existsSync, mkdirSync, writeFileSync } from "node:fs";
11
11
  import { join, resolve } from "node:path";
12
12
  import { runCascadeChecks, isCascadeComplete, buildGuidedRemediation, loadCascadeDecisions, } from "./check-cascade.js";
13
- import { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, formatRmId, } from "./roadmap-builder.js";
14
- export { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, formatRmId, } from "./roadmap-builder.js";
13
+ import { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, buildExecutableBringUpStub, buildExecutableVerifyStub, formatRmId, formatExId, EXECUTABLE_SPRINT_HEADER, } from "./roadmap-builder.js";
14
+ import { readProjectTags } from "./hardening-config.js";
15
+ import { resolveExecutableGates, gateFilePath } from "./executable-gates.js";
16
+ export { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, buildExecutableBringUpStub, buildExecutableVerifyStub, formatRmId, formatExId, EXECUTABLE_SPRINT_HEADER, } from "./roadmap-builder.js";
15
17
  // ── Schema ───────────────────────────────────────────────────────────
16
18
  export const generateRoadmapSchema = z.object({
17
19
  project_dir: z.string().describe("Absolute path to the project root."),
@@ -60,8 +62,10 @@ export async function generateRoadmapHandler(args) {
60
62
  : "docs/use-cases.md";
61
63
  const projectName = readProjectName(projectDir);
62
64
  const ucItems = parseUseCaseTitles(projectDir);
65
+ const tags = readProjectTags(projectDir);
66
+ const gates = resolveExecutableGates(tags);
63
67
  mkdirSync(join(projectDir, "docs"), { recursive: true });
64
- writeFileSync(roadmapPath, buildRoadmapContent(projectName, ucItems, specFilePath), "utf-8");
68
+ writeFileSync(roadmapPath, buildRoadmapContent(projectName, ucItems, specFilePath, tags), "utf-8");
65
69
  const stubsDir = join(projectDir, "docs", "session-prompts");
66
70
  mkdirSync(stubsDir, { recursive: true });
67
71
  const writtenStubs = [];
@@ -72,16 +76,46 @@ export async function generateRoadmapHandler(args) {
72
76
  writeFileSync(join(stubsDir, `${rmId}.md`), buildSessionPromptStub(rmId, title, uc.id), "utf-8");
73
77
  writtenStubs.push(`docs/session-prompts/${rmId}.md`);
74
78
  }
79
+ // Executable Sprint stubs + gate files
80
+ writeFileSync(join(stubsDir, `${EXECUTABLE_SPRINT_HEADER.id}.md`), buildExecutableBringUpStub(projectName, tags), "utf-8");
81
+ writtenStubs.push(`docs/session-prompts/${EXECUTABLE_SPRINT_HEADER.id}.md`);
82
+ for (let i = 0; i < ucItems.length; i++) {
83
+ const uc = ucItems[i];
84
+ const exId = formatExId(i + 1);
85
+ writeFileSync(join(stubsDir, `${exId}.md`), buildExecutableVerifyStub(exId, uc.id, uc.title, tags), "utf-8");
86
+ writtenStubs.push(`docs/session-prompts/${exId}.md`);
87
+ // Write runnable gate file stubs for each applicable tool
88
+ for (const gate of gates) {
89
+ const relPath = gateFilePath(gate, uc.id);
90
+ const absPath = join(projectDir, relPath);
91
+ mkdirSync(join(absPath, ".."), { recursive: true });
92
+ if (!existsSync(absPath)) {
93
+ writeFileSync(absPath, gate.buildStub(uc.id, uc.title), "utf-8");
94
+ writtenStubs.push(relPath);
95
+ }
96
+ }
97
+ }
75
98
  const phase1List = ucItems
76
99
  .map((uc, i) => `- **${formatRmId(i + 1)}**: Implement ${uc.id}: ${uc.title}`)
77
100
  .join("\n");
101
+ const exList = [
102
+ EXECUTABLE_SPRINT_HEADER,
103
+ ...ucItems.map((uc, i) => ({
104
+ id: formatExId(i + 1),
105
+ title: `Verify live: ${uc.id} — ${uc.title}`,
106
+ })),
107
+ ]
108
+ .map((item) => `- **${item.id}**: ${item.title}`)
109
+ .join("\n");
78
110
  return {
79
111
  content: [
80
112
  {
81
113
  type: "text",
82
114
  text: `## Roadmap Generated\n\n` +
83
- `Written to \`docs/roadmap.md\` with ${ucItems.length} Phase 1 items.\n\n` +
115
+ `Written to \`docs/roadmap.md\` with ${ucItems.length} Phase 1 items + ${ucItems.length + 1} Executable Sprint items.\n\n` +
84
116
  `### Phase 1 Items\n${phase1List}\n\n` +
117
+ `### Executable Sprint Items\n${exList}\n\n` +
118
+ `> Complete the Executable Sprint before Phase 2. Each EX item proves a use case works end-to-end.\n\n` +
85
119
  `### Session Prompt Stubs Written\n` +
86
120
  writtenStubs.map((p) => `- \`${p}\``).join("\n") +
87
121
  `\n\nRun \`generate_session_prompt\` with an item's description to get the full bound prompt.`,
@@ -1 +1 @@
1
- {"version":3,"file":"generate-roadmap.js","sourceRoot":"","sources":["../../src/tools/generate-roadmap.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"generate-roadmap.js","sourceRoot":"","sources":["../../src/tools/generate-roadmap.ts"],"names":[],"mappings":"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"}
@@ -8,8 +8,8 @@
8
8
  */
9
9
  import { z } from "zod";
10
10
  import type { ToolResult, ToolAmbiguity } from "../shared/types.js";
11
- export type { ArtifactContext, PromptBuildInput, McpServerYamlEntry, McpServersYaml } from "./session-prompt-builders.js";
12
- export { buildPrompt, loadMcpServerDescriptions, buildMcpToolsSection, FORGECRAFT_PRIMARY_USE, discoverArtifacts, readStatusSummary, buildDefaultCriteria, } from "./session-prompt-builders.js";
11
+ export type { ArtifactContext, PromptBuildInput, McpServerYamlEntry, McpServersYaml, } from "./session-prompt-builders.js";
12
+ export { buildPrompt, loadMcpServerDescriptions, buildMcpToolsSection, FORGECRAFT_PRIMARY_USE, discoverArtifacts, readStatusSummary, buildDefaultCriteria, detectClarificationMarkers, buildClarificationWarning, } from "./session-prompt-builders.js";
13
13
  export { isPlaceholderTestScript, deriveTestCommand, isServerConfigured, buildContextLoadBlock, buildTddGateSection, buildContextRetrievalSection, buildExecutionLoopSection, } from "./session-prompt-sections.js";
14
14
  export declare const generateSessionPromptSchema: z.ZodObject<{
15
15
  project_dir: z.ZodString;
@@ -20,7 +20,7 @@ export declare const generateSessionPromptSchema: z.ZodObject<{
20
20
  session_type: z.ZodDefault<z.ZodEnum<["feature", "fix", "refactor", "test", "docs", "chore"]>>;
21
21
  }, "strip", z.ZodTypeAny, {
22
22
  project_dir: string;
23
- session_type: "docs" | "test" | "feature" | "fix" | "refactor" | "chore";
23
+ session_type: "test" | "docs" | "feature" | "fix" | "refactor" | "chore";
24
24
  item_description?: string | undefined;
25
25
  acceptance_criteria?: string[] | undefined;
26
26
  scope_note?: string | undefined;
@@ -30,7 +30,7 @@ export declare const generateSessionPromptSchema: z.ZodObject<{
30
30
  item_description?: string | undefined;
31
31
  acceptance_criteria?: string[] | undefined;
32
32
  scope_note?: string | undefined;
33
- session_type?: "docs" | "test" | "feature" | "fix" | "refactor" | "chore" | undefined;
33
+ session_type?: "test" | "docs" | "feature" | "fix" | "refactor" | "chore" | undefined;
34
34
  roadmap_item_id?: string | undefined;
35
35
  }>;
36
36
  export type GenerateSessionPromptInput = z.infer<typeof generateSessionPromptSchema>;
@@ -1 +1 @@
1
- {"version":3,"file":"generate-session-prompt.d.ts","sourceRoot":"","sources":["../../src/tools/generate-session-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUpE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC1H,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AAGtC,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAqCtC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAIrF;;;;;;;;;;;GAWG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,UAAU,CAAC,CA0ErB;AAwDD,YAAY,EAAE,aAAa,EAAE,CAAC"}
1
+ {"version":3,"file":"generate-session-prompt.d.ts","sourceRoot":"","sources":["../../src/tools/generate-session-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAcpE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AAGtC,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAuCtC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,2BAA2B,CACnC,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,UAAU,CAAC,CAkHrB;AAmFD,YAAY,EAAE,aAAa,EAAE,CAAC"}