@skrr-ai/cli 0.1.95 → 0.1.96

package/dist/commands/signals/schemas/list.d.ts

@@ -0,0 +1,8 @@
+import { BaseCommand } from '../../../base-command';
+export default class SchemasList extends BaseCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/signals/schemas/list.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const signals_1 = require("../../../lib/signals");
+class SchemasList extends base_command_1.BaseCommand {
+    static description = 'List Signal schemas (read-only)';
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    async run() {
+        this.requireAuth();
+        await this.parse(SchemasList);
+        const result = await signals_1.signalsApi.listSchemas();
+        this.log(JSON.stringify(result, null, 2));
+    }
+}
+exports.default = SchemasList;

package/dist/commands/signals/schemas/show.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../base-command';
+export default class SchemasShow extends BaseCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/signals/schemas/show.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const signals_1 = require("../../../lib/signals");
+class SchemasShow extends base_command_1.BaseCommand {
+    static description = 'Show one Signal schema (read-only)';
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    async run() {
+        this.requireAuth();
+        const { args } = await this.parse(SchemasShow);
+        const result = await signals_1.signalsApi.showSchema(args.id);
+        this.log(JSON.stringify(result, null, 2));
+    }
+}
+exports.default = SchemasShow;

package/dist/commands/signals/sources/list.d.ts

@@ -0,0 +1,8 @@
+import { BaseCommand } from '../../../base-command';
+export default class SourcesList extends BaseCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/signals/sources/list.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const signals_1 = require("../../../lib/signals");
+class SourcesList extends base_command_1.BaseCommand {
+    static description = 'List Signal sources (read-only; credentials are never shown)';
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    async run() {
+        this.requireAuth();
+        await this.parse(SourcesList);
+        const result = await signals_1.signalsApi.listSources();
+        this.log(JSON.stringify(result, null, 2));
+    }
+}
+exports.default = SourcesList;

package/dist/commands/signals/sources/receipts.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../base-command';
+export default class SourcesReceipts extends BaseCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/signals/sources/receipts.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const signals_1 = require("../../../lib/signals");
+class SourcesReceipts extends base_command_1.BaseCommand {
+    static description = 'List recent redacted receipts of a Signal source';
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    async run() {
+        this.requireAuth();
+        const { args } = await this.parse(SourcesReceipts);
+        const result = await signals_1.signalsApi.sourceReceipts(args.id);
+        this.log(JSON.stringify(result, null, 2));
+    }
+}
+exports.default = SourcesReceipts;

package/dist/commands/signals/sources/show.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../base-command';
+export default class SourcesShow extends BaseCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/signals/sources/show.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const signals_1 = require("../../../lib/signals");
+class SourcesShow extends base_command_1.BaseCommand {
+    static description = 'Show one Signal source (read-only)';
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    async run() {
+        this.requireAuth();
+        const { args } = await this.parse(SourcesShow);
+        const result = await signals_1.signalsApi.showSource(args.id);
+        this.log(JSON.stringify(result, null, 2));
+    }
+}
+exports.default = SourcesShow;

