검색 hit / RAG citation 에 indexed_at + stale 두 wire 필드 추가.
documents.updated_at 재활용 (V006 incremental ingest 가 자연 source-of-truth).
config [search] stale_threshold_days = 30 default. additive minor wire.
TUI Warning role / CLI plain [stale] tag / agent --json 동시 surface.
자동 재 ingest 는 out of scope.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

@@ -194,0 +195,4 @@
+            // and an older threshold; if either has shifted (config
+            // reload, time passing) the cached `stale: false` may now
+            // be wrong. Re-stamping is cheap (per-hit comparison) and
+            // avoids invalidating the cache on threshold changes.

@@ -0,0 +10,4 @@
+///
+/// p9-fb-32: mirrored in `kebab_rag::pipeline::compute_stale` (dep-boundary
+/// rule prevents `kebab-rag → kebab-app`). Update both together.
+pub fn compute_stale(

@@ -0,0 +67,4 @@
+temperature = 0.0
+seed = 0
+
+[search]

@@ -984,0 +1016,4 @@
+    }
+
+    #[test]
+    fn negative_stale_threshold_rejected_at_validation() {

@@ -47,0 +50,4 @@
+/// LLM-citation construction site can build a complete
+/// [`kebab_core::AnswerCitation`] (p9-fb-32).
+#[derive(Clone, Debug)]
+struct PackedCitation {

@@ -628,0 +687,4 @@
+    }
+    let threshold = time::Duration::days(i64::from(threshold_days));
+    (now - indexed_at) > threshold
+}

@@ -404,1 +418,4 @@
         chunker_version: ChunkerVersion(raw.chunker_version),
+        indexed_at,
+        // Placeholder — App layer overwrites against config threshold (Task 6).
+        stale: false,

@@ -105,2 +123,4 @@
     let mut lines: Vec<Line> = Vec::new();
     // Header
+    let now = time::OffsetDateTime::now_utc();
+    let stale = kebab_app::compute_stale(doc.metadata.updated_at, now, threshold_days);

@@ -17,3 +17,3 @@
     "retrieval",
     "index_version",
-    "chunker_version"
+    "chunker_version",

@@ -102,6 +102,7 @@ Claude Code spawns `kebab mcp` at session start; the process stays alive across
 - `search` output can be large for broad queries. Project relevant fields when summarizing — for CLI: `jq '.[] | {rank, doc_path, heading: .heading_path[-1], snippet}'`.
 - `ask`'s `citations[]` mirrors `search_hit.v1` minus retrieval internals — same `doc_path` / `citation` shape.
 - Schema reference lives in the kebab repo at `docs/wire-schema/v1/*.schema.json` if a field is unclear.
+- `search_hit.v1` and `answer.v1.citations[]` carry `indexed_at` (RFC3339) + `stale` (bool). When `stale == true`, the source doc hasn't been re-processed since `config.search.stale_threshold_days`. Surface this caveat to the user when summarizing — the cited snapshot may not reflect current reality.

@@ -1030,0 +1095,4 @@
+        // under test — this isolates the failure to the negative
+        // value rather than missing required sections.
+        let cfg = Config::defaults();
+        let mut toml_text = toml::to_string(&cfg).expect("default round-trips");

@@ -14,6 +14,20 @@ historical contract that was implemented; this file accumulates the
 deltas so phase 5+ readers can find the live behavior without diffing
 git history.
 
+## 2026-05-09 — fb-32: search_hit.v1 / citation.v1 required-field expansion

@@ -16,2 +16,3 @@
 
-> ⏳ **백로그 only — 미구현.** 본 spec 은 도그푸딩 피드백 skeleton. 구현 착수 전 [superpowers:brainstorming](../../docs/superpowers/) 으로 설계 단계 선행 필요. stale threshold 정책 / "stale" 정의 (ingest 시점 vs file mtime) / wire schema 필드 위치 brainstorm 후 확정.
+상세 설계: `docs/superpowers/specs/2026-05-08-p9-fb-32-stale-doc-indicator-design.md`.
+구현 계획: `docs/superpowers/plans/2026-05-09-p9-fb-32-stale-doc-indicator.md`.

@@ -1030,0 +1096,4 @@
+        // value rather than missing required sections.
+        let cfg = Config::defaults();
+        let mut toml_text = toml::to_string(&cfg).expect("default round-trips");
+        assert!(

@@ -14,6 +14,20 @@ historical contract that was implemented; this file accumulates the
 deltas so phase 5+ readers can find the live behavior without diffing
 git history.
 
+## 2026-05-09 — p9-fb-32: search_hit.v1 / citation.v1 required-field expansion

@@ -15,3 +15,3 @@
 # p9-fb-32 — Stale doc indicator
 
-> ⏳ **백로그 only — 미구현.** 본 spec 은 도그푸딩 피드백 skeleton. 구현 착수 전 [superpowers:brainstorming](../../docs/superpowers/) 으로 설계 단계 선행 필요. stale threshold 정책 / "stale" 정의 (ingest 시점 vs file mtime) / wire schema 필드 위치 brainstorm 후 확정.
+> ✅ **구현 완료.** 본 spec 은 구현 시점의 frozen 상태. post-merge deviation (특히 search_hit.v1 / citation.v1 의 required-field 확장) 은 [HOTFIXES.md](../HOTFIXES.md) 의 `2026-05-09 — p9-fb-32` 항목 참조 — live source of truth.