@harivatsa/sirius-mcp-proxy 0.1.0 → 0.1.2

package/README.md

@@ -10,6 +10,12 @@ npm install -g @harivatsa/sirius-mcp-proxy
 
 Point Claude at `sirius-mcp-proxy` after configuring the Sirius index URL, repo-agent URL, and token environment variables described in the root README.
 
+Use `index_repo` from Claude/MCP to register a local repo path with the always-on repo-agent and start
+indexing. Use `list_local_repos` to inspect repos known to the local agent. After that,
+`semantic_code_search`, `hybrid_search`, `symbol_search`, `get_call_chain`, `impact_analysis`,
+`ripgrep_search`, `sync_repo`, and `sync_status` operate through the repo-agent and index server.
+Pass `reset=true` to `index_repo` or `sync_repo` when you need to purge and rebuild a polluted index.
+
 Snippet enrichment is bounded by `SIRIUS_MCP_ENRICH_CONCURRENCY`, which defaults to `16` and caps at `50`, matching the MCP tool `top_k` limit. Normal `top_k <= 16` searches fetch snippets in one wave; larger windows avoid unbounded local file-range fan-out.
 
 `semantic_code_search`, `hybrid_search`, `symbol_search`, `get_call_chain`, and `impact_analysis` compare indexed file hashes with local snippet hashes when `include_code=true`. With `auto_sync_stale=true`, stale snippets trigger one local repo-agent sync and then rerun the lookup.

package/dist/index.js

@@ -6,9 +6,9 @@ import { enrichGraphNodes, enrichSearchResults, enrichSymbols } from "./enrich.j
 import { agentGet, agentPost, indexDelete, indexGet, indexPost } from "./http.js";
 import { impactAnalysisWithOptionalStaleSync } from "./impact.js";
 import { hasStaleSnippet, searchWithOptionalStaleSync } from "./search.js";
-import { localFilePathSchema, publicRepoIdSchema } from "./validation.js";
+import { localFilePathSchema, localRepoPathSchema, publicRepoIdSchema } from "./validation.js";
 // General rule: package-installed CLIs need a no-session self-check path for install validation.
-const MCP_PROXY_VERSION = "0.1.0";
+const MCP_PROXY_VERSION = "0.1.2";
 // General rule: expanded call graphs can include many nodes, while source snippets dominate MCP payload size.
 const DEFAULT_CALL_CHAIN_CODE_NODE_LIMIT = 50;
 // General rule: graph snippet enrichment should stay bounded by the largest accepted call-chain graph window.
@@ -24,6 +24,40 @@ const server = new McpServer({
     name: "sirius-mcp",
     version: MCP_PROXY_VERSION
 });
+server.registerTool("index_repo", {
+    title: "Index Repo",
+    description: "Register a local repository with the repo agent and start indexing it on the Sirius server.",
+    inputSchema: {
+        repo_path: localRepoPathSchema,
+        repo_id: publicRepoIdSchema.optional(),
+        share_mode: z.enum(["personal", "group"]).default("personal"),
+        remote: z.string().min(1).default("origin"),
+        shared_ref: z.string().optional(),
+        sync: z.boolean().default(true),
+        full: z.boolean().default(false),
+        reset: z.boolean().default(false)
+    }
+}, async ({ repo_path, repo_id, share_mode, remote, shared_ref, sync, full, reset }) => {
+    const response = await agentPost("/repos/register", {
+        repo_path,
+        repo_id,
+        share_mode,
+        remote,
+        shared_ref,
+        sync,
+        full,
+        reset
+    });
+    return asJson(response);
+});
+server.registerTool("list_local_repos", {
+    title: "List Local Repos",
+    description: "List repositories registered with the local Sirius repo agent.",
+    inputSchema: {}
+}, async () => {
+    const response = await agentGet("/repos");
+    return asJson(response);
+});
 server.registerTool("semantic_code_search", {
     title: "Semantic Code Search",
     description: "Find relevant code by meaning using the Sirius index, optionally returning local snippets.",
@@ -201,10 +235,11 @@ server.registerTool("sync_repo", {
     description: "Trigger a manual incremental or full sync through the local repo agent.",
     inputSchema: {
         repo_id: publicRepoIdSchema,
-        full: z.boolean().default(false)
+        full: z.boolean().default(false),
+        reset: z.boolean().default(false)
     }
-}, async ({ repo_id, full }) => {
-    const response = await agentPost(`/repos/${encodeURIComponent(repo_id)}/sync`, { full });
+}, async ({ repo_id, full, reset }) => {
+    const response = await agentPost(`/repos/${encodeURIComponent(repo_id)}/sync`, { full, reset });
     return asJson(response);
 });
 server.registerTool("sync_status", {

package/dist/validation.js

@@ -3,10 +3,13 @@ import { z } from "zod";
 const PUBLIC_REPO_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
 // General rule: local file reads must use normalized repo-relative slash paths.
 const WINDOWS_DRIVE_PATH_PATTERN = /^[A-Za-z]:/;
+const WINDOWS_ABSOLUTE_PATH_PATTERN = /^[A-Za-z]:[\\/]/;
 export const PUBLIC_REPO_ID_RULE = "use 1-128 ASCII letters, digits, dots, underscores, or hyphens, starting with a letter or digit";
 export const LOCAL_FILE_PATH_RULE = "file_path must be a relative path inside the repo";
+export const LOCAL_REPO_PATH_RULE = "repo_path must be an absolute local filesystem path";
 export const publicRepoIdSchema = z.string().regex(PUBLIC_REPO_ID_PATTERN, PUBLIC_REPO_ID_RULE);
 export const localFilePathSchema = z.string().refine(isSafeLocalFilePath, LOCAL_FILE_PATH_RULE);
+export const localRepoPathSchema = z.string().min(1).refine(isAbsoluteLocalPath, LOCAL_REPO_PATH_RULE);
 export function isSafeLocalFilePath(filePath) {
     if (!filePath ||
         filePath.includes("\0") ||
@@ -17,3 +20,6 @@ export function isSafeLocalFilePath(filePath) {
     }
     return filePath.split("/").every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
 }
+export function isAbsoluteLocalPath(filePath) {
+    return filePath.startsWith("/") || WINDOWS_ABSOLUTE_PATH_PATTERN.test(filePath);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harivatsa/sirius-mcp-proxy",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP proxy that joins Sirius index metadata with local source snippets.",
   "license": "UNLICENSED",
   "type": "module",