@elysiumoss/grepo 0.2.0

package/lib/config.js

@@ -0,0 +1,149 @@
+import { GrepoValidationError } from "./errors.js";
+import { parseArgs } from "./utils/args.js";
+import { isValidGeminiApiKey, isValidGitHubUrl } from "./utils/validation.js";
+import { Schema } from "effect";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/config.ts
+/**
+*
+* Copyright 2026 Mike Odnis
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*
+*/
+const Command = Schema.Literal("readme", "topics", "describe", "summary", "tech", "improve");
+const OutputFormat = Schema.Literal("md", "mdx");
+const DocumentationStyle = Schema.Literal("minimal", "standard", "comprehensive");
+const GrepoConfig = Schema.Struct({
+	branch: Schema.String,
+	command: Command,
+	geminiApiKey: Schema.String,
+	githubToken: Schema.optional(Schema.String),
+	isDryRun: Schema.Boolean,
+	outputFile: Schema.String,
+	outputFormat: OutputFormat,
+	repoUrl: Schema.String,
+	shouldApply: Schema.Boolean,
+	shouldMerge: Schema.Boolean,
+	shouldPush: Schema.Boolean,
+	style: DocumentationStyle,
+	tone: Schema.optional(Schema.Literal("casual", "minimal", "professional", "technical"))
+});
+async function loadEnv() {
+	const envPath = resolve(dirname(fileURLToPath(import.meta.url)), "../.env");
+	if (!existsSync(envPath)) return;
+	const envContent = readFileSync(envPath, "utf-8");
+	for (const line of envContent.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("#")) continue;
+		const [key, ...valueParts] = trimmed.split("=");
+		if (key && valueParts.length > 0) {
+			const value = valueParts.join("=").trim().replaceAll(/(^["'])|(['"]$)/g, "");
+			if (!process.env[key.trim()]) process.env[key.trim()] = value;
+		}
+	}
+}
+const BOOLEAN_FLAGS = [
+	"push",
+	"apply",
+	"merge",
+	"dry-run"
+];
+const USAGE = `Usage: grepo <command> <github-url> [options]
+
+Commands:
+  readme    Generate README documentation
+  topics    Generate and apply repository topics
+  describe  Generate repository description and homepage URL
+  summary   Summarize repository
+  tech      List technologies used
+  improve   Suggest improvements
+
+Options:
+  --format md|mdx              Output format (readme only, default: md)
+  --style minimal|standard|comprehensive  Documentation style (readme only, default: standard)
+  --output <file>              Output file path (readme only)
+  --push                       Push to GitHub (readme only)
+  --apply                      Apply changes to GitHub (topics, describe)
+  --merge                      Merge with existing topics (topics only)
+  --dry-run                    Preview changes without applying
+  --branch <name>              Target branch (default: main)
+  --tone <voice>              Tone: casual, professional, minimal, technical (default: auto-detect)`;
+const VALID_TONES = [
+	"casual",
+	"professional",
+	"minimal",
+	"technical"
+];
+function validateTone(tone) {
+	if (!tone) return;
+	if (!VALID_TONES.includes(tone)) throw new GrepoValidationError({
+		field: "tone",
+		message: `Invalid tone "${tone}". Must be one of: ${VALID_TONES.join(", ")}`
+	});
+	return tone;
+}
+function buildConfig(argv) {
+	const { options, positional } = parseArgs(argv, [...BOOLEAN_FLAGS]);
+	if (positional.length < 2) {
+		console.log(USAGE);
+		process.exit(1);
+	}
+	const command = positional[0];
+	if (![
+		"readme",
+		"topics",
+		"describe",
+		"summary",
+		"tech",
+		"improve"
+	].includes(command)) {
+		console.error(`Unknown command: ${command}`);
+		console.log(USAGE);
+		process.exit(1);
+	}
+	const repoUrl = positional[1];
+	if (!isValidGitHubUrl(repoUrl)) throw new GrepoValidationError({
+		field: "repoUrl",
+		message: "Invalid GitHub URL"
+	});
+	const geminiApiKey = process.env.GEMINI_API_KEY ?? process.env.GOOGLE_API_KEY ?? "";
+	if (!isValidGeminiApiKey(geminiApiKey)) throw new GrepoValidationError({ message: "GEMINI_API_KEY is missing or invalid" });
+	const githubToken = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+	const shouldApply = !!options.apply;
+	const shouldPush = !!options.push;
+	const shouldMerge = !!options.merge;
+	if ((shouldApply || shouldPush || shouldMerge) && !githubToken) throw new GrepoValidationError({ message: "GitHub token (GITHUB_TOKEN or GH_TOKEN) is required for mutation operations" });
+	const format = options.format || "md";
+	return {
+		branch: options.branch || "main",
+		command,
+		geminiApiKey,
+		githubToken,
+		isDryRun: !!options["dry-run"],
+		outputFile: options.output || `README.${format}`,
+		outputFormat: format,
+		repoUrl,
+		shouldApply,
+		shouldMerge,
+		shouldPush,
+		style: options.style || "standard",
+		tone: validateTone(options.tone)
+	};
+}
+//#endregion
+export { Command, DocumentationStyle, GrepoConfig, OutputFormat, buildConfig, loadEnv };
+
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":["validation.isValidGitHubUrl","validation.isValidGeminiApiKey"],"sources":["../src/config.ts"],"sourcesContent":["/**\n *\n * Copyright 2026 Mike Odnis\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { Schema } from \"effect\";\n\nimport { GrepoValidationError } from \"./errors.js\";\nimport { parseArgs } from \"./utils/args.js\";\nimport * as validation from \"./utils/validation.js\";\n\n// ============================================================================\n// Config Schema\n// ============================================================================\n\nexport const Command = Schema.Literal(\n\t\"readme\",\n\t\"topics\",\n\t\"describe\",\n\t\"summary\",\n\t\"tech\",\n\t\"improve\",\n);\nexport type Command = Schema.Schema.Type<typeof Command>;\n\nexport const OutputFormat = Schema.Literal(\"md\", \"mdx\");\nexport type OutputFormat = Schema.Schema.Type<typeof OutputFormat>;\n\nexport const DocumentationStyle = Schema.Literal(\n\t\"minimal\",\n\t\"standard\",\n\t\"comprehensive\",\n);\nexport type DocumentationStyle = Schema.Schema.Type<typeof DocumentationStyle>;\n\nexport const GrepoConfig = Schema.Struct({\n\tbranch: Schema.String,\n\tcommand: Command,\n\tgeminiApiKey: Schema.String,\n\tgithubToken: Schema.optional(Schema.String),\n\tisDryRun: Schema.Boolean,\n\toutputFile: Schema.String,\n\toutputFormat: OutputFormat,\n\trepoUrl: Schema.String,\n\tshouldApply: Schema.Boolean,\n\tshouldMerge: Schema.Boolean,\n\tshouldPush: Schema.Boolean,\n\tstyle: DocumentationStyle,\n\ttone: Schema.optional(\n\t\tSchema.Literal(\"casual\", \"minimal\", \"professional\", \"technical\"),\n\t),\n});\nexport type GrepoConfig = Schema.Schema.Type<typeof GrepoConfig>;\n\n// ============================================================================\n// Env Loading\n// ============================================================================\n\nexport async function loadEnv(): Promise<void> {\n\tconst __filename = fileURLToPath(import.meta.url);\n\tconst __dirname = dirname(__filename);\n\tconst envPath = resolve(__dirname, \"../.env\");\n\n\tif (!existsSync(envPath)) {\n\t\treturn;\n\t}\n\n\tconst envContent = readFileSync(envPath, \"utf-8\");\n\tfor (const line of envContent.split(\"\\n\")) {\n\t\tconst trimmed = line.trim();\n\t\tif (!trimmed || trimmed.startsWith(\"#\")) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst [key, ...valueParts] = trimmed.split(\"=\");\n\t\tif (key && valueParts.length > 0) {\n\t\t\tconst value = valueParts\n\t\t\t\t.join(\"=\")\n\t\t\t\t.trim()\n\t\t\t\t.replaceAll(/(^[\"'])|(['\"]$)/g, \"\");\n\t\t\tif (!process.env[key.trim()]) {\n\t\t\t\tprocess.env[key.trim()] = value;\n\t\t\t}\n\t\t}\n\t}\n}\n\n// ============================================================================\n// Config Builder\n// ============================================================================\n\nconst BOOLEAN_FLAGS = [\"push\", \"apply\", \"merge\", \"dry-run\"] as const;\n\nconst USAGE = `Usage: grepo <command> <github-url> [options]\n\nCommands:\n  readme    Generate README documentation\n  topics    Generate and apply repository topics\n  describe  Generate repository description and homepage URL\n  summary   Summarize repository\n  tech      List technologies used\n  improve   Suggest improvements\n\nOptions:\n  --format md|mdx              Output format (readme only, default: md)\n  --style minimal|standard|comprehensive  Documentation style (readme only, default: standard)\n  --output <file>              Output file path (readme only)\n  --push                       Push to GitHub (readme only)\n  --apply                      Apply changes to GitHub (topics, describe)\n  --merge                      Merge with existing topics (topics only)\n  --dry-run                    Preview changes without applying\n  --branch <name>              Target branch (default: main)\n  --tone <voice>              Tone: casual, professional, minimal, technical (default: auto-detect)`;\n\nconst VALID_TONES = [\"casual\", \"professional\", \"minimal\", \"technical\"] as const;\n\nfunction validateTone(tone: string | undefined): GrepoConfig[\"tone\"] {\n\tif (!tone) {\n\t\treturn undefined;\n\t}\n\tif (!VALID_TONES.includes(tone as (typeof VALID_TONES)[number])) {\n\t\tthrow new GrepoValidationError({\n\t\t\tfield: \"tone\",\n\t\t\tmessage: `Invalid tone \"${tone}\". Must be one of: ${VALID_TONES.join(\", \")}`,\n\t\t});\n\t}\n\treturn tone as GrepoConfig[\"tone\"];\n}\n\nexport function buildConfig(argv: string[]): GrepoConfig {\n\tconst { options, positional } = parseArgs(argv, [...BOOLEAN_FLAGS]);\n\n\tif (positional.length < 2) {\n\t\tconsole.log(USAGE);\n\t\tprocess.exit(1);\n\t}\n\n\tconst command = positional[0];\n\tconst validCommands: Command[] = [\n\t\t\"readme\",\n\t\t\"topics\",\n\t\t\"describe\",\n\t\t\"summary\",\n\t\t\"tech\",\n\t\t\"improve\",\n\t];\n\tif (!validCommands.includes(command as Command)) {\n\t\tconsole.error(`Unknown command: ${command}`);\n\t\tconsole.log(USAGE);\n\t\tprocess.exit(1);\n\t}\n\n\tconst repoUrl = positional[1];\n\tif (!validation.isValidGitHubUrl(repoUrl)) {\n\t\tthrow new GrepoValidationError({\n\t\t\tfield: \"repoUrl\",\n\t\t\tmessage: \"Invalid GitHub URL\",\n\t\t});\n\t}\n\n\tconst geminiApiKey =\n\t\tprocess.env.GEMINI_API_KEY ?? process.env.GOOGLE_API_KEY ?? \"\";\n\tif (!validation.isValidGeminiApiKey(geminiApiKey)) {\n\t\tthrow new GrepoValidationError({\n\t\t\tmessage: \"GEMINI_API_KEY is missing or invalid\",\n\t\t});\n\t}\n\n\tconst githubToken = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;\n\tconst shouldApply = !!options.apply;\n\tconst shouldPush = !!options.push;\n\tconst shouldMerge = !!options.merge;\n\n\tif ((shouldApply || shouldPush || shouldMerge) && !githubToken) {\n\t\tthrow new GrepoValidationError({\n\t\t\tmessage:\n\t\t\t\t\"GitHub token (GITHUB_TOKEN or GH_TOKEN) is required for mutation operations\",\n\t\t});\n\t}\n\n\tconst format = (options.format as string) || \"md\";\n\treturn {\n\t\tbranch: (options.branch as string) || \"main\",\n\t\tcommand: command as Command,\n\t\tgeminiApiKey,\n\t\tgithubToken,\n\t\tisDryRun: !!options[\"dry-run\"],\n\t\toutputFile: (options.output as string) || `README.${format}`,\n\t\toutputFormat: format as OutputFormat,\n\t\trepoUrl,\n\t\tshouldApply,\n\t\tshouldMerge,\n\t\tshouldPush,\n\t\tstyle: ((options.style as string) || \"standard\") as DocumentationStyle,\n\t\ttone: validateTone(options.tone as string | undefined),\n\t};\n}\n"],"mappings":"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"}

package/lib/errors.d.ts

@@ -0,0 +1,55 @@
+import * as effect_Types0 from "effect/Types";
+import * as effect_Cause0 from "effect/Cause";
+
+//#region src/errors.d.ts
+
+/**
+ *
+ * Copyright 2026 Mike Odnis
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+declare const GrepoValidationError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "GrepoValidationError";
+} & Readonly<A>;
+declare class GrepoValidationError extends GrepoValidationError_base<{
+  readonly message: string;
+  readonly field?: string;
+}> {}
+declare const GeminiError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "GeminiError";
+} & Readonly<A>;
+declare class GeminiError extends GeminiError_base<{
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+declare const GitHubError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "GitHubError";
+} & Readonly<A>;
+declare class GitHubError extends GitHubError_base<{
+  readonly message: string;
+  readonly statusCode?: number;
+  readonly endpoint?: string;
+}> {}
+declare const GitIngestError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "GitIngestError";
+} & Readonly<A>;
+declare class GitIngestError extends GitIngestError_base<{
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+type GrepoError = GeminiError | GitHubError | GitIngestError | GrepoValidationError;
+//#endregion
+export { GeminiError, GitHubError, GitIngestError, GrepoError, GrepoValidationError };
+//# sourceMappingURL=errors.d.ts.map

package/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../src/errors.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,uCAA0C,EAAA,IAAA,CAAA,gBAAA,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,IAAA,sBAAA,EAAA,EAAA,CAAA,CAAA,CAAA,SAAA,IAAA,GAAA,IAAA,GAAA,iBAAA,OAAA,KAAA,SAAA,MAAA,GAAA,KAAA,IAAA,IAAA,EAAA,CAAA,EAAA,EAAA,kCAAA;EAKrC,SAAA,IAAA,EAAA,sBAAA;;cALQ,oBAAA,SAA6B;;;;cAKrC;;;cAEQ,WAAA,SAAoB;;;AAAjC,CAAA,CAAA,CAAA;cAGK;;;cAEQ,WAAA,SAAoB;;;;;cAI5B;;;AAJQ,cAMA,cAAA,SAAuB,mBANH,CAAA;EAI5B,SAAA,OAAA,EAAA,MAAA;;;KAOO,UAAA,GACT,cACA,cACA,iBACA"}

package/lib/errors.js

@@ -0,0 +1,27 @@
+import { Data } from "effect";
+//#region src/errors.ts
+/**
+*
+* Copyright 2026 Mike Odnis
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*
+*/
+var GrepoValidationError = class extends Data.TaggedError("GrepoValidationError") {};
+var GeminiError = class extends Data.TaggedError("GeminiError") {};
+var GitHubError = class extends Data.TaggedError("GitHubError") {};
+var GitIngestError = class extends Data.TaggedError("GitIngestError") {};
+//#endregion
+export { GeminiError, GitHubError, GitIngestError, GrepoValidationError };
+
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n *\n * Copyright 2026 Mike Odnis\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n */\n\nimport { Data } from \"effect\";\n\nexport class GrepoValidationError extends Data.TaggedError(\n\t\"GrepoValidationError\",\n)<{\n\treadonly message: string;\n\treadonly field?: string;\n}> {}\n\nexport class GeminiError extends Data.TaggedError(\"GeminiError\")<{\n\treadonly message: string;\n\treadonly cause?: unknown;\n}> {}\n\nexport class GitHubError extends Data.TaggedError(\"GitHubError\")<{\n\treadonly message: string;\n\treadonly statusCode?: number;\n\treadonly endpoint?: string;\n}> {}\n\nexport class GitIngestError extends Data.TaggedError(\"GitIngestError\")<{\n\treadonly message: string;\n\treadonly cause?: unknown;\n}> {}\n\nexport type GrepoError =\n\t| GeminiError\n\t| GitHubError\n\t| GitIngestError\n\t| GrepoValidationError;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoBA,IAAa,uBAAb,cAA0C,KAAK,YAC9C,uBACA,CAGE;AAEH,IAAa,cAAb,cAAiC,KAAK,YAAY,cAAc,CAG7D;AAEH,IAAa,cAAb,cAAiC,KAAK,YAAY,cAAc,CAI7D;AAEH,IAAa,iBAAb,cAAoC,KAAK,YAAY,iBAAiB,CAGnE"}

