voyageai-cli 1.30.1 → 1.30.2

package/src/workflows/code-review.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://vai.dev/schemas/workflow-v1.json",
+  "name": "Code Review Assistant",
+  "description": "Index a codebase, find similar patterns, and surface related code for review. Paste a code snippet and get context from across the project — similar implementations, related functions, and architectural patterns.",
+  "version": "1.0.0",
+  "branding": {
+    "icon": "code",
+    "color": "#06B6D4"
+  },
+  "inputs": {
+    "source": {
+      "type": "string",
+      "description": "Local directory path or GitHub repo URL to analyze",
+      "required": true
+    },
+    "code": {
+      "type": "string",
+      "description": "Code snippet to review — finds similar patterns and related implementations",
+      "required": true
+    },
+    "question": {
+      "type": "string",
+      "description": "Optional question about the code (e.g., 'are there any other retry implementations?')",
+      "default": ""
+    },
+    "language": {
+      "type": "string",
+      "description": "Filter results to a specific language (e.g., 'js', 'py', 'go')"
+    },
+    "limit": {
+      "type": "number",
+      "description": "Maximum results per search step",
+      "default": 5
+    }
+  },
+  "defaults": {
+    "db": "vai_code_search"
+  },
+  "steps": [
+    {
+      "id": "check_index",
+      "name": "Check if codebase is already indexed",
+      "tool": "code_status",
+      "inputs": {
+        "db": "{{ defaults.db }}"
+      }
+    },
+    {
+      "id": "index_codebase",
+      "name": "Index codebase (skip if already indexed and fresh)",
+      "tool": "code_index",
+      "inputs": {
+        "source": "{{ inputs.source }}",
+        "db": "{{ defaults.db }}",
+        "refresh": true
+      },
+      "condition": "{{ !check_index.output || check_index.output.totalChunks === 0 }}"
+    },
+    {
+      "id": "find_similar",
+      "name": "Find similar code patterns across the codebase",
+      "tool": "code_find_similar",
+      "inputs": {
+        "code": "{{ inputs.code }}",
+        "db": "{{ defaults.db }}",
+        "collection": "{{ index_codebase.output.collection || check_index.output.collection }}",
+        "limit": "{{ inputs.limit }}",
+        "language": "{{ inputs.language }}",
+        "threshold": 0.4
+      }
+    },
+    {
+      "id": "contextual_search",
+      "name": "Search for related architectural context",
+      "tool": "code_search",
+      "inputs": {
+        "query": "{{ inputs.question || 'functions and modules related to: ' + inputs.code }}",
+        "db": "{{ defaults.db }}",
+        "collection": "{{ index_codebase.output.collection || check_index.output.collection }}",
+        "limit": "{{ inputs.limit }}",
+        "language": "{{ inputs.language }}",
+        "rerank": true
+      }
+    },
+    {
+      "id": "deep_query",
+      "name": "Answer specific question about the code",
+      "tool": "code_query",
+      "inputs": {
+        "query": "{{ inputs.question }}",
+        "db": "{{ defaults.db }}",
+        "collection": "{{ index_codebase.output.collection || check_index.output.collection }}",
+        "limit": 3,
+        "language": "{{ inputs.language }}"
+      },
+      "condition": "{{ inputs.question && inputs.question.length > 0 }}"
+    }
+  ],
+  "output": {
+    "similarPatterns": "{{ find_similar.output.results }}",
+    "similarCount": "{{ find_similar.output.metadata.resultCount }}",
+    "relatedCode": "{{ contextual_search.output.results }}",
+    "relatedCount": "{{ contextual_search.output.metadata.resultCount }}",
+    "answer": "{{ deep_query.output.results }}",
+    "indexStatus": {
+      "totalFiles": "{{ check_index.output.uniqueFiles || index_codebase.output.filesIndexed }}",
+      "totalChunks": "{{ check_index.output.totalChunks || index_codebase.output.chunksCreated }}"
+    }
+  }
+}

package/src/workflows/cost-analysis.json

@@ -69,5 +69,10 @@
     "docs": "{{ inputs.docs }}",
     "queriesPerMonth": "{{ inputs.queries }}",
     "months": "{{ inputs.months }}"
+  },
+  "formatters": {
+    "default": "table",
+    "title": "Cost Analysis",
+    "arrayField": "comparison"
   }
 }

package/src/workflows/tests/code-review.fresh-index.test.json

