phasegate 0.264.0 → 0.283.0

package/CHANGELOG.md

@@ -9,6 +9,44 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- **WI-328 — 実効言語と出所を phasegate:status に表示（GitHub #39 残課題）** — WI-319/320 の言語自動検出の結果がどこにも表示されず、どの validator が有効/SKIP になるか知る術がなかった。`phasegate:status` の JSON に `languages: { effective, source }`（source = `declared` / `detected` / `fallback`）を追加。解決ロジックは validator-system の `resolveProjectLanguages()`（WI-319 の検出テーブル）に一本化して再利用し、validator の有効/SKIP 判定と必ず同じ結果を表示する。ConfigQueryPort への追加は optional メソッドで後方互換。
+
+- **WI-327 — 最小 config（project のみ）で動作可能に** — 手書き `phasegate.config.json` のスキーマが top-level 8 項目を required とし、`{"project": {"name": ..., "preset": ...}}` の最小構成で L1-001 が連発していた。プリセット解決（`PresetResolutionService.deepMerge`）は省略セクションの補完を既に完備していたため、v3 **と v2**（architecture キーなしの最小 config は v2 検証に振られる）の top-level required を `["project"]` に緩和し、型定義を実態に一致させた。**検証は弱めていない**: セクション内の required・型・enum・additionalProperties は不変で、書かれているが不正なキーは従来どおりエラー（spawn E2E で exit 2 を固定）。最小 config の解決結果がプリセット定義と一致することも統合テストで固定。
+
+- **WI-326 — install フラグ状態を manifest に永続化（GitHub #36 残課題）** — `--with-husky` / `--with-ci` / personal の install 時オプションが `.phasegate/manifest.json` に記録されず、後の reconcile が「全 target 対象」を仮定して opt-out したはずの Husky / CI workflow を追加し直す食い違いがあった。manifest に optional `installationFlags` を追加して install（apply）時に実効フラグを記録し、reconcile は明示指定 > manifest 記録 > 従来挙動の優先順で target を構成する。フィールドを持たない旧 manifest は推測せず従来挙動のまま（load / save round-trip のバイト互換もテストで固定）。
+
+- **WI-324 — フレッシュプロジェクトで L3-004 を SKIP に（オンボーディング阻害の解消）** — phasegate 導入直後（story 未作成・requirement-test-matrix 未生成）でも L3-004 が「マトリクス不在」で fail-closed FAIL になり導入体験を阻害していた。「matrix 不在 かつ StoryCatalog（user_stories.md）の story ゼロ」の場合のみ skipWithReason（WI-317 の L3-003 と同表現）で透過 SKIP に変更。**story が 1 件でも存在するのに matrix 不在なら従来どおり fail-closed**（あるべき matrix の消失事故は見逃さない）。story 数の取得に失敗した場合も判定不能として fail-closed 側に倒す。
+
+- **WI-323 — 非ゲート hook の payload フィールド欠落を fail-open 化（GitHub #40 残課題）** — stop hook が stdin payload の `session_id` 欠落で exit 2 になり、WI-314 の「hook は開発フローを止めない」方針と不整合だった。stop（`SESSION_ID_MISSING`）と post-tool-use（`TOOL_NAME_MISSING`）を警告 + hook-skip-event 記録 + exit 0 の fail-open に変更。**pre-tool-use の `tool_name` 欠落 exit 2 は書き込みゲートのため意図的に fail-closed を維持**し、回帰ガードテストで固定。usecase 契約（空 sessionId エラー）は presentation 入口ガード方式で不変。
+
+- **WI-322 — config なし fallback の coverageThreshold 90 を opt-out の 0 に修正（GitHub #37 残課題）** — WI-317 で「カバレッジゲートはオプトイン、0 = 正規の opt-out」と定義したのに、config なし環境で使われる validator-system の `DEFAULT_CONFIG` fallback が `coverageThreshold: 90` のままで、config を持たない環境だけ勝手に 90% が強制される矛盾を解消。fallback のみの変更でプリセット定義（minimal / standard / strict）は不変。fallback 経由で L3-003 が透過 SKIP になることを回帰テストで固定。
+
+- **WI-321 — complete-check の JSON 出力に warning 詳細を含める（GitHub #38 残課題）** — `phasegate:complete-check` が warning を `summary.warnings` の件数のみで返し、どの validator のどんな warning かが出力に含まれなかった非対称を修正。ci-check case と同じく `CiCheckResult` を data ペイロードとして pass / fail 双方で返す（`data.validatorResults[].validatorId / errors[]`）。validator 結果 0 件時は従来どおり data なし。判定ロジック・exit code・lint 合流は不変。
+
+- **WI-325 — load 経路の JSON パース失敗が "Failed to persist" と誤表示される問題を修正** — `FileSystemConfigRepository.load()` の JSON 構文エラーが書き込み用の `ConfigPersistenceError`（"Failed to persist config"）で送出され、読み込み失敗なのに永続化失敗と誤解させるメッセージになっていた。`ConfigParseError extends ConfigPersistenceError` を新設して load 経路を "Failed to parse config JSON" に分離。サブクラス化により main.ts の `instanceof ConfigPersistenceError` fail-open 判定（WI-314）は無変更で互換維持。save 経路は従来どおり。
+
+- **WI-320 — 言語自動検出を実 CLI 経路で有効化（GitHub #39 フォローアップ）** — WI-319 の検出は adapter に実装されたが、実 CLI では preset 解決（`preset-resolution-service`）・mapper・`ProjectConfig` VO の 3 箇所が未宣言時に `["typescript"]` を注入するため dead code だった（シナリオ検証で発見）。「未宣言」シグナルを resolved config から adapter まで生存させ、純 Python リポジトリで L3-003 が unsupported-language SKIP になることを実 CLI spawn の E2E で固定。宣言時の挙動・検証は不変。
+
+- **WI-319 — project.languages のファイルシステム自動検出（GitHub #39）** — `project.languages` 未宣言時に無条件で `["typescript"]` へフォールバックし、純 Python プロジェクトでも TS 専用 validator（L3-002 / L3-003 / L4-003）が既定で走っていた問題を修正。マーカーファイル（python: pyproject.toml 等 / go.mod / Cargo.toml / pom.xml / Gemfile / composer.json、typescript: tsconfig.json または package.json の typescript 依存のみ — phasegate 導入時の package.json を誤検出しないため存在自体は根拠にしない）から検出し、config 宣言は引き続き最優先、検出ゼロ時は従来どおり typescript フォールバック。
+
+- **WI-318 — complete-check に severity-aware 集約を適用（GitHub #38）** — `phasegate:complete-check` が validator の生の `passed` だけを見ており、warning-only failure でも exit 1 になって `validate` / `ci-check` と乖離していた。Stop hook が叩くのは complete-check のため、L2-016 の `ungated-legacy` マーカー（error→可視 warning 降格）が実質無効化されていた。ci-check と同一の `CiCheckResult.fromResults()`（ADR-017 / WI-260 の `isEffectivelyPassed`）を通す集約に修正し、warning 件数を summary に反映。skipped validator が fail 扱いされる潜在バグも同時に解消。lint fail → exit 1 の合流は不変。
+
+- **WI-317 — coverageThreshold の opt-out を到達可能に（GitHub #37）** — L3-003 実装は「カバレッジゲートはオプトイン」と明記しつつ、opt-out 手段（`null`）がスキーマで拒否され、`0` を設定してもレポート不在で fail-closed FAIL になる矛盾があった。ドメイン VO `L3Config.hasCoverageGate()` の「threshold > 0 でのみ有効」の意図に run-l3 を揃え、`coverageThreshold: 0`（および null）を正規の opt-out として SKIP にした（minimal preset の 0 も本来の opt-out として機能）。レポート不在 FAIL の suggestion に (a) カバレッジ付き実行 (b) `coverageThreshold: 0` での opt-out (c) 非 JS/TS プロジェクトの `project.languages` 宣言、の 3 択を案内する。
+
+- **WI-316 — install の `--with-husky` / `--with-ci` dead flag を修正（GitHub #36）** — install コマンドがこの 2 フラグを一度も読まず、`--personal` なしでは常に `.husky/*` と `.github/workflows/phasegate-aidlc-gate.yml` を書き込んでいた。ヘルプ記載・`init` / `setup:agent` と同じ opt-in（フラグ明示時のみ書き込み）に配線を揃え、CLI 統合テストとドキュメントで固定した。usecase のプログラマティック契約（既定 true）は不変。
+
+- **WI-315 — install / reconcile が CLAUDE.md の user-section を上書きする問題を修正（GitHub #35）** — CLAUDE.md テンプレートは user-section が managed-section の内側にあるため、`install --apply` / `reconcile` の managed block 置換がユーザー自身の記述を placeholder で消失させていた。merge 時に既存 user-section 本文を抽出して新 block に再注入する方式で保持するようにした（AGENTS.md の既存挙動は不変）。併せて、ユーザー本文が `String.replace` の置換文字列として `$` シーケンス解釈される潜在破損を replacer 関数で封じた。
+
+- **WI-314 — 不正 config の hook / doctor 自己修復デッドロック解消（GitHub #40）** — スキーマ違反の `phasegate.config.json` が dispatch 上流の fail-closed で全コマンドを exit 2 にし、pre-tool-use hook 経由で Bash / Write / Edit を全遮断して config 自身の修復も不能になる問題を修正。`hook` / `doctor` は警告 + 既定設定で続行する fail-open とし（診断・自己修復経路の常時確保）、`validate` / `ci-check` 等の検査系は復旧手順の案内付きで fail-closed を維持。hook 内部 adapter の素 `JSON.parse` throw も同様に fail-open 化し、構文破壊 JSON での再デッドロックを塞いだ。gated スコープへの書き込みは phase-gate 判定が引き続き fail-closed でブロックする。
+
+- **WI-313 — typescript peer range を `<7.0.0` に制限（GitHub #34）** — peer 自動インストールで typescript@7 が解決されると classic compiler API（`ts.ScriptTarget` 等）が存在せず全コマンドが `Cannot read properties of undefined (reading 'ESNext')` でクラッシュする問題を修正。TypeScript 7 系を peer range で弾き、packaging contract テストで range を固定した。
+
+- **WI-312 — coverage-producing CI gate** — production workflowとbundled `aidlc-gate`がL3-003実行前に`coverage/coverage-summary.json`を生成せず、clean checkoutでcoverageThresholdに対してfail-closedとなる既存欠陥を修正。self-repoはcoverage付きunit / integrationとcoverage対象外E2Eを各1回だけ実行してplain full suiteの二重実行を避け、threads開始時にもforks blobを保持して両poolをmergeする。templateは採用projectの`coverage` scriptをpackage manager別に必須実行し、test / coverage → matrix → World derive二重一致 → L3 → attestation → integrityの順序を維持する。
+
+- **WI-311 — hermetic CI-facing harness integration tests** — GitHub Actionsのtest-before-matrix順序で、real lint integrationとCLI E2Eがself-repo cwd、coverage、untracked requirement matrixを暗黙のPASS入力としていた既存欠陥を修正。lint adapterへ明示rootを注入してtracked minimal workspaceだけを実scanし、`phasegate:ci-check --json`とlegacy `complete-check`はL3 / Worldを明示無効化したtemp configで公開command契約を検証する。productionのfail-closedとCI gate順序は変更しない。
+
+- **WI-310 — hermetic large-stdout CLI regression** — WI-308の64 KiB超assertionがuntracked requirement matrixとself-repoの604 adopted-legacy warningsへ依存していた欠陥を修正。tracked World-enabled configを使うtemp corpusに160組のduplicate fragment IDを生成し、CIのtest-before-matrix順序でも`validate --layer L2 --format json` / `--json`が決定的に64 KiBを超えて完全parseできる契約へ置換した。
+
 - **WI-309 — WI-305 validator domain reflection repair** — `DesignChangeDeclarationPolicy`を実装・配線しながらvalidator-system `domain_model.md`へのWI-305累積反映を欠落させ、story reflection corpusが検出したbaseline外違反を正規に解消。exact `corpusRole + DeclaredKey`照合、pinned change限定、Work-Item trailer intersection、unique sorted finding、local fast-path / L3 authority境界を実コードどおり記録し、baseline / allowlistには触れていない。
 
 - **WI-308 — CLI large stdout drain** — self-repoのWorld enforcement有効化により`validate --layer L2 --json`が604件のadopted-legacy warningを含む64 KiB超のJSONとなり、`console.log`直後の`process.exit`がpipe bufferをdrainせず末尾を切断する回帰を修正。direct stdout resultを返す全top-level CLI経路を共通graceful exitへ統合し、warningを省略せず任意サイズの完全な出力と既存exit codeを維持する。64 KiB超を必須条件とするprocess E2Eで`--format json` / `--json`双方を固定し、同E2E fileの全subprocess caseへ明示60秒timeoutを適用した。

