@knowzai/cli 0.1.0

package/dist/commands/repo/status.js

@@ -0,0 +1,60 @@
+import { Args } from '@oclif/core';
+import { existsSync } from 'node:fs';
+import { openLocalStore } from '@knowzai/local-store';
+import { BaseCommand } from '../../base-command.js';
+import { findRepoBinding, resolveRepoPath } from '../../lib/repo-binding.js';
+export default class RepoStatus extends BaseCommand {
+    static id = 'repo:status';
+    static description = 'Show the Knowz repo binding and local index status.';
+    static args = {
+        path: Args.string({ description: 'Repository path or nested path', default: '.' }),
+    };
+    async run() {
+        const { args } = await this.parse(RepoStatus);
+        const found = findRepoBinding(args.path);
+        if (!found) {
+            const missing = { configured: false };
+            if (!this.jsonEnabled())
+                this.log('No Knowz repo binding found. Run `knowz repo setup` first.');
+            return missing;
+        }
+        const binding = found.binding;
+        const dbPath = resolveRepoPath(binding, binding.dbPath);
+        const graphPath = resolveRepoPath(binding, binding.graphPath);
+        let local;
+        if (existsSync(dbPath)) {
+            const store = await openLocalStore({ driver: 'sqlite', dbPath });
+            try {
+                local = await store.meta();
+            }
+            finally {
+                await store.close();
+            }
+        }
+        const result = {
+            configured: true,
+            repoRoot: binding.repoRoot,
+            bindingPath: found.bindingPath,
+            profile: binding.profile,
+            apiUrl: binding.apiUrl,
+            vaultId: binding.vaultId,
+            ...(binding.vaultName ? { vaultName: binding.vaultName } : {}),
+            dbPath,
+            graphPath,
+            dbExists: existsSync(dbPath),
+            graphExists: existsSync(graphPath),
+            index: binding.index,
+            ...(local ? { local } : {}),
+        };
+        if (this.jsonEnabled())
+            return result;
+        this.log(`Knowz repo: ${binding.repoRoot}`);
+        this.log(`vault: ${binding.vaultName ? `${binding.vaultName} ` : ''}${binding.vaultId}`);
+        this.log(`db:    ${dbPath} (${result.dbExists ? 'exists' : 'missing'})`);
+        this.log(`graph: ${graphPath} (${result.graphExists ? 'exists' : 'missing'})`);
+        if (local)
+            this.log(`items: ${local.itemCount}, chunks: ${local.chunkCount}`);
+        return result;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/repo/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/repo/status.ts"],"names":[],"mappings":"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"}

package/dist/commands/restore.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../base-command.js';
+export default class Restore extends BaseCommand {
+    static description: string;
+    static args: {
+        archive: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'replace-installation': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        clone: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'config-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<import("../lib/platform-backup.js").PortableRestoreResult>;
+}
+//# sourceMappingURL=restore.d.ts.map

package/dist/commands/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAKhD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW;IAC9C,OAAgB,WAAW,SAAoF;IAC/G,OAAgB,IAAI;;MAAqG;IACzH,OAAgB,KAAK;;;;;;MAMpB;IAEK,GAAG;CAgCV"}

package/dist/commands/restore.js

@@ -0,0 +1,53 @@
+import { Args, Flags } from '@oclif/core';
+import { ExitCode, KnowzError, registerSecret } from '@knowzai/core';
+import { BaseCommand } from '../base-command.js';
+import { resolveEngineStatus, runEngineProbes } from '../lib/container-engine.js';
+import { resolveRestoreIdentityMode, runPortableRestore } from '../lib/platform-backup.js';
+import { nodeProcessRunner, resolvePlatformPaths } from '../lib/platform-runtime.js';
+export default class Restore extends BaseCommand {
+    static description = 'Restore a portable-platform backup after validating its manifest and checksums.';
+    static args = { archive: Args.string({ required: true, description: 'Backup .tar.gz or .tar.gz.enc archive' }) };
+    static flags = {
+        'replace-installation': Flags.boolean({ description: 'Restore the same installation identity and seat' }),
+        clone: Flags.boolean({ description: 'Create an empty identity volume for a new installation and seat' }),
+        name: Flags.string({ description: 'Runtime project name', default: 'knowz' }),
+        'config-dir': Flags.string({ description: 'Knowz configuration root' }),
+        yes: Flags.boolean({ char: 'y', description: 'Bypass typed destructive confirmation' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Restore);
+        const mode = resolveRestoreIdentityMode({
+            replaceInstallation: flags['replace-installation'], clone: flags.clone,
+        });
+        let passphrase = process.env.KNOWZ_BACKUP_PASSPHRASE;
+        if (args.archive.endsWith('.enc') && !passphrase) {
+            if (!process.stdin.isTTY)
+                throw new KnowzError('Set KNOWZ_BACKUP_PASSPHRASE to restore this encrypted backup.', ExitCode.Auth);
+            const { password } = await import('@inquirer/prompts');
+            passphrase = await password({ message: 'Backup passphrase (input is hidden)' });
+        }
+        if (passphrase)
+            registerSecret(passphrase);
+        const paths = resolvePlatformPaths(flags.name, flags['config-dir']);
+        const engine = resolveEngineStatus(runEngineProbes(nodeProcessRunner), process.platform, process.env);
+        const result = await runPortableRestore({
+            archive: args.archive,
+            paths,
+            projectName: flags.name,
+            mode,
+            yes: flags.yes,
+            isTty: process.stdin.isTTY === true,
+            passphrase,
+            engine,
+            runner: nodeProcessRunner,
+            confirmName: async () => {
+                const { input } = await import('@inquirer/prompts');
+                return input({ message: `Type '${flags.name}' to confirm destructive restore` });
+            },
+            emit: line => { if (!this.jsonEnabled())
+                this.log(line); },
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/commands/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"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"}

package/dist/commands/search.d.ts

@@ -0,0 +1,14 @@
+import type { SearchResult } from '@knowzai/types';
+import { BaseCommand } from '../base-command.js';
+export default class Search extends BaseCommand {
+    static description: string;
+    static args: {
+        query: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'include-children': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,OAAgB,WAAW,SAA0D;IACrF,OAAgB,IAAI;;MAA2E;IAC/F,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAmBrC"}

package/dist/commands/search.js

@@ -0,0 +1,32 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../base-command.js';
+export default class Search extends BaseCommand {
+    static description = 'Hybrid (keyword + semantic) search across knowledge.';
+    static args = { query: Args.string({ description: 'Search query', required: true }) };
+    static flags = {
+        limit: Flags.integer({ description: 'Max results', default: 10 }),
+        'include-children': Flags.boolean({ description: 'Include descendant vaults' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Search);
+        const client = await this.apiClient(flags);
+        const vaultId = await this.resolveVaultId(client, flags);
+        const results = await client.search.search({
+            q: args.query,
+            limit: flags.limit,
+            vaultId,
+            includeChildren: flags['include-children'],
+        });
+        if (this.jsonEnabled())
+            return results;
+        for (const r of results) {
+            const rel = Math.max(0, Math.min(100, Math.round(r.relevance * 100)));
+            this.log(`${String(rel).padStart(3)}%  ${r.title}  (${r.knowledgeId})`);
+            if (r.snippet)
+                this.log(`    ${r.snippet}`);
+        }
+        this.log(`\n${results.length} result(s)`);
+        return results;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,MAAM,CAAU,WAAW,GAAG,sDAAsD,CAAC;IACrF,MAAM,CAAU,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/F,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACjE,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;KAChF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YACzC,CAAC,EAAE,IAAI,CAAC,KAAK;YACb,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO;YACP,eAAe,EAAE,KAAK,CAAC,kBAAkB,CAAC;SAC3C,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,OAAO,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;YACxE,IAAI,CAAC,CAAC,OAAO;gBAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../base-command.js';
+export default class Setup extends BaseCommand {
+    static id: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        version: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-port': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'web-port': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'mcp-port': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'public-site-port': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'with-mcp': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'with-public-site': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'config-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<{
+        status: string;
+        url: string;
+        result?: unknown;
+    }>;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;IAC5C,OAAgB,EAAE,SAAW;IAC7B,OAAgB,WAAW,SAAmF;IAC9G,OAAgB,QAAQ,WAGtB;IACF,OAAgB,KAAK;;;;;;;;;;;MAAqB;IAEpC,GAAG,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAYxE"}

package/dist/commands/setup.js

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../base-command.js';
+import { runSetupConsoleCommand, setupConsoleFlags } from '../lib/platform-command-shared.js';
+export default class Setup extends BaseCommand {
+    static id = 'setup';
+    static description = 'Open the one-shot loopback setup console for a local portable Knowz platform.';
+    static examples = [
+        '<%= config.bin %> setup',
+        '<%= config.bin %> setup --no-open',
+    ];
+    static flags = setupConsoleFlags;
+    async run() {
+        const { flags } = await this.parse(Setup);
+        return runSetupConsoleCommand({
+            authState: (authFlags) => this.authState(authFlags),
+            cliVersion: this.config?.version ?? '0.0.0',
+            jsonEnabled: () => this.jsonEnabled(),
+            log: (line) => this.log(line),
+        }, flags);
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE9F,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;IAC5C,MAAM,CAAU,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAU,WAAW,GAAG,+EAA+E,CAAC;IAC9G,MAAM,CAAU,QAAQ,GAAG;QACzB,yBAAyB;QACzB,mCAAmC;KACpC,CAAC;IACF,MAAM,CAAU,KAAK,GAAG,iBAAiB,CAAC;IAE1C,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,sBAAsB,CAC3B;YACE,SAAS,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;YACnD,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,OAAO;YAC3C,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;YACrC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;SAC9B,EACD,KAAK,CACN,CAAC;IACJ,CAAC"}

package/dist/commands/stats.d.ts

@@ -0,0 +1,6 @@
+import { BaseCommand } from '../base-command.js';
+export default class Stats extends BaseCommand {
+    static description: string;
+    run(): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;IAC5C,OAAgB,WAAW,SAAyD;IAE9E,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAU9C"}

package/dist/commands/stats.js

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../base-command.js';
+export default class Stats extends BaseCommand {
+    static description = 'Show aggregate knowledge statistics for the tenant.';
+    async run() {
+        const { flags } = await this.parse(Stats);
+        const client = await this.apiClient(flags);
+        const stats = await client.stats.get();
+        if (this.jsonEnabled())
+            return stats;
+        for (const [k, v] of Object.entries(stats)) {
+            this.log(`${k}: ${typeof v === 'object' ? JSON.stringify(v) : String(v)}`);
+        }
+        return stats;
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;IAC5C,MAAM,CAAU,WAAW,GAAG,qDAAqD,CAAC;IAEpF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,KAAK,CAAC;QACrC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../base-command.js';
+export interface StatusReport {
+    cliVersion: string;
+    profile: string;
+    apiUrl: string;
+    configPath: string;
+    /** N3 wires real auth state; 'unknown' until then. */
+    authenticated: 'unknown' | boolean;
+}
+/** Pure, testable status report builder (no oclif dependency). */
+export declare function buildStatusReport(flags: {
+    profile?: string;
+    'api-url'?: string;
+}, cliVersion: string): StatusReport;
+export default class Status extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<StatusReport>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,aAAa,EAAE,SAAS,GAAG,OAAO,CAAC;CACpC;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/C,UAAU,EAAE,MAAM,GACjB,YAAY,CAKd;AAED,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,OAAgB,WAAW,SACqE;IAChG,OAAgB,QAAQ,WAAmE;IAErF,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;CAiBnC"}

package/dist/commands/status.js

@@ -0,0 +1,33 @@
+import { BaseCommand } from '../base-command.js';
+import { loadConfig, resolveProfileName, resolveApiUrl, configPath } from '@knowzai/core';
+/** Pure, testable status report builder (no oclif dependency). */
+export function buildStatusReport(flags, cliVersion) {
+    const cfg = loadConfig();
+    const profile = resolveProfileName({ profileFlag: flags.profile }, cfg);
+    const apiUrl = resolveApiUrl({ apiUrlFlag: flags['api-url'], profileFlag: flags.profile }, cfg);
+    return { cliVersion, profile, apiUrl, configPath: configPath(), authenticated: 'unknown' };
+}
+export default class Status extends BaseCommand {
+    static description = 'Show CLI status: active profile, resolved API URL, config path, and version. Works offline.';
+    static examples = ['<%= config.bin %> status', '<%= config.bin %> status --json'];
+    async run() {
+        const { flags } = await this.parse(Status);
+        const report = buildStatusReport(flags, this.config.version);
+        // Resolve real auth state (offline — reads the local credential store only).
+        try {
+            report.authenticated = await (await this.authState(flags)).isAuthenticated();
+        }
+        catch {
+            /* leave 'unknown' if the credential store can't be read */
+        }
+        if (this.jsonEnabled())
+            return report;
+        this.log(`knowz ${report.cliVersion}`);
+        this.log(`profile:  ${report.profile}`);
+        this.log(`api url:  ${report.apiUrl}`);
+        this.log(`config:   ${report.configPath}`);
+        this.log(`auth:     ${report.authenticated === true ? 'logged in' : report.authenticated === false ? 'logged out' : 'unknown'}`);
+        return report;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAW1F,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAC/B,KAA+C,EAC/C,UAAkB;IAElB,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IAChG,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,MAAM,CAAU,WAAW,GACzB,6FAA6F,CAAC;IAChG,MAAM,CAAU,QAAQ,GAAG,CAAC,0BAA0B,EAAE,iCAAiC,CAAC,CAAC;IAE3F,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7D,6EAA6E;QAC7E,IAAI,CAAC;YACH,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;QAC/E,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,MAAM,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACjI,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/sync/conflicts.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base-command.js';
+export default class SyncConflicts extends BaseCommand {
+    static id: string;
+    static description: string;
+    static flags: {
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        dsn: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<{
+        id: string;
+        title: string;
+    }[]>;
+}
+//# sourceMappingURL=conflicts.d.ts.map

package/dist/commands/sync/conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/conflicts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,EAAE,SAAoB;IACtC,OAAgB,WAAW,SAAwF;IACnH,OAAgB,KAAK;;;MAAgF;IAE/F,GAAG,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAYtD"}

package/dist/commands/sync/conflicts.js

@@ -0,0 +1,23 @@
+import { Flags } from '@oclif/core';
+import { SyncEngine } from '@knowzai/local-store';
+import { BaseCommand } from '../../base-command.js';
+export default class SyncConflicts extends BaseCommand {
+    static id = 'sync:conflicts';
+    static description = 'List items in conflict (local + remote both changed). Resolve with `sync resolve`.';
+    static flags = { db: Flags.string({ description: 'SQLite db path' }), dsn: Flags.string() };
+    async run() {
+        const { flags } = await this.parse(SyncConflicts);
+        const store = await this.localStore(flags, flags);
+        const client = await this.apiClient(flags);
+        const conflicts = await new SyncEngine(store, client).listConflicts();
+        await store.close();
+        const out = conflicts.map((c) => ({ id: c.id, title: c.title }));
+        if (this.jsonEnabled())
+            return out;
+        for (const c of out)
+            this.log(`${c.id}  ${c.title}`);
+        this.log(`\n${out.length} conflict(s)${out.length ? ' — resolve with: knowz sync resolve <id> --keep-local|--keep-remote' : ''}`);
+        return out;
+    }
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/commands/sync/conflicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.js","sourceRoot":"","sources":["../../../src/commands/sync/conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,MAAM,CAAU,EAAE,GAAG,gBAAgB,CAAC;IACtC,MAAM,CAAU,WAAW,GAAG,oFAAoF,CAAC;IACnH,MAAM,CAAU,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;IAErG,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QACtE,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,GAAG,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,qEAAqE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClI,OAAO,GAAG,CAAC;IACb,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type SyncReport } from '@knowzai/local-store';
+import { BaseCommand } from '../../base-command.js';
+export default class SyncPull extends BaseCommand {
+    static description: string;
+    static flags: {
+        driver: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        dsn: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        passphrase: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<SyncReport>;
+}
+//# sourceMappingURL=pull.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/pull.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,OAAgB,WAAW,SAAyD;IACpF,OAAgB,KAAK;;;;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;CAYjC"}

package/dist/commands/sync/pull.js

@@ -0,0 +1,26 @@
+import { Flags } from '@oclif/core';
+import { SyncEngine } from '@knowzai/local-store';
+import { BaseCommand } from '../../base-command.js';
+export default class SyncPull extends BaseCommand {
+    static description = 'Pull knowledge from the cloud into the local store.';
+    static flags = {
+        driver: Flags.string({ options: ['sqlite', 'postgres'] }),
+        db: Flags.string({ description: 'SQLite db path' }),
+        dsn: Flags.string({ description: 'Postgres DSN' }),
+        passphrase: Flags.string({ description: 'CMEK passphrase (if the profile is CMEK-enabled)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(SyncPull);
+        const store = await this.localStore(flags, flags);
+        const client = await this.apiClient(flags);
+        const encryptor = this.cmekEncryptor({ ...flags, passphrase: flags.passphrase });
+        const vaultId = flags.vault ? await this.resolveVaultId(client, flags) : undefined;
+        const report = await new SyncEngine(store, client, { encryptor }).pull({ vaultId });
+        await store.close();
+        if (this.jsonEnabled())
+            return report;
+        this.log(`pulled ${report.pulled}, skipped ${report.skipped}, conflicts ${report.conflicts.length}`);
+        return report;
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/sync/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../../src/commands/sync/pull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAU,WAAW,GAAG,qDAAqD,CAAC;IACpF,MAAM,CAAU,KAAK,GAAG;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACzD,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;QACnD,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;QAClD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;KAC9F,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACjF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,MAAM,MAAM,GAAG,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACpF,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,MAAM,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,MAAM,aAAa,MAAM,CAAC,OAAO,eAAe,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACrG,OAAO,MAAM,CAAC;IAChB,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type SyncReport } from '@knowzai/local-store';
+import { BaseCommand } from '../../base-command.js';
+export default class SyncPush extends BaseCommand {
+    static description: string;
+    static flags: {
+        driver: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        dsn: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        passphrase: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<SyncReport>;
+}
+//# sourceMappingURL=push.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/push.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,OAAgB,WAAW,SAAkD;IAC7E,OAAgB,KAAK;;;;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;CAYjC"}

package/dist/commands/sync/push.js

@@ -0,0 +1,26 @@
+import { Flags } from '@oclif/core';
+import { SyncEngine } from '@knowzai/local-store';
+import { BaseCommand } from '../../base-command.js';
+export default class SyncPush extends BaseCommand {
+    static description = 'Push local new/dirty knowledge to the cloud.';
+    static flags = {
+        driver: Flags.string({ options: ['sqlite', 'postgres'] }),
+        db: Flags.string({ description: 'SQLite db path' }),
+        dsn: Flags.string({ description: 'Postgres DSN' }),
+        passphrase: Flags.string({ description: 'CMEK passphrase (if the profile is CMEK-enabled)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(SyncPush);
+        const store = await this.localStore(flags, flags);
+        const client = await this.apiClient(flags);
+        const encryptor = this.cmekEncryptor({ ...flags, passphrase: flags.passphrase });
+        const vaultId = flags.vault ? await this.resolveVaultId(client, flags) : undefined;
+        const report = await new SyncEngine(store, client, { encryptor }).push({ vaultId });
+        await store.close();
+        if (this.jsonEnabled())
+            return report;
+        this.log(`pushed ${report.pushed}, conflicts ${report.conflicts.length}`);
+        return report;
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/commands/sync/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/commands/sync/push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAU,WAAW,GAAG,8CAA8C,CAAC;IAC7E,MAAM,CAAU,KAAK,GAAG;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACzD,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;QACnD,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;QAClD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;KAC9F,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACjF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,MAAM,MAAM,GAAG,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACpF,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,MAAM,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,MAAM,eAAe,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/sync/recover.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command.js';
+export default class SyncRecover extends BaseCommand {
+    static id: string;
+    static description: string;
+    static flags: {
+        passphrase: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        dsn: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<{
+        repaired: number;
+        conflicts: string[];
+        orphanedLocal: string[];
+    }>;
+}
+//# sourceMappingURL=recover.d.ts.map

package/dist/commands/sync/recover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/recover.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,EAAE,SAAkB;IACpC,OAAgB,WAAW,SAC6E;IACxG,OAAgB,KAAK;;;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAazF"}

package/dist/commands/sync/recover.js

@@ -0,0 +1,29 @@
+import { Flags } from '@oclif/core';
+import { SyncEngine } from '@knowzai/local-store';
+import { BaseCommand } from '../../base-command.js';
+export default class SyncRecover extends BaseCommand {
+    static id = 'sync:recover';
+    static description = 'Recovery: re-pull authoritative cloud state to repair the local store; reports conflicts + orphans.';
+    static flags = {
+        passphrase: Flags.string({ description: 'CMEK passphrase (if the profile is CMEK-enabled)' }),
+        db: Flags.string({ description: 'SQLite db path' }),
+        dsn: Flags.string(),
+    };
+    async run() {
+        const { flags } = await this.parse(SyncRecover);
+        const store = await this.localStore(flags, flags);
+        const client = await this.apiClient(flags);
+        const encryptor = this.cmekEncryptor({ ...flags, passphrase: flags.passphrase });
+        const report = await new SyncEngine(store, client, { encryptor }).recover({ vaultId: flags.vault });
+        await store.close();
+        if (this.jsonEnabled())
+            return report;
+        this.log(`repaired ${report.repaired} item(s) from cloud`);
+        if (report.conflicts.length)
+            this.log(`conflicts (resolve manually): ${report.conflicts.join(', ')}`);
+        if (report.orphanedLocal.length)
+            this.log(`orphaned locally (gone from cloud): ${report.orphanedLocal.join(', ')}`);
+        return report;
+    }
+}
+//# sourceMappingURL=recover.js.map

package/dist/commands/sync/recover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover.js","sourceRoot":"","sources":["../../../src/commands/sync/recover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,MAAM,CAAU,EAAE,GAAG,cAAc,CAAC;IACpC,MAAM,CAAU,WAAW,GACzB,qGAAqG,CAAC;IACxG,MAAM,CAAU,KAAK,GAAG;QACtB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;QAC7F,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;QACnD,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE;KACpB,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACpG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,MAAM,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,QAAQ,qBAAqB,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtG,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,uCAAuC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpH,OAAO,MAAM,CAAC;IAChB,CAAC"}

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

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../base-command.js';
+export default class SyncResolve extends BaseCommand {
+    static id: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'keep-remote': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'keep-local': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        passphrase: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        dsn: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<{
+        id: string;
+        outcome: string;
+    }>;
+}
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,EAAE,SAAkB;IACpC,OAAgB,WAAW,SAA2E;IACtG,OAAgB,QAAQ,WAGtB;IACF,OAAgB,IAAI;;MAAwE;IAC5F,OAAgB,KAAK;;;;;;MAMnB;IAEI,GAAG,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAgBtD"}