@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/core/classification-score.js

@@ -0,0 +1,107 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Deterministic facet scoring. Aliases are matched against the item head
+ * (title, tags, category; weight 3) and the opening of its description
+ * (weight 1). Candidates are sorted by score; the caller decides, the scorer
+ * only suggests. No model, no randomness: same input, same output.
+ *
+ * @see STORY-420 TASK-829
+ */
+const HEAD_WEIGHT = 3;
+const BODY_WEIGHT = 1;
+const BODY_CHARS = 600;
+/** Aliases this short only count as whole words: `api` must not match `rapid`. */
+const SHORT_ALIAS = 3;
+const MAX_TERMS = 4;
+const ROLE_PATTERN = /as an?\**\s+\**([^*,\n]+?)\**\s*,?\s*i want/i;
+/** True when `alias` occurs in `text`; short aliases need word boundaries. */
+export function aliasHits(alias, text) {
+    const needle = alias.toLowerCase().trim();
+    if (needle.length === 0)
+        return false;
+    if (needle.length <= SHORT_ALIAS) {
+        const escaped = needle.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return new RegExp(`(?<![a-z0-9])${escaped}(?![a-z0-9])`).test(text);
+    }
+    return text.includes(needle);
+}
+/** The searchable head of an item: title, tags and category, lower-cased. */
+export function headText(item) {
+    return `${item.title} ${(item.tags ?? []).join(' ')} ${item.category ?? ''}`.toLowerCase();
+}
+/** The opening of the description, lower-cased and capped. */
+export function bodyText(description) {
+    return description.slice(0, BODY_CHARS).toLowerCase();
+}
+/** Score every node of a facet against head and body; nodes without a hit are omitted. */
+export function scoreNodes(nodes, head, body) {
+    const hits = [];
+    for (const [node, spec] of Object.entries(nodes)) {
+        const headTerms = spec.aliases.filter((a) => aliasHits(a, head)).map((a) => a.trim());
+        const bodyTerms = spec.aliases
+            .filter((a) => aliasHits(a, body))
+            .map((a) => a.trim())
+            .filter((a) => !headTerms.includes(a));
+        const score = HEAD_WEIGHT * headTerms.length + BODY_WEIGHT * bodyTerms.length;
+        if (score > 0)
+            hits.push({ node, score, terms: [...headTerms, ...bodyTerms].slice(0, MAX_TERMS) });
+    }
+    return hits.sort((a, b) => b.score - a.score || a.node.localeCompare(b.node));
+}
+/** Component nodes whose path prefixes cover at least one affected path. */
+export function componentsFromPaths(paths, componentMap) {
+    const nodes = new Set();
+    for (const path of paths) {
+        for (const [node, prefixes] of Object.entries(componentMap)) {
+            if (prefixes.some((p) => path.startsWith(p) || path === p.replace(/\/$/, '')))
+                nodes.add(node);
+        }
+    }
+    return [...nodes].sort();
+}
+/**
+ * The role a user story names. The title is read first, then the description
+ * opening; a phrase outside the vocabulary is returned as written so the gap
+ * stays visible.
+ */
+export function roleFromStory(title, description, roles) {
+    const match = ROLE_PATTERN.exec(title) ?? ROLE_PATTERN.exec(description.slice(0, 800));
+    if (!match)
+        return null;
+    const phrase = match[1].trim().toLowerCase();
+    for (const [node, phrases] of Object.entries(roles)) {
+        if (phrases.some((p) => phrase.includes(p)))
+            return node;
+    }
+    return phrase;
+}
+/** Activity: the item type decides where declared, aliases otherwise, then the type default. */
+export function activityFor(item, head, body, activities) {
+    for (const [node, spec] of Object.entries(activities)) {
+        if (spec.types?.includes(item.type))
+            return [{ node, score: 9, terms: ['type'] }];
+    }
+    const scored = scoreNodes(activities, head, body);
+    if (scored.length > 0)
+        return scored;
+    for (const [node, spec] of Object.entries(activities)) {
+        if (spec.default_for?.includes(item.type))
+            return [{ node, score: 1, terms: ['default'] }];
+    }
+    return [];
+}
+/** Classify one item against a registry. */
+export function classifyItem(item, description, registry) {
+    const head = headText(item);
+    const body = bodyText(description);
+    return {
+        category: scoreNodes(registry.category, head, body),
+        component: componentsFromPaths(item.affected_paths ?? [], registry.component),
+        concern: scoreNodes(registry.concern, head, body),
+        activity: activityFor(item, head, body, registry.activity),
+        role: item.type === 'story' ? roleFromStory(item.title, description, registry.role) : null,
+    };
+}
+//# sourceMappingURL=classification-score.js.map

