@akiojin/gwt 2.0.0

package/src/types/api.ts

@@ -0,0 +1,241 @@
+/**
+ * Web UI API型定義
+ *
+ * データモデル仕様: specs/SPEC-d5e56259/data-model.md
+ * REST API仕様: specs/SPEC-d5e56259/contracts/rest-api.yaml
+ */
+
+/**
+ * Branch - Gitブランチ
+ */
+export interface Branch {
+  name: string;
+  type: "local" | "remote";
+  commitHash: string;
+  commitMessage?: string | null;
+  author?: string | null;
+  commitDate?: string | null; // ISO8601
+  mergeStatus: "unmerged" | "merged" | "unknown";
+  hasUnpushedCommits: boolean;
+  worktreePath?: string | null;
+  baseBranch?: string | null;
+  divergence?: {
+    ahead: number;
+    behind: number;
+    upToDate: boolean;
+  } | null;
+  prInfo?: {
+    number: number;
+    title: string;
+    state: "open" | "merged" | "closed";
+    mergedAt?: string | null;
+  } | null;
+}
+
+/**
+ * Worktree - Gitワークツリー
+ */
+export interface Worktree {
+  path: string;
+  branchName: string;
+  head: string;
+  isLocked: boolean;
+  isPrunable: boolean;
+  isProtected: boolean;
+  createdAt?: string | null; // ISO8601
+  lastAccessedAt?: string | null; // ISO8601
+  divergence?: Branch["divergence"];
+  prInfo?: Branch["prInfo"];
+}
+
+/**
+ * AIToolSession - AI Tool実行セッション
+ */
+export interface AIToolSession {
+  sessionId: string; // UUID v4
+  toolType: "claude-code" | "codex-cli" | "custom";
+  toolName?: string | null;
+  mode: "normal" | "continue" | "resume";
+  worktreePath: string;
+  ptyPid?: number | null;
+  websocketId?: string | null;
+  status: "pending" | "running" | "completed" | "failed";
+  startedAt: string; // ISO8601
+  endedAt?: string | null; // ISO8601
+  exitCode?: number | null;
+  errorMessage?: string | null;
+}
+
+/**
+ * CustomAITool - カスタムAI Tool設定
+ */
+export interface EnvironmentVariable {
+  key: string;
+  value: string;
+  lastUpdated?: string | null;
+  importedFromOs?: boolean;
+}
+
+export interface EnvironmentHistoryEntry {
+  key: string;
+  action: "add" | "update" | "delete" | "import";
+  timestamp: string;
+  source: "ui" | "os" | "cli";
+}
+
+export interface CustomAITool {
+  id: string; // UUID v4 or slug
+  displayName: string;
+  icon?: string | null;
+  command: string;
+  executionType: "path" | "bunx" | "command";
+  defaultArgs?: string[] | null;
+  modeArgs: {
+    normal?: string[];
+    continue?: string[];
+    resume?: string[];
+  };
+  permissionSkipArgs?: string[] | null;
+  env?: EnvironmentVariable[] | null;
+  description?: string | null;
+  createdAt?: string | null; // ISO8601
+  updatedAt?: string | null; // ISO8601
+}
+
+/**
+ * REST API Response wrappers
+ */
+export interface SuccessResponse<T = unknown> {
+  success: true;
+  data: T;
+}
+
+export interface ErrorResponse {
+  success: false;
+  error: string;
+  details?: string | null;
+}
+
+export type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;
+
+/**
+ * API Endpoints
+ */
+export interface HealthResponse {
+  success: true;
+  status: string;
+  timestamp: string; // ISO8601
+}
+
+export type BranchListResponse = SuccessResponse<Branch[]>;
+export type BranchResponse = SuccessResponse<Branch>;
+export type BranchSyncResponse = SuccessResponse<BranchSyncResult>;
+export type WorktreeListResponse = SuccessResponse<Worktree[]>;
+export type WorktreeResponse = SuccessResponse<Worktree>;
+export type SessionListResponse = SuccessResponse<AIToolSession[]>;
+export type SessionResponse = SuccessResponse<AIToolSession>;
+export interface ConfigPayload {
+  version: string;
+  updatedAt?: string | null;
+  env?: EnvironmentVariable[] | null;
+  history?: EnvironmentHistoryEntry[] | null;
+  tools: CustomAITool[];
+}
+
+export type ConfigResponse = SuccessResponse<ConfigPayload>;
+
+/**
+ * API Request bodies
+ */
+export interface CreateWorktreeRequest {
+  branchName: string;
+  createBranch?: boolean;
+}
+
+export interface BranchSyncRequest {
+  worktreePath: string;
+}
+
+export interface StartSessionRequest {
+  toolType: "claude-code" | "codex-cli" | "custom";
+  toolName?: string | null;
+  mode: "normal" | "continue" | "resume";
+  worktreePath: string;
+  skipPermissions?: boolean;
+  bypassApprovals?: boolean;
+  extraArgs?: string[];
+  customToolId?: string | null;
+}
+
+export type UpdateConfigRequest = ConfigPayload;
+
+export interface CleanupResponse {
+  success: true;
+  deleted: string[];
+}
+
+export interface BranchSyncResult {
+  branch: Branch;
+  divergence?: Branch["divergence"];
+  fetchStatus: "success";
+  pullStatus: "success" | "failed";
+  warnings?: string[];
+}
+
+/**
+ * WebSocket Messages
+ */
+export interface WebSocketMessage {
+  type: string;
+  data?: unknown;
+  timestamp?: string; // ISO8601
+}
+
+export interface InputMessage extends WebSocketMessage {
+  type: "input";
+  data: string;
+}
+
+export interface ResizeMessage extends WebSocketMessage {
+  type: "resize";
+  data: {
+    cols: number;
+    rows: number;
+  };
+}
+
+export interface PingMessage extends WebSocketMessage {
+  type: "ping";
+}
+
+export interface OutputMessage extends WebSocketMessage {
+  type: "output";
+  data: string;
+}
+
+export interface ExitMessage extends WebSocketMessage {
+  type: "exit";
+  data: {
+    code: number;
+    signal?: string;
+  };
+}
+
+export interface ErrorMessage extends WebSocketMessage {
+  type: "error";
+  data: {
+    message: string;
+    code?: string;
+  };
+}
+
+export interface PongMessage extends WebSocketMessage {
+  type: "pong";
+}
+
+export type ClientMessage = InputMessage | ResizeMessage | PingMessage;
+export type ServerMessage =
+  | OutputMessage
+  | ExitMessage
+  | ErrorMessage
+  | PongMessage;

