@fractalsynapse/dsh-chapters 0.0.0-stage → 0.2.20

package/lib/notice.js

@@ -0,0 +1,92 @@
+/** Our producer id. Changing this orphans every already-seeded continuation. */
+export const NOTICE_PLUGIN = 'dsh-chapters';
+/** The v4 producer-owned source kind (issue #43). `plugin:<producer>` is the
+ *  form the 0.2.x kernel itself admits for third-party producers; the bare
+ *  `plugin` wrapper it retired. */
+export const NOTICE_SOURCE_KIND = `plugin:${NOTICE_PLUGIN}`;
+/** The section name our TOC rides under inside the snapshot. */
+export const NOTICE_SECTION = 'chapters:toc';
+/**
+ * The kinds this plugin may emit, pinned to what the installed v4 kernel
+ * admits (seed/load boundary + persistence row admission). The retired v3
+ * `plugin` wrapper is deliberately NOT in this list — it is refused below
+ * with the kernel's own refusal text.
+ */
+export const ACCEPTED_SOURCE_KINDS = ['user', NOTICE_SOURCE_KIND];
+/** `ContextForm` values, exactly as published (semantic, never visual). */
+export const ACCEPTED_CONTEXT_FORMS = [
+    'instructions', 'catalog', 'snapshot', 'notice', 'relay', 'recall',
+];
+/**
+ * Build the one seed event for a continuation. Throws rather than emit an
+ * event the kernel would reject at seed time — a refusal here is cheap, a
+ * bricked log is not.
+ */
+export function buildTocNotice(tocText, opts) {
+    if (tocText.trim().length === 0)
+        throw new Error('chapters: TOC notice text must not be empty');
+    const id = opts.newId();
+    if (id.length === 0)
+        throw new Error('chapters: notice message needs a non-empty id ("lacks an identified message")');
+    const event = {
+        type: 'user/message',
+        seq: 0, // seeds must be contiguous from 0 (FINDINGS: a seq-3 seed is rejected)
+        time: opts.time ?? Date.now(),
+        surfaceOp: 'append',
+        data: {
+            id,
+            role: 'user',
+            source: {
+                kind: NOTICE_SOURCE_KIND,
+                form: 'snapshot',
+                sections: [{ name: NOTICE_SECTION, text: tocText }],
+            },
+            // content mirrors sections[0].text byte-identically: the model reads
+            // `content`; the UI and attribution read `source`. One text, two faces.
+            content: [{ type: 'text', text: tocText }],
+        },
+    };
+    assertKernelAcceptedUserMessage(event);
+    return event;
+}
+/**
+ * Transcription of the kernel's seed-time checks (message-shape + v4 source
+ * admission + the recorded rejections). Kept as an exported predicate so tests
+ * pin our output against the same rules the host applies, and any future
+ * notice variant fails HERE, at the boundary of authorship. The v4 rows are
+ * drift-gated against the kernel's own admission function
+ * (`dsh-session-format-v3-to-v4` `assertV4RowAdmission`) in
+ * tests/unit/host-seed-contract.test.ts — this transcription is the fast lane,
+ * the kernel is the authority.
+ */
+export function assertKernelAcceptedUserMessage(event) {
+    if (event.type !== 'user/message')
+        throw new Error(`chapters: unexpected notice event type ${event.type}`);
+    const data = event.data;
+    if (data === undefined || typeof data !== 'object')
+        throw new Error('chapters: notice event needs data');
+    if (typeof data.id !== 'string' || data.id.length === 0) {
+        throw new Error('chapters: seed user/message lacks an identified message');
+    }
+    if (data.role !== 'user')
+        throw new Error('chapters: seed message must have role "user"');
+    const source = data.source;
+    if (source === undefined || typeof source !== 'object' || typeof source.kind !== 'string' || source.kind.length === 0) {
+        throw new Error('chapters: seed message has invalid source (object with non-empty string kind required)');
+    }
+    // The retired v3 wrapper, refused with the kernel's own v4 words — reproducing
+    // the production refusal at our authorship boundary (issue #43).
+    if (source.kind === 'plugin') {
+        throw new Error('chapters: format v4 message requires a producer-owned source kind (use plugin:dsh-chapters; the bare plugin wrapper was retired)');
+    }
+    if (!ACCEPTED_SOURCE_KINDS.includes(source.kind)) {
+        throw new Error(`chapters: source kind "${source.kind}" is outside the pinned vocabulary`);
+    }
+    if (source.form !== undefined && !ACCEPTED_CONTEXT_FORMS.includes(source.form)) {
+        throw new Error(`chapters: context form "${String(source.form)}" is outside the published ContextForm union`);
+    }
+    if (!Array.isArray(data.content) || data.content.length === 0) {
+        throw new Error('chapters: seed message has invalid content');
+    }
+}
+//# sourceMappingURL=notice.js.map

