@helpfeel/cosense-cli 1.4.6 → 1.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.4.6",
+  "version": "1.5.1",
   "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skill用のCLI",
   "homepage": "https://github.com/helpfeel/cosense-cli",
   "license": "MIT",
@@ -24,14 +24,14 @@
     "format": "oxfmt"
   },
   "dependencies": {
-    "tsx": "4.21.0"
+    "tsx": "4.22.4"
   },
   "devDependencies": {
-    "@types/node": "24.12.2",
+    "@types/node": "24.13.2",
     "npm-run-all": "4.1.5",
-    "oxfmt": "0.46.0",
-    "oxlint": "1.61.0",
-    "typescript": "6.0.2"
+    "oxfmt": "0.54.0",
+    "oxlint": "1.70.0",
+    "typescript": "6.0.3"
   },
   "engines": {
     "node": ">=24"

package/src/commands/browsePage.ts

@@ -16,9 +16,9 @@ import {
 import { resolveCredential } from '../lib/settings.ts';
 
 export const browsePageSummary =
-  '単一ページを読む。メタデータ+アイコン記法+テロメア+本文をAIが読みやすい形式で出力する。行permalink (`#<lineId>`) 付きなら該当行をマークする';
+  '単一ページを読む。メタデータ+アイコン記法+テロメア+Infobox+本文をAIが読みやすい形式で出力する。行permalink (`#<lineId>`) 付きなら該当行をマークする';
 
-export const browsePageHelp = `browsePage - 単一ページを読む。メタデータ+アイコン記法+テロメア+本文をAIが読みやすい形式で出力する。行permalink (#<lineId>) 付きなら該当行をマークする
+export const browsePageHelp = `browsePage - 単一ページを読む。メタデータ+アイコン記法+テロメア+Infobox+本文をAIが読みやすい形式で出力する。行permalink (#<lineId>) 付きなら該当行をマークする
 
 Usage:
   cosense browsePage <pageUrl>
@@ -46,6 +46,12 @@ Usage:
     lines[] を最終更新者でグルーピングし、 displayName  更新期間 YYYY/M/D 〜 YYYY/M/D  N行更新
     の形式で行数降順に全員出力
 
+  ## Infobox
+    このページ本文から抜き出された Infobox を出力する。各 Infobox を ### <title> の
+    見出しと  - キー: 値  の箇条書きで表す。値はCosense記法のまま。
+    hallucination または truncated と判定された Infobox は除外する。
+    0件の場合はセクションごと省略
+
   ## 本文
     各行の text を改行で結合。fragment 指定行のみ末尾に  #<lineId>  を付与
 
@@ -56,7 +62,7 @@ Usage:
     このページの 1-hop 近傍ページタイトル一覧。 1-hop が 0 件なら区切り線ごと省略
 
 persistent: false の時:
-  メタデータ・アイコン・テロメアは省略。 (このページはまだ作成されていません) と
+  メタデータ・アイコン・テロメア・Infoboxは省略。 (このページはまだ作成されていません) と
   本文（テンプレート）と Related Pages を出力する
 
 URLに #<lineId> fragmentが指定された時:
@@ -81,6 +87,13 @@ interface UserRef {
   displayName?: string;
 }
 
+interface InfoboxResult {
+  title?: string;
+  infobox?: Record<string, string>;
+  hallucination?: boolean;
+  truncated?: boolean;
+}
+
 interface PageData {
   id?: string;
   commitId?: string;
@@ -102,6 +115,7 @@ interface PageData {
   users?: UserRef[];
   lines?: PageLine[];
   icons?: string[];
+  infoboxResult?: InfoboxResult[];
 }
 
 const LINE_ID_PATTERN = /^[0-9a-f]{24}$/;
@@ -224,6 +238,23 @@ const renderTelomere = (
   return `## テロメアのサマリー\n\n${lines.join('\n')}`;
 };
 
+const renderInfobox = (results: InfoboxResult[] | undefined): string | null => {
+  if (!results) return null;
+  const blocks: string[] = [];
+  for (const result of results) {
+    // hallucination=AI補完の不確実値、truncated=抽出失敗で値が不完全。どちらも
+    // 信頼できないので丸ごと除外する
+    if (result.hallucination || result.truncated) continue;
+    const rows = Object.entries(result.infobox ?? {}).map(
+      ([key, value]) => `- ${key}: ${value}`
+    );
+    if (rows.length === 0) continue;
+    blocks.push(`### ${result.title ?? ''}\n\n${rows.join('\n')}`);
+  }
+  if (blocks.length === 0) return null;
+  return `## Infobox\n\n${blocks.join('\n\n')}`;
+};
+
 interface BodyRender {
   body: string;
   matchedFragment: boolean;
@@ -324,6 +355,9 @@ export const browsePage = async (args: string[]): Promise<void> => {
   const telomereSection = renderTelomere(telomere, userMap);
   if (telomereSection) sections.push(telomereSection);
 
+  const infoboxSection = renderInfobox(page.infoboxResult);
+  if (infoboxSection) sections.push(infoboxSection);
+
   sections.push(`## 本文\n\n${body}`);
 
   const related = renderRelatedPages(hopValue);

package/src/commands/previewEdit.ts

@@ -1,4 +1,5 @@
 import { randomBytes } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
 import { parseProjectUrlStrict } from '../lib/parseUrl.ts';
 import { requestJson } from '../lib/request.ts';
 import { resolveUserCredential } from '../lib/settings.ts';
@@ -11,6 +12,8 @@ export const previewEditHelp = `previewEdit - ページ編集opsをdry-runして
 Usage:
   cosense previewEdit <projectUrl> <pageId> < ops.json      既存ページの編集 (stdinはops JSON)
   cosense previewEdit --new <projectUrl> < body.txt         新規ページ作成 (stdinはプレーンテキスト本文)
+  cosense previewEdit --input-file ops.json <projectUrl> <pageId>
+  cosense previewEdit --new --input-file body.txt <projectUrl>
   printf '%s' '<opsJSON>' | cosense previewEdit <projectUrl> <pageId>
   printf '%s' '<text>'    | cosense previewEdit --new <projectUrl>
 
@@ -22,6 +25,8 @@ Usage:
 オプション:
   --new   stdin をプレーンテキスト本文として受け取り、 新規ページを作る。 改行で複数行に分割され、
           1行目が page title、 2行目以降が本文として扱われる。 ops JSON を組み立てる必要は無い
+  --input-file <path>
+          stdin の代わりに UTF-8 テキストファイルから入力を読む。 指定時は stdin を読まない
 
 stdinから受け取る入力形式（既存ページ編集モード, JSON）:
   {
@@ -234,23 +239,75 @@ const readStdin = async (): Promise<string> => {
   return Buffer.concat(chunks).toString('utf8');
 };
 
+// --input-file はバイト列を読んで UTF-8 として厳格に decode する。 TextDecoder の既定は
+// ignoreBOM: false なので先頭 BOM を除去し、 fatal: true で BOM付き UTF-16 や不正バイトを
+// 例外で弾く。 ただし BOM なし UTF-16LE は各バイトが偶然 valid UTF-8 になり fatal をすり抜けて
+// NUL 混じり文字列になる事があるので、 decode 後に NUL を弾く。 stdin 経由 (readStdin の
+// toString('utf8')) は不正バイトを置換して通すが、 こちらは「文字化けしたまま書き込み成功」を
+// 防ぐため早期に失敗させる。
+const readInputFileUtf8 = async (path: string): Promise<string> => {
+  let bytes: Buffer;
+  try {
+    bytes = await readFile(path);
+  } catch (err) {
+    throw new Error(
+      `--input-file: failed to read "${path}": ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  let text: string;
+  try {
+    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+  } catch {
+    throw new Error(
+      `--input-file: "${path}" is not valid UTF-8. Rewrite the file as UTF-8 (not UTF-16) and retry.`
+    );
+  }
+  if (text.includes('\u0000')) {
+    throw new Error(
+      `--input-file: "${path}" contains NUL, which suggests UTF-16 or binary, not UTF-8 text. Rewrite the file as UTF-8 (not UTF-16) and retry.`
+    );
+  }
+  return text;
+};
+
 interface ParsedArgs {
   isNew: boolean;
   projectUrl: string;
   pageId: string | undefined;
+  inputFile: string | undefined;
 }
 
 const parseArgs = (args: string[]): ParsedArgs => {
   const usage =
     'Usage: cosense previewEdit <projectUrl> <pageId> < ops.json (use --new <projectUrl> < body.txt for new pages)';
   let isNew = false;
+  let inputFile: string | undefined;
   const positional: string[] = [];
-  for (const arg of args) {
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i] as string;
     if (arg === '--new') {
       if (isNew) {
         throw new Error(`Duplicate option: --new\n${usage}`);
       }
       isNew = true;
+    } else if (arg === '--input-file') {
+      if (inputFile !== undefined) {
+        throw new Error(`Duplicate option: --input-file\n${usage}`);
+      }
+      // 空文字を素通しすると後段の truthy 判定 (!inputFile / inputFile ? ...) で
+      // 「未指定」と同じ扱いになり、 stdin を読んでしまう。 値欠落として弾く
+      const value = args[++i];
+      if (value === undefined || value === '') {
+        throw new Error(`Missing value for --input-file\n${usage}`);
+      }
+      // 次トークンが別オプション (--new 等) の時はパスの書き忘れとみなし、 黙って
+      // ファイル名として消費しない。 `--` 始まりの実ファイルは ./--name で渡せる
+      if (value.startsWith('--')) {
+        throw new Error(
+          `--input-file expects a file path, but got "${value}". A path must immediately follow --input-file.\n${usage}`
+        );
+      }
+      inputFile = value;
     } else if (arg.startsWith('--')) {
       throw new Error(`Unknown option: ${arg}\n${usage}`);
     } else {
@@ -263,7 +320,12 @@ const parseArgs = (args: string[]): ParsedArgs => {
         'Usage: cosense previewEdit --new <projectUrl> < body.txt'
       );
     }
-    return { isNew, projectUrl: positional[0] as string, pageId: undefined };
+    return {
+      isNew,
+      projectUrl: positional[0] as string,
+      pageId: undefined,
+      inputFile
+    };
   }
   if (positional.length !== 2) {
     throw new Error(usage);
@@ -271,28 +333,32 @@ const parseArgs = (args: string[]): ParsedArgs => {
   return {
     isNew,
     projectUrl: positional[0] as string,
-    pageId: positional[1] as string
+    pageId: positional[1] as string,
+    inputFile
   };
 };
 
 export const previewEdit = async (args: string[]): Promise<void> => {
-  const { isNew, projectUrl, pageId } = parseArgs(args);
+  const { isNew, projectUrl, pageId, inputFile } = parseArgs(args);
 
-  if (process.stdin.isTTY) {
+  if (!inputFile && process.stdin.isTTY) {
     throw new Error(
       isNew
-        ? 'previewEdit --new reads plain text body from stdin. Pipe it in, e.g. `printf "Title\\nbody\\n" | cosense previewEdit --new <projectUrl>`.'
-        : 'previewEdit reads ops JSON from stdin. Pipe it in, e.g. `cosense previewEdit <projectUrl> <pageId> < ops.json`.'
+        ? 'previewEdit --new reads plain text body from stdin or --input-file. Pipe it in, e.g. `printf "Title\\nbody\\n" | cosense previewEdit --new <projectUrl>`, or pass a UTF-8 file with `--input-file body.txt`.'
+        : 'previewEdit reads ops JSON from stdin or --input-file. Pipe it in, e.g. `cosense previewEdit <projectUrl> <pageId> < ops.json`, or pass a UTF-8 file with `--input-file ops.json`.'
     );
   }
 
   const { origin, projectName } = parseProjectUrlStrict(projectUrl);
-  const stdinRaw = await readStdin();
-  if (!stdinRaw.trim()) {
+  const rawInput = inputFile
+    ? await readInputFileUtf8(inputFile)
+    : await readStdin();
+  if (!rawInput.trim()) {
+    const source = inputFile ? `input file "${inputFile}"` : 'stdin';
     throw new Error(
       isNew
-        ? 'stdin is empty. Pipe page body (plain text) to stdin.'
-        : 'stdin is empty. Pipe ops JSON to stdin.'
+        ? `${source} is empty. Provide page body (plain text).`
+        : `${source} is empty. Provide ops JSON.`
     );
   }
 
@@ -302,15 +368,16 @@ export const previewEdit = async (args: string[]): Promise<void> => {
   // 慣習で末尾の単一改行 (LF または CRLF) だけ取り除く
   let ops: unknown;
   if (isNew) {
-    const body = stdinRaw.replace(/\r?\n$/, '');
+    const body = rawInput.replace(/\r?\n$/, '');
     ops = [{ insertBefore: '_end', text: body }];
   } else {
     let parsed: unknown;
     try {
-      parsed = JSON.parse(stdinRaw);
+      parsed = JSON.parse(rawInput);
     } catch (err) {
+      const source = inputFile ? `input file "${inputFile}"` : 'stdin';
       throw new Error(
-        `stdin is not valid JSON: ${err instanceof Error ? err.message : String(err)}`
+        `${source} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`
       );
     }
     ops = (parsed as { ops?: unknown }).ops;