@uluops/setup 0.2.0 → 0.4.0

package/dist/cli.js

@@ -13,41 +13,99 @@ import { installCommands, uninstallCommands } from "./steps/commands.js";
 import { writeShellExport, removeShellExport } from "./steps/shell.js";
 import { verify } from "./steps/verify.js";
 import { installMetrics, uninstallMetrics } from "./steps/metrics.js";
-import { loadManifest, saveManifest, deleteManifest, } from "./lib/manifest.js";
-import { getClaudeHome, getAgentsDir, ASSETS_DIR } from "./lib/paths.js";
+import { probeHookSupport } from "./lib/settings-merger.js";
+import { loadManifest, saveManifest, deleteManifest, validateManifest, } from "./lib/manifest.js";
+import { ASSETS_DIR, findProjectRoot } from "./lib/paths.js";
+import { getHealthTimeout } from "./lib/health.js";
+import { ok, warn, fail, info, printSetupSummary, printAgentList } from "./lib/display.js";
+import { getProfile, resolveHarnessName, listHarnesses, HarnessNotTestedError, } from "./harnesses/index.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 async function getVersion() {
     const pkgPath = join(__dirname, "..", "package.json");
     const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
     return pkg.version;
 }
-const ok = (msg) => console.log(`  ${chalk.green("✓")} ${msg}`);
-const warn = (msg) => console.log(`  ${chalk.yellow("⚠")} ${msg}`);
-const fail = (msg) => console.log(`  ${chalk.red("✗")} ${msg}`);
-const info = (msg) => console.log(`  ${msg}`);
 async function runSetup(opts) {
     const version = await getVersion();
+    const profile = getProfile(opts.harness);
     console.log();
     console.log(`  ${chalk.dim("⟨u⟩")} ${chalk.cyan.bold("ulu")}${chalk.bold("·ops")}`);
     console.log(`      ${chalk.dim("operating intelligence as infrastructure")}`);
     console.log();
-    console.log(`  Setup v${version}`);
+    console.log(`  Setup v${version} — ${chalk.bold(profile.displayName)}`);
     console.log();
     if (opts.dryRun) {
         info(chalk.dim("(dry run — no changes will be made)\n"));
     }
-    // Detect environment
+    const { env, apiKey } = await initContext(opts);
+    console.log();
+    // Load existing manifest for update detection
+    const existingManifest = await loadManifest();
+    const existingHarness = existingManifest?.harnesses[profile.name];
+    if (existingManifest && existingManifest.version !== version) {
+        info(`Updating ${chalk.dim(existingManifest.version)} → ${chalk.green(version)}`);
+        console.log();
+    }
+    else if (existingHarness) {
+        info(chalk.dim(`Already at v${version} — checking for changes`));
+        console.log();
+    }
+    // Check for conflicts on first install for this harness
+    if (!existingHarness && !opts.yes && !opts.dryRun) {
+        await checkConflicts(profile, opts.localDefs);
+    }
+    const mcpResult = await configureMcpStep(profile, apiKey, opts);
+    const agentsResult = await installAgentsDefs(profile, opts, existingHarness?.agents);
+    const commandsResult = await installCommandsDefs(profile, opts, existingHarness?.commands);
+    const metricsResult = await configureMetricsStep(profile, opts);
+    await runHealthCheck(opts);
+    const shellModified = await configureShell(env, apiKey, opts);
+    // Save manifest
+    if (!opts.dryRun) {
+        const now = new Date().toISOString();
+        const harnessEntry = {
+            installedAt: now,
+            setupVersion: version,
+            mcpScope: opts.scope,
+            mcpConfigPath: mcpResult.configPath,
+            defsScope: opts.localDefs ? "local" : "global",
+            defsPath: opts.localDefs
+                ? join(await findProjectRoot(), "uluops")
+                : profile.paths.home,
+            agents: agentsResult.files,
+            commands: commandsResult.files,
+            hooksInstalled: metricsResult.hookConfigured,
+        };
+        const manifest = existingManifest ?? {
+            version,
+            installedAt: now,
+            shellModified: false,
+            harnesses: {},
+        };
+        manifest.version = version;
+        manifest.installedAt = now;
+        manifest.shellModified = shellModified || manifest.shellModified;
+        manifest.harnesses[profile.name] = harnessEntry;
+        await saveManifest(manifest);
+    }
+    await printSetupSummary({
+        profile,
+        agentCount: agentsResult.files.length,
+        commandCount: commandsResult.files.length,
+        apiKey,
+    });
+}
+// --- extracted helpers ---
+/** Resolve API key via flag, env, file, signup, or interactive prompt. Returns env detection + key. */
+async function initContext(opts) {
     const env = await detect();
-    // Resolve API key — via signup or existing key
     let apiKey;
-    let email = null;
     try {
         if (opts.signup) {
             info("Create your UluOps account\n");
             const auth = await signup();
             apiKey = auth.apiKey;
-            email = auth.email;
-            ok(`Account created (${email})`);
+            ok(`Account created (${auth.email})`);
             ok(`API key generated`);
         }
         else {
@@ -57,193 +115,137 @@ async function runSetup(opts) {
                 interactive: !opts.yes && !opts.apiKey && !process.env["ULUOPS_API_KEY"],
             });
             apiKey = auth.apiKey;
-            email = auth.email;
-            if (email) {
-                ok(`Key validated (${email})`);
-            }
-            else if (opts.skipValidation) {
+            if (auth.email)
+                ok(`Key validated (${auth.email})`);
+            else if (opts.skipValidation)
                 ok("Key accepted (validation skipped)");
-            }
-            else {
+            else
                 ok("Key validated");
-            }
         }
     }
     catch (err) {
         fail(err instanceof Error ? err.message : String(err));
         process.exit(1);
     }
