@skrr-ai/cli 0.1.22 → 0.1.24

package/dist/commands/tasks/result/show.js

@@ -0,0 +1,64 @@
+"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");
+const task_legacy_1 = require("../../../lib/task-legacy");
+class TasksResultShow extends base_command_1.BaseCommand {
+    static description = 'Show the current Task Result and its exact Review';
+    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' }),
+        history: core_1.Flags.boolean({ description: 'Include superseded Result versions' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksResultShow);
+        const task = (0, task_resolver_1.resolveTaskIdentity)({ positionalId: args.task, flagTask: flags.task });
+        let result;
+        try {
+            result = await data_provider_1.dataService.listTaskResults(task.id, { includeSuperseded: flags.history });
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        const current = result.results.find((row) => row.id === result.currentResultId);
+        if (!current)
+            return this.log(await (0, task_legacy_1.emptyCanonicalView)(task.id, 'Result'));
+        const review = result.reviews.find((row) => row.resultId === current.id);
+        this.log(`Result v${current.version}\n${current.summary}`);
+        if (current.conclusion)
+            this.log(`Conclusion (${current.conclusion.type}): ${JSON.stringify(current.conclusion.value)}`);
+        // Only "awaiting" while a review can still be recorded. A closed Task
+        // refuses one outright (`TASK_REOPEN_REQUIRED`), so the old wording named a
+        // state nothing could ever leave — and a reader could not tell it from a
+        // review that is genuinely pending. The extra read happens only on the
+        // no-review path, where the distinction is the whole point.
+        let reviewLine = 'awaiting review';
+        if (review) {
+            reviewLine = review.decision;
+        }
+        else {
+            const full = (await data_provider_1.dataService
+                .getTask(task.id, { enrich: false })
+                .catch(() => undefined));
+            if (['completed', 'cancelled'].includes(String(full?.statusType ?? ''))) {
+                reviewLine = 'none recorded — the Task is closed';
+            }
+        }
+        this.log(`Review: ${reviewLine}`);
+        if (flags.history && result.results.length > 1) {
+            this.log(`Superseded versions: ${result.results
+                .slice(1)
+                .map((row) => `v${row.version}`)
+                .join(', ')}`);
+        }
+    }
+}
+exports.default = TasksResultShow;

package/dist/commands/tasks/result/submit.d.ts

@@ -0,0 +1,26 @@
+import { BaseCommand } from '../../../base-command';
+export default class TasksResultSubmit extends BaseCommand {
+    static description: string;
+    static examples: 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>;
+        summary: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        body: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'conclusion-type': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'conclusion-json': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'structured-schema': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'structured-json': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        deliverable: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        evidence: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        remaining: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'run-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'source-run': 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>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tasks/result/submit.js

@@ -0,0 +1,134 @@
+"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 outbox_1 = require("../../../lib/outbox");
+const task_resolver_1 = require("../../../lib/task-resolver");
+const web_url_1 = require("../../../lib/web-url");
+const api_fetch_1 = require("../../../lib/api-fetch");
+const session_task_endpoints_1 = require("../../../lib/session-task-endpoints");
+function parseJson(value, label) {
+    if (!value)
+        return undefined;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new Error(`${label} must be valid JSON`);
+    }
+}
+class TasksResultSubmit extends base_command_1.BaseCommand {
+    static description = 'Submit the Task Result; this does not self-accept it or turn a domain conclusion into a Review';
+    static examples = [
+        '<%= config.bin %> tasks result submit <task> --summary "NO-SHIP until Gates A-D pass" --conclusion-type release_recommendation --conclusion-json \'{"posture":"no_ship"}\'',
+    ];
+    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' }),
+        summary: core_1.Flags.string({ required: true, description: 'The answer in one readable paragraph' }),
+        body: core_1.Flags.string({ description: 'Long-form Result body' }),
+        'conclusion-type': core_1.Flags.string({ description: 'Domain conclusion type' }),
+        'conclusion-json': core_1.Flags.string({ description: 'JSON value for the domain conclusion' }),
+        'structured-schema': core_1.Flags.string({ description: 'Schema name for --structured-json' }),
+        'structured-json': core_1.Flags.string({ description: 'Task-type-specific structured Result JSON' }),
+        deliverable: core_1.Flags.string({
+            multiple: true,
+            description: 'Task Resource link id (repeatable)',
+        }),
+        evidence: core_1.Flags.string({
+            multiple: true,
+            description: 'Evidence reference as <kind>:<id-or-uri>',
+        }),
+        remaining: core_1.Flags.string({ multiple: true, description: 'Remaining work item (repeatable)' }),
+        'run-id': core_1.Flags.string({ description: 'Canonical Task Run that produced this Result' }),
+        'source-run': core_1.Flags.string({ multiple: true, description: 'Contributing Run id (repeatable)' }),
+        'spec-version': core_1.Flags.integer({
+            description: 'Task specification version this Result answers',
+        }),
+        'idempotency-key': core_1.Flags.string({ description: 'Stable retry key for this exact Result' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksResultSubmit);
+        const task = (0, task_resolver_1.resolveTaskIdentity)({ positionalId: args.task, flagTask: flags.task });
+        if (Boolean(flags['conclusion-type']) !== Boolean(flags['conclusion-json'])) {
+            this.error('--conclusion-type and --conclusion-json must be supplied together', { exit: 1 });
+        }
+        if (Boolean(flags['structured-schema']) !== Boolean(flags['structured-json'])) {
+            this.error('--structured-schema and --structured-json must be supplied together', {
+                exit: 1,
+            });
+        }
+        let conclusionValue;
+        let structuredValue;
+        try {
+            conclusionValue = parseJson(flags['conclusion-json'], '--conclusion-json');
+            structuredValue = parseJson(flags['structured-json'], '--structured-json');
+        }
+        catch (error) {
+            this.error(error.message, { exit: 1 });
+        }
+        if (structuredValue &&
+            (typeof structuredValue !== 'object' || Array.isArray(structuredValue))) {
+            this.error('--structured-json must contain a JSON object', { exit: 1 });
+        }
+        const evidenceRefs = (flags.evidence || []).map((raw) => {
+            const split = raw.indexOf(':');
+            if (split < 1)
+                this.error('--evidence must be <kind>:<id-or-uri>', { exit: 1 });
+            const kind = raw.slice(0, split);
+            const value = raw.slice(split + 1);
+            return /^https?:|^file:/.test(value) ? { kind, uri: value } : { kind, id: value };
+        });
+        const payload = {
+            summary: flags.summary,
+            body: flags.body,
+            expectedSpecVersion: flags['spec-version'],
+            runId: flags['run-id'],
+            sourceRunIds: flags['source-run'],
+            resourceLinkIds: flags.deliverable,
+            evidenceRefs,
+            remainingWork: (flags.remaining || []).map((summary) => ({ summary })),
+            ...(flags['conclusion-type']
+                ? { conclusion: { type: flags['conclusion-type'], value: conclusionValue } }
+                : {}),
+            ...(flags['structured-schema']
+                ? {
+                    structuredContent: {
+                        schema: flags['structured-schema'],
+                        value: structuredValue,
+                    },
+                }
+                : {}),
+        };
+        let result;
+        try {
+            const data = {
+                ...payload,
+                idempotencyKey: flags['idempotency-key'] ||
+                    (0, outbox_1.idempotencyKeyFor)('task-result', task.id, JSON.stringify(payload)),
+            };
+            const sessionPath = await (0, session_task_endpoints_1.sessionScopedTaskPath)('result');
+            result = sessionPath
+                ? await (0, api_fetch_1.apiFetch)(sessionPath, {
+                    method: 'POST',
+                    body: data,
+                })
+                : await data_provider_1.dataService.submitTaskResult({ taskId: task.id, data });
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        const url = (0, web_url_1.taskUrlFrom)(this.cliConfig.baseURL, { id: task.id });
+        if (flags.json)
+            return this.log(JSON.stringify({ ...result, url }, null, 2));
+        this.log(`Submitted Result v${result.result.version} for ${task.id}; it is ready for review.`);
+        if (url)
+            this.log(`Task: ${url}`);
+    }
+}
+exports.default = TasksResultSubmit;

package/dist/commands/tasks/resume/save.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../../base-command';
+export default class TasksResumeSave 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>;
+        'run-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        snapshot: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'spec-version': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tasks/resume/save.js

@@ -0,0 +1,69 @@
+"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 outbox_1 = require("../../../lib/outbox");
+const task_resolver_1 = require("../../../lib/task-resolver");
+const api_fetch_1 = require("../../../lib/api-fetch");
+const session_task_endpoints_1 = require("../../../lib/session-task-endpoints");
+class TasksResumeSave extends base_command_1.BaseCommand {
+    static description = 'Save recovery state without publishing a visible Task Update';
+    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' }),
+        'run-id': core_1.Flags.string({ required: true, description: 'Canonical Task Run' }),
+        snapshot: core_1.Flags.string({
+            required: true,
+            description: 'Resume Point JSON snapshot. ' +
+                'Every field is optional. `completed`, `nextActions` and `currentFocus` accept either a ' +
+                'plain sentence or {summary,sourceRefs} — the object form is canonical and a bare string ' +
+                'is lifted into it, so the same sentence you put in an Update’s nextActions works here ' +
+                'unchanged. Shape: {completed:[], currentFocus, nextActions:[], ' +
+                'openQuestions:[{question,sourceRef?}], relevantUpdateIds:[], evidenceRefs:[], ' +
+                'deliverableRefs:[], childHeads:[{runId,resumePointId,status}], workspaceStateRef}. ' +
+                'Never put a credential, token or lease in a snapshot — the server refuses one.',
+        }),
+        'spec-version': core_1.Flags.integer({ description: 'Task specification version' }),
+        'idempotency-key': core_1.Flags.string({ description: 'Stable retry key' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksResumeSave);
+        const task = (0, task_resolver_1.resolveTaskIdentity)({ positionalId: args.task, flagTask: flags.task });
+        let resume;
+        try {
+            resume = JSON.parse(flags.snapshot);
+        }
+        catch {
+            this.error('--snapshot must be a JSON object', { exit: 1 });
+        }
+        let result;
+        try {
+            const payload = {
+                runId: flags['run-id'],
+                expectedSpecVersion: flags['spec-version'],
+                resume: resume,
+                idempotencyKey: flags['idempotency-key'] ||
+                    (0, outbox_1.idempotencyKeyFor)('task-resume', task.id, JSON.stringify(resume)),
+            };
+            const sessionPath = await (0, session_task_endpoints_1.sessionScopedTaskPath)('resume');
+            result = sessionPath
+                ? await (0, api_fetch_1.apiFetch)(sessionPath, {
+                    method: 'POST',
+                    body: payload,
+                })
+                : await data_provider_1.dataService.saveTaskResumePoint({ taskId: task.id, data: payload });
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        this.log(`Saved Resume Point ${result.resumePoint.id} for Run ${flags['run-id']}.`);
+    }
+}
+exports.default = TasksResumeSave;

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

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class TasksResumeShow 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>;
+        'run-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tasks/resume/show.js

@@ -0,0 +1,35 @@
+"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");
+const api_fetch_1 = require("../../../lib/api-fetch");
+const session_task_endpoints_1 = require("../../../lib/session-task-endpoints");
+class TasksResumeShow extends base_command_1.BaseCommand {
+    static description = 'Build the bounded context needed to resume one Task Run';
+    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' }),
+        'run-id': core_1.Flags.string({ required: true, description: 'Canonical Task Run' }),
+        json: core_1.Flags.boolean({ default: true, description: 'Output the Resume Context as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksResumeShow);
+        const task = (0, task_resolver_1.resolveTaskIdentity)({ positionalId: args.task, flagTask: flags.task });
+        try {
+            const sessionPath = await (0, session_task_endpoints_1.sessionScopedTaskPath)('resumeRead');
+            const result = sessionPath
+                ? await (0, api_fetch_1.apiFetch)(sessionPath, { method: 'GET' })
+                : await data_provider_1.dataService.getTaskResumeContext(task.id, flags['run-id']);
+            this.log(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = TasksResumeShow;

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

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../base-command';
+export default class TasksReview 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>;
+        'result-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        decision: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        rationale: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'run-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tasks/review.js

@@ -0,0 +1,54 @@
+"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 outbox_1 = require("../../lib/outbox");
+const task_resolver_1 = require("../../lib/task-resolver");
+const api_fetch_1 = require("../../lib/api-fetch");
+const session_task_endpoints_1 = require("../../lib/session-task-endpoints");
+class TasksReview extends base_command_1.BaseCommand {
+    static description = 'Accept or request changes on one exact Task Result';
+    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' }),
+        'result-id': core_1.Flags.string({ required: true, description: 'Exact Result version id' }),
+        decision: core_1.Flags.string({ required: true, options: ['accepted', 'changes_requested'] }),
+        rationale: core_1.Flags.string({ description: 'Why this Result was accepted or needs changes' }),
+        'run-id': core_1.Flags.string({ description: 'Canonical reviewer Run for a generic API call' }),
+        'idempotency-key': core_1.Flags.string({ description: 'Stable retry key' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksReview);
+        const task = (0, task_resolver_1.resolveTaskIdentity)({ positionalId: args.task, flagTask: flags.task });
+        const payload = {
+            resultId: flags['result-id'],
+            runId: flags['run-id'],
+            decision: flags.decision,
+            rationale: flags.rationale,
+        };
+        let result;
+        try {
+            const data = {
+                ...payload,
+                idempotencyKey: flags['idempotency-key'] ||
+                    (0, outbox_1.idempotencyKeyFor)('task-review', task.id, JSON.stringify(payload)),
+            };
+            const sessionPath = await (0, session_task_endpoints_1.sessionScopedTaskPath)('review');
+            result = sessionPath
+                ? await (0, api_fetch_1.apiFetch)(sessionPath, { method: 'POST', body: data })
+                : await data_provider_1.dataService.reviewTaskResult({ taskId: task.id, data });
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        this.log(`Recorded Review: ${flags.decision} for Result ${flags['result-id']}.`);
+    }
+}
+exports.default = TasksReview;

package/dist/commands/tasks/runs.js

@@ -23,6 +23,11 @@ function formatTime(value) {
  * daemon id was not recorded). `-` when the row predates executor stamping.
  */
 function formatRunExecutor(run) {
+    const executor = run.executor;
+    if (executor?.kind === 'agent' && typeof executor.agentId === 'string') {
+        const release = typeof executor.agentReleaseId === 'string' ? ` @ ${executor.agentReleaseId}` : '';
+        return `Agent ${executor.agentId}${release}`;
+    }
     const daemonId = run.daemonId;
     if (typeof daemonId === 'string' && daemonId.trim() !== '') {
         return `daemon ${daemonId}`;

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

@@ -31,10 +31,13 @@ class TasksSelfSchedule extends base_command_1.BaseCommand {
         at: core_1.Flags.string({ description: 'Absolute return time (ISO-8601 UTC)' }),
         in: core_1.Flags.string({ description: 'Relative return time such as 90m, 2h, 3d' }),
         note: core_1.Flags.string({
-            // Was "handed to the agent as the return prompt", which is not true:
-            // `task_execute` builds the run's prompt from the Task, so this string is
-            // recorded and never read by the run. See `TaskScheduler/selfSchedule.js`.
-            description: 'Why you are coming back — recorded on the return for you to read back',
+            // This DOES reach the run now. It is read by `buildTaskExecutionPrompt`,
+            // the one place every dispatch path assembles a task prompt, and rendered
+            // as `### Why You Parked This Task` alongside the instant it was parked
+            // for. For a while it was recorded and never delivered, and the help said
+            // so; both halves are fixed rather than only the sentence.
+            description: 'Why you are coming back. Delivered to the agent on the return as its own ' +
+                'prompt section, and readable any time with --show',
         }),
         'max-per-day': core_1.Flags.integer({
             description: 'Cap on self-initiated returns per day (1-24, default 4)',

package/dist/commands/tasks/show.js

@@ -262,6 +262,25 @@ class TasksShow extends base_command_1.BaseCommand {
             this.log(`Created:     ${formatTime(t.createdAt)}`);
         if (t.updatedAt)
             this.log(`Updated:     ${formatTime(t.updatedAt)}`);
+        /**
+         * Say which Task model this row belongs to, on the one surface everybody
+         * reads first.
+         *
+         * Canonical Task Model v1 deliberately migrated nothing, so a Task created
+         * before it is a second class of object with visibly different behaviour —
+         * no Updates, no Result, no Activity, no timeline. The only marker was
+         * `specVersion` being ABSENT under `--json`, and absence-as-a-marker is not
+         * something a reader can notice: you have to already know the field exists
+         * to observe that it does not. So `tasks show` said nothing, and the user
+         * found out by watching four other commands report emptiness about a Task
+         * with years of history.
+         *
+         * Printed only for the legacy class. A canonical Task needs no line saying
+         * it is ordinary.
+         */
+        if (t.specVersion === undefined || t.specVersion === null) {
+            this.log('Model:       predates the canonical Task model — no Result, Updates, Activity or timeline');
+        }
         if (t.description) {
             this.log('');
             this.log('Description:');

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

@@ -15,8 +15,8 @@ export default class TasksTimeline extends BaseCommand {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
         cursor: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        kind: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        run: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        type: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        execution: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         actor: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/tasks/timeline.js

@@ -5,7 +5,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
-const tasks_1 = require("../../lib/tasks");
+const task_legacy_1 = require("../../lib/task-legacy");
 /**
  * `<action> (<k=v ...>)`, or just the preview when there is nothing to add.
  *
@@ -14,11 +14,11 @@ const tasks_1 = require("../../lib/tasks");
  */
 function withDetails(item) {
     const preview = String(item.preview ?? '-');
-    const details = (0, format_1.formatCell)(item.details, '');
+    const details = (0, format_1.formatCell)(item.data ?? item.details, '');
     return details ? `${preview} (${details})` : preview;
 }
 class TasksTimeline extends base_command_1.BaseCommand {
-    static description = 'Show the unified task timeline: work log, comments, lifecycle, and execution';
+    static description = 'Show the immutable multi-actor Task Activity timeline';
     static args = {
         id: core_1.Args.string({ description: 'Task ID', required: true, ignoreStdin: true }),
     };
@@ -26,16 +26,9 @@ class TasksTimeline extends base_command_1.BaseCommand {
         json: core_1.Flags.boolean({ description: 'Output JSON' }),
         limit: core_1.Flags.integer({ default: 50 }),
         cursor: core_1.Flags.string(),
-        // `--kind` names a typed WORK-EVENT kind, not one of the timeline's four
-        // sources. Undeclared and undescribed, it read like a source filter and
-        // silently accepted anything; the server now refuses an unknown kind, and
-        // declaring the options here refuses a typo before it costs a round trip.
-        kind: core_1.Flags.string({
-            description: 'Show only work events of this kind (excludes comments, lifecycle, execution)',
-            options: [...tasks_1.TASK_WORK_EVENT_KINDS],
-        }),
-        run: core_1.Flags.string(),
-        actor: core_1.Flags.string({ options: ['user', 'agent', 'system'] }),
+        type: core_1.Flags.string({ description: 'Exact Activity event type, e.g. task.result.submitted' }),
+        execution: core_1.Flags.string({ description: 'Bounded Task execution id' }),
+        actor: core_1.Flags.string({ options: ['human', 'agent', 'system', 'integration'] }),
     };
     async run() {
         this.requireAuth();
@@ -45,8 +38,8 @@ class TasksTimeline extends base_command_1.BaseCommand {
             result = await data_provider_1.dataService.getTaskTimeline(args.id, {
                 limit: flags.limit,
                 cursor: flags.cursor,
-                kind: flags.kind,
-                runId: flags.run,
+                type: flags.type,
+                executionId: flags.execution,
                 actor: flags.actor,
             });
         }
@@ -57,16 +50,18 @@ class TasksTimeline extends base_command_1.BaseCommand {
             this.log(JSON.stringify(result, null, 2));
             return;
         }
-        (0, format_1.renderTable)((result.data ?? []).map((item) => ({
+        const rows = result.data ?? [];
+        if (rows.length === 0) {
+            // `renderTable([])` prints NOTHING — no header, no empty state, exit 0 —
+            // which is indistinguishable from a broken command. Say what happened.
+            this.log(await (0, task_legacy_1.emptyCanonicalView)(args.id, 'timeline entries'));
+            return;
+        }
+        (0, format_1.renderTable)(rows.map((item) => ({
             time: String(item.occurredAt ?? '-')
                 .replace('T', ' ')
                 .slice(0, 19),
-            // A work event's own kind is the thing you came to see. Showing the
-            // source alone collapsed blocker, decision, checkpoint and evidence
-            // into one indistinguishable `work_event`.
-            source: item.eventKind
-                ? `${String(item.kind ?? '-')}:${String(item.eventKind)}`
-                : String(item.kind ?? '-'),
+            source: String(item.type ?? '-'),
             actor: String(item.actor?.kind ?? '-'),
             // A lifecycle row's preview is the bare action, so `status_changed`
             // appeared three times in a row without ever naming a status. The
@@ -75,13 +70,13 @@ class TasksTimeline extends base_command_1.BaseCommand {
             // substituted: the action is still what happened, `details` is what
             // it happened to.
             detail: (0, format_1.truncate)(withDetails(item), 90),
-            run: String(item.runId ?? '-'),
+            run: String(item.executionId ?? '-'),
         })), [
             { key: 'time', header: 'TIME' },
             { key: 'source', header: 'SOURCE' },
             { key: 'actor', header: 'ACTOR' },
             { key: 'detail', header: 'DETAIL', maxWidth: 90 },
-            { key: 'run', header: 'RUN', maxWidth: 24 },
+            { key: 'run', header: 'EXECUTION', maxWidth: 24 },
         ], (line) => this.log(line));
         if (result.next_cursor)
             this.log(`Next page: --cursor ${result.next_cursor}`);

package/dist/commands/tasks/updates/add.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../../base-command';
+export default class TasksUpdatesAdd extends BaseCommand {
+    static description: string;
+    static examples: 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>;
+        type: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        summary: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        data: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        resume: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'run-id': 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>;
+        supersedes: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        reference: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}