@femtomc/mu-agent 26.2.102 → 26.2.103

package/README.md

@@ -22,7 +22,7 @@ These are loaded by runtime code and are the single source of truth for default
 ## Bundled starter skills
 
 Bundled starter skills live under `packages/agent/prompts/skills/` and are bootstrapped
-into `~/.mu/skills/` (or `$MU_HOME/skills/`) when missing:
+into `~/.mu/skills/` (or `$MU_HOME/skills/`) by the CLI store-initialization path:
 
 - `mu`
 - `memory`
@@ -36,9 +36,10 @@ into `~/.mu/skills/` (or `$MU_HOME/skills/`) when missing:
 - `setup-discord`
 - `setup-telegram`
 - `setup-neovim`
+- `writing`
 
-Starter skills are version-synced by the CLI bootstrap path when users run `mu`
-commands after upgrading.
+Starter skills are version-synced by CLI bootstrap. Initial bootstrap seeds missing
+skills; bundled-version changes refresh installed starter skill files.
 
 ## Install
 

package/dist/operator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../src/operator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../src/operator.ts"],"names":[],"mappings":"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"}

package/dist/operator.js

@@ -1,5 +1,5 @@
 import { HudDocSchema, normalizeHudDocs } from "@femtomc/mu-core";
-import { appendJsonl, getStorePaths, readJsonl } from "@femtomc/mu-core/node";
+import { appendJsonl, getStorePaths } from "@femtomc/mu-core/node";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { z } from "zod";
@@ -292,93 +292,6 @@ function collectHudDocsFromToolExecutionEvent(event) {
     }
     return extractHudDocsFromToolResult(rec.result);
 }
