add rule agent

Author: itsflaid

.gitignore

@@ -6,7 +6,6 @@ dist/
 *.log
 
 
-TEST.md
 
 # Test fixtures intentionally verify ignored paths.
 !packages/cli/test/fixtures/nextjs-project/.env

AGENTS.md

@@ -1,5 +1,31 @@
 # DevMap — Agent
 
+When working in this repository:
+
+- Create a branch before making changes unless the user explicitly asks to work on the current branch.
+- Use branch names with the `codex/` prefix, for example `codex/fix-analyzer`.
+- Keep changes scoped to the user request.
+- Do not revert unrelated user changes.
+- Prefer opening a pull request instead of pushing directly to `main`, unless the user explicitly asks to push to `main`.
+
+## Commits
+
+- Commit AI-authored work as:
+
+  ```bash
+  git -c user.name="devmap-agent" -c user.email="238585242+devmap-agent@users.noreply.github.com" commit -m "Clear commit message"
+  ```
+
+- Do not change global or repository Git config for the author identity unless the user explicitly asks.
+- If the user wants their own account as the main author, keep their author identity and add this trailer to the commit message:
+
+  ```text
+  Co-authored-by: devmap-agent <238585242+devmap-agent@users.noreply.github.com>
+  ```
+
+- Keep commit messages short, specific, and focused on the user-visible fix or feature.
+
+
 read PRD and all documentation first before hands-on.
 
 ## Source of Truth
@@ -8,6 +34,9 @@ The PRD is the source of truth for product behavior, requirements, and prioritie
 
 If there is any conflict between the PRD and other documents (README, docs, comments, plans, or specifications), follow the PRD.
 
+
+
+
 ## Relevant Skills
 
 ECC skills are stored in `.agents/skills/`.

docs/for-me-personal/DEBUG.md

@@ -558,6 +558,54 @@ cache yang sama. Smoke test distribusi harus deterministik dan berurutan.
 
 ---
 
+## 11. Pertanyaan NextAuth Jatuh ke Fallback Critical File
+
+**Tanggal:** 2026-06-11
+
+**Status:** Selesai.
+
+### Gejala
+
+Pada benchmark Context Builder, pertanyaan:
+
+```text
+Explain the NextAuth configuration
+```
+
+menempatkan `app/api/session/route.ts` di posisi pertama, bukan `lib/auth.ts`.
+File yang benar masih masuk top-3, tetapi top-1 accuracy hanya 19/20.
+
+### Akar Masalah
+
+Keyword tokenizer menghasilkan `nextauth`, sedangkan concept alias auth hanya
+memiliki `auth` dan tidak memiliki bentuk nama provider tersebut. Karena tidak
+ada direct match, ranking jatuh ke fallback critical file.
+
+### Solusi
+
+Tambahkan `nextauth` ke concept alias authentication.
+
+### Verifikasi
+
+```powershell
+pnpm --filter devmap exec tsx --test test/context-builder-eval.test.ts
+```
+
+Hasil:
+
+```text
+Context Builder top-1 accuracy: 20/20
+Context Builder top-3 recall: 20/20
+```
+
+### Pelajaran
+
+Concept alias perlu mencakup nama provider populer, bukan hanya nama concern
+generik. Eval bilingual membantu menemukan gap yang tidak terlihat dari unit
+test satu pertanyaan.
+
+---
+
 ## Checklist Saat Menambahkan Debug Baru
 
 Tambahkan catatan baru ketika:

docs/for-me-personal/PROGRESS.md

@@ -28,7 +28,11 @@ Terakhir diperbarui: 2026-06-11
 - File besar memakai relevant line window.
 - Path traversal dan symlink escape di luar project root ditolak.
 - `devmap ask` sudah memakai Context Builder secara lokal.
-- Automated test saat ini berjumlah 20 dan seluruhnya lulus.
+- Benchmark 20 pertanyaan mencakup auth, database, route session, halaman,
+  layout, payment, dan entry point dalam Bahasa Indonesia dan English.
+- Hasil benchmark saat ini: top-1 accuracy 20/20 dan top-3 recall 20/20.
+- Alias `nextauth` ditambahkan setelah eval menemukan satu fallback ranking yang
+  salah.
 - Context Builder sudah siap digunakan sebagai input AI layer.
 
 ### AI Ask
@@ -73,7 +77,7 @@ Terakhir diperbarui: 2026-06-11
 - Availability selected model ikut diperiksa.
 - Snapshot dibedakan menjadi valid, missing, corrupt, dan unsupported schema.
 - API key dan raw stack trace tidak pernah ditampilkan.
