@elysiumoss/grepo 0.2.0

package/LICENSE.md

@@ -0,0 +1,20 @@
+# MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+<h1 align="center">package-template</h1>
+
+<p align="center">
+	A very lovely package.
+	Hooray!
+</p>
+
+<p align="center">
+	<!-- prettier-ignore-start -->
+	<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+	<a href="#contributors" target="_blank"><img alt="👪 All Contributors: 2" src="https://img.shields.io/badge/%F0%9F%91%AA_all_contributors-2-21bb42.svg" /></a>
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+	<!-- prettier-ignore-end -->
+	<a href="https://github.com/ElysiumOSS/package-template/blob/main/.github/CODE_OF_CONDUCT.md" target="_blank"><img alt="🤝 Code of Conduct: Kept" src="https://img.shields.io/badge/%F0%9F%A4%9D_code_of_conduct-kept-21bb42" /></a>
+	<a href="https://codecov.io/gh/ElysiumOSS/package-template" target="_blank"><img alt="🧪 Coverage" src="https://img.shields.io/codecov/c/github/ElysiumOSS/package-template?label=%F0%9F%A7%AA%20coverage" /></a>
+	<a href="https://github.com/ElysiumOSS/package-template/blob/main/LICENSE.md" target="_blank"><img alt="📝 License: MIT" src="https://img.shields.io/badge/%F0%9F%93%9D_license-MIT-21bb42.svg" /></a>
+	<a href="http://npmjs.com/package/package-template" target="_blank"><img alt="📦 npm version" src="https://img.shields.io/npm/v/package-template?color=21bb42&label=%F0%9F%93%A6%20npm" /></a>
+	<img alt="💪 TypeScript: Strict" src="https://img.shields.io/badge/%F0%9F%92%AA_typescript-strict-21bb42.svg" />
+</p>
+
+## Usage
+
+```shell
+npm i package-template
+```
+
+```ts
+import { greet } from "package-template";
+
+greet("Hello, world! 💖");
+```
+
+## Development
+
+See [`.github/CONTRIBUTING.md`](./.github/CONTRIBUTING.md), then [`.github/DEVELOPMENT.md`](./.github/DEVELOPMENT.md).
+Thanks! 💖
+
+## Contributors
+
+<!-- spellchecker: disable -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center"><a href="https://github.com/ElysiumOSS"><img src="https://avatars.githubusercontent.com/u/155137850?v=4?s=100" width="100px;" alt="Elysium Open Source"/><br /><sub><b>Elysium Open Source</b></sub></a><br /><a href="https://github.com/ElysiumOSS/package-template/commits?author=ElysiumOSS" title="Code">💻</a> <a href="#content-ElysiumOSS" title="Content">🖋</a> <a href="https://github.com/ElysiumOSS/package-template/commits?author=ElysiumOSS" title="Documentation">📖</a> <a href="#ideas-ElysiumOSS" title="Ideas, Planning, & Feedback">🤔</a> <a href="#infra-ElysiumOSS" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#maintenance-ElysiumOSS" title="Maintenance">🚧</a> <a href="#projectManagement-ElysiumOSS" title="Project Management">📆</a> <a href="#tool-ElysiumOSS" title="Tools">🔧</a></td>
+      <td align="center"><a href="https://linktr.ee/mikeodnis"><img src="https://avatars.githubusercontent.com/u/95197809?v=4?s=100" width="100px;" alt="Mike Odnis"/><br /><sub><b>Mike Odnis</b></sub></a><br /><a href="https://github.com/ElysiumOSS/package-template/commits?author=WomB0ComB0" title="Code">💻</a> <a href="#content-WomB0ComB0" title="Content">🖋</a> <a href="https://github.com/ElysiumOSS/package-template/commits?author=WomB0ComB0" title="Documentation">📖</a> <a href="#ideas-WomB0ComB0" title="Ideas, Planning, & Feedback">🤔</a> <a href="#infra-WomB0ComB0" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#maintenance-WomB0ComB0" title="Maintenance">🚧</a> <a href="#projectManagement-WomB0ComB0" title="Project Management">📆</a> <a href="#tool-WomB0ComB0" title="Tools">🔧</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- spellchecker: enable -->
+
+<!-- You can remove this notice if you don't want it 🙂 no worries! -->
+
+> 💝 This package was templated with [`create-typescript-app`](https://github.com/JoshuaKGoldberg/create-typescript-app) using the [Bingo framework](https://create.bingo).

package/lib/cli.d.ts

@@ -0,0 +1 @@
+export { };

package/lib/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { buildConfig, loadEnv } from "./config.js";
+import { Logger as Logger$1 } from "./utils/logger.js";
+import { GeminiLive, GitHubLive } from "./services.js";
+import { Effect, Layer } from "effect";
+//#region src/cli.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 logger = new Logger$1("GREPO");
+await loadEnv();
+const argv = process.argv.slice(2);
+if (argv.length === 0) {
+	console.log(`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
+
+Run 'grepo <command> --help' for more information.`);
+	process.exit(0);
+}
+const config = buildConfig(argv);
+const layers = Layer.merge(GeminiLive(config.geminiApiKey), GitHubLive(config.githubToken));
+let run;
+switch (config.command) {
+	case "readme":
+		run = (await import("./commands/readme.js")).run;
+		break;
+	case "topics":
+		run = (await import("./commands/topics.js")).run;
+		break;
+	case "describe":
+		run = (await import("./commands/describe.js")).run;
+		break;
+	case "summary":
+	case "tech":
+	case "improve":
+		run = (await import("./commands/analyze.js")).run;
+		break;
+}
+await Effect.runPromise(run(config).pipe(Effect.provide(layers), Effect.catchTags({
+	GeminiError: (e) => Effect.sync(() => {
+		logger.error(`Gemini Error: ${e.message}`);
+		process.exit(1);
+	}),
+	GitHubError: (e) => Effect.sync(() => {
+		logger.error(`GitHub Error (${e.endpoint}): ${e.message}`, void 0, { status: e.statusCode });
+		process.exit(1);
+	}),
+	GitIngestError: (e) => Effect.sync(() => {
+		logger.error(`GitIngest Error: ${e.message}`);
+		process.exit(1);
+	}),
+	GrepoValidationError: (e) => Effect.sync(() => {
+		logger.error(`Validation Error: ${e.message}`, void 0, { field: e.field });
+		process.exit(1);
+	})
+}))).catch((error) => {
+	logger.error("An unexpected error occurred", error);
+	process.exit(1);
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.js.map

package/lib/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":["Logger"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\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 { Effect, Layer } from \"effect\";\n\nimport type { GrepoConfig } from \"./config.js\";\nimport { buildConfig, loadEnv } from \"./config.js\";\nimport type {\n\tGeminiError,\n\tGitHubError,\n\tGitIngestError,\n\tGrepoValidationError,\n} from \"./errors.js\";\nimport type { Gemini, GitHub } from \"./services.js\";\nimport { GeminiLive, GitHubLive } from \"./services.js\";\nimport { Logger } from \"./utils/logger.js\";\n\nconst logger = new Logger(\"GREPO\");\n\nawait loadEnv();\n\nconst argv = process.argv.slice(2);\n\nif (argv.length === 0) {\n\tconsole.log(`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\nRun 'grepo <command> --help' for more information.`);\n\tprocess.exit(0);\n}\n\nconst config = buildConfig(argv);\n\nconst layers = Layer.merge(\n\tGeminiLive(config.geminiApiKey),\n\tGitHubLive(config.githubToken),\n);\n\ntype CommandRunner = (\n\tconfig: GrepoConfig,\n) => Effect.Effect<\n\tvoid,\n\tGeminiError | GitHubError | GitIngestError | GrepoValidationError,\n\tGemini | GitHub\n>;\n\nlet run: CommandRunner;\n\nswitch (config.command) {\n\tcase \"readme\":\n\t\trun = (await import(\"./commands/readme.js\")).run;\n\t\tbreak;\n\tcase \"topics\":\n\t\trun = (await import(\"./commands/topics.js\")).run;\n\t\tbreak;\n\tcase \"describe\":\n\t\trun = (await import(\"./commands/describe.js\")).run;\n\t\tbreak;\n\tcase \"summary\":\n\tcase \"tech\":\n\tcase \"improve\":\n\t\trun = (await import(\"./commands/analyze.js\")).run;\n\t\tbreak;\n}\n\nawait Effect.runPromise(\n\trun(config).pipe(\n\t\tEffect.provide(layers),\n\t\tEffect.catchTags({\n\t\t\tGeminiError: (e) =>\n\t\t\t\tEffect.sync(() => {\n\t\t\t\t\tlogger.error(`Gemini Error: ${e.message}`);\n\t\t\t\t\tprocess.exit(1);\n\t\t\t\t}),\n\t\t\tGitHubError: (e) =>\n\t\t\t\tEffect.sync(() => {\n\t\t\t\t\tlogger.error(\n\t\t\t\t\t\t`GitHub Error (${e.endpoint}): ${e.message}`,\n\t\t\t\t\t\tundefined,\n\t\t\t\t\t\t{ status: e.statusCode },\n\t\t\t\t\t);\n\t\t\t\t\tprocess.exit(1);\n\t\t\t\t}),\n\t\t\tGitIngestError: (e) =>\n\t\t\t\tEffect.sync(() => {\n\t\t\t\t\tlogger.error(`GitIngest Error: ${e.message}`);\n\t\t\t\t\tprocess.exit(1);\n\t\t\t\t}),\n\t\t\tGrepoValidationError: (e) =>\n\t\t\t\tEffect.sync(() => {\n\t\t\t\t\tlogger.error(`Validation Error: ${e.message}`, undefined, {\n\t\t\t\t\t\tfield: e.field,\n\t\t\t\t\t});\n\t\t\t\t\tprocess.exit(1);\n\t\t\t\t}),\n\t\t}),\n\t),\n).catch((error) => {\n\tlogger.error(\"An unexpected error occurred\", error);\n\tprocess.exit(1);\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAM,SAAS,IAAIA,SAAO,QAAQ;AAElC,MAAM,SAAS;AAEf,MAAM,OAAO,QAAQ,KAAK,MAAM,EAAE;AAElC,IAAI,KAAK,WAAW,GAAG;AACtB,SAAQ,IAAI;;;;;;;;;;oDAUuC;AACnD,SAAQ,KAAK,EAAE;;AAGhB,MAAM,SAAS,YAAY,KAAK;AAEhC,MAAM,SAAS,MAAM,MACpB,WAAW,OAAO,aAAa,EAC/B,WAAW,OAAO,YAAY,CAC9B;AAUD,IAAI;AAEJ,QAAQ,OAAO,SAAf;CACC,KAAK;AACJ,SAAO,MAAM,OAAO,yBAAyB;AAC7C;CACD,KAAK;AACJ,SAAO,MAAM,OAAO,yBAAyB;AAC7C;CACD,KAAK;AACJ,SAAO,MAAM,OAAO,2BAA2B;AAC/C;CACD,KAAK;CACL,KAAK;CACL,KAAK;AACJ,SAAO,MAAM,OAAO,0BAA0B;AAC9C;;AAGF,MAAM,OAAO,WACZ,IAAI,OAAO,CAAC,KACX,OAAO,QAAQ,OAAO,EACtB,OAAO,UAAU;CAChB,cAAc,MACb,OAAO,WAAW;AACjB,SAAO,MAAM,iBAAiB,EAAE,UAAU;AAC1C,UAAQ,KAAK,EAAE;GACd;CACH,cAAc,MACb,OAAO,WAAW;AACjB,SAAO,MACN,iBAAiB,EAAE,SAAS,KAAK,EAAE,WACnC,KAAA,GACA,EAAE,QAAQ,EAAE,YAAY,CACxB;AACD,UAAQ,KAAK,EAAE;GACd;CACH,iBAAiB,MAChB,OAAO,WAAW;AACjB,SAAO,MAAM,oBAAoB,EAAE,UAAU;AAC7C,UAAQ,KAAK,EAAE;GACd;CACH,uBAAuB,MACtB,OAAO,WAAW;AACjB,SAAO,MAAM,qBAAqB,EAAE,WAAW,KAAA,GAAW,EACzD,OAAO,EAAE,OACT,CAAC;AACF,UAAQ,KAAK,EAAE;GACd;CACH,CAAC,CACF,CACD,CAAC,OAAO,UAAU;AAClB,QAAO,MAAM,gCAAgC,MAAM;AACnD,SAAQ,KAAK,EAAE;EACd"}

package/lib/commands/analyze.d.ts

@@ -0,0 +1,11 @@
+import { GeminiError, GitIngestError } from "../errors.js";
+import { GrepoConfig } from "../config.js";
+import { Gemini } from "../services.js";
+import { Effect } from "effect";
+
+//#region src/commands/analyze.d.ts
+
+declare const run: (config: GrepoConfig) => Effect.Effect<void, GitIngestError | GeminiError, Gemini>;
+//#endregion
+export { run };
+//# sourceMappingURL=analyze.d.ts.map

package/lib/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","names":[],"sources":["../../src/commands/analyze.ts"],"sourcesContent":[],"mappings":";;;;;;;cAmCa,cAAe,gBAAW,MAAA,CAAA,aAAA,cAAA,GAAA,aAAA"}

package/lib/commands/analyze.js

@@ -0,0 +1,49 @@
+import { SEPARATOR, displayHeader } from "../utils/args.js";
+import { Logger as Logger$1 } from "../utils/logger.js";
+import { Gemini, fetchRepo } from "../services.js";
+import { Effect } from "effect";
+//#region src/commands/analyze.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 logger = new Logger$1("GREPO:ANALYZE");
+const PROMPTS = {
+	improve: "Suggest 5 specific, actionable improvements for this repository.",
+	summary: "Provide a comprehensive 2-3 paragraph summary of this repository.",
+	tech: "List all technologies, frameworks, and tools used in this repository as a categorized markdown list."
+};
+const run = (config) => Effect.gen(function* () {
+	const gemini = yield* Gemini;
+	const analysisType = config.command;
+	displayHeader(`grepo ${analysisType}`, { Repository: config.repoUrl });
+	logger.info("Fetching repository content via GitIngest...");
+	const repoData = yield* fetchRepo(config.repoUrl);
+	logger.success("Content fetched successfully");
+	logger.info(`Running ${analysisType} analysis via Gemini...`);
+	const prompt = `${PROMPTS[analysisType]}\n\nTree:\n${repoData.tree}\n\nContent:\n${repoData.content.slice(0, 4e3)}`;
+	const result = yield* gemini.generateContent(prompt);
+	logger.success("Analysis complete");
+	console.log();
+	console.log(SEPARATOR);
+	console.log(result);
+	console.log(SEPARATOR);
+	console.log();
+});
+//#endregion
+export { run };
+
+//# sourceMappingURL=analyze.js.map

package/lib/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","names":["Logger"],"sources":["../../src/commands/analyze.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 { Effect } from \"effect\";\n\nimport type { GrepoConfig } from \"../config.js\";\nimport { fetchRepo, Gemini } from \"../services.js\";\nimport { displayHeader, SEPARATOR } from \"../utils/args.js\";\nimport { Logger } from \"../utils/logger.js\";\n\nconst logger = new Logger(\"GREPO:ANALYZE\");\n\ntype AnalysisType = \"improve\" | \"summary\" | \"tech\";\n\nconst PROMPTS: Record<AnalysisType, string> = {\n\timprove: \"Suggest 5 specific, actionable improvements for this repository.\",\n\tsummary: \"Provide a comprehensive 2-3 paragraph summary of this repository.\",\n\ttech: \"List all technologies, frameworks, and tools used in this repository as a categorized markdown list.\",\n};\n\nexport const run = (config: GrepoConfig) =>\n\tEffect.gen(function* () {\n\t\tconst gemini = yield* Gemini;\n\t\tconst analysisType = config.command as AnalysisType;\n\n\t\tdisplayHeader(`grepo ${analysisType}`, {\n\t\t\tRepository: config.repoUrl,\n\t\t});\n\n\t\tlogger.info(\"Fetching repository content via GitIngest...\");\n\t\tconst repoData = yield* fetchRepo(config.repoUrl);\n\t\tlogger.success(\"Content fetched successfully\");\n\n\t\tlogger.info(`Running ${analysisType} analysis via Gemini...`);\n\t\tconst prompt = `${PROMPTS[analysisType]}\\n\\nTree:\\n${repoData.tree}\\n\\nContent:\\n${repoData.content.slice(0, 4000)}`;\n\t\tconst result = yield* gemini.generateContent(prompt);\n\t\tlogger.success(\"Analysis complete\");\n\n\t\tconsole.log();\n\t\tconsole.log(SEPARATOR);\n\t\tconsole.log(result);\n\t\tconsole.log(SEPARATOR);\n\t\tconsole.log();\n\t});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,SAAS,IAAIA,SAAO,gBAAgB;AAI1C,MAAM,UAAwC;CAC7C,SAAS;CACT,SAAS;CACT,MAAM;CACN;AAED,MAAa,OAAO,WACnB,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO;CACtB,MAAM,eAAe,OAAO;AAE5B,eAAc,SAAS,gBAAgB,EACtC,YAAY,OAAO,SACnB,CAAC;AAEF,QAAO,KAAK,+CAA+C;CAC3D,MAAM,WAAW,OAAO,UAAU,OAAO,QAAQ;AACjD,QAAO,QAAQ,+BAA+B;AAE9C,QAAO,KAAK,WAAW,aAAa,yBAAyB;CAC7D,MAAM,SAAS,GAAG,QAAQ,cAAc,aAAa,SAAS,KAAK,gBAAgB,SAAS,QAAQ,MAAM,GAAG,IAAK;CAClH,MAAM,SAAS,OAAO,OAAO,gBAAgB,OAAO;AACpD,QAAO,QAAQ,oBAAoB;AAEnC,SAAQ,KAAK;AACb,SAAQ,IAAI,UAAU;AACtB,SAAQ,IAAI,OAAO;AACnB,SAAQ,IAAI,UAAU;AACtB,SAAQ,KAAK;EACZ"}

package/lib/commands/describe.d.ts

@@ -0,0 +1,11 @@
+import { GeminiError, GitHubError, GitIngestError } from "../errors.js";
+import { GrepoConfig } from "../config.js";
+import { Gemini, GitHub } from "../services.js";
+import { Effect } from "effect";
+
+//#region src/commands/describe.d.ts
+
+declare const run: (config: GrepoConfig) => Effect.Effect<void, GitIngestError | GeminiError | GitHubError, Gemini | GitHub>;
+//#endregion
+export { run };
+//# sourceMappingURL=describe.d.ts.map

package/lib/commands/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","names":[],"sources":["../../src/commands/describe.ts"],"sourcesContent":[],"mappings":";;;;;;;cA6Ca,cAAe,gBAAW,MAAA,CAAA,aAAA,cAAA,GAAA,WAAA,GAAA,aAAA,SAAA"}

package/lib/commands/describe.js

@@ -0,0 +1,89 @@
+import { SEPARATOR, displayHeader } from "../utils/args.js";
+import { parseGitHubUrl } from "../utils/validation.js";
+import { Logger as Logger$1 } from "../utils/logger.js";
+import { Gemini, GitHub, fetchRepo } from "../services.js";
+import { Effect } from "effect";
+//#region src/commands/describe.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 logger = new Logger$1("GREPO:DESCRIBE");
+const DESCRIBE_PROMPT = `Analyze this repository and generate:
+1. A concise repository description (max 350 characters) suitable for GitHub's "About" section
+2. A homepage URL if you can detect one from the repository content
+
+Look for homepage URLs in:
+- package.json "homepage" field
+- docs site configurations (docusaurus, vitepress, mkdocs, etc.)
+- deployment configs referencing domains (vercel.json, netlify.toml, CNAME files)
+- GitHub Pages configuration
+- README badges or links pointing to live demos, docs, or package registries (npm, PyPI, crates.io, etc.)
+
+Return ONLY a JSON object with this shape:
+{
+  "description": "the description here",
+  "homepage": "https://example.com or null if not found"
+}`;
+const run = (config) => Effect.gen(function* () {
+	const gemini = yield* Gemini;
+	const github = yield* GitHub;
+	displayHeader("grepo describe", {
+		Apply: config.shouldApply ? "Yes" : "No",
+		"Dry Run": config.isDryRun ? "Yes" : "No",
+		Repository: config.repoUrl
+	});
+	logger.info("Fetching repository content via GitIngest...");
+	const repoData = yield* fetchRepo(config.repoUrl);
+	logger.success("Content fetched successfully");
+	logger.info("Generating description and detecting homepage via Gemini...");
+	const prompt = `${DESCRIBE_PROMPT}\n\nURL: ${repoData.repo_url}\nSummary: ${repoData.summary}\nTree:\n${repoData.tree}\n\nContent:\n${repoData.content.slice(0, 6e3)}`;
+	const result = yield* gemini.generateContent(prompt);
+	logger.success("Analysis complete");
+	const jsonMatch = /\{[\s\S]*?\}/.exec(result);
+	if (!jsonMatch) {
+		logger.warn("Could not parse AI response");
+		console.log();
+		console.log(SEPARATOR);
+		console.log(result);
+		console.log(SEPARATOR);
+		return;
+	}
+	const parsed = JSON.parse(jsonMatch[0]);
+	console.log();
+	console.log(SEPARATOR);
+	console.log(`  Description: ${parsed.description}`);
+	console.log(`  Homepage:    ${parsed.homepage || "(none detected)"}`);
+	console.log(SEPARATOR);
+	console.log();
+	if (parsed.description.length > 350) logger.warn(`Description is ${parsed.description.length} chars (max 350), it will be truncated by GitHub`);
+	const { owner, repo } = parseGitHubUrl(config.repoUrl);
+	const updateData = { description: parsed.description };
+	if (parsed.homepage) updateData.homepage = parsed.homepage;
+	if (config.isDryRun) {
+		logger.info("DRY RUN: Would set:", updateData);
+		return;
+	}
+	if (config.shouldApply) {
+		logger.info(`Updating ${owner}/${repo} on GitHub...`);
+		yield* github.updateRepo(owner, repo, updateData);
+		logger.success("Repository description and homepage updated successfully");
+	} else logger.info("Use --apply to set description and homepage on GitHub");
+});
+//#endregion
+export { run };
+
+//# sourceMappingURL=describe.js.map

package/lib/commands/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","names":["Logger","validation.parseGitHubUrl"],"sources":["../../src/commands/describe.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 { Effect } from \"effect\";\n\nimport type { GrepoConfig } from \"../config.js\";\nimport { fetchRepo, Gemini, GitHub } from \"../services.js\";\nimport { displayHeader, SEPARATOR } from \"../utils/args.js\";\nimport { Logger } from \"../utils/logger.js\";\nimport * as validation from \"../utils/validation.js\";\n\nconst logger = new Logger(\"GREPO:DESCRIBE\");\n\nconst DESCRIBE_PROMPT = `Analyze this repository and generate:\n1. A concise repository description (max 350 characters) suitable for GitHub's \"About\" section\n2. A homepage URL if you can detect one from the repository content\n\nLook for homepage URLs in:\n- package.json \"homepage\" field\n- docs site configurations (docusaurus, vitepress, mkdocs, etc.)\n- deployment configs referencing domains (vercel.json, netlify.toml, CNAME files)\n- GitHub Pages configuration\n- README badges or links pointing to live demos, docs, or package registries (npm, PyPI, crates.io, etc.)\n\nReturn ONLY a JSON object with this shape:\n{\n  \"description\": \"the description here\",\n  \"homepage\": \"https://example.com or null if not found\"\n}`;\n\nexport const run = (config: GrepoConfig) =>\n\tEffect.gen(function* () {\n\t\tconst gemini = yield* Gemini;\n\t\tconst github = yield* GitHub;\n\n\t\tdisplayHeader(\"grepo describe\", {\n\t\t\tApply: config.shouldApply ? \"Yes\" : \"No\",\n\t\t\t\"Dry Run\": config.isDryRun ? \"Yes\" : \"No\",\n\t\t\tRepository: config.repoUrl,\n\t\t});\n\n\t\tlogger.info(\"Fetching repository content via GitIngest...\");\n\t\tconst repoData = yield* fetchRepo(config.repoUrl);\n\t\tlogger.success(\"Content fetched successfully\");\n\n\t\tlogger.info(\"Generating description and detecting homepage via Gemini...\");\n\t\tconst prompt = `${DESCRIBE_PROMPT}\\n\\nURL: ${repoData.repo_url}\\nSummary: ${repoData.summary}\\nTree:\\n${repoData.tree}\\n\\nContent:\\n${repoData.content.slice(0, 6000)}`;\n\t\tconst result = yield* gemini.generateContent(prompt);\n\t\tlogger.success(\"Analysis complete\");\n\n\t\tconst jsonMatch = /\\{[\\s\\S]*?\\}/.exec(result);\n\t\tif (!jsonMatch) {\n\t\t\tlogger.warn(\"Could not parse AI response\");\n\t\t\tconsole.log();\n\t\t\tconsole.log(SEPARATOR);\n\t\t\tconsole.log(result);\n\t\t\tconsole.log(SEPARATOR);\n\t\t\treturn;\n\t\t}\n\n\t\tconst parsed = JSON.parse(jsonMatch[0]) as {\n\t\t\tdescription: string;\n\t\t\thomepage: string | null;\n\t\t};\n\n\t\tconsole.log();\n\t\tconsole.log(SEPARATOR);\n\t\tconsole.log(`  Description: ${parsed.description}`);\n\t\tconsole.log(`  Homepage:    ${parsed.homepage || \"(none detected)\"}`);\n\t\tconsole.log(SEPARATOR);\n\t\tconsole.log();\n\n\t\tif (parsed.description.length > 350) {\n\t\t\tlogger.warn(\n\t\t\t\t`Description is ${parsed.description.length} chars (max 350), it will be truncated by GitHub`,\n\t\t\t);\n\t\t}\n\n\t\tconst { owner, repo } = validation.parseGitHubUrl(config.repoUrl);\n\n\t\tconst updateData: { description?: string; homepage?: string } = {\n\t\t\tdescription: parsed.description,\n\t\t};\n\t\tif (parsed.homepage) {\n\t\t\tupdateData.homepage = parsed.homepage;\n\t\t}\n\n\t\tif (config.isDryRun) {\n\t\t\tlogger.info(\"DRY RUN: Would set:\", updateData);\n\t\t\treturn;\n\t\t}\n\n\t\tif (config.shouldApply) {\n\t\t\tlogger.info(`Updating ${owner}/${repo} on GitHub...`);\n\t\t\tyield* github.updateRepo(owner, repo, updateData);\n\t\t\tlogger.success(\n\t\t\t\t\"Repository description and homepage updated successfully\",\n\t\t\t);\n\t\t} else {\n\t\t\tlogger.info(\"Use --apply to set description and homepage on GitHub\");\n\t\t}\n\t});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,SAAS,IAAIA,SAAO,iBAAiB;AAE3C,MAAM,kBAAkB;;;;;;;;;;;;;;;;AAiBxB,MAAa,OAAO,WACnB,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO;CACtB,MAAM,SAAS,OAAO;AAEtB,eAAc,kBAAkB;EAC/B,OAAO,OAAO,cAAc,QAAQ;EACpC,WAAW,OAAO,WAAW,QAAQ;EACrC,YAAY,OAAO;EACnB,CAAC;AAEF,QAAO,KAAK,+CAA+C;CAC3D,MAAM,WAAW,OAAO,UAAU,OAAO,QAAQ;AACjD,QAAO,QAAQ,+BAA+B;AAE9C,QAAO,KAAK,8DAA8D;CAC1E,MAAM,SAAS,GAAG,gBAAgB,WAAW,SAAS,SAAS,aAAa,SAAS,QAAQ,WAAW,SAAS,KAAK,gBAAgB,SAAS,QAAQ,MAAM,GAAG,IAAK;CACrK,MAAM,SAAS,OAAO,OAAO,gBAAgB,OAAO;AACpD,QAAO,QAAQ,oBAAoB;CAEnC,MAAM,YAAY,eAAe,KAAK,OAAO;AAC7C,KAAI,CAAC,WAAW;AACf,SAAO,KAAK,8BAA8B;AAC1C,UAAQ,KAAK;AACb,UAAQ,IAAI,UAAU;AACtB,UAAQ,IAAI,OAAO;AACnB,UAAQ,IAAI,UAAU;AACtB;;CAGD,MAAM,SAAS,KAAK,MAAM,UAAU,GAAG;AAKvC,SAAQ,KAAK;AACb,SAAQ,IAAI,UAAU;AACtB,SAAQ,IAAI,kBAAkB,OAAO,cAAc;AACnD,SAAQ,IAAI,kBAAkB,OAAO,YAAY,oBAAoB;AACrE,SAAQ,IAAI,UAAU;AACtB,SAAQ,KAAK;AAEb,KAAI,OAAO,YAAY,SAAS,IAC/B,QAAO,KACN,kBAAkB,OAAO,YAAY,OAAO,kDAC5C;CAGF,MAAM,EAAE,OAAO,SAASC,eAA0B,OAAO,QAAQ;CAEjE,MAAM,aAA0D,EAC/D,aAAa,OAAO,aACpB;AACD,KAAI,OAAO,SACV,YAAW,WAAW,OAAO;AAG9B,KAAI,OAAO,UAAU;AACpB,SAAO,KAAK,uBAAuB,WAAW;AAC9C;;AAGD,KAAI,OAAO,aAAa;AACvB,SAAO,KAAK,YAAY,MAAM,GAAG,KAAK,eAAe;AACrD,SAAO,OAAO,WAAW,OAAO,MAAM,WAAW;AACjD,SAAO,QACN,2DACA;OAED,QAAO,KAAK,wDAAwD;EAEpE"}

