@namzu/sdk 0.1.8 → 0.3.0

package/dist/session/__tests__/integration/migration-filesystem.test.js

@@ -0,0 +1,140 @@
+/**
+ * Integration — boot-time filesystem re-layout wired through the real
+ * {@link DefaultFilesystemMigrator}. Temp-dir fixtures, no mocks.
+ *
+ * Covers roadmap §5 invariants: §13.4.1 boot migration (cold-boot / warm /
+ * idempotent / multi-thread), synthesized project.json + session.json with
+ * `_legacy: true` + UNKNOWN_TENANT_ID, marker `.migration/v0.2.0` written
+ * last.
+ */
+import { mkdir, mkdtemp, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { UNKNOWN_TENANT_ID } from '../../../types/ids/index.js';
+import { DefaultFilesystemMigrator, LEGACY_DEFAULT_PROJECT_PREFIX, LEGACY_DEFAULT_SESSION_ID, MARKER_REL_PATH, MIGRATION_VERSION, } from '../../migration/filesystem.js';
+function collectingSink() {
+    const events = [];
+    return {
+        events,
+        sink: {
+            emit(ev) {
+                events.push(ev);
+            },
+        },
+    };
+}
+async function seedLegacyThread(root, thread, runs) {
+    for (const run of runs) {
+        const dir = join(root, 'threads', thread, 'runs', run);
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, 'run.json'), JSON.stringify({ id: run }), 'utf-8');
+    }
+}
+async function pathExists(p) {
+    try {
+        await stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe('Integration — boot-time filesystem migration', () => {
+    let root;
+    beforeEach(async () => {
+        root = await mkdtemp(join(tmpdir(), 'namzu-intgr-fsmig-'));
+    });
+    afterEach(async () => {
+        await rm(root, { recursive: true, force: true });
+    });
+    it('cold boot with legacy .namzu/threads/thd_abc → migrated to projects layout + marker + event', async () => {
+        await seedLegacyThread(root, 'thd_abc', ['run_xyz']);
+        const { events, sink } = collectingSink();
+        const migrator = new DefaultFilesystemMigrator(sink);
+        const result = await migrator.migrate(root);
+        expect(result.kind).toBe('migrated');
+        expect(result.migratedThreads).toEqual([
+            { legacyThreadId: 'thd_abc', newProjectId: `${LEGACY_DEFAULT_PROJECT_PREFIX}abc` },
+        ]);
+        // New layout: projects/{prj_legacy_abc}/sessions/{ses_legacy_default}/runs/run_xyz
+        const newRunDir = join(root, 'projects', `${LEGACY_DEFAULT_PROJECT_PREFIX}abc`, 'sessions', LEGACY_DEFAULT_SESSION_ID, 'runs', 'run_xyz');
+        expect(await pathExists(newRunDir)).toBe(true);
+        // Legacy sub-tree moved.
+        expect(await pathExists(join(root, 'threads', 'thd_abc', 'runs'))).toBe(false);
+        // Marker landed last.
+        const markerRaw = await readFile(join(root, MARKER_REL_PATH), 'utf-8');
+        const marker = JSON.parse(markerRaw);
+        expect(marker.version).toBe(MIGRATION_VERSION);
+        // Event emitted.
+        expect(events).toHaveLength(1);
+        expect(events[0]?.type).toBe('filesystem.migrated');
+    });
+    it('synthesized project.json has _legacy: true + tenantId: UNKNOWN_TENANT_ID', async () => {
+        await seedLegacyThread(root, 'thd_leg', ['run_a']);
+        const migrator = new DefaultFilesystemMigrator();
+        await migrator.migrate(root);
+        const parsed = JSON.parse(await readFile(join(root, 'projects', `${LEGACY_DEFAULT_PROJECT_PREFIX}leg`, 'project.json'), 'utf-8'));
+        expect(parsed._legacy).toBe(true);
+        expect(parsed.tenantId).toBe(UNKNOWN_TENANT_ID);
+        expect(parsed.id).toBe(`${LEGACY_DEFAULT_PROJECT_PREFIX}leg`);
+        expect(parsed.config).toMatchObject({
+            maxDelegationDepth: 4,
+            maxDelegationWidth: 8,
+            maxInterventionDepth: 10,
+        });
+    });
+    it('synthesized session.json is idle + _legacy', async () => {
+        await seedLegacyThread(root, 'thd_seschk', ['run_a']);
+        const migrator = new DefaultFilesystemMigrator();
+        await migrator.migrate(root);
+        const parsed = JSON.parse(await readFile(join(root, 'projects', `${LEGACY_DEFAULT_PROJECT_PREFIX}seschk`, 'sessions', LEGACY_DEFAULT_SESSION_ID, 'session.json'), 'utf-8'));
+        expect(parsed.id).toBe(LEGACY_DEFAULT_SESSION_ID);
+        expect(parsed.status).toBe('idle');
+        expect(parsed.tenantId).toBe(UNKNOWN_TENANT_ID);
+        expect(parsed._legacy).toBe(true);
+    });
+    it('warm boot: marker present → kind: already_migrated, no filesystem changes', async () => {
+        // First run creates the marker.
+        await seedLegacyThread(root, 'thd_warm', ['run_a']);
+        const migrator = new DefaultFilesystemMigrator();
+        await migrator.migrate(root);
+        // Second run must short-circuit.
+        const result = await migrator.migrate(root);
+        expect(result.kind).toBe('already_migrated');
+        expect(result.migratedThreads).toHaveLength(0);
+    });
+    it('idempotent: second migrate() invocation is noop in same process', async () => {
+        await seedLegacyThread(root, 'thd_idem', ['run_1']);
+        const migrator = new DefaultFilesystemMigrator();
+        const first = await migrator.migrate(root);
+        const second = await migrator.migrate(root);
+        expect(first.kind).toBe('migrated');
+        expect(second.kind).toBe('already_migrated');
+        expect(second.migratedThreads).toHaveLength(0);
+        // End state still valid.
+        const newRunDir = join(root, 'projects', `${LEGACY_DEFAULT_PROJECT_PREFIX}idem`, 'sessions', LEGACY_DEFAULT_SESSION_ID, 'runs', 'run_1');
+        expect(await pathExists(newRunDir)).toBe(true);
+    });
+    it('three legacy threads migrated in one pass → marker lists all', async () => {
+        await seedLegacyThread(root, 'thd_alpha', ['run_a1', 'run_a2']);
+        await seedLegacyThread(root, 'thd_beta', ['run_b1']);
+        await seedLegacyThread(root, 'thd_gamma', ['run_g1']);
+        const migrator = new DefaultFilesystemMigrator();
+        const result = await migrator.migrate(root);
+        expect(result.kind).toBe('migrated');
+        expect(result.migratedThreads).toHaveLength(3);
+        const ids = result.migratedThreads.map((m) => m.legacyThreadId).sort();
+        expect(ids).toEqual(['thd_alpha', 'thd_beta', 'thd_gamma']);
+        const markerRaw = await readFile(join(root, MARKER_REL_PATH), 'utf-8');
+        const marker = JSON.parse(markerRaw);
+        expect(marker.migratedThreads).toHaveLength(3);
+    });
+    it('fresh install (no legacy + no marker): writes marker + returns noop_no_legacy', async () => {
+        const migrator = new DefaultFilesystemMigrator();
+        const result = await migrator.migrate(root);
+        expect(result.kind).toBe('noop_no_legacy');
+        expect(await pathExists(join(root, MARKER_REL_PATH))).toBe(true);
+    });
+});
+//# sourceMappingURL=migration-filesystem.test.js.map

package/dist/session/__tests__/integration/migration-filesystem.test.js.map

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

package/dist/session/__tests__/integration/migration-id-prefix.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Integration — ID-prefix read-accept + MigrationWarning emission.
+ *
+ * Covers roadmap §5 invariants: §13.3.1 `thd_*` → `prj_*` coercion with
+ * warning emission (once per distinct legacy id per process), rejection of
+ * unknown prefixes via {@link StalePrefixError}.
+ *
+ * Orthogonal to `session/migration/__tests__/id-prefix.test.ts` unit tests
+ * by wiring a single collecting sink across multiple `acceptLegacyThreadId`
+ * invocations so the dedup across the integration boundary is visible.
+ */
+export {};
+//# sourceMappingURL=migration-id-prefix.test.d.ts.map

package/dist/session/__tests__/integration/migration-id-prefix.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-id-prefix.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/migration-id-prefix.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/session/__tests__/integration/migration-id-prefix.test.js

@@ -0,0 +1,84 @@
+/**
+ * Integration — ID-prefix read-accept + MigrationWarning emission.
+ *
+ * Covers roadmap §5 invariants: §13.3.1 `thd_*` → `prj_*` coercion with
+ * warning emission (once per distinct legacy id per process), rejection of
+ * unknown prefixes via {@link StalePrefixError}.
+ *
+ * Orthogonal to `session/migration/__tests__/id-prefix.test.ts` unit tests
+ * by wiring a single collecting sink across multiple `acceptLegacyThreadId`
+ * invocations so the dedup across the integration boundary is visible.
+ */
+import { beforeEach, describe, expect, it } from 'vitest';
+import { StalePrefixError, __resetSeenLegacyForTests, acceptLegacyThreadId, } from '../../migration/id-prefix.js';
+function collectingSink() {
+    const emitted = [];
+    return {
+        emitted,
+        sink: {
+            emit(w) {
+                emitted.push(w);
+            },
+        },
+    };
+}
+describe('Integration — ID-prefix migration window', () => {
+    beforeEach(() => {
+        __resetSeenLegacyForTests();
+    });
+    it('acceptLegacyThreadId("thd_abc") coerces to prj_abc and emits warning once', () => {
+        const { emitted, sink } = collectingSink();
+        const result = acceptLegacyThreadId('thd_abc', sink);
+        expect(result).toBe('prj_abc');
+        expect(emitted).toHaveLength(1);
+        expect(emitted[0]?.kind).toBe('id_prefix_legacy_read');
+        expect(emitted[0]?.legacyId).toBe('thd_abc');
+        expect(emitted[0]?.normalizedId).toBe('prj_abc');
+        expect(emitted[0]?.emittedOncePerProcess).toBe(true);
+    });
+    it('second call with same id → no duplicate warning (process-level dedup)', () => {
+        const { emitted, sink } = collectingSink();
+        acceptLegacyThreadId('thd_abc', sink);
+        acceptLegacyThreadId('thd_abc', sink);
+        acceptLegacyThreadId('thd_abc', sink);
+        expect(emitted).toHaveLength(1);
+    });
+    it('distinct legacy ids emit distinct warnings', () => {
+        const { emitted, sink } = collectingSink();
+        acceptLegacyThreadId('thd_abc', sink);
+        acceptLegacyThreadId('thd_xyz', sink);
+        acceptLegacyThreadId('thd_abc', sink); // dedup, no emission
+        expect(emitted).toHaveLength(2);
+        expect(emitted.map((w) => w.legacyId).sort()).toEqual(['thd_abc', 'thd_xyz']);
+    });
+    it('acceptLegacyThreadId("prj_abc") returns as-is with no warning', () => {
+        const { emitted, sink } = collectingSink();
+        const result = acceptLegacyThreadId('prj_abc', sink);
+        expect(result).toBe('prj_abc');
+        expect(emitted).toHaveLength(0);
+    });
+    it('acceptLegacyThreadId("xyz_abc") rejects with StalePrefixError (unknown_prefix)', () => {
+        const { sink } = collectingSink();
+        try {
+            acceptLegacyThreadId('xyz_abc', sink);
+            expect.fail('expected StalePrefixError');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(StalePrefixError);
+            expect(err.details.rawId).toBe('xyz_abc');
+            expect(err.details.kind).toBe('unknown_prefix');
+        }
+    });
+    it('dedup is per-sink-aggregated: a single process-level cache serves all sinks', () => {
+        // The dedup state is process-global (seenLegacy Set inside id-prefix.ts),
+        // so switching sinks mid-run does NOT re-trigger the warning. Consumers
+        // wiring a shared collector across modules observe the single emission.
+        const sinkA = collectingSink();
+        const sinkB = collectingSink();
+        acceptLegacyThreadId('thd_shared', sinkA.sink);
+        expect(sinkA.emitted).toHaveLength(1);
+        acceptLegacyThreadId('thd_shared', sinkB.sink);
+        expect(sinkB.emitted).toHaveLength(0); // process-wide dedup
+    });
+});
+//# sourceMappingURL=migration-id-prefix.test.js.map

package/dist/session/__tests__/integration/migration-id-prefix.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-id-prefix.test.js","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/migration-id-prefix.test.ts"],"names":[],"mappings":"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"}

package/dist/session/__tests__/integration/prev-artifact-dag.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Integration — intervention `prevArtifactRef` DAG primitives wired against
+ * a real {@link InMemorySessionStore}-backed {@link InterventionChainLoader}.
+ *
+ * Covers roadmap §5 invariants: §4.5 prevArtifactRef acyclic DAG (cycle +
+ * depth rejection), terminal semantics for non-`session_summary` deliverables.
+ *
+ * Orthogonal to the unit tests in `session/intervention/__tests__/prev-artifact.test.ts`
+ * which run against a synthetic in-memory loader. This file wires the loader
+ * against live store state — every ancestor read is a SessionStore lookup,
+ * proving the walker composes with the real persistence layer.
+ */
+export {};
+//# sourceMappingURL=prev-artifact-dag.test.d.ts.map

package/dist/session/__tests__/integration/prev-artifact-dag.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prev-artifact-dag.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/prev-artifact-dag.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/session/__tests__/integration/prev-artifact-dag.test.js

@@ -0,0 +1,242 @@
+/**
+ * Integration — intervention `prevArtifactRef` DAG primitives wired against
+ * a real {@link InMemorySessionStore}-backed {@link InterventionChainLoader}.
+ *
+ * Covers roadmap §5 invariants: §4.5 prevArtifactRef acyclic DAG (cycle +
+ * depth rejection), terminal semantics for non-`session_summary` deliverables.
+ *
+ * Orthogonal to the unit tests in `session/intervention/__tests__/prev-artifact.test.ts`
+ * which run against a synthetic in-memory loader. This file wires the loader
+ * against live store state — every ancestor read is a SessionStore lookup,
+ * proving the walker composes with the real persistence layer.
+ */
+import { describe, expect, it } from 'vitest';
+import { InMemorySessionStore } from '../../../store/session/memory.js';
+import { ArtifactRefCycleError, InterventionDepthExceeded, validatePrevArtifactChain, } from '../../intervention/prev-artifact.js';
+import { DEFAULT_TENANT, agentActor, userActor } from './_fixtures.js';
+const TEST_THREAD_ID = 'thd_test';
+/**
+ * Build a live loader pointing at a real InMemorySessionStore. Each node
+ * resolves via `findParentSubSession`-style lookup on the store's sub-session
+ * map — the walker is therefore verifying the real data structure.
+ */
+function buildLoaderFromStore(store, tenantId) {
+    return {
+        async loadAncestor(sessionId) {
+            // Walk the store: session → parent sub-session → (parent, edge).
+            // drill() returns root-to-self ancestry; the element immediately
+            // before self is the direct parent-session-id.
+            const view = await store.drill(sessionId, tenantId);
+            if (!view)
+                return null;
+            const ancestry = view.ancestry;
+            if (ancestry.length < 2)
+                return null;
+            const parentId = ancestry[ancestry.length - 2];
+            if (!parentId)
+                return null;
+            const parentChildren = await store.getChildren(parentId, tenantId);
+            const edge = parentChildren.find((sub) => sub.childSessionId === sessionId);
+            if (!edge)
+                return null;
+            return {
+                subSessionId: edge.id,
+                sessionId: edge.childSessionId,
+                ...(edge.prevArtifactRef !== undefined && { prevArtifactRef: edge.prevArtifactRef }),
+            };
+        },
+    };
+}
+async function buildLinearChain(store, length) {
+    const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'chain' }, DEFAULT_TENANT);
+    const sessions = [];
+    let previous = null;
+    for (let i = 0; i < length; i++) {
+        const s = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: agentActor(`agt_${i}`) }, DEFAULT_TENANT);
+        if (previous) {
+            await store.createSubSession({
+                parentSessionId: previous,
+                childSessionId: s.id,
+                kind: 'intervention',
+                spawnedBy: userActor('usr_driver'),
+            }, DEFAULT_TENANT);
+        }
+        sessions.push(s.id);
+        previous = s.id;
+    }
+    return { sessions };
+}
+function summaryRefTo(sessionId) {
+    return {
+        id: 'del_intgr',
+        kind: 'session_summary',
+        sessionId,
+        summaryRef: 'sum_x',
+        at: new Date(),
+    };
+}
+describe('Integration — prevArtifactRef DAG against real store', () => {
+    it('accepts depth-1 and depth-2 chains', async () => {
+        const store = new InMemorySessionStore();
+        const { sessions } = await buildLinearChain(store, 3);
+        const loader = buildLoaderFromStore(store, DEFAULT_TENANT);
+        const proposedChild = 'sub_proposed';
+        // Depth 1: walk pointed at the last session in the chain has no
+        // prevArtifactRef populated (our test chain is bare), so result is a
+        // single-element chain.
+        const depth1 = await validatePrevArtifactChain(loader, proposedChild, summaryRefTo(sessions[0]), 10);
+        // The loader looks up `sessions[0]` — that session is the root and has
+        // no parent sub-session. Chain terminates at zero links.
+        expect(depth1.length).toBeLessThanOrEqual(10);
+    });
+    it('depth at limit accepted; one over rejected with InterventionDepthExceeded', async () => {
+        // Use a synthetic chain since the store-backed loader walks ancestry
+        // via session linkage (not through `prevArtifactRef`). The roadmap
+        // requirement is "walker enforces cap" — we exercise exactly that.
+        const syntheticLoader = {
+            async loadAncestor(sid) {
+                // Produce an infinite chain by always returning a deeper ancestor
+                // keyed off sid suffix.
+                const match = /ses_(\d+)/.exec(sid);
+                if (!match)
+                    return null;
+                const n = Number(match[1]);
+                if (n <= 0)
+                    return null;
+                return {
+                    subSessionId: `sub_${n}`,
+                    sessionId: `ses_${n - 1}`,
+                    prevArtifactRef: summaryRefTo(`ses_${n - 1}`),
+                };
+            },
+        };
+        const proposed = 'sub_new';
+        // Max 10: start at ses_10 and walk → 10 steps reachable, ses_0 terminates.
+        const okChain = await validatePrevArtifactChain(syntheticLoader, proposed, summaryRefTo('ses_10'), 10);
+        expect(okChain.length).toBeLessThanOrEqual(10);
+        // Over limit: starting at ses_12 requires 12 steps, over cap 10.
+        await expect(validatePrevArtifactChain(syntheticLoader, proposed, summaryRefTo('ses_12'), 10)).rejects.toBeInstanceOf(InterventionDepthExceeded);
+    });
+    it('rejects self-reference (cycle)', async () => {
+        const proposed = 'sub_self';
+        const loader = {
+            async loadAncestor(sid) {
+                return {
+                    subSessionId: proposed, // self-reference
+                    sessionId: sid,
+                };
+            },
+        };
+        await expect(validatePrevArtifactChain(loader, proposed, summaryRefTo('ses_a'), 10)).rejects.toBeInstanceOf(ArtifactRefCycleError);
+    });
+    it('rejects 2-cycle and 3-cycle', async () => {
+        const proposed = 'sub_p';
+        // 2-cycle: A ↔ B
+        const twoCycleLoader = {
+            async loadAncestor(sid) {
+                if (sid === 'ses_a') {
+                    return {
+                        subSessionId: 'sub_a',
+                        sessionId: 'ses_a',
+                        prevArtifactRef: summaryRefTo('ses_b'),
+                    };
+                }
+                if (sid === 'ses_b') {
+                    return {
+                        subSessionId: 'sub_a', // revisit sub_a closes the cycle
+                        sessionId: 'ses_b',
+                    };
+                }
+                return null;
+            },
+        };
+        await expect(validatePrevArtifactChain(twoCycleLoader, proposed, summaryRefTo('ses_a'), 10)).rejects.toBeInstanceOf(ArtifactRefCycleError);
+        // 3-cycle: A → B → C → A
+        const threeCycleLoader = {
+            async loadAncestor(sid) {
+                if (sid === 'ses_a') {
+                    return {
+                        subSessionId: 'sub_a',
+                        sessionId: 'ses_a',
+                        prevArtifactRef: summaryRefTo('ses_b'),
+                    };
+                }
+                if (sid === 'ses_b') {
+                    return {
+                        subSessionId: 'sub_b',
+                        sessionId: 'ses_b',
+                        prevArtifactRef: summaryRefTo('ses_c'),
+                    };
+                }
+                if (sid === 'ses_c') {
+                    return {
+                        subSessionId: 'sub_a', // back to start
+                        sessionId: 'ses_c',
+                    };
+                }
+                return null;
+            },
+        };
+        await expect(validatePrevArtifactChain(threeCycleLoader, proposed, summaryRefTo('ses_a'), 10)).rejects.toBeInstanceOf(ArtifactRefCycleError);
+    });
+    it('non-session_summary DeliverableRef terminates chain (file, artifact_blob, message)', async () => {
+        const loader = {
+            async loadAncestor() {
+                throw new Error('loader should not be invoked for non-session_summary');
+            },
+        };
+        const proposed = 'sub_p';
+        const fileRef = {
+            id: 'del_f',
+            kind: 'file',
+            path: 'a.txt',
+            contentHash: 'abc',
+            sizeBytes: 0,
+        };
+        expect(await validatePrevArtifactChain(loader, proposed, fileRef, 10)).toEqual([]);
+        const blobRef = {
+            id: 'del_b',
+            kind: 'artifact_blob',
+            storageRef: 'blob://x',
+        };
+        expect(await validatePrevArtifactChain(loader, proposed, blobRef, 10)).toEqual([]);
+    });
+    it('wired end-to-end: store has a real 3-step intervention chain; walker confirms it through the store', async () => {
+        // Build A → B → C with prevArtifactRef edges explicitly attached, then
+        // verify the walker loader resolves each ancestor through the store.
+        const store = new InMemorySessionStore();
+        const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'intgr' }, DEFAULT_TENANT);
+        const sA = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: agentActor('agt_a') }, DEFAULT_TENANT);
+        const sB = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: agentActor('agt_b') }, DEFAULT_TENANT);
+        const sC = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: agentActor('agt_c') }, DEFAULT_TENANT);
+        const subAB = await store.createSubSession({
+            parentSessionId: sA.id,
+            childSessionId: sB.id,
+            kind: 'intervention',
+            spawnedBy: userActor('usr_d'),
+        }, DEFAULT_TENANT);
+        await store.updateSubSession({
+            ...subAB,
+            prevArtifactRef: summaryRefTo(sA.id),
+        }, DEFAULT_TENANT);
+        const subBC = await store.createSubSession({
+            parentSessionId: sB.id,
+            childSessionId: sC.id,
+            kind: 'intervention',
+            spawnedBy: userActor('usr_d'),
+        }, DEFAULT_TENANT);
+        await store.updateSubSession({
+            ...subBC,
+            prevArtifactRef: summaryRefTo(sB.id),
+        }, DEFAULT_TENANT);
+        const loader = buildLoaderFromStore(store, DEFAULT_TENANT);
+        // Ancestor of sC is sB, whose prev points at sA. Walker should traverse
+        // one step (to subBC) and then stop — sA has no ancestor sub-session.
+        const proposed = 'sub_proposed_c';
+        const chain = await validatePrevArtifactChain(loader, proposed, summaryRefTo(sC.id), 10);
+        // The walker returns sub-session ids along the ancestry — at least one
+        // hop resolved through the real store.
+        expect(chain.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=prev-artifact-dag.test.js.map

package/dist/session/__tests__/integration/prev-artifact-dag.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prev-artifact-dag.test.js","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/prev-artifact-dag.test.ts"],"names":[],"mappings":"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"}

package/dist/session/__tests__/integration/retention-archive.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Integration — retention archive / restore round-trip wired through the
+ * real stack: `InMemorySessionStore` + `DiskArchiveBackend` (pointed at
+ * `tmpdir()`) + `ArchivalManager` + `GitWorktreeDriver`.
+ *
+ * Covers roadmap §5 invariants: §12.3 retention deny-by-default, §12.3
+ * archive produces tombstone (in-slot), tombstone navigable via `drill`,
+ * restore full fidelity round-trip (Phase 9 closed synthetic-id loss),
+ * idempotent workspace dispose.
+ */
+export {};
+//# sourceMappingURL=retention-archive.test.d.ts.map

package/dist/session/__tests__/integration/retention-archive.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-archive.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/retention-archive.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}