@takagaki/cortex-decisions-viewer 0.12.71 → 0.12.72

package/dist/render.js

@@ -5507,6 +5507,19 @@ a.ds-tile:hover { text-decoration: none; }
 .ops-card-icon { font-size: 22px; line-height: 1; }
 .ops-card-title { font-size: 15px; font-weight: 700; color: var(--text); margin: 0; }
 .ops-card-desc { color: var(--muted); font-size: 13px; line-height: 1.7; margin: 0; flex: 1 1 auto; }
+/* 手動投入のカードの「どう送ると良いか」（#663）。
+   🔴 **margin: 0 を明示する**——.ops-card は column flex の gap: 10px なので、
+   素の <p> だとブラウザ既定マージンが gap に上乗せされて段が離れる（.ops-card-desc と同じ理由）。
+   **色を desc と同じ var(--muted) にしない**——地続きに見えて「段を分ける」意図が消える。
+   左罫で説明文と役割が違うことを示す。**罫は var(--border) にしない**——#e3e6ea は白地に対して
+   コントラスト比 1.15 で、実機ではほぼ見えない（実装レビュー🟡5）。
+   🔴 **このルールは番人テストが見ている。** CSS は <style> に埋め込まれるので、
+   丸ごと消す・display: none を足す形の退行は material-intake-wording.test.mjs が赤にする
+   （「CSS は jsdom から見えない」は誤りだった・実装レビュー🔴1）。 */
+.ops-card-hint {
+  margin: 0; font-size: 12.5px; line-height: 1.7; color: var(--text);
+  border-left: 3px solid var(--accent); padding: 2px 0 2px 10px;
+}
 .ops-card-btn {
   align-self: flex-start; display: inline-flex; align-items: center; gap: 4px;
   padding: 8px 16px; border-radius: 999px; border: 1px solid var(--accent);
@@ -15499,7 +15512,17 @@ ${calendarAddUrl.toString()}
       return opsCard("🗒️", "会議の文字起こしを追加", "顧客主催の会議など、自動取り込みできない会議の文字起こしファイル（.txt / .docx 等）から議事録を生成します。ファイルを選ぶかテキストを貼って送信すると、数分で反映されます。", "transcript", "文字起こしを追加");
     }
     if (cap === "共有資料") {
-      return opsCard("📎", "共有資料を追加", "提案書・仕様書・議事メモなどの資料を Markdown 化して 共有資料 に取り込みます。ファイルを選ぶかテキストを貼って送信すると、数分で反映されます。", "material", "資料を追加");
+      // hint（#663）: 文字の層が無い PDF（画面の印刷・スキャン・画像を貼ったもの）は
+      // どの変換ツールでも文字が取れない。**「PDF が読めない」とは言わない**——読めないのは
+      // 画面を保存したものとスキャン・写真から作ったものだけで、文字の層がある PDF は今までどおり読める。
+      // **「画面を印刷した PDF」と書かない**（実装レビュー🟡4）——実際の操作は macOS の
+      // 印刷ダイアログの「PDF として保存」で、当人は「印刷していない」と読む。「スキャンした画像」も
+      // 同じで、スキャナの出力は普通 PDF なので「自分のは画像じゃない」と読まれる。
+      // **Google のスライド・ドキュメントは書かない**——「元のファイル」がローカルに存在せず、
+      // 書き出す時点で必ず形式を選ばされるので、指示どおりに行動できない（設計レビュー🔴3）。
+      // その一手は docs/ops-ui-user-stories.md の Drive の節が持つ。
+      return opsCard("📎", "共有資料を追加", "提案書・仕様書・議事メモなどの資料を Markdown 化して 共有資料 に取り込みます。ファイルを選ぶかテキストを貼って送信すると、数分で反映されます。", "material", "資料を追加",
+        "PowerPoint・Word・Excel は、PDF にせず元のファイルのまま送ってください（そのほうが正確に読めます）。画面を「PDF として保存」したものや、スキャン・写真から作った PDF は、文字を取り出せないので中身が空になります。");
     }
     return null;
   }