package/lib/commands/readme.d.ts

@@ -0,0 +1,11 @@
+import { GeminiError, GitHubError, GitIngestError } from "../errors.js";
+import { GrepoConfig } from "../config.js";
+import { Gemini, GitHub } from "../services.js";
+import { Effect } from "effect";
+
+//#region src/commands/readme.d.ts
+
+declare const run: (config: GrepoConfig) => Effect.Effect<void, GitIngestError | GeminiError | GitHubError, Gemini | GitHub>;
+//#endregion
+export { run };
+//# sourceMappingURL=readme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readme.d.ts","names":[],"sources":["../../src/commands/readme.ts"],"sourcesContent":[],"mappings":";;;;;;;cAoCa,cAAe,gBAAW,MAAA,CAAA,aAAA,cAAA,GAAA,WAAA,GAAA,aAAA,SAAA"}

package/lib/commands/readme.js

@@ -0,0 +1,69 @@
+import { displayHeader } from "../utils/args.js";
+import { parseGitHubUrl } from "../utils/validation.js";
+import { Logger as Logger$1 } from "../utils/logger.js";
+import { Gemini, GitHub, fetchRepo } from "../services.js";
+import { validateAndFixMermaid } from "../mermaid.js";
+import { buildAnalysisPrompt, buildGenerationPrompt, extractExistingReadme, parseAnalysis } from "../prompts/readme.js";
+import { Effect } from "effect";
+import { writeFile } from "node:fs/promises";
+//#region src/commands/readme.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 logger = new Logger$1("GREPO:README");
+const run = (config) => Effect.gen(function* () {
+	const gemini = yield* Gemini;
+	const github = yield* GitHub;
+	displayHeader("grepo readme", {
+		Format: config.outputFormat,
+		Output: config.outputFile,
+		Push: config.shouldPush ? `Yes (${config.branch})` : "No",
+		Repository: config.repoUrl,
+		Style: config.style
+	});
+	logger.info("Fetching repository content via GitIngest...");
+	const repoData = yield* fetchRepo(config.repoUrl);
+	logger.success("Content fetched successfully");
+	logger.info("Analyzing repository structure...");
+	const analysisPrompt = buildAnalysisPrompt(repoData, extractExistingReadme(repoData.content) ?? void 0);
+	const analysis = parseAnalysis(yield* gemini.generateContent(analysisPrompt));
+	logger.success("Analysis complete");
+	logger.info("Generating README content via Gemini...");
+	const generationPrompt = buildGenerationPrompt(analysis, repoData, {
+		format: config.outputFormat,
+		style: config.style,
+		tone: config.tone
+	});
+	const rawContent = yield* gemini.generateContent(generationPrompt);
+	logger.success("README generated successfully");
+	const content = yield* validateAndFixMermaid(rawContent, gemini);
+	if (config.outputFile) {
+		logger.info(`Saving README to ${config.outputFile}...`);
+		yield* Effect.promise(() => writeFile(config.outputFile, content));
+		logger.success("File saved locally");
+	}
+	if (config.shouldPush) {
+		const { owner, repo } = parseGitHubUrl(config.repoUrl);
+		logger.info(`Pushing README to GitHub (${owner}/${repo})...`);
+		yield* github.pushFile(owner, repo, config.outputFile, content, "docs: update README with AI-generated content", config.branch);
+		logger.success("Pushed to GitHub successfully");
+	}
+});
+//#endregion
+export { run };
+
+//# sourceMappingURL=readme.js.map

