@skrr-ai/cli 0.1.110 → 0.1.113

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

@@ -39,6 +39,7 @@ export default class TasksCreate extends BaseCommand {
     static examples: string[];
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        unassigned: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         template: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/tasks/create.js

@@ -104,6 +104,7 @@ function taskMatchesCreateIdentity(task, payload) {
         'projectId',
         'parentId',
         'commitmentId',
+        'executionMode',
     ]) {
         const requested = payload[field];
         if (requested === undefined || requested === null || requested === '')
@@ -111,6 +112,14 @@ function taskMatchesCreateIdentity(task, payload) {
         if (String(task[field] ?? '') !== String(requested))
             return false;
     }
+    for (const field of ['assigneeAgentIds', 'assigneeUserIds']) {
+        if (!Array.isArray(payload[field]))
+            continue;
+        const requested = [...new Set(payload[field].map(String))].sort();
+        const actual = [...new Set(Array.isArray(task[field]) ? task[field].map(String) : [])].sort();
+        if (JSON.stringify(actual) !== JSON.stringify(requested))
+            return false;
+    }
     return true;
 }
 class TasksCreate extends base_command_1.BaseCommand {
@@ -129,6 +138,9 @@ class TasksCreate extends base_command_1.BaseCommand {
     ];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output the created task as JSON' }),
+        unassigned: core_1.Flags.boolean({
+            description: 'Leave both Agent and Human assignees empty; overrides JSON assignment and suppresses session, parent and Space defaults. Does not start a Run.',
+        }),
         'dry-run': core_1.Flags.boolean({
             description: 'Validate and print the create payload without writing a task',
         }),
@@ -190,7 +202,7 @@ class TasksCreate extends base_command_1.BaseCommand {
             description: 'Source message ID (requires --source-conversation or daemon session context)',
         }),
         'assignee-agent': core_1.Flags.string({
-            description: 'Assignee agent: the agent that DOES the work when the task starts (the first listed runs). ' +
+            description: 'Assignee Agent eligible to do the work when the Task starts. Multiple Agents require an explicit execution choice. ' +
                 'Id or name, resolved within --space (repeatable)',
             multiple: true,
         }),
