septum 0.1.0 → 0.1.2

package/src/core/parser/boundary-tracker.ts

@@ -1,128 +1,128 @@
-/**
- * Utility to find the end line (1-based index) of a code block.
- * Handles brace matching with string and comment awareness for C-like languages (TS, JS, PHP, Go).
- */
-export function findBraceBlockEnd(lines: string[], startLineIndex: number): number {
-  let depth = 0;
-  let hasOpened = false;
-  let inMultiLineComment = false;
-
-  for (let i = startLineIndex; i < lines.length; i++) {
-    const line = lines[i];
-    let inSingleQuote = false;
-    let inDoubleQuote = false;
-    let inTemplateString = false;
-
-    for (let j = 0; j < line.length; j++) {
-      const char = line[j];
-      const prevChar = j > 0 ? line[j - 1] : "";
-      const nextChar = j + 1 < line.length ? line[j + 1] : "";
-
-      // Multi-line comment boundary
-      if (inMultiLineComment) {
-        if (char === "*" && nextChar === "/") {
-          inMultiLineComment = false;
-          j++; // skip '/'
-        }
-        continue;
-      }
-
-      // Check start of multi-line comment /*
-      if (!inSingleQuote && !inDoubleQuote && !inTemplateString && char === "/" && nextChar === "*") {
-        inMultiLineComment = true;
-        j++;
-        continue;
-      }
-
-      // Check single-line comment //
-      if (!inSingleQuote && !inDoubleQuote && !inTemplateString && char === "/" && nextChar === "/") {
-        break; // ignore rest of line
-      }
-
-      // String quote handling (with escape character check)
-      if (char === "'" && !inDoubleQuote && !inTemplateString && prevChar !== "\\") {
-        inSingleQuote = !inSingleQuote;
-        continue;
-      }
-      if (char === '"' && !inSingleQuote && !inTemplateString && prevChar !== "\\") {
-        inDoubleQuote = !inDoubleQuote;
-        continue;
-      }
-      if (char === "`" && !inSingleQuote && !inDoubleQuote && prevChar !== "\\") {
-        inTemplateString = !inTemplateString;
-        continue;
-      }
-
-      if (inSingleQuote || inDoubleQuote || inTemplateString) {
-        continue;
-      }
-
-      // Brace tracking
-      if (char === "{") {
-        depth++;
-        hasOpened = true;
-      } else if (char === "}") {
-        if (hasOpened) {
-          depth--;
-          if (depth === 0) {
-            return i + 1; // 1-based line number
-          }
-        }
-      }
-    }
-
-    // Safety guard: If we haven't seen an opening brace within 40 lines or hit a declaration-only statement
-    if (!hasOpened) {
-      const trimmed = line.trim();
-      if (trimmed.endsWith(";") && i > startLineIndex) {
-        return i + 1;
-      }
-      if (i - startLineIndex > 40) {
-        return startLineIndex + 1;
-      }
-    }
-  }
-
-  // Fallback: If braces were unclosed or not found, return start line
-  return startLineIndex + 1;
-}
-
-/**
- * Utility to find the end line (1-based index) of an indentation-based block (Python).
- */
-export function findPythonBlockEnd(lines: string[], startLineIndex: number): number {
-  if (startLineIndex >= lines.length) return startLineIndex + 1;
-
-  const startLine = lines[startLineIndex];
-  const baseIndentMatch = startLine.match(/^(\s*)/);
-  const baseIndent = baseIndentMatch ? baseIndentMatch[1].length : 0;
-
-  let lastContentLine = startLineIndex + 1;
-  let bodyStarted = false;
-
-  for (let i = startLineIndex + 1; i < lines.length; i++) {
-    const line = lines[i];
-    const trimmed = line.trim();
-
-    // Skip empty lines or pure comment lines
-    if (!trimmed || trimmed.startsWith("#")) {
-      continue;
-    }
-
-    const currentIndentMatch = line.match(/^(\s*)/);
-    const currentIndent = currentIndentMatch ? currentIndentMatch[1].length : 0;
-
-    if (currentIndent > baseIndent) {
-      bodyStarted = true;
-      lastContentLine = i + 1;
-    } else {
-      // Returned to same or lesser indentation -> block ended
-      if (bodyStarted) {
-        return lastContentLine;
-      }
-      break;
-    }
-  }
-
-  return lastContentLine;
-}
+/**
+ * Utility to find the end line (1-based index) of a code block.
+ * Handles brace matching with string and comment awareness for C-like languages (TS, JS, PHP, Go).
+ */
+export function findBraceBlockEnd(lines: string[], startLineIndex: number): number {
+  let depth = 0;
+  let hasOpened = false;
+  let inMultiLineComment = false;
+
+  for (let i = startLineIndex; i < lines.length; i++) {
+    const line = lines[i];
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let inTemplateString = false;
+
+    for (let j = 0; j < line.length; j++) {
+      const char = line[j];
+      const prevChar = j > 0 ? line[j - 1] : "";
+      const nextChar = j + 1 < line.length ? line[j + 1] : "";
+
+      // Multi-line comment boundary
+      if (inMultiLineComment) {
+        if (char === "*" && nextChar === "/") {
+          inMultiLineComment = false;
+          j++; // skip '/'
+        }
+        continue;
+      }
+
+      // Check start of multi-line comment /*
+      if (!inSingleQuote && !inDoubleQuote && !inTemplateString && char === "/" && nextChar === "*") {
+        inMultiLineComment = true;
+        j++;
+        continue;
+      }
+
+      // Check single-line comment //
+      if (!inSingleQuote && !inDoubleQuote && !inTemplateString && char === "/" && nextChar === "/") {
+        break; // ignore rest of line
+      }
+
+      // String quote handling (with escape character check)
+      if (char === "'" && !inDoubleQuote && !inTemplateString && prevChar !== "\\") {
+        inSingleQuote = !inSingleQuote;
+        continue;
+      }
+      if (char === '"' && !inSingleQuote && !inTemplateString && prevChar !== "\\") {
+        inDoubleQuote = !inDoubleQuote;
+        continue;
+      }
+      if (char === "`" && !inSingleQuote && !inDoubleQuote && prevChar !== "\\") {
+        inTemplateString = !inTemplateString;
+        continue;
+      }
+
+      if (inSingleQuote || inDoubleQuote || inTemplateString) {
+        continue;
+      }
+
+      // Brace tracking
+      if (char === "{") {
+        depth++;
+        hasOpened = true;
+      } else if (char === "}") {
+        if (hasOpened) {
+          depth--;
+          if (depth === 0) {
+            return i + 1; // 1-based line number
+          }
+        }
+      }
+    }
+
+    // Safety guard: If we haven't seen an opening brace within 40 lines or hit a declaration-only statement
+    if (!hasOpened) {
+      const trimmed = line.trim();
+      if (trimmed.endsWith(";") && i > startLineIndex) {
+        return i + 1;
+      }
+      if (i - startLineIndex > 40) {
+        return startLineIndex + 1;
+      }
+    }
+  }
+
+  // Fallback: If braces were unclosed or not found, return start line
+  return startLineIndex + 1;
+}
+
+/**
+ * Utility to find the end line (1-based index) of an indentation-based block (Python).
+ */
+export function findPythonBlockEnd(lines: string[], startLineIndex: number): number {
+  if (startLineIndex >= lines.length) return startLineIndex + 1;
+
+  const startLine = lines[startLineIndex];
+  const baseIndentMatch = startLine.match(/^(\s*)/);
+  const baseIndent = baseIndentMatch ? baseIndentMatch[1].length : 0;
+
+  let lastContentLine = startLineIndex + 1;
+  let bodyStarted = false;
+
+  for (let i = startLineIndex + 1; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trim();
+
+    // Skip empty lines or pure comment lines
+    if (!trimmed || trimmed.startsWith("#")) {
+      continue;
+    }
+
+    const currentIndentMatch = line.match(/^(\s*)/);
+    const currentIndent = currentIndentMatch ? currentIndentMatch[1].length : 0;
+
+    if (currentIndent > baseIndent) {
+      bodyStarted = true;
+      lastContentLine = i + 1;
+    } else {
+      // Returned to same or lesser indentation -> block ended
+      if (bodyStarted) {
+        return lastContentLine;
+      }
+      break;
+    }
+  }
+
+  return lastContentLine;
+}

