@knowzai/cli 0.1.0

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

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base-command.js';
+export default class PlatformSetup 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/platform/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/commands/platform/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,EAAE,SAAoB;IACtC,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/platform/setup.js

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../base-command.js';
+import { runSetupConsoleCommand, setupConsoleFlags } from '../../lib/platform-command-shared.js';
+export default class PlatformSetup extends BaseCommand {
+    static id = 'platform:setup';
+    static description = 'Open the one-shot loopback setup console for a local portable Knowz platform.';
+    static examples = [
+        '<%= config.bin %> platform setup',
+        '<%= config.bin %> platform setup --no-open',
+    ];
+    static flags = setupConsoleFlags;
+    async run() {
+        const { flags } = await this.parse(PlatformSetup);
+        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/platform/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/commands/platform/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEjG,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,MAAM,CAAU,EAAE,GAAG,gBAAgB,CAAC;IACtC,MAAM,CAAU,WAAW,GAAG,+EAA+E,CAAC;IAC9G,MAAM,CAAU,QAAQ,GAAG;QACzB,kCAAkC;QAClC,4CAA4C;KAC7C,CAAC;IACF,MAAM,CAAU,KAAK,GAAG,iBAAiB,CAAC;IAE1C,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAClD,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/platform/status.d.ts

@@ -0,0 +1,28 @@
+import { BaseCommand } from '../../base-command.js';
+export default class PlatformStatus extends BaseCommand {
+    static id: string;
+    static description: string;
+    static flags: {
+        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<{
+        runtimeDir: string;
+        composeStatus: string;
+        versionSources: import("../../lib/platform-lifecycle.js").PlatformVersionSources | undefined;
+        versionConsistent: boolean | undefined;
+        schemaVersion: 1;
+        name: string;
+        version: string;
+        provider: import("../../lib/provider-presets.js").PlatformProviderPreset;
+        storage: import("../../lib/platform-runtime.js").PlatformStorageMode;
+        imageFlavor: "" | "-gcp";
+        axes: import("../../lib/platform-runtime.js").PlatformProviderAxes;
+        ports: import("../../lib/platform-runtime.js").PlatformPorts;
+        serviceUrls: import("../../lib/platform-runtime.js").PlatformPublicUrls;
+        components?: import("../../lib/platform-runtime.js").PlatformComponents;
+        imageMode?: "build" | "pull" | "preloaded";
+        updatedAt: string;
+    }>;
+}
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/platform/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,OAAgB,EAAE,SAAqB;IACvC,OAAgB,WAAW,SAA8E;IACzG,OAAgB,KAAK;;;MAAyB;IAExC,GAAG;;;;;;;;;;;;;;;;;;CA2BV"}

package/dist/commands/platform/status.js

@@ -0,0 +1,37 @@
+import { BaseCommand } from '../../base-command.js';
+import { runPlatformLifecycle } from '../../lib/platform-lifecycle.js';
+import { platformIdentityFlags } from '../../lib/platform-command-shared.js';
+export default class PlatformStatus extends BaseCommand {
+    static id = 'platform:status';
+    static description = 'Show persisted platform configuration and Docker Compose service status.';
+    static flags = platformIdentityFlags;
+    async run() {
+        const { flags } = await this.parse(PlatformStatus);
+        const result = runPlatformLifecycle('status', { name: flags.name, configDir: flags['config-dir'] });
+        if (!this.jsonEnabled()) {
+            this.log(`Knowz platform '${result.state.name}' ${result.state.version} (${result.state.provider}, ${result.state.storage})`);
+            this.log(`Web: ${result.state.serviceUrls.web}`);
+            this.log(`API: ${result.state.serviceUrls.api}`);
+            this.log(`MCP: ${result.state.serviceUrls.mcp}`);
+            if (result.versionSources) {
+                const running = Object.entries(result.versionSources.running)
+                    .map(([service, version]) => `${service}=${version}`)
+                    .join(', ') || 'none observed';
+                this.log(`Version (state): ${result.versionSources.state}`);
+                this.log(`Version (environment): ${result.versionSources.environment ?? 'missing'}`);
+                this.log(`Version (running): ${running}`);
+                this.log(`Version consistent: ${result.versionConsistent ? 'yes' : 'NO'}`);
+            }
+            if (result.output)
+                this.log(result.output);
+        }
+        return {
+            ...result.state,
+            runtimeDir: result.paths.runtimeDir,
+            composeStatus: result.output,
+            versionSources: result.versionSources,
+            versionConsistent: result.versionConsistent,
+        };
+    }
+}
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/platform/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,MAAM,CAAU,EAAE,GAAG,iBAAiB,CAAC;IACvC,MAAM,CAAU,WAAW,GAAG,0EAA0E,CAAC;IACzG,MAAM,CAAU,KAAK,GAAG,qBAAqB,CAAC;IAE9C,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACpG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;YAC9H,IAAI,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC;qBAC1D,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;qBACpD,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;gBACjC,IAAI,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC5D,IAAI,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,cAAc,CAAC,WAAW,IAAI,SAAS,EAAE,CAAC,CAAC;gBACrF,IAAI,CAAC,GAAG,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;gBAC1C,IAAI,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,MAAM,CAAC,MAAM;gBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO;YACL,GAAG,MAAM,CAAC,KAAK;YACf,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;YACnC,aAAa,EAAE,MAAM,CAAC,MAAM;YAC5B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;SAC5C,CAAC;IACJ,CAAC"}

package/dist/commands/platform/up.d.ts

@@ -0,0 +1,42 @@
+import { BaseCommand } from '../../base-command.js';
+import { printableApplyResult } from '../../lib/platform-command-shared.js';
+export default class PlatformUp 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>;
+        provider: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        storage: 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>;
+        'public-api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'public-web-origin': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'public-mcp-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'embedding-dimensions': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'azure-endpoint': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'azure-api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'azure-embedding-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'gcp-project': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'gcp-region': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'gcp-adc-path': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'gcp-chat-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'gcp-embedding-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'openai-endpoint': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'openai-api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'openai-chat-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'openai-embedding-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ai-provider': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'doc-intelligence-provider': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'vision-provider': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'transcription-provider': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        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<ReturnType<typeof printableApplyResult>>;
+}
+//# sourceMappingURL=up.d.ts.map

package/dist/commands/platform/up.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"up.d.ts","sourceRoot":"","sources":["../../../src/commands/platform/up.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAmD,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE7H,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,EAAE,SAAiB;IACnC,OAAgB,WAAW,SAAiF;IAC5G,OAAgB,QAAQ,WAItB;IACF,OAAgB,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAsB;IAErC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;CAM9D"}

package/dist/commands/platform/up.js

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../base-command.js';
+import { applyPlatform } from '../../lib/platform-lifecycle.js';
+import { platformApplyFlags, platformApplyInputFromFlags, printableApplyResult } from '../../lib/platform-command-shared.js';
+export default class PlatformUp extends BaseCommand {
+    static id = 'platform:up';
+    static description = 'Install and start the complete portable Knowz platform with Docker Compose.';
+    static examples = [
+        '<%= config.bin %> platform up --version 1.2.3',
+        '<%= config.bin %> platform up --version 1.2.3 --provider azure',
+        '<%= config.bin %> platform up --version 1.2.3 --provider openai-compatible --openai-endpoint http://host.docker.internal:11434/v1 --openai-chat-model llama3 --openai-embedding-model nomic-embed-text --embedding-dimensions 768',
+    ];
+    static flags = platformApplyFlags;
+    async run() {
+        const { flags } = await this.parse(PlatformUp);
+        const result = await applyPlatform(platformApplyInputFromFlags('up', flags));
+        if (!this.jsonEnabled())
+            for (const line of result.output.split('\n'))
+                this.log(line);
+        return printableApplyResult(result);
+    }
+}
+//# sourceMappingURL=up.js.map

package/dist/commands/platform/up.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"up.js","sourceRoot":"","sources":["../../../src/commands/platform/up.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE7H,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAU,EAAE,GAAG,aAAa,CAAC;IACnC,MAAM,CAAU,WAAW,GAAG,6EAA6E,CAAC;IAC5G,MAAM,CAAU,QAAQ,GAAG;QACzB,+CAA+C;QAC/C,gEAAgE;QAChE,mOAAmO;KACpO,CAAC;IACF,MAAM,CAAU,KAAK,GAAG,kBAAkB,CAAC;IAE3C,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtF,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC"}

package/dist/commands/platform/upgrade.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base-command.js';
+import { printableApplyResult } from '../../lib/platform-command-shared.js';
+export default class PlatformUpgrade 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>;
+        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<ReturnType<typeof printableApplyResult>>;
+}
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/platform/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/commands/platform/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAsD,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAGhI,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAW;IACtD,OAAgB,EAAE,SAAsB;IACxC,OAAgB,WAAW,SAAqF;IAChH,OAAgB,QAAQ,WAA0D;IAClF,OAAgB,KAAK;;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;CAM9D"}

package/dist/commands/platform/upgrade.js

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../base-command.js';
+import { applyPlatform } from '../../lib/platform-lifecycle.js';
+import { platformApplyInputFromFlags, platformIdentityFlags, printableApplyResult } from '../../lib/platform-command-shared.js';
+import { Flags } from '@oclif/core';
+export default class PlatformUpgrade extends BaseCommand {
+    static id = 'platform:upgrade';
+    static description = 'Pull and apply a new pinned platform version while preserving data and secrets.';
+    static examples = ['<%= config.bin %> platform upgrade --version 1.3.0'];
+    static flags = {
+        ...platformIdentityFlags,
+        version: Flags.string({ description: 'New pinned platform SemVer (or KNOWZ_VERSION)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(PlatformUpgrade);
+        const result = await applyPlatform(platformApplyInputFromFlags('upgrade', flags));
+        if (!this.jsonEnabled())
+            for (const line of result.output.split('\n'))
+                this.log(line);
+        return printableApplyResult(result);
+    }
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/commands/platform/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/commands/platform/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAChI,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAW;IACtD,MAAM,CAAU,EAAE,GAAG,kBAAkB,CAAC;IACxC,MAAM,CAAU,WAAW,GAAG,iFAAiF,CAAC;IAChH,MAAM,CAAU,QAAQ,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAClF,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,qBAAqB;QACxB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC;KACxF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,2BAA2B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtF,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC"}

package/dist/commands/profile/add.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../base-command.js';
+export default class ProfileAdd extends BaseCommand {
+    static id: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        use: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<{
+        name: string;
+        apiUrl: string;
+    }>;
+}
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/profile/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/commands/profile/add.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,EAAE,SAAiB;IACnC,OAAgB,WAAW,SAAwB;IACnD,OAAgB,QAAQ,WAAyE;IACjG,OAAgB,IAAI;;MAA0E;IAC9F,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAUvD"}

package/dist/commands/profile/add.js

@@ -0,0 +1,26 @@
+import { Args, Flags } from '@oclif/core';
+import { loadConfig, saveConfig, addProfile, BUILTIN_API_URLS } from '@knowzai/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ProfileAdd extends BaseCommand {
+    static id = 'profile:add';
+    static description = 'Add a new profile.';
+    static examples = ['<%= config.bin %> profile add prod --api-url https://api.knowz.io'];
+    static args = { name: Args.string({ description: 'Profile name', required: true }) };
+    static flags = {
+        'api-url': Flags.string({ description: 'API base URL for the profile' }),
+        use: Flags.boolean({ description: 'Switch to the new profile after creating it' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProfileAdd);
+        const cfg = loadConfig();
+        const apiUrl = flags['api-url'] ?? BUILTIN_API_URLS[args.name] ?? BUILTIN_API_URLS.dev;
+        addProfile(cfg, args.name, apiUrl);
+        if (flags.use)
+            cfg.activeProfile = args.name;
+        saveConfig(cfg);
+        if (!this.jsonEnabled())
+            this.log(`added profile '${args.name}' (${apiUrl})${flags.use ? ' — now active' : ''}`);
+        return { name: args.name, apiUrl };
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/profile/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/commands/profile/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAU,EAAE,GAAG,aAAa,CAAC;IACnC,MAAM,CAAU,WAAW,GAAG,oBAAoB,CAAC;IACnD,MAAM,CAAU,QAAQ,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACjG,MAAM,CAAU,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC9F,MAAM,CAAU,KAAK,GAAG;QACtB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC;QACxE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC;KACnF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,GAAI,CAAC;QACxF,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,GAAG;YAAE,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7C,UAAU,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,IAAI,MAAM,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC"}

package/dist/commands/profile/list.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base-command.js';
+export default class ProfileList extends BaseCommand {
+    static id: string;
+    static description: string;
+    run(): Promise<{
+        active: string;
+        profiles: string[];
+    }>;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/profile/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/profile/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,EAAE,SAAkB;IACpC,OAAgB,WAAW,SAA4D;IAEjF,GAAG,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAY7D"}

package/dist/commands/profile/list.js

@@ -0,0 +1,20 @@
+import { loadConfig } from '@knowzai/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ProfileList extends BaseCommand {
+    static id = 'profile:list';
+    static description = 'List configured profiles (the active one is marked *).';
+    async run() {
+        await this.parse(ProfileList);
+        const cfg = loadConfig();
+        const profiles = Object.keys(cfg.profiles);
+        if (this.jsonEnabled())
+            return { active: cfg.activeProfile, profiles };
+        for (const name of profiles) {
+            const p = cfg.profiles[name];
+            const mark = name === cfg.activeProfile ? '*' : ' ';
+            this.log(`${mark} ${name.padEnd(14)} ${p.apiUrl}${p.pgDsn ? '  [postgres]' : ''}`);
+        }
+        return { active: cfg.activeProfile, profiles };
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/profile/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/profile/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,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,GAAG,wDAAwD,CAAC;IAEvF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC;QACvE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC;IACjD,CAAC"}

package/dist/commands/profile/remove.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base-command.js';
+export default class ProfileRemove extends BaseCommand {
+    static id: string;
+    static description: string;
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<{
+        removed: string;
+    }>;
+}
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/profile/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/commands/profile/remove.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,SAAsD;IACjF,OAAgB,IAAI;;MAA0E;IAC9F,OAAgB,KAAK;;MAA2E;IAE1F,GAAG,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAQ1C"}

package/dist/commands/profile/remove.js

@@ -0,0 +1,19 @@
+import { Args, Flags } from '@oclif/core';
+import { loadConfig, saveConfig, removeProfile } from '@knowzai/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ProfileRemove extends BaseCommand {
+    static id = 'profile:remove';
+    static description = 'Remove a profile (cannot remove the active one).';
+    static args = { name: Args.string({ description: 'Profile name', required: true }) };
+    static flags = { yes: Flags.boolean({ char: 'y', description: 'Skip confirmation' }) };
+    async run() {
+        const { args } = await this.parse(ProfileRemove);
+        const cfg = loadConfig();
+        removeProfile(cfg, args.name);
+        saveConfig(cfg);
+        if (!this.jsonEnabled())
+            this.log(`removed profile '${args.name}'`);
+        return { removed: args.name };
+    }
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/profile/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../src/commands/profile/remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtE,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,kDAAkD,CAAC;IACjF,MAAM,CAAU,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC9F,MAAM,CAAU,KAAK,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC;IAEhG,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,UAAU,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC"}

package/dist/commands/profile/use.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command.js';
+export default class ProfileUse extends BaseCommand {
+    static id: string;
+    static description: string;
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<{
+        active: string;
+    }>;
+}
+//# sourceMappingURL=use.d.ts.map

package/dist/commands/profile/use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../src/commands/profile/use.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,EAAE,SAAiB;IACnC,OAAgB,WAAW,SAAgC;IAC3D,OAAgB,IAAI;;MAA0E;IAExF,GAAG,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAQzC"}

package/dist/commands/profile/use.js

@@ -0,0 +1,18 @@
+import { Args } from '@oclif/core';
+import { loadConfig, saveConfig, useProfile } from '@knowzai/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ProfileUse extends BaseCommand {
+    static id = 'profile:use';
+    static description = 'Switch the active profile.';
+    static args = { name: Args.string({ description: 'Profile name', required: true }) };
+    async run() {
+        const { args } = await this.parse(ProfileUse);
+        const cfg = loadConfig();
+        useProfile(cfg, args.name);
+        saveConfig(cfg);
+        if (!this.jsonEnabled())
+            this.log(`active profile: ${args.name}`);
+        return { active: args.name };
+    }
+}
+//# sourceMappingURL=use.js.map

package/dist/commands/profile/use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../src/commands/profile/use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAU,EAAE,GAAG,aAAa,CAAC;IACnC,MAAM,CAAU,WAAW,GAAG,4BAA4B,CAAC;IAC3D,MAAM,CAAU,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAE9F,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,UAAU,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC"}

package/dist/commands/recall.d.ts

@@ -0,0 +1,29 @@
+import { BaseCommand } from '../base-command.js';
+/**
+ * Recall relevant agent memory. Tier-0 is the LOCAL store (offline, vault-scoped,
+ * fail-closed). Tier-1 is a bounded best-effort cloud lookup when online and a
+ * --query is given. Designed as the Claude Code `SessionStart` hook target with
+ * --inject (prints a token-budgeted context block to stdout) and is fail-open
+ * under --quiet so a recall problem never blocks session start.
+ */
+export default class RecallCmd extends BaseCommand {
+    static id: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        inject: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'local-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        deep: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'max-chars': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        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>;
+    };
+    run(): Promise<unknown>;
+    /** Bounded, best-effort cloud lookup. Fail-closed: any error → empty (no over-share). */
+    private tryCloudRecall;
+}
+//# sourceMappingURL=recall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/commands/recall.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWjD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,EAAE,SAAY;IAC9B,OAAgB,WAAW,SAC2E;IACtG,OAAgB,QAAQ,WAItB;IACF,OAAgB,KAAK;;;;;;;;;;;MAWnB;IAEI,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;IAyC7B,yFAAyF;YAC3E,cAAc;CAgB7B"}

package/dist/commands/recall.js

@@ -0,0 +1,94 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../base-command.js';
+import { readHookInput } from '../lib/hook-io.js';
+import { localRecall, semanticLocalRecall, renderRecallBlock, looksLikeGuid, } from '../lib/recall.js';
+/**
+ * Recall relevant agent memory. Tier-0 is the LOCAL store (offline, vault-scoped,
+ * fail-closed). Tier-1 is a bounded best-effort cloud lookup when online and a
+ * --query is given. Designed as the Claude Code `SessionStart` hook target with
+ * --inject (prints a token-budgeted context block to stdout) and is fail-open
+ * under --quiet so a recall problem never blocks session start.
+ */
+export default class RecallCmd extends BaseCommand {
+    static id = 'recall';
+    static description = 'Recall relevant agent memory (local-first, vault-scoped). SessionStart hook target with --inject.';
+    static examples = [
+        '<%= config.bin %> recall',
+        '<%= config.bin %> recall --inject --quiet',
+        '<%= config.bin %> recall --query "service bus outbox" --limit 8',
+    ];
+    static flags = {
+        inject: Flags.boolean({ description: 'Print the recall block for context injection (SessionStart)' }),
+        'local-only': Flags.boolean({ description: 'Skip the cloud tier (offline)' }),
+        deep: Flags.boolean({ description: 'Raise cloud result count (more thorough, slower)' }),
+        quiet: Flags.boolean({ description: 'Fail-open: never error (for the SessionStart hook)' }),
+        query: Flags.string({ description: 'Query text (else read from hook stdin / recency only)' }),
+        limit: Flags.integer({ description: 'Max local items', default: 5 }),
+        'max-chars': Flags.integer({ description: 'Token-budget cap for the injected block', default: 4000 }),
+        driver: Flags.string({ options: ['sqlite', 'postgres'] }),
+        db: Flags.string({ description: 'SQLite db path' }),
+        dsn: Flags.string({ description: 'Postgres DSN' }),
+    };
+    async run() {
+        let flags;
+        try {
+            ({ flags } = await this.parse(RecallCmd));
+            const query = flags.query ?? (flags.inject ? (await readHookInput()).prompt : undefined);
+            // Offline vault scoping: use --vault only if it's a GUID; otherwise leave
+            // unscoped (single-user local store). Never block on the network here.
+            const vaultId = looksLikeGuid(flags.vault) ? flags.vault : undefined;
+            const store = await this.localStore(flags, flags);
+            try {
+                // With a query, rank by semantic (content) relevance; fall back to recency
+                // when there's no query or nothing relevant is embedded yet.
+                let local = [];
+                if (query && query.trim().length > 0) {
+                    try {
+                        local = await semanticLocalRecall(store, query, { vaultId, limit: flags.limit });
+                    }
+                    catch {
+                        local = [];
+                    }
+                }
+                if (local.length === 0)
+                    local = await localRecall(store, { vaultId, limit: flags.limit });
+                const cloud = flags['local-only'] ? [] : await this.tryCloudRecall(flags, query, vaultId);
+                const block = renderRecallBlock(local, cloud, flags['max-chars']);
+                if (this.jsonEnabled())
+                    return { local: local.length, cloud: cloud.length, block };
+                if (flags.inject) {
+                    if (block)
+                        this.log(block);
+                }
+                else {
+                    this.log(block || 'No relevant agent memory found.');
+                }
+                return { local: local.length, cloud: cloud.length };
+            }
+            finally {
+                await store.close();
+            }
+        }
+        catch (err) {
+            if (flags?.quiet)
+                return { local: 0, cloud: 0 };
+            throw err;
+        }
+    }
+    /** Bounded, best-effort cloud lookup. Fail-closed: any error → empty (no over-share). */
+    async tryCloudRecall(flags, query, vaultGuid) {
+        if (!query)
+            return [];
+        try {
+            const client = await this.apiClient(flags);
+            const vaultId = vaultGuid ?? (await this.resolveVaultId(client, flags));
+            const pageSize = flags.deep ? 10 : 5;
+            const res = await client.knowledge.list({ vaultId, titlePattern: query, pageSize });
+            return (res.items ?? []).map((i) => ({ title: i.title }));
+        }
+        catch {
+            return []; // offline / unauthenticated / unresolved vault → recall nothing from cloud
+        }
+    }
+}
+//# sourceMappingURL=recall.js.map

package/dist/commands/recall.js.map

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

package/dist/commands/repo/context.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base-command.js';
+interface RepoContextResult {
+    ok: boolean;
+    text: string;
+    repoRoot?: string;
+    vaultId?: string;
+}
+export default class RepoContext extends BaseCommand {
+    static id: string;
+    static description: string;
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        inject: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'max-chars': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<RepoContextResult>;
+    private empty;
+}
+export {};
+//# sourceMappingURL=context.d.ts.map