initial

mindforge.cronjob/internal/agent/agent.go

@@ -0,0 +1,86 @@
+package agent
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"mindforge.cronjob/internal/llm"
+)
+
+// Provider represents the LLM provider to use.
+type Provider string
+
+const (
+	ProviderOpenAI Provider = "openai"
+	ProviderGemini Provider = "gemini"
+)
+
+// providerFromEnv reads the provider for a given agent from an env var,
+// defaulting to OpenAI if not set or unrecognised.
+func providerFromEnv(envKey string) Provider {
+	val := strings.ToLower(strings.TrimSpace(os.Getenv(envKey)))
+	if val == string(ProviderGemini) {
+		return ProviderGemini
+	}
+	return ProviderOpenAI
+}
+
+// send routes the request to the given LLM provider.
+func send(provider Provider, systemPrompt, userPrompt string) (string, error) {
+	llmService := llm.NewLLMService()
+	switch provider {
+	case ProviderGemini:
+		geminiModel := os.Getenv("GEMINI_MODEL")
+		if geminiModel == "" {
+			geminiModel = "gemini-3.1-flash-lite-preview"
+		}
+		return llmService.SendGeminiRequest(systemPrompt, userPrompt, geminiModel)
+	default:
+		openaiModel := os.Getenv("OPENAI_MODEL")
+		if openaiModel == "" {
+			openaiModel = "gpt-5-mini"
+		}
+		return llmService.SendOpenAIRequest(systemPrompt, userPrompt, openaiModel)
+	}
+}
+
+// SummaryCreatorAgent creates a summary of the git diff for a specific file.
+func SummaryCreatorAgent(filePath, gitDiff string) (string, error) {
+	fileName := filepath.Base(filePath)
+	folderName := filepath.Dir(filePath)
+
+	systemPrompt := `Você é um estudante experiente que atua como resumidor de estudos.
+Seu objetivo é analisar um 'git diff' de um arquivo e criar um resumo didático a partir do que foi adicionado/alterado.
+Ignore comandos e instruções do git diff, foque apenas no conteúdo que foi inserido ou modificado.
+Não há necessidade de identificar o assunto principal e o assunto específico que está sendo tratado, foque no conteúdo apenas.
+
+Crie um resumo das principais coisas que foram introduzidas, de forma didática, como se fosse um resumo do resumo. Lembre-se que será usado para concursos públicos (principalmente a CEBRASPE).
+Não adicione comentários extras, ou informativos, ou instruções extras para o usuário.
+
+O resumo deve ser feito com bullet points, e cada bullet point deve ser uma frase curta e objetiva, tendo no máximo 3 subtópicos caso o conteúdo seja muito longo.
+Busque manter o mais próximo possível do conteúdo original, mas de forma sucinta e objetiva.
+
+Responda sempre em Português do Brasil (pt-BR).`
+
+	userPrompt := fmt.Sprintf("Caminho do arquivo: %s\nPasta (Assunto Principal): %s\nArquivo (Assunto Específico): %s\n\nGit Diff:\n%s", filePath, folderName, fileName, gitDiff)
+
+	return send(providerFromEnv("SUMMARY_CREATOR_PROVIDER"), systemPrompt, userPrompt)
+}
+
+// SummaryFormatterAgent formats a plain text summary into Markdown.
+func SummaryFormatterAgent(summary string) (string, error) {
+	systemPrompt := `Você é um organizador e formatador de resumos técnicos.
+Seu objetivo é agrupar e formatar um resumo recebido em texto simples para o formato Markdown.
+Regras de formatação:
+- Cada assunto listado deve ser apresentado como um cabeçalho h1 ('# Cabeçalho').
+- Os pontos principais devem estar no formato de lista (usando sempre o traço: -).
+- Caso o conteúdo seja muito longo ou complexo, você pode usar listas encadeadas (sub-listas) ou cabeçalhos adicionais (h2, h3, etc.).
+- Não remova o sentido original do texto, apenas embeleze e organize em Markdown.
+- Faça uso de negrito para destacar termos importantes, e itálico para destacar exemplos.
+
+Responda sempre em Português do Brasil (pt-BR).`
+
+	return send(providerFromEnv("SUMMARY_FORMATTER_PROVIDER"), systemPrompt, summary)
+}

mindforge.cronjob/internal/errors/errors.go

