browser-git-ops 0.0.4 → 0.0.5

package/dist/index.js

@@ -53,23 +53,28 @@ var APIGitLib = (() => {
         ok = true;
       return ok;
     }
-    /** 利用可能なサブディレクトリ名の候補を返す
-     * @returns {Promise<string[]>} available root directories
-     */
     /**
      * Return available root folder names for OPFS. This method is synchronous
      * to satisfy the StorageBackendConstructor contract; it returns a cached
      * hint if available and kicks off an async probe to populate the cache.
      * If no information is available synchronously an empty array is returned.
-      * @returns {Promise<string[]>} available root directories
+     * @returns {Promise<string[]>} available root directories
      */
-    static async availableRoots() {
+    static async availableRoots(namespace) {
       try {
         const root = await OpfsStorage2._getNavigatorStorageRoot();
         if (!root)
           return [];
-        return await OpfsStorage2._collectDirectoryNames(root);
-      } catch {
+        for await (const handle of root.values()) {
+          const name = OpfsStorage2._extractHandleName(handle);
+          if (name === namespace && OpfsStorage2._isDirectoryHandle(handle)) {
+            return await OpfsStorage2._collectDirectoryNames(handle);
+          }
+        }
+        return [];
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("availableRoots probe failed", error);
         return [];
       }
     }
@@ -120,6 +125,7 @@ var APIGitLib = (() => {
     }
     rootDir = "apigit_storage";
     currentBranch = null;
+    namespace = "";
     /**
      * Calculate SHA-1 hex digest of given content.
      * @param content Input string
@@ -132,10 +138,21 @@ var APIGitLib = (() => {
       const hashArray = Array.from(new Uint8Array(hashBuffer));
       return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
     }
-    /** コンストラクタ（OPFS は初期化不要）。`root` は OPFS ルート直下に作成するサブディレクトリ名です。 */
-    constructor(root) {
-      if (root)
-        this.rootDir = root;
+    /**
+     * コンストラクタ（OPFS は初期化不要）。
+     * `namespace` は必須。挙動:
+     * - `new(namespace)` のみの場合は OPFS ルートとして `namespace` を使う（テストの期待値に合わせる）。
+     * - `new(namespace, root)` の場合は `namespace/root` を使う。
+     */
+    constructor(namespace, root) {
+      this.namespace = namespace || "";
+      if (root) {
+        this.rootDir = this.namespace ? `${this.namespace}/${root}` : root;
+      } else if (this.namespace) {
+        this.rootDir = this.namespace;
+      } else {
+        this.rootDir = this.rootDir;
+      }
     }
     /**
      * 初期化（OPFS はランタイム判定のみ）
@@ -163,7 +180,7 @@ var APIGitLib = (() => {
     }
     /**
      * Map logical segment to concrete prefix used on OPFS.
-      * @returns {string} concrete prefix path for the given segment
+     * @returns {string} concrete prefix path for the given segment
      */
     _segmentToPrefix(segment) {
       if (segment === "workspace")
@@ -172,7 +189,6 @@ var APIGitLib = (() => {
       const branch = this.currentBranch || "main";
       return `.git/${branch}/${segName}`;
     }
-    // legacy canUseOpfs removed; use static canUse() instead
     /**
      * Try to get OPFS root from navigator.storage.getDirectory().
      * @returns {Promise<any|null>}
@@ -186,7 +202,9 @@ var APIGitLib = (() => {
         const maybe = nav.storage.getDirectory();
         const d = await Promise.resolve(maybe);
         return d || null;
-      } catch {
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("_tryNavigatorStorage failed", error);
         return null;
       }
     }
@@ -201,7 +219,9 @@ var APIGitLib = (() => {
       }
       try {
         return await opfs.getDirectory();
-      } catch {
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("_tryOriginPrivateFileSystem failed", error);
         return null;
       }
     }
@@ -232,10 +252,6 @@ var APIGitLib = (() => {
       }
       return directory;
     }
-    /**
-     * index を読み出す
-     * @returns {Promise<IndexFile|null>} 読み出した IndexFile、存在しなければ null
-     */
     /**
      * Read index metadata file from OPFS.
      * @returns {Promise<string|null>}
@@ -252,7 +268,9 @@ var APIGitLib = (() => {
         const fh = await root.getFileHandle("index");
         const file = await fh.getFile();
         return await file.text();
-      } catch {
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("_readIndexMetadata failed", error);
         return null;
       }
     }
@@ -611,8 +629,8 @@ var APIGitLib = (() => {
      * @param root root directory handle
      * @param prefix prefix dir
      * @param filepath path relative to prefix
-      * @returns {Promise<string|null>} file contents or null when not found
-      */
+     * @returns {Promise<string|null>} file contents or null when not found
+     */
     async readFromPrefix(root, prefix, filepath) {
       try {
         const fullPath = this.rootDir ? `${this.rootDir}/${prefix}/${filepath}` : `${prefix}/${filepath}`;
@@ -696,7 +714,6 @@ var APIGitLib = (() => {
         await this._handleChildEntry(d, name, base, results);
       }
     }
-    /** Handle a single child entry name: try file first, then directory. */
     /**
      * @returns {Promise<void>}
      */
@@ -750,7 +767,7 @@ var APIGitLib = (() => {
      * @param prefix プレフィックス（例: 'dir/sub'）。省略時はルート
      * @param segment セグメント（'workspace' 等）。省略時は 'workspace'
      * @param recursive サブディレクトリも含めるか。省略時は true
-      * @returns {Promise<Array<{ path: string; info: string | null }>>}
+     * @returns {Promise<Array<{ path: string; info: string | null }>>}
      */
     async listFiles(prefix, segment, recursive = true) {
       const root = await this.getOpfsRoot();
@@ -794,12 +811,9 @@ var APIGitLib = (() => {
      */
     async _findStorageDirectory(navRoot) {
       try {
-        for await (const handle of navRoot.values()) {
-          const name = OpfsStorage2._extractHandleName(handle);
-          if (name === this.rootDir && OpfsStorage2._isDirectoryHandle(handle))
-            return handle;
-        }
-        return null;
+        const parts = this.rootDir.split("/").filter(Boolean);
+        const directoryHandle = await this.traverseDir(navRoot, parts);
+        return directoryHandle;
       } catch {
         return null;
       }
@@ -983,7 +997,6 @@ var APIGitLib = (() => {
     setLogger(logger) {
       this.logger = logger;
     }
-    // Internal helpers to forward logs only when a logger is injected
     /**
      * Log debug messages when a logger is present.
      * @param _messages messages to log (unused when no logger)
@@ -1032,14 +1045,6 @@ var APIGitLib = (() => {
         }
       }
     }
-    /**
-     * Proxy to shared fetchWithRetry implementation
-     * @param input RequestInfo
-     * @param init RequestInit
-     * @param attempts retry attempts
-     * @param baseDelay base delay ms
-     * @returns Promise resolving to Response
-     */
     /**
      * Normalize different header-like shapes into a plain object.
      * @param headerLike headers in Headers, array, or plain object form
@@ -1148,14 +1153,6 @@ var APIGitLib = (() => {
       const jitter = Math.floor(Math.random() * base * 0.3);
       return base + jitter;
     }
-    /**
-     * Delegate to shared mapWithConcurrency implementation
-     * @template T,R
-     * @param items items to map
-     * @param mapper async mapper
-     * @param concurrency concurrency limit
-     * @returns Promise resolving to mapped results
-     */
     /**
      * Map items with limited concurrency by delegating to the shared helper.
      * @template T,R
@@ -1263,12 +1260,6 @@ var APIGitLib = (() => {
         parents
       };
     }
-    /**
-     * コンテンツから sha1 を算出します。
-     * @param {string} content コンテンツ
-     * @returns {string} sha1 ハッシュ
-     */
-    // shaOf is inherited from AbstractGitAdapter
     /**
      * ブロブを作成またはキャッシュから取得します。
      * @param {any[]} changes 変更一覧（create/update を含む）
@@ -1283,11 +1274,6 @@ var APIGitLib = (() => {
         map[r.path] = r.sha;
       return map;
     }
-    /**
-     * ブロブ作成用のヘルパー（createBlobs から抽出）
-     * @param {any} ch 変更エントリ
-      * @returns {Promise<{path:string,sha:string}>}
-     */
     /**
      * Create a blob for a change or return cached blobSha.
      * @param {any} ch change entry
@@ -1494,10 +1480,6 @@ var APIGitLib = (() => {
       }
       throw new NonRetryableError("getRef: sha not found");
     }
-    /**
-     * Helper to fetch a ref URL and extract a SHA if present.
-     * Returns null when SHA not found.
-     */
     /**
      * Fetch a ref URL and extract a SHA if present.
      * @param {string} url API URL to fetch
@@ -1592,18 +1574,6 @@ var APIGitLib = (() => {
       const enc = index.encoding || "utf-8";
       return { content: index.content, encoding: enc };
     }
-    /**
-     * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
-     * Resolution order: branch -> tag -> commit endpoint -> treat as SHA
-     * Throws if resolution fails.
-     */
-    /**
-     * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
-     * Resolution order: branch -> tag -> commit endpoint -> treat as SHA
-     * Throws if resolution fails.
-     * @param {string} reference commit-ish to resolve
-     * @returns {Promise<string>} resolved commit SHA
-     */
     /**
      * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
      * Resolution order: branch -> tag -> commit endpoint -> treat as SHA
@@ -1643,11 +1613,6 @@ var APIGitLib = (() => {
       }
       return null;
     }
-    /**
-     * Try to resolve reference as a branch and return its sha.
-     * @param {string} reference branch name
-     * @returns {Promise<string|null>} resolved sha or null
-     */
     /**
      * Try to resolve a branch name to a commit SHA.
      * @param {string} reference branch name
@@ -1657,11 +1622,6 @@ var APIGitLib = (() => {
       const sha = await this.getRef(`heads/${reference}`);
       return sha || null;
     }
-    /**
-     * Try to resolve reference as a tag and return its sha.
-     * @param {string} reference tag name
-     * @returns {Promise<string|null>} resolved sha or null
-     */
     /**
      * Try to resolve a tag name to a commit SHA.
      * @param {string} reference tag name
@@ -1671,11 +1631,6 @@ var APIGitLib = (() => {
       const sha = await this.getRef(`tags/${reference}`);
       return sha || null;
     }
-    /**
-     * Try to resolve reference using commits endpoint (could be SHA or other form).
-     * @param {string} reference commit-ish
-     * @returns {Promise<string|null>} resolved sha or null
-     */
     /**
      * Try to resolve via commits endpoint (may accept SHA or other forms).
      * @param {string} reference commit-ish
@@ -1691,11 +1646,6 @@ var APIGitLib = (() => {
       }
       return null;
     }
-    /**
-     * Blob を取得して content を返す。取得失敗時は content=null を返す。
-     * @param {{sha:string,path:string}} f blob 情報
-     * @returns {Promise<{path:string,content:string|null}>}
-     */
     /**
      * Fetch a blob's content; return null content on failure.
      * @param {any} f blob metadata
@@ -1735,16 +1685,6 @@ var APIGitLib = (() => {
       }
       return safe;
     }
-    /**
-     * Fetch a blob's content; return null content on failure.
-     * @param {any} f blob metadata
-     * @returns {Promise<{path:string,content:string|null}>}
-     */
-    /**
-     * リポジトリのスナップショットを取得します。
-     * @param {string} branch ブランチ名 (default: 'main')
-      * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:Function,snapshot:Record<string,string>}>}
-     */
     /**
      * Fetch repository snapshot: headSha, shas map and a fetchContent helper.
      * @param {string} branch branch name
@@ -1819,22 +1759,6 @@ var APIGitLib = (() => {
         out[p] = content;
       return null;
     }
-    /**
-     * 指定パスのコンテンツを取得し、キャッシュと snapshot を更新します。
-     * @param {Map<string, any>} fileMap ファイルメタ情報マップ
-     * @param {Map<string, string>} contentCache キャッシュマップ
-     * @param {Record<string,string>} snapshot スナップショット出力マップ
-     * @param {string} p 取得対象パス
-     * @returns {Promise<string|null>} ファイル内容または null
-     */
-    /**
-     * Fetch single path content, update cache and snapshot.
-     * @param {Map<string, any>} fileMap file map
-     * @param {Map<string,string>} contentCache cache map
-     * @param {Record<string,string>} snapshot snapshot map
-     * @param {string} p path to fetch
-     * @returns {Promise<string|null>} content or null
-     */
     /**
      * Fetch single path content, update cache and snapshot.
      * @param {Map<string, any>} fileMap file map
@@ -1914,7 +1838,7 @@ var APIGitLib = (() => {
     }
     /**
      * GitLab のページングヘッダを解析します（x-next-page / x-total-pages）。
-      * @returns {{nextPage?: number, lastPage?: number}} ページ番号情報
+     * @returns {{nextPage?: number, lastPage?: number}} ページ番号情報
      */
     _parsePagingHeaders(resp) {
       const out = {};
@@ -1946,12 +1870,6 @@ var APIGitLib = (() => {
         parents
       };
     }
-    /**
-     * コンテンツから sha1 を算出します。
-     * @param {string} content コンテンツ
-     * @returns {string} sha1 ハッシュ
-     */
-    // shaOf is inherited from AbstractGitAdapter
     /**
      * 変更一覧から blob sha のマップを作成します（疑似実装）。
      * @param {any[]} changes 変更一覧
@@ -2031,9 +1949,6 @@ var APIGitLib = (() => {
       }
       return await this.postCommit(url, body);
     }
-    /**
-     * Retrieve project metadata (default branch, name, id) and cache it.
-     */
     /**
      * Retrieve project metadata (default branch, name, id) and cache it.
      * @returns {Promise<import('../virtualfs/types.ts').RepositoryMetadata>} repository metadata
@@ -2132,7 +2047,7 @@ var APIGitLib = (() => {
     }
     /**
      * Convert change descriptors to GitLab API actions
-      * @returns {Array<any>} API-compatible actions array
+     * @returns {Array<any>} API-compatible actions array
      */
     createActions(changes) {
       return changes.map((c) => {
@@ -2143,11 +2058,6 @@ var APIGitLib = (() => {
         return { action: "update", file_path: c.path, content: c.content };
       });
     }
-    /**
-     * Verify remote branch head matches expected parent SHA.
-     * @throws Error if non-fast-forward
-      * @returns {Promise<void>}
-     */
     /**
      * Verify that remote branch head matches expected parent SHA.
      * Throws when non-fast-forward detected.
@@ -2182,10 +2092,6 @@ var APIGitLib = (() => {
       }
       return index.id || index.commit || index;
     }
-    /**
-     * Post commit request and parse response
-      * @returns {Promise<any>}
-      */
     /**
      * Post commit request and return parsed commit response.
      * @param {string} url endpoint URL
@@ -2197,19 +2103,6 @@ var APIGitLib = (() => {
       const text = await response.text().catch(() => "");
       return this.parseCommitResponse(text);
     }
-    /**
-     * fetch をリトライ付きで実行します。
-     * @param {string} url リクエスト URL
-     * @param {RequestInit} opts fetch オプション
-     * @param {number} [retries] 最大リトライ回数
-     * @returns {Promise<Response>} レスポンス
-     */
-    // fetchWithRetry is provided by AbstractGitAdapter
-    /**
-     * Wait helper for fetch retry backoff.
-     * @param attempt Attempt number
-     * @returns {Promise<void>} resolves after backoff
-     */
     /**
      * Wait helper for retry backoff.
      * @param {number} attempt attempt number
@@ -2219,28 +2112,6 @@ var APIGitLib = (() => {
       const wait = this.backoffMs(attempt);
       await new Promise((r) => setTimeout(r, wait));
     }
-    /**
-     * ステータスが再試行対象か判定します。
-     * @param {number} status ステータスコード
-     * @returns {boolean}
-     */
-    // isRetryableStatus is provided by AbstractGitAdapter
-    /**
-     * バックオフ時間を計算します。
-     * @param {number} attempt 試行回数（1..）
-     * @returns {number} ミリ秒
-     */
-    // backoffMs provided by AbstractGitAdapter
-    // small concurrency mapper used for fetching files
-    /**
-     * 並列マッピングユーティリティ
-     * @template T, R
-     * @param {T[]} items 入力配列
-     * @param {(t:T)=>Promise<R>} mapper マッピング関数
-     * @param {number} concurrency 同時実行数
-     * @returns {Promise<R[]>}
-     */
-    // mapWithConcurrency provided by AbstractGitAdapter
     /**
      * Prepare JSON body for commit API call.
      * @returns {string} JSON body
@@ -2248,9 +2119,6 @@ var APIGitLib = (() => {
     _prepareCommitBody(branch, message, actions) {
       return JSON.stringify({ branch, commit_message: message, actions });
     }
-    /**
-     * Optionally verify parent SHA; swallow non-422 errors.
-     */
     /**
      * Optionally verify parent SHA; rethrow errors after logging.
      * @param {string} expectedParentSha expected SHA
@@ -2269,7 +2137,7 @@ var APIGitLib = (() => {
     /**
      * リポジトリのスナップショットを取得します。
      * @param {string} branch ブランチ名 (default: 'main')
-    * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:(paths:string[])=>Promise<Record<string,string>>}>}
+     * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:(paths:string[])=>Promise<Record<string,string>>}>}
      */
     async fetchSnapshot(branch = "main", concurrency = 5) {
       const headSha = await this._determineHeadSha(branch);
@@ -2279,11 +2147,6 @@ var APIGitLib = (() => {
       const fetchContent = (paths) => this._fetchContentFromFileSet(fileSet, cache, snapshot, paths, branch, concurrency);
       return { headSha, shas, fetchContent, snapshot };
     }
-    /**
-     * Determine the remote head SHA for a branch. Falls back to branch name on error.
-     * @param {string} branch Branch name
-     * @returns {Promise<string>} head SHA or branch
-     */
     /**
      * Determine the head SHA for a branch; fallback to branch name if unavailable.
      * @param {string} branch branch name
@@ -2306,11 +2169,6 @@ var APIGitLib = (() => {
       }
       return branch;
     }
-    /**
-     * Fetch repository tree and build shas/fileSet.
-     * @param {string} branch Branch name
-     * @returns {Promise<{shas:Record<string,string>,fileSet:Set<string>}>}
-     */
     /**
      * Fetch repository tree and build shas map and fileSet.
      * @param {string} branch branch name
@@ -2322,10 +2180,6 @@ var APIGitLib = (() => {
       const files = Array.isArray(treeJ) ? treeJ.filter((t) => t.type === "blob") : [];
       return this._buildShasAndFileSet(files);
     }
-    /**
-     * Helper to fetch files from the repository tree with caching and concurrency.
-      * @returns {Promise<Record<string,string>>}
-     */
     /**
      * Fetch contents for requested paths from a FileSet with caching.
      * @param {Set<string>} fileSet set of available files
@@ -2347,14 +2201,6 @@ var APIGitLib = (() => {
       }, concurrency);
       return out;
     }
-    /**
-     * 指定パスのファイル内容を取得し、キャッシュと snapshot を更新します。
-     * @param {Map<string,string>} cache キャッシュマップ
-     * @param {Record<string,string>} snapshot スナップショットマップ
-     * @param {string} p ファイルパス
-     * @param {string} branch ブランチ名
-     * @returns {Promise<string|null>} ファイル内容または null
-     */
     /**
      * Fetch the content for a single file path, updating cache and snapshot.
      * @param {Map<string,string>} cache cache map
@@ -2377,12 +2223,6 @@ var APIGitLib = (() => {
       }
       return null;
     }
-    /**
-     * ファイルの raw コンテンツを取得して返します。失敗時は null を返します。
-     * @param {string} path ファイルパス
-     * @param {string} branch ブランチ名
-      * @returns {Promise<string|null>} ファイル内容または null
-     */
     /**
      * Fetch raw file content from GitLab; return null on failure.
      * @param {string} path file path
@@ -2404,7 +2244,6 @@ var APIGitLib = (() => {
         return null;
       }
     }
-    /** Build shas map and fileSet from tree entries */
     /**
      * Build shas map and fileSet from tree entries
      * @returns {{shas:Record<string,string>,fileSet:Set<string>}}
@@ -2421,18 +2260,6 @@ var APIGitLib = (() => {
       }
       return { shas, fileSet };
     }
-    /**
-     * Resolve a commit-ish (branch name, tag name, or SHA) to a commit SHA.
-     * Resolution order: branch -> tag -> commits endpoint -> treat as SHA
-     * Throws if not resolvable.
-     */
-    /**
-     * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
-     * Resolution order: branch -> tag -> commits endpoint -> treat as SHA
-     * Throws if not resolvable.
-     * @param {string} reference commit-ish to resolve
-     * @returns {Promise<string>} resolved commit SHA
-     */
     /**
      * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
      * Resolution order: branch -> tag -> commits endpoint -> treat as SHA
@@ -3536,7 +3363,7 @@ var APIGitLib = (() => {
     /**
      * Read and parse the stored info entry for `path`.
      * Returns parsed object or null when missing/invalid.
-      * @returns {Promise<any|null>} parsed object or null
+     * @returns {Promise<any|null>} parsed object or null
      */
     async _readInfoEntry(path) {
       try {
@@ -3559,7 +3386,7 @@ var APIGitLib = (() => {
     /**
      * Attempt to fetch base content using adapterInstance.getBlob.
      * Returns string when fetched, null when fetch attempted but failed, or undefined when adapter not supported.
-      * @returns {Promise<string|null|undefined>} fetched content, null, or undefined
+     * @returns {Promise<string|null|undefined>} fetched content, null, or undefined
      */
     async _tryFetchBaseWithAdapter(adapterInstance, baseSha, path) {
       if (!adapterInstance || typeof adapterInstance.getBlob !== "function")
@@ -3595,7 +3422,7 @@ var APIGitLib = (() => {
     /**
      * Attempt to fetch raw file using adapterInstance._fetchFileRaw if available.
      * Returns string when fetched, null when attempted but failed, or undefined when adapter not supported.
-      * @returns {Promise<string|null|undefined>} fetched content, null, or undefined
+     * @returns {Promise<string|null|undefined>} fetched content, null, or undefined
      */
     async _tryFetchRawFile(adapterInstance, path, ie) {
       if (!adapterInstance || typeof adapterInstance._fetchFileRaw !== "function")
@@ -3703,7 +3530,7 @@ var APIGitLib = (() => {
       if (options?.backend)
         this.backend = options.backend;
       else
-        this.backend = new OpfsStorage();
+        this.backend = new OpfsStorage("default");
       if (options && options.logger)
         this.logger = options.logger;
       this.applier = new LocalChangeApplier(this.backend);
@@ -3743,22 +3570,6 @@ var APIGitLib = (() => {
     set lastCommitKey(k) {
       this.indexManager.setLastCommitKey(k);
     }
-    /**
-     * SHA-1 helper wrapper (delegates to ./hashUtils)
-     * @param {string} content - ハッシュ対象の文字列
-     * @returns {Promise<string>} SHA-1 ハッシュの16進表現
-     */
-    async shaOf(content) {
-      return await shaOf2(content);
-    }
-    /**
-     * SHA helper for Git blob formatting
-     * @param {string} content - blob コンテンツ
-     * @returns {Promise<string>} SHA-1 ハッシュの16進表現（git blob 用）
-     */
-    async shaOfGitBlob(content) {
-      return await shaOfGitBlob(content);
-    }
     /**
      * VirtualFS の初期化を行います（バックエンド初期化と index 読み込み）。
      * @returns {Promise<void>}
@@ -3898,6 +3709,312 @@ var APIGitLib = (() => {
       }
       return null;
     }
+    /**
+     * Helper: obtain backend listFilesRaw in a safe manner.
+     * @returns {Promise<any[]>}
+     */
+    async _getBackendFilesRaw() {
+      try {
+        if (this.backend && typeof this.backend.listFilesRaw === "function") {
+          return await this.backend.listFilesRaw();
+        }
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("_getBackendFilesRaw failed", error);
+      }
+      return [];
+    }
+    /**
+     * Helper: apply parsed info text into stats object when possible.
+     * @param infoTxt raw info text
+     * @param stats stats object to mutate
+     * @returns {void}
+     */
+    _applyInfoTxtToStats(infoTxt, stats) {
+      if (!infoTxt)
+        return;
+      try {
+        const info = JSON.parse(infoTxt);
+        if (typeof info.baseSha === "string")
+          stats.gitBlobSha = info.baseSha;
+        if (typeof info.updatedAt === "number")
+          stats.mtime = new Date(info.updatedAt);
+        if (typeof info.size === "number")
+          stats.size = info.size;
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("parse info failed", error);
+      }
+    }
+    /**
+     * Find a matched backend entry for the given filepath.
+     * @param filepath target filepath
+     * @param filesRaw backend raw listing
+     * @returns {any|null}
+     */
+    _findMatchedFile(filepath, filesRaw) {
+      if (!Array.isArray(filesRaw))
+        return null;
+      return filesRaw.find((f) => {
+        if (!f || !f.path)
+          return false;
+        return f.path === filepath || f.path.endsWith("/" + filepath) || f.path.endsWith("/" + filepath);
+      });
+    }
+    /**
+     * Create default stats object with consistent shape.
+     * @param now current Date
+     * @returns {any}
+     */
+    _createDefaultStats(now) {
+      return {
+        dev: 0,
+        ino: 0,
+        mode: 33188,
+        nlink: 1,
+        uid: 0,
+        gid: 0,
+        rdev: 0,
+        size: 0,
+        blksize: void 0,
+        blocks: void 0,
+        atime: now,
+        mtime: now,
+        ctime: now,
+        birthtime: now,
+        /** @returns {boolean} */
+        isFile: () => true,
+        /** @returns {boolean} */
+        isDirectory: () => false
+      };
+    }
+    /**
+     * Populate stats.gitCommitSha from adapterMeta if available.
+     * @param stats stats object to mutate
+     * @returns {void}
+     */
+    _populateCommitShaFromMeta(stats) {
+      if (!stats.gitCommitSha && this.adapterMeta && this.adapterMeta.opts && this.adapterMeta.opts.branch) {
+        stats.gitCommitSha = this.adapterMeta.opts.branch;
+      }
+    }
+    /**
+     * Try to resolve commit SHA from an instantiated adapter when needed.
+     * @param stats stats object to mutate
+     * @returns {Promise<void>}
+     */
+    async _resolveCommitShaFromAdapter(stats) {
+      const instAdapter = await this._safeGetAdapterInstance();
+      if (!instAdapter || stats.gitCommitSha)
+        return;
+      if (typeof instAdapter.resolveRef !== "function")
+        return;
+      try {
+        const branch = this.adapterMeta && this.adapterMeta.opts && this.adapterMeta.opts.branch || "main";
+        const resolved = await instAdapter.resolveRef(branch);
+        if (resolved)
+          stats.gitCommitSha = resolved;
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("_resolveCommitShaFromAdapter resolveRef failed", error);
+      }
+    }
+    /**
+     * Safely get adapter instance, returning null on error.
+     * @returns {Promise<any|null>}
+     */
+    async _safeGetAdapterInstance() {
+      try {
+        return await this.getAdapterInstance();
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("_safeGetAdapterInstance failed", error);
+        return null;
+      }
+    }
+    /**
+     * Helper: populate stats.gitCommitSha using adapterMeta or adapter.resolveRef when available.
+     * @param stats stats object to mutate
+     * @returns {Promise<void>}
+     */
+    async _resolveAdapterCommitShaIfNeeded(stats) {
+      this._populateCommitShaFromMeta(stats);
+      if (!stats.gitCommitSha)
+        await this._resolveCommitShaFromAdapter(stats);
+    }
+    /**
+     * Determine whether a normalized path is an exact file entry in the provided entries.
+     * @param normalizedDirectory normalized directory string
+     * @param keys index keys array
+     * @param entries index entries object
+     * @returns {boolean}
+     */
+    _isExactFile(normalizedDirectory, keys, entries) {
+      return keys.includes(normalizedDirectory) && entries[normalizedDirectory] && entries[normalizedDirectory].state !== "deleted";
+    }
+    /**
+     * Collect immediate child names from index entries for given directory.
+     * @param normalizedDirectory normalized directory string
+     * @param entries index entries object
+     * @returns {Set<string>} set of immediate child names
+     */
+    _collectNamesFromIndex(normalizedDirectory, entries) {
+      const outNames = /* @__PURE__ */ new Set();
+      const keys = Object.keys(entries || {});
+      for (const k of keys) {
+        const v = entries[k];
+        if (v && v.state === "deleted")
+          continue;
+        if (normalizedDirectory === "." || normalizedDirectory === "") {
+          this._collectNamesFromIndexRoot(k, outNames);
+          continue;
+        }
+        this._processIndexKeyForDirectory(k, normalizedDirectory, outNames);
+      }
+      return outNames;
+    }
+    /**
+     * Process a single index key for a non-root directory and add immediate child when applicable.
+     * @param key index key
+     * @param normalizedDirectory normalized directory string
+     * @param outNames set to mutate
+     * @returns {void}
+     */
+    _processIndexKeyForDirectory(key, normalizedDirectory, outNames) {
+      if (key === normalizedDirectory)
+        return;
+      if (key.startsWith(normalizedDirectory + "/")) {
+        const rest = key.slice(normalizedDirectory.length + 1);
+        const first = rest.indexOf("/") === -1 ? rest : rest.slice(0, rest.indexOf("/"));
+        outNames.add(first);
+      }
+    }
+    /**
+     * Safe wrapper for backend.listFiles returning [] on failure.
+     * @param normalizedDirectory directory path
+     * @returns {Promise<any[]>}
+     */
+    async _getBackendList(normalizedDirectory) {
+      try {
+        return await this.backend.listFiles(normalizedDirectory, void 0, false);
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("_getBackendList failed", error);
+        return [];
+      }
+    }
+    /**
+     * Helper for collecting names when scanning root directory entries.
+     * @param key index key
+     * @param outNames set to mutate
+     * @returns {void}
+     */
+    _collectNamesFromIndexRoot(key, outNames) {
+      const first = key.indexOf("/") === -1 ? key : key.slice(0, key.indexOf("/"));
+      outNames.add(first);
+    }
+    /**
+     * Check whether normalizedDirectory corresponds to an exact file entry.
+     * @param normalizedDirectory normalized directory string
+     * @param entries index entries object
+     * @returns {boolean}
+     */
+    _hasExactEntry(normalizedDirectory, entries) {
+      const keys = Object.keys(entries || {});
+      return this._isExactFile(normalizedDirectory, keys, entries);
+    }
+    /**
+     * Consult backend.listFiles to collect immediate child names for given directory.
+     * Best-effort: logs and returns empty set on failure.
+     * @param normalizedDirectory normalized directory string
+     * @returns {Promise<Set<string>>}
+     */
+    async _collectNamesFromBackend(normalizedDirectory) {
+      const outNames = /* @__PURE__ */ new Set();
+      if (!this._backendSupportsListFiles())
+        return outNames;
+      const backendList = await this._getBackendList(normalizedDirectory);
+      if (!Array.isArray(backendList) || backendList.length === 0)
+        return outNames;
+      for (const it of backendList)
+        this._processBackendEntry(it, normalizedDirectory, outNames);
+      return outNames;
+    }
+    /**
+     * Return true when backend supports listFiles
+     * @returns {boolean}
+     */
+    _backendSupportsListFiles() {
+      return !!(this.backend && typeof this.backend.listFiles === "function");
+    }
+    /**
+     * Process a single backend listFiles entry and add immediate child name to outNames when applicable.
+     * @param it backend entry
+     * @param normalizedDirectory normalized directory string
+     * @param outNames set to mutate
+     * @returns {void}
+     */
+    _processBackendEntry(it, normalizedDirectory, outNames) {
+      try {
+        if (!it || !it.path)
+          return;
+        const p = it.path;
+        if (p === normalizedDirectory)
+          return;
+        if (p.startsWith(normalizedDirectory + "/")) {
+          const rest = p.slice(normalizedDirectory.length + 1);
+          const first = rest.indexOf("/") === -1 ? rest : rest.slice(0, rest.indexOf("/"));
+          outNames.add(first);
+        }
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("_processBackendEntry failed", error);
+      }
+    }
+    /**
+     * Build Dirent-like lightweight objects for given names.
+     * @param names array of names
+     * @param keys array of index keys
+     * @param entries index entries object
+     * @param normalizedDirectory normalized directory string
+     * @returns {Array<any>} array of Dirent-like objects
+     */
+    _buildDirentTypes(names, keys, entries, normalizedDirectory) {
+      const out = [];
+      for (const name of names) {
+        const childPath = normalizedDirectory === "." ? name : `${normalizedDirectory}/${name}`;
+        const { isFile, isDirectory } = this._determineChildType(childPath, keys, entries);
+        const _isFileFunction = function() {
+          return isFile && !isDirectory;
+        };
+        const _isDirectoryFunction = function() {
+          return isDirectory;
+        };
+        out.push({ name, isFile: _isFileFunction, isDirectory: _isDirectoryFunction });
+      }
+      return out;
+    }
+    /**
+     * Determine whether a childPath corresponds to a file, directory, or both.
+     * @param childPath path of child
+     * @param keys index keys
+     * @param entries index entries
+     * @returns {{isFile:boolean,isDirectory:boolean}}
+     */
+    _determineChildType(childPath, keys, entries) {
+      let isDirectory = false;
+      let isFile = false;
+      for (const k of keys) {
+        if (k === childPath && entries[k] && entries[k].state !== "deleted") {
+          isFile = true;
+        }
+        if (k.startsWith(childPath + "/")) {
+          isDirectory = true;
+          break;
+        }
+      }
+      return { isFile, isDirectory };
+    }
     /**
      * Return persisted adapter metadata (if any).
      * @returns {any|null}
@@ -3915,15 +4032,6 @@ var APIGitLib = (() => {
       await this.localFileManager.writeFile(filepath, content);
       await this.loadIndex();
     }
-    /**
-     * ファイルを削除します（トゥームストーン作成を含む）。
-     * @param {string} filepath ファイルパス
-     * @returns {Promise<void>}
-     */
-    async deleteFile(filepath) {
-      await this.localFileManager.deleteFile(filepath);
-      await this.loadIndex();
-    }
     /**
      * rename を delete + create の合成で行うヘルパ
      * @param from 元パス
@@ -3934,7 +4042,7 @@ var APIGitLib = (() => {
       if (content === null)
         throw new Error("source not found");
       await this.writeFile(to, content);
-      await this.deleteFile(from);
+      await this.unlink(from);
     }
     /**
      * ワークスペース/ベースからファイル内容を読み出します。
@@ -3951,7 +4059,9 @@ var APIGitLib = (() => {
           await this.remoteSynchronizer.fetchBaseIfMissing(filepath, adapter);
           content = await this.localFileManager.readFile(filepath);
         }
-      } catch {
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("readFile on-demand fetch failed", error);
       }
       return content;
     }
@@ -3963,6 +4073,151 @@ var APIGitLib = (() => {
     async readConflict(filepath) {
       return await this.conflictManager.readConflict(filepath);
     }
+    /**
+     * fs.stat 互換: 指定ファイルのメタ情報を返す
+     * ワークスペース上の情報を優先し、未取得時は Git のメタ情報で補完する。
+     * @returns {Promise<any>} stats オブジェクト
+     */
+    async stat(filepath) {
+      if (!filepath || typeof filepath !== "string")
+        throw new TypeError("filepath is required");
+      const filesRaw = await this._getBackendFilesRaw();
+      const matched = this._findMatchedFile(filepath, filesRaw);
+      const now = /* @__PURE__ */ new Date();
+      const stats = this._createDefaultStats(now);
+      try {
+        const infoTxt = await this.backend.readBlob(filepath, "info");
+        this._applyInfoTxtToStats(infoTxt, stats);
+      } catch (error) {
+        if (typeof console !== "undefined" && console.debug)
+          console.debug("stat readBlob failed", error);
+      }
+      if (matched) {
+        stats.workspacePath = matched.path;
+      }
+      await this._resolveAdapterCommitShaIfNeeded(stats);
+      return stats;
+    }
+    /**
+     * fs.unlink 互換: ファイルを削除する
+     */
+    async unlink(filepath) {
+      if (!filepath || typeof filepath !== "string")
+        throw new TypeError("filepath is required");
+      await this.localFileManager.deleteFile(filepath);
+      await this.loadIndex();
+    }
+    /**
+     * fs.mkdir 互換 (簡易実装): workspace 側にディレクトリ情報を書き込む
+     */
+    async mkdir(dirpath, _options) {
+      if (!dirpath || typeof dirpath !== "string")
+        throw new TypeError("dirpath is required");
+      const info = { path: dirpath, state: "dir", createdAt: Date.now() };
+      if (this.backend && typeof this.backend.writeBlob === "function") {
+        await this.backend.writeBlob(dirpath, JSON.stringify(info), "info-workspace").catch((error) => {
+          throw Object.assign(new Error("\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u4F5C\u6210\u5931\u6557"), { code: "EEXIST", cause: error });
+        });
+      }
+    }
+    /**
+     * fs.rmdir 互換 (簡易実装)
+     */
+    async rmdir(dirpath, options) {
+      if (!dirpath || typeof dirpath !== "string")
+        throw new TypeError("dirpath is required");
+      const children = await this._listChildrenOfDir(dirpath);
+      if (children.length > 0 && !(options && options.recursive)) {
+        const errorObject = new Error("Directory not empty");
+        errorObject.code = "ENOTEMPTY";
+        throw errorObject;
+      }
+      if (options && options.recursive)
+        await this._deleteChildrenRecursive(children);
+    }
+    /**
+     * Return list of child paths for given dirpath based on index entries.
+     * @param dirpath directory path
+     * @returns {Promise<string[]>}
+     */
+    async _listChildrenOfDir(dirpath) {
+      const paths = await this.listPaths();
+      return paths.filter((p) => p === dirpath || p.startsWith(dirpath + "/"));
+    }
+    /**
+     * Delete array of children using localFileManager, logging failures per-child.
+     * @param children array of paths
+     * @returns {Promise<void>}
+     */
+    async _deleteChildrenRecursive(children) {
+      for (const p of children) {
+        try {
+          await this.localFileManager.deleteFile(p);
+        } catch (error) {
+          if (typeof console !== "undefined" && console.debug)
+            console.debug("rmdir recursive delete failed for", p, error);
+        }
+      }
+    }
+    /**
+     * fs.readdir 互換 (簡易実装)
+     * @returns {Promise<string[]|Array<any>>}
+     */
+    async readdir(dirpath, options) {
+      if (!dirpath || typeof dirpath !== "string")
+        throw new TypeError("dirpath is required");
+      const index = await this.indexManager.getIndex();
+      const entries = index && index.entries || {};
+      const keys = Object.keys(entries);
+      const names = await this._gatherDirectoryNames(dirpath, entries, keys);
+      const maybeEmpty = this._returnIfNoNames(names, options);
+      if (maybeEmpty !== null)
+        return maybeEmpty;
+      const normalizedDirectory = dirpath === "" ? "." : dirpath;
+      if (options && options.withFileTypes)
+        return this._buildDirentTypes(names, keys, entries, normalizedDirectory);
+      return names;
+    }
+    /**
+     * Return an empty array when names is empty according to options, else null to continue.
+     * @param names array of names
+     * @param options readdir options
+     * @returns {Array<any>|null}
+     */
+    _returnIfNoNames(names, options) {
+      if (!names || names.length === 0)
+        return options && options.withFileTypes ? [] : [];
+      return null;
+    }
+    /**
+     * Gather immediate child names for a directory using index and backend as fallback.
+     * Throws ENOTDIR when the path represents a file.
+     * @param dirpath original directory path
+     * @param entries index entries object
+     * @param keys array of index keys
+     * @returns {Promise<string[]>} immediate child names
+     */
+    async _gatherDirectoryNames(dirpath, entries, keys) {
+      const normalizedDirectory = dirpath === "" ? "." : dirpath;
+      const outNames = /* @__PURE__ */ new Set();
+      const isExactFile = this._isExactFile(normalizedDirectory, keys, entries);
+      const indexNames = this._collectNamesFromIndex(normalizedDirectory, entries);
+      for (const n of indexNames)
+        outNames.add(n);
+      if (outNames.size === 0 && normalizedDirectory !== "." && !isExactFile) {
+        const backendNames = await this._collectNamesFromBackend(normalizedDirectory);
+        for (const n of backendNames)
+          outNames.add(n);
+      }
+      if (isExactFile && outNames.size === 0) {
+        const errorObject = new Error("\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u3067\u306F\u3042\u308A\u307E\u305B\u3093");
+        errorObject.code = "ENOTDIR";
+        throw errorObject;
+      }
+      if (outNames.size === 0)
+        return [];
+      return Array.from(outNames);
+    }
     /**
      * 指定パスのリモート衝突ファイル (.git-conflict/) を削除して
      * 競合を解消済とマークします。
@@ -4006,12 +4261,9 @@ var APIGitLib = (() => {
       const entries = index && index.entries || {};
       const out = [];
       for (const k of Object.keys(entries)) {
-        try {
-          const v = entries[k];
-          if (v && v.state === "deleted")
-            continue;
-        } catch {
-        }
+        const v = entries[k];
+        if (v && v.state === "deleted")
+          continue;
         out.push(k);
       }
       return out;
@@ -4067,7 +4319,9 @@ var APIGitLib = (() => {
       if (input.parentSha && typeof adapter.getCommitTreeSha === "function") {
         try {
           baseTreeSha = await adapter.getCommitTreeSha(input.parentSha);
-        } catch {
+        } catch (error) {
+          if (typeof console !== "undefined" && console.debug)
+            console.debug("getCommitTreeSha failed, continuing without baseTree", error);
           baseTreeSha = void 0;
         }
       }
@@ -4226,7 +4480,7 @@ apigit-commit-key:${input.commitKey}`;
     /**
      * Persist the requested branch into adapter metadata (best-effort).
      * @param {string} branch branch name to persist
-      * @returns {Promise<void>}
+     * @returns {Promise<void>}
      */
     async _persistAdapterBranchMeta(branch, adapterInstance) {
       const meta = this.adapterMeta && this.adapterMeta.opts ? { ...this.adapterMeta } : await this.getAdapter();
@@ -4430,7 +4684,7 @@ apigit-commit-key:${input.commitKey}`;
     /**
      * Convenience to get default branch name from adapter repository metadata.
      * Returns null when adapter not available.
-      * @returns {Promise<string|null>}
+     * @returns {Promise<string|null>}
      */
     async getDefaultBranch() {
       const instAdapter = await this.getAdapterInstance();
@@ -4470,11 +4724,6 @@ apigit-commit-key:${input.commitKey}`;
           console.debug("persist repository metadata aborted", error);
       }
     }
-    /**
-     * Normalize a resolved descriptor (string headSha or object) into a
-     * RemoteSnapshotDescriptor or null. Helper to reduce cognitive complexity.
-      * @returns {Promise<RemoteSnapshotDescriptor|null>} 正規化された descriptor または null
-     */
     /**
      * Try persisting repository metadata when available. Best-effort.
      * @param instAdapter adapter instance or null
@@ -4578,7 +4827,7 @@ apigit-commit-key:${input.commitKey}`;
         input.changes = await this.getChangeSet();
       }
       if (!input.commitKey) {
-        input.commitKey = await this.shaOf((input.parentSha || "") + JSON.stringify(input.changes));
+        input.commitKey = await shaOf2((input.parentSha || "") + JSON.stringify(input.changes));
       }
       const instAdapter = await this.getAdapterInstance();
       if (!instAdapter) {
@@ -4607,7 +4856,7 @@ apigit-commit-key:${input.commitKey}`;
   var IndexedDatabaseStorage = class IndexedDatabaseStorage2 {
     /**
      * 環境に IndexedDB が存在するかを同期検査します。
-      * @returns {boolean} 利用可能なら true
+     * @returns {boolean} 利用可能なら true
      */
     static canUse() {
       try {
@@ -4619,6 +4868,8 @@ apigit-commit-key:${input.commitKey}`;
     dbName;
     dbPromise;
     currentBranch = null;
+    root;
+    rootPrefix = "";
     static VAR_WORKSPACE_BASE = "workspace";
     // Historically this was a separate workspace-info store, but some test
     // fakes expect info entries to be available in 'git-info'. Alias the
@@ -4632,7 +4883,7 @@ apigit-commit-key:${input.commitKey}`;
     /** 利用可能な DB 名の一覧を返す
      * @returns {string[]} available root names
      */
-    static async availableRoots() {
+    static async availableRoots(namespace) {
       const g = globalThis;
       const idb = g.indexedDB;
       if (!idb)
@@ -4640,7 +4891,12 @@ apigit-commit-key:${input.commitKey}`;
       if (typeof idb.databases !== "function")
         return [];
       try {
-        return await IndexedDatabaseStorage2._namesFromDatabases(idb);
+        const names = await IndexedDatabaseStorage2._namesFromDatabases(idb);
+        if (!namespace)
+          return names;
+        if (names.includes(namespace))
+          return ["apigit_storage"];
+        return [];
       } catch {
         return [];
       }
@@ -4660,8 +4916,10 @@ apigit-commit-key:${input.commitKey}`;
       return Array.from(new Set(names));
     }
     /** コンストラクタ */
-    constructor(root) {
-      this.dbName = root ?? IndexedDatabaseStorage2.DEFAULT_DB_NAME;
+    constructor(namespace, _root) {
+      this.dbName = namespace || IndexedDatabaseStorage2.DEFAULT_DB_NAME;
+      this.root = _root || void 0;
+      this.rootPrefix = this.root ? `${this.root}_` : "";
       this.dbPromise = this.openDb();
     }
     /**
@@ -4693,27 +4951,26 @@ apigit-commit-key:${input.commitKey}`;
      */
     /**
      * Handle DB upgrade event and create required object stores.
-     * @param ev Upgrade event
+     * Creates the object stores used by this backend, names are resolved
+     * through `_storeName` to include any configured `_root` prefix.
+     * @param {Event} event - Upgrade event from `indexedDB.open`
      * @returns {void}
      */
     _handleUpgrade(event) {
       const database = event.target.result;
-      if (!database.objectStoreNames.contains(IndexedDatabaseStorage2.VAR_WORKSPACE_BASE))
-        database.createObjectStore(IndexedDatabaseStorage2.VAR_WORKSPACE_BASE);
-      if (!database.objectStoreNames.contains(IndexedDatabaseStorage2.VAR_WORKSPACE_INFO))
-        database.createObjectStore(IndexedDatabaseStorage2.VAR_WORKSPACE_INFO);
-      if (!database.objectStoreNames.contains(IndexedDatabaseStorage2.VAR_BASE))
-        database.createObjectStore(IndexedDatabaseStorage2.VAR_BASE);
-      if (!database.objectStoreNames.contains(IndexedDatabaseStorage2.VAR_CONFLICT))
-        database.createObjectStore(IndexedDatabaseStorage2.VAR_CONFLICT);
-      if (!database.objectStoreNames.contains(IndexedDatabaseStorage2.VAR_INFO))
-        database.createObjectStore(IndexedDatabaseStorage2.VAR_INFO);
-      if (!database.objectStoreNames.contains("index"))
-        database.createObjectStore("index");
+      if (!database.objectStoreNames.contains(this._storeName(IndexedDatabaseStorage2.VAR_WORKSPACE_BASE)))
+        database.createObjectStore(this._storeName(IndexedDatabaseStorage2.VAR_WORKSPACE_BASE));
+      if (!database.objectStoreNames.contains(this._storeName(IndexedDatabaseStorage2.VAR_WORKSPACE_INFO)))
+        database.createObjectStore(this._storeName(IndexedDatabaseStorage2.VAR_WORKSPACE_INFO));
+      if (!database.objectStoreNames.contains(this._storeName(IndexedDatabaseStorage2.VAR_BASE)))
+        database.createObjectStore(this._storeName(IndexedDatabaseStorage2.VAR_BASE));
+      if (!database.objectStoreNames.contains(this._storeName(IndexedDatabaseStorage2.VAR_CONFLICT)))
+        database.createObjectStore(this._storeName(IndexedDatabaseStorage2.VAR_CONFLICT));
+      if (!database.objectStoreNames.contains(this._storeName(IndexedDatabaseStorage2.VAR_INFO)))
+        database.createObjectStore(this._storeName(IndexedDatabaseStorage2.VAR_INFO));
+      if (!database.objectStoreNames.contains(this._storeName("index")))
+        database.createObjectStore(this._storeName("index"));
     }
-    /**
-     * 指定 DB に対する onversionchange ハンドラを生成します。
-     */
     /**
      * Create a handler to close DB on version change.
      * @param dbParam Target DB
@@ -4724,9 +4981,6 @@ apigit-commit-key:${input.commitKey}`;
         databaseParameter.close();
       };
     }
-    /**
-     * DB open の成功ハンドラ
-     */
     /**
      * Called when DB open succeeds.
      * @param req IDB open request
@@ -4738,9 +4992,6 @@ apigit-commit-key:${input.commitKey}`;
       database.onversionchange = this._makeVersionChangeHandler(database);
       resolve(database);
     }
-    /**
-     * DB open のエラーハンドラ
-     */
     /**
      * Called when DB open errors.
      * @param req IDB open request
@@ -4750,22 +5001,19 @@ apigit-commit-key:${input.commitKey}`;
     _onOpenError(request, reject) {
       reject(request.error);
     }
-    /**
-     * トランザクションラッパー。cb 内の処理をトランザクションで実行し、
-     * 必要なら再試行します。
-     */
     /**
      * トランザクションラッパー。cb 内の処理をトランザクションで実行し、必要なら再試行します。
      * @returns {Promise<void>} トランザクション処理完了時に解決
      */
     async tx(storeName, mode, callback) {
+      const physical = this._storeName(storeName);
       try {
-        return await this._performTxAttempt(storeName, mode, callback);
+        return await this._performTxAttempt(physical, mode, callback);
       } catch (error) {
         const isInvalidState = error && (error.name === "InvalidStateError" || /closing/i.test(String(error.message || "")));
         if (isInvalidState) {
           this.dbPromise = this.openDb();
-          return await this._performTxAttempt(storeName, mode, callback);
+          return await this._performTxAttempt(physical, mode, callback);
         }
         throw error;
       }
@@ -4862,10 +5110,6 @@ apigit-commit-key:${input.commitKey}`;
         return orig.apply(target, arguments_);
       };
     }
-    /**
-     * Schedule a microtask to invoke tx.oncomplete in case fake IndexedDB
-     * implementations never fire it.
-     */
     /**
      * Schedule a microtask to invoke tx.oncomplete in case fake IndexedDB
      * implementations never fire it.
@@ -4881,7 +5125,6 @@ apigit-commit-key:${input.commitKey}`;
         }
       }, 0);
     }
-    // legacy canUseOpfs removed; use static canUse() instead
     /**
      * index を読み出す
      * @returns {Promise<IndexFile|null>} 読み出した IndexFile、存在しなければ null
@@ -4913,10 +5156,6 @@ apigit-commit-key:${input.commitKey}`;
         this.currentBranch = null;
       }
     }
-    /**
-     * Apply metadata to result. @returns void
-     * @returns {void}
-     */
     /**
      * Load workspace-local info entries into result.entries (workspace overrides branch-scoped)
      * @param result IndexFile being populated
@@ -4971,8 +5210,9 @@ apigit-commit-key:${input.commitKey}`;
     async _readIndexMeta(database) {
       return await new Promise((resolve) => {
         try {
-          const tx = database.transaction("index", "readonly");
-          const store = tx.objectStore("index");
+          const indexName = this._storeName("index");
+          const tx = database.transaction(indexName, "readonly");
+          const store = tx.objectStore(indexName);
           const request = store.get("index");
           request.onsuccess = () => {
             resolve(request.result ?? null);
@@ -5152,14 +5392,7 @@ apigit-commit-key:${input.commitKey}`;
       return await this._getFromStore(storeName, key);
     }
     /**
-     * Read blob when a segment is provided. Handles info-workspace/info-git/info and other segments.
-     * @param segment Segment name
-     * @param filepath Path to read
-     * @param branch Current branch
-     * @returns {Promise<string|null>} blob content or null
-     */
-    /**
-             * blob を削除する
+     * blob を削除する
      * @returns {Promise<void>} 削除完了時に解決
      */
     async deleteBlob(filepath, segment) {
@@ -5210,10 +5443,6 @@ apigit-commit-key:${input.commitKey}`;
       }
       return toWrite;
     }
-    /**
-     * Gather entries that should be written to workspace-info: those that exist in workspace-base.
-     * @returns {Promise<Array<{k:string,v:any}>>}
-     */
     /**
      * Compute store name and key for a given segment and filepath.
      * @returns {{storeName:string,key:string}}
@@ -5223,10 +5452,6 @@ apigit-commit-key:${input.commitKey}`;
       const key = seg === "workspace" ? filepath : seg === "conflictBlob" ? `${branch}::conflictBlob::${filepath}` : `${branch}::${filepath}`;
       return { storeName, key };
     }
-    /**
-     * Compute store name and key for a given segment and filepath.
-     * @returns {{storeName:string,key:string}}
-     */
     /**
      * Delete a filepath from all relevant stores for the given branch.
      * @returns {Promise<void>}
@@ -5239,10 +5464,6 @@ apigit-commit-key:${input.commitKey}`;
       await this._deleteFromStore(IndexedDatabaseStorage2.VAR_INFO, filepath);
       await this._deleteFromStore(IndexedDatabaseStorage2.VAR_WORKSPACE_INFO, filepath);
     }
-    /**
-     * Delete a filepath from all relevant stores for the given branch.
-     * @returns {Promise<void>}
-     */
     /**
      * Read a value from a specific object store.
      * @param storeName Object store name
@@ -5253,8 +5474,9 @@ apigit-commit-key:${input.commitKey}`;
       const database = await this.dbPromise;
       return new Promise((resolve) => {
         try {
-          const tx = database.transaction(storeName, "readonly");
-          const store = tx.objectStore(storeName);
+          const physical = this._storeName(storeName);
+          const tx = database.transaction(physical, "readonly");
+          const store = tx.objectStore(physical);
           const request = store.get(filepath);
           request.onsuccess = () => {
             const result = request.result ?? null;
@@ -5284,8 +5506,9 @@ apigit-commit-key:${input.commitKey}`;
       const database = await this.dbPromise;
       return new Promise((resolve) => {
         try {
-          const tx = database.transaction(storeName, "readonly");
-          const store = tx.objectStore(storeName);
+          const physical = this._storeName(storeName);
+          const tx = database.transaction(physical, "readonly");
+          const store = tx.objectStore(physical);
           const keys = [];
           const request = store.openKeyCursor();
           request.onsuccess = this._makeCursorSuccessHandler(resolve, keys);
@@ -5320,8 +5543,13 @@ apigit-commit-key:${input.commitKey}`;
       });
     }
     /**
-     * Create a cursor success handler bound to resolve and keys array.
+     * Map a logical store name to its physical store name including root prefix.
+     * @param name logical store identifier
+     * @returns physical store name used in IndexedDB
      */
+    _storeName(name) {
+      return this.rootPrefix ? `${this.rootPrefix}${name}` : name;
+    }
     /**
      * Create a cursor success handler bound to resolve and keys array.
      * @param resolve resolver
@@ -5362,9 +5590,6 @@ apigit-commit-key:${input.commitKey}`;
       keys = this._filterKeys(keys, p, recursive);
       return await this._collectFiles(keys, seg);
     }
-    /**
-     * Raw listing that returns implementation-specific URIs and a normalized path.
-     */
     /**
      * Raw listing that returns implementation-specific URIs and a normalized path.
      * @param prefix optional prefix to filter
@@ -5395,9 +5620,6 @@ apigit-commit-key:${input.commitKey}`;
       }
       return out;
     }
-    /**
-     * Helper: build entries from store keys with filtering and path normalization
-     */
     /**
      * Helper: build entries from store keys with filtering and path normalization
      * @returns {Promise<Array<{uri:string,path:string,info?:string|null}>>}
@@ -5474,10 +5696,6 @@ apigit-commit-key:${input.commitKey}`;
       }
       return keys;
     }
-    /**
-     * Collect file info objects for keys array.
-     * @returns {Promise<Array<{path:string, info:string|null}>>}
-     */
     /**
      * Collect file info objects for keys array.
      * @param keys list of keys
@@ -5493,15 +5711,6 @@ apigit-commit-key:${input.commitKey}`;
       }
       return out;
     }
-    /**
-     * Collect file info objects for keys array.
-     * @param keys key list
-     * @param _seg segment (unused)
-     * @returns {Promise<Array<{path:string, info:string|null}>>}
-     */
-    /**
-     * Resolve info value for a given key: prefer workspace-local, then branch-scoped.
-     */
     /**
      * Resolve info value for a given key: prefer workspace-local, then branch-scoped.
      * @param k key
@@ -5514,10 +5723,6 @@ apigit-commit-key:${input.commitKey}`;
         info = await this._getFromStore(IndexedDatabaseStorage2.VAR_INFO, k);
       return info;
     }
-    /**
-     * Resolve info value for a given key: prefer workspace-local, then branch-scoped.
-     * @returns {Promise<string|null>}
-     */
     /**
      * Calculate SHA-1 hex digest of given content.
      * @param content Input string
@@ -5596,6 +5801,23 @@ apigit-commit-key:${input.commitKey}`;
     for (let index = 0; index < bytes.length; index += 4) {
       words.push(bytes[index] << 24 | bytes[index + 1] << 16 | bytes[index + 2] << 8 | bytes[index + 3]);
     }
+    let h0 = 1732584193;
+    let h1 = 4023233417;
+    let h2 = 2562383102;
+    let h3 = 271733878;
+    let h4 = 3285377520;
+    const results = processWords(words);
+    h0 = results[0];
+    h1 = results[1];
+    h2 = results[2];
+    h3 = results[3];
+    h4 = results[4];
+    function toHex(n) {
+      return n.toString(16).padStart(8, "0");
+    }
+    return (toHex(h0) + toHex(h1) + toHex(h2) + toHex(h3) + toHex(h4)).toLowerCase();
+  }
+  function processWords(words) {
     let h0 = 1732584193;
     let h1 = 4023233417;
     let h2 = 2562383102;
@@ -5609,37 +5831,40 @@ apigit-commit-key:${input.commitKey}`;
         const temporary = w[t - 3] ^ w[t - 8] ^ w[t - 14] ^ w[t - 16];
         w[t] = (temporary << 1 | temporary >>> 31) >>> 0;
       }
-      let a = h0, b = h1, c = h2, d = h3, errorReg = h4;
-      for (let t = 0; t < 80; t++) {
-        let f, k;
-        if (t < 20) {
-          f = b & c | ~b & d;
-          k = 1518500249;
-        } else if (t < 40) {
-          f = b ^ c ^ d;
-          k = 1859775393;
-        } else if (t < 60) {
-          f = b & c | b & d | c & d;
-          k = 2400959708;
-        } else {
-          f = b ^ c ^ d;
-          k = 3395469782;
-        }
-        const temporaryValue = (a << 5 | a >>> 27) + f + errorReg + k + (w[t] >>> 0) >>> 0;
-        errorReg = d;
-        d = c;
-        c = (b << 30 | b >>> 2) >>> 0;
-        b = a;
-        a = temporaryValue;
-      }
-      h0 = h0 + a >>> 0;
-      h1 = h1 + b >>> 0;
-      h2 = h2 + c >>> 0;
-      h3 = h3 + d >>> 0;
-      h4 = h4 + errorReg >>> 0;
-    }
-    const toHex = (n) => n.toString(16).padStart(8, "0");
-    return (toHex(h0) + toHex(h1) + toHex(h2) + toHex(h3) + toHex(h4)).toLowerCase();
+      const updated = processChunk(w, [h0, h1, h2, h3, h4]);
+      h0 = updated[0];
+      h1 = updated[1];
+      h2 = updated[2];
+      h3 = updated[3];
+      h4 = updated[4];
+    }
+    return [h0, h1, h2, h3, h4];
+  }
+  function processChunk(w, h) {
+    let a = h[0], b = h[1], c = h[2], d = h[3], registerE = h[4];
+    for (let t = 0; t < 80; t++) {
+      let f, k;
+      if (t < 20) {
+        f = b & c | ~b & d;
+        k = 1518500249;
+      } else if (t < 40) {
+        f = b ^ c ^ d;
+        k = 1859775393;
+      } else if (t < 60) {
+        f = b & c | b & d | c & d;
+        k = 2400959708;
+      } else {
+        f = b ^ c ^ d;
+        k = 3395469782;
+      }
+      const temporaryValue = (a << 5 | a >>> 27) + f + registerE + k + (w[t] >>> 0) >>> 0;
+      registerE = d;
+      d = c;
+      c = (b << 30 | b >>> 2) >>> 0;
+      b = a;
+      a = temporaryValue;
+    }
+    return [h[0] + a >>> 0, h[1] + b >>> 0, h[2] + c >>> 0, h[3] + d >>> 0, h[4] + registerE >>> 0];
   }
   function parseExistingInfo(store, filepath) {
     const existingTxt = store.infoBlobs.has(filepath) ? store.infoBlobs.get(filepath) : null;
@@ -5687,31 +5912,36 @@ apigit-commit-key:${input.commitKey}`;
       const now = Date.now();
       const existing = parseExistingInfo(store, filepath);
       if (seg === "info") {
-        try {
-          const parsed = JSON.parse(content);
-          store.infoBlobs.set(filepath, JSON.stringify(parsed));
-          return;
-        } catch {
-          store.infoBlobs.set(filepath, String(content));
-          return;
-        }
+        await handleInfoSegment(store, filepath, content);
+        return;
       }
       const sha = await shaOf3(content);
       let entry;
-      if (seg === "workspace") {
+      if (seg === "workspace")
         entry = buildWorkspaceEntry(existing, filepath, sha, now);
-      } else if (seg === "base") {
+      else if (seg === "base")
         entry = buildBaseEntry(existing, filepath, sha, now);
-      } else if (seg === "conflict") {
+      else if (seg === "conflict")
         entry = buildConflictEntry(existing, filepath, now);
-      } else {
+      else
         entry = { path: filepath, updatedAt: now };
-      }
       store.infoBlobs.set(filepath, JSON.stringify(entry));
-    } catch {
+    } catch (error) {
+      if (typeof console !== "undefined" && console.debug)
+        console.debug("updateInfoForWrite failed", error);
       return;
     }
   }
+  async function handleInfoSegment(store, filepath, content) {
+    try {
+      const parsed = JSON.parse(content);
+      store.infoBlobs.set(filepath, JSON.stringify(parsed));
+    } catch (error) {
+      store.infoBlobs.set(filepath, String(content));
+      if (typeof console !== "undefined" && console.debug)
+        console.debug("handleInfoSegment: stored raw content due to parse error", error);
+    }
+  }
 
   // src/virtualfs/inmemoryStorage.ts
   var BRANCH_SEP = "::";
@@ -5735,17 +5965,26 @@ apigit-commit-key:${input.commitKey}`;
      * 利用可能なルート名を返します。
      * @returns {string[]} ルート名の配列
      */
-    static availableRoots() {
+    static availableRoots(namespace) {
       const keys = Array.from(InMemoryStorage2.stores.keys());
-      return keys.length ? keys : ["apigit_storage"];
+      if (namespace) {
+        const filtered = keys.filter((k) => k.startsWith(namespace + "/")).map((k) => k.slice((namespace + "/").length));
+        return filtered.length ? filtered : ["apigit_storage"];
+      }
+      const roots = keys.map((k) => {
+        const parts = k.split("/");
+        return parts.length > 1 ? parts.slice(1).join("/") : parts[0];
+      });
+      const uniq = Array.from(new Set(roots));
+      return uniq.length ? uniq : ["apigit_storage"];
     }
-    // legacy canUseOpfs removed; use static canUse() instead
     /**
      * コンストラクタ。互換性のためにディレクトリ名を受け取るが無視する。
      * @param directory 任意のディレクトリ文字列（使用しない）
      */
-    constructor(directory) {
-      this.rootKey = directory ?? `__inmem_${Math.random().toString(36).slice(2)}`;
+    constructor(namespace, directory) {
+      const directoryName = directory ?? `__inmem_${Math.random().toString(36).slice(2)}`;
+      this.rootKey = namespace ? `${namespace}/${directoryName}` : directoryName;
       if (!InMemoryStorage2.stores.has(this.rootKey)) {
         InMemoryStorage2.stores.set(this.rootKey, {
           index: { head: "", entries: {} },
@@ -5787,7 +6026,7 @@ apigit-commit-key:${input.commitKey}`;
     }
     /**
      * Load workspace-local info entries into result.entries (unprefixed keys)
-      * @returns {void}
+     * @returns {void}
      */
     _loadInMemoryWorkspaceInfo(store, result, branch) {
       for (const [k, v] of store.infoBlobs.entries()) {
@@ -5800,7 +6039,7 @@ apigit-commit-key:${input.commitKey}`;
     }
     /**
      * Load branch-scoped info entries into result.entries without overwriting workspace-local entries
-      * @returns {void}
+     * @returns {void}
      */
     _loadInMemoryBranchInfo(store, result, branch) {
       for (const [k, v] of store.infoBlobs.entries()) {
@@ -5873,10 +6112,6 @@ apigit-commit-key:${input.commitKey}`;
       const wrapped = seg === SEG_WORKSPACE || seg === "conflict" ? this._wrapStoreForInfoNoPrefix(store) : this._wrapStoreForInfoPrefix(store);
       await updateInfoForWrite(wrapped, filepath, seg, content);
     }
-    /**
-     * Handle workspace blob writes that should be based on existing git-scoped info.
-     * Returns true when the operation is handled and caller should return early.
-     */
     /**
      * Handle workspace blob writes that should be based on existing git-scoped info.
      * Returns true when the operation is handled and caller should return early.
@@ -6168,7 +6403,7 @@ apigit-commit-key:${input.commitKey}`;
      * @param prefix プレフィックス（例: 'dir/sub'）
      * @param segment セグメント（'workspace' 等）。省略時は 'workspace'
      * @param recursive サブディレクトリも含めるか。省略時は true
-    * @returns {Promise<Array<{ path: string; info: string | null }>>}
+     * @returns {Promise<Array<{ path: string; info: string | null }>>}
      */
     async listFiles(prefix, segment, recursive = true) {
       const seg = segment || SEG_WORKSPACE;
@@ -6187,9 +6422,6 @@ apigit-commit-key:${input.commitKey}`;
       const keys = this._resolveKeysForList(allKeys, String(seg), p, recursive);
       return this._collectFilesInMemory(keys, store);
     }
-    /**
-     * Resolve and filter keys for `listFiles` into final key list.
-     */
     /**
      * Resolve and filter keys for `listFiles` into final key list.
      * @returns {string[]} filtered keys
@@ -6326,9 +6558,15 @@ apigit-commit-key:${input.commitKey}`;
     static delete(rootName) {
       if (InMemoryStorage2.stores.has(rootName)) {
         InMemoryStorage2.stores.delete(rootName);
-      } else {
-        throw new Error(`InMemory root "${rootName}" not found`);
+        return;
+      }
+      for (const key of Array.from(InMemoryStorage2.stores.keys())) {
+        if (key === rootName || key.endsWith("/" + rootName)) {
+          InMemoryStorage2.stores.delete(key);
+          return;
+        }
       }
+      throw new Error(`InMemory root "${rootName}" not found`);
     }
   };
   var inmemoryStorage_default = InMemoryStorage;