shell-dsl 0.0.32 → 0.0.33

package/README.md

@@ -36,6 +36,7 @@ bun add shell-dsl memfs
 - **Automatic escaping** — Interpolated values are escaped by default for safety
 - **POSIX-inspired syntax** — Pipes, redirects, control flow operators, and more
 - **Streaming pipelines** — Commands communicate via async iteration
+- **Version control** — Built-in VCS with commits, branches, checkout, and diffs on any virtual filesystem
 - **TypeScript-first** — Full type definitions included
 
 ## Getting Started
@@ -745,6 +746,109 @@ const fs = new FileSystem("/", {}, createWebUnderlyingFS(root));
 ```
 
 
+## Version Control
+
+`VersionControlSystem` adds git-like version control to any `VirtualFS`. It tracks changes as diffs, supports branching, and stores metadata in a `.vcs` directory.
+
+```ts
+import { VersionControlSystem, createVirtualFS } from "shell-dsl";
+import { createFsFromVolume, Volume } from "memfs";
+
+const vol = new Volume();
+vol.fromJSON({
+  "/project/src/index.ts": 'console.log("hello")',
+  "/project/README.md": "# My Project",
+});
+const fs = createVirtualFS(createFsFromVolume(vol));
+
+const vcs = new VersionControlSystem({
+  fs,
+  path: "/project",
+});
+```
+
+### Committing Changes
+
+```ts
+// Commit all pending changes
+const rev = await vcs.commit("initial commit");
+
+// Selective commit with glob patterns (relative to root path)
+await vcs.commit("update src only", { paths: ["/src/**"] });
+```
+
+### Checking Status
+
+`status()` returns a `DiffEntry[]` describing uncommitted changes:
+
+```ts
+const changes = await vcs.status();
+for (const entry of changes) {
+  console.log(entry.type, entry.path); // "add" | "modify" | "delete"
+}
+```
+
+### Checkout
+
+```ts
+// Checkout a specific revision (errors if working tree is dirty)
+await vcs.checkout(1);
+
+// Force checkout, discarding uncommitted changes
+await vcs.checkout(1, { force: true });
+
+// Partial checkout — restore specific files without changing HEAD
+await vcs.checkout(1, { paths: ["/src/index.ts", "/**/*.txt"] });
+```
+
+### Branching
+
+```ts
+// Create a branch at HEAD
+await vcs.branch("feature");
+
+// Switch to a branch
+await vcs.checkout("feature");
+
+// List all branches
+const branches = await vcs.branches();
+// [{ name: "main", revision: 1, current: false },
+//  { name: "feature", revision: 1, current: true }]
+```
+
+### History and Diffs
+
+```ts
+// Revision history
+const entries = await vcs.log();
+const filtered = await vcs.log({ path: "src/index.ts", limit: 10 });
+
+// Diff between two revisions
+const diff = await vcs.diff(1, 2);
+for (const entry of diff) {
+  console.log(entry.type, entry.path); // "add" | "modify" | "delete"
+}
+
+// Current HEAD info
+const head = await vcs.head();
+// { branch: "main", revision: 2 }
+```
+
+### Separate VCS Storage
+
+By default, metadata lives in `{path}/.vcs`. You can store it on a different filesystem:
+
+```ts
+const vcs = new VersionControlSystem({
+  fs: workingTreeFs,
+  path: "/project",
+  vcsPath: {
+    fs: metadataFs,          // different VirtualFS instance
+    path: "/meta/.vcs",      // custom location
+  },
+});
+```
+
 ## Low-Level API
 
 For advanced use cases (custom tooling, AST inspection):
@@ -809,6 +913,11 @@ import type {
   Permission,
   PermissionRules,
   UnderlyingFS,
+  VCSConfig,
+  Revision,
+  DiffEntry,
+  LogEntry,
+  BranchInfo,
 } from "shell-dsl";
 ```
 

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "type": "commonjs"
 }

package/dist/cjs/src/index.cjs

