@helpfeel/cosense-cli 1.14.0 → 1.14.2

package/README.md

@@ -1,6 +1,6 @@
 # @helpfeel/cosense-cli
 
-Cosenseのページを読み・調べ・編集するAgent SkillとCLI
+Cosenseのページを読み・調べ・編集するAgent Skillとそのハーネス
 
 ## Install Agent Skill
 
@@ -34,7 +34,7 @@ npx skills update cosense
 
 ## Install CLI
 
-Skillの実行にはCLIが必要です
+SkillはこのCLIをハーネスとして使います。Skillの実行に必要です
 
 ```bash
 npm install -g @helpfeel/cosense-cli

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.14.0",
-  "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skill用のCLI",
+  "version": "1.14.2",
+  "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skillのハーネス",
   "homepage": "https://github.com/helpfeel/cosense-cli",
   "license": "MIT",
   "repository": {
@@ -29,8 +29,8 @@
   "devDependencies": {
     "@types/node": "24.13.3",
     "npm-run-all": "4.1.5",
-    "oxfmt": "0.62.0",
-    "oxlint": "1.77.0",
+    "oxfmt": "0.64.0",
+    "oxlint": "1.79.0",
     "typescript": "7.0.2"
   },
   "engines": {

package/src/cli.ts

@@ -254,7 +254,7 @@ const commands: Record<string, CommandSpec> = {
 const renderTopLevelHelp = (): string => {
   const nameWidth = Math.max(...Object.keys(commands).map(n => n.length));
   const lines = [
-    `cosense v${version} - Cosenseのページを読み・調べ・編集するCLI`,
+    `cosense v${version} - Cosenseのページを読み・調べ・編集するAgent Skillのハーネス`,
     '',
     'Usage:',
     '  cosense <command> [args...]',

package/src/commands/previewDelete.ts

@@ -15,7 +15,9 @@ Usage:
   <pageId>      削除対象ページのID。 readPage 出力の top-level "id" field から取得する
 
 戻り値（plain text）:
-  previewId / expireAt / status (delete) / project / title のヘッダー + 削除されるpage全体。
+  previewId / expireAt / status (delete) / project / title / commitId のヘッダー +
+  削除されるpage全体。
+  commitId は preview を作った時点の削除対象ページの最新コミット。
   preview は dry-run なのでこの段階では削除されない。
   previewId を submitEdit に渡すと削除が確定する。5分で expire する。
 
@@ -27,6 +29,7 @@ HTTPエラー:
 
 interface PagePreview {
   title?: string;
+  commitId?: string;
   lines?: { id: string; text: string }[];
 }
 
@@ -67,6 +70,7 @@ export const previewDelete = async (args: string[]): Promise<void> => {
   lines.push('status:    delete');
   lines.push(`project:   ${projectName}`);
   lines.push(`title:     ${response.pagePreview?.title ?? ''}`);
+  lines.push(`commitId:  ${response.pagePreview?.commitId ?? ''}`);
   lines.push('');
   lines.push('page (will be deleted):');
   for (const line of response.pagePreview?.lines ?? []) {

package/src/commands/previewEdit.ts

@@ -47,8 +47,10 @@ stdinから受け取る入力形式（既存ページ編集モード, JSON）:
   する必要がある（消えた lineId を anchor に指定すると 422）。
 
 戻り値（plain text）:
-  previewId / expireAt / status (create or update) / project / title のヘッダー +
+  previewId / expireAt / status (create or update) / project / title / commitId のヘッダー +
   ops summary + 適用後 page 全体。
+  commitId は preview を作った時点の編集対象ページの最新コミット。 新規作成 (status: create)
+  では出力されない。
   変更行の頭には > (新規) または * (更新) のマーカーと末尾 # <lineId> が付く。
   既存行(変更なし)はマーカーなし。
   preview は dry-run なのでこの段階ではpage URLは確定しない。 確定URLは submitEdit の出力で確認する。
@@ -98,6 +100,7 @@ type RawChange = RawInsertChange | RawUpdateChange | RawDeleteChange;
 interface PagePreview {
   title?: string;
   persistent?: boolean;
+  commitId?: string;
   lines?: { id: string; text: string }[];
 }
 
@@ -212,6 +215,10 @@ const formatPreview = (
   lines.push(`status:    ${status}`);
   lines.push(`project:   ${projectName}`);
   lines.push(`title:     ${title}`);
+  // 新規作成 (persistent: false) のページにはまだcommitが無く、サーバーもcommitIdを返さない
+  if (typeof pagePreview?.commitId === 'string') {
+    lines.push(`commitId:  ${pagePreview.commitId}`);
+  }
   lines.push('');
   lines.push('ops:');
   for (const op of ops) {