flamerjs 1.1.3 → 1.1.4

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to flamer are recorded here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.4] - 2026-10-24
+
+### Added
+
+- Added `--verbose` output with the CLI version, repository name, selected
+  backend, scan path, file and line counts, duration, and native fallback
+  details.
+
 ## [1.1.3] - 2026-10-24
 
 ### Fixed

package/README.md

@@ -4,11 +4,10 @@
 
 [![CI](https://img.shields.io/github/actions/workflow/status/dummy3ye/flamer/ci.yml?branch=master&style=for-the-badge&label=CI&labelColor=101418&color=9ccbfb)](https://github.com/dummy3ye/flamer/actions/workflows/ci.yml)
 [![Coverage](https://img.shields.io/codecov/c/github/dummy3ye/flamer?style=for-the-badge&label=coverage&labelColor=101418&color=b9c8da)](https://codecov.io/gh/dummy3ye/flamer)
-[![npm](https://img.shields.io/npm/v/flamerjs?style=for-the-badge&labelColor=101418&color=d3bfe6)](https://www.npmjs.com/package/flamerjs)<br>
+[![GitHub repo size](https://img.shields.io/github/repo-size/dummy3ye/flamer?style=for-the-badge&labelColor=101418&color=d3bfe6)](https://github.com/dummy3ye/flamer)<br>
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge&labelColor=101418&color=d3bfe6)](LICENSE)
 [![GitHub last commit](https://img.shields.io/github/last-commit/dummy3ye/flamer?style=for-the-badge&labelColor=101418&color=9ccbfb)](https://github.com/dummy3ye/flamer/commits/master)
-[![GitHub Repo stars](https://img.shields.io/github/stars/dummy3ye/flamer?style=for-the-badge&labelColor=101418&color=b9c8da)](https://github.com/dummy3ye/flamer/stargazers)
-[![GitHub repo size](https://img.shields.io/github/repo-size/dummy3ye/flamer?style=for-the-badge&labelColor=101418&color=d3bfe6)](https://github.com/dummy3ye/flamer)
+[![npm](https://img.shields.io/npm/v/flamerjs?style=for-the-badge&labelColor=101418&color=d3bfe6)](https://www.npmjs.com/package/flamerjs)
 
 Flamer scans a repository for the common mistakes that appear when software is
 assembled quickly with AI or other “vibe coding” workflows: unfinished
@@ -124,6 +123,7 @@ flamerjs [path] [options]
 | `--no-lockfile-warning`                 | Suppress the missing-lockfile suggestion                                      |
 | `--ignore-dir <name>`                   | Ignore an additional directory name; repeatable                               |
 | `--quiet`                               | Suppress the human summary                                                    |
+| `--verbose`                             | Show CLI version, runtime backend, and scan details                           |
 | `--color`                               | Force ANSI colors                                                             |
 | `--no-color`                            | Disable ANSI colors                                                           |
 | `--engine <all\|typescript\|rust\|cpp>` | Run all engines (default) or select one engine                                |

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { writeFileSync, existsSync as existsSync4 } from "fs";
+import { writeFileSync, existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
 import { resolve, basename } from "path";
 
 // src/util/fs.ts
@@ -3003,6 +3003,7 @@ function runNativeWorker(root, files, worker, operation = "file_metrics") {
 
 // src/cli.ts
 var SPEC_VERSION = 1;
+var CLI_VERSION = JSON.parse(readFileSync2(new URL("../package.json", import.meta.url), "utf8")).version;
 function parseArgs(argv) {
   const opts = {
     root: process.cwd(),
@@ -3014,6 +3015,7 @@ function parseArgs(argv) {
     noGit: false,
     noLockfileWarning: false,
     quiet: false,
+    verbose: false,
     scope: null,
     listLanguages: false,
     help: false,
@@ -3058,6 +3060,9 @@ function parseArgs(argv) {
       case "--quiet":
         opts.quiet = true;
         break;
+      case "--verbose":
+        opts.verbose = true;
+        break;
       case "--color":
         opts.color = true;
         break;
@@ -3111,6 +3116,7 @@ Options:
   --no-lockfile-warning      skip the "no lockfile" suggestion
   --ignore-dir <name>        also skip this directory name (repeatable)
   --quiet                    suppress the human summary
+  --verbose                  show runtime engine and scan details
   --color                    force ANSI colors
   --no-color                 disable ANSI colors
   --engine <all|typescript|rust|cpp>
@@ -3379,13 +3385,50 @@ function severityColor(severity) {
 function severityIcon(severity) {
   return severity === "LOW" ? "\xB7" : severity === "INFO" ? "i" : "!";
 }
-function printSummary(report, forceColor) {
+function printVerbose(report, forceColor) {
+  const enabled = colorEnabled(forceColor);
+  const native = report.metadata.native;
+  let backend = "typescript";
+  let backendDetail = "TypeScript analyzers";
+  if (native?.fallback) {
+    backendDetail = "TypeScript fallback";
+  } else if (native?.engine === "all") {
+    backend = "rust + cpp";
+    backendDetail = "Rust and C++ workers";
+  } else if (native?.engine === "rust") {
+    backend = "rust";
+    backendDetail = "Rust worker";
+  } else if (native?.engine === "cpp") {
+    backend = "cpp";
+    backendDetail = "C++ worker";
+  }
+  const p = report.project;
+  const lines = [
+    "",
+    ` ${paint(`flamer.js v${CLI_VERSION}`, ANSI.bold + ANSI.cyan, enabled)} ${paint(p.name, ANSI.bold, enabled)}`,
+    ` ${paint("cli", ANSI.dim, enabled)}      : typescript`,
+    ` ${paint("backend", ANSI.dim, enabled)}  : ${backend}`,
+    ` ${paint("details", ANSI.dim, enabled)}   : ${backendDetail}`,
+    ` ${paint("path", ANSI.dim, enabled)}      : ${p.root || p.name}`,
+    ` ${paint("files", ANSI.dim, enabled)}     : ${(p.totalFiles || 0).toLocaleString()}`,
+    ` ${paint("lines", ANSI.dim, enabled)}     : ${(p.totalLines || 0).toLocaleString()}`,
+    ` ${paint("duration", ANSI.dim, enabled)}  : ${report.metadata.durationSeconds.toFixed(2)}s`
+  ];
+  if (native?.fallback) {
+    lines.push(
+      ` ${paint("fallback", ANSI.dim, enabled)}  : ${[...new Set(native.fallback)].join("; ")}`
+    );
+  }
+  process.stdout.write(lines.join("\n") + "\n");
+}
+function printSummary(report, forceColor, verbose = false) {
   const enabled = colorEnabled(forceColor);
   const p = report.project;
   const out = [];
   const width = 62;
   const duration = report.metadata.durationSeconds;
   out.push("");
+  if (verbose) printVerbose(report, forceColor);
   out.push(
     ` ${paint("FLAMER", ANSI.bold + ANSI.cyan, enabled)}  ${paint(p.name, ANSI.bold, enabled)}`
   );
@@ -3458,7 +3501,7 @@ async function main() {
     }
   }
   if (opts.format === "summary") {
-    if (!opts.quiet) printSummary(report, opts.color);
+    if (!opts.quiet) printSummary(report, opts.color, opts.verbose);
   } else {
     process.stdout.write(json + "\n");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flamerjs",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Language-agnostic code health auditor that walks a repository once and reports what is wrong with it",
   "license": "MIT",
   "type": "module",