navori 0.2.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ulises Ciprés
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -25,8 +25,8 @@ navori init
 
 El `init` detecta automáticamente del repo:
 - **Nombre** del proyecto (de `package.json`, `pyproject.toml`, `Cargo.toml`, git remote o basename)
-- **Stack**: framework (Next.js, Vite, NestJS, Expo, etc.), UI, forms, state, test
-- **Preset sugerido** basado en el stack (ej. `vite-react-ts-mantine`, `nextjs-apollo`, `bun-keystone`)
+- **Stack**: framework (Next.js, Vite, NestJS, Express, Astro, etc.), UI, forms, state, test
+- **Preset sugerido** según el stack (ej. `vite-react-ts-mantine`, `nextjs`, `express-mongoose`)
 - **Quality gate** compuesto de los scripts del `package.json`
 - **Branch base** del git (`origin/HEAD`, fallback main/master/develop)
 - **Infraestructura Claude existente** (`.claude/`, `CLAUDE.md`, `AGENTS.md`, agents, skills) — ofrece coexistir o reemplazar con backup
@@ -34,20 +34,55 @@ El `init` detecta automáticamente del repo:
 Y genera:
 - `navori.config.json` — fuente de verdad del repo
 - `CLAUDE.md` con managed blocks que el CLI mantiene sincronizados
+- `.claude/` con agentes, skills, hooks y settings
 
 ## Comandos
 
 | Comando | Qué hace |
 |---|---|
-| `init` | Bootstrap del repo con detección automática + wizard |
-| `add <plugin>` | Activa un plugin + opcionalmente instala la tool externa |
+| `init` | Bootstrap del repo con detección automática + wizard (o `--recommended` sin preguntas) |
+| `add <plugin>` | Activa un plugin y opcionalmente instala la tool externa |
 | `configure <section>` | Ajusta una sección del config sin re-correr el wizard |
 | `update` | Re-detecta el repo, refresca config y corre sync en un paso |
-| `render` | Genera CLAUDE.md con los managed blocks |
-| `sync` | Refresca managed blocks con conflict resolution + backups |
-| `doctor` | Inspecciona config + reporta procedencia de cada managed block |
-| `workspace <sub>` | Gestiona workspaces cross-repo (init, ls, show, add-repo) |
-| `ticket <sub>` | Gestiona tickets-as-files en un workspace (new, list, show) |
+| `render` | Genera CLAUDE.md y `.claude/` desde el config (preview por default; `--apply` escribe) |
+| `sync` | Refresca los managed blocks con conflict resolution + backups |
+| `preset init <id>` | Scaffoldea un preset local en `.navori/presets/<id>/` |
+| `scan` | Detecta workspaces nuevos en monorepos (`pnpm-workspace.yaml` / `package.json#workspaces`) |
+| `doctor` | Audita el config + reporta procedencia y drift de cada managed block (`--strict` para CI) |
+| `status` | Snapshot rápido: config, plugins activos, conteo de drift y próximos pasos |
+| `bench` | Corre `render` en dry-run N veces y reporta latencias (detecta regresiones locales) |
+| `workspace <sub>` | Gestiona workspaces cross-repo (`init`, `ls`, `show`, `rm`) |
+| `ticket <sub>` | Gestiona tickets-as-files en un workspace (`new`, `list`, `show`, `archive`, `delete`) |
+| `backup <sub>` | Lista y restaura backups de `~/.navori/backups/` |
+| `migrations <sub>` | Lista y restaura migraciones de `~/.navori/migrations/` |
+
+## Presets
+
+Un preset aporta skills y reglas específicas del stack además del core. El `init` te sugiere uno según lo que detecta.
+
+**Presets oficiales (incluidos):**
+
+| Preset | Stack |
+|---|---|
+| `vite-react-ts-mantine` | Vite + React + TS + Mantine (SPA) |
+| `nextjs` | Next.js (App Router) |
+| `nestjs` | NestJS (backend) |
+| `express-mongoose` | Express + Mongoose (backend) |
+| `astro` | Astro (static / SSR) |
+| `medusa` | Medusa.js v2 (backend) |
+
+**¿Tu stack no tiene preset oficial?** No pasa nada. El `init` instala el harness completo (agentes, gates, protocolo, SDD) y funciona desde ya — solo te quedas sin los skills específicos del stack. El init te avisa, te deja en el baseline (`preset: custom`) y te sugiere cubrir el gap con un preset local.
+
+**Presets locales** — crea uno checked-in al repo bajo `.navori/presets/<id>/`:
+
+```bash
+navori preset init sveltekit
+# ✓ .navori/presets/sveltekit/  (manifest + managed/stack.md + skills/)
+# ✓ navori.config.json → preset: sveltekit
+# → edita las plantillas y corre 'navori render --apply'
+```
+
+La resolución es **local → bundled**: si tienes un preset local con el mismo id que uno oficial, gana el local. Así puedes override un preset incluido sin tocar el paquete.
 
 ## Plugins disponibles
 
