@helpfeel/cosense-cli 1.16.1 → 1.16.2

package/README.md

@@ -46,7 +46,6 @@ cosense --help
 - install [direnv](https://direnv.net/)
 - run `npm install`
 - install [Codex CLI](https://github.com/openai/codex) and run `codex login`
-  - modelは `gpt-5.6-sol`、reasoning effortは `high` 以上を推奨
 - run `claude` or `codex`
 
 Claude Codeでこのディレクトリをtrustすると、開発フローで使うpluginが `.claude/settings.json` によりインストールされる。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpfeel/cosense-cli",
-  "version": "1.16.1",
+  "version": "1.16.2",
   "description": "Cosense (旧Scrapbox) のページを読み・調べ・編集するAgent Skillのハーネス",
   "homepage": "https://github.com/helpfeel/cosense-cli",
   "license": "MIT",
@@ -27,10 +27,10 @@
     "tsx": "4.23.15"
   },
   "devDependencies": {
-    "@types/node": "24.13.6",
+    "@types/node": "24.19.1",
     "npm-run-all": "4.1.5",
-    "oxfmt": "0.70.0",
-    "oxlint": "1.85.0",
+    "oxfmt": "0.71.0",
+    "oxlint": "1.86.0",
     "typescript": "7.0.2"
   },
   "engines": {

package/src/commands/downloadFile.ts

@@ -30,9 +30,6 @@ Usage:
 HTTPエラー:
   401/403: 認証・権限が無い。private projectのファイルはproject member権限が必要
   404: fileIdに対応するファイルが存在しない
-
-注記:
-  動画ファイルはサーバー側の制限により取得できない場合がある
 `;
 
 interface ParsedArgs {

package/src/commands/uploadFile.ts

@@ -76,8 +76,8 @@ const parseArgs = (args: string[]): ParsedArgs => {
   };
 };
 
-// request.tsのHttpErrorは401/403でcosense loginを案内するが、GCSのsigned URLへの
-// PUT失敗にログイン案内は誤誘導なので専用のエラーメッセージを組み立てる
+// request.tsのHttpErrorは401/403でcosense loginか権限の確認を案内するが、GCSのsigned URLへの
+// PUT失敗にはどちらも誤誘導なので専用のエラーメッセージを組み立てる
 const uploadToSignedUrl = async (
   url: string,
   body: Uint8Array,

package/src/lib/request.ts

@@ -5,6 +5,11 @@ import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import type { Credential } from './settings.ts';
 
+const describeCredentialDenied = (credential: Credential): string =>
+  credential.type === 'serviceAccount'
+    ? 'Service Account key was sent, but the server denied access. Check that the key belongs to the project of the target resource and that this operation is allowed.'
+    : 'Personal Access Token was sent, but the server denied access. Check that the account has permission for the target resource and this operation.';
+
 export class HttpError extends Error {
   readonly status: number;
   readonly statusText: string;
@@ -16,9 +21,13 @@ export class HttpError extends Error {
     statusText: string;
     url: string;
     body: string;
+    credential?: Credential;
   }) {
     let message = `HTTP ${params.status} ${params.statusText}\n${params.url}\n${params.body.slice(0, 500)}`;
-    if (params.status === 401 || params.status === 403) {
+    if (params.status === 403 && params.credential) {
+      // credential付きの403はtokenの入れ直しでは直らないので、login案内ではなく権限の確認を促す
+      message += `\n\n${describeCredentialDenied(params.credential)}`;
+    } else if (params.status === 401 || params.status === 403) {
       let origin: string | undefined;
       try {
         origin = new URL(params.url).origin;
@@ -76,7 +85,8 @@ export const requestJson = async (
       status: res.status,
       statusText: res.statusText,
       url,
-      body
+      body,
+      credential: options?.credential
     });
   }
   return res.json();
@@ -129,7 +139,8 @@ export const downloadToFile = async (
       status: res.status,
       statusText: res.statusText,
       url,
-      body
+      body,
+      credential: options?.credential
     });
   }
   if (!res.body) {