agent-tower 0.1.0

package/dist/executors/profiles.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ExecutorProfiles — 执行器配置管理
+ *
+ * 数据结构: { executors: { [AgentType]: { [variant]: config } } }
+ * - 内置默认配置 (default-profiles.json)
+ * - 用户自定义覆盖 (data 目录下 profiles.json)
+ * - 合并策略: 用户配置覆盖默认，但不能删除内置 executor
+ */
+import { AgentType } from '../types/index.js';
+/** 单个 variant 的配置，字段取决于 agent 类型 */
+export type VariantConfig = Record<string, unknown>;
+/** 某个 agent 的所有 variant 配置 */
+export type AgentVariants = Record<string, VariantConfig>;
+/** 完整的 profiles 结构 */
+export interface ExecutorProfiles {
+    executors: Record<string, AgentVariants>;
+}
+/**
+ * 深度合并: 用户配置覆盖默认配置
+ * - 用户可以新增 executor / variant
+ * - 用户可以覆盖已有 variant 的配置
+ * - 不会删除默认的 executor 或 variant
+ */
+export declare function mergeWithDefaults(defaults: ExecutorProfiles, overrides: ExecutorProfiles): ExecutorProfiles;
+/**
+ * 加载 profiles（默认 + 用户覆盖合并）
+ */
+export declare function loadProfiles(): ExecutorProfiles;
+/**
+ * 获取当前 profiles（带缓存）
+ */
+export declare function getProfiles(): ExecutorProfiles;
+/**
+ * 重新加载 profiles
+ */
+export declare function reloadProfiles(): ExecutorProfiles;
+/**
+ * 获取某个 agent 的某个 variant 配置
+ */
+export declare function getVariantConfig(agentType: AgentType | string, variant?: string): VariantConfig | null;
+/**
+ * 获取某个 agent 的所有 variant 名称
+ */
+export declare function getVariantNames(agentType: AgentType | string): string[];
+/**
+ * 保存用户覆盖配置
+ */
+export declare function saveProfiles(profiles: ExecutorProfiles): void;
+/**
+ * 更新某个 variant 配置
+ */
+export declare function setVariantConfig(agentType: AgentType | string, variant: string, config: VariantConfig): void;
+/**
+ * 删除某个 variant 配置（不允许删除内置默认的 DEFAULT）
+ */
+export declare function deleteVariantConfig(agentType: AgentType | string, variant: string): boolean;
+/**
+ * 获取默认 profiles（不含用户覆盖）
+ */
+export declare function getDefaultProfiles(): ExecutorProfiles;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/executors/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/executors/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,8BAA8B;AAC9B,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE1D,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC1C;AA4BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,gBAAgB,GAC1B,gBAAgB,CAmBlB;AAkCD;;GAEG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CAqB/C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,gBAAgB,CAK9C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAGjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,GAAG,MAAM,EAC7B,OAAO,GAAE,MAAkB,GAC1B,aAAa,GAAG,IAAI,CAOtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,CAKvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAc7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,GAAG,MAAM,EAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,GACpB,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,GAAG,MAAM,EAC7B,OAAO,EAAE,MAAM,GACd,OAAO,CAoBT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,gBAAgB,CAErD"}

package/dist/executors/profiles.js