package/dist/core/classification-score.js.map

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

package/dist/core/classification-snapshot.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Classification snapshot: every selected item of a workspace with its facet
+ * suggestions, plus the registry summary a view needs to draw the rails.
+ *
+ * @see STORY-420 TASK-829
+ */
+import type { ItemStatus, ItemType } from '../schemas/index.js';
+import { type ClassificationRegistry, FACET_QUESTIONS } from './classification-registry.js';
+import { type ItemClassification } from './classification-score.js';
+export declare const OPEN_STATUSES: readonly ItemStatus[];
+export declare const DEFAULT_SNAPSHOT_TYPES: readonly ItemType[];
+export interface ClassificationSnapshotArgs {
+    types?: readonly ItemType[];
+    statuses?: readonly ItemStatus[];
+}
+export interface ClassifiedItem {
+    id: string;
+    type: ItemType;
+    status: ItemStatus;
+    title: string;
+    tags: string[];
+    category: string;
+    updated: string;
+    affected_paths: string[];
+    /** `field` when the item's category names a registry node, else `suggested` or `none`. */
+    category_source: 'field' | 'suggested' | 'none';
+    classification: ItemClassification;
+}
+export interface FacetSummary {
+    key: keyof typeof FACET_QUESTIONS;
+    question: string;
+    /** node → the node's own question, empty when it has none */
+    nodes: Record<string, string>;
+}
+export interface ClassificationSnapshot {
+    generated_at: string;
+    registry: {
+        source: ClassificationRegistry['source'];
+        path: string;
+    };
+    facets: FacetSummary[];
+    types: ItemType[];
+    statuses: ItemStatus[];
+    items: ClassifiedItem[];
+    unreadable: string[];
+}
+/**
+ * Build the snapshot for a workspace. Reads the registry once, lists the
+ * index, and classifies every item whose type and status are selected.
+ */
+export declare function buildClassificationSnapshot(devstepsDir: string, args?: ClassificationSnapshotArgs): Promise<ClassificationSnapshot>;
+//# sourceMappingURL=classification-snapshot.d.ts.map

package/dist/core/classification-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification-snapshot.d.ts","sourceRoot":"","sources":["../../src/core/classification-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,EAGhB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIlF,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAM9C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAAS,QAAQ,EAAsB,CAAC;AAE7E,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0FAA0F;IAC1F,eAAe,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;IAChD,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,OAAO,eAAe,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE;QAAE,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAuBD;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,0BAA+B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA6CjC"}

package/dist/core/classification-snapshot.js

