@namzu/sdk 0.1.7 → 0.2.0

package/dist/session/workspace/__tests__/git-worktree.test.js

@@ -0,0 +1,244 @@
+import { describe, expect, it, vi } from 'vitest';
+import { WorkspaceBackendError } from '../../errors.js';
+import { GitWorktreeDriver, parseWorktreeList, } from '../git-worktree.js';
+function stubLogger() {
+    return {
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        child() {
+            return stubLogger();
+        },
+    };
+}
+function okExec(stdout = '', stderr = '') {
+    return { stdout, stderr };
+}
+describe('GitWorktreeDriver', () => {
+    it('create: invokes `git worktree add` with argv array (no shell interpolation)', async () => {
+        const calls = [];
+        const exec = async (file, args) => {
+            calls.push({ file, args: [...args] });
+            return okExec();
+        };
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        const ref = await driver.create({ label: 'foo', baseRef: 'main' });
+        expect(ref.id.startsWith('wsp_')).toBe(true);
+        expect(ref.meta.backend).toBe('git-worktree');
+        expect(ref.meta.branch).toBe('namzu/foo');
+        expect(calls).toHaveLength(1);
+        const call = calls[0];
+        if (!call)
+            throw new Error('missing call');
+        expect(call.file).toBe('git');
+        expect(call.args).toEqual([
+            '-C',
+            '/repo',
+            'worktree',
+            'add',
+            '-b',
+            'namzu/foo',
+            '/repo/.namzu/worktrees/foo',
+            'main',
+        ]);
+    });
+    it('create: omits baseRef argv slot when not supplied', async () => {
+        const calls = [];
+        const exec = async (file, args) => {
+            calls.push({ file, args: [...args] });
+            return okExec();
+        };
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        await driver.create({ label: 'bar' });
+        const call = calls[0];
+        if (!call)
+            throw new Error('missing call');
+        expect(call.args.at(-1)).toBe('/repo/.namzu/worktrees/bar');
+    });
+    it('create: wraps failures in WorkspaceBackendError', async () => {
+        const exec = async () => {
+            throw new Error('invalid baseRef');
+        };
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        await expect(driver.create({ baseRef: 'does-not-exist' })).rejects.toBeInstanceOf(WorkspaceBackendError);
+    });
+    it('dispose: removes worktree with --force', async () => {
+        const calls = [];
+        const exec = async (_file, args) => {
+            calls.push(args);
+            return okExec();
+        };
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        const ref = {
+            id: 'wsp_x',
+            meta: {
+                backend: 'git-worktree',
+                repoRoot: '/repo',
+                branch: 'namzu/x',
+                worktreePath: '/repo/.namzu/worktrees/x',
+            },
+            createdAt: new Date(),
+        };
+        await driver.dispose(ref);
+        expect(calls[0]).toEqual([
+            '-C',
+            '/repo',
+            'worktree',
+            'remove',
+            '/repo/.namzu/worktrees/x',
+            '--force',
+        ]);
+    });
+    it('dispose: tolerates missing worktree ("not a working tree")', async () => {
+        const exec = async () => {
+            throw new Error("'/tmp/gone' is not a working tree");
+        };
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        const ref = {
+            id: 'wsp_x',
+            meta: {
+                backend: 'git-worktree',
+                repoRoot: '/repo',
+                branch: 'namzu/x',
+                worktreePath: '/tmp/gone',
+            },
+            createdAt: new Date(),
+        };
+        // Must NOT throw — roadmap Risk #3 mitigation.
+        await expect(driver.dispose(ref)).resolves.toBeUndefined();
+    });
+    it('dispose: surfaces unexpected failures as WorkspaceBackendError', async () => {
+        const exec = async () => {
+            throw new Error('fatal: permission denied');
+        };
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        const ref = {
+            id: 'wsp_x',
+            meta: {
+                backend: 'git-worktree',
+                repoRoot: '/repo',
+                branch: 'namzu/x',
+                worktreePath: '/repo/.namzu/worktrees/x',
+            },
+            createdAt: new Date(),
+        };
+        await expect(driver.dispose(ref)).rejects.toBeInstanceOf(WorkspaceBackendError);
+    });
+    it('inspect: parses list output and detects clean tree', async () => {
+        const listStdout = [
+            'worktree /repo/.namzu/worktrees/x',
+            'HEAD abc123',
+            'branch refs/heads/namzu/x',
+            '',
+        ].join('\n');
+        let callIndex = 0;
+        const exec = async (_file, args) => {
+            callIndex++;
+            if (args.includes('list'))
+                return okExec(listStdout);
+            if (args.includes('status'))
+                return okExec('');
+            throw new Error(`unexpected call ${callIndex}`);
+        };
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        const ref = {
+            id: 'wsp_x',
+            meta: {
+                backend: 'git-worktree',
+                repoRoot: '/repo',
+                branch: 'namzu/x',
+                worktreePath: '/repo/.namzu/worktrees/x',
+            },
+            createdAt: new Date(),
+        };
+        const inspection = await driver.inspect(ref);
+        expect(inspection.exists).toBe(true);
+        expect(inspection.isDirty).toBe(false);
+    });
+    it('inspect: reports dirty when status --porcelain has output', async () => {
+        const listStdout = [
+            'worktree /repo/.namzu/worktrees/x',
+            'HEAD abc123',
+            'branch refs/heads/namzu/x',
+            '',
+        ].join('\n');
+        const exec = async (_file, args) => {
+            if (args.includes('list'))
+                return okExec(listStdout);
+            if (args.includes('status'))
+                return okExec(' M path/to/file\n');
+            throw new Error('unexpected');
+        };
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        const ref = {
+            id: 'wsp_x',
+            meta: {
+                backend: 'git-worktree',
+                repoRoot: '/repo',
+                branch: 'namzu/x',
+                worktreePath: '/repo/.namzu/worktrees/x',
+            },
+            createdAt: new Date(),
+        };
+        const inspection = await driver.inspect(ref);
+        expect(inspection.isDirty).toBe(true);
+    });
+});
+describe('parseWorktreeList', () => {
+    it('returns null when the target path is absent', () => {
+        const stdout = ['worktree /other', 'HEAD abc', 'branch refs/heads/main', ''].join('\n');
+        expect(parseWorktreeList(stdout, '/missing')).toBeNull();
+    });
+    it('extracts head + branch for the matching entry', () => {
+        const stdout = [
+            'worktree /repo/.namzu/worktrees/x',
+            'HEAD deadbeef',
+            'branch refs/heads/namzu/x',
+            '',
+            'worktree /other',
+            'HEAD abc',
+            'bare',
+            '',
+        ].join('\n');
+        const entry = parseWorktreeList(stdout, '/repo/.namzu/worktrees/x');
+        expect(entry).toEqual({
+            path: '/repo/.namzu/worktrees/x',
+            head: 'deadbeef',
+            branch: 'refs/heads/namzu/x',
+        });
+    });
+});
+//# sourceMappingURL=git-worktree.test.js.map

