@lakindu_perera/toren 1.0.10 → 1.1.1

package/CHANGELOG.md

@@ -5,6 +5,26 @@ 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.1.1] - 2026-09-13
+### Changed
+- **Accuracy and Confidence Scoring**: Evidence scoring logic has been centralized and optimized.
+- **Minimum Evidence Requirements**: A secondary guard prevents false-positive detections from weak signals (like config files) if strong signals (like package manager dependencies) are missing.
+- **Deduplication and Determinism**: Evidence lists and technology output order are now guaranteed to be perfectly deterministic and deduplicated.
+- **Renderer Hardening and XSS Protection**: Technology stack output is now fully integrated into Markdown and HTML outputs, with strict escaping applied to protect against XSS vulnerabilities.
+- **Extensive Test Coverage**: Added comprehensive false-positive and deterministic regression test suites. Over 150+ new tests added.
+
+
+## [1.1.0] - 2026-09-09
+### Added
+- Technology Stack detector for Testing, Build, Quality, Container, and Deployment tools.
+- `--tech-stack` (and `--stack` alias) CLI flag for focused technology breakdown.
+- Technology Stack section included in JSON, Console, Markdown, and HTML outputs.
+- **Backend Framework Detection**: Detects Node.js (Express, Fastify, NestJS, Koa, Hapi), Python (Django, Flask, FastAPI), Java (Spring Boot), PHP (Laravel), and Ruby (Rails) backends using package dependency and structural file evidence only.
+- **Database Detection**: Detects PostgreSQL, MySQL, MariaDB, SQLite, MongoDB, and Redis from package dependencies and config/schema files. Never reads `.env` files or credentials.
+- **ORM / Data-Access Detection**: Independently detects Prisma, Drizzle, TypeORM, Sequelize, Mongoose, Knex, SQLAlchemy, Hibernate, Django ORM, Eloquent, and Active Record. ORMs are never inferred from database type and vice-versa.
+- **Safety Guarantees**: `.env`, `.env.*` secret files are never read or inspected. Database URLs and credentials are never used as evidence. All signals are structural (package names, file presence, config files).
+- **128 new tests** covering all backend, database, ORM detectors plus false-positive guards, `.env` safety, category ordering, and `scan()` integration fixtures.
+
 ## [1.0.10] - 2026-09-06
 ### Added
 - **Full Tree Output**: Added a new `--all` (or `-a`) flag to the CLI. This flag bypasses the default display limit and prints the complete directory tree without hiding any files or folders, making it easier to view, copy, or document the entire file structure.

package/README.md

@@ -74,6 +74,7 @@ toren --scripts
 toren --summary
 toren --important-files
 toren --health
+toren --stack
 
 # Lifecycle & Help Commands
 toren --help
@@ -96,6 +97,7 @@ toren --uninstall
 | `--summary` | Show project summary only. |
 | `--important-files` | Show important files only. |
 | `--health` | Show project health observations only. |
+| `--stack`, `--tech-stack` | Show detected technology stack 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. |

package/dist/cli/toren.js

@@ -64,7 +64,8 @@ Fast Repository Discovery CLI
   --scripts           Show available package scripts only
   --summary           Show project summary only
   --important-files   Show important files only
-  --health            Show project health observations only
+  --health            Show project health observations
+  --stack, --tech-stack Show detected technology stack only
   --include-hidden    Include hidden files and folders
   --all, -a           Show complete directory tree without limits
   --max-files <n>     Set scan file limit

package/dist/cli/toren.js.map

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