package/docs/guide/installation.md

@@ -56,7 +56,7 @@ npx phasegate install --apply
 npx phasegate doctor
 ```
 
-`install --dry-run` reports whether each target will be created, merged, skipped, or refused. `install --apply` performs the merge, adds package scripts and the `phasegate` devDependency, deploys selected bundled skills to root `skills/`, creates `.claude/skills` and `.codex/skills` links, writes `CLAUDE.md` / `AGENTS.md` managed sections for selected agent targets, writes `.github/workflows/phasegate-aidlc-gate.yml` when CI is enabled, and records managed entries in `.phasegate/manifest.json`. Existing skills catalogs are merged: PhaseGate refreshes only bundled skill directories selected by `--skills core|all` and preserves user-owned skills. See [Setup Artifacts](setup-artifacts.md) for the full managed target, generated artifact, runtime state, legacy artifact, and user-level setting inventory. <!-- @work-item-id WI-152 --> <!-- @work-item-id WI-169 --> <!-- @work-item-id WI-174 --> <!-- @work-item-id WI-216 -->
+`install --dry-run` reports whether each target will be created, merged, skipped, or refused. `install --apply` performs the merge, adds package scripts and the `phasegate` devDependency, deploys selected bundled skills to root `skills/`, creates `.claude/skills` and `.codex/skills` links, writes `CLAUDE.md` / `AGENTS.md` managed sections for selected agent targets, writes `.github/workflows/phasegate-aidlc-gate.yml` when CI is enabled, and records managed entries in `.phasegate/manifest.json`. Husky hook targets (`.husky/*`) and the GitHub Actions target are opt-in, matching `init` and `setup:agent`: pass `--with-husky` and/or `--with-ci` to include them — without these flags `install` does not touch `.husky/` or `.github/workflows/`. <!-- @work-item-id WI-316 --> Existing skills catalogs are merged: PhaseGate refreshes only bundled skill directories selected by `--skills core|all` and preserves user-owned skills. See [Setup Artifacts](setup-artifacts.md) for the full managed target, generated artifact, runtime state, legacy artifact, and user-level setting inventory. <!-- @work-item-id WI-152 --> <!-- @work-item-id WI-169 --> <!-- @work-item-id WI-174 --> <!-- @work-item-id WI-216 -->
 
 For personal evaluation inside a team-owned repository:
 

package/docs/templates/ci/aidlc-gate.yml

@@ -7,10 +7,11 @@
 # 実行内容:
 #   1. bypass:audit — bypass trailer / evidence 監査
 #   2. phasegate lint  — L1 Biome AST ルール検証
-#   3. requirement-test matrix をcurrent testsから再生成
-#   4. world.enabled=true の場合、world:derive を2回実行してbyte一致を検証
-#   5. phasegate:ci-check — L3 CI バリデータ（security / performance / coverage / nyquist / World）
-#   6. 失敗時: PR にエラーサマリーをコメント
+#   3. package の coverage script を実行し、L3-003 の入力を生成
+#   4. requirement-test matrix をcurrent testsから再生成
+#   5. world.enabled=true の場合、world:derive を2回実行してbyte一致を検証
+#   6. phasegate:ci-check — L3 CI バリデータ（security / performance / coverage / nyquist / World）
+#   7. 失敗時: PR にエラーサマリーをコメント
 
 name: AIDLC Quality Gate
 
@@ -79,6 +80,23 @@ jobs:
           echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT
           exit $EXIT_CODE
 
+      # L3-003 is fail-closed when coverageThreshold is configured but the
+      # report is absent. The adopting project owns this script and must emit
+      # coverage/coverage-summary.json; package-manager selection follows the
+      # lockfile used during dependency installation above.
+      - name: Test and generate coverage
+        shell: bash
+        run: |
+          set -euo pipefail
+          node -e "const scripts=require('./package.json').scripts ?? {}; if (!scripts.coverage) { throw new Error('phasegate aidlc-gate requires package.json scripts.coverage to generate coverage/coverage-summary.json'); }"
+          if [ -f pnpm-lock.yaml ]; then
+            pnpm run coverage
+          elif [ -f yarn.lock ]; then
+            yarn coverage
+          else
+            npm run coverage
+          fi
+
       # L3-004 consumes the generated requirement-test matrix. Always rebuild it
       # from this checkout instead of trusting a stale or persisted artifact.
       - name: Generate requirement-test matrix

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.264.0",
+  "version": "0.283.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",
@@ -78,7 +78,7 @@
     "vitest": "^3.0.0"
   },
   "peerDependencies": {
-    "typescript": ">=5.0.0"
+    "typescript": ">=5.0.0 <7.0.0"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/scripts/harness/agent-integration/infrastructure/adapters/harness-config-config-query-adapter.ts

@@ -6,13 +6,9 @@
  * HarnessConfigV2 の harnesses セクションから Hook 設定を読み取る
  */
 
