@p31/andromeda-cli 1.0.0

package/mcp-server.js

@@ -0,0 +1,364 @@
+#!/usr/bin/env node
+
+// ═════════════════════════════════════════════════════════════════════════════
+// P31 Oasis MCP Server — Model Context Protocol interface for CLI agents
+// Exposes session state, design tokens, and slash-command execution via JSON-RPC
+// ═════════════════════════════════════════════════════════════════════════════
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const yaml = require('yaml');
+const { execSync } = require('child_process');
+
+const SESSION_DIR = path.join(os.homedir(), '.p31');
+const SESSION_FILE = path.join(SESSION_DIR, 'cli-session.json');
+const DESIGN_PATH = path.join(__dirname, '..', 'DESIGN.md');
+
+// ─── Session I/O ─────────────────────────────────────────────────────────────
+
+function loadSession() {
+  const defaults = { theme: 'warm', todos: [], log: [], mode: 'BUILD', sandboxCwd: process.cwd() };
+  try {
+    if (fs.existsSync(SESSION_FILE)) {
+      const raw = fs.readFileSync(SESSION_FILE, 'utf-8');
+      const saved = JSON.parse(raw);
+      return { ...defaults, ...saved };
+    }
+  } catch (_) { /* corrupt → fresh */ }
+  return defaults;
+}
+
+function saveSession(data) {
+  try {
+    fs.mkdirSync(SESSION_DIR, { recursive: true });
+    fs.writeFileSync(SESSION_FILE, JSON.stringify({ ...data, savedAt: new Date().toISOString() }, null, 2));
+    return true;
+  } catch (_) { return false; }
+}
+
+// ─── Design Tokens ───────────────────────────────────────────────────────────
+
+function loadDesign() {
+  try {
+    const raw = fs.readFileSync(DESIGN_PATH, 'utf8');
+    const match = raw.match(/^---\n([\s\S]*?)\n---/);
+    if (match) return yaml.parse(match[1]) || {};
+  } catch (_) { /* ignore */ }
+  return {};
+}
+
+// ─── Tool Definitions ────────────────────────────────────────────────────────
+
+const TOOLS = [
+  {
+    name: 'oasis_status',
+    description: 'Get current CLI session state, design tokens, and capabilities. Equivalent to `andromeda --agent`.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'oasis_save',
+    description: 'Persist the current session state (theme, todos, log, mode) to ~/.p31/cli-session.json.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'oasis_theme',
+    description: 'Switch the CLI theme. Persists to session.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', enum: ['cyberpunk', 'nord', 'dracula', 'catppuccin', 'warm'], description: 'Theme name' },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'oasis_mode',
+    description: 'Set the CLI working mode. Persists to session.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', enum: ['BUILD', 'PLAN', 'REVIEW', 'DEBUG'], description: 'Mode name (auto-uppercased)' },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'oasis_clear',
+    description: 'Clear the in-memory log buffer.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'oasis_export_log',
+    description: 'Export the session log to a timestamped text file in the current directory.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'oasis_sandbox_clear',
+    description: 'Clear the sandbox pane content (in-memory).',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'oasis_notify',
+    description: 'Queue a test notification message.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        message: { type: 'string', description: 'Notification text' },
+        type: { type: 'string', enum: ['info', 'ok', 'warn', 'err'], description: 'Notification severity' },
+      },
+    },
+  },
+  {
+    name: 'oasis_add_todo',
+    description: 'Add a todo item to the session.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        text: { type: 'string', description: 'Todo description' },
+      },
+      required: ['text'],
+    },
+  },
+  {
+    name: 'oasis_toggle_todo',
+    description: 'Toggle a todo item\'s done state by index (0-based).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        index: { type: 'number', description: '0-based index of the todo to toggle' },
+      },
+      required: ['index'],
+    },
+  },
+  {
+    name: 'oasis_execute',
+    description: 'Execute a shell command in the session sandbox directory. Returns stdout, stderr, and exit code. Use for file operations, git commands, npm scripts, etc.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        command: { type: 'string', description: 'Shell command to execute' },
+        timeout: { type: 'number', description: 'Timeout in milliseconds (default: 30000)' },
+      },
+      required: ['command'],
+    },
+  },
+];
+
+// ─── Tool Execution ──────────────────────────────────────────────────────────
+
+function executeTool(name, args) {
+  const session = loadSession();
+
+  switch (name) {
+    case 'oasis_status': {
+      const design = loadDesign();
+      return {
+        version: require('./package.json').version,
+        mode: session.mode,
+        theme: session.theme,
+        todos: session.todos.map(t => ({ text: t.text || t, done: t.done || false })),
+        sandboxCwd: session.sandboxCwd,
+        design: {
+          colors: design.colors || {},
+          typography: design.typography || {},
+          rounded: design.rounded || {},
+          spacing: design.spacing || {},
+          components: design.components || {},
+        },
+        capabilities: {
+          slashCommands: ['/exit', '/clear', '/sandbox clear', '/export log', '/save', '/notify test', '/help', '/theme <name>', '/mode <name>'],
+          themes: ['cyberpunk', 'nord', 'dracula', 'catppuccin', 'warm'],
+          modes: ['BUILD', 'PLAN', 'REVIEW', 'DEBUG'],
+        },
+        status: 'ok',
+      };
+    }
+
+    case 'oasis_save': {
+      const ok = saveSession(session);
+      return { saved: ok, path: SESSION_FILE, status: ok ? 'ok' : 'error' };
+    }
+
+    case 'oasis_theme': {
+      const themes = ['cyberpunk', 'nord', 'dracula', 'catppuccin', 'warm'];
+      const name = (args.name || '').toLowerCase();
+      if (!themes.includes(name)) {
+        return { error: `Unknown theme "${name}". Options: ${themes.join(', ')}`, status: 'error' };
+      }
+      session.theme = name;
+      saveSession(session);
+      return { theme: name, saved: true, status: 'ok' };
+    }
+
+    case 'oasis_mode': {
+      const name = (args.name || 'BUILD').toUpperCase();
+      session.mode = name;
+      saveSession(session);
+      return { mode: name, saved: true, status: 'ok' };
+    }
+
+    case 'oasis_clear': {
+      session.log = [];
+      saveSession(session);
+      return { cleared: true, status: 'ok' };
+    }
+
+    case 'oasis_export_log': {
+      const ts = Date.now();
+      const filename = `p31-oasis-log-${ts}.txt`;
+      const clean = (session.log || []).join('\n');
+      try {
+        fs.writeFileSync(filename, clean);
+        return { file: filename, lines: session.log.length, status: 'ok' };
+      } catch (e) {
+        return { error: e.message, status: 'error' };
+      }
+    }
+
+    case 'oasis_sandbox_clear': {
+      return { cleared: true, note: 'Sandbox output cleared (in-memory). Next command刷新es it.', status: 'ok' };
+    }
+
+    case 'oasis_notify': {
+      return {
+        queued: true,
+        message: args.message || 'Test notification',
+        type: args.type || 'info',
+        status: 'ok',
+      };
+    }
+
+    case 'oasis_add_todo': {
+      if (!args.text) return { error: 'text is required', status: 'error' };
+      session.todos.push({ text: args.text, done: false });
+      saveSession(session);
+      return { todo: { text: args.text, done: false }, total: session.todos.length, status: 'ok' };
+    }
+
+    case 'oasis_toggle_todo': {
+      const idx = args.index;
+      if (typeof idx !== 'number' || idx < 0 || idx >= session.todos.length) {
+        return { error: `Invalid index ${idx}. Range: 0–${session.todos.length - 1}`, status: 'error' };
+      }
+      session.todos[idx].done = !session.todos[idx].done;
+      saveSession(session);
+      return { todo: session.todos[idx], index: idx, status: 'ok' };
+    }
+
+    case 'oasis_execute': {
+      if (!args.command) return { error: 'command is required', status: 'error' };
+      const cwd = session.sandboxCwd || process.cwd();
+      const timeout = args.timeout || 30000;
+      try {
+        const stdout = execSync(args.command, {
+          cwd,
+          timeout,
+          maxBuffer: 1024 * 1024,
+          encoding: 'utf8',
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return { stdout: stdout.trim(), exitCode: 0, cwd, status: 'ok' };
+      } catch (e) {
+        return {
+          stdout: (e.stdout || '').trim(),
+          stderr: (e.stderr || '').trim(),
+          exitCode: e.status || 1,
+          cwd,
+          status: e.status === 0 ? 'ok' : 'error',
+        };
+      }
+    }
+
+    default:
+      return { error: `Unknown tool: ${name}`, status: 'error' };
+  }
+}
+
+// ─── JSON-RPC over stdio ─────────────────────────────────────────────────────
+
+let buffer = '';
+
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => {
+  buffer += chunk;
+  const lines = buffer.split('\n');
+  buffer = lines.pop(); // keep incomplete line in buffer
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      const req = JSON.parse(trimmed);
+      handleRequest(req);
+    } catch (e) {
+      // ignore malformed lines
+    }
+  }
+});
+
+function handleRequest(req) {
+  const { id, method, params } = req;
+
+  switch (method) {
+    case 'initialize':
+      respond(id, {
+        protocolVersion: '2024-11-05',
+        capabilities: { tools: {} },
+        serverInfo: { name: 'p31-oasis-mcp', version: '1.0.0' },
+      });
+      break;
+
+    case 'notifications/initialized':
+      // no response needed for notifications
+      break;
+
+    case 'tools/list':
+      respond(id, { tools: TOOLS });
+      break;
+
+    case 'tools/call': {
+      const toolName = params?.name;
+      const toolArgs = params?.arguments || {};
+      const tool = TOOLS.find(t => t.name === toolName);
+      if (!tool) {
+        respondError(id, -32602, `Unknown tool: ${toolName}`);
+        break;
+      }
+      try {
+        const result = executeTool(toolName, toolArgs);
+        const content = [{ type: 'text', text: JSON.stringify(result, null, 2) }];
+        respond(id, { content });
+      } catch (e) {
+        respond(id, {
+          content: [{ type: 'text', text: JSON.stringify({ error: e.message, status: 'error' }) }],
+          isError: true,
+        });
+      }
+      break;
+    }
+
+    case 'ping':
+      respond(id, {});
+      break;
+
+    default:
+      if (id !== undefined) {
+        respondError(id, -32601, `Method not found: ${method}`);
+      }
+  }
+}
+
+function respond(id, result) {
+  const msg = JSON.stringify({ jsonrpc: '2.0', id, result });
+  process.stdout.write(msg + '\n');
+}
+
+function respondError(id, code, message) {
+  const msg = JSON.stringify({ jsonrpc: '2.0', id, error: { code, message } });
+  process.stdout.write(msg + '\n');
+}
+
+// ─── Entry ───────────────────────────────────────────────────────────────────
+
+process.stderr.write('[p31-oasis-mcp] Server started. Listening on stdin (JSON-RPC).\n');

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@p31/andromeda-cli",
+  "version": "1.0.0",
+  "description": "Sovereign, agent-native CLI for the P31 ecosystem — Oasis TUI, MCP server, and --agent JSON mode for AI agents and CI/CD.",
+  "main": "index.js",
+  "bin": {
+    "andromeda": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "dev": "nodemon index.js",
+    "test": "jest",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "index.js",
+    "mcp-server.js",
+    "component-registry.js",
+    "design-tokens-registry.js",
+    "README.md",
+    "SECURITY.md",
+    "config/",
+    "scripts/postinstall.js"
+  ],
+  "dependencies": {
+    "axios": "^1.4.0",
+    "bcrypt": "^5.1.0",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.3",
+    "commander": "^11.0.0",
+    "crypto": "^1.0.1",
+    "dotenv": "^16.3.1",
+    "envfile": "^6.1.0",
+    "figlet": "^1.5.2",
+    "fs-extra": "^11.1.1",
+    "inquirer": "^8.2.5",
+    "jsonwebtoken": "^9.0.2",
+    "node-cron": "^3.0.2",
+    "ora": "^8.0.1",
+    "progress": "^2.0.3",
+    "update-notifier": "^6.0.2",
+    "yaml": "^2.3.1"
+  },
+  "optionalDependencies": {
+    "blessed": "^0.1.81",
+    "blessed-contrib": "^4.11.0",
+    "node-pty": "^1.0.0"
+  },
+  "devDependencies": {
+    "babel-cli": "6.26.0",
+    "babel-preset-env": "^1.7.0",
+    "jest": "^29.6.1",
+    "nodemon": "^3.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/p31labs/P31-local-workspace.git"
+  },
+  "bugs": {
+    "url": "https://github.com/p31labs/P31-local-workspace/issues"
+  },
+  "homepage": "https://p31ca.org/cli",
+  "author": "P31 Labs",
+  "license": "MIT",
+  "keywords": [
+    "cli",
+    "agent-native",
+    "neuroinclusive",
+    "MCP",
+    "sovereign",
+    "assistive-technology",
+    "p31",
+    "andromeda"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('🔧 P31 Andromeda CLI Post-Installation Setup');
+
+// Create necessary directories
+const directories = [
+  'config',
+  'secrets',
+  'tokens',
+  'logs',
+  'deployment',
+  'monitoring'
+];
+
+directories.forEach(dir => {
+  const dirPath = path.join(__dirname, '..', dir);
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+    console.log(`✅ Created directory: ${dir}`);
+  }
+});
+
+// Create default configuration files
+const defaultConfig = {
+  version: '1.0.0',
+  environment: 'development',
+  services: {
+    frontend: {
+      port: 3000,
+      path: 'software/spaceship-earth'
+    },
+    backend: {
+      port: 3001,
+      path: 'software'
+    },
+    monitoring: {
+      port: 3002,
+      path: 'monitoring'
+    }
+  },
+  oauth: {
+    providers: ['google', 'github', 'discord'],
+    callbackUrl: 'http://localhost:3000/auth/callback'
+  },
+  secrets: {
+    encryption: {
+      algorithm: 'aes-256-gcm',
+      keyLength: 32,
+      ivLength: 16
+    }
+  }
+};
+
+fs.writeFileSync(
+  path.join(__dirname, '..', 'config', 'default.json'),
+  JSON.stringify(defaultConfig, null, 2)
+);
+
+// Create .gitignore for CLI
+const gitignore = `
+# CLI-specific ignores
+node_modules/
+.env.local
+.env.production
+secrets/encrypted.json
+tokens/jwt.json
+logs/*.log
+dist/
+coverage/
+.DS_Store
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+`;
+
+fs.writeFileSync(path.join(__dirname, '..', '.gitignore'), gitignore);
+
+// Make CLI executable
+const cliPath = path.join(__dirname, '..', 'index.js');
+try {
+  fs.chmodSync(cliPath, '755');
+  console.log('✅ CLI executable permissions set');
+} catch (error) {
+  console.log('⚠️ Could not set executable permissions (Windows)');
+}
+
+console.log('✅ P31 Andromeda CLI setup complete!');
+console.log('');
+console.log('🚀 Quick Start:');
+console.log('  andromeda setup    # Complete environment setup');
+console.log('  andromeda dev      # Start development environment');
+console.log('  andromeda launch   # Launch production environment');
+console.log('');
+console.log('📚 For more commands, run: andromeda --help');