geo-new 0.1.0 → 0.1.1

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.1" : "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;
   }
@@ -37127,6 +37127,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 +37162,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 +37355,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 +37363,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 +37574,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 +37644,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 +37712,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 +37734,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,6 +37753,7 @@ 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];
@@ -37725,7 +37766,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 +37796,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 +37839,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 +37953,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.1" : "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.1",
   "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",