package/lib/index.d.ts

@@ -0,0 +1,14 @@
+import { GeminiError, GitHubError, GitIngestError, GrepoError, GrepoValidationError } from "./errors.js";
+import { Command, DocumentationStyle, GrepoConfig, OutputFormat, buildConfig, loadEnv } from "./config.js";
+import { fetchRepositoryContent } from "./utils/gitingest.js";
+import { Gemini, GeminiLive, GeminiServiceApi, GitHub, GitHubLive, GitHubServiceApi, RepoData, fetchRepo } from "./services.js";
+import { run } from "./commands/analyze.js";
+import { run as run$1 } from "./commands/describe.js";
+import { run as run$2 } from "./commands/readme.js";
+import { run as run$3 } from "./commands/topics.js";
+import { extractMermaidBlocks, validateAndFixMermaid } from "./mermaid.js";
+import { AnalysisResult, DEFAULT_ANALYSIS, GenerationOptions, STYLE_GUIDANCE, Tone, buildAnalysisPrompt, buildExistingReadmeInstructions, buildGenerationPrompt, extractExistingReadme, parseAnalysis } from "./prompts/readme.js";
+import { GeminiService } from "./utils/gemini.js";
+import { GitHubClient } from "./utils/github.js";
+import { Logger } from "./utils/logger.js";
+export { type AnalysisResult, type Command, DEFAULT_ANALYSIS, type DocumentationStyle, Gemini, GeminiError, GeminiLive, GeminiService, type GeminiServiceApi, type GenerationOptions, GitHub, GitHubClient, GitHubError, GitHubLive, type GitHubServiceApi, GitIngestError, type GrepoConfig, type GrepoError, GrepoValidationError, Logger, type OutputFormat, type RepoData, STYLE_GUIDANCE, type Tone, run as analyze, buildAnalysisPrompt, buildConfig, buildExistingReadmeInstructions, buildGenerationPrompt, run$1 as describe, extractExistingReadme, extractMermaidBlocks, fetchRepo, fetchRepositoryContent, loadEnv, parseAnalysis, run$2 as readme, run$3 as topics, validateAndFixMermaid };

