@skrr-ai/cli 0.1.22 → 0.1.24

package/dist/commands/memory/topics/show.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryTopicsShow extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Show one semantic Memory topic';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        level: core_1.Flags.string({ options: ['L0', 'L1', 'L2'], default: 'L1' }),
+        facts: core_1.Flags.boolean(),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryTopicsShow);
+        const store = await this.resolveStore(flags);
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/topics/${encodeURIComponent(args.id)}${this.query(flags, { level: flags.level, includeFacts: flags.facts })}`);
+        this.print(result, flags.json, `${result.node.path}\n${result.representation?.content || '(no projection)'}`);
+    }
+}
+exports.default = MemoryTopicsShow;

package/dist/commands/memory/topics/update.d.ts

@@ -0,0 +1,23 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryTopicsUpdate extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        content: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        confidence: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        source: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'privacy-approval': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/topics/update.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryTopicsUpdate extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Reconsolidate a Memory topic using optimistic version CAS';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        ...scoped_memory_command_1.versionedMutationFlags,
+        content: core_1.Flags.string({ required: true }),
+        confidence: core_1.Flags.string(),
+        source: core_1.Flags.string(),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryTopicsUpdate);
+        const result = await this.mutation('reconsolidate', flags, {
+            memoryId: args.id,
+            content: flags.content,
+            confidence: flags.confidence === undefined ? undefined : Number(flags.confidence),
+            source: flags.source,
+            episode: null,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no topic updated.' : `Updated Memory topic ${args.id}.`);
+    }
+}
+exports.default = MemoryTopicsUpdate;

package/dist/commands/memory/tree.d.ts

@@ -1,10 +1,13 @@
-import { BaseCommand } from '../../base-command';
-export default class MemoryTree extends BaseCommand {
+import { ScopedMemoryCommand } from '../../lib/scoped-memory-command';
+export default class MemoryTree extends ScopedMemoryCommand {
     static description: string;
     static flags: {
         agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         archived: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/memory/tree.js

@@ -2,17 +2,33 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
-const base_command_1 = require("../../base-command");
-class MemoryTree extends base_command_1.BaseCommand {
+const scoped_memory_command_1 = require("../../lib/scoped-memory-command");
+class MemoryTree extends scoped_memory_command_1.ScopedMemoryCommand {
     static description = 'Browse an agent-maintained semantic memory tree and its L0 summaries';
     static flags = {
         agent: core_1.Flags.string({ description: 'Agent ID', required: true }),
         archived: core_1.Flags.boolean({ description: 'Include archived nodes', default: false }),
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        store: core_1.Flags.string({ description: 'Canonical Memory Store ID' }),
+        scope: core_1.Flags.string({ description: 'Canonical owner scope: agent:<id> or space:<id>' }),
+        space: core_1.Flags.string({ description: 'Current Space context' }),
     };
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(MemoryTree);
+        if (flags.store || flags.scope) {
+            const store = await this.resolveStore(flags);
+            const result = await this.memoryApi(flags.agent, `/stores/${store.id}/tree${this.query(flags, { includeArchived: flags.archived })}`);
+            if (flags.json)
+                return this.log(JSON.stringify({ storeId: store.id, ...result }, null, 2));
+            for (const node of result.nodes) {
+                const depth = node.path === '/' ? 0 : node.path.split('/').filter(Boolean).length;
+                this.log(`${'  '.repeat(depth)}${node.nodeKind === 'folder' ? '▸' : '•'} ${node.title}  ${node.path}`);
+            }
+            if (!result.nodes.length)
+                this.log('No Memory nodes.');
+            return;
+        }
         let response;
         try {
             response = await data_provider_1.dataService.getAgentMemoryWorkspaceTree(flags.agent, {
@@ -34,6 +50,8 @@ class MemoryTree extends base_command_1.BaseCommand {
             if (abstract)
                 this.log(`${'  '.repeat(depth + 1)}${abstract}`);
         }
+        if (!response.nodes.length)
+            this.log('No Memory nodes.');
         this.printAgentUrl(flags.agent);
     }
 }

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

@@ -8,7 +8,7 @@ export default class MemoryUpdate extends BaseCommand {
     static flags: {
         agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         tier: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'pool-workspace': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         value: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         rename: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/memory/versions/list.d.ts

@@ -0,0 +1,16 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryVersionsList extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        memory: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/versions/list.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryVersionsList extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'List immutable versions for one Memory topic';
+    static args = { memory: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = { ...scoped_memory_command_1.scopedMemoryFlags, limit: core_1.Flags.integer({ default: 100 }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryVersionsList);
+        const store = await this.resolveStore(flags);
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/versions${this.query(flags, { memoryId: args.memory, limit: flags.limit })}`);
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        for (const version of result.versions)
+            this.log(`${version.id}  ${version.operation}  ${version.createdAt}  ${version.contentHash || '[redacted]'}`);
+        if (!result.versions.length)
+            this.log('No Memory versions.');
+    }
+}
+exports.default = MemoryVersionsList;