package/lib/notice.js.map

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

package/lib/plans.d.ts

@@ -0,0 +1,154 @@
+/**
+ * The plan detector (docs/plans-carriage.md § 1): a session plan is ONE thing in the
+ * durable log — a `tool/call` for `exit_plan_mode` whose `arguments.plan` carries the
+ * complete markdown, answered by a `tool/result` that carries the human verdict.
+ * There is no plan document event and no plan store: reading those two events is the
+ * whole job, and it must be read identically by the renderer, the segmentation tool
+ * and the notice builder.
+ *
+ * Host facts this mirrors, cited so an upgrade can re-verify them:
+ * - parameters `{ plan: string, required }` — `@deepseek-ai/dsh-plan-mode`
+ *   `lib/index.js:232-236`; the plan must start with a `#` heading (`:256`).
+ * - an approved review returns the canonical `{ approved: true }` plus the fixed
+ *   render text (`:237-251`).
+ * - "Keep planning" throws carrying the feedback; a dismissed review throws naming
+ *   the takeover (`:277-289`).
+ * - state is a log-only `plan/mode { active }` event appended at the NEXT accepted
+ *   in-turn pre-step (`:374, 389`), so the RESULT — not the mode event — is the
+ *   primary verdict. An approved exit narrates silently (`pendingIntents narrate:false`),
+ *   so the mode event may not exist at all by archive time.
+ * - a freshly created agent begins with plan mode INACTIVE and cannot inherit the
+ *   parent's `plan/mode` events (package README § Known Limitations), which is why the
+ *   notice has to carry this text at all.
+ *
+ * Verdict classes, and why `failed` exists: the host also throws when the review never
+ * opened (no user-questions channel, the service reloaded mid-review, the call ran
+ * outside plan mode, the markdown had no heading). Those carry NO human verdict, so
+ * labelling them `rejected` would invent one. (`docs/plans-carriage.md` § 1 amendment,
+ * 2026-10-09: `failed` is the fifth status; the record's four were the ones a human
+ * answered.)
+ *
+ * Pure module: no cordis, no fs, no DSH imports, no hash/token helpers (the renderer
+ * owns those, so this file cannot form an import cycle with it).
+ */
+import type { NoticePlan, PlanFact, PlanStatus, SessionEventLike } from './types.ts';
+export declare const PLAN_TOOL = "exit_plan_mode";
+/**
+ * Why a child exists. `continue` extends the SAME stream of work (the tool
+ * `chapters_continue`), so the operative plan stays a live directive — and plan mode
+ * can be seeded so the gate survives the boundary, which is what keeps the agent
+ * anchored to the task across compactions (decision 2026-10-10). `branch` splits a
+ * NEW direction off the history (`chapters_fork`, `/chapters-fork`), so plans are
+ * history: cited, never re-asserted, never seeded.
+ */
+export type PlanIntent = 'continue' | 'branch';
+export declare const PLAN_MODE_EVENT = "plan/mode";
+export type { NoticePlan, PlanFact, PlanStatus };
+/** A plan as the log states it. Never model-authored (invariant 4). */
+export interface PlanDoc {
+    /** The `tool/call` event seq — the plan's identity in the log. */
+    seq: number;
+    /** The verdict result seq, or null when the review was never answered. */
+    resultSeq: number | null;
+    callId: string;
+    /** First heading of the plan (the host requires an H1; any level is accepted). */
+    title: string;
+    status: PlanStatus;
+    /** The plan markdown, injected spans screened out. Full bytes — never clipped here. */
+    text: string;
+    bytes: number;
+    /** H2/H3 outline, in document order, fenced code excluded. */
+    outline: string[];
+    /** The verdict text as logged (feedback, dismissal reason, service fault), or null. */
+    verdict: string | null;
+    /** False when `seq` is above the archive ceiling: an unfinished turn, parent log only. */
+    archived: boolean;
+}
+export interface ModeFlip {
+    seq: number;
+    active: boolean;
+}
+export interface PlanScan {
+    plans: PlanDoc[];
+    /** Every `plan/mode` event in the scanned range, oldest first. */
+    flips: ModeFlip[];
+    /** Last logged value wins (the host projection rule). Null when no event exists. */
+    modeActive: boolean | null;
+}
+/**
+ * The first markdown heading at any level, or '' when the payload has none. The
+ * DISPLAY title is bounded: a plan whose H1 is a 4KB paragraph would otherwise be
+ * printed in full in every chapter that carries it and again in every child notice
+ * built from that path. Bounded here, not at the call sites — and the artifact keeps
+ * the untouched heading, because the artifact keeps every byte.
+ */
+export declare const PLAN_TITLE_MAX = 120;
+export declare function planTitleOf(text: string): string;
+/** Outline budget: entries × chars. An outline is an INDEX, not the document — the
+ * full heading map with line numbers is one `chapters_artifact toc` call away, so
+ * printing 24 unbounded headings per plan (a 4 KB H2 is a real thing people write)
+ * would repeat the 0.1.8 mistake at a smaller scale. */
+export declare const PLAN_OUTLINE_MAX_ENTRIES = 12;
+export declare const PLAN_OUTLINE_TITLE_MAX = 60;
+/**
+ * The plan's own table of contents: H2/H3 headings in document order, with fenced
+ * blocks excluded so a `# comment` inside a code sample never poses as a heading
+ * (the same discipline `artifact-query.buildToc` applies to stored blobs). Each
+ * entry is bounded; when entries are dropped a trailing `+N more` says so — a
+ * silently shortened index is the lie this codebase exists to avoid.
+ */
+export declare function planOutlineOf(text: string, maxEntries?: number): {
+    outline: string[];
+    levels: number[];
+};
+/**
+ * One verdict, from the result the host logged. Order matters: a dismissed or
+ * keep-planning failure text can contain the word "approved" only as a quote, so
+ * the non-approval shapes are tested before the approval shape, and `isError`
+ * decides when the prose is ambiguous.
+ */
+export declare function classifyVerdict(resultText: string, isError: boolean): PlanStatus;
+/** Plan submissions paired with their verdicts, in log order, over ANY event list. */
+export declare function detectPlans(events: readonly SessionEventLike[], opts?: {
+    ceiling?: number;
+}): PlanScan;
+/** True when the range carries at least one plan submission (composer split test). */
+export declare function planCallSeqs(events: readonly SessionEventLike[]): number[];
+/**
+ * The `## Plans` block of the continuation notice (docs/plans-carriage.md § 4).
+ * EMPTY when the path holds no plans, so a session that never planned contributes
+ * zero injected bytes — the property that keeps the model tapes matching.
+ *
+ * Flat, in the CAUSAL order the caller supplies (never re-sorted by `seq` — different
+ * sessions own different seq spaces): the model never traverses.
+ * `estTokens` arrives only from the caller's own measurement — this file owns no
+ * token maths, so the notice can never disagree with the budget gate.
+ */
+export declare function buildPlansSection(plans: readonly NoticePlan[], opts?: {
+    modeActive?: boolean | null;
+    intent?: PlanIntent;
+    seeded?: boolean;
+}): string;
+/**
+ * The in-place checkpoint's plan carriage (the PLOT mechanism, applied to plans —
+ * docs/plans-carriage.md § 9). Shadowing a region can hide the chapter that carries a
+ * plan, and a directive that only survives in a file the child may never open is a
+ * directive the agent drifts from. So the OPERATIVE plan travels in the checkpoint
+ * text itself, bounded, with its citation and the sha that still resolves the whole.
+ *
+ * "Operative" is session-level, not region-level — the newest submission on the log,
+ * whatever region it happened to fall in — because that is what "the current task"
+ * means to the agent reading the checkpoint.
+ */
+export declare function carryActivePlan(plans: readonly PlanDoc[], opts: {
+    maxChars: number;
+}): string | null;
+/**
+ * Topics for a plan DOCUMENT: the file paths the plan names, plus its most
+ * characteristic terms. Same vocabulary as the transcript's index floor
+ * (`signature.chapterTopics`), deliberately re-derived here rather than imported —
+ * a plan is prose the agent wrote on purpose, so its own path mentions are the
+ * strongest signal about what it changes, and they must land in the same topic
+ * namespace the chapter index already uses.
+ */
+export declare function planTopicsOf(planText: string, maxTerms?: number): string[];