package/lib/index.js

@@ -0,0 +1,14 @@
+import { GeminiError, GitHubError, GitIngestError, GrepoValidationError } from "./errors.js";
+import { buildConfig, loadEnv } from "./config.js";
+import { Logger } from "./utils/logger.js";
+import { GeminiService } from "./utils/gemini.js";
+import { GitHubClient } from "./utils/github.js";
+import { fetchRepositoryContent } from "./utils/gitingest.js";
+import { Gemini, GeminiLive, GitHub, GitHubLive, fetchRepo } from "./services.js";
+import { run } from "./commands/analyze.js";
+import { run as run$1 } from "./commands/describe.js";
+import { extractMermaidBlocks, validateAndFixMermaid } from "./mermaid.js";
+import { DEFAULT_ANALYSIS, STYLE_GUIDANCE, buildAnalysisPrompt, buildExistingReadmeInstructions, buildGenerationPrompt, extractExistingReadme, parseAnalysis } from "./prompts/readme.js";
+import { run as run$2 } from "./commands/readme.js";
+import { run as run$3 } from "./commands/topics.js";
+export { DEFAULT_ANALYSIS, Gemini, GeminiError, GeminiLive, GeminiService, GitHub, GitHubClient, GitHubError, GitHubLive, GitIngestError, GrepoValidationError, Logger, STYLE_GUIDANCE, run as analyze, buildAnalysisPrompt, buildConfig, buildExistingReadmeInstructions, buildGenerationPrompt, run$1 as describe, extractExistingReadme, extractMermaidBlocks, fetchRepo, fetchRepositoryContent, loadEnv, parseAnalysis, run$2 as readme, run$3 as topics, validateAndFixMermaid };

