@helpfeel/cosense-cli 1.7.0 → 1.10.0

package/README.md

@@ -6,6 +6,8 @@ Cosenseのページを読み・調べ・編集するAgent SkillとCLI
 
 ### for Claude Code
 
+Claude Codeを起動し、インストールコマンドを実行する
+
 ```
 /plugin marketplace add helpfeel/cosense-cli
 ```
@@ -14,10 +16,20 @@ Cosenseのページを読み・調べ・編集するAgent SkillとCLI
 /plugin install cosense-cli@cosense-cli
 ```
 
+Claude CodeはSkillの自動更新が設定可能です。 `/plugins` からMarketplaceを選択し、有効化してください。
+
 ### for Codex
 
+Codexに入らず、ターミナルでインストールコマンドを実行する
+
+```
+npx skills install helpfeel/cosense-cli --agent codex
+```
+
+CodexはSkillの自動更新ができません。手動更新してください。
+
 ```
-$skill-installer https://github.com/helpfeel/cosense-cli
+npx skills update cosense
 ```
 
 ## Install CLI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.7.0",
+  "version": "1.10.0",
   "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skill用のCLI",
   "homepage": "https://github.com/helpfeel/cosense-cli",
   "license": "MIT",
@@ -29,8 +29,8 @@
   "devDependencies": {
     "@types/node": "24.13.2",
     "npm-run-all": "4.1.5",
-    "oxfmt": "0.54.0",
-    "oxlint": "1.70.0",
+    "oxfmt": "0.56.0",
+    "oxlint": "1.71.0",
     "typescript": "6.0.3"
   },
   "engines": {

package/src/commands/browsePage.ts

@@ -1,4 +1,6 @@
 import { enrichTimestampsOf } from '../lib/enrichTimestamps.ts';
+import { applyFileMarkup, fetchFileMarkups } from '../lib/fileMarkup.ts';
+import { renderLiterateDatabase } from '../lib/literateDatabase.ts';
 import { parsePageUrl } from '../lib/parseUrl.ts';
 import { fetchRelatedPages } from '../lib/relatedPages.ts';
 import {
@@ -54,13 +56,38 @@ Usage:
     0件の場合はセクションごと省略
 
   ## 本文
-    各行の text を改行で結合。fragment 指定行のみ末尾に  #<lineId>  を付与
+    各行の text を改行で結合。fragment 指定行のみ末尾に  #<lineId>  を付与。
+    本文中の、ページと同じhostのアップロードファイルURL (https://<host>/files/<fileId>[.<ext>])
+    は、囲むbracketごと1行の <cosense:file> タグに展開する。
+      type          string?  ファイルのContent-Type
+      url           string   元のファイルURL
+      originalname  string?  アップロード時のファイル名
+      size          number?  ファイルのbyte数
+      description   string?  ファイルから抽出されたテキスト（画像のOCR、PDFの本文等）。
+                             先頭2000文字まで、超えた分は … に切り詰める。
+                             改行・"・バックスラッシュは \\n \\" \\\\ にエスケープ
+    本文中のGyazo URL (https://gyazo.com/<hash> とその変種) も同様に
+    <cosense:gyazo> タグに展開する。
+      type       string   photo または video
+      url        string   元のGyazo URL
+      thumbnail  string   curl等で直接取得できるプレビュー画像URL。photoは縮小版、
+                          videoは動画から切り出された静止ポスター
+      image      string?  photoの原寸画像URL
+      width      number?  原寸の横px
+      height     number?  原寸の縦px
+      title      string?  Gyazoに設定されたタイトル
+    ファイル・Gyazoの情報を取得できなかった時（非公開・削除済み等）や、別host・query/hash
+    付きのURLはタグ化されず、そのまま残る
 
   -------------------- Related Pages --------------------
     本文と関連ページ一覧の境界を示す非Markdown区切り線。Cosenseの#hashtag記法と
     衝突しないようにMarkdown見出しを避ける。
   ## 1 hop link
-    このページの 1-hop 近傍ページタイトル一覧。 1-hop が 0 件なら区切り線ごと省略
+    このページの 1-hop 近傍ページタイトル一覧。 0 件なら区切り線ごと省略。
+    このページがinfobox定義ページ（本文に table:infobox または table:cosense を宣言している）の
+    時は ## 1 hop link（Infoboxの文芸的データベース、TSV形式のテーブル） に変わる。表の構造は
+    cosense browseRelatedPages --help を参照。表に載らなかったページは
+    ## 1 hop link（表に載っていないページ） に出力する
 
 persistent: false の時:
   メタデータ・アイコン・テロメア・Infoboxは省略。 (このページはまだ作成されていません) と
@@ -119,6 +146,7 @@ interface PageData {
   lines?: PageLine[];
   icons?: string[];
   infoboxResult?: InfoboxResult[];
+  infoboxDefinition?: string[];
 }
 
 const LINE_ID_PATTERN = /^[0-9a-f]{24}$/;
@@ -268,11 +296,15 @@ interface BodyRender {
   matchedFragment: boolean;
 }
 
-const renderBody = (lines: PageLine[], fragment: string | null): BodyRender => {
+const renderBody = (
+  lines: PageLine[],
+  fragment: string | null,
+  fileMarkups: Map<string, string>
+): BodyRender => {
   let matchedFragment = false;
   const out: string[] = [];
   for (const line of lines) {
-    const text = normalizeIndent(line.text ?? '');
+    const text = applyFileMarkup(normalizeIndent(line.text ?? ''), fileMarkups);
     if (fragment && line.id === fragment) {
       matchedFragment = true;
       out.push(`${text}\t#${line.id}`);
