@easysociable/cli 0.1.5 → 0.1.6

package/content-engine/workbench/template.html

@@ -164,6 +164,7 @@
     .row[data-kind="swipe"] .stripe { background: #c4a06a; }
     .row[data-kind="atom"] .stripe { background: #a78bb0; }
     .row[data-kind="claim"] .stripe { background: #d08a78; }
+    .row[data-kind="hit"] .stripe { background: #6b8f9e; }
     .row[data-kind="run"] .stripe { background: #8aa87a; }
     .row[data-kind="profile"] .stripe { background: #8b6b4a; }
     .row[data-kind="account"] .stripe { background: #5c6b7a; }
@@ -189,6 +190,107 @@
     .heat-chip.empty { opacity: .55; font-weight: 400; }
     .heat-note { font-size: 11px; color: var(--faint); margin: 6px 0 0; }
     .insp .heat { margin: 0 0 14px; }
+    .kw-filter { margin: 0 0 12px; display: flex; flex-direction: column; gap: 8px; }
+    .kw-filter-row { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; }
+    .kw-search {
+      position: relative;
+      flex: 1 1 180px;
+      min-width: 160px;
+      max-width: 320px;
+    }
+    .kw-search::before {
+      content: ""; position: absolute; left: 12px; top: 50%; width: 12px; height: 12px;
+      margin-top: -7px; border: 1.5px solid var(--faint); border-radius: 50%;
+      pointer-events: none;
+    }
+    .kw-search::after {
+      content: ""; position: absolute; left: 22px; top: 50%; width: 6px; height: 1.5px;
+      margin-top: 3px; background: var(--faint); transform: rotate(45deg);
+      pointer-events: none;
+    }
+    .kw-search input[type="search"] {
+      width: 100%;
+      background: var(--paper);
+      border: 1px solid var(--line);
+      color: var(--text);
+      border-radius: 999px;
+      padding: 8px 14px 8px 32px;
+      font: inherit;
+      font-size: 13px;
+      outline: none;
+      box-shadow: inset 0 1px 0 rgba(255, 250, 240, .55);
+      transition: border-color .15s ease, box-shadow .15s ease;
+      -webkit-appearance: none;
+      appearance: none;
+    }
+    .kw-search input[type="search"]::placeholder { color: var(--faint); }
+    .kw-search input[type="search"]::-webkit-search-decoration,
+    .kw-search input[type="search"]::-webkit-search-cancel-button { -webkit-appearance: none; }
+    .kw-search input[type="search"]:hover { border-color: color-mix(in srgb, var(--line) 40%, var(--accent-dim)); }
+    .kw-search input[type="search"]:focus {
+      border-color: var(--accent-dim);
+      box-shadow: inset 0 1px 0 rgba(255, 250, 240, .55), 0 0 0 3px color-mix(in srgb, var(--accent) 16%, transparent);
+    }
+    .kw-quick { display: flex; flex-wrap: wrap; gap: 6px; align-items: center; width: 100%; }
+    .kw-quick .kw-chip.on { background: var(--accent); color: #fff; border-color: var(--accent); }
+    .kw-active {
+      display: flex; flex-wrap: wrap; gap: 8px; align-items: baseline;
+      border: 1px solid var(--line); background: var(--bg-2);
+      border-radius: 10px; padding: 8px 10px; font-size: 12px;
+    }
+    .kw-active .kid {
+      font-family: ui-monospace, "SF Mono", Menlo, monospace;
+      color: var(--accent); font-weight: 600;
+    }
+    .kw-active .why { color: var(--text); flex: 1 1 180px; }
+    .kw-active .meta { color: var(--muted); }
+    .kw-active .clear {
+      border: 0; background: transparent; color: var(--muted); cursor: pointer; font: inherit; font-size: 12px;
+    }
+    .kw-active .clear:hover { color: var(--text); }
+    .kw-chip {
+      display: inline-flex; align-items: center; gap: 4px;
+      font-family: ui-monospace, "SF Mono", Menlo, monospace;
+      font-size: 11px; padding: 3px 8px; border-radius: 999px;
+      border: 1px solid var(--line); background: var(--bg-3); color: var(--accent);
+      cursor: pointer;
+    }
+    .kw-chip .n { font-family: inherit; color: var(--muted); font-weight: 600; }
+    .kw-chip.on .n { color: rgba(255,255,255,.85); }
+    .kw-chip:hover { border-color: var(--accent); }
+    .kw-catalog-grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+      gap: 10px;
+      margin-top: 12px;
+    }
+    .kw-catalog-card {
+      border: 1px solid var(--line); background: var(--bg-2);
+      border-radius: 12px; padding: 12px; text-align: left; color: inherit;
+      cursor: pointer; display: flex; flex-direction: column; gap: 6px;
+    }
+    .kw-catalog-card:hover { border-color: var(--accent); }
+    .kw-catalog-card .kid {
+      font-family: ui-monospace, "SF Mono", Menlo, monospace;
+      font-size: 12px; color: var(--accent); font-weight: 600;
+    }
+    .kw-catalog-card .meta { font-size: 11px; color: var(--muted); }
+    .kw-catalog-card .query {
+      font-family: ui-monospace, "SF Mono", Menlo, monospace;
+      font-size: 12px; color: var(--text); line-height: 1.4;
+      word-break: break-word;
+    }
+    .kw-catalog-card .why { font-size: 12px; color: var(--muted); line-height: 1.35; }
+    .kw-catalog-card .count { font-size: 11px; color: var(--faint); margin-top: auto; }
+    .kw-active .query {
+      font-family: ui-monospace, "SF Mono", Menlo, monospace;
+      font-size: 12px; color: var(--text); flex: 1 1 220px; word-break: break-word;
+    }
+    .kw-catalog-card .count b { color: var(--text); }
+    .kw-catalog-card .go {
+      font-size: 11px; color: var(--accent); border: 0; background: transparent;
+      padding: 0; cursor: pointer; text-align: left; font: inherit;
+    }
     .row .id {
       font-family: ui-monospace, "SF Mono", Menlo, monospace;
       font-size: 11px; color: var(--accent); letter-spacing: .02em;
@@ -623,18 +725,44 @@
   </div>
   <script>
     const GRAPH = /*__GRAPH__*/null;
-    const TRACE_ORDER = ["raw", "capture", "need", "product", "recommendation", "topic", "swipe", "atom", "claim", "run", "published"];
+    const TRACE_ORDER = ["raw", "capture", "hit", "need", "product", "recommendation", "topic", "swipe", "atom", "claim", "run", "published"];
     const STR = {
       zh: {
         title: "Content Engine · 观察台",
         brand: "观察台",
         search: "搜索 ID、一句话、来源…",
-        overview: "总览", needs: "需求库", products: "产品库", recommendations: "推荐库", topics: "选题库", notes: "记录与知识", runs: "Run 档案", pub: "发布与复盘",
+        overview: "总览", needs: "需求库", hits: "Hits", products: "产品库", recommendations: "推荐库", topics: "选题库", notes: "记录与知识", runs: "Run 档案", pub: "发布与复盘",
         notes_in: "记下的", notes_needs: "需求原话", notes_lib: "进库的",
         lead: "先认 IP，再看库存。",
-        kpi_cap: "记下的", kpi_needs: "需求", kpi_lib: "进库的", kpi_topics: "选题", kpi_out: "下场",
+        kpi_cap: "记下的", kpi_needs: "需求", kpi_hits: "Hits", kpi_lib: "进库的", kpi_topics: "选题", kpi_out: "下场",
         kpi_cap_sub: "Capture", kpi_needs_sub: "Needs 原话", kpi_lib_sub: "Swipe / Atom / Claim",
         kpi_topics_sub: "{n} 条 ready 未开单", kpi_out_sub: "Run / 已发帖",
+        kpi_hits_sub: "待分流 triage",
+        no_hit: "尚无 Hits",
+        no_keyword: "尚无 active 关键词",
+        hit_empty_hint: "对 Agent 说「扫关键词」写入 triage。路由后才会进 Needs 或 Library。",
+        gap_hits_n: "Hits 待分流 {n}",
+        f_signal: "信号",
+        f_hit_kind: "类型",
+        f_keyword: "关键词",
+        kw_search: "搜 K- / why…",
+        kw_triage: "待分流",
+        kw_hits: "命中",
+        kw_clear: "清除",
+        hits_sub_list: "命中",
+        hits_sub_catalog: "关键词",
+        kw_catalog_search: "搜全部关键词…",
+        kw_catalog_empty: "无匹配关键词",
+        kw_open_hits: "查看命中",
+        kw_track_all: "全部轨",
+        kw_track_listen: "listen 社交",
+        kw_track_search: "search SEO",
+        kw_track_ask: "ask GEO",
+        kw_vol: "量",
+
+        kw_catalog_count: "共 {n} 条",
+        doc_keywords: "Keywords",
+        doc_handles: "Handles",
         ip_section: "IP · Profiles",
         ip_all: "全部 Profile",
         ip_accounts: "账号 {n}",
@@ -648,11 +776,13 @@
         gap_needs_n: "需求原话未选题 {n}",
         gap_lib_n: "Capture 未入库 {n}",
         gap_review_n: "已发但无法复盘 {n}",
-        topics_lead: "选题必须有明确输入：need / inbox / user / product / recommendation。没有 Discovery 中间层；来源热度不是选题。",
         kv_lane: "Lane",
         kv_mode: "生成路径",
         kv_needs: "需求",
         kv_recs: "推荐对象",
+        kv_signal: "信号",
+        kv_hit_kind: "命中类型",
+        kv_hit_source: "来源配方",
         kv_profile: "Profile",
         kind_profile: "Profile", kind_account: "账号",
         profile_pillars: "支柱",
@@ -738,7 +868,7 @@
         thin_warn: "数据不足：result 不是 win / flat / loss，不画趋势。",
         topic_bind: "选题绑定：{t} · swipe {s} · claim {c}",
         supersedes: "取代 {id}", superseded_by: "被取代 {id}",
-        kind_raw: "Raw", kind_capture: "Capture", kind_need: "需求", kind_product: "产品", kind_recommendation: "推荐对象", kind_topic: "选题", kind_swipe: "Swipe",
+        kind_raw: "Raw", kind_capture: "Capture", kind_hit: "Hit", kind_need: "需求", kind_product: "产品", kind_recommendation: "推荐对象", kind_topic: "选题", kind_swipe: "Swipe",
         kind_atom: "Atom", kind_claim: "Claim", kind_run: "Run", kind_published: "发布",
         kv_kind: "类型", kv_date: "日期", kv_status: "状态", kv_plat: "平台", kv_score: "分数", kv_relevance: "关联度", kv_ownership: "归属度", kv_product_relevance: "产品关联",
         kv_use: "使用", kv_src: "来源", kv_result: "结果", kv_pillar: "支柱",
@@ -750,12 +880,38 @@
         title: "Content Engine · Observatory",
         brand: "Observatory",
         search: "Search ID, one-liner, source…",
-        overview: "Overview", needs: "Needs", products: "Products", recommendations: "Recommendations", topics: "Topics", notes: "Notes & library", runs: "Run files", pub: "Shipped & review",
+        overview: "Overview", needs: "Needs", hits: "Hits", products: "Products", recommendations: "Recommendations", topics: "Topics", notes: "Notes & library", runs: "Run files", pub: "Shipped & review",
         notes_in: "Captured", notes_needs: "Needs", notes_lib: "Catalog",
         lead: "Pick an IP, then inspect the stock.",
-        kpi_cap: "Captured", kpi_needs: "Needs", kpi_lib: "Catalog", kpi_topics: "Topics", kpi_out: "Outcomes",
+        kpi_cap: "Captured", kpi_needs: "Needs", kpi_hits: "Hits", kpi_lib: "Catalog", kpi_topics: "Topics", kpi_out: "Outcomes",
         kpi_cap_sub: "Capture", kpi_needs_sub: "Audience quotes", kpi_lib_sub: "Swipe / Atom / Claim",
         kpi_topics_sub: "{n} ready, never opened as a run", kpi_out_sub: "Runs / shipped URLs",
+        kpi_hits_sub: "awaiting triage",
+        no_hit: "No hits yet",
+        no_keyword: "No active keywords",
+        hit_empty_hint: "Ask the Agent to scan keywords. Hits stay in triage until you route them.",
+        gap_hits_n: "{n} hits awaiting triage",
+        f_signal: "Signal",
+        f_hit_kind: "Kind",
+        f_keyword: "Keyword",
+        kw_search: "Search K- / why…",
+        kw_triage: "triage",
+        kw_hits: "hits",
+        kw_clear: "Clear",
+        hits_sub_list: "Hits",
+        hits_sub_catalog: "Keywords",
+        kw_catalog_search: "Search all keywords…",
+        kw_catalog_empty: "No matching keywords",
+        kw_open_hits: "View hits",
+        kw_track_all: "All tracks",
+        kw_track_listen: "listen",
+        kw_track_search: "search SEO",
+        kw_track_ask: "ask GEO",
+        kw_vol: "vol",
+
+        kw_catalog_count: "{n} total",
+        doc_keywords: "Keywords",
+        doc_handles: "Handles",
         ip_section: "IP · Profiles",
         ip_all: "All profiles",
         ip_accounts: "{n} account(s)",
@@ -769,11 +925,13 @@
         gap_needs_n: "{n} needs not yet in a topic",
         gap_lib_n: "{n} captures not ingested",
         gap_review_n: "{n} shipped posts not reviewable",
-        topics_lead: "Topics need an explicit input: need, inbox, user, product, or recommendation. No Discovery layer; source heat is not a topic.",
         kv_lane: "Lane",
         kv_mode: "Generation mode",
         kv_needs: "Needs",
         kv_recs: "Recommendations",
+        kv_signal: "Signal",
+        kv_hit_kind: "Hit kind",
+        kv_hit_source: "Source recipe",
         kv_profile: "Profile",
         kind_profile: "Profile", kind_account: "Account",
         profile_pillars: "Pillars",
@@ -859,7 +1017,7 @@
         thin_warn: "Too thin to review: result is not win / flat / loss. No chart.",
         topic_bind: "Topic: {t} · swipe {s} · claim {c}",
         supersedes: "supersedes {id}", superseded_by: "superseded by {id}",
-        kind_raw: "Raw", kind_capture: "Capture", kind_need: "Need", kind_product: "Product", kind_recommendation: "Recommendation", kind_topic: "Topic", kind_swipe: "Swipe",
+        kind_raw: "Raw", kind_capture: "Capture", kind_hit: "Hit", kind_need: "Need", kind_product: "Product", kind_recommendation: "Recommendation", kind_topic: "Topic", kind_swipe: "Swipe",
         kind_atom: "Atom", kind_claim: "Claim", kind_run: "Run", kind_published: "Shipped",
         kv_kind: "Kind", kv_date: "Date", kv_status: "Status", kv_plat: "Platform", kv_score: "Score", kv_relevance: "Relevance", kv_ownership: "Ownership", kv_product_relevance: "Product relevance",
         kv_use: "Use", kv_src: "Source", kv_result: "Result", kv_pillar: "Pillar",
@@ -957,6 +1115,15 @@
     let topicSrc = "";
     let topicUsage = "";
     let capIngest = "";
+    let hitKw = "";
+    let hitKwQ = "";
+    let hitSt = "";
+    let hitSig = "";
+    let hitsSub = "list"; // list = 命中 · catalog = 关键词
+    let kwCatalogQ = "";
+    let kwCatalogTrack = ""; // "" | listen | search | ask
+
+    const KW_TRACKS = ["listen", "search", "ask"];
     const TOPIC_SOURCES = ["need", "inbox", "user", "product", "recommendation"];
     let selected = null;
     const $list = document.getElementById("list");
@@ -1302,7 +1469,7 @@
       sel.innerHTML = `<option value="">${t("ip_all")}</option>` +
         ids.map(id => `<option value="${id}" ${id === profileScope ? "selected" : ""}>${id}</option>`).join("");
       tabs.innerHTML = "";
-      for (const id of ["overview", "needs", "products", "recommendations", "topics", "notes", "runs", "pub"]) {
+      for (const id of ["overview", "hits", "needs", "products", "recommendations", "topics", "notes", "runs", "pub"]) {
         const b = document.createElement("button");
         b.textContent = t(id);
         b.dataset.view = id;
@@ -1362,7 +1529,7 @@
     function qmatch(n) {
       const q = $q.value.trim().toLowerCase();
       if (!q) return true;
-      const blob = [n.ident, n.label, n.kind, n.status, n.pillar, n.lane, n.generation_mode, n.profile, n.profiles, n.src_handle, n.url, n.notes, n.type, n.atom_type, n.topic_id, n.audience, n.need_ids, n.product_ids, n.product_fit, n.recommendation_ids, n.source_type, n.capture_id].filter(Boolean).join(" ").toLowerCase();
+      const blob = [n.ident, n.label, n.kind, n.status, n.pillar, n.lane, n.generation_mode, n.profile, n.profiles, n.src_handle, n.url, n.notes, n.type, n.atom_type, n.topic_id, n.audience, n.need_ids, n.product_ids, n.product_fit, n.recommendation_ids, n.source_type, n.capture_id, n.source, n.keyword_id, n.hit_kind, n.signal, n.excerpt].filter(Boolean).join(" ").toLowerCase();
       return blob.includes(q);
     }
     function connected(id) {
@@ -1491,6 +1658,14 @@
         if (n.source_type) bits.push(`<span class="pill">${esc(n.source_type)}</span>`);
         if (n.frequency) bits.push(`<span class="pill">×${esc(n.frequency)}</span>`);
       }
+      if (n.kind === "hit") {
+        const st = n.status || "";
+        const cls = st === "triage" ? "gap" : (st === "discarded" ? "" : "ok");
+        if (st) bits.push(`<span class="pill ${cls}">${esc(st)}</span>`);
+        if (n.keyword_id) bits.push(`<button type="button" class="kw-chip" data-kw-filter="${esc(n.keyword_id)}">${esc(n.keyword_id)}</button>`);
+        if (n.signal) bits.push(`<span class="pill">${esc(n.signal)}</span>`);
+        if (n.hit_kind) bits.push(`<span class="pill">${esc(n.hit_kind)}</span>`);
+      }
       if (n.kind === "topic") {
         bits.push(`<span class="pill">${esc(n.status)}</span>`);
         if (n.source_type) bits.push(`<span class="pill">${esc(n.source_type)}</span>`);
@@ -1535,6 +1710,7 @@
       for (const b of tabs.querySelectorAll("button")) b.classList.toggle("on", b.dataset.view === view);
       if (view === "overview") renderOverview();
       if (view === "needs") renderNeeds();
+      if (view === "hits") renderHits();
       if (view === "products") renderProducts();
       if (view === "recommendations") renderRecommendations();
       if (view === "topics") renderTopics();
@@ -1569,6 +1745,299 @@
       renderNeedsList($list);
     }
 
+    function keywordsInScope(opts = {}) {
+      const all = GRAPH.keywords || [];
+      let rows = profileScope
+        ? all.filter(k => k.profile === profileScope)
+        : all.slice();
+      if (opts.activeOnly !== false) rows = rows.filter(k => k.status === "active" || !k.status);
+      if (opts.track) rows = rows.filter(k => (k.track || "listen") === opts.track);
+      return rows;
+    }
+    function listenKeywordsInScope() {
+      return keywordsInScope({ track: "listen" });
+    }
+    function hitCountForKeyword(kid) {
+      return nodesOf("hit").filter(h => h.keyword_id === kid).length;
+    }
+    function triageCountForKeyword(kid) {
+      return nodesOf("hit").filter(h => h.keyword_id === kid && h.status === "triage").length;
+    }
+    function keywordMatchesQuery(k, q) {
+      if (!q) return true;
+      const blob = [k.id, k.why, k.query, k.intent, k.layer, k.pillar].filter(Boolean).join(" ").toLowerCase();
+      return blob.includes(q);
+    }
+    function rankedKeywords(opts = {}) {
+      const base = opts.forHits ? listenKeywordsInScope() : keywordsInScope({ activeOnly: false, track: opts.track || "" });
+      return base
+        .map(k => ({
+          ...k,
+          track: k.track || "listen",
+          triage: triageCountForKeyword(k.id),
+          total: hitCountForKeyword(k.id),
+        }))
+        .sort((a, b) => (b.triage - a.triage) || (b.total - a.total) || (Number(b.weight || 0) - Number(a.weight || 0)));
+    }
+    function keywordById(kid) {
+      return (GRAPH.keywords || []).find(k => k.id === kid && (!profileScope || k.profile === profileScope))
+        || (GRAPH.keywords || []).find(k => k.id === kid)
+        || null;
+    }
+    function keywordIdNum(id) {
+      const m = String(id || "").match(/K-(\d+)/i);
+      return m ? Number(m[1]) : 0;
+    }
+    function keywordOptionLabel(k) {
+      const triage = typeof k.triage === "number" ? k.triage : triageCountForKeyword(k.id);
+      const total = typeof k.total === "number" ? k.total : hitCountForKeyword(k.id);
+      const bits = [k.id];
+      if (k.track && k.track !== "listen") bits.push(k.track);
+      if (k.layer) bits.push(k.layer);
+      bits.push(`${triage}/${total}`);
+      return bits.join(" · ");
+    }
+    function bindKwFilters(root) {
+      root.querySelectorAll("[data-kw-filter]").forEach(btn => {
+        btn.onclick = (e) => {
+          e.preventDefault();
+          e.stopPropagation();
+          const kid = btn.getAttribute("data-kw-filter") || "";
+          hitKw = hitKw === kid ? "" : kid;
+          hitsSub = "list";
+          renderHits();
+        };
+      });
+    }
+    function renderKeywordFilter(into) {
+      const wrap = document.createElement("div");
+      wrap.className = "kw-filter";
+      const ranked = rankedKeywords({ forHits: true });
+      const q = hitKwQ.trim().toLowerCase();
+      const filtered = ranked.filter(k => keywordMatchesQuery(k, q));
+      const withHits = filtered.filter(k => k.total > 0);
+      const listenN = listenKeywordsInScope().length;
+
+      const row = document.createElement("div");
+      row.className = "kw-filter-row";
+      const searchWrap = document.createElement("div");
+      searchWrap.className = "kw-search";
+      const search = document.createElement("input");
+      search.type = "search";
+      search.placeholder = t("kw_search");
+      search.setAttribute("aria-label", t("kw_search"));
+      search.value = hitKwQ;
+      search.oninput = () => {
+        const pos = search.selectionStart;
+        hitKwQ = search.value;
+        renderHits();
+        const s2 = $list.querySelector(".kw-search input[type='search']");
+        if (s2) {
+          s2.focus();
+          try { s2.setSelectionRange(pos, pos); } catch (_) {}
+        }
+      };
+      searchWrap.appendChild(search);
+      row.appendChild(searchWrap);
+      wrap.appendChild(row);
+
+      const quickWrap = document.createElement("div");
+      quickWrap.className = "kw-quick";
+      if (!listenN) {
+        quickWrap.innerHTML = `<span class="vacant">${esc(t("no_keyword"))}</span>`;
+      } else if (!withHits.length) {
+        quickWrap.innerHTML = `<span class="vacant">${esc(t("no_hit"))}</span>`;
+      } else {
+        withHits.forEach(k => {
+          const b = document.createElement("button");
+          b.type = "button";
+          b.className = "kw-chip" + (hitKw === k.id ? " on" : "");
+          b.innerHTML = `${esc(k.id)}<span class="n">${k.triage}</span>`;
+          b.title = [k.query, k.why, `${k.triage} ${t("kw_triage")} · ${k.total} ${t("kw_hits")}`].filter(Boolean).join("\n");
+          b.onclick = () => {
+            hitKw = hitKw === k.id ? "" : k.id;
+            renderHits();
+          };
+          quickWrap.appendChild(b);
+        });
+      }
+      wrap.appendChild(quickWrap);
+
+      if (hitKw) {
+        const k = keywordById(hitKw);
+        const active = document.createElement("div");
+        active.className = "kw-active";
+        const triage = triageCountForKeyword(hitKw);
+        const total = hitCountForKeyword(hitKw);
+        active.innerHTML = `<span class="kid">${esc(hitKw)}</span>
+          <span class="meta">${esc([(k && k.layer) || "", (k && k.intent) || "", (k && k.pillar) || ""].filter(Boolean).join(" · "))}</span>
+          <span class="query" title="${esc((k && k.why) || "")}">${esc((k && k.query) || "")}</span>
+          <span class="meta"><b>${triage}</b> ${esc(t("kw_triage"))} · ${total} ${esc(t("kw_hits"))}</span>
+          <button type="button" class="clear">${esc(t("kw_clear"))}</button>`;
+        active.querySelector(".clear").onclick = () => { hitKw = ""; renderHits(); };
+        wrap.appendChild(active);
+      }
+
+      into.appendChild(wrap);
+      return { filtered };
+    }
+    function renderHitsSubtabs() {
+      const sub = document.createElement("div");
+      sub.className = "subtabs";
+      sub.innerHTML = `<button type="button" data-hits-sub="list">${t("hits_sub_list")}</button><button type="button" data-hits-sub="catalog">${t("hits_sub_catalog")}</button>`;
+      sub.querySelectorAll("button").forEach(b => {
+        b.classList.toggle("on", b.dataset.hitsSub === hitsSub);
+        b.onclick = () => {
+          hitsSub = b.dataset.hitsSub;
+          renderHits();
+        };
+      });
+      $list.appendChild(sub);
+    }
+    function openKeywordInHits(kid) {
+      hitKw = kid || "";
+      hitsSub = "list";
+      renderHits();
+    }
+    function renderKeywordCatalog() {
+      const row = document.createElement("div");
+      row.className = "kw-filter-row";
+      const searchWrap = document.createElement("div");
+      searchWrap.className = "kw-search";
+      const search = document.createElement("input");
+      search.type = "search";
+      search.placeholder = t("kw_catalog_search");
+      search.setAttribute("aria-label", t("kw_catalog_search"));
+      search.value = kwCatalogQ;
+      search.oninput = () => {
+        const pos = search.selectionStart;
+        kwCatalogQ = search.value;
+        renderHits();
+        const s2 = $list.querySelector(".kw-search input[type='search']");
+        if (s2) {
+          s2.focus();
+          try { s2.setSelectionRange(pos, pos); } catch (_) {}
+        }
+      };
+      searchWrap.appendChild(search);
+      row.appendChild(searchWrap);
+
+      const tracks = document.createElement("div");
+      tracks.className = "kw-quick";
+      [
+        ["", "kw_track_all"],
+        ["listen", "kw_track_listen"],
+        ["search", "kw_track_search"],
+        ["ask", "kw_track_ask"],
+      ].forEach(([id, labelKey]) => {
+        const b = document.createElement("button");
+        b.type = "button";
+        b.className = "kw-chip" + (kwCatalogTrack === id ? " on" : "");
+        b.textContent = t(labelKey);
+        b.onclick = () => { kwCatalogTrack = id; renderHits(); };
+        tracks.appendChild(b);
+      });
+      row.appendChild(tracks);
+      $list.appendChild(row);
+
+      const q = kwCatalogQ.trim().toLowerCase();
+      const keys = rankedKeywords({ track: kwCatalogTrack || "" })
+        .filter(k => keywordMatchesQuery(k, q))
+        .sort((a, b) => keywordIdNum(a.id) - keywordIdNum(b.id));
+      const count = document.createElement("p");
+      count.className = "note";
+      count.style.margin = "8px 0 0";
+      count.textContent = t("kw_catalog_count", { n: keys.length });
+      $list.appendChild(count);
+      const grid = document.createElement("div");
+      grid.className = "kw-catalog-grid";
+      if (!keys.length) {
+        grid.innerHTML = `<p class='empty'>${esc(t("kw_catalog_empty"))}</p>`;
+      } else {
+        keys.forEach(k => {
+          const card = document.createElement("button");
+          card.type = "button";
+          card.className = "kw-catalog-card";
+          const vol = k.track === "search" && k.volume
+            ? ` · ${t("kw_vol")} ${esc(k.volume)}`
+            : "";
+          const go = k.track === "listen"
+            ? `<span class="go">${esc(t("kw_open_hits"))} →</span>`
+            : `<span class="meta">${esc(k.track)}</span>`;
+          card.innerHTML = `<div class="kid">${esc(k.id)} <span class="pill">${esc(k.track || "listen")}</span></div>
+            <div class="meta">${esc([k.layer, k.intent, k.pillar, k.status].filter(Boolean).join(" · "))}${vol}</div>
+            <div class="query">${esc(k.query || "")}</div>
+            ${k.why ? `<div class="why">${esc(k.why)}</div>` : ""}
+            <div class="count"><b>${k.triage}</b> ${esc(t("kw_triage"))} · ${k.total} ${esc(t("kw_hits"))}${k.last_scanned ? ` · ${esc(k.last_scanned)}` : ""}</div>
+            ${go}`;
+          card.onclick = () => {
+            if ((k.track || "listen") === "listen") openKeywordInHits(k.id);
+          };
+          grid.appendChild(card);
+        });
+      }
+      $list.appendChild(grid);
+    }
+    function renderHitsList() {
+      const statuses = [...new Set(nodesOf("hit").map(x => x.status).filter(Boolean))];
+      const signals = [...new Set(nodesOf("hit").map(x => x.signal).filter(Boolean))];
+      const { filtered } = renderKeywordFilter($list);
+      const kwOptions = filtered.length ? filtered : rankedKeywords({ forHits: true });
+      filterBar(
+        `<select id="h-st"><option value="">${t("f_status")}</option>${statuses.map(s => `<option value="${s}" ${s === hitSt ? "selected" : ""}>${esc(s)}</option>`).join("")}</select>
+         <select id="h-sig"><option value="">${t("f_signal")}</option>${signals.map(s => `<option value="${s}" ${s === hitSig ? "selected" : ""}>${esc(s)}</option>`).join("")}</select>
+         <select id="h-kw"><option value="">${t("f_keyword")} (${listenKeywordsInScope().length})</option>${kwOptions.map(k => `<option value="${esc(k.id)}" ${k.id === hitKw ? "selected" : ""}>${esc(keywordOptionLabel(k))}</option>`).join("")}</select>`,
+        (w) => {
+          const st = w.querySelector("#h-st");
+          const sig = w.querySelector("#h-sig");
+          const kw = w.querySelector("#h-kw");
+          if (hitKw && ![...kw.options].some(o => o.value === hitKw)) {
+            const opt = document.createElement("option");
+            opt.value = hitKw;
+            opt.textContent = keywordOptionLabel(keywordById(hitKw) || { id: hitKw });
+            opt.selected = true;
+            kw.appendChild(opt);
+          }
+          const paintCards = () => {
+            [...$list.querySelectorAll(".cards")].forEach(n => n.remove());
+            const cards = document.createElement("div");
+            cards.className = "cards";
+            let rows = nodesOf("hit").filter(qmatch).sort((a, b) => {
+              const ta = a.status === "triage" ? 0 : 1;
+              const tb = b.status === "triage" ? 0 : 1;
+              if (ta !== tb) return ta - tb;
+              const ha = Number(String(a.src_likes || "0").replace(/,/g, "")) || 0;
+              const hb = Number(String(b.src_likes || "0").replace(/,/g, "")) || 0;
+              if (hb !== ha) return hb - ha;
+              return String(b.date || "").localeCompare(String(a.date || ""));
+            });
+            if (hitSt) rows = rows.filter(x => x.status === hitSt);
+            if (hitSig) rows = rows.filter(x => x.signal === hitSig);
+            if (hitKw) rows = rows.filter(x => x.keyword_id === hitKw);
+            rows.forEach(x => {
+              const meta = [x.platform, x.hit_kind, x.signal].filter(Boolean).join(" · ");
+              cards.appendChild(listRowEl(x, meta));
+            });
+            if (!rows.length) {
+              cards.innerHTML = `<p class='empty'>${t("no_hit")}</p><p class="note">${esc(t("hit_empty_hint"))}</p>`;
+            }
+            $list.appendChild(cards);
+            bindKwFilters(cards);
+          };
+          st.onchange = () => { hitSt = st.value || ""; paintCards(); };
+          sig.onchange = () => { hitSig = sig.value || ""; paintCards(); };
+          kw.onchange = () => { hitKw = kw.value || ""; renderHits(); };
+          paintCards();
+        }
+      );
+    }
+    function renderHits() {
+      $list.innerHTML = "";
+      renderHitsSubtabs();
+      if (hitsSub === "catalog") renderKeywordCatalog();
+      else renderHitsList();
+    }
+
     function renderProducts() {
       $list.innerHTML = "";
       const products = nodesOf("product").filter(qmatch).sort((a, b) => String(a.label).localeCompare(String(b.label)));
@@ -1688,7 +2157,6 @@
 
     function renderTopics() {
       $list.innerHTML = "";
-      $list.insertAdjacentHTML("beforeend", `<p class="lead">${esc(t("topics_lead"))}</p>`);
       if (topicSrc && !TOPIC_SOURCES.includes(topicSrc)) topicSrc = "";
       const statuses = [...new Set(nodesOf("topic").map(x => x.status).filter(Boolean))];
       filterBar(
@@ -1959,6 +2427,7 @@
       return {
         capture: nodesOfAll("capture").filter(n => n.profile === profileId).length,
         need: nodesOfAll("need").filter(n => n.profile === profileId).length,
+        hit: nodesOfAll("hit").filter(n => n.profile === profileId).length,
         topic: nodesOfAll("topic").filter(n => n.profile === profileId).length,
         lib: GRAPH.nodes.filter(n => n.lib && (String(n.profiles || "").includes(profileId) || String(n.profiles || "").includes("*"))).length,
         run: nodesOfAll("run").filter(n => n.profile === profileId).length,
@@ -1971,6 +2440,7 @@
       return {
         capture: nodesOfAll("capture").length,
         need: nodesOfAll("need").length,
+        hit: nodesOfAll("hit").length,
         topic: nodesOfAll("topic").length,
         lib: GRAPH.nodes.filter(n => n.lib).length,
         run: nodesOfAll("run").length,
@@ -1981,17 +2451,20 @@
     function gapsFor(profileId) {
       const topics = profileId ? nodesOfAll("topic").filter(n => n.profile === profileId) : nodesOfAll("topic");
       const needs = profileId ? nodesOfAll("need").filter(n => n.profile === profileId) : nodesOfAll("need");
+      const hits = profileId ? nodesOfAll("hit").filter(n => n.profile === profileId) : nodesOfAll("hit");
       const caps = profileId ? nodesOfAll("capture").filter(n => n.profile === profileId) : nodesOfAll("capture");
       const pubs = profileId ? nodesOfAll("published").filter(n => n.profile === profileId) : nodesOfAll("published");
       const needCount = needs.length;
       const gaps = [
+        [hits.filter(h => h.status === "triage").length, "gap_hits_n"],
         [topics.filter(x => x.status === "ready" && x.usage === "unused").length, "gap_ready_n"],
         [needs.filter(n => n.status === "captured" && (!n.topic_ids || n.topic_ids === "none")).length, "gap_needs_n"],
         [caps.filter(c => c.status !== "ingested").length, "gap_lib_n"],
         [pubs.filter(p => !p.reviewable).length, "gap_review_n"],
       ].filter(([n]) => n > 0);
       if (GRAPH.needs_index_present && needCount < 3) {
-        gaps.splice(1, 0, [needCount, "gap_needs_thin_n"]);
+        const idx = gaps.findIndex(([, k]) => k === "gap_needs_n");
+        gaps.splice(idx < 0 ? gaps.length : idx, 0, [needCount, "gap_needs_thin_n"]);
       }
       return gaps;
     }
@@ -2000,6 +2473,7 @@
       return `<div class="prof-stats">
         <div><b>${counts.capture}</b><span>${t("kpi_cap")}</span></div>
         <div><b>${counts.need || 0}</b><span>${t("kpi_needs")}</span></div>
+        <div><b>${counts.hit || 0}</b><span>${t("kpi_hits")}</span></div>
         <div><b>${counts.topic}</b><span>${t("kpi_topics")}</span></div>
         <div><b>${counts.lib}</b><span>${t("kpi_lib")}</span></div>
         <div><b>${counts.run}</b><span>Run</span></div>
@@ -2034,6 +2508,8 @@
         ["audience", t("doc_audience")],
         ["pillars", t("doc_pillars")],
         ["lanes", t("doc_lanes")],
+        ["keywords", t("doc_keywords")],
+        ["handles", t("doc_handles")],
       ];
       const pillarRows = Object.entries(pillars).map(([id, p]) => {
         const title = lang === "zh" ? p.zh : p.en;
@@ -2103,9 +2579,14 @@
         [t("kv_profile")]: n.profile || n.profile_id || (n.profiles || ""),
         [t("kv_score")]: n.fit ? `${n.craft} opp / ${n.fit} aud` : n.total,
         [t("kv_use")]: n.usage,
-        [t("kv_src")]: n.source_type,
+        [t("kv_src")]: n.kind === "hit" ? (n.source || "") : n.source_type,
+        [t("kv_hit_kind")]: n.kind === "hit" ? (n.hit_kind || "") : "",
+        [t("kv_signal")]: n.kind === "hit" ? (n.signal || "") : "",
+        Keyword: n.kind === "hit" ? (n.keyword_id || "") : "",
+        [t("kv_hit_source")]: n.kind === "hit" ? (n.source || "") : "",
         [t("kv_needs")]: n.kind === "topic" ? (n.need_ids || "") : "",
         Quote: n.kind === "need" ? (n.quote || "") : "",
+        Excerpt: n.kind === "hit" ? (n.excerpt || "") : "",
         Speaker: n.kind === "need" ? (n.speaker || "") : "",
         Frequency: n.kind === "need" ? (n.frequency || "") : "",
         Topics: n.kind === "need" ? (n.topic_ids || "") : "",
@@ -2119,16 +2600,23 @@
         Relationship: n.kind === "recommendation" ? (n.relationship || "") : "",
         "Last researched": n.kind === "recommendation" ? (n.last_researched || "") : "",
         Handle: n.source_handle || n.src_handle || "",
-        [t("kv_heat_at")]: n.kind === "capture" ? (n.engagement_at || "") : "",
+        [t("kv_heat_at")]: (n.kind === "capture" || n.kind === "hit") ? (n.engagement_at || "") : "",
         [t("kv_result")]: n.result,
       }).filter(([, v]) => v);
-      const heatBlock = n.kind === "capture"
+      const kwMeta = n.kind === "hit" && n.keyword_id
+        ? (GRAPH.keywords || []).find(k => k.id === n.keyword_id && (!n.profile || k.profile === n.profile))
+        : null;
+      const kwBlock = n.kind === "hit" && n.keyword_id
+        ? `<p class="note"><button type="button" class="kw-chip" data-kw-filter="${esc(n.keyword_id)}">${esc(n.keyword_id)}</button>${kwMeta ? ` · ${esc([kwMeta.layer, kwMeta.intent, kwMeta.why].filter(Boolean).join(" · "))}` : ""}</p>`
+        : "";
+      const heatBlock = (n.kind === "capture" || n.kind === "hit")
         ? `${heatStripHtml(n, { hint: true })}${n.source_url ? `<p class="note">${t("src_url")}<a href="${esc(n.source_url)}" target="_blank" rel="noreferrer">${esc(n.source_url)}</a></p>` : ""}`
         : "";
       $insp.innerHTML = `<h2>${t("obj")}</h2>
         <p class="kicker">${esc(kindName(n.kind))} · ${esc(n.ident)}</p>
         <p class="title">${n.kind === "run" ? `<button type="button" class="ghost-link title-btn" data-run-open="${esc(n.id)}">${esc(n.label)}</button>` : esc(n.label)}</p>
         <dl class="kv">${kv.map(([k, v]) => `<dt>${esc(k)}</dt><dd>${esc(v)}</dd>`).join("")}</dl>
+        ${kwBlock}
         ${heatBlock}
         ${n.kind === "swipe" || n.kind === "atom" ? `<p class="note">${esc(t("lib_use_hist"))}</p>` : ""}
         ${n.kind === "claim" ? `<p class="note">${esc(t("lib_claim_ev"))}</p>` : ""}
@@ -2143,6 +2631,7 @@
       $insp.querySelectorAll("[data-goto]").forEach(btn => {
         btn.onclick = () => select(btn.getAttribute("data-goto"));
       });
+      bindKwFilters($insp);
       const trace = $insp.querySelector("#trace");
       for (const k of TRACE_ORDER) {
         const items = k === "published" ? publishedFor(n, ctx) : (byKind[k] || []);