@skrr-ai/cli 0.1.129 → 0.1.130

package/dist/base-command.js

@@ -1617,6 +1617,21 @@ class BaseCommand extends core_1.Command {
                     details: envelopeDetails(body),
                 });
             }
+            else if (commitmentBodyErrorCode(body)) {
+                // These Commitment routes send the code in upper-case `error`, which `refusalCodeOf` does not
+                // read as a code, so the documented code (the guide's refusal table) never reached `error.code`:
+                // a program saw `HTTP_400` or `HTTP_409` and had to know to look in `details.error` (OSK-21102).
+                // Read them by name, as the activation and Compass refusals are, rather than widening
+                // `refusalCodeOf` for every route. The message is the server's, unchanged.
+                this.failWithCliError({
+                    message: say(bodyMessage || e.message),
+                    code: commitmentBodyErrorCode(body),
+                    status: e.status,
+                    exit: 1,
+                    retryable: false,
+                    details: envelopeDetails(body),
+                });
+            }
             else if ((e.status === 409 || e.status === 404) && (0, compass_refusals_1.compassRefusalCode)(body)) {
                 // The Compass routes sent the code in upper-case `error`, which `refusalCodeOf` does not
                 // read as a code, so a stale writer saw `HTTP_409` and a mistyped version `NOT_FOUND`,
@@ -2309,6 +2324,21 @@ function apiRefusal(err) {
 }
 /** The typed code the server refuses a Commitment activation with. */
 const COMMITMENT_ACTIVATION_BLOCKED = 'COMMITMENT_ACTIVATION_BLOCKED';
+/**
+ * Commitment refusals the routes send in upper-case `error` (OSK-21102): the retired `mode` and
+ * `policy.autonomyMode` fields, a cadence window no single wall-clock pattern holds, and an edit that
+ * tries to activate a draft (which only `resume` may do).
+ */
+const COMMITMENT_BODY_ERROR_CODES = new Set([
+    'COMMITMENT_MODE_RETIRED',
+    'COMMITMENT_POLICY_RETIRED',
+    'COMMITMENT_CADENCE_WINDOW_UNSUPPORTED',
+    'COMMITMENT_RESUME_REQUIRES_EXPLICIT_ACTION',
+]);
+function commitmentBodyErrorCode(body) {
+    const value = stringProp(body, 'error');
+    return value && COMMITMENT_BODY_ERROR_CODES.has(value) ? value : undefined;
+}
 /**
  * The remedy a refused Commitment activation carries.
  *

package/dist/commands/agenda/trigger/create.js

@@ -48,7 +48,9 @@ class AgendaTriggerCreate extends base_command_1.BaseCommand {
             description: 'IANA timezone for the cron (defaults to UTC). Only used with --kind=schedule.',
         }),
         'delay-minutes': core_1.Flags.integer({
-            description: 'Minutes from now to fire — required when --kind=self_scheduled. Range: 5..43200 (5min..30d).',
+            description: 'Minutes from now to fire — required when --kind=self_scheduled. ' +
+                `Range: ${data_provider_1.AGENDA_SELF_SCHEDULED_DELAY_MIN_MINUTES}..${data_provider_1.AGENDA_SELF_SCHEDULED_DELAY_MAX_MINUTES} ` +
+                `(${data_provider_1.AGENDA_SELF_SCHEDULED_DELAY_MIN_MINUTES} minutes..24 hours).`,
         }),
         'max-fires-per-day': core_1.Flags.integer({
             description: 'Daily cap on fires. Required for self_scheduled (1..96); defaults to 96 for schedule when omitted.',
@@ -91,6 +93,12 @@ class AgendaTriggerCreate extends base_command_1.BaseCommand {
             if (typeof flags['delay-minutes'] !== 'number') {
                 this.error('--delay-minutes is required when --kind=self_scheduled', { exit: 2 });
             }
+            // The server holds the same range, but its refusal arrives after the round trip. The sentence
+            // is data-provider's, so what is said here and what the route says cannot differ (OSK-21500).
+            const delayRefusal = (0, data_provider_1.describeAgendaDelayMinutesRefusal)(flags['delay-minutes']);
+            if (delayRefusal) {
+                this.error(`--delay-minutes: ${delayRefusal}`, { exit: 2 });
+            }
             if (typeof flags['max-fires-per-day'] !== 'number') {
                 this.error('--max-fires-per-day is required when --kind=self_scheduled', { exit: 2 });
             }

package/dist/commands/agents/reflect.d.ts

@@ -32,5 +32,11 @@ export default class AgentsReflect extends BaseCommand {
     run(): Promise<void>;
     private runDisable;
     private runEnableOrRetune;
+    /**
+     * Parse `--set-cadence` and apply the reflection window. A cadence that is not one
+     * (`0`, `1 month`, empty) is a usage error naming the rule, raised before anything is
+     * written, not an API failure.
+     */
+    private boundRequestedCadence;
     private runStatus;
 }

