diff --git a/DEVELOPMENT_PLAN.md b/archive/achieve/DEVELOPMENT_PLAN.md similarity index 100% rename from DEVELOPMENT_PLAN.md rename to archive/achieve/DEVELOPMENT_PLAN.md diff --git a/archive/achieve/OPENCLAW_PLUGIN_DEV_PLAN.md b/archive/achieve/OPENCLAW_PLUGIN_DEV_PLAN.md new file mode 100644 index 0000000..3b684a1 --- /dev/null +++ b/archive/achieve/OPENCLAW_PLUGIN_DEV_PLAN.md @@ -0,0 +1,77 @@ +# OpenClaw Plugin 开发计划（当前版） + +**状态**: API Key 方案已落地，challenge / WebSocket 旧方案已废弃。 + +## 当前架构 + +- HarborForge Monitor Backend 提供服务器注册与遥测接收接口 +- OpenClaw Gateway 加载 `harbor-forge` 插件 +- 旧 sidecar (`server/telemetry.mjs`) 已移除 +- 插件通过 Gateway/runtime 路径直接提供 OpenClaw 元数据 +- Monitor 可选通过本地 `monitor_port` 桥接读取补充信息 + +## 当前后端接口 + +### 公开接口 +- `GET /monitor/public/overview` + +### 管理接口 +- `GET /monitor/admin/servers` +- `POST /monitor/admin/servers` +- `DELETE /monitor/admin/servers/{id}` +- `POST /monitor/admin/servers/{id}/api-key` +- `DELETE /monitor/admin/servers/{id}/api-key` + +### 插件上报接口 +- `POST /monitor/server/heartbeat-v2` + - Header: `X-API-Key` + - Body: + - `identifier` + - `openclaw_version` + - `plugin_version` + - `agents` + - `cpu_pct` + - `mem_pct` + - `disk_pct` + - `swap_pct` + - `load_avg` + - `uptime_seconds` + +## 数据语义 + +- `openclaw_version`: 远程服务器上的 OpenClaw 版本 +- `plugin_version`: 远程服务器上的 `harbor-forge` 插件版本 + +## 已废弃内容 + +以下旧方案已经废弃，不再作为实现路径： + +- challenge UUID +- `GET /monitor/public/server-public-key` +- `POST /monitor/admin/servers/{id}/challenge` +- `WS /monitor/server/ws` +- challenge / nonce 握手逻辑 + +## 前端管理页要求 + +Monitor 管理页应提供： + +- Add Server +- Generate API Key +- Revoke API Key +- Delete Server + +不再提供 `Generate Challenge`。 + +## 运行流程 + +1. 管理员在 Monitor 中注册服务器 +2. 管理员为服务器生成 API Key +3. 将 API Key 写入 `~/.openclaw/openclaw.json` +4. 如需本地桥接补充信息，配置 `monitor_port` +5. 重启 OpenClaw Gateway +6. 插件直接参与遥测链路；若本地桥接可达，则额外提供 OpenClaw 补充元数据 + +## 备注 + +当前保留了对旧 challenge 数据表的**删除兼容清理**（仅为兼容老数据库中的遗留数据），但不再保留 challenge 功能入口、WebSocket 方案或 sidecar 运行时逻辑。 diff --git a/plans/automation/cron/hf-bootstrap-2026-03-21-state.json b/archive/achieve/automation/cron/hf-bootstrap-2026-03-21-state.json similarity index 100% rename from plans/automation/cron/hf-bootstrap-2026-03-21-state.json rename to archive/achieve/automation/cron/hf-bootstrap-2026-03-21-state.json diff --git a/plans/automation/cron/hf-bootstrap-2026-03-21.prompt.md b/archive/achieve/automation/cron/hf-bootstrap-2026-03-21.prompt.md similarity index 100% rename from plans/automation/cron/hf-bootstrap-2026-03-21.prompt.md rename to archive/achieve/automation/cron/hf-bootstrap-2026-03-21.prompt.md diff --git a/plans/automation/cron/hf-dev-kimi-2026-03-21.prompt.md b/archive/achieve/automation/cron/hf-dev-kimi-2026-03-21.prompt.md similarity index 100% rename from plans/automation/cron/hf-dev-kimi-2026-03-21.prompt.md rename to archive/achieve/automation/cron/hf-dev-kimi-2026-03-21.prompt.md diff --git a/plans/automation/cron/hf-dev-opus-2026-03-21.prompt.md b/archive/achieve/automation/cron/hf-dev-opus-2026-03-21.prompt.md similarity index 100% rename from plans/automation/cron/hf-dev-opus-2026-03-21.prompt.md rename to archive/achieve/automation/cron/hf-dev-opus-2026-03-21.prompt.md diff --git a/plans/harborforge-cli-go-plan.md b/archive/achieve/harborforge-cli-go-plan.md similarity index 100% rename from plans/harborforge-cli-go-plan.md rename to archive/achieve/harborforge-cli-go-plan.md diff --git a/plans/hf-cross-project-todo.md b/archive/achieve/hf-cross-project-todo.md similarity index 100% rename from plans/hf-cross-project-todo.md rename to archive/achieve/hf-cross-project-todo.md diff --git a/docs/milestone-propose-requirements.md b/archive/achieve/milestone-propose-requirements.md similarity index 100% rename from docs/milestone-propose-requirements.md rename to archive/achieve/milestone-propose-requirements.md diff --git a/archive/achieve/monitor-server-connector-plan.md b/archive/achieve/monitor-server-connector-plan.md new file mode 100644 index 0000000..2a2ae0b --- /dev/null +++ b/archive/achieve/monitor-server-connector-plan.md @@ -0,0 +1,54 @@ +# Monitor Server Connector Plan + +## Current design + +The plugin and Monitor communicate over a local bridge port (`monitor_port` / `MONITOR_PORT`). + +### Data flow + +1. **Monitor → Plugin** (GET): Plugin queries `GET /telemetry` on the bridge for host hardware data. +2. **Plugin → Monitor** (POST): Plugin pushes OpenClaw metadata via `POST /openclaw` to the bridge. +3. **Monitor → Backend**: Monitor heartbeats to `POST /monitor/server/heartbeat-v2` with `X-API-Key`, enriched with any available OpenClaw metadata. + +### Bridge endpoints (on Monitor, 127.0.0.1:MONITOR_PORT) + +| Endpoint | Method | Description | +|----------|--------|-------------| +| `/health` | GET | Health check, returns monitor version and identifier | +| `/telemetry` | GET | Latest hardware telemetry snapshot | +| `/openclaw` | POST | Receive OpenClaw metadata from plugin | + +### Plugin behavior + +- On `gateway_start`, plugin begins periodic metadata push (aligned with `reportIntervalSec`). +- Initial push is delayed 2s to allow Monitor bridge startup. +- If bridge is unreachable, pushes fail silently. Plugin remains fully functional. +- On `gateway_stop`, periodic push is stopped. + +## No longer used + +The following design has been retired: + +- challenge UUID / RSA handshake / WebSocket telemetry +- Plugin-side `server/` sidecar process + +## Heartbeat payload + +```json +{ + "identifier": "vps.t1", + "openclaw_version": "OpenClaw 2026.3.13 (61d171a)", + "plugin_version": "0.2.0", + "agents": [], + "cpu_pct": 10.5, + "mem_pct": 52.1, + "disk_pct": 81.0, + "swap_pct": 0.0, + "load_avg": [0.12, 0.09, 0.03], + "uptime_seconds": 12345, + "nginx_installed": true, + "nginx_sites": ["default"] +} +``` + +`openclaw_version`, `plugin_version`, and `agents` are optional enrichment from the plugin. If plugin never pushes metadata, these fields are omitted and the heartbeat contains only hardware telemetry. diff --git a/archive/achieve/openclaw-monitor-plugin-plan.md b/archive/achieve/openclaw-monitor-plugin-plan.md new file mode 100644 index 0000000..30d196c --- /dev/null +++ b/archive/achieve/openclaw-monitor-plugin-plan.md @@ -0,0 +1,78 @@ +# HarborForge Monitor / OpenClaw Plugin Connector Plan + +## 目标 + +使用 **API Key + HTTP heartbeat** 连接 HarborForge Monitor 与远程 OpenClaw 节点。 + +## 认证方式 + +- 管理员为服务器生成 API Key +- 插件通过 `X-API-Key` 调用 heartbeat 接口 +- 不再使用 challenge / RSA 公钥 / WebSocket 握手 + +## 上报接口 + +`POST /monitor/server/heartbeat-v2` + +### Headers +- `X-API-Key: ` + +### Payload +```json +{ + "identifier": "vps.t1", + "openclaw_version": "OpenClaw 2026.3.13 (61d171a)", + "plugin_version": "0.1.0", + "agents": [ + { "id": "agent-bot1", "name": "agent-bot1", "status": "configured" } + ], + "cpu_pct": 12.3, + "mem_pct": 45.6, + "disk_pct": 78.9, + "swap_pct": 0, + "load_avg": [0.12, 0.08, 0.03], + "uptime_seconds": 12345 +} +``` + +## 语义 + +- `openclaw_version`: 远程主机上的 OpenClaw 版本 +- `plugin_version`: `harbor-forge` 插件版本 + +## 插件生命周期 + +- 插件注册名为 `harbor-forge` +- 不再启动独立 `server/telemetry.mjs` sidecar +- 插件直接通过 Gateway/runtime 路径暴露 OpenClaw 元数据 +- 如配置了 `monitor_port`，插件还可通过本地桥接与 HarborForge.Monitor 交互 + +## 配置位置 + +`~/.openclaw/openclaw.json` + +```json +{ + "plugins": { + "entries": { + "harbor-forge": { + "enabled": true, + "config": { + "enabled": true, + "backendUrl": "http://127.0.0.1:8000", + "identifier": "vps.t1", + "apiKey": "your-api-key", + "monitor_port": 9100 + } + } + } + } +} +``` + +## 已废弃 + +- challenge UUID +- server public key +- WebSocket telemetry +- encrypted handshake payload diff --git a/CALENDAR_DESIGN.md b/plans/NEXT_WAVE_DEV_DIRECTION.md similarity index 77% rename from CALENDAR_DESIGN.md rename to plans/NEXT_WAVE_DEV_DIRECTION.md index c528636..eefdf06 100644 --- a/CALENDAR_DESIGN.md +++ b/plans/NEXT_WAVE_DEV_DIRECTION.md @@ -8,6 +8,13 @@ 为 HarborForge 新增日程表（Calendar）系统，支持 Agent/人类用户的任务调度、周期性计划、以及通过 OpenClaw 插件心跳自动唤醒 Agent 执行日程。 +同时记录一项项目结构调整： +- Propose 改名为 Proposal +- Proposal Accept 不再生成单个 Feature Task +- 改为在 Proposal 下维护多个 Essential；Accept 时将该 Proposal 下所有 Essential 按类型生成对应的 story task，并落到 Proposal 选择的 Milestone +- story 整个大类改为 restricted，只允许通过 Proposal Accept 创建 +- Essential 拥有独立的 EssentialCode，编码风格参考 ProjectCode / TaskCode 等既有结构 + 同时包含一个 bug fix：acc-mgr 用户密码不可修改，前端隐藏修改密码入口。 --- @@ -40,7 +47,7 @@ **Job:** ```json { - "type": "Task|Support|Meeting", + "type": "Task|Support|Meeting|Essential", "code": "TASK-42", "working_sessions": ["session-id-1", "session-id-2"] } @@ -283,7 +290,74 @@ hf user create [--agent-id ] [--claw-identifier ] ... --- -## 八、前端 +## 八、项目结构调整记录（与 Calendar 相关联的设计备注） + +### 8.1 命名调整 + +- `Propose` 统一改名为 `Proposal` + +### 8.2 新结构 + +```text +Project +└─ Proposal + ├─ Essential + │ ├─ feature + │ ├─ improvement + │ └─ refactor + └─ accept -> 将该 Proposal 下所有 Essential 生成对应类型的 story task，并创建到 Proposal 选择的 Milestone +``` + +### 8.3 Proposal Accept 语义变更 + +旧行为： +- Proposal Accept 后生成单个 `story/feature` task + +新行为： +- Proposal Accept **不再生成单个 Feature Task** +- 每个 Proposal 可维护多个 Essential +- Accept 时，遍历该 Proposal 下全部 Essential +- 按 Essential 类型映射生成对应的 story task： + - `feature` -> `story/feature` + - `improvement` -> `story/improvement` + - `refactor` -> `story/refactor` +- 生成目标 Milestone 由 Proposal 在 Accept 前或 Accept 时明确选择 + +### 8.4 Story 创建限制 + +- `story` 整个大类视为 **restricted** +- 任何 `story/*` task 都不允许通过通用 task create endpoint 直接创建 +- `story` 仅允许通过 `Proposal Accept` 工作流生成 + +### 8.5 Essential + +新增 `Essential` 概念，用于承载 Proposal 下的可落地核心条目。 + +建议字段： + +| 字段 | 类型 | 说明 | +|------|------|------| +| id | int (PK) | | +| essential_code | VARCHAR(64), UNIQUE | EssentialCode，风格参考 ProjectCode / TaskCode / MilestoneCode / ProposalCode | +| proposal_id | FK -> proposals.id | 所属 Proposal | +| type | Enum(feature, improvement, refactor) | Essential 类型 | +| title | VARCHAR(255) | 标题 | +| description | TEXT, nullable | 描述 | +| created_by_id | FK -> users.id, nullable | 创建人 | +| created_at | datetime | 创建时间 | +| updated_at | datetime | 更新时间 | + +### 8.6 代码生成 + +- `Essential` 拥有独立 `EssentialCode` +- 编码规则参考现有类似结构，例如： + - `ProjectCode` + - `MilestoneCode` + - `TaskCode` + - `ProposalCode` +- 具体前缀与编号策略待后续单独定稿 + +## 九、前端 - 每个用户可查看/调整自己的日程表 - Admin 可查看/调整所有用户的日程表 @@ -291,16 +365,18 @@ hf user create [--agent-id ] [--claw-identifier ] ... --- -## 九、Bug Fix +## 十、Bug Fix - acc-mgr 用户：后端禁止修改密码（admin 也不行） - 前端：acc-mgr 用户不显示修改密码入口 --- -## 十、待定项 +## 十一、待定项 - Entertainment 事件子类型设计 - MinimumWorkload 存储方式（JSON 字段 vs 独立表） - 前端日程表 UI 详细设计 - Agent 唤醒的提示词模板 +- Proposal / Essential 的详细数据模型、API、前端页面与 accept 流程实现细节 +- Story restricted 后，现有 task create / propose accept / milestone flow 的兼容迁移策略 diff --git a/plans/TASKLIST.md b/plans/TASKLIST.md new file mode 100644 index 0000000..f08debf --- /dev/null +++ b/plans/TASKLIST.md @@ -0,0 +1,379 @@ +# TASKLIST.md + +> 说明：如果某个进行中的 Task 没有完全完成，或者在执行过程中遇到 block，需要在该 Task 下继续拆分若干子 TODO item：本次开发中已经完成的部分标记为已完成，block / pending / 尚未完成的部分标记为未完成。 +> +> 拆分原则：尽量保证 Task 之间相互独立；每个 Task 最好只改动一个子模块（如 `HarborForge.Backend` / `HarborForge.Frontend` / `HarborForge.Cli` / `HarborForge.OpenclawPlugin` / 根目录文档），避免一次任务同时横跨多个子模块。只有在确实无法避免时，才建立跨模块 Task。 + +--- + +# TODOLIST + +## A. Root / Docs（根目录与规划文档） + +- [ ] DOC-001：整理本波开发范围说明（root docs only） + - [ ] 明确 Calendar 属于独立功能线 + - [ ] 明确 Proposal / Essential 属于项目结构调整线 + - [ ] 明确两条线的交叉点仅限 `event_data` / Agent 调度引用层 + - [ ] 将“必须本波完成”和“仅设计保留”区分写清楚 + +- [ ] DOC-002：整理 Proposal / Essential / Story restricted 的迁移说明（root docs only） + - [ ] 说明 `Propose -> Proposal` 的命名调整 + - [ ] 说明 `Proposal Accept` 语义变化 + - [ ] 说明 `story/*` 改为 restricted 的影响面 + - [ ] 说明旧数据和旧接口的兼容策略 + +- [ ] DOC-003：整理 Calendar 验收清单（root docs only） + - [ ] 列出后端验收项 + - [ ] 列出前端验收项 + - [ ] 列出 CLI 验收项 + - [ ] 列出插件联动验收项 + +## B. HarborForge.Backend — Proposal / Essential / Story restricted + +- [ ] BE-PR-001：后端统一重命名 `Propose` 概念为 `Proposal`（backend only） + - [ ] 盘点 `models / schemas / routers / services / tests` 中 `propose` 命名 + - [ ] 明确保留兼容别名还是直接切换 + - [ ] 输出重命名影响清单 + +- [ ] BE-PR-002：新增 Proposal 数据模型调整（backend only） + - [ ] 调整 Proposal 模型命名与字段注释 + - [ ] 确认 Proposal 与 `project_id / created_by_id / feat_task_id` 的后续关系 + - [ ] 标记 `feat_task_id` 是否废弃或替换 + +- [ ] BE-PR-003：新增 Essential 模型（backend only） + - [ ] 新增 `Essential` SQLAlchemy model + - [ ] 增加 `proposal_id` 外键 + - [ ] 增加 `essential_code` + - [ ] 增加 `type / title / description / created_by_id / created_at / updated_at` + +- [ ] BE-PR-004：实现 EssentialCode 编码规则（backend only） + - [ ] 参考现有 `ProjectCode / MilestoneCode / TaskCode / ProposeCode` 生成方式 + - [ ] 设计 Essential code 前缀 + - [ ] 实现唯一编号生成逻辑 + - [ ] 明确是否需要独立 counter 表 + +- [ ] BE-PR-005：新增 Essential 的 schema 定义（backend only） + - [ ] 新增 create schema + - [ ] 新增 update schema + - [ ] 新增 response schema + - [ ] 新增 Proposal detail 中嵌套 Essential 的返回结构 + +- [ ] BE-PR-006：新增 Proposal 下 Essential CRUD API（backend only） + - [ ] 实现创建 Essential + - [ ] 实现编辑 Essential + - [ ] 实现删除 Essential + - [ ] 实现 Proposal 详情返回 Essential 列表 + +- [ ] BE-PR-007：重构 Proposal Accept 逻辑（backend only） + - [ ] 移除“accept 后生成单个 `story/feature` task”的旧逻辑 + - [ ] Accept 时要求显式选择目标 Milestone + - [ ] 遍历 Proposal 下全部 Essential + - [ ] 按 Essential.type 生成对应 `story/*` task + - [ ] 保证批量创建在一个事务中完成 + +- [ ] BE-PR-008：补充 Proposal Accept 追踪字段/关系（backend only） + - [ ] 明确 Proposal 与生成 tasks 的映射方式 + - [ ] 设计是用反查字段、关联表还是事件记录 + - [ ] 实现最小可用追踪能力 + +- [ ] BE-PR-009：收紧 Task 类型规则，限制全部 `story/*`（backend only） + - [ ] 更新 `TASK_SUBTYPE_MAP` 相关约束 + - [ ] 将所有 `story/*` 组合标记为 restricted + - [ ] 禁止通用 create endpoint 直接创建任何 story + - [ ] 保留内部受控入口用于 Proposal Accept + +- [ ] BE-PR-010：清理旧的 `feat_task_id` 语义（backend only） + - [ ] 判断字段是否保留但废弃 + - [ ] 如果废弃，给出兼容读取策略 + - [ ] 如果替换，落地新的字段或关联方式 + +- [ ] BE-PR-011：补 Proposal / Essential / Story restricted 的后端测试（backend only） + - [ ] Essential CRUD 测试 + - [ ] Proposal Accept 批量生成 story task 测试 + - [ ] 非受控入口创建 `story/*` 的失败测试 + - [ ] 兼容旧 proposal 数据的测试 + +## C. HarborForge.Backend — Calendar 基础模型与规则 + +- [ ] BE-CAL-001：新增 Calendar 基础模型 `TimeSlot`（backend only） + - [ ] 新增表结构 + - [ ] 定义 slot status / slot type / event type 枚举 + - [ ] 定义时间字段与时长字段 + - [ ] 定义 `plan_id` 关联 + +- [ ] BE-CAL-002：新增 Calendar 基础模型 `SchedulePlan`（backend only） + - [ ] 新增表结构 + - [ ] 定义 `at_time / on_day / on_week / on_month` + - [ ] 加入层级参数校验约束 + - [ ] 处理 user 归属关系 + +- [ ] BE-CAL-003：新增 Agent 扩展字段（backend only） + - [ ] 为 Agent 增加 `status / last_heartbeat` + - [ ] 增加 `exhausted_at / recovery_at / exhaust_reason` + - [ ] 明确与现有 user / monitor 标识的关系 + +- [ ] BE-CAL-004：实现 MinimumWorkload 存储方案（backend only） + - [ ] 确定 JSON 字段还是独立表 + - [ ] 实现用户级配置读写 + - [ ] 提供后续校验调用入口 + +- [ ] BE-CAL-005：实现 Plan 虚拟 slot 标识与物化策略（backend only） + - [ ] 实现 `plan-{plan_id}-{date}` 标识规则 + - [ ] 实现虚拟 slot 转真实 slot 的物化逻辑 + - [ ] 实现 edit / cancel 后断开 plan 关联 + +- [ ] BE-CAL-006：实现 Calendar overlap 校验（backend only） + - [ ] 校验同日时间冲突 + - [ ] 返回明确的冲突错误信息 + - [ ] 区分 create 与 edit 两种场景 + +- [ ] BE-CAL-007：实现 MinimumWorkload warning 规则（backend only） + - [ ] 计算 daily / weekly / monthly / yearly 工作量 + - [ ] 不阻止提交，仅返回 warning + - [ ] 统一 warning 数据结构 + +- [ ] BE-CAL-008：实现不可修改过去 slot 的规则（backend only） + - [ ] 禁止 edit 过去 slot + - [ ] 禁止 cancel 过去 slot + - [ ] 保证 plan-edit / plan-cancel 不追溯过去已物化 slot + +## D. HarborForge.Backend — Calendar API + +- [ ] BE-CAL-API-001：实现单次日程创建 API（backend only） + - [ ] 创建 slot + - [ ] 支持 job/system/event_data + - [ ] 接入 overlap 与 workload warning + +- [ ] BE-CAL-API-002：实现某日 Calendar 查询 API（backend only） + - [ ] 返回真实 slot + - [ ] 合成当日 plan 虚拟 slot + - [ ] 输出统一排序结构 + +- [ ] BE-CAL-API-003：实现 Calendar 编辑 API（backend only） + - [ ] 支持真实 slot 编辑 + - [ ] 支持虚拟 slot 编辑并触发物化 + - [ ] 返回编辑后的真实结果 + +- [ ] BE-CAL-API-004：实现 Calendar 取消 API（backend only） + - [ ] 支持真实 slot cancel + - [ ] 支持虚拟 slot cancel 并触发物化 + - [ ] 处理状态字段更新 + +- [ ] BE-CAL-API-005：实现 plan-schedule / plan-list API（backend only） + - [ ] 创建计划 + - [ ] 列出计划 + - [ ] 返回计划规则字段 + +- [ ] BE-CAL-API-006：实现 plan-edit / plan-cancel API（backend only） + - [ ] 编辑计划 + - [ ] 取消计划 + - [ ] 不追溯已物化过去数据 + +- [ ] BE-CAL-API-007：实现 date-list API（backend only） + - [ ] 仅列出有已物化未来 slot 的日期 + - [ ] 排除纯 plan 未物化日期 + +## E. HarborForge.Backend — Agent / Plugin Calendar 协作 + +- [ ] BE-AGT-001：定义心跳查询待执行 slot 的服务层（backend only） + - [ ] 筛选当天 `NotStarted / Deferred` + - [ ] 仅返回 `scheduled_at` 已过的 slot + - [ ] 按优先级排序 + +- [ ] BE-AGT-002：实现 Agent 状态流转服务（backend only） + - [ ] Idle -> Busy / OnCall + - [ ] Busy / OnCall -> Idle + - [ ] 超时无心跳 -> Offline + - [ ] API 配额错误 -> Exhausted + +- [ ] BE-AGT-003：实现多 slot 竞争处理（backend only） + - [ ] 选最高 priority 执行 + - [ ] 其余 slot 标记 Deferred + - [ ] Deferred slot 自动 priority += 1 + +- [ ] BE-AGT-004：实现 Exhausted 恢复时间解析（backend only） + - [ ] 解析 retry-after / reset in / resets at + - [ ] 解析失败时默认 5 小时 + - [ ] 到期恢复 Idle + +## F. HarborForge.Frontend — Proposal / Essential / Story restricted + +- [ ] FE-PR-001：前端统一重命名 Propose -> Proposal（frontend only） + - [ ] 调整页面标题与菜单文案 + - [ ] 调整类型名与 API 调用命名 + - [ ] 清理旧 propose 文案 + +- [ ] FE-PR-002：Proposal 详情页增加 Essential 列表区（frontend only） + - [ ] 展示 Essential 列表 + - [ ] 展示 Essential type / code / title + - [ ] 处理空状态 + +- [ ] FE-PR-003：新增 Essential 创建/编辑表单（frontend only） + - [ ] 创建表单 + - [ ] 编辑表单 + - [ ] type 选择器 + - [ ] 提交后局部刷新 + +- [ ] FE-PR-004：Proposal Accept 增加目标 Milestone 选择（frontend only） + - [ ] Accept 前展示 milestone 选择控件 + - [ ] 校验必须选择 milestone + - [ ] 展示 Accept 成功后的生成结果 + +- [ ] FE-PR-005：限制前端直接创建 `story/*`（frontend only） + - [ ] 从 Task 创建入口移除 story + - [ ] 或将 story 整体设为不可选 + - [ ] 调整相关提示文案 + +## G. HarborForge.Frontend — Calendar + +- [ ] FE-CAL-001：新增 Calendar 页面基础骨架（frontend only） + - [ ] 增加路由入口 + - [ ] 增加侧边栏入口 + - [ ] 增加基础页面布局 + +- [ ] FE-CAL-002：实现某日 slot 列表展示（frontend only） + - [ ] 展示时间轴或列表 + - [ ] 区分真实 slot 与 plan 虚拟 slot + - [ ] 展示状态 / 类型 / 时长 / 优先级 + +- [ ] FE-CAL-003：实现计划列表展示（frontend only） + - [ ] 展示计划规则 + - [ ] 展示周期参数 + - [ ] 支持跳转编辑 + +- [ ] FE-CAL-004：实现创建 / 编辑 / 取消日程交互（frontend only） + - [ ] 新建 slot 表单 + - [ ] 编辑 slot 表单 + - [ ] cancel 操作确认 + - [ ] 展示后端 warning + +- [ ] FE-CAL-005：实现 Deferred / Exhausted / overlap 等状态提示（frontend only） + - [ ] Deferred 提示 + - [ ] overlap 报错展示 + - [ ] workload warning 展示 + - [ ] Exhausted 状态展示 + +## H. HarborForge.Cli — Proposal / Essential / Story restricted + +- [ ] CLI-PR-001：统一 CLI 文案 `propose -> proposal`（cli only） + - [ ] 调整命令 help 文案 + - [ ] 调整输出文本 + - [ ] 评估命令名是否兼容保留 `hf propose` + +- [ ] CLI-PR-002：新增 Essential 相关命令（cli only） + - [ ] `hf proposal essential list` + - [ ] `hf proposal essential create` + - [ ] `hf proposal essential update` + - [ ] `hf proposal essential delete` + +- [ ] CLI-PR-003：更新 Proposal Accept CLI（cli only） + - [ ] Accept 时支持传入 milestone + - [ ] 展示批量生成的 task 结果 + - [ ] 更新帮助文案 + +- [ ] CLI-PR-004：限制 CLI 直接创建 `story/*`（cli only） + - [ ] 阻止 story 类型直建 + - [ ] 返回明确错误提示 + - [ ] 提示改走 Proposal Accept + +## I. HarborForge.Cli — Calendar + +- [ ] CLI-CAL-001：新增 `hf calendar` 命令组骨架（cli only） + - [ ] 注册命令组 + - [ ] 增加 help surface + - [ ] 增加 brief help + +- [ ] CLI-CAL-002：实现 `hf calendar schedule`（cli only） + - [ ] 参数解析 + - [ ] 请求构造 + - [ ] 结果输出 + +- [ ] CLI-CAL-003：实现 `hf calendar show`（cli only） + - [ ] 日期参数 + - [ ] 列表输出 + - [ ] JSON 输出 + +- [ ] CLI-CAL-004：实现 `hf calendar edit`（cli only） + - [ ] 支持 slot-id 与 date + - [ ] PATCH/POST 适配 + - [ ] 输出 warning / error + +- [ ] CLI-CAL-005：实现 `hf calendar cancel`（cli only） + - [ ] 支持 slot-id 与 date + - [ ] 输出结果 + +- [ ] CLI-CAL-006：实现 `hf calendar date-list`（cli only） + - [ ] 列出未来已物化日期 + - [ ] 适配 JSON 输出 + +- [ ] CLI-CAL-007：实现 `hf calendar plan-schedule`（cli only） + - [ ] 参数解析 `--at --on-day --on-week --on-month` + - [ ] 请求构造 + - [ ] 输出结果 + +- [ ] CLI-CAL-008：实现 `hf calendar plan-list`（cli only） + - [ ] 列表输出 + - [ ] JSON 输出 + +- [ ] CLI-CAL-009：实现 `hf calendar plan-edit`（cli only） + - [ ] 参数解析 + - [ ] 请求发送 + - [ ] 输出结果 + +- [ ] CLI-CAL-010：实现 `hf calendar plan-cancel`（cli only） + - [ ] 参数解析 + - [ ] 请求发送 + - [ ] 输出结果 + +## J. HarborForge.OpenclawPlugin / Monitor 联动 + +- [ ] PLG-CAL-001：插件侧定义 Calendar 心跳请求格式（plugin only） + - [ ] 明确 claw_identifier 传递方式 + - [ ] 明确 agent_id 传递方式 + - [ ] 明确返回 slot 列表结构 + +- [ ] PLG-CAL-002：插件侧处理待执行 slot 唤醒（plugin only） + - [ ] Idle 时唤醒 agent + - [ ] 透传任务上下文 + - [ ] 执行前更新 attended / started_at / status + +- [ ] PLG-CAL-003：插件侧处理非 Idle / Deferred 分支（plugin only） + - [ ] Agent 非 Idle 时上报 Deferred + - [ ] 处理多 slot 重排后的重新规划 + +- [ ] PLG-CAL-004：插件侧处理 ScheduledGatewayRestart（plugin only） + - [ ] 收到事件后持久化状态 + - [ ] 发送最终心跳 + - [ ] 暂停定时任务 + +## K. Tests / Integration（按子模块分别补，不混做） + +- [ ] TEST-BE-CAL-001：补 Calendar backend 测试（backend tests only） + - [ ] 模型测试 + - [ ] API 测试 + - [ ] overlap / warning / materialize 测试 + +- [ ] TEST-BE-PR-001：补 Proposal / Essential backend 测试（backend tests only） + - [ ] Essential CRUD + - [ ] Accept 生成 story tasks + - [ ] story restricted + +- [ ] TEST-FE-CAL-001：补 Calendar 前端测试（frontend tests only） + - [ ] 页面渲染 + - [ ] 表单交互 + - [ ] warning / error 展示 + +- [ ] TEST-FE-PR-001：补 Proposal / Essential 前端测试（frontend tests only） + - [ ] Essential 列表与表单 + - [ ] Accept milestone 选择 + - [ ] story 创建入口限制 + +- [ ] TEST-CLI-CAL-001：补 Calendar CLI 测试（cli tests only） + - [ ] 命令解析 + - [ ] JSON 输出 + - [ ] 错误输出 + +- [ ] TEST-CLI-PR-001：补 Proposal / Essential CLI 测试（cli tests only） + - [ ] Essential 子命令 + - [ ] accept milestone 参数 + - [ ] story 限制提示