-import * as fs from 'node:fs';
-import type {
-  BaselineConfig,
-  ConfigQueryPort,
-  HookType,
-} from '../../domain/ports/config-query-port.js';
-import { ProjectPaths } from '../../domain/value-objects/project-paths.js';
+import * as fs from "node:fs";
+import type { BaselineConfig, ConfigQueryPort, HookType } from "../../domain/ports/config-query-port.js";
+import { ProjectPaths } from "../../domain/value-objects/project-paths.js";
 
 interface ProjectDocsSection {
   inception?: string;
@@ -84,8 +80,22 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     if (this.cachedConfig !== null) {
       return this.cachedConfig;
     }
-    const raw = fs.readFileSync(this.configPath, 'utf8');
-    const doc = JSON.parse(raw) as HarnessConfigDocument;
+    // GitHub #40: config が JSON として壊れている場合に hook プロセス全体を throw で
+    // 落とすと、エージェントの全ツール呼び出しが遮断され config の修復自体が不能になる。
+    // main.ts の ConfigPersistenceError と同じ意味論（警告 + 既定値で続行）に揃える。
+    // ファイル不在等の fs エラーは既存契約どおり throw する（上流の catch が defaults を
+    // 適用する）。gated スコープへの書き込みは phase-gate 側が fail-closed でブロックする。
+    const raw = fs.readFileSync(this.configPath, "utf8");
+    let doc: HarnessConfigDocument;
+    try {
+      doc = JSON.parse(raw) as HarnessConfigDocument;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      process.stderr.write(
+        `Warning: phasegate.config.json could not be parsed as JSON (${message}); continuing with default hook settings so self-repair stays possible.\n`,
+      );
+      doc = {};
+    }
     this.cachedConfig = doc;
     return doc;
   }
