@delfos-ai/cli 1.0.3

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { loginCommand } from './commands/login.command.js';
+import { logoutCommand } from './commands/logout.command.js';
+import { memoryCommand } from './commands/memory/index.js';
+import { mcpMemoryCommand } from './commands/mcp/mcp-memory.command.js';
+import { registerFatalHandlers } from './infrastructure/logger/index.js';
+const program = new Command();
+program
+    .name('delfos')
+    .description('Delfos CLI — AI Layer tools for the terminal')
+    .version('0.1.0');
+// Auth commands
+program.addCommand(loginCommand);
+program.addCommand(logoutCommand);
+// Memory commands
+program.addCommand(memoryCommand);
+// MCP commands
+const mcpCommand = new Command('mcp').description('MCP server operations');
+mcpCommand.addCommand(mcpMemoryCommand);
+program.addCommand(mcpCommand);
+registerFatalHandlers();
+await program.parseAsync(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,gBAAgB;AAChB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,kBAAkB;AAClB,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,eAAe;AACf,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAC3E,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAE/B,qBAAqB,EAAE,CAAC;AACxB,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/infrastructure/embeddings/embedding-provider.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Embedding provider interface for generating text embeddings.
+ */
+export interface EmbeddingProvider {
+    embed(texts: string[]): Promise<number[][]>;
+    modelName: string;
+    dimension: number;
+}
+//# sourceMappingURL=embedding-provider.d.ts.map

package/dist/infrastructure/embeddings/embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/embeddings/embedding-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/infrastructure/embeddings/embedding-provider.js

@@ -0,0 +1,5 @@
+/**
+ * Embedding provider interface for generating text embeddings.
+ */
+export {};
+//# sourceMappingURL=embedding-provider.js.map

package/dist/infrastructure/embeddings/embedding-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.js","sourceRoot":"","sources":["../../../src/infrastructure/embeddings/embedding-provider.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/infrastructure/embeddings/local-embedding.provider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Local embedding provider using a local model.
+ */
+import type { EmbeddingProvider } from './embedding-provider.js';
+/**
+ * Local embedding provider implementation class with lazy loading.
+ */
+export declare class LocalEmbeddingProvider implements EmbeddingProvider {
+    readonly modelName = "Xenova/all-MiniLM-L6-v2";
+    readonly dimension = 384;
+    private pipeline;
+    embed(texts: string[]): Promise<number[][]>;
+}
+/**
+ * Stub instance for backward compatibility.
+ */
+export declare const localEmbeddingProvider: EmbeddingProvider;
+//# sourceMappingURL=local-embedding.provider.d.ts.map

package/dist/infrastructure/embeddings/local-embedding.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-embedding.provider.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/embeddings/local-embedding.provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;GAEG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,QAAQ,CAAC,SAAS,6BAA6B;IAC/C,QAAQ,CAAC,SAAS,OAAO;IAEzB,OAAO,CAAC,QAAQ,CAAwB;IAElC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAsBlD;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,iBAQpC,CAAC"}

package/dist/infrastructure/embeddings/local-embedding.provider.js

@@ -0,0 +1,38 @@
+/**
+ * Local embedding provider using a local model.
+ */
+/**
+ * Local embedding provider implementation class with lazy loading.
+ */
+export class LocalEmbeddingProvider {
+    modelName = 'Xenova/all-MiniLM-L6-v2';
+    dimension = 384;
+    pipeline = null;
+    async embed(texts) {
+        // Lazy load pipeline on first call
+        if (this.pipeline === null) {
+            const { pipeline } = await import('@huggingface/transformers');
+            this.pipeline = await pipeline('feature-extraction', this.modelName);
+        }
+        // Call the pipeline
+        const results = await this.pipeline(texts, { pooling: 'mean', normalize: true });
+        // Convert results to number[][]
+        return results.map((r) => {
+            const embedding = r.data;
+            // Convert Float32Array to number[]
+            return Array.from(embedding);
+        });
+    }
+}
+/**
+ * Stub instance for backward compatibility.
+ */
+export const localEmbeddingProvider = {
+    modelName: 'local-model',
+    dimension: 384,
+    embed: async (texts) => {
+        const provider = new LocalEmbeddingProvider();
+        return provider.embed(texts);
+    },
+};
+//# sourceMappingURL=local-embedding.provider.js.map

package/dist/infrastructure/embeddings/local-embedding.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-embedding.provider.js","sourceRoot":"","sources":["../../../src/infrastructure/embeddings/local-embedding.provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACxB,SAAS,GAAG,yBAAyB,CAAC;IACtC,SAAS,GAAG,GAAG,CAAC;IAEjB,QAAQ,GAAmB,IAAI,CAAC;IAExC,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,mCAAmC;QACnC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACvE,CAAC;QAED,oBAAoB;QACpB,MAAM,OAAO,GAAG,MACd,IAAI,CAAC,QAIN,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,gCAAgC;QAChC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE;YAChC,MAAM,SAAS,GAAI,CAA4B,CAAC,IAAI,CAAC;YACrD,mCAAmC;YACnC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,GAAG;IAEd,KAAK,EAAE,KAAK,EAAE,KAAe,EAAuB,EAAE;QACpD,MAAM,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC"}

package/dist/infrastructure/logger/index.d.ts

@@ -0,0 +1,21 @@
+import { type Logger } from 'pino';
+export declare const logger: Logger;
+export declare function createSliceLogger(slice: string, extra?: Record<string, unknown>): Logger;
+interface JobContext {
+    id?: string | null;
+    name?: string;
+    data?: {
+        userId?: string;
+        flowJobId?: string;
+        operationId?: string;
+        [key: string]: unknown;
+    };
+    attemptsMade?: number;
+    opts?: {
+        attempts?: number;
+    };
+}
+export declare function createJobLogger(job: JobContext, sliceLogger?: Logger): Logger;
+export declare function registerFatalHandlers(): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/logger/index.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AA4EzC,eAAO,MAAM,MAAM,EAAE,MAcpB,CAAC;AAUF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAER;AAUD,UAAU,UAAU;IAClB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAY7E;AASD,wBAAgB,qBAAqB,IAAI,IAAI,CAa5C"}

package/dist/infrastructure/logger/index.js

@@ -0,0 +1,116 @@
+import pino from 'pino';
+import { createRequire } from 'node:module';
+const _require = createRequire(import.meta.url);
+// =============================================================================
+// Regra 1 — Data Redaction: chaves sensíveis mascaradas em TODOS os ambientes
+// =============================================================================
+const REDACTED_PATHS = [
+    // Chaves BYOK e credenciais de IA
+    'api_key',
+    'apiKey',
+    'key_encrypted',
+    'byokKey',
+    // Headers HTTP de autenticação (passados como objeto em logs de request)
+    'req.headers.authorization',
+    'req.headers["authorization"]',
+    'req.headers["anthropic-api-key"]',
+    'req.headers["x-api-key"]',
+    'req.headers["openai-api-key"]',
+    // Corpo de request/response com prompts ou dados sensíveis
+    'req.body.password',
+    'req.body.api_key',
+    'req.body.prompt',
+    'req.body.messages',
+    'res.body.choices',
+    // Contexto de jobs (o dado bruto de um job pode carregar a chave)
+    'jobData.byokKey',
+    'jobData.key_encrypted',
+    // Campos genéricos que poderiam aparecer em qualquer nível
+    'password',
+    'token',
+    'secret',
+    'authorization',
+];
+// =============================================================================
+// Regra 4 — Separação de Ambientes: JSON em produção, pretty em dev
+// =============================================================================
+const isDev = process.env.NODE_ENV === 'development';
+// Verifica se pino-pretty está disponível antes de tentar usá-lo
+// Isso evita erros em containers Docker onde devDependencies não estão instaladas
+const canUsePretty = isDev &&
+    (() => {
+        try {
+            _require.resolve('pino-pretty');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    })();
+const transport = canUsePretty
+    ? {
+        target: 'pino-pretty',
+        options: {
+            colorize: true,
+            translateTime: 'SYS:yyyy-mm-dd HH:MM:ss',
+            ignore: 'pid,hostname',
+            messageFormat: '[{slice}] {msg}',
+        },
+    }
+    : undefined; // produção ou pino-pretty não disponível: JSON puro via process.stdout
+// =============================================================================
+// Logger base — único por processo, compartilhado via import
+// =============================================================================
+export const logger = pino({
+    level: process.env.LOG_LEVEL ?? (isDev ? 'debug' : 'info'),
+    redact: {
+        paths: REDACTED_PATHS,
+        censor: '[REDACTED]',
+    },
+    base: {
+        pid: process.pid,
+        env: process.env.NODE_ENV ?? 'development',
+    },
+    timestamp: pino.stdTimeFunctions.isoTime,
+}, transport ? pino.transport(transport) : process.stdout);
+// =============================================================================
+// Regra 2 — VSA Child Logger: cada slice declara o seu contexto de origem
+//
+// Uso em qualquer slice:
+//   import { createSliceLogger } from '../../infrastructure/logger/index.js';
+//   const logger = createSliceLogger('convert-instructions');
+// =============================================================================
+export function createSliceLogger(slice, extra) {
+    return logger.child({ slice, ...extra });
+}
+export function createJobLogger(job, sliceLogger) {
+    const base = sliceLogger ?? logger;
+    return base.child({
+        jobId: job.id,
+        jobName: job.name,
+        flowJobId: job.data?.flowJobId ?? null,
+        userId: job.data?.userId,
+        operationId: job.data?.operationId,
+        attempt: (job.attemptsMade ?? 0) + 1,
+        maxAttempts: job.opts?.attempts,
+    });
+}
+// =============================================================================
+// Regra 5 — Erros Fatais: uncaughtException + unhandledRejection
+// Deve ser chamado UMA VEZ em main.ts antes de qualquer outro setup
+// =============================================================================
+let fatalHandlersRegistered = false;
+export function registerFatalHandlers() {
+    if (fatalHandlersRegistered)
+        return;
+    fatalHandlersRegistered = true;
+    process.on('uncaughtException', (err) => {
+        logger.fatal({ err }, 'uncaughtException — processo encerrando');
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        logger.fatal({ reason }, 'unhandledRejection — promise sem handler');
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/logger/index.js.map

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

package/dist/infrastructure/vector-db/chroma.adapter.d.ts

@@ -0,0 +1,76 @@
+export declare class EmbeddingDimensionMismatchError extends Error {
+    readonly expected: number;
+    readonly received: number;
+    constructor(expected: number, received: number);
+}
+/**
+ * ChromaDB adapter implementation class.
+ */
+export declare class ChromaDBAdapterImpl implements ChromaDBAdapter {
+    private readonly host;
+    private readonly port;
+    private client;
+    constructor(host: string, port: number);
+    collectionExists(collectionName: string): Promise<boolean>;
+    queryChunks(_collectionName: string, _embedding: number[], _limit: number, _filters?: QueryFilters): Promise<QueryResult[]>;
+    getOrCreateCollection(collectionName: string, dimension: number): Promise<void>;
+    dropCollection(collectionName: string): Promise<void>;
+    getCollectionMeta(collectionName: string): Promise<CollectionMeta>;
+    upsertChunks(collectionName: string, chunks: ChunkToUpsert[]): Promise<void>;
+    deleteByPaths(_collectionName: string, _paths: string[]): Promise<void>;
+    updateLastIndexAt(collectionName: string, timestamp?: string): Promise<void>;
+}
+export interface QueryFilters {
+    folder?: string;
+    tags?: string;
+}
+export interface ChunkToUpsert {
+    id: string;
+    content: string;
+    embedding: number[];
+    metadata: {
+        path: string;
+        title: string;
+        folder: string;
+        tags: string;
+        modified_at: string;
+        type: string;
+        chunk_index: number;
+        heading: string;
+    };
+}
+export interface QueryResult {
+    id: string;
+    content: string;
+    score: number;
+    metadata: {
+        path: string;
+        title: string;
+        folder: string;
+        tags: string | string[];
+        modified_at: string;
+        type: string;
+        chunk_index: number;
+        heading: string;
+    };
+}
+export interface CollectionMeta {
+    count: number;
+    dimension: number;
+    lastIndexAt: string | null;
+}
+export interface ChromaDBAdapter {
+    collectionExists(collectionName: string): Promise<boolean>;
+    queryChunks(collectionName: string, embedding: number[], limit: number, filters?: QueryFilters): Promise<QueryResult[]>;
+    getOrCreateCollection(collectionName: string, dimension: number): Promise<void>;
+    dropCollection(collectionName: string): Promise<void>;
+    getCollectionMeta(collectionName: string): Promise<CollectionMeta>;
+    upsertChunks(collectionName: string, chunks: ChunkToUpsert[]): Promise<void>;
+    deleteByPaths(collectionName: string, paths: string[]): Promise<void>;
+    updateLastIndexAt(collectionName: string): Promise<void>;
+}
+/**
+ * Stub implementation - replace with actual ChromaDB client.
+ */
+export declare const chromaDBAdapter: ChromaDBAdapter;
+//# sourceMappingURL=chroma.adapter.d.ts.map

package/dist/infrastructure/vector-db/chroma.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chroma.adapter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/vector-db/chroma.adapter.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/vector-db/chroma.adapter.js

@@ -0,0 +1,137 @@
+/**
+ * ChromaDB adapter for vector storage and retrieval.
+ */
+import { createRequire } from 'node:module';
+const _cjsRequire = createRequire(import.meta.url);
+export class EmbeddingDimensionMismatchError extends Error {
+    expected;
+    received;
+    constructor(expected, received) {
+        super(`Embedding dimension mismatch: received ${received}, expected ${expected}. Memory index is full, please rebuild.`);
+        this.expected = expected;
+        this.received = received;
+        this.name = 'EmbeddingDimensionMismatchError';
+    }
+}
+/**
+ * ChromaDB adapter implementation class.
+ */
+export class ChromaDBAdapterImpl {
+    host;
+    port;
+    client;
+    constructor(host, port) {
+        this.host = host;
+        this.port = port;
+        const { ChromaClient } = _cjsRequire('chromadb');
+        this.client = new ChromaClient({ path: `http://${host}:${port}` });
+    }
+    async collectionExists(collectionName) {
+        try {
+            await this.client.getCollection({ name: collectionName });
+            return true;
+        }
+        catch (err) {
+            if (err.name === 'ChromaNotFoundError')
+                return false;
+            throw err;
+        }
+    }
+    async queryChunks(_collectionName, _embedding, _limit, _filters) {
+        // TODO: Implement actual ChromaDB query
+        return [];
+    }
+    async getOrCreateCollection(collectionName, dimension) {
+        try {
+            const collection = await this.client.getCollection({ name: collectionName });
+            const colDimension = collection.metadata?.embeddingDimension;
+            if (colDimension && colDimension !== dimension) {
+                throw new EmbeddingDimensionMismatchError(dimension, colDimension);
+            }
+        }
+        catch (err) {
+            const errorName = err.name;
+            if (errorName === 'ChromaNotFoundError' ||
+                err instanceof EmbeddingDimensionMismatchError) {
+                if (err instanceof EmbeddingDimensionMismatchError)
+                    throw err;
+                await this.client.createCollection({
+                    name: collectionName,
+                    metadata: { embeddingDimension: dimension },
+                });
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    async dropCollection(collectionName) {
+        await this.client.deleteCollection({ name: collectionName });
+    }
+    async getCollectionMeta(collectionName) {
+        const collection = await this.client.getCollection({ name: collectionName });
+        const count = await collection.count();
+        return {
+            count,
+            dimension: collection.metadata?.embeddingDimension || 384,
+            lastIndexAt: collection.metadata?.lastIndexAt || null,
+        };
+    }
+    async upsertChunks(collectionName, chunks) {
+        if (chunks.length === 0)
+            return;
+        const collection = await this.client.getCollection({ name: collectionName });
+        await collection.upsert({
+            ids: chunks.map((c) => c.id),
+            embeddings: chunks.map((c) => c.embedding),
+            documents: chunks.map((c) => c.content),
+            metadatas: chunks.map((c) => c.metadata),
+        });
+    }
+    async deleteByPaths(_collectionName, _paths) {
+        // TODO: Implement actual ChromaDB delete by paths
+    }
+    async updateLastIndexAt(collectionName, timestamp) {
+        const collection = await this.client.getCollection({ name: collectionName });
+        const existingMeta = (collection.metadata || {});
+        await collection.modify({
+            metadata: {
+                ...existingMeta,
+                lastIndexAt: timestamp || new Date().toISOString(),
+            },
+        });
+    }
+}
+/**
+ * Stub implementation - replace with actual ChromaDB client.
+ */
+export const chromaDBAdapter = {
+    collectionExists: async (_collectionName) => {
+        // TODO: Implement actual ChromaDB collection check
+        return false;
+    },
+    queryChunks: async (_collectionName, _embedding, _limit, _filters) => {
+        // TODO: Implement actual ChromaDB query
+        return [];
+    },
+    getOrCreateCollection: async (_collectionName, _dimension) => {
+        // TODO: Implement actual ChromaDB collection creation
+    },
+    dropCollection: async (_collectionName) => {
+        // TODO: Implement actual ChromaDB collection deletion
+    },
+    getCollectionMeta: async (_collectionName) => {
+        // TODO: Implement actual ChromaDB collection metadata
+        return { count: 0, dimension: 384, lastIndexAt: null };
+    },
+    upsertChunks: async (_collectionName, _chunks) => {
+        // TODO: Implement actual ChromaDB upsert
+    },
+    deleteByPaths: async (_collectionName, _paths) => {
+        // TODO: Implement actual ChromaDB delete by paths
+    },
+    updateLastIndexAt: async (_collectionName) => {
+        // TODO: Implement actual ChromaDB last index timestamp update
+    },
+};
+//# sourceMappingURL=chroma.adapter.js.map

package/dist/infrastructure/vector-db/chroma.adapter.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,13 @@
+export interface TokenData {
+    token: string;
+    userId: string;
+    email: string;
+}
+/** Absolute path to the CLI config file — exported for use in test assertions and success messages. */
+export declare const CONFIG_PATH: string;
+/**
+ * Persists token, userId, and email to ~/.delfos/config.json.
+ * Delegates to writeConfig which handles mkdirSync and writeFileSync.
+ */
+export declare function storeToken(data: TokenData): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uGAAuG;AACvG,eAAO,MAAM,WAAW,QAAoD,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAEhD"}

package/dist/utils/config.js

@@ -0,0 +1,13 @@
+import { writeConfig } from '../config/cli-config.js';
+import * as os from 'node:os';
+import * as path from 'node:path';
+/** Absolute path to the CLI config file — exported for use in test assertions and success messages. */
+export const CONFIG_PATH = path.join(os.homedir(), '.delfos', 'config.json');
+/**
+ * Persists token, userId, and email to ~/.delfos/config.json.
+ * Delegates to writeConfig which handles mkdirSync and writeFileSync.
+ */
+export function storeToken(data) {
+    writeConfig({ token: data.token, userId: data.userId, email: data.email });
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC,uGAAuG;AACvG,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/utils/pkce.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Generates a PKCE code verifier: 32 random bytes encoded as URL-safe Base64.
+ * Output is 43 characters, within RFC 7636 range of 43–128 chars.
+ */
+export declare function generateCodeVerifier(): string;
+/**
+ * Derives the PKCE code challenge from a verifier using SHA-256.
+ * Returns URL-safe Base64 without '=' padding (RFC 4648 §5).
+ * This is synchronous — crypto.createHash is not async in Node.js.
+ */
+export declare function generateCodeChallenge(verifier: string): string;
+/**
+ * Generates a random state token for CSRF protection.
+ * Returns 32 hex characters (16 random bytes encoded as hex).
+ */
+export declare function generateState(): string;
+//# sourceMappingURL=pkce.d.ts.map

package/dist/utils/pkce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.d.ts","sourceRoot":"","sources":["../../src/utils/pkce.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/utils/pkce.js

@@ -0,0 +1,28 @@
+import * as crypto from 'node:crypto';
+/**
+ * Generates a PKCE code verifier: 32 random bytes encoded as URL-safe Base64.
+ * Output is 43 characters, within RFC 7636 range of 43–128 chars.
+ */
+export function generateCodeVerifier() {
+    return crypto.randomBytes(32).toString('base64url');
+}
+/**
+ * Derives the PKCE code challenge from a verifier using SHA-256.
+ * Returns URL-safe Base64 without '=' padding (RFC 4648 §5).
+ * This is synchronous — crypto.createHash is not async in Node.js.
+ */
+export function generateCodeChallenge(verifier) {
+    return crypto
+        .createHash('sha256')
+        .update(verifier)
+        .digest()
+        .toString('base64url');
+}
+/**
+ * Generates a random state token for CSRF protection.
+ * Returns 32 hex characters (16 random bytes encoded as hex).
+ */
+export function generateState() {
+    return crypto.randomBytes(16).toString('hex');
+}
+//# sourceMappingURL=pkce.js.map

package/dist/utils/pkce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.js","sourceRoot":"","sources":["../../src/utils/pkce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO,MAAM;SACV,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,QAAQ,CAAC;SAChB,MAAM,EAAE;SACR,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/utils/port.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Finds the first available TCP port starting at `startPort`.
+ * Probes up to 100 consecutive ports. Binds to 127.0.0.1 only (not 0.0.0.0).
+ * Rejects with an Error if no port is available in the range.
+ */
+export declare function findAvailablePort(startPort: number): Promise<number>;
+//# sourceMappingURL=port.d.ts.map

package/dist/utils/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/utils/port.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCpE"}

package/dist/utils/port.js

@@ -0,0 +1,33 @@
+import * as net from 'node:net';
+/**
+ * Finds the first available TCP port starting at `startPort`.
+ * Probes up to 100 consecutive ports. Binds to 127.0.0.1 only (not 0.0.0.0).
+ * Rejects with an Error if no port is available in the range.
+ */
+export function findAvailablePort(startPort) {
+    return new Promise((resolve, reject) => {
+        let attempt = 0;
+        function tryPort(port) {
+            if (attempt >= 100) {
+                reject(new Error(`No available port found in range ${startPort}–${startPort + 99}`));
+                return;
+            }
+            attempt++;
+            const server = net.createServer();
+            server.once('error', (err) => {
+                server.close();
+                if (err.code === 'EADDRINUSE') {
+                    tryPort(port + 1);
+                }
+                else {
+                    reject(err);
+                }
+            });
+            server.listen(port, '127.0.0.1', () => {
+                server.close(() => resolve(port));
+            });
+        }
+        tryPort(startPort);
+    });
+}
+//# sourceMappingURL=port.js.map

package/dist/utils/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/utils/port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,SAAS,OAAO,CAAC,IAAY;YAC3B,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;gBACnB,MAAM,CACJ,IAAI,KAAK,CACP,oCAAoC,SAAS,IAAI,SAAS,GAAG,EAAE,EAAE,CAClE,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,OAAO,EAAE,CAAC;YAEV,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;YAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;gBAClD,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC9B,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;gBACpC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC"}