faure 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b6caa6c0d2ed4a8ad383112454acb77a37df2af5db57cb1dc4f4cc6a23fc8191
+  data.tar.gz: 0de6f2b9d21361bcb0b8c3566187ed2ea5f08b35723a2a5da8a6c7f1c0471f1f
+SHA512:
+  metadata.gz: 3c7e2438a5e882f4fde1d94692452914b86786acaaeaca4882efff96f16853839a4d43d1556aa60968cb3520c8cc8b5b94dd21198803332faf6868f85cd5c857
+  data.tar.gz: 6c705864faf21d94c6213757d5e722eb747fd2d1a34a96d338ed980afae21c734ab80656e930be550486e1df8f7ab2409829c2cadb3c0b5c6c644684cad9149a

data/README.md

@@ -0,0 +1,48 @@
+# ShamoX Agent
+
+Agent codeur autonome GitLab CI/CD + MLX local.
+
+## Architecture
+
+```
+Issue GitLab + commentaire @shamox-codeur
+    ↓
+Webhook GitLab → trigger pipeline CI
+    ↓
+Job `codeur` (Qwen3-Coder-30B via mlx_lm)
+  - lit l'issue et l'historique des commentaires
+  - produit les modifications de fichiers en XML
+  - commit + push sur feature/issue-NNN
+    ↓
+Job `agent-git` (Qwen3.5-4B via mlx_lm)
+  - analyse le diff
+  - génère la description de MR
+  - crée la MR et assigne le reviewer
+    ↓
+Review manuelle + merge
+```
+
+## Variables CI/CD requises
+
+| Variable | Description |
+|---|---|
+| `SHAMOX_BOT_ID` | ID GitLab du compte de service shamox-bot |
+| `SHAMOX_BOT_API_TOKEN` | Project Access Token avec scope `api` |
+| `SHAMOX_REVIEWER_ID` | ID GitLab numérique du reviewer |
+
+## Intégration dans un projet
+
+Dans le `.gitlab-ci.yml` du projet cible, inclure :
+
+```yaml
+include:
+  - project: 'rlaures.pro/shamox-agent'
+    ref: main
+    file: '.gitlab-ci.yml'
+```
+
+## Stack
+
+- Ruby stdlib uniquement (pas de gems externes)
+- mlx_lm sur Apple Silicon (M1/M4)
+- GitLab CI/CD Runners headless (chacana, hecaton-macmini-001)

data/bin/faure-agent

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require_relative '../lib/faure/agent'
+Faure::Agent.new.run

data/bin/faure-codeur

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require_relative '../lib/faure/codeur'
+Faure::Codeur.new.run

