@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.
- package/.agents/plugins/marketplace.json +20 -0
- package/CHANGELOG.md +485 -0
- package/EXAMPLES.md +255 -0
- package/GEMINI.md +231 -0
- package/LICENSE +201 -0
- package/QWEN.md +241 -0
- package/README.md +220 -0
- package/agents/accessibility_specialist.md +20 -0
- package/agents/analytics_engineer.md +22 -0
- package/agents/api_designer.md +19 -0
- package/agents/architect.md +19 -0
- package/agents/cloud_architect.md +19 -0
- package/agents/cobol_engineer.md +22 -0
- package/agents/code_reviewer.md +17 -0
- package/agents/coder.md +22 -0
- package/agents/compliance_reviewer.md +19 -0
- package/agents/content_strategist.md +19 -0
- package/agents/copywriter.md +19 -0
- package/agents/data_engineer.md +22 -0
- package/agents/database_administrator.md +21 -0
- package/agents/db2_dba.md +21 -0
- package/agents/debugger.md +19 -0
- package/agents/design_system_engineer.md +22 -0
- package/agents/devops_engineer.md +23 -0
- package/agents/hlasm_assembler_specialist.md +22 -0
- package/agents/i18n_specialist.md +21 -0
- package/agents/ibm_i_specialist.md +22 -0
- package/agents/integration_engineer.md +23 -0
- package/agents/ml_engineer.md +23 -0
- package/agents/mlops_engineer.md +23 -0
- package/agents/mobile_engineer.md +23 -0
- package/agents/observability_engineer.md +23 -0
- package/agents/performance_engineer.md +21 -0
- package/agents/platform_engineer.md +24 -0
- package/agents/product_manager.md +20 -0
- package/agents/prompt_engineer.md +22 -0
- package/agents/refactor.md +22 -0
- package/agents/release_manager.md +22 -0
- package/agents/security_engineer.md +21 -0
- package/agents/seo_specialist.md +21 -0
- package/agents/site_reliability_engineer.md +21 -0
- package/agents/solutions_architect.md +19 -0
- package/agents/technical_writer.md +21 -0
- package/agents/tester.md +23 -0
- package/agents/ux_designer.md +20 -0
- package/agents/zos_sysprog.md +21 -0
- package/bin/maestro-mcp-server.js +10 -0
- package/claude/.claude-plugin/plugin.json +21 -0
- package/claude/.mcp.json +11 -0
- package/claude/README.md +191 -0
- package/claude/agents/accessibility-specialist.md +36 -0
- package/claude/agents/analytics-engineer.md +38 -0
- package/claude/agents/api-designer.md +33 -0
- package/claude/agents/architect.md +33 -0
- package/claude/agents/cloud-architect.md +33 -0
- package/claude/agents/cobol-engineer.md +38 -0
- package/claude/agents/code-reviewer.md +31 -0
- package/claude/agents/coder.md +38 -0
- package/claude/agents/compliance-reviewer.md +33 -0
- package/claude/agents/content-strategist.md +33 -0
- package/claude/agents/copywriter.md +33 -0
- package/claude/agents/data-engineer.md +37 -0
- package/claude/agents/database-administrator.md +37 -0
- package/claude/agents/db2-dba.md +37 -0
- package/claude/agents/debugger.md +32 -0
- package/claude/agents/design-system-engineer.md +38 -0
- package/claude/agents/devops-engineer.md +39 -0
- package/claude/agents/hlasm-assembler-specialist.md +38 -0
- package/claude/agents/i18n-specialist.md +37 -0
- package/claude/agents/ibm-i-specialist.md +38 -0
- package/claude/agents/integration-engineer.md +39 -0
- package/claude/agents/ml-engineer.md +39 -0
- package/claude/agents/mlops-engineer.md +39 -0
- package/claude/agents/mobile-engineer.md +39 -0
- package/claude/agents/observability-engineer.md +39 -0
- package/claude/agents/performance-engineer.md +34 -0
- package/claude/agents/platform-engineer.md +40 -0
- package/claude/agents/product-manager.md +34 -0
- package/claude/agents/prompt-engineer.md +38 -0
- package/claude/agents/refactor.md +38 -0
- package/claude/agents/release-manager.md +38 -0
- package/claude/agents/security-engineer.md +37 -0
- package/claude/agents/seo-specialist.md +37 -0
- package/claude/agents/site-reliability-engineer.md +37 -0
- package/claude/agents/solutions-architect.md +33 -0
- package/claude/agents/technical-writer.md +37 -0
- package/claude/agents/tester.md +39 -0
- package/claude/agents/ux-designer.md +34 -0
- package/claude/agents/zos-sysprog.md +37 -0
- package/claude/hooks/claude-hooks.json +48 -0
- package/claude/mcp/maestro-server.js +9 -0
- package/claude/mcp-config.example.json +9 -0
- package/claude/scripts/adapters/claude-adapter.js +7 -0
- package/claude/scripts/hook-runner.js +8 -0
- package/claude/scripts/policy-enforcer.js +294 -0
- package/claude/skills/a11y-audit/SKILL.md +26 -0
- package/claude/skills/archive/SKILL.md +24 -0
- package/claude/skills/code-review/SKILL.md +7 -0
- package/claude/skills/compliance-check/SKILL.md +26 -0
- package/claude/skills/debug-workflow/SKILL.md +27 -0
- package/claude/skills/delegation/SKILL.md +7 -0
- package/claude/skills/design-dialogue/SKILL.md +7 -0
- package/claude/skills/execute/SKILL.md +38 -0
- package/claude/skills/execution/SKILL.md +7 -0
- package/claude/skills/implementation-planning/SKILL.md +7 -0
- package/claude/skills/orchestrate/SKILL.md +38 -0
- package/claude/skills/perf-check/SKILL.md +26 -0
- package/claude/skills/resume-session/SKILL.md +38 -0
- package/claude/skills/review-code/SKILL.md +27 -0
- package/claude/skills/security-audit/SKILL.md +28 -0
- package/claude/skills/seo-audit/SKILL.md +26 -0
- package/claude/skills/session-management/SKILL.md +7 -0
- package/claude/skills/status/SKILL.md +22 -0
- package/claude/skills/validation/SKILL.md +7 -0
- package/claude/src/agents/accessibility-specialist.md +163 -0
- package/claude/src/agents/analytics-engineer.md +182 -0
- package/claude/src/agents/api-designer.md +124 -0
- package/claude/src/agents/architect.md +120 -0
- package/claude/src/agents/cloud-architect.md +134 -0
- package/claude/src/agents/cobol-engineer.md +127 -0
- package/claude/src/agents/code-reviewer.md +123 -0
- package/claude/src/agents/coder.md +132 -0
- package/claude/src/agents/compliance-reviewer.md +219 -0
- package/claude/src/agents/content-strategist.md +111 -0
- package/claude/src/agents/copywriter.md +113 -0
- package/claude/src/agents/data-engineer.md +130 -0
- package/claude/src/agents/database-administrator.md +126 -0
- package/claude/src/agents/db2-dba.md +124 -0
- package/claude/src/agents/debugger.md +133 -0
- package/claude/src/agents/design-system-engineer.md +258 -0
- package/claude/src/agents/devops-engineer.md +138 -0
- package/claude/src/agents/hlasm-assembler-specialist.md +134 -0
- package/claude/src/agents/i18n-specialist.md +241 -0
- package/claude/src/agents/ibm-i-specialist.md +132 -0
- package/claude/src/agents/integration-engineer.md +133 -0
- package/claude/src/agents/ml-engineer.md +115 -0
- package/claude/src/agents/mlops-engineer.md +116 -0
- package/claude/src/agents/mobile-engineer.md +115 -0
- package/claude/src/agents/observability-engineer.md +133 -0
- package/claude/src/agents/performance-engineer.md +139 -0
- package/claude/src/agents/platform-engineer.md +129 -0
- package/claude/src/agents/product-manager.md +170 -0
- package/claude/src/agents/prompt-engineer.md +129 -0
- package/claude/src/agents/refactor.md +138 -0
- package/claude/src/agents/release-manager.md +132 -0
- package/claude/src/agents/security-engineer.md +143 -0
- package/claude/src/agents/seo-specialist.md +129 -0
- package/claude/src/agents/site-reliability-engineer.md +131 -0
- package/claude/src/agents/solutions-architect.md +137 -0
- package/claude/src/agents/technical-writer.md +129 -0
- package/claude/src/agents/tester.md +135 -0
- package/claude/src/agents/ux-designer.md +168 -0
- package/claude/src/agents/zos-sysprog.md +134 -0
- package/claude/src/config/setting-resolver.js +32 -0
- package/claude/src/core/agent-registry.js +67 -0
- package/claude/src/core/canonical-source.js +39 -0
- package/claude/src/core/env-file-parser.js +82 -0
- package/claude/src/core/feature-blocks.js +34 -0
- package/claude/src/core/logger.js +12 -0
- package/claude/src/core/markdown-state.js +36 -0
- package/claude/src/core/policy-rules.js +32 -0
- package/claude/src/core/project-root-resolver.js +184 -0
- package/claude/src/core/stdin-reader.js +77 -0
- package/claude/src/core/version.js +50 -0
- package/claude/src/entry-points/core-command-registry.js +37 -0
- package/claude/src/entry-points/preamble-builders.js +54 -0
- package/claude/src/entry-points/registry.js +199 -0
- package/claude/src/entry-points/templates/claude-core-command.md.tmpl +38 -0
- package/claude/src/entry-points/templates/claude-skill.md.tmpl +18 -0
- package/claude/src/entry-points/templates/codex-core-command.md.tmpl +16 -0
- package/claude/src/entry-points/templates/codex-skill.md.tmpl +11 -0
- package/claude/src/entry-points/templates/gemini-command.toml.tmpl +17 -0
- package/claude/src/entry-points/templates/gemini-core-command.toml.tmpl +30 -0
- package/claude/src/generated/agent-registry.json +630 -0
- package/claude/src/generated/hook-registry.json +18 -0
- package/claude/src/generated/resource-registry.json +16 -0
- package/claude/src/hooks/logic/after-agent-logic.js +54 -0
- package/claude/src/hooks/logic/before-agent-logic.js +57 -0
- package/claude/src/hooks/logic/hook-state.js +127 -0
- package/claude/src/hooks/logic/session-end-logic.js +17 -0
- package/claude/src/hooks/logic/session-start-logic.js +25 -0
- package/claude/src/lib/discovery/index.js +172 -0
- package/claude/src/lib/errors/index.js +104 -0
- package/claude/src/lib/framework-detection.js +50 -0
- package/claude/src/lib/frontmatter/index.js +262 -0
- package/claude/src/lib/io/index.js +96 -0
- package/claude/src/lib/naming/index.js +94 -0
- package/claude/src/lib/validation/index.js +124 -0
- package/claude/src/lib/yaml-emit.js +38 -0
- package/claude/src/mcp/content/provider.js +68 -0
- package/claude/src/mcp/content/runtime-content.js +188 -0
- package/claude/src/mcp/contracts/cache-path-rejector.js +39 -0
- package/claude/src/mcp/contracts/downstream-context.js +106 -0
- package/claude/src/mcp/contracts/plan-schema.js +148 -0
- package/claude/src/mcp/contracts/workspace-marker.js +61 -0
- package/claude/src/mcp/core/create-server.js +76 -0
- package/claude/src/mcp/core/line-reader.js +35 -0
- package/claude/src/mcp/core/project-root-cache.js +120 -0
- package/claude/src/mcp/core/protocol-dispatcher.js +274 -0
- package/claude/src/mcp/core/recovery-hints.js +43 -0
- package/claude/src/mcp/core/tool-outcome.js +77 -0
- package/claude/src/mcp/core/tool-registry.js +82 -0
- package/claude/src/mcp/handlers/assess-task-complexity.js +108 -0
- package/claude/src/mcp/handlers/blocker-parser.js +34 -0
- package/claude/src/mcp/handlers/design-gate.js +393 -0
- package/claude/src/mcp/handlers/get-agent.js +54 -0
- package/claude/src/mcp/handlers/get-runtime-context.js +49 -0
- package/claude/src/mcp/handlers/get-skill-content.js +51 -0
- package/claude/src/mcp/handlers/initialize-workspace.js +45 -0
- package/claude/src/mcp/handlers/reconciliation.js +224 -0
- package/claude/src/mcp/handlers/resolve-settings.js +39 -0
- package/claude/src/mcp/handlers/session-state-core.js +108 -0
- package/claude/src/mcp/handlers/session-state-tools.js +562 -0
- package/claude/src/mcp/handlers/validate-plan.js +76 -0
- package/claude/src/mcp/maestro-server.js +122 -0
- package/claude/src/mcp/runtime/runtime-config-map.js +70 -0
- package/claude/src/mcp/tool-packs/content/index.js +80 -0
- package/claude/src/mcp/tool-packs/contracts.js +30 -0
- package/claude/src/mcp/tool-packs/index.js +15 -0
- package/claude/src/mcp/tool-packs/session/index.js +243 -0
- package/claude/src/mcp/tool-packs/workspace/index.js +98 -0
- package/claude/src/mcp/utils/extension-root.js +31 -0
- package/claude/src/mcp/validation/agent-checker.js +81 -0
- package/claude/src/mcp/validation/dag-checker.js +214 -0
- package/claude/src/mcp/validation/file-overlap-checker.js +63 -0
- package/claude/src/mcp/validation/schema-checker.js +108 -0
- package/claude/src/platforms/claude/runtime-config.js +60 -0
- package/claude/src/platforms/shared/adapters/claude-adapter.js +36 -0
- package/claude/src/platforms/shared/adapters/conventions.js +29 -0
- package/claude/src/platforms/shared/adapters/exit-codes.js +6 -0
- package/claude/src/platforms/shared/adapters/factory.js +40 -0
- package/claude/src/platforms/shared/agent-names.js +10 -0
- package/claude/src/platforms/shared/hook-runner.js +52 -0
- package/claude/src/references/architecture.md +139 -0
- package/claude/src/references/orchestration-steps.md +193 -0
- package/claude/src/skills/shared/code-review/SKILL.md +145 -0
- package/claude/src/skills/shared/delegation/SKILL.md +370 -0
- package/claude/src/skills/shared/delegation/protocols/agent-base-protocol.md +145 -0
- package/claude/src/skills/shared/delegation/protocols/filesystem-safety-protocol.md +31 -0
- package/claude/src/skills/shared/design-dialogue/SKILL.md +284 -0
- package/claude/src/skills/shared/execution/SKILL.md +258 -0
- package/claude/src/skills/shared/implementation-planning/SKILL.md +303 -0
- package/claude/src/skills/shared/session-management/SKILL.md +314 -0
- package/claude/src/skills/shared/validation/SKILL.md +204 -0
- package/claude/src/state/session-state.js +113 -0
- package/claude/src/templates/design-document.md +95 -0
- package/claude/src/templates/implementation-plan.md +86 -0
- package/claude/src/templates/session-state.md +68 -0
- package/claude/src/version.json +3 -0
- package/commands/maestro/a11y-audit.toml +22 -0
- package/commands/maestro/archive.toml +23 -0
- package/commands/maestro/compliance-check.toml +22 -0
- package/commands/maestro/debug.toml +23 -0
- package/commands/maestro/execute.toml +30 -0
- package/commands/maestro/orchestrate.toml +30 -0
- package/commands/maestro/perf-check.toml +22 -0
- package/commands/maestro/resume.toml +38 -0
- package/commands/maestro/review.toml +23 -0
- package/commands/maestro/security-audit.toml +24 -0
- package/commands/maestro/seo-audit.toml +22 -0
- package/commands/maestro/status.toml +21 -0
- package/docs/architecture.md +310 -0
- package/docs/cicd.md +647 -0
- package/docs/flow.md +255 -0
- package/docs/maestro-cheatsheet.md +199 -0
- package/docs/overview.md +141 -0
- package/docs/runtime-claude.md +190 -0
- package/docs/runtime-codex.md +197 -0
- package/docs/runtime-gemini.md +170 -0
- package/docs/runtime-qwen.md +147 -0
- package/docs/usage.md +312 -0
- package/gemini-extension.json +55 -0
- package/hooks/adapters/gemini-adapter.js +2 -0
- package/hooks/adapters/qwen-adapter.js +2 -0
- package/hooks/hook-runner.js +3 -0
- package/hooks/hooks.json +56 -0
- package/mcp/maestro-server.js +4 -0
- package/package.json +93 -0
- package/plugins/maestro/.app.json +3 -0
- package/plugins/maestro/.codex-plugin/plugin.json +41 -0
- package/plugins/maestro/.mcp.json +16 -0
- package/plugins/maestro/README.md +57 -0
- package/plugins/maestro/references/runtime-guide.md +125 -0
- package/plugins/maestro/skills/a11y-audit/SKILL.md +16 -0
- package/plugins/maestro/skills/archive/SKILL.md +16 -0
- package/plugins/maestro/skills/code-review/SKILL.md +6 -0
- package/plugins/maestro/skills/compliance-check/SKILL.md +16 -0
- package/plugins/maestro/skills/debug-workflow/SKILL.md +16 -0
- package/plugins/maestro/skills/delegation/SKILL.md +6 -0
- package/plugins/maestro/skills/design-dialogue/SKILL.md +6 -0
- package/plugins/maestro/skills/execute/SKILL.md +16 -0
- package/plugins/maestro/skills/execution/SKILL.md +6 -0
- package/plugins/maestro/skills/implementation-planning/SKILL.md +6 -0
- package/plugins/maestro/skills/orchestrate/SKILL.md +16 -0
- package/plugins/maestro/skills/perf-check/SKILL.md +16 -0
- package/plugins/maestro/skills/resume-session/SKILL.md +16 -0
- package/plugins/maestro/skills/review-code/SKILL.md +16 -0
- package/plugins/maestro/skills/security-audit/SKILL.md +16 -0
- package/plugins/maestro/skills/seo-audit/SKILL.md +16 -0
- package/plugins/maestro/skills/session-management/SKILL.md +6 -0
- package/plugins/maestro/skills/status/SKILL.md +14 -0
- package/plugins/maestro/skills/validation/SKILL.md +6 -0
- package/plugins/maestro/src/agents/accessibility-specialist.md +163 -0
- package/plugins/maestro/src/agents/analytics-engineer.md +182 -0
- package/plugins/maestro/src/agents/api-designer.md +124 -0
- package/plugins/maestro/src/agents/architect.md +120 -0
- package/plugins/maestro/src/agents/cloud-architect.md +134 -0
- package/plugins/maestro/src/agents/cobol-engineer.md +127 -0
- package/plugins/maestro/src/agents/code-reviewer.md +123 -0
- package/plugins/maestro/src/agents/coder.md +132 -0
- package/plugins/maestro/src/agents/compliance-reviewer.md +219 -0
- package/plugins/maestro/src/agents/content-strategist.md +111 -0
- package/plugins/maestro/src/agents/copywriter.md +113 -0
- package/plugins/maestro/src/agents/data-engineer.md +130 -0
- package/plugins/maestro/src/agents/database-administrator.md +126 -0
- package/plugins/maestro/src/agents/db2-dba.md +124 -0
- package/plugins/maestro/src/agents/debugger.md +133 -0
- package/plugins/maestro/src/agents/design-system-engineer.md +258 -0
- package/plugins/maestro/src/agents/devops-engineer.md +138 -0
- package/plugins/maestro/src/agents/hlasm-assembler-specialist.md +134 -0
- package/plugins/maestro/src/agents/i18n-specialist.md +241 -0
- package/plugins/maestro/src/agents/ibm-i-specialist.md +132 -0
- package/plugins/maestro/src/agents/integration-engineer.md +133 -0
- package/plugins/maestro/src/agents/ml-engineer.md +115 -0
- package/plugins/maestro/src/agents/mlops-engineer.md +116 -0
- package/plugins/maestro/src/agents/mobile-engineer.md +115 -0
- package/plugins/maestro/src/agents/observability-engineer.md +133 -0
- package/plugins/maestro/src/agents/performance-engineer.md +139 -0
- package/plugins/maestro/src/agents/platform-engineer.md +129 -0
- package/plugins/maestro/src/agents/product-manager.md +170 -0
- package/plugins/maestro/src/agents/prompt-engineer.md +129 -0
- package/plugins/maestro/src/agents/refactor.md +138 -0
- package/plugins/maestro/src/agents/release-manager.md +132 -0
- package/plugins/maestro/src/agents/security-engineer.md +143 -0
- package/plugins/maestro/src/agents/seo-specialist.md +129 -0
- package/plugins/maestro/src/agents/site-reliability-engineer.md +131 -0
- package/plugins/maestro/src/agents/solutions-architect.md +137 -0
- package/plugins/maestro/src/agents/technical-writer.md +129 -0
- package/plugins/maestro/src/agents/tester.md +135 -0
- package/plugins/maestro/src/agents/ux-designer.md +168 -0
- package/plugins/maestro/src/agents/zos-sysprog.md +134 -0
- package/plugins/maestro/src/config/setting-resolver.js +32 -0
- package/plugins/maestro/src/core/agent-registry.js +67 -0
- package/plugins/maestro/src/core/canonical-source.js +39 -0
- package/plugins/maestro/src/core/env-file-parser.js +82 -0
- package/plugins/maestro/src/core/feature-blocks.js +34 -0
- package/plugins/maestro/src/core/logger.js +12 -0
- package/plugins/maestro/src/core/markdown-state.js +36 -0
- package/plugins/maestro/src/core/policy-rules.js +32 -0
- package/plugins/maestro/src/core/project-root-resolver.js +184 -0
- package/plugins/maestro/src/core/stdin-reader.js +77 -0
- package/plugins/maestro/src/core/version.js +50 -0
- package/plugins/maestro/src/entry-points/core-command-registry.js +37 -0
- package/plugins/maestro/src/entry-points/preamble-builders.js +54 -0
- package/plugins/maestro/src/entry-points/registry.js +199 -0
- package/plugins/maestro/src/entry-points/templates/claude-core-command.md.tmpl +38 -0
- package/plugins/maestro/src/entry-points/templates/claude-skill.md.tmpl +18 -0
- package/plugins/maestro/src/entry-points/templates/codex-core-command.md.tmpl +16 -0
- package/plugins/maestro/src/entry-points/templates/codex-skill.md.tmpl +11 -0
- package/plugins/maestro/src/entry-points/templates/gemini-command.toml.tmpl +17 -0
- package/plugins/maestro/src/entry-points/templates/gemini-core-command.toml.tmpl +30 -0
- package/plugins/maestro/src/generated/agent-registry.json +630 -0
- package/plugins/maestro/src/generated/hook-registry.json +18 -0
- package/plugins/maestro/src/generated/resource-registry.json +16 -0
- package/plugins/maestro/src/hooks/logic/after-agent-logic.js +54 -0
- package/plugins/maestro/src/hooks/logic/before-agent-logic.js +57 -0
- package/plugins/maestro/src/hooks/logic/hook-state.js +127 -0
- package/plugins/maestro/src/hooks/logic/session-end-logic.js +17 -0
- package/plugins/maestro/src/hooks/logic/session-start-logic.js +25 -0
- package/plugins/maestro/src/lib/discovery/index.js +172 -0
- package/plugins/maestro/src/lib/errors/index.js +104 -0
- package/plugins/maestro/src/lib/framework-detection.js +50 -0
- package/plugins/maestro/src/lib/frontmatter/index.js +262 -0
- package/plugins/maestro/src/lib/io/index.js +96 -0
- package/plugins/maestro/src/lib/naming/index.js +94 -0
- package/plugins/maestro/src/lib/validation/index.js +124 -0
- package/plugins/maestro/src/lib/yaml-emit.js +38 -0
- package/plugins/maestro/src/mcp/content/provider.js +68 -0
- package/plugins/maestro/src/mcp/content/runtime-content.js +188 -0
- package/plugins/maestro/src/mcp/contracts/cache-path-rejector.js +39 -0
- package/plugins/maestro/src/mcp/contracts/downstream-context.js +106 -0
- package/plugins/maestro/src/mcp/contracts/plan-schema.js +148 -0
- package/plugins/maestro/src/mcp/contracts/workspace-marker.js +61 -0
- package/plugins/maestro/src/mcp/core/create-server.js +76 -0
- package/plugins/maestro/src/mcp/core/line-reader.js +35 -0
- package/plugins/maestro/src/mcp/core/project-root-cache.js +120 -0
- package/plugins/maestro/src/mcp/core/protocol-dispatcher.js +274 -0
- package/plugins/maestro/src/mcp/core/recovery-hints.js +43 -0
- package/plugins/maestro/src/mcp/core/tool-outcome.js +77 -0
- package/plugins/maestro/src/mcp/core/tool-registry.js +82 -0
- package/plugins/maestro/src/mcp/handlers/assess-task-complexity.js +108 -0
- package/plugins/maestro/src/mcp/handlers/blocker-parser.js +34 -0
- package/plugins/maestro/src/mcp/handlers/design-gate.js +393 -0
- package/plugins/maestro/src/mcp/handlers/get-agent.js +54 -0
- package/plugins/maestro/src/mcp/handlers/get-runtime-context.js +49 -0
- package/plugins/maestro/src/mcp/handlers/get-skill-content.js +51 -0
- package/plugins/maestro/src/mcp/handlers/initialize-workspace.js +45 -0
- package/plugins/maestro/src/mcp/handlers/reconciliation.js +224 -0
- package/plugins/maestro/src/mcp/handlers/resolve-settings.js +39 -0
- package/plugins/maestro/src/mcp/handlers/session-state-core.js +108 -0
- package/plugins/maestro/src/mcp/handlers/session-state-tools.js +562 -0
- package/plugins/maestro/src/mcp/handlers/validate-plan.js +76 -0
- package/plugins/maestro/src/mcp/maestro-server.js +122 -0
- package/plugins/maestro/src/mcp/runtime/runtime-config-map.js +70 -0
- package/plugins/maestro/src/mcp/tool-packs/content/index.js +80 -0
- package/plugins/maestro/src/mcp/tool-packs/contracts.js +30 -0
- package/plugins/maestro/src/mcp/tool-packs/index.js +15 -0
- package/plugins/maestro/src/mcp/tool-packs/session/index.js +243 -0
- package/plugins/maestro/src/mcp/tool-packs/workspace/index.js +98 -0
- package/plugins/maestro/src/mcp/utils/extension-root.js +31 -0
- package/plugins/maestro/src/mcp/validation/agent-checker.js +81 -0
- package/plugins/maestro/src/mcp/validation/dag-checker.js +214 -0
- package/plugins/maestro/src/mcp/validation/file-overlap-checker.js +63 -0
- package/plugins/maestro/src/mcp/validation/schema-checker.js +108 -0
- package/plugins/maestro/src/platforms/codex/runtime-config.js +58 -0
- package/plugins/maestro/src/platforms/shared/adapters/conventions.js +29 -0
- package/plugins/maestro/src/platforms/shared/adapters/exit-codes.js +6 -0
- package/plugins/maestro/src/platforms/shared/adapters/factory.js +40 -0
- package/plugins/maestro/src/platforms/shared/agent-names.js +10 -0
- package/plugins/maestro/src/platforms/shared/hook-runner.js +52 -0
- package/plugins/maestro/src/references/architecture.md +139 -0
- package/plugins/maestro/src/references/orchestration-steps.md +193 -0
- package/plugins/maestro/src/skills/shared/code-review/SKILL.md +145 -0
- package/plugins/maestro/src/skills/shared/delegation/SKILL.md +370 -0
- package/plugins/maestro/src/skills/shared/delegation/protocols/agent-base-protocol.md +145 -0
- package/plugins/maestro/src/skills/shared/delegation/protocols/filesystem-safety-protocol.md +31 -0
- package/plugins/maestro/src/skills/shared/design-dialogue/SKILL.md +284 -0
- package/plugins/maestro/src/skills/shared/execution/SKILL.md +258 -0
- package/plugins/maestro/src/skills/shared/implementation-planning/SKILL.md +303 -0
- package/plugins/maestro/src/skills/shared/session-management/SKILL.md +314 -0
- package/plugins/maestro/src/skills/shared/validation/SKILL.md +204 -0
- package/plugins/maestro/src/state/session-state.js +113 -0
- package/plugins/maestro/src/templates/design-document.md +95 -0
- package/plugins/maestro/src/templates/implementation-plan.md +86 -0
- package/plugins/maestro/src/templates/session-state.md +68 -0
- package/plugins/maestro/src/version.json +3 -0
- package/policies/maestro.toml +44 -0
- package/qwen/agents/accessibility_specialist.md +18 -0
- package/qwen/agents/analytics_engineer.md +20 -0
- package/qwen/agents/api_designer.md +17 -0
- package/qwen/agents/architect.md +17 -0
- package/qwen/agents/cloud_architect.md +17 -0
- package/qwen/agents/cobol_engineer.md +20 -0
- package/qwen/agents/code_reviewer.md +15 -0
- package/qwen/agents/coder.md +20 -0
- package/qwen/agents/compliance_reviewer.md +17 -0
- package/qwen/agents/content_strategist.md +17 -0
- package/qwen/agents/copywriter.md +17 -0
- package/qwen/agents/data_engineer.md +20 -0
- package/qwen/agents/database_administrator.md +19 -0
- package/qwen/agents/db2_dba.md +19 -0
- package/qwen/agents/debugger.md +17 -0
- package/qwen/agents/design_system_engineer.md +20 -0
- package/qwen/agents/devops_engineer.md +21 -0
- package/qwen/agents/hlasm_assembler_specialist.md +20 -0
- package/qwen/agents/i18n_specialist.md +19 -0
- package/qwen/agents/ibm_i_specialist.md +20 -0
- package/qwen/agents/integration_engineer.md +21 -0
- package/qwen/agents/ml_engineer.md +21 -0
- package/qwen/agents/mlops_engineer.md +21 -0
- package/qwen/agents/mobile_engineer.md +21 -0
- package/qwen/agents/observability_engineer.md +21 -0
- package/qwen/agents/performance_engineer.md +19 -0
- package/qwen/agents/platform_engineer.md +22 -0
- package/qwen/agents/product_manager.md +18 -0
- package/qwen/agents/prompt_engineer.md +20 -0
- package/qwen/agents/refactor.md +20 -0
- package/qwen/agents/release_manager.md +20 -0
- package/qwen/agents/security_engineer.md +19 -0
- package/qwen/agents/seo_specialist.md +19 -0
- package/qwen/agents/site_reliability_engineer.md +19 -0
- package/qwen/agents/solutions_architect.md +17 -0
- package/qwen/agents/technical_writer.md +19 -0
- package/qwen/agents/tester.md +21 -0
- package/qwen/agents/ux_designer.md +18 -0
- package/qwen/agents/zos_sysprog.md +19 -0
- package/qwen/hooks.json +56 -0
- package/qwen-extension.json +55 -0
- package/scripts/check-layer-boundaries.js +74 -0
- package/scripts/generate.js +155 -0
- package/scripts/install-codex-plugin.js +167 -0
- package/scripts/install-git-hooks.js +43 -0
- package/scripts/npm-publish-idempotent.js +150 -0
- package/scripts/package-release-artifacts.js +156 -0
- package/scripts/release-artifact-manifest.js +378 -0
- package/scripts/release-version-metadata.js +129 -0
- package/scripts/update-versions.js +33 -0
- package/scripts/verify-npm-pack.js +85 -0
- package/scripts/verify-release-artifacts.js +95 -0
- package/src/agents/accessibility-specialist.md +163 -0
- package/src/agents/analytics-engineer.md +182 -0
- package/src/agents/api-designer.md +124 -0
- package/src/agents/architect.md +120 -0
- package/src/agents/cloud-architect.md +134 -0
- package/src/agents/cobol-engineer.md +127 -0
- package/src/agents/code-reviewer.md +123 -0
- package/src/agents/coder.md +132 -0
- package/src/agents/compliance-reviewer.md +219 -0
- package/src/agents/content-strategist.md +111 -0
- package/src/agents/copywriter.md +113 -0
- package/src/agents/data-engineer.md +130 -0
- package/src/agents/database-administrator.md +126 -0
- package/src/agents/db2-dba.md +124 -0
- package/src/agents/debugger.md +133 -0
- package/src/agents/design-system-engineer.md +258 -0
- package/src/agents/devops-engineer.md +138 -0
- package/src/agents/hlasm-assembler-specialist.md +134 -0
- package/src/agents/i18n-specialist.md +241 -0
- package/src/agents/ibm-i-specialist.md +132 -0
- package/src/agents/integration-engineer.md +133 -0
- package/src/agents/ml-engineer.md +115 -0
- package/src/agents/mlops-engineer.md +116 -0
- package/src/agents/mobile-engineer.md +115 -0
- package/src/agents/observability-engineer.md +133 -0
- package/src/agents/performance-engineer.md +139 -0
- package/src/agents/platform-engineer.md +129 -0
- package/src/agents/product-manager.md +170 -0
- package/src/agents/prompt-engineer.md +129 -0
- package/src/agents/refactor.md +138 -0
- package/src/agents/release-manager.md +132 -0
- package/src/agents/security-engineer.md +143 -0
- package/src/agents/seo-specialist.md +129 -0
- package/src/agents/site-reliability-engineer.md +131 -0
- package/src/agents/solutions-architect.md +137 -0
- package/src/agents/technical-writer.md +129 -0
- package/src/agents/tester.md +135 -0
- package/src/agents/ux-designer.md +168 -0
- package/src/agents/zos-sysprog.md +134 -0
- package/src/config/setting-resolver.js +32 -0
- package/src/core/agent-registry.js +67 -0
- package/src/core/canonical-source.js +39 -0
- package/src/core/env-file-parser.js +82 -0
- package/src/core/feature-blocks.js +34 -0
- package/src/core/logger.js +12 -0
- package/src/core/markdown-state.js +36 -0
- package/src/core/policy-rules.js +32 -0
- package/src/core/project-root-resolver.js +184 -0
- package/src/core/stdin-reader.js +77 -0
- package/src/core/version.js +50 -0
- package/src/entry-points/core-command-registry.js +37 -0
- package/src/entry-points/preamble-builders.js +54 -0
- package/src/entry-points/registry.js +199 -0
- package/src/entry-points/templates/claude-core-command.md.tmpl +38 -0
- package/src/entry-points/templates/claude-skill.md.tmpl +18 -0
- package/src/entry-points/templates/codex-core-command.md.tmpl +16 -0
- package/src/entry-points/templates/codex-skill.md.tmpl +11 -0
- package/src/entry-points/templates/gemini-command.toml.tmpl +17 -0
- package/src/entry-points/templates/gemini-core-command.toml.tmpl +30 -0
- package/src/generated/agent-registry.json +630 -0
- package/src/generated/hook-registry.json +18 -0
- package/src/generated/resource-registry.json +16 -0
- package/src/generator/entry-point-expander.js +182 -0
- package/src/generator/file-writer.js +167 -0
- package/src/generator/generation-session.js +62 -0
- package/src/generator/manifest-curator.js +31 -0
- package/src/generator/manifest-expander.js +256 -0
- package/src/generator/payload-builder.js +217 -0
- package/src/generator/registry-scanner.js +130 -0
- package/src/generator/stale-pruner.js +101 -0
- package/src/hooks/logic/after-agent-logic.js +54 -0
- package/src/hooks/logic/before-agent-logic.js +57 -0
- package/src/hooks/logic/hook-state.js +127 -0
- package/src/hooks/logic/session-end-logic.js +17 -0
- package/src/hooks/logic/session-start-logic.js +25 -0
- package/src/lib/discovery/index.js +172 -0
- package/src/lib/errors/index.js +104 -0
- package/src/lib/framework-detection.js +50 -0
- package/src/lib/frontmatter/index.js +262 -0
- package/src/lib/io/index.js +96 -0
- package/src/lib/naming/index.js +94 -0
- package/src/lib/validation/index.js +124 -0
- package/src/lib/yaml-emit.js +38 -0
- package/src/manifest.js +11 -0
- package/src/mcp/content/provider.js +68 -0
- package/src/mcp/content/runtime-content.js +188 -0
- package/src/mcp/contracts/cache-path-rejector.js +39 -0
- package/src/mcp/contracts/downstream-context.js +106 -0
- package/src/mcp/contracts/plan-schema.js +148 -0
- package/src/mcp/contracts/workspace-marker.js +61 -0
- package/src/mcp/core/create-server.js +76 -0
- package/src/mcp/core/line-reader.js +35 -0
- package/src/mcp/core/project-root-cache.js +120 -0
- package/src/mcp/core/protocol-dispatcher.js +274 -0
- package/src/mcp/core/recovery-hints.js +43 -0
- package/src/mcp/core/tool-outcome.js +77 -0
- package/src/mcp/core/tool-registry.js +82 -0
- package/src/mcp/handlers/assess-task-complexity.js +108 -0
- package/src/mcp/handlers/blocker-parser.js +34 -0
- package/src/mcp/handlers/design-gate.js +393 -0
- package/src/mcp/handlers/get-agent.js +54 -0
- package/src/mcp/handlers/get-runtime-context.js +49 -0
- package/src/mcp/handlers/get-skill-content.js +51 -0
- package/src/mcp/handlers/initialize-workspace.js +45 -0
- package/src/mcp/handlers/reconciliation.js +224 -0
- package/src/mcp/handlers/resolve-settings.js +39 -0
- package/src/mcp/handlers/session-state-core.js +108 -0
- package/src/mcp/handlers/session-state-tools.js +562 -0
- package/src/mcp/handlers/validate-plan.js +76 -0
- package/src/mcp/maestro-server.js +122 -0
- package/src/mcp/runtime/runtime-config-map.js +70 -0
- package/src/mcp/tool-packs/content/index.js +80 -0
- package/src/mcp/tool-packs/contracts.js +30 -0
- package/src/mcp/tool-packs/index.js +15 -0
- package/src/mcp/tool-packs/session/index.js +243 -0
- package/src/mcp/tool-packs/workspace/index.js +98 -0
- package/src/mcp/utils/extension-root.js +31 -0
- package/src/mcp/validation/agent-checker.js +81 -0
- package/src/mcp/validation/dag-checker.js +214 -0
- package/src/mcp/validation/file-overlap-checker.js +63 -0
- package/src/mcp/validation/schema-checker.js +108 -0
- package/src/platforms/claude/metadata.js +96 -0
- package/src/platforms/claude/runtime-config.js +60 -0
- package/src/platforms/codex/metadata.js +107 -0
- package/src/platforms/codex/runtime-config.js +58 -0
- package/src/platforms/gemini/metadata.js +27 -0
- package/src/platforms/gemini/runtime-config.js +62 -0
- package/src/platforms/metadata-shared.js +131 -0
- package/src/platforms/metadata.js +29 -0
- package/src/platforms/qwen/metadata.js +27 -0
- package/src/platforms/qwen/runtime-config.js +62 -0
- package/src/platforms/shared/adapters/claude-adapter.js +36 -0
- package/src/platforms/shared/adapters/conventions.js +29 -0
- package/src/platforms/shared/adapters/exit-codes.js +6 -0
- package/src/platforms/shared/adapters/factory.js +40 -0
- package/src/platforms/shared/adapters/gemini-adapter.js +34 -0
- package/src/platforms/shared/adapters/qwen-adapter.js +93 -0
- package/src/platforms/shared/agent-names.js +10 -0
- package/src/platforms/shared/hook-runner.js +52 -0
- package/src/references/architecture.md +139 -0
- package/src/references/orchestration-steps.md +193 -0
- package/src/scripts/ensure-workspace.js +14 -0
- package/src/scripts/read-active-session.js +26 -0
- package/src/scripts/read-setting.js +18 -0
- package/src/scripts/read-state.js +17 -0
- package/src/scripts/write-state.js +22 -0
- package/src/skills/shared/code-review/SKILL.md +145 -0
- package/src/skills/shared/delegation/SKILL.md +370 -0
- package/src/skills/shared/delegation/protocols/agent-base-protocol.md +145 -0
- package/src/skills/shared/delegation/protocols/filesystem-safety-protocol.md +31 -0
- package/src/skills/shared/design-dialogue/SKILL.md +284 -0
- package/src/skills/shared/execution/SKILL.md +258 -0
- package/src/skills/shared/implementation-planning/SKILL.md +303 -0
- package/src/skills/shared/session-management/SKILL.md +314 -0
- package/src/skills/shared/validation/SKILL.md +204 -0
- package/src/state/session-state.js +113 -0
- package/src/templates/design-document.md +95 -0
- package/src/templates/implementation-plan.md +86 -0
- package/src/templates/session-state.md +68 -0
- package/src/transforms/agent-stub.js +29 -0
- package/src/transforms/extract-examples.js +63 -0
- package/src/transforms/index.js +35 -0
- package/src/transforms/parse-frontmatter.js +23 -0
- package/src/transforms/rebuild-frontmatter.js +147 -0
- package/src/transforms/skill-discovery-stub.js +27 -0
- 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
|
+
}
|
package/hooks/hooks.json
ADDED
|
@@ -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
|
+
}
|
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
|
+
}
|