soja-cli 1.4.0

package/LICENSE

@@ -0,0 +1,18 @@
+SOJA PROPRIETARY SOFTWARE LICENSE
+
+Copyright (c) 2026 Enmauel.biz (GitHub: Mike28108). All rights reserved.
+
+This package is proprietary. The copyright holder grants the recipient a
+limited, non-exclusive, non-transferable license to install and run the
+unmodified SOJA CLI package for its intended purpose. No other rights are
+granted. In particular, redistribution, sublicensing, publication of modified
+versions, and use of the source code to create a competing product require
+prior written permission from the copyright holder.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW. IN NO EVENT SHALL
+THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY
+ARISING FROM THE SOFTWARE OR ITS USE.
+
+For licensing inquiries, contact the copyright holder through the project
+repository.

package/README.md

@@ -0,0 +1,117 @@
+# SOJA
+
+```
+▄█▀▀▀▀▀▀  ▄█▀▀▀▀█▄        ██  ▄█▀▀▀▀█▄
+ ▀▀▀▀▀█▄  ██    ██        ██  ██▄▄▄▄██
+▄▄▄▄▄▄█▀  ▀█▄▄▄▄█▀  ▀█▄▄▄▄█▀  ██    ██ ▄▄▄
+```
+
+**Software Operations & Job Assistant** · v1.4.0 · by Enmauel.biz
+
+> No dashboards. No browser. No bullshit. Just work.
+
+SOJA es un gestor de tareas para equipos de desarrollo que vive en la terminal. Convierte las solicitudes que llegan por WhatsApp, reuniones o mensajes en tareas técnicas trazables en segundos, sin salir de la shell.
+
+- **Terminal-native, con aspecto de aplicación:** interfaz TUI con React + Ink, con paneles, barra lateral, ventanas flotantes, tema claro/oscuro y mouse; todo se maneja también con el teclado y atajos estilo Vim.
+- **Rápido:** para crear una task basta el título.
+- **Trazable:** cada cambio queda en el timeline de la task, junto a los comentarios.
+- **Local-first:** tus datos viven en SQLite en tu máquina. En equipo, `soja login` conecta con el servidor de SOJA y sigue funcionando sin conexión.
+- **Chat del equipo** (modo remoto): canales en tiempo real junto al trabajo, con menciones, referencias `SOJA-12` y tasks creadas desde un mensaje. `#` lo abre.
+- **Git-aware:** branch, commit, push, PR y merge desde la task, con log en vivo y errores con sugerencias. Ve el estado de cada PR y su CI en GitHub y hace el merge sin salir de la terminal. Usa tus credenciales de Git y `gh`.
+- **Scriptable:** una CLI no interactiva que usa los mismos servicios que la interfaz.
+
+## Instalar
+
+Requiere **Node.js 24+**:
+
+```bash
+npm install --global soja-cli
+soja
+```
+
+`soja update` instala versiones nuevas (SOJA avisa cuando hay una).
+
+## Acceso al servicio
+
+SOJA funciona de dos maneras:
+
+- **Modo local:** no necesita cuenta ni solicitud. Instalas, ejecutas `soja` y empiezas; tus datos se quedan en tu máquina.
+- **Modo en equipo** (servidor de SOJA): workspaces compartidos, sincronización entre máquinas y chat del equipo.
+
+**En esta primera etapa, el acceso al modo en equipo es por solicitud:**
+
+1. Inicia sesión con GitHub: `soja login` (o desde la pantalla de bienvenida de `soja`).
+2. Completa la solicitud: nombre, fecha de nacimiento, país y una carta breve (hasta 100 caracteres) sobre por qué te interesa SOJA.
+3. La revisamos en un plazo aproximado de **24 a 48 horas** y se aprueba si encaja con esta etapa del proyecto.
+
+Mientras tanto SOJA sigue en modo local, sin perder nada de lo que hagas. Consulta el estado con `soja access status`. Cuando se apruebe, vuelve a ejecutar `soja login` para elegir o crear tu workspace; `soja import-local` sube a ese workspace lo que hiciste en modo local. Si una solicitud se rechaza, puedes enviar otra con `soja access request`.
+
+Puedes borrar tu cuenta en cualquier momento con `soja account delete`.
+
+SOJA es software propietario. La instalación permite usar el paquete sin conceder derechos de redistribución o modificación; consulta [LICENSE](LICENSE). El aviso de privacidad está en [docs/PRIVACY.md](docs/PRIVACY.md).
+
+## Desde el código
+
+El código es público para que puedas revisarlo y verificar el paquete de npm (se publica con *provenance* desde este repositorio). Las contribuciones están limitadas a colaboradores aprobados; consulta [CONTRIBUTING.md](CONTRIBUTING.md). La configuración de publicación está en [docs/NPM_PUBLISH.md](docs/NPM_PUBLISH.md).
+
+
+```bash
+git clone https://github.com/Mike28108/soja-cli.git
+cd soja-cli
+npm install
+npm run dev              # la primera vez te hace 3 preguntas y listo
+```
+
+¿Quieres verlo con datos? `npm run db:seed` y luego `npm run dev`.
+
+Para tener el comando `soja` en tu sistema:
+
+```bash
+npm run build && npm link
+```
+
+## Uso en 30 segundos
+
+| Tecla | Acción |
+| --- | --- |
+| `j` / `k` · `enter` · `esc` | moverse · abrir · volver |
+| `n` | nueva task |
+| `/` | buscar |
+| `:` o `Ctrl+K` | command palette |
+| `h` / `l` o `1`–`7` | cambiar filtro |
+| `s` · `p` · `a` · `c` · `e` · `x` | estado · prioridad · asignar · comentar · editar · done |
+| `?` · `q` | ayuda · salir |
+
+```bash
+soja task create "Fix Stripe webhook" --project enroll --priority high --requester Finance
+soja task list --all
+soja folders add ~/workspace/products   # carpetas donde viven tus repos
+soja project link ENROLL enrollbridge   # o en la TUI: p → r → elegir de la lista
+soja start SOJA-12               # crea/cambia a su branch Git y la pasa a In Progress
+soja commit SOJA-12 -m "Fix" --all
+soja pr SOJA-12                  # push + pull request con gh
+soja merge SOJA-12 --delete --done
+```
+
+## Documentación
+
+- 📘 **[docs/SOJA.md](docs/SOJA.md)**: la documentación completa (conceptos, interfaz, atajos, CLI, configuración, modelo de datos, arquitectura y guía de desarrollo).
+- 📝 **[CHANGELOG.md](CHANGELOG.md)**: los cambios de cada versión.
+- 🗺️ **[ROADMAP.md](ROADMAP.md)**: hitos publicados y próximos.
+
+## Desarrollo
+
+```bash
+npm run dev        # ejecutar desde el código fuente
+npm test           # tests (Vitest)
+npm run lint       # typecheck + ESLint
+npm run build      # compilar a dist/
+npm run db:seed    # datos demo
+npm run db:reset   # borrar los datos locales (pide confirmación)
+```
+
+Stack: TypeScript · React · Ink · `node:sqlite` · Drizzle ORM · Zod · Vitest.
+
+---
+
+© Enmauel.biz. Software propietario: ver [LICENSE](LICENSE).

