@josstei/maestro 1.6.4-nightly.20260430

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 (655) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/CHANGELOG.md +486 -0
  3. package/EXAMPLES.md +255 -0
  4. package/GEMINI.md +251 -0
  5. package/LICENSE +201 -0
  6. package/QWEN.md +274 -0
  7. package/README.md +220 -0
  8. package/agents/accessibility_specialist.md +20 -0
  9. package/agents/analytics_engineer.md +22 -0
  10. package/agents/api_designer.md +19 -0
  11. package/agents/architect.md +19 -0
  12. package/agents/cloud_architect.md +19 -0
  13. package/agents/cobol_engineer.md +22 -0
  14. package/agents/code_reviewer.md +17 -0
  15. package/agents/coder.md +22 -0
  16. package/agents/compliance_reviewer.md +19 -0
  17. package/agents/content_strategist.md +19 -0
  18. package/agents/copywriter.md +19 -0
  19. package/agents/data_engineer.md +22 -0
  20. package/agents/database_administrator.md +21 -0
  21. package/agents/db2_dba.md +21 -0
  22. package/agents/debugger.md +19 -0
  23. package/agents/design_system_engineer.md +22 -0
  24. package/agents/devops_engineer.md +23 -0
  25. package/agents/hlasm_assembler_specialist.md +22 -0
  26. package/agents/i18n_specialist.md +21 -0
  27. package/agents/ibm_i_specialist.md +22 -0
  28. package/agents/integration_engineer.md +23 -0
  29. package/agents/ml_engineer.md +23 -0
  30. package/agents/mlops_engineer.md +23 -0
  31. package/agents/mobile_engineer.md +23 -0
  32. package/agents/observability_engineer.md +23 -0
  33. package/agents/performance_engineer.md +21 -0
  34. package/agents/platform_engineer.md +24 -0
  35. package/agents/product_manager.md +20 -0
  36. package/agents/prompt_engineer.md +22 -0
  37. package/agents/refactor.md +22 -0
  38. package/agents/release_manager.md +22 -0
  39. package/agents/security_engineer.md +21 -0
  40. package/agents/seo_specialist.md +21 -0
  41. package/agents/site_reliability_engineer.md +21 -0
  42. package/agents/solutions_architect.md +19 -0
  43. package/agents/technical_writer.md +21 -0
  44. package/agents/tester.md +23 -0
  45. package/agents/ux_designer.md +20 -0
  46. package/agents/zos_sysprog.md +21 -0
  47. package/bin/maestro-mcp-server.js +10 -0
  48. package/claude/.claude-plugin/plugin.json +21 -0
  49. package/claude/.mcp.json +11 -0
  50. package/claude/README.md +191 -0
  51. package/claude/agents/accessibility-specialist.md +36 -0
  52. package/claude/agents/analytics-engineer.md +38 -0
  53. package/claude/agents/api-designer.md +33 -0
  54. package/claude/agents/architect.md +33 -0
  55. package/claude/agents/cloud-architect.md +33 -0
  56. package/claude/agents/cobol-engineer.md +38 -0
  57. package/claude/agents/code-reviewer.md +31 -0
  58. package/claude/agents/coder.md +38 -0
  59. package/claude/agents/compliance-reviewer.md +33 -0
  60. package/claude/agents/content-strategist.md +33 -0
  61. package/claude/agents/copywriter.md +33 -0
  62. package/claude/agents/data-engineer.md +37 -0
  63. package/claude/agents/database-administrator.md +37 -0
  64. package/claude/agents/db2-dba.md +37 -0
  65. package/claude/agents/debugger.md +32 -0
  66. package/claude/agents/design-system-engineer.md +38 -0
  67. package/claude/agents/devops-engineer.md +39 -0
  68. package/claude/agents/hlasm-assembler-specialist.md +38 -0
  69. package/claude/agents/i18n-specialist.md +37 -0
  70. package/claude/agents/ibm-i-specialist.md +38 -0
  71. package/claude/agents/integration-engineer.md +39 -0
  72. package/claude/agents/ml-engineer.md +39 -0
  73. package/claude/agents/mlops-engineer.md +39 -0
  74. package/claude/agents/mobile-engineer.md +39 -0
  75. package/claude/agents/observability-engineer.md +39 -0
  76. package/claude/agents/performance-engineer.md +34 -0
  77. package/claude/agents/platform-engineer.md +40 -0
  78. package/claude/agents/product-manager.md +34 -0
  79. package/claude/agents/prompt-engineer.md +38 -0
  80. package/claude/agents/refactor.md +38 -0
  81. package/claude/agents/release-manager.md +38 -0
  82. package/claude/agents/security-engineer.md +37 -0
  83. package/claude/agents/seo-specialist.md +37 -0
  84. package/claude/agents/site-reliability-engineer.md +37 -0
  85. package/claude/agents/solutions-architect.md +33 -0
  86. package/claude/agents/technical-writer.md +37 -0
  87. package/claude/agents/tester.md +39 -0
  88. package/claude/agents/ux-designer.md +34 -0
  89. package/claude/agents/zos-sysprog.md +37 -0
  90. package/claude/hooks/claude-hooks.json +48 -0
  91. package/claude/mcp/maestro-server.js +9 -0
  92. package/claude/mcp-config.example.json +9 -0
  93. package/claude/scripts/adapters/claude-adapter.js +7 -0
  94. package/claude/scripts/hook-runner.js +8 -0
  95. package/claude/scripts/policy-enforcer.js +294 -0
  96. package/claude/skills/a11y-audit/SKILL.md +26 -0
  97. package/claude/skills/archive/SKILL.md +24 -0
  98. package/claude/skills/code-review/SKILL.md +7 -0
  99. package/claude/skills/compliance-check/SKILL.md +26 -0
  100. package/claude/skills/debug-workflow/SKILL.md +27 -0
  101. package/claude/skills/delegation/SKILL.md +7 -0
  102. package/claude/skills/design-dialogue/SKILL.md +7 -0
  103. package/claude/skills/execute/SKILL.md +38 -0
  104. package/claude/skills/execution/SKILL.md +7 -0
  105. package/claude/skills/implementation-planning/SKILL.md +7 -0
  106. package/claude/skills/orchestrate/SKILL.md +38 -0
  107. package/claude/skills/perf-check/SKILL.md +26 -0
  108. package/claude/skills/resume-session/SKILL.md +38 -0
  109. package/claude/skills/review-code/SKILL.md +27 -0
  110. package/claude/skills/security-audit/SKILL.md +28 -0
  111. package/claude/skills/seo-audit/SKILL.md +26 -0
  112. package/claude/skills/session-management/SKILL.md +7 -0
  113. package/claude/skills/status/SKILL.md +22 -0
  114. package/claude/skills/validation/SKILL.md +7 -0
  115. package/claude/src/agents/accessibility-specialist.md +163 -0
  116. package/claude/src/agents/analytics-engineer.md +182 -0
  117. package/claude/src/agents/api-designer.md +124 -0
  118. package/claude/src/agents/architect.md +120 -0
  119. package/claude/src/agents/cloud-architect.md +134 -0
  120. package/claude/src/agents/cobol-engineer.md +127 -0
  121. package/claude/src/agents/code-reviewer.md +123 -0
  122. package/claude/src/agents/coder.md +132 -0
  123. package/claude/src/agents/compliance-reviewer.md +219 -0
  124. package/claude/src/agents/content-strategist.md +111 -0
  125. package/claude/src/agents/copywriter.md +113 -0
  126. package/claude/src/agents/data-engineer.md +130 -0
  127. package/claude/src/agents/database-administrator.md +126 -0
  128. package/claude/src/agents/db2-dba.md +124 -0
  129. package/claude/src/agents/debugger.md +133 -0
  130. package/claude/src/agents/design-system-engineer.md +258 -0
  131. package/claude/src/agents/devops-engineer.md +138 -0
  132. package/claude/src/agents/hlasm-assembler-specialist.md +134 -0
  133. package/claude/src/agents/i18n-specialist.md +241 -0
  134. package/claude/src/agents/ibm-i-specialist.md +132 -0
  135. package/claude/src/agents/integration-engineer.md +133 -0
  136. package/claude/src/agents/ml-engineer.md +115 -0
  137. package/claude/src/agents/mlops-engineer.md +116 -0
  138. package/claude/src/agents/mobile-engineer.md +115 -0
  139. package/claude/src/agents/observability-engineer.md +133 -0
  140. package/claude/src/agents/performance-engineer.md +139 -0
  141. package/claude/src/agents/platform-engineer.md +129 -0
  142. package/claude/src/agents/product-manager.md +170 -0
  143. package/claude/src/agents/prompt-engineer.md +129 -0
  144. package/claude/src/agents/refactor.md +138 -0
  145. package/claude/src/agents/release-manager.md +132 -0
  146. package/claude/src/agents/security-engineer.md +143 -0
  147. package/claude/src/agents/seo-specialist.md +129 -0
  148. package/claude/src/agents/site-reliability-engineer.md +131 -0
  149. package/claude/src/agents/solutions-architect.md +137 -0
  150. package/claude/src/agents/technical-writer.md +129 -0
  151. package/claude/src/agents/tester.md +135 -0
  152. package/claude/src/agents/ux-designer.md +168 -0
  153. package/claude/src/agents/zos-sysprog.md +134 -0
  154. package/claude/src/config/setting-resolver.js +32 -0
  155. package/claude/src/core/agent-registry.js +67 -0
  156. package/claude/src/core/canonical-source.js +39 -0
  157. package/claude/src/core/env-file-parser.js +82 -0
  158. package/claude/src/core/feature-blocks.js +34 -0
  159. package/claude/src/core/logger.js +12 -0
  160. package/claude/src/core/markdown-state.js +36 -0
  161. package/claude/src/core/policy-rules.js +32 -0
  162. package/claude/src/core/project-root-resolver.js +184 -0
  163. package/claude/src/core/stdin-reader.js +77 -0
  164. package/claude/src/core/version.js +50 -0
  165. package/claude/src/entry-points/core-command-registry.js +37 -0
  166. package/claude/src/entry-points/preamble-builders.js +54 -0
  167. package/claude/src/entry-points/registry.js +199 -0
  168. package/claude/src/entry-points/templates/claude-core-command.md.tmpl +38 -0
  169. package/claude/src/entry-points/templates/claude-skill.md.tmpl +18 -0
  170. package/claude/src/entry-points/templates/codex-core-command.md.tmpl +16 -0
  171. package/claude/src/entry-points/templates/codex-skill.md.tmpl +11 -0
  172. package/claude/src/entry-points/templates/gemini-command.toml.tmpl +17 -0
  173. package/claude/src/entry-points/templates/gemini-core-command.toml.tmpl +30 -0
  174. package/claude/src/generated/agent-registry.json +630 -0
  175. package/claude/src/generated/hook-registry.json +18 -0
  176. package/claude/src/generated/resource-registry.json +16 -0
  177. package/claude/src/hooks/logic/after-agent-logic.js +54 -0
  178. package/claude/src/hooks/logic/before-agent-logic.js +57 -0
  179. package/claude/src/hooks/logic/hook-state.js +127 -0
  180. package/claude/src/hooks/logic/session-end-logic.js +17 -0
  181. package/claude/src/hooks/logic/session-start-logic.js +25 -0
  182. package/claude/src/lib/discovery/index.js +172 -0
  183. package/claude/src/lib/errors/index.js +104 -0
  184. package/claude/src/lib/framework-detection.js +50 -0
  185. package/claude/src/lib/frontmatter/index.js +262 -0
  186. package/claude/src/lib/io/index.js +96 -0
  187. package/claude/src/lib/naming/index.js +94 -0
  188. package/claude/src/lib/validation/index.js +124 -0
  189. package/claude/src/lib/yaml-emit.js +38 -0
  190. package/claude/src/mcp/content/provider.js +68 -0
  191. package/claude/src/mcp/content/runtime-content.js +188 -0
  192. package/claude/src/mcp/contracts/cache-path-rejector.js +39 -0
  193. package/claude/src/mcp/contracts/downstream-context.js +106 -0
  194. package/claude/src/mcp/contracts/plan-schema.js +148 -0
  195. package/claude/src/mcp/contracts/workspace-marker.js +61 -0
  196. package/claude/src/mcp/core/create-server.js +76 -0
  197. package/claude/src/mcp/core/line-reader.js +35 -0
  198. package/claude/src/mcp/core/project-root-cache.js +120 -0
  199. package/claude/src/mcp/core/protocol-dispatcher.js +274 -0
  200. package/claude/src/mcp/core/recovery-hints.js +43 -0
  201. package/claude/src/mcp/core/tool-outcome.js +77 -0
  202. package/claude/src/mcp/core/tool-registry.js +82 -0
  203. package/claude/src/mcp/handlers/assess-task-complexity.js +108 -0
  204. package/claude/src/mcp/handlers/blocker-parser.js +34 -0
  205. package/claude/src/mcp/handlers/design-gate.js +393 -0
  206. package/claude/src/mcp/handlers/get-agent.js +54 -0
  207. package/claude/src/mcp/handlers/get-runtime-context.js +49 -0
  208. package/claude/src/mcp/handlers/get-skill-content.js +51 -0
  209. package/claude/src/mcp/handlers/initialize-workspace.js +45 -0
  210. package/claude/src/mcp/handlers/reconciliation.js +224 -0
  211. package/claude/src/mcp/handlers/resolve-settings.js +39 -0
  212. package/claude/src/mcp/handlers/session-state-core.js +108 -0
  213. package/claude/src/mcp/handlers/session-state-tools.js +562 -0
  214. package/claude/src/mcp/handlers/validate-plan.js +76 -0
  215. package/claude/src/mcp/maestro-server.js +122 -0
  216. package/claude/src/mcp/runtime/runtime-config-map.js +70 -0
  217. package/claude/src/mcp/tool-packs/content/index.js +80 -0
  218. package/claude/src/mcp/tool-packs/contracts.js +30 -0
  219. package/claude/src/mcp/tool-packs/index.js +15 -0
  220. package/claude/src/mcp/tool-packs/session/index.js +243 -0
  221. package/claude/src/mcp/tool-packs/workspace/index.js +98 -0
  222. package/claude/src/mcp/utils/extension-root.js +31 -0
  223. package/claude/src/mcp/validation/agent-checker.js +81 -0
  224. package/claude/src/mcp/validation/dag-checker.js +214 -0
  225. package/claude/src/mcp/validation/file-overlap-checker.js +63 -0
  226. package/claude/src/mcp/validation/schema-checker.js +108 -0
  227. package/claude/src/platforms/claude/runtime-config.js +60 -0
  228. package/claude/src/platforms/shared/adapters/claude-adapter.js +36 -0
  229. package/claude/src/platforms/shared/adapters/conventions.js +29 -0
  230. package/claude/src/platforms/shared/adapters/exit-codes.js +6 -0
  231. package/claude/src/platforms/shared/adapters/factory.js +40 -0
  232. package/claude/src/platforms/shared/agent-names.js +15 -0
  233. package/claude/src/platforms/shared/hook-runner.js +52 -0
  234. package/claude/src/references/architecture.md +139 -0
  235. package/claude/src/references/orchestration-steps.md +193 -0
  236. package/claude/src/skills/shared/code-review/SKILL.md +145 -0
  237. package/claude/src/skills/shared/delegation/SKILL.md +387 -0
  238. package/claude/src/skills/shared/delegation/protocols/agent-base-protocol.md +145 -0
  239. package/claude/src/skills/shared/delegation/protocols/filesystem-safety-protocol.md +31 -0
  240. package/claude/src/skills/shared/design-dialogue/SKILL.md +284 -0
  241. package/claude/src/skills/shared/execution/SKILL.md +258 -0
  242. package/claude/src/skills/shared/implementation-planning/SKILL.md +307 -0
  243. package/claude/src/skills/shared/session-management/SKILL.md +314 -0
  244. package/claude/src/skills/shared/validation/SKILL.md +204 -0
  245. package/claude/src/state/session-state.js +113 -0
  246. package/claude/src/templates/design-document.md +95 -0
  247. package/claude/src/templates/implementation-plan.md +86 -0
  248. package/claude/src/templates/session-state.md +68 -0
  249. package/claude/src/version.json +3 -0
  250. package/commands/maestro/a11y-audit.toml +22 -0
  251. package/commands/maestro/archive.toml +23 -0
  252. package/commands/maestro/compliance-check.toml +22 -0
  253. package/commands/maestro/debug.toml +23 -0
  254. package/commands/maestro/execute.toml +30 -0
  255. package/commands/maestro/orchestrate.toml +30 -0
  256. package/commands/maestro/perf-check.toml +22 -0
  257. package/commands/maestro/resume.toml +38 -0
  258. package/commands/maestro/review.toml +23 -0
  259. package/commands/maestro/security-audit.toml +24 -0
  260. package/commands/maestro/seo-audit.toml +22 -0
  261. package/commands/maestro/status.toml +21 -0
  262. package/docs/architecture.md +323 -0
  263. package/docs/cicd.md +658 -0
  264. package/docs/flow.md +266 -0
  265. package/docs/maestro-cheatsheet.md +207 -0
  266. package/docs/overview.md +141 -0
  267. package/docs/runtime-claude.md +190 -0
  268. package/docs/runtime-codex.md +197 -0
  269. package/docs/runtime-gemini.md +173 -0
  270. package/docs/runtime-qwen.md +150 -0
  271. package/docs/usage.md +315 -0
  272. package/gemini-extension.json +56 -0
  273. package/hooks/adapters/gemini-adapter.js +2 -0
  274. package/hooks/adapters/qwen-adapter.js +2 -0
  275. package/hooks/hook-runner.js +3 -0
  276. package/hooks/hooks.json +56 -0
  277. package/mcp/maestro-server.js +4 -0
  278. package/package.json +93 -0
  279. package/plugins/maestro/.app.json +3 -0
  280. package/plugins/maestro/.codex-plugin/plugin.json +41 -0
  281. package/plugins/maestro/.mcp.json +16 -0
  282. package/plugins/maestro/README.md +57 -0
  283. package/plugins/maestro/references/runtime-guide.md +125 -0
  284. package/plugins/maestro/skills/a11y-audit/SKILL.md +16 -0
  285. package/plugins/maestro/skills/archive/SKILL.md +16 -0
  286. package/plugins/maestro/skills/code-review/SKILL.md +6 -0
  287. package/plugins/maestro/skills/compliance-check/SKILL.md +16 -0
  288. package/plugins/maestro/skills/debug-workflow/SKILL.md +16 -0
  289. package/plugins/maestro/skills/delegation/SKILL.md +6 -0
  290. package/plugins/maestro/skills/design-dialogue/SKILL.md +6 -0
  291. package/plugins/maestro/skills/execute/SKILL.md +16 -0
  292. package/plugins/maestro/skills/execution/SKILL.md +6 -0
  293. package/plugins/maestro/skills/implementation-planning/SKILL.md +6 -0
  294. package/plugins/maestro/skills/orchestrate/SKILL.md +16 -0
  295. package/plugins/maestro/skills/perf-check/SKILL.md +16 -0
  296. package/plugins/maestro/skills/resume-session/SKILL.md +16 -0
  297. package/plugins/maestro/skills/review-code/SKILL.md +16 -0
  298. package/plugins/maestro/skills/security-audit/SKILL.md +16 -0
  299. package/plugins/maestro/skills/seo-audit/SKILL.md +16 -0
  300. package/plugins/maestro/skills/session-management/SKILL.md +6 -0
  301. package/plugins/maestro/skills/status/SKILL.md +14 -0
  302. package/plugins/maestro/skills/validation/SKILL.md +6 -0
  303. package/plugins/maestro/src/agents/accessibility-specialist.md +163 -0
  304. package/plugins/maestro/src/agents/analytics-engineer.md +182 -0
  305. package/plugins/maestro/src/agents/api-designer.md +124 -0
  306. package/plugins/maestro/src/agents/architect.md +120 -0
  307. package/plugins/maestro/src/agents/cloud-architect.md +134 -0
  308. package/plugins/maestro/src/agents/cobol-engineer.md +127 -0
  309. package/plugins/maestro/src/agents/code-reviewer.md +123 -0
  310. package/plugins/maestro/src/agents/coder.md +132 -0
  311. package/plugins/maestro/src/agents/compliance-reviewer.md +219 -0
  312. package/plugins/maestro/src/agents/content-strategist.md +111 -0
  313. package/plugins/maestro/src/agents/copywriter.md +113 -0
  314. package/plugins/maestro/src/agents/data-engineer.md +130 -0
  315. package/plugins/maestro/src/agents/database-administrator.md +126 -0
  316. package/plugins/maestro/src/agents/db2-dba.md +124 -0
  317. package/plugins/maestro/src/agents/debugger.md +133 -0
  318. package/plugins/maestro/src/agents/design-system-engineer.md +258 -0
  319. package/plugins/maestro/src/agents/devops-engineer.md +138 -0
  320. package/plugins/maestro/src/agents/hlasm-assembler-specialist.md +134 -0
  321. package/plugins/maestro/src/agents/i18n-specialist.md +241 -0
  322. package/plugins/maestro/src/agents/ibm-i-specialist.md +132 -0
  323. package/plugins/maestro/src/agents/integration-engineer.md +133 -0
  324. package/plugins/maestro/src/agents/ml-engineer.md +115 -0
  325. package/plugins/maestro/src/agents/mlops-engineer.md +116 -0
  326. package/plugins/maestro/src/agents/mobile-engineer.md +115 -0
  327. package/plugins/maestro/src/agents/observability-engineer.md +133 -0
  328. package/plugins/maestro/src/agents/performance-engineer.md +139 -0
  329. package/plugins/maestro/src/agents/platform-engineer.md +129 -0
  330. package/plugins/maestro/src/agents/product-manager.md +170 -0
  331. package/plugins/maestro/src/agents/prompt-engineer.md +129 -0
  332. package/plugins/maestro/src/agents/refactor.md +138 -0
  333. package/plugins/maestro/src/agents/release-manager.md +132 -0
  334. package/plugins/maestro/src/agents/security-engineer.md +143 -0
  335. package/plugins/maestro/src/agents/seo-specialist.md +129 -0
  336. package/plugins/maestro/src/agents/site-reliability-engineer.md +131 -0
  337. package/plugins/maestro/src/agents/solutions-architect.md +137 -0
  338. package/plugins/maestro/src/agents/technical-writer.md +129 -0
  339. package/plugins/maestro/src/agents/tester.md +135 -0
  340. package/plugins/maestro/src/agents/ux-designer.md +168 -0
  341. package/plugins/maestro/src/agents/zos-sysprog.md +134 -0
  342. package/plugins/maestro/src/config/setting-resolver.js +32 -0
  343. package/plugins/maestro/src/core/agent-registry.js +67 -0
  344. package/plugins/maestro/src/core/canonical-source.js +39 -0
  345. package/plugins/maestro/src/core/env-file-parser.js +82 -0
  346. package/plugins/maestro/src/core/feature-blocks.js +34 -0
  347. package/plugins/maestro/src/core/logger.js +12 -0
  348. package/plugins/maestro/src/core/markdown-state.js +36 -0
  349. package/plugins/maestro/src/core/policy-rules.js +32 -0
  350. package/plugins/maestro/src/core/project-root-resolver.js +184 -0
  351. package/plugins/maestro/src/core/stdin-reader.js +77 -0
  352. package/plugins/maestro/src/core/version.js +50 -0
  353. package/plugins/maestro/src/entry-points/core-command-registry.js +37 -0
  354. package/plugins/maestro/src/entry-points/preamble-builders.js +54 -0
  355. package/plugins/maestro/src/entry-points/registry.js +199 -0
  356. package/plugins/maestro/src/entry-points/templates/claude-core-command.md.tmpl +38 -0
  357. package/plugins/maestro/src/entry-points/templates/claude-skill.md.tmpl +18 -0
  358. package/plugins/maestro/src/entry-points/templates/codex-core-command.md.tmpl +16 -0
  359. package/plugins/maestro/src/entry-points/templates/codex-skill.md.tmpl +11 -0
  360. package/plugins/maestro/src/entry-points/templates/gemini-command.toml.tmpl +17 -0
  361. package/plugins/maestro/src/entry-points/templates/gemini-core-command.toml.tmpl +30 -0
  362. package/plugins/maestro/src/generated/agent-registry.json +630 -0
  363. package/plugins/maestro/src/generated/hook-registry.json +18 -0
  364. package/plugins/maestro/src/generated/resource-registry.json +16 -0
  365. package/plugins/maestro/src/hooks/logic/after-agent-logic.js +54 -0
  366. package/plugins/maestro/src/hooks/logic/before-agent-logic.js +57 -0
  367. package/plugins/maestro/src/hooks/logic/hook-state.js +127 -0
  368. package/plugins/maestro/src/hooks/logic/session-end-logic.js +17 -0
  369. package/plugins/maestro/src/hooks/logic/session-start-logic.js +25 -0
  370. package/plugins/maestro/src/lib/discovery/index.js +172 -0
  371. package/plugins/maestro/src/lib/errors/index.js +104 -0
  372. package/plugins/maestro/src/lib/framework-detection.js +50 -0
  373. package/plugins/maestro/src/lib/frontmatter/index.js +262 -0
  374. package/plugins/maestro/src/lib/io/index.js +96 -0
  375. package/plugins/maestro/src/lib/naming/index.js +94 -0
  376. package/plugins/maestro/src/lib/validation/index.js +124 -0
  377. package/plugins/maestro/src/lib/yaml-emit.js +38 -0
  378. package/plugins/maestro/src/mcp/content/provider.js +68 -0
  379. package/plugins/maestro/src/mcp/content/runtime-content.js +188 -0
  380. package/plugins/maestro/src/mcp/contracts/cache-path-rejector.js +39 -0
  381. package/plugins/maestro/src/mcp/contracts/downstream-context.js +106 -0
  382. package/plugins/maestro/src/mcp/contracts/plan-schema.js +148 -0
  383. package/plugins/maestro/src/mcp/contracts/workspace-marker.js +61 -0
  384. package/plugins/maestro/src/mcp/core/create-server.js +76 -0
  385. package/plugins/maestro/src/mcp/core/line-reader.js +35 -0
  386. package/plugins/maestro/src/mcp/core/project-root-cache.js +120 -0
  387. package/plugins/maestro/src/mcp/core/protocol-dispatcher.js +274 -0
  388. package/plugins/maestro/src/mcp/core/recovery-hints.js +43 -0
  389. package/plugins/maestro/src/mcp/core/tool-outcome.js +77 -0
  390. package/plugins/maestro/src/mcp/core/tool-registry.js +82 -0
  391. package/plugins/maestro/src/mcp/handlers/assess-task-complexity.js +108 -0
  392. package/plugins/maestro/src/mcp/handlers/blocker-parser.js +34 -0
  393. package/plugins/maestro/src/mcp/handlers/design-gate.js +393 -0
  394. package/plugins/maestro/src/mcp/handlers/get-agent.js +54 -0
  395. package/plugins/maestro/src/mcp/handlers/get-runtime-context.js +49 -0
  396. package/plugins/maestro/src/mcp/handlers/get-skill-content.js +51 -0
  397. package/plugins/maestro/src/mcp/handlers/initialize-workspace.js +45 -0
  398. package/plugins/maestro/src/mcp/handlers/reconciliation.js +224 -0
  399. package/plugins/maestro/src/mcp/handlers/resolve-settings.js +39 -0
  400. package/plugins/maestro/src/mcp/handlers/session-state-core.js +108 -0
  401. package/plugins/maestro/src/mcp/handlers/session-state-tools.js +562 -0
  402. package/plugins/maestro/src/mcp/handlers/validate-plan.js +76 -0
  403. package/plugins/maestro/src/mcp/maestro-server.js +122 -0
  404. package/plugins/maestro/src/mcp/runtime/runtime-config-map.js +70 -0
  405. package/plugins/maestro/src/mcp/tool-packs/content/index.js +80 -0
  406. package/plugins/maestro/src/mcp/tool-packs/contracts.js +30 -0
  407. package/plugins/maestro/src/mcp/tool-packs/index.js +15 -0
  408. package/plugins/maestro/src/mcp/tool-packs/session/index.js +243 -0
  409. package/plugins/maestro/src/mcp/tool-packs/workspace/index.js +98 -0
  410. package/plugins/maestro/src/mcp/utils/extension-root.js +31 -0
  411. package/plugins/maestro/src/mcp/validation/agent-checker.js +81 -0
  412. package/plugins/maestro/src/mcp/validation/dag-checker.js +214 -0
  413. package/plugins/maestro/src/mcp/validation/file-overlap-checker.js +63 -0
  414. package/plugins/maestro/src/mcp/validation/schema-checker.js +108 -0
  415. package/plugins/maestro/src/platforms/codex/runtime-config.js +58 -0
  416. package/plugins/maestro/src/platforms/shared/adapters/conventions.js +29 -0
  417. package/plugins/maestro/src/platforms/shared/adapters/exit-codes.js +6 -0
  418. package/plugins/maestro/src/platforms/shared/adapters/factory.js +40 -0
  419. package/plugins/maestro/src/platforms/shared/agent-names.js +15 -0
  420. package/plugins/maestro/src/platforms/shared/hook-runner.js +52 -0
  421. package/plugins/maestro/src/references/architecture.md +139 -0
  422. package/plugins/maestro/src/references/orchestration-steps.md +193 -0
  423. package/plugins/maestro/src/skills/shared/code-review/SKILL.md +145 -0
  424. package/plugins/maestro/src/skills/shared/delegation/SKILL.md +387 -0
  425. package/plugins/maestro/src/skills/shared/delegation/protocols/agent-base-protocol.md +145 -0
  426. package/plugins/maestro/src/skills/shared/delegation/protocols/filesystem-safety-protocol.md +31 -0
  427. package/plugins/maestro/src/skills/shared/design-dialogue/SKILL.md +284 -0
  428. package/plugins/maestro/src/skills/shared/execution/SKILL.md +258 -0
  429. package/plugins/maestro/src/skills/shared/implementation-planning/SKILL.md +307 -0
  430. package/plugins/maestro/src/skills/shared/session-management/SKILL.md +314 -0
  431. package/plugins/maestro/src/skills/shared/validation/SKILL.md +204 -0
  432. package/plugins/maestro/src/state/session-state.js +113 -0
  433. package/plugins/maestro/src/templates/design-document.md +95 -0
  434. package/plugins/maestro/src/templates/implementation-plan.md +86 -0
  435. package/plugins/maestro/src/templates/session-state.md +68 -0
  436. package/plugins/maestro/src/version.json +3 -0
  437. package/policies/maestro.toml +44 -0
  438. package/qwen/agents/accessibility_specialist.md +18 -0
  439. package/qwen/agents/analytics_engineer.md +20 -0
  440. package/qwen/agents/api_designer.md +17 -0
  441. package/qwen/agents/architect.md +17 -0
  442. package/qwen/agents/cloud_architect.md +17 -0
  443. package/qwen/agents/cobol_engineer.md +20 -0
  444. package/qwen/agents/code_reviewer.md +15 -0
  445. package/qwen/agents/coder.md +20 -0
  446. package/qwen/agents/compliance_reviewer.md +17 -0
  447. package/qwen/agents/content_strategist.md +17 -0
  448. package/qwen/agents/copywriter.md +17 -0
  449. package/qwen/agents/data_engineer.md +20 -0
  450. package/qwen/agents/database_administrator.md +19 -0
  451. package/qwen/agents/db2_dba.md +19 -0
  452. package/qwen/agents/debugger.md +17 -0
  453. package/qwen/agents/design_system_engineer.md +20 -0
  454. package/qwen/agents/devops_engineer.md +21 -0
  455. package/qwen/agents/hlasm_assembler_specialist.md +20 -0
  456. package/qwen/agents/i18n_specialist.md +19 -0
  457. package/qwen/agents/ibm_i_specialist.md +20 -0
  458. package/qwen/agents/integration_engineer.md +21 -0
  459. package/qwen/agents/ml_engineer.md +21 -0
  460. package/qwen/agents/mlops_engineer.md +21 -0
  461. package/qwen/agents/mobile_engineer.md +21 -0
  462. package/qwen/agents/observability_engineer.md +21 -0
  463. package/qwen/agents/performance_engineer.md +19 -0
  464. package/qwen/agents/platform_engineer.md +22 -0
  465. package/qwen/agents/product_manager.md +18 -0
  466. package/qwen/agents/prompt_engineer.md +20 -0
  467. package/qwen/agents/refactor.md +20 -0
  468. package/qwen/agents/release_manager.md +20 -0
  469. package/qwen/agents/security_engineer.md +19 -0
  470. package/qwen/agents/seo_specialist.md +19 -0
  471. package/qwen/agents/site_reliability_engineer.md +19 -0
  472. package/qwen/agents/solutions_architect.md +17 -0
  473. package/qwen/agents/technical_writer.md +19 -0
  474. package/qwen/agents/tester.md +21 -0
  475. package/qwen/agents/ux_designer.md +18 -0
  476. package/qwen/agents/zos_sysprog.md +19 -0
  477. package/qwen/hooks.json +56 -0
  478. package/qwen-extension.json +56 -0
  479. package/scripts/check-layer-boundaries.js +74 -0
  480. package/scripts/generate.js +155 -0
  481. package/scripts/install-codex-plugin.js +167 -0
  482. package/scripts/install-git-hooks.js +43 -0
  483. package/scripts/npm-publish-idempotent.js +338 -0
  484. package/scripts/package-release-artifacts.js +156 -0
  485. package/scripts/release-artifact-manifest.js +378 -0
  486. package/scripts/release-version-metadata.js +129 -0
  487. package/scripts/update-versions.js +33 -0
  488. package/scripts/verify-npm-pack.js +85 -0
  489. package/scripts/verify-release-artifacts.js +95 -0
  490. package/src/agents/accessibility-specialist.md +163 -0
  491. package/src/agents/analytics-engineer.md +182 -0
  492. package/src/agents/api-designer.md +124 -0
  493. package/src/agents/architect.md +120 -0
  494. package/src/agents/cloud-architect.md +134 -0
  495. package/src/agents/cobol-engineer.md +127 -0
  496. package/src/agents/code-reviewer.md +123 -0
  497. package/src/agents/coder.md +132 -0
  498. package/src/agents/compliance-reviewer.md +219 -0
  499. package/src/agents/content-strategist.md +111 -0
  500. package/src/agents/copywriter.md +113 -0
  501. package/src/agents/data-engineer.md +130 -0
  502. package/src/agents/database-administrator.md +126 -0
  503. package/src/agents/db2-dba.md +124 -0
  504. package/src/agents/debugger.md +133 -0
  505. package/src/agents/design-system-engineer.md +258 -0
  506. package/src/agents/devops-engineer.md +138 -0
  507. package/src/agents/hlasm-assembler-specialist.md +134 -0
  508. package/src/agents/i18n-specialist.md +241 -0
  509. package/src/agents/ibm-i-specialist.md +132 -0
  510. package/src/agents/integration-engineer.md +133 -0
  511. package/src/agents/ml-engineer.md +115 -0
  512. package/src/agents/mlops-engineer.md +116 -0
  513. package/src/agents/mobile-engineer.md +115 -0
  514. package/src/agents/observability-engineer.md +133 -0
  515. package/src/agents/performance-engineer.md +139 -0
  516. package/src/agents/platform-engineer.md +129 -0
  517. package/src/agents/product-manager.md +170 -0
  518. package/src/agents/prompt-engineer.md +129 -0
  519. package/src/agents/refactor.md +138 -0
  520. package/src/agents/release-manager.md +132 -0
  521. package/src/agents/security-engineer.md +143 -0
  522. package/src/agents/seo-specialist.md +129 -0
  523. package/src/agents/site-reliability-engineer.md +131 -0
  524. package/src/agents/solutions-architect.md +137 -0
  525. package/src/agents/technical-writer.md +129 -0
  526. package/src/agents/tester.md +135 -0
  527. package/src/agents/ux-designer.md +168 -0
  528. package/src/agents/zos-sysprog.md +134 -0
  529. package/src/config/setting-resolver.js +32 -0
  530. package/src/core/agent-registry.js +67 -0
  531. package/src/core/canonical-source.js +39 -0
  532. package/src/core/env-file-parser.js +82 -0
  533. package/src/core/feature-blocks.js +34 -0
  534. package/src/core/logger.js +12 -0
  535. package/src/core/markdown-state.js +36 -0
  536. package/src/core/policy-rules.js +32 -0
  537. package/src/core/project-root-resolver.js +184 -0
  538. package/src/core/stdin-reader.js +77 -0
  539. package/src/core/version.js +50 -0
  540. package/src/entry-points/core-command-registry.js +37 -0
  541. package/src/entry-points/preamble-builders.js +54 -0
  542. package/src/entry-points/registry.js +199 -0
  543. package/src/entry-points/templates/claude-core-command.md.tmpl +38 -0
  544. package/src/entry-points/templates/claude-skill.md.tmpl +18 -0
  545. package/src/entry-points/templates/codex-core-command.md.tmpl +16 -0
  546. package/src/entry-points/templates/codex-skill.md.tmpl +11 -0
  547. package/src/entry-points/templates/gemini-command.toml.tmpl +17 -0
  548. package/src/entry-points/templates/gemini-core-command.toml.tmpl +30 -0
  549. package/src/generated/agent-registry.json +630 -0
  550. package/src/generated/hook-registry.json +18 -0
  551. package/src/generated/resource-registry.json +16 -0
  552. package/src/generator/entry-point-expander.js +182 -0
  553. package/src/generator/file-writer.js +167 -0
  554. package/src/generator/generation-session.js +62 -0
  555. package/src/generator/manifest-curator.js +31 -0
  556. package/src/generator/manifest-expander.js +256 -0
  557. package/src/generator/payload-builder.js +217 -0
  558. package/src/generator/registry-scanner.js +130 -0
  559. package/src/generator/stale-pruner.js +101 -0
  560. package/src/hooks/logic/after-agent-logic.js +54 -0
  561. package/src/hooks/logic/before-agent-logic.js +57 -0
  562. package/src/hooks/logic/hook-state.js +127 -0
  563. package/src/hooks/logic/session-end-logic.js +17 -0
  564. package/src/hooks/logic/session-start-logic.js +25 -0
  565. package/src/lib/discovery/index.js +172 -0
  566. package/src/lib/errors/index.js +104 -0
  567. package/src/lib/framework-detection.js +50 -0
  568. package/src/lib/frontmatter/index.js +262 -0
  569. package/src/lib/io/index.js +96 -0
  570. package/src/lib/naming/index.js +94 -0
  571. package/src/lib/validation/index.js +124 -0
  572. package/src/lib/yaml-emit.js +38 -0
  573. package/src/manifest.js +11 -0
  574. package/src/mcp/content/provider.js +68 -0
  575. package/src/mcp/content/runtime-content.js +188 -0
  576. package/src/mcp/contracts/cache-path-rejector.js +39 -0
  577. package/src/mcp/contracts/downstream-context.js +106 -0
  578. package/src/mcp/contracts/plan-schema.js +148 -0
  579. package/src/mcp/contracts/workspace-marker.js +61 -0
  580. package/src/mcp/core/create-server.js +76 -0
  581. package/src/mcp/core/line-reader.js +35 -0
  582. package/src/mcp/core/project-root-cache.js +120 -0
  583. package/src/mcp/core/protocol-dispatcher.js +274 -0
  584. package/src/mcp/core/recovery-hints.js +43 -0
  585. package/src/mcp/core/tool-outcome.js +77 -0
  586. package/src/mcp/core/tool-registry.js +82 -0
  587. package/src/mcp/handlers/assess-task-complexity.js +108 -0
  588. package/src/mcp/handlers/blocker-parser.js +34 -0
  589. package/src/mcp/handlers/design-gate.js +393 -0
  590. package/src/mcp/handlers/get-agent.js +54 -0
  591. package/src/mcp/handlers/get-runtime-context.js +49 -0
  592. package/src/mcp/handlers/get-skill-content.js +51 -0
  593. package/src/mcp/handlers/initialize-workspace.js +45 -0
  594. package/src/mcp/handlers/reconciliation.js +224 -0
  595. package/src/mcp/handlers/resolve-settings.js +39 -0
  596. package/src/mcp/handlers/session-state-core.js +108 -0
  597. package/src/mcp/handlers/session-state-tools.js +562 -0
  598. package/src/mcp/handlers/validate-plan.js +76 -0
  599. package/src/mcp/maestro-server.js +122 -0
  600. package/src/mcp/runtime/runtime-config-map.js +70 -0
  601. package/src/mcp/tool-packs/content/index.js +80 -0
  602. package/src/mcp/tool-packs/contracts.js +30 -0
  603. package/src/mcp/tool-packs/index.js +15 -0
  604. package/src/mcp/tool-packs/session/index.js +243 -0
  605. package/src/mcp/tool-packs/workspace/index.js +98 -0
  606. package/src/mcp/utils/extension-root.js +31 -0
  607. package/src/mcp/validation/agent-checker.js +81 -0
  608. package/src/mcp/validation/dag-checker.js +214 -0
  609. package/src/mcp/validation/file-overlap-checker.js +63 -0
  610. package/src/mcp/validation/schema-checker.js +108 -0
  611. package/src/platforms/claude/metadata.js +96 -0
  612. package/src/platforms/claude/runtime-config.js +60 -0
  613. package/src/platforms/codex/metadata.js +107 -0
  614. package/src/platforms/codex/runtime-config.js +58 -0
  615. package/src/platforms/gemini/metadata.js +27 -0
  616. package/src/platforms/gemini/runtime-config.js +62 -0
  617. package/src/platforms/metadata-shared.js +133 -0
  618. package/src/platforms/metadata.js +29 -0
  619. package/src/platforms/qwen/metadata.js +27 -0
  620. package/src/platforms/qwen/runtime-config.js +62 -0
  621. package/src/platforms/shared/adapters/claude-adapter.js +36 -0
  622. package/src/platforms/shared/adapters/conventions.js +29 -0
  623. package/src/platforms/shared/adapters/exit-codes.js +6 -0
  624. package/src/platforms/shared/adapters/factory.js +40 -0
  625. package/src/platforms/shared/adapters/gemini-adapter.js +34 -0
  626. package/src/platforms/shared/adapters/qwen-adapter.js +93 -0
  627. package/src/platforms/shared/agent-names.js +15 -0
  628. package/src/platforms/shared/hook-runner.js +52 -0
  629. package/src/references/architecture.md +139 -0
  630. package/src/references/orchestration-steps.md +193 -0
  631. package/src/scripts/ensure-workspace.js +14 -0
  632. package/src/scripts/read-active-session.js +26 -0
  633. package/src/scripts/read-setting.js +18 -0
  634. package/src/scripts/read-state.js +17 -0
  635. package/src/scripts/write-state.js +22 -0
  636. package/src/skills/shared/code-review/SKILL.md +145 -0
  637. package/src/skills/shared/delegation/SKILL.md +387 -0
  638. package/src/skills/shared/delegation/protocols/agent-base-protocol.md +145 -0
  639. package/src/skills/shared/delegation/protocols/filesystem-safety-protocol.md +31 -0
  640. package/src/skills/shared/design-dialogue/SKILL.md +284 -0
  641. package/src/skills/shared/execution/SKILL.md +258 -0
  642. package/src/skills/shared/implementation-planning/SKILL.md +307 -0
  643. package/src/skills/shared/session-management/SKILL.md +314 -0
  644. package/src/skills/shared/validation/SKILL.md +204 -0
  645. package/src/state/session-state.js +113 -0
  646. package/src/templates/design-document.md +95 -0
  647. package/src/templates/implementation-plan.md +86 -0
  648. package/src/templates/session-state.md +68 -0
  649. package/src/transforms/agent-stub.js +29 -0
  650. package/src/transforms/extract-examples.js +63 -0
  651. package/src/transforms/index.js +35 -0
  652. package/src/transforms/parse-frontmatter.js +23 -0
  653. package/src/transforms/rebuild-frontmatter.js +147 -0
  654. package/src/transforms/skill-discovery-stub.js +27 -0
  655. package/src/transforms/skill-metadata.js +14 -0
