ndomo 0.1.0 → 0.2.1

package/.env.example

@@ -17,3 +17,7 @@ OPENCODE_SERVER_PASSWORD=
 
 # OpenCode server URL for SDK client (default: http://localhost:4096)
 OPENCODE_SERVER_URL=http://localhost:4096
+
+# Web UI build-time API base (default: empty = same-origin). Set when SPA and API
+# are on different origins (e.g., VITE_API_BASE=https://api.example.com during dev).
+# VITE_API_BASE=

package/README.es.md

@@ -36,25 +36,25 @@ ndomo es un plugin de orquestación multi-agente para [OpenCode](https://github.
 ## Inicio Rápido
 
 ```bash
-# Instalación rápida (interactivo, preguntará por provider)
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash
+# Instalación rápida (interactivo, preguntará por HTTP)
+bunx ndomo install
 
-# No interactivo con provider preestablecido
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s -- --provider=opencode --no-provider-prompt
+# No interactivo con preset + HTTP habilitado
+bunx ndomo install --preset=budget --enable-http
 
-# Con preset budget + DCP
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s -- --preset=budget --with-dcp
+# Con DCP
+bunx ndomo install --with-dcp
 ```
 
-Por defecto la instalación aplica `presets.default` de `config/ndomo.config.json`. Usa `--preset=budget` para modelos más económicos, `--provider=ID` para sobrescribir el prefijo de provider.
+Por defecto la instalación aplica `presets.default` de `config/ndomo.config.json`. Usa `--preset=budget` para modelos más económicos, `--provider=ID` para sobrescribir el prefijo de provider, `--enable-http` para activar el servidor HTTP.
 
 O desde el código fuente:
 
 ```bash
-git clone <repo-url> ndomo
+git clone https://github.com/nicosup98/ndomo-v2 ndomo
 cd ndomo
 bun install
-opencode
+bun run src/cli/install.ts
 ```
 
 Dentro de OpenCode, verifica que todos los agentes respondan:
@@ -67,30 +67,31 @@ ping all agents
 
 **Requisitos:** [bun](https://bun.sh) >= 1.1.0, OpenCode instalado y configurado con al menos un proveedor autenticado.
 
-Instalación vía curl (recomendada):
+Instalación vía bunx (recomendada):
 
 ```bash
-# Instalación interactiva (preguntará por provider)
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash
+# Instalación interactiva (preguntará por HTTP)
+bunx ndomo install
 
 # Con provider preestablecido (no interactivo)
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s -- --provider=opencode --no-provider-prompt
+bunx ndomo install --provider=opencode --no-provider-prompt
 
 # Con preset budget + DCP
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s -- --preset=budget --with-dcp
+bunx ndomo install --preset=budget --with-dcp
 ```
 
 O desde un clon local:
 
 ```bash
-git clone <repo-url> ndomo
+git clone https://github.com/nicosup98/ndomo-v2 ndomo
 cd ndomo
-./scripts/install.sh                 # con preset default
-./scripts/install.sh --preset=budget # con modelos budget
-./scripts/install.sh --with-dcp      # incluye plugin DCP
+bun install
+bun run src/cli/install.ts                        # con preset default
+bun run src/cli/install.ts --preset=budget        # con modelos budget
+bun run src/cli/install.ts --with-dcp             # incluye plugin DCP
 ```
 
-Ver [docs/installation.md](docs/installation.md) para pasos detallados.
+Ver [docs/installer.md](docs/installer.md) para pasos detallados.
 
 **Flags:**
 
@@ -100,10 +101,15 @@ Ver [docs/installation.md](docs/installation.md) para pasos detallados.
 | `--no-provider-prompt` | Omite el prompt interactivo de provider. El preset se aplica igualmente; no se realiza ninguna sobrescritura de prefijo de provider. |
 | `--preset=NAME` | Selecciona un preset de `config/ndomo.config.json::presets[NAME]`. El preset es la fuente de verdad para los modelos de agentes al instalar. (default: `default`, opciones: `default`, `budget`) |
 | `--with-dcp` | Instala y configura el plugin DCP. |
-| `--repo=URL` | Sobrescribe la URL del repositorio (para instalaciones vía pipe desde un fork). |
-| `--branch=NAME` | Sobrescribe la rama del repositorio (para instalaciones vía pipe desde ramas dev). |
-
-**Desinstalación:** `./scripts/uninstall.sh [--keep-data]`
+| `--dry-run` | Imprime los cambios planeados sin escribir archivos. |
+| `--skip-deps` | Omite el paso de dependencias (`bun install`). |
+| `--enable-http` | Activa automáticamente el servidor HTTP (escribe bloque http en `ndomo.config.json`). |
+| `--disable-http` | Omite por completo el prompt automático de HTTP (default en no-TTY / CI). |
+| `--port=N` | Puerto del servidor HTTP (default: `4097`). |
+| `--cors-origins=CSV` | Orígenes CORS del HTTP, separados por comas (default: `*`). |
+| `--auth-required=BOOL` | Requisito de auth HTTP (default: `true`). |
+
+**Desinstalación:** `bunx ndomo install --uninstall` or `./scripts/uninstall.sh [--keep-data]`
 
 ## Base de Datos de Planes y Tareas
 

package/README.md

@@ -36,25 +36,25 @@ ndomo is a multi-agent orchestration plugin for [OpenCode](https://github.com/op
 ## Quick Start
 
 ```bash
-# Quick install (interactive, will prompt for provider)
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash
+# Quick install (interactive, will prompt for HTTP)
+bunx ndomo install
 
-# Non-interactive with provider preset
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s -- --provider=opencode --no-provider-prompt
+# Non-interactive with preset + HTTP enabled
+bunx ndomo install --preset=budget --enable-http
 
-# With budget preset + DCP
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s -- --preset=budget --with-dcp
+# With DCP
+bunx ndomo install --with-dcp
 ```
 
-By default the install applies `presets.default` from `config/ndomo.config.json`. Use `--preset=budget` for cheaper models, `--provider=ID` to override the provider prefix.
+By default the install applies `presets.default` from `config/ndomo.config.json`. Use `--preset=budget` for cheaper models, `--provider=ID` to override the provider prefix. See [docs/installer.md](docs/installer.md) for the full flag reference.
 
 Or from source:
 
 ```bash
-git clone <repo-url> ndomo
+git clone https://github.com/nicosup98/ndomo-v2 ndomo
 cd ndomo
 bun install
-opencode
+bun run src/cli/install.ts
 ```
 
 Inside OpenCode, verify all agents respond:
@@ -67,43 +67,51 @@ ping all agents
 
 **Prerequisites:** [bun](https://bun.sh) >= 1.1.0, OpenCode installed and configured with at least one authenticated provider.
 
-Install via curl (recommended):
+Install via bunx (recommended):
 
 ```bash
-# Interactive install (will prompt for provider)
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash
+# Interactive install (will prompt for HTTP)
+bunx ndomo install
 
 # With provider preset (non-interactive)
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s -- --provider=opencode --no-provider-prompt
+bunx ndomo install --provider=opencode --no-provider-prompt
 
 # With budget preset + DCP
-curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s -- --preset=budget --with-dcp
+bunx ndomo install --preset=budget --with-dcp
 ```
 
 Or from a local clone:
 
 ```bash
-git clone <repo-url> ndomo
+git clone https://github.com/nicosup98/ndomo-v2 ndomo
 cd ndomo
-./scripts/install.sh                 # with default preset
-./scripts/install.sh --preset=budget # with budget models
-./scripts/install.sh --with-dcp      # include DCP plugin
+bun install
+bun run src/cli/install.ts                     # default preset
+bun run src/cli/install.ts --preset=budget     # budget models
+bun run src/cli/install.ts --with-dcp          # include DCP plugin
 ```
 
-See [docs/installation.md](docs/installation.md) for detailed steps.
+See [docs/installer.md](docs/installer.md) for detailed steps and full flag reference.
+
+> **Migration note:** `scripts/install.sh` is preserved in the published tarball as a **compat shim for users coming from `curl -fsSL ... | bash`** (the pre-0.2.0 install path). It is deprecated — new installs should use `bunx ndomo install`. The shim is not removed to avoid breaking legacy one-liners, but no new features will be added there.
 
 **Flags:**
 
 | Flag | Description |
 |---|---|
-| `--provider=ID` | Override the provider prefix for all agents. The model ID is taken from the active preset; only the `provider/` segment of the `model:` field is swapped. Example: preset gives `opencode-go/minimax-m2.7`, `--provider=opencode` rewrites to `opencode/minimax-m2.7`. |
+| `--provider=ID` | Override the provider prefix for all agents. The model ID is taken from the active preset; only the `provider/` segment of the `model:` field is swapped. |
 | `--no-provider-prompt` | Skip the interactive provider prompt. The preset is still applied; no provider prefix override is performed. |
-| `--preset=NAME` | Select preset from `config/ndomo.config.json::presets[NAME]`. The preset is the source of truth for agent models at install time. (default: `default`, options: `default`, `budget`) |
+| `--preset=NAME` | Select preset from `config/ndomo.config.json::presets[NAME]`. (default: `default`, options: `default`, `budget`) |
 | `--with-dcp` | Install and configure the DCP plugin. |
-| `--repo=URL` | Override repository URL (for piped installs from a fork). |
-| `--branch=NAME` | Override repository branch (for piped installs from dev branches). |
+| `--dry-run` | Print planned changes without writing files. |
+| `--skip-deps` | Skip the `bun install` dependency step. |
+| `--enable-http` | Auto-enable HTTP server (writes http block to `ndomo.config.json`). |
+| `--disable-http` | Skip the HTTP auto-prompt entirely (default in non-TTY / CI). |
+| `--port=N` | HTTP server port (default: `4097`). |
+| `--cors-origins=CSV` | HTTP CORS origins, comma-separated (default: `*`). |
+| `--auth-required=BOOL` | HTTP auth requirement (default: `true`). |
 
-**Uninstall:** `./scripts/uninstall.sh [--keep-data]`
+**Uninstall:** `bunx ndomo install --uninstall` or `./scripts/uninstall.sh [--keep-data]`
 
 ## Plans & Tasks DB
 
@@ -158,10 +166,42 @@ ndomo bundles 7 skills under `skills/`:
 
 See [docs/integrations.md](docs/integrations.md) for details.
 
+## Web UI
+
+The HTTP server includes a read-only Vue 3 SPA for browsing plans, tasks, and sessions in the browser. Single-port topology — the same Elysia process serves both the API (`/api/*`) and the SPA (everything else, with hash-mode fallback).
+
+See [docs/web-ui.md](docs/web-ui.md) for architecture, build pipeline, and extension guide.
+
+Quick start:
+
+```bash
+bun run web:build                                # build SPA -> src/http/web/
+NDOMO_HTTP_ENABLED=true OPENCODE_SERVER_PASSWORD=secret bun run src/cli/serve.ts
+# Open http://localhost:4097/
+```
+
+Vite dev mode (HMR):
+
+```bash
+# Terminal 1: server
+NDOMO_HTTP_ENABLED=true OPENCODE_SERVER_PASSWORD=secret bun run src/cli/serve.ts
+# Terminal 2: SPA dev
+bun run web:dev
+# Open http://localhost:5173/
+```
+
 ## Optional HTTP server
 
 Expose ndomo's SQLite state and OpenCode SDK event stream over HTTP+SSE via an embedded Elysia server. Phase 1 ships read-only REST endpoints (`/api/plans`, `/api/tasks`, `/api/sessions`) and a live SSE relay (`/api/events`).
 
+**Recommended: use the installer flag to enable HTTP:**
+
+```bash
+bunx ndomo install --enable-http
+```
+
+Or set env vars manually and start the server:
+
 ```bash
 export NDOMO_HTTP_ENABLED=true
 export OPENCODE_SERVER_PASSWORD='pick-a-strong-passphrase'