package/dist/commands/agents/reflect.js

@@ -55,12 +55,16 @@ class AgentsReflect extends base_command_1.BaseCommand {
         this.requireAuth();
         const { args, flags } = await this.parse(AgentsReflect);
         const agentId = args.id;
+        // Only the status view prints whether the loop's fires run, so only it asks the server for
+        // that verdict (a policy read); enabling, retuning and pausing do not.
+        const isStatus = !flags.disable && !flags.enable && flags['set-cadence'] === undefined;
         let existing;
         try {
             const list = await triggers_1.triggerApi.list((0, triggers_1.withQuery)('/api/triggers', {
                 scope: 'agent',
                 refEntity: (0, triggers_1.agentRefEntity)(agentId),
                 limit: 200,
+                include: isStatus ? 'autonomy' : undefined,
             }));
             existing = (0, reflection_1.findReflectionTrigger)(list.triggers ?? []);
         }
@@ -103,14 +107,23 @@ class AgentsReflect extends base_command_1.BaseCommand {
         // Resolve the target cadence: explicit --set-cadence, else keep the existing
         // interval when just --enabling, else the default.
         let minutes;
+        let bounds = null;
         if (flags['set-cadence'] !== undefined) {
-            minutes = (0, reflection_1.clampCadenceMinutes)((0, reflection_1.parseCadenceToMinutes)(flags['set-cadence']));
+            bounds = this.boundRequestedCadence(flags['set-cadence']);
+            minutes = bounds.minutes;
         }
         else {
             minutes =
                 (existing && (0, reflection_1.reflectionCadenceMinutes)(existing)) || reflection_1.DEFAULT_REFLECTION_CADENCE_MINUTES;
         }
         const cadence = (0, reflection_1.describeCadenceMinutes)(minutes);
+        // What was ASKED for, beside what was applied: a request the window moved is said so
+        // (OSK-21493), in the text and in `--json`, instead of only the clamped number.
+        const clampNote = bounds ? (0, reflection_1.describeCadenceClamp)(bounds) : null;
+        const requested = {
+            requestedCadence: bounds ? (0, reflection_1.describeCadenceMinutes)(bounds.requestedMinutes) : null,
+            ...(clampNote ? { clamped: true, note: clampNote } : {}),
+        };
         if (existing?.id) {
             const patch = {
                 enabled: true,
@@ -124,10 +137,12 @@ class AgentsReflect extends base_command_1.BaseCommand {
             }
             const updated = await triggers_1.triggerApi.update(existing.id, patch);
             if (flags.json) {
-                this.log(JSON.stringify({ ok: true, agentId, action: 'retuned', cadence, trigger: updated }, null, 2));
+                this.log(JSON.stringify({ ok: true, agentId, action: 'retuned', ...requested, cadence, trigger: updated }, null, 2));
                 return;
             }
             this.log(`Self-reflection loop retuned — agent ${agentId} now reflects every ${cadence}.`);
+            if (clampNote)
+                this.log(`Note: ${clampNote}`);
             this.log(`Trigger: ${existing.id}`);
             return;
         }
@@ -138,12 +153,30 @@ class AgentsReflect extends base_command_1.BaseCommand {
         });
         const created = await triggers_1.triggerApi.create(payload);
         if (flags.json) {
-            this.log(JSON.stringify({ ok: true, agentId, action: 'enabled', cadence, trigger: created }, null, 2));
+            this.log(JSON.stringify({ ok: true, agentId, action: 'enabled', ...requested, cadence, trigger: created }, null, 2));
             return;
         }
         this.log(`Self-reflection loop enabled — agent ${agentId} will reflect every ${cadence}.`);
+        if (clampNote)
+            this.log(`Note: ${clampNote}`);
         this.log(`Trigger: ${created.id ?? '(created)'}`);
-        this.log(`Next run: ${(0, triggers_1.nextRunLabel)(created)}`);
+        this.log(`Next run: ${(0, reflection_1.reflectionNextRunLabel)(created)}`);
+    }
+    /**
+     * Parse `--set-cadence` and apply the reflection window. A cadence that is not one
+     * (`0`, `1 month`, empty) is a usage error naming the rule, raised before anything is
+     * written, not an API failure.
+     */
+    boundRequestedCadence(raw) {
+        try {
+            return (0, reflection_1.applyCadenceBounds)((0, reflection_1.parseCadenceToMinutes)(raw));
+        }
+        catch (err) {
+            if (err instanceof reflection_1.InvalidCadenceError) {
+                this.failWithCliError({ message: err.message, code: err.code, exit: 2, retryable: false });
+            }
+            throw err;
+        }
     }
     runStatus(agentId, existing, json) {
         if (!existing) {
@@ -165,7 +198,8 @@ class AgentsReflect extends base_command_1.BaseCommand {
                 enabled: existing.enabled !== false,
                 cadence,
                 cadenceMinutes: minutes ?? null,
-                nextRun: (0, triggers_1.nextRunLabel)(existing),
+                nextRun: (0, reflection_1.reflectionNextRunLabel)(existing),
+                ...(0, reflection_1.reflectionAutonomyFields)(existing),
                 trigger: existing,
             }, null, 2));
             return;
@@ -173,8 +207,13 @@ class AgentsReflect extends base_command_1.BaseCommand {
         this.log(`Self-reflection loop for agent ${agentId}:`);
         this.log(`  Status:   ${existing.enabled === false ? 'paused' : 'active'}`);
         this.log(`  Cadence:  every ${cadence}`);
-        this.log(`  Next run: ${(0, triggers_1.nextRunLabel)(existing)}`);
+        this.log(`  Next run: ${(0, reflection_1.reflectionNextRunLabel)(existing)}`);
         this.log(`  Trigger:  ${existing.id ?? '-'}`);
+        // "active" with a next run says the loop is armed, not that its fires run: under some
+        // initiative modes they only create an inbox suggestion (OSK-21606).
+        const autonomyNote = (0, reflection_1.reflectionAutonomyNote)(existing, this.config.bin);
+        if (autonomyNote)
+            this.log(`  Note:     ${autonomyNote}`);
         if (existing.enabled === false) {
             this.log('');
             this.log('Re-enable it with:  ' + `${this.config.bin} agents reflect ${agentId} --enable`);

package/dist/commands/agents/schedule-overview.d.ts

@@ -1,4 +1,5 @@
 import { BaseCommand } from '../../base-command';
+import { type TriggerDefinition } from '../../lib/triggers';
 /**
  * `skrr agents schedule-overview <agent-id>` — the one-call "full visibility"
  * view an agent needs when it wakes to think: PAST (recent fires) + FUTURE
@@ -25,3 +26,19 @@ export default class AgentsScheduleOverview extends BaseCommand {
     };
     run(): Promise<void>;
 }
+/** The reflection loop as `--json` reports it. A paused loop has no next run (`-`). */
+export declare function reflectionSummary(reflection: TriggerDefinition): {
+    autonomy?: "runs" | "suggests_only";
+    note?: string;
+    triggerId: string | undefined;
+    enabled: boolean;
+    cadence: string;
+    nextRun: string;
+};
+/** The reflection loop as the text view prints it. */
+export declare function reflectionLine(reflection: TriggerDefinition): string;
+/**
+ * The line under the loop when the server says its fires do not run for the owner (OSK-21606),
+ * else null. "active · next <time>" only says the loop is armed.
+ */
+export declare function reflectionNoteLine(reflection: TriggerDefinition, bin: string): string | null;

package/dist/commands/agents/schedule-overview.js

@@ -1,5 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.reflectionSummary = reflectionSummary;
+exports.reflectionLine = reflectionLine;
+exports.reflectionNoteLine = reflectionNoteLine;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -51,6 +54,8 @@ class AgentsScheduleOverview extends base_command_1.BaseCommand {
                 scope: 'agent',
                 refEntity: (0, triggers_1.agentRefEntity)(agentId),
                 limit: 200,
+                // Whether the reflection loop's fires run: its row carries the verdict (OSK-21606).
+                include: 'autonomy',
             })),
             // Filter SERVER-side. Fetching an unfiltered page and filtering in memory
             // silently truncates the section for any user with more tasks than
@@ -72,14 +77,7 @@ class AgentsScheduleOverview extends base_command_1.BaseCommand {
         if (flags.json) {
             this.log(JSON.stringify({
                 agentId,
-                reflection: reflection
-                    ? {
-                        triggerId: reflection.id,
-                        enabled: reflection.enabled !== false,
-                        cadence: describeCadence(reflection),
-                        nextRun: (0, triggers_1.nextRunLabel)(reflection),
-                    }
-                    : null,
+                reflection: reflection ? reflectionSummary(reflection) : null,
                 upcoming,
                 recentFires: fires,
                 openTasks,
@@ -97,7 +95,10 @@ class AgentsScheduleOverview extends base_command_1.BaseCommand {
             this.log(`  none — enable with: ${this.config.bin} agents reflect ${agentId} --set-cadence 6h`);
         }
         else {
-            this.log(`  ${reflection.enabled === false ? 'paused' : 'active'} · every ${describeCadence(reflection)} · next ${(0, triggers_1.nextRunLabel)(reflection)} · ${reflection.id ?? '-'}`);
+            this.log(reflectionLine(reflection));
+            const note = reflectionNoteLine(reflection, this.config.bin);
+            if (note)
+                this.log(note);
         }
         // FUTURE.
         this.log('');
@@ -190,6 +191,29 @@ function describeCadence(trigger) {
     const minutes = (0, reflection_1.reflectionCadenceMinutes)(trigger);
     return minutes ? (0, reflection_1.describeCadenceMinutes)(minutes) : 'unknown';
 }
+/** The reflection loop as `--json` reports it. A paused loop has no next run (`-`). */
+function reflectionSummary(reflection) {
+    return {
+        triggerId: reflection.id,
+        enabled: reflection.enabled !== false,
+        cadence: describeCadence(reflection),
+        nextRun: (0, reflection_1.reflectionNextRunLabel)(reflection),
+        // Whether its fires run, when the server said; absent means it did not.
+        ...(0, reflection_1.reflectionAutonomyFields)(reflection),
+    };
+}
+/** The reflection loop as the text view prints it. */
+function reflectionLine(reflection) {
+    return `  ${reflection.enabled === false ? 'paused' : 'active'} · every ${describeCadence(reflection)} · next ${(0, reflection_1.reflectionNextRunLabel)(reflection)} · ${reflection.id ?? '-'}`;
+}
+/**
+ * The line under the loop when the server says its fires do not run for the owner (OSK-21606),
+ * else null. "active · next <time>" only says the loop is armed.
+ */
+function reflectionNoteLine(reflection, bin) {
+    const note = (0, reflection_1.reflectionAutonomyNote)(reflection, bin);
+    return note ? `  Note: ${note}` : null;
+}
 function settledValue(result) {
     return result.status === 'fulfilled' ? result.value : undefined;
 }

package/dist/commands/agents/triggers/policy.js

@@ -56,7 +56,9 @@ class AgentsTriggersPolicy extends base_command_1.BaseCommand {
             description: 'Allowed trigger kind under auto_run_limited (repeatable or comma-separated)',
             multiple: true,
         }),
-        'max-fires-per-day': core_1.Flags.integer({ description: 'Agent initiative daily fire cap' }),
+        'max-fires-per-day': core_1.Flags.integer({
+            description: 'Daily cap on how often this agent can wake itself: its Task returns and self_scheduled triggers, whatever cap they carry',
+        }),
         'max-per-hour': core_1.Flags.integer({ description: 'Agent initiative hourly fire cap' }),
         'working-hours': core_1.Flags.string({ description: 'Policy workingHours JSON object' }),
         'quiet-hours': core_1.Flags.string({ description: 'Policy quietHours JSON object' }),

package/dist/commands/northstars/create.js

@@ -15,10 +15,11 @@ const HOUR_MS = 60 * 60 * 1000;
  * `skrr northstars governance configure`.
  */
 class NorthstarsCreate extends base_command_1.BaseCommand {
-    static description = 'Create a northstar (the portfolio layer above commitments)';
+    static description = `Create a northstar (the portfolio layer above commitments)\n\n${northstars_1.NORTHSTAR_WORKSPACE_CREATE_HELP}`;
     static examples = [
         '<%= config.bin %> northstars create --title "Reach $10M ARR"',
         '<%= config.bin %> northstars create --title "Reliability" --tier critical --max-active 5 --review-interval-hours 24',
+        '<%= config.bin %> northstars create --title "Reliability" --workspace <workspace-id>',
     ];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
@@ -98,6 +99,10 @@ class NorthstarsCreate extends base_command_1.BaseCommand {
         }
         this.log(`Created ${created.id} — ${created.title} (${created.status})`);
         this.log(`URL: ${created.url ?? '-'}`);
+        this.log((0, northstars_1.northstarWorkspaceLine)(created));
+        const workspaceNote = (0, northstars_1.createdNorthstarNote)(created);
+        if (workspaceNote)
+            this.log(workspaceNote);
         if (flags['max-active'] === 0)
             this.log('Attention   max active 0 (no cap)');
         this.log(flags['review-interval-hours'] !== undefined

package/dist/commands/northstars/list.js

@@ -12,7 +12,7 @@ const northstars_1 = require("../../lib/northstars");
  * their health on a cadence.
  */
 class NorthstarsList extends base_command_1.BaseCommand {
-    static description = 'List northstars (the portfolio layer above commitments)';
+    static description = `List northstars (the portfolio layer above commitments)\n\nThe WORKSPACE column is a shortened workspace id (--json has the full workspaceId) or "personal". ${northstars_1.NORTHSTAR_WORKSPACE_READ_HELP}`;
     static examples = [
         '<%= config.bin %> northstars list',
         '<%= config.bin %> northstars list --status active',

package/dist/commands/northstars/show.js

@@ -27,7 +27,7 @@ function normalizeNorthstarShowResponse(status) {
  * asking of a portfolio, which is what is actually in it.
  */
 class NorthstarsShow extends base_command_1.BaseCommand {
-    static description = 'Show a northstar, its linked commitments, and open recommendations';
+    static description = `Show a northstar, its linked commitments, and open recommendations\n\nThe Workspace line is the full workspace id, or "personal". ${northstars_1.NORTHSTAR_WORKSPACE_READ_HELP}`;
     static examples = [
         '<%= config.bin %> northstars show nst_abc123',
         '<%= config.bin %> northstars show nst_abc123 --json',

package/dist/commands/spaces/heartbeats/status.js

@@ -49,6 +49,16 @@ class SpacesHeartbeatsStatus extends base_command_1.BaseCommand {
         this.log(`Running:        ${s.isRunning === true ? 'yes' : 'no'}`);
         this.log(`Next Run:       ${s.nextRunAt ? (0, format_1.localTime)(s.nextRunAt) : '-'}`);
         this.log(`BullMQ Job Key: ${s.bullmqJobKey ?? '-'}`);
+        // The newest fire and what became of it. `Next Run` moves whether or not a fire does anything,
+        // so a heartbeat the agent's policy skips on every fire would otherwise read as healthy.
+        const fire = s.lastFire;
+        if (fire && typeof fire === 'object') {
+            const what = [fire.outcome, fire.reason].filter(Boolean).join(': ');
+            this.log(`Last Fire:      ${fire.firedAt ? (0, format_1.localTime)(fire.firedAt) : '-'}  ${what || '-'}`);
+            if (fire.outcome === 'skipped') {
+                this.log('The last fire did nothing: the heartbeat was skipped, not run. `skrr triggers audit` lists every fire.');
+            }
+        }
     }
 }
 exports.default = SpacesHeartbeatsStatus;

package/dist/commands/tasks/archive.js

@@ -4,6 +4,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const web_url_1 = require("../../lib/web-url");
+const task_schedule_notes_1 = require("../../lib/task-schedule-notes");
 class TasksArchive extends base_command_1.BaseCommand {
     static description = 'Archive a task (reversible — use --unarchive to restore)';
     static examples = [
@@ -37,6 +38,11 @@ class TasksArchive extends base_command_1.BaseCommand {
         }
         const action = flags.unarchive ? 'unarchived' : 'archived';
         this.log(`Task ${args.id} ${action}`);
+        const lines = flags.unarchive
+            ? (0, task_schedule_notes_1.unarchiveResultLines)(result, String(args.id), this.config.bin)
+            : (0, task_schedule_notes_1.archiveResultLines)(result);
+        for (const line of lines)
+            this.log(line);
     }
 }
 exports.default = TasksArchive;

package/dist/commands/tasks/pause-schedule.js

@@ -5,7 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const web_url_1 = require("../../lib/web-url");
 class TasksPauseSchedule extends base_command_1.BaseCommand {
-    static description = 'Pause future recurring runs; current runs and already queued work are unchanged';
+    static description = 'Pause future recurring runs; current runs and already queued work are unchanged. A run that comes due while paused is skipped, not replayed, when you resume';
     static examples = [
         '<%= config.bin %> tasks pause-schedule <task-id>',
         '<%= config.bin %> tasks pause-schedule <task-id> --json',

package/dist/commands/tasks/resume-schedule.js

@@ -4,8 +4,9 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const web_url_1 = require("../../lib/web-url");
+const task_schedule_notes_1 = require("../../lib/task-schedule-notes");
 class TasksResumeSchedule extends base_command_1.BaseCommand {
-    static description = 'Resume a paused recurring task — server re-computes the next fire from the cron pattern';
+    static description = 'Resume a paused recurring task. A run that came due while it was paused is skipped (not replayed); the next run comes from the cron pattern';
     static examples = [
         '<%= config.bin %> tasks resume-schedule <task-id>',
         '<%= config.bin %> tasks resume-schedule <task-id> --json',
@@ -34,6 +35,8 @@ class TasksResumeSchedule extends base_command_1.BaseCommand {
         const t = result;
         const ref = t.identifier ?? (t.taskNumber ? `#${t.taskNumber}` : '');
         this.log(`Resumed schedule on task ${t.id ?? t._id ?? taskRef}${ref ? ` (${ref})` : ''}`);
+        for (const line of (0, task_schedule_notes_1.resumeResultLines)(t))
+            this.log(line);
     }
 }
 exports.default = TasksResumeSchedule;

package/dist/commands/tasks/schedule.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const web_url_1 = require("../../lib/web-url");
 const prompt_1 = require("../../lib/prompt");
+const task_schedule_notes_1 = require("../../lib/task-schedule-notes");
 const iso_instant_1 = require("../../lib/iso-instant");
 const task_recurrence_summary_1 = require("../../lib/task-recurrence-summary");
 class TasksSchedule extends base_command_1.BaseCommand {
@@ -91,7 +92,8 @@ class TasksSchedule extends base_command_1.BaseCommand {
         }
         const t = result;
         const ref = t.identifier ?? (t.taskNumber ? `#${t.taskNumber}` : '');
-        this.log(`Scheduled task ${t.id ?? t._id ?? taskRef}${ref ? ` (${ref})` : ''} for ${payload.scheduledFor}`);
+        const paused = Boolean(t.schedulePaused);
+        this.log(`${paused ? 'Recorded the time for' : 'Scheduled'} task ${t.id ?? t._id ?? taskRef}${ref ? ` (${ref})` : ''} for ${payload.scheduledFor}`);
         if (t.recurrence?.pattern) {
             // Always name the zone: the pattern is read in UTC unless one was set, and a rule with no zone beside it
             // is exactly what could not be told apart from a local-time one.
@@ -108,6 +110,9 @@ class TasksSchedule extends base_command_1.BaseCommand {
             if (t.recurrence.endDate)
                 this.log(`Ends: ${t.recurrence.endDate}`);
         }
+        for (const line of (0, task_schedule_notes_1.scheduleResultLines)(t, String(t.id ?? t._id ?? taskRef), this.config.bin)) {
+            this.log(line);
+        }
     }
 }
 exports.default = TasksSchedule;

package/dist/commands/tasks/self-schedule.d.ts

@@ -23,8 +23,64 @@ export default class TasksSelfSchedule extends BaseCommand {
         in: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         note: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'max-per-day': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        're-enable': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         show: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         clear: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }
+/** What the server records about a return that came due (`lastDecision` on the GET). */
+export interface ReturnDecision {
+    outcome?: string;
+    /** ran | skipped | failed | waiting. Absent from a server older than this field. */
+    verdict?: 'ran' | 'skipped' | 'failed' | 'waiting';
+    reason?: string | null;
+    /** The reason in plain words, when the server has some for it. */
+    reasonText?: string | null;
+    at?: string | null;
+}
+/** The part after "the return came due and": what became of it, with the reason. */
+export declare function decisionClause(decision: ReturnDecision): string;
+/**
+ * The line `--show` prints for a return whose time has passed. "returned at" is
+ * said only when a run really started; a skipped, failed or unrecorded return
+ * says what it was.
+ */
+export declare function describeSpentReturn({ taskRef, runAt, decision, triggerId, bin, }: {
+    taskRef: string;
+    runAt: string;
+    decision?: ReturnDecision | null;
+    triggerId?: string;
+    bin?: string;
+}): string;
+/**
+ * `--in` as an instant. A value that does not parse says WHICH value, because
+ * the generic "pass --at or --in" this used to fall through to told a person who
+ * had passed `--in 1.5h` to pass `--in`.
+ *
+ * Seconds are accepted: the server owns the 60 s floor and answers
+ * `RETURN_TOO_SOON` with the bound, which is a better explanation than the CLI
+ * refusing the unit.
+ */
+export declare function resolveRelativeRunAt(relative: string, now?: number): {
+    runAt: string;
+} | {
+    error: string;
+};
+/**
+ * `--at` as a UTC instant. Any offset is accepted and normalised, so the server
+ * always receives `...Z`. A value with no zone is refused by saying so: it is a
+ * valid ISO-8601 string, and "Invalid ISO datetime" for it read as if the CLI
+ * could not parse a thing the help had just told the person to type.
+ */
+export declare function resolveAbsoluteRunAt(absolute: string): {
+    runAt: string;
+} | {
+    error: string;
+};
+/** `--at`, or `--in`, or neither (undefined). Absolute wins when both are given. */
+export declare function resolveRunAt(at?: string, relative?: string, now?: number): {
+    runAt: string;
+} | {
+    error: string;
+} | undefined;