maestro-flow 0.3.20 → 0.3.21

package/.codex/skills/maestro/SKILL.md

@@ -141,7 +141,7 @@ After each barrier skill completes, read its artifacts and update `state.context
    spawn_agents_on_csv({
      csv_path: "{sessionDir}/wave-{N}.csv",
      id_column: "id", instruction: WAVE_INSTRUCTION,
-     max_workers: <wave size>, max_runtime_seconds: 1800,
+     max_workers: <wave size>, max_runtime_seconds: 3600,
      output_csv_path: "{sessionDir}/wave-{N}-results.csv",
      output_schema: RESULT_SCHEMA
    })

package/.codex/skills/maestro-analyze/SKILL.md

@@ -252,7 +252,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildExplorationInstruction(sessionFolder),
   max_concurrency: maxConcurrency,
-  max_runtime_seconds: 600,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: { id, status: ["completed"|"failed"], findings, score, recommendations, error }
   // required: id, status, findings
@@ -277,7 +277,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildScoringInstruction(sessionFolder),
   max_concurrency: maxConcurrency,
-  max_runtime_seconds: 600,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-2-results.csv`,
   output_schema: { id, status: ["completed"|"failed"], findings, score, recommendations, error }
   // required: id, status, findings, score

package/.codex/skills/maestro-brainstorm/SKILL.md

@@ -230,7 +230,7 @@ spawn_agents_on_csv({
   csv_path: `${sessionFolder}/wave-1.csv`,
   id_column: "id",
   instruction: buildGuidanceInstruction(sessionFolder, topicArg),
-  max_concurrency: 1, max_runtime_seconds: 600,
+  max_concurrency: 1, max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: { id, status: [completed|failed], findings, analysis_file, error }
 })
@@ -258,7 +258,7 @@ spawn_agents_on_csv({
   csv_path: `${sessionFolder}/wave-2.csv`,
   id_column: "id",
   instruction: buildRoleAnalysisInstruction(sessionFolder),
-  max_concurrency: maxConcurrency, max_runtime_seconds: 900,
+  max_concurrency: maxConcurrency, max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-2-results.csv`,
   output_schema: { id, status: [completed|failed], findings, analysis_file, error }
 })

package/.codex/skills/maestro-execute/SKILL.md

@@ -219,7 +219,7 @@ spawn_agents_on_csv({
   csv_path: `${sessionFolder}/wave-${N}.csv`,
   id_column: "id",
   instruction: buildExecutorInstruction(sessionFolder, phaseDir, autoCommit, specsContent),
-  max_concurrency: maxConcurrency, max_runtime_seconds: 900,
+  max_concurrency: maxConcurrency, max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-${N}-results.csv`,
   output_schema: { id, status: [completed|failed|blocked], findings, files_modified, tests_passed, error }
 })

package/.codex/skills/maestro-link-coordinate/SKILL.md

@@ -119,7 +119,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: AGENT_INSTRUCTION,
   max_workers: 1,
