claude-alfred 0.3.2 → 0.3.4

package/README.ja.md

@@ -22,7 +22,7 @@ alfred は3つとも潰す。
 
 **消えない仕様。** 要件、設計、決定、セッション状態 — 構造化されたMarkdownファイルが Compact を跨いで生き残る。コンテキストは一度も失われない。
 
-**適応する仕様。** 小さなバグ修正なら3ファイル。中規模なら5。大規模なら7。タスクに応じてスペックの深さを自動調整。bugfix専用テンプレート（再現手順、原因分析、修正戦略）も。
+**適応する仕様。** 小さなバグ修正なら3ファイル。中規模なら5。大規模なら6。タスクに応じてスペックの深さを自動調整。bugfix専用テンプレート（再現手順、原因分析、修正戦略）も。
 
 **積み重なる記憶。** 「あの時こう決めた」「このバグ前にも見た」「Xは試したけどダメだった」— 全てが `.alfred/knowledge/` に構造化JSONとして保存される。3分類のみ: **decision**（一回きりの選択 + 理由 + 却下した代替案）、**pattern**（繰り返し実践 + 適用条件 + 期待結果）、**rule**（強制ルール + 優先度 + 根拠）。Git フレンドリーで、チームで共有できる。SQLite検索インデックスがセマンティック検索を提供。矛盾は自動検出。次に似た問題に当たったとき、聞く前に alfred が出してくる。
 
@@ -36,7 +36,9 @@ alfred は3つとも潰す。
 
 **能動的スキル提案。** alfred は呼ばれるのを待たない。調査中か、設計中か、実装中か、バグ修正中かを検出し、適切なタイミングで適切なスキルを提案する。コードを探索し続けてる？「`/alfred:survey` 使ったら？」。調査結果が出た？「`ledger` に保存しよう」。タスクが溜まってきた？「`roster` でまとめよう」。
 
-**バイパスできない承認ゲート。** 実装前に仕様のレビューサイクルを回す。ブラウザダッシュボードで任意の行にコメントして、承認か差し戻し — GitHub の PR レビューと同じ体験を、仕様に対してやる。ステータスの手動書き換えでは突破できない。レビューファイルの存在まで検証する。**ハード強制**: PreToolUse フックが未承認 M/L/XL スペックへの Edit/Write を物理的にブロック。Stop フックがタスク完了・セルフレビュー・spec close まで Claude の停止を阻止。
+**バイパスできない承認ゲート。** 実装前に仕様のレビューサイクルを回す。ブラウザダッシュボードで任意の行にコメントして、承認か差し戻し — GitHub の PR レビューと同じ体験を、仕様に対してやる。ステータスの手動書き換えでは突破できない。**3層 enforcement**: (1) review gate が spec/wave レビュー完了まで Edit/Write をブロック、(2) approval gate が未承認 M/L/XL をブロック、(3) intent guard が spec なし実装をブロック。Stop hook はレビューゲート以外ではブロックせず、リマインドのみ。
+
+**リアルタイムナレッジ抽出。** `ledger` で保存した decision は即座に検索可能。設計パターンは spec 更新時に自動抽出。レビューエージェントの指摘（critical/high）はアンチパターンとして自動保存。ナレッジはタスク完了時だけでなく、継続的に蓄積される。
 
 **張り付くプロジェクトコンテキスト。** Steering文書（プロダクトの目的、コード構造、技術スタック）がプロジェクトから自動生成され、すべての仕様に注入される。AIは常にアーキテクチャを理解している。
 
@@ -121,7 +123,7 @@ npm update -g claude-alfred        # CLI、hooks、MCP サーバー、ダッシ
 
 | ツール | 役割 |
 |--------|------|
-| `dossier` | 仕様のライフサイクル管理 — init（サイズ/タイプ指定可）, update, status, switch, complete, delete, history, rollback, review, validate |
+| `dossier` | 仕様のライフサイクル管理 — init, update, status, switch, complete, delete, history, rollback, review, validate, gate（レビューゲート管理） |
 | `roster` | エピック管理 — タスクのグループ化、依存関係、進捗追跡 |
 | `ledger` | ナレッジ — search, save（構造化JSON: decision/pattern/rule）, promote（pattern→rule）, reflect, audit-conventions |
 
