@helpfeel/cosense-cli 1.5.1 → 1.5.3

package/package.json

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

package/src/commands/browsePage.ts

@@ -11,6 +11,7 @@ import { requestJson } from '../lib/request.ts';
 import {
   enrichPageUsers,
   fetchUserMap,
+  serviceAccountSuffix,
   type UserMap
 } from '../lib/resolveUsers.ts';
 import { resolveCredential } from '../lib/settings.ts';
@@ -85,6 +86,8 @@ interface UserRef {
   id?: string;
   name?: string;
   displayName?: string;
+  isServiceAccount?: boolean;
+  isServiceAccountDeleted?: boolean;
 }
 
 interface InfoboxResult {
@@ -129,8 +132,12 @@ const extractFragment = (input: string): string | null => {
 
 const formatUserDisplay = (u: UserRef | null | undefined): string | null => {
   if (!u) return null;
-  if (u.displayName && u.name) return `${u.displayName} (${u.name})`;
-  return u.displayName ?? u.name ?? u.id ?? null;
+  const base =
+    u.displayName && u.name
+      ? `${u.displayName} (${u.name})`
+      : (u.displayName ?? u.name ?? u.id ?? null);
+  if (base === null) return null;
+  return `${base}${serviceAccountSuffix(u)}`;
 };
 
 const formatDateYMD = (unixSec: number): string => {
@@ -232,7 +239,8 @@ const renderTelomere = (
   if (entries.length === 0) return null;
   const lines = entries.map(e => {
     const info = userMap.get(e.userId);
-    const name = info?.displayName ?? info?.name ?? e.userId;
+    const base = info?.displayName ?? info?.name ?? e.userId;
+    const name = info ? `${base}${serviceAccountSuffix(info)}` : base;
     return `- ${name}\t更新期間 ${formatDateYMD(e.minUpdated)} 〜 ${formatDateYMD(e.maxUpdated)}\t${e.lineCount}行更新`;
   });
   return `## テロメアのサマリー\n\n${lines.join('\n')}`;

package/src/commands/browsePageChanges.ts

@@ -2,7 +2,11 @@ import { encodeTitleForUrl } from '../lib/encodeTitle.ts';
 import { formatTimestamp } from '../lib/formatTimestamp.ts';
 import { parseProjectUrlStrict } from '../lib/parseUrl.ts';
 import { requestJson } from '../lib/request.ts';
-import { fetchUserMap, type UserMap } from '../lib/resolveUsers.ts';
+import {
+  fetchUserMap,
+  serviceAccountSuffix,
+  type UserMap
+} from '../lib/resolveUsers.ts';
 import { resolveCredential } from '../lib/settings.ts';
 
 export const browsePageChangesSummary =
@@ -102,7 +106,9 @@ const resolveUserName = (
 ): string => {
   if (!userId) return '不明なユーザー';
   const info = userMap.get(userId);
-  return info?.displayName ?? info?.name ?? userId;
+  if (!info) return userId;
+  const base = info.displayName ?? info.name ?? userId;
+  return `${base}${serviceAccountSuffix(info)}`;
 };
 
 const quote = (text: string | undefined): string => `「${text ?? ''}」`;

package/src/commands/previewEdit.ts

@@ -2,7 +2,7 @@ import { randomBytes } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
 import { parseProjectUrlStrict } from '../lib/parseUrl.ts';
 import { requestJson } from '../lib/request.ts';
-import { resolveUserCredential } from '../lib/settings.ts';
+import { resolveCredential } from '../lib/settings.ts';
 
 export const previewEditSummary =
   'ページ編集opsをdry-runしてpreviewIdを取得する';
@@ -56,7 +56,7 @@ stdinから受け取る入力形式（既存ページ編集モード, JSON）:
 
 HTTPエラー:
   HTTP 401  認証なし
-  HTTP 403  非memberまたはService Account（書き込みはPAT限定）
+  HTTP 403  権限不足（PAT利用時、projectのmemberでない 等）
   HTTP 404  pageId に対応するpageが存在しない / pageId が不正な形式
   HTTP 409 {"error":"NotFastForward","latest":...}
             preview生成後にページが更新された。最新stateを再取得して ops を作り直す必要がある
@@ -384,8 +384,8 @@ export const previewEdit = async (args: string[]): Promise<void> => {
   }
   const { changes, newLineIds, updatedLineIds } = translateOps(ops);
 
-  // 書き込み系 API は PAT 限定 (Service Account 拒否) なので、PAT を直接解決する
-  const credential = resolveUserCredential(origin);
+  // projectに紐づくService Accountがあればそれを、無ければPATを使う（読み取りと同じ）
+  const credential = resolveCredential(origin, projectName);
 
   const apiUrl = `${origin}/api/pages/v2/${projectName}/page-edit-for-ai/preview`;
   const requestBody = pageId ? { pageId, changes } : { changes };

package/src/commands/readProjectMembers.ts

@@ -14,8 +14,10 @@ Usage:
   <projectUrl>  プロジェクトのURL（例: https://scrapbox.io/shokai）
 
 戻り値（top-levelの主なkey）:
-  users           Array<User>          現メンバー一覧
-  memberSnapshots Array<Snapshot>?     退去済みメンバーの記録
+  users                   Array<User>            現メンバー一覧
+  memberSnapshots         Array<Snapshot>?       退去済みメンバーの記録
+  serviceAccounts         Array<ServiceAccount>? Service Account一覧
+  serviceAccountSnapshots Array<ServiceAccount>? 削除済みService Accountの記録
 
 User の field:
   id           string    Cosense内部のID
@@ -34,6 +36,10 @@ Snapshot の field:
   updated string                            退去者snapshot更新時刻
   data    { id, name?, displayName?, email? } 退去時のユーザー情報
 
+ServiceAccount の field:
+  id     string   Service AccountのID（このIDでページ・行の著者を同定できる）
+  usage  string   用途ラベル（著者の表示名として使う）
+
 戻り値のJSON抜粋例:
 {
   "users": [
@@ -60,6 +66,12 @@ Snapshot の field:
         "email": "former@example.com"
       }
     }
+  ],
+  "serviceAccounts": [
+    { "id": "6a44...", "usage": "CLI test" }
+  ],
+  "serviceAccountSnapshots": [
+    { "id": "6a1a...", "usage": "Cosense CLI" }
   ]
 }
 `;

package/src/commands/submitEdit.ts

@@ -1,7 +1,7 @@
 import { encodeTitleForUrl } from '../lib/encodeTitle.ts';
 import { parseProjectUrlStrict } from '../lib/parseUrl.ts';
 import { requestJson } from '../lib/request.ts';
-import { resolveUserCredential } from '../lib/settings.ts';
+import { resolveCredential } from '../lib/settings.ts';
 
 export const submitEditSummary =
   'previewEditで取得したpreviewIdを使ってページ編集を確定する';
@@ -26,7 +26,7 @@ Usage:
 HTTPエラー:
   HTTP 400  preview を生成した時と違う project の URL を渡している
   HTTP 401  認証なし
-  HTTP 403  非memberまたはService Account（書き込みはPAT限定）
+  HTTP 403  権限不足（PAT利用時、projectのmemberでない 等）
   HTTP 404  preview が見つからない / 期限切れ (5分) / 既にconsume済み / 他userのpreview
   HTTP 409 {"error":"NotFastForward","latest":...}
             preview生成後にページが更新された。最新stateを再取得して ops を作り直し、
@@ -50,8 +50,8 @@ export const submitEdit = async (args: string[]): Promise<void> => {
 
   const { origin, projectName } = parseProjectUrlStrict(projectUrl);
   const apiUrl = `${origin}/api/pages/v2/${projectName}/page-edit-for-ai/submit`;
-  // 書き込み系 API は PAT 限定 (Service Account 拒否) なので、PAT を直接解決する
-  const credential = resolveUserCredential(origin);
+  // projectに紐づくService Accountがあればそれを、無ければPATを使う（読み取りと同じ）
+  const credential = resolveCredential(origin, projectName);
   const response = (await requestJson(apiUrl, {
     credential,
     method: 'POST',

package/src/lib/resolveUsers.ts

@@ -5,6 +5,8 @@ interface UserInfo {
   name?: string;
   displayName?: string;
   email?: string;
+  isServiceAccount?: boolean;
+  isServiceAccountDeleted?: boolean;
 }
 
 export type UserMap = Map<string, UserInfo>;
@@ -20,9 +22,16 @@ interface MemberSnapshotEntry {
   data?: UserEntry;
 }
 
+interface ServiceAccountEntry {
+  id?: unknown;
+  usage?: unknown;
+}
+
 interface UsersResponse {
   users?: UserEntry[];
   memberSnapshots?: MemberSnapshotEntry[];
+  serviceAccounts?: ServiceAccountEntry[];
+  serviceAccountSnapshots?: ServiceAccountEntry[];
 }
 
 const cache = new Map<string, UserMap>();
@@ -30,6 +39,18 @@ const cache = new Map<string, UserMap>();
 const stringOrUndefined = (value: unknown): string | undefined =>
   typeof value === 'string' && value !== '' ? value : undefined;
 
+// Service Account著者の表示名末尾に付ける注記。名前を文字列整形するコマンド
+// (browsePage / browsePageChanges) で共用し、usageが人間名に見えるのを防ぐ
+export const serviceAccountSuffix = (info: {
+  isServiceAccount?: boolean;
+  isServiceAccountDeleted?: boolean;
+}): string => {
+  if (!info.isServiceAccount) return '';
+  return info.isServiceAccountDeleted
+    ? ' (deleted service account)'
+    : ' (service account)';
+};
+
 const buildUserInfo = (entry: UserEntry): UserInfo => {
   const info: UserInfo = {};
   const name = stringOrUndefined(entry.name);
@@ -66,6 +87,23 @@ export const fetchUserMap = async (
     if (!id || map.has(id)) continue;
     map.set(id, buildUserInfo(entry));
   }
+  for (const entry of data.serviceAccounts ?? []) {
+    const id = stringOrUndefined(entry.id);
+    if (!id || map.has(id)) continue;
+    map.set(id, {
+      displayName: stringOrUndefined(entry.usage),
+      isServiceAccount: true
+    });
+  }
+  for (const entry of data.serviceAccountSnapshots ?? []) {
+    const id = stringOrUndefined(entry.id);
+    if (!id || map.has(id)) continue;
+    map.set(id, {
+      displayName: stringOrUndefined(entry.usage),
+      isServiceAccount: true,
+      isServiceAccountDeleted: true
+    });
+  }
 
   cache.set(cacheKey, map);
   return map;