@chemx/starter-kit 26.9.12-107 → 26.9.12-118

package/cli/audit/prompts.js

@@ -1,36 +1,19 @@
-import { groupViolationsByRule } from './reporter-grouping.js';
-
-const CYAN = '\x1b[38;2;98;201;255m';
-const BOLD = '\x1b[1m';
-const DIM = '\x1b[2m';
-const RESET = '\x1b[0m';
-
-const buildPathTree = (violations) => {
-  const root = { dirs: new Map(), files: new Map() };
-
-  for (const v of violations) {
-    const rawPath = v.filePath || '';
-    const normalized = rawPath.replace(/\\/g, '/').replace(/^\.\//, '');
-    const segments = normalized.split('/');
-    const fileName = segments.pop();
-
-    let current = root;
-    for (const seg of segments) {
-      const segName = seg.endsWith('/') ? seg : `${seg}/`;
-      if (!current.dirs.has(segName)) {
-        current.dirs.set(segName, { dirs: new Map(), files: new Map() });
-      }
-      current = current.dirs.get(segName);
-    }
-
-    if (!current.files.has(fileName)) {
-      current.files.set(fileName, []);
-    }
-    const loc = v.column ? `${v.line}:${v.column}` : `${v.line}`;
-    current.files.get(fileName).push(loc);
-  }
-
-  return root;
+import { groupViolationsByRule, buildPathTree } from './reporter-grouping.js';
+import {
+  CYAN,
+  YELLOW,
+  RED,
+  ORANGE,
+  DIM,
+  BOLD,
+  RESET
+} from './reporter-utils.js';
+
+const SEVERITY_COLORS = {
+  CRITICAL: RED,
+  HIGH: ORANGE,
+  MEDIUM: YELLOW,
+  LOW: DIM
 };
 
 const renderTreeLines = (node, depth = 0) => {
@@ -39,7 +22,7 @@ const renderTreeLines = (node, depth = 0) => {
 
   const sortedDirs = Array.from(node.dirs.entries()).sort((a, b) => a[0].localeCompare(b[0]));
   for (const [dirName, childNode] of sortedDirs) {
-    lines.push(`${indent}* ${dirName}`);
+    lines.push(`${indent}📁 ${BOLD}${dirName}${RESET}`);
     const childLines = renderTreeLines(childNode, depth + 1);
     lines.push(...childLines);
   }
@@ -47,7 +30,7 @@ const renderTreeLines = (node, depth = 0) => {
   const sortedFiles = Array.from(node.files.entries()).sort((a, b) => a[0].localeCompare(b[0]));
   for (const [fileName, locs] of sortedFiles) {
     const uniqueLocs = Array.from(new Set(locs)).join(', ');
-    lines.push(`${indent}- \`${fileName}:${uniqueLocs}\``);
+    lines.push(`${indent}- \`${YELLOW}${fileName}:${uniqueLocs}${RESET}\``);
   }
 
   return lines;
@@ -61,10 +44,11 @@ export const formatGroupedPromptViolations = (violations = []) => {
   const lines = [];
 
   ruleGroups.forEach((rg, idx) => {
+    const sevColor = SEVERITY_COLORS[rg.severity] || YELLOW;
     const countLabel = rg.total === 1 ? '1 item' : `${rg.total} items`;
-    lines.push(`${idx + 1}. [${rg.rule}] (${countLabel})`);
-    lines.push(`   Hazard: ${rg.hazard}`);
-    lines.push(`   Directive: ${rg.directive}`);
+    lines.push(`${idx + 1}. ${sevColor}[${rg.rule}]${RESET} ${BOLD}(${countLabel})${RESET}`);
+    lines.push(`   Hazard:    ${rg.hazard}`);
+    lines.push(`   Directive: ${CYAN}${rg.directive}${RESET}`);
     lines.push('   Locations:');
 
     const tree = buildPathTree(rg.violations);

package/cli/audit/reporter-grouping.d.ts

@@ -29,9 +29,15 @@ export interface RuleHazardSummary {
   readonly directories: readonly RuleDirectoryOccurrence[];
 }
 
+export interface PathTreeNode {
+  readonly dirs: Map<string, PathTreeNode>;
+  readonly files: Map<string, string[]>;
+}
+
 export declare function resolveDirectory(filePath?: string): string;
 export declare function groupViolationsByDirectory(violations?: readonly HazardViolation[]): readonly DirectoryHazardSummary[];
 export declare function groupViolationsByRule(violations?: readonly HazardViolation[]): readonly RuleHazardSummary[];
+export declare function buildPathTree(violations?: readonly HazardViolation[]): PathTreeNode;
 export declare function formatCompactLocations(violations: readonly HazardViolation[], maxShown?: number): string;
 export declare function renderGroupedViolationsTerminal(violations: readonly HazardViolation[]): string;
 export declare function formatDirectoryDistributionSection(report: AuditReport, themeColor?: string | null): string;

package/cli/audit/reporter-grouping.js

@@ -157,6 +157,34 @@ const resolveSeverityColor = (severity) => {
   return DIM;
 };
 
+export const buildPathTree = (violations = []) => {
+  const root = { dirs: new Map(), files: new Map() };
+
+  for (const v of violations) {
+    const rawPath = v.filePath || '';
+    const normalized = rawPath.replace(/\\/g, '/').replace(/^\.\//, '');
+    const segments = normalized.split('/');
+    const fileName = segments.pop();
+
+    let current = root;
+    for (const seg of segments) {
+      const segName = seg.endsWith('/') ? seg : `${seg}/`;
+      if (!current.dirs.has(segName)) {
+        current.dirs.set(segName, { dirs: new Map(), files: new Map() });
+      }
+      current = current.dirs.get(segName);
+    }
+
+    if (!current.files.has(fileName)) {
+      current.files.set(fileName, []);
+    }
+    const loc = v.column ? `${v.line}:${v.column}` : `${v.line}`;
+    current.files.get(fileName).push(loc);
+  }
+
+  return root;
+};
+
 export const formatCompactLocations = (violations, maxShown = 4) => {
   const formatLocationItem = (v) => {
     const base = path.basename(v.filePath);
@@ -186,7 +214,8 @@ export const renderGroupedViolationsTerminal = (violations) => {
 
     if (isSingleOccurrence) {
       const v = rg.violations[0];
-      lines.push(`   ${sevColor}[#${idx + 1} ${rg.severity}]${RESET} [${rg.rule}] ${YELLOW}${v.filePath}:${v.line}:${v.column}${RESET}`);
+      const colStr = v.column ? `:${v.column}` : '';
+      lines.push(`   ${sevColor}[#${idx + 1} ${rg.severity}]${RESET} [${rg.rule}] ${YELLOW}${v.filePath}:${v.line}${colStr}${RESET}`);
       lines.push(`      Hazard:    ${rg.hazard}`);
       lines.push(`      Directive: ${CYAN}${rg.directive}${RESET}\n`);
       return;
@@ -199,10 +228,24 @@ export const renderGroupedViolationsTerminal = (violations) => {
     lines.push(`      Directive: ${CYAN}${rg.directive}${RESET}`);
     lines.push(`      Locations:`);
 
-    for (const d of rg.directories) {
-      const locs = formatCompactLocations(d.violations, 4);
-      lines.push(`        📁 ${d.directory} (${d.count}): ${locs}`);
-    }
+    const tree = buildPathTree(rg.violations);
+    const renderTerminalTree = (node, depth = 0) => {
+      const indent = '        ' + '  '.repeat(depth);
+
+      const sortedDirs = Array.from(node.dirs.entries()).sort((a, b) => a[0].localeCompare(b[0]));
+      for (const [dirName, childNode] of sortedDirs) {
+        lines.push(`${indent}📁 ${BOLD}${dirName}${RESET}`);
+        renderTerminalTree(childNode, depth + 1);
+      }
+
+      const sortedFiles = Array.from(node.files.entries()).sort((a, b) => a[0].localeCompare(b[0]));
+      for (const [fileName, locs] of sortedFiles) {
+        const uniqueLocs = Array.from(new Set(locs)).join(', ');
+        lines.push(`${indent}- ${YELLOW}${fileName}:${uniqueLocs}${RESET}`);
+      }
+    };
+
+    renderTerminalTree(tree, 0);
     lines.push('');
   });
 

package/cli/audit/reporter.js

@@ -49,6 +49,7 @@ export {
   resolveDirectory,
   groupViolationsByDirectory,
   groupViolationsByRule,
+  buildPathTree,
   formatCompactLocations,
   renderGroupedViolationsTerminal,
   formatDirectoryDistributionSection

package/docs/CHANGELOG.md

@@ -20,7 +20,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### Added
 - Expanded AST static analysis engine with Pillars 8 to 11 (`cli/audit/extended-visitors.js`): added automated rules and visitors for Accessibility & Semantic Integrity (`A11Y_CLICKABLE_NON_SEMANTIC`, `A11Y_IMAGE_MISSING_ALT`), Security & Content Safety (`SECURITY_RAW_HTML_INJECTION`, `SECURITY_HARDCODED_SECRET`), Testing Discipline (`TEST_FAKE_GREEN`, `TEST_MISSING_COLOCATED`), and Naming Conventions (`NAMING_BARE_BOOLEAN`, `NAMING_HANDLER_PREFIX`).
-- Implemented nested bullet tree path-chain formatter (`formatGroupedPromptViolations` in `cli/audit/prompts.js`), clustering violations by rule and rendering folder hierarchy steps as indented bullet chains (`* app/` -> `* components/` -> `* molecules/` -> leaf files with line hits) to eliminate boilerplate repetitions and slash AI prompt token consumption by up to 85%.
+- Implemented nested bullet tree path-chain formatter (`formatGroupedPromptViolations` in `cli/audit/prompts.js` and `renderGroupedViolationsTerminal` in `cli/audit/reporter-grouping.js`), clustering violations by rule and rendering folder hierarchy steps as indented bullet chains with `📁` folder emojis and ANSI severity colors (`📁 app/` -> `📁 components/` -> `📁 molecules/` -> leaf files with line hits) to eliminate boilerplate repetitions and slash AI prompt token consumption by up to 85%.
 - Consolidated monolith refactoring action directives across `buildHotspotsPrompt`, `buildGradeFPrompt`, `buildGradeDPrompt`, and `buildGradeCPrompt`, stating action requirements once per section.
 - Added `{ excludeAiSlop }` filter options to grade prompt builders to prevent duplicate slop violation listings in `buildMasterPrompt`.
 - Added `{ includePrompt: false }` flag to `formatHotspotsSection` and `formatAiSlopSection` when rendered within full terminal report (`cli/audit/reporter.js`), preventing mid-report prompt box duplication before the master prompt.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chemx/starter-kit",
-  "version": "26.9.12-107",
+  "version": "26.9.12-118",
   "description": "Chemical X Protocol: Private drop-in architecture starter kit and capsule generator",
   "type": "module",
   "bin": {