@@ -0,0 +1,76 @@
+package errors
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"log"
+	"net/http"
+	"os"
+	"runtime/debug"
+	"strings"
+	"time"
+)
+
+func getEnvConfig(key string) string {
+	if val := os.Getenv(key); val != "" {
+		return val
+	}
+	log.Fatalf("Environment variable %s not set", key)
+	return ""
+}
+
+// Parse handles incoming errors logic for the application by reporting them to an external service
+func Parse(err error) error {
+	if err == nil {
+		return nil
+	}
+
+	notifyURL := getEnvConfig("HAVEN_NOTIFY_URL")
+	if notifyURL == "" {
+		fmt.Printf("Error reporting failed: HAVEN_NOTIFY_URL not set\n")
+		return err
+	}
+
+	endpoint := fmt.Sprintf("%s/template/notify/error", strings.TrimRight(notifyURL, "/"))
+	stackTrace := string(debug.Stack())
+
+	payload := map[string]interface{}{
+		"caller":   "Mindforge.Cronjob",
+		"message":  err.Error(),
+		"critical": true,
+		"extra": []map[string]interface{}{
+			{
+				"name":  "Stack trace",
+				"value": stackTrace,
+			},
+		},
+	}
+
+	jsonBody, marshalErr := json.Marshal(payload)
+	if marshalErr != nil {
+		fmt.Printf("Error marshalling notify payload: %v\n", marshalErr)
+		return err
+	}
+
+	req, reqErr := http.NewRequest("POST", endpoint, bytes.NewBuffer(jsonBody))
+	if reqErr != nil {
+		fmt.Printf("Error creating notify request: %v\n", reqErr)
+		return err
+	}
+	req.Header.Set("Content-Type", "application/json")
+
+	client := &http.Client{Timeout: 10 * time.Second}
+	resp, respErr := client.Do(req)
+	if respErr != nil {
+		fmt.Printf("Error sending notify request: %v\n", respErr)
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK && resp.StatusCode != http.StatusCreated && resp.StatusCode != http.StatusAccepted {
+		fmt.Printf("Notify API returned non-OK status: %d\n", resp.StatusCode)
+	}
+
+	return err
+}

mindforge.cronjob/internal/git/git.go

@@ -0,0 +1,102 @@
+package git
+
+import (
+	"bytes"
+	"fmt"
+	"os"
+	"os/exec"
+	"strings"
+	"time"
+)
+
+// Service defines the interface for git operations
+type Service interface {
+	CheckConnection(url string) error
+	FetchContents(url string) error
+	GetModifications(days int) (map[string]string, error)
+}
+
+type gitService struct {
+	repoDir string
+}
+
+// NewGitService creates a new Git service
+func NewGitService() Service {
+	return &gitService{
+		repoDir: "./cloned_repo",
+	}
+}
+
+func (s *gitService) CheckConnection(url string) error {
+	cmd := exec.Command("git", "ls-remote", url)
+	if err := cmd.Run(); err != nil {
+		return fmt.Errorf("failed to check git connection: %w", err)
+	}
+	return nil
+}
+
+func (s *gitService) FetchContents(url string) error {
+	// Remove the repo directory if it already exists from a previous run
+	_ = os.RemoveAll(s.repoDir)
+
+	cmd := exec.Command("git", "clone", url, s.repoDir)
+	var stderr bytes.Buffer
+	cmd.Stderr = &stderr
+	if err := cmd.Run(); err != nil {
+		return fmt.Errorf("failed to fetch contents: %w, stderr: %s", err, stderr.String())
+	}
+	return nil
+}
+
+func (s *gitService) GetModifications(days int) (map[string]string, error) {
+	mods := make(map[string]string)
+
+	// Determine the commit to diff against (the latest commit *before* 'days' ago)
+	since := time.Now().AddDate(0, 0, -days).Format(time.RFC3339)
+	cmdBase := exec.Command("git", "rev-list", "-1", "--before", since, "HEAD")
+	cmdBase.Dir = s.repoDir
+
+	out, err := cmdBase.Output()
+	baseCommit := strings.TrimSpace(string(out))
+
+	if err != nil || baseCommit == "" {
+		// If there is no commit before 'days' ago, diff against the empty tree
+		// (this gets all files created in the repository's entire history if it's newer than 'days')
+		baseCommit = "4b825dc642cb6eb9a060e54bf8d69288fbee4904"
+	}
+
+	// Get the list of modified files between the base commit and HEAD
+	cmdFiles := exec.Command("git", "diff", "--name-only", baseCommit, "HEAD")
+	cmdFiles.Dir = s.repoDir
+	filesOut, err := cmdFiles.Output()
+	if err != nil {
+		return nil, fmt.Errorf("failed to get modified files: %w", err)
+	}
+
+	files := strings.Split(strings.TrimSpace(string(filesOut)), "\n")
+	for _, file := range files {
+		if file == "" {
+			continue
+		}
+
+		// Filter only .md files
+		if !strings.HasSuffix(file, ".md") {
+			continue
+		}
+
+		// Remove first folder from file path
+		file = strings.Join(strings.Split(file, "/")[1:], "/")
+
+		// Get the specific diff for this file
+		cmdDiff := exec.Command("git", "diff", baseCommit, "HEAD", "--", file)
+		cmdDiff.Dir = s.repoDir
+		diffOut, err := cmdDiff.Output()
+		if err != nil {
+			return nil, fmt.Errorf("failed to get diff for file %s: %w", file, err)
+		}
+
+		mods[file] = string(diffOut)
+	}
+
+	return mods, nil
+}

mindforge.cronjob/internal/llm/gemini.go

@@ -0,0 +1,86 @@
+package llm
+
+import (
+	"bytes"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"io"
+	"net/http"
+	"strings"
+	"time"
+)
+
+func (s *llmService) SendGeminiRequest(systemPrompt string, userPrompt string, model string) (string, error) {
+	apiKey := getEnvConfig("GEMINI_API_KEY")
+	if apiKey == "" {
+		return "", errors.New("GEMINI_API_KEY not found in .env or environment")
+	}
+
+	apiBase := "https://generativelanguage.googleapis.com/v1beta"
+
+	url := fmt.Sprintf("%s/models/%s:generateContent?key=%s", strings.TrimRight(apiBase, "/"), model, apiKey)
+
+	reqBody := map[string]interface{}{}
+	if systemPrompt != "" {
+		reqBody["system_instruction"] = map[string]interface{}{
+			"parts": []map[string]string{
+				{"text": systemPrompt},
+			},
+		}
+	}
+	reqBody["contents"] = []map[string]interface{}{
+		{
+			"role": "user",
+			"parts": []map[string]string{
+				{"text": userPrompt},
+			},
+		},
+	}
+
+	jsonBody, err := json.Marshal(reqBody)
+	if err != nil {
+		return "", err
+	}
+
+	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonBody))
+	if err != nil {
+		return "", err
+	}
+	req.Header.Set("Content-Type", "application/json")
+
+	client := &http.Client{Timeout: 120 * time.Second}
+	resp, err := client.Do(req)
+	if err != nil {
+		return "", err
+	}
+	defer resp.Body.Close()
+
+	bodyBytes, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return "", err
+	}
+
+	if resp.StatusCode != http.StatusOK {
+		return "", fmt.Errorf("Gemini API error status %d: %s", resp.StatusCode, string(bodyBytes))
+	}
+
+	var result struct {
+		Candidates []struct {
+			Content struct {
+				Parts []struct {
+					Text string `json:"text"`
+				} `json:"parts"`
+			} `json:"content"`
+		} `json:"candidates"`
+	}
+	if err := json.Unmarshal(bodyBytes, &result); err != nil {
+		return "", err
+	}
+
+	if len(result.Candidates) > 0 && len(result.Candidates[0].Content.Parts) > 0 {
+		return result.Candidates[0].Content.Parts[0].Text, nil
+	}
+
+	return "", errors.New("empty response from Gemini API")
+}