package/dist/commands/memory/versions/redact.d.ts

@@ -0,0 +1,21 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryVersionsRedact extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'privacy-approval': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/versions/redact.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const prompt_1 = require("../../../lib/prompt");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryVersionsRedact extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Irreversibly redact the content of an exact historical MemoryVersion';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = { ...scoped_memory_command_1.mutationFlags, yes: core_1.Flags.boolean({ char: 'y' }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryVersionsRedact);
+        if (!flags['dry-run']) {
+            const ok = await (0, prompt_1.confirmDestructive)(`Irreversibly redact MemoryVersion ${args.id}?`, flags.yes).catch((error) => this.error(error.message, { exit: error.exit || 7 }));
+            if (!ok)
+                return this.log('Cancelled.');
+        }
+        const result = await this.mutation('redact', flags, { versionId: args.id });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no version redacted.' : `Redacted MemoryVersion ${args.id}.`);
+    }
+}
+exports.default = MemoryVersionsRedact;

package/dist/commands/memory/versions/restore.d.ts

@@ -0,0 +1,20 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryVersionsRestore extends ScopedMemoryCommand {
+    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<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'authorization-generation': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'privacy-approval': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/versions/restore.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryVersionsRestore extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Restore an old version by appending a new current version';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = scoped_memory_command_1.versionedMutationFlags;
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryVersionsRestore);
+        const result = await this.mutation('restore', flags, { versionId: args.id });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no version restored.' : `Restored MemoryVersion ${args.id}.`);
+    }
+}
+exports.default = MemoryVersionsRestore;

package/dist/commands/memory/versions/show.d.ts

@@ -0,0 +1,15 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryVersionsShow extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        id: 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>;
+        space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        store: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: 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/memory/versions/show.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryVersionsShow extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Show one immutable MemoryVersion';
+    static args = { id: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = scoped_memory_command_1.scopedMemoryFlags;
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(MemoryVersionsShow);
+        const store = await this.resolveStore(flags);
+        const result = await this.memoryApi(flags.agent, `/stores/${store.id}/versions/${encodeURIComponent(args.id)}${this.query(flags)}`);
+        this.print(result, flags.json, `${result.id}  ${result.operation}\n${JSON.stringify(result.payloadSnapshot, null, 2)}`);
+    }
+}
+exports.default = MemoryVersionsShow;

package/dist/commands/messages/list.js

@@ -6,6 +6,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
 const task_transcript_1 = require("../../lib/task-transcript");
