@agent-phonon/protocol 0.2.0

package/dist/schemas/project.d.ts

@@ -0,0 +1,506 @@
+import { z } from "zod";
+/**
+ * 项目管理协议（design D23）。
+ *
+ * 一个项目 = 一个目录 + Git。所有 session 必须绑定一个项目（projectId）。
+ * 项目是磁盘上的客观目录，**设备级共享、不受 tenant 隔离**——不同 tenant 都能看到/用
+ * 同一项目，在其下各干各的；冲突风险用户自担。（隔离发生在会话/任务层，不在文件层。）
+ */
+/** 项目描述。 */
+export declare const ProjectDescriptor: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    /** 展示名。 */
+    name: z.ZodString;
+    /** 项目目录的绝对路径（设备本地）。 */
+    path: z.ZodString;
+    /** 是否已 git init。 */
+    git: z.ZodDefault<z.ZodBoolean>;
+    /** 当前分支（若有）。 */
+    branch: z.ZodOptional<z.ZodString>;
+    /** 可选：远端 URL。 */
+    remote: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    createdAt: string;
+    name: string;
+    projectId: string & z.BRAND<"ProjectId">;
+    git: boolean;
+    branch?: string | undefined;
+    remote?: string | undefined;
+}, {
+    path: string;
+    createdAt: string;
+    name: string;
+    projectId: string;
+    git?: boolean | undefined;
+    branch?: string | undefined;
+    remote?: string | undefined;
+}>;
+export type ProjectDescriptor = z.infer<typeof ProjectDescriptor>;
+export declare const ProjectCreateParams: z.ZodObject<{
+    /** 可选：幂等键（P0-3）。 */
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    /**
+     * 可选：指定目录路径。缺省由 phonon 在受控工作区下按 name 生成
+     * （避免服务端越权指定任意本地路径）。
+     */
+    path: z.ZodOptional<z.ZodString>;
+    /** 是否 git init（默认 true，项目 = 目录 + Git）。 */
+    git: z.ZodDefault<z.ZodBoolean>;
+    /** 可选：初始化时设置的远端。 */
+    remote: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    git: boolean;
+    path?: string | undefined;
+    clientRequestId?: string | undefined;
+    remote?: string | undefined;
+}, {
+    name: string;
+    path?: string | undefined;
+    clientRequestId?: string | undefined;
+    git?: boolean | undefined;
+    remote?: string | undefined;
+}>;
+export type ProjectCreateParams = z.infer<typeof ProjectCreateParams>;
+export declare const ProjectCreateResult: z.ZodObject<{
+    project: z.ZodObject<{
+        projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** 展示名。 */
+        name: z.ZodString;
+        /** 项目目录的绝对路径（设备本地）。 */
+        path: z.ZodString;
+        /** 是否已 git init。 */
+        git: z.ZodDefault<z.ZodBoolean>;
+        /** 当前分支（若有）。 */
+        branch: z.ZodOptional<z.ZodString>;
+        /** 可选：远端 URL。 */
+        remote: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        git: boolean;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }, {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    project: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        git: boolean;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    };
+}, {
+    project: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    };
+}>;
+export type ProjectCreateResult = z.infer<typeof ProjectCreateResult>;
+export declare const ProjectListParams: z.ZodDefault<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+export type ProjectListParams = z.infer<typeof ProjectListParams>;
+export declare const ProjectListResult: z.ZodObject<{
+    projects: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** 展示名。 */
+        name: z.ZodString;
+        /** 项目目录的绝对路径（设备本地）。 */
+        path: z.ZodString;
+        /** 是否已 git init。 */
+        git: z.ZodDefault<z.ZodBoolean>;
+        /** 当前分支（若有）。 */
+        branch: z.ZodOptional<z.ZodString>;
+        /** 可选：远端 URL。 */
+        remote: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        git: boolean;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }, {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    projects: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        git: boolean;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }[];
+}, {
+    projects: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }[];
+}>;
+export type ProjectListResult = z.infer<typeof ProjectListResult>;
+export declare const ProjectGetParams: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strip", z.ZodTypeAny, {
+    projectId: string & z.BRAND<"ProjectId">;
+}, {
+    projectId: string;
+}>;
+export type ProjectGetParams = z.infer<typeof ProjectGetParams>;
+export declare const ProjectGetResult: z.ZodObject<{
+    project: z.ZodObject<{
+        projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** 展示名。 */
+        name: z.ZodString;
+        /** 项目目录的绝对路径（设备本地）。 */
+        path: z.ZodString;
+        /** 是否已 git init。 */
+        git: z.ZodDefault<z.ZodBoolean>;
+        /** 当前分支（若有）。 */
+        branch: z.ZodOptional<z.ZodString>;
+        /** 可选：远端 URL。 */
+        remote: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        git: boolean;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }, {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    project: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        git: boolean;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    };
+}, {
+    project: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    };
+}>;
+export type ProjectGetResult = z.infer<typeof ProjectGetResult>;
+export declare const ProjectRemoveParams: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    /**
+     * 是否删除物理目录。默认 false（仅从 phonon 解绑/注销，保留磁盘文件，防误删）。
+     * true 才真正删目录——危险操作，需 policy allowDeleteFiles。
+     */
+    deleteFiles: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * 有 active session 绑定本项目时的处理（P1-7 / Minimax#5）：
+     * - reject（默认）：还有 active session → errProjectHasActiveSessions
+     * - cascade      ：级联 terminate 所有 active session 再移除
+     */
+    whenActiveSessions: z.ZodDefault<z.ZodEnum<["reject", "cascade"]>>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string & z.BRAND<"ProjectId">;
+    deleteFiles: boolean;
+    whenActiveSessions: "reject" | "cascade";
+}, {
+    projectId: string;
+    deleteFiles?: boolean | undefined;
+    whenActiveSessions?: "reject" | "cascade" | undefined;
+}>;
+export type ProjectRemoveParams = z.infer<typeof ProjectRemoveParams>;
+export declare const ProjectRemoveResult: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    removed: z.ZodLiteral<true>;
+    filesDeleted: z.ZodBoolean;
+    /** cascade 时被级联 terminate 的 session。 */
+    terminatedSessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string & z.BRAND<"ProjectId">;
+    removed: true;
+    filesDeleted: boolean;
+    terminatedSessions?: string[] | undefined;
+}, {
+    projectId: string;
+    removed: true;
+    filesDeleted: boolean;
+    terminatedSessions?: string[] | undefined;
+}>;
+export type ProjectRemoveResult = z.infer<typeof ProjectRemoveResult>;
+/** worktree 描述。 */
+export declare const WorktreeDescriptor: z.ZodObject<{
+    /** worktree 标识（phonon 生成）。 */
+    worktreeId: z.ZodString;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    /** worktree 的工作目录路径。 */
+    path: z.ZodString;
+    /** 该 worktree 检出的分支。 */
+    branch: z.ZodString;
+    /** 是否是主工作区（项目本体目录）。 */
+    isPrimary: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    worktreeId: string;
+    projectId: string & z.BRAND<"ProjectId">;
+    branch: string;
+    isPrimary: boolean;
+    createdAt?: string | undefined;
+}, {
+    path: string;
+    worktreeId: string;
+    projectId: string;
+    branch: string;
+    createdAt?: string | undefined;
+    isPrimary?: boolean | undefined;
+}>;
+export type WorktreeDescriptor = z.infer<typeof WorktreeDescriptor>;
+export declare const WorktreeCreateParams: z.ZodObject<{
+    /** 可选：幂等键（P0-3）。 */
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    /** 基于哪个已有 branch 创建（检出点）。 */
+    baseBranch: z.ZodString;
+    /**
+     * 可选：新建并检出的分支名。缺省则直接检出 baseBranch
+     * （注：同一 branch 不能被两个 worktree 同时检出，所以多开并发时通常传 newBranch）。
+     */
+    newBranch: z.ZodOptional<z.ZodString>;
+    /** 可选：指定 worktree 路径；缺省由 phonon 在受控区生成。 */
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string & z.BRAND<"ProjectId">;
+    baseBranch: string;
+    path?: string | undefined;
+    clientRequestId?: string | undefined;
+    newBranch?: string | undefined;
+}, {
+    projectId: string;
+    baseBranch: string;
+    path?: string | undefined;
+    clientRequestId?: string | undefined;
+    newBranch?: string | undefined;
+}>;
+export type WorktreeCreateParams = z.infer<typeof WorktreeCreateParams>;
+export declare const WorktreeCreateResult: z.ZodObject<{
+    worktree: z.ZodObject<{
+        /** worktree 标识（phonon 生成）。 */
+        worktreeId: z.ZodString;
+        projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** worktree 的工作目录路径。 */
+        path: z.ZodString;
+        /** 该 worktree 检出的分支。 */
+        branch: z.ZodString;
+        /** 是否是主工作区（项目本体目录）。 */
+        isPrimary: z.ZodDefault<z.ZodBoolean>;
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        worktreeId: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        branch: string;
+        isPrimary: boolean;
+        createdAt?: string | undefined;
+    }, {
+        path: string;
+        worktreeId: string;
+        projectId: string;
+        branch: string;
+        createdAt?: string | undefined;
+        isPrimary?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    worktree: {
+        path: string;
+        worktreeId: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        branch: string;
+        isPrimary: boolean;
+        createdAt?: string | undefined;
+    };
+}, {
+    worktree: {
+        path: string;
+        worktreeId: string;
+        projectId: string;
+        branch: string;
+        createdAt?: string | undefined;
+        isPrimary?: boolean | undefined;
+    };
+}>;
+export type WorktreeCreateResult = z.infer<typeof WorktreeCreateResult>;
+export declare const WorktreeListParams: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strip", z.ZodTypeAny, {
+    projectId: string & z.BRAND<"ProjectId">;
+}, {
+    projectId: string;
+}>;
+export type WorktreeListParams = z.infer<typeof WorktreeListParams>;
+export declare const WorktreeListResult: z.ZodObject<{
+    worktrees: z.ZodArray<z.ZodObject<{
+        /** worktree 标识（phonon 生成）。 */
+        worktreeId: z.ZodString;
+        projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** worktree 的工作目录路径。 */
+        path: z.ZodString;
+        /** 该 worktree 检出的分支。 */
+        branch: z.ZodString;
+        /** 是否是主工作区（项目本体目录）。 */
+        isPrimary: z.ZodDefault<z.ZodBoolean>;
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        worktreeId: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        branch: string;
+        isPrimary: boolean;
+        createdAt?: string | undefined;
+    }, {
+        path: string;
+        worktreeId: string;
+        projectId: string;
+        branch: string;
+        createdAt?: string | undefined;
+        isPrimary?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    worktrees: {
+        path: string;
+        worktreeId: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        branch: string;
+        isPrimary: boolean;
+        createdAt?: string | undefined;
+    }[];
+}, {
+    worktrees: {
+        path: string;
+        worktreeId: string;
+        projectId: string;
+        branch: string;
+        createdAt?: string | undefined;
+        isPrimary?: boolean | undefined;
+    }[];
+}>;
+export type WorktreeListResult = z.infer<typeof WorktreeListResult>;
+export declare const WorktreeRemoveParams: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    worktreeId: z.ZodString;
+    /**
+     * 是否强制清理（P1-7）。默认 false：
+     * 有未提交变更 → errWorktreeHasChanges；还有 active/running session 绑定 → errWorktreeInUse。
+     * force=true 才允许硬删，但会连带影响返回 affectedSessions。
+     */
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    worktreeId: string;
+    force: boolean;
+    projectId: string & z.BRAND<"ProjectId">;
+}, {
+    worktreeId: string;
+    projectId: string;
+    force?: boolean | undefined;
+}>;
+export type WorktreeRemoveParams = z.infer<typeof WorktreeRemoveParams>;
+export declare const WorktreeRemoveResult: z.ZodObject<{
+    worktreeId: z.ZodString;
+    removed: z.ZodLiteral<true>;
+    /** 被连带影响（被迫 terminate）的 session（force 硬删时）。 */
+    affectedSessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    worktreeId: string;
+    removed: true;
+    affectedSessions?: string[] | undefined;
+}, {
+    worktreeId: string;
+    removed: true;
+    affectedSessions?: string[] | undefined;
+}>;
+export type WorktreeRemoveResult = z.infer<typeof WorktreeRemoveResult>;
+export declare const GitDeleteBranchParams: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    branch: z.ZodString;
+    /**
+     * 是否强制删除（P1-7）。默认 false：
+     * 未合并 → errBranchNotMerged；仍被某 worktree 检出 → errBranchInUse。
+     * force=true 强删未合并（git branch -D），返回 affectedWorktrees。
+     */
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    force: boolean;
+    projectId: string & z.BRAND<"ProjectId">;
+    branch: string;
+}, {
+    projectId: string;
+    branch: string;
+    force?: boolean | undefined;
+}>;
+export type GitDeleteBranchParams = z.infer<typeof GitDeleteBranchParams>;
+export declare const GitDeleteBranchResult: z.ZodObject<{
+    branch: z.ZodString;
+    deleted: z.ZodLiteral<true>;
+    wasMerged: z.ZodOptional<z.ZodBoolean>;
+    /** 被连带影响的 worktree（force 硬删时）。 */
+    affectedWorktrees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    branch: string;
+    deleted: true;
+    wasMerged?: boolean | undefined;
+    affectedWorktrees?: string[] | undefined;
+}, {
+    branch: string;
+    deleted: true;
+    wasMerged?: boolean | undefined;
+    affectedWorktrees?: string[] | undefined;
+}>;
+export type GitDeleteBranchResult = z.infer<typeof GitDeleteBranchResult>;
+//# sourceMappingURL=project.d.ts.map

