@lakindu_perera/toren 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [1.0.9] - 2026-08-31
+### Changed
+- **TypeScript Foundation**: Completely migrated the entire Torén codebase from JavaScript to TypeScript.
+- **Zero Runtime Dependencies**: The CLI continues to operate natively on Node.js without needing ts-node or any other runtime bundlers. Source code is compiled to `.js` files using ES2022 targets.
+- **Build & CI Improvements**: Set up robust static type-checking and automated build steps using `tsc`.
+
+
 
 ## [1.0.7] - 2026-08-29
 ### Added

package/dist/cli/toren.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Toren CLI — Entry Point
+ *
+ * Usage:
+ *   toren [path]              Scan <path> (defaults to current directory)
+ *   toren --format <type>     Select output format (default: console)
+ *   toren --json              Legacy alias for --format json
+ *   toren --version           Print version
+ *   toren --help              Print usage
+ *   toren --doctor            Check global installation health
+ *   toren --uninstall         Safely remove global installation
+ *   toren --include-hidden    Include hidden files (dot-files) in scan
+ *   toren --max-files <N>     Override the max file scan limit
+ *
+ * Adding a new output format
+ * ──────────────────────────
+ *   1. Create src/renderers/<format>-renderer.js
+ *      and export: render(result, options?) => void
+ *   2. Register it in src/renderers/index.js
+ *
+ *   No changes to this file are required.
+ */
+export {};

