@lunanoir/dep-lens 0.1.2 → 1.0.0

package/dist/cli.js

@@ -6,8 +6,8 @@ import { render } from 'ink';
 import { parseArgs, USAGE } from './args.js';
 import { renderCsv, renderHtml, renderMarkdown, runScan } from './bridge.js';
 import { readConfig } from './config.js';
-import { main as runSetupWizard } from './postinstall.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() {
@@ -47,16 +47,17 @@ 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) {
             options.locale = config.locale;
         }
     }
-    if (options.setup) {
-        await runSetupWizard(true);
-        return;
-    }
     const scanOptions = { path: options.path, ignore: options.ignore, locale: options.locale };
     if (options.test) {
         process.exitCode = await runSelfTest(scanOptions);

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';
@@ -73,18 +72,16 @@ function pathContains(dir) {
  * 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 main(force = false) {
-    // 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();
+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 (!force && !isInteractive()) {
-        process.stdout.write(`${dim('run')} dep-lens ${dim('to scan, or')} dep-lens --help\n\n`);
+        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`);
@@ -130,17 +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`);
     }
 }
-// Only auto-run when invoked directly as the postinstall script, not when
-// imported by `dep-lens --setup`.
-if (process.argv[1]?.endsWith('postinstall.js')) {
-    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.2",
+  "version": "1.0.0",
   "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,18 +32,17 @@
   ],
   "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",
     "react": "^18.3.1"
   },
   "optionalDependencies": {
-    "@lunanoir/dep-lens-darwin-arm64": "0.1.0",
-    "@lunanoir/dep-lens-darwin-x64": "0.1.0",
-    "@lunanoir/dep-lens-linux-x64": "0.1.1",
-    "@lunanoir/dep-lens-win32-x64": "0.1.0"
+    "@lunanoir/dep-lens-darwin-arm64": "1.0.0",
+    "@lunanoir/dep-lens-darwin-x64": "1.0.0",
+    "@lunanoir/dep-lens-linux-x64": "1.0.0",
+    "@lunanoir/dep-lens-win32-x64": "1.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",