@robbiesrobotics/alice-agents 1.4.5 → 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,8 @@ 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;
@@ -202,10 +201,23 @@ export async function runDoctor() {
   }
 
   // 3. A.L.I.C.E. agents in config
+  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(
@@ -217,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
@@ -277,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;
     }
   }
 
@@ -291,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)',

package/lib/installer.mjs

@@ -27,6 +27,8 @@ import { c, bold, dim, green, greenBold, red, yellow, cyan, gray,
          icons, separator, printSection, printSeparator, printBox,
          printStepDone, printStepFail, printStepSkip } from './colors.mjs';
 import { runSkillsWizardStep } from './skills.mjs';
+import { resolveCodingAgentPreference } from './coding-agent.mjs';
+import { loadAgentRegistry } from './agent-registry.mjs';
 
 function commandExists(cmd) {
   const probe = process.platform === 'win32' ? 'where' : 'which';
@@ -105,7 +107,11 @@ function getOpenClawVersion() {
 
 function getLatestNpmVersion() {
   try {
-    const output = execSync('npm view openclaw version', { stdio: 'pipe', encoding: 'utf8' });
+    const output = execSync('npm view openclaw version', {
+      stdio: 'pipe',
+      encoding: 'utf8',
+      timeout: 5000,
+    });
     return output.trim();
   } catch {
     return null;
@@ -421,11 +427,6 @@ async function installRuntime(auto) {
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
-function loadAgentRegistry() {
-  const raw = readFileSync(join(__dirname, '..', 'templates', 'agents-starter.json'), 'utf8');
-  return JSON.parse(raw);
-}
-
 function printBanner() {
   const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url)));
   const version = pkg.version || '';
@@ -446,6 +447,13 @@ function printSummary(mode, tier, agents, preset, userInfo, detectedModels) {
   return printSummaryWithOptions(mode, tier, agents, preset, userInfo, detectedModels, null);
 }
 
+function normalizeTierOption(tier) {
+  if (!tier) return null;
+  const normalized = String(tier).trim().toLowerCase();
+  if (normalized === 'starter' || normalized === 'pro') return normalized;
+  throw new Error(`Invalid --tier value "${tier}". Use starter or pro.`);
+}
+
 function printSummaryWithOptions(mode, tier, agents, preset, userInfo, detectedModels, missionControl) {
   const modelLabel =
     preset === 'detected'
@@ -542,8 +550,6 @@ export async function runInstall(options = {}) {
     console.log(`  ${icons.info} ${dim('No model configured yet — you\'ll be prompted to choose one.')}\n`);
   }
 
-  const allAgents = loadAgentRegistry();
-
   // 2. Install mode
   let mode;
   if (options.modeOverride) {
@@ -596,7 +602,9 @@ export async function runInstall(options = {}) {
 
   // 5. Tier selection
   let tier;
-  if (auto) {
+  if (options.tierOverride) {
+    tier = normalizeTierOption(options.tierOverride);
+  } else if (auto) {
     tier = 'starter';
   } else {
     tier = await promptTier();
@@ -604,16 +612,49 @@ export async function runInstall(options = {}) {
 
   if (tier === 'pro') {
     const { checkProLicense, validateLicenseRemote, storeLicense, isValidFormat } = await import('./license.mjs');
+    const explicitLicenseKey = String(options.licenseKey || '').trim();
 
-    const existing = await checkProLicense();
+    const existing = await checkProLicense({ revalidate: true });
 
     if (existing.licensed) {
-      printStepDone(`Pro license found (${existing.key.slice(0, 12)}...)`);
+      if (existing.provisional) {
+        printStepDone(`Pro license found (${existing.key.slice(0, 12)}...)`, `temporary grace until ${existing.graceUntil}`);
+      } else if (existing.needsRevalidation) {
+        printStepDone(`Pro license found (${existing.key.slice(0, 12)}...)`, 'using cached validation while the service is unavailable');
+      } else {
+        printStepDone(`Pro license found (${existing.key.slice(0, 12)}...)`);
+      }
+    } else if (auto && explicitLicenseKey) {
+      if (!isValidFormat(explicitLicenseKey)) {
+        throw new Error('Invalid --license-key format. Key must be ALICE-XXXX-XXXX-XXXX.');
+      }
+
+      console.log('  Validating provided Pro license key...');
+      const result = await validateLicenseRemote(explicitLicenseKey);
+      if (result.valid) {
+        storeLicense(explicitLicenseKey, {
+          status: 'validated',
+          plan: result.plan || 'pro',
+          transport: result.transport,
+          source: 'remote',
+        });
+        printStepDone('License verified! Welcome to A.L.I.C.E. Pro.');
+      } else if (result.graceEligible) {
+        const graceRecord = storeLicense(explicitLicenseKey, {
+          status: 'grace',
+          plan: 'pro',
+          transport: result.transport,
+          source: 'grace',
+        });
+        printStepDone('Key stored', `temporary grace until ${graceRecord.graceUntil}`);
+      } else {
+        throw new Error(`Pro license validation failed: ${result.message ?? 'Not recognized'}`);
+      }
     } else if (auto) {
       // --yes flag: skip interactive prompt, fallback to Starter if no stored license
       console.log('');
       console.log(`  ${icons.info} ${dim('Pro tier requires a license key.')}`);
-      console.log(`  ${dim('Run without --yes to enter your license key.')}`);
+      console.log(`  ${dim('Run without --yes to enter your license key, or pass --license-key for automation.')}`);
       console.log(`  ${dim('Falling back to Starter tier.')}`);
       console.log(`  ${dim('Purchase a license at:')} ${cyan('https://getalice.av3.ai/pricing')}`);
       tier = 'starter';
@@ -635,12 +676,22 @@ export async function runInstall(options = {}) {
         const result = await validateLicenseRemote(key);
 
         if (result.valid) {
-          storeLicense(key);
-          if (result.message === 'offline') {
-            printStepDone('Key stored', 'offline — will validate on next run');
-          } else {
-            printStepDone('License verified! Welcome to A.L.I.C.E. Pro.');
-          }
+          storeLicense(key, {
+            status: 'validated',
+            plan: result.plan || 'pro',
+            transport: result.transport,
+            source: 'remote',
+          });
+          printStepDone('License verified! Welcome to A.L.I.C.E. Pro.');
+          break;
+        } else if (result.graceEligible) {
+          const graceRecord = storeLicense(key, {
+            status: 'grace',
+            plan: 'pro',
+            transport: result.transport,
+            source: 'grace',
+          });
+          printStepDone('Key stored', `temporary grace until ${graceRecord.graceUntil}`);
           break;
         } else {
           printStepFail(`Invalid key: ${result.message ?? 'Not recognized'}`);
@@ -684,12 +735,21 @@ export async function runInstall(options = {}) {
         dashboardUrl,
         ingestUrl,
         sourceNode,
+        teamId: String(options.cloudTeamId || existingMissionControl?.teamId || '').trim(),
+        teamSlug: String(options.cloudTeamSlug || existingMissionControl?.teamSlug || '').trim(),
+        teamName: String(options.cloudTeamName || existingMissionControl?.teamName || '').trim(),
+        teamPlan: String(options.cloudTeamPlan || existingMissionControl?.teamPlan || '').trim(),
         hasIngestToken: !!ingestToken,
         ingestToken,
       };
     }
   }
 
+  const codingAgent = resolveCodingAgentPreference({
+    detectedModels,
+    override: options.codingTool,
+  });
+  const allAgents = loadAgentRegistry(tier);
   const agents = allAgents;
 
   // 6. Confirmation
@@ -733,7 +793,7 @@ export async function runInstall(options = {}) {
   }
 
   // Scaffold workspaces
-  const results = scaffoldAll(agents, userInfo);
+  const { workspaces: results, installedSkill } = scaffoldAll(agents, userInfo, codingAgent);
   let newWorkspaces = 0;
   let updatedWorkspaces = 0;
   for (const r of results) {
@@ -744,6 +804,7 @@ export async function runInstall(options = {}) {
     }
   }
   printStepDone('Workspaces', `${newWorkspaces} created, ${updatedWorkspaces} updated`);
+  printStepDone('Coding agent skill', `${installedSkill.preferred.name} preferred, ${installedSkill.fallback.name} fallback`);
 
   // Skills installation step
   const finalRuntimeForSkills = await detectRuntime();
@@ -762,6 +823,9 @@ export async function runInstall(options = {}) {
     userName: userInfo.name,
     userTimezone: userInfo.timezone,
     modelPreset: effectivePreset,
+    skills: [...new Set([...(existing?.skills || []), installedSkill.skillId, ...(skillsInstalled || [])])],
+    codingTool: installedSkill.preferredTool,
+    codingSkill: installedSkill.skillId,
     missionControl: missionControl
       ? {
           enabled: true,