package/dist/session/workspace/__tests__/git-worktree.test.js.map

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

package/dist/session/workspace/__tests__/path-builder.test.d.ts

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

package/dist/session/workspace/__tests__/path-builder.test.d.ts.map

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

package/dist/session/workspace/__tests__/path-builder.test.js

@@ -0,0 +1,37 @@
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { DefaultPathBuilder } from '../path-builder.js';
+const projectId = 'prj_abc';
+const sessionId = 'ses_xyz';
+const subSessionId = 'sub_qqq';
+const runId = 'run_rrr';
+describe('DefaultPathBuilder', () => {
+    it('rootDir returns the injected root verbatim', () => {
+        const pb = new DefaultPathBuilder('/tmp/ns');
+        expect(pb.rootDir()).toBe('/tmp/ns');
+    });
+    it('projectDir resolves to {root}/projects/{projectId}', () => {
+        const pb = new DefaultPathBuilder('/tmp/ns');
+        expect(pb.projectDir(projectId)).toBe(join('/tmp/ns', 'projects', projectId));
+    });
+    it('sessionDir resolves to {root}/projects/{projectId}/sessions/{sessionId}', () => {
+        const pb = new DefaultPathBuilder('/tmp/ns');
+        expect(pb.sessionDir(projectId, sessionId)).toBe(join('/tmp/ns', 'projects', projectId, 'sessions', sessionId));
+    });
+    it('subSessionDir nests under session/subsessions/{subSessionId}', () => {
+        const pb = new DefaultPathBuilder('/tmp/ns');
+        expect(pb.subSessionDir(projectId, sessionId, subSessionId)).toBe(join('/tmp/ns', 'projects', projectId, 'sessions', sessionId, 'subsessions', subSessionId));
+    });
+    it('runDir nests under session/runs/{runId}', () => {
+        const pb = new DefaultPathBuilder('/tmp/ns');
+        expect(pb.runDir(projectId, sessionId, runId)).toBe(join('/tmp/ns', 'projects', projectId, 'sessions', sessionId, 'runs', runId));
+    });
+    it('root injection is per-instance (does not mutate global state)', () => {
+        const a = new DefaultPathBuilder('/tmp/a');
+        const b = new DefaultPathBuilder('/tmp/b');
+        expect(a.rootDir()).toBe('/tmp/a');
+        expect(b.rootDir()).toBe('/tmp/b');
+        expect(a.projectDir(projectId)).not.toBe(b.projectDir(projectId));
+    });
+});
+//# sourceMappingURL=path-builder.test.js.map