package/lib/mermaid.d.ts

@@ -0,0 +1,17 @@
+import { GeminiServiceApi } from "./services.js";
+import { Effect, Schema } from "effect";
+
+//#region src/mermaid.d.ts
+
+declare const MermaidBlock: Schema.Struct<{
+  code: typeof Schema.String;
+  end: typeof Schema.Number;
+  index: typeof Schema.Number;
+  start: typeof Schema.Number;
+}>;
+type MermaidBlock = Schema.Schema.Type<typeof MermaidBlock>;
+declare function extractMermaidBlocks(markdown: string): MermaidBlock[];
+declare const validateAndFixMermaid: (content: string, gemini: GeminiServiceApi, maxRetries?: number) => Effect.Effect<string, never>;
+//#endregion
+export { MermaidBlock, extractMermaidBlocks, validateAndFixMermaid };
+//# sourceMappingURL=mermaid.d.ts.map

package/lib/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","names":[],"sources":["../src/mermaid.ts"],"sourcesContent":[],"mappings":";;;;;cA+Ba,cAAY,MAAA,CAAA;;;;;;KAMb,YAAA,GAAe,MAAA,CAAO,MAAA,CAAO,YAAY;iBAErC,oBAAA,oBAAwC;cA2E3C,iDAEJ,0CAEN,MAAA,CAAO"}