@@ -16264,7 +16287,17 @@ ${calendarAddUrl.toString()}
     if (!mapAsOf) return;
     wrap.appendChild(el("p", { class: "conn-map-asof", text: "設定と件数は " + mapAsOf + " 時点・接続状態は最新です。" }));
   }
-  function opsCard(icon, title, desc, kind, btnLabel) {
+  /**
+   * 手動投入のカード。hint は任意（#663）。
+   *
+   * **説明文と同じ段落に混ぜない。** 1 段目（desc）は「押すと何が起きるか」、
+   * 2 段目（hint）は「どう送ると良いか」で役割が違う。渡さなければ段ごと出ないので、
+   * 会議のカードは 1 文字も変わらない。
+   *
+   * ⚠ この関数は埋め込み JS（テンプレートリテラル）の中にある。**コメントにバッククォートを
+   * 書かない**——その場でリテラルが閉じて、離れた行が構文エラーになる。
+   */
+  function opsCard(icon, title, desc, kind, btnLabel, hint) {
     var btn = el("button", { class: "ops-card-btn", text: "＋ " + btnLabel });
     btn.addEventListener("click", function () { openIntakeModal(kind); });
     return el("div", { class: "ops-card" }, [
@@ -16273,6 +16306,7 @@ ${calendarAddUrl.toString()}
         el("h3", { class: "ops-card-title", text: title }),
       ]),
       el("p", { class: "ops-card-desc", text: desc }),
+      hint ? el("p", { class: "ops-card-hint", text: hint }) : null,
       btn,
     ]);
   }
@@ -16417,9 +16451,19 @@ ${calendarAddUrl.toString()}
     var mk = makeModal(isT ? "会議の文字起こしを追加" : "共有資料を追加", false);
     var overlay = mk.overlay;
     var modal = mk.modal;
+    // 🔴 **資料の案内はカードだけでは届かない**（#663・設計レビュー🔴2）。makeModal は
+    // 前のオーバーレイを必ず閉じるので、**ファイルを選ぶ瞬間、カードの hint は画面に無い**。
+    // 事故（画面を印刷した PDF を投入して日本語 0 文字）が起きるのはこの文を読んでいる最中なので、
+    // 症状と一手はここにも要る。**カードと同じ文は書かない**——「繰り返さない」は
+    // 「同じ説明を段を変えて並べるな」であって、事故の瞬間に黙れという意味ではない。
+    // **症状を括弧に落として一手を前に出す**（実装レビュー🟡3）。ただし症状そのものは消さない
+    // ——元のファイルを持っていない人（Slack の画面を保存した人）には「元のファイルを優先」が
+    // 一手にならず、自分の PDF が駄目だと分かるのは症状の側だけだから。
+    // 列挙の先頭を PDF から元のファイルに入れ替えてある（**受け付ける拡張子は 1 つも変えていない**。
+    // allowedExt は下のまま）。
     modal.appendChild(el("p", { class: "modal-desc", text: isT
       ? "文字起こしファイル（テキスト・Word・PDF・字幕 等）を選んで送信してください。（送信後、数分で議事録が自動生成されます）"
-      : "資料ファイル（PDF・Word・PowerPoint・Excel・テキスト・画像 等）を選んで送信してください。（送信後、数分で内容が Markdown に変換されて取り込まれます）" }));
+      : "資料ファイル（PowerPoint・Word・Excel・PDF・テキスト・画像 等）を選んで送信してください。元のファイルがあれば PDF より優先してください（画面を保存した PDF・スキャンした PDF からは文字を取り出せません）。（送信後、数分で内容が Markdown に変換されて取り込まれます）" }));
 
     var selectedFiles = [];
     var allowedExt = isT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takagaki/cortex-decisions-viewer",
-  "version": "0.12.71",
+  "version": "0.12.72",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,