@@ -135,8 +137,8 @@ npm update -g claude-alfred        # CLI、hooks、MCP サーバー、ダッシ
 | PreCompact | スナップショット保存 + 決定抽出 + エピック進捗同期 + 調査パターン検出 |
 | UserPromptSubmit | セマンティック検索 + スキルナッジ + **spec承認ゲート**（未承認 M/L/XL に DIRECTIVE） |
 | PostToolUse | エラー検出 + Next Steps 自動チェック + ドリフト検出 + コミット時決定保存 |
-| **PreToolUse** | **ハード強制**: 未承認 M/L/XL スペックへの Edit/Write をブロック。`.alfred/` 編集と Read/Grep は常に許可 |
-| **Stop** | **品質ゲート**: Next Steps 全チェック + Wave セルフレビュー + dossier complete 完了まで停止を阻止 |
+| **PreToolUse** | **3層 enforcement**: (1) review gate（spec/wave レビュー完了まで）、(2) intent guard（spec なし実装ブロック）、(3) approval gate（未承認 M/L/XL）。`.alfred/` 編集は常に許可 |
+| **Stop** | review gate → ブロック。その他 → コンテキストリマインド（ブロックなし） |
 
 ## ブラウザダッシュボード
 
@@ -208,7 +210,7 @@ alfred dashboard --url-only   # URLだけ出力
 |--------|------------|------|
 | **S** | 3: requirements, tasks, session | バグ修正、設定変更、小さな変更 |
 | **M** | 5: + design, test-specs | 新エンドポイント、リファクタ、中規模機能 |
-| **L/XL** | 7: + decisions, research | アーキテクチャ変更、新サブシステム |
+| **L/XL** | 6: + research | アーキテクチャ変更、新サブシステム。Decision は `ledger` で直接保存 |
 | **D** (delta) | 2: delta.md（CHG-N ID + Before/After付き）, session | 既存コードへのブラウンフィールド変更 |
 | **Bugfix** | 3-4: bugfix.md, tasks, session (+test-specs) | 外科的バグ修正（再現手順付き） |
 
@@ -256,8 +258,8 @@ Hook（見えない）
   |-- PreCompact       -> スナップショット保存、決定抽出、エピック進捗
   |-- UserPromptSubmit -> ベクトル検索 + FTS5 + スキルナッジ + spec承認チェック
   |-- PostToolUse      -> エラー検出、Next Steps自動チェック、ドリフト検出
-  |-- PreToolUse       -> 未承認 M/L/XL への Edit/Write をブロック
-  |-- Stop             -> 全タスク完了 + セルフレビュー + complete まで停止阻止
+  |-- PreToolUse       -> review gate + intent guard + approval gate（3層 enforcement）
+  |-- Stop             -> review gate ブロック + コンテキストリマインド（非ブロック）
   |
   v
 ストレージ

package/README.md

@@ -22,7 +22,7 @@ alfred fixes all three.
 
 **Specs that survive.** Requirements, design, decisions, session state — structured markdown files that persist across compacts, sessions, and even project restarts. Your context is never lost.
 
-**Specs that adapt.** Small bug? 3 files. Medium feature? 5. Large system? All 7. alfred auto-detects the right scope — or you can pick a bugfix template with surgical precision (reproduction steps, root cause, fix strategy).
+**Specs that adapt.** Small bug? 3 files. Medium feature? 5. Large system? 6. alfred auto-detects the right scope — or you can pick a bugfix template with surgical precision (reproduction steps, root cause, fix strategy).
 
 **Memory that compounds.** Every decision, every bug fix, every "we tried X and it didn't work" gets stored as structured JSON files in `.alfred/knowledge/` — three types only: **decisions** (one-time choices with reasoning and rejected alternatives), **patterns** (repeatable practices with conditions and expected outcomes), and **rules** (enforceable standards with priority and rationale). Git-friendly, human-readable, team-shareable. A SQLite search index provides semantic search across all knowledge. Contradictions are detected automatically. Next time you hit a similar problem, alfred surfaces the relevant experience — before you even ask.
 
@@ -36,7 +36,9 @@ alfred fixes all three.
 
 **Proactive skill suggestions.** alfred doesn't wait to be asked. It detects what you're doing — researching, designing, implementing, fixing bugs — and suggests the right skill at the right time. Explored code for a while? "Try `/alfred:survey`." Got research findings? "Save them with `ledger`." Three tasks piling up? "Group them with `roster`."
 
