@easysociable/cli 0.1.3 → 0.1.5

package/content-engine/workbench/template.html

@@ -158,8 +158,8 @@
     .row.sel { border-color: var(--accent); box-shadow: var(--shadow); }
     .stripe { border-radius: 14px 0 0 14px; background: var(--accent-dim); }
     .row[data-kind="capture"] .stripe { background: #7d9aa8; }
+    .row[data-kind="need"] .stripe { background: #5a9e8f; }
     .row[data-kind="raw"] .stripe { background: #6e7f6a; }
-    .row[data-kind="discovery"] .stripe { background: #6b7c8a; }
     .row[data-kind="topic"] .stripe { background: var(--accent); }
     .row[data-kind="swipe"] .stripe { background: #c4a06a; }
     .row[data-kind="atom"] .stripe { background: #a78bb0; }
@@ -623,17 +623,17 @@
   </div>
   <script>
     const GRAPH = /*__GRAPH__*/null;
-    const TRACE_ORDER = ["raw", "capture", "discovery", "topic", "swipe", "atom", "claim", "run", "published"];
+    const TRACE_ORDER = ["raw", "capture", "need", "product", "recommendation", "topic", "swipe", "atom", "claim", "run", "published"];
     const STR = {
       zh: {
         title: "Content Engine · 观察台",
         brand: "观察台",
         search: "搜索 ID、一句话、来源…",
-        overview: "总览", discovery: "发现", topics: "选题库", notes: "记录与知识", runs: "Run 档案", pub: "发布与复盘",
-        notes_in: "记下的", notes_lib: "进库的",
+        overview: "总览", needs: "需求库", products: "产品库", recommendations: "推荐库", topics: "选题库", notes: "记录与知识", runs: "Run 档案", pub: "发布与复盘",
+        notes_in: "记下的", notes_needs: "需求原话", notes_lib: "进库的",
         lead: "先认 IP，再看库存。",
-        kpi_cap: "记下的", kpi_lib: "进库的", kpi_topics: "选题", kpi_out: "下场",
-        kpi_cap_sub: "Capture", kpi_lib_sub: "Swipe / Atom / Claim",
+        kpi_cap: "记下的", kpi_needs: "需求", 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 / 已发帖",
         ip_section: "IP · Profiles",
         ip_all: "全部 Profile",
@@ -644,8 +644,15 @@
         gap_section: "断链",
         gap_none: "没有明显断链。",
         gap_ready_n: "ready 选题未开单 {n}",
+        gap_needs_thin_n: "需求原话不足 3 条（出图硬门闩）· 现有 {n}",
+        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_profile: "Profile",
         kind_profile: "Profile", kind_account: "账号",
         profile_pillars: "支柱",
@@ -657,6 +664,7 @@
         doc_voice: "Voice",
         doc_audience: "Audience",
         doc_pillars: "Pillars",
+        doc_lanes: "Lanes",
         empty_profile_t: "点选一个 Profile",
         empty_profile_b: "右侧会显示该 IP 的支柱、账号、档案与断链。",
         acct_handle: "Handle",
@@ -680,6 +688,7 @@
         lib_claim_ev: "命题证据在本 claim 的 Evidence 表；命中率看 n/win/loss。",
         f_status: "状态（登记）", f_pillar: "Pillar", f_src: "来源", f_use: "使用", f_unused: "未开单", f_promoted: "已开单",
         f_sort: "排序",
+        f_sort_recommend: "报题优先",
         f_sort_bookmarks: "Bookmarks ↓",
         f_sort_replies: "Replies ↓",
         f_sort_likes: "Likes ↓",
@@ -702,7 +711,8 @@
         f_cap_ingest: "入库",
         f_cap_ingested: "已入库",
         f_cap_not_ingested: "未入库",
-        no_topic: "无匹配选题", no_discovery: "无匹配发现", no_note: "无匹配记录", no_pub: "尚无已发帖",
+        no_topic: "无匹配选题", no_note: "无匹配记录", no_need: "尚无需求原话", no_pub: "尚无已发帖",
+        need_empty_hint: "对 Agent 说「记需求：……」写入第一条读者原话。不要编造。",
         no_stage: "无阶段文件",
         empty_t: "从左边拾起一件东西",
         empty_b: "它从哪来、有没有被写过、发过没有、值不值得再拿出来——会在这里连成一条。",
@@ -728,7 +738,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_discovery: "发现", kind_topic: "选题", kind_swipe: "Swipe",
+        kind_raw: "Raw", kind_capture: "Capture", 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: "支柱",
@@ -740,11 +750,11 @@
         title: "Content Engine · Observatory",
         brand: "Observatory",
         search: "Search ID, one-liner, source…",
-        overview: "Overview", discovery: "Discovery", topics: "Topics", notes: "Notes & library", runs: "Run files", pub: "Shipped & review",
-        notes_in: "Captured", notes_lib: "Catalog",
+        overview: "Overview", needs: "Needs", 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_lib: "Catalog", kpi_topics: "Topics", kpi_out: "Outcomes",
-        kpi_cap_sub: "Capture", kpi_lib_sub: "Swipe / Atom / Claim",
+        kpi_cap: "Captured", kpi_needs: "Needs", 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",
         ip_section: "IP · Profiles",
         ip_all: "All profiles",
@@ -755,8 +765,15 @@
         gap_section: "Breaks",
         gap_none: "No obvious breaks.",
         gap_ready_n: "{n} ready topics with no run",
+        gap_needs_thin_n: "Needs under 3 quotes (graphics hard gate) · have {n}",
+        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_profile: "Profile",
         kind_profile: "Profile", kind_account: "Account",
         profile_pillars: "Pillars",
@@ -768,6 +785,7 @@
         doc_voice: "Voice",
         doc_audience: "Audience",
         doc_pillars: "Pillars",
+        doc_lanes: "Lanes",
         empty_profile_t: "Pick a Profile",
         empty_profile_b: "The inspector shows that IP’s pillars, accounts, files, and breaks.",
         acct_handle: "Handle",
@@ -791,6 +809,7 @@
         lib_claim_ev: "Proposition evidence is this claim’s Evidence table; hit rate is n/win/loss.",
         f_status: "Registry status", f_pillar: "Pillar", f_src: "Source", f_use: "Use", f_unused: "unused", f_promoted: "promoted",
         f_sort: "Sort",
+        f_sort_recommend: "Report first",
         f_sort_bookmarks: "Bookmarks ↓",
         f_sort_replies: "Replies ↓",
         f_sort_likes: "Likes ↓",
@@ -813,7 +832,8 @@
         f_cap_ingest: "Ingest",
         f_cap_ingested: "Ingested",
         f_cap_not_ingested: "Not ingested",
-        no_topic: "No matching topics", no_discovery: "No matching discoveries", no_note: "No matching notes", no_pub: "No shipped posts",
+        no_topic: "No matching topics", no_note: "No matching notes", no_need: "No audience quotes yet", no_pub: "No shipped posts",
+        need_empty_hint: "Ask the Agent: “capture audience quotes: …” with a verbatim quote. Do not invent quotes.",
         no_stage: "no stage files",
         empty_t: "Pick something on the left",
         empty_b: "Where it came from, whether it was written, whether it shipped, whether it is worth reusing — that chain shows up here.",
@@ -839,7 +859,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_discovery: "Discovery", kind_topic: "Topic", kind_swipe: "Swipe",
+        kind_raw: "Raw", kind_capture: "Capture", 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",
@@ -936,9 +956,8 @@
     let topicPillar = "";
     let topicSrc = "";
     let topicUsage = "";
-    let discStatus = "";
-    let discSort = "bookmarks";
     let capIngest = "";
+    const TOPIC_SOURCES = ["need", "inbox", "user", "product", "recommendation"];
     let selected = null;
     const $list = document.getElementById("list");
     const $insp = document.getElementById("insp");
@@ -1283,7 +1302,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", "discovery", "topics", "notes", "runs", "pub"]) {
+      for (const id of ["overview", "needs", "products", "recommendations", "topics", "notes", "runs", "pub"]) {
         const b = document.createElement("button");
         b.textContent = t(id);
         b.dataset.view = id;
@@ -1343,7 +1362,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.profile, n.profiles, n.src_handle, n.url, n.notes, n.type, n.atom_type, n.topic_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].filter(Boolean).join(" ").toLowerCase();
       return blob.includes(q);
     }
     function connected(id) {
@@ -1423,11 +1442,16 @@
     function heatMetric(n, key) {
       return numCompact(n[`src_${key}`]);
     }
+    function hasHeat(n) {
+      return ["likes", "replies", "bookmarks", "views"].some(k => heatMetric(n, k) !== null);
+    }
     function heatStripHtml(n, opts = {}) {
+      // No strip when every metric is missing — empty "—" chips inflate row height.
+      if (!hasHeat(n)) return "";
       const hint = opts.hint ? `<span class="heat-note">${esc(t("heat_hint"))}</span>` : "";
       const items = [
         { key: "likes", sym: "♥", title: "likes" },
-        { key: "replies", sym: "↩", title: "replies" },
+        { key: "replies", sym: "💬", title: "replies" },
         { key: "bookmarks", sym: "🔖", title: "bookmarks" },
         { key: "views", sym: "👁", title: "views" },
       ];
@@ -1439,7 +1463,7 @@
       }).join("");
       return `<div class="heat" title="${esc(t("heat_hint"))}">${chips}</div>${hint}`;
     }
-    function discoveryRowEl(n, extra) {
+    function listRowEl(n, extra) {
       const d = document.createElement("div");
       d.className = "row" + (selected === n.id ? " sel" : "");
       d.dataset.kind = n.kind;
@@ -1458,35 +1482,19 @@
         </div>`;
       return d;
     }
-    function sortDiscoveries(rows, mode) {
-      const missing = -1;
-      const num = (n, key) => {
-        const v = Number(String(n[`src_${key}`] ?? "").replace(/,/g, ""));
-        return Number.isFinite(v) ? v : missing;
-      };
-      return rows.slice().sort((a, b) => {
-        let cmp = 0;
-        if (mode === "likes") cmp = num(b, "likes") - num(a, "likes");
-        else if (mode === "replies") cmp = num(b, "replies") - num(a, "replies");
-        else if (mode === "views") cmp = num(b, "views") - num(a, "views");
-        else if (mode === "date") cmp = String(b.date || "").localeCompare(String(a.date || ""));
-        else cmp = num(b, "bookmarks") - num(a, "bookmarks");
-        if (cmp !== 0) return cmp;
-        return String(b.date || "").localeCompare(String(a.date || ""));
-      });
-    }
     function pills(n) {
       const bits = [];
-      if (n.kind === "discovery") {
+      if (n.kind === "need") {
         const st = n.status || "";
-        const cls = st === "read" || st === "promoted" ? "ok"
-          : (st === "saved" || st === "rejected" || st === "unread" ? "gap" : "");
+        const cls = st === "promoted" ? "ok" : (st === "captured" ? "gap" : "");
         if (st) bits.push(`<span class="pill ${cls}">${esc(st)}</span>`);
-        if (n.source_role) bits.push(`<span class="pill">${esc(n.source_role)}</span>`);
-        if (n.next_action && n.next_action !== "none") bits.push(`<span class="pill">${esc(n.next_action)}</span>`);
+        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 === "topic") {
         bits.push(`<span class="pill">${esc(n.status)}</span>`);
+        if (n.source_type) bits.push(`<span class="pill">${esc(n.source_type)}</span>`);
+        if (n.generation_mode) bits.push(`<span class="pill">${esc(n.generation_mode)}</span>`);
         bits.push(n.usage === "unused" ? `<span class="pill gap">${t("unused")}</span>` : `<span class="pill ok">${esc(n.usage)}</span>`);
       }
       if (n.kind === "run") {
@@ -1526,7 +1534,9 @@
     function render() {
       for (const b of tabs.querySelectorAll("button")) b.classList.toggle("on", b.dataset.view === view);
       if (view === "overview") renderOverview();
-      if (view === "discovery") renderDiscovery();
+      if (view === "needs") renderNeeds();
+      if (view === "products") renderProducts();
+      if (view === "recommendations") renderRecommendations();
       if (view === "topics") renderTopics();
       if (view === "notes") renderNotes();
       if (view === "runs") renderRuns();
@@ -1534,6 +1544,69 @@
       renderInsp();
     }
 
+    function renderNeedsList(into) {
+      const cards = document.createElement("div");
+      cards.className = "cards";
+      const needs = nodesOf("need").filter(qmatch).sort((a, b) => (b.date || "").localeCompare(a.date || ""));
+      needs.forEach(n => {
+        const meta = [
+          n.source_type || "",
+          n.status || "",
+          n.frequency ? `×${n.frequency}` : "",
+          n.topic_ids && n.topic_ids !== "none" ? n.topic_ids : "",
+        ].filter(Boolean).join(" · ");
+        cards.appendChild(listRowEl(n, meta));
+      });
+      if (!needs.length) {
+        cards.innerHTML = `<p class='empty'>${t("no_need")}</p><p class="note">${esc(t("need_empty_hint"))}</p>`;
+      }
+      into.appendChild(cards);
+    }
+
+    function renderNeeds() {
+      $list.innerHTML = "";
+      $list.insertAdjacentHTML("beforeend", `<p class="lead">${esc(t("need_empty_hint"))}</p>`);
+      renderNeedsList($list);
+    }
+
+    function renderProducts() {
+      $list.innerHTML = "";
+      const products = nodesOf("product").filter(qmatch).sort((a, b) => String(a.label).localeCompare(String(b.label)));
+      $list.insertAdjacentHTML("beforeend", `<p class="lead">Needs describe demand. Products describe the offer. Topics connect them only when the fit is honest.</p>`);
+      const cards = document.createElement("div");
+      cards.className = "cards";
+      products.forEach(product => {
+        const meta = [
+          product.status,
+          product.audience,
+          product.price,
+          product.effective_from,
+        ].filter(Boolean).join(" · ");
+        cards.appendChild(rowEl(product, meta));
+      });
+      if (!products.length) cards.innerHTML = `<p class='empty'>No products in products/_index.md</p>`;
+      $list.appendChild(cards);
+    }
+
+    function renderRecommendations() {
+      $list.innerHTML = "";
+      const recommendations = nodesOf("recommendation").filter(qmatch).sort((a, b) => String(a.label).localeCompare(String(b.label)));
+      $list.insertAdjacentHTML("beforeend", `<p class="lead">Recommendations are third-party review subjects, not owned Products.</p>`);
+      const cards = document.createElement("div");
+      cards.className = "cards";
+      recommendations.forEach(item => {
+        const meta = [
+          item.status,
+          item.category,
+          item.relationship,
+          item.last_researched,
+        ].filter(Boolean).join(" · ");
+        cards.appendChild(rowEl(item, meta));
+      });
+      if (!recommendations.length) cards.innerHTML = `<p class='empty'>No recommendations in recommendations/_index.md</p>`;
+      $list.appendChild(cards);
+    }
+
     function renderOverview() {
       $list.innerHTML = "";
       $list.insertAdjacentHTML("beforeend", `<p class="lead">${t("lead")}</p>`);
@@ -1597,56 +1670,31 @@
       onReady(wrap);
     }
 
-    function renderDiscovery() {
-      $list.innerHTML = "";
-      const statuses = [...new Set(nodesOf("discovery").map(x => x.status).filter(Boolean))];
-      const sortOpts = [
-        ["bookmarks", "f_sort_bookmarks"],
-        ["replies", "f_sort_replies"],
-        ["likes", "f_sort_likes"],
-        ["views", "f_sort_views"],
-        ["date", "f_sort_date"],
-      ];
-      filterBar(
-        `<select id="d-st"><option value="">${t("f_status")}</option>${statuses.map(s => `<option value="${s}" ${s === discStatus ? "selected" : ""}>${esc(s)}</option>`).join("")}</select>
-         <select id="d-sort" title="${esc(t("f_sort"))}"><option value="" disabled>${esc(t("f_sort"))}</option>${sortOpts.map(([v, k]) => `<option value="${v}" ${v === discSort ? "selected" : ""}>${esc(t(k))}</option>`).join("")}</select>`,
-        (w) => {
-          const status = w.querySelector("#d-st");
-          const sortEl = w.querySelector("#d-sort");
-          const paint = () => {
-            discStatus = status.value;
-            discSort = sortEl.value || "bookmarks";
-            const cards = document.createElement("div");
-            cards.className = "cards";
-            let rows = nodesOf("discovery").filter(qmatch);
-            if (discStatus) rows = rows.filter(x => x.status === discStatus);
-            rows = sortDiscoveries(rows, discSort);
-            rows.forEach(x => {
-              const meta = [
-                x.source_role,
-                x.next_action && x.next_action !== "none" ? x.next_action : "",
-                `@${x.source_handle || "—"}`,
-              ].filter(Boolean).join(" · ");
-              cards.appendChild(discoveryRowEl(x, meta));
-            });
-            if (!rows.length) cards.innerHTML = `<p class='empty'>${t("no_discovery")}</p>`;
-            [...$list.querySelectorAll(".cards")].forEach(n => n.remove());
-            $list.appendChild(cards);
-          };
-          status.onchange = paint;
-          sortEl.onchange = paint;
-          paint();
-        }
-      );
+    function topicMeta(x) {
+      const score = x.fit ? `${x.craft}/${x.fit}` : (x.craft || x.total || "—");
+      const bits = [
+        score,
+        formatPillar(x.pillar),
+        x.lane,
+        x.generation_mode,
+        x.source_type,
+        x.need_ids && x.need_ids !== "none" ? x.need_ids : "",
+        x.product_ids && x.product_ids !== "none" ? x.product_ids : "",
+        x.recommendation_ids && x.recommendation_ids !== "none" ? x.recommendation_ids : "",
+        x.capture_id || "",
+      ].filter(Boolean);
+      return bits.join(" · ");
     }
 
     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(
         `<select id="f-st"><option value="">${t("f_status")}</option>${statuses.map(s => `<option value="${s}" ${s === topicStatus ? "selected" : ""}>${esc(s)}</option>`).join("")}</select>
          <select id="f-p"><option value="">${t("f_pillar")}</option>${pillarIds().map(id => `<option value="${id}" ${id === topicPillar ? "selected" : ""}>${esc(formatPillar(id))}</option>`).join("")}</select>
-         <select id="f-src"><option value="">${t("f_src")}</option>${["watchlist", "inbox", "user"].map(s => `<option value="${s}" ${s === topicSrc ? "selected" : ""}>${s}</option>`).join("")}</select>
+         <select id="f-src"><option value="">${t("f_src")}</option>${TOPIC_SOURCES.map(s => `<option value="${s}" ${s === topicSrc ? "selected" : ""}>${s}</option>`).join("")}</select>
          <select id="f-u"><option value="">${t("f_use")}</option>
            <option value="unused" ${topicUsage === "unused" ? "selected" : ""}>${t("f_unused")}</option>
            <option value="promoted" ${topicUsage === "promoted" ? "selected" : ""}>${t("f_promoted")}</option></select>`,
@@ -1669,8 +1717,7 @@
             if (topicSrc) rows = rows.filter(x => x.source_type === topicSrc);
             if (topicUsage) rows = rows.filter(x => x.usage === topicUsage);
             rows.forEach(x => {
-              const score = x.fit ? `${x.craft}/${x.fit}` : (x.craft || x.total || "—");
-              cards.appendChild(rowEl(x, `${score} · ${formatPillar(x.pillar)} · ${x.source_type} @${x.src_handle || "—"}`));
+              cards.appendChild(rowEl(x, topicMeta(x)));
             });
             if (!rows.length) cards.innerHTML = `<p class='empty'>${t("no_topic")}</p>`;
             $list.appendChild(cards);
@@ -1685,7 +1732,7 @@
       $list.innerHTML = "";
       const sub = document.createElement("div");
       sub.className = "subtabs";
-      sub.innerHTML = `<button data-t="notes">${t("notes_in")}</button><button data-t="lib">${t("notes_lib")}</button>`;
+      sub.innerHTML = `<button data-t="notes">${t("notes_in")}</button><button data-t="needs">${t("notes_needs")}</button><button data-t="lib">${t("notes_lib")}</button>`;
       $list.appendChild(sub);
       sub.querySelectorAll("button").forEach(b => b.classList.toggle("on", b.dataset.t === notesTab));
       sub.onclick = (e) => {
@@ -1712,11 +1759,15 @@
         let caps = nodesOf("capture").filter(qmatch).sort((a, b) => (b.date || "").localeCompare(a.date || ""));
         if (capIngest === "ingested") caps = caps.filter(c => c.status === "ingested");
         if (capIngest === "not_ingested") caps = caps.filter(c => c.status !== "ingested");
-        caps.forEach(c => cards.appendChild(rowEl(c, `${c.type} · ${c.status} · raw ${c.has_raw ? t("raw_yes") : t("raw_no")}`)));
+        caps.forEach(c => cards.appendChild(listRowEl(c, `${c.type} · ${c.status} · raw ${c.has_raw ? t("raw_yes") : t("raw_no")}`)));
         if (!caps.length) cards.innerHTML = `<p class='empty'>${t("no_note")}</p>`;
         $list.appendChild(cards);
         return;
       }
+      if (notesTab === "needs") {
+        renderNeedsList($list);
+        return;
+      }
       const items = GRAPH.nodes.filter(n => n.lib && inScope(n));
       const subtypeOf = (n) => n.atom_type || n.form || n.claim_type || "";
       const kinds = [...new Set(items.map(n => n.kind))];
@@ -1907,6 +1958,7 @@
     function profileCounts(profileId) {
       return {
         capture: nodesOfAll("capture").filter(n => n.profile === profileId).length,
+        need: nodesOfAll("need").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,
@@ -1918,6 +1970,7 @@
       if (profileId) return profileCounts(profileId);
       return {
         capture: nodesOfAll("capture").length,
+        need: nodesOfAll("need").length,
         topic: nodesOfAll("topic").length,
         lib: GRAPH.nodes.filter(n => n.lib).length,
         run: nodesOfAll("run").length,
@@ -1927,18 +1980,26 @@
 
     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 caps = profileId ? nodesOfAll("capture").filter(n => n.profile === profileId) : nodesOfAll("capture");
       const pubs = profileId ? nodesOfAll("published").filter(n => n.profile === profileId) : nodesOfAll("published");
-      return [
+      const needCount = needs.length;
+      const gaps = [
         [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"]);
+      }
+      return gaps;
     }
 
     function statsHtml(counts) {
       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.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>
@@ -1972,6 +2033,7 @@
         ["voice", t("doc_voice")],
         ["audience", t("doc_audience")],
         ["pillars", t("doc_pillars")],
+        ["lanes", t("doc_lanes")],
       ];
       const pillarRows = Object.entries(pillars).map(([id, p]) => {
         const title = lang === "zh" ? p.zh : p.en;
@@ -2035,16 +2097,32 @@
           ? `${n.win || 0}w / ${n.loss || 0}l / n=${n.n}`
           : "",
         [t("kv_pillar")]: formatPillar(n.pillar),
+        [t("kv_lane")]: n.kind === "topic" ? (n.lane || "") : "",
+        [t("kv_mode")]: n.kind === "topic" ? (n.generation_mode || "") : "",
         [t("kv_plat")]: n.platform || n.platforms,
         [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.kind === "discovery" ? (n.next_action || "") : n.usage,
-        [t("kv_src")]: n.kind === "discovery" ? (n.source_role || "") : n.source_type,
+        [t("kv_use")]: n.usage,
+        [t("kv_src")]: n.source_type,
+        [t("kv_needs")]: n.kind === "topic" ? (n.need_ids || "") : "",
+        Quote: n.kind === "need" ? (n.quote || "") : "",
+        Speaker: n.kind === "need" ? (n.speaker || "") : "",
+        Frequency: n.kind === "need" ? (n.frequency || "") : "",
+        Topics: n.kind === "need" ? (n.topic_ids || "") : "",
+        Products: n.kind === "topic" ? (n.product_ids || "") : "",
+        "Product fit": n.kind === "topic" ? (n.product_fit || "") : "",
+        [t("kv_recs")]: n.kind === "topic" ? (n.recommendation_ids || "") : "",
+        Audience: n.kind === "product" ? (n.audience || "") : "",
+        Price: n.kind === "product" ? (n.price || "") : "",
+        "Effective from": n.kind === "product" ? (n.effective_from || "") : "",
+        Category: n.kind === "recommendation" ? (n.category || "") : "",
+        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 === "discovery" ? (n.engagement_at || "") : "",
+        [t("kv_heat_at")]: n.kind === "capture" ? (n.engagement_at || "") : "",
         [t("kv_result")]: n.result,
       }).filter(([, v]) => v);
-      const heatBlock = n.kind === "discovery"
+      const heatBlock = n.kind === "capture"
         ? `${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>