@helpfeel/cosense-cli 1.15.0 → 1.16.0

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.0",
   "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,5 @@
 import { enrichTimestampsOf } from '../lib/enrichTimestamps.ts';
+import { 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 +35,10 @@ Usage:
   # <title>
 
   ## メタデータ
-    タイトル / pageId / commitId / 作成日時 / 最終更新日時 / 最終アクセス日時 /
+    タイトル / URL / pageId / commitId / 作成日時 / 最終更新日時 / 最終アクセス日時 /
     被リンク数 / pageRank / views / snapshot / 行数 / 文字数 / 作成者 / 最終更新者 /
     関わったユーザー
+    URL はタイトルをパーセントエンコードしたページURL
     pageId はページの不変ID、commitId は閲覧時点の最新コミット。共同編集中に
     ページを見失ったら、これらを browsePageChanges に渡して変更（リネーム含む）を辿れる
 
@@ -90,8 +92,8 @@ Usage:
     ## 1 hop link（表に載っていないページ） に出力する
 
 persistent: false の時:
-  メタデータ・アイコン・テロメア・Infoboxは省略。 (このページはまだ作成されていません) と
-  本文（テンプレート）と Related Pages を出力する
+  アイコン・テロメア・Infoboxは省略し、メタデータはURLだけを出力する。
+  (このページはまだ作成されていません) と 本文（テンプレート）と Related Pages を出力する
 
 URLに #<lineId> fragmentが指定された時:
   タイトル直後に判定結果を1行出力する。
@@ -206,9 +208,10 @@ 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): string => {
   const items: string[] = [];
   if (typeof page.title === 'string') items.push(`- タイトル: ${page.title}`);
+  items.push(`- URL: ${pageUrl}`);
   if (typeof page.id === 'string') items.push(`- pageId: ${page.id}`);
   if (typeof page.commitId === 'string') {
     items.push(`- commitId: ${page.commitId}`);
@@ -358,10 +361,12 @@ export const browsePage = async (args: string[]): Promise<void> => {
 
   const title = page.title ?? '';
   const persistent = page.persistent !== false;
+  const pageUrl = `${origin}/${projectName}/${encodeTitleForUrl(title)}`;
   const sections: string[] = [`# ${title}`];
 
   if (!persistent) {
     sections.push('(このページはまだ作成されていません)');
+    sections.push(`## メタデータ\n\n- URL: ${pageUrl}`);
     const { body } = renderBody(page.lines ?? [], null, new Map());
     sections.push(`## 本文（テンプレート）\n\n${body}`);
     const related = renderRelatedPages(hopValue, page);
@@ -409,7 +414,7 @@ export const browsePage = async (args: string[]): Promise<void> => {
   ]);
   enrichPageUsers(page, userMap);
 
-  sections.push(renderMetadata(page));
+  sections.push(renderMetadata(page, pageUrl));
 
   const iconsSection = renderHumanIcons(page.icons, userMap);
   if (iconsSection) sections.push(iconsSection);

package/src/commands/submitEdit.ts

@@ -18,7 +18,7 @@ Usage:
 戻り値（plain text）:
   commitId: <生成されたcommitのID>
   title:    <実際に書き込まれたpage title>
-  url:      <作成または更新された page の URL>
+  url:      <作成または更新された page の URL。タイトルはパーセントエンコード済み>
 
   url はサーバーが返す title から再構築される。 同名ページが既に存在する場合、 サーバーは
   タイトルに auto-suffix を付ける (新規作成でも既存ページのタイトル変更でも起きる)。

package/src/lib/encodeTitle.ts

@@ -1,13 +1,10 @@
-// 人が読める 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()}`
+  );
 };