agent-tower 0.1.0

package/node_modules/@agent-tower/shared/dist/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * 核心业务类型定义
+ * 前后端共享的实体类型、枚举与常量
+ */
+/** 任务状态 */
+export declare enum TaskStatus {
+    TODO = "TODO",
+    IN_PROGRESS = "IN_PROGRESS",
+    IN_REVIEW = "IN_REVIEW",
+    DONE = "DONE",
+    CANCELLED = "CANCELLED"
+}
+/** 工作空间状态 */
+export declare enum WorkspaceStatus {
+    ACTIVE = "ACTIVE",
+    MERGED = "MERGED",
+    ABANDONED = "ABANDONED"
+}
+/** AI 代理类型 */
+export declare enum AgentType {
+    CLAUDE_CODE = "CLAUDE_CODE",
+    GEMINI_CLI = "GEMINI_CLI",
+    CURSOR_AGENT = "CURSOR_AGENT"
+}
+/** 会话状态 */
+export declare enum SessionStatus {
+    PENDING = "PENDING",
+    RUNNING = "RUNNING",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    CANCELLED = "CANCELLED"
+}
+/** 会话用途 */
+export declare enum SessionPurpose {
+    /** 正常用户交互会话 */
+    CHAT = "CHAT",
+    /** 内部：生成 commit message */
+    COMMIT_MSG = "COMMIT_MSG"
+}
+/** 项目 */
+export interface Project {
+    id: string;
+    name: string;
+    color: string;
+    description?: string;
+    /** 仓库路径 (对应 Prisma repoPath) */
+    repoPath: string;
+    /** 主分支名称，默认 "main" */
+    mainBranch: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** 任务 */
+export interface Task {
+    id: string;
+    projectId: string;
+    title: string;
+    description?: string;
+    status: TaskStatus;
+    /** 优先级 (对应 Prisma priority) */
+    priority?: number;
+    /** 排序位置 (对应 Prisma position) */
+    position?: number;
+    /** 关联的工作空间列表（API include 时返回） */
+    workspaces?: Workspace[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** 工作空间 */
+export interface Workspace {
+    id: string;
+    taskId: string;
+    /** 分支名称 (对应 Prisma branchName) */
+    branchName: string;
+    /** worktree 路径 (对应 Prisma worktreePath) */
+    worktreePath: string;
+    status: WorkspaceStatus;
+    /** AI 生成的 commit message（合并时使用） */
+    commitMessage?: string | null;
+    /** 关联的会话列表（API include 时返回） */
+    sessions?: Session[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** 会话 */
+export interface Session {
+    id: string;
+    workspaceId: string;
+    agentType: AgentType;
+    status: SessionStatus;
+    /** 会话用途 */
+    purpose?: SessionPurpose;
+    tokenUsage?: {
+        totalTokens: number;
+        modelContextWindow?: number;
+    } | null;
+    startedAt?: string;
+    endedAt?: string;
+}
+/** Agent 生成的 Todo 项 */
+export interface TodoItem {
+    content: string;
+    status: string;
+    priority?: string | null;
+}
+/** 冲突操作类型 */
+export declare enum ConflictOp {
+    REBASE = "REBASE",
+    MERGE = "MERGE"
+}
+/** Git 操作状态 */
+export interface GitOperationStatus {
+    /** 当前操作类型 */
+    operation: 'idle' | 'rebase' | 'merge';
+    /** 冲突文件列表 */
+    conflictedFiles: string[];
+    /** 冲突操作类型（仅在有冲突时有值） */
+    conflictOp: ConflictOp | null;
+    /** 领先基础分支的提交数 */
+    ahead: number;
+    /** 落后基础分支的提交数 */
+    behind: number;
+    /** 是否有未提交的变更（tracked 文件） */
+    hasUncommittedChanges: boolean;
+    /** 未提交变更的文件数 */
+    uncommittedCount: number;
+    /** 未跟踪文件数 */
+    untrackedCount: number;
+}
+/** 代理可用性检查结果 */
+export interface AgentAvailability {
+    available: boolean;
+    version?: string;
+    error?: string;
+}
+/** 执行器配置 */
+export interface ExecutorConfig {
+    workingDir: string;
+    prompt: string;
+    env?: Record<string, string>;
+}
+/** 附件 */
+export interface Attachment {
+    id: string;
+    originalName: string;
+    mimeType: string;
+    sizeBytes: number;
+    /** HTTP 访问路径: /attachments/:id/file */
+    url: string;
+    /** 磁盘绝对路径，用于传给 agent */
+    storagePath: string;
+    createdAt?: string;
+}
+/** 第三方通知渠道 */
+export type ThirdPartyChannel = 'none' | 'feishu';
+/** 通知事件类型 */
+export type NotificationEventType = 'task_in_review' | 'task_failed';
+/** 通知配置 */
+export interface NotificationSettings {
+    id: string;
+    osNotificationEnabled: boolean;
+    thirdPartyChannel: ThirdPartyChannel;
+    feishuWebhookUrl: string | null;
+    thirdPartyBaseUrl: string | null;
+    taskInReviewTitleTemplate: string;
+    taskInReviewBodyTemplate: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@agent-tower/shared/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/node_modules/@agent-tower/shared/dist/types.js

@@ -0,0 +1,53 @@
+/**
+ * 核心业务类型定义
+ * 前后端共享的实体类型、枚举与常量
+ */
+// ============ 枚举 / 常量 ============
+/** 任务状态 */
+export var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["TODO"] = "TODO";
+    TaskStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    TaskStatus["IN_REVIEW"] = "IN_REVIEW";
+    TaskStatus["DONE"] = "DONE";
+    TaskStatus["CANCELLED"] = "CANCELLED";
+})(TaskStatus || (TaskStatus = {}));
+/** 工作空间状态 */
+export var WorkspaceStatus;
+(function (WorkspaceStatus) {
+    WorkspaceStatus["ACTIVE"] = "ACTIVE";
+    WorkspaceStatus["MERGED"] = "MERGED";
+    WorkspaceStatus["ABANDONED"] = "ABANDONED";
+})(WorkspaceStatus || (WorkspaceStatus = {}));
+/** AI 代理类型 */
+export var AgentType;
+(function (AgentType) {
+    AgentType["CLAUDE_CODE"] = "CLAUDE_CODE";
+    AgentType["GEMINI_CLI"] = "GEMINI_CLI";
+    AgentType["CURSOR_AGENT"] = "CURSOR_AGENT";
+})(AgentType || (AgentType = {}));
+/** 会话状态 */
+export var SessionStatus;
+(function (SessionStatus) {
+    SessionStatus["PENDING"] = "PENDING";
+    SessionStatus["RUNNING"] = "RUNNING";
+    SessionStatus["COMPLETED"] = "COMPLETED";
+    SessionStatus["FAILED"] = "FAILED";
+    SessionStatus["CANCELLED"] = "CANCELLED";
+})(SessionStatus || (SessionStatus = {}));
+/** 会话用途 */
+export var SessionPurpose;
+(function (SessionPurpose) {
+    /** 正常用户交互会话 */
+    SessionPurpose["CHAT"] = "CHAT";
+    /** 内部：生成 commit message */
+    SessionPurpose["COMMIT_MSG"] = "COMMIT_MSG";
+})(SessionPurpose || (SessionPurpose = {}));
+// ============ Git 操作类型 ============
+/** 冲突操作类型 */
+export var ConflictOp;
+(function (ConflictOp) {
+    ConflictOp["REBASE"] = "REBASE";
+    ConflictOp["MERGE"] = "MERGE";
+})(ConflictOp || (ConflictOp = {}));
+//# sourceMappingURL=types.js.map

package/node_modules/@agent-tower/shared/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oCAAoC;AAEpC,WAAW;AACX,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,yCAA2B,CAAA;IAC3B,qCAAuB,CAAA;IACvB,2BAAa,CAAA;IACb,qCAAuB,CAAA;AACzB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB;AAED,aAAa;AACb,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,0CAAuB,CAAA;AACzB,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED,cAAc;AACd,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,wCAA2B,CAAA;IAC3B,sCAAyB,CAAA;IACzB,0CAA6B,CAAA;AAC/B,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB;AAED,WAAW;AACX,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;AACzB,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAED,WAAW;AACX,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,eAAe;IACf,+BAAa,CAAA;IACb,2BAA2B;IAC3B,2CAAyB,CAAA;AAC3B,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AA0ED,qCAAqC;AAErC,aAAa;AACb,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,6BAAe,CAAA;AACjB,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB"}

package/node_modules/@agent-tower/shared/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@agent-tower/shared",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./socket": {
+      "types": "./dist/socket/index.d.ts",
+      "import": "./dist/socket/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./log-adapter": {
+      "types": "./dist/log-adapter.d.ts",
+      "import": "./dist/log-adapter.js"
+    },
+    "./dev-port": {
+      "types": "./dist/dev-port.d.ts",
+      "import": "./dist/dev-port.js"
+    }
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3"
+  }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "agent-tower",
+  "version": "0.1.0",
+  "description": "AI Agent Task Management Dashboard",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "agent-tower": "./dist/cli.js",
+    "agent-tower-mcp": "./dist/mcp/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist/",
+    "prisma/",
+    "scripts/",
+    "node_modules/@agent-tower/"
+  ],
+  "scripts": {
+    "postinstall": "prisma generate && node scripts/postinstall.js"
+  },
+  "dependencies": {
+    "@agent-tower/shared": "0.1.0",
+    "@fastify/cors": "^9.0.1",
+    "@fastify/multipart": "^8.3.1",
+    "@fastify/static": "^7.0.4",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@prisma/client": "^5.9.1",
+    "cloudflared": "^0.7.1",
+    "fast-json-patch": "^3.1.1",
+    "fastify": "^4.26.0",
+    "node-pty": "^1.0.0",
+    "simple-git": "^3.22.0",
+    "socket.io": "^4.8.3",
+    "zod": "^3.22.4",
+    "prisma": "^5.9.1"
+  },
+  "optionalDependencies": {
+    "fsevents": "~2.3.3"
+  },
+  "bundledDependencies": [
+    "@agent-tower/shared"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/prisma/schema.prisma

@@ -0,0 +1,130 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "sqlite"
+  url      = env("DATABASE_URL")
+}
+
+// 项目
+model Project {
+  id          String   @id @default(uuid())
+  name        String
+  description String?
+  repoPath    String
+  mainBranch  String   @default("main")
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+  tasks       Task[]
+}
+
+// 任务
+// TaskStatus: TODO, IN_PROGRESS, IN_REVIEW, DONE, CANCELLED
+model Task {
+  id          String      @id @default(uuid())
+  title       String
+  description String?
+  status      String      @default("TODO")
+  priority    Int         @default(0)
+  position    Int         @default(0)
+  projectId   String
+  project     Project     @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  workspaces  Workspace[]
+  createdAt   DateTime    @default(now())
+  updatedAt   DateTime    @updatedAt
+
+  @@index([projectId])
+  @@index([status])
+}
+
+// 工作空间 (对应一个 git worktree)
+// WorkspaceStatus: ACTIVE, MERGED, ABANDONED
+model Workspace {
+  id            String    @id @default(uuid())
+  taskId        String
+  task          Task      @relation(fields: [taskId], references: [id], onDelete: Cascade)
+  branchName    String
+  worktreePath  String
+  status        String    @default("ACTIVE")
+  commitMessage String?   // AI 生成的 commit message（合并时使用）
+  sessions      Session[]
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+
+  @@index([taskId])
+}
+
+// 会话 (一次 AI 代理执行)
+// AgentType: CLAUDE_CODE, GEMINI_CLI, CURSOR_AGENT
+// SessionStatus: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED
+// SessionPurpose: CHAT, COMMIT_MSG
+model Session {
+  id           String             @id @default(uuid())
+  workspaceId  String
+  workspace    Workspace          @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
+  agentType    String
+  variant      String             @default("DEFAULT")
+  prompt       String
+  status       String             @default("PENDING")
+  purpose      String             @default("CHAT")  // CHAT: 正常会话, COMMIT_MSG: 生成提交消息
+  logSnapshot  String?            // 序列化的 NormalizedConversation JSON，session 结束时持久化
+  tokenUsage   String?            // JSON: { totalTokens, modelContextWindow? }
+  processes    ExecutionProcess[]
+  createdAt    DateTime           @default(now())
+  updatedAt    DateTime           @updatedAt
+
+  @@index([workspaceId])
+}
+
+// 执行进程
+model ExecutionProcess {
+  id        String   @id @default(uuid())
+  sessionId String
+  session   Session  @relation(fields: [sessionId], references: [id], onDelete: Cascade)
+  pid       Int?
+  exitCode  Int?
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([sessionId])
+}
+
+// 执行日志
+model ExecutionLog {
+  id        String   @id @default(uuid())
+  processId String
+  content   String
+  timestamp DateTime @default(now())
+
+  @@index([processId])
+}
+
+// 附件
+model Attachment {
+  id           String   @id @default(uuid())
+  originalName String
+  mimeType     String
+  sizeBytes    Int
+  storagePath  String
+  hash         String
+  createdAt    DateTime @default(now())
+
+  @@index([hash])
+}
+
+// 通知配置 (单例，只有一行)
+// thirdPartyChannel: none, feishu
+model NotificationSettings {
+  id                    String  @id @default("singleton")
+  osNotificationEnabled Boolean @default(true)
+  thirdPartyChannel     String  @default("none")
+  feishuWebhookUrl      String?
+
+  // 第三方通知跳转地址
+  thirdPartyBaseUrl String?
+
+  // 通知模板
+  taskInReviewTitleTemplate String  @default("Agent Tower")
+  taskInReviewBodyTemplate  String  @default("✅ \"{taskTitle}\" 已完成，等待审查")
+}

package/scripts/postinstall.js

@@ -0,0 +1,120 @@
+/**
+ * postinstall 脚本 - 修复 node-pty 原生模块权限问题
+ *
+ * 问题背景：
+ * node-pty 是一个用于创建伪终端 (PTY) 的 Node.js 库，用于与 Claude Code、Gemini CLI 等 Agent 进行交互。
+ * 在 macOS 上，pnpm 安装 node-pty 时，预编译的 spawn-helper 二进制文件可能会丢失执行权限，
+ * 导致 "posix_spawnp failed" 错误。
+ *
+ * 解决方案：
+ * 在 postinstall 阶段自动为 spawn-helper 添加执行权限。
+ */
+
+import { readdirSync, chmodSync, statSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/**
+ * 向上查找 monorepo 根目录（包含 pnpm-workspace.yaml 或根 node_modules）
+ */
+function findMonorepoRoot(startDir) {
+  let dir = startDir;
+  while (dir !== dirname(dir)) {
+    // 检查是否存在 pnpm-workspace.yaml（pnpm monorepo 标志）
+    if (existsSync(join(dir, 'pnpm-workspace.yaml'))) {
+      return dir;
+    }
+    // 检查是否存在 node_modules/.pnpm（pnpm 的依赖目录）
+    if (existsSync(join(dir, 'node_modules', '.pnpm'))) {
+      return dir;
+    }
+    dir = dirname(dir);
+  }
+  return null;
+}
+
+/**
+ * 递归查找匹配的文件
+ */
+function findFiles(dir, pattern, results = [], depth = 0, maxDepth = 10) {
+  if (depth > maxDepth) return results;
+
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        // 跳过隐藏目录（除了 .pnpm）
+        if (entry.name.startsWith('.') && entry.name !== '.pnpm') {
+          continue;
+        }
+        findFiles(fullPath, pattern, results, depth + 1, maxDepth);
+      } else if (pattern.test(entry.name)) {
+        results.push(fullPath);
+      }
+    }
+  } catch {
+    // 忽略无法访问的目录
+  }
+  return results;
+}
+
+/**
+ * 修复 spawn-helper 权限
+ */
+function fixSpawnHelperPermissions() {
+  // 1. 优先查找包自身的 node_modules（npm 全局安装场景）
+  const packageRoot = join(__dirname, '..');
+  const localNodeModules = join(packageRoot, 'node_modules');
+
+  // 2. 尝试查找 monorepo 根目录（pnpm monorepo 场景）
+  const monorepoRoot = findMonorepoRoot(__dirname);
+  const monorepoNodeModules = monorepoRoot ? join(monorepoRoot, 'node_modules') : null;
+
+  // 收集所有需要搜索的 node_modules 目录（去重）
+  const searchDirs = [];
+  if (existsSync(localNodeModules)) {
+    searchDirs.push(localNodeModules);
+  }
+  if (monorepoNodeModules && monorepoNodeModules !== localNodeModules && existsSync(monorepoNodeModules)) {
+    searchDirs.push(monorepoNodeModules);
+  }
+
+  if (searchDirs.length === 0) {
+    console.log('[postinstall] 未找到 node_modules 目录，跳过 spawn-helper 权限修复');
+    return;
+  }
+
+  let fixed = 0;
+  for (const nodeModulesDir of searchDirs) {
+    console.log(`[postinstall] 在 ${nodeModulesDir} 中查找 spawn-helper...`);
+    const spawnHelpers = findFiles(nodeModulesDir, /^spawn-helper$/);
+
+    for (const file of spawnHelpers) {
+      if (!file.includes('node-pty')) continue;
+
+      try {
+        const stats = statSync(file);
+        const isExecutable = (stats.mode & 0o111) !== 0;
+
+        if (!isExecutable) {
+          chmodSync(file, 0o755);
+          console.log(`[postinstall] 已修复 spawn-helper 权限: ${file}`);
+          fixed++;
+        }
+      } catch (err) {
+        console.warn(`[postinstall] 无法修复权限: ${file}`, err.message);
+      }
+    }
+  }
+
+  if (fixed > 0) {
+    console.log(`[postinstall] 共修复 ${fixed} 个 spawn-helper 文件`);
+  } else {
+    console.log('[postinstall] 所有 spawn-helper 权限正常，无需修复');
+  }
+}
+
+fixSpawnHelperPermissions();