@agent-phonon/protocol 0.9.0 → 0.10.0

package/dist/schemas/project.d.ts

@@ -3,16 +3,21 @@ import { z } from "zod";
  * 项目管理协议（design D23）。
  *
  * 一个项目 = 一个目录 + Git。所有 session 必须绑定一个项目（projectId）。
- * 项目是磁盘上的客观目录，**设备级共享、不受 tenant 隔离**——不同 tenant 都能看到/用
- * 同一项目，在其下各干各的；冲突风险用户自担。（隔离发生在会话/任务层，不在文件层。）
+ * 项目对应本机目录，但注册的 projectId 归属连接 namespace；其他 tenant 的标识及
+ * 未映射的旧记录不能自动借用。本机用户显式共享目录不等于 API 授予跨 namespace 权限。
  */
 /** 项目描述。 */
 export declare const ProjectDescriptor: z.ZodObject<{
     projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    /** Creator connection namespace. Missing means an unmapped legacy record, not implicit ownership. */
+    namespace: z.ZodOptional<z.ZodString>;
+    /** Internal employee home, not a Registry project binding. */
+    employeeId: z.ZodOptional<z.ZodString>;
     /** 展示名。 */
     name: z.ZodString;
     /** 项目目录的绝对路径（设备本地）。 */
     path: z.ZodString;
+    directoryIdentity: z.ZodOptional<z.ZodString>;
     /** 是否已 git init。 */
     git: z.ZodDefault<z.ZodBoolean>;
     /** 当前分支（若有）。 */
@@ -26,6 +31,9 @@ export declare const ProjectDescriptor: z.ZodObject<{
     name: string;
     projectId: string & z.BRAND<"ProjectId">;
     git: boolean;
+    employeeId?: string | undefined;
+    namespace?: string | undefined;
+    directoryIdentity?: string | undefined;
     branch?: string | undefined;
     remote?: string | undefined;
 }, {
@@ -33,12 +41,15 @@ export declare const ProjectDescriptor: z.ZodObject<{
     createdAt: string;
     name: string;
     projectId: string;
+    employeeId?: string | undefined;
+    namespace?: string | undefined;
+    directoryIdentity?: string | undefined;
     git?: boolean | undefined;
     branch?: string | undefined;
     remote?: string | undefined;
 }>;
 export type ProjectDescriptor = z.infer<typeof ProjectDescriptor>;
-export declare const ProjectCreateParams: z.ZodObject<{
+export declare const ProjectCreateParams: z.ZodEffects<z.ZodObject<{
     /** 可选：幂等键（P0-3）。 */
     clientRequestId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -51,27 +62,49 @@ export declare const ProjectCreateParams: z.ZodObject<{
     git: z.ZodDefault<z.ZodBoolean>;
     /** 可选：初始化时设置的远端。 */
     remote: z.ZodOptional<z.ZodString>;
+    existingDirectoryIdentity: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     git: boolean;
     path?: string | undefined;
     clientRequestId?: string | undefined;
     remote?: string | undefined;
+    existingDirectoryIdentity?: string | undefined;
 }, {
     name: string;
     path?: string | undefined;
     clientRequestId?: string | undefined;
     git?: boolean | undefined;
     remote?: string | undefined;
+    existingDirectoryIdentity?: string | undefined;
+}>, {
+    name: string;
+    git: boolean;
+    path?: string | undefined;
+    clientRequestId?: string | undefined;
+    remote?: string | undefined;
+    existingDirectoryIdentity?: string | undefined;
+}, {
+    name: string;
+    path?: string | undefined;
+    clientRequestId?: string | undefined;
+    git?: boolean | undefined;
+    remote?: string | undefined;
+    existingDirectoryIdentity?: string | undefined;
 }>;
 export type ProjectCreateParams = z.infer<typeof ProjectCreateParams>;
 export declare const ProjectCreateResult: z.ZodObject<{
     project: z.ZodObject<{
         projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** Creator connection namespace. Missing means an unmapped legacy record, not implicit ownership. */
+        namespace: z.ZodOptional<z.ZodString>;
+        /** Internal employee home, not a Registry project binding. */
+        employeeId: z.ZodOptional<z.ZodString>;
         /** 展示名。 */
         name: z.ZodString;
         /** 项目目录的绝对路径（设备本地）。 */
         path: z.ZodString;
+        directoryIdentity: z.ZodOptional<z.ZodString>;
         /** 是否已 git init。 */
         git: z.ZodDefault<z.ZodBoolean>;
         /** 当前分支（若有）。 */
@@ -85,6 +118,9 @@ export declare const ProjectCreateResult: z.ZodObject<{
         name: string;
         projectId: string & z.BRAND<"ProjectId">;
         git: boolean;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
     }, {
@@ -92,6 +128,9 @@ export declare const ProjectCreateResult: z.ZodObject<{
         createdAt: string;
         name: string;
         projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         git?: boolean | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
@@ -103,6 +142,9 @@ export declare const ProjectCreateResult: z.ZodObject<{
         name: string;
         projectId: string & z.BRAND<"ProjectId">;
         git: boolean;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
     };
@@ -112,21 +154,466 @@ export declare const ProjectCreateResult: z.ZodObject<{
         createdAt: string;
         name: string;
         projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         git?: boolean | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
     };
 }>;
 export type ProjectCreateResult = z.infer<typeof ProjectCreateResult>;
+export declare const ProjectProvisionParams: z.ZodObject<{
+    clientRequestId: z.ZodString;
+    name: z.ZodString;
+    expectedReceiverID: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    clientRequestId: string;
+    expectedReceiverID: string;
+}, {
+    name: string;
+    clientRequestId: string;
+    expectedReceiverID: string;
+}>;
+export type ProjectProvisionParams = z.infer<typeof ProjectProvisionParams>;
+export declare const ProjectProvisionStatusParams: z.ZodObject<Pick<{
+    clientRequestId: z.ZodString;
+    name: z.ZodString;
+    expectedReceiverID: z.ZodString;
+}, "clientRequestId" | "expectedReceiverID">, "strict", z.ZodTypeAny, {
+    clientRequestId: string;
+    expectedReceiverID: string;
+}, {
+    clientRequestId: string;
+    expectedReceiverID: string;
+}>;
+export type ProjectProvisionStatusParams = z.infer<typeof ProjectProvisionStatusParams>;
+export declare const ProjectProvisionStatusResult: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    state: z.ZodLiteral<"not_found">;
+    found: z.ZodLiteral<false>;
+    outcomeKnown: z.ZodLiteral<false>;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "not_found";
+    clientRequestId: string;
+    receiverID: string;
+    found: false;
+    outcomeKnown: false;
+}, {
+    state: "not_found";
+    clientRequestId: string;
+    receiverID: string;
+    found: false;
+    outcomeKnown: false;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"prepared">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<false>;
+    dispatchClaimed: z.ZodLiteral<false>;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "prepared";
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: false;
+}, {
+    state: "prepared";
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: false;
+}>, z.ZodObject<{
+    state: z.ZodEnum<["dispatched", "unknown"]>;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<false>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "unknown" | "dispatched";
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: true;
+}, {
+    state: "unknown" | "dispatched";
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: true;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"failed">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<true>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    reasonCode: z.ZodLiteral<"creation_refused">;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "failed";
+    reasonCode: "creation_refused";
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+}, {
+    state: "failed";
+    reasonCode: "creation_refused";
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"confirmed">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<true>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    project: z.ZodObject<{
+        projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** Creator connection namespace. Missing means an unmapped legacy record, not implicit ownership. */
+        namespace: z.ZodOptional<z.ZodString>;
+        /** Internal employee home, not a Registry project binding. */
+        employeeId: z.ZodOptional<z.ZodString>;
+        /** 展示名。 */
+        name: z.ZodString;
+        /** 项目目录的绝对路径（设备本地）。 */
+        path: z.ZodString;
+        directoryIdentity: z.ZodOptional<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;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }, {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }>;
+    rootIdentity: z.ZodString;
+    workspaceIdentity: z.ZodString;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "confirmed";
+    project: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        git: boolean;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    };
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+    rootIdentity: string;
+    workspaceIdentity: string;
+}, {
+    state: "confirmed";
+    project: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    };
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+    rootIdentity: string;
+    workspaceIdentity: string;
+}>]>;
+export type ProjectProvisionStatusResult = z.infer<typeof ProjectProvisionStatusResult>;
+export declare const WorktreeProvisionParams: z.ZodObject<{
+    name: z.ZodString;
+    baseBranch: z.ZodString;
+    newBranch: z.ZodString;
+    clientRequestId: z.ZodString;
+    expectedReceiverID: z.ZodString;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    expectedReceiverID: string;
+    baseBranch: string;
+    newBranch: string;
+}, {
+    name: string;
+    projectId: string;
+    clientRequestId: string;
+    expectedReceiverID: string;
+    baseBranch: string;
+    newBranch: string;
+}>;
+export type WorktreeProvisionParams = z.infer<typeof WorktreeProvisionParams>;
+export declare const WorktreeProvisionStatusParams: z.ZodObject<{
+    clientRequestId: z.ZodString;
+    expectedReceiverID: z.ZodString;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strict", z.ZodTypeAny, {
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    expectedReceiverID: string;
+}, {
+    projectId: string;
+    clientRequestId: string;
+    expectedReceiverID: string;
+}>;
+export type WorktreeProvisionStatusParams = z.infer<typeof WorktreeProvisionStatusParams>;
+export declare const WorktreeProvisionStatusResult: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    state: z.ZodLiteral<"not_found">;
+    found: z.ZodLiteral<false>;
+    outcomeKnown: z.ZodLiteral<false>;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strict", z.ZodTypeAny, {
+    state: "not_found";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    receiverID: string;
+    found: false;
+    outcomeKnown: false;
+}, {
+    state: "not_found";
+    projectId: string;
+    clientRequestId: string;
+    receiverID: string;
+    found: false;
+    outcomeKnown: false;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"prepared">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<false>;
+    dispatchClaimed: z.ZodLiteral<false>;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strict", z.ZodTypeAny, {
+    state: "prepared";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: false;
+}, {
+    state: "prepared";
+    projectId: string;
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: false;
+}>, z.ZodObject<{
+    state: z.ZodEnum<["dispatched", "unknown"]>;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<false>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strict", z.ZodTypeAny, {
+    state: "unknown" | "dispatched";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: true;
+}, {
+    state: "unknown" | "dispatched";
+    projectId: string;
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: true;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"failed">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<true>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    reasonCode: z.ZodLiteral<"creation_refused">;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strict", z.ZodTypeAny, {
+    state: "failed";
+    reasonCode: "creation_refused";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+}, {
+    state: "failed";
+    reasonCode: "creation_refused";
+    projectId: string;
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"confirmed">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<true>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    workspace: z.ZodObject<{
+        projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** Creator connection namespace. Missing means an unmapped legacy record, not implicit ownership. */
+        namespace: z.ZodOptional<z.ZodString>;
+        /** Internal employee home, not a Registry project binding. */
+        employeeId: z.ZodOptional<z.ZodString>;
+        /** 展示名。 */
+        name: z.ZodString;
+        /** 项目目录的绝对路径（设备本地）。 */
+        path: z.ZodString;
+        directoryIdentity: z.ZodOptional<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;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }, {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    }>;
+    directoryIdentity: z.ZodString;
+    baseCommit: z.ZodString;
+    branch: z.ZodString;
+    clientRequestId: z.ZodString;
+    receiverID: z.ZodString;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strict", z.ZodTypeAny, {
+    state: "confirmed";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+    directoryIdentity: string;
+    branch: string;
+    workspace: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        git: boolean;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    };
+    baseCommit: string;
+}, {
+    state: "confirmed";
+    projectId: string;
+    clientRequestId: string;
+    receiverID: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+    directoryIdentity: string;
+    branch: string;
+    workspace: {
+        path: string;
+        createdAt: string;
+        name: string;
+        projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
+        git?: boolean | undefined;
+        branch?: string | undefined;
+        remote?: string | undefined;
+    };
+    baseCommit: string;
+}>]>;
+export type WorktreeProvisionStatusResult = z.infer<typeof WorktreeProvisionStatusResult>;
 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">;
