@mmmbuto/nexuscrew 0.2.1 → 0.2.3

package/lib/server/services/summary-generator.js

@@ -1,309 +0,0 @@
-/**
- * SummaryGenerator - produce contextual summaries for sessions.
- *
- * Features:
- * - Generate AI titles for new conversations
- * - Generate contextual summaries for sessions
- * - Auto-save summaries to session_summaries table
- * - Support for summary-based context bridging
- *
- * Note: AI generation requires external provider configuration.
- * This implementation provides the structure; actual AI calls
- * can be integrated via environment-provided clients or webhooks.
- */
-
-const { v4: uuidv4 } = require('uuid');
-const { prepare, saveDb } = require('../db/adapter');
-
-class SummaryGenerator {
-  constructor(options = {}) {
-    this.options = options;
-    // AI client can be injected or configured later
-    this.aiClient = options.aiClient || null;
-  }
-
-  /**
-   * Set AI client for summary generation
-   * @param {Object} client - AI client with sendMessage method
-   */
-  setAIClient(client) {
-    this.aiClient = client;
-  }
-
-  /**
-   * Generate a short title for a new conversation (3-8 words)
-   * Called after first AI response, runs in background
-   * @param {string} userMessage - First user message
-   * @param {string} assistantResponse - First AI response (optional, for context)
-   * @returns {Promise<string>} Generated title
-   */
-  async generateTitle(userMessage, assistantResponse = '') {
-    const startedAt = Date.now();
-
-    // Keep context brief for fast generation
-    const context = assistantResponse
-      ? `User: ${userMessage.slice(0, 500)}\nAssistant: ${assistantResponse.slice(0, 500)}`
-      : `User: ${userMessage.slice(0, 800)}`;
-
-    const prompt = `Generate a brief title (3-8 words, no quotes) for this conversation:
-
-${context}
-
-Reply with ONLY the title, nothing else.`;
-
-    try {
-      if (!this.aiClient) {
-        console.warn('[SummaryGenerator] No AI client configured, using fallback title generation');
-        return this.fallbackTitle(userMessage);
-      }
-
-      const result = await this.aiClient.sendMessage({
-        prompt,
-        conversationId: uuidv4(), // Ephemeral session
-        model: 'haiku',
-        onStatus: () => {} // Silence status
-      });
-
-      // Clean up the response
-      let title = result.text.trim()
-        .replace(/^["']|["']$/g, '') // Remove surrounding quotes
-        .replace(/^Title:\s*/i, '') // Remove "Title:" prefix
-        .slice(0, 60); // Max 60 chars
-
-      console.log(`[SummaryGenerator] Title generated in ${Date.now() - startedAt}ms: ${title}`);
-      return title || 'New Chat';
-    } catch (error) {
-      console.error('[SummaryGenerator] Title generation failed:', error.message);
-      // Fallback to truncated first message
-      return this.fallbackTitle(userMessage);
-    }
-  }
-
-  /**
-   * Fallback title generation (simple truncation)
-   * @param {string} userMessage
-   * @returns {string}
-   */
-  fallbackTitle(userMessage) {
-    return userMessage.slice(0, 50).trim() + (userMessage.length > 50 ? '...' : '');
-  }
-
-  /**
-   * Generate or refresh summary for a session.
-   * @param {Object} params
-   * @param {string} params.conversationId
-   * @param {Array} params.messages - Array of {role, content, created_at}
-   * @param {Object|null} params.existingSummary
-   * @returns {Promise<Object>} summary payload
-   */
-  async generateSummary({ conversationId, messages = [], existingSummary = null }) {
-    if (!conversationId) throw new Error('conversationId is required');
-
-    const startedAt = Date.now();
-
-    // Build transcript snippet (limit to 40 latest messages for brevity)
-    const transcript = this.buildTranscript(messages.slice(-40));
-
-    const prompt = this.buildPrompt({ conversationId, transcript, existingSummary });
-
-    if (!this.aiClient) {
-      console.warn('[SummaryGenerator] No AI client configured, using fallback summary');
-      return this.fallbackSummary(messages);
-    }
-
-    const result = await this.aiClient.sendMessage({
-      prompt,
-      conversationId: uuidv4(), // Ephemeral session
-      model: 'haiku',
-      onStatus: () => {} // silence status for summaries
-    });
-
-    const parsed = this.safeParseJson(result.text);
-
-    console.log(`[SummaryGenerator] Summary for ${conversationId} took ${Date.now() - startedAt}ms`);
-
-    return parsed;
-  }
-
-  /**
-   * Fallback summary generation (rule-based)
-   * @param {Array} messages
-   * @returns {Object}
-   */
-  fallbackSummary(messages) {
-    const userMessages = messages.filter(m => m.role === 'user');
-    const assistantMessages = messages.filter(m => m.role === 'assistant');
-
-    // Extract first user message as summary
-    const firstUserMsg = userMessages[0]?.content || '';
-    const summary = firstUserMsg.slice(0, 200) + (firstUserMsg.length > 200 ? '...' : '');
-
-    return {
-      summary_short: summary,
-      summary_long: null,
-      key_decisions: [],
-      tools_used: [],
-      files_modified: []
-    };
-  }
-
-  /**
-   * Save summary to database
-   * @param {string} conversationId
-   * @param {Object} summary - {summary_short, summary_long, key_decisions, tools_used, files_modified}
-   * @returns {boolean} Success
-   */
-  saveSummary(conversationId, summary) {
-    try {
-      const stmt = prepare(`
-        INSERT OR REPLACE INTO session_summaries
-        (conversation_id, summary_short, key_decisions, files_modified, updated_at)
-        VALUES (?, ?, ?, ?, ?)
-      `);
-
-      stmt.run(
-        conversationId,
-        summary.summary_short || '',
-        JSON.stringify(summary.key_decisions || []),
-        JSON.stringify(summary.files_modified || []),
-        Date.now()
-      );
-
-      saveDb();
-      console.log(`[SummaryGenerator] Saved summary for ${conversationId}`);
-      return true;
-    } catch (error) {
-      console.error(`[SummaryGenerator] Failed to save summary:`, error.message);
-      return false;
-    }
-  }
-
-  /**
-   * Get existing summary from database
-   * @param {string} conversationId
-   * @returns {Object|null}
-   */
-  getSummary(conversationId) {
-    try {
-      const stmt = prepare('SELECT * FROM session_summaries WHERE conversation_id = ?');
-      const row = stmt.get(conversationId);
-
-      if (!row) return null;
-
-      return {
-        summary_short: row.summary_short,
-        summary_long: row.summary_long || null,
-        key_decisions: JSON.parse(row.key_decisions || '[]'),
-        files_modified: JSON.parse(row.files_modified || '[]'),
-        updated_at: row.updated_at
-      };
-    } catch (error) {
-      console.warn(`[SummaryGenerator] Failed to get summary:`, error.message);
-      return null;
-    }
-  }
-
-  /**
-   * Generate summary and save to DB (convenience method)
-   * @param {string} conversationId
-   * @param {Array} messages
-   * @returns {Promise<Object|null>}
-   */
-  async generateAndSave(conversationId, messages) {
-    try {
-      const existingSummary = this.getSummary(conversationId);
-      const summary = await this.generateSummary({ conversationId, messages, existingSummary });
-      this.saveSummary(conversationId, summary);
-      return summary;
-    } catch (error) {
-      console.error(`[SummaryGenerator] generateAndSave failed:`, error.message);
-      return null;
-    }
-  }
-
-  /**
-   * Get summary text for context bridging
-   * Returns a formatted string suitable for prefixing prompts
-   * @param {string} conversationId
-   * @returns {string|null}
-   */
-  getBridgeContext(conversationId) {
-    const summary = this.getSummary(conversationId);
-    if (!summary || !summary.summary_short) return null;
-
-    let context = `[Session Summary]\n${summary.summary_short}`;
-
-    if (summary.key_decisions && summary.key_decisions.length > 0) {
-      context += `\n\nKey decisions:\n- ${summary.key_decisions.slice(0, 5).join('\n- ')}`;
-    }
-
-    if (summary.files_modified && summary.files_modified.length > 0) {
-      context += `\n\nFiles worked on:\n- ${summary.files_modified.slice(0, 10).join('\n- ')}`;
-    }
-
-    return context;
-  }
-
-  buildTranscript(messages) {
-    return messages
-      .map(m => {
-        const role = m.role || 'assistant';
-        const content = (m.content || '').trim();
-        const ts = m.created_at ? new Date(m.created_at * 1000).toISOString() : '';
-        return `[${ts}] ${role.toUpperCase()}: ${content}`;
-      })
-      .join('\n')
-      .slice(-6000); // keep prompt size reasonable
-  }
-
-  buildPrompt({ conversationId, transcript, existingSummary }) {
-    const existing = existingSummary
-      ? `Existing summary (for refresh): ${JSON.stringify(existingSummary)}`
-      : 'No existing summary.';
-
-    return `
-You are a concise assistant. Summarize the coding/chat session into JSON.
-Conversation ID: ${conversationId}
-
-${existing}
-
-Provide JSON with keys:
-- summary_short (<=80 words)
-- summary_long (<=200 words, optional)
-- key_decisions (array of short bullet strings)
-- tools_used (array of tool names or commands, optional)
-- files_modified (array of file paths)
-
-Do not include any extra text outside valid JSON.
-
-Transcript:
-${transcript}
-`;
-  }
-
-  safeParseJson(text) {
-    // Try to extract JSON block
-    const start = text.indexOf('{');
-    const end = text.lastIndexOf('}');
-    if (start === -1 || end === -1) {
-      throw new Error('Failed to parse summary JSON');
-    }
-
-    const jsonString = text.slice(start, end + 1);
-
-    try {
-      const parsed = JSON.parse(jsonString);
-      // Normalize array fields
-      ['key_decisions', 'tools_used', 'files_modified'].forEach(key => {
-        if (parsed[key] && !Array.isArray(parsed[key])) {
-          parsed[key] = [parsed[key]].filter(Boolean);
-        }
-      });
-      return parsed;
-    } catch (e) {
-      throw new Error('Invalid JSON returned by model');
-    }
-  }
-}
-
-module.exports = SummaryGenerator;

package/lib/server/services/workspace-manager.js

@@ -1,79 +0,0 @@
-/**
- * Workspace Manager - NexusCrew tmux-based version
- *
- * Simplified version that discovers workspaces from conversations table
- * instead of reading .claude/projects/ JSONL files (NexusCLI approach).
- */
-
-const fs = require('fs');
-const { prepare } = require('../db/adapter');
-
-class WorkspaceManager {
-  /**
-   * Discover workspaces from conversations table
-   * Groups by workspace path and counts sessions
-   * @returns {Array} List of workspaces with metadata
-   */
-  discoverWorkspaces() {
-    const stmt = prepare(`
-      SELECT workspace, COUNT(*) as session_count,
-             MAX(updated_at) as last_activity
-      FROM conversations
-      WHERE workspace != '' AND workspace IS NOT NULL
-      GROUP BY workspace
-      ORDER BY last_activity DESC
-    `);
-
-    return stmt.all().map(row => ({
-      path: row.workspace,
-      session_count: row.session_count,
-      last_activity: row.last_activity
-    }));
-  }
-
-  /**
-   * Validate workspace path exists on filesystem
-   * @param {string} wsPath - Absolute path to workspace
-   * @returns {boolean} True if path exists and is a directory
-   */
-  validateWorkspace(wsPath) {
-    try {
-      return fs.statSync(wsPath).isDirectory();
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Get conversations for a specific workspace
-   * @param {string} workspace - Workspace path
-   * @returns {Array} List of conversations in workspace
-   */
-  getWorkspaceConversations(workspace) {
-    const stmt = prepare(`
-      SELECT * FROM conversations
-      WHERE workspace = ?
-      ORDER BY updated_at DESC
-    `);
-    return stmt.all(workspace);
-  }
-
-  /**
-   * Get workspace statistics
-   * @param {string} workspace - Workspace path
-   * @returns {Object} Statistics for the workspace
-   */
-  getWorkspaceStats(workspace) {
-    const stmt = prepare(`
-      SELECT
-        COUNT(*) as total_conversations,
-        SUM(CASE WHEN status = 'active' THEN 1 ELSE 0 END) as active_conversations,
-        SUM(CASE WHEN pinned = 1 THEN 1 ELSE 0 END) as pinned_conversations
-      FROM conversations
-      WHERE workspace = ?
-    `);
-    return stmt.get(workspace);
-  }
-}
-
-module.exports = WorkspaceManager;

package/lib/services/remote-pane-watcher.js

@@ -1,155 +0,0 @@
-const { EventEmitter } = require('events');
-const LogWatcher = require('./log-watcher');
-
-function normalizeSnapshot(text = '') {
-  return String(text).replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-}
-
-function commonPrefixLength(a = '', b = '') {
-  const max = Math.min(a.length, b.length);
-  let index = 0;
-  while (index < max && a[index] === b[index]) {
-    index += 1;
-  }
-  return index;
-}
-
-class RemotePaneWatcher extends EventEmitter {
-  constructor(tmux, options = {}) {
-    super();
-    this.tmux = tmux;
-    this.parserAdapter = new LogWatcher();
-    this.watchers = new Map();
-    this.pollMs = options.pollMs || 400;
-    this.idleMs = options.idleMs || 4500;
-    this.timeoutMs = options.timeoutMs || 120000;
-
-    this.parserAdapter.on('data', (event) => this.emit('data', event));
-  }
-
-  watch({ conversationId, engine, host, windowName, promptText = '', initialSnapshot = '' }) {
-    const key = `${host?.name || host || 'local'}:${windowName}:${conversationId}`;
-    if (this.watchers.has(key)) return key;
-
-    const parserState = this.parserAdapter.createParserState(engine, conversationId);
-    const state = {
-      key,
-      conversationId,
-      engine,
-      host,
-      windowName,
-      parserState,
-      promptText: String(promptText || ''),
-      lastSnapshot: normalizeSnapshot(initialSnapshot),
-      startedAt: Date.now(),
-      lastChangeAt: Date.now(),
-      lastEmitAt: 0,
-      stopped: false,
-      sawAnyOutput: false
-    };
-
-    const intervalId = setInterval(() => this._poll(state), this.pollMs);
-    state.intervalId = intervalId;
-    this.watchers.set(key, state);
-    return key;
-  }
-
-  unwatch(key) {
-    const state = this.watchers.get(key);
-    if (!state) return;
-    clearInterval(state.intervalId);
-    state.stopped = true;
-    this.watchers.delete(key);
-  }
-
-  unwatchByConversation(conversationId) {
-    for (const [key, state] of this.watchers.entries()) {
-      if (state.conversationId === conversationId) {
-        this.unwatch(key);
-      }
-    }
-  }
-
-  unwatchAll() {
-    for (const key of this.watchers.keys()) {
-      this.unwatch(key);
-    }
-  }
-
-  _poll(state) {
-    if (state.stopped) return;
-
-    if (Date.now() - state.startedAt > this.timeoutMs) {
-      this._finish(state, true);
-      return;
-    }
-
-    const snapshot = normalizeSnapshot(
-      this.tmux.capturePane(state.windowName, state.host, 250)
-    );
-
-    if (!snapshot) {
-      if (Date.now() - state.lastChangeAt > this.idleMs) {
-        this._finish(state, true);
-      }
-      return;
-    }
-
-    if (snapshot === state.lastSnapshot) {
-      if (state.sawAnyOutput && Date.now() - state.lastChangeAt > this.idleMs) {
-        this._finish(state, true);
-      }
-      return;
-    }
-
-    const prefixLength = commonPrefixLength(state.lastSnapshot, snapshot);
-    let delta = snapshot.slice(prefixLength);
-    state.lastSnapshot = snapshot;
-    state.lastChangeAt = Date.now();
-
-    if (!delta.trim()) {
-      return;
-    }
-
-    delta = this._stripPromptEcho(delta, state);
-    if (!delta.trim()) {
-      return;
-    }
-
-    state.sawAnyOutput = true;
-    this.parserAdapter.processTextChunk(delta, state.parserState);
-    state.lastEmitAt = Date.now();
-  }
-
-  _stripPromptEcho(delta, state) {
-    if (!state.promptText) return delta;
-
-    const prompt = state.promptText.trim();
-    if (!prompt) return delta;
-
-    if (delta.includes(prompt)) {
-      return delta.replace(prompt, '');
-    }
-
-    const compact = delta.trim();
-    if (prompt.startsWith(compact) && compact.length > 10) {
-      return '';
-    }
-
-    return delta;
-  }
-
-  _finish(state, emitDone = false) {
-    this.parserAdapter.flushState(state.parserState);
-    if (emitDone) {
-      this.emit('data', {
-        type: 'done',
-        conversationId: state.conversationId,
-        engine: state.engine
-      });
-    }
-    this.unwatch(state.key);
-  }
-}
-
-module.exports = RemotePaneWatcher;

package/lib/setup/postinstall.js

@@ -1,38 +0,0 @@
-#!/usr/bin/env node
-
-const { execSync } = require('child_process');
-const { ensureDirectories, PATHS } = require('../utils/paths');
-const { initializeConfig, isInitialized } = require('../config/manager');
-const { ensureHostsFile } = require('../config/hosts');
-const { isTermux } = require('../utils/termux');
-
-function has(command) {
-  try {
-    execSync(`which ${command}`, { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-ensureDirectories();
-ensureHostsFile();
-
-if (!isInitialized()) {
-  initializeConfig({ workspaces: [`${process.env.HOME || ''}/Dev`] });
-}
-
-console.log('');
-console.log('NexusCrew postinstall');
-console.log(`  config: ${PATHS.CONFIG_FILE}`);
-console.log(`  hosts: ${PATHS.HOSTS_FILE}`);
-console.log(`  tmux: ${has('tmux') ? 'OK' : 'missing'}`);
-console.log(`  ssh: ${has('ssh') ? 'OK' : 'missing'}`);
-console.log(`  scp: ${has('scp') ? 'OK' : 'missing'}`);
-console.log(`  whisper-cli: ${has('whisper-cli') ? 'OK' : 'missing'}`);
-if (isTermux()) {
-  console.log('  platform: Termux');
-  console.log(`  termux-services: ${has('sv') ? 'OK' : 'missing'}`);
-}
-console.log('  next: run `nexuscrew setup` to configure workspace, SSH hosts, local STT, and optional Termux boot/runit');
-console.log('');

package/lib/utils/paths.js

@@ -1,124 +0,0 @@
-/**
- * Standard Paths for NexusCrew
- * Termux Mobile First - all paths relative to $HOME
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const HOME = process.env.HOME || os.homedir();
-
-/**
- * NexusCrew standard paths
- */
-const PATHS = {
-  // Main config directory
-  CONFIG_DIR: path.join(HOME, '.nexuscrew'),
-
-  // Config file
-  CONFIG_FILE: path.join(HOME, '.nexuscrew', 'config.json'),
-
-  // Data directory (database, cache)
-  DATA_DIR: path.join(HOME, '.nexuscrew', 'data'),
-
-  // Database file
-  DATABASE: path.join(HOME, '.nexuscrew', 'data', 'nexuscrew.db'),
-
-  // Logs directory
-  LOGS_DIR: path.join(HOME, '.nexuscrew', 'logs'),
-
-  // Server log
-  SERVER_LOG: path.join(HOME, '.nexuscrew', 'logs', 'server.log'),
-
-  // PID file for daemon
-  PID_FILE: path.join(HOME, '.nexuscrew', 'nexuscrew.pid'),
-
-  // Engines config directory
-  ENGINES_DIR: path.join(HOME, '.nexuscrew', 'engines'),
-
-  // Attachments directory
-  ATTACHMENTS_DIR: path.join(HOME, '.nexuscrew', 'attachments'),
-
-  // Local helper binaries
-  BIN_DIR: path.join(HOME, '.nexuscrew', 'bin'),
-
-  // Hosts registry
-  HOSTS_FILE: path.join(HOME, '.nexuscrew', 'hosts.json'),
-
-  // Termux boot script
-  BOOT_SCRIPT: path.join(HOME, '.termux', 'boot', 'nexuscrew-start.sh'),
-
-  // Termux runit service directory
-  TERMUX_SERVICE_DIR: path.join(process.env.PREFIX || '/data/data/com.termux/files/usr', 'var', 'service', 'nexuscrew'),
-
-  // Termux runit logs
-  TERMUX_SERVICE_LOG_DIR: path.join(process.env.PREFIX || '/data/data/com.termux/files/usr', 'var', 'log', 'sv', 'nexuscrew'),
-
-  // Claude CLI history (read-only)
-  CLAUDE_HISTORY: path.join(HOME, '.claude', 'history.jsonl'),
-  CLAUDE_PROJECTS: path.join(HOME, '.claude', 'projects'),
-
-  // Default workspace
-  DEFAULT_WORKSPACE: path.join(HOME, 'Dev')
-};
-
-/**
- * Ensure all required directories exist
- */
-function ensureDirectories() {
-  const dirs = [
-    PATHS.CONFIG_DIR,
-    PATHS.DATA_DIR,
-    PATHS.LOGS_DIR,
-    PATHS.ENGINES_DIR,
-    PATHS.ATTACHMENTS_DIR,
-    PATHS.BIN_DIR
-  ];
-
-  for (const dir of dirs) {
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-  }
-}
-
-/**
- * Ensure Termux boot directory exists
- */
-function ensureBootDirectory() {
-  const bootDir = path.join(HOME, '.termux', 'boot');
-  if (!fs.existsSync(bootDir)) {
-    fs.mkdirSync(bootDir, { recursive: true });
-  }
-  return bootDir;
-}
-
-/**
- * Get path resolving ~ to HOME
- */
-function resolvePath(p) {
-  if (p.startsWith('~')) {
-    return path.join(HOME, p.slice(1));
-  }
-  return path.resolve(p);
-}
-
-/**
- * Get relative path from HOME (for display)
- */
-function toDisplayPath(p) {
-  if (p.startsWith(HOME)) {
-    return '~' + p.slice(HOME.length);
-  }
-  return p;
-}
-
-module.exports = {
-  PATHS,
-  HOME,
-  ensureDirectories,
-  ensureBootDirectory,
-  resolvePath,
-  toDisplayPath
-};