package/dist/application/chat.js

@@ -0,0 +1 @@
+export {};

package/dist/application/filters.js

@@ -0,0 +1,27 @@
+/** The tabs of the task list, in order. */
+export const TASK_FILTERS = ['mine', 'all', 'todo', 'in_progress', 'review', 'blocked', 'done'];
+export const FILTER_LABELS = {
+    mine: 'My Tasks',
+    all: 'All Tasks',
+    todo: 'Todo',
+    in_progress: 'In Progress',
+    review: 'Review',
+    blocked: 'Blocked',
+    done: 'Done',
+    archived: 'Archived',
+};
+const OPEN_STATUSES = ['backlog', 'todo', 'in_progress', 'review', 'blocked'];
+/** Turns a named filter into a repository query. Status filters span the whole workspace. */
+export function filterToQuery(session, filter) {
+    const workspaceId = session.workspace.id;
+    switch (filter) {
+        case 'mine':
+            return { workspaceId, assigneeId: session.user.id, statuses: OPEN_STATUSES };
+        case 'all':
+            return { workspaceId, statuses: OPEN_STATUSES };
+        case 'archived':
+            return { workspaceId, archived: 'only' };
+        default:
+            return { workspaceId, statuses: [filter] };
+    }
+}

package/dist/application/import.js

@@ -0,0 +1 @@
+export {};

package/dist/application/ports.js

@@ -0,0 +1 @@
+export {};

package/dist/application/repository-root.js