-**Approval gates that can't be bypassed.** Specs go through a review cycle before implementation. Comment on any line in the browser dashboard, approve or request changes — like a GitHub PR review, but for your specs. The gate verifies both the review status *and* the existence of a signed review file, so manually editing the status won't get you past it. **Hard enforcement**: PreToolUse hooks physically block Edit/Write operations on unapproved M/L/XL specs. Stop hooks prevent Claude from finishing until all tasks are checked off, self-reviews are done, and the spec is closed.
+**Approval gates that can't be bypassed.** Specs go through a review cycle before implementation. Comment on any line in the browser dashboard, approve or request changes — like a GitHub PR review, but for your specs. The gate verifies both the review status *and* the existence of a signed review file, so manually editing the status won't get you past it. **Three-layer enforcement**: (1) Review gate blocks Edit/Write until spec self-review is completed, (2) Approval gate blocks Edit/Write on unapproved M/L/XL specs, (3) Intent guard blocks implementation without a spec. Stop hook reminds about incomplete items but doesn't block (except for review gates).
+
+**Real-time knowledge extraction.** Decisions saved via `ledger` are immediately searchable. Design patterns extracted from spec components on every update. Review agent findings (critical/high severity) auto-saved as anti-patterns. Knowledge accumulates continuously, not just at task completion.
 
 **Project context that sticks.** Steering documents (product purpose, code structure, tech stack) are auto-generated from your project and injected into every spec. Your AI always knows your architecture.
 
@@ -121,7 +123,7 @@ Run `alfred doctor` to verify both are in sync.
 
 | Tool | Purpose |
 |------|---------|
-| `dossier` | Spec lifecycle — init (with size/type), update, status, switch, complete, delete, history, rollback, review, validate |
+| `dossier` | Spec lifecycle — init (with size/type), update, status, switch, complete, delete, history, rollback, review, validate, gate (review gate management) |
 | `roster` | Epic management — group tasks with dependencies, track progress |
 | `ledger` | Knowledge — search, save (structured JSON: decision/pattern/rule), promote (pattern→rule), reflect, audit-conventions |
 
@@ -135,8 +137,8 @@ Run automatically. You don't touch these.
 | PreCompact | Extracts decisions, saves chapter snapshots, syncs epic progress, detects research patterns |
 | UserPromptSubmit | Semantic search + file context boost + **skill nudge** + **spec approval gate** (blocks implement intent on unapproved M/L/XL specs) |
 | PostToolUse | Detects Bash errors + searches memory. After commits: spec drift detection + auto-save decisions. Edit/Write: auto-check Next Steps progress |
-| **PreToolUse** | **Hard enforcement**: blocks Edit/Write when active M/L/XL spec is not approved. `.alfred/` edits and Read/Grep always allowed |
-| **Stop** | **Quality gate**: blocks Claude from stopping until all Next Steps are checked, Wave self-reviews are done, and `dossier complete` is called |
+| **PreToolUse** | **Three-layer enforcement**: (1) review-gate blocks until spec/wave review done, (2) intent guard blocks implementation without a spec, (3) approval gate blocks unapproved M/L/XL. `.alfred/` edits always allowed |
+| **Stop** | Review gate → block. Other incomplete items → context reminder (no block) |
 
 ## Browser dashboard
 
@@ -208,7 +210,7 @@ Not every task needs 7 spec files.
 |------|----------------|------|
 | **S** (small) | 3: requirements, tasks, session | Bug fix, config change, small tweak |
 | **M** (medium) | 5: + design, test-specs | New endpoint, refactor, moderate feature |
-| **L/XL** (large) | 7: + decisions, research | Architecture change, new subsystem |
+| **L/XL** (large) | 6: + research | Architecture change, new subsystem. Decisions saved via `ledger` directly |
 | **D** (delta) | 2: delta.md (with CHG-N IDs + Before/After), session | Brownfield changes to existing code |
 | **Bugfix** | 3-4: bugfix.md, tasks, session (+ test-specs) | Surgical bug fix with reproduction steps |
 
