@skrr-ai/cli 0.1.92 → 0.1.93

package/dist/commands/store/stats.js

@@ -0,0 +1,258 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.funnelLines = funnelLines;
+exports.adoptionLines = adoptionLines;
+exports.outcomesLines = outcomesLines;
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const agent_ref_1 = require("../../lib/agent-ref");
+const format_1 = require("../../lib/format");
+const store_listing_1 = require("../../lib/store-listing");
+const SECTIONS = ['funnel', 'adoption', 'outcomes'];
+async function settle(read) {
+    try {
+        return { ok: true, value: await read() };
+    }
+    catch (error) {
+        return { ok: false, error };
+    }
+}
+function errorMessage(error) {
+    return error?.message || 'unavailable';
+}
+/**
+ * The publisher's readouts for one of their own Store agents: how buyers move
+ * through the install funnel, which releases their copies are on, and how each
+ * release turns out in use.
+ *
+ * Every figure is k-anonymous and publisher-only (the author, or an owner/admin
+ * of the organisation the listing is published as) — the same readouts the web
+ * shows, under the same terms (I2): the seller side's own copies are excluded, a readout covering fewer buyers than its floor returns NO figures,
+ * and small rows are withheld. This command prints a withheld readout as
+ * withheld, with the floor it missed. It never prints 0 for one, because zero
+ * is a claim the server did not make.
+ *
+ * There is no `--since`. Each window is fixed by the server — a caller-chosen
+ * length would let `days=N` minus `days=N-1` isolate a single buyer — so the
+ * window a readout covers is printed with it instead.
+ */
+class StoreStats extends base_command_1.BaseCommand {
+    static description = 'Publisher analytics for your store agent: install funnel, release adoption and release outcomes (k-anonymous; small cohorts withheld)';
+    static examples = [
+        '<%= config.bin %> store stats agent_abc123',
+        '<%= config.bin %> store stats agent_abc123 --only funnel',
+        '<%= config.bin %> store stats agent_abc123 --json',
+    ];
+    static args = {
+        agent: core_1.Args.string({
+            description: 'Your published store agent: its id or a link to it',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the three readouts as JSON' }),
+        only: core_1.Flags.string({
+            description: 'Read one readout instead of all three',
+            options: [...SECTIONS],
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StoreStats);
+        let agentId;
+        try {
+            ({ agentId } = await (0, agent_ref_1.resolveAgentRef)(args.agent, { baseURL: this.cliConfig?.baseURL }));
+        }
+        catch (err) {
+            if (err instanceof agent_ref_1.AgentRefError) {
+                this.failWithCliError({ message: err.message, code: err.code, exit: 1, retryable: false });
+            }
+            // Resolving a share code reads the server; its failure is an API failure.
+            this.handleApiError(err);
+        }
+        const wanted = (section) => !flags.only || flags.only === section;
+        const skipped = { ok: false, error: null };
+        const [funnel, adoption, outcomes] = await Promise.all([
+            wanted('funnel')
+                ? settle(() => data_provider_1.dataService.getStoreAgentInstallFunnelSummary({ agentId }))
+                : skipped,
+            wanted('adoption')
+                ? settle(() => data_provider_1.dataService.getStoreAgentReleaseAdoptionSummary(agentId))
+                : skipped,
+            wanted('outcomes')
+                ? settle(() => data_provider_1.dataService.getStoreAgentReleaseOutcomes({ agentId }))
+                : skipped,
+        ]);
+        // Every requested readout failed: that is one answer (not yours, not
+        // found, signed out), and the shared error handler words it.
+        const attempted = [funnel, adoption, outcomes].filter((r) => r.ok || r.error !== null);
+        if (attempted.length > 0 && attempted.every((r) => !r.ok)) {
+            this.handleApiError(attempted[0].error, {
+                subject: `store agent ${agentId}`,
+            });
+        }
+        if (flags.json) {
+            const shape = (r) => r.ok ? r.value : r.error === null ? undefined : { error: errorMessage(r.error) };
+            this.log(JSON.stringify({
+                agentId,
+                funnel: shape(funnel),
+                adoption: shape(adoption),
+                outcomes: shape(outcomes),
+            }, null, 2));
+            return;
+        }
+        const blocks = [];
+        if (wanted('funnel')) {
+            blocks.push(funnel.ok
+                ? funnelLines(funnel.value.summary)
+                : ['Install funnel', `  unavailable (${errorMessage(funnel.error)})`]);
+        }
+        if (wanted('adoption')) {
+            blocks.push(adoption.ok
+                ? adoptionLines(adoption.value.summary)
+                : ['Release adoption', `  unavailable (${errorMessage(adoption.error)})`]);
+        }
+        if (wanted('outcomes')) {
+            blocks.push(outcomes.ok
+                ? outcomesLines(outcomes.value.outcomes)
+                : ['Release outcomes', `  unavailable (${errorMessage(outcomes.error)})`]);
+        }
+        blocks.forEach((lines, index) => {
+            if (index > 0)
+                this.log('');
+            for (const line of lines)
+                this.log(line);
+        });
+    }
+}
+exports.default = StoreStats;
+function table(rows, columns) {
+    const out = [];
+    (0, format_1.renderTable)(rows, columns, (line) => out.push(`  ${line}`));
+    return out;
+}
+function funnelLines(summary) {
+    const lines = [`Install funnel — ${(0, store_listing_1.funnelWindowLine)(summary)}`];
+    const testEvents = summary.excluded?.publisherTestEvents;
+    if (summary.suppressed) {
+        lines.push(`  ${(0, store_listing_1.withheldLine)(summary.minimumCohort, 'buyers')}`);
+    }
+    else {
+        lines.push(...table(summary.funnel.map((step) => ({
+            step: step.label,
+            sessions: String(step.sessions),
+            events: String(step.events),
+            fromPlan: (0, store_listing_1.formatRate)(step.conversionFromPlan),
+            fromPrevious: (0, store_listing_1.formatRate)(step.conversionFromPrevious),
+        })), [
+            { key: 'step', header: 'STEP', maxWidth: 32 },
+            { key: 'sessions', header: 'SESSIONS' },
+            { key: 'events', header: 'EVENTS' },
+            { key: 'fromPlan', header: 'FROM PLAN' },
+            { key: 'fromPrevious', header: 'FROM PREV' },
+        ]));
+        const h = summary.health;
+        lines.push(...(0, store_listing_1.labelledLines)([
+            ['Buyer sessions', String(summary.sessionCount)],
+            [
+                'Installs',
+                `${h.installCompletions} of ${h.installStarts} started (${(0, store_listing_1.formatRate)(h.installCompletionRate)})`,
+            ],
+            [
+                'Activations',
+                `${h.activationCompletions} (${(0, store_listing_1.formatRate)(h.activationCompletionRate)} of installs)`,
+            ],
+            ['Failed sessions', String(h.failedSessions)],
+        ]));
+        if (summary.truncated) {
+            lines.push('  More events than one readout reads; figures cover the first part of the window.');
+        }
+        const cells = (0, store_listing_1.suppressedCellsLine)(summary.suppressedCells, summary.minimumCohort, 'buyers');
+        if (cells)
+            lines.push(`  ${cells}`);
+    }
+    if (typeof testEvents === 'number' && testEvents > 0) {
+        lines.push(`  Not counted: ${testEvents} event(s) from your own test installs.`);
+    }
+    return lines;
+}
+function adoptionLines(summary) {
+    const lines = [`Release adoption — ${(0, store_listing_1.adoptionWindowLine)(summary)}`];
+    if (summary.suppressed) {
+        lines.push(`  ${(0, store_listing_1.withheldLine)(summary.minimumCohort, 'buyers')}`);
+        return lines;
+    }
+    if (summary.versions.length === 0) {
+        lines.push('  No version row reaches the floor.');
+    }
+    else {
+        lines.push(...table(summary.versions.map((v) => ({
+            version: v.releaseId
+                ? `${v.versionLabel ? `v${v.versionLabel}` : '(no label)'}${v.latest ? ' (latest)' : ''}`
+                : 'no recorded release',
+            release: v.releaseNumber === null ? '-' : String(v.releaseNumber),
+            installs: String(v.installs),
+        })), [
+            { key: 'version', header: 'VERSION' },
+            { key: 'release', header: 'RELEASE #' },
+            { key: 'installs', header: 'COPIES' },
+        ]));
+    }
+    if (summary.conflictFields.length > 0) {
+        lines.push('  Fields where buyers’ edits conflict with an update:');
+        lines.push(...table(summary.conflictFields.map((f) => ({ field: f.field, installs: String(f.installs) })), [
+            { key: 'field', header: 'FIELD' },
+            { key: 'installs', header: 'COPIES' },
+        ]));
+    }
+    const cells = (0, store_listing_1.suppressedCellsLine)(summary.suppressedCells, summary.minimumCohort, 'buyers');
+    if (cells)
+        lines.push(`  ${cells}`);
+    return lines;
+}
+function outcomesLines(outcomes) {
+    const lines = [`Release outcomes — ${(0, store_listing_1.outcomesWindowLine)(outcomes)}`];
+    if (outcomes.suppressed) {
+        lines.push(`  ${(0, store_listing_1.withheldLine)(outcomes.minimumCohort, 'buyer cohorts')}`);
+        return lines;
+    }
+    lines.push(`  ${outcomes.cohortCount} buyer cohort(s).`);
+    if (outcomes.releases.length === 0) {
+        lines.push('  No release row reaches the floor.');
+    }
+    else {
+        lines.push(...table(outcomes.releases.map((r) => ({
+            version: r.versionLabel ? `v${r.versionLabel}` : r.releaseId,
+            runs: String(r.runs.total),
+            success: (0, store_listing_1.formatRate)(r.runs.successRate),
+            closes: String(r.taskCloses.closed),
+            clean: (0, store_listing_1.formatRate)(r.taskCloses.cleanRate),
+            reviews: `${r.buyerTestimony.reviewsAccepted} accepted / ${r.buyerTestimony.reviewsChangesRequested} changes`,
+        })), [
+            { key: 'version', header: 'VERSION' },
+            { key: 'runs', header: 'RUNS' },
+            { key: 'success', header: 'SUCCEEDED' },
+            { key: 'closes', header: 'TASKS CLOSED' },
+            { key: 'clean', header: 'CLEAN' },
+            { key: 'reviews', header: 'BUYER REVIEWS' },
+        ]));
+    }
+    // What each column rests on: runs and closes are recorded by the platform,
+    // reviews are what buyers said.
+    lines.push('  Runs and task closes are platform-recorded; reviews are buyer testimony.');
+    const cells = (0, store_listing_1.suppressedCellsLine)(outcomes.suppressedCells, outcomes.minimumCohort, 'buyer cohorts');
+    if (cells)
+        lines.push(`  ${cells}`);
+    const ex = outcomes.excluded;
+    lines.push(...(0, store_listing_1.labelledLines)([
+        ['Left out: modified copies', (0, store_listing_1.exclusionValue)(ex.modifiedCopyRuns)],
+        ['Left out: self-assessed closes', (0, store_listing_1.exclusionValue)(ex.selfAssessedCloses)],
+        [
+            'Left out: agent reviews/assessments',
+            `${(0, store_listing_1.exclusionValue)(ex.agentReviews)} / ${(0, store_listing_1.exclusionValue)(ex.agentAssessments)}`,
+        ],
+    ]));
+    return lines;
+}

package/dist/commands/tasks/actions/attach.js

@@ -129,7 +129,7 @@ class TasksActionsAttach extends base_command_1.BaseCommand {
                 this.exit(1);
             return;
         }
-        const singleTaskId = taskId;
+        const singleTaskId = await this.resolveEntityRef('task', taskId);
         let current;
         try {
             current = await data_provider_1.dataService.getTask(singleTaskId, { enrich: false });

package/dist/commands/tasks/actions/detach.js

@@ -89,9 +89,10 @@ class TasksActionsDetach extends base_command_1.BaseCommand {
                 this.exit(1);
             return;
         }
+        const taskRef = await this.resolveEntityRef('task', taskId);
         let current;
         try {
-            current = await data_provider_1.dataService.getTask(taskId, { enrich: false });
+            current = await data_provider_1.dataService.getTask(taskRef, { enrich: false });
         }
         catch (err) {
             this.handleApiError(err);
@@ -109,7 +110,7 @@ class TasksActionsDetach extends base_command_1.BaseCommand {
         let updated;
         try {
             updated = await data_provider_1.dataService.updateTask({
-                taskId: taskId,
+                taskId: taskRef,
                 data: { attachedActionRefs: remaining },
             });
         }
@@ -120,7 +121,7 @@ class TasksActionsDetach extends base_command_1.BaseCommand {
             this.log(JSON.stringify(updated, null, 2));
             return;
         }
-        this.log(`Detached ${existing.length - remaining.length} action(s) from task ${taskId}.`);
+        this.log(`Detached ${existing.length - remaining.length} action(s) from task ${taskRef}.`);
         this.log(remaining.length
             ? `Still attached: ${remaining.map(refKey).join(', ')}`
             : 'No actions attached.');

package/dist/commands/tasks/activity.js

@@ -88,9 +88,10 @@ class TasksActivity extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksActivity);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.listTaskActivityEvents(args.id, { limit: flags.limit });
+            response = await data_provider_1.dataService.listTaskActivityEvents(taskRef, { limit: flags.limit });
         }
         catch (err) {
             this.handleApiError(err);
@@ -105,7 +106,7 @@ class TasksActivity extends base_command_1.BaseCommand {
             // "No activity." was a claim about the TASK. It is only ever a claim about
             // this VIEW: a Task predating the canonical model has its history in the
             // legacy activity log, which this endpoint does not read.
-            this.log(await (0, task_legacy_1.emptyCanonicalView)(args.id, 'Activity'));
+            this.log(await (0, task_legacy_1.emptyCanonicalView)(taskRef, 'Activity'));
             return;
         }
         (0, format_1.renderTable)(items.map(activityRow), [

package/dist/commands/tasks/ancestors.js

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

package/dist/commands/tasks/approvals/create.js

@@ -32,6 +32,7 @@ class TasksApprovalsCreate extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksApprovalsCreate);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         const data = { type: flags.type };
         if (flags['approver-agent'])
             data.approverAgentId = flags['approver-agent'];
@@ -40,7 +41,7 @@ class TasksApprovalsCreate extends base_command_1.BaseCommand {
         let result;
         try {
             result = await data_provider_1.dataService.createTaskApproval({
-                taskId: args.id,
+                taskId: taskRef,
                 data: data,
             });
         }

package/dist/commands/tasks/approvals/delete.js

@@ -20,9 +20,10 @@ class TasksApprovalsDelete extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksApprovalsDelete);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let confirmed;
         try {
-            confirmed = await (0, prompt_1.confirmDestructive)(`Delete approval ${args.approvalId} from task ${args.id}? This cannot be undone.`, flags.yes);
+            confirmed = await (0, prompt_1.confirmDestructive)(`Delete approval ${args.approvalId} from task ${taskRef}? This cannot be undone.`, flags.yes);
         }
         catch (err) {
             const e = err;
@@ -33,7 +34,7 @@ class TasksApprovalsDelete extends base_command_1.BaseCommand {
             return;
         }
         try {
-            await data_provider_1.dataService.deleteTaskApproval({ taskId: args.id, approvalId: args.approvalId });
+            await data_provider_1.dataService.deleteTaskApproval({ taskId: taskRef, approvalId: args.approvalId });
         }
         catch (err) {
             this.handleApiError(err);

package/dist/commands/tasks/approvals/list.js

@@ -165,9 +165,10 @@ class TasksApprovalsList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksApprovalsList);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.listTaskApprovals(args.id);
+            response = await data_provider_1.dataService.listTaskApprovals(taskRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -183,7 +184,7 @@ class TasksApprovalsList extends base_command_1.BaseCommand {
         let blockedRun = null;
         let runsRead = false;
         try {
-            const runs = (await data_provider_1.dataService.getTaskRuns(args.id));
+            const runs = (await data_provider_1.dataService.getTaskRuns(taskRef));
             blockedRun = permissionBlockedRun(runs?.data ?? []);
             runsRead = true;
         }
@@ -202,13 +203,13 @@ class TasksApprovalsList extends base_command_1.BaseCommand {
             const out = runsRead
                 ? {
                     ...payload,
-                    blockedRun: blockedRun ? blockedRunSummary(blockedRun, this.config.bin, args.id) : null,
+                    blockedRun: blockedRun ? blockedRunSummary(blockedRun, this.config.bin, taskRef) : null,
                 }
                 : payload;
             this.log(JSON.stringify(out, null, 2));
             return;
         }
-        const blockLines = blockedRun ? permissionBlockLines(blockedRun, this.config.bin, args.id) : [];
+        const blockLines = blockedRun ? permissionBlockLines(blockedRun, this.config.bin, taskRef) : [];
         if (items.length === 0) {
             this.log('No approval requests.');
             if (blockLines.length > 0) {

package/dist/commands/tasks/approvals/resolve.js

@@ -26,13 +26,14 @@ class TasksApprovalsResolve extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksApprovalsResolve);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         const data = { status: flags.status };
         if (flags.reason)
             data.reason = flags.reason;
         let result;
         try {
             result = await data_provider_1.dataService.resolveTaskApproval({
-                taskId: args.id,
+                taskId: taskRef,
                 approvalId: args.approvalId,
                 data: data,
             });

package/dist/commands/tasks/archive.js

@@ -21,11 +21,12 @@ class TasksArchive extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksArchive);
+        const taskId = await this.resolveEntityRef('task', args.id);
         let result;
         try {
             result = flags.unarchive
-                ? await data_provider_1.dataService.unarchiveTask(args.id)
-                : await data_provider_1.dataService.archiveTask(args.id);
+                ? await data_provider_1.dataService.unarchiveTask(taskId)
+                : await data_provider_1.dataService.archiveTask(taskId);
         }
         catch (err) {
             this.handleApiError(err);

package/dist/commands/tasks/assign.js

@@ -109,6 +109,7 @@ class TasksAssign extends base_command_1.BaseCommand {
                 details: { suggestion: failure.suggestion, context: failure.details },
             });
         }
+        const taskRef = await this.resolveEntityRef('task', taskIdentity.id);
         const personQueries = [...(args.person ? [args.person] : []), ...(flags.person ?? [])];
         const agentQueries = flags.agent ?? [];
         if (!flags.list && !flags.suggest && personQueries.length === 0 && agentQueries.length === 0) {
@@ -129,7 +130,7 @@ class TasksAssign extends base_command_1.BaseCommand {
         }
         let task;
         try {
-            task = await data_provider_1.dataService.getTask(taskIdentity.id, { enrich: false });
+            task = await data_provider_1.dataService.getTask(taskRef, { enrich: false });
         }
         catch (err) {
             this.handleApiError(err);
@@ -185,7 +186,7 @@ class TasksAssign extends base_command_1.BaseCommand {
         let updated;
         try {
             updated = await data_provider_1.dataService.updateTask({
-                taskId: taskIdentity.id,
+                taskId: taskRef,
                 data: payload,
             });
         }
@@ -204,7 +205,7 @@ class TasksAssign extends base_command_1.BaseCommand {
             return;
         }
         const t = updated;
-        const ref = t.identifier ?? t.id ?? taskIdentity.id;
+        const ref = t.identifier ?? t.id ?? taskRef;
         let verb = 'Assigned';
         if (flags.remove)
             verb = 'Unassigned';

package/dist/commands/tasks/attachments/delete.js

@@ -20,9 +20,10 @@ class TasksAttachmentsDelete extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksAttachmentsDelete);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let confirmed;
         try {
-            confirmed = await (0, prompt_1.confirmDestructive)(`Delete attachment ${args.attachmentId} from task ${args.id}? This cannot be undone.`, flags.yes);
+            confirmed = await (0, prompt_1.confirmDestructive)(`Delete attachment ${args.attachmentId} from task ${taskRef}? This cannot be undone.`, flags.yes);
         }
         catch (err) {
             const e = err;
@@ -33,7 +34,7 @@ class TasksAttachmentsDelete extends base_command_1.BaseCommand {
             return;
         }
         try {
-            await data_provider_1.dataService.deleteTaskAttachment({ taskId: args.id, attachmentId: args.attachmentId });
+            await data_provider_1.dataService.deleteTaskAttachment({ taskId: taskRef, attachmentId: args.attachmentId });
         }
         catch (err) {
             this.handleApiError(err);

package/dist/commands/tasks/attachments/download.d.ts

@@ -8,6 +8,7 @@ export default class TasksAttachmentsDownload extends BaseCommand {
     };
     static flags: {
         out: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/tasks/attachments/download.js

@@ -52,13 +52,22 @@ class TasksAttachmentsDownload extends base_command_1.BaseCommand {
             description: 'Output path (use - for stdout)',
             required: true,
         }),
+        json: core_1.Flags.boolean({
+            description: 'Print {path, bytes} as JSON after writing a file (not valid with --out -)',
+        }),
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksAttachmentsDownload);
+        const taskRef = await this.resolveEntityRef('task', args.id);
+        if (flags.json && flags.out === '-') {
+            this.error('--json cannot be combined with --out - (stdout carries the file bytes).', {
+                exit: 2,
+            });
+        }
         let buffer;
         try {
-            buffer = await data_provider_1.dataService.downloadTaskAttachment(args.id, args.attachmentId);
+            buffer = await data_provider_1.dataService.downloadTaskAttachment(taskRef, args.attachmentId);
         }
         catch (err) {
             this.handleApiError(err);
@@ -71,6 +80,16 @@ class TasksAttachmentsDownload extends base_command_1.BaseCommand {
         }
         else {
             fs.writeFileSync(flags.out, bytes);
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    object: 'task_attachment_download',
+                    taskId: taskRef,
+                    attachmentId: args.attachmentId,
+                    path: flags.out,
+                    bytes: bytes.length,
+                }));
+                return;
+            }
             this.log(`Wrote ${bytes.length} bytes to ${flags.out}`);
         }
     }

package/dist/commands/tasks/attachments/list.js

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

package/dist/commands/tasks/attachments/set-role.js

@@ -35,10 +35,11 @@ class TasksAttachmentsSetRole extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksAttachmentsSetRole);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         let attachment;
         try {
             attachment = await data_provider_1.dataService.setTaskAttachmentRole({
-                taskId: args.id,
+                taskId: taskRef,
                 attachmentId: args.attachmentId,
                 role: flags.role,
             });

package/dist/commands/tasks/attachments/upload.js

@@ -24,13 +24,14 @@ class TasksAttachmentsUpload extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(TasksAttachmentsUpload);
+        const taskRef = await this.resolveEntityRef('task', args.id);
         // The pipeline — buffered vs direct, session vs generic — lives in
         // task-asset-upload.ts so `--attach` on updates/result/complete/comments
         // makes the same routing decisions byte for byte (OSK-9863).
         let asset;
         try {
             asset = await (0, task_asset_upload_1.uploadTaskAssetFile)({
-                taskId: args.id,
+                taskId: taskRef,
                 filePath: flags.file,
                 role: flags.role,
             });

package/dist/commands/tasks/bulk-update.d.ts

@@ -5,6 +5,7 @@ export default class TasksBulkUpdate extends BaseCommand {
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'continue-on-error': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;