@@ -0,0 +1,192 @@
+/**
+ * ExecutorProfiles — 执行器配置管理
+ *
+ * 数据结构: { executors: { [AgentType]: { [variant]: config } } }
+ * - 内置默认配置 (default-profiles.json)
+ * - 用户自定义覆盖 (data 目录下 profiles.json)
+ * - 合并策略: 用户配置覆盖默认，但不能删除内置 executor
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+// ─── Defaults ────────────────────────────────────────────────────
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const defaultProfilesJson = require('./default-profiles.json');
+const DEFAULT_PROFILES = defaultProfilesJson;
+// ─── State ───────────────────────────────────────────────────────
+let cachedProfiles = null;
+// ─── User overrides path ─────────────────────────────────────────
+function getUserProfilesPath() {
+    if (process.env.AGENT_TOWER_DATA_DIR) {
+        return path.join(process.env.AGENT_TOWER_DATA_DIR, 'profiles.json');
+    }
+    // 开发模式回退: server 包根目录的 data 目录
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const serverRoot = path.resolve(__dirname, '..', '..');
+    return path.join(serverRoot, 'data', 'profiles.json');
+}
+// ─── Core functions ──────────────────────────────────────────────
+/**
+ * 深度合并: 用户配置覆盖默认配置
+ * - 用户可以新增 executor / variant
+ * - 用户可以覆盖已有 variant 的配置
+ * - 不会删除默认的 executor 或 variant
+ */
+export function mergeWithDefaults(defaults, overrides) {
+    const merged = {
+        executors: { ...defaults.executors },
+    };
+    for (const [agentType, overrideVariants] of Object.entries(overrides.executors)) {
+        if (merged.executors[agentType]) {
+            // 合并 variant 级别
+            merged.executors[agentType] = {
+                ...merged.executors[agentType],
+                ...overrideVariants,
+            };
+        }
+        else {
+            // 新增的 agent 类型
+            merged.executors[agentType] = { ...overrideVariants };
+        }
+    }
+    return merged;
+}
+/**
+ * 计算用户覆盖部分（与默认不同的配置）
+ */
+function computeOverrides(defaults, current) {
+    const overrides = { executors: {} };
+    for (const [agentType, variants] of Object.entries(current.executors)) {
+        const defaultVariants = defaults.executors[agentType];
+        if (!defaultVariants) {
+            // 整个 agent 是用户新增的
+            overrides.executors[agentType] = { ...variants };
+            continue;
+        }
+        for (const [variantName, config] of Object.entries(variants)) {
+            const defaultConfig = defaultVariants[variantName];
+            if (!defaultConfig || JSON.stringify(defaultConfig) !== JSON.stringify(config)) {
+                if (!overrides.executors[agentType]) {
+                    overrides.executors[agentType] = {};
+                }
+                overrides.executors[agentType][variantName] = config;
+            }
+        }
+    }
+    return overrides;
+}
+/**
+ * 加载 profiles（默认 + 用户覆盖合并）
+ */
+export function loadProfiles() {
+    const defaults = structuredClone(DEFAULT_PROFILES);
+    const userPath = getUserProfilesPath();
+    let userOverrides = null;
+    try {
+        if (fs.existsSync(userPath)) {
+            const content = fs.readFileSync(userPath, 'utf-8');
+            userOverrides = JSON.parse(content);
+        }
+    }
+    catch (e) {
+        console.error('[Profiles] Failed to load user profiles.json:', e);
+    }
+    if (userOverrides) {
+        cachedProfiles = mergeWithDefaults(defaults, userOverrides);
+    }
+    else {
+        cachedProfiles = defaults;
+    }
+    return cachedProfiles;
+}
+/**
+ * 获取当前 profiles（带缓存）
+ */
+export function getProfiles() {
+    if (!cachedProfiles) {
+        return loadProfiles();
+    }
+    return cachedProfiles;
+}
+/**
+ * 重新加载 profiles
+ */
+export function reloadProfiles() {
+    cachedProfiles = null;
+    return loadProfiles();
+}
+/**
+ * 获取某个 agent 的某个 variant 配置
+ */
+export function getVariantConfig(agentType, variant = 'DEFAULT') {
+    const profiles = getProfiles();
+    const agentVariants = profiles.executors[agentType];
+    if (!agentVariants)
+        return null;
+    const normalizedVariant = variant.toUpperCase();
+    return agentVariants[normalizedVariant] ?? null;
+}
+/**
+ * 获取某个 agent 的所有 variant 名称
+ */
+export function getVariantNames(agentType) {
+    const profiles = getProfiles();
+    const agentVariants = profiles.executors[agentType];
+    if (!agentVariants)
+        return [];
+    return Object.keys(agentVariants);
+}
+/**
+ * 保存用户覆盖配置
+ */
+export function saveProfiles(profiles) {
+    const defaults = structuredClone(DEFAULT_PROFILES);
+    const overrides = computeOverrides(defaults, profiles);
+    const userPath = getUserProfilesPath();
+    const dir = path.dirname(userPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(userPath, JSON.stringify(overrides, null, 2), 'utf-8');
+    // 更新缓存
+    cachedProfiles = profiles;
+}
+/**
+ * 更新某个 variant 配置
+ */
+export function setVariantConfig(agentType, variant, config) {
+    const profiles = structuredClone(getProfiles());
+    const normalizedVariant = variant.toUpperCase();
+    if (!profiles.executors[agentType]) {
+        profiles.executors[agentType] = {};
+    }
+    profiles.executors[agentType][normalizedVariant] = config;
+    saveProfiles(profiles);
+}
+/**
+ * 删除某个 variant 配置（不允许删除内置默认的 DEFAULT）
+ */
+export function deleteVariantConfig(agentType, variant) {
+    const normalizedVariant = variant.toUpperCase();
+    // 检查是否是内置默认配置
+    const defaultVariants = DEFAULT_PROFILES.executors[agentType];
+    if (defaultVariants && normalizedVariant in defaultVariants) {
+        throw new Error(`Cannot delete built-in variant '${normalizedVariant}' of '${agentType}'. You can override it instead.`);
+    }
+    const profiles = structuredClone(getProfiles());
+    const agentVariants = profiles.executors[agentType];
+    if (!agentVariants || !(normalizedVariant in agentVariants)) {
+        return false;
+    }
+    delete agentVariants[normalizedVariant];
+    saveProfiles(profiles);
+    return true;
+}
+/**
+ * 获取默认 profiles（不含用户覆盖）
+ */
+export function getDefaultProfiles() {
+    return structuredClone(DEFAULT_PROFILES);
+}
+//# sourceMappingURL=profiles.js.map

package/dist/executors/profiles.js.map

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

package/dist/git/git-cli.d.ts

@@ -0,0 +1,59 @@
+import { ConflictOp } from '@agent-tower/shared';
+export declare class GitError extends Error {
+    code: string;
+    constructor(message: string, code?: string);
+}
+export declare class BranchNotFoundError extends GitError {
+    constructor(branchName: string);
+}
+export declare class BranchExistsError extends GitError {
+    constructor(branchName: string);
+}
+export declare class InvalidBranchNameError extends GitError {
+    constructor(branchName: string, reason?: string);
+}
+export declare class WorktreeNotFoundError extends GitError {
+    constructor(worktreePath: string);
+}
+export declare class WorktreeDirtyError extends GitError {
+    constructor(worktreePath: string);
+}
+export declare class MergeConflictError extends GitError {
+    conflictedFiles: string[];
+    conflictOp: ConflictOp;
+    constructor(conflictedFiles: string[], conflictOp?: ConflictOp);
+}
+export declare class RebaseInProgressError extends GitError {
+    constructor();
+}
+export declare class BranchesDivergedError extends GitError {
+    ahead: number;
+    behind: number;
+    constructor(taskBranch: string, baseBranch: string, ahead: number, behind: number);
+}
+/**
+ * Execute a git command in the given repository path.
+ * All git operations go through this single entry point for uniform error handling.
+ */
+export declare function execGit(repoPath: string, args: string[], options?: {
+    timeout?: number;
+}): Promise<string>;
+/**
+ * Check that the `git` binary is available on PATH.
+ */
+export declare function ensureGitAvailable(): Promise<void>;
+/**
+ * Validate a git branch name.
+ * Follows rules from `git check-ref-format --branch`:
+ * - No double dots (..)
+ * - No ASCII control chars or space, ~, ^, :, ?, *, [, \
+ * - Cannot begin or end with a dot, or end with .lock
+ * - Cannot contain @{
+ * - Cannot be a single @
+ * - Each component cannot begin with a dot
+ */
+export declare function isValidBranchName(name: string): {
+    valid: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=git-cli.d.ts.map

package/dist/git/git-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-cli.d.ts","sourceRoot":"","sources":["../../src/git/git-cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMjD,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,MAAM,CAAC;gBAED,OAAO,EAAE,MAAM,EAAE,IAAI,SAAc;CAKhD;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;gBACtC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAOhD;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,YAAY,EAAE,MAAM;CAOjC;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,YAAY,EAAE,MAAM;CAOjC;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;gBAEX,eAAe,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,UAA6B;CAUjF;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;;CAKlD;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;gBAEH,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CASlF;AAID;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CASxD;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAgDnF"}

package/dist/git/git-cli.js

@@ -0,0 +1,156 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { ConflictOp } from '@agent-tower/shared';
+const execFileAsync = promisify(execFile);
+// ─── Custom Error Types ───────────────────────────────────────────────────────
+export class GitError extends Error {
+    code;
+    constructor(message, code = 'GIT_ERROR') {
+        super(message);
+        this.name = 'GitError';
+        this.code = code;
+    }
+}
+export class BranchNotFoundError extends GitError {
+    constructor(branchName) {
+        super(`Branch '${branchName}' does not exist`, 'BRANCH_NOT_FOUND');
+        this.name = 'BranchNotFoundError';
+    }
+}
+export class BranchExistsError extends GitError {
+    constructor(branchName) {
+        super(`Branch '${branchName}' already exists`, 'BRANCH_EXISTS');
+        this.name = 'BranchExistsError';
+    }
+}
+export class InvalidBranchNameError extends GitError {
+    constructor(branchName, reason) {
+        const msg = reason
+            ? `Invalid branch name '${branchName}': ${reason}`
+            : `Invalid branch name '${branchName}'`;
+        super(msg, 'INVALID_BRANCH_NAME');
+        this.name = 'InvalidBranchNameError';
+    }
+}
+export class WorktreeNotFoundError extends GitError {
+    constructor(worktreePath) {
+        super(`Worktree not found at '${worktreePath}'`, 'WORKTREE_NOT_FOUND');
+        this.name = 'WorktreeNotFoundError';
+    }
+}
+export class WorktreeDirtyError extends GitError {
+    constructor(worktreePath) {
+        super(`Worktree at '${worktreePath}' has uncommitted changes`, 'WORKTREE_DIRTY');
+        this.name = 'WorktreeDirtyError';
+    }
+}
+export class MergeConflictError extends GitError {
+    conflictedFiles;
+    conflictOp;
+    constructor(conflictedFiles, conflictOp = ConflictOp.MERGE) {
+        const fileList = conflictedFiles.join(', ');
+        super(`Merge conflict in files: ${fileList}`, 'MERGE_CONFLICT');
+        this.name = 'MergeConflictError';
+        this.conflictedFiles = conflictedFiles;
+        this.conflictOp = conflictOp;
+    }
+}
+export class RebaseInProgressError extends GitError {
+    constructor() {
+        super('Rebase in progress; resolve or abort it before retrying', 'REBASE_IN_PROGRESS');
+        this.name = 'RebaseInProgressError';
+    }
+}
+export class BranchesDivergedError extends GitError {
+    ahead;
+    behind;
+    constructor(taskBranch, baseBranch, ahead, behind) {
+        super(`Branch '${taskBranch}' has diverged from '${baseBranch}' (ahead: ${ahead}, behind: ${behind}). Rebase or update before merging.`, 'BRANCHES_DIVERGED');
+        this.name = 'BranchesDivergedError';
+        this.ahead = ahead;
+        this.behind = behind;
+    }
+}
+// ─── Git CLI Wrapper ──────────────────────────────────────────────────────────
+/**
+ * Execute a git command in the given repository path.
+ * All git operations go through this single entry point for uniform error handling.
+ */
+export async function execGit(repoPath, args, options) {
+    try {
+        const { stdout } = await execFileAsync('git', args, {
+            cwd: repoPath,
+            maxBuffer: 10 * 1024 * 1024, // 10 MB
+            timeout: options?.timeout ?? 30_000,
+        });
+        return stdout;
+    }
+    catch (err) {
+        const error = err;
+        const stderr = error.stderr ?? error.message ?? 'Unknown git error';
+        throw new GitError(`git ${args.join(' ')} failed: ${stderr.trim()}`, typeof error.code === 'string' ? error.code : 'GIT_EXEC_ERROR');
+    }
+}
+/**
+ * Check that the `git` binary is available on PATH.
+ */
+export async function ensureGitAvailable() {
+    try {
+        await execFileAsync('git', ['--version']);
+    }
+    catch {
+        throw new GitError('git is not installed or not found on PATH', 'GIT_NOT_AVAILABLE');
+    }
+}
+// ─── Branch Name Validation ───────────────────────────────────────────────────
+/**
+ * Validate a git branch name.
+ * Follows rules from `git check-ref-format --branch`:
+ * - No double dots (..)
+ * - No ASCII control chars or space, ~, ^, :, ?, *, [, \
+ * - Cannot begin or end with a dot, or end with .lock
+ * - Cannot contain @{
+ * - Cannot be a single @
+ * - Each component cannot begin with a dot
+ */
+export function isValidBranchName(name) {
+    if (!name || name.trim().length === 0) {
+        return { valid: false, reason: 'branch name cannot be empty' };
+    }
+    if (name === '@') {
+        return { valid: false, reason: 'branch name cannot be a single @' };
+    }
+    if (name.includes('..')) {
+        return { valid: false, reason: 'branch name cannot contain ".."' };
+    }
+    if (name.includes('@{')) {
+        return { valid: false, reason: 'branch name cannot contain "@{"' };
+    }
+    if (name.endsWith('.lock')) {
+        return { valid: false, reason: 'branch name cannot end with ".lock"' };
+    }
+    if (name.startsWith('.') || name.endsWith('.')) {
+        return { valid: false, reason: 'branch name cannot start or end with "."' };
+    }
+    if (name.startsWith('-')) {
+        return { valid: false, reason: 'branch name cannot start with "-"' };
+    }
+    // No ASCII control chars, space, ~, ^, :, ?, *, [, backslash
+    // eslint-disable-next-line no-control-regex
+    const invalidChars = /[\x00-\x1f\x7f ~^:?*[\]\\]/;
+    if (invalidChars.test(name)) {
+        return { valid: false, reason: 'branch name contains invalid characters' };
+    }
+    // Each slash-separated component cannot begin with a dot
+    const components = name.split('/');
+    for (const comp of components) {
+        if (comp.startsWith('.')) {
+            return { valid: false, reason: `path component "${comp}" cannot start with "."` };
+        }
+        if (comp.length === 0) {
+            return { valid: false, reason: 'branch name cannot contain empty path components (consecutive slashes)' };
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=git-cli.js.map

package/dist/git/git-cli.js.map

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

package/dist/git/worktree.manager.d.ts

@@ -0,0 +1,166 @@
+import type { GitOperationStatus } from '@agent-tower/shared';
+export { GitError, BranchExistsError, BranchNotFoundError, InvalidBranchNameError, WorktreeDirtyError, MergeConflictError, BranchesDivergedError, RebaseInProgressError, } from './git-cli.js';
+export interface WorktreeInfo {
+    /** Absolute path to the worktree directory */
+    path: string;
+    /** HEAD commit hash */
+    head: string;
+    /** Branch name (empty for detached HEAD) */
+    branch: string;
+    /** Whether this is the bare/main worktree */
+    bare: boolean;
+}
+export interface BranchStatus {
+    ahead: number;
+    behind: number;
+}
+export interface WorktreeStatus {
+    /** Number of staged + unstaged modified files */
+    changedFiles: number;
+    /** Number of untracked files */
+    untrackedFiles: number;
+}
+export interface DiffResult {
+    /** Full diff output */
+    diff: string;
+    /** Summary stat output */
+    stat: string;
+}
+export declare class WorktreeManager {
+    private repoPath;
+    private worktreeBaseDir;
+    constructor(repoPath: string);
+    /**
+     * List all worktrees with parsed metadata.
+     * Parses `git worktree list --porcelain` output.
+     */
+    listWorktrees(): Promise<WorktreeInfo[]>;
+    /**
+     * Get branch divergence status (ahead/behind) relative to a base branch.
+     */
+    getBranchStatus(branchName: string, baseBranch: string): Promise<BranchStatus>;
+    /**
+     * Get the working tree status of a worktree (changed + untracked file counts).
+     */
+    getWorktreeStatus(worktreePath: string): Promise<WorktreeStatus>;
+    /**
+     * Check whether a worktree has no uncommitted changes.
+     */
+    isWorktreeClean(worktreePath: string): Promise<boolean>;
+    /**
+     * Check whether a branch exists (local).
+     */
+    checkBranchExists(branchName: string): Promise<boolean>;
+    /**
+     * Create a new worktree with a new branch.
+     *
+     * - Validates branch name
+     * - Checks branch does not already exist
+     * - Creates the worktree base directory if needed
+     */
+    create(branchName: string): Promise<string>;
+    /**
+     * Remove a worktree. If the worktree does not exist, this is a no-op.
+     */
+    remove(worktreePath: string): Promise<void>;
+    /**
+     * Ensure a worktree exists for an existing branch. If the worktree directory
+     * is already valid, return its path. Otherwise, recreate it.
+     *
+     * Used when reactivating a MERGED workspace — the branch was preserved via
+     * update-ref but the worktree directory was removed.
+     *
+     * 参考: vibe-kanban crates/services/src/services/worktree_manager.rs:93-123
+     */
+    ensureWorktreeExists(branchName: string): Promise<string>;
+    /**
+     * Get the diff of a worktree branch against a base branch.
+     * Returns both the full diff and a stat summary.
+     */
+    getDiff(worktreePath: string, baseBranch: string): Promise<string>;
+    getDiff(worktreePath: string, baseBranch: string, options: {
+        withStat: true;
+    }): Promise<DiffResult>;
+    /**
+     * Squash-merge a worktree branch into the target branch.
+     *
+     * Performs the following steps:
+     * 1. Verify the worktree is clean
+     * 2. Check branch divergence — fail if base branch has advanced
+     * 3. Checkout target branch in the main repo
+     * 4. Execute `git merge --squash --no-commit <task_branch>`
+     * 5. Commit the squash merge
+     * 6. Remove the worktree and delete the task branch
+     */
+    merge(worktreePath: string, targetBranch: string, options?: {
+        commitMessage?: string;
+    }): Promise<{
+        sha: string;
+        taskBranch: string;
+    }>;
+    /**
+     * Prune stale worktree references.
+     */
+    prune(): Promise<void>;
+    /**
+     * Rebase the current branch in the worktree onto the latest base branch.
+     * Uses `git rebase --onto <baseBranch> <mergeBase> <taskBranch>`.
+     *
+     * - If a rebase is already in progress, throws RebaseInProgressError
+     * - On conflict, throws MergeConflictError with ConflictOp.REBASE (preserves rebase state)
+     * - On non-conflict failure, auto-aborts to keep repo clean
+     */
+    rebase(worktreePath: string, baseBranch: string): Promise<void>;
+    /**
+     * Get the current Git operation status of a worktree.
+     */
+    getGitOperationStatus(worktreePath: string, baseBranch: string): Promise<GitOperationStatus>;
+    /**
+     * Abort the current in-progress Git operation (rebase or merge).
+     * If no operation is in progress, this is a no-op.
+     */
+    abortOperation(worktreePath: string): Promise<void>;
+    /**
+     * Alias for `listWorktrees()`, returns just the paths.
+     * Kept for backward compatibility with existing callers.
+     */
+    list(): Promise<string[]>;
+    /**
+     * Assert that a branch exists; throw BranchNotFoundError if not.
+     */
+    private ensureBranchExists;
+    /**
+     * Parse the porcelain output of `git worktree list --porcelain`.
+     *
+     * Format:
+     * ```
+     * worktree /path/to/main
+     * HEAD abc123
+     * branch refs/heads/main
+     *
+     * worktree /path/to/wt
+     * HEAD def456
+     * branch refs/heads/feature
+     * ```
+     */
+    private parseWorktreeListOutput;
+    /**
+     * Get the list of conflicted files from a failed merge.
+     */
+    private getConflictedFiles;
+    /**
+     * Get the list of conflicted files in a specific worktree path.
+     */
+    private getConflictedFilesIn;
+    /**
+     * Check if a rebase is in progress in the given worktree.
+     * Detects by checking for rebase-merge or rebase-apply directories.
+     */
+    private isRebaseInProgress;
+    /**
+     * Check if a merge is in progress in the given worktree.
+     * Detects by verifying MERGE_HEAD exists.
+     */
+    private isMergeInProgress;
+}
+//# sourceMappingURL=worktree.manager.d.ts.map

package/dist/git/worktree.manager.d.ts.map

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