@namzu/sdk 0.1.8 → 0.3.0

package/dist/session/intervention/prev-artifact.js

@@ -0,0 +1,112 @@
+/**
+ * prevArtifactRef DAG primitives — acyclic walker, cycle detection, depth
+ * enforcement. See session-hierarchy.md §4.5.
+ *
+ * Intervention chains link successive follow-up sub-sessions via
+ * `SubSession.prevArtifactRef`, forming a strict acyclic DAG over prior
+ * completed sessions. This module supplies the pre-commit validator that
+ * rejects any insertion that would close a cycle or overflow
+ * {@link Project.config.maxInterventionDepth} (default 10).
+ *
+ * Convention #5: deny-by-default. Cycle or depth violation rejects with a
+ * typed error; callers never get a silently-truncated chain.
+ *
+ * Convention #0: no silent fallbacks. The walker surfaces corruption as
+ * `ArtifactRefCycleError` rather than infinite-looping.
+ */
+/**
+ * Raised when {@link validatePrevArtifactChain} detects a cycle — revisiting
+ * a sub-session id already in the ancestry set. Indicates a bug in the caller
+ * (or pre-existing store corruption); the write must be rejected.
+ */
+export class ArtifactRefCycleError extends Error {
+    details;
+    constructor(details) {
+        super(`prevArtifactRef cycle starting at ${details.startSubSessionId}: ${details.cyclePath.join(' -> ')}`);
+        this.name = 'ArtifactRefCycleError';
+        this.details = details;
+    }
+}
+/**
+ * Raised when the resolved chain length exceeds the configured intervention
+ * depth limit (`Project.config.maxInterventionDepth`). Convention #5
+ * deny-by-default — the kernel does not auto-truncate.
+ */
+export class InterventionDepthExceeded extends Error {
+    details;
+    constructor(details) {
+        super(`Intervention chain depth ${details.depth} exceeds limit ${details.limit} at ${details.subSessionId}`);
+        this.name = 'InterventionDepthExceeded';
+        this.details = details;
+    }
+}
+/**
+ * Pre-commit validator for adding a `prevArtifactRef` on a proposed child
+ * sub-session. Walks from `candidateAncestor` backwards through
+ * `loader.loadAncestor`, seeding the visited-set with `proposedChild` so a
+ * cycle (the candidate chain loops back to the child) is rejected
+ * immediately.
+ *
+ * Returns the resolved ancestry chain (oldest last, length ≤ `maxDepth`),
+ * excluding `proposedChild` itself. The chain is ordered from
+ * immediate-ancestor to furthest-ancestor (reverse-chronological per §4.5).
+ *
+ * Throws:
+ * - {@link ArtifactRefCycleError} if the walk revisits `proposedChild` or
+ *   any already-visited ancestor.
+ * - {@link InterventionDepthExceeded} if the chain would exceed `maxDepth`.
+ *
+ * Non-session_summary deliverables (file / message / artifact_blob) do not
+ * form chain links — the walker terminates cleanly when it encounters one,
+ * since only `kind: 'session_summary'` references another sub-session's
+ * ancestry.
+ */
+export async function validatePrevArtifactChain(loader, proposedChild, candidateAncestor, maxDepth) {
+    if (maxDepth <= 0) {
+        throw new InterventionDepthExceeded({
+            subSessionId: proposedChild,
+            depth: 1,
+            limit: maxDepth,
+        });
+    }
+    // Non-session_summary refs are leaves — no chain links.
+    if (candidateAncestor.kind !== 'session_summary') {
+        return [];
+    }
+    const visited = new Set([proposedChild]);
+    const chain = [];
+    let currentRef = candidateAncestor;
+    while (currentRef !== undefined) {
+        if (currentRef.kind !== 'session_summary') {
+            // Chain terminates on non-session deliverable.
+            return chain;
+        }
+        // `SessionSummaryDeliverable.sessionId` names the completed session the
+        // ref points at. The loader resolves that to the sub-session edge
+        // carrying its own `prevArtifactRef` (if any), giving us the next step.
+        const ancestorNode = await loader.loadAncestor(currentRef.sessionId);
+        if (!ancestorNode) {
+            // Unknown ancestor (root session, or archived / tombstoned). Chain
+            // ends cleanly — absence is not a cycle.
+            return chain;
+        }
+        if (visited.has(ancestorNode.subSessionId)) {
+            throw new ArtifactRefCycleError({
+                startSubSessionId: proposedChild,
+                cyclePath: [...chain, ancestorNode.subSessionId],
+            });
+        }
+        visited.add(ancestorNode.subSessionId);
+        chain.push(ancestorNode.subSessionId);
+        if (chain.length > maxDepth) {
+            throw new InterventionDepthExceeded({
+                subSessionId: proposedChild,
+                depth: chain.length,
+                limit: maxDepth,
+            });
+        }
+        currentRef = ancestorNode.prevArtifactRef;
+    }
+    return chain;
+}
+//# sourceMappingURL=prev-artifact.js.map