package/lib/plans.js

@@ -0,0 +1,315 @@
+import { callArg, callArgsText, lastResultFor, toolResultIsError, toolResultText } from "./log-shape.js";
+import { stripReminderSpans } from "./injections.js";
+export const PLAN_TOOL = 'exit_plan_mode';
+export const PLAN_MODE_EVENT = 'plan/mode';
+const RE_APPROVED = /(?:\{\s*"?approved"?\s*:\s*true)|(?:plan approved\b)/i;
+const RE_DISMISSED = /dismissed the plan review|to speak instead/i;
+const RE_KEEP_PLANNING = /keep planning/i;
+/**
+ * The first markdown heading at any level, or '' when the payload has none. The
+ * DISPLAY title is bounded: a plan whose H1 is a 4KB paragraph would otherwise be
+ * printed in full in every chapter that carries it and again in every child notice
+ * built from that path. Bounded here, not at the call sites — and the artifact keeps
+ * the untouched heading, because the artifact keeps every byte.
+ */
+export const PLAN_TITLE_MAX = 120;
+export function planTitleOf(text) {
+    for (const line of text.split('\n')) {
+        const m = /^#{1,6}\s+(.+?)\s*$/.exec(line);
+        if (m === null)
+            continue;
+        const title = m[1].replace(/\s+#+\s*$/, ''); // closed ATX heading: "# Title #"
+        return title.length > PLAN_TITLE_MAX ? `${title.slice(0, PLAN_TITLE_MAX - 1).trimEnd()}…` : title;
+    }
+    return '';
+}
+/** Outline budget: entries × chars. An outline is an INDEX, not the document — the
+ * full heading map with line numbers is one `chapters_artifact toc` call away, so
+ * printing 24 unbounded headings per plan (a 4 KB H2 is a real thing people write)
+ * would repeat the 0.1.8 mistake at a smaller scale. */
+export const PLAN_OUTLINE_MAX_ENTRIES = 12;
+export const PLAN_OUTLINE_TITLE_MAX = 60;
+/**
+ * The plan's own table of contents: H2/H3 headings in document order, with fenced
+ * blocks excluded so a `# comment` inside a code sample never poses as a heading
+ * (the same discipline `artifact-query.buildToc` applies to stored blobs). Each
+ * entry is bounded; when entries are dropped a trailing `+N more` says so — a
+ * silently shortened index is the lie this codebase exists to avoid.
+ */
+export function planOutlineOf(text, maxEntries = PLAN_OUTLINE_MAX_ENTRIES) {
+    const outline = [];
+    const levels = [];
+    let truncated = false;
+    let inFence = false;
+    let fenceChar = '';
+    for (const line of text.split('\n')) {
+        const fence = /^\s{0,3}(`{3,}|~{3,})/.test(line);
+        if (fence) {
+            const marker = line.trim().slice(0, 3);
+            if (!inFence) {
+                inFence = true;
+                fenceChar = marker[0];
+            }
+            else if (marker[0] === fenceChar)
+                inFence = false;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const m = /^(#{2,3})\s+(.+?)\s*$/.exec(line);
+        if (m === null)
+            continue;
+        if (outline.length >= maxEntries) {
+            truncated = true;
+            break;
+        }
+        const heading = m[2].replace(/\s+#+\s*$/, '');
+        outline.push(heading.length > PLAN_OUTLINE_TITLE_MAX ? `${heading.slice(0, PLAN_OUTLINE_TITLE_MAX - 1).trimEnd()}…` : heading);
+        levels.push(m[1].length);
+    }
+    if (truncated)
+        outline.push(`+more (chapters_artifact 'toc' lists every heading)`);
+    return { outline, levels };
+}
+/**
+ * One verdict, from the result the host logged. Order matters: a dismissed or
+ * keep-planning failure text can contain the word "approved" only as a quote, so
+ * the non-approval shapes are tested before the approval shape, and `isError`
+ * decides when the prose is ambiguous.
+ */
+export function classifyVerdict(resultText, isError) {
+    if (RE_DISMISSED.test(resultText))
+        return 'dismissed';
+    if (RE_KEEP_PLANNING.test(resultText))
+        return 'rejected';
+    if (!isError && RE_APPROVED.test(resultText))
+        return 'approved';
+    if (isError)
+        return 'failed';
+    // A success that says nothing recognizable is NOT an approval: refuse to invent one.
+    return 'failed';
+}
+/** Plan submissions paired with their verdicts, in log order, over ANY event list. */
+export function detectPlans(events, opts = {}) {
+    const ceiling = opts.ceiling ?? Number.POSITIVE_INFINITY;
+    const sorted = [...events].sort((a, b) => a.seq - b.seq);
+    const results = sorted.filter((e) => e.type === 'tool/result');
+    const plans = [];
+    for (const call of sorted) {
+        if (call.type !== 'tool/call')
+            continue;
+        const data = (call.data ?? {});
+        if (String(data.name ?? '') !== PLAN_TOOL)
+            continue;
+        const callId = typeof data.callId === 'string' ? data.callId : '';
+        const raw = callArg(data, 'plan') ?? callArgsText(data);
+        // Screened at the source (a plan is model-authored bytes, but an injected span
+        // riding inside it is host state — same reasoning as injections.ts:62-70).
+        const text = stripReminderSpans(raw).text.trim();
+        const answer = callId === '' ? undefined : lastResultFor(results, callId);
+        let status = 'pending';
+        let verdict = null;
+        let resultSeq = null;
+        if (answer !== undefined) {
+            resultSeq = answer.seq;
+            const ad = (answer.data ?? {});
+            verdict = stripReminderSpans(toolResultText(ad)).text.trim() || null;
+            status = classifyVerdict(verdict ?? '', toolResultIsError(ad));
+        }
+        const { outline } = planOutlineOf(text);
+        plans.push({
+            seq: call.seq,
+            resultSeq,
+            callId,
+            title: planTitleOf(text),
+            status,
+            text,
+            bytes: Buffer.byteLength(text, 'utf8'),
+            outline,
+            verdict,
+            archived: call.seq <= ceiling,
+        });
+    }
+    // Same-title re-submission: the newest is operative; everything earlier in the
+    // group is superseded, whatever its own verdict was. Deterministic, no judgement.
+    const byTitle = new Map();
+    for (const p of plans) {
+        const key = p.title.trim().toLowerCase();
+        if (key === '')
+            continue;
+        const group = byTitle.get(key) ?? [];
+        group.push(p);
+        byTitle.set(key, group);
+    }
+    for (const group of byTitle.values()) {
+        if (group.length < 2)
+            continue;
+        for (const earlier of group.slice(0, -1))
+            earlier.status = 'superseded';
+    }
+    const flips = [];
+    for (const ev of sorted) {
+        if (ev.type !== PLAN_MODE_EVENT)
+            continue;
+        const active = ev.data?.active;
+        if (typeof active === 'boolean')
+            flips.push({ seq: ev.seq, active });
+    }
+    return { plans, flips, modeActive: flips.length > 0 ? flips[flips.length - 1].active : null };
+}
+/** True when the range carries at least one plan submission (composer split test). */
+export function planCallSeqs(events) {
+    return detectPlans(events).plans.map((p) => p.seq);
+}
+/**
+ * `PlanFact` (the chapter/registry machine facts) and `NoticePlan` (the flat notice
+ * row) are declared in types.ts and re-exported above, so the renderer, the zod
+ * schema and the notice builder cannot drift into three shapes.
+ */
+const STATUS_WORD = {
+    approved: 'APPROVED',
+    rejected: 'REJECTED — the user sent it back with feedback',
+    dismissed: 'DISMISSED — the user took over the conversation',
+    pending: 'PENDING — the review was never answered',
+    superseded: 'SUPERSEDED by a later submission',
+    failed: 'NOT ACCEPTED — the review could not be opened',
+};
+const shorterSha = (sha) => sha.slice(0, 7);
+/**
+ * The `## Plans` block of the continuation notice (docs/plans-carriage.md § 4).
+ * EMPTY when the path holds no plans, so a session that never planned contributes
+ * zero injected bytes — the property that keeps the model tapes matching.
+ *
+ * Flat, in the CAUSAL order the caller supplies (never re-sorted by `seq` — different
+ * sessions own different seq spaces): the model never traverses.
+ * `estTokens` arrives only from the caller's own measurement — this file owns no
+ * token maths, so the notice can never disagree with the budget gate.
+ */
+export function buildPlansSection(plans, opts = {}) {
+    if (plans.length === 0)
+        return '';
+    // A BRANCH splits off a new direction, so its plans are history: they already sit
+    // in the chapters the TOC cites, and a call-out would tell the child to keep
+    // working a directive it just chose to leave behind (decision, 2026-10-10).
+    if (opts.intent === 'branch')
+        return '';
+    // CAUSAL order is the caller's, not something this function can reconstruct: an
+    // ancestor path's rows come from DIFFERENT sessions, each with its own seq space
+    // (a child's seq 3 is not "before" a root's seq 40). The notice builder therefore
+    // hands rows in reading order — chapters root-first, plans within a chapter by
+    // seq, then the caller's unarchived tail — which is exactly the flattening rule
+    // the chapter list follows. Sorting by seq here would order two sessions' plans
+    // by unrelated counters and crown the wrong plan operative.
+    const sorted = [...plans];
+    const operative = sorted[sorted.length - 1];
+    const counts = new Map();
+    for (const p of sorted)
+        counts.set(p.status, (counts.get(p.status) ?? 0) + 1);
+    const tally = [...counts.entries()].map(([s, n]) => `${n} ${s}`).join(', ');
+    const previous = sorted.slice(0, -1);
+    const lines = [
+        `## Active plan`,
+        `(this continuation keeps the same stream of work: ${sorted.length} plan(s) submitted on the path — ${tally})`,
+        '',
+    ];
+    const ref = (p) => {
+        const bits = [];
+        if (p.chapterPath !== undefined) {
+            bits.push(`ch. ${p.chapterNumber ?? '?'} ${p.chapterPath}`);
+        }
+        else {
+            bits.push(`NOT ARCHIVED — parent log seq ${p.seq} only`);
+        }
+        if (p.artifactPath !== undefined)
+            bits.push(`full text: ${p.artifactPath}`);
+        if (p.docPath !== undefined)
+            bits.push(`plan document: ${p.docPath}`);
+        if (p.sha256 !== undefined)
+            bits.push(`sha ${shorterSha(p.sha256)}…`);
+        if (p.estTokens !== undefined)
+            bits.push(`~${p.estTokens} tok`);
+        return bits.join(' · ');
+    };
+    lines.push(`- ACTIVE PLAN: "${operative.title}" — ${STATUS_WORD[operative.status]} (${ref(operative)})`);
+    if (operative.status !== 'approved') {
+        lines.push('  This plan was never approved: do NOT implement it. Ask the user, or keep planning.');
+    }
+    else {
+        lines.push('  Read the full text with chapters_artifact (toc | search | read) before implementing.');
+        lines.push('  Do NOT re-plan from recall: the bytes are in the store.');
+    }
+    if (previous.length > 0) {
+        lines.push('', '## Previous plans on this path', '(history — cited for evolution and status, not directives)');
+        for (const p of previous) {
+            if (p.status === 'superseded' && p.title === operative.title)
+                continue;
+            lines.push(`- "${p.title}" — ${STATUS_WORD[p.status]} (${ref(p)})`);
+        }
+    }
+    if (opts.seeded === true) {
+        lines.push('', 'Plan mode is ACTIVE in this session — the directive above is live, not history. Keep');
+        lines.push('planning until a plan is approved; implementation begins only after that approval.');
+    }
+    else if (opts.modeActive === true) {
+        lines.push('', 'Plan mode was ACTIVE at the end of the archived span, and a created session does not');
+        lines.push('inherit it: this child starts OUTSIDE plan mode. Ask the user whether to keep planning or act.');
+    }
+    return lines.join('\n');
+}
+/**
+ * The in-place checkpoint's plan carriage (the PLOT mechanism, applied to plans —
+ * docs/plans-carriage.md § 9). Shadowing a region can hide the chapter that carries a
+ * plan, and a directive that only survives in a file the child may never open is a
+ * directive the agent drifts from. So the OPERATIVE plan travels in the checkpoint
+ * text itself, bounded, with its citation and the sha that still resolves the whole.
+ *
+ * "Operative" is session-level, not region-level — the newest submission on the log,
+ * whatever region it happened to fall in — because that is what "the current task"
+ * means to the agent reading the checkpoint.
+ */
+export function carryActivePlan(plans, opts) {
+    const operative = plans[plans.length - 1];
+    if (operative === undefined)
+        return null;
+    const title = operative.title === '' ? '(untitled plan)' : operative.title;
+    const body = operative.text.replace(/^#{1,6}\s+.+\n/, '').trim();
+    const clipped = body.length > opts.maxChars ? `${body.slice(0, opts.maxChars).trimEnd()}…` : body;
+    return [
+        `ACTIVE PLAN: "${title}" — ${STATUS_WORD[operative.status]} (submitted seq ${operative.seq}`
+            + (operative.resultSeq !== null ? `, answered seq ${operative.resultSeq}` : ', no verdict yet') + ')',
+        '',
+        clipped,
+        ...(body.length > opts.maxChars
+            // No hash claimed: at summarize time the chapter does not exist yet, and a
+            // sha we cannot verify would be a citation to nothing.
+            ? ['', '(carried truncated — the archive chapter holding this plan cites its complete text)']
+            : []),
+    ].join('\n');
+}
+/**
+ * Topics for a plan DOCUMENT: the file paths the plan names, plus its most
+ * characteristic terms. Same vocabulary as the transcript's index floor
+ * (`signature.chapterTopics`), deliberately re-derived here rather than imported —
+ * a plan is prose the agent wrote on purpose, so its own path mentions are the
+ * strongest signal about what it changes, and they must land in the same topic
+ * namespace the chapter index already uses.
+ */
+export function planTopicsOf(planText, maxTerms = 8) {
+    const paths = new Set();
+    for (const m of planText.matchAll(/([\w@.\-/]+\.[A-Za-z]{1,6})\b/g)) {
+        const p = m[1];
+        if (p.length > 3 && !p.startsWith('http'))
+            paths.add(p);
+    }
+    const stop = new Set(['plan', 'goal', 'tests', 'criteria', 'changes', 'subsystem', 'steps', 'summary', 'overview', 'context', 'assumptions', 'risks', 'rollback', 'acceptance', 'success', 'approach', 'implementation']);
+    const terms = new Map();
+    for (const raw of planText.toLowerCase().split(/[^a-z0-9_+.\-/]+/)) {
+        const t = raw.replace(/^[.+\-/]+|[.+\-/]+$/g, '');
+        if (t.length < 4 || t.length > 28 || stop.has(t) || /^\d+$/.test(t))
+            continue;
+        terms.set(t, (terms.get(t) ?? 0) + 1);
+    }
+    const top = [...terms.entries()].sort((a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : 1)).slice(0, maxTerms).map(([t]) => t);
+    return [...paths, ...top];
+}
+//# sourceMappingURL=plans.js.map

package/lib/plans.js.map

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