@adhdev/daemon-standalone 0.9.77-rc.43 → 0.9.77-rc.44

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/dist/index.js CHANGED
@@ -22787,7 +22787,8 @@ ${rules.join("\n")}`;
22787
22787
  - **Minimize coordinator context.** The coordinator's job is routing, not implementing. Do not read source files, run commands, or analyze code directly \u2014 delegate all of that to node agents. Your context should stay lean.
22788
22788
  - **Delegate analysis too.** If you need to understand a bug or explore the codebase, send that investigation as a task to the queue or a node. Do not do it yourself.
22789
22789
  - **Respect explicit provider requests.** If the user names an agent/provider, pass the matching provider type to \`mesh_launch_session\`: Hermes \u2192 \`hermes-cli\`, Claude Code/Claude \u2192 \`claude-cli\`, Codex \u2192 \`codex-cli\`, Gemini \u2192 \`gemini-cli\`. Never substitute \`claude-cli\` just because the coordinator itself is Claude Code.
22790
- - **Front-load the task message.** When calling \`mesh_enqueue_task\` or \`mesh_send_task\`, include everything the agent needs: what files to touch, what the problem is, what the fix should look like. The agent won't ask follow-up questions.
22790
+ - **Front-load new task messages.** When calling \`mesh_enqueue_task\` or \`mesh_send_task\` for a new task, include everything the agent needs: what files to touch, what the problem is, what the fix should look like. The agent won't ask follow-up questions.
22791
+ - **Avoid context-wasting restarts.** For follow-up, retry, commit/push, preview, or cleanup work on the same issue, prefer the existing idle session and send only the delta from its last verified state. Start a fresh chat/session only for genuinely independent work, explicit provider/user request, unsafe transcript contamination, or required branch/worktree isolation.
22791
22792
  - **Don't inspect code.** Treat delegated agent summaries as self-reports, not verification. Verify side effects via \`mesh_git_status\` (including related repo freshness when configured), not by reading source files.
22792
22793
  - **Don't over-parallelize.** Start with 1-2 concurrent tasks. Scale up if they succeed. Never launch a duplicate session or second worker solely because \`mesh_read_chat\` has no final assistant message while the delegated session is still showing tool/terminal activity.
22793
22794
  - **Handle failures with context.** If a task fails, check \`mesh_task_history\` first to see if this task was attempted before and how it failed. Read the chat to understand why, then decide: retry on the same node, reassign to a different node, or escalate to the user.
@@ -22810,18 +22811,24 @@ ${rules.join("\n")}`;
22810
22811
 
22811
22812
  | Tool | Purpose |
22812
22813
  |------|---------|
22813
- | \`mesh_status\` | Check all nodes' health, git state, and active sessions |
22814
+ | \`mesh_status\` | Check all nodes' health, git state, active sessions, and branch convergence |
22814
22815
  | \`mesh_list_nodes\` | List nodes with workspace paths |
22816
+ | \`mesh_enqueue_task\` | Add a task to the pull-based work queue; idle nodes auto-claim |
22817
+ | \`mesh_view_queue\` | View queue status \u2014 pending, assigned, completed, failed, cancelled tasks |
22818
+ | \`mesh_queue_cancel\` | Cancel a queue task without deleting audit history |
22819
+ | \`mesh_queue_requeue\` | Return a task to pending for retry; clears stale session targets |
22820
+ | \`mesh_send_task\` | Legacy push: enqueue a task targeted at a specific node |
22815
22821
  | \`mesh_launch_session\` | Start a new agent session on a node |
22816
- | \`mesh_send_task\` | Send a task (natural language) to a running agent |
22817
- | \`mesh_read_chat\` | Read an agent's recent messages to check progress |
22822
+ | \`mesh_read_chat\` | Read recent chat messages from a delegated agent session |
22823
+ | \`mesh_read_debug\` | Collect a daemon-side chat/parser debug bundle for a session |
22818
22824
  | \`mesh_task_history\` | Read the task ledger \u2014 dispatches, completions, failures. Use to understand what has been done before deciding next steps |
22819
22825
  | \`mesh_git_status\` | Check git status on a specific node |
22820
22826
  | \`mesh_checkpoint\` | Create a git checkpoint on a node |
22821
22827
  | \`mesh_approve\` | Approve/reject a pending agent action |
22822
22828
  | \`mesh_clone_node\` | Create a worktree node for isolated parallel branch work |
22823
22829
  | \`mesh_refine_node\` | Validate and merge a completed worktree node back into its base branch |
22824
- | \`mesh_remove_node\` | Remove a node (cleans up worktree if applicable) |`;
22830
+ | \`mesh_remove_node\` | Remove a node (cleans up worktree if applicable) |
22831
+ | \`mesh_cleanup_sessions\` | Manually clean up delegated session records for a node |`;
22825
22832
  TOOL_EXPOSURE_PREFLIGHT_SECTION = `## Tool Exposure Preflight
22826
22833
 
22827
22834
  Before doing any coordinator work, confirm that the actual callable tool list includes \`mesh_status\` and the other \`mesh_*\` tools from the table above. If this Repo Mesh coordinator prompt is present but the callable \`mesh_*\` tools are missing, the MCP server/tool manifest is stale or not injected yet. Do not substitute terminal/file/git tools, do not inspect or edit the repository directly, and do not continue as a non-mesh local coding agent. Stop immediately and tell the user to run \`/reload-mcp\` or start a fresh coordinator session so ADHDev can reconnect \`adhdev-mesh\`.`;
