geo-new 0.1.0 → 0.1.2

package/dist/cli.js

@@ -7311,7 +7311,7 @@ var ApiError = class extends Error {
 };
 
 // packages/geo-new/src/client.ts
-var VERSION = true ? "0.1.0" : "0.0.0-dev";
+var VERSION = true ? "0.1.2" : "0.0.0-dev";
 var DEFAULT_ORIGIN = "https://geo.new";
 var isLoopback = (url2) => url2.hostname === "localhost" || url2.hostname === "127.0.0.1" || url2.hostname === "[::1]" || url2.hostname === "::1";
 var sleep = (ms, signal) => new Promise((resolve, reject) => {
@@ -7510,7 +7510,7 @@ var GeoNewClient = class {
       snapshot = await this.snapshot(id, { signal: options.signal });
     }
   }
-  /** The keyless session token, when the client holds one; the CLI prints it on request, never by default. */
+  /** The last audit this machine started, so a bare `geo-new report` has something to read. */
   get lastAuditId() {
     return this.credentials.load().last_audit_id;
   }
@@ -7565,6 +7565,105 @@ var clock = (ms) => {
 function detectUtf8(env = process.env) {
   return /utf-?8/i.test(env.LC_ALL ?? env.LC_CTYPE ?? env.LANG ?? "") || process.platform === "win32";
 }
+var ACCENT = "38;5;173";
+var COMET = [ACCENT, "38;5;137", "38;5;95"];
+var BASE = "38;5;240";
+var FACE = {
+  G: [".####", "#....", "#..##", "#...#", ".####"],
+  E: ["#####", "#....", "####.", "#....", "#####"],
+  O: [".###.", "#...#", "#...#", "#...#", ".###."],
+  ".": [".", ".", ".", ".", "#"],
+  n: [".....", "####.", "#...#", "#...#", "#...#"],
+  e: [".....", ".###.", "#####", "#....", ".####"],
+  w: [".....", "#...#", "#.#.#", "#.#.#", ".#.#."]
+};
+var WORD = "GEO.new";
+var GAP = 2;
+var ROWS = 5;
+var CARET = 4;
+var STARTS = [...WORD].reduce(
+  (xs, ch) => [...xs, xs[xs.length - 1] + FACE[ch][0].length + GAP],
+  [0]
+);
+var BOOT_WIDTH = STARTS[WORD.length] - GAP + 1 + CARET;
+var RING = [
+  [0, 0],
+  [0, 1],
+  [0, 2],
+  [1, 2],
+  [2, 2],
+  [2, 1],
+  [2, 0],
+  [1, 0]
+];
+var BOOT = [
+  [70, 0],
+  [70, 0],
+  [70, 0],
+  [70, 0],
+  [70, 0],
+  [70, 0],
+  [70, 0],
+  [70, 0],
+  [110, 0],
+  [120, 0],
+  [70, 1],
+  [70, 2],
+  [70, 3],
+  [120, 3],
+  // a beat between the name and the suffix, as in the design
+  [65, 4],
+  [65, 5],
+  [65, 6],
+  [420, 7]
+  // the caret stands here, then the boot is over
+];
+var LAST = BOOT.length - 1;
+var UP = `\r\x1B[${Math.ceil(ROWS / 2) - 1}A`;
+var sgr = (p, glyph) => p ? `\x1B[${p}m${glyph}\x1B[0m` : glyph;
+var bg = (p) => p.replace(/^38;/, "48;");
+function cell(u, l) {
+  if (u === null) return l === null ? " " : sgr(l, "\u2584");
+  if (l === null) return sgr(u, "\u2580");
+  if (u === l) return sgr(u, "\u2588");
+  if (!u) return sgr(bg(l), "\u2580");
+  if (!l) return sgr(bg(u), "\u2584");
+  return sgr(`${u};${bg(l)}`, "\u2580");
+}
+function bootFrame(step, done, color) {
+  const grid = Array.from({ length: ROWS }, () => []);
+  const ink = (shade) => color ? shade : "";
+  const put = (row, col, shade) => grid[row][col] = shade;
+  const typed = done ? WORD.length : BOOT[step][1];
+  [...WORD].slice(0, typed).forEach(
+    (ch, i) => FACE[ch].forEach(
+      (row, r) => [...row].forEach((p, c) => p === "#" && put(r, STARTS[i] + c, i < 3 ? ink(ACCENT) : ""))
+    )
+  );
+  if (!done && step <= 7)
+    RING.forEach(([r, c], i) => {
+      const k = (step - i + RING.length) % RING.length;
+      put(r + 1, c + 1, color ? COMET[k] ?? BASE : k < COMET.length ? "" : null);
+    });
+  else if (!done && step === 8)
+    for (let r = 1; r <= 3; r++) for (let c = 1; c <= 3; c++) put(r, c, ink(ACCENT));
+  else if (!done && step === 9) {
+    for (let r = 0; r < ROWS; r++)
+      for (let c = 0; c < ROWS; c++) if (r === 0 || r === 4 || c === 0 || c === 4) put(r, c, ink(COMET[2]));
+  }
+  if (!done && step >= 10) {
+    const x = STARTS[typed] - GAP + 1;
+    for (let r = 0; r < ROWS; r++) for (let c = 0; c < CARET; c++) put(r, x + c, "");
+  }
+  const width = Math.max(0, ...grid.map((row) => row.length));
+  const lines = [];
+  for (let r = 0; r < ROWS; r += 2) {
+    let line = "";
+    for (let c = 0; c < width; c++) line += cell(grid[r][c] ?? null, grid[r + 1]?.[c] ?? null);
+    lines.push(line.replace(/ +$/, ""));
+  }
+  return lines;
+}
 var Output = class {
   stream;
   tty;
@@ -7574,6 +7673,11 @@ var Output = class {
   verbose;
   lastLine = "";
   lineOpen = false;
+  booting;
+  /** A process that exits mid-boot must leave the cursor visible and the prompt on its own line. */
+  abandon = () => {
+    if (this.booting) this.stream.write("\x1B[?25h\n");
+  };
   constructor(options = {}) {
     this.stream = options.stream ?? process.stderr;
     this.tty = options.tty ?? Boolean(process.stderr.isTTY);
@@ -7587,9 +7691,51 @@ var Output = class {
     const symbol2 = this.utf8 ? utf8 : ascii;
     return this.color ? `\x1B[${color}m${symbol2}\x1B[0m` : symbol2;
   }
+  /**
+   * Runs the wordmark's boot while an audit is admitted. Progress waits behind it: the first snapshot
+   * lets the ring finish its turn and hand over to the name, and `settle` cuts it to the finished name.
+   */
+  boot() {
+    if (this.quiet || !this.tty || !this.utf8 || this.booting) return;
+    if ((this.stream.columns || 80) < BOOT_WIDTH) return;
+    this.booting = { step: 0, seen: false };
+    process.once("exit", this.abandon);
+    this.stream.write(`\x1B[?25l
+${this.frame(0)}`);
+    this.tick();
+  }
+  frame(step, done = false) {
+    return bootFrame(step, done, this.color).map((line) => `\x1B[2K${line}`).join("\n");
+  }
+  tick() {
+    const b = this.booting;
+    if (!b) return;
+    b.timer = setTimeout(() => {
+      if (b.step === LAST) return this.endBoot();
+      b.step = b.step === 7 && !b.seen ? 0 : b.step + 1;
+      this.stream.write(`${UP}${this.frame(b.step)}`);
+      this.tick();
+    }, BOOT[b.step][0]);
+  }
+  endBoot() {
+    const b = this.booting;
+    if (!b) return;
+    clearTimeout(b.timer);
+    this.booting = void 0;
+    process.off("exit", this.abandon);
+    this.stream.write(`${UP}${this.frame(LAST, true)}\x1B[?25h
+
+`);
+    if (b.pending) this.progress(...b.pending);
+  }
   /** One live line on a TTY, one line per change otherwise. */
   progress(snapshot, elapsedMs) {
     if (this.quiet) return;
+    if (this.booting) {
+      this.booting.seen = true;
+      this.booting.pending = [snapshot, elapsedMs];
+      return;
+    }
     const parts = Object.entries(snapshot.sections).filter(([key]) => key in SECTION_LABEL).map(([key, section]) => `${SECTION_LABEL[key]} ${this.glyph(section.state)}`);
     const line = `${parts.join("  ")}  ${clock(elapsedMs)}`;
     if (this.tty) {
@@ -7604,6 +7750,7 @@ var Output = class {
   }
   /** Ends a live progress line before anything else is printed. */
   settle() {
+    this.endBoot();
     if (this.lineOpen) {
       this.stream.write("\n");
       this.lineOpen = false;
@@ -7648,7 +7795,9 @@ function comparisonLines(comparison) {
   const c = comparison ?? {};
   const delta = (v) => v === null || v === void 0 ? "unmeasured" : v > 0 ? `+${v}` : `${v}`;
   const count = (change) => (c.checks ?? []).filter((k) => k.change === change).length;
-  const lines = [`geo ${delta(c.score_delta?.geo)} \xB7 seo ${delta(c.score_delta?.seo)} \xB7 ${c.state ?? "unknown"}`];
+  const lines = [
+    `geo ${delta(c.score_delta?.geo)} \xB7 seo ${delta(c.score_delta?.seo)} \xB7 ${c.state ?? "unknown"}`
+  ];
   const moved = [
     ["fixed", count("fixed")],
     ["new", count("new")],
@@ -37127,6 +37276,11 @@ var CreateAuditSchema = external_exports.object({ url: external_exports.string()
 var IssueKeySchema = external_exports.object({
   label: external_exports.string().regex(/^[\x20-\x7e]{1,40}$/).optional()
 }).strict();
+var AdminPlanSchema = external_exports.object({
+  plan: external_exports.enum(["free", "builder"]),
+  days: external_exports.number().int().min(1).max(365).optional(),
+  reason: external_exports.string().min(1).max(200).optional()
+}).strict();
 var ClaimSessionSchema = external_exports.object({ key: external_exports.string().min(1).max(128) }).strict();
 
 // src/mcp/summary.ts
@@ -37157,6 +37311,22 @@ function summarize(snapshot, actionLimit = 8) {
     ai: snapshot.ai.status
   };
 }
+function summarizeComparison(comparison, current = null, changedLimit = 40) {
+  const c = comparison ?? {};
+  const moved = (c.checks ?? []).filter((row) => row.change !== "unchanged"), before = c.baseline?.scores?.catalog?.value ?? null, after = current?.scores.catalog?.value ?? null;
+  return {
+    baseline_id: c.baseline_id ?? null,
+    current_id: c.current_id ?? null,
+    state: c.state ?? "unknown",
+    reason: c.reason ?? null,
+    score_delta: c.score_delta ?? null,
+    score: { before, after, delta: before === null || after === null ? null : after - before },
+    changed: moved.slice(0, changedLimit),
+    changed_omitted: Math.max(0, moved.length - changedLimit),
+    unchanged: (c.checks ?? []).length - moved.length,
+    resolved_actions: c.resolved_actions ?? []
+  };
+}
 
 // src/mcp/server.ts
 var MAX_WAIT_SECONDS = 45;
@@ -37334,7 +37504,7 @@ function createMcpServer(api, options) {
     "compare_reports",
     {
       title: "Compare two reports",
-      description: "Score, category and row deltas between a report and an earlier one of the same URL that you also own.",
+      description: "Score, category and row deltas between a report and an earlier one of the same URL that you also own. The result is the rows that moved and a count of the rest, not the baseline report; read either side with get_report.",
       inputSchema: {
         audit_id: external_exports.string().regex(/^aud_[a-f0-9]{32}$/),
         baseline_id: external_exports.string().regex(/^aud_[a-f0-9]{32}$/)
@@ -37342,7 +37512,11 @@ function createMcpServer(api, options) {
     },
     async ({ audit_id, baseline_id }) => {
       try {
-        return text(await api.compare(audit_id, baseline_id));
+        const [comparison, current] = await Promise.all([
+          api.compare(audit_id, baseline_id),
+          api.snapshot(audit_id)
+        ]);
+        return text(summarizeComparison(comparison, current));
       } catch (error61) {
         return failed(error61, { tool: "compare_reports", args: { audit_id, baseline_id } });
       }
@@ -37549,19 +37723,32 @@ var FLAGS = {
   help: false,
   version: false
 };
-var COMMANDS = ["audit", "report", "fix", "share", "compare", "usage", "key", "login", "logout", "mcp"];
+var COMMANDS = [
+  "audit",
+  "report",
+  "fix",
+  "share",
+  "compare",
+  "usage",
+  "key",
+  "login",
+  "logout",
+  "mcp"
+];
 var HELP = `geo-new ${VERSION} \u2014 audit one page for GEO, SEO and agent readiness
 
   npx -y geo-new audit <url> [--fresh] [--json] [--out file] [--wait s] [--wait-for-ai] [--share] [--open]
                              [--min-score N] [--allow-unscored]
   geo-new report [audit_id] [--json] [--out file]     geo-new fix [audit_id]
-  geo-new share [audit_id] [--revoke]                 geo-new usage [--json]
-  geo-new compare <before> <after> [--min-score N] [--allow-drop] [--allow-missing-baseline] [--json]
+  geo-new share [audit_id] [--revoke] [--open]        geo-new usage [--json]
+  geo-new compare <before> <after> [--json] [--out file] [--min-score N] [--allow-drop]
+                                   [--allow-missing-baseline]
   geo-new key create [--label name] | list | revoke <prefix> | set <key>
   geo-new login <key>   geo-new logout   geo-new mcp   geo-new --version
 
   Keyless by default: the first call mints a session and keeps it in your config directory.
   A key (geo-new key create) is the durable identity with a larger allowance; GEO_NEW_API_KEY also works.
+  --out writes JSON, the snapshot compare reads, and leaves stdout empty; the report itself is Markdown.
   Exit codes: 0 done \xB7 1 audit failed \xB7 2 usage \xB7 3 rate limited \xB7 4 auth or ownership \xB7 5 network or server
               6 below --min-score \xB7 7 score dropped \xB7 8 still running when --wait expired \xB7 130 interrupted
   Docs: https://geo.new/docs/api`;
@@ -37606,7 +37793,8 @@ function parseArgs(argv) {
 var integer2 = (value, name, fallback) => {
   if (value === void 0) return fallback;
   const n = Number(value);
-  if (!Number.isInteger(n) || n < 0) throw new Exit(EXIT.usage, `--${name} needs a whole number`);
+  if (!Number.isInteger(n) || n < 0)
+    throw new Exit(EXIT.usage, `--${name} needs a whole number of 0 or more`);
   return n;
 };
 function errorLine(error61) {
@@ -37673,7 +37861,7 @@ async function main(argv, deps = {}) {
   if (flags.help || !command) {
     stdout.write(`${HELP}
 `);
-    return command ? EXIT.ok : EXIT.usage;
+    return flags.help ? EXIT.ok : EXIT.usage;
   }
   if (!COMMANDS.includes(command)) {
     const hint = nearest(command, COMMANDS);
@@ -37695,9 +37883,10 @@ async function main(argv, deps = {}) {
     } else if (flags.json) stdout.write(JSON.stringify(snapshot, null, 2) + "\n");
     else stdout.write((await client.markdown(snapshot.audit_id)).text);
   };
+  let floor = null;
   const minimum = async (snapshot) => {
-    if (flags["min-score"] === void 0) return EXIT.ok;
-    const min = integer2(flags["min-score"], "min-score", 0);
+    if (floor === null) return EXIT.ok;
+    const min = floor;
     const value = scoreOf(snapshot);
     if (value === null) {
       if (flags["allow-unscored"]) return EXIT.ok;
@@ -37713,11 +37902,13 @@ async function main(argv, deps = {}) {
     return EXIT.ok;
   };
   try {
+    if (flags["min-score"] !== void 0) floor = integer2(flags["min-score"], "min-score", 0);
     switch (command) {
       case "audit": {
         const url2 = positional[0];
         if (!url2) throw new Exit(EXIT.usage, "usage: geo-new audit <url>");
         const waitSeconds = integer2(flags.wait, "wait", 90);
+        if (waitSeconds > 0) output2.boot();
         const envelope = await client.audit(url2, {
           fresh: Boolean(flags.fresh),
           signal: deps.signal
@@ -37725,7 +37916,8 @@ async function main(argv, deps = {}) {
         deps.onAudit?.(envelope.audit_id);
         output2.debug(`admitted ${envelope.audit_id} \xB7 cached ${envelope.cached}`);
         if (waitSeconds === 0) {
-          stdout.write(JSON.stringify(envelope) + "\n");
+          const { session: _session, ...admission } = envelope;
+          stdout.write(JSON.stringify(admission) + "\n");
           return EXIT.ok;
         }
         const started = Date.now();
@@ -37754,7 +37946,7 @@ async function main(argv, deps = {}) {
           output2.note(line);
         if (shareUrl && flags.open) openBrowser(shareUrl);
         if (snapshot.status === "failed") return EXIT.failed;
-        return minimum(snapshot);
+        return await minimum(snapshot);
       }
       case "report": {
         const snapshot = await client.snapshot(lastId(positional[0]));
@@ -37797,16 +37989,18 @@ async function main(argv, deps = {}) {
         const load = async (v) => isFile(v) ? readSnapshotFile(v) : client.snapshot(v);
         const [baseline, current] = await Promise.all([load(before), load(after)]);
         const comparison = isFile(before) || isFile(after) ? compareReports(current, baseline) : await client.compare(after, before);
+        const from = scoreOf(baseline), to = scoreOf(current);
+        const moved = from !== null && to !== null && to !== from ? ` (${to > from ? "+" : ""}${to - from})` : "";
+        const scoreLine = `score ${from ?? "unmeasured"} \u2192 ${to ?? "unmeasured"}${moved}`;
         if (flags.out) writeFileSync2(String(flags.out), JSON.stringify(comparison, null, 2) + "\n", "utf8");
         else if (flags.json) stdout.write(JSON.stringify(comparison, null, 2) + "\n");
-        else stdout.write(comparisonLines(comparison).join("\n") + "\n");
-        const from = scoreOf(baseline), to = scoreOf(current);
-        output2.note(`score ${from ?? "unmeasured"} \u2192 ${to ?? "unmeasured"}`);
+        else stdout.write([scoreLine, ...comparisonLines(comparison)].join("\n") + "\n");
+        if (flags.out || flags.json) output2.note(scoreLine);
         if (from !== null && to !== null && to < from && !flags["allow-drop"]) {
           output2.line(`score dropped by ${from - to}`);
           return EXIT.dropped;
         }
-        return minimum(current);
+        return await minimum(current);
       }
       case "usage": {
         const usage = await client.usage();
@@ -37909,7 +38103,7 @@ interrupted${current ? ` \xB7 the audit continues \xB7 geo-new report ${current}
     (error61) => {
       process.stderr.write(`geo-new: ${error61 instanceof Error ? error61.message : String(error61)}
 `);
-      process.exit(EXIT.network);
+      process.exit(error61 instanceof Exit ? error61.code : EXIT.network);
     }
   );
 }

package/dist/client.d.ts

@@ -90,7 +90,7 @@ export declare class GeoNewClient implements Api {
     }>;
     /** Polls until the report is measured (`writing` or terminal), terminal (`ai`), or the timeout. */
     waitFor(id: string, options?: WaitOptions): Promise<WaitResult>;
-    /** The keyless session token, when the client holds one; the CLI prints it on request, never by default. */
+    /** The last audit this machine started, so a bare `geo-new report` has something to read. */
     get lastAuditId(): string | undefined;
     remember(patch: Partial<{
         key: string;

package/dist/index.js

@@ -107,7 +107,7 @@ var ApiError = class extends Error {
 };
 
 // packages/geo-new/src/client.ts
-var VERSION = true ? "0.1.0" : "0.0.0-dev";
+var VERSION = true ? "0.1.2" : "0.0.0-dev";
 var DEFAULT_ORIGIN = "https://geo.new";
 var isLoopback = (url) => url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "[::1]" || url.hostname === "::1";
 var sleep = (ms, signal) => new Promise((resolve, reject) => {
@@ -306,7 +306,7 @@ var GeoNewClient = class {
       snapshot = await this.snapshot(id, { signal: options.signal });
     }
   }
-  /** The keyless session token, when the client holds one; the CLI prints it on request, never by default. */
+  /** The last audit this machine started, so a bare `geo-new report` has something to read. */
   get lastAuditId() {
     return this.credentials.load().last_audit_id;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-new",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Audit one page for GEO, SEO and agent readiness from a terminal, a coding agent (MCP) or a script. Keyless by default; a key is optional.",
   "license": "MIT",
   "type": "module",