package/lib/mermaid.js

@@ -0,0 +1,132 @@
+import { Logger as Logger$1 } from "./utils/logger.js";
+import { Effect, Schema } from "effect";
+import { join } from "node:path";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { tmpdir } from "node:os";
+import { promisify } from "node:util";
+//#region src/mermaid.ts
+/**
+*
+* Copyright 2026 Mike Odnis
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*
+*/
+const execFileAsync = promisify(execFile);
+const logger = new Logger$1("GREPO:MERMAID");
+const MermaidBlock = Schema.Struct({
+	code: Schema.String,
+	end: Schema.Number,
+	index: Schema.Number,
+	start: Schema.Number
+});
+function extractMermaidBlocks(markdown) {
+	const blocks = [];
+	const regex = /```mermaid\n([\s\S]*?)```/g;
+	let index = 0;
+	for (let match = regex.exec(markdown); match !== null; match = regex.exec(markdown)) blocks.push({
+		code: match[1].trim(),
+		end: match.index + match[0].length,
+		index: index++,
+		start: match.index
+	});
+	return blocks;
+}
+async function validateBlock(block) {
+	const dir = await mkdtemp(join(tmpdir(), "mermaid-"));
+	const inputFile = join(dir, "input.mmd");
+	const outputFile = join(dir, "output.svg");
+	try {
+		await writeFile(inputFile, block.code);
+		await execFileAsync("npx", [
+			"mmdc",
+			"-i",
+			inputFile,
+			"-o",
+			outputFile,
+			"-e",
+			"svg"
+		], { timeout: 15e3 });
+		return { valid: true };
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		return {
+			error: (err && typeof err === "object" && "stderr" in err && typeof err.stderr === "string" ? err.stderr : "").trim() || message,
+			valid: false
+		};
+	} finally {
+		await rm(dir, {
+			force: true,
+			recursive: true
+		}).catch(() => {});
+	}
+}
+function buildFixPrompt(code, error) {
+	return `The following Mermaid diagram has a syntax error. Fix it and return ONLY the corrected Mermaid code — no fences, no explanation.
+
+<broken_diagram>
+${code}
+</broken_diagram>
+
+<error>
+${error}
+</error>
+
+Common fixes:
+- Wrap labels with special chars in quotes: A["Label (info)"]
+- Use --> not -> in flowcharts
+- Use ->> not --> in sequence diagrams
+- Use "flowchart" not "graph"
+- Subgraph IDs cannot have spaces
+- No semicolons at end of lines
+
+Return ONLY the fixed Mermaid code.`;
+}
+const validateAndFixMermaid = (content, gemini, maxRetries = 2) => Effect.gen(function* () {
+	const blocks = extractMermaidBlocks(content);
+	if (blocks.length === 0) return content;
+	logger.info(`Validating ${blocks.length} Mermaid diagram(s)...`);
+	let result = content;
+	for (const block of blocks) {
+		let currentCode = block.code;
+		let attempt = 0;
+		let validation = yield* Effect.promise(() => validateBlock({
+			...block,
+			code: currentCode
+		}));
+		while (!validation.valid && attempt < maxRetries) {
+			attempt++;
+			logger.warn(`Diagram ${block.index + 1} invalid (attempt ${attempt}/${maxRetries}): ${validation.error}`);
+			const fixPrompt = buildFixPrompt(currentCode, validation.error ?? "Unknown error");
+			currentCode = (yield* Effect.catchAll(gemini.generateContent(fixPrompt), () => Effect.succeed(currentCode))).replace(/^```(?:mermaid)?\s*/i, "").replace(/\s*```\s*$/, "").trim();
+			validation = yield* Effect.promise(() => validateBlock({
+				...block,
+				code: currentCode
+			}));
+		}
+		if (validation.valid && currentCode !== block.code) {
+			logger.success(`Diagram ${block.index + 1} fixed after ${attempt} attempt(s)`);
+			result = result.replace(`\`\`\`mermaid\n${block.code}\n\`\`\``, `\`\`\`mermaid\n${currentCode}\n\`\`\``);
+		} else if (validation.valid) logger.success(`Diagram ${block.index + 1} valid`);
+		else {
+			logger.warn(`Diagram ${block.index + 1} could not be fixed, removing it`);
+			result = result.replace(`\`\`\`mermaid\n${block.code}\n\`\`\``, "");
+		}
+	}
+	return result;
+});
+//#endregion
+export { MermaidBlock, extractMermaidBlocks, validateAndFixMermaid };
+
+//# sourceMappingURL=mermaid.js.map

