@uluops/setup 0.2.0 → 0.6.0

package/dist/steps/verify.js

@@ -1,149 +1,165 @@
-import { readdir, access } from "node:fs/promises";
+import { readdir, access, stat } from "node:fs/promises";
 import { join } from "node:path";
 import { loadManifest } from "../lib/manifest.js";
-import { readConfig } from "../lib/config-merger.js";
-import { readSettings, hasUluopsHook } from "../lib/settings-merger.js";
-import { getMetricsToolDir, getSettingsPath } from "./metrics.js";
-export async function verify() {
-    const checks = [];
+import { getHealthTimeout } from "../lib/health.js";
+import { getProfile } from "../harnesses/index.js";
+import { readInstalledMetricsVersion } from "./metrics.js";
+/** Verify a single harness entry, appending results to checks. Returns false if any check fails. */
+async function verifyHarness(harnessName, hm, checks) {
     let allOk = true;
-    // 1. Manifest
-    const manifest = await loadManifest();
-    if (!manifest) {
-        checks.push({
-            label: "Manifest found",
-            passed: false,
-            detail: "No manifest — run npx @uluops/setup first",
-        });
-        return { ok: false, checks };
+    let profile;
+    try {
+        profile = getProfile(harnessName);
     }
-    checks.push({
-        label: `Manifest found (v${manifest.version}, installed ${manifest.installedAt.split("T")[0]})`,
-        passed: true,
-    });
-    // 2. MCP config
-    const config = await readConfig(manifest.mcpConfigPath);
-    const hasTracker = !!config.mcpServers?.["uluops-tracker"];
-    const hasRegistry = !!config.mcpServers?.["uluops-registry"];
-    if (hasTracker && hasRegistry) {
+    catch {
+        checks.push({ label: `Harness: ${harnessName}`, passed: false, detail: "Unknown harness in manifest" });
+        return false;
+    }
+    // 1. Readiness Check (Harness Restart)
+    try {
+        const configStat = await stat(hm.mcpConfigPath);
+        const installedTime = new Date(hm.installedAt).getTime();
+        const configTime = configStat.mtimeMs;
+        // If config was modified AFTER install, it's a proxy for the harness having read it.
+        // We add a 100ms buffer to handle near-simultaneous writes.
+        const isReady = configTime > (installedTime + 100);
         checks.push({
-            label: `MCP config present in ${manifest.mcpConfigPath} (2 servers)`,
+            label: `[${profile.displayName}] Readiness`,
             passed: true,
+            detail: isReady ? "Active (loaded)" : "Waiting for restart",
         });
     }
-    else {
-        checks.push({
-            label: "MCP config",
-            passed: false,
-            detail: `Missing: ${[!hasTracker && "tracker", !hasRegistry && "registry"].filter(Boolean).join(", ")}`,
-        });
-        allOk = false;
+    catch {
+        // If we can't stat it, we'll catch the error in the MCP config check below.
     }
-    // 3. Agent files
-    const agentsDir = join(manifest.defsPath, "agents");
+    // 2. MCP config
     try {
-        const agentFiles = await readdir(agentsDir);
-        const found = manifest.agents.filter((a) => agentFiles.includes(a)).length;
-        if (found === manifest.agents.length) {
-            checks.push({
-                label: `${found}/${manifest.agents.length} agents in ${agentsDir}`,
-                passed: true,
-            });
+        const config = await profile.mcpConfig.read(hm.mcpConfigPath);
+        if (profile.mcpConfig.check(config)) {
+            checks.push({ label: `[${profile.displayName}] MCP config present in ${hm.mcpConfigPath} (2 servers)`, passed: true });
         }
         else {
-            checks.push({
-                label: `${found}/${manifest.agents.length} agents in ${agentsDir}`,
-                passed: false,
-                detail: `Missing ${manifest.agents.length - found} agent(s)`,
-            });
+            checks.push({ label: `[${profile.displayName}] MCP config`, passed: false, detail: "UluOps servers not found in config" });
             allOk = false;
         }
     }
     catch {
+        checks.push({ label: `[${profile.displayName}] MCP config`, passed: false, detail: `Cannot read ${hm.mcpConfigPath}` });
+        allOk = false;
+    }
+    // Agent files
+    const agentsDir = join(hm.defsPath, "agents");
+    try {
+        const agentFiles = await readdir(agentsDir);
+        const found = hm.agents.filter((a) => agentFiles.includes(a)).length;
         checks.push({
-            label: "Agent files",
-            passed: false,
-            detail: `Directory not found: ${agentsDir}`,
+            label: `[${profile.displayName}] ${found}/${hm.agents.length} agents in ${agentsDir}`,
+            passed: found === hm.agents.length,
+            detail: found < hm.agents.length ? `Missing ${hm.agents.length - found} agent(s)` : undefined,
         });
+        if (found < hm.agents.length)
+            allOk = false;
+    }
+    catch {
+        checks.push({ label: `[${profile.displayName}] Agent files`, passed: false, detail: `Directory not found: ${agentsDir}` });
         allOk = false;
     }
-    // 4. Command files
-    const commandsDir = join(manifest.defsPath, "commands");
-    try {
-        let found = 0;
-        for (const cmd of manifest.commands) {
+    // Command files
+    if (hm.commands.length > 0) {
+        const commandsDir = join(hm.defsPath, "commands");
+        const cmdResults = await Promise.all(hm.commands.map(async (cmd) => {
             try {
                 await access(join(commandsDir, cmd));
-                found++;
+                return true;
             }
             catch {
-                // Missing
+                return false;
             }
-        }
-        if (found === manifest.commands.length) {
-            checks.push({
-                label: `${found}/${manifest.commands.length} commands in ${commandsDir}`,
-                passed: true,
-            });
-        }
-        else {
-            checks.push({
-                label: `${found}/${manifest.commands.length} commands in ${commandsDir}`,
-                passed: false,
-                detail: `Missing ${manifest.commands.length - found} command(s)`,
-            });
-            allOk = false;
-        }
-    }
-    catch {
+        }));
+        const found = cmdResults.filter(Boolean).length;
         checks.push({
-            label: "Command files",
-            passed: false,
-            detail: `Directory not found: ${commandsDir}`,
+            label: `[${profile.displayName}] ${found}/${hm.commands.length} commands`,
+            passed: found === hm.commands.length,
+            detail: found < hm.commands.length ? `Missing ${hm.commands.length - found} command(s)` : undefined,
         });
-        allOk = false;
+        if (found < hm.commands.length)
+            allOk = false;
     }
-    // 5. Agent metrics hook
-    if (manifest.metricsHookInstalled) {
-        const settings = await readSettings(getSettingsPath());
-        const hookPresent = hasUluopsHook(settings);
-        const toolDir = getMetricsToolDir();
+    // Hooks
+    if (hm.hooksInstalled && profile.hooks && profile.paths.settingsPath) {
+        const hookPresent = await profile.hooks.check(profile.paths.settingsPath);
         let hookFilePresent = false;
-        try {
-            await access(join(toolDir, "dist", "hook.js"));
-            hookFilePresent = true;
-        }
-        catch {
-            // Missing
+        if (profile.paths.toolsDir) {
+            try {
+                await access(join(profile.paths.toolsDir, "dist", "hook.js"));
+                hookFilePresent = true;
+            }
+            catch { /* Missing */ }
         }
         if (hookPresent && hookFilePresent) {
+            // Existence is necessary but not sufficient — check version drift against the
+            // currently-resolvable agent-metrics. Without this, verify cannot detect that
+            // a fresh setup release is shipping while the installed hook is stale.
+            const installedVersion = profile.paths.toolsDir
+                ? await readInstalledMetricsVersion(profile.paths.toolsDir)
+                : null;
+            const recordedVersion = hm.hooksInstalledVersion ?? null;
+            const detail = installedVersion
+                ? `v${installedVersion}${recordedVersion && recordedVersion !== installedVersion ? ` (manifest records v${recordedVersion} — out of sync)` : ""}`
+                : "version unknown";
             checks.push({
-                label: "Agent metrics hook configured and tool files present",
+                label: `[${profile.displayName}] Agent metrics hook configured`,
                 passed: true,
+                detail,
             });
+            if (recordedVersion && installedVersion && recordedVersion !== installedVersion) {
+                // Drift between manifest record and on-disk hook copy — not a hard failure
+                // because verify is read-only, but surface it so the user re-runs setup.
+                allOk = false;
+            }
         }
         else {
             const missing = [
-                !hookPresent && "hook not in settings.json",
-                !hookFilePresent && "hook.js not found",
-            ]
-                .filter(Boolean)
-                .join(", ");
-            checks.push({
-                label: "Agent metrics",
-                passed: false,
-                detail: missing,
-            });
+                ...(!hookPresent ? ["hook not in settings"] : []),
+                ...(!hookFilePresent ? ["hook.js not found"] : []),
+            ].join(", ");
+            checks.push({ label: `[${profile.displayName}] Agent metrics`, passed: false, detail: missing });
             allOk = false;
         }
     }
-    // 6. API connectivity
-    const apiKey = extractApiKey(config);
+    return allOk;
+}
+/** Run all verification checks against the current installation and return structured results. */
+export async function verify() {
+    const checks = [];
+    let allOk = true;
+    // 1. Manifest
+    const manifest = await loadManifest();
+    if (!manifest) {
+        checks.push({
+            label: "Manifest found",
+            passed: false,
+            detail: "No manifest — run npx @uluops/setup first",
+        });
+        return { ok: false, checks };
+    }
+    checks.push({
+        label: `Manifest found (v${manifest.version}, installed ${manifest.installedAt.split("T")[0]})`,
+        passed: true,
+    });
+    // 2. Per-harness checks
+    for (const [harnessName, hm] of Object.entries(manifest.harnesses)) {
+        const ok = await verifyHarness(harnessName, hm, checks);
+        if (!ok)
+            allOk = false;
+    }
+    // 3. API connectivity (harness-agnostic)
+    const apiKey = process.env["ULUOPS_API_KEY"];
     if (apiKey) {
         try {
             const res = await fetch("https://api.uluops.ai/api/v1/registry/users/me", {
                 headers: { Authorization: `Bearer ${apiKey}` },
-                signal: AbortSignal.timeout(5000),
+                signal: AbortSignal.timeout(getHealthTimeout()),
             });
             if (res.ok) {
                 const data = (await res.json());
@@ -172,13 +188,3 @@ export async function verify() {
     }
     return { ok: allOk, checks };
 }
-function extractApiKey(config) {
-    const raw = config.mcpServers;
-    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-        return process.env["ULUOPS_API_KEY"];
-    }
-    const servers = raw;
-    return (servers["uluops-registry"]?.env?.["ULUOPS_API_KEY"] ??
-        servers["uluops-tracker"]?.env?.["ULUOPS_TRACKER_API_KEY"] ??
-        process.env["ULUOPS_API_KEY"]);
-}

package/package.json

@@ -1,36 +1,62 @@
 {
   "name": "@uluops/setup",
-  "version": "0.2.0",
-  "description": "Zero-friction installer for UluOps + Claude Code",
+  "version": "0.6.0",
+  "description": "Zero-friction installer for UluOps agentic harnesses",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Uluops/-uluops-setup.git"
+  },
+  "homepage": "https://uluops.ai",
+  "keywords": [
+    "uluops",
+    "mcp",
+    "agents",
+    "claude",
+    "opencode",
+    "agentic",
+    "harness",
+    "setup",
+    "installer"
+  ],
   "type": "module",
   "bin": {
     "uluops-setup": "./dist/cli.js"
   },
+  "exports": {
+    "./cli": "./dist/cli.js"
+  },
   "files": [
-    "dist",
+    "dist/cli.js",
+    "dist/cli.d.ts",
+    "dist/lib/**",
+    "dist/steps/**",
+    "dist/harnesses/**",
+    "dist/commands/**",
     "assets"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc -p tsconfig.build.json",
     "dev": "tsx src/cli.ts",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit && tsc -p tsconfig.test.json --noEmit",
     "test": "vitest run",
     "test:watch": "vitest watch",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@inquirer/prompts": "^7.0.0",
-    "@uluops/agent-metrics": "^0.2.0",
-    "chalk": "^5.0.0",
-    "commander": "^12.0.0"
+    "@inquirer/prompts": "7.10.1",
+    "@uluops/agent-metrics": "0.4.0",
+    "chalk": "5.6.2",
+    "commander": "12.1.0",
+    "jsonc-parser": "3.3.1"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
+    "@types/node": "22.19.15",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
   }
 }