package/dist/session/workspace/__tests__/path-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-builder.test.js","sourceRoot":"","sources":["../../../../src/session/workspace/__tests__/path-builder.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,MAAM,SAAS,GAAG,SAAsB,CAAA;AACxC,MAAM,SAAS,GAAG,SAAsB,CAAA;AACxC,MAAM,YAAY,GAAG,SAAyB,CAAA;AAC9C,MAAM,KAAK,GAAG,SAAkB,CAAA;AAEhC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACrD,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC7D,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAC5C,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QAClF,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAC5C,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAC/C,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAC7D,CAAA;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACvE,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAC5C,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAChE,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,CAAC,CAC1F,CAAA;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAClD,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAC5C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAClD,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAC5E,CAAA;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,GAAG,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAA;QAC1C,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAClC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAClC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/session/workspace/driver.d.ts

@@ -0,0 +1,55 @@
+/**
+ * WorkspaceBackendDriver — pluggable backend contract for workspace
+ * provisioning. See session-hierarchy.md §7.1.
+ *
+ * Every Session persists a {@link WorkspaceRef}; the driver owns the
+ * underlying filesystem/container/etc. semantics. Phase 3 ships the
+ * git-worktree reference implementation (`git-worktree.ts`); tmpfs,
+ * container, and shared variants slot behind this same interface in a
+ * later phase (Convention #10: provider abstraction).
+ */
+import type { WorkspaceBackendKind, WorkspaceRef } from './ref.js';
+/**
+ * Params for {@link WorkspaceBackendDriver.create}. `baseRef` selects the
+ * commit / branch the workspace should track; when absent the driver
+ * provisions from the backend's default (e.g. the current branch of the
+ * repo for git-worktree).
+ */
+export interface CreateWorkspaceParams {
+    baseRef?: string;
+    label?: string;
+}
+/**
+ * Params for {@link WorkspaceBackendDriver.branch}. `label` is a free-form
+ * tag embedded into the new workspace name so operators can trace provenance
+ * without reaching into the driver's internal naming scheme.
+ */
+export interface BranchWorkspaceParams {
+    label?: string;
+}
+/**
+ * Snapshot returned by {@link WorkspaceBackendDriver.inspect}. `exists` is
+ * `false` when the underlying resource has been disposed out-of-band (e.g.
+ * manual `git worktree remove` on disk); consumers can use it to detect
+ * divergence between the persisted {@link WorkspaceRef} and the backend.
+ */
+export interface WorkspaceInspection {
+    exists: boolean;
+    currentRef: string;
+    isDirty: boolean;
+}
+/**
+ * Backend driver contract. All methods are async and may throw
+ * {@link WorkspaceBackendError} on I/O failures. `dispose` is idempotent —
+ * calling it against an already-disposed ref is not an error (mitigates
+ * roadmap Risk #3: broadcast rollback must not fail on partial state).
+ */
+export interface WorkspaceBackendDriver {
+    readonly kind: WorkspaceBackendKind;
+    create(params: CreateWorkspaceParams): Promise<WorkspaceRef>;
+    branch(source: WorkspaceRef, params: BranchWorkspaceParams): Promise<WorkspaceRef>;
+    dispose(ref: WorkspaceRef): Promise<void>;
+    inspect(ref: WorkspaceRef): Promise<WorkspaceInspection>;
+}
+export type { WorkspaceBackendKind } from './ref.js';
+//# sourceMappingURL=driver.d.ts.map