package/dist/session/intervention/prev-artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prev-artifact.js","sourceRoot":"","sources":["../../../src/session/intervention/prev-artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAqBH;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACtC,OAAO,CAGf;IAED,YAAY,OAGX;QACA,KAAK,CACJ,qCAAqC,OAAO,CAAC,iBAAiB,KAAK,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CACnG,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAC1C,OAAO,CAIf;IAED,YAAY,OAAqE;QAChF,KAAK,CACJ,4BAA4B,OAAO,CAAC,KAAK,kBAAkB,OAAO,CAAC,KAAK,OAAO,OAAO,CAAC,YAAY,EAAE,CACrG,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAkBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC9C,MAA+B,EAC/B,aAA2B,EAC3B,iBAAiC,EACjC,QAAgB;IAEhB,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,yBAAyB,CAAC;YACnC,YAAY,EAAE,aAAa;YAC3B,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,QAAQ;SACf,CAAC,CAAA;IACH,CAAC;IAED,wDAAwD;IACxD,IAAI,iBAAiB,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAClD,OAAO,EAAE,CAAA;IACV,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAe,CAAC,aAAa,CAAC,CAAC,CAAA;IACtD,MAAM,KAAK,GAAmB,EAAE,CAAA;IAEhC,IAAI,UAAU,GAA+B,iBAAiB,CAAA;IAE9D,OAAO,UAAU,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,UAAU,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC3C,+CAA+C;YAC/C,OAAO,KAAK,CAAA;QACb,CAAC;QAED,wEAAwE;QACxE,kEAAkE;QAClE,wEAAwE;QACxE,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QACpE,IAAI,CAAC,YAAY,EAAE,CAAC;YACnB,mEAAmE;YACnE,yCAAyC;YACzC,OAAO,KAAK,CAAA;QACb,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,qBAAqB,CAAC;gBAC/B,iBAAiB,EAAE,aAAa;gBAChC,SAAS,EAAE,CAAC,GAAG,KAAK,EAAE,YAAY,CAAC,YAAY,CAAC;aAChD,CAAC,CAAA;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,CAAA;QACtC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAA;QAErC,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,yBAAyB,CAAC;gBACnC,YAAY,EAAE,aAAa;gBAC3B,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,KAAK,EAAE,QAAQ;aACf,CAAC,CAAA;QACH,CAAC;QAED,UAAU,GAAG,YAAY,CAAC,eAAe,CAAA;IAC1C,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/session/migration/__tests__/filesystem.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filesystem.test.d.ts.map

package/dist/session/migration/__tests__/filesystem.test.d.ts.map

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

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

