@helpfeel/cosense-cli 1.5.2 → 1.5.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.5.2",
+  "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/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/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;