@@ -70,6 +70,7 @@ __export(exports_src, {
   createShellDSL: () => import_shell_dsl.createShellDSL,
   createPipe: () => import_io2.createPipe,
   WebFileSystem: () => import_fs2.WebFileSystem,
+  VersionControlSystem: () => import_vcs.VersionControlSystem,
   StdinImpl: () => import_io.StdinImpl,
   ShellPromise: () => import_shell_promise.ShellPromise,
   ShellError: () => import_errors.ShellError,
@@ -100,5 +101,6 @@ var import_fs2 = require("./fs/index.cjs");
 var import_io = require("./io/index.cjs");
 var import_io2 = require("./io/index.cjs");
 var import_utils = require("./utils/index.cjs");
+var import_vcs = require("./vcs/index.cjs");
 
-//# debugId=76B4D83DA9C2C40964756E2164756E21
+//# debugId=27F0973A44539CA064756E2164756E21

package/dist/cjs/src/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/index.ts"],
   "sourcesContent": [
-    "// Main class exports\nexport { ShellDSL, createShellDSL, type Program } from \"./shell-dsl.cjs\";\nexport { ShellPromise, type ShellPromiseOptions } from \"./shell-promise.cjs\";\n\n// Types\nexport type {\n  VirtualFS,\n  FileStat,\n  Command,\n  CommandContext,\n  Stdin,\n  Stdout,\n  Stderr,\n  OutputCollector,\n  ExecResult,\n  ShellConfig,\n  RawValue,\n} from \"./types.cjs\";\nexport { isRawValue } from \"./types.cjs\";\n\n// Errors\nexport { ShellError, LexError, ParseError } from \"./errors.cjs\";\n\n// Lexer\nexport { Lexer, lex, tokenToString } from \"./lexer/index.cjs\";\nexport type { Token, RedirectMode } from \"./lexer/index.cjs\";\n\n// Parser\nexport { Parser, parse } from \"./parser/index.cjs\";\nexport type {\n  ASTNode,\n  Redirect,\n  CommandNode,\n  PipelineNode,\n  AndNode,\n  OrNode,\n  SequenceNode,\n  LiteralNode,\n  VariableNode,\n  SubstitutionNode,\n  GlobNode,\n  ConcatNode,\n  IfNode,\n  ForNode,\n  WhileNode,\n  UntilNode,\n  CaseNode,\n  CaseClause,\n  ArithmeticNode,\n} from \"./parser/index.cjs\";\nexport {\n  isCommandNode,\n  isPipelineNode,\n  isAndNode,\n  isOrNode,\n  isSequenceNode,\n  isLiteralNode,\n  isVariableNode,\n  isSubstitutionNode,\n  isGlobNode,\n  isConcatNode,\n  isIfNode,\n  isForNode,\n  isWhileNode,\n  isUntilNode,\n  isCaseNode,\n  isArithmeticNode,\n} from \"./parser/index.cjs\";\n\n// Interpreter\nexport { Interpreter, type InterpreterOptions, BreakException, ContinueException } from \"./interpreter/index.cjs\";\n\n// Filesystem\nexport { createVirtualFS } from \"./fs/index.cjs\";\nexport {\n  FileSystem,\n  ReadOnlyFileSystem,\n  WebFileSystem,\n  createWebUnderlyingFS,\n  type PathOps,\n  type Permission,\n  type PermissionRules,\n  type UnderlyingFS,\n} from \"./fs/index.cjs\";\n\n// I/O\nexport { createStdin, StdinImpl } from \"./io/index.cjs\";\nexport { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from \"./io/index.cjs\";\n\n// Utilities\nexport { escape, escapeForInterpolation, globVirtualFS } from \"./utils/index.cjs\";\nexport type { GlobVirtualFS, GlobOptions } from \"./utils/index.cjs\";\n"
+    "// Main class exports\nexport { ShellDSL, createShellDSL, type Program } from \"./shell-dsl.cjs\";\nexport { ShellPromise, type ShellPromiseOptions } from \"./shell-promise.cjs\";\n\n// Types\nexport type {\n  VirtualFS,\n  FileStat,\n  Command,\n  CommandContext,\n  Stdin,\n  Stdout,\n  Stderr,\n  OutputCollector,\n  ExecResult,\n  ShellConfig,\n  RawValue,\n} from \"./types.cjs\";\nexport { isRawValue } from \"./types.cjs\";\n\n// Errors\nexport { ShellError, LexError, ParseError } from \"./errors.cjs\";\n\n// Lexer\nexport { Lexer, lex, tokenToString } from \"./lexer/index.cjs\";\nexport type { Token, RedirectMode } from \"./lexer/index.cjs\";\n\n// Parser\nexport { Parser, parse } from \"./parser/index.cjs\";\nexport type {\n  ASTNode,\n  Redirect,\n  CommandNode,\n  PipelineNode,\n  AndNode,\n  OrNode,\n  SequenceNode,\n  LiteralNode,\n  VariableNode,\n  SubstitutionNode,\n  GlobNode,\n  ConcatNode,\n  IfNode,\n  ForNode,\n  WhileNode,\n  UntilNode,\n  CaseNode,\n  CaseClause,\n  ArithmeticNode,\n} from \"./parser/index.cjs\";\nexport {\n  isCommandNode,\n  isPipelineNode,\n  isAndNode,\n  isOrNode,\n  isSequenceNode,\n  isLiteralNode,\n  isVariableNode,\n  isSubstitutionNode,\n  isGlobNode,\n  isConcatNode,\n  isIfNode,\n  isForNode,\n  isWhileNode,\n  isUntilNode,\n  isCaseNode,\n  isArithmeticNode,\n} from \"./parser/index.cjs\";\n\n// Interpreter\nexport { Interpreter, type InterpreterOptions, BreakException, ContinueException } from \"./interpreter/index.cjs\";\n\n// Filesystem\nexport { createVirtualFS } from \"./fs/index.cjs\";\nexport {\n  FileSystem,\n  ReadOnlyFileSystem,\n  WebFileSystem,\n  createWebUnderlyingFS,\n  type PathOps,\n  type Permission,\n  type PermissionRules,\n  type UnderlyingFS,\n} from \"./fs/index.cjs\";\n\n// I/O\nexport { createStdin, StdinImpl } from \"./io/index.cjs\";\nexport { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from \"./io/index.cjs\";\n\n// Utilities\nexport { escape, escapeForInterpolation, globVirtualFS } from \"./utils/index.cjs\";\nexport type { GlobVirtualFS, GlobOptions } from \"./utils/index.cjs\";\n\n// Version Control\nexport { VersionControlSystem } from \"./vcs/index.cjs\";\nexport type {\n  VCSConfig,\n  Revision,\n  DiffEntry,\n  TreeManifest,\n  FileEntry,\n  CommitOptions,\n  CheckoutOptions,\n  LogOptions,\n  LogEntry,\n  BranchInfo,\n} from \"./vcs/index.cjs\";\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACuD,IAAvD;AACuD,IAAvD;AAgB2B,IAA3B;AAGiD,IAAjD;AAG0C,IAA1C;AAI8B,IAA9B;AAuCO,IAjBP;AAoBwF,IAAxF;AAGgC,IAAhC;AAUO,IATP;AAYuC,IAAvC;AACwF,IAAxF;AAG8D,IAA9D;",
-  "debugId": "76B4D83DA9C2C40964756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACuD,IAAvD;AACuD,IAAvD;AAgB2B,IAA3B;AAGiD,IAAjD;AAG0C,IAA1C;AAI8B,IAA9B;AAuCO,IAjBP;AAoBwF,IAAxF;AAGgC,IAAhC;AAUO,IATP;AAYuC,IAAvC;AACwF,IAAxF;AAG8D,IAA9D;AAIqC,IAArC;",
+  "debugId": "27F0973A44539CA064756E2164756E21",
   "names": []
 }

package/dist/cjs/src/vcs/diff.cjs

@@ -0,0 +1,102 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/vcs/diff.ts
+var exports_diff = {};
+__export(exports_diff, {
+  diffWorkingTree: () => diffWorkingTree,
+  diffManifests: () => diffManifests
+});
+module.exports = __toCommonJS(exports_diff);
+var import_walk = require("./walk.cjs");
+function diffManifests(before, after) {
+  const entries = [];
+  const allPaths = new Set([...Object.keys(before), ...Object.keys(after)]);
+  for (const path of allPaths) {
+    const prev = before[path];
+    const curr = after[path];
+    if (!prev && curr) {
+      entries.push({ type: "add", path, content: curr.content });
+    } else if (prev && !curr) {
+      entries.push({ type: "delete", path, previousContent: prev.content });
+    } else if (prev && curr && prev.content !== curr.content) {
+      entries.push({
+        type: "modify",
+        path,
+        content: curr.content,
+        previousContent: prev.content
+      });
+    }
+  }
+  return entries.sort((a, b) => a.path.localeCompare(b.path));
+}
+async function diffWorkingTree(fs, rootPath, manifest, exclude = []) {
+  const entries = [];
+  const workingFiles = await import_walk.walkTree(fs, rootPath, exclude);
+  const manifestPaths = new Set(Object.keys(manifest));
+  const seenPaths = new Set;
+  for (const relPath of workingFiles) {
+    seenPaths.add(relPath);
+    const fullPath = fs.resolve(rootPath, relPath);
+    const content = await fs.readFile(fullPath);
+    const b64 = Buffer.from(content).toString("base64");
+    const prev = manifest[relPath];
+    if (!prev) {
+      entries.push({ type: "add", path: relPath, content: b64 });
+    } else if (prev.content !== b64) {
+      entries.push({
+        type: "modify",
+        path: relPath,
+        content: b64,
+        previousContent: prev.content
+      });
+    }
+  }
+  for (const manifestPath of manifestPaths) {
+    if (!seenPaths.has(manifestPath)) {
+      entries.push({
+        type: "delete",
+        path: manifestPath,
+        previousContent: manifest[manifestPath].content
+      });
+    }
+  }
+  return entries.sort((a, b) => a.path.localeCompare(b.path));
+}
+
+//# debugId=C182915799ABD69764756E2164756E21

package/dist/cjs/src/vcs/diff.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/vcs/diff.ts"],
+  "sourcesContent": [
+    "import type { VirtualFS } from \"../types.cjs\";\nimport type { TreeManifest, DiffEntry } from \"./types.cjs\";\nimport { walkTree } from \"./walk.cjs\";\n\n/**\n * Compute diff entries between two tree manifests.\n */\nexport function diffManifests(\n  before: TreeManifest,\n  after: TreeManifest,\n): DiffEntry[] {\n  const entries: DiffEntry[] = [];\n  const allPaths = new Set([...Object.keys(before), ...Object.keys(after)]);\n\n  for (const path of allPaths) {\n    const prev = before[path];\n    const curr = after[path];\n\n    if (!prev && curr) {\n      entries.push({ type: \"add\", path, content: curr.content });\n    } else if (prev && !curr) {\n      entries.push({ type: \"delete\", path, previousContent: prev.content });\n    } else if (prev && curr && prev.content !== curr.content) {\n      entries.push({\n        type: \"modify\",\n        path,\n        content: curr.content,\n        previousContent: prev.content,\n      });\n    }\n  }\n\n  return entries.sort((a, b) => a.path.localeCompare(b.path));\n}\n\n/**\n * Compute diff between a tree manifest and the current working tree.\n */\nexport async function diffWorkingTree(\n  fs: VirtualFS,\n  rootPath: string,\n  manifest: TreeManifest,\n  exclude: string[] = [],\n): Promise<DiffEntry[]> {\n  const entries: DiffEntry[] = [];\n  const workingFiles = await walkTree(fs, rootPath, exclude);\n  const manifestPaths = new Set(Object.keys(manifest));\n  const seenPaths = new Set<string>();\n\n  for (const relPath of workingFiles) {\n    seenPaths.add(relPath);\n    const fullPath = fs.resolve(rootPath, relPath);\n    const content = await fs.readFile(fullPath);\n    const b64 = Buffer.from(content).toString(\"base64\");\n\n    const prev = manifest[relPath];\n    if (!prev) {\n      entries.push({ type: \"add\", path: relPath, content: b64 });\n    } else if (prev.content !== b64) {\n      entries.push({\n        type: \"modify\",\n        path: relPath,\n        content: b64,\n        previousContent: prev.content,\n      });\n    }\n  }\n\n  for (const manifestPath of manifestPaths) {\n    if (!seenPaths.has(manifestPath)) {\n      entries.push({\n        type: \"delete\",\n        path: manifestPath,\n        previousContent: manifest[manifestPath]!.content,\n      });\n    }\n  }\n\n  return entries.sort((a, b) => a.path.localeCompare(b.path));\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEyB,IAAzB;AAKO,SAAS,aAAa,CAC3B,QACA,OACa;AAAA,EACb,MAAM,UAAuB,CAAC;AAAA,EAC9B,MAAM,WAAW,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC;AAAA,EAExE,WAAW,QAAQ,UAAU;AAAA,IAC3B,MAAM,OAAO,OAAO;AAAA,IACpB,MAAM,OAAO,MAAM;AAAA,IAEnB,IAAI,CAAC,QAAQ,MAAM;AAAA,MACjB,QAAQ,KAAK,EAAE,MAAM,OAAO,MAAM,SAAS,KAAK,QAAQ,CAAC;AAAA,IAC3D,EAAO,SAAI,QAAQ,CAAC,MAAM;AAAA,MACxB,QAAQ,KAAK,EAAE,MAAM,UAAU,MAAM,iBAAiB,KAAK,QAAQ,CAAC;AAAA,IACtE,EAAO,SAAI,QAAQ,QAAQ,KAAK,YAAY,KAAK,SAAS;AAAA,MACxD,QAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN;AAAA,QACA,SAAS,KAAK;AAAA,QACd,iBAAiB,KAAK;AAAA,MACxB,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,OAAO,QAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAAA;AAM5D,eAAsB,eAAe,CACnC,IACA,UACA,UACA,UAAoB,CAAC,GACC;AAAA,EACtB,MAAM,UAAuB,CAAC;AAAA,EAC9B,MAAM,eAAe,MAAM,qBAAS,IAAI,UAAU,OAAO;AAAA,EACzD,MAAM,gBAAgB,IAAI,IAAI,OAAO,KAAK,QAAQ,CAAC;AAAA,EACnD,MAAM,YAAY,IAAI;AAAA,EAEtB,WAAW,WAAW,cAAc;AAAA,IAClC,UAAU,IAAI,OAAO;AAAA,IACrB,MAAM,WAAW,GAAG,QAAQ,UAAU,OAAO;AAAA,IAC7C,MAAM,UAAU,MAAM,GAAG,SAAS,QAAQ;AAAA,IAC1C,MAAM,MAAM,OAAO,KAAK,OAAO,EAAE,SAAS,QAAQ;AAAA,IAElD,MAAM,OAAO,SAAS;AAAA,IACtB,IAAI,CAAC,MAAM;AAAA,MACT,QAAQ,KAAK,EAAE,MAAM,OAAO,MAAM,SAAS,SAAS,IAAI,CAAC;AAAA,IAC3D,EAAO,SAAI,KAAK,YAAY,KAAK;AAAA,MAC/B,QAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS;AAAA,QACT,iBAAiB,KAAK;AAAA,MACxB,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,WAAW,gBAAgB,eAAe;AAAA,IACxC,IAAI,CAAC,UAAU,IAAI,YAAY,GAAG;AAAA,MAChC,QAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,MAAM;AAAA,QACN,iBAAiB,SAAS,cAAe;AAAA,MAC3C,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,OAAO,QAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAAA;",
+  "debugId": "C182915799ABD69764756E2164756E21",
+  "names": []
+}

package/dist/cjs/src/vcs/index.cjs

@@ -0,0 +1,47 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/vcs/index.ts
+var exports_vcs = {};
+__export(exports_vcs, {
+  VersionControlSystem: () => import_vcs.VersionControlSystem
+});
+module.exports = __toCommonJS(exports_vcs);
+var import_vcs = require("./vcs.cjs");
+
+//# debugId=882B2013CEEDB5D864756E2164756E21

package/dist/cjs/src/vcs/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/vcs/index.ts"],
+  "sourcesContent": [
+    "export { VersionControlSystem } from \"./vcs.cjs\";\nexport type {\n  VCSConfig,\n  Revision,\n  DiffEntry,\n  TreeManifest,\n  FileEntry,\n  CommitOptions,\n  CheckoutOptions,\n  LogOptions,\n  LogEntry,\n  BranchInfo,\n} from \"./types.cjs\";\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAqC,IAArC;",
+  "debugId": "882B2013CEEDB5D864756E2164756E21",
+  "names": []
+}

package/dist/cjs/src/vcs/match.cjs

@@ -0,0 +1,106 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/vcs/match.ts
+var exports_match = {};
+__export(exports_match, {
+  matchGlobPath: () => matchGlobPath
+});
+module.exports = __toCommonJS(exports_match);
+function matchGlobPath(pattern, filePath) {
+  const p = pattern.startsWith("/") ? pattern.slice(1) : pattern;
+  const f = filePath.startsWith("/") ? filePath.slice(1) : filePath;
+  const patternParts = p.split("/");
+  const pathParts = f.split("/");
+  return matchParts(patternParts, pathParts, 0, 0);
+}
+function matchParts(pattern, path, pi, fi) {
+  while (pi < pattern.length && fi < path.length) {
+    const seg = pattern[pi];
+    if (seg === "**") {
+      for (let i = fi;i <= path.length; i++) {
+        if (matchParts(pattern, path, pi + 1, i))
+          return true;
+      }
+      return false;
+    }
+    if (!matchSegment(seg, path[fi]))
+      return false;
+    pi++;
+    fi++;
+  }
+  while (pi < pattern.length && pattern[pi] === "**")
+    pi++;
+  return pi === pattern.length && fi === path.length;
+}
+function matchSegment(pattern, segment) {
+  let regex = "^";
+  for (let i = 0;i < pattern.length; i++) {
+    const c = pattern[i];
+    switch (c) {
+      case "*":
+        regex += "[^/]*";
+        break;
+      case "?":
+        regex += "[^/]";
+        break;
+      case ".":
+      case "^":
+      case "$":
+      case "+":
+      case "{":
+      case "}":
+      case "(":
+      case ")":
+      case "|":
+      case "\\":
+        regex += "\\" + c;
+        break;
+      default:
+        regex += c;
+    }
+  }
+  regex += "$";
+  try {
+    return new RegExp(regex).test(segment);
+  } catch {
+    return false;
+  }
+}
+
+//# debugId=9C038AE3F1837D4764756E2164756E21

package/dist/cjs/src/vcs/match.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/vcs/match.ts"],
+  "sourcesContent": [
+    "/**\n * Match a file path against a glob pattern.\n * Supports `**` for recursive directory matching, `*` for single segment wildcard.\n */\nexport function matchGlobPath(pattern: string, filePath: string): boolean {\n  // Normalize: strip leading slashes\n  const p = pattern.startsWith(\"/\") ? pattern.slice(1) : pattern;\n  const f = filePath.startsWith(\"/\") ? filePath.slice(1) : filePath;\n\n  const patternParts = p.split(\"/\");\n  const pathParts = f.split(\"/\");\n\n  return matchParts(patternParts, pathParts, 0, 0);\n}\n\nfunction matchParts(\n  pattern: string[],\n  path: string[],\n  pi: number,\n  fi: number,\n): boolean {\n  while (pi < pattern.length && fi < path.length) {\n    const seg = pattern[pi]!;\n\n    if (seg === \"**\") {\n      // ** matches zero or more path segments\n      // Try matching rest of pattern against current position and all subsequent positions\n      for (let i = fi; i <= path.length; i++) {\n        if (matchParts(pattern, path, pi + 1, i)) return true;\n      }\n      return false;\n    }\n\n    if (!matchSegment(seg, path[fi]!)) return false;\n    pi++;\n    fi++;\n  }\n\n  // Skip trailing ** patterns\n  while (pi < pattern.length && pattern[pi] === \"**\") pi++;\n\n  return pi === pattern.length && fi === path.length;\n}\n\nfunction matchSegment(pattern: string, segment: string): boolean {\n  // Convert glob segment to regex\n  let regex = \"^\";\n  for (let i = 0; i < pattern.length; i++) {\n    const c = pattern[i]!;\n    switch (c) {\n      case \"*\":\n        regex += \"[^/]*\";\n        break;\n      case \"?\":\n        regex += \"[^/]\";\n        break;\n      case \".\":\n      case \"^\":\n      case \"$\":\n      case \"+\":\n      case \"{\":\n      case \"}\":\n      case \"(\":\n      case \")\":\n      case \"|\":\n      case \"\\\\\":\n        regex += \"\\\\\" + c;\n        break;\n      default:\n        regex += c;\n    }\n  }\n  regex += \"$\";\n\n  try {\n    return new RegExp(regex).test(segment);\n  } catch {\n    return false;\n  }\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIO,SAAS,aAAa,CAAC,SAAiB,UAA2B;AAAA,EAExE,MAAM,IAAI,QAAQ,WAAW,GAAG,IAAI,QAAQ,MAAM,CAAC,IAAI;AAAA,EACvD,MAAM,IAAI,SAAS,WAAW,GAAG,IAAI,SAAS,MAAM,CAAC,IAAI;AAAA,EAEzD,MAAM,eAAe,EAAE,MAAM,GAAG;AAAA,EAChC,MAAM,YAAY,EAAE,MAAM,GAAG;AAAA,EAE7B,OAAO,WAAW,cAAc,WAAW,GAAG,CAAC;AAAA;AAGjD,SAAS,UAAU,CACjB,SACA,MACA,IACA,IACS;AAAA,EACT,OAAO,KAAK,QAAQ,UAAU,KAAK,KAAK,QAAQ;AAAA,IAC9C,MAAM,MAAM,QAAQ;AAAA,IAEpB,IAAI,QAAQ,MAAM;AAAA,MAGhB,SAAS,IAAI,GAAI,KAAK,KAAK,QAAQ,KAAK;AAAA,QACtC,IAAI,WAAW,SAAS,MAAM,KAAK,GAAG,CAAC;AAAA,UAAG,OAAO;AAAA,MACnD;AAAA,MACA,OAAO;AAAA,IACT;AAAA,IAEA,IAAI,CAAC,aAAa,KAAK,KAAK,GAAI;AAAA,MAAG,OAAO;AAAA,IAC1C;AAAA,IACA;AAAA,EACF;AAAA,EAGA,OAAO,KAAK,QAAQ,UAAU,QAAQ,QAAQ;AAAA,IAAM;AAAA,EAEpD,OAAO,OAAO,QAAQ,UAAU,OAAO,KAAK;AAAA;AAG9C,SAAS,YAAY,CAAC,SAAiB,SAA0B;AAAA,EAE/D,IAAI,QAAQ;AAAA,EACZ,SAAS,IAAI,EAAG,IAAI,QAAQ,QAAQ,KAAK;AAAA,IACvC,MAAM,IAAI,QAAQ;AAAA,IAClB,QAAQ;AAAA,WACD;AAAA,QACH,SAAS;AAAA,QACT;AAAA,WACG;AAAA,QACH,SAAS;AAAA,QACT;AAAA,WACG;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,QACH,SAAS,OAAO;AAAA,QAChB;AAAA;AAAA,QAEA,SAAS;AAAA;AAAA,EAEf;AAAA,EACA,SAAS;AAAA,EAET,IAAI;AAAA,IACF,OAAO,IAAI,OAAO,KAAK,EAAE,KAAK,OAAO;AAAA,IACrC,MAAM;AAAA,IACN,OAAO;AAAA;AAAA;",
+  "debugId": "9C038AE3F1837D4764756E2164756E21",
+  "names": []
+}

package/dist/cjs/src/vcs/snapshot.cjs

@@ -0,0 +1,112 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/vcs/snapshot.ts
+var exports_snapshot = {};
+__export(exports_snapshot, {
+  restoreTree: () => restoreTree,
+  buildTreeManifest: () => buildTreeManifest,
+  buildPartialManifest: () => buildPartialManifest
+});
+module.exports = __toCommonJS(exports_snapshot);
+var import_walk = require("./walk.cjs");
+async function buildTreeManifest(fs, rootPath, exclude = []) {
+  const manifest = {};
+  const files = await import_walk.walkTree(fs, rootPath, exclude);
+  for (const relPath of files) {
+    const fullPath = fs.resolve(rootPath, relPath);
+    const content = await fs.readFile(fullPath);
+    const buf = Buffer.from(content);
+    manifest[relPath] = {
+      content: buf.toString("base64"),
+      size: buf.length
+    };
+  }
+  return manifest;
+}
+async function buildPartialManifest(fs, rootPath, paths) {
+  const manifest = {};
+  for (const relPath of paths) {
+    const fullPath = fs.resolve(rootPath, relPath);
+    if (!await fs.exists(fullPath))
+      continue;
+    const stat = await fs.stat(fullPath);
+    if (!stat.isFile())
+      continue;
+    const content = await fs.readFile(fullPath);
+    const buf = Buffer.from(content);
+    manifest[relPath] = {
+      content: buf.toString("base64"),
+      size: buf.length
+    };
+  }
+  return manifest;
+}
+async function restoreTree(fs, rootPath, manifest, options) {
+  const fullRestore = options?.fullRestore ?? false;
+  const filterPaths = options?.paths ? new Set(options.paths) : null;
+  for (const [relPath, entry] of Object.entries(manifest)) {
+    if (filterPaths && !filterPaths.has(relPath))
+      continue;
+    await writeFileFromEntry(fs, rootPath, relPath, entry);
+  }
+  if (fullRestore) {
+    const exclude = getVcsDirName(rootPath);
+    const currentFiles = await import_walk.walkTree(fs, rootPath, exclude ? [exclude] : []);
+    for (const relPath of currentFiles) {
+      if (!manifest[relPath]) {
+        const fullPath = fs.resolve(rootPath, relPath);
+        await fs.rm(fullPath);
+      }
+    }
+  }
+}
+async function writeFileFromEntry(fs, rootPath, relPath, entry) {
+  const fullPath = fs.resolve(rootPath, relPath);
+  const dir = fs.dirname(fullPath);
+  if (!await fs.exists(dir)) {
+    await fs.mkdir(dir, { recursive: true });
+  }
+  const buf = Buffer.from(entry.content, "base64");
+  await fs.writeFile(fullPath, buf);
+}
+function getVcsDirName(_rootPath) {
+  return ".vcs";
+}
+
+//# debugId=E0FC26F624360D1C64756E2164756E21

package/dist/cjs/src/vcs/snapshot.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/vcs/snapshot.ts"],
+  "sourcesContent": [
+    "import type { VirtualFS } from \"../types.cjs\";\nimport type { TreeManifest, FileEntry } from \"./types.cjs\";\nimport { walkTree } from \"./walk.cjs\";\n\n/**\n * Build a TreeManifest from the current working tree.\n */\nexport async function buildTreeManifest(\n  fs: VirtualFS,\n  rootPath: string,\n  exclude: string[] = [],\n): Promise<TreeManifest> {\n  const manifest: TreeManifest = {};\n  const files = await walkTree(fs, rootPath, exclude);\n\n  for (const relPath of files) {\n    const fullPath = fs.resolve(rootPath, relPath);\n    const content = await fs.readFile(fullPath);\n    const buf = Buffer.from(content);\n    manifest[relPath] = {\n      content: buf.toString(\"base64\"),\n      size: buf.length,\n    };\n  }\n\n  return manifest;\n}\n\n/**\n * Build a TreeManifest for only the specified relative paths.\n */\nexport async function buildPartialManifest(\n  fs: VirtualFS,\n  rootPath: string,\n  paths: string[],\n): Promise<TreeManifest> {\n  const manifest: TreeManifest = {};\n\n  for (const relPath of paths) {\n    const fullPath = fs.resolve(rootPath, relPath);\n    if (!(await fs.exists(fullPath))) continue;\n    const stat = await fs.stat(fullPath);\n    if (!stat.isFile()) continue;\n\n    const content = await fs.readFile(fullPath);\n    const buf = Buffer.from(content);\n    manifest[relPath] = {\n      content: buf.toString(\"base64\"),\n      size: buf.length,\n    };\n  }\n\n  return manifest;\n}\n\n/**\n * Restore a working tree from a TreeManifest.\n *\n * If `fullRestore` is true, deletes working tree files not in the manifest.\n * If `paths` is provided, only restores matching files.\n */\nexport async function restoreTree(\n  fs: VirtualFS,\n  rootPath: string,\n  manifest: TreeManifest,\n  options?: { fullRestore?: boolean; paths?: string[] },\n): Promise<void> {\n  const fullRestore = options?.fullRestore ?? false;\n  const filterPaths = options?.paths ? new Set(options.paths) : null;\n\n  // Write files from manifest\n  for (const [relPath, entry] of Object.entries(manifest)) {\n    if (filterPaths && !filterPaths.has(relPath)) continue;\n    await writeFileFromEntry(fs, rootPath, relPath, entry);\n  }\n\n  // Delete files not in manifest (full restore only)\n  if (fullRestore) {\n    const exclude = getVcsDirName(rootPath);\n    const currentFiles = await walkTree(fs, rootPath, exclude ? [exclude] : []);\n\n    for (const relPath of currentFiles) {\n      if (!manifest[relPath]) {\n        const fullPath = fs.resolve(rootPath, relPath);\n        await fs.rm(fullPath);\n      }\n    }\n  }\n}\n\nasync function writeFileFromEntry(\n  fs: VirtualFS,\n  rootPath: string,\n  relPath: string,\n  entry: FileEntry,\n): Promise<void> {\n  const fullPath = fs.resolve(rootPath, relPath);\n  const dir = fs.dirname(fullPath);\n\n  // Ensure parent directory exists\n  if (!(await fs.exists(dir))) {\n    await fs.mkdir(dir, { recursive: true });\n  }\n\n  const buf = Buffer.from(entry.content, \"base64\");\n  await fs.writeFile(fullPath, buf);\n}\n\nfunction getVcsDirName(_rootPath: string): string | null {\n  return \".vcs\";\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEyB,IAAzB;AAKA,eAAsB,iBAAiB,CACrC,IACA,UACA,UAAoB,CAAC,GACE;AAAA,EACvB,MAAM,WAAyB,CAAC;AAAA,EAChC,MAAM,QAAQ,MAAM,qBAAS,IAAI,UAAU,OAAO;AAAA,EAElD,WAAW,WAAW,OAAO;AAAA,IAC3B,MAAM,WAAW,GAAG,QAAQ,UAAU,OAAO;AAAA,IAC7C,MAAM,UAAU,MAAM,GAAG,SAAS,QAAQ;AAAA,IAC1C,MAAM,MAAM,OAAO,KAAK,OAAO;AAAA,IAC/B,SAAS,WAAW;AAAA,MAClB,SAAS,IAAI,SAAS,QAAQ;AAAA,MAC9B,MAAM,IAAI;AAAA,IACZ;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAMT,eAAsB,oBAAoB,CACxC,IACA,UACA,OACuB;AAAA,EACvB,MAAM,WAAyB,CAAC;AAAA,EAEhC,WAAW,WAAW,OAAO;AAAA,IAC3B,MAAM,WAAW,GAAG,QAAQ,UAAU,OAAO;AAAA,IAC7C,IAAI,CAAE,MAAM,GAAG,OAAO,QAAQ;AAAA,MAAI;AAAA,IAClC,MAAM,OAAO,MAAM,GAAG,KAAK,QAAQ;AAAA,IACnC,IAAI,CAAC,KAAK,OAAO;AAAA,MAAG;AAAA,IAEpB,MAAM,UAAU,MAAM,GAAG,SAAS,QAAQ;AAAA,IAC1C,MAAM,MAAM,OAAO,KAAK,OAAO;AAAA,IAC/B,SAAS,WAAW;AAAA,MAClB,SAAS,IAAI,SAAS,QAAQ;AAAA,MAC9B,MAAM,IAAI;AAAA,IACZ;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAST,eAAsB,WAAW,CAC/B,IACA,UACA,UACA,SACe;AAAA,EACf,MAAM,cAAc,SAAS,eAAe;AAAA,EAC5C,MAAM,cAAc,SAAS,QAAQ,IAAI,IAAI,QAAQ,KAAK,IAAI;AAAA,EAG9D,YAAY,SAAS,UAAU,OAAO,QAAQ,QAAQ,GAAG;AAAA,IACvD,IAAI,eAAe,CAAC,YAAY,IAAI,OAAO;AAAA,MAAG;AAAA,IAC9C,MAAM,mBAAmB,IAAI,UAAU,SAAS,KAAK;AAAA,EACvD;AAAA,EAGA,IAAI,aAAa;AAAA,IACf,MAAM,UAAU,cAAc,QAAQ;AAAA,IACtC,MAAM,eAAe,MAAM,qBAAS,IAAI,UAAU,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AAAA,IAE1E,WAAW,WAAW,cAAc;AAAA,MAClC,IAAI,CAAC,SAAS,UAAU;AAAA,QACtB,MAAM,WAAW,GAAG,QAAQ,UAAU,OAAO;AAAA,QAC7C,MAAM,GAAG,GAAG,QAAQ;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AAAA;AAGF,eAAe,kBAAkB,CAC/B,IACA,UACA,SACA,OACe;AAAA,EACf,MAAM,WAAW,GAAG,QAAQ,UAAU,OAAO;AAAA,EAC7C,MAAM,MAAM,GAAG,QAAQ,QAAQ;AAAA,EAG/B,IAAI,CAAE,MAAM,GAAG,OAAO,GAAG,GAAI;AAAA,IAC3B,MAAM,GAAG,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AAAA,EACzC;AAAA,EAEA,MAAM,MAAM,OAAO,KAAK,MAAM,SAAS,QAAQ;AAAA,EAC/C,MAAM,GAAG,UAAU,UAAU,GAAG;AAAA;AAGlC,SAAS,aAAa,CAAC,WAAkC;AAAA,EACvD,OAAO;AAAA;",
+  "debugId": "E0FC26F624360D1C64756E2164756E21",
+  "names": []
+}