@ingeniomaps/cauce 0.22.0 → 0.24.0

package/template/planning/rules/system/conduct.md

@@ -0,0 +1,32 @@
+# Conducta
+
+## R12 — Sistemas externos, reales y de sólo lectura
+
+Todo sistema externo se considera real y de producción mientras no se lo nombre explícitamente como
+sandbox. Sin aprobación humana explícita:
+
+- no desplegar, publicar, enviar mensajes ni escribir en producción;
+- no cobrar, reembolsar, gastar créditos ni llamar APIs con costo de forma repetida;
+- no editar secretos, credenciales, DNS, permisos o cuentas;
+- no borrar datos ni ejecutar migraciones irreversibles.
+
+Las excepciones se documentan en el `AGENTS.md` del proyecto, nombrando el entorno concreto.
+
+## R13 — Negarse no es entregar
+
+Cada límite tiene una contraparte positiva, y respetarlo no exime de ella. Negarse bien y no dejar nada
+deja el pedido sin resolver: es la mitad barata del trabajo.
+
+- Ante falta de contexto se produce el borrador reversible marcado como supuesto, en vez de bloquear
+  pidiendo insumos. Se pide una decisión humana sólo cuando las opciones cambian materialmente el rumbo,
+  el gasto, una obligación externa o el riesgo. Un borrador que se puede tirar no cambia ninguna de esas
+  cosas; no entregarlo, sí.
+- Delimitar el espacio de decisión no es decidir: cuando ninguna opción cambia materialmente el rumbo, se
+  propone una, con su razón, marcada como propuesta.
+- Todo rechazo se acompaña de lo que sí corresponde hacer, dicho como acción concreta y no como
+  categoría. «Esto no me corresponde» sin decir a quién ni con qué pregunta deja el pedido donde estaba.
+- Nombrar lo que falta no reemplaza a entregar lo que se puede: lo que sí se pudo establecer se escribe
+  igual, aunque quede parcial y marcado como tal.
+
+Esto no afloja ningún límite: no promover, no prometer fechas, no inventar evidencia y no exceder la
+autoridad del cargo siguen siendo absolutos. Lo que se cierra es la salida de cumplirlos sin entregar.

package/template/tools/ops.js

@@ -4,7 +4,7 @@
 // Punto de entrada estable del proyecto: nadie —ni una persona ni un agente— necesita saber de
 // dónde sale el motor. Viene de la dependencia npm, que el lockfile versiona.
 
-const path = require('path')
+const path = require('node:path')
 
 const root = path.join(__dirname, '..')
 

package/.github/workflows/agent-learning.yml

