@animalabs/agent-framework 0.9.0 → 0.11.0

package/dist/test/provider-acceleration-cooldown.test.js

@@ -0,0 +1,286 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { MembraneError } from '@animalabs/membrane';
+import { AgentFramework } from '../src/index.js';
+import { MockMembrane, MockYieldingStream, createMockResponse } from './helpers/mock-membrane.js';
+class InputModule {
+    name = 'input';
+    ctx = null;
+    async start(ctx) { this.ctx = ctx; }
+    async stop() { this.ctx = null; }
+    getTools() { return []; }
+    async handleToolCall(_call) { return { success: false, isError: true, error: 'none' }; }
+    async onProcess(event, _state) {
+        if (event.type !== 'external-message')
+            return {};
+        return { addMessages: [{ participant: 'User', content: [{ type: 'text', text: String(event.content) }] }], requestInference: true };
+    }
+}
+class ErrorStream {
+    error;
+    isWaitingForTools = false;
+    pendingToolCallIds = [];
+    toolDepth = 0;
+    isCancelled = false;
+    constructor(error) {
+        this.error = error;
+    }
+    provideToolResults() { throw new Error('not waiting'); }
+    cancel() { this.isCancelled = true; }
+    async *[Symbol.asyncIterator]() {
+        yield { type: 'error', error: this.error };
+    }
+}
+class AccelerationThenSuccessMembrane extends MockMembrane {
+    n = 0;
+    streamYielding(request) {
+        this.calls.push(request);
+        this.n++;
+        if (this.n === 1) {
+            return new ErrorStream(new MembraneError({
+                type: 'rate_limit', retryable: true, httpStatus: 429,
+                message: "This request would exceed your organization's maximum usage increase rate for input tokens per minute",
+                rawError: { status: 429 }, rawRequest: request,
+            }));
+        }
+        return new MockYieldingStream([createMockResponse([{ type: 'text', text: 'recovered' }])]);
+    }
+}
+class GenericRateLimitThenSuccessMembrane extends MockMembrane {
+    n = 0;
+    streamYielding(request) {
+        this.calls.push(request);
+        this.n++;
+        if (this.n === 1)
+            return new ErrorStream(new MembraneError({
+                type: 'rate_limit', retryable: true, httpStatus: 429,
+                message: "This request would exceed your organization's rate limit for input tokens per minute; retry after 1", retryAfterMs: 1,
+                rawError: { status: 429 }, rawRequest: request,
+            }));
+        return new MockYieldingStream([createMockResponse([{ type: 'text', text: 'ordinary retry' }])]);
+    }
+}
+class AlwaysSuccessMembrane extends MockMembrane {
+    streamYielding(request) {
+        this.calls.push(request);
+        return new MockYieldingStream([createMockResponse([{ type: 'text', text: 'ok' }])]);
+    }
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function textOf(request) {
+    return request.messages.flatMap((m) => m.content)
+        .filter((b) => b.type === 'text')
+        .map((b) => b.text).join('\n');
+}
+test('organization acceleration 429 defers one fresh compile, includes arrivals, and avoids failure breaker', async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'af-provider-cooldown-'));
+    const membrane = new AccelerationThenSuccessMembrane();
+    const framework = await AgentFramework.create({
+        storePath: join(dir, 'store.chronicle'), membrane: membrane.asMembrane(),
+        agents: [{ name: 'resident', model: 'test-model', systemPrompt: 'system' }],
+        modules: [new InputModule()], syncIntervalMs: 0, maintenanceIntervalMs: 0,
+    });
+    const internal = framework;
+    internal.providerAccelerationDefaultCooldownMs = 1_000;
+    internal.providerAccelerationJitterMs = 0;
+    try {
+        framework.pushEvent({ type: 'external-message', source: 'test', content: 'first', metadata: {} });
+        await framework.runUntilIdle();
+        assert.equal(membrane.calls.length, 1, 'no immediate same-window retry');
+        assert.equal(internal.consecutiveInferenceFailures.get('resident') ?? 0, 0, 'capacity does not enter hard-down streak');
+        assert.equal(internal.providerAccelerationCooldowns.size, 1);
+        framework.pushEvent({ type: 'external-message', source: 'test', content: 'arrived during cooldown', metadata: {} });
+        await framework.runUntilIdle();
+        assert.equal(membrane.calls.length, 1, 'new arrival is held, not separately inferred');
+        assert.equal(internal.providerAccelerationCooldowns.get('resident')?.heldRequests.length, 2);
+        await sleep(1_100);
+        await framework.runUntilIdle();
+        assert.equal(membrane.calls.length, 2, 'one deferred primary attempt');
+        assert.match(textOf(membrane.calls[1]), /first/);
+        assert.match(textOf(membrane.calls[1]), /arrived during cooldown/);
+        const messages = framework.getAgent('resident').getContextManager().queryMessages({}).messages;
+        const failed = messages.filter((m) => m.metadata?.kind === 'inference-failed');
+        const authoredReceipt = messages.filter((m) => m.metadata?.kind === 'provider-acceleration-recovered');
+        assert.equal(failed.length, 0, 'no poisoned-history/failure marker');
+        assert.equal(authoredReceipt.length, 0, 'provider admission never authors resident memory');
+        const recovery = internal.providerAccelerationLastRecovery.get('resident');
+        assert.ok(recovery, 'operational recovery receipt is exposed outside Chronicle');
+        assert.ok(recovery.waitedMs >= recovery.cooldownMs);
+        assert.equal(recovery.heldRequests, 2);
+        assert.ok(recovery.messageCount > 0);
+        assert.equal(recovery.stopReason, 'end_turn');
+    }
+    finally {
+        await framework.stop();
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('dynamic conversation forks are excluded from provider cooldown ownership', async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'af-provider-conversation-'));
+    const membrane = new AccelerationThenSuccessMembrane();
+    const framework = await AgentFramework.create({
+        storePath: join(dir, 'store.chronicle'), membrane: membrane.asMembrane(),
+        agents: [{ name: 'resident', model: 'test-model', systemPrompt: 'system' }],
+        modules: [], syncIntervalMs: 0, maintenanceIntervalMs: 0,
+    });
+    const internal = framework;
+    internal.conversationAgentHomes.set('resident', 'world:test');
+    try {
+        const error = new MembraneError({
+            type: 'rate_limit', retryable: true, httpStatus: 429,
+            message: "This request would exceed your organization's maximum usage increase rate for input tokens per minute",
+            rawError: { status: 429 },
+        });
+        const held = internal.holdProviderAcceleration(framework.getAgent('resident'), error, {
+            agentName: 'resident', reason: 'conversation', source: 'test', timestamp: Date.now(),
+        });
+        assert.equal(held, false, 'conversation fork retains its existing provider policy');
+        assert.equal(internal.providerAccelerationCooldowns.size, 0);
+        assert.equal(internal.providerGates.size, 0, 'generation-unique conversation name allocates no provider gate');
+    }
+    finally {
+        await framework.stop();
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('a resident waiting behind auxiliary work does not block another resident', async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'af-provider-cross-agent-'));
+    const membrane = new AlwaysSuccessMembrane();
+    const framework = await AgentFramework.create({
+        storePath: join(dir, 'store.chronicle'), membrane: membrane.asMembrane(),
+        agents: [
+            { name: 'resident', model: 'test-model', systemPrompt: 'system' },
+            { name: 'other', model: 'test-model', systemPrompt: 'system' },
+        ],
+        modules: [], syncIntervalMs: 0, maintenanceIntervalMs: 0,
+    });
+    const internal = framework;
+    let finish;
+    const auxiliary = internal.withAuxiliaryAdmission('resident', () => new Promise((resolve) => {
+        finish = resolve;
+    }));
+    try {
+        await internal.startAgentStream(framework.getAgent('resident'));
+        await internal.startAgentStream(framework.getAgent('other'));
+        await sleep(20);
+        assert.equal(membrane.calls.length, 1, 'the other resident reaches the provider while the first waits');
+        finish();
+        await auxiliary;
+        await sleep(20);
+        assert.equal(membrane.calls.length, 2, 'the waiting resident resumes after auxiliary settlement');
+    }
+    finally {
+        finish();
+        await auxiliary;
+        await framework.stop();
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('shutdown aborts a primary waiting behind in-flight auxiliary work', async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'af-provider-stop-aux-'));
+    const membrane = new MockMembrane();
+    const framework = await AgentFramework.create({
+        storePath: join(dir, 'store.chronicle'), membrane: membrane.asMembrane(),
+        agents: [{ name: 'resident', model: 'test-model', systemPrompt: 'system' }],
+        modules: [new InputModule()], syncIntervalMs: 0, maintenanceIntervalMs: 0,
+    });
+    const internal = framework;
+    let finish;
+    const auxiliary = internal.withAuxiliaryAdmission('resident', () => new Promise((resolve) => {
+        finish = resolve;
+    }));
+    let stopped = false;
+    try {
+        framework.pushEvent({ type: 'external-message', source: 'test', content: 'first', metadata: {} });
+        const draining = framework.runUntilIdle();
+        await sleep(20);
+        assert.equal(membrane.calls.length, 0, 'primary waits behind the admitted auxiliary');
+        await Promise.race([
+            framework.stop().then(() => { stopped = true; }),
+            sleep(250).then(() => { throw new Error('shutdown left the primary waiting behind auxiliary work'); }),
+        ]);
+        await draining;
+        assert.equal(membrane.calls.length, 0, 'shutdown does not start a late primary against the closed store');
+    }
+    finally {
+        finish();
+        await auxiliary;
+        if (!stopped)
+            await framework.stop();
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('ordinary 429 keeps the existing retry policy instead of entering acceleration cooldown', async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'af-provider-generic-'));
+    const membrane = new GenericRateLimitThenSuccessMembrane();
+    const framework = await AgentFramework.create({
+        storePath: join(dir, 'store.chronicle'), membrane: membrane.asMembrane(),
+        agents: [{ name: 'resident', model: 'test-model', systemPrompt: 'system' }],
+        modules: [new InputModule()], syncIntervalMs: 0, maintenanceIntervalMs: 0,
+    });
+    try {
+        framework.pushEvent({ type: 'external-message', source: 'test', content: 'ordinary', metadata: {} });
+        await framework.runUntilIdle();
+        assert.equal(membrane.calls.length, 2);
+        const internal = framework;
+        assert.equal(internal.providerAccelerationCooldowns.size, 0);
+    }
+    finally {
+        await framework.stop();
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('local provider gate settles in-flight auxiliary work and parks later auxiliary admission', async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'af-provider-gate-'));
+    const membrane = new MockMembrane();
+    const framework = await AgentFramework.create({
+        storePath: join(dir, 'store.chronicle'), membrane: membrane.asMembrane(),
+        agents: [{ name: 'resident', model: 'test-model', systemPrompt: 'system' }], modules: [],
+        syncIntervalMs: 0, maintenanceIntervalMs: 0,
+    });
+    const internal = framework;
+    try {
+        let finish;
+        const inFlight = internal.withAuxiliaryAdmission('resident', () => new Promise((resolve) => {
+            finish = () => resolve(3);
+        }));
+        internal.acquirePrimaryProviderGate('resident');
+        let primaryReady = false;
+        const wait = internal.waitForAuxiliaryIdle('resident').then(() => { primaryReady = true; });
+        let laterRan = false;
+        const later = internal.withAuxiliaryAdmission('resident', async () => { laterRan = true; return 7; });
+        await sleep(10);
+        assert.equal(primaryReady, false, 'primary observes the already in-flight auxiliary');
+        assert.equal(laterRan, false, 'new auxiliary is parked');
+        finish();
+        assert.equal(await inFlight, 3);
+        await wait;
+        assert.equal(primaryReady, true);
+        assert.equal(laterRan, false, 'parked auxiliary still waits for primary settlement');
+        internal.releasePrimaryProviderGate('resident');
+        assert.equal(await later, 7);
+        assert.equal(internal.providerGates.get('resident')?.deferredAuxiliary, 0, 'completed wait no longer reports backlog');
+        // The real Context Manager door is the wrapped auxiliary Membrane, not
+        // merely the helper tested above.
+        internal.acquirePrimaryProviderGate('resident');
+        const cm = framework.getAgent('resident').getContextManager();
+        const request = {
+            messages: [], tools: [], config: { model: 'test-model', maxTokens: 16 },
+        };
+        const before = membrane.calls.length;
+        const throughCm = cm.membrane.complete(request);
+        await sleep(10);
+        assert.equal(membrane.calls.length, before, 'Context Manager provider call is parked');
+        internal.releasePrimaryProviderGate('resident');
+        await throughCm;
+        assert.equal(membrane.calls.length, before + 1, 'Context Manager call resumes once');
+    }
+    finally {
+        await framework.stop();
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=provider-acceleration-cooldown.test.js.map

package/dist/test/provider-acceleration-cooldown.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-acceleration-cooldown.test.js","sourceRoot":"","sources":["../../test/provider-acceleration-cooldown.test.ts"],"names":[],"mappings":"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"}

package/dist/test/puppet-tool-call.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=puppet-tool-call.test.d.ts.map

package/dist/test/puppet-tool-call.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppet-tool-call.test.d.ts","sourceRoot":"","sources":["../../test/puppet-tool-call.test.ts"],"names":[],"mappings":""}

package/dist/test/puppet-tool-call.test.js

@@ -0,0 +1,106 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { AgentFramework } from '../src/framework.js';
+function puppetHarness(opts) {
+    const stored = [];
+    const traces = [];
+    const executed = [];
+    const status = opts?.status ?? 'idle';
+    const surface = opts?.surface ?? ['mcpl--eido--look'];
+    // Real MCPL results are MCP content arrays — the helper renders them plain.
+    const result = opts?.result ?? {
+        success: true,
+        data: [{ type: 'text', text: 'You are "p" in world "w".' }],
+        isError: false,
+    };
+    const agent = {
+        name: 'princess',
+        state: { status },
+        canUseTool: (name) => surface.includes(name),
+        getContextManager: () => ({
+            addMessage: (participant, content) => {
+                stored.push({ participant, content });
+                return `msg-${stored.length}`;
+            },
+        }),
+    };
+    const framework = Object.create(AgentFramework.prototype);
+    framework.agents =
+        new Map([['princess', agent]]);
+    framework.getToolsForAgent =
+        () => surface.map((name) => ({ name }));
+    framework.executeToolCall =
+        async (call) => {
+            executed.push(call);
+            return result;
+        };
+    framework.resolveToolResultInlineCap =
+        () => ({ cap: undefined });
+    framework.emitTrace =
+        (e) => { traces.push(e); };
+    return { framework, stored, traces, executed };
+}
+test('puppetToolCall executes with agent provenance and stores the pair', async () => {
+    const { framework, stored, traces, executed } = puppetHarness();
+    const quiet = console.log;
+    console.log = () => { };
+    try {
+        const { toolUseId, result } = await framework.puppetToolCall('princess', 'mcpl--eido--look', {});
+        assert.match(toolUseId, /^toolu_01[A-Za-z0-9]{22}$/, 'anthropic-shaped id');
+        assert.equal(result.success, true);
+        assert.equal(executed.length, 1);
+        assert.equal(executed[0].callerAgentName, 'princess', 'executes AS the agent');
+        assert.equal(executed[0].id, toolUseId, 'wire call carries the stored id');
+        assert.equal(stored.length, 2, 'exactly the pair, nothing else');
+        const [use, res] = stored;
+        assert.equal(use.participant, 'princess', 'tool_use is the agent turn');
+        assert.equal(use.content.length, 1, 'bare tool_use — no fabricated text/thinking');
+        assert.equal(use.content[0].type, 'tool_use');
+        assert.equal(use.content[0].id, toolUseId);
+        assert.equal(res.participant, 'user', 'tool_result rides a user message');
+        assert.equal(res.content[0].type, 'tool_result');
+        assert.equal(res.content[0].toolUseId, toolUseId, 'result pairs with the call');
+        assert.equal(res.content[0].toolName, 'mcpl--eido--look');
+        assert.equal(res.content[0].isError, false);
+        assert.match(String(res.content[0].content), /You are "p"/, 'real result text stored');
+        assert.equal(traces.length, 1);
+        assert.equal(traces[0].type, 'puppet:tool-call');
+        assert.equal(traces[0].agentName, 'princess');
+    }
+    finally {
+        console.log = quiet;
+    }
+});
+test('puppetToolCall refuses a non-idle agent', async () => {
+    const { framework, stored } = puppetHarness({ status: 'streaming' });
+    await assert.rejects(() => framework.puppetToolCall('princess', 'mcpl--eido--look', {}), /requires idle/);
+    assert.equal(stored.length, 0, 'nothing stored on refusal');
+});
+test('puppetToolCall refuses a tool off the agent surface', async () => {
+    const { framework, stored, executed } = puppetHarness();
+    await assert.rejects(() => framework.puppetToolCall('princess', 'mcpl--other--nuke', {}), /not on princess's surface/);
+    assert.equal(executed.length, 0, 'never executed');
+    assert.equal(stored.length, 0, 'nothing stored');
+});
+test('puppetToolCall refuses an unknown agent', async () => {
+    const { framework } = puppetHarness();
+    await assert.rejects(() => framework.puppetToolCall('ghost', 'mcpl--eido--look', {}), /Unknown agent/);
+});
+test('puppetToolCall stores an error result as isError, still paired', async () => {
+    const { framework, stored } = puppetHarness({
+        result: { success: false, error: 'MCPL server unreachable', isError: true },
+    });
+    const quiet = console.log;
+    console.log = () => { };
+    try {
+        const { result } = await framework.puppetToolCall('princess', 'mcpl--eido--look', {});
+        assert.equal(result.isError, true);
+        assert.equal(stored.length, 2, 'error results are stored too — same as a real turn');
+        assert.equal(stored[1].content[0].isError, true);
+        assert.match(String(stored[1].content[0].content), /unreachable/);
+    }
+    finally {
+        console.log = quiet;
+    }
+});
+//# sourceMappingURL=puppet-tool-call.test.js.map

package/dist/test/puppet-tool-call.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppet-tool-call.test.js","sourceRoot":"","sources":["../../test/puppet-tool-call.test.ts"],"names":[],"mappings":"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"}

package/dist/test/release-changelog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release-changelog.test.d.ts.map

package/dist/test/release-changelog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-changelog.test.d.ts","sourceRoot":"","sources":["../../test/release-changelog.test.ts"],"names":[],"mappings":""}

package/dist/test/release-changelog.test.js

@@ -0,0 +1,159 @@
+// Black-box coverage of scripts/release-changelog.mjs: each case runs the
+// real script in a throwaway directory, so assembly, validation, and the
+// deletion of consumed fragments are all exercised exactly as `npm version`
+// would run them.
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { execFileSync } from "node:child_process";
+import { mkdirSync, mkdtempSync, readdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const SCRIPT = fileURLToPath(new URL("../../scripts/release-changelog.mjs", import.meta.url));
+const BASE_CHANGELOG = [
+    "# Changelog",
+    "",
+    "Intro that mentions ## Unreleased inline, which must not count as a heading.",
+    "",
+    "## Unreleased",
+    "",
+    "## 1.0.0 — 2026-01-01",
+    "",
+    "### Fixed",
+    "",
+    "- Old entry.",
+    "",
+].join("\n");
+function setup(f) {
+    const dir = mkdtempSync(join(tmpdir(), "release-changelog-"));
+    writeFileSync(join(dir, "package.json"), JSON.stringify({ name: "fixture", version: f.version ?? "1.1.0" }));
+    writeFileSync(join(dir, "CHANGELOG.md"), f.changelog ?? BASE_CHANGELOG);
+    mkdirSync(join(dir, "changelog.d"));
+    writeFileSync(join(dir, "changelog.d", "README.md"), "# Pending fragments\n");
+    for (const [name, body] of Object.entries(f.fragments ?? {})) {
+        const path = join(dir, "changelog.d", name);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, body);
+    }
+    return dir;
+}
+function run(dir) {
+    try {
+        const stdout = execFileSync(process.execPath, [SCRIPT], {
+            cwd: dir,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        return { status: 0, stdout, stderr: "" };
+    }
+    catch (e) {
+        const err = e;
+        return { status: err.status, stdout: err.stdout ?? "", stderr: err.stderr ?? "" };
+    }
+}
+function section(text, version) {
+    const lines = text.split("\n");
+    const start = lines.findIndex((l) => l.startsWith(`## ${version} — `));
+    assert.notEqual(start, -1, `no '## ${version}' section in:\n${text}`);
+    const rest = lines.slice(start + 1);
+    const end = rest.findIndex((l) => l.startsWith("## "));
+    return rest.slice(0, end === -1 ? undefined : end).join("\n").trim();
+}
+const changelog = (dir) => readFileSync(join(dir, "CHANGELOG.md"), "utf8");
+const pending = (dir) => readdirSync(join(dir, "changelog.d")).sort();
+test("folds fragments into a versioned section in canonical order and deletes them", () => {
+    const dir = setup({
+        fragments: {
+            "z-later.fixed.md": "- Fixed thing.\n",
+            "a-first.added.md": "- Added thing,\n  continued on an indented line.\n",
+            "m.breaking.md": "- **Module authors:** breaking thing.\n",
+        },
+    });
+    const r = run(dir);
+    assert.equal(r.status, 0, r.stderr);
+    const text = changelog(dir);
+    assert.equal(section(text, "1.1.0"), [
+        "### Breaking",
+        "",
+        "- **Module authors:** breaking thing.",
+        "",
+        "### Added",
+        "",
+        "- Added thing,",
+        "  continued on an indented line.",
+        "",
+        "### Fixed",
+        "",
+        "- Fixed thing.",
+    ].join("\n"));
+    assert.match(text, /^## Unreleased\n\n## 1\.1\.0 — \d{4}-\d{2}-\d{2}\n/m, "fresh empty Unreleased above the cut");
+    assert.ok(text.startsWith("# Changelog\n\nIntro that mentions"), "file header preserved");
+    assert.equal(section(text, "1.0.0"), "### Fixed\n\n- Old entry.", "older section untouched");
+    assert.deepEqual(pending(dir), ["README.md"], "consumed fragments deleted, README kept");
+});
+test("merges fragments into directly-filed Unreleased entries, reordering subsections canonically", () => {
+    const dir = setup({
+        changelog: BASE_CHANGELOG.replace("## Unreleased\n", "## Unreleased\n\n### Fixed\n\n- Manual fix.\n\n### Added\n\n- Manual add.\n"),
+        fragments: { "x.fixed.md": "- Fragment fix.\n" },
+    });
+    const r = run(dir);
+    assert.equal(r.status, 0, r.stderr);
+    assert.equal(section(changelog(dir), "1.1.0"), "### Added\n\n- Manual add.\n\n### Fixed\n\n- Manual fix.\n\n- Fragment fix.");
+});
+test("breaking fragments join an audience-qualified Breaking heading", () => {
+    const dir = setup({
+        changelog: BASE_CHANGELOG.replace("## Unreleased\n", "## Unreleased\n\n### Fixed\n\n- Manual fix.\n\n### Breaking (module authors only)\n\n- Manual break.\n"),
+        fragments: { "b.breaking.md": "- Fragment break.\n" },
+    });
+    const r = run(dir);
+    assert.equal(r.status, 0, r.stderr);
+    assert.equal(section(changelog(dir), "1.1.0"), "### Breaking (module authors only)\n\n- Manual break.\n\n- Fragment break.\n\n### Fixed\n\n- Manual fix.");
+});
+test("accepts nested bullets and multi-line continuations", () => {
+    const dir = setup({
+        fragments: { "n.fixed.md": "- one\n  - nested\n  more text\n- two\n" },
+    });
+    const r = run(dir);
+    assert.equal(r.status, 0, r.stderr);
+    assert.equal(section(changelog(dir), "1.1.0"), "### Fixed\n\n- one\n  - nested\n  more text\n- two");
+});
+test("accepts bullet content that merely resembles headings or rules", () => {
+    const body = "- **Module authors:** bold opener.\n- -1 is now the sentinel.\n- #123 is referenced inline.\n- ***emphasis*** then text.\n";
+    const dir = setup({ fragments: { "r.fixed.md": body } });
+    const r = run(dir);
+    assert.equal(r.status, 0, r.stderr);
+    assert.equal(section(changelog(dir), "1.1.0"), `### Fixed\n\n${body.trim()}`);
+});
+const refusals = [
+    ["nothing to release", {}, /nothing to release as 1\.1\.0/],
+    ["duplicate version section", { version: "1.0.0", fragments: { "a.fixed.md": "- x\n" } }, /'## 1\.0\.0' section already exists/],
+    ["unrecognized category suffix", { fragments: { "oops.md": "- x\n" } }, /changelog\.d\/oops\.md: unrecognized file/],
+    ["stray non-markdown file", { fragments: { "notes.txt": "hi\n", "a.fixed.md": "- x\n" } }, /changelog\.d\/notes\.txt: unrecognized file/],
+    ["empty fragment", { fragments: { "e.fixed.md": "\n" } }, /changelog\.d\/e\.fixed\.md: empty fragment/],
+    ["fragment nested under a branch-name directory", { fragments: { "fix/foo.fixed.md": "- x\n", "a.fixed.md": "- y\n" } }, /changelog\.d\/fix: not a file/],
+    ["plain prose", { fragments: { "p.fixed.md": "prose only\n" } }, /offending line: 'prose only'/],
+    ["prose after a valid bullet", { fragments: { "p.fixed.md": "- ok\nrogue prose\n" } }, /offending line: 'rogue prose'/],
+    ["top-level heading after a bullet", { fragments: { "h.fixed.md": "- ok\n\n## 9.9.9 — fake\n" } }, /offending line: '## 9\.9\.9 — fake'/],
+    ["indented ATX heading", { fragments: { "h.fixed.md": "- ok\n  ## 8.8.8 — injected\n  - beneath\n" } }, /offending line: '  ## 8\.8\.8 — injected'/],
+    ["indented setext underline / rule", { fragments: { "s.fixed.md": "- ok\n  ---\n" } }, /offending line: '  ---'/],
+    ["spaced thematic break shaped like a bullet", { fragments: { "s.fixed.md": "- ok\n- - -\n" } }, /offending line: '- - -'/],
+    ["asterisk thematic break with spaces", { fragments: { "s.fixed.md": "- ok\n* * *\n" } }, /offending line: '\* \* \*'/],
+    ["rule as bullet content", { fragments: { "s.fixed.md": "- ---\n" } }, /offending line: '- ---'/],
+    ["heading as bullet content", { fragments: { "h.fixed.md": "- ## 9.9.9 — embedded heading\n" } }, /offending line: '- ## 9\.9\.9 — embedded heading'/],
+    ["heading as nested bullet content", { fragments: { "h.fixed.md": "- ok\n  - ### nested heading\n" } }, /offending line: '  - ### nested heading'/],
+    ["tab-indented continuation", { fragments: { "t.fixed.md": "- ok\n\tcontinued\n" } }, /offending line: '\tcontinued'/],
+    ["no Unreleased heading", { changelog: "# Changelog\n\n## 1.0.0 — 2026-01-01\n\n- x\n", fragments: { "a.fixed.md": "- x\n" } }, /no '## Unreleased' section/],
+    ["two Unreleased headings", { changelog: BASE_CHANGELOG + "\n## Unreleased\n\n- stranded\n", fragments: { "a.fixed.md": "- x\n" } }, /2 '## Unreleased' headings/],
+];
+for (const [name, fixture, message] of refusals) {
+    test(`refuses ${name} without touching anything`, () => {
+        const dir = setup(fixture);
+        const before = { changelog: changelog(dir), pending: pending(dir) };
+        const r = run(dir);
+        assert.equal(r.status, 1, `expected refusal, got exit ${r.status}:\n${r.stdout}${r.stderr}`);
+        assert.match(r.stderr, message);
+        assert.equal(changelog(dir), before.changelog, "CHANGELOG.md must be untouched");
+        assert.deepEqual(pending(dir), before.pending, "no fragment may be deleted on refusal");
+    });
+}
+//# sourceMappingURL=release-changelog.test.js.map

package/dist/test/release-changelog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-changelog.test.js","sourceRoot":"","sources":["../../test/release-changelog.test.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,kBAAkB;AAClB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,MAAM,GAAG,aAAa,CAC1B,IAAI,GAAG,CAAC,qCAAqC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAChE,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,aAAa;IACb,EAAE;IACF,8EAA8E;IAC9E,EAAE;IACF,eAAe;IACf,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,WAAW;IACX,EAAE;IACF,cAAc;IACd,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAQb,SAAS,KAAK,CAAC,CAAU;IACvB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC9D,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EACzB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC,CACnE,CAAC;IACF,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,SAAS,IAAI,cAAc,CAAC,CAAC;IACxE,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;IACpC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QAC5C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,GAAG,CAAC,GAAW;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;YACtD,GAAG,EAAE,GAAG;YACR,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAyD,CAAC;QACtE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;IACpF,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,OAAe;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC,CAAC;IACvE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,UAAU,OAAO,kBAAkB,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;AACnF,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAE9E,IAAI,CAAC,8EAA8E,EAAE,GAAG,EAAE;IACxF,MAAM,GAAG,GAAG,KAAK,CAAC;QAChB,SAAS,EAAE;YACT,kBAAkB,EAAE,kBAAkB;YACtC,kBAAkB,EAAE,oDAAoD;YACxE,eAAe,EAAE,yCAAyC;SAC3D;KACF,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,CACV,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EACtB;QACE,cAAc;QACd,EAAE;QACF,uCAAuC;QACvC,EAAE;QACF,WAAW;QACX,EAAE;QACF,gBAAgB;QAChB,kCAAkC;QAClC,EAAE;QACF,WAAW;QACX,EAAE;QACF,gBAAgB;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,qDAAqD,EAAE,sCAAsC,CAAC,CAAC;IAClH,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,oCAAoC,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAC1F,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,2BAA2B,EAAE,yBAAyB,CAAC,CAAC;IAC7F,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,yCAAyC,CAAC,CAAC;AAC3F,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6FAA6F,EAAE,GAAG,EAAE;IACvG,MAAM,GAAG,GAAG,KAAK,CAAC;QAChB,SAAS,EAAE,cAAc,CAAC,OAAO,CAC/B,iBAAiB,EACjB,6EAA6E,CAC9E;QACD,SAAS,EAAE,EAAE,YAAY,EAAE,mBAAmB,EAAE;KACjD,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CACV,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAChC,6EAA6E,CAC9E,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,GAAG,GAAG,KAAK,CAAC;QAChB,SAAS,EAAE,cAAc,CAAC,OAAO,CAC/B,iBAAiB,EACjB,wGAAwG,CACzG;QACD,SAAS,EAAE,EAAE,eAAe,EAAE,qBAAqB,EAAE;KACtD,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CACV,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAChC,0GAA0G,CAC3G,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAC/D,MAAM,GAAG,GAAG,KAAK,CAAC;QAChB,SAAS,EAAE,EAAE,YAAY,EAAE,yCAAyC,EAAE;KACvE,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,oDAAoD,CAAC,CAAC;AACvG,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,IAAI,GAAG,4HAA4H,CAAC;IAC1I,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAqC;IACjD,CAAC,oBAAoB,EAAE,EAAE,EAAE,+BAA+B,CAAC;IAC3D,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,qCAAqC,CAAC;IAChI,CAAC,8BAA8B,EAAE,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,2CAA2C,CAAC;IACpH,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,6CAA6C,CAAC;IACzI,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,4CAA4C,CAAC;IACvG,CAAC,+CAA+C,EAAE,EAAE,SAAS,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,+BAA+B,CAAC;IACzJ,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,EAAE,8BAA8B,CAAC;IAChG,CAAC,4BAA4B,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,qBAAqB,EAAE,EAAE,EAAE,+BAA+B,CAAC;IACvH,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,2BAA2B,EAAE,EAAE,EAAE,qCAAqC,CAAC;IACzI,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,4CAA4C,EAAE,EAAE,EAAE,2CAA2C,CAAC;IACpJ,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,yBAAyB,CAAC;IACjH,CAAC,4CAA4C,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,yBAAyB,CAAC;IAC3H,CAAC,qCAAqC,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,4BAA4B,CAAC;IACvH,CAAC,wBAAwB,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,EAAE,yBAAyB,CAAC;IACjG,CAAC,2BAA2B,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,iCAAiC,EAAE,EAAE,EAAE,mDAAmD,CAAC;IACtJ,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,gCAAgC,EAAE,EAAE,EAAE,0CAA0C,CAAC;IACnJ,CAAC,2BAA2B,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,qBAAqB,EAAE,EAAE,EAAE,+BAA+B,CAAC;IACtH,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,+CAA+C,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,4BAA4B,CAAC;IAC7J,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,cAAc,GAAG,iCAAiC,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,4BAA4B,CAAC;CACnK,CAAC;AAEF,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;IAChD,IAAI,CAAC,WAAW,IAAI,4BAA4B,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,8BAA8B,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7F,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;QACjF,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,uCAAuC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/test/tool-result-spill.test.d.ts

@@ -2,7 +2,7 @@
  * Oversized tool-result spill — completion coverage for issue #89.
  *
  * The mechanism (spill to workspace file + bounded preview) landed in
- * f231bbf; these tests pin the completion semantics: the house-safe 5000
+ * f231bbf; these tests pin the completion semantics: the house-safe 24000
  * default (no more 42k accidental ingests), the durable
  * FrameworkConfig.toolResultInlineMaxChars cap, hot-override provenance and
  * restart behavior, error results under the same policy, the explicit