navada-edge-cli 4.1.0 → 4.2.0

package/lib/agent.js

@@ -175,6 +175,15 @@ function getSystemPrompt() {
     prompt += `\n\n--- MEMORY (auto-loaded) ---\n${memoryContext}`;
   }
 
+  // Inject user skills (so agent knows what skills are available)
+  try {
+    const skills = require('./skills');
+    const skillsPrompt = skills.getSkillsPrompt();
+    if (skillsPrompt) {
+      prompt += `\n\n--- USER SKILLS ---\n${skillsPrompt}`;
+    }
+  } catch {}
+
   return prompt;
 }
 

package/lib/commands/index.js

@@ -6,7 +6,7 @@ const { register } = require('../registry');
 const moduleNames = [
   'network', 'mcp', 'lucas', 'docker', 'database', 'cloudflare',
   'ai', 'azure', 'agents', 'tasks', 'keys', 'setup', 'system',
-  'learn', 'sandbox', 'nvidia', 'edge', 'conversations', 'audit', 'compute',
+  'learn', 'sandbox', 'nvidia', 'edge', 'conversations', 'audit', 'compute', 'skills',
 ];
 
 function loadAll() {

package/lib/commands/setup.js

@@ -211,7 +211,32 @@ async function runSetup(fromRepl = false) {
   const reqDir = path.join(config.CONFIG_DIR, 'requests');
   if (!fs.existsSync(reqDir)) fs.mkdirSync(reqDir, { recursive: true });
 
-  // Step 8: Theme
+  // Step 8: Skills directory + install default skill
+  const skillsDir = path.join(config.CONFIG_DIR, 'skills');
+  if (!fs.existsSync(skillsDir)) fs.mkdirSync(skillsDir, { recursive: true });
+
+  // Offer to install template skills
+  const installSkills = await ask(rl, '  Install starter skills? (Y/n): ');
+  if (installSkills.trim().toLowerCase() !== 'n') {
+    const skills = require('../skills');
+    let installed = 0;
+    for (const [name, tmpl] of Object.entries(skills.TEMPLATES)) {
+      const skillFile = path.join(skillsDir, `${name}.md`);
+      if (!fs.existsSync(skillFile)) {
+        skills.createSkill(name, tmpl);
+        installed++;
+      }
+    }
+    if (installed > 0) {
+      console.log(ui.success(`Installed ${installed} starter skills`));
+      console.log(ui.dim('  View: /skill list  |  Create your own: /skill create'));
+    } else {
+      console.log(ui.dim('  All template skills already installed'));
+    }
+  }
+  console.log('');
+
+  // Step 9: Theme
   const theme = await ask(rl, '  Theme (dark/crow/matrix/light) [dark]: ');
   config.setTheme(theme.trim() || 'dark');
   console.log('');
@@ -222,8 +247,14 @@ async function runSetup(fromRepl = false) {
  Guard:  ${guardrailPath}
 
  Type naturally to chat, or /help for commands.
- Submit automation requests: /automate
- View agent tools: /tools`));
+
+ KEY COMMANDS
+ /tools       — 16 agent tools across 7 categories
+ /skills      — view and manage skills
+ /skill create — create your own reusable skills
+ /skill templates — install ready-made skills
+ /automate    — submit automation requests
+ /about       — learn about NAVADA Edge`));
   console.log('');
 
   rl.close();

package/lib/commands/skills.js

@@ -0,0 +1,209 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const ui = require('../ui');
+const config = require('../config');
+const { style } = require('../theme');
+const skills = require('../skills');
+
+module.exports = function(reg) {
+
+  reg('skill', 'Manage agent skills — create, list, use, delete', async (args) => {
+    const sub = args[0];
+
+    if (!sub || sub === 'help') {
+      console.log(ui.header('NAVADA EDGE — SKILLS'));
+      console.log(ui.dim('  Skills are reusable task templates the agent follows.'));
+      console.log(ui.dim('  Create your own or install from templates.'));
+      console.log('');
+      console.log(ui.cmd('skill list', 'Show all installed skills'));
+      console.log(ui.cmd('skill create', 'Create a new skill interactively'));
+      console.log(ui.cmd('skill create <name>', 'Create from a template'));
+      console.log(ui.cmd('skill show <name>', 'View skill details'));
+      console.log(ui.cmd('skill use <name> [args]', 'Run a skill'));
+      console.log(ui.cmd('skill templates', 'Show available templates'));
+      console.log(ui.cmd('skill install <template>', 'Install a template skill'));
+      console.log(ui.cmd('skill delete <name>', 'Delete a skill'));
+      console.log(ui.cmd('skill edit <name>', 'Open skill in editor'));
+      console.log('');
+      console.log(ui.dim('Skills live in: ~/.navada/skills/<name>.md'));
+      console.log(ui.dim('The agent auto-detects skills from your conversation.'));
+      return;
+    }
+
+    // /skill list
+    if (sub === 'list') {
+      const all = skills.loadAll();
+      console.log(ui.header('INSTALLED SKILLS'));
+      if (all.length === 0) {
+        console.log(ui.dim('No skills installed yet.'));
+        console.log(ui.dim('Get started: /skill templates  or  /skill create'));
+        return;
+      }
+      for (const s of all) {
+        const triggers = s.trigger.length > 0 ? style('dim', ` [${s.trigger.slice(0, 3).join(', ')}]`) : '';
+        console.log(`  ${style('accent', s.title.padEnd(24))} ${style('dim', s.description.slice(0, 50))}${triggers}`);
+      }
+      console.log('');
+      console.log(ui.dim(`${all.length} skill(s) installed. Use: /skill use <name>`));
+      return;
+    }
+
+    // /skill templates
+    if (sub === 'templates') {
+      console.log(ui.header('SKILL TEMPLATES'));
+      console.log(ui.dim('  Ready-made skills you can install in one command.'));
+      console.log('');
+      for (const [key, tmpl] of Object.entries(skills.TEMPLATES)) {
+        console.log(`  ${style('accent', key.padEnd(20))} ${style('dim', tmpl.description)}`);
+      }
+      console.log('');
+      console.log(ui.dim('Install: /skill install seo-audit'));
+      console.log(ui.dim('Or create your own: /skill create'));
+      return;
+    }
+
+    // /skill install <template>
+    if (sub === 'install') {
+      const name = args[1];
+      if (!name) { console.log(ui.error('Usage: /skill install <template-name>')); return; }
+      const tmpl = skills.TEMPLATES[name];
+      if (!tmpl) {
+        console.log(ui.error(`Template not found: ${name}`));
+        console.log(ui.dim('Available: ' + Object.keys(skills.TEMPLATES).join(', ')));
+        return;
+      }
+      const filePath = skills.createSkill(name, tmpl);
+      console.log(ui.success(`Skill installed: ${tmpl.title}`));
+      console.log(ui.label('File', filePath));
+      console.log(ui.label('Triggers', tmpl.triggers.join(', ')));
+      console.log(ui.dim('Use it: /skill use ' + name));
+      return;
+    }
+
+    // /skill show <name>
+    if (sub === 'show') {
+      const name = args.slice(1).join(' ');
+      if (!name) { console.log(ui.error('Usage: /skill show <name>')); return; }
+      const s = skills.getSkill(name);
+      if (!s) { console.log(ui.error(`Skill not found: ${name}`)); return; }
+      console.log(ui.header(`SKILL: ${s.title}`));
+      console.log(ui.label('Description', s.description));
+      console.log(ui.label('Triggers', s.trigger.join(', ') || 'none'));
+      console.log(ui.label('File', s.file));
+      console.log('');
+      if (s.steps) {
+        console.log(ui.dim('  Steps:'));
+        console.log(s.steps.split('\n').map(l => '    ' + l).join('\n'));
+      }
+      if (s.output) {
+        console.log('');
+        console.log(ui.dim('  Output:'));
+        console.log('    ' + s.output);
+      }
+      return;
+    }
+
+    // /skill use <name> [context]
+    if (sub === 'use') {
+      const name = args[1];
+      if (!name) { console.log(ui.error('Usage: /skill use <name> [context]')); return; }
+      const s = skills.getSkill(name);
+      if (!s) { console.log(ui.error(`Skill not found: ${name}`)); return; }
+
+      const context = args.slice(2).join(' ');
+      const prompt = `Execute this skill:\n\n${s.raw}\n\n${context ? `User context: ${context}` : 'Run the skill now.'}`;
+
+      // Route to chat
+      try {
+        const { chat, addToHistory } = require('../agent');
+        addToHistory('user', prompt);
+        console.log(ui.dim(`  Running skill: ${s.title}...`));
+        console.log('');
+        const response = await chat(prompt);
+        if (response) addToHistory('assistant', response);
+      } catch (e) {
+        console.log(ui.error(`Skill execution failed: ${e.message}`));
+      }
+      return;
+    }
+
+    // /skill create (interactive)
+    if (sub === 'create') {
+      // If a template name is given, install it
+      if (args[1] && skills.TEMPLATES[args[1]]) {
+        const tmpl = skills.TEMPLATES[args[1]];
+        const filePath = skills.createSkill(args[1], tmpl);
+        console.log(ui.success(`Skill created from template: ${tmpl.title}`));
+        console.log(ui.label('File', filePath));
+        return;
+      }
+
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+      const ask = (q) => new Promise(resolve => rl.question(q, resolve));
+
+      console.log(ui.header('CREATE A SKILL'));
+      console.log(ui.dim('  A skill is a reusable task the agent can follow.'));
+      console.log('');
+
+      const title = await ask('  Skill name: ');
+      if (!title.trim()) { console.log(ui.error('Name is required.')); rl.close(); return; }
+
+      const description = await ask('  Description: ');
+      const triggersRaw = await ask('  Trigger phrases (comma-separated): ');
+      const steps = await ask('  Steps (or press Enter for default): ');
+      const output = await ask('  Expected output: ');
+
+      const data = {
+        title: title.trim(),
+        description: description.trim() || title.trim(),
+        triggers: triggersRaw.split(',').map(t => t.trim().toLowerCase()).filter(Boolean),
+        steps: steps.trim() || undefined,
+        output: output.trim() || undefined,
+      };
+
+      const filePath = skills.createSkill(title.trim(), data);
+      console.log('');
+      console.log(ui.success(`Skill created: ${data.title}`));
+      console.log(ui.label('File', filePath));
+      console.log(ui.dim('Edit it: /skill edit ' + path.basename(filePath, '.md')));
+      console.log(ui.dim('Use it: /skill use ' + path.basename(filePath, '.md')));
+      rl.close();
+      return;
+    }
+
+    // /skill delete <name>
+    if (sub === 'delete' || sub === 'rm') {
+      const name = args.slice(1).join(' ');
+      if (!name) { console.log(ui.error('Usage: /skill delete <name>')); return; }
+      if (skills.deleteSkill(name)) {
+        console.log(ui.success(`Deleted skill: ${name}`));
+      } else {
+        console.log(ui.error(`Skill not found: ${name}`));
+      }
+      return;
+    }
+
+    // /skill edit <name>
+    if (sub === 'edit') {
+      const name = args.slice(1).join(' ');
+      if (!name) { console.log(ui.error('Usage: /skill edit <name>')); return; }
+      const s = skills.getSkill(name);
+      if (!s) { console.log(ui.error(`Skill not found: ${name}`)); return; }
+      try {
+        const { exec } = require('child_process');
+        const editor = process.env.EDITOR || (process.platform === 'win32' ? 'notepad' : 'nano');
+        exec(`${editor} "${s.file}"`);
+        console.log(ui.success(`Opening ${s.file} in ${editor}...`));
+      } catch {
+        console.log(ui.label('File', s.file));
+        console.log(ui.dim('Open this file in your editor.'));
+      }
+      return;
+    }
+
+    console.log(ui.dim('Unknown subcommand. Try /skill help'));
+  }, { category: 'SKILLS', subs: ['list', 'create', 'show', 'use', 'templates', 'install', 'delete', 'edit', 'help'], aliases: ['skills'] });
+};

package/lib/commands/system.js

@@ -441,6 +441,71 @@ module.exports = function(reg) {
     console.log(ui.dim('For automation setup on 24/7 cloud: /automate'));
   }, { category: 'SYSTEM' });
 
