@uluops/setup 0.2.0 → 0.6.0

package/dist/cli.js

@@ -1,393 +1,26 @@
 #!/usr/bin/env node
 import { Command } from "commander";
 import chalk from "chalk";
-import { readFile, readdir } from "node:fs/promises";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { detect } from "./steps/detect.js";
-import { resolveApiKey } from "./steps/auth.js";
-import { signup } from "./steps/signup.js";
-import { installMcp, uninstallMcp } from "./steps/mcp.js";
-import { installAgents, uninstallAgents } from "./steps/agents.js";
-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";
-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();
-    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();
-    if (opts.dryRun) {
-        info(chalk.dim("(dry run — no changes will be made)\n"));
-    }
-    // Detect environment
-    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(`API key generated`);
-        }
-        else {
-            const auth = await resolveApiKey({
-                apiKeyFlag: opts.apiKey,
-                skipValidation: opts.skipValidation,
-                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) {
-                ok("Key accepted (validation skipped)");
-            }
-            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) {
-        const parts = [];
-        if (metricsResult.toolFilesCopied > 0)
-            parts.push(`${metricsResult.toolFilesCopied} files`);
-        parts.push("hook configured");
-        ok(`Agent metrics → ~/.claude/tools/agent-metrics/ (${parts.join(", ")})`);
-    }
-    else {
-        warn("Agent metrics hook not configured (tool files not found)");
-    }
-    // Health check
-    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) {
-                ok("Health check passed — both APIs reachable");
-            }
-            else {
-                warn("Some APIs unreachable (MCP tools may have limited functionality)");
-            }
-        }
-        catch {
-            warn("Health check skipped (network issue)");
-        }
-    }
-    // Shell export
-    let shellModified = false;
-    if (opts.shell && env.shellProfile) {
-        await writeShellExport(env.shellProfile, apiKey, opts.dryRun);
-        ok(`ULUOPS_API_KEY added to ${env.shellProfile}`);
-        shellModified = 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();
-}
-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();
-}
-async function runUninstall(opts) {
-    const version = await getVersion();
-    console.log();
-    console.log(`  ${chalk.dim("⟨u⟩")} ${chalk.cyan.bold("ulu")}${chalk.bold("·ops")} ${chalk.red("Uninstall")} v${version}`);
-    console.log();
-    if (opts.dryRun) {
-        info(chalk.dim("(dry run — no changes will be made)\n"));
-    }
-    const manifest = await loadManifest();
-    if (!manifest) {
-        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}`);
-    }
-    else {
-        ok(`Would remove MCP servers from ${manifest.mcpConfigPath}`);
-    }
-    // Remove agent metrics hook and tool files
-    if (manifest.metricsHookInstalled) {
-        if (!opts.dryRun) {
-            await uninstallMetrics(false);
-            ok("Removed agent-metrics hook and tool files");
-        }
-        else {
-            ok("Would remove agent-metrics hook and tool files");
-        }
-    }
-    // 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}`);
-        }
-        else if (profile) {
-            ok(`Would remove export from ${profile.path}`);
-        }
-    }
-    // Delete manifest
-    if (!opts.dryRun) {
-        await deleteManifest();
-        ok("Manifest deleted");
-    }
-    console.log();
-    info("UluOps has been removed. Restart Claude Code to complete.");
-    console.log();
-}
-async function runVerify() {
-    const version = await getVersion();
-    console.log();
-    console.log(`  ${chalk.dim("⟨u⟩")} ${chalk.cyan.bold("ulu")}${chalk.bold("·ops")} Installation Check v${version}`);
-    console.log();
-    const result = await verify();
-    for (const check of result.checks) {
-        if (check.passed) {
-            ok(check.label);
-        }
-        else {
-            fail(`${check.label}${check.detail ? ` — ${check.detail}` : ""}`);
-        }
-    }
-    console.log();
-    if (result.ok) {
-        info(chalk.green("All checks passed."));
-    }
-    else {
-        info(chalk.red("Some checks failed. Run npx @uluops/setup to fix."));
-    }
-    console.log();
-    process.exit(result.ok ? 0 : 1);
-}
-async function checkConflicts(localDefs) {
-    const destDir = getAgentsDir(localDefs);
-    const srcDir = join(ASSETS_DIR, "agents");
-    let existingFiles;
-    let assetFiles;
-    try {
-        existingFiles = await readdir(destDir);
-        assetFiles = await readdir(srcDir);
-    }
-    catch {
-        return; // Directory doesn't exist yet
-    }
-    const conflicts = assetFiles.filter((f) => existingFiles.includes(f));
-    if (conflicts.length === 0)
-        return;
-    warn(`Found ${conflicts.length} existing agents that match UluOps definitions:`);
-    for (const f of conflicts.slice(0, 5)) {
-        info(`  ${f}`);
-    }
-    if (conflicts.length > 5) {
-        info(`  ... and ${conflicts.length - 5} more`);
-    }
-    console.log();
-    info("These will be overwritten.");
-    console.log();
-    const { confirm } = await import("@inquirer/prompts");
-    const proceed = await confirm({ message: "Continue?", default: true });
-    if (!proceed) {
-        process.exit(0);
-    }
-}
-async function checkEndpoint(url) {
-    try {
-        const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
-        return res.ok;
-    }
-    catch {
-        return false;
-    }
-}
+import { info, printAgentList } from "./lib/display.js";
+import { getVersion } from "./lib/version.js";
+import { resolveHarnessName, listHarnesses, HarnessNotTestedError, } from "./harnesses/index.js";
+import { runSetup } from "./commands/setup.js";
+import { runUninstall } from "./commands/uninstall.js";
+import { runVerify } from "./commands/verify.js";
 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("--scope <mode>", 'MCP config scope: "global" or "local"', "global")
