@beastmode-develeap/beastmode 0.1.271 → 0.1.272

package/dist/index.js

@@ -6471,6 +6471,36 @@ Path: ${projectPath}
         return { status: "idle" };
       }
     },
+    // ── GET /api/projects/:name/codebase-guide ──
+    // Return the project's codebase guide content at a requested pyramid level.
+    // Levels: l0 (one-line .txt), l1 (paragraph .md, DEFAULT), l2 (full .md).
+    // Responds 200 with { level, content, meta } when the guide is available;
+    // 404 when analysis has not completed or the requested level file is missing.
+    {
+      method: "GET",
+      pattern: "/api/projects/:name/codebase-guide",
+      handler: (_body, params, query) => {
+        const { name } = params;
+        assertSafeName(name);
+        const projectsDir = join14(factoryDir, ".beastmode", "projects");
+        const meta = _readAnalyzeMeta(projectsDir, name);
+        if (!meta || meta.status !== "complete") {
+          throw new HttpError(404, {
+            error: "No codebase guide available",
+            status: meta?.status || "none"
+          });
+        }
+        const levelRaw = query?.level || "l1";
+        const level = levelRaw === "l0" || levelRaw === "l2" ? levelRaw : "l1";
+        const filename = level === "l0" ? "codebase-guide.l0.txt" : level === "l2" ? "codebase-guide.md" : "codebase-guide.l1.md";
+        const filePath = join14(projectsDir, name, filename);
+        if (!existsSync16(filePath)) {
+          throw new HttpError(404, { error: "Guide file not found" });
+        }
+        const content = readFileSync13(filePath, "utf-8");
+        return { level, content, meta };
+      }
+    },
     // ── Runs ──
     {
       method: "GET",