month-heads-up

月末の注意喚起を実行します。先を見通したキャッシュデータを取得し、次の30日間の見通しと、注意すべき具体的な点をオーナーに明確に提示します。

引数を解析します：

• --horizon（デフォルト：30）— 予測期間（日数）（30または60）

ステップ1 — 現在の現金残高

cash-flow-snapshot スキルのワークフローを使用します。

1. QuickBooks の現在の現金残高と売掛金残高を取得します。
2. PayPal の決済済み残高と入金保留額を取得します。
3. 合算して、利用可能な現金と入金予定額の合計を算出します。

ステップ2 — 今後の支払い義務

1. QuickBooks から、今後30日以内に支払期日が来る定期支出（給与、サブスクリプション、家賃／リース）を取得します。
2. 期限超過または14日以内に支払期日が来る未払い請求書を取得します。
3. 残高が安全余裕額（デフォルト：2,000ドル未満、またはオーナーの QuickBooks における平均月間支出の0.5倍）を下回る支払いにフラグを付けます。

ステップ3 — キャッシュフロー予測

1. 30日間の純キャッシュを予測します：現在の残高 + 入金予定額 − 既知の支払い義務。
2. 残高の予測が最も低くなる、最も厳しい週を特定します。
3. いずれかの週の予測残高がマイナスになる場合は、フラグを付けます。

ステップ4 — 注意すべき2つのこと

具体的で実行可能な注意事項を最大2つ提示します：

• すぐに督促すべき請求書
• 支払いを延期または条件交渉すべき支出

次の形式で表示します：

Month-End Heads Up — {current date}
Horizon: next {X} days

Cash today: ${amount}
Projected end-of-period: ${amount}
Tightest week: {date range} — projected ${amount}

TWO THINGS TO WATCH
1. {item} — {why it matters} — suggested action: {action}
2. {item} — {why it matters} — suggested action: {action}

コネクターの障害

QuickBooks に接続できない場合は処理を停止します。キャッシュ予測では QuickBooks を正確なデータの基準とする必要があります。PayPal が接続されていない場合は、QuickBooks のデータのみで予測を実行し、「PayPal は未接続です — PayPal の売掛金は予測から除外されています」と記載します。Stripe／Square が接続されていない場合も同様です。

承認ゲート

• 支払いの開始やメールの送信を自動で行ってはいけません。 データと、オーナーが実行するアクションを提示します。
• QuickBooks または PayPal で確認されていない売上を予測してはいけません。 保守的な見積もりのみを使用します。

出力

指定の形式で概要を提示し、期限超過としてフラグが付いた請求書について、督促メールの下書きを作成するか尋ねます。