actualize

ナレッジベースの最新化

このコマンドは、変化し続ける保証ケースを維持するための中核となる機能です。FPF ナレッジベース（.fpf/）を、プロジェクトのコードベースの変化する実態と同期させます。

このコマンドは、最近の git の変更を対象に3つの監査を行い、コンテキストのずれ、古くなったエビデンス、時代遅れの意思決定の可能性を明らかにします。これは、FPF 正規進化ループ（B.4）の観察フェーズに沿ったものであり、認識論的負債（B.3.4）の管理に役立ちます。

アクション（実行時）

ステップ 1：Git の変更を確認する

最後の最新化以降の変更を特定する git コマンドを実行します。

# Get current commit hash
git rev-parse HEAD

# Check for changes since last known baseline
# (Read .fpf/.baseline file if it exists, otherwise use initial commit)
git diff --name-only <baseline_commit> HEAD

# List all changed files
git diff --stat <baseline_commit> HEAD

ステップ 2：レポートを分析してコンテキストのずれを確認する

1. 変更されたファイルのうち、プロジェクトの中核となる設定を確認します。

   • package.json、go.mod、Cargo.toml、requirements.txt
   • Dockerfile、docker-compose.yml
   • .env.example、設定ファイル

2. 設定ファイルが変更されている場合：

   • プロジェクト構成（README、設定ファイル）を再確認します
   • 検出されたコンテキストと .fpf/context.md を比較します
   • 差分をユーザーに提示します

3. context.md を更新するかどうか、ユーザーに尋ねます

ステップ 3：レポートを分析してエビデンスの陳腐化（認識論的負債）を確認する

1. .fpf/evidence/ 内のすべてのエビデンスファイルを読み込みます
2. 各エビデンスファイルの carrier_ref フィールドを確認します
3. git diff で変更されたファイルと相互参照します
4. 参照先のファイルが変更されている場合：
   • エビデンスに 陳腐化 のフラグを付けます
   • 影響を受ける仮説を記録します

ステップ 4：レポートを分析して意思決定との関連性を確認する

1. .fpf/decisions/ 内のすべての DRR ファイルを読み込みます
2. 元となるエビデンスファイルと仮説ファイルまで遡って確認します
3. 基盤となるファイルが変更されている場合：
   • DRR に 古くなっている可能性あり のフラグを付けます

ステップ 5：ベースラインを更新する

.fpf/.baseline ファイルを作成または更新します。

# FPF Actualization Baseline
# Last actualized: 2025-01-15T16:00:00Z
commit: abc123def456

ステップ 6：調査結果を提示する

構造化されたレポートを出力します。

## Actualization Report

**Baseline**: abc123 (2025-01-10)
**Current**: def456 (2025-01-15)
**Files Changed**: 42

### Context Drift

The following configuration files have changed:
- package.json (+5 dependencies)
- Dockerfile (base image updated)

**Action Required**: Review and update `.fpf/context.md` if constraints have changed.

### Stale Evidence (3 items)

| Evidence | Hypothesis | Changed File |
|----------|------------|--------------|
| ev-benchmark-api | api-optimization | src/api/handler.ts |
| ev-test-auth | auth-module | src/auth/login.ts |
| ev-perf-db | db-indexing | migrations/002.sql |

**Action Required**: Re-validate to refresh evidence for affected hypotheses.

### Decisions to Review (1 item)

| DRR | Affected By |
|-----|-------------|
| DRR-2025-01-10-api-design | src/api/handler.ts changed |

**Action Required**: Consider re-evaluating decision via `/fpf:propose-hypotheses`.

### Summary

- Context drift detected: YES
- Stale evidence: 3 items
- Decisions to review: 1 item

Run `/fpf:decay` for detailed freshness management.

ファイル：.fpf/.baseline

最後に最新化した時点を記録します。

# FPF Actualization Baseline
last_actualized: 2025-01-15T16:00:00Z
commit: abc123def456789
branch: main

実行するタイミング

• 新しい作業を始める前：ナレッジベースが最新であることを確認します
• 大きな変更の後：エビデンスをコードの変更と同期させます
• 毎週のメンテナンス：定期的な整理の一環として実行します
• 意思決定の前：エビデンスが引き続き有効であることを確認します