@lakindu_perera/toren 1.0.3 → 1.0.5

package/README.md

@@ -62,6 +62,14 @@ toren --format markdown > PROJECT_REPORT.md
 toren --format html > report.html
 toren --format json > scan.json
 
+# Focused Output Modes (Mutually Exclusive)
+toren --project-type
+toren --frameworks
+toren --entry-points
+toren --structure
+toren --configs
+toren --scripts
+
 # Lifecycle & Help Commands
 toren --help
 toren --version
@@ -74,6 +82,12 @@ toren --uninstall
 | Flag | Description |
 |------|-------------|
 | `[path]` | Directory to scan. Defaults to the current directory (`.`). |
+| `--project-type` | Show detected project type only. |
+| `--frameworks` | Show detected frameworks only. |
+| `--entry-points` | Show detected entry points only. |
+| `--structure` | Show repository structure only. |
+| `--configs` | Show detected project configuration files. |
+| `--scripts` | Show available package scripts only. |
 | `--format <type>` | Output format: `console` (default), `json`, `markdown`, `html`. |
 | `--include-hidden` | Include hidden files and dot-directories in the scan. |
 | `--max-files <N>` | Override the default 50,000-file scan limit. |
@@ -83,18 +97,48 @@ toren --uninstall
 | `--uninstall` | Safely remove Toren from the global npm environment. |
 
 > **Note:** `--format md` is not a valid alias. Use `--format markdown` in full.
+> **Note:** Focused output flags (`--project-type`, `--frameworks`, `--entry-points`, `--structure`, `--configs`, `--scripts`) are mutually exclusive.
 
 ---
 
 ## Output Examples
 
+### Focused Output Example
+Sometimes you only need a specific piece of intelligence for use in a script or a quick lookup. Use the focused output flags to bypass the full report:
+
+```bash
+$ toren --project-type
+Project Type: Node.js / JavaScript
+
+$ toren --frameworks
+Frameworks:
+- React
+
+$ toren --entry-points
+Entry Points:
+- src/main.tsx
+
+$ toren --configs
+Configuration Files
+───────────────────
+
+✓ package.json
+✓ vite.config.ts
+
+$ toren --scripts
+Available Scripts
+
+start      node bin/toren.js
+test       node --test
+```
+
 ### Console Output Example
 The default `console` format renders a beautiful summary directly in your terminal:
 
 ```text
-  Toren v1.0.3  —  Codebase Onboarding Intelligence
+  Toren v1.0.4  —  Codebase Onboarding Intelligence
 
-🔍  Project Summary
+ Project Summary
 ────────────────────────────────────────────────────────────────────────────────
   Path:          ./my-react-app
   Project type:  React
@@ -102,11 +146,11 @@ The default `console` format renders a beautiful summary directly in your termin
   Total folders: 6
   Scan duration: 4 ms
 
-🚪  Entry Points
+ Entry Points
 ────────────────────────────────────────────────────────────────────────────────
   →  src/main.tsx
 
-📁  Folder Structure  (first 20 files)
+ Folder Structure  (first 20 files)
 ────────────────────────────────────────────────────────────────────────────────
 my-react-app/
 ├── public/
@@ -124,7 +168,7 @@ my-react-app/
   … and 21 more file(s) not shown
 
 ────────────────────────────────────────────────────────────────────────────────
-  ✅  Scan complete.
+  Scan complete.
 ```
 
 ### JSON Output Example
@@ -209,12 +253,12 @@ Contributions to improve this codebase analyzer CLI are always welcome!
 
 ---
 
-## 📄 License
+## License
 
 Distributed under the MIT License. See `LICENSE` for more information.
 
 ---
 
