chore: sync from fn-registry agent

README.md

@@ -0,0 +1,75 @@
+# dev_console
+
+CLI unificado para listar, inspeccionar y gestionar issues y flows del registry.
+
+## Build
+
+```bash
+cd apps/dev_console
+CGO_ENABLED=0 go build -o dev_console .
+```
+
+## Uso
+
+```bash
+# Listar issues con filtros
+./dev_console issue list
+./dev_console issue list --status pendiente
+./dev_console issue list --domain trading --prio alta
+./dev_console issue list --type epic
+
+# Ver un issue concreto
+./dev_console issue show 0099
+./dev_console issue status 0099
+
+# Board Kanban en terminal
+./dev_console issue board
+
+# Flows
+./dev_console flow list
+./dev_console flow list --risk high
+./dev_console flow show 0001
+./dev_console flow status 0001
+
+# Work: que hacer hoy
+./dev_console work today
+./dev_console work dashboard    # JSON para dashboards
+
+# Salida JSON (todos los subcomandos)
+./dev_console issue list --json | jq '.[] | .id'
+```
+
+## Entorno
+
+`FN_REGISTRY_ROOT` — directorio raiz del registry. Si no se setea, se
+auto-detecta subiendo desde el cwd hasta encontrar `registry.db`.
+
+## Auto-deteccion de raiz
+
+El binario puede lanzarse desde cualquier directorio dentro del registry:
+
+```bash
+# Desde la raiz
+./apps/dev_console/dev_console issue list
+
+# Con env var explicita
+FN_REGISTRY_ROOT=/home/lucas/fn_registry ./dev_console issue list
+```
+
+## Subcomandos v2 (stub)
+
+Los siguientes subcomandos imprimen "TODO v2" y salen con exit code 2:
+
+- `issue dep|roadmap|tag|done|stale|create`
+- `flow create|dod|trace|user-test|run|chain|done`
+- `work weekly|search`
+
+## Source
+
+- `main.go` — entrypoint + dispatch + flag parsing
+- `parser.go` — ParseIssue / ParseFlow / LoadAllIssues / LoadAllFlows
+- `issue.go` — subcomandos de issue
+- `flow.go` — subcomandos de flow
+- `work.go` — subcomandos de work
+- `format.go` — tabwriter helpers + JSON renderer
+- `parser_test.go` — unit tests con fixtures en testdata/