@oisheek_c/codeforge 1.0.1

package/packages/retrieval/symbols.js

@@ -0,0 +1,145 @@
+/**
+ * packages/retrieval/symbols.js
+ *
+ * Repository-wide symbol index.
+ */
+
+export class SymbolIndex {
+    constructor() {
+        this.clear();
+    }
+
+    clear() {
+        this.byId = new Map();
+        this.byName = new Map();
+        this.byFile = new Map();
+        this.byKind = new Map();
+    }
+
+    /**
+     * Add a single symbol.
+     */
+    add(symbol) {
+        if (!symbol) {
+            return;
+        }
+
+        // ------------------------------------------------------------------
+        // ID
+        // ------------------------------------------------------------------
+
+        this.byId.set(symbol.id, symbol);
+
+        // ------------------------------------------------------------------
+        // Name
+        // ------------------------------------------------------------------
+
+        if (!this.byName.has(symbol.name)) {
+            this.byName.set(symbol.name, []);
+        }
+
+        this.byName.get(symbol.name).push(symbol);
+
+        // ------------------------------------------------------------------
+        // File
+        // ------------------------------------------------------------------
+
+        if (!this.byFile.has(symbol.file)) {
+            this.byFile.set(symbol.file, []);
+        }
+
+        this.byFile.get(symbol.file).push(symbol);
+
+        // ------------------------------------------------------------------
+        // Kind
+        // ------------------------------------------------------------------
+
+        if (!this.byKind.has(symbol.kind)) {
+            this.byKind.set(symbol.kind, []);
+        }
+
+        this.byKind.get(symbol.kind).push(symbol);
+    }
+
+    /**
+     * Index one parsed file.
+     */
+    addFile(parsedFile) {
+        if (!parsedFile?.symbols) {
+            return;
+        }
+
+        for (const symbol of parsedFile.symbols) {
+            this.add(symbol);
+        }
+    }
+
+    /**
+     * Build the complete repository index.
+     */
+    build(repository) {
+        this.clear();
+
+        const files = repository.files ?? repository;
+
+        for (const file of files) {
+            this.addFile(file);
+        }
+
+        return this;
+    }
+
+    /**
+     * Lookup by ID.
+     */
+    get(id) {
+        return this.byId.get(id) ?? null;
+    }
+
+    /**
+     * Find symbols by name.
+     */
+    find(name) {
+        return this.byName.get(name) ?? [];
+    }
+
+    /**
+     * Get symbols in a file.
+     */
+    file(path) {
+        return this.byFile.get(path) ?? [];
+    }
+
+    /**
+     * Get symbols by kind.
+     */
+    kind(kind) {
+        return this.byKind.get(kind) ?? [];
+    }
+
+    /**
+     * All indexed symbols.
+     */
+    values() {
+        return [...this.byId.values()];
+    }
+
+    /**
+     * Repository statistics.
+     */
+    stats() {
+        return {
+            total: this.byId.size,
+            names: this.byName.size,
+            files: this.byFile.size,
+            kinds: this.byKind.size,
+        };
+    }
+}
+
+/**
+ * Convenience helper.
+ */
+export function buildSymbolIndex(repository) {
+    return new SymbolIndex().build(repository);
+}

package/packages/scanner/detect.js

@@ -0,0 +1,69 @@
+import fs from "fs/promises";
+import path from "path";
+
+async function readPackageJson(root) {
+  const file = path.join(root, "package.json");
+
+  try {
+    const content = await fs.readFile(file, "utf8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+export async function detectProject(root) {
+  const packageJson = await readPackageJson(root);
+
+  let framework = "unknown";
+  let packageManager = "unknown";
+
+  if (!packageJson) {
+    return {
+      framework,
+      packageManager,
+      packageJson: null
+    };
+  }
+
+  const deps = {
+    ...(packageJson.dependencies ?? {}),
+    ...(packageJson.devDependencies ?? {})
+  };
+
+  if (deps.next)
+    framework = "next";
+
+  else if (deps.react)
+    framework = "react";
+
+  else if (deps["@nestjs/core"])
+    framework = "nest";
+
+  else if (deps.express)
+    framework = "express";
+
+  else if (deps.vue)
+    framework = "vue";
+
+  else if (deps.vite)
+    framework = "vite";
+
+  else
+    framework = "node";
+
+  if (packageJson.packageManager?.startsWith("pnpm"))
+    packageManager = "pnpm";
+
+  else if (packageJson.packageManager?.startsWith("yarn"))
+    packageManager = "yarn";
+
+  else
+    packageManager = "npm";
+
+  return {
+    framework,
+    packageManager,
+    packageJson
+  };
+}

package/packages/scanner/ignore.js

@@ -0,0 +1,12 @@
+export const DEFAULT_IGNORE = [
+  "node_modules",
+  ".git",
+  ".next",
+  "dist",
+  "build",
+  ".turbo",
+  ".cache",
+  ".codeforge",
+  ".idea",
+  ".vscode"
+];

package/packages/scanner/index.js

@@ -0,0 +1,2 @@
+export * from "./scanner.js";
+export * from "./root.js";

package/packages/scanner/root.js

@@ -0,0 +1,21 @@
+import fs from "fs/promises";
+import path from "path";
+
+export async function findWorkspaceRoot(start) {
+  let current = path.resolve(start);
+
+  while (true) {
+    try {
+      await fs.access(path.join(current, "pnpm-workspace.yaml"));
+      return current;
+    } catch {}
+
+    const parent = path.dirname(current);
+
+    if (parent === current) {
+      return start;
+    }
+
+    current = parent;
+  }
+}

package/packages/scanner/scanner.js

@@ -0,0 +1,35 @@
+import fs from "fs/promises";
+import path from "path";
+
+import { detectProject } from "./detect.js";
+import { buildTree } from "./tree.js";
+
+export async function scanProject(root) {
+  const detection = await detectProject(root);
+
+  let files = [];
+
+  try {
+    files = await fs.readdir(root);
+  } catch {}
+
+  return {
+    name: path.basename(root),
+
+    root,
+
+    packageManager: detection.packageManager,
+
+    framework: detection.framework,
+
+    hasGit: files.includes(".git"),
+
+    hasNodeModules: files.includes("node_modules"),
+
+    tree: await buildTree(root),
+
+    packageJson: detection.packageJson,
+
+    files
+  };
+}

package/packages/scanner/tree.js

@@ -0,0 +1,45 @@
+import fs from "fs/promises";
+import path from "path";
+import { DEFAULT_IGNORE } from "./ignore.js";
+
+const MAX_DEPTH = 3;
+
+async function walk(dir, depth = 0) {
+  if (depth > MAX_DEPTH)
+    return [];
+
+  let entries = await fs.readdir(dir, {
+    withFileTypes: true
+  });
+
+  entries = entries
+    .filter(entry => !DEFAULT_IGNORE.includes(entry.name))
+    .sort((a, b) => a.name.localeCompare(b.name));
+
+  const lines = [];
+
+  for (const entry of entries) {
+    const indent = "  ".repeat(depth);
+
+    if (entry.isDirectory()) {
+      lines.push(`${indent}${entry.name}/`);
+
+      const children = await walk(
+        path.join(dir, entry.name),
+        depth + 1
+      );
+
+      lines.push(...children);
+    } else {
+      lines.push(`${indent}${entry.name}`);
+    }
+  }
+
+  return lines;
+}
+
+export async function buildTree(root) {
+  const lines = await walk(root);
+
+  return lines.join("\n");
+}