@skrr-ai/cli 0.1.100 → 0.1.102

package/dist/commands/commitments/analytics/detail.d.ts

@@ -3,9 +3,8 @@ import { BaseCommand } from '../../../base-command';
  * `skrr commitments analytics detail <id>` — per-commitment analytics.
  *
  * Distinct from `skrr commitments show` (the contract) and from
- * `skrr commitments ledger` (the raw durable runs): this is the JOINED
- * projection — checks correlated with their outcomes, runs and deliveries over a
- * window.
+ * `skrr commitments ledger` (the raw durable runs): the default rolls up daily
+ * Check/outcome metrics. Only --ledger joins checks, native Runs and deliveries.
  */
 export default class CommitmentsAnalyticsDetail extends BaseCommand {
     static description: string;

package/dist/commands/commitments/analytics/detail.js

@@ -7,12 +7,11 @@ const commitment_analytics_1 = require("../../../lib/commitment-analytics");
  * `skrr commitments analytics detail <id>` — per-commitment analytics.
  *
  * Distinct from `skrr commitments show` (the contract) and from
- * `skrr commitments ledger` (the raw durable runs): this is the JOINED
- * projection — checks correlated with their outcomes, runs and deliveries over a
- * window.
+ * `skrr commitments ledger` (the raw durable runs): the default rolls up daily
+ * Check/outcome metrics. Only --ledger joins checks, native Runs and deliveries.
  */
 class CommitmentsAnalyticsDetail extends base_command_1.BaseCommand {
-    static description = 'Per-commitment analytics (joined checks, outcomes, runs)';
+    static description = 'Daily Check/outcome analytics; use --ledger for joined native Runs. Legacy totals.autoRuns is not a native Run count';
     static examples = [
         '<%= config.bin %> commitments analytics detail obj_abc123',
         '<%= config.bin %> commitments analytics detail obj_abc123 --days 30',
@@ -24,7 +23,7 @@ class CommitmentsAnalyticsDetail extends base_command_1.BaseCommand {
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
         days: core_1.Flags.integer({ description: 'Lookback window in days', min: 1, max: 365 }),
-        ledger: core_1.Flags.boolean({ description: 'Show the joined ledger projection instead' }),
+        ledger: core_1.Flags.boolean({ description: 'Show joined checks, native Runs and deliveries instead of daily Check/outcome metrics' }),
         limit: core_1.Flags.integer({ description: 'Max rows (ledger)', min: 1, max: 200 }),
         'check-limit': core_1.Flags.integer({ description: 'Max checks (ledger)', min: 1, max: 200 }),
         'run-limit': core_1.Flags.integer({ description: 'Max runs (ledger)', min: 1, max: 200 }),

package/dist/commands/commitments/control/apply.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../../base-command';
+export default class CommitmentsControlApply extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        reason: 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/commitments/control/apply.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const commitments_1 = require("../../../lib/commitments");
+const prompt_1 = require("../../../lib/prompt");
+const responsibility_controls_1 = require("../../../lib/responsibility-controls");
+class CommitmentsControlApply extends base_command_1.BaseCommand {
+    static description = 'Apply the exact scope, version and execution targets from a saved control preview';
+    static examples = ['<%= config.bin %> commitments control apply <id> --from-json control.json --idempotency-key <key>'];
+    static args = {
+        id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        'from-json': core_1.Flags.string({ description: 'Reviewed control preview file, or - for stdin', required: true }),
+        'idempotency-key': core_1.Flags.string({ description: 'Stable key for retries of this exact control request', required: true }),
+        reason: core_1.Flags.string({ description: 'Reason for this control (at most 1000 characters)' }),
+        json: core_1.Flags.boolean({ description: 'Output the actual control receipt as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(CommitmentsControlApply);
+        try {
+            const body = (0, responsibility_controls_1.controlFromPreview)(args.id, await (0, prompt_1.readJsonBody)(flags['from-json']), flags['idempotency-key'], flags.reason);
+            const receipt = await commitments_1.commitmentApi.applyControl(args.id, body);
+            if (flags.json)
+                this.log(JSON.stringify(receipt, null, 2));
+            else
+                (0, responsibility_controls_1.renderControl)(receipt, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CommitmentsControlApply;

package/dist/commands/commitments/control/preview.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../../base-command';
+export default class CommitmentsControlPreview extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        scope: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        target: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        assignment: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'workflow-run': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        node: 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/commitments/control/preview.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const commitments_1 = require("../../../lib/commitments");
+const responsibility_controls_1 = require("../../../lib/responsibility-controls");
+class CommitmentsControlPreview extends base_command_1.BaseCommand {
+    static description = 'Review a responsibility control and its exact affected execution attempts';
+    static examples = [
+        '<%= config.bin %> commitments control preview <id> cancel_worker --assignment <id> --json > control.json',
+        '<%= config.bin %> commitments control preview <id> pause_observation --json > control.json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
+        scope: core_1.Args.string({ description: 'Control scope', options: [...responsibility_controls_1.RESPONSIBILITY_CONTROL_SCOPES], required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        target: core_1.Flags.string({ description: 'Exact target ID (repeat for multiple targets)', multiple: true }),
+        assignment: core_1.Flags.string({ description: 'Assignment ID to inspect' }),
+        'workflow-run': core_1.Flags.string({ description: 'Workflow episode ID to inspect' }),
+        node: core_1.Flags.string({ description: 'Node key in the selected workflow episode', dependsOn: ['workflow-run'] }),
+        json: core_1.Flags.boolean({ description: 'Output the complete frozen preview for control apply' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(CommitmentsControlPreview);
+        try {
+            const preview = await commitments_1.commitmentApi.controlPreview(args.id, {
+                scope: args.scope,
+                ...(flags.target?.length ? { targetIds: flags.target.join(',') } : {}),
+                assignmentId: flags.assignment, workflowRunId: flags['workflow-run'], nodeKey: flags.node,
+            });
+            if (flags.json)
+                this.log(JSON.stringify(preview, null, 2));
+            else
+                (0, responsibility_controls_1.renderControl)(preview, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CommitmentsControlPreview;

package/dist/commands/commitments/control/show.d.ts

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

package/dist/commands/commitments/control/show.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const commitments_1 = require("../../../lib/commitments");
+const responsibility_controls_1 = require("../../../lib/responsibility-controls");
+class CommitmentsControlShow extends base_command_1.BaseCommand {
+    static description = 'Read an exact responsibility control receipt and its current acknowledgement state';
+    static args = {
+        id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
+        controlId: core_1.Args.string({ description: 'Control receipt ID', required: true, ignoreStdin: true }),
+    };
+    static flags = { json: core_1.Flags.boolean({ description: 'Output the control receipt as JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(CommitmentsControlShow);
+        try {
+            const receipt = await commitments_1.commitmentApi.controlReceipt(args.id, args.controlId);
+            if (flags.json)
+                this.log(JSON.stringify(receipt, null, 2));
+            else
+                (0, responsibility_controls_1.renderControl)(receipt, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CommitmentsControlShow;

package/dist/commands/commitments/create.js

@@ -251,11 +251,11 @@ JSON
         // companion flag implicitly opts the source in — mirroring how
         // `--metric-key` works — so the enum and its config never disagree.
         'watch-space': core_1.Flags.string({
-            description: 'Space to watch (repeatable). Accepts a space id, ref, or unique title. Implies --watch space.',
+            description: 'One Space to watch. Accepts a space id, ref, or unique title. Implies --watch space.',
             multiple: true,
         }),
         'watch-monitor': core_1.Flags.string({
-            description: 'Signal Monitor id to watch (repeatable). Implies --watch monitor.',
+            description: 'One Signal Monitor id to watch. Implies --watch monitor.',
             multiple: true,
         }),
         cadence: core_1.Flags.string({
@@ -427,6 +427,9 @@ JSON
                     throw new Error('A finite policy.executionBudget.maxConcurrentRuns in --from-json requires maxConcurrentRunsReason.');
                 }
             }
+            if (Array.isArray(payload.watchedSources)) {
+                payload.watchedSources = (0, commitments_1.normalizeWatchedSourceDeclarations)(payload.watchedSources);
+            }
         }
         catch (err) {
             this.error(err.message, { exit: 1 });

package/dist/commands/commitments/observation/probe.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../../base-command';
+export default class CommitmentsObservationProbe extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'timeout-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/commitments/observation/probe.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const commitments_1 = require("../../../lib/commitments");
+const prompt_1 = require("../../../lib/prompt");
+const responsibility_controls_1 = require("../../../lib/responsibility-controls");
+class CommitmentsObservationProbe extends base_command_1.BaseCommand {
+    static description = 'Perform a bounded source-read probe for a saved responsibility or unsaved draft';
+    static examples = [
+        '<%= config.bin %> commitments observation probe <id> --expected-version 7 --timeout-ms 5000',
+        '<%= config.bin %> commitments observation probe --from-json draft.json --json',
+    ];
+    static args = { id: core_1.Args.string({ description: 'Saved Commitment ID; omit for an unsaved draft', ignoreStdin: true }) };
+    static flags = {
+        'from-json': core_1.Flags.string({ description: 'Unsaved draft JSON file, or - for stdin' }),
+        'expected-version': core_1.Flags.integer({ description: 'Exact saved Commitment version', min: 1 }),
+        'timeout-ms': core_1.Flags.integer({ description: 'Saved source-probe timeout (1..15000ms)', min: 1, max: 15000 }),
+        json: core_1.Flags.boolean({ description: 'Output source evidence as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(CommitmentsObservationProbe);
+        try {
+            if (Boolean(args.id) === Boolean(flags['from-json']))
+                throw new Error('Provide either a saved Commitment ID or --from-json for an unsaved draft.');
+            if (!args.id && (flags['expected-version'] !== undefined || flags['timeout-ms'] !== undefined)) {
+                throw new Error('--expected-version and --timeout-ms apply only to a saved Commitment.');
+            }
+            const probe = args.id
+                ? await commitments_1.commitmentApi.observationProbe(args.id, {
+                    ...(flags['expected-version'] !== undefined ? { expectedVersion: flags['expected-version'] } : {}),
+                    ...(flags['timeout-ms'] !== undefined ? { timeoutMs: flags['timeout-ms'] } : {}),
+                })
+                : await commitments_1.commitmentApi.draftObservationProbe((0, commitments_1.normalizeCreateBody)(await (0, prompt_1.readJsonBody)(flags['from-json'])));
+            if (flags.json)
+                this.log(JSON.stringify(probe, null, 2));
+            else
+                (0, responsibility_controls_1.renderProbe)(probe, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CommitmentsObservationProbe;

package/dist/commands/commitments/observation/summary.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../../base-command';
+export default class CommitmentsObservationSummary extends BaseCommand {
+    static description: string;
+    static flags: {
+        agent: 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/commitments/observation/summary.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const commitments_1 = require("../../../lib/commitments");
+class CommitmentsObservationSummary extends base_command_1.BaseCommand {
+    static description = 'Read the bounded portfolio observation projection without performing new source checks';
+    static flags = {
+        agent: core_1.Flags.string({ description: 'Filter the authenticated portfolio by Agent ID' }),
+        json: core_1.Flags.boolean({ description: 'Output the complete observation projection as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(CommitmentsObservationSummary);
+        try {
+            const summary = await commitments_1.commitmentApi.observationSummary({ agentId: flags.agent });
+            if (flags.json) {
+                this.log(JSON.stringify(summary, null, 2));
+                return;
+            }
+            this.log(`Portfolio observation: ${summary.state ?? 'unknown'}`);
+            this.log(`Checked at: ${summary.checkedAt ?? 'unavailable'}`);
+            this.log(`Coverage: ${JSON.stringify(summary.coverage ?? {})}`);
+            this.log(`Next wake: ${JSON.stringify(summary.nextWake ?? {})}`);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CommitmentsObservationSummary;

package/dist/commands/commitments/readiness/show.d.ts

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

package/dist/commands/commitments/readiness/show.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const commitments_1 = require("../../../lib/commitments");
+const responsibility_controls_1 = require("../../../lib/responsibility-controls");
+class CommitmentsReadinessShow extends base_command_1.BaseCommand {
+    static description = 'Read one exact historical admission or activation receipt without refreshing its evidence';
+    static args = {
+        id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
+        receiptId: core_1.Args.string({ description: 'Readiness or activation receipt ID', required: true, ignoreStdin: true }),
+    };
+    static flags = { json: core_1.Flags.boolean({ description: 'Output the exact receipt as JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(CommitmentsReadinessShow);
+        try {
+            const receipt = await commitments_1.commitmentApi.readinessReceipt(args.id, args.receiptId);
+            if (flags.json)
+                this.log(JSON.stringify(receipt, null, 2));
+            else
+                (0, responsibility_controls_1.renderReadiness)(receipt, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CommitmentsReadinessShow;

package/dist/commands/commitments/readiness/verify.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class CommitmentsReadinessVerify extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'timeout-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/commitments/readiness/verify.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const commitments_1 = require("../../../lib/commitments");
+const responsibility_controls_1 = require("../../../lib/responsibility-controls");
+class CommitmentsReadinessVerify extends base_command_1.BaseCommand {
+    static description = 'Verify one exact saved responsibility version and record canonical readiness evidence';
+    static args = { id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }) };
+    static flags = {
+        'expected-version': core_1.Flags.integer({ description: 'Reviewed Commitment version', required: true, min: 1 }),
+        'timeout-ms': core_1.Flags.integer({ description: 'Source-probe timeout (1..15000ms)', min: 1, max: 15000 }),
+        json: core_1.Flags.boolean({ description: 'Output the recorded readiness receipt as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(CommitmentsReadinessVerify);
+        try {
+            const receipt = await commitments_1.commitmentApi.verifyReadiness(args.id, {
+                expectedVersion: flags['expected-version'],
+                ...(flags['timeout-ms'] !== undefined ? { timeoutMs: flags['timeout-ms'] } : {}),
+            });
+            if (flags.json)
+                this.log(JSON.stringify(receipt, null, 2));
+            else
+                (0, responsibility_controls_1.renderReadiness)(receipt, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CommitmentsReadinessVerify;

package/dist/commands/commitments/update.js

@@ -103,11 +103,11 @@ JSON
             options: [...commitments_1.COMMITMENT_WATCHED_SOURCES],
         }),
         'watch-space': core_1.Flags.string({
-            description: 'Space to watch (repeatable). Accepts a space id, ref, or unique title. Implies --watch space.',
+            description: 'One Space to watch. Accepts a space id, ref, or unique title. Implies --watch space.',
             multiple: true,
         }),
         'watch-monitor': core_1.Flags.string({
-            description: 'Signal Monitor id to watch (repeatable). Implies --watch monitor.',
+            description: 'One Signal Monitor id to watch. Implies --watch monitor.',
             multiple: true,
         }),
         cadence: core_1.Flags.string({
@@ -187,7 +187,8 @@ JSON
                         ? { reviewPolicy: (0, commitment_product_1.normalizeTaskReviewPolicy)(flags['task-review-policy']) }
                         : {}),
                 };
-                payload.expectedVersion ??= current?.version;
+                if (payload.expectedVersion === undefined)
+                    payload.expectedVersion = current?.version;
             }
             const declaredDelivery = payload.delivery;
             if (declaredDelivery?.reviewPolicy !== undefined)
@@ -270,15 +271,13 @@ JSON
                 monitorIds: (0, triggers_1.splitRepeated)(flags['watch-monitor']),
             });
             if (built) {
-                // Flags replace the selected source SET, not the declarations of a
-                // retained binding. In particular agent_run's named keys are JSON
-                // authored; rebuilding a bare source silently erased them (OSK-15110).
+                // A flag edit selects the full replacement set. Keep sensing declarations
+                // only for a binding it still names; explicit JSON is the authored base.
                 const declarations = Array.isArray(payload.watchedSources)
-                    ? payload.watchedSources
+                    ? (0, commitments_1.normalizeWatchedSourceDeclarations)(payload.watchedSources)
                     : current?.watchedSources ?? [];
                 payload.watchedSources = built.map((next) => {
-                    const scopeKey = next.source === 'space' ? 'spaceId'
-                        : next.source === 'monitor' ? 'monitorId' : undefined;
+                    const scopeKey = next.source === 'space' ? 'spaceId' : next.source === 'monitor' ? 'monitorId' : undefined;
                     const nextConfig = next.config;
                     const prior = declarations.find((binding) => binding?.source === next.source &&
                         (!scopeKey || binding.config?.[scopeKey] === nextConfig?.[scopeKey]));
@@ -371,6 +370,9 @@ JSON
                 Object.prototype.hasOwnProperty.call(finalEnvelope, 'maxConcurrentRuns')) {
                 throw new Error('An autonomous Agent cannot change owner Commitment concurrency policy. Ask the owner to run this update outside the Agent session.');
             }
+            if (Array.isArray(payload.watchedSources)) {
+                payload.watchedSources = (0, commitments_1.normalizeWatchedSourceDeclarations)(payload.watchedSources);
+            }
         }
         catch (err) {
             this.error(err.message, { exit: 1 });

package/dist/commands/commitments/work-plan.d.ts

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

package/dist/commands/commitments/work-plan.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const commitments_1 = require("../../lib/commitments");
+class CommitmentsWorkPlan extends base_command_1.BaseCommand {
+    static description = 'Read permission-filtered delegated assignments and workflow episodes for a responsibility';
+    static args = { id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }) };
+    static flags = { json: core_1.Flags.boolean({ description: 'Output the complete public work-plan projection as JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(CommitmentsWorkPlan);
+        try {
+            const plan = await commitments_1.commitmentApi.workPlan(args.id);
+            if (flags.json) {
+                this.log(JSON.stringify(plan, null, 2));
+                return;
+            }
+            for (const key of ['assignments', 'episodes']) {
+                const rows = plan[key];
+                this.log(`${key}: ${Array.isArray(rows) ? rows.length : 'unavailable'}`);
+                if (Array.isArray(rows))
+                    for (const row of rows) {
+                        if (typeof row === 'object' && row !== null)
+                            this.log(`  ${JSON.stringify(row)}`);
+                    }
+            }
+            this.log(`Coverage: ${JSON.stringify(plan.coverage ?? {})}`);
+            this.log(`Coordinator: ${JSON.stringify(plan.coordinatorState ?? {})}`);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CommitmentsWorkPlan;

package/dist/commands/compass/effective-policy.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command';
+export default class CompassEffectivePolicy extends BaseCommand {
+    static description: string;
+    static args: {
+        compassId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        agent: 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/compass/effective-policy.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const compasses_1 = require("../../lib/compasses");
+class CompassEffectivePolicy extends base_command_1.BaseCommand {
+    static description = 'Read a Compass policy revision, effective defaults and field provenance';
+    static args = { compassId: core_1.Args.string({ description: 'Compass ID', required: true, ignoreStdin: true }) };
+    static flags = {
+        agent: core_1.Flags.string({ description: 'Agent ID that owns the Compass', required: true }),
+        json: core_1.Flags.boolean({ description: 'Output the complete policy and provenance as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(CompassEffectivePolicy);
+        try {
+            const policy = await compasses_1.compassApi.effectivePolicy(args.compassId, { agentId: flags.agent });
+            if (flags.json) {
+                this.log(JSON.stringify(policy, null, 2));
+                return;
+            }
+            this.log(`Compass ${policy.compassId}, revision ${policy.compassVersion}: ${policy.status}`);
+            this.log(`Applies to runtime: ${policy.appliesToRuntime === true ? 'yes' : 'no'}`);
+            this.log(`Autonomy defaults: ${JSON.stringify(policy.autonomy ?? {})}`);
+            this.log(`Communication defaults: ${JSON.stringify(policy.communication ?? {})}`);
+            this.log(`Authority: ${policy.authority ?? 'unknown'}`);
+            this.log(`Field provenance: ${JSON.stringify(policy.fieldProvenance ?? {})}`);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = CompassEffectivePolicy;

package/dist/commands/compass/update.d.ts

@@ -1,4 +1,15 @@
 import { BaseCommand } from '../../base-command';
+/**
+ * The server fences every compass write on the version the caller last saw
+ * (`expectedVersion`, required), so a stale writer gets a conflict instead of
+ * silently overwriting a newer revision. Precedence: an explicit flag, then a
+ * value the caller put in `--json-body` (passed through untouched, so an invalid
+ * one is the server's to refuse), then the current version read just now.
+ */
+export declare function resolveExpectedVersion(explicit: number | undefined, fileBody: Record<string, unknown>, fetchCurrentVersion: () => Promise<number>): Promise<{
+    version: unknown;
+    source: 'flag' | 'json-body' | 'current';
+}>;
 /**
  * `skrr compass update <compass-id> --agent <id>`
  *
@@ -24,6 +35,7 @@ export default class CompassUpdate extends BaseCommand {
         status: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         invariant: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         reason: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'json-body': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;