package/lib/commands/readme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.js","names":["Logger","validation.parseGitHubUrl"],"sources":["../../src/commands/readme.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 { writeFile } from \"node:fs/promises\";\nimport { Effect } from \"effect\";\n\nimport type { GrepoConfig } from \"../config.js\";\nimport { validateAndFixMermaid } from \"../mermaid.js\";\nimport {\n\tbuildAnalysisPrompt,\n\tbuildGenerationPrompt,\n\textractExistingReadme,\n\tparseAnalysis,\n} from \"../prompts/readme.js\";\nimport { fetchRepo, Gemini, GitHub } from \"../services.js\";\nimport { displayHeader } from \"../utils/args.js\";\nimport { Logger } from \"../utils/logger.js\";\nimport * as validation from \"../utils/validation.js\";\n\nconst logger = new Logger(\"GREPO:README\");\n\nexport const run = (config: GrepoConfig) =>\n\tEffect.gen(function* () {\n\t\tconst gemini = yield* Gemini;\n\t\tconst github = yield* GitHub;\n\n\t\tdisplayHeader(\"grepo readme\", {\n\t\t\tFormat: config.outputFormat,\n\t\t\tOutput: config.outputFile,\n\t\t\tPush: config.shouldPush ? `Yes (${config.branch})` : \"No\",\n\t\t\tRepository: config.repoUrl,\n\t\t\tStyle: config.style,\n\t\t});\n\n\t\tlogger.info(\"Fetching repository content via GitIngest...\");\n\t\tconst repoData = yield* fetchRepo(config.repoUrl);\n\t\tlogger.success(\"Content fetched successfully\");\n\n\t\t// Phase 1: Analysis\n\t\tlogger.info(\"Analyzing repository structure...\");\n\t\tconst existingReadme = extractExistingReadme(repoData.content);\n\t\tconst analysisPrompt = buildAnalysisPrompt(\n\t\t\trepoData,\n\t\t\texistingReadme ?? undefined,\n\t\t);\n\t\tconst analysisRaw = yield* gemini.generateContent(analysisPrompt);\n\t\tconst analysis = parseAnalysis(analysisRaw);\n\t\tlogger.success(\"Analysis complete\");\n\n\t\t// Phase 2: Generation\n\t\tlogger.info(\"Generating README content via Gemini...\");\n\t\tconst generationPrompt = buildGenerationPrompt(analysis, repoData, {\n\t\t\tformat: config.outputFormat,\n\t\t\tstyle: config.style,\n\t\t\ttone: config.tone,\n\t\t});\n\t\tconst rawContent = yield* gemini.generateContent(generationPrompt);\n\t\tlogger.success(\"README generated successfully\");\n\n\t\t// Phase 3: Mermaid validation\n\t\tconst content = yield* validateAndFixMermaid(rawContent, gemini);\n\n\t\tif (config.outputFile) {\n\t\t\tlogger.info(`Saving README to ${config.outputFile}...`);\n\t\t\tyield* Effect.promise(() => writeFile(config.outputFile, content));\n\t\t\tlogger.success(\"File saved locally\");\n\t\t}\n\n\t\tif (config.shouldPush) {\n\t\t\tconst { owner, repo } = validation.parseGitHubUrl(config.repoUrl);\n\t\t\tlogger.info(`Pushing README to GitHub (${owner}/${repo})...`);\n\t\t\tyield* github.pushFile(\n\t\t\t\towner,\n\t\t\t\trepo,\n\t\t\t\tconfig.outputFile,\n\t\t\t\tcontent,\n\t\t\t\t\"docs: update README with AI-generated content\",\n\t\t\t\tconfig.branch,\n\t\t\t);\n\t\t\tlogger.success(\"Pushed to GitHub successfully\");\n\t\t}\n\t});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAM,SAAS,IAAIA,SAAO,eAAe;AAEzC,MAAa,OAAO,WACnB,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO;CACtB,MAAM,SAAS,OAAO;AAEtB,eAAc,gBAAgB;EAC7B,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,MAAM,OAAO,aAAa,QAAQ,OAAO,OAAO,KAAK;EACrD,YAAY,OAAO;EACnB,OAAO,OAAO;EACd,CAAC;AAEF,QAAO,KAAK,+CAA+C;CAC3D,MAAM,WAAW,OAAO,UAAU,OAAO,QAAQ;AACjD,QAAO,QAAQ,+BAA+B;AAG9C,QAAO,KAAK,oCAAoC;CAEhD,MAAM,iBAAiB,oBACtB,UAFsB,sBAAsB,SAAS,QAAQ,IAG3C,KAAA,EAClB;CAED,MAAM,WAAW,cADG,OAAO,OAAO,gBAAgB,eAAe,CACtB;AAC3C,QAAO,QAAQ,oBAAoB;AAGnC,QAAO,KAAK,0CAA0C;CACtD,MAAM,mBAAmB,sBAAsB,UAAU,UAAU;EAClE,QAAQ,OAAO;EACf,OAAO,OAAO;EACd,MAAM,OAAO;EACb,CAAC;CACF,MAAM,aAAa,OAAO,OAAO,gBAAgB,iBAAiB;AAClE,QAAO,QAAQ,gCAAgC;CAG/C,MAAM,UAAU,OAAO,sBAAsB,YAAY,OAAO;AAEhE,KAAI,OAAO,YAAY;AACtB,SAAO,KAAK,oBAAoB,OAAO,WAAW,KAAK;AACvD,SAAO,OAAO,cAAc,UAAU,OAAO,YAAY,QAAQ,CAAC;AAClE,SAAO,QAAQ,qBAAqB;;AAGrC,KAAI,OAAO,YAAY;EACtB,MAAM,EAAE,OAAO,SAASC,eAA0B,OAAO,QAAQ;AACjE,SAAO,KAAK,6BAA6B,MAAM,GAAG,KAAK,MAAM;AAC7D,SAAO,OAAO,SACb,OACA,MACA,OAAO,YACP,SACA,iDACA,OAAO,OACP;AACD,SAAO,QAAQ,gCAAgC;;EAE/C"}

