@robbiesrobotics/alice-agents 1.4.4 → 1.4.6

package/README.md

@@ -22,6 +22,7 @@ That's it. The installer detects your runtime (NemoClaw or OpenClaw) and sets ev
 - installs the `mission-control-bridge` plugin into your OpenClaw home
 - writes a portable local Mission Control config at `~/.openclaw/.alice-mission-control.json`
 - enables the bridge in `openclaw.json` so your runtime can forward live telemetry to Mission Control
+- installs a bundled `coding-agent` skill that prefers Codex for OpenAI defaults and Claude Code for Anthropic defaults
 
 An orchestrator (A.L.I.C.E., also addressable as Alice or Olivia) backed by specialist agents across every domain:
 
@@ -79,11 +80,14 @@ When you install, the installer will **auto-detect your configured model** and l
 # Interactive install
 npx @robbiesrobotics/alice-agents
 
-# Non-interactive with defaults (detected model if available, otherwise Sonnet; Starter tier)
+# Non-interactive with defaults (detected model if available, otherwise Sonnet; Starter tier unless --tier pro)
 npx @robbiesrobotics/alice-agents --yes
 
 # Non-interactive Pro install with Mission Control Cloud enabled
-npx @robbiesrobotics/alice-agents --cloud --cloud-token YOUR_TOKEN
+npx @robbiesrobotics/alice-agents --yes --tier pro --license-key YOUR_KEY --cloud --cloud-token YOUR_TOKEN
+
+# Force the coding tool preference for this install
+npx @robbiesrobotics/alice-agents --yes --coding-tool codex
 
 # Show help
 npx @robbiesrobotics/alice-agents --help
@@ -100,7 +104,7 @@ npx @robbiesrobotics/alice-agents --help
 If you're a Pro user with the cloud add-on, the installer can configure your local runtime for Mission Control in the same pass.
 
 - Interactive install: choose `Pro`, validate your license, then enable the Mission Control Cloud add-on when prompted
-- Non-interactive install: pass `--cloud`
+- Non-interactive install: pass `--tier pro --license-key YOUR_KEY --cloud`
 - Optional flags:
   - `--cloud-token <token>` — access or ingest token for authenticated telemetry
   - `--cloud-dashboard-url <url>` — defaults to `https://alice.av3.ai`
@@ -127,6 +131,18 @@ npx @robbiesrobotics/alice-agents --uninstall
 
 Removes A.L.I.C.E. agents from `openclaw.json` while preserving any non-ALICE agents. Creates a backup before making changes.
 
+## Maintainer Release Guard
+
+Maintainer publishes are now gated.
+
+- `npm publish` runs `prepublishOnly`
+- that hook runs tests, syntax checks, and `npm run release:check`
+- publish is blocked unless the package version has a matching git tag on `HEAD`
+- publish is blocked unless `landing/content/changelog.md` contains the matching version entry
+- publish is blocked unless `releases/vX.Y.Z.md` exists and is marked `Status: approved`
+
+Use `releases/TEMPLATE.md` as the starting point for each release brief.
+
 ## How It Works
 
 1. **You talk to A.L.I.C.E.** — she's your single point of contact

package/bin/alice-install.mjs

