@knowzai/cli 0.1.0

package/dist/commands/config/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/commands/config/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,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,oCAAoC,CAAC;IAEnE,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC"}

package/dist/commands/config/set.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command.js';
+export default class ConfigSet extends BaseCommand {
+    static id: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<{
+        profile: string;
+        key: string;
+        value: string;
+    }>;
+}
+//# sourceMappingURL=set.d.ts.map

package/dist/commands/config/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/config/set.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,EAAE,SAAgB;IAClC,OAAgB,WAAW,SAA2F;IACtH,OAAgB,QAAQ,WAItB;IACF,OAAgB,IAAI;;;MAGlB;IAEI,GAAG,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAiBtE"}

package/dist/commands/config/set.js

@@ -0,0 +1,36 @@
+import { Args } from '@oclif/core';
+import { loadConfig, saveConfig, resolveProfileName, setProfileValue, setUiFrontend } from '@knowzai/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ConfigSet extends BaseCommand {
+    static id = 'config:set';
+    static description = 'Set a setting on the active (or --profile) profile, or a global key like ui.frontend.';
+    static examples = [
+        '<%= config.bin %> config set apiUrl https://api.dev.knowz.io',
+        '<%= config.bin %> config set defaultVaultId <vault-id> --profile prod',
+        '<%= config.bin %> config set ui.frontend tui',
+    ];
+    static args = {
+        key: Args.string({ description: 'apiUrl | defaultVaultId | email | label | pgDsn | ui.frontend', required: true }),
+        value: Args.string({ description: 'New value', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConfigSet);
+        const cfg = loadConfig();
+        // Global (non-profile) keys.
+        if (args.key === 'ui.frontend') {
+            setUiFrontend(cfg, args.value);
+            saveConfig(cfg);
+            const value = args.value.toLowerCase();
+            if (!this.jsonEnabled())
+                this.log(`set ui.frontend = ${value}`);
+            return { profile: '(global)', key: args.key, value };
+        }
+        const profile = resolveProfileName({ profileFlag: flags.profile }, cfg);
+        setProfileValue(cfg, profile, args.key, args.value);
+        saveConfig(cfg);
+        if (!this.jsonEnabled())
+            this.log(`set ${profile}.${args.key} = ${args.value}`);
+        return { profile, key: args.key, value: args.value };
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/commands/config/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/commands/config/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAU,EAAE,GAAG,YAAY,CAAC;IAClC,MAAM,CAAU,WAAW,GAAG,uFAAuF,CAAC;IACtH,MAAM,CAAU,QAAQ,GAAG;QACzB,8DAA8D;QAC9D,uEAAuE;QACvE,8CAA8C;KAC/C,CAAC;IACF,MAAM,CAAU,IAAI,GAAG;QACrB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+DAA+D,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClH,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KACjE,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,6BAA6B;QAC7B,IAAI,IAAI,CAAC,GAAG,KAAK,aAAa,EAAE,CAAC;YAC/B,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,UAAU,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,GAAG,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QACxE,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,UAAU,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,OAAO,OAAO,IAAI,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAChF,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,56 @@
+import { BaseCommand } from '../base-command.js';
+type CheckStatus = 'pass' | 'fail';
+interface DoctorCheck {
+    name: string;
+    status: CheckStatus;
+    message: string;
+}
+interface DoctorHit {
+    file?: string;
+    relevance: number;
+    snippet: string;
+}
+interface DoctorReport {
+    ok: boolean;
+    profile: string;
+    apiUrl: string;
+    configPath: string;
+    dbPath?: string;
+    graphPath: string;
+    samplePath: string;
+    generatedSample: boolean;
+    keptSample: boolean;
+    checks: DoctorCheck[];
+    index: {
+        filesIndexed: number;
+        filesSkipped: number;
+        chunks: number;
+    };
+    search: {
+        query: string;
+        hitCount: number;
+        hits: DoctorHit[];
+    };
+    graph: {
+        nodes: number;
+        edges: number;
+        byKind: Record<string, number>;
+    };
+    nextSteps: string[];
+}
+export default class Doctor extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'keep-sample': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        query: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<DoctorReport>;
+    private printReport;
+}
+export {};
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnC,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,SAAS,EAAE,CAAC;KACnB,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IACF,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,OAAgB,WAAW,SAC4F;IACvH,OAAgB,QAAQ,WAItB;IACF,OAAgB,IAAI;;MAElB;IACF,OAAgB,KAAK;;;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;IAuHlC,OAAO,CAAC,WAAW;CAiBpB"}

package/dist/commands/doctor.js

@@ -0,0 +1,151 @@
+import { Args, Flags } from '@oclif/core';
+import { existsSync, mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { tmpdir } from 'node:os';
+import { TreeSitterIndexer } from '@knowzai/indexer';
+import { defaultDbPath, graphPath, relevanceFromDistance } from '@knowzai/local-store';
+import { configPath, ExitCode, KnowzError, loadConfig, resolveApiUrl, resolveProfileName } from '@knowzai/core';
+import { BaseCommand } from '../base-command.js';
+import { DEFAULT_DOCTOR_QUERY, writeDoctorFixture } from '../lib/doctor-fixture.js';
+import { isGuid } from '../lib/vault.js';
+export default class Doctor extends BaseCommand {
+    static description = 'Check local Knowz CLI setup by indexing a generated or supplied repository, searching it, and reading graph stats.';
+    static examples = [
+        '<%= config.bin %> doctor',
+        '<%= config.bin %> doctor --keep-sample',
+        '<%= config.bin %> doctor ./my-repo --query "auth flow"',
+    ];
+    static args = {
+        path: Args.string({ description: 'Repository or folder to index. Omit to generate a disposable fake repo.' }),
+    };
+    static flags = {
+        db: Flags.string({ description: 'SQLite db path' }),
+        'keep-sample': Flags.boolean({ description: 'Keep the generated fake repository instead of deleting it' }),
+        query: Flags.string({ description: 'Search query to run after indexing', default: DEFAULT_DOCTOR_QUERY }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Doctor);
+        const cfg = loadConfig();
+        const profile = resolveProfileName({ profileFlag: flags.profile }, cfg);
+        const apiUrl = resolveApiUrl({ apiUrlFlag: flags['api-url'], profileFlag: flags.profile }, cfg);
+        const generatedSample = !args.path;
+        const samplePath = generatedSample
+            ? mkdtempSync(join(tmpdir(), 'knowz-doctor-repo-'))
+            : resolve(args.path);
+        if (generatedSample) {
+            writeDoctorFixture(samplePath);
+        }
+        else if (!existsSync(samplePath)) {
+            throw new KnowzError(`Path not found: ${samplePath}`, ExitCode.NotFound);
+        }
+        const checks = [];
+        const addCheck = (name, pass, message) => {
+            checks.push({ name, status: pass ? 'pass' : 'fail', message });
+        };
+        const indexer = new TreeSitterIndexer();
+        const usesPostgres = Boolean(cfg.profiles[profile]?.pgDsn ?? process.env.KNOWZ_PG_DSN);
+        const dbPath = usesPostgres ? undefined : (flags.db ?? defaultDbPath(profile));
+        const gpath = graphPath(profile, flags.db);
+        const nextScanPath = generatedSample && !flags['keep-sample'] ? '.' : samplePath;
+        let report;
+        let store;
+        try {
+            store = await this.localStore(flags, { db: flags.db, dim: indexer.dim });
+            const meta = await store.meta();
+            addCheck('local store', meta.dim === indexer.dim, `${store.driver} store ready with dim ${meta.dim}`);
+            const vaultId = flags.vault && !isGuid(flags.vault)
+                ? await this.resolveVaultId(await this.apiClient(flags), flags)
+                : flags.vault;
+            const indexReport = await indexer.indexDirectory(samplePath, store, {
+                vaultId,
+                force: true,
+            });
+            addCheck('index scan', indexReport.filesIndexed > 0 && indexReport.chunks > 0, `indexed ${indexReport.filesIndexed} file(s), ${indexReport.chunks} chunk(s)`);
+            mkdirSync(dirname(gpath), { recursive: true });
+            writeFileSync(gpath, JSON.stringify(indexReport.graph.toJSON()));
+            const graphStats = indexReport.graph.stats();
+            addCheck('code graph', graphStats.nodes > 0, `${graphStats.nodes} node(s), ${graphStats.edges} edge(s)`);
+            const hits = await store.knnSearch(indexer.embedQuery(flags.query), 5, vaultId ? { vaultId } : undefined);
+            const outHits = [];
+            for (const h of hits) {
+                const item = await store.getItem(h.chunk.itemId);
+                outHits.push({
+                    file: item?.title,
+                    relevance: Math.round(relevanceFromDistance(h.distance) * 100),
+                    snippet: h.chunk.text.slice(0, 160).replace(/\s+/g, ' ').trim(),
+                });
+            }
+            addCheck('local search', outHits.length > 0, `${outHits.length} hit(s) for "${flags.query}"`);
+            const nextSteps = [
+                `knowz index scan ${quoteArg(nextScanPath)}`,
+                `knowz index search ${quoteArg(flags.query)}`,
+                'knowz index graph',
+            ];
+            report = {
+                ok: checks.every((c) => c.status === 'pass'),
+                profile,
+                apiUrl,
+                configPath: configPath(),
+                dbPath,
+                graphPath: gpath,
+                samplePath,
+                generatedSample,
+                keptSample: generatedSample && Boolean(flags['keep-sample']),
+                checks,
+                index: {
+                    filesIndexed: indexReport.filesIndexed,
+                    filesSkipped: indexReport.filesSkipped,
+                    chunks: indexReport.chunks,
+                },
+                search: {
+                    query: flags.query,
+                    hitCount: outHits.length,
+                    hits: outHits,
+                },
+                graph: {
+                    nodes: graphStats.nodes,
+                    edges: graphStats.edges,
+                    byKind: graphStats.byKind,
+                },
+                nextSteps,
+            };
+        }
+        finally {
+            await store?.close();
+            if (generatedSample && !flags['keep-sample']) {
+                rmSync(samplePath, { recursive: true, force: true });
+            }
+        }
+        if (!report) {
+            throw new Error('Doctor did not produce a report.');
+        }
+        if (this.jsonEnabled())
+            return report;
+        this.printReport(report);
+        return report;
+    }
+    printReport(report) {
+        this.log(`Knowz doctor: ${report.ok ? 'ok' : 'failed'}`);
+        this.log(`profile: ${report.profile}`);
+        this.log(`config:  ${report.configPath}`);
+        this.log(`db:      ${report.dbPath ?? '(profile/postgres)'}`);
+        this.log(`repo:    ${report.generatedSample && !report.keptSample ? '(generated temp repo, cleaned up)' : report.samplePath}`);
+        this.log('');
+        for (const check of report.checks) {
+            this.log(`[${check.status}] ${check.name}: ${check.message}`);
+        }
+        this.log('');
+        this.log('Next commands:');
+        for (const step of report.nextSteps)
+            this.log(`  ${step}`);
+        if (report.generatedSample && !report.keptSample) {
+            this.log('  knowz doctor --keep-sample');
+        }
+    }
+}
+function quoteArg(value) {
+    if (/^[A-Za-z0-9_./:@%+=,-]+$/u.test(value))
+        return value;
+    return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/down.d.ts

@@ -0,0 +1,30 @@
+import { BaseCommand } from '../base-command.js';
+/**
+ * Friendly top-level alias of `platform down` (the symmetric partner of
+ * `knowz up`). Preserves named volumes and runtime configuration — use
+ * `knowz platform reset --yes` to also delete the data volumes.
+ */
+export default class Down extends BaseCommand {
+    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<{
+        stopped: boolean;
+        volumesPreserved: boolean;
+        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=down.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,OAAgB,WAAW,SAA+F;IAC1H,OAAgB,KAAK;;;MAAyB;IAExC,GAAG;;;;;;;;;;;;;;;;CAMV"}

package/dist/commands/down.js

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../base-command.js';
+import { runPlatformLifecycle } from '../lib/platform-lifecycle.js';
+import { platformIdentityFlags } from '../lib/platform-command-shared.js';
+/**
+ * Friendly top-level alias of `platform down` (the symmetric partner of
+ * `knowz up`). Preserves named volumes and runtime configuration — use
+ * `knowz platform reset --yes` to also delete the data volumes.
+ */
+export default class Down extends BaseCommand {
+    static description = 'Stop the portable Knowz platform, preserving all data volumes (alias of `platform down`).';
+    static flags = platformIdentityFlags;
+    async run() {
+        const { flags } = await this.parse(Down);
+        const result = runPlatformLifecycle('down', { name: flags.name, configDir: flags['config-dir'] });
+        if (!this.jsonEnabled())
+            this.log(`Stopped Knowz platform '${result.state.name}'; data volumes were preserved.`);
+        return { ...result.state, stopped: true, volumesPreserved: true };
+    }
+}
+//# sourceMappingURL=down.js.map

package/dist/commands/down.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.js","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,MAAM,CAAU,WAAW,GAAG,2FAA2F,CAAC;IAC1H,MAAM,CAAU,KAAK,GAAG,qBAAqB,CAAC;IAE9C,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAClG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,KAAK,CAAC,IAAI,iCAAiC,CAAC,CAAC;QACjH,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;IACpE,CAAC"}

package/dist/commands/entities/find.d.ts

@@ -0,0 +1,16 @@
+import type { Entity } from '@knowzai/api-client';
+import { BaseCommand } from '../../base-command.js';
+export default class EntitiesFind extends BaseCommand {
+    static id: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        type: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        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>;
+    };
+    run(): Promise<Entity[]>;
+}
+//# sourceMappingURL=find.d.ts.map

package/dist/commands/entities/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/commands/entities/find.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,OAAgB,EAAE,SAAmB;IACrC,OAAgB,WAAW,SAAuF;IAClH,OAAgB,QAAQ,WAAuG;IAC/H,OAAgB,IAAI;;MAAwF;IAC5G,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAY/B"}

package/dist/commands/entities/find.js

@@ -0,0 +1,27 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class EntitiesFind extends BaseCommand {
+    static id = 'entities:find';
+    static description = 'Find named entities (people, locations, events, …) extracted from your knowledge.';
+    static examples = ['<%= config.bin %> entities find person --query alex', '<%= config.bin %> entities find location'];
+    static args = { type: Args.string({ description: 'Entity type (e.g. person, location, event)' }) };
+    static flags = {
+        query: Flags.string({ char: 'q', description: 'Filter by name' }),
+        limit: Flags.integer({ description: 'Max results', default: 50 }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EntitiesFind);
+        const client = await this.apiClient(flags);
+        const entities = await client.entities.find({ type: args.type, q: flags.query, limit: flags.limit });
+        if (this.jsonEnabled())
+            return entities;
+        for (const e of entities) {
+            this.log(`${e.id}  ${(e.type ?? '—').padEnd(10)} ${e.name}${e.knowledgeCount != null ? `  (${e.knowledgeCount})` : ''}`);
+            if (e.description)
+                this.log(`    ${e.description}`);
+        }
+        this.log(`\n${entities.length} entity(ies)`);
+        return entities;
+    }
+}
+//# sourceMappingURL=find.js.map

package/dist/commands/entities/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/commands/entities/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAU,EAAE,GAAG,eAAe,CAAC;IACrC,MAAM,CAAU,WAAW,GAAG,mFAAmF,CAAC;IAClH,MAAM,CAAU,QAAQ,GAAG,CAAC,qDAAqD,EAAE,0CAA0C,CAAC,CAAC;IAC/H,MAAM,CAAU,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC,EAAE,CAAC;IAC5G,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;QACjE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;KAClE,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACrG,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,QAAQ,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzH,IAAI,CAAC,CAAC,WAAW;gBAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC;IAClB,CAAC"}

package/dist/commands/hooks/install.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../base-command.js';
+export default class HooksInstallCmd extends BaseCommand {
+    static id: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dir: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        print: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'command-prefix': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<{
+        path: string;
+        events: string[];
+        written: boolean;
+    }>;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/hooks/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOpD,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAW;IACtD,OAAgB,EAAE,SAAmB;IACrC,OAAgB,WAAW,SAC6G;IACxI,OAAgB,QAAQ,WAItB;IACF,OAAgB,KAAK;;;;;;MASnB;IAEI,GAAG,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CA+B3E"}

package/dist/commands/hooks/install.js

@@ -0,0 +1,53 @@
+import { Flags } from '@oclif/core';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { BaseCommand } from '../../base-command.js';
+import { buildAgentMemoryHooks, installClaudeHooks, settingsJson, } from '../../lib/claude-hooks.js';
+export default class HooksInstallCmd extends BaseCommand {
+    static id = 'hooks:install';
+    static description = 'Install Claude Code hooks that auto-capture agent memory (PostToolUse/Stop/SessionEnd/PreCompact) and inject recall (SessionStart).';
+    static examples = [
+        '<%= config.bin %> hooks install',
+        '<%= config.bin %> hooks install --global',
+        '<%= config.bin %> hooks install --print',
+    ];
+    static flags = {
+        dir: Flags.string({ description: 'Project root (writes .claude/settings.json there)', default: '.' }),
+        global: Flags.boolean({ description: 'Write ~/.claude/settings.json instead of the project file' }),
+        print: Flags.boolean({ description: 'Print the hook block that would be written; do not write' }),
+        'command-prefix': Flags.string({
+            description: 'How to invoke the CLI from a hook (must resolve at hook time)',
+            default: 'knowz',
+        }),
+        db: Flags.string({ description: 'Pin a SQLite db path into the hook commands (optional)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(HooksInstallCmd);
+        const prefix = flags['command-prefix'];
+        const ours = buildAgentMemoryHooks({
+            prefix,
+            dbPath: flags.db,
+            profile: flags.profile,
+            vaultId: flags.vault,
+        });
+        const settingsPath = flags.global
+            ? join(homedir(), '.claude', 'settings.json')
+            : join(flags.dir, '.claude', 'settings.json');
+        const events = Object.keys(ours);
+        if (flags.print) {
+            this.log(settingsJson({ hooks: ours }));
+            if (this.jsonEnabled())
+                return { path: settingsPath, events, written: false };
+            this.log(`\n(would merge into ${settingsPath} — re-run without --print to write)`);
+            return { path: settingsPath, events, written: false };
+        }
+        installClaudeHooks(settingsPath, ours);
+        if (!this.jsonEnabled()) {
+            this.log(`Installed knowz agent-memory hooks → ${settingsPath}`);
+            this.log(`  events: ${events.join(', ')}`);
+            this.log(`  invoke: "${prefix}" (ensure it resolves at hook time; override with --command-prefix)`);
+        }
+        return { path: settingsPath, events, written: true };
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/hooks/install.js.map

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

package/dist/commands/index/graph.d.ts

@@ -0,0 +1,11 @@
+import { CodeGraph } from '@knowzai/indexer';
+import { BaseCommand } from '../../base-command.js';
+export default class IndexGraph extends BaseCommand {
+    static id: string;
+    static description: string;
+    static flags: {
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ReturnType<CodeGraph['stats']>>;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/commands/index/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/commands/index/graph.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,EAAE,SAAiB;IACnC,OAAgB,WAAW,SAAoD;IAC/E,OAAgB,KAAK;;MAA2D;IAE1E,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;CAiBrD"}

package/dist/commands/index/graph.js

@@ -0,0 +1,31 @@
+import { Flags } from '@oclif/core';
+import { readFileSync, existsSync } from 'node:fs';
+import { CodeGraph } from '@knowzai/indexer';
+import { graphPath } from '@knowzai/local-store';
+import { loadConfig, resolveProfileName, KnowzError, ExitCode } from '@knowzai/core';
+import { BaseCommand } from '../../base-command.js';
+export default class IndexGraph extends BaseCommand {
+    static id = 'index:graph';
+    static description = 'Show code-graph stats from the last index run.';
+    static flags = { db: Flags.string({ description: 'SQLite db path' }) };
+    async run() {
+        const { flags } = await this.parse(IndexGraph);
+        const cfg = loadConfig();
+        const profile = resolveProfileName({ profileFlag: flags.profile }, cfg);
+        const path = graphPath(profile, flags.db);
+        if (!existsSync(path)) {
+            throw new KnowzError('No code graph found. Run `knowz index scan` first.', ExitCode.NotFound);
+        }
+        const graph = CodeGraph.fromJSON(JSON.parse(readFileSync(path, 'utf8')));
+        const s = graph.stats();
+        if (this.jsonEnabled())
+            return s;
+        this.log(`nodes: ${s.nodes}  edges: ${s.edges}`);
+        this.log(`by kind: ${Object.entries(s.byKind).map(([k, v]) => `${k}=${v}`).join(', ')}`);
+        this.log('top by degree:');
+        for (const t of s.topByDegree.slice(0, 10))
+            this.log(`  ${String(t.degree).padStart(3)}  ${t.id}`);
+        return s;
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/index/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/commands/index/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,QAAQ,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,gDAAgD,CAAC;IAC/E,MAAM,CAAU,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;IAEhF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,UAAU,CAAC,oDAAoD,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzF,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnG,OAAO,CAAC,CAAC;IACX,CAAC"}

package/dist/commands/index/scan.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../base-command.js';
+export default class IndexScan extends BaseCommand {
+    static id: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        db: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<{
+        filesIndexed: number;
+        filesSkipped: number;
+        chunks: number;
+        nodes: number;
+        edges: number;
+        graphPath: string;
+    }>;
+}
+//# sourceMappingURL=scan.d.ts.map

package/dist/commands/index/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/commands/index/scan.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,EAAE,SAAgB;IAClC,OAAgB,WAAW,SACgE;IAC3F,OAAgB,QAAQ,WAAoF;IAC5G,OAAgB,IAAI;;MAA6E;IACjG,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CA8BtI"}

package/dist/commands/index/scan.js

@@ -0,0 +1,48 @@
+import { Args, Flags } from '@oclif/core';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { TreeSitterIndexer } from '@knowzai/indexer';
+import { graphPath } from '@knowzai/local-store';
+import { loadConfig, resolveProfileName } from '@knowzai/core';
+import { BaseCommand } from '../../base-command.js';
+import { isGuid } from '../../lib/vault.js';
+export default class IndexScan extends BaseCommand {
+    static id = 'index:scan';
+    static description = 'Index local code into the local store (tree-sitter intelligent chunking + code graph).';
+    static examples = ['<%= config.bin %> index scan ./src', '<%= config.bin %> index scan . --force'];
+    static args = { path: Args.string({ description: 'File or directory', default: '.' }) };
+    static flags = {
+        force: Flags.boolean({ description: 'Re-index unchanged files' }),
+        db: Flags.string({ description: 'SQLite db path' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(IndexScan);
+        const cfg = loadConfig();
+        const profile = resolveProfileName({ profileFlag: flags.profile }, cfg);
+        const indexer = new TreeSitterIndexer();
+        const store = await this.localStore(flags, { db: flags.db, dim: indexer.dim });
+        const vaultId = flags.vault && !isGuid(flags.vault)
+            ? await this.resolveVaultId(await this.apiClient(flags), flags)
+            : flags.vault;
+        const report = await indexer.indexDirectory(args.path, store, { vaultId, force: flags.force });
+        await store.close();
+        const gpath = graphPath(profile, flags.db);
+        mkdirSync(dirname(gpath), { recursive: true }); // dir may not exist in Postgres mode
+        writeFileSync(gpath, JSON.stringify(report.graph.toJSON()));
+        const stats = report.graph.stats();
+        const out = {
+            filesIndexed: report.filesIndexed,
+            filesSkipped: report.filesSkipped,
+            chunks: report.chunks,
+            nodes: stats.nodes,
+            edges: stats.edges,
+            graphPath: gpath,
+        };
+        if (this.jsonEnabled())
+            return out;
+        this.log(`indexed ${report.filesIndexed} file(s), ${report.chunks} chunk(s); skipped ${report.filesSkipped}.`);
+        this.log(`graph: ${stats.nodes} nodes, ${stats.edges} edges → ${gpath}`);
+        return out;
+    }
+}
+//# sourceMappingURL=scan.js.map