package/lib/mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.js","names":["Logger"],"sources":["../src/mermaid.ts"],"sourcesContent":["/**\n *\n * Copyright 2026 Mike Odnis\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n */\n\nimport { execFile } from \"node:child_process\";\nimport { mkdtemp, rm, writeFile } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\nimport { Effect, Schema } from \"effect\";\n\nimport type { GeminiServiceApi } from \"./services.js\";\nimport { Logger } from \"./utils/logger.js\";\n\nconst execFileAsync = promisify(execFile);\nconst logger = new Logger(\"GREPO:MERMAID\");\n\nexport const MermaidBlock = Schema.Struct({\n\tcode: Schema.String,\n\tend: Schema.Number,\n\tindex: Schema.Number,\n\tstart: Schema.Number,\n});\nexport type MermaidBlock = Schema.Schema.Type<typeof MermaidBlock>;\n\nexport function extractMermaidBlocks(markdown: string): MermaidBlock[] {\n\tconst blocks: MermaidBlock[] = [];\n\tconst regex = /```mermaid\\n([\\s\\S]*?)```/g;\n\tlet index = 0;\n\n\tfor (\n\t\tlet match = regex.exec(markdown);\n\t\tmatch !== null;\n\t\tmatch = regex.exec(markdown)\n\t) {\n\t\tblocks.push({\n\t\t\tcode: match[1].trim(),\n\t\t\tend: match.index + match[0].length,\n\t\t\tindex: index++,\n\t\t\tstart: match.index,\n\t\t});\n\t}\n\n\treturn blocks;\n}\n\nasync function validateBlock(\n\tblock: MermaidBlock,\n): Promise<{ error?: string; valid: boolean }> {\n\tconst dir = await mkdtemp(join(tmpdir(), \"mermaid-\"));\n\tconst inputFile = join(dir, \"input.mmd\");\n\tconst outputFile = join(dir, \"output.svg\");\n\n\ttry {\n\t\tawait writeFile(inputFile, block.code);\n\n\t\tawait execFileAsync(\n\t\t\t\"npx\",\n\t\t\t[\"mmdc\", \"-i\", inputFile, \"-o\", outputFile, \"-e\", \"svg\"],\n\t\t\t{ timeout: 15_000 },\n\t\t);\n\n\t\treturn { valid: true };\n\t} catch (err) {\n\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\tconst stderr =\n\t\t\terr &&\n\t\t\ttypeof err === \"object\" &&\n\t\t\t\"stderr\" in err &&\n\t\t\ttypeof err.stderr === \"string\"\n\t\t\t\t? err.stderr\n\t\t\t\t: \"\";\n\t\treturn { error: stderr.trim() || message, valid: false };\n\t} finally {\n\t\tawait rm(dir, { force: true, recursive: true }).catch(() => {});\n\t}\n}\n\nfunction buildFixPrompt(code: string, error: string): string {\n\treturn `The following Mermaid diagram has a syntax error. Fix it and return ONLY the corrected Mermaid code — no fences, no explanation.\n\n<broken_diagram>\n${code}\n</broken_diagram>\n\n<error>\n${error}\n</error>\n\nCommon fixes:\n- Wrap labels with special chars in quotes: A[\"Label (info)\"]\n- Use --> not -> in flowcharts\n- Use ->> not --> in sequence diagrams\n- Use \"flowchart\" not \"graph\"\n- Subgraph IDs cannot have spaces\n- No semicolons at end of lines\n\nReturn ONLY the fixed Mermaid code.`;\n}\n\nexport const validateAndFixMermaid = (\n\tcontent: string,\n\tgemini: GeminiServiceApi,\n\tmaxRetries = 2,\n): Effect.Effect<string, never> =>\n\tEffect.gen(function* () {\n\t\tconst blocks = extractMermaidBlocks(content);\n\t\tif (blocks.length === 0) {\n\t\t\treturn content;\n\t\t}\n\n\t\tlogger.info(`Validating ${blocks.length} Mermaid diagram(s)...`);\n\t\tlet result = content;\n\n\t\tfor (const block of blocks) {\n\t\t\tlet currentCode = block.code;\n\t\t\tlet attempt = 0;\n\t\t\tlet validation = yield* Effect.promise(() =>\n\t\t\t\tvalidateBlock({ ...block, code: currentCode }),\n\t\t\t);\n\n\t\t\twhile (!validation.valid && attempt < maxRetries) {\n\t\t\t\tattempt++;\n\t\t\t\tlogger.warn(\n\t\t\t\t\t`Diagram ${block.index + 1} invalid (attempt ${attempt}/${maxRetries}): ${validation.error}`,\n\t\t\t\t);\n\n\t\t\t\tconst fixPrompt = buildFixPrompt(\n\t\t\t\t\tcurrentCode,\n\t\t\t\t\tvalidation.error ?? \"Unknown error\",\n\t\t\t\t);\n\t\t\t\tconst fixed: string = yield* Effect.catchAll(\n\t\t\t\t\tgemini.generateContent(fixPrompt),\n\t\t\t\t\t() => Effect.succeed(currentCode),\n\t\t\t\t);\n\n\t\t\t\tcurrentCode = fixed\n\t\t\t\t\t.replace(/^```(?:mermaid)?\\s*/i, \"\")\n\t\t\t\t\t.replace(/\\s*```\\s*$/, \"\")\n\t\t\t\t\t.trim();\n\n\t\t\t\tvalidation = yield* Effect.promise(() =>\n\t\t\t\t\tvalidateBlock({ ...block, code: currentCode }),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (validation.valid && currentCode !== block.code) {\n\t\t\t\tlogger.success(\n\t\t\t\t\t`Diagram ${block.index + 1} fixed after ${attempt} attempt(s)`,\n\t\t\t\t);\n\t\t\t\tresult = result.replace(\n\t\t\t\t\t`\\`\\`\\`mermaid\\n${block.code}\\n\\`\\`\\``,\n\t\t\t\t\t`\\`\\`\\`mermaid\\n${currentCode}\\n\\`\\`\\``,\n\t\t\t\t);\n\t\t\t} else if (validation.valid) {\n\t\t\t\tlogger.success(`Diagram ${block.index + 1} valid`);\n\t\t\t} else {\n\t\t\t\tlogger.warn(\n\t\t\t\t\t`Diagram ${block.index + 1} could not be fixed, removing it`,\n\t\t\t\t);\n\t\t\t\tresult = result.replace(`\\`\\`\\`mermaid\\n${block.code}\\n\\`\\`\\``, \"\");\n\t\t\t}\n\t\t}\n\n\t\treturn result;\n\t});\n"],"mappings":"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"}

