@akiojin/gwt 3.0.0 → 3.1.1

package/src/cli/ui/hooks/useProfiles.ts

@@ -0,0 +1,211 @@
+/**
+ * プロファイル管理フック
+ *
+ * 環境変数プロファイルの読み込み・操作を提供します。
+ * @see specs/SPEC-dafff079/spec.md
+ */
+
+import { useState, useEffect, useCallback } from "react";
+import {
+  loadProfiles,
+  setActiveProfile as setActiveProfileApi,
+  createProfile as createProfileApi,
+  updateProfile as updateProfileApi,
+  deleteProfile as deleteProfileApi,
+} from "../../../config/profiles.js";
+import type {
+  ProfilesConfig,
+  EnvironmentProfile,
+} from "../../../types/profiles.js";
+
+export interface UseProfilesResult {
+  /** プロファイル設定（ロード中はnull） */
+  profiles: ProfilesConfig | null;
+  /** ロード中フラグ */
+  loading: boolean;
+  /** エラー（なければnull） */
+  error: Error | null;
+  /** アクティブなプロファイル名 */
+  activeProfileName: string | null;
+  /** アクティブなプロファイル設定 */
+  activeProfile: EnvironmentProfile | null;
+
+  /** プロファイル設定を再読み込み */
+  refresh: () => Promise<void>;
+  /** アクティブなプロファイルを設定 */
+  setActiveProfile: (name: string | null) => Promise<void>;
+  /** 新しいプロファイルを作成 */
+  createProfile: (name: string, profile: EnvironmentProfile) => Promise<void>;
+  /** プロファイルを更新 */
+  updateProfile: (
+    name: string,
+    updates: Partial<EnvironmentProfile>,
+  ) => Promise<void>;
+  /** プロファイルを削除 */
+  deleteProfile: (name: string) => Promise<void>;
+  /** 環境変数を更新 */
+  updateEnvVar: (
+    profileName: string,
+    key: string,
+    value: string,
+  ) => Promise<void>;
+  /** 環境変数を削除 */
+  deleteEnvVar: (profileName: string, key: string) => Promise<void>;
+}
+
+/**
+ * プロファイル管理フック
+ *
+ * コンポーネントでプロファイルの読み込みと操作を行うためのフック。
+ * 初回マウント時に自動的にプロファイル設定を読み込みます。
+ */
+export function useProfiles(): UseProfilesResult {
+  const [profiles, setProfiles] = useState<ProfilesConfig | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  // プロファイル設定を読み込む
+  const refresh = useCallback(async () => {
+    try {
+      setLoading(true);
+      setError(null);
+      const config = await loadProfiles();
+      setProfiles(config);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  // 初回マウント時に読み込み
+  useEffect(() => {
+    refresh();
+  }, [refresh]);
+
+  // アクティブなプロファイル名
+  const activeProfileName = profiles?.activeProfile ?? null;
+
+  // アクティブなプロファイル設定
+  const activeProfile = activeProfileName
+    ? (profiles?.profiles[activeProfileName] ?? null)
+    : null;
+
+  // アクティブなプロファイルを設定
+  const setActiveProfile = useCallback(
+    async (name: string | null) => {
+      try {
+        await setActiveProfileApi(name);
+        await refresh();
+      } catch (err) {
+        setError(err instanceof Error ? err : new Error(String(err)));
+        throw err;
+      }
+    },
+    [refresh],
+  );
+
+  // プロファイルを作成
+  const createProfile = useCallback(
+    async (name: string, profile: EnvironmentProfile) => {
+      try {
+        await createProfileApi(name, profile);
+        await refresh();
+      } catch (err) {
+        setError(err instanceof Error ? err : new Error(String(err)));
+        throw err;
+      }
+    },
+    [refresh],
+  );
+
+  // プロファイルを更新
+  const updateProfile = useCallback(
+    async (name: string, updates: Partial<EnvironmentProfile>) => {
+      try {
+        await updateProfileApi(name, updates);
+        await refresh();
+      } catch (err) {
+        setError(err instanceof Error ? err : new Error(String(err)));
+        throw err;
+      }
+    },
+    [refresh],
+  );
+
+  // プロファイルを削除
+  const deleteProfile = useCallback(
+    async (name: string) => {
+      try {
+        await deleteProfileApi(name);
+        await refresh();
+      } catch (err) {
+        setError(err instanceof Error ? err : new Error(String(err)));
+        throw err;
+      }
+    },
+    [refresh],
+  );
+
+  // 環境変数を更新
+  const updateEnvVar = useCallback(
+    async (profileName: string, key: string, value: string) => {
+      if (!profiles) {
+        const err = new Error("Profiles not loaded");
+        setError(err);
+        throw err;
+      }
+
+      if (!profiles.profiles[profileName]) {
+        const err = new Error(`Profile "${profileName}" does not exist`);
+        setError(err);
+        throw err;
+      }
+
+      const existingProfile = profiles.profiles[profileName];
+      const newEnv = { ...existingProfile.env, [key]: value };
+
+      await updateProfile(profileName, { env: newEnv });
+    },
+    [profiles, updateProfile],
+  );
+
+  // 環境変数を削除
+  const deleteEnvVar = useCallback(
+    async (profileName: string, key: string) => {
+      if (!profiles) {
+        const err = new Error("Profiles not loaded");
+        setError(err);
+        throw err;
+      }
+
+      if (!profiles.profiles[profileName]) {
+        const err = new Error(`Profile "${profileName}" does not exist`);
+        setError(err);
+        throw err;
+      }
+
+      const existingProfile = profiles.profiles[profileName];
+      const newEnv = { ...existingProfile.env };
+      delete newEnv[key];
+
+      await updateProfile(profileName, { env: newEnv });
+    },
+    [profiles, updateProfile],
+  );
+
+  return {
+    profiles,
+    loading,
+    error,
+    activeProfileName,
+    activeProfile,
+    refresh,
+    setActiveProfile,
+    createProfile,
+    updateProfile,
+    deleteProfile,
+    updateEnvVar,
+    deleteEnvVar,
+  };
+}

package/src/cli/ui/types.ts

@@ -191,7 +191,8 @@ export type ScreenType =
   | "session-selector"
   | "execution-mode-selector"
   | "batch-merge-progress"
-  | "batch-merge-result";
+  | "batch-merge-result"
+  | "environment-profile";
 
 /**
  * Branch action types for action selector screen

package/src/cli/ui/utils/branchFormatter.ts

@@ -6,7 +6,6 @@ import type {
   WorktreeInfo,
 } from "../types.js";
 import stringWidth from "string-width";
-import chalk from "chalk";
 
 // Icon mappings
 const branchIcons: Record<BranchType, string> = {
@@ -21,7 +20,7 @@ const branchIcons: Record<BranchType, string> = {
 
 const worktreeIcons: Record<Exclude<WorktreeStatus, undefined>, string> = {
   active: "🟢",
-  inaccessible: "🟠",
+  inaccessible: "🔴",
 };
 
 const changeIcons = {
@@ -67,7 +66,7 @@ const iconWidthOverrides: Record<string, number> = {
   // Worktree status icons
   "🟢": 2,
   "⚪": 2,
-  "🟠": 1,
+  "🔴": 2,
   // Change status icons
   "👉": 1,
   "💾": 1,

package/src/config/profiles.ts

@@ -0,0 +1,362 @@
+/**
+ * 環境変数プロファイル設定管理
+ *
+ * ~/.gwt/profiles.yamlからプロファイル設定を読み込み、
+ * AIツール起動時の環境変数を管理します。
+ *
+ * @see specs/SPEC-dafff079/spec.md
+ */
+
+import {
+  mkdir,
+  open,
+  readFile,
+  rename,
+  stat,
+  unlink,
+  writeFile,
+} from "node:fs/promises";
+import path from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { homedir } from "node:os";
+import {
+  DEFAULT_PROFILES_CONFIG,
+  isValidProfileName,
+  type EnvironmentProfile,
+  type ProfilesConfig,
+} from "../types/profiles.js";
+
+/**
+ * 設定ディレクトリのパスを取得
+ *
+ * 環境変数の優先順位: GWT_HOME > CLAUDE_WORKTREE_HOME (後方互換性) > ホームディレクトリ
+ */
+function getConfigDir(): string {
+  const worktreeHome =
+    process.env.GWT_HOME && process.env.GWT_HOME.trim().length > 0
+      ? process.env.GWT_HOME
+      : process.env.CLAUDE_WORKTREE_HOME &&
+          process.env.CLAUDE_WORKTREE_HOME.trim().length > 0
+        ? process.env.CLAUDE_WORKTREE_HOME
+        : homedir();
+  return path.join(worktreeHome, ".gwt");
+}
+
+/**
+ * プロファイル設定ファイルのパスを取得
+ */
+function getProfilesConfigPath(): string {
+  return path.join(getConfigDir(), "profiles.yaml");
+}
+
+const LOCK_RETRY_INTERVAL_MS = 50;
+const LOCK_TIMEOUT_MS = 3000;
+const LOCK_STALE_MS = 30_000;
+
+function getProfilesLockPath(): string {
+  return `${getProfilesConfigPath()}.lock`;
+}
+
+async function withProfilesLock<T>(fn: () => Promise<T>): Promise<T> {
+  const lockPath = getProfilesLockPath();
+  await mkdir(path.dirname(lockPath), { recursive: true });
+
+  const startedAt = Date.now();
+
+  while (true) {
+    try {
+      const handle = await open(lockPath, "wx");
+      try {
+        await handle.writeFile(
+          JSON.stringify(
+            { pid: process.pid, createdAt: new Date().toISOString() },
+            null,
+            2,
+          ),
+          "utf-8",
+        );
+      } finally {
+        await handle.close();
+      }
+      break;
+    } catch (error) {
+      if (!(error instanceof Error) || !("code" in error)) {
+        throw error;
+      }
+
+      if (error.code !== "EEXIST") {
+        throw error;
+      }
+
+      try {
+        const lockStat = await stat(lockPath);
+        const isStale = Date.now() - lockStat.mtimeMs > LOCK_STALE_MS;
+        if (isStale) {
+          await unlink(lockPath).catch(() => {
+            // 他プロセスが先に削除した可能性があるため無視する
+          });
+          continue;
+        }
+      } catch {
+        // lock の stat/unlink が失敗してもリトライする
+      }
+
+      if (Date.now() - startedAt > LOCK_TIMEOUT_MS) {
+        throw new Error(
+          `Timeout acquiring profiles lock: ${lockPath}. Another gwt instance may be running.`,
+        );
+      }
+
+      await new Promise((resolve) =>
+        setTimeout(resolve, LOCK_RETRY_INTERVAL_MS),
+      );
+    }
+  }
+
+  try {
+    return await fn();
+  } finally {
+    await unlink(lockPath).catch(() => {
+      // lock が既に削除されている/削除できない場合は無視する
+    });
+  }
+}
+
+async function mutateProfiles(
+  mutator: (config: ProfilesConfig) => void | Promise<void>,
+): Promise<void> {
+  await withProfilesLock(async () => {
+    const config = await loadProfiles();
+    await mutator(config);
+    await saveProfiles(config);
+  });
+}
+
+/**
+ * プロファイル設定ファイルのパス（後方互換性のためエクスポート）
+ *
+ * @deprecated 内部では getProfilesConfigPath() を使用してください。
+ * この定数はモジュールロード時に評価されるため、
+ * 実行中に環境変数（GWT_HOME/CLAUDE_WORKTREE_HOME）を変更しても反映されません。
+ */
+export const PROFILES_CONFIG_PATH = getProfilesConfigPath();
+
+/**
+ * プロファイル設定を読み込む
+ *
+ * ~/.gwt/profiles.yamlから設定を読み込みます。
+ * ファイルが存在しない場合はデフォルト設定を返します。
+ *
+ * @returns ProfilesConfig
+ * @throws YAML構文エラー時
+ */
+export async function loadProfiles(): Promise<ProfilesConfig> {
+  try {
+    const configPath = getProfilesConfigPath();
+    const content = await readFile(configPath, "utf-8");
+    const config = parseYaml(content) as ProfilesConfig;
+
+    // 基本的な検証
+    if (!config.version || typeof config.version !== "string") {
+      throw new Error("version field is required and must be a string");
+    }
+
+    if (config.profiles && typeof config.profiles !== "object") {
+      throw new Error("profiles field must be an object");
+    }
+
+    if (
+      config.activeProfile !== null &&
+      config.activeProfile !== undefined &&
+      typeof config.activeProfile !== "string"
+    ) {
+      throw new Error("activeProfile field must be a string or null");
+    }
+
+    return {
+      version: config.version,
+      activeProfile: config.activeProfile ?? null,
+      profiles: config.profiles ?? {},
+    };
+  } catch (error) {
+    // ファイルが存在しない場合はデフォルト設定を返す
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      // DEFAULT_PROFILES_CONFIG は不変オブジェクトのため、
+      // 呼び出し側が編集できるように新しい参照を返す
+      return {
+        version: DEFAULT_PROFILES_CONFIG.version,
+        activeProfile: null,
+        profiles: {},
+      };
+    }
+
+    // YAML構文エラーの場合
+    throw error;
+  }
+}
+
+/**
+ * プロファイル設定を保存する
+ *
+ * ~/.gwt/profiles.yamlに設定を保存します。
+ * ディレクトリが存在しない場合は自動的に作成します。
+ *
+ * @param config - 保存するプロファイル設定
+ */
+export async function saveProfiles(config: ProfilesConfig): Promise<void> {
+  const configDir = getConfigDir();
+  const configPath = getProfilesConfigPath();
+  const tempPath = `${configPath}.tmp`;
+
+  await mkdir(configDir, { recursive: true });
+
+  const yaml = stringifyYaml(config);
+  await writeFile(tempPath, yaml, { mode: 0o600 });
+  try {
+    await rename(tempPath, configPath);
+  } catch (error) {
+    await unlink(tempPath).catch(() => {
+      // 一時ファイルが存在しない/削除できない場合は無視する
+    });
+    throw error;
+  }
+}
+
+/**
+ * アクティブなプロファイルを取得
+ *
+ * 現在選択されているプロファイルの設定を返します。
+ * プロファイルが選択されていない場合、または選択されたプロファイルが
+ * 存在しない場合はnullを返します。
+ *
+ * @returns アクティブなプロファイル、またはnull
+ */
+export async function getActiveProfile(): Promise<EnvironmentProfile | null> {
+  const config = await loadProfiles();
+
+  if (!config.activeProfile) {
+    return null;
+  }
+
+  const profile = config.profiles[config.activeProfile];
+  return profile ?? null;
+}
+
+/**
+ * アクティブなプロファイル名を取得
+ *
+ * @returns アクティブなプロファイル名、またはnull
+ */
+export async function getActiveProfileName(): Promise<string | null> {
+  const config = await loadProfiles();
+  return config.activeProfile;
+}
+
+/**
+ * アクティブなプロファイルを設定
+ *
+ * @param profileName - 設定するプロファイル名（nullで無効化）
+ * @throws プロファイルが存在しない場合
+ */
+export async function setActiveProfile(
+  profileName: string | null,
+): Promise<void> {
+  await mutateProfiles(async (config) => {
+    if (profileName !== null && !config.profiles[profileName]) {
+      throw new Error(`Profile "${profileName}" does not exist`);
+    }
+
+    config.activeProfile = profileName;
+  });
+}
+
+/**
+ * 新しいプロファイルを作成
+ *
+ * @param name - プロファイル名
+ * @param profile - プロファイル設定
+ * @throws 既存のプロファイル名の場合
+ * @throws 無効なプロファイル名の場合
+ */
+export async function createProfile(
+  name: string,
+  profile: EnvironmentProfile,
+): Promise<void> {
+  if (!isValidProfileName(name)) {
+    throw new Error(
+      `Invalid profile name: "${name}". Use lowercase letters, numbers, and hyphens (must start and end with a letter or number).`,
+    );
+  }
+
+  await mutateProfiles(async (config) => {
+    if (config.profiles[name]) {
+      throw new Error(`Profile "${name}" already exists`);
+    }
+
+    config.profiles[name] = profile;
+  });
+}
+
+/**
+ * プロファイルを更新
+ *
+ * @param name - プロファイル名
+ * @param updates - 更新するフィールド（envが指定された場合は完全に置き換えられます）
+ * @throws プロファイルが存在しない場合
+ */
+export async function updateProfile(
+  name: string,
+  updates: Partial<EnvironmentProfile>,
+): Promise<void> {
+  await mutateProfiles(async (config) => {
+    if (!config.profiles[name]) {
+      throw new Error(`Profile "${name}" does not exist`);
+    }
+
+    config.profiles[name] = {
+      ...config.profiles[name],
+      ...updates,
+    };
+  });
+}
+
+/**
+ * プロファイルを削除
+ *
+ * @param name - プロファイル名
+ * @throws アクティブなプロファイルの場合
+ * @throws プロファイルが存在しない場合
+ */
+export async function deleteProfile(name: string): Promise<void> {
+  await mutateProfiles(async (config) => {
+    if (!config.profiles[name]) {
+      throw new Error(`Profile "${name}" does not exist`);
+    }
+
+    if (config.activeProfile === name) {
+      throw new Error(
+        `Cannot delete active profile "${name}". Please switch to another profile first.`,
+      );
+    }
+
+    delete config.profiles[name];
+  });
+}
+
+/**
+ * アクティブなプロファイルの環境変数を解決
+ *
+ * AIツール起動時に使用する環境変数を返します。
+ * プロファイルが選択されていない場合は空オブジェクトを返します。
+ *
+ * @returns 環境変数のRecord
+ */
+export async function resolveProfileEnv(): Promise<Record<string, string>> {
+  const profile = await getActiveProfile();
+
+  if (!profile) {
+    return {};
+  }
+
+  return { ...profile.env };
+}

package/src/config/tools.ts

@@ -21,6 +21,7 @@ import type {
   AIToolConfig,
 } from "../types/tools.js";
 import { BUILTIN_TOOLS } from "./builtin-tools.js";
+import { resolveProfileEnv } from "./profiles.js";
 
 /**
  * ツール設定ファイルのパス
@@ -196,9 +197,26 @@ export async function saveToolsConfig(config: ToolsConfig): Promise<void> {
   await rename(TEMP_CONFIG_PATH, TOOLS_CONFIG_PATH);
 }
 
+/**
+ * 共有環境変数を取得
+ *
+ * AIツール起動時に適用される環境変数を返します。
+ * マージ優先順位（後勝ち）:
+ * 1. tools.json の env フィールド
+ * 2. profiles.yaml のアクティブプロファイル
+ *
+ * @returns 環境変数のRecord
+ */
 export async function getSharedEnvironment(): Promise<Record<string, string>> {
-  const config = await loadToolsConfig();
-  return { ...(config.env ?? {}) };
+  const [config, profileEnv] = await Promise.all([
+    loadToolsConfig(),
+    resolveProfileEnv(),
+  ]);
+
+  return {
+    ...(config.env ?? {}),
+    ...profileEnv, // プロファイルが後勝ち
+  };
 }
 
 /**

package/src/types/profiles.ts

@@ -0,0 +1,64 @@
+/**
+ * 環境変数プロファイル型定義
+ *
+ * プロファイル機能で使用する型を定義します。
+ * @see specs/SPEC-dafff079/spec.md
+ */
+
+/**
+ * 環境変数プロファイル
+ *
+ * 環境変数のセットを表します。
+ */
+export interface EnvironmentProfile {
+  /** プロファイルの表示名 */
+  displayName: string;
+  /** プロファイルの説明（オプション） */
+  description?: string;
+  /** 環境変数のキーバリューペア */
+  env: Record<string, string>;
+}
+
+/**
+ * プロファイル設定
+ *
+ * 全プロファイルを管理する設定です。
+ * ~/.gwt/profiles.yaml に保存されます。
+ */
+export interface ProfilesConfig {
+  /** 設定ファイルのバージョン */
+  version: string;
+  /** 現在アクティブなプロファイル名（nullの場合はプロファイルなし） */
+  activeProfile: string | null;
+  /** プロファイルの辞書（キー: プロファイル名、値: プロファイル設定） */
+  profiles: Record<string, EnvironmentProfile>;
+}
+
+/**
+ * デフォルトのプロファイル設定
+ *
+ * profiles.yamlが存在しない場合に使用されます。
+ * 不変オブジェクトとして扱われるため、変更は禁止されています。
+ */
+export const DEFAULT_PROFILES_CONFIG: Readonly<ProfilesConfig> = Object.freeze({
+  version: "1.0",
+  activeProfile: null,
+  profiles: Object.freeze({}),
+});
+
+/**
+ * プロファイル名のバリデーションパターン
+ *
+ * 小文字英数字とハイフンのみを許可し、先頭と末尾は英数字でなければなりません。
+ */
+export const PROFILE_NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+
+/**
+ * プロファイル名をバリデート
+ *
+ * @param name - 検証するプロファイル名
+ * @returns バリデーション結果
+ */
+export function isValidProfileName(name: string): boolean {
+  return name.length > 0 && PROFILE_NAME_PATTERN.test(name);
+}