package/dist/cli/toren.js

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Toren CLI — Entry Point
+ *
+ * Usage:
+ *   toren [path]              Scan <path> (defaults to current directory)
+ *   toren --format <type>     Select output format (default: console)
+ *   toren --json              Legacy alias for --format json
+ *   toren --version           Print version
+ *   toren --help              Print usage
+ *   toren --doctor            Check global installation health
+ *   toren --uninstall         Safely remove global installation
+ *   toren --include-hidden    Include hidden files (dot-files) in scan
+ *   toren --max-files <N>     Override the max file scan limit
+ *
+ * Adding a new output format
+ * ──────────────────────────
+ *   1. Create src/renderers/<format>-renderer.js
+ *      and export: render(result, options?) => void
+ *   2. Register it in src/renderers/index.js
+ *
+ *   No changes to this file are required.
+ */
+import { createRequire } from 'node:module';
+import { scan } from '../scanner/scan.js';
+import renderers from '../renderers/index.js';
+import { getFocusedModeInfo, renderFocusedMode, FOCUSED_FLAGS } from '../focused-output.js';
+import { runDoctor, runUninstall } from '../lifecycle.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+/** Format used when no --format flag is supplied. */
+const DEFAULT_FORMAT = 'console';
+/** Derived from the registry — always in sync with available renderers. */
+const SUPPORTED_FORMATS = Object.keys(renderers);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function printError(title, message, detailLabel, detailValue) {
+    console.error(`\x1b[31m✖ ${title}\x1b[0m\n`);
+    console.error(`${message}\n`);
+    if (detailLabel && detailValue) {
+        console.error(`${detailLabel}:\n`);
+        console.error(`${detailValue}\n`);
+    }
+}
+function printHelp() {
+    const formatList = SUPPORTED_FORMATS.map(f => {
+        const suffix = f === DEFAULT_FORMAT ? '  (default)' : '';
+        return `  --format ${f.padEnd(10)}${suffix}`;
+    }).join('\n');
+    console.log(`
+\x1b[1mToren\x1b[0m v${pkg.version}
+Fast Repository Discovery CLI
+
+\x1b[1mUSAGE\x1b[0m
+  toren [path] [options]
+
+\x1b[1mCOMMANDS\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
+  --summary           Show project summary only
+  --important-files   Show important files only
+  --health            Show project health observations only
+  --include-hidden    Include hidden files and folders
+  --max-files <n>     Set scan file limit
+  --doctor            Run CLI diagnostics
+  --uninstall         Remove Toren global installation
+  --help              Show this help message
+  --version           Show version number
+
+\x1b[1mOUTPUT FORMATS\x1b[0m
+${formatList}
+
+\x1b[1mEXAMPLES\x1b[0m
+  toren .                              Scan the current directory
+  toren ./my-project                   Scan a specific project folder
+  toren --format json .                Output results as JSON
+  toren --format markdown . > out.md   Save a Markdown report to a file
+  toren --format html . > out.html     Save an HTML report to a file
+  toren . --configs                    Show project configuration files
+  toren . --frameworks                 Show detected frameworks
+`);
+}
+// ---------------------------------------------------------------------------
+// Argument parsing
+// ---------------------------------------------------------------------------
+/**
+ * @typedef {Object} ParsedArgs
+ * @property {'exit'|'wait'|'scan'} action
+ * @property {string}  [target]        - Resolved path to scan
+ * @property {string}  [format]        - Renderer format name
+ * @property {boolean} [includeHidden] - Whether to include hidden files
+ * @property {number}  [maxFiles]      - Max files to scan
+ */
+/**
+ * Parse process.argv into a structured options object.
+ *
+ * Returns { action: 'exit' } when the process should exit immediately.
+ * Returns { action: 'wait' } when an async interactive command is running.
+ * Returns { action: 'scan', target, format } for normal scan operations.
+ *
+ * @returns {ParsedArgs}
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    // ── Informational flags ─────────────────────────────────────────────────
+    if (args.includes('--help') || args.includes('-h')) {
+        printHelp();
+        return { action: 'exit', code: 0 };
+    }
+    if (args.includes('--version') || args.includes('-V') || args.includes('-v')) {
+        console.log(`Toren ${pkg.version}`);
+        return { action: 'exit', code: 0 };
+    }
+    // ── Lifecycle commands ──────────────────────────────────────────────────
+    if (args.includes('--doctor')) {
+        runDoctor(pkg.version);
+        return { action: 'exit', code: 0 };
+    }
+    if (args.includes('--uninstall')) {
+        runUninstall();
+        return { action: 'wait' };
+    }
+    // ── Output format ───────────────────────────────────────────────────────
+    // --json is a legacy alias for --format json, kept for backwards
+    // compatibility. It will be removed in a future major version.
+    let format = DEFAULT_FORMAT;
+    const formatIdx = args.indexOf('--format');
+    if (formatIdx !== -1) {
+        const nextToken = args[formatIdx + 1];
+        // If the next token is missing or starts with '-', the user omitted the value.
+        if (nextToken === undefined || nextToken.startsWith('-')) {
+            printError('Missing value', 'The --format flag requires a valid output format.', 'Supported formats', SUPPORTED_FORMATS.join(', '));
+            return { action: 'exit', code: 1 };
+        }
+        format = nextToken;
+    }
+    else if (args.includes('--json')) {
+        format = 'json';
+    }
+    // ── Focused Output Flags ────────────────────────────────────────────────
+    const focusedInfo = getFocusedModeInfo(args);
+    if (focusedInfo.error) {
+        printError(focusedInfo.title, focusedInfo.message, focusedInfo.detailLabel, focusedInfo.detailValue);
+        return { action: 'exit', code: 1 };
+    }
+    const focusedMode = focusedInfo.mode;
+    // ── Hidden files ────────────────────────────────────────────────────────
+    const includeHidden = args.includes('--include-hidden');
+    // ── Target path ─────────────────────────────────────────────────────────
+    // Build the set of tokens that are consumed as values by named flags so
+    // we don't accidentally treat them as the positional path argument.
+    const consumedValues = new Set();
+    if (formatIdx !== -1 && args[formatIdx + 1] !== undefined && !args[formatIdx + 1].startsWith('-')) {
+        consumedValues.add(args[formatIdx + 1]);
+    }
+    // ── Max files ───────────────────────────────────────────────────────────
+    let maxFiles = undefined;
+    const maxFilesIdx = args.indexOf('--max-files');
+    if (maxFilesIdx !== -1) {
+        const rawVal = args[maxFilesIdx + 1];
+        if (rawVal === undefined || rawVal.startsWith('-')) {
+            printError('Missing value', 'The --max-files flag requires a numeric value.', 'Example', 'toren --max-files 100000');
+            return { action: 'exit', code: 1 };
+        }
+        maxFiles = parseInt(rawVal, 10);
+        if (isNaN(maxFiles) || maxFiles < 1) {
+            printError('Invalid value', 'The --max-files flag must be a positive integer.', 'Provided value', rawVal);
+            return { action: 'exit', code: 1 };
+        }
+        consumedValues.add(rawVal);
+    }
+    // First non-flag, non-consumed token is the target path; default to cwd.
+    const target = args.find(a => !a.startsWith('-') && !consumedValues.has(a)) ?? '.';
+    // ── Unknown flag check ──────────────────────────────────────────────────
+    const knownFlags = new Set([
+        '--help', '-h',
+        '--version', '-V', '-v',
+        '--doctor',
+        '--uninstall',
+        '--format',
+        '--json',
+        ...FOCUSED_FLAGS,
+        '--include-hidden',
+        '--max-files',
+    ]);
+    const unknownFlag = args.find(a => a.startsWith('-') && !knownFlags.has(a) && !consumedValues.has(a));
+    if (unknownFlag) {
+        printError('Unknown option', 'An unrecognized flag was provided.', 'Flag', unknownFlag);
+        return { action: 'exit', code: 1 };
+    }
+    return { action: 'scan', target, format, includeHidden, maxFiles, focusedMode };
+}
+// ---------------------------------------------------------------------------
+// Format validation
+// ---------------------------------------------------------------------------
+/**
+ * Assert that `format` has a registered renderer.
+ * Prints a descriptive error message and exits with code 1 if not found.
+ *
+ * @param {string} format
+ */
+function assertValidFormat(format) {
+    if (renderers[format])
+        return;
+    printError('Unsupported output format', 'The requested output format is not supported.', 'Format', format);
+    process.exit(1);
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+(function main() {
+    const parsed = parseArgs();
+    if (parsed.action === 'exit') {
+        process.exit(parsed.code ?? 0);
+    }
+    if (parsed.action === 'wait')
+        return;
+    // Validate before scanning — fail fast on bad format names.
+    assertValidFormat(parsed.format);
+    const render = renderers[parsed.format];
+    try {
+        const result = scan(parsed.target, {
+            includeHidden: parsed.includeHidden,
+            maxFiles: parsed.maxFiles,
+        });
+        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') {
+            console.error(JSON.stringify({ error: err.message }, null, 2));
+        }
+        else {
+            if (err.title) {
+                printError(err.title, err.message, err.detailLabel, err.detailValue);
+            }
+            else {
+                printError('Scan failed', err.message);
+            }
+        }
+        process.exit(1);
+    }
+})();
+//# sourceMappingURL=toren.js.map

