brainclaw 1.22.0 → 1.23.0

package/dist/cli/register-capture.js

@@ -1,3 +1,4 @@
+import { runMemoryConfirm } from '../commands/memory-confirm.js';
 import { runDecision } from '../commands/decision.js';
 import { runConstraint } from '../commands/constraint.js';
 import { runTrap } from '../commands/trap.js';
@@ -205,5 +206,19 @@ export function registerCaptureCommands(program) {
         .action((options) => {
         runRuntimeStatus(options);
     });
+    // --- confirm (pln#620) ---
+    // La surface qui manquait a `recordMemoryEvent` : le coeur existait, teste, branche sur
+    // un schema porte par les traps/decisions/contraintes — et n'etait appele DEPUIS NULLE
+    // PART. 0 item sur 471 portait la moindre confirmation au moment ou cette commande a ete
+    // ajoutee. C'est la classe de defaut de trp#1292 : un coeur vert, une fonctionnalite inerte.
+    program
+        .command('confirm <entity> <id> <kind>')
+        .description("Attester l'applicabilite d'un item de memoire : trap|decision|constraint, kind = confirm|infirm|saved_me|misled_me")
+        .option('--evidence <ref>', 'Preuve : fichier:ligne, sha de commit, sortie de commande (OBLIGATOIRE pour confirm)')
+        .option('--note <text>', 'Le « pourquoi » en une ligne')
+        .option('--json', 'Sortie JSON')
+        .action((entity, id, kind, options) => {
+        runMemoryConfirm({ entity, id, kind, evidence: options.evidence, note: options.note, json: options.json });
+    });
 }
 //# sourceMappingURL=register-capture.js.map

package/dist/commands/loops-handlers.js

