@nimbus-sh/worker 0.9.0 → 0.11.0

package/dist/git/network-facet.d.ts

@@ -1,5 +1,5 @@
 /**
- * git-network-facet.ts — Facet-based git clone/fetch/pull.
+ * git/network-facet.ts — Facet-based git clone/fetch/pull.
  *
  * Runs isomorphic-git's network operations (clone/fetch/pull) inside a
  * dynamic worker (LOADER.load) to escape the supervisor DO's CPU budget
@@ -33,6 +33,8 @@ export interface GitNetworkOpts {
     dir: string;
     /** For clone: repository URL */
     url?: string;
+    /** `git clone -q`: no progress on the terminal; the result is unchanged. */
+    quiet?: boolean;
     /** For fetch/pull: remote name (default "origin") */
     remote?: string;
     /** For clone: branch to clone (default remote HEAD); for pull: branch name (default current) */
@@ -44,10 +46,18 @@ export interface GitNetworkOpts {
         username: string;
         password: string;
     };
-    /** Author (for pull merges) */
+    /** Author and committer (for pull merges), as the supervisor's git resolved them. */
     author?: {
         name: string;
         email: string;
+        timestamp?: number;
+        timezoneOffset?: number;
+    };
+    committer?: {
+        name: string;
+        email: string;
+        timestamp?: number;
+        timezoneOffset?: number;
     };
     /** Total operation budget (ms). Clone default 30 min; other ops default 5 min. */
     timeout?: number;

package/dist/git/network-facet.d.ts.map

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

package/dist/git/network-facet.js

@@ -1,5 +1,5 @@
 /**
- * git-network-facet.ts — Facet-based git clone/fetch/pull.
+ * git/network-facet.ts — Facet-based git clone/fetch/pull.
  *
  * Runs isomorphic-git's network operations (clone/fetch/pull) inside a
  * dynamic worker (LOADER.load) to escape the supervisor DO's CPU budget
@@ -25,9 +25,10 @@
  * in the PR that introduced this file.
  */
 import { getCtxExports } from '@nimbus-sh/fabric/composition.js';
+import { supervisorBindingProps } from '@nimbus-sh/fabric/supervisor-props.js';
 import { CF_COMPAT_DATE } from '@nimbus-sh/core/constants.js';
 import { MAX_RPC_SAFE_PAYLOAD_BYTES } from '@nimbus-sh/platform/limits.js';
-import { GIT_BUNDLE_CODE } from '../git-bundle.generated.js';
+import { fetchGitBundleSource } from '../runtime/git-bundle-artifact.js';
 import { W7_FRAME_PREAMBLE } from '../loaders/generated-workers.js';
 import { ESBUILD_NAME_GLOBAL_SHIM } from '@nimbus-sh/core/_shared/esbuild-facet-shim.js';
 import { disposeRpcResource } from '@nimbus-sh/platform/rpc-dispose.js';
