Merge branch 'main' into codex/render-ai-markdown

Author: devmap-agent

docs/for-me-personal/TEST.md

@@ -616,3 +616,38 @@ npm exec --yes --cache "$env:TEMP\devmap-help" --package $tarball -- devmap --he
 ```
 
 Jangan menjalankan dua instalasi `npx` secara paralel dengan cache yang sama.
+
+### End-to-End Project Sementara
+
+Pasang tarball pada project sementara yang memiliki:
+
+- `package.json` dengan dependency Express;
+- `src/server.ts` dengan satu route;
+- `AGENTS.md` yang sudah memiliki isi.
+
+Jalankan binary dari `node_modules/.bin`:
+
+```powershell
+devmap --version
+devmap --help
+devmap init
+devmap analyze
+devmap ask "where is the server entry point?"
+devmap doctor
+```
+
+Tanpa `GROQ_API_KEY`, hasil yang diharapkan:
+
+- `init` exit `1` dengan pesan actionable dan tidak membuat config parsial;
+- `analyze`, `ask`, dan `doctor` exit `0`;
+- `ask` menampilkan static context;
+- snapshot mendeteksi Express, npm, dan route project;
+- lockfile package manager tidak masuk `fileIndex` atau statistik line;
+- `AGENTS.md` yang sudah ada tidak berubah.
+
+Dengan `GROQ_API_KEY` valid, ulangi flow untuk memverifikasi:
+
+- `init` membuat config, `.gitignore`, dan `DEVMAP.md`;
+- `analyze` menghasilkan AI architecture interpretation;
+- `ask` menghasilkan jawaban AI dan token usage;
+- `doctor` memvalidasi key dan model.

packages/cli/src/analyzers/filterEngine.ts

@@ -25,17 +25,30 @@ const IGNORED_EXTENSIONS = new Set([
   ".zip"
 ]);
 
+const IGNORED_FILES = new Set([
+  "package-lock.json",
+  "npm-shrinkwrap.json",
+  "pnpm-lock.yaml",
+  "yarn.lock",
+  "bun.lock",
+  "bun.lockb"
+]);
+
 export function shouldIgnorePath(path: string, isDirectory: boolean): boolean {
   const segments = path.split("/");
   if (segments.some((segment) => IGNORED_DIRECTORIES.has(segment))) {
     return true;
   }
 
+  if (!isDirectory && IGNORED_FILES.has(segments.at(-1) ?? "")) {
+    return true;
+  }
+
   if (path.startsWith(".env") || path.includes("/.env")) {
     return true;
   }
 
-  if (path.includes("public/assets/") || path.endsWith(".min.ts") || path.endsWith("-lock.yaml")) {
+  if (path.includes("public/assets/") || path.endsWith(".min.ts")) {
     return true;
   }
 

packages/cli/test/analyzers.test.ts

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 import test from "node:test";
 import { buildDependencyGraph, countReferences } from "../src/analyzers/dependencyGraph.js";
 import { scanFiles } from "../src/analyzers/fileScanner.js";
+import { shouldIgnorePath } from "../src/analyzers/filterEngine.js";
 import { detectFramework } from "../src/analyzers/frameworkDetector.js";
 import { createProjectMap } from "../src/analyzers/projectMap.js";
 import { detectExternalServices } from "../src/analyzers/serviceDetector.js";
@@ -32,6 +33,19 @@ test("scanner ignores generated and secret paths", async () => {
   assert.ok(!paths.some((path) => path.startsWith(".env")));
 });
 
+test("scanner ignores package manager lockfiles", () => {
+  for (const lockfile of [
+    "package-lock.json",
+    "npm-shrinkwrap.json",
+    "pnpm-lock.yaml",
+    "yarn.lock",
+    "bun.lock",
+    "bun.lockb"
+  ]) {
+    assert.equal(shouldIgnorePath(lockfile, false), true, lockfile);
+  }
+});
+
 test("framework detector recognizes Next.js and Express fixtures", async () => {
   const nextFiles = await scanFiles(nextFixture);
   const expressFiles = await scanFiles(expressFixture);