@myooken/license-output 0.1.1 → 0.2.1

package/README.md

@@ -1,5 +1,11 @@
 # Third-Party License Output for node_modules
 
+[![npm version](https://img.shields.io/npm/v/@myooken/license-output.svg)](https://www.npmjs.com/package/@myooken/license-output)
+[![npm downloads](https://img.shields.io/npm/dm/@myooken/license-output.svg)](https://www.npmjs.com/package/@myooken/license-output)
+[![node](https://img.shields.io/node/v/@myooken/license-output.svg)](https://www.npmjs.com/package/@myooken/license-output)
+
+https://www.npmjs.com/package/@myooken/license-output
+
 ### What is this?
 
 A tool to scan `node_modules` and **output third-party licenses in Markdown**.  
@@ -8,7 +14,7 @@ It generates two files: `THIRD-PARTY-LICENSE.md` (main content) and `THIRD-PARTY
 ### Highlights
 
 - **ESM / Node.js 18+**, zero dependencies
-- **Outputs full license texts** from LICENSE/NOTICE/COPYING files
+- **Outputs full license texts** from LICENSE/NOTICE/THIRD-PARTY-NOTICES/COPYING files
 - **Review file** flags missing Source / license / license files
 - `--fail-on-missing` supports CI enforcement
 
@@ -37,15 +43,18 @@ third-party-license
 
 ### Options
 
-| Option                 | Description                                            | Default                         |
-| ---------------------- | ------------------------------------------------------ | ------------------------------- |
-| `--node-modules <dir>` | Path to `node_modules`                                 | `node_modules`                  |
-| `--review [file]`      | Write review file only; optional filename              | `THIRD-PARTY-LICENSE-REVIEW.md` |
-| `--license [file]`     | Write main file only; optional filename                | `THIRD-PARTY-LICENSE.md`        |
-| `--fail-on-missing`    | Exit with code 1 if LICENSE/NOTICE/COPYING are missing | `false`                         |
-| `-h`, `--help`         | Show help                                              | -                               |
+| Option                 | Description                                                                 | Default                         |
+| ---------------------- | --------------------------------------------------------------------------- | ------------------------------- |
+| `--node-modules <dir>` | Path to `node_modules`                                                      | `node_modules`                  |
+| `--review [file]`      | Write review file only; optional filename                                   | `THIRD-PARTY-LICENSE-REVIEW.md` |
+| `--license [file]`     | Write main file only; optional filename                                     | `THIRD-PARTY-LICENSE.md`        |
+| `--recreate`           | Regenerate files from current `node_modules` only (drops removed packages)  | `true` (default)                |
+| `--update`             | Merge with existing outputs, keep removed packages, and mark their presence | `false`                        |
+| `--fail-on-missing`    | Exit with code 1 if LICENSE/NOTICE/THIRD-PARTY-NOTICES/COPYING are missing  | `false`                         |
+| `-h`, `--help`         | Show help                                                                   | -                               |
 
 > If neither `--review` nor `--license` is specified, **both files are generated**.
+> Packages in both files are sorted by name@version; `--update` keeps entries for packages no longer in `node_modules` and annotates their usage status.
 
 ### Examples
 
@@ -53,6 +62,9 @@ third-party-license
 # Default (both files)
 third-party-license
 
+# Update existing files without dropping removed packages
+third-party-license --update
+
 # Custom node_modules path
 third-party-license --node-modules ./path/to/node_modules
 
@@ -71,27 +83,32 @@ third-party-license --fail-on-missing
 ### Programmatic API
 
 ```js
-import { collectThirdPartyLicenses } from "@myooken/third-party-license-output-nodemodules";
+import { collectThirdPartyLicenses } from "@myooken/license-output";
 
 const result = await collectThirdPartyLicenses({
   nodeModules: "./node_modules",
   outFile: "./THIRD-PARTY-LICENSE.md",
   reviewFile: "./THIRD-PARTY-LICENSE-REVIEW.md",
   failOnMissing: false,
+  // mode: "update", // keep packages missing from node_modules when updating files
 });
 
 console.log(result.mainContent);
 console.log(result.reviewContent);
 ```
 
+Outputs are sorted by package key. Use `mode: "update"` to merge with existing files and keep packages that are no longer in `node_modules`, with their usage shown in both outputs.
+
 ### Output overview
 
 - **THIRD-PARTY-LICENSE.md**
   - List of packages
   - Source / License info
-  - Full LICENSE/NOTICE/COPYING texts
+  - Full LICENSE/NOTICE/THIRD-PARTY-NOTICES/COPYING texts
+  - Usage line shows whether the package is present in the current `node_modules`
 - **THIRD-PARTY-LICENSE-REVIEW.md**
   - Review-oriented checklist
+  - Usage-aware status (present / not found) for each package
   - **Missing summary** section
 
 ### How it differs from typical npm license tools (general view)
@@ -112,3 +129,4 @@ console.log(result.reviewContent);
 - Exit code 1: missing license files when `--fail-on-missing` is set, or `node_modules` not found.
 - Throws an error if `node_modules` does not exist.
 - Missing `license` or `repository` fields are flagged in the review file.
+- Paths printed in outputs/logs are shown relative to the current working directory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myooken/license-output",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Generate third-party-license markdown by scanning licenses in node_modules.",
   "license": "MIT",
   "type": "module",

package/src/cli.js

@@ -4,6 +4,7 @@ import fsp from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { collectThirdPartyLicenses, DEFAULT_OPTIONS } from "./core.js";
+import { LICENSE_FILES_LABEL } from "./constants.js";
 
 // 引数パース: --review / --license は最後に指定されたものを優先し、直後の値があれば出力ファイル名として扱う
 function parseArgs(argv) {
@@ -32,6 +33,10 @@ function parseArgs(argv) {
         args.outFile = file;
         i += 1;
       }
+    } else if (a === "--recreate") {
+      args.mode = "recreate";
+    } else if (a === "--update") {
+      args.mode = "update";
     } else if (a === "--fail-on-missing") {
       args.failOnMissing = true;
     } else if (a === "-h" || a === "--help") {
@@ -66,7 +71,7 @@ function applyOutputMode(mode, args) {
 
 function showHelp() {
   console.log(`Usage:
-  third-party-license [--node-modules <dir>] [--review [file]] [--license [file]] [--fail-on-missing]
+  third-party-license [--node-modules <dir>] [--review [file]] [--license [file]] [--recreate|--update] [--fail-on-missing]
 `);
 }
 
@@ -103,12 +108,18 @@ export async function runCli(argv = process.argv.slice(2)) {
     await Promise.all(writeTasks);
 
     if (result.options.writeMain)
-      console.log(`Generated: ${result.options.outFile}`);
+      console.log(
+        `Generated: ${result.options.outFileDisplay ?? result.options.outFile}`
+      );
     if (result.options.writeReview)
-      console.log(`Review:    ${result.options.reviewFile}`);
+      console.log(
+        `Review:    ${
+          result.options.reviewFileDisplay ?? result.options.reviewFile
+        }`
+      );
     console.log(`Packages:  ${result.stats.packages}`);
     console.log(
-      `Missing LICENSE/NOTICE/COPYING: ${result.stats.missingFiles.length}`
+      `Missing ${LICENSE_FILES_LABEL}: ${result.stats.missingFiles.length}`
     );
 
     if (result.stats.missingFiles.length > 0 && result.options.failOnMissing) {

package/src/constants.js

@@ -1,11 +1,15 @@
-// デフォルト値と定数群
-export const DEFAULT_OPTIONS = {
-  nodeModules: "node_modules",
-  outFile: "THIRD-PARTY-LICENSE.md",
-  reviewFile: "THIRD-PARTY-LICENSE-REVIEW.md",
-  failOnMissing: false,
-};
-
-// ライセンスらしいファイル名を検出する正規表現
-export const LICENSE_LIKE_RE =
-  /^(LICEN[CS]E|COPYING|NOTICE)(\..*)?$|^(LICEN[CS]E|COPYING|NOTICE)-/i;
+// デフォルト値と定数群
+export const DEFAULT_OPTIONS = {
+  nodeModules: "node_modules",
+  outFile: "THIRD-PARTY-LICENSE.md",
+  reviewFile: "THIRD-PARTY-LICENSE-REVIEW.md",
+  failOnMissing: false,
+  mode: "recreate", // "recreate" | "update"
+};
+
+// ライセンスらしいファイル名を検出する正規表現
+export const LICENSE_LIKE_RE =
+  /^(LICEN[CS]E|COPYING|NOTICE|THIRD[-_. ]?PARTY[-_. ]?NOTICES?)(\..*)?$|^(LICEN[CS]E|COPYING|NOTICE|THIRD[-_. ]?PARTY[-_. ]?NOTICES?)-/i;
+
+export const LICENSE_FILES_LABEL =
+  "LICENSE/NOTICE/THIRD-PARTY-NOTICES/COPYING";

package/src/core.js

@@ -3,27 +3,39 @@ import path from "node:path";
 import { DEFAULT_OPTIONS } from "./constants.js";
 import { gatherPackages } from "./scan.js";
 import { renderMain, renderReview } from "./render.js";
-import { uniqSorted } from "./fs-utils.js";
+import { makeAnchorId, uniqSorted } from "./fs-utils.js";
+import {
+  parseExistingMainFile,
+  parseExistingReviewFile,
+} from "./existing.js";
 
-// 警告の出力先（デフォルトは console）
+// Default warning handler (prints to console)
 const defaultWarn = (msg) => {
   console.warn(`warning: ${msg}`);
 };
 
-// 公開API: ライセンス情報を収集し、マークダウン文字列を返す
+// Public API: scan licenses and render markdown
 export async function collectThirdPartyLicenses(options = {}) {
   const opts = normalizeOptions(options);
-  await assertNodeModulesExists(opts.nodeModules); // node_modules が無ければ即エラー
+  await assertNodeModulesExists(opts.nodeModules); // fail fast when node_modules is missing
 
-  const result = await gatherPackages(opts);
+  const scanResult = await gatherPackages(opts);
+  const presentPackages = withPresentUsage(scanResult.packages);
 
-  const mainContent = renderMain(result.packages, opts);
+  const packages =
+    opts.mode === "update"
+      ? await mergeWithExistingOutputs(presentPackages, opts)
+      : presentPackages;
+
+  const sortedPackages = sortPackages(packages);
+
+  const mainContent = renderMain(sortedPackages, opts);
   const reviewContent = renderReview(
-    result.packages,
+    sortedPackages,
     opts,
-    result.missingFiles,
-    result.missingSource,
-    result.missingLicenseField
+    scanResult.missingFiles,
+    scanResult.missingSource,
+    scanResult.missingLicenseField
   );
 
   return {
@@ -31,10 +43,10 @@ export async function collectThirdPartyLicenses(options = {}) {
     reviewContent,
     options: opts,
     stats: {
-      packages: result.seenCount,
-      missingFiles: uniqSorted(result.missingFiles),
-      missingSource: uniqSorted(result.missingSource),
-      missingLicenseField: uniqSorted(result.missingLicenseField),
+      packages: scanResult.seenCount,
+      missingFiles: uniqSorted(scanResult.missingFiles),
+      missingSource: uniqSorted(scanResult.missingSource),
+      missingLicenseField: uniqSorted(scanResult.missingLicenseField),
     },
   };
 }
@@ -42,25 +54,114 @@ export async function collectThirdPartyLicenses(options = {}) {
 export { DEFAULT_OPTIONS } from "./constants.js";
 
 function normalizeOptions(options) {
+  const cwd = process.cwd();
+  const nodeModules = path.resolve(
+    options.nodeModules ?? DEFAULT_OPTIONS.nodeModules
+  );
+  const outFile = path.resolve(options.outFile ?? DEFAULT_OPTIONS.outFile);
+  const reviewFile = path.resolve(
+    options.reviewFile ?? DEFAULT_OPTIONS.reviewFile
+  );
+
   return {
-    nodeModules: path.resolve(
-      options.nodeModules ?? DEFAULT_OPTIONS.nodeModules
-    ),
-    outFile: path.resolve(options.outFile ?? DEFAULT_OPTIONS.outFile),
-    reviewFile: path.resolve(options.reviewFile ?? DEFAULT_OPTIONS.reviewFile),
+    nodeModules,
+    outFile,
+    reviewFile,
+    nodeModulesDisplay: makeDisplayPath(nodeModules, cwd),
+    outFileDisplay: makeDisplayPath(outFile, cwd),
+    reviewFileDisplay: makeDisplayPath(reviewFile, cwd),
     failOnMissing: Boolean(
       options.failOnMissing ?? DEFAULT_OPTIONS.failOnMissing
     ),
     writeMain: options.writeMain ?? true,
     writeReview: options.writeReview ?? true,
     warn: options.onWarn ?? defaultWarn,
+    mode: normalizeMode(options.mode),
   };
 }
 
+function normalizeMode(mode) {
+  const m = typeof mode === "string" ? mode.toLowerCase() : "";
+  return m === "update" ? "update" : DEFAULT_OPTIONS.mode;
+}
+
+function makeDisplayPath(targetPath, cwd) {
+  const rel = path.relative(cwd, targetPath);
+  return rel || ".";
+}
+
 async function assertNodeModulesExists(dir) {
-  // node_modules の有無を事前チェックし、無ければ例外を投げてCIなどで失敗させる
   const stat = await fsp.stat(dir).catch(() => null);
   if (!stat || !stat.isDirectory()) {
     throw new Error(`not found node_modules: ${dir}`);
   }
 }
+
+function withPresentUsage(packages) {
+  return packages.map((pkg) => ({
+    ...pkg,
+    usage: "present",
+    notes: "",
+  }));
+}
+
+async function mergeWithExistingOutputs(currentPackages, opts) {
+  const [existingMain, existingReview] = await Promise.all([
+    parseExistingMainFile(opts.outFile),
+    parseExistingReviewFile(opts.reviewFile),
+  ]);
+
+  // Start with previously known packages as "missing" (not found in this scan)
+  const merged = new Map();
+  for (const [key, prevReview] of existingReview.entries()) {
+    const prevMain = existingMain.get(key);
+    merged.set(key, toMissingPackage(key, prevMain, prevReview));
+  }
+  for (const [key, prevMain] of existingMain.entries()) {
+    if (!merged.has(key)) {
+      merged.set(key, toMissingPackage(key, prevMain, null));
+    }
+  }
+
+  // Override with current scan (present in node_modules), keeping previous notes when available
+  for (const pkg of currentPackages) {
+    const prevReview = existingReview.get(pkg.key);
+    merged.set(pkg.key, toPresentPackage(pkg, prevReview));
+  }
+
+  return [...merged.values()];
+}
+
+function toPresentPackage(pkg, prevReview) {
+  return {
+    ...pkg,
+    usage: "present",
+    notes: prevReview?.notes ?? "",
+  };
+}
+
+function toMissingPackage(key, prevMain, prevReview) {
+  return {
+    key,
+    anchor: makeAnchorId(key),
+    source: prevMain?.source ?? prevReview?.source ?? null,
+    license: prevMain?.license ?? prevReview?.license ?? null,
+    fileNames: deriveFileNames(prevMain, prevReview),
+    flags: [],
+    licenseTexts: prevMain?.licenseTexts ?? [],
+    usage: "missing",
+    notes: prevReview?.notes ?? "",
+  };
+}
+
+function deriveFileNames(prevMain, prevReview) {
+  const names =
+    (prevMain?.fileNames && prevMain.fileNames.length > 0
+      ? prevMain.fileNames
+      : prevReview?.fileNames) ?? [];
+  return uniqSorted(names);
+}
+
+function sortPackages(packages) {
+  return [...packages].sort((a, b) => a.key.localeCompare(b.key));
+}

package/src/existing.js

@@ -0,0 +1,168 @@
+import fsp from "node:fs/promises";
+import { makeAnchorId, uniqSorted } from "./fs-utils.js";
+import { LICENSE_FILES_LABEL } from "./constants.js";
+
+export async function parseExistingMainFile(filePath) {
+  const content = await readFileSafe(filePath);
+  if (!content) return new Map();
+
+  const map = new Map();
+  for (const { key, body } of splitPackageBlocks(content)) {
+    map.set(key, parseMainBlock(key, body));
+  }
+  return map;
+}
+
+export async function parseExistingReviewFile(filePath) {
+  const content = await readFileSafe(filePath);
+  if (!content) return new Map();
+
+  const map = new Map();
+  for (const { key, body } of splitPackageBlocks(content)) {
+    map.set(key, parseReviewBlock(key, body));
+  }
+  return map;
+}
+
+async function readFileSafe(filePath) {
+  try {
+    return await fsp.readFile(filePath, "utf8");
+  } catch {
+    return null;
+  }
+}
+
+function splitPackageBlocks(content) {
+  const blocks = [];
+  const headingRe = /^##\s+(.+)$/gm;
+  let match;
+  let current = null;
+
+  while ((match = headingRe.exec(content))) {
+    if (current) {
+      blocks.push({
+        key: current.key,
+        body: content.slice(current.start, match.index),
+      });
+    }
+    current = { key: match[1].trim(), start: match.index };
+  }
+
+  if (current) {
+    blocks.push({
+      key: current.key,
+      body: content.slice(current.start),
+    });
+  }
+
+  return blocks;
+}
+
+function parseMainBlock(key, body) {
+  const source = pickLine(body, /^- Source:\s*(.+)$/m);
+  const license = pickLine(body, /^- License:\s*(.+)$/m);
+  const usage = pickLine(body, /^- Usage:\s*(.+)$/m);
+
+  const licenseTexts = [];
+  const licRe = /###\s+(.+?)\s*\r?\n```text\r?\n([\s\S]*?)```/g;
+  let licMatch;
+  while ((licMatch = licRe.exec(body))) {
+    licenseTexts.push({
+      name: licMatch[1].trim(),
+      text: licMatch[2],
+    });
+  }
+
+  const fileNames = [];
+  for (const m of body.matchAll(/^- (.+)$/gm)) {
+    const val = m[1].trim();
+    if (
+      val.startsWith("Source:") ||
+      val.startsWith("License:") ||
+      val.startsWith("Usage:")
+    ) {
+      continue;
+    }
+    if (
+      val.startsWith("(no LICENSE/NOTICE/COPYING files)") ||
+      val.startsWith(`(no ${LICENSE_FILES_LABEL} files)`)
+    ) {
+      continue;
+    }
+    fileNames.push(val);
+  }
+
+  const derivedNames =
+    fileNames.length > 0 ? fileNames : licenseTexts.map((x) => x.name);
+
+  return {
+    key,
+    anchor: makeAnchorId(key),
+    source: source || null,
+    license: license || null,
+    fileNames: uniqSorted(derivedNames),
+    flags: [],
+    licenseTexts,
+    usage: usage || "",
+    notes: "",
+  };
+}
+
+function parseReviewBlock(key, body) {
+  const source = pickLine(body, /^- Source:\s*(.+)$/m);
+  const license = pickLine(body, /^- License:\s*(.+)$/m);
+
+  const lines = body.split(/\r?\n/);
+  const fileNames = [];
+
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i];
+    if (!line.startsWith("- Files:")) continue;
+
+    let j = i + 1;
+    while (j < lines.length && lines[j].startsWith("  -")) {
+      fileNames.push(lines[j].replace(/^  -\s*/, ""));
+      j += 1;
+    }
+    i = j - 1;
+  }
+
+  let notes = "";
+  const notesIdx = lines.findIndex((l) => l.startsWith("- Notes:"));
+  if (notesIdx !== -1) {
+    const noteLines = [];
+    for (let i = notesIdx + 1; i < lines.length; i += 1) {
+      const line = lines[i];
+      if (line.startsWith("## ")) break;
+      if (line.startsWith("- ")) break;
+      if (line.startsWith("---")) break;
+      if (line.startsWith("  ")) {
+        noteLines.push(line.slice(2));
+        continue;
+      }
+      if (line.trim() === "") {
+        noteLines.push("");
+        continue;
+      }
+      break;
+    }
+    notes = noteLines.join("\n").replace(/\s+$/, "");
+  }
+
+  return {
+    key,
+    anchor: makeAnchorId(key),
+    source: source || null,
+    license: license || null,
+    fileNames: uniqSorted(fileNames),
+    flags: [],
+    licenseTexts: [],
+    usage: "",
+    notes,
+  };
+}
+
+function pickLine(body, re) {
+  const m = body.match(re);
+  return m ? m[1].trim() : "";
+}

package/src/render.js

@@ -1,6 +1,7 @@
 import os from "node:os";
 import path from "node:path";
 import { mdSafeText, uniqSorted } from "./fs-utils.js";
+import { LICENSE_FILES_LABEL } from "./constants.js";
 
 // メインのTHIRD-PARTY-LICENSE.mdを描画する
 export function renderMain(packages, opts) {
@@ -9,7 +10,7 @@ export function renderMain(packages, opts) {
 
   push("# Third-Party Licenses");
   push("");
-  push(`Generated from: ${opts.nodeModules}`);
+  push(`Generated from: ${opts.nodeModulesDisplay ?? opts.nodeModules}`);
   push("");
 
   for (const pkg of packages) {
@@ -17,19 +18,21 @@ export function renderMain(packages, opts) {
     push(`## ${pkg.key}`);
     push(`- Source: ${pkg.source ?? "(missing)"}`);
     push(`- License: ${pkg.license ?? "(missing)"}`);
+    push(`- Usage: ${describeUsage(pkg.usage)}`);
 
-    if (pkg.fileNames.length === 0) {
-      push("- (no LICENSE/NOTICE/COPYING files)");
+    const fileNames = pkg.fileNames ?? [];
+    if (fileNames.length === 0) {
+      push(`- (no ${LICENSE_FILES_LABEL} files)`);
       push("");
-      push("_No LICENSE/NOTICE/COPYING file found in package directory._");
+      push(`_No ${LICENSE_FILES_LABEL} file found in package directory._`);
       push("");
       continue;
     }
 
-    for (const n of pkg.fileNames) push(`- ${n}`);
+    for (const n of fileNames) push(`- ${n}`);
     push("");
 
-    for (const lic of pkg.licenseTexts) {
+    for (const lic of pkg.licenseTexts ?? []) {
       push(`### ${lic.name}`);
       push("```text");
       push(mdSafeText(lic.text).replace(/\s+$/, ""));
@@ -51,34 +54,41 @@ export function renderReview(
 ) {
   const lines = [];
   const push = (s = "") => lines.push(s);
-  const mainBase = path.basename(opts.outFile);
+  const mainPath = makeMainLinkPath(opts);
 
   push("# THIRD-PARTY-LICENSE-REVIEW");
   push("");
-  push(`Generated from: ${opts.nodeModules}`);
-  push(`Main file: ${mainBase}`);
+  push(`Generated from: ${opts.nodeModulesDisplay ?? opts.nodeModules}`);
+  push(`Main file: ${mainPath}`);
   push("");
 
   for (const it of [...packages].sort((a, b) => a.key.localeCompare(b.key))) {
     push(`## ${it.key}`);
-    push(`- Main: ${mainBase}#${it.anchor}`);
+    push(`- Main: ${mainPath}#${it.anchor}`);
     push(`- Source: ${it.source ?? "(missing)"}`);
     push(`- License: ${it.license ?? "(missing)"}`);
 
     push("- Files:");
-    if (it.fileNames.length === 0) {
+    const fileNames = it.fileNames ?? [];
+    if (fileNames.length === 0) {
       push("  - (none)");
     } else {
-      for (const f of it.fileNames) push(`  - ${f}`);
+      for (const f of fileNames) push(`  - ${f}`);
     }
 
-    if (it.flags.length === 0) {
-      push("- Status: Check manually");
-    } else {
-      push(`- Status: ${it.flags.join(" / ")}`);
-    }
+    const statusParts = [describeUsage(it.usage), ...(it.flags ?? [])].filter(
+      Boolean
+    );
+    const status =
+      statusParts.length === 0 ? "Check manually" : statusParts.join(" / ");
+    push(`- Status: ${status}`);
 
     push("- Notes:");
+    if (it.notes && it.notes.length > 0) {
+      for (const line of it.notes.split(/\r?\n/)) {
+        push(`  ${line}`);
+      }
+    }
     push("");
   }
 
@@ -98,7 +108,21 @@ export function renderReview(
 
   writeList("Missing Source", missingSource);
   writeList("Missing package.json license field", missingLicenseField);
-  writeList("Missing LICENSE/NOTICE/COPYING files", missingFiles);
+  writeList(`Missing ${LICENSE_FILES_LABEL} files`, missingFiles);
 
   return lines.join(os.EOL) + os.EOL;
 }
+
+function makeMainLinkPath(opts) {
+  const baseDir = path.dirname(opts.reviewFile);
+  const rel = path.relative(baseDir, opts.outFile);
+  const normalized = rel.replace(/\\/g, "/");
+  return normalized || path.basename(opts.outFile);
+}
+
+function describeUsage(usage) {
+  if (usage === "missing") {
+    return "Not found in node_modules (kept from previous output)";
+  }
+  return "Present in node_modules";
+}

package/src/scan.js

@@ -8,6 +8,7 @@ import {
   walkForPackageJson,
 } from "./fs-utils.js";
 import { getRepositoryUrl } from "./url.js";
+import { LICENSE_FILES_LABEL } from "./constants.js";
 
 // node_modules を走査してパッケージ情報を集約する
 export async function gatherPackages(opts) {
@@ -57,8 +58,9 @@ export async function gatherPackages(opts) {
 
     if (licFiles.length === 0) {
       missingFiles.push(key);
-      flags.push("Missing LICENSE/NOTICE/COPYING files");
-      opts.warn(`Missing LICENSE/NOTICE/COPYING in ${pkgDir} (${key})`);
+      const missingMsg = `Missing ${LICENSE_FILES_LABEL} files`;
+      flags.push(missingMsg);
+      opts.warn(`Missing ${LICENSE_FILES_LABEL} in ${pkgDir} (${key})`);
     }
 
     const licenseTexts =