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

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

@@ -0,0 +1,18 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * The session close-out inventory (EPIC-061): worktrees, branches and their classification for
+ * the session's own worktrees or for a whole repository with its submodules. Headless and
+ * read-only: only read commands run, never fetch, gc, prune, checkout or anything that writes
+ * refs, the index or worktree files. The one exception is `merge-tree --write-tree`, which adds
+ * unreachable objects to the object store and nothing else.
+ */
+import type { CloseoutInventory, CloseoutOptions } from './closeout-types.js';
+export { assertKnownWorktree, listSubmodules, listWorktrees, resolveMainline, } from './closeout-worktrees.js';
+/**
+ * Inventories the session's own worktrees (default) or the whole repository with its
+ * submodules. Changes nothing.
+ */
+export declare function closeoutInventory(repoPath: string, options?: CloseoutOptions): CloseoutInventory;
+//# sourceMappingURL=closeout-inventory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"closeout-inventory.d.ts","sourceRoot":"","sources":["../../src/core/closeout-inventory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,KAAK,EAEV,iBAAiB,EACjB,eAAe,EAGhB,MAAM,qBAAqB,CAAC;AAa7B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAyPjC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC5B,iBAAiB,CA6CnB"}

package/dist/core/closeout-inventory.js

@@ -0,0 +1,251 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * The session close-out inventory (EPIC-061): worktrees, branches and their classification for
+ * the session's own worktrees or for a whole repository with its submodules. Headless and
+ * read-only: only read commands run, never fetch, gc, prune, checkout or anything that writes
+ * refs, the index or worktree files. The one exception is `merge-tree --write-tree`, which adds
+ * unreachable objects to the object store and nothing else.
+ */
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { classifyBranch, classifyWithoutMainline } from './closeout-classify.js';
+import { git, gitLines, tryGit } from './closeout-git.js';
+import { closeoutLocalDate, closeoutStatusLine } from './closeout-handover-draft.js';
+import { buildRows } from './closeout-rows.js';
+import { projectSecretPatterns } from './closeout-secrets.js';
+import { assertKnownWorktree, currentBranchName, findMainline, inspectWorktrees, keepCaseRelative, listSubmodules, normalizePath, rawWorktrees, } from './closeout-worktrees.js';
+export { assertKnownWorktree, listSubmodules, listWorktrees, resolveMainline, } from './closeout-worktrees.js';
+const MIN_MERGE_TREE = [2, 38];
+/** `merge-tree --write-tree` needs git 2.38; the version is read once per run. */
+function mergeTreeAvailable(cwd) {
+    const match = /(\d+)\.(\d+)/.exec(tryGit(['--version'], { cwd }).stdout);
+    if (!match)
+        return false;
+    const [major, minor] = [Number(match[1]), Number(match[2])];
+    return major > MIN_MERGE_TREE[0] || (major === MIN_MERGE_TREE[0] && minor >= MIN_MERGE_TREE[1]);
+}
+function listHeads(cwd) {
+    // refname:short drops "heads/" when a tag of the same name exists; strip the prefix instead.
+    const format = '%(refname)%09%(objectname)%09%(upstream:short)';
+    return gitLines(['for-each-ref', `--format=${format}`, 'refs/heads'], { cwd }).map((line) => {
+        const [name = '', sha = '', upstream = ''] = line.split('\t');
+        return { name: name.replace(/^refs\/heads\//, ''), sha, upstream: upstream || null };
+    });
+}
+function unpushedCount(cwd, upstream, head) {
+    if (!upstream)
+        return null;
+    const result = tryGit(['rev-list', '--count', `${upstream}..${head}`], { cwd });
+    return result.ok ? Number.parseInt(result.stdout.trim(), 10) : null;
+}
+/** The mainline, or null when none resolves; an explicit one that is missing throws for the superproject. */
+function mainlineFor(spec, options) {
+    if (!options.mainline)
+        return findMainline(spec.path);
+    if (spec.kind === 'superproject')
+        return findMainline(spec.path, options.mainline);
+    try {
+        return findMainline(spec.path, options.mainline);
+    }
+    catch {
+        return findMainline(spec.path);
+    }
+}
+function selectBranches(heads, mainline, worktrees, spec, extra) {
+    const known = new Set(heads.map((head) => head.name));
+    const names = spec.members
+        ? [...worktrees.map((worktree) => worktree.branch ?? ''), ...extra]
+        : heads.map((head) => head.name).filter((name) => !name.startsWith('rescue/'));
+    return [...new Set(names)].filter((name) => known.has(name) && name !== mainline);
+}
+function branchInventory(spec, name, mainline, heads, raws, ctx) {
+    const classified = mainline === null
+        ? classifyWithoutMainline(spec.path, name)
+        : classifyBranch(spec.path, name, mainline, { conflicts: ctx.conflicts });
+    const head = heads.find((entry) => entry.name === name);
+    return {
+        ...classified,
+        upstream: head?.upstream ?? null,
+        unpushed: unpushedCount(spec.path, head?.upstream ?? null, classified.head),
+        duplicates: heads
+            .filter((other) => other.name !== name &&
+            other.sha === classified.head &&
+            other.name !== mainline &&
+            !other.name.startsWith('rescue/'))
+            .map((other) => other.name),
+        worktree: raws.find((raw) => raw.branch === name)?.path ?? null,
+    };
+}
+/**
+ * Commits of a detached HEAD that no local branch, remote-tracking branch or the mainline holds
+ * (a submodule checkout pinned to a pushed commit is not at risk).
+ */
+function applyDetached(cwd, worktrees, mainline) {
+    for (const worktree of worktrees) {
+        if (worktree.branch !== null || !worktree.head || !worktree.exists)
+            continue;
+        const exclude = mainline === null ? ['--branches', '--remotes'] : [mainline, '--branches', '--remotes'];
+        const count = tryGit(['rev-list', '--count', worktree.head, '--not', ...exclude], { cwd });
+        worktree.unreachable_commits = count.ok ? Number.parseInt(count.stdout.trim(), 10) : 1;
+        if (worktree.unreachable_commits > 0)
+            worktree.removal_blockers.push('unreachable commits');
+    }
+}
+/** A worktree is removable when nothing in it is unique: its branch is contained or equivalent. */
+function applyRemoval(worktrees, branches, mainline) {
+    for (const worktree of worktrees) {
+        if (mainline === null)
+            worktree.removal_blockers.push('no mainline');
+        if (worktree.branch !== null) {
+            const branch = branches.find((entry) => entry.name === worktree.branch);
+            if (worktree.branch === mainline)
+                worktree.removal_blockers.push('mainline branch');
+            else if (!branch)
+                worktree.removal_blockers.push('branch unclassified');
+            else if (branch && branch.class !== 'contained' && branch.class !== 'patch-equivalent') {
+                worktree.removal_blockers.push(`branch ${branch.class}`);
+            }
+        }
+        worktree.removable = worktree.removal_blockers.length === 0;
+    }
+}
+/** A branch checked out in a worktree that stays is kept too, and says why. */
+function noteBlockedWorktrees(branches, worktrees) {
+    for (const branch of branches) {
+        if (branch.suggested_action === 'keep' || branch.suggested_action === undefined)
+            continue;
+        const worktree = worktrees.find((entry) => entry.branch === branch.name);
+        if (!worktree && branch.worktree) {
+            // Session scope: the checkout is outside the inspected set, so nobody checked it is clean.
+            branch.suggested_action = 'keep';
+            branch.note = `checked out in ${branch.worktree} outside this scope`;
+            continue;
+        }
+        if (!worktree || worktree.removable)
+            continue;
+        // The branch's own class blocks its worktree by design; only the other blockers keep it.
+        const blockers = worktree.removal_blockers.filter((entry) => !entry.startsWith('branch '));
+        if (blockers.length === 0)
+            continue;
+        branch.suggested_action = 'keep';
+        branch.note = `worktree ${blockers.join(', ')}`;
+    }
+}
+function buildRepository(spec, ctx) {
+    const found = mainlineFor(spec, ctx.options);
+    const mainline = found ?? currentBranchName(spec.path);
+    const raws = rawWorktrees(spec.path);
+    const members = spec.members;
+    const worktrees = inspectWorktrees(spec.path, ctx.patterns, members ? { include: (path) => members.has(normalizePath(path)), ignored: true } : undefined);
+    const heads = listHeads(spec.path);
+    const names = selectBranches(heads, found, worktrees, spec, ctx.options.branches ?? []);
+    const branches = names.map((name) => branchInventory(spec, name, found, heads, raws, ctx));
+    applyDetached(spec.path, worktrees, found);
+    applyRemoval(worktrees, branches, found);
+    noteBlockedWorktrees(branches, worktrees);
+    const mainlineHead = found
+        ? tryGit(['rev-parse', '--verify', '--quiet', `${found}^{commit}`], { cwd: spec.path })
+        : null;
+    return {
+        path: spec.path,
+        kind: spec.kind,
+        name: spec.name,
+        mainline,
+        mainline_head: mainlineHead?.ok ? mainlineHead.stdout.trim() : '',
+        mainline_missing: found === null,
+        worktrees,
+        branches,
+        preserved: {
+            archive_tags: gitLines(['for-each-ref', '--format=%(refname)', 'refs/tags/archive/'], {
+                cwd: spec.path,
+            }).length,
+            rescue_refs: heads.filter((head) => head.name.startsWith('rescue/')).map((head) => head.name),
+        },
+        conflicts_available: ctx.available,
+    };
+}
+function repositorySpecs(top) {
+    return [
+        { path: top, kind: 'superproject', name: '.', members: null },
+        ...listSubmodules(top).map((sub) => ({ path: sub.path, kind: 'submodule', name: sub.name, members: null })),
+    ];
+}
+function relativeName(listed, path) {
+    const wanted = normalizePath(path);
+    for (const worktree of listed) {
+        const base = `${normalizePath(worktree.path)}/`;
+        if (wanted.startsWith(base))
+            return keepCaseRelative(wanted.slice(base.length), path);
+    }
+    return keepCaseRelative(wanted.split('/').pop() ?? wanted, path);
+}
+/** Session scope: each requested worktree and the submodule checkouts inside it. */
+function sessionSpecs(top, requested) {
+    const listed = rawWorktrees(top);
+    const members = [...requested];
+    for (const path of requested) {
+        if (existsSync(path))
+            members.push(...listSubmodules(path).map((sub) => sub.path));
+    }
+    const specs = new Map();
+    for (const member of members) {
+        const primary = existsSync(member) ? (rawWorktrees(member)[0]?.path ?? member) : top;
+        const key = normalizePath(primary);
+        let spec = specs.get(key);
+        if (!spec) {
+            const isTop = key === normalizePath(top);
+            spec = {
+                path: primary,
+                kind: isTop ? 'superproject' : 'submodule',
+                name: isTop ? '.' : relativeName(listed, member),
+                members: new Set(),
+            };
+            specs.set(key, spec);
+        }
+        spec.members?.add(normalizePath(member));
+    }
+    return [...specs.values()].sort((a, b) => Number(b.kind === 'superproject') - Number(a.kind === 'superproject') ||
+        a.name.localeCompare(b.name));
+}
+/**
+ * Inventories the session's own worktrees (default) or the whole repository with its
+ * submodules. Changes nothing.
+ */
+export function closeoutInventory(repoPath, options = {}) {
+    const scope = options.scope ?? 'session';
+    const top = rawWorktrees(repoPath)[0]?.path ?? repoPath;
+    const devsteps = join(top, '.devsteps');
+    const available = mergeTreeAvailable(repoPath);
+    const ctx = {
+        options,
+        available,
+        patterns: options.secretPatterns ?? projectSecretPatterns(existsSync(devsteps) ? devsteps : null),
+        conflicts: options.conflicts !== false && available,
+    };
+    let specs;
+    if (scope === 'repository')
+        specs = repositorySpecs(top);
+    else {
+        const given = options.worktrees?.length
+            ? options.worktrees.map((path) => resolve(repoPath, path))
+            : [git(['rev-parse', '--show-toplevel'], { cwd: repoPath }).trim()];
+        specs = sessionSpecs(top, given.map((path) => assertKnownWorktree(repoPath, path)));
+    }
+    const repositories = specs.map((spec) => buildRepository(spec, ctx));
+    const inventory = {
+        generated_at: (options.now?.() ?? new Date()).toISOString(),
+        scope,
+        repositories,
+        rows: buildRows(repositories),
+        archivable: repositories.every((repository) => repository.worktrees.every((worktree) => worktree.changed.length === 0 &&
+            worktree.secret_paths.length === 0 &&
+            worktree.unreachable_commits === 0 &&
+            !worktree.removal_blockers.includes('status unavailable'))),
+        status_line: '',
+    };
+    inventory.status_line = closeoutStatusLine(inventory, closeoutLocalDate(options.now?.() ?? new Date()));
+    return inventory;
+}
+//# sourceMappingURL=closeout-inventory.js.map

package/dist/core/closeout-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closeout-inventory.js","sourceRoot":"","sources":["../../src/core/closeout-inventory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAQ9D,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,EAEb,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAwBjC,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAE/B,kFAAkF;AAClF,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,6FAA6F;IAC7F,MAAM,MAAM,GAAG,gDAAgD,CAAC;IAChE,OAAO,QAAQ,CAAC,CAAC,cAAc,EAAE,YAAY,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1F,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,QAAuB,EAAE,IAAY;IACvE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,QAAQ,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC;AAED,6GAA6G;AAC7G,SAAS,WAAW,CAAC,IAAc,EAAE,OAAwB;IAC3D,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnF,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,KAAsB,EACtB,QAAuB,EACvB,SAAuC,EACvC,IAAc,EACd,KAAwB;IAExB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO;QACxB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC;QACnE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,eAAe,CACtB,IAAc,EACd,IAAY,EACZ,QAAuB,EACvB,KAAsB,EACtB,IAA4B,EAC5B,GAAe;IAEf,MAAM,UAAU,GACd,QAAQ,KAAK,IAAI;QACf,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAC1C,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACxD,OAAO;QACL,GAAG,UAAU;QACb,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;QAChC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;QAC3E,UAAU,EAAE,KAAK;aACd,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,KAAK,IAAI;YACnB,KAAK,CAAC,GAAG,KAAK,UAAU,CAAC,IAAI;YAC7B,KAAK,CAAC,IAAI,KAAK,QAAQ;YACvB,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CACpC;aACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,IAAI,IAAI,IAAI;KAChE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,GAAW,EAAE,SAA8B,EAAE,QAAuB;IACzF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,SAAS;QAC7E,MAAM,OAAO,GACX,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAC1F,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3F,QAAQ,CAAC,mBAAmB,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,QAAQ,CAAC,mBAAmB,GAAG,CAAC;YAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,SAAS,YAAY,CACnB,SAA8B,EAC9B,QAAoC,EACpC,QAAuB;IAEvB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,KAAK,IAAI;YAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxE,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ;gBAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;iBAC/E,IAAI,CAAC,MAAM;gBAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;iBACnE,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,KAAK,kBAAkB,EAAE,CAAC;gBACvF,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAS,oBAAoB,CAC3B,QAA2B,EAC3B,SAAuC;IAEvC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,gBAAgB,KAAK,MAAM,IAAI,MAAM,CAAC,gBAAgB,KAAK,SAAS;YAAE,SAAS;QAC1F,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACjC,2FAA2F;YAC3F,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC;YACjC,MAAM,CAAC,IAAI,GAAG,kBAAkB,MAAM,CAAC,QAAQ,qBAAqB,CAAC;YACrE,SAAS;QACX,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS;YAAE,SAAS;QAC9C,yFAAyF;QACzF,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC;QACjC,MAAM,CAAC,IAAI,GAAG,YAAY,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAClD,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAc,EAAE,GAAe;IACtD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,KAAK,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,SAAS,GAAG,gBAAgB,CAChC,IAAI,CAAC,IAAI,EACT,GAAG,CAAC,QAAQ,EACZ,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAC7F,CAAC;IACF,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3F,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3C,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzC,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,KAAK;QACxB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvF,CAAC,CAAC,IAAI,CAAC;IACT,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ;QACR,aAAa,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;QACjE,gBAAgB,EAAE,KAAK,KAAK,IAAI;QAChC,SAAS;QACT,QAAQ;QACR,SAAS,EAAE;YACT,YAAY,EAAE,QAAQ,CAAC,CAAC,cAAc,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,EAAE;gBACpF,GAAG,EAAE,IAAI,CAAC,IAAI;aACf,CAAC,CAAC,MAAM;YACT,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SAC9F;QACD,mBAAmB,EAAE,GAAG,CAAC,SAAS;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO;QACL,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;QAC7D,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,CACxB,CAAC,GAAG,EAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAC1F;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAA8B,EAAE,IAAY;IAChE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAChD,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,oFAAoF;AACpF,SAAS,YAAY,CAAC,GAAW,EAAE,SAA4B;IAC7D,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACrF,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,GAAG,KAAK,aAAa,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,GAAG;gBACL,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW;gBAC1C,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC;gBAChD,OAAO,EAAE,IAAI,GAAG,EAAE;aACnB,CAAC;YACF,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,OAAO,GAAoB,EAAE;IAE7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;IACzC,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,QAAQ,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAe;QACtB,OAAO;QACP,SAAS;QACT,QAAQ,EACN,OAAO,CAAC,cAAc,IAAI,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACzF,SAAS,EAAE,OAAO,CAAC,SAAS,KAAK,KAAK,IAAI,SAAS;KACpD,CAAC;IACF,IAAI,KAAiB,CAAC;IACtB,IAAI,KAAK,KAAK,YAAY;QAAE,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;SACpD,CAAC;QACJ,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,MAAM;YACrC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,KAAK,GAAG,YAAY,CAClB,GAAG,EACH,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CACzD,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,SAAS,GAAsB;QACnC,YAAY,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;QAC3D,KAAK;QACL,YAAY;QACZ,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC;QAC7B,UAAU,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAC5C,UAAU,CAAC,SAAS,CAAC,KAAK,CACxB,CAAC,QAAQ,EAAE,EAAE,CACX,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAC7B,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAClC,QAAQ,CAAC,mBAAmB,KAAK,CAAC;YAClC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAC5D,CACF;QACD,WAAW,EAAE,EAAE;KAChB,CAAC;IACF,SAAS,CAAC,WAAW,GAAG,kBAAkB,CACxC,SAAS,EACT,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CACjD,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Preserves gitignored artefacts for the session close-out (EPIC-061): files and folders are
+ * copied into a durable, gitignored folder of the project and verified by sha256 before and
+ * after the copy, so the item can name location and hash.
+ */
+export interface PreservedArtifact {
+    source: string;
+    target: string;
+    sha256: string;
+    bytes: number;
+}
+/**
+ * The canonical form of `path`, which need not exist: the real path of its deepest existing
+ * folder with the rest appended. git reports canonical paths, so a path typed through a link
+ * (macOS reaches /private/var as /var) compares with them only in this form.
+ */
+export declare function canonicalPath(path: string): string;
+/** Copies the sources to `<targetDir>/<date>/<basename>` and returns one entry per file. */
+export declare function preserveArtifacts(repoPath: string, sources: readonly string[], targetDir: string, date: string): PreservedArtifact[];
+//# sourceMappingURL=closeout-preserve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"closeout-preserve.d.ts","sourceRoot":"","sources":["../../src/core/closeout-preserve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAwBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAkED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,iBAAiB,EAAE,CAmBrB"}

package/dist/core/closeout-preserve.js

@@ -0,0 +1,123 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Preserves gitignored artefacts for the session close-out (EPIC-061): files and folders are
+ * copied into a durable, gitignored folder of the project and verified by sha256 before and
+ * after the copy, so the item can name location and hash.
+ */
+import { createHash } from 'node:crypto';
+import { closeSync, copyFileSync, existsSync, lstatSync, mkdirSync, openSync, readdirSync, readSync, realpathSync, rmSync, statSync, } from 'node:fs';
+import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { tryGit } from './closeout-git.js';
+/** Streamed in blocks, so a file of any size hashes without being held in memory. */
+function sha256(file) {
+    const hash = createHash('sha256');
+    const buffer = Buffer.allocUnsafe(1 << 20);
+    const fd = openSync(file, 'r');
+    try {
+        for (;;) {
+            const read = readSync(fd, buffer, 0, buffer.length, null);
+            if (read === 0)
+                break;
+            hash.update(buffer.subarray(0, read));
+        }
+    }
+    finally {
+        closeSync(fd);
+    }
+    return hash.digest('hex');
+}
+function isInside(parent, child) {
+    const rel = relative(parent, child);
+    return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
+}
+/**
+ * The canonical form of `path`, which need not exist: the real path of its deepest existing
+ * folder with the rest appended. git reports canonical paths, so a path typed through a link
+ * (macOS reaches /private/var as /var) compares with them only in this form.
+ */
+export function canonicalPath(path) {
+    let existing = path;
+    while (!existsSync(existing) && dirname(existing) !== existing)
+        existing = dirname(existing);
+    return join(realpathSync(existing), relative(existing, path));
+}
+function assertTargetDir(repoPath, targetDir) {
+    const root = realpathSync(repoPath);
+    // Canonical first: a link that leads out is refused, a link that leads in is accepted.
+    const target = canonicalPath(resolve(root, targetDir));
+    if (!isInside(root, target)) {
+        throw new Error(`The artifact folder must lie inside the repository (${root}): ${target}`);
+    }
+    // A probe file below the folder answers for a folder that does not exist yet.
+    const probe = join(relative(root, target), '.probe').replace(/\\/g, '/');
+    const ignored = tryGit(['check-ignore', '-q', '--no-index', probe], { cwd: root });
+    if (!ignored.ok) {
+        throw new Error(`The artifact folder must be ignored by git (add it to .gitignore): ${relative(root, target)}`);
+    }
+    return target;
+}
+/** A free target path: an existing file with other content gets -2, -3 … before its extension. */
+function freeTarget(target, hash) {
+    const dot = basename(target).lastIndexOf('.');
+    const stem = dot > 0 ? target.slice(0, target.length - (basename(target).length - dot)) : target;
+    const ext = dot > 0 ? target.slice(stem.length) : '';
+    for (let attempt = 1;; attempt++) {
+        const candidate = attempt === 1 ? target : `${stem}-${attempt}${ext}`;
+        if (!existsSync(candidate) || sha256(candidate) === hash)
+            return candidate;
+    }
+}
+function filesBelow(path, nested = false) {
+    // A link below a folder could point out of the tree or loop back into it.
+    if (nested && lstatSync(path).isSymbolicLink())
+        return [];
+    if (lstatSync(path).isSymbolicLink() && statSync(path).isDirectory())
+        return [];
+    if (!statSync(path).isDirectory())
+        return [path];
+    return readdirSync(path)
+        .sort()
+        .flatMap((name) => filesBelow(join(path, name), true));
+}
+function copyOne(plan) {
+    const destination = freeTarget(plan.target, plan.hash);
+    mkdirSync(dirname(destination), { recursive: true });
+    copyFileSync(plan.file, destination);
+    const after = sha256(destination);
+    if (after !== plan.hash) {
+        rmSync(destination, { force: true });
+        throw new Error(`Copy of ${plan.file} differs from its source (sha256 ${plan.hash} vs ${after})`);
+    }
+    return {
+        source: plan.file,
+        target: destination,
+        sha256: after,
+        bytes: statSync(destination).size,
+    };
+}
+/** Copies the sources to `<targetDir>/<date>/<basename>` and returns one entry per file. */
+export function preserveArtifacts(repoPath, sources, targetDir, date) {
+    if (!/^\d{8}$/.test(date))
+        throw new Error(`The date must be yyyymmdd: ${date}`);
+    const target = assertTargetDir(repoPath, targetDir);
+    // Every source is found, read and hashed before the first copy, so a bad source copies nothing.
+    const plans = [];
+    for (const source of sources) {
+        const absolute = resolve(repoPath, source);
+        if (!existsSync(absolute))
+            throw new Error(`Artifact source not found: ${source}`);
+        const destination = join(target, date, basename(absolute));
+        for (const file of filesBelow(absolute)) {
+            const rel = relative(absolute, file);
+            plans.push({
+                file,
+                target: rel === '' ? destination : join(destination, rel),
+                hash: sha256(file),
+            });
+        }
+    }
+    return plans.map(copyOne);
+}
+//# sourceMappingURL=closeout-preserve.js.map

package/dist/core/closeout-preserve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closeout-preserve.js","sourceRoot":"","sources":["../../src/core/closeout-preserve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAS3C,qFAAqF;AACrF,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1D,IAAI,IAAI,KAAK,CAAC;gBAAE,MAAM;YACtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,KAAa;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,QAAQ;QAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7F,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB,EAAE,SAAiB;IAC1D,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpC,uFAAuF;IACvF,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,uDAAuD,IAAI,MAAM,MAAM,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,8EAA8E;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,sEAAsE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAC/F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kGAAkG;AAClG,SAAS,UAAU,CAAC,MAAc,EAAE,IAAY;IAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjG,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;QACtE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,MAAM,GAAG,KAAK;IAC9C,0EAA0E;IAC1E,IAAI,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1D,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;QAAE,OAAO,EAAE,CAAC;IAChF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,WAAW,CAAC,IAAI,CAAC;SACrB,IAAI,EAAE;SACN,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAQD,SAAS,OAAO,CAAC,IAAiB;IAChC,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,CAAC,IAAI,oCAAoC,IAAI,CAAC,IAAI,OAAO,KAAK,GAAG,CACjF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI;KAClC,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,OAA0B,EAC1B,SAAiB,EACjB,IAAY;IAEZ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpD,gGAAgG;IAChG,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAC;QACnF,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI;gBACJ,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;gBACzD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Writes the close-out blocks (branch records, preserved artefacts) into an item's master
+ * document through the path `update` uses: guarded by the metadata stamp, `updated` bumped.
+ */
+import { type BranchRecord } from './closeout-branch-record.js';
+export declare const PRESERVED_HEADING = "## Preserved artefacts";
+export declare function writeBranchRecord(devstepsDir: string, record: BranchRecord & {
+    item_id: string;
+}, now?: () => Date): {
+    item_id: string;
+    record: BranchRecord;
+    replaced: boolean;
+};
+export interface PreservedArtifactNote {
+    source: string;
+    target: string;
+    sha256: string;
+    bytes: number;
+}
+export declare function renderPreservedArtifacts(artifacts: readonly PreservedArtifactNote[], recordedAt: string): string;
+/** Appends the artefacts that the item does not list yet; returns how many it wrote. */
+export declare function writePreservedArtifacts(devstepsDir: string, itemId: string, artifacts: readonly PreservedArtifactNote[], now?: () => Date): {
+    item_id: string;
+    count: number;
+};
+//# sourceMappingURL=closeout-record-write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"closeout-record-write.d.ts","sourceRoot":"","sources":["../../src/core/closeout-record-write.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,6BAA6B,CAAC;AAKrC,eAAO,MAAM,iBAAiB,2BAA2B,CAAC;AA0B1D,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAC1C,GAAG,GAAE,MAAM,IAAuB,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAe9D;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,UAAU,EAAE,MAAM,GACjB,MAAM,CAQR;AAOD,wFAAwF;AACxF,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,GAAG,GAAE,MAAM,IAAuB,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAoBpC"}

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

@@ -0,0 +1,69 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Writes the close-out blocks (branch records, preserved artefacts) into an item's master
+ * document through the path `update` uses: guarded by the metadata stamp, `updated` bumped.
+ */
+import { writeFileAtomic } from '../utils/atomic-write.js';
+import { appendToSection, parseBranchRecords, upsertBranchRecord, } from './closeout-branch-record.js';
+import { itemPaths } from './item-paths.js';
+import { assertItemUnchanged, readItem, StaleItemError, writeItemMetadata } from './item-store.js';
+const WRITE_ATTEMPTS = 3;
+export const PRESERVED_HEADING = '## Preserved artefacts';
+/**
+ * Reads the item with its stamp, applies `change` to the description and writes it back, with
+ * `updated` taken from `now` (BUG-191: a test injects the clock instead of sleeping on it).
+ */
+function rewriteDescription(devstepsDir, itemId, change, now) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            const { metadata, description, stamp } = readItem(devstepsDir, itemId);
+            assertItemUnchanged(devstepsDir, itemId, stamp);
+            writeFileAtomic(itemPaths(devstepsDir, itemId).description, change(description));
+            metadata.updated = now().toISOString();
+            writeItemMetadata(devstepsDir, metadata, stamp);
+            return;
+        }
+        catch (error) {
+            if (!(error instanceof StaleItemError) || attempt >= WRITE_ATTEMPTS)
+                throw error;
+        }
+    }
+}
+export function writeBranchRecord(devstepsDir, record, now = () => new Date()) {
+    const { item_id: itemId, ...plain } = record;
+    let replaced = false;
+    rewriteDescription(devstepsDir, itemId, (description) => {
+        replaced = parseBranchRecords(description).some((existing) => existing.repository === plain.repository && existing.branch === plain.branch);
+        return upsertBranchRecord(description, plain);
+    }, now);
+    return { item_id: itemId, record: plain, replaced };
+}
+export function renderPreservedArtifacts(artifacts, recordedAt) {
+    return [
+        `<!-- devsteps:preserved-artifacts recorded=${recordedAt} -->`,
+        ...artifacts.map((a) => `- \`${a.source}\` → \`${a.target}\` · sha256 \`${a.sha256}\` · ${a.bytes} bytes`),
+        '<!-- /devsteps:preserved-artifacts -->',
+    ].join('\n');
+}
+/** The part of a rendered line that names the copy: its target and hash. */
+function artifactKey(artifact) {
+    return `→ \`${artifact.target}\` · sha256 \`${artifact.sha256}\``;
+}
+/** Appends the artefacts that the item does not list yet; returns how many it wrote. */
+export function writePreservedArtifacts(devstepsDir, itemId, artifacts, now = () => new Date()) {
+    if (artifacts.length === 0)
+        return { item_id: itemId, count: 0 };
+    let count = 0;
+    // Decided inside the rewrite: a stale retry re-reads the description and re-checks it.
+    rewriteDescription(devstepsDir, itemId, (description) => {
+        const fresh = artifacts.filter((artifact) => !description.includes(artifactKey(artifact)));
+        count = fresh.length;
+        if (fresh.length === 0)
+            return description;
+        return appendToSection(description, PRESERVED_HEADING, renderPreservedArtifacts(fresh, now().toISOString()));
+    }, now);
+    return { item_id: itemId, count };
+}
+//# sourceMappingURL=closeout-record-write.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Repository identities for closeout branch records (BUG-218). External submodule worktrees
+ * require both a shared Git common directory and registered membership; durable records use
+ * the contained checkout so removing a session worktree does not invalidate its identity.
+ */
+interface RecordRepository {
+    directory: string;
+    repository: string;
+}
+/** Resolve native paths and reject roots outside the served checkout unless Git proves ownership. */
+export declare function resolveRecordRepository(repoPath: string, repository: string): RecordRepository;
+export {};
+//# sourceMappingURL=closeout-repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"closeout-repository.d.ts","sourceRoot":"","sources":["../../src/core/closeout-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqDD,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAiB9F"}