@skrr-ai/cli 0.1.128 → 0.1.130

package/dist/commands/store/artifacts/releases.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const format_1 = require("../../../lib/format");
+const list_output_1 = require("../../../lib/list-output");
+const store_artifact_releases_1 = require("../../../lib/store-artifact-releases");
+/**
+ * Your own publication history for one skill, newest first, with the admission
+ * state a curator left on each release. `store artifacts receipt` reads one
+ * release in full.
+ */
+class StoreArtifactsReleases extends base_command_1.BaseCommand {
+    static description = 'List the releases you published for your own skill, newest first, with each release’s admission state and review note';
+    static examples = [
+        '<%= config.bin %> store artifacts releases skill <skill-id>',
+        '<%= config.bin %> store artifacts releases skill <skill-id> --limit 50 --json',
+        '<%= config.bin %> store artifacts releases skill <skill-id> --before 7',
+    ];
+    static args = {
+        // The history route is served for skills only. An action release is read
+        // one at a time with `store artifacts receipt action <id> <releaseId>`.
+        entityType: core_1.Args.string({
+            required: true,
+            ignoreStdin: true,
+            options: ['skill'],
+            description: 'Only skills have a release history read; for an action use `receipt`',
+        }),
+        entityId: core_1.Args.string({ required: true, ignoreStdin: true, description: 'Skill id' }),
+    };
+    static flags = {
+        limit: core_1.Flags.integer({ description: 'How many releases (1-50)', min: 1, max: 50 }),
+        before: core_1.Flags.integer({
+            description: 'Only releases numbered below this one (the page cursor printed with a page)',
+            min: 1,
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StoreArtifactsReleases);
+        let history;
+        try {
+            history = await (0, store_artifact_releases_1.listSkillArtifactReleases)(args.entityId, {
+                limit: flags.limit,
+                before: flags.before,
+            });
+        }
+        catch (error) {
+            this.handleApiError(error);
+            return;
+        }
+        const releases = history?.data ?? [];
+        const nextBefore = history?.nextBefore ?? null;
+        if (flags.json) {
+            this.printJsonResult((0, list_output_1.listResult)({ data: releases, next_cursor: nextBefore === null ? null : String(nextBefore) }, 'data'));
+            return;
+        }
+        if (releases.length === 0) {
+            this.log('No releases published for this skill.');
+            return;
+        }
+        (0, format_1.renderTable)(releases.map((release) => ({
+            number: String(release.releaseNumber),
+            release: release.releaseId,
+            version: release.versionLabel ?? '-',
+            status: release.status ?? '-',
+            admission: release.admission?.state ?? '-',
+            note: release.admission?.review?.note ?? '-',
+            published: release.publishedAt ? String(release.publishedAt).slice(0, 10) : '-',
+        })), [
+            { key: 'number', header: '#' },
+            { key: 'release', header: 'RELEASE' },
+            { key: 'version', header: 'VERSION' },
+            { key: 'status', header: 'STATUS' },
+            { key: 'admission', header: 'ADMISSION' },
+            { key: 'note', header: 'REVIEW NOTE', maxWidth: 40 },
+            { key: 'published', header: 'PUBLISHED' },
+        ], (line) => this.log(line));
+        if (nextBefore !== null) {
+            this.log(`More: run again with --before ${nextBefore}`);
+        }
+    }
+}
+exports.default = StoreArtifactsReleases;

package/dist/commands/store/library.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * The Skill, Action and Service copies you bought, and whether each can still
+ * be used (the web Library page). `store installs` lists the Agent purchases;
+ * this is the other three kinds.
+ */
+export default class StoreLibrary extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/store/library.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const format_1 = require("../../lib/format");
+const store_library_1 = require("../../lib/store-library");
+const workspaces_1 = require("../../lib/workspaces");
+const KINDS = [
+    ['skill', 'skills'],
+    ['action', 'actions'],
+    ['service', 'services'],
+];
+/**
+ * The Skill, Action and Service copies you bought, and whether each can still
+ * be used (the web Library page). `store installs` lists the Agent purchases;
+ * this is the other three kinds.
+ */
+class StoreLibrary extends base_command_1.BaseCommand {
+    static description = 'List the Skill, Action and Service copies you bought from the Store and whether each is still usable (Agent purchases: `store installs`)';
+    static examples = [
+        '<%= config.bin %> store library',
+        '<%= config.bin %> store library --json',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(StoreLibrary);
+        const workspaceId = await (0, workspaces_1.ambientWorkspaceId)();
+        let library;
+        try {
+            library = await (0, store_library_1.getStoreLibraryItems)(workspaceId);
+        }
+        catch (error) {
+            this.handleApiError(error);
+            return;
+        }
+        if (flags.json) {
+            this.printJsonResult({ workspaceId: workspaceId ?? null, ...library });
+            return;
+        }
+        const rows = KINDS.flatMap(([kind, key]) => (library?.[key] ?? []).map((item) => ({
+            kind,
+            source: item.sourceId,
+            copy: item.copyId ?? '-',
+            name: item.name ?? '-',
+            // `copyAvailable` is the server's verdict; the states say why when it is false.
+            state: item.copyAvailable ? 'available' : 'unavailable',
+            reason: item.copyAvailable
+                ? '-'
+                : [item.entitlementState, item.fulfillmentState].filter(Boolean).join(' / ') ||
+                    'copy missing',
+        })));
+        if (rows.length === 0) {
+            this.log(workspaceId
+                ? `No Skill, Action or Service purchases found in workspace ${workspaceId}.`
+                : 'No Skill, Action or Service purchases found; select a workspace with --workspace to check another scope.');
+            return;
+        }
+        (0, format_1.renderTable)(rows, [
+            { key: 'kind', header: 'KIND' },
+            { key: 'source', header: 'SOURCE' },
+            { key: 'copy', header: 'YOUR COPY' },
+            { key: 'name', header: 'NAME', maxWidth: 32 },
+            { key: 'state', header: 'STATE' },
+            { key: 'reason', header: 'REASON', maxWidth: 36 },
+        ], (line) => this.log(line));
+    }
+}
+exports.default = StoreLibrary;

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

@@ -2,6 +2,40 @@ import type { TaskListParams } from '@skrr-ai/data-provider';
 import { BaseCommand } from '../../base-command';
 import { type ListWarning } from '../../lib/list-output';
 type ListFlags = Record<string, unknown>;
+/** Which workspace a list reads, and why (OSK-21284). */
+export type ListWorkspaceScope = {
+    source: 'all';
+} | {
+    source: 'default';
+    workspaceId: string;
+    workspaceName?: string;
+    workspaceCount: number;
+};
+/**
+ * A plain `tasks list` named no workspace, and the server answers that with a list across EVERY
+ * workspace the person belongs to. Its access filter has branches that belong to no single
+ * workspace, so no index can serve it in order: on production it timed out after about 6 s while
+ * the same list naming a workspace answered in about a second. `skrr workspaces list` already says
+ * an unselected session "resolves to your default workspace"; a list now reads it too.
+ *
+ *   --all-workspaces   the old, wider list, asked for by name (`workspaceScope=all`)
+ *   a selected workspace, `--workspace`, or `skrr workspaces use`   untouched: the choice stands
+ *   an autonomous Agent session   untouched: a workspace-less Agent session stays personal
+ *   `--space`, `--calendar`   untouched: a Space names its own scope
+ *
+ * Returns nothing when there is nothing to apply, and `source: 'default'` when the caller's
+ * default workspace should be used. `lookupDefault` is injected so the rule is tested without the
+ * network; a lookup that fails or finds no default changes nothing.
+ */
+export declare function resolveListWorkspace(flags: {
+    'all-workspaces'?: boolean;
+    space?: string;
+    calendar?: string;
+}, env: NodeJS.ProcessEnv, lookupDefault: () => Promise<{
+    id: string;
+    name?: string;
+    count: number;
+} | null>): Promise<ListWorkspaceScope | undefined>;
 /**
  * E12: inside an agent session an unfiltered `tasks list --json` returned the
  * first page of EVERYTHING, which in practice was cancelled test tasks. When the
@@ -51,6 +85,19 @@ export declare function nextColumnWidth(rows: Array<{
  * is the one name an agent scanning 43 keys does not guess (OSK-10692).
  */
 export declare function taskRef(t: Record<string, unknown>): string;
+/**
+ * A calendar row in `--json`: the Task it places, by the names `tasks show` resolves.
+ *
+ * The server's occurrence `id` is `<taskId>:<kind>:<instant>`, a key for the occurrence, and the
+ * list shaping every other `tasks list` row gets (`ref` and `url` read off the row itself, and
+ * `nextAction` off its actionability) turned it into an `id`, a `url` and a `ref` that named
+ * nothing: `tasks show` refused the first two and the third was "-" (OSK-21586, OSK-21587). So the
+ * row's `id`, `ref` and `url` are the Task's, and the occurrence key is `occurrenceId`. A missing
+ * answer is `null`, never a placeholder.
+ */
+export declare function calendarJsonRow(baseURL: string, row: Record<string, unknown>): Record<string, unknown>;
+/** The calendar response with its rows made addressable; everything else stays as the server sent it. */
+export declare function calendarJsonResponse(baseURL: string, response: unknown): unknown;
 /** Evidence about managed execution only; unmanaged work is outside this projection. */
 export declare function taskExecution(t: Record<string, unknown>): Record<string, unknown>;
 export declare function taskPageSummary(items: Array<Record<string, unknown>>, hasMore: boolean): {
@@ -123,6 +170,7 @@ export default class TasksList extends BaseCommand {
         'explicit-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         subscribed: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'include-snoozed': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'all-workspaces': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'external-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'external-key-prefix': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'description-format': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/tasks/list.js

@@ -1,11 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveListWorkspace = resolveListWorkspace;
 exports.agentSessionOpenDefault = agentSessionOpenDefault;
 exports.emptyTasksMessage = emptyTasksMessage;
 exports.externalKeyPrefixWarnings = externalKeyPrefixWarnings;
 exports.nextActionText = nextActionText;
 exports.nextColumnWidth = nextColumnWidth;
 exports.taskRef = taskRef;
+exports.calendarJsonRow = calendarJsonRow;
+exports.calendarJsonResponse = calendarJsonResponse;
 exports.taskExecution = taskExecution;
 exports.taskPageSummary = taskPageSummary;
 exports.taskExecutionText = taskExecutionText;
@@ -18,7 +21,9 @@ const web_url_1 = require("../../lib/web-url");
 const format_1 = require("../../lib/format");
 const list_output_1 = require("../../lib/list-output");
 const tasks_1 = require("../../lib/tasks");
+const workspaces_1 = require("../../lib/workspaces");
 const task_economics_1 = require("../../lib/task-economics");
+const task_calendar_1 = require("../../lib/task-calendar");
 /**
  * Names of `tasks list` flags that narrow the result set. Used to distinguish
  * "no tasks anywhere" from "no tasks matching your filters" — the first case
@@ -63,6 +68,55 @@ const FILTER_FLAGS = new Set([
     'q',
     'view',
 ]);
+/**
+ * A plain `tasks list` named no workspace, and the server answers that with a list across EVERY
+ * workspace the person belongs to. Its access filter has branches that belong to no single
+ * workspace, so no index can serve it in order: on production it timed out after about 6 s while
+ * the same list naming a workspace answered in about a second. `skrr workspaces list` already says
+ * an unselected session "resolves to your default workspace"; a list now reads it too.
+ *
+ *   --all-workspaces   the old, wider list, asked for by name (`workspaceScope=all`)
+ *   a selected workspace, `--workspace`, or `skrr workspaces use`   untouched: the choice stands
+ *   an autonomous Agent session   untouched: a workspace-less Agent session stays personal
+ *   `--space`, `--calendar`   untouched: a Space names its own scope
+ *
+ * Returns nothing when there is nothing to apply, and `source: 'default'` when the caller's
+ * default workspace should be used. `lookupDefault` is injected so the rule is tested without the
+ * network; a lookup that fails or finds no default changes nothing.
+ */
+async function resolveListWorkspace(flags, env, lookupDefault) {
+    if (flags['all-workspaces'])
+        return { source: 'all' };
+    if (env.OVERSKY_WORKSPACE_ID?.trim())
+        return undefined;
+    if (env.OVERSKY_AUTONOMOUS_SESSION === '1')
+        return undefined;
+    if (flags.space || flags.calendar)
+        return undefined;
+    let found = null;
+    try {
+        found = await lookupDefault();
+    }
+    catch {
+        return undefined;
+    }
+    if (!found?.id)
+        return undefined;
+    return {
+        source: 'default',
+        workspaceId: found.id,
+        ...(found.name ? { workspaceName: found.name } : {}),
+        workspaceCount: found.count,
+    };
+}
+/** The default workspace the signed-in person's `skrr workspaces list` reports. */
+async function lookupDefaultWorkspace() {
+    const listing = await (0, workspaces_1.listWorkspaceListing)();
+    if (!listing.defaultWorkspaceId)
+        return null;
+    const row = listing.rows.find((entry) => entry.id === listing.defaultWorkspaceId);
+    return { id: listing.defaultWorkspaceId, ...(row?.name ? { name: row.name } : {}), count: listing.rows.length };
+}
 /**
  * E12: inside an agent session an unfiltered `tasks list --json` returned the
  * first page of EVERYTHING, which in practice was cancelled test tasks. When the
@@ -234,6 +288,43 @@ function nextColumnWidth(rows) {
 function taskRef(t) {
     return String(t.identifier ?? (t.taskNumber ? `#${t.taskNumber}` : '-'));
 }
+/**
+ * A calendar row in `--json`: the Task it places, by the names `tasks show` resolves.
+ *
+ * The server's occurrence `id` is `<taskId>:<kind>:<instant>`, a key for the occurrence, and the
+ * list shaping every other `tasks list` row gets (`ref` and `url` read off the row itself, and
+ * `nextAction` off its actionability) turned it into an `id`, a `url` and a `ref` that named
+ * nothing: `tasks show` refused the first two and the third was "-" (OSK-21586, OSK-21587). So the
+ * row's `id`, `ref` and `url` are the Task's, and the occurrence key is `occurrenceId`. A missing
+ * answer is `null`, never a placeholder.
+ */
+function calendarJsonRow(baseURL, row) {
+    const task = (row.task ?? {});
+    const taskId = (row.taskId ?? task.id);
+    const next = nextActionText(task);
+    return {
+        ...row,
+        id: taskId ?? row.id,
+        occurrenceId: row.id,
+        ref: task.identifier ?? null,
+        nextAction: next === '-' ? null : next,
+        url: taskId ? (0, web_url_1.taskUrlFrom)(baseURL, { id: taskId, spaceId: task.spaceId }) : null,
+    };
+}
+/** The calendar response with its rows made addressable; everything else stays as the server sent it. */
+function calendarJsonResponse(baseURL, response) {
+    if (!response || typeof response !== 'object')
+        return response;
+    const calendar = response;
+    if (!Array.isArray(calendar.data))
+        return response;
+    return {
+        ...calendar,
+        data: calendar.data.map((row) => row && typeof row === 'object'
+            ? calendarJsonRow(baseURL, row)
+            : row),
+    };
+}
 /** Evidence about managed execution only; unmanaged work is outside this projection. */
 function taskExecution(t) {
     const actionability = t.actionability;
@@ -351,6 +442,7 @@ function buildListParams(flags, assigneeUserId) {
         ...(flag('explicit-only') ? { explicitOnly: true } : {}),
         ...(flag('subscribed') ? { subscribed: true } : {}),
         ...(flag('include-snoozed') ? { includeSnoozed: true } : {}),
+        ...(flag('all-workspaces') ? { workspaceScope: 'all' } : {}),
         ...(flag('external-key')
             ? { externalKey: flag('external-key') }
             : {}),
@@ -430,6 +522,7 @@ class TasksList extends base_command_1.BaseCommand {
         '<%= config.bin %> tasks list --dri me',
         '<%= config.bin %> tasks list --view <task-view-id>',
         '<%= config.bin %> tasks list --calendar 2026-08-01..2026-08-31 --json',
+        '<%= config.bin %> tasks list --calendar 2026-12-06T16:00:00Z..2026-12-07T15:59:59Z',
         '<%= config.bin %> tasks list --open --compact --json',
         '<%= config.bin %> tasks list --space <space-id> --fields id,ref,title,status --json',
         '<%= config.bin %> tasks list --open --ndjson | jq -r .ref',
@@ -543,6 +636,10 @@ class TasksList extends base_command_1.BaseCommand {
         'include-snoozed': core_1.Flags.boolean({
             description: 'Include tasks you have personally snoozed (hidden by default)',
         }),
+        'all-workspaces': core_1.Flags.boolean({
+            description: 'List across every workspace you belong to. Without it, a list with no workspace selected ' +
+                'reads your default workspace; a list across all of them is slow and may time out.',
+        }),
         'external-key': core_1.Flags.string({ description: 'Filter by external key' }),
         'external-key-prefix': core_1.Flags.string({
             description: 'Filter to tasks whose external key starts with this literal prefix, e.g. every task of one tree written under --external-key-prefix. Combine with --space; see also `tasks create-tree --verify`.',
@@ -581,7 +678,11 @@ class TasksList extends base_command_1.BaseCommand {
             description: 'Exit 2 when --status names a value that is not a built-in state id and matches nothing (instead of an empty success).',
         }),
         calendar: core_1.Flags.string({
-            description: 'Expand the human task calendar for an inclusive range (YYYY-MM-DD..YYYY-MM-DD or ISO instants). Includes due dates and agent schedule occurrences.',
+            description: 'Expand the human task calendar for an inclusive range, <from>..<to>, at most 93 days. ' +
+                'A date-only value (YYYY-MM-DD) is a whole UTC day, 00:00:00.000Z to 23:59:59.999Z, not your local day: ' +
+                'for a local day pass ISO instants, e.g. 2026-12-06T16:00:00Z..2026-12-07T15:59:59Z. ' +
+                'Rows print in UTC, and the human output names the resolved window. ' +
+                'Includes due dates and agent schedule occurrences; a result cut short by a limit says which limit.',
         }),
     };
     async run() {
@@ -633,6 +734,16 @@ class TasksList extends base_command_1.BaseCommand {
         const filterApplied = agentSessionOpenDefault(flags);
         if (filterApplied)
             flags.open = true;
+        // Which workspace this list reads. A default is applied the way `--workspace` is: the
+        // request header follows OVERSKY_WORKSPACE_ID, set for this process only.
+        const workspaceScope = await resolveListWorkspace(flags, process.env, lookupDefaultWorkspace);
+        if (workspaceScope?.source === 'default') {
+            process.env.OVERSKY_WORKSPACE_ID = workspaceScope.workspaceId;
+            if (!flags.json && !flags.ndjson && workspaceScope.workspaceCount > 1) {
+                this.logToStderr(`Workspace: ${workspaceScope.workspaceName ? `"${workspaceScope.workspaceName}"` : workspaceScope.workspaceId} ` +
+                    `(your default). Every workspace you belong to: ${this.config.bin} tasks list --all-workspaces`);
+            }
+        }
         let response;
         try {
             response = calendarRange
@@ -687,19 +798,24 @@ class TasksList extends base_command_1.BaseCommand {
             // `identifier` and `actionability` — under `--json` an agent scanning 43
             // keys could not find either (OSK-10692). Alias them to the names the
             // table prints so the machine view answers the same questions.
-            const enriched = list && Array.isArray(list.data)
+            const enriched = list && Array.isArray(list.data) && !calendarRange
                 ? {
                     ...list,
-                    ...(!calendarRange ? { summary: taskPageSummary(list.data, Boolean(list.has_more ?? list.next_cursor)) } : {}),
+                    summary: taskPageSummary(list.data, Boolean(list.has_more ?? list.next_cursor)),
                     data: list.data.map((t) => ({
                         ...t,
                         ref: taskRef(t),
                         nextAction: nextActionText(t),
-                        ...(!calendarRange ? { execution: taskExecution(t) } : {}),
+                        execution: taskExecution(t),
                     })),
                 }
                 : response;
-            const withUrls = (0, web_url_1.withDataUrls)(this.cliConfig.baseURL, enriched, web_url_1.taskUrlFrom);
+            // A calendar row is an occurrence, not a Task: it gets the Task's id, ref and url and the
+            // occurrence key as `occurrenceId`, instead of the Task list's treatment, which rebuilt the
+            // url and the ref from the occurrence's own id (OSK-21586).
+            const withUrls = calendarRange
+                ? calendarJsonResponse(this.cliConfig.baseURL, response)
+                : (0, web_url_1.withDataUrls)(this.cliConfig.baseURL, enriched, web_url_1.taskUrlFrom);
             // The calendar response is occurrences, not tasks: leave its shape alone.
             const out = calendarRange
                 ? withUrls
@@ -723,14 +839,27 @@ class TasksList extends base_command_1.BaseCommand {
                         }
                         : {}),
                 });
-            this.printList(out, Boolean(flags.ndjson));
+            // Say which workspace was read, as data, when the CLI chose it (or the caller asked for all):
+            // an agent reading JSON cannot see the stderr note.
+            this.printList(workspaceScope && out && typeof out === 'object' && !Array.isArray(out)
+                ? { ...out, workspace_scope: workspaceScope }
+                : out, Boolean(flags.ndjson));
             return;
         }
         if (calendarRange) {
             const calendar = response;
             const occurrences = calendar.data ?? [];
+            const notices = (0, task_calendar_1.calendarNoticeLines)(calendar);
+            // The resolved window goes to stderr: it is about the read, not a row, so a piped table
+            // stays a table. A date-only range is a whole UTC day (OSK-21529).
+            this.logToStderr((0, task_calendar_1.calendarWindowLine)(calendar));
             if (occurrences.length === 0) {
-                this.log('No calendar occurrences.');
+                // "No calendar occurrences." is only true of a complete read (OSK-21382).
+                this.log(notices.length === 0
+                    ? 'No calendar occurrences.'
+                    : 'No calendar occurrences were listed, but the read was cut short.');
+                for (const line of notices)
+                    this.log(line);
                 return;
             }
             (0, format_1.renderTable)(occurrences.map((item) => ({
@@ -746,8 +875,11 @@ class TasksList extends base_command_1.BaseCommand {
                 { key: 'title', header: 'TITLE', maxWidth: 50 },
                 { key: 'status', header: 'STATUS' },
             ], (line) => this.log(line));
-            if (calendar.truncated)
-                this.log('\nNote: calendar occurrence expansion reached its safety cap.');
+            if (notices.length > 0) {
+                this.log('');
+                for (const line of notices)
+                    this.log(line);
+            }
             return;
         }
         const r = response;

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/remind.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
+const iso_instant_1 = require("../../lib/iso-instant");
+const task_reminder_1 = require("../../lib/task-reminder");
 /** Set a one-time human reminder without changing the task's visibility or state. */
 class TasksRemind extends base_command_1.BaseCommand {
     static description = 'Set a one-time inbox reminder on a task. The task stays visible and unchanged.';
@@ -18,24 +20,27 @@ class TasksRemind extends base_command_1.BaseCommand {
         }),
     };
     static flags = {
-        at: core_1.Flags.string({ description: 'Reminder time as an ISO-8601 UTC instant', required: true }),
+        at: core_1.Flags.string({
+            description: 'Reminder time as an ISO-8601 UTC instant ending in Z (e.g. 2026-08-25T16:00:00Z); a time with no Z or a numeric offset such as +08:00 is refused',
+            required: true,
+        }),
         json: core_1.Flags.boolean({ description: 'Output the TriggerDefinition as JSON' }),
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksRemind);
+        // Before any lookup: a bad time costs no round trip and creates nothing. Never `new Date(flags.at)`,
+        // which reads a zoneless time in THIS machine's zone and rolls 2027-02-30 into March (OSK-21504/21506).
+        const parsed = (0, iso_instant_1.parseUtcInstant)(flags.at, '--at');
+        if (!parsed.ok)
+            this.error(parsed.message, { exit: 2 });
+        const at = parsed.date;
         const taskRef = await this.resolveEntityRef('task', args.taskId);
-        const at = new Date(flags.at);
-        if (Number.isNaN(at.getTime()) || !/^\d{4}-\d{2}-\d{2}T/.test(flags.at)) {
-            this.error('--at must be an ISO-8601 instant, for example 2026-08-25T16:00:00Z.', {
-                exit: 2,
-            });
-        }
         let task;
         let reminder;
         try {
             task = (await data_provider_1.dataService.getTask(taskRef, { enrich: false }));
-            reminder = await data_provider_1.request.post('/api/triggers', {
+            reminder = (await data_provider_1.request.post('/api/triggers', {
                 scope: {
                     kind: 'entity_reminder',
                     refs: {
@@ -47,8 +52,8 @@ class TasksRemind extends base_command_1.BaseCommand {
                 kind: 'once',
                 label: `Reminder: ${task.title || task.identifier || task.id}`.slice(0, 120),
                 execution: { mode: 'notify_user', promptTemplate: '' },
-                once: { runAt: at.toISOString() },
-            });
+                once: { runAt: parsed.iso },
+            }));
         }
         catch (err) {
             this.handleApiError(err);
@@ -58,7 +63,14 @@ class TasksRemind extends base_command_1.BaseCommand {
             this.log(JSON.stringify(reminder, null, 2));
             return;
         }
-        this.log(`Reminder set for ${task.title || task.identifier || task.id} at ${at.toLocaleString()}.`);
+        for (const line of (0, task_reminder_1.reminderReceiptLines)({
+            title: task.title || task.identifier || task.id,
+            trigger: reminder,
+            requested: at,
+            bin: this.config.bin,
+        })) {
+            this.log(line);
+        }
     }
 }
 exports.default = TasksRemind;

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

@@ -5,10 +5,12 @@ 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 TasksRetrySchedule extends base_command_1.BaseCommand {
-    static description = 'Re-arm a stale/failed schedule. Optionally pin a new first-fire time';
+    static description = 'Re-arm a stale/failed schedule. After a failed or skipped start, pass --at with a new first-fire time: ' +
+        'the failed fire cleared the scheduledFor, so there is nothing left to retry against. ' +
+        'The Task must have an assigned agent, as the start will fail the same way otherwise.';
     static examples = [
-        '<%= config.bin %> tasks retry-schedule <task-id>',
         '<%= config.bin %> tasks retry-schedule <task-id> --at 2026-06-01T15:30:00Z',
+        '<%= config.bin %> tasks retry-schedule <task-id>',
     ];
     static args = {
         id: core_1.Args.string({ description: 'Task ID', required: true, ignoreStdin: true }),
@@ -16,7 +18,8 @@ class TasksRetrySchedule extends base_command_1.BaseCommand {
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
         at: core_1.Flags.string({
-            description: 'Optional new first-fire time as ISO-8601 UTC. Omit to retry against the current scheduledFor.',
+            description: 'New first-fire time as ISO-8601 UTC. Required after a failed or skipped start (the failed fire cleared scheduledFor). ' +
+                'Omit it only to re-sync a schedule whose scheduledFor is still in the future.',
         }),
     };
     async run() {