@skrr-ai/cli 0.1.108 → 0.1.110

package/dist/commands/spaces/workflows/node-types.d.ts

@@ -1,6 +1,7 @@
 import { type WorkflowNodeType } from '@skrr-ai/data-provider';
 import { BaseCommand } from '../../../base-command';
 export declare function workflowNodeTypeReference(type: WorkflowNodeType): {
+    childInput?: import("@skrr-ai/data-provider").WorkflowNodeChildInput | undefined;
     type: WorkflowNodeType;
     typeVersion: number;
     label: string;
@@ -33,6 +34,7 @@ export declare function workflowNodeTypeReference(type: WorkflowNodeType): {
     outcomes: import("@skrr-ai/data-provider").WorkflowOutcomeSpec[];
 };
 export default class SpacesWorkflowsNodeTypes extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static examples: string[];
     static args: {

package/dist/commands/spaces/workflows/node-types.js

@@ -20,15 +20,22 @@ function workflowNodeTypeReference(type) {
         label: definition.label,
         description: definition.description,
         requiredConfig: definition.requiredConfig,
-        fields: definition.fields.map((field) => ({
-            ...field,
-            path: field.name === 'join' ? 'join' : `config.${field.name}`,
-        })),
+        /*
+         * Every manifest field is a key of `node.config` — the inspector writes
+         * `config[field.name]`. A loop's or review loop's `join` field is its batch
+         * policy (`config.join: { policy, quorum }`); the node-level `join`
+         * ('all' | 'any') is a different thing, how incoming EDGES admit the node.
+         * This used to print `join` for the former, so an author following it put a
+         * policy object where only 'all' | 'any' is legal (OSK-15327).
+         */
+        fields: definition.fields.map((field) => ({ ...field, path: `config.${field.name}` })),
         defaultNode: node,
         outcomes: definition.outcomes(node),
+        ...(definition.childInput ? { childInput: definition.childInput } : {}),
     };
 }
 class SpacesWorkflowsNodeTypes extends base_command_1.BaseCommand {
+    static aliases = ['workflows:node-types'];
     static description = 'Read node config fields, defaults and review lens preset choices from the installed CLI catalog (no server requests)';
     static examples = [
         '<%= config.bin %> spaces workflows node-types',
@@ -59,7 +66,10 @@ class SpacesWorkflowsNodeTypes extends base_command_1.BaseCommand {
         const note = 'Installed CLI authoring reference. Defaults may require configuration; fill required fields and agent choices, then validate the draft against your server before publishing.';
         if (flags.json) {
             this.log(JSON.stringify({
-                object: 'workflow_node_catalog', source: 'installed_cli', note, nodeTypes: references,
+                object: 'workflow_node_catalog',
+                source: 'installed_cli',
+                note,
+                nodeTypes: references,
             }, null, 2));
             return;
         }
@@ -72,11 +82,19 @@ class SpacesWorkflowsNodeTypes extends base_command_1.BaseCommand {
             this.log(`Required config keys: ${reference.requiredConfig.join(', ') || 'none declared'}`);
             for (const field of reference.fields) {
                 const choices = field.options?.length
-                    ? ` (${field.options.map((option) => option.value).join(', ')})` : '';
+                    ? ` (${field.options.map((option) => option.value).join(', ')})`
+                    : '';
                 this.log(`  ${field.path}: ${field.label}${choices}`);
                 if (field.help)
                     this.log(`    ${field.help}`);
             }
+            this.log(`  join: how incoming edges admit this node (all | any)`);
+            if (reference.childInput) {
+                this.log(`Body input: ${reference.childInput.summary}`);
+                for (const field of reference.childInput.fields) {
+                    this.log(`  $input.${field.name}: ${field.description}`);
+                }
+            }
             this.log(`Default node: ${JSON.stringify(reference.defaultNode, null, 2)}`);
         }
         if (!args.type)

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

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../base-command';
 export default class SpacesWorkflowsPause extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -4,6 +4,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 class SpacesWorkflowsPause extends base_command_1.BaseCommand {
+    static aliases = ['workflows:pause'];
     static description = 'Pause a workflow node without cancelling its run';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),

package/dist/commands/spaces/workflows/plan/show.d.ts

@@ -1,6 +1,7 @@
 import { BaseCommand } from '../../../../base-command';
 /** Read the mutable, run-scoped plan rather than the immutable workflow version. */
 export default class SpacesWorkflowsPlanShow extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/spaces/workflows/plan/show.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../../base-command");
 /** Read the mutable, run-scoped plan rather than the immutable workflow version. */
 class SpacesWorkflowsPlanShow extends base_command_1.BaseCommand {
+    static aliases = ['workflows:plan:show'];
     static description = 'Show the mutable Run Plan for a workflow run';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),

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

@@ -7,6 +7,7 @@ export declare function buildRunPlanUpdatePayload(body: Record<string, unknown>,
     presentationRevision?: number;
 }): RunPlanPatch;
 export default class SpacesWorkflowsPlanUpdate extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -26,6 +26,7 @@ function buildRunPlanUpdatePayload(body, overrides) {
     };
 }
 class SpacesWorkflowsPlanUpdate extends base_command_1.BaseCommand {
+    static aliases = ['workflows:plan:update'];
     static description = 'Apply revision-fenced mutations to a workflow Run Plan';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),

package/dist/commands/spaces/workflows/proposals/apply.d.ts

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../../base-command';
 export default class SpacesWorkflowsProposalsApply extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/spaces/workflows/proposals/apply.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../../base-command");
 const prompt_1 = require("../../../../lib/prompt");
 class SpacesWorkflowsProposalsApply extends base_command_1.BaseCommand {
+    static aliases = ['workflows:proposals:apply'];
     static description = 'Apply a reviewed workflow proposal directly to the mutable draft';
     static args = {
         spaceId: core_1.Args.string({ required: true, ignoreStdin: true }),

package/dist/commands/spaces/workflows/proposals/confirm.d.ts

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../../base-command';
 export default class SpacesWorkflowsProposalsConfirm extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/spaces/workflows/proposals/confirm.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../../base-command");
 const prompt_1 = require("../../../../lib/prompt");
 class SpacesWorkflowsProposalsConfirm extends base_command_1.BaseCommand {
+    static aliases = ['workflows:proposals:confirm'];
     static description = 'Issue a one-time, 10-minute confirmation ID for agent-mediated proposal Apply';
     static args = {
         spaceId: core_1.Args.string({ required: true, ignoreStdin: true }),

package/dist/commands/spaces/workflows/proposals/create.d.ts

@@ -4,6 +4,7 @@ import { BaseCommand } from '../../../../base-command';
  * The API compiles it and binds it to the current semantic/layout revisions.
  */
 export default class SpacesWorkflowsProposalsCreate extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/spaces/workflows/proposals/create.js

@@ -10,6 +10,7 @@ const space_output_1 = require("../../../../lib/space-output");
  * The API compiles it and binds it to the current semantic/layout revisions.
  */
 class SpacesWorkflowsProposalsCreate extends base_command_1.BaseCommand {
+    static aliases = ['workflows:proposals:create'];
     static description = 'Create a revision-bound workflow proposal for Canvas review without changing the draft';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),

package/dist/commands/spaces/workflows/proposals/dismiss.d.ts

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../../base-command';
 export default class SpacesWorkflowsProposalsDismiss extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/spaces/workflows/proposals/dismiss.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../../base-command");
 const prompt_1 = require("../../../../lib/prompt");
 class SpacesWorkflowsProposalsDismiss extends base_command_1.BaseCommand {
+    static aliases = ['workflows:proposals:dismiss'];
     static description = 'Dismiss a workflow proposal without changing the current draft';
     static args = {
         spaceId: core_1.Args.string({ required: true, ignoreStdin: true }),

package/dist/commands/spaces/workflows/proposals/list.d.ts

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../../base-command';
 export default class SpacesWorkflowsProposalsList extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/spaces/workflows/proposals/list.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../../base-command");
 const format_1 = require("../../../../lib/format");
 class SpacesWorkflowsProposalsList extends base_command_1.BaseCommand {
+    static aliases = ['workflows:proposals:list'];
     static description = 'List reviewable workflow proposals and their revision freshness';
     static args = {
         spaceId: core_1.Args.string({ required: true, ignoreStdin: true }),

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

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../base-command';
 export default class SpacesWorkflowsPublish extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -4,7 +4,9 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const space_output_1 = require("../../../lib/space-output");
+const workflow_issues_1 = require("../../../lib/workflow-issues");
 class SpacesWorkflowsPublish extends base_command_1.BaseCommand {
+    static aliases = ['workflows:publish'];
     static description = 'Validate and publish an immutable workflow version';
     static args = {
         spaceId: core_1.Args.string({ required: true, ignoreStdin: true }),
@@ -30,6 +32,13 @@ class SpacesWorkflowsPublish extends base_command_1.BaseCommand {
         this.log(`Published workflow version ${String(version.version)} (${String(version.id)})`);
         if (decorated.url)
             this.log(`URL:  ${decorated.url}`);
+        // Published, not refused (owner decision 2026-10-15) — so the warning has to be loud here.
+        const warnings = version.warnings ?? [];
+        if (warnings.length) {
+            this.warn(`Published with ${warnings.length} warning${warnings.length === 1 ? '' : 's'} — runs of this version will hit ${warnings.length === 1 ? 'it' : 'them'}:`);
+            for (const line of (0, workflow_issues_1.formatWorkflowIssues)(warnings))
+                this.log(line);
+        }
     }
 }
 exports.default = SpacesWorkflowsPublish;

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

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../base-command';
 export default class SpacesWorkflowsReconcile extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const space_output_1 = require("../../../lib/space-output");
 class SpacesWorkflowsReconcile extends base_command_1.BaseCommand {
+    static aliases = ['workflows:reconcile'];
     static description = 'Reconcile a workflow run after a task completion or interrupted delivery';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),

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

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../base-command';
 export default class SpacesWorkflowsResume extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -4,6 +4,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 class SpacesWorkflowsResume extends base_command_1.BaseCommand {
+    static aliases = ['workflows:resume'];
     static description = 'Resume a paused workflow node';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),

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

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../../../base-command';
 export default class SpacesWorkflowsRetry extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const space_output_1 = require("../../../lib/space-output");
 class SpacesWorkflowsRetry extends base_command_1.BaseCommand {
+    static aliases = ['workflows:retry'];
     static description = 'Start a retry run from a previous workflow run';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),

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

@@ -26,6 +26,7 @@ export declare function describeLoopItemsNote(node: {
     } | null;
 }): string;
 export default class SpacesWorkflowsRun extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -8,6 +8,7 @@ const base_command_1 = require("../../../base-command");
 const format_1 = require("../../../lib/format");
 const space_output_1 = require("../../../lib/space-output");
 const workflow_run_budget_1 = require("../../../lib/workflow-run-budget");
+const workflow_run_view_1 = require("../../../lib/workflow-run-view");
 /**
  * A run node's human-facing attention note, or '' when nothing is wrong.
  *
@@ -60,6 +61,7 @@ function describeLoopItemsNote(node) {
     return '';
 }
 class SpacesWorkflowsRun extends base_command_1.BaseCommand {
+    static aliases = ['workflows:run'];
     static description = 'Inspect a workflow run and each durable node state';
     static args = {
         spaceId: core_1.Args.string({ required: true, ignoreStdin: true }),
@@ -97,26 +99,31 @@ class SpacesWorkflowsRun extends base_command_1.BaseCommand {
             this.log(line);
         if (runUrl)
             this.log(`URL: ${runUrl}`);
-        const nodes = (run.nodes || []);
+        // Graph order (the server's topological depth), not node-creation order (OSK-15325).
+        const nodes = (0, workflow_run_view_1.orderNodesByGraph)((run.nodes || []));
         if (nodes.length) {
             const rows = nodes.map((node) => ({
                 key: String(node.nodeKey ?? '-'),
                 type: String(node.nodeType ?? '-'),
                 status: String(node.status ?? '-'),
                 task: String(node.taskId ?? '-'),
-                attention: describeNodeAttention(node),
+                detail: (0, workflow_run_view_1.describeNodeDetail)(node, describeNodeAttention(node)),
             }));
             (0, format_1.renderTable)(rows, [
                 { key: 'key', header: 'NODE' },
                 { key: 'type', header: 'TYPE' },
                 { key: 'status', header: 'STATUS' },
                 { key: 'task', header: 'TASK' },
-                // Only widen to an ATTENTION column when a node actually needs eyes,
-                // so a healthy run stays a clean four-column table (OSK-4988).
-                ...(rows.some((row) => row.attention)
-                    ? [{ key: 'attention', header: 'ATTENTION' }]
-                    : []),
+                // Only widen to a DETAIL column when a node has something to say (needs eyes, is
+                // waiting on something, or is a loop with progress), so a plain run stays a clean
+                // four-column table (OSK-4988).
+                ...(rows.some((row) => row.detail) ? [{ key: 'detail', header: 'DETAIL' }] : []),
             ], (line) => this.log(line));
+            for (const line of (0, workflow_run_view_1.describePartialOutcomes)(nodes))
+                this.log(line);
+            for (const line of (0, workflow_run_view_1.describeSignalHints)(args.spaceId, args.runId, nodes, this.config.bin)) {
+                this.log(line);
+            }
             for (const node of nodes) {
                 const note = describeLoopItemsNote(node);
                 if (note)

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

@@ -19,6 +19,7 @@ export declare const WORKFLOW_RUNS_COLUMNS: Array<{
     maxWidth?: number;
 }>;
 export default class SpacesWorkflowsRuns extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -22,6 +22,7 @@ exports.WORKFLOW_RUNS_COLUMNS = [
     { key: 'id', header: 'RUN ID' },
 ];
 class SpacesWorkflowsRuns extends base_command_1.BaseCommand {
+    static aliases = ['workflows:runs'];
     static description = 'List recent workflow runs in a space';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),

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

@@ -1,6 +1,31 @@
+import { type WorkflowDefinition, type WorkflowVersion } from '@skrr-ai/data-provider';
 import { BaseCommand } from '../../../base-command';
+/**
+ * Which run duration limit applies, and which only sits in the draft.
+ *
+ * Publish freezes `maxDurationMs` ON the version; the definition's top-level
+ * `maxDurationMs` is the head (draft) value and reaches runs only at the next
+ * publish. `show` printed neither, and its JSON carried only the draft value at
+ * the top level, so an unpublished edit read as the live limit (OSK-15335).
+ * `null` is "no limit", a decision as real as a number.
+ */
+export declare function workflowRunLimits(workflow: Pick<WorkflowDefinition, 'maxDurationMs' | 'publishedVersionId' | 'currentVersion'> & {
+    versions?: Array<Pick<WorkflowVersion, 'id' | 'version' | 'maxDurationMs'>>;
+}): {
+    published: {
+        versionId: string;
+        version: number;
+        maxDurationMs: number | null;
+    } | null;
+    draft: {
+        maxDurationMs: number | null;
+        /** True when publishing would change the limit the next start gets. */
+        unpublishedChange: boolean;
+    };
+};
 /** Show a definition and its immutable published versions. */
 export default class SpacesWorkflowsShow extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -1,11 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.workflowRunLimits = workflowRunLimits;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const space_output_1 = require("../../../lib/space-output");
+/**
+ * Which run duration limit applies, and which only sits in the draft.
+ *
+ * Publish freezes `maxDurationMs` ON the version; the definition's top-level
+ * `maxDurationMs` is the head (draft) value and reaches runs only at the next
+ * publish. `show` printed neither, and its JSON carried only the draft value at
+ * the top level, so an unpublished edit read as the live limit (OSK-15335).
+ * `null` is "no limit", a decision as real as a number.
+ */
+function workflowRunLimits(workflow) {
+    const published = workflow.publishedVersionId
+        ? (workflow.versions ?? []).find((version) => version.id === workflow.publishedVersionId)
+        : undefined;
+    const draftMs = workflow.maxDurationMs ?? null;
+    const publishedMs = published ? (published.maxDurationMs ?? null) : null;
+    return {
+        published: published
+            ? { versionId: published.id, version: published.version, maxDurationMs: publishedMs }
+            : null,
+        draft: {
+            maxDurationMs: draftMs,
+            /** True when publishing would change the limit the next start gets. */
+            unpublishedChange: published ? draftMs !== publishedMs : draftMs !== null,
+        },
+    };
+}
+function describeLimit(ms) {
+    return ms === null ? 'no run limit' : `run limit ${(0, data_provider_1.describeWorkflowDuration)(ms)}`;
+}
 /** Show a definition and its immutable published versions. */
 class SpacesWorkflowsShow extends base_command_1.BaseCommand {
+    static aliases = ['workflows:show'];
     static description = 'Show a workflow definition, draft revisions, and published versions';
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),
@@ -27,15 +58,22 @@ class SpacesWorkflowsShow extends base_command_1.BaseCommand {
             this.handleApiError(error);
             return;
         }
+        const runLimits = workflowRunLimits(workflow);
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withWorkflowUrl)(this.cliConfig.baseURL, args.spaceId, workflow, {
-                workflowId: args.workflowId,
-            }), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withWorkflowUrl)(this.cliConfig.baseURL, args.spaceId, { ...workflow, runLimits }, { workflowId: args.workflowId }), null, 2));
             return;
         }
         this.log(`ID:                  ${workflow.id}`);
         this.log(`Title:               ${workflow.title}`);
-        this.log(`Published version:   ${workflow.currentVersion || 'not published'}`);
+        if (runLimits.published) {
+            this.log(`Published version:   ${runLimits.published.version} (${describeLimit(runLimits.published.maxDurationMs)}; the next start gets this)`);
+        }
+        else {
+            this.log(`Published version:   ${workflow.currentVersion || 'not published'}`);
+        }
+        if (runLimits.draft.unpublishedChange) {
+            this.log(`Draft run limit:     ${describeLimit(runLimits.draft.maxDurationMs)} — not published yet; publish to apply it`);
+        }
         this.log(`Semantic revision:   ${workflow.draft.semanticRevision}`);
         this.log(`Presentation revision:${workflow.draft.presentationRevision}`);
         this.log(`Versions:            ${workflow.versions.length}`);

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

@@ -1,7 +1,19 @@
 import { BaseCommand } from '../../../base-command';
+/**
+ * The lines after a signal landed. "run X is succeeded" alone hid a loop item that failed in a
+ * run that nonetheless succeeded (OSK-15325), and said nothing about what the run waits on next.
+ */
+export declare function describeSignalResult(spaceId: string, runId: string, nodeKey: string, outcome: string, run: {
+    id?: string;
+    status?: string;
+    nodes?: unknown[];
+} | undefined, bin?: string): string[];
 export declare function parseSignalPayload(value: string | undefined): unknown;
 export default class SpacesWorkflowsSignal extends BaseCommand {
+    static aliases: string[];
+    static summary: string;
     static description: string;
+    static examples: string[];
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
         runId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -1,11 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeSignalResult = describeSignalResult;
 exports.parseSignalPayload = parseSignalPayload;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const prompt_1 = require("../../../lib/prompt");
 const space_output_1 = require("../../../lib/space-output");
+const workflow_run_view_1 = require("../../../lib/workflow-run-view");
+/**
+ * The lines after a signal landed. "run X is succeeded" alone hid a loop item that failed in a
+ * run that nonetheless succeeded (OSK-15325), and said nothing about what the run waits on next.
+ */
+function describeSignalResult(spaceId, runId, nodeKey, outcome, run, bin = 'skrr') {
+    const id = run?.id ?? runId;
+    const lines = [`Signalled ${nodeKey} with ${outcome}; run ${id} is ${run?.status ?? 'updated'}.`];
+    const nodes = (0, workflow_run_view_1.orderNodesByGraph)((run?.nodes ?? []));
+    lines.push(...(0, workflow_run_view_1.describePartialOutcomes)(nodes));
+    lines.push(...(0, workflow_run_view_1.describeSignalHints)(spaceId, id, nodes, bin));
+    return lines;
+}
 const OUTCOMES = ['success', 'failure', 'true', 'false'];
 function parseSignalPayload(value) {
     if (value === undefined)
@@ -18,7 +32,29 @@ function parseSignalPayload(value) {
     }
 }
 class SpacesWorkflowsSignal extends base_command_1.BaseCommand {
-    static description = 'Resolve a waiting approval or event node in a workflow run';
+    static aliases = ['workflows:signal'];
+    static summary = 'Resolve a waiting approval or event node in a workflow run';
+    /*
+     * The two ways to resolve a wait live under different topics — a person
+     * signals here, a machine event resolves through a `workflow_signal`
+     * trigger — and neither help pointed at the other (OSK-15315).
+     */
+    static description = [
+        'Needs Space edit access; a token with edit access may call the same signal API.',
+        'The event key a node waits on describes the wait and does not itself authorize a signal.',
+        '',
+        'To let a machine event resolve an event wait instead, author a workflow_signal trigger on the Space:',
+        '  skrr triggers create --scope space_oracle --ref spaceId=<space-id> --kind event \\',
+        '    --entity <entity> --event <event> --mode workflow_signal --workflow-event-key <key>',
+        'It resolves only event waits parked on exactly that key, never an approval.',
+        '',
+        'A node that was already resolved, is not waiting yet, or waits on its own work (a loop, a',
+        'child run, a Task) is refused with what the run found, and nothing changes.',
+    ].join('\n');
+    static examples = [
+        '<%= config.bin %> workflows signal <space-id> <run-id> approval_1 --outcome success',
+        '<%= config.bin %> workflows signal <space-id> <run-id> wait_event_1 --payload \'{"approved":true}\'',
+    ];
     static args = {
         spaceId: core_1.Args.string({ description: 'Owning Space ID', required: true, ignoreStdin: true }),
         runId: core_1.Args.string({ description: 'Workflow run ID', required: true, ignoreStdin: true }),
@@ -70,7 +106,9 @@ class SpacesWorkflowsSignal extends base_command_1.BaseCommand {
             return;
         }
         const run = result.run;
-        this.log(`Signalled ${args.nodeKey} with ${flags.outcome}; run ${run?.id ?? args.runId} is ${run?.status ?? 'updated'}.`);
+        for (const line of describeSignalResult(args.spaceId, args.runId, args.nodeKey, String(flags.outcome), run, this.config.bin)) {
+            this.log(line);
+        }
     }
 }
 exports.default = SpacesWorkflowsSignal;

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

@@ -17,6 +17,7 @@ export declare function formatStartedRunLine(result: {
     };
 }): string;
 export default class SpacesWorkflowsStart extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

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

@@ -21,6 +21,7 @@ function formatStartedRunLine(result) {
     return `${verb} workflow run ${result.run.id} (${result.run.status})${version}`;
 }
 class SpacesWorkflowsStart extends base_command_1.BaseCommand {
+    static aliases = ['workflows:start'];
     static description = 'Start a durable run of a published workflow';
     static args = {
         spaceId: core_1.Args.string({ required: true, ignoreStdin: true }),
@@ -79,8 +80,10 @@ class SpacesWorkflowsStart extends base_command_1.BaseCommand {
             return;
         }
         const decorated = (0, space_output_1.withWorkflowUrl)(this.cliConfig.baseURL, args.spaceId, result, { workflowId: args.workflowId, runId: result.run.id });
+        // The id this command created, at the top where a script looks for it, instead of only
+        // inside `run` (OSK-16494). The nested run is unchanged.
         if (flags.json)
-            return this.log(JSON.stringify(decorated, null, 2));
+            return this.log(JSON.stringify({ runId: result.run.id, status: result.run.status, ...decorated }, null, 2));
         this.log(formatStartedRunLine(result));
         // The run someone just started is the one they most want to watch, so the
         // link comes before the command that prints the same thing as text.

package/dist/commands/spaces/workflows/task-execution/create.d.ts

@@ -1,6 +1,7 @@
 import { BaseCommand } from '../../../../base-command';
 /** Compile existing Space Tasks into one durable, observable execution run. */
 export default class SpacesWorkflowsTaskExecutionCreate extends BaseCommand {
+    static aliases: string[];
     static description: string;
     static args: {
         spaceId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/spaces/workflows/task-execution/create.js

@@ -6,6 +6,7 @@ const base_command_1 = require("../../../../base-command");
 const space_output_1 = require("../../../../lib/space-output");
 /** Compile existing Space Tasks into one durable, observable execution run. */
 class SpacesWorkflowsTaskExecutionCreate extends base_command_1.BaseCommand {
+    static aliases = ['workflows:task-execution:create'];
     static description = 'Create and start an execution workflow over existing Space Tasks';
     static args = {
         spaceId: core_1.Args.string({ required: true, ignoreStdin: true }),