claude-alfred 0.3.21 → 0.3.23

package/dist/{server-D3b54XYU.mjs → server-BsyPli_m.mjs}

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 import { a as __toCommonJS, o as __toESM, t as __commonJSMin } from "./chunk-CAm0Jl7e.mjs";
-import { a as effectiveStatus, c as readActive, d as reviewStatusFor, g as writeActiveState, h as verifyReviewFile, i as detectSize, l as readActiveState, n as VALID_SLUG, o as filesForSize, p as switchActive, r as completeTask, s as init_types, t as SpecDir, u as removeTask } from "./types-K2jxpWyU.mjs";
-import { a as nextActionable, c as topologicalOrder, i as listAllEpics, l as unlinkTaskFromAllEpics, n as initEpic, o as removeEpic, r as init_epic, s as syncTaskStatus, t as EpicDir } from "./epic-CfxJ13zy.mjs";
-import { n as init_audit, t as appendAudit } from "./audit-e13xK9Fr.mjs";
+import { a as effectiveStatus, c as readActive, d as reviewStatusFor, g as writeActiveState, h as verifyReviewFile, i as detectSize, l as readActiveState, n as VALID_SLUG, o as filesForSize, p as switchActive, r as completeTask, s as init_types, t as SpecDir, u as removeTask } from "./types-zr3tpkx_.mjs";
+import { a as nextActionable, c as topologicalOrder, i as listAllEpics, l as unlinkTaskFromAllEpics, n as initEpic, o as removeEpic, r as init_epic, s as syncTaskStatus, t as EpicDir } from "./epic-BHZ71Dpf.mjs";
+import { n as init_audit, t as appendAudit } from "./audit-BUfNnVyn.mjs";
 import { i as getKnowledgeByIDs, l as init_knowledge } from "./knowledge-C7rEfFSX.mjs";
 import { r as vectorSearchKnowledge, t as init_vectors } from "./vectors-DHZGQ096.mjs";
 import { a as subTypeBoost, i as searchKnowledgeFTS, r as init_fts } from "./fts-DICqcpG_.mjs";
-import "./dispatcher-BDl_Flyx.mjs";
-import { o as truncate, r as init_helpers } from "./directives-DfzKzUAL.mjs";
-import { c as updateTaskStatus, l as handleLedger, n as init_post_tool, o as post_tool_exports, s as init_status, u as init_ledger } from "./post-tool-DpBkq5ik.mjs";
+import "./dispatcher-DcHtDI_E.mjs";
+import { o as truncate, r as init_helpers } from "./directives-B-imQAUP.mjs";
+import { c as updateTaskStatus, l as handleLedger, n as init_post_tool, o as post_tool_exports, s as init_status, u as init_ledger } from "./post-tool-DPLHW9jK.mjs";
 import "./store-BffM-bi-.mjs";
-import { a as writeReviewGate, i as readReviewGate, n as init_review_gate, t as clearReviewGate } from "./review-gate-7Pfe_A-8.mjs";
+import { a as writeReviewGate, i as readReviewGate, n as init_review_gate, t as clearReviewGate } from "./review-gate-BpjBk-63.mjs";
 import { d as writeStateJSON, n as ensureStateDir, p as writeWaveProgress, r as init_state, s as readWaveProgress, u as stateDir } from "./state-Cih-8_Zc.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
@@ -18214,63 +18214,11 @@ function validateSpec(projectPath, taskSlug, size, specType, opts) {
 		status: "fail",
 		message: `${f} missing`
 	});
-	const primaryContent = readFile(specType === "bugfix" ? "bugfix.md" : specType === "delta" ? "delta.md" : "requirements.md") ?? "";
+	const primaryContent = readFile(specType === "bugfix" ? "bugfix.md" : "requirements.md") ?? "";
 	const tasksContent = readFile("tasks.md") ?? "";
 	const designContent = readFile("design.md") ?? "";
 	const testSpecsContent = readFile("test-specs.md") ?? "";
 	const researchContent = readFile("research.md") ?? "";
