@anthuanvasquez/devlogs 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [1.0.1](https://github.com/anthuanvasquez/dev-logs/compare/v1.0.0...v1.0.1) (2026-02-12)
+
+## 1.0.0 (2026-02-12)
+
+
+### Features
+
+* add script to run commands across all projects from json list ([9961fb3](https://github.com/anthuanvasquez/dev-logs/commit/9961fb351c894ac2faf5b28bdbe231ee695b53fc))
+* add telegram support and interactive destination prompt ([541a893](https://github.com/anthuanvasquez/dev-logs/commit/541a8931fafa84b594d75df1ee76570f19451aca))
+* implement CLI arguments for date range and destination flags ([d9bffd8](https://github.com/anthuanvasquez/dev-logs/commit/d9bffd8f2aeba466c32ed2b5a0152fc983e8f762))
+* initial commit with project structure and dependencies ([ea14907](https://github.com/anthuanvasquez/dev-logs/commit/ea14907ac92c00798d77270b3956914d3d4dc336))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anthuan Vásquez
+
+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,123 @@
+# devlogs 📝
+
+<p align="center">
+  <img src="docs/logo.png" alt="devlogs Logo" width="200" style="image-rendering: pixelated;">
+</p>
+
+> Automated daily commit reports powered by Gemini AI, delivered to Discord and Telegram.
+
+## Features
+
+- 🔍 **Scans commits** from the current day.
+- 🤖 **Generates a concise summary** using Google Gemini AI.
+- 🚀 **Sends reports** to Discord Webhooks and/or Telegram Bots.
+-  interactive **CLI prompt** to choose destination if both are configured.
+- 📦 **Supports multiple projects** via a script.
+
+## Prerequisites
+
+- **Node.js** (v18 or higher recommended)
+- **Git** installed and available in PATH.
+- A **Google Gemini API Key** (Get it [here](https://aistudio.google.com/)).
+- A **Discord Webhook URL** (optional).
+- A **Telegram Bot Token** and **Chat ID** (optional).
+
+## Installation
+
+### From NPM (Recommended)
+
+```bash
+npx devlogs
+```
+
+### From Source
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/anthuanvasquez/devlogs.git
+   cd devlogs
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Link the package globally:
+   ```bash
+   npm link
+   ```
+
+## Configuration
+
+Create a `.env` file in the root of your project or where you intend to run the script (or set them as system environment variables):
+
+```bash
+# Required
+GEMINI_API_KEY=your_gemini_api_key
+
+# Optional (at least one is required)
+DISCORD_WEBHOOK_URL=your_discord_webhook_url
+TELEGRAM_BOT_TOKEN=your_telegram_bot_token
+TELEGRAM_CHAT_ID=your_telegram_chat_id
+```
+
+## Usage
+
+Navigate to any git repository and run:
+`devlogs [today|yesterday] [--discord] [--telegram]`
+
+```bash
+# Default (today, ask if multiple targets)
+devlogs
+
+# Report for yesterday
+devlogs yesterday
+
+# Force send to Discord (skip prompt)
+devlogs today --discord
+
+# Force send to Telegram (skip prompt)
+devlogs yesterday --telegram
+
+# Send to both without prompt
+devlogs --discord --telegram
+```
+
+If multiple destinations are configured, you will be prompted to choose:
+`¿Dónde deseas enviar el reporte? (discord/telegram/ambos) [ambos]:`
+
+### Running for Multiple Projects
+
+You can create a `projects.json` file with an array of absolute paths to your projects:
+
+```json
+[
+  "/path/to/project-a",
+  "/path/to/project-b"
+]
+```
+
+Then run the included script:
+
+```bash
+./run-all-projects.sh
+```
+
+## Automating with Cron
+
+To run it automatically every day at 6:00 PM:
+
+1. Open your crontab:
+   ```bash
+   crontab -e
+   ```
+
+2. Add the following line (adjust paths accordingly):
+   ```bash
+   0 18 * * 1-5 /path/to/dev-logs/run-all-projects.sh >> /tmp/cron_devlogs.txt 2>&1
+   ```
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,165 @@
+import { GoogleGenerativeAI } from "@google/generative-ai";
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import readline from "readline";
+import 'dotenv/config';
+
+const DISCORD_WEBHOOK_URL = process.env.DISCORD_WEBHOOK_URL;
+const GEMINI_API_KEY = process.env.GEMINI_API_KEY;
+const TELEGRAM_BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN;
+const TELEGRAM_CHAT_ID = process.env.TELEGRAM_CHAT_ID;
+
+const genAI = new GoogleGenerativeAI(GEMINI_API_KEY);
+const model = genAI.getGenerativeModel({ model: "gemini-flash-lite-latest" });
+
+async function sendToDiscord(message) {
+  if (!DISCORD_WEBHOOK_URL) return;
+
+  console.log("🚀 Enviando a Discord...");
+
+  await fetch(DISCORD_WEBHOOK_URL, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ content: message })
+  });
+
+  console.log("✅ Reporte enviado a Discord con éxito.");
+}
+
+async function sendToTelegram(message) {
+  if (!TELEGRAM_BOT_TOKEN || !TELEGRAM_CHAT_ID) return;
+
+  console.log("✈️ Enviando a Telegram...");
+  
+  const url = `https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage`;
+  
+  await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      chat_id: TELEGRAM_CHAT_ID,
+      text: message,
+      parse_mode: 'Markdown'
+    })
+  });
+  
+  console.log("✅ Reporte enviado a Telegram con éxito.");
+}
+
+function askQuestion(query) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise(resolve => rl.question(query, ans => {
+    rl.close();
+    resolve(ans);
+  }));
+}
+
+async function main() {
+  try {
+    const projectRoot = process.cwd();
+    let projectName = "Proyecto Desconocido";
+    
+    try {
+      const packageJson = JSON.parse(fs.readFileSync(path.join(projectRoot, 'package.json'), 'utf8'));
+      projectName = packageJson.name || path.basename(projectRoot);
+    } catch (e) {
+      projectName = path.basename(projectRoot);
+    }
+
+    projectName = projectName.charAt(0).toUpperCase() + projectName.slice(1);
+
+    const args = process.argv.slice(2);
+    const when = args.includes('yesterday') ? 'yesterday' : 'today';
+    const forceDiscord = args.includes('--discord');
+    const forceTelegram = args.includes('--telegram');
+
+    const dateOptions = { weekday: 'long', day: 'numeric', month: 'long' };
+    const dateObj = new Date();
+    
+    if (when === 'yesterday') {
+      dateObj.setDate(dateObj.getDate() - 1);
+    }
+    
+    const dayName = dateObj.toLocaleDateString('es-ES', { weekday: 'long' });
+    const dayNum = dateObj.getDate();
+    const formattedDate = `${dayName.charAt(0).toUpperCase() + dayName.slice(1)} ${dayNum}`;
+    
+    console.log(`🔍 Buscando commits de ${when === 'today' ? 'hoy' : 'ayer'} para: ${projectName}...`);
+    
+    let commits = "";
+    
+    try {
+      let gitCommand = 'git log --since="00:00" --oneline --no-merges';
+      if (when === 'yesterday') {
+        gitCommand = 'git log --since="yesterday 00:00" --until="today 00:00" --oneline --no-merges';
+      }
+      commits = execSync(gitCommand, { encoding: 'utf8' }).trim();
+    } catch (error) {
+      console.error("⚠️ No es un repositorio git o hubo un error.");
+      return;
+    }
+
+    if (!commits) {
+      console.log(`✅ No hay commits ${when === 'today' ? 'hoy' : 'ayer'}. ¡A descansar!`);
+      return;
+    }
+
+    const hasDiscord = !!DISCORD_WEBHOOK_URL;
+    const hasTelegram = !!(TELEGRAM_BOT_TOKEN && TELEGRAM_CHAT_ID);
+
+    if (!hasDiscord && !hasTelegram) {
+      throw new Error("❌ No se encontró configuración para Discord ni Telegram en el archivo .env");
+    }
+
+    let target = "";
+
+    if (forceDiscord || forceTelegram) {
+        if (forceDiscord && forceTelegram) target = "ambos";
+        else if (forceDiscord) target = "discord";
+        else target = "telegram";
+    } else if (hasDiscord && hasTelegram) {
+      const answer = await askQuestion("¿Dónde deseas enviar el reporte? (discord/telegram/ambos) [ambos]: ");
+      target = answer.toLowerCase().trim() || "ambos";
+    } else if (hasDiscord) {
+      target = "discord";
+    } else {
+      target = "telegram";
+    }
+
+    const prompt = `
+      Actúa como un Tech Lead conciso.
+      Tengo estos commits realizados ${when === 'today' ? 'hoy' : 'ayer'} en el proyecto "${projectName}":
+      
+      ${commits}
+      
+      Genera un resumen muy breve en formato lista (markdown).
+      - Agrupa tareas similares.
+      - Usa emojis técnicos.
+      - Destaca si hubo corrección de bugs o nuevas features.
+      - NO pongas título, solo los bullets.
+    `;
+
+    console.log("🤖 Generando reporte con Gemini Flash...");
+    
+    const result = await model.generateContent(prompt);
+    const aiSummary = result.response.text();
+    const finalMessage = `## 📝 Resumen Diario - ${formattedDate} - ${projectName}\n\n${aiSummary}`;
+    
+    if (target === "discord" || target === "ambos") {
+      await sendToDiscord(finalMessage);
+    }
+    
+    if (target === "telegram" || target === "ambos") {
+      await sendToTelegram(finalMessage);
+    }
+  } catch (error) {
+    console.error("❌ Error:", error.message || error);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@anthuanvasquez/devlogs",
+  "description": "Genera reportes diarios de commits y envialos a Discord",
+  "version": "1.0.1",
+  "main": "index.js",
+  "bin": {
+    "devlogs": "./index.js"
+  },
+  "keywords": [
+    "git",
+    "report",
+    "ai",
+    "gemini",
+    "discord",
+    "telegram",
+    "developer",
+    "tools"
+  ],
+  "author": "Anthuan Vasquez",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthuanvasquez/dev-logs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/anthuanvasquez/dev-logs/issues"
+  },
+  "homepage": "https://github.com/anthuanvasquez/dev-logs#readme",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "release": "standard-version",
+    "release:minor": "standard-version --release-as minor",
+    "release:patch": "standard-version --release-as patch",
+    "release:major": "standard-version --release-as major",
+    "publish": "npm publish --access public"
+  },
+  "dependencies": {
+    "@google/generative-ai": "^0.24.1",
+    "dotenv": "^17.2.4"
+  },
+  "devDependencies": {
+    "standard-version": "^9.5.0"
+  }
+}