@unlimiting/qsc 0.1.0

package/dist/chunker/languages/typescript.js

@@ -0,0 +1,34 @@
+export const typescriptConfig = {
+    extensions: [".ts", ".js"],
+    treeSitterLanguage: "typescript",
+    treeSitterWasmFile: "tree-sitter-typescript.wasm",
+    chunkNodeTypes: [
+        "function_declaration",
+        "arrow_function",
+        "class_declaration",
+        "method_definition",
+        "interface_declaration",
+        "type_alias_declaration",
+        "enum_declaration",
+        "export_statement",
+        "lexical_declaration",
+        "variable_declaration",
+    ],
+    containerNodeTypes: [
+        "program",
+        "class_body",
+        "module",
+        "export_statement",
+    ],
+    importNodeTypes: [
+        "import_statement",
+    ],
+    nameFields: ["name", "property"],
+};
+export const tsxConfig = {
+    ...typescriptConfig,
+    extensions: [".tsx", ".jsx"],
+    treeSitterLanguage: "tsx",
+    treeSitterWasmFile: "tree-sitter-tsx.wasm",
+};
+//# sourceMappingURL=typescript.js.map

package/dist/chunker/languages/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../src/chunker/languages/typescript.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;IAC1B,kBAAkB,EAAE,YAAY;IAChC,kBAAkB,EAAE,6BAA6B;IACjD,cAAc,EAAE;QACd,sBAAsB;QACtB,gBAAgB;QAChB,mBAAmB;QACnB,mBAAmB;QACnB,uBAAuB;QACvB,wBAAwB;QACxB,kBAAkB;QAClB,kBAAkB;QAClB,qBAAqB;QACrB,sBAAsB;KACvB;IACD,kBAAkB,EAAE;QAClB,SAAS;QACT,YAAY;QACZ,QAAQ;QACR,kBAAkB;KACnB;IACD,eAAe,EAAE;QACf,kBAAkB;KACnB;IACD,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;CACjC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAmB;IACvC,GAAG,gBAAgB;IACnB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,KAAK;IACzB,kBAAkB,EAAE,sBAAsB;CAC3C,CAAC"}

package/dist/chunker/token.d.ts

@@ -0,0 +1,6 @@
+import type { Chunk } from "./index.js";
+export interface TokenChunker {
+    chunk(content: string, filePath: string): Chunk[];
+}
+export declare function createTokenChunker(maxTokens: number, overlapRatio: number): TokenChunker;
+//# sourceMappingURL=token.d.ts.map

package/dist/chunker/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/chunker/token.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAyCxC,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;CACnD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAuExF"}

package/dist/chunker/token.js

@@ -0,0 +1,107 @@
+import { extname } from "node:path";
+/**
+ * Rough token count estimation: ~4 characters per token on average for code.
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Find the best split point near a target line index, respecting code boundaries.
+ * Prefers splitting at blank lines, then at dedent boundaries.
+ */
+function findBestSplit(lines, targetIdx, windowSize) {
+    const start = Math.max(0, targetIdx - windowSize);
+    const end = Math.min(lines.length - 1, targetIdx + windowSize);
+    // Prefer blank lines
+    for (let i = targetIdx; i >= start; i--) {
+        if (lines[i].trim() === "")
+            return i + 1;
+    }
+    for (let i = targetIdx + 1; i <= end; i++) {
+        if (lines[i].trim() === "")
+            return i + 1;
+    }
+    // Prefer lines with less indentation (scope boundary)
+    let bestIdx = targetIdx;
+    let bestIndent = Infinity;
+    for (let i = start; i <= end; i++) {
+        const line = lines[i];
+        if (line.trim() === "")
+            continue;
+        const indent = line.length - line.trimStart().length;
+        if (indent < bestIndent) {
+            bestIndent = indent;
+            bestIdx = i;
+        }
+    }
+    return bestIdx;
+}
+export function createTokenChunker(maxTokens, overlapRatio) {
+    return {
+        chunk(content, filePath) {
+            const lines = content.split("\n");
+            if (lines.length === 0)
+                return [];
+            const ext = extname(filePath).toLowerCase();
+            const language = ext ? ext.slice(1) : "unknown";
+            const totalTokens = estimateTokens(content);
+            if (totalTokens <= maxTokens) {
+                return [{
+                        content,
+                        startLine: 1,
+                        endLine: lines.length,
+                        type: "module",
+                        language,
+                    }];
+            }
+            const overlapTokens = Math.floor(maxTokens * overlapRatio);
+            const chunks = [];
+            let lineIdx = 0;
+            while (lineIdx < lines.length) {
+                // Accumulate lines until we reach maxTokens
+                let tokenCount = 0;
+                let endIdx = lineIdx;
+                while (endIdx < lines.length) {
+                    const lineTokens = estimateTokens(lines[endIdx] + "\n");
+                    if (tokenCount + lineTokens > maxTokens && endIdx > lineIdx)
+                        break;
+                    tokenCount += lineTokens;
+                    endIdx++;
+                }
+                // Try to find a good split point if we're not at the end
+                if (endIdx < lines.length) {
+                    const window = Math.min(10, Math.floor((endIdx - lineIdx) * 0.2));
+                    endIdx = findBestSplit(lines, endIdx - 1, window);
+                    if (endIdx <= lineIdx)
+                        endIdx = lineIdx + 1;
+                }
+                const chunkLines = lines.slice(lineIdx, endIdx);
+                const chunkContent = chunkLines.join("\n");
+                if (chunkContent.trim().length > 0) {
+                    chunks.push({
+                        content: chunkContent,
+                        startLine: lineIdx + 1,
+                        endLine: endIdx,
+                        type: "block",
+                        language,
+                    });
+                }
+                // Compute overlap: go back by overlapTokens worth of lines
+                if (endIdx >= lines.length)
+                    break;
+                let overlapLines = 0;
+                let overlapCount = 0;
+                for (let i = endIdx - 1; i >= lineIdx; i--) {
+                    const lt = estimateTokens(lines[i] + "\n");
+                    if (overlapCount + lt > overlapTokens)
+                        break;
+                    overlapCount += lt;
+                    overlapLines++;
+                }
+                lineIdx = endIdx - overlapLines;
+            }
+            return chunks;
+        },
+    };
+}
+//# sourceMappingURL=token.js.map