-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(getStorePaths(repoRoot).storeDir, "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;
@@ -551,46 +464,14 @@ 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: inboundForBackend,
+                inbound: opts.inbound,
                 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) {
             const failureCode = classifyBackendFailureCode(err);
@@ -707,53 +588,6 @@ function buildOperatorPromptContextBlock(metadata) {
     }
     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) {
     const lines = [
         `[Messaging context]`,
@@ -763,7 +597,6 @@ function buildOperatorPrompt(input) {
         ``,
         `User message: ${input.inbound.command_text}`,
         ...buildOperatorPromptContextBlock(input.inbound.metadata),
-        ...buildOperatorPromptFlashBlock(input.inbound.metadata),
     ];
     return lines.join("\n");
 }

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,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,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"}
+{"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,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,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;AAsCF,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAuDnF"}

package/dist/session_factory.js

@@ -1,8 +1,11 @@
 import { createBashTool, createEditTool, createReadTool, createWriteTool } from "@mariozechner/pi-coding-agent";
 import { createMuResourceLoader, resolveModel } from "./backend.js";
 import { MU_DEFAULT_THEME_NAME, MU_DEFAULT_THEME_PATH } from "./ui_defaults.js";
+function resolveSessionPersistenceMode(sessionOpts) {
+    return sessionOpts?.mode ?? (sessionOpts?.sessionFile ? "open" : "continue-recent");
+}
 function createSessionManager(SessionManager, cwd, sessionOpts) {
-    const mode = sessionOpts?.mode ?? (sessionOpts?.sessionFile ? "open" : "continue-recent");
+    const mode = resolveSessionPersistenceMode(sessionOpts);
     const sessionDir = sessionOpts?.sessionDir;
     switch (mode) {
         case "continue-recent":
@@ -23,10 +26,13 @@ function createSessionManager(SessionManager, cwd, sessionOpts) {
 export async function createMuSession(opts) {
     const { AuthStorage, createAgentSession, SessionManager, SettingsManager } = await import("@mariozechner/pi-coding-agent");
     const authStorage = AuthStorage.create();
+    const sessionMode = resolveSessionPersistenceMode(opts.session);
+    const shouldRestoreSessionConfig = sessionMode === "open" && !opts.provider && !opts.model;
     const defaultModel = "gpt-5.3-codex";
-    const modelId = opts.model ?? defaultModel;
-    const model = resolveModel(modelId, authStorage, opts.provider);
-    if (!model) {
+    const requestedModelId = opts.model?.trim();
+    const modelId = requestedModelId && requestedModelId.length > 0 ? requestedModelId : shouldRestoreSessionConfig ? null : defaultModel;
+    const model = modelId ? resolveModel(modelId, authStorage, opts.provider) : undefined;
+    if (modelId && !model) {
         const scope = opts.provider ? ` in provider "${opts.provider}"` : "";
         throw new Error(`Model "${modelId}" not found${scope} in pi-ai registry.`);
     }
@@ -45,15 +51,22 @@ export async function createMuSession(opts) {
         createWriteTool(opts.cwd),
         createEditTool(opts.cwd),
     ];
-    const { session } = await createAgentSession({
+    const requestedThinking = opts.thinking?.trim();
+    const thinkingLevel = requestedThinking && requestedThinking.length > 0
+        ? requestedThinking
+        : shouldRestoreSessionConfig
+            ? undefined
+            : "minimal";
+    const createOpts = {
         cwd: opts.cwd,
-        model,
+        ...(model ? { model } : {}),
         tools,
-        thinkingLevel: (opts.thinking ?? "minimal"),
+        ...(thinkingLevel ? { thinkingLevel: thinkingLevel } : {}),
         sessionManager: createSessionManager(SessionManager, opts.cwd, opts.session),
         settingsManager,
         resourceLoader,
         authStorage,
-    });
+    };
+    const { session } = await createAgentSession(createOpts);
     return session;
 }

package/dist/session_turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session_turn.d.ts","sourceRoot":"","sources":["../src/session_turn.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjG,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;AACrD,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEL,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIlD;AAsQD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAyCA;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+F7B"}
+{"version":3,"file":"session_turn.d.ts","sourceRoot":"","sources":["../src/session_turn.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjG,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;AACrD,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEL,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIlD;AAuUD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAyCA;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgG7B"}

package/dist/session_turn.js

@@ -65,6 +65,29 @@ function defaultSessionDirForKind(repoRoot, sessionKind) {
             return join(storeDir, "control-plane", "operator-sessions");
     }
 }
+function normalizePathForPrefixMatch(path) {
+    return resolve(path).replaceAll("\\", "/");
+}
+function inferSessionKindFromSessionDir(repoRoot, sessionDir) {
+    const storeDir = getStorePaths(repoRoot).storeDir;
+    const normalizedSessionDir = normalizePathForPrefixMatch(sessionDir);
+    const operatorDir = normalizePathForPrefixMatch(join(storeDir, "operator", "sessions"));
+    if (normalizedSessionDir === operatorDir || normalizedSessionDir.startsWith(`${operatorDir}/`)) {
+        return "operator";
+    }
+    const cpOperatorDir = normalizePathForPrefixMatch(join(storeDir, "control-plane", "operator-sessions"));
+    if (normalizedSessionDir === cpOperatorDir || normalizedSessionDir.startsWith(`${cpOperatorDir}/`)) {
+        return "cp_operator";
+    }
+    return null;
+}
+function defaultSessionLookupTargets(repoRoot) {
+    const storeDir = getStorePaths(repoRoot).storeDir;
+    return [
+        { sessionKind: "operator", sessionDir: join(storeDir, "operator", "sessions") },
+        { sessionKind: "cp_operator", sessionDir: join(storeDir, "control-plane", "operator-sessions") },
+    ];
+}
 async function pathExists(path) {
     try {
         await stat(path);
@@ -208,9 +231,7 @@ function safeSessionFile(session) {
     return typeof value === "string" && value.trim().length > 0 ? value : null;
 }
 async function resolveSessionTarget(opts) {
-    const sessionDir = opts.request.session_dir
-        ? resolveRepoPath(opts.repoRoot, opts.request.session_dir)
-        : defaultSessionDirForKind(opts.repoRoot, opts.normalizedSessionKind);
+    const explicitSessionDir = opts.request.session_dir ? resolveRepoPath(opts.repoRoot, opts.request.session_dir) : null;
     if (opts.request.session_file) {
         const sessionFile = resolveRepoPath(opts.repoRoot, opts.request.session_file);
         if (!(await pathExists(sessionFile))) {
@@ -223,22 +244,55 @@ async function resolveSessionTarget(opts) {
         if (headerId !== opts.request.session_id) {
             throw new SessionTurnError(409, `session_file header id mismatch (expected ${opts.request.session_id}, found ${headerId})`);
         }
+        const sessionDir = explicitSessionDir ?? dirname(sessionFile);
+        return {
+            sessionFile,
+            sessionDir,
+            sessionKind: opts.normalizedSessionKind ?? inferSessionKindFromSessionDir(opts.repoRoot, sessionDir),
+        };
+    }
+    if (explicitSessionDir || opts.normalizedSessionKind) {
+        const sessionDir = explicitSessionDir ?? defaultSessionDirForKind(opts.repoRoot, opts.normalizedSessionKind);
+        if (!(await directoryExists(sessionDir))) {
+            throw new SessionTurnError(404, `session directory not found: ${sessionDir}`);
+        }
+        const sessionFile = await resolveSessionFileById({
+            sessionDir,
+            sessionId: opts.request.session_id,
+        });
+        if (!sessionFile) {
+            throw new SessionTurnError(404, `session_id not found in ${sessionDir}: ${opts.request.session_id}`);
+        }
         return {
             sessionFile,
-            sessionDir: opts.request.session_dir ? sessionDir : dirname(sessionFile),
+            sessionDir,
+            sessionKind: opts.normalizedSessionKind ?? inferSessionKindFromSessionDir(opts.repoRoot, sessionDir),
         };
     }
-    if (!(await directoryExists(sessionDir))) {
-        throw new SessionTurnError(404, `session directory not found: ${sessionDir}`);
+    const matches = [];
+    for (const target of defaultSessionLookupTargets(opts.repoRoot)) {
+        if (!(await directoryExists(target.sessionDir))) {
+            continue;
+        }
+        const sessionFile = await resolveSessionFileById({
+            sessionDir: target.sessionDir,
+            sessionId: opts.request.session_id,
+        });
+        if (sessionFile) {
+            matches.push({
+                sessionFile,
+                sessionDir: target.sessionDir,
+                sessionKind: target.sessionKind,
+            });
+        }
+    }
+    if (matches.length === 1) {
+        return matches[0];
     }
-    const sessionFile = await resolveSessionFileById({
-        sessionDir,
-        sessionId: opts.request.session_id,
-    });
-    if (!sessionFile) {
-        throw new SessionTurnError(404, `session_id not found in ${sessionDir}: ${opts.request.session_id}`);
+    if (matches.length > 1) {
+        throw new SessionTurnError(409, `session_id is ambiguous across operator/cp_operator stores: ${opts.request.session_id} (pass --session-kind or --session-dir)`);
     }
-    return { sessionFile, sessionDir };
+    throw new SessionTurnError(404, `session_id not found in operator/cp_operator stores: ${opts.request.session_id}`);
 }
 export function parseSessionTurnRequest(body) {
     const sessionId = nonEmptyString(body.session_id);
@@ -289,18 +343,19 @@ export async function executeSessionTurn(opts) {
         request: opts.request,
         normalizedSessionKind,
     });
+    const effectiveSessionKind = target.sessionKind ?? normalizedSessionKind;
     const sessionFactory = opts.sessionFactory ?? createMuSession;
     const session = await sessionFactory({
         cwd: opts.repoRoot,
         systemPrompt: systemPromptForTurn({
-            sessionKind: normalizedSessionKind,
+            sessionKind: effectiveSessionKind,
             extensionProfile,
         }),
         provider: opts.request.provider ?? undefined,
         model: opts.request.model ?? undefined,
         thinking: opts.request.thinking ?? undefined,
         extensionPaths: extensionPathsForTurn({
-            sessionKind: normalizedSessionKind,
+            sessionKind: effectiveSessionKind,
             extensionProfile,
         }),
         session: {
@@ -365,7 +420,7 @@ export async function executeSessionTurn(opts) {
     }
     return {
         session_id: resolvedSessionId ?? opts.request.session_id,
-        session_kind: normalizedSessionKind,
+        session_kind: effectiveSessionKind,
         session_file: resolvedSessionFile ?? target.sessionFile,
         context_entry_id: contextEntryId,
         reply,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-agent",
-  "version": "26.2.102",
+  "version": "26.2.103",
   "description": "Shared operator runtime for mu assistant sessions and serve extensions.",
   "keywords": [
     "mu",
@@ -24,10 +24,10 @@
     "themes/**"
   ],
   "dependencies": {
-    "@femtomc/mu-core": "26.2.102",
-    "@mariozechner/pi-agent-core": "^0.53.0",
-    "@mariozechner/pi-ai": "^0.53.0",
-    "@mariozechner/pi-coding-agent": "^0.53.0",
+    "@femtomc/mu-core": "26.2.103",
+    "@mariozechner/pi-agent-core": "^0.54.2",
+    "@mariozechner/pi-ai": "^0.54.2",
+    "@mariozechner/pi-coding-agent": "^0.54.2",
     "zod": "^4.1.9"
   }
 }

package/prompts/roles/operator.md

@@ -19,5 +19,6 @@ Using `mu`:
 - The `mu` CLI is self-explanatory: poke around with `mu --help` to understand.
 - Use `mu memory search|timeline|stats` to access contextual memory from past interactions.
 - Use `mu memory index status|rebuild` to inspect/refresh local memory index health when needed.
+- Use `mu control harness [provider] --json --pretty` to inspect harness adapter/provider/model configuration and model capability vectors.
 - Use `mu heartbeats` and `mu cron` to access persistent scheduled processes that broadcast to the user.
 

package/prompts/skills/memory/SKILL.md

@@ -136,9 +136,6 @@ mu memory stats --pretty
 - adjust anchors (`issue_id`, `run_id`, `session_id`, `topic`, channel metadata)
 - rebuild selected sources only
 
-Compatibility note:
-- `mu context ...` remains an alias to `mu memory ...`.
-
 ## Evaluation scenarios
 
 1. **Issue-scoped context retrieval**

package/prompts/skills/mu/SKILL.md

@@ -11,9 +11,10 @@ run focused execution loops, and hand off to specialized skills when needed.
 ## Contents
 
 - [Core contract](#core-contract)
+- [CLI capability map](#cli-capability-map)
 - [Default bounded investigation loop](#default-bounded-investigation-loop)
-- [Common mutation patterns](#common-mutation-patterns)
-- [Session and serve surfaces](#session-and-serve-surfaces)
+- [Common mutation and diagnostics patterns](#common-mutation-and-diagnostics-patterns)
+- [Session, serve, and one-shot surfaces](#session-serve-and-one-shot-surfaces)
 - [Durable automation handoff](#durable-automation-handoff)
 - [Evaluation scenarios](#evaluation-scenarios)
 - [Escalation map](#escalation-map)
@@ -25,25 +26,66 @@ run focused execution loops, and hand off to specialized skills when needed.
    - Start with bounded queries (`--limit`, scoped filters), then drill into specific entities.
 
 2. **CLI-first state operations**
-   - Read/mutate `issues`, `forum`, `memory`, and `control-plane` via `mu` CLI commands.
+   - Use `mu` command surfaces for state reads/writes (`issues`, `forum`, `memory`, `events`, `control`, `store`, `session`).
    - Avoid hand-editing JSONL runtime journals for normal operations.
 
 3. **Read -> act -> verify loop**
    - Before writes: inspect relevant current state.
    - After writes: re-read to confirm effect.
 
-4. **Keep work reversible and explicit**
+4. **Prefer self-discovery when uncertain**
+   - Run `mu --help` and `mu <command> --help` instead of guessing flags/subcommands.
+   - Use `mu guide` for the canonical in-CLI workflow map.
+
+5. **Keep work reversible and explicit**
    - Prefer small, composable steps.
    - State assumptions and blockers clearly.
 
+## CLI capability map
+
+Use these command groups as the source of truth for current capabilities:
+
+- Orientation + summaries:
+  - `mu --help`
+  - `mu guide`
+  - `mu status --pretty`
+- Work graph + coordination:
+  - `mu issues <subcmd>`
+  - `mu forum <subcmd>`
+- Context retrieval + traces:
+  - `mu memory <search|timeline|stats|index ...>`
+  - `mu events <list|trace ...>`
+- Control-plane + operator config:
+  - `mu control status`
+  - `mu control harness`
+  - `mu control identities`
+  - `mu control operator <...>`
+  - `mu control config <get|set|unset ...>`
+  - `mu control reload`
+  - `mu control diagnose-operator`
+- Session/runtime surfaces:
+  - `mu serve`, `mu stop`
+  - `mu session [list|config|<id>]`
+  - `mu turn ...`
+  - `mu exec ...`
+- Durable automation:
+  - `mu heartbeats <...>`
+  - `mu cron <...>`
+- Store forensics + replay:
+  - `mu store <paths|ls|tail ...>`
+  - `mu replay <id|path>`
+- Provider auth:
+  - `mu login [<provider>] [--list] [--logout]`
+
 ## Default bounded investigation loop
 
 ```bash
 mu status --pretty
 mu issues list --status open --limit 20 --pretty
 mu issues ready --limit 20 --pretty
-mu forum read user:context --limit 20 --pretty
+mu forum topics --prefix issue: --limit 20 --pretty
 mu memory search --query "<topic>" --limit 20
+mu events list --limit 20 --pretty
 mu store tail events --limit 20 --pretty
 ```
 
@@ -52,37 +94,54 @@ Then inspect concrete targets:
 ```bash
 mu issues get <id> --pretty
 mu forum read issue:<id> --limit 20 --pretty
+mu memory timeline --issue-id <id> --order desc --limit 40 --pretty
 ```
 
-## Common mutation patterns
+## Common mutation and diagnostics patterns
 
 Issue/forum lifecycle:
 
 ```bash
+mu issues claim <id> --pretty
 mu issues update <id> --status in_progress --pretty
 mu forum post issue:<id> -m "START: <plan>" --author operator
 mu forum post issue:<id> -m "RESULT: <summary>" --author operator
 mu issues close <id> --outcome success --pretty
 ```
 
-Control-plane lifecycle:
+Control-plane lifecycle and config:
 
 ```bash
 mu control status --pretty
+mu control harness --pretty
 mu control identities --all --pretty
+mu control config get --pretty
+mu control operator get --pretty
 mu control reload
 ```
 
-Store forensics:
+Targeted config/operator updates:
+
+```bash
+mu control config set control_plane.operator.enabled false
+mu control config set control_plane.memory_index.every_ms 120000
+mu control operator set openai-codex gpt-5.3-codex high
+mu control diagnose-operator --limit 40 --pretty
+```
+
+Store forensics and run replay:
 
 ```bash
+mu store paths --pretty
 mu store ls --pretty
 mu store tail cp_commands --limit 20 --pretty
 mu store tail cp_outbox --limit 20 --pretty
 mu store tail cp_adapter_audit --limit 20 --pretty
+mu store tail cp_operator_turns --limit 20 --pretty
+mu replay <issue-id-or-log-path>
 ```
 
-## Session and serve surfaces
+## Session, serve, and one-shot surfaces
 
 Primary interactive surface:
 
@@ -93,9 +152,17 @@ mu serve
 Session follow-ups/handoffs:
 
 ```bash
-mu session list --json --pretty
+mu session list --kind all --all-workspaces --limit 50 --json --pretty
 mu session <session-id>
 mu turn --session-kind operator --session-id <session-id> --body "<follow-up>"
+mu session config get --session-id <session-id>
+mu session config set-thinking --session-id <session-id> --thinking minimal
+```
+
+One-shot prompt (no durable session):
+
+```bash
+mu exec --message "<task>" --json
 ```
 
 In attached terminal operator chat, `/mu` helpers are available (`/mu events`, `/mu hud ...`, `/mu help`).
@@ -110,8 +177,8 @@ mu cron --help
 ```
 
 When work is multi-step and issue-graph driven, use `planning` to shape the DAG,
-then `hierarchical-work-protocol` to keep DAG semantics consistent, then
-`subagents` for durable execution.
+then `hud` for canonical HUD behavior, then `hierarchical-work-protocol` to keep DAG
+semantics consistent, then `subagents` for durable execution.
 For recurring bounded automation loops, use `heartbeats`.
 For wall-clock schedules (one-shot, interval, cron-expression), use `crons`.
 
@@ -119,20 +186,21 @@ For wall-clock schedules (one-shot, interval, cron-expression), use `crons`.
 
 1. **Bounded investigation before mutation**
    - Prompt: user asks for status + targeted change.
-   - Expected: skill gathers scoped evidence first (`mu status`, `issues`, `forum`, `memory`), then performs minimal write and verifies post-state.
+   - Expected: gather scoped evidence first (`mu status`, `issues`, `forum`, `memory`/`events`), then perform minimal write and verify post-state.
 
 2. **Control-plane diagnostics loop**
-   - Prompt: user reports messaging channel stopped responding.
-   - Expected: skill inspects `mu control status`, identities, and adapter audit/outbox logs, then proposes smallest reversible recovery step (`reload`, relink, or config fix).
+   - Prompt: messaging channel stopped responding.
+   - Expected: inspect `mu control status`, `harness`, identities, adapter audit/outbox logs; then apply smallest reversible fix (`config set`, relink, `reload`) and verify.
 
-3. **Session handoff continuity**
-   - Prompt: user asks to continue prior operator thread.
-   - Expected: skill inspects `mu session list`, resumes by ID, and keeps follow-up actions scoped to the resumed session context.
+3. **Session continuity + scope-safe config**
+   - Prompt: continue prior operator thread with model/thinking tweaks.
+   - Expected: use `mu session list` + `mu session <id>`/`mu turn`; when needed, apply `mu session config ...` (session-scoped) instead of mutating global defaults.
 
 ## Escalation map
 
 - Historical context retrieval and index maintenance: **`memory`**
 - Planning/decomposition and DAG review: **`planning`**
+- HUD contract/state updates across surfaces: **`hud`**
 - Shared DAG semantics for planning + execution: **`hierarchical-work-protocol`**
 - Durable multi-agent orchestration: **`subagents`**
 - Recurring bounded automation scheduling: **`heartbeats`**
@@ -142,3 +210,4 @@ For wall-clock schedules (one-shot, interval, cron-expression), use `crons`.
   - **`setup-discord`**
   - **`setup-telegram`**
   - **`setup-neovim`**
+- Technical writing/docs polish: **`writing`**

package/prompts/skills/setup-telegram/SKILL.md

@@ -21,8 +21,6 @@ Goal: get Telegram bot ingress and reply delivery working with minimal user-side
 - Public webhook base URL reachable by Telegram (for example `https://mu.example.com`)
 - Telegram bot token (from BotFather)
 
-Optional (agent can usually discover):
-- Bot username
 
 ## Agent-first workflow
 
@@ -47,18 +45,10 @@ mu control identities --all --pretty
 
 If no running server is available, ask user to start `mu serve` in another terminal before reload/route checks.
 
-### 2) Generate webhook secret and discover bot username
+### 2) Generate webhook secret
 
 Generate a strong webhook secret (do not expose it in final summaries).
 
-If outbound network is available, discover bot username:
-
-```bash
-curl -sS "https://api.telegram.org/bot<bot-token>/getMe"
-```
-
-Extract `result.username` when present.
-
 ### 3) Configure Telegram webhook (agent does this when possible)
 
 Set webhook to `https://<public-base>/webhooks/telegram` with secret token:
@@ -78,7 +68,6 @@ Use this canonical patch snippet (preserves unrelated keys):
 ```bash
 export MU_TELEGRAM_WEBHOOK_SECRET='<TELEGRAM_WEBHOOK_SECRET>'
 export MU_TELEGRAM_BOT_TOKEN='<TELEGRAM_BOT_TOKEN>'
-export MU_TELEGRAM_BOT_USERNAME='<TELEGRAM_BOT_USERNAME_OR_EMPTY>'
 config_path="$(mu control status --json | python3 -c 'import json,sys; print(json.load(sys.stdin)["config_path"])')"
 
 python3 - "$config_path" <<'PY'
@@ -98,8 +87,6 @@ adapters = cp.setdefault("adapters", {})
 telegram = adapters.setdefault("telegram", {})
 telegram["webhook_secret"] = os.environ["MU_TELEGRAM_WEBHOOK_SECRET"]
 telegram["bot_token"] = os.environ["MU_TELEGRAM_BOT_TOKEN"]
-username = os.environ.get("MU_TELEGRAM_BOT_USERNAME", "").strip()
-telegram["bot_username"] = username or None
 
 path.parent.mkdir(parents=True, exist_ok=True)
 path.write_text(json.dumps(data, indent=2) + "\n")
@@ -107,8 +94,7 @@ PY
 ```
 
 Replace placeholder values with secrets from the user.
-If bot username is unknown, leave `MU_TELEGRAM_BOT_USERNAME` empty.
-Then `unset MU_TELEGRAM_WEBHOOK_SECRET MU_TELEGRAM_BOT_TOKEN MU_TELEGRAM_BOT_USERNAME` after patching.
+Then `unset MU_TELEGRAM_WEBHOOK_SECRET MU_TELEGRAM_BOT_TOKEN` after patching.
 
 ### 5) Reload and verify
 
@@ -160,9 +146,9 @@ Ask user to send `/mu status` (or plain status text) and verify response deliver
    - Inputs: agent cannot reach `api.telegram.org`.
    - Expected: skill hands user exact `setWebhook` command, resumes after confirmation, and still completes local config/reload verification.
 
-3. **Unknown bot username fallback**
-   - Inputs: `getMe` unavailable or username omitted.
-   - Expected: config stores `bot_username: null` (or omitted equivalent), adapter still activates, and identity link can proceed from audit chat id.
+3. **Token+secret only configuration**
+   - Inputs: valid bot token + webhook secret, no username discovery step.
+   - Expected: adapter activates and identity link can proceed from audit chat id.
 
 ## Safety requirements
 

package/prompts/skills/writing/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: writing
+description: "Crafts clear, precise technical documentation. Use when writing or reviewing docs, PR descriptions, error messages, READMEs, API references, or any technical prose."
+---
+
+# writing
+
+Use this skill when asked to write, edit, or review technical prose. This includes documentation, READMEs, PR descriptions, error messages, comments, API references, and commit messages.
+
+## Contents
+
+- [Core contract](#core-contract)
+- [Writing workflows](#writing-workflows)
+- [Common patterns by document type](#common-patterns-by-document-type)
+- [Editing and review workflow](#editing-and-review-workflow)
+- [Evaluation scenarios](#evaluation-scenarios)
+
+## Core contract
+
+1. **Audience first**
+   - Identify the reader's baseline knowledge before writing.
+   - Write for the busiest reader who needs this information.
+   - Honor their time: front-load the essential information.
+
+2. **Clarity over style**
+   - One idea per sentence. Complex concepts deserve their own space.
+   - Active voice: "The system returns an error" not "An error is returned by the system."
+   - Precise terminology: use the same word for the same concept throughout.
+   - Concrete over abstract: "200ms latency" beats "fast performance."
+
+3. **Structure for scanability**
+   - Headings should communicate the document structure without reading prose.
+   - Lists for parallel items (bullets for unordered, numbers for sequences).
+   - Code blocks and tables over prose descriptions.
+   - Inverted pyramid: conclusion, supporting details, background.
+
+4. **Actionability**
+   - Imperative for procedures: "Run the migration" not "The migration should be run."
+   - Explicit consequences: state what happens if the user does X.
+   - Anticipate failure modes in troubleshooting sections.
+
+5. **Accessibility**
+   - Plain language: avoid Latin abbreviations, buzzwords, metaphor-heavy descriptions.
+   - Sentence length: average 15-20 words. Vary rhythm but never confuse length with sophistication.
+   - Context for jargon: define domain-specific terms on first use or link to definitions.
+
+6. **Verify by reading aloud**
+   - Awkward phrasing surfaces when spoken.
+   - Test instructions by following them exactly as written.
+   - Delete mercilessly: if a sentence doesn't inform or direct, cut it.
+
+## Writing workflows
+
+### A) Documentation from scratch
+
+1. **Identify the audience and goal**
+   - Who will read this? What do they know? What must they do after reading?
+
+2. **Outline the structure**
+   - Opening paragraph: what this document covers and why it matters.
+   - Body: group related concepts, sequence procedures in order of execution.
+   - Closing: next steps, related resources, or troubleshooting.
+
+3. **Draft with constraints**
+   - Maximum 25 words per sentence on average.
+   - Active voice for all instructions.
+   - Code examples for any behavior described.
+
+4. **Review against the contract**
+   - Scan test: can a reader grasp structure from headings alone?
+   - Action test: can a reader execute procedures without asking questions?
+   - Deletion pass: remove sentences that don't inform or direct.
+
+### B) PR/commit description
+
+1. **What changed** (imperative, present tense)
+2. **Why it changed** (context, motivation)
+3. **How to verify** (testing steps, expected outcomes)
+4. **Breaking changes** (if any, with migration path)
+
+Keep under 80 characters per line in the summary. Body wraps at 72 characters.
+
+### C) Error messages
+
+1. **State what happened** (not what didn't)
+2. **Explain why** (the root cause, if known)
+3. **Provide the fix** (concrete next step, not generic advice)
+4. **Include identifiers** (error codes, relevant IDs, log locations)
+
+Example:
+```
+Error: Connection refused to database 'prod-db' on port 5432.
+Cause: The database service is not running or firewall blocks port 5432.
+Fix: Start the service with 'sudo systemctl start postgresql' or verify firewall rules.
+Log: See /var/log/postgresql/postgresql-14-main.log for details.
+```
+
+## Common patterns by document type
+
+### README.md
+
+Structure:
+1. One-line description of what this is
+2. Installation/usage (minimal working example)
+3. Key features (bullet list)
+4. Configuration/options
+5. Contributing/troubleshooting links
+
+### API documentation
+
+Per endpoint:
+- Purpose (one sentence)
+- HTTP method and path
+- Parameters (name, type, required, description)
+- Request/response examples
+- Error codes and meanings
+
+### Inline code comments
+
+- **Why**, not what: explain intent, not obvious behavior.
+- Non-obvious side effects or assumptions.
+- TODO/FIXME with issue references, not vague notes.
+- Public APIs: docstrings with parameters, returns, raises.
+
+### Configuration docs
+
+- Default values explicitly stated.
+- Units for all numeric values (ms, bytes, percent).
+- Validation constraints (min/max, allowed values).
+- Impact of changing the value (what breaks, what improves).
+
+## Editing and review workflow
+
+When reviewing existing prose:
+
+1. **Structural audit**
+   - Does the outline serve the reader's goal?
+   - Are headings descriptive? Is sequencing logical?
+
+2. **Sentence-level edits**
+   - Convert passive to active voice.
+   - Replace vague quantifiers ("some", "many") with specifics.
+   - Break long sentences (\> 25 words) into two.
+
+3. **Accuracy check**
+   - Verify all code examples execute as written.
+   - Confirm version numbers, paths, and URLs are current.
+   - Check that error messages match actual output.
+
+4. **Final polish**
+   - Read aloud for awkward rhythm.
+   - Consistent formatting (punctuation in lists, code fences with languages).
+   - Spelling and grammar (but prioritize clarity over grammatical perfection).
+
+## Evaluation scenarios
+
+1. **Drafting documentation for a new feature**
+   - Prompt: user asks for docs for a feature they've implemented.
+   - Expected: skill identifies audience, structures around user goals not implementation details, includes working examples, and ends with verification steps.
+
+2. **Reviewing a PR description**
+   - Prompt: user shares a draft PR description for feedback.
+   - Expected: skill checks for imperative summary line, clear what/why/how structure, and explicit breaking change notice if applicable.
+
+3. **Improving error messages**
+   - Prompt: user shares error handling code or current error text.
+   - Expected: skill transforms vague messages into specific what/why/fix format with actionable next steps and relevant identifiers.
+
+4. **Editing README for clarity**
+   - Prompt: user asks for help with a project's README.
+   - Expected: skill restructures for inverted pyramid, adds minimal working example, replaces feature paragraphs with scannable lists, and ensures installation steps are complete and ordered.
+
+## Quality bar
+
+- Every sentence earns its place: informs or directs.
+- No sentence requires a second reading to understand.
+- A reader can act on instructions without asking clarifying questions.
+- Code examples execute without modification.
+- A skim reader grasps the document's purpose and structure.