@hyperfrontend/project-scope 0.1.0 → 0.2.1

package/cli/index.esm.js

@@ -10,7 +10,6 @@ import { existsSync, readFileSync, statSync, lstatSync, readdirSync } from 'node
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/console
  */
-// Capture references at module initialization time
 const _console = globalThis.console;
 /**
  * (Safe copy) Outputs a message to the console.
@@ -85,40 +84,6 @@ _console.timeEnd.bind(_console);
  */
 _console.timeLog.bind(_console);
 
-/**
- * Safe copies of Array built-in static methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/array
- */
-// Capture references at module initialization time
-const _Array = globalThis.Array;
-/**
- * (Safe copy) Determines whether the passed value is an Array.
- */
-const isArray = _Array.isArray;
-
-/**
- * Safe copies of JSON built-in methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/json
- */
-// Capture references at module initialization time
-const _JSON = globalThis.JSON;
-/**
- * (Safe copy) Converts a JavaScript Object Notation (JSON) string into an object.
- */
-const parse = _JSON.parse;
-/**
- * (Safe copy) Converts a JavaScript value to a JavaScript Object Notation (JSON) string.
- */
-const stringify = _JSON.stringify;
-
 /**
  * Safe copies of Object built-in methods.
  *
@@ -127,7 +92,6 @@ const stringify = _JSON.stringify;
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/object
  */
-// Capture references at module initialization time
 const _Object = globalThis.Object;
 /**
  * (Safe copy) Prevents modification of existing property attributes and values,
@@ -151,30 +115,21 @@ const values = _Object.values;
  */
 const defineProperties = _Object.defineProperties;
 
+const registeredClasses = [];
+
 /**
- * Safe copies of Set built-in via factory function.
- *
- * Since constructors cannot be safely captured via Object.assign, this module
- * provides a factory function that uses Reflect.construct internally.
+ * Safe copies of Array built-in static methods.
  *
  * These references are captured at module initialization time to protect against
  * prototype pollution attacks. Import only what you need for tree-shaking.
  *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/array
  */
-// Capture references at module initialization time
-const _Set = globalThis.Set;
-const _Reflect$3 = globalThis.Reflect;
+const _Array = globalThis.Array;
 /**
- * (Safe copy) Creates a new Set using the captured Set constructor.
- * Use this instead of `new Set()`.
- *
- * @param iterable - Optional iterable of values.
- * @returns A new Set instance.
+ * (Safe copy) Determines whether the passed value is an Array.
  */
-const createSet = (iterable) => _Reflect$3.construct(_Set, iterable ? [iterable] : []);
-
-const registeredClasses = [];
+const isArray = _Array.isArray;
 
 /**
  * Returns the data type of the target.
@@ -210,9 +165,8 @@ const getType = (target) => {
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
  */
-// Capture references at module initialization time
 const _Error = globalThis.Error;
-const _Reflect$2 = globalThis.Reflect;
+const _Reflect$3 = globalThis.Reflect;
 /**
  * (Safe copy) Creates a new Error using the captured Error constructor.
  * Use this instead of `new Error()`.
@@ -221,7 +175,7 @@ const _Reflect$2 = globalThis.Reflect;
  * @param options - Optional error options.
  * @returns A new Error instance.
  */
-const createError = (message, options) => _Reflect$2.construct(_Error, [message, options]);
+const createError = (message, options) => _Reflect$3.construct(_Error, [message, options]);
 
 /**
  * Safe copies of Map built-in via factory function.
@@ -234,9 +188,8 @@ const createError = (message, options) => _Reflect$2.construct(_Error, [message,
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/map
  */
-// Capture references at module initialization time
 const _Map = globalThis.Map;
-const _Reflect$1 = globalThis.Reflect;
+const _Reflect$2 = globalThis.Reflect;
 /**
  * (Safe copy) Creates a new Map using the captured Map constructor.
  * Use this instead of `new Map()`.
@@ -244,7 +197,7 @@ const _Reflect$1 = globalThis.Reflect;
  * @param iterable - Optional iterable of key-value pairs.
  * @returns A new Map instance.
  */
-const createMap = (iterable) => _Reflect$1.construct(_Map, iterable ? [iterable] : []);
+const createMap = (iterable) => _Reflect$2.construct(_Map, iterable ? [iterable] : []);
 
 /**
  * Safe copies of Date built-in via factory function and static methods.
@@ -257,11 +210,10 @@ const createMap = (iterable) => _Reflect$1.construct(_Map, iterable ? [iterable]
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/date
  */
-// Capture references at module initialization time
 const _Date = globalThis.Date;
-const _Reflect = globalThis.Reflect;
+const _Reflect$1 = globalThis.Reflect;
 function createDate(...args) {
-    return _Reflect.construct(_Date, args);
+    return _Reflect$1.construct(_Date, args);
 }
 /**
  * (Safe copy) Returns the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.
@@ -276,7 +228,6 @@ const dateNow = _Date.now;
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/math
  */
-// Capture references at module initialization time
 const _Math = globalThis.Math;
 /**
  * (Safe copy) Returns the value of a number rounded to the nearest integer.
@@ -287,6 +238,28 @@ const round = _Math.round;
  */
 const min = _Math.min;
 
