Context Guard 接口设计

　　由于当前项目开始涉及multi agent协作，多平台兼容，端云同步等多种通信问题，需要对接口进行规范设计。也通过这篇文档梳理整个项目的设计思路。

Context Guard
├── Agent Interface
├── Human Interface
├── Host Interface
└── Cloud Interface

　　注意当前仅为1.0版本interface design，最新版本参考github repo main interface.md

Agent Interface

小文件、可分层、可链接、按需展开、角色隔离、避免全量读取。
阅读优先级：

静态✅/动态🔴上下文

读写权限：

CLI 主要负责写和状态变化

Domain	接口函数	Caller	用途
map	`createNode(input: CreateNodeInput): Promise<Node>updateNode(input: UpdateNodeInput): Promise<Node>moveNode(input: MoveNodeInput): Promise<Node>deleteNode(input: DeleteNodeInput): Promise<void>`	C	创建、修改、移动、删除节点
task	`createTask(input: CreateTaskInput): Promise<Task>updateTask(input: UpdateTaskInput): Promise<Task>closeTask(input: CloseTaskInput): Promise<Task>`	C / E / T	创建、更新、关闭 Todo/任务
bug	`createBug(input: CreateBugInput): Promise<Bug>updateBug(input: UpdateBugInput): Promise<Bug>resolveBug(input: ResolveBugInput): Promise<Bug>`	C / E / T	创建、更新、修复 Bug
idea	`createIdea(input: CreateIdeaInput): Promise<Idea>updateIdea(input: UpdateIdeaInput): Promise<Idea>`	C	创建、更新 Idea
plan	`submitPlan(input: SubmitPlanInput): Promise<Plan>approvePlan(input: ApprovePlanInput): Promise<Plan>rejectPlan(input: RejectPlanInput): Promise<Plan>`	C / E	提交、批准、拒绝 Plan
handoff	`handoffToExecutor(input: HandoffInput): Promise<Handoff>handoffToTester(input: HandoffInput): Promise<Handoff>`	C	C→E/T 交接
result	`submitExecutionResult(input: ExecutionResultInput): Promise<Result>submitTestResult(input: TestResultInput): Promise<Result>`	E / T	回传执行或测试结果
session	`archiveSession(input: ArchiveSessionInput): Promise<Session>finishSession(input: FinishSessionInput): Promise<Session>recoverSession(input: RecoverSessionInput): Promise<Session>`	C / E / T	归档、完成、恢复 Session

Domain	接口函数
map	`getMap()` `getNode()` `createNode()` `updateNode()` `moveNode()` `deleteNode()`
task	`listTasks()` `getTask()` `updateTask()` `acceptTask()`
bug	`listBugs()` `getBug()` `updateBug()` `acceptBug()`
idea	`listIdeas()` `getIdea()` `updateIdea()`
plan	`getPlan()` `approvePlan()` `rejectPlan()`
result	`getResult()` `acceptResult()` `rejectResult()`
session	`listSessions()` `getSession()` `switchSession()`
permission	`getGrants()` `grant()` `revoke()`
conflict	`getConflict()` `resolveConflict()`
project	`getProject()` `updateSettings()`

Codex / Cursor / Claude 等宿主平台与 Context Guard 的连接

Domain	接口函数
session	`sessionStart()` `sessionStop()` `interrupt()`
prompt	`userPromptSubmit()`
tool	`preToolUse()` `postToolUse()` `toolFailure()`
permission	`permissionRequest()`
compact	`preCompact()` `postCompact()`
subagent	`subagentStart()` `subagentStop()`
identity	`getSessionId()` `getWorktree()` `getPlatform()`
context	`injectContext()` `refreshContext()`
runtime	`heartbeat()` `getRuntimeState()`
adapter	`normalizeEvent()`

定义本地 Context Guard 与云端服务之间，如何可靠交换状态、事件和权限。

Domain	接口函数
project	`connectProject()` `disconnectProject()` `getProjectState()`
sync	`pullState()` `pushOperation()` `syncStatus()` `checkpoint()`
session	`openSession()` `syncSession()` `publishSession()` `reopenSession()`
events	`subscribeEvents()` `getEvents()` `ackEvent()`
conflict	`getConflict()` `resolveConflict()`
auth	`login()` `refreshToken()` `logout()`
memory	`getMainMemory()` `getSessionMemory()` `updateMemory()`
recovery	`retrySync()` `recoverSession()`
heartbeat	`heartbeat()` `getPresence()`

<br>