@vecteur/cli 0.2.1 → 0.2.3

package/dist/commands/chat.js

@@ -9,8 +9,9 @@
 import { createInterface } from "node:readline";
 import { loadConfig } from "../config.js";
 import { login } from "./auth.js";
+import { refreshUpdateCache, updateNoticeFromCache } from "../update.js";
 import { streamTurn, webBase, buildLocalContextQuery, openBrowser } from "../runner.js";
-import { handleSlashCommand, parseMentions, resolveWorkspaceProject } from "../session.js";
+import { handleSlashCommand, parseMentions, renameProject, resolveWorkspaceProject, titleFromPrompt } from "../session.js";
 const DIM = "\x1b[2m", RESET = "\x1b[0m", CYAN = "\x1b[36m", BOLD = "\x1b[1m";
 export async function chat() {
     let cfg = loadConfig();
@@ -30,6 +31,9 @@ export async function chat() {
     }
     const { id: project, created } = await resolveWorkspaceProject();
     const cwd = process.cwd();
+    // Refresh the update cache (throttled to once/day) so the notice shows this run, not next.
+    await refreshUpdateCache();
+    const updateNotice = updateNoticeFromCache();
     const useInk = Boolean(process.stdout.isTTY) &&
         (process.stdout.columns ?? 0) >= 60 &&
         (process.stdout.rows ?? 0) >= 10 &&
@@ -45,13 +49,17 @@ export async function chat() {
             cwd,
             created,
             userLabel: cfg.tokenPrefix ?? "user",
+            updateNotice,
         }));
         await instance.waitUntilExit();
         return;
     }
     console.log(`${BOLD}Vecteur${RESET} ${DIM}— space-engineering agent in your terminal${RESET}`);
     console.log(`${DIM}workspace: ${cwd}${RESET}`);
-    console.log(`${DIM}project:   ${project}${created ? " (new)" : ""}  ·  /help for commands${RESET}\n`);
+    console.log(`${DIM}project:   ${project}${created ? " (new)" : ""}  ·  /help for commands${RESET}`);
+    if (updateNotice)
+        console.log(`\x1b[33m${updateNotice}${RESET}`);
+    console.log("");
     const rl = createInterface({ input: process.stdin, output: process.stdout, prompt: `${CYAN}› ${RESET}` });
     let turns = 0;
     let lastTaskId; // threads multi-turn context to the next turn
@@ -105,6 +113,9 @@ export async function chat() {
             console.log("\n" + (res.answer ?? "(no answer)") + "\n");
             if (res.sawVisual)
                 console.log(`${DIM}(visual artifacts — see ${webBase()}/projects/${project})${RESET}`);
+            // First prompt in a freshly-created project becomes its title (self-describing in the web app).
+            if (created && turns === 0)
+                void renameProject(project, titleFromPrompt(raw));
             lastTaskId = res.taskId;
             turns++;
         }

package/dist/index.js

@@ -11,7 +11,7 @@ import { listProjects } from "./commands/projects.js";
 import { ask } from "./commands/ask.js";
 import { chat } from "./commands/chat.js";
 import { VERSION } from "./version.js";
-import { maybeNotifyUpdate, runUpdate } from "./update.js";
+import { refreshUpdateCache, runUpdate } from "./update.js";
 const program = new Command();
 program
     .name("vecteur")
@@ -77,6 +77,6 @@ async function run(fn) {
         }
     }
 }
-// Non-blocking update notice (cached banner now; background registry refresh once/day).
-maybeNotifyUpdate();
+// Keep the update cache warm for all commands (throttled once/day); `chat` shows the notice in-TUI.
+void refreshUpdateCache();
 program.parseAsync(process.argv);

package/dist/session.js

@@ -7,14 +7,33 @@ export async function resolveWorkspaceProject() {
     const bound = getWorkspaceProject(cwd);
     if (bound)
         return { id: bound, created: false };
-    const name = basename(cwd) || "workspace";
+    // Provisional, unique title until the first prompt renames it: "<dir> · <datetime>".
+    // The directory tells you where it came from; the timestamp keeps same-named dirs distinct.
+    const dir = basename(cwd) || "workspace";
+    const stamp = new Date().toISOString().slice(0, 16).replace("T", " ");
     const proj = await api("/api/v1/projects", {
         method: "POST",
-        body: { name: `${name} (CLI)` },
+        body: { name: `${dir} · ${stamp}` },
     });
     setWorkspaceProject(cwd, proj.id);
     return { id: proj.id, created: true };
 }