package/dist/detectors/evidence-weights.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview Toren — Centralized Evidence Weight Model (v1.1.1)
+ *
+ * Single source of truth for evidence confidence contributions.
+ * All technology detection rules MUST reference these weights rather than
+ * embedding raw numbers independently.
+ *
+ * Design principles:
+ *  - Deterministic: same evidence always yields the same weight.
+ *  - Strongly typed: TechnologyEvidenceType is the key.
+ *  - Immutable: `as const` prevents accidental mutation.
+ *  - Capped externally: callers cap the total at 1.0 via `capConfidence()`.
+ *  - Zero runtime dependencies.
+ *
+ * Evidence strength tiers:
+ *  STRONG   (≥ 0.60): dependency, devDependency, peerDependency, manifest
+ *    - A single strong signal alone crosses the 0.60 detection threshold.
+ *    - Suitable for package.json entries and canonical manifest files.
+ *  MODERATE (0.20–0.25): config, script
+ *    - Provides meaningful supporting evidence but cannot stand alone.
+ *  WEAK     (0.10–0.15): file, directory
+ *    - Supplements strong detections but never creates one independently.
+ *
+ * @module detectors/evidence-weights
+ */
+import type { TechnologyEvidenceType } from '../types/index.js';
+/**
+ * Confidence contribution for each evidence kind.
+ *
+ * Values chosen to satisfy the following invariants:
+ *  1. One strong signal alone (dep/devDep/peerDep/manifest) crosses 0.60 threshold.
+ *  2. One weak signal alone (file/dir) does NOT cross 0.60 threshold.
+ *  3. One config alone (0.25) does NOT cross 0.60 threshold.
+ *  4. dep(0.60) + config(0.25) = 0.85 — consistent with existing tests.
+ *  5. dep(0.60) + config(0.25) + file(0.15) = 1.00 — consistent with existing tests.
+ *  6. peerDep(0.55) alone crosses 0.60 — WAIT, 0.55 < 0.60. Let peers be 0.60 too for
+ *     backwards compat, or use a nuanced threshold. We keep peerDep = 0.60 for now.
+ */
+export declare const EVIDENCE_WEIGHTS: {
+    /** Direct runtime dependency in package.json `dependencies`. */
+    readonly dependency: 0.6;
+    /** Development dependency in package.json `devDependencies`. */
+    readonly devDependency: 0.6;
+    /** Peer dependency in package.json `peerDependencies`. */
+    readonly peerDependency: 0.6;
+    /** A recognised framework/tool configuration file (e.g. tailwind.config.ts). */
+    readonly config: 0.25;
+    /** A specific file whose presence indicates a technology (e.g. schema.prisma). */
+    readonly file: 0.15;
+    /** A specific directory whose presence supports detection (supplementary only). */
+    readonly directory: 0.15;
+    /** A package.json script keyword that invokes a tool. */
+    readonly script: 0.15;
+    /**
+     * A non-package.json manifest file (e.g. Dockerfile, Gemfile, manage.py).
+     * Treated as strong evidence, equivalent to a direct dependency.
+     */
+    readonly manifest: 0.6;
+};
+/** Ordered list of evidence types from strongest to weakest. */
+export declare const EVIDENCE_TYPE_ORDER: TechnologyEvidenceType[];
+/** Evidence types that are considered "strong" (≥ 0.60 threshold by themselves). */
+export declare const STRONG_EVIDENCE_TYPES: Set<TechnologyEvidenceType>;
+/**
+ * Returns the confidence weight for a given evidence type.
+ *
+ * @param type - The evidence kind to look up.
+ * @returns The confidence contribution in the range [0, 1].
+ *
+ * @example
+ * getEvidenceWeight('dependency')   // 0.60
+ * getEvidenceWeight('config')       // 0.25
+ * getEvidenceWeight('directory')    // 0.15
+ */
+export declare function getEvidenceWeight(type: TechnologyEvidenceType): number;
+/**
+ * Returns true if the evidence type is considered "strong" — i.e., a single
+ * piece of this evidence alone can cross the detection threshold.
+ *
+ * @param type - The evidence kind to check.
+ */
+export declare function isStrongEvidence(type: TechnologyEvidenceType): boolean;
+/**
+ * Cap a raw confidence score at exactly 1.0 and round to 2 decimal places
+ * to avoid floating-point representation issues (e.g. 0.8500000000000001).
+ *
+ * Rounding is applied BEFORE the cap so the cap always produces a clean 1.00.
+ *
+ * @param rawScore - Accumulated raw score (may exceed 1.0).
+ * @returns Confidence in [0.00, 1.00] rounded to 2 decimal places.
+ */
+export declare function capConfidence(rawScore: number): number;
+/**
+ * Returns the sort rank for an evidence type used in deterministic ordering.
+ * Lower rank = displayed first.
+ *
+ * Ordering: dependency < devDependency < peerDependency < manifest <
+ *           config < script < file < directory
+ * Within the same type, values are sorted alphabetically.
+ */
+export declare function evidenceTypeRank(type: TechnologyEvidenceType): number;