package/src/core/parser/extractors/base.ts

@@ -1,60 +1,60 @@
-import type { ArchetypeKind, ParsedFileAST } from "../../../types/index.ts";
-
-export interface CodeExtractor {
-  canHandle(filePath: string): boolean;
-  extract(filePath: string, content: string): Promise<ParsedFileAST>;
-}
-
-export function detectArchetype(filePath: string, archetypesMap: Record<string, string>): ArchetypeKind {
-  const normalized = filePath.replace(/\\/g, "/");
-
-  // Check user-configured archetype glob patterns
-  for (const [archetype, pattern] of Object.entries(archetypesMap)) {
-    if (matchesSimpleGlob(normalized, pattern)) {
-      return archetype as ArchetypeKind;
-    }
-  }
-
-  // Built-in convention heuristics
-  const lower = normalized.toLowerCase();
-  if (lower.includes("controller")) return "controller";
-  if (lower.includes("service")) return "service";
-  if (lower.includes("repository") || lower.includes("repo")) return "repository";
-  if (lower.includes("model") || lower.includes("entities") || lower.includes("entity")) return "model";
-  if (lower.includes("action")) return "action";
-  if (lower.includes("job") || lower.includes("queue")) return "job";
-  if (lower.includes("event")) return "event";
-  if (lower.includes("listener")) return "listener";
-  if (lower.includes("middleware")) return "middleware";
-  if (lower.includes("request")) return "request";
-  if (lower.includes("resource")) return "resource";
-  if (lower.includes("util") || lower.includes("helper")) return "util";
-
-  return "unknown";
-}
-
-function matchesSimpleGlob(path: string, pattern: string): boolean {
-  const normalizedPath = path.replace(/\\/g, "/").replace(/^\.\//, "");
-  const normalizedPattern = pattern.replace(/\\/g, "/").replace(/^\.\//, "");
-
-  const escaped = normalizedPattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
-  const regexStr = escaped
-    .replace(/\*\*\//g, "(?:.*\\/)?")
-    .replace(/\*\*/g, ".*")
-    .replace(/\*/g, "[^/]*")
-    .replace(/\?/g, "[^/]");
-
-  const regex = new RegExp(`^${regexStr}$`, "i");
-  if (regex.test(normalizedPath)) {
-    return true;
-  }
-
-  // If pattern does not contain directory separators, allow matching against the basename
-  if (!normalizedPattern.includes("/")) {
-    const base = normalizedPath.split("/").pop() ?? "";
-    return regex.test(base);
-  }
-
-  return false;
-}
-
+import type { ArchetypeKind, ParsedFileAST } from "../../../types/index.ts";
+
+export interface CodeExtractor {
+  canHandle(filePath: string): boolean;
+  extract(filePath: string, content: string): Promise<ParsedFileAST>;
+}
+
+export function detectArchetype(filePath: string, archetypesMap: Record<string, string>): ArchetypeKind {
+  const normalized = filePath.replace(/\\/g, "/");
+
+  // Check user-configured archetype glob patterns
+  for (const [archetype, pattern] of Object.entries(archetypesMap)) {
+    if (matchesSimpleGlob(normalized, pattern)) {
+      return archetype as ArchetypeKind;
+    }
+  }
+
+  // Built-in convention heuristics
+  const lower = normalized.toLowerCase();
+  if (lower.includes("controller")) return "controller";
+  if (lower.includes("service")) return "service";
+  if (lower.includes("repository") || lower.includes("repo")) return "repository";
+  if (lower.includes("model") || lower.includes("entities") || lower.includes("entity")) return "model";
+  if (lower.includes("action")) return "action";
+  if (lower.includes("job") || lower.includes("queue")) return "job";
+  if (lower.includes("event")) return "event";
+  if (lower.includes("listener")) return "listener";
+  if (lower.includes("middleware")) return "middleware";
+  if (lower.includes("request")) return "request";
+  if (lower.includes("resource")) return "resource";
+  if (lower.includes("util") || lower.includes("helper")) return "util";
+
+  return "unknown";
+}
+
+function matchesSimpleGlob(path: string, pattern: string): boolean {
+  const normalizedPath = path.replace(/\\/g, "/").replace(/^\.\//, "");
+  const normalizedPattern = pattern.replace(/\\/g, "/").replace(/^\.\//, "");
+
+  const escaped = normalizedPattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+  const regexStr = escaped
+    .replace(/\*\*\//g, "(?:.*\\/)?")
+    .replace(/\*\*/g, ".*")
+    .replace(/\*/g, "[^/]*")
+    .replace(/\?/g, "[^/]");
+
+  const regex = new RegExp(`^${regexStr}$`, "i");
+  if (regex.test(normalizedPath)) {
+    return true;
+  }
+
+  // If pattern does not contain directory separators, allow matching against the basename
+  if (!normalizedPattern.includes("/")) {
+    const base = normalizedPath.split("/").pop() ?? "";
+    return regex.test(base);
+  }
+
+  return false;
+}
+