+/** A short, human project title from the user's first prompt (collapsed + capped to 60 chars). */
+export function titleFromPrompt(raw) {
+    const t = raw.replace(/\s+/g, " ").trim();
+    return t.length > 60 ? `${t.slice(0, 57).trimEnd()}…` : t;
+}
+/** Rename a project (best-effort — a nicer title must never break or block a turn). */
+export async function renameProject(projectId, name) {
+    if (!name)
+        return;
+    try {
+        await api(`/api/v1/projects/${projectId}`, { method: "PUT", body: { name } });
+    }
+    catch {
+        /* ignore — title is cosmetic */
+    }
+}
 /** Split a line into the prompt text and any @path file mentions. */
 export function parseMentions(line) {
     const files = [];
@@ -27,6 +46,7 @@ export function parseMentions(line) {
     return { text: text.trim(), files };
 }
 export const SLASH_COMMANDS = [
+    { name: "usage", desc: "show remaining AI usage, forecast and granted pools" },
     { name: "files", desc: "list files in this workspace directory" },
     { name: "project", desc: "show the project bound to this directory" },
     { name: "open", desc: "open this workspace's run in the web app" },
@@ -35,6 +55,44 @@ export const SLASH_COMMANDS = [
     { name: "help", desc: "show this help" },
     { name: "exit", desc: "quit" },
 ];
+/** 1,000 usage units ≈ 1 minute — same vocabulary as the web app and MCP. */
+export function unitsAsTime(units) {
+    if (units < 0)
+        return "unlimited";
+    const minutes = Math.round(units / 1000);
+    if (minutes < 60)
+        return `${minutes} min`;
+    const hours = Math.floor(minutes / 60);
+    const rem = minutes % 60;
+    return rem === 0 ? `${hours}h` : `${hours}h ${String(rem).padStart(2, "0")}m`;
+}
+export function formatUsage(sub) {
+    const lines = [];
+    const t = sub.tokens;
+    lines.push(`plan: ${(sub.account_type ?? "free").toUpperCase()}`);
+    if (t) {
+        const dailyLeft = Math.max(0, t.daily_limit - t.daily_used);
+        const monthlyLeft = Math.max(0, t.monthly_limit - t.monthly_used);
+        lines.push(`today:      ${unitsAsTime(t.daily_used)} used · ≈ ${unitsAsTime(dailyLeft)} left of ${unitsAsTime(t.daily_limit)}`);
+        lines.push(`this month: ${unitsAsTime(t.monthly_used)} used · ≈ ${unitsAsTime(monthlyLeft)} left of ${unitsAsTime(t.monthly_limit)}`);
+    }
+    if (sub.forecast) {
+        const f = sub.forecast;
+        const pct = f.projected_pct_of_limit != null ? `~${f.projected_pct_of_limit}% of your monthly allowance by month-end` : "";
+        const dep = f.depletion_date ? ` · runs out ~${f.depletion_date}` : "";
+        if (pct || dep)
+            lines.push(`forecast:   ${pct}${dep}`);
+    }
+    for (const g of sub.grants ?? []) {
+        const shared = (g.shared_member_count ?? 0) > 1 ? ` · shared with ${g.shared_member_count}` : "";
+        const exp = g.expires_at ? ` · expires ${g.expires_at.slice(0, 10)}` : "";
+        lines.push(`granted:    ${unitsAsTime(g.remaining_units ?? 0)} left (${g.label ?? "grant"})${shared}${exp}`);
+    }
+    if (typeof sub.credit_balance_eur === "number") {
+        lines.push(`credits:    €${sub.credit_balance_eur.toFixed(2)}`);
+    }
+    return lines.map((l) => `  ${l}`).join("\n");
+}
 export const HELP = `
 Commands:
   @path             attach a local file as context (e.g. "explain @mission.md")
@@ -59,5 +117,14 @@ export async function handleSlashCommand(cmd, ctx) {
         const output = (files.files ?? []).map((f) => `  ${f.name ?? f}`).join("\n") || "  (none)";
         return { output };
     }
+    if (name === "usage") {
+        try {
+            const sub = await api("/api/v1/billing/subscription");
+            return { output: formatUsage(sub) };
+        }
+        catch (e) {
+            return { output: `could not load usage (${e.message})` };
+        }
+    }
     return { output: `unknown command: /${name} (/help)` };
 }

package/dist/ui/App.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { Box, Static, Text, useApp, useInput } from "ink";
 import { buildLocalContextQuery, openBrowser, streamTurn, webBase } from "../runner.js";
-import { handleSlashCommand, parseMentions, SLASH_COMMANDS } from "../session.js";
+import { handleSlashCommand, parseMentions, renameProject, SLASH_COMMANDS, titleFromPrompt } from "../session.js";
 import { markdownToAnsi } from "./markdown.js";
 import { Header } from "./Header.js";
 import { Logo } from "./logo.js";
@@ -30,7 +30,7 @@ function SlashMenu({ value, selected }) {
     const sel = Math.min(selected, matches.length - 1);
     return (_jsx(Box, { flexDirection: "column", marginLeft: 2, children: matches.map((cmd, i) => (_jsxs(Text, { children: [_jsxs(Text, { color: "cyan", bold: i === sel, children: [i === sel ? "❯ " : "  ", "/", cmd.name] }), _jsxs(Text, { dimColor: true, children: ["  ", cmd.desc] })] }, cmd.name))) }));
 }
-export function App({ project, cwd, created }) {
+export function App({ project, cwd, created, updateNotice }) {
     const { exit } = useApp();
     const [input, setInput] = useState("");
     const [history, setHistory] = useState([]);
@@ -110,6 +110,9 @@ export function App({ project, cwd, created }) {
             }
             else {
                 pushItem({ user: raw, answer: result.answer ?? "(no answer)", sawVisual: result.sawVisual });
+                // First prompt in a freshly-created project becomes its title (self-describing in the web app).
+                if (created && turns === 0)
+                    void renameProject(project, titleFromPrompt(raw));
                 setLastTaskId(result.taskId);
                 setTurns((prev) => prev + 1);
                 setTokenTotal((prev) => prev + (result.tokens?.total ?? 0));
@@ -168,5 +171,5 @@ export function App({ project, cwd, created }) {
             }
         }
     });
-    return (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsx(Header, { cwd: cwd, project: project }), items.length === 0 && turns === 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Logo, {}), _jsx(Text, { dimColor: true, children: "New workspace. Try: \"design a sun-synchronous orbit at 550 km\" \u2014 or @mention a local file." })] })) : null, _jsx(Static, { items: items, children: (item) => _jsx(TranscriptTurn, { item: item, project: project }, item.id) }), streaming ? _jsx(RunStatus, { stages: stages.length ? stages : ["starting run"] }) : null, _jsx(Prompt, { value: input, onChange: onInputChange, onSubmit: submit, disabled: streaming }), _jsx(SlashMenu, { value: input, selected: selected }), notice ? _jsx(Text, { dimColor: true, children: notice }) : null, _jsxs(Box, { justifyContent: "space-between", width: "100%", children: [_jsx(Text, { dimColor: true, children: "enter send \u00B7 /help \u00B7 ctrl-d exit" }), _jsxs(Text, { dimColor: true, children: ["tokens: ", tokenTotal] })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsx(Header, { cwd: cwd, project: project }), updateNotice ? _jsxs(Text, { color: "yellow", children: ["\u2191 ", updateNotice] }) : null, items.length === 0 && turns === 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Logo, {}), _jsx(Text, { dimColor: true, children: "New workspace. Try: \"design a sun-synchronous orbit at 550 km\" \u2014 or @mention a local file." })] })) : null, _jsx(Static, { items: items, children: (item) => _jsx(TranscriptTurn, { item: item, project: project }, item.id) }), streaming ? _jsx(RunStatus, { stages: stages.length ? stages : ["starting run"] }) : null, _jsx(Prompt, { value: input, onChange: onInputChange, onSubmit: submit, disabled: streaming }), _jsx(SlashMenu, { value: input, selected: selected }), notice ? _jsx(Text, { dimColor: true, children: notice }) : null, _jsxs(Box, { justifyContent: "space-between", width: "100%", children: [_jsx(Text, { dimColor: true, children: "enter send \u00B7 /help \u00B7 ctrl-d exit" }), _jsxs(Text, { dimColor: true, children: ["tokens: ", tokenTotal] })] })] }));
 }

package/dist/ui/logo.js

@@ -1,11 +1,24 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Box, Text } from "ink";
+import { Box, Text, useStdout } from "ink";
 import { VERSION } from "../version.js";
-// The Vecteur mark is a downward triangle (the "V"), matching the web wordmark
-// (`M16 26 L4 4 H28 Z`). Rendered in the brand blue next to the wordmark.
-const TRIANGLE = ["╲         ╱", " ╲       ╱ ", "  ╲     ╱  ", "   ╲   ╱   ", "    ╲ ╱    ", "     ╲╱    "];
 const BRAND_BLUE = "#4a9eff";
-/** ASCII welcome banner shown on the first screen of an interactive session. */
+// "VECTEUR" in an ANSI-shadow block font — the brand wordmark for a wide terminal.
+const WORDMARK = [
+    "██╗   ██╗███████╗ ██████╗████████╗███████╗██╗   ██╗██████╗",
+    "██║   ██║██╔════╝██╔════╝╚══██╔══╝██╔════╝██║   ██║██╔══██╗",
+    "██║   ██║█████╗  ██║        ██║   █████╗  ██║   ██║██████╔╝",
+    "╚██╗ ██╔╝██╔══╝  ██║        ██║   ██╔══╝  ██║   ██║██╔══██╗",
+    " ╚████╔╝ ███████╗╚██████╗   ██║   ███████╗╚██████╔╝██║  ██║",
+    "  ╚═══╝  ╚══════╝ ╚═════╝   ╚═╝   ╚══════╝ ╚═════╝ ╚═╝  ╚═╝",
+];
+const WORDMARK_WIDTH = 58;
+/** Brand banner for the interactive welcome. Full wordmark when it fits; a compact mark otherwise. */
 export function Logo() {
-    return (_jsxs(Box, { marginBottom: 1, children: [_jsx(Box, { flexDirection: "column", children: TRIANGLE.map((line, i) => (_jsx(Text, { color: BRAND_BLUE, bold: true, children: line }, i))) }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, justifyContent: "center", children: [_jsx(Text, { bold: true, color: "white", children: "V E C T E U R" }), _jsxs(Text, { dimColor: true, children: ["space-engineering agent \u00B7 v", VERSION] })] })] }));
+    const { stdout } = useStdout();
+    const cols = stdout?.columns ?? 80;
+    if (cols >= WORDMARK_WIDTH + 6) {
+        return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [WORDMARK.map((line, i) => (_jsx(Text, { color: BRAND_BLUE, children: line }, i))), _jsx(Text, { dimColor: true, children: `  space-engineering agent · v${VERSION}` })] }));
+    }
+    // Compact mark for narrow (but ink-capable) terminals — a downward-triangle "V" + wordmark.
+    return (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: BRAND_BLUE, bold: true, children: "▽ " }), _jsx(Text, { bold: true, color: "white", children: "VECTEUR" }), _jsx(Text, { dimColor: true, children: `   space-engineering agent · v${VERSION}` })] }));
 }

package/dist/update.js

@@ -53,17 +53,6 @@ export async function refreshUpdateCache() {
         /* offline / registry down / timeout — silent, try again tomorrow */
     }
 }
-/**
- * Print the cached update banner (to stderr, TTY only, so it never pollutes piped/JSON output)
- * and kick off a background cache refresh that we intentionally do NOT await.
- */
-export function maybeNotifyUpdate() {
-    const notice = updateNoticeFromCache();
-    if (notice && process.stderr.isTTY) {
-        process.stderr.write(`\x1b[2m${notice}\x1b[0m\n`);
-    }
-    void refreshUpdateCache();
-}
 /** `vecteur update` — self-update via the global npm install. */
 export async function runUpdate() {
     const { spawn } = await import("node:child_process");

package/dist/version.js

@@ -3,4 +3,4 @@
  * `version.test.ts` (the build/test fails if they drift). Used for `--version`, the
  * `User-Agent` header (lets the server gate old clients with 426), and the update check.
  */
-export const VERSION = "0.2.1";
+export const VERSION = "0.2.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vecteur/cli",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Vecteur CLI — a thin client for the Vecteur space-engineering platform (login, ask, projects, files). Hosted brain; no IP ships.",
   "type": "module",
   "license": "MIT",