package/dist/cli/toren.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toren.js","sourceRoot":"","sources":["../../src/cli/toren.ts"],"names":[],"mappings":"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"}

package/dist/detectors/config-detector.d.ts

@@ -0,0 +1,3 @@
+export declare function detectConfigs(flatFiles: string[]): {
+    configs: string[];
+};

package/dist/detectors/config-detector.js

@@ -0,0 +1,58 @@
+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) {
+        if (file.includes('/'))
+            continue;
+        for (const pattern of configPatterns) {
+            if (pattern.test(file)) {
+                matchedSet.add(file);
+                break;
+            }
+        }
+    }
+    const configs = Array.from(matchedSet).sort();
+    return { configs };
+}
+//# sourceMappingURL=config-detector.js.map

package/dist/detectors/config-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-detector.js","sourceRoot":"","sources":["../../src/detectors/config-detector.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,SAAmB;IAC/C,MAAM,cAAc,GAAa;QAC/B,UAAU;QACV,iBAAiB;QACjB,sBAAsB;QACtB,mBAAmB;QACnB,cAAc;QACd,cAAc;QAEd,aAAa;QACb,kBAAkB;QAClB,kBAAkB;QAElB,WAAW;QACX,8BAA8B;QAC9B,8BAA8B;QAC9B,8BAA8B;QAC9B,+BAA+B;QAC/B,iBAAiB;QAEjB,QAAQ;QACR,iCAAiC;QACjC,gCAAgC;QAChC,eAAe;QACf,YAAY;QAEZ,UAAU;QACV,kCAAkC;QAClC,iCAAiC;QAEjC,OAAO;QACP,gCAAgC;QAChC,gBAAgB;QAChB,kCAAkC;QAClC,kBAAkB;QAElB,UAAU;QACV,YAAY;QACZ,iBAAiB;QACjB,sBAAsB;QAEtB,YAAY;QACZ,qBAAqB;QACrB,mBAAmB;QACnB,eAAe;QACf,WAAW;QAEX,aAAa;QACb,cAAc;QACd,yBAAyB;KAC1B,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAEjC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/detectors/health-detector.d.ts

@@ -0,0 +1,12 @@
+import type { HealthObservation, ScriptInfo, ImportantFile } from '../types/index.js';
+interface DetectHealthOptions {
+    flatFiles: string[];
+    configs: string[];
+    importantFiles: ImportantFile[];
+    scripts: ScriptInfo[];
+    projectType: string;
+}
+export declare function detectHealth({ flatFiles, configs, importantFiles, scripts, projectType }: DetectHealthOptions): {
+    health: HealthObservation[];
+};
+export {};

package/dist/detectors/health-detector.js