@@ -302,7 +302,6 @@ export async function handleBclawLoop(options) {
                         slot_id: req.slot_id,
                         role: req.role,
                         input: req.input,
-                        dispatch: req.dispatch,
                         assignment_id: req.assignment_id,
                         claim_id: req.claim_id,
                         actor,

package/dist/commands/mcp-catalog.js

@@ -11,30 +11,11 @@
  * @module
  */
 import { generatedSchemas } from './mcp-schemas.generated.js';
-const SEQUENCE_ITEM_INPUT_SCHEMA = {
-    type: 'object',
-    description: 'Sequence lane item. planId is required; stepId optionally narrows dispatch/readiness to a specific plan step.',
-    properties: {
-        planId: { type: 'string', minLength: 1, description: 'Plan item ID referenced by this sequence item.' },
-        stepId: { type: 'string', minLength: 1, description: 'Optional plan step ID inside planId for step-level dispatch/readiness.' },
-        rank: { type: 'number', minimum: 1, description: 'Positive integer ordering key. Ranks must be unique within a sequence.' },
-        hard_after: {
-            type: 'array',
-            items: { type: 'string' },
-            description: 'Sequence item planId values that must complete before this item becomes ready.',
-        },
-        soft_after: {
-            type: 'array',
-            items: { type: 'string' },
-            description: 'Advisory predecessor planId values; they inform ordering but do not block readiness.',
-        },
-        lane: { type: 'string', description: 'Optional lane label used for parallel dispatch grouping and filtering.' },
-        scope_hint: { type: 'string', description: 'Optional file/path scope hint for claim and brief generation.' },
-        rationale: { type: 'string', description: 'Optional explanation for this item or dependency placement.' },
-    },
-    required: ['planId', 'rank'],
-    additionalProperties: false,
-};
+// SEQUENCE_ITEM_INPUT_SCHEMA a ete RETIRE (pln#599 batch 2). Ce sous-schema JSON manuel
+// etait reutilise par create_sequence et update_sequence ; il est desormais derive d'une
+// source zod UNIQUE (src/core/sequence-request-schema.ts) et materialise dans
+// mcp-schemas.generated.ts. C'est exactement la classe de defaut de trp#180 — un
+// sous-schema duplique, corrige d'un cote seulement — qui disparait avec lui.
 const { $defs: loopPhaseDefs, ...loopPhaseItemSchema } = generatedSchemas.LoopPhase;
 const loopSlotInputItemSchema = generatedSchemas.LoopSlotInput;
 export const MCP_READ_TOOLS = [
@@ -159,21 +140,7 @@ export const MCP_READ_TOOLS = [
         name: 'bclaw_assignment_events',
         description: 'List correlated runtime events for assignments and runs with filters on assignment, run, claim, session, agent, or event type.',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                assignmentId: { type: 'string', description: 'Filter by linked assignment ID.' },
-                runId: { type: 'string', description: 'Filter by linked run ID.' },
-                claimId: { type: 'string', description: 'Filter by linked claim ID.' },
-                sessionId: { type: 'string', description: 'Filter by runtime session ID.' },
-                agent: { type: 'string', description: 'Filter by agent name.' },
-                eventType: { type: 'string', description: 'Filter by runtime event type.' },
-                id: { type: 'string', description: 'Get a single runtime event by ID.' },
-                limit: { type: 'number', description: 'Maximum number of events to return (default: 20).' },
-                offset: { type: 'number', description: 'Number of events to skip (for pagination).' },
-                compact: { type: 'boolean', description: 'Return only key fields to reduce output size.' },
-            },
-        },
+        inputSchema: { ...generatedSchemas.AssignmentEventsRequest },
     },
     {
         name: 'bclaw_list_agents',
@@ -553,36 +520,18 @@ const MCP_WRITE_TOOLS = [
     {
         name: 'bclaw_write_note',
         description: 'Add a runtime note. Requires contributor trust level or above. Use crossProject to push a runtime-note signal to a linked project (requires role: publisher in cross_project_links config).',
-        annotations: { tier: 'standard', category: 'memory', headlessApproval: 'auto' },
+        annotations: { tier: 'standard', category: 'memory', headlessApproval: 'auto', schemaSource: 'zod-derived' },
         inputSchema: {
-            type: 'object',
-            properties: {
-                text: { type: 'string', description: 'Note content.' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-                tags: { type: 'array', items: { type: 'string' }, description: 'Optional tags.' },
-                visibility: { type: 'string', description: 'Visibility: shared, machine, private.' },
-                ttl: { type: 'string', description: 'Optional TTL: 30m, 2h, 7d.' },
-                autoReflect: { type: 'boolean', description: 'Attempt to reflect the runtime note into durable memory immediately.' },
-                crossProject: { type: 'string', description: 'Push note to a linked project (name or path). Requires role: publisher in cross_project_links config.' },
-                cross_project: { type: 'string', description: 'Snake_case alias of crossProject.' },
-            },
+            ...generatedSchemas.WriteNoteRequest,
             required: ['text'],
         },
     },
     {
         name: 'bclaw_quick_capture',
         description: 'Capture free-form text as a decision, trap, constraint, or runtime note. Declare `type` yourself (you know what you are capturing — caller assertion wins); keyword heuristics are only a fallback when type is absent. Contradictions with existing memory are attached as advisory metadata on the candidate, never block promotion.',
-        annotations: { tier: 'standard', category: 'memory', headlessApproval: 'auto' },
+        annotations: { tier: 'standard', category: 'memory', headlessApproval: 'auto', schemaSource: 'zod-derived' },
         inputSchema: {
-            type: 'object',
-            properties: {
-                text: { type: 'string', description: 'Free-form capture text.' },
-                type: { type: 'string', enum: ['decision', 'trap', 'constraint', 'note'], description: 'Caller-asserted classification. Strongly recommended — the calling agent knows the nature of the capture better than keyword heuristics (cnd_abe61d68: 18 false contradiction positives on a review summary).' },
-                context: { type: 'string', description: 'Optional file/path/scope context to associate with the capture.' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-            },
+            ...generatedSchemas.QuickCaptureRequest,
             required: ['text'],
         },
     },
@@ -590,116 +539,41 @@ const MCP_WRITE_TOOLS = [
         name: 'bclaw_claim',
         description: 'Claim a work scope (advisory lock). By default creates an isolated git worktree for the claim (multi-agent safety). Pass advisory:true (or worktree:false) for an advisory-only lock with NO worktree — use this when the work already lives uncommitted in the main tree and a fresh worktree would be counterproductive (trp#431). Requires contributor trust level or above.',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                scope: { type: 'string', description: 'Scope being claimed.' },
-                description: { type: 'string', description: 'Description of the work.' },
-                agent: { type: 'string', description: 'Agent or person name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-                planId: { type: 'string', description: 'Optional linked plan item ID.' },
-                project: { type: 'string', description: 'Project name or path. Use this when working on a project different from the MCP server workspace (e.g. CLI agents in a different directory).' },
-                store: { type: 'string', description: 'Target store level: local (default), repo, workspace.' },
-                worktreeBranch: { type: 'string', description: 'Branch name for the worktree. Defaults to feat/<scope-slug>.' },
-                worktree: { type: 'boolean', description: 'Whether to create an isolated git worktree (default true). Pass false for an advisory-only lock with no worktree (trp#431) — for in-place work in the main tree.' },
-                advisory: { type: 'boolean', description: 'Alias for worktree:false — advisory-only lock with no worktree (trp#431).' },
-                handoffMode: { type: 'string', enum: ['self-commit', 'integrator'], description: 'Handoff mode: "self-commit" (worker commits+merges) or "integrator" (another agent reviews+merges). Default: self-commit.' },
-            },
-            required: ['scope', 'description'],
-        },
+        inputSchema: { ...generatedSchemas.ClaimRequest },
     },
     {
         name: 'bclaw_release_claim',
         description: 'Release a work claim. Callers own their own claims; a trusted+ coordinator releasing another agent\'s claim MUST pass coordinator_override:true (audited).',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'string', description: 'Claim ID to release.' },
-                planStatus: { type: 'string', description: 'Optional: update linked plan status.' },
-                coordinator_override: {
-                    type: 'boolean',
-                    description: 'Opt-in override for a trusted+ caller releasing a claim they do NOT own (cross-agent teardown, ghost-claim cleanup). Rejected for contributor-level callers; audited when used. trp#928.',
-                },
-            },
-            required: ['id'],
-        },
+        inputSchema: { ...generatedSchemas.ReleaseClaimRequest },
     },
     {
         name: 'bclaw_session_start',
         description: 'Start a session and capture initial context. Pass includeContext and/or includeBoard to get full context + agent board in a single call, eliminating the need for separate bclaw_get_context and bclaw_get_agent_board calls.',
         annotations: { tier: 'standard', category: 'session', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-                context: { type: 'string', description: 'Context target path.' },
-                maintenanceMode: { type: 'string', enum: ['fast', 'full'], description: 'Maintenance mode. Default is full for explicit session-start calls; use fast to skip non-critical maintenance work.' },
-                includeContext: { type: 'boolean', description: 'Include project memory context in the response (equivalent to bclaw_get_context).' },
-                includeBoard: { type: 'boolean', description: 'Include agent board (plans, claims, handoffs) in the response (equivalent to bclaw_get_agent_board).' },
-                contextProfile: { type: 'string', description: 'Context profile when includeContext is true: dev (default), dense, compact, copilot, quick, briefing, openclaw, ops, research. If unset, uses the agent default profile.' },
-                contextFormat: { type: 'string', description: 'Context format when includeContext is true: markdown, json, or template.' },
-            },
-        },
+        inputSchema: { ...generatedSchemas.SessionStartRequest },
     },
     {
         name: 'bclaw_session_end',
         description: 'End a session and optionally auto-reflect observations as candidates.',
         annotations: { tier: 'standard', category: 'session', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                session: { type: 'string', description: 'Session ID.' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-                summary: { type: 'string', description: 'Session summary text.' },
-                narrative: { type: 'string', description: 'Free-text narrative of what happened in the session and why. Goes beyond the auto-generated commit list: "Tried X, failed because Y, pivoted to Z. Watch out for A."' },
-                autoReflect: { type: 'boolean', description: 'Auto-reflect session notes as candidates.' },
-                autoRelease: { type: 'boolean', description: 'Auto-release any active claims at session end.' },
-                reflectHandoff: { type: 'boolean', description: 'Materialize an open handoff from git commits since session start.' },
-                dispatchReview: { type: 'boolean', description: 'When used with reflectHandoff, auto-dispatch a code review if the reflected handoff is reviewable.' },
-                reviewer: { type: 'string', description: 'Explicit reviewer for the reflected handoff review dispatch.' },
-                reflect: { type: 'boolean', description: 'Emit the dogfooding reflection prompt (project + your surfaces/skills/tools). Default true — pass false to suppress on a trivial session. Capture actionable findings via bclaw_quick_capture.' },
-            },
-        },
+        inputSchema: { ...generatedSchemas.SessionEndRequest },
     },
     {
         name: 'bclaw_create_sequence',
         description: 'Create a coordination sequence shared by agents.',
-        annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'prompt' },
+        annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'prompt', schemaSource: 'zod-derived' },
         inputSchema: {
-            type: 'object',
-            properties: {
-                name: { type: 'string', description: 'Sequence name.' },
-                description: { type: 'string', description: 'Optional sequence description.' },
-                status: { type: 'string', description: 'Status: draft, active, archived.' },
-                owner: { type: 'string', description: 'Optional sequence owner.' },
-                items: { type: 'array', description: 'Sequence items in rank order.', items: SEQUENCE_ITEM_INPUT_SCHEMA },
-                tags: { type: 'array', items: { type: 'string' }, description: 'Optional tags.' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-            },
+            ...generatedSchemas.CreateSequenceRequest,
             required: ['name'],
         },
     },
     {
         name: 'bclaw_update_sequence',
         description: 'Update a coordination sequence status, metadata, or items.',
-        annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'prompt' },
+        annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'prompt', schemaSource: 'zod-derived' },
         inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'string', description: 'Sequence ID or short label.' },