-- Automated test saat ini berjumlah 33 dan seluruhnya lulus.
+- Automated test saat ini berjumlah 34 dan seluruhnya lulus.
 
 ### Distribusi npm
 
@@ -113,7 +117,7 @@ Terakhir diperbarui: 2026-06-11
 
 1. Pastikan rerun GitHub Actions hijau pada seluruh 9 kombinasi.
 2. Lakukan manual verification Groq pada project nyata.
-3. Benchmark Context Builder dengan minimal 20 pertanyaan.
+3. Uji `init`, `analyze`, `ask`, dan `doctor` dari tarball pada project nyata.
 4. Tambahkan streaming output untuk jawaban AI jika waktu MVP masih tersedia.
 
 ## Status Saat Ini

docs/for-me-personal/TEST.md

@@ -78,8 +78,8 @@ Saat ini test mencakup:
 Hasil minimum yang diharapkan:
 
 ```text
-tests 33
-pass 33
+tests 34
+pass 34
 fail 0
 ```
 
@@ -120,8 +120,8 @@ npx -p node@20 node packages\cli\node_modules\tsx\dist\cli.mjs packages\cli\test
 Hasil minimum yang diharapkan untuk keduanya:
 
 ```text
-tests 33
-pass 33
+tests 34
+pass 34
 fail 0
 ```
 
