explainthisrepo 0.4.0 → 0.4.1

package/dist/cli.js

@@ -6,7 +6,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
 import { fetchRepo, fetchReadme } from "./github.js";
-import { buildPrompt, buildSimplePrompt } from "./prompt.js";
+import { buildPrompt, buildQuickPrompt, buildSimplePrompt } from "./prompt.js";
 import { generateExplanation } from "./generate.js";
 import { writeOutput } from "./writer.js";
 import { readRepoSignalFiles } from "./repo_reader.js";
@@ -192,41 +192,39 @@ Examples:
         console.warn(`Warning: Could not fetch README: ${e?.message || e}`);
         readme = null;
     }
-    let readResult = null;
-    if (!options.quick) {
+    if (options.quick) {
+        const prompt = buildQuickPrompt(repoData.full_name, repoData.description, readme);
+        console.log("Generating explanation...");
+        let output;
         try {
-            readResult = await readRepoSignalFiles(owner, repo);
+            output = await generateExplanation(prompt);
         }
         catch (e) {
-            console.warn(`Warning: Could not read repo files: ${e?.message || e}`);
-            readResult = null;
+            console.error("Failed to generate explanation.");
+            console.error(`error: ${e?.message || e}`);
+            console.error("\nfix:");
+            console.error("- Ensure GEMINI_API_KEY is set");
+            console.error("- Or run: explainthisrepo --doctor");
+            process.exit(1);
         }
-    }
-    const prompt = buildPrompt(repoData.full_name, repoData.description, readme, options.detailed || false, options.quick || false, readResult?.treeText ?? null, readResult?.filesText ?? null);
-    console.log("Generating explanation...");
-    let output;
-    try {
-        output = await generateExplanation(prompt);
-    }
-    catch (e) {
-        console.error("Failed to generate explanation.");
-        console.error(`error: ${e?.message || e}`);
-        console.error("\nfix:");
-        console.error("- Ensure GEMINI_API_KEY is set");
-        console.error("- Or run: explainthisrepo --doctor");
-        process.exit(1);
-    }
-    if (options.quick) {
         console.log("Quick summary 🎉");
         console.log(output.trim());
         return;
     }
     if (options.simple) {
-        console.log("Summarizing...");
-        const simplePrompt = buildSimplePrompt(output);
-        let simpleOutput;
+        let readResult = null;
         try {
-            simpleOutput = await generateExplanation(simplePrompt);
+            readResult = await readRepoSignalFiles(owner, repo);
+        }
+        catch (e) {
+            console.warn(`Warning: Could not read repo files: ${e?.message || e}`);
+            readResult = null;
+        }
+        const prompt = buildSimplePrompt(repoData.full_name, repoData.description, readme, readResult?.treeText ?? null);
+        console.log("Generating explanation...");
+        let output;
+        try {
+            output = await generateExplanation(prompt);
         }
         catch (e) {
             console.error("Failed to generate explanation.");
@@ -237,9 +235,31 @@ Examples:
             process.exit(1);
         }
         console.log("Simple summary 🎉");
-        console.log(simpleOutput.trim());
+        console.log(output.trim());
         return;
     }
+    let readResult = null;
+    try {
+        readResult = await readRepoSignalFiles(owner, repo);
+    }
+    catch (e) {
+        console.warn(`Warning: Could not read repo files: ${e?.message || e}`);
+        readResult = null;
+    }
+    const prompt = buildPrompt(repoData.full_name, repoData.description, readme, options.detailed || false, readResult?.treeText ?? null, readResult?.filesText ?? null);
+    console.log("Generating explanation...");
+    let output;
+    try {
+        output = await generateExplanation(prompt);
+    }
+    catch (e) {
+        console.error("Failed to generate explanation.");
+        console.error(`error: ${e?.message || e}`);
+        console.error("\nfix:");
+        console.error("- Ensure GEMINI_API_KEY is set");
+        console.error("- Or run: explainthisrepo --doctor");
+        process.exit(1);
+    }
     console.log("Writing EXPLAIN.md...");
     writeOutput(output);
     const wordCount = output.split(/\s+/).filter(Boolean).length;

package/dist/prompt.d.ts

@@ -1,2 +1,3 @@
-export declare function buildPrompt(repoName: string, description: string | null, readme: string | null, detailed?: boolean, quick?: boolean, treeText?: string | null, filesText?: string | null): string;
-export declare function buildSimplePrompt(longExplanation: string): string;
+export declare function buildPrompt(repoName: string, description: string | null, readme: string | null, detailed?: boolean, treeText?: string | null, filesText?: string | null): string;
+export declare function buildQuickPrompt(repoName: string, description: string | null, readme: string | null): string;
+export declare function buildSimplePrompt(repoName: string, description: string | null, readme: string | null, treeText?: string | null): string;

package/dist/prompt.js

@@ -1,28 +1,4 @@
-export function buildPrompt(repoName, description, readme, detailed = false, quick = false, treeText = null, filesText = null) {
-    if (quick) {
-        const readmeSnippet = (readme || "").slice(0, 2000);
-        return `
-You are a senior software engineer.
-
-Write a ONE-SENTENCE plain-English definition of what this GitHub repository is.
-
-Repository:
-- Name: ${repoName}
-- Description: ${description || "No description provided"}
-
-README snippet:
-${readmeSnippet || "No README provided"}
-
-Rules:
-- Output MUST be exactly 1 sentence.
-- Plain English.
-- No markdown.
-- No quotes.
-- No bullet points.
-- No extra text.
-- Do not add features not stated in the description/README.
-`.trim();
-    }
+export function buildPrompt(repoName, description, readme, detailed = false, treeText = null, filesText = null) {
     let prompt = `You are a senior software engineer.
 
 Your task is to explain a GitHub repository clearly and concisely for a human reader.
@@ -34,10 +10,10 @@ Repository:
 README content:
 ${readme || "No README provided"}
 
-Repository structure:
-${treeText || "No tree provided"}
+Repo structure:
+${treeText || "No file tree provided"}
 
-Key files (snippets):
+Key code files:
 ${filesText || "No code files provided"}
 
 Instructions:
@@ -70,14 +46,46 @@ Output format:
 `;
     return prompt.trim();
 }
-export function buildSimplePrompt(longExplanation) {
-    return `
-You are a senior software engineer.
+export function buildQuickPrompt(repoName, description, readme) {
+    const readmeSnippet = (readme || "No README provided").slice(0, 2000);
+    const prompt = `You are a senior software engineer.
+
+Write a ONE-SENTENCE plain-English definition of what this GitHub repository is.
+
+Repository:
+- Name: ${repoName}
+- Description: ${description || "No description provided"}
+
+README snippet:
+${readmeSnippet}
+
+Rules:
+- Output MUST be exactly 1 sentence.
+- Plain English.
+- No markdown.
+- No quotes.
+- No bullet points.
+- No extra text.
+- Do not add features not stated in the description/README.
+`;
+    return prompt.trim();
+}
+export function buildSimplePrompt(repoName, description, readme, treeText = null) {
+    const readmeContent = (readme || "No README provided").slice(0, 4000);
+    const treeContent = (treeText || "No file tree provided").slice(0, 1500);
+    const prompt = `You are a senior software engineer.
+
+Summarize this GitHub repository in a concise bullet-point format.
+
+Repository:
+- Name: ${repoName}
+- Description: ${description || "No description provided"}
 
-Rewrite the long repository explanation below into a SIMPLE version in the exact style specified.
+README content:
+${readmeContent}
 
-Input explanation:
-${longExplanation}
+Repo structure:
+${treeContent}
 
 Output style rules:
 - Plain English.
@@ -89,13 +97,13 @@ Key points from the repo:
 - Each bullet MUST start with: ⬤
 - Each bullet title should be 1–3 words only (example: "Purpose", "Stack", "Entrypoints", "How it works", "Usage", "Structure").
 - Each bullet body should be 1–2 lines max.
-- If the input contains architecture/pipeline steps, capture them naturally.
-- If the input does NOT contain architecture/pipeline steps, do NOT invent them.
+- Base bullets strictly on the provided README and structure.
+- Do NOT invent features, architecture, or details not present in the input.
 - Optional: end with one extra line starting with:
 Also interesting:
-- Do NOT add features not present in the input.
 - No quotes.
 
 Make it feel like a human developer explaining to another developer in simple terms.
-`.trim();
+`;
+    return prompt.trim();
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "explainthisrepo",
-  "version": "0.4.0",
-  "description": "ExplainThisRepo is a CLI developer tool to explain any GitHub repository in plain English",
+  "version": "0.4.1",
+  "description": "A CLI developer tool to explain any GitHub repository in plain English",
   "license": "MIT",
   "type": "module",
   "author": "Caleb Wodi <calebwodi33@gmail.com>",
@@ -40,7 +40,7 @@
     "prepublishOnly": "npm run build"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "dependencies": {
     "@google/generative-ai": "^0.24.1",