@@ -0,0 +1,150 @@
1
+ # Qwen Runtime
2
+
3
+ The Qwen Code extension lives in `qwen/` (the output directory declared in `src/platforms/qwen/runtime-config.js`). The manifest (`qwen-extension.json`) and context file (`QWEN.md`) remain at the repo root so Qwen Code can discover the extension; generated artifacts (`qwen/agents/`, `qwen/hooks.json`) live in the subdirectory. It mirrors the Gemini CLI extension structure with Qwen-specific manifest, context, and tool mappings.
4
+
5
+ ## Configuration
6
+
7
+ **Manifest**: `qwen-extension.json`
8
+ **Version**: generated from `package.json`
9
+ **Context File**: `QWEN.md`
10
+
11
+ ### MCP Server
12
+
13
+ ```json
14
+ {
15
+ "command": "node",
16
+ "args": ["${extensionPath}/mcp/maestro-server.js"],
17
+ "cwd": "${extensionPath}",
18
+ "env": {
19
+ "MAESTRO_RUNTIME": "qwen",
20
+ "MAESTRO_WORKSPACE_PATH": "${workspacePath}"
21
+ }
22
+ }
23
+ ```
24
+
25
+ Qwen reuses the repo-root public server at `mcp/maestro-server.js`. The Qwen manifest launches that shared adapter with `MAESTRO_RUNTIME=qwen`; without that env var the adapter defaults to Gemini. The adapter requires canonical `src/mcp/maestro-server.js` directly and runs the Qwen runtime against shared source in `src/`. Qwen declares `primary: filesystem` and `fallback: none`.
26
+
27
+ ## Agent Naming
28
+
29
+ Qwen uses **snake_case** for agent names (matching Gemini's convention): `code_reviewer`, `api_designer`, `accessibility_specialist`.
30
+
31
+ Agent files are generated at `qwen/agents/*.md` with snake_case filenames (Qwen's own subdirectory, separate from Gemini's repo-root `agents/`).
32
+
33
+ ## Delegation
34
+
35
+ Direct function call syntax:
36
+
37
+ ```
38
+ coder(query: "Implement the user service...")
39
+ architect(query: "Design the auth system...")
40
+ ```
41
+
42
+ ## Commands
43
+
44
+ The Qwen runtime does not emit its own TOML command files. `src/generator/entry-point-expander.js` sets `qwen: null` in both `ENTRY_POINT_CONFIG` and `CORE_COMMAND_CONFIG`, so `expandEntryPoints('qwen')` and `expandCoreCommands('qwen')` return empty arrays. This is intentional: Qwen Code is Gemini-CLI-compatible and consumes the 12 TOML commands generated for Gemini at repo-root `commands/maestro/` when both extensions coexist. See `docs/runtime-gemini.md` for the full command list.
45
+
46
+ ## Hooks
47
+
48
+ 4 hook events in `qwen/hooks.json`:
49
+
50
+ | Event | Script | Purpose |
51
+ |-------|--------|---------|
52
+ | `SessionStart` | `hooks/hook-runner.js qwen session-start` | Initialize hook state, prune stale sessions |
53
+ | `SubagentStart` | `hooks/hook-runner.js qwen before-agent` | Detect agent, inject session context |
54
+ | `SubagentStop` | `hooks/hook-runner.js qwen after-agent` | Validate Task Report + Downstream Context |
55
+ | `SessionEnd` | `hooks/hook-runner.js qwen session-end` | Clean up hook state |
56
+
57
+ ### SubagentStop Validation
58
+
59
+ Qwen uses the same post-delegation validation as Gemini:
60
+
61
+ - Checks for `## Task Report` (or `# Task Report`) and `## Downstream Context` headings
62
+ - First failure: blocks and requests retry
63
+ - Second failure (`stopHookActive=true`): allows through with warning
64
+
65
+ ### Hook Adapter
66
+
67
+ Qwen reuses the shared Gemini-style adapter at `hooks/adapters/qwen-adapter.js` (or the shared Gemini adapter when the CLI JSON shape matches). Output format: `{ continue: boolean, systemMessage?: string }`.
68
+
69
+ ## Policies
70
+
71
+ `policies/maestro.toml` — TOML-based shell guardrails evaluated by Qwen's policy engine (same rules as Gemini):
72
+
73
+ **Deny (priority 950)**:
74
+ - `rm -rf`, `rm -fr`, `sudo rm -rf`, `sudo rm -fr`
75
+ - `git reset --hard`, `git checkout --`
76
+ - `git clean -fd`, `git clean -df`, `git clean -xfd`, `git clean -xdf`
77
+ - Heredocs (`<<`)
78
+
79
+ **Ask User (priority 850)**:
80
+ - `tee` commands
81
+ - Output redirection (`>`, `>>`)
82
+
83
+ ## Tool Mapping
84
+
85
+ Qwen tools use canonical names with Qwen-specific overrides declared in `src/platforms/qwen/runtime-config.js`:
86
+
87
+ | Canonical | Qwen |
88
+ |-----------|------|
89
+ | `read_file` | `read_file` |
90
+ | `read_many_files` | `read_many_files` |
91
+ | `list_directory` | `list_directory` |
92
+ | `glob` | `glob` |
93
+ | `grep_search` | `grep_search` |
94
+ | `google_web_search` | `web_search` |
95
+ | `web_fetch` | `web_fetch` |
96
+ | `write_file` | `write_file` |
97
+ | `replace` | `edit` |
98
+ | `run_shell_command` | `run_shell_command` |
99
+ | `ask_user` | `ask_user_question` |
100
+ | `write_todos` | `todo_write` |
101
+ | `activate_skill` | `skill` |
102
+ | `enter_plan_mode` | `enter_plan_mode` |
103
+ | `exit_plan_mode` | `exit_plan_mode` |
104
+ | `codebase_investigator` | `codebase_investigator` |
105
+
106
+ ## Feature Flags
107
+
108
+ The canonical feature set (same 4 flags across all runtimes, values per runtime):
109
+
110
+ ```
111
+ exampleBlocks: false
112
+ claudeStateContract: false
113
+ scriptBasedStateContract: true
114
+ codexStateContract: false
115
+ ```
116
+
117
+ See `src/platforms/qwen/runtime-config.js` for the authoritative values.
118
+
119
+ ## Agent Frontmatter
120
+
121
+ Qwen agent stubs share the Gemini shape:
122
+
123
+ ```yaml
124
+ ---
125
+ name: coder
126
+ kind: local
127
+ description: "..."
128
+ tools: [read_file, write_file, ...]
129
+ temperature: 0.2
130
+ max_turns: 25
131
+ timeout_mins: 10
132
+ ---
133
+ ```
134
+
135
+ Fields: `kind` (always "local"), `temperature`, `max_turns`, `timeout_mins`.
136
+
137
+ ## Generated Files
138
+
139
+ ```text
140
+ qwen/
141
+ ├── agents/ 39 agent stubs (snake_case, Qwen tool names)
142
+ └── hooks.json hook registration (SubagentStart, SubagentStop, …)
143
+ ```
144
+
145
+ The Qwen extension reuses Gemini's repo-root `commands/maestro/`, `hooks/`, `mcp/`, and `policies/` artifacts when both runtimes coexist; no duplicates are written under `qwen/`.
146
+
147
+ ## Notes
148
+
149
+ - Qwen writes its own agent stubs and hook config to `qwen/agents/` and `qwen/hooks.json` (separate from Gemini's repo-root outputs). For the `/maestro:*` command surface, Qwen reuses Gemini's repo-root `commands/maestro/` TOML files — the Qwen generator does not duplicate these.
150
+ - `node scripts/generate.js` derives `qwen-extension.json` from `package.json` with the other runtime manifests so release metadata stays aligned.
package/docs/usage.md ADDED
@@ -0,0 +1,315 @@
1
+ # Maestro Usage
2
+
3
+ For detailed CI/CD pipeline documentation including workflow diagrams, the release process, and npm publishing strategy, see [docs/cicd.md](cicd.md).
4
+
5
+ ## Development Commands
6
+
7
+ ```bash
8
+ # Regenerate runtime files from source
9
+ node scripts/generate.js
10
+
11
+ # Generate runtime adapters using package scripts
12
+ npm run build
13
+
14
+ # Run all tests across unit, transform, and integration suites
15
+ node --test tests/unit/*.test.js tests/transforms/*.test.js tests/integration/*.test.js
16
+
17
+ # Show unified diff of changes
18
+ node scripts/generate.js --diff
19
+
20
+ # Delete all generated files and regenerate
21
+ node scripts/generate.js --clean
22
+
23
+ # Run CI test subset (see justfile for current file list)
24
+ just test
25
+
26
+ # Run only transform unit tests
27
+ just test-transforms
28
+
29
+ # Run only integration tests
30
+ just test-integration
31
+
32
+ # Generate + verify zero drift in a clean worktree/CI checkout
33
+ just check
34
+
35
+ # Full CI equivalent in a clean worktree/CI checkout (check + check-layers + test)
36
+ just ci
37
+
38
+ # Verify lib/ import-boundary rules
39
+ just check-layers
40
+
41
+ # Delete local branches whose remotes are gone
42
+ just cleanup-branches
43
+ ```
44
+
45
+ ## Editing Workflow
46
+
47
+ 1. Edit canonical source in `src/`. Maintain hand-authored root docs (`README.md`, `EXAMPLES.md`, `USAGE.md`, `OVERVIEW.md`, `ARCHITECTURE.md`, `CONTRIBUTING.md`, `SECURITY.md`) directly. Do not edit generated runtime stubs, command files, hook adapters, detached payloads, or generated skill copies directly.
48
+ 2. Run `node scripts/generate.js` or `npm run build` to regenerate runtime adapters
49
+ 3. Run `node scripts/generate.js --diff` to confirm the generator has no additional pending output
50
+ 4. Run `node --test tests/unit/*.test.js tests/transforms/*.test.js tests/integration/*.test.js` (or `just test`) before committing
51
+ 5. Commit canonical source, directly owned root docs, and generated adapter output together
52
+ 6. CI will fail if runtime adapters drift from canonical `src/`; `just check` and `just ci` are designed for clean worktrees because they end with `git diff --exit-code`
53
+
54
+ ## Configuration
55
+
56
+ ### Settings
57
+
58
+ All settings are resolved with precedence: environment variable > workspace `.env` > extension `.env` > default.
59
+
60
+ | Setting | Default | Values | Purpose |
61
+ |---------|---------|--------|---------|
62
+ | `MAESTRO_STATE_DIR` | `docs/maestro` | path | Session state directory |
63
+ | `MAESTRO_DISABLED_AGENTS` | (none) | comma-separated names | Exclude agents from assignment |
64
+ | `MAESTRO_EXECUTION_MODE` | `ask` | parallel, sequential, ask | Execution strategy |
65
+ | `MAESTRO_VALIDATION_STRICTNESS` | `normal` | strict, normal, lenient | Validation mode |
66
+ | `MAESTRO_AUTO_ARCHIVE` | `true` | true, false | Auto-archive on completion |
67
+ | `MAESTRO_MAX_RETRIES` | `2` | integer | Max retries per phase |
68
+ | `MAESTRO_MAX_CONCURRENT` | `0` | integer | Max parallel agents (0 = unlimited) |
69
+
70
+ ### Runtime-Specific Environment Variables
71
+
72
+ | Variable | Runtime | Purpose |
73
+ |----------|---------|---------|
74
+ | `MAESTRO_EXTENSION_PATH` | Gemini | Override extension root path |
75
+ | `MAESTRO_WORKSPACE_PATH` | Gemini | Workspace root (set by Gemini CLI) |
76
+ | `MAESTRO_EXTENSION_PATH` | Qwen | Override extension root path |
77
+ | `MAESTRO_WORKSPACE_PATH` | Qwen | Workspace root (set by Qwen Code) |
78
+ | `MAESTRO_WORKSPACE_PATH` | Codex | Optional workspace root override; otherwise Codex uses MCP `roots/list` |
79
+ | `CLAUDE_PLUGIN_ROOT` | Claude | Plugin root (set by Claude Code) |
80
+ | `CLAUDE_PROJECT_DIR` | Claude | Project directory (set by Claude Code) |
81
+
82
+ ## Invoking Maestro
83
+
84
+ ### Gemini CLI
85
+
86
+ Commands are TOML-based slash commands:
87
+
88
+ | Command | Purpose |
89
+ |---------|---------|
90
+ | `/maestro:orchestrate` | Full orchestration workflow |
91
+ | `/maestro:execute` | Execute an approved plan |
92
+ | `/maestro:resume` | Resume interrupted session |
93
+ | `/maestro:review` | Code review |
94
+ | `/maestro:debug` | Debugging workflow |
95
+ | `/maestro:archive` | Archive active session |
96
+ | `/maestro:status` | Show session status |
97
+ | `/maestro:security-audit` | Security assessment |
98
+ | `/maestro:perf-check` | Performance assessment |
99
+ | `/maestro:seo-audit` | SEO audit |
100
+ | `/maestro:a11y-audit` | Accessibility audit |
101
+ | `/maestro:compliance-check` | Compliance review |
102
+
103
+ ### Claude Code
104
+
105
+ Skills are Markdown-based slash commands:
106
+
107
+ | Command | Purpose |
108
+ |---------|---------|
109
+ | `/orchestrate` | Full orchestration workflow |
110
+ | `/execute` | Execute an approved plan |
111
+ | `/resume-session` | Resume interrupted session |
112
+ | `/review-code` | Code review |
113
+ | `/debug-workflow` | Debugging workflow |
114
+ | `/archive` | Archive active session |
115
+ | `/status` | Show session status |
116
+ | `/security-audit` | Security assessment |
117
+ | `/perf-check` | Performance assessment |
118
+ | `/seo-audit` | SEO audit |
119
+ | `/a11y-audit` | Accessibility audit |
120
+ | `/compliance-check` | Compliance review |
121
+
122
+ ### Codex
123
+
124
+ Skills are invoked through the plugin namespace:
125
+
126
+ | Command | Purpose |
127
+ |---------|---------|
128
+ | `$maestro:orchestrate` | Full orchestration workflow |
129
+ | `$maestro:execute` | Execute an approved plan |
130
+ | `$maestro:resume-session` | Resume interrupted session |
131
+ | `$maestro:review-code` | Code review |
132
+ | `$maestro:debug-workflow` | Debugging workflow |
133
+ | `$maestro:archive` | Archive active session |
134
+ | `$maestro:status` | Show session status |
135
+ | `$maestro:security-audit` | Security assessment |
136
+ | `$maestro:perf-check` | Performance assessment |
137
+ | `$maestro:seo-audit` | SEO audit |
138
+ | `$maestro:a11y-audit` | Accessibility audit |
139
+ | `$maestro:compliance-check` | Compliance review |
140
+
141
+ Codex keeps its built-in `/review`, `/debug`, and `/resume` commands. Maestro exposes `$maestro:review-code`, `$maestro:debug-workflow`, and `$maestro:resume-session` to avoid colliding with those host commands.
142
+
143
+ ## State Directory Structure
144
+
145
+ After running Maestro, the state directory (default: `docs/maestro/`) contains:
146
+
147
+ ```
148
+ docs/maestro/
149
+ ├── state/
150
+ │ ├── active-session.md # Current session
151
+ │ └── archive/
152
+ │ └── <session-id>.md # Archived sessions
153
+ └── plans/
154
+ ├── <date>-<topic>-design.md # Design documents
155
+ ├── <date>-<topic>-impl-plan.md # Implementation plans
156
+ └── archive/
157
+ └── ... # Archived plans
158
+ ```
159
+
160
+ ### Session State Format
161
+
162
+ Active sessions use YAML frontmatter + Markdown body:
163
+
164
+ ```yaml
165
+ ---
166
+ session_id: "2024-03-15-auth-system"
167
+ task: "Implement user authentication"
168
+ created: "2024-03-15T10:00:00Z"
169
+ updated: "2024-03-15T11:30:00Z"
170
+ status: "in_progress"
171
+ workflow_mode: "standard"
172
+ design_document: "docs/maestro/plans/2024-03-15-auth-system-design.md"
173
+ implementation_plan: "docs/maestro/plans/2024-03-15-auth-system-impl-plan.md"
174
+ current_phase: 2
175
+ total_phases: 4
176
+ execution_mode: "sequential"
177
+ execution_backend: null
178
+ current_batch: null
179
+ task_complexity: "medium"
180
+
181
+ token_usage:
182
+ total_input: 0
183
+ total_output: 0
184
+ total_cached: 0
185
+ by_agent: {}
186
+
187
+ phases:
188
+ - id: 1
189
+ name: "Foundation"
190
+ status: "completed"
191
+ agents: ["architect"]
192
+ parallel: false
193
+ started: "2024-03-15T10:05:00Z"
194
+ completed: "2024-03-15T10:45:00Z"
195
+ blocked_by: []
196
+ files_created: ["src/services/user.ts"]
197
+ files_modified: []
198
+ files_deleted: []
199
+ downstream_context:
200
+ key_interfaces_introduced: ["UserService"]
201
+ patterns_established: ["Repository pattern"]
202
+ integration_points: ["/api/users"]
203
+ assumptions: []
204
+ warnings: []
205
+ errors: []
206
+ retry_count: 0
207
+ - id: 2
208
+ name: "Implementation"
209
+ status: "in_progress"
210
+ agents: ["coder"]
211
+ parallel: false
212
+ started: "2024-03-15T10:50:00Z"
213
+ completed: null
214
+ blocked_by: [1]
215
+ files_created: []
216
+ files_modified: []
217
+ files_deleted: []
218
+ downstream_context:
219
+ key_interfaces_introduced: []
220
+ patterns_established: []
221
+ integration_points: []
222
+ assumptions: []
223
+ warnings: []
224
+ errors: []
225
+ retry_count: 0
226
+ ---
227
+
228
+ # Auth System Orchestration Log
229
+
230
+ ## Phase 1: Foundation
231
+ ...
232
+ ```
233
+
234
+ ## Agent Catalog
235
+
236
+ ### Read-Only Agents (analysis, no code changes)
237
+
238
+ | Agent | Specialty | Turns | Temp |
239
+ |-------|-----------|-------|------|
240
+ | architect | System design, technology selection | 15 | 0.3 |
241
+ | api-designer | Endpoint design, API contracts | 15 | 0.3 |
242
+ | cloud-architect | AWS/GCP/Azure topology, IaC, multi-region design | 15 | 0.3 |
243
+ | code-reviewer | Bug detection, quality assessment | 15 | 0.2 |
244
+ | compliance-reviewer | GDPR/CCPA, license auditing | 15 | 0.3 |
245
+ | content-strategist | Content planning, editorial calendars | 15 | 0.3 |
246
+ | solutions-architect | Enterprise integration, cross-team architecture | 15 | 0.3 |
247
+
248
+ ### Read + Shell Agents (investigation, profiling)
249
+
250
+ | Agent | Specialty | Turns | Temp |
251
+ |-------|-----------|-------|------|
252
+ | accessibility-specialist | WCAG compliance, ARIA review | 20 | 0.2 |
253
+ | database-administrator | RDBMS tuning, indexes, migration safety | 20 | 0.2 |
254
+ | db2-dba | DB2 for z/OS and LUW, REORG/RUNSTATS/bind | 20 | 0.2 |
255
+ | debugger | Root cause analysis, execution tracing | 20 | 0.2 |
256
+ | performance-engineer | Profiling, optimization | 20 | 0.2 |
257
+ | security-engineer | Vulnerability assessment, threat modeling | 20 | 0.2 |
258
+ | seo-specialist | Technical SEO, structured data | 20 | 0.2 |
259
+ | site-reliability-engineer | SLOs, error budgets, runbooks, postmortems | 20 | 0.2 |
260
+ | zos-sysprog | z/OS systems programming, JCL, USS, RACF | 20 | 0.2 |
261
+
262
+ ### Read + Write Agents (documentation, design)
263
+
264
+ | Agent | Specialty | Turns | Temp |
265
+ |-------|-----------|-------|------|
266
+ | copywriter | Marketing copy, landing pages | 20 | 0.3 |
267
+ | product-manager | PRDs, user stories, prioritization | 20 | 0.2 |
268
+ | prompt-engineer | LLM prompt design, few-shot, RAG tuning | 15 | 0.3 |
269
+ | release-manager | Release notes, changelogs, rollout planning | 15 | 0.3 |
270
+ | technical-writer | Documentation, API references | 15 | 0.3 |
271
+ | ux-designer | User flows, wireframes, heuristics | 20 | 0.2 |
272
+
273
+ ### Full Access Agents (implementation)
274
+
275
+ | Agent | Specialty | Turns | Temp |
276
+ |-------|-----------|-------|------|
277
+ | analytics-engineer | Event tracking, A/B testing, funnels | 25 | 0.2 |
278
+ | cobol-engineer | Mainframe COBOL, JCL, CICS/IMS on z/OS | 25 | 0.2 |
279
+ | coder | Feature implementation, SOLID principles | 25 | 0.2 |
280
+ | data-engineer | Schema design, ETL, migrations | 20 | 0.2 |
281
+ | design-system-engineer | Design tokens, theming, component APIs | 25 | 0.2 |
282
+ | devops-engineer | CI/CD, containerization, infrastructure | 20 | 0.2 |
283
+ | hlasm-assembler-specialist | IBM HLASM for z/OS, macros, SVCs | 25 | 0.2 |
284
+ | i18n-specialist | Internationalization, RTL, locales | 20 | 0.2 |
285
+ | ibm-i-specialist | IBM i RPG/CL, DB2 for i, OS/400 | 25 | 0.2 |
286
+ | integration-engineer | B2B APIs, ETL, message brokers (Kafka, MQ) | 25 | 0.2 |
287
+ | ml-engineer | Model training, feature pipelines, evaluation | 25 | 0.2 |
288
+ | mlops-engineer | Model registry, CI/CD for models, drift detection | 25 | 0.2 |
289
+ | mobile-engineer | iOS/Android/React Native/Flutter platform work | 25 | 0.2 |
290
+ | observability-engineer | Metrics, logs, traces, OpenTelemetry, dashboards | 25 | 0.2 |
291
+ | platform-engineer | Internal developer platforms, paved paths | 25 | 0.2 |
292
+ | refactor | Code restructuring, debt reduction | 25 | 0.2 |
293
+ | tester | Unit/integration/E2E tests, TDD | 25 | 0.2 |
294
+
295
+ ## MCP Tools Quick Reference
296
+
297
+ | Tool | Pack | Purpose |
298
+ |------|------|---------|
299
+ | `initialize_workspace` | Workspace | Create state directories |
300
+ | `assess_task_complexity` | Workspace | Repo analysis signals |
301
+ | `validate_plan` | Workspace | Plan validation + dependency DAG |
302
+ | `resolve_settings` | Workspace | Setting resolution with precedence |
303
+ | `create_session` | Session | Create active session |
304
+ | `get_session_status` | Session | Read session state |
305
+ | `update_session` | Session | Update execution metadata |
306
+ | `transition_phase` | Session | Complete phase + start next |
307
+ | `archive_session` | Session | Move to archive |
308
+ | `enter_design_gate` | Session | Mark session as entering design phase (idempotent) |
309
+ | `record_design_approval` | Session | Record user approval of design document |
310
+ | `get_design_gate_status` | Session | Read design gate status for a session |
311
+ | `scan_phase_changes` | Session | Scan workspace for files changed since phase start |
312
+ | `reconcile_phase` | Session | Record file manifests for un-handed-off phase |
313
+ | `get_skill_content` | Content | Serve skills/templates/references |
314
+ | `get_agent` | Content | Serve agent methodologies |
315
+ | `get_runtime_context` | Content | Runtime config snapshot |
@@ -0,0 +1,56 @@
1
+ {
2
+ "name": "maestro",
3
+ "version": "1.6.4-nightly.20260430",
4
+ "description": "Multi-agent development orchestration platform — 39 specialists, 4-phase orchestration, native parallel subagents, persistent sessions, and standalone review/debug/security/perf/seo/a11y/compliance commands",
5
+ "contextFileName": "GEMINI.md",
6
+ "settings": [
7
+ {
8
+ "name": "Disabled Agents",
9
+ "description": "Comma-separated list of agent names to exclude from implementation planning.",
10
+ "envVar": "MAESTRO_DISABLED_AGENTS"
11
+ },
12
+ {
13
+ "name": "Max Retries",
14
+ "description": "Maximum retry attempts per phase before escalating to user.",
15
+ "envVar": "MAESTRO_MAX_RETRIES"
16
+ },
17
+ {
18
+ "name": "Auto Archive",
19
+ "description": "Automatically archive session state on successful completion (true/false).",
20
+ "envVar": "MAESTRO_AUTO_ARCHIVE"
21
+ },
22
+ {
23
+ "name": "Validation",
24
+ "description": "Post-phase validation strictness level (strict/normal/lenient).",
25
+ "envVar": "MAESTRO_VALIDATION_STRICTNESS"
26
+ },
27
+ {
28
+ "name": "State Directory",
29
+ "description": "Base directory for session state and plans (default: docs/maestro).",
30
+ "envVar": "MAESTRO_STATE_DIR"
31
+ },
32
+ {
33
+ "name": "Max Concurrent",
34
+ "description": "Maximum subagents emitted in one native parallel batch turn (0 = dispatch the entire ready batch).",
35
+ "envVar": "MAESTRO_MAX_CONCURRENT"
36
+ },
37
+ {
38
+ "name": "Execution Mode",
39
+ "description": "Phase 3 execution mode: 'parallel' (native concurrent subagents), 'sequential' (one at a time), or 'ask' (prompt each time). Default: ask.",
40
+ "envVar": "MAESTRO_EXECUTION_MODE"
41
+ }
42
+ ],
43
+ "mcpServers": {
44
+ "maestro": {
45
+ "command": "node",
46
+ "args": [
47
+ "${extensionPath}/mcp/maestro-server.js"
48
+ ],
49
+ "cwd": "${extensionPath}",
50
+ "env": {
51
+ "MAESTRO_RUNTIME": "gemini",
52
+ "MAESTRO_WORKSPACE_PATH": "${workspacePath}"
53
+ }
54
+ }
55
+ }
56
+ }
@@ -0,0 +1,2 @@
1
+ 'use strict';
2
+ module.exports = require('../../src/platforms/shared/adapters/gemini-adapter');
@@ -0,0 +1,2 @@
1
+ 'use strict';
2
+ module.exports = require('../../src/platforms/shared/adapters/qwen-adapter');
@@ -0,0 +1,3 @@
1
+ 'use strict';
2
+
3
+ require('../src/platforms/shared/hook-runner');
@@ -0,0 +1,56 @@
1
+ {
2
+ "hooks": {
3
+ "SessionStart": [
4
+ {
5
+ "hooks": [
6
+ {
7
+ "type": "command",
8
+ "command": "node ${extensionPath}/hooks/hook-runner.js gemini session-start",
9
+ "name": "maestro-session-start",
10
+ "description": "Initialize hook state and prune stale sessions",
11
+ "timeout": 10000
12
+ }
13
+ ]
14
+ }
15
+ ],
16
+ "BeforeAgent": [
17
+ {
18
+ "hooks": [
19
+ {
20
+ "type": "command",
21
+ "command": "node ${extensionPath}/hooks/hook-runner.js gemini before-agent",
22
+ "name": "maestro-before-agent",
23
+ "description": "Inject session context into agent turns",
24
+ "timeout": 10000
25
+ }
26
+ ]
27
+ }
28
+ ],
29
+ "AfterAgent": [
30
+ {
31
+ "hooks": [
32
+ {
33
+ "type": "command",
34
+ "command": "node ${extensionPath}/hooks/hook-runner.js gemini after-agent",
35
+ "name": "maestro-after-agent",
36
+ "description": "Validate handoff report format with retry on malformed output",
37
+ "timeout": 10000
38
+ }
39
+ ]
40
+ }
41
+ ],
42
+ "SessionEnd": [
43
+ {
44
+ "hooks": [
45
+ {
46
+ "type": "command",
47
+ "command": "node ${extensionPath}/hooks/hook-runner.js gemini session-end",
48
+ "name": "maestro-session-end",
49
+ "description": "Clean up hook state for ended session",
50
+ "timeout": 10000
51
+ }
52
+ ]
53
+ }
54
+ ]
55
+ }
56
+ }
@@ -0,0 +1,4 @@
1
+ 'use strict';
2
+
3
+ process.env.MAESTRO_RUNTIME = process.env.MAESTRO_RUNTIME || 'gemini';
4
+ require('../src/mcp/maestro-server').main();
package/package.json ADDED
@@ -0,0 +1,93 @@
1
+ {
2
+ "name": "@josstei/maestro",
3
+ "version": "1.6.4-nightly.20260430",
4
+ "description": "Multi-agent development orchestration platform — 39 specialists, 4-phase workflows, 4 runtime targets (Gemini CLI, Claude Code, OpenAI Codex, Qwen Code)",
5
+ "license": "Apache-2.0",
6
+ "author": {
7
+ "name": "josstei",
8
+ "email": "hello@josstei.dev",
9
+ "url": "https://github.com/josstei"
10
+ },
11
+ "homepage": "https://github.com/josstei/maestro-orchestrate",
12
+ "repository": {
13
+ "type": "git",
14
+ "url": "https://github.com/josstei/maestro-orchestrate.git"
15
+ },
16
+ "bin": {
17
+ "maestro-install-codex": "./scripts/install-codex-plugin.js",
18
+ "maestro-mcp-server": "./bin/maestro-mcp-server.js"
19
+ },
20
+ "scripts": {
21
+ "generate": "node scripts/generate.js",
22
+ "build": "npm run generate",
23
+ "test": "node --test tests/unit/*.test.js tests/transforms/*.test.js tests/integration/*.test.js",
24
+ "test:coverage": "c8 npm test",
25
+ "release:artifacts": "node scripts/package-release-artifacts.js --out-dir dist/release",
26
+ "release:verify-artifacts": "node scripts/verify-release-artifacts.js",
27
+ "pack:verify": "node scripts/verify-npm-pack.js",
28
+ "install-hooks": "node scripts/install-git-hooks.js",
29
+ "prepack": "npm run generate"
30
+ },
31
+ "c8": {
32
+ "all": true,
33
+ "reporter": [
34
+ "text",
35
+ "html",
36
+ "lcov"
37
+ ],
38
+ "include": [
39
+ "src/**/*.js",
40
+ "scripts/**/*.js",
41
+ "bin/**/*.js"
42
+ ],
43
+ "exclude": [
44
+ "**/*.test.js"
45
+ ]
46
+ },
47
+ "devDependencies": {
48
+ "c8": "^10.1.3"
49
+ },
50
+ "engines": {
51
+ "node": ">=20"
52
+ },
53
+ "keywords": [
54
+ "orchestration",
55
+ "multi-agent",
56
+ "planning",
57
+ "execution",
58
+ "gemini",
59
+ "claude",
60
+ "codex",
61
+ "mcp"
62
+ ],
63
+ "files": [
64
+ "EXAMPLES.md",
65
+ "src/",
66
+ "scripts/",
67
+ "bin/",
68
+ "agents/",
69
+ "claude/",
70
+ "plugins/",
71
+ "commands/",
72
+ "hooks/",
73
+ "mcp/",
74
+ "policies/",
75
+ "docs/architecture.md",
76
+ "docs/cicd.md",
77
+ "docs/flow.md",
78
+ "docs/maestro-cheatsheet.md",
79
+ "docs/overview.md",
80
+ "docs/runtime-claude.md",
81
+ "docs/runtime-codex.md",
82
+ "docs/runtime-gemini.md",
83
+ "docs/runtime-qwen.md",
84
+ "docs/usage.md",
85
+ ".agents/",
86
+ "GEMINI.md",
87
+ "gemini-extension.json",
88
+ "QWEN.md",
89
+ "qwen-extension.json",
90
+ "qwen/",
91
+ "CHANGELOG.md"
92
+ ]
93
+ }