jobarbiter 0.3.0 → 0.3.1

package/dist/index.js

@@ -3,6 +3,8 @@ import { Command } from "commander";
 import { saveConfig, requireConfig, getConfigPath } 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";
 const program = new Command();
 program
     .name("jobarbiter")
@@ -15,57 +17,24 @@ program
         setJsonMode(true);
 });
 // ============================================================
-// 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,
-            baseUrl: opts.baseUrl,
-            userType: userType,
-        });
-        success(`Email verified! API key saved to ${getConfigPath()}`);
-        console.log(`  Key: ${verifyData.apiKey.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,
+    });
 });
 // ============================================================
 // verify (standalone verification for existing registrations)
 // ============================================================
 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")
@@ -706,7 +675,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>")
     .description("Submit LinkedIn profile for verification")
@@ -774,6 +743,166 @@ 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;
+        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;
+        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
 // ============================================================
 function handleError(e) {

package/dist/lib/config.js

@@ -35,7 +35,7 @@ export function saveConfig(config) {
 export function requireConfig() {
     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);
     }

package/dist/lib/observe.d.ts

@@ -0,0 +1,48 @@
+/**
+ * JobArbiter Observer — Hook installer for coding agent CLIs
+ *
+ * Detects installed coding agents, installs observation hooks that
+ * extract proficiency signals from session transcripts.
+ */
+export interface DetectedAgent {
+    id: string;
+    name: string;
+    configDir: string;
+    hookFormat: "claude" | "cursor" | "opencode" | "codex" | "gemini";
+    installed: boolean;
+    hookInstalled: boolean;
+}
+export declare function detectAgents(): DetectedAgent[];
+/**
+ * Install observer hooks for the specified agents.
+ * Returns a summary of what was installed.
+ */
+export declare function installObservers(agentIds: string[]): {
+    installed: string[];
+    skipped: string[];
+    errors: Array<{
+        agent: string;
+        error: string;
+    }>;
+};
+/**
+ * Remove observer hooks for the specified agents.
+ */
+export declare function removeObservers(agentIds: string[]): {
+    removed: string[];
+    notFound: string[];
+};
+/**
+ * Get observation status — what's been accumulated locally.
+ */
+export declare function getObservationStatus(): {
+    hasData: boolean;
+    totalSessions: number;
+    totalTokens: number;
+    topTools: Array<{
+        tool: string;
+        count: number;
+    }>;
+    agents: string[];
+    lastSubmitted: string | null;
+};