VS Code + Cline で ”Devin 風”開発を行う方法⑤ - マルチエージェントループ実行編 #1

#
# Kanban 開発ループを構築します。
#
using module .\kanban\status\status-manager.psm1

param(
    [string]$baseRef

)

$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
$ProjectRoot = Resolve-Path (Join-Path $ScriptDir "..\..")

Import-Module (Join-Path $PSScriptRoot "kanban\status\status-manager.psm1")
Import-Module (Join-Path $PSScriptRoot "common\logger.psm1")
Import-Module (Join-Path $PSScriptRoot "common\json.psm1")
Import-Module (Join-Path $PSScriptRoot "common\git.psm1")
Import-Module (Join-Path $PSScriptRoot "common\task.psm1")
Import-Module (Join-Path $PSScriptRoot "common\lock.psm1")

$CreateBranch = Join-Path $PSScriptRoot "kanban\git\create-branch.ps1"
$PopStash = Join-Path $PSScriptRoot "kanban\git\pop-stash.ps1"
$CreatePlan = Join-Path $PSScriptRoot "kanban\task\create-plan.ps1"
$CreateWork = Join-Path $PSScriptRoot "kanban\task\create-work.ps1"
$CreateReview = Join-Path $PSScriptRoot "kanban\task\create-review.ps1"
$Detach = Join-Path $PSScriptRoot "kanban\git\detach.ps1"
$GetTaskId = Join-Path $PSScriptRoot "kanban\task\get-task-id.ps1"
$StartKanbanTask = Join-Path $PSScriptRoot "kanban\task\start-kanban-task.ps1"

Write-Header
$Command = $MyInvocation.MyCommand.Name
$Arguments = "-baseRef $baseRef"
Write-Log -m "Command: $Command $Arguments"

if ([string]::IsNullOrEmpty($baseRef)) {
    Write-Log -m "ブランチ名がありません。'loop-builder.ps1 -baseRef refactor/login' という形式で実行してください。" -t "ERROR"
    exit 1
}

Push-Location $ProjectRoot

