@mmmbuto/nexuscrew 0.2.0 → 0.2.2

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/utils/paths.js

@@ -1,107 +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'),
-
-  // Termux boot script
-  BOOT_SCRIPT: path.join(HOME, '.termux', 'boot', 'nexuscrew-start.sh'),
-
-  // 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
-  ];
-
-  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
-};

package/lib/utils/termux.js

@@ -1,145 +0,0 @@
-/**
- * Termux Detection and Utilities
- */
-
-const fs = require('fs');
-const path = require('path');
-const { execSync, spawn } = require('child_process');
-
-/**
- * Check if running in Termux environment
- */
-function isTermux() {
-  return (
-    process.platform === 'android' ||
-    process.env.PREFIX?.includes('com.termux') ||
-    process.env.TERMUX_VERSION !== undefined
-  );
-}
-
-/**
- * Get Termux prefix path
- */
-function getPrefix() {
-  return process.env.PREFIX || '/data/data/com.termux/files/usr';
-}
-
-/**
- * Check if a Termux package is installed
- */
-function isPackageInstalled(pkg) {
-  try {
-    execSync(`which ${pkg}`, { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Install a Termux package
- */
-function installPackage(pkg) {
-  try {
-    execSync(`pkg install -y ${pkg}`, { stdio: 'inherit' });
-    return true;
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * Check if Termux:API app is working
- */
-function isTermuxApiWorking() {
-  try {
-    execSync('termux-battery-status', { timeout: 5000, stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Check if Termux:Boot is available
- */
-function isTermuxBootAvailable() {
-  const bootDir = path.join(process.env.HOME, '.termux', 'boot');
-  return fs.existsSync(bootDir);
-}
-
-/**
- * Acquire Termux wake lock
- */
-function acquireWakeLock() {
-  if (!isTermux()) return false;
-  try {
-    spawn('termux-wake-lock', [], { detached: true, stdio: 'ignore' }).unref();
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Release Termux wake lock
- */
-function releaseWakeLock() {
-  if (!isTermux()) return false;
-  try {
-    spawn('termux-wake-unlock', [], { detached: true, stdio: 'ignore' }).unref();
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Send Termux notification
- */
-function sendNotification(title, content, id = 'nexuscrew') {
-  if (!isTermux()) return false;
-  try {
-    execSync(`termux-notification --id ${id} --title "${title}" --content "${content}"`, {
-      stdio: 'ignore'
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Get required Termux packages
- */
-function getRequiredPackages() {
-  return ['termux-api', 'termux-tools'];
-}
-
-/**
- * Check all required packages
- */
-function checkRequiredPackages() {
-  const packages = getRequiredPackages();
-  const status = {};
-
-  for (const pkg of packages) {
-    status[pkg] = isPackageInstalled(pkg);
-  }
-
-  return status;
-}
-
-module.exports = {
-  isTermux,
-  getPrefix,
-  isPackageInstalled,
-  installPackage,
-  isTermuxApiWorking,
-  isTermuxBootAvailable,
-  acquireWakeLock,
-  releaseWakeLock,
-  sendNotification,
-  getRequiredPackages,
-  checkRequiredPackages
-};