@dtd-dev/agent-kb 0.1.0 → 0.1.1

package/README.md

@@ -36,7 +36,9 @@ Không cài global, không cần clone. Zero-dependency nên `npx` chạy tức
 | `help` | Trợ giúp |
 
 Chạy tương tác sẽ hỏi: **tên dự án, backend, database, frontend, CI/CD, lệnh deploy, tool phụ**
-(Enter để giữ gợi ý). agent-kb **tự đọc `package.json`/`go.mod`/… để gợi ý stack & database sẵn**.
+(Enter để giữ gợi ý). agent-kb **tự đọc `package.json`/`go.mod`/… để gợi ý stack & database sẵn**
+— quét cả **thư mục con tới 3 cấp** nên hỗ trợ **monorepo** (vd `apps/web`, `services/api`). Nếu
+không thấy manifest nào, nó **báo rõ** và để bạn nhập tay (hoặc dùng cờ `--backend/--frontend/--database`).
 Các phần còn lại (cache, state, UI lib, container, URL môi trường, rollback…) là placeholder
 `<!-- vd: ... -->` trong file để bạn điền tay sau.
 

package/bin/cli.js

@@ -167,38 +167,86 @@ function substituteTokens(values) {
   }
 }
 
-// Đọc dự án để gợi ý stack — chỉ đọc file, không đổi gì.
-function detectStack() {
-  const out = { backend: null, frontend: null, database: null, cicd: null, stacks: [] };
-  const addStack = (s) => {
-    if (!out.stacks.includes(s)) out.stacks.push(s);
+// Thư mục rác/sinh ra — không quét để khỏi nhận diện nhầm & cho nhanh.
+const IGNORE_DIRS = new Set([
+  "node_modules", ".git", ".ai", ".claude", "dist", "build", "out",
+  ".next", ".nuxt", "coverage", "vendor", "target", ".gradle", ".venv", "venv", "__pycache__",
+]);
+const MANIFEST_NAMES = [
+  "package.json", "go.mod", "requirements.txt", "pyproject.toml", "Pipfile",
+  "pom.xml", "build.gradle", "build.gradle.kts", "Cargo.toml", "composer.json",
+];
+
+// Tìm các thư mục có manifest, quét tối đa maxDepth cấp từ root (bỏ thư mục rác/dotdir).
+function findProjectRoots(root, maxDepth) {
+  const roots = [];
+  const walk = (dir, depth) => {
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    if (entries.some((e) => e.isFile() && MANIFEST_NAMES.includes(e.name))) roots.push(dir);
+    if (depth >= maxDepth) return;
+    for (const e of entries) {
+      if (e.isDirectory() && !e.name.startsWith(".") && !IGNORE_DIRS.has(e.name)) {
+        walk(path.join(dir, e.name), depth + 1);
+      }
+    }
   };
+  walk(root, 0);
+  return roots;
+}
 
-  const pkg = readJSONSafe(path.join(CWD, "package.json"));
+// Nhận diện stack trong MỘT thư mục, gộp vào `out` (chỉ điền chỗ còn trống → root thắng subfolder).
+function detectInDir(dir, out, addStack) {
+  const exists = (f) => fs.existsSync(path.join(dir, f));
+  const pkg = readJSONSafe(path.join(dir, "package.json"));
   if (pkg) {
     const deps = Object.assign({}, pkg.dependencies, pkg.devDependencies);
     const has = (n) => Object.prototype.hasOwnProperty.call(deps, n);
-    if (has("next")) { out.frontend = "Next.js + React"; addStack("react"); }
-    else if (has("react")) { out.frontend = "React" + (has("vite") ? " + Vite" : ""); addStack("react"); }
-    else if (has("vue")) out.frontend = "Vue";
-    else if (has("svelte") || has("@sveltejs/kit")) out.frontend = "Svelte";
-
-    if (has("@nestjs/core")) { out.backend = "Node.js + NestJS"; addStack("node"); }
-    else if (has("express")) { out.backend = "Node.js + Express"; addStack("node"); }
-    else if (has("fastify")) { out.backend = "Node.js + Fastify"; addStack("node"); }
-    else if (!out.frontend) { out.backend = "Node.js"; addStack("node"); }
-
-    if (has("pg") || has("postgres") || has("postgresql")) out.database = "PostgreSQL";
-    else if (has("mysql") || has("mysql2")) out.database = "MySQL";
-    else if (has("mongoose") || has("mongodb")) out.database = "MongoDB";
-    else if (has("firebase") || has("firebase-admin")) out.database = "Firebase/Firestore";
-    if (has("redis") || has("ioredis")) out.database = out.database ? out.database + " + Redis" : "Redis";
-  }
-  if (hasFile("go.mod")) { out.backend = out.backend || "Go"; addStack("go"); }
-  if (hasFile("requirements.txt") || hasFile("pyproject.toml") || hasFile("Pipfile")) { out.backend = out.backend || "Python"; addStack("python"); }
-  if (hasFile("pom.xml") || hasFile("build.gradle") || hasFile("build.gradle.kts")) { out.backend = out.backend || "Java"; addStack("java"); }
-  if (hasFile("Cargo.toml")) { out.backend = out.backend || "Rust"; addStack("rust"); }
-  if (hasFile("composer.json")) { out.backend = out.backend || "PHP"; addStack("php"); }
+    let fe = null, be = null;
+    if (has("next")) { fe = "Next.js + React"; addStack("react"); }
+    else if (has("react")) { fe = "React" + (has("vite") ? " + Vite" : ""); addStack("react"); }
+    else if (has("vue")) fe = "Vue";
+    else if (has("svelte") || has("@sveltejs/kit")) fe = "Svelte";
+
+    if (has("@nestjs/core")) { be = "Node.js + NestJS"; addStack("node"); }
+    else if (has("express")) { be = "Node.js + Express"; addStack("node"); }
+    else if (has("fastify")) { be = "Node.js + Fastify"; addStack("node"); }
+    else if (!fe) { out._node = true; addStack("node"); } // Node "trơn": ưu tiên thấp nhất, quyết ở cuối
+
+    if (fe && !out.frontend) out.frontend = fe;
+    if (be && !out.backend) out.backend = be;
+
+    if (!out.database) {
+      if (has("pg") || has("postgres") || has("postgresql")) out.database = "PostgreSQL";
+      else if (has("mysql") || has("mysql2")) out.database = "MySQL";
+      else if (has("mongoose") || has("mongodb")) out.database = "MongoDB";
+      else if (has("firebase") || has("firebase-admin")) out.database = "Firebase/Firestore";
+    }
+    if ((has("redis") || has("ioredis")) && !(out.database || "").includes("Redis")) {
+      out.database = out.database ? out.database + " + Redis" : "Redis";
+    }
+  }
+  if (exists("go.mod")) { out.backend = out.backend || "Go"; addStack("go"); }
+  if (exists("requirements.txt") || exists("pyproject.toml") || exists("Pipfile")) { out.backend = out.backend || "Python"; addStack("python"); }
+  if (exists("pom.xml") || exists("build.gradle") || exists("build.gradle.kts")) { out.backend = out.backend || "Java"; addStack("java"); }
+  if (exists("Cargo.toml")) { out.backend = out.backend || "Rust"; addStack("rust"); }
+  if (exists("composer.json")) { out.backend = out.backend || "PHP"; addStack("php"); }
+}
+
+// Đọc dự án để gợi ý stack — chỉ đọc file, không đổi gì. Quét cả thư mục con (monorepo).
+function detectStack() {
+  const out = { backend: null, frontend: null, database: null, cicd: null, stacks: [], roots: [], _node: false };
+  const addStack = (s) => {
+    if (!out.stacks.includes(s)) out.stacks.push(s);
+  };
+
+  // Root (CWD) trước, rồi tới subfolder nông→sâu, để stack của thư mục gốc được ưu tiên.
+  const roots = findProjectRoots(CWD, 3).sort((a, b) => a.length - b.length);
+  for (const dir of roots) {
+    detectInDir(dir, out, addStack);
+    out.roots.push(path.relative(CWD, dir) || ".");
+  }
+  if (!out.backend && out._node) out.backend = "Node.js"; // fallback Node sau khi đã xét hết
 
   if (fs.existsSync(path.join(CWD, ".github", "workflows"))) out.cicd = "GitHub Actions";
   else if (hasFile(".gitlab-ci.yml")) out.cicd = "GitLab CI";
@@ -259,6 +307,14 @@ async function init() {
 
   if (det.backend || det.frontend || det.cicd) {
     console.log(`\nℹ  Nhận diện stack: ${[det.backend, det.frontend, det.database, det.cicd].filter(Boolean).join(" · ") || "—"}`);
+    if (det.roots.length > 1 || (det.roots.length === 1 && det.roots[0] !== ".")) {
+      console.log(`   (manifest tại: ${det.roots.join(", ")})`);
+    }
+  } else {
+    console.log("\n⚠  Không tự nhận diện được stack — không thấy manifest");
+    console.log("   (package.json / go.mod / requirements.txt / pyproject.toml / pom.xml / Cargo.toml / composer.json)");
+    console.log("   trong thư mục này hay các thư mục con (quét tối đa 3 cấp).");
+    console.log("   → Chạy ở đúng thư mục gốc dự án, hoặc nhập tay / dùng cờ --backend --frontend --database.");
   }
 
   if (!YES) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dtd-dev/agent-kb",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Bộ agent skill chuẩn hoá cho doanh nghiệp: scaffold knowledge base .ai/ tiết kiệm token, tăng độ chính xác khi viết code, và cá nhân hoá theo nghiệp vụ công ty để tái dùng cho nhiều dự án cùng nghiệp vụ (AGENTS.md, CLAUDE.md, GEMINI.md, Copilot).",
   "bin": {
     "agent-kb": "bin/cli.js"