@@ -0,0 +1,53 @@
+export function detectHealth({ flatFiles, configs, importantFiles, scripts, projectType }) {
+    const health = [];
+    const fileSet = new Set(flatFiles);
+    // README
+    if (fileSet.has('README.md') || fileSet.has('README') || fileSet.has('readme.md')) {
+        health.push({ id: 'readme', status: 'pass', message: 'README found' });
+    }
+    else {
+        health.push({ id: 'readme', status: 'warning', message: 'README not found' });
+    }
+    // LICENSE
+    if (fileSet.has('LICENSE') || fileSet.has('LICENSE.md') || fileSet.has('LICENSE.txt')) {
+        health.push({ id: 'license', status: 'pass', message: 'LICENSE found' });
+    }
+    else {
+        health.push({ id: 'license', status: 'warning', message: 'LICENSE not found' });
+    }
+    // ENVIRONMENT EXAMPLE
+    if (fileSet.has('.env.example') || fileSet.has('.env.sample')) {
+        health.push({ id: 'env-example', status: 'pass', message: 'Environment example found' });
+    }
+    // TESTS
+    const hasTestFiles = flatFiles.some(f => f.startsWith('test/') ||
+        f.startsWith('tests/') ||
+        f.startsWith('__tests__/') ||
+        f.includes('.test.') ||
+        f.includes('.spec.'));
+    const hasTestScripts = (scripts || []).some(s => s.category === 'testing' || s.name === 'test');
+    if (hasTestFiles || hasTestScripts) {
+        health.push({ id: 'tests', status: 'pass', message: 'Tests detected' });
+    }
+    // LINTER
+    const hasLinter = (configs || []).some(c => c.includes('eslint') ||
+        c.includes('biome') ||
+        c.includes('stylelint')) || (scripts || []).some(s => s.category === 'quality' || s.name === 'lint');
+    if (hasLinter) {
+        health.push({ id: 'lint', status: 'pass', message: 'Linter detected' });
+    }
+    // TYPESCRIPT
+    if (fileSet.has('tsconfig.json')) {
+        health.push({ id: 'typescript', status: 'pass', message: 'TypeScript configuration found' });
+    }
+    // GIT
+    if (fileSet.has('.gitignore')) {
+        health.push({ id: 'git', status: 'info', message: '.gitignore found' });
+    }
+    // DOCKER
+    if (fileSet.has('Dockerfile') || fileSet.has('docker-compose.yml') || fileSet.has('compose.yml')) {
+        health.push({ id: 'docker', status: 'info', message: 'Docker configuration found' });
+    }
+    return { health };
+}
+//# sourceMappingURL=health-detector.js.map

package/dist/detectors/health-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-detector.js","sourceRoot":"","sources":["../../src/detectors/health-detector.ts"],"names":[],"mappings":"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"}

package/dist/detectors/important-files-detector.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Toren — Important File Detector
+ *
+ * Identifies the most strategically significant files in a project, based
+ * on the already-scanned flat file list and detected project context.
+ *
+ * Design contract:
+ *  - Pure function. Uses only the data already produced by scan().
+ *  - No filesystem I/O. No directory traversal.
+ *  - Deterministic: same input always produces the same output.
+ *  - No duplicates: each path appears at most once (highest priority wins).
+ *  - Sorted: highest priority first; ties broken alphabetically by path.
+ *  - Never returns null; importantFiles is always an array.
+ *  - Framework-specific files are only marked important when they exist.
+ *
+ * Priority anchors:
+ *  100 – Project manifest (package.json, pom.xml, Cargo.toml, …)
+ *   95 – Primary documentation (README.md)
+ *   90 – Primary detected entry point
+ *   85 – Framework configuration (next.config.*, vite.config.*, …)
+ *   82 – App-level framework files (root layout, root page, …)
+ *   80 – Environment documentation (.env.example)
+ *   78 – Secondary framework files (middleware, server entry)
+ *   75 – TypeScript / language config
+ *   72 – Project-specific config (routes, config/application)
+ *   70 – Container (Dockerfile)
+ *   68 – Container orchestration (docker-compose)
+ *
+ * @module detectors/important-files-detector
+ */
+/**
+ * Detect strategically important files in a scanned project.
+ *
+ * Uses only data already produced by scan() — no new filesystem operations.
+ *
+ * @param {Object}   params
+ * @param {string[]} params.flatFiles    - All relative POSIX file paths from the scanner
+ * @param {string}   params.projectType  - Detected project type (e.g. 'React', 'Go')
+ * @param {string[]} params.entryPoints  - Detected entry point paths
+ * @param {string[]} params.configs      - Detected configuration file paths
+ * @returns {{ importantFiles: ImportantFile[] }}
+ */
+import type { ImportantFile } from "../types/index.js";
+export declare function detectImportantFiles({ flatFiles, projectType, entryPoints, configs }: {
+    flatFiles: string[];
+    projectType: string;
+    entryPoints: string[];
+    configs: string[];
+}): {
+    importantFiles: ImportantFile[];
+};