data/lib/faure/agent.rb

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+# lib/faure/agent.rb
+
+require 'net/http'
+require 'json'
+require 'uri'
+require_relative 'version'
+require_relative 'config'
+
+module Faure
+  class Agent
+
+    def initialize
+      payload    = JSON.parse(ENV.fetch('TRIGGER_PAYLOAD', '{}'))
+      @issue_iid = payload.dig('issue', 'iid').to_s
+    end
+
+    def run
+      branch_name = "feature/issue-#{@issue_iid}"
+      diff        = `git diff origin/#{Config::TARGET_BRANCH}...#{branch_name} --stat`
+      diff_full   = `git diff origin/#{Config::TARGET_BRANCH}...#{branch_name}`
+
+      if diff.strip.empty?
+        puts '[faure:agent] Aucun diff détecté, abandon.'
+        exit 0
+      end
+
+      puts "[faure:agent] Diff détecté :\n#{diff}"
+
+      description = call_model([
+        { role: 'system', content: mr_system_prompt },
+        { role: 'user', content: <<~PROMPT }
+          Voici le diff de la branche #{branch_name} :
+          #{diff_full[0..3000]}
+          Rédige une description de MR en 3-5 phrases : ce qui a été fait, pourquoi, et ce qu'il faut vérifier.
+        PROMPT
+      ])
+
+      puts '[faure:agent] Description MR générée'
+
+      res  = gitlab_post("/projects/#{Config::PROJECT_ID}/merge_requests", {
+        source_branch:        branch_name,
+        target_branch:        Config::TARGET_BRANCH,
+        title:                "faure: résolution issue ##{@issue_iid}",
+        description:          "Closes ##{@issue_iid}\n\n#{description}",
+        reviewer_ids:         [Config::REVIEWER_ID],
+        remove_source_branch: true,
+        squash:               false
+      })
+      body = JSON.parse(res.body)
+
+      if body['web_url']
+        puts "[faure:agent] MR créée : #{body['web_url']}"
+      else
+        puts "[faure:agent] Erreur création MR : #{res.body}"
+        exit 1
+      end
+    end
+
+    private
+
+    def mr_system_prompt
+      if Config::LANG == 'fr'
+        'Tu es un assistant qui rédige des descriptions de Merge Request claires et concises en français. Réponds uniquement avec le texte de la description, sans balises.'
+      else
+        'You are an assistant that writes clear and concise Merge Request descriptions in English. Reply only with the description text, no markup.'
+      end
+    end
+
+    def call_model(messages, max_tokens: 512)
+      uri = URI("#{Config::OPENAI_URL}/v1/chat/completions")
+      req = Net::HTTP::Post.new(uri)
+      req['Content-Type'] = 'application/json'
+      req.body = { model: Config::AGENT_MODEL, messages: messages, max_tokens: max_tokens }.to_json
+      res  = Net::HTTP.start(uri.host, uri.port) { |h| h.request(req) }
+      JSON.parse(res.body).dig('choices', 0, 'message', 'content')
+    end
+
+    def gitlab_post(path, payload)
+      uri = URI("#{Config::GITLAB_URL}/api/v4#{path}")
+      req = Net::HTTP::Post.new(uri)
+      req['PRIVATE-TOKEN'] = Config::API_TOKEN
+      req['Content-Type']  = 'application/json'
+      req.body = payload.to_json
+      Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') { |h| h.request(req) }
+    end
+
+  end
+end

data/lib/faure/codeur.rb