package/src/types/tools.ts

@@ -0,0 +1,235 @@
+/**
+ * カスタムAIツール対応機能の型定義
+ *
+ * この型定義ファイルは、設定ファイル（tools.json）のスキーマと
+ * 内部で使用するデータ構造を定義します。
+ */
+
+// ============================================================================
+// 設定ファイルのスキーマ
+// ============================================================================
+
+/**
+ * ツール実行方式
+ *
+ * - path: 絶対パスで直接実行（例: /usr/local/bin/my-tool）
+ * - bunx: bunx経由でパッケージを実行（例: @org/package@latest）
+ * - command: PATH環境変数から探して実行（例: aider）
+ */
+export type ToolExecutionType = "path" | "bunx" | "command";
+
+/**
+ * 実行モード別引数
+ *
+ * 各モードで使用する引数の配列を定義します。
+ * 少なくとも1つのモードを定義する必要があります。
+ */
+export interface ModeArgs {
+  /**
+   * 通常モード時の引数
+   */
+  normal?: string[];
+
+  /**
+   * 継続モード時の引数
+   */
+  continue?: string[];
+
+  /**
+   * 再開モード時の引数
+   */
+  resume?: string[];
+}
+
+/**
+ * カスタムAIツール定義
+ *
+ * tools.jsonファイルで定義される個別のツール設定。
+ */
+export interface CustomAITool {
+  /**
+   * ツールの一意識別子
+   *
+   * 小文字英数字とハイフンのみ使用可能（パターン: ^[a-z0-9-]+$）
+   * ビルトインツール（claude-code, codex-cli）との重複は不可。
+   */
+  id: string;
+
+  /**
+   * UI表示名
+   *
+   * ツール選択画面で表示される名前。日本語も使用可能。
+   */
+  displayName: string;
+
+  /**
+   * アイコン文字（オプション）
+   *
+   * ツール選択画面で表示されるUnicode文字。
+   */
+  icon?: string;
+
+  /**
+   * 実行方式
+   *
+   * - "path": 絶対パスで直接実行
+   * - "bunx": bunx経由でパッケージを実行
+   * - "command": PATH環境変数から探して実行
+   */
+  type: ToolExecutionType;
+
+  /**
+   * 実行パス/パッケージ名/コマンド名
+   *
+   * typeに応じた値を設定：
+   * - type="path": 絶対パス（例: /usr/local/bin/my-tool）
+   * - type="bunx": パッケージ名（例: @org/package@latest）
+   * - type="command": コマンド名（例: aider）
+   */
+  command: string;
+
+  /**
+   * デフォルト引数（オプション）
+   *
+   * ツール実行時に常に付与される引数。
+   * 最終的な引数は: defaultArgs + modeArgs[mode] + permissionSkipArgs + extraArgs
+   */
+  defaultArgs?: string[];
+
+  /**
+   * モード別引数
+   *
+   * normal/continue/resumeの各モードで使用する引数。
+   * 少なくとも1つのモードを定義する必要があります。
+   */
+  modeArgs: ModeArgs;
+
+  /**
+   * 権限スキップ時の引数（オプション）
+   *
+   * ユーザーが権限スキップを有効にした場合に追加される引数。
+   */
+  permissionSkipArgs?: string[];
+
+  /**
+   * 環境変数（オプション）
+   *
+   * ツール起動時に設定される環境変数。
+   * APIキーや設定ファイルパスなどを指定。
+   */
+  env?: Record<string, string>;
+}
+
+/**
+ * ツール設定ファイル全体
+ *
+ * ~/.gwt/tools.json のスキーマ。
+ */
+export interface ToolsConfig {
+  /**
+   * 設定フォーマットのバージョン
+   *
+   * セマンティックバージョニング形式。
+   */
+  version: string;
+
+  /**
+   * 設定ファイルの最終更新日時（ISO8601）
+   */
+  updatedAt?: string;
+
+  /**
+   * すべてのツールで共有する環境変数
+   */
+  env?: Record<string, string>;
+
+  /**
+   * カスタムツール定義の配列
+   *
+   * 空配列も許可（ビルトインツールのみ使用）。
+   */
+  customTools: CustomAITool[];
+}
+
+// ============================================================================
+// 内部使用の型定義
+// ============================================================================
+
+/**
+ * 統合ツール設定
+ *
+ * ビルトインツールとカスタムツールを統合して扱うための内部型。
+ * getAllTools() 関数がこの型の配列を返します。
+ */
+export interface AIToolConfig {
+  /**
+   * ツールID
+   *
+   * ビルトイン: "claude-code" | "codex-cli"
+   * カスタム: CustomAITool.id
+   */
+  id: string;
+
+  /**
+   * UI表示名
+   */
+  displayName: string;
+
+  /**
+   * アイコン文字（オプション）
+   */
+  icon?: string;
+
+  /**
+   * ビルトインツールかどうか
+   *
+   * true: Claude Code または Codex CLI
+   * false: カスタムツール
+   */
+  isBuiltin: boolean;
+
+  /**
+   * カスタムツールの場合、元の設定
+   *
+   * isBuiltin=false の場合のみ存在。
+   */
+  customConfig?: CustomAITool;
+}
+
+/**
+ * ツール起動オプション
+ *
+ * launchCustomAITool() 関数の引数として使用。
+ */
+export interface LaunchOptions {
+  /**
+   * 実行モード
+   */
+  mode?: "normal" | "continue" | "resume";
+
+  /**
+   * 権限スキップを有効にするか
+   *
+   * true の場合、permissionSkipArgs が追加されます。
+   */
+  skipPermissions?: boolean;
+
+  /**
+   * 追加引数
+   *
+   * コマンドラインから -- 以降に渡された引数。
+   */
+  extraArgs?: string[];
+
+  /**
+   * 作業ディレクトリ（ワークツリーパス）
+   *
+   * ツール起動時のcwdとして使用されます。
+   */
+  cwd?: string;
+
+  /**
+   * 共有環境変数（共通env + ローカル取り込み）
+   */
+  sharedEnv?: Record<string, string>;
+}

