phasegate 0.44.0 → 0.63.0

package/templates/.codex/hooks.json

@@ -0,0 +1,63 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx phasegate hook session-start",
+            "statusMessage": "phasegate: loading session context"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx phasegate hook user-prompt-submit",
+            "statusMessage": "phasegate: refreshing status"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx phasegate hook pre-tool-use",
+            "statusMessage": "phasegate: pre-tool-use check"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx phasegate hook post-tool-use",
+            "statusMessage": "phasegate: post-tool-use lint"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx phasegate hook stop",
+            "statusMessage": "phasegate: completion check",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/logical_design.template.md

@@ -0,0 +1,79 @@
+---
+traceability:
+  initial_creation: true
+---
+
+# 論理設計: <Unit名>
+
+> **対応ストーリー**: <HXX-XX, HYY-YY>
+> **作成日**: <YYYY-MM-DD>
+> **Unit**: <UNIT_NAME>
+
+---
+
+## 概要
+
+<このUnitが解決するビジネス課題を 2〜3 行で記述>
+
+---
+
+## ドメインモデル
+
+@story-id <HXX-XX>
+### <集約 / エンティティ / 値オブジェクト名>
+
+<不変条件・責務・関連の説明>
+
+---
+
+## ユースケース
+
+@story-id <HXX-XX>
+### UC-001: <ユースケース名>
+
+**As a** <役割>
+**I want to** <達成したいこと>
+**So that** <得られる価値>
+
+#### 事前条件
+- <前提>
+
+#### 基本フロー
+1. <ステップ>
+
+#### 例外フロー
+- <エラーケース>
+
+---
+
+## 層構成（Clean Architecture）
+
+```
+domain/          : Entity / ValueObject / Port / Domain Service
+application/     : UseCase / DTO
+infrastructure/  : Gateway / Adapter
+presentation/    : CLI Handler / Controller
+```
+
+---
+
+## トレーサビリティメタデータの使い方
+
+このテンプレートが emit する 2 種類のメタデータ:
+
+### 1. YAML frontmatter (`initial_creation: true`)
+- 文書の**新規作成時のみ**付与する
+- `@story-id` インライン注釈が必須であることを示すフラグ
+- 2 回目以降の改訂では frontmatter を削除（または `false` に変更）して構わない
+
+### 2. `@story-id` インライン注釈
+- ユーザーストーリーに紐づく設計要素の**直前に独立行で記述**
+- 形式: `@story-id HXX-XX`
+- ルール:
+  - 独立行（他のテキストと混在させない）
+  - 直後に設計要素（空行を挟まない）
+  - `HXX-XX` は `docs/product/user_stories.md` に存在する ID
+  - 複数ストーリー時は連続並列で並べ、最後の直後に設計要素
+
+これらは `MetadataValidator.validateDesignDocument` で検証され、
+ISSUE-008 Phase B-2 / B-3 以降は `npx phasegate validate-metadata` / pre-commit で自動チェックされる。

package/templates/source.template.ts

@@ -0,0 +1,18 @@
+// @unit <UNIT_NAME>
+// @layer <LAYER>
+
+/**
+ * phasegate ソースファイルテンプレート
+ *
+ * 使い方:
+ *   1. `<UNIT_NAME>` を `docs/product/construction/` 配下の Unit ID に置換
+ *      （例: traceability-model, harness-api）
+ *   2. `<LAYER>` を以下のいずれかに置換
+ *      - domain         : Entity / ValueObject / Port / Domain Service
+ *      - application    : UseCase / DTO / Application Service
+ *      - infrastructure : Gateway / Adapter（外部 I/O 接続）
+ *      - presentation   : CLI Handler / Controller / Formatter
+ *   3. 配置ディレクトリと `@layer` 値を一致させる（L1-004 ルール）
+ *
+ * このメタデータは L1 Biome ルール（L1-001 / L1-002）で検証される。
+ */

package/templates/test.template.ts

@@ -0,0 +1,37 @@
+// @unit <UNIT_NAME>
+// @layer test
+// @story <STORY_ID>
+
+/**
+ * phasegate テストファイルテンプレート
+ *
+ * 使い方:
+ *   1. `<UNIT_NAME>` を被テスト実装と同じ Unit ID に置換
+ *   2. `<STORY_ID>` を本テストがカバーする User Story ID に置換
+ *      （例: H03-02。複数カバーする場合は `H03-01, H03-02` のようにカンマ区切り）
+ *   3. `<TestSubject>` を対象のクラス / 関数名に置換
+ *   4. `target` / `context` は project の test-helpers から import される describe エイリアス
+ *
+ * このメタデータは `MetadataValidator.validateTest` で検証される:
+ *   - `@story` が存在すること
+ *   - `HXX-XX` 形式であること
+ *   - `docs/product/user_stories.md`（StoryCatalog）に存在する ID であること
+ *
+ * pre-commit 経路で自動チェックされる（ISSUE-008 Phase C-3）。
+ */
+
+import { describe, expect, it } from 'vitest';
+import { target, context } from '../helpers/test-helpers.js';
+
+target('<TestSubject>', () => {
+  context('<前提条件・シナリオ>', () => {
+    it('<期待される挙動を日本語で記述>', () => {
+      // Arrange
+      const input = 'TODO';
+      // Act
+      const actual = input;
+      // Assert
+      expect(actual).toBe('TODO');
+    });
+  });
+});