+const message_provenance_1 = require("../../lib/message-provenance");
 /**
  * OSK-2058 — resolve the conversation id from either calling convention.
  *
@@ -114,20 +115,36 @@ class MessagesList extends base_command_1.BaseCommand {
         }
         // TMessage has historically varied its shape across versions — accept
         // multiple field names and coerce to strings.
-        const rows = selected.map((m) => ({
-            when: m.createdAt ? new Date(String(m.createdAt)).toISOString().slice(11, 19) : '-',
-            role: String(m.sender ?? m.role ?? (m.isCreatedByUser ? 'user' : 'assistant')),
-            text: String(m.text ?? m.content ?? '')
-                .replace(/\s+/g, ' ')
-                .trim(),
-            id: String(m.messageId ?? m._id ?? m.id ?? '-'),
-        }));
+        // OSK-7708 — an unattended run's answer arrives with no question above it,
+        // so the row itself has to say what caused it. Without this a scheduled
+        // thread reads as an agent volunteering five answers to nothing.
+        let unattended = 0;
+        const rows = selected.map((m) => {
+            const provenance = (0, message_provenance_1.messageProvenance)(m);
+            if (provenance)
+                unattended += 1;
+            return {
+                when: m.createdAt ? new Date(String(m.createdAt)).toISOString().slice(11, 19) : '-',
+                role: String(m.sender ?? m.role ?? (m.isCreatedByUser ? 'user' : 'assistant')),
+                via: provenance ? (0, message_provenance_1.provenanceLabel)(provenance) : '-',
+                text: String(m.text ?? m.content ?? '')
+                    .replace(/\s+/g, ' ')
+                    .trim(),
+                id: String(m.messageId ?? m._id ?? m.id ?? '-'),
+            };
+        });
         (0, format_1.renderTable)(rows, [
             { key: 'when', header: 'TIME' },
             { key: 'role', header: 'ROLE', maxWidth: 12 },
+            { key: 'via', header: 'VIA', maxWidth: 10 },
             { key: 'text', header: 'TEXT', maxWidth: 80 },
             { key: 'id', header: 'ID' },
         ], (line) => this.log(line));
+        if (unattended > 0) {
+            this.log('');
+            this.log(`${unattended} message${unattended === 1 ? '' : 's'} came from an unattended run, so no prompt precedes ${unattended === 1 ? 'it' : 'them'} here.`);
+            this.log(`  skrr messages show ${convoId} <message-id>   # what the run was asked`);
+        }
         // Never let a cap read as "this is the whole transcript".
         if (truncated) {
             this.log('');

package/dist/commands/messages/show.js

@@ -4,6 +4,7 @@ exports.firstMessageFromDetailResponse = firstMessageFromDetailResponse;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
+const message_provenance_1 = require("../../lib/message-provenance");
 /** The detail endpoint preserves the legacy raw-array response while the list
  * endpoint returns an envelope. Accept both so an ID emitted by messages list
  * is always usable by messages show. */