package/lib/commands/topics.d.ts

@@ -0,0 +1,11 @@
+import { GeminiError, GitHubError, GitIngestError } from "../errors.js";
+import { GrepoConfig } from "../config.js";
+import { Gemini, GitHub } from "../services.js";
+import { Effect } from "effect";
+
+//#region src/commands/topics.d.ts
+
+declare const run: (config: GrepoConfig) => Effect.Effect<void, GitIngestError | GeminiError | GitHubError, Gemini | GitHub>;
+//#endregion
+export { run };
+//# sourceMappingURL=topics.d.ts.map

package/lib/commands/topics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.d.ts","names":[],"sources":["../../src/commands/topics.ts"],"sourcesContent":[],"mappings":";;;;;;;cA+Ba,cAAe,gBAAW,MAAA,CAAA,aAAA,cAAA,GAAA,WAAA,GAAA,aAAA,SAAA"}

package/lib/commands/topics.js

@@ -0,0 +1,74 @@
+import { SEPARATOR, displayHeader } from "../utils/args.js";
+import { parseGitHubUrl } from "../utils/validation.js";
+import { Logger as Logger$1 } from "../utils/logger.js";
+import { Gemini, GitHub, fetchRepo } from "../services.js";
+import { Effect } from "effect";
+//#region src/commands/topics.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 logger = new Logger$1("GREPO:TOPICS");
+const TOPICS_PROMPT = `Analyze this repository and suggest 5-8 relevant GitHub topics.
+Return ONLY a JSON array of lowercase, hyphenated strings. Example: ["typescript", "cli-tool", "ai-powered"]`;
+const run = (config) => Effect.gen(function* () {
+	const gemini = yield* Gemini;
+	const github = yield* GitHub;
+	displayHeader("grepo topics", {
+		Apply: config.shouldApply ? "Yes" : "No",
+		"Dry Run": config.isDryRun ? "Yes" : "No",
+		Merge: config.shouldMerge ? "Yes" : "No",
+		Repository: config.repoUrl
+	});
+	logger.info("Fetching repository content via GitIngest...");
+	const repoData = yield* fetchRepo(config.repoUrl);
+	logger.success("Content fetched successfully");
+	logger.info("Running topics analysis via Gemini...");
+	const prompt = `${TOPICS_PROMPT}\n\nTree:\n${repoData.tree}\n\nContent:\n${repoData.content.slice(0, 4e3)}`;
+	const result = yield* gemini.generateContent(prompt);
+	logger.success("Analysis complete");
+	console.log();
+	console.log(SEPARATOR);
+	console.log(result);
+	console.log(SEPARATOR);
+	console.log();
+	const jsonMatch = /\[[\s\S]*?\]/.exec(result);
+	if (!jsonMatch) {
+		logger.warn("Could not find topics list in AI response");
+		return;
+	}
+	const suggested = JSON.parse(jsonMatch[0]).map((t) => t.toLowerCase().trim().replaceAll(/\s+/g, "-"));
+	const { owner, repo } = parseGitHubUrl(config.repoUrl);
+	let finalTopics = suggested;
+	if (config.shouldMerge && config.githubToken) {
+		logger.info("Fetching current topics from GitHub...");
+		const current = yield* github.getTopics(owner, repo);
+		finalTopics = [...new Set([...current, ...suggested])].sort((a, b) => a.localeCompare(b));
+	}
+	if (config.isDryRun) {
+		logger.info("DRY RUN: Would apply these topics:", { topics: finalTopics });
+		return;
+	}
+	if (config.shouldApply) {
+		logger.info("Applying topics to GitHub...");
+		yield* github.setTopics(owner, repo, finalTopics);
+		logger.success("Topics applied successfully");
+	} else logger.info("Use --apply to set these topics on GitHub");
+});
+//#endregion
+export { run };
+
+//# sourceMappingURL=topics.js.map