-	if (size === "D") {
-		const deltaContent = readFile("delta.md") ?? "";
-		const requiredSectionsEN = [
-			"Change Summary",
-			"Files Affected",
-			"Rationale",
-			"Impact Scope",
-			"Test Plan",
-			"Rollback Strategy"
-		];
-		const requiredSectionsJA = [
-			"変更概要",
-			"影響ファイル",
-			"変更理由",
-			"影響範囲",
-			"テスト計画",
-			"ロールバック手順"
-		];
-		const enCount = requiredSectionsEN.filter((s) => deltaContent.includes(`## ${s}`)).length;
-		const jaCount = requiredSectionsJA.filter((s) => deltaContent.includes(`## ${s}`)).length;
-		const bestCount = Math.max(enCount, jaCount);
-		checks.push(bestCount >= 6 ? {
-			name: "delta_sections_present",
-			status: "pass",
-			message: "All delta sections present"
-		} : {
-			name: "delta_sections_present",
-			status: "fail",
-			message: `Only ${bestCount}/6 delta sections found`
-		});
-		const chgIDs = extractIDs(deltaContent, ID.CHG);
-		checks.push(chgIDs.length > 0 ? {
-			name: "delta_change_ids",
-			status: "pass",
-			message: `${chgIDs.length} CHG-N IDs found`
-		} : {
-			name: "delta_change_ids",
-			status: "fail",
-			message: "No CHG-N IDs found in delta.md"
-		});
-		const hasBeforeAfter = /\bBefore:\s*/i.test(deltaContent) && /\bAfter:\s*/i.test(deltaContent);
-		checks.push(hasBeforeAfter ? {
-			name: "delta_before_after",
-			status: "pass",
-			message: "Before/After blocks found"
-		} : {
-			name: "delta_before_after",
-			status: "fail",
-			message: "Missing Before/After blocks in delta.md"
-		});
-		return buildResult(checks, opts);
-	}
 	if (specType === "bugfix") checks.push(primaryContent.length > 200 ? {
 		name: "min_fr_count",
 		status: "pass",
@@ -18282,7 +18230,7 @@ function validateSpec(projectPath, taskSlug, size, specType, opts) {
 	});
 	else {
 		const frIDs = extractIDs(primaryContent, ID.FR);
-		const minCount = size === "S" ? 1 : size === "M" ? 3 : size === "XL" ? 8 : 5;
+		const minCount = size === "S" ? 1 : size === "M" ? 3 : 5;
 		const status = frIDs.length >= minCount ? "pass" : frIDs.length > 0 ? "warn" : "fail";
 		checks.push({
 			name: "min_fr_count",
@@ -18325,7 +18273,10 @@ function validateSpec(projectPath, taskSlug, size, specType, opts) {
 		let currentTask = "";
 		for (const line of taskLines) {
 			const taskMatch = line.match(/(?:###\s+|[-*]\s+\[[ x]\]\s+)(T-\d+\.\d+)/);
-			if (taskMatch) currentTask = taskMatch[1];
+			if (taskMatch) {
+				currentTask = taskMatch[1];
+				if (extractIDs(line, ID.FR).length > 0) tasksWithFR.add(currentTask);
+			}
 			if (currentTask && /(?:^[-\s]*|_)Requirements:\s*FR-/i.test(line)) tasksWithFR.add(currentTask);
 		}
 		const orphanTasks = taskIDs.filter((t) => !tasksWithFR.has(t));
@@ -18460,7 +18411,7 @@ function validateSpec(projectPath, taskSlug, size, specType, opts) {
 			message: `${confidenceCount}/${frIDs.length} FRs have confidence annotations`
 		});
 	}
-	if (size === "L" || size === "XL") {
+	if (size === "L") {
 		const nfrIDs = extractIDs(primaryContent, ID.NFR);
 		const taskNFRs = extractIDs(tasksContent, ID.NFR);
 		const unreferencedNFR = nfrIDs.filter((n) => !taskNFRs.includes(n));
@@ -18484,41 +18435,7 @@ function validateSpec(projectPath, taskSlug, size, specType, opts) {
 			message: "Research content may be insufficient"
 		});
 	}
-	if (size === "XL") {
-		const frIDs = extractIDs(primaryContent, ID.FR);
-		const confidenceCount = (primaryContent.match(/<!--\s*confidence:/g) ?? []).length;
-		const coverage = frIDs.length > 0 ? confidenceCount / frIDs.length : 1;
-		checks.push(coverage >= .8 ? {
-			name: "confidence_coverage",
-			status: "pass",
-			message: `${Math.round(coverage * 100)}% confidence coverage`
-		} : {
-			name: "confidence_coverage",
-			status: "fail",
-			message: `${Math.round(coverage * 100)}% confidence coverage (required: ≥80%)`
-		});
-		const waveHeaders = tasksContent.match(/## Wave\s+\d+/g) ?? [];
-		checks.push(waveHeaders.length >= 4 ? {
-			name: "xl_wave_count",
-			status: "pass",
-			message: `${waveHeaders.length} waves found`
-		} : {
-			name: "xl_wave_count",
-			status: "fail",
-			message: `${waveHeaders.length} waves found (required: ≥4 for XL)`
-		});
-		const nfrIDs = extractIDs(primaryContent, ID.NFR);
-		checks.push(nfrIDs.length > 0 ? {
-			name: "xl_nfr_required",
-			status: "pass",
-			message: `${nfrIDs.length} NFR-N found`
-		} : {
-			name: "xl_nfr_required",
-			status: "fail",
-			message: "No NFR-N found (required for XL)"
-		});
-	}
-	if ((size === "L" || size === "XL") && primaryContent.includes("grounding:")) {
+	if (size === "L" && primaryContent.includes("grounding:")) {
 		const groundingMatches = primaryContent.match(/grounding:\s*(\w+)/g) ?? [];
 		const speculative = groundingMatches.filter((g) => /speculative/i.test(g)).length;
 		const ratio = groundingMatches.length > 0 ? speculative / groundingMatches.length : 0;
@@ -18605,6 +18522,13 @@ function dossierUpdate(projectPath, store, params) {
 	};
 	const lang = process.env.ALFRED_LANG || "en";
 	if (lang !== "en") result.lang = lang;
+	try {
+		const task = readActiveState(projectPath).tasks.find((t) => t.slug === taskSlug);
+		const size = task?.size ?? "L";
+		const specType = task?.spec_type ?? "feature";
+		const issues = validateSpec(projectPath, taskSlug, size, specType).checks.filter((c) => c.status === "fail" || c.status === "warn").map((c) => `[${c.status}] ${c.message}`);
+		if (issues.length > 0) result.validation_hints = issues;
+	} catch {}
 	return jsonResult$1(result);
 }
 function dossierStatus(projectPath) {
@@ -18813,9 +18737,6 @@ var requirements_default$1 = "# Requirements: {{taskSlug}}\n\n> {{description}}\
 //#region src/spec/templates/en/bugfix.tmpl
 var bugfix_default$1 = "# Bugfix: {{taskSlug}}\n\n> {{description}}\n\n## Bug Summary\n\n<!-- 1-2 sentences. What happens vs. what should happen. -->\n\n## Severity & Impact\n\n| Field | Value |\n|-------|-------|\n| Severity | P0 (service down) / P1 (major feature broken) / P2 (workaround exists) / P3 (minor) |\n| Impact | |\n| Frequency | Always / under specific conditions / rare |\n| Workaround | Yes (describe) / None |\n\n## Reproduction Steps\n\n1.\n2.\n3.\n\n## Root Cause Analysis\n\n### 5 Whys\n\n1. Why? →\n2. Why? →\n3. Why? →\n4. Why? →\n5. Why (root cause)? →\n\n### Code Trace\n\n<!-- Exact paths and line numbers so implementor can locate the cause immediately. -->\n\n- **Symptom location**: `src/path/to/file.ts:line` — what happens\n- **Root cause location**: `src/path/to/file.ts:line` — why it happens\n- **Data flow**: input → processing → point of failure\n\n## Fix Strategy\n\n- **Target file**: `src/path/to/file.ts` — concrete change description\n- **Rejected alternatives**: other approaches and why dismissed\n- **Side-effect risk**: potential impact on other functionality\n\n## Unchanged Behavior\n\n<!-- What MUST NOT break. Implementor checks these BEFORE applying fix. -->\n\n- [ ] All existing tests pass\n- [ ]\n\n## Regression Prevention Test\n\n<!-- Test to detect recurrence. Also add to test-specs.md.\n     Test MUST describe external-observable behavior only (no internal implementation references). -->\n\n```gherkin\nScenario: [Bug does not recur]\n  Given [precondition that triggered the bug]\n  When [action that caused the bug]\n  Then [correct behavior]\n```\n";
 //#endregion
-//#region src/spec/templates/en/delta.tmpl
-var delta_default$1 = "# Delta: {{taskSlug}}\n\n> {{description}}\n\n## Change Summary\n\n<!-- 1-2 sentences. What changes and why. -->\n\n## Files Affected\n\n### CHG-1: [Change description]\n\n- File: `src/path/to/file.ts`\n- Before: [current code or behavior]\n- After: [changed code or behavior]\n\n## Rationale\n\n<!-- Why this change is necessary. If alternatives exist, list them with rejection reasons.\n     Important decisions MUST be persisted via `ledger save sub_type=decision`. -->\n\n## Impact Scope\n\n<!-- What else this change affects. If nothing, explicitly state \"no impact\". -->\n\n- **API compatibility**: Changed / Unchanged\n- **UI**: Changed / Unchanged\n- **Tests**: Modification needed / Not needed\n- **Performance**: Impacted / Not impacted\n\n## Unchanged Behavior\n\n<!-- What MUST NOT break. -->\n\n- [ ] All existing tests pass\n- [ ]\n\n## Test Plan\n\n<!-- How to verify the change is correct. Concrete commands or steps. -->\n\n## Rollback Strategy\n\n<!-- Recovery steps if problems occur. Is `git revert` sufficient, or is data migration needed? -->\n";
-//#endregion
 //#region src/spec/templates/en/design.tmpl
 var design_default$1 = "# Design: {{taskSlug}}\n\n## Architecture Overview\n\n<!-- ASCII diagram showing component structure and data flow.\n     Implementor MUST create/modify files according to this diagram. -->\n\n## Component Design\n\n<!-- For each component: write Why and What. Minimize How — implementor decides. -->\n\n### [Component Name] (`src/path/to/file.ts`)\n\n- **Responsibility**: One sentence.\n- **Interface**:\n```typescript\n// Public function signatures and types. Implementor MUST follow this contract.\n```\n- **Dependencies**: Existing modules used\n- **Error handling**: Errors this component throws/returns\n\n## Data Models\n\n<!-- New/changed tables, type definitions. Write both SQL DDL and TypeScript types.\n     Implementor uses these definitions directly in code. -->\n\n## API Contracts\n\n<!-- New/changed endpoints.\n     Implementor MUST follow this contract exactly. No ad-hoc field additions. -->\n\n| Method | Path | Request | Response | Error |\n|--------|------|---------|----------|-------|\n|        |      |         |          |       |\n\n## Error Scenarios\n\n<!-- List errors that CAN happen and HOW to handle them.\n     AI tends to implement happy-path only. Errors not listed here will NOT be handled. -->\n\n| Scenario | Input/State | Expected Handling | HTTP/Exit |\n|----------|------------|-------------------|-----------|\n|          |            |                   |           |\n\n## Boundary Conditions\n\n<!-- Typical edge cases AI misses. Implementation MUST cover these. -->\n\n- [ ] Empty input (null, undefined, \"\", [], {})\n- [ ] Maximum values (MAX_INT, very long strings, 1000+ records)\n- [ ] Concurrent access (simultaneous writes, race conditions)\n- [ ] Unicode / CJK / special characters\n- [ ] Unauthorized / expired auth\n- [ ] Network error / timeout\n- [ ] Remove non-applicable items\n\n## Design Decisions\n\n<!-- Important decisions MUST be persisted via `ledger save sub_type=decision`. -->\n\n| Decision | Choice | Rationale | Alternatives |\n|----------|--------|-----------|--------------|\n|          |        |           |              |\n\n## Non-Goals\n\n<!-- Align with Out of Scope in requirements.md.\n     If implementor starts building out-of-scope features, refer here to stop. -->\n\n-\n\n## Traceability Matrix\n\n<!-- Every FR must map to component → task → test. No orphans allowed. -->\n\n| Req ID | Component | Task ID | Test ID |\n|--------|-----------|---------|---------|\n| FR-1   |           | T-1.1   | TS-1.1  |\n";
 //#endregion
@@ -18834,9 +18755,6 @@ var requirements_default = "# 要件定義: {{taskSlug}}\n\n> {{description}}\n\
 //#region src/spec/templates/ja/bugfix.tmpl
 var bugfix_default = "# バグ修正: {{taskSlug}}\n\n> {{description}}\n\n## バグ概要\n\n<!-- 1-2 文。何が起きるか vs 何が正しい動作か。 -->\n\n## 重要度と影響範囲\n\n| 項目 | 内容 |\n|------|------|\n| 重要度 | P0 (サービス停止) / P1 (主要機能障害) / P2 (回避策あり) / P3 (軽微) |\n| 影響範囲 | |\n| 頻度 | 常に / 特定条件下 / 稀 |\n| 回避策 | あり (内容) / なし |\n\n## 再現手順\n\n1.\n2.\n3.\n\n## 原因分析\n\n### 5 Whys\n\n1. なぜ？→\n2. なぜ？→\n3. なぜ？→\n4. なぜ？→\n5. なぜ（根本原因）？→\n\n### コードトレース\n\n<!-- 実装者が原因箇所を即座に特定できるよう、正確なパスと行番号を書く。 -->\n\n- **発症箇所**: `src/path/to/file.ts:line` — 何が起きるか\n- **原因箇所**: `src/path/to/file.ts:line` — なぜ起きるか\n- **データフロー**: 入力 → 処理 → 問題が生じるポイント\n\n## 修正方針\n\n- **変更対象**: `src/path/to/file.ts` — 具体的にどう変えるか\n- **選択しなかった方法**: 代替案と却下理由\n- **副作用リスク**: 修正が他に影響する可能性\n\n## 変更不可の動作\n\n<!-- 修正で壊してはいけないもの。実装者はここを確認してから修正すること。 -->\n\n- [ ] 既存テスト全件パス\n- [ ]\n\n## リグレッション防止テスト\n\n<!-- このバグの再発を検知するテスト。test-specs.md にも追加すること。\n     テストは外部観測可能な振る舞いのみ（内部実装を参照しない）。 -->\n\n```gherkin\nScenario: [バグの再発防止]\n  Given [バグ発生の前提条件]\n  When [バグを引き起こす操作]\n  Then [正常な動作]\n```\n";
 //#endregion
-//#region src/spec/templates/ja/delta.tmpl
-var delta_default = "# 差分変更: {{taskSlug}}\n\n> {{description}}\n\n## 変更概要\n\n<!-- 1-2 文。何を変えるか、なぜ変えるか。 -->\n\n## 影響ファイル\n\n### CHG-1: [変更内容]\n\n- File: `src/path/to/file.ts`\n- Before: [現在のコードまたは動作]\n- After: [変更後のコードまたは動作]\n\n## 変更理由\n\n<!-- なぜこの変更が必要か。代替案があれば記載し却下理由も書く。\n     重要な判断は `ledger save sub_type=decision` で永続化。 -->\n\n## 影響範囲\n\n<!-- この変更が影響する他の機能/コンポーネント。\n     影響なしの場合も「影響なし」と明記する。 -->\n\n- **API 互換性**: 変更あり / なし\n- **UI**: 変更あり / なし\n- **テスト**: 修正必要 / 不要\n- **パフォーマンス**: 影響あり / なし\n\n## 変更不可の動作\n\n<!-- この変更で壊してはいけないもの。 -->\n\n- [ ] 既存テスト全件パス\n- [ ]\n\n## テスト計画\n\n<!-- 変更の正しさをどう確認するか。具体的なコマンドまたは手順。 -->\n\n## ロールバック手順\n\n<!-- 問題が起きた場合の復旧手順。`git revert` で十分か、データ migration が必要か。 -->\n";
-//#endregion
 //#region src/spec/templates/ja/design.tmpl
 var design_default = "# 設計: {{taskSlug}}\n\n## アーキテクチャ概要\n\n<!-- ASCII ダイアグラムでコンポーネント構成とデータフローを示す。\n     実装者はこの図に従ってファイルを作成/変更すること。 -->\n\n## コンポーネント設計\n\n<!-- 各コンポーネントに以下を記載。Why と What を書く。How は最小限 — 実装者が判断する。 -->\n\n### [コンポーネント名] (`src/path/to/file.ts`)\n\n- **責務**: 1文で。\n- **インターフェース**:\n```typescript\n// 公開する関数シグネチャと型を書く。実装者はこの契約に従う。\n```\n- **依存**: 使用する既存モジュール\n- **エラー処理**: このコンポーネントが throw/return するエラー\n\n## データモデル\n\n<!-- 新規/変更テーブル、型定義。SQL DDL + TypeScript 型を両方書く。\n     実装者はここの定義をそのままコードに使う。 -->\n\n## API 契約\n\n<!-- 新規/変更エンドポイント。\n     実装者はこの契約に正確に従うこと。勝手なフィールド追加禁止。 -->\n\n| Method | Path | Request | Response | Error |\n|--------|------|---------|----------|-------|\n|        |      |         |          |       |\n\n## エラーシナリオ\n\n<!-- 正常系だけでなく、発生しうるエラーとその処理方法を列挙する。\n     AI は happy-path のみ実装する傾向がある。ここで明示しないエラーは処理されない。 -->\n\n| シナリオ | 入力/状態 | 期待する処理 | HTTP/Exit |\n|----------|----------|-------------|-----------|\n|          |          |             |           |\n\n## 境界条件\n\n<!-- AI が見落とす典型的なエッジケース。実装時に必ずカバーすること。 -->\n\n- [ ] 空入力 (null, undefined, \"\", [], {})\n- [ ] 最大値 (MAX_INT, 長大文字列, 1000+ レコード)\n- [ ] 並行アクセス (同時書き込み, レース条件)\n- [ ] Unicode / 日本語 / 特殊文字\n- [ ] 権限なし / 認証切れ\n- [ ] ネットワークエラー / タイムアウト\n- [ ] 該当なし項目は削除すること\n\n## 設計判断\n\n<!-- 重要な判断は `ledger save sub_type=decision` で永続化すること。 -->\n\n| 判断 | 選択 | 理由 | 代替案 |\n|------|------|------|--------|\n|      |      |      |        |\n\n## やらないこと\n\n<!-- requirements.md の Out of Scope と整合。\n     実装者がスコープ外の機能を作り始めたらここを参照して止める。 -->\n\n-\n\n## トレーサビリティマトリクス\n\n<!-- 全 FR がコンポーネント → タスク → テストに紐づくこと。孤立禁止。 -->\n\n| Req ID | Component | Task ID | Test ID |\n|--------|-----------|---------|---------|\n| FR-1   |           | T-1.1   | TS-1.1  |\n";
 //#endregion
@@ -18854,7 +18772,6 @@ init_types();
 const EN_TEMPLATES = {
 	"requirements.md": requirements_default$1,
 	"bugfix.md": bugfix_default$1,
-	"delta.md": delta_default$1,
 	"design.md": design_default$1,
 	"tasks.md": tasks_default$1,
 	"test-specs.md": test_specs_default$1,
@@ -18863,7 +18780,6 @@ const EN_TEMPLATES = {
 const JA_TEMPLATES = {
 	"requirements.md": requirements_default,
 	"bugfix.md": bugfix_default,
-	"delta.md": delta_default,
 	"design.md": design_default,
 	"tasks.md": tasks_default,
 	"test-specs.md": test_specs_default,
@@ -18892,18 +18808,16 @@ init_types();
 function initSpec(projectPath, taskSlug, description, opts) {
 	if (!VALID_SLUG.test(taskSlug)) throw new Error(`invalid task_slug "${taskSlug}": must be lowercase alphanumeric with hyphens (e.g., 'add-auth')`);
 	const size = opts?.size ?? detectSize(description);
-	let specType = opts?.specType ?? "feature";
-	if (size === "D") specType = "delta";
+	const specType = opts?.specType ?? "feature";
 	const sd = new SpecDir(projectPath, taskSlug);
 	if (sd.exists()) throw new Error(`spec already exists for '${taskSlug}'; use dossier action=update to modify`);
 	mkdirSync(sd.dir(), { recursive: true });
-	const data = {
+	const rendered = renderForSize(size, specType, {
 		taskSlug,
 		description,
 		date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
 		specType
-	};
-	const rendered = renderForSize(size, specType, data);
+	});
 	const files = filesForSize(size, specType);
 	try {
 		for (const f of files) {
@@ -19003,11 +18917,7 @@ async function dossierInit(projectPath, store, emb, params) {
 	const lang = process.env.ALFRED_LANG || "en";
 	result.lang = lang;
 	if (lang !== "en") result.lang_directive = `Write ALL spec content in ${lang === "ja" ? "Japanese (日本語)" : lang}. Technical terms and IDs (FR-N, T-N.N, etc.) stay in English.`;
-	result.onboarding_hint = `Spec '${params.task_slug}' created (size: ${initResult.size}). Next: write spec files → self-review → ${[
-		"M",
-		"L",
-		"XL"
-	].includes(initResult.size) ? "dashboard approval → " : ""}implement per wave.`;
+	result.onboarding_hint = `Spec '${params.task_slug}' created (size: ${initResult.size}). Next: write spec files → self-review → ${["M", "L"].includes(initResult.size) ? "dashboard approval → " : ""}implement per wave.`;
 	try {
 		writeReviewGate(projectPath, {
 			gate: "spec-review",
@@ -19071,11 +18981,7 @@ function dossierComplete(projectPath, store, params) {
 	const task = readActiveState(projectPath).tasks.find((t) => t.slug === taskSlug);
 	if (task) {
 		const size = task.size ?? "L";
-		if ([
-			"M",
-			"L",
-			"XL"
-		].includes(size)) {
+		if (["M", "L"].includes(size)) {
 			const reviewStatus = reviewStatusFor(projectPath, taskSlug);
 			if (reviewStatus !== "approved") return errorResult$1(`completion requires review_status="approved" for ${size} specs (current: "${reviewStatus || "pending"}"). Review in alfred dashboard.`);
 			const verification = verifyReviewFile(projectPath, taskSlug);
@@ -19603,7 +19509,7 @@ function createMCPServer(store, emb, version) {
 Actions: status (read-only), init, update, switch, complete, delete (2-phase: preview then confirm=true), history, rollback, review, validate (read-only), gate (review gate management), check (mark task completed), defer (toggle deferred/resume), cancel.
 
 task_slug format: lowercase alphanumeric with hyphens (e.g. "my-feature", max 64 chars).
-Size-based scaling: init accepts size (S/M/L/XL) and spec_type (feature/bugfix). S=2 files, M=3-4 files, L/XL=5 files.`, {
+Size-based scaling: init accepts size (S/M/L) and spec_type (feature/bugfix). S=3 files, M=4 files, L=5 files.`, {
 		action: enumType([
 			"init",
 			"update",
@@ -19638,8 +19544,7 @@ Size-based scaling: init accepts size (S/M/L/XL) and spec_type (feature/bugfix).
 		size: enumType([
 			"S",
 			"M",
-			"L",
-			"XL"
+			"L"
 		]).optional().describe("Spec size for init"),
 		spec_type: enumType(["feature", "bugfix"]).optional().describe("Spec type for init"),
 		version: stringType().optional().describe("Version timestamp for rollback"),
@@ -19680,15 +19585,70 @@ Actions: init, status, link, unlink, order, list, update, delete (2-phase: previ
 	}, async (params) => {
 		return handleRoster(store, params);
 	});
-	server.tool("ledger", `Long-term knowledge search, save, and health management — memories and past specs, searchable across sessions and projects.
+	const ledgerDesc = (process.env.ALFRED_LANG || "en").toLowerCase() === "ja" ? `ナレッジの検索・保存・管理。セッションやプロジェクトを跨いで検索可能。
+
+Actions:
+- search: 過去のナレッジを検索
+- save: 新しいナレッジを保存（下記ガイドに従うこと）
+- promote: pattern→rule に昇格
+- candidates: 昇格候補の一覧
+- reflect: ヘルスレポート（統計、矛盾検出、昇格候補）
+
+## save ガイド（全フィールドを日本語で記述すること）
+
+### decision（意思決定）— 技術的な選択とその根拠
+- title: 1行の要約（例: 「認証にJWTではなくセッションCookieを採用」）
+- decision: 何を決めたか（例: 「セッションCookieベースの認証を採用する」）
+- reasoning: なぜその選択か、具体的な根拠（例: 「XSSリスク軽減のため。HttpOnly + SameSiteで保護可能」）
+- alternatives: 却下した選択肢と理由を改行区切りで（例: 「JWT: トークン失効管理が複雑」）
+- context_text: 背景・制約条件
+
+### pattern（パターン）— 再利用可能な手法・アンチパターン
+- title: 1行の要約（例: 「大規模リファクタリング前にgrepで影響範囲を列挙する」）
+- pattern_type: good（推奨）/ bad（アンチパターン）/ error-solution（エラー解決策）
+- pattern: 問題と解決策を具体的に（例: 「問題: 変更漏れによるランタイムエラー。解決: grep -r で全参照を列挙してからリファクタ開始」）
+- application_conditions: いつ適用するか / しないか
+- expected_outcomes: 期待される結果
+
+### rule（ルール）— 常に従うべき規約
+- title: 1行の要約（例: 「テストではモックDBではなく実DBを使用する」）
+- key: 機械可読キー（例: use-real-db-in-tests）
+- text: 命令形のルール本文（例: 「テストでは常に実データベースに接続すること。モックDBは使用禁止」）
+- priority: p0（必須）/ p1（推奨）/ p2（参考）
+- rationale: なぜこのルールが必要か
+- category: 分類（style / security / architecture / testing）` : `Long-term knowledge search, save, and management — searchable across sessions and projects.
 
 Actions:
-- search (default): Search past memories AND completed specs
-- save: Save a new memory entry for future retrieval
-- promote: Promote a memory's sub_type (pattern→rule)
-- candidates: List patterns that qualify for promotion to rule based on hit_count
+- search: Search past knowledge entries
+- save: Save a new knowledge entry (follow the guide below)
+- promote: Promote pattern→rule
+- candidates: List promotion candidates
 - reflect: Health report — stats, conflicts, promotion candidates
-- audit-conventions: Check pattern/rule memories against the codebase for drift`, {
+
+## save guide (write all fields in English)
+
+### decision — Technical choices and their rationale
+- title: One-line summary (e.g. "Adopt session cookies over JWT for auth")
+- decision: What was decided (e.g. "Use session cookie-based authentication")
+- reasoning: Why this choice, with specific rationale (e.g. "Reduces XSS risk. HttpOnly + SameSite provides protection")
+- alternatives: Rejected alternatives with reasons, newline-separated (e.g. "JWT: token revocation management is complex")
+- context_text: Background and constraints
+
+### pattern — Reusable techniques or anti-patterns
+- title: One-line summary (e.g. "Grep all references before large-scale refactoring")
+- pattern_type: good (recommended) / bad (anti-pattern) / error-solution (error fix)
+- pattern: Problem and solution concretely (e.g. "Problem: runtime errors from missed references. Solution: grep -r all references before starting refactor")
+- application_conditions: When to apply / when NOT to apply
+- expected_outcomes: Expected results
+
+### rule — Conventions to always follow
+- title: One-line summary (e.g. "Use real DB, not mocks, in tests")
+- key: Machine-readable key (e.g. use-real-db-in-tests)
+- text: Imperative rule text (e.g. "Always connect to a real database in tests. Mock DBs are prohibited")
+- priority: p0 (must) / p1 (should) / p2 (reference)
+- rationale: Why this rule is needed
+- category: Classification (style / security / architecture / testing)`;
+	server.tool("ledger", ledgerDesc, {
 		action: enumType([
 			"search",
 			"save",
@@ -19700,7 +19660,7 @@ Actions:
 		]).describe("Action to perform"),
 		id: numberType().optional().describe("Record ID (required for promote)"),
 		query: stringType().optional().describe("Search query"),
-		label: stringType().optional().describe("Short label for saved entry (REQUIRED for save)"),
+		label: stringType().optional().describe("Short label for saved entry, natural language (REQUIRED for save)"),
 		limit: numberType().optional().describe("Maximum search results (default: 10)"),
 		detail: enumType([
 			"compact",
@@ -19712,30 +19672,30 @@ Actions:
 			"pattern",
 			"rule"
 		]).optional().describe("Knowledge type (REQUIRED for save)"),
-		title: stringType().optional().describe("Entry title (REQUIRED for save)"),
-		decision: stringType().optional().describe("Decision: what was decided (REQUIRED for decision)"),
-		reasoning: stringType().optional().describe("Decision: why this choice (REQUIRED for decision)"),
-		alternatives: stringType().optional().describe("Decision: newline-separated rejected alternatives with reasons"),
-		context_text: stringType().optional().describe("Decision/Pattern: context or background"),
+		title: stringType().optional().describe("Natural language title, max 200 chars. NOT JSON. (REQUIRED for save)"),
+		decision: stringType().optional().describe("Decision: what was decided, in plain text (REQUIRED for decision)"),
+		reasoning: stringType().optional().describe("Decision: why this choice, with specific rationale (REQUIRED for decision)"),
+		alternatives: stringType().optional().describe("Decision: rejected alternatives with reasons, newline-separated"),
+		context_text: stringType().optional().describe("Background, constraints, or trigger for this knowledge entry"),
 		pattern_type: enumType([
 			"good",
 			"bad",
 			"error-solution"
-		]).optional().describe("Pattern: type (REQUIRED for pattern)"),
-		pattern: stringType().optional().describe("Pattern: concrete steps (REQUIRED for pattern)"),
-		application_conditions: stringType().optional().describe("Pattern: when to apply"),
-		expected_outcomes: stringType().optional().describe("Pattern: expected results"),
-		key: stringType().optional().describe("Rule: machine-readable key (REQUIRED for rule)"),
-		text: stringType().optional().describe("Rule: imperative text (REQUIRED for rule)"),
-		category: stringType().optional().describe("Rule: category"),
+		]).optional().describe("Pattern classification (REQUIRED for pattern)"),
+		pattern: stringType().optional().describe("Pattern: problem and solution in plain text (REQUIRED for pattern)"),
+		application_conditions: stringType().optional().describe("Pattern: when to apply / when NOT to apply"),
+		expected_outcomes: stringType().optional().describe("Pattern: expected results when applied"),
+		key: stringType().optional().describe("Rule: machine-readable key, kebab-case (REQUIRED for rule)"),
+		text: stringType().optional().describe("Rule: imperative text — what to do or not do (REQUIRED for rule)"),
+		category: stringType().optional().describe("Rule: category (style / security / architecture / testing)"),
 		priority: enumType([
 			"p0",
 			"p1",
 			"p2"
-		]).optional().describe("Rule: priority"),
-		rationale: stringType().optional().describe("Rule: rationale"),
+		]).optional().describe("Rule: p0=must, p1=should, p2=reference"),
+		rationale: stringType().optional().describe("Rule: why this rule is needed"),
 		source_ref: stringType().optional().describe("Rule: source reference JSON {\"type\":\"pattern\",\"id\":\"...\"}"),
-		tags: stringType().optional().describe("Comma-separated tags"),
+		tags: stringType().optional().describe("Comma-separated tags for search"),
 		project_path: stringType().optional().describe("Project root path")
 	}, async (params) => {
 		return handleLedger(store, emb, params);

package/dist/{server-CYUJFZhW.mjs → server-zYXME7cg.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { g as writeActiveState, h as verifyReviewFile, l as readActiveState, n as VALID_SLUG, o as filesForSize, r as completeTask, s as init_types, t as SpecDir } from "./types-K2jxpWyU.mjs";
-import { i as listAllEpics, r as init_epic } from "./epic-CfxJ13zy.mjs";
-import { n as init_audit, t as appendAudit } from "./audit-e13xK9Fr.mjs";
+import { g as writeActiveState, h as verifyReviewFile, l as readActiveState, n as VALID_SLUG, o as filesForSize, r as completeTask, s as init_types, t as SpecDir } from "./types-zr3tpkx_.mjs";
+import { i as listAllEpics, r as init_epic } from "./epic-BHZ71Dpf.mjs";
+import { n as init_audit, t as appendAudit } from "./audit-BUfNnVyn.mjs";
 import { a as getKnowledgeStats, d as promoteSubType, l as init_knowledge, o as getPromotionCandidates, p as setKnowledgeEnabled } from "./knowledge-C7rEfFSX.mjs";
 import { n as pairwiseSimilarity, t as init_vectors } from "./vectors-DHZGQ096.mjs";
 import { i as searchKnowledgeFTS, n as expandAliases, r as init_fts } from "./fts-DICqcpG_.mjs";
@@ -2553,8 +2553,7 @@ function createApp(projectPath, store, _emb, version) {
 		"decisions.md",
 		"research.md",
 		"session.md",
-		"bugfix.md",
-		"delta.md"
+		"bugfix.md"
 	]);
 	function enrichTask(task, projPath, projectName) {
 		const detail = {
@@ -2968,11 +2967,7 @@ function createApp(projectPath, store, _emb, version) {
 		const task = state.tasks.find((t) => t.slug === slug);
 		if (!task) return c.json({ error: "task not found" }, 404);
 		if (task.status === "completed") return c.json({ error: "task already completed" }, 400);
-		if ([
-			"M",
-			"L",
-			"XL"
-		].includes(task.size ?? "")) {
+		if (["M", "L"].includes(task.size ?? "")) {
 			if (task.review_status !== "approved") return c.json({ error: `${task.size} spec requires approval before completion` }, 400);
 			const verification = verifyReviewFile(projectPath, slug);
 			if (!verification.valid) return c.json({ error: `review verification failed: ${verification.reason}` }, 400);

package/dist/{session-start-CU4-KivX.mjs → session-start-CBXKeCj1.mjs}

@@ -1,18 +1,21 @@
 #!/usr/bin/env node
 import { n as __esmMin } from "./chunk-CAm0Jl7e.mjs";
-import { c as readActive, l as readActiveState, s as init_types, t as SpecDir } from "./types-K2jxpWyU.mjs";
+import { c as readActive, l as readActiveState, s as init_types, t as SpecDir } from "./types-zr3tpkx_.mjs";
 import { l as init_knowledge, m as upsertKnowledge, n as deleteOrphanKnowledge, s as getRecentDecisions, t as countKnowledge } from "./knowledge-C7rEfFSX.mjs";
 import { n as init_project, t as detectProject } from "./project-DCKke4_Q.mjs";
-import { a as notifyUser, i as init_dispatcher, r as extractSection } from "./dispatcher-BDl_Flyx.mjs";
-import { n as init_directives, o as truncate, r as init_helpers, t as emitDirectives } from "./directives-DfzKzUAL.mjs";
+import { a as notifyUser, i as init_dispatcher, r as extractSection } from "./dispatcher-DcHtDI_E.mjs";
+import { n as init_directives, o as truncate, r as init_helpers, t as emitDirectives } from "./directives-B-imQAUP.mjs";
 import { n as openDefaultCached, t as init_store } from "./store-BffM-bi-.mjs";
-import { l as resetWorkedSlugs, r as init_state } from "./state-Cih-8_Zc.mjs";
+import { d as writeStateJSON, l as resetWorkedSlugs, r as init_state } from "./state-Cih-8_Zc.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 //#region src/hooks/session-start.ts
 async function sessionStart(ev, _signal) {
 	if (!ev.cwd) return;
-	if (existsSync(join(ev.cwd, ".alfred"))) resetWorkedSlugs(ev.cwd);
+	if (existsSync(join(ev.cwd, ".alfred"))) {
+		resetWorkedSlugs(ev.cwd);
+		writeStateJSON(ev.cwd, "spec-prompt.json", {});
+	}
 	let store;
 	try {
 		store = openDefaultCached();

package/dist/{stop-CGv96IQd.mjs → stop-DOflmlLk.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { n as __esmMin } from "./chunk-CAm0Jl7e.mjs";
-import "./types-K2jxpWyU.mjs";
-import { c as countUncheckedTasks, d as init_spec_guard, m as tryReadActiveSpec, n as init_review_gate, r as isGateActive, s as blockStop, u as hasUncheckedSelfReview } from "./review-gate-7Pfe_A-8.mjs";
+import "./types-zr3tpkx_.mjs";
+import { c as countUncheckedTasks, d as init_spec_guard, m as tryReadActiveSpec, n as init_review_gate, r as isGateActive, s as blockStop, u as hasUncheckedSelfReview } from "./review-gate-BpjBk-63.mjs";
 import { c as readWorkedSlugs, r as init_state } from "./state-Cih-8_Zc.mjs";
 //#region src/hooks/stop.ts
 /**

package/dist/{types-K2jxpWyU.mjs → types-zr3tpkx_.mjs}

@@ -6592,23 +6592,20 @@ function detectSize(description) {
 	return "L";
 }
 function filesForSize(size, specType) {
-	if (size === "D") return ["delta.md"];
 	const primary = specType === "bugfix" ? "bugfix.md" : "requirements.md";
 	switch (size) {
-		case "S": return [primary, "tasks.md"];
-		case "M":
-			if (specType === "bugfix") return [
-				primary,
-				"tasks.md",
-				"test-specs.md"
-			];
-			return [
-				primary,
-				"design.md",
-				"tasks.md",
-				"test-specs.md"
-			];
-		default: return [
+		case "S": return [
+			primary,
+			"design.md",
+			"tasks.md"
+		];
+		case "M": return [
+			primary,
+			"design.md",
+			"tasks.md",
+			"test-specs.md"
+		];
+		case "L": return [
 			primary,
 			"design.md",
 			"tasks.md",
@@ -6678,12 +6675,17 @@ function completeTask(projectPath, taskSlug) {
 	const current = effectiveStatus(task.status);
 	if (current === "done") throw new Error(`task "${taskSlug}" is already done`);
 	if (current === "cancelled") throw new Error(`task "${taskSlug}" is cancelled`);
-	task.status = "done";
-	task.completed_at = (/* @__PURE__ */ new Date()).toISOString();
 	if (state.primary === taskSlug) state.primary = state.tasks.find((t) => {
 		const s = effectiveStatus(t.status);
 		return s !== "done" && s !== "cancelled" && t.slug !== taskSlug;
 	})?.slug ?? "";
+	state.tasks = state.tasks.filter((t) => t.slug !== taskSlug);
+	if (state.tasks.length === 0) {
+		try {
+			rmSync(activePath(projectPath));
+		} catch {}
+		return state.primary;
+	}
 	writeActiveState(projectPath, state);
 	return state.primary;
 }
@@ -6858,8 +6860,7 @@ var init_types = __esmMin((() => {
 				"decisions.md",
 				"research.md",
 				"session.md",
-				"bugfix.md",
-				"delta.md"
+				"bugfix.md"
 			];
 			const sections = [];
 			for (const f of allFiles) try {

package/dist/{user-prompt-BPAOU8f-.mjs → user-prompt-vC5iWoT9.mjs}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { n as __esmMin } from "./chunk-CAm0Jl7e.mjs";
-import { l as readActiveState, s as init_types } from "./types-K2jxpWyU.mjs";
+import { l as readActiveState, s as init_types } from "./types-zr3tpkx_.mjs";
 import { a as subTypeBoost, r as init_fts } from "./fts-DICqcpG_.mjs";
 import { Embedder, t as init_embedder } from "./embedder-D3hJoryD.mjs";
-import "./dispatcher-BDl_Flyx.mjs";
-import { a as trackHitCounts, i as searchPipeline, n as init_directives, o as truncate, r as init_helpers, t as emitDirectives } from "./directives-DfzKzUAL.mjs";
+import "./dispatcher-DcHtDI_E.mjs";
+import { a as trackHitCounts, i as searchPipeline, n as init_directives, o as truncate, r as init_helpers, t as emitDirectives } from "./directives-B-imQAUP.mjs";
 import { n as openDefaultCached, t as init_store } from "./store-BffM-bi-.mjs";
 import { a as readStateJSON, c as readWorkedSlugs, d as writeStateJSON, r as init_state } from "./state-Cih-8_Zc.mjs";
 import { existsSync } from "node:fs";
@@ -142,7 +142,7 @@ function classifyIntent(prompt) {
 * FR-5/FR-7: Check if spec is required or unapproved before implementation.
 * Stage 1: No spec exists → DIRECTIVE to create one.
 * Stage 1.5: Spec exists + implement intent → WARNING to confirm or create new spec.
-* Stage 2: Spec exists but not approved (M/L/XL) → DIRECTIVE to get review.
+* Stage 2: Spec exists but not approved (M/L) → DIRECTIVE to get review.
 */
 function checkSpecRequired(cwd, intent) {
 	if (!intent || ![
@@ -155,25 +155,23 @@ function checkSpecRequired(cwd, intent) {
 	try {
 		state = readActiveState(cwd);
 	} catch {
+		if (readStateJSON(cwd, "spec-prompt.json", {}).prompted) return null;
+		const lang = (process.env.ALFRED_LANG || "en").toLowerCase();
+		writeStateJSON(cwd, "spec-prompt.json", {
+			prompted: true,
+			at: (/* @__PURE__ */ new Date()).toISOString()
+		});
 		return {
 			level: "DIRECTIVE",
-			message: "MUST create a spec first via /alfred:brief or dossier action=init before implementing. No active spec found.",
-			rationalizations: [
-				"\"I already have enough context to proceed\" → Specs catch assumptions you don't know you're making",
-				"\"The spec would just restate the request\" → Specs add structure, traceability, and test criteria",
-				"\"Creating a spec would slow things down\" → S-size adds <2min. Bugs from no spec cost hours"
-			],
+			message: lang.startsWith("ja") ? "新しい実装タスクです。AskUserQuestion で「spec を作成しますか？ (S/M/L/スキップ)」とユーザーに確認してください。ユーザーが「スキップ」を選んだ場合、そのまま実装に進んでください。" : "New implementation task. Use AskUserQuestion to ask the user: 'Create a spec? (S/M/L/Skip)'. If the user selects Skip, proceed without a spec.",
+			rationalizations: ["\"I already know what to build\" → A quick S-size spec takes <2min and catches assumptions", "\"The user just wants me to code\" → Ask first. If they say Skip, proceed freely"],
 			spiritVsLetter: true
 		};
 	}
 	try {
 		const taskSlug = state.primary;
 		const task = taskSlug ? state.tasks.find((t) => t.slug === taskSlug) : void 0;
-		if (task && [
-			"M",
-			"L",
-			"XL"
-		].includes(task.size ?? "") && task.review_status !== "approved") return {
+		if (task && ["M", "L"].includes(task.size ?? "") && task.review_status !== "approved") return {
 			level: "DIRECTIVE",
 			message: `Spec '${taskSlug}' (size ${task.size}) requires review approval before implementation. Submit review via \`alfred dashboard\` or run spec self-review first.`,
 			rationalizations: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-alfred",
-  "version": "0.3.21",
+  "version": "0.3.23",
   "type": "module",
   "bin": {
     "alfred": "dist/cli.mjs"