@profullstack/coinpay 0.19.0 → 0.20.0

package/bin/coinpay.js

@@ -682,7 +682,7 @@ ${colors.cyan}Commands:${colors.reset}
     due [--days 7]        What is due and overdue across every account (--days up to 60)
     recurring             Every recurring charge detected, with next date and monthly cost
     due-day <id> <1-31|clear>  A card/loan's statement due day (--amount 810.46, or balance)
-    daily [show|on|off|send-now]  Daily summary email: due soon, new activity, position (--hour 7 --to …)
+    daily [show|on|off|send-now]  Daily summary email: spend vs target, top cuts, due soon, position (--hour 7 --to …, --target 100)
 
   ${colors.bright}escrow${colors.reset}
     create                Create a new escrow

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/coinpay",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "CoinPay SDK & CLI \u2014 Accept cryptocurrency and card payments (BTC, ETH, SOL, POL, BCH, USDC) with wallet, swap and a live finances dashboard",
   "type": "module",
   "main": "./src/index.js",

package/src/finances-commands.js

@@ -891,10 +891,21 @@ export async function runFinancesCommand(subcommand, args, flags, ctx) {
         const action = flags.off ? 'off' : args[0] || 'show';
         const describe = (s) => s
           ? `Daily summary ${s.active ? 'on' : 'off'} · ${String(s.hour).padStart(2, '0')}:00 ${s.timezone} · to ${s.recipients.join(', ')}${s.nextRunAt ? ` · next ${s.nextRunAt}` : ''}${s.lastSentAt ? ` · last ${s.lastSentAt}` : ''}`
-          : 'No daily summary configured. Turn it on with: coinpay finances daily on --hour 7 --to you@example.com';
+          : 'No daily summary configured. Turn it on with: coinpay finances daily on --hour 7';
+        const targetText = (t) => (t === null || t === undefined ? 'no daily spend target' : `target $${t}/day`);
+        if (flags.target !== undefined) {
+          const raw = String(flags.target);
+          const target = ['off', 'clear', 'none'].includes(raw) ? null : Number(raw.replace(/^\$/, ''));
+          if (target !== null && (!Number.isFinite(target) || target < 0)) throw new CliExit(EXIT.INVALID, 'The target is a daily amount, e.g. --target 100, or --target clear');
+          const data = await api.setDailySpendTarget(client, target);
+          if (action === 'show') {
+            emit({ schedule: data.schedule, target: data.target }, `${describe(data.schedule)}\n${target === null ? 'Cleared the daily spend target.' : `Daily spend target set to $${data.target}/day.`}`);
+            return EXIT.OK;
+          }
+        }
         if (action === 'show') {
-          const s = await api.getDailySummary(client);
-          emit({ schedule: s }, describe(s));
+          const { schedule: s, target } = await api.getDailySummaryWithTarget(client);
+          emit({ schedule: s, target }, `${describe(s)} · ${targetText(target)}`);
           return EXIT.OK;
         }
         if (action === 'on' || action === 'set') {
@@ -917,7 +928,7 @@ export async function runFinancesCommand(subcommand, args, flags, ctx) {
           emit(data, `Sent to ${data.sent.join(', ') || 'nobody'} (${data.due} due, ${data.overdue} overdue)${data.failed.length ? `; failed: ${data.failed.map((f) => `${f.to} (${f.error})`).join(', ')}` : ''}`);
           return data.sent.length > 0 ? EXIT.OK : EXIT.FAILURE;
         }
-        throw new CliExit(EXIT.INVALID, 'Usage: coinpay finances daily [show|on --hour 7 --to a@x|off|send-now]');
+        throw new CliExit(EXIT.INVALID, 'Usage: coinpay finances daily [show|on --hour 7 --to a@x|off|send-now] [--target 100|--target clear]');
       }
 
       case 'payloads': {

package/src/finances-reports.js

@@ -461,6 +461,12 @@ export async function getDailySummary(client) {
   return data.schedule;
 }
 
+/** The daily summary schedule plus the owner's $/day spend target (null when none). */
+export async function getDailySummaryWithTarget(client) {
+  const data = await call(client, '/finances/email-schedules?kind=daily_summary');
+  return { schedule: data.schedule, target: data.dailySpendTarget ?? null };
+}
+
 export async function setDailySummary(client, { weekdays, hour, timezone, recipients, active } = {}) {
   const data = await call(client, '/finances/email-schedules', {
     method: 'POST',
@@ -469,6 +475,15 @@ export async function setDailySummary(client, { weekdays, hour, timezone, recipi
   return data.schedule;
 }
 
+/** Set the daily summary's $/day spend target, or clear it with null. Does not turn the summary on. */
+export async function setDailySpendTarget(client, target) {
+  const data = await call(client, '/finances/email-schedules', {
+    method: 'POST',
+    body: JSON.stringify({ kind: 'daily_summary', target }),
+  });
+  return { schedule: data.schedule, target: data.dailySpendTarget ?? null };
+}
+
 export async function deleteDailySummary(client) {
   return call(client, '/finances/email-schedules?kind=daily_summary', { method: 'DELETE' });
 }

package/src/mcp.js

@@ -95,13 +95,14 @@ export const TOOLS = [
   },
   {
     name: 'finance_daily_summary',
-    description: 'The daily summary email (due soon, new activity, position): show it, turn it on (optionally hour 0-23 and recipients), turn it off, or send one now.',
+    description: 'The daily summary email (spend vs a $/day target, top cuts, due soon, new activity, position): show it, turn it on (optionally hour 0-23 and recipients), turn it off, send one now, or set_target (target in $/day, null clears).',
     inputSchema: {
       type: 'object',
       properties: {
-        action: { type: 'string', enum: ['show', 'on', 'off', 'send_now'] },
+        action: { type: 'string', enum: ['show', 'on', 'off', 'send_now', 'set_target'] },
         hour: { type: 'integer', minimum: 0, maximum: 23 },
         to: { type: 'array', items: { type: 'string' }, maxItems: 5 },
+        target: { type: ['number', 'null'], minimum: 0 },
       },
       required: ['action'],
       additionalProperties: false,
@@ -110,7 +111,8 @@ export const TOOLS = [
       if (args.action === 'on') return text({ schedule: await reports.setDailySummary(client, { hour: args.hour, recipients: args.to, active: true }) });
       if (args.action === 'off') return text(await reports.deleteDailySummary(client));
       if (args.action === 'send_now') return text(await reports.sendDailySummaryNow(client));
-      return text({ schedule: await reports.getDailySummary(client) });
+      if (args.action === 'set_target') return text(await reports.setDailySpendTarget(client, args.target ?? null));
+      return text(await reports.getDailySummaryWithTarget(client));
     },
   },
   {