@@ -0,0 +1,83 @@
+{
+  "name": "code-review: fresh index required (no existing index)",
+  "inputs": {
+    "source": "https://github.com/mrlynn/voyageai-cli",
+    "code": "function generateEmbeddings(texts, model) { ... }",
+    "limit": 5
+  },
+  "mocks": {
+    "code_status": {
+      "totalChunks": 0,
+      "uniqueFiles": 0,
+      "languages": {},
+      "lastIndexed": null,
+      "indexes": []
+    },
+    "code_index": {
+      "source": "https://github.com/mrlynn/voyageai-cli",
+      "sourceType": "github",
+      "db": "vai_code_search",
+      "collection": "voyageai_cli_code",
+      "model": "voyage-code-3",
+      "filesFound": 89,
+      "filesIndexed": 89,
+      "chunksCreated": 642,
+      "totalTokens": 185000,
+      "errors": [],
+      "timeMs": 8400,
+      "refresh": true,
+      "indexName": "code_search_index"
+    },
+    "code_find_similar": {
+      "results": [
+        {
+          "source": "src/lib/api.js",
+          "language": "js",
+          "startLine": 45,
+          "endLine": 78,
+          "symbols": ["generateEmbeddings", "batchEmbed"],
+          "content": "async function generateEmbeddings(texts, model, opts) { ... }",
+          "score": 0.962,
+          "chunkType": "boundary"
+        }
+      ],
+      "metadata": {
+        "collection": "voyageai_cli_code",
+        "model": "voyage-code-3",
+        "resultCount": 1,
+        "timeMs": 145
+      }
+    },
+    "code_search": {
+      "results": [
+        {
+          "source": "src/lib/api.js",
+          "language": "js",
+          "startLine": 1,
+          "endLine": 30,
+          "symbols": ["apiRequest", "BASE_URL"],
+          "content": "const BASE_URL = process.env.VOYAGE_API_URL || 'https://ai.mongodb.com/v1/'; ...",
+          "score": 0.834
+        }
+      ],
+      "metadata": {
+        "collection": "voyageai_cli_code",
+        "model": "voyage-code-3",
+        "reranked": true,
+        "resultCount": 1,
+        "timeMs": 210
+      }
+    },
+    "code_query": null
+  },
+  "expect": {
+    "steps": {
+      "check_index": { "status": "completed" },
+      "index_codebase": { "status": "completed" },
+      "find_similar": { "status": "completed" },
+      "contextual_search": { "status": "completed" },
+      "deep_query": { "status": "skipped" }
+    },
+    "noErrors": true
+  }
+}

package/src/workflows/tests/code-review.happy-path.test.json