package/src/utils/spinner.ts

@@ -0,0 +1,54 @@
+const SPINNER_FRAMES = [
+  "⠋",
+  "⠙",
+  "⠹",
+  "⠸",
+  "⠼",
+  "⠴",
+  "⠦",
+  "⠧",
+  "⠇",
+  "⠏",
+] as const;
+const FRAME_INTERVAL_MS = 80;
+
+function isWritableStream(
+  stream: NodeJS.WriteStream | undefined,
+): stream is NodeJS.WriteStream {
+  return Boolean(stream && typeof stream.write === "function");
+}
+
+/**
+ * CLI用の簡易スピナーを開始する。
+ * 戻り値の関数を呼び出すとスピナーが停止して行をクリアします。
+ */
+export function startSpinner(message: string): () => void {
+  const stream = process.stdout;
+
+  if (!isWritableStream(stream) || stream.isTTY === false) {
+    return () => {};
+  }
+
+  let frameIndex = 0;
+  let active = true;
+  const padding = " ".repeat(message.length + 2);
+
+  const render = () => {
+    if (!active) return;
+    const frame = SPINNER_FRAMES[frameIndex];
+    frameIndex = (frameIndex + 1) % SPINNER_FRAMES.length;
+    stream.write(`\r${frame} ${message}`);
+  };
+
+  render();
+  const timer = setInterval(render, FRAME_INTERVAL_MS);
+
+  const stop = () => {
+    if (!active) return;
+    active = false;
+    clearInterval(timer);
+    stream.write(`\r${padding}\r`);
+  };
+
+  return stop;
+}