package/dist/detectors/evidence-weights.js

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Toren — Centralized Evidence Weight Model (v1.1.1)
+ *
+ * Single source of truth for evidence confidence contributions.
+ * All technology detection rules MUST reference these weights rather than
+ * embedding raw numbers independently.
+ *
+ * Design principles:
+ *  - Deterministic: same evidence always yields the same weight.
+ *  - Strongly typed: TechnologyEvidenceType is the key.
+ *  - Immutable: `as const` prevents accidental mutation.
+ *  - Capped externally: callers cap the total at 1.0 via `capConfidence()`.
+ *  - Zero runtime dependencies.
+ *
+ * Evidence strength tiers:
+ *  STRONG   (≥ 0.60): dependency, devDependency, peerDependency, manifest
+ *    - A single strong signal alone crosses the 0.60 detection threshold.
+ *    - Suitable for package.json entries and canonical manifest files.
+ *  MODERATE (0.20–0.25): config, script
+ *    - Provides meaningful supporting evidence but cannot stand alone.
+ *  WEAK     (0.10–0.15): file, directory
+ *    - Supplements strong detections but never creates one independently.
+ *
+ * @module detectors/evidence-weights
+ */
+// ---------------------------------------------------------------------------
+// Evidence weight table
+// ---------------------------------------------------------------------------
+/**
+ * Confidence contribution for each evidence kind.
+ *
+ * Values chosen to satisfy the following invariants:
+ *  1. One strong signal alone (dep/devDep/peerDep/manifest) crosses 0.60 threshold.
+ *  2. One weak signal alone (file/dir) does NOT cross 0.60 threshold.
+ *  3. One config alone (0.25) does NOT cross 0.60 threshold.
+ *  4. dep(0.60) + config(0.25) = 0.85 — consistent with existing tests.
+ *  5. dep(0.60) + config(0.25) + file(0.15) = 1.00 — consistent with existing tests.
+ *  6. peerDep(0.55) alone crosses 0.60 — WAIT, 0.55 < 0.60. Let peers be 0.60 too for
+ *     backwards compat, or use a nuanced threshold. We keep peerDep = 0.60 for now.
+ */
+export const EVIDENCE_WEIGHTS = {
+    /** Direct runtime dependency in package.json `dependencies`. */
+    dependency: 0.60,
+    /** Development dependency in package.json `devDependencies`. */
+    devDependency: 0.60,
+    /** Peer dependency in package.json `peerDependencies`. */
+    peerDependency: 0.60,
+    /** A recognised framework/tool configuration file (e.g. tailwind.config.ts). */
+    config: 0.25,
+    /** A specific file whose presence indicates a technology (e.g. schema.prisma). */
+    file: 0.15,
+    /** A specific directory whose presence supports detection (supplementary only). */
+    directory: 0.15,
+    /** A package.json script keyword that invokes a tool. */
+    script: 0.15,
+    /**
+     * A non-package.json manifest file (e.g. Dockerfile, Gemfile, manage.py).
+     * Treated as strong evidence, equivalent to a direct dependency.
+     */
+    manifest: 0.60,
+};
+// ---------------------------------------------------------------------------
+// Type helpers
+// ---------------------------------------------------------------------------
+/** Ordered list of evidence types from strongest to weakest. */
+export const EVIDENCE_TYPE_ORDER = [
+    'dependency',
+    'devDependency',
+    'peerDependency',
+    'manifest',
+    'config',
+    'script',
+    'file',
+    'directory',
+];
+/** Evidence types that are considered "strong" (≥ 0.60 threshold by themselves). */
+export const STRONG_EVIDENCE_TYPES = new Set([
+    'dependency',
+    'devDependency',
+    'peerDependency',
+    'manifest',
+]);
+// ---------------------------------------------------------------------------
+// API
+// ---------------------------------------------------------------------------
+/**
+ * Returns the confidence weight for a given evidence type.
+ *
+ * @param type - The evidence kind to look up.
+ * @returns The confidence contribution in the range [0, 1].
+ *
+ * @example
+ * getEvidenceWeight('dependency')   // 0.60
+ * getEvidenceWeight('config')       // 0.25
+ * getEvidenceWeight('directory')    // 0.15
+ */
+export function getEvidenceWeight(type) {
+    return EVIDENCE_WEIGHTS[type];
+}
+/**
+ * Returns true if the evidence type is considered "strong" — i.e., a single
+ * piece of this evidence alone can cross the detection threshold.
+ *
+ * @param type - The evidence kind to check.
+ */
+export function isStrongEvidence(type) {
+    return STRONG_EVIDENCE_TYPES.has(type);
+}
+/**
+ * Cap a raw confidence score at exactly 1.0 and round to 2 decimal places
+ * to avoid floating-point representation issues (e.g. 0.8500000000000001).
+ *
+ * Rounding is applied BEFORE the cap so the cap always produces a clean 1.00.
+ *
+ * @param rawScore - Accumulated raw score (may exceed 1.0).
+ * @returns Confidence in [0.00, 1.00] rounded to 2 decimal places.
+ */
+export function capConfidence(rawScore) {
+    // Round to 2 decimal places first to eliminate floating-point drift.
+    const rounded = Math.round(rawScore * 100) / 100;
+    return Math.min(rounded, 1.0);
+}
+/**
+ * Returns the sort rank for an evidence type used in deterministic ordering.
+ * Lower rank = displayed first.
+ *
+ * Ordering: dependency < devDependency < peerDependency < manifest <
+ *           config < script < file < directory
+ * Within the same type, values are sorted alphabetically.
+ */
+export function evidenceTypeRank(type) {
+    const idx = EVIDENCE_TYPE_ORDER.indexOf(type);
+    return idx === -1 ? EVIDENCE_TYPE_ORDER.length : idx;
+}
+//# sourceMappingURL=evidence-weights.js.map

