@helpfeel/cosense-cli 1.9.0 → 1.10.1

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.9.0",
+  "version": "1.10.1",
   "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skill用のCLI",
   "homepage": "https://github.com/helpfeel/cosense-cli",
   "license": "MIT",
@@ -24,13 +24,13 @@
     "format": "oxfmt"
   },
   "dependencies": {
-    "tsx": "4.22.4"
+    "tsx": "4.23.0"
   },
   "devDependencies": {
-    "@types/node": "24.13.2",
+    "@types/node": "24.13.3",
     "npm-run-all": "4.1.5",
-    "oxfmt": "0.56.0",
-    "oxlint": "1.71.0",
+    "oxfmt": "0.58.0",
+    "oxlint": "1.74.0",
     "typescript": "6.0.3"
   },
   "engines": {

package/src/commands/browsePage.ts

@@ -1,4 +1,5 @@
 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';
@@ -55,7 +56,28 @@ 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記法と
@@ -274,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}`);
@@ -336,7 +362,7 @@ 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, page);
     if (related) sections.push(related);
@@ -344,11 +370,18 @@ export const browsePage = async (args: string[]): Promise<void> => {
     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) {

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);
+};