package/lib/commands/topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","names":["Logger","validation.parseGitHubUrl"],"sources":["../../src/commands/topics.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 { Effect } from \"effect\";\n\nimport type { GrepoConfig } from \"../config.js\";\nimport { fetchRepo, Gemini, GitHub } from \"../services.js\";\nimport { displayHeader, SEPARATOR } from \"../utils/args.js\";\nimport { Logger } from \"../utils/logger.js\";\nimport * as validation from \"../utils/validation.js\";\n\nconst logger = new Logger(\"GREPO:TOPICS\");\n\nconst TOPICS_PROMPT = `Analyze this repository and suggest 5-8 relevant GitHub topics.\nReturn ONLY a JSON array of lowercase, hyphenated strings. Example: [\"typescript\", \"cli-tool\", \"ai-powered\"]`;\n\nexport const run = (config: GrepoConfig) =>\n\tEffect.gen(function* () {\n\t\tconst gemini = yield* Gemini;\n\t\tconst github = yield* GitHub;\n\n\t\tdisplayHeader(\"grepo topics\", {\n\t\t\tApply: config.shouldApply ? \"Yes\" : \"No\",\n\t\t\t\"Dry Run\": config.isDryRun ? \"Yes\" : \"No\",\n\t\t\tMerge: config.shouldMerge ? \"Yes\" : \"No\",\n\t\t\tRepository: config.repoUrl,\n\t\t});\n\n\t\tlogger.info(\"Fetching repository content via GitIngest...\");\n\t\tconst repoData = yield* fetchRepo(config.repoUrl);\n\t\tlogger.success(\"Content fetched successfully\");\n\n\t\tlogger.info(\"Running topics analysis via Gemini...\");\n\t\tconst prompt = `${TOPICS_PROMPT}\\n\\nTree:\\n${repoData.tree}\\n\\nContent:\\n${repoData.content.slice(0, 4000)}`;\n\t\tconst result = yield* gemini.generateContent(prompt);\n\t\tlogger.success(\"Analysis complete\");\n\n\t\tconsole.log();\n\t\tconsole.log(SEPARATOR);\n\t\tconsole.log(result);\n\t\tconsole.log(SEPARATOR);\n\t\tconsole.log();\n\n\t\tconst jsonMatch = /\\[[\\s\\S]*?\\]/.exec(result);\n\t\tif (!jsonMatch) {\n\t\t\tlogger.warn(\"Could not find topics list in AI response\");\n\t\t\treturn;\n\t\t}\n\n\t\tconst suggested = (JSON.parse(jsonMatch[0]) as string[]).map((t) =>\n\t\t\tt.toLowerCase().trim().replaceAll(/\\s+/g, \"-\"),\n\t\t);\n\n\t\tconst { owner, repo } = validation.parseGitHubUrl(config.repoUrl);\n\n\t\tlet finalTopics = suggested;\n\t\tif (config.shouldMerge && config.githubToken) {\n\t\t\tlogger.info(\"Fetching current topics from GitHub...\");\n\t\t\tconst current = yield* github.getTopics(owner, repo);\n\t\t\tfinalTopics = [...new Set([...current, ...suggested])].sort((a, b) =>\n\t\t\t\ta.localeCompare(b),\n\t\t\t);\n\t\t}\n\n\t\tif (config.isDryRun) {\n\t\t\tlogger.info(\"DRY RUN: Would apply these topics:\", {\n\t\t\t\ttopics: finalTopics,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tif (config.shouldApply) {\n\t\t\tlogger.info(\"Applying topics to GitHub...\");\n\t\t\tyield* github.setTopics(owner, repo, finalTopics);\n\t\t\tlogger.success(\"Topics applied successfully\");\n\t\t} else {\n\t\t\tlogger.info(\"Use --apply to set these topics on GitHub\");\n\t\t}\n\t});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,SAAS,IAAIA,SAAO,eAAe;AAEzC,MAAM,gBAAgB;;AAGtB,MAAa,OAAO,WACnB,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO;CACtB,MAAM,SAAS,OAAO;AAEtB,eAAc,gBAAgB;EAC7B,OAAO,OAAO,cAAc,QAAQ;EACpC,WAAW,OAAO,WAAW,QAAQ;EACrC,OAAO,OAAO,cAAc,QAAQ;EACpC,YAAY,OAAO;EACnB,CAAC;AAEF,QAAO,KAAK,+CAA+C;CAC3D,MAAM,WAAW,OAAO,UAAU,OAAO,QAAQ;AACjD,QAAO,QAAQ,+BAA+B;AAE9C,QAAO,KAAK,wCAAwC;CACpD,MAAM,SAAS,GAAG,cAAc,aAAa,SAAS,KAAK,gBAAgB,SAAS,QAAQ,MAAM,GAAG,IAAK;CAC1G,MAAM,SAAS,OAAO,OAAO,gBAAgB,OAAO;AACpD,QAAO,QAAQ,oBAAoB;AAEnC,SAAQ,KAAK;AACb,SAAQ,IAAI,UAAU;AACtB,SAAQ,IAAI,OAAO;AACnB,SAAQ,IAAI,UAAU;AACtB,SAAQ,KAAK;CAEb,MAAM,YAAY,eAAe,KAAK,OAAO;AAC7C,KAAI,CAAC,WAAW;AACf,SAAO,KAAK,4CAA4C;AACxD;;CAGD,MAAM,YAAa,KAAK,MAAM,UAAU,GAAG,CAAc,KAAK,MAC7D,EAAE,aAAa,CAAC,MAAM,CAAC,WAAW,QAAQ,IAAI,CAC9C;CAED,MAAM,EAAE,OAAO,SAASC,eAA0B,OAAO,QAAQ;CAEjE,IAAI,cAAc;AAClB,KAAI,OAAO,eAAe,OAAO,aAAa;AAC7C,SAAO,KAAK,yCAAyC;EACrD,MAAM,UAAU,OAAO,OAAO,UAAU,OAAO,KAAK;AACpD,gBAAc,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,MAC/D,EAAE,cAAc,EAAE,CAClB;;AAGF,KAAI,OAAO,UAAU;AACpB,SAAO,KAAK,sCAAsC,EACjD,QAAQ,aACR,CAAC;AACF;;AAGD,KAAI,OAAO,aAAa;AACvB,SAAO,KAAK,+BAA+B;AAC3C,SAAO,OAAO,UAAU,OAAO,MAAM,YAAY;AACjD,SAAO,QAAQ,8BAA8B;OAE7C,QAAO,KAAK,4CAA4C;EAExD"}

