@akiojin/gwt 9.11.11 → 9.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.ja.md +23 -0
  2. package/README.md +21 -0
  3. package/package.json +1 -1
package/README.ja.md CHANGED
@@ -116,6 +116,29 @@ Docker 起動では引き続きコンテナ内のシェルを使います。
116
116
  できます。Windows / Linux では `Ctrl+Shift+C` でも現在の選択をコピーできます。
117
117
  `Ctrl+C` は実行中のターミナルプロセス向けの割り込みのままです。
118
118
 
119
+ ## ワークスペース構成
120
+
121
+ gwt は各プロジェクトをワークスペースディレクトリ配下の **Nested Bare + Worktree**
122
+ 構成として管理します。
123
+
124
+ ```
125
+ <workspace>/<project>/
126
+ ├── <project>.git/ # bare リポジトリ
127
+ ├── develop/ # develop ワークツリー(既定の作業ディレクトリ)
128
+ ├── feature/<name>/ # ブランチごとの追加ワークツリー
129
+ └── .gwt/project.toml # gwt が管理するプロジェクトメタデータ
130
+ ```
131
+
132
+ Initialization ウィザード経由で clone した場合は自動でこの構成になります。
133
+ 既存の Normal Git リポジトリ(プロジェクト直下に `.git/` がある通常レイアウト)
134
+ は検出され、要望に応じて Nested Bare + Worktree 構成へマイグレーションできます。
135
+ マイグレーションは `.gwt-migration-backup/` にフルバックアップを取ってから
136
+ bare リポジトリを作り直し、各 worktree を新レイアウトに再配置します。
137
+ 任意のフェーズで失敗した場合は自動的に元のレイアウトへロールバックされます。
138
+ 進行状況は
139
+ [GitHub Issue #1934 (SPEC-1934)](https://github.com/akiojin/gwt/issues/1934)
140
+ で管理しています。
141
+
119
142
  ## キャンバス操作
120
143
 
121
144
  - 画面上の zoom ボタンでキャンバスを拡大・縮小
package/README.md CHANGED
@@ -118,6 +118,27 @@ In terminal windows, drag to select text and release the mouse button to copy.
118
118
  On Windows and Linux, `Ctrl+Shift+C` also copies the current terminal
119
119
  selection. `Ctrl+C` stays mapped to the running terminal process.
120
120
 
121
+ ## Workspace Layout
122
+
123
+ gwt manages each project as a **Nested Bare + Worktree** layout under your
124
+ workspace directory:
125
+
126
+ ```
127
+ <workspace>/<project>/
128
+ ├── <project>.git/ # bare repository
129
+ ├── develop/ # develop worktree (default working directory)
130
+ ├── feature/<name>/ # additional worktrees by branch
131
+ └── .gwt/project.toml # gwt-managed project metadata
132
+ ```
133
+
134
+ `gwt` auto-creates this layout when you clone through the Initialization
135
+ wizard. Existing Normal Git repositories (`.git/` directly under the project
136
+ directory) are recognised so a migration to the Nested Bare + Worktree layout
137
+ can be run on demand. The migration safely backs up the original tree to
138
+ `.gwt-migration-backup/`, rebuilds the bare repo, recreates each worktree,
139
+ and rolls back automatically if any phase fails. Tracking work is captured in
140
+ [GitHub Issue #1934 (SPEC-1934)](https://github.com/akiojin/gwt/issues/1934).
141
+
121
142
  ## Canvas Operations
122
143
 
123
144
  - Zoom the canvas with the on-screen zoom buttons
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@akiojin/gwt",
3
- "version": "9.11.11",
3
+ "version": "9.12.0",
4
4
  "description": "Desktop GUI for Git worktree management and coding agent launch",
5
5
  "type": "module",
6
6
  "bin": {