@@ -219,7 +231,7 @@ class TasksCreate extends base_command_1.BaseCommand {
                 'executor, human or agent.',
         }),
         'execution-mode': core_1.Flags.string({
-            description: 'Who executes the task: agent or human. Required when both Humans and Agents are ' +
+            description: 'Intended executor: agent or human, independent of assignment. Use --unassigned to record intent before selecting anyone. Required when both Humans and Agents are ' +
                 'assigned. Passing "human" with no assignee flags files the task against you, ' +
                 'never against an agent.',
             options: ['agent', 'human'],
@@ -293,6 +305,18 @@ class TasksCreate extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(TasksCreate);
+        this.setJsonOperation({
+            command: 'tasks:create',
+            mode: flags['dry-run'] ? 'dry_run' : 'execute',
+        });
+        const assignmentError = (0, tasks_1.taskUnassignmentFlagError)(flags);
+        if (assignmentError)
+            this.failWithCliError({
+                message: assignmentError,
+                code: 'TASK_ASSIGNMENT_FLAG_CONFLICT',
+                exit: 2,
+                retryable: false,
+            });
         // Default to {} so TS flow-analysis is satisfied — the catch calls this.error(), which throws.
         let body = {};
         try {
@@ -352,6 +376,7 @@ class TasksCreate extends base_command_1.BaseCommand {
         catch (error) {
             this.error(error instanceof Error ? error.message : 'Invalid economics', { exit: 2 });
         }
+        await this.resolveTaskResourceReferences(payload);
         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
@@ -360,14 +385,26 @@ class TasksCreate extends base_command_1.BaseCommand {
         if (isTemplateInstantiation) {
             const validationErrors = (0, tasks_1.validateTaskCreatePayload)(payload);
             if (flags['dry-run']) {
+                const explicitAssignment = Array.isArray(payload.assigneeAgentIds) && Array.isArray(payload.assigneeUserIds);
+                const preview = (0, tasks_1.taskAssignmentPreview)(payload);
                 const result = {
                     object: 'task_template_instantiate_dry_run',
                     ok: validationErrors.length === 0,
                     errors: validationErrors,
                     payload,
+                    assignmentPreview: {
+                        ...preview,
+                        executor: payload.executionMode
+                            ? preview.executor
+                            : { mode: null, source: 'template_defaults_not_loaded' },
+                        assigneeAgentIds: explicitAssignment ? preview.assigneeAgentIds : null,
+                        assigneeUserIds: explicitAssignment ? preview.assigneeUserIds : null,
+                        assigned: explicitAssignment ? preview.assigned : null,
+                        defaults: 'template_defaults_not_loaded',
+                    },
                 };
                 if (flags.json)
-                    this.log(JSON.stringify(result, null, 2));
+                    this.printJsonOperation(result, { mode: 'dry_run', resource: null, task: null });
                 else
                     this.log(JSON.stringify(result, null, 2));
                 if (validationErrors.length > 0)
@@ -393,7 +430,14 @@ class TasksCreate extends base_command_1.BaseCommand {
                 (instantiated.rootTasks || [])[0];
             const url = root ? (0, web_url_1.taskUrlFrom)(this.cliConfig.baseURL, root) : undefined;
             if (flags.json) {
-                this.log(JSON.stringify({ ...instantiated, ...(url ? { url } : {}) }, null, 2));
+                this.printJsonOperation({
+                    ...instantiated,
+                    ...(url ? { url } : {}),
+                    ...(root ? { assignmentPreview: (0, tasks_1.taskAssignmentPreview)(root) } : {}),
+                }, {
+                    resource: root?.id ? { kind: 'task', id: String(root.id) } : null,
+                    task: root?.id ? { id: String(root.id) } : null,
+                });
                 return;
             }
             const count = Array.isArray(instantiated.createdTasks) ? instantiated.createdTasks.length : 0;
@@ -468,10 +512,11 @@ class TasksCreate extends base_command_1.BaseCommand {
                 errors,
                 ...(warnings.length > 0 ? { warnings } : {}),
                 defaultAgent: defaultAgentResolution,
+                assignmentPreview: (0, tasks_1.taskAssignmentPreview)(payload),
                 payload,
             };
             if (flags.json) {
-                this.log(JSON.stringify(result, null, 2));
+                this.printJsonOperation(result, { mode: 'dry_run', resource: null, task: null });
             }
             else if (errors.length > 0) {
                 this.log('Dry run failed:');
@@ -533,9 +578,8 @@ class TasksCreate extends base_command_1.BaseCommand {
             }
             delete payload.assigneeAgentIds;
             delete payload.assigneeUserIds;
-            // `executionMode: 'agent'` is inferred from the same binding and the
-            // schema rejects it without an agent assignee, so it goes too — unless
-            // the caller stated it, which is a claim about how the work runs.
+            // Remove intent inferred from the discarded binding. Preserve a mode
+            // the caller stated: it can be recorded before anyone is assigned.
             const modeWasStated = flags['execution-mode'] !== undefined ||
                 Object.prototype.hasOwnProperty.call(body ?? {}, 'executionMode');
             if (!modeWasStated)
@@ -576,12 +620,18 @@ class TasksCreate extends base_command_1.BaseCommand {
             // bound". Surface the same decision plain mode prints under `assignment`
             // — a scripted caller is exactly the audience that never sees the note.
             // (OSK-4856)
-            this.log(JSON.stringify({
-                ...created,
+            const row = created;
+            this.printJsonOperation({
+                ...row,
                 url,
                 assignment: defaultAgentResolution,
+                assignmentPreview: (0, tasks_1.taskAssignmentPreview)(row),
                 ...(createRecovery ? { recovery: createRecovery } : {}),
-            }, null, 2));
+            }, {
+                resource: row.id ? { kind: 'task', id: String(row.id) } : null,
+                task: row.id ? { id: String(row.id) } : null,
+                replayed: !!createRecovery,
+            });
             return;
         }
         this.log(`${createRecovery ? 'Recovered' : 'Created'} task ${(0, tasks_1.formatTaskLabel)(created)}`);
@@ -592,6 +642,8 @@ class TasksCreate extends base_command_1.BaseCommand {
         // line that stops "unassigned" from being a silent outcome.
         if (defaultAgentResolution.note)
             this.log(defaultAgentResolution.note);
+        if (flags.unassigned)
+            this.log(`Executor intent: ${(0, tasks_1.taskAssignmentPreview)(created).executor.mode || 'unspecified'}; assignment: unassigned. No Run requested.`);
         if (url)
             this.log(`View it at ${url}`);
         await (0, task_instruction_offer_1.maybeOfferTaskManagementInstructions)((message) => this.log(message));

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

@@ -124,6 +124,7 @@ class TasksDeliverableAdd extends base_command_1.BaseCommand {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
     };
     async run() {
+        this.setJsonOperation({ command: 'tasks:deliverable:add', mode: 'execute' });
         this.requireAuth();
         const { args, flags } = await this.parse(TasksDeliverableAdd);
         const parsed = (0, tasks_1.parseDeliverableCoordinate)(args.coordinate);
@@ -208,7 +209,10 @@ class TasksDeliverableAdd extends base_command_1.BaseCommand {
             return;
         }
         if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
+            this.printJsonOperation(result, {
+                resource: { kind: 'task_resource_link', id: result?.link?.id },
+                task: { id: result?.link?.taskId },
+            });
             return;
         }
         const where = parsed.value.location ? ` at ${parsed.value.location}` : '';
@@ -281,12 +285,15 @@ class TasksDeliverableAdd extends base_command_1.BaseCommand {
             // `--status` is overridden for an archived copy, and --json used to say nothing of it: the
             // receipt's observation read `available` and the requested status appeared nowhere (OSK-15437).
             const notes = statusNotApplied(opts.requestedStatus);
-            this.log(JSON.stringify({
+            this.printJsonOperation({
                 ...resourceReceipt,
                 archived,
                 identity: opts.identity,
                 ...(notes ? { requestedStatus: opts.requestedStatus, notes: [notes] } : {}),
-            }, null, 2));
+            }, {
+                resource: { kind: 'task_resource_link', id: resourceReceipt?.link.id },
+                task: { id: resourceReceipt?.link?.taskId },
+            });
             return true;
         }
         const recorded = resourceReceipt?.link.id

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.earlierVersions = earlierVersions;
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -88,7 +89,7 @@ class TasksDeliverableList extends base_command_1.BaseCommand {
             this.handleApiError(error);
         }
         if (flags.json)
-            return this.log(JSON.stringify(result, null, 2));
+            return this.printJsonResult((0, list_output_1.listResult)(result));
         if (!result.data.length)
             return this.log('No Deliverables recorded.');
         const earlier = earlierVersions(result.data);

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -56,7 +57,7 @@ class TasksEventsList extends base_command_1.BaseCommand {
         // activity`, both render tables, so the one command an agent is pointed at
         // for the durable ledger was the one that made you read storage internals.
         if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(result));
             return;
         }
         const rows = (result?.data ?? []);

package/dist/commands/tasks/execution-state.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command';
+export { describeExecutionState } from '../../lib/task-work';
+export default class TasksExecutionState 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>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tasks/execution-state.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeExecutionState = void 0;
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const task_work_1 = require("../../lib/task-work");
+var task_work_2 = require("../../lib/task-work");
+Object.defineProperty(exports, "describeExecutionState", { enumerable: true, get: function () { return task_work_2.describeExecutionState; } });
+class TasksExecutionState extends base_command_1.BaseCommand {
+    static description = 'Inspect current Task execution, waiting, health and Result applicability';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true, description: 'Task ID or identifier' }) };
+    static flags = { json: core_1.Flags.boolean({ description: 'Output the versioned execution snapshot as JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksExecutionState);
+        const taskId = await this.resolveTaskReference(args.id);
+        let state;
+        try {
+            state = await data_provider_1.dataService.getTaskExecutionState(taskId);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        this.log(flags.json ? JSON.stringify(state, null, 2) : (0, task_work_1.describeExecutionState)(state).join('\n'));
+    }
+}
+exports.default = TasksExecutionState;

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

@@ -7,6 +7,7 @@ const outbox_1 = require("../../../lib/outbox");
 const task_resolver_1 = require("../../../lib/task-resolver");
 const api_fetch_1 = require("../../../lib/api-fetch");
 const session_task_write_1 = require("../../../lib/session-task-write");
+const task_write_attribution_1 = require("../../../lib/task-write-attribution");
 class TasksExpectationsAssess extends base_command_1.BaseCommand {
     static description = 'Assess one current Task Expectation with evidence and a reason';
     // Both positionals are declared optional because oclif REJECTS an args table
@@ -138,7 +139,11 @@ class TasksExpectationsAssess extends base_command_1.BaseCommand {
             };
             const sessionWrite = await (0, session_task_write_1.sessionTaskWrite)('assessment', task.id);
             return sessionWrite
-                ? await (0, api_fetch_1.apiFetch)(sessionWrite.path, { method: 'POST', body: data, credential: sessionWrite.credential })
+                ? await (0, api_fetch_1.apiFetch)(sessionWrite.path, {
+                    method: 'POST',
+                    body: data,
+                    credential: sessionWrite.credential,
+                })
                 : await data_provider_1.dataService.assessTaskExpectation({ taskId: task.id, expectationId: id, data });
         };
         if (flags.all) {
@@ -155,6 +160,17 @@ class TasksExpectationsAssess extends base_command_1.BaseCommand {
             }
             const skippedRejections = flags['include-unmet'] ? [] : rejected;
             if (ids.length === 0) {
+                if (flags.json) {
+                    this.printJsonResult({
+                        ok: true,
+                        decision: flags.decision,
+                        settled: [],
+                        failed: [],
+                        skippedUnmet: skippedRejections,
+                        attributions: [],
+                    });
+                    return;
+                }
                 if (skippedRejections.length > 0) {
                     // "Nothing is awaiting assessment" was true of what this command
                     // WOULD touch and false about the Task, which is the distinction that
@@ -168,7 +184,7 @@ class TasksExpectationsAssess extends base_command_1.BaseCommand {
                 this.log('Nothing is awaiting assessment on this Task.');
                 return;
             }
-            if (skippedRejections.length > 0) {
+            if (skippedRejections.length > 0 && !flags.json) {
                 this.log(`Skipping ${skippedRejections.length} Expectation(s) judged unmet ` +
                     `(${skippedRejections.join(', ')}) — pass --include-unmet to re-assess them.`);
             }
@@ -177,20 +193,36 @@ class TasksExpectationsAssess extends base_command_1.BaseCommand {
             // remedy is to re-run for the rest — a single rolled-up "failed" would
             // make that impossible to work out.
             const settled = [];
+            const attributions = [];
             const failed = [];
             for (const id of ids) {
                 try {
-                    await submit(id);
+                    const receipt = await submit(id);
                     settled.push(id);
+                    attributions.push({ id, attribution: (0, task_write_attribution_1.taskWriteAttribution)(receipt, 'assessedBy') });
                 }
                 catch (error) {
                     failed.push({ id, message: error?.message || 'unknown error' });
                 }
             }
             if (flags.json) {
-                return this.log(JSON.stringify({ decision: flags.decision, settled, failed }, null, 2));
+                this.printJsonResult({
+                    ok: failed.length === 0,
+                    decision: flags.decision,
+                    settled,
+                    failed,
+                    skippedUnmet: skippedRejections,
+                    attributions,
+                });
+                if (failed.length > 0)
+                    this.exit(1);
+                return;
             }
             this.log(`Recorded ${settled.length} Expectation(s) as ${flags.decision}: ${settled.join(', ')}`);
+            for (const { id, attribution } of attributions) {
+                for (const line of (0, task_write_attribution_1.attributionLines)(attribution))
+                    this.log(`${id}: ${line}`);
+            }
             for (const failure of failed)
                 this.log(`  FAILED ${failure.id}: ${failure.message}`);
             if (failed.length > 0)
@@ -204,9 +236,12 @@ class TasksExpectationsAssess extends base_command_1.BaseCommand {
         catch (error) {
             this.handleApiError(error);
         }
+        const attribution = (0, task_write_attribution_1.taskWriteAttribution)(result, 'assessedBy');
         if (flags.json)
-            return this.log(JSON.stringify(result, null, 2));
+            return this.printJsonResult({ ...result, attribution });
         this.log(`Recorded ${expectationId} as ${flags.decision}.`);
+        for (const line of (0, task_write_attribution_1.attributionLines)(attribution))
+            this.log(line);
     }
 }
 exports.default = TasksExpectationsAssess;

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

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+/** Local documentation must remain readable without credentials or a daemon. */
+export default class TasksGuide extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tasks/guide.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const task_operations_1 = require("../../lib/task-operations");
+const json_output_1 = require("../../lib/json-output");
+/** Local documentation must remain readable without credentials or a daemon. */
+class TasksGuide extends core_1.Command {
+    static description = 'Find the commands for Task planning, dependencies, preflight, execution, and results';
+    static examples = ['<%= config.bin %> tasks guide', '<%= config.bin %> tasks guide --json'];
+    static flags = { json: core_1.Flags.boolean({ description: 'Output the local operations guide as JSON' }) };
+    async run() {
+        const { flags } = await this.parse(TasksGuide);
+        if (flags.json)
+            this.log(JSON.stringify((0, json_output_1.withOk)((0, task_operations_1.taskOperationsGuide)(this.config.bin)), null, 2));
+        else
+            for (const line of (0, task_operations_1.taskOperationsGuideLines)(this.config.bin))
+                this.log(line);
+    }
+}
+exports.default = TasksGuide;

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -24,7 +25,7 @@ class TasksLabelsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
         const r = response;

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

@@ -27,6 +27,8 @@ export declare function agentSessionOpenDefault(flags: ListFlags, env?: NodeJS.P
  * Exported and pure so the wording is testable without an oclif runtime.
  */
 export declare function emptyTasksMessage(flags: ListFlags, bin?: string): string;
+/** An empty filtered page is evidence about this query, not an empty Space. */
+export declare function externalKeyPrefixWarnings(flags: ListFlags, rowCount: number): ListWarning[];
 /**
  * The NEXT column's text, computed once for the table and the `--json`
  * `nextAction` alias. `reason` is the sentence the server wrote for a person;
@@ -49,6 +51,23 @@ export declare function nextColumnWidth(rows: Array<{
  * is the one name an agent scanning 43 keys does not guess (OSK-10692).
  */
 export declare function taskRef(t: Record<string, unknown>): string;
+/** Evidence about managed execution only; unmanaged work is outside this projection. */
+export declare function taskExecution(t: Record<string, unknown>): Record<string, unknown>;
+export declare function taskPageSummary(items: Array<Record<string, unknown>>, hasMore: boolean): {
+    scope: "fetched_page";
+    taskCount: number;
+    has_more: boolean;
+    workflow: Record<string, number>;
+    assignment: {
+        assigned: number;
+        unassigned: number;
+        unknown: number;
+    };
+    readiness: Record<string, number>;
+    execution: Record<string, number>;
+    measurement: string;
+};
+export declare function taskExecutionText(t: Record<string, unknown>): string;
 /**
  * The task-list request bag is shared with import/export so every CLI list
  * surface serializes the same server-side filters. Keep user-id resolution in