@@ -0,0 +1,85 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Classification snapshot: every selected item of a workspace with its facet
+ * suggestions, plus the registry summary a view needs to draw the rails.
+ *
+ * @see STORY-420 TASK-829
+ */
+import { FACET_QUESTIONS, loadClassificationRegistry, UNCLASSIFIED, } from './classification-registry.js';
+import { classifyItem } from './classification-score.js';
+import { getItem } from './get.js';
+import { listItems } from './list.js';
+export const OPEN_STATUSES = [
+    'draft',
+    'planned',
+    'in-progress',
+    'review',
+    'blocked',
+];
+export const DEFAULT_SNAPSHOT_TYPES = ['epic', 'story'];
+function summarizeFacets(registry) {
+    const questions = (nodes) => Object.fromEntries(Object.entries(nodes).map(([n, spec]) => [n, spec.q ?? '']));
+    const plain = (names) => Object.fromEntries(names.map((n) => [n, '']));
+    return [
+        { key: 'category', question: FACET_QUESTIONS.category, nodes: questions(registry.category) },
+        {
+            key: 'component',
+            question: FACET_QUESTIONS.component,
+            nodes: plain(Object.keys(registry.component)),
+        },
+        { key: 'concern', question: FACET_QUESTIONS.concern, nodes: questions(registry.concern) },
+        {
+            key: 'activity',
+            question: FACET_QUESTIONS.activity,
+            nodes: plain(Object.keys(registry.activity)),
+        },
+        { key: 'role', question: FACET_QUESTIONS.role, nodes: plain(Object.keys(registry.role)) },
+    ];
+}
+/**
+ * Build the snapshot for a workspace. Reads the registry once, lists the
+ * index, and classifies every item whose type and status are selected.
+ */
+export async function buildClassificationSnapshot(devstepsDir, args = {}) {
+    const registry = loadClassificationRegistry(devstepsDir);
+    const types = [...(args.types ?? DEFAULT_SNAPSHOT_TYPES)];
+    const statuses = [...(args.statuses ?? OPEN_STATUSES)];
+    const wanted = new Set(statuses);
+    const typeSet = new Set(types);
+    const listed = await listItems(devstepsDir, {});
+    const picked = listed.items.filter((i) => typeSet.has(i.type) && wanted.has(i.status));
+    const items = await Promise.all(picked.map(async (entry) => {
+        const { metadata, description } = await getItem(devstepsDir, entry.id);
+        const classification = classifyItem(metadata, description, registry);
+        const confirmed = metadata.category !== UNCLASSIFIED && metadata.category in registry.category;
+        return {
+            id: metadata.id,
+            type: metadata.type,
+            status: metadata.status,
+            title: metadata.title,
+            tags: metadata.tags,
+            category: metadata.category,
+            updated: metadata.updated,
+            affected_paths: metadata.affected_paths,
+            category_source: confirmed
+                ? 'field'
+                : classification.category.length
+                    ? 'suggested'
+                    : 'none',
+            classification,
+        };
+    }));
+    items.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }));
+    return {
+        generated_at: new Date().toISOString(),
+        registry: { source: registry.source, path: registry.path },
+        facets: summarizeFacets(registry),
+        types,
+        statuses,
+        items,
+        unreadable: listed.unreadable,
+    };
+}
+//# sourceMappingURL=classification-snapshot.js.map

package/dist/core/classification-snapshot.js.map

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

package/dist/core/closeout-branch-record.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Branch records of the session close-out (EPIC-061): the fixed, greppable block a session leaves
+ * in a work item's master document so any successor finds branch, head, base, verdict, merge
+ * recipe and worktree without waking the old session. A record is a point-in-time copy: the merge
+ * queue rebases, so `verifyBranchRecords` compares the recorded head with the branch as it is now.
+ */
+export type BranchVerdict = 'ready-to-merge' | 'parked' | 'wip' | `superseded-by ${string}`;
+export interface BranchRecord {
+    branch: string;
+    /** `.` for the superproject, the contained repository path otherwise. */
+    repository: string;
+    head: string;
+    base: string;
+    verdict: BranchVerdict;
+    recipe: string;
+    worktree: string | null;
+    recorded_at: string;
+}
+export interface VerifiedBranchRecord extends BranchRecord {
+    /** The branch's tip now; null when the branch or its repository is gone. */
+    current_head: string | null;
+    stale: boolean;
+}
+export declare const BRANCH_RECORDS_HEADING = "## Branch records";
+export declare function isBranchVerdict(value: unknown): value is BranchVerdict;
+export declare function renderBranchRecord(record: BranchRecord): string;
+/** Every well-formed block of the description; a malformed block is skipped. */
+export declare function parseBranchRecords(description: string): BranchRecord[];
+/**
+ * Appends a block at the end of the section `heading`, creating the section at the end of the
+ * description when absent. Everything outside the insertion point stays byte-identical.
+ */
+export declare function appendToSection(description: string, heading: string, block: string): string;
+/** Replaces the block with the same repository and branch, else appends under the section. */
+export declare function upsertBranchRecord(description: string, record: BranchRecord): string;
+export interface BranchRecordInput {
+    item_id: string;
+    branch: string;
+    repository?: string;
+    head?: string;
+    base?: string;
+    verdict: string;
+    recipe?: string;
+    worktree?: string | null;
+    mainline?: string;
+    repoPath: string;
+    now?: () => Date;
+}
+/** Validates the verdict and fills head and base from the repository when not given. */
+export declare function resolveBranchRecord(input: BranchRecordInput): BranchRecord;
+/** Compares each recorded head with the branch as it is now in the record's repository. */
+export declare function verifyBranchRecords(repoPath: string, records: readonly BranchRecord[]): VerifiedBranchRecord[];
+//# sourceMappingURL=closeout-branch-record.d.ts.map

