@namzu/sdk 0.1.7 → 0.2.0

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":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EACN,yBAAyB,EAGzB,6BAA6B,EAC7B,yBAAyB,EACzB,eAAe,EACf,iBAAiB,GACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAEhE,SAAS,cAAc;IAItB,MAAM,MAAM,GAA+B,EAAE,CAAA;IAC7C,OAAO;QACN,MAAM;QACN,IAAI,EAAE;YACL,IAAI,CAAC,EAAE;gBACN,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAChB,CAAC;SACD;KACD,CAAA;AACF,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAc,EAAE,IAAc;IAC3E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;QACtD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACrC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;IAC7E,CAAC;AACF,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC;QACJ,MAAM,IAAI,CAAC,CAAC,CAAC,CAAA;QACb,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC;AAED,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAClD,IAAI,IAAY,CAAA;IAEhB,UAAU,CAAC,KAAK,IAAI,EAAE;QACrB,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,KAAK,IAAI,EAAE;QACpB,4DAA4D;QAC5D,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;QAEpD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QACzC,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAA;QAEpD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAE3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC;YACtC,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,6BAA6B,KAAK,EAAE;SAClF,CAAC,CAAA;QAEF,qBAAqB;QACrB,MAAM,SAAS,GAAG,IAAI,CACrB,IAAI,EACJ,UAAU,EACV,GAAG,6BAA6B,KAAK,EACrC,UAAU,EACV,yBAAyB,EACzB,MAAM,EACN,SAAS,CACT,CAAA;QACD,MAAM,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEhE,8CAA8C;QAC9C,MAAM,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAE9E,iBAAiB;QACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAA;QACtE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAC1C,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QACpD,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAEpD,sCAAsC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE;YAC9C,OAAO,EAAE,iBAAiB;YAC1B,EAAE,EAAE,IAAI,IAAI,EAAE;YACd,eAAe,EAAE,EAAE;SACnB,CAAC,CAAA;QACF,MAAM,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;QAE9D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QACzC,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAA;QAEpD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAE3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,iDAAiD;QACjD,MAAM,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAC3F,IAAI,CACJ,CAAA;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qFAAqF,EAAE,KAAK,IAAI,EAAE;QACpG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QACzC,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAA;QAEpD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAE3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QAElD,gEAAgE;QAChE,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAA;QAElE,kEAAkE;QAClE,sEAAsE;QACtE,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE;YAC9C,OAAO,EAAE,iBAAiB;YAC1B,EAAE,EAAE,IAAI,IAAI,EAAE;YACd,eAAe,EAAE;gBAChB,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,6BAA6B,KAAK,EAAE;aAClF;SACD,CAAC,CAAA;QAEF,qEAAqE;QACrE,mEAAmE;QACnE,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAA;QAChD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;QAC3D,MAAM,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QACjD,MAAM,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QAEjD,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAA;QAChD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAE3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAA;QACtE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QAEhD,iCAAiC;QACjC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAA;QACtE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAC1C,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QAC1D,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAA;QAChD,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAE5B,MAAM,eAAe,GAAG,IAAI,CAC3B,IAAI,EACJ,UAAU,EACV,GAAG,6BAA6B,aAAa,EAC7C,cAAc,CACd,CAAA;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;QACnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,6BAA6B,aAAa,CAAC,CAAA;QACrE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YACnC,kBAAkB,EAAE,CAAC;YACrB,kBAAkB,EAAE,CAAC;YACrB,oBAAoB,EAAE,EAAE;SACxB,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QACvD,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAA;QAChD,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAE5B,MAAM,eAAe,GAAG,IAAI,CAC3B,IAAI,EACJ,UAAU,EACV,GAAG,6BAA6B,UAAU,EAC1C,UAAU,EACV,yBAAyB,EACzB,cAAc,CACd,CAAA;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;QACnE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;QACjD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QAEnD,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAA;QAChD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAE3C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAC5C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9C,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,CACrB,IAAI,EACJ,UAAU,EACV,GAAG,6BAA6B,MAAM,EACtC,UAAU,EACV,yBAAyB,EACzB,MAAM,EACN,OAAO,CACP,CAAA;QACD,MAAM,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QAC1F,sEAAsE;QACtE,+CAA+C;QAC/C,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAExB,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAA;QAChD,IAAI,CAAC;YACJ,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC5B,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAA;YACpD,MAAM,OAAO,GAAI,GAAgC,CAAC,OAAO,CAAA;YACzD,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YACvC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACzC,CAAC;gBAAS,CAAC;YACV,0CAA0C;YAC1C,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAChD,CAAC;IACF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

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":"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"}

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"}

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