@@ -407,7 +408,7 @@ export async function execGitNetwork(ctx, env, opts) {
         const ctxExports = getCtxExports();
         const supervisorBinding = ctxExports?.SupervisorRPC
             ? ctxExports.SupervisorRPC({
-                props: { doId: ctx.id.toString(), pid: opts.pid, mutationOwner },
+                props: { ...supervisorBindingProps(ctx, opts.pid), mutationOwner },
             })
             : undefined;
         if (!supervisorBinding) {
@@ -424,6 +425,7 @@ export async function execGitNetwork(ctx, env, opts) {
         let worker;
         let entrypoint;
         try {
+            const gitBundleSource = await fetchGitBundleSource(env);
             const loadedWorker = env.LOADER.load({
                 compatibilityDate: CF_COMPAT_DATE,
                 compatibilityFlags: ['nodejs_compat'],
@@ -436,10 +438,11 @@ export async function execGitNetwork(ctx, env, opts) {
                 //     `preamble` option provides for npm install. This is the
                 //     W7 v3 emits one bounded record per pull; the receiver owns
                 //     the aggregate 8 MiB payload-credit and transaction limits.
-                //   - the pre-bundled isomorphic-git (git-bundle.js)
+                //   - the pre-bundled isomorphic-git (git-bundle.js), the staged
+                //     copy of vendor/git.generated.mjs (runtime/git-bundle-artifact.ts)
                 modules: {
                     'git-network-worker.js': assembleGitNetworkFacetSource(),
-                    'git-bundle.js': GIT_BUNDLE_CODE,
+                    'git-bundle.js': gitBundleSource,
                 },
                 env: { SUPERVISOR: supervisorBinding },
             });
@@ -482,7 +485,8 @@ export async function execGitNetwork(ctx, env, opts) {
                             ? prepare.result.error
                             : 'clone-prepare returned an invalid result', prepare.diagnostic);
                     }
-                    await writeClonePhaseProgress(supervisorBinding, prepare.diagnostic);
+                    if (!opts.quiet)
+                        await writeClonePhaseProgress(supervisorBinding, prepare.diagnostic);
                     let checkoutCursor = null;
                     let checkoutChunk = 0;
                     do {
@@ -513,7 +517,9 @@ export async function execGitNetwork(ctx, env, opts) {
                         budgetContext.chunksCompleted++;
                         budgetContext.processedEntries += progress.treeEntriesVisited;
                         budgetContext.decodedBytes += progress.decodedBytes;
-                        await writeCloneChunkProgress(supervisorBinding, checkout.diagnostic, checkoutChunk, progress);
+                        if (!opts.quiet) {
+                            await writeCloneChunkProgress(supervisorBinding, checkout.diagnostic, checkoutChunk, progress);
+                        }
                     } while (checkoutCursor !== null);
                     return {
                         success: true,
@@ -550,7 +556,8 @@ export async function execGitNetwork(ctx, env, opts) {
                             const abort = await invokeFacet(entrypoint, 'clone-abort', crypto.randomUUID(), { ...facetOpts, jobId, optionsHash }, Date.now() + CLONE_ABORT_TIMEOUT_MS, CLONE_ABORT_TIMEOUT_MS);
                             phases.push(abort.diagnostic);
                             accountResult(abort.result);
-                            await writeClonePhaseProgress(supervisorBinding, abort.diagnostic);
+                            if (!opts.quiet)
+                                await writeClonePhaseProgress(supervisorBinding, abort.diagnostic);
                             if (abort.result.success !== true) {
                                 cleanupError = typeof abort.result.error === 'string'
                                     ? abort.result.error
@@ -1077,6 +1084,18 @@ function enotdir(filepath) {
   return err;
 }
 
+function eisdir(filepath) {
+  const err = new Error('EISDIR: illegal operation on a directory, ' + filepath);
+  err.code = 'EISDIR'; err.errno = -21;
+  return err;
+}
+
+function enotempty(filepath) {
+  const err = new Error('ENOTEMPTY: directory not empty, ' + filepath);
+  err.code = 'ENOTEMPTY'; err.errno = -39;
+  return err;
+}
+
 function einval(filepath) {
   const err = new Error('EINVAL: invalid argument, ' + filepath);
   err.code = 'EINVAL'; err.errno = -22;
@@ -1132,7 +1151,9 @@ function convertSupervisorStat(st) {
     mtimeMs, mtime: new Date(mtimeMs),
     ctimeMs, ctime: new Date(ctimeMs),
     atimeMs, atime: new Date(atimeMs),
-    uid: 1000, gid: 1000, dev: 0, ino: 0, nlink: 1,
+    // The supervisor's git reports these same fields, so an index either side wrote stays warm.
+    uid: Number(st.uid) || 0, gid: Number(st.gid) || 0,
+    dev: Number(st.dev) || 0, ino: Number(st.ino) || 0, nlink: 1,
   };
 }
 
@@ -1171,7 +1192,7 @@ function emptyMetadataOverlayStats() {
  * Files + all their parent directories become inodes; file content is
  * chunked at CHUNK_SIZE boundaries to match sqlite-vfs.
  */
-function buildPayload(writeBuffer, dirBuffer, deleteSet, metadata, authoritativeRoot) {
+function buildPayload(writeBuffer, dirBuffer, deleteSet, metadata, authoritativeRoot, worktreeRoot) {
   const inodes = [];
   const chunks = [];
   const dirs = new Set();
@@ -1179,12 +1200,12 @@ function buildPayload(writeBuffer, dirBuffer, deleteSet, metadata, authoritative
 
   // Collect all parent directories for files.
   for (const [path] of writeBuffer) {
-    collectDirectoryPaths(dirs, parentOf(path), authoritativeRoot);
+    collectDirectoryPaths(dirs, parentOf(path), authoritativeRoot, worktreeRoot);
   }
   // Explicit mkdir entries
   for (const d of dirBuffer) {
     if (!d) continue;
-    collectDirectoryPaths(dirs, d, authoritativeRoot);
+    collectDirectoryPaths(dirs, d, authoritativeRoot, worktreeRoot);
   }
 
   const orderedDirs = [...dirs].sort((left, right) => {
@@ -1259,12 +1280,19 @@ function buildPayload(writeBuffer, dirBuffer, deleteSet, metadata, authoritative
   return { inodes, chunks, deletePaths };
 }
 
-function collectDirectoryPaths(paths, path, authoritativeRoot) {
+// A clone publishes the directories it creates, up to and including its
+// authoritative root. An operation in an existing worktree (worktreeRoot)
+// publishes only directories below its top: the top and everything above it
+// already exist, are followed as git follows them, and are not the worktree's
+// to rewrite — republishing home is EACCES for the session user, and would
+// replace a linked ancestor with an empty directory.
+function collectDirectoryPaths(paths, path, authoritativeRoot, worktreeRoot = null) {
   let current = path;
   while (current) {
     if (authoritativeRoot &&
         current !== authoritativeRoot &&
         !current.startsWith(authoritativeRoot + '/')) break;
+    if (worktreeRoot !== null && !current.startsWith(worktreeRoot + '/')) break;
     paths.add(current);
     if (current === authoritativeRoot) break;
     current = parentOf(current);
@@ -1274,6 +1302,14 @@ function collectDirectoryPaths(paths, path, authoritativeRoot) {
 /**
  * Create the buffered fs adapter isomorphic-git will use.
  * Writes buffer in-memory; reads check buffer then fall back to supervisor.
+ *
+ * With a worktreeRoot (fetch, pull, push in an existing repository) the
+ * adapter writes that worktree the way git's checkout does (entry.c
+ * create_directories, has_symlink_leading_path): below its top, .git
+ * aside, a leading component that is not a real directory (a link, dangling
+ * or not, or a file) is deleted and replaced by a directory rather than
+ * followed, and a file replaces a link at its own path rather than writing
+ * through it.
  */
 function createBufferedFs(
   supervisor,
@@ -1285,6 +1321,7 @@ function createBufferedFs(
   phaseDeadline = null,
   authoritativeFallbackPaths = [],
   authoritativeFallbackRoots = [],
+  worktreeRoot = null,
 ) {
   const writeBuffer = new Map(); // path → Uint8Array (insertion ordered = FIFO)
   const pendingWriteMetadata = new Map();
@@ -1477,16 +1514,16 @@ function createBufferedFs(
     const paths = new Set(deleteBuffer);
     for (const path of dirBuffer) {
       if (!path) continue;
-      collectDirectoryPaths(paths, path, authoritativeRoot);
+      collectDirectoryPaths(paths, path, authoritativeRoot, worktreeRoot);
     }
     for (const path of writeBuffer.keys()) {
       paths.add(path);
-      collectDirectoryPaths(paths, parentOf(path), authoritativeRoot);
+      collectDirectoryPaths(paths, parentOf(path), authoritativeRoot, worktreeRoot);
     }
     if (extraPath) {
       paths.add(extraPath);
       if (includeParents) {
-        collectDirectoryPaths(paths, parentOf(extraPath), authoritativeRoot);
+        collectDirectoryPaths(paths, parentOf(extraPath), authoritativeRoot, worktreeRoot);
       }
     }
     let pathBytes = 0;
@@ -1574,6 +1611,7 @@ function createBufferedFs(
         deleteBuffer,
         waveMetadata,
         authoritativeRoot,
+        worktreeRoot,
       );
     // Snapshot stats counters BEFORE clearing the buffers so the increments
     // below see the wave's true size, not zero.
@@ -1857,9 +1895,14 @@ function createBufferedFs(
         });
       },
 
+      // unlink(2) and rmdir(2): a buffered delete removes the whole subtree at
+      // its path, so neither may take a directory it would not take on disk.
+      // unlink refuses a directory; rmdir refuses a non-directory and a
+      // directory that still holds anything (untracked files a checkout leaves).
       async unlink(filepath) {
         assertFlushHealthy();
         const p = normalizePath(filepath);
+        if ((await fs.promises.lstat(filepath)).isDirectory()) throw eisdir(filepath);
         return bufferMutation(p, 0, false, async () => {
           if (writeBuffer.has(p)) {
             bufferBytes -= writeBuffer.get(p).length;
@@ -1935,9 +1978,13 @@ function createBufferedFs(
         });
       },
 
-      async rmdir(filepath) {
+      async rmdir(filepath, options) {
         assertFlushHealthy();
         const p = normalizePath(filepath);
+        if (!(options && options.recursive)) {
+          if (!(await fs.promises.lstat(filepath)).isDirectory()) throw enotdir(filepath);
+          if ((await fs.promises.readdir(filepath)).length > 0) throw enotempty(filepath);
+        }
         return bufferMutation(p, 0, false, async () => {
           dirBuffer.delete(p);
           deleteBuffer.add(p);
@@ -2185,13 +2232,14 @@ export default {
       }
     }
     const log = (msg) => {
+      if (opts.quiet) return;
       stats.supervisorRpc.stdout++;
       try { useRpcResult(supervisor.stdout(new TextEncoder().encode(msg)), () => undefined).catch(() => {}); } catch {}
     };
 
     // Import the pre-bundled isomorphic-git + http/web.
     // The bundle is provided via LOADER.load()'s modules record;
-    // see scripts/bundle-git.mjs and src/git-bundle.generated.ts.
+    // see scripts/bundle-git.mjs and src/runtime/git-bundle-artifact.ts.
     let git, http;
     try {
       const bundle = await import('./git-bundle.js');
@@ -2375,6 +2423,8 @@ export default {
         phase === 'clone-checkout'
           ? [normalizePath(opts.dir) + '/.git/nimbus-checkout-index']
           : [],
+        // fetch, pull and push work in a repository that already exists.
+        phase === 'operation' ? normalizePath(opts.dir) : null,
       );
       const fs = bufferedFs.fs;
       flushWave = bufferedFs.flushWave;
@@ -2601,6 +2651,7 @@ export default {
           ref: opts.ref,
           singleBranch: true,
           author: opts.author || { name: 'user', email: 'user@nimbus.dev' },
+          committer: opts.committer,
           onProgress,
           onAuth,
         });

package/dist/git/unified-diff.d.ts

@@ -0,0 +1,74 @@
+export declare const DEFAULT_CONTEXT = 3;
+/** One side of a file pair: git's diff_filespec. */
+export interface DiffSpec {
+    /** Repo-relative path, or the path as given to --no-index ('/dev/null' for an absent side). */
+    path: string;
+    /** False on the absent side of an add or a delete. */
+    valid: boolean;
+    oid: string;
+    mode: number;
+    data: Uint8Array;
+}
+export interface DiffPair {
+    one: DiffSpec;
+    two: DiffSpec;
+    /** Set when rename detection paired `one` with `two`: similarity out of MAX_SCORE. */
+    renameScore?: number;
+}
+export declare function absentSpec(path: string): DiffSpec;
+/** diff_resolve_rename_copy's status letter. */
+export declare function pairStatus(pair: DiffPair): 'A' | 'D' | 'T' | 'R' | 'M';
+export declare function binaryFromBytes(bytes: Uint8Array): string;
+export declare function bytesFromBinary(text: string): Uint8Array;
+/** A path's UTF-8 bytes as a binary string. */
+export declare function binaryPath(path: string): string;
+/** A path as git prints it on a '\n'-ended line: C-quoted if any byte needs it. */
+export declare function quotePath(path: string): string;
+/** One entry of a path list: quoted and '\n'-ended, or raw and NUL-ended under -z. */
+export declare function pathLine(path: string, z: boolean): string;
+/** buffer_is_binary: a NUL in the first 8000 bytes. */
+export declare function isBinary(data: Uint8Array): boolean;
+/** One file's `diff --git` section, exactly as `git diff` prints it without color. */
+export declare function formatPatch(pair: DiffPair, context?: number): string;
+export declare function formatNameOnly(pair: DiffPair, z: boolean): string;
+export declare function formatNameStatus(pair: DiffPair, z: boolean): string;
+export interface StatFile {
+    /** Display name: quoted path, or `from => to` when the two sides are named differently. */
+    name: string;
+    added: number;
+    deleted: number;
+    binary: boolean;
+}
+export declare function statFile(pair: DiffPair): StatFile;
+/** The --stat block for `columns` terminal columns (git's term_columns: $COLUMNS, else 80). */
+export declare function formatStat(files: readonly StatFile[], columns: number): string;
+export declare const MAX_SCORE = 60000;
+export declare const DEFAULT_RENAME_SCORE = 30000;
+export declare function similarityIndex(score: number): number;
+/** parse_rename_score (`5`, `50%` and `.5` are all 50%), or null when anything follows the number. */
+export declare function parseRenameScore(text: string): number | null;
+export interface RenameSide {
+    path: string;
+    oid: string;
+    mode: number;
+}
+export interface QueuedPair<S extends RenameSide> {
+    one: S | null;
+    two: S | null;
+    renameScore?: number;
+}
+/**
+ * git diff's default rename detection over a path-ordered queue: exact
+ * renames, then unique basenames at a higher bar, then the similarity
+ * matrix, skipped (as git skips it) past `renameLimit` squared pairs. A
+ * rename takes its destination's place in the queue. `neededRenameLimit`
+ * is non-zero when the matrix was skipped.
+ */
+export declare function detectRenames<S extends RenameSide>(queue: readonly QueuedPair<S>[], read: (side: S) => Promise<Uint8Array>, { minimumScore, renameLimit }?: {
+    minimumScore?: number | undefined;
+    renameLimit?: number | undefined;
+}): Promise<{
+    queue: QueuedPair<S>[];
+    neededRenameLimit: number;
+}>;
+//# sourceMappingURL=unified-diff.d.ts.map

package/dist/git/unified-diff.d.ts.map

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