-  max_runtime_seconds: 1800,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionDir}/wave-${nodeId}-results.csv`,
   output_schema: RESULT_SCHEMA
 })

package/.codex/skills/maestro-plan/SKILL.md

@@ -227,7 +227,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildExplorationInstruction(sessionFolder, phaseDir),
   max_concurrency: maxConcurrency,
-  max_runtime_seconds: 600,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: { // required: id, status, findings
     id: "string", status: "completed|failed", findings: "string", error: "string"
@@ -268,7 +268,7 @@ spawn_agents_on_csv({
     contextMd, indexJson, specRef, docIndex, designRef, gapsContext
   }),
   max_concurrency: 1,  // Single planning agent
-  max_runtime_seconds: 900,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-2-results.csv`,
   output_schema: { // required: id, status, findings
     id: "string", status: "completed|failed", findings: "string", error: "string"

package/.codex/skills/maestro-player/SKILL.md

@@ -199,7 +199,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: PLAYER_INSTRUCTION,
   max_workers: waveSteps.length,
-  max_runtime_seconds: 1800,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionDir}/wave-${waveNum}-results.csv`,
   output_schema: RESULT_SCHEMA
 })

package/.codex/skills/maestro-roadmap/SKILL.md

@@ -198,7 +198,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildAnalysisInstruction(sessionFolder, requirementArg, strategy),
   max_concurrency: 3,
-  max_runtime_seconds: 300,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: {
     type: "object",

package/.codex/skills/maestro-spec-generate/SKILL.md

@@ -218,7 +218,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildResearchInstruction(sessionFolder, topicArg),
   max_concurrency: 3,
-  max_runtime_seconds: 600,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: {
     type: "object",

package/.codex/skills/maestro-verify/SKILL.md

@@ -235,7 +235,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildVerifyInstruction(sessionFolder, "wave1"),
   max_concurrency: maxConcurrency,
-  max_runtime_seconds: 600,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: { id, status: ["completed"|"failed"], findings, gaps_found, fix_plan, error }
   // required: id, status, findings

package/.codex/skills/manage-codebase-rebuild/SKILL.md

@@ -200,7 +200,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildRebuildInstruction(sessionFolder, sourceDirs),
   max_concurrency: maxConcurrency,
-  max_runtime_seconds: 900,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: {
     type: "object",

package/.codex/skills/manage-issue-discover/SKILL.md

@@ -247,7 +247,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildDiscoverInstruction(sessionFolder, discoveryDir, mode),
   max_concurrency: maxConcurrency,
-  max_runtime_seconds: 900,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: { // required: id, status, findings
     id: "string", status: "completed|failed",

package/.codex/skills/quality-debug/SKILL.md

@@ -205,7 +205,7 @@ spawn_agents_on_csv({
   csv_path: `${sessionFolder}/wave-1.csv`,
   id_column: "id",
   instruction: buildInvestigationInstruction(sessionFolder),
-  max_concurrency: maxConcurrency, max_runtime_seconds: 600,
+  max_concurrency: maxConcurrency, max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: { id, status: [confirmed|refuted|inconclusive|failed], findings, evidence_for, evidence_against, error }
 })
@@ -225,7 +225,7 @@ spawn_agents_on_csv({
   csv_path: `${sessionFolder}/wave-2.csv`,
   id_column: "id",
   instruction: buildFixInstruction(sessionFolder),
-  max_concurrency: maxConcurrency, max_runtime_seconds: 900,
+  max_concurrency: maxConcurrency, max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-2-results.csv`,
   output_schema: { id, status: [fixed|fix_failed|failed], findings, fix_applied, verified, error }
 })

package/.codex/skills/quality-integration-test/SKILL.md

@@ -231,7 +231,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildL0Instruction(sessionFolder),
   max_concurrency: maxConcurrency,
-  max_runtime_seconds: 300,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: { id, status: ["completed"|"failed"], findings, tests_passed, tests_failed, coverage, error }
   // required: id, status, findings

package/.codex/skills/quality-review/SKILL.md