@@ -37,15 +37,22 @@ if (flags.has('--help') || flags.has('-h')) {
     npx @robbiesrobotics/alice-agents --help       Show this help
 
   Options:
-    --yes         Skip prompts, use defaults (Sonnet, Starter tier)
+    --yes         Skip prompts, use detected model when available (otherwise Sonnet)
     --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
     --cloud       Enable Mission Control Cloud setup during install
     --no-cloud    Skip Mission Control Cloud setup during install
+    --tier <starter|pro>           Force the install tier
+    --license-key <key>            Provide a Pro license key for automation
+    --coding-tool <auto|claude|codex>  Override the preferred coding CLI
     --cloud-token <token>           Mission Control ingest/access token
     --cloud-dashboard-url <url>     Mission Control dashboard URL
     --cloud-ingest-url <url>        Mission Control ingest endpoint
+    --cloud-team-id <id>            Mission Control team UUID for hosted linkage
+    --cloud-team-slug <slug>        Mission Control team slug
+    --cloud-team-name <name>        Mission Control team display name
+    --cloud-team-plan <plan>        Mission Control team plan
     --version     Print package version
   `);
   process.exit(0);
@@ -61,9 +68,16 @@ if (flags.has('--doctor')) {
     yes: true,
     modeOverride: 'upgrade',
     cloud: flags.has('--cloud') ? true : flags.has('--no-cloud') ? false : undefined,
+    tierOverride: getFlagValue('--tier'),
+    licenseKey: getFlagValue('--license-key'),
+    codingTool: getFlagValue('--coding-tool'),
     cloudToken: getFlagValue('--cloud-token'),
     cloudDashboardUrl: getFlagValue('--cloud-dashboard-url'),
     cloudIngestUrl: getFlagValue('--cloud-ingest-url'),
+    cloudTeamId: getFlagValue('--cloud-team-id'),
+    cloudTeamSlug: getFlagValue('--cloud-team-slug'),
+    cloudTeamName: getFlagValue('--cloud-team-name'),
+    cloudTeamPlan: getFlagValue('--cloud-team-plan'),
   }).catch((err) => {
     console.error('  ❌ Update failed:', err.message);
     process.exit(1);
@@ -82,9 +96,16 @@ if (flags.has('--doctor')) {
   runInstall({
     yes: flags.has('--yes'),
     cloud: flags.has('--cloud') ? true : flags.has('--no-cloud') ? false : undefined,
+    tierOverride: getFlagValue('--tier'),
+    licenseKey: getFlagValue('--license-key'),
+    codingTool: getFlagValue('--coding-tool'),
     cloudToken: getFlagValue('--cloud-token'),
     cloudDashboardUrl: getFlagValue('--cloud-dashboard-url'),
     cloudIngestUrl: getFlagValue('--cloud-ingest-url'),
+    cloudTeamId: getFlagValue('--cloud-team-id'),
+    cloudTeamSlug: getFlagValue('--cloud-team-slug'),
+    cloudTeamName: getFlagValue('--cloud-team-name'),
+    cloudTeamPlan: getFlagValue('--cloud-team-plan'),
   }).catch((err) => {
     console.error('  ❌ Install failed:', err.message);
     process.exit(1);

package/lib/agent-registry.mjs

@@ -0,0 +1,33 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = join(__dirname, '..', 'templates');
+
+const STARTER_TEMPLATE = 'agents-starter.json';
+const PRO_ADDONS_TEMPLATE = 'agents-pro.json';
+
+export function normalizeTier(tier) {
+  return tier === 'pro' ? 'pro' : 'starter';
+}
+
+function loadRegistryFile(filename) {
+  const raw = readFileSync(join(TEMPLATES_DIR, filename), 'utf8');
+  return JSON.parse(raw);
+}
+
+export function loadAgentRegistry(tier = 'starter') {
+  const normalizedTier = normalizeTier(tier);
+  const starterAgents = loadRegistryFile(STARTER_TEMPLATE);
+  if (normalizedTier === 'starter') {
+    return starterAgents;
+  }
+
+  const proAddons = loadRegistryFile(PRO_ADDONS_TEMPLATE);
+  return [...starterAgents, ...proAddons];
+}
+
+export function getAgentIdsForTier(tier = 'starter') {
+  return loadAgentRegistry(tier).map((agent) => agent.id);
+}

package/lib/coding-agent.mjs

@@ -0,0 +1,187 @@
+import { execSync } from 'node:child_process';
+
+export const CODING_TOOL_OVERRIDES = new Set(['auto', 'claude', 'codex']);
+
+const TOOL_CONFIG = {
+  claude: {
+    id: 'claude',
+    name: 'Claude Code',
+    cli: 'claude',
+    skillHeading: 'Claude Code',
+    primaryExample: `claude --permission-mode bypassPermissions --print 'YOUR TASK HERE. Run tests to verify.'`,
+    reviewExample: `claude --permission-mode bypassPermissions --print 'Review the current changes for bugs, regressions, and missing tests. Output a numbered list of findings.'`,
+  },
+  codex: {
+    id: 'codex',
+    name: 'Codex',
+    cli: 'codex',
+    skillHeading: 'Codex',
+    primaryExample: `codex exec --full-auto -C /path/to/project 'YOUR TASK HERE. Run tests to verify.'`,
+    reviewExample: `codex review --base main 'Review the current changes for bugs, regressions, and missing tests.'`,
+  },
+};
+
+function commandExists(cmd) {
+  const probe = process.platform === 'win32' ? 'where' : 'which';
+  try {
+    execSync(`${probe} ${cmd}`, { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function normalizeProviderId(provider) {
+  if (!provider) return null;
+  if (provider === 'openai-codex') return 'openai';
+  return provider;
+}
+
+export function getModelProvider(model) {
+  if (!model || typeof model !== 'string' || !model.includes('/')) return null;
+  return normalizeProviderId(model.split('/')[0]);
+}
+
+function getPreferredToolForProvider(provider) {
+  if (provider === 'anthropic') return 'claude';
+  if (provider === 'openai') return 'codex';
+  return null;
+}
+
+function validateOverride(override) {
+  const normalized = String(override || 'auto').trim().toLowerCase() || 'auto';
+  if (!CODING_TOOL_OVERRIDES.has(normalized)) {
+    throw new Error(`Invalid --coding-tool value "${override}". Use auto, claude, or codex.`);
+  }
+  return normalized;
+}
+
+export function resolveCodingAgentPreference({ detectedModels = null, override = 'auto' } = {}) {
+  const normalizedOverride = validateOverride(override);
+  const available = {
+    claude: commandExists(TOOL_CONFIG.claude.cli),
+    codex: commandExists(TOOL_CONFIG.codex.cli),
+  };
+  const provider =
+    getModelProvider(detectedModels?.primary) ||
+    getModelProvider(detectedModels?.orchestrator) ||
+    (detectedModels?.providers || [])
+      .map(normalizeProviderId)
+      .find((entry) => entry === 'anthropic' || entry === 'openai') ||
+    null;
+
+  let preferredTool = normalizedOverride === 'auto' ? getPreferredToolForProvider(provider) : normalizedOverride;
+
+  if (!preferredTool) {
+    if (available.codex) {
+      preferredTool = 'codex';
+    } else if (available.claude) {
+      preferredTool = 'claude';
+    } else {
+      preferredTool = 'codex';
+    }
+  }
+
+  const fallbackTool = preferredTool === 'codex' ? 'claude' : 'codex';
+  const selectionReason =
+    normalizedOverride !== 'auto'
+      ? `manual override (--coding-tool ${preferredTool})`
+      : provider
+        ? `detected ${provider} as the default OpenClaw provider`
+        : available.codex || available.claude
+          ? 'no provider-specific default detected; using the first available coding CLI'
+          : 'no coding CLI detected yet; generated guidance includes both Codex and Claude Code';
+
+  return {
+    override: normalizedOverride,
+    provider,
+    preferredTool,
+    fallbackTool,
+    preferred: TOOL_CONFIG[preferredTool],
+    fallback: TOOL_CONFIG[fallbackTool],
+    available,
+    selectionReason,
+    skillId: 'coding-agent',
+    skillPath: '~/.openclaw/skills/coding-agent/SKILL.md',
+  };
+}
+
+export function buildCodingAgentSkillContent(preference) {
+  const preferredAvailability = preference.available[preference.preferred.id]
+    ? `${preference.preferred.cli} is installed on this machine.`
+    : `${preference.preferred.cli} is not currently installed; check before using it.`;
+  const fallbackAvailability = preference.available[preference.fallback.id]
+    ? `${preference.fallback.cli} is also available as a fallback.`
+    : `${preference.fallback.cli} is the fallback if you install it later.`;
+  const providerLabel = preference.provider || 'unknown';
+
+  return `---
+name: coding-agent
+description: 'Delegate substantial coding work to the preferred coding CLI for this install. Use when: multi-file implementation, refactors, build/test verification, deep codebase exploration, or structured code review. Prefer ${preference.preferred.name} first, then fall back to ${preference.fallback.name} if needed.'
+metadata:
+  {
+    "openclaw": { "emoji": "⚙️", "requires": { "anyBins": ["${preference.preferred.cli}", "${preference.fallback.cli}"] } }
+  }
+---
+
+# Coding Agent Skill
+
+This bundled skill routes coding work through the preferred CLI for this install.
+
+- Preferred tool: **${preference.preferred.name}**
+- Fallback tool: **${preference.fallback.name}**
+- Detection basis: ${preference.selectionReason}
+- Current provider signal: ${providerLabel}
+
+## Availability
+
+- ${preferredAvailability}
+- ${fallbackAvailability}
+
+## When to use this skill
+
+Use this skill when the task requires:
+- Modifying multiple files
+- Running build, lint, or test commands to verify correctness
+- Exploring an unfamiliar codebase before implementing
+- A focused code review with concrete findings
+
+## Preferred path: ${preference.preferred.skillHeading}
+
+\`\`\`
+${preference.preferred.primaryExample}
+\`\`\`
+
+Review-only example:
+
+\`\`\`
+${preference.preferred.reviewExample}
+\`\`\`
+
+## Fallback path: ${preference.fallback.skillHeading}
+
+\`\`\`
+${preference.fallback.primaryExample}
+\`\`\`
+
+Review-only example:
+
+\`\`\`
+${preference.fallback.reviewExample}
+\`\`\`
+
+## Rules
+
+1. Use the preferred tool first unless it is unavailable or blocked.
+2. Always point the tool at the project root before asking it to work.
+3. Ask it to run the relevant verification commands before finishing.
+4. Summarize what changed and any remaining risks when reporting back.
+5. Do not use this skill for trivial one-line edits or pure planning.
+
+## Quick check
+
+\`\`\`
+which ${preference.preferred.cli} || which ${preference.fallback.cli}
+\`\`\`
+`;
+}