package/dist/schemas/project.d.ts.map

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

package/dist/schemas/project.js

@@ -0,0 +1,148 @@
+import { z } from "zod";
+import { ProjectId, Timestamp } from "./common.js";
+/**
+ * 项目管理协议（design D23）。
+ *
+ * 一个项目 = 一个目录 + Git。所有 session 必须绑定一个项目（projectId）。
+ * 项目是磁盘上的客观目录，**设备级共享、不受 tenant 隔离**——不同 tenant 都能看到/用
+ * 同一项目，在其下各干各的；冲突风险用户自担。（隔离发生在会话/任务层，不在文件层。）
+ */
+/** 项目描述。 */
+export const ProjectDescriptor = z.object({
+    projectId: ProjectId,
+    /** 展示名。 */
+    name: z.string().min(1),
+    /** 项目目录的绝对路径（设备本地）。 */
+    path: z.string().min(1),
+    /** 是否已 git init。 */
+    git: z.boolean().default(true),
+    /** 当前分支（若有）。 */
+    branch: z.string().optional(),
+    /** 可选：远端 URL。 */
+    remote: z.string().optional(),
+    createdAt: Timestamp,
+});
+// --- project.create ---
+export const ProjectCreateParams = z.object({
+    /** 可选：幂等键（P0-3）。 */
+    clientRequestId: z.string().optional(),
+    name: z.string().min(1),
+    /**
+     * 可选：指定目录路径。缺省由 phonon 在受控工作区下按 name 生成
+     * （避免服务端越权指定任意本地路径）。
+     */
+    path: z.string().optional(),
+    /** 是否 git init（默认 true，项目 = 目录 + Git）。 */
+    git: z.boolean().default(true),
+    /** 可选：初始化时设置的远端。 */
+    remote: z.string().optional(),
+});
+export const ProjectCreateResult = z.object({
+    project: ProjectDescriptor,
+});
+// --- project.list ---
+export const ProjectListParams = z.object({}).default({});
+export const ProjectListResult = z.object({
+    projects: z.array(ProjectDescriptor),
+});
+// --- project.get ---
+export const ProjectGetParams = z.object({ projectId: ProjectId });
+export const ProjectGetResult = z.object({ project: ProjectDescriptor });
+// --- project.remove ---
+export const ProjectRemoveParams = z.object({
+    projectId: ProjectId,
+    /**
+     * 是否删除物理目录。默认 false（仅从 phonon 解绑/注销，保留磁盘文件，防误删）。
+     * true 才真正删目录——危险操作，需 policy allowDeleteFiles。
+     */
+    deleteFiles: z.boolean().default(false),
+    /**
+     * 有 active session 绑定本项目时的处理（P1-7 / Minimax#5）：
+     * - reject（默认）：还有 active session → errProjectHasActiveSessions
+     * - cascade      ：级联 terminate 所有 active session 再移除
+     */
+    whenActiveSessions: z.enum(["reject", "cascade"]).default("reject"),
+});
+export const ProjectRemoveResult = z.object({
+    projectId: ProjectId,
+    removed: z.literal(true),
+    filesDeleted: z.boolean(),
+    /** cascade 时被级联 terminate 的 session。 */
+    terminatedSessions: z.array(z.string()).optional(),
+});
+// ===========================================================================
+// Git / worktree 子能力（D25）
+// worktree = 同一仓库的多个工作目录，天然适配「多 tenant/session 在同一项目各干各的」。
+// ===========================================================================
+/** worktree 描述。 */
+export const WorktreeDescriptor = z.object({
+    /** worktree 标识（phonon 生成）。 */
+    worktreeId: z.string().min(1),
+    projectId: ProjectId,
+    /** worktree 的工作目录路径。 */
+    path: z.string().min(1),
+    /** 该 worktree 检出的分支。 */
+    branch: z.string().min(1),
+    /** 是否是主工作区（项目本体目录）。 */
+    isPrimary: z.boolean().default(false),
+    createdAt: Timestamp.optional(),
+});
+// --- project.worktree.create：基于某 branch 创建 worktree ---
+export const WorktreeCreateParams = z.object({
+    /** 可选：幂等键（P0-3）。 */
+    clientRequestId: z.string().optional(),
+    projectId: ProjectId,
+    /** 基于哪个已有 branch 创建（检出点）。 */
+    baseBranch: z.string().min(1),
+    /**
+     * 可选：新建并检出的分支名。缺省则直接检出 baseBranch
+     * （注：同一 branch 不能被两个 worktree 同时检出，所以多开并发时通常传 newBranch）。
+     */
+    newBranch: z.string().optional(),
+    /** 可选：指定 worktree 路径；缺省由 phonon 在受控区生成。 */
+    path: z.string().optional(),
+});
+export const WorktreeCreateResult = z.object({
+    worktree: WorktreeDescriptor,
+});
+// --- project.worktree.list ---
+export const WorktreeListParams = z.object({ projectId: ProjectId });
+export const WorktreeListResult = z.object({
+    worktrees: z.array(WorktreeDescriptor),
+});
+// --- project.worktree.remove：清理 worktree ---
+export const WorktreeRemoveParams = z.object({
+    projectId: ProjectId,
+    worktreeId: z.string().min(1),
+    /**
+     * 是否强制清理（P1-7）。默认 false：
+     * 有未提交变更 → errWorktreeHasChanges；还有 active/running session 绑定 → errWorktreeInUse。
+     * force=true 才允许硬删，但会连带影响返回 affectedSessions。
+     */
+    force: z.boolean().default(false),
+});
+export const WorktreeRemoveResult = z.object({
+    worktreeId: z.string(),
+    removed: z.literal(true),
+    /** 被连带影响（被迫 terminate）的 session（force 硬删时）。 */
+    affectedSessions: z.array(z.string()).optional(),
+});
+// --- project.git.deleteBranch：删除（已合并的）branch ---
+export const GitDeleteBranchParams = z.object({
+    projectId: ProjectId,
+    branch: z.string().min(1),
+    /**
+     * 是否强制删除（P1-7）。默认 false：
+     * 未合并 → errBranchNotMerged；仍被某 worktree 检出 → errBranchInUse。
+     * force=true 强删未合并（git branch -D），返回 affectedWorktrees。
+     */
+    force: z.boolean().default(false),
+});
+export const GitDeleteBranchResult = z.object({
+    branch: z.string(),
+    deleted: z.literal(true),
+    wasMerged: z.boolean().optional(),
+    /** 被连带影响的 worktree（force 硬删时）。 */
+    affectedWorktrees: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=project.js.map

package/dist/schemas/project.js.map

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