@skrr-ai/cli 0.1.22 → 0.1.23

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

@@ -0,0 +1,76 @@
+"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 tasks_1 = require("../../../lib/tasks");
+const RESOURCE_ROLES = ['input', 'reference', 'evidence', 'attachment', 'deliverable'];
+class TasksResourceAdd extends base_command_1.BaseCommand {
+    static description = 'Link an exact input, reference, evidence item, attachment, or deliverable to a task';
+    static examples = [
+        '<%= config.bin %> tasks resource add <task-id> input file/pdf:brief@Drive/Briefs',
+        '<%= config.bin %> tasks resource add <task-id> evidence code:a1b2c3d@origin/main --provider github',
+    ];
+    static args = {
+        task: core_1.Args.string({ description: 'Task id or ref', required: true, ignoreStdin: true }),
+        role: core_1.Args.string({
+            description: 'How the resource relates to this task',
+            required: true,
+            options: [...RESOURCE_ROLES],
+            ignoreStdin: true,
+        }),
+        coordinate: core_1.Args.string({
+            description: '<kind>[/<format>]:<identity>[@<location>]',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        status: core_1.Flags.string({
+            options: ['unknown', 'local', 'in_review', 'available', 'unavailable', 'superseded'],
+            description: 'Observed availability. Evidence strength is recorded separately.',
+        }),
+        title: core_1.Flags.string({ description: 'Human-readable Resource name' }),
+        provider: core_1.Flags.string({ description: 'Provider, such as github or drive' }),
+        version: core_1.Flags.string({ description: 'Exact provider version, such as a full commit SHA' }),
+        'content-digest': core_1.Flags.string({ description: 'Integrity digest for this exact version' }),
+        expectation: core_1.Flags.string({ multiple: true, description: 'Expectation id this supports' }),
+        'result-id': core_1.Flags.string({ description: 'Result version this Resource supports' }),
+        'run-id': core_1.Flags.string({ description: 'Run that produced or observed it' }),
+        'idempotency-key': core_1.Flags.string({ description: 'Stable retry key' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksResourceAdd);
+        const parsed = (0, tasks_1.parseDeliverableCoordinate)(args.coordinate);
+        if (!parsed.ok)
+            this.error(parsed.error, { exit: 1 });
+        const payload = {
+            ...parsed.value,
+            role: args.role,
+            status: flags.status,
+            title: flags.title,
+            provider: flags.provider,
+            version: flags.version,
+            contentDigest: flags['content-digest'],
+            expectationIds: flags.expectation,
+            resultId: flags['result-id'],
+            runId: flags['run-id'],
+            idempotencyKey: flags['idempotency-key'] ||
+                (0, outbox_1.idempotencyKeyFor)('task-resource', args.task, JSON.stringify({ role: args.role, coordinate: parsed.value, status: flags.status })),
+        };
+        let result;
+        try {
+            result = await data_provider_1.dataService.recordTaskResource(args.task, payload);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        this.log(`Linked ${args.role} Resource ${result.link.id}: ${parsed.value.kind}:${parsed.value.identity}`);
+    }
+}
+exports.default = TasksResourceAdd;

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

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class TasksResourceList 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>;
+        role: 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/resource/list.js

@@ -0,0 +1,41 @@
+"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 RESOURCE_ROLES = ['input', 'reference', 'evidence', 'attachment', 'deliverable'];
+class TasksResourceList extends base_command_1.BaseCommand {
+    static description = 'List the exact Resources linked to a task, including their role and evidence state';
+    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' }),
+        role: core_1.Flags.string({ options: [...RESOURCE_ROLES], description: 'Only show one Task role' }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TasksResourceList);
+        const task = (0, task_resolver_1.resolveTaskIdentity)({ positionalId: args.task, flagTask: flags.task });
+        let result;
+        try {
+            result = await data_provider_1.dataService.listTaskResources(task.id, {
+                role: flags.role,
+            });
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        if (!result.data.length)
+            return this.log('No Resources linked.');
+        for (const item of result.data) {
+            this.log(`${item.linkId} · ${item.role} · ${item.title || item.identity || item.kind}\n` +
+                `  ${item.location || 'no locator'} · ${item.versionFidelity} · ${item.status} · ${item.evidenceLevel}`);
+        }
+    }
+}
+exports.default = TasksResourceList;

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

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

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

@@ -0,0 +1,46 @@
+"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 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('No Result submitted.');
+        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)}`);
+        this.log(`Review: ${review ? review.decision : 'awaiting review'}`);
+        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,59 @@
+"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' }),
+        '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/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>;