jobarbiter 0.3.0 → 0.3.2

package/src/index.ts

@@ -4,6 +4,9 @@ import { Command } from "commander";
 import { loadConfig, saveConfig, requireConfig, getConfigPath, type Config } from "./lib/config.js";
 import { api, apiUnauthenticated, ApiError } from "./lib/api.js";
 import { output, outputList, success, error, setJsonMode } from "./lib/output.js";
+import { runOnboardWizard } from "./lib/onboard.js";
+import { detectAgents, installObservers, removeObservers, getObservationStatus } from "./lib/observe.js";
+import { getObservableTools, formatToolDisplay } from "./lib/detect-tools.js";
 
 const program = new Command();
 
@@ -18,57 +21,19 @@ program
 	});
 
 // ============================================================
-// register
+// onboard — Interactive setup wizard (primary entry point)
 // ============================================================
 
 program
-	.command("register")
-	.description("Register a new account and save API key")
-	.requiredOption("--email <email>", "Email address")
-	.requiredOption("--type <type>", "Account type: worker or employer")
+	.command("onboard")
+	.description("Interactive setup wizard — the only command you need to get started")
+	.option("--force", "Start fresh even if already configured")
 	.option("--base-url <url>", "API base URL", "https://jobarbiter-api-production.up.railway.app")
 	.action(async (opts) => {
-		try {
-			const userType = opts.type === "seeker" ? "worker" : opts.type;
-			if (!["worker", "employer"].includes(userType)) {
-				error("Type must be 'worker' or 'employer'");
-				process.exit(1);
-			}
-
-			// Step 1: Register and request verification code
-			const registerData = await apiUnauthenticated(opts.baseUrl, "POST", "/v1/auth/register", {
-				email: opts.email,
-				userType,
-			});
-
-			success(`Verification code sent to ${opts.email} (expires in 15 minutes)`);
-
-			// Step 2: Prompt for verification code
-			const code = await promptForCode();
-			if (!code) {
-				error("Verification cancelled.");
-				process.exit(1);
-			}
-
-			// Step 3: Verify the code
-			const verifyData = await apiUnauthenticated(opts.baseUrl, "POST", "/v1/auth/verify", {
-				email: opts.email,
-				code: code.trim(),
-			});
-
-			// Step 4: Save config with API key
-			saveConfig({
-				apiKey: verifyData.apiKey as string,
-				baseUrl: opts.baseUrl,
-				userType: userType as "worker" | "employer",
-			});
-
-			success(`Email verified! API key saved to ${getConfigPath()}`);
-			console.log(`  Key: ${(verifyData.apiKey as string).slice(0, 20)}... (save this — shown only once)`);
-			output({ id: verifyData.id, email: opts.email, userType });
-		} catch (e) {
-			handleError(e);
-		}
+		await runOnboardWizard({
+			force: opts.force,
+			baseUrl: opts.baseUrl,
+		});
 	});
 
 // ============================================================
@@ -76,7 +41,7 @@ program
 // ============================================================
 
 program
-	.command("verify")
+	.command("verify-email")
 	.description("Verify email with code (if registration was interrupted)")
 	.requiredOption("--email <email>", "Email address")
 	.option("--code <code>", "6-digit verification code")
@@ -746,7 +711,7 @@ program
 // verify
 // ============================================================
 
-const verify = program.command("verify").description("Identity verification");
+const verify = program.command("identity").description("Identity verification (GitHub, LinkedIn, domain)");
 
 verify
 	.command("linkedin <url>")
@@ -815,6 +780,187 @@ program
 		}
 	});
 
