@femtomc/mu-agent 26.2.73 → 26.2.74

package/dist/operator.js

@@ -1,4 +1,4 @@
-import { appendJsonl } from "@femtomc/mu-core/node";
+import { appendJsonl, readJsonl } from "@femtomc/mu-core/node";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { z } from "zod";
@@ -183,6 +183,106 @@ function buildOperatorFailureFallbackMessage(code) {
 function conversationKey(inbound, binding) {
     return `${inbound.channel}:${inbound.channel_tenant_id}:${inbound.channel_conversation_id}:${binding.binding_id}`;
 }
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function nonEmptyString(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function finiteInt(value) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return null;
+    }
+    return Math.trunc(value);
+}
+function stringList(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const out = [];
+    for (const item of value) {
+        const parsed = nonEmptyString(item);
+        if (parsed) {
+            out.push(parsed);
+        }
+    }
+    return out;
+}
+function sessionFlashPath(repoRoot) {
+    return join(repoRoot, ".mu", "control-plane", "session_flash.jsonl");
+}
+async function loadPendingSessionFlashes(opts) {
+    const rows = await readJsonl(sessionFlashPath(opts.repoRoot));
+    const created = new Map();
+    const delivered = new Set();
+    for (const row of rows) {
+        const rec = asRecord(row);
+        if (!rec) {
+            continue;
+        }
+        const kind = nonEmptyString(rec.kind);
+        if (kind === "session_flash.create") {
+            const tsMs = finiteInt(rec.ts_ms) ?? Date.now();
+            const flashId = nonEmptyString(rec.flash_id);
+            const sessionId = nonEmptyString(rec.session_id);
+            const body = nonEmptyString(rec.body);
+            if (!flashId || !sessionId || !body || sessionId !== opts.sessionId) {
+                continue;
+            }
+            created.set(flashId, {
+                flash_id: flashId,
+                created_at_ms: tsMs,
+                session_id: sessionId,
+                session_kind: nonEmptyString(rec.session_kind),
+                body,
+                context_ids: stringList(rec.context_ids),
+                source: nonEmptyString(rec.source),
+                metadata: asRecord(rec.metadata) ?? {},
+            });
+            continue;
+        }
+        if (kind === "session_flash.delivery") {
+            const flashId = nonEmptyString(rec.flash_id);
+            const sessionId = nonEmptyString(rec.session_id);
+            if (!flashId || !sessionId || sessionId !== opts.sessionId) {
+                continue;
+            }
+            delivered.add(flashId);
+        }
+    }
+    const pending = [...created.values()]
+        .filter((row) => !delivered.has(row.flash_id))
+        .sort((a, b) => a.created_at_ms - b.created_at_ms);
+    const limit = Math.max(1, Math.trunc(opts.limit ?? 16));
+    if (pending.length <= limit) {
+        return pending;
+    }
+    return pending.slice(pending.length - limit);
+}
+async function markSessionFlashesDelivered(opts) {
+    if (opts.flashIds.length === 0) {
+        return;
+    }
+    const deduped = [...new Set(opts.flashIds.filter((id) => id.trim().length > 0))];
+    for (const flashId of deduped) {
+        const row = {
+            kind: "session_flash.delivery",
+            ts_ms: opts.nowMs,
+            flash_id: flashId,
+            session_id: opts.sessionId,
+            delivered_by: "messaging_operator_runtime",
+            note: null,
+        };
+        await appendJsonl(sessionFlashPath(opts.repoRoot), row);
+    }
+}
 export class JsonFileConversationSessionStore {
     #path;
     #loaded = false;
@@ -323,14 +423,46 @@ export class MessagingOperatorRuntime {
                 operatorTurnId: turnId,
             };
         }
+        let pendingFlashes = [];
+        try {
+            pendingFlashes = await loadPendingSessionFlashes({
+                repoRoot: opts.inbound.repo_root,
+                sessionId,
+            });
+        }
+        catch {
+            pendingFlashes = [];
+        }
+        const inboundForBackend = pendingFlashes.length > 0
+            ? {
+                ...opts.inbound,
+                metadata: {
+                    ...opts.inbound.metadata,
+                    session_flash_messages: pendingFlashes,
+                },
+            }
+            : opts.inbound;
         let backendResult;
         try {
             backendResult = OperatorBackendTurnResultSchema.parse(await this.#backend.runTurn({
                 sessionId,
                 turnId,
-                inbound: opts.inbound,
+                inbound: inboundForBackend,
                 binding: opts.binding,
             }));