package/lib/prompts/readme.d.ts

@@ -0,0 +1,90 @@
+import { DocumentationStyle } from "../config.js";
+import { Schema } from "effect";
+
+//#region src/prompts/readme.d.ts
+
+declare const DiagramSchema: Schema.Struct<{
+  keyNodes: Schema.Array$<typeof Schema.String>;
+  purpose: typeof Schema.String;
+  scope: typeof Schema.String;
+  type: Schema.Literal<["c4-context", "er", "flowchart", "sequence", "state"]>;
+}>;
+declare const ExistingReadmeSchema: Schema.Struct<{
+  improve: Schema.Array$<typeof Schema.String>;
+  missing: Schema.Array$<typeof Schema.String>;
+  preserve: Schema.Array$<typeof Schema.String>;
+  quality: Schema.Literal<["decent", "good", "none", "poor"]>;
+}>;
+declare const IdentitySchema: Schema.Struct<{
+  differentiators: Schema.Array$<typeof Schema.String>;
+  name: typeof Schema.String;
+  oneLiner: typeof Schema.String;
+}>;
+declare const SectionsSchema: Schema.Struct<{
+  recommended: Schema.Array$<typeof Schema.String>;
+  skip: Schema.Array$<Schema.Struct<{
+    reason: typeof Schema.String;
+    section: typeof Schema.String;
+  }>>;
+}>;
+declare const ToneSchema: Schema.Literal<["casual", "minimal", "professional", "technical"]>;
+type Tone = Schema.Schema.Type<typeof ToneSchema>;
+declare const ToneDetectionSchema: Schema.Struct<{
+  detected: Schema.Literal<["casual", "minimal", "professional", "technical"]>;
+  evidence: typeof Schema.String;
+}>;
+declare const AnalysisResult: Schema.Struct<{
+  diagrams: Schema.Array$<Schema.Struct<{
+    keyNodes: Schema.Array$<typeof Schema.String>;
+    purpose: typeof Schema.String;
+    scope: typeof Schema.String;
+    type: Schema.Literal<["c4-context", "er", "flowchart", "sequence", "state"]>;
+  }>>;
+  existingReadme: Schema.Struct<{
+    improve: Schema.Array$<typeof Schema.String>;
+    missing: Schema.Array$<typeof Schema.String>;
+    preserve: Schema.Array$<typeof Schema.String>;
+    quality: Schema.Literal<["decent", "good", "none", "poor"]>;
+  }>;
+  identity: Schema.Struct<{
+    differentiators: Schema.Array$<typeof Schema.String>;
+    name: typeof Schema.String;
+    oneLiner: typeof Schema.String;
+  }>;
+  repoType: typeof Schema.String;
+  sections: Schema.Struct<{
+    recommended: Schema.Array$<typeof Schema.String>;
+    skip: Schema.Array$<Schema.Struct<{
+      reason: typeof Schema.String;
+      section: typeof Schema.String;
+    }>>;
+  }>;
+  tone: Schema.Struct<{
+    detected: Schema.Literal<["casual", "minimal", "professional", "technical"]>;
+    evidence: typeof Schema.String;
+  }>;
+}>;
+type AnalysisResult = Schema.Schema.Type<typeof AnalysisResult>;
+declare const GenerationOptions: Schema.Struct<{
+  format: Schema.Literal<["md", "mdx"]>;
+  style: Schema.Literal<["minimal", "standard", "comprehensive"]>;
+  tone: Schema.optional<Schema.Literal<["casual", "minimal", "professional", "technical"]>>;
+}>;
+type GenerationOptions = Schema.Schema.Type<typeof GenerationOptions>;
+declare const RepoData: Schema.Struct<{
+  content: typeof Schema.String;
+  repo_url: typeof Schema.String;
+  summary: typeof Schema.String;
+  tree: typeof Schema.String;
+}>;
+type RepoData = Schema.Schema.Type<typeof RepoData>;
+declare const DEFAULT_ANALYSIS: AnalysisResult;
+declare function extractExistingReadme(content: string): string | null;
+declare function parseAnalysis(raw: string): AnalysisResult;
+declare function buildAnalysisPrompt(repoData: RepoData, existingReadme?: string): string;
+declare const STYLE_GUIDANCE: Record<DocumentationStyle, string>;
+declare function buildExistingReadmeInstructions(analysis: AnalysisResult): string;
+declare function buildGenerationPrompt(analysis: AnalysisResult, repoData: RepoData, options: GenerationOptions): string;
+//#endregion
+export { AnalysisResult, DEFAULT_ANALYSIS, DiagramSchema, ExistingReadmeSchema, GenerationOptions, IdentitySchema, RepoData, STYLE_GUIDANCE, SectionsSchema, Tone, ToneDetectionSchema, ToneSchema, buildAnalysisPrompt, buildExistingReadmeInstructions, buildGenerationPrompt, extractExistingReadme, parseAnalysis };
+//# sourceMappingURL=readme.d.ts.map