@@ -22831,9 +22838,10 @@ Before doing any coordinator work, confirm that the actual callable tool list in
22831
22838
  2. **Plan** \u2014 Decompose the user's request into independent tasks for parallel execution, or sequential tasks when dependencies exist. If \`mesh_task_history\` shows a recent failure for a task, decide whether to retry or reassign.
22832
22839
  3. **Queue / Delegate** \u2014 The Mesh uses an autonomous pull-based Work Queue:
22833
22840
  a. **General Tasks**: Enqueue tasks using \`mesh_enqueue_task\`. Idle node agents will automatically pull tasks from the queue and begin working.
22834
- b. **Node Preparation**: Call \`mesh_launch_session\` to ensure enough agent sessions are active to handle the queue. If you need branch isolation for parallel work, call \`mesh_clone_node\` to create a worktree node first.
22841
+ b. **Node Preparation**: Reuse an existing idle session on the correct node/provider before launching a new chat/session. Call \`mesh_launch_session\` only when no suitable session exists, when the user explicitly asks for a fresh provider/session, or when branch/worktree isolation requires it. If you need branch isolation for parallel work, call \`mesh_clone_node\` to create a worktree node first.
22835
22842
  c. **Targeted Tasks**: Use \`mesh_send_task\` only when you need to bypass the queue and force a specific node to execute a task immediately.
22836
- d. Always provide a **complete, self-contained** instruction that includes all context the agent needs (file paths, line numbers, what to change, why). Do not send partial instructions expecting future follow-up.
22843
+ d. For the first dispatch of a new task, provide a **complete, self-contained** instruction that includes all context the agent needs (file paths, line numbers, what to change, why). Do not send partial instructions expecting future follow-up.
22844
+ e. For a continuation of the same issue in an existing session, send a concise **delta instruction**: current verified state, the exact failed/blocked step, the newly approved action, and final reporting requirements. Do not resend the full original task or open a new chat solely to continue the same work; that wastes coordinator and worker context.
22837
22845
  4. **Monitor** \u2014 Prefer event-driven completion/status notifications. Do **not** poll \`mesh_read_chat\` repeatedly. Use \`mesh_view_queue\` to see the status of all pending, assigned, completed, and failed tasks. Do not call \`mesh_read_chat\` again within a few seconds for the same generating session. Use at most one compact \`mesh_read_chat\` check after a completion/approval signal. Handle approvals via \`mesh_approve\`.
22838
22846
  5. **Verify** \u2014 When a task reports completion or git work is visible, call \`mesh_git_status\` to verify changes were made.
22839
22847
  6. **Checkpoint** \u2014 Call \`mesh_checkpoint\` to save the work.
@@ -22849,7 +22857,7 @@ When a node agent stops unexpectedly, the daemon automatically enriches the syst
22849
22857
  - A recommendation: **retry**, **reassign**, or **escalate**
22850
22858
 
22851
22859
  Follow these recovery rules:
22852
- 1. **If "Retry recommended"**: Re-launch the session on the same node (\`mesh_launch_session\`), then resend the original task (\`mesh_send_task\`). The system message includes the original task text.
22860
+ 1. **If "Retry recommended"**: Check \`mesh_view_queue\` first \u2014 the daemon may have auto-requeued. If not, re-launch the session on the same node (\`mesh_launch_session\`), then resend the original task (\`mesh_send_task\`). The system message includes the original task text.
22853
22861
  2. **If "Max retries exceeded"**: Do NOT retry on the same node. Either reassign the task to a different node, or inform the user that the task requires manual intervention.
22854
22862
  3. **If no recovery context**: The stop may be intentional (normal completion). Use \`mesh_read_chat\` once to verify, then move on.
22855
22863
  4. **Always record what happened**: After handling a failure, briefly note the outcome in your report to the user.`;