package/dist/chunker/token.js.map

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

package/dist/collection.d.ts

@@ -0,0 +1,22 @@
+export interface CollectionMeta {
+    dbPath: string;
+    sourcePath: string;
+    createdAt: string;
+    updateCommand?: string;
+}
+export interface CollectionRegistry {
+    [name: string]: CollectionMeta;
+}
+export declare function ensureQscHome(): void;
+export declare function getCollectionDbPath(name: string): string;
+export declare function listCollections(): CollectionRegistry;
+export declare function getCollection(name: string): CollectionMeta | undefined;
+export declare function registerCollection(name: string, sourcePath: string, dbPath?: string, updateCommand?: string): CollectionMeta;
+export declare function updateCollectionMeta(name: string, updates: Partial<Pick<CollectionMeta, "updateCommand">>): CollectionMeta;
+export declare function removeCollection(name: string): boolean;
+export declare function resolveCollectionDb(name: string): string;
+export declare function resolveCollectionSourcePath(name: string): string;
+export declare function copyCollection(sourceName: string, destName: string, newSourcePath: string): CollectionMeta;
+export declare function importCollection(name: string, sqlitePath: string, sourcePath: string): CollectionMeta;
+export declare function exportCollection(name: string, outputPath: string): void;
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;CAChC;AAkDD,wBAAgB,aAAa,IAAI,IAAI,CASpC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,eAAe,IAAI,kBAAkB,CAEpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGtE;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,cAAc,CAkBhB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,GACtD,cAAc,CAqBhB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,cAAc,CAehB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,cAAc,CAYhB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAgBvE"}

package/dist/collection.js

