eai-cli 0.0.0-bootstrap.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (690) hide show
  1. package/LICENSE +183 -0
  2. package/NOTICE +4 -0
  3. package/README.md +14 -0
  4. package/dist/commands/agent.d.ts +3 -0
  5. package/dist/commands/agent.d.ts.map +1 -0
  6. package/dist/commands/agent.js +69 -0
  7. package/dist/commands/agent.js.map +1 -0
  8. package/dist/commands/blocks.d.ts +3 -0
  9. package/dist/commands/blocks.d.ts.map +1 -0
  10. package/dist/commands/blocks.js +249 -0
  11. package/dist/commands/blocks.js.map +1 -0
  12. package/dist/commands/chat.d.ts +6 -0
  13. package/dist/commands/chat.d.ts.map +1 -0
  14. package/dist/commands/chat.js +105 -0
  15. package/dist/commands/chat.js.map +1 -0
  16. package/dist/commands/deploy.d.ts +36 -0
  17. package/dist/commands/deploy.d.ts.map +1 -0
  18. package/dist/commands/deploy.js +712 -0
  19. package/dist/commands/deploy.js.map +1 -0
  20. package/dist/commands/dev.d.ts +15 -0
  21. package/dist/commands/dev.d.ts.map +1 -0
  22. package/dist/commands/dev.js +133 -0
  23. package/dist/commands/dev.js.map +1 -0
  24. package/dist/commands/docs.d.ts +6 -0
  25. package/dist/commands/docs.d.ts.map +1 -0
  26. package/dist/commands/docs.js +118 -0
  27. package/dist/commands/docs.js.map +1 -0
  28. package/dist/commands/env.d.ts +10 -0
  29. package/dist/commands/env.d.ts.map +1 -0
  30. package/dist/commands/env.js +200 -0
  31. package/dist/commands/env.js.map +1 -0
  32. package/dist/commands/errors.d.ts +3 -0
  33. package/dist/commands/errors.d.ts.map +1 -0
  34. package/dist/commands/errors.js +72 -0
  35. package/dist/commands/errors.js.map +1 -0
  36. package/dist/commands/gofer.d.ts +3 -0
  37. package/dist/commands/gofer.d.ts.map +1 -0
  38. package/dist/commands/gofer.js +134 -0
  39. package/dist/commands/gofer.js.map +1 -0
  40. package/dist/commands/init.d.ts +14 -0
  41. package/dist/commands/init.d.ts.map +1 -0
  42. package/dist/commands/init.js +1437 -0
  43. package/dist/commands/init.js.map +1 -0
  44. package/dist/commands/login.d.ts +7 -0
  45. package/dist/commands/login.d.ts.map +1 -0
  46. package/dist/commands/login.js +117 -0
  47. package/dist/commands/login.js.map +1 -0
  48. package/dist/commands/provision.d.ts +6 -0
  49. package/dist/commands/provision.d.ts.map +1 -0
  50. package/dist/commands/provision.js +855 -0
  51. package/dist/commands/provision.js.map +1 -0
  52. package/dist/commands/publicapi.d.ts +6 -0
  53. package/dist/commands/publicapi.d.ts.map +1 -0
  54. package/dist/commands/publicapi.js +184 -0
  55. package/dist/commands/publicapi.js.map +1 -0
  56. package/dist/commands/resources.d.ts +38 -0
  57. package/dist/commands/resources.d.ts.map +1 -0
  58. package/dist/commands/resources.js +1010 -0
  59. package/dist/commands/resources.js.map +1 -0
  60. package/dist/commands/runtime.d.ts +3 -0
  61. package/dist/commands/runtime.d.ts.map +1 -0
  62. package/dist/commands/runtime.js +78 -0
  63. package/dist/commands/runtime.js.map +1 -0
  64. package/dist/commands/template.d.ts +3 -0
  65. package/dist/commands/template.d.ts.map +1 -0
  66. package/dist/commands/template.js +365 -0
  67. package/dist/commands/template.js.map +1 -0
  68. package/dist/commands/tenant.d.ts +45 -0
  69. package/dist/commands/tenant.d.ts.map +1 -0
  70. package/dist/commands/tenant.js +1036 -0
  71. package/dist/commands/tenant.js.map +1 -0
  72. package/dist/commands/types.d.ts +130 -0
  73. package/dist/commands/types.d.ts.map +1 -0
  74. package/dist/commands/types.js +1636 -0
  75. package/dist/commands/types.js.map +1 -0
  76. package/dist/commands/update.d.ts +13 -0
  77. package/dist/commands/update.d.ts.map +1 -0
  78. package/dist/commands/update.js +163 -0
  79. package/dist/commands/update.js.map +1 -0
  80. package/dist/commands/user.d.ts +6 -0
  81. package/dist/commands/user.d.ts.map +1 -0
  82. package/dist/commands/user.js +359 -0
  83. package/dist/commands/user.js.map +1 -0
  84. package/dist/commands/verify.d.ts +40 -0
  85. package/dist/commands/verify.d.ts.map +1 -0
  86. package/dist/commands/verify.js +1442 -0
  87. package/dist/commands/verify.js.map +1 -0
  88. package/dist/commands/vertical.d.ts +24 -0
  89. package/dist/commands/vertical.d.ts.map +1 -0
  90. package/dist/commands/vertical.js +301 -0
  91. package/dist/commands/vertical.js.map +1 -0
  92. package/dist/commands/whoami.d.ts +6 -0
  93. package/dist/commands/whoami.d.ts.map +1 -0
  94. package/dist/commands/whoami.js +73 -0
  95. package/dist/commands/whoami.js.map +1 -0
  96. package/dist/commands/workflow.d.ts +6 -0
  97. package/dist/commands/workflow.d.ts.map +1 -0
  98. package/dist/commands/workflow.js +400 -0
  99. package/dist/commands/workflow.js.map +1 -0
  100. package/dist/index.d.ts +10 -0
  101. package/dist/index.d.ts.map +1 -0
  102. package/dist/index.js +272 -0
  103. package/dist/index.js.map +1 -0
  104. package/dist/lib/agent-guide.d.ts +24 -0
  105. package/dist/lib/agent-guide.d.ts.map +1 -0
  106. package/dist/lib/agent-guide.js +155 -0
  107. package/dist/lib/agent-guide.js.map +1 -0
  108. package/dist/lib/api.d.ts +338 -0
  109. package/dist/lib/api.d.ts.map +1 -0
  110. package/dist/lib/api.js +991 -0
  111. package/dist/lib/api.js.map +1 -0
  112. package/dist/lib/auth.d.ts +65 -0
  113. package/dist/lib/auth.d.ts.map +1 -0
  114. package/dist/lib/auth.js +592 -0
  115. package/dist/lib/auth.js.map +1 -0
  116. package/dist/lib/azure-cli.d.ts +6 -0
  117. package/dist/lib/azure-cli.d.ts.map +1 -0
  118. package/dist/lib/azure-cli.js +13 -0
  119. package/dist/lib/azure-cli.js.map +1 -0
  120. package/dist/lib/block-catalog-normalize.d.ts +47 -0
  121. package/dist/lib/block-catalog-normalize.d.ts.map +1 -0
  122. package/dist/lib/block-catalog-normalize.js +355 -0
  123. package/dist/lib/block-catalog-normalize.js.map +1 -0
  124. package/dist/lib/block-catalog-types.d.ts +111 -0
  125. package/dist/lib/block-catalog-types.d.ts.map +1 -0
  126. package/dist/lib/block-catalog-types.js +41 -0
  127. package/dist/lib/block-catalog-types.js.map +1 -0
  128. package/dist/lib/block-catalog-utils.d.ts +7 -0
  129. package/dist/lib/block-catalog-utils.d.ts.map +1 -0
  130. package/dist/lib/block-catalog-utils.js +47 -0
  131. package/dist/lib/block-catalog-utils.js.map +1 -0
  132. package/dist/lib/block-catalog-validation.d.ts +5 -0
  133. package/dist/lib/block-catalog-validation.d.ts.map +1 -0
  134. package/dist/lib/block-catalog-validation.js +112 -0
  135. package/dist/lib/block-catalog-validation.js.map +1 -0
  136. package/dist/lib/block-catalog.d.ts +3 -0
  137. package/dist/lib/block-catalog.d.ts.map +1 -0
  138. package/dist/lib/block-catalog.js +284 -0
  139. package/dist/lib/block-catalog.js.map +1 -0
  140. package/dist/lib/cloud-env.d.ts +25 -0
  141. package/dist/lib/cloud-env.d.ts.map +1 -0
  142. package/dist/lib/cloud-env.js +79 -0
  143. package/dist/lib/cloud-env.js.map +1 -0
  144. package/dist/lib/config.d.ts +116 -0
  145. package/dist/lib/config.d.ts.map +1 -0
  146. package/dist/lib/config.js +195 -0
  147. package/dist/lib/config.js.map +1 -0
  148. package/dist/lib/context.d.ts +43 -0
  149. package/dist/lib/context.d.ts.map +1 -0
  150. package/dist/lib/context.js +68 -0
  151. package/dist/lib/context.js.map +1 -0
  152. package/dist/lib/error-codes.d.ts +56 -0
  153. package/dist/lib/error-codes.d.ts.map +1 -0
  154. package/dist/lib/error-codes.js +211 -0
  155. package/dist/lib/error-codes.js.map +1 -0
  156. package/dist/lib/error-guidance/catalog.d.ts +648 -0
  157. package/dist/lib/error-guidance/catalog.d.ts.map +1 -0
  158. package/dist/lib/error-guidance/catalog.js +940 -0
  159. package/dist/lib/error-guidance/catalog.js.map +1 -0
  160. package/dist/lib/error-guidance/match.d.ts +3 -0
  161. package/dist/lib/error-guidance/match.d.ts.map +1 -0
  162. package/dist/lib/error-guidance/match.js +46 -0
  163. package/dist/lib/error-guidance/match.js.map +1 -0
  164. package/dist/lib/error-guidance/render.d.ts +5 -0
  165. package/dist/lib/error-guidance/render.d.ts.map +1 -0
  166. package/dist/lib/error-guidance/render.js +92 -0
  167. package/dist/lib/error-guidance/render.js.map +1 -0
  168. package/dist/lib/error-guidance/types.d.ts +76 -0
  169. package/dist/lib/error-guidance/types.d.ts.map +1 -0
  170. package/dist/lib/error-guidance/types.js +2 -0
  171. package/dist/lib/error-guidance/types.js.map +1 -0
  172. package/dist/lib/error-guidance/validate.d.ts +3 -0
  173. package/dist/lib/error-guidance/validate.d.ts.map +1 -0
  174. package/dist/lib/error-guidance/validate.js +59 -0
  175. package/dist/lib/error-guidance/validate.js.map +1 -0
  176. package/dist/lib/gofer-installer.d.ts +32 -0
  177. package/dist/lib/gofer-installer.d.ts.map +1 -0
  178. package/dist/lib/gofer-installer.js +589 -0
  179. package/dist/lib/gofer-installer.js.map +1 -0
  180. package/dist/lib/gofer-refresh.d.ts +46 -0
  181. package/dist/lib/gofer-refresh.d.ts.map +1 -0
  182. package/dist/lib/gofer-refresh.js +536 -0
  183. package/dist/lib/gofer-refresh.js.map +1 -0
  184. package/dist/lib/next-route-exports.d.ts +6 -0
  185. package/dist/lib/next-route-exports.d.ts.map +1 -0
  186. package/dist/lib/next-route-exports.js +127 -0
  187. package/dist/lib/next-route-exports.js.map +1 -0
  188. package/dist/lib/npm.d.ts +2 -0
  189. package/dist/lib/npm.d.ts.map +1 -0
  190. package/dist/lib/npm.js +4 -0
  191. package/dist/lib/npm.js.map +1 -0
  192. package/dist/lib/object-type-defaults.d.ts +4 -0
  193. package/dist/lib/object-type-defaults.d.ts.map +1 -0
  194. package/dist/lib/object-type-defaults.js +72 -0
  195. package/dist/lib/object-type-defaults.js.map +1 -0
  196. package/dist/lib/output.d.ts +35 -0
  197. package/dist/lib/output.d.ts.map +1 -0
  198. package/dist/lib/output.js +166 -0
  199. package/dist/lib/output.js.map +1 -0
  200. package/dist/lib/profile.d.ts +52 -0
  201. package/dist/lib/profile.d.ts.map +1 -0
  202. package/dist/lib/profile.js +116 -0
  203. package/dist/lib/profile.js.map +1 -0
  204. package/dist/lib/project-manifest.d.ts +42 -0
  205. package/dist/lib/project-manifest.d.ts.map +1 -0
  206. package/dist/lib/project-manifest.js +191 -0
  207. package/dist/lib/project-manifest.js.map +1 -0
  208. package/dist/lib/resourceapi-bundle.d.ts +33 -0
  209. package/dist/lib/resourceapi-bundle.d.ts.map +1 -0
  210. package/dist/lib/resourceapi-bundle.js +79 -0
  211. package/dist/lib/resourceapi-bundle.js.map +1 -0
  212. package/dist/lib/runtime-contract.d.ts +84 -0
  213. package/dist/lib/runtime-contract.d.ts.map +1 -0
  214. package/dist/lib/runtime-contract.js +318 -0
  215. package/dist/lib/runtime-contract.js.map +1 -0
  216. package/dist/lib/schema-builder.d.ts +28 -0
  217. package/dist/lib/schema-builder.d.ts.map +1 -0
  218. package/dist/lib/schema-builder.js +69 -0
  219. package/dist/lib/schema-builder.js.map +1 -0
  220. package/dist/lib/tenant-context.d.ts +127 -0
  221. package/dist/lib/tenant-context.d.ts.map +1 -0
  222. package/dist/lib/tenant-context.js +573 -0
  223. package/dist/lib/tenant-context.js.map +1 -0
  224. package/dist/lib/update-check.d.ts +52 -0
  225. package/dist/lib/update-check.d.ts.map +1 -0
  226. package/dist/lib/update-check.js +271 -0
  227. package/dist/lib/update-check.js.map +1 -0
  228. package/dist/lib/update-maintenance.d.ts +15 -0
  229. package/dist/lib/update-maintenance.d.ts.map +1 -0
  230. package/dist/lib/update-maintenance.js +187 -0
  231. package/dist/lib/update-maintenance.js.map +1 -0
  232. package/dist/lib/utils.d.ts +23 -0
  233. package/dist/lib/utils.d.ts.map +1 -0
  234. package/dist/lib/utils.js +48 -0
  235. package/dist/lib/utils.js.map +1 -0
  236. package/dist/lib/workflow-provisioning.d.ts +54 -0
  237. package/dist/lib/workflow-provisioning.d.ts.map +1 -0
  238. package/dist/lib/workflow-provisioning.js +281 -0
  239. package/dist/lib/workflow-provisioning.js.map +1 -0
  240. package/package.json +51 -0
  241. package/resources/gofer/.gofer-version +7 -0
  242. package/resources/gofer/agents-skills/0_gofer_start/SKILL.md +1287 -0
  243. package/resources/gofer/agents-skills/0a_problem_validation/SKILL.md +429 -0
  244. package/resources/gofer/agents-skills/10_gofer_cloud/SKILL.md +635 -0
  245. package/resources/gofer/agents-skills/1_gofer_research/SKILL.md +1159 -0
  246. package/resources/gofer/agents-skills/2_gofer_specify/SKILL.md +860 -0
  247. package/resources/gofer/agents-skills/3_gofer_plan/SKILL.md +886 -0
  248. package/resources/gofer/agents-skills/4_gofer_tasks/SKILL.md +748 -0
  249. package/resources/gofer/agents-skills/5_gofer_implement/SKILL.md +924 -0
  250. package/resources/gofer/agents-skills/6_gofer_validate/SKILL.md +2269 -0
  251. package/resources/gofer/agents-skills/7_gofer_save/SKILL.md +423 -0
  252. package/resources/gofer/agents-skills/7a_stakeholder_comms/SKILL.md +508 -0
  253. package/resources/gofer/agents-skills/8_gofer_branding/SKILL.md +315 -0
  254. package/resources/gofer/agents-skills/9_gofer_tests/SKILL.md +558 -0
  255. package/resources/gofer/agents-skills/gofer_bootstrap_workspace/SKILL.md +148 -0
  256. package/resources/gofer/agents-skills/gofer_check_workspace/SKILL.md +119 -0
  257. package/resources/gofer/agents-skills/gofer_constitution/SKILL.md +612 -0
  258. package/resources/gofer/agents-skills/gofer_diagnose/SKILL.md +114 -0
  259. package/resources/gofer/agents-skills/gofer_eai_first_run/SKILL.md +397 -0
  260. package/resources/gofer/agents-skills/gofer_hydrate/SKILL.md +561 -0
  261. package/resources/gofer/agents-skills/gofer_personality/SKILL.md +44 -0
  262. package/resources/gofer/agents-skills/gofer_plan/SKILL.md +40 -0
  263. package/resources/gofer/agents-skills/gofer_side/SKILL.md +45 -0
  264. package/resources/gofer/agents-skills/gofer_spec_summary/SKILL.md +112 -0
  265. package/resources/gofer/agents-skills/gofer_tdd/SKILL.md +112 -0
  266. package/resources/gofer/agents-skills/gofer_vocabulary/SKILL.md +112 -0
  267. package/resources/gofer/agents-skills/gofer_zoom_out/SKILL.md +112 -0
  268. package/resources/gofer/bash-scripts/check-context-health.sh +365 -0
  269. package/resources/gofer/bash-scripts/check-persona-pack.sh +81 -0
  270. package/resources/gofer/bash-scripts/check-prerequisites.sh +168 -0
  271. package/resources/gofer/bash-scripts/common.sh +192 -0
  272. package/resources/gofer/bash-scripts/create-new-feature.sh +260 -0
  273. package/resources/gofer/bash-scripts/install-optional-tools.sh +270 -0
  274. package/resources/gofer/bash-scripts/log-stage.sh +224 -0
  275. package/resources/gofer/bash-scripts/mark-task-complete.sh +74 -0
  276. package/resources/gofer/bash-scripts/pipeline-state.sh +306 -0
  277. package/resources/gofer/bash-scripts/read-failed-approaches.sh +114 -0
  278. package/resources/gofer/bash-scripts/read-session-memories.sh +96 -0
  279. package/resources/gofer/bash-scripts/save-checkpoint.sh +407 -0
  280. package/resources/gofer/bash-scripts/setup-plan.sh +62 -0
  281. package/resources/gofer/bash-scripts/sync-implementation-status.sh +47 -0
  282. package/resources/gofer/bash-scripts/update-agent-context.sh +772 -0
  283. package/resources/gofer/bash-scripts/validate-artifact.sh +335 -0
  284. package/resources/gofer/bash-scripts/verify-task.sh +384 -0
  285. package/resources/gofer/bash-scripts/write-failed-approach.sh +110 -0
  286. package/resources/gofer/bash-scripts/write-periodic-checkpoint.sh +128 -0
  287. package/resources/gofer/bash-scripts/write-session-memory.sh +118 -0
  288. package/resources/gofer/claude-agents/assumption-tracker.md +168 -0
  289. package/resources/gofer/claude-agents/business-metrics-analyzer.md +169 -0
  290. package/resources/gofer/claude-agents/business-problem-validator.md +168 -0
  291. package/resources/gofer/claude-agents/codebase-analyzer.md +124 -0
  292. package/resources/gofer/claude-agents/codebase-locator.md +95 -0
  293. package/resources/gofer/claude-agents/codebase-pattern-finder.md +180 -0
  294. package/resources/gofer/claude-agents/comms-writer.md +158 -0
  295. package/resources/gofer/claude-agents/engineer-review.md +169 -0
  296. package/resources/gofer/claude-agents/implement-bug-triangulator.md +94 -0
  297. package/resources/gofer/claude-agents/implement-code-review-council.md +89 -0
  298. package/resources/gofer/claude-agents/implement-doc-writer.md +89 -0
  299. package/resources/gofer/claude-agents/implement-error-hardener.md +84 -0
  300. package/resources/gofer/claude-agents/implement-performance-explorer.md +95 -0
  301. package/resources/gofer/claude-agents/implement-test-diversifier.md +82 -0
  302. package/resources/gofer/claude-agents/implement-variant-generator.md +80 -0
  303. package/resources/gofer/claude-agents/multi-perspective-judge.md +114 -0
  304. package/resources/gofer/claude-agents/plan-api-comparator.md +90 -0
  305. package/resources/gofer/claude-agents/plan-architecture-diverger.md +100 -0
  306. package/resources/gofer/claude-agents/plan-data-model-stress-tester.md +95 -0
  307. package/resources/gofer/claude-agents/plan-migration-path-finder.md +95 -0
  308. package/resources/gofer/claude-agents/plan-refactor-rewrite-advisor.md +97 -0
  309. package/resources/gofer/claude-agents/research-dependency-evaluator.md +106 -0
  310. package/resources/gofer/claude-agents/research-horizon-scanner.md +100 -0
  311. package/resources/gofer/claude-agents/research-market-scanner.md +137 -0
  312. package/resources/gofer/claude-agents/research-perspective-multiplier.md +102 -0
  313. package/resources/gofer/claude-agents/scope-creep-detector.md +152 -0
  314. package/resources/gofer/claude-agents/specify-ambiguity-detector.md +95 -0
  315. package/resources/gofer/claude-agents/specify-journey-stress-tester.md +92 -0
  316. package/resources/gofer/claude-agents/tasks-cross-cutting-scanner.md +91 -0
  317. package/resources/gofer/claude-agents/tasks-rollback-planner.md +89 -0
  318. package/resources/gofer/claude-agents/validate-security-red-team.md +102 -0
  319. package/resources/gofer/claude-agents/validation-correctness.md +103 -0
  320. package/resources/gofer/claude-agents/validation-integration.md +129 -0
  321. package/resources/gofer/claude-agents/validation-performance.md +120 -0
  322. package/resources/gofer/claude-agents/validation-security.md +115 -0
  323. package/resources/gofer/claude-agents/validation-standards.md +151 -0
  324. package/resources/gofer/claude-agents/validation-test-quality.md +146 -0
  325. package/resources/gofer/claude-agents/visual-bounded-context-writer.md +40 -0
  326. package/resources/gofer/claude-agents/visual-c4-writer.md +45 -0
  327. package/resources/gofer/claude-agents/visual-erd-writer.md +34 -0
  328. package/resources/gofer/claude-agents/visual-heatmap-writer.md +63 -0
  329. package/resources/gofer/claude-agents/visual-risk-writer.md +64 -0
  330. package/resources/gofer/claude-commands/0_gofer_start.md +1282 -0
  331. package/resources/gofer/claude-commands/0a_problem_validation.md +424 -0
  332. package/resources/gofer/claude-commands/10_gofer_cloud.md +630 -0
  333. package/resources/gofer/claude-commands/1_gofer_research.md +1154 -0
  334. package/resources/gofer/claude-commands/2_gofer_specify.md +855 -0
  335. package/resources/gofer/claude-commands/3_gofer_plan.md +881 -0
  336. package/resources/gofer/claude-commands/4_gofer_tasks.md +743 -0
  337. package/resources/gofer/claude-commands/5_gofer_implement.md +919 -0
  338. package/resources/gofer/claude-commands/6_gofer_validate.md +2264 -0
  339. package/resources/gofer/claude-commands/7_gofer_save.md +418 -0
  340. package/resources/gofer/claude-commands/7a_stakeholder_comms.md +503 -0
  341. package/resources/gofer/claude-commands/8_gofer_branding.md +310 -0
  342. package/resources/gofer/claude-commands/9_gofer_tests.md +553 -0
  343. package/resources/gofer/claude-commands/gofer_bootstrap_workspace.md +143 -0
  344. package/resources/gofer/claude-commands/gofer_check_workspace.md +114 -0
  345. package/resources/gofer/claude-commands/gofer_constitution.md +607 -0
  346. package/resources/gofer/claude-commands/gofer_diagnose.md +109 -0
  347. package/resources/gofer/claude-commands/gofer_eai_first_run.md +392 -0
  348. package/resources/gofer/claude-commands/gofer_hydrate.md +556 -0
  349. package/resources/gofer/claude-commands/gofer_personality.md +39 -0
  350. package/resources/gofer/claude-commands/gofer_plan.md +35 -0
  351. package/resources/gofer/claude-commands/gofer_side.md +40 -0
  352. package/resources/gofer/claude-commands/gofer_spec_summary.md +107 -0
  353. package/resources/gofer/claude-commands/gofer_tdd.md +107 -0
  354. package/resources/gofer/claude-commands/gofer_vocabulary.md +107 -0
  355. package/resources/gofer/claude-commands/gofer_zoom_out.md +107 -0
  356. package/resources/gofer/claude-skills/eai-gofer/SKILL.md +56 -0
  357. package/resources/gofer/commands/.gitkeep +0 -0
  358. package/resources/gofer/commands/0_gofer_start.md +1299 -0
  359. package/resources/gofer/commands/0a_problem_validation.md +405 -0
  360. package/resources/gofer/commands/10_gofer_cloud.md +611 -0
  361. package/resources/gofer/commands/1_gofer_research.md +1135 -0
  362. package/resources/gofer/commands/2_gofer_specify.md +836 -0
  363. package/resources/gofer/commands/3_gofer_plan.md +862 -0
  364. package/resources/gofer/commands/4_gofer_tasks.md +724 -0
  365. package/resources/gofer/commands/5_gofer_implement.md +900 -0
  366. package/resources/gofer/commands/6_gofer_validate.md +2245 -0
  367. package/resources/gofer/commands/7_gofer_save.md +399 -0
  368. package/resources/gofer/commands/7a_stakeholder_comms.md +484 -0
  369. package/resources/gofer/commands/8_gofer_branding.md +291 -0
  370. package/resources/gofer/commands/9_gofer_tests.md +534 -0
  371. package/resources/gofer/commands/gofer_bootstrap_workspace.md +159 -0
  372. package/resources/gofer/commands/gofer_check_workspace.md +130 -0
  373. package/resources/gofer/commands/gofer_constitution.md +588 -0
  374. package/resources/gofer/commands/gofer_diagnose.md +89 -0
  375. package/resources/gofer/commands/gofer_eai_first_run.md +392 -0
  376. package/resources/gofer/commands/gofer_hydrate.md +537 -0
  377. package/resources/gofer/commands/gofer_personality.md +61 -0
  378. package/resources/gofer/commands/gofer_plan.md +51 -0
  379. package/resources/gofer/commands/gofer_side.md +56 -0
  380. package/resources/gofer/commands/gofer_spec_summary.md +87 -0
  381. package/resources/gofer/commands/gofer_tdd.md +87 -0
  382. package/resources/gofer/commands/gofer_vocabulary.md +87 -0
  383. package/resources/gofer/commands/gofer_zoom_out.md +87 -0
  384. package/resources/gofer/copilot-instructions/gofer-cost.instructions.md +13 -0
  385. package/resources/gofer/copilot-instructions/language-server.instructions.md +49 -0
  386. package/resources/gofer/copilot-instructions/typescript.instructions.md +47 -0
  387. package/resources/gofer/copilot-instructions/vscode-extension.instructions.md +46 -0
  388. package/resources/gofer/copilot-prompts/0_gofer_start.prompt.md +1308 -0
  389. package/resources/gofer/copilot-prompts/0a_problem_validation.prompt.md +429 -0
  390. package/resources/gofer/copilot-prompts/10_gofer_cloud.prompt.md +644 -0
  391. package/resources/gofer/copilot-prompts/1_gofer_research.prompt.md +1177 -0
  392. package/resources/gofer/copilot-prompts/2_gofer_specify.prompt.md +878 -0
  393. package/resources/gofer/copilot-prompts/3_gofer_plan.prompt.md +904 -0
  394. package/resources/gofer/copilot-prompts/4_gofer_tasks.prompt.md +766 -0
  395. package/resources/gofer/copilot-prompts/5_gofer_implement.prompt.md +942 -0
  396. package/resources/gofer/copilot-prompts/6_gofer_validate.prompt.md +2277 -0
  397. package/resources/gofer/copilot-prompts/7_gofer_save.prompt.md +433 -0
  398. package/resources/gofer/copilot-prompts/7a_stakeholder_comms.prompt.md +516 -0
  399. package/resources/gofer/copilot-prompts/8_gofer_branding.prompt.md +323 -0
  400. package/resources/gofer/copilot-prompts/9_gofer_tests.prompt.md +566 -0
  401. package/resources/gofer/copilot-prompts/gofer_bootstrap_workspace.prompt.md +161 -0
  402. package/resources/gofer/copilot-prompts/gofer_check_workspace.prompt.md +132 -0
  403. package/resources/gofer/copilot-prompts/gofer_constitution.prompt.md +621 -0
  404. package/resources/gofer/copilot-prompts/gofer_diagnose.prompt.md +127 -0
  405. package/resources/gofer/copilot-prompts/gofer_eai_first_run.prompt.md +410 -0
  406. package/resources/gofer/copilot-prompts/gofer_hydrate.prompt.md +571 -0
  407. package/resources/gofer/copilot-prompts/gofer_personality.prompt.md +57 -0
  408. package/resources/gofer/copilot-prompts/gofer_plan.prompt.md +53 -0
  409. package/resources/gofer/copilot-prompts/gofer_side.prompt.md +58 -0
  410. package/resources/gofer/copilot-prompts/gofer_spec_summary.prompt.md +125 -0
  411. package/resources/gofer/copilot-prompts/gofer_tdd.prompt.md +125 -0
  412. package/resources/gofer/copilot-prompts/gofer_vocabulary.prompt.md +125 -0
  413. package/resources/gofer/copilot-prompts/gofer_zoom_out.prompt.md +125 -0
  414. package/resources/gofer/gemini/agents/assumption-tracker.md +171 -0
  415. package/resources/gofer/gemini/agents/business-metrics-analyzer.md +172 -0
  416. package/resources/gofer/gemini/agents/business-problem-validator.md +171 -0
  417. package/resources/gofer/gemini/agents/codebase-analyzer.md +127 -0
  418. package/resources/gofer/gemini/agents/codebase-locator.md +98 -0
  419. package/resources/gofer/gemini/agents/codebase-pattern-finder.md +183 -0
  420. package/resources/gofer/gemini/agents/comms-writer.md +161 -0
  421. package/resources/gofer/gemini/agents/engineer-review.md +172 -0
  422. package/resources/gofer/gemini/agents/implement-bug-triangulator.md +97 -0
  423. package/resources/gofer/gemini/agents/implement-code-review-council.md +92 -0
  424. package/resources/gofer/gemini/agents/implement-doc-writer.md +92 -0
  425. package/resources/gofer/gemini/agents/implement-error-hardener.md +87 -0
  426. package/resources/gofer/gemini/agents/implement-performance-explorer.md +98 -0
  427. package/resources/gofer/gemini/agents/implement-test-diversifier.md +85 -0
  428. package/resources/gofer/gemini/agents/implement-variant-generator.md +83 -0
  429. package/resources/gofer/gemini/agents/multi-perspective-judge.md +117 -0
  430. package/resources/gofer/gemini/agents/plan-api-comparator.md +93 -0
  431. package/resources/gofer/gemini/agents/plan-architecture-diverger.md +103 -0
  432. package/resources/gofer/gemini/agents/plan-data-model-stress-tester.md +98 -0
  433. package/resources/gofer/gemini/agents/plan-migration-path-finder.md +98 -0
  434. package/resources/gofer/gemini/agents/plan-refactor-rewrite-advisor.md +100 -0
  435. package/resources/gofer/gemini/agents/research-dependency-evaluator.md +109 -0
  436. package/resources/gofer/gemini/agents/research-horizon-scanner.md +103 -0
  437. package/resources/gofer/gemini/agents/research-market-scanner.md +140 -0
  438. package/resources/gofer/gemini/agents/research-perspective-multiplier.md +105 -0
  439. package/resources/gofer/gemini/agents/scope-creep-detector.md +155 -0
  440. package/resources/gofer/gemini/agents/specify-ambiguity-detector.md +98 -0
  441. package/resources/gofer/gemini/agents/specify-journey-stress-tester.md +95 -0
  442. package/resources/gofer/gemini/agents/tasks-cross-cutting-scanner.md +94 -0
  443. package/resources/gofer/gemini/agents/tasks-rollback-planner.md +92 -0
  444. package/resources/gofer/gemini/agents/validate-security-red-team.md +105 -0
  445. package/resources/gofer/gemini/agents/validation-correctness.md +106 -0
  446. package/resources/gofer/gemini/agents/validation-integration.md +132 -0
  447. package/resources/gofer/gemini/agents/validation-performance.md +123 -0
  448. package/resources/gofer/gemini/agents/validation-security.md +118 -0
  449. package/resources/gofer/gemini/agents/validation-standards.md +154 -0
  450. package/resources/gofer/gemini/agents/validation-test-quality.md +149 -0
  451. package/resources/gofer/gemini/agents/visual-bounded-context-writer.md +40 -0
  452. package/resources/gofer/gemini/agents/visual-c4-writer.md +44 -0
  453. package/resources/gofer/gemini/agents/visual-erd-writer.md +36 -0
  454. package/resources/gofer/gemini/agents/visual-heatmap-writer.md +63 -0
  455. package/resources/gofer/gemini/agents/visual-risk-writer.md +64 -0
  456. package/resources/gofer/gemini/commands/gofer/.gitkeep +0 -0
  457. package/resources/gofer/gemini/commands/gofer/0_gofer_start.md +1282 -0
  458. package/resources/gofer/gemini/commands/gofer/0_gofer_start.toml +2 -0
  459. package/resources/gofer/gemini/commands/gofer/0a_problem_validation.md +424 -0
  460. package/resources/gofer/gemini/commands/gofer/0a_problem_validation.toml +2 -0
  461. package/resources/gofer/gemini/commands/gofer/10_gofer_cloud.md +630 -0
  462. package/resources/gofer/gemini/commands/gofer/10_gofer_cloud.toml +2 -0
  463. package/resources/gofer/gemini/commands/gofer/1_gofer_research.md +1154 -0
  464. package/resources/gofer/gemini/commands/gofer/1_gofer_research.toml +2 -0
  465. package/resources/gofer/gemini/commands/gofer/2_gofer_specify.md +855 -0
  466. package/resources/gofer/gemini/commands/gofer/2_gofer_specify.toml +2 -0
  467. package/resources/gofer/gemini/commands/gofer/3_gofer_plan.md +881 -0
  468. package/resources/gofer/gemini/commands/gofer/3_gofer_plan.toml +2 -0
  469. package/resources/gofer/gemini/commands/gofer/4_gofer_tasks.md +743 -0
  470. package/resources/gofer/gemini/commands/gofer/4_gofer_tasks.toml +2 -0
  471. package/resources/gofer/gemini/commands/gofer/5_gofer_implement.md +919 -0
  472. package/resources/gofer/gemini/commands/gofer/5_gofer_implement.toml +2 -0
  473. package/resources/gofer/gemini/commands/gofer/6_gofer_validate.md +2264 -0
  474. package/resources/gofer/gemini/commands/gofer/6_gofer_validate.toml +2 -0
  475. package/resources/gofer/gemini/commands/gofer/7_gofer_save.md +418 -0
  476. package/resources/gofer/gemini/commands/gofer/7_gofer_save.toml +2 -0
  477. package/resources/gofer/gemini/commands/gofer/7a_stakeholder_comms.md +503 -0
  478. package/resources/gofer/gemini/commands/gofer/7a_stakeholder_comms.toml +2 -0
  479. package/resources/gofer/gemini/commands/gofer/8_gofer_branding.md +310 -0
  480. package/resources/gofer/gemini/commands/gofer/8_gofer_branding.toml +2 -0
  481. package/resources/gofer/gemini/commands/gofer/9_gofer_tests.md +553 -0
  482. package/resources/gofer/gemini/commands/gofer/9_gofer_tests.toml +2 -0
  483. package/resources/gofer/gemini/commands/gofer/gofer_bootstrap_workspace.md +143 -0
  484. package/resources/gofer/gemini/commands/gofer/gofer_bootstrap_workspace.toml +2 -0
  485. package/resources/gofer/gemini/commands/gofer/gofer_check_workspace.md +114 -0
  486. package/resources/gofer/gemini/commands/gofer/gofer_check_workspace.toml +2 -0
  487. package/resources/gofer/gemini/commands/gofer/gofer_constitution.md +607 -0
  488. package/resources/gofer/gemini/commands/gofer/gofer_constitution.toml +2 -0
  489. package/resources/gofer/gemini/commands/gofer/gofer_diagnose.md +109 -0
  490. package/resources/gofer/gemini/commands/gofer/gofer_diagnose.toml +2 -0
  491. package/resources/gofer/gemini/commands/gofer/gofer_eai_first_run.md +392 -0
  492. package/resources/gofer/gemini/commands/gofer/gofer_eai_first_run.toml +2 -0
  493. package/resources/gofer/gemini/commands/gofer/gofer_hydrate.md +556 -0
  494. package/resources/gofer/gemini/commands/gofer/gofer_hydrate.toml +2 -0
  495. package/resources/gofer/gemini/commands/gofer/gofer_personality.md +39 -0
  496. package/resources/gofer/gemini/commands/gofer/gofer_personality.toml +2 -0
  497. package/resources/gofer/gemini/commands/gofer/gofer_plan.md +35 -0
  498. package/resources/gofer/gemini/commands/gofer/gofer_plan.toml +2 -0
  499. package/resources/gofer/gemini/commands/gofer/gofer_side.md +40 -0
  500. package/resources/gofer/gemini/commands/gofer/gofer_side.toml +2 -0
  501. package/resources/gofer/gemini/commands/gofer/gofer_spec_summary.md +107 -0
  502. package/resources/gofer/gemini/commands/gofer/gofer_spec_summary.toml +2 -0
  503. package/resources/gofer/gemini/commands/gofer/gofer_tdd.md +107 -0
  504. package/resources/gofer/gemini/commands/gofer/gofer_tdd.toml +2 -0
  505. package/resources/gofer/gemini/commands/gofer/gofer_vocabulary.md +107 -0
  506. package/resources/gofer/gemini/commands/gofer/gofer_vocabulary.toml +2 -0
  507. package/resources/gofer/gemini/commands/gofer/gofer_zoom_out.md +107 -0
  508. package/resources/gofer/gemini/commands/gofer/gofer_zoom_out.toml +2 -0
  509. package/resources/gofer/gemini/commands/gofer/manifest.json +32 -0
  510. package/resources/gofer/gemini/extension.json +16 -0
  511. package/resources/gofer/github-agents/gofer-business.agent.md +20 -0
  512. package/resources/gofer/github-agents/gofer-implement.agent.md +15 -0
  513. package/resources/gofer/github-agents/gofer-plan.agent.md +15 -0
  514. package/resources/gofer/github-agents/gofer-research.agent.md +15 -0
  515. package/resources/gofer/github-agents/gofer-validate.agent.md +10 -0
  516. package/resources/gofer/github-skills/eai-gofer/SKILL.md +56 -0
  517. package/resources/gofer/hook-scripts/agent-stop.mjs +655 -0
  518. package/resources/gofer/hook-scripts/log-stage-launch-time.mjs +77 -0
  519. package/resources/gofer/hook-scripts/post-tool-use.mjs +333 -0
  520. package/resources/gofer/hook-scripts/queued-input.mjs +188 -0
  521. package/resources/gofer/hook-scripts/session-lifecycle.mjs +93 -0
  522. package/resources/gofer/hook-scripts/user-prompt-submit.mjs +228 -0
  523. package/resources/gofer/instruction-templates/base/agents-base.md +37 -0
  524. package/resources/gofer/instruction-templates/base/claude-base.md +7 -0
  525. package/resources/gofer/instruction-templates/base/copilot-base.md +26 -0
  526. package/resources/gofer/instruction-templates/gofer/gofer-claude.md +5 -0
  527. package/resources/gofer/instruction-templates/gofer/gofer-copilot.md +9 -0
  528. package/resources/gofer/instruction-templates/languages/generic.md +7 -0
  529. package/resources/gofer/instruction-templates/languages/go.md +8 -0
  530. package/resources/gofer/instruction-templates/languages/java.md +8 -0
  531. package/resources/gofer/instruction-templates/languages/python.md +9 -0
  532. package/resources/gofer/instruction-templates/languages/rust.md +9 -0
  533. package/resources/gofer/instruction-templates/languages/typescript.md +19 -0
  534. package/resources/gofer/instruction-templates/workflow/principles.md +52 -0
  535. package/resources/gofer/memory/constitution.md +391 -0
  536. package/resources/gofer/memory/context-profiles.yaml +74 -0
  537. package/resources/gofer/memory/decisions/000-use-adr-for-decisions.md +67 -0
  538. package/resources/gofer/memory/decisions/001-di-framework.md +190 -0
  539. package/resources/gofer/memory/decisions/002-module-extraction.md +305 -0
  540. package/resources/gofer/memory/decisions/003-error-handling.md +368 -0
  541. package/resources/gofer/memory/decisions/004-cache-eviction.md +436 -0
  542. package/resources/gofer/memory/decisions/005-constants-management.md +520 -0
  543. package/resources/gofer/memory/decisions/README.md +129 -0
  544. package/resources/gofer/memory/diagrams/di-container.mmd +321 -0
  545. package/resources/gofer/memory/diagrams/extension-activation.mmd +184 -0
  546. package/resources/gofer/memory/diagrams/module-dependencies.mmd +264 -0
  547. package/resources/gofer/memory/gofer-model-policy.yaml +97 -0
  548. package/resources/gofer/memory/lessons.md +46 -0
  549. package/resources/gofer/node-scripts/canonical-descriptions.mjs +86 -0
  550. package/resources/gofer/node-scripts/check-version-alignment.mjs +131 -0
  551. package/resources/gofer/node-scripts/codex-doctor.mjs +425 -0
  552. package/resources/gofer/node-scripts/generate-commands.mjs +1366 -0
  553. package/resources/gofer/node-scripts/generate-issues.js +563 -0
  554. package/resources/gofer/node-scripts/gofer-closed-loop-audit.mjs +893 -0
  555. package/resources/gofer/node-scripts/gofer-loop-audit.mjs +541 -0
  556. package/resources/gofer/node-scripts/gofer-performance-report.mjs +306 -0
  557. package/resources/gofer/node-scripts/gofer-workspace-bootstrap.mjs +56 -0
  558. package/resources/gofer/node-scripts/gofer-workspace-check.mjs +56 -0
  559. package/resources/gofer/node-scripts/lib/ai-leverage-tagger.mjs +103 -0
  560. package/resources/gofer/node-scripts/lib/assemble-stakeholder-pack.mjs +114 -0
  561. package/resources/gofer/node-scripts/lib/marp-deck.mjs +87 -0
  562. package/resources/gofer/node-scripts/lib/mermaid-tabular-fallback.mjs +264 -0
  563. package/resources/gofer/node-scripts/lib/render-visual.mjs +54 -0
  564. package/resources/gofer/node-scripts/lib/validate-aliases.mjs +85 -0
  565. package/resources/gofer/node-scripts/lib/visual-counts.mjs +44 -0
  566. package/resources/gofer/node-scripts/lib/visual-pass-pipeline.mjs +134 -0
  567. package/resources/gofer/node-scripts/mermaid-export.mjs +72 -0
  568. package/resources/gofer/node-scripts/package-agent-plugin.mjs +940 -0
  569. package/resources/gofer/node-scripts/parse-stage-command.mjs +211 -0
  570. package/resources/gofer/node-scripts/schemas/.gitkeep +0 -0
  571. package/resources/gofer/node-scripts/schemas/stage-command.schema.json +72 -0
  572. package/resources/gofer/node-scripts/sync-extension-resources.mjs +110 -0
  573. package/resources/gofer/node-scripts/workspace-bootstrap-lib.mjs +1166 -0
  574. package/resources/gofer/powershell-scripts/install-optional-tools.ps1 +214 -0
  575. package/resources/gofer/references/platform/README.md +17 -0
  576. package/resources/gofer/references/platform/deployment-repo.md +9 -0
  577. package/resources/gofer/references/platform/eai-app-template.md +45 -0
  578. package/resources/gofer/references/platform/eai-config-driven-ui.md +156 -0
  579. package/resources/gofer/references/platform/eai-error-catalog.yaml +197 -0
  580. package/resources/gofer/references/platform/eai-repo-contract.md +134 -0
  581. package/resources/gofer/references/platform/eai-service-patterns.md +56 -0
  582. package/resources/gofer/references/platform/eai.md +85 -0
  583. package/resources/gofer/references/platform/vertical-template.md +49 -0
  584. package/resources/gofer/specify-commands/.gitkeep +0 -0
  585. package/resources/gofer/specify-commands/0_gofer_start.md +1299 -0
  586. package/resources/gofer/specify-commands/0a_problem_validation.md +405 -0
  587. package/resources/gofer/specify-commands/10_gofer_cloud.md +611 -0
  588. package/resources/gofer/specify-commands/1_gofer_research.md +1135 -0
  589. package/resources/gofer/specify-commands/2_gofer_specify.md +836 -0
  590. package/resources/gofer/specify-commands/3_gofer_plan.md +862 -0
  591. package/resources/gofer/specify-commands/4_gofer_tasks.md +724 -0
  592. package/resources/gofer/specify-commands/5_gofer_implement.md +900 -0
  593. package/resources/gofer/specify-commands/6_gofer_validate.md +2245 -0
  594. package/resources/gofer/specify-commands/7_gofer_save.md +399 -0
  595. package/resources/gofer/specify-commands/7a_stakeholder_comms.md +484 -0
  596. package/resources/gofer/specify-commands/8_gofer_branding.md +291 -0
  597. package/resources/gofer/specify-commands/9_gofer_tests.md +534 -0
  598. package/resources/gofer/specify-commands/gofer_bootstrap_workspace.md +159 -0
  599. package/resources/gofer/specify-commands/gofer_check_workspace.md +130 -0
  600. package/resources/gofer/specify-commands/gofer_constitution.md +588 -0
  601. package/resources/gofer/specify-commands/gofer_diagnose.md +89 -0
  602. package/resources/gofer/specify-commands/gofer_eai_first_run.md +392 -0
  603. package/resources/gofer/specify-commands/gofer_hydrate.md +537 -0
  604. package/resources/gofer/specify-commands/gofer_personality.md +61 -0
  605. package/resources/gofer/specify-commands/gofer_plan.md +51 -0
  606. package/resources/gofer/specify-commands/gofer_side.md +56 -0
  607. package/resources/gofer/specify-commands/gofer_spec_summary.md +87 -0
  608. package/resources/gofer/specify-commands/gofer_tdd.md +87 -0
  609. package/resources/gofer/specify-commands/gofer_vocabulary.md +87 -0
  610. package/resources/gofer/specify-commands/gofer_zoom_out.md +87 -0
  611. package/resources/gofer/system-skills/0_gofer_start/SKILL.md +1287 -0
  612. package/resources/gofer/system-skills/0a_problem_validation/SKILL.md +429 -0
  613. package/resources/gofer/system-skills/10_gofer_cloud/SKILL.md +635 -0
  614. package/resources/gofer/system-skills/1_gofer_research/SKILL.md +1159 -0
  615. package/resources/gofer/system-skills/2_gofer_specify/SKILL.md +860 -0
  616. package/resources/gofer/system-skills/3_gofer_plan/SKILL.md +886 -0
  617. package/resources/gofer/system-skills/4_gofer_tasks/SKILL.md +748 -0
  618. package/resources/gofer/system-skills/5_gofer_implement/SKILL.md +924 -0
  619. package/resources/gofer/system-skills/6_gofer_validate/SKILL.md +2269 -0
  620. package/resources/gofer/system-skills/7_gofer_save/SKILL.md +423 -0
  621. package/resources/gofer/system-skills/7a_stakeholder_comms/SKILL.md +508 -0
  622. package/resources/gofer/system-skills/8_gofer_branding/SKILL.md +315 -0
  623. package/resources/gofer/system-skills/9_gofer_tests/SKILL.md +558 -0
  624. package/resources/gofer/system-skills/gofer_bootstrap_workspace/SKILL.md +148 -0
  625. package/resources/gofer/system-skills/gofer_check_workspace/SKILL.md +119 -0
  626. package/resources/gofer/system-skills/gofer_constitution/SKILL.md +612 -0
  627. package/resources/gofer/system-skills/gofer_diagnose/SKILL.md +114 -0
  628. package/resources/gofer/system-skills/gofer_eai_first_run/SKILL.md +397 -0
  629. package/resources/gofer/system-skills/gofer_hydrate/SKILL.md +561 -0
  630. package/resources/gofer/system-skills/gofer_personality/SKILL.md +44 -0
  631. package/resources/gofer/system-skills/gofer_plan/SKILL.md +40 -0
  632. package/resources/gofer/system-skills/gofer_side/SKILL.md +45 -0
  633. package/resources/gofer/system-skills/gofer_spec_summary/SKILL.md +112 -0
  634. package/resources/gofer/system-skills/gofer_tdd/SKILL.md +112 -0
  635. package/resources/gofer/system-skills/gofer_vocabulary/SKILL.md +112 -0
  636. package/resources/gofer/system-skills/gofer_zoom_out/SKILL.md +112 -0
  637. package/resources/gofer/templates/agent-file-template.md +28 -0
  638. package/resources/gofer/templates/assumptions-template.md +94 -0
  639. package/resources/gofer/templates/audit-history-template.md +35 -0
  640. package/resources/gofer/templates/brand/brand-profile-template.json +45 -0
  641. package/resources/gofer/templates/brand/document-style-template.md +50 -0
  642. package/resources/gofer/templates/brand/marp-theme-template.css +58 -0
  643. package/resources/gofer/templates/brownfield-analysis.md +44 -0
  644. package/resources/gofer/templates/business-metrics-template.md +120 -0
  645. package/resources/gofer/templates/business-owner-summary-template.md +83 -0
  646. package/resources/gofer/templates/checklist-template.md +40 -0
  647. package/resources/gofer/templates/ciso-security-summary-template.md +70 -0
  648. package/resources/gofer/templates/context-bundle-template.md +76 -0
  649. package/resources/gofer/templates/contract-pack-template.md +109 -0
  650. package/resources/gofer/templates/cto-architecture-summary-template.md +83 -0
  651. package/resources/gofer/templates/discovery-template.md +92 -0
  652. package/resources/gofer/templates/eai-preflight-template.md +144 -0
  653. package/resources/gofer/templates/goal-ledger-template.json +69 -0
  654. package/resources/gofer/templates/gofer-model-policy.yaml +97 -0
  655. package/resources/gofer/templates/issues-template.md +106 -0
  656. package/resources/gofer/templates/journey/base-journey.md +95 -0
  657. package/resources/gofer/templates/journey/industry-variants.yaml +277 -0
  658. package/resources/gofer/templates/loop-contract-template.json +68 -0
  659. package/resources/gofer/templates/plan-template.md +215 -0
  660. package/resources/gofer/templates/problem-brief-template.md +85 -0
  661. package/resources/gofer/templates/proposal-review-template.md +79 -0
  662. package/resources/gofer/templates/research-template.md +222 -0
  663. package/resources/gofer/templates/reuse-scan-template.md +43 -0
  664. package/resources/gofer/templates/sequence-diagrams/option-spectrum.yaml +178 -0
  665. package/resources/gofer/templates/service-fit-matrix-template.md +29 -0
  666. package/resources/gofer/templates/session-handoff-template.md +172 -0
  667. package/resources/gofer/templates/spec-summary-template.md +118 -0
  668. package/resources/gofer/templates/spec-template.md +196 -0
  669. package/resources/gofer/templates/stakeholder-comms-template.md +330 -0
  670. package/resources/gofer/templates/stakeholder-review-index-template.md +54 -0
  671. package/resources/gofer/templates/tasks-template.md +323 -0
  672. package/resources/gofer/templates/ui-approval-template.md +32 -0
  673. package/resources/gofer/templates/ui-preview-brief-template.md +65 -0
  674. package/resources/gofer/templates/ui-review-log-template.md +11 -0
  675. package/resources/gofer/templates/visuals/.gitkeep +0 -0
  676. package/resources/gofer/templates/visuals/bounded-context-map.md +19 -0
  677. package/resources/gofer/templates/visuals/bounded-context-template.md +47 -0
  678. package/resources/gofer/templates/visuals/c4-container-template.md +38 -0
  679. package/resources/gofer/templates/visuals/c4-container.md +20 -0
  680. package/resources/gofer/templates/visuals/c4-context-template.md +46 -0
  681. package/resources/gofer/templates/visuals/capability-heatmap-template.md +54 -0
  682. package/resources/gofer/templates/visuals/data-model-erd-template.md +41 -0
  683. package/resources/gofer/templates/visuals/erd.md +19 -0
  684. package/resources/gofer/templates/visuals/impact-canvas.md +40 -0
  685. package/resources/gofer/templates/visuals/risk-heatmap-template.md +51 -0
  686. package/resources/gofer/templates/visuals/roi-projection.md +17 -0
  687. package/resources/gofer/templates/visuals/value-stream-asis.md +16 -0
  688. package/resources/gofer/templates/visuals/value-stream-tobe.md +18 -0
  689. package/resources/gofer/templates/working-backwards-prfaq-template.md +165 -0
  690. package/resources/linked-sources.json +25 -0
