@josstei/maestro 1.6.4-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (655) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/CHANGELOG.md +485 -0
  3. package/EXAMPLES.md +255 -0
  4. package/GEMINI.md +231 -0
  5. package/LICENSE +201 -0
  6. package/QWEN.md +241 -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 +10 -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 +370 -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 +303 -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 +310 -0
  263. package/docs/cicd.md +647 -0
  264. package/docs/flow.md +255 -0
  265. package/docs/maestro-cheatsheet.md +199 -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 +170 -0
  270. package/docs/runtime-qwen.md +147 -0
  271. package/docs/usage.md +312 -0
  272. package/gemini-extension.json +55 -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 +10 -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 +370 -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 +303 -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 +55 -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 +150 -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 +131 -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 +10 -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 +370 -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 +303 -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,147 @@
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": { "MAESTRO_WORKSPACE_PATH": "${workspacePath}" }
19
+ }
20
+ ```
21
+
22
+ The public server at `mcp/maestro-server.js` is a thin adapter. It sets `MAESTRO_RUNTIME=qwen`, 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`.
23
+
24
+ ## Agent Naming
25
+
26
+ Qwen uses **snake_case** for agent names (matching Gemini's convention): `code_reviewer`, `api_designer`, `accessibility_specialist`.
27
+
28
+ Agent files are generated at `qwen/agents/*.md` with snake_case filenames (Qwen's own subdirectory, separate from Gemini's repo-root `agents/`).
29
+
30
+ ## Delegation
31
+
32
+ Direct function call syntax:
33
+
34
+ ```
35
+ coder(query: "Implement the user service...")
36
+ architect(query: "Design the auth system...")
37
+ ```
38
+
39
+ ## Commands
40
+
41
+ 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.
42
+
43
+ ## Hooks
44
+
45
+ 4 hook events (same lifecycle shape as Gemini):
46
+
47
+ | Event | Script | Purpose |
48
+ |-------|--------|---------|
49
+ | `SessionStart` | `hooks/hook-runner.js qwen session-start` | Initialize hook state, prune stale sessions |
50
+ | `BeforeAgent` | `hooks/hook-runner.js qwen before-agent` | Detect agent, inject session context |
51
+ | `AfterAgent` | `hooks/hook-runner.js qwen after-agent` | Validate Task Report + Downstream Context |
52
+ | `SessionEnd` | `hooks/hook-runner.js qwen session-end` | Clean up hook state |
53
+
54
+ ### AfterAgent Validation
55
+
56
+ Qwen uses the same post-delegation validation as Gemini:
57
+
58
+ - Checks for `## Task Report` (or `# Task Report`) and `## Downstream Context` headings
59
+ - First failure: blocks and requests retry
60
+ - Second failure (`stopHookActive=true`): allows through with warning
61
+
62
+ ### Hook Adapter
63
+
64
+ 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 }`.
65
+
66
+ ## Policies
67
+
68
+ `policies/maestro.toml` — TOML-based shell guardrails evaluated by Qwen's policy engine (same rules as Gemini):
69
+
70
+ **Deny (priority 950)**:
71
+ - `rm -rf`, `rm -fr`, `sudo rm -rf`, `sudo rm -fr`
72
+ - `git reset --hard`, `git checkout --`
73
+ - `git clean -fd`, `git clean -df`, `git clean -xfd`, `git clean -xdf`
74
+ - Heredocs (`<<`)
75
+
76
+ **Ask User (priority 850)**:
77
+ - `tee` commands
78
+ - Output redirection (`>`, `>>`)
79
+
80
+ ## Tool Mapping
81
+
82
+ Qwen tools use canonical names with Qwen-specific overrides declared in `src/platforms/qwen/runtime-config.js`:
83
+
84
+ | Canonical | Qwen |
85
+ |-----------|------|
86
+ | `read_file` | `read_file` |
87
+ | `read_many_files` | `read_many_files` |
88
+ | `list_directory` | `list_directory` |
89
+ | `glob` | `glob` |
90
+ | `grep_search` | `grep_search` |
91
+ | `google_web_search` | `web_search` |
92
+ | `web_fetch` | `web_fetch` |
93
+ | `write_file` | `write_file` |
94
+ | `replace` | `edit` |
95
+ | `run_shell_command` | `run_shell_command` |
96
+ | `ask_user` | `ask_user_question` |
97
+ | `write_todos` | `todo_write` |
98
+ | `activate_skill` | `skill` |
99
+ | `enter_plan_mode` | `enter_plan_mode` |
100
+ | `exit_plan_mode` | `exit_plan_mode` |
101
+ | `codebase_investigator` | `codebase_investigator` |
102
+
103
+ ## Feature Flags
104
+
105
+ The canonical feature set (same 4 flags across all runtimes, values per runtime):
106
+
107
+ ```
108
+ exampleBlocks: false
109
+ claudeStateContract: false
110
+ scriptBasedStateContract: true
111
+ codexStateContract: false
112
+ ```
113
+
114
+ See `src/platforms/qwen/runtime-config.js` for the authoritative values.
115
+
116
+ ## Agent Frontmatter
117
+
118
+ Qwen agent stubs share the Gemini shape:
119
+
120
+ ```yaml
121
+ ---
122
+ name: coder
123
+ kind: local
124
+ description: "..."
125
+ tools: [read_file, write_file, ...]
126
+ temperature: 0.2
127
+ max_turns: 25
128
+ timeout_mins: 10
129
+ ---
130
+ ```
131
+
132
+ Fields: `kind` (always "local"), `temperature`, `max_turns`, `timeout_mins`.
133
+
134
+ ## Generated Files
135
+
136
+ ```text
137
+ qwen/
138
+ ├── agents/ 39 agent stubs (snake_case, Qwen tool names)
139
+ └── hooks.json hook registration (SubagentStart, SubagentStop, …)
140
+ ```
141
+
142
+ 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/`.
143
+
144
+ ## Notes
145
+
146
+ - 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.
147
+ - `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,312 @@
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 980 tests across 71 files
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 (CI equivalent)
33
+ just check
34
+
35
+ # Full CI equivalent (check + test)
36
+ just ci
37
+
38
+ # Verify lib/ import-boundary rules (enforced by check target)
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 root docs (`README.md`, `EXAMPLES.md`, `USAGE.md`, `OVERVIEW.md`, `ARCHITECTURE.md`) directly, and do not edit generated `claude/`, `plugins/maestro/`, or `qwen/` output.
48
+ 2. Run `node scripts/generate.js` or `npm run build` to regenerate runtime adapters
49
+ 3. Run `node --test tests/unit/*.test.js tests/transforms/*.test.js tests/integration/*.test.js` (or `just test`) before committing
50
+ 4. Commit canonical source, directly owned root docs, and generated adapter output together
51
+ 5. CI will fail if runtime adapters drift from canonical `src/`
52
+
53
+ ## Configuration
54
+
55
+ ### Settings
56
+
57
+ All settings are resolved with precedence: environment variable > workspace `.env` > extension `.env` > default.
58
+
59
+ | Setting | Default | Values | Purpose |
60
+ |---------|---------|--------|---------|
61
+ | `MAESTRO_STATE_DIR` | `docs/maestro` | path | Session state directory |
62
+ | `MAESTRO_DISABLED_AGENTS` | (none) | comma-separated names | Exclude agents from assignment |
63
+ | `MAESTRO_EXECUTION_MODE` | `ask` | parallel, sequential, ask | Execution strategy |
64
+ | `MAESTRO_VALIDATION_STRICTNESS` | `normal` | strict, normal, lenient | Validation mode |
65
+ | `MAESTRO_AUTO_ARCHIVE` | `true` | true, false | Auto-archive on completion |
66
+ | `MAESTRO_MAX_RETRIES` | `2` | integer | Max retries per phase |
67
+ | `MAESTRO_MAX_CONCURRENT` | `0` | integer | Max parallel agents (0 = unlimited) |
68
+
69
+ ### Runtime-Specific Environment Variables
70
+
71
+ | Variable | Runtime | Purpose |
72
+ |----------|---------|---------|
73
+ | `MAESTRO_EXTENSION_PATH` | Gemini | Override extension root path |
74
+ | `MAESTRO_WORKSPACE_PATH` | Gemini | Workspace root (set by Gemini CLI) |
75
+ | `MAESTRO_WORKSPACE_PATH` | Codex | Optional workspace root override; otherwise Codex uses MCP `roots/list` |
76
+ | `CLAUDE_PLUGIN_ROOT` | Claude | Plugin root (set by Claude Code) |
77
+ | `CLAUDE_PROJECT_DIR` | Claude | Project directory (set by Claude Code) |
78
+
79
+ ## Invoking Maestro
80
+
81
+ ### Gemini CLI
82
+
83
+ Commands are TOML-based slash commands:
84
+
85
+ | Command | Purpose |
86
+ |---------|---------|
87
+ | `/maestro:orchestrate` | Full orchestration workflow |
88
+ | `/maestro:execute` | Execute an approved plan |
89
+ | `/maestro:resume` | Resume interrupted session |
90
+ | `/maestro:review` | Code review |
91
+ | `/maestro:debug` | Debugging workflow |
92
+ | `/maestro:archive` | Archive active session |
93
+ | `/maestro:status` | Show session status |
94
+ | `/maestro:security-audit` | Security assessment |
95
+ | `/maestro:perf-check` | Performance assessment |
96
+ | `/maestro:seo-audit` | SEO audit |
97
+ | `/maestro:a11y-audit` | Accessibility audit |
98
+ | `/maestro:compliance-check` | Compliance review |
99
+
100
+ ### Claude Code
101
+
102
+ Skills are Markdown-based slash commands:
103
+
104
+ | Command | Purpose |
105
+ |---------|---------|
106
+ | `/orchestrate` | Full orchestration workflow |
107
+ | `/execute` | Execute an approved plan |
108
+ | `/resume-session` | Resume interrupted session |
109
+ | `/review-code` | Code review |
110
+ | `/debug-workflow` | Debugging workflow |
111
+ | `/archive` | Archive active session |
112
+ | `/status` | Show session status |
113
+ | `/security-audit` | Security assessment |
114
+ | `/perf-check` | Performance assessment |
115
+ | `/seo-audit` | SEO audit |
116
+ | `/a11y-audit` | Accessibility audit |
117
+ | `/compliance-check` | Compliance review |
118
+
119
+ ### Codex
120
+
121
+ Skills are invoked through the plugin namespace:
122
+
123
+ | Command | Purpose |
124
+ |---------|---------|
125
+ | `$maestro:orchestrate` | Full orchestration workflow |
126
+ | `$maestro:execute` | Execute an approved plan |
127
+ | `$maestro:resume-session` | Resume interrupted session |
128
+ | `$maestro:review-code` | Code review |
129
+ | `$maestro:debug-workflow` | Debugging workflow |
130
+ | `$maestro:archive` | Archive active session |
131
+ | `$maestro:status` | Show session status |
132
+ | `$maestro:security-audit` | Security assessment |
133
+ | `$maestro:perf-check` | Performance assessment |
134
+ | `$maestro:seo-audit` | SEO audit |
135
+ | `$maestro:a11y-audit` | Accessibility audit |
136
+ | `$maestro:compliance-check` | Compliance review |
137
+
138
+ 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.
139
+
140
+ ## State Directory Structure
141
+
142
+ After running Maestro, the state directory (default: `docs/maestro/`) contains:
143
+
144
+ ```
145
+ docs/maestro/
146
+ ├── state/
147
+ │ ├── active-session.md # Current session
148
+ │ └── archive/
149
+ │ └── <session-id>.md # Archived sessions
150
+ └── plans/
151
+ ├── <date>-<topic>-design.md # Design documents
152
+ ├── <date>-<topic>-impl-plan.md # Implementation plans
153
+ └── archive/
154
+ └── ... # Archived plans
155
+ ```
156
+
157
+ ### Session State Format
158
+
159
+ Active sessions use YAML frontmatter + Markdown body:
160
+
161
+ ```yaml
162
+ ---
163
+ session_id: "2024-03-15-auth-system"
164
+ task: "Implement user authentication"
165
+ created: "2024-03-15T10:00:00Z"
166
+ updated: "2024-03-15T11:30:00Z"
167
+ status: "in_progress"
168
+ workflow_mode: "standard"
169
+ design_document: "docs/maestro/plans/2024-03-15-auth-system-design.md"
170
+ implementation_plan: "docs/maestro/plans/2024-03-15-auth-system-impl-plan.md"
171
+ current_phase: 2
172
+ total_phases: 4
173
+ execution_mode: "sequential"
174
+ execution_backend: null
175
+ current_batch: null
176
+ task_complexity: "medium"
177
+
178
+ token_usage:
179
+ total_input: 0
180
+ total_output: 0
181
+ total_cached: 0
182
+ by_agent: {}
183
+
184
+ phases:
185
+ - id: 1
186
+ name: "Foundation"
187
+ status: "completed"
188
+ agents: ["architect"]
189
+ parallel: false
190
+ started: "2024-03-15T10:05:00Z"
191
+ completed: "2024-03-15T10:45:00Z"
192
+ blocked_by: []
193
+ files_created: ["src/services/user.ts"]
194
+ files_modified: []
195
+ files_deleted: []
196
+ downstream_context:
197
+ key_interfaces_introduced: ["UserService"]
198
+ patterns_established: ["Repository pattern"]
199
+ integration_points: ["/api/users"]
200
+ assumptions: []
201
+ warnings: []
202
+ errors: []
203
+ retry_count: 0
204
+ - id: 2
205
+ name: "Implementation"
206
+ status: "in_progress"
207
+ agents: ["coder"]
208
+ parallel: false
209
+ started: "2024-03-15T10:50:00Z"
210
+ completed: null
211
+ blocked_by: [1]
212
+ files_created: []
213
+ files_modified: []
214
+ files_deleted: []
215
+ downstream_context:
216
+ key_interfaces_introduced: []
217
+ patterns_established: []
218
+ integration_points: []
219
+ assumptions: []
220
+ warnings: []
221
+ errors: []
222
+ retry_count: 0
223
+ ---
224
+
225
+ # Auth System Orchestration Log
226
+
227
+ ## Phase 1: Foundation
228
+ ...
229
+ ```
230
+
231
+ ## Agent Catalog
232
+
233
+ ### Read-Only Agents (analysis, no code changes)
234
+
235
+ | Agent | Specialty | Turns | Temp |
236
+ |-------|-----------|-------|------|
237
+ | architect | System design, technology selection | 15 | 0.3 |
238
+ | api-designer | Endpoint design, API contracts | 15 | 0.3 |
239
+ | cloud-architect | AWS/GCP/Azure topology, IaC, multi-region design | 15 | 0.3 |
240
+ | code-reviewer | Bug detection, quality assessment | 15 | 0.2 |
241
+ | compliance-reviewer | GDPR/CCPA, license auditing | 15 | 0.3 |
242
+ | content-strategist | Content planning, editorial calendars | 15 | 0.3 |
243
+ | solutions-architect | Enterprise integration, cross-team architecture | 15 | 0.3 |
244
+
245
+ ### Read + Shell Agents (investigation, profiling)
246
+
247
+ | Agent | Specialty | Turns | Temp |
248
+ |-------|-----------|-------|------|
249
+ | accessibility-specialist | WCAG compliance, ARIA review | 20 | 0.2 |
250
+ | database-administrator | RDBMS tuning, indexes, migration safety | 20 | 0.2 |
251
+ | db2-dba | DB2 for z/OS and LUW, REORG/RUNSTATS/bind | 20 | 0.2 |
252
+ | debugger | Root cause analysis, execution tracing | 20 | 0.2 |
253
+ | performance-engineer | Profiling, optimization | 20 | 0.2 |
254
+ | security-engineer | Vulnerability assessment, threat modeling | 20 | 0.2 |
255
+ | seo-specialist | Technical SEO, structured data | 20 | 0.2 |
256
+ | site-reliability-engineer | SLOs, error budgets, runbooks, postmortems | 20 | 0.2 |
257
+ | zos-sysprog | z/OS systems programming, JCL, USS, RACF | 20 | 0.2 |
258
+
259
+ ### Read + Write Agents (documentation, design)
260
+
261
+ | Agent | Specialty | Turns | Temp |
262
+ |-------|-----------|-------|------|
263
+ | copywriter | Marketing copy, landing pages | 20 | 0.3 |
264
+ | product-manager | PRDs, user stories, prioritization | 20 | 0.2 |
265
+ | prompt-engineer | LLM prompt design, few-shot, RAG tuning | 15 | 0.3 |
266
+ | release-manager | Release notes, changelogs, rollout planning | 15 | 0.3 |
267
+ | technical-writer | Documentation, API references | 15 | 0.3 |
268
+ | ux-designer | User flows, wireframes, heuristics | 20 | 0.2 |
269
+
270
+ ### Full Access Agents (implementation)
271
+
272
+ | Agent | Specialty | Turns | Temp |
273
+ |-------|-----------|-------|------|
274
+ | analytics-engineer | Event tracking, A/B testing, funnels | 25 | 0.2 |
275
+ | cobol-engineer | Mainframe COBOL, JCL, CICS/IMS on z/OS | 25 | 0.2 |
276
+ | coder | Feature implementation, SOLID principles | 25 | 0.2 |
277
+ | data-engineer | Schema design, ETL, migrations | 20 | 0.2 |
278
+ | design-system-engineer | Design tokens, theming, component APIs | 25 | 0.2 |
279
+ | devops-engineer | CI/CD, containerization, infrastructure | 20 | 0.2 |
280
+ | hlasm-assembler-specialist | IBM HLASM for z/OS, macros, SVCs | 25 | 0.2 |
281
+ | i18n-specialist | Internationalization, RTL, locales | 20 | 0.2 |
282
+ | ibm-i-specialist | IBM i RPG/CL, DB2 for i, OS/400 | 25 | 0.2 |
283
+ | integration-engineer | B2B APIs, ETL, message brokers (Kafka, MQ) | 25 | 0.2 |
284
+ | ml-engineer | Model training, feature pipelines, evaluation | 25 | 0.2 |
285
+ | mlops-engineer | Model registry, CI/CD for models, drift detection | 25 | 0.2 |
286
+ | mobile-engineer | iOS/Android/React Native/Flutter platform work | 25 | 0.2 |
287
+ | observability-engineer | Metrics, logs, traces, OpenTelemetry, dashboards | 25 | 0.2 |
288
+ | platform-engineer | Internal developer platforms, paved paths | 25 | 0.2 |
289
+ | refactor | Code restructuring, debt reduction | 25 | 0.2 |
290
+ | tester | Unit/integration/E2E tests, TDD | 25 | 0.2 |
291
+
292
+ ## MCP Tools Quick Reference
293
+
294
+ | Tool | Pack | Purpose |
295
+ |------|------|---------|
296
+ | `initialize_workspace` | Workspace | Create state directories |
297
+ | `assess_task_complexity` | Workspace | Repo analysis signals |
298
+ | `validate_plan` | Workspace | Plan validation + dependency DAG |
299
+ | `resolve_settings` | Workspace | Setting resolution with precedence |
300
+ | `create_session` | Session | Create active session |
301
+ | `get_session_status` | Session | Read session state |
302
+ | `update_session` | Session | Update execution metadata |
303
+ | `transition_phase` | Session | Complete phase + start next |
304
+ | `archive_session` | Session | Move to archive |
305
+ | `enter_design_gate` | Session | Mark session as entering design phase (idempotent) |
306
+ | `record_design_approval` | Session | Record user approval of design document |
307
+ | `get_design_gate_status` | Session | Read design gate status for a session |
308
+ | `scan_phase_changes` | Session | Scan workspace for files changed since phase start |
309
+ | `reconcile_phase` | Session | Record file manifests for un-handed-off phase |
310
+ | `get_skill_content` | Content | Serve skills/templates/references |
311
+ | `get_agent` | Content | Serve agent methodologies |
312
+ | `get_runtime_context` | Content | Runtime config snapshot |
@@ -0,0 +1,55 @@
1
+ {
2
+ "name": "maestro",
3
+ "version": "1.6.4-rc.1",
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_WORKSPACE_PATH": "${workspacePath}"
52
+ }
53
+ }
54
+ }
55
+ }
@@ -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-rc.1",
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
+ }
@@ -0,0 +1,3 @@
1
+ {
2
+ "apps": {}
3
+ }