woostack-build

woostack-build

Build 是一个薄控制器封装，用于内部决策和规划阶段。它始终在 .woostack/tmp/runs/<run-id>/ 下保留本地运行，支持精确的 --run，保留 Success/Stop/Abandon 产物，并在经过验证的交接处停止，由调用方提供一个选定的、完整且范围明确的任务供 Execute 使用。本地运行始终具有权威性；Linear、Plane 或 GitHub 仅作为可选镜像流程，并受 artifacts.provider: "linear"、artifacts.provider: "plane" 或 artifacts.provider: "github" 控制。对于仓库交付，Git 和规范的 GitHub 读取仍具有权威性。默认使用 Git + gh；可选的 Graphite 选择遵循源代码控制契约。合并权限仅属于人工：绝不自动合并、绝不加入队列、绝不合并。

命令

/woostack-build <goal> [--project <exact Linear, Plane, or GitHub URL-or-UUID>] [--run <exact-run-id>]
/woostack-build --run <exact-run-id>
/woostack-build --project <exact Linear, Plane, or GitHub URL-or-UUID>

指定 --run <exact-run-id> 时，Build 会根据共享产物契约，仅恢复 .woostack/tmp/runs/<run-id>/ 下对应的确切运行目录。未指定时，Build 会在 .woostack/tmp/runs/<run-id>/ 下创建一个新的持久本地运行。

默认本地模式不会调用任何服务提供方。显式指定 --project 时，必须配置服务提供方镜像；只能通过选定的配置和 Build 上下文解析或创建对应的确切项目。 执行操作前，先加载共享的 产物契约，然后只加载选定的服务提供方条目：

artifacts.provider	服务提供方配置	Build 上下文	同步
"github"	GitHub	GitHub 上下文	GitHub 流程
"linear"	Linear	Linear 上下文	Linear 流程
"plane"	Plane	Plane 上下文	Plane 流程

本地模式不会加载任何服务提供方配置或服务提供方流程。共享契约是运行分配与恢复、权限受限的清单、可读的纯 Markdown 产物、可选镜像同步、图排序、漂移/故障恢复和保留策略的唯一权威来源。选定的配置和 Build 参考仅提供服务提供方特定的范围、身份、能力、变更操作和回读方式。 分配、每次清单读取/CAS 检查点以及最终纯文本产物写入，都使用规范的运行存储辅助工具。Build 提供完整的准入内容；辅助工具负责文件系统安全，不负责用户批准或工作流状态。

共享的仓库祖先关系契约规定了父分支意图和基线变动检测；本封装不会重述这些规则。

固定链路

allocate or resume canonical local run `.woostack/tmp/runs/<run-id>/` (and admit baseline when mirroring) →
draft Ideate/Harden locally with zero provider calls →
writes plain Markdown `project-spec.md` (and perform optional bounded mirror sync/read-back) →
draft delegated Plan/Harden locally with zero provider calls →
writes plain Markdown `execution-plan.md` (and perform optional bounded mirror sync/read-back) →
retain run artifacts → present verified handoff and ask `Stop here`/`Execute`/`Abandon`

已停用自动执行。 不再自动分发 Execute 或移交给运行控制器。 构建会在保留产物处停止；调用方选择一个完整且有界的任务，并将其连同决策、 父级证据和精确保留状态一起提供给 woostack-execute。 最终编排自动化属于后续工作。 调用 woostack-ideate 以获取经用户验证的完整决策，并调用 woostack-harden 以根据有界的仓库证据进行协调。二者仅在基线准入后 操作共享的、限定于运行的清单，在受门控时不会调用提供方，也不负责审批门控。