@@ -256,8 +258,8 @@ Hooks (invisible)
   |-- PreCompact       -> save snapshots, extract decisions, epic progress
   |-- UserPromptSubmit -> vector search + FTS5 + skill nudge + spec approval check
   |-- PostToolUse      -> detect errors, auto-check Next Steps, drift detection
-  |-- PreToolUse       -> BLOCK Edit/Write on unapproved M/L/XL specs
-  |-- Stop             -> BLOCK stop until all tasks done + self-review + complete
+  |-- PreToolUse       -> review-gate + intent guard + approval gate (3-layer enforcement)
+  |-- Stop             -> review-gate block + context reminders (non-blocking)
   |
   v
 Storage

package/dist/audit-g6phLGMg.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { u as rootDir } from "./types-DFsKNXVY.mjs";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+//#region src/spec/audit.ts
+function appendAudit(projectPath, entry) {
+	try {
+		const dir = rootDir(projectPath);
+		mkdirSync(dir, { recursive: true });
+		const line = JSON.stringify({
+			...entry,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		appendFileSync(join(dir, "audit.jsonl"), `${line}\n`);
+	} catch {}
+}
+//#endregion
+export { appendAudit as t };

package/dist/cli.mjs

@@ -369,9 +369,9 @@ const main = defineCommand({
 		serve: defineCommand({
 			meta: { description: "Start MCP server (stdio)" },
 			async run() {
-				const { Store } = await import("./store-CuN3_dWu.mjs");
-				const { Embedder } = await import("./embedder-BRG2Xpr4.mjs");
-				const { serveMCP } = await import("./server-CHdcikXe.mjs");
+				const { Store } = await import("./store-D4fokoGA.mjs");
+				const { Embedder } = await import("./embedder-CFkDPOku.mjs");
+				const { serveMCP } = await import("./server-DjHlrHQd.mjs");
 				const store = Store.openDefault();
 				let emb = null;
 				try {
@@ -397,9 +397,9 @@ const main = defineCommand({
 				}
 			},
 			async run({ args }) {
-				const { Store } = await import("./store-CuN3_dWu.mjs");
-				const { Embedder } = await import("./embedder-BRG2Xpr4.mjs");
-				const { startDashboard } = await import("./server-Df8fib2F.mjs");
+				const { Store } = await import("./store-D4fokoGA.mjs");
+				const { Embedder } = await import("./embedder-CFkDPOku.mjs");
+				const { startDashboard } = await import("./server-BaPbUbPa.mjs");
 				const projectPath = process.cwd();
 				const store = Store.openDefault();
 				let emb = null;
@@ -422,7 +422,7 @@ const main = defineCommand({
 				description: "Event name"
 			} },
 			async run({ args }) {
-				const { runHook } = await import("./dispatcher-BnBtA4bo.mjs").then((n) => n.t);
+				const { runHook } = await import("./dispatcher-DE-9lhIv.mjs").then((n) => n.t);
 				await runHook(args.event);
 			}
 		}),

package/dist/{directives-ko2sX5BW.mjs → directives-DyHIJo9p.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as emitAdditionalContext } from "./dispatcher-BnBtA4bo.mjs";
+import { n as emitAdditionalContext } from "./dispatcher-DE-9lhIv.mjs";
 //#region src/hooks/directives.ts
 const LEVEL_ORDER = {
 	DIRECTIVE: 0,

package/dist/{dispatcher-BnBtA4bo.mjs → dispatcher-DE-9lhIv.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { k as __exportAll } from "./knowledge-B0fsJ9SI.mjs";
+import { g as __exportAll } from "./types-DFsKNXVY.mjs";
 import { resolve } from "node:path";
 //#region src/hooks/dispatcher.ts
 var dispatcher_exports = /* @__PURE__ */ __exportAll({
@@ -89,27 +89,27 @@ async function runHook(event) {
 	}
 }
 async function handleSessionStart(ev, signal) {
-	const { sessionStart } = await import("./session-start-dPl4lfZw.mjs");
+	const { sessionStart } = await import("./session-start-B036zTZK.mjs");
 	await sessionStart(ev, signal);
 }
 async function handlePreCompact(ev, signal) {
-	const { preCompact } = await import("./pre-compact-CwvBi5op.mjs");
+	const { preCompact } = await import("./pre-compact-B2G-Khc9.mjs");
 	await preCompact(ev, signal);
 }
 async function handleUserPromptSubmit(ev, signal) {
-	const { userPromptSubmit } = await import("./user-prompt-o9rlzB2I.mjs");
+	const { userPromptSubmit } = await import("./user-prompt-B-FXw-Q3.mjs");
 	await userPromptSubmit(ev, signal);
 }
 async function handlePostToolUse(ev, signal) {
-	const { postToolUse } = await import("./post-tool-gG8qG5Ee.mjs");
+	const { postToolUse } = await import("./post-tool-Dg6-F0_1.mjs");
 	await postToolUse(ev, signal);
 }
 async function handlePreToolUse(ev, _signal) {
-	const { preToolUse } = await import("./pre-tool-BMCYjtHT.mjs");
+	const { preToolUse } = await import("./pre-tool-BwjDjdA-.mjs");
 	await preToolUse(ev);
 }
 async function handleStop(ev, _signal) {
-	const { stop } = await import("./stop-NL5GdPNy.mjs");
+	const { stop } = await import("./stop-_E6Cn7T8.mjs");
 	await stop(ev);
 }
 //#endregion

package/dist/{audit-6NSlW0Ut.mjs → epic-D9ksT1k7.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { C as rootDir, D as require_dist, h as VALID_SLUG } from "./knowledge-B0fsJ9SI.mjs";
-import { appendFileSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { m as require_dist, n as VALID_SLUG } from "./types-DFsKNXVY.mjs";
+import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 //#region src/epic/index.ts
 var import_dist = require_dist();
@@ -222,17 +222,4 @@ function writeActiveEpics(projectPath, state) {
 	renameSync(tmp, path);
 }
 //#endregion
-//#region src/spec/audit.ts
-function appendAudit(projectPath, entry) {
-	try {
-		const dir = rootDir(projectPath);
-		mkdirSync(dir, { recursive: true });
-		const line = JSON.stringify({
-			...entry,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString()
-		});
-		appendFileSync(join(dir, "audit.jsonl"), `${line}\n`);
-	} catch {}
-}
-//#endregion
-export { nextActionable as a, topologicalOrder as c, listAllEpics as i, unlinkTaskFromAllEpics as l, EpicDir as n, removeEpic as o, initEpic as r, syncTaskStatus as s, appendAudit as t };
+export { removeEpic as a, unlinkTaskFromAllEpics as c, nextActionable as i, initEpic as n, syncTaskStatus as o, listAllEpics as r, topologicalOrder as s, EpicDir as t };

package/dist/{fts-QWdC_4Zv.mjs → fts-Buk8fkl1.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { d as searchKnowledgeKeyword, i as getKnowledgeByIDs, l as mapRow } from "./knowledge-B0fsJ9SI.mjs";
-import { n as deserializeFloat32, t as cosineSimilarity } from "./vectors-BDQP0gaa.mjs";
+import { d as searchKnowledgeKeyword, i as getKnowledgeByIDs, l as mapRow } from "./knowledge-BgWoLpv7.mjs";
+import { n as deserializeFloat32, t as cosineSimilarity } from "./vectors-DtWMZUgk.mjs";
 //#region src/store/fts.ts
 function subTypeHalfLife(subType) {
 	switch (subType) {

package/dist/{helpers-BnPVn8Nv.mjs → helpers-CvI9bVCq.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { c as incrementHitCount, d as searchKnowledgeKeyword, i as getKnowledgeByIDs } from "./knowledge-B0fsJ9SI.mjs";
-import { r as vectorSearchKnowledge } from "./vectors-BDQP0gaa.mjs";
-import { i as subTypeHalfLife, n as searchKnowledgeFTS, r as subTypeBoost } from "./fts-QWdC_4Zv.mjs";
+import { c as incrementHitCount, d as searchKnowledgeKeyword, i as getKnowledgeByIDs } from "./knowledge-BgWoLpv7.mjs";
+import { r as vectorSearchKnowledge } from "./vectors-DtWMZUgk.mjs";
+import { i as subTypeHalfLife, n as searchKnowledgeFTS, r as subTypeBoost } from "./fts-Buk8fkl1.mjs";
 //#region src/mcp/helpers.ts
 const RECENCY_FLOOR = .5;
 function truncate(s, maxLen) {

package/dist/knowledge-BgWoLpv7.mjs

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+import { createHash } from "node:crypto";
+//#region src/store/knowledge.ts
+function contentHash(content) {
+	return createHash("sha256").update(content).digest("hex");
+}
+function upsertKnowledge(store, row) {
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	if (!row.createdAt) row.createdAt = now;
+	row.updatedAt = now;
+	row.contentHash = contentHash(row.content);
+	const existing = store.db.prepare("SELECT id, content_hash FROM knowledge_index WHERE project_remote = ? AND project_path = ? AND file_path = ?").get(row.projectRemote, row.projectPath, row.filePath);
+	if (existing && existing.content_hash === row.contentHash) {
+		row.id = existing.id;
+		return {
+			id: existing.id,
+			changed: false
+		};
+	}
+	const result = store.db.prepare(`
+    INSERT INTO knowledge_index
+    (file_path, content_hash, title, content, sub_type,
+     project_remote, project_path, project_name, branch,
+     created_at, updated_at, hit_count, last_accessed, enabled)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, '', 1)
+    ON CONFLICT(project_remote, project_path, file_path) DO UPDATE SET
+     content_hash = excluded.content_hash,
+     title = excluded.title,
+     content = excluded.content,
+     sub_type = excluded.sub_type,
+     project_name = excluded.project_name,
+     branch = excluded.branch,
+     updated_at = excluded.updated_at
+  `).run(row.filePath, row.contentHash, row.title, row.content, row.subType, row.projectRemote, row.projectPath, row.projectName, row.branch, row.createdAt, row.updatedAt);
+	const id = Number(result.lastInsertRowid);
+	row.id = id;
+	return {
+		id,
+		changed: true
+	};
+}
+function getKnowledgeByID(store, id) {
+	const row = store.db.prepare(`
+    SELECT id, file_path, content_hash, title, content, sub_type,
+           project_remote, project_path, project_name, branch,
+           created_at, updated_at, hit_count, last_accessed, enabled
+    FROM knowledge_index WHERE id = ?
+  `).get(id);
+	return row ? mapRow(row) : void 0;
+}
+function getKnowledgeByIDs(store, ids) {
+	if (ids.length === 0) return [];
+	const placeholders = ids.map(() => "?").join(",");
+	return store.db.prepare(`
+    SELECT id, file_path, content_hash, title, content, sub_type,
+           project_remote, project_path, project_name, branch,
+           created_at, updated_at, hit_count, last_accessed, enabled
+    FROM knowledge_index WHERE id IN (${placeholders})
+  `).all(...ids).map(mapRow);
+}
+function setKnowledgeEnabled(store, id, enabled) {
+	store.db.prepare("UPDATE knowledge_index SET enabled = ? WHERE id = ?").run(enabled ? 1 : 0, id);
+}
+function incrementHitCount(store, ids) {
+	if (ids.length === 0) return;
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const placeholders = ids.map(() => "?").join(",");
+	store.db.prepare(`UPDATE knowledge_index SET hit_count = hit_count + 1, last_accessed = ?
+     WHERE id IN (${placeholders})`).run(now, ...ids);
+}
+function promoteSubType(store, id, newSubType) {
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	if (store.db.prepare("UPDATE knowledge_index SET sub_type = ?, updated_at = ? WHERE id = ? AND enabled = 1").run(newSubType, now, id).changes === 0) throw new Error(`store: promote sub_type: knowledge ${id} not found or disabled`);
+}
+function getPromotionCandidates(store) {
+	return store.db.prepare(`
+    SELECT id, file_path, content_hash, title, content, sub_type,
+           project_remote, project_path, project_name, branch,
+           created_at, updated_at, hit_count, last_accessed, enabled
+    FROM knowledge_index
+    WHERE enabled = 1
+      AND (sub_type = 'pattern' AND hit_count >= 15)
+    ORDER BY hit_count DESC
+  `).all().map(mapRow);
+}
+function getKnowledgeStats(store) {
+	const agg = store.db.prepare("SELECT COUNT(*) as total, COALESCE(AVG(hit_count), 0) as avg_hits FROM knowledge_index WHERE enabled = 1").get();
+	const bySubType = {};
+	const subtypeRows = store.db.prepare("SELECT sub_type, COUNT(*) as cnt FROM knowledge_index WHERE enabled = 1 GROUP BY sub_type").all();
+	for (const r of subtypeRows) bySubType[r.sub_type] = r.cnt;
+	const topRows = store.db.prepare(`
+    SELECT id, file_path, content_hash, title, content, sub_type,
+           project_remote, project_path, project_name, branch,
+           created_at, updated_at, hit_count, last_accessed, enabled
+    FROM knowledge_index WHERE enabled = 1
+    ORDER BY hit_count DESC LIMIT 5
+  `).all();
+	return {
+		total: agg?.total ?? 0,
+		avgHitCount: agg?.avg_hits ?? 0,
+		bySubType,
+		topAccessed: topRows.map(mapRow)
+	};
+}
+function searchKnowledgeKeyword(store, query, limit) {
+	const escaped = escapeLIKEContains(query);
+	return store.db.prepare(`
+    SELECT id, file_path, content_hash, title, content, sub_type,
+           project_remote, project_path, project_name, branch,
+           created_at, updated_at, hit_count, last_accessed, enabled
+    FROM knowledge_index
+    WHERE enabled = 1 AND (content LIKE ? ESCAPE '\\' OR title LIKE ? ESCAPE '\\')
+    ORDER BY hit_count DESC LIMIT ?
+  `).all(escaped, escaped, limit).map(mapRow);
+}
+function getRecentDecisions(store, projectRemote, projectPath, sinceISO, limit) {
+	return store.db.prepare(`
+    SELECT title, content, created_at FROM knowledge_index
+    WHERE sub_type = 'decision'
+      AND project_remote = ? AND project_path = ?
+      AND created_at > ? AND enabled = 1
+    ORDER BY created_at DESC LIMIT ?
+  `).all(projectRemote, projectPath, sinceISO, limit).map((r) => ({
+		title: r.title,
+		content: r.content,
+		createdAt: r.created_at
+	}));
+}
+function deleteOrphanKnowledge(store, projectRemote, projectPath, branch, validFilePaths) {
+	const rows = store.db.prepare("SELECT id, file_path FROM knowledge_index WHERE project_remote = ? AND project_path = ? AND branch = ?").all(projectRemote, projectPath, branch);
+	let deleted = 0;
+	const delEmbed = store.db.prepare("DELETE FROM embeddings WHERE source = 'knowledge' AND source_id = ?");
+	const delKnowledge = store.db.prepare("DELETE FROM knowledge_index WHERE id = ?");
+	store.db.transaction(() => {
+		for (const row of rows) if (!validFilePaths.has(row.file_path)) {
+			delEmbed.run(row.id);
+			delKnowledge.run(row.id);
+			deleted++;
+		}
+	})();
+	return deleted;
+}
+function countKnowledge(store, projectRemote, projectPath) {
+	return store.db.prepare("SELECT COUNT(*) as cnt FROM knowledge_index WHERE project_remote = ? AND project_path = ? AND enabled = 1").get(projectRemote, projectPath).cnt;
+}
+function escapeLIKEContains(s) {
+	s = s.replaceAll("\\", "\\\\");
+	s = s.replaceAll("%", "\\%");
+	s = s.replaceAll("_", "\\_");
+	return `%${s}%`;
+}
+function mapRow(r) {
+	return {
+		id: r.id,
+		filePath: r.file_path,
+		contentHash: r.content_hash,
+		title: r.title,
+		content: r.content,
+		subType: r.sub_type,
+		projectRemote: r.project_remote,
+		projectPath: r.project_path,
+		projectName: r.project_name,
+		branch: r.branch,
+		createdAt: r.created_at,
+		updatedAt: r.updated_at,
+		hitCount: r.hit_count,
+		lastAccessed: r.last_accessed,
+		enabled: r.enabled === 1
+	};
+}
+//#endregion
+export { getKnowledgeStats as a, incrementHitCount as c, searchKnowledgeKeyword as d, setKnowledgeEnabled as f, getKnowledgeByIDs as i, mapRow as l, deleteOrphanKnowledge as n, getPromotionCandidates as o, upsertKnowledge as p, getKnowledgeByID as r, getRecentDecisions as s, countKnowledge as t, promoteSubType as u };