@@ -0,0 +1,188 @@
+import { chmod, 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 { FilesystemMigrationError } from '../errors.js';
+import { DefaultFilesystemMigrator, LEGACY_DEFAULT_PROJECT_PREFIX, LEGACY_DEFAULT_SESSION_ID, MARKER_REL_PATH, MIGRATION_VERSION, } from '../filesystem.js';
+import { acquireMigrationLock, writeMarker } from '../marker.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('DefaultFilesystemMigrator.migrate', () => {
+    let root;
+    beforeEach(async () => {
+        root = await mkdtemp(join(tmpdir(), 'namzu-fsmig-'));
+    });
+    afterEach(async () => {
+        // chmod first in case a test left 000 perms on a directory.
+        await chmod(root, 0o755).catch(() => undefined);
+        await rm(root, { recursive: true, force: true });
+    });
+    it('cold boot with a single legacy thread: migrates, emits event, writes marker', 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 exists.
+        const newRunDir = join(root, 'projects', `${LEGACY_DEFAULT_PROJECT_PREFIX}abc`, 'sessions', LEGACY_DEFAULT_SESSION_ID, 'runs', 'run_xyz');
+        expect(await pathExists(newRunDir)).toBe(true);
+        expect(await pathExists(join(newRunDir, 'run.json'))).toBe(true);
+        // Legacy path moved (runs/ sub-tree renamed).
+        expect(await pathExists(join(root, 'threads', 'thd_abc', 'runs'))).toBe(false);
+        // Marker landed.
+        const markerRaw = await readFile(join(root, MARKER_REL_PATH), 'utf-8');
+        const markerParsed = JSON.parse(markerRaw);
+        expect(markerParsed.version).toBe(MIGRATION_VERSION);
+        expect(markerParsed.migratedThreads).toHaveLength(1);
+        // Event emitted with accurate result.
+        expect(events).toHaveLength(1);
+        expect(events[0]?.type).toBe('filesystem.migrated');
+        expect(events[0]?.result.kind).toBe('migrated');
+    });
+    it('warm boot with an existing marker short-circuits to already_migrated', async () => {
+        await writeMarker(join(root, MARKER_REL_PATH), {
+            version: MIGRATION_VERSION,
+            at: new Date(),
+            migratedThreads: [],
+        });
+        await seedLegacyThread(root, 'thd_stillhere', ['run_ignored']);
+        const { events, sink } = collectingSink();
+        const migrator = new DefaultFilesystemMigrator(sink);
+        const result = await migrator.migrate(root);
+        expect(result.kind).toBe('already_migrated');
+        expect(events).toHaveLength(0);
+        // No migration happened — legacy path untouched.
+        expect(await pathExists(join(root, 'threads', 'thd_stillhere', 'runs', 'run_ignored'))).toBe(true);
+    });
+    it('cold boot with neither legacy nor marker writes a marker and returns noop_no_legacy', async () => {
+        const { events, sink } = collectingSink();
+        const migrator = new DefaultFilesystemMigrator(sink);
+        const result = await migrator.migrate(root);
+        expect(result.kind).toBe('noop_no_legacy');
+        expect(events).toHaveLength(0);
+        expect(await pathExists(join(root, MARKER_REL_PATH))).toBe(true);
+    });
+    it('cooperates with a concurrent migrator: main marker lands → already_migrated', async () => {
+        await seedLegacyThread(root, 'thd_abc', ['run_1']);
+        // Pre-seed the tmp lock to simulate another boot mid-migration.
+        await acquireMigrationLock(join(root, '.migration', 'v0.2.0.tmp'));
+        // Now write the main marker as the "winner" would. The loser must
+        // see this on the re-check after waiting and return already_migrated.
+        await writeMarker(join(root, MARKER_REL_PATH), {
+            version: MIGRATION_VERSION,
+            at: new Date(),
+            migratedThreads: [
+                { legacyThreadId: 'thd_abc', newProjectId: `${LEGACY_DEFAULT_PROJECT_PREFIX}abc` },
+            ],
+        });
+        // Because readMarker is checked FIRST (before lock contention), this
+        // actually returns already_migrated on step 1. That is the correct
+        // semantics: the main marker is the single source of truth.
+        const migrator = new DefaultFilesystemMigrator();
+        const result = await migrator.migrate(root);
+        expect(result.kind).toBe('already_migrated');
+    });
+    it('migrates multiple legacy threads in one pass with marker listing all', async () => {
+        await seedLegacyThread(root, 'thd_a', ['run_a1', 'run_a2']);
+        await seedLegacyThread(root, 'thd_b', ['run_b1']);
+        await seedLegacyThread(root, 'thd_c', ['run_c1']);
+        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_a', 'thd_b', 'thd_c']);
+        // Marker content mirrors result.
+        const markerRaw = await readFile(join(root, MARKER_REL_PATH), 'utf-8');
+        const markerParsed = JSON.parse(markerRaw);
+        expect(markerParsed.migratedThreads).toHaveLength(3);
+    });
+    it('synthesized project.json has _legacy: true and tenantId: UNKNOWN_TENANT_ID', async () => {
+        await seedLegacyThread(root, 'thd_tenantcheck', ['run_0']);
+        const migrator = new DefaultFilesystemMigrator();
+        await migrator.migrate(root);
+        const projectJsonPath = join(root, 'projects', `${LEGACY_DEFAULT_PROJECT_PREFIX}tenantcheck`, 'project.json');
+        const parsed = JSON.parse(await readFile(projectJsonPath, 'utf-8'));
+        expect(parsed._legacy).toBe(true);
+        expect(parsed.tenantId).toBe(UNKNOWN_TENANT_ID);
+        expect(parsed.id).toBe(`${LEGACY_DEFAULT_PROJECT_PREFIX}tenantcheck`);
+        expect(parsed.config).toMatchObject({
+            maxDelegationDepth: 4,
+            maxDelegationWidth: 8,
+            maxInterventionDepth: 10,
+        });
+    });
+    it('synthesized session.json is idle and flagged _legacy', async () => {
+        await seedLegacyThread(root, 'thd_sescheck', ['run_0']);
+        const migrator = new DefaultFilesystemMigrator();
+        await migrator.migrate(root);
+        const sessionJsonPath = join(root, 'projects', `${LEGACY_DEFAULT_PROJECT_PREFIX}sescheck`, 'sessions', LEGACY_DEFAULT_SESSION_ID, 'session.json');
+        const parsed = JSON.parse(await readFile(sessionJsonPath, '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('idempotent: two successive migrate() calls produce the same end-state', 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('error path: unwritable marker directory surfaces FilesystemMigrationError', async () => {
+        // Make the rootDir read-only so write_marker fails on the noop branch
+        // (simplest repro — no legacy threads needed).
+        await chmod(root, 0o555);
+        const migrator = new DefaultFilesystemMigrator();
+        try {
+            await migrator.migrate(root);
+            expect.fail('expected migrate() to throw');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(FilesystemMigrationError);
+            const details = err.details;
+            expect(details.op).toBe('write_marker');
+            expect(details.path).toContain('v0.2.0');
+        }
+        finally {
+            // restore perms so afterEach can clean up
+            await chmod(root, 0o755).catch(() => undefined);
+        }
+    });
+});
+//# sourceMappingURL=filesystem.test.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=id-prefix.test.d.ts.map

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

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

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

