@helpfeel/cosense-cli 1.15.0 → 1.16.1

package/README.md

@@ -45,4 +45,8 @@ cosense --help
 
 - install [direnv](https://direnv.net/)
 - run `npm install`
+- install [Codex CLI](https://github.com/openai/codex) and run `codex login`
+  - modelは `gpt-5.6-sol`、reasoning effortは `high` 以上を推奨
 - run `claude` or `codex`
+
+Claude Codeでこのディレクトリをtrustすると、開発フローで使うpluginが `.claude/settings.json` によりインストールされる。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skillのハーネス",
   "homepage": "https://github.com/helpfeel/cosense-cli",
   "license": "MIT",
@@ -24,13 +24,13 @@
     "format": "oxfmt"
   },
   "dependencies": {
-    "tsx": "4.23.13"
+    "tsx": "4.23.15"
   },
   "devDependencies": {
-    "@types/node": "24.13.3",
+    "@types/node": "24.13.6",
     "npm-run-all": "4.1.5",
-    "oxfmt": "0.65.0",
-    "oxlint": "1.80.0",
+    "oxfmt": "0.70.0",
+    "oxlint": "1.85.0",
     "typescript": "7.0.2"
   },
   "engines": {

package/src/commands/browsePage.ts

@@ -1,4 +1,8 @@
 import { enrichTimestampsOf } from '../lib/enrichTimestamps.ts';
+import {
+  encodeTitleForReadableLink,
+  encodeTitleForUrl
+} from '../lib/encodeTitle.ts';
 import { applyFileMarkup, fetchFileMarkups } from '../lib/fileMarkup.ts';
 import { renderLiterateDatabase } from '../lib/literateDatabase.ts';
 import { parsePageUrl } from '../lib/parseUrl.ts';
@@ -34,9 +38,11 @@ Usage:
   # <title>
 
   ## メタデータ
-    タイトル / pageId / commitId / 作成日時 / 最終更新日時 / 最終アクセス日時 /
-    被リンク数 / pageRank / views / snapshot / 行数 / 文字数 / 作成者 / 最終更新者 /
-    関わったユーザー
+    タイトル / URL / Readable link / pageId / commitId / 作成日時 / 最終更新日時 /
+    最終アクセス日時 / 被リンク数 / pageRank / views / snapshot / 行数 / 文字数 /
+    作成者 / 最終更新者 / 関わったユーザー
+    URL はタイトルをパーセントエンコードしたページURL
+    Readable link は日本語等を生で残した同じページのURL（Cosenseの「Copy readable link」相当）
     pageId はページの不変ID、commitId は閲覧時点の最新コミット。共同編集中に
     ページを見失ったら、これらを browsePageChanges に渡して変更（リネーム含む）を辿れる
 
@@ -90,8 +96,8 @@ Usage:
     ## 1 hop link（表に載っていないページ） に出力する
 
 persistent: false の時:
-  メタデータ・アイコン・テロメア・Infoboxは省略。 (このページはまだ作成されていません) と
-  本文（テンプレート）と Related Pages を出力する
+  アイコン・テロメア・Infoboxは省略し、メタデータはURLとReadable linkだけを出力する。
+  (このページはまだ作成されていません) と 本文（テンプレート）と Related Pages を出力する
 
 URLに #<lineId> fragmentが指定された時:
   タイトル直後に判定結果を1行出力する。
@@ -206,9 +212,15 @@ const buildTelomere = (lines: PageLine[]): TelomereEntry[] => {
   return [...byUser.values()].sort((a, b) => b.lineCount - a.lineCount);
 };
 
-const renderMetadata = (page: PageData): string => {
+const renderMetadata = (
+  page: PageData,
+  pageUrl: string,
+  readableLink: string
+): string => {
   const items: string[] = [];
   if (typeof page.title === 'string') items.push(`- タイトル: ${page.title}`);
+  items.push(`- URL: ${pageUrl}`);
+  items.push(`- Readable link: ${readableLink}`);
   if (typeof page.id === 'string') items.push(`- pageId: ${page.id}`);
   if (typeof page.commitId === 'string') {
     items.push(`- commitId: ${page.commitId}`);
@@ -358,10 +370,15 @@ export const browsePage = async (args: string[]): Promise<void> => {
 
   const title = page.title ?? '';
   const persistent = page.persistent !== false;
+  const pageUrl = `${origin}/${projectName}/${encodeTitleForUrl(title)}`;
+  const readableLink = `${origin}/${projectName}/${encodeTitleForReadableLink(title)}`;
   const sections: string[] = [`# ${title}`];
 
   if (!persistent) {
     sections.push('(このページはまだ作成されていません)');
+    sections.push(
+      `## メタデータ\n\n- URL: ${pageUrl}\n- Readable link: ${readableLink}`
+    );
     const { body } = renderBody(page.lines ?? [], null, new Map());
     sections.push(`## 本文（テンプレート）\n\n${body}`);
     const related = renderRelatedPages(hopValue, page);
@@ -409,7 +426,7 @@ export const browsePage = async (args: string[]): Promise<void> => {
   ]);
   enrichPageUsers(page, userMap);
 
-  sections.push(renderMetadata(page));
+  sections.push(renderMetadata(page, pageUrl, readableLink));
 
   const iconsSection = renderHumanIcons(page.icons, userMap);
   if (iconsSection) sections.push(iconsSection);

package/src/commands/browsePageChanges.ts

@@ -1,4 +1,7 @@
-import { encodeTitleForUrl } from '../lib/encodeTitle.ts';
+import {
+  encodeTitleForReadableLink,
+  encodeTitleForUrl
+} from '../lib/encodeTitle.ts';
 import { formatTimestamp } from '../lib/formatTimestamp.ts';
 import { parseProjectUrlStrict } from '../lib/parseUrl.ts';
 import { requestJson } from '../lib/request.ts';
@@ -32,7 +35,7 @@ Usage:
 出力形式（Markdown plain text。JSONではない）:
   # ページ変更履歴
     pageId / 範囲（--since より後か全履歴か）/ commit数 / title change（変更後タイトル、無ければ なし）
-    タイトルが変わっていた時のみ、新URLも出力する
+    タイトルが変わっていた時のみ、新URLと新Readable linkも出力する
   ## 変更
     時系列の変更イベントを「<日時>\t<誰>が<何を>」の形（TAB区切り）で列挙する。
     同一行への連続した編集は1件にまとめ、変更前→最終のテキストを示す。
@@ -231,6 +234,8 @@ export const browsePageChanges = async (args: string[]): Promise<void> => {
   if (latestTitle !== undefined) {
     const newUrl = `${origin}/${projectName}/${encodeTitleForUrl(latestTitle)}`;
     meta.push(`- 新URL: ${newUrl}`);
+    const newReadableLink = `${origin}/${projectName}/${encodeTitleForReadableLink(latestTitle)}`;
+    meta.push(`- 新Readable link: ${newReadableLink}`);
   }
   sections.push(meta.join('\n'));
 

package/src/commands/submitEdit.ts

@@ -1,4 +1,7 @@
-import { encodeTitleForUrl } from '../lib/encodeTitle.ts';
+import {
+  encodeTitleForReadableLink,
+  encodeTitleForUrl
+} from '../lib/encodeTitle.ts';
 import { parseProjectUrlStrict } from '../lib/parseUrl.ts';
 import { requestJson } from '../lib/request.ts';
 import { resolveCredential } from '../lib/settings.ts';
@@ -18,11 +21,12 @@ Usage:
 戻り値（plain text）:
   commitId: <生成されたcommitのID>
   title:    <実際に書き込まれたpage title>
-  url:      <作成または更新された page の URL>
+  url:      <作成または更新された page の URL。タイトルはパーセントエンコード済み>
+  readableLink: <同じ page の URL。日本語等を生で残す（Cosenseの「Copy readable link」相当）>
 
-  url はサーバーが返す title から再構築される。 同名ページが既に存在する場合、 サーバーは
-  タイトルに auto-suffix を付ける (新規作成でも既存ページのタイトル変更でも起きる)。
-  title/url にはその suffix が反映される。
+  url と readableLink はサーバーが返す title から再構築される。 同名ページが既に存在する場合、
+  サーバーはタイトルに auto-suffix を付ける (新規作成でも既存ページのタイトル変更でも起きる)。
+  title/url/readableLink にはその suffix が反映される。
 
   既存ページのタイトルが変わった編集では、続けて以下を出力する:
   titleChanged: "<変更前title>" -> "<変更後title>"
@@ -89,8 +93,9 @@ export const submitEdit = async (args: string[]): Promise<void> => {
     );
   }
   const url = `${origin}/${projectName}/${encodeTitleForUrl(title)}`;
+  const readableLink = `${origin}/${projectName}/${encodeTitleForReadableLink(title)}`;
   process.stdout.write(
-    `commitId: ${response.commitId}\ntitle:    ${title}\nurl:      ${url}\n`
+    `commitId: ${response.commitId}\ntitle:    ${title}\nurl:      ${url}\nreadableLink: ${readableLink}\n`
   );
 
   // titleChangedはサーバーが対応している場合のみ返る

package/src/lib/encodeTitle.ts

@@ -1,13 +1,19 @@
-// 人が読める URL を作るための encoder (cosense 本家の「Copy readable link」 相当)。
-// Unicode 文字 (Japanese 等) は raw のまま (browser は IRI として透過処理する)。
-// cosense server の route match (`/:projectName/:title`, `:title=[^/]+`) を満たすため
-// title 内の `/` は `%2F` 必須。 URL syntax を破壊する `%` `?` `#` も percent-encode する。
-// space は cosense convention で `_` に置換。
+// 非ASCIIを生で残すと、`%2F`等と混ざったURLをmacOSのターミナルが開く時に`%`が再エンコードされ、別のページに飛ぶ
+// 半角スペースはCosenseの慣習で`_`に置換する
 export const encodeTitleForUrl = (title: string): string => {
-  return title
-    .replace(/%/g, '%25')
-    .replace(/\//g, '%2F')
-    .replace(/\?/g, '%3F')
-    .replace(/#/g, '%23')
-    .replace(/ /g, '_');
+  // 孤立サロゲートが残っているとencodeURIComponentが例外を投げる
+  return encodeURIComponent(title.toWellFormed().replace(/ /g, '_')).replace(
+    // encodeURIComponentが残すRFC 3986の予約文字。括弧はMarkdownリンクのリンク先を、`'`はshellのクォートを壊しうる
+    /[!'()*]/g,
+    c => `%${c.charCodeAt(0).toString(16).toUpperCase()}`
+  );
 };
+
+// Cosenseの「Copy readable link」と同じく、日本語等を生で残して人が読めるURLにする
+// URLパーサーは`\`を`/`と解釈し、末尾のC0制御文字を取り除く。空白文字と`<>`は貼った先でURLの自動リンクを途中で切り、`'`はshellのクォートを壊す。これらを`/` `%` `?` `#`と共にエスケープする
+export const encodeTitleForReadableLink = (title: string): string =>
+  title
+    .replace(/ /g, '_')
+    .replace(/[/%?#\\<>\p{Cc}]|\s/gu, c => encodeURIComponent(c))
+    // encodeURIComponentは`'`をエスケープしない
+    .replace(/'/g, '%27');