@robbiesrobotics/alice-agents 1.2.9 → 1.3.0

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,169 @@
+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;
+
+  // 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

@@ -253,7 +253,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 {

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.0",
   "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/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 -->