@@ -0,0 +1,83 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { NOOP_MIGRATION_WARNING_SINK, StalePrefixError, __resetSeenLegacyForTests, acceptLegacyThreadId, rejectLegacyPrefix, } from '../id-prefix.js';
+function collectingSink() {
+    const emitted = [];
+    return {
+        emitted,
+        sink: {
+            emit(w) {
+                emitted.push(w);
+            },
+        },
+    };
+}
+describe('acceptLegacyThreadId', () => {
+    beforeEach(() => {
+        __resetSeenLegacyForTests();
+    });
+    it('coerces thd_* to prj_* and emits a warning on first encounter', () => {
+        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);
+        expect(emitted[0]?.at).toBeInstanceOf(Date);
+    });
+    it('does NOT re-emit a warning for the same legacy id on a second call', () => {
+        const { emitted, sink } = collectingSink();
+        acceptLegacyThreadId('thd_abc', sink);
+        acceptLegacyThreadId('thd_abc', sink);
+        acceptLegacyThreadId('thd_abc', sink);
+        expect(emitted).toHaveLength(1);
+    });
+    it('emits distinct warnings for distinct legacy ids', () => {
+        const { emitted, sink } = collectingSink();
+        acceptLegacyThreadId('thd_abc', sink);
+        acceptLegacyThreadId('thd_xyz', sink);
+        expect(emitted).toHaveLength(2);
+        expect(emitted.map((w) => w.legacyId).sort()).toEqual(['thd_abc', 'thd_xyz']);
+    });
+    it('returns prj_* ids unchanged and emits no warning', () => {
+        const { emitted, sink } = collectingSink();
+        const result = acceptLegacyThreadId('prj_keepme', sink);
+        expect(result).toBe('prj_keepme');
+        expect(emitted).toHaveLength(0);
+    });
+    it('rejects unknown prefixes with StalePrefixError', () => {
+        const { sink } = collectingSink();
+        expect(() => acceptLegacyThreadId('xyz_nope', sink)).toThrowError(StalePrefixError);
+    });
+    it('StalePrefixError carries structured details for unknown prefixes', () => {
+        const { sink } = collectingSink();
+        try {
+            acceptLegacyThreadId('xyz_nope', sink);
+            expect.fail('expected throw');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(StalePrefixError);
+            expect(err.details.rawId).toBe('xyz_nope');
+            expect(err.details.kind).toBe('unknown_prefix');
+        }
+    });
+    it('NOOP_MIGRATION_WARNING_SINK swallows warnings without error', () => {
+        expect(() => acceptLegacyThreadId('thd_noop', NOOP_MIGRATION_WARNING_SINK)).not.toThrow();
+    });
+});
+describe('rejectLegacyPrefix', () => {
+    it('throws StalePrefixError for thd_* input', () => {
+        expect(() => rejectLegacyPrefix('thd_abc')).toThrowError(StalePrefixError);
+    });
+    it('accepts prj_* input without throwing', () => {
+        expect(() => rejectLegacyPrefix('prj_abc')).not.toThrow();
+    });
+    it('accepts non-thread prefixes without throwing (writer guard is scoped)', () => {
+        // The guard is specifically for thd_* re-emission; unrelated prefixes
+        // are a concern for their own parse functions.
+        expect(() => rejectLegacyPrefix('ses_abc')).not.toThrow();
+        expect(() => rejectLegacyPrefix('run_abc')).not.toThrow();
+    });
+});
+//# sourceMappingURL=id-prefix.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id-prefix.test.js","sourceRoot":"","sources":["../../../../src/session/migration/__tests__/id-prefix.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEzD,OAAO,EACN,2BAA2B,EAC3B,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,GAClB,MAAM,iBAAiB,CAAA;AAGxB,SAAS,cAAc;IACtB,MAAM,OAAO,GAAuB,EAAE,CAAA;IACtC,OAAO;QACN,OAAO;QACP,IAAI,EAAE;YACL,IAAI,CAAC,CAAC;gBACL,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAChB,CAAC;SACD;KACD,CAAA;AACF,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACrC,UAAU,CAAC,GAAG,EAAE;QACf,yBAAyB,EAAE,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACxE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QAC1C,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAsB,CAAC,CAAA;QAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QACtD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAChD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC7E,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QAC1C,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACrC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACrC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC1D,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QAC1C,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACrC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC3D,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QAC1C,MAAM,MAAM,GAAG,oBAAoB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAyB,CAAC,CAAA;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QACjC,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAA;IACpF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC3E,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QACjC,IAAI,CAAC;YACJ,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;YACtC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAA;YAC5C,MAAM,CAAE,GAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAChE,MAAM,CAAE,GAAwB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QACtE,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,UAAU,EAAE,2BAA2B,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IAC1F,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAChF,sEAAsE;QACtE,+CAA+C;QAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IAC1D,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/session/migration/__tests__/marker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=marker.test.d.ts.map

