javi-forge 0.1.0

package/modules/obsidian-brain/.project/Memory/README.md

@@ -0,0 +1,61 @@
+# Project Memory (Obsidian Brain)
+
+> Archivos de memoria persistente para AI CLIs y documentacion del proyecto.
+> Funciona como markdown plano sin Obsidian. Con Obsidian, agrega Kanban visual, queries Dataview y templates Templater.
+
+## Estructura
+
+```
+Memory/
+├── CONTEXT.md    <- Estado actual del proyecto (leer al inicio)
+├── DECISIONS.md  <- ADRs (Architecture Decision Records)
+├── BLOCKERS.md   <- Problemas encontrados y soluciones
+├── WAVES.md      <- Historial de oleadas de trabajo
+├── KANBAN.md     <- Board visual de tareas (plugin Kanban)
+├── DASHBOARD.md  <- Metricas y queries (plugin Dataview)
+└── README.md     <- Este archivo
+```
+
+## Flujo de Trabajo
+
+### Al iniciar sesion:
+1. Leer `CONTEXT.md` para recordar estado
+2. Revisar `KANBAN.md` para tareas activas
+3. Revisar `BLOCKERS.md` para issues pendientes
+4. Crear sesion: copiar `../Sessions/TEMPLATE.md` como `../Sessions/YYYY-MM-DD.md`
+   - Con Obsidian: usar Templater (Ctrl+T > Session) que auto-llena fecha y prompts
+   - Sin Obsidian: copiar TEMPLATE.md y reemplazar placeholders manualmente
+
+### Durante la sesion:
+5. Mover tareas en `KANBAN.md` entre lanes
+6. Documentar blockers si aparecen (usar inline fields: `type:: blocker`, `status:: open`)
+7. Registrar decisiones importantes como ADRs (usar inline fields: `type:: adr`, `status::`)
+
+### Al finalizar:
+8. Actualizar `CONTEXT.md`
+9. Completar sesion del dia
+
+## Templates disponibles
+
+En `../Templates/` hay templates de Templater (requieren plugin):
+- **Session.md** - Sesion con fecha automatica y prompts
+- **ADR.md** - Decision de arquitectura con prompts
+- **Blocker.md** - Blocker con prompts
+
+Sin Templater, usar los templates inline que estan al final de DECISIONS.md y BLOCKERS.md.
+
+## Con Obsidian
+
+Si abres el proyecto como vault de Obsidian:
+- **KANBAN.md** se renderiza como board visual (drag & drop)
+- **DASHBOARD.md** ejecuta queries Dataview automaticamente
+- **Templates/** permite crear sesiones y ADRs con Templater
+- Los links `[[ARCHIVO]]` navegan entre notas
+
+## Sin Obsidian
+
+Todo funciona como markdown plano:
+- **KANBAN.md** se edita moviendo lineas entre secciones H2
+- **DASHBOARD.md** muestra bloques de codigo (sin ejecutar)
+- Las sesiones se crean copiando TEMPLATE.md manualmente
+- Los links `[[ARCHIVO]]` se ven como texto plano (no navegables)

package/modules/obsidian-brain/.project/Memory/WAVES.md

@@ -0,0 +1,78 @@
+---
+type: waves
+updated: "[FECHA]"
+---
+
+# Oleadas de Trabajo
+
+> Registro historico de oleadas de tareas paralelas.
+> Para gestion dia a dia, usar [[KANBAN]]. WAVES.md es el historial de oleadas completadas.
+
+---
+
+## Oleada Actual
+
+**Numero:** 0
+**Estado:** Ninguna activa
+**Tareas:** -
+**Branches:** -
+**Inicio:** -
+
+---
+
+## Como usar oleadas
+
+### 1. Analizar dependencias
+
+```
+Tareas disponibles:
+- T-001: Setup monorepo          (sin deps)
+- T-002: Configurar CI           (depende de T-001)
+- T-003: Agregar linters         (depende de T-001)
+- T-004: Docker compose          (sin deps)
+- T-005: Integrar linters en CI  (depende de T-002, T-003)
+```
+
+### 2. Agrupar en oleadas
+
+```
+Oleada 1: T-001, T-004  (sin dependencias entre si)
+Oleada 2: T-002, T-003  (dependen solo de T-001)
+Oleada 3: T-005         (depende de oleada 2)
+```
+
+### 3. Ejecutar
+
+```bash
+# Crear oleada
+./scripts/new-wave.sh "T-001 T-004"
+
+# Crear branches
+./scripts/new-wave.sh --create-branches
+
+# Trabajar en paralelo...
+
+# Completar y merge
+./scripts/new-wave.sh --complete
+```
+
+---
+
+## Historial
+
+| # | Tareas | Inicio | Fin | Estado |
+|---|--------|--------|-----|--------|
+| - | - | - | - | - |
+
+---
+
+## Tips
+
+- **Maximo recomendado:** 5-7 tareas por oleada para mantener foco
+- **Sin limite tecnico:** El sistema soporta cualquier cantidad
+- **Merge order:** Mergear a develop cuando todas las tareas de la oleada esten listas
+- **Conflictos:** Si hay conflictos entre branches de la misma oleada, revisar dependencias
+
+---
+
+*Ultima actualizacion: [FECHA]*

package/modules/obsidian-brain/.project/Sessions/TEMPLATE.md

@@ -0,0 +1,99 @@
+---
+type: session
+date: "[YYYY-MM-DD]"
+phase: "[Foundation/MVP/Alpha/Beta]"
+wave: "[N]"
+---
+
+# Sesion - [YYYY-MM-DD]
+
+> Copiar este archivo como `YYYY-MM-DD.md` para cada sesion
+
+---
+
+## Contexto Inicial
+
+| Campo | Valor |
+|-------|-------|
+| **Fase** | [Foundation/MVP/...] |
+| **Oleada** | [N] |
+| **Branch** | [branch-name] |
+| **Tiempo Disponible** | [X] horas |
+
+---
+
+## Objetivos
+
+- [ ] Objetivo 1
+- [ ] Objetivo 2
+- [ ] Objetivo 3
+
+---
+
+## Tareas Trabajadas
+
+### [T-XXX] - [Titulo]
+
+| Campo | Valor |
+|-------|-------|
+| Inicio | HH:MM |
+| Fin | HH:MM |
+| Estado | Completada / En progreso / Bloqueada |
+
+**Cambios:**
+- [Cambio 1]
+- [Cambio 2]
+
+**Commits:**
+- `abc1234` - mensaje
+
+---
+
+## Problemas
+
+### Problema 1
+- **Que paso:** [descripcion]
+- **Solucion:** [como se resolvio]
+- **Documentado en:** [[BLOCKERS#BLOCKER-XXX]]
+
+---
+
+## Decisiones
+
+- **Decision:** [que se decidio]
+- **Razon:** [por que]
+- **Documentado en:** [[DECISIONS#ADR-XXX]]
+
+---
+
+## Aprendizajes
+
+- [Aprendi X sobre Y]
+- [Descubri que Z]
+
+---
+
+## Proxima Sesion
+
+### Continuar:
+- [ ] Tarea pendiente 1
+- [ ] Tarea pendiente 2
+
+### Preparar:
+- [ ] Leer documentacion de X
+- [ ] Revisar Y
+
+---
+
+## Resumen
+
+| Metrica | Valor |
+|---------|-------|
+| Tiempo total | X horas |
+| Tareas completadas | X |
+| Commits | X |
+| Blockers | X |
+
+---
+
+*Fin de sesion: HH:MM*

package/modules/obsidian-brain/.project/Templates/ADR.md

@@ -0,0 +1,33 @@
+## ADR-<% await tp.system.prompt("Numero de ADR (ej: 002)") %>: <% await tp.system.prompt("Titulo de la decision") %>
+
+type:: adr
+status:: pendiente
+date:: <% tp.date.now("YYYY-MM-DD") %>
+
+### Contexto
+
+<% await tp.system.prompt("Que problema o necesidad motivo esta decision") %>
+
+### Decision
+
+<% await tp.system.prompt("Que se decidio hacer") %>
+
+### Razones
+
+1. <% await tp.system.prompt("Razon principal") %>
+2.
+3.
+
+### Consecuencias
+
+**Positivas:**
+-
+
+**Negativas:**
+-
+
+### Alternativas Consideradas
+
+| Alternativa | Pros | Contras | Por que no |
+|-------------|------|---------|------------|
+| | | | |

package/modules/obsidian-brain/.project/Templates/Blocker.md

@@ -0,0 +1,21 @@
+### BLOCKER-<% await tp.system.prompt("Numero de blocker (ej: 002)") %>: <% await tp.system.prompt("Titulo del problema") %>
+
+type:: blocker
+status:: open
+impact:: <% await tp.system.prompt("Impacto (alto/medio/bajo)") %>
+date:: <% tp.date.now("YYYY-MM-DD") %>
+
+**Descripcion:**
+<% await tp.system.prompt("Que paso, como se manifesto") %>
+
+**Impacto:**
+-
+
+**Investigacion:**
+1.
+
+**Solucion:**
+_(Completar cuando se resuelva)_
+
+**Lecciones:**
+-

package/modules/obsidian-brain/.project/Templates/Session.md

@@ -0,0 +1,88 @@
+---
+type: session
+date: "<% tp.date.now("YYYY-MM-DD") %>"
+phase: "<% await tp.system.prompt("Fase del proyecto (Foundation/MVP/Alpha/Beta)") %>"
+wave: "<% await tp.system.prompt("Numero de oleada actual") %>"
+---
+
+# Sesion - <% tp.date.now("YYYY-MM-DD") %>
+
+---
+
+## Contexto Inicial
+
+| Campo | Valor |
+|-------|-------|
+| **Fase** | <% await tp.system.prompt("Fase del proyecto") %> |
+| **Oleada** | <% await tp.system.prompt("Oleada actual") %> |
+| **Branch** | <% await tp.system.prompt("Branch activo") %> |
+| **Tiempo Disponible** | <% await tp.system.prompt("Tiempo disponible (ej: 2 horas)") %> |
+
+---
+
+## Objetivos
+
+- [ ] <% await tp.system.prompt("Objetivo principal de la sesion") %>
+- [ ]
+- [ ]
+
+---
+
+## Tareas Trabajadas
+
+### [T-XXX] - [Titulo]
+
+| Campo | Valor |
+|-------|-------|
+| Inicio | <% tp.date.now("HH:mm") %> |
+| Fin | |
+| Estado | En progreso |
+
+**Cambios:**
+-
+
+**Commits:**
+-
+
+---
+
+## Problemas
+
+_(Completar si aparecen problemas)_
+
+---
+
+## Decisiones
+
+_(Completar si se toman decisiones)_
+
+---
+
+## Aprendizajes
+
+-
+
+---
+
+## Proxima Sesion
+
+### Continuar:
+- [ ]
+
+### Preparar:
+- [ ]
+
+---
+
+## Resumen
+
+| Metrica | Valor |
+|---------|-------|
+| Tiempo total | |
+| Tareas completadas | |
+| Commits | |
+| Blockers | |
+
+---
+
+*Fin de sesion: *

package/modules/obsidian-brain/README.md

@@ -0,0 +1,268 @@
+# Obsidian Brain
+
+> Vault de Obsidian integrado al proyecto: Kanban visual, queries Dataview, templates Templater.
+> Todo funciona como markdown plano sin Obsidian instalado.
+
+## Instalacion
+
+### Automatica (recomendado)
+
+```bash
+./scripts/init-project.sh
+# Elegir opcion 1: obsidian-brain
+```
+
+### Manual
+
+```bash
+# 1. Copiar estructura de memoria y config Obsidian
+cp -r optional/obsidian-brain/.project tu-proyecto/
+cp -r optional/obsidian-brain/.obsidian tu-proyecto/
+
+# 2. Copiar scripts de oleadas
+cp optional/obsidian-brain/new-wave.sh tu-proyecto/scripts/
+cp optional/obsidian-brain/new-wave.ps1 tu-proyecto/scripts/
+chmod +x tu-proyecto/scripts/new-wave.sh
+
+# 3. Agregar lineas al .gitignore
+cat optional/obsidian-brain/.obsidian-gitignore-snippet.txt >> tu-proyecto/.gitignore
+```
+
+## Estructura
+
+```
+proyecto/                          <- Vault root
+├── .obsidian/                     <- Config Obsidian (pre-configurada)
+│   ├── app.json                   <- Settings (relative links, ignore filters)
+│   ├── appearance.json            <- Tema, fuente, CSS snippets habilitados
+│   ├── bookmarks.json             <- Acceso rapido a CONTEXT, KANBAN, DASHBOARD
+│   ├── core-plugins.json          <- Core plugins habilitados
+│   ├── core-plugins-migration.json
+│   ├── community-plugins.json     <- Kanban + Dataview + Templater
+│   ├── daily-notes.json           <- Auto-crear sesiones en Sessions/
+│   ├── graph.json                 <- Filtros y colores para graph view
+│   ├── hotkeys.json               <- Ctrl+T = insertar template Templater
+│   ├── snippets/
+│   │   └── project-memory.css     <- Estilos para inline fields y Kanban
+│   └── plugins/
+│       ├── obsidian-kanban/data.json
+│       ├── dataview/data.json
+│       └── templater-obsidian/data.json
+├── .project/
+│   ├── Attachments/               <- Imagenes y archivos adjuntos
+│   ├── Memory/
+│   │   ├── CONTEXT.md             <- Estado actual del proyecto
+│   │   ├── DECISIONS.md           <- ADRs con inline fields Dataview
+│   │   ├── BLOCKERS.md            <- Problemas con inline fields Dataview
+│   │   ├── WAVES.md               <- Historial de oleadas
+│   │   ├── KANBAN.md              <- Board visual (plugin Kanban)
+│   │   ├── DASHBOARD.md           <- Queries automaticas (plugin Dataview)
+│   │   └── README.md
+│   ├── Sessions/
+│   │   └── TEMPLATE.md            <- Template manual para sesiones
+│   └── Templates/
+│       ├── Session.md             <- Template Templater para sesiones
+│       ├── ADR.md                 <- Template Templater para ADRs
+│       └── Blocker.md             <- Template Templater para blockers
+└── scripts/
+    ├── new-wave.sh                <- Gestion de oleadas (bash)
+    └── new-wave.ps1               <- Gestion de oleadas (PowerShell)
+```
+
+## Plugins Requeridos
+
+Los `data.json` estan pre-configurados. Solo necesitas instalar los plugins desde Obsidian:
+
+1. Abrir Obsidian > Settings > Community Plugins > Browse
+2. Instalar: **Kanban**, **Dataview**, **Templater**
+3. Habilitar los 3 plugins
+
+La configuracion se aplica automaticamente desde los `data.json` ya incluidos.
+
+### Pre-configurado
+
+- **Ctrl+T** - Insertar template Templater (sesion, ADR, blocker)
+- **Daily Notes** - Al hacer click en "Open today's daily note", crea sesion en `.project/Sessions/` usando el template de Templater
+- **Bookmarks** - CONTEXT, KANBAN, DASHBOARD, DECISIONS, BLOCKERS en acceso rapido
+- **Graph View** - Memory files en azul, Sessions en violeta, build artifacts filtrados
+- **CSS Snippet** - `project-memory.css` activo: resalta inline fields y status badges
+- **Core templates desactivado** - Se usa Templater en su lugar (mas potente, sin conflicto)
+
+### Seguridad
+
+- **Templater:** `enable_system_commands: false` (no ejecuta comandos del sistema)
+- **Dataview:** `enableDataviewJs: false` (no ejecuta JavaScript arbitrario)
+
+## Workflow
+
+### Con Obsidian
+
+1. Abrir proyecto como vault
+2. Usar KANBAN.md como board visual (drag & drop entre lanes)
+3. Crear sesiones con Templater (Ctrl+T > Session)
+4. Ver DASHBOARD.md para metricas automaticas
+5. Las oleadas se gestionan con `new-wave.sh` y se reflejan en WAVES.md
+
+### Sin Obsidian (markdown plano)
+
+1. Editar KANBAN.md moviendo lineas entre secciones H2
+2. Copiar TEMPLATE.md para crear sesiones manualmente
+3. DASHBOARD.md muestra bloques de codigo sin ejecutar
+4. Todo el workflow funciona igual, solo sin la parte visual
+
+## KANBAN.md
+
+El board tiene 4 lanes:
+
+```markdown
+## Backlog
+- [ ] Tarea por hacer #wave
+
+## En Progreso
+- [ ] Tarea activa
+
+## Review
+- [ ] Tarea en revision
+
+## Completado
+- [x] Tarea terminada
+```
+
+### Mover tareas
+- **Con Obsidian:** drag & drop entre lanes
+- **Sin Obsidian:** cortar/pegar la linea `- [ ]` a la seccion correspondiente
+- **Con AI CLI:** mover la linea entre secciones H2
+
+### Tags utiles
+- `#wave` - Pertenece a oleada activa
+- `#blocker` - Tiene un blocker asociado
+- `#review` - Necesita revision
+
+## Oleadas (Waves)
+
+KANBAN.md es para el dia a dia. WAVES.md es el historial de oleadas:
+
+```bash
+# Ver oleada actual
+./scripts/new-wave.sh --list
+
+# Crear oleada
+./scripts/new-wave.sh "T-001 T-002 T-003"
+
+# Completar oleada
+./scripts/new-wave.sh --complete
+```
+
+## Inline Fields vs Frontmatter
+
+Obsidian Brain usa dos formatos de metadata segun el tipo de archivo:
+
+- **Inline fields** (`key:: value`) - Para ADRs y Blockers dentro de DECISIONS.md y BLOCKERS.md.
+  Se usan porque multiples entradas conviven en el mismo archivo. Dataview los detecta como campos
+  de la seccion H2/H3 donde aparecen.
+
+- **YAML frontmatter** (`key: value` en bloque `---`) - Para archivos individuales como sesiones
+  (un archivo por dia). Obsidian los muestra en el panel de propiedades.
+
+No mezclar: usar inline fields dentro de secciones, frontmatter al inicio de archivos individuales.
+
+## Inline Fields (Dataview)
+
+Los archivos usan inline fields para queries automaticas. Formato: `key:: value`
+
+### Campos obligatorios por tipo
+
+| Tipo de entrada | Campos requeridos | Valores validos |
+|-----------------|-------------------|-----------------|
+| ADR | `type:: adr`, `status::`, `date::` | status: `pendiente`, `aceptada`, `rechazada`, `deprecada` |
+| Blocker | `type:: blocker`, `status::`, `impact::`, `date::` | status: `open`, `investigating`, `resolved`, `workaround`. impact: `alto`, `medio`, `bajo` |
+| Session | frontmatter `type: session`, `date`, `phase`, `wave` | phase: `Foundation`, `MVP`, `Alpha`, `Beta` |
+
+### Ejemplo real (ADR)
+
+```markdown
+## ADR-002: Usar PostgreSQL en vez de SQLite
+
+type:: adr
+status:: aceptada
+date:: 2026-01-15
+
+### Contexto
+Necesitamos soporte para queries concurrentes y full-text search.
+
+### Decision
+Usar PostgreSQL 16 con pgx driver.
+```
+
+### Ejemplo real (Blocker)
+
+```markdown
+### BLOCKER-002: Docker build falla en CI
+
+type:: blocker
+status:: open
+impact:: alto
+date:: 2026-01-20
+
+**Descripcion:**
+El build de Docker falla con error de memoria en GitHub Actions.
+```
+
+Estos campos permiten a Dataview generar tablas automaticas en DASHBOARD.md. Sin los campos, las queries devuelven resultados vacios.
+
+## Git
+
+### Se commitea
+- `.obsidian/app.json` - Settings compartidos
+- `.obsidian/appearance.json` - Tema y CSS snippets
+- `.obsidian/bookmarks.json` - Bookmarks compartidos
+- `.obsidian/core-plugins.json` - Core plugins
+- `.obsidian/core-plugins-migration.json` - Migration flags
+- `.obsidian/community-plugins.json` - Lista de plugins
+- `.obsidian/daily-notes.json` - Config de daily notes
+- `.obsidian/graph.json` - Config del graph view
+- `.obsidian/hotkeys.json` - Atajos de teclado
+- `.obsidian/snippets/*.css` - CSS snippets del proyecto
+- `.obsidian/plugins/*/data.json` - Configuracion de plugins
+
+### Se ignora (.gitignore)
+- `.obsidian/workspace.json` - Layout personal
+- `.obsidian/workspace/` - Workspace data
+- `.obsidian/cache/` - Cache
+- `.obsidian/plugins/*/main.js` - Binarios de plugins
+- `.obsidian/plugins/*/styles.css` - Estilos de plugins
+- `.obsidian/plugins/*/manifest.json` - Manifiestos de plugins
+- `.trash/` - Papelera de Obsidian
+
+## Verificacion Post-Instalacion
+
+Despues de instalar, verificar que existan:
+
+```bash
+# Archivos de memoria
+ls .project/Memory/CONTEXT.md .project/Memory/KANBAN.md .project/Memory/DASHBOARD.md
+
+# Config Obsidian
+ls .obsidian/app.json .obsidian/community-plugins.json
+
+# Plugins pre-configurados
+ls .obsidian/plugins/obsidian-kanban/data.json
+ls .obsidian/plugins/dataview/data.json
+ls .obsidian/plugins/templater-obsidian/data.json
+
+# Scripts
+ls scripts/new-wave.sh scripts/new-wave.ps1
+
+# Gitignore (debe contener lineas de Obsidian)
+grep "obsidian" .gitignore
+```
+
+## Migracion desde VibeKanban
+
+Si ya usas vibekanban:
+
+1. Copiar `.obsidian/` al proyecto
+2. Crear `KANBAN.md` y `DASHBOARD.md` en `.project/Memory/`
+3. Agregar frontmatter YAML a archivos existentes (CONTEXT, DECISIONS, etc.)
+4. Agregar inline fields Dataview a ADRs y blockers existentes
+5. Actualizar `.gitignore` con el snippet de Obsidian