+        /** Creator connection namespace. Missing means an unmapped legacy record, not implicit ownership. */
+        namespace: z.ZodOptional<z.ZodString>;
+        /** Internal employee home, not a Registry project binding. */
+        employeeId: z.ZodOptional<z.ZodString>;
         /** 展示名。 */
         name: z.ZodString;
         /** 项目目录的绝对路径（设备本地）。 */
         path: z.ZodString;
+        directoryIdentity: z.ZodOptional<z.ZodString>;
         /** 是否已 git init。 */
         git: z.ZodDefault<z.ZodBoolean>;
         /** 当前分支（若有）。 */
@@ -140,6 +627,9 @@ export declare const ProjectListResult: z.ZodObject<{
         name: string;
         projectId: string & z.BRAND<"ProjectId">;
         git: boolean;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
     }, {
@@ -147,6 +637,9 @@ export declare const ProjectListResult: z.ZodObject<{
         createdAt: string;
         name: string;
         projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         git?: boolean | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
@@ -158,6 +651,9 @@ export declare const ProjectListResult: z.ZodObject<{
         name: string;
         projectId: string & z.BRAND<"ProjectId">;
         git: boolean;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
     }[];
@@ -167,6 +663,9 @@ export declare const ProjectListResult: z.ZodObject<{
         createdAt: string;
         name: string;
         projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         git?: boolean | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
@@ -184,10 +683,15 @@ export type ProjectGetParams = z.infer<typeof ProjectGetParams>;
 export declare const ProjectGetResult: z.ZodObject<{
     project: z.ZodObject<{
         projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        /** Creator connection namespace. Missing means an unmapped legacy record, not implicit ownership. */
+        namespace: z.ZodOptional<z.ZodString>;
+        /** Internal employee home, not a Registry project binding. */
+        employeeId: z.ZodOptional<z.ZodString>;
         /** 展示名。 */
         name: z.ZodString;
         /** 项目目录的绝对路径（设备本地）。 */
         path: z.ZodString;
+        directoryIdentity: z.ZodOptional<z.ZodString>;
         /** 是否已 git init。 */
         git: z.ZodDefault<z.ZodBoolean>;
         /** 当前分支（若有）。 */
@@ -201,6 +705,9 @@ export declare const ProjectGetResult: z.ZodObject<{
         name: string;
         projectId: string & z.BRAND<"ProjectId">;
         git: boolean;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
     }, {
@@ -208,6 +715,9 @@ export declare const ProjectGetResult: z.ZodObject<{
         createdAt: string;
         name: string;
         projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         git?: boolean | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
@@ -219,6 +729,9 @@ export declare const ProjectGetResult: z.ZodObject<{
         name: string;
         projectId: string & z.BRAND<"ProjectId">;
         git: boolean;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
     };
@@ -228,6 +741,9 @@ export declare const ProjectGetResult: z.ZodObject<{
         createdAt: string;
         name: string;
         projectId: string;
+        employeeId?: string | undefined;
+        namespace?: string | undefined;
+        directoryIdentity?: string | undefined;
         git?: boolean | undefined;
         branch?: string | undefined;
         remote?: string | undefined;
@@ -265,13 +781,13 @@ export declare const ProjectRemoveResult: z.ZodObject<{
     terminatedSessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     projectId: string & z.BRAND<"ProjectId">;
-    removed: true;
     filesDeleted: boolean;
+    removed: true;
     terminatedSessions?: string[] | undefined;
 }, {
     projectId: string;
-    removed: true;
     filesDeleted: boolean;
+    removed: true;
     terminatedSessions?: string[] | undefined;
 }>;
 export type ProjectRemoveResult = z.infer<typeof ProjectRemoveResult>;
@@ -289,15 +805,15 @@ export declare const WorktreeDescriptor: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     path: string;
-    worktreeId: string;
     projectId: string & z.BRAND<"ProjectId">;
+    worktreeId: string;
     branch: string;
     isPrimary: boolean;
     createdAt?: string | undefined;
 }, {
     path: string;
-    worktreeId: string;
     projectId: string;
+    worktreeId: string;
     branch: string;
     createdAt?: string | undefined;
     isPrimary?: boolean | undefined;
@@ -344,15 +860,15 @@ export declare const WorktreeCreateResult: z.ZodObject<{
         createdAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        worktreeId: string;
         projectId: string & z.BRAND<"ProjectId">;
+        worktreeId: string;
         branch: string;
         isPrimary: boolean;
         createdAt?: string | undefined;
     }, {
         path: string;
-        worktreeId: string;
         projectId: string;
+        worktreeId: string;
         branch: string;
         createdAt?: string | undefined;
         isPrimary?: boolean | undefined;
@@ -360,8 +876,8 @@ export declare const WorktreeCreateResult: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     worktree: {
         path: string;
-        worktreeId: string;
         projectId: string & z.BRAND<"ProjectId">;
+        worktreeId: string;
         branch: string;
         isPrimary: boolean;
         createdAt?: string | undefined;
@@ -369,8 +885,8 @@ export declare const WorktreeCreateResult: z.ZodObject<{
 }, {
     worktree: {
         path: string;
-        worktreeId: string;
         projectId: string;
+        worktreeId: string;
         branch: string;
         createdAt?: string | undefined;
         isPrimary?: boolean | undefined;
@@ -399,15 +915,15 @@ export declare const WorktreeListResult: z.ZodObject<{
         createdAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        worktreeId: string;
         projectId: string & z.BRAND<"ProjectId">;
+        worktreeId: string;
         branch: string;
         isPrimary: boolean;
         createdAt?: string | undefined;
     }, {
         path: string;
-        worktreeId: string;
         projectId: string;
+        worktreeId: string;
         branch: string;
         createdAt?: string | undefined;
         isPrimary?: boolean | undefined;
@@ -415,8 +931,8 @@ export declare const WorktreeListResult: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     worktrees: {
         path: string;
-        worktreeId: string;
         projectId: string & z.BRAND<"ProjectId">;
+        worktreeId: string;
         branch: string;
         isPrimary: boolean;
         createdAt?: string | undefined;
@@ -424,8 +940,8 @@ export declare const WorktreeListResult: z.ZodObject<{
 }, {
     worktrees: {
         path: string;
-        worktreeId: string;
         projectId: string;
+        worktreeId: string;
         branch: string;
         createdAt?: string | undefined;
         isPrimary?: boolean | undefined;
@@ -442,12 +958,12 @@ export declare const WorktreeRemoveParams: z.ZodObject<{
      */
     force: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    worktreeId: string;
     force: boolean;
     projectId: string & z.BRAND<"ProjectId">;
-}, {
     worktreeId: string;
+}, {
     projectId: string;
+    worktreeId: string;
     force?: boolean | undefined;
 }>;
 export type WorktreeRemoveParams = z.infer<typeof WorktreeRemoveParams>;
@@ -492,13 +1008,13 @@ export declare const GitDeleteBranchResult: z.ZodObject<{
     /** 被连带影响的 worktree（force 硬删时）。 */
     affectedWorktrees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    branch: string;
     deleted: true;
+    branch: string;
     wasMerged?: boolean | undefined;
     affectedWorktrees?: string[] | undefined;
 }, {
-    branch: string;
     deleted: true;
+    branch: string;
     wasMerged?: boolean | undefined;
     affectedWorktrees?: string[] | undefined;
 }>;
@@ -527,8 +1043,8 @@ export declare const GitCommitParams: z.ZodObject<{
     message: string;
     projectId: string & z.BRAND<"ProjectId">;
     allowEmpty: boolean;
-    worktreeId?: string | undefined;
     files?: string[] | undefined;
+    worktreeId?: string | undefined;
     author?: {
         name: string;
         email: string;
@@ -536,13 +1052,13 @@ export declare const GitCommitParams: z.ZodObject<{
 }, {
     message: string;
     projectId: string;
-    worktreeId?: string | undefined;
     files?: string[] | undefined;
-    allowEmpty?: boolean | undefined;
+    worktreeId?: string | undefined;
     author?: {
         name: string;
         email: string;
     } | undefined;
+    allowEmpty?: boolean | undefined;
 }>;
 export type GitCommitParams = z.infer<typeof GitCommitParams>;
 export declare const GitCommitResult: z.ZodObject<{
@@ -552,13 +1068,13 @@ export declare const GitCommitResult: z.ZodObject<{
     insertions: z.ZodOptional<z.ZodNumber>;
     deletions: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    commitSha: string;
     filesChanged: number;
+    commitSha: string;
     insertions?: number | undefined;
     deletions?: number | undefined;
 }, {
-    commitSha: string;
     filesChanged: number;
+    commitSha: string;
     insertions?: number | undefined;
     deletions?: number | undefined;
 }>;
@@ -576,8 +1092,8 @@ export declare const GitMergeParams: z.ZodObject<{
     /** 冲突时是否 abort（默认 true，避免 worktree 留在冲突状态） */
     abortOnConflict: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    strategy: "merge" | "squash" | "rebase" | "ff-only";
     projectId: string & z.BRAND<"ProjectId">;
+    strategy: "merge" | "squash" | "rebase" | "ff-only";
     sourceBranch: string;
     abortOnConflict: boolean;
     message?: string | undefined;
@@ -686,8 +1202,8 @@ export declare const GitLogParams: z.ZodObject<{
     /** 只看这些路径相关的提交 */
     paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    limit: number;
     projectId: string & z.BRAND<"ProjectId">;
+    limit: number;
     worktreeId?: string | undefined;
     branch?: string | undefined;
     paths?: string[] | undefined;
@@ -712,16 +1228,16 @@ export declare const GitCommitInfo: z.ZodObject<{
     subject: z.ZodString;
     body: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    email: string;
     author: string;
+    email: string;
     sha: string;
     shortSha: string;
     timestamp: string;
     subject: string;
     body?: string | undefined;
 }, {
-    email: string;
     author: string;
+    email: string;
     sha: string;
     shortSha: string;
     timestamp: string;
@@ -739,16 +1255,16 @@ export declare const GitLogResult: z.ZodObject<{
         subject: z.ZodString;
         body: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        email: string;
         author: string;
+        email: string;
         sha: string;
         shortSha: string;
         timestamp: string;
         subject: string;
         body?: string | undefined;
     }, {
-        email: string;
         author: string;
+        email: string;
         sha: string;
         shortSha: string;
         timestamp: string;
@@ -757,8 +1273,8 @@ export declare const GitLogResult: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     commits: {
-        email: string;
         author: string;
+        email: string;
         sha: string;
         shortSha: string;
         timestamp: string;
@@ -767,8 +1283,8 @@ export declare const GitLogResult: z.ZodObject<{
     }[];
 }, {
     commits: {
-        email: string;
         author: string;
+        email: string;
         sha: string;
         shortSha: string;
         timestamp: string;
@@ -795,8 +1311,8 @@ export declare const GitPushParams: z.ZodObject<{
 }, {
     projectId: string;
     branch: string;
-    worktreeId?: string | undefined;
     force?: boolean | undefined;
+    worktreeId?: string | undefined;
     remote?: string | undefined;
     setUpstream?: boolean | undefined;
 }>;
@@ -823,6 +1339,58 @@ export declare const GitPushResult: z.ZodObject<{
     remoteHead?: string | undefined;
 }>;
 export type GitPushResult = z.infer<typeof GitPushResult>;
+export declare const GitOriginParams: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+}, "strict", z.ZodTypeAny, {
+    projectId: string & z.BRAND<"ProjectId">;
+}, {
+    projectId: string;
+}>;
+export declare const GitOriginResult: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    path: z.ZodString;
+    repositoryRoot: z.ZodString;
+    observedAt: z.ZodString;
+    origin: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+        state: z.ZodLiteral<"configured">;
+        url: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        state: "configured";
+        url: string;
+    }, {
+        state: "configured";
+        url: string;
+    }>, z.ZodObject<{
+        state: z.ZodEnum<["missing", "unsupported"]>;
+    }, "strict", z.ZodTypeAny, {
+        state: "unsupported" | "missing";
+    }, {
+        state: "unsupported" | "missing";
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    observedAt: string;
+    projectId: string & z.BRAND<"ProjectId">;
+    origin: {
+        state: "configured";
+        url: string;
+    } | {
+        state: "unsupported" | "missing";
+    };
+    repositoryRoot: string;
+}, {
+    path: string;
+    observedAt: string;
+    projectId: string;
+    origin: {
+        state: "configured";
+        url: string;
+    } | {
+        state: "unsupported" | "missing";
+    };
+    repositoryRoot: string;
+}>;
+export type GitOriginResult = z.infer<typeof GitOriginResult>;
 export declare const GitStatusParams: z.ZodObject<{
     projectId: z.ZodBranded<z.ZodString, "ProjectId">;
     worktreeId: z.ZodOptional<z.ZodString>;
@@ -838,19 +1406,81 @@ export declare const GitFileStatus: z.ZodObject<{
     /** 文件路径（相对 cwd） */
     path: z.ZodString;
     /** 索引区状态（git status --porcelain 第 1 位） */
-    index: z.ZodEnum<["unmodified", "modified", "added", "deleted", "renamed", "copied", "untracked"]>;
+    index: z.ZodEnum<["unmodified", "modified", "added", "deleted", "renamed", "copied", "untracked", "unmerged", "typeChanged"]>;
     /** 工作区状态（第 2 位） */
-    worktree: z.ZodEnum<["unmodified", "modified", "added", "deleted", "renamed", "copied", "untracked"]>;
+    worktree: z.ZodEnum<["unmodified", "modified", "added", "deleted", "renamed", "copied", "untracked", "unmerged", "typeChanged"]>;
 }, "strip", z.ZodTypeAny, {
     path: string;
-    worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
-    index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
+    worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
+    index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
 }, {
     path: string;
-    worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
-    index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
+    worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
+    index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
 }>;
 export type GitFileStatus = z.infer<typeof GitFileStatus>;
+export declare const GitWorkspaceObservation: z.ZodEffects<z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    worktreeId: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    repositoryRoot: z.ZodString;
+    isWorktree: z.ZodBoolean;
+    detached: z.ZodBoolean;
+    head: z.ZodOptional<z.ZodString>;
+    observedAt: z.ZodString;
+    changedFileCount: z.ZodNumber;
+    trackedChangedFileCount: z.ZodNumber;
+    untrackedFileCount: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    observedAt: string;
+    projectId: string & z.BRAND<"ProjectId">;
+    detached: boolean;
+    repositoryRoot: string;
+    isWorktree: boolean;
+    changedFileCount: number;
+    trackedChangedFileCount: number;
+    untrackedFileCount: number;
+    worktreeId?: string | undefined;
+    head?: string | undefined;
+}, {
+    path: string;
+    observedAt: string;
+    projectId: string;
+    detached: boolean;
+    repositoryRoot: string;
+    isWorktree: boolean;
+    changedFileCount: number;
+    trackedChangedFileCount: number;
+    untrackedFileCount: number;
+    worktreeId?: string | undefined;
+    head?: string | undefined;
+}>, {
+    path: string;
+    observedAt: string;
+    projectId: string & z.BRAND<"ProjectId">;
+    detached: boolean;
+    repositoryRoot: string;
+    isWorktree: boolean;
+    changedFileCount: number;
+    trackedChangedFileCount: number;
+    untrackedFileCount: number;
+    worktreeId?: string | undefined;
+    head?: string | undefined;
+}, {
+    path: string;
+    observedAt: string;
+    projectId: string;
+    detached: boolean;
+    repositoryRoot: string;
+    isWorktree: boolean;
+    changedFileCount: number;
+    trackedChangedFileCount: number;
+    untrackedFileCount: number;
+    worktreeId?: string | undefined;
+    head?: string | undefined;
+}>;
+export type GitWorkspaceObservation = z.infer<typeof GitWorkspaceObservation>;
 export declare const GitStatusResult: z.ZodObject<{
     branch: z.ZodString;
     /** 是否 dirty（有任何未提交改动） */
@@ -863,37 +1493,125 @@ export declare const GitStatusResult: z.ZodObject<{
         /** 文件路径（相对 cwd） */
         path: z.ZodString;
         /** 索引区状态（git status --porcelain 第 1 位） */
-        index: z.ZodEnum<["unmodified", "modified", "added", "deleted", "renamed", "copied", "untracked"]>;
+        index: z.ZodEnum<["unmodified", "modified", "added", "deleted", "renamed", "copied", "untracked", "unmerged", "typeChanged"]>;
         /** 工作区状态（第 2 位） */
-        worktree: z.ZodEnum<["unmodified", "modified", "added", "deleted", "renamed", "copied", "untracked"]>;
+        worktree: z.ZodEnum<["unmodified", "modified", "added", "deleted", "renamed", "copied", "untracked", "unmerged", "typeChanged"]>;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
-        index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
+        worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
+        index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
     }, {
         path: string;
-        worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
-        index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
+        worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
+        index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
     }>, "many">;
+    /** Live, bounded device observation. Older peers may omit it. */
+    workspace: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+        worktreeId: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        repositoryRoot: z.ZodString;
+        isWorktree: z.ZodBoolean;
+        detached: z.ZodBoolean;
+        head: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodString;
+        changedFileCount: z.ZodNumber;
+        trackedChangedFileCount: z.ZodNumber;
+        untrackedFileCount: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        observedAt: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        detached: boolean;
+        repositoryRoot: string;
+        isWorktree: boolean;
+        changedFileCount: number;
+        trackedChangedFileCount: number;
+        untrackedFileCount: number;
+        worktreeId?: string | undefined;
+        head?: string | undefined;
+    }, {
+        path: string;
+        observedAt: string;
+        projectId: string;
+        detached: boolean;
+        repositoryRoot: string;
+        isWorktree: boolean;
+        changedFileCount: number;
+        trackedChangedFileCount: number;
+        untrackedFileCount: number;
+        worktreeId?: string | undefined;
+        head?: string | undefined;
+    }>, {
+        path: string;
+        observedAt: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        detached: boolean;
+        repositoryRoot: string;
+        isWorktree: boolean;
+        changedFileCount: number;
+        trackedChangedFileCount: number;
+        untrackedFileCount: number;
+        worktreeId?: string | undefined;
+        head?: string | undefined;
+    }, {
+        path: string;
+        observedAt: string;
+        projectId: string;
+        detached: boolean;
+        repositoryRoot: string;
+        isWorktree: boolean;
+        changedFileCount: number;
+        trackedChangedFileCount: number;
+        untrackedFileCount: number;
+        worktreeId?: string | undefined;
+        head?: string | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
-    branch: string;
     files: {
         path: string;
-        worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
-        index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
+        worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
+        index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
     }[];
+    branch: string;
     isClean: boolean;
+    workspace?: {
+        path: string;
+        observedAt: string;
+        projectId: string & z.BRAND<"ProjectId">;
+        detached: boolean;
+        repositoryRoot: string;
+        isWorktree: boolean;
+        changedFileCount: number;
+        trackedChangedFileCount: number;
+        untrackedFileCount: number;
+        worktreeId?: string | undefined;
+        head?: string | undefined;
+    } | undefined;
     ahead?: number | undefined;
     behind?: number | undefined;
     upstream?: string | undefined;
 }, {
-    branch: string;
     files: {
         path: string;
-        worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
-        index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked";
+        worktree: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
+        index: "deleted" | "unmodified" | "modified" | "added" | "renamed" | "copied" | "untracked" | "unmerged" | "typeChanged";
     }[];
+    branch: string;
     isClean: boolean;
+    workspace?: {
+        path: string;
+        observedAt: string;
+        projectId: string;
+        detached: boolean;
+        repositoryRoot: string;
+        isWorktree: boolean;
+        changedFileCount: number;
+        trackedChangedFileCount: number;
+        untrackedFileCount: number;
+        worktreeId?: string | undefined;
+        head?: string | undefined;
+    } | undefined;
     ahead?: number | undefined;
     behind?: number | undefined;
     upstream?: string | undefined;
@@ -911,17 +1629,17 @@ export declare const ProjectExecParams: z.ZodObject<{
     timeoutMs: z.ZodDefault<z.ZodNumber>;
     maxOutputBytes: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    projectId: string & z.BRAND<"ProjectId">;
     args: string[];
     command: string;
-    projectId: string & z.BRAND<"ProjectId">;
     timeoutMs: number;
     maxOutputBytes: number;
     worktreeId?: string | undefined;
     cwd?: string | undefined;
     env?: Record<string, string> | undefined;
 }, {
-    command: string;
     projectId: string;
+    command: string;
     worktreeId?: string | undefined;
     args?: string[] | undefined;
     cwd?: string | undefined;