package/dist/session/migration/__tests__/marker.test.d.ts.map

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

package/dist/session/migration/__tests__/marker.test.js

@@ -0,0 +1,75 @@
+import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { acquireMigrationLock, readMarker, releaseMigrationLock, writeMarker } from '../marker.js';
+describe('migration marker I/O', () => {
+    let root;
+    beforeEach(async () => {
+        root = await mkdtemp(join(tmpdir(), 'namzu-marker-'));
+    });
+    afterEach(async () => {
+        await rm(root, { recursive: true, force: true });
+    });
+    it('readMarker returns null when the file is missing', async () => {
+        const result = await readMarker(join(root, 'missing.json'));
+        expect(result).toBeNull();
+    });
+    it('readMarker parses a valid JSON marker', async () => {
+        const path = join(root, 'v0.2.0');
+        const at = new Date('2026-04-17T00:00:00.000Z');
+        await writeMarker(path, {
+            version: '0.2.0',
+            at,
+            migratedThreads: [{ legacyThreadId: 'thd_abc', newProjectId: 'prj_legacy_abc' }],
+        });
+        const result = await readMarker(path);
+        expect(result).not.toBeNull();
+        expect(result?.version).toBe('0.2.0');
+        expect(result?.at.toISOString()).toBe('2026-04-17T00:00:00.000Z');
+        expect(result?.migratedThreads).toEqual([
+            { legacyThreadId: 'thd_abc', newProjectId: 'prj_legacy_abc' },
+        ]);
+    });
+    it('readMarker returns null on corrupt JSON (retry-safe)', async () => {
+        const path = join(root, 'corrupt.json');
+        await writeFile(path, '{ not valid json', 'utf-8');
+        const result = await readMarker(path);
+        expect(result).toBeNull();
+    });
+    it('writeMarker atomically writes via tmp-rename (no partial content)', async () => {
+        const path = join(root, 'v0.2.0');
+        await writeMarker(path, {
+            version: '0.2.0',
+            at: new Date(),
+            migratedThreads: [],
+        });
+        const content = await readFile(path, 'utf-8');
+        const parsed = JSON.parse(content);
+        expect(parsed.version).toBe('0.2.0');
+    });
+    it('acquireMigrationLock succeeds on first call and throws EEXIST on the second', async () => {
+        const lockPath = join(root, 'v0.2.0.tmp');
+        await acquireMigrationLock(lockPath);
+        let caught = null;
+        try {
+            await acquireMigrationLock(lockPath);
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).not.toBeNull();
+        expect(caught?.code).toBe('EEXIST');
+    });
+    it('releaseMigrationLock tolerates a missing file (idempotent)', async () => {
+        const lockPath = join(root, 'never-existed.tmp');
+        await expect(releaseMigrationLock(lockPath)).resolves.toBeUndefined();
+    });
+    it('releaseMigrationLock clears the lock so re-acquire succeeds', async () => {
+        const lockPath = join(root, 'v0.2.0.tmp');
+        await acquireMigrationLock(lockPath);
+        await releaseMigrationLock(lockPath);
+        await expect(acquireMigrationLock(lockPath)).resolves.toBeUndefined();
+    });
+});
+//# sourceMappingURL=marker.test.js.map

