stratum-cli 0.9.0-beta.0 → 0.10.0

package/evals/scenarios/code/code-edit-typographic-quotes.json

@@ -0,0 +1,58 @@
+{
+  "id": "code-edit-typographic-quotes",
+  "group": "code",
+  "title": "Editar una línea con comillas tipográficas y guion largo",
+  "difficulty": "basic",
+  "setup": {
+    "files": {
+      "docs/nota.md": "# Nota\n\nEl \u201cinforme\u201d \u2014 pendiente de revisi\u00f3n\n"
+    }
+  },
+  "input": "En docs/nota.md, marca el informe como listo: deja la línea del informe como `El \"informe\" - listo`. No cambies nada más.",
+  "script": [
+    {
+      "toolCalls": [
+        {
+          "name": "read_file",
+          "args": {
+            "path": "docs/nota.md"
+          }
+        }
+      ]
+    },
+    {
+      "toolCalls": [
+        {
+          "name": "edit_file",
+          "args": {
+            "path": "docs/nota.md",
+            "old_string": "El \"informe\" - pendiente de revisi\u00f3n",
+            "new_string": "El \"informe\" - listo"
+          }
+        }
+      ]
+    },
+    {
+      "text": "Línea actualizada: el informe queda como listo."
+    }
+  ],
+  "expect": {
+    "description": "La línea del informe queda con comillas rectas y guion normal, sin tocar el resto del documento.",
+    "checks": [
+      {
+        "type": "command",
+        "label": "docs/nota.md tiene la línea reescrita y el resto intacto",
+        "run": [
+          "node",
+          "-e",
+          "const fs=require('fs');const want='# Nota\\n\\nEl \"informe\" - listo\\n';const got=fs.readFileSync('docs/nota.md','utf8');if(got!==want){console.error(JSON.stringify(got));process.exit(1)}"
+        ]
+      },
+      {
+        "type": "metric",
+        "metric": "toolCalls",
+        "max": 6
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stratum-cli",
-  "version": "0.9.0-beta.0",
+  "version": "0.10.0",
   "description": "Agente CLI extensible sobre un loop ReAct — provider-agnostic (Ollama, llama.cpp, vLLM, LiteLLM, OpenAI), con plan-and-execute, subagentes, MCP y SSH nativo",
   "keywords": [
     "cli",
@@ -40,6 +40,7 @@
   "files": [
     "dist/",
     "evals/scenarios/",
+    "skills/",
     "STRATUM.md",
     ".stratumrc.json.example",
     "README.md",
@@ -57,7 +58,6 @@
   "scripts": {
     "dev": "tsx src/cli/index.ts",
     "build": "tsup",
-    "build:desktop": "tsup --config tsup.desktop.config.ts",
     "prepare": "tsup",
     "test": "vitest",
     "test:run": "vitest run",

package/skills/.stratum-builtin-skills

@@ -0,0 +1 @@
+Marca de la carpeta de skills de serie de Stratum (bundledSkillsDir). No borrar.

package/skills/stratum-global-memory/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: stratum-global-memory
+description: Úsala antes de guardar o consultar algo de tu memoria a largo plazo — una preferencia del usuario, un hecho estable sobre él o su trabajo — o cuando pida «recuerda», «apunta», «olvida» o pregunte qué te contó antes.
+presets: [assistant]
+---
+
+# Memoria global del asistente
+
+Tu memoria es **global**: la compartes entre todas las conversaciones con este usuario y no pertenece a ningún proyecto. No ves la memoria de los repositorios donde trabaja su agente de código, y lo que guardes no llega allí.
+
+| Capa | Para qué | Cómo |
+|---|---|---|
+| Decisiones | Preferencias, hechos estables y acuerdos que deben durar | `store_decision` / `recall_decisions` |
+| `STRATUM.md` global | Instrucciones permanentes que el usuario escribió para ti | Ya está en tus instrucciones. Solo lectura |
+
+La memoria de la conversación en curso es automática: no tiene tool y no la gestionas tú.
+
+## Antes de responder: consulta
+
+Si una preferencia o un hecho pasado podría cambiar tu respuesta (cómo le gusta que le escribas, a qué se dedica, algo que te pidió recordar), llama antes a `recall_decisions`. Si el índice no está disponible, sigue sin él: no reintentes.
+
+## Qué guardar con `store_decision`
+
+- una preferencia del usuario (tono, idioma, formato, herramientas que usa);
+- un hecho estable sobre él o su trabajo que le ayudará en otras conversaciones;
+- algo que te pide explícitamente que recuerdes.
+
+Usa `type: user_preference` para preferencias; para lo demás, el que mejor encaje. `title` corto, `content` con el contexto, hasta 5 `tags` e `importance`.
+
+**No guardes nunca:** secretos, contraseñas, datos de pago o de salud que no te haya pedido guardar; detalles de un proyecto concreto (eso es de la memoria de ese proyecto); lo que solo vale para esta conversación. Stratum también extrae recuerdos por su cuenta: no repitas a mano lo trivial.
+
+## Si `store_decision` devuelve un id que ya existía
+
+La memoria deduplica por significado: no se guardó nada nuevo porque ya había algo casi igual. No reintentes con otras palabras.
+
+## Corregir u olvidar
+
+No puedes editar ni borrar recuerdos. Para corregir uno, guarda otro cuyo `content` empiece por «Sustituye a `dec_…`:» con lo que cambió. Si el usuario quiere borrar algo, dile que puede hacerlo con `stratum memory forget --global <id>` (el id lo da `recall_decisions`).
+
+## `STRATUM.md` global
+
+No puedes escribirlo. Si algo merece ser una instrucción permanente («contéstame siempre en inglés»), propón al usuario el texto exacto y dile que lo añada a `~/.stratum/STRATUM.md`; mientras, guárdalo con `store_decision`.

package/skills/stratum-project-memory/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: stratum-project-memory
+description: Úsala antes de guardar o consultar algo de la memoria del proyecto — una decisión técnica, una convención, una preferencia del usuario sobre este repo — o cuando el usuario pida «recuerda», «apunta», «olvida» o pregunte qué se decidió antes.
+presets: [coding]
+---
+
+# Memoria del proyecto
+
+Trabajas en un proyecto y solo ves **su** memoria. No hay memoria global en esta sesión: lo que guardes se queda en este repositorio.
+
+| Capa | Dónde vive | Para qué |
+|---|---|---|
+| Decisiones | `<raíz del repo>/.stratum/memory/decisions.json` (con `store_decision` / `recall_decisions`) | Decisiones, convenciones y preferencias que deben sobrevivir a esta tarea |
+| `STRATUM.md` | `<raíz del repo>/STRATUM.md` (lo ves ya en tus instrucciones) | Reglas del proyecto que deben estar presentes en **cada** sesión |
+
+La memoria de la conversación (lo que se compacta en sesiones largas) es automática: no tiene tool y no la gestionas tú.
+
+## Antes de decidir: consulta
+
+Si vas a elegir algo que podría estar decidido ya (una librería, un patrón, cómo nombrar, cómo probar), llama antes a `recall_decisions` con una consulta en lenguaje natural. Si devuelve algo aplicable, síguelo y menciónalo; si contradice lo que pide el usuario, pregúntale.
+
+Si responde que el índice semántico no está disponible, sigue sin él: no reintentes.
+
+## Qué guardar con `store_decision`
+
+Guarda solo lo que un agente futuro necesitaría y no podría deducir del código:
+
+- una decisión con su porqué («usamos X en lugar de Y porque…»);
+- una convención del proyecto que no está escrita en otro sitio;
+- la causa de un bug difícil y cómo se resolvió;
+- una preferencia del usuario sobre cómo trabajar en este repo.
+
+Rellena todos los campos: `title` corto (≤ 100), `content` con contexto, alternativas y razón, `type` (`architectural`, `tooling`, `convention`, `bug_fix`, `security`, `user_preference`), hasta 5 `tags` e `importance`.
+
+**No guardes nunca:** secretos, tokens, contraseñas o rutas a credenciales; el estado de la tarea en curso (eso va en `todo`); lo que ya está en `STRATUM.md` o en el código; detalles que solo valen para esta conversación. Además Stratum extrae decisiones por su cuenta al final de cada respuesta: no repitas a mano lo trivial.
+
+## Si `store_decision` devuelve un id que ya existía
+
+La memoria deduplica por significado (similitud ≥ 0,9). Si el id devuelto no es nuevo, **no se guardó nada**: había una decisión casi igual. No reintentes con otras palabras. Si lo nuevo de verdad matiza lo anterior, guárdalo como corrección (abajo).
+
+## Corregir u olvidar
+
+No puedes editar ni borrar decisiones. Para corregir una:
+
+1. Guarda una decisión nueva cuyo `content` empiece por «Sustituye a `dec_…`:» y explique qué cambió y por qué.
+2. Dile al usuario que puede borrar la antigua con `stratum memory forget <id>`.
+
+Si el usuario pide olvidar algo, dale ese mismo comando con el id (búscalo con `recall_decisions`).
+
+## Cuándo usar `STRATUM.md`
+
+Para reglas que el agente debe tener siempre delante en este repo (comandos de build y test, convenciones de estilo, zonas que no tocar). Edítalo con `edit_file`, de forma breve: se carga entero en cada sesión. Si la regla es una decisión puntual, mejor `store_decision`. No escribas el `STRATUM.md` global (`~/.stratum/STRATUM.md`): es del asistente, no de este proyecto.
+
+## Modo read-only y modo plan
+
+`store_decision` no está disponible en una sesión read-only ni antes de aprobar un plan. No lo intentes: anota lo que guardarías y propónselo al usuario al final. `recall_decisions` sí funciona.

package/skills/stratum-skill-authoring/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: stratum-skill-authoring
+description: Úsala cuando el usuario quiera crear, escribir, mejorar o revisar una skill de Stratum, o convertir una forma de trabajar que repite en instrucciones reutilizables.
+presets: [coding, assistant]
+---
+
+# Diseñar una skill
+
+Una skill es un fichero markdown con instrucciones para un tipo de tarea. Stratum pone en tus instrucciones solo su nombre y su `description`; el cuerpo se carga con `read_skill` cuando la tarea encaja. Por eso la `description` decide si la skill se usa, y el cuerpo, si se usa bien.
+
+## 1. Entiende la tarea antes de escribir
+
+Pregunta (con `question`, en una sola tanda) lo que no sepas:
+
+- ¿Qué tarea concreta cubre y qué frases usaría el usuario al pedirla?
+- ¿Qué hace hoy mal o de forma inconsistente el agente sin ella?
+- ¿Para el agente de código, para el asistente o para ambos?
+- ¿Solo para un proyecto o para todos los del usuario?
+
+## 2. Escribe el frontmatter
+
+```markdown
+---
+name: nombre-en-minusculas-con-guiones
+description: Úsala cuando … (disparadores concretos: verbos, objetos, frases del usuario).
+presets: [coding]          # coding, assistant, o ambos
+---
+```
+
+- `name`: corto, en minúsculas, con guiones. Una skill con el mismo nombre que otra de menor precedencia la sustituye.
+- `description`: empieza por «Úsala cuando…» y nombra situaciones reconocibles, no el contenido. Mal: «Guía de despliegue». Bien: «Úsala cuando el usuario pida desplegar, publicar una release o subir a producción».
+- `presets`: sin él la skill vale solo para el agente de código.
+
+## 3. Escribe el cuerpo
+
+- Pasos accionables en imperativo, en el orden en que se hacen. Nada de teoría ni de historia.
+- Lo que el agente no sabría solo: comandos exactos, rutas, criterios para decidir, errores típicos y cómo evitarlos.
+- Qué no hacer, si hay un error frecuente.
+- Cómo comprobar que salió bien (un comando, un resultado esperado).
+- Breve: si pasa de una pantalla, probablemente son dos skills.
+- No incluyas secretos ni datos personales: la skill puede compartirse.
+
+## 4. Guárdala en su sitio
+
+| Para | Ruta |
+|---|---|
+| Este proyecto | `<repo>/.stratum/skills/<name>/SKILL.md` |
+| Todos los proyectos del usuario | `~/.stratum/skills/<name>/SKILL.md` |
+
+Precedencia: proyecto > usuario > las de serie de Stratum. Las nuevas se ven al empezar la siguiente sesión (`stratum skills list` las enumera).
+
+**Si eres el asistente** (no puedes escribir fuera de tu carpeta): escribe el fichero en `outputs/<name>/SKILL.md` y dile al usuario a qué ruta de la tabla copiarlo. Recuerda que el asistente solo carga las skills de serie de Stratum: una skill de usuario la usará su agente de código.
+
+## 5. Revísala con el usuario
+
+Enséñale la `description` y pregúntale si reconoce en ella las frases con las que pediría esa tarea. Si no, reescríbela: es lo que más importa.