package/dist/core/closeout-branch-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closeout-branch-record.d.ts","sourceRoot":"","sources":["../../src/core/closeout-branch-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,QAAQ,GAAG,KAAK,GAAG,iBAAiB,MAAM,EAAE,CAAC;AAE5F,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,4EAA4E;IAC5E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAM1D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAItE;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAc/D;AAiCD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAOtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAY3F;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CASpF;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AA+CD,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAiC1E;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,oBAAoB,EAAE,CAWxB"}

package/dist/core/closeout-branch-record.js

@@ -0,0 +1,201 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Branch records of the session close-out (EPIC-061): the fixed, greppable block a session leaves
+ * in a work item's master document so any successor finds branch, head, base, verdict, merge
+ * recipe and worktree without waking the old session. A record is a point-in-time copy: the merge
+ * queue rebases, so `verifyBranchRecords` compares the recorded head with the branch as it is now.
+ */
+import { git, tryGit } from './closeout-git.js';
+import { resolveRecordRepository } from './closeout-repository.js';
+export const BRANCH_RECORDS_HEADING = '## Branch records';
+const BLOCK_PATTERN = /<!-- devsteps:branch-record repository=(.*?) branch=(\S+) -->\r?\n([\s\S]*?)<!-- \/devsteps:branch-record -->/g;
+const SHA = /^[0-9a-f]{40}$/;
+const SIMPLE_VERDICTS = ['ready-to-merge', 'parked', 'wip'];
+export function isBranchVerdict(value) {
+    if (typeof value !== 'string')
+        return false;
+    if (SIMPLE_VERDICTS.includes(value))
+        return true;
+    return /^superseded-by \S[^\r\n]*$/.test(value);
+}
+function oneLine(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+export function renderBranchRecord(record) {
+    const recipe = oneLine(record.recipe) || 'n/a';
+    return [
+        `<!-- devsteps:branch-record repository=${record.repository} branch=${record.branch} -->`,
+        `- Branch: \`${record.branch}\``,
+        `- Repository: ${record.repository}`,
+        `- Head: \`${record.head}\``,
+        `- Base: \`${record.base}\``,
+        `- Verdict: ${record.verdict}`,
+        `- Merge recipe: ${recipe}`,
+        `- Worktree: ${record.worktree ? `\`${record.worktree}\`` : 'none'}`,
+        `- Recorded: ${record.recorded_at}`,
+        '<!-- /devsteps:branch-record -->',
+    ].join('\n');
+}
+function field(body, label) {
+    const match = new RegExp(`^- ${label}: (.*?)\\s*$`, 'm').exec(body);
+    return match ? (match[1] ?? '') : null;
+}
+function unquote(value) {
+    if (value === null)
+        return null;
+    const match = /^`(.*)`$/.exec(value);
+    return match ? (match[1] ?? '') : value;
+}
+function parseBlock(repository, branch, body) {
+    const head = unquote(field(body, 'Head'));
+    const base = unquote(field(body, 'Base'));
+    const verdict = field(body, 'Verdict');
+    if (!head || !base || !SHA.test(head) || !SHA.test(base) || !isBranchVerdict(verdict)) {
+        return null;
+    }
+    const worktree = unquote(field(body, 'Worktree'));
+    return {
+        branch,
+        repository,
+        head,
+        base,
+        verdict,
+        recipe: field(body, 'Merge recipe') ?? 'n/a',
+        worktree: worktree && worktree !== 'none' ? worktree : null,
+        recorded_at: field(body, 'Recorded') ?? '',
+    };
+}
+/** Every well-formed block of the description; a malformed block is skipped. */
+export function parseBranchRecords(description) {
+    const records = [];
+    for (const match of description.matchAll(BLOCK_PATTERN)) {
+        const record = parseBlock(match[1] ?? '', match[2] ?? '', match[3] ?? '');
+        if (record)
+            records.push(record);
+    }
+    return records;
+}
+/**
+ * Appends a block at the end of the section `heading`, creating the section at the end of the
+ * description when absent. Everything outside the insertion point stays byte-identical.
+ */
+export function appendToSection(description, heading, block) {
+    const start = description.search(new RegExp(`^${heading}[ \\t\\r]*$`, 'm'));
+    if (start === -1) {
+        const base = description.replace(/\s+$/, '');
+        return `${base ? `${base}\n\n` : ''}${heading}\n\n${block}\n`;
+    }
+    const afterHeading = start + heading.length;
+    const next = description.slice(afterHeading).search(/^## /m);
+    const end = next === -1 ? description.length : afterHeading + next;
+    const before = description.slice(0, end).replace(/\s+$/, '');
+    const after = description.slice(end);
+    return `${before}\n\n${block}\n${after ? `\n${after}` : ''}`;
+}
+/** Replaces the block with the same repository and branch, else appends under the section. */
+export function upsertBranchRecord(description, record) {
+    const rendered = renderBranchRecord(record);
+    let replaced = false;
+    const next = description.replace(BLOCK_PATTERN, (whole, repository, branch) => {
+        if (replaced || repository !== record.repository || branch !== record.branch)
+            return whole;
+        replaced = true;
+        return rendered;
+    });
+    return replaced ? next : appendToSection(description, BRANCH_RECORDS_HEADING, rendered);
+}
+/** Text that lands in the block must not close, open or split a block. */
+function assertSafeText(label, value, extra) {
+    if (/[\r\n]|-->|<!--/.test(value)) {
+        throw new Error(`${label} must not contain line breaks, "<!--" or "-->"`);
+    }
+    if (extra?.[0].test(value))
+        throw new Error(`${label} must not contain ${extra[1]}`);
+}
+function tipOf(dir, branch) {
+    const result = tryGit(['rev-parse', '--verify', '--quiet', `refs/heads/${branch}^{commit}`], {
+        cwd: dir,
+    });
+    return result.ok ? result.stdout.trim() : null;
+}
+/** A real branch name: refs/heads/<name> is then a ref, never rev syntax such as main~1. */
+function assertBranchName(cwd, branch) {
+    const valid = branch !== '' &&
+        !branch.startsWith('-') &&
+        !branch.includes('@{') &&
+        // biome-ignore lint/suspicious/noControlCharactersInRegex: control characters are the point
+        !/[\x00-\x20\x7f]/.test(branch) &&
+        tryGit(['check-ref-format', '--branch', branch], { cwd }).ok;
+    if (!valid)
+        throw new Error(`Invalid branch name "${branch}"`);
+}
+/** An explicit head or base must be a full SHA that names a commit in the target repository. */
+function verifiedCommit(dir, label, value) {
+    if (!SHA.test(value))
+        throw new Error(`${label} must be a full 40-hex commit SHA, got "${value}"`);
+    const result = tryGit(['rev-parse', '--verify', '--quiet', `${value}^{commit}`], { cwd: dir });
+    if (!result.ok)
+        throw new Error(`${label} ${value} is not a commit in this repository`);
+    return result.stdout.trim();
+}
+function resolveMainline(dir, given) {
+    if (given)
+        assertBranchName(dir, given);
+    const candidates = given ? [given] : ['main', 'master'];
+    for (const name of candidates) {
+        if (tipOf(dir, name))
+            return name;
+    }
+    throw new Error(`No mainline branch found (${candidates.join(', ')}); pass mainline`);
+}
+/** Validates the verdict and fills head and base from the repository when not given. */
+export function resolveBranchRecord(input) {
+    if (!isBranchVerdict(input.verdict)) {
+        throw new Error(`Invalid verdict "${input.verdict}": use ready-to-merge, parked, wip or superseded-by <sha-or-branch>`);
+    }
+    assertBranchName(input.repoPath, input.branch);
+    const given = input.repository?.trim() || '.';
+    assertSafeText('Branch', input.branch);
+    assertSafeText('Repository', given, [/ branch=/, '" branch="']);
+    assertSafeText('Verdict', input.verdict);
+    assertSafeText('Recipe', input.recipe ?? '');
+    assertSafeText('Worktree', input.worktree ?? '', [/`/, 'a backtick']);
+    const { repository, directory: dir } = resolveRecordRepository(input.repoPath, given);
+    assertSafeText('Repository', repository, [/ branch=/, '" branch="']);
+    const tip = tipOf(dir, input.branch);
+    if (!tip)
+        throw new Error(`Branch ${input.branch} not found in repository ${repository}`);
+    const head = input.head === undefined ? tip : verifiedCommit(dir, 'Head', input.head);
+    const base = input.base === undefined
+        ? git(['merge-base', resolveMainline(dir, input.mainline), head], { cwd: dir }).trim()
+        : verifiedCommit(dir, 'Base', input.base);
+    if (!SHA.test(base))
+        throw new Error(`Base must be a full 40-hex commit SHA, got "${base}"`);
+    return {
+        branch: input.branch,
+        repository,
+        head,
+        base,
+        verdict: input.verdict,
+        recipe: input.recipe ?? 'n/a',
+        worktree: input.worktree ?? null,
+        recorded_at: (input.now?.() ?? new Date()).toISOString(),
+    };
+}
+/** Compares each recorded head with the branch as it is now in the record's repository. */
+export function verifyBranchRecords(repoPath, records) {
+    return records.map((record) => {
+        let currentHead = null;
+        try {
+            const { directory } = resolveRecordRepository(repoPath, record.repository);
+            currentHead = tipOf(directory, record.branch);
+        }
+        catch {
+            currentHead = null;
+        }
+        return { ...record, current_head: currentHead, stale: currentHead !== record.head };
+    });
+}
+//# sourceMappingURL=closeout-branch-record.js.map