-    console.log();
-    // Load existing manifest for update detection
-    const existingManifest = await loadManifest();
-    // Show update info if re-running with newer version
-    if (existingManifest && existingManifest.version !== version) {
-        info(`Updating ${chalk.dim(existingManifest.version)} → ${chalk.green(version)}`);
-        console.log();
-    }
-    else if (existingManifest) {
-        info(chalk.dim(`Already at v${version} — checking for changes`));
-        console.log();
-    }
-    // Check for conflicts on first install
-    if (!existingManifest && !opts.yes && !opts.dryRun) {
-        await checkConflicts(opts.localDefs);
-    }
-    // MCP config
-    const mcpResult = await installMcp(apiKey, opts.scope, opts.dryRun);
-    ok(`MCP config → ${mcpResult.configPath} (2 servers)`);
-    // Agents
-    const agentsResult = await installAgents(opts.localDefs, opts.dryRun, existingManifest?.agents);
-    const agentParts = [];
-    if (agentsResult.copied > 0)
-        agentParts.push(`${agentsResult.copied} copied`);
-    if (agentsResult.skipped > 0)
-        agentParts.push(`${agentsResult.skipped} unchanged`);
-    if (agentsResult.removed > 0)
-        agentParts.push(`${agentsResult.removed} removed`);
-    ok(`${agentsResult.files.length} agents → ${opts.localDefs ? "./uluops/agents/" : "~/.claude/agents/"}${agentParts.length ? ` (${agentParts.join(", ")})` : ""}`);
-    // Commands
-    const commandsResult = await installCommands(opts.localDefs, opts.dryRun, existingManifest?.commands);
-    const totalCommands = commandsResult.agentCommands + commandsResult.workflowCommands;
-    const cmdSkipped = commandsResult.skipped;
-    const cmdTotal = commandsResult.files.length;
-    const cmdParts = [];
-    if (totalCommands > 0)
-        cmdParts.push(`${totalCommands} copied`);
-    if (cmdSkipped > 0)
-        cmdParts.push(`${cmdSkipped} unchanged`);
-    if (commandsResult.removed > 0)
-        cmdParts.push(`${commandsResult.removed} removed`);
-    ok(`${cmdTotal} commands → ${opts.localDefs ? "./uluops/commands/" : "~/.claude/commands/"}${cmdParts.length ? ` (${cmdParts.join(", ")})` : ""}`);
-    // Agent metrics (SubagentStop hook for auto-capture)
-    const metricsResult = await installMetrics(opts.dryRun);
-    if (metricsResult.hookConfigured) {
+    return { env, apiKey };
+}
+/** Write MCP server entries to harness config and report warnings. */
+async function configureMcpStep(profile, apiKey, opts) {
+    const res = await installMcp(profile, apiKey, opts.scope, opts.dryRun);
+    ok(`MCP config → ${res.configPath} (2 servers)`);
+    for (const w of res.packageWarnings)
+        warn(w);
+    return res;
+}
+/** Copy agent definitions from assets to harness directory. */
+async function installAgentsDefs(profile, opts, prev) {
+    const res = await installAgents(profile, opts.localDefs, opts.dryRun, prev);
+    const parts = [];
+    if (res.copied > 0)
+        parts.push(`${res.copied} copied`);
+    if (res.skipped > 0)
+        parts.push(`${res.skipped} unchanged`);
+    if (res.removed > 0)
+        parts.push(`${res.removed} removed`);
+    const dest = opts.localDefs
+        ? "./uluops/agents/"
+        : `${profile.paths.agentsDir.replace(process.env["HOME"] ?? "", "~")}/`;
+    ok(`${res.files.length} agents → ${dest}${parts.length ? ` (${parts.join(", ")})` : ""}`);
+    return res;
+}
+/** Copy slash-command definitions from assets (Claude Code only). */
+async function installCommandsDefs(profile, opts, prev) {
+    const res = await installCommands(profile, opts.localDefs, opts.dryRun, prev);
+    if (res.skippedReason === "not-supported") {
+        info(chalk.dim(`Commands not yet supported for ${profile.displayName} (coming soon)`));
+        return res;
+    }
+    const total = res.agentCommands + res.workflowCommands + res.pipelineCommands;
+    const parts = [];
+    if (total > 0)
+        parts.push(`${total} copied`);
+    if (res.skipped > 0)
+        parts.push(`${res.skipped} unchanged`);
+    if (res.removed > 0)
+        parts.push(`${res.removed} removed`);
+    const dest = opts.localDefs
+        ? "./uluops/commands/"
+        : `${profile.paths.commandsDir.replace(process.env["HOME"] ?? "", "~")}/`;
+    ok(`${res.files.length} commands → ${dest}${parts.length ? ` (${parts.join(", ")})` : ""}`);
+    return res;
+}
+/** Install agent-metrics hook and tool files (Claude Code only). */
+async function configureMetricsStep(profile, opts) {
+    if (!profile.hooks) {
+        info(chalk.dim(`Metrics hooks not supported for ${profile.displayName}`));
+        return { toolFilesCopied: 0, hookConfigured: false };
+    }
+    const probe = probeHookSupport();
+    if (probe.warning)
+        warn(probe.warning);
+    const res = await installMetrics(profile, opts.dryRun);
+    if (res.hookConfigured) {
         const parts = [];
-        if (metricsResult.toolFilesCopied > 0)
-            parts.push(`${metricsResult.toolFilesCopied} files`);
+        if (res.toolFilesCopied > 0)
+            parts.push(`${res.toolFilesCopied} files`);
         parts.push("hook configured");
-        ok(`Agent metrics → ~/.claude/tools/agent-metrics/ (${parts.join(", ")})`);
+        const toolPath = profile.paths.toolsDir?.replace(process.env["HOME"] ?? "", "~");
+        ok(`Agent metrics → ${toolPath}/ (${parts.join(", ")})`);
     }
     else {
         warn("Agent metrics hook not configured (tool files not found)");
     }
-    // Health check
+    return res;
+}
+/** Ping tracker and registry health endpoints. */
+async function runHealthCheck(opts) {
     if (!opts.skipValidation && !opts.dryRun) {
         try {
             const [trackerOk, registryOk] = await Promise.all([
                 checkEndpoint("https://api.uluops.ai/api/v1/health"),
                 checkEndpoint("https://api.uluops.ai/api/v1/registry/health"),
             ]);
-            if (trackerOk && registryOk) {
+            if (trackerOk && registryOk)
                 ok("Health check passed — both APIs reachable");
-            }
-            else {
+            else
                 warn("Some APIs unreachable (MCP tools may have limited functionality)");
-            }
         }
         catch {
             warn("Health check skipped (network issue)");
         }
     }
-    // Shell export
-    let shellModified = false;
+}
+/** Optionally write ULUOPS_API_KEY export to shell profile. */
+async function configureShell(env, apiKey, opts) {
+    let modified = false;
     if (opts.shell && env.shellProfile) {
+        if (!opts.yes && !opts.dryRun) {
+            const confirmed = await confirmShellWrite(env.shellProfile);
+            if (!confirmed) {
+                warn("Skipped writing API key to shell profile");
+                return false;
+            }
+        }
         await writeShellExport(env.shellProfile, apiKey, opts.dryRun);
         ok(`ULUOPS_API_KEY added to ${env.shellProfile}`);
-        shellModified = true;
+        warn("API key stored in plaintext in shell profile. Consider rotating if shared machine.");
+        modified = true;
     }
     else if (opts.shell) {
         warn("--shell requested but no supported shell detected ($SHELL). Skipping.");
     }
-    // Save manifest
-    if (!opts.dryRun) {
-        await saveManifest({
-            version,
-            installedAt: new Date().toISOString(),
-            mcpScope: opts.scope,
-            mcpConfigPath: mcpResult.configPath,
-            defsScope: opts.localDefs ? "local" : "global",
-            defsPath: opts.localDefs
-                ? join(process.cwd(), "uluops")
-                : getClaudeHome(),
-            shellModified,
-            agents: agentsResult.files,
-            commands: commandsResult.files,
-            metricsHookInstalled: metricsResult.hookConfigured,
-        });
-    }
-    printSetupSummary({
-        agentCount: agentsResult.files.length,
-        commandCount: cmdTotal,
-        apiKey,
-    });
-}
-// MCP tool count across both servers. Update when server toolsets change.
-const TOOL_COUNT = 73;
-const AGENT_LIST = [
-    ["/agents:validate", "Code quality", "sonnet"],
-    ["/agents:type-safety", "TypeScript", "sonnet"],
-    ["/agents:test-review", "Test quality", "sonnet"],
-    ["/agents:optimize", "Performance", "sonnet"],
-    ["/agents:frontend", "React/a11y", "sonnet"],
-    ["/agents:mcp-validate", "MCP compliance", "sonnet"],
-    ["/agents:architect", "Design review", "sonnet"],
-    ["/agents:audit", "Runtime bugs", "opus"],
-    ["/agents:security", "OWASP", "sonnet"],
-    ["/agents:api-contract", "API alignment", "sonnet"],
-    ["/agents:release", "Publish ready", "sonnet"],
-    ["/agents:public-interface", "README/exports", "sonnet"],
-    ["/agents:docs-validate", "Documentation", "sonnet"],
-    ["/agents:prompt-validate", "Prompt review", "sonnet"],
-    ["/agents:prompt-quality", "Prompt quality", "sonnet"],
-    ["/agents:pattern-analyzer", "Patterns", "sonnet"],
-    ["/agents:aristotle-explorer", "Categories", "opus"],
-    ["/agents:aristotle-analyst", "Four causes", "opus"],
-    ["/agents:aristotle-validator", "Teleology", "opus"],
-    ["/agents:aristotle-forecaster", "Potentiality", "opus"],
-    ["/agents:assumption-excavator", "Assumptions", "sonnet"],
-    ["/agents:workflow-synthesis", "Cross-agent synthesis", "opus"],
-];
-function printSetupSummary(opts) {
-    console.log();
-    console.log(`  ${chalk.dim("━".repeat(46))}`);
-    console.log();
-    console.log(`  ${chalk.bold("Setup complete!")} ${TOOL_COUNT} MCP tools · ${opts.agentCount} agents · ${opts.commandCount} slash commands · metrics`);
-    console.log();
-    printAgentList();
-    info("For SDK/CLI usage, add to your shell profile:");
-    info(`  ${chalk.cyan(`export ULUOPS_API_KEY="${opts.apiKey}"`)}`);
-    console.log();
-    info(`Run again to update: ${chalk.cyan("npx @uluops/setup")}`);
-    console.log();
-    // Restart warning — last and prominent
-    console.log(`  ${chalk.dim("━".repeat(46))}`);
-    console.log();
-    console.log(`  ${chalk.yellow.bold("Restart Claude Code to load agents.")}`);
-    console.log();
-    info("After restart, verify with:");
-    info(`  ${chalk.cyan("/agents:validate --help")}`);
-    console.log();
-    info("Then try:");
-    info(`  ${chalk.cyan("/workflows:post-implementation .")}`);
-    console.log();
+    return modified;
 }