package/lib/prompts/readme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.d.ts","names":[],"sources":["../../src/prompts/readme.ts"],"sourcesContent":[],"mappings":";;;;;cA2Ba,eAAa,MAAA,CAAA;EAOO,QAAA,eAAA,CAAA,oBAAA,CAAA;EAAA,OAAA,EAAA,oBAAA;EAOpB,KAAA,EAAA,oBAIX;;;cAXW,sBAAoB,MAAA,CAAA;;EAON,OAAA,eAAA,CAAA,oBAAA,CAAA;EAAA,QAAA,eAAA,CAAA,oBAAA,CAAA;EAMd,OAAA,gBAQX,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;;cAdW,gBAAc,MAAA,CAAA;;;;;AAMA,cAAd,cAAc,EAAA,MAAA,CAAA,MAAA,CAAA;EAAA,WAAA,eAAA,CAAA,oBAAA,CAAA;EAUd,IAAA,eAKZ,cALsB,CAAA;IAMX,MAAI,EAAA,oBAAG;IAEN,OAAA,EAAA,oBAGX;;;AAH8B,cARnB,UAQmB,EART,MAAA,CAAA,OAQS,CAAA,CAAA,QAAA,EAAA,SAAA,EAAA,cAAA,EAAA,WAAA,CAAA,CAAA;AAAA,KAFpB,IAAA,GAAO,MAAA,CAAO,MAAA,CAAO,IAED,CAAA,OAFa,UAEb,CAAA;AAKnB,cALA,mBAYX,EAZ8B,MAAA,CAAA,MAY9B,CAAA;;;;cAPW,gBAAc,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAA,QAAA,EAAA,oBAAA;EAAA,CAAA,CAAA;AAQ3B,CAAA,CAAA;AAEa,KAFD,cAAA,GAAiB,MAAA,CAAO,MAAA,CAAO,IAMzC,CAAA,OANqD,cAMrD,CAAA;cAJW,mBAAiB,MAAA,CAAA;;;;CAAA,CAAA;AAAA,KAKlB,iBAAA,GAAoB,MAAA,CAAO,MAAA,CAAO,IALhB,CAAA,OAK4B,iBAL5B,CAAA;AAKlB,cAMC,QANgB,EAMR,MAAA,CAAA,MANqC,CAAA;EAM7C,OAAA,EAAA,oBAKX;;;;;AALmB,KAMT,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,IANhB,CAAA,OAM4B,QAN5B,CAAA;AAAA,cAYR,gBAZQ,EAYU,cAZV;AAMT,iBA0CI,qBAAA,CA1Cc,OAAO,EAAA,MAAI,CAAA,EAAA,MAAA,GAAA,IAAA;AAM5B,iBA+CG,aAAA,CA/Ce,GAAA,EAAA,MAAA,CA8B9B,EAiB2C,cAjB3C;AAMe,iBAyCA,mBAAA,CAzCqB,QAAA,EA0C1B,QA1C0B,EAAA,cAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAWrB,cA4HH,cA5H+B,EA4Hf,MA5He,CA4HR,kBA5HsB,EAAA,MAAA,CAAA;AA8B1C,iBAuGA,+BAAA,CAtGG,QAAA,EAuGR,cAvGQ,CAAA,EAAA,MAAA;AA6FN,iBA6CG,qBAAA,CA7CoB,QAAP,EA8ClB,cA9CwB,EAAA,QAAA,EA+CxB,QA/CwB,EAAA,OAAA,EAgDzB,iBAhDyB,CAAA,EAAA,MAAA"}