@@ -0,0 +1,211 @@
+#!/usr/bin/env ruby
+# lib/faure/codeur.rb
+
+require 'net/http'
+require 'json'
+require 'uri'
+require 'fileutils'
+require_relative 'version'
+require_relative 'config'
+
+module Faure
+  class Codeur
+
+    def initialize
+      payload        = JSON.parse(ENV.fetch('TRIGGER_PAYLOAD', '{}'))
+      @note          = payload.dig('object_attributes', 'note') || ''
+      @noteable_type = payload.dig('object_attributes', 'noteable_type')
+      @author_id     = payload.dig('user', 'id').to_i
+      @issue_iid     = payload.dig('issue', 'iid').to_s
+    end
+
+    def run
+      guard!
+      puts "[faure] Issue ##{@issue_iid} — auteur_id=#{@author_id}"
+
+      issue    = gitlab_get("/projects/#{Config::PROJECT_ID}/issues/#{@issue_iid}")
+      comments = gitlab_get("/projects/#{Config::PROJECT_ID}/issues/#{@issue_iid}/notes?sort=asc&per_page=100")
+
+      previous_summary = comments
+        .select { |n| n['body'].include?('<!-- faure:context -->') }
+        .last&.dig('body')
+
+      pending_question = comments
+        .select { |n| n['body'].include?('🤔 **faure demande :**') }
+        .last
+
+      mode = if pending_question && !@note.include?('@faure-codeur')
+        :answering_question
+      else
+        :new_instruction
+      end
+
+      puts "[faure] Mode : #{mode}"
+
+      branch_name  = "feature/issue-#{@issue_iid}"
+      user_content = build_prompt(mode, issue, previous_summary, pending_question)
+
+      puts "[faure] Appel #{Config::CODER_MODEL}..."
+      response = call_model(Config::CODER_MODEL, [
+        { role: 'system', content: system_prompt },
+        { role: 'user',   content: user_content }
+      ])
+      puts "[faure] Réponse reçue (#{response.length} chars)"
+
+      files    = parse_files(response)
+      question = parse_question(response)
+
+      if files.empty? && question.nil?
+        post_comment("⚠️ faure: réponse non structurée du modèle. Relancer ou reformuler l'issue.")
+        exit 1
+      end
+
+      commit_files(files, branch_name) unless files.empty?
+      post_comment("🤔 **faure demande :** #{question}") if question
+
+      summary = summarize_context(issue['title'], previous_summary, response, branch_name)
+      post_comment("<!-- faure:context -->\n#{summary}")
+
+      puts '[faure] Codeur terminé.'
+    end
+
+    private
+
+    def guard!
+      abort '[faure] Pas un commentaire sur issue, abandon.'       unless @noteable_type == 'Issue'
+      abort '[faure] Commentaire du bot, abandon.'                 if @author_id == Config::BOT_ID
+      abort '[faure] Commentaire faure:context, abandon.'          if @note.include?('<!-- faure:context -->')
+      abort '[faure] Pas de mention @faure-codeur ni réponse attendue.' \
+        unless @note.include?('@faure-codeur') || @note.match?(/^[^@]/)
+    end
+
+    def system_prompt
+      lang_instruction = Config::LANG == 'fr' ? 'Réponds en français.' : 'Reply in English.'
+      <<~SYSTEM
+        Tu es un agent codeur expert. Tu reçois une tâche de développement et tu dois produire les modifications de fichiers nécessaires.
+        #{lang_instruction}
+        Réponds UNIQUEMENT avec des balises XML :
+        - <file path="chemin/fichier">contenu complet du fichier</file> pour chaque fichier modifié
+        - <question>ta question</question> si tu as besoin de clarifications (peut coexister avec des <file>)
+        Ne produis rien en dehors de ces balises XML.
+      SYSTEM
+    end
+
+    def build_prompt(mode, issue, previous_summary, pending_question)
+      case mode
+      when :answering_question
+        <<~PROMPT
+          Contexte de la tâche :
+          #{previous_summary || issue['description']}
+
+          Question que tu avais posée :
+          #{pending_question['body']}
+
+          Réponse :
+          #{@note}
+        PROMPT
+      when :new_instruction
+        if previous_summary
+          <<~PROMPT
+            Contexte de la tâche :
+            #{previous_summary}
+
+            Nouvelle instruction : #{@note}
+          PROMPT
+        else
+          <<~PROMPT
+            Issue ##{@issue_iid} : #{issue['title']}
+
+            Description :
+            #{issue['description']}
+
+            #{@note.include?('@faure-codeur') ? "Instruction : #{@note}" : ''}
+          PROMPT
+        end
+      end
+    end
+
+    def commit_files(files, branch_name)
+      puts "[faure] #{files.size} fichier(s) à écrire..."
+      files.each do |f|
+        full_path = File.join(Config::PROJECT_DIR, f[:path])
+        FileUtils.mkdir_p(File.dirname(full_path))
+        File.write(full_path, f[:content])
+        puts "  → #{f[:path]}"
+      end
+
+      system("git config user.email 'faure@liant.dev'")
+      system("git config user.name 'Faure Codeur'")
+      system("git checkout -B #{branch_name}")
+      system('git add -A')
+      system("git commit -m 'faure(issue-#{@issue_iid}): modifications automatiques'")
+      system("git push origin #{branch_name} --force-with-lease 2>/dev/null || git push origin #{branch_name} --force")
+      puts "[faure] Push sur #{branch_name} effectué"
+    end
+
+    def summarize_context(issue_title, previous_summary, response, branch_name)
+      messages = [
+        { role: 'system', content: "Tu es un assistant qui résume de façon concise l'état d'avancement d'une tâche de développement. Réponds uniquement en XML valide." },
+        { role: 'user', content: <<~PROMPT }
+          Issue : #{issue_title}
+          Résumé précédent : #{previous_summary || 'aucun'}
+          Dernière réponse du codeur :
+          #{response[0..2000]}
+
+          Produis un résumé structuré :
+          <context>
+            <task>description courte de la tâche</task>
+            <done>ce qui a été fait</done>
+            <pending>ce qui reste ou les questions en suspens</pending>
+            <branch>#{branch_name}</branch>
+          </context>
+        PROMPT
+      ]
+      call_model(Config::SUMMARY_MODEL, messages, max_tokens: 512)
+    end
+
+    def parse_files(content)
+      content.scan(/<file path="([^"]+)">(.*?)<\/file>/m).map do |path, body|
+        { path: path.strip, content: body.strip }
+      end
+    end
+
+    def parse_question(content)
+      m = content.match(/<question>(.*?)<\/question>/m)
+      m ? m[1].strip : nil
+    end
+
+    def call_model(model, messages, max_tokens: 4096)
+      uri = URI("#{Config::OPENAI_URL}/v1/chat/completions")
+      req = Net::HTTP::Post.new(uri)
+      req['Content-Type'] = 'application/json'
+      req.body = { model: model, messages: messages, max_tokens: max_tokens }.to_json
+      res  = Net::HTTP.start(uri.host, uri.port) { |h| h.request(req) }
+      data = JSON.parse(res.body)
+      data.dig('choices', 0, 'message', 'content') or raise "Réponse inattendue : #{res.body}"
+    end
+
+    def gitlab_get(path)
+      uri = URI("#{Config::GITLAB_URL}/api/v4#{path}")
+      req = Net::HTTP::Get.new(uri)
+      req['PRIVATE-TOKEN'] = Config::API_TOKEN
+      res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') { |h| h.request(req) }
+      JSON.parse(res.body)
+    end
+
+    def gitlab_post(path, payload)
+      uri = URI("#{Config::GITLAB_URL}/api/v4#{path}")
+      req = Net::HTTP::Post.new(uri)
+      req['PRIVATE-TOKEN'] = Config::API_TOKEN
+      req['Content-Type']  = 'application/json'
+      req.body = payload.to_json
+      Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') { |h| h.request(req) }
+    end
+
+    def post_comment(body)
+      gitlab_post("/projects/#{Config::PROJECT_ID}/issues/#{@issue_iid}/notes", { body: body })
+      puts "[faure] Commentaire posté sur l'issue ##{@issue_iid}"
+    end
+
+  end
+end