@@ -63,6 +64,15 @@ class MessagesShow extends base_command_1.BaseCommand {
             this.log(`Updated:      ${formatTime(msg.updatedAt)}`);
         if (msg.tokenCount !== undefined)
             this.log(`Tokens:       ${msg.tokenCount}`);
+        // OSK-7682 — an unattended run persists no user message, so this row is the
+        // only place its instruction can be read. Print the question before the
+        // answer, which is the order a reader needs them in.
+        const provenance = (0, message_provenance_1.messageProvenance)(msg);
+        if (provenance) {
+            for (const line of (0, message_provenance_1.provenanceLines)(provenance)) {
+                this.log(line);
+            }
+        }
         this.log('');
         this.log('Text:');
         this.log(String(msg.text ?? msg.content ?? ''));

package/dist/commands/spaces/update.js

@@ -76,7 +76,9 @@ class SpacesUpdate extends base_command_1.BaseCommand {
             description: tasks_1.EXPECT_FLAG_HELP +
                 ' This is the space DEFAULT, and it is where the contract actually gets set: nobody ' +
                 'declares one per task, but a space default is configured once and then holds. A ' +
-                'per-task --expect wins. Merged into deliveryPolicy without clobbering its other fields.',
+                'per-task --expect wins. Merged into deliveryPolicy without clobbering its other ' +
+                'fields. Replaces the whole list; pass "clear" to remove the default so new tasks ' +
+                'inherit nothing.',
         }),
         'delivery-mode': core_1.Flags.string({
             options: ['none', 'branch', 'pr', 'pr_automerge', 'direct'],
@@ -132,21 +134,23 @@ class SpacesUpdate extends base_command_1.BaseCommand {
         // Parse before any write: a bad spec must fail here, not reach the server
         // as a silently-dropped field. A space default nobody is enforcing is worse
         // than none, because every task under it then shows a contract that isn't real.
-        let defaultExpectations;
-        if (flags['default-expect'] !== undefined && flags['default-expect'].length > 0) {
-            const parsed = (0, tasks_1.parseExpectations)(flags['default-expect']);
-            if (!parsed.ok) {
-                this.error(parsed.error, { exit: 1 });
-            }
-            else {
-                defaultExpectations = parsed.value;
-            }
+        const resolvedDefaults = (0, tasks_1.resolveDefaultExpectations)(flags['default-expect']);
+        if (!resolvedDefaults.ok) {
+            this.error(resolvedDefaults.error, { exit: 1 });
         }
+        const defaultExpectations = resolvedDefaults.ok ? resolvedDefaults.value : undefined;
         const isolation = flags['worktree-isolation'];
         const deliveryMode = flags['delivery-mode'];
         const integrationBranch = flags['integration-branch'];
         const autoMergeTier = flags['auto-merge-tier'];
-        if (isolation || defaultExpectations || deliveryMode || integrationBranch || autoMergeTier) {
+        // `defaultExpectations === null` is a real instruction (remove the default), so
+        // it must reach the policy merge — a truthiness test dropped it silently and
+        // made `clear` a no-op that printed success.
+        if (isolation ||
+            defaultExpectations !== undefined ||
+            deliveryMode ||
+            integrationBranch ||
+            autoMergeTier) {
             let basePolicy = {};
             if (payload.deliveryPolicy && typeof payload.deliveryPolicy === 'object') {
                 basePolicy = { ...payload.deliveryPolicy };
@@ -169,7 +173,7 @@ class SpacesUpdate extends base_command_1.BaseCommand {
                 ...(deliveryMode ? { mode: deliveryMode } : {}),
                 ...(integrationBranch ? { integrationBranch } : {}),
                 ...(autoMergeTier ? { autoMergeTrustTier: autoMergeTier } : {}),
-                ...(defaultExpectations ? { defaultExpectations } : {}),
+                ...(defaultExpectations !== undefined ? { defaultExpectations } : {}),
             };
         }
         // Goal links are NOT part of the PATCH body — the server rejects a PATCH

package/dist/commands/spaces/work-sync/reconcile.d.ts

@@ -0,0 +1,38 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * `skrr spaces work-sync reconcile <space>` — answer the divergence question
+ * without a browser, and repair what it finds.
+ *
+ * Root `CLAUDE.md` records that two Work Sync exit criteria were knowingly
+ * overridden, and that "an unexplained board divergence is a live hypothesis, not
+ * an impossibility, and is the first thing to suspect." `work-sync telemetry`
+ * reports whether the browser's convergence detector has ever RUN. This answers
+ * the underlying question directly: it compares every published projection entry
+ * against authoritative task truth server-side, and `upserts` is the count that
+ * disagreed.
+ *
+ * That matters because the detector only runs where a board is open. A Space
+ * nobody has visited since the detector shipped reports zero comparisons forever,
+ * which is indistinguishable from health in the telemetry and is not health. This
+ * command needs no board, no browser, and no visitor.
+ *
+ * IT WRITES, and the help says so plainly rather than burying it. The endpoint is
+ * editor-gated because it republishes projection rows that clients will see. It
+ * never mutates task truth — the projection is derived, and a republished card is
+ * a corrected copy of a Task nobody touched — and on a healthy scope it finds
+ * nothing and changes nothing, so the verification and the repair are the same
+ * call. There is deliberately no dry-run flag to add: a read-only variant would be
+ * a second implementation of the comparison, which is how the two answers start
+ * disagreeing.
+ */
+export default class SpacesWorkSyncReconcile extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        space: 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/spaces/work-sync/reconcile.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const work_sync_1 = require("../../../lib/work-sync");
+/**
+ * `skrr spaces work-sync reconcile <space>` — answer the divergence question
+ * without a browser, and repair what it finds.
+ *
+ * Root `CLAUDE.md` records that two Work Sync exit criteria were knowingly
+ * overridden, and that "an unexplained board divergence is a live hypothesis, not
+ * an impossibility, and is the first thing to suspect." `work-sync telemetry`
+ * reports whether the browser's convergence detector has ever RUN. This answers
+ * the underlying question directly: it compares every published projection entry
+ * against authoritative task truth server-side, and `upserts` is the count that
+ * disagreed.
+ *
+ * That matters because the detector only runs where a board is open. A Space
+ * nobody has visited since the detector shipped reports zero comparisons forever,
+ * which is indistinguishable from health in the telemetry and is not health. This
+ * command needs no board, no browser, and no visitor.
+ *
+ * IT WRITES, and the help says so plainly rather than burying it. The endpoint is
+ * editor-gated because it republishes projection rows that clients will see. It
+ * never mutates task truth — the projection is derived, and a republished card is
+ * a corrected copy of a Task nobody touched — and on a healthy scope it finds
+ * nothing and changes nothing, so the verification and the repair are the same
+ * call. There is deliberately no dry-run flag to add: a read-only variant would be
+ * a second implementation of the comparison, which is how the two answers start
+ * disagreeing.
+ */
+class SpacesWorkSyncReconcile extends base_command_1.BaseCommand {
+    static description = 'Compare a Space Work Sync projection against task truth and repair what diverged (writes)';
+    static examples = [
+        '<%= config.bin %> spaces work-sync reconcile <space-id>',
+        '<%= config.bin %> spaces work-sync reconcile <space-id> --json',
+    ];
+    static args = {
+        space: core_1.Args.string({ description: 'Space ID', 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(SpacesWorkSyncReconcile);
+        let result;
+        try {
+            result = await (0, work_sync_1.reconcileWorkSyncScope)(args.space);
+        }
+        catch (err) {
+            this.handleApiError(err);
+            return;
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const diverged = (result.upserts || 0) +
+            (result.removes || 0) +
+            (result.summaryUpserts || 0) +
+            (result.summaryRemoves || 0);
+        // Lead with the verdict, because it is the whole reason to run this. A table
+        // of four zeros under no summary line makes the reader do the addition.
+        if (diverged === 0) {
+            this.log('No divergence: every published projection entry matches task truth.');
+        }
+        else {
+            this.log(`Divergence found and repaired: ${diverged} ${diverged === 1 ? 'entry' : 'entries'}.`);
+            this.log('');
+            this.log(`  stale task cards republished   ${result.upserts || 0}`);
+            this.log(`  task cards removed             ${result.removes || 0}`);
+            this.log(`  stale summaries republished    ${result.summaryUpserts || 0}`);
+            this.log(`  summaries removed              ${result.summaryRemoves || 0}`);
+        }
+        if (result.backlog > 0) {
+            this.log('');
+            this.log(`${result.backlog} repair ${result.backlog === 1 ? 'row was' : 'rows were'} already queued ` +
+                'by earlier publish failures. A successful run settles them; one that failed again is kept.');
+        }
+        if (result.truncated) {
+            this.log('');
+            // Never let a partial pass read as a clean one. The scope read is capped at
+            // 1000 rows, so a larger Space was only checked as far as the cap.
+            this.log('PARTIAL: this Space is larger than the 1000-row reconciliation cap, so the ' +
+                'verdict above covers a prefix of it and not the whole Space.');
+        }
+    }
+}
+exports.default = SpacesWorkSyncReconcile;

package/dist/commands/spaces/work-sync/telemetry.d.ts

@@ -0,0 +1,29 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * `skrr spaces work-sync telemetry <space>` — Work Sync's own exit criteria.
+ *
+ * Work Sync v1 is ON at 100% (owner decision, 2026-09-08) with two criteria
+ * knowingly overridden rather than satisfied. The server has computed the verdict
+ * the whole time, and nothing outside the API could read it — so checking the
+ * criteria meant querying the production database by hand, which is why nobody
+ * did. An exit criterion that can only be read by hand is one that does not get
+ * read.
+ *
+ * The verdict is printed as the server decided it. This command does not
+ * re-derive it: the same rule that keeps `tasks expectations` reading the server's
+ * judgement rather than computing its own applies here, and for the same reason —
+ * a CLI that reached a different conclusion from the service would leave the
+ * reader unable to tell which was lying.
+ */
+export default class SpacesWorkSyncTelemetry extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        space: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}