package/dist/session/migration/__tests__/marker.test.js.map

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

package/dist/session/migration/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Typed errors for the migration module.
+ *
+ * See session-hierarchy.md §13.4.1. Structured `details` payload lets
+ * consumers route failures without string parsing (Convention #5: fail
+ * fast, surface cause, no silent swallowing).
+ */
+/**
+ * Raised when any filesystem step during the boot-time v0.2.0 re-layout
+ * fails (enumerate, rename, synthesize project.json, write marker).
+ * `op` is a short stable tag so consumers can dashboard on failure mode;
+ * `cause` carries the underlying `Error` for stack preservation.
+ */
+export declare class FilesystemMigrationError extends Error {
+    readonly details: {
+        op: string;
+        path: string;
+        cause?: unknown;
+    };
+    constructor(details: {
+        op: string;
+        path: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/session/migration/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/session/migration/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAClD,QAAQ,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;gBAEnD,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKlE"}

package/dist/session/migration/errors.js

@@ -0,0 +1,22 @@
+/**
+ * Typed errors for the migration module.
+ *
+ * See session-hierarchy.md §13.4.1. Structured `details` payload lets
+ * consumers route failures without string parsing (Convention #5: fail
+ * fast, surface cause, no silent swallowing).
+ */
+/**
+ * Raised when any filesystem step during the boot-time v0.2.0 re-layout
+ * fails (enumerate, rename, synthesize project.json, write marker).
+ * `op` is a short stable tag so consumers can dashboard on failure mode;
+ * `cause` carries the underlying `Error` for stack preservation.
+ */
+export class FilesystemMigrationError extends Error {
+    details;
+    constructor(details) {
+        super(`Filesystem migration failed at ${details.op} on ${details.path}`);
+        this.name = 'FilesystemMigrationError';
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/session/migration/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/session/migration/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACzC,OAAO,CAA+C;IAE/D,YAAY,OAAsD;QACjE,KAAK,CAAC,kCAAkC,OAAO,CAAC,EAAE,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QACxE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD"}