data/lib/faure/config.rb

@@ -0,0 +1,23 @@
+module Faure
+  module Config
+    # Obligatoires
+    API_TOKEN    = ENV.fetch('FAURE_API_TOKEN')
+    REVIEWER_ID  = ENV.fetch('FAURE_REVIEWER_ID').to_i
+    BOT_ID       = ENV.fetch('FAURE_BOT_ID', '0').to_i
+    OPENAI_URL   = ENV.fetch('OPENAI_API_URL', 'http://host.containers.internal:8080')
+
+    # Modèles — configurables par projet
+    CODER_MODEL   = ENV.fetch('FAURE_CODER_MODEL',   'mlx-community/Qwen3-Coder-30B-A3B-Instruct-4bit')
+    AGENT_MODEL   = ENV.fetch('FAURE_AGENT_MODEL',   'mlx-community/Qwen3.5-4B-4bit')
+    SUMMARY_MODEL = ENV.fetch('FAURE_SUMMARY_MODEL', 'mlx-community/Qwen3.5-4B-4bit')
+
+    # Options
+    TARGET_BRANCH = ENV.fetch('FAURE_TARGET_BRANCH', 'main')
+    LANG          = ENV.fetch('FAURE_LANG', 'fr')
+
+    # GitLab CI — injectées automatiquement
+    GITLAB_URL    = ENV.fetch('CI_SERVER_URL', 'https://gitlab.com')
+    PROJECT_ID    = ENV.fetch('CI_PROJECT_ID')
+    PROJECT_DIR   = ENV.fetch('CI_PROJECT_DIR', Dir.pwd)
+  end
+end

data/lib/faure/version.rb

@@ -0,0 +1,3 @@
+module Faure
+  VERSION = '0.1.1'
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: faure
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Roland Laurès
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-16 00:00:00.000000000 Z
+dependencies: []
+description: Faure orchestre un agent codeur et un agent git via GitLab CI/CD et un
+  backend OpenAI-compatible (mlx_lm, Ollama, OpenAI...).
+email:
+- roland@liant.dev
+executables:
+- faure-codeur
+- faure-agent
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/faure-agent
+- bin/faure-codeur
+- lib/faure/agent.rb
+- lib/faure/codeur.rb
+- lib/faure/config.rb
+- lib/faure/version.rb
+homepage: https://gitlab.com/rol-public/shamox-agent
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Agent codeur autonome GitLab CI/CD + backend OpenAI-compatible
+test_files: []