@slothmoney/agent-cli 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.8.0 - 2026-08-12
+
+- Read each goal's one-based priority and move one goal to a new position with
+  automatic shifting of the intervening goals.
+
+## 0.7.0 - 2026-08-09
+
 - Read personal or joint budget periods with categories, line items, funding,
   and planned amounts.
 - Preview or apply planned line-item updates that overwrite the selected period

package/README.md

@@ -15,7 +15,7 @@ sloth-agent --version
 For a one-off pinned run:
 
 ```bash
-npm exec --yes --package=@slothmoney/agent-cli@0.7.0 -- sloth-agent --help
+npm exec --yes --package=@slothmoney/agent-cli@0.8.0 -- sloth-agent --help
 ```
 
 ## Authenticate
@@ -355,7 +355,7 @@ sloth-agent goals create \
   --apply
 ```
 
-Use the `id` from list or create output to update or delete a goal:
+Use the `id` from list or create output to update or delete goals:
 
 ```bash
 sloth-agent goals update \
@@ -365,6 +365,11 @@ sloth-agent goals update \
   --achieved=false \
   --apply
 
+sloth-agent goals update \
+  --goal-id house-goal-id \
+  --priority 2 \
+  --apply
+
 sloth-agent goals delete --goal-id goal-id --apply
 ```
 
@@ -373,7 +378,13 @@ remove an optional value. Marking a goal achieved removes its forecast
 assignment. Deleting a goal also removes its forecast assignments and drift
 history. Goal sharing remains app-managed. Change an active shared goal's
 pot-tracked target amount in the Sloth Budget app, where account balances can
-be reallocated across goals in priority order.
+be reallocated across goals in priority order. Goal list output includes a
+one-based `priority`; `1` is highest. Moving one goal automatically shifts the
+goals between its old and new positions. The
+priority option must be used on its own, and the write persists immediately.
+Forecast assignments and shared pot
+progress are browser-owned derived state and refresh when the owner next opens
+the Forecast screen.
 
 Read uncategorised contributions to the joint budget:
 

package/dist/args.js

@@ -64,6 +64,16 @@ function parseGoalMonthKey(value, name) {
     }
     return value;
 }
+function parseGoalPriority(value) {
+    if (!/^[1-9]\d*$/.test(value)) {
+        throw new UsageError('--priority must be a positive whole-number position');
+    }
+    const priority = Number(value);
+    if (!Number.isSafeInteger(priority)) {
+        throw new UsageError('--priority must be a positive whole-number position');
+    }
+    return priority;
+}
 function parseExplicitBoolean(value, name) {
     if (value !== 'true' && value !== 'false') {
         throw new UsageError(`${name} must be true or false`);
@@ -467,6 +477,7 @@ function parseGoals(args, baseUrl) {
         let targetAmount;
         let targetMonthKey;
         let isAchieved;
+        let priority;
         let apply = false;
         for (let index = 0; index < args.length; index += 1) {
             const argument = args[index];
@@ -497,7 +508,8 @@ function parseGoals(args, baseUrl) {
                 && option !== '--name'
                 && option !== '--target-amount'
                 && option !== '--target-month'
-                && option !== '--achieved') {
+                && option !== '--achieved'
+                && option !== '--priority') {
                 throw new UsageError(`Unknown goals update option: ${argument}`);
             }
             const value = requireNonEmpty(inlineValue ?? readOptionValue(args, index, option), option);
@@ -521,6 +533,9 @@ function parseGoals(args, baseUrl) {
                 }
                 targetMonthKey = parseGoalMonthKey(value, option);
             }
+            else if (option === '--priority') {
+                priority = setOnce(priority, parseGoalPriority(value), option);
+            }
             else {
                 isAchieved = setOnce(isAchieved, parseExplicitBoolean(value, option), option);
             }
@@ -530,9 +545,17 @@ function parseGoals(args, baseUrl) {
         if (name === undefined
             && targetAmount === undefined
             && targetMonthKey === undefined
-            && isAchieved === undefined) {
+            && isAchieved === undefined
+            && priority === undefined) {
             throw new UsageError('goals update requires at least one field to update');
         }
+        if (priority !== undefined
+            && (name !== undefined
+                || targetAmount !== undefined
+                || targetMonthKey !== undefined
+                || isAchieved !== undefined)) {
+            throw new UsageError('--priority must be used on its own');
+        }
         return withBaseUrl({
             command: 'goals-update',
             goalId,
@@ -540,6 +563,7 @@ function parseGoals(args, baseUrl) {
             ...(targetAmount === undefined ? {} : { targetAmount }),
             ...(targetMonthKey === undefined ? {} : { targetMonthKey }),
             ...(isAchieved === undefined ? {} : { isAchieved }),
+            ...(priority === undefined ? {} : { priority }),
             apply,
         }, baseUrl);
     }

package/dist/cli.js

@@ -4,7 +4,7 @@ import { ICON_KEYS } from './category-metadata.js';
 import { parseApiResponse, validateAssignmentPayload, validateBudgetUpdatePayload, } from './contracts.js';
 import { createSystemCredentialStore, secureStorageUnavailableError, } from './credential-store.js';
 import { ApiError, CliError, ConfigError, UsageError, } from './errors.js';
-export const CLI_VERSION = '0.7.0';
+export const CLI_VERSION = '0.8.0';
 const REQUEST_TIMEOUT_MS = 60_000;
 const API_ORIGIN_HELP_LINES = [
     '',
@@ -562,7 +562,7 @@ export function goalsListHelpText() {
         '  This command is read-only.',
         '',
         'Output:',
-        '  JSON containing currency and goals. Each goal contains id, name,',
+        '  JSON containing currency and goals. Each goal contains id, name, priority,',
         '  targetAmount, targetMonthKey, isAchieved, and sharedWithPartner.',
     ].join('\n');
 }
@@ -615,6 +615,7 @@ export function goalsUpdateHelpText() {
         '  --target-month YYYY-MM       Optional. Replace the target month.',
         '  --clear-target-month         Optional. Remove the target month.',
         '  --achieved=true|false        Optional. Mark the goal achieved or active.',
+        '  --priority POSITION          Optional. Positive whole-number position; 1 is highest.',
         '  --apply                      Optional. Write the partial update.',
         '  --base-url URL               Optional. Override the API origin.',
         '  -h, --help                   Show this help.',
@@ -622,6 +623,11 @@ export function goalsUpdateHelpText() {
         '',
         'Constraints:',
         '  Provide at least one field to update.',
+        '  Priority must be updated on its own.',
+        '  Priority 1 is highest. The position cannot exceed the current goal count.',
+        '  Moving a goal shifts the intervening goals automatically.',
+        '  Forecast assignments and shared progress refresh when the owner next opens',
+        '  the Forecast screen.',
         '  Set and clear options for the same field are mutually exclusive.',
         '  Marking a goal achieved removes its forecast assignment.',
         '  Marking it active again does not restore the previous assignment.',
@@ -634,6 +640,9 @@ export function goalsUpdateHelpText() {
         '  Without --apply, the command returns a dry-run preview and does not write.',
         '  Applying requires a write-enabled token created with Allow changes.',
         '',
+        'Example:',
+        '  sloth-agent goals update --goal-id goal-3 --priority 2 --apply',
+        '',
         'Output:',
         '  Preview mode returns dryRun, method, endpoint, and payload.',
         '  Apply mode returns the complete persisted goal and currency.',
@@ -724,6 +733,23 @@ export function commandHelpText(topic) {
 function writeJson(write, data) {
     write(`${JSON.stringify(data, null, 2)}\n`);
 }
+function withListedGoalPriorities(value) {
+    const response = value;
+    return {
+        ...response,
+        goals: response.goals.map((goal, index) => ({
+            ...goal,
+            priority: index + 1,
+        })),
+    };
+}
+function withUpdatedGoalPriority(value, priority) {
+    const response = value;
+    return {
+        ...response,
+        goal: { ...response.goal, priority },
+    };
+}
 function redact(value, token) {
     return token ? value.split(token).join('[REDACTED]') : value;
 }
@@ -1104,6 +1130,9 @@ export async function runCli(argv = process.argv.slice(2), options = {}) {
                 ...(parsed.isAchieved === undefined
                     ? {}
                     : { isAchieved: parsed.isAchieved }),
+                ...(parsed.priority === undefined
+                    ? {}
+                    : { priority: parsed.priority }),
             };
             if (!parsed.apply) {
                 writeJson(writeStdout, {
@@ -1124,7 +1153,9 @@ export async function runCli(argv = process.argv.slice(2), options = {}) {
                 signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
             });
             const data = parseApiResponse('goals-update', await parseHttpResponse(response, token));
-            writeJson(writeStdout, data);
+            writeJson(writeStdout, parsed.priority === undefined
+                ? data
+                : withUpdatedGoalPriority(data, parsed.priority));
             return 0;
         }
         if (parsed.command === 'goals-delete') {
@@ -1187,7 +1218,7 @@ export async function runCli(argv = process.argv.slice(2), options = {}) {
                 signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
             });
             const data = parseApiResponse('goals-list', await parseHttpResponse(response, token));
-            writeJson(writeStdout, data);
+            writeJson(writeStdout, withListedGoalPriorities(data));
             return 0;
         }
         if (parsed.command === 'budget') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slothmoney/agent-cli",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Command-line access to the Sloth Money Agent API.",
   "type": "module",
   "bin": {