@helpfeel/cosense-cli 1.10.1 → 1.11.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.10.1",
+  "version": "1.11.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.23.0"
+    "tsx": "4.23.10"
   },
   "devDependencies": {
     "@types/node": "24.13.3",
     "npm-run-all": "4.1.5",
-    "oxfmt": "0.58.0",
-    "oxlint": "1.74.0",
-    "typescript": "6.0.3"
+    "oxfmt": "0.61.0",
+    "oxlint": "1.76.0",
+    "typescript": "7.0.2"
   },
   "engines": {
     "node": ">=24"

package/src/cli.ts

@@ -63,6 +63,11 @@ import {
   readProjectMembersHelp,
   readProjectMembersSummary
 } from './commands/readProjectMembers.ts';
+import {
+  replaceLinks,
+  replaceLinksHelp,
+  replaceLinksSummary
+} from './commands/replaceLinks.ts';
 import {
   submitEdit,
   submitEditHelp,
@@ -188,6 +193,11 @@ const commands: Record<string, CommandSpec> = {
     handler: submitEdit,
     summary: submitEditSummary,
     help: submitEditHelp
+  },
+  replaceLinks: {
+    handler: replaceLinks,
+    summary: replaceLinksSummary,
+    help: replaceLinksHelp
   }
 };
 

package/src/commands/replaceLinks.ts

@@ -0,0 +1,59 @@
+import { parseProjectUrlStrict } from '../lib/parseUrl.ts';
+import { requestJson } from '../lib/request.ts';
+import { resolveCredential } from '../lib/settings.ts';
+
+export const replaceLinksSummary =
+  '旧タイトルへのリンク記法を新しいタイトルに一括置換する';
+
+export const replaceLinksHelp = `replaceLinks - 旧タイトルへのリンク記法を新しいタイトルに一括置換する
+
+Usage:
+  cosense replaceLinks <projectUrl> <oldTitle> <newTitle>
+
+引数:
+  <projectUrl>  プロジェクトのURL (例: https://scrapbox.io/shokai)。 末尾に余分なpathがあるとerror
+  <oldTitle>    置換前のページタイトル
+  <newTitle>    置換後のページタイトル
+
+project内のページを走査し、 <oldTitle> を指すリンク記法 \`[title]\`・hashtag \`#title\`・
+アイコン記法 \`[title.icon]\` を <newTitle> に書き換える。 タイトルの一致は大文字小文字と
+空白/アンダースコアの違いを無視する。 他projectを指す \`[/project/title]\` は対象外。
+リンク記法になっていない平文、 タイトル行、 code block、 CLI記法、 Helpfeel記法の行は書き換えない。
+
+ページ自体のタイトルは変わらない。 タイトルの変更は previewEdit / submitEdit で行う。
+
+戻り値（plain text）:
+  更新したページ数を伝えるmessage (例: "3 pages have been successfully updated!")
+
+HTTPエラー:
+  HTTP 400  <oldTitle> と <newTitle> が同じ / どちらかが空 / <newTitle> がリンク記法として成立しない
+  HTTP 401  認証なし
+  HTTP 403  権限不足（PAT利用時、projectのmemberでない 等）
+  HTTP 500  一部のページの更新に失敗した。 同じ引数で再実行できる。 置換済みのリンクが
+            別の文字列へ再置換される事はない
+`;
+
+interface ReplaceLinksResponse {
+  message: string;
+}
+
+export const replaceLinks = async (args: string[]): Promise<void> => {
+  if (args.length !== 3) {
+    throw new Error(
+      'Usage: cosense replaceLinks <projectUrl> <oldTitle> <newTitle>'
+    );
+  }
+  const [projectUrl, oldTitle, newTitle] = args as [string, string, string];
+
+  const { origin, projectName } = parseProjectUrlStrict(projectUrl);
+  const apiUrl = `${origin}/api/pages/${projectName}/replace/links`;
+  // projectに紐づくService Accountがあればそれを、無ければPATを使う（読み取りと同じ）
+  const credential = resolveCredential(origin, projectName);
+  const response = (await requestJson(apiUrl, {
+    credential,
+    method: 'POST',
+    body: { from: oldTitle, to: newTitle }
+  })) as ReplaceLinksResponse;
+
+  process.stdout.write(`${response.message}\n`);
+};

package/src/commands/submitEdit.ts

@@ -20,8 +20,13 @@ Usage:
   title:    <実際に書き込まれたpage title>
   url:      <作成または更新された page の URL>
 
-  url はサーバーが返す title から再構築される。 新規作成時にサーバーが auto-suffix した場合
-  (同名ページが既に存在する場合) は、 title/url にその suffix が反映される。
+  url はサーバーが返す title から再構築される。 同名ページが既に存在する場合、 サーバーは
+  タイトルに auto-suffix を付ける (新規作成でも既存ページのタイトル変更でも起きる)。
+  title/url にはその suffix が反映される。
+
+  既存ページのタイトルが変わった編集では、続けて以下を出力する:
+  titleChanged: "<変更前title>" -> "<変更後title>"
+  新旧タイトルはそれぞれJSON string
 
 HTTPエラー:
   HTTP 400  preview を生成した時と違う project の URL を渡している
@@ -40,6 +45,7 @@ previewId は1回限り (consume-on-submit)。submit 後・5分 expire 後・con
 interface SubmitResponse {
   commitId: string;
   page: { title?: string } | null;
+  titleChanged?: { from?: string; to?: string };
 }
 
 export const submitEdit = async (args: string[]): Promise<void> => {
@@ -68,4 +74,18 @@ export const submitEdit = async (args: string[]): Promise<void> => {
   process.stdout.write(
     `commitId: ${response.commitId}\ntitle:    ${title}\nurl:      ${url}\n`
   );
+
+  // titleChangedはサーバーが対応している場合のみ返る
+  const titleChanged = response.titleChanged;
+  if (
+    typeof titleChanged?.from === 'string' &&
+    typeof titleChanged.to === 'string'
+  ) {
+    // タイトルには " や -> が含まれうるので、境界が一意に読めるようJSON stringで出力する
+    process.stdout.write(
+      `titleChanged: ${JSON.stringify(titleChanged.from)} -> ${JSON.stringify(
+        titleChanged.to
+      )}\n`
+    );
+  }
 };