@@ -1,324 +0,0 @@
-name: Agent learning proposals
-
-# Consolida el ciclo mensual de aprendizaje de todos los agentes. La lista sale del árbol
-# `agents/<tipo>/<slug>/SKILL.md`, así que agregar un agente no toca este archivo.
-
-on:
-  schedule:
-    # Semanal la investigación, mensual la consolidación. La propuesta sólo vale si antes hubo
-    # informes: consolidar sin ellos produce un andamiaje vacío que nadie puede aprobar.
-    - cron: "17 13 * * 1"
-    - cron: "17 13 1 * *"
-  workflow_dispatch:
-    inputs:
-      agent:
-        description: "Slug de un agente. Vacío corre todos."
-        required: false
-        default: ""
-
-# Mínimo arriba: cada job eleva sólo lo que necesita. El que corre el agente se queda en `read` —
-# ingiere contenido web que no controlamos y no tiene por qué poder escribir el repositorio.
-permissions:
-  contents: read
-
-jobs:
-  discover:
-    runs-on: ubuntu-latest
-    outputs:
-      agents: ${{ steps.list.outputs.agents }}
-    steps:
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
-        with:
-          node-version: "24"
-
-      - name: Resolve CLI
-        id: cli
-        run: |
-          for candidate in tools/ops.js .ops/engine/cli/ops.js engine/cli/ops.js; do
-            if [ -f "$candidate" ]; then
-              echo "path=$candidate" >> "$GITHUB_OUTPUT"
-              exit 0
-            fi
-          done
-          echo "No se encontró el CLI de Cauce." >&2
-          exit 1
-
-      # El CLI resuelve la precedencia del catálogo; repetir ese recorrido acá lo dejaría
-      # divergir en silencio la próxima vez que cambie la estructura.
-      - name: List agents
-        id: list
-        env:
-          ONLY: ${{ inputs.agent }}
-          OPS: ${{ steps.cli.outputs.path }}
-        run: |
-          all=$(node "$OPS" agents list . --json)
-          node -e '
-            const fs = require("fs")
-            const only = (process.env.ONLY || "").trim()
-            const slugs = JSON.parse(process.argv[1]).map((role) => role.slug)
-            const list = only ? slugs.filter((slug) => slug === only) : slugs.sort()
-            if (!list.length) {
-              console.error(only ? `No existe el agente "${only}".` : "No se encontró ningún agente.")
-              process.exit(1)
-            }
-            fs.appendFileSync(process.env.GITHUB_OUTPUT, `agents=${JSON.stringify(list)}\n`)
-          ' "$all"
-
-  # La investigación necesita un modelo, así que este job sólo corre si el repositorio declara una
-  # credencial. Sin ella se saltea entero en vez de abrir un PR por cargo con un informe vacío, que
-  # es ruido con forma de trabajo. `learn` solo arma el andamiaje; llenarlo es lo que hace un agente.
-  research:
-    if: github.event.schedule != '17 13 1 * *'
-    needs: discover
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    strategy:
-      fail-fast: false
-      max-parallel: 3
-      matrix:
-        agent: ${{ fromJSON(needs.discover.outputs.agents) }}
-    steps:
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
-        with:
-          node-version: "24"
-      - name: Check credential
-        id: creds
-        env:
-          KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-        run: |
-          if [ -n "$KEY" ]; then
-            echo "ready=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "ready=false" >> "$GITHUB_OUTPUT"
-            echo "Sin ANTHROPIC_API_KEY: la investigación semanal queda para correr a mano." >&2
-          fi
-      - name: Resolve CLI
-        if: steps.creds.outputs.ready == 'true'
-        id: cli
-        run: |
-          for candidate in tools/ops.js engine/cli/ops.js; do
-            if [ -f "$candidate" ]; then
-              echo "path=$candidate" >> "$GITHUB_OUTPUT"
-              exit 0
-            fi
-          done
-          echo "No se encontró el CLI de Cauce." >&2
-          exit 1
-      - name: Prepare report
-        if: steps.creds.outputs.ready == 'true'
-        env:
-          AGENT: ${{ matrix.agent }}
-          OPS: ${{ steps.cli.outputs.path }}
-        run: node "$OPS" learn "$AGENT"
-      # El prompt no lo escribe este archivo: lo declara el propio cargo en su
-      # `learning/AUTOMATION.md`. Así un cargo nuevo trae su investigación sin tocar el cron.
-      - name: Research
-        if: steps.creds.outputs.ready == 'true'
-        env:
-          AGENT: ${{ matrix.agent }}
-          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-        run: |
-          npm install -g @anthropic-ai/claude-code@2.1.233
-          claude -p "Leé el learning/AUTOMATION.md del cargo $AGENT y ejecutá exactamente lo que declara. El informe de esta semana ya está creado y vacío: completalo. Cada afirmación necesita enlace, fecha y versión; lo que no puedas corroborar va a Preguntas abiertas en vez de afirmarse. El único archivo que escribís es ese informe."
-      - name: Detect changes
-        if: steps.creds.outputs.ready == 'true'
-        id: changes
-        run: |
-          if git diff --quiet; then
-            echo "changed=false" >> "$GITHUB_OUTPUT"
-          else
-            echo "changed=true" >> "$GITHUB_OUTPUT"
-          fi
-      # El informe sale de acá como artifact, no como commit. Lo que el agente escribió fuera de su
-      # informe se queda en este runner y muere con él: no hay credencial con que sacarlo.
-      - name: Collect report
-        if: steps.creds.outputs.ready == 'true' && steps.changes.outputs.changed == 'true'
-        id: collect
-        env:
-          AGENT: ${{ matrix.agent }}
-        run: |
-          stamp="$(date -u +%Y-%m-%d)"
-          report="$(git diff --name-only -- "agents/*/$AGENT/learning/reports/$stamp.md")"
-          if [ -z "$report" ]; then
-            echo "El agente no escribió su informe; lo que haya tocado no sale de acá." >&2
-            git diff --name-only >&2
-            exit 1
-          fi
-          echo "path=$report" >> "$GITHUB_OUTPUT"
-          echo "stamp=$stamp" >> "$GITHUB_OUTPUT"
-      - name: Upload report
-        if: steps.collect.outputs.path != ''
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
-        with:
-          name: research-${{ matrix.agent }}
-          path: ${{ steps.collect.outputs.path }}
-          retention-days: 7
-
-  # Segundo job y no un paso más: acá vive la credencial de escritura, y para llegar hasta acá el
-  # informe tuvo que pasar por un artifact. Este job no habla con ningún modelo ni lee la web —
-  # recibe un archivo, comprueba que caiga donde debe, y lo commitea.
-  research-pr:
-    needs: [discover, research]
-    if: needs.research.result == 'success'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-    strategy:
-      fail-fast: false
-      max-parallel: 3
-      matrix:
-        agent: ${{ fromJSON(needs.discover.outputs.agents) }}
-    steps:
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
-      - name: Download report
-        id: fetch
-        continue-on-error: true
-        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
-        with:
-          name: research-${{ matrix.agent }}
-          path: ${{ github.workspace }}
-      - name: Resolve CLI
-        if: steps.fetch.outcome == 'success'
-        id: cli
-        run: |
-          for candidate in tools/ops.js engine/cli/ops.js; do
-            if [ -f "$candidate" ]; then
-              echo "path=$candidate" >> "$GITHUB_OUTPUT"
-              exit 0
-            fi
-          done
-          echo "No se encontró el CLI de Cauce." >&2
-          exit 1
-      - name: Open research pull request
-        if: steps.fetch.outcome == 'success'
-        env:
-          AGENT: ${{ matrix.agent }}
-          OPS: ${{ steps.cli.outputs.path }}
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          stamp="$(date -u +%Y-%m-%d)"
-          branch="automation/$AGENT-research-$stamp"
-          # El artifact trae contenido, no destino: `upload-artifact` aplana la ruta de un archivo
-          # suelto, así que llega como `<fecha>.md` a la raíz. Dónde va se resuelve **acá**, con el
-          # mismo CLI que resolvió el catálogo antes, y eso además es la garantía: nada de lo que
-          # venga en el artifact puede redirigir dónde aterriza el archivo.
-          dir="$(node "$OPS" agents list --json | node -e '
-            let s = ""
-            process.stdin.on("data", (d) => { s += d }).on("end", () => {
-              const found = JSON.parse(s).find((role) => role.slug === process.env.AGENT)
-              if (!found) { console.error("agente desconocido"); process.exit(1) }
-              console.log(found.path)
-            })')"
-          dest="$dir/learning/reports/$stamp.md"
-          mkdir -p "$(dirname "$dest")"
-          mv "$stamp.md" "$dest"
-          report="$(git diff --name-only -- "agents/*/$AGENT/learning/reports/$stamp.md")"
-          otros="$(git status --porcelain | awk '{print $2}' | grep -v -F "$dest" || true)"
-          if [ -z "$report" ] && [ ! -f "$dest" ]; then
-            echo "No llegó el informe de $AGENT." >&2
-            exit 1
-          fi
-          if [ -n "$otros" ]; then
-            echo "Se esperaba exactamente el informe de $AGENT y nada más." >&2
-            git status --porcelain >&2
-            exit 1
-          fi
-          report="$dest"
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git switch -c "$branch"
-          git add "$report"
-          git commit -m "docs($AGENT): weekly research $stamp"
-          git push origin "$branch"
-          gh pr create --base "$GITHUB_REF_NAME" --head "$branch" \
-            --title "$AGENT weekly research — $stamp" \
-            --body "Investigación semanal de la profesión. No modifica SKILL.md ni propone cambios: alimenta la propuesta mensual."
-
-  # Este job no habla con ningún modelo: consolida informes ya commiteados con el CLI y abre el PR.
-  # Por eso puede escribir sin la separación que exige `research`.
-  propose:
-    if: github.event.schedule == '17 13 1 * *' || github.event_name == 'workflow_dispatch'
-    needs: discover
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-    strategy:
-      fail-fast: false
-      max-parallel: 5
-      matrix:
-        agent: ${{ fromJSON(needs.discover.outputs.agents) }}
-    steps:
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
-        with:
-          node-version: "24"
-
-      # El CLI vive en `tools/ops.js` dentro de un proyecto generado y en `engine/cli/ops.js`
-      # dentro del repositorio del toolkit.
-      - name: Resolve CLI
-        id: cli
-        run: |
-          for candidate in tools/ops.js .ops/engine/cli/ops.js engine/cli/ops.js; do
-            if [ -f "$candidate" ]; then
-              echo "path=$candidate" >> "$GITHUB_OUTPUT"
-              exit 0
-            fi
-          done
-          echo "No se encontró el CLI de Cauce." >&2
-          exit 1
-
-      - name: Validate current agent
-        env:
-          AGENT: ${{ matrix.agent }}
-          OPS: ${{ steps.cli.outputs.path }}
-        run: node "$OPS" evaluate "$AGENT"
-
-      - name: Build monthly proposal from weekly reports
-        env:
-          AGENT: ${{ matrix.agent }}
-          OPS: ${{ steps.cli.outputs.path }}
-        run: node "$OPS" learn "$AGENT" --proposal
-
-      - name: Validate proposal
-        env:
-          AGENT: ${{ matrix.agent }}
-          OPS: ${{ steps.cli.outputs.path }}
-        run: node "$OPS" evaluate "$AGENT"
-
-      - name: Detect changes
-        id: changes
-        run: |
-          if git diff --quiet; then
-            echo "changed=false" >> "$GITHUB_OUTPUT"
-          else
-            echo "changed=true" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Open proposal pull request
-        if: steps.changes.outputs.changed == 'true'
-        env:
-          AGENT: ${{ matrix.agent }}
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          period="$(date -u +%Y-%m)"
-          branch="automation/$AGENT-$period"
-          proposal="$(git diff --name-only -- "agents/*/$AGENT/learning/proposals/$period.md")"
-          if [ -z "$proposal" ]; then
-            echo "El agente cambió archivos fuera de su propuesta; no se abre PR." >&2
-            git diff --name-only >&2
-            exit 1
-          fi
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git switch -c "$branch"
-          git add "$proposal"
-          git commit -m "docs($AGENT): propose $period learning review"
-          git push origin "$branch"
-          gh pr create --base "$GITHUB_REF_NAME" --head "$branch" \
-            --title "$AGENT learning proposal — $period" \
-            --body "Propuesta automática construida desde los informes semanales. No modifica SKILL.md y requiere evaluación y aprobación humana."

package/.github/workflows/ci.yml

@@ -1,27 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: ["**"]
-  pull_request:
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ci-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  ci:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
-        with:
-          node-version: "24"
-      # Valida planning, automatización e integraciones y después corre las pruebas
-      # exigiendo los umbrales de cobertura. Sin dependencias que instalar.
-      - name: Validate and test
-        run: npm run ci