@lakindu_perera/toren 1.0.3 → 1.0.4

package/README.md

@@ -62,6 +62,12 @@ 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
+
 # Lifecycle & Help Commands
 toren --help
 toren --version
@@ -74,6 +80,10 @@ 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. |
 | `--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,16 +93,33 @@ 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`) 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
+```
+
 ### 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
 ────────────────────────────────────────────────────────────────────────────────

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,20 @@ 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
+  --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 +147,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 +201,7 @@ function parseArgs() {
     '--uninstall',
     '--format',
     '--json',
+    ...FOCUSED_FLAGS,
     '--include-hidden',
     '--max-files',
   ]);
@@ -198,7 +216,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 +267,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.4",
   "description": "A powerful codebase scanner CLI tool for project analysis, framework detection, and understanding repository structure instantly.",
   "type": "module",
   "bin": {

package/src/focused-output.js

@@ -0,0 +1,71 @@
+/**
+ * @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'
+];
+
+/**
+ * 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;
+  }
+}

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 {
@@ -228,3 +231,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;
+  }
+}