@robbiesrobotics/alice-agents 1.2.9 → 1.3.1

package/README.md

@@ -139,7 +139,7 @@ If you're already running NemoClaw, A.L.I.C.E. works out of the box — no extra
 
 - [OpenClaw](https://openclaw.ai) or [NemoClaw](https://nemoclaw.com) installed and configured
 - Node.js 18+
-- At least one AI provider configured in OpenClaw (Anthropic, OpenAI, Ollama, or any other supported provider)
+- At least one model configured in OpenClaw or NemoClaw — no specific API key required. A.L.I.C.E. uses whatever you already have set up.
 
 ## License
 

package/bin/alice-install.mjs

@@ -1,10 +1,19 @@
 #!/usr/bin/env node
 
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
 import { runInstall, runUninstall } from '../lib/installer.mjs';
+import { runDoctor } from '../lib/doctor.mjs';
 
 const args = process.argv.slice(2);
 const flags = new Set(args);
 
+if (flags.has('--version') || flags.has('-v')) {
+  const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url)));
+  console.log(pkg.version);
+  process.exit(0);
+}
+
 if (flags.has('--help') || flags.has('-h')) {
   console.log(`
   alice-agents — A.L.I.C.E. Agent Framework Installer
@@ -12,17 +21,33 @@ if (flags.has('--help') || flags.has('-h')) {
   Usage:
     npx @robbiesrobotics/alice-agents              Interactive install
     npx @robbiesrobotics/alice-agents --yes        Non-interactive install with defaults
+    npx @robbiesrobotics/alice-agents --update     Non-interactive upgrade to latest agents
     npx @robbiesrobotics/alice-agents --uninstall  Remove A.L.I.C.E. agents from config
+    npx @robbiesrobotics/alice-agents --doctor     Run diagnostics on your A.L.I.C.E. install
+    npx @robbiesrobotics/alice-agents --version    Show version
     npx @robbiesrobotics/alice-agents --help       Show this help
 
   Options:
     --yes         Skip prompts, use defaults (Sonnet, Starter tier)
+    --update      Non-interactive upgrade (alias for --yes with upgrade mode)
     --uninstall   Remove A.L.I.C.E. agents (preserves non-ALICE agents)
+    --doctor      Run diagnostics and check install health
+    --version     Print package version
   `);
   process.exit(0);
 }
 
