@skrr-ai/cli 0.1.94 → 0.1.96

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/cancel-cascade.js

@@ -5,7 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const prompt_1 = require("../../lib/prompt");
 class TasksCancelCascade extends base_command_1.BaseCommand {
-    static description = 'Cancel an active cascade pipeline for a task';
+    static description = 'Cancel running and queued work in the active cascade; future schedules stay enabled';
     static examples = [
         '<%= config.bin %> tasks cancel-cascade <task-id>',
         '<%= config.bin %> tasks cancel-cascade <task-id> --yes',

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-tree.d.ts

@@ -52,9 +52,13 @@ export declare function partialFailureResult(args: {
     failedAt: TreeFailure;
     total: number;
     prefix?: string;
+    keyed?: boolean;
     warnings: Array<Record<string, unknown>>;
+    failures?: Array<Record<string, unknown>>;
 }): {
     warnings?: Record<string, unknown>[] | undefined;
+    rerun: string;
+    failures?: Record<string, unknown>[] | undefined;
     object: string;
     ok: boolean;
     count: number;
@@ -69,7 +73,6 @@ export declare function partialFailureResult(args: {
     }[];
     mapping: Record<string, string>;
     failedAt: TreeFailure;
-    rerun: string;
 };
 export default class TasksCreateTree extends BaseCommand {
     static description: string;
@@ -80,6 +83,7 @@ export default class TasksCreateTree extends BaseCommand {
         'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'external-key-prefix': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         fresh: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        resume: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'default-agent': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         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>;

package/dist/commands/tasks/create-tree.js

@@ -78,8 +78,9 @@ function partialFailureResult(args) {
         })),
         mapping,
         failedAt,
-        rerun: prefix
-            ? 'Safe to re-run the same command: nodes with an externalKey are updated, not duplicated.'
+        ...(args.failures ? { failures: args.failures } : {}),
+        rerun: prefix || args.keyed
+            ? 'Re-run the same keyed file with --resume to confirm existing IDs and create only missing nodes. A submitted write may still finish; stable keys prevent duplicates.'
             : 'Re-running creates un-keyed nodes again. Use mapping to continue by hand, or re-run with --external-key-prefix.',
         ...(warnings.length > 0 ? { warnings } : {}),
     };
@@ -105,6 +106,10 @@ class TasksCreateTree extends base_command_1.BaseCommand {
         fresh: core_1.Flags.boolean({
             description: 'Do not derive a key prefix from the file: create a new copy even if this exact file was applied before',
         }),
+        resume: core_1.Flags.boolean({
+            description: 'Confirm existing stable-key nodes without patching them, then create only missing nodes. Use the unchanged keyed file after an incomplete result.',
+            exclusive: ['fresh'],
+        }),
         'default-agent': core_1.Flags.string({
             description: 'Override the automatic assignee for nodes with no assignee. Use "auto" to inherit the space lead agent; children inherit parent assignees first.',
         }),
@@ -212,6 +217,8 @@ class TasksCreateTree extends base_command_1.BaseCommand {
         }
         const errors = [
             ...defaultAgentErrors,
+            ...(flags.resume && unkeyedNodes(planned).length
+                ? ['--resume requires an externalKey for every node; supply --external-key-prefix and do not use --fresh'] : []),
             ...planned.flatMap(({ key, payload }) => (0, tasks_1.validateTaskCreatePayload)(payload).map((error) => `${key}: ${error}`)),
         ];
         if (errors.length > 0) {
@@ -267,15 +274,17 @@ class TasksCreateTree extends base_command_1.BaseCommand {
         const mapping = {};
         const results = [];
         // A half-applied tree reports the ids it did create; the only way back.
-        const reportPartial = (item, failure, err) => {
-            if (results.length === 0)
+        const reportPartial = (item, failure, err, failures) => {
+            if (results.length === 0 && !failures)
                 this.handleApiError(err);
             const partial = partialFailureResult({
                 results,
                 mapping,
                 total: planned.length,
                 prefix: keyPrefix,
+                keyed: unkeyedNodes(planned).length === 0,
                 warnings,
+                failures,
                 failedAt: {
                     tempId: item.key,
                     ...(item.parentKey ? { parentTempId: item.parentKey } : {}),
@@ -288,10 +297,18 @@ class TasksCreateTree extends base_command_1.BaseCommand {
                 process.exitCode = partial.failedAt.error.retryable ? 5 : 1;
                 this.exit(partial.failedAt.error.retryable ? 5 : 1);
             }
-            this.log(`Created ${results.length} of ${planned.length} task(s) before "${item.key}" failed:`);
+            this.log(`Confirmed ${results.length} of ${planned.length} task(s); stopped at "${item.key}":`);
             for (const [tempId, id] of Object.entries(mapping))
                 this.log(`- ${tempId} -> ${id}`);
             this.log(partial.rerun);
+            if (failures) {
+                for (const row of failures) {
+                    const detail = row.error;
+                    this.log(`- ${String(row.tempId)}: ${String(row.outcome)} — ${detail.message}`);
+                }
+                this.exit(failure.retryable ? 5 : 1);
+                return;
+            }
             this.handleApiError(err);
         };
         // The serial path: one request per node. Used for updates of existing keyed
@@ -381,7 +398,11 @@ class TasksCreateTree extends base_command_1.BaseCommand {
                             ...(failure.error.status ? { status: failure.error.status } : {}),
                             ...(failure.error.code ? { code: failure.error.code } : {}),
                         });
-                        reportPartial(node, failure.error, err);
+                        reportPartial(node, failure.error, err, outcome.failures.map((f) => ({
+                            tempId: f.key, outcome: f.outcome ?? (f.skipped ? 'not_attempted' : 'failed'),
+                            externalKey: f.externalKey ?? byKey.get(f.key)?.payload.externalKey,
+                            error: f.error,
+                        })));
                     }
                     return;
                 }
@@ -395,7 +416,14 @@ class TasksCreateTree extends base_command_1.BaseCommand {
             if (existingTask) {
                 // An update must see its parent's id, and a later create its own parent's.
                 await flushPending();
-                await applySerial(item);
+                if (flags.resume) {
+                    const id = (0, tasks_1.taskId)(existingTask);
+                    mapping[item.key] = id;
+                    results.push({ tempId: item.key, parentTempId: item.parentKey, id, action: 'existing',
+                        externalKey: item.payload.externalKey, title: existingTask.title ?? item.payload.title, task: existingTask });
+                }
+                else
+                    await applySerial(item);
             }
             else {
                 pending.push(item);

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

@@ -10,7 +10,7 @@ const base_command_1 = require("../../base-command");
  * activity log shows who pulled the plug and why.
  */
 class TasksInterrupt extends base_command_1.BaseCommand {
-    static description = 'Interrupt a running task (posts an interrupt-flagged comment that the agent runtime honors)';
+    static description = 'Request an interrupt for the current run; child runs, queued work and future schedules are unchanged';
     static examples = [
         '<%= config.bin %> tasks interrupt <task-id>',
         '<%= config.bin %> tasks interrupt <task-id> --reason "wrong file"',
@@ -45,7 +45,7 @@ class TasksInterrupt extends base_command_1.BaseCommand {
             return;
         }
         const c = result;
-        this.log(`Interrupt sent to task ${taskRef} (comment ${c.id ?? c._id ?? '?'})`);
+        this.log(`Stop requested for task ${taskRef} (comment ${c.id ?? c._id ?? '?'}). Child runs and schedules are unchanged; inspect run state to confirm it stopped.`);
     }
 }
 exports.default = TasksInterrupt;

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>;

package/dist/commands/tasks/list.js

@@ -272,7 +272,9 @@ function buildListParams(flags, assigneeUserId) {
         // `--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('compact') && !flag('fields') && !flag('rank')
+            ? { view: 'summary' }
+            : {}),
         ...(flag('view') ? { taskViewId: flag('view') } : {}),
         limit: flag('limit'),
         cursor: flag('cursor'),
@@ -374,6 +376,10 @@ class TasksList extends base_command_1.BaseCommand {
         'needs-me': core_1.Flags.boolean({
             description: 'Filter to Human-actionable work addressed to you',
         }),
+        rank: core_1.Flags.string({
+            options: ['economics'],
+            description: 'Rank only this fetched page by annualized USD / max(effort hours,0.5) × risk discount; unknown last, never an action policy',
+        }),
         sort: core_1.Flags.string({
             description: 'Order by a shared saved-view field',
             options: [...data_provider_1.VIEW_SORT_KEYS],
@@ -527,6 +533,19 @@ class TasksList extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
+        if (flags.rank && calendarRange)
+            this.error('--rank applies to fetched task pages, not calendar occurrences.', { exit: 2 });
+        if (flags.rank &&
+            response &&
+            typeof response === 'object' &&
+            'data' in response &&
+            Array.isArray(response.data)) {
+            response = {
+                ...response,
+                data: (0, data_provider_1.rankEconomicItems)(response.data),
+                rank_applied: { key: 'economics', scope: 'fetched_page' },
+            };
+        }
         const list = response;
         const statusWarnings = calendarRange
             ? []
@@ -604,6 +623,12 @@ class TasksList extends base_command_1.BaseCommand {
             return;
         }
         const rows = items.map((t) => {
+            const economics = t.economics;
+            const basis = {
+                agent_estimate: 'Agent estimate',
+                human_confirmed: 'Human confirmed',
+                measured: 'Measured',
+            };
             const agents = Array.isArray(t.assigneeAgentIds) ? t.assigneeAgentIds.length : 0;
             const users = Array.isArray(t.assigneeUserIds) ? t.assigneeUserIds.length : 0;
             const assignees = agents + users > 0 ? `${agents}a/${users}u` : '-';
@@ -617,6 +642,14 @@ class TasksList extends base_command_1.BaseCommand {
                 assignees,
                 next: nextActionText(t),
                 match: String(t._matchField ?? '-'),
+                savings: economics?.savings
+                    ? `${economics.savings.currency} ${economics.savings.amount}/${economics.savings.per}`
+                    : 'Unknown',
+                effort: economics?.effortHours !== undefined ? `${economics.effortHours}h` : 'Unknown',
+                risk: economics?.risk ?? 'Unknown',
+                basis: economics?.basis && Object.prototype.hasOwnProperty.call(basis, economics.basis)
+                    ? basis[economics.basis]
+                    : 'Unknown',
             };
         });
         (0, format_1.renderTable)(rows, [
@@ -624,6 +657,14 @@ class TasksList extends base_command_1.BaseCommand {
             { key: 'title', header: 'TITLE', maxWidth: 50 },
             { key: 'status', header: 'STATUS' },
             { key: 'priority', header: 'PRIORITY' },
+            ...(flags.rank
+                ? [
+                    { key: 'savings', header: 'SAVINGS' },
+                    { key: 'effort', header: 'EFFORT' },
+                    { key: 'risk', header: 'RISK' },
+                    { key: 'basis', header: 'BASIS' },
+                ]
+                : []),
             { key: 'estimate', header: 'ESTIMATE' },
             { key: 'assignees', header: 'ASSIGNEES' },
             // Bounded: the reason is a sentence, and an unbounded column wraps the
@@ -634,6 +675,8 @@ class TasksList extends base_command_1.BaseCommand {
             ...(flags.q ? [{ key: 'match', header: 'MATCH' }] : []),
             { key: 'id', header: 'ID' },
         ], (line) => this.log(line));
+        if (flags.rank)
+            this.log('\nRanked only within this fetched page; estimates are claims, not measured savings.');
         if (r?.next_cursor) {
             this.log('');
             this.log(`Next page: --cursor ${r.next_cursor}`);

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

@@ -5,7 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const web_url_1 = require("../../lib/web-url");
 class TasksPauseSchedule extends base_command_1.BaseCommand {
-    static description = 'Pause a recurring task — keeps the recurrence definition but stops future fires';
+    static description = 'Pause future recurring runs; current runs and already queued work are unchanged';
     static examples = [
         '<%= config.bin %> tasks pause-schedule <task-id>',
         '<%= config.bin %> tasks pause-schedule <task-id> --json',

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

@@ -63,6 +63,11 @@ export declare function labelsLine(labelIds?: string[], nameById?: Map<string, s
  * reassigning the task changes only the implied kind.
  */
 export declare function taskExecutorLabel(t: Record<string, unknown>, bin?: string): string;
+/**
+ * The `Recurrence:` line for a series whose next occurrence was never armed.
+ * Silent otherwise: a healthy series has nothing to say here.
+ */
+export declare function recurrenceArmFailureLines(t: Record<string, unknown>, bin?: string): string[];
 /**
  * The failure rows of `tasks show`, when there are any. (S3 dogfood finding)
  *