-function printAgentList() {
-    info(chalk.bold("WORKFLOWS"));
-    info(`  ${chalk.cyan("/workflows:pre-implementation")}    Design review before coding`);
-    info(`  ${chalk.cyan("/workflows:post-implementation")}   Iterative validation loop`);
-    info(`  ${chalk.cyan("/workflows:ship")}                  Final gate before shipping`);
-    info(`  ${chalk.cyan("/workflows:prompt-audit")}          Audit agent prompts`);
-    console.log();
-    info(`  ${chalk.cyan("/workflows:aristotle")}             Four-cause teleological analysis`);
-    console.log();
-    info(`${chalk.bold("AGENTS")} (run individually)${" ".repeat(26)}${chalk.dim("MODEL")}`);
-    for (const [cmd, desc, model] of AGENT_LIST) {
-        info(`  ${chalk.cyan(cmd.padEnd(34))}${desc.padEnd(17)}${chalk.dim(model)}`);
-    }
-    console.log();
-    info(chalk.dim(`  This is the starter set. Browse 135+ agents at registry.uluops.ai`));
-    console.log();
+/** Interactive y/N confirmation before writing API key to shell profile. */
+async function confirmShellWrite(profilePath) {
+    const readline = await import("node:readline/promises");
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const answer = await rl.question(`Write ULUOPS_API_KEY to ${profilePath}? (y/N) `);
+    rl.close();
+    return answer.trim().toLowerCase() === "y";
 }
 async function runUninstall(opts) {
     const version = await getVersion();
@@ -258,59 +260,87 @@ async function runUninstall(opts) {
         warn("No manifest found — nothing to uninstall.");
         return;
     }
-    // Remove agents
-    if (!opts.dryRun) {
-        const removed = await uninstallAgents(manifest.agents, manifest.defsPath);
-        ok(`Removed ${removed} agent(s)`);
-    }
-    else {
-        ok(`Would remove ${manifest.agents.length} agent(s)`);
-    }
-    // Remove commands
-    if (!opts.dryRun) {
-        const removed = await uninstallCommands(manifest.commands, manifest.defsPath);
-        ok(`Removed ${removed} command(s)`);
-    }
-    else {
-        ok(`Would remove ${manifest.commands.length} command(s)`);
-    }
-    // Remove MCP config
-    if (!opts.dryRun) {
-        await uninstallMcp(manifest.mcpConfigPath);
-        ok(`Removed MCP servers from ${manifest.mcpConfigPath}`);
+    const validation = await validateManifest(manifest);
+    if (!validation.valid) {
+        fail("Manifest references paths that no longer exist:");
+        for (const err of validation.errors)
+            info(`  ${err}`);
+        console.log();
+        info("Uninstall may be incomplete. Proceeding with what's available.");
+        console.log();
     }
-    else {
-        ok(`Would remove MCP servers from ${manifest.mcpConfigPath}`);
+    if (validation.warnings.length > 0) {
+        for (const w of validation.warnings)
+            warn(w);
+        console.log();
     }
-    // Remove agent metrics hook and tool files
-    if (manifest.metricsHookInstalled) {
+    for (const [harnessName, hm] of Object.entries(manifest.harnesses)) {
+        let profile;
+        try {
+            profile = getProfile(harnessName);
+        }
+        catch {
+            warn(`Unknown harness "${harnessName}" in manifest — skipping`);
+            continue;
+        }
+        info(chalk.bold(profile.displayName));
+        if (!opts.dryRun) {
+            const agentCount = await uninstallAgents(hm.agents, hm.defsPath);
+            ok(`Removed ${agentCount} agent(s)`);
+        }
+        else {
+            ok(`Would remove ${hm.agents.length} agent(s)`);
+        }
+        if (hm.commands.length > 0) {
+            if (!opts.dryRun) {
+                const cmdCount = await uninstallCommands(hm.commands, hm.defsPath);
+                ok(`Removed ${cmdCount} command(s)`);
+            }
+            else {
+                ok(`Would remove ${hm.commands.length} command(s)`);
+            }
+        }
         if (!opts.dryRun) {
-            await uninstallMetrics(false);
-            ok("Removed agent-metrics hook and tool files");
+            try {
+                await uninstallMcp(profile, hm.mcpConfigPath);
+                ok(`Removed MCP servers from ${hm.mcpConfigPath}`);
+            }
+            catch {
+                warn(`Could not remove MCP servers from ${hm.mcpConfigPath}`);
+            }
         }
         else {
-            ok("Would remove agent-metrics hook and tool files");
+            ok(`Would remove MCP servers from ${hm.mcpConfigPath}`);
+        }
+        if (hm.hooksInstalled) {
+            if (!opts.dryRun) {
+                await uninstallMetrics(profile, false);
+                ok("Removed agent-metrics hook and tool files");
+            }
+            else {
+                ok("Would remove agent-metrics hook and tool files");
+            }
         }
+        console.log();
     }
     // Remove shell export
     if (manifest.shellModified) {
         const { getShellProfile } = await import("./lib/paths.js");
-        const profile = getShellProfile();
-        if (profile && !opts.dryRun) {
-            await removeShellExport(profile.path);
-            ok(`Removed export from ${profile.path}`);
+        const shellProfile = getShellProfile();
+        if (shellProfile && !opts.dryRun) {
+            await removeShellExport(shellProfile.path);
+            ok(`Removed export from ${shellProfile.path}`);
         }
-        else if (profile) {
-            ok(`Would remove export from ${profile.path}`);
+        else if (shellProfile) {
+            ok(`Would remove export from ${shellProfile.path}`);
         }
     }
-    // Delete manifest
     if (!opts.dryRun) {
         await deleteManifest();
         ok("Manifest deleted");
     }
     console.log();
-    info("UluOps has been removed. Restart Claude Code to complete.");
+    info("UluOps has been removed. Restart your harness to complete.");
     console.log();
 }
 async function runVerify() {
@@ -337,9 +367,12 @@ async function runVerify() {
     console.log();
     process.exit(result.ok ? 0 : 1);
 }
-async function checkConflicts(localDefs) {
-    const destDir = getAgentsDir(localDefs);
-    const srcDir = join(ASSETS_DIR, "agents");
+/** Warn if existing agent files will be overwritten and prompt for confirmation. */
+async function checkConflicts(profile, localDefs) {
+    const destDir = localDefs
+        ? join(await findProjectRoot(), "uluops", "agents")
+        : profile.paths.agentsDir;
+    const srcDir = join(ASSETS_DIR, "agents", profile.name);
     let existingFiles;
     let assetFiles;
     try {
@@ -347,7 +380,7 @@ async function checkConflicts(localDefs) {
         assetFiles = await readdir(srcDir);
     }
     catch {
-        return; // Directory doesn't exist yet
+        return;
     }
     const conflicts = assetFiles.filter((f) => existingFiles.includes(f));
     if (conflicts.length === 0)
@@ -368,9 +401,12 @@ async function checkConflicts(localDefs) {
         process.exit(0);
     }
 }
+/** Fetch a URL and return true if the response is OK, false on any failure. */
 async function checkEndpoint(url) {
     try {
-        const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
+        const res = await fetch(url, {
+            signal: AbortSignal.timeout(getHealthTimeout()),
+        });
         return res.ok;
     }
     catch {
@@ -381,12 +417,13 @@ async function main() {
     const version = await getVersion();
     const program = new Command()
         .name("uluops-setup")
-        .description("Zero-friction installer for UluOps + Claude Code")
+        .description("Zero-friction installer for UluOps agentic harnesses")
         .version(version)
         .option("--api-key <key>", "API key (skip prompt)")
         .option("--signup", "Create a new account (email + password, no browser)")
+        .option("--harness <name>", `Target harness: ${listHarnesses().join(", ")} (aliases: claude, oc, gemini)`, "claude-code")
         .option("--scope <mode>", 'MCP config scope: "global" or "local"', "global")
-        .option("--local-defs", "Save agents/commands locally instead of ~/.claude/", false)
+        .option("--local-defs", "Save agents/commands locally instead of harness global dir", false)
         .option("--shell", "Write API key export to shell profile", false)
         .option("--skip-validation", "Accept API key without verifying", false)
         .option("--list", "Show available agents and workflows without installing")
@@ -400,7 +437,7 @@ async function main() {
         console.log();
         console.log(`  ${chalk.dim("⟨u⟩")} ${chalk.cyan.bold("ulu")}${chalk.bold("·ops")} v${version} — available agents and workflows`);
         console.log();
-        printAgentList();
+        await printAgentList();
         info(`Install with: ${chalk.cyan("npx @uluops/setup")}`);
         console.log();
         return;
@@ -418,6 +455,8 @@ async function main() {
         process.exit(1);
     }
     const scope = opts.scope === "local" ? "local" : "global";
+    // Resolve harness name (supports aliases)
+    const harnessName = resolveHarnessName(opts.harness);
     await runSetup({
         apiKey: opts.apiKey,
         signup: opts.signup ?? false,
@@ -427,9 +466,14 @@ async function main() {
         skipValidation: opts.skipValidation,
         dryRun: opts.dryRun,
         yes: opts.yes,
+        harness: harnessName,
     });
 }
 main().catch((err) => {
+    if (err instanceof HarnessNotTestedError) {
+        console.error(chalk.yellow(`\n  ${err.message}\n`));
+        process.exit(1);
+    }
     const msg = err instanceof Error ? err.message : String(err);
     console.error(chalk.red(`\n  Error: ${msg}\n`));
     process.exit(1);

package/dist/harnesses/claude-code.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Claude Code Harness Profile
+ *
+ * Wraps existing config-merger.ts and settings-merger.ts logic
+ * behind the HarnessProfile abstraction.
+ */
+import type { HarnessProfile } from "./types.js";
+export declare const claudeCodeProfile: HarnessProfile;