@skrr-ai/cli 0.1.135 → 0.1.136

package/dist/commands/agents/spawn.d.ts

@@ -1,10 +1,13 @@
 import { BaseCommand } from '../../base-command';
-import { type ApplyProactiveAgentResponse } from '../../lib/proactiveApi';
+import { type ProactiveAgentSpec, type ApplyProactiveAgentResponse } from '../../lib/proactiveApi';
 export type ProactiveInstallReadiness = {
     status: 'ready' | 'degraded';
     message: string;
     repairCommand?: string;
 };
+export declare function workerPolicyWindowLines(policy: NonNullable<ProactiveAgentSpec['worker']>['policy']): string[];
+/** JSON previews show the effective disabled state without mutating the input spec. */
+export declare function specWithEffectiveWindowFlags(spec: ProactiveAgentSpec): ProactiveAgentSpec;
 /**
  * Agent identity creation is intentionally forward-only, but an Agent URL must
  * not masquerade as a fully installed proactive service when a watcher or

package/dist/commands/agents/spawn.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.workerPolicyWindowLines = workerPolicyWindowLines;
+exports.specWithEffectiveWindowFlags = specWithEffectiveWindowFlags;
 exports.proactiveInstallReadiness = proactiveInstallReadiness;
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
@@ -7,6 +9,40 @@ const prompt_1 = require("../../lib/prompt");
 const format_1 = require("../../lib/format");
 const web_url_1 = require("../../lib/web-url");
 const proactiveApi_1 = require("../../lib/proactiveApi");
+function workerPolicyWindowLines(policy) {
+    const lines = [];
+    for (const [label, window] of [
+        ['Working hours', policy?.workingHours],
+        ['Quiet hours', policy?.quietHours],
+    ]) {
+        if (!window)
+            continue;
+        const state = window.enabled === undefined
+            ? 'disabled; enabled not specified'
+            : window.enabled ? 'enabled' : 'disabled';
+        lines.push(`  ${label}: ${window.start}–${window.end} ${window.timezone ?? '(no zone recorded)'} (${state})`);
+    }
+    return lines;
+}
+/** JSON previews show the effective disabled state without mutating the input spec. */
+function specWithEffectiveWindowFlags(spec) {
+    const policy = spec.worker?.policy;
+    if (!spec.worker || !policy)
+        return spec;
+    const workingHours = policy.workingHours && { ...policy.workingHours, enabled: policy.workingHours.enabled ?? false };
+    const quietHours = policy.quietHours && { ...policy.quietHours, enabled: policy.quietHours.enabled ?? false };
+    return {
+        ...spec,
+        worker: {
+            ...spec.worker,
+            policy: {
+                ...policy,
+                ...(workingHours ? { workingHours } : {}),
+                ...(quietHours ? { quietHours } : {}),
+            },
+        },
+    };
+}
 /**
  * Agent identity creation is intentionally forward-only, but an Agent URL must
  * not masquerade as a fully installed proactive service when a watcher or
@@ -23,6 +59,18 @@ function proactiveInstallReadiness(result, bin) {
             message: 'The Agent is off. Review the setup warnings and enable Always-On explicitly if you want it to run.',
         };
     }
+    if (result.warnings.some((warning) => warning.code === 'compass_existing_not_replaced')) {
+        return {
+            status: 'degraded',
+            message: 'The requested standing direction was not installed. Review the existing Compass and the setup warnings.',
+        };
+    }
+    if (result.warnings.some((warning) => warning.code === 'policy_window_enabled_unspecified')) {
+        return {
+            status: 'degraded',
+            message: 'Some worker time windows are disabled because their enablement was not specified. Review the warnings.',
+        };
+    }
     // A full trigger budget must not make a new persona-only Agent look broken
     // when its core system commitments, local execution policy, and Always-On
     // state installed successfully. The optional backlog watcher is deferred;
@@ -135,7 +183,7 @@ class AgentsSpawn extends base_command_1.BaseCommand {
         const spec = (body.spec ?? body);
         if (!flags.approve) {
             if (flags.json) {
-                this.log(JSON.stringify(spec, null, 2));
+                this.log(JSON.stringify(specWithEffectiveWindowFlags(spec), null, 2));
                 return;
             }
             this.renderSpec(spec);
@@ -192,7 +240,7 @@ class AgentsSpawn extends base_command_1.BaseCommand {
         const spec = plan.spec;
         if (!flags.approve) {
             if (flags.json) {
-                this.log(JSON.stringify(plan, null, 2));
+                this.log(JSON.stringify({ ...plan, spec: specWithEffectiveWindowFlags(spec) }, null, 2));
                 return;
             }
             this.renderSpec(spec);
@@ -244,6 +292,8 @@ class AgentsSpawn extends base_command_1.BaseCommand {
         if (spec.worker) {
             this.log('');
             this.log(`Worker (event-reactive) — policy: ${spec.worker.policy?.mode ?? 'ask_first'}`);
+            for (const line of workerPolicyWindowLines(spec.worker.policy))
+                this.log(line);
             (0, format_1.renderTable)(spec.worker.watchers.map((w) => ({
                 source: w.source,
                 every: `${w.intervalMinutes ?? '-'}m`,

package/dist/commands/spaces/autodream/status.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../base-command';
+export default class SpaceAutoDreamStatus extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/spaces/autodream/status.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const api_fetch_1 = require("../../../lib/api-fetch");
+class SpaceAutoDreamStatus extends base_command_1.BaseCommand {
+    static description = 'Show current Space AutoDream eligibility and the most recent recorded cycle';
+    static args = { id: core_1.Args.string({ description: 'Space ID or title', required: true, ignoreStdin: true }) };
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpaceAutoDreamStatus);
+        const spaceId = await this.resolveSpaceReference(args.id);
+        let result;
+        try {
+            result = await (0, api_fetch_1.apiFetch)(`/api/spaces/${encodeURIComponent(spaceId)}/autodream`, {
+                credential: this.resolvedCredential,
+            });
+        }
+        catch (error) {
+            this.handleApiError(error, { subject: `space ${args.id}` });
+        }
+        if (flags.json) {
+            this.printJsonResult(result);
+            return;
+        }
+        const eligibility = {
+            principal_missing_or_revoked: 'No active execution principal is configured.',
+            principal_lead_mismatch: 'The execution principal no longer matches the Space lead.',
+            principal_configured_unverified: 'An execution principal is configured; its current access has not been verified by this status check.',
+        }[result.currentEligibility] || 'Current eligibility is unknown.';
+        this.log(`Current eligibility: ${eligibility}`);
+        this.log(`Checked at: ${result.checkedAt}`);
+        const cycle = result.latestRecordedCycle;
+        if (cycle) {
+            this.log(`Most recent recorded cycle: ${cycle.window} — ${cycle.outcome}${cycle.reason ? ` (${cycle.reason})` : ''}; completed ${cycle.completedAt}`);
+        }
+        else {
+            this.log('No recorded cycle. This does not establish whether a cycle was scheduled.');
+        }
+        this.log('Cycle receipts are best-effort; an unrecorded later cycle may exist.');
+    }
+}
+exports.default = SpaceAutoDreamStatus;

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

@@ -62,6 +62,10 @@ class SpacesProposalsList extends base_command_1.BaseCommand {
         if (!result.data.length) {
             for (const line of (0, space_proposals_1.emptySpaceInboxLines)(result.nextCursor))
                 this.log(line);
+            if (!result.nextCursor) {
+                const bin = this.config?.bin || 'skrr';
+                this.log(`For AutoDream status, run: ${bin} spaces autodream status ${spaceId}`);
+            }
         }
         (0, format_1.renderTable)(result.data.map(space_proposals_1.spaceProposalRow), [
             { key: 'id', header: 'PROPOSAL', verbatim: true },

package/dist/commands/triggers/fire-detail.js

@@ -25,6 +25,10 @@ function describeFireAuditDetail(detail, fireId, triggerId) {
         lines.push(`Reason:       ${reason}`);
     if (message && message !== reason)
         lines.push(`${reason ? 'Detail:' : 'Reason:'}       ${message}`);
+    const quietHours = (0, triggers_1.quietHoursAuditExplanation)(detail);
+    if (quietHours) {
+        lines.push(`Explanation:  ${quietHours.summary}. ${quietHours.detail}`);
+    }
     if (detail.durationMs !== undefined)
         lines.push(`Duration:     ${String(detail.durationMs)}ms`);
     if (detail.conversationId)

package/dist/lib/proactiveApi.d.ts

@@ -7,6 +7,10 @@ export interface ProactiveWorkingHours {
     end: string;
     timezone?: string;
 }
+/** Worker policy windows have an explicit enable switch; orchestrator hours do not. */
+export interface ProactiveWorkerPolicyHours extends ProactiveWorkingHours {
+    enabled?: boolean;
+}
 export interface SpecWatcher {
     source: WatcherSource;
     intervalMinutes?: number;
@@ -34,8 +38,8 @@ export interface ProactiveAgentSpec {
             maxAutoRunsPerDay?: number;
             cooldownMinutes?: number;
             requireApprovalRiskLevels?: string[];
-            workingHours?: ProactiveWorkingHours;
-            quietHours?: ProactiveWorkingHours;
+            workingHours?: ProactiveWorkerPolicyHours;
+            quietHours?: ProactiveWorkerPolicyHours;
         };
     };
     orchestrator?: {

package/dist/lib/triggers.d.ts

@@ -583,6 +583,15 @@ export declare function renderTriggerSummary(trigger: TriggerDefinition, log: (l
     baseURL?: string;
 }): void;
 export declare function renderLegacyRuns(runs: LegacyTriggerRun[], log: (line: string) => void): void;
+/** Human explanation for quiet-hour audit rows; a one-shot may have been re-armed. */
+export declare function quietHoursAuditExplanation(fire: {
+    source?: unknown;
+    reason?: unknown;
+    outcome?: unknown;
+}): {
+    summary: string;
+    detail: string;
+} | null;
 export declare function renderFireAudit(fires: TriggerFireRecord[], log: (line: string) => void): void;
 /**
  * Trigger budget for one scope. `active` counts only ENABLED rows — a disabled

package/dist/lib/triggers.js

@@ -53,6 +53,7 @@ exports.toolsRefusedHintLines = toolsRefusedHintLines;
 exports.fireRefusalLines = fireRefusalLines;
 exports.renderTriggerSummary = renderTriggerSummary;
 exports.renderLegacyRuns = renderLegacyRuns;
+exports.quietHoursAuditExplanation = quietHoursAuditExplanation;
 exports.renderFireAudit = renderFireAudit;
 const data_provider_1 = require("@skrr-ai/data-provider");
 const node_fs_1 = require("node:fs");
@@ -1524,6 +1525,22 @@ function renderLegacyRuns(runs, log) {
         { key: 'conversation', header: 'CONVO', maxWidth: 24 },
     ], log);
 }
+/** Human explanation for quiet-hour audit rows; a one-shot may have been re-armed. */
+function quietHoursAuditExplanation(fire) {
+    const reason = fire.reason || fire.outcome;
+    if (reason !== 'inside_quiet_hours' && reason !== 'initiative_policy_quiet_hours')
+        return null;
+    if (fire.source === 'once') {
+        return {
+            summary: 'One-shot skipped: quiet hours',
+            detail: 'This skipped occurrence will not retry automatically. Check the trigger state; if the one-shot is spent, schedule a new one outside quiet hours.',
+        };
+    }
+    return {
+        summary: 'Skipped: quiet hours',
+        detail: 'Review the trigger and Agent quiet-hours settings before retrying.',
+    };
+}
 function renderFireAudit(fires, log) {
     if (fires.length === 0) {
         log('No fire audit records.');
@@ -1536,7 +1553,7 @@ function renderFireAudit(fires, log) {
         source: fire.source ?? '-',
         reason: fire.metadata?.recordKind === 'schedule_end_marker'
             ? 'Schedule ended after prior fire'
-            : fire.reason ?? fire.errorMessage ?? '',
+            : quietHoursAuditExplanation(fire)?.summary ?? fire.reason ?? fire.errorMessage ?? '',
         duration: fire.durationMs === undefined ? '-' : `${fire.durationMs}ms`,
         replay: fire.metadata?.replayable === true || fire.metadata?.replayContext
             ? 'yes'

package/oclif.manifest.json

@@ -90022,6 +90022,76 @@
         "update.js"
       ]
     },
+    "spaces:autodream:status": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Space ID or title",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Show current Space AutoDream eligibility and the most recent recorded cycle",
+      "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 as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "spaces:autodream:status",
+      "pluginAlias": "@skrr-ai/cli",
+      "pluginName": "@skrr-ai/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "autonomousCredentialPolicy": "delegated",
+      "resolveSpaceFlag": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "spaces",
+        "autodream",
+        "status.js"
+      ]
+    },
     "spaces:bootstrap": {
       "aliases": [],
       "args": {
@@ -143454,5 +143524,5 @@
       ]
     }
   },
-  "version": "0.1.135"
+  "version": "0.1.136"
 }

package/package.json

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