package/lib/config-merger.mjs

@@ -272,7 +272,11 @@ export function mergeConfig({ agents, mode, preset, customModels }) {
   config.tools = config.tools || {};
   config.tools.agentToAgent = config.tools.agentToAgent || {};
   config.tools.agentToAgent.enabled = true;
-  config.tools.agentToAgent.allow = [...aliceIds];
+  const mergedAllow = new Set(config.tools.agentToAgent.allow || []);
+  for (const id of aliceIds) {
+    mergedAllow.add(id);
+  }
+  config.tools.agentToAgent.allow = [...mergedAllow];
 
   writeConfigAtomic(config);
   return { backupPath, agentCount: aliceEntries.length, effectivePreset, warning };

package/lib/doctor.mjs

@@ -5,6 +5,7 @@ import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { icons, greenBold, green, red, yellow, cyan, dim, bold,
          printSection, printSeparator, separator } from './colors.mjs';
+import { getAgentIdsForTier } from './agent-registry.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const HOME = homedir();
@@ -20,10 +21,52 @@ function commandExists(cmd) {
 }
 const OPENCLAW_DIR = join(HOME, '.openclaw');
 
-const STARTER_AGENTS = [
-  'olivia', 'dylan', 'selena', 'devon', 'quinn',
-  'felix', 'daphne', 'rowan', 'darius', 'sophie',
-];
+const STARTER_AGENTS = getAgentIdsForTier('starter');
+const ALL_ALICE_AGENTS = getAgentIdsForTier('pro');
+
+function normalizeProviderId(provider) {
+  if (!provider) return null;
+  if (provider === 'openai-codex') return 'openai';
+  return provider;
+}
+
+function getConfigAgents(config) {
+  if (Array.isArray(config?.agents?.list)) return config.agents.list;
+  if (Array.isArray(config?.agents)) return config.agents;
+  return [];
+}
+
+function detectConfiguredModel(config) {
+  if (!config || config === 'invalid') return { ok: false, label: null, inherited: false };
+
+  const defaults = config?.agents?.defaults?.model || {};
+  const primary = defaults.primary || config?.model || config?.default_model || null;
+  if (primary) {
+    return { ok: true, label: primary, inherited: true };
+  }
+
+  const providerKeys = Object.keys(config?.models?.providers || {});
+  if (providerKeys.length > 0) {
+    return { ok: true, label: providerKeys[0], inherited: false };
+  }
+
+  const profile = Object.values(config?.auth?.profiles || {}).find((entry) => entry?.provider);
+  if (profile?.provider) {
+    return { ok: true, label: normalizeProviderId(profile.provider), inherited: false };
+  }
+
+  if (config.models && Object.keys(config.models).length > 0) {
+    return { ok: true, label: Object.keys(config.models)[0], inherited: false };
+  }
+  if (config.providers && Object.keys(config.providers).length > 0) {
+    return { ok: true, label: Object.keys(config.providers)[0], inherited: false };
+  }
+  if (config.llm && Object.keys(config.llm).length > 0) {
+    return { ok: true, label: Object.keys(config.llm)[0], inherited: false };
+  }
+
+  return { ok: false, label: null, inherited: false };
+}
 
 function check(label, ok, hint) {
   const icon = ok ? icons.ok : icons.fail;
@@ -158,10 +201,23 @@ export async function runDoctor() {
   }
 
   // 3. A.L.I.C.E. agents in config
-  const configAgents = Array.isArray(config.agents) ? config.agents : [];
+  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 configAgents = getConfigAgents(config);
   const agentsInConfig = configAgents
-    .filter((a) => a && STARTER_AGENTS.includes(a.id))
+    .filter((a) => a && ALL_ALICE_AGENTS.includes(a.id))
     .map((a) => a.id);
+  const expectedTier = manifest?.tier === 'pro' || agentsInConfig.some((id) => !STARTER_AGENTS.includes(id))
+    ? 'pro'
+    : 'starter';
+  const expectedAgents = expectedTier === 'pro' ? ALL_ALICE_AGENTS : STARTER_AGENTS;
 
   const agentsOk = agentsInConfig.length > 0;
   check(
@@ -173,17 +229,17 @@ export async function runDoctor() {
   );
   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 for missing agents from the expected tier roster
+  if (agentsInConfig.length > 0 && agentsInConfig.length < expectedAgents.length) {
+    const missing = expectedAgents.filter((id) => !agentsInConfig.includes(id));
     check(
-      `All starter agents present (missing: ${missing.join(', ')})`,
+      `All ${expectedTier} 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);
+  } else if (agentsInConfig.length === expectedAgents.length) {
+    check(`All ${expectedTier} agents present`, true);
   }
 
   // 4. Agent workspaces exist on disk
@@ -207,26 +263,13 @@ export async function runDoctor() {
   }
 
   // 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];
-  }
+  const modelState = detectConfiguredModel(config);
+  const modelOk = modelState.ok;
+  const modelLabel = modelState.label;
 
   check(
     modelOk
-      ? `Model/provider configured: ${modelLabel}`
+      ? `Model/provider configured: ${modelLabel}${modelState.inherited ? ' (shared default)' : ''}`
       : 'No model/provider configured',
     modelOk,
     'Run: openclaw configure to set up a model provider'
@@ -246,9 +289,11 @@ export async function runDoctor() {
       );
       // Docker permission issue is a warning, not a hard failure for A.L.I.C.E. itself
       // but it will break OpenClaw's own Docker features
+      allOk = false;
       console.log(`  ${icons.info} ${dim('This will affect OpenClaw features that use Docker.')}\n`);
     } else {
       check('Docker daemon not running or not accessible', false, docker.hint);
+      allOk = false;
     }
   }
 
@@ -260,24 +305,28 @@ export async function runDoctor() {
 
   // 7. 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
-      );
+      if (licenseResult.provisional) {
+        check(
+          `Pro license: ${maskedKey} (temporary grace until ${licenseResult.graceUntil})`,
+          false,
+          'Reconnect to the network and rerun the installer to complete validation'
+        );
+        allOk = false;
+      } else {
+        check(
+          `Pro license: ${maskedKey} (stored at ~/.alice/license)`,
+          true
+        );
+        if (licenseResult.needsRevalidation) {
+          console.log(`  ${icons.info} ${dim('Validation service unavailable — using cached entitlement for now.')}`);
+          console.log('');
+        }
+      }
     } else {
       check(
         'Pro license: not found (running Starter tier)',
@@ -291,7 +340,38 @@ export async function runDoctor() {
     check('License: Starter tier (no license required)', true);
   }
 
-  // 8. Skills disk check
+  // 8. Mission Control cloud config
+  const missionControlConfigPath = join(OPENCLAW_DIR, '.alice-mission-control.json');
+  if (existsSync(missionControlConfigPath)) {
+    try {
+      const missionControlConfig = JSON.parse(readFileSync(missionControlConfigPath, 'utf8'));
+      const cloud = missionControlConfig?.cloud || {};
+      const hasDashboardUrl = typeof cloud.dashboardUrl === 'string' && cloud.dashboardUrl.length > 0;
+      const hasIngestUrl = typeof cloud.ingestUrl === 'string' && cloud.ingestUrl.length > 0;
+      const hasIngestToken = typeof cloud.ingestToken === 'string' && cloud.ingestToken.length > 0;
+      const cloudOk = hasDashboardUrl && hasIngestUrl && hasIngestToken;
+
+      check(
+        cloudOk
+          ? `Mission Control cloud configured (${cloud.dashboardUrl})`
+          : 'Mission Control cloud config incomplete',
+        cloudOk,
+        'Run: npx @robbiesrobotics/alice-agents --cloud to repair cloud settings'
+      );
+      allOk = allOk && cloudOk;
+    } catch {
+      check(
+        'Mission Control cloud config invalid',
+        false,
+        'Repair ~/.openclaw/.alice-mission-control.json or rerun the installer with --cloud'
+      );
+      allOk = false;
+    }
+  } else {
+    console.log(`  ${dim('–')}  ${dim('Mission Control cloud not configured (optional)')}`);
+  }
+
+  // 9. Skills disk check
   const skillsManifestPath = join(OPENCLAW_DIR, '.alice-manifest.json');
   const skillsManifestData = (() => {
     try {