@skrr-ai/cli 0.1.129 → 0.1.131

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/agent/message/send.js

@@ -747,6 +747,9 @@ function normalizeIntentPayload({ agentId, jsonBody, merged, }) {
     const overlayChannel = optionalString(merged.channelId);
     const overlayThreadTs = optionalString(merged.threadTs);
     const destinationKind = pickDestinationKind({ bodyDestination, overlayKind });
+    if (destinationKind !== 'slack_channel' && (overlayThreadTs || bodyDestination?.threadTs)) {
+        throw invalidIntent('--thread-ts / destination.threadTs only applies to slack_channel.');
+    }
     const destination = buildDestination({
         kind: destinationKind,
         bodyDestination,

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/schedule-trace.js

@@ -25,7 +25,7 @@ class AgentsScheduleTrace extends base_command_1.BaseCommand {
     };
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
-        date: core_1.Flags.string({ description: 'Plan date (YYYY-MM-DD). Defaults to today.' }),
+        date: core_1.Flags.string({ description: 'Plan date (YYYY-MM-DD). Defaults to today in the plan timezone.' }),
         todo: core_1.Flags.string({ description: 'Scope the trace to one to-do' }),
         timezone: core_1.Flags.string({ description: 'IANA timezone for the plan day' }),
         limit: core_1.Flags.integer({ description: 'Events to return (1-200)' }),
@@ -34,16 +34,25 @@ class AgentsScheduleTrace extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(AgentsScheduleTrace);
-        // The server requires a plan date. Defaulting to today locally keeps the
-        // common call a single argument rather than a date the caller must know.
-        const date = flags.date ?? new Date().toISOString().slice(0, 10);
+        // Use the same zone for choosing the day and querying its events. UTC can
+        // already be tomorrow while it is still evening for the reader.
+        const timezone = flags.timezone ?? (flags.date ? undefined : Intl.DateTimeFormat().resolvedOptions().timeZone);
+        let date = flags.date;
+        if (!date) {
+            try {
+                date = (0, schedule_1.scheduleTraceToday)(new Date(), timezone);
+            }
+            catch {
+                this.error(`Invalid IANA timezone: ${timezone}`, { exit: 1 });
+            }
+        }
         let trace;
         try {
             trace = await schedule_1.scheduleApi.scheduleTrace({
                 agentId: args.agent,
                 date,
                 todoId: flags.todo,
-                timezone: flags.timezone,
+                timezone,
                 limit: flags.limit,
                 cursor: flags.cursor,
             });

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/harnesses/prune.d.ts

@@ -18,6 +18,7 @@ export default class HarnessesPrune extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'older-than': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'include-gone-leases': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/harnesses/prune.js

@@ -30,12 +30,20 @@ class HarnessesPrune extends base_command_1.BaseCommand {
         'pinned row is KEPT, with the agents named. Move the pin (`agents attach-harness`) and run this again.\n\n' +
         'At most --limit rows are removed per run, oldest first; the rest are counted and the next run takes ' +
         'them. Running it again when nothing qualifies removes nothing. A daemon that is still running ' +
-        're-registers on its next connection, so removing a row never stops a machine.';
+        're-registers on its next connection, so removing a row never stops a machine.\n\n' +
+        'A hosted, dedicated or cloud machine belongs to its lease, so by default it is never touched. ' +
+        '--include-gone-leases also considers the rows of such a machine whose lease is GONE (archived, ' +
+        'terminating, terminated, failed or lost): no compute runs on it again, so the row can never come ' +
+        'back online. A row with no lease, a lease that can come back (stopped, ready, active) and a row ' +
+        'with usage recorded against it are kept, and so is everything the rules above keep. Use --older-than ' +
+        'to leave recent ones, for example 30d.';
     static examples = [
         '<%= config.bin %> harnesses prune',
         '<%= config.bin %> harnesses prune --yes',
         '<%= config.bin %> harnesses prune --yes --limit 20',
         '<%= config.bin %> harnesses prune --older-than 7d --json',
+        '<%= config.bin %> harnesses prune --include-gone-leases --older-than 30d',
+        '<%= config.bin %> harnesses prune --include-gone-leases --older-than 30d --yes --limit 200',
     ];
     static flags = {
         yes: core_1.Flags.boolean({
@@ -50,6 +58,10 @@ class HarnessesPrune extends base_command_1.BaseCommand {
         'older-than': core_1.Flags.string({
             description: 'Only rows unseen for at least this long: 90m, 36h or 7d (default 24h). The server never goes below its offline window.',
         }),
+        'include-gone-leases': core_1.Flags.boolean({
+            description: 'Also consider the rows of hosted, dedicated or cloud machines whose lease is gone. Off by default.',
+            default: false,
+        }),
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
     };
     async run() {
@@ -71,6 +83,7 @@ class HarnessesPrune extends base_command_1.BaseCommand {
                 dryRun: !flags.yes,
                 ...(flags.limit !== undefined ? { limit: flags.limit } : {}),
                 ...(minUnseenMs !== undefined ? { minUnseenMs } : {}),
+                ...(flags['include-gone-leases'] ? { includeGoneLeases: true } : {}),
             });
         }
         catch (err) {
@@ -86,7 +99,9 @@ class HarnessesPrune extends base_command_1.BaseCommand {
     render(result) {
         const { dryRun } = result;
         const removing = dryRun ? result.remove.length : result.removedCount;
-        const noun = (n) => `${n} superseded harness row${n === 1 ? '' : 's'}`;
+        // "superseded" is only true of the personal-machine rows; a gone-lease row was not replaced by anything.
+        const kind = result.remove.some((row) => row.goneLease) ? '' : 'superseded ';
+        const noun = (n) => `${n} ${kind}harness row${n === 1 ? '' : 's'}`;
         if (dryRun) {
             this.log('Dry run - nothing was removed.');
         }
@@ -141,6 +156,9 @@ class HarnessesPrune extends base_command_1.BaseCommand {
         if (count('not_personal_machine') > 0) {
             passedOver.push(`${count('not_personal_machine')} hosted, dedicated, cloud or of unknown origin`);
         }
+        if (count('lease_not_gone') > 0) {
+            passedOver.push(`${count('lease_not_gone')} of a machine whose lease is not gone`);
+        }
         if (count('no_machine_identity') > 0) {
             passedOver.push(`${count('no_machine_identity')} that name no machine`);
         }
@@ -159,13 +177,15 @@ class HarnessesPrune extends base_command_1.BaseCommand {
             provider: (0, format_1.formatCell)(row.provider),
             daemon: (0, format_1.formatCell)(row.daemonId),
             seen: (0, format_1.localStamp)(row.lastSeenAt),
-            replacedBy: (0, format_1.formatCell)(row.supersededBy?.daemonId),
+            replacedBy: row.goneLease
+                ? `lease gone (${row.goneLease})`
+                : (0, format_1.formatCell)(row.supersededBy?.daemonId),
         })), [
             { key: 'id', header: 'HARNESS ID' },
             { key: 'provider', header: 'PROVIDER' },
             { key: 'daemon', header: 'DAEMON ID', verbatim: true },
             { key: 'seen', header: `LAST SEEN (${(0, format_1.localZone)()})` },
-            { key: 'replacedBy', header: 'REPLACED BY (ONLINE)', verbatim: true },
+            { key: 'replacedBy', header: 'REPLACED BY (ONLINE) / LEASE', verbatim: true },
         ], (line) => this.log(line));
     }
 }

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;