package/dist/detectors/evidence-weights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-weights.js","sourceRoot":"","sources":["../../src/detectors/evidence-weights.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gEAAgE;IAChE,UAAU,EAAO,IAAI;IACrB,gEAAgE;IAChE,aAAa,EAAI,IAAI;IACrB,0DAA0D;IAC1D,cAAc,EAAG,IAAI;IACrB,gFAAgF;IAChF,MAAM,EAAW,IAAI;IACrB,kFAAkF;IAClF,IAAI,EAAa,IAAI;IACrB,mFAAmF;IACnF,SAAS,EAAQ,IAAI;IACrB,yDAAyD;IACzD,MAAM,EAAW,IAAI;IACrB;;;OAGG;IACH,QAAQ,EAAS,IAAI;CACoC,CAAC;AAE5D,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAA6B;IAC3D,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,WAAW;CACZ,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAyB;IACnE,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,UAAU;CACX,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM;AACN,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA4B;IAC5D,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA4B;IAC3D,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,qEAAqE;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACjD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA4B;IAC3D,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;AACvD,CAAC"}

package/dist/detectors/technology-stack-detector.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview Toren — Technology Stack Detector (v1.1.1)
+ *
+ * Detects the technology stack of a project using pre-collected scan context.
+ * Does NOT re-scan the repository or re-read package.json.
+ *
+ * Design contract:
+ *  - Consumes only the data already collected by scan() and passed in context.
+ *  - Deterministic: same input always produces the same ordered output.
+ *  - Confidence model (centralized in evidence-weights.ts):
+ *      dependency / devDependency / peerDependency → +0.60 (strong)
+ *      manifest                    → +0.60 (strong)
+ *      config file                 → +0.25 (moderate supporting)
+ *      script keyword              → +0.15 (weak supporting)
+ *      file                        → +0.15 (weak supporting)
+ *      directory                   → +0.15 (weak supporting)
+ *  - Confidence is rounded to 2 decimal places and capped at 1.0.
+ *  - Technologies below the CONFIDENCE_THRESHOLD (0.60) are suppressed.
+ *  - When multiple rules match the same technology, evidence is merged and
+ *    confidence is combined (capped), never producing duplicate entries.
+ *  - Evidence within a technology is deduplicated and sorted deterministically.
+ *  - Files under noise directories (examples/, fixtures/, demo/, samples/)
+ *    are deprioritised for file/directory evidence to reduce false positives
+ *    from nested example projects.
+ *  - Output is ordered by: category rank → confidence desc → name asc.
+
+ *
+ * Frontend technologies detected (Step 4):
+ *   React, Next.js, Vue, Nuxt, Angular, Svelte, SvelteKit, Astro, Remix
+ *
+ * Styling technologies detected (Step 4):
+ *   Tailwind CSS, Sass, Less, Styled Components, Emotion, Bootstrap,
+ *   Material UI, Chakra UI
+ *
+ * Backend technologies detected (Step 5):
+ *   Node.js: Express, Fastify, NestJS, Koa, Hapi
+ *   Python:  Django, Flask, FastAPI
+ *   Java:    Spring Boot
+ *   PHP:     Laravel
+ *   Ruby:    Rails
+ *
+ * Database technologies detected (Step 5):
+ *   PostgreSQL, MySQL, MariaDB, SQLite, MongoDB, Redis
+ *
+ * ORM / data-access tools detected (Step 5):
+ *   Prisma, Drizzle, TypeORM, Sequelize, Mongoose, Knex,
+ *   SQLAlchemy, Hibernate, Django ORM, Eloquent, Active Record
+ *
+ * Testing frameworks detected (Step 6):
+ *   Jest, Vitest, Mocha, Playwright, Cypress, Testing Library,
+ *   Pytest, JUnit
+ *
+ * Build tools detected (Step 6):
+ *   Vite, Webpack, Rollup, esbuild
+ *
+ * Quality tools detected (Step 6):
+ *   ESLint, Prettier, Biome, Stylelint
+ *
+ * Container tools detected (Step 6):
+ *   Docker, Docker Compose
+ *
+ * Deployment tools detected (Step 6):
+ *   Vercel, Netlify, Fly.io, Railway, Render,
+ *   Serverless Framework, AWS SAM
+ *
+ * False-positive / safety guards:
+ *   - Directory names alone never trigger framework detection.
+ *   - .env / secret files are NEVER read or scanned.
+ *   - Database URLs / credentials are NEVER used as evidence.
+ *   - ORM is never guessed from database type; each needs its own evidence.
+ *   - Plain CSS files are never reported as a technology framework.
+ *
+ * @module detectors/technology-stack-detector
+ */
+import type { TechnologyStack, PackageManager, ScriptInfo } from '../types/index.js';
+/**
+ * All information already collected by scan().
+ * The detector reuses this data — it never reads from disk again.
+ */
+export interface TechnologyDetectorContext {
+    /** Flat list of relative file paths (POSIX separators). */
+    flatFiles: string[];
+    /** Root-level config file names (already detected). */
+    configs: string[];
+    /** Enriched script entries. */
+    scripts: ScriptInfo[];
+    /** Detected package manager (or null). */
+    packageManager: PackageManager | null;
+    /** Detected project type string (e.g. "Next.js", "Node.js / TypeScript"). */
+    projectType: string;
+    /**
+     * Parsed package.json dependencies already available from a prior read.
+     * Keyed maps of name → version.
+     * Providing this avoids re-reading package.json.
+     */
+    packageManifest?: {
+        dependencies?: Record<string, string>;
+        devDependencies?: Record<string, string>;
+        peerDependencies?: Record<string, string>;
+    } | null;
+    /** Frameworks already detected by project-info-detector. */
+    existingFrameworks?: string[];
+}
+/**
+ * Detect the technology stack from already-collected scan context.
+ *
+ * @param context - Pre-collected scan data. No disk I/O is performed.
+ * @returns TechnologyStack with deduplicated, ordered, threshold-filtered
+ *          technologies.
+ */
+export declare function detectTechnologyStack(context: TechnologyDetectorContext): TechnologyStack;