-        .option("--local-defs", "Save agents/commands locally instead of ~/.claude/", false)
+        .option("--harness <name>", `Target harness: ${listHarnesses().join(", ")} (aliases: claude, oc, gemini)`, "claude-code")
+        .option("--scope <mode>", 'MCP connectivity scope: "global" (~/.claude.json) or "local" (.mcp.json)', "global")
+        .option("--local-defs", "Save agents/commands locally (./uluops/) for project isolation", false)
         .option("--shell", "Write API key export to shell profile", false)
+        .option("--with-cli", "Install @uluops/cli globally without prompting")
+        .option("--no-cli", "Skip @uluops/cli install without prompting (takes precedence over --with-cli)")
         .option("--skip-validation", "Accept API key without verifying", false)
         .option("--list", "Show available agents and workflows without installing")
         .option("--verify", "Check existing installation health")
@@ -400,7 +33,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,18 +51,27 @@ 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,
         scope,
         localDefs: opts.localDefs,
         shell: opts.shell,
+        withCli: opts.withCli,
+        cli: opts.cli,
         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/commands/helpers.d.ts

@@ -0,0 +1,73 @@
+import { detect } from "../steps/detect.js";
+import type { McpResult } from "../steps/mcp.js";
+import type { AgentsResult } from "../steps/agents.js";
+import type { CommandsResult } from "../steps/commands.js";
+import type { MetricsResult } from "../steps/metrics.js";
+import type { CliExecutor, CliInstallResult } from "../steps/cli.js";
+import type { HarnessProfile } from "../harnesses/index.js";
+/** Resolve API key via flag, env, file, signup, or interactive prompt. Returns env detection + key. */
+export declare function initContext(opts: {
+    apiKey?: string;
+    signup: boolean;
+    skipValidation: boolean;
+    yes: boolean;
+}): Promise<{
+    env: Awaited<ReturnType<typeof detect>>;
+    apiKey: string;
+}>;
+/** Write MCP server entries to harness config and report warnings. */
+export declare function configureMcpStep(profile: HarnessProfile, apiKey: string, opts: {
+    scope: "global" | "local";
+    dryRun: boolean;
+}): Promise<McpResult>;
+/** Copy agent definitions from assets to harness directory. */
+export declare function installAgentsDefs(profile: HarnessProfile, opts: {
+    localDefs: boolean;
+    dryRun: boolean;
+}, prev?: string[]): Promise<AgentsResult>;
+/** Copy slash-command definitions from assets (Claude Code only). */
+export declare function installCommandsDefs(profile: HarnessProfile, opts: {
+    localDefs: boolean;
+    dryRun: boolean;
+}, prev?: string[]): Promise<CommandsResult>;
+/** Install agent-metrics hook and tool files (Claude Code only). */
+export declare function configureMetricsStep(profile: HarnessProfile, opts: {
+    dryRun: boolean;
+}): Promise<MetricsResult>;
+/**
+ * Decide whether to install `@uluops/cli` globally and do it (or not).
+ *
+ * Decision matrix:
+ * - `--no-cli` (opts.cli === false) → skip, no prompt
+ * - `--with-cli` (opts.withCli === true) → install, no prompt
+ * - Neither flag + non-interactive (--yes / --api-key / no TTY) → skip
+ * - Neither flag + interactive → prompt (default Y)
+ *
+ * Returns null when the step did not run (skipped). Returns a `CliInstallResult`
+ * when an install attempt was made, with details for the manifest.
+ */
+export declare function configureCliStep(opts: {
+    withCli?: boolean;
+    cli?: boolean;
+    yes: boolean;
+    apiKey?: string;
+    dryRun: boolean;
+    executor?: CliExecutor;
+}): Promise<CliInstallResult | null>;
+/** Ping tracker and registry health endpoints. */
+export declare function runHealthCheck(opts: {
+    skipValidation: boolean;
+    dryRun: boolean;
+}): Promise<void>;
+/** Optionally write ULUOPS_API_KEY export to shell profile. */
+export declare function configureShell(env: {
+    shellProfile: string | null;
+}, apiKey: string, opts: {
+    shell: boolean;
+    yes: boolean;
+    dryRun: boolean;
+}): Promise<boolean>;
+/** Interactive y/N confirmation before writing API key to shell profile. */
+export declare function confirmShellWrite(profilePath: string): Promise<boolean>;
+/** Warn if existing agent files will be overwritten and prompt for confirmation. */
+export declare function checkConflicts(profile: HarnessProfile, localDefs: boolean): Promise<void>;