@@ -204,7 +204,7 @@ spawn_agents_on_csv({
   id_column: "id",
   instruction: buildReviewInstruction(sessionFolder),
   max_concurrency: maxConcurrency,
-  max_runtime_seconds: 600,
+  max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: {
     type: "object",

package/.codex/skills/quality-test-gen/SKILL.md

@@ -214,7 +214,7 @@ spawn_agents_on_csv({
   csv_path: `${sessionFolder}/wave-1.csv`,
   id_column: "id",
   instruction: buildTestGenInstruction(sessionFolder),
-  max_concurrency: maxConcurrency, max_runtime_seconds: 600,
+  max_concurrency: maxConcurrency, max_runtime_seconds: 3600,
   output_csv_path: `${sessionFolder}/wave-1-results.csv`,
   output_schema: { id, status: [completed|failed], findings, tests_created, coverage_delta, error }
 })

package/.codex/skills/spec-map/SKILL.md

@@ -106,7 +106,7 @@ Generate 4 mapper rows. If focus area specified, scope descriptions to that area
 
 ### Phase 2: Wave Execution
 
-Single wave -- all 4 mappers via `spawn_agents_on_csv` (max_concurrency: 4, 600s timeout). Each agent returns: id, status (completed/failed), findings, error.
+Single wave -- all 4 mappers via `spawn_agents_on_csv` (max_concurrency: 4, 3600s timeout). Each agent returns: id, status (completed/failed), findings, error.
 
 ### Phase 3: Write Output Files
 

package/.codex/skills/team-coordinate/roles/coordinator/role.md

@@ -385,6 +385,7 @@ Delegate to `@commands/dispatch.md` which creates the full task chain:
 ### Agent Lifecycle Management
 - **list_agents({})**: Returns all running agents. Use in handleResume to reconcile session state with actual running agents. Use in handleComplete to verify clean shutdown.
 - **Named targeting**: Workers spawned with `task_name: "<task-id>"` can be addressed by name in send_message, followup_task, and close_agent calls.
+- **Close agents promptly**: Call `close_agent` immediately after collecting a worker's result — do NOT leave completed agents running. Idle agents waste resources. At pipeline end, verify all agents closed via `list_agents`.
 
 ## Error Handling
 

package/.codex/skills/team-executor/roles/executor/role.md

@@ -155,6 +155,9 @@ Initialize session folder if needed.
 
 ---
 
+## Agent Lifecycle Management
+- **Close agents promptly**: Call `close_agent` immediately after collecting a worker's result — do NOT leave completed agents running. Idle agents waste resources. At pipeline end, verify all agents closed via `list_agents`.
+
 ## Error Handling
 
 | Error | Resolution |

package/.codex/skills/team-lifecycle-v4/roles/coordinator/role.md

@@ -175,6 +175,7 @@ Delegate to @commands/monitor.md#handleSpawnNext:
 ### Agent Lifecycle Management
 - **list_agents({})**: Returns all running agents. Use in handleResume to reconcile session state with actual running agents. Use in handleComplete to verify clean shutdown.
 - **Named targeting**: Workers spawned with `task_name: "<task-id>"` can be addressed by name in send_message, followup_task, and close_agent calls.
+- **Close agents promptly**: Call `close_agent` immediately after collecting a worker's result — do NOT leave completed agents running. Idle agents waste resources. At pipeline end, verify all agents closed via `list_agents`.
 
 ## Error Handling
 

package/.codex/skills/team-quality-assurance/roles/coordinator/role.md

@@ -162,6 +162,7 @@ Delegate to @commands/monitor.md#handleSpawnNext:
 ### Agent Lifecycle Management
 - **list_agents({})**: Returns all running agents. Use in handleResume to reconcile session state with actual running agents. Use in handleComplete to verify clean shutdown.
 - **Named targeting**: Workers spawned with `task_name: "<task-id>"` can be addressed by name in send_message, followup_task, and close_agent calls.
+- **Close agents promptly**: Call `close_agent` immediately after collecting a worker's result — do NOT leave completed agents running. Idle agents waste resources. At pipeline end, verify all agents closed via `list_agents`.
 
 ## Error Handling
 

package/.codex/skills/team-review/roles/coordinator/role.md

@@ -162,6 +162,7 @@ Delegate to @commands/monitor.md#handleSpawnNext:
 ### Agent Lifecycle Management
 - **list_agents({})**: Returns all running agents. Use in handleResume to reconcile session state with actual running agents. Use in handleComplete to verify clean shutdown.
 - **Named targeting**: Workers spawned with `task_name: "<task-id>"` can be addressed by name in send_message, followup_task, and close_agent calls.
+- **Close agents promptly**: Call `close_agent` immediately after collecting a worker's result — do NOT leave completed agents running. Idle agents waste resources. At pipeline end, verify all agents closed via `list_agents`.
 
 ## Error Handling
 

package/.codex/skills/team-tech-debt/roles/coordinator/role.md

@@ -158,6 +158,7 @@ Delegate to @commands/monitor.md#handleSpawnNext:
 ### Agent Lifecycle Management
 - **list_agents({})**: Returns all running agents. Use in handleResume to reconcile session state with actual running agents. Use in handleComplete to verify clean shutdown.
 - **Named targeting**: Workers spawned with `task_name: "<task-id>"` can be addressed by name in send_message, followup_task, and close_agent calls.
+- **Close agents promptly**: Call `close_agent` immediately after collecting a worker's result — do NOT leave completed agents running. Idle agents waste resources. At pipeline end, verify all agents closed via `list_agents`.
 
 ## Error Handling
 

package/.codex/skills/team-testing/roles/coordinator/role.md

@@ -171,6 +171,7 @@ Delegate to @commands/monitor.md#handleSpawnNext:
 ### Agent Lifecycle Management
 - **list_agents({})**: Returns all running agents. Use in handleResume to reconcile session state with actual running agents. Use in handleComplete to verify clean shutdown.
 - **Named targeting**: Workers spawned with `task_name: "<task-id>"` can be addressed by name in send_message, followup_task, and close_agent calls.
+- **Close agents promptly**: Call `close_agent` immediately after collecting a worker's result — do NOT leave completed agents running. Idle agents waste resources. At pipeline end, verify all agents closed via `list_agents`.
 
 ## Error Handling
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maestro-flow",
-  "version": "0.3.20",
+  "version": "0.3.21",
   "description": "Workflow orchestration CLI with MCP endpoint support and extensible architecture",
   "type": "module",
   "imports": {