package/lib/config.d.ts

@@ -0,0 +1,31 @@
+import { Schema } from "effect";
+
+//#region src/config.d.ts
+
+declare const Command: Schema.Literal<["readme", "topics", "describe", "summary", "tech", "improve"]>;
+type Command = Schema.Schema.Type<typeof Command>;
+declare const OutputFormat: Schema.Literal<["md", "mdx"]>;
+type OutputFormat = Schema.Schema.Type<typeof OutputFormat>;
+declare const DocumentationStyle: Schema.Literal<["minimal", "standard", "comprehensive"]>;
+type DocumentationStyle = Schema.Schema.Type<typeof DocumentationStyle>;
+declare const GrepoConfig: Schema.Struct<{
+  branch: typeof Schema.String;
+  command: Schema.Literal<["readme", "topics", "describe", "summary", "tech", "improve"]>;
+  geminiApiKey: typeof Schema.String;
+  githubToken: Schema.optional<typeof Schema.String>;
+  isDryRun: typeof Schema.Boolean;
+  outputFile: typeof Schema.String;
+  outputFormat: Schema.Literal<["md", "mdx"]>;
+  repoUrl: typeof Schema.String;
+  shouldApply: typeof Schema.Boolean;
+  shouldMerge: typeof Schema.Boolean;
+  shouldPush: typeof Schema.Boolean;
+  style: Schema.Literal<["minimal", "standard", "comprehensive"]>;
+  tone: Schema.optional<Schema.Literal<["casual", "minimal", "professional", "technical"]>>;
+}>;
+type GrepoConfig = Schema.Schema.Type<typeof GrepoConfig>;
+declare function loadEnv(): Promise<void>;
+declare function buildConfig(argv: string[]): GrepoConfig;
+//#endregion
+export { Command, DocumentationStyle, GrepoConfig, OutputFormat, buildConfig, loadEnv };
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;cA+Ba,SAAO,MAAA,CAAA;KAQR,OAAA,GAAU,MAAA,CAAO,MAAA,CAAO,YAAY;cAEnC,cAAY,MAAA,CAAA;KACb,YAAA,GAAe,MAAA,CAAO,MAAA,CAAO,YAAY;cAExC,oBAAkB,MAAA,CAAA;KAKnB,kBAAA,GAAqB,MAAA,CAAO,MAAA,CAAO,YAAY;cAE9C,aAAW,MAAA,CAAA;EAAA,MAAA,EAAA,oBAAA;EAAA,OAAA,gBAAA,CAAA,CAAA,QAAA,EAAA,QAAA,EAAA,UAAA,EAAA,SAAA,EAAA,MAAA,EAAA,SAAA,CAAA,CAAA;EAiBZ,YAAA,EAAW,oBAA6B;EAM9B,WAAO,iBAAI,CAAA,oBAAO,CAAA;EAsExB,QAAA,EAAA,qBAA6B;;;;;;;;;;KA5EjC,WAAA,GAAc,MAAA,CAAO,MAAA,CAAO,YAAY;iBAM9B,OAAA,CAAA,GAAW;iBAsEjB,WAAA,kBAA6B"}