用途:Pocket Enterprise 是面向明确选择远程生命周期同步的团队的可选增量适配器,需与匹配的 Core 角色并排安装,不捆绑或复制 Core 技能。Core 先提交本地状态与中性生命周期事件,不调用 gh、不合并 PR、不关闭 issue;适配器在任何外部操作前校验兼容性,确定性对账事件,归属不明时交由人工处理。
主要能力:适配器拥有 GitHub ID、凭据与远程证明,存于 Enterprise 自有元数据;Core 生命周期记录不含这些。事件路由包括 spec-approved(对账已批准 spec 与其 issue)、phase-complete(对账已有阶段 PR 及证明,缺失 PR 为 PR_REQUIRED,适配器从不创建)、phase-closed(仅堆叠计划,发布已关闭阶段 PR)、plan-closed(对账最终任务清单证明)。create-pr 是独立的用户触发记录器。
使用方式:从项目根运行预检 node enterprise/cli.js preflight <project-root> --json;依赖 npm 包时用 node node_modules/pocketto-pi/enterprise/cli.js preflight <project-root> --json。仅在确认兼容 Core 与已注册适配器后继续。Core 提供带 --json --contract 3 的 lifecycle transition、drain、repair、migrate 命令;drain 仅在 Enterprise 预检成功后运行。
限制:适配器从不合并 PR 或关闭 issue,这些由人工控制。归属不明时停止并请求人工解决,不做变更。不得从远程或凭据推断同意。升级后需重装适配器,contract 1 注册会以 ENTERPRISE_ADAPTER_CONTRACT_MISMATCH 失败。仅无执行进度的全新 v3 计划可迁移,否则返回 PIN_V3_REQUIRED。回滚时禁用或移除适配器但保留 Core 与 lifecycle.json,保留 .pocket-meta.json、log.json、待处理事件与远程标记,用原 ID 重放事件。