neuvikon 0.2.3 → 0.2.5

package/README.md

@@ -49,7 +49,8 @@ pbpaste | npx neuvikon start
 ## Token usage
 
 `start`/`stop` are all an agent can report about itself — no agent knows its own
-token count. On Claude Code the transcript does, so a hook can report it:
+token count. On Claude Code the transcript does, so `login`/`init` wire a hook
+into `.claude/settings.json` for you, whenever that project already has one:
 
 ```jsonc
 // .claude/settings.json
@@ -65,12 +66,16 @@ token count. On Claude Code the transcript does, so a hook can report it:
 turn adds that turn rather than re-counting the conversation. It is silent and
 always exits 0 — a token count is never worth interrupting someone's work.
 
+If `.claude/settings.json` doesn't exist yet, or another agent is the one
+being used, add the block above by hand.
+
 ## Configuration
 
 | | |
 |---|---|
 | `~/.neuvikon/config.json` | Token and deployment URL, `0600` |
 | `.neuvikon-session` | Which ticket this directory is tracking. Git-ignored by `init` |
+| `--dev` | Target the development deployment instead of production |
 | `NEUVIKON_URL` | Point at a self-hosted deployment. `--url` does the same per command |
 | `NEUVIKON_TOKEN` | Use this token instead of logging in — for CI and anywhere a browser cannot open |
 

package/dist/index.mjs

@@ -3,6 +3,62 @@ import { chmodSync, closeSync, existsSync, fstatSync, mkdirSync, openSync, readF
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
 import { spawn } from "node:child_process";
+//#region src/agents/hooks.ts
+const REPORT_COMMAND = "npx neuvikon report";
+const STOP_COMMAND = "npx neuvikon stop";
+function hasCommand(groups, command) {
+	return (groups ?? []).some((group) => group.hooks.some((hook) => hook.command === command));
+}
+function withCommand(groups, command) {
+	if (hasCommand(groups, command)) return groups;
+	return [...groups ?? [], { hooks: [{
+		type: "command",
+		command
+	}] }];
+}
+/**
+* Wires token reporting into Claude Code's own hook system — the one agent
+* whose transcript exposes usage, per `usage.ts`. `Stop` fires after every
+* turn, exactly when `report` should read what the transcript gained since
+* last time; `SessionEnd` is the backstop for `stop` when nobody remembered
+* to run it by hand. Without this, `start`/`stop` are the only events an
+* agent ever sends and token usage never leaves zero.
+*/
+function installClaudeHooks(root) {
+	const relativePath = join(".claude", "settings.json");
+	const path = join(root, relativePath);
+	const raw = existsSync(path) ? readFileSync(path, "utf8") : "";
+	let settings;
+	try {
+		settings = raw.trim() ? JSON.parse(raw) : {};
+	} catch {
+		return {
+			path: relativePath,
+			action: "skipped",
+			reason: "settings.json is not valid JSON"
+		};
+	}
+	const hooks = settings.hooks ?? {};
+	if (hasCommand(hooks.Stop, REPORT_COMMAND) && hasCommand(hooks.SessionEnd, STOP_COMMAND)) return {
+		path: relativePath,
+		action: "unchanged"
+	};
+	const nextSettings = {
+		...settings,
+		hooks: {
+			...hooks,
+			Stop: withCommand(hooks.Stop, REPORT_COMMAND),
+			SessionEnd: withCommand(hooks.SessionEnd, STOP_COMMAND)
+		}
+	};
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(path, `${JSON.stringify(nextSettings, null, 2)}\n`);
+	return {
+		path: relativePath,
+		action: raw ? "updated" : "created"
+	};
+}
+//#endregion
 //#region src/agents/instructions.ts
 /**
 * The bridge between "user pasted a ticket" and "Neuvikon knows about it".
@@ -123,6 +179,7 @@ function installAgentInstructions(root) {
 		if (existsSync(path)) results.push(writeMarkdownTarget(root, target));
 	}
 	if (existsSync(join(root, ".cursor"))) results.push(writeCursorRule(root));
+	if (existsSync(join(root, ".claude"))) results.push(installClaudeHooks(root));
 	const gitignore = ignoreSessionFile(root);
 	if (gitignore) results.push(gitignore);
 	return results;
@@ -142,14 +199,35 @@ function isInstalled(root) {
 //#endregion
 //#region src/config.ts
 /**
-* The deployment the CLI talks to. Overridable so self-hosted installs and
-* local Convex dev deployments work without a separate build.
-*
-* MUST point at the production Convex deployment before publishing: every
-* installed copy of this CLI hardcodes whatever ships here, and a dev
-* deployment can be reset out from under them.
+* The two deployments this CLI knows about. The browser origin is kept here
+* rather than read back from the server, because the API answers on a Convex
+* domain while approval happens on the web app's — one is not derivable from
+* the other, and guessing wrong sends people to a page that does not exist.
+*/
+const DEPLOYMENTS = {
+	production: {
+		api: "https://flexible-bird-801.eu-west-1.convex.site",
+		web: "https://www.neuvikon.space"
+	},
+	development: {
+		api: "https://calm-sturgeon-831.eu-west-1.convex.site",
+		web: "http://localhost:3000"
+	}
+};
+/**
+* `--dev` targets the development deployment; NEUVIKON_URL overrides the API
+* for a self-hosted install, in which case the web origin is unknowable and
+* falls back to the matching default.
 */
-const DEFAULT_SITE_URL = process.env.NEUVIKON_URL ?? "https://flexible-bird-801.eu-west-1.convex.sites";
+function resolveDeployment(flags) {
+	const base = flags.has("dev") ? DEPLOYMENTS.development : DEPLOYMENTS.production;
+	const override = flags.get("url") || process.env.NEUVIKON_URL;
+	return override ? {
+		api: override.trim().replace(/\/+$/, ""),
+		web: base.web
+	} : base;
+}
+const DEFAULT_SITE_URL = process.env.NEUVIKON_URL ?? DEPLOYMENTS.production.api;
 const CONFIG_DIR = join(homedir(), ".neuvikon");
 const CONFIG_PATH = join(CONFIG_DIR, "config.json");
 /**
@@ -247,6 +325,7 @@ function fail(message, hint) {
 function init() {
 	const results = installAgentInstructions(process.cwd());
 	for (const result of results) if (result.action === "unchanged") info(dim(`  ${result.path} — already up to date`));
+	else if (result.action === "skipped") warn(`${result.path} — skipped (${result.reason})`);
 	else success(`${result.path} — ${result.action}`);
 	if (!readCredentials()) warn("Not logged in yet — run `npx neuvikon login`.");
 }
@@ -317,7 +396,8 @@ function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 async function login(flags) {
-	const url = normalizeUrl(flags.get("url") ?? DEFAULT_SITE_URL);
+	const deployment = resolveDeployment(flags);
+	const url = normalizeUrl(deployment.api);
 	let start;
 	try {
 		start = await post(url, "/api/cli/auth/start", {});
@@ -326,12 +406,13 @@ async function login(flags) {
 		if (error instanceof ApiError) fail(error.message);
 		throw error;
 	}
+	const verifyUrl = `${deployment.web}/cli?code=${encodeURIComponent(start.userCode)}`;
 	info("");
-	info(`  Open ${cyan(start.verifyUrl)}`);
+	info(`  Open ${cyan(verifyUrl)}`);
 	info(`  and confirm this code: ${bold(start.userCode)}`);
 	info("");
 	info(dim("  Waiting for approval..."));
-	openBrowser(start.verifyUrl);
+	openBrowser(verifyUrl);
 	const interval = Math.max(1e3, start.intervalMs);
 	for (;;) {
 		if (Date.now() > start.expiresAt) fail("That login request expired.", "Run `npx neuvikon login` to get a fresh code.");
@@ -357,9 +438,12 @@ async function login(flags) {
 		info("");
 		success(`Logged in as ${bold(result.userName)} · ${result.organizationName}`);
 		info(dim(`  Token stored in ${CONFIG_PATH}`));
-		const touched = installAgentInstructions(process.cwd()).filter((entry) => entry.action !== "unchanged");
+		const installed = installAgentInstructions(process.cwd());
+		const touched = installed.filter((entry) => entry.action === "created" || entry.action === "updated");
+		const skipped = installed.filter((entry) => entry.action === "skipped");
 		if (touched.length > 0) success(`Told your coding agent how to report work (${touched.map((e) => e.path).join(", ")})`);
 		else success("Your coding agent already knows how to report work");
+		for (const entry of skipped) if (entry.action === "skipped") warn(`${entry.path} — skipped (${entry.reason})`);
 		info("");
 		info(dim("  Paste a ticket into any coding agent and it will do the rest."));
 		return;
@@ -714,6 +798,7 @@ ${bold("Options")}
   --tool <name>                   claude-code | codex | cursor | other
   --transcript <path>             Read token usage from an agent transcript
   --tokens-in <n> --tokens-out <n>
+  --dev                           Use the development deployment
   --url <site-url>                Point at a self-hosted deployment
 
 ${dim("Paste a ticket into any coding agent after logging in — it takes it from there.")}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neuvikon",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Tell Neuvikon which ticket your coding agent is working on.",
   "keywords": [
     "neuvikon",