package/dist/session/workspace/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/session/workspace/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAElE;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;IACnC,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC5D,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAClF,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;CACxD;AAED,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}

package/dist/session/workspace/driver.js

@@ -0,0 +1,12 @@
+/**
+ * WorkspaceBackendDriver — pluggable backend contract for workspace
+ * provisioning. See session-hierarchy.md §7.1.
+ *
+ * Every Session persists a {@link WorkspaceRef}; the driver owns the
+ * underlying filesystem/container/etc. semantics. Phase 3 ships the
+ * git-worktree reference implementation (`git-worktree.ts`); tmpfs,
+ * container, and shared variants slot behind this same interface in a
+ * later phase (Convention #10: provider abstraction).
+ */
+export {};
+//# sourceMappingURL=driver.js.map

package/dist/session/workspace/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/session/workspace/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/session/workspace/git-worktree.d.ts

@@ -0,0 +1,65 @@
+/**
+ * GitWorktreeDriver — reference implementation of
+ * {@link WorkspaceBackendDriver} backed by `git worktree`.
+ *
+ * See session-hierarchy.md §7.2 (Git-worktree reference backend).
+ *
+ * Safety: every subprocess invocation uses `execFile` with an argv array —
+ * no shell interpolation — so caller-supplied `label`/`baseRef` strings
+ * cannot escape their argument slot. Failures surface as
+ * {@link WorkspaceBackendError} carrying the underlying cause.
+ */
+import type { Logger } from '../../utils/logger.js';
+import type { BranchWorkspaceParams, CreateWorkspaceParams, WorkspaceBackendDriver, WorkspaceInspection } from './driver.js';
+import type { WorkspaceRef } from './ref.js';
+/**
+ * Minimal shape of `execFile`'s promisified result — allows tests to stub
+ * via dependency injection without pulling in the full `ChildProcess` type.
+ */
+export interface ExecFileResult {
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Async exec callable used by {@link GitWorktreeDriver}. Matches the shape
+ * of `promisify(execFile)` for the argv-array overload. Injected via the
+ * constructor so tests can stub without touching `child_process`.
+ */
+export type ExecFile = (file: string, args: readonly string[]) => Promise<ExecFileResult>;
+/**
+ * Configuration for {@link GitWorktreeDriver}.
+ */
+export interface GitWorktreeDriverConfig {
+    /** Absolute path to the repo root whose `.git` backs the worktrees. */
+    repoRoot: string;
+    /**
+     * Directory (absolute) where worktree checkouts live. Defaults to
+     * `{repoRoot}/.namzu/worktrees` per session-hierarchy.md §7.2.
+     */
+    worktreesDir?: string;
+    logger: Logger;
+    /** Test-seam: inject a stub `execFile` implementation. */
+    execFile?: ExecFile;
+}
+export declare class GitWorktreeDriver implements WorkspaceBackendDriver {
+    readonly kind: "git-worktree";
+    private readonly repoRoot;
+    private readonly worktreesDir;
+    private readonly log;
+    private readonly exec;
+    constructor(config: GitWorktreeDriverConfig);
+    create(params: CreateWorkspaceParams): Promise<WorkspaceRef>;
+    branch(source: WorkspaceRef, params: BranchWorkspaceParams): Promise<WorkspaceRef>;
+    dispose(ref: WorkspaceRef): Promise<void>;
+    inspect(ref: WorkspaceRef): Promise<WorkspaceInspection>;
+}
+/**
+ * Parses `git worktree list --porcelain` output, returning the record for
+ * `worktreePath` or `null` when absent. Exported for tests.
+ */
+export declare function parseWorktreeList(stdout: string, worktreePath: string): {
+    path: string;
+    head?: string;
+    branch?: string;
+} | null;
+//# sourceMappingURL=git-worktree.d.ts.map

package/dist/session/workspace/git-worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree.d.ts","sourceRoot":"","sources":["../../../src/session/workspace/git-worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,EACX,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAA0B,YAAY,EAAE,MAAM,UAAU,CAAA;AAIpE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAIzF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB;AAED,qBAAa,iBAAkB,YAAW,sBAAsB;IAC/D,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;gBAEnB,MAAM,EAAE,uBAAuB;IAOrC,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAgC5D,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAMlF,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BzC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAkC9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBzD"}

package/dist/session/workspace/git-worktree.js

@@ -0,0 +1,156 @@
+/**
+ * GitWorktreeDriver — reference implementation of
+ * {@link WorkspaceBackendDriver} backed by `git worktree`.
+ *
+ * See session-hierarchy.md §7.2 (Git-worktree reference backend).
+ *
+ * Safety: every subprocess invocation uses `execFile` with an argv array —
+ * no shell interpolation — so caller-supplied `label`/`baseRef` strings
+ * cannot escape their argument slot. Failures surface as
+ * {@link WorkspaceBackendError} carrying the underlying cause.
+ */
+import { execFile } from 'node:child_process';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { generateWorkspaceId } from '../../utils/id.js';
+import { WorkspaceBackendError } from '../errors.js';
+const execFileAsync = promisify(execFile);
+const defaultExecFile = async (file, args) => execFileAsync(file, [...args]);
+export class GitWorktreeDriver {
+    kind = 'git-worktree';
+    repoRoot;
+    worktreesDir;
+    log;
+    exec;
+    constructor(config) {
+        this.repoRoot = config.repoRoot;
+        this.worktreesDir = config.worktreesDir ?? join(config.repoRoot, '.namzu', 'worktrees');
+        this.log = config.logger.child({ component: 'GitWorktreeDriver' });
+        this.exec = config.execFile ?? defaultExecFile;
+    }
+    async create(params) {
+        const id = generateWorkspaceId();
+        const label = params.label ?? id;
+        const branch = `namzu/${label}`;
+        const worktreePath = join(this.worktreesDir, label);
+        const argv = ['-C', this.repoRoot, 'worktree', 'add', '-b', branch, worktreePath];
+        if (params.baseRef !== undefined) {
+            argv.push(params.baseRef);
+        }
+        try {
+            await this.exec('git', argv);
+        }
+        catch (cause) {
+            throw new WorkspaceBackendError({ op: 'create', kind: this.kind, cause });
+        }
+        const meta = {
+            backend: 'git-worktree',
+            repoRoot: this.repoRoot,
+            branch,
+            worktreePath,
+        };
+        this.log.info('git-worktree created', { id, branch, worktreePath });
+        return {
+            id,
+            meta,
+            createdAt: new Date(),
+        };
+    }
+    async branch(source, params) {
+        // Branch from the source worktree's current branch. The source's
+        // `meta.branch` is the ref we base off.
+        return this.create({ baseRef: source.meta.branch, label: params.label });
+    }
+    async dispose(ref) {
+        // Tolerate missing directories per roadmap Risk #3 mitigation: the
+        // broadcast-rollback compensating step calls dispose on partially
+        // provisioned refs and must not propagate "already gone" errors.
+        try {
+            await this.exec('git', [
+                '-C',
+                this.repoRoot,
+                'worktree',
+                'remove',
+                ref.meta.worktreePath,
+                '--force',
+            ]);
+            this.log.info('git-worktree disposed', { id: ref.id, path: ref.meta.worktreePath });
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            // git exits non-zero with "is not a working tree" when the path is
+            // absent; treat as idempotent success and log at debug.
+            if (/not a working tree|does not exist|No such file/i.test(message)) {
+                this.log.debug('git-worktree already gone; dispose idempotent', {
+                    id: ref.id,
+                    path: ref.meta.worktreePath,
+                });
+                return;
+            }
+            throw new WorkspaceBackendError({ op: 'dispose', kind: this.kind, cause });
+        }
+    }
+    async inspect(ref) {
+        let listStdout;
+        try {
+            const result = await this.exec('git', [
+                '-C',
+                this.repoRoot,
+                'worktree',
+                'list',
+                '--porcelain',
+            ]);
+            listStdout = result.stdout;
+        }
+        catch (cause) {
+            throw new WorkspaceBackendError({ op: 'inspect:list', kind: this.kind, cause });
+        }
+        const entry = parseWorktreeList(listStdout, ref.meta.worktreePath);
+        if (!entry) {
+            return { exists: false, currentRef: ref.meta.branch, isDirty: false };
+        }
+        let statusStdout;
+        try {
+            const result = await this.exec('git', ['-C', ref.meta.worktreePath, 'status', '--porcelain']);
+            statusStdout = result.stdout;
+        }
+        catch (cause) {
+            throw new WorkspaceBackendError({ op: 'inspect:status', kind: this.kind, cause });
+        }
+        return {
+            exists: true,
+            currentRef: entry.branch ?? entry.head ?? ref.meta.branch,
+            isDirty: statusStdout.trim().length > 0,
+        };
+    }
+}
+/**
+ * Parses `git worktree list --porcelain` output, returning the record for
+ * `worktreePath` or `null` when absent. Exported for tests.
+ */
+export function parseWorktreeList(stdout, worktreePath) {
+    const blocks = stdout.split(/\n\n+/);
+    for (const block of blocks) {
+        const lines = block.split('\n').filter((l) => l.length > 0);
+        let path;
+        let head;
+        let branch;
+        for (const line of lines) {
+            if (line.startsWith('worktree '))
+                path = line.slice('worktree '.length);
+            else if (line.startsWith('HEAD '))
+                head = line.slice('HEAD '.length);
+            else if (line.startsWith('branch '))
+                branch = line.slice('branch '.length);
+        }
+        if (path === worktreePath) {
+            return {
+                path,
+                ...(head !== undefined && { head }),
+                ...(branch !== undefined && { branch }),
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=git-worktree.js.map

package/dist/session/workspace/git-worktree.js.map

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

package/dist/session/workspace/index.d.ts

@@ -0,0 +1,8 @@
+export type { WorkspaceRef, WorkspaceBackendMeta, WorkspaceBackendKind, GitWorktreeBackendMeta, } from './ref.js';
+export type { WorkspaceBackendDriver, CreateWorkspaceParams, BranchWorkspaceParams, WorkspaceInspection, } from './driver.js';
+export { DefaultPathBuilder } from './path-builder.js';
+export type { PathBuilder } from './path-builder.js';
+export { WorkspaceBackendRegistry } from './registry.js';
+export { GitWorktreeDriver, parseWorktreeList } from './git-worktree.js';
+export type { ExecFile, ExecFileResult, GitWorktreeDriverConfig } from './git-worktree.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/workspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/session/workspace/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACtB,MAAM,UAAU,CAAA;AAEjB,YAAY,EACX,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACxE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/session/workspace/index.js

@@ -0,0 +1,7 @@
+// Sub-barrel for the workspace module (Convention #4).
+// Concrete types + driver implementation live in sibling files; re-export
+// them here so other modules import via `../session/workspace/index.js`.
+export { DefaultPathBuilder } from './path-builder.js';
+export { WorkspaceBackendRegistry } from './registry.js';
+export { GitWorktreeDriver, parseWorktreeList } from './git-worktree.js';
+//# sourceMappingURL=index.js.map

package/dist/session/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/session/workspace/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,0EAA0E;AAC1E,yEAAyE;AAgBzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA"}