@helpfeel/cosense-cli 1.12.0 → 1.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skill用のCLI",
   "homepage": "https://github.com/helpfeel/cosense-cli",
   "license": "MIT",
@@ -24,13 +24,13 @@
     "format": "oxfmt"
   },
   "dependencies": {
-    "tsx": "4.23.10"
+    "tsx": "4.23.12"
   },
   "devDependencies": {
     "@types/node": "24.13.3",
     "npm-run-all": "4.1.5",
-    "oxfmt": "0.61.0",
-    "oxlint": "1.76.0",
+    "oxfmt": "0.62.0",
+    "oxlint": "1.77.0",
     "typescript": "7.0.2"
   },
   "engines": {

package/src/cli.ts

@@ -17,6 +17,11 @@ import {
   browseRelatedPagesHelp,
   browseRelatedPagesSummary
 } from './commands/browseRelatedPages.ts';
+import {
+  deleteFile,
+  deleteFileHelp,
+  deleteFileSummary
+} from './commands/deleteFile.ts';
 import {
   downloadFile,
   downloadFileHelp,
@@ -43,6 +48,11 @@ import {
   listProjectsSummary
 } from './commands/listProjects.ts';
 import { login, loginHelp, loginSummary } from './commands/login.ts';
+import {
+  previewDelete,
+  previewDeleteHelp,
+  previewDeleteSummary
+} from './commands/previewDelete.ts';
 import {
   previewEdit,
   previewEditHelp,
@@ -154,6 +164,11 @@ const commands: Record<string, CommandSpec> = {
     summary: uploadFileSummary,
     help: uploadFileHelp
   },
+  deleteFile: {
+    handler: deleteFile,
+    summary: deleteFileSummary,
+    help: deleteFileHelp
+  },
   readProjectMembers: {
     handler: readProjectMembers,
     summary: readProjectMembersSummary,
@@ -199,6 +214,11 @@ const commands: Record<string, CommandSpec> = {
     summary: previewEditSummary,
     help: previewEditHelp
   },
+  previewDelete: {
+    handler: previewDelete,
+    summary: previewDeleteSummary,
+    help: previewDeleteHelp
+  },
   submitEdit: {
     handler: submitEdit,
     summary: submitEditSummary,
@@ -242,7 +262,9 @@ if (command === '--version') {
   process.exit(0);
 }
 
-const spec = command ? commands[command] : undefined;
+// cosense constructorやcosense __proto__はObject.prototypeのpropertyを引いてしまう
+const spec =
+  command && Object.hasOwn(commands, command) ? commands[command] : undefined;
 if (!spec) {
   process.stderr.write(
     `invalid command${command ? `: ${command}` : ''}\n` +

package/src/commands/deleteFile.ts

@@ -0,0 +1,81 @@
+import { parseFileUrl } from '../lib/parseUrl.ts';
+import { requestJson } from '../lib/request.ts';
+import { resolveFileCredential } from '../lib/resolveFileCredential.ts';
+
+export const deleteFileSummary = 'ファイルをprojectから削除する';
+
+export const deleteFileHelp = `deleteFile - ファイルをprojectから削除する
+
+Usage:
+  cosense deleteFile <fileUrl> [--project <projectUrl>]
+
+引数:
+  <fileUrl>  ファイルのURL（例: https://scrapbox.io/files/5f151efbacbb17001a58f120.pdf）。query/hashは付けない
+
+オプション:
+  --project <projectUrl>  Service Account認証で削除する時に、ファイルが属するprojectのURLを指定する（例: https://scrapbox.io/example）。省略時はPersonal Access Tokenを使う
+
+出力（JSON）:
+  success  boolean  削除に成功したらtrue
+
+削除後、ファイルが所属するproject内でこのファイルを埋め込んでいるページの本文はサーバーが自動修正するため、クライアント側での本文修正は不要。
+
+例:
+  cosense deleteFile 'https://scrapbox.io/files/5f151efbacbb17001a58f120.pdf'
+
+HTTPエラー:
+  401/403: 認証・権限が無い。projectのmember権限（またはprojectのService Account）が必要
+  404: fileIdに対応するファイルが存在しない
+`;
+
+interface ParsedArgs {
+  fileUrl: string;
+  project?: string;
+}
+
+const parseArgs = (args: string[]): ParsedArgs => {
+  const usage = 'Usage: cosense deleteFile <fileUrl> [--project <projectUrl>]';
+  let project: string | undefined;
+  const positional: string[] = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i] as string;
+    if (arg === '--project') {
+      if (project !== undefined) {
+        throw new Error(`--project specified multiple times\n${usage}`);
+      }
+      const value = args[i + 1];
+      if (value === undefined || value.startsWith('--')) {
+        throw new Error(`--project requires a value\n${usage}`);
+      }
+      project = value;
+      i += 1;
+    } else if (arg.startsWith('--')) {
+      throw new Error(`Unknown option: ${arg}\n${usage}`);
+    } else {
+      positional.push(arg);
+    }
+  }
+  if (positional.length !== 1) {
+    throw new Error(usage);
+  }
+  return { fileUrl: positional[0] as string, project };
+};
+
+export const deleteFile = async (args: string[]): Promise<void> => {
+  const { fileUrl, project } = parseArgs(args);
+  const { origin, fileId } = parseFileUrl(fileUrl);
+  const credential = resolveFileCredential(origin, project);
+  if (!credential) {
+    throw new Error(
+      `No credential found for ${origin}. Run \`cosense login ${origin}\` to authenticate.`
+    );
+  }
+  const data = (await requestJson(`${origin}/api/gcs/${fileId}`, {
+    credential,
+    method: 'DELETE'
+  })) as { success?: unknown };
+  if (data?.success !== true) {
+    throw new Error(`unexpected delete response: ${JSON.stringify(data)}`);
+  }
+  process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+};

package/src/commands/previewDelete.ts

@@ -0,0 +1,76 @@
+import { parseProjectUrlStrict } from '../lib/parseUrl.ts';
+import { requestJson } from '../lib/request.ts';
+import { resolveCredential } from '../lib/settings.ts';
+
+export const previewDeleteSummary =
+  'ページ削除をdry-runしてpreviewIdを取得する';
+
+export const previewDeleteHelp = `previewDelete - ページ削除をdry-runしてpreviewIdを取得する
+
+Usage:
+  cosense previewDelete <projectUrl> <pageId>
+
+引数:
+  <projectUrl>  プロジェクトのURL (例: https://scrapbox.io/shokai)。 末尾に余分なpathがあるとerror
+  <pageId>      削除対象ページのID。 readPage 出力の top-level "id" field から取得する
+
+戻り値（plain text）:
+  previewId / expireAt / status (delete) / project / title のヘッダー + 削除されるpage全体。
+  preview は dry-run なのでこの段階では削除されない。
+  previewId を submitEdit に渡すと削除が確定する。5分で expire する。
+
+HTTPエラー:
+  HTTP 401  認証なし
+  HTTP 403  権限不足（PAT利用時、projectのmemberでない 等）
+  HTTP 404  pageId に対応するpageが存在しない / pageId が不正な形式
+`;
+
+interface PagePreview {
+  title?: string;
+  lines?: { id: string; text: string }[];
+}
+
+interface PreviewResponse {
+  previewId: string;
+  expireAt: string;
+  pagePreview: PagePreview | null;
+  pageDelete?: boolean;
+}
+
+export const previewDelete = async (args: string[]): Promise<void> => {
+  if (args.length !== 2) {
+    throw new Error('Usage: cosense previewDelete <projectUrl> <pageId>');
+  }
+  const [projectUrl, pageId] = args as [string, string];
+
+  const { origin, projectName } = parseProjectUrlStrict(projectUrl);
+  // projectに紐づくService Accountがあればそれを、無ければPATを使う（読み取りと同じ）
+  const credential = resolveCredential(origin, projectName);
+
+  const apiUrl = `${origin}/api/pages/v2/${projectName}/page-edit-for-ai/preview`;
+  const response = (await requestJson(apiUrl, {
+    credential,
+    method: 'POST',
+    body: { pageId, changes: [{ deleted: true }] }
+  })) as PreviewResponse;
+
+  // 削除は破壊的操作なので、サーバーが削除previewとして受理した事を確認してから表示する
+  if (response.pageDelete !== true) {
+    throw new Error(
+      'server did not mark this preview as a page deletion. Do not submit the previewId.'
+    );
+  }
+
+  const lines: string[] = [];
+  lines.push(`previewId: ${response.previewId}`);
+  lines.push(`expireAt:  ${response.expireAt}`);
+  lines.push('status:    delete');
+  lines.push(`project:   ${projectName}`);
+  lines.push(`title:     ${response.pagePreview?.title ?? ''}`);
+  lines.push('');
+  lines.push('page (will be deleted):');
+  for (const line of response.pagePreview?.lines ?? []) {
+    lines.push(`  ${line.text}`);
+  }
+  process.stdout.write(`${lines.join('\n')}\n`);
+};

package/src/commands/submitEdit.ts

@@ -4,16 +4,16 @@ import { requestJson } from '../lib/request.ts';
 import { resolveCredential } from '../lib/settings.ts';
 
 export const submitEditSummary =
-  'previewEditで取得したpreviewIdを使ってページ編集を確定する';
+  'previewEdit/previewDeleteで取得したpreviewIdを使ってページ編集・削除を確定する';
 
-export const submitEditHelp = `submitEdit - previewEditで取得したpreviewIdを使ってページ編集を確定する
+export const submitEditHelp = `submitEdit - previewEdit/previewDeleteで取得したpreviewIdを使ってページ編集・削除を確定する
 
 Usage:
   cosense submitEdit <projectUrl> <previewId>
 
 引数:
   <projectUrl>  プロジェクトのURL (例: https://scrapbox.io/shokai)。 末尾に余分なpathがあるとerror
-  <previewId>   previewEdit の戻り値の previewId
+  <previewId>   previewEdit または previewDelete の戻り値の previewId
 
 戻り値（plain text）:
   commitId: <生成されたcommitのID>
@@ -28,6 +28,11 @@ Usage:
   titleChanged: "<変更前title>" -> "<変更後title>"
   新旧タイトルはそれぞれJSON string
 
+  previewDelete の previewId を確定した時は、代わりに以下を出力する:
+  commitId: <生成されたcommitのID>
+  title:    <削除されたpage title>
+  deleted:  true
+
 HTTPエラー:
   HTTP 400  preview を生成した時と違う project の URL を渡している
   HTTP 401  認証なし
@@ -36,6 +41,9 @@ HTTPエラー:
   HTTP 409 {"error":"NotFastForward","latest":...}
             preview生成後にページが更新された。最新stateを再取得して ops を作り直し、
             previewEdit からやり直す必要がある
+  HTTP 409 {"error":"NotFastForward","latest":null}
+            対象ページが既に存在しない。削除の確定でこれが返った場合、ページは別経路で
+            削除済みであり、目的の状態は達成されている。リトライ不要
   HTTP 409 {"error":"DuplicateTitle"}
             preview→submit の間に他人が同名ページを作った (race condition)
 
@@ -45,6 +53,7 @@ previewId は1回限り (consume-on-submit)。submit 後・5分 expire 後・con
 interface SubmitResponse {
   commitId: string;
   page: { title?: string } | null;
+  pageDeleted?: { title?: string };
   titleChanged?: { from?: string; to?: string };
 }
 
@@ -64,6 +73,15 @@ export const submitEdit = async (args: string[]): Promise<void> => {
     body: { previewId }
   })) as SubmitResponse;
 
+  // pageDeletedはページ削除commitの確定時に返る。削除されたページにURLは無い
+  const pageDeleted = response.pageDeleted;
+  if (pageDeleted) {
+    process.stdout.write(
+      `commitId: ${response.commitId}\ntitle:    ${pageDeleted.title ?? ''}\ndeleted:  true\n`
+    );
+    return;
+  }
+
   const title = response.page?.title;
   if (typeof title !== 'string') {
     throw new Error(

package/src/commands/uploadFile.ts

@@ -20,13 +20,13 @@ Usage:
   <filePath>    アップロードするローカルファイルのパス
 
 オプション:
-  --content-type <type>  ファイルのMIME type。省略時は拡張子から推定し、不明な拡張子はapplication/octet-streamになる
+  --content-type <type>  ファイルのMIME type
 
 出力（JSON）:
-  embedUrl      string  ページ本文への埋め込みに使うファイルURL
-  originalname  string  アップロードしたファイル名
-  contentType   string  embedUrlが配信するファイルのMIME type
-  size          number  ファイルのbyte数
+  embedUrl      string   ページ本文への埋め込みに使うファイルURL
+  originalname  string   アップロードしたファイル名
+  contentType   string?  ファイルのMIME type
+  size          number   ファイルのbyte数
 
 例:
   cosense uploadFile 'https://scrapbox.io/example' ./photo.png
@@ -55,7 +55,7 @@ const parseArgs = (args: string[]): ParsedArgs => {
         throw new Error(`--content-type specified multiple times\n${usage}`);
       }
       const value = args[i + 1];
-      if (value === undefined || value.startsWith('--')) {
+      if (!value || value.startsWith('--')) {
         throw new Error(`--content-type requires a value\n${usage}`);
       }
       contentType = value;
@@ -81,11 +81,11 @@ const parseArgs = (args: string[]): ParsedArgs => {
 const uploadToSignedUrl = async (
   url: string,
   body: Uint8Array,
-  contentType: string
+  contentType: string | undefined
 ): Promise<void> => {
   const res = await fetch(url, {
     method: 'PUT',
-    headers: { 'Content-Type': contentType },
+    headers: contentType ? { 'Content-Type': contentType } : {},
     body
   });
   if (res.ok) {
@@ -149,10 +149,10 @@ export const uploadFile = async (args: string[]): Promise<void> => {
   let resultContentType = contentType;
   if (uploadRequest.embedUrl) {
     // 同一ファイルがアップロード済みの場合、serverはupload-requestで即embedUrlを返す。
-    // embedUrlが配信するのは保存済みファイルなので、contentTypeはローカル推定よりserver値を優先する
+    // embedUrlが配信するのは保存済みファイルなので、ローカル推定の型は当てにならない
     embedUrl = uploadRequest.embedUrl;
     originalname = uploadRequest.originalname ?? name;
-    resultContentType = uploadRequest.contentType ?? contentType;
+    resultContentType = uploadRequest.contentType?.trim() || undefined;
   } else {
     const { signedUrl, fileId } = uploadRequest;
     if (!signedUrl || !fileId) {

package/src/lib/mimeTypes.ts

@@ -1,7 +1,8 @@
 import { extname } from 'node:path';
 
-// アップロード時に申告するContent-Typeを拡張子から推定する最小マップ。
-// 網羅せず、外れる型は--content-typeで上書きしてもらう
+// アップロード時に申告するContent-Typeを拡張子から推定するマップ。網羅はしないが、
+// browsePageが<cosense:file type="...">でファイル種別をAIに伝えられるよう、判明した型は足していく。
+// ここに無い型は--content-typeで上書きしてもらう
 const MIME_TYPES: Record<string, string> = {
   png: 'image/png',
   jpg: 'image/jpeg',
@@ -20,6 +21,13 @@ const MIME_TYPES: Record<string, string> = {
   weba: 'audio/webm',
   aac: 'audio/aac',
   pdf: 'application/pdf',
+  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+  xlsm: 'application/vnd.ms-excel.sheet.macroEnabled.12',
+  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+  doc: 'application/msword',
+  xls: 'application/vnd.ms-excel',
+  ppt: 'application/vnd.ms-powerpoint',
   txt: 'text/plain',
   md: 'text/markdown',
   csv: 'text/csv',
@@ -29,7 +37,11 @@ const MIME_TYPES: Record<string, string> = {
   zip: 'application/zip'
 };
 
-export const contentTypeForFile = (filePath: string): string => {
+// 推定できない時にapplication/octet-streamを申告しない。octet-streamで申告するとserverが
+// embedUrlから拡張子を落とすため、URLからファイル種別が読み取れなくなり、ページ本文での
+// 埋め込み表示の判定もできなくなる
+export const contentTypeForFile = (filePath: string): string | undefined => {
   const ext = extname(filePath).slice(1).toLowerCase();
-  return MIME_TYPES[ext] ?? 'application/octet-stream';
+  // a.constructorやa.__proto__はObject.prototypeのpropertyを引いてしまう
+  return Object.hasOwn(MIME_TYPES, ext) ? MIME_TYPES[ext] : undefined;
 };

package/src/lib/request.ts

@@ -40,7 +40,7 @@ export class HttpError extends Error {
 
 interface RequestOptions {
   credential?: Credential;
-  method?: 'GET' | 'POST';
+  method?: 'GET' | 'POST' | 'DELETE';
   body?: unknown;
 }