package/dist/core/closeout-branch-record.js.map

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

package/dist/core/closeout-classify.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Branch classification for the session close-out (EPIC-061). `rev-list main..branch` misleads
+ * because the merge queue rebases, so a branch is classified in steps: nothing ahead means
+ * contained; `git cherry` with no '+' means patch-equivalent; commits that the mainline carries
+ * under the same subject or item ID after a rework make it reworked; anything else stays
+ * unmerged. The content check of reworked and unmerged branches is a judgment step for a human
+ * or an analyst, not for this module.
+ *
+ * Read-only apart from `merge-tree --write-tree`, which writes unreachable objects only.
+ */
+import type { BranchInventory } from './closeout-types.js';
+export type BranchClassification = Omit<BranchInventory, 'upstream' | 'unpushed' | 'duplicates' | 'worktree'>;
+/** A branch in a repository without a mainline: nothing to compare against, so never contained. */
+export declare function classifyWithoutMainline(repoPath: string, branch: string): BranchClassification;
+/**
+ * Classifies one local branch against the mainline in about six git calls: rev-parse, rev-list,
+ * cherry, the branch log, and for diverged branches merge-base, the mainline log and merge-tree.
+ */
+export declare function classifyBranch(repoPath: string, branch: string, mainline: string, options?: {
+    conflicts?: boolean;
+}): BranchClassification;
+//# sourceMappingURL=closeout-classify.d.ts.map

package/dist/core/closeout-classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closeout-classify.d.ts","sourceRoot":"","sources":["../../src/core/closeout-classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAEV,eAAe,EAIhB,MAAM,qBAAqB,CAAC;AAc7B,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,eAAe,EACf,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CACpD,CAAC;AA4GF,mGAAmG;AACnG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAe9F;AA4DD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,oBAAoB,CA2EtB"}