septum 0.1.2 → 0.1.4

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/register-domain.ts

@@ -22,7 +22,7 @@ export async function handleRegisterDomain(
     throw new Error("Missing required arguments: 'name' and 'root' are required.");
   }
 
-  const domainConfig: DomainConfig = {
+  const domainConfig = {
     root: args.root,
     description: args.description || `Domain: ${args.name}`,
     allowed_dependencies: args.allowed_dependencies || [],

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

@@ -18,75 +18,21 @@ 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 = "";
+  let formattedText = result.message;
 
-  if (result.found && result.slice) {
-    const s = result.slice;
-    formattedText = `=== VERTICAL SLICE TRACE ===\n`;
-    formattedText += `Query: ${result.query}\n`;
-    formattedText += `Status: RESOLVED\n\n`;
-
-    formattedText += `• Route:\n`;
-    formattedText += `    Method: ${s.route.method}\n`;
-    formattedText += `    URI:    ${s.route.uri}\n`;
-    if (s.route.name) {
-      formattedText += `    Name:   ${s.route.name}\n`;
-    }
-
-    if (s.request) {
-      formattedText += `\n• Request / Validation:\n`;
-      formattedText += `    Class:  ${s.request.class} (${s.request.file || "inline"})\n`;
-      const ruleKeys = Object.keys(s.request.rules);
-      if (ruleKeys.length > 0) {
-        formattedText += `    Rules:\n`;
-        for (const k of ruleKeys) {
-          formattedText += `      - ${k} => ${s.request.rules[k]}\n`;
-        }
-      }
-    }
-
-    formattedText += `\n• Controller Action:\n`;
-    formattedText += `    Class:  ${s.controller.class}@${s.controller.action}\n`;
-    formattedText += `    File:   ${s.controller.file || "unknown"}:${s.controller.line}\n`;
-
-    if (s.model) {
-      formattedText += `\n• Model:\n`;
-      formattedText += `    Class:  ${s.model.class} (${s.model.file || "unknown"})\n`;
-      if (s.model.fillable && s.model.fillable.length > 0) {
-        formattedText += `    Fillable: [${s.model.fillable.join(", ")}]\n`;
-      }
-      if (s.model.casts && Object.keys(s.model.casts).length > 0) {
-        formattedText += `    Casts:    ${JSON.stringify(s.model.casts)}\n`;
-      }
+  if (result.found && result.alternatives && result.alternatives.length > 0) {
+    formattedText += `\n\n• Other Matching Slices:\n`;
+    for (const alt of result.alternatives) {
+      formattedText += `    - ${alt.method} ${alt.uri} -> ${alt.controller}@${alt.action}\n`;
     }
-
-    if (s.frontend) {
-      formattedText += `\n• Frontend Target:\n`;
-      formattedText += `    Page:   ${s.frontend.target}\n`;
-      if (s.frontend.props.length > 0) {
-        formattedText += `    Props:  [${s.frontend.props.join(", ")}]\n`;
-      }
-    }
-
-    if (result.alternatives && result.alternatives.length > 0) {
-      formattedText += `\n• Other Matching Slices:\n`;
-      for (const alt of result.alternatives) {
-        formattedText += `    - ${alt.method} ${alt.uri} -> ${alt.controller}@${alt.action}\n`;
-      }
-    }
-  } else {
-    formattedText = `=== VERTICAL SLICE NOT FOUND ===\n`;
-    formattedText += `Query: ${result.query}\n`;
-    formattedText += `Message: ${result.message}\n`;
-
-    if (result.alternatives && result.alternatives.length > 0) {
-      formattedText += `\nAvailable Slices:\n`;
-      for (const alt of result.alternatives) {
-        formattedText += `    - ${alt.method} ${alt.uri} -> ${alt.controller}@${alt.action}\n`;
-      }
+  } else if (!result.found && result.alternatives && result.alternatives.length > 0) {
+    formattedText += `\n\nAvailable Slices:\n`;
+    for (const alt of result.alternatives) {
+      formattedText += `    - ${alt.method} ${alt.uri} -> ${alt.controller}@${alt.action}\n`;
     }
   }
 

package/src/types/index.ts

@@ -12,7 +12,9 @@ export type ArchetypeKind =
   | "middleware"
   | "request"
   | "resource"
+  | "route"
   | "util"
+  | "view"
   | "unknown";
 
 export type SymbolKind =
@@ -23,7 +25,9 @@ export type SymbolKind =
   | "method"
   | "function"
   | "type"
-  | "property";
+  | "property"
+  | "component"
+  | "view";
 
 export type Visibility = "public" | "protected" | "private";
 
@@ -120,6 +124,7 @@ export interface SymbolRecord {
   line_start: number;
   line_end: number;
   line_count: number;
+  nesting_depth: number;
 }
 
 export interface DependencyRecord {
@@ -139,6 +144,7 @@ export interface ExtractedSymbol {
   line_start: number;
   line_end: number;
   line_count: number;
+  nesting_depth?: number;
 }
 
 export interface ExtractedDependency {
@@ -190,12 +196,17 @@ export interface DomainCatalogResponse {
 export interface ExecutionChainNode {
   stage:
     | "ingress"
+    | "guard"
     | "validation"
     | "controller"
     | "orchestrator"
     | "use_case"
     | "domain"
     | "entity"
+    | "side_effect"
+    | "job"
+    | "event"
+    | "transaction"
     | "egress"
     | "repository"
     | string;
@@ -203,6 +214,14 @@ export interface ExecutionChainNode {
   file?: string;
   line?: number;
   description?: string;
+  table?: string;
+  schema_file?: string;
+  columns_summary?: string;
+  guards?: string[];
+  mutations?: string[];
+  emits?: string[];
+  dispatches?: string[];
+  transactions?: boolean;
 }
 
 export interface VerticalSliceRecord {

package/src/version.ts

@@ -1,3 +1,3 @@
-import packageJson from "../package.json" with { type: "json" };
-
-export const SEPTUM_VERSION: string = packageJson.version;
+import packageJson from "../package.json" with { type: "json" };
+
+export const SEPTUM_VERSION: string = packageJson.version;