@lunanoir/dep-lens 0.1.1 → 0.1.3

package/dist/args.js

@@ -16,6 +16,8 @@ OPTIONS:
     --tr               Turkish UI (Turkce arayuz)
     --test             Run a self-check: verify the scanner binary and
                        report which ecosystems it detects in --path
+    --setup            Re-run the interactive setup wizard (language,
+                       PATH check) even outside of npm install
     --help             Show this help
     --version          Show version
 
@@ -49,6 +51,7 @@ export function parseArgs(argv) {
         help: false,
         version: false,
         test: false,
+        setup: false,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -98,6 +101,9 @@ export function parseArgs(argv) {
             case '--test':
                 options.test = true;
                 break;
+            case '--setup':
+                options.setup = true;
+                break;
             case '--help':
             case '-h':
                 options.help = true;

package/dist/cli.js

@@ -7,6 +7,7 @@ import { parseArgs, USAGE } from './args.js';
 import { renderCsv, renderHtml, renderMarkdown, runScan } from './bridge.js';
 import { readConfig } from './config.js';
 import { runSelfTest } from './selftest.js';
+import { runFirstRunSetup, runWizard } from './setup.js';
 import { violations } from './utils.js';
 import { Root } from './ui/Root.js';
 function packageVersion() {
@@ -46,6 +47,11 @@ async function main() {
         process.stdout.write(`dep-lens ${packageVersion()}\n`);
         return;
     }
+    if (options.setup) {
+        await runWizard(true);
+        return;
+    }
+    await runFirstRunSetup();
     if (!options.localeExplicit) {
         const config = await readConfig();
         if (config.locale !== undefined) {

package/dist/config.js

@@ -22,6 +22,9 @@ export async function readConfig() {
         if (record['locale'] === 'en' || record['locale'] === 'tr') {
             config.locale = record['locale'];
         }
+        if (typeof record['setupDone'] === 'boolean') {
+            config.setupDone = record['setupDone'];
+        }
         return config;
     }
     catch {

package/dist/{postinstall.js → setup.js}

@@ -1,13 +1,12 @@
-#!/usr/bin/env node
 /**
- * Postinstall setup wizard. Runs once after `npm install`, detects the
- * caller's project ecosystems, asks for a default UI language, and checks
- * whether the global npm bin directory (where the `dep-lens` launcher
- * lands) is on PATH.
+ * Interactive setup wizard. Detects the project's ecosystems, asks for a
+ * default UI language, and checks whether the global npm bin directory
+ * (where the `dep-lens` launcher lands) is on PATH.
  *
- * Skips entirely in non-interactive environments (CI, piped installs, or
- * when npm doesn't attach a TTY to lifecycle scripts) so it never blocks an
- * install.
+ * Runs automatically the first time `dep-lens` is invoked (not as an npm
+ * `postinstall` script - npm 11's install-script policy and the lack of a
+ * TTY on lifecycle scripts make that unreliable), and any time via
+ * `dep-lens --setup`.
  */
 import { execFile } from 'node:child_process';
 import { createInterface } from 'node:readline';
@@ -69,18 +68,20 @@ function pathContains(dir) {
     const sep = process.platform === 'win32' ? ';' : ':';
     return pathEnv.split(sep).some((entry) => entry.replace(/[/\\]+$/, '') === dir.replace(/[/\\]+$/, ''));
 }
-async function main() {
-    // Always print a one-line banner so even non-interactive installs show
-    // something useful, but never prompt unless we have a real TTY.
-    const cwd = process.env['INIT_CWD'] ?? process.cwd();
+/**
+ * Run the setup wizard. `force` skips the TTY/CI checks (used by
+ * `dep-lens --setup`, where the user explicitly asked for it).
+ */
+export async function runWizard(force = false) {
+    const cwd = process.cwd();
     const detected = detectEcosystems(cwd);
-    process.stdout.write(`\n${bold(brand('dep-lens'))} installed.\n`);
+    process.stdout.write(`\n${bold(brand('dep-lens'))} setup\n`);
     if (detected.length > 0) {
         const labels = detected.map((eco) => eco.label).join(', ');
         process.stdout.write(`${dim('detected in this project:')} ${good(labels)}\n`);
     }
-    if (!isInteractive()) {
-        process.stdout.write(`${dim('run')} dep-lens ${dim('to scan, or')} dep-lens --help\n\n`);
+    if (!force && !isInteractive()) {
+        process.stdout.write(`${dim('run')} dep-lens --setup ${dim('for language and PATH setup.')}\n\n`);
         return;
     }
     process.stdout.write(`\n${bold('Quick setup')} ${dim('(press enter to accept defaults)')}\n`);
@@ -126,13 +127,29 @@ async function appendToShellProfile(binDir) {
             process.stdout.write(`${dim('already present in')} ${rcFile}\n`);
             return;
         }
-        await appendFile(rcFile, `\n# added by dep-lens postinstall\n${line}\n`);
+        await appendFile(rcFile, `\n# added by dep-lens setup\n${line}\n`);
         process.stdout.write(`${good('added to')} ${rcFile}${dim(' - open a new terminal to apply.')}\n`);
     }
     catch {
         process.stdout.write(`${dim('could not update shell profile, add manually:')} ${line}\n`);
     }
 }
-main().catch(() => {
-    // Never fail the install over the setup wizard.
-});
+/**
+ * Run the wizard once, the first time `dep-lens` is ever invoked. No-op on
+ * every later run (tracked via `setupDone` in the user config).
+ */
+export async function runFirstRunSetup() {
+    // Avoid writing wizard banners into piped/redirected output (e.g.
+    // `dep-lens --json | jq`), where stdout isn't a terminal at all.
+    if (process.stdout.isTTY !== true) {
+        return;
+    }
+    const config = await readConfig();
+    if (config.setupDone === true) {
+        return;
+    }
+    await runWizard(false);
+    const finalConfig = await readConfig();
+    finalConfig.setupDone = true;
+    await writeConfig(finalConfig);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunanoir/dep-lens",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Dependency license scanner across npm, Cargo, Go, Python, Ruby, PHP, Java, Dart, and C/C++ with commercial risk reporting",
   "type": "module",
   "license": "MIT",
@@ -32,8 +32,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "test": "tsc && node --test \"dist/test/**/*.test.js\"",
-    "postinstall": "node dist/postinstall.js"
+    "test": "tsc && node --test \"dist/test/**/*.test.js\""
   },
   "dependencies": {
     "ink": "^5.2.1",