-                name: { type: 'string', description: 'Optional new sequence name.' },
-                description: { type: 'string', description: 'Optional new description.' },
-                status: { type: 'string', description: 'Status: draft, active, archived.' },
-                owner: { type: 'string', description: 'Optional sequence owner.' },
-                items: { type: 'array', description: 'Optional replacement items array.', items: SEQUENCE_ITEM_INPUT_SCHEMA },
-                tags: { type: 'array', items: { type: 'string' }, description: 'Optional replacement tags.' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-            },
+            ...generatedSchemas.UpdateSequenceRequest,
             required: ['id'],
         },
     },
@@ -707,82 +581,25 @@ const MCP_WRITE_TOOLS = [
         name: 'bclaw_add_step',
         description: 'Add a sub-step to a plan item. Canonical shape is `{ planId, data: { text, title?, assignee? } }`; legacy top-level `{ text, assignee }` still works for backward compatibility. If both are present, data.* wins and a warning is emitted. Requires contributor trust level or above. Pass `project` to target a step in a plan that lives in a linked project (same pattern as the canonical-grammar tools).',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                planId: { type: 'string', description: 'Plan item ID.' },
-                data: {
-                    type: 'object',
-                    description: 'Canonical step payload: { text, title?, assignee? }. title is accepted as an alias for text.',
-                    properties: {
-                        text: { type: 'string', description: 'Step description.' },
-                        title: { type: 'string', description: 'Alias for text.' },
-                        assignee: { type: 'string', description: 'Optional assignee.' },
-                        estimated_effort: { type: 'number', description: 'Step-level estimate in minutes (pln#495). A duration string like "2h"/"30m" is also accepted and coerced.' },
-                        actual_effort: { type: 'string', description: 'Step-level actual effort, free-form ("45m", "2h"), parsed when the estimation report runs.' },
-                    },
-                },
-                text: { type: 'string', description: 'Legacy top-level step description; prefer data.text.' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-                assignee: { type: 'string', description: 'Legacy top-level optional assignee; prefer data.assignee.' },
-                project: { type: 'string', description: 'Optional: name (or path/basename) of a linked project to add the step in. Defaults to the current project. Same resolution as canonical-grammar tools — accepts cross_project_links and workspace store-chain children.' },
-            },
-            required: ['planId'],
-        },
+        inputSchema: { ...generatedSchemas.AddStepRequest },
     },
     {
         name: 'bclaw_complete_step',
         description: 'Mark a plan sub-step as done. Requires contributor trust level or above. Pass `project` to operate on a plan in a linked project.',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                planId: { type: 'string', description: 'Plan item ID.' },
-                stepId: { type: 'string', description: 'Step ID to complete.' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-                project: { type: 'string', description: 'Optional: name of a linked project to complete the step in. Defaults to the current project.' },
-            },
-            required: ['planId', 'stepId'],
-        },
+        inputSchema: { ...generatedSchemas.CompleteStepRequest },
     },
     {
         name: 'bclaw_update_step',
         description: 'Update a plan sub-step (status, text, assignee). Supports all step statuses: todo, in_progress, testing, done, blocked. Requires contributor trust level or above. Pass `project` to operate on a plan in a linked project.',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                planId: { type: 'string', description: 'Plan item ID.' },
-                stepId: { type: 'string', description: 'Step ID to update.' },
-                status: { type: 'string', description: 'New status: todo, in_progress, testing, done, blocked.' },
-                text: { type: 'string', description: 'New step text.' },
-                assignee: { type: 'string', description: 'New assignee (empty string to unassign).' },
-                estimated_effort: { type: 'number', description: 'Step-level estimate in minutes (pln#495); a duration string is also coerced.' },
-                actual_effort: { type: 'string', description: 'Step-level actual effort, free-form ("45m", "2h").' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-                project: { type: 'string', description: 'Optional: name of a linked project to update the step in. Defaults to the current project.' },
-            },
-            required: ['planId', 'stepId'],
-        },
+        inputSchema: { ...generatedSchemas.UpdateStepRequest },
     },
     {
         name: 'bclaw_delete_step',
         description: 'Remove a sub-step from a plan. Requires contributor trust level or above. Pass `project` to operate on a plan in a linked project.',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'prompt' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                planId: { type: 'string', description: 'Plan item ID.' },
-                stepId: { type: 'string', description: 'Step ID to delete.' },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-                project: { type: 'string', description: 'Optional: name of a linked project to delete the step from. Defaults to the current project.' },
-            },
-            required: ['planId', 'stepId'],
-        },
+        inputSchema: { ...generatedSchemas.DeleteStepRequest },
     },
     {
         name: 'bclaw_delete_plan',
@@ -1076,62 +893,13 @@ const MCP_WRITE_TOOLS = [
         name: 'bclaw_assignment_update',
         description: 'Report assignment lifecycle status. Part of the Agent SDK runtime protocol. Workers call this to report: accepted (acknowledging receipt), started (work begun), progress (heartbeat), completed (done with artifacts), failed (error), or blocked (external blocker). The assignment_id is provided in the dispatch brief. OWNERSHIP (trp#291): only the agent the assignment is OWNED BY (the dispatched worker) may update it — a different agent (e.g. the coordinator) gets `Agent <x> cannot update assignment owned by <y>`. If you are the coordinator and need to converge a worker run, do NOT call this; verify via bclaw_dispatch_status instead (the reconciler infers completion from sentinels/commits).',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                assignment_id: { type: 'string', description: 'Assignment ID from the dispatch brief (asgn_xxx).' },
-                status: { type: 'string', enum: ['accepted', 'started', 'progress', 'completed', 'failed', 'blocked'], description: 'Lifecycle status to report.' },
-                message: { type: 'string', description: 'Human-readable status message or progress note.' },
-                artifacts: {
-                    type: 'array',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            type: { type: 'string', description: 'Artifact type: commit, branch, file, pr, test_result.' },
-                            ref: { type: 'string', description: 'Reference: SHA, branch name, file path, PR URL.' },
-                            description: { type: 'string', description: 'Optional description.' },
-                        },
-                        required: ['type', 'ref'],
-                    },
-                    description: 'Artifacts produced. Most useful for completed status.',
-                },
-                error_message: { type: 'string', description: 'Error details (for failed status).' },
-                blocker: { type: 'string', description: 'Blocker description (for blocked status).' },
-                action_required: {
-                    type: 'object',
-                    description: 'Optional ActionRequired payload when status=blocked. Lets the worker request approval, user input, or clarification before resuming.',
-                    properties: {
-                        kind: { type: 'string', enum: ['approval', 'user_input', 'clarification', 'plan_approval'], description: 'Kind of action needed.' },
-                        title: { type: 'string', description: 'Short title shown to supervisors/UI.' },
-                        prompt: { type: 'string', description: 'Question or approval prompt to answer.' },
-                        options: { type: 'array', items: { type: 'string' }, description: 'Optional answer choices.' },
-                        response_schema: { type: 'object', description: 'Optional structured response schema hint.' },
-                        tags: { type: 'array', items: { type: 'string' }, description: 'Optional tags.' },
-                    },
-                    required: ['kind', 'title', 'prompt'],
-                },
-                agent: { type: 'string', description: 'Agent name.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-            },
-            required: ['assignment_id', 'status'],
-        },
+        inputSchema: { ...generatedSchemas.AssignmentUpdateRequest },
     },
     {
         name: 'bclaw_assignment_action',
         description: 'Resolve or reject a pending ActionRequired item and update the linked Assignment/AgentRun state.',
         annotations: { tier: 'standard', category: 'coordination', headlessApproval: 'auto' },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action_id: { type: 'string', description: 'ActionRequired ID (act_xxx).' },
-                outcome: { type: 'string', enum: ['resolved', 'rejected', 'cancelled'], description: 'How the supervisor resolves the pending action.' },
-                text: { type: 'string', description: 'Human-readable response or rationale.' },
-                payload: { type: 'object', description: 'Optional structured response payload.' },
-                agent: { type: 'string', description: 'Supervisor/agent responding to the action.' },
-                agentId: { type: 'string', description: 'Registered agent id.' },
-            },
-            required: ['action_id', 'outcome'],
-        },
+        inputSchema: { ...generatedSchemas.AssignmentActionRequest },
     },
     {
         name: 'bclaw_harvest_candidates',

package/dist/commands/mcp-read-handlers.js

@@ -737,7 +737,11 @@ function dispatchReadTool(name, args, ctx) {
                 ...(bounded.next_offset !== undefined ? { next_offset: bounded.next_offset } : {}),
                 ...(bounded.omitted_for_size ? { omitted_for_size: bounded.omitted_for_size } : {}),
                 ...(bounded.hint ? { hint: bounded.hint } : {}),
-                next_actions: nextActions,
+                // OMETTRE la cle plutot que rendre un tableau vide (pln#598 etape 4). La regle de
+                // src/core/next-actions.ts est explicite : « les appelants omettent entierement la
+                // cle quand le tableau est vide ». Un next_actions vide est le pire des deux
+                // mondes — le champ existe, ne dit rien, et apprend quand meme a l ignorer.
+                ...(nextActions.length ? { next_actions: nextActions } : {}),
             },
         };
     }