Initial publish v0.1.0: standalone workflow core (corpus + examples + guards)

This commit is contained in:
octopus
2026-09-15 08:41:51 +08:00
commit bb35e661b2
114 changed files with 20240 additions and 0 deletions
+36
View File
@@ -0,0 +1,36 @@
# 术语映射表(Core ↔ dogfood 实例)
> 本表是 Core 改写与 dogfood 实例对照的**唯一事实源**v3 §E):Core 侧
> 工件使用下表左列的中立术语,右列是本组织 dogfood 实例(Gitea 后端)的
> 实际表述。任何 Core 工件需要落到本实例时,按本表做机械替换;反向
> 改写(实例 → Core)同样以本表为准。新增映射必须先改本表,再改工件。
| Core 中立术语 | dogfood/Gitea 实例表述 |
| --- | --- |
| 工单后端(ticket backend | Gitea |
| Tier-2 工件库 | Gitea wiki |
| 工单评论 APIticket backend 评论接口) | `gitea_issue_comment__*` |
| wiki 读写 APITier-2 工件库读写接口) | `gitea_wiki__*` |
| 看板移动 API(工单看板列迁移接口) | `gitea_column__move_issue` |
| 项目看板 API(工单面板管理接口) | `gitea_project__*` |
| 路由解析工具(Step 0 路由门依赖) | `route_resolver` |
| 会话工作树路径(并发分支工作区根) | `<worktrees-root>` |
| 测试命令·变更集(本地前置检查) | `bun run test:changed` |
| 测试命令·全量分片(交付前置 / nightly) | `bun run test:parallel` |
| 类型检查命令 | `bun typecheck` |
| 产品代码路径(harness 实现所在包) | `packages/octopus/src/...` |
| 私化工单引用(组织内部工单号) | `#NNNN` 活链接(Core 侧用 `[org-internal #NNNN]` 注记) |
| 实例规则目录(dogfood 消费副本所在) | `.octopus/`(如 `.octopus/rules/` |
| 运行工作区(Tier-1 本地工件) | `.octopus/runs/{slug}/` |
| 实例配置文件(会话/管线配置) | `octopus.jsonc` |
## 备注
- **私化工单引用**:Core 侧不得产出指向具体实例的活链接 `#NNNN`(会被
实例渲染为真实工单);一律写 `[org-internal #NNNN]` 注记格式,落地
实例时按本表还原为 `#NNNN`
- **命令占位**:Core 规则正文中的 `<test-cmd:changed>`
`<test-cmd:parallel>` 等占位符按本表「测试命令」两行绑定到实例命令。
- **裸词 Gitea**:仅当作为 adapter 名称出现时允许(如「Gitea adapter」);
- 表内反引号包裹的实例表述仅供对照,不构成 Core 对实例的引用
(C-1 扫描剥离行内代码后本表零命中)。