package/dist/commands/spaces/usage.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command';
+export default class SpacesUsage extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        window: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/spaces/usage.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const space_usage_1 = require("../../lib/space-usage");
+class SpacesUsage extends base_command_1.BaseCommand {
+    static description = 'Show attributed Space spend and coverage (requires Space owner permissions or workspace administrator)';
+    static args = {
+        id: core_1.Args.string({ description: 'Space ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean(),
+        window: core_1.Flags.string({ options: ['1d', '7d', '30d', '90d'], default: '30d' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpacesUsage);
+        const space = await this.resolveEntityRef('space', args.id);
+        try {
+            const result = await (0, space_usage_1.getSpaceUsage)(space, flags.window);
+            this.log(flags.json ? JSON.stringify(result, null, 2) : (0, space_usage_1.formatSpaceSpend)(result));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = SpacesUsage;

package/dist/commands/spaces/workflows/run.js

@@ -6,6 +6,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const format_1 = require("../../../lib/format");
 const space_output_1 = require("../../../lib/space-output");
+const workflow_run_budget_1 = require("../../../lib/workflow-run-budget");
 /**
  * A run node's human-facing attention note, or '' when nothing is wrong.
  *
@@ -59,6 +60,8 @@ class SpacesWorkflowsRun extends base_command_1.BaseCommand {
             }), null, 2));
         this.log(`Run: ${run.id}`);
         this.log(`Status: ${run.status}`);
+        for (const line of (0, workflow_run_budget_1.describeRunBudget)(run))
+            this.log(line);
         if (runUrl)
             this.log(`URL: ${runUrl}`);
         const nodes = (run.nodes || []);

package/dist/commands/spaces/workflows/runs.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WORKFLOW_RUNS_COLUMNS = void 0;
+const workflow_run_budget_1 = require("../../../lib/workflow-run-budget");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -75,7 +76,7 @@ class SpacesWorkflowsRuns extends base_command_1.BaseCommand {
             id: run.id,
             definition: run.definitionId,
             version: run.version === undefined ? '-' : `v${run.version}`,
-            status: run.status,
+            status: (0, workflow_run_budget_1.runStatusLabel)(run),
             updated: String(run.updatedAt ?? '-'),
         })), exports.WORKFLOW_RUNS_COLUMNS, (line) => this.log(line));
     }

package/dist/commands/spaces/workflows/update.d.ts

@@ -1,7 +1,9 @@
 import { type WorkflowDraft, type WorkflowGraph } from '@skrr-ai/data-provider';
 import { BaseCommand } from '../../../base-command';
 type WorkflowPatch = Record<string, unknown>;
-export declare function buildWorkflowUpdatePayload({ body, title, description, clearDescription, graph, draft, semanticRevision, presentationRevision, }: {
+/** `90m`, `4h`, `2d` to milliseconds; null when malformed or outside the shared bounds. */
+export declare function parseWorkflowDuration(text: string): number | null;
+export declare function buildWorkflowUpdatePayload({ body, title, description, clearDescription, graph, draft, semanticRevision, presentationRevision, maxDurationMs, }: {
     body: WorkflowPatch;
     title?: string;
     description?: string;
@@ -10,6 +12,7 @@ export declare function buildWorkflowUpdatePayload({ body, title, description, c
     draft?: Omit<WorkflowDraft, 'semanticRevision' | 'presentationRevision'>;
     semanticRevision?: number;
     presentationRevision?: number;
+    maxDurationMs?: number | null;
 }): WorkflowPatch;
 /** Update metadata or the mutable draft; executable changes use optimistic concurrency. */
 export default class SpacesWorkflowsUpdate extends BaseCommand {
@@ -28,6 +31,8 @@ export default class SpacesWorkflowsUpdate extends BaseCommand {
         graph: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         draft: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'semantic-revision': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-duration': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'clear-max-duration': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'presentation-revision': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/spaces/workflows/update.js

@@ -1,12 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseWorkflowDuration = parseWorkflowDuration;
 exports.buildWorkflowUpdatePayload = buildWorkflowUpdatePayload;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const prompt_1 = require("../../../lib/prompt");
 const space_output_1 = require("../../../lib/space-output");
-function buildWorkflowUpdatePayload({ body, title, description, clearDescription, graph, draft, semanticRevision, presentationRevision, }) {
+/** `90m`, `4h`, `2d` to milliseconds; null when malformed or outside the shared bounds. */
+function parseWorkflowDuration(text) {
+    const match = /^(\d+)\s*([mhd])$/i.exec(text.trim());
+    if (!match)
+        return null;
+    const unit = { m: 60_000, h: 3_600_000, d: 86_400_000 }[match[2].toLowerCase()];
+    const ms = Number(match[1]) * unit;
+    return (0, data_provider_1.isValidWorkflowMaxDurationMs)(ms) ? ms : null;
+}
+function buildWorkflowUpdatePayload({ body, title, description, clearDescription, graph, draft, semanticRevision, presentationRevision, maxDurationMs, }) {
     return (0, prompt_1.mergeDefined)(body, {
         title,
         description: clearDescription ? null : description,
@@ -14,6 +24,7 @@ function buildWorkflowUpdatePayload({ body, title, description, clearDescription
         draft,
         expectedSemanticRevision: semanticRevision,
         expectedPresentationRevision: presentationRevision,
+        maxDurationMs,
     });
 }
 /** Update metadata or the mutable draft; executable changes use optimistic concurrency. */
@@ -23,6 +34,8 @@ class SpacesWorkflowsUpdate extends base_command_1.BaseCommand {
         '<%= config.bin %> spaces workflows update <space-id> <workflow-id> --title "Release train"',
         '<%= config.bin %> spaces workflows update <space-id> <workflow-id> --graph workflow.json',
         '<%= config.bin %> spaces workflows update <space-id> <workflow-id> --draft canvas-draft.json --json',
+        '<%= config.bin %> spaces workflows update <space-id> <workflow-id> --max-duration 4h',
+        '<%= config.bin %> spaces workflows update <space-id> <workflow-id> --clear-max-duration',
     ];
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),
@@ -45,6 +58,10 @@ class SpacesWorkflowsUpdate extends base_command_1.BaseCommand {
         'semantic-revision': core_1.Flags.integer({
             description: 'Expected semantic revision; defaults to the latest server value',
         }),
+        'max-duration': core_1.Flags.string({
+            description: 'Run duration limit, e.g. 90m, 4h or 2d. A run still open past it is cancelled with WORKFLOW_RUN_DEADLINE. Applies from the next publish; runs already started keep their deadline',
+        }),
+        'clear-max-duration': core_1.Flags.boolean({ description: 'Remove the run duration limit' }),
         'presentation-revision': core_1.Flags.integer({
             description: 'Expected presentation revision; defaults to the latest server value',
         }),
@@ -57,6 +74,20 @@ class SpacesWorkflowsUpdate extends base_command_1.BaseCommand {
         if (flags.description !== undefined && flags['clear-description']) {
             this.error('Pass either --description or --clear-description, not both.', { exit: 2 });
         }
+        if (flags['max-duration'] !== undefined && flags['clear-max-duration']) {
+            this.error('Pass either --max-duration or --clear-max-duration, not both.', { exit: 2 });
+        }
+        let maxDurationMs;
+        if (flags['clear-max-duration'])
+            maxDurationMs = null;
+        else if (flags['max-duration'] !== undefined) {
+            const parsedDuration = parseWorkflowDuration(flags['max-duration']);
+            if (parsedDuration === null) {
+                this.error(`--max-duration must look like 90m, 4h or 2d, between ${(0, data_provider_1.describeWorkflowDuration)(data_provider_1.WORKFLOW_MAX_DURATION_MIN_MS)} and ${(0, data_provider_1.describeWorkflowDuration)(data_provider_1.WORKFLOW_MAX_DURATION_MAX_MS)}.`, { exit: 2 });
+                return;
+            }
+            maxDurationMs = parsedDuration;
+        }
         if ((flags['semantic-revision'] === undefined) !==
             (flags['presentation-revision'] === undefined)) {
             this.error('Pass both --semantic-revision and --presentation-revision together.', {
@@ -86,9 +117,10 @@ class SpacesWorkflowsUpdate extends base_command_1.BaseCommand {
             draft,
             semanticRevision: flags['semantic-revision'],
             presentationRevision: flags['presentation-revision'],
+            maxDurationMs,
         });
         if (Object.keys(patch).length === 0) {
-            this.error('Nothing to update. Pass metadata, --graph, --draft, or --from-json.', {
+            this.error('Nothing to update. Pass metadata, --max-duration, --graph, --draft, or --from-json.', {
                 exit: 2,
             });
         }

package/dist/commands/tasks/cascade-status.d.ts

@@ -1,4 +1,6 @@
 import { BaseCommand } from '../../base-command';
+/** Skip counts, the stall reason and per-task join reasons, as printed lines. */
+export declare function cascadeSkipLines(s: Record<string, unknown>): string[];
 export default class TasksCascadeStatus extends BaseCommand {
     static description: string;
     static examples: string[];

package/dist/commands/tasks/cascade-status.js

@@ -1,8 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.cascadeSkipLines = cascadeSkipLines;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
+/** Skip counts, the stall reason and per-task join reasons, as printed lines. */
+function cascadeSkipLines(s) {
+    const lines = [
+        `Skipped:              ${s.skipped ?? 0}`,
+        `Skipped duplicate:    ${s.skippedDuplicate ?? 0}`,
+        `Waiting for Human:    ${s.humanBlocked ?? s.humanWaitingCount ?? s.waitingForHuman ?? '-'}`,
+    ];
+    if (s.stalledReason)
+        lines.push(`Waiting reason:       ${s.stalledReason}`);
+    if (s.stalledReason === 'waiting_on_timed_out_human')
+        lines.push("                      a person's task timed out and was never completed; the cascade stopped");
+    if (Number(s.unresolvedHumanCount) > 0)
+        lines.push(`Unresolved human:    ${s.unresolvedHumanCount} (finished without a person completing these tasks)`);
+    const tasks = (Array.isArray(s.tasks) ? s.tasks : []);
+    for (const task of tasks) {
+        if (task.abortUnconfirmed)
+            lines.push(`${task.identifier || task.taskId}: cancelled; the task may still be running - check it`);
+        else if (task.cancelUnconfirmed)
+            lines.push(`${task.identifier || task.taskId}: cancelled (not confirmed in the run record; the stored row may still read otherwise)`);
+        else if (task.reason || task.joinNote)
+            lines.push(`${task.identifier || task.taskId}: ${task.reason || task.joinNote}`);
+    }
+    return lines;
+}
 class TasksCascadeStatus extends base_command_1.BaseCommand {
     static description = 'Show cascade pipeline status for a task';
     static examples = [
@@ -36,7 +61,8 @@ class TasksCascadeStatus extends base_command_1.BaseCommand {
         this.log(`Total Tasks:          ${s.totalTasks ?? s.total ?? '-'}`);
         this.log(`Completed:            ${s.completedTasks ?? s.completed ?? '-'}`);
         this.log(`Failed:               ${s.failedTasks ?? s.failed ?? '-'}`);
-        this.log(`Waiting for Human:    ${s.humanWaitingCount ?? s.waitingForHuman ?? '-'}`);
+        for (const line of cascadeSkipLines(s))
+            this.log(line);
     }
 }
 exports.default = TasksCascadeStatus;

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

@@ -67,6 +67,10 @@ export default class TasksCreate extends BaseCommand {
         'execution-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'start-date': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'due-date': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        savings: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        per: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        effort: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        risk: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         estimate: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         tag: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'label-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/tasks/create.js

@@ -5,6 +5,7 @@ exports.droppedEstimateWarning = droppedEstimateWarning;
 exports.taskCreateMayHaveCommitted = taskCreateMayHaveCommitted;
 exports.taskMatchesCreateIdentity = taskMatchesCreateIdentity;
 const core_1 = require("@oclif/core");
+const task_economics_1 = require("../../lib/task-economics");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const label_ref_1 = require("../../lib/label-ref");
@@ -223,6 +224,13 @@ class TasksCreate extends base_command_1.BaseCommand {
         }),
         'start-date': core_1.Flags.string({ description: 'Planned start date (ISO string)' }),
         'due-date': core_1.Flags.string({ description: 'Due date (ISO string)' }),
+        savings: core_1.Flags.string({ description: 'Expected USD savings (requires --per)' }),
+        per: core_1.Flags.string({
+            options: ['month', 'year', 'once'],
+            description: 'Savings period (requires --savings)',
+        }),
+        effort: core_1.Flags.string({ description: 'Expected effort in hours, nonnegative' }),
+        risk: core_1.Flags.string({ options: ['low', 'medium', 'high'], description: 'Expected risk' }),
         estimate: core_1.Flags.integer({
             // Names the prerequisite AND how to satisfy it. The first version of this
             // help said the scale was reachable only from the web UI, which was true
@@ -320,6 +328,14 @@ class TasksCreate extends base_command_1.BaseCommand {
                 ? parsedExpectations.value
                 : undefined,
         });
+        try {
+            const economics = (0, task_economics_1.economicsFromFlags)(flags, body.economics);
+            if (economics)
+                payload.economics = economics;
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : 'Invalid economics', { exit: 2 });
+        }
         const isTemplateInstantiation = typeof payload.templateId === 'string' && payload.templateId.length > 0;
         // Template defaults (including its assigned agents) are part of the saved
         // resource. Do not let the ordinary "who owns an empty task?" policy

package/dist/commands/tasks/deliverable/add.js

@@ -269,12 +269,21 @@ class TasksDeliverableAdd extends base_command_1.BaseCommand {
             this.handleApiError(err);
             return false;
         }
+        const { resourceReceipt, ...archived } = asset;
+        if (!resourceReceipt?.link.id) {
+            this.warn('The file was archived, but this server did not return its Deliverable link. ' +
+                `Run skrr tasks deliverable list ${opts.taskId} --json to find the exact version before submitting a Result.`);
+        }
         if (opts.json) {
-            this.log(JSON.stringify({ archived: asset, identity: opts.identity }, null, 2));
+            this.log(JSON.stringify({ ...resourceReceipt, archived, identity: opts.identity }, null, 2));
             return true;
         }
-        this.log(`Recorded Deliverable ${opts.identity} — archived copy ${asset.id} ` +
-            `(sha256 pinned; observed available; self reported).`);
+        const recorded = resourceReceipt?.link.id
+            ? `Recorded Deliverable ${resourceReceipt.link.id}: ${opts.identity}`
+            : `Archived ${opts.identity}`;
+        const version = resourceReceipt?.version.id ? `version ${resourceReceipt.version.id}; ` : '';
+        this.log(`${recorded} — archived copy ${asset.id} ` +
+            `(${version}sha256 pinned; observed available; self reported).`);
         if (opts.requestedStatus && opts.requestedStatus !== 'available') {
             // Not silent: the platform WATCHED these bytes land, which is a stronger
             // and verified statement than the one that was asked for. Who vouched

package/dist/commands/tasks/economics-compare.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base-command';
+export default class TasksEconomicsCompare extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        measure: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        fire: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
+        revision: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tasks/economics-compare.js

@@ -0,0 +1,60 @@
+"use strict";
+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");
+class TasksEconomicsCompare extends base_command_1.BaseCommand {
+    static description = 'Show a Task economics estimate beside retained platform readings (no measurement binding is created)';
+    static examples = [
+        '<%= config.bin %> tasks economics-compare <task-id> --measure <id> --fire <fire-id> --revision 3',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Task ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        measure: core_1.Flags.string({ description: 'Measure ID', required: true }),
+        fire: core_1.Flags.string({
+            description: 'Exact retained trigger fire ID (repeat once for a second reading)',
+            required: true,
+            multiple: true,
+        }),
+        revision: core_1.Flags.integer({
+            description: 'Task economics revision being compared',
+            required: true,
+            min: 1,
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksEconomicsCompare);
+        const taskRef = await this.resolveEntityRef('task', args.id);
+        let response;
+        try {
+            response = await data_provider_1.dataService.getTaskEconomicsComparison(taskRef, {
+                measureId: flags.measure,
+                fireIds: flags.fire,
+                economicsRevision: flags.revision,
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        const readings = response.platformReadings;
+        this.log(`Estimate (revision ${response.economicsRevision}): ${JSON.stringify(response.economics)}`);
+        if (readings.status === 'unavailable') {
+            this.log(`Platform readings unavailable: ${readings.reason}`);
+        }
+        else {
+            const unit = readings.customUnit ?? readings.declaredUnit;
+            for (const r of readings.readings)
+                this.log(`${r.triggerFireId}: ${r.value} ${unit} at ${r.observedAt}`);
+        }
+        this.log(`Measurement: ${response.measurement.reason}`);
+    }
+}
+exports.default = TasksEconomicsCompare;

package/dist/commands/tasks/expectations/evaluate.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class TasksExpectationsEvaluate extends BaseCommand {
+    static description: string;
+    static args: {
+        task: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        task: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'spec-version': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tasks/expectations/evaluate.js

@@ -0,0 +1,43 @@
+"use strict";
+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 task_resolver_1 = require("../../../lib/task-resolver");
+class TasksExpectationsEvaluate extends base_command_1.BaseCommand {
+    static description = 'Observe authorized Task/Goal states and record met-only facts; never close the Task';
+    static args = {
+        task: core_1.Args.string({ required: false, ignoreStdin: true, description: 'Task id or ref' }),
+    };
+    static flags = {
+        task: core_1.Flags.string({ description: 'Task id; overrides runtime context' }),
+        'spec-version': core_1.Flags.integer({
+            min: 1,
+            description: 'Expected current specification version',
+        }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksExpectationsEvaluate);
+        const task = (0, task_resolver_1.resolveTaskIdentity)({ positionalId: args.task, flagTask: flags.task });
+        try {
+            const result = await data_provider_1.dataService.evaluateTaskExpectations({
+                taskId: task.id,
+                data: { expectedSpecVersion: flags['spec-version'] },
+            });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log(`Task specification v${result.specVersion}; platform-state snapshot only.`);
+            for (const row of result.outcomes) {
+                this.log(`${row.expectationId}: ${row.state}${row.reason ? ` (${row.reason})` : ''}`);
+            }
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = TasksExpectationsEvaluate;

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

@@ -74,6 +74,7 @@ export default class TasksList extends BaseCommand {
         'actionable-by': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'actionable-for-agent': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'needs-me': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        rank: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         sort: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         order: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'due-before': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;