@@ -283,11 +315,26 @@ const renderBody = (lines: PageLine[], fragment: string | null): BodyRender => {
   return { body: out.join('\n'), matchedFragment };
 };
 
-const renderRelatedPages = (hopValue: unknown): string | null => {
+const renderRelatedPages = (
+  hopValue: unknown,
+  page: PageData
+): string | null => {
+  const sections: string[] = [];
+  // seen は文芸的データベースと 1 hop link で共有して、表に載ったページを再掲しないようにする
+  const seen = new Set<string>();
+  const literateDatabase = renderLiterateDatabase(page, hopValue, seen);
+  if (literateDatabase) sections.push(literateDatabase);
+
   const links1hop = (hopValue as { links1hop?: RelatedPage[] }).links1hop;
-  const pages = dedupAndSortByPageRank(links1hop);
-  if (pages.length === 0) return null;
-  return `-------------------- Related Pages --------------------\n\n## 1 hop link\n\n${renderGroups(buildGroups(pages))}`;
+  const pages = dedupAndSortByPageRank(links1hop, seen);
+  if (pages.length > 0) {
+    const heading = literateDatabase
+      ? '## 1 hop link（表に載っていないページ）'
+      : '## 1 hop link';
+    sections.push(`${heading}\n\n${renderGroups(buildGroups(pages))}`);
+  }
+  if (sections.length === 0) return null;
+  return `-------------------- Related Pages --------------------\n\n${sections.join('\n\n')}`;
 };
 
 export const browsePage = async (args: string[]): Promise<void> => {
@@ -315,19 +362,26 @@ export const browsePage = async (args: string[]): Promise<void> => {
 
   if (!persistent) {
     sections.push('(このページはまだ作成されていません)');
-    const { body } = renderBody(page.lines ?? [], null);
+    const { body } = renderBody(page.lines ?? [], null, new Map());
     sections.push(`## 本文（テンプレート）\n\n${body}`);
-    const related = renderRelatedPages(hopValue);
+    const related = renderRelatedPages(hopValue, page);
     if (related) sections.push(related);
     process.stdout.write(`${sections.join('\n\n')}\n`);
     return;
   }
 
+  const fileMarkups = await fetchFileMarkups(
+    (page.lines ?? []).map(line => line.text ?? ''),
+    origin,
+    credential
+  );
+
   // 本文を先にrenderしてfragment一致状況を取得し、タイトル直後の説明文に反映する
   const validFragment = fragment !== null && LINE_ID_PATTERN.test(fragment);
   const { body, matchedFragment } = renderBody(
     page.lines ?? [],
-    validFragment ? fragment : null
+    validFragment ? fragment : null,
+    fileMarkups
   );
   if (fragment !== null) {
     if (!validFragment) {
@@ -368,7 +422,7 @@ export const browsePage = async (args: string[]): Promise<void> => {
 
   sections.push(`## 本文\n\n${body}`);
 
-  const related = renderRelatedPages(hopValue);
+  const related = renderRelatedPages(hopValue, page);
   if (related) sections.push(related);
 
   process.stdout.write(`${sections.join('\n\n')}\n`);

package/src/commands/browseRelatedPages.ts

@@ -4,12 +4,19 @@ import {
   type Page,
   renderGroups
 } from '../lib/relatedPagesFormat.ts';
+import {
+  type DefinitionPage,
+  renderLiterateDatabase
+} from '../lib/literateDatabase.ts';
 import { fetchRelatedPages } from '../lib/relatedPages.ts';
+import { parsePageUrl } from '../lib/parseUrl.ts';
+import { requestJson } from '../lib/request.ts';
+import { resolveCredential } from '../lib/settings.ts';
 
 export const browseRelatedPagesSummary =
-  '1-hop+2-hopの関連ページタイトル一覧をAIが読みやすい形式で出力する';
+  '1-hop+2-hopの関連ページタイトル一覧をAIが読みやすい形式で出力する。infobox定義ページでは文芸的データベース(TSV表)を出力する';
 
-export const browseRelatedPagesHelp = `browseRelatedPages - 1-hop+2-hopの関連ページタイトル一覧をAIが読みやすい形式で出力する
+export const browseRelatedPagesHelp = `browseRelatedPages - 1-hop+2-hopの関連ページタイトル一覧をAIが読みやすい形式で出力する。infobox定義ページでは文芸的データベース(TSV表)を出力する
 
 Usage:
   cosense browseRelatedPages <pageUrl>
@@ -32,6 +39,26 @@ Usage:
   ## 2 hop link
 
   - タイトル
+
+対象がinfobox定義ページ（本文に table:infobox または table:cosense を宣言している）の時:
+  Web UIと同様に、関連ページリストの先頭が文芸的データベース（TSV形式のテーブル）になる。
+  行 = このページにリンクしているページ（pageRank 降順）。
+  列 = Page / Created / Updated + 定義された項目。
+  セル = 各ページの本文からInfoboxが抜き出した値（Cosense記法のまま。セル内の改行は「 / 」に置換）。
+  表に載らなかった関連ページは、続く ## 1 hop link（表に載っていないページ） に出力する。
+
+  # Related Pages
+
+  ## 1 hop link（Infoboxの文芸的データベース、TSV形式のテーブル）
+
+  Page/Created/Updated以外の列は、各ページの本文からInfoboxが抜き出した値
+
+  Page	Created	Updated	材料	カテゴリ
+  麻婆豆腐	2018-03-04	2026-07-05	[豆腐]、[挽き肉]	中華
+
+  ## 1 hop link（表に載っていないページ）
+
+  - 料理
 `;
 
 export const browseRelatedPages = async (args: string[]): Promise<void> => {
@@ -39,8 +66,15 @@ export const browseRelatedPages = async (args: string[]): Promise<void> => {
     throw new Error('Usage: cosense browseRelatedPages <pageUrl>');
   }
   const [url] = args as [string];
+  const { origin, projectName, encodedTitle } = parsePageUrl(url);
+  const credential = resolveCredential(origin, projectName);
 
-  const [result1hop, result2hop] = await Promise.allSettled([
+  // ページ本体はinfobox定義の取得にだけ使う。失敗しても従来のタイトル一覧に
+  // フォールバックできるよう、関連ページの取得失敗とは区別する
+  const [resultPage, result1hop, result2hop] = await Promise.allSettled([
+    requestJson(`${origin}/api/pages/v2/${projectName}/${encodedTitle}`, {
+      credential
+    }) as Promise<DefinitionPage>,
     fetchRelatedPages(url, 1),
     fetchRelatedPages(url, 2)
   ]);
@@ -49,8 +83,35 @@ export const browseRelatedPages = async (args: string[]): Promise<void> => {
     throw result1hop.reason;
   }
 
-  // seen は 1-hop と 2-hop で共有して、 1-hop に出たページが 2-hop にも再掲されないようにする
+  const sections: string[] = [];
+  // seen は文芸的データベース・1-hop・2-hopで共有して、先に出たページを再掲しないようにする
   const seen = new Set<string>();
+
+  let hasLiterateDatabase = false;
+  if (resultPage.status === 'rejected') {
+    // 非定義ページと区別が付かないまま黙って通常出力に落ちると、AIが不完全な
+    // 出力を信じてしまうので、判定不能である事をstderrで知らせる
+    process.stderr.write(
+      'ページ情報の取得に失敗したため、infobox定義ページかどうか判定できません。文芸的データベースがあっても出力されません\n'
+    );
+  } else if (result1hop.status === 'fulfilled') {
+    const literateDatabase = renderLiterateDatabase(
+      resultPage.value,
+      result1hop.value,
+      seen
+    );
+    if (literateDatabase) {
+      sections.push(literateDatabase);
+      hasLiterateDatabase = true;
+    }
+  } else if ((resultPage.value.infoboxDefinition?.length ?? 0) > 0) {
+    // infobox定義ページだと確定しているのに関連ページの取得に失敗した場合も、
+    // 表が黙って欠落しないように知らせる
+    process.stderr.write(
+      '関連ページの取得に失敗したため、このinfobox定義ページの文芸的データベースを出力できません\n'
+    );
+  }
+
   const pages1hop =
     result1hop.status === 'fulfilled'
       ? dedupAndSortByPageRank(
@@ -66,9 +127,11 @@ export const browseRelatedPages = async (args: string[]): Promise<void> => {
         )
       : [];
 
-  const sections: string[] = [];
   if (pages1hop.length > 0) {
-    sections.push(`## 1 hop link\n\n${renderGroups(buildGroups(pages1hop))}`);
+    const heading = hasLiterateDatabase
+      ? '## 1 hop link（表に載っていないページ）'
+      : '## 1 hop link';
+    sections.push(`${heading}\n\n${renderGroups(buildGroups(pages1hop))}`);
   }
   if (pages2hop.length > 0) {
     sections.push(`## 2 hop link\n\n${renderGroups(buildGroups(pages2hop))}`);

package/src/lib/fileMarkup.ts

@@ -0,0 +1,169 @@
+import { requestJson } from './request.ts';
+import type { Credential } from './settings.ts';
+
+// 本文中のGCSアップロードファイルURL。末尾の (?![^\s[\]]) 境界で、直後に空白・bracket・
+// 行末以外（?・#・余分なpath等）が続くURLは弾き、clean URLだけをマッチする。query/hash
+// 付き等はマッチせず本文にそのまま残る。拡張子は .tar.gz 等の多重ドットも丸ごと取る
+const FILE_URL_PATTERN =
+  /https?:\/\/[^\s[\]]+\/files\/([0-9a-f]{24})(?:\.[A-Za-z0-9]+)*(?![^\s[\]])/g;
+
+// Gyazo URLの変種（i.gyazo.com/<hash>.<ext>、/raw付き、t.gyazo.com/teams/<team>/<hash>）
+// もまとめてマッチし、hashでoEmbedを引く。FILE_URL_PATTERNと同じ末尾境界でquery/hash付きは残す
+const GYAZO_URL_PATTERN =
+  /https?:\/\/(?:[a-z0-9-]+\.)?gyazo\.com\/(?:teams\/[^\s/[\]]+\/)?([0-9a-f]{32})(?:\/raw|\.[A-Za-z0-9]+)?(?![^\s[\]])/g;
+
+// 本文の行を1回のスキャンで両方置換するための結合パターン
+const EMBED_URL_PATTERN = new RegExp(
+  `${FILE_URL_PATTERN.source}|${GYAZO_URL_PATTERN.source}`,
+  'g'
+);
+
+interface FileInfo {
+  contentType?: string;
+  originalname?: string;
+  size?: number;
+  text?: string;
+}
+
+interface GyazoOEmbed {
+  type?: string;
+  url?: string;
+  thumbnail_url?: string;
+  // 読めないhashでも200が返り、width/heightが空文字になる。numberであることが
+  // 実体の存在確認になる
+  width?: number | string;
+  height?: number | string;
+  title?: string;
+}
+
+// browsePage出力全体の肥大を防ぐ。全文が必要ならreadFileInfoで取れる
+const DESCRIPTION_MAX_CHARS = 2000;
+
+// 雰囲気マークアップを1行に収めて本文の行構造を保つ
+const escapeAttr = (value: string): string =>
+  value.replaceAll('\\', '\\\\').replaceAll('"', '\\"').replaceAll('\n', '\\n');
+
+const renderFileTag = (url: string, info: FileInfo): string => {
+  const attrs: string[] = [];
+  if (info.contentType) attrs.push(`type="${escapeAttr(info.contentType)}"`);
+  attrs.push(`url="${escapeAttr(url)}"`);
+  if (info.originalname) {
+    attrs.push(`originalname="${escapeAttr(info.originalname)}"`);
+  }
+  if (typeof info.size === 'number') attrs.push(`size="${info.size}"`);
+  const text = info.text?.trim();
+  if (text) {
+    const truncated =
+      text.length > DESCRIPTION_MAX_CHARS
+        ? `${text.slice(0, DESCRIPTION_MAX_CHARS)}…`
+        : text;
+    attrs.push(`description="${escapeAttr(truncated)}"`);
+  }
+  return `<cosense:file ${attrs.join(' ')}>`;
+};
+
+const renderGyazoTag = (
+  url: string,
+  hash: string,
+  info: GyazoOEmbed
+): string | null => {
+  const attrs: string[] = [`type="${escapeAttr(info.type ?? '')}"`];
+  attrs.push(`url="${escapeAttr(url)}"`);
+  if (info.type === 'photo') {
+    if (typeof info.width !== 'number' || !info.url) return null;
+    attrs.push(`thumbnail="https://gyazo.com/${hash}/thumb/1000"`);
+    attrs.push(`image="${escapeAttr(info.url)}"`);
+  } else if (info.type === 'video') {
+    if (!info.thumbnail_url) return null;
+    attrs.push(`thumbnail="${escapeAttr(info.thumbnail_url)}"`);
+  } else {
+    return null;
+  }
+  if (typeof info.width === 'number') attrs.push(`width="${info.width}"`);
+  if (typeof info.height === 'number') attrs.push(`height="${info.height}"`);
+  if (info.title) attrs.push(`title="${escapeAttr(info.title)}"`);
+  return `<cosense:gyazo ${attrs.join(' ')}>`;
+};
+
+const collectMatches = (
+  lines: string[],
+  pattern: RegExp
+): Map<string, string> => {
+  const found = new Map<string, string>();
+  for (const line of lines) {
+    for (const m of line.matchAll(pattern)) {
+      found.set(m[0], m[1] as string);
+    }
+  }
+  return found;
+};
+
+export const fetchFileMarkups = async (
+  lines: string[],
+  pageOrigin: string,
+  pageCredential: Credential | undefined
+): Promise<Map<string, string>> => {
+  const files = collectMatches(lines, FILE_URL_PATTERN);
+  const gyazos = collectMatches(lines, GYAZO_URL_PATTERN);
+  const markups = new Map<string, string>();
+
+  // ページと同じhostのアップロードファイルだけタグ展開する。cross-originのURLに
+  // ページのcredential（env COSENSE_PATを含む）を送るとPAT漏洩になるため、別host・
+  // 不正URL・取得失敗（404・権限なし・非公開Gyazo等）はいずれもURLのまま本文に残す。
+  // 従来の出力と同じに劣化するだけで、AIはURLからファイルの存在を認知できる
+  const fileTasks = [...files].map(async ([url, fileId]) => {
+    try {
+      if (new URL(url).origin !== pageOrigin) return;
+      const info = (await requestJson(`${pageOrigin}/api/gcs/${fileId}/info`, {
+        credential: pageCredential
+      })) as FileInfo;
+      markups.set(url, renderFileTag(url, info));
+    } catch {}
+  });
+
+  // 同じhashの変種URLが複数あってもoEmbedは1回だけ引く
+  const gyazoInfos = new Map<string, Promise<GyazoOEmbed | null>>();
+  for (const hash of new Set(gyazos.values())) {
+    gyazoInfos.set(
+      hash,
+      requestJson(
+        `https://api.gyazo.com/api/oembed?url=https://gyazo.com/${hash}`
+      ).then(
+        info => info as GyazoOEmbed,
+        () => null
+      )
+    );
+  }
+  const gyazoTasks = [...gyazos].map(async ([url, hash]) => {
+    const info = await gyazoInfos.get(hash);
+    if (!info) return;
+    const markup = renderGyazoTag(url, hash, info);
+    if (markup) markups.set(url, markup);
+  });
+
+  await Promise.all([...fileTasks, ...gyazoTasks]);
+  return markups;
+};
+
+export const applyFileMarkup = (
+  line: string,
+  markups: Map<string, string>
+): string => {
+  if (markups.size === 0) return line;
+  let out = '';
+  let cursor = 0;
+  for (const m of line.matchAll(EMBED_URL_PATTERN)) {
+    const markup = markups.get(m[0]);
+    if (!markup) continue;
+    let start = m.index;
+    let end = start + m[0].length;
+    // 画像記法 [url] や強調 [[url]] はbracketごとタグに置き換える
+    while (line[start - 1] === '[' && line[end] === ']') {
+      start -= 1;
+      end += 1;
+    }
+    out += line.slice(cursor, start) + markup;
+    cursor = end;
+  }
+  return out + line.slice(cursor);
+};

package/src/lib/literateDatabase.ts

@@ -0,0 +1,133 @@
+import { type Page, toTitleLc } from './relatedPagesFormat.ts';
+
+interface InfoboxResultEntry {
+  title?: string;
+  infobox?: Record<string, string>;
+}
+
+export interface LiterateDatabaseSourcePage extends Page {
+  linksLc?: string[];
+  created?: number;
+  updated?: number;
+  infoboxResult?: InfoboxResultEntry[];
+  infoboxDisableLinks?: string[];
+}
+
+interface Links1hopResponse {
+  links1hop?: LiterateDatabaseSourcePage[];
+  pagination?: { total?: number; hasNext?: boolean };
+}
+
+export interface DefinitionPage {
+  title?: string;
+  infoboxDefinition?: string[];
+}
+
+// 定義行はタブ区切りで、第1セルが列名。第2セル以降はInfoboxが値を抜き出す時の
+// 指示文なので列にしない。第1セルがオプション宣言 (ExcludeTitleLine) の行も列にしない。
+// 列名をtrimしないのは意図的: infoboxResultのkeyは未trimの第1セルで生成されるため、
+// trimするとlookupが外れる（オプション宣言の判定だけがtrim込みで行われる）
+const parseInfoboxFieldNames = (infoboxDefinition: string[]): string[] => {
+  const fieldNames: string[] = [];
+  for (const row of infoboxDefinition) {
+    const firstCell = row.split('\t')[0] ?? '';
+    if (firstCell.trim() === 'ExcludeTitleLine') continue;
+    fieldNames.push(firstCell);
+  }
+  return fieldNames;
+};
+
+interface LiterateDatabaseRow {
+  page: LiterateDatabaseSourcePage;
+  infobox: Record<string, string>;
+}
+
+// 行選定はWeb UIの文芸的データベースと同じ:
+// 定義ページにリンクしているページのうち、無効化されていないもの。
+// 並びは通常の関連ページリストとソート基準を揃えたpageRank降順（Web UIとは異なる）
+const buildRows = (
+  definition: DefinitionPage,
+  links1hop: LiterateDatabaseSourcePage[]
+): LiterateDatabaseRow[] => {
+  const definitionTitleLc = toTitleLc(definition.title ?? '');
+
+  const rows: LiterateDatabaseRow[] = [];
+  for (const page of links1hop) {
+    const linksLc = page.linksLc ?? [];
+    if (!linksLc.includes(definitionTitleLc)) continue;
+    if (page.infoboxDisableLinks?.includes(definitionTitleLc)) continue;
+
+    const infobox =
+      page.infoboxResult?.find(
+        entry => toTitleLc(entry.title ?? '') === definitionTitleLc
+      )?.infobox ?? {};
+    rows.push({ page, infobox });
+  }
+
+  rows.sort((a, b) => (b.page.pageRank ?? 0) - (a.page.pageRank ?? 0));
+  return rows;
+};
+
+// TSVの1ページ=1行を守るため、セル内の改行・タブを置換する。
+// セル値はAIが抽出した物なので、文字列以外が混ざっていても落ちないように文字列化する
+const sanitizeCell = (value: unknown): string =>
+  String(value ?? '')
+    .replace(/\t/g, ' ')
+    .replace(/\r\n|[\r\n]/g, ' / ');
+
+const formatDateCell = (unixSec: number | undefined): string => {
+  if (typeof unixSec !== 'number') return '';
+  const d = new Date(unixSec * 1000);
+  const month = String(d.getMonth() + 1).padStart(2, '0');
+  const day = String(d.getDate()).padStart(2, '0');
+  return `${d.getFullYear()}-${month}-${day}`;
+};
+
+// 対象がinfobox定義ページなら文芸的データベースのセクションを組み立てる。
+// 定義ページでなければ null。表に載せたページは seen に積み、呼び出し側の
+// 1 hop link 一覧に再掲されないようにする
+export const renderLiterateDatabase = (
+  definition: DefinitionPage,
+  hopValue: unknown,
+  seen: Set<string>
+): string | null => {
+  const infoboxDefinition = definition.infoboxDefinition ?? [];
+  if (infoboxDefinition.length === 0) return null;
+
+  const { links1hop = [], pagination } = (hopValue ?? {}) as Links1hopResponse;
+  const fieldNames = parseInfoboxFieldNames(infoboxDefinition);
+  const rows = buildRows(definition, links1hop);
+  for (const { page } of rows) {
+    seen.add(page.titleLc ?? toTitleLc(page.title));
+  }
+
+  const header = ['Page', 'Created', 'Updated', ...fieldNames].join('\t');
+  const lines = rows.map(({ page, infobox }) =>
+    [
+      sanitizeCell(page.title),
+      formatDateCell(page.created),
+      formatDateCell(page.updated),
+      ...fieldNames.map(field => sanitizeCell(infobox[field] ?? ''))
+    ].join('\t')
+  );
+
+  // 見出しは通常ページの「1 hop link」に揃える。「文芸的データベース」を見出し単体で
+  // 使うと、出力だけを読むAIが同名ページを探しに行ってしまう。ただしユーザーはこの表を
+  // 「文芸的データベース」「Infoboxの表」「テーブル」等とも呼ぶので、指示と結びつくよう
+  // 別名として括弧内に残す
+  const parts = [
+    '## 1 hop link（Infoboxの文芸的データベース、TSV形式のテーブル）',
+    'Page/Created/Updated以外の列は、各ページの本文からInfoboxが抜き出した値',
+    [header, ...lines].join('\n')
+  ];
+  if (rows.length === 0) {
+    // ヘッダーだけの表は出力が途切れたようにも見えるので、0件である事を明示する
+    parts.push('表に載るページが無いため、行は0件');
+  }
+  if (pagination?.hasNext) {
+    parts.push(
+      `注意: 関連ページが多いため、全${pagination.total}件のうち取得できた${links1hop.length}件から表を構成しています`
+    );
+  }
+  return parts.join('\n\n');
+};

package/src/lib/relatedPagesFormat.ts

@@ -40,7 +40,7 @@ export const buildGroups = (pages: Page[]): Group[] => {
   return groups;
 };
 
-const toTitleLc = (title: string): string =>
+export const toTitleLc = (title: string): string =>
   title.replace(/ /g, '_').toLowerCase();
 
 export const dedupAndSortByPageRank = (