@skrr-ai/cli 0.1.91 → 0.1.93

package/dist/commands/tasks/labels/suggest.js

@@ -31,11 +31,12 @@ class TasksLabelsSuggest extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksLabelsSuggest);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let response;
         try {
             // The URL lives in the lib — a command that builds its own `/api/...`
             // string is invisible to the CLI↔API parity check.
-            response = await (0, task_extras_1.taskLabelSuggestion)(args.id);
+            response = await (0, task_extras_1.taskLabelSuggestion)(taskRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -47,7 +48,7 @@ class TasksLabelsSuggest extends base_command_1.BaseCommand {
         const suggestions = (response?.suggestions ?? []).filter((s) => Boolean(s?.id && s?.name));
         const ref = response?.identifier ? ` (${response.identifier})` : '';
         if (suggestions.length === 0) {
-            this.log(`No label suggestions for task ${args.id}${ref} — ` +
+            this.log(`No label suggestions for task ${taskRef}${ref} — ` +
                 // The server counts the vocabulary AFTER excluding the labels this
                 // task already wears, so 0 means nothing left to propose, not that
                 // the registry is empty.
@@ -57,13 +58,13 @@ class TasksLabelsSuggest extends base_command_1.BaseCommand {
                 ' "No label" is a correct answer.');
             return;
         }
-        this.log(`Suggested labels for task ${args.id}${ref}:`);
+        this.log(`Suggested labels for task ${taskRef}${ref}:`);
         (0, format_1.renderTable)(suggestions.map((s) => ({ id: s.id, name: s.name })), [
             { key: 'id', header: 'ID' },
             { key: 'name', header: 'NAME' },
         ], (line) => this.log(line));
         this.log(`A suggestion is a proposal, not a write — attach with ` +
-            `\`skrr tasks labels attach ${args.id} --label <id>\` if one fits.`);
+            `\`skrr tasks labels attach ${taskRef} --label <id>\` if one fits.`);
     }
 }
 exports.default = TasksLabelsSuggest;

package/dist/commands/tasks/list.d.ts

@@ -1,6 +1,21 @@
 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>;
+/**
+ * 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
+ * caller is an agent (a session agent id in the environment) asking for machine
+ * output and has named no state filter of its own, default to open work and SAY
+ * so, as data (`filter_applied`) and not only in prose. `--all` is the opt-out;
+ * any filter the caller wrote leaves the default off, since they have decided.
+ * A person at a terminal is untouched.
+ */
+export declare function agentSessionOpenDefault(flags: ListFlags, env?: NodeJS.ProcessEnv): {
+    open: true;
+    reason: 'agent_session_default';
+    hint: string;
+} | undefined;
 /**
  * What the zero-row case is allowed to say. The bare `No tasks.` was step 3
  * of `GETTING_STARTED.md` and named no next step; a new user reading it hit
@@ -31,10 +46,21 @@ export declare function taskRef(t: Record<string, unknown>): string;
  * the command; this function is deliberately pure for reuse and parity tests.
  */
 export declare function buildListParams(flags: ListFlags, assigneeUserId?: string): TaskListParams;
+/**
+ * P4: `--status bogus` exits 0 with an empty list, and text mode explains why
+ * while `--json` said nothing, so an agent could not tell "no matches" from
+ * "invalid filter". Same facts, as data.
+ */
+export declare function statusFilterWarnings(flags: ListFlags, rowCount: number): ListWarning[];
 export default class TasksList extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        strict: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        calendar: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        fields: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        compact: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        ndjson: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         goal: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -75,7 +101,7 @@ export default class TasksList extends BaseCommand {
         view: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
         cursor: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        calendar: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        all: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/tasks/list.js

@@ -1,14 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentSessionOpenDefault = agentSessionOpenDefault;
 exports.emptyTasksMessage = emptyTasksMessage;
 exports.nextActionText = nextActionText;
 exports.taskRef = taskRef;
 exports.buildListParams = buildListParams;
+exports.statusFilterWarnings = statusFilterWarnings;
 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 format_1 = require("../../lib/format");
+const list_output_1 = require("../../lib/list-output");
 const tasks_1 = require("../../lib/tasks");
 /**
  * Names of `tasks list` flags that narrow the result set. Used to distinguish
@@ -53,6 +56,33 @@ const FILTER_FLAGS = new Set([
     'q',
     'view',
 ]);
+/**
+ * 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
+ * caller is an agent (a session agent id in the environment) asking for machine
+ * output and has named no state filter of its own, default to open work and SAY
+ * so, as data (`filter_applied`) and not only in prose. `--all` is the opt-out;
+ * any filter the caller wrote leaves the default off, since they have decided.
+ * A person at a terminal is untouched.
+ */
+function agentSessionOpenDefault(flags, env = process.env) {
+    const inAgentSession = Boolean(env.OVERSKY_SESSION_AGENT_ID?.trim() || env.OVERSKY_AGENT_ID?.trim());
+    if (!inAgentSession || flags.all || flags.calendar)
+        return undefined;
+    if (!flags.json && !flags.ndjson)
+        return undefined;
+    for (const name of FILTER_FLAGS) {
+        const value = flags[name];
+        if (Array.isArray(value) ? value.length > 0 : value !== undefined && value !== false) {
+            return undefined;
+        }
+    }
+    return {
+        open: true,
+        reason: 'agent_session_default',
+        hint: 'Closed tasks are hidden for agent sessions by default. Pass --all to include them, or --status / --status-type to choose.',
+    };
+}
 /**
  * What the zero-row case is allowed to say. The bare `No tasks.` was step 3
  * of `GETTING_STARTED.md` and named no next step; a new user reading it hit
@@ -239,11 +269,36 @@ function buildListParams(flags, assigneeUserId) {
             ? { labelIds: flag('label-id') }
             : {}),
         q: flag('q'),
+        // `--compact` asks the server for its own card projection (no activityLog,
+        // narrative or ledgers) so the bytes are never sent, then the CLI trims the
+        // rest to the navigation set. Only the JSON path reads it.
+        ...(flag('compact') && !flag('fields') ? { view: 'summary' } : {}),
         ...(flag('view') ? { taskViewId: flag('view') } : {}),
         limit: flag('limit'),
         cursor: flag('cursor'),
     };
 }
+/**
+ * P4: `--status bogus` exits 0 with an empty list, and text mode explains why
+ * while `--json` said nothing, so an agent could not tell "no matches" from
+ * "invalid filter". Same facts, as data.
+ */
+function statusFilterWarnings(flags, rowCount) {
+    if (rowCount > 0 || flags['execution-state'])
+        return [];
+    const builtin = data_provider_1.TASK_STATUSES;
+    return statusList(flags).map((value) => builtin.includes(value)
+        ? {
+            code: 'STATUS_FILTER_EMPTY',
+            value,
+            hint: `Nothing matched --status ${value}. A status is a workflow-state id the Space owns, so a board need not use this one; try --status-type or drop --status to see what the scope holds.`,
+        }
+        : {
+            code: 'STATUS_NOT_BUILTIN',
+            value,
+            hint: `"${value}" is not a built-in status id (${data_provider_1.TASK_STATUSES.join(', ')}). It only matches a Space that defines a state with exactly this id; otherwise use --status-type (${[...data_provider_1.TASK_WORKFLOW_TYPE_BANDS.open].join(', ')} ...) or --open.`,
+        });
+}
 class TasksList extends base_command_1.BaseCommand {
     static description = 'List tasks';
     static examples = [
@@ -267,6 +322,9 @@ 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 --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',
     ];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
@@ -393,6 +451,13 @@ class TasksList extends base_command_1.BaseCommand {
         }),
         limit: core_1.Flags.integer({ description: 'Max results', default: 50 }),
         cursor: core_1.Flags.string({ description: 'Pagination cursor from a previous page' }),
+        all: core_1.Flags.boolean({
+            description: 'Include closed tasks even inside an agent session (where --json defaults to open work and reports filter_applied)',
+        }),
+        ...list_output_1.listOutputFlags,
+        strict: core_1.Flags.boolean({
+            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.',
         }),
@@ -443,6 +508,9 @@ class TasksList extends base_command_1.BaseCommand {
         }
         flags.dri = driId;
         flags['dri-kind'] = driKind;
+        const filterApplied = agentSessionOpenDefault(flags);
+        if (filterApplied)
+            flags.open = true;
         let response;
         try {
             response = calendarRange
@@ -459,12 +527,27 @@ class TasksList extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
-        if (flags.json) {
+        const list = response;
+        const statusWarnings = calendarRange
+            ? []
+            : statusFilterWarnings(flags, Array.isArray(list?.data) ? list.data.length : 0);
+        if (flags.strict && statusWarnings.some((w) => w.code === 'STATUS_NOT_BUILTIN')) {
+            const bad = statusWarnings.find((w) => w.code === 'STATUS_NOT_BUILTIN');
+            this.failWithCliError({
+                message: bad.hint,
+                code: 'TASK_STATUS_FILTER_NO_MATCH',
+                exit: 2,
+                retryable: false,
+                details: {
+                    suggestion: 'Use --status-type or --open, or a state id from `spaces states list`.',
+                },
+            });
+        }
+        if (flags.json || flags.ndjson) {
             // The table renders REF and NEXT, but the raw payload names them
             // `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 list = response;
             const enriched = list && Array.isArray(list.data)
                 ? {
                     ...list,
@@ -475,7 +558,19 @@ class TasksList extends base_command_1.BaseCommand {
                     })),
                 }
                 : response;
-            this.log(JSON.stringify((0, web_url_1.withDataUrls)(this.cliConfig.baseURL, enriched, web_url_1.taskUrlFrom), null, 2));
+            const withUrls = (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
+                : (0, list_output_1.shapeListResponse)(withUrls, {
+                    resource: 'task',
+                    fields: flags.fields,
+                    compact: flags.compact,
+                    requestedLimit: flags.limit,
+                    warnings: statusWarnings,
+                    ...(filterApplied ? { filterApplied } : {}),
+                });
+            this.printList(out, Boolean(flags.ndjson));
             return;
         }
         if (calendarRange) {
@@ -543,6 +638,9 @@ class TasksList extends base_command_1.BaseCommand {
             this.log('');
             this.log(`Next page: --cursor ${r.next_cursor}`);
         }
+        const note = (0, list_output_1.limitNote)(flags.limit, items.length, Boolean(r?.has_more));
+        for (const line of (0, list_output_1.warningLines)(note.warning ? [note.warning] : []))
+            this.log(line);
     }
 }
 exports.default = TasksList;

package/dist/commands/tasks/move.js

@@ -76,6 +76,7 @@ class TasksMove extends base_command_1.BaseCommand {
                 details: { suggestion: failure.suggestion, context: failure.details },
             });
         }
+        const taskRef = await this.resolveEntityRef('task', taskIdentity.id);
         const projectId = (0, projects_1.resolveTaskProjectFlag)(flags.project);
         if (!flags.status && projectId === undefined) {
             this.failWithCliError({
@@ -113,7 +114,7 @@ class TasksMove extends base_command_1.BaseCommand {
                 }
                 else {
                     updated = await data_provider_1.dataService.moveTask({
-                        taskId: taskIdentity.id,
+                        taskId: taskRef,
                         status: flags.status,
                         reason: flags.reason,
                         resolutionActor: flags['resolution-actor'],
@@ -125,7 +126,7 @@ class TasksMove extends base_command_1.BaseCommand {
                 // Project membership is an ordinary task field — PATCH /tasks/:id.
                 // `--project none` sends `projectId: null`, which detaches.
                 updated = await data_provider_1.dataService.updateTask({
-                    taskId: taskIdentity.id,
+                    taskId: taskRef,
                     data: { projectId },
                 });
             }
@@ -154,7 +155,7 @@ class TasksMove extends base_command_1.BaseCommand {
         if (projectId !== undefined) {
             destinations.push(await this.describeProjectDestination(projectId, t));
         }
-        this.log(`Moved task ${t.id ?? t._id ?? taskIdentity.id}${ref ? ` (${ref})` : ''} → ${destinations.join(', ')}`);
+        this.log(`Moved task ${t.id ?? t._id ?? taskRef}${ref ? ` (${ref})` : ''} → ${destinations.join(', ')}`);
         /*
          * Closing is the actor's call — the server does not refuse outstanding
          * work, it records it on `resolution.closure`. If the close just written

package/dist/commands/tasks/output.js

@@ -52,27 +52,28 @@ class TasksOutput extends base_command_1.BaseCommand {
                 details: { suggestion: failure.suggestion },
             });
         }
+        const taskRef = await this.resolveEntityRef('task', identity.id);
         let task;
         try {
-            task = (await data_provider_1.dataService.getTask(identity.id, { enrich: false }));
+            task = (await data_provider_1.dataService.getTask(taskRef, { enrich: false }));
         }
         catch (error) {
             this.handleApiError(error);
         }
         const conversationId = task.conversationId ? String(task.conversationId) : null;
         const [resultBundle, resources, updates, latestRun, messages] = await Promise.all([
-            data_provider_1.dataService.listTaskResults(identity.id).catch(() => ({
+            data_provider_1.dataService.listTaskResults(taskRef).catch(() => ({
                 currentResultId: null,
                 currentSpecVersion: 1,
                 results: [],
                 reviews: [],
             })),
-            data_provider_1.dataService.listTaskResources(identity.id).catch(() => ({ data: [] })),
-            data_provider_1.dataService.listTaskUpdates(identity.id, { limit: 10 }).catch(() => ({
+            data_provider_1.dataService.listTaskResources(taskRef).catch(() => ({ data: [] })),
+            data_provider_1.dataService.listTaskUpdates(taskRef, { limit: 10 }).catch(() => ({
                 data: [],
                 nextCursor: null,
             })),
-            (0, task_transcript_1.fetchLatestRun)(identity.id).catch(() => null),
+            (0, task_transcript_1.fetchLatestRun)(taskRef).catch(() => null),
             conversationId
                 ? (0, task_transcript_1.fetchTranscript)(conversationId).catch(() => [])
                 : Promise.resolve([]),

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

@@ -19,9 +19,10 @@ class TasksPauseSchedule extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksPauseSchedule);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.pauseSchedule(args.id);
+            result = await data_provider_1.dataService.pauseSchedule(taskRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -32,7 +33,7 @@ class TasksPauseSchedule extends base_command_1.BaseCommand {
         }
         const t = result;
         const ref = t.identifier ?? (t.taskNumber ? `#${t.taskNumber}` : '');
-        this.log(`Paused schedule on task ${t.id ?? t._id ?? args.id}${ref ? ` (${ref})` : ''}`);
+        this.log(`Paused schedule on task ${t.id ?? t._id ?? taskRef}${ref ? ` (${ref})` : ''}`);
     }
 }
 exports.default = TasksPauseSchedule;

package/dist/commands/tasks/promote.js

@@ -54,6 +54,7 @@ class TasksPromote extends base_command_1.BaseCommand {
                 details: { suggestion: failure.suggestion, context: failure.details },
             });
         }
+        const taskRef = await this.resolveEntityRef('task', taskIdentity.id);
         const taskId = taskIdentity.id;
         // The route resolves the GROUP from the addressed run, then requires the
         // canonical run to be a member of it. Addressing by the canonical run

package/dist/commands/tasks/prompt-log.js

@@ -18,9 +18,10 @@ class TasksPromptLog extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksPromptLog);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.getTaskPromptLog(args.id);
+            result = await data_provider_1.dataService.getTaskPromptLog(taskRef);
         }
         catch (err) {
             this.handleApiError(err);

package/dist/commands/tasks/release.js

@@ -18,9 +18,10 @@ class TasksRelease extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksRelease);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.releaseTask(args.id);
+            result = await data_provider_1.dataService.releaseTask(taskRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -29,7 +30,7 @@ class TasksRelease extends base_command_1.BaseCommand {
             this.log(JSON.stringify(result, null, 2));
             return;
         }
-        this.log(`Released task ${args.id}`);
+        this.log(`Released task ${taskRef}`);
         // OSK-3816 — releasing frees the CHECKOUT; it does not change the STATUS.
         // A task left at `in_progress` is still unstartable ("This Task is marked in
         // progress and cannot start another Agent execution"), so an operator who
@@ -39,8 +40,8 @@ class TasksRelease extends base_command_1.BaseCommand {
         const status = result?.status;
         if (status === 'in_progress') {
             this.log(`Still marked in_progress — the checkout is free but the status blocks a new run.\n` +
-                `  Return it to the working set with: skrr tasks move ${args.id} --status todo\n` +
-                `  Or do both at once with:            skrr tasks retry ${args.id}`);
+                `  Return it to the working set with: skrr tasks move ${taskRef} --status todo\n` +
+                `  Or do both at once with:            skrr tasks retry ${taskRef}`);
         }
     }
 }

package/dist/commands/tasks/remind.js

@@ -24,6 +24,7 @@ class TasksRemind extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksRemind);
+        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.', {
@@ -33,7 +34,7 @@ class TasksRemind extends base_command_1.BaseCommand {
         let task;
         let reminder;
         try {
-            task = (await data_provider_1.dataService.getTask(args.taskId, { enrich: false }));
+            task = (await data_provider_1.dataService.getTask(taskRef, { enrich: false }));
             reminder = await data_provider_1.request.post('/api/triggers', {
                 scope: {
                     kind: 'entity_reminder',

package/dist/commands/tasks/replay.js

@@ -20,9 +20,10 @@ class TasksReplay extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksReplay);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.getTaskReplay(args.id, flags.run);
+            result = await data_provider_1.dataService.getTaskReplay(taskRef, flags.run);
         }
         catch (err) {
             const e = err;
@@ -30,7 +31,7 @@ class TasksReplay extends base_command_1.BaseCommand {
                 // Distinguish "task has no runs yet" from "task ID doesn't exist" —
                 // the server's generic 404 doesn't, but this surface lets a user
                 // running `skrr tasks replay <fresh-task>` know what to do next.
-                this.error(`No execution runs found for task ${args.id}. Start the task first with \`${this.config.bin} tasks start ${args.id}\`.`, { exit: 4 });
+                this.error(`No execution runs found for task ${taskRef}. Start the task first with \`${this.config.bin} tasks start ${taskRef}\`.`, { exit: 4 });
             }
             this.handleApiError(err);
         }

package/dist/commands/tasks/report.js

@@ -75,6 +75,7 @@ class TasksReport extends base_command_1.BaseCommand {
                 details: { suggestion: failure.suggestion, context: failure.details },
             });
         }
+        const taskRef = await this.resolveEntityRef('task', task.id);
         let report;
         try {
             report = (0, task_report_1.buildTaskReport)({

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

@@ -19,9 +19,10 @@ class TasksResumeSchedule extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksResumeSchedule);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.resumeSchedule(args.id);
+            result = await data_provider_1.dataService.resumeSchedule(taskRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -32,7 +33,7 @@ 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 ?? args.id}${ref ? ` (${ref})` : ''}`);
+        this.log(`Resumed schedule on task ${t.id ?? t._id ?? taskRef}${ref ? ` (${ref})` : ''}`);
     }
 }
 exports.default = TasksResumeSchedule;

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

@@ -22,10 +22,11 @@ class TasksRetrySchedule extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksRetrySchedule);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let result;
         try {
             result = await data_provider_1.dataService.retryScheduledTask({
-                taskId: args.id,
+                taskId: taskRef,
                 scheduledFor: flags.at,
             });
         }
@@ -39,7 +40,7 @@ class TasksRetrySchedule extends base_command_1.BaseCommand {
         const t = result;
         const ref = t.identifier ?? (t.taskNumber ? `#${t.taskNumber}` : '');
         const when = flags.at ?? t.scheduledFor ?? '(server default)';
-        this.log(`Re-armed schedule for task ${t.id ?? t._id ?? args.id}${ref ? ` (${ref})` : ''} → ${when}`);
+        this.log(`Re-armed schedule for task ${t.id ?? t._id ?? taskRef}${ref ? ` (${ref})` : ''} → ${when}`);
     }
 }
 exports.default = TasksRetrySchedule;

package/dist/commands/tasks/retry.js

@@ -68,41 +68,42 @@ class TasksRetry extends base_command_1.BaseCommand {
                 details: { suggestion: failure.suggestion, context: failure.details },
             });
         }
+        const taskRef = await this.resolveEntityRef('task', taskIdentity.id);
         // Step 1 — clear the terminal state. `todo` rather than `backlog`: the task
         // was already triaged into the working set once, and a retry is not a
         // decision to deprioritise it.
         try {
             await data_provider_1.dataService.moveTask({
-                taskId: taskIdentity.id,
+                taskId: taskRef,
                 status: 'todo',
             });
         }
         catch (err) {
-            this.handleApiError(err, { subject: `Task ${taskIdentity.id}` });
+            this.handleApiError(err, { subject: `Task ${taskRef}` });
         }
         if (flags['no-start']) {
             if (flags.json) {
-                this.log(JSON.stringify({ taskId: taskIdentity.id, status: 'todo', started: false }));
+                this.log(JSON.stringify({ taskId: taskRef, status: 'todo', started: false }));
                 return;
             }
-            this.log(`Cleared failed state on ${taskIdentity.id} — now todo, not started.`);
-            this.log(`Start it with: skrr tasks start ${taskIdentity.id}`);
+            this.log(`Cleared failed state on ${taskRef} — now todo, not started.`);
+            this.log(`Start it with: skrr tasks start ${taskRef}`);
             return;
         }
         let result;
         try {
-            result = await data_provider_1.dataService.startTask(taskIdentity.id, flags.skill ? { skillId: flags.skill } : undefined);
+            result = await data_provider_1.dataService.startTask(taskRef, flags.skill ? { skillId: flags.skill } : undefined);
         }
         catch (err) {
             this.handleApiError(err, {
-                subject: `Task ${taskIdentity.id} (failed state was cleared — it is now 'todo')`,
+                subject: `Task ${taskRef} (failed state was cleared — it is now 'todo')`,
             });
         }
         if (flags.json) {
-            this.log(JSON.stringify({ ...result, taskId: taskIdentity.id, status: 'todo', started: true }, null, 2));
+            this.log(JSON.stringify({ ...result, taskId: taskRef, status: 'todo', started: true }, null, 2));
             return;
         }
-        this.log(`Retried task ${taskIdentity.id}`);
+        this.log(`Retried task ${taskRef}`);
         this.log(`Conversation: ${result.conversationId}`);
         this.log(`Session:      ${result.sessionId}`);
     }

package/dist/commands/tasks/revisions.js

@@ -19,9 +19,10 @@ class TasksRevisions extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksRevisions);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.getTaskRevisions(args.id);
+            result = await data_provider_1.dataService.getTaskRevisions(taskRef);
         }
         catch (err) {
             this.handleApiError(err);

package/dist/commands/tasks/runs.js

@@ -157,9 +157,10 @@ class TasksRuns extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksRuns);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.getTaskRuns(args.id);
+            response = await data_provider_1.dataService.getTaskRuns(taskRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -178,8 +179,8 @@ class TasksRuns extends base_command_1.BaseCommand {
             // scripted caller still learns where the message actually lives.
             if (unexplained) {
                 this.warn('A failed run here carries `errors` but no `failureReason` — this server predates that ' +
-                    `field. Read it from \`${this.config.bin} tasks show ${args.id} --json\` (executionError) or ` +
-                    `\`${this.config.bin} tasks activity ${args.id} --json\` (details.error, keyed by runId).`);
+                    `field. Read it from \`${this.config.bin} tasks show ${taskRef} --json\` (executionError) or ` +
+                    `\`${this.config.bin} tasks activity ${taskRef} --json\` (details.error, keyed by runId).`);
             }
             this.log(JSON.stringify(response, null, 2));
             return;
@@ -217,7 +218,7 @@ class TasksRuns extends base_command_1.BaseCommand {
             return;
         let failures = new Map();
         try {
-            const activity = (await data_provider_1.dataService.getTaskActivity(args.id, 200));
+            const activity = (await data_provider_1.dataService.getTaskActivity(taskRef, 200));
             failures = (0, activity_1.runFailuresFromActivity)(activity?.data);
         }
         catch {
@@ -226,7 +227,7 @@ class TasksRuns extends base_command_1.BaseCommand {
             // block below then says "no reason recorded", which is true of what we
             // can see.
         }
-        for (const line of renderRunFailures(items, failures, this.config.bin, args.id)) {
+        for (const line of renderRunFailures(items, failures, this.config.bin, taskRef)) {
             this.log(line);
         }
     }

package/dist/commands/tasks/schedule.js

@@ -42,6 +42,7 @@ class TasksSchedule extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksSchedule);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let body = {};
         try {
             body = await (0, prompt_1.readJsonBody)(flags['from-json']);
@@ -67,7 +68,7 @@ class TasksSchedule extends base_command_1.BaseCommand {
         let result;
         try {
             result = await data_provider_1.dataService.scheduleTask({
-                taskId: args.id,
+                taskId: taskRef,
                 data: payload,
             });
         }
@@ -80,7 +81,7 @@ 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 ?? args.id}${ref ? ` (${ref})` : ''} for ${payload.scheduledFor}`);
+        this.log(`Scheduled task ${t.id ?? t._id ?? taskRef}${ref ? ` (${ref})` : ''} for ${payload.scheduledFor}`);
         if (t.recurrence?.pattern) {
             const tz = t.recurrence.timezone ? ` (${t.recurrence.timezone})` : '';
             this.log(`Recurrence: ${t.recurrence.pattern}${tz}`);