neuvikon 0.2.13 → 0.2.14

package/README.md

@@ -39,6 +39,8 @@ as being worked on, by whom, with which tool.
 | `neuvikon stop` | Stop tracking |
 | `neuvikon status` | Login, project setup, current ticket |
 | `neuvikon logout` | Revoke this machine's token and forget it |
+| `neuvikon pages [--ticket EWWQ-1]` | List the ticket's project pages, flattened to plain text |
+| `neuvikon pages update "Title" [--ticket EWWQ-1]` | Create or update a page by title, body on stdin (or `--text`) |
 
 `start` also accepts the ticket on stdin, and pulls the reference out of it:
 
@@ -46,6 +48,32 @@ as being worked on, by whom, with which tool.
 pbpaste | npx neuvikon start
 ```
 
+## Project pages
+
+An agent's most useful output often isn't the ticket, it's what it learned
+doing it. `pages` reads and writes the same project pages a person sees in the
+app — the running knowledge base for that project, not a per-ticket scratchpad:
+
+```sh
+npx neuvikon pages --ticket EWWQ-1
+```
+
+```sh
+npx neuvikon pages update "Auth flow" --ticket EWWQ-1 <<'EOF'
+Sessions are issued by convex/auth.ts and expire after 30 days.
+See [[Session storage]] for where they're persisted.
+EOF
+```
+
+An update matches an existing page by title (case-insensitive) and overwrites
+it, so writing to the same title again refines that page instead of piling up
+duplicates. `[[Another Title]]` inside the text becomes a real link to that
+page if a page with that title already exists in the project, same as typing
+it in the editor.
+
+Both commands fall back to whichever ticket `npx neuvikon start` is already
+tracking in this directory when `--ticket` is omitted.
+
 ## Token usage
 
 `start`/`stop` are all an agent can report about itself — no agent knows its own
@@ -97,4 +125,3 @@ pnpm typecheck
 ```
 
 No runtime dependencies, so `npx neuvikon` stays a fast cold start.
-# neuvikon-cli

package/dist/index.mjs

@@ -640,6 +640,25 @@ When the user hands you a Neuvikon ticket — text beginning with a reference li
 
     npx neuvikon start --ticket EWWQ-1
 
+Before you start, and any time you need more context, read the ticket's
+project pages — this is the project's accumulated knowledge, not just this
+ticket's:
+
+    npx neuvikon pages --ticket EWWQ-1
+
+When you learn something worth keeping — how a system works, a decision and
+why, anything future work on this project would benefit from — write it back
+so the next agent or teammate has it:
+
+    npx neuvikon pages update "Some Title" --ticket EWWQ-1 <<'EOF'
+    What you learned.
+    EOF
+
+An update with a title that already exists overwrites that page instead of
+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:
 
     npx neuvikon stop
@@ -907,6 +926,69 @@ async function logout() {
 	info(dim("  Could not reach Neuvikon to revoke the token — revoke it in settings if it leaked."));
 }
 //#endregion
+//#region src/commands/pages.ts
+function requireCredentials() {
+	const credentials = readCredentials();
+	if (!credentials) fail("Not logged in.", "Run `npx neuvikon login` first.");
+	return credentials;
+}
+/** `--ticket` wins; otherwise fall back to whatever this directory is already tracking. */
+function resolveTicketRef(flags) {
+	const ref = flags.get("ticket") ?? readSession()?.ticket;
+	if (!ref) fail("No ticket to look up pages for.", "Pass --ticket EWWQ-1, or run this where `npx neuvikon start` is already tracking one.");
+	return ref;
+}
+/** Both pages subcommands fail the same two ways `start` does; shared so they say so identically. */
+async function request(credentials, path, body) {
+	try {
+		return await post(credentials.url, path, body);
+	} 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;
+	}
+}
+async function list(flags) {
+	const credentials = requireCredentials();
+	const ticketRef = resolveTicketRef(flags);
+	const { pages } = await request(credentials, "/api/agent/pages", {
+		token: credentials.token,
+		ticketRef
+	});
+	if (pages.length === 0) {
+		info(dim(`No pages in ${ticketRef}'s project yet.`));
+		return;
+	}
+	const body = pages.map((page) => `# ${page.title}\n\n${page.text}`).join("\n\n---\n\n");
+	process.stdout.write(`${body}\n`);
+}
+async function update(flags, positional) {
+	const credentials = requireCredentials();
+	const ticketRef = resolveTicketRef(flags);
+	const title = flags.get("title") ?? positional[0];
+	if (!title) fail("A page title is required.", `Pass --title "Auth flow notes", or give it as the first argument.`);
+	const text = (flags.get("text") || await readStdin()).trim();
+	if (!text) fail("No page text given.", "Pipe the page's body in on stdin, or pass --text.");
+	success(`${(await request(credentials, "/api/agent/pages/upsert", {
+		token: credentials.token,
+		ticketRef,
+		title,
+		text
+	})).created ? "Created" : "Updated"} page ${bold(title)} in ${ticketRef}'s project`);
+}
+async function pages(flags, positional) {
+	const [subcommand, ...rest] = positional;
+	switch (subcommand) {
+		case void 0:
+		case "list": return list(flags);
+		case "update": return update(flags, rest);
+		default: fail(`Unknown "pages ${subcommand}".`, "Try `pages` or `pages update`.");
+	}
+}
+//#endregion
 //#region src/commands/start.ts
 const TOOLS = /* @__PURE__ */ new Set([
 	"claude-code",
@@ -1012,6 +1094,13 @@ ${bold("Usage")}
   npx neuvikon status             Show login, project setup and current ticket
   npx neuvikon logout
 
+${bold("Project pages")}
+  npx neuvikon pages                        List the current ticket's project pages
+  npx neuvikon pages update "Title" < notes.txt
+                                   Create or update a page by title
+  Reference another page with [[Its Title]], same as in the editor.
+  Both accept --ticket EWWQ-1 instead of relying on a tracked session.
+
 ${bold("Options")}
   --tool <name>                   claude-code | codex | cursor | other
   --transcript <path>             Read token usage from an agent transcript
@@ -1059,6 +1148,7 @@ async function main() {
 		case "report": return report(flags);
 		case "stop": return stop(flags);
 		case "status": return status();
+		case "pages": return pages(flags, positional);
 		case void 0:
 		case "help":
 		case "--help":

package/package.json

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