+/**
+ * Safe copies of Set built-in via factory function.
+ *
+ * Since constructors cannot be safely captured via Object.assign, this module
+ * provides a factory function that uses Reflect.construct internally.
+ *
+ * These references are captured at module initialization time to protect against
+ * prototype pollution attacks. Import only what you need for tree-shaking.
+ *
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
+ */
+const _Set = globalThis.Set;
+const _Reflect = globalThis.Reflect;
+/**
+ * (Safe copy) Creates a new Set using the captured Set constructor.
+ * Use this instead of `new Set()`.
+ *
+ * @param iterable - Optional iterable of values.
+ * @returns A new Set instance.
+ */
+const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
+
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * Creates a wrapper function that only executes the wrapped function if the condition function returns true.
@@ -450,6 +423,24 @@ function notFnMsg(label) {
 
 createLogger(error, warn, log, info, debug);
 
+/**
+ * Safe copies of JSON built-in methods.
+ *
+ * These references are captured at module initialization time to protect against
+ * prototype pollution attacks. Import only what you need for tree-shaking.
+ *
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/json
+ */
+const _JSON = globalThis.JSON;
+/**
+ * (Safe copy) Converts a JavaScript Object Notation (JSON) string into an object.
+ */
+const parse = _JSON.parse;
+/**
+ * (Safe copy) Converts a JavaScript value to a JavaScript Object Notation (JSON) string.
+ */
+const stringify = _JSON.stringify;
+
 /**
  * Global log level registry.
  * Tracks all created scoped loggers to allow global log level changes.
@@ -578,14 +569,11 @@ function formatMessage(namespace, message, meta) {
  */
 function createScopedLogger(namespace, options = {}) {
     const { level = 'error', sanitizeSecrets = true } = options;
-    // Create wrapper functions that add namespace prefix and sanitization
     const createLogFn = (baseFn) => (message, meta) => {
         const processedMeta = sanitizeSecrets && meta ? sanitize(meta) : meta;
         baseFn(formatMessage(namespace, message, processedMeta));
     };
-    // Create base logger with wrapped functions
     const baseLogger = createLogger(createLogFn(error), createLogFn(warn), createLogFn(log), createLogFn(info), createLogFn(debug));
-    // Set initial log level (use global override if set)
     baseLogger.setLogLevel(globalLogLevel ?? level);
     const scopedLogger = freeze({
         error: (message, meta) => baseLogger.error(message, meta),
@@ -596,7 +584,6 @@ function createScopedLogger(namespace, options = {}) {
         setLogLevel: baseLogger.setLogLevel,
         getLogLevel: baseLogger.getLogLevel,
     });
-    // Register logger for global level management
     loggerRegistry.add(scopedLogger);
     return scopedLogger;
 }
@@ -809,7 +796,6 @@ function traverseUpward(startPath, predicate) {
         }
         currentPath = dirname(currentPath);
     }
-    // Check root directory
     if (predicate(rootPath)) {
         fsTraversalLogger.debug('Upward traversal found match at root', { startPath, foundPath: rootPath });
         return rootPath;
@@ -1072,7 +1058,6 @@ const cacheRegistry = createSet();
 function createCache(options) {
     const { ttl, maxSize } = options ?? {};
     const store = createMap();
-    // Track insertion order for FIFO eviction
     const insertionOrder = [];
     /**
      * Check if an entry is expired.
@@ -1123,12 +1108,10 @@ function createCache(options) {
             return entry.value;
         },
         set(key, value) {
-            // If key exists, remove from order first
             if (store.has(key)) {
                 removeFromOrder(key);
             }
             else {
-                // Evict if needed before adding new entry
                 evictIfNeeded();
             }
             // eslint-disable-next-line workspace/no-unsafe-builtin-methods -- Date.now() is needed for Jest fake timers compatibility
@@ -1161,15 +1144,10 @@ function createCache(options) {
             return [...insertionOrder];
         },
     };
-    // Register cache for global operations
     cacheRegistry.add(cache);
     return freeze(cache);
 }
 
-/**
- * Pattern matching utilities with ReDoS protection.
- * Uses character-by-character matching instead of regex where possible.
- */
 /**
  * Match path against glob pattern using safe character iteration.
  * Avoids regex to prevent ReDoS attacks.
@@ -1207,17 +1185,14 @@ function matchGlobPattern(path, pattern) {
  * @returns True if remaining segments match
  */
 function matchSegments(pathParts, patternParts, pathIdx, patternIdx) {
-    // Base cases
     if (pathIdx === pathParts.length && patternIdx === patternParts.length) {
-        return true; // Both exhausted = match
+        return true;
     }
     if (patternIdx >= patternParts.length) {
-        return false; // Pattern exhausted but path remains
+        return false;
     }
     const patternPart = patternParts[patternIdx];
-    // Handle ** (globstar) - matches zero or more directories
     if (patternPart === '**') {
-        // Try matching rest of pattern against current position and all future positions
         for (let i = pathIdx; i <= pathParts.length; i++) {
             if (matchSegments(pathParts, patternParts, i, patternIdx + 1)) {
                 return true;
@@ -1226,10 +1201,9 @@ function matchSegments(pathParts, patternParts, pathIdx, patternIdx) {
         return false;
     }
     if (pathIdx >= pathParts.length) {
-        return false; // Path exhausted but pattern remains (and it's not **)
+        return false;
     }
     const pathPart = pathParts[pathIdx];
-    // Match current segment
     if (matchSegment(pathPart, patternPart)) {
         return matchSegments(pathParts, patternParts, pathIdx + 1, patternIdx + 1);
     }
@@ -1249,12 +1223,10 @@ function matchSegment(text, pattern) {
     while (patternIdx < pattern.length) {
         const char = pattern[patternIdx];
         if (char === '*') {
-            // * matches zero or more characters
             patternIdx++;
             if (patternIdx === pattern.length) {
-                return true; // * at end matches rest of string
+                return true;
             }
-            // Try matching rest of pattern at each position in text
             for (let i = textIdx; i <= text.length; i++) {
                 if (matchSegmentFrom(text, i, pattern, patternIdx)) {
                     return true;
@@ -1263,7 +1235,6 @@ function matchSegment(text, pattern) {
             return false;
         }
         else if (char === '?') {
-            // ? matches exactly one character
             if (textIdx >= text.length) {
                 return false;
             }
@@ -1271,10 +1242,8 @@ function matchSegment(text, pattern) {
             patternIdx++;
         }
         else if (char === '{') {
-            // {a,b,c} matches any alternative
             const closeIdx = findClosingBrace(pattern, patternIdx);
             if (closeIdx === -1) {
-                // Unmatched brace, treat as literal
                 if (textIdx >= text.length || text[textIdx] !== char) {
                     return false;
                 }
@@ -1292,7 +1261,6 @@ function matchSegment(text, pattern) {
             }
         }
         else {
-            // Literal character
             if (textIdx >= text.length || text[textIdx] !== char) {
                 return false;
             }
@@ -1840,7 +1808,6 @@ function collectAllDependencies(packageJson) {
 function parseVersionString(versionString) {
     if (versionString === undefined || versionString === null)
         return undefined;
-    // Manual parsing instead of regex to avoid ReDoS
     let start = 0;
     while (start < versionString.length) {
         const char = versionString[start];
@@ -1901,7 +1868,6 @@ function expressDetector(projectPath, packageJson) {
         version = parseVersionString(deps['express']);
         sources.push({ type: 'package.json', field: 'dependencies.express' });
     }
-    // @types/express (indicates usage)
     if (deps['@types/express']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.@types/express' });
@@ -1937,13 +1903,11 @@ function nestDetector(projectPath, packageJson) {
     let version;
     let configPath;
     const deps = collectAllDependencies(pkg);
-    // @nestjs/core package
     if (deps['@nestjs/core']) {
         confidence += 70;
         version = parseVersionString(deps['@nestjs/core']);
         sources.push({ type: 'package.json', field: 'dependencies.@nestjs/core' });
     }
-    // @nestjs/common
     if (deps['@nestjs/common']) {
         confidence += 15;
         sources.push({ type: 'package.json', field: 'dependencies.@nestjs/common' });
@@ -1994,7 +1958,6 @@ function fastifyDetector(projectPath, packageJson) {
         confidence += 15;
         sources.push({ type: 'package.json', field: 'dependencies (fastify plugins)' });
     }
-    // @types/fastify (older versions)
     if (deps['@types/fastify']) {
         confidence += 5;
         sources.push({ type: 'package.json', field: 'dependencies.@types/fastify' });
@@ -2029,7 +1992,6 @@ function koaDetector(projectPath, packageJson) {
         version = parseVersionString(deps['koa']);
         sources.push({ type: 'package.json', field: 'dependencies.koa' });
     }
-    // @types/koa
     if (deps['@types/koa']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.@types/koa' });
@@ -2572,7 +2534,6 @@ function remixDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // @remix-run packages
     if (deps['@remix-run/react']) {
         confidence += 70;
         version = parseVersionString(deps['@remix-run/react']);
@@ -2848,7 +2809,6 @@ function sveltekitDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // @sveltejs/kit package
     if (deps['@sveltejs/kit']) {
         confidence += 70;
         version = parseVersionString(deps['@sveltejs/kit']);
@@ -2927,13 +2887,11 @@ function qwikDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // @builder.io/qwik package
     if (deps['@builder.io/qwik']) {
         confidence += 70;
         version = parseVersionString(deps['@builder.io/qwik']);
         sources.push({ type: 'package.json', field: 'dependencies.@builder.io/qwik' });
     }
-    // @builder.io/qwik-city
     if (deps['@builder.io/qwik-city']) {
         confidence += 20;
         sources.push({ type: 'package.json', field: 'dependencies.@builder.io/qwik-city' });
@@ -3026,23 +2984,19 @@ function angularJSDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // AngularJS package (angular, not @angular/core)
     if (deps['angular']) {
         confidence += 70;
         version = parseVersionString(deps['angular']);
         sources.push({ type: 'package.json', field: 'dependencies.angular' });
     }
-    // AngularJS router
     if (deps['angular-route']) {
         confidence += 15;
         sources.push({ type: 'package.json', field: 'dependencies.angular-route' });
     }
-    // AngularJS resource
     if (deps['angular-resource']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.angular-resource' });
     }
-    // AngularJS animate
     if (deps['angular-animate']) {
         confidence += 5;
         sources.push({ type: 'package.json', field: 'dependencies.angular-animate' });
@@ -3073,23 +3027,19 @@ function backboneDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // Backbone package
     if (deps['backbone']) {
         confidence += 70;
         version = parseVersionString(deps['backbone']);
         sources.push({ type: 'package.json', field: 'dependencies.backbone' });
-        // Underscore (commonly used with Backbone)
         if (deps['underscore']) {
             confidence += 15;
             sources.push({ type: 'package.json', field: 'dependencies.underscore' });
         }
-        // Lodash can be used as underscore replacement
         if (deps['lodash']) {
             confidence += 5;
             sources.push({ type: 'package.json', field: 'dependencies.lodash' });
         }
     }
-    // Marionette (Backbone framework)
     if (deps['backbone.marionette'] || deps['marionette']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.backbone.marionette' });
@@ -3120,18 +3070,15 @@ function emberDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // Ember source package
     if (deps['ember-source']) {
         confidence += 70;
         version = parseVersionString(deps['ember-source']);
         sources.push({ type: 'package.json', field: 'dependencies.ember-source' });
     }
-    // Ember CLI
     if (deps['ember-cli']) {
         confidence += 20;
         sources.push({ type: 'package.json', field: 'devDependencies.ember-cli' });
     }
-    // Ember Data
     if (deps['ember-data']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.ember-data' });
@@ -3162,18 +3109,15 @@ function jqueryDetector(projectPath, packageJson) {
     let confidence = 0;
     let version;
     const deps = collectAllDependencies(pkg);
-    // jQuery package
     if (deps['jquery']) {
         confidence += 80;
         version = parseVersionString(deps['jquery']);
         sources.push({ type: 'package.json', field: 'dependencies.jquery' });
     }
-    // jQuery UI
     if (deps['jquery-ui']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.jquery-ui' });
     }
-    // jQuery plugins
     if (deps['jquery-validation']) {
         confidence += 5;
         sources.push({ type: 'package.json', field: 'dependencies.jquery-validation' });
@@ -3302,7 +3246,6 @@ function prettierDetector(projectPath, packageJson) {
         confidence += 30;
         sources.push({ type: 'package.json', field: 'prettier' });
     }
-    // .prettierignore file
     if (exists(join$1(projectPath, '.prettierignore'))) {
         confidence += 10;
         sources.push({ type: 'config-file', path: '.prettierignore' });
@@ -3397,7 +3340,6 @@ function biomeDetector(projectPath, packageJson) {
     let configPath;
     let version;
     const deps = collectAllDependencies(pkg);
-    // @biomejs/biome package
     if (deps['@biomejs/biome']) {
         confidence += 70;
         version = parseVersionString(deps['@biomejs/biome']);
@@ -3666,7 +3608,7 @@ function npmWorkspacesDetector(workspacePath, packageJson) {
         sources.push({ type: 'lockfile', path: 'package-lock.json' });
     }
     if (exists(join$1(workspacePath, 'yarn.lock'))) {
-        return null; // Let yarn workspace detector handle this
+        return null;
     }
     if (confidence === 0) {
         return null;
@@ -4009,7 +3951,6 @@ function checkTsConfigStrict(projectPath) {
     if (!content)
         return undefined;
     try {
-        // Simple JSON parsing - doesn't handle comments but good enough for strict check
         const cleanContent = content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '');
         const parsed = parse(cleanContent);
         return parsed?.compilerOptions?.strict === true;
@@ -4032,19 +3973,16 @@ function typescriptDetector(projectPath, packageJson) {
     let configPath;
     let version;
     const deps = collectAllDependencies(pkg);
-    // TypeScript package
     if (deps['typescript']) {
         confidence += 50;
         version = parseVersionString(deps['typescript']);
         sources.push({ type: 'package.json', field: 'dependencies.typescript' });
     }
-    // tsconfig.json
     if (exists(join$1(projectPath, 'tsconfig.json'))) {
         confidence += 40;
         configPath = 'tsconfig.json';
         sources.push({ type: 'config-file', path: 'tsconfig.json' });
     }
-    // tsconfig.*.json variants
     const tsconfigVariants = ['tsconfig.build.json', 'tsconfig.lib.json', 'tsconfig.spec.json', 'tsconfig.app.json'];
     for (const variant of tsconfigVariants) {
         if (exists(join$1(projectPath, variant))) {
@@ -4053,7 +3991,6 @@ function typescriptDetector(projectPath, packageJson) {
             break;
         }
     }
-    // @types packages
     const typePackages = keys(deps).filter((d) => d.startsWith('@types/'));
     if (typePackages.length > 0) {
         confidence += 10;
@@ -4087,24 +4024,20 @@ function flowDetector(projectPath, packageJson) {
     let configPath;
     let version;
     const deps = collectAllDependencies(pkg);
-    // flow-bin package
     if (deps['flow-bin']) {
         confidence += 60;
         version = parseVersionString(deps['flow-bin']);
         sources.push({ type: 'package.json', field: 'dependencies.flow-bin' });
     }
-    // .flowconfig
     if (exists(join$1(projectPath, '.flowconfig'))) {
         confidence += 40;
         configPath = '.flowconfig';
         sources.push({ type: 'config-file', path: '.flowconfig' });
     }
-    // flow-typed directory
     if (exists(join$1(projectPath, 'flow-typed'))) {
         confidence += 10;
         sources.push({ type: 'directory', path: 'flow-typed/' });
     }
-    // @babel/preset-flow
     if (deps['@babel/preset-flow']) {
         confidence += 10;
         sources.push({ type: 'package.json', field: 'dependencies.@babel/preset-flow' });
@@ -4128,7 +4061,6 @@ function flowDetector(projectPath, packageJson) {
  * @returns `true` if the content contains JSDoc type annotations.
  */
 function hasJsDocTypes(content) {
-    // Check for JSDoc type annotations
     return (content.includes('@type {') ||
         content.includes('@param {') ||
         content.includes('@returns {') ||
@@ -4147,14 +4079,11 @@ function jsdocDetector(projectPath, packageJson) {
     const sources = [];
     let confidence = 0;
     const deps = collectAllDependencies(pkg);
-    // jsdoc package
     if (deps['jsdoc']) {
         confidence += 30;
         sources.push({ type: 'package.json', field: 'dependencies.jsdoc' });
     }
-    // typescript with checkJs (JSDoc type checking)
     if (deps['typescript']) {
-        // Check if checkJs is enabled in tsconfig
         const tsconfigPath = join$1(projectPath, 'tsconfig.json');
         const content = readFileIfExists(tsconfigPath);
         if (content) {
@@ -4171,12 +4100,10 @@ function jsdocDetector(projectPath, packageJson) {
             }
         }
     }
-    // Check for jsconfig.json (VS Code JS type checking)
     if (exists(join$1(projectPath, 'jsconfig.json'))) {
         confidence += 40;
         sources.push({ type: 'config-file', path: 'jsconfig.json' });
     }
-    // Sample check for JSDoc annotations in source files
     const srcDir = join$1(projectPath, 'src');
     if (exists(srcDir)) {
         try {
@@ -4227,8 +4154,6 @@ const detectAllCache = createCache({ ttl: 60000, maxSize: 50 });
 function isDetectAllOptions(value) {
     if (typeof value !== 'object' || value === null)
         return false;
-    // DetectAllOptions has skipCache or packageJson fields specifically
-    // PackageJson never has skipCache field
     return 'skipCache' in value || 'packageJson' in value;
 }
 /**
@@ -4260,9 +4185,7 @@ function isDetectAllOptions(value) {
  * ```
  */
 function detectAll(projectPath, packageJsonOrOptions) {
-    // Handle backward-compatible arguments
     const options = isDetectAllOptions(packageJsonOrOptions) ? packageJsonOrOptions : { packageJson: packageJsonOrOptions };
-    // Check cache first (unless skipCache is true)
     if (!options.skipCache) {
         const cached = detectAllCache.get(projectPath);
         if (cached) {
@@ -4313,7 +4236,6 @@ function detectAll(projectPath, packageJsonOrOptions) {
         legacyFrameworks: result.legacyFrameworks.map((f) => f.id),
         testingFrameworks: result.testingFrameworks.map((f) => f.id),
     });
-    // Cache the result
     detectAllCache.set(projectPath, result);
     return result;
 }
@@ -4585,7 +4507,6 @@ createScopedLogger('project-scope:nx:config');
  * Known configuration file patterns organized by type.
  */
 const CONFIG_PATTERNS = {
-    // Package Management
     'package.json': {
         patterns: ['package.json'],
         format: 'json',
@@ -4612,14 +4533,12 @@ const CONFIG_PATTERNS = {
         description: 'NPM configuration',
         sensitive: true,
     },
-    // TypeScript
     tsconfig: {
         patterns: ['tsconfig.json', 'tsconfig.*.json'],
         format: 'jsonc',
         description: 'TypeScript configuration',
         canExtend: true,
     },
-    // Monorepo
     nx: {
         patterns: ['nx.json'],
         format: 'json',
@@ -4645,7 +4564,6 @@ const CONFIG_PATTERNS = {
         format: 'json',
         description: 'Lerna configuration',
     },
-    // Build Tools
     webpack: {
         patterns: ['webpack.config.js', 'webpack.config.ts', 'webpack.config.cjs', 'webpack.config.mjs'],
         format: 'js',
@@ -4676,7 +4594,6 @@ const CONFIG_PATTERNS = {
         format: 'json',
         description: 'SWC configuration',
     },
-    // Testing
     jest: {
         patterns: ['jest.config.js', 'jest.config.ts', 'jest.config.mjs'],
         description: 'Jest configuration',
@@ -4693,7 +4610,6 @@ const CONFIG_PATTERNS = {
         patterns: ['playwright.config.js', 'playwright.config.ts'],
         description: 'Playwright configuration',
     },
-    // Framework configs
     next: {
         patterns: ['next.config.js', 'next.config.mjs', 'next.config.ts'],
         format: 'js',
@@ -4719,7 +4635,6 @@ const CONFIG_PATTERNS = {
         format: 'js',
         description: 'Astro configuration',
     },
-    // Linting & Formatting
     eslint: {
         patterns: [
             'eslint.config.js',
@@ -4738,14 +4653,12 @@ const CONFIG_PATTERNS = {
         format: 'json',
         description: 'Prettier configuration',
     },
-    // Environment (sensitive)
     env: {
         patterns: ['.env', '.env.*', '*.env'],
         format: 'dotenv',
         description: 'Environment variables',
         sensitive: true,
     },
-    // Git
     '.gitignore': {
         patterns: ['.gitignore'],
         format: 'text',
@@ -4860,12 +4773,8 @@ function detectConfigs(rootPath, types, options) {
  *
  * @module @hyperfrontend/immutable-api-utils/built-in-copy/number
  */
-// Capture references at module initialization time
 const _parseInt = globalThis.parseInt;
 const _parseFloat = globalThis.parseFloat;
-// ============================================================================
-// Parsing
-// ============================================================================
 /**
  * (Safe copy) Parses a string and returns an integer.
  */
@@ -5193,11 +5102,9 @@ const analyzeLogger = createScopedLogger('project-scope:analyze');
  * @returns Detected workspace type
  */
 function detectWorkspaceType(projectPath) {
-    // Check for NX
     if (isNxWorkspace(projectPath) || findNxWorkspaceRoot(projectPath) !== null) {
         return 'nx';
     }
-    // Check for common monorepo markers
     if (exists(resolve(projectPath, 'turbo.json'))) {
         return 'turborepo';
     }
@@ -5207,7 +5114,6 @@ function detectWorkspaceType(projectPath) {
     if (exists(resolve(projectPath, 'pnpm-workspace.yaml'))) {
         return 'pnpm';
     }
-    // Check package.json for workspaces
     const pkg = readPackageJsonIfExists(projectPath);
     if (pkg?.workspaces) {
         if (exists(resolve(projectPath, 'yarn.lock'))) {
@@ -5216,7 +5122,7 @@ function detectWorkspaceType(projectPath) {
         if (exists(resolve(projectPath, 'package-lock.json'))) {
             return 'npm';
         }
-        return 'npm'; // default for workspaces
+        return 'npm';
     }
     return 'standalone';
 }
@@ -5228,15 +5134,12 @@ function detectWorkspaceType(projectPath) {
  * @returns True if the analysis should be performed
  */
 function shouldInclude(type, options) {
-    // If include list is specified, item must be in it
     if (options?.include && options.include.length > 0) {
         return options.include.includes(type);
     }
-    // If exclude list is specified, item must not be in it
     if (options?.exclude && options.exclude.length > 0) {
         return !options.exclude.includes(type);
     }
-    // Default: include everything
     return true;
 }
 /**
@@ -5285,28 +5188,22 @@ function normalizeConfigFormat(format) {
 function analyzeProject(projectPath, options) {
     const startTime = dateNow();
     const resolvedPath = resolve(projectPath);
-    // Set log level based on verbose option
     if (options?.verbose) {
         analyzeLogger.setLogLevel('debug');
     }
     analyzeLogger.debug('Starting project analysis', { path: resolvedPath, options });
-    // Read package.json once for reuse
     const packageJson = readPackageJsonIfExists(resolvedPath);
     analyzeLogger.debug('Package.json loaded', { found: !!packageJson, name: packageJson?.name });
-    // Detect project and workspace types
     const projectTypeDetection = detectProjectType(resolvedPath, {
         skipTechDetection: options?.depth === 'basic',
     });
     const projectType = projectTypeDetection.type;
     const workspaceType = detectWorkspaceType(resolvedPath);
     analyzeLogger.debug('Project type detected', { projectType, workspaceType });
-    // Get project name from package.json or directory name
     const projectName = packageJson?.name ?? basename(resolvedPath);
-    // Run all technology detectors
     const detections = shouldInclude('frameworks', options) || shouldInclude('buildTools', options) || shouldInclude('testing', options)
         ? detectAll(resolvedPath, packageJson ?? undefined)
         : null;
-    // Convert framework detections to FrameworkInfo
     const frameworks = shouldInclude('frameworks', options) && detections
         ? [
             ...detections.frontendFrameworks.map((d) => ({
@@ -5326,7 +5223,6 @@ function analyzeProject(projectPath, options) {
             })),
         ]
         : [];
-    // Convert build tool detections
     const buildTools = shouldInclude('buildTools', options) && detections
         ? detections.buildTools.map((d) => ({
             id: d.id,
@@ -5336,7 +5232,6 @@ function analyzeProject(projectPath, options) {
             confidence: d.confidence,
         }))
         : [];
-    // Convert testing framework detections
     const testingFrameworks = shouldInclude('testing', options) && detections
         ? detections.testingFrameworks.map((d) => ({
             id: d.id,
@@ -5347,7 +5242,6 @@ function analyzeProject(projectPath, options) {
             confidence: d.confidence,
         }))
         : [];
-    // Discover entry points
     const entryPoints = shouldInclude('entryPoints', options)
         ? discoverEntryPoints(resolvedPath).map((e) => ({
             path: e.path,
@@ -5355,7 +5249,6 @@ function analyzeProject(projectPath, options) {
             confidence: e.confidence,
         }))
         : [];
-    // Detect configuration files
     const configFiles = shouldInclude('configs', options)
         ? detectConfigs(resolvedPath).map((c) => ({
             path: c.path,
@@ -5364,7 +5257,6 @@ function analyzeProject(projectPath, options) {
             tool: c.type,
         }))
         : [];
-    // Get dependency summary
     let dependencies;
     if (shouldInclude('dependencies', options)) {
         const deps = getProjectDependencies(resolvedPath);
@@ -5385,7 +5277,6 @@ function analyzeProject(projectPath, options) {
             total: 0,
         };
     }
-    // Build metadata
     const metadata = {
         timestamp: createDate(),
         durationMs: dateNow() - startTime,
@@ -5460,15 +5351,12 @@ function formatWorkspaceType(type) {
  */
 function formatAnalysisText(result) {
     const lines = [];
-    // Header
     lines.push(`Project Analysis: ${result.name}`);
     lines.push('='.repeat(30));
     lines.push('');
-    // Basic info
     lines.push(`Type:           ${formatProjectType(result.projectType)}`);
     lines.push(`Workspace:      ${formatWorkspaceType(result.workspaceType)}`);
     lines.push('');
-    // Frameworks
     if (result.frameworks.length > 0) {
         lines.push('Frameworks:');
         for (const framework of result.frameworks) {
@@ -5482,7 +5370,6 @@ function formatAnalysisText(result) {
         }
         lines.push('');
     }
-    // Build tools
     if (result.buildTools.length > 0) {
         lines.push('Build Tools:');
         for (const tool of result.buildTools) {
@@ -5491,7 +5378,6 @@ function formatAnalysisText(result) {
         }
         lines.push('');
     }
-    // Testing
     if (result.testingFrameworks.length > 0) {
         lines.push('Testing:');
         for (const framework of result.testingFrameworks) {
@@ -5500,7 +5386,6 @@ function formatAnalysisText(result) {
         }
         lines.push('');
     }
-    // Entry points
     if (result.entryPoints.length > 0) {
         lines.push('Entry Points:');
         for (const entry of result.entryPoints.slice(0, 5)) {
@@ -5511,7 +5396,6 @@ function formatAnalysisText(result) {
         }
         lines.push('');
     }
-    // Configurations
     if (result.configFiles.length > 0) {
         lines.push('Configurations:');
         for (const config of result.configFiles.slice(0, 8)) {
@@ -5522,7 +5406,6 @@ function formatAnalysisText(result) {
         }
         lines.push('');
     }
-    // Dependencies summary
     lines.push('Dependencies:');
     lines.push(`  Production:    ${result.dependencies.production}`);
     lines.push(`  Development:   ${result.dependencies.development}`);
@@ -5609,7 +5492,7 @@ function parseAnalyzeArgs(args) {
             exclude: { type: 'string', short: 'e' },
         },
         allowPositionals: true,
-        strict: false, // Allow global options to pass through
+        strict: false,
     });
     const format = values.format;
     const depth = values.depth;
@@ -5668,7 +5551,6 @@ const analyzeCommandDef = {
     description: 'Analyze project structure and tech stack',
     execute(args, globalOptions) {
         const options = parseAnalyzeArgs(args);
-        // Global --json flag overrides format
         if (globalOptions.json) {
             options.format = 'json';
         }
@@ -5975,12 +5857,10 @@ Examples:
 function formatDependencyList(deps, maxItems = 20) {
     const lines = [];
     const depEntries = entries(deps);
-    // Sort alphabetically
     depEntries.sort((a, b) => a[0].localeCompare(b[0]));
     const displayCount = min(depEntries.length, maxItems);
     for (let i = 0; i < displayCount; i++) {
         const [name, version] = depEntries[i];
-        // Pad name to align versions
         const paddedName = name.padEnd(30);
         lines.push(`  ${paddedName} ${version}`);
     }
@@ -6223,13 +6103,10 @@ function buildTree(rootPath, walkEntries, options) {
         isDirectory: true,
         children: [],
     };
-    // Create a map for quick lookup
     const nodeMap = createMap();
     nodeMap.set('.', root);
-    // Sort entries by path for proper parent-child relationships
     const sortedEntries = [...walkEntries].sort((a, b) => a.relativePath.localeCompare(b.relativePath));
     for (const entry of sortedEntries) {
-        // Skip based on filters
         if (options.dirsOnly && !entry.isDirectory)
             continue;
         if (options.filesOnly && entry.isDirectory)
@@ -6240,7 +6117,6 @@ function buildTree(rootPath, walkEntries, options) {
             isDirectory: entry.isDirectory,
             children: [],
         };
-        // Add size/modified if requested
         if ((options.showSize || options.showModified) && entry.isFile) {
             const stats = getFileStat(entry.path);
             if (stats) {
@@ -6250,9 +6126,8 @@ function buildTree(rootPath, walkEntries, options) {
                     node.modified = stats.modified;
             }
         }
-        // Find parent
         const parts = entry.relativePath.split('/');
-        parts.pop(); // Remove current entry name
+        parts.pop();
         const parentPath = parts.join('/') || '.';
         const parent = nodeMap.get(parentPath);
         if (parent) {
@@ -6273,11 +6148,9 @@ function buildTree(rootPath, walkEntries, options) {
  */
 function renderTreeText(node, options, prefix = '', isLast = true) {
     const lines = [];
-    // Current line
     const connector = isLast ? '└── ' : '├── ';
     const dirMark = node.isDirectory ? '/' : '';
     let line = `${prefix}${connector}${node.name}${dirMark}`;
-    // Add size/modified
     const meta = [];
     if (options.showSize && node.size !== undefined) {
         meta.push(formatSize(node.size));
@@ -6289,10 +6162,8 @@ function renderTreeText(node, options, prefix = '', isLast = true) {
         line += `  [${meta.join(' ')}]`;
     }
     lines.push(line);
-    // Process children
     const childPrefix = prefix + (isLast ? '    ' : '│   ');
     const sortedChildren = [...node.children].sort((a, b) => {
-        // Directories first, then alphabetically
         if (a.isDirectory && !b.isDirectory)
             return -1;
         if (!a.isDirectory && b.isDirectory)
@@ -6316,9 +6187,7 @@ function renderTreeText(node, options, prefix = '', isLast = true) {
  */
 function formatTreeText(rootPath, tree, options) {
     const lines = [];
-    // Root line
     lines.push(basename(rootPath));
-    // Count stats
     let dirCount = 0;
     let fileCount = 0;
     /**
@@ -6337,7 +6206,6 @@ function formatTreeText(rootPath, tree, options) {
             countNodes(child);
         }
     }
-    // Render children of root
     const sortedChildren = [...tree.children].sort((a, b) => {
         if (a.isDirectory && !b.isDirectory)
             return -1;
@@ -6351,7 +6219,6 @@ function formatTreeText(rootPath, tree, options) {
         lines.push(...renderTreeText(child, options, '', isLast));
         countNodes(child);
     }
-    // Summary
     lines.push('');
     const dirText = dirCount === 1 ? '1 directory' : `${dirCount} directories`;
     const fileText = fileCount === 1 ? '1 file' : `${fileCount} files`;
@@ -6412,7 +6279,6 @@ function parseTreeArgs(args) {
 function treeCommand(options) {
     const rootPath = options.path ? resolve(options.path) : process.cwd();
     try {
-        // Collect entries via walk
         const walkEntries = [];
         walkDirectory(rootPath, (entry) => {
             walkEntries.push(entry);
@@ -6422,9 +6288,7 @@ function treeCommand(options) {
             ignorePatterns: options.ignore,
             includeHidden: false,
         });
-        // Build tree structure
         const tree = buildTree(rootPath, walkEntries, options);
-        // Format output
         let output;
         if (options.format === 'json') {
             output = formatTreeJson(tree);
@@ -6483,6 +6347,9 @@ Examples:
 
 /** Logger for CLI operations */
 const cliLogger = createScopedLogger('project-scope:cli');
+/** Output printer for user-facing CLI output (help, version, command results). */
+const output = createLogger(error, undefined, log);
+output.setLogLevel('log');
 /** Library version */
 const VERSION = '0.1.0';
 /**
@@ -6498,7 +6365,7 @@ const commands = {
  * Print general help information.
  */
 function printHelp() {
-    log(`
+    output.log(`
 project-scope <command> [options]
 
 A tool for analyzing JavaScript/TypeScript project structure and tech stack.
@@ -6530,7 +6397,7 @@ Examples:
  * Print CLI version.
  */
 function printVersion() {
-    log(`project-scope v${VERSION}`);
+    output.log(`project-scope v${VERSION}`);
 }
 /**
  * Parse global options from command line arguments.
@@ -6591,24 +6458,24 @@ function run(args) {
         setGlobalLogLevel('debug');
     }
     cliLogger.debug('CLI invoked', { args, globalOptions });
+    const commandName = args[0];
     if (globalOptions.version) {
         printVersion();
         return { exitCode: 0 };
     }
-    if (globalOptions.help && (args.length === 1 || !commands[args[0]])) {
+    if (globalOptions.help && (args.length === 1 || !commands[commandName])) {
         printHelp();
         return { exitCode: 0 };
     }
-    const commandName = args[0];
     const command = commands[commandName];
     if (!command) {
         cliLogger.warn('Unknown command requested', { commandName });
-        error(`Unknown command: ${commandName}`);
-        error('Run "project-scope --help" for usage information.');
+        output.error(`Unknown command: ${commandName}`);
+        output.error('Run "project-scope --help" for usage information.');
         return { exitCode: 1, error: `Unknown command: ${commandName}` };
     }
     if (globalOptions.help) {
-        log(command.getHelp());
+        output.log(command.getHelp());
         return { exitCode: 0 };
     }
     const commandArgs = args.slice(1);
@@ -6616,11 +6483,11 @@ function run(args) {
     const result = command.execute(commandArgs, globalOptions);
     cliLogger.debug('Command completed', { commandName, exitCode: result.exitCode });
     if (result.output) {
-        log(result.output);
+        output.log(result.output);
     }
     if (result.error) {
         cliLogger.error('Command error', { commandName, error: result.error });
-        error(result.error);
+        output.error(result.error);
     }
     return result;
 }