@vfarcic/dot-ai 1.0.3 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
   "mcpName": "io.github.vfarcic/dot-ai",
   "main": "dist/index.js",
@@ -84,16 +84,22 @@
     "LICENSE"
   ],
   "devDependencies": {
+    "better-npm-audit": "^3.11.0",
+    "@eslint/js": "^9.39.2",
     "@types/glob": "^9.0.0",
     "@types/handlebars": "^4.0.40",
     "@types/node": "^22.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
     "@vitest/ui": "^3.2.4",
-    "eslint": "^8.0.0",
+    "eslint": "^9.39.2",
+    "globals": "^17.2.0",
     "prettier": "^3.0.0",
     "ts-node": "^10.9.0",
     "typescript": "^5.0.0",
+    "typescript-eslint": "^8.54.0",
+    "uuid": "^13.0.0",
     "vitest": "^3.2.4"
   },
   "dependencies": {
@@ -103,7 +109,7 @@
     "@ai-sdk/openai": "^2.0.42",
     "@ai-sdk/xai": "^2.0.26",
     "@kubernetes/client-node": "^1.3.0",
-    "@modelcontextprotocol/sdk": "^1.13.2",
+    "@modelcontextprotocol/sdk": "1.25.3",
     "@openrouter/ai-sdk-provider": "^1.2.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.207.0",

package/prompts/knowledge-ask.md

@@ -0,0 +1,29 @@
+# Knowledge Base Question Answering Agent
+
+You are a knowledge assistant that answers questions using an organization's knowledge base, supplemented by your general knowledge when helpful.
+
+## Strategy
+
+1. **Search first**: Always search the knowledge base before answering.
+
+2. **Multiple searches for multi-topic questions**: If the question spans different topics, make separate searches for each topic.
+
+3. **Know when to stop**: Once you have sufficient information, stop searching and answer.
+
+## Answering Guidelines
+
+1. **Knowledge base is authoritative**: For organization-specific information (processes, configurations, policies), use only what you find in the knowledge base.
+
+2. **Supplement with general knowledge**: You may add general technical context from your own knowledge to make answers more helpful and complete.
+
+3. **Be direct**: Start with a direct answer. Avoid preambles.
+
+4. **Synthesize coherently**: Combine information into a clear, organized answer.
+
+5. **Handle missing information**: If the knowledge base doesn't cover the topic, say so - but you can still provide general guidance if applicable.
+
+6. **Be concise but complete**: Provide focused answers with relevant details.
+
+## Response Format
+
+Provide your answer as plain text. The system will automatically include the source documents you referenced.

package/dist/core/vector-db-service.d.ts

@@ -1,108 +0,0 @@
-/**
- * Vector DB Service
- *
- * Handles Qdrant Vector Database integration for semantic search and storage
- */
-export interface VectorDBConfig {
-    url?: string;
-    apiKey?: string;
-    collectionName?: string;
-}
-export interface VectorDocument {
-    id: string;
-    payload: Record<string, any>;
-    vector?: number[];
-}
-export interface SearchResult {
-    id: string;
-    score: number;
-    payload: Record<string, any>;
-}
-export interface SearchOptions {
-    limit?: number;
-    scoreThreshold?: number;
-    filter?: Record<string, any>;
-}
-export declare class VectorDBService {
-    private client;
-    private config;
-    private collectionName;
-    constructor(config?: VectorDBConfig);
-    private validateConfig;
-    private shouldInitializeClient;
-    /**
-     * Check if collection exists without creating it
-     */
-    collectionExists(): Promise<boolean>;
-    /**
-     * Initialize the collection if it doesn't exist
-     */
-    initializeCollection(vectorSize?: number): Promise<void>;
-    /**
-     * Create collection with specified vector size
-     * Handles conflict errors gracefully (collection already exists from race condition or restart)
-     */
-    private createCollection;
-    /**
-     * Ensure text index exists on searchText field for efficient keyword search
-     * This is idempotent - safe to call multiple times
-     */
-    private ensureTextIndex;
-    /**
-     * Store a document with optional vector
-     */
-    upsertDocument(document: VectorDocument): Promise<void>;
-    /**
-     * Search for similar documents using vector similarity
-     */
-    searchSimilar(vector: number[], options?: SearchOptions): Promise<SearchResult[]>;
-    /**
-     * Search for documents using payload filtering (keyword search)
-     * Uses Qdrant's native text index for efficient server-side filtering
-     */
-    searchByKeywords(keywords: string[], options?: SearchOptions): Promise<SearchResult[]>;
-    /**
-     * Get a document by ID
-     */
-    getDocument(id: string): Promise<VectorDocument | null>;
-    /**
-     * Delete a document by ID
-     */
-    deleteDocument(id: string): Promise<void>;
-    /**
-     * Delete all documents by clearing all points from the collection
-     * More efficient than retrieving and deleting individual records
-     * Collection structure is preserved, avoiding Qdrant storage cleanup issues
-     */
-    deleteAllDocuments(): Promise<void>;
-    /**
-     * Scroll documents with Qdrant filter
-     * @param filter - Qdrant filter object (must/should/must_not conditions)
-     * @param limit - Maximum documents to retrieve
-     * Uses semaphore to limit concurrent Qdrant operations
-     */
-    scrollWithFilter(filter: any, limit?: number): Promise<VectorDocument[]>;
-    /**
-     * Get all documents (for listing)
-     * @param limit - Maximum number of documents to retrieve. Defaults to unlimited (10000).
-     * Uses semaphore to limit concurrent Qdrant operations
-     */
-    getAllDocuments(limit?: number): Promise<VectorDocument[]>;
-    /**
-     * Get collection info and statistics
-     */
-    getCollectionInfo(): Promise<any>;
-    /**
-     * Check if Vector DB is available and responsive
-     */
-    healthCheck(): Promise<boolean>;
-    /**
-     * Check if client is initialized
-     */
-    isInitialized(): boolean;
-    /**
-     * Get configuration (for debugging)
-     */
-    getConfig(): VectorDBConfig;
-}
-//# sourceMappingURL=vector-db-service.d.ts.map

package/dist/core/vector-db-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vector-db-service.d.ts","sourceRoot":"","sources":["../../src/core/vector-db-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgDH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,GAAE,cAAmB;IAuBvC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,sBAAsB;IAM9B;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAa1C;;OAEG;IACG,oBAAoB,CAAC,UAAU,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDnE;;;OAGG;YACW,gBAAgB;IAmC9B;;;OAGG;YACW,eAAe;IAwC7B;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC7D;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAuC1B;;;OAGG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IA8H1B;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqC7D;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/C;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCzC;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAuCnF;;;;OAIG;IACG,eAAe,CAAC,KAAK,GAAE,MAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgDvE;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC;IAqBvC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAsBrC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,cAAc;CAG5B"}