写入 project-spec.md 后（并且可选的镜像同步已完成，或已记录为非阻塞失败），使用可读的规范、 基线身份和已验证的运行清单调用 woostack-plan。由 Build 委派时，Plan 仅 根据其所选提供方的不变量返回候选图，不执行提供方读取或 变更。Harden 会将候选图纳入清单，并根据仓库证据进行协调。Build 会直接在运行目录下写入 execution-plan.md；当 artifacts.provider: "linear"、artifacts.provider: "plane" 或 artifacts.provider: "github" 时，还会执行可选的有界镜像同步。

在两个边界处都应用最少代码原则。Ideate 负责让用户验证完整规范，包括技术 细节和可删减内容；Harden 负责与仓库进行协调。仓库证据和建议的默认值都不能替代用户的决策。

可读的纯文本产物

Build 会在共享的纯文本产物约定下，直接在 .woostack/tmp/runs/<run-id>/ 中写入 Markdown 格式的纯文本 project-spec.md 和 execution-plan.md：

1. 项目规范。 写入 project-spec.md，其中包含经用户验证的完整规范。 当 artifacts.provider: "linear"、artifacts.provider: "plane" 或 artifacts.provider: "github" 时，会执行一次有界镜像同步，写入规范并 在清单中记录镜像状态；镜像失败不阻塞流程。
2. 执行计划。 写入 execution-plan.md，其中包含所有有序增量契约和 依赖元组。当 artifacts.provider: "linear"、artifacts.provider: "plane" 或 artifacts.provider: "github" 时，会执行一次有界镜像同步，将稳定的 本地任务键关联到规范提供方引用，并在清单中记录镜像状态；镜像失败 不阻塞流程。

允许跨会话继续使用经过独立验证的运行状态。成功完成或明确放弃后，都会保留 .woostack/tmp/runs/<run-id>/ 中的所有运行产物。共享本地边界上的任何失败都会阻止 Build；本地草稿绝不会替代最后一个经过验证的边界。

已验证交接

此交接适用于 Build 和以项目为依据的 Fix。两者完成后，写入经用户验证的 project-spec.md 和 execution-plan.md（并完成可选镜像，或记录非阻塞失败）后，负责的工作流会显示确切的运行 ID、可读的产物路径、稳定的任务映射、依赖关系元组、规划父分支、规划父分支最新提交，以及可选的镜像映射和状态（启用镜像时）。随后，工作流停留在保留的产物处：

已弃用： /woostack-execute --run <exact-run-id> 已弃用（参见 woostack-execute）。要继续，调用方需选择一个完整且范围明确的任务，并将其作为 /woostack-execute <bounded input> 提供，同时附上相关决策、父级证据和确切的保留状态。

超出顺序执行约定的 GitHub DAG 会被保留并镜像，不会被线性化。 GitHub 父级选择约定 记录预期的 Orchestrate 边界和任何尚未解决的合并决策。

询问是否要 Stop here、Execute 或 Abandon。接受明确无歧义的自然语言选择； 用户无需重复照抄选项标签。

• Stop here： 返回，不更改仓库、运行或项目状态。
• Execute： 调用方将一个选定的完整且范围明确的任务连同上述确切的保留状态提供给 woostack-execute；Build 不会自动分派。
• Abandon： 记录 status: "abandoned"，保留运行，不更改任何已镜像的项目，也不分派 Execute。

意图不明确时，应请求澄清且不做任何更改。若回复改变了范围、技术决策或验收标准，则返回负责的 Ideate/Harden/Plan 边界进行明确验证；对先前产物的批准并不意味着授权更改后的约定。明确选择 Execute 时，可以附带范围内的验证提醒。

范围明确的 Execute 任务会根据其提供的父级证据应用共享的仓库祖先关系和基线变更约定，并依据自身约定负责实现、针对性验证和仓库交付。Build 不会选择其他执行模式、创建相互竞争的权威来源或进行合并。

任何必需的本地清单边界失败都会阻塞在最后一个已验证的边界。产物记录绝不能替代必需的 Git/GitHub 证据（以及该模式下的 Graphite 证据），也不能授予仓库权限。