@danieltmn/tamnora 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+Todos los cambios relevantes de este proyecto se documentan en este archivo.
+
+El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/)
+y el proyecto usa [Versionado Semantico](https://semver.org/lang/es/).
+
+## [0.1.0] - 2026-10-01
+
+### Agregado
+
+- Casa global de Tamnora (`TAMNORA_HOME` / datos del sistema) con `app.json`,
+  base SQLite global, logs y runtime.
+- `tamnora server --init|--start|--reload|--stop|--status|--logs`: daemon en
+  segundo plano que sobrevive al cierre de la consola.
+- Login real (cookie firmada + CSRF + lockout) y `tamnora user` (scrypt).
+- `tamnora bridge --start|--reload|--stop|--status`: tunel publico (tunnelmole)
+  con QR para abrir la URL desde el celular.
+- `tamnora doctor`, `tamnora update` y `tamnora autostart install|remove`.
+- `scripts/release.mjs`: release con guard de credenciales, changelog, tag, push
+  y `npm publish` (con `--dry-run`).
+- Reintentos con backoff ante errores transitorios (429/5xx/red) y cancelacion
+  real entre rondas/tools en el loop del agente (evento `retry`).
+- Gestion de contexto: recorte de tool-results viejos y descarte de turnos
+  antiguos cuando la sesion se acerca al limite del modelo (evento `trim`).
+- Consola responsive: en movil la barra lateral es un drawer con backdrop, el
+  topbar envuelve y la conversacion usa todo el ancho.
+- Tools de Git (`git_status`, `git_diff`, `git_log`, `git_commit`) y diff
+  coloreado en la consola para los cambios de `write`/`edit`.
+- Acciones por mensaje en la consola: copiar, editar, regenerar y borrar desde
+  ese punto (`POST /api/sessions/:id/truncate`).
+- Ajustes del agente (modo, proveedor, modelo y auto) en un modal; el topbar
+  queda con solo los botones de panel y tema.
+- Busqueda global (sesiones y mensajes, `GET /api/search`) y command palette
+  (`Ctrl/Cmd+K`) con comandos rapidos.
+- MCP completo: recursos y prompts (tools sinteticas `list_/read_resource`,
+  `list_/get_prompt`), reconexion de stdio y refresco por `tools/list_changed`.
+- TUI: edicion con cursor (flechas/home/end/delete), scroll (pgup/pgdn),
+  bracketed paste, contador de contexto, `--mode plan` y restauracion de la
+  terminal ante salida/senal.
+- CI multi-plataforma y analisis de la consola web del harness.
+
+### Cambiado
+
+- El chat SPA se separo a su propio repositorio (`tamnora-chat`).
+- La raiz del repo pasa a ser el paquete publicable `@danieltmn/tamnora`.
+- Puerto default `4517`; la base SQLite es global (migra la legacy por proyecto).
+- La landing pasa de login cosmetico a autenticacion real.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tamnora
+
+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

@@ -0,0 +1,130 @@
+# Tamnora Harness
+
+Harness local para IAs: un agente **CLI-first** (estilo opencode) en Node puro,
+con TUI, consola web, tools locales, MCP y evaluacion de modelos.
+
+- **Sin dependencias**: solo modulos de Node (`node:sqlite`, `node:crypto`, ...).
+- **Local**: corre en tu maquina y guarda el estado en tu casa local.
+- **Multi-proveedor**: OpenRouter, OpenAI-compatible (DeepSeek, Groq, Mistral,
+  xAI, Together, Fireworks, Cerebras, Perplexity) y Ollama.
+
+## Instalacion
+
+```bash
+npx @danieltmn/tamnora --help
+# o global
+npm i -g @danieltmn/tamnora
+```
+
+Requiere **Node.js >= 22.5** (por `node:sqlite`).
+
+## Uso rapido
+
+```bash
+tamnora init                  # crea la configuracion (proveedor, modelo)
+tamnora                       # consola TUI full-screen (REPL si no hay TTY)
+tamnora run "hola"            # tarea headless
+tamnora eval <dataset.jsonl>  # evaluacion de modelos
+tamnora mcp [--json]          # servidores MCP: tools, recursos y prompts
+tamnora serve                 # consola web
+```
+
+### Consola TUI
+
+```bash
+tamnora                   # TUI full-screen (REPL si no hay TTY)
+tamnora tui --mode plan   # modo plan: solo lectura, sin escritura ni bash
+```
+
+Atajos: `enter` enviar · `↑/↓` historial · `←/→` cursor · `home/end` inicio/fin ·
+`pgup/pgdn` scroll · `ctrl+l` limpiar · `ctrl+c` cancelar/salir · `/salir`,
+`/limpiar`. El pegado de bloques multilinea entra como un solo texto y el header
+muestra el contexto usado (`ctx <tokens>`).
+
+### Server como servicio
+
+```bash
+tamnora server --init         # crea la casa y arranca (segundo plano)
+tamnora server --start        # arranca (default)
+tamnora server --reload       # reinicia aplicando config/codigo
+tamnora server --stop
+tamnora server --status
+tamnora server --logs --follow
+tamnora doctor                # verifica Node, casa, puerto y base
+tamnora update                # busca/instala una version nueva
+tamnora autostart install     # arranque automatico del server
+```
+
+`tamnora server` corre en segundo plano y **sobrevive al cierre de la consola**
+(puerto default `4517`). La configuracion de la app vive en la **casa** de
+Tamnora (override con `--home` o `TAMNORA_HOME`):
+
+- Windows: `%APPDATA%\tamnora`
+- macOS: `~/Library/Application Support/tamnora`
+- Linux: `~/.config/tamnora`
+
+### Login
+
+```bash
+tamnora user --name <n> --password <p>   # crea/cambia el usuario local
+tamnora user                            # muestra el usuario
+tamnora user remove                     # el server deja de pedir login
+```
+
+Con un usuario configurado, **todas** las rutas `/api/*` piden sesion (cookie
+firmada + CSRF) y la landing pasa a ser el login real; sin usuario, el server
+corre en modo local sin login. Al cambiar el usuario se detiene el server
+(volvelo a arrancar con `tamnora server --start`).
+
+### Acceso remoto
+
+```bash
+tamnora bridge --start        # abre un tunel publico (tunnelmole) + QR
+tamnora bridge --status       # URL publica
+tamnora bridge --reload       # reinicia el tunel
+tamnora bridge --stop
+```
+
+`tamnora bridge` abre un tunel (tunnelmole) hacia tu server local y muestra la
+URL publica **y un QR** para abrirlo desde el celular. Trabaja protegido por el
+login del server: configura un usuario antes de exponerlo (ver
+[`SECURITY.md`](SECURITY.md)).
+
+## MCP
+
+Los servidores MCP se configuran en `tamnora.json` (`mcp[]`) y soportan HTTP y
+stdio. Las tools se exponen como `mcp__<servidor>__<tool>` y, si el servidor los
+anuncia, tambien sus **recursos** y **prompts** (`list_resources`,
+`read_resource`, `list_prompts`, `get_prompt`).
+
+## Documentacion
+
+- [`CHANGELOG.md`](CHANGELOG.md) — historial de versiones.
+- [`AGENTS.md`](AGENTS.md) — arquitectura del harness, tools, MCP, evaluacion y
+  convenciones.
+- [`harness/tamnora.example.json`](harness/tamnora.example.json) — plantilla de
+  configuracion.
+- [`SECURITY.md`](SECURITY.md) — modelo de amenaza y reporte de vulnerabilidades.
+
+> El chat SPA (Tamnora Chat) vive en su propio repositorio: `tamnora-chat`.
+
+## Versiones
+
+El proyecto sigue [Versionado Semantico](https://semver.org/lang/es/). Cada
+version se documenta en [`CHANGELOG.md`](CHANGELOG.md) y se publica como un tag
+`vX.Y.Z` en git mas `npm publish`.
+
+## Desarrollo
+
+```bash
+pnpm install
+pnpm tamnora        # TUI / REPL
+pnpm serve          # consola web
+pnpm mock           # proveedor local de prueba (OpenAI-compatible + Ollama)
+pnpm test           # tests (node:test)
+pnpm lint           # ESLint
+```
+
+## Licencia
+
+MIT.

package/SECURITY.md

@@ -0,0 +1,31 @@
+# Seguridad
+
+## Reportar una vulnerabilidad
+
+No abras un issue publico para vulnerabilidades. Escribi a **security@tamnora.com**
+con: descripcion, pasos para reproducir, impacto y version afectada. Respondemos
+dentro de 72 horas.
+
+## Modelo de amenaza
+
+Tamnora es un harness **local**: corre en tu maquina y, por defecto, escucha en
+`127.0.0.1`. Ejecuta comandos y escribe archivos dentro del workspace que elijas,
+asi que se lo debe tratar como codigo con acceso a tu usuario.
+
+- **Local (loopback)**: quien ya tiene tu sesion de usuario ya puede correr
+  comandos; el server no agrega una barrera adicional mas alla del login.
+- **Acceso remoto por tunel (tunnelmole)**: la URL publica es accesible desde
+  Internet. Es obligatorio (a) una passphrase fuerte, (b) login real en toda la
+  API, (c) limite de intentos y (d) restringir el picker de carpetas a roots
+  permitidos. Nunca expongas un server sin passphrase.
+- **Credenciales**: las API keys de proveedores se guardan en la casa local del
+  usuario (fuera del repo) y se cifran con una clave derivada de la passphrase.
+  Nunca se commitean y se devuelven enmascaradas al cliente.
+
+## Buenas practicas
+
+- Mantene Node actualizado (`node:sqlite` requiere Node >= 22.5).
+- No commitees `.env`, `tamnora.json`, bases `.db` ni `.npmrc`; estan en
+  `.gitignore`.
+- Rota cualquier credencial que se haya compartido en texto plano.
+- Cierra el tunel (`tamnora bridge --stop`) cuando no lo uses.

package/harness/packages/cli/bin/tamnora.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runCli } from '../src/cli.js';
+
+runCli(process.argv.slice(2))
+  .then((code) => {
+    process.exitCode = typeof code === 'number' ? code : 0;
+  })
+  .catch((err) => {
+    console.error(err?.stack ?? String(err));
+    process.exitCode = 1;
+  });

package/harness/packages/cli/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@tamnora/cli",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "description": "Tamnora harness CLI (local, headless-first).",
+  "bin": {
+    "tamnora": "bin/tamnora.mjs"
+  }
+}

