neuvikon 0.2.4 → 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,6 +66,9 @@ 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
 
 | | |

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;
@@ -268,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`.");
 }
@@ -380,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;

package/package.json

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