dsh-git-worktree 0.8.0 → 0.9.2

package/lib/adapters/initial-commit.js

@@ -0,0 +1,112 @@
+import { createHash } from 'node:crypto';
+import { lstat, open, readdir, readFile, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { SessionCheckoutError } from '../index.js';
+import { hostMessage } from '../i18n/host.js';
+/** Only the Console's confirmed host action calls initialize; normal Git inspection is read-only. */
+export function initialCommitActions(inspect, run) {
+    const stale = () => new SessionCheckoutError('stale_local', hostMessage('initialStateChanged'));
+    async function checked(root, args, input) {
+        const result = await run(root, args, input);
+        if (result.code !== 0)
+            throw new SessionCheckoutError('git_operation_failed', hostMessage('initialCommitFailed'));
+        return result.stdout;
+    }
+    async function identity(path, trackChanges = false) {
+        const stat = await lstat(path, { bigint: true });
+        if (stat.isSymbolicLink())
+            throw stale();
+        return `${stat.dev}:${stat.ino}:${stat.birthtimeNs}${trackChanges ? `:${stat.mtimeNs}:${stat.ctimeNs}` : ''}`;
+    }
+    async function indexBytes(gitDir) {
+        try {
+            return (await readFile(join(gitDir, 'index'))).toString('base64');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return '';
+            throw error;
+        }
+    }
+    async function preflightInitialCommit(root) {
+        const snapshot = await inspect(root);
+        if (snapshot === null)
+            throw new SessionCheckoutError('not_git_repository', hostMessage('repositoryInspectionFailed'));
+        if (snapshot.headOid !== 'unborn')
+            return { kind: 'ready', fingerprint: '', snapshot };
+        const entries = await readdir(snapshot.root);
+        // Filesystem enumeration deliberately ignores no patterns: ignored files, symlinks,
+        // nested repositories and empty directories all require an explicit user decision.
+        const files = entries.filter(name => name !== '.git');
+        const index = await checked(root, ['ls-files', '--stage', '-z']);
+        if (files.length || index)
+            return { kind: 'files', fingerprint: '', snapshot };
+        const fingerprint = createHash('sha256').update(JSON.stringify({
+            snapshot, rootIdentity: await identity(root, true), canonicalIdentity: await identity(snapshot.root, true),
+            gitIdentity: await identity(snapshot.gitDir), commonIdentity: await identity(snapshot.commonDir),
+            head: (await readFile(join(snapshot.gitDir, 'HEAD'))).toString('base64'),
+            headIdentity: await identity(join(snapshot.gitDir, 'HEAD'), true),
+            index: await indexBytes(snapshot.gitDir), files: files.sort(),
+        })).digest('hex');
+        return { kind: 'empty', fingerprint, snapshot };
+    }
+    async function initializeEmptyRepository(root, fingerprint, assertAuthorized) {
+        const before = await preflightInitialCommit(root);
+        if (before.kind !== 'empty' || before.fingerprint !== fingerprint)
+            throw stale();
+        const locks = [];
+        try {
+            // The index lock excludes cooperating index writers and other initializers;
+            // the ref transaction below locks HEAD. Never remove a lock we did not create.
+            for (const name of ['index.lock']) {
+                const path = join(before.snapshot.gitDir, name);
+                locks.push({ path, handle: await open(path, 'wx') });
+            }
+            const current = await preflightInitialCommit(root);
+            if (current.kind !== 'empty' || current.fingerprint !== fingerprint)
+                throw stale();
+            await assertAuthorized?.();
+            for (const variable of ['GIT_AUTHOR_IDENT', 'GIT_COMMITTER_IDENT']) {
+                const ident = await run(root, ['-c', 'user.useConfigOnly=true', 'var', variable]);
+                if (ident.code !== 0)
+                    throw new SessionCheckoutError('git_operation_failed', hostMessage('initialIdentityMissing'));
+            }
+            // mktree with an empty stdin creates the empty tree without touching the index.
+            const tree = await checked(root, ['mktree']);
+            const oid = await checked(root, ['-c', 'user.useConfigOnly=true', 'commit-tree', tree, '-m', 'Initial commit']);
+            const latest = await preflightInitialCommit(root);
+            if (latest.kind !== 'empty' || latest.fingerprint !== fingerprint)
+                throw stale();
+            // Compare-and-swap the previously unborn branch; never overwrite a racing commit.
+            // Git prepares the HEAD update and locks HEAD plus the resolved branch. Only
+            // after rechecking under those locks may the transaction publish the commit.
+            await checked(root, ['update-ref', '--stdin'], {
+                prepare: `start
+update HEAD ${oid} ${'0'.repeat(oid.length)}
+prepare
+`,
+                async beforeCommit() {
+                    const locked = await preflightInitialCommit(root);
+                    if (locked.kind !== 'empty' || locked.fingerprint !== fingerprint)
+                        throw stale();
+                    await assertAuthorized?.();
+                },
+            });
+            return oid;
+        }
+        catch (error) {
+            if (error.code === 'EEXIST') {
+                throw new SessionCheckoutError('operation_not_allowed', hostMessage('initialRepositoryBusy'));
+            }
+            throw error;
+        }
+        finally {
+            for (const lock of locks.reverse()) {
+                await lock.handle.close();
+                await unlink(lock.path);
+            }
+        }
+    }
+    return { preflightInitialCommit, initializeEmptyRepository };
+}
+//# sourceMappingURL=initial-commit.js.map

package/lib/adapters/initial-commit.js.map

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

package/lib/adapters/lookup.js

@@ -40,6 +40,27 @@ export function createDshLookupPort(ctx) {
         return isSessionStoreLike(candidate) ? candidate : undefined;
     };
     return {
+        getSidebarMemberships: async (managedRoots) => {
+            if (managedRoots.length === 0)
+                return [];
+            const workspaces = registry()?.list() ?? [];
+            const query = ctx.get('sessionQuery');
+            // Query headers, not transcript bodies or cached projection metadata.
+            // A missing directory must not erase historical navigation identity.
+            const headers = query?.listSessions ? (await query.listSessions()).map(item => item.header) : [];
+            return [...new Set(managedRoots)].map(managedRoot => {
+                const matches = workspaces.filter(workspace => sameResolvedPath(workspace.path, managedRoot));
+                return {
+                    managedRoot,
+                    workspaceIds: matches.map(workspace => workspace.id),
+                    sessionIds: [...new Set([
+                            ...matches.flatMap(workspace => [...workspace.sessionIds]),
+                            ...headers.filter(header => typeof header.cwd === 'string' && sameResolvedPath(header.cwd, managedRoot))
+                                .map(header => header.id),
+                        ])],
+                };
+            });
+        },
         getSession: (sessionId) => {
             const workspaces = registry()?.list() ?? [];
             for (const workspace of workspaces) {

package/lib/adapters/lookup.js.map

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

package/lib/adapters/project-skill-io.d.ts

@@ -0,0 +1,12 @@
+export interface SkillRead {
+    path: string;
+    maxBytes: number;
+}
+export interface SkillBytes {
+    path: string;
+    content: Buffer;
+    mode: number;
+}
+export declare function readSkillFiles(root: string, identity: string, files: readonly SkillRead[]): Promise<SkillBytes[]>;
+export declare function createSkillDirectories(root: string, identity: string, directories: readonly string[]): Promise<void>;
+export declare function createSkillFiles(root: string, identity: string, files: readonly SkillBytes[]): Promise<void>;

package/lib/adapters/project-skill-io.js

@@ -0,0 +1,96 @@
+import { constants } from 'node:fs';
+import { lstat, mkdir, open } from 'node:fs/promises';
+import { join } from 'node:path';
+// These checks support trusted local creation, not atomic containment against
+// another process maliciously replacing ancestors between filesystem calls.
+async function checkRoot(root, expected) {
+    const stat = await lstat(root, { bigint: true });
+    if (!stat.isDirectory() || stat.isSymbolicLink() || `${stat.dev}:${stat.ino}:${stat.birthtimeNs}` !== expected) {
+        throw new Error('Project Skills: checkout directory changed');
+    }
+}
+async function checkPath(root, path, createParents = false) {
+    const parts = path.split('/');
+    if (!['.dsh', '.agents', '.claude'].includes(parts[0]) || parts[1] !== 'skills'
+        || parts.some(part => !part || part === '.' || part === '..' || /[\\:\x00-\x1f]/.test(part)))
+        throw new Error('Project Skills: invalid path');
+    let current = root;
+    for (const [index, part] of parts.entries()) {
+        current = join(current, part);
+        if (createParents && index < parts.length - 1) {
+            await mkdir(current).catch(error => { if (error.code !== 'EEXIST')
+                throw error; });
+        }
+        try {
+            const stat = await lstat(current);
+            if (stat.isSymbolicLink() || (index < parts.length - 1 ? !stat.isDirectory() : !stat.isFile() && !stat.isDirectory())) {
+                throw new Error('Project Skills: links and special files are not supported');
+            }
+        }
+        catch (error) {
+            if (createParents && index === parts.length - 1 && error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+    }
+}
+export async function readSkillFiles(root, identity, files) {
+    const result = [];
+    let remaining = 64 * 1024 * 1024;
+    for (const file of files) {
+        await checkRoot(root, identity);
+        await checkPath(root, file.path);
+        const handle = await open(join(root, file.path), constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+        try {
+            const stat = await handle.stat({ bigint: true });
+            const pathStat = await lstat(join(root, file.path), { bigint: true });
+            const limit = Math.min(file.maxBytes, remaining);
+            if (!stat.isFile() || pathStat.isSymbolicLink() || stat.ino !== pathStat.ino || stat.dev !== pathStat.dev || stat.size > BigInt(limit))
+                throw new Error('Project Skills: file changed or exceeds size limit');
+            const buffer = Buffer.alloc(limit + 1);
+            let size = 0;
+            while (size < buffer.length) {
+                const { bytesRead } = await handle.read(buffer, size, buffer.length - size, size);
+                if (!bytesRead)
+                    break;
+                size += bytesRead;
+            }
+            if (size > limit)
+                throw new Error('Project Skills: file exceeds size limit');
+            remaining -= size;
+            result.push({ path: file.path, content: buffer.subarray(0, size), mode: Number(stat.mode & 511n) });
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    await checkRoot(root, identity);
+    return result;
+}
+export async function createSkillDirectories(root, identity, directories) {
+    for (const directory of directories) {
+        await checkRoot(root, identity);
+        // Validate and create components without a recursive mkdir following links.
+        await checkPath(root, `${directory}/.directory-check`, true);
+        await checkRoot(root, identity);
+    }
+}
+export async function createSkillFiles(root, identity, files) {
+    for (const file of files) {
+        await checkRoot(root, identity);
+        await checkPath(root, file.path, true);
+        const handle = await open(join(root, file.path), constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0), file.mode);
+        try {
+            await handle.writeFile(file.content);
+            if (process.platform !== 'win32')
+                await handle.chmod(file.mode);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        await checkRoot(root, identity);
+        await checkPath(root, file.path);
+    }
+}
+//# sourceMappingURL=project-skill-io.js.map

package/lib/adapters/project-skill-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-skill-io.js","sourceRoot":"","sources":["../../src/adapters/project-skill-io.ts"],"names":[],"mappings":"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"}

package/lib/adapters/project-skill-provider.d.ts

@@ -0,0 +1,25 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { SkillCandidate, SkillDefinition, SkillLookupOptions, SkillProvider, SkillProviderControl, SkillProviderObservation } from '@deepseek-ai/dsh-skill';
+import type { SessionCheckoutRegistryPort } from '../ports.js';
+/** Resolve against host-owned records, never a root claimed by a Skill file. */
+export declare function managedSkillRoot(registry: SessionCheckoutRegistryPort): (cwd: string) => Promise<string | null>;
+/** Additional project source only; native .dsh/.agents discovery remains unchanged. */
+export declare class ClaudeProjectSkillProvider implements SkillProvider {
+    private readonly ctx;
+    private readonly control;
+    private readonly resolveRoot;
+    readonly name = "worktree-project-claude";
+    private readonly providers;
+    private operations;
+    private disposed;
+    private run;
+    constructor(ctx: Context, control: SkillProviderControl, resolveRoot: (cwd: string) => Promise<string | null>);
+    private provider;
+    list(options: SkillLookupOptions): Promise<SkillCandidate[] | SkillProviderObservation>;
+    private listNow;
+    get(candidate: SkillCandidate, options: SkillLookupOptions): Promise<SkillDefinition | undefined>;
+    private getNow;
+    observeHostMutation(path: string): void;
+    dispose(): Promise<void>;
+}
+export declare function mountProjectSkillProvider(ctx: Context, registry: SessionCheckoutRegistryPort): void;

package/lib/adapters/project-skill-provider.js

@@ -0,0 +1,137 @@
+import { FileSystemSkillProvider } from '@deepseek-ai/dsh-skill-filesystem';
+import { lstat, readFile, realpath } from 'node:fs/promises';
+import { isAbsolute, join, relative, resolve } from 'node:path';
+import { assertSkillPath, assertSkillTree } from './project-skills.js';
+const NAME = 'worktree-project-claude';
+/** Resolve against host-owned records, never a root claimed by a Skill file. */
+export function managedSkillRoot(registry) {
+    return async (cwd) => {
+        const canonical = await realpath(cwd);
+        for (const record of Object.values(registry.read().managedCheckouts)) {
+            if (record.phase !== 'ready')
+                continue;
+            const root = record.managedGitRoot;
+            const child = relative(root, canonical);
+            if (child.startsWith('..') || isAbsolute(child))
+                continue;
+            const marker = join(root, '.git');
+            const rootStat = await lstat(root);
+            if (!rootStat.isDirectory() || rootStat.isSymbolicLink() || relative(root, await realpath(root)) !== '')
+                return null;
+            const stat = await lstat(marker);
+            if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 65536)
+                return null;
+            const text = (await readFile(marker, 'utf8')).trim();
+            if (!text.startsWith('gitdir: ') || await realpath(resolve(root, text.slice(8))) !== await realpath(record.gitDir))
+                return null;
+            const backlink = join(record.gitDir, 'gitdir');
+            const backlinkStat = await lstat(backlink);
+            if (!backlinkStat.isFile() || backlinkStat.isSymbolicLink() || backlinkStat.size > 65536)
+                return null;
+            if (resolve(record.gitDir, (await readFile(backlink, 'utf8')).trim()) !== resolve(marker))
+                return null;
+            return root;
+        }
+        return null;
+    };
+}
+/** Additional project source only; native .dsh/.agents discovery remains unchanged. */
+export class ClaudeProjectSkillProvider {
+    ctx;
+    control;
+    resolveRoot;
+    name = NAME;
+    providers = new Map();
+    operations = Promise.resolve();
+    disposed = false;
+    run(operation) {
+        const result = this.operations.then(operation);
+        this.operations = result.then(() => { }, () => { });
+        return result;
+    }
+    constructor(ctx, control, resolveRoot) {
+        this.ctx = ctx;
+        this.control = control;
+        this.resolveRoot = resolveRoot;
+    }
+    async provider(root) {
+        const existing = this.providers.get(root);
+        if (existing)
+            return existing;
+        if (this.providers.size >= 32) {
+            const oldest = this.providers.entries().next().value;
+            this.providers.delete(oldest[0]);
+            await oldest[1].dispose();
+        }
+        const provider = new FileSystemSkillProvider(this.ctx, this.control, {
+            providerName: NAME, includeDefaultRoots: false, customSkillDirs: [join(root, '.claude', 'skills')],
+            watch: true, watchFollowSymlinks: false,
+        });
+        this.providers.set(root, provider);
+        return provider;
+    }
+    list(options) {
+        return this.run(() => this.listNow(options));
+    }
+    async listNow(options) {
+        if (this.disposed || !options.cwd || this.control.signal.aborted || options.signal?.aborted)
+            return [];
+        const root = await this.resolveRoot(options.cwd);
+        if (!root)
+            return [];
+        await assertSkillTree(root, '.claude/skills');
+        const observation = await (await this.provider(root)).list(options);
+        const candidates = Array.isArray(observation) ? observation : observation.candidates;
+        const result = [];
+        for (const candidate of candidates) {
+            if (!candidate.path)
+                continue;
+            const path = relative(root, candidate.path).split('\\').join('/');
+            await assertSkillPath(root, path);
+            result.push({ ...candidate, provider: NAME, source: 'project-claude', rank: 250, locator: { root, candidate } });
+        }
+        return Array.isArray(observation) ? result : { ...observation, candidates: result };
+    }
+    get(candidate, options) {
+        return this.run(() => this.getNow(candidate, options));
+    }
+    async getNow(candidate, options) {
+        if (this.disposed || !options.cwd || this.control.signal.aborted || options.signal?.aborted)
+            return undefined;
+        const root = await this.resolveRoot(options.cwd);
+        const locator = candidate.locator;
+        if (!root || locator?.root !== root || !locator.candidate?.path)
+            return undefined;
+        await assertSkillTree(root, '.claude/skills');
+        await assertSkillPath(root, relative(root, locator.candidate.path).split('\\').join('/'));
+        const skill = await (await this.provider(root)).get(locator.candidate, options);
+        return skill ? { ...skill, provider: NAME, source: 'project-claude' } : undefined;
+    }
+    observeHostMutation(path) {
+        if (!this.disposed)
+            for (const provider of this.providers.values())
+                provider.observeHostMutation(path);
+    }
+    async dispose() {
+        this.disposed = true;
+        await this.operations;
+        const providers = [...this.providers.values()];
+        this.providers.clear();
+        await Promise.all(providers.map(provider => provider.dispose()));
+    }
+}
+export function mountProjectSkillProvider(ctx, registry) {
+    ctx.inject(['skills'], scoped => {
+        let provider;
+        scoped.skills.registerProvider(control => {
+            provider = new ClaudeProjectSkillProvider(scoped, control, managedSkillRoot(registry));
+            return provider;
+        });
+        scoped.on('fs/observed', (target, _observation, actor) => {
+            if (actor)
+                provider.observeHostMutation(target.displayPath);
+        });
+        scoped.effect(function* () { yield () => provider.dispose(); }, 'worktree project Skill compatibility');
+    });
+}
+//# sourceMappingURL=project-skill-provider.js.map

package/lib/adapters/project-skill-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-skill-provider.js","sourceRoot":"","sources":["../../src/adapters/project-skill-provider.ts"],"names":[],"mappings":"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"}

package/lib/adapters/project-skills.d.ts

@@ -0,0 +1,40 @@
+export declare const PROJECT_SKILL_ROOTS: readonly [".dsh/skills", ".agents/skills", ".claude/skills"];
+interface Entry {
+    path: string;
+    hash: string;
+    mode: number;
+}
+export interface SkillSnapshot {
+    directories?: string[];
+    files: Array<Entry & {
+        content: Buffer;
+    }>;
+}
+export interface CarriedSkillState {
+    paths: string[];
+    fingerprint: string;
+    modified: boolean;
+}
+export declare function assertSkillTree(root: string, skillRoot: typeof PROJECT_SKILL_ROOTS[number]): Promise<void>;
+/** Host-private provenance: never accept an exclusion list from the managed checkout. */
+export declare class ProjectSkillStore {
+    private readonly directory;
+    constructor(directory: string);
+    private file;
+    snapshot(source: string): Promise<SkillSnapshot>;
+    private load;
+    carry(snapshot: SkillSnapshot, target: string): Promise<void>;
+    scope(root: string): Promise<{
+        paths: string[];
+        directories: string[];
+    } | null>;
+    paths(root: string): Promise<string[] | null>;
+    state(root: string, tracked?: ReadonlySet<string>): Promise<CarriedSkillState | null>;
+    assertRemovable(root: string, tracked: ReadonlySet<string>): Promise<void>;
+    forget(root: string): Promise<void>;
+}
+export declare function trackedSkillPaths(indexEntries: Buffer | string, headPaths?: Buffer | string): Set<string>;
+/** Only ?? records are auxiliary; tracked edits, renames and deletions stay visible. */
+export declare function hasDeliverableStatus(output: string, auxiliary: ReadonlySet<string>, directories?: readonly string[]): boolean;
+export declare function assertSkillPath(root: string, path: string): Promise<void>;
+export {};