try {
    # 排他制御用にロックファイル作成
    $lockFile = "loop-builder.lock"
    $lockResult = Lock -f $lockFile -i 1

    if (-not $lockResult) {
        Write-Log -m "loop-builder is already running. Skip." -t "ERROR"
        exit 1
    }

    # ブランチ切り替え
    $currentBranch = Get-CurrentBranch -i 1

    & $CreateBranch -b $baseRef -c $true -i 1

    # 現在のループの状態をチェック
    $result = Get-LoopStatus -i 1

    if ($result.Status -and $result.Status -ne [LoopStatus]::IDLE) {
        exit $result.ExitCode
    }

    Set-LoopStatus -n LOOP_BUILDING -i 1

    # タスクを取得
    $taskId = & $GetTaskId -t "memory-bank\kanban\tasks.md" -i 1

    if ([string]::IsNullOrEmpty($taskId)) {
        Write-Log -m "実行できるタスクがありません。" -i $IndentLevel
        exit 0
    }

    # status.json ファイル作成
    Set-Status -p "baseRef" -v $baseRef -i 1
    Set-Status -p "currentTask" -v $taskId -i 1

    # plan.md ファイル作成
    & $CreatePlan -t $taskId -i 1

    # work.md ファイル作成
    & $CreateWork -t $taskId -i 1

    # review.md ファイル作成
    & $CreateReview -t $taskId -i 1

    # Worker タスク作成
    $WorkerTaskId = New-KanbanTask `
        -title "Worker Task" `
        -prompt ".clinerules\AGENTS.md を読む。/workflow worker を実行する。" `
        -baseref $baseRef `
        -autoreview $true `
        -i 1

    # Update-KanbanTask -t $WorkerTaskId -i 1 --cline-model "qwen3.6:27b"

    Set-Status -p "workerTaskId" -v $WorkerTaskId -i 1

    # reviewer タスク作成
    $ReviewerTaskId = New-KanbanTask `
        -title "Reviewer Task" `
        -prompt ".clinerules\AGENTS.md を読む。/workflow reviewer を実行する。" `
        -baseref $baseRef `
        -autoreview $true `
        -i 1

    Set-Status -p "reviewerTaskId" -v $ReviewerTaskId -i 1
    
    # リンクを作成
    New-KanbanLinkJson `
        -SourceTaskId $WorkerTaskId `
        -TargetTaskId $ReviewerTaskId `
        -i 1

    Set-LoopStatus LOOP_STARTING -i 1

    # 変更をコミット
    Invoke-Commit -m "chore: update status.json" -i 1

    # タスクステータス更新
    Set-TaskStatus -t $taskId -s "PROCESSING" -i 1

    # 現在のブランチをデタッチ
    & $Detach -i 1

    # ブランチ復元
    Switch-Branch $currentBranch -i 1

    Start-Sleep -Seconds 1
    
    # タスク実行
    $StartText = & $StartKanbanTask -t $WorkerTaskId -i 1
    
    Write-Output $StartText

    Write-Log -m "LOOP_BUILDER_DONE"

    exit 0
}
catch {
    Write-Log -m $_.Exception.Message -i 1 -t "ERROR"
    exit 1
}
finally {
    & $PopStash -i 1
    # ロック解除
    UnLock -f $lockFile -i 1
    Write-Footer
    Pop-Location
}

# Worker ワークフロー

**重要** 各手順に従い順番に実行してください。

あなたは Worker Agent です。

以下のルールを必ず読んでください。

- `./.clinerules/kanban/00-common.md`
- `./.clinerules/kanban/20-worker.md`

## 実行手順

### 1. 前準備

- `.\.kanban\scripts\kanban\task\initialize-task.ps1` スクリプトを実行してください。

実行例:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\task\initialize-task.ps1 WORKER
```
- `INITIALIZE_TASK_DONE` が出力されるまで次に進まないこと。


### 2. コード修正

**重要** ファイルの読み込みは `/read-file <relative_filepath>` を優先的に使用する。
**重要** ファイルの修正は `/replace-file <relative_filepath> <old_string> <new_string>` を優先的に使用する。
**重要** スクリプトコマンドの実行が失敗したら代替手段を試みる。

以下のファイルを読み込んでコード修正を行ってください。

- `./memory-bank/kanban/plan.md`
- `./memory-bank/kanban/work.md`

コード修正は説明だけで終わらせず、必ず実ファイルを変更してください。

### 3. 修正チェック

コードが修正できたら以下のスクリプトで必ずチェックしてください。

- `./.kanban/scripts/kanban/task/worker-check.ps1`

実行例:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\task\worker-check.ps1
```

- `WORKER_COMPLETED` が出力されなかったり、エラーが発生した場合は再度「1. コード修正」を行ってください。

### 4. 変更をコミット

コード修正が完了したら、以下のスクリプトを実行して変更を正しいブランチにコミットしてください。

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\task\auto-commit.ps1
```

- `AUTO_COMMIT_DONE` が出力されるまで次に進まないこと。
- このスクリプトはデタッチされた worktree の変更を正しいブランチにコミットします。
- コミット後は再度 `read-worktree-file.ps1` 経由でファイルを読み込む必要はありません。コード修正は完了しています。


### 5. 終了処理

- WORKER_COMPLETED が出力されたら、以下のスクリプトを実行します。
- `.\.kanban\scripts\kanban\task\finalize-task.ps1 WORKER` を実行する。

実行例:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\task\finalize-task.ps1 WORKER
```
- FINALIZE_TASK_DONE が出力されたらタスクを `done` レーンに移動します。

# Reviewer ワークフロー

あなたは Reviewer Agent です。

以下のルールを必ず読んでください。

- `./.clinerules\kanban\00-common.md`
- `./.clinerules\kanban\30-reviewer.md`

**重要** 手順に従いすべて自動的に実行してください。

## 1. 前準備

- `.\.kanban\scripts\kanban\task\initialize-task.ps1` スクリプトを実行してください。

実行例:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\task\initialize-task.ps1 REVIEWER
```
- `INITIALIZE_TASK_DONE` が出力されるまで次に進まないこと。


## 2. レビューの実施

### レビュー前処理

以下のファイルを必ず読むこと。

1. `memory-bank\kanban\plan.md`
2. `memory-bank\kanban\review.md`
3. `memory-bank\kanban\worker-result.md`

### 差分確認

以下の方法で変更内容を確認すること。

```powershell
git diff HEAD~1 HEAD
```

または

```powershell
git show --stat
```

実際に変更されたファイルを確認すること。

### レビュー手順

#### 1. Plan確認

plan.md の内容を確認する。

以下を確認すること。

* 実装内容が plan.md と一致しているか
* 完了条件を満たしているか
* 禁止事項に違反していないか

#### 2. WorkerResult確認

worker-result.md の内容を確認する。

以下を確認すること。

* ChangedFiles が実際の変更内容と一致しているか
* ImplementationSummary が差分と一致しているか
* ValidationResults が妥当か
* KnownIssues が適切に記録されているか

#### 3. ReviewCheckList確認

review.md の内容を確認する。

ReviewCheckList を満たしているか確認すること。

#### 4. 差分レビュー

実際の変更差分を確認する。

以下を確認すること。

* 不要な変更が含まれていないか
* 関係ないファイルを変更していないか
* plan.md の範囲を超えた変更がないか
* syntax error の原因となる変更がないか

### NG の場合

以下を実施すること。

1. 問題内容を整理する。
2. review.md にレビュー結果を追記する。
3. tasks.md の現在タスクを FAILED に変更する。

実行形式:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\status\update-task-status.ps1 FAILED
```

最後に以下を出力すること。

```text
REVIEW_REJECTED
```

### OK の場合

以下を実施すること。

1. review.md にレビュー結果を追記する。
2. `memory-bank\kanban\worker-result.md` の `ChangedFiles` に記載されている PHP ファイルを確認する。

例:
```md
### ChangedFiles (変更したファイル)

- app/src/adapter/Controllers/UserController.php
```
3. ChangedFiles に記載されている各 PHP ファイルに対して format-code.ps1 を実行する。
実行形式:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\lint\format-code.ps1 <対象ファイル>
```

例:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\lint\format-code.ps1 app\src\adapter\Controllers\UserController.php
```
4. format-code.ps1 の実行後、同じファイルに対して php-lint.ps1 を実行する。
実行形式:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\lint\php-lint.ps1 <対象ファイル>
```

例:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\lint\php-lint.ps1 app\src\adapter\Controllers\UserController.php
```
5. format-code.ps1 または php-lint.ps1 が失敗した場合は、DONE にしてはいけない。
問題内容を review.md に追記し、現在タスクを FAILED に変更する。

実行形式:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\status\update-task-status.ps1 FAILED
```
6. すべての確認が成功した場合のみ、tasks.md の現在タスクを DONE に変更する。
実行形式:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\status\update-task-status.ps1 DONE
```

最後に以下を出力すること。

```text
REVIEW_APPROVED
```

### レビュー結果記録

review.md に以下を追記すること。

#### ReviewResult

* Approved または Rejected
* 確認した差分
* 指摘事項
* 修正が必要な内容
* Reviewer コメント

既存の review.md の内容を削除してはいけない。
追記のみ行うこと。


## 3. 終了処理

- REVIEW_APPROVED が出力されたら、以下のスクリプトを実行して終了します。

- `.\.kanban\scripts\kanban\task\finalize-task.ps1 WORKER` を実行する。

実行例:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\.kanban\scripts\kanban\task\finalize-task.ps1 REVIEWER
```

- FINALIZE_TASK_DONE が出力されたらタスクを `done` レーンに移動します。

.kanban/
├── locks/                               # ロックファイル格納ディレクトリ（並列実行防止用）
├── logs/
│  ├── invoke-git.log                    # git 操作の実行ログ
│  ├── kanban-task.log                   # Kanban タスク操作のログ
│  ├── kanban.log                        # Kanban フレームワーク全体の実行ログ
│  └── kanban.py.log                     # Kanban フレームワークの実行ログ (Python)
├── python/
│  ├── __init__.py                       # Python パッケージ定義ファイル
│  ├── append-file.py                    # ファイル末尾に文字列を追加するユーティリティ
│  ├── logger.py                         # ロギング機能を提供するモジュール
│  ├── replace_text.py                   # ファイル内の文字列を置換するユーティリティ（/replace-file 用）
│  ├── stdin_replace_text.py             # stdin から入力を受け取る文字列置換ユーティリティ
│  └── test-data/                        # Python スクリプトのテストデータ格納ディレクトリ
├── scripts/
│  ├── loop-builder.ps1                  # Kanban ループを構築するエントリースクリプト（/start コマンド用）
│  ├── start-kanban.ps1                  # Kanban ワークフローを開始するスクリプト
│  ├── common/                           # 共通モジュール
│  │  ├── encode-utf8.ps1                # UTF-8 エンコード変換ユーティリティ
│  │  ├── git.psm1                       # git 操作の共通関数ライブラリ
│  │  ├── invoke-git.psm1                # git コマンド実行ラッパーモジュール
│  │  ├── invoke-task.psm1               # タスク実行 Invoke モジュール
│  │  ├── json.psm1                      # JSON 解析・操作ユーティリティモジュール
│  │  ├── lock.psm1                      # ファイルロック機構モジュール
│  │  ├── logger.psm1                    # ロガー共通モジュール
│  │  └── task.psm1                      # タスク管理共通モジュール
│  ├── kanban/                           # Kanban 関連スクリプト
│  │  ├── git/                           # git 操作系スクリプト
│  │  │  ├── commit-all.ps1              # 変更ファイルをすべてコミットする（/commit コマンド用）
│  │  │  ├── create-branch.ps1           # ブランチを作成する
│  │  │  ├── detach.ps1                  # worktree の detached 状態を操作する
│  │  │  ├── has-changed.ps1             # ファイルが変更されているか確認する
│  │  │  ├── is-branch-exist.ps1         # ブランチの存在確認
│  │  │  ├── merge-to-branch.ps1         # 指定ブランチにマージする
│  │  │  ├── pop-stash.ps1               # stash を適用する
│  │  │  ├── stash.ps1                   # 変更を stash する
│  │  │  └── switch-current-branch.ps1   # 現在のブランチを切り替える
│  │  ├── lint/                          # リント・フォーマット系スクリプト
│  │  │  ├── format-code.ps1             # コードフォーマット実行スクリプト
│  │  │  └── php-lint.ps1                # PHP リントチェック実行スクリプト
│  │  ├── status/                        # タスクステータス管理系スクリプト
│  │  │  ├── status-manager.psm1         # ステータス管理モジュール
│  │  │  └── update-task-status.ps1      # タスクステータスを更新する
│  │  ├── task/                          # Kanban タスク操作系スクリプト
│  │  │  ├── auto-commit.ps1             # 自動コミット処理
│  │  │  ├── create-plan.ps1             # プランテンプレートを生成する
│  │  │  ├── create-review.ps1           # レビューテンプレートを生成する
│  │  │  ├── create-work.ps1             # ワークテンプレートを生成する
│  │  │  ├── finalize-task.ps1           # タスクを最終確定する
│  │  │  ├── get-task-id.ps1             # 現在のタスク ID を取得する
│  │  │  ├── initialize-task.ps1         # タスクを初期化する
│  │  │  ├── kanban-task.ps1             # Kanban CLI の PowerShell ラッパー（/read-file, /replace-file 等他のコマンドが経由）
│  │  │  ├── reviewer-check.ps1          # Reviewer のチェック用スクリプト
│  │  │  ├── start-kanban-task.ps1       # Kanban タスクの開始処理
│  │  │  ├── worker-check.ps1            # Worker のチェック用スクリプト（/workflow worker 用）
│  │  │  └── worker-workflow.ps1         # Worker ワークフロー実行スクリプト
│  │  └── util/                          # ユーティリティ系スクリプト
│  │     ├── read-worktree-file.ps1      # worktree のファイルを読み取る（/read-file コマンド用）
│  │     └── write-worktree-file.ps1     # worktree のファイルに書き込む
│  └── tests/                            # テスト系スクリプト
│     ├── coverage-tests.ps1             # カバレッジテスト実行スクリプト
│     ├── tests.ps1                      # テストスイート実行スクリプト
│     └── kanban/                        # Kanban 関連テスト用サブディレクトリ
│        └── status/                     # ステータス関連テスト用ディレクトリ
│           └── status-manager.tests.ps1 # ステータス関連テストファイル
└── templates/                           # テンプレートファイル格納ディレクトリ
   ├── plan-template.md                  # プランドキュメントのテンプレート
   ├── review-template.md                # レビュードキュメントのテンプレート
   ├── work-template.md                  # ワークドキュメントのテンプレート
   └── worker-result-template.md         # Worker 結果ドキュメントのテンプレート

import argparse
import subprocess
import sys
from pathlib import Path

from logger import write_header, write_footer, write_command_log, write_log


def get_worktree_root() -> Path:
    result = subprocess.run(
        ["git", "rev-parse", "--show-toplevel"],
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE,
        text=True,
        encoding="utf-8",
        errors="replace",
    )
    if result.returncode != 0:
        raise RuntimeError("Git worktree が見つかりません。")
    return Path(result.stdout.strip()).resolve()


def normalize_relative_path(file_path: str) -> Path:
    path = Path(file_path.replace("\\", "/").lstrip("./"))
    if path.is_absolute():
        raise ValueError("絶対パスは使用できません。")
    if ".." in path.parts:
        raise ValueError(".. を含むパスは使用できません。")
    return path


def read_file(path: Path) -> tuple[str, str]:
    raw = path.read_bytes()
    if raw.startswith(b"\xef\xbb\xbf"):
        return raw.decode("utf-8-sig"), "utf-8-sig"
    try:
        return raw.decode("utf-8"), "utf-8"
    except UnicodeDecodeError:
        return raw.decode("cp932"), "cp932"


def write_file(path: Path, content: str, encoding: str) -> None:
    path.write_text(content, encoding=encoding, newline="")


def to_lf(text: str) -> str:
    return text.replace("\r\n", "\n").replace("\r", "\n")


def to_crlf(text: str) -> str:
    return to_lf(text).replace("\n", "\r\n")


def main() -> int:
    parser = argparse.ArgumentParser()
    parser.add_argument("--file", required=True, help="置換対象ファイル")
    parser.add_argument("--old", required=True, help="置換前文字列")
    parser.add_argument("--new", required=True, help="置換後文字列")
    parser.add_argument("--count", type=int, default=-1, help="置換回数（既定: 全置換）")
    parser.add_argument("--allow-no-change", action="store_true", default=True)
    args = parser.parse_args()

    write_header()
    write_command_log()

    try:
        target = (get_worktree_root() / normalize_relative_path(args.file)).resolve()

        if not str(target).startswith(str(get_worktree_root())):
            raise ValueError("worktree 外のファイルは変更できません。")
        if not target.exists():
            raise FileNotFoundError(f"ファイルが見つかりません: {target}")

        content, encoding = read_file(target)
        content_lf, old_lf, new_lf = to_lf(content), to_lf(args.old), to_lf(args.new)

        count = content_lf.count(old_lf)
        if count == 0:
            msg = f"REPLACE_TEXT_NOT_FOUND: {args.old}"
            print(msg)
            write_log(msg)
            if not args.allow_no_change:
                raise RuntimeError(msg)
            print("REPLACE_TEXT_DONE")
            write_log("REPLACE_TEXT_DONE")
            return 0

        new_lf = content_lf.replace(old_lf, new_lf, args.count if args.count > 0 else count)
        write_file(target, to_crlf(new_lf), encoding)

        print(f"REPLACE_TEXT_DONE: {args.file}")
        print(f"REPLACE_COUNT: {count}")
        write_log(f"REPLACE_TEXT_DONE: {args.file}")
        write_log(f"REPLACE_COUNT: {count}")
        return 0

    except Exception as e:
        msg = f"ERROR: {e}"
        print(msg, file=sys.stderr)
        write_log(msg, log_type="ERROR")
        return 1

    finally:
        write_footer()


if __name__ == "__main__":
    sys.exit(main())

$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
$ProjectRoot = Resolve-Path (Join-Path $ScriptDir "..\..\..")

Import-Module (Join-Path $PSScriptRoot "..\common\logger.psm1")

function Lock {
    param(
        [string]$filePath,
        [int]$IndentLevel = 0
    )

    Push-Location $ProjectRoot

    Write-Header -i $IndentLevel
    $Command = $MyInvocation.MyCommand.Name
    $Arguments = "-filePath $filePath"
    Write-Log -m "Command: $Command $Arguments" -i $IndentLevel

    if ([string]::IsNullOrEmpty($filePath)) {
        Write-Log -m "Filename is required." -i $IndentLevel -t "ERROR"
        return $false
    }

    try {
        $LockDir = Join-Path $ProjectRoot ".kanban\locks"
        $LockPath = Join-Path $LockDir $filePath

        # ロックファイルを作成して排他制御します
        if (-not (Test-Path $LockDir)) {
            New-Item -ItemType Directory -Path $LockDir -Force | Out-Null
        }

        New-Item -Path $LockPath -ItemType File -ErrorAction Stop

        return $true
    }
    catch {
        Write-Log -m "File '$filePath' is already locked." -i $IndentLevel -t "ERROR"
        return $false
    }
    finally {
        Write-Footer -i $IndentLevel
        Pop-Location
    }
}

function UnLock {
    param(
        [string]$filePath,
        [int]$IndentLevel = 0
    )

    Push-Location $ProjectRoot

    Write-Header -i $IndentLevel
    $Command = $MyInvocation.MyCommand.Name
    $Arguments = "-filePath $filePath"
    Write-Log -m "Command: $Command $Arguments" -i $IndentLevel

    if ([string]::IsNullOrEmpty($filePath)) {
        Write-Log -m "Filename is required." -i $IndentLevel -t "ERROR"
        return $false
    }

    try {
        $LockDir = Join-Path $ProjectRoot ".kanban\locks"
        $LockPath = Join-Path $LockDir $filePath

        if (Test-Path $LockPath) {
            Remove-Item $LockPath -Force
            Write-Log -m "Unlock '$filePath'" -i $IndentLevel
        }
        else {
            Write-Log -m "'$filePath' not found." -i $IndentLevel
        }
        return $true
    }
    catch {
        Write-Log -m $_.Exception.Message -i $IndentLevel -t "ERROR"
        return $false
    }
    finally {
        Write-Footer -i $IndentLevel
        Pop-Location
    }
}

Export-ModuleMember -Function Lock, UnLock

# Tests for status-manager.psm1
using module ..\..\..\kanban\status\status-manager.psm1

Describe 'Get-LoopStatus' {
    BeforeEach {
        Mock Write-Log {} -ModuleName status-manager
        Mock Write-Header {} -ModuleName status-manager
        Mock Write-Footer {} -ModuleName status-manager
    }

    Context 'Valid loopStatus' {
        BeforeEach {
            Mock Get-Property { 'IDLE' } -ModuleName status-manager
        }
        It 'returns Success=true, Status=IDLE, ExitCode=0' {
            $result = Get-LoopStatus
            $result.Success | Should -BeTrue
            $result.Status | Should -Be ([LoopStatus]::IDLE)
            $result.ExitCode | Should -Be 0
        }
    }

    Context 'Invalid loopStatus' {
        BeforeEach {
            Mock Get-Property { 'UNKNOWN' } -ModuleName status-manager
        }
        It 'returns Success=false, Status=$null, ExitCode=1' {
            $result = Get-LoopStatus
            $result.Success | Should -BeFalse
            $result.Status | Should -Be $null
            $result.ExitCode | Should -Be 1
        }
    }

    Context 'Missing loopStatus' {
        BeforeEach {
            Mock Get-Property { '' } -ModuleName status-manager
        }
        It 'returns Success=false, ExitCode=1' {
            $result = Get-LoopStatus
            $result.Success | Should -BeFalse
            $result.ExitCode | Should -Be 0
        }
    }

    Context 'Throw exception' {
        BeforeEach {
            Mock Get-Property { Throw "exception" } -ModuleName status-manager
        }
        It 'returns Success=false, ExitCode=1' {
            $result = Get-LoopStatus
            $result.Success | Should -BeFalse
            $result.ExitCode | Should -Be 1
        }
    }
}

Describe 'Set-LoopStatus' {
    BeforeEach {
        Mock Write-Log {} -ModuleName status-manager
        Mock Write-Header {} -ModuleName status-manager
        Mock Write-Footer {} -ModuleName status-manager
    }

    Context 'Basic functionality' {
        It 'returns true when Set-Property succeeds' {
            Mock Set-Property { return $true } -ModuleName status-manager
            $result = Set-LoopStatus -newStatus ([LoopStatus]::IDLE)
            $result | Should -BeTrue
        }
    }
}

Describe 'Get-Status' {
    BeforeEach {
        Mock Write-Log {} -ModuleName status-manager
        Mock Write-Header {} -ModuleName status-manager
        Mock Write-Footer {} -ModuleName status-manager
    }

    Context 'Valid property' {
        It 'returns mocked value' {
            Mock Get-Property { return 'value' } -ModuleName status-manager
            $result = Get-Status -property 'TestProp'
            $result | Should -Be 'value'
        }
    }
}

Describe 'Set-Status' {
    BeforeEach {
        Mock Write-Log {} -ModuleName status-manager
        Mock Write-Header {} -ModuleName status-manager
        Mock Write-Footer {} -ModuleName status-manager
    }

    Context 'Sets property' {
        It 'calls Set-Property with correct args' {
            $prop = 'TestProp'
            $value = 'new value'
            Mock Set-Property { } -ModuleName status-manager
            Set-Status -property $prop -value $value
        }
    }
}

Describe 'Invoke-Commit' {
    BeforeEach {
        Mock Write-Log {} -ModuleName status-manager
        Mock Write-Header {} -ModuleName status-manager
        Mock Write-Footer {} -ModuleName status-manager
    }

    Context 'Commits message' {
        It 'calls Commit with provided message' {
            $msg = "Test commit"
            Mock Commit { } -ModuleName status-manager
            Invoke-Commit -m $msg
        }
    }
}