@@ -0,0 +1,154 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from "node:fs";
+import { resolve, join, dirname } from "node:path";
+import { homedir } from "node:os";
+// --- Paths ---
+function getQscHome() {
+    return resolve(homedir(), ".qsc");
+}
+function getRegistryPath() {
+    return join(getQscHome(), "collections.json");
+}
+function getCollectionsDir() {
+    return join(getQscHome(), "collections");
+}
+// --- Registry I/O ---
+function readRegistry() {
+    const registryPath = getRegistryPath();
+    if (!existsSync(registryPath)) {
+        return {};
+    }
+    const raw = readFileSync(registryPath, "utf-8");
+    return JSON.parse(raw);
+}
+function writeRegistry(registry) {
+    const registryPath = getRegistryPath();
+    const dir = dirname(registryPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(registryPath, JSON.stringify(registry, null, 2), "utf-8");
+}
+// --- Validation ---
+const VALID_COLLECTION_NAME = /^[a-zA-Z0-9_-]+$/;
+function validateCollectionName(name) {
+    if (!VALID_COLLECTION_NAME.test(name)) {
+        throw new Error(`Invalid collection name '${name}'. Only alphanumeric characters, hyphens, and underscores are allowed.`);
+    }
+}
+// --- Public API ---
+export function ensureQscHome() {
+    const home = getQscHome();
+    if (!existsSync(home)) {
+        mkdirSync(home, { recursive: true });
+    }
+    const collectionsDir = getCollectionsDir();
+    if (!existsSync(collectionsDir)) {
+        mkdirSync(collectionsDir, { recursive: true });
+    }
+}
+export function getCollectionDbPath(name) {
+    validateCollectionName(name);
+    return join(getCollectionsDir(), `${name}.sqlite`);
+}
+export function listCollections() {
+    return readRegistry();
+}
+export function getCollection(name) {
+    const registry = readRegistry();
+    return registry[name];
+}
+export function registerCollection(name, sourcePath, dbPath, updateCommand) {
+    ensureQscHome();
+    const finalDbPath = dbPath ?? getCollectionDbPath(name);
+    const meta = {
+        dbPath: finalDbPath,
+        sourcePath: resolve(sourcePath),
+        createdAt: new Date().toISOString(),
+    };
+    if (updateCommand !== undefined) {
+        meta.updateCommand = updateCommand;
+    }
+    const registry = readRegistry();
+    registry[name] = meta;
+    writeRegistry(registry);
+    return meta;
+}
+export function updateCollectionMeta(name, updates) {
+    const registry = readRegistry();
+    const meta = registry[name];
+    if (!meta) {
+        throw new Error(`Collection '${name}' not found. Run 'qsc init ${name} <path>' first.`);
+    }
+    if (updates.updateCommand !== undefined) {
+        if (updates.updateCommand === "") {
+            delete meta.updateCommand;
+        }
+        else {
+            meta.updateCommand = updates.updateCommand;
+        }
+    }
+    registry[name] = meta;
+    writeRegistry(registry);
+    return meta;
+}
+export function removeCollection(name) {
+    const registry = readRegistry();
+    if (!registry[name])
+        return false;
+    delete registry[name];
+    writeRegistry(registry);
+    return true;
+}
+export function resolveCollectionDb(name) {
+    const meta = getCollection(name);
+    if (!meta) {
+        throw new Error(`Collection '${name}' not found. Run 'qsc init ${name} <path>' first.`);
+    }
+    return meta.dbPath;
+}
+export function resolveCollectionSourcePath(name) {
+    const meta = getCollection(name);
+    if (!meta) {
+        throw new Error(`Collection '${name}' not found. Run 'qsc init ${name} <path>' first.`);
+    }
+    return meta.sourcePath;
+}
+export function copyCollection(sourceName, destName, newSourcePath) {
+    const sourceMeta = getCollection(sourceName);
+    if (!sourceMeta) {
+        throw new Error(`Source collection '${sourceName}' not found.`);
+    }
+    if (!existsSync(sourceMeta.dbPath)) {
+        throw new Error(`Source database not found: ${sourceMeta.dbPath}`);
+    }
+    ensureQscHome();
+    const destDbPath = getCollectionDbPath(destName);
+    copyFileSync(sourceMeta.dbPath, destDbPath);
+    return registerCollection(destName, newSourcePath, destDbPath);
+}
+export function importCollection(name, sqlitePath, sourcePath) {
+    const absSource = resolve(sqlitePath);
+    if (!existsSync(absSource)) {
+        throw new Error(`SQLite file not found: ${absSource}`);
+    }
+    ensureQscHome();
+    const destDbPath = getCollectionDbPath(name);
+    copyFileSync(absSource, destDbPath);
+    return registerCollection(name, sourcePath, destDbPath);
+}
+export function exportCollection(name, outputPath) {
+    const meta = getCollection(name);
+    if (!meta) {
+        throw new Error(`Collection '${name}' not found.`);
+    }
+    if (!existsSync(meta.dbPath)) {
+        throw new Error(`Database not found: ${meta.dbPath}`);
+    }
+    const absOutput = resolve(outputPath);
+    const outDir = dirname(absOutput);
+    if (!existsSync(outDir)) {
+        mkdirSync(outDir, { recursive: true });
+    }
+    copyFileSync(meta.dbPath, absOutput);
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,95 @@
+import { z } from "zod";
+declare const EmbedderConfigSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        openai: "openai";
+        local: "local";
+    }>>;
+    model: z.ZodDefault<z.ZodString>;
+    api_key_env: z.ZodDefault<z.ZodString>;
+    dimensions: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const LLMConfigSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        openai: "openai";
+        local: "local";
+    }>>;
+    model: z.ZodDefault<z.ZodString>;
+    api_key_env: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+declare const ChunkerConfigSchema: z.ZodObject<{
+    max_tokens: z.ZodDefault<z.ZodNumber>;
+    overlap: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const ScannerConfigSchema: z.ZodObject<{
+    exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    max_file_size: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const QSCConfigSchema: z.ZodObject<{
+    embedder: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<{
+            openai: "openai";
+            local: "local";
+        }>>;
+        model: z.ZodDefault<z.ZodString>;
+        api_key_env: z.ZodDefault<z.ZodString>;
+        dimensions: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>, z.ZodTransform<{
+        provider: "openai" | "local";
+        model: string;
+        api_key_env: string;
+        dimensions: number;
+    }, {
+        provider: "openai" | "local";
+        model: string;
+        api_key_env: string;
+        dimensions: number;
+    } | undefined>>;
+    llm: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<{
+            openai: "openai";
+            local: "local";
+        }>>;
+        model: z.ZodDefault<z.ZodString>;
+        api_key_env: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>, z.ZodTransform<{
+        provider: "openai" | "local";
+        model: string;
+        api_key_env: string;
+    }, {
+        provider: "openai" | "local";
+        model: string;
+        api_key_env: string;
+    } | undefined>>;
+    chunker: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+        max_tokens: z.ZodDefault<z.ZodNumber>;
+        overlap: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>, z.ZodTransform<{
+        max_tokens: number;
+        overlap: number;
+    }, {
+        max_tokens: number;
+        overlap: number;
+    } | undefined>>;
+    scanner: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+        exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        max_file_size: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>, z.ZodTransform<{
+        exclude: string[];
+        max_file_size: number;
+    }, {
+        exclude: string[];
+        max_file_size: number;
+    } | undefined>>;
+}, z.core.$strip>;
+export type QSCConfig = z.infer<typeof QSCConfigSchema>;
+export type EmbedderConfig = z.infer<typeof EmbedderConfigSchema>;
+export type LLMConfig = z.infer<typeof LLMConfigSchema>;
+export type ChunkerConfig = z.infer<typeof ChunkerConfigSchema>;
+export type ScannerConfig = z.infer<typeof ScannerConfigSchema>;
+/**
+ * Load configuration from a qsc.yml file, apply environment variable
+ * overrides, validate with zod, and return the merged config with defaults.
+ */
+export declare function loadConfig(basePath?: string): QSCConfig;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,QAAA,MAAM,oBAAoB;;;;;;;;iBAKxB,CAAC;AAEH,QAAA,MAAM,eAAe;;;;;;;iBAInB,CAAC;AAEH,QAAA,MAAM,mBAAmB;;;iBAGvB,CAAC;AAEH,QAAA,MAAM,mBAAmB;;;iBAUvB,CAAC;AAEH,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAanB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAgDhE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAevD"}

package/dist/config/index.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+// --- Zod schemas ---
+const EmbedderConfigSchema = z.object({
+    provider: z.enum(["openai", "local"]).default("openai"),
+    model: z.string().default("text-embedding-3-small"),
+    api_key_env: z.string().default("OPENAI_API_KEY"),
+    dimensions: z.number().int().positive().default(1536),
+});
+const LLMConfigSchema = z.object({
+    provider: z.enum(["openai", "local"]).default("openai"),
+    model: z.string().default("gpt-4o-mini"),
+    api_key_env: z.string().default("OPENAI_API_KEY"),
+});
+const ChunkerConfigSchema = z.object({
+    max_tokens: z.number().int().positive().default(900),
+    overlap: z.number().min(0).max(1).default(0.15),
+});
+const ScannerConfigSchema = z.object({
+    exclude: z
+        .array(z.string())
+        .default([
+        "node_modules/**",
+        ".git/**",
+        "dist/**",
+        "*.min.js",
+    ]),
+    max_file_size: z.number().int().positive().default(1_048_576),
+});
+const QSCConfigSchema = z.object({
+    embedder: EmbedderConfigSchema.optional().transform((v) => EmbedderConfigSchema.parse(v ?? {})),
+    llm: LLMConfigSchema.optional().transform((v) => LLMConfigSchema.parse(v ?? {})),
+    chunker: ChunkerConfigSchema.optional().transform((v) => ChunkerConfigSchema.parse(v ?? {})),
+    scanner: ScannerConfigSchema.optional().transform((v) => ScannerConfigSchema.parse(v ?? {})),
+});
+// --- Environment variable overrides ---
+function applyEnvOverrides(raw) {
+    const result = { ...raw };
+    // embedder overrides
+    const embedder = {
+        ...(result.embedder ?? {}),
+    };
+    if (process.env.QSC_EMBEDDER_PROVIDER)
+        embedder.provider = process.env.QSC_EMBEDDER_PROVIDER;
+    if (process.env.QSC_EMBEDDER_MODEL)
+        embedder.model = process.env.QSC_EMBEDDER_MODEL;
+    if (process.env.QSC_EMBEDDER_API_KEY_ENV)
+        embedder.api_key_env = process.env.QSC_EMBEDDER_API_KEY_ENV;
+    if (process.env.QSC_EMBEDDER_DIMENSIONS)
+        embedder.dimensions = Number(process.env.QSC_EMBEDDER_DIMENSIONS);
+    result.embedder = embedder;
+    // llm overrides
+    const llm = {
+        ...(result.llm ?? {}),
+    };
+    if (process.env.QSC_LLM_PROVIDER)
+        llm.provider = process.env.QSC_LLM_PROVIDER;
+    if (process.env.QSC_LLM_MODEL)
+        llm.model = process.env.QSC_LLM_MODEL;
+    if (process.env.QSC_LLM_API_KEY_ENV)
+        llm.api_key_env = process.env.QSC_LLM_API_KEY_ENV;
+    result.llm = llm;
+    // chunker overrides
+    const chunker = {
+        ...(result.chunker ?? {}),
+    };
+    if (process.env.QSC_CHUNKER_MAX_TOKENS)
+        chunker.max_tokens = Number(process.env.QSC_CHUNKER_MAX_TOKENS);
+    if (process.env.QSC_CHUNKER_OVERLAP)
+        chunker.overlap = Number(process.env.QSC_CHUNKER_OVERLAP);
+    result.chunker = chunker;
+    // scanner overrides
+    const scanner = {
+        ...(result.scanner ?? {}),
+    };
+    if (process.env.QSC_SCANNER_MAX_FILE_SIZE)
+        scanner.max_file_size = Number(process.env.QSC_SCANNER_MAX_FILE_SIZE);
+    result.scanner = scanner;
+    return result;
+}
+// --- Public API ---
+const CONFIG_FILENAMES = ["qsc.yml", "qsc.yaml"];
+/**
+ * Load configuration from a qsc.yml file, apply environment variable
+ * overrides, validate with zod, and return the merged config with defaults.
+ */
+export function loadConfig(basePath) {
+    const dir = basePath ?? process.cwd();
+    let raw = {};
+    for (const name of CONFIG_FILENAMES) {
+        const filePath = resolve(dir, name);
+        if (existsSync(filePath)) {
+            const content = readFileSync(filePath, "utf-8");
+            raw = parseYaml(content) ?? {};
+            break;
+        }
+    }
+    const withEnv = applyEnvOverrides(raw);
+    return QSCConfigSchema.parse(withEnv);
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/embedder/index.d.ts

@@ -0,0 +1,14 @@
+import type { EmbedderConfig } from "../config/index.js";
+/**
+ * Embedder interface: converts text strings into vector embeddings.
+ */
+export interface Embedder {
+    embed(texts: string[]): Promise<number[][]>;
+    readonly dimensions: number;
+    readonly modelName: string;
+}
+/**
+ * Factory function: creates an Embedder instance based on config.
+ */
+export declare function createEmbedder(config: EmbedderConfig): Promise<Embedder>;
+//# sourceMappingURL=index.d.ts.map

package/dist/embedder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embedder/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAa9E"}

package/dist/embedder/index.js

@@ -0,0 +1,18 @@
+/**
+ * Factory function: creates an Embedder instance based on config.
+ */
+export async function createEmbedder(config) {
+    switch (config.provider) {
+        case "openai": {
+            const { createOpenAIEmbedder } = await import("./openai.js");
+            return createOpenAIEmbedder(config);
+        }
+        case "local": {
+            const { createLocalEmbedder } = await import("./local.js");
+            return createLocalEmbedder(config);
+        }
+        default:
+            throw new Error(`Unknown embedder provider: ${config.provider}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/embedder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embedder/index.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAsB;IACzD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC7D,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAC3D,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,QAAkB,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/dist/embedder/local.d.ts

@@ -0,0 +1,11 @@
+import type { EmbedderConfig } from "../config/index.js";
+import type { Embedder } from "./index.js";
+/**
+ * Creates a local model Embedder using node-llama-cpp.
+ *
+ * NOTE: This is a stub implementation. Full functionality requires
+ * node-llama-cpp to be installed and a GGUF model file available.
+ * The interface and structure are ready for when the environment supports it.
+ */
+export declare function createLocalEmbedder(config: EmbedderConfig): Embedder;
+//# sourceMappingURL=local.d.ts.map

package/dist/embedder/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/embedder/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CA4DpE"}