browser-git-ops 0.0.0 → 0.0.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 nojaja
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 nojaja
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,146 +1,146 @@
-# browser-git-ops
-
-**目的**: ブラウザネイティブ環境（OPFS + Github/Gitlab APIs）で動作する軽量な Git 操作ライブラリを提供します。VirtualFS によるローカル差分生成と、GitHub/GitLab 向けのアダプタを通じたリモート操作を抽象化します。
-
-**主な特徴**
-- **仮想ファイルシステム (VirtualFS)**: ローカルワークスペースとベーススナップショットを管理し、変更セット（create/update/delete）を生成します。
-- **Git アダプタ抽象**: `GitAdapter` インターフェースに準拠するアダプタで GitHub/GitLab API を操作できます（サンプル実装あり）。
-- **Idempotent push**: commitKey による冪等処理サポート。
-- **衝突検知とマージ補助**: リモート差分取り込み時にローカルの未コミット変更を検出して conflicts を報告します。
-
-**注意（⚠️）**: 実装はユーティリティ/ライブラリ向けで、環境やアクセストークンの管理、エラーハンドリング方針は利用側で制御してください。
-
-**プロジェクト構成（抜粋）**
-- **src/virtualfs/virtualfs.ts**: VirtualFS 本体（初期化、read/write、push/pull、差分生成） - [src/virtualfs/virtualfs.ts](src/virtualfs/virtualfs.ts)
-- **src/virtualfs/persistence.ts**: ストレージバックエンドの抽象と Node 用実装 - [src/virtualfs/persistence.ts](src/virtualfs/persistence.ts)
-- **src/git/adapter.ts**: `GitAdapter` インターフェース定義 - [src/git/adapter.ts](src/git/adapter.ts)
-- **src/git/githubAdapter.ts**: GitHub 用アダプタ（blob/tree/commit フロー、再試行ロジック） - [src/git/githubAdapter.ts](src/git/githubAdapter.ts)
-- **test/**: ユニット／E2E テスト群（Jest / Playwright） - [test](test)
-
-**技術スタック**
-- TypeScript 5.x
-- Node.js (ESM, `type: "module"`)
-- テスト: Jest（unit） / Playwright（E2E）
-- ビルド: `tsc`
-
---------------------------------------------------
-**クイックスタート（開発用）**
-
-1. 依存インストール
-
-```bash
-npm ci
-```
-
-2. ユニットテスト実行
-
-```bash
-npm run test
-```
-
-3. E2E テスト（Playwright）
-
-```bash
-npm run test:e2e
-```
-
-4. ビルド
-
-```bash
-npm run build
-```
-
---------------------------------------------------
-**ライブラリ利用ガイド（Library Usage）**
-
-下記はライブラリの代表的な使い方（TypeScript）です。詳しい実装は各ファイルを参照してください。
-
-例: `VirtualFS` を初期化してローカル編集を push する
-
-```ts
-import VirtualFS from './src/virtualfs/virtualfs'
-import GitHubAdapter from './src/git/githubAdapter'
-
-async function example() {
-  const vfs = new VirtualFS({ storageDir: '.apigit' })
-  await vfs.init()
-
-  // ワークスペース編集
-  await vfs.writeWorkspace('foo.txt', 'hello')
-
-  // 変更セット取得
-  const changes = await vfs.getChangeSet()
-
-  // GitHub アダプタを使って push
-  const gh = new GitHubAdapter({ owner: 'ORG', repo: 'REPO', token: process.env.GH_TOKEN })
-  const res = await vfs.push({ parentSha: vfs.getIndex().head, message: 'update', changes }, gh as any)
-  console.log('commitSha', res.commitSha)
-}
-```
-
-API の概略（主要メソッド）
-- `new VirtualFS(options?)` - オプション: `{ storageDir?: string, backend?: StorageBackend }`
-- `init()` - バックエンド初期化と index 読み込み
-- `writeWorkspace(filepath, content)` - ワークスペースにファイルを書き込む
-- `deleteWorkspace(filepath)` - ワークスペース上のファイルを削除（トゥームストーン管理）
-- `renameWorkspace(from, to)` - rename（内部では delete + create）
-- `readWorkspace(filepath)` - ワークスペース/ベースから内容を読み出す
-- `applyBaseSnapshot(snapshot, headSha)` - リモートスナップショットを適用
-- `getIndex()` - 現在の index を返す
-- `listPaths()` - 登録パス一覧
-- `getChangeSet()` - create/update/delete の配列を生成
-- `pull(remoteHead, baseSnapshot)` - リモート差分取り込み（conflicts を返す）
-- `push(input, adapter?)` - 変更をコミットし（adapter があれば）リモートへ反映
-
-GitAdapter インターフェース（`src/git/adapter.ts`）
-- `createBlobs(changes, concurrency?)` -> Promise<Record<string,string>>
-- `createTree(changes, baseTreeSha?)` -> Promise<string>
-- `createCommit(message, parentSha, treeSha)` -> Promise<string>
-- `updateRef(ref, commitSha, force?)` -> Promise<void>
-
-実装済みアダプタの注意点:
-- `GitHubAdapter` は `blob/tree/commit` フローを実装し、HTTP 再試行ロジックを内蔵しています（5xx, 429 のリトライ等）。実装は [src/git/githubAdapter.ts](src/git/githubAdapter.ts) を参照してください。
-- GitLab 用実装はリポジトリ内に存在しますが、環境差異により API の振る舞いが異なるため本番運用前に検証してください。⚠️
-
---------------------------------------------------
-**開発セットアップ**
-- Node: 任意の recent Node.js（ESM サポート済み）
-- 実行手順
-
-```bash
-git clone <repo>
-cd APIGitWorkspace01
-npm ci
-```
-
-- コマンド一覧
-  - `npm run test` : ユニットテスト（Jest）
-  - `npm run test:e2e` : Playwright E2E
-  - `npm run lint` : ESLint
-  - `npm run build` : TypeScript ビルド
-
-テスト関連の注意:
-- Jest は ESM を扱うため `node --experimental-vm-modules` を使用するスクリプトが package.json に設定されています。
-
---------------------------------------------------
-**現在のステータス**
-- 実装済み: `VirtualFS` のコア機能（差分生成、push/pull シミュレーション、index 管理）、`GitHubAdapter` の主要な API 呼び出し。
-- テスト: unit テストと一部の E2E テストが含まれています（`test/` 配下）。
-- 未確定/要検証: 外部サービス（GitLab）の細かい API 挙動、production 用のエラー・認可ポリシー。
-
---------------------------------------------------
-**ライセンスとメタデータ**
-- package name: `browser-git-ops`
-- version: `0.0.0`
-- module type: CommonJS (`type: commonjs`)
-- License: MIT License
-
---------------------------------------------------
-追加で欲しいもの
-- サンプルユースケースを示す小さなサンプルリポジトリまたは `examples/` ディレクトリ
-
-
---------------------------------------------------
-貢献・問い合わせ
-- PR/Issue を歓迎します。まず issue を立て、簡単な実装提案（変更点の概要）を添えてください。
-
+# browser-git-ops
+
+**目的**: ブラウザネイティブ環境（OPFS + Github/Gitlab APIs）で動作する軽量な Git 操作ライブラリを提供します。VirtualFS によるローカル差分生成と、GitHub/GitLab 向けのアダプタを通じたリモート操作を抽象化します。
+
+**主な特徴**
+- **仮想ファイルシステム (VirtualFS)**: ローカルワークスペースとベーススナップショットを管理し、変更セット（create/update/delete）を生成します。
+- **Git アダプタ抽象**: `GitAdapter` インターフェースに準拠するアダプタで GitHub/GitLab API を操作できます（サンプル実装あり）。
+- **Idempotent push**: commitKey による冪等処理サポート。
+- **衝突検知とマージ補助**: リモート差分取り込み時にローカルの未コミット変更を検出して conflicts を報告します。
+
+**注意（⚠️）**: 実装はユーティリティ/ライブラリ向けで、環境やアクセストークンの管理、エラーハンドリング方針は利用側で制御してください。
+
+**プロジェクト構成（抜粋）**
+- **src/virtualfs/virtualfs.ts**: VirtualFS 本体（初期化、read/write、push/pull、差分生成） - [src/virtualfs/virtualfs.ts](src/virtualfs/virtualfs.ts)
+- **src/virtualfs/persistence.ts**: ストレージバックエンドの抽象と Node 用実装 - [src/virtualfs/persistence.ts](src/virtualfs/persistence.ts)
+- **src/git/adapter.ts**: `GitAdapter` インターフェース定義 - [src/git/adapter.ts](src/git/adapter.ts)
+- **src/git/githubAdapter.ts**: GitHub 用アダプタ（blob/tree/commit フロー、再試行ロジック） - [src/git/githubAdapter.ts](src/git/githubAdapter.ts)
+- **test/**: ユニット／E2E テスト群（Jest / Playwright） - [test](test)
+
+**技術スタック**
+- TypeScript 5.x
+- Node.js (ESM, `type: "module"`)
+- テスト: Jest（unit） / Playwright（E2E）
+- ビルド: `tsc`
+
+--------------------------------------------------
+**クイックスタート（開発用）**
+
+1. 依存インストール
+
+```bash
+npm ci
+```
+
+2. ユニットテスト実行
+
+```bash
+npm run test
+```
+
+3. E2E テスト（Playwright）
+
+```bash
+npm run test:e2e
+```
+
+4. ビルド
+
+```bash
+npm run build
+```
+
+--------------------------------------------------
+**ライブラリ利用ガイド（Library Usage）**
+
+下記はライブラリの代表的な使い方（TypeScript）です。詳しい実装は各ファイルを参照してください。
+
+例: `VirtualFS` を初期化してローカル編集を push する
+
+```ts
+import VirtualFS from './src/virtualfs/virtualfs'
+import GitHubAdapter from './src/git/githubAdapter'
+
+async function example() {
+  const vfs = new VirtualFS({ storageDir: '.apigit' })
+  await vfs.init()
+
+  // ワークスペース編集
+  await vfs.writeWorkspace('foo.txt', 'hello')
+
+  // 変更セット取得
+  const changes = await vfs.getChangeSet()
+
+  // GitHub アダプタを使って push
+  const gh = new GitHubAdapter({ owner: 'ORG', repo: 'REPO', token: process.env.GH_TOKEN })
+  const res = await vfs.push({ parentSha: vfs.getIndex().head, message: 'update', changes }, gh as any)
+  console.log('commitSha', res.commitSha)
+}
+```
+
+API の概略（主要メソッド）
+- `new VirtualFS(options?)` - オプション: `{ storageDir?: string, backend?: StorageBackend }`
+- `init()` - バックエンド初期化と index 読み込み
+- `writeWorkspace(filepath, content)` - ワークスペースにファイルを書き込む
+- `deleteWorkspace(filepath)` - ワークスペース上のファイルを削除（トゥームストーン管理）
+- `renameWorkspace(from, to)` - rename（内部では delete + create）
+- `readWorkspace(filepath)` - ワークスペース/ベースから内容を読み出す
+- `applyBaseSnapshot(snapshot, headSha)` - リモートスナップショットを適用
+- `getIndex()` - 現在の index を返す
+- `listPaths()` - 登録パス一覧
+- `getChangeSet()` - create/update/delete の配列を生成
+- `pull(remoteHead, baseSnapshot)` - リモート差分取り込み（conflicts を返す）
+- `push(input, adapter?)` - 変更をコミットし（adapter があれば）リモートへ反映
+
+GitAdapter インターフェース（`src/git/adapter.ts`）
+- `createBlobs(changes, concurrency?)` -> Promise<Record<string,string>>
+- `createTree(changes, baseTreeSha?)` -> Promise<string>
+- `createCommit(message, parentSha, treeSha)` -> Promise<string>
+- `updateRef(ref, commitSha, force?)` -> Promise<void>
+
+実装済みアダプタの注意点:
+- `GitHubAdapter` は `blob/tree/commit` フローを実装し、HTTP 再試行ロジックを内蔵しています（5xx, 429 のリトライ等）。実装は [src/git/githubAdapter.ts](src/git/githubAdapter.ts) を参照してください。
+- GitLab 用実装はリポジトリ内に存在しますが、環境差異により API の振る舞いが異なるため本番運用前に検証してください。⚠️
+
+--------------------------------------------------
+**開発セットアップ**
+- Node: 任意の recent Node.js（ESM サポート済み）
+- 実行手順
+
+```bash
+git clone <repo>
+cd APIGitWorkspace01
+npm ci
+```
+
+- コマンド一覧
+  - `npm run test` : ユニットテスト（Jest）
+  - `npm run test:e2e` : Playwright E2E
+  - `npm run lint` : ESLint
+  - `npm run build` : TypeScript ビルド
+
+テスト関連の注意:
+- Jest は ESM を扱うため `node --experimental-vm-modules` を使用するスクリプトが package.json に設定されています。
+
+--------------------------------------------------
+**現在のステータス**
+- 実装済み: `VirtualFS` のコア機能（差分生成、push/pull シミュレーション、index 管理）、`GitHubAdapter` の主要な API 呼び出し。
+- テスト: unit テストと一部の E2E テストが含まれています（`test/` 配下）。
+- 未確定/要検証: 外部サービス（GitLab）の細かい API 挙動、production 用のエラー・認可ポリシー。
+
+--------------------------------------------------
+**ライセンスとメタデータ**
+- package name: `browser-git-ops`
+- version: `0.0.0`
+- module type: CommonJS (`type: commonjs`)
+- License: MIT License
+
+--------------------------------------------------
+追加で欲しいもの
+- サンプルユースケースを示す小さなサンプルリポジトリまたは `examples/` ディレクトリ
+
+
+--------------------------------------------------
+貢献・問い合わせ
+- PR/Issue を歓迎します。まず issue を立て、簡単な実装提案（変更点の概要）を添えてください。
+

package/dist/git/githubAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"githubAdapter.d.ts","sourceRoot":"","sources":["../../src/git/githubAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAGtC,KAAK,SAAS,GAAG;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAU/C;;;;;;;GAOG;AAEH,iBAAe,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,SAAI,EAAE,SAAS,SAAM,qBAcjG;AAED,iBAAS,cAAc,CAAC,MAAM,EAAE,MAAM,WAErC;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAI9E;AAED,iBAAe,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAQlF;AAED;;;;;GAKG;AAEH,iBAAS,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,SAAI,gBAc3F;AAED,qBAAa,aAAc,YAAW,UAAU;IAMlC,OAAO,CAAC,IAAI;IALxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,eAAe,CAAqF;IAE5G,OAAO,CAAC,SAAS,CAAiC;gBAC9B,IAAI,EAAE,SAAS;IAU7B,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,WAAW,SAAI;IAqB3C,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM;IAkB/C,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAQhE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,UAAQ;CAQ9D;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,CAAA;AAC5G,eAAe,aAAa,CAAA"}
+{"version":3,"file":"githubAdapter.d.ts","sourceRoot":"","sources":["../../src/git/githubAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAGtC,KAAK,SAAS,GAAG;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAU/C;;;;;;;GAOG;AAEH,iBAAe,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,SAAI,EAAE,SAAS,SAAM,qBAcjG;AAED,iBAAS,cAAc,CAAC,MAAM,EAAE,MAAM,WAErC;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAI9E;AAED,iBAAe,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAQlF;AAED;;;;;GAKG;AAEH,iBAAS,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,SAAI,gBAc3F;AAED,qBAAa,aAAc,YAAW,UAAU;IAMlC,OAAO,CAAC,IAAI;IALxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,eAAe,CAAqF;IAE5G,OAAO,CAAC,SAAS,CAAiC;gBAC9B,IAAI,EAAE,SAAS;IAU7B,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,WAAW,SAAI;IAqB3C,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM;IAkB/C,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAQhE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,UAAQ;CAQ9D;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,CAAA;AAC5G,eAAe,aAAa,CAAA"}

package/dist/test/e2e/virtualfs.spec.js

@@ -50,67 +50,67 @@ async function installMockApi(page, initialFiles = {}) {
     };
 }
 // Simple in-page VirtualFS implementation used by tests
-const vfsScript = `(() => {
-  const base = {}; // files that reflect remote base
-  const workspace = {}; // pending edits
-  const tombstone = new Set();
-  let head = 'initial';
-
-  async function pull() {
-    const res = await fetch('http://example.com/api/pull');
-    if (!res.ok) throw new Error('pull failed');
-    const body = await res.json();
-    for (const k of Object.keys(base)) delete base[k];
-    for (const [k,v] of Object.entries(body.files)) base[k]=v;
-    head = body.head;
-    // clear workspace/tombstone on successful pull
-    for (const k of Object.keys(workspace)) delete workspace[k];
-    tombstone.clear();
-    return { head };
-  }
-
-  async function push() {
-    // compute actions from workspace/tombstone
-    const actions = [];
-    for (const k of Object.keys(workspace)) {
-      if (!(k in base)) actions.push({ action: 'create', path: k, content: workspace[k] });
-      else if (base[k] !== workspace[k]) actions.push({ action: 'update', path: k, content: workspace[k] });
-    }
-    for (const p of tombstone) actions.push({ action: 'delete', path: p });
-    if (actions.length === 0) return { noop: true };
-    const res = await fetch('http://example.com/api/commit', { method: 'POST', headers: {'content-type':'application/json'}, body: JSON.stringify({ actions, message: 'test commit' }) });
-    if (!res.ok) throw new Error('push failed');
-    const body = await res.json();
-    // apply commit to base
-    for (const a of actions) {
-      if (a.action === 'create' || a.action === 'update') base[a.path] = a.content ?? '';
-      else if (a.action === 'delete') delete base[a.path];
-    }
-    // clear workspace/tombstone
-    for (const k of Object.keys(workspace)) delete workspace[k];
-    tombstone.clear();
-    head = body.commit.id;
-    return { commit: body.commit };
-  }
-
-  return {
-    readFile: (p) => {
-      if (p in workspace) return workspace[p];
-      if (p in base) return base[p];
-      throw new Error('not found');
-    },
-    writeFile: (p, content) => { workspace[p] = content; tombstone.delete(p); },
-    delete: (p) => { delete workspace[p]; if (p in base) tombstone.add(p); },
-    rename: (from, to) => {
-      if (from in workspace) { workspace[to] = workspace[from]; delete workspace[from]; }
-      else if (from in base) { tombstone.add(from); workspace[to] = base[from]; }
-    },
-    status: () => ({ changed: Object.keys(workspace), deleted: Array.from(tombstone), conflicted: [] }),
-    pull, push,
-    _debug_getBase: () => ({ ...base }),
-    _debug_getWorkspace: () => ({ ...workspace }),
-    _debug_getTombstone: () => Array.from(tombstone),
-  };
+const vfsScript = `(() => {
+  const base = {}; // files that reflect remote base
+  const workspace = {}; // pending edits
+  const tombstone = new Set();
+  let head = 'initial';
+
+  async function pull() {
+    const res = await fetch('http://example.com/api/pull');
+    if (!res.ok) throw new Error('pull failed');
+    const body = await res.json();
+    for (const k of Object.keys(base)) delete base[k];
+    for (const [k,v] of Object.entries(body.files)) base[k]=v;
+    head = body.head;
+    // clear workspace/tombstone on successful pull
+    for (const k of Object.keys(workspace)) delete workspace[k];
+    tombstone.clear();
+    return { head };
+  }
+
+  async function push() {
+    // compute actions from workspace/tombstone
+    const actions = [];
+    for (const k of Object.keys(workspace)) {
+      if (!(k in base)) actions.push({ action: 'create', path: k, content: workspace[k] });
+      else if (base[k] !== workspace[k]) actions.push({ action: 'update', path: k, content: workspace[k] });
+    }
+    for (const p of tombstone) actions.push({ action: 'delete', path: p });
+    if (actions.length === 0) return { noop: true };
+    const res = await fetch('http://example.com/api/commit', { method: 'POST', headers: {'content-type':'application/json'}, body: JSON.stringify({ actions, message: 'test commit' }) });
+    if (!res.ok) throw new Error('push failed');
+    const body = await res.json();
+    // apply commit to base
+    for (const a of actions) {
+      if (a.action === 'create' || a.action === 'update') base[a.path] = a.content ?? '';
+      else if (a.action === 'delete') delete base[a.path];
+    }
+    // clear workspace/tombstone
+    for (const k of Object.keys(workspace)) delete workspace[k];
+    tombstone.clear();
+    head = body.commit.id;
+    return { commit: body.commit };
+  }
+
+  return {
+    readFile: (p) => {
+      if (p in workspace) return workspace[p];
+      if (p in base) return base[p];
+      throw new Error('not found');
+    },
+    writeFile: (p, content) => { workspace[p] = content; tombstone.delete(p); },
+    delete: (p) => { delete workspace[p]; if (p in base) tombstone.add(p); },
+    rename: (from, to) => {
+      if (from in workspace) { workspace[to] = workspace[from]; delete workspace[from]; }
+      else if (from in base) { tombstone.add(from); workspace[to] = base[from]; }
+    },
+    status: () => ({ changed: Object.keys(workspace), deleted: Array.from(tombstone), conflicted: [] }),
+    pull, push,
+    _debug_getBase: () => ({ ...base }),
+    _debug_getWorkspace: () => ({ ...workspace }),
+    _debug_getTombstone: () => Array.from(tombstone),
+  };
 })();`;
 test_1.test.describe('VirtualFS E2E (mocked API)', () => {
     test_1.test.beforeEach(async ({ page }) => {

package/dist/virtualfs/virtualfs.d.ts

@@ -93,8 +93,9 @@ export declare class VirtualFS {
      * @returns {TombstoneEntry[]}
      */
     /**
-     *
-     */
+      * ワークスペースとインデックスから変更セットを生成します。
+      * @returns {Promise<Array<{type:string,path:string,content?:string,baseSha?:string}>>} 変更リスト
+      */
     getChangeSet(): Promise<({
         type: 'create';
         path: string;

package/dist/virtualfs/virtualfs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtualfs.d.ts","sourceRoot":"","sources":["../../src/virtualfs/virtualfs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,cAAc,EAAiB,MAAM,eAAe,CAAA;AAE7D;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,IAAI,CAAsD;IAClE,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,OAAO,CAAgB;IAE/B;;OAEG;gBACS,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE;IAOvE;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;OAGG;IACG,IAAI;IAKV;;;OAGG;YACW,SAAS;IAmBvB;;;OAGG;YACW,SAAS;IAIvB;;OAEG;IACH;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAkBtD;;;;OAIG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM;IAqBtC;;;;OAIG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAa9C;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM;IAWpC;;;;;OAKG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;IA2BzE;;;OAGG;IACH,QAAQ,IAAI,SAAS;IAIrB;;;OAGG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;;OAGG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;;OAGG;IAEH;;OAEG;IACG,YAAY;cAGJ,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;cACvC,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;;cACvC,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;IAQrD;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;;;OAIG;YACW,iBAAiB;IAS/B;;;OAGG;YACW,gBAAgB;IAa9B;;;OAGG;YACW,qBAAqB;IAkBnC;;;;OAIG;YACW,mBAAmB;IAqBjC;;;OAGG;YACW,qBAAqB;IAYnC;;;OAGG;YACW,gBAAgB;IAe9B;;;OAGG;YACW,mBAAmB;IAkBjC;;;;;OAKG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;IA6BnE;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,OAAO,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,gBAAgB,EAAE,UAAU;;;CAkD/F;AAED,eAAe,SAAS,CAAA"}
+{"version":3,"file":"virtualfs.d.ts","sourceRoot":"","sources":["../../src/virtualfs/virtualfs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,cAAc,EAAiB,MAAM,eAAe,CAAA;AAE7D;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,IAAI,CAAsD;IAClE,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,OAAO,CAAgB;IAE/B;;OAEG;gBACS,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE;IAOvE;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;OAGG;IACG,IAAI;IAKV;;;OAGG;YACW,SAAS;IAmBvB;;;OAGG;YACW,SAAS;IAIvB;;OAEG;IACH;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAkBtD;;;;OAIG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM;IAqBtC;;;;OAIG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAa9C;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM;IAWpC;;;;;OAKG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;IA2BzE;;;OAGG;IACH,QAAQ,IAAI,SAAS;IAIrB;;;OAGG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;;OAGG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;;OAGG;IAEH;;;QAGI;IACI,YAAY;cAGN,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;cACvC,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;;cACvC,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;IAQrD;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;;;OAIG;YACW,iBAAiB;IAS/B;;;OAGG;YACW,gBAAgB;IAa9B;;;OAGG;YACW,qBAAqB;IAkBnC;;;;OAIG;YACW,mBAAmB;IAqBjC;;;OAGG;YACW,qBAAqB;IAYnC;;;OAGG;YACW,gBAAgB;IAe9B;;;OAGG;YACW,mBAAmB;IAkBjC;;;;;OAKG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;IA6BnE;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,OAAO,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,gBAAgB,EAAE,UAAU;;;CAkD/F;AAED,eAAe,SAAS,CAAA"}

package/dist/virtualfs/virtualfs.js

@@ -218,8 +218,9 @@ class VirtualFS {
      * @returns {TombstoneEntry[]}
      */
     /**
-     *
-     */
+      * ワークスペースとインデックスから変更セットを生成します。
+      * @returns {Promise<Array<{type:string,path:string,content?:string,baseSha?:string}>>} 変更リスト
+      */
     async getChangeSet() {
         const changes = [];
         changes.push(...this._changesFromTombstones());
@@ -467,7 +468,6 @@ class VirtualFS {
             // If adapter supports createCommitWithActions (GitLab style), use it directly
             if (adapter.createCommitWithActions) {
                 // ensure message contains commitKey
-                ;
                 input.message = messageWithKey;
                 const res = await this._pushWithActions(adapter, input, branch);
                 // record commitKey in index metadata
@@ -475,7 +475,6 @@ class VirtualFS {
                 return res;
             }
             // Fallback to GitHub-style flow: delegate to helper
-            ;
             input.message = messageWithKey;
             const res = await this._pushWithGitHubFlow(adapter, input, branch);
             this.index.lastCommitKey = input.commitKey;

package/package.json

@@ -1,47 +1,47 @@
-{
-  "name": "browser-git-ops",
-  "version": "0.0.0",
-  "type": "commonjs",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "description": "A browser-native Git operations library built with OPFS and Web APIs.",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/nojaja/APIGitWorkspace.git"
-  },
-  "bugs": {
-    "url": "https://github.com/nojaja/APIGitWorkspace/issues"
-  },
-  "homepage": "https://github.com/nojaja/APIGitWorkspace#readme",
-  "keywords": ["virtualfs", "git", "github", "vfs", "apigit"],
-  "author": "nojaja <free.riccia@gmail.com> (https://github.com/nojaja)",
-  "license": "MIT",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --runInBand",
-    "pretest:e2e": "npm run build",
-    "test:e2e": "playwright test --config=playwright.config.cjs",
-    "test:ci": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --coverage --runInBand",
-    "lint": "eslint \"src/**/*.{ts,js}\" --config .eslintrc.cjs",
-    "depcruise": "depcruise --config .dependency-cruiser.js src || exit 0",
-    "build": "tsc -p tsconfig.json && tsc -p tsconfig.e2e.json"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.40.0",
-    "@types/jest": "^29.5.2",
-    "@typescript-eslint/eslint-plugin": "^6.10.0",
-    "@typescript-eslint/parser": "^6.10.0",
-    "dependency-cruiser": "^17.3.6",
-    "eslint": "^8.45.0",
-    "eslint-plugin-jsdoc": "^62.1.0",
-    "eslint-plugin-sonarjs": "^0.16.0",
-    "jest": "^29.6.1",
-    "ts-jest": "^29.1.0",
-    "typedoc": "^0.25.0",
-    "typescript": "5.3.3"
-  }
-}
+{
+  "name": "browser-git-ops",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "description": "A browser-native Git operations library built with OPFS and Web APIs.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nojaja/browser-git-ops.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nojaja/browser-git-ops/issues"
+  },
+  "homepage": "https://github.com/nojaja/browser-git-ops#readme",
+  "keywords": ["virtualfs", "git", "github", "vfs", "apigit"],
+  "author": "nojaja <free.riccia@gmail.com> (https://github.com/nojaja)",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --runInBand",
+    "pretest:e2e": "npm run build",
+    "test:e2e": "playwright test --config=playwright.config.cjs",
+    "test:ci": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --coverage --runInBand",
+    "lint": "eslint \"src/**/*.{ts,js}\" --config .eslintrc.cjs",
+    "depcruise": "depcruise --config .dependency-cruiser.cjs src || exit 0",
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.e2e.json"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.40.0",
+    "@types/jest": "^29.5.2",
+    "@typescript-eslint/eslint-plugin": "^6.10.0",
+    "@typescript-eslint/parser": "^6.10.0",
+    "dependency-cruiser": "^17.3.6",
+    "eslint": "^8.45.0",
+    "eslint-plugin-jsdoc": "^62.1.0",
+    "eslint-plugin-sonarjs": "^0.16.0",
+    "jest": "^29.6.1",
+    "ts-jest": "^29.1.0",
+    "typedoc": "^0.25.0",
+    "typescript": "5.3.3"
+  }
+}