@knowzai/cli 0.1.0

package/dist/lib/content.js

@@ -0,0 +1,20 @@
+import { readFileSync } from 'node:fs';
+/**
+ * Resolve knowledge content from (in priority order): --content, --file, or
+ * piped stdin. Returns undefined if none provided.
+ */
+export async function resolveContentInput(opts) {
+    if (opts.content !== undefined)
+        return opts.content;
+    if (opts.file)
+        return readFileSync(opts.file, 'utf8');
+    if (!process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        const text = Buffer.concat(chunks).toString('utf8');
+        return text.length ? text : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=content.js.map

package/dist/lib/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/lib/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAGzC;IACC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC;IACpD,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/doctor-fixture.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_DOCTOR_QUERY = "agent memory invoice ledger";
+export interface DoctorFixture {
+    path: string;
+    query: string;
+    files: string[];
+}
+export declare function writeDoctorFixture(root: string): DoctorFixture;
+//# sourceMappingURL=doctor-fixture.d.ts.map

package/dist/lib/doctor-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-fixture.d.ts","sourceRoot":"","sources":["../../src/lib/doctor-fixture.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CA4D9D"}

package/dist/lib/doctor-fixture.js

@@ -0,0 +1,50 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const DEFAULT_DOCTOR_QUERY = 'agent memory invoice ledger';
+export function writeDoctorFixture(root) {
+    const src = join(root, 'src');
+    const docs = join(root, 'docs');
+    mkdirSync(src, { recursive: true });
+    mkdirSync(docs, { recursive: true });
+    const router = join(src, 'agentMemoryRouter.ts');
+    const ledger = join(src, 'invoiceLedger.ts');
+    const readme = join(root, 'README.md');
+    const runbook = join(docs, 'local-indexing.md');
+    writeFileSync(router, [
+        'import { InvoiceLedger } from "./invoiceLedger";',
+        '',
+        'export class AgentMemoryRouter {',
+        '  constructor(private readonly ledger = new InvoiceLedger()) {}',
+        '',
+        '  recallSession(sessionId: string): string {',
+        '    return this.ledger.recordInvoice(`agent-memory:${sessionId}`);',
+        '  }',
+        '}',
+        '',
+    ].join('\n'));
+    writeFileSync(ledger, [
+        'export class InvoiceLedger {',
+        '  recordInvoice(id: string): string {',
+        '    return `invoice-ledger:${id}`;',
+        '  }',
+        '}',
+        '',
+    ].join('\n'));
+    writeFileSync(readme, [
+        '# Knowz Doctor Fixture',
+        '',
+        'This fake repository verifies local Knowz indexing, semantic search, and graph generation.',
+        'The smoke query should find the agent memory router and invoice ledger content.',
+        '',
+    ].join('\n'));
+    writeFileSync(runbook, [
+        '# Local indexing runbook',
+        '',
+        'Run `knowz index scan` to index code and docs.',
+        'Run `knowz index search "agent memory invoice ledger"` to verify local recall.',
+        'Run `knowz index graph` to inspect code graph stats.',
+        '',
+    ].join('\n'));
+    return { path: root, query: DEFAULT_DOCTOR_QUERY, files: [router, ledger, readme, runbook] };
+}
+//# sourceMappingURL=doctor-fixture.js.map

package/dist/lib/doctor-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-fixture.js","sourceRoot":"","sources":["../../src/lib/doctor-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAQlE,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAErC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAEhD,aAAa,CACX,MAAM,EACN;QACE,kDAAkD;QAClD,EAAE;QACF,kCAAkC;QAClC,iEAAiE;QACjE,EAAE;QACF,8CAA8C;QAC9C,oEAAoE;QACpE,KAAK;QACL,GAAG;QACH,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,aAAa,CACX,MAAM,EACN;QACE,8BAA8B;QAC9B,uCAAuC;QACvC,oCAAoC;QACpC,KAAK;QACL,GAAG;QACH,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,aAAa,CACX,MAAM,EACN;QACE,wBAAwB;QACxB,EAAE;QACF,4FAA4F;QAC5F,iFAAiF;QACjF,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,aAAa,CACX,OAAO,EACP;QACE,0BAA0B;QAC1B,EAAE;QACF,gDAAgD;QAChD,gFAAgF;QAChF,sDAAsD;QACtD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;AAC/F,CAAC"}

package/dist/lib/embedding-guard.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Portable embedding guardrail — fails a setup at plan time (before any container boot or
+ * pgvector column is created) when the configured embedding model cannot produce vectors that
+ * match the portable vector-column dimension.
+ *
+ * Why: the portable Azure/OpenAiCompat embedding transports never send a `dimensions` request
+ * field (no MRL truncation — `OpenAiCompatService.cs` convention / `FEAT_LocalEmbeddingEndpointOverride`),
+ * so a model runs at its NATIVE dimension. The pgvector `content_vector` column is created at
+ * `EMBEDDING_DIMENSIONS` on first boot. When native != configured, EVERY embedding call fails at
+ * runtime with "Embedding dimension mismatch" and enrichment/search silently break.
+ *
+ * Scope: this complements — does not duplicate — the runtime `PostgresSearchDimensionValidator`.
+ * It is intentionally Azure-focused. GCP/Vertex is excluded (Vertex supports `output_dimensionality`
+ * truncation, so its model native dim need not equal the configured dimension). OpenAiCompat models
+ * are operator-chosen and validated at runtime; only the guided default is dimension-matched.
+ *
+ * See FEAT_PortableEmbeddingGuardrails and ARCH_EmbeddingConfigOwnership.
+ */
+/** Native output dimension of embedding models the portable setup knows about. */
+export declare const KNOWN_EMBEDDING_NATIVE_DIMS: Readonly<Record<string, number>>;
+export interface EmbeddingGuardInput {
+    /** Resolved AI provider axis (e.g. 'Azure', 'Gcp', 'OpenAiCompat'). */
+    aiProvider: string | undefined;
+    /** Resolved embedding model / deployment name (may be undefined for a custom deployment). */
+    model: string | undefined;
+    /** Resolved (validated) EMBEDDING_DIMENSIONS the pgvector column will be created at. */
+    dimensions: number;
+}
+/**
+ * Throws a clear, actionable Error when a portable Azure embedding config would produce a runtime
+ * dimension mismatch. No-op for non-Azure providers and for Azure configs that are safe.
+ */
+export declare function assertPortableEmbeddingSupported(input: EmbeddingGuardInput): void;
+//# sourceMappingURL=embedding-guard.d.ts.map

package/dist/lib/embedding-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-guard.d.ts","sourceRoot":"","sources":["../../src/lib/embedding-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,kFAAkF;AAClF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxE,CAAC;AAKF,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,6FAA6F;IAC7F,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAuBjF"}

package/dist/lib/embedding-guard.js

@@ -0,0 +1,50 @@
+/**
+ * Portable embedding guardrail — fails a setup at plan time (before any container boot or
+ * pgvector column is created) when the configured embedding model cannot produce vectors that
+ * match the portable vector-column dimension.
+ *
+ * Why: the portable Azure/OpenAiCompat embedding transports never send a `dimensions` request
+ * field (no MRL truncation — `OpenAiCompatService.cs` convention / `FEAT_LocalEmbeddingEndpointOverride`),
+ * so a model runs at its NATIVE dimension. The pgvector `content_vector` column is created at
+ * `EMBEDDING_DIMENSIONS` on first boot. When native != configured, EVERY embedding call fails at
+ * runtime with "Embedding dimension mismatch" and enrichment/search silently break.
+ *
+ * Scope: this complements — does not duplicate — the runtime `PostgresSearchDimensionValidator`.
+ * It is intentionally Azure-focused. GCP/Vertex is excluded (Vertex supports `output_dimensionality`
+ * truncation, so its model native dim need not equal the configured dimension). OpenAiCompat models
+ * are operator-chosen and validated at runtime; only the guided default is dimension-matched.
+ *
+ * See FEAT_PortableEmbeddingGuardrails and ARCH_EmbeddingConfigOwnership.
+ */
+/** Native output dimension of embedding models the portable setup knows about. */
+export const KNOWN_EMBEDDING_NATIVE_DIMS = {
+    'text-embedding-3-small': 1536,
+    'text-embedding-ada-002': 1536,
+    'text-embedding-3-large': 3072,
+    'qwen/qwen3-embedding-0.6b': 1024,
+};
+/** Portable never provisions a vector column wider than this on the Azure path. */
+const PORTABLE_MAX_VECTOR_DIMS = 1536;
+/**
+ * Throws a clear, actionable Error when a portable Azure embedding config would produce a runtime
+ * dimension mismatch. No-op for non-Azure providers and for Azure configs that are safe.
+ */
+export function assertPortableEmbeddingSupported(input) {
+    if (input.aiProvider !== 'Azure')
+        return;
+    const dims = input.dimensions;
+    const model = input.model?.trim();
+    const nativeDim = model ? KNOWN_EMBEDDING_NATIVE_DIMS[model.toLowerCase()] : undefined;
+    if (dims > PORTABLE_MAX_VECTOR_DIMS) {
+        throw new Error(`Portable does not provision a ${dims}-dimension vector column. Azure embeddings on portable ` +
+            `must be 1536 — use text-embedding-3-small (native 1536). ` +
+            `The transport does not reduce dimensions. See ARCH_EmbeddingConfigOwnership.`);
+    }
+    if (nativeDim !== undefined && nativeDim !== dims) {
+        throw new Error(`Embedding model '${model}' produces ${nativeDim} dimensions but Embedding:Dimensions=${dims}. ` +
+            `Portable does not truncate embeddings, so these must match. ` +
+            `Use text-embedding-3-small (native 1536) for the portable Azure path. ` +
+            `See ARCH_EmbeddingConfigOwnership.`);
+    }
+}
+//# sourceMappingURL=embedding-guard.js.map

package/dist/lib/embedding-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-guard.js","sourceRoot":"","sources":["../../src/lib/embedding-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,2BAA2B,GAAqC;IAC3E,wBAAwB,EAAE,IAAI;IAC9B,wBAAwB,EAAE,IAAI;IAC9B,wBAAwB,EAAE,IAAI;IAC9B,2BAA2B,EAAE,IAAI;CAClC,CAAC;AAEF,mFAAmF;AACnF,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAWtC;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,KAA0B;IACzE,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO;QAAE,OAAO;IAEzC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,2BAA2B,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvF,IAAI,IAAI,GAAG,wBAAwB,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,yDAAyD;YAC5F,2DAA2D;YAC3D,8EAA8E,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,oBAAoB,KAAK,cAAc,SAAS,wCAAwC,IAAI,IAAI;YAC9F,8DAA8D;YAC9D,wEAAwE;YACxE,oCAAoC,CACvC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/hook-io.d.ts

@@ -0,0 +1,24 @@
+import type { Readable } from 'node:stream';
+/**
+ * Normalized view of a Claude Code hook payload (delivered as JSON on stdin).
+ * Field names vary slightly across events/versions, so we read both snake_case
+ * and camelCase defensively.
+ */
+export interface HookInput {
+    sessionId?: string;
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+    toolResponse?: unknown;
+    cwd?: string;
+    prompt?: string;
+    raw: string;
+}
+/** Read + parse the hook JSON from stdin. Never throws — returns {} on any issue. */
+export declare function readHookInput(stdin?: Readable & {
+    isTTY?: boolean;
+}): Promise<HookInput>;
+/** Build a concise, human-readable descriptor of a tool-use for an observation. */
+export declare function summarizeToolUse(toolName: string, toolInput?: Record<string, unknown>): string;
+/** The file path a tool-use targets, if any (for deny-list checks). */
+export declare function targetPath(toolInput?: Record<string, unknown>): string | undefined;
+//# sourceMappingURL=hook-io.d.ts.map

package/dist/lib/hook-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-io.d.ts","sourceRoot":"","sources":["../../src/lib/hook-io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAgBD,qFAAqF;AACrF,wBAAsB,aAAa,CAAC,KAAK,GAAE,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CAiB7G;AAmBD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAuB9F;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAIlF"}

package/dist/lib/hook-io.js

@@ -0,0 +1,73 @@
+/** Read + parse the hook JSON from stdin. Never throws — returns {} on any issue. */
+export async function readHookInput(stdin = process.stdin) {
+    const raw = await readAll(stdin);
+    let parsed = {};
+    try {
+        parsed = raw.trim().length > 0 ? JSON.parse(raw) : {};
+    }
+    catch {
+        parsed = {};
+    }
+    return {
+        sessionId: parsed.session_id ?? parsed.sessionId,
+        toolName: parsed.tool_name ?? parsed.toolName,
+        toolInput: parsed.tool_input ?? parsed.toolInput,
+        toolResponse: parsed.tool_response ?? parsed.toolResponse,
+        cwd: parsed.cwd,
+        prompt: parsed.prompt ?? parsed.user_prompt,
+        raw,
+    };
+}
+function readAll(stream) {
+    return new Promise((resolve) => {
+        if (stream.isTTY) {
+            resolve('');
+            return;
+        }
+        let data = '';
+        stream.setEncoding('utf8');
+        stream.on('data', (c) => (data += c));
+        stream.on('end', () => resolve(data));
+        stream.on('error', () => resolve(data));
+        // Backstop so a hook never hangs the agent if stdin is held open.
+        const t = setTimeout(() => resolve(data), 5000);
+        if (typeof t.unref === 'function')
+            t.unref();
+    });
+}
+/** Build a concise, human-readable descriptor of a tool-use for an observation. */
+export function summarizeToolUse(toolName, toolInput) {
+    const s = (v) => (typeof v === 'string' ? v : v == null ? '' : JSON.stringify(v));
+    const input = toolInput ?? {};
+    switch (toolName) {
+        case 'Edit':
+        case 'Write':
+        case 'Read':
+        case 'NotebookEdit':
+            return `${toolName}: ${s(input.file_path ?? input.path ?? input.notebook_path)}`;
+        case 'Bash':
+        case 'PowerShell':
+            return `${toolName}: ${firstLine(s(input.command))}`;
+        case 'Grep':
+        case 'Glob':
+            return `${toolName}: ${s(input.pattern)}${input.path ? ` in ${s(input.path)}` : ''}`;
+        case 'Task':
+        case 'Agent':
+            return `${toolName}: ${s(input.description ?? input.subagent_type)}`;
+        default: {
+            const brief = firstLine(s(input.file_path ?? input.path ?? input.command ?? input.pattern ?? input.description ?? ''));
+            return brief ? `${toolName}: ${brief}` : toolName;
+        }
+    }
+}
+/** The file path a tool-use targets, if any (for deny-list checks). */
+export function targetPath(toolInput) {
+    const input = toolInput ?? {};
+    const p = input.file_path ?? input.path ?? input.notebook_path;
+    return typeof p === 'string' ? p : undefined;
+}
+function firstLine(s) {
+    const line = s.split(/\r?\n/, 1)[0] ?? '';
+    return line.length > 160 ? `${line.slice(0, 159)}…` : line;
+}
+//# sourceMappingURL=hook-io.js.map

package/dist/lib/hook-io.js.map

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

package/dist/lib/ingest.d.ts

@@ -0,0 +1,24 @@
+import { TreeSitterIndexer } from '@knowzai/indexer';
+import type { LocalStore } from '@knowzai/local-store';
+export type IngestType = 'Note' | 'Document' | 'Code';
+/** Infer a knowledge type from the file extension. */
+export declare function inferType(path: string): IngestType;
+export interface IngestResult {
+    id: string;
+    title: string;
+    type: IngestType;
+    chunks: number;
+    lang?: string;
+}
+/**
+ * Ingest a single file into the local store as a knowledge item: chunk +
+ * embed (via the indexer), set file-state, mark `new` so `sync push` can ship
+ * it. The foundation for richer ingestion sources (email/web/watch) later.
+ */
+export declare function ingestFile(indexer: TreeSitterIndexer, store: LocalStore, path: string, opts?: {
+    vaultId?: string;
+    tags?: string[];
+    type?: IngestType;
+    title?: string;
+}): Promise<IngestResult>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/lib/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/lib/ingest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAkB,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAKtD,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAKlD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,OAAO,CAAC,YAAY,CAAC,CAsBvB"}

package/dist/lib/ingest.js

@@ -0,0 +1,44 @@
+import { readFileSync, statSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { grammarForPath } from '@knowzai/indexer';
+const DOC_EXT = new Set(['md', 'markdown', 'txt', 'rst', 'adoc', 'text']);
+const NON_CODE_GRAMMARS = new Set(['json', 'yaml', 'yml', 'toml', 'html', 'css']);
+/** Infer a knowledge type from the file extension. */
+export function inferType(path) {
+    const ext = path.split('.').pop()?.toLowerCase() ?? '';
+    if (grammarForPath(path) && !NON_CODE_GRAMMARS.has(ext))
+        return 'Code';
+    if (DOC_EXT.has(ext))
+        return 'Document';
+    return 'Note';
+}
+/**
+ * Ingest a single file into the local store as a knowledge item: chunk +
+ * embed (via the indexer), set file-state, mark `new` so `sync push` can ship
+ * it. The foundation for richer ingestion sources (email/web/watch) later.
+ */
+export async function ingestFile(indexer, store, path, opts = {}) {
+    const content = readFileSync(path, 'utf8');
+    const res = await indexer.indexFile(path, content);
+    const type = opts.type ?? inferType(path);
+    res.item.type = type;
+    if (opts.title)
+        res.item.title = opts.title;
+    res.item.tags = [...new Set([...(res.item.tags ?? []), ...(opts.tags ?? [])])];
+    if (opts.vaultId)
+        res.item.vaultId = opts.vaultId;
+    res.item.syncState = 'new';
+    await store.upsertItem(res.item);
+    await store.putChunks(res.item.id, res.chunks, res.vectors);
+    const st = statSync(path);
+    await store.setFileState({
+        path,
+        hash: createHash('sha256').update(content).digest('hex'),
+        mtimeMs: st.mtimeMs,
+        size: st.size,
+        itemId: res.item.id,
+        lastIndexedAt: new Date().toISOString(),
+    });
+    return { id: res.item.id, title: res.item.title, type, chunks: res.chunks.length, lang: res.lang };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/lib/ingest.js.map

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

package/dist/lib/login.d.ts

@@ -0,0 +1,40 @@
+import { type CredentialStore, type KnowzConfig, type KeyType } from '@knowzai/core';
+import type { RegisterResult, VerifyResult } from '@knowzai/types';
+export type LoginMode = 'paste' | 'register' | 'self-hosted';
+export interface LoginInput {
+    profile: string;
+    apiUrl: string;
+    mode: LoginMode;
+    key?: string;
+    register?: {
+        name: string;
+        email: string;
+        password?: string;
+    };
+    storeTenantKey?: boolean;
+    force?: boolean;
+}
+export interface LoginDeps {
+    store: CredentialStore;
+    config: KnowzConfig;
+    saveConfig: (cfg: KnowzConfig) => void;
+    validateKey: (apiKey: string) => Promise<VerifyResult>;
+    register: (req: {
+        name: string;
+        email: string;
+        password?: string;
+    }) => Promise<RegisterResult>;
+}
+export interface LoginResult {
+    profile: string;
+    keyType?: KeyType;
+    tenantId?: string;
+    email?: string;
+}
+/**
+ * Verify-on-login, persist-after-verify (S-N3-6). Never returns or logs the key.
+ * Throws KnowzError(Auth) on rejected credentials, KnowzError(Usage) on bad
+ * input / wrong-tenant overwrite without --force.
+ */
+export declare function performLogin(input: LoginInput, deps: LoginDeps): Promise<LoginResult>;
+//# sourceMappingURL=login.d.ts.map

package/dist/lib/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/lib/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,OAAO,EACb,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD,QAAQ,EAAE,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAChG;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAsD3F"}

package/dist/lib/login.js

@@ -0,0 +1,56 @@
+import { KnowzError, ExitCode, enforceTls, validateKeyFormat, keyType, } from '@knowzai/core';
+/**
+ * Verify-on-login, persist-after-verify (S-N3-6). Never returns or logs the key.
+ * Throws KnowzError(Auth) on rejected credentials, KnowzError(Usage) on bad
+ * input / wrong-tenant overwrite without --force.
+ */
+export async function performLogin(input, deps) {
+    enforceTls(input.apiUrl);
+    let key;
+    let verify;
+    let email;
+    if (input.mode === 'register') {
+        if (!input.register?.email || !input.register?.name) {
+            throw new KnowzError('register requires --email and --name', ExitCode.Usage);
+        }
+        const res = await deps.register(input.register);
+        key = input.storeTenantKey ? res.apiKey : res.userApiKey;
+        email = input.register.email;
+        verify = { isValid: true, tenant: { id: res.tenantId }, user: { id: '', email } };
+    }
+    else {
+        if (!input.key)
+            throw new KnowzError('no API key provided', ExitCode.Usage);
+        key = input.key.trim();
+        const fmt = validateKeyFormat(key);
+        if (!fmt.ok)
+            throw new KnowzError(`Invalid API key: ${fmt.reason}`, ExitCode.Usage);
+        verify = await deps.validateKey(key);
+        if (!verify.isValid) {
+            throw new KnowzError('API key was rejected by the server', ExitCode.Auth);
+        }
+        email = verify.user?.email;
+    }
+    // Wrong-tenant overwrite guard (S-N3-6).
+    const existing = await deps.store.getSecret(input.profile);
+    if (existing && !input.force) {
+        const existingTenant = deps.config.profiles[input.profile]?.tenantId;
+        const newTenant = verify.tenant?.id;
+        if (existingTenant && newTenant && existingTenant !== newTenant) {
+            throw new KnowzError(`Profile '${input.profile}' already holds credentials for a different tenant. Pass --force to overwrite.`, ExitCode.Usage);
+        }
+    }
+    await deps.store.setSecret(input.profile, key);
+    const prev = deps.config.profiles[input.profile];
+    deps.config.profiles[input.profile] = {
+        apiUrl: input.apiUrl,
+        tenantId: verify.tenant?.id ?? prev?.tenantId,
+        email: email ?? prev?.email,
+        label: prev?.label,
+        defaultVaultId: prev?.defaultVaultId,
+    };
+    deps.config.activeProfile = input.profile;
+    deps.saveConfig(deps.config);
+    return { profile: input.profile, keyType: keyType(key), tenantId: verify.tenant?.id, email };
+}
+//# sourceMappingURL=login.js.map

package/dist/lib/login.js.map

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

package/dist/lib/pending-captures.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Parser for the legacy KnowzCode "pending captures" markdown buffers
+ * (`knowzcode/pending_captures*.md`, `knowz-pending.md`) — the orphaned
+ * agent-memory backlog that accumulated because capture was coupled to a flaky
+ * cloud MCP session. `knowz capture seal --from-pending` parses these into the
+ * durable capture outbox so they finally drain through an idempotent consumer.
+ */
+export interface ParsedCapture {
+    title: string;
+    vaultId?: string;
+    category?: string;
+    content: string;
+    source?: string;
+    ts?: string;
+    sourceFile: string;
+    /** Stable, content-derived key for idempotent enqueue (outbox PK). */
+    dedupKey: string;
+}
+/** Parse one pending-captures markdown document into discrete captures. */
+export declare function parsePendingMarkdown(markdown: string, sourceFile?: string): ParsedCapture[];
+/** Known pending-capture file locations relative to a repo root. */
+export declare function defaultPendingFiles(root: string): string[];
+/** Read + parse a set of pending files, tagging each capture with its source. */
+export declare function parsePendingFiles(files: string[]): ParsedCapture[];
+//# sourceMappingURL=pending-captures.d.ts.map

package/dist/lib/pending-captures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-captures.d.ts","sourceRoot":"","sources":["../../src/lib/pending-captures.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAY,GAAG,aAAa,EAAE,CA6C9F;AA2DD,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAY1D;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAOlE"}