-## 👨‍💻 Author
+## Author
 
 Built with by **[Lakindu Perera](https://github.com/lakindudev)**.

package/bin/toren.js

@@ -25,6 +25,7 @@
 import { createRequire } from 'node:module';
 import { scan }          from '../src/scanner/scan.js';
 import renderers         from '../src/renderers/index.js';
+import { getFocusedModeInfo, renderFocusedMode, FOCUSED_FLAGS } from '../src/focused-output.js';
 import { runDoctor, runUninstall } from '../src/lifecycle.js';
 
 const require = createRequire(import.meta.url);
@@ -44,14 +45,22 @@ function printHelp() {
   const formatList = SUPPORTED_FORMATS.map(f => `      ${f}`).join('\n');
   console.log(`
 \x1b[1mUsage:\x1b[0m
-  toren [path]                Scan a directory (defaults to current directory)
-  toren --format <type>       Select output format (default: console)
-  toren --include-hidden      Include hidden dot-files in the scan
-  toren --max-files <N>       Set max file scan limit (default: 50000)
-  toren --help                Show this help message
-  toren --version             Show version number
-  toren --doctor              Check global installation health
-  toren --uninstall           Safely remove global installation
+  toren [path] [options]
+
+\x1b[1mOptions:\x1b[0m
+  --project-type      Show detected project type only
+  --frameworks        Show detected frameworks only
+  --entry-points      Show detected entry points only
+  --structure         Show repository structure only
+  --configs           Show detected project configuration files
+  --scripts           Show available package scripts only
+  --format <type>     Output as console, json, markdown, or html
+  --include-hidden    Include hidden files and folders
+  --max-files <n>     Set scan file limit
+  --help              Show this help message
+  --version           Show version number
+  --doctor            Run CLI diagnostics
+  --uninstall         Remove Toren global installation
 
 \x1b[1mOutput Formats:\x1b[0m
 ${formatList}
@@ -140,6 +149,16 @@ function parseArgs() {
     format = 'json';
   }
 
+  // ── Focused Output Flags ────────────────────────────────────────────────
+  const focusedInfo = getFocusedModeInfo(args);
+  
+  if (focusedInfo.error) {
+    console.error(focusedInfo.message);
+    return { action: 'exit', code: 1 };
+  }
+
+  const focusedMode = focusedInfo.mode;
+
   // ── Hidden files ────────────────────────────────────────────────────────
   const includeHidden = args.includes('--include-hidden');
 
@@ -184,6 +203,7 @@ function parseArgs() {
     '--uninstall',
     '--format',
     '--json',
+    ...FOCUSED_FLAGS,
     '--include-hidden',
     '--max-files',
   ]);
@@ -198,7 +218,7 @@ function parseArgs() {
     return { action: 'exit', code: 1 };
   }
 
-  return { action: 'scan', target, format, includeHidden, maxFiles };
+  return { action: 'scan', target, format, includeHidden, maxFiles, focusedMode };
 }
 
 // ---------------------------------------------------------------------------
@@ -249,7 +269,12 @@ function assertValidFormat(format) {
       includeHidden: parsed.includeHidden,
       maxFiles:      parsed.maxFiles,
     });
-    render(result, { cwd: process.cwd() });
+    
+    if (parsed.focusedMode) {
+      renderFocusedMode(parsed.focusedMode, result);
+    } else {
+      render(result, { cwd: process.cwd() });
+    }
   } catch (err) {
     // Render errors in the requested format where possible.
     if (parsed.format === 'json') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lakindu_perera/toren",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "A powerful codebase scanner CLI tool for project analysis, framework detection, and understanding repository structure instantly.",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
   ],
   "scripts": {
     "start": "node bin/toren.js",
+    "test": "node --test",
     "lint": "node --check bin/toren.js src/scanner/scan.js src/lifecycle.js src/renderers/index.js src/renderers/console-renderer.js src/renderers/json-renderer.js src/renderers/markdown-renderer.js src/renderers/html-renderer.js"
   },
   "keywords": [

package/src/detectors/config-detector.js

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Configuration file detector
+ */
+
+/**
+ * Detects common configuration files in the root of the repository.
+ *
+ * @param {string[]} flatFiles - Array of relative file paths from the scanner
+ * @returns {{ configs: string[] }}
+ */
+export function detectConfigs(flatFiles) {
+  const configPatterns = [
+    // Package
+    /^package\.json$/,
+    /^package-lock\.json$/,
+    /^pnpm-lock\.yaml$/,
+    /^yarn\.lock$/,
+    /^bun\.lockb$/,
+
+    // TypeScript
+    /^tsconfig\.json$/,
+    /^jsconfig\.json$/,
+
+    // Frontend
+    /^vite\.config\.[a-zA-Z0-9]+$/,
+    /^next\.config\.[a-zA-Z0-9]+$/,
+    /^nuxt\.config\.[a-zA-Z0-9]+$/,
+    /^astro\.config\.[a-zA-Z0-9]+$/,
+    /^angular\.json$/,
+
+    // Build
+    /^webpack\.config\.[a-zA-Z0-9]+$/,
+    /^rollup\.config\.[a-zA-Z0-9]+$/,
+    /^turbo\.json$/,
+    /^nx\.json$/,
+
+    // Styling
+    /^tailwind\.config\.[a-zA-Z0-9]+$/,
+    /^postcss\.config\.[a-zA-Z0-9]+$/,
+
+    // Lint
+    /^eslint\.config\.[a-zA-Z0-9]+$/,
+    /^\.eslintrc.*$/,
+    /^prettier\.config\.[a-zA-Z0-9]+$/,
+    /^\.prettierrc.*$/,
+
+    // Backend
+    /^pom\.xml$/,
+    /^build\.gradle$/,
+    /^build\.gradle\.kts$/,
+
+    // Languages
+    /^requirements\.txt$/,
+    /^pyproject\.toml$/,
+    /^Cargo\.toml$/,
+    /^go\.mod$/,
+
+    // Deployment
+    /^Dockerfile$/,
+    /^docker-compose\.ya?ml$/
+  ];
+
+  const matchedSet = new Set();
+
+  for (const file of flatFiles) {
+    // Ensure we only match files at the root of the repository
+    if (file.includes('/')) continue;
+
+    for (const pattern of configPatterns) {
+      if (pattern.test(file)) {
+        matchedSet.add(file);
+        break; // Stop checking patterns once a match is found
+      }
+    }
+  }
+
+  // Convert Set to Array and sort alphabetically
+  const configs = Array.from(matchedSet).sort();
+
+  return { configs };
+}

package/src/detectors/script-detector.js

@@ -0,0 +1,32 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * Detects npm/package scripts from package.json in the project root.
+ *
+ * @param {string} rootPath - The absolute path of the scanned root
+ * @returns {{ scripts: Array<{name: string, command: string}> }}
+ */
+export function detectScripts(rootPath) {
+  const scripts = [];
+  const pkgPath = path.join(rootPath, 'package.json');
+
+  try {
+    if (fs.existsSync(pkgPath)) {
+      const content = fs.readFileSync(pkgPath, 'utf8');
+      const pkg = JSON.parse(content);
+
+      if (pkg.scripts && typeof pkg.scripts === 'object') {
+        for (const [name, command] of Object.entries(pkg.scripts)) {
+          if (typeof command === 'string') {
+            scripts.push({ name, command });
+          }
+        }
+      }
+    }
+  } catch (error) {
+    // Return empty scripts on malformed or unreadable package.json
+  }
+
+  return { scripts };
+}

package/src/focused-output.js

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Focused output modes handling for Toren CLI.
+ */
+
+import { renderStructure } from './renderers/console-renderer.js';
+
+export const FOCUSED_FLAGS = [
+  '--project-type',
+  '--frameworks',
+  '--entry-points',
+  '--structure',
+  '--configs',
+  '--scripts'
+];
+
+/**
+ * Validates focused flags in the provided arguments.
+ * 
+ * @param {string[]} args Process arguments
+ * @returns {{ error: boolean, message?: string, mode?: string|null }}
+ */
+export function getFocusedModeInfo(args) {
+  const activeFlags = FOCUSED_FLAGS.filter(flag => args.includes(flag));
+  
+  if (activeFlags.length > 1) {
+    return {
+      error: true,
+      message: '\x1b[31mError: focused output flags are mutually exclusive. Please use only one of:\x1b[0m\n' + 
+               FOCUSED_FLAGS.map(f => `  ${f}`).join('\n') + '\n'
+    };
+  }
+
+  return {
+    error: false,
+    mode: activeFlags[0] || null
+  };
+}
+
+/**
+ * Renders the scan result based on the active focused mode.
+ * 
+ * @param {string} mode Active focused mode flag
+ * @param {import('./scanner/scan.js').ScanResult} result 
+ */
+export function renderFocusedMode(mode, result) {
+  switch (mode) {
+    case '--project-type':
+      console.log(`Project Type: ${result.projectType}`);
+      break;
+      
+    case '--frameworks':
+      if (!result.projectType || result.projectType === 'Unknown') {
+        console.log('Frameworks: None detected');
+      } else {
+        console.log('Frameworks:');
+        console.log(`- ${result.projectType}`);
+      }
+      break;
+      
+    case '--entry-points':
+      if (!result.entryPoints || result.entryPoints.length === 0) {
+        console.log('Entry Points: None detected');
+      } else {
+        console.log('Entry Points:');
+        result.entryPoints.forEach(ep => console.log(`- ${ep}`));
+      }
+      break;
+      
+    case '--structure':
+      renderStructure(result);
+      break;
+      
+    case '--configs':
+      console.log('Configuration Files');
+      console.log('───────────────────\n');
+      if (!result.configs || result.configs.length === 0) {
+        console.log('No configuration files detected.');
+      } else {
+        result.configs.forEach(c => console.log(`✓ ${c}`));
+      }
+      break;
+
+    case '--scripts':
+      console.log('Available Scripts\n');
+      if (!result.scripts || result.scripts.length === 0) {
+        console.log('No scripts found');
+      } else {
+        const maxNameLen = Math.max(...result.scripts.map(s => s.name.length));
+        result.scripts.forEach(s => {
+          const paddedName = s.name.padEnd(maxNameLen + 6, ' ');
+          console.log(`${paddedName}${s.command}`);
+        });
+      }
+      break;
+  }
+}

package/src/renderers/console-renderer.js

@@ -99,8 +99,11 @@ function row(label, value, ...valueCodes) {
  * @param {string}            prefix   - Accumulated indentation
  * @param {boolean}           isLast   - Whether this is the last sibling
  * @param {{ count: number, maxReached: boolean }} counter  - Shared mutable file counter
+ * @param {number}            limit    - Max files to render
+ * @param {number}            depth    - Current depth
+ * @param {number}            maxDepth - Max recursion depth
  */
-function renderTree(node, prefix, isLast, counter, depth = 0, maxDepth = 4) {
+function renderTree(node, prefix, isLast, counter, limit = PREVIEW_LIMIT, depth = 0, maxDepth = 4) {
   if (counter.maxReached) return;
   if (depth >= maxDepth) return;
 
@@ -117,7 +120,7 @@ function renderTree(node, prefix, isLast, counter, depth = 0, maxDepth = 4) {
     }
 
     for (let i = 0; i < children.length; i++) {
-      if (counter.count >= PREVIEW_LIMIT) {
+      if (counter.count >= limit) {
         console.log(`${prefix}${extension}└── ${paint('...', C.dim)}`);
         counter.maxReached = true;
         break;
@@ -125,7 +128,7 @@ function renderTree(node, prefix, isLast, counter, depth = 0, maxDepth = 4) {
       // Check if this child will be the last one we render due to limits
       let willBeLast = i === children.length - 1;
       
-      renderTree(children[i], prefix + extension, willBeLast, counter, depth + 1, maxDepth);
+      renderTree(children[i], prefix + extension, willBeLast, counter, limit, depth + 1, maxDepth);
       if (counter.maxReached) break;
     }
   } else {
@@ -170,6 +173,8 @@ export function render(result, options = {}) {
     rootPath,
     projectType,
     entryPoints,
+    configs = [],
+    scripts = [],
     tree,
     flatFiles,
     totalFolders,
@@ -201,6 +206,28 @@ export function render(result, options = {}) {
     }
   }
 
+  // ── Configuration Files ───────────────────────────────────────────────────
+  section('⚙️', 'Configuration Files');
+  if (configs.length === 0) {
+    console.log(paint('  No configuration files detected', C.dim));
+  } else {
+    for (const c of configs) {
+      console.log(`  ${paint(c, C.white)}`);
+    }
+  }
+
+  // ── Package Scripts ───────────────────────────────────────────────────────
+  section('📜', 'Package Scripts');
+  if (scripts.length === 0) {
+    console.log(paint('  No package scripts detected', C.dim));
+  } else {
+    const maxNameLen = Math.max(...scripts.map(s => s.name.length));
+    for (const s of scripts) {
+      const paddedName = s.name.padEnd(maxNameLen, ' ');
+      console.log(`  ${paint(paddedName, C.white)}  ${paint(s.command, C.dim)}`);
+    }
+  }
+
   // ── Structure Preview ─────────────────────────────────────────────────────
   section('📁', `Folder Structure  ${paint(`(first ${PREVIEW_LIMIT} files)`, C.dim)}`);
 
@@ -228,3 +255,28 @@ export function render(result, options = {}) {
   console.log(paint('  ✅  Scan complete.', C.green));
   console.log('');
 }
+
+/**
+ * Render only the project structure for the --structure flag.
+ * 
+ * @param {import('../scanner/scan.js').ScanResult} result
+ */
+export function renderStructure(result) {
+  const { tree, flatFiles } = result;
+
+  console.log(paint('Project Structure:', C.bold, C.white));
+  console.log(paint(`${tree.name || '.'}/`, C.bold, C.blue));
+
+  const counter  = { count: 0, maxReached: false };
+  const children = tree.children ?? [];
+  const limit = flatFiles.length; // No preview limit for focused --structure
+
+  for (let i = 0; i < children.length; i++) {
+    if (counter.count >= limit) {
+      console.log(`└── ${paint('...', C.dim)}`);
+      break;
+    }
+    renderTree(children[i], '', i === children.length - 1, counter, limit, 0, Infinity);
+    if (counter.maxReached) break;
+  }
+}

package/src/renderers/html-renderer.js

@@ -625,6 +625,7 @@ const icon = {
   tree:    () => `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>`,
   bar:     () => `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="20" x2="18" y2="10"/><line x1="12" y1="20" x2="12" y2="4"/><line x1="6" y1="20" x2="6" y2="14"/></svg>`,
   info:    () => `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><line x1="12" y1="8" x2="12.01" y2="8"/></svg>`,
+  terminal: () => `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="4 17 10 11 4 5"/><line x1="12" y1="19" x2="20" y2="19"/></svg>`,
 };
 
 // ---------------------------------------------------------------------------
@@ -748,6 +749,82 @@ function renderEntryPoints(entryPoints) {
   </div>`;
 }
 
+/**
+ * Render the configuration files section.
+ *
+ * @param {string[]} configs
+ * @returns {string}
+ */
+function renderConfigurationFiles(configs) {
+  const count = configs.length;
+
+  const body = count === 0
+    ? `<p class="empty-msg">No configuration files detected.</p>`
+    : `<ul class="entry-list">
+        ${configs.map(c => `
+          <li class="entry-item">
+            <span class="entry-dot"></span>
+            ${esc(c)}
+          </li>`).join('')}
+       </ul>`;
+
+  const countBadge = count > 0
+    ? `<span class="section-count">${count} found</span>`
+    : '';
+
+  return `
+  <div class="section">
+    <div class="section-header">
+      <div class="section-icon">${icon.file()}</div>
+      <span class="section-title">Configuration Files</span>
+      ${countBadge}
+    </div>
+    <div class="section-body">${body}</div>
+  </div>`;
+}
+
+/**
+ * Render the package scripts section.
+ *
+ * @param {Array<{name: string, command: string}>} scripts
+ * @returns {string}
+ */
+function renderPackageScripts(scripts) {
+  const count = scripts.length;
+
+  const body = count === 0
+    ? `<p class="empty-msg" style="padding: 1.5rem">No package scripts detected.</p>`
+    : `<table class="data-table">
+        <thead>
+          <tr>
+            <th>Script</th>
+            <th>Command</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${scripts.map(s => `
+            <tr>
+              <td><code>${esc(s.name)}</code></td>
+              <td class="val-plain"><code>${esc(s.command)}</code></td>
+            </tr>`).join('')}
+        </tbody>
+       </table>`;
+
+  const countBadge = count > 0
+    ? `<span class="section-count">${count} found</span>`
+    : '';
+
+  return `
+  <div class="section">
+    <div class="section-header">
+      <div class="section-icon">${icon.terminal()}</div>
+      <span class="section-title">Package Scripts</span>
+      ${countBadge}
+    </div>
+    <div class="section-body" style="padding:0">${body}</div>
+  </div>`;
+}
+
 /**
  * Render the folder structure section with a dark <pre><code> tree.
  *
@@ -873,7 +950,7 @@ function renderFooter() {
  * @param {{ cwd?: string }} [options]
  */
 export function render(result, options = {}) {
-  const { rootPath, projectType, entryPoints, flatFiles } = result;
+  const { rootPath, projectType, entryPoints, configs = [], scripts = [], flatFiles } = result;
 
   const cwd      = options.cwd ?? process.cwd();
   const relRoot  = path.relative(cwd, rootPath) || '.';
@@ -898,6 +975,8 @@ export function render(result, options = {}) {
     <main>
       ${renderSummaryCards(result)}
       ${renderEntryPoints(entryPoints)}
+      ${renderConfigurationFiles(configs)}
+      ${renderPackageScripts(scripts)}
       ${renderFolderStructure(flatFiles, rootName)}
       ${renderStats(result)}
       ${renderScanInfo()}

package/src/renderers/json-renderer.js

@@ -26,6 +26,8 @@ export function render(result, options = {}) {
     rootPath,
     projectType,
     entryPoints,
+    configs = [],
+    scripts = [],
     tree,
     flatFiles,
     totalFolders,
@@ -47,6 +49,8 @@ export function render(result, options = {}) {
       scanDurationMs: Math.round(scanDurationMs),
     },
     entryPoints,
+    configs,
+    scripts,
     structure: (tree.children || []).map(mapTree)
   };
 

package/src/renderers/markdown-renderer.js

@@ -218,6 +218,50 @@ function sectionSummary(out, result, relRoot) {
   out.push('---');
 }
 
+/**
+ * @param {string[]} out
+ * @param {string[]} configs
+ */
+function sectionConfigurationFiles(out, configs) {
+  out.push('');
+  out.push('## Configuration Files');
+  out.push('');
+
+  if (configs.length === 0) {
+    out.push('No configuration files detected.');
+  } else {
+    for (const c of configs) {
+      out.push(`- ${c}`);
+    }
+  }
+
+  out.push('');
+  out.push('---');
+}
+
+/**
+ * @param {string[]} out
+ * @param {Array<{name: string, command: string}>} scripts
+ */
+function sectionPackageScripts(out, scripts) {
+  out.push('');
+  out.push('## Package Scripts');
+  out.push('');
+
+  if (scripts.length === 0) {
+    out.push('No package scripts detected.');
+  } else {
+    out.push('| Script | Command |');
+    out.push('|--------|---------|');
+    for (const s of scripts) {
+      out.push(`| \`${s.name}\` | \`${s.command}\` |`);
+    }
+  }
+
+  out.push('');
+  out.push('---');
+}
+
 /**
  * @param {string[]} out
  * @param {string[]} entryPoints
@@ -308,7 +352,7 @@ function sectionScanInfo(out) {
  * @param {{ cwd?: string }} [options]
  */
 export function render(result, options = {}) {
-  const { rootPath, entryPoints, flatFiles } = result;
+  const { rootPath, entryPoints, configs = [], scripts = [], flatFiles } = result;
 
   const cwd     = options.cwd ?? process.cwd();
   const relRoot  = path.relative(cwd, rootPath) || '.';
@@ -320,6 +364,8 @@ export function render(result, options = {}) {
   sectionTitle(out);
   sectionSummary(out, result, relRoot);
   sectionEntryPoints(out, entryPoints);
+  sectionConfigurationFiles(out, configs);
+  sectionPackageScripts(out, scripts);
   sectionFolderStructure(out, flatFiles, rootName);
   sectionStatistics(out, result);
   sectionScanInfo(out);

package/src/scanner/scan.js

@@ -20,6 +20,8 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
+import { detectConfigs } from '../detectors/config-detector.js';
+import { detectScripts } from '../detectors/script-detector.js';
 
 // ---------------------------------------------------------------------------
 // Constants
@@ -96,6 +98,8 @@ const PROJECT_TYPE_MARKERS = [
  * @property {string}              rootPath       - Absolute path that was scanned
  * @property {string}              projectType    - Detected project type label
  * @property {Array<string>}       entryPoints    - Relative paths of detected entry points
+ * @property {Array<string>}       configs        - Relative paths of detected config files
+ * @property {Array<{name: string, command: string}>} scripts - Parsed package scripts
  * @property {DirNode}             tree           - Full in-memory file tree
  * @property {Array<string>}       flatFiles      - All relative file paths (flat list)
  * @property {number}              totalFolders   - Total number of directories walked
@@ -453,6 +457,10 @@ export function scan(targetPath, options = {}) {
   const flatFiles   = [];
   /** @type {Array<string>} */
   let entryPoints = [];
+  /** @type {Array<string>} */
+  let configs = [];
+  /** @type {Array<{name: string, command: string}>} */
+  let scripts = [];
 
   const startTime   = performance.now();
   let tree;
@@ -465,6 +473,8 @@ export function scan(targetPath, options = {}) {
     // Count all directory nodes in the tree (excluding root itself).
     totalFolders = countFolders(tree) - 1;
     entryPoints = findEntryPoints(projectType, flatFiles, rootPath);
+    configs = detectConfigs(flatFiles).configs;
+    scripts = detectScripts(rootPath).scripts;
   } else if (stat.isFile()) {
     const relFilePath = toPosix(path.basename(rootPath));
     tree = {
@@ -481,6 +491,8 @@ export function scan(targetPath, options = {}) {
     };
     flatFiles.push(relFilePath);
     entryPoints = [relFilePath]; // A single file is its own entry point
+    configs = detectConfigs(flatFiles).configs;
+    scripts = detectScripts(path.dirname(rootPath)).scripts;
   } else {
     throw new Error(`Path is neither a file nor a directory: ${rootPath}`);
   }
@@ -491,6 +503,8 @@ export function scan(targetPath, options = {}) {
     rootPath,
     projectType,
     entryPoints,
+    configs,
+    scripts,
     tree,
     flatFiles,
     totalFolders,