Object Types

含义 — 拥有独立 Agent Cell、独立文件目录和权限边界的部门。Department 是部署的基本颗粒：每个部门一个 Agent Cell，一个独立文件目录或 EFS/S3 prefix。

属性	类型	说明
id	string	全局唯一标识，例如 dept-strategy
name	string	部门名称
file_root	string	部门文件系统根路径（目录或 EFS/S3 prefix）
owner_agent	ref:Agent	负责该部门的 C-suite Agent
status	enum	active / suspended
created_at	timestamp	创建时间

关系 — 拥有多个 Agent 与 File；是 WorkItem 的归属边界；跨部门共享必须通过显式 Link 或 ShareContext 动作。

示例场景 — MVP 选择 Strategy 和 Marketing 两个部门，各自一个 Agent Cell 与独立目录，跨部门只共享 lead 摘要。

含义 — 在某个 Agent Cell 中运行、对特定目录和流程负责的 AI 执行主体。Agent 不是聊天窗口，而是有职责、有版本、有权限边界的组织成员（参见 Agent 即文件管理者）。

属性	类型	说明
id	string	全局唯一标识，例如 agent-cmo-01
name	string	Agent 名称
department_id	ref:Department	所属部门
role	string	职责描述，对应目录的 AGENT.md
version	string	Agent 配置版本，Action 提交时绑定
permission_scope	list	可访问的对象、目录与工具范围
status	enum	active / paused / retired
created_at	timestamp	注册时间

关系 — 属于一个 Department；负责若干 File（目录）；被 AssignAgent 动作分配到 WorkItem；所有动作提交写入 ActionLog。

示例场景 — Marketing Agent 负责 09_marketing/ 目录，发现 lead 后通过 ShareContext 把摘要共享给 Strategy Agent。

含义 — 部门文件系统中被纳入语义索引的文件或目录。File 对象让"文件"可以被引用、授权和审计，而不只是磁盘上的路径。

属性	类型	说明
id	string	全局唯一标识
path	string	相对部门 file_root 的路径
department_id	ref:Department	归属部门，决定默认权限边界
owner_agent	ref:Agent	负责该文件的 Agent
doc_type	enum	strategy / sop / research / deliverable / log 等
version	string	版本号，存储层启用版本化与备份
updated_at	timestamp	最近修改时间

关系 — 属于一个 Department；由一个 Agent 负责；被 WorkItem 和 Decision 引用；Agent 对它的每次修改在 ActionLog 中留下 file diff。

示例场景 — 一份客户调研笔记进入 Marketing 目录后注册为 File 对象，Strategy Agent 只能读取经 ShareContext 授权的摘要版本。

含义 — 可被分配、跟踪和关闭的工作单元：任务、工单、请求。WorkItem 是工作流语义的载体，也是 Interface 的典型示例——所有 WorkItem 都可以被分配、评论、关闭。

属性	类型	说明
id	string	全局唯一标识，即审计链中的 task id
title	string	任务标题
type	enum	task / ticket / request
department_id	ref:Department	归属部门
assignee	ref:Agent	当前负责的 Agent，由 AssignAgent 动作写入
status	enum	open / in_progress / blocked / closed
priority	enum	low / normal / high
created_at	timestamp	由 CreateWorkItem 动作创建的时间

关系 — 由 CreateWorkItem 创建；通过 AssignAgent 分配给 Agent；引用若干 File 作为输入与产出；可以产出 Decision；全程动作记录在 ActionLog。

示例场景 — "评估某条 lead 是否值得跟进"被建为 WorkItem，分配给 Strategy Agent，关闭条件是产出一个 Decision。

含义 — 一次有明确结论、依据和责任人的组织决策。Decision 把"拍板"从聊天记录里拿出来，变成可引用、可追溯、可复盘的一等对象。

属性	类型	说明
id	string	全局唯一标识
title	string	决策标题
outcome	enum	go / no-go / hold
rationale	text	决策依据摘要，引用相关 File 与对象
decided_by	ref:Agent | human	决策责任主体（Agent 或人类负责人）
context_package_id	string	决策时使用的上下文包版本，保证可回放
status	enum	draft / final / superseded
decided_at	timestamp	决策时间

关系 — 由 WorkItem 产出；通过 UpdateDecision 动作变更；引用 File 作为依据；高风险决策需先经 RequestApproval；决策过程完整记录在 ActionLog。

示例场景 — Strategy Agent 读取共享的 lead 摘要后生成 go/no-go 决策，ActionLog 记录决策过程与所用上下文包。

含义 — 外部客户或潜在客户。这是 MVP 中唯一的外部业务实体，用于验证跨部门共享的受控通道：Marketing 发现，Strategy 评估，共享的只是允许范围内的摘要。

属性	类型	说明
id	string	全局唯一标识
name	string	客户或线索名称
stage	enum	lead / qualified / customer / churned
source	string	线索来源渠道
owner_department	ref:Department	归属部门，默认 Marketing
shared_summary	text	允许跨部门读取的摘要字段，由 ShareContext 生成
status	enum	active / archived
created_at	timestamp	录入时间

关系 — 归属一个 Department；关联发现与评估两类 WorkItem；其去留由 Decision 决定；跨部门可见性由 ShareContext 动作控制。

示例场景 — Marketing Agent 发现一条制造业线索并录入为 Lead，Strategy Agent 只读取 shared_summary 字段完成评估（不虚构真实客户名）。

含义 — 一次 Action 提交的完整记录。ActionLog 的特殊之处在于它既是日志也是对象：可以被查询、聚合和分析，是审计、复盘与 Evolution Loop 的数据基础。

属性	类型	说明
id	string	action id，全局唯一
action_type	ref:ActionType	提交的动作类型
actor	ref:Agent | human	发起者
agent_version	string	发起 Agent 的配置版本
task_id	ref:WorkItem	关联的工作单元
context_package_id	string	执行时使用的上下文包版本
target_object	ref	动作的目标对象
file_diff	text	文件变更摘要
tool_summary	text	工具调用摘要
created_at	timestamp	提交时间

关系 — 记录所有 Action Type 的提交；绑定 Agent、WorkItem、目标对象与上下文包版本；中央日志短暂不可用时先写入本地审计缓冲，恢复后补发。

示例场景 — 上述 go/no-go 决策对应一条 ActionLog：action_type 为 UpdateDecision，附带 file diff 与工具调用摘要，可在复盘时完整回放。