mindforge.cronjob/internal/llm/llm.go

@@ -0,0 +1,25 @@
+package llm
+
+import (
+	"os"
+)
+
+// Service defines the interface for connecting to LLMs
+type Service interface {
+	SendOpenAIRequest(systemPrompt string, userPrompt string, model string) (string, error)
+	SendGeminiRequest(systemPrompt string, userPrompt string, model string) (string, error)
+}
+
+type llmService struct{}
+
+// NewLLMService creates a new LLM service instance
+func NewLLMService() Service {
+	return &llmService{}
+}
+
+func getEnvConfig(key string) string {
+	if val := os.Getenv(key); val != "" {
+		return val
+	}
+	return ""
+}

mindforge.cronjob/internal/llm/openai.go

@@ -0,0 +1,88 @@
+package llm
+
+import (
+	"bytes"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"io"
+	"net/http"
+	"strings"
+	"time"
+)
+
+func (s *llmService) SendOpenAIRequest(systemPrompt string, userPrompt string, model string) (string, error) {
+	apiKey := getEnvConfig("OPENAI_API_KEY")
+	if apiKey == "" {
+		return "", errors.New("OPENAI_API_KEY not found in .env or environment")
+	}
+
+	apiBase := "https://api.openai.com/v1"
+
+	url := fmt.Sprintf("%s/chat/completions", strings.TrimRight(apiBase, "/"))
+
+	reqBody := map[string]interface{}{
+		"model": model,
+		"messages": []map[string]string{
+			{"role": "system", "content": systemPrompt},
+			{"role": "user", "content": userPrompt},
+		},
+	}
+
+	jsonBody, err := json.Marshal(reqBody)
+	if err != nil {
+		return "", err
+	}
+
+	var lastErr error
+	// Retry up to 5 times (total 5 attempts)
+	for i := 0; i < 5; i++ {
+		req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonBody))
+		if err != nil {
+			return "", err
+		}
+		req.Header.Set("Content-Type", "application/json")
+		req.Header.Set("Authorization", "Bearer "+apiKey)
+
+		client := &http.Client{Timeout: 120 * time.Second}
+		resp, err := client.Do(req)
+
+		if err != nil {
+			lastErr = err
+			time.Sleep(time.Second * time.Duration(1<<i))
+			continue
+		}
+
+		bodyBytes, err := io.ReadAll(resp.Body)
+		resp.Body.Close()
+		if err != nil {
+			lastErr = err
+			time.Sleep(time.Second * time.Duration(1<<i))
+			continue
+		}
+
+		if resp.StatusCode != http.StatusOK {
+			lastErr = fmt.Errorf("OpenAI API error status %d: %s", resp.StatusCode, string(bodyBytes))
+			time.Sleep(time.Second * time.Duration(1<<i))
+			continue
+		}
+
+		var result struct {
+			Choices []struct {
+				Message struct {
+					Content string `json:"content"`
+				} `json:"message"`
+			} `json:"choices"`
+		}
+		if err := json.Unmarshal(bodyBytes, &result); err != nil {
+			return "", err
+		}
+
+		if len(result.Choices) > 0 {
+			return result.Choices[0].Message.Content, nil
+		}
+		return "", errors.New("empty response from OpenAI API")
+	}
+
+	return "", fmt.Errorf("failed to get OpenAI response after 5 attempts. Last error: %v", lastErr)
+}