@@ -149,6 +149,36 @@ Jalankan:
 pnpm test:cli
 ```
 
+## Benchmark Context Builder
+
+Benchmark deterministic berada di:
+
+```text
+packages/cli/test/context-builder-eval.test.ts
+```
+
+Jalankan benchmark saja:
+
+```powershell
+pnpm --filter devmap exec tsx --test test/context-builder-eval.test.ts
+```
+
+Benchmark terdiri dari 20 pertanyaan Bahasa Indonesia dan English untuk:
+
+- authentication dan NextAuth;
+- database dan Prisma;
+- API session;
+- page dan layout Next.js;
+- payment dan Stripe;
+- entry point Express.
+
+Target minimum saat ini:
+
+```text
+Context Builder top-1 accuracy: 20/20
+Context Builder top-3 recall: 20/20
+```
+
 ## Testing AI Ask dengan Groq
 
 Testing manual ini memakai API key dan dapat menggunakan quota Groq.

packages/cli/src/ai/contextBuilder.ts

@@ -28,7 +28,18 @@ const STOP_WORDS = new Set([
 ]);
 
 const CONCEPT_ALIASES: Record<string, string[]> = {
-  auth: ["auth", "authentication", "autentikasi", "login", "session", "sesi", "token", "jwt", "middleware"],
+  auth: [
+    "auth",
+    "authentication",
+    "autentikasi",
+    "login",
+    "session",
+    "sesi",
+    "token",
+    "jwt",
+    "middleware",
+    "nextauth"
+  ],
   database: ["database", "db", "data", "prisma", "drizzle", "mongoose", "supabase"],
   payment: ["payment", "payments", "pembayaran", "stripe", "midtrans", "checkout"],
   route: ["route", "routes", "routing", "api", "endpoint"],

packages/cli/test/context-builder-eval.test.ts

@@ -0,0 +1,184 @@
+import assert from "node:assert/strict";
+import { dirname, join } from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+import { buildQuestionContext } from "../src/ai/contextBuilder.js";
+import { createProjectMap } from "../src/analyzers/projectMap.js";
+
+const testDirectory = dirname(fileURLToPath(import.meta.url));
+const fixtures = {
+  nextjs: join(testDirectory, "fixtures", "nextjs-project"),
+  express: join(testDirectory, "fixtures", "express-project")
+} as const;
+
+type ContextEvalCase = {
+  name: string;
+  fixture: keyof typeof fixtures;
+  question: string;
+  expectedFile: string;
+};
+
+const evalCases: ContextEvalCase[] = [
+  {
+    name: "authentication architecture",
+    fixture: "nextjs",
+    question: "How does authentication work?",
+    expectedFile: "lib/auth.ts"
+  },
+  {
+    name: "Indonesian authentication",
+    fixture: "nextjs",
+    question: "Bagaimana autentikasi pengguna bekerja?",
+    expectedFile: "lib/auth.ts"
+  },
+  {
+    name: "session implementation",
+    fixture: "nextjs",
+    question: "Where is the user session implemented?",
+    expectedFile: "lib/auth.ts"
+  },
+  {
+    name: "login handling",
+    fixture: "nextjs",
+    question: "File mana yang menangani login?",
+    expectedFile: "lib/auth.ts"
+  },
+  {
+    name: "NextAuth configuration",
+    fixture: "nextjs",
+    question: "Explain the NextAuth configuration",
+    expectedFile: "lib/auth.ts"
+  },
+  {
+    name: "database client",
+    fixture: "nextjs",
+    question: "Where is the database client initialized?",
+    expectedFile: "lib/db.ts"
+  },
+  {
+    name: "Indonesian database connection",
+    fixture: "nextjs",
+    question: "Di mana koneksi database dibuat?",
+    expectedFile: "lib/db.ts"
+  },
+  {
+    name: "Prisma initialization",
+    fixture: "nextjs",
+    question: "Which file initializes Prisma?",
+    expectedFile: "lib/db.ts"
+  },
+  {
+    name: "database access module",
+    fixture: "nextjs",
+    question: "Show the main db module",
+    expectedFile: "lib/db.ts"
+  },
+  {
+    name: "session API endpoint",
+    fixture: "nextjs",
+    question: "Where is the session API endpoint?",
+    expectedFile: "app/api/session/route.ts"
+  },
+  {
+    name: "Indonesian session route",
+    fixture: "nextjs",
+    question: "Route API mana yang mengembalikan sesi?",
+    expectedFile: "app/api/session/route.ts"
+  },
+  {
+    name: "GET session handler",
+    fixture: "nextjs",
+    question: "Which GET endpoint handles session requests?",
+    expectedFile: "app/api/session/route.ts"
+  },
+  {
+    name: "home page",
+    fixture: "nextjs",
+    question: "Where is the main home page?",
+    expectedFile: "app/page.tsx"
+  },
+  {
+    name: "Indonesian main page",
+    fixture: "nextjs",
+    question: "File mana untuk page utama?",
+    expectedFile: "app/page.tsx"
+  },
+  {
+    name: "root layout",
+    fixture: "nextjs",
+    question: "Where is the root layout component?",
+    expectedFile: "app/layout.tsx"
+  },
+  {
+    name: "payment implementation",
+    fixture: "express",
+    question: "How are payments implemented?",
+    expectedFile: "src/routes/payments.ts"
+  },
+  {
+    name: "Indonesian payment",
+    fixture: "express",
+    question: "Di mana pembayaran diproses?",
+    expectedFile: "src/routes/payments.ts"
+  },
+  {
+    name: "Stripe setup",
+    fixture: "express",
+    question: "Which file configures Stripe?",
+    expectedFile: "src/routes/payments.ts"
+  },
+  {
+    name: "Express entry point",
+    fixture: "express",
+    question: "Where does the Express server start?",
+    expectedFile: "src/server.ts"
+  },
+  {
+    name: "Indonesian server entry",
+    fixture: "express",
+    question: "File mana yang menjalankan server utama?",
+    expectedFile: "src/server.ts"
+  }
+];
+
+test("context builder benchmark keeps relevant files in the top results", async (testContext) => {
+  const snapshots = {
+    nextjs: await createProjectMap(fixtures.nextjs),
+    express: await createProjectMap(fixtures.express)
+  };
+  const failures: string[] = [];
+  const topOneMisses: string[] = [];
+  let topOneHits = 0;
+
+  for (const evalCase of evalCases) {
+    const context = await buildQuestionContext(
+      fixtures[evalCase.fixture],
+      snapshots[evalCase.fixture],
+      evalCase.question
+    );
+    const rankedPaths = context.files.map((file) => file.path);
+    const expectedRank = rankedPaths.indexOf(evalCase.expectedFile);
+
+    if (expectedRank === 0) {
+      topOneHits += 1;
+    } else {
+      topOneMisses.push(
+        `${evalCase.name}: expected ${evalCase.expectedFile}, got ${rankedPaths[0] ?? "none"}`
+      );
+    }
+
+    if (expectedRank < 0 || expectedRank >= 3) {
+      failures.push(
+        `${evalCase.name}: expected ${evalCase.expectedFile}, got ${rankedPaths.join(", ")}`
+      );
+    }
+  }
+
+  assert.deepEqual(failures, []);
+  assert.equal(topOneHits, evalCases.length);
+  testContext.diagnostic(`Context Builder top-1 accuracy: ${topOneHits}/20`);
+  testContext.diagnostic("Context Builder top-3 recall: 20/20");
+  for (const miss of topOneMisses) {
+    testContext.diagnostic(`Top-1 miss: ${miss}`);
+  }
+});