legacyver 2.1.0 → 2.1.2

package/src/parser/pattern-detector.js

@@ -0,0 +1,71 @@
+'use strict';
+
+/**
+ * Domain pattern detector — scans function body text for known patterns.
+ */
+
+const PATTERNS = [
+  {
+    name: 'arithmetic',
+    test: (body) =>
+      /[\*\/\%\*\*]/.test(body) || /Math\./.test(body),
+  },
+  {
+    name: 'mqtt',
+    test: (body) =>
+      /\.publish\s*\(/.test(body) ||
+      /\.subscribe\s*\(/.test(body) ||
+      /\.connect\s*\(/.test(body) ||
+      /mqtts?:\/\//.test(body),
+  },
+  {
+    name: 'http_call',
+    test: (body) =>
+      /\bfetch\s*\(/.test(body) ||
+      /\baxios\b/.test(body) ||
+      /\bhttp\.get\s*\(/.test(body) ||
+      /\bcurl\b/.test(body) ||
+      /\bGuzzle\b/.test(body),
+  },
+  {
+    name: 'database_query',
+    test: (body) =>
+      /\.query\s*\(/.test(body) ||
+      /->where\s*\(/.test(body) ||
+      /->select\s*\(/.test(body) ||
+      /\bDB::/.test(body) ||
+      /\bPDO\b/.test(body) ||
+      /\bmongoose\b/.test(body) ||
+      /\bprisma\b/.test(body),
+  },
+  {
+    name: 'event_emit',
+    test: (body) =>
+      /\.emit\s*\(/.test(body) ||
+      /\.dispatch\s*\(/.test(body) ||
+      /\bevent\s*\(/.test(body) ||
+      /Event::dispatch\s*\(/.test(body),
+  },
+  {
+    name: 'caching',
+    test: (body) =>
+      /\bcache\s*\(/.test(body) ||
+      /\bCache::/.test(body) ||
+      /\bRedis::/.test(body),
+  },
+  {
+    name: 'queue_job',
+    test: (body) =>
+      /\bdispatch\s*\(/.test(body) ||
+      /Queue::push\s*\(/.test(body) ||
+      /->delay\s*\(/.test(body) ||
+      /\.queue\s*\(/.test(body),
+  },
+];
+
+function detectPatterns(bodyText) {
+  if (!bodyText) return [];
+  return PATTERNS.filter((p) => p.test(bodyText)).map((p) => p.name);
+}
+
+module.exports = { detectPatterns, PATTERNS };

package/src/parser/pkg-builder.js

@@ -1,105 +1,58 @@
-/**
- * PKG (Project Knowledge Graph) builder.
- * Aggregates all FileFacts into a single ProjectKnowledgeGraph.
- * Infers project name from package.json or directory name.
- * Detects entry points (files with empty calledBy).
- */
-
-import { readFileSync, existsSync } from 'node:fs';
-import { join, basename } from 'node:path';
+'use strict';
 
 /**
- * @typedef {object} ProjectKnowledgeGraph
- * @property {object} meta
- * @property {string} meta.name
- * @property {string} meta.primaryLanguage
- * @property {number} meta.totalFiles
- * @property {string} meta.analyzedAt
- * @property {Object<string, import('./index.js').FileFacts>} files
- * @property {string[]} entryPoints
- * @property {Object<string, string[]>} graph
+ * Assemble all FileFacts into a Project Knowledge Graph (PKG).
  */
-
-/**
- * Build a ProjectKnowledgeGraph from all FileFacts.
- * @param {import('./index.js').FileFacts[]} allFacts
- * @param {string} targetDir - Base directory
- * @returns {ProjectKnowledgeGraph}
- */
-export function buildPKG(allFacts, targetDir) {
-  const name = inferProjectName(targetDir);
-  const primaryLanguage = detectPrimaryLanguage(allFacts);
-
+function buildPKG(allFacts, meta) {
   const files = {};
   const graph = {};
+  const entryPoints = [];
 
   for (const facts of allFacts) {
     files[facts.relativePath] = facts;
-    if (facts.callsTo.length > 0) {
-      graph[facts.relativePath] = facts.callsTo;
+    graph[facts.relativePath] = facts.callsTo || [];
+    if (!facts.calledBy || facts.calledBy.length === 0) {
+      entryPoints.push(facts.relativePath);
     }
   }
 
-  // Entry points: files not called by anyone
-  const entryPoints = allFacts
-    .filter((f) => f.calledBy.length === 0)
-    .map((f) => f.relativePath);
+  // Laravel meta aggregation
+  let laravelMeta = null;
+  if (meta && meta.framework === 'laravel') {
+    const routeMap = [];
+    const relationships = [];
+    const providerBindings = [];
+    const modelNames = [];
+
+    for (const facts of allFacts) {
+      if (facts.laravelContext) {
+        const ctx = facts.laravelContext;
+        if (ctx.type === 'route_file' && ctx.routes) {
+          routeMap.push(...ctx.routes);
+        }
+        if (ctx.type === 'model') {
+          if (facts.classes && facts.classes.length > 0) modelNames.push(facts.classes[0].name);
+          if (ctx.relationships) relationships.push(...ctx.relationships.map(r => ({ ...r, fromModel: facts.classes && facts.classes[0] ? facts.classes[0].name : facts.relativePath })));
+        }
+        if (ctx.type === 'provider' && ctx.registerBindings) {
+          providerBindings.push({ provider: facts.relativePath, bindings: ctx.registerBindings });
+        }
+      }
+    }
+
+    laravelMeta = { routeMap, relationships, providerBindings, modelNames };
+  }
 
   return {
     meta: {
-      name,
-      primaryLanguage,
+      ...meta,
       totalFiles: allFacts.length,
-      analyzedAt: new Date().toISOString(),
     },
     files,
     entryPoints,
     graph,
+    laravelMeta,
   };
 }
 
-function inferProjectName(targetDir) {
-  // Try package.json
-  const pkgJsonPath = join(targetDir, 'package.json');
-  if (existsSync(pkgJsonPath)) {
-    try {
-      const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
-      if (pkg.name) return pkg.name;
-    } catch {
-      // Ignore parse errors
-    }
-  }
-
-  // Try go.mod
-  const goModPath = join(targetDir, 'go.mod');
-  if (existsSync(goModPath)) {
-    try {
-      const content = readFileSync(goModPath, 'utf-8');
-      const match = content.match(/module\s+(\S+)/);
-      if (match) return match[1];
-    } catch {
-      // Ignore
-    }
-  }
-
-  // Fall back to directory name
-  return basename(targetDir);
-}
-
-function detectPrimaryLanguage(allFacts) {
-  const counts = {};
-  for (const facts of allFacts) {
-    counts[facts.language] = (counts[facts.language] || 0) + 1;
-  }
-
-  let maxLang = 'unknown';
-  let maxCount = 0;
-  for (const [lang, count] of Object.entries(counts)) {
-    if (count > maxCount) {
-      maxLang = lang;
-      maxCount = count;
-    }
-  }
-
-  return maxLang;
-}
+module.exports = { buildPKG };

package/src/renderer/html.js

@@ -1,152 +1,80 @@
-/**
- * HTML renderer.
- * Converts all Markdown fragments to HTML using marked.
- * Injects sidebar navigation.
- * Outputs single self-contained index.html.
- */
+'use strict';
 
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { marked } from 'marked';
+const { writeFileSync, mkdirSync } = require('fs');
+const path = require('path');
+const { marked } = require('marked');
 
 /**
- * Render documentation as a single self-contained HTML file.
- * @param {import('../llm/queue.js').DocFragment[]} fragments
- * @param {import('../parser/pkg-builder.js').ProjectKnowledgeGraph} pkg
- * @param {string} outputDir - Output directory path
+ * HTML renderer — single self-contained index.html with lunr.js search.
  */
-export async function renderHTML(fragments, pkg, outputDir) {
+async function render(fragments, pkg, outputDir, config) {
   mkdirSync(outputDir, { recursive: true });
 
-  const sidebar = buildSidebar(fragments, pkg);
-  const content = buildContent(fragments, pkg);
+  const nav = fragments.map(f => {
+    const id = f.relativePath.replace(/[^a-zA-Z0-9]/g, '-');
+    return `<li><a href="#${id}">${f.relativePath}</a></li>`;
+  }).join('\n');
+
+  const content = fragments.map(f => {
+    const id = f.relativePath.replace(/[^a-zA-Z0-9]/g, '-');
+    const html = marked(f.content || '');
+    return `<section id="${id}"><h2>${f.relativePath}</h2>${html}</section>`;
+  }).join('\n');
+
+  const lunrDocs = fragments.map(f => ({
+    id: f.relativePath,
+    title: f.relativePath,
+    body: (f.content || '').replace(/[#`*_\[\]()]/g, ' '),
+  }));
 
   const html = `<!DOCTYPE html>
 <html lang="en">
 <head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${pkg.meta.name} - Documentation</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; display: flex; min-height: 100vh; }
-    
-    .sidebar {
-      width: 280px; min-width: 280px; background: #1e1e2e; color: #cdd6f4;
-      padding: 20px; overflow-y: auto; position: fixed; top: 0; left: 0; bottom: 0;
-    }
-    .sidebar h2 { color: #89b4fa; font-size: 16px; margin-bottom: 16px; }
-    .sidebar ul { list-style: none; }
-    .sidebar li { margin-bottom: 4px; }
-    .sidebar a { color: #a6adc8; text-decoration: none; font-size: 13px; display: block; padding: 4px 8px; border-radius: 4px; }
-    .sidebar a:hover { background: #313244; color: #cdd6f4; }
-    .sidebar .dir-label { color: #6c7086; font-size: 11px; text-transform: uppercase; margin-top: 12px; margin-bottom: 4px; padding-left: 8px; }
-    
-    .search-box { width: 100%; padding: 8px 12px; background: #313244; border: 1px solid #45475a; border-radius: 6px; color: #cdd6f4; font-size: 13px; margin-bottom: 16px; }
-    .search-box::placeholder { color: #6c7086; }
-    
-    .content { margin-left: 280px; padding: 40px; max-width: 900px; flex: 1; }
-    .content h1 { color: #1e1e2e; border-bottom: 2px solid #89b4fa; padding-bottom: 8px; margin-bottom: 24px; }
-    .content h2 { color: #313244; margin-top: 32px; margin-bottom: 12px; }
-    .content h3 { color: #45475a; margin-top: 20px; margin-bottom: 8px; }
-    .content p { line-height: 1.6; margin-bottom: 12px; color: #313244; }
-    .content code { background: #f5f5f5; padding: 2px 6px; border-radius: 3px; font-size: 14px; }
-    .content pre { background: #1e1e2e; color: #cdd6f4; padding: 16px; border-radius: 8px; overflow-x: auto; margin-bottom: 16px; }
-    .content pre code { background: none; padding: 0; }
-    .content table { border-collapse: collapse; width: 100%; margin-bottom: 16px; }
-    .content th, .content td { border: 1px solid #ddd; padding: 8px 12px; text-align: left; }
-    .content th { background: #f5f5f5; }
-    .content ul, .content ol { margin-left: 24px; margin-bottom: 12px; }
-    .content li { margin-bottom: 4px; line-height: 1.5; }
-    
-    .file-section { border-top: 1px solid #e0e0e0; padding-top: 32px; margin-top: 32px; }
-    .file-section:first-child { border-top: none; padding-top: 0; margin-top: 0; }
-
-    .meta-table { font-size: 14px; }
-    .meta-table td:first-child { font-weight: 600; width: 150px; }
-  </style>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>${pkg.meta && pkg.meta.name || 'Legacyver'} Documentation</title>
+<script src="https://unpkg.com/lunr/lunr.js"></script>
+<style>
+  body { font-family: system-ui, sans-serif; display: flex; margin: 0; }
+  nav { width: 250px; min-height: 100vh; background: #1e1e2e; color: #cdd6f4; padding: 1rem; overflow-y: auto; position: sticky; top: 0; }
+  nav ul { list-style: none; padding: 0; }
+  nav a { color: #89b4fa; text-decoration: none; font-size: 0.85rem; }
+  nav a:hover { color: #cba6f7; }
+  main { flex: 1; padding: 2rem; max-width: 900px; }
+  pre { background: #1e1e2e; color: #cdd6f4; padding: 1rem; border-radius: 6px; overflow-x: auto; }
+  code { background: #313244; padding: 2px 4px; border-radius: 3px; }
+  #search { width: 100%; padding: 0.5rem; margin-bottom: 1rem; background: #313244; border: none; color: #cdd6f4; border-radius: 4px; }
+  #search-results { background: #313244; padding: 0.5rem; border-radius: 4px; margin-bottom: 1rem; display: none; }
+</style>
 </head>
 <body>
-  <nav class="sidebar">
-    <h2>${pkg.meta.name}</h2>
-    <input type="text" class="search-box" placeholder="Search files..." id="search">
-    ${sidebar}
-  </nav>
-  <main class="content">
-    ${content}
-  </main>
-  <script>
-    document.getElementById('search').addEventListener('input', function(e) {
-      const query = e.target.value.toLowerCase();
-      document.querySelectorAll('.sidebar li').forEach(function(li) {
-        const text = li.textContent.toLowerCase();
-        li.style.display = text.includes(query) ? '' : 'none';
-      });
-    });
-    
-    document.querySelectorAll('.sidebar a').forEach(function(a) {
-      a.addEventListener('click', function(e) {
-        e.preventDefault();
-        var target = document.getElementById(this.getAttribute('href').substring(1));
-        if (target) target.scrollIntoView({ behavior: 'smooth' });
-      });
-    });
-  </script>
+<nav>
+  <input id="search" type="search" placeholder="Search..." />
+  <div id="search-results"></div>
+  <ul>${nav}</ul>
+</nav>
+<main>${content}</main>
+<script>
+const docs = ${JSON.stringify(lunrDocs)};
+const idx = lunr(function() {
+  this.field('title'); this.field('body');
+  docs.forEach(d => this.add(d));
+});
+document.getElementById('search').addEventListener('input', function() {
+  const q = this.value.trim();
+  const res = document.getElementById('search-results');
+  if (!q) { res.style.display = 'none'; return; }
+  try {
+    const results = idx.search(q);
+    res.innerHTML = results.map(r => '<div><a href="#' + r.ref.replace(/[^a-zA-Z0-9]/g,'-') + '">' + r.ref + '</a></div>').join('') || '<div>No results</div>';
+    res.style.display = 'block';
+  } catch(e) { res.style.display = 'none'; }
+});
+</script>
 </body>
 </html>`;
 
-  writeFileSync(join(outputDir, 'index.html'), html, 'utf-8');
+  writeFileSync(path.join(outputDir, 'index.html'), html, 'utf8');
 }
 
-function buildSidebar(fragments, pkg) {
-  const dirs = new Map();
-
-  for (const fragment of fragments) {
-    const dir = dirname(fragment.relativePath);
-    if (!dirs.has(dir)) {
-      dirs.set(dir, []);
-    }
-    dirs.get(dir).push(fragment);
-  }
-
-  let html = '<ul>';
-
-  const sortedDirs = [...dirs.keys()].sort();
-  for (const dir of sortedDirs) {
-    if (dir !== '.') {
-      html += `<li><div class="dir-label">${dir}</div></li>`;
-    }
-    const files = dirs.get(dir).sort((a, b) => a.relativePath.localeCompare(b.relativePath));
-    for (const f of files) {
-      const id = f.relativePath.replace(/[^a-zA-Z0-9]/g, '-');
-      html += `<li><a href="#${id}">${f.relativePath}</a></li>`;
-    }
-  }
-
-  html += '</ul>';
-  return html;
-}
-
-function buildContent(fragments, pkg) {
-  let html = '';
-
-  // Project overview
-  html += `<h1>${pkg.meta.name} Documentation</h1>`;
-  html += `<table class="meta-table">`;
-  html += `<tr><td>Primary Language</td><td>${pkg.meta.primaryLanguage}</td></tr>`;
-  html += `<tr><td>Total Files</td><td>${pkg.meta.totalFiles}</td></tr>`;
-  html += `<tr><td>Analyzed At</td><td>${pkg.meta.analyzedAt}</td></tr>`;
-  html += `</table>`;
-
-  // Individual file docs
-  const sorted = [...fragments].sort((a, b) => a.relativePath.localeCompare(b.relativePath));
-  for (const fragment of sorted) {
-    const id = fragment.relativePath.replace(/[^a-zA-Z0-9]/g, '-');
-    html += `<div class="file-section" id="${id}">`;
-    html += `<h2>${fragment.relativePath}</h2>`;
-    html += marked(fragment.content);
-    html += `</div>`;
-  }
-
-  return html;
-}
+module.exports = { render };

package/src/renderer/index.js

@@ -1,44 +1,32 @@
-/**
- * Renderer dispatcher.
- * Reads format from config, calls correct renderer.
- * Ensures output directory exists.
- */
+'use strict';
 
-import { mkdirSync } from 'node:fs';
-import { renderMarkdown } from './markdown.js';
-import { renderHTML } from './html.js';
-import { renderJSON } from './json.js';
-import { RenderError } from '../utils/errors.js';
-
-const RENDERERS = {
-  markdown: renderMarkdown,
-  html: renderHTML,
-  json: renderJSON,
-};
+const { mkdirSync } = require('fs');
+const { RenderError } = require('../utils/errors');
 
 /**
- * Render documentation using the specified format.
- * @param {import('../llm/queue.js').DocFragment[]} fragments
- * @param {import('../parser/pkg-builder.js').ProjectKnowledgeGraph} pkg
- * @param {object} options
- * @param {string} options.format - Output format (markdown, html, json)
- * @param {string} options.outputDir - Output directory
+ * Renderer dispatcher.
  */
-export async function render(fragments, pkg, options) {
-  const { format = 'markdown', outputDir } = options;
-
-  const renderer = RENDERERS[format];
-  if (!renderer) {
-    throw new RenderError(format, `Unsupported format "${format}". Supported: ${Object.keys(RENDERERS).join(', ')}`);
-  }
-
-  // Ensure output directory exists
+async function render(fragments, pkg, outputDir, config) {
   mkdirSync(outputDir, { recursive: true });
 
+  const format = (config.format || 'markdown').toLowerCase();
+
   try {
-    await renderer(fragments, pkg, outputDir);
-  } catch (err) {
-    if (err instanceof RenderError) throw err;
-    throw new RenderError(format, err.message);
+    switch (format) {
+      case 'html':
+        await require('./html').render(fragments, pkg, outputDir, config);
+        break;
+      case 'json':
+        await require('./json').render(fragments, pkg, outputDir, config);
+        break;
+      case 'markdown':
+      default:
+        await require('./markdown').render(fragments, pkg, outputDir, config);
+        break;
+    }
+  } catch (e) {
+    throw new RenderError(format, e);
   }
 }
+
+module.exports = { render };

package/src/renderer/json.js

@@ -1,46 +1,28 @@
-/**
- * JSON renderer.
- * Outputs full PKG with llmDescription field added to each file entry.
- * Writes legacyver-docs/documentation.json.
- */
+'use strict';
 
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+const { writeFileSync, mkdirSync } = require('fs');
+const path = require('path');
 
 /**
- * Render documentation as a JSON file.
- * @param {import('../llm/queue.js').DocFragment[]} fragments
- * @param {import('../parser/pkg-builder.js').ProjectKnowledgeGraph} pkg
- * @param {string} outputDir - Output directory path
+ * JSON renderer — outputs PKG enriched with LLM descriptions.
  */
-export async function renderJSON(fragments, pkg, outputDir) {
+async function render(fragments, pkg, outputDir, config) {
   mkdirSync(outputDir, { recursive: true });
 
-  // Create a fragment lookup by relative path
-  const fragmentMap = new Map();
-  for (const fragment of fragments) {
-    fragmentMap.set(fragment.relativePath, fragment);
-  }
-
-  // Build output: PKG + llmDescription per file
-  const output = {
-    meta: pkg.meta,
-    entryPoints: pkg.entryPoints,
-    graph: pkg.graph,
-    files: {},
-  };
-
-  for (const [filePath, facts] of Object.entries(pkg.files)) {
-    const fragment = fragmentMap.get(filePath);
-    output.files[filePath] = {
-      ...facts,
-      llmDescription: fragment ? fragment.content : null,
-    };
+  // Enrich PKG with LLM descriptions
+  const enrichedPkg = JSON.parse(JSON.stringify(pkg));
+  for (const frag of fragments) {
+    if (enrichedPkg.files[frag.relativePath]) {
+      enrichedPkg.files[frag.relativePath].llmDescription = frag.content;
+      enrichedPkg.files[frag.relativePath]._qualityWarnings = frag._qualityWarnings || [];
+    }
   }
 
   writeFileSync(
-    join(outputDir, 'documentation.json'),
-    JSON.stringify(output, null, 2),
-    'utf-8'
+    path.join(outputDir, 'documentation.json'),
+    JSON.stringify(enrichedPkg, null, 2),
+    'utf8'
   );
 }
+
+module.exports = { render };