@@ -0,0 +1,121 @@
+{
+  "name": "code-review: find similar patterns with contextual search",
+  "inputs": {
+    "source": "/Users/dev/myapp",
+    "code": "async function retryWithBackoff(fn, maxRetries = 3) {\n  for (let i = 0; i < maxRetries; i++) {\n    try { return await fn(); }\n    catch (e) { if (i === maxRetries - 1) throw e; await sleep(Math.pow(2, i) * 1000); }\n  }\n}",
+    "question": "are there other retry or backoff implementations?",
+    "language": "js",
+    "limit": 5
+  },
+  "mocks": {
+    "code_status": {
+      "totalChunks": 1823,
+      "uniqueFiles": 247,
+      "collection": "myapp_code",
+      "languages": { "js": 180, "ts": 45, "json": 22 },
+      "lastIndexed": "2026-02-16T12:00:00.000Z",
+      "indexes": [{ "name": "code_search_index", "status": "READY" }]
+    },
+    "code_index": null,
+    "code_find_similar": {
+      "results": [
+        {
+          "source": "src/lib/http-client.js",
+          "language": "js",
+          "startLine": 88,
+          "endLine": 112,
+          "symbols": ["retryRequest", "exponentialDelay"],
+          "content": "async function retryRequest(url, opts, retries = 5) {\n  const exponentialDelay = (attempt) => Math.pow(2, attempt) * 500;\n  for (let attempt = 0; attempt < retries; attempt++) { ... }",
+          "score": 0.921,
+          "chunkType": "boundary"
+        },
+        {
+          "source": "src/lib/queue.js",
+          "language": "js",
+          "startLine": 34,
+          "endLine": 58,
+          "symbols": ["processWithRetry"],
+          "content": "async function processWithRetry(task, { maxAttempts = 3, backoff = 'exponential' }) { ... }",
+          "score": 0.867,
+          "chunkType": "boundary"
+        },
+        {
+          "source": "src/utils/resilience.js",
+          "language": "js",
+          "startLine": 1,
+          "endLine": 30,
+          "symbols": ["circuitBreaker", "withTimeout"],
+          "content": "function circuitBreaker(fn, { threshold = 5, resetMs = 30000 }) { ... }",
+          "score": 0.743,
+          "chunkType": "boundary"
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "resultCount": 3,
+        "timeMs": 187
+      }
+    },
+    "code_search": {
+      "results": [
+        {
+          "source": "src/lib/http-client.js",
+          "language": "js",
+          "startLine": 1,
+          "endLine": 25,
+          "symbols": ["createClient", "DEFAULT_TIMEOUT"],
+          "content": "const DEFAULT_TIMEOUT = 30000;\nfunction createClient(baseUrl, opts) { ... }",
+          "score": 0.856
+        },
+        {
+          "source": "docs/resilience.md",
+          "language": "md",
+          "startLine": 1,
+          "endLine": 40,
+          "symbols": [],
+          "content": "# Resilience Patterns\n\nThis project uses exponential backoff with jitter for all HTTP retries...",
+          "score": 0.812
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "rerankModel": "rerank-2.5",
+        "reranked": true,
+        "resultCount": 2,
+        "timeMs": 234
+      }
+    },
+    "code_query": {
+      "results": [
+        {
+          "source": "src/lib/http-client.js",
+          "language": "js",
+          "startLine": 88,
+          "endLine": 112,
+          "symbols": ["retryRequest", "exponentialDelay"],
+          "content": "async function retryRequest(url, opts, retries = 5) { ... }",
+          "score": 0.943
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "reranked": true,
+        "resultCount": 1,
+        "timeMs": 198
+      }
+    }
+  },
+  "expect": {
+    "steps": {
+      "check_index": { "status": "completed" },
+      "index_codebase": { "status": "skipped" },
+      "find_similar": { "status": "completed" },
+      "contextual_search": { "status": "completed" },
+      "deep_query": { "status": "completed" }
+    },
+    "noErrors": true
+  }
+}

package/src/workflows/tests/code-review.no-question.test.json

@@ -0,0 +1,70 @@
+{
+  "name": "code-review: no question — skip deep_query, auto-generate search from snippet",
+  "inputs": {
+    "source": "/Users/dev/myapp",
+    "code": "class DatabasePool {\n  constructor(uri, { maxSize = 10, idleTimeoutMs = 30000 }) {\n    this.pool = [];\n    this.maxSize = maxSize;\n  }\n  async acquire() { ... }\n  release(conn) { ... }\n}",
+    "limit": 3
+  },
+  "mocks": {
+    "code_status": {
+      "totalChunks": 500,
+      "uniqueFiles": 80,
+      "collection": "myapp_code",
+      "languages": { "js": 60, "ts": 20 },
+      "lastIndexed": "2026-02-16T10:00:00.000Z",
+      "indexes": [{ "name": "code_search_index", "status": "READY" }]
+    },
+    "code_index": null,
+    "code_find_similar": {
+      "results": [
+        {
+          "source": "src/lib/redis-pool.js",
+          "language": "js",
+          "startLine": 5,
+          "endLine": 45,
+          "symbols": ["RedisPool", "acquire", "release"],
+          "content": "class RedisPool { constructor(opts) { ... } async acquire() { ... } }",
+          "score": 0.889,
+          "chunkType": "boundary"
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "resultCount": 1,
+        "timeMs": 156
+      }
+    },
+    "code_search": {
+      "results": [
+        {
+          "source": "src/lib/mongo.js",
+          "language": "js",
+          "startLine": 12,
+          "endLine": 50,
+          "symbols": ["getMongoCollection", "closeClient"],
+          "content": "async function getMongoCollection(db, collection) { ... }",
+          "score": 0.801
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "reranked": true,
+        "resultCount": 1,
+        "timeMs": 189
+      }
+    },
+    "code_query": null
+  },
+  "expect": {
+    "steps": {
+      "check_index": { "status": "completed" },
+      "index_codebase": { "status": "skipped" },
+      "find_similar": { "status": "completed" },
+      "contextual_search": { "status": "completed" },
+      "deep_query": { "status": "skipped" }
+    },
+    "noErrors": true
+  }
+}

package/src/workflows/tests/smart-ingest.duplicate-detected.test.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-ingest: duplicate detected (high similarity)",
-  "description": "NOTE: Due to a known dependency extraction issue with negated conditions (!similarity_check), the ingest_doc step's condition cannot properly wait for similarity_check. The !prefix prevents dependency tracking, so ingest_doc runs in parallel with check_existing. The condition evaluates with similarity_check.output as undefined, making !undefined = true, so ingest_doc always executes. This test validates actual engine behavior.",
+  "description": "When a near-duplicate is found (similarity above 0.85), the ingest_doc step is correctly skipped to avoid ingesting duplicate content.",
   "inputs": {
     "text": "A document that already exists in the knowledge base",
     "source": "existing-doc.md",
@@ -27,7 +27,7 @@
     "steps": {
       "check_existing": { "status": "completed" },
       "similarity_check": { "status": "completed" },
-      "ingest_doc": { "status": "completed" }
+      "ingest_doc": { "status": "skipped" }
     },
     "noErrors": true
   }