@skrr-ai/cli 0.1.22 → 0.1.23

package/dist/commands/memory/search.js

@@ -2,15 +2,15 @@
 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");
+const scoped_memory_command_1 = require("../../lib/scoped-memory-command");
 const format_1 = require("../../lib/format");
 const memory_scope_1 = require("../../lib/memory-scope");
-class MemorySearch extends base_command_1.BaseCommand {
+class MemorySearch extends scoped_memory_command_1.ScopedMemoryCommand {
     static description = 'Semantic (hybrid vector + text) search over a memory pool — the same ranking the agent sees';
     static examples = [
         '<%= config.bin %> memory search "dark mode preference"',
         '<%= config.bin %> memory search "billing" --agent agent_abc123',
-        '<%= config.bin %> memory search "team norms" --tier workspace --workspace ws_123',
+        '<%= config.bin %> memory search "team norms" --tier workspace --pool-workspace ws_123',
         '<%= config.bin %> memory search "onboarding" --max-results 10 --json',
     ];
     static args = {
@@ -21,10 +21,34 @@ class MemorySearch extends base_command_1.BaseCommand {
         'max-results': core_1.Flags.integer({ description: 'Maximum results (1-50)', default: 6 }),
         'min-score': core_1.Flags.string({ description: 'Minimum score 0-1 (default: 0.35)' }),
         ...memory_scope_1.memoryScopeFlags,
+        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-context': core_1.Flags.string({ description: 'Current Space context for canonical mounts' }),
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(MemorySearch);
+        if (flags.store || flags.scope) {
+            if (!flags.agent)
+                this.error('--agent is required with --store or --scope.', { exit: 2 });
+            const canonicalFlags = {
+                agent: flags.agent,
+                store: flags.store,
+                scope: flags.scope,
+                space: flags['space-context'],
+                json: flags.json,
+            };
+            const store = await this.resolveStore(canonicalFlags);
+            const response = await this.memoryApi(flags.agent, `/stores/${store.id}/search${this.query(canonicalFlags, { q: args.query, limit: flags['max-results'] })}`);
+            if (flags.json)
+                this.log(JSON.stringify(response, null, 2));
+            else if (!response.results?.length)
+                this.log(`No memories matched "${args.query}".`);
+            else
+                for (const result of response.results)
+                    this.log(`${Number(result.score || 0).toFixed(2)}  ${result.node.path}  ${result.content}`);
+            return;
+        }
         const scope = (0, memory_scope_1.resolveMemoryScopeOrFail)(flags, (m) => this.error(m, { exit: 1 }));
         let minScore;
         if (flags['min-score'] !== undefined) {

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

@@ -8,7 +8,7 @@ export default class MemoryShow 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>;
     };
     run(): Promise<void>;

package/dist/commands/memory/stores/archive.d.ts

@@ -0,0 +1,14 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresArchive extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        'expected-revision': import("@oclif/core/lib/interfaces").OptionFlag<number, 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/stores/archive.js

@@ -0,0 +1,31 @@
+"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 MemoryStoresArchive extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Archive a Memory Store before deletion';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        'expected-revision': core_1.Flags.integer({ required: true }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Run server validation without archiving the Store',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresArchive);
+        const store = await this.resolveStore(flags, { write: true });
+        const body = {
+            status: 'archived',
+            expectedRevision: flags['expected-revision'],
+            ...(flags.space ? { spaceId: flags.space } : {}),
+            ...(flags['dry-run'] ? { dryRun: true } : {}),
+        };
+        const result = await this.memoryApi(flags.agent, `/stores/${encodeURIComponent(store.id)}`, {
+            method: 'PATCH',
+            body,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no Store changed.' : `Archived Memory Store ${store.id}.`);
+    }
+}
+exports.default = MemoryStoresArchive;

package/dist/commands/memory/stores/create.d.ts

@@ -0,0 +1,12 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresCreate extends ScopedMemoryCommand {
+    static description: string;
+    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>;
+        scope: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,30 @@
+"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 MemoryStoresCreate extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Ensure the authorized Agent or current Space Memory Store exists';
+    static flags = {
+        agent: core_1.Flags.string({ required: true }),
+        space: core_1.Flags.string(),
+        scope: core_1.Flags.string({ required: true, description: 'agent:<id> or space:<id>' }),
+        json: core_1.Flags.boolean(),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Run server validation without creating the Store',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresCreate);
+        const body = {
+            scope: flags.scope,
+            ...(flags.space ? { spaceId: flags.space } : {}),
+            ...(flags['dry-run'] ? { dryRun: true } : {}),
+        };
+        const result = await this.memoryApi(flags.agent, '/stores', { method: 'POST', body });
+        this.print(result, flags.json, flags['dry-run']
+            ? 'Dry run: Store ensure request passed server validation.'
+            : `Memory Store ${result.id} is ready.`);
+    }
+}
+exports.default = MemoryStoresCreate;

package/dist/commands/memory/stores/delete.d.ts

@@ -0,0 +1,15 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresDelete extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        'expected-revision': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        '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/stores/delete.js

@@ -0,0 +1,38 @@
+"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 MemoryStoresDelete extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Permanently delete an already-archived Memory Store';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        'expected-revision': core_1.Flags.integer({ required: true }),
+        yes: core_1.Flags.boolean({ char: 'y' }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Run server validation without deleting the Store',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresDelete);
+        const store = await this.resolveStore(flags, { write: true });
+        if (!flags['dry-run']) {
+            const ok = await (0, prompt_1.confirmDestructive)(`Permanently delete archived Memory Store ${store.id}?`, flags.yes).catch((error) => this.error(error.message, { exit: error.exit || 7 }));
+            if (!ok)
+                return this.log('Cancelled.');
+        }
+        const body = {
+            confirmStoreId: store.id,
+            expectedRevision: flags['expected-revision'],
+            ...(flags.space ? { spaceId: flags.space } : {}),
+            ...(flags['dry-run'] ? { dryRun: true } : {}),
+        };
+        const result = await this.memoryApi(flags.agent, `/stores/${encodeURIComponent(store.id)}`, {
+            method: 'DELETE',
+            body,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no Store deleted.' : `Deleted Memory Store ${store.id}.`);
+    }
+}
+exports.default = MemoryStoresDelete;

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

@@ -0,0 +1,10 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresList extends ScopedMemoryCommand {
+    static description: string;
+    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>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_schemas_1 = require("@skrr-ai/data-schemas");
+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 flags = {
+        agent: core_1.Flags.string({ required: true }),
+        space: core_1.Flags.string({ description: 'Current Space context' }),
+        json: core_1.Flags.boolean({ description: 'Output stable JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresList);
+        const response = await this.memoryApi(flags.agent, `/stores${this.query(flags)}`);
+        const result = {
+            stores: response.stores.map((store) => data_schemas_1.MountedMemoryStoreSchema.parse(store)),
+        };
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        for (const store of result.stores) {
+            this.log(`${store.id}  ${store.owner.kind}:${store.owner.id}  ${store.mount.access}  r${store.revision}`);
+        }
+        if (!result.stores.length)
+            this.log('No mounted Memory Stores.');
+    }
+}
+exports.default = MemoryStoresList;

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

@@ -0,0 +1,12 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresShow extends ScopedMemoryCommand {
+    static description: string;
+    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/stores/show.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+class MemoryStoresShow extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Show one mounted Memory Store';
+    static flags = scoped_memory_command_1.scopedMemoryFlags;
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresShow);
+        const store = await this.resolveStore(flags);
+        this.print(store, flags.json, `${store.id}  ${store.owner.kind}:${store.owner.id}  ${store.status}  r${store.revision}`);
+    }
+}
+exports.default = MemoryStoresShow;

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

@@ -0,0 +1,15 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemoryStoresUpdate extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        attributes: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-revision': import("@oclif/core/lib/interfaces").OptionFlag<number, 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/stores/update.js

@@ -0,0 +1,39 @@
+"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 MemoryStoresUpdate extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Update Memory Store metadata with revision CAS';
+    static flags = {
+        ...scoped_memory_command_1.scopedMemoryFlags,
+        attributes: core_1.Flags.string({ description: 'Complete attributes JSON object', required: true }),
+        'expected-revision': core_1.Flags.integer({ required: true }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Run server validation without updating the Store',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemoryStoresUpdate);
+        const store = await this.resolveStore(flags, { write: true });
+        let attributes;
+        try {
+            attributes = JSON.parse(flags.attributes);
+        }
+        catch {
+            this.error('--attributes must be valid JSON.', { exit: 2 });
+        }
+        const body = {
+            attributes,
+            expectedRevision: flags['expected-revision'],
+            ...(flags.space ? { spaceId: flags.space } : {}),
+            ...(flags['dry-run'] ? { dryRun: true } : {}),
+        };
+        const result = await this.memoryApi(flags.agent, `/stores/${encodeURIComponent(store.id)}`, {
+            method: 'PATCH',
+            body,
+        });
+        this.print(result, flags.json, flags['dry-run'] ? 'Dry run: no Store changed.' : `Updated Memory Store ${store.id}.`);
+    }
+}
+exports.default = MemoryStoresUpdate;

package/dist/commands/memory/sync/delete.d.ts

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

package/dist/commands/memory/sync/delete.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const memory_sync_1 = require("../../../lib/memory-sync");
+const prompt_1 = require("../../../lib/prompt");
+class MemorySyncDelete extends base_command_1.BaseCommand {
+    static description = 'Delete a local topic file and stage its version-bound tombstone for the next sync push';
+    static args = {
+        memoryId: core_1.Args.string({
+            description: 'Materialized Memory topic ID',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        dir: core_1.Flags.string({ description: 'Materialized Memory directory', required: true }),
+        yes: core_1.Flags.boolean({ char: 'y', description: 'Confirm local deletion without prompting' }),
+        json: core_1.Flags.boolean({ description: 'Output stable JSON' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(MemorySyncDelete);
+        const ok = await (0, prompt_1.confirmDestructive)(`Delete the local file for Memory topic ${args.memoryId} and stage its permanent deletion?`, flags.yes).catch((error) => this.error(error.message, { exit: error.exit || 7 }));
+        if (!ok)
+            return this.log('Cancelled.');
+        const result = await (0, memory_sync_1.stageLocalDelete)(flags.dir, args.memoryId);
+        if (flags.json)
+            this.log(JSON.stringify(result, null, 2));
+        else {
+            this.log(`Staged deletion of ${result.file}.`);
+            this.log('Run `skrr memory sync push` with the same Store context to commit it.');
+        }
+    }
+}
+exports.default = MemorySyncDelete;

package/dist/commands/memory/sync/pull.d.ts

@@ -0,0 +1,19 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemorySyncPull extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        '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/sync/pull.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+const memory_sync_1 = require("../../../lib/memory-sync");
+class MemorySyncPull extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Pull canonical Store changes into a local materialized mount';
+    static flags = {
+        ...scoped_memory_command_1.mutationFlags,
+        dir: core_1.Flags.string({ required: true }),
+        cursor: core_1.Flags.string(),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemorySyncPull);
+        const binding = await (0, memory_sync_1.readMaterializationBinding)(flags.dir);
+        (0, memory_sync_1.assertMaterializationSpaceContext)(binding.manifest, flags.space);
+        const mounted = await this.memoryApi(flags.agent, `/mounts${this.query(flags)}`);
+        if (binding.manifest &&
+            !mounted.mounts.some((mount) => mount.storeId === binding.manifest?.storeId)) {
+            const revoked = await (0, memory_sync_1.revokeMaterialization)(flags.dir, Math.max(1, ...mounted.mounts.map((mount) => mount.authorizationGeneration + 1)));
+            const result = { status: 'revoked', storeId: binding.manifest.storeId, ...revoked };
+            return this.print(result, flags.json, `Access revoked; removed ${revoked.removed} protected projection(s).`);
+        }
+        const store = await this.resolveStore(flags);
+        const cursor = flags.cursor || (binding.manifest?.storeId === store.id ? binding.cursor : null);
+        if (cursor && !flags['dry-run']) {
+            let after = cursor;
+            let changed = 0;
+            let conflicts = 0;
+            let hasMore = true;
+            while (hasMore) {
+                const delta = await this.memoryApi(flags.agent, `/stores/${store.id}/sync/changes${this.query(flags, { after, limit: 500 })}`);
+                if (delta.resetRequired) {
+                    const snapshot = await this.memoryApi(flags.agent, `/stores/${store.id}/sync/snapshot${this.query(flags)}`);
+                    const reset = await (0, memory_sync_1.pullSnapshot)(flags.dir, snapshot);
+                    return this.print({ ...reset, reset: true, reason: delta.reason }, flags.json, `Cursor expired; refreshed the full snapshot (${reset.changed} change(s)).`);
+                }
+                const applied = await (0, memory_sync_1.pullChanges)(flags.dir, delta);
+                changed += applied.changed;
+                conflicts += applied.conflicts;
+                after = applied.cursor;
+                hasMore = delta.hasMore === true;
+            }
+            return this.print({ changed, conflicts, cursor: after, incremental: true }, flags.json, `Pulled ${changed} incremental change(s).`);
+        }
+        const snapshot = await this.memoryApi(flags.agent, `/stores/${store.id}/sync/snapshot${this.query(flags)}`);
+        const result = await (0, memory_sync_1.pullSnapshot)(flags.dir, snapshot, { dryRun: flags['dry-run'] });
+        this.print(result, flags.json, `${flags['dry-run'] ? 'Would pull' : 'Pulled'} ${result.changed ?? 0} change(s).`);
+    }
+}
+exports.default = MemorySyncPull;

package/dist/commands/memory/sync/push.d.ts

@@ -0,0 +1,18 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemorySyncPush extends ScopedMemoryCommand {
+    static description: string;
+    static flags: {
+        dir: 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>;
+        '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/sync/push.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const scoped_memory_command_1 = require("../../../lib/scoped-memory-command");
+const api_fetch_1 = require("../../../lib/api-fetch");
+const memory_sync_1 = require("../../../lib/memory-sync");
+class MemorySyncPush extends scoped_memory_command_1.ScopedMemoryCommand {
+    static description = 'Push eligible local topic edits through canonical versioned mutations';
+    static flags = { ...scoped_memory_command_1.mutationFlags, dir: core_1.Flags.string({ required: true }) };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(MemorySyncPush);
+        const store = await this.resolveStore(flags, { write: true });
+        const binding = await (0, memory_sync_1.readMaterializationBinding)(flags.dir);
+        (0, memory_sync_1.assertMaterializationStore)(binding.manifest, store.id);
+        const plan = await (0, memory_sync_1.planPush)(flags.dir, { recordConflicts: !flags['dry-run'] });
+        const results = [];
+        for (const item of plan.mutations) {
+            const body = {
+                ...item.input,
+                ...(flags.space ? { spaceId: flags.space } : {}),
+                targetStoreId: store.id,
+                authorizationGeneration: flags['authorization-generation'] ??
+                    store.mount?.authorizationGeneration ??
+                    store.authorizationGeneration,
+                ...(flags['privacy-approval'] ? { privacyApprovalId: flags['privacy-approval'] } : {}),
+                ...(flags['dry-run'] ? { dryRun: true } : {}),
+            };
+            try {
+                results.push(await (0, api_fetch_1.apiFetch)(this.endpoint(flags.agent, `/mutations/${encodeURIComponent(item.operation)}`), { method: 'POST', body }));
+            }
+            catch (error) {
+                let causeCode = error instanceof api_fetch_1.ApiFetchError ? error.code : undefined;
+                let causeMessage = error instanceof Error ? error.message : String(error);
+                if (error instanceof api_fetch_1.ApiFetchError) {
+                    try {
+                        const parsed = JSON.parse(error.body || '{}');
+                        causeCode = parsed.code || parsed.error || causeCode;
+                        causeMessage = parsed.message || causeMessage;
+                    }
+                    catch {
+                        // Preserve the transport code/message when the body is not JSON.
+                    }
+                }
+                const dryRun = flags['dry-run'] === true;
+                const partial = {
+                    status: dryRun ? 'validation_failure' : 'partial_failure',
+                    code: dryRun
+                        ? 'MEMORY_SYNC_DRY_RUN_VALIDATION_FAILED'
+                        : 'MEMORY_SYNC_PARTIAL_PUSH_FAILED',
+                    planned: plan.mutations.length,
+                    committed: dryRun ? 0 : results.length,
+                    validated: dryRun ? results.length : undefined,
+                    remoteCommitted: !dryRun && results.length > 0,
+                    failedFile: item.file,
+                    retryable: true,
+                    causeCode,
+                    causeMessage,
+                    results,
+                    next: dryRun
+                        ? 'No remote changes were committed. Fix the failed file and rerun the dry-run.'
+                        : 'Inspect the failed file, then retry with the unchanged directory. Completed items reuse stable idempotency keys.',
+                };
+                if (flags.json)
+                    this.log(JSON.stringify(partial, null, 2));
+                else {
+                    this.log(dryRun
+                        ? `Dry-run validation failed after ${results.length}/${plan.mutations.length} item(s); no remote changes were committed.`
+                        : `Partial push: ${results.length}/${plan.mutations.length} remote change(s) committed before ${item.file} failed.`);
+                    this.log(partial.next);
+                }
+                process.exitCode =
+                    error instanceof api_fetch_1.ApiFetchError && error.status === 409
+                        ? 6
+                        : error instanceof api_fetch_1.ApiFetchError && error.status === 403
+                            ? 5
+                            : error instanceof api_fetch_1.ApiFetchError && error.status === 404
+                                ? 4
+                                : 2;
+                return;
+            }
+        }
+        let localRefresh = { status: 'not_required' };
+        if (!flags['dry-run'] && plan.mutations.length) {
+            try {
+                const snapshot = await (0, api_fetch_1.apiFetch)(this.endpoint(flags.agent, `/stores/${store.id}/sync/snapshot${this.query(flags)}`));
+                await (0, memory_sync_1.pullSnapshot)(flags.dir, snapshot);
+                localRefresh = { status: 'refreshed', cursor: snapshot.cursor };
+            }
+            catch (error) {
+                localRefresh = {
+                    status: 'failed',
+                    remoteCommitted: true,
+                    retryable: true,
+                    code: 'MEMORY_SYNC_LOCAL_REFRESH_FAILED',
+                    message: 'Remote Memory changes committed, but the local basis could not be refreshed. Retry this push with the unchanged files; stable idempotency keys prevent duplicate writes.',
+                    cause: error instanceof Error ? error.message : String(error),
+                };
+            }
+        }
+        const result = {
+            changed: plan.mutations.length,
+            conflicts: plan.conflicts,
+            unrecognizedFiles: plan.unrecognizedFiles,
+            nextActions: plan.nextActions,
+            results,
+            dryRun: flags['dry-run'],
+            localRefresh,
+        };
+        this.print(result, flags.json, localRefresh.status === 'failed'
+            ? `Committed ${result.changed} remote change(s), but local refresh failed. Retry the same push to recover safely.`
+            : `${flags['dry-run'] ? 'Would push' : 'Pushed'} ${result.changed} change(s); ${result.conflicts} conflict(s).`);
+    }
+}
+exports.default = MemorySyncPush;

package/dist/commands/memory/sync/resolve.d.ts

@@ -0,0 +1,23 @@
+import { ScopedMemoryCommand } from '../../../lib/scoped-memory-command';
+export default class MemorySyncResolve extends ScopedMemoryCommand {
+    static description: string;
+    static args: {
+        conflict: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        strategy: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        content: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        '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>;
+}