@helpfeel/cosense-cli 1.12.1 → 1.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skill用のCLI",
   "homepage": "https://github.com/helpfeel/cosense-cli",
   "license": "MIT",

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,

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/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;
 }