@treeseed/dsh-chapters 0.1.23 → 0.2.0

package/lib/prompt.d.ts

@@ -0,0 +1,130 @@
+import { type SessionState } from './registry.ts';
+import type { SessionEventLike } from './types.ts';
+/** The stored override key (durable kv, same table as `enrichment.model`). */
+export declare const PROMPT_SETTING_KEY = "prompt.model";
+export interface PromptRoute {
+    provider: string;
+    model: string;
+}
+export interface PromptSuggestionResult {
+    ok: boolean;
+    text: string;
+}
+export interface PromptConfig {
+    /** config default for the model; '' ⇒ off unless a stored override says otherwise. */
+    model: string;
+    /** hard total budget on the assembled input slice. */
+    contextChars: number;
+    /** cap on the accepted recommendation; over-cap is invalid, never truncated. */
+    maxChars: number;
+}
+export interface PromptDeps {
+    getSetting(key: string): string | undefined;
+    putSetting(key: string, value: string): Promise<void>;
+    deleteSetting(key: string): Promise<void>;
+    /** Active chapter records for the calling session's registry row (never the
+     *  ancestor walk — the live tail carries the immediate context; this is the
+     *  economy, and the choice is documented at the site that reads it). */
+    chaptersOf(sessionId: string): Promise<{
+        number: number;
+        title: string;
+        summary: string;
+    }[]>;
+    config: PromptConfig;
+    /** The last route the conversation used on this plane, or null. */
+    conversationRoute(): PromptRoute | null;
+    /** One auxiliary completion; may reject — `suggest` catches and refuses honestly. */
+    fetch(prompt: string, route: PromptRoute): Promise<string>;
+    warn?(msg: string): void;
+}
+/** A live session as the command hands it over: id, an optional title, and the
+ *  surface events (what the working model sees — the same view the defining model reads). */
+export interface SuggestSession {
+    id: string;
+    title?: string | undefined;
+    events: SessionEventLike[];
+}
+/** The surface the host command and `/chapters-status` speak to. */
+export interface PromptSurface {
+    /** Effective spec after precedence; '' ⇒ OFF. */
+    effective(): {
+        spec: string;
+        source: 'override' | 'config' | 'unset';
+    };
+    setModel(spec: string | null): Promise<void>;
+    suggest(session: SuggestSession): Promise<PromptSuggestionResult>;
+    /** One line for /chapters-status — ON names the model, OFF names the command. */
+    statusLine(): string;
+}
+/**
+ * Effective spec = stored override ?? config default, trimmed. `undefined`
+ * (row absent — cleared) falls back; a STORED '' is the deliberate OFF.
+ */
+export declare function effectivePromptSpec(setting: string | undefined, configModel: string): {
+    spec: string;
+    source: 'override' | 'config' | 'unset';
+};
+/**
+ * 'provider/model' routes as named; a bare model name rides the conversation's
+ * provider (the enrich-wire rule); '' is not a route. A bare name with no
+ * provider answers with its reason rather than guessing.
+ */
+export declare function resolvePromptRoute(spec: string, conversation: PromptRoute | null): {
+    route: PromptRoute | null;
+    reason?: string;
+};
+/**
+ * The conversation tail from surface events, screened through the ONE injection
+ * predicate (docs/contract.md, #59): injected events drop, injected spans strip.
+ * Chronological; text-bearing human/assistant messages only.
+ */
+export declare function tailFromEvents(events: SessionEventLike[]): {
+    role: 'user' | 'assistant';
+    text: string;
+}[];
+export interface SuggestFacts {
+    title?: string | undefined;
+    chapters: {
+        number: number;
+        title: string;
+        summary: string;
+    }[];
+    tail: {
+        role: 'user' | 'assistant';
+        text: string;
+    }[];
+}
+/**
+ * Assemble the auxiliary input: deterministic (same facts ⇒ same bytes), hard
+ * total ≤ `capChars`. Oldest chapter lines drop first, then oldest tail
+ * messages; every drop is ANNOUNCED in the input itself — a silent squeeze
+ * would make the answer look derived from bytes that were never sent.
+ */
+export declare function buildSuggestInput(facts: SuggestFacts, capChars: number, maxChars: number): string;
+/**
+ * Validate one answer. A wrapping code fence or one pair of wrapping quotes is
+ * formatting noise and comes off; the rest is the human's next prompt verbatim.
+ * Over-cap or empty is INVALID (never truncated) — the caller retries once and
+ * then refuses with the measured numbers.
+ */
+export declare function validateSuggestion(raw: string, maxChars: number): {
+    ok: true;
+    text: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * The watermarks this surface caches per session: the seq of the last surface
+ * event at generation. A new completed turn moves the seq and retires the
+ * suggestion; a restart simply loses the cache (it is a convenience, never truth).
+ */
+export declare function createPromptSurface(deps: PromptDeps): PromptSurface;
+/** Narrow slice: what `registerHostCommands` needs from the surface. */
+export type PromptCommandSurface = PromptSurface;
+/** Active chapters of one registry row, mapped to the facts the input uses. */
+export declare function promptChaptersOf(state: SessionState): {
+    number: number;
+    title: string;
+    summary: string;
+}[];

package/lib/prompt.js

@@ -0,0 +1,255 @@
+/**
+ * dsh-chapters — prompt recommendations (#71, site §28).
+ *
+ * One model reads the context and DOES the work; a second model reads the context
+ * and DEFINES it: the next prompt the human would send, offered as a ghost layer
+ * in the composer. Off by default, and the model IS the switch: the effective spec
+ * (stored override ?? config `promptModel`) being non-empty is what enables the
+ * feature — one knob, no second boolean that could drift against it.
+ *
+ * Transport here is the PULL: the client overlay executes
+ * `/chapters-prompt suggest` over `remote.commands` (the door-proven wire) and this
+ * module answers from a one-per-turn-boundary cache or one bounded auxiliary call.
+ * The 0.2.x push upgrade (plugin record + projection) is in docs/backlog.md; the
+ * measured host facts are in docs/contract.md § Composer Ghost Layer.
+ *
+ * Invariants the answer MUST respect: the recommendation is UI state only. It is
+ * never archived, never enters a notice or a rule, never steers a model request —
+ * it reaches the log only when a human accepts it and sends, as their own message.
+ *
+ * @module dsh-chapters/src/prompt
+ */
+import { textOfBlocks } from "./log-shape.js";
+import { screenConversation, stripReminderSpans } from "./injections.js";
+import { isActiveChapter } from "./registry.js";
+/** The stored override key (durable kv, same table as `enrichment.model`). */
+export const PROMPT_SETTING_KEY = 'prompt.model';
+/**
+ * Effective spec = stored override ?? config default, trimmed. `undefined`
+ * (row absent — cleared) falls back; a STORED '' is the deliberate OFF.
+ */
+export function effectivePromptSpec(setting, configModel) {
+    if (setting !== undefined)
+        return { spec: setting.trim(), source: 'override' };
+    const c = configModel.trim();
+    return { spec: c, source: c === '' ? 'unset' : 'config' };
+}
+/**
+ * 'provider/model' routes as named; a bare model name rides the conversation's
+ * provider (the enrich-wire rule); '' is not a route. A bare name with no
+ * provider answers with its reason rather than guessing.
+ */
+export function resolvePromptRoute(spec, conversation) {
+    if (spec === '')
+        return { route: null, reason: 'prompt suggestions are off' };
+    const i = spec.indexOf('/');
+    if (i > 0 && i < spec.length - 1)
+        return { route: { provider: spec.slice(0, i), model: spec.slice(i + 1) } };
+    if (conversation !== null && conversation.provider !== '')
+        return { route: { provider: conversation.provider, model: spec } };
+    return { route: null, reason: `no provider to route "${spec}" — name it as provider/model` };
+}
+/**
+ * The conversation tail from surface events, screened through the ONE injection
+ * predicate (docs/contract.md, #59): injected events drop, injected spans strip.
+ * Chronological; text-bearing human/assistant messages only.
+ */
+export function tailFromEvents(events) {
+    const out = [];
+    for (const ev of events) {
+        const data = (ev.data ?? {});
+        if (ev.type === 'user/message') {
+            const screen = screenConversation(data, textOfBlocks(data.content), 'user');
+            if (screen.omittedEvent)
+                continue;
+            const text = stripReminderSpans(screen.text).text.trim();
+            if (text !== '')
+                out.push({ role: 'user', text });
+        }
+        else if (ev.type === 'assistant/message') {
+            const message = (data.message ?? data);
+            const text = stripReminderSpans(textOfBlocks(message.content)).text.trim();
+            if (text !== '')
+                out.push({ role: 'assistant', text });
+        }
+    }
+    return out;
+}
+/** One message's inline budget before its own ellipsis — the cap is a cap, the
+ *  ellipsis says so (loudness, #61). */
+const MESSAGE_INLINE_CHARS = 500;
+/**
+ * Assemble the auxiliary input: deterministic (same facts ⇒ same bytes), hard
+ * total ≤ `capChars`. Oldest chapter lines drop first, then oldest tail
+ * messages; every drop is ANNOUNCED in the input itself — a silent squeeze
+ * would make the answer look derived from bytes that were never sent.
+ */
+export function buildSuggestInput(facts, capChars, maxChars) {
+    const chapters = [...facts.chapters];
+    let tail = [...facts.tail];
+    let droppedChapters = 0;
+    let droppedTail = 0;
+    let msgCap = MESSAGE_INLINE_CHARS;
+    const perMessage = (t) => (t.length > msgCap ? `${t.slice(0, msgCap - 1)}…` : t);
+    const render = (announce) => {
+        const head = `You are the second reader of a DSH session — a model that DEFINES the next step and never executes it.`;
+        const rules = `Write the ONE next prompt the human should send. A single imperative request; plain text; at most ${maxChars} characters; no preamble, no quotes, no markdown; it must follow from the latest state and propose nothing already done. Reply with ONLY that prompt.`;
+        const parts = [
+            head,
+            '',
+            `## Session${facts.title !== undefined && facts.title !== '' ? `: ${facts.title}` : ''}`,
+            '',
+            chapters.length > 0 ? '## Where it has been (chapters)' : '## Where it has been (no chapters yet)',
+            ...chapters.map((c) => `${c.number}. ${c.title} — ${c.summary}`),
+            '',
+            tail.length > 0 ? '## Live tail (oldest first)' : '## Live tail (empty)',
+            ...tail.map((m) => `${m.role === 'user' ? 'Human' : 'Assistant'}: ${perMessage(m.text)}`),
+        ];
+        if (announce !== '')
+            parts.push(announce);
+        parts.push('', rules);
+        return parts.join('\n');
+    };
+    // Trim to budget: chapters are the compressible past; the tail is the present.
+    // The ladder has a floor: a `capChars` smaller than the fixed skeleton (persona +
+    // section headers + reply rule) cannot be met by dropping — the last arm returns
+    // the skeleton as-is. The documented default (4000) is far above it.
+    for (;;) {
+        const announce = droppedChapters + droppedTail === 0
+            ? ''
+            : `\n(older context dropped to fit the ${capChars}-char budget: ${droppedChapters} chapter line(s), ${droppedTail} message(s))`;
+        const input = render(announce);
+        if (input.length <= capChars)
+            return input;
+        if (chapters.length > 0) {
+            chapters.shift();
+            droppedChapters += 1;
+            continue;
+        }
+        if (tail.length > 1) {
+            tail.shift();
+            droppedTail += 1;
+            continue;
+        }
+        if (msgCap > 40) {
+            msgCap = Math.max(40, Math.floor(msgCap / 2));
+            continue;
+        }
+        if (tail.length === 1) {
+            tail = [];
+            droppedTail += 1;
+            continue;
+        }
+        return input;
+    }
+}
+/**
+ * Validate one answer. A wrapping code fence or one pair of wrapping quotes is
+ * formatting noise and comes off; the rest is the human's next prompt verbatim.
+ * Over-cap or empty is INVALID (never truncated) — the caller retries once and
+ * then refuses with the measured numbers.
+ */
+export function validateSuggestion(raw, maxChars) {
+    let text = raw.trim();
+    const fence = text.match(/^`{2,}[^\n]*\n([\s\S]*?)\n`{2,}\s*$/);
+    if (fence?.[1] !== undefined)
+        text = fence[1].trim();
+    const quoted = text.match(/^"([\s\S]+)"$/) ?? text.match(/^“([\s\S]+)”$/);
+    if (quoted?.[1] !== undefined)
+        text = quoted[1].trim();
+    if (text === '')
+        return { ok: false, reason: 'the model returned no text' };
+    if (text.length > maxChars)
+        return { ok: false, reason: `the answer is ${text.length} characters, over the ${maxChars}-char cap` };
+    return { ok: true, text };
+}
+/**
+ * The watermarks this surface caches per session: the seq of the last surface
+ * event at generation. A new completed turn moves the seq and retires the
+ * suggestion; a restart simply loses the cache (it is a convenience, never truth).
+ */
+export function createPromptSurface(deps) {
+    const cache = new Map();
+    const inflight = new Map();
+    const refuse = (reason) => ({ ok: false, text: reason });
+    const effective = () => effectivePromptSpec(deps.getSetting(PROMPT_SETTING_KEY), deps.config.model);
+    const run = async (session, seq) => {
+        const { spec } = effective();
+        const { route, reason } = resolvePromptRoute(spec, deps.conversationRoute());
+        if (route === null)
+            return refuse(`prompt suggestions cannot run: ${reason ?? 'no route'}`);
+        let input;
+        let chaptersCount = 0;
+        try {
+            const chapters = await deps.chaptersOf(session.id);
+            chaptersCount = chapters.length;
+            const tail = tailFromEvents(session.events);
+            input = buildSuggestInput({ title: session.title, chapters, tail }, deps.config.contextChars, deps.config.maxChars);
+        }
+        catch (error) {
+            return refuse(`could not assemble the context: ${String(error?.message ?? error).slice(0, 160)}`);
+        }
+        const cap = `Remember: reply with ONLY the suggested prompt, plain text, at most ${deps.config.maxChars} characters.`;
+        try {
+            let text = await deps.fetch(input, route);
+            let verdict = validateSuggestion(text, deps.config.maxChars);
+            if (!verdict.ok) {
+                deps.warn?.(`prompt retry (${verdict.reason}) after ${chaptersCount} chapter line(s) + tail`);
+                text = await deps.fetch(`${input}\n${cap}`, route);
+                verdict = validateSuggestion(text, deps.config.maxChars);
+            }
+            if (!verdict.ok)
+                return refuse(`no recommendation: ${verdict.reason}`);
+            cache.set(session.id, { text: verdict.text, seq });
+            return { ok: true, text: verdict.text };
+        }
+        catch (error) {
+            const message = `prompt model call failed: ${String(error?.message ?? error).slice(0, 160)}`;
+            deps.warn?.(message);
+            return refuse(message);
+        }
+    };
+    return {
+        effective,
+        async setModel(spec) {
+            if (spec === null)
+                await deps.deleteSetting(PROMPT_SETTING_KEY);
+            else
+                await deps.putSetting(PROMPT_SETTING_KEY, spec.trim());
+            cache.clear();
+            inflight.clear();
+        },
+        async suggest(session) {
+            const { spec } = effective();
+            if (spec === '')
+                return refuse('prompt suggestions are off — enable with /chapters-prompt model <provider/model>');
+            const events = session.events;
+            if (events.length === 0)
+                return refuse('nothing to recommend yet — the session has no surface events');
+            const seq = events[events.length - 1].seq;
+            const tail = tailFromEvents(events);
+            if (!tail.some((m) => m.role === 'assistant'))
+                return refuse('nothing to recommend yet — no completed assistant turn');
+            const fresh = cache.get(session.id);
+            if (fresh !== undefined && fresh.seq === seq)
+                return { ok: true, text: fresh.text };
+            const pending = inflight.get(session.id);
+            if (pending !== undefined)
+                return await pending;
+            const job = run(session, seq).finally(() => { inflight.delete(session.id); });
+            inflight.set(session.id, job);
+            return await job;
+        },
+        statusLine() {
+            const { spec, source } = effective();
+            if (spec === '')
+                return `Prompt suggestions: OFF${source === 'override' ? ' (explicitly off — /chapters-prompt model <provider/model> to enable)' : ' — enable with /chapters-prompt model <provider/model>'}`;
+            return `Prompt suggestions: ON — ${spec} (${source}; the composer ghost offers its answer, accepted only by your keystroke)`;
+        },
+    };
+}
+/** Active chapters of one registry row, mapped to the facts the input uses. */
+export function promptChaptersOf(state) {
+    return state.chapters.filter(isActiveChapter).map((c) => ({ number: c.number, title: c.title, summary: c.summary }));
+}
+//# sourceMappingURL=prompt.js.map

package/lib/prompt.js.map

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

package/lib/registry.d.ts

@@ -31,6 +31,15 @@ export interface SessionState {
      */
     nextPlanNumber: number;
     chapters: ChapterRecord[];
+    /**
+     * Write counter, bumped by the store on every accepted put (#59). It exists so a read-modify-write
+     * can DETECT that the row moved underneath it — the row is one whole value and five doors plus the
+     * turn/end listener write it, so "last writer wins" is not a theoretical concern: in the field a
+     * stale enrichment put erased a compaction's committed manifest, reservation, `finalized` entry and
+     * chapter record while leaving its file on disk. Optional-with-default so a stored row from before
+     * the field parses unchanged.
+     */
+    rev?: number | undefined;
     /** attemptKey -> numbers, so an idempotent retry reuses rather than duplicates. */
     reservations: Record<string, number[]>;
     /**
@@ -95,8 +104,37 @@ export declare function reservePlan(state: SessionState, attemptId: string, coun
     state: SessionState;
     numbers: number[];
 };
-/** Append verified chapter records. A record with an existing (number) identity is a no-op — retries are safe. */
+/**
+ * Append verified chapter records.
+ *
+ * Identity is `(number, sha256)`, never `number` alone (#59). An identical record is a no-op — that is
+ * what makes a retry after a crash safe. A record reusing a number for DIFFERENT bytes is not a retry,
+ * it is a collision: one door's reservation was rewound by a lost update and another door has now been
+ * handed a number whose file already exists. Measured in the field: chapter 15 was spent twice in
+ * `session-aac0254e`, and number-only dedupe silently DROPPED the second record while its 960 KB file
+ * stayed on disk — a chapter no TOC cites and no tool can find. Refusing is the only honest option.
+ */
+/**
+ * The ONE test for "may this chapter be shown as knowledge?" (#60). Every derived layer — the TOC a
+ * child is seeded with, the enrichment queue, anything else that reads `state.chapters` — goes through
+ * this predicate, because a repair that left a husk in the corpus would be a lie a later reader cannot
+ * see past. Records written before this field existed are `undefined`, i.e. active: legacy archives
+ * are never silently hidden by a new filter.
+ */
+export declare function isActiveChapter(c: {
+    status?: 'superseded' | undefined;
+}): boolean;
 export declare function appendChapters(state: SessionState, records: readonly ChapterRecord[]): SessionState;
+/**
+ * Free an attempt's retry key WITHOUT un-spacing its numbers (#59). Reserve-before-write exists so a
+ * crash cannot re-issue a number whose file may already be on disk; that guarantee must not be undone
+ * here. What this does is stop a burned key from living forever: a door that reserved and then failed
+ * (a read-back that did not verify, a refusal after writing) currently leaves `reservations[k]` behind
+ * with no file and no record, which is the state the field showed at numbers 20 and 37.
+ *
+ * `numbersSpent` stays monotonic — only the attempt key goes.
+ */
+export declare function releaseReservation(state: SessionState, attemptId: string): SessionState;
 /**
  * Commit point for a continuation: the child inherits the PARENT's root and
  * gets its direct parent recorded. Set once, never rewritten — re-pointing a

package/lib/registry.js

@@ -1,4 +1,5 @@
 export const freshSession = (sessionId) => ({
+    rev: 0,
     parentSession: null,
     rootSession: sessionId,
     nextChapterNumber: 1,
@@ -36,11 +37,22 @@ export function reserve(state, attemptId, count) {
         }
         return { state, numbers: [...existing] };
     }
-    const numbers = Array.from({ length: count }, (_, i) => state.nextChapterNumber + i);
+    // Never hand out a number the row already carries. A committed number with no matching
+    // reservation is a real state, not a bug: an orphan row written before this field existed, or a
+    // chapter whose record a lost update erased while its file survived (#59). Allocating into it would
+    // put two `0NN-*.md` in one tree, so allocation SKIPS it and spends the next free number instead.
+    const taken = new Set(state.chapters.map((c) => c.number));
+    const numbers = [];
+    let cursor = state.nextChapterNumber;
+    while (numbers.length < count) {
+        if (!taken.has(cursor))
+            numbers.push(cursor);
+        cursor += 1;
+    }
     return {
         state: {
             ...state,
-            nextChapterNumber: state.nextChapterNumber + count,
+            nextChapterNumber: cursor,
             reservations: { ...state.reservations, [attemptId]: numbers },
         },
         numbers,
@@ -59,23 +71,78 @@ export function reservePlan(state, attemptId, count) {
         }
         return { state, numbers: [...existing] };
     }
-    const numbers = Array.from({ length: count }, (_, i) => state.nextPlanNumber + i);
+    // Same skip rule as reserve(): plan documents are numbered independently but the collision
+    // hazard is identical (a lost update rewinding nextPlanNumber re-issues `plan-003` over a twin).
+    const taken = new Set(state.chapters.flatMap((c) => c.planDocs ?? [])
+        .map((d) => /plan-(\d+)-/.exec(d.path)?.[1]).filter((n) => n !== undefined).map(Number));
+    const numbers = [];
+    let cursor = state.nextPlanNumber;
+    while (numbers.length < count) {
+        if (!taken.has(cursor))
+            numbers.push(cursor);
+        cursor += 1;
+    }
     return {
         state: {
             ...state,
-            nextPlanNumber: state.nextPlanNumber + count,
+            nextPlanNumber: cursor,
             reservations: { ...state.reservations, [key]: numbers },
         },
         numbers,
     };
 }
-/** Append verified chapter records. A record with an existing (number) identity is a no-op — retries are safe. */
+/**
+ * Append verified chapter records.
+ *
+ * Identity is `(number, sha256)`, never `number` alone (#59). An identical record is a no-op — that is
+ * what makes a retry after a crash safe. A record reusing a number for DIFFERENT bytes is not a retry,
+ * it is a collision: one door's reservation was rewound by a lost update and another door has now been
+ * handed a number whose file already exists. Measured in the field: chapter 15 was spent twice in
+ * `session-aac0254e`, and number-only dedupe silently DROPPED the second record while its 960 KB file
+ * stayed on disk — a chapter no TOC cites and no tool can find. Refusing is the only honest option.
+ */
+/**
+ * The ONE test for "may this chapter be shown as knowledge?" (#60). Every derived layer — the TOC a
+ * child is seeded with, the enrichment queue, anything else that reads `state.chapters` — goes through
+ * this predicate, because a repair that left a husk in the corpus would be a lie a later reader cannot
+ * see past. Records written before this field existed are `undefined`, i.e. active: legacy archives
+ * are never silently hidden by a new filter.
+ */
+export function isActiveChapter(c) {
+    return c.status !== 'superseded';
+}
 export function appendChapters(state, records) {
-    const known = new Set(state.chapters.map((c) => c.number));
-    const fresh = records.filter((r) => !known.has(r.number));
-    if (fresh.length === 0)
+    const byNumber = new Map(state.chapters.map((c) => [c.number, c]));
+    const fresh = [];
+    for (const r of records) {
+        const prior = byNumber.get(r.number);
+        if (prior !== undefined) {
+            if (prior.sha256 !== r.sha256 || prior.path !== r.path) {
+                throw new Error(`appendChapters: chapter number ${r.number} is already committed with different content `
+                    + `(${prior.path} sha ${prior.sha256.slice(0, 12)}…) — refusing to overwrite or silently drop `
+                    + `${r.path} (sha ${r.sha256.slice(0, 12)}…). A reused number means a lost registry update (#59).`);
+            }
+            continue; // identical retry
+        }
+        fresh.push(r);
+        byNumber.set(r.number, r);
+    }
+    return fresh.length === 0 ? state : { ...state, chapters: [...state.chapters, ...fresh] };
+}
+/**
+ * Free an attempt's retry key WITHOUT un-spacing its numbers (#59). Reserve-before-write exists so a
+ * crash cannot re-issue a number whose file may already be on disk; that guarantee must not be undone
+ * here. What this does is stop a burned key from living forever: a door that reserved and then failed
+ * (a read-back that did not verify, a refusal after writing) currently leaves `reservations[k]` behind
+ * with no file and no record, which is the state the field showed at numbers 20 and 37.
+ *
+ * `numbersSpent` stays monotonic — only the attempt key goes.
+ */
+export function releaseReservation(state, attemptId) {
+    if (state.reservations[attemptId] === undefined)
         return state;
-    return { ...state, chapters: [...state.chapters, ...fresh] };
+    const { [attemptId]: _gone, ...rest } = state.reservations;
+    return { ...state, reservations: rest };
 }
 /**
  * Commit point for a continuation: the child inherits the PARENT's root and

package/lib/registry.js.map

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

package/lib/render.d.ts

@@ -20,9 +20,37 @@ export declare function artifactRef(text: string, opts: {
  * Validate model-supplied ranges. Never trust them (hard rule): an overlap duplicates archived text and a
  * gap silently drops history, so both are errors here rather than data that quietly goes missing.
  */
-export declare function validateRanges(chapters: ChapterRange[], archiveCeiling: number): ChapterRange[];
-/** Enumerate tool results in a range so the model can decide keep/defer against real sizes. */
-export declare function toolResultCandidates(events: SessionEventLike[], range: ChapterRange): ToolResultCandidate[];
+export declare function validateRanges(chapters: ChapterRange[], archiveCeiling: number, 
+/** The watermark: ranges must start HERE, not wherever the submitter liked (#59). */
+archiveFloor?: number): ChapterRange[];
+/**
+ * Ranges whose render blew past the oversize ceiling (#59). `chapterTokenTarget` stays the SOFT target
+ * — split at the next boundary, never clip — and a modest overshoot is a warning, because a single
+ * indivisible turn can legitimately exceed it. Past `target × factor` the chapter is not a chapter:
+ * nobody can `read` it back inside the window it exists for, which is the whole point of archiving.
+ * The field held an 89,982-token chapter, an unrepaired 237,870-token orphan and eleven over 32K.
+ */
+export declare function oversizeRanges(rendered: readonly {
+    range: ChapterRange;
+    stats: {
+        estimatedTokens: number;
+    };
+}[], chapterTokenTarget: number, oversizeFactor: number): string[];
+/**
+ * The capped public form (#61). `chapters_segment` once emitted 49,932 characters of its OWN output while
+ * also reporting `(Omitted 275266 bytes …)` — ≈81K est tokens into a 32K-class window, asking a small
+ * model to judge a candidate list it never received. Ranking is by size descending, so what a cap
+ * removes is the SMALL stuff: the judgment the model is actually asked for stays intact.
+ *
+ * The caller reports what was withheld — see `candidateTotals` — because a capped list that does not say
+ * it is capped is a silent truncation, and AGENTS.md forbids truncating to fit.
+ */
+export declare function toolResultCandidates(events: SessionEventLike[], range: ChapterRange, capTokens?: number): ToolResultCandidate[];
+/** Totals for the WHOLE candidate set, so a capped response can name what it left out. */
+export declare function candidateTotals(events: SessionEventLike[], range: ChapterRange): {
+    count: number;
+    bytes: number;
+};
 /**
  * Render one chapter. `overrides` is the model's sparse exception list; anything not named follows the
  * default rule (small results inline, large ones deferred). Either way the artifact is written, so a wrong