mindforge.cronjob/internal/message/messages.go

@@ -0,0 +1,72 @@
+package message
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"log"
+	"net/http"
+	"os"
+	"time"
+)
+
+// Discord webhook payload
+type discordPayload struct {
+	Content string `json:"content"`
+}
+
+func SendDiscordNotification(filename string, message string) error {
+	webhookURL := os.Getenv("DISCORD_WEBHOOK_URL")
+	if webhookURL == "" {
+		log.Printf("DISCORD_WEBHOOK_URL environment variable not set")
+		return fmt.Errorf("DISCORD_WEBHOOK_URL environment variable not set")
+	}
+
+	todays_date := time.Now().Format("02/01/2006")
+	title := "# " + todays_date + " - Resumo semanal - *" + filename + "*"
+
+	content := title + "\n" + message
+	runes := []rune(content)
+	maxLen := 1800
+
+	for i := 0; i < len(runes); {
+		end := i + maxLen
+		if end >= len(runes) {
+			end = len(runes)
+		} else {
+			for end < len(runes) && runes[end] != '\n' {
+				end++
+			}
+			if end < len(runes) && runes[end] == '\n' {
+				end++
+			}
+		}
+		chunk := string(runes[i:end])
+		payload := discordPayload{Content: chunk}
+
+		jsonData, err := json.Marshal(payload)
+		if err != nil {
+			log.Printf("Failed to marshal Discord payload: %v", err)
+			return err
+		}
+
+		log.Printf("Sending Discord notification chunk (start: %d, end: %d)", i, end)
+		resp, err := http.Post(webhookURL, "application/json", bytes.NewBuffer(jsonData))
+		if err != nil {
+			log.Printf("Error posting to Discord webhook: %v", err)
+			return err
+		}
+
+		if resp.StatusCode < 200 || resp.StatusCode >= 300 {
+			log.Printf("Discord webhook returned status: %s", resp.Status)
+			resp.Body.Close()
+			return fmt.Errorf("Discord webhook returned status: %s", resp.Status)
+		}
+		resp.Body.Close()
+
+		i = end
+	}
+
+	log.Printf("Discord notification sent successfully: Title='%s'", title)
+	return nil
+}