@@ -0,0 +1,712 @@
1
+ /**
2
+ * eai deploy — deployment management.
3
+ *
4
+ * setup: Generate deploy-demo.yml + configure GitHub secrets
5
+ * trigger: Trigger deployment workflow
6
+ * status: Check deployment status
7
+ */
8
+ import { Command } from 'commander';
9
+ import { execFile } from 'node:child_process';
10
+ import { promisify } from 'node:util';
11
+ import { access, writeFile, mkdir } from 'node:fs/promises';
12
+ import { join } from 'node:path';
13
+ import ora from 'ora';
14
+ import chalk from 'chalk';
15
+ import { findProjectRoot, loadEnvFile } from '../lib/config.js';
16
+ import * as out from '../lib/output.js';
17
+ import { ErrorCode, exitWithError } from '../lib/error-codes.js';
18
+ import { expectedStatuses, loadRuntimeContract, RUNTIME_CONTRACT_FILE, validateRuntimeContract, } from '../lib/runtime-contract.js';
19
+ const exec = promisify(execFile);
20
+ export const deployCommand = new Command('deploy')
21
+ .description('Deployment management');
22
+ // ─── eai deploy setup ─────────────────────────────────────────────────────
23
+ deployCommand
24
+ .command('setup')
25
+ .description('Generate deployment workflow and configure GitHub secrets')
26
+ .option('--repo <repo>', 'GitHub repo (org/name)')
27
+ .action(async (options) => {
28
+ const root = await findProjectRoot();
29
+ if (!root) {
30
+ exitWithError(ErrorCode.E001);
31
+ }
32
+ const envVars = await loadEnvFile(root);
33
+ const appName = envVars.NEXT_PUBLIC_APP_NAME || 'my-app';
34
+ // Check if workflow already exists
35
+ const workflowPath = join(root, '.github', 'workflows', 'deploy-demo.yml');
36
+ try {
37
+ await access(workflowPath);
38
+ out.warn('deploy-demo.yml already exists. Skipping workflow generation.');
39
+ }
40
+ catch {
41
+ const spinner = ora('Generating deploy-demo.yml...').start();
42
+ const workflowDir = join(root, '.github', 'workflows');
43
+ await mkdir(workflowDir, { recursive: true });
44
+ const workflow = generateWorkflow(appName);
45
+ await writeFile(workflowPath, workflow, 'utf-8');
46
+ spinner.succeed('Created .github/workflows/deploy-demo.yml');
47
+ }
48
+ // Configure GitHub secrets if repo is available
49
+ const repo = options.repo;
50
+ if (repo) {
51
+ out.heading('Configuring GitHub secrets');
52
+ out.info(`Repository: ${chalk.cyan(repo)}`);
53
+ const secrets = [
54
+ { name: 'AZUREAPPSERVICE_CLIENTID', desc: 'Azure AD app client ID for deployment' },
55
+ { name: 'AZUREAPPSERVICE_TENANTID', desc: 'Azure AD tenant ID' },
56
+ { name: 'AZUREAPPSERVICE_SUBSCRIPTIONID', desc: 'Azure subscription ID' },
57
+ { name: 'AZURE_RESOURCE_GROUP', desc: 'Resource group name' },
58
+ { name: 'AZURE_WEBAPP_NAME', desc: 'App Service name' },
59
+ ];
60
+ for (const secret of secrets) {
61
+ try {
62
+ await exec('gh', ['secret', 'list', '--repo', repo]);
63
+ out.info(`Configure ${chalk.cyan(secret.name)}: ${secret.desc}`);
64
+ }
65
+ catch {
66
+ out.warn(`Could not check secrets for ${repo}. Install and authenticate gh CLI.`);
67
+ break;
68
+ }
69
+ }
70
+ out.blank();
71
+ out.info('Set secrets with: gh secret set SECRET_NAME --repo ' + repo);
72
+ }
73
+ else {
74
+ out.blank();
75
+ out.info('To configure GitHub secrets, re-run with --repo org/name');
76
+ }
77
+ });
78
+ // ─── eai deploy trigger ──────────────────────────────────────────────────
79
+ deployCommand
80
+ .command('trigger')
81
+ .description('Trigger deployment workflow')
82
+ .option('--repo <repo>', 'GitHub repo (org/name)')
83
+ .option('--branch <branch>', 'Branch to deploy', 'main')
84
+ .option('--workflow <name>', 'Workflow filename', 'deploy-demo.yml')
85
+ .option('--format <format>', 'Output format (text|json)', 'text')
86
+ .option('--json', 'Output raw JSON (deprecated, use --format json)', false)
87
+ .addHelpText('after', `
88
+ Examples:
89
+ $ eai deploy trigger
90
+ $ eai deploy trigger --branch develop
91
+ $ eai deploy trigger --repo eai-tools/my-app --format json
92
+ `)
93
+ .action(async (options) => {
94
+ let repo = options.repo;
95
+ if (options.json)
96
+ options.format = 'json';
97
+ if (!repo) {
98
+ // Try to detect from git remote
99
+ try {
100
+ const { stdout } = await exec('git', ['remote', 'get-url', 'origin']);
101
+ const match = stdout.trim().match(/github\.com[:/](.+?)(?:\.git)?$/);
102
+ if (match)
103
+ repo = match[1];
104
+ }
105
+ catch { /* can't detect */ }
106
+ }
107
+ if (!repo) {
108
+ exitWithError(ErrorCode.E305, { details: 'Could not detect GitHub repository. Use --repo org/name' }, options.format);
109
+ }
110
+ const spinner = options.format === 'json' ? null : ora(`Triggering ${options.workflow} on ${repo}...`).start();
111
+ try {
112
+ await exec('gh', [
113
+ 'workflow', 'run', options.workflow,
114
+ '--repo', repo,
115
+ '--ref', options.branch,
116
+ ]);
117
+ if (options.format === 'json') {
118
+ out.json({
119
+ triggered: true,
120
+ repo,
121
+ branch: options.branch,
122
+ workflow: options.workflow
123
+ });
124
+ }
125
+ else {
126
+ spinner.succeed(`Triggered deployment on ${chalk.cyan(repo)}@${options.branch}`);
127
+ out.info(`Check status: ${chalk.dim(`eai deploy status --repo ${repo}`)}`);
128
+ }
129
+ }
130
+ catch (err) {
131
+ if (spinner)
132
+ spinner.fail(err instanceof Error ? err.message : String(err));
133
+ process.exit(1);
134
+ }
135
+ });
136
+ // ─── eai deploy status ──────────────────────────────────────────────────
137
+ deployCommand
138
+ .command('status')
139
+ .description('Check deployment status')
140
+ .option('--repo <repo>', 'GitHub repo (org/name)')
141
+ .option('--format <format>', 'Output format (text|json)', 'text')
142
+ .option('--json', 'Output raw JSON (deprecated, use --format json)', false)
143
+ .action(async (options) => {
144
+ let repo = options.repo;
145
+ if (options.json)
146
+ options.format = 'json';
147
+ if (!repo) {
148
+ try {
149
+ const { stdout } = await exec('git', ['remote', 'get-url', 'origin']);
150
+ const match = stdout.trim().match(/github\.com[:/](.+?)(?:\.git)?$/);
151
+ if (match)
152
+ repo = match[1];
153
+ }
154
+ catch { /* can't detect */ }
155
+ }
156
+ if (!repo) {
157
+ exitWithError(ErrorCode.E305, { details: 'Could not detect GitHub repository. Use --repo org/name' }, options.format);
158
+ }
159
+ const spinner = options.format === 'json' ? null : ora('Checking deployment status...').start();
160
+ try {
161
+ const { stdout } = await exec('gh', [
162
+ 'run', 'list',
163
+ '--repo', repo,
164
+ '--limit', '5',
165
+ '--json', 'status,conclusion,name,createdAt,headBranch',
166
+ ]);
167
+ const runs = JSON.parse(stdout);
168
+ if (options.format === 'json') {
169
+ out.json({ repo, runs });
170
+ }
171
+ else {
172
+ spinner.succeed(`Recent deployments for ${chalk.cyan(repo)}`);
173
+ for (const run of runs) {
174
+ const icon = run.conclusion === 'success' ? out.symbols.success
175
+ : run.conclusion === 'failure' ? out.symbols.error
176
+ : run.status === 'in_progress' ? chalk.blue('⟳')
177
+ : out.symbols.pending;
178
+ const time = new Date(run.createdAt).toLocaleString();
179
+ out.info(`${icon} ${run.name} — ${chalk.dim(run.headBranch)} — ${chalk.dim(time)}`);
180
+ }
181
+ }
182
+ }
183
+ catch (err) {
184
+ if (spinner)
185
+ spinner.fail(err instanceof Error ? err.message : String(err));
186
+ process.exit(1);
187
+ }
188
+ });
189
+ // ─── eai deploy env ──────────────────────────────────────────────────────
190
+ const DEPLOY_PROVIDERS = ['vercel', 'docker', 'aws', 'azure', 'kubernetes', 'vm', 'generic'];
191
+ function isDeployProvider(value) {
192
+ return DEPLOY_PROVIDERS.includes(value);
193
+ }
194
+ function providerNotes(provider) {
195
+ switch (provider) {
196
+ case 'vercel':
197
+ return [
198
+ 'Add required environment variables and secrets in Project Settings > Environment Variables.',
199
+ 'Add the deployed Auth.js callback URL to the Entra app registration.',
200
+ 'Run eai deploy doctor --url against preview and production URLs before marking deployment complete.',
201
+ ];
202
+ case 'docker':
203
+ return [
204
+ 'Put non-secret values in an env file or container environment.',
205
+ 'Inject secrets through the runtime or orchestrator secret store, not the image.',
206
+ 'Run eai deploy doctor --url against the exposed container URL.',
207
+ ];
208
+ case 'aws':
209
+ return [
210
+ 'Map required env vars to the app runtime configuration for the selected AWS service.',
211
+ 'Store secrets in the provider secret store and inject them at runtime.',
212
+ 'Run eai deploy doctor --url against the public load balancer or app URL.',
213
+ ];
214
+ case 'azure':
215
+ return [
216
+ 'Map required env vars to App Settings or the selected Azure container runtime.',
217
+ 'Store secrets in the platform secret store or Key Vault-backed settings.',
218
+ 'Run eai deploy doctor --url against the deployed app URL after restart.',
219
+ ];
220
+ case 'kubernetes':
221
+ return [
222
+ 'Put non-secret values in a ConfigMap and secrets in a Secret.',
223
+ 'Mount both into the workload as environment variables.',
224
+ 'Run eai deploy doctor --url against the ingress URL after rollout.',
225
+ ];
226
+ case 'vm':
227
+ return [
228
+ 'Provide env vars and secrets through the process manager or host secret mechanism.',
229
+ 'Do not commit runtime secret files to the repo.',
230
+ 'Run eai deploy doctor --url against the public or internal app URL.',
231
+ ];
232
+ case 'generic':
233
+ return [
234
+ 'Translate the runtime contract into your host environment and secret mechanism.',
235
+ 'Configure the Auth.js callback URL in the Entra app registration.',
236
+ 'Run eai deploy doctor --url after deployment; /health alone is not enough.',
237
+ ];
238
+ }
239
+ }
240
+ function buildDeployEnvPlan(provider, contractPath, validation) {
241
+ return {
242
+ provider,
243
+ contract: contractPath,
244
+ requiredEnv: validation.summary.requiredEnv,
245
+ requiredSecrets: validation.summary.requiredSecrets,
246
+ optionalSecrets: validation.summary.optionalSecrets,
247
+ notes: providerNotes(provider),
248
+ };
249
+ }
250
+ deployCommand
251
+ .command('env')
252
+ .description('Print provider-neutral runtime env and secret requirements')
253
+ .requiredOption('--provider <provider>', `Target provider (${DEPLOY_PROVIDERS.join('|')})`)
254
+ .option('--format <format>', 'Output format (text|json)', 'text')
255
+ .option('--json', 'Output raw JSON (deprecated, use --format json)', false)
256
+ .addHelpText('after', `
257
+ Examples:
258
+ $ eai deploy env --provider generic
259
+ $ eai deploy env --provider vercel --format json
260
+ $ eai deploy env --provider kubernetes
261
+ `)
262
+ .action(async (options) => {
263
+ if (options.json)
264
+ options.format = 'json';
265
+ if (!isDeployProvider(options.provider)) {
266
+ exitWithError(ErrorCode.E305, { details: `Unknown provider ${options.provider}. Use one of ${DEPLOY_PROVIDERS.join(', ')}` }, options.format);
267
+ }
268
+ const validation = await validateRuntimeContract();
269
+ const plan = buildDeployEnvPlan(options.provider, validation.contractPath, validation);
270
+ if (options.format === 'json') {
271
+ out.json({
272
+ provider: plan.provider,
273
+ contract: plan.contract,
274
+ requiredEnv: plan.requiredEnv,
275
+ requiredProtectedEnvNames: plan.requiredSecrets,
276
+ optionalProtectedEnvNames: plan.optionalSecrets,
277
+ notes: plan.notes,
278
+ validationStatus: validation.status,
279
+ validationFindings: validation.findings,
280
+ });
281
+ if (validation.status === 'fail')
282
+ process.exit(1);
283
+ return;
284
+ }
285
+ out.heading(`EAI Deploy Env: ${options.provider}`);
286
+ out.table([
287
+ ['Contract', plan.contract],
288
+ ['Validation', validation.status === 'pass' ? 'PASS' : 'FAIL'],
289
+ ]);
290
+ out.blank();
291
+ out.heading('Required Environment Variables');
292
+ for (const name of plan.requiredEnv) {
293
+ out.info(name);
294
+ }
295
+ out.blank();
296
+ out.heading('Required Secrets');
297
+ for (const name of plan.requiredSecrets) {
298
+ out.info(name);
299
+ }
300
+ if (plan.optionalSecrets.length > 0) {
301
+ out.blank();
302
+ out.heading('Optional Secrets');
303
+ for (const name of plan.optionalSecrets) {
304
+ out.info(name);
305
+ }
306
+ }
307
+ out.blank();
308
+ out.heading('Provider Notes');
309
+ for (const note of plan.notes) {
310
+ out.info(note);
311
+ }
312
+ if (validation.status === 'fail') {
313
+ out.blank();
314
+ for (const finding of validation.findings) {
315
+ out.error(`${finding.code}: ${finding.message}`);
316
+ if (finding.fix)
317
+ out.info(`Fix: ${finding.fix}`);
318
+ }
319
+ process.exit(1);
320
+ }
321
+ });
322
+ function normalizeBaseUrl(url) {
323
+ const parsed = new URL(url);
324
+ parsed.hash = '';
325
+ parsed.search = '';
326
+ return parsed.toString().replace(/\/$/, '');
327
+ }
328
+ function combineUrl(baseUrl, pathValue) {
329
+ return `${baseUrl}${pathValue.startsWith('/') ? pathValue : `/${pathValue}`}`;
330
+ }
331
+ function coerceDoctorCategory(value, fallback) {
332
+ const allowed = new Set([
333
+ 'host/infrastructure',
334
+ 'app_not_running',
335
+ 'authjs_config',
336
+ 'entra_client_redirect_config',
337
+ 'eai_publicapi_config',
338
+ 'tenant_workflow_config',
339
+ 'service_identity_app_only_auth_config',
340
+ 'publicapi_authorization',
341
+ 'app_code_runtime_error',
342
+ ]);
343
+ return value && allowed.has(value) ? value : fallback;
344
+ }
345
+ function classifyStatus(pathValue, httpStatus, fallback) {
346
+ if (httpStatus === 401 || httpStatus === 403)
347
+ return 'publicapi_authorization';
348
+ if (httpStatus === 404 && pathValue.includes('/api/auth'))
349
+ return 'authjs_config';
350
+ if (httpStatus >= 500 && pathValue.includes('/api/eai'))
351
+ return 'app_code_runtime_error';
352
+ if (httpStatus >= 500)
353
+ return 'app_not_running';
354
+ return fallback;
355
+ }
356
+ async function readJsonSafely(response) {
357
+ const text = await response.text();
358
+ if (!text.trim())
359
+ return null;
360
+ try {
361
+ return JSON.parse(text);
362
+ }
363
+ catch {
364
+ return text;
365
+ }
366
+ }
367
+ function hasTenantWorkflowProblem(body) {
368
+ if (!body || typeof body !== 'object' || Array.isArray(body)) {
369
+ return 'Runtime config did not return a JSON object.';
370
+ }
371
+ const tenants = body.tenants;
372
+ if (!tenants || typeof tenants !== 'object' || Array.isArray(tenants)) {
373
+ return 'Runtime config did not include a tenants object.';
374
+ }
375
+ for (const [key, value] of Object.entries(tenants)) {
376
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
377
+ return `Tenant key ${key} did not return an object.`;
378
+ }
379
+ const tenant = value;
380
+ if (typeof tenant.tenantId !== 'string' || tenant.tenantId.trim() === '') {
381
+ return `Tenant key ${key} is missing tenantId.`;
382
+ }
383
+ if (typeof tenant.workflowId !== 'string' || tenant.workflowId.trim() === '') {
384
+ return `Tenant key ${key} is missing workflowId.`;
385
+ }
386
+ }
387
+ return null;
388
+ }
389
+ function hasAuthProvidersProblem(body) {
390
+ if (!body || typeof body !== 'object' || Array.isArray(body)) {
391
+ return 'Auth.js providers endpoint did not return a JSON object.';
392
+ }
393
+ if (Object.keys(body).length === 0) {
394
+ return 'Auth.js providers endpoint returned no providers.';
395
+ }
396
+ return null;
397
+ }
398
+ async function runDoctorCheck(baseUrl, test, fallbackCategory) {
399
+ const url = combineUrl(baseUrl, test.path);
400
+ const expected = expectedStatuses(test);
401
+ const category = coerceDoctorCategory(test.category, fallbackCategory);
402
+ try {
403
+ const response = await fetch(url, {
404
+ method: test.method,
405
+ signal: AbortSignal.timeout(10_000),
406
+ });
407
+ const body = await readJsonSafely(response);
408
+ if (!expected.includes(response.status)) {
409
+ const failureCategory = classifyStatus(test.path, response.status, category);
410
+ const optionalStatus = test.optional ? 'warning' : 'fail';
411
+ return {
412
+ name: test.name,
413
+ method: test.method,
414
+ path: test.path,
415
+ url,
416
+ category: failureCategory,
417
+ status: optionalStatus,
418
+ httpStatus: response.status,
419
+ message: `Expected HTTP ${expected.join(' or ')}, received ${response.status}.`,
420
+ fix: 'Check the deployed app logs and the runtime contract for this endpoint.',
421
+ };
422
+ }
423
+ if (test.path.includes('/api/eai/config')) {
424
+ const problem = hasTenantWorkflowProblem(body);
425
+ if (problem) {
426
+ return {
427
+ name: test.name,
428
+ method: test.method,
429
+ path: test.path,
430
+ url,
431
+ category: 'tenant_workflow_config',
432
+ status: test.optional ? 'warning' : 'fail',
433
+ httpStatus: response.status,
434
+ message: problem,
435
+ fix: 'Set TENANT_KEYS plus TENANT_{KEY}_ID and WORKFLOW_{KEY}_ID for the deployed app.',
436
+ };
437
+ }
438
+ }
439
+ if (test.path.includes('/api/auth/providers')) {
440
+ const problem = hasAuthProvidersProblem(body);
441
+ if (problem) {
442
+ return {
443
+ name: test.name,
444
+ method: test.method,
445
+ path: test.path,
446
+ url,
447
+ category: 'authjs_config',
448
+ status: test.optional ? 'warning' : 'fail',
449
+ httpStatus: response.status,
450
+ message: problem,
451
+ fix: 'Check AUTH_SECRET, AUTH_URL, Entra client settings, and callback URL registration.',
452
+ };
453
+ }
454
+ }
455
+ return {
456
+ name: test.name,
457
+ method: test.method,
458
+ path: test.path,
459
+ url,
460
+ category,
461
+ status: 'pass',
462
+ httpStatus: response.status,
463
+ message: `HTTP ${response.status}`,
464
+ };
465
+ }
466
+ catch (error) {
467
+ const message = error instanceof Error ? error.message : String(error);
468
+ return {
469
+ name: test.name,
470
+ method: test.method,
471
+ path: test.path,
472
+ url,
473
+ category: test.path === '/health' ? 'app_not_running' : 'host/infrastructure',
474
+ status: test.optional ? 'warning' : 'fail',
475
+ message,
476
+ fix: 'Confirm the deployed URL is reachable from this machine and the app process is running.',
477
+ };
478
+ }
479
+ }
480
+ function dedupeSmokeTests(tests) {
481
+ const seen = new Set();
482
+ const unique = [];
483
+ for (const test of tests) {
484
+ const key = `${test.method}:${test.path}`;
485
+ if (!seen.has(key)) {
486
+ seen.add(key);
487
+ unique.push(test);
488
+ }
489
+ }
490
+ return unique;
491
+ }
492
+ export async function runDeployDoctor(url) {
493
+ const baseUrl = normalizeBaseUrl(url);
494
+ const validation = await validateRuntimeContract();
495
+ const loaded = await loadRuntimeContract(validation.projectRoot);
496
+ const checks = [];
497
+ if (validation.status === 'fail') {
498
+ for (const finding of validation.findings) {
499
+ checks.push({
500
+ name: finding.code,
501
+ method: 'LOCAL',
502
+ path: RUNTIME_CONTRACT_FILE,
503
+ url: validation.contractPath,
504
+ category: 'eai_publicapi_config',
505
+ status: 'fail',
506
+ message: finding.message,
507
+ fix: finding.fix,
508
+ });
509
+ }
510
+ }
511
+ const contract = loaded.contract;
512
+ const tests = dedupeSmokeTests([
513
+ {
514
+ name: 'health',
515
+ method: 'GET',
516
+ path: contract.endpoints.health || '/health',
517
+ expectedStatus: 200,
518
+ category: 'app_not_running',
519
+ },
520
+ {
521
+ name: 'auth-providers',
522
+ method: 'GET',
523
+ path: contract.endpoints.authProviders || '/api/auth/providers',
524
+ expectedStatus: 200,
525
+ category: 'authjs_config',
526
+ },
527
+ {
528
+ name: 'runtime-config',
529
+ method: 'GET',
530
+ path: contract.endpoints.runtimeConfig || '/api/eai/config',
531
+ expectedStatus: 200,
532
+ category: 'tenant_workflow_config',
533
+ },
534
+ ...contract.endpoints.public.map((endpoint, index) => ({
535
+ name: `public-${index + 1}`,
536
+ method: endpoint.method || 'GET',
537
+ path: endpoint.path || '/',
538
+ expectedStatus: 200,
539
+ category: endpoint.serverSidePlatformAccess
540
+ ? 'service_identity_app_only_auth_config'
541
+ : 'app_code_runtime_error',
542
+ })),
543
+ ...contract.endpoints.smokeTests,
544
+ ]);
545
+ for (const test of tests) {
546
+ checks.push(await runDoctorCheck(baseUrl, test, 'app_code_runtime_error'));
547
+ }
548
+ const hasBffSmoke = tests.some((test) => contract.endpoints.bffBasePath &&
549
+ test.path.startsWith(contract.endpoints.bffBasePath) &&
550
+ test.path !== contract.endpoints.runtimeConfig);
551
+ if (!hasBffSmoke) {
552
+ checks.push({
553
+ name: 'publicapi-bff-smoke-declared',
554
+ method: 'CONTRACT',
555
+ path: contract.endpoints.bffBasePath || '/api/eai',
556
+ url: contract.endpoints.bffBasePath || '/api/eai',
557
+ category: 'eai_publicapi_config',
558
+ status: 'warning',
559
+ message: 'No deployed BFF/PublicAPI smoke endpoint is declared; doctor cannot prove PublicAPI reachability through the app.',
560
+ fix: 'Add a safe read-only smoke endpoint to endpoints.smokeTests when the app exposes one.',
561
+ });
562
+ }
563
+ const summary = {
564
+ pass: checks.filter((check) => check.status === 'pass').length,
565
+ fail: checks.filter((check) => check.status === 'fail').length,
566
+ warning: checks.filter((check) => check.status === 'warning').length,
567
+ skip: checks.filter((check) => check.status === 'skip').length,
568
+ };
569
+ return {
570
+ url: baseUrl,
571
+ contract: loaded.contractPath,
572
+ status: summary.fail > 0 ? 'fail' : 'pass',
573
+ checks,
574
+ summary,
575
+ };
576
+ }
577
+ deployCommand
578
+ .command('doctor')
579
+ .description('Black-box check a deployed EAI app runtime')
580
+ .requiredOption('--url <url>', 'Deployed app base URL')
581
+ .option('--format <format>', 'Output format (text|json)', 'text')
582
+ .option('--json', 'Output raw JSON (deprecated, use --format json)', false)
583
+ .addHelpText('after', `
584
+ Examples:
585
+ $ eai deploy doctor --url https://my-app.example.com
586
+ $ eai deploy doctor --url https://my-app.example.com --format json
587
+ `)
588
+ .action(async (options) => {
589
+ if (options.json)
590
+ options.format = 'json';
591
+ let result;
592
+ try {
593
+ result = await runDeployDoctor(options.url);
594
+ }
595
+ catch (error) {
596
+ const message = error instanceof Error ? error.message : String(error);
597
+ if (options.format === 'json') {
598
+ out.json({ status: 'fail', error: message });
599
+ }
600
+ else {
601
+ out.error(message);
602
+ }
603
+ process.exit(1);
604
+ return;
605
+ }
606
+ if (options.format === 'json') {
607
+ out.json(result);
608
+ if (result.status === 'fail')
609
+ process.exit(1);
610
+ return;
611
+ }
612
+ out.heading('EAI Deploy Doctor');
613
+ out.table([
614
+ ['URL', result.url],
615
+ ['Contract', result.contract],
616
+ ['Status', result.status === 'pass' ? 'PASS' : 'FAIL'],
617
+ ['Passed', String(result.summary.pass)],
618
+ ['Failed', String(result.summary.fail)],
619
+ ['Warnings', String(result.summary.warning)],
620
+ ]);
621
+ out.blank();
622
+ for (const check of result.checks) {
623
+ const icon = check.status === 'pass'
624
+ ? out.symbols.success
625
+ : check.status === 'warning'
626
+ ? out.symbols.warning
627
+ : out.symbols.error;
628
+ console.log(`${icon} ${check.name} [${check.category}] ${check.method} ${check.path}: ${check.message}`);
629
+ if (check.fix && check.status !== 'pass')
630
+ out.info(`Fix: ${check.fix}`);
631
+ }
632
+ out.blank();
633
+ if (result.status === 'pass') {
634
+ out.success('Deployment runtime checks passed.');
635
+ }
636
+ else {
637
+ out.error('Deployment runtime checks failed.');
638
+ process.exit(1);
639
+ }
640
+ });
641
+ function generateWorkflow(appName) {
642
+ return `name: Deploy ${appName}
643
+
644
+ on:
645
+ push:
646
+ branches: [main]
647
+ workflow_dispatch:
648
+
649
+ env:
650
+ APP_NAME: ${appName}
651
+ NODE_VERSION: '20.x'
652
+
653
+ jobs:
654
+ build-and-deploy:
655
+ runs-on: ubuntu-latest
656
+ environment: demo
657
+ permissions:
658
+ id-token: write
659
+ contents: read
660
+
661
+ steps:
662
+ - uses: actions/checkout@v4
663
+
664
+ - name: Set up Node.js
665
+ uses: actions/setup-node@v4
666
+ with:
667
+ node-version: \${{ env.NODE_VERSION }}
668
+ cache: 'npm'
669
+
670
+ - name: Install dependencies
671
+ run: npm ci
672
+
673
+ - name: Build Object Types JSON
674
+ run: npm run build:object-types
675
+
676
+ - name: Build
677
+ run: npm run build
678
+ env:
679
+ APP_BASE_PATH: /\${{ env.APP_NAME }}
680
+
681
+ - name: Package standalone output
682
+ run: |
683
+ mkdir -p deploy/\${{ env.APP_NAME }}
684
+ cp -r .next/standalone/. deploy/\${{ env.APP_NAME }}/
685
+ cp -r .next/static deploy/\${{ env.APP_NAME }}/.next/
686
+ cp -r public deploy/\${{ env.APP_NAME }}/ 2>/dev/null || true
687
+ cd deploy && zip -r ../app-content.zip \${{ env.APP_NAME }}
688
+
689
+ - name: Azure Login
690
+ uses: azure/login@v2
691
+ with:
692
+ client-id: \${{ secrets.AZUREAPPSERVICE_CLIENTID }}
693
+ tenant-id: \${{ secrets.AZUREAPPSERVICE_TENANTID }}
694
+ subscription-id: \${{ secrets.AZUREAPPSERVICE_SUBSCRIPTIONID }}
695
+
696
+ - name: Deploy to Azure
697
+ run: |
698
+ az webapp deploy \\
699
+ --resource-group \${{ secrets.AZURE_RESOURCE_GROUP }} \\
700
+ --name \${{ secrets.AZURE_WEBAPP_NAME }} \\
701
+ --src-path app-content.zip \\
702
+ --type zip \\
703
+ --target-path /home/site/wwwroot/\${{ env.APP_NAME }}
704
+
705
+ - name: Restart App Service
706
+ run: |
707
+ az webapp restart \\
708
+ --resource-group \${{ secrets.AZURE_RESOURCE_GROUP }} \\
709
+ --name \${{ secrets.AZURE_WEBAPP_NAME }}
710
+ `;
711
+ }
712
+ //# sourceMappingURL=deploy.js.map