@geekbeer/minion 4.3.3 → 4.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "4.3.3",
+  "version": "4.3.4",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {

package/skills/accounting-bookkeeping/SKILL.md

@@ -57,10 +57,15 @@ API 全体のエンドポイント表は `~/.minion/docs/api-reference.md` の
    - default_payable_account_id が未設定なら PATCH で先に設定する
 2. POST /reimbursements で記帳
    body: { paid_by_counterparty_id, occurred_on, amount, expense_account_id, description }
-   → 内部で「(借)費用 / (貸)立替者の負債科目」の仕訳が自動生成される
+   → 内部で「(借)借方科目 / (貸)立替者の負債科目」の仕訳が自動生成される
+   - expense_account_id は費用に限らず、会社の負債 (未払金・未払税金) も指定可。
+     例: 役員が会社の未払法人税を立替納付 → expense_account_id=未払法人税等
 3. レシートがあれば事前に GET /receipts で対象を確認 (アップロードと仕訳への attach は人間が HQ UI で行う)
 ```
 
+**立替は必ず /reimbursements で記帳する。** 複合仕訳 (A の /entries) に counterparty_id を
+付けて立替の仕訳を自前で組んでも、立替精算リストに出ず消し込みできない (補助元帳のみ)。
+
 詳細: `references/api-expense-reimbursement.md`
 
 ### B') レシートの照会・OCR

package/skills/accounting-bookkeeping/references/api-expense-reimbursement.md

@@ -11,14 +11,28 @@
 ミニオンに提供されるのは **一覧取得 (GET)** と **記帳 (POST)** の2つだけ。
 精算・編集・削除は実出金や取消を伴うため **人間専用**(後述)。
 
+## ⚠️ いつ /reimbursements を使うか (最重要)
+
+**「立替精算リストに載せて後で消し込みたい立替」は、必ずこの `POST /reimbursements` で記帳すること。**
+
+手動仕訳 (`POST /entries`) に `counterparty_id` を付けて立替の仕訳を自前で組んでも、
+`accounting_expense_reimbursements` レコードが作られないため **立替精算リストには出ない**
+(取引先別補助元帳には出るが、settle / bulk-settle の対象にならない)。
+
+立替記帳は `/entries` ではなく必ず `/reimbursements` を使う、と覚えること。
+
 ## 仕訳パターン
 
 **立替記帳時 (POST /reimbursements が自動生成):**
 ```
-(借) 費用科目                 amount    [counterparty_id=<立替者>]
+(借) 借方科目 (費用 または 会社の負債)            amount    [counterparty_id=<立替者>]
   (貸) counterparty.default_payable_account_id   amount    [counterparty_id=<立替者>]
 ```
 
+借方は通常は費用科目だが、**会社の負債 (未払金・未払税金等) を立替で支払って取り崩すケース**では
+負債科目を借方に置く。例: 役員が会社の未払法人税を立替納付 →
+`(借) 未払法人税等 / (貸) 役員借入金`。いずれの場合も立替精算リストに載り、消し込みできる。
+
 **精算時 (人間が HQ UI で実行):**
 ```
 (借) counterparty.default_payable_account_id   amount    [counterparty_id=<立替者>]
@@ -47,7 +61,7 @@ Response:
 
 ### POST /reimbursements
 
-立替経費を記帳する。仕訳(借方=expense, 貸方=payable)を自動生成する。
+立替経費を記帳する。仕訳(借方=費用 or 会社の負債, 貸方=payable)を自動生成する。
 
 ```
 Body:
@@ -55,21 +69,25 @@ Body:
     "paid_by_counterparty_id": "<立替者のcounterparty uuid>",
     "occurred_on": "YYYY-MM-DD",
     "amount": 1000,
-    "expense_account_id": "<費用科目 uuid>",
+    "expense_account_id": "<借方科目 uuid>",   // 費用 / 繰延資産 / 会社の負債のいずれか
     "description": "新幹線代 東京→大阪",      // 任意
     "payable_account_id": "<貸方科目 uuid>"   // 任意。省略時は counterparty.default_payable_account_id を使用
   }
 
-Response: { "reimbursement": { "id", "expense_journal_entry_id" } }
+Response: { "reimbursement": { "id", "expense_journal_entry_id" }, "entry": {...} }
+
+`expense_account_id` (= 借方科目) は名前に反して費用科目に限らない。**立替で何を支払ったか**で選ぶ:
+  - 経費の立替        → 費用科目 (旅費交通費 等)
+  - 創立費等の立替    → 繰延資産科目
+  - 会社の負債の立替  → 負債科目 (未払法人税等・未払金 等)  ← 「いつ /reimbursements を使うか」参照
+このルートは借方の型チェックを行わないため、上記の用途に応じた科目をそのまま渡す。
 
-主要エラー:
-  400 invalid_amount                       — amount が正の数値でない
-  400 expense_account_not_found            — 費用科目が見つからない / 別帳簿
-  400 invalid_expense_account_type         — expense_account_id が expense 型でない
-  404 counterparty_not_found               — 立替者が見つからない (next_action: POST で先に作成)
-  409 counterparty_archived                — 立替者がアーカイブ済み
+主要エラー (このルートが実際に返すもの):
+  400 missing required fields              — paid_by_counterparty_id / occurred_on / amount / expense_account_id のいずれか欠落
+  400 amount must be positive              — amount が正の数値でない
+  404 Counterparty not found               — 立替者が見つからない / 別帳簿 (next_action: POST で先に作成)
+  400 payable_account_id 未指定             — payable_account_id 省略かつ counterparty.default_payable_account_id 未設定
   409 code: 'period_closed'                — occurred_on が締め済期間内
-  422 missing_default_payable_account      — 立替者の default_payable_account_id が未設定 (先に PATCH /counterparties で設定)
 ```
 
 ## 人間専用操作 (ミニオンから提供されない)

package/skills/accounting-bookkeeping/references/api-journal-entries.md

@@ -2,6 +2,10 @@
 
 複式簿記の仕訳エンドポイント。立替経費以外の通常取引(収入/支出/振替/手動仕訳)を扱う。
 
+> **立替 (役員/従業員の立替払い) はこのエンドポイントで組まず、必ず `/reimbursements` を使うこと。**
+> `manual` 仕訳に `counterparty_id` を付けて立替仕訳を自前で組んでも立替精算リストに出ず、消し込みできない。
+> 詳細は `api-expense-reimbursement.md` の「いつ /reimbursements を使うか」。
+
 > パスはすべて **ミニオン用** `$HQ_URL/api/minion/workspaces/:id/accounting/` を基準とした相対表記。
 > 認証は `Authorization: Bearer $API_TOKEN`。人間用 `/api/accounting/*` は使わない。
 > ミニオンが作成した仕訳は **常に `source='ai_generated'`** で記録される。

package/skills/accounting-bookkeeping/references/troubleshooting.md

@@ -63,6 +63,16 @@
 - 同一人物なら既存IDを使う
 - 別人なら名前を変える(例: "山田太郎(役員)" vs "山田太郎(従業員)")
 
+### 記帳は成功したのに立替精算リストに出ない
+
+**原因:** 立替を `/reimbursements` ではなく**手動仕訳 (`/entries`)** で記帳した。
+`counterparty_id` を行に付けても、`accounting_expense_reimbursements` レコードが作られないため、
+立替精算リスト (`GET /reimbursements`) には出ない (取引先別補助元帳には出る)。
+
+**対処:**
+1. 誤って `/entries` で作った立替仕訳は、ミニオンからは DELETE できない → 人間に取消を依頼
+2. 改めて `POST /reimbursements` で記帳し直す (借方が会社の負債なら `expense_account_id` に負債科目を渡す)
+
 ## 期間まわり
 
 ### `period_closed` (409)
@@ -76,11 +86,16 @@
 
 ## 科目まわり
 
-### `invalid_expense_account_type` (400)
+### 立替の借方科目 (`expense_account_id`) に何を指定できるか
 
-**原因:** 立替経費の費用科目に expense 型でない科目を指定した。
+`/reimbursements` の `expense_account_id` (= 借方) は**型チェックされず**、費用に限らない。
+立替で何を支払ったかに応じて選ぶ:
+- 経費の立替 → 費用科目 (`GET /accounts?type=expense`)
+- 会社の負債 (未払金・未払税金) の立替払い → 負債科目 (`GET /accounts?type=liability`)
+- 創立費等の立替 → 繰延資産科目
 
-**対処:** `GET /accounts?type=expense` の科目を取得して使用
+(以前のドキュメントには「expense 型でないと `invalid_expense_account_type` で弾かれる」とあったが、
+`/reimbursements` ルートはこの検証を行わない。負債を借方に置く立替も正しく記帳できる。)
 
 ### `invalid_default_payable_account` (400)