-if (flags.has('--uninstall')) {
+if (flags.has('--doctor')) {
+  runDoctor().then((ok) => process.exit(ok ? 0 : 1)).catch((err) => {
+    console.error('  ❌ Doctor failed:', err.message);
+    process.exit(1);
+  });
+} else if (flags.has('--update')) {
+  runInstall({ yes: true, modeOverride: 'upgrade' }).catch((err) => {
+    console.error('  ❌ Update failed:', err.message);
+    process.exit(1);
+  });
+} else if (flags.has('--uninstall')) {
   runUninstall({ yes: flags.has('--yes') }).catch((err) => {
     console.error('  ❌ Uninstall failed:', err.message);
     process.exit(1);

package/lib/doctor.mjs

@@ -0,0 +1,202 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { execSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOME = homedir();
+const OPENCLAW_DIR = join(HOME, '.openclaw');
+
+const STARTER_AGENTS = [
+  'olivia', 'dylan', 'selena', 'devon', 'quinn',
+  'felix', 'daphne', 'rowan', 'darius', 'sophie',
+];
+
+function check(label, ok, hint) {
+  const icon = ok ? '✓' : '✗';
+  console.log(`  ${icon}  ${label}`);
+  if (!ok && hint) console.log(`     → ${hint}`);
+  return ok;
+}
+
+function getRuntime() {
+  try {
+    const v = execSync('nemoclaw --version', { stdio: 'pipe', encoding: 'utf8' }).trim();
+    return { name: 'NemoClaw', ok: true, version: v };
+  } catch {}
+  try {
+    const v = execSync('openclaw --version', { stdio: 'pipe', encoding: 'utf8' }).trim();
+    return { name: 'OpenClaw', ok: true, version: v };
+  } catch {}
+  return { name: 'openclaw/nemoclaw', ok: false, version: null };
+}
+
+function loadConfig() {
+  const configPath = join(OPENCLAW_DIR, 'openclaw.json');
+  if (!existsSync(configPath)) return null;
+  try {
+    return JSON.parse(readFileSync(configPath, 'utf8'));
+  } catch {
+    return 'invalid';
+  }
+}
+
+export async function runDoctor() {
+  console.log('\n  🩺 A.L.I.C.E. Doctor — Diagnostic Report\n');
+  let allOk = true;
+
+  // 1. Runtime check
+  const runtime = getRuntime();
+  const runtimeOk = check(
+    runtime.ok
+      ? `${runtime.name} installed (${runtime.version})`
+      : `${runtime.name} not found`,
+    runtime.ok,
+    'Install OpenClaw: npm install -g openclaw'
+  );
+  allOk = allOk && runtimeOk;
+
+  // 2. Config exists and valid JSON
+  const configPath = join(OPENCLAW_DIR, 'openclaw.json');
+  const configExists = existsSync(configPath);
+  check('openclaw.json exists', configExists, 'Run: openclaw configure');
+
+  if (!configExists) {
+    allOk = false;
+    console.log('\n  ⚠️  Cannot continue checks — openclaw.json missing.\n');
+    return false;
+  }
+
+  const config = loadConfig();
+  const configValid = config !== null && config !== 'invalid';
+  check(
+    'openclaw.json is valid JSON',
+    configValid,
+    `Fix JSON syntax in ${configPath}`
+  );
+  if (!configValid) {
+    allOk = false;
+    console.log('\n  ⚠️  Cannot continue checks — config is invalid JSON.\n');
+    return false;
+  }
+
+  // 3. A.L.I.C.E. agents in config
+  const configAgents = Array.isArray(config.agents) ? config.agents : [];
+  const agentsInConfig = configAgents
+    .filter((a) => a && STARTER_AGENTS.includes(a.id))
+    .map((a) => a.id);
+
+  const agentsOk = agentsInConfig.length > 0;
+  check(
+    agentsOk
+      ? `A.L.I.C.E. agents in config: ${agentsInConfig.join(', ')}`
+      : 'No A.L.I.C.E. agents found in config',
+    agentsOk,
+    'Run: npx @robbiesrobotics/alice-agents to install'
+  );
+  allOk = allOk && agentsOk;
+
+  // Check for missing agents from full starter set
+  if (agentsInConfig.length > 0 && agentsInConfig.length < STARTER_AGENTS.length) {
+    const missing = STARTER_AGENTS.filter((id) => !agentsInConfig.includes(id));
+    check(
+      `All starter agents present (missing: ${missing.join(', ')})`,
+      false,
+      'Run: npx @robbiesrobotics/alice-agents --update'
+    );
+    allOk = false;
+  } else if (agentsInConfig.length === STARTER_AGENTS.length) {
+    check('All starter agents present', true);
+  }
+
+  // 4. Agent workspaces exist on disk
+  if (agentsInConfig.length > 0) {
+    let missingWorkspaces = [];
+    for (const id of agentsInConfig) {
+      const wsDir = join(OPENCLAW_DIR, `workspace-${id}`);
+      if (!existsSync(wsDir)) {
+        missingWorkspaces.push(id);
+      }
+    }
+    const workspacesOk = missingWorkspaces.length === 0;
+    check(
+      workspacesOk
+        ? `Agent workspaces exist (${agentsInConfig.length})`
+        : `Agent workspaces missing: ${missingWorkspaces.join(', ')}`,
+      workspacesOk,
+      'Run: npx @robbiesrobotics/alice-agents --update to scaffold missing workspaces'
+    );
+    allOk = allOk && workspacesOk;
+  }
+
+  // 5. At least one model/provider configured
+  let modelOk = false;
+  let modelLabel = null;
+
+  if (config.default_model) {
+    modelOk = true;
+    modelLabel = config.default_model;
+  } else if (config.models && Object.keys(config.models).length > 0) {
+    modelOk = true;
+    modelLabel = Object.keys(config.models)[0];
+  } else if (config.providers && Object.keys(config.providers).length > 0) {
+    modelOk = true;
+    modelLabel = Object.keys(config.providers)[0];
+  } else if (config.llm && Object.keys(config.llm).length > 0) {
+    modelOk = true;
+    modelLabel = Object.keys(config.llm)[0];
+  }
+
+  check(
+    modelOk
+      ? `Model/provider configured: ${modelLabel}`
+      : 'No model/provider configured',
+    modelOk,
+    'Run: openclaw configure to set up a model provider'
+  );
+  allOk = allOk && modelOk;
+
+  // 6. License check
+  const { checkProLicense } = await import('./license.mjs');
+  const manifest = (() => {
+    try {
+      const mPath = join(OPENCLAW_DIR, '.alice-manifest.json');
+      if (!existsSync(mPath)) return null;
+      return JSON.parse(readFileSync(mPath, 'utf8'));
+    } catch {
+      return null;
+    }
+  })();
+
+  const licenseResult = await checkProLicense();
+  if (manifest?.tier === 'pro' || licenseResult.licensed) {
+    if (licenseResult.licensed) {
+      const maskedKey = licenseResult.key.slice(0, 13) + '****';
+      check(
+        `Pro license: ${maskedKey} (stored at ~/.alice/license)`,
+        true
+      );
+    } else {
+      check(
+        'Pro license: not found (running Starter tier)',
+        false,
+        'Purchase a Pro license at: https://getalice.av3.ai/pricing'
+      );
+      allOk = false;
+    }
+  } else {
+    // Starter tier — just note no license needed
+    check('License: Starter tier (no license required)', true);
+  }
+
+  // Summary
+  console.log();
+  if (allOk) {
+    console.log('  ✅ A.L.I.C.E. is healthy!\n');
+  } else {
+    console.log('  ⚠️  Issues found — follow the hints above to fix them.\n');
+  }
+
+  return allOk;
+}

package/lib/installer.mjs

@@ -11,6 +11,7 @@ import {
   promptModelPreset,
   promptCustomModel,
   promptTier,
+  promptLicenseKey,
   confirm,
   choose,
   input,
@@ -253,7 +254,9 @@ export async function runInstall(options = {}) {
 
   // 2. Install mode
   let mode;
-  if (auto) {
+  if (options.modeOverride) {
+    mode = options.modeOverride;
+  } else if (auto) {
     const manifest = readManifest();
     mode = manifest ? 'upgrade' : 'fresh';
   } else {
@@ -309,22 +312,58 @@ export async function runInstall(options = {}) {
   }
 
   if (tier === 'pro') {
-    console.log();
-    console.log('  \ud83d\udd12 Pro Tier \u2014 Authentication Required');
-    console.log();
-    console.log('  Pro unlocks 18 additional specialist agents:');
-    console.log('  \ud83d\udc65 Hannah (HR)  \ud83d\udcc8 Aiden (Analytics)  \u270d\ufe0f Clara (Communication)');
-    console.log('  \u2699\ufe0f Avery (Automation)  \ud83d\udd27 Owen (Operations)  \ud83d\udd0c Isaac (Integration)');
-    console.log('  \u2708\ufe0f Tommy (Travel)  \ud83d\udcbc Sloane (Sales)  \ud83c\udfa8 Nadia (UI/UX)');
-    console.log('  \ud83d\udce3 Morgan (Marketing)  \ud83d\udd77\ufe0f Alex (API Crawling)  \ud83e\uddea Uma (UX Research)');
-    console.log('  \ud83d\uddc2\ufe0f Caleb (CRM)  \ud83d\udccb Elena (Estimation)  \ud83d\udcb0 Audrey (Accounting)');
-    console.log('  \u2696\ufe0f Logan (Legal)  \ud83d\udccc Eva (Executive Assistant)  \ud83d\udcc5 Parker (Project Mgmt)');
-    console.log();
-    console.log('  To unlock Pro, sign up at: getalice.av3.ai/signup?plan=pro');
-    console.log('  Then run: npx @robbiesrobotics/alice-agents');
-    console.log();
-    closePrompt();
-    return;
+    const { checkProLicense, validateLicenseRemote, storeLicense, isValidFormat } = await import('./license.mjs');
+
+    const existing = await checkProLicense();
+
+    if (existing.licensed) {
+      console.log(`  ✅ Pro license found (${existing.key.slice(0, 12)}...)`);
+    } else if (auto) {
+      // --yes flag: skip interactive prompt, fallback to Starter if no stored license
+      console.log('');
+      console.log('  ℹ️  Pro tier requires a license key.');
+      console.log('  Run without --yes to enter your license key.');
+      console.log('  Falling back to Starter tier.');
+      console.log('  Purchase a license at: https://getalice.av3.ai/pricing');
+      tier = 'starter';
+    } else {
+      // No stored license — prompt for key
+      let key = '';
+      let attempts = 0;
+
+      while (attempts < 3) {
+        key = await promptLicenseKey();
+
+        if (!isValidFormat(key)) {
+          console.log('  ❌ Invalid format. Key must be ALICE-XXXX-XXXX-XXXX');
+          attempts++;
+          continue;
+        }
+
+        console.log('  Validating key...');
+        const result = await validateLicenseRemote(key);
+
+        if (result.valid) {
+          storeLicense(key);
+          if (result.message === 'offline') {
+            console.log('  ✅ Key stored (offline — will validate on next run)');
+          } else {
+            console.log('  ✅ License verified! Welcome to A.L.I.C.E. Pro.');
+          }
+          break;
+        } else {
+          console.log(`  ❌ Invalid key: ${result.message ?? 'Not recognized'}`);
+          attempts++;
+
+          if (attempts >= 3) {
+            console.log('');
+            console.log('  Too many invalid attempts. Falling back to Starter tier.');
+            console.log('  Purchase a license at: https://getalice.av3.ai/pricing');
+            tier = 'starter'; // fallback gracefully
+          }
+        }
+      }
+    }
   }
 
   const agents = allAgents;

package/lib/license.mjs

@@ -0,0 +1,50 @@
+// lib/license.mjs
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const LICENSE_DIR = join(homedir(), '.alice');
+const LICENSE_FILE = join(LICENSE_DIR, 'license');
+const VALIDATE_URL = 'https://getalice.av3.ai/api/license/validate';
+const KEY_REGEX = /^ALICE-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/;
+
+export function readStoredLicense() {
+  try {
+    if (!existsSync(LICENSE_FILE)) return null;
+    return readFileSync(LICENSE_FILE, 'utf8').trim();
+  } catch {
+    return null;
+  }
+}
+
+export function storeLicense(key) {
+  mkdirSync(LICENSE_DIR, { recursive: true });
+  writeFileSync(LICENSE_FILE, key.trim(), 'utf8');
+}
+
+export function isValidFormat(key) {
+  return KEY_REGEX.test(key?.trim()?.toUpperCase());
+}
+
+export async function validateLicenseRemote(key) {
+  // Returns { valid: boolean, plan: string, message?: string }
+  try {
+    const res = await fetch(`${VALIDATE_URL}?key=${encodeURIComponent(key)}`, {
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!res.ok) return { valid: false, message: 'Validation service unavailable' };
+    return await res.json();
+  } catch {
+    // Network error — fail open (allow install, validate next time)
+    return { valid: true, plan: 'pro', message: 'offline' };
+  }
+}
+
+export async function checkProLicense() {
+  // Returns: { licensed: boolean, key: string|null, source: 'stored'|'none' }
+  const stored = readStoredLicense();
+  if (stored && isValidFormat(stored)) {
+    return { licensed: true, key: stored, source: 'stored' };
+  }
+  return { licensed: false, key: null, source: 'none' };
+}

package/lib/prompter.mjs

@@ -110,3 +110,18 @@ export async function promptTier() {
     { label: 'Pro (18 more agents) — sign up at getalice.av3.ai/signup?plan=pro', value: 'pro' },
   ]);
 }
+
+export async function promptLicenseKey() {
+  // Show instructions, prompt for key, validate format
+  console.log('');
+  console.log('  A.L.I.C.E. Pro requires a license key.');
+  console.log('  Purchase at: https://getalice.av3.ai/pricing');
+  console.log('  Already have a key? Enter it below.');
+  console.log('');
+
+  return new Promise((resolve) => {
+    getRL().question('  License key (ALICE-XXXX-XXXX-XXXX): ', (answer) => {
+      resolve(answer.trim().toUpperCase());
+    });
+  });
+}

package/lib/workspace-scaffolder.mjs

@@ -12,7 +12,7 @@ const SKILLS_DIR = join(OPENCLAW_DIR, 'skills');
 const PRODUCT_FILES = ['SOUL.md', 'AGENTS.md', 'IDENTITY.md', 'TOOLS.md'];
 
 // User files — only created if missing
-const USER_FILES = ['PLAYBOOK.md', 'LEARNINGS.md', 'FEEDBACK.md', 'USER.md'];
+const USER_FILES = ['PLAYBOOK.md', 'LEARNINGS.md', 'FEEDBACK.md', 'USER.md', 'MEMORY.md'];
 
 function renderTemplate(template, vars) {
   let result = template;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbiesrobotics/alice-agents",
-  "version": "1.2.9",
+  "version": "1.3.1",
   "description": "A.L.I.C.E. — 28 AI agents for OpenClaw. One conversation, one team.",
   "bin": {
     "alice-agents": "bin/alice-install.mjs"
@@ -28,6 +28,10 @@
     "SELF-HEALING-SPEC.md",
     "README.md"
   ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "test:check": "node --check lib/*.mjs bin/*.mjs"
+  },
   "publishConfig": {
     "access": "public"
   }

package/templates/workspaces/_shared/AGENTS.md

@@ -48,3 +48,12 @@ Skip this for trivial lookups or single-command tasks. Write it for anything inv
 - Don't exceed your domain without flagging it
 - Don't run destructive commands without explicit risk callout
 - `trash` > `rm`
+
+## Tier Note
+
+{{#if isPro}}
+You are a **Pro tier** agent. Pro tier requires a valid A.L.I.C.E. Pro license key stored at `~/.alice/license`.
+If you were installed without a license key, run the installer interactively to enter your key:
+`npx @robbiesrobotics/alice-agents`
+Purchase or manage your license at: https://getalice.av3.ai/pricing
+{{/if}}

package/templates/workspaces/_shared/MEMORY.md

@@ -0,0 +1,22 @@
+# MEMORY.md — {{agentName}}
+
+> Persistent memory for {{agentName}}, {{agentDomain}} specialist.
+> This file is yours — add notes, context, and learnings that should persist across sessions.
+
+## Identity
+
+- **Name:** {{agentName}}
+- **Domain:** {{agentDomain}}
+- **Team:** A.L.I.C.E.
+
+## Active Projects
+
+<!-- Add ongoing projects and their current status here -->
+
+## Key Notes
+
+<!-- Jot down anything important to remember across sessions -->
+
+## Decisions Made
+
+<!-- Record significant decisions and their rationale -->