woostack-build

woostack-build

Build は、内部の意思決定フェーズと計画フェーズを薄くラップするコントローラーです。.woostack/tmp/runs/<run-id>/ の下に常に永続的なローカル実行を保持し、--run による正確な実行の指定をサポートします。また、成功／停止／放棄の成果物を保持し、呼び出し元が Execute に渡す、選択済みの完結した範囲内のタスクを 1 つ指定する、検証済みの引き継ぎ地点で停止します。ローカル実行が無条件で権限を持ちます。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 チェックポイントすべて、および最終的なプレーン成果物の書き込みには、正規の run-store ヘルパーを使用します。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 のディスパッチや run-controller への引き継ぎはありません。Build は保持された成果物の作成までで停止します。呼び出し元が、完全かつ範囲が限定されたタスクを 1 つ選び、その判断、親のエビデンス、正確な保持状態とともに woostack-execute に渡します。最終的なオーケストレーションの自動化は今後の作業です。 網羅的なユーザー確認済みの判断には woostack-ideate を、範囲が限定されたリポジトリのエビデンスとの整合には woostack-harden を呼び出します。どちらもベースラインの受け入れ後にのみ、共有の実行スコープ付きマニフェストで作業します。ゲート中はプロバイダーを呼び出さず、承認ゲートも管理しません。

project-spec.md の書き込み後（および、任意のミラー同期が完了するか、ブロッキングではない失敗を記録した後）、読み取り可能な仕様、ベースライン ID、検証済みの実行マニフェストを指定して 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" の場合、範囲を限定したミラー同期を 1 回実行して仕様を書き込み、マニフェストにミラーの状態を記録します。ミラーの失敗はブロッキングではありません。
2. 実行計画。 順序付けられたすべてのインクリメント契約と依存関係タプルを含む execution-plan.md を書き込みます。artifacts.provider: "linear"、artifacts.provider: "plane"、または artifacts.provider: "github" の場合、範囲を限定したミラー同期を 1 回実行して、安定したローカルタスクキーを正規のプロバイダー参照に結び付け、マニフェストにミラーの状態を記録します。ミラーの失敗はブロッキングではありません。

独立して検証済みの実行状態であれば、セッションをまたいで続行できます。.woostack/tmp/runs/<run-id>/ 内のすべての実行成果物は、正常に完了した場合も、明示的に中断した場合も保持されます。共有ローカル境界で失敗が発生した場合は、Build がブロックされます。ローカルの下書きが、最後に検証された境界に取って代わることはありません。

検証済みの引き継ぎ

この引き継ぎは、Build とプロジェクト連携型 Fix に共通です。両方の完了後、ユーザーが検証した project-spec.md と execution-plan.md が書き込まれ（任意のミラーリングが完了するか、ブロックしない失敗として記録された後）、ワークフローの担当者は、正確な実行 ID、読み取り可能な成果物のパス、安定したタスクの対応関係、依存関係のタプル、計画の親ブランチ、計画時点の親ブランチの先端、および任意のミラーリングの対応関係とステータス（ミラーリングが有効な場合）を表示します。その後、保持された成果物の状態で停止します。

廃止済み： /woostack-execute --run <exact-run-id> は廃止されました（woostack-execute を参照）。続行するには、呼び出し側が範囲を限定した完全なタスクを1つ選び、その判断、親の根拠、および正確に保持された状態とともに、/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 も）に代わることはなく、リポジトリへのアクセス権を付与することもありません。