package/harness/packages/cli/src/cli.js

@@ -0,0 +1,90 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { runCommand } from './commands/run.js';
+import { replCommand } from './commands/repl.js';
+import { evalCommand } from './commands/eval.js';
+import { initCommand } from './commands/init.js';
+import { mcpCommand } from './commands/mcp.js';
+import { serveCommand } from './commands/serve.js';
+import { serverCommand } from './commands/server.js';
+import { userCommand } from './commands/user.js';
+import { bridgeCommand } from './commands/bridge.js';
+import { updateCommand } from './commands/update.js';
+import { autostartCommand } from './commands/autostart.js';
+import { doctorCommand } from './commands/doctor.js';
+import { tuiCommand } from './commands/tui.js';
+import { color } from './ui/color.js';
+
+const COMMANDS = {
+  run: runCommand,
+  repl: replCommand,
+  tui: tuiCommand,
+  eval: evalCommand,
+  init: initCommand,
+  mcp: mcpCommand,
+  serve: serveCommand,
+  server: serverCommand,
+  user: userCommand,
+  bridge: bridgeCommand,
+  update: updateCommand,
+  autostart: autostartCommand,
+  doctor: doctorCommand,
+};
+
+function readVersion() {
+  try {
+    const pkgPath = path.join(path.dirname(fileURLToPath(import.meta.url)), '../../../../package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    return pkg.version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
+export async function runCli(argv) {
+  const [command, ...rest] = argv;
+
+  if (command === '-h' || command === '--help' || command === 'help') {
+    printHelp();
+    return 0;
+  }
+  if (command === '-v' || command === '--version') {
+    console.log(`tamnora ${readVersion()}`);
+    return 0;
+  }
+
+  const handler = command && COMMANDS[command];
+  if (handler) return handler(rest);
+
+  if (command && !command.startsWith('-')) {
+    console.error(color.red(`Comando desconocido: ${command}`));
+    printHelp();
+    return 1;
+  }
+
+  // No subcommand → full-screen console on a TTY, else the line REPL
+  if (process.stdin.isTTY && process.stdout.isTTY) return tuiCommand(argv);
+  return replCommand(argv);
+}
+
+function printHelp() {
+  console.log(`tamnora — harness local para IAs
+
+Uso:
+  tamnora                         Consola full-screen (REPL si no hay TTY)
+  tamnora run "<prompt>"          Ejecutar una tarea headless
+  tamnora eval <dataset.jsonl>    Correr un dataset de evaluación
+  tamnora mcp                     Listar servidores y herramientas MCP
+  tamnora server [--init|--start|--reload|--stop|--status|--logs]   Server en segundo plano
+  tamnora user                    Usuario local (login del server)
+  tamnora bridge [--start|--reload|--stop|--status]   Tunel publico (tunnelmole) + QR
+  tamnora autostart install|remove    Arranque automatico del server
+  tamnora serve                   Consola web local (primer plano)
+  tamnora doctor                  Verificar Node, casa, puerto y base
+  tamnora update                  Buscar/instalar una version nueva
+  tamnora init                    Crear tamnora.json
+
+También: tamnora repl · tamnora tui
+Corré "tamnora <comando> --help" para ver las opciones de cada comando.`);
+}

package/harness/packages/cli/src/commands/autostart.js

@@ -0,0 +1,121 @@
+import { spawnSync } from 'node:child_process';
+import { mkdirSync, unlinkSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { homeDir } from '../../../core/src/index.js';
+import { parse } from '../lib/util.js';
+
+const OPTIONS = { home: { type: 'string' }, help: { type: 'boolean', short: 'h' } };
+
+function autostartPath() {
+  if (process.platform === 'win32') {
+    const appData = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+    return path.join(appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup', 'Tamnora.lnk');
+  }
+  if (process.platform === 'darwin') {
+    return path.join(os.homedir(), 'Library', 'LaunchAgents', 'net.tamnora.server.plist');
+  }
+  return path.join(os.homedir(), '.config', 'systemd', 'user', 'tamnora.service');
+}
+
+function psQuote(s) {
+  return `'${String(s).replace(/'/g, "''")}'`;
+}
+
+function vbsStr(s) {
+  return `"${String(s).replace(/"/g, '""')}"`;
+}
+
+export async function autostartCommand(argv) {
+  const { positionals, values } = parse(argv, OPTIONS);
+  if (values.help) {
+    console.log('Uso: tamnora autostart install|remove\n\nInstala/quita el arranque automatico del server.');
+    return 0;
+  }
+  const action = String(positionals[0] || '').toLowerCase();
+  if (action !== 'install' && action !== 'remove') {
+    console.error('Uso: tamnora autostart install|remove');
+    return 1;
+  }
+
+  const bin = process.argv[1];
+  const node = process.execPath;
+  const target = autostartPath();
+  const homeArg = process.env.TAMNORA_HOME ? ` --home "${homeDir()}"` : '';
+  const workdir = os.homedir();
+
+  if (action === 'remove') {
+    let removed = false;
+    try {
+      unlinkSync(target);
+      removed = true;
+    } catch {
+      /* no estaba */
+    }
+    try {
+      unlinkSync(path.join(homeDir(), 'autostart.vbs'));
+    } catch {
+      /* nada */
+    }
+    console.log(removed ? `autostart quitado: ${target}` : 'no habia autostart instalado.');
+    return 0;
+  }
+
+  mkdirSync(path.dirname(target), { recursive: true });
+
+  if (process.platform === 'win32') {
+    // Lanzador oculto: wscript.exe corre un .vbs que abre node sin consola.
+    const wscript = path.join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'wscript.exe');
+    const vbsPath = path.join(homeDir(), 'autostart.vbs');
+    const vbsCmd = `"${node}" "${bin}" server --start${homeArg}`;
+    const vbs = ['Set sh = CreateObject("WScript.Shell")', `sh.Run ${vbsStr(vbsCmd)}, 0, False`, ''].join('\r\n');
+    writeFileSync(vbsPath, vbs);
+    const ps = [
+      '$ws = New-Object -ComObject WScript.Shell;',
+      `$sc = $ws.CreateShortcut(${psQuote(target)});`,
+      `$sc.TargetPath = ${psQuote(wscript)};`,
+      `$sc.Arguments = ${psQuote(`"${vbsPath}"`)};`,
+      `$sc.WorkingDirectory = ${psQuote(workdir)};`,
+      '$sc.WindowStyle = 1;',
+      '$sc.Save();',
+    ].join(' ');
+    const r = spawnSync('powershell', ['-NoProfile', '-Command', ps], { encoding: 'utf8', windowsHide: true });
+    if (r.status !== 0) {
+      console.error(`No se pudo crear el acceso directo: ${(r.stderr || '').trim()}`);
+      return 1;
+    }
+    console.log(`autostart instalado: ${target}`);
+    console.log(`  (arranca \`tamnora server --start\` en ${workdir})`);
+    return 0;
+  }
+
+  if (process.platform === 'darwin') {
+    const plist =
+      '<?xml version="1.0" encoding="UTF-8"?>\n' +
+      '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n' +
+      '<plist version="1.0"><dict>' +
+      '<key>Label</key><string>net.tamnora.server</string>' +
+      '<key>ProgramArguments</key><array>' +
+      `<string>${node}</string><string>${bin}</string>` +
+      '<string>server</string><string>--stream</string>' +
+      (process.env.TAMNORA_HOME ? `<string>--home</string><string>${homeDir()}</string>` : '') +
+      '</array>' +
+      `<key>WorkingDirectory</key><string>${workdir}</string>` +
+      '<key>RunAtLoad</key><true/><key>KeepAlive</key><true/>' +
+      '</dict></plist>\n';
+    writeFileSync(target, plist);
+  } else {
+    const unit =
+      '[Unit]\nDescription=Tamnora Harness\nAfter=network-online.target\n\n' +
+      '[Service]\nType=simple\n' +
+      `ExecStart=${node} ${bin} server --stream${homeArg}\n` +
+      `WorkingDirectory=${workdir}\nRestart=on-failure\n\n` +
+      '[Install]\nWantedBy=default.target\n';
+    writeFileSync(target, unit);
+    spawnSync('systemctl', ['--user', 'daemon-reload'], { windowsHide: true });
+    spawnSync('systemctl', ['--user', 'enable', '--now', 'tamnora.service'], { windowsHide: true });
+  }
+  console.log(`autostart instalado: ${target}`);
+  console.log(`  (arranca \`tamnora server\` en ${workdir})`);
+  return 0;
+}