@@ -0,0 +1,18 @@
+import { existsSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { ValidationError } from '../domain/errors.js';
+import { expandHome, tildify } from '../utils/text.js';
+/** The top-level folder of the Git repository containing `path` (`~` allowed), or a friendly error. */
+export async function resolveRepositoryRoot(git, path) {
+    const absolute = resolve(expandHome(path.trim()));
+    if (!existsSync(absolute) || !statSync(absolute).isDirectory()) {
+        throw new ValidationError(`${tildify(absolute)} does not exist or is not a folder.`);
+    }
+    const root = await git.repositoryRoot(absolute);
+    if (!root) {
+        throw new ValidationError(`${tildify(absolute)} is not inside a Git repository.`, {
+            hint: 'Run `git init` there first, or point to the repository folder.',
+        });
+    }
+    return root;
+}

package/dist/application/services/backup-service.js

@@ -0,0 +1,93 @@
+import { copyFileSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { NotFoundError, ValidationError } from '../../domain/errors.js';
+const AUTO_EVERY_MS = 24 * 60 * 60 * 1000;
+const AUTO_KEEP = 7;
+const NAME = /^soja-(.+)-(\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}(?:-\d{3})?)-(auto|manual|before-restore)\.db$/;
+/**
+ * Copies of the database SOJA is using. In remote mode that is the replica,
+ * which matters for the changes still waiting to be sent.
+ */
+export class BackupService {
+    source;
+    dir;
+    clock;
+    constructor(source, dir, clock = () => new Date()) {
+        this.source = source;
+        this.dir = dir;
+        this.clock = clock;
+    }
+    create(kind = 'manual') {
+        mkdirSync(this.dir, { recursive: true });
+        const path = join(this.dir, fileName(this.source.label, this.clock(), kind));
+        this.source.backupTo(path);
+        return describe(path);
+    }
+    /** Newest first, only this database's copies. */
+    list() {
+        if (!existsSync(this.dir))
+            return [];
+        return readdirSync(this.dir)
+            .filter((name) => NAME.exec(name)?.[1] === safeLabel(this.source.label))
+            .map((name) => describe(join(this.dir, name)))
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    /** A daily copy when SOJA opens; keeps the last seven. Returns the copy made, if any. */
+    auto() {
+        const autos = this.list().filter((backup) => backup.kind === 'auto');
+        const latest = autos[0];
+        if (latest && this.clock().getTime() - latest.createdAt.getTime() < AUTO_EVERY_MS)
+            return null;
+        const made = this.create('auto');
+        for (const old of [made, ...autos].slice(AUTO_KEEP))
+            rmSync(old.path, { force: true });
+        return made;
+    }
+    find(name) {
+        const backup = this.list().find((candidate) => candidate.name === name || candidate.name === `${name}.db`);
+        if (!backup)
+            throw new NotFoundError(`There is no backup called ${name}.`, { hint: 'See them with `soja backup list`.' });
+        return backup;
+    }
+}
+/**
+ * Puts a backup in place of `databaseFile`, keeping a copy of the current
+ * state first. SOJA must not have the database open (run it from a command
+ * that did not open one).
+ */
+export function restoreBackup(backup, databaseFile, dir, label, clock = () => new Date()) {
+    if (!existsSync(backup.path))
+        throw new ValidationError(`${backup.name} no longer exists.`);
+    let saved = null;
+    if (existsSync(databaseFile)) {
+        const path = join(dir, fileName(label, clock(), 'before-restore'));
+        copyFileSync(databaseFile, path);
+        saved = describe(path);
+    }
+    // The write-ahead log belongs to the database being replaced.
+    for (const suffix of ['-wal', '-shm'])
+        rmSync(`${databaseFile}${suffix}`, { force: true });
+    mkdirSync(join(databaseFile, '..'), { recursive: true });
+    copyFileSync(backup.path, databaseFile);
+    return saved;
+}
+function fileName(label, at, kind) {
+    return `soja-${safeLabel(label)}-${at.toISOString().replace(/[:.]/g, '-').replace(/Z$/, '')}-${kind}.db`;
+}
+function safeLabel(label) {
+    return label.replace(/[^a-z0-9.]+/gi, '_');
+}
+function describe(path) {
+    const name = basename(path);
+    const match = NAME.exec(name);
+    const stamp = match?.[2] ?? '';
+    const [date = '', time = ''] = stamp.split('T');
+    const [hours = '00', minutes = '00', seconds = '00', millis = '000'] = time.split('-');
+    return {
+        name,
+        path,
+        createdAt: new Date(`${date}T${hours}:${minutes}:${seconds}.${millis}Z`),
+        bytes: statSync(path).size,
+        kind: match?.[3] ?? 'manual',
+    };
+}

package/dist/application/services/folder-service.js

@@ -0,0 +1,116 @@
+import { existsSync, readdirSync, realpathSync, statSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { ConflictError, NotFoundError, SojaError, ValidationError } from '../../domain/errors.js';
+import { expandHome, tildify } from '../../utils/text.js';
+/**
+ * Parent folders ("where my repositories live") and their subfolders, for
+ * picking a project repository from a list instead of typing paths.
+ * Everything here is local to this machine.
+ */
+export class FolderService {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    list() {
+        return this.config.load()?.parentFolders ?? [];
+    }
+    add(path) {
+        if (!path.trim())
+            throw new ValidationError('Type the path of a folder.');
+        const absolute = resolve(expandHome(path.trim()));
+        if (!existsSync(absolute) || !statSync(absolute).isDirectory()) {
+            throw new ValidationError(`${tildify(absolute)} does not exist or is not a folder.`);
+        }
+        const folders = this.list();
+        if (folders.includes(absolute))
+            throw new ConflictError(`${tildify(absolute)} is already a parent folder.`);
+        this.save([...folders, absolute]);
+        return this.list();
+    }
+    /** Removes by exact path (`~` allowed) or by folder name when that is unambiguous. */
+    remove(pathOrName) {
+        const target = this.find(pathOrName);
+        this.save(this.list().filter((folder) => folder !== target));
+        return this.list();
+    }
+    /** Every parent folder with its immediate subfolders, like `ls -1` (hidden folders skipped). */
+    browse() {
+        return this.list().map((path) => {
+            let names;
+            try {
+                names = readdirSync(path, { withFileTypes: true })
+                    .filter((entry) => !entry.name.startsWith('.') && isDirectory(path, entry.name, entry.isDirectory(), entry.isSymbolicLink()))
+                    .map((entry) => entry.name)
+                    .sort((a, b) => a.localeCompare(b, undefined, { sensitivity: 'base' }));
+            }
+            catch {
+                return { path, available: false, children: [] };
+            }
+            return {
+                path,
+                available: true,
+                children: names.map((name) => {
+                    const full = join(path, name);
+                    return { name, path: safeRealpath(full), isGitRepository: existsSync(join(full, '.git')) };
+                }),
+            };
+        });
+    }
+    /**
+     * Resolves a subfolder by name across all parent folders, e.g.
+     * `enrollbridge` → `~/workspace/products/enrollbridge`.
+     */
+    findChild(name) {
+        const matches = this.browse().flatMap((parent) => parent.children.filter((child) => child.name === name.trim()));
+        const [first, second] = matches;
+        if (!first) {
+            throw new NotFoundError(`No folder called “${name}” inside your parent folders.`, {
+                hint: this.list().length ? 'List them with `soja folders list`.' : 'Add one with `soja folders add <path>`.',
+            });
+        }
+        if (second) {
+            throw new ConflictError(`“${name}” exists in more than one parent folder.`, {
+                hint: `Use the full path: ${matches.map((match) => tildify(match.path)).join(' or ')}`,
+            });
+        }
+        return first;
+    }
+    find(pathOrName) {
+        const folders = this.list();
+        const absolute = resolve(expandHome(pathOrName.trim()));
+        if (folders.includes(absolute))
+            return absolute;
+        const byName = folders.filter((folder) => basename(folder) === pathOrName.trim());
+        if (byName.length === 1 && byName[0])
+            return byName[0];
+        throw new NotFoundError(`${pathOrName} is not one of your parent folders.`, { hint: 'List them with `soja folders list`.' });
+    }
+    save(parentFolders) {
+        const current = this.config.load();
+        if (!current) {
+            throw new SojaError('SOJA is not set up yet.', { hint: 'Run `soja` once to create your user and workspace.' });
+        }
+        this.config.save({ ...current, parentFolders });
+    }
+}
+function isDirectory(parent, name, isDir, isLink) {
+    if (isDir)
+        return true;
+    if (!isLink)
+        return false;
+    try {
+        return statSync(join(parent, name)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function safeRealpath(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}