@@ -0,0 +1,94 @@
+/**
+ * Boot-time filesystem re-layout — `.namzu/threads/{thd_X}/` →
+ * `.namzu/projects/{prj_legacy_<X>}/sessions/ses_legacy_default/runs/...`.
+ *
+ * Trigger: first {@link RunContextFactory.build} call per process. The
+ * factory invokes {@link DefaultFilesystemMigrator.migrate} before resolving
+ * any path so legacy runs are never orphaned by the new layout.
+ *
+ * See session-hierarchy.md §13.4.1 for the detection / trigger / atomicity
+ * contract. Concurrency model:
+ *
+ *   1. Main marker present → short-circuit `already_migrated`. Idempotent.
+ *   2. Legacy `.namzu/threads/` absent → write the main marker and return
+ *      `noop_no_legacy`. This plants the marker on fresh installs so the
+ *      `threads/` detection branch is only ever entered once.
+ *   3. Legacy layout detected → acquire the `.tmp` lock via `wx`; on
+ *      EEXIST another boot is mid-migration. The loser waits 100ms and
+ *      re-checks the main marker — cooperating, not competing. Roadmap
+ *      Risk #4 mitigation.
+ *   4. Per-legacy-thread: rename the whole `runs/` subtree in a single
+ *      `fs.rename` call (cross-OS atomic on the same filesystem; different
+ *      filesystems fall back to copy-then-unlink via Node's default — a
+ *      known limitation documented below).
+ *   5. Synthesize `project.json` + `session.json` via write-tmp-rename
+ *      (Convention #8) so partial crashes leave no half-serialised state.
+ *   6. Write main marker last — presence of the marker is the canonical
+ *      "migration done" signal.
+ *
+ * Known limitations:
+ *  - Cross-filesystem moves: Node's `fs.rename` rejects with `EXDEV` when
+ *    source and target live on different filesystems. This migrator does
+ *    NOT fall back to copy-then-unlink; the error surfaces as
+ *    {@link FilesystemMigrationError} with op `'rename_runs'`. Consumers
+ *    running `.namzu/threads` and `.namzu/projects` on different mounts
+ *    must migrate manually (documented INTERP flag).
+ *  - `UNKNOWN_TENANT_ID`: legacy threads have no tenant denormalisation on
+ *    disk. The synthesised project.json carries the sentinel so consumers
+ *    know these are legacy-rehomed and can either tag-then-retain or
+ *    reject until a real tenant is assigned (policy is consumer-owned).
+ */
+import type { ProjectId, SessionId } from '../../types/session/ids.js';
+/**
+ * Sentinel SessionId used for legacy pre-0.2.0 runs that pre-date the
+ * Session entity. Every migrated thread collapses into this single session
+ * so consumers can still address the runs through the new layout.
+ */
+export declare const LEGACY_DEFAULT_SESSION_ID: SessionId;
+/** Prefix for projects synthesised from legacy `thd_*` folders. */
+export declare const LEGACY_DEFAULT_PROJECT_PREFIX = "prj_legacy_";
+/** Marker version string persisted at `.migration/v0.2.0`. */
+export declare const MIGRATION_VERSION = "0.2.0";
+/** Marker file path relative to rootDir. */
+export declare const MARKER_REL_PATH: string;
+/** In-flight lock file path relative to rootDir. */
+export declare const LOCK_REL_PATH: string;
+/**
+ * Result of a migration attempt. `kind` discriminates the three outcomes;
+ * `migratedThreads` is only non-empty for `kind: 'migrated'`. Sinks and
+ * callers can switch on `kind` without string parsing.
+ */
+export interface FilesystemMigrationResult {
+    kind: 'migrated' | 'already_migrated' | 'noop_no_legacy';
+    migratedThreads: readonly {
+        legacyThreadId: string;
+        newProjectId: ProjectId;
+    }[];
+    markerPath: string;
+    at: Date;
+}
+/** Event emitted on successful migration (`kind === 'migrated'` only). */
+export interface FilesystemMigrationEvent {
+    type: 'filesystem.migrated';
+    result: FilesystemMigrationResult;
+}
+/** Sink contract — one `emit` method. */
+export interface FilesystemMigrationSink {
+    emit(event: FilesystemMigrationEvent): void;
+}
+export declare const NOOP_FILESYSTEM_MIGRATION_SINK: FilesystemMigrationSink;
+/** Interface so consumers can inject a stub migrator in tests. */
+export interface FilesystemMigrator {
+    migrate(rootDir: string): Promise<FilesystemMigrationResult>;
+}
+/**
+ * Default implementation. Migration is driven by the contract documented in
+ * the module header — readers should trace concerns to this comment rather
+ * than re-deriving from code.
+ */
+export declare class DefaultFilesystemMigrator implements FilesystemMigrator {
+    private readonly sink;
+    constructor(sink?: FilesystemMigrationSink);
+    migrate(rootDir: string): Promise<FilesystemMigrationResult>;
+}
+//# sourceMappingURL=filesystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/session/migration/filesystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAItE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAA2B,SAAS,CAAA;AAE1E,mEAAmE;AACnE,eAAO,MAAM,6BAA6B,gBAAgB,CAAA;AAE1D,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,UAAU,CAAA;AAExC,4CAA4C;AAC5C,eAAO,MAAM,eAAe,QAA+B,CAAA;AAE3D,oDAAoD;AACpD,eAAO,MAAM,aAAa,QAAmC,CAAA;AAK7D;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACzC,IAAI,EAAE,UAAU,GAAG,kBAAkB,GAAG,gBAAgB,CAAA;IACxD,eAAe,EAAE,SAAS;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,SAAS,CAAA;KAAE,EAAE,CAAA;IAC/E,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,IAAI,CAAA;CACR;AAED,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,qBAAqB,CAAA;IAC3B,MAAM,EAAE,yBAAyB,CAAA;CACjC;AAED,yCAAyC;AACzC,MAAM,WAAW,uBAAuB;IACvC,IAAI,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAA;CAC3C;AAED,eAAO,MAAM,8BAA8B,EAAE,uBAE5C,CAAA;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IAClC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAA;CAC5D;AAyCD;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,uBAAwD;IAErF,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;CA0NlE"}