@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/adapters/fs/directory-replacement.js

@@ -0,0 +1,80 @@
+// Directory replacement records its private staging paths before moving the
+// live directory. Recovery keeps the installed tree, or restores the previous
+// tree when interruption happened between the two renames.
+import { randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+export async function replaceDirectory(source, target) {
+    const journal = `${target}.fx-transaction`;
+    await recover(target, journal);
+    await fs.mkdir(path.dirname(target), { recursive: true });
+    const token = randomUUID();
+    const tx = {
+        target,
+        staged: `${target}.fx-next-${token}`,
+        backup: `${target}.fx-old-${token}`,
+    };
+    await fs.writeFile(journal, JSON.stringify(tx), { flag: 'wx', mode: 0o600 });
+    try {
+        await fs.cp(source, tx.staged, { recursive: true, errorOnExist: true, force: false });
+        if (await exists(target))
+            await fs.rename(target, tx.backup);
+        await fs.rename(tx.staged, target);
+        await fs.rm(tx.backup, { recursive: true, force: true });
+        await fs.unlink(journal);
+    }
+    catch (err) {
+        await recover(target, journal);
+        throw err;
+    }
+}
+async function recover(target, journal) {
+    let raw;
+    try {
+        raw = await fs.readFile(journal, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    let tx;
+    try {
+        tx = JSON.parse(raw);
+    }
+    catch {
+        throw conflict();
+    }
+    if (tx?.target !== target ||
+        typeof tx.staged !== 'string' ||
+        typeof tx.backup !== 'string' ||
+        !tx.staged.startsWith(`${target}.fx-next-`) ||
+        !tx.backup.startsWith(`${target}.fx-old-`) ||
+        path.dirname(tx.staged) !== path.dirname(target) ||
+        path.dirname(tx.backup) !== path.dirname(target))
+        throw conflict();
+    if (!(await exists(target)) && (await exists(tx.backup)))
+        await fs.rename(tx.backup, target);
+    await fs.rm(tx.staged, { recursive: true, force: true });
+    await fs.rm(tx.backup, { recursive: true, force: true });
+    await fs.unlink(journal);
+}
+async function exists(file) {
+    try {
+        await fs.lstat(file);
+        return true;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return false;
+        throw err;
+    }
+}
+function conflict() {
+    return new DevkitError('conflict', 'PROJECTION_RECOVERY_REQUIRED', 'A directory projection has an unrecognized recovery record', {
+        hint: 'Inspect the transaction and preserve both directories before retrying.',
+        nextSteps: ['fx doctor'],
+    });
+}
+//# sourceMappingURL=directory-replacement.js.map

package/dist/adapters/fs/directory-replacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-replacement.js","sourceRoot":"","sources":["../../../src/adapters/fs/directory-replacement.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,2DAA2D;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAQrD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,MAAc;IACnE,MAAM,OAAO,GAAG,GAAG,MAAM,iBAAiB,CAAC;IAC3C,MAAM,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAgB;QACtB,MAAM;QACN,MAAM,EAAE,GAAG,MAAM,YAAY,KAAK,EAAE;QACpC,MAAM,EAAE,GAAG,MAAM,WAAW,KAAK,EAAE;KACpC,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACtF,IAAI,MAAM,MAAM,CAAC,MAAM,CAAC;YAAE,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,OAAe;IACpD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QAC7D,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,EAAe,CAAC;IACpB,IAAI,CAAC;QACH,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;IACD,IACE,EAAE,EAAE,MAAM,KAAK,MAAM;QACrB,OAAO,EAAE,CAAC,MAAM,KAAK,QAAQ;QAC7B,OAAO,EAAE,CAAC,MAAM,KAAK,QAAQ;QAC7B,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,WAAW,CAAC;QAC3C,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,UAAU,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAEhD,MAAM,QAAQ,EAAE,CAAC;IACnB,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7F,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACnE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,IAAI,WAAW,CACpB,UAAU,EACV,8BAA8B,EAC9B,4DAA4D,EAC5D;QACE,IAAI,EAAE,wEAAwE;QAC9E,SAAS,EAAE,CAAC,WAAW,CAAC;KACzB,CACF,CAAC;AACJ,CAAC"}

package/dist/adapters/fs/node-fs.js

@@ -0,0 +1,223 @@
+// node:fs behind the FileSystem port, keeping the port's promise that absence
+// is a value: a missing file reads as undefined, a missing directory as empty,
+// a path that is no link as no link. Every write makes its parent directory
+// first. Anything else propagates.
+import { randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { asDevkitError, busyError, DevkitError } from '../../domain/errors.js';
+import { pathKey } from '../../domain/path.js';
+import { replaceDirectory } from './directory-replacement.js';
+export class NodeFs {
+    lock;
+    async ensureDir(directory) {
+        await fs.mkdir(directory, { recursive: true });
+    }
+    constructor(lock) {
+        this.lock = lock;
+    }
+    async readBytes(file) {
+        try {
+            return await fs.readFile(file);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return undefined;
+            throw err;
+        }
+    }
+    async writeBytes(file, bytes, executable = false) {
+        await fs.mkdir(path.dirname(file), { recursive: true });
+        await fs.writeFile(file, bytes, { mode: executable ? 0o755 : 0o644 });
+    }
+    async readText(file) {
+        try {
+            return await fs.readFile(file, 'utf8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return undefined;
+            throw err;
+        }
+    }
+    async writeText(file, text) {
+        const lease = await this.lock?.acquire({
+            key: `projection:${pathKey(file)}`,
+            waitMs: 2000,
+        });
+        if (lease === null)
+            throw busyError('LOCK_BUSY', 'The projection');
+        const temporary = `${file}.${randomUUID()}.tmp`;
+        try {
+            await fs.mkdir(path.dirname(file), { recursive: true });
+            const current = await fs.lstat(file).catch((err) => {
+                if (err.code === 'ENOENT')
+                    return undefined;
+                throw err;
+            });
+            if (current && !current.isFile())
+                throw new DevkitError('conflict', 'PROJECTION_FOREIGN', 'The projection is not a regular file', { nextSteps: [`Remove or rename ${file}, then re-run the same command.`] });
+            await fs.writeFile(temporary, text, {
+                flag: 'wx',
+                mode: current === undefined ? 0o600 : current.mode & 0o777,
+            });
+            await fs.rename(temporary, file);
+        }
+        finally {
+            await fs.rm(temporary, { force: true });
+            await lease?.release();
+        }
+    }
+    async replaceDir(from, to) {
+        if (!this.lock)
+            throw new DevkitError('internal', 'LOCK_UNAVAILABLE', 'Directory replacement requires a lock');
+        const lease = await this.lock.acquire({ key: `projection:${pathKey(to)}`, waitMs: 2000 });
+        if (!lease)
+            throw busyError('LOCK_BUSY', 'The Skill projection');
+        try {
+            const current = await fs.lstat(to).catch((err) => {
+                if (err.code === 'ENOENT')
+                    return undefined;
+                throw err;
+            });
+            if (current && !current.isDirectory())
+                throw new DevkitError('conflict', 'PROJECTION_FOREIGN', 'The projection is not a directory', { nextSteps: [`Remove or rename ${to}, then re-run the same command.`] });
+            await replaceDirectory(from, to);
+        }
+        catch (err) {
+            throw asDevkitError(err);
+        }
+        finally {
+            await lease.release();
+        }
+    }
+    async moveToBackup(target) {
+        if (!this.lock)
+            throw new DevkitError('internal', 'LOCK_UNAVAILABLE', 'Path replacement requires a lock');
+        const requested = path.resolve(target);
+        const parent = await fs.realpath(path.dirname(requested));
+        const file = path.join(parent, path.basename(requested));
+        const lease = await this.lock.acquire({ key: `projection:${pathKey(file)}`, waitMs: 2000 });
+        if (!lease)
+            throw busyError('LOCK_BUSY', 'The replacement');
+        try {
+            await assertBackupParent(requested, parent);
+            const current = await fs.lstat(file);
+            if (!current.isFile() && !current.isDirectory() && !current.isSymbolicLink())
+                throw new DevkitError('conflict', 'PROJECTION_FOREIGN', 'The path cannot be backed up', {
+                    nextSteps: [`Inspect ${file} and move it aside before retrying.`],
+                });
+            for (let suffix = 0;; suffix += 1) {
+                const backup = `${file}.fx-backup${suffix === 0 ? '' : `-${suffix}`}`;
+                const backupLease = await this.lock.acquire({
+                    key: `projection:${pathKey(backup)}`,
+                    waitMs: 0,
+                });
+                if (!backupLease)
+                    throw busyError('LOCK_BUSY', 'The backup');
+                try {
+                    if (await fs.lstat(backup).then(() => true, missingPath))
+                        continue;
+                    await assertBackupParent(requested, parent);
+                    // The move preserves saves through an open file handle; a later editor
+                    // replacement at the original path is left for the caller to recheck.
+                    await fs.rename(file, backup);
+                    return backup;
+                }
+                finally {
+                    await backupLease.release();
+                }
+            }
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                throw new DevkitError('conflict', 'PROJECTION_CHANGED', 'The replacement path changed', {
+                    nextSteps: [`Inspect ${file} and retry from its current state.`],
+                    cause: err,
+                });
+            throw asDevkitError(err);
+        }
+        finally {
+            await lease.release();
+        }
+    }
+    async exists(file) {
+        try {
+            await fs.access(file);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async readDir(dir) {
+        try {
+            return await fs.readdir(dir);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return [];
+            throw err;
+        }
+    }
+    async isDirectory(dir) {
+        try {
+            return (await fs.stat(dir)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    async readLink(file) {
+        try {
+            return await fs.readlink(file);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async link(target, at) {
+        await fs.mkdir(path.dirname(at), { recursive: true });
+        await fs.symlink(path.resolve(target), at, process.platform === 'win32' ? 'junction' : 'dir');
+    }
+    async copyDir(from, to) {
+        await fs.mkdir(path.dirname(to), { recursive: true });
+        await fs.cp(from, to, { recursive: true });
+    }
+    async remove(file) {
+        const stat = await fs.lstat(file).catch((err) => {
+            if (err.code !== 'ENOENT')
+                throw err;
+            return undefined;
+        });
+        if (stat?.isSymbolicLink()) {
+            await fs.unlink(file);
+            return;
+        }
+        await fs.rm(file, { recursive: true, force: true });
+    }
+    async realpath(target) {
+        try {
+            return await fs.realpath(target);
+        }
+        catch {
+            const absolute = path.resolve(target);
+            const parent = path.dirname(absolute);
+            return parent === absolute
+                ? absolute
+                : path.join(await this.realpath(parent), path.basename(absolute));
+        }
+    }
+}
+function missingPath(error) {
+    if (error.code === 'ENOENT')
+        return false;
+    throw error;
+}
+async function assertBackupParent(file, parent) {
+    if ((await fs.realpath(path.dirname(file))) !== parent)
+        throw new DevkitError('conflict', 'PROJECTION_CHANGED', 'The replacement directory changed', {
+            nextSteps: [`Inspect the directory containing ${file}, then retry.`],
+        });
+}
+//# sourceMappingURL=node-fs.js.map

package/dist/adapters/fs/node-fs.js.map

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

package/dist/adapters/fs/snapshot-reader.js

@@ -0,0 +1,40 @@
+// An in-memory filesystem view isolates candidate validation from the source's
+// live files and index. Constructor capture prevents later caller mutation.
+import path from 'node:path';
+export class SnapshotReader {
+    files;
+    constructor(input) {
+        this.files = new Map(Object.entries(input.files).map(([file, content]) => [
+            path.resolve(input.root, file),
+            content,
+        ]));
+    }
+    async readText(file) {
+        return this.files.get(path.resolve(file));
+    }
+    async readBytes(file) {
+        const text = await this.readText(file);
+        return text === undefined ? undefined : new TextEncoder().encode(text);
+    }
+    async exists(file) {
+        return this.files.has(path.resolve(file)) || (await this.isDirectory(file));
+    }
+    async readDir(dir) {
+        const prefix = `${path.resolve(dir)}${path.sep}`;
+        return [
+            ...new Set([...this.files.keys()]
+                .filter((file) => file.startsWith(prefix))
+                .map((file) => file.slice(prefix.length).split(path.sep)[0])),
+        ].sort();
+    }
+    async isDirectory(dir) {
+        return (await this.readDir(dir)).length > 0;
+    }
+    async readLink(_file) {
+        return undefined;
+    }
+    async realpath(file) {
+        return path.resolve(file);
+    }
+}
+//# sourceMappingURL=snapshot-reader.js.map

package/dist/adapters/fs/snapshot-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-reader.js","sourceRoot":"","sources":["../../../src/adapters/fs/snapshot-reader.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAE5E,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B,MAAM,OAAO,cAAc;IACR,KAAK,CAA8B;IAEpD,YAAY,KAAoB;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAClB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;YAC9B,OAAO;SACR,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW;QACvB,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjD,OAAO;YACL,GAAG,IAAI,GAAG,CACR,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;iBACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;iBACzC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAChE;SACF,CAAC,IAAI,EAAE,CAAC;IACX,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAa;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/adapters/git/contribution-capture.js

@@ -0,0 +1,148 @@
+// Captures selected working bytes against an explicit base. Unsupported paths
+// cannot redirect reads outside the source; text must decode without replacement.
+import { createHash } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { selectContributionFiles } from '../../domain/contribution/selection.js';
+import { DevkitError } from '../../domain/errors.js';
+import { runContributionGit } from './contribution-command.js';
+import { computeContributionTree, parseContributionTree, } from './contribution-tree.js';
+export async function captureContribution(process, input) {
+    const dir = await fs.realpath(input.dir);
+    const git = (args) => runContributionGit({ process, dir, args });
+    const root = (await git(['rev-parse', '--show-toplevel'])).trim();
+    if ((await fs.realpath(root)) !== dir)
+        throw new DevkitError('usage', 'SOURCE_ROOT_REQUIRED', 'Use the registered source root', {
+            nextSteps: [
+                'fx workspace show',
+                `Register the source at the repository root ${root}, or move the checkout out of the enclosing repository.`,
+            ],
+        });
+    const base = (await git(['rev-parse', '--verify', '--end-of-options', `${input.base}^{commit}`])).trim();
+    const head = (await git(['rev-parse', '--verify', 'HEAD'])).trim();
+    const changed = parseChanges(await git(['diff', '--no-ext-diff', '--no-textconv', '--name-status', '-z', '-M', base, '--']));
+    const untracked = (await git(['ls-files', '--others', '--exclude-standard', '-z']))
+        .split('\0')
+        .filter(Boolean);
+    for (const file of untracked)
+        changed.push({ path: file, mode: '100644', kind: 'file', content: '' });
+    const selected = selectContributionFiles({ paths: input.paths, changes: changed });
+    const modes = await indexModes(git);
+    const files = [];
+    for (const file of selected)
+        files.push(await captureFile(dir, file, modes));
+    const entries = parseContributionTree(await git(['ls-tree', '-r', '-z', base]));
+    const baseFiles = await readBase(git, entries);
+    const tree = computeContributionTree({ entries, files, objectLength: base.length });
+    return {
+        dir,
+        base,
+        head,
+        paths: [...input.paths],
+        files,
+        baseFiles,
+        fingerprint: fingerprint({ base, head, files }),
+        tree,
+    };
+}
+function parseChanges(text) {
+    const fields = text.split('\0');
+    const files = [];
+    for (let i = 0; i < fields.length - 1;) {
+        const status = fields[i++];
+        const first = fields[i++];
+        if (status.startsWith('R')) {
+            const second = fields[i++];
+            files.push({
+                path: first,
+                kind: 'deleted',
+                mode: '100644',
+                content: null,
+                renamePeer: second,
+            });
+            files.push({ path: second, kind: 'file', mode: '100644', content: '', renamePeer: first });
+        }
+        else
+            files.push({
+                path: first,
+                kind: status === 'D' ? 'deleted' : 'file',
+                mode: '100644',
+                content: status === 'D' ? null : '',
+            });
+    }
+    return files;
+}
+async function captureFile(root, file, modes) {
+    if (file.kind === 'deleted')
+        return file;
+    const target = path.join(root, file.path);
+    await assertAncestors(root, file.path);
+    const info = await fs.lstat(target);
+    const actual = await fs.realpath(target);
+    const relative = path.relative(root, actual);
+    if (!info.isFile() || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative))
+        throw new DevkitError('usage', 'SOURCE_ENTRY_UNSUPPORTED', 'Selected entries must be regular source files', {
+            nextSteps: [
+                `ls -l ${target}`,
+                `Remove ${file.path} from the selection; only regular files can be contributed.`,
+            ],
+        });
+    const bytes = await fs.readFile(target);
+    let content;
+    try {
+        content = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(bytes);
+    }
+    catch {
+        throw new DevkitError('usage', 'SOURCE_ENTRY_UNSUPPORTED', 'Selected files must be UTF-8 text', { nextSteps: [`Re-encode ${file.path} as UTF-8, or remove it from the selection.`] });
+    }
+    if (content.includes('\0'))
+        throw new DevkitError('usage', 'SOURCE_ENTRY_UNSUPPORTED', 'Binary contributions require manual review', {
+            nextSteps: [
+                `Remove ${file.path} from the selection and deliver binary content through the code host.`,
+            ],
+        });
+    const executable = process.platform === 'win32' ? modes.get(file.path) === '100755' : (info.mode & 0o111) !== 0;
+    return { ...file, mode: executable ? '100755' : '100644', content };
+}
+async function indexModes(git) {
+    const entries = parseContributionTree(await git(['ls-tree', '-r', '-z', 'HEAD']));
+    const modes = new Map(entries.map((entry) => [entry.path, entry.mode]));
+    for (const entry of (await git(['ls-files', '--stage', '-z'])).split('\0')) {
+        const match = /^(\d+) [a-f0-9]+ 0\t([\s\S]+)$/.exec(entry);
+        if (match)
+            modes.set(match[2], match[1]);
+    }
+    return modes;
+}
+async function readBase(git, entries) {
+    const files = Object.create(null);
+    for (const { path: file, mode, oid } of entries) {
+        if (mode !== '100644' && mode !== '100755')
+            continue;
+        const text = await git(['cat-file', 'blob', oid]);
+        // Opaque blobs remain present so a malformed optional document cannot disappear.
+        files[file] = text.includes('\0') || text.includes('\ufffd') ? '\0' : text;
+    }
+    return files;
+}
+function fingerprint(input) {
+    return createHash('sha256').update(JSON.stringify(input)).digest('hex');
+}
+async function assertAncestors(root, file) {
+    let current = root;
+    for (const segment of file.split('/').slice(0, -1)) {
+        current = path.join(current, segment);
+        if (!(await fs.lstat(current)).isDirectory())
+            throw new DevkitError('usage', 'SOURCE_ENTRY_UNSUPPORTED', 'Selected paths cannot traverse symbolic links', {
+                nextSteps: [
+                    `Select ${file} through its real directory instead of the symbolic link at ${current}.`,
+                ],
+            });
+    }
+}
+export async function readContributionBase(input) {
+    const git = (args) => runContributionGit({ ...input, args });
+    const entries = parseContributionTree(await git(['ls-tree', '-r', '-z', input.ref]));
+    return readBase(git, entries);
+}
+//# sourceMappingURL=contribution-capture.js.map

package/dist/adapters/git/contribution-capture.js.map

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

package/dist/adapters/git/contribution-command.js

@@ -0,0 +1,44 @@
+// Local contribution plumbing suppresses external diff helpers and optional
+// index writes. Failures report an operation code without echoing Git output.
+import { DevkitError } from '../../domain/errors.js';
+export async function runContributionGit(input) {
+    const env = Object.fromEntries(Object.keys(process.env)
+        .filter((key) => key.startsWith('GIT_'))
+        .map((key) => [key, undefined]));
+    const result = await input.process.run([
+        'git',
+        '--no-optional-locks',
+        '-c',
+        'core.fsmonitor=false',
+        '-c',
+        'core.splitIndex=false',
+        '-C',
+        input.dir,
+        ...input.args,
+    ], {
+        env: {
+            ...env,
+            GIT_OPTIONAL_LOCKS: '0',
+            GIT_INDEX_FILE: input.index,
+            GIT_TERMINAL_PROMPT: '0',
+        },
+        timeoutMs: 15000,
+        ...(input.input === undefined ? {} : { input: input.input }),
+    });
+    if (result.code === 1 && input.allowAbsent)
+        return '';
+    if (result.code !== 0) {
+        const rejected = input.network && /non-fast-forward|fetch first/.test(result.stdout + result.stderr);
+        const category = input.network && !rejected ? 'network' : 'conflict';
+        throw new DevkitError(category, rejected ? 'SOURCE_PUSH_REJECTED' : 'SOURCE_GIT_FAILED', 'Contribution Git operation failed', {
+            hint: 'Inspect the source checkout and its Git configuration; no checkout or reset was attempted.',
+            nextSteps: ['fx source push --help', 'Inspect the source Git status and retry.'],
+        });
+    }
+    return result.stdout;
+}
+export function assertObjectId(value) {
+    if (!/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/.test(value))
+        throw new DevkitError('conflict', 'SOURCE_OBJECT_INVALID', 'Expected a complete Git object identity', { nextSteps: ['Check the source repository with git fsck, then re-run fx source push.'] });
+}
+//# sourceMappingURL=contribution-command.js.map

package/dist/adapters/git/contribution-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-command.js","sourceRoot":"","sources":["../../../src/adapters/git/contribution-command.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAarD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAA0B;IACjE,MAAM,GAAG,GAAsB,MAAM,CAAC,WAAW,CAC/C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;SACrB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAClC,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CACpC;QACE,KAAK;QACL,qBAAqB;QACrB,IAAI;QACJ,sBAAsB;QACtB,IAAI;QACJ,uBAAuB;QACvB,IAAI;QACJ,KAAK,CAAC,GAAG;QACT,GAAG,KAAK,CAAC,IAAI;KACd,EACD;QACE,GAAG,EAAE;YACH,GAAG,GAAG;YACN,kBAAkB,EAAE,GAAG;YACvB,cAAc,EAAE,KAAK,CAAC,KAAK;YAC3B,mBAAmB,EAAE,GAAG;SACzB;QACD,SAAS,EAAE,KAAK;QAChB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KAC7D,CACF,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IACtD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,QAAQ,GACZ,KAAK,CAAC,OAAO,IAAI,8BAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACtF,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QACrE,MAAM,IAAI,WAAW,CACnB,QAAQ,EACR,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,mBAAmB,EACvD,mCAAmC,EACnC;YACE,IAAI,EAAE,4FAA4F;YAClG,SAAS,EAAE,CAAC,uBAAuB,EAAE,0CAA0C,CAAC;SACjF,CACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,iCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC;QAChD,MAAM,IAAI,WAAW,CACnB,UAAU,EACV,uBAAuB,EACvB,yCAAyC,EACzC,EAAE,SAAS,EAAE,CAAC,wEAAwE,CAAC,EAAE,CAC1F,CAAC;AACN,CAAC"}