+  // --- /about ---
+  reg('about', 'About the NAVADA Edge agent and network', () => {
+    console.log(ui.header('NAVADA EDGE'));
+    console.log('');
+    console.log('  ' + style('accent', 'Name')       + '         NAVADA Edge');
+    console.log('  ' + style('accent', 'Born')       + '         December 2024, London, United Kingdom');
+    console.log('  ' + style('accent', 'Version')    + '      v' + require('../../package.json').version);
+    console.log('  ' + style('accent', 'Species')    + '      AI Terminal Agent');
+    console.log('  ' + style('accent', 'Purpose')    + '      Make AI accessible from the command line');
+    console.log('');
+    console.log(ui.dim('  ── ORIGIN STORY ──'));
+    console.log('');
+    console.log(ui.dim('  NAVADA was born from a simple idea: what if your terminal'));
+    console.log(ui.dim('  understood you? Not just commands — but context, memory,'));
+    console.log(ui.dim('  and intent. Built by Lee Akpareva, a Principal AI Consultant'));
+    console.log(ui.dim('  with 17+ years in enterprise IT, NAVADA started as a home'));
+    console.log(ui.dim('  server experiment and grew into a distributed AI network'));
+    console.log(ui.dim('  spanning 5 nodes across 3 countries.'));
+    console.log('');
+    console.log(ui.dim('  ── WHAT I AM ──'));
+    console.log('');
+    console.log(ui.dim('  I am an AI agent that lives in your terminal. I have 16 tools,'));
+    console.log(ui.dim('  a 3-tier memory system, and I learn who you are over time.'));
+    console.log(ui.dim('  I can write code, analyse data, manage files, take screenshots,'));
+    console.log(ui.dim('  search the web, and remember everything we discuss.'));
+    console.log('');
+    console.log(ui.dim('  I support 5 AI providers — bring your own model or use the'));
+    console.log(ui.dim('  free NVIDIA tier. Every provider gets full tool access.'));
+    console.log('');
+    console.log(ui.dim('  ── THE NETWORK ──'));
+    console.log('');
+    console.log(ui.dim('  NAVADA Edge Network is a distributed computing platform:'));
+    console.log(ui.dim('  • 5 nodes connected via encrypted Tailscale VPN'));
+    console.log(ui.dim('  • 29+ Docker containers across AWS, Azure, Oracle Cloud'));
+    console.log(ui.dim('  • Cloudflare tunnel with 13 subdomains'));
+    console.log(ui.dim('  • 24/7 monitoring, health checks, auto-restart'));
+    console.log(ui.dim('  • Automation pipeline for user-requested tasks'));
+    console.log('');
+    console.log(ui.dim('  ── PHILOSOPHY ──'));
+    console.log('');
+    console.log(ui.dim('  The terminal is the foundation of computing. Every server,'));
+    console.log(ui.dim('  every cloud platform, every CI/CD pipeline runs on text'));
+    console.log(ui.dim('  commands. NAVADA doesn\'t replace the terminal — it makes'));
+    console.log(ui.dim('  it conversational. You describe what you want, the agent'));
+    console.log(ui.dim('  figures out how to do it.'));
+    console.log('');
+    console.log(ui.dim('  ── FOUNDER ──'));
+    console.log('');
+    console.log('  ' + style('accent', 'Leslie (Lee) Akpareva'));
+    console.log(ui.dim('  Principal AI Consultant | MBA, MA | EF8 Alumni'));
+    console.log(ui.dim('  17+ years: enterprise IT, insurance, AI infrastructure'));
+    console.log(ui.dim('  Currently: AI Project Lead at Generali UK'));
+    console.log('');
+    console.log(ui.dim('  github.com/leeakpareva'));
+    console.log(ui.dim('  navada-lab.space'));
+    console.log('');
+    console.log(ui.dim('  ── LINKS ──'));
+    console.log('');
+    console.log(ui.label('Portal', 'https://portal.navada-edge-server.uk'));
+    console.log(ui.label('npm', 'npmjs.com/package/navada-edge-cli'));
+    console.log(ui.label('SDK', 'npmjs.com/package/navada-edge-sdk'));
+    console.log(ui.label('GitHub', 'github.com/Navada25/edge-sdk'));
+    console.log('');
+  }, { category: 'SYSTEM', aliases: ['info', 'whoami'] });
+
   // --- /clear ---
   reg('clear', 'Clear screen', () => {
     console.clear();

package/lib/skills.js

@@ -0,0 +1,222 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const config = require('./config');
+
+const SKILLS_DIR = path.join(config.CONFIG_DIR, 'skills');
+
+function ensureDir() {
+  if (!fs.existsSync(SKILLS_DIR)) fs.mkdirSync(SKILLS_DIR, { recursive: true });
+}
+
+// Parse a skill markdown file into structured data
+function parseSkill(filePath) {
+  try {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const lines = raw.split('\n');
+    const skill = {
+      name: path.basename(filePath, '.md'),
+      file: filePath,
+      title: '',
+      trigger: [],
+      description: '',
+      steps: '',
+      output: '',
+      raw,
+    };
+
+    let section = 'header';
+    const sectionContent = { steps: [], output: [] };
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+
+      // Title
+      if (trimmed.startsWith('# ') && !skill.title) {
+        skill.title = trimmed.slice(2).trim();
+        continue;
+      }
+
+      // Metadata lines
+      if (trimmed.startsWith('trigger:')) {
+        skill.trigger = trimmed.slice(8).split(',').map(t => t.trim().replace(/"/g, '').toLowerCase()).filter(Boolean);
+        continue;
+      }
+      if (trimmed.startsWith('description:')) {
+        skill.description = trimmed.slice(12).trim();
+        continue;
+      }
+
+      // Section headers
+      if (trimmed.startsWith('## Steps')) { section = 'steps'; continue; }
+      if (trimmed.startsWith('## Output')) { section = 'output'; continue; }
+      if (trimmed.startsWith('## ')) { section = 'other'; continue; }
+
+      if (section === 'steps') sectionContent.steps.push(line);
+      if (section === 'output') sectionContent.output.push(line);
+    }
+
+    skill.steps = sectionContent.steps.join('\n').trim();
+    skill.output = sectionContent.output.join('\n').trim();
+    if (!skill.title) skill.title = skill.name;
+    if (!skill.description) skill.description = skill.title;
+
+    return skill;
+  } catch (e) {
+    return null;
+  }
+}
+
+// Load all skills
+function loadAll() {
+  ensureDir();
+  try {
+    const files = fs.readdirSync(SKILLS_DIR).filter(f => f.endsWith('.md'));
+    return files.map(f => parseSkill(path.join(SKILLS_DIR, f))).filter(Boolean);
+  } catch { return []; }
+}
+
+// Find a skill by trigger phrase
+function matchSkill(input) {
+  const lower = input.toLowerCase();
+  const skills = loadAll();
+
+  for (const skill of skills) {
+    for (const trigger of skill.trigger) {
+      if (lower.includes(trigger)) return skill;
+    }
+  }
+  return null;
+}
+
+// Get skill by name
+function getSkill(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+  const filePath = path.join(SKILLS_DIR, `${slug}.md`);
+  if (fs.existsSync(filePath)) return parseSkill(filePath);
+
+  // Try partial match
+  ensureDir();
+  const files = fs.readdirSync(SKILLS_DIR).filter(f => f.endsWith('.md'));
+  const match = files.find(f => f.toLowerCase().includes(slug));
+  if (match) return parseSkill(path.join(SKILLS_DIR, match));
+  return null;
+}
+
+// Create a new skill from structured data
+function createSkill(name, data) {
+  ensureDir();
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+  const filePath = path.join(SKILLS_DIR, `${slug}.md`);
+
+  const content = `# ${data.title || name}
+trigger: ${(data.triggers || []).map(t => `"${t}"`).join(', ')}
+description: ${data.description || ''}
+
+## Steps
+${data.steps || '1. Analyse the request\n2. Execute the task\n3. Return the result'}
+
+## Output
+${data.output || 'Formatted result based on the task'}
+`;
+
+  fs.writeFileSync(filePath, content);
+  return filePath;
+}
+
+// Delete a skill
+function deleteSkill(name) {
+  const skill = getSkill(name);
+  if (!skill) return false;
+  try {
+    fs.unlinkSync(skill.file);
+    return true;
+  } catch { return false; }
+}
+
+// Get skills summary for system prompt injection
+function getSkillsPrompt() {
+  const skills = loadAll();
+  if (skills.length === 0) return '';
+
+  const lines = ['Available user skills (invoke when request matches):'];
+  for (const s of skills) {
+    lines.push(`- "${s.title}": ${s.description}. Triggers: ${s.trigger.join(', ') || 'manual'}. Steps: ${s.steps.slice(0, 150)}`);
+  }
+  return lines.join('\n');
+}
+
+// Built-in skill templates
+const TEMPLATES = {
+  'seo-audit': {
+    title: 'SEO Audit',
+    triggers: ['seo audit', 'check seo', 'analyse website seo'],
+    description: 'Run a comprehensive SEO audit on any URL',
+    steps: `1. Use shell to curl the target URL and capture HTML
+2. Use python_exec to parse HTML — extract title, meta description, h1-h6 tags, img alt attributes, internal/external links
+3. Check: title length (50-60 chars), meta description (150-160 chars), heading hierarchy, missing alt text, broken links
+4. Score each category out of 10
+5. Generate a markdown report with scores and actionable recommendations`,
+    output: 'Markdown report: overall score, category breakdown, top 5 fixes',
+  },
+  'email-template': {
+    title: 'Marketing Email',
+    triggers: ['marketing email', 'email template', 'write email campaign'],
+    description: 'Generate a professional marketing email template',
+    steps: `1. Ask for: target audience, product/service, tone, call-to-action
+2. Write subject line (under 50 chars, no spam words)
+3. Write preview text (90 chars)
+4. Write email body: hook, value proposition, social proof, CTA
+5. Save as HTML file with inline CSS for email client compatibility`,
+    output: 'HTML email template file + plain text version',
+  },
+  'api-scaffold': {
+    title: 'REST API Scaffold',
+    triggers: ['scaffold api', 'create api', 'generate api project'],
+    description: 'Generate a complete REST API project with routes, models, and tests',
+    steps: `1. Ask for: language (Node/Python/Go), database, entity names
+2. Create project directory with standard structure
+3. Generate: package.json/requirements.txt, entry point, routes, models, middleware
+4. Add: error handling, validation, health endpoint, CORS
+5. Generate: Dockerfile, .env.example, README with API docs
+6. Run initial install and verify it starts`,
+    output: 'Complete project directory, ready to run',
+  },
+  'git-pr': {
+    title: 'Git PR Creator',
+    triggers: ['create pr', 'pull request', 'git pr'],
+    description: 'Analyse changes and create a well-documented pull request',
+    steps: `1. Run git diff to see all changes
+2. Run git log to see commit history since branch point
+3. Categorise changes: features, fixes, refactors, tests
+4. Write PR title (under 72 chars, conventional commit style)
+5. Write PR body: summary, changes list, testing notes, screenshots if UI
+6. Use shell to create the PR via gh cli`,
+    output: 'PR created with full description and labels',
+  },
+  'data-report': {
+    title: 'Data Report Generator',
+    triggers: ['analyse data', 'data report', 'generate report from'],
+    description: 'Analyse a data file and produce a visual report',
+    steps: `1. Read the data file (CSV, JSON, Excel)
+2. Use python_exec with pandas: shape, dtypes, null counts, describe()
+3. Identify key patterns: trends, outliers, correlations
+4. Generate visualisations with matplotlib (save as PNG)
+5. Write a markdown summary report with embedded charts
+6. Save report as HTML for easy sharing`,
+    output: 'HTML report with charts, summary statistics, and insights',
+  },
+};
+
+module.exports = {
+  SKILLS_DIR,
+  loadAll,
+  matchSkill,
+  getSkill,
+  createSkill,
+  deleteSkill,
+  parseSkill,
+  getSkillsPrompt,
+  TEMPLATES,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "navada-edge-cli",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "AI agent in your terminal — 3-tier memory, 16 tools, automation pipeline, bring your own model. Learns who you are, remembers across sessions.",
   "main": "lib/cli.js",
   "bin": {