@namzu/sdk 0.1.8 → 0.2.0

package/dist/session/__tests__/integration/hierarchy-lifecycle.test.js

@@ -0,0 +1,157 @@
+/**
+ * Integration — Tenant → Project → Session → SubSession → Run hierarchy
+ * lifecycle against a real {@link InMemorySessionStore}.
+ *
+ * Covers roadmap §5 invariants §4 (branded IDs), §4.3 (currentActor
+ * immutability), §4.4 (sub-session status fan-in to drill), plus the
+ * `drill()` navigation primitive (§14.3). Orthogonal to `e2e-spawn.test.ts`
+ * (which exercises the full AgentManager spawn path); this file asserts the
+ * raw store contract under direct construction.
+ */
+import { describe, expect, it } from 'vitest';
+import { TenantIsolationError } from '../../errors.js';
+import { DEFAULT_TENANT, agentActor, buildHarness, userActor } from './_fixtures.js';
+describe('Integration — hierarchy lifecycle', () => {
+    it('creates Tenant → Project → Session → SubSession with properly branded IDs', async () => {
+        const { store } = buildHarness();
+        const tenant = DEFAULT_TENANT;
+        const project = await store.createProject({ tenantId: tenant, name: 'p1' }, tenant);
+        expect(project.id.startsWith('prj_')).toBe(true);
+        expect(project.tenantId.startsWith('tnt_')).toBe(true);
+        const session = await store.createSession({ projectId: project.id, currentActor: userActor('usr_a') }, tenant);
+        expect(session.id.startsWith('ses_')).toBe(true);
+        expect(session.projectId).toBe(project.id);
+        expect(session.tenantId).toBe(tenant);
+        expect(session.status).toBe('idle');
+        expect(session.ownerVersion).toBe(0);
+        expect(session.previousActors).toEqual([]);
+        const childSession = await store.createSession({ projectId: project.id, currentActor: agentActor('agt_worker') }, tenant);
+        const subSession = await store.createSubSession({
+            parentSessionId: session.id,
+            childSessionId: childSession.id,
+            kind: 'agent_spawn',
+            spawnedBy: userActor('usr_a'),
+        }, tenant);
+        expect(subSession.id.startsWith('sub_')).toBe(true);
+        expect(subSession.parentSessionId).toBe(session.id);
+        expect(subSession.childSessionId).toBe(childSession.id);
+        expect(subSession.kind).toBe('agent_spawn');
+        expect(subSession.status).toBe('pending');
+    });
+    it('drill(parentSessionId) returns a SessionView with children[] and ancestry[]', async () => {
+        const { store } = buildHarness();
+        const tenant = DEFAULT_TENANT;
+        const project = await store.createProject({ tenantId: tenant, name: 'drill' }, tenant);
+        const parent = await store.createSession({ projectId: project.id, currentActor: userActor('usr_root') }, tenant);
+        const childA = await store.createSession({ projectId: project.id, currentActor: agentActor('agt_a') }, tenant);
+        const childB = await store.createSession({ projectId: project.id, currentActor: agentActor('agt_b') }, tenant);
+        await store.createSubSession({
+            parentSessionId: parent.id,
+            childSessionId: childA.id,
+            kind: 'agent_spawn',
+            spawnedBy: userActor('usr_root'),
+        }, tenant);
+        await store.createSubSession({
+            parentSessionId: parent.id,
+            childSessionId: childB.id,
+            kind: 'agent_spawn',
+            spawnedBy: userActor('usr_root'),
+        }, tenant);
+        const parentView = await store.drill(parent.id, tenant);
+        expect(parentView).not.toBeNull();
+        expect(parentView?.session.id).toBe(parent.id);
+        expect(parentView?.children).toHaveLength(2);
+        expect(parentView?.ancestry).toEqual([parent.id]);
+        const childAView = await store.drill(childA.id, tenant);
+        expect(childAView).not.toBeNull();
+        expect(childAView?.ancestry).toEqual([parent.id, childA.id]);
+        expect(childAView?.children).toHaveLength(0);
+    });
+    it('drill returns null for unknown session (deny-by-default)', async () => {
+        const { store } = buildHarness();
+        const view = await store.drill('ses_missing', DEFAULT_TENANT);
+        expect(view).toBeNull();
+    });
+    it('§4.3 currentActor immutable previousActors — append-only on handoff', async () => {
+        const { store } = buildHarness();
+        const tenant = DEFAULT_TENANT;
+        const project = await store.createProject({ tenantId: tenant, name: 'actors' }, tenant);
+        const userA = userActor('usr_a');
+        const userB = userActor('usr_b');
+        const userC = userActor('usr_c');
+        const session = await store.createSession({ projectId: project.id, currentActor: userA }, tenant);
+        // Simulate two successive handoff commits — each pushes the old actor
+        // onto previousActors and increments ownerVersion.
+        const firstHandoff = {
+            ...session,
+            currentActor: userB,
+            previousActors: [userA],
+            ownerVersion: 1,
+        };
+        await store.updateSession(firstHandoff, tenant);
+        const secondHandoff = {
+            ...firstHandoff,
+            currentActor: userC,
+            previousActors: [...firstHandoff.previousActors, userB],
+            ownerVersion: 2,
+        };
+        await store.updateSession(secondHandoff, tenant);
+        const reloaded = await store.getSession(session.id, tenant);
+        expect(reloaded?.currentActor).toEqual(userC);
+        expect(reloaded?.previousActors).toEqual([userA, userB]);
+        expect(reloaded?.ownerVersion).toBe(2);
+    });
+    it('cycle guard via AncestryCycleError: ancestry walk detects corrupted parent linkage', async () => {
+        const { store } = buildHarness();
+        const tenant = DEFAULT_TENANT;
+        const project = await store.createProject({ tenantId: tenant, name: 'cycle' }, tenant);
+        const sA = await store.createSession({ projectId: project.id, currentActor: userActor('usr_a') }, tenant);
+        const sB = await store.createSession({ projectId: project.id, currentActor: userActor('usr_b') }, tenant);
+        // Valid edge sA → sB.
+        await store.createSubSession({
+            parentSessionId: sA.id,
+            childSessionId: sB.id,
+            kind: 'agent_spawn',
+            spawnedBy: userActor('usr_a'),
+        }, tenant);
+        // Corrupting edge sB → sA closes the cycle. The store layer does not
+        // pre-check parent direction (the pattern doc §4.5 discusses
+        // intervention DAG cycles; ancestry cycles are a store-corruption
+        // detection path per session/errors.ts#AncestryCycleError).
+        await store.createSubSession({
+            parentSessionId: sB.id,
+            childSessionId: sA.id,
+            kind: 'agent_spawn',
+            spawnedBy: userActor('usr_b'),
+        }, tenant);
+        await expect(store.getAncestry(sB.id, tenant)).rejects.toThrow(/cycle/i);
+    });
+    it('SubSession pending → active → idle lifecycle', async () => {
+        const { store } = buildHarness();
+        const tenant = DEFAULT_TENANT;
+        const project = await store.createProject({ tenantId: tenant, name: 'lifecycle' }, tenant);
+        const parent = await store.createSession({ projectId: project.id, currentActor: userActor('usr_a') }, tenant);
+        const child = await store.createSession({ projectId: project.id, currentActor: agentActor('agt_a') }, tenant);
+        const sub = await store.createSubSession({
+            parentSessionId: parent.id,
+            childSessionId: child.id,
+            kind: 'agent_spawn',
+            spawnedBy: userActor('usr_a'),
+        }, tenant);
+        expect(sub.status).toBe('pending');
+        // pending → active.
+        await store.updateSubSession({ ...sub, status: 'active' }, tenant);
+        const active = await store.getSubSession(sub.id, tenant);
+        expect(active?.status).toBe('active');
+        // active → idle (§5.3: no 'closed' state — sub-sessions terminate on idle).
+        await store.updateSubSession({ ...sub, status: 'idle' }, tenant);
+        const idle = await store.getSubSession(sub.id, tenant);
+        expect(idle?.status).toBe('idle');
+    });
+    it('cross-tenant hierarchy access rejects via TenantIsolationError', async () => {
+        const { store } = buildHarness();
+        const projectA = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'a' }, DEFAULT_TENANT);
+        await expect(store.getProject(projectA.id, 'tnt_other')).rejects.toBeInstanceOf(TenantIsolationError);
+    });
+});
+//# sourceMappingURL=hierarchy-lifecycle.test.js.map

package/dist/session/__tests__/integration/hierarchy-lifecycle.test.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=migration-filesystem.test.d.ts.map

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

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

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