theus-cli 0.2.82 → 0.2.84

package/vendor/theus-arsenal/scripts/lib/observer-sessions.js

@@ -1,237 +0,0 @@
-/**
- * Utilidades de sesiones del observador (proceso en segundo plano de Theus).
- * Administra el directorio de datos del observador, el registro de proyectos
- * y los "leases" de sesión que indican qué sesiones están activas por proyecto.
- */
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const crypto = require('crypto');
-const { spawnSync } = require('child_process');
-const { ensureDir, sanitizeSessionId } = require('./utils');
-
-/**
- * Directorio de datos del observador. Orden de resolución:
- *   1. THEUS_OBSERVER_DIR — override explícito (debe ser absoluto).
- *   2. THEUS_PLUGIN_DATA/observer — cuando el motor Theus inyecta el
- *      directorio de datos del plugin (ubicación preferida para estado
- *      persistente).
- *   3. XDG_DATA_HOME/theus-observer — si XDG_DATA_HOME es absoluto.
- *   4. ~/.local/share/theus-observer — valor por defecto.
- */
-function getObserverDataDir() {
-  const override = process.env.THEUS_OBSERVER_DIR;
-  if (override) {
-    if (path.isAbsolute(override)) {
-      return override;
-    }
-    process.stderr.write(`[theus] THEUS_OBSERVER_DIR=${override} no es absoluta; se ignora\n`);
-  }
-
-  // Nota: THEUS_PLUGIN_DATA se excluye a propósito — solo existe en el
-  // entorno de los hooks y partiría los datos del observador según el
-  // contexto de ejecución. Ver scripts/lib/agent-data-home.js.
-  const xdgDataHome = process.env.XDG_DATA_HOME;
-  if (xdgDataHome) {
-    if (path.isAbsolute(xdgDataHome)) {
-      return path.join(xdgDataHome, 'theus-observer');
-    }
-    process.stderr.write(`[theus] XDG_DATA_HOME=${xdgDataHome} no es absoluta; se ignora\n`);
-  }
-
-  return path.join(os.homedir(), '.local', 'share', 'theus-observer');
-}
-
-function getProjectsDir() {
-  return path.join(getObserverDataDir(), 'projects');
-}
-
-function getProjectRegistryPath() {
-  return path.join(getObserverDataDir(), 'projects.json');
-}
-
-function readProjectRegistry() {
-  try {
-    return JSON.parse(fs.readFileSync(getProjectRegistryPath(), 'utf8'));
-  } catch {
-    return {};
-  }
-}
-
-function runGit(args, cwd) {
-  const result = spawnSync('git', args, {
-    cwd,
-    encoding: 'utf8',
-    stdio: ['ignore', 'pipe', 'ignore']
-  });
-  if (result.status !== 0) return '';
-  return (result.stdout || '').trim();
-}
-
-function stripRemoteCredentials(remoteUrl) {
-  if (!remoteUrl) return '';
-  return String(remoteUrl).replace(/:\/\/[^@]+@/, '://');
-}
-
-function normalizeRemoteUrl(remoteUrl) {
-  if (!remoteUrl) return '';
-  const raw = String(remoteUrl);
-  const isNetwork = !raw.startsWith('file://') && (raw.includes('://') || /^[^@/:]+@[^:/]+:/.test(raw));
-  let normalized = stripRemoteCredentials(raw)
-    .replace(/^[A-Za-z][A-Za-z0-9+.-]*:\/\//, '')
-    .replace(/^[^@/:]+@([^:/]+):/, '$1/')
-    .replace(/\.git\/?$/, '')
-    .replace(/\/+$/, '');
-
-  if (isNetwork) {
-    normalized = normalized.toLowerCase();
-  }
-
-  return normalized;
-}
-
-function resolveProjectRoot(cwd = process.cwd()) {
-  const envRoot = process.env.THEUS_PROJECT_DIR;
-  if (envRoot && fs.existsSync(envRoot)) {
-    return path.resolve(envRoot);
-  }
-
-  const gitRoot = runGit(['rev-parse', '--show-toplevel'], cwd);
-  if (gitRoot) return path.resolve(gitRoot);
-
-  return '';
-}
-
-function computeProjectId(projectRoot) {
-  const remoteUrl = stripRemoteCredentials(runGit(['remote', 'get-url', 'origin'], projectRoot));
-  const hashInput = normalizeRemoteUrl(remoteUrl) || remoteUrl || projectRoot;
-  return crypto.createHash('sha256').update(hashInput).digest('hex').slice(0, 12);
-}
-
-function resolveProjectContext(cwd = process.cwd()) {
-  const projectRoot = resolveProjectRoot(cwd);
-  if (!projectRoot) {
-    const projectDir = getObserverDataDir();
-    ensureDir(projectDir);
-    return { projectId: 'global', projectRoot: '', projectDir, isGlobal: true };
-  }
-
-  const registry = readProjectRegistry();
-  const registryEntry = Object.values(registry).find(entry => entry && path.resolve(entry.root || '') === projectRoot);
-  const projectId = registryEntry?.id || computeProjectId(projectRoot);
-  const projectDir = path.join(getProjectsDir(), projectId);
-  ensureDir(projectDir);
-
-  return { projectId, projectRoot, projectDir, isGlobal: false };
-}
-
-function getObserverPidFile(context) {
-  return path.join(context.projectDir, '.observer.pid');
-}
-
-function getObserverSignalCounterFile(context) {
-  return path.join(context.projectDir, '.observer-signal-counter');
-}
-
-function getObserverActivityFile(context) {
-  return path.join(context.projectDir, '.observer-last-activity');
-}
-
-function getSessionLeaseDir(context) {
-  return path.join(context.projectDir, '.observer-sessions');
-}
-
-/**
- * Sanitiza el `session_id` que el motor Theus entrega a los hooks por stdin
- * (campo `session_id` del JSON del evento; es un UUID). No existe una
- * variable de entorno con el ID de sesión: el llamador debe pasarlo.
- * @param {string} rawSessionId - `session_id` leído del stdin del hook
- * @returns {string} ID de sesión sanitizado o cadena vacía
- */
-function resolveSessionId(rawSessionId) {
-  return sanitizeSessionId(rawSessionId || '') || '';
-}
-
-function getSessionLeaseFile(context, rawSessionId) {
-  const sessionId = resolveSessionId(rawSessionId);
-  if (!sessionId) return '';
-  return path.join(getSessionLeaseDir(context), `${sessionId}.json`);
-}
-
-function writeSessionLease(context, rawSessionId, extra = {}) {
-  const leaseFile = getSessionLeaseFile(context, rawSessionId);
-  if (!leaseFile) return '';
-
-  ensureDir(getSessionLeaseDir(context));
-  const payload = {
-    sessionId: resolveSessionId(rawSessionId),
-    cwd: process.cwd(),
-    pid: process.pid,
-    updatedAt: new Date().toISOString(),
-    ...extra
-  };
-  fs.writeFileSync(leaseFile, JSON.stringify(payload, null, 2) + '\n');
-  return leaseFile;
-}
-
-function removeSessionLease(context, rawSessionId) {
-  const leaseFile = getSessionLeaseFile(context, rawSessionId);
-  if (!leaseFile) return false;
-  try {
-    fs.rmSync(leaseFile, { force: true });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function listSessionLeases(context) {
-  const leaseDir = getSessionLeaseDir(context);
-  if (!fs.existsSync(leaseDir)) return [];
-  return fs.readdirSync(leaseDir)
-    .filter(name => name.endsWith('.json'))
-    .map(name => path.join(leaseDir, name));
-}
-
-function stopObserverForContext(context) {
-  const pidFile = getObserverPidFile(context);
-  if (!fs.existsSync(pidFile)) return false;
-
-  const pid = (fs.readFileSync(pidFile, 'utf8') || '').trim();
-  if (!/^[0-9]+$/.test(pid) || pid === '0' || pid === '1') {
-    fs.rmSync(pidFile, { force: true });
-    return false;
-  }
-
-  try {
-    process.kill(Number(pid), 0);
-  } catch {
-    fs.rmSync(pidFile, { force: true });
-    return false;
-  }
-
-  try {
-    process.kill(Number(pid), 'SIGTERM');
-  } catch {
-    return false;
-  }
-
-  fs.rmSync(pidFile, { force: true });
-  fs.rmSync(getObserverSignalCounterFile(context), { force: true });
-  return true;
-}
-
-module.exports = {
-  getObserverDataDir,
-  normalizeRemoteUrl,
-  resolveProjectContext,
-  getObserverActivityFile,
-  getObserverPidFile,
-  getSessionLeaseDir,
-  writeSessionLease,
-  removeSessionLease,
-  listSessionLeases,
-  stopObserverForContext,
-  resolveSessionId
-};

package/vendor/theus-arsenal/scripts/lib/package-manager.d.ts

@@ -1,120 +0,0 @@
-/**
- * Detección y selección del gestor de paquetes.
- * Soporta: npm, pnpm, yarn, bun.
- */
-
-/** Nombres de gestores de paquetes soportados */
-export type PackageManagerName = 'npm' | 'pnpm' | 'yarn' | 'bun';
-
-/** Configuración de un gestor de paquetes */
-export interface PackageManagerConfig {
-  name: PackageManagerName;
-  /** Nombre del lock file (p. ej., "package-lock.json", "pnpm-lock.yaml") */
-  lockFile: string;
-  /** Comando de instalación (p. ej., "npm install") */
-  installCmd: string;
-  /** Prefijo del comando para ejecutar scripts (p. ej., "npm run", "pnpm") */
-  runCmd: string;
-  /** Comando para ejecutar binarios (p. ej., "npx", "pnpm dlx") */
-  execCmd: string;
-  /** Comando de tests (p. ej., "npm test") */
-  testCmd: string;
-  /** Comando de build (p. ej., "npm run build") */
-  buildCmd: string;
-  /** Comando del servidor de desarrollo (p. ej., "npm run dev") */
-  devCmd: string;
-}
-
-/** Cómo se detectó el gestor de paquetes */
-export type DetectionSource =
-  | 'environment'
-  | 'project-config'
-  | 'package.json'
-  | 'lock-file'
-  | 'global-config'
-  | 'default';
-
-/** Resultado de getPackageManager() */
-export interface PackageManagerResult {
-  name: PackageManagerName;
-  config: PackageManagerConfig;
-  source: DetectionSource;
-}
-
-/** Mapa de todos los gestores de paquetes soportados, indexado por nombre */
-export const PACKAGE_MANAGERS: Record<PackageManagerName, PackageManagerConfig>;
-
-/** Orden de prioridad para la detección por lock file */
-export const DETECTION_PRIORITY: PackageManagerName[];
-
-export interface GetPackageManagerOptions {
-  /** Directorio del proyecto donde detectar (por defecto: process.cwd()) */
-  projectDir?: string;
-}
-
-/**
- * Obtiene el gestor de paquetes a usar para el proyecto actual.
- *
- * Prioridad de detección:
- * 1. Variable de entorno THEUS_PACKAGE_MANAGER
- * 2. Configuración específica del proyecto (.theus/package-manager.json)
- * 3. Campo `packageManager` de package.json
- * 4. Detección por lock file
- * 5. Preferencia global del usuario (package-manager.json en el directorio de datos de Theus)
- * 6. npm por defecto (sin lanzar procesos hijo)
- */
-export function getPackageManager(options?: GetPackageManagerOptions): PackageManagerResult;
-
-/**
- * Establece el gestor de paquetes preferido global del usuario.
- * Se guarda en package-manager.json del directorio de datos de Theus.
- * @throws Si pmName no es un gestor conocido o si falla el guardado
- */
-export function setPreferredPackageManager(pmName: PackageManagerName): { packageManager: string; setAt: string };
-
-/**
- * Establece el gestor de paquetes preferido de un proyecto.
- * Se guarda en <projectDir>/.theus/package-manager.json.
- * @throws Si pmName no es un gestor conocido
- */
-export function setProjectPackageManager(pmName: PackageManagerName, projectDir?: string): { packageManager: string; setAt: string };
-
-/**
- * Obtiene los gestores de paquetes instalados en el sistema.
- * ADVERTENCIA: lanza procesos hijo por cada comprobación.
- * NO llamar durante los hooks de inicio de sesión.
- */
-export function getAvailablePackageManagers(): PackageManagerName[];
-
-/** Detecta el gestor de paquetes a partir del lock file en el directorio indicado */
-export function detectFromLockFile(projectDir?: string): PackageManagerName | null;
-
-/** Detecta el gestor de paquetes a partir del campo `packageManager` de package.json */
-export function detectFromPackageJson(projectDir?: string): PackageManagerName | null;
-
-/**
- * Obtiene la cadena de comando completa para ejecutar un script.
- * @param script - Nombre del script: "install", "test", "build", "dev" o uno personalizado
- */
-export function getRunCommand(script: string, options?: GetPackageManagerOptions): string;
-
-/**
- * Obtiene la cadena de comando completa para ejecutar el binario de un paquete.
- * @param binary - Nombre del binario (p. ej., "prettier", "eslint")
- * @param args - Argumentos a pasar al binario
- */
-export function getExecCommand(binary: string, args?: string, options?: GetPackageManagerOptions): string;
-
-/**
- * Obtiene un mensaje que orienta al usuario para configurar su gestor de paquetes.
- * NO lanza procesos hijo.
- */
-export function getSelectionPrompt(): string;
-
-/**
- * Genera una cadena de patrón regex que coincide con los comandos de todos los
- * gestores de paquetes.
- * @param action - Acción como "dev", "install", "test", "build" o personalizada
- * @returns Cadena regex de alternación entre paréntesis, p. ej., "(npm run dev|pnpm( run)? dev|...)"
- */
-export function getCommandPattern(action: string): string;