@skrr-ai/cli 0.1.99 → 0.1.100

package/dist/commands/commitments/preflight.js

@@ -45,6 +45,26 @@ function preflightGateLines(gate, verbose = false) {
     if (hasNote) {
         lines.push(`        ${String(note).trim()}`);
     }
+    if (gate.id === 'owner_rules') {
+        const status = gate.detail?.status;
+        const count = gate.detail?.activeRules;
+        if (status === 'not_bound') {
+            lines.push('        Owner rules: no Compass bound.');
+        }
+        else if (status === 'unreadable') {
+            lines.push('        Active owner rules: unknown (Compass unreadable).');
+        }
+        else if (status === 'invalid') {
+            lines.push('        Active owner rules: unknown (stored rules invalid).');
+        }
+        else if (status === 'available' && typeof count === 'number' &&
+            Number.isSafeInteger(count) && count >= 0) {
+            lines.push(`        Active owner rules: ${count}${count === 0 ? ' (no active rules configured)' : ''}.`);
+        }
+        else {
+            lines.push('        Active owner rules: unknown (count not reported).');
+        }
+    }
     // `detail.hint` is the actionable plain-words sentence — why the gate is
     // capped and the exact command to lift it. It lived only in --json, so the
     // human view printed the machine code (`autonomy_capped_by_initiative_policy`)

package/dist/commands/memory/mounts/resolve.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
 class MemoryMountsResolve extends scoped_memory_command_1.ScopedMemoryCommand {
-    static description = 'Resolve the ACL-aware Memory mounts for an Agent session';
+    static description = 'Resolve ACL-aware Memory mounts; discovery may initialize default Store metadata';
     static flags = {
         agent: core_1.Flags.string({ required: true }),
         space: core_1.Flags.string({ description: 'Current Space context' }),
@@ -13,9 +13,15 @@ class MemoryMountsResolve extends scoped_memory_command_1.ScopedMemoryCommand {
         this.requireAuth();
         const { flags } = await this.parse(MemoryMountsResolve);
         const response = await this.memoryApi(flags.agent, `/mounts${this.query(flags)}`);
-        const result = { mounts: response.mounts.map(scoped_memory_command_1.parseMemoryMount) };
+        const storeResolutions = (0, scoped_memory_command_1.parseMemoryStoreResolutions)(response.storeResolutions);
+        const result = {
+            mounts: response.mounts.map(scoped_memory_command_1.parseMemoryMount),
+            ...(storeResolutions !== undefined ? { storeResolutions } : {}),
+        };
         if (flags.json)
             return this.log(JSON.stringify(result, null, 2));
+        for (const line of (0, scoped_memory_command_1.memoryStoreResolutionLines)(storeResolutions))
+            this.log(line);
         for (const mount of result.mounts) {
             this.log(`${mount.source}  ${mount.uri}  ${mount.access}  store=${mount.storeId}  r${mount.storeRevision}  cursor=${mount.cursor}`);
         }

package/dist/commands/memory/stores/list.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
 class MemoryStoresList extends scoped_memory_command_1.ScopedMemoryCommand {
-    static description = 'List Memory Stores mounted for an Agent session';
+    static description = 'List mounted Memory Stores; discovery may initialize default Store metadata';
     static flags = {
         agent: core_1.Flags.string({ required: true }),
         space: core_1.Flags.string({ description: 'Current Space context' }),
@@ -13,11 +13,15 @@ class MemoryStoresList extends scoped_memory_command_1.ScopedMemoryCommand {
         this.requireAuth();
         const { flags } = await this.parse(MemoryStoresList);
         const response = await this.memoryApi(flags.agent, `/stores${this.query(flags)}`);
+        const storeResolutions = (0, scoped_memory_command_1.parseMemoryStoreResolutions)(response.storeResolutions);
         const result = {
             stores: response.stores.map(scoped_memory_command_1.parseMountedMemoryStore),
+            ...(storeResolutions !== undefined ? { storeResolutions } : {}),
         };
         if (flags.json)
             return this.log(JSON.stringify(result, null, 2));
+        for (const line of (0, scoped_memory_command_1.memoryStoreResolutionLines)(storeResolutions))
+            this.log(line);
         for (const store of result.stores) {
             this.log(`${store.id}  ${store.owner.kind}:${store.owner.id}  ${store.mount.access}  r${store.revision}`);
         }

package/dist/commands/proposals/list.js

@@ -47,6 +47,8 @@ class ProposalsList extends base_command_1.BaseCommand {
             this.log(JSON.stringify(result, null, 2));
             return;
         }
+        if (!result.data.length)
+            this.log('No proposals returned on this page.');
         (0, format_1.renderTable)(result.data.map((row) => ({
             id: row.id,
             title: row.title,

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

@@ -29,7 +29,7 @@ class SpacesWorkflowsCreate extends base_command_1.BaseCommand {
         title: core_1.Flags.string({ required: true, description: 'Workflow title' }),
         description: core_1.Flags.string({ description: 'Optional description' }),
         graph: core_1.Flags.string({
-            description: 'Required exactly once with --draft/--starter: path to graph JSON ({ nodes, edges })',
+            description: 'Required exactly once with --draft/--starter: path to graph JSON ({ nodes, edges }); inspect config with spaces workflows node-types',
             exactlyOne: ['graph', 'draft', 'starter'],
         }),
         draft: core_1.Flags.string({

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

@@ -0,0 +1,45 @@
+import { type WorkflowNodeType } from '@skrr-ai/data-provider';
+import { BaseCommand } from '../../../base-command';
+export declare function workflowNodeTypeReference(type: WorkflowNodeType): {
+    type: WorkflowNodeType;
+    typeVersion: number;
+    label: string;
+    description: string;
+    requiredConfig: string[];
+    fields: {
+        path: string;
+        name: string;
+        label: string;
+        kind: import("@skrr-ai/data-provider").WorkflowNodeFieldKind;
+        placeholder?: string;
+        help?: string;
+        showWhen?: {
+            field: string;
+            equals: unknown;
+        };
+        options?: Array<{
+            value: string;
+            label: string;
+        }>;
+    }[];
+    defaultNode: {
+        key: string;
+        type: WorkflowNodeType;
+        typeVersion: number;
+        config: Record<string, unknown>;
+        join: "all";
+        bindings: {};
+    };
+    outcomes: import("@skrr-ai/data-provider").WorkflowOutcomeSpec[];
+};
+export default class SpacesWorkflowsNodeTypes extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        type: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workflowNodeTypeReference = workflowNodeTypeReference;
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+function workflowNodeTypeReference(type) {
+    const definition = data_provider_1.WORKFLOW_NODE_TYPES[type];
+    const node = {
+        key: `${definition.keyPrefix}_1`,
+        type,
+        typeVersion: definition.version,
+        config: definition.defaultConfig(),
+        join: 'all',
+        bindings: {},
+    };
+    return {
+        type,
+        typeVersion: definition.version,
+        label: definition.label,
+        description: definition.description,
+        requiredConfig: definition.requiredConfig,
+        fields: definition.fields.map((field) => ({
+            ...field,
+            path: field.name === 'join' ? 'join' : `config.${field.name}`,
+        })),
+        defaultNode: node,
+        outcomes: definition.outcomes(node),
+    };
+}
+class SpacesWorkflowsNodeTypes extends base_command_1.BaseCommand {
+    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',
+        '<%= config.bin %> spaces workflows node-types loop --json',
+        '<%= config.bin %> spaces workflows node-types review_loop --json',
+    ];
+    static args = {
+        type: core_1.Args.string({ description: 'Node type; omit to list all types', ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output node fields, choices and default node JSON' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(SpacesWorkflowsNodeTypes);
+        if (args.type && !(0, data_provider_1.isWorkflowNodeType)(args.type)) {
+            this.failWithCliError({
+                message: `Unknown node type: ${args.type}. Run skrr spaces workflows node-types to list types.`,
+                code: 'WORKFLOW_NODE_TYPE_UNKNOWN',
+                exit: 2,
+                retryable: false,
+            });
+            return;
+        }
+        const types = args.type
+            ? [args.type]
+            : Object.keys(data_provider_1.WORKFLOW_NODE_TYPES);
+        const references = types.map(workflowNodeTypeReference);
+        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,
+            }, null, 2));
+            return;
+        }
+        this.log(note);
+        for (const reference of references) {
+            this.log(`\n${reference.type} · ${reference.label} · v${reference.typeVersion}`);
+            if (!args.type)
+                continue;
+            this.log(reference.description);
+            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(', ')})` : '';
+                this.log(`  ${field.path}: ${field.label}${choices}`);
+                if (field.help)
+                    this.log(`    ${field.help}`);
+            }
+            this.log(`Default node: ${JSON.stringify(reference.defaultNode, null, 2)}`);
+        }
+        if (!args.type)
+            this.log('\nRead one type: skrr spaces workflows node-types <type> --json');
+    }
+}
+exports.default = SpacesWorkflowsNodeTypes;

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

@@ -51,19 +51,21 @@ class SpacesWorkflowsUpdate extends base_command_1.BaseCommand {
         title: core_1.Flags.string({ description: 'New workflow title' }),
         description: core_1.Flags.string({ description: 'New workflow description' }),
         'clear-description': core_1.Flags.boolean({ description: 'Remove the workflow description' }),
-        graph: core_1.Flags.string({ description: 'Path to graph JSON ({ nodes, edges })' }),
+        graph: core_1.Flags.string({
+            description: 'Path to graph JSON ({ nodes, edges }); inspect config with spaces workflows node-types',
+        }),
         draft: core_1.Flags.string({
             description: 'Path to complete draft JSON ({ semantic, presentation })',
         }),
         'semantic-revision': core_1.Flags.integer({
-            description: 'Expected semantic revision; defaults to the latest server value',
+            description: 'Expected semantic revision; pass with --presentation-revision. For graph/draft writes, omit both to fetch the latest server revisions',
         }),
         'max-duration': core_1.Flags.string({
             description: 'Run duration limit, e.g. 90m, 4h or 2d. A run still open past it is cancelled with WORKFLOW_RUN_DEADLINE. Applies from the next publish; runs already started keep their deadline',
         }),
         'clear-max-duration': core_1.Flags.boolean({ description: 'Remove the run duration limit' }),
         'presentation-revision': core_1.Flags.integer({
-            description: 'Expected presentation revision; defaults to the latest server value',
+            description: 'Expected presentation revision; pass with --semantic-revision. For graph/draft writes, omit both to fetch the latest server revisions',
         }),
     };
     async run() {

package/dist/commands/tasks/schedule.js

@@ -18,7 +18,7 @@ class TasksSchedule extends base_command_1.BaseCommand {
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
         at: core_1.Flags.string({
-            description: 'First fire time as ISO-8601 UTC (e.g. 2026-06-01T15:30:00Z)',
+            description: 'First fire time as ISO-8601 UTC ending in Z (e.g. 2026-06-01T15:30:00Z); numeric offsets such as +00:00 are not accepted',
         }),
         cron: core_1.Flags.string({
             description: 'Recurrence cron pattern (UTC unless --timezone is set)',
@@ -36,7 +36,7 @@ class TasksSchedule extends base_command_1.BaseCommand {
             dependsOn: ['cron'],
         }),
         'from-json': core_1.Flags.string({
-            description: 'Path to a JSON file (or "-" for stdin) with the schedule body',
+            description: 'Path to a JSON file (or "-" for stdin) with the schedule body; scheduledFor must use ISO-8601 UTC ending in Z',
         }),
     };
     async run() {
@@ -63,7 +63,7 @@ class TasksSchedule extends base_command_1.BaseCommand {
             recurrence,
         });
         if (!payload.scheduledFor || typeof payload.scheduledFor !== 'string') {
-            this.error('A first-fire time is required. Pass --at <ISO-8601> or include scheduledFor in --from-json.', { exit: 1 });
+            this.error('A first-fire time is required. Pass --at <ISO-8601 UTC ending in Z> or include scheduledFor in --from-json using the same format.', { exit: 1 });
         }
         let result;
         try {

package/dist/lib/commitment-terms.js

@@ -82,7 +82,7 @@ function renderCommitmentTerms(commitment, log) {
         ? `${subject.type} ${subject.label || subject.externalKey}`
         : 'standing (not about one instance)'}`);
     const sensors = commitment.sensors ?? [];
-    log(`Watches:   ${sensors.length
+    log(`Sensors:   ${sensors.length
         ? sensors
             .map((s) => `${sensorRefKey(s)}${s.sensorType ? ` (${s.sensorType})` : ''}`)
             .join(', ')

package/dist/lib/scoped-memory-command.d.ts

@@ -5,6 +5,13 @@ export type MemoryMount = SharedMemoryMount;
 export type MemoryStore = SharedMemoryStore & {
     mount: SharedMemoryMount;
 };
+export type MemoryStoreResolution = {
+    storeId: string;
+    outcome: 'existing' | 'created' | 'adopted' | 'existing_after_race' | 'unconfirmed';
+    metadataChanged: boolean | null;
+};
+export declare function parseMemoryStoreResolutions(value: unknown): MemoryStoreResolution[] | undefined;
+export declare function memoryStoreResolutionLines(resolutions?: MemoryStoreResolution[]): string[];
 export declare function parseMemoryMount(value: unknown): MemoryMount;
 export declare function parseMountedMemoryStore(value: unknown): MemoryStore;
 export declare const scopedMemoryFlags: {

package/dist/lib/scoped-memory-command.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScopedMemoryCommand = exports.versionedMutationFlags = exports.mutationFlags = exports.scopedMemoryFlags = void 0;
+exports.parseMemoryStoreResolutions = parseMemoryStoreResolutions;
+exports.memoryStoreResolutionLines = memoryStoreResolutionLines;
 exports.parseMemoryMount = parseMemoryMount;
 exports.parseMountedMemoryStore = parseMountedMemoryStore;
 exports.parseMemoryApiError = parseMemoryApiError;
@@ -8,6 +10,40 @@ const core_1 = require("@oclif/core");
 const node_crypto_1 = require("node:crypto");
 const base_command_1 = require("../base-command");
 const api_fetch_1 = require("./api-fetch");
+function parseMemoryStoreResolutions(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value))
+        throw new Error('Invalid Memory Store resolution response from server');
+    return value.map((entry) => {
+        const resolution = entry;
+        const changed = resolution?.outcome === 'created' || resolution?.outcome === 'adopted';
+        const expectedChange = resolution?.outcome === 'unconfirmed' ? null : changed;
+        if (!resolution || typeof resolution.storeId !== 'string' || !resolution.storeId ||
+            !['existing', 'created', 'adopted', 'existing_after_race', 'unconfirmed']
+                .includes(String(resolution.outcome)) || resolution.metadataChanged !== expectedChange) {
+            throw new Error('Invalid Memory Store resolution response from server');
+        }
+        return {
+            storeId: resolution.storeId,
+            outcome: resolution.outcome,
+            metadataChanged: resolution.metadataChanged,
+        };
+    });
+}
+function memoryStoreResolutionLines(resolutions) {
+    if (!resolutions) {
+        return ['Store initialization outcome was not reported by this server; discovery may create default Store metadata or adopt a legacy Store into this workspace.'];
+    }
+    const labels = {
+        existing: 'Reused existing Store metadata',
+        created: 'Created default Store metadata',
+        adopted: 'Adopted legacy Store metadata into this workspace',
+        existing_after_race: 'Reused Store metadata from a concurrent creator',
+        unconfirmed: 'Store metadata initialization outcome is unconfirmed',
+    };
+    return resolutions.map((resolution) => `${labels[resolution.outcome]}: ${resolution.storeId}`);
+}
 // The public CLI must not load the private data-schemas package at runtime.
 // The API validates the full wire contract; check the fields used by CLI commands
 // before treating a response as a mounted Store or mount.

package/oclif.manifest.json

@@ -63745,7 +63745,7 @@
     "memory:mounts:resolve": {
       "aliases": [],
       "args": {},
-      "description": "Resolve the ACL-aware Memory mounts for an Agent session",
+      "description": "Resolve ACL-aware Memory mounts; discovery may initialize default Store metadata",
       "flags": {
         "bare": {
           "description": "Bare mode — ignore keychain/file credential sources. Token must come from env or --token.",
@@ -65674,7 +65674,7 @@
     "memory:stores:list": {
       "aliases": [],
       "args": {},
-      "description": "List Memory Stores mounted for an Agent session",
+      "description": "List mounted Memory Stores; discovery may initialize default Store metadata",
       "flags": {
         "bare": {
           "description": "Bare mode — ignore keychain/file credential sources. Token must come from env or --token.",
@@ -94243,7 +94243,7 @@
           "type": "option"
         },
         "graph": {
-          "description": "Required exactly once with --draft/--starter: path to graph JSON ({ nodes, edges })",
+          "description": "Required exactly once with --draft/--starter: path to graph JSON ({ nodes, edges }); inspect config with spaces workflows node-types",
           "name": "graph",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -94726,6 +94726,80 @@
         "list.js"
       ]
     },
+    "spaces:workflows:node-types": {
+      "aliases": [],
+      "args": {
+        "type": {
+          "description": "Node type; omit to list all types",
+          "name": "type"
+        }
+      },
+      "description": "Read node config fields, defaults and review lens preset choices from the installed CLI catalog (no server requests)",
+      "examples": [
+        "<%= config.bin %> spaces workflows node-types",
+        "<%= config.bin %> spaces workflows node-types loop --json",
+        "<%= config.bin %> spaces workflows node-types review_loop --json"
+      ],
+      "flags": {
+        "bare": {
+          "description": "Bare mode — ignore keychain/file credential sources. Token must come from env or --token.",
+          "name": "bare",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "token": {
+          "description": "Bearer token for this invocation (debugging/impersonation). Overrides env and stored creds.",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "description": "Workspace ID for workspace-scoped requests (also sets X-Workspace-Id).",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "description": "Which stored session to use. Each profile keeps its own credential and deployment, so signing into one does not sign you out of another. Also OVERSKY_PROFILE. List them with `profiles list`.",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "raw": {
+          "description": "With --json, keep the Mongo storage fields (_id next to id, __v) that the CLI otherwise strips. Also OVERSKY_CLI_RAW=1.",
+          "name": "raw",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output node fields, choices and default node JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "spaces:workflows:node-types",
+      "pluginAlias": "@skrr-ai/cli",
+      "pluginName": "@skrr-ai/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "autonomousCredentialPolicy": "delegated",
+      "resolveSpaceFlag": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "spaces",
+        "workflows",
+        "node-types.js"
+      ]
+    },
     "spaces:workflows:pause": {
       "aliases": [],
       "args": {
@@ -96892,7 +96966,7 @@
           "type": "boolean"
         },
         "graph": {
-          "description": "Path to graph JSON ({ nodes, edges })",
+          "description": "Path to graph JSON ({ nodes, edges }); inspect config with spaces workflows node-types",
           "name": "graph",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -96906,7 +96980,7 @@
           "type": "option"
         },
         "semantic-revision": {
-          "description": "Expected semantic revision; defaults to the latest server value",
+          "description": "Expected semantic revision; pass with --presentation-revision. For graph/draft writes, omit both to fetch the latest server revisions",
           "name": "semantic-revision",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -96926,7 +97000,7 @@
           "type": "boolean"
         },
         "presentation-revision": {
-          "description": "Expected presentation revision; defaults to the latest server value",
+          "description": "Expected presentation revision; pass with --semantic-revision. For graph/draft writes, omit both to fetch the latest server revisions",
           "name": "presentation-revision",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -117133,7 +117207,7 @@
           "type": "boolean"
         },
         "at": {
-          "description": "First fire time as ISO-8601 UTC (e.g. 2026-06-01T15:30:00Z)",
+          "description": "First fire time as ISO-8601 UTC ending in Z (e.g. 2026-06-01T15:30:00Z); numeric offsets such as +00:00 are not accepted",
           "name": "at",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -117177,7 +117251,7 @@
           "type": "option"
         },
         "from-json": {
-          "description": "Path to a JSON file (or \"-\" for stdin) with the schedule body",
+          "description": "Path to a JSON file (or \"-\" for stdin) with the schedule body; scheduledFor must use ISO-8601 UTC ending in Z",
           "name": "from-json",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -131288,5 +131362,5 @@
       ]
     }
   },
-  "version": "0.1.99"
+  "version": "0.1.100"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrr-ai/cli",
-  "version": "0.1.99",
+  "version": "0.1.100",
   "description": "Command-line interface for skrr",
   "license": "ISC",
   "author": "skrr",