+            if (pendingFlashes.length > 0) {
+                try {
+                    await markSessionFlashesDelivered({
+                        repoRoot: opts.inbound.repo_root,
+                        sessionId,
+                        flashIds: pendingFlashes.map((row) => row.flash_id),
+                        nowMs: Date.now(),
+                    });
+                }
+                catch {
+                    // Best-effort delivery bookkeeping; do not fail the operator turn.
+                }
+            }
         }
         catch (err) {
             return {
@@ -385,15 +517,115 @@ export class MessagingOperatorRuntime {
 }
 export { DEFAULT_OPERATOR_SYSTEM_PROMPT };
 const COMMAND_TOOL_NAME = "command";
+const OPERATOR_PROMPT_CONTEXT_MAX_CHARS = 2_500;
+function compactJsonPreview(value, maxChars = OPERATOR_PROMPT_CONTEXT_MAX_CHARS) {
+    let raw = "";
+    if (typeof value === "string") {
+        raw = value;
+    }
+    else {
+        try {
+            raw = JSON.stringify(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    const compact = raw.replace(/\s+/g, " ").trim();
+    if (compact.length === 0) {
+        return null;
+    }
+    if (compact.length <= maxChars) {
+        return compact;
+    }
+    const keep = Math.max(1, maxChars - 1);
+    return `${compact.slice(0, keep)}…`;
+}
+function extractPromptContext(metadata) {
+    for (const key of ["client_context", "context", "editor_context"]) {
+        if (!(key in metadata)) {
+            continue;
+        }
+        const value = metadata[key];
+        if (value == null) {
+            continue;
+        }
+        if (typeof value === "object" || typeof value === "string") {
+            return value;
+        }
+    }
+    return null;
+}
+function buildOperatorPromptContextBlock(metadata) {
+    const context = extractPromptContext(metadata);
+    if (!context) {
+        return [];
+    }
+    const preview = compactJsonPreview(context);
+    if (!preview) {
+        return [];
+    }
+    return ["", "Client context (structured preview):", preview];
+}
+function extractSessionFlashPromptMessages(metadata) {
+    const raw = metadata.session_flash_messages;
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    const out = [];
+    for (const value of raw) {
+        const rec = asRecord(value);
+        if (!rec) {
+            continue;
+        }
+        const flashId = nonEmptyString(rec.flash_id);
+        const body = nonEmptyString(rec.body);
+        const sessionId = nonEmptyString(rec.session_id);
+        if (!flashId || !body || !sessionId) {
+            continue;
+        }
+        out.push({
+            flash_id: flashId,
+            created_at_ms: finiteInt(rec.created_at_ms) ?? 0,
+            session_id: sessionId,
+            session_kind: nonEmptyString(rec.session_kind),
+            body,
+            context_ids: stringList(rec.context_ids),
+            source: nonEmptyString(rec.source),
+            metadata: asRecord(rec.metadata) ?? {},
+        });
+    }
+    out.sort((a, b) => a.created_at_ms - b.created_at_ms);
+    return out;
+}
+function buildOperatorPromptFlashBlock(metadata) {
+    const flashes = extractSessionFlashPromptMessages(metadata);
+    if (flashes.length === 0) {
+        return [];
+    }
+    const lines = ["", `Session flash messages (${flashes.length}):`];
+    for (const flash of flashes) {
+        const source = flash.source ?? "unknown";
+        const contextIds = flash.context_ids.length > 0 ? ` | context_ids=${flash.context_ids.join(",")}` : "";
+        const bodyPreview = compactJsonPreview(flash.body, 400) ?? flash.body;
+        lines.push(`- [${flash.flash_id}] source=${source}${contextIds}`);
+        lines.push(`  ${bodyPreview}`);
+    }
+    lines.push("Treat these as high-priority user-provided context for this session.");
+    return lines;
+}
 function buildOperatorPrompt(input) {
-    return [
+    const lines = [
         `[Messaging context]`,
         `channel: ${input.inbound.channel}`,
         `request_id: ${input.inbound.request_id}`,
         `repo_root: ${input.inbound.repo_root}`,
         ``,
         `User message: ${input.inbound.command_text}`,
-    ].join("\n");
+        ...buildOperatorPromptContextBlock(input.inbound.metadata),
+        ...buildOperatorPromptFlashBlock(input.inbound.metadata),
+    ];
+    return lines.join("\n");
 }
 function sessionFileStem(sessionId) {
     const normalized = sessionId.trim().replace(/[^a-zA-Z0-9._-]+/g, "-");
@@ -430,7 +662,7 @@ export class PiMessagingOperatorBackend {
         this.#persistSessions = opts.persistSessions ?? true;
         this.#sessionDirForRepoRoot =
             opts.sessionDirForRepoRoot ?? ((repoRoot) => join(repoRoot, ".mu", "control-plane", "operator-sessions"));
-        // Command execution routes through the server command pipeline via command.
+        // Operator turns can emit structured command proposals captured from tool events.
     }
     #disposeSession(sessionId) {
         const entry = this.#sessions.get(sessionId);

package/dist/session_factory.d.ts

@@ -23,6 +23,11 @@ export type MuSession = {
     agent: {
         waitForIdle: () => Promise<void>;
     };
+    sessionId?: string;
+    sessionFile?: string;
+    sessionManager?: {
+        getLeafId?: () => string | null;
+    };
 };
 export declare function createMuSession(opts: CreateMuSessionOpts): Promise<MuSession>;
 //# sourceMappingURL=session_factory.d.ts.map

package/dist/session_factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session_factory.d.ts","sourceRoot":"","sources":["../src/session_factory.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG;IACtC,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CAC5C,CAAC;AAkCF,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2CnF"}
+{"version":3,"file":"session_factory.d.ts","sourceRoot":"","sources":["../src/session_factory.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG;IACtC,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACF,CAAC;AAkCF,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2CnF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-agent",
-  "version": "26.2.73",
+  "version": "26.2.74",
   "description": "Shared agent runtime for mu chat, orchestration roles, and serve extensions.",
   "keywords": [
     "mu",
@@ -24,11 +24,10 @@
     "themes/**"
   ],
   "dependencies": {
-    "@femtomc/mu-core": "26.2.73",
+    "@femtomc/mu-core": "26.2.74",
     "@mariozechner/pi-agent-core": "^0.53.0",
     "@mariozechner/pi-ai": "^0.53.0",
     "@mariozechner/pi-coding-agent": "^0.53.0",
-    "@sinclair/typebox": "^0.34.0",
     "zod": "^4.1.9"
   }
 }

package/prompts/roles/operator.md

@@ -5,39 +5,34 @@ Mission:
 - Help users with any coding tasks they ask you to handle directly.
 - Help users inspect repository/control-plane state.
 - Help users choose safe next actions.
-- When needed, execute approved mutations using the `command` tool.
+- Execute reads and mutations through direct `mu` CLI invocation when managing mu state.
 
 Available tools:
 - read: Read file contents
-- bash: Execute bash commands
+- bash: Execute shell commands (primary path for `mu` CLI)
 - edit: Make surgical edits to files
 - write: Create or overwrite files
-- query: Read-only retrieval across mu state (`action=describe|get|list|search|timeline|stats|trace`)
-- command: Approved mutation pathway (`run_*`, `reload/update`, issue/forum lifecycle, heartbeat/cron program management)
 
-Hard Constraints:
-- Never perform mutations directly through read/write tools.
-- Mutating actions must flow through the `command` tool.
-- Use structured tool arguments; do not emit raw JSON directives in normal text replies.
+CLI-first workflow:
+- Use `bash` + `mu ...` for issue/forum/run/control-plane state operations.
+- Prefer `--pretty` (or `--json` + targeted parsing) for clear, auditable output.
+- Do not use bespoke query/command wrappers; call the CLI surface directly.
 
-command tool usage:
-- `command({ kind: "run_start", prompt: "ship release" })`
-- `command({ kind: "run_resume", root_issue_id: "mu-abc123", max_steps: 25 })`
-- `command({ kind: "issue_close", id: "mu-abc123", outcome: "success" })`
-- `command({ kind: "forum_post", topic: "issue:mu-abc123", body: "done", author: "operator" })`
-- `command({ kind: "heartbeat_create", title: "Run heartbeat", target_kind: "run", run_root_issue_id: "mu-abc123", every_ms: 15000 })`
-- `command({ kind: "cron_create", title: "Nightly resume", target_kind: "run", run_root_issue_id: "mu-abc123", schedule_kind: "cron", expr: "0 2 * * *", tz: "UTC" })`
-- `command({ kind: "reload" })`
+Example invocation patterns:
+- `bash("mu status --pretty")`
+- `bash("mu issues list --status open --limit 20 --pretty")`
+- `bash("mu forum read issue:mu-abc123 --limit 20 --pretty")`
+- `bash("mu runs start \"ship release\" --max-steps 25 --pretty")`
+- `bash("mu issues close mu-abc123 --outcome success --pretty")`
+- `bash("mu forum post issue:mu-abc123 -m \"done\" --author operator --pretty")`
+- `bash("mu control reload --pretty")`
 
-query tool usage:
-- Start with `query({ action: "describe" })` when capability discovery is needed.
-- Use narrow retrieval first (`limit` + filters), then targeted `get` with `id` + `fields`.
-- Prefer precise context windows via `query({ action: "search"|"timeline", resource: "context", ... })`.
-
-Efficiency:
+Guardrails:
+- Never hand-edit `.mu/*.jsonl` for normal lifecycle actions; use `mu` CLI commands.
+- Prefer bounded retrieval (`--limit`, scoped filters) before broad scans.
 - Do NOT pre-fetch status/issues/events/runs at conversation start.
 - Fetch only what the user request requires.
-- Keep responses grounded in concrete tool results.
+- Keep responses grounded in concrete command results.
 
 For normal answers:
 - Respond in plain text (no directive prefix).

package/prompts/roles/orchestrator.md

@@ -7,9 +7,9 @@ Mission:
 - Move planning state forward by closing expanded planning nodes.
 
 Available tools:
-- query: Read-only retrieval
-- command: Mutation pathway
-- bash/read are available, but prefer query/command for issue/forum state changes.
+- bash: Execute commands (use `mu` CLI for issue/forum reads + mutations)
+- read: Read repository files when needed for planning context
+- edit/write: available but forbidden for orchestrator execution (planning only)
 
 Hard Constraints:
 1. You MUST NOT execute work directly. No code changes, no file edits, no git commits.
@@ -22,20 +22,19 @@ If the task looks atomic, create exactly one worker child issue rather than doin
 
 Workflow:
 1. Inspect context:
-   - `query({ action: "get", resource: "issues", id: "<id>" })`
-   - `query({ action: "list", resource: "forum_messages", topic: "issue:<id>", limit: 20 })`
-   - `query({ action: "list", resource: "issues", contains: "<id>", limit: 200 })` (or targeted child lookup via CLI if needed)
+   - `bash("mu issues get <id> --pretty")`
+   - `bash("mu forum read issue:<id> --limit 20 --pretty")`
+   - `bash("mu issues children <id> --pretty")` (or `mu issues list --root <id> --pretty`)
 2. Decompose into worker issues:
-   - `command({ kind: "issue_create", title: "<title>", body: "<body>", tags: "node:agent,role:worker", parent_id: "<id>" })`
+   - `bash("mu issues create \"<title>\" --body \"<body>\" --tags \"node:agent,role:worker\" --parent <id> --pretty")`
 3. Add ordering where needed:
-   - `command({ kind: "issue_dep", src_id: "<src>", dep_type: "blocks", dst_id: "<dst>" })`
+   - `bash("mu issues dep <src> blocks <dst> --pretty")`
 4. Close yourself:
-   - `command({ kind: "issue_close", id: "<id>", outcome: "expanded" })`
-   - (CLI equivalent: `mu issues close <id> --outcome expanded`)
+   - `bash("mu issues close <id> --outcome expanded --pretty")`
 
 Guardrails:
 - The only valid orchestrator close outcome is `expanded`.
 - Never close with `success`, `failure`, `needs_work`, or `skipped`.
 - Keep plans small, explicit, and testable.
 - Plans should include proposed evidence for successful completion.
-- Prefer bounded reads (`limit`, scoped filters) before deep inspection.
+- Prefer bounded reads (`--limit`, scoped filters) before deep inspection.

package/prompts/roles/reviewer.md

@@ -7,10 +7,8 @@ Mission:
 
 Available tools:
 - read: Read files and logs
-- bash: Run validation commands
+- bash: Run validation commands (including `mu` CLI for issue/forum actions)
 - edit/write: available but avoid changing implementation directly
-- query: Read-only retrieval
-- command: Mutation pathway
 
 Hard Constraints:
 - Do NOT create child issues. Refinement scheduling is orchestrator-owned.
@@ -19,15 +17,15 @@ Hard Constraints:
 
 Workflow:
 1. Inspect:
-   - `query({ action: "get", resource: "issues", id: "<id>" })`
-   - `query({ action: "list", resource: "forum_messages", topic: "issue:<id>", limit: 20 })`
+   - `bash("mu issues get <id> --pretty")`
+   - `bash("mu forum read issue:<id> --limit 20 --pretty")`
 2. Verify:
    - Re-run relevant tests/checks, inspect changed files/logs.
 3. Decide:
-   - Accept: `command({ kind: "issue_close", id: "<id>", outcome: "success" })`
-   - Refine: `command({ kind: "issue_close", id: "<id>", outcome: "needs_work" })`
+   - Accept: `bash("mu issues close <id> --outcome success --pretty")`
+   - Refine: `bash("mu issues close <id> --outcome needs_work --pretty")`
 4. Post rationale:
-   - `command({ kind: "forum_post", topic: "issue:<id>", body: "<evidence + rationale>", author: "reviewer" })`
+   - `bash("mu forum post issue:<id> -m \"<evidence + rationale>\" --author reviewer --pretty")`
 
 Guardrails:
 - Use concrete evidence (commands/tests) over opinion.

package/prompts/roles/worker.md

@@ -7,11 +7,9 @@ Mission:
 
 Available tools:
 - read: Read file contents
-- bash: Execute bash commands
+- bash: Execute commands (including direct `mu` CLI reads/mutations)
 - edit: Make surgical edits to files
 - write: Create or overwrite files
-- query: Read-only retrieval
-- command: Mutation pathway
 
 Hard Constraints:
 - Do NOT create child issues — that is the orchestrator's job.
@@ -19,19 +17,19 @@ Hard Constraints:
 
 Workflow:
 1. Inspect:
-   - `query({ action: "get", resource: "issues", id: "<id>" })`
-   - `query({ action: "list", resource: "forum_messages", topic: "issue:<id>", limit: 20 })`
+   - `bash("mu issues get <id> --pretty")`
+   - `bash("mu forum read issue:<id> --limit 20 --pretty")`
 2. Implement:
    - Edit files and run commands needed for this issue only.
 3. Verify:
    - Run tests/typecheck/build/lint as appropriate.
 4. Close:
-   - `command({ kind: "issue_close", id: "<id>", outcome: "success" })` (or `failure` / `skipped` / `needs_work` when warranted)
+   - `bash("mu issues close <id> --outcome success --pretty")` (or `failure` / `skipped` / `needs_work` when warranted)
 5. Log key notes:
-   - `command({ kind: "forum_post", topic: "issue:<id>", body: "...", author: "worker" })`
+   - `bash("mu forum post issue:<id> -m \"...\" --author worker --pretty")`
 
 Guardrails:
 - Prefer concrete evidence over claims (test output, build output, repro checks).
 - Report what changed and why.
-- Keep command output focused: use bounded reads first (`limit`, scoped filters) and drill into specific IDs/files next.
+- Keep command output focused: use bounded reads first (`--limit`, scoped filters) and drill into specific IDs/files next.
 - Be concise.

package/dist/extensions/mu-tools.d.ts

@@ -1,9 +0,0 @@
-/**
- * mu-tools — Tool-only extension bundle for non-interactive roles.
- *
- * Registers `query` (read) and `command` (mutation).
- */
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare function muToolsExtension(pi: ExtensionAPI): void;
-export default muToolsExtension;
-//# sourceMappingURL=mu-tools.d.ts.map

package/dist/extensions/mu-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mu-tools.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAIlE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,QAGhD;AAED,eAAe,gBAAgB,CAAC"}

package/dist/extensions/mu-tools.js

@@ -1,12 +0,0 @@
-/**
- * mu-tools — Tool-only extension bundle for non-interactive roles.
- *
- * Registers `query` (read) and `command` (mutation).
- */
-import { operatorCommandExtension } from "./operator-command.js";
-import { queryExtension } from "./query.js";
-export function muToolsExtension(pi) {
-    queryExtension(pi);
-    operatorCommandExtension(pi);
-}
-export default muToolsExtension;

package/dist/extensions/operator-command.d.ts

@@ -1,13 +0,0 @@
-/**
- * command — Approved mutation tool.
- *
- * Single execution path:
- * - Requires MU_SERVER_URL.
- * - Always POSTs to /api/commands/submit.
- * - Supports mutation-capable command kinds only.
- */
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare const COMMAND_TOOL_NAME = "command";
-export declare function operatorCommandExtension(pi: ExtensionAPI): void;
-export default operatorCommandExtension;
-//# sourceMappingURL=operator-command.d.ts.map

package/dist/extensions/operator-command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"operator-command.d.ts","sourceRoot":"","sources":["../../src/extensions/operator-command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AA2H3C,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,QA6FxD;AAED,eAAe,wBAAwB,CAAC"}