+// ============================================================
+// observe (manage coding agent observers)
+// ============================================================
+
+const observe = program.command("observe").description("Manage coding agent proficiency observers");
+
+observe
+	.command("status")
+	.description("Show observer status and accumulated data")
+	.action(async () => {
+		try {
+			const agents = detectAgents();
+			const status = getObservationStatus();
+
+			const detected = agents.filter((a) => a.installed);
+
+			console.log("\n🔍 Coding Agent Observers\n");
+			console.log("  Agents:");
+			for (const agent of agents) {
+				if (!agent.installed) {
+					console.log(`    ⬚ ${agent.name}  (not installed)`);
+				} else if (agent.hookInstalled) {
+					console.log(`    ✅ ${agent.name}  (observer active)`);
+				} else {
+					console.log(`    ⚠️  ${agent.name}  (detected, no observer)`);
+				}
+			}
+
+			console.log("\n  Accumulated Data:");
+			console.log(`    Sessions observed: ${status.totalSessions}`);
+			console.log(`    Total tokens:      ${status.totalTokens.toLocaleString()}`);
+			console.log(`    Agents seen:       ${status.agents.join(", ") || "none yet"}`);
+			console.log(`    Last submitted:    ${status.lastSubmitted || "never"}`);
+
+			if (status.topTools.length > 0) {
+				console.log("\n  Top Tools:");
+				for (const { tool, count } of status.topTools.slice(0, 5)) {
+					console.log(`    ${tool}: ${count} uses`);
+				}
+			}
+
+			console.log(`\n  Data file: ~/.config/jobarbiter/observer/observations.json\n`);
+
+			output({
+				detectedAgents: agents.map((a) => ({
+					id: a.id,
+					name: a.name,
+					installed: a.installed,
+					observerActive: a.hookInstalled,
+				})),
+				...status,
+			});
+		} catch (e) {
+			handleError(e);
+		}
+	});
+
+observe
+	.command("install")
+	.description("Install observers for detected coding agents")
+	.option("--agent <id>", "Install for specific agent (claude-code, cursor, opencode, codex, gemini)")
+	.option("--all", "Install for all detected agents")
+	.action(async (opts) => {
+		try {
+			const agents = detectAgents();
+			const detected = agents.filter((a) => a.installed);
+
+			if (detected.length === 0) {
+				error("No coding agents detected on this system.");
+				console.log("  Supported: Claude Code, Cursor, OpenCode, Codex CLI, Gemini CLI");
+				process.exit(1);
+			}
+
+			let toInstall: string[];
+
+			if (opts.agent) {
+				const agent = agents.find((a) => a.id === opts.agent);
+				if (!agent) {
+					error(`Unknown agent: ${opts.agent}. Available: ${agents.map((a) => a.id).join(", ")}`);
+					process.exit(1);
+				}
+				if (!agent.installed) {
+					error(`${agent.name} is not installed on this system.`);
+					process.exit(1);
+				}
+				toInstall = [opts.agent];
+			} else {
+				toInstall = detected.map((a) => a.id);
+			}
+
+			const result = installObservers(toInstall);
+
+			for (const name of result.installed) {
+				success(`Installed observer for ${name}`);
+			}
+			for (const name of result.skipped) {
+				console.log(`  — ${name} (already installed)`);
+			}
+			for (const { agent: a, error: errMsg } of result.errors) {
+				error(`${a}: ${errMsg}`);
+			}
+
+			output(result);
+		} catch (e) {
+			handleError(e);
+		}
+	});
+
+observe
+	.command("remove")
+	.description("Remove observers from coding agents")
+	.option("--agent <id>", "Remove from specific agent")
+	.option("--all", "Remove from all agents")
+	.action(async (opts) => {
+		try {
+			const agents = detectAgents();
+			const withHooks = agents.filter((a) => a.hookInstalled);
+
+			if (withHooks.length === 0) {
+				console.log("No observers are currently installed.");
+				process.exit(0);
+			}
+
+			let toRemove: string[];
+
+			if (opts.agent) {
+				toRemove = [opts.agent];
+			} else {
+				toRemove = withHooks.map((a) => a.id);
+			}
+
+			const result = removeObservers(toRemove);
+
+			for (const name of result.removed) {
+				success(`Removed observer from ${name}`);
+			}
+			for (const name of result.notFound) {
+				console.log(`  — ${name} (no observer found)`);
+			}
+
+			output(result);
+		} catch (e) {
+			handleError(e);
+		}
+	});
+
+observe
+	.command("review")
+	.description("Review accumulated observation data before submission")
+	.action(async () => {
+		try {
+			const status = getObservationStatus();
+
+			if (!status.hasData) {
+				console.log("\nNo observation data collected yet.");
+				console.log("Use your coding agents normally — data accumulates automatically.\n");
+				process.exit(0);
+			}
+
+			console.log("\n📊 Observation Data Review\n");
+			console.log(`  Sessions: ${status.totalSessions}`);
+			console.log(`  Tokens:   ${status.totalTokens.toLocaleString()}`);
+			console.log(`  Agents:   ${status.agents.join(", ")}`);
+
+			if (status.topTools.length > 0) {
+				console.log("\n  Tool Usage:");
+				for (const { tool, count } of status.topTools) {
+					const bar = "█".repeat(Math.min(count, 30));
+					console.log(`    ${tool.padEnd(25)} ${bar} ${count}`);
+				}
+			}
+
+			console.log(`\n  This data will be submitted as an attestation when you run:`);
+			console.log(`    jobarbiter attest --agent observer --capabilities <auto-generated>\n`);
+
+			output(status);
+		} catch (e) {
+			handleError(e);
+		}
+	});
+
 // ============================================================
 // Helpers
 // ============================================================

package/src/lib/config.ts

@@ -47,7 +47,7 @@ export function saveConfig(config: Config): void {
 export function requireConfig(): Config {
 	const config = loadConfig();
 	if (!config) {
-		console.error("Not configured. Run: jobarbiter register --email YOUR_EMAIL --type seeker");
+		console.error("Not configured. Run: jobarbiter onboard");
 		console.error("Or set JOBARBITER_API_KEY environment variable.");
 		process.exit(1);
 	}