@@ -66,6 +101,15 @@ navori add engram          # te ofrece instalar la tool externa si falta
 navori add engram --skip-install   # solo registra el plugin
 ```
 
+## Harness defensivo (read-only por default)
+
+El harness que genera `navori` trae permisos seguros desde el arranque, para que tengas menos prompts en lo cotidiano sin bajar la guardia en lo peligroso:
+
+- **Las lecturas no piden confirmación**: `git status/diff/log/show`, `ls`, `cat`, `grep`, `Read`/`Glob`/`Grep`, etc. corren sin interrumpirte.
+- **Lo destructivo pide confirmación** (`ask`): `rm -rf`, `git push --force`, `git reset --hard`, `git clean -f`, `chmod -R`, …
+- **Lo catastrófico se rechaza** (`deny`): `rm -rf /`, `sudo rm`, `mkfs`, …
+- Un hook `guard-destructive` actúa como backstop adicional.
+
 ## Workspace + tickets cross-repo
 
 Si un ticket toca varios repos (frontend + backend + microservicio), el workspace te da un punto único:
@@ -81,7 +125,7 @@ navori workspace add-repo bonum --name backend --path ~/dev/bonum/nexus --stack
 # Crear ticket
 navori ticket new bonum BNM-123 --title "Checkout flow rebuild"
 
-# En cada repo que tocás el ticket, agregá una referencia:
+# En cada repo que toca el ticket, agrega una referencia:
 # echo "ticket: BNM-123" >> progress/current.md
 
 # Ver el ticket + en qué repos aparece
@@ -105,17 +149,17 @@ contenido sincronizado
 <!-- /navori:managed id="idioma-rol" -->
 ```
 
-- **`hash`**: detecta si vos editaste el bloque (sync te avisa antes de pisar)
+- **`hash`**: detecta si editaste el bloque (sync te avisa antes de pisarlo)
 - **`version`**: cuando se publica una nueva versión de `@navori/core` o un plugin, `sync` reporta "update available"
 - **`source`**: qué paquete es dueño del bloque (`doctor` te muestra la procedencia de cada uno)
 
-Si modificás un managed block a mano y después corrés `sync`, vas a ver:
+Si modificas un managed block a mano y después corres `sync`, vas a ver:
 ```
 Conflict in 'idioma-rol':
   - tu versión
   + versión del Core
 ```
-Y elegís: `skip-conflicts` (mantener tu edit), `apply-all` (pisar) o `abort`.
+Y eliges: `skip-conflicts` (mantener tu edit), `apply-all` (pisar) o `abort`.
 
 Backups automáticos en `~/.navori/backups/<timestamp>/` antes de cada `sync` (retención 30 días).
 
@@ -128,17 +172,19 @@ navori configure plugins              # multiselect de plugins activos
 navori configure quality-gate         # nuevo comando de quality gate
 navori configure language en          # switch a inglés (fallback a es)
 navori configure engines              # multiselect: claude / agents-md / cursor / copilot
+navori configure branch-base develop  # fijar la branch base
 navori configure workspace bonum      # asociar a un workspace
 ```
 
 ## Filosofía
 
-- **Cero opinión sobre tu proceso**. El CLI detecta y propone; vos decidís.
-- **Coexiste con harness existente**. Modo `coexist` no toca nada que ya tenías.
+- **Cero opinión sobre tu proceso**. El CLI detecta y propone; tú decides.
+- **Coexiste con harness existente**. El modo `coexist` no toca nada que ya tenías.
 - **Nunca pisa silenciosamente**. Hash en el marker + backups antes de cada write.
+- **Read-only por default**. Las lecturas no piden permiso; lo destructivo sí.
 - **Output legible siempre**. Texto + `--json` para piping en CI.
-- **Bilingüe ready**. Schema soporta `language: es | en`. Hoy solo `es` está full; `en` cae en fallback honesto.
+- **Bilingüe ready**. El schema soporta `language: es | en`. Hoy `es` está full; `en` cae en fallback honesto.
 
 ## Licencia
 
-ISC.
+MIT.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "navori",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Multi-agent harness + SDD scaffolder for Claude Code and other AI engines",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "coreAgents": 7,
     "coreSkills": 3
   },
-  "license": "ISC",
+  "license": "MIT",
   "scripts": {
     "build": "tsup && node scripts/copy-assets.mjs",
     "dev": "tsup --watch",