neuvikon 0.2.14 → 0.2.16

package/README.md

@@ -1,6 +1,6 @@
 # neuvikon
 
-Tells [Neuvikon](https://neuvikon.com) which ticket your coding agent is working
+Tells [Neuvikon](https://neuvikon.space) which ticket your coding agent is working
 on, and how many tokens it spent doing it.
 
 Works with any agent that reads a rules file and has a shell — Claude Code,

package/dist/index.mjs

@@ -3,6 +3,49 @@ import { chmodSync, closeSync, existsSync, fstatSync, mkdirSync, openSync, readF
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { spawn } from "node:child_process";
+//#region src/api.ts
+var ApiError = class extends Error {
+	status;
+	constructor(message, status) {
+		super(message);
+		this.status = status;
+		this.name = "ApiError";
+	}
+};
+/** A request that never reached the server: offline, DNS, TLS, timeout. */
+var NetworkError = class extends Error {
+	constructor(cause) {
+		super("Could not reach Neuvikon", { cause });
+		this.name = "NetworkError";
+	}
+};
+const TIMEOUT_MS = 15e3;
+/**
+* The one place an HTTP failure becomes a typed error. Callers decide what a
+* failure means — a hook wrapping the agent's turn wants to swallow it, `login`
+* wants to shout about it.
+*/
+async function post(url, path, body) {
+	let response;
+	try {
+		response = await fetch(`${url}${path}`, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(TIMEOUT_MS)
+		});
+	} catch (error) {
+		throw new NetworkError(error);
+	}
+	const payload = await response.json().catch(() => ({}));
+	const error = typeof payload === "object" && payload !== null ? payload.error : void 0;
+	if (!response.ok) throw new ApiError(typeof error === "string" ? error : `Request failed with status ${response.status}`, response.status);
+	return payload;
+}
+function normalizeUrl(url) {
+	return url.trim().replace(/\/+$/, "");
+}
+//#endregion
 //#region src/config.ts
 /**
 * The two deployments this CLI knows about. The browser origin is kept here
@@ -93,49 +136,6 @@ function clearCredentials() {
 	}
 }
 //#endregion
-//#region src/api.ts
-var ApiError = class extends Error {
-	status;
-	constructor(message, status) {
-		super(message);
-		this.status = status;
-		this.name = "ApiError";
-	}
-};
-/** A request that never reached the server: offline, DNS, TLS, timeout. */
-var NetworkError = class extends Error {
-	constructor(cause) {
-		super("Could not reach Neuvikon", { cause });
-		this.name = "NetworkError";
-	}
-};
-const TIMEOUT_MS = 15e3;
-/**
-* The one place an HTTP failure becomes a typed error. Callers decide what a
-* failure means — a hook wrapping the agent's turn wants to swallow it, `login`
-* wants to shout about it.
-*/
-async function post(url, path, body) {
-	let response;
-	try {
-		response = await fetch(`${url}${path}`, {
-			method: "POST",
-			headers: { "content-type": "application/json" },
-			body: JSON.stringify(body),
-			signal: AbortSignal.timeout(TIMEOUT_MS)
-		});
-	} catch (error) {
-		throw new NetworkError(error);
-	}
-	const payload = await response.json().catch(() => ({}));
-	const error = typeof payload === "object" && payload !== null ? payload.error : void 0;
-	if (!response.ok) throw new ApiError(typeof error === "string" ? error : `Request failed with status ${response.status}`, response.status);
-	return payload;
-}
-function normalizeUrl(url) {
-	return url.trim().replace(/\/+$/, "");
-}
-//#endregion
 //#region src/session.ts
 /**
 * Distinguishes concurrent agents working in the *same* checkout — two Claude
@@ -184,6 +184,74 @@ function clearSession() {
 	} catch {}
 }
 //#endregion
+//#region src/ui.ts
+/**
+* Output helpers. Everything the agent shouldn't parse goes to stderr, so a
+* command's stdout stays a clean, pipeable value.
+*/
+const useColor = process.env.NO_COLOR === void 0 && process.stderr.isTTY === true;
+function paint(code, text) {
+	return useColor ? `\x1b[${code}m${text}\x1b[0m` : text;
+}
+const dim = (text) => paint("2", text);
+const bold = (text) => paint("1", text);
+const green = (text) => paint("32", text);
+const red = (text) => paint("31", text);
+const cyan = (text) => paint("36", text);
+function info(message) {
+	process.stderr.write(`${message}\n`);
+}
+function success(message) {
+	process.stderr.write(`${green("✓")} ${message}\n`);
+}
+function warn(message) {
+	process.stderr.write(`${red("!")} ${message}\n`);
+}
+/** Ends the process. Every user-facing failure funnels through here. */
+function fail(message, hint) {
+	process.stderr.write(`${red("✗")} ${message}\n`);
+	if (hint) process.stderr.write(`  ${dim(hint)}\n`);
+	process.exit(1);
+}
+//#endregion
+//#region src/commands/board.ts
+function requireCredentials$3() {
+	const credentials = readCredentials();
+	if (!credentials) fail("Not logged in.", "Run `npx neuvikon login` first.");
+	return credentials;
+}
+function resolveTicketRef$3(flags) {
+	const ref = flags.get("ticket") ?? readSession()?.ticket;
+	if (!ref) fail("No ticket to look up a board for.", "Pass --ticket EWWQ-1, or run this where `npx neuvikon start` is already tracking one.");
+	return ref;
+}
+/**
+* Shows an agent the real shape of this project's board before it guesses at
+* a column name — boards vary per project, and some have no "done" at all.
+*/
+async function board(flags) {
+	const credentials = requireCredentials$3();
+	const ticketRef = resolveTicketRef$3(flags);
+	let result;
+	try {
+		result = await post(credentials.url, "/api/agent/board", {
+			token: credentials.token,
+			ticketRef
+		});
+	} catch (error) {
+		if (error instanceof NetworkError) fail("Could not reach Neuvikon.");
+		if (error instanceof ApiError) {
+			if (error.status === 401) fail(error.message, "Run `npx neuvikon login` again.");
+			fail(error.message);
+		}
+		throw error;
+	}
+	info(`${ticketRef} is on ${bold(result.currentColumn || "(no column)")}`);
+	info(dim("Columns, in board order:"));
+	for (const column of result.columns) info(`  - ${column.name}${column.isDone ? dim(" (terminal)") : ""}`);
+	if (!result.columns.some((column) => column.isDone)) info(dim("No column is marked terminal on this board — use your judgment on what counts as done."));
+}
+//#endregion
 //#region src/ticket.ts
 /**
 * Ticket refs look like `AWKN-14`. This pattern is deliberately looser than the
@@ -209,6 +277,40 @@ async function readStdin() {
 	return Buffer.concat(chunks).toString("utf8");
 }
 //#endregion
+//#region src/commands/comment.ts
+function requireCredentials$2() {
+	const credentials = readCredentials();
+	if (!credentials) fail("Not logged in.", "Run `npx neuvikon login` first.");
+	return credentials;
+}
+function resolveTicketRef$2(flags) {
+	const ref = flags.get("ticket") ?? readSession()?.ticket;
+	if (!ref) fail("No ticket to comment on.", "Pass --ticket EWWQ-1, or run this where `npx neuvikon start` is already tracking one.");
+	return ref;
+}
+/** A note on a ticket that doesn't move it — e.g. explaining a handoff mid-ticket. */
+async function comment(flags) {
+	const credentials = requireCredentials$2();
+	const ticketRef = resolveTicketRef$2(flags);
+	const text = (flags.get("text") || await readStdin()).trim();
+	if (!text) fail("No comment text given.", "Pipe the comment in on stdin, or pass --text.");
+	try {
+		await post(credentials.url, "/api/agent/comment", {
+			token: credentials.token,
+			ticketRef,
+			comment: text
+		});
+	} catch (error) {
+		if (error instanceof NetworkError) fail("Could not reach Neuvikon.");
+		if (error instanceof ApiError) {
+			if (error.status === 401) fail(error.message, "Run `npx neuvikon login` again.");
+			fail(error.message);
+		}
+		throw error;
+	}
+	success(`Commented on ${ticketRef}`);
+}
+//#endregion
 //#region src/usage.ts
 /**
 * Sums token usage out of a JSONL agent transcript, starting from `offset`.
@@ -336,36 +438,6 @@ function claudeTranscriptPath() {
 	}
 }
 //#endregion
-//#region src/ui.ts
-/**
-* Output helpers. Everything the agent shouldn't parse goes to stderr, so a
-* command's stdout stays a clean, pipeable value.
-*/
-const useColor = process.env.NO_COLOR === void 0 && process.stderr.isTTY === true;
-function paint(code, text) {
-	return useColor ? `\x1b[${code}m${text}\x1b[0m` : text;
-}
-const dim = (text) => paint("2", text);
-const bold = (text) => paint("1", text);
-const green = (text) => paint("32", text);
-const red = (text) => paint("31", text);
-const cyan = (text) => paint("36", text);
-function info(message) {
-	process.stderr.write(`${message}\n`);
-}
-function success(message) {
-	process.stderr.write(`${green("✓")} ${message}\n`);
-}
-function warn(message) {
-	process.stderr.write(`${red("!")} ${message}\n`);
-}
-/** Ends the process. Every user-facing failure funnels through here. */
-function fail(message, hint) {
-	process.stderr.write(`${red("✗")} ${message}\n`);
-	if (hint) process.stderr.write(`  ${dim(hint)}\n`);
-	process.exit(1);
-}
-//#endregion
 //#region src/commands/report.ts
 /**
 * Agent hooks hand their context to the command on stdin as JSON. Reading the
@@ -659,12 +731,42 @@ creating a duplicate, so reuse a title for anything you're extending.
 Reference another page by writing its title in double brackets, e.g.
 \`[[Auth Flow]]\` — it becomes a real link if that page already exists.
 
-When you finish that ticket, or the user moves you to a different one, run:
+Before you change the ticket's status, look at what columns this project's
+board actually has — they vary per project, and there may be no column
+literally called "Done":
+
+    npx neuvikon board --ticket EWWQ-1
+
+Then decide, based on what's actually true, not on finishing your turn:
+
+- The work is really done — merged to main, deployed, whatever "done" means
+  for this project — move it to that board's terminal column (the one
+  \`board\` marks as terminal), and say why:
+
+      npx neuvikon move --ticket EWWQ-1 --column "Done" --comment "Merged to main in #142"
+
+- The work needs a step before done — a PR is open, it's waiting on review,
+  it's blocked — move it to whichever real column matches that, with the
+  same reasoning:
+
+      npx neuvikon move --ticket EWWQ-1 --column "Code Review" --comment "PR up, waiting on review"
+
+- If the board has no column that fits, or you're just leaving a note without
+  changing where the ticket sits (e.g. handing off mid-ticket), comment
+  instead of moving:
+
+      npx neuvikon comment --ticket EWWQ-1 --text "Handing off — blocked on design"
+
+A ticket that isn't actually finished should never land on a terminal column
+just because you're done for now. When you finish that ticket, or the user
+moves you to a different one, also run:
 
     npx neuvikon stop
 
-This is bookkeeping that tells the user's team which ticket you are on. You do
-not need to narrate these commands, and if one fails, carry on with the actual
+\`stop\` only tells the team you're no longer working on it — it does not move
+the ticket, since stopping and finishing are not the same thing. This is
+bookkeeping that tells the user's team which ticket you are on. You do not
+need to narrate these commands, and if one fails, carry on with the actual
 work — never let it block you.`;
 function instructionBlock() {
 	return `${START_MARKER}\n${INSTRUCTION_BODY}\n${END_MARKER}`;
@@ -926,6 +1028,49 @@ async function logout() {
 	info(dim("  Could not reach Neuvikon to revoke the token — revoke it in settings if it leaked."));
 }
 //#endregion
+//#region src/commands/move.ts
+function requireCredentials$1() {
+	const credentials = readCredentials();
+	if (!credentials) fail("Not logged in.", "Run `npx neuvikon login` first.");
+	return credentials;
+}
+function resolveTicketRef$1(flags) {
+	const ref = flags.get("ticket") ?? readSession()?.ticket;
+	if (!ref) fail("No ticket to move.", "Pass --ticket EWWQ-1, or run this where `npx neuvikon start` is already tracking one.");
+	return ref;
+}
+/**
+* Explicit column change, e.g. `npx neuvikon move --column "Code Review" \
+* --comment "PR up, waiting on review"`. A comment is mandatory: this is the
+* command that lands a ticket on a done-like column, and it should never do
+* that silently.
+*/
+async function move(flags) {
+	const credentials = requireCredentials$1();
+	const ticketRef = resolveTicketRef$1(flags);
+	const column = flags.get("column");
+	if (!column) fail("A target column is required.", `Pass --column "Code Review" — run \`npx neuvikon board\` first if you're not sure what this project calls it.`);
+	const comment = (flags.get("comment") || await readStdin()).trim();
+	if (!comment) fail("A comment is required.", "Pass --comment \"why this ticket is moving\", e.g. \"Merged to main.\"");
+	let result;
+	try {
+		result = await post(credentials.url, "/api/agent/move", {
+			token: credentials.token,
+			ticketRef,
+			column,
+			comment
+		});
+	} catch (error) {
+		if (error instanceof NetworkError) fail("Could not reach Neuvikon.");
+		if (error instanceof ApiError) {
+			if (error.status === 401) fail(error.message, "Run `npx neuvikon login` again.");
+			fail(error.message);
+		}
+		throw error;
+	}
+	success(`Moved ${ticketRef} to ${bold(result.column)}`);
+}
+//#endregion
 //#region src/commands/pages.ts
 function requireCredentials() {
 	const credentials = readCredentials();
@@ -1094,6 +1239,14 @@ ${bold("Usage")}
   npx neuvikon status             Show login, project setup and current ticket
   npx neuvikon logout
 
+${bold("Board")}
+  npx neuvikon board                        Show this project's columns and where the ticket sits
+  npx neuvikon move --column "Code Review" --comment "PR up, waiting on review"
+                                   Move the ticket to a specific column, with why
+  npx neuvikon comment --text "Handing off, blocked on design"
+                                   Leave a note without changing the column
+  All three accept --ticket EWWQ-1 instead of relying on a tracked session.
+
 ${bold("Project pages")}
   npx neuvikon pages                        List the current ticket's project pages
   npx neuvikon pages update "Title" < notes.txt
@@ -1149,6 +1302,9 @@ async function main() {
 		case "stop": return stop(flags);
 		case "status": return status();
 		case "pages": return pages(flags, positional);
+		case "board": return board(flags);
+		case "move": return move(flags);
+		case "comment": return comment(flags);
 		case void 0:
 		case "help":
 		case "--help":

package/package.json

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