@@ -98,10 +108,10 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     // pre-tool-use → agentLessonCollection
     // post-tool-use → cascadeUpdate
     // stop → デフォルト有効
-    if (hookType === 'pre-tool-use') {
+    if (hookType === "pre-tool-use") {
       return harnesses.agentLessonCollection ?? true;
     }
-    if (hookType === 'post-tool-use') {
+    if (hookType === "post-tool-use") {
       return harnesses.cascadeUpdate ?? true;
     }
     // stop はデフォルト有効
@@ -111,13 +121,9 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
   async getProtectedFilePatterns(): Promise<string[]> {
     const config = this.loadConfig();
     const configured = config.protectedFiles?.patterns ?? [];
-    const principlesDocs = config.paths?.principlesDocs ?? 'docs/principles';
-    const folderRulesDoc = config.paths?.folderRulesDoc ?? 'docs/folder_management_rules.md';
-    return [
-      ...configured,
-      `${normalizeProjectPath(principlesDocs)}/**`,
-      normalizeProjectPath(folderRulesDoc),
-    ];
+    const principlesDocs = config.paths?.principlesDocs ?? "docs/principles";
+    const folderRulesDoc = config.paths?.folderRulesDoc ?? "docs/folder_management_rules.md";
+    return [...configured, `${normalizeProjectPath(principlesDocs)}/**`, normalizeProjectPath(folderRulesDoc)];
   }
 
   async getProtectedFileExclusions(): Promise<string[]> {
@@ -135,13 +141,10 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     const paths = config.project?.paths;
     const topLevelPaths = config.paths;
 
-    return ProjectPaths.create(
-      paths?.source ?? ['scripts/harness'],
-      {
-        construction: paths?.docs?.construction ?? topLevelPaths?.designDocs ?? 'docs/product/construction',
-        inception: paths?.docs?.inception ?? topLevelPaths?.inceptionDocs ?? 'docs/inception',
-      },
-    );
+    return ProjectPaths.create(paths?.source ?? ["scripts/harness"], {
+      construction: paths?.docs?.construction ?? topLevelPaths?.designDocs ?? "docs/product/construction",
+      inception: paths?.docs?.inception ?? topLevelPaths?.inceptionDocs ?? "docs/inception",
+    });
   }
 
   async getBaselineConfig(): Promise<BaselineConfig> {
@@ -149,7 +152,7 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     const baseline = config.baseline ?? {};
     return {
       enabled: baseline.enabled ?? true,
-      path: baseline.path ?? '.phasegate/baseline.json',
+      path: baseline.path ?? ".phasegate/baseline.json",
     };
   }
 
@@ -162,5 +165,5 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
 }
 
 function normalizeProjectPath(path: string): string {
-  return path.replace(/\\/g, '/').replace(/\/+$/g, '');
+  return path.replace(/\\/g, "/").replace(/\/+$/g, "");
 }

package/scripts/harness/agent-integration/presentation/post-tool-use-hook.ts

@@ -2,18 +2,19 @@
  * @layer presentation
  * @unit agent-integration
  * @work-item-id WI-208
+ * @work-item-id WI-323
  *
  * PostToolUse Hook Adapter
  * Claude Code の PostToolUse Hook エントリポイント
  */
 
-import { HandlePostToolUseUseCase } from '../application/usecases/handle-post-tool-use-usecase.js';
-import { HarnessConfigConfigQueryAdapter } from '../infrastructure/adapters/harness-config-config-query-adapter.js';
-import { HarnessApiCliCommandRegistryAdapter } from '../infrastructure/adapters/harness-api-cli-command-registry-adapter.js';
-import { ChildProcessCliExecutorAdapter } from '../infrastructure/adapters/child-process-cli-executor-adapter.js';
-import { recordHookSkipEvent } from './hook-skip-event-recorder.js';
-import * as path from 'node:path';
-import * as fs from 'node:fs/promises';
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { HandlePostToolUseUseCase } from "../application/usecases/handle-post-tool-use-usecase.js";
+import { ChildProcessCliExecutorAdapter } from "../infrastructure/adapters/child-process-cli-executor-adapter.js";
+import { HarnessApiCliCommandRegistryAdapter } from "../infrastructure/adapters/harness-api-cli-command-registry-adapter.js";
+import { HarnessConfigConfigQueryAdapter } from "../infrastructure/adapters/harness-config-config-query-adapter.js";
+import { recordHookSkipEvent } from "./hook-skip-event-recorder.js";
 
 interface PostToolUseHookInput {
   tool_name?: string;
@@ -25,15 +26,15 @@ async function readStdin(): Promise<string> {
   for await (const chunk of process.stdin) {
     chunks.push(chunk as Buffer);
   }
-  return Buffer.concat(chunks).toString('utf8');
+  return Buffer.concat(chunks).toString("utf8");
 }
 
 async function findConfigPath(): Promise<string> {
   let dir = process.cwd();
   while (true) {
     const candidates = [
-      path.join(dir, 'phasegate.config.json'),
-      path.join(dir, '.phasegate-local', 'phasegate.config.json'),
+      path.join(dir, "phasegate.config.json"),
+      path.join(dir, ".phasegate-local", "phasegate.config.json"),
     ];
     for (const candidate of candidates) {
       try {
@@ -45,12 +46,12 @@ async function findConfigPath(): Promise<string> {
     if (parent === dir) break;
     dir = parent;
   }
-  return path.join(process.cwd(), 'phasegate.config.json');
+  return path.join(process.cwd(), "phasegate.config.json");
 }
 
 function projectRootForConfig(configPath: string): string {
   const configDir = path.dirname(configPath);
-  return path.basename(configDir) === '.phasegate-local' ? path.dirname(configDir) : configDir;
+  return path.basename(configDir) === ".phasegate-local" ? path.dirname(configDir) : configDir;
 }
 
 async function main(): Promise<void> {
@@ -58,7 +59,7 @@ async function main(): Promise<void> {
   try {
     raw = await readStdin();
   } catch {
-    process.stderr.write('stdin読み取りエラー\n');
+    process.stderr.write("stdin読み取りエラー\n");
     process.exit(2);
   }
 
@@ -72,8 +73,20 @@ async function main(): Promise<void> {
 
   const toolName = input.tool_name;
   if (!toolName) {
-    process.stderr.write('tool_nameフィールドが必要です\n');
-    process.exit(2);
+    // WI-323: PostToolUse はツール実行後の lint フィードバックでありゲートではないため、
+    // tool_name 欠落は fail-open でスキップする（WI-314 / github#40 方針）。
+    // ※ pre-tool-use-hook の同ガードは書き込みゲートなので fail-closed (exit 2) を維持する。
+    const configPath = await findConfigPath();
+    await recordHookSkipEvent({
+      projectRoot: projectRootForConfig(configPath),
+      hookType: "post-tool-use",
+      reason: "TOOL_NAME_MISSING",
+      targetPaths: [],
+    });
+    process.stderr.write(
+      "警告: stdin payload に tool_name が無いため post-tool-use hook の処理をスキップしました (fail-open)\n",
+    );
+    process.exit(0);
   }
 
   try {
@@ -93,7 +106,7 @@ async function main(): Promise<void> {
     if (output.skipReason) {
       await recordHookSkipEvent({
         projectRoot: projectRootForConfig(configPath),
-        hookType: 'post-tool-use',
+        hookType: "post-tool-use",
         reason: output.skipReason,
         targetPaths: [],
       });

package/scripts/harness/agent-integration/presentation/stop-hook.ts

@@ -3,19 +3,20 @@
  * @unit agent-integration
  * @work-item-id WI-203
  * @work-item-id WI-208
+ * @work-item-id WI-323
  *
  * Stop Hook Adapter
  * Claude Code の Stop Hook エントリポイント
  */
 
-import { HandleStopUseCase } from '../application/usecases/handle-stop-usecase.js';
-import { EnvFileReentryGuardStateAdapter } from '../infrastructure/adapters/env-file-reentry-guard-state-adapter.js';
-import { HarnessConfigConfigQueryAdapter } from '../infrastructure/adapters/harness-config-config-query-adapter.js';
-import { HarnessApiCliCommandRegistryAdapter } from '../infrastructure/adapters/harness-api-cli-command-registry-adapter.js';
-import { ChildProcessCliExecutorAdapter } from '../infrastructure/adapters/child-process-cli-executor-adapter.js';
-import { recordHookSkipEvent } from './hook-skip-event-recorder.js';
-import * as path from 'node:path';
-import * as fs from 'node:fs/promises';
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { HandleStopUseCase } from "../application/usecases/handle-stop-usecase.js";
+import { ChildProcessCliExecutorAdapter } from "../infrastructure/adapters/child-process-cli-executor-adapter.js";
+import { EnvFileReentryGuardStateAdapter } from "../infrastructure/adapters/env-file-reentry-guard-state-adapter.js";
+import { HarnessApiCliCommandRegistryAdapter } from "../infrastructure/adapters/harness-api-cli-command-registry-adapter.js";
+import { HarnessConfigConfigQueryAdapter } from "../infrastructure/adapters/harness-config-config-query-adapter.js";
+import { recordHookSkipEvent } from "./hook-skip-event-recorder.js";
 
 interface StopHookInput {
   session_id?: string;
@@ -23,8 +24,7 @@ interface StopHookInput {
 
 function isCompleteCheckExecutionWiringFailure(stderr: string): boolean {
   return (
-    /scripts\/harness\/cli\/complete-check\.ts/.test(stderr) ||
-    /ERR_MODULE_NOT_FOUND|Cannot find module/i.test(stderr)
+    /scripts\/harness\/cli\/complete-check\.ts/.test(stderr) || /ERR_MODULE_NOT_FOUND|Cannot find module/i.test(stderr)
   );
 }
 
@@ -40,15 +40,15 @@ async function readStdin(): Promise<string> {
   for await (const chunk of process.stdin) {
     chunks.push(chunk as Buffer);
   }
-  return Buffer.concat(chunks).toString('utf8');
+  return Buffer.concat(chunks).toString("utf8");
 }
 
 async function findConfigPath(): Promise<string> {
   let dir = process.cwd();
   while (true) {
     const candidates = [
-      path.join(dir, 'phasegate.config.json'),
-      path.join(dir, '.phasegate-local', 'phasegate.config.json'),
+      path.join(dir, "phasegate.config.json"),
+      path.join(dir, ".phasegate-local", "phasegate.config.json"),
     ];
     for (const candidate of candidates) {
       try {
@@ -60,12 +60,12 @@ async function findConfigPath(): Promise<string> {
     if (parent === dir) break;
     dir = parent;
   }
-  return path.join(process.cwd(), 'phasegate.config.json');
+  return path.join(process.cwd(), "phasegate.config.json");
 }
 
 function projectRootForConfig(configPath: string): string {
   const configDir = path.dirname(configPath);
-  return path.basename(configDir) === '.phasegate-local' ? path.dirname(configDir) : configDir;
+  return path.basename(configDir) === ".phasegate-local" ? path.dirname(configDir) : configDir;
 }
 
 async function main(): Promise<void> {
@@ -73,7 +73,7 @@ async function main(): Promise<void> {
   try {
     raw = await readStdin();
   } catch {
-    process.stderr.write('stdin読み取りエラー\n');
+    process.stderr.write("stdin読み取りエラー\n");
     process.exit(2);
   }
 
@@ -87,13 +87,24 @@ async function main(): Promise<void> {
 
   const sessionId = input.session_id;
   if (!sessionId) {
-    process.stderr.write('session_idフィールドが必要です\n');
-    process.exit(2);
+    // WI-323: session_id 欠落は呼び出し側環境の不備であり、stop hook はゲートではないため
+    // fail-open でスキップする（WI-314 / github#40 の「hook は開発フローを止めない」方針）。
+    const configPath = await findConfigPath();
+    await recordHookSkipEvent({
+      projectRoot: projectRootForConfig(configPath),
+      hookType: "stop",
+      reason: "SESSION_ID_MISSING",
+      targetPaths: [],
+    });
+    process.stderr.write(
+      "警告: stdin payload に session_id が無いため stop hook の処理をスキップしました (fail-open)\n",
+    );
+    process.exit(0);
   }
 
   try {
     const configPath = await findConfigPath();
-    const reentryGuardStatePort = new EnvFileReentryGuardStateAdapter({ strategy: 'env' });
+    const reentryGuardStatePort = new EnvFileReentryGuardStateAdapter({ strategy: "env" });
     const configQueryPort = new HarnessConfigConfigQueryAdapter(configPath);
     const cliCommandRegistryPort = new HarnessApiCliCommandRegistryAdapter();
     const cliExecutorPort = new ChildProcessCliExecutorAdapter();
@@ -107,14 +118,14 @@ async function main(): Promise<void> {
 
     const output = await useCase.execute({ sessionId });
 
-    if (output.skipReason === 'REENTRY_DETECTED') {
+    if (output.skipReason === "REENTRY_DETECTED") {
       await recordHookSkipEvent({
         projectRoot: projectRootForConfig(configPath),
-        hookType: 'stop',
+        hookType: "stop",
         reason: output.skipReason,
         targetPaths: [],
       });
-      process.stderr.write('ReentryGuard: 再入検出によりスキップ\n');
+      process.stderr.write("ReentryGuard: 再入検出によりスキップ\n");
       process.exit(0);
     }
 
@@ -123,10 +134,8 @@ async function main(): Promise<void> {
         // WI-087 finding #4: enforce=true なら exit 2 + decision JSON で turn block
         if (output.shouldEnforceFailure === true) {
           const reason = formatCompleteCheckFailureReason(output.cliResult.exitCode, output.cliResult.stderr);
-          process.stdout.write(`${JSON.stringify({ decision: 'block', reason })}\n`);
-          process.stderr.write(
-            `${reason} — strict mode により turn を block します\n`,
-          );
+          process.stdout.write(`${JSON.stringify({ decision: "block", reason })}\n`);
+          process.stderr.write(`${reason} — strict mode により turn を block します\n`);
           process.exit(2);
         }
         process.stderr.write(`Complete Check失敗 (exitCode=${output.cliResult.exitCode})\n`);

package/scripts/harness/config-foundation/application/mappers/validator-system-config-mapper.ts

@@ -10,6 +10,7 @@
  * @work-item-id WI-300
  * @work-item-id WI-301
  * @work-item-id WI-302
+ * @work-item-id WI-320
  */
 import type { HarnessConfigV2 } from "../../domain/harness-config.js";
 
@@ -54,7 +55,10 @@ export function toValidatorSystemConfig(resolvedConfig: HarnessConfigV2 | undefi
   return {
     project: {
       preset: resolvedConfig.project.preset,
-      languages: resolvedConfig.project.languages ?? ["typescript"],
+      // WI-320 (github#39): 未宣言時に ["typescript"] を注入せず undefined のまま渡す。
+      // HarnessConfigValidatorConfigAdapter.getProjectLanguages() が未宣言時のみ
+      // ファイルシステム検出（WI-319）にフォールバックできるようにするため。
+      ...(resolvedConfig.project.languages === undefined ? {} : { languages: resolvedConfig.project.languages }),
     },
     paths: {
       designDocs: resolvedConfig.paths.designDocs,

package/scripts/harness/config-foundation/domain/harness-config.ts

@@ -5,6 +5,7 @@
  * @work-item-id WI-212
  * @work-item-id WI-219
  * @work-item-id WI-300
+ * @work-item-id WI-327
  */
 import { ConfigFoundationDomainError } from "./errors/config-foundation-domain-error.js";
 import { ConfigValidationError } from "./errors/config-validation-error.js";
@@ -48,13 +49,15 @@ export interface HarnessConfigSourceDocument {
     preset: PresetId;
     languages?: string[];
   };
-  layers: DeepPartial<HarnessConfigResolvedDocument["layers"]>;
-  quickMode: Partial<HarnessConfigResolvedDocument["quickMode"]>;
-  phaseDependencies: HarnessConfigResolvedDocument["phaseDependencies"];
-  planningMode: HarnessConfigResolvedDocument["planningMode"];
-  harnesses: Partial<HarnessConfigResolvedDocument["harnesses"]>;
-  paths: HarnessConfigResolvedDocument["paths"];
-  reporting: HarnessConfigResolvedDocument["reporting"];
+  // WI-327: project 以外の top-level セクションは手書き config で省略可。
+  // 省略時は PresetResolutionService が防御プリセット（project.preset）のデフォルト値で補完する。
+  layers?: DeepPartial<HarnessConfigResolvedDocument["layers"]>;
+  quickMode?: Partial<HarnessConfigResolvedDocument["quickMode"]>;
+  phaseDependencies?: HarnessConfigResolvedDocument["phaseDependencies"];
+  planningMode?: HarnessConfigResolvedDocument["planningMode"];
+  harnesses?: Partial<HarnessConfigResolvedDocument["harnesses"]>;
+  paths?: HarnessConfigResolvedDocument["paths"];
+  reporting?: HarnessConfigResolvedDocument["reporting"];
   ci?: HarnessConfigResolvedDocument["ci"];
   validate?: HarnessConfigResolvedDocument["validate"];
   preCommit?: Partial<HarnessConfigResolvedDocument["preCommit"]>;

package/scripts/harness/config-foundation/domain/services/preset-resolution-service.ts

@@ -3,6 +3,7 @@
  * @unit config-foundation
  * @work-item-id WI-212
  * @work-item-id WI-300
+ * @work-item-id WI-320
  */
 import { ConfigFoundationDomainError } from "../errors/config-foundation-domain-error.js";
 import type { HarnessConfigResolvedDocument, HarnessConfigSourceDocument } from "../harness-config.js";
@@ -163,7 +164,9 @@ export class PresetResolutionService {
       project: {
         name: sourceDocument.project.name,
         preset: sourceDocument.project.preset,
-        languages: sourceDocument.project.languages ?? ["typescript"],
+        // WI-320 (github#39): 未宣言時に ["typescript"] を注入しない。「未宣言」を resolved config まで
+        // 生存させ、validator-system adapter のファイルシステム言語検出（WI-319）を実 CLI 経路で有効にする。
+        ...(sourceDocument.project.languages === undefined ? {} : { languages: sourceDocument.project.languages }),
       },
       layers,
       quickMode: deepMerge(presetDefinition.quickMode, sourceDocument.quickMode, "quickMode"),

package/scripts/harness/config-foundation/domain/value-objects/project-config.ts

@@ -2,11 +2,12 @@
  * @layer domain
  * @unit config-foundation
  * @work-item-id WI-212
+ * @work-item-id WI-320
  *
  * ProjectConfig値オブジェクト - プロジェクト名とPresetを保持する
  */
-import { ConfigValidationError } from '../errors/config-validation-error.js';
-import { Preset } from './preset.js';
+import { ConfigValidationError } from "../errors/config-validation-error.js";
+import { Preset } from "./preset.js";
 
 interface ProjectConfigProps {
   readonly name: string;
@@ -17,29 +18,37 @@ interface ProjectConfigProps {
 export class ProjectConfig {
   readonly name: string;
   readonly preset: Preset;
-  readonly languages: readonly string[];
+  /**
+   * WI-320 (github#39): 宣言があった場合のみ保持する（undefined = 未宣言）。
+   * default `['typescript']` の注入をやめ、「未宣言」シグナルを下流
+   * （validator-system のファイルシステム言語検出、WI-319）まで生存させる。
+   */
+  readonly languages?: readonly string[];
 
   constructor(props: ProjectConfigProps) {
-    if (!props.name || props.name.trim() === '') {
-      throw new ConfigValidationError('ProjectConfig: name must not be empty');
-    }
-    const sourceLanguages = props.languages ?? ['typescript'];
-    if (sourceLanguages.length === 0) {
-      throw new ConfigValidationError('ProjectConfig: languages must not be empty');
+    if (!props.name || props.name.trim() === "") {
+      throw new ConfigValidationError("ProjectConfig: name must not be empty");
     }
-    const normalizedLanguages = sourceLanguages.map((language) => language.trim()).filter((language) => language.length > 0);
-    if (normalizedLanguages.length !== sourceLanguages.length) {
-      throw new ConfigValidationError('ProjectConfig: languages must contain non-empty strings');
+    if (props.languages !== undefined) {
+      if (props.languages.length === 0) {
+        throw new ConfigValidationError("ProjectConfig: languages must not be empty");
+      }
+      const normalizedLanguages = props.languages
+        .map((language) => language.trim())
+        .filter((language) => language.length > 0);
+      if (normalizedLanguages.length !== props.languages.length) {
+        throw new ConfigValidationError("ProjectConfig: languages must contain non-empty strings");
+      }
+      this.languages = Object.freeze([...normalizedLanguages]);
     }
     this.name = props.name;
     this.preset = props.preset;
-    this.languages = Object.freeze([...normalizedLanguages]);
     Object.freeze(this);
   }
 
   static create(raw: { name: string; preset: string; languages?: readonly string[] }): ProjectConfig {
     const preset = Preset.create(raw.preset);
-    return new ProjectConfig({ name: raw.name, preset, languages: raw.languages ?? ['typescript'] });
+    return new ProjectConfig({ name: raw.name, preset, languages: raw.languages });
   }
 
   rename(name: string): ProjectConfig {
@@ -51,9 +60,16 @@ export class ProjectConfig {
   }
 
   equals(other: ProjectConfig): boolean {
-    return this.name === other.name
-      && this.preset.equals(other.preset)
-      && this.languages.length === other.languages.length
-      && this.languages.every((language, index) => language === other.languages[index]);
+    return this.name === other.name && this.preset.equals(other.preset) && this.languagesEqual(other.languages);
+  }
+
+  private languagesEqual(otherLanguages: readonly string[] | undefined): boolean {
+    if (this.languages === undefined || otherLanguages === undefined) {
+      return this.languages === otherLanguages;
+    }
+    return (
+      this.languages.length === otherLanguages.length &&
+      this.languages.every((language, index) => language === otherLanguages[index])
+    );
   }
 }