septum 0.1.2 → 0.1.3

package/src/mcp/tools/locate-symbol.ts

@@ -1,5 +1,8 @@
+import { existsSync, readdirSync } from "node:fs";
+import { isAbsolute, join, basename } from "node:path";
 import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
 import type { SeptumRepository } from "../../core/database/repository.ts";
+import type { IngestionPipeline } from "../../core/ingestion/pipeline.ts";
 import {
   SymbolLocator,
   type SymbolLocationResult,
@@ -8,12 +11,15 @@ import {
 export interface LocateSymbolArgs {
   query: string;
   domain?: string;
+  workspace_path?: string;
 }
 
-export function handleLocateSymbol(
+export async function handleLocateSymbol(
   repo: SeptumRepository,
   config: ValidatedSeptumConfig,
-  args: LocateSymbolArgs
+  args: LocateSymbolArgs,
+  pipeline?: IngestionPipeline,
+  workspaceRoot?: string
 ) {
   if (!args.query) {
     throw new Error(
@@ -21,8 +27,79 @@ export function handleLocateSymbol(
     );
   }
 
+  const root = workspaceRoot || process.cwd();
+
+  // 1. Guarded Lazy Ingestion on Empty Catalog / Cold Start
+  if (repo.countFiles() === 0 && pipeline) {
+    try {
+      await pipeline.run(config);
+    } catch {
+      // Ingestion fallback
+    }
+
+    if (repo.countFiles() === 0) {
+      const diagnostic = {
+        status: "NOT_INDEXED",
+        found: false,
+        query: args.query,
+        message: `Workspace '${root}' belum terindeks dalam Septum catalog.`,
+        suggested_action: {
+          tool: "septum_register_domain",
+          params: { name: "core", root: "src", ingest_now: true },
+        },
+        agent_guidance:
+          "Panggil tool 'septum_register_domain(name: \"core\", root: \"src\", ingest_now: true)' untuk mendaftarkan dan mengindeks codebase ini, atau jalankan 'septum init' di terminal workspace.",
+      };
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(diagnostic, null, 2),
+          },
+        ],
+        metadata: diagnostic,
+      };
+    }
+  }
+
   const locator = new SymbolLocator(repo);
-  const result: SymbolLocationResult = locator.locate(args.query, args.domain);
+  let result: SymbolLocationResult = locator.locate(args.query, args.domain);
+
+  // 2. JIT Delta Sync: Check if located file has changed on disk since last ingest
+  if (result.found && result.file_path && pipeline) {
+    const fullPath = isAbsolute(result.file_path)
+      ? result.file_path
+      : join(root, result.file_path);
+    try {
+      const reindexed = await pipeline.ingestFile(fullPath, config);
+      if (reindexed) {
+        result = locator.locate(args.query, args.domain);
+      }
+    } catch {
+      // Silently fall back to existing result
+    }
+  }
+
+  // 3. Fallback on Cache Miss: Search for candidate source files matching the query terms
+  if (!result.found && pipeline) {
+    try {
+      const cleanTerm = args.query.replace(/[^a-zA-Z0-9_]/g, " ").trim().split(/\s+/)[0] || "";
+      if (cleanTerm.length >= 3) {
+        const candidateFiles = findCandidateFiles(root, cleanTerm);
+        let anyReindexed = false;
+        for (const candidate of candidateFiles) {
+          const reindexed = await pipeline.ingestFile(candidate, config);
+          if (reindexed) anyReindexed = true;
+        }
+        if (anyReindexed) {
+          result = locator.locate(args.query, args.domain);
+        }
+      }
+    } catch {
+      // Ignore candidate scan errors
+    }
+  }
 
   let formattedText = "";
 
@@ -72,3 +149,42 @@ export function handleLocateSymbol(
     metadata: result,
   };
 }
+
+/**
+ * Searches for potential candidate files whose names resemble parts of the query term.
+ */
+function findCandidateFiles(root: string, term: string): string[] {
+  const matched: string[] = [];
+  const lowerTerm = term.toLowerCase().replace(/_/g, "");
+  const searchDirs = ["src", "app", "lib"].map((d) => join(root, d)).filter((d) => existsSync(d));
+
+  function scan(dir: string, depth: number = 0) {
+    if (depth > 4) return;
+    try {
+      const entries = readdirSync(dir, { withFileTypes: true });
+      for (const e of entries) {
+        if (e.name.startsWith(".") || e.name === "node_modules" || e.name === "dist") continue;
+        const full = join(dir, e.name);
+        if (e.isDirectory()) {
+          scan(full, depth + 1);
+        } else if (e.isFile() && /\.(ts|tsx|js|jsx|php|py|go)$/i.test(e.name)) {
+          const lowerName = e.name.toLowerCase().replace(/[-_.]/g, "");
+          if (lowerName.includes(lowerTerm) || lowerTerm.includes(lowerName.replace(/\.[^.]+$/, ""))) {
+            matched.push(full);
+            if (matched.length >= 5) return;
+          }
+        }
+      }
+    } catch {
+      // Ignore
+    }
+  }
+
+  for (const sDir of searchDirs) {
+    scan(sDir);
+    if (matched.length >= 5) break;
+  }
+
+  return matched;
+}
+

package/src/mcp/tools/trace-vertical-slice.ts

@@ -18,7 +18,8 @@ export function handleTraceVerticalSlice(
     );
   }
 
-  const tracer = new VerticalSliceTracer(repo);
+  const workspaceRoot = (config.settings as Record<string, unknown>)?.workspace_root as string || process.cwd();
+  const tracer = new VerticalSliceTracer(repo, workspaceRoot);
   const result: VerticalSliceTraceResponse = tracer.trace(args.query);
 
   let formattedText = "";

package/src/types/index.ts

@@ -13,6 +13,7 @@ export type ArchetypeKind =
   | "request"
   | "resource"
   | "util"
+  | "view"
   | "unknown";
 
 export type SymbolKind =
@@ -23,7 +24,9 @@ export type SymbolKind =
   | "method"
   | "function"
   | "type"
-  | "property";
+  | "property"
+  | "component"
+  | "view";
 
 export type Visibility = "public" | "protected" | "private";