gws-axi 0.13.0 → 0.14.0

package/dist/src/commands/docs/diff.d.ts

@@ -0,0 +1,23 @@
+export declare const DIFF_HELP = "usage: gws-axi docs diff <fileId> <revA> [revB] [flags]\nargs[3]:\n  <fileId>             The Google Doc / Drive file ID (the portion of the URL after /d/)\n  <revA>               The \"from\" revision id (from `gws-axi docs revisions <fileId>`)\n  <revB>               The \"to\" revision id (optional; defaults to the head revision)\nflags[3]:\n  --full               Don't truncate the diff (default cap: 8000 chars)\n  --out <path>         Write the full unified diff to a file (implies --full)\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi docs diff 1Kc9mv... 841 865\n  gws-axi docs diff 1Kc9mv... 841            # 841 vs head\n  gws-axi docs diff 1Kc9mv... 841 865 --out ./change.diff\noutput:\n  A `document{id,name,type}` header, `from{revision,modified,author}` and\n  `to{revision,modified,author}` provenance blocks, a `summary{lines_added,\n  lines_removed,changed}`, and a `diff` block of the unified diff (truncated\n  unless --full/--out). The diff shows the changes that transform revA into revB.\nnotes:\n  Native Google Docs only. Google exposes no diff API, so this exports BOTH\n  revisions to markdown server-side and diffs them locally \u2014 the result is a\n  diff of two markdown exports (lossy relevance previews), NOT a faithful\n  editorial diff: formatting-only or Google-specific changes may be invisible,\n  and native revision history is itself a sparse sample.\n";
+interface ParsedFlags {
+    fileId: string;
+    revA: string;
+    revB: string | undefined;
+    full: boolean;
+    out: string | undefined;
+}
+export declare function parseFlags(args: string[]): ParsedFlags;
+export interface DiffResult {
+    unified: string;
+    linesAdded: number;
+    linesRemoved: number;
+    changed: boolean;
+}
+/**
+ * Compute a unified diff (and added/removed line counts) of two text blobs.
+ * Argument order is respected — the diff transforms `textA` into `textB`.
+ * Pure (no I/O) so it's unit-testable.
+ */
+export declare function computeDiff(labelA: string, labelB: string, textA: string, textB: string, headerA?: string, headerB?: string): DiffResult;
+export declare function docsDiffCommand(account: string, args: string[]): Promise<string>;
+export {};

package/dist/src/commands/docs/diff.js

@@ -0,0 +1,212 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { AxiError } from "axi-sdk-js";
+import { createTwoFilesPatch, structuredPatch } from "diff";
+import { driveClient, translateGoogleError } from "../../google/client.js";
+import { joinBlocks, renderHelp, renderObject } from "../../output/index.js";
+import { resolveOutputPath } from "../../util/paths.js";
+import { fetchNativeRevisionExport, listRecentRevisions, } from "./revision-content.js";
+export const DIFF_HELP = `usage: gws-axi docs diff <fileId> <revA> [revB] [flags]
+args[3]:
+  <fileId>             The Google Doc / Drive file ID (the portion of the URL after /d/)
+  <revA>               The "from" revision id (from \`gws-axi docs revisions <fileId>\`)
+  <revB>               The "to" revision id (optional; defaults to the head revision)
+flags[3]:
+  --full               Don't truncate the diff (default cap: 8000 chars)
+  --out <path>         Write the full unified diff to a file (implies --full)
+  --account <email>    Account override when 2+ are configured
+examples:
+  gws-axi docs diff 1Kc9mv... 841 865
+  gws-axi docs diff 1Kc9mv... 841            # 841 vs head
+  gws-axi docs diff 1Kc9mv... 841 865 --out ./change.diff
+output:
+  A \`document{id,name,type}\` header, \`from{revision,modified,author}\` and
+  \`to{revision,modified,author}\` provenance blocks, a \`summary{lines_added,
+  lines_removed,changed}\`, and a \`diff\` block of the unified diff (truncated
+  unless --full/--out). The diff shows the changes that transform revA into revB.
+notes:
+  Native Google Docs only. Google exposes no diff API, so this exports BOTH
+  revisions to markdown server-side and diffs them locally — the result is a
+  diff of two markdown exports (lossy relevance previews), NOT a faithful
+  editorial diff: formatting-only or Google-specific changes may be invisible,
+  and native revision history is itself a sparse sample.
+`;
+const DEFAULT_TRUNCATE_CHARS = 8000;
+export function parseFlags(args) {
+    const positionals = [];
+    let full = false;
+    let out;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--full":
+                full = true;
+                break;
+            case "--out":
+                out = next;
+                i++;
+                break;
+            default:
+                if (!arg.startsWith("--"))
+                    positionals.push(arg);
+        }
+    }
+    const [fileId, revA, revB] = positionals;
+    if (!fileId || !revA) {
+        throw new AxiError("docs diff needs a fileId and at least one revision", "VALIDATION_ERROR", [
+            "Usage: gws-axi docs diff <fileId> <revA> [revB]",
+            "List revision ids with `gws-axi docs revisions <fileId>`",
+        ]);
+    }
+    // --out writes the full diff; truncation only protects an inline response.
+    if (out)
+        full = true;
+    return { fileId, revA, revB, full, out };
+}
+/**
+ * Compute a unified diff (and added/removed line counts) of two text blobs.
+ * Argument order is respected — the diff transforms `textA` into `textB`.
+ * Pure (no I/O) so it's unit-testable.
+ */
+export function computeDiff(labelA, labelB, textA, textB, headerA = "", headerB = "") {
+    const patch = structuredPatch(labelA, labelB, textA, textB, "", "");
+    let linesAdded = 0;
+    let linesRemoved = 0;
+    for (const hunk of patch.hunks) {
+        for (const line of hunk.lines) {
+            if (line.startsWith("+"))
+                linesAdded++;
+            else if (line.startsWith("-"))
+                linesRemoved++;
+        }
+    }
+    return {
+        unified: createTwoFilesPatch(labelA, labelB, textA, textB, headerA, headerB),
+        linesAdded,
+        linesRemoved,
+        changed: textA !== textB,
+    };
+}
+export async function docsDiffCommand(account, args) {
+    const flags = parseFlags(args);
+    const api = await driveClient(account);
+    // Step 1: metadata — name + native classification.
+    let meta;
+    try {
+        const res = await api.files.get({
+            fileId: flags.fileId,
+            fields: "id,name,mimeType",
+            supportsAllDrives: true,
+        });
+        meta = {
+            name: res.data.name ?? "(unnamed)",
+            mimeType: res.data.mimeType ?? "application/octet-stream",
+        };
+    }
+    catch (err) {
+        const translated = translateGoogleError(err, {
+            account,
+            operation: "drive.files.get",
+        });
+        if (translated.code === "NOT_FOUND") {
+            throw new AxiError(`File '${flags.fileId}' not found (or ${account} doesn't have access)`, "FILE_NOT_FOUND", [
+                "Verify the file ID is correct (the portion of the URL after /d/)",
+                `Confirm ${account} has at least view access to the file`,
+            ]);
+        }
+        throw translated;
+    }
+    if (!meta.mimeType.startsWith("application/vnd.google-apps.")) {
+        throw new AxiError(`'${flags.fileId}' is not a native Google Doc — diff compares markdown exports, which binary files don't have`, "NON_NATIVE_DOCUMENT", [
+            `Compare size/mime across revisions with \`gws-axi drive revisions ${flags.fileId} --full\``,
+            `Or fetch each revision's bytes with \`gws-axi docs download ${flags.fileId} --revision <id>\` and diff locally`,
+        ]);
+    }
+    // Step 2: resolve revB → head when omitted.
+    let revB = flags.revB;
+    if (!revB) {
+        const head = await listRecentRevisions(api, flags.fileId, 1);
+        if (head.length === 0) {
+            throw new AxiError(`No revisions found for '${flags.fileId}'`, "REVISION_NOT_FOUND", [`List revisions with \`gws-axi docs revisions ${flags.fileId}\``]);
+        }
+        revB = head[0].id;
+    }
+    // Step 3: export both revisions to markdown (server-side), in parallel.
+    // A bad id surfaces as REVISION_NOT_FOUND from the helper.
+    const [exportA, exportB] = await Promise.all([
+        fetchNativeRevisionExport(api, account, flags.fileId, flags.revA, undefined),
+        fetchNativeRevisionExport(api, account, flags.fileId, revB, undefined),
+    ]);
+    const textA = exportA.bytes.toString("utf8");
+    const textB = exportB.bytes.toString("utf8");
+    // Step 4: compute the diff. Argument order is respected (revA → revB);
+    // never reordered chronologically.
+    const labelA = `r${flags.revA}`;
+    const labelB = `r${revB}`;
+    const { unified, linesAdded, linesRemoved, changed, } = computeDiff(labelA, labelB, textA, textB, exportA.modified, exportB.modified);
+    const blocks = [];
+    blocks.push(renderObject({ account }));
+    blocks.push(renderObject({
+        document: { id: flags.fileId, name: meta.name, type: "native" },
+    }));
+    blocks.push(renderObject({
+        from: {
+            revision: flags.revA,
+            modified: exportA.modified,
+            author: exportA.author,
+        },
+    }));
+    blocks.push(renderObject({
+        to: { revision: revB, modified: exportB.modified, author: exportB.author },
+    }));
+    blocks.push(renderObject({
+        summary: {
+            lines_added: linesAdded,
+            lines_removed: linesRemoved,
+            changed,
+        },
+    }));
+    const suggestions = [];
+    if (!changed) {
+        // Identical markdown exports — which does NOT prove the source revisions
+        // were identical, only their previews.
+        blocks.push(renderObject({
+            diff: "no differences (the two markdown exports are identical)",
+        }));
+    }
+    else {
+        const total = unified.length;
+        if (flags.out) {
+            const defaultName = `${stripExt(meta.name)}.r${flags.revA}-r${revB}.diff`;
+            const outPath = await resolveOutputPath(flags.out, defaultName);
+            await mkdir(dirname(outPath), { recursive: true });
+            await writeFile(outPath, unified);
+            blocks.push(renderObject({ saved: outPath, diff_total_chars: total }));
+        }
+        else {
+            const cap = flags.full ? Number.POSITIVE_INFINITY : DEFAULT_TRUNCATE_CHARS;
+            const truncated = total > cap;
+            blocks.push(renderObject({ diff: truncated ? `${unified.slice(0, cap)}…` : unified }));
+            if (truncated) {
+                blocks.push(renderObject({ diff_truncated: true, diff_total_chars: total }));
+                suggestions.push(`Run \`gws-axi docs diff ${flags.fileId} ${flags.revA} ${revB} --out <path>\` to save the full diff, or --full to expand inline`);
+            }
+        }
+    }
+    for (const n of [exportA.note, exportB.note]) {
+        if (n)
+            blocks.push(renderObject({ note: n }));
+    }
+    suggestions.push(`Fetch a side's full content: \`gws-axi docs download ${flags.fileId} --revision ${flags.revA}\` (or --revision ${revB})`);
+    suggestions.push(`List all revisions: \`gws-axi docs revisions ${flags.fileId}\``);
+    suggestions.push("Diff compares markdown exports (lossy) — formatting-only changes may be invisible, and native revision history is a sparse sample");
+    blocks.push(renderHelp(suggestions));
+    return joinBlocks(...blocks);
+}
+/** Strip a trailing extension from a filename, if present. */
+function stripExt(name) {
+    const idx = name.lastIndexOf(".");
+    return idx > 0 ? name.slice(0, idx) : name;
+}
+//# sourceMappingURL=diff.js.map

package/dist/src/commands/docs/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../../src/commands/docs/diff.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/docs/diff.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/commands/docs/diff.test.js

@@ -0,0 +1,84 @@
+import { describe, expect, it } from "vitest";
+import { AxiError } from "axi-sdk-js";
+import { computeDiff, parseFlags } from "./diff.js";
+describe("docs diff parseFlags", () => {
+    it("parses fileId + two revisions", () => {
+        const f = parseFlags(["1Kc9mv", "841", "865"]);
+        expect(f.fileId).toBe("1Kc9mv");
+        expect(f.revA).toBe("841");
+        expect(f.revB).toBe("865");
+        expect(f.full).toBe(false);
+        expect(f.out).toBeUndefined();
+    });
+    it("leaves revB undefined when only one revision is given (defaults to head later)", () => {
+        const f = parseFlags(["1Kc9mv", "841"]);
+        expect(f.revA).toBe("841");
+        expect(f.revB).toBeUndefined();
+    });
+    it("parses --full and --out (--out implies --full)", () => {
+        const f = parseFlags(["1Kc9mv", "841", "865", "--out", "./c.diff"]);
+        expect(f.out).toBe("./c.diff");
+        expect(f.full).toBe(true);
+    });
+    it("preserves argument order — does not reorder revisions", () => {
+        const f = parseFlags(["1Kc9mv", "865", "841"]);
+        expect(f.revA).toBe("865");
+        expect(f.revB).toBe("841");
+    });
+    it("throws VALIDATION_ERROR with no revision", () => {
+        try {
+            parseFlags(["1Kc9mv"]);
+            throw new Error("should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AxiError);
+            expect(err.code).toBe("VALIDATION_ERROR");
+        }
+    });
+    it("throws VALIDATION_ERROR with no fileId", () => {
+        try {
+            parseFlags(["--full"]);
+            throw new Error("should have thrown");
+        }
+        catch (err) {
+            expect(err.code).toBe("VALIDATION_ERROR");
+        }
+    });
+});
+describe("docs diff computeDiff", () => {
+    it("counts added and removed lines", () => {
+        const a = "one\ntwo\nthree\n";
+        const b = "one\ntwo\nthree\nfour\nfive\n";
+        const r = computeDiff("rA", "rB", a, b);
+        expect(r.changed).toBe(true);
+        expect(r.linesAdded).toBe(2);
+        expect(r.linesRemoved).toBe(0);
+        expect(r.unified).toContain("rA");
+        expect(r.unified).toContain("rB");
+    });
+    it("counts a replacement as both removed and added", () => {
+        const a = "alpha\nbeta\ngamma\n";
+        const b = "alpha\nBETA\ngamma\n";
+        const r = computeDiff("rA", "rB", a, b);
+        expect(r.linesAdded).toBe(1);
+        expect(r.linesRemoved).toBe(1);
+    });
+    it("reports changed=false for identical text", () => {
+        const same = "no change here\n";
+        const r = computeDiff("rA", "rB", same, same);
+        expect(r.changed).toBe(false);
+        expect(r.linesAdded).toBe(0);
+        expect(r.linesRemoved).toBe(0);
+    });
+    it("respects argument order (reverse is the inverse diff)", () => {
+        const a = "one\ntwo\n";
+        const b = "one\ntwo\nthree\n";
+        const forward = computeDiff("rA", "rB", a, b);
+        const reverse = computeDiff("rB", "rA", b, a);
+        expect(forward.linesAdded).toBe(1);
+        expect(forward.linesRemoved).toBe(0);
+        expect(reverse.linesAdded).toBe(0);
+        expect(reverse.linesRemoved).toBe(1);
+    });
+});
+//# sourceMappingURL=diff.test.js.map

package/dist/src/commands/docs/diff.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.test.js","sourceRoot":"","sources":["../../../../src/commands/docs/diff.test.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/docs/download.js

@@ -1,9 +1,10 @@
 import { writeFile, mkdir } from "node:fs/promises";
 import { basename, dirname, extname } from "node:path";
 import { AxiError } from "axi-sdk-js";
-import { driveClient, oauthClientForAccount, translateGoogleError, } from "../../google/client.js";
+import { driveClient, translateGoogleError } from "../../google/client.js";
 import { joinBlocks, renderHelp, renderObject } from "../../output/index.js";
 import { resolveOutputPath } from "../../util/paths.js";
+import { fetchNativeRevisionExport } from "./revision-content.js";
 export const DOWNLOAD_HELP = `usage: gws-axi docs download <documentId> [flags]
 args[1]:
   <documentId>         The Google Doc / Drive file ID (from the URL after /d/)
@@ -239,69 +240,21 @@ export async function docsDownloadCommand(account, args) {
  */
 async function downloadRevision(api, account, flags, meta, isNative) {
     const revisionId = flags.revision;
-    // Fetch the revision metadata: modifiedTime + (native) exportLinks.
-    let revision;
-    try {
-        const res = await api.revisions.get({
-            fileId: flags.documentId,
-            revisionId,
-            fields: "id,modifiedTime,exportLinks",
-        });
-        revision = res.data;
-    }
-    catch (err) {
-        const translated = translateGoogleError(err, {
-            account,
-            operation: "drive.revisions.get",
-        });
-        if (translated.code === "NOT_FOUND") {
-            throw new AxiError(`Revision '${revisionId}' not found on file '${flags.documentId}'`, "REVISION_NOT_FOUND", [
-                `List valid revisions with \`gws-axi drive revisions ${flags.documentId}\``,
-            ]);
-        }
-        throw translated;
-    }
     let bytes;
     let effectiveMime;
     let extension;
+    let revisionModified = "";
     const notes = [];
     if (isNative) {
-        const links = revision.exportLinks ?? {};
-        const requested = flags.as ?? "text/markdown";
-        let chosen = requested;
-        let url = links[requested];
-        // Fallback chain only applies to the default (markdown); an explicit
-        // --as that isn't available is an error the caller must resolve.
-        if (!url && !flags.as) {
-            const fallback = links["text/plain"] ?? Object.values(links)[0];
-            const fallbackMime = Object.keys(links).find((k) => links[k] === fallback) ?? "";
-            if (fallback) {
-                chosen = fallbackMime;
-                url = fallback;
-                notes.push(`text/markdown not available for this revision — exported as ${fallbackMime} instead`);
-            }
-        }
-        if (!url) {
-            throw new AxiError(`Export format ${requested} not available for revision ${revisionId}`, "EXPORT_FORMAT_REQUIRED", [
-                `Available formats: ${Object.keys(links).join(", ") || "(none)"}`,
-                "Pass a supported --as <mime>",
-            ]);
-        }
-        effectiveMime = chosen;
-        extension = EXTENSION_BY_MIME[chosen] ?? "";
-        // exportLinks are arbitrary URLs (not a googleapis method), so fetch
-        // directly with the account's bearer token.
-        const auth = await oauthClientForAccount(account);
-        const { token } = await auth.getAccessToken();
-        const resp = await fetch(url, {
-            headers: { Authorization: `Bearer ${token}` },
-        });
-        if (!resp.ok) {
-            throw new AxiError(`Failed to export revision ${revisionId} as ${chosen} (HTTP ${resp.status})`, "REVISION_CONTENT_UNAVAILABLE", [
-                `List valid revisions with \`gws-axi drive revisions ${flags.documentId}\``,
-            ]);
-        }
-        bytes = Buffer.from(await resp.arrayBuffer());
+        // Native: export the revision via its exportLinks (markdown default with
+        // fallback when --as is omitted). Shared with `docs diff`.
+        const exported = await fetchNativeRevisionExport(api, account, flags.documentId, revisionId, flags.as);
+        bytes = exported.bytes;
+        effectiveMime = exported.mime;
+        extension = EXTENSION_BY_MIME[exported.mime] ?? "";
+        revisionModified = exported.modified;
+        if (exported.note)
+            notes.push(exported.note);
     }
     else {
         if (flags.as) {
@@ -309,6 +262,28 @@ async function downloadRevision(api, account, flags, meta, isNative) {
         }
         effectiveMime = meta.mimeType;
         extension = extname(meta.name) || EXTENSION_BY_MIME[effectiveMime] || "";
+        // Binary: a metadata get resolves modifiedTime and surfaces a bad id as
+        // REVISION_NOT_FOUND before we attempt the media download.
+        try {
+            const metaRes = await api.revisions.get({
+                fileId: flags.documentId,
+                revisionId,
+                fields: "id,modifiedTime",
+            });
+            revisionModified = metaRes.data.modifiedTime ?? "";
+        }
+        catch (err) {
+            const translated = translateGoogleError(err, {
+                account,
+                operation: "drive.revisions.get",
+            });
+            if (translated.code === "NOT_FOUND") {
+                throw new AxiError(`Revision '${revisionId}' not found on file '${flags.documentId}'`, "REVISION_NOT_FOUND", [
+                    `List valid revisions with \`gws-axi drive revisions ${flags.documentId}\``,
+                ]);
+            }
+            throw translated;
+        }
         try {
             const res = await api.revisions.get({ fileId: flags.documentId, revisionId, alt: "media" }, { responseType: "arraybuffer" });
             bytes = Buffer.from(res.data);
@@ -342,7 +317,7 @@ async function downloadRevision(api, account, flags, meta, isNative) {
             saved_mime_type: effectiveMime,
             size_bytes: bytes.length,
             revision: revisionId,
-            revision_modified: revision.modifiedTime ?? "",
+            revision_modified: revisionModified,
         },
     }));
     blocks.push(renderObject({ saved: outPath }));

package/dist/src/commands/docs/download.js.map

@@ -1 +1 @@
-{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../../src/commands/docs/download.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../../src/commands/docs/download.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/docs/read.d.ts

@@ -1,2 +1,2 @@
-export declare const READ_HELP = "usage: gws-axi docs read <documentId> [flags]\nargs[1]:\n  <documentId>         The Google Doc ID (from the URL after /d/)\nflags[4]:\n  --tab <id>           Tab ID to render (omit for single-tab docs; required for multi-tab)\n  --full               Don't truncate the rendered markdown (default cap: 8000 chars)\n  --out <path>         Write the rendered markdown to a file (implies --full).\n                       Accepts a file path or directory; directories get\n                       `<title>.md` appended. When set, the TOON response\n                       carries a `saved` field instead of the content block.\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi docs read 1BxAbc...\n  gws-axi docs read 1BxAbc... --tab t.0\n  gws-axi docs read 1BxAbc... --tab t.1.0 --full\n  gws-axi docs read 1BxAbc... --out ./notes.md\noutput:\n  A `document{id,title,tab,revision_id}` header, a `tabs[N]{id,title,index,parent,active}`\n  listing (always shown, with \u2713 on the active tab if any), and \u2014 when a tab is\n  rendered \u2014 either a `content` block of GitHub-flavored markdown (inline,\n  truncated unless --full) or a `saved` path (when --out is set). Multi-tab\n  docs without --tab return only the tabs listing so the agent can pick one.\n";
+export declare const READ_HELP = "usage: gws-axi docs read <documentId> [flags]\nargs[1]:\n  <documentId>         The Google Doc ID (from the URL after /d/)\nflags[4]:\n  --tab <id>           Tab ID to render (omit for single-tab docs; required for multi-tab)\n  --full               Don't truncate the rendered markdown (default cap: 8000 chars)\n  --out <path>         Write the rendered markdown to a file (implies --full).\n                       Accepts a file path or directory; directories get\n                       `<title>.md` appended. When set, the TOON response\n                       carries a `saved` field instead of the content block.\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi docs read 1BxAbc...\n  gws-axi docs read 1BxAbc... --tab t.0\n  gws-axi docs read 1BxAbc... --tab t.1.0 --full\n  gws-axi docs read 1BxAbc... --out ./notes.md\noutput:\n  A `document{id,title,tab,revision_id}` header, a `tabs[N]{id,title,index,parent,active}`\n  listing (always shown, with \u2713 on the active tab if any), a `revisions[N]{id,modified,author}`\n  block of the 5 most recent revisions (always shown \u2014 provenance travels with the\n  content), and \u2014 when a tab is rendered \u2014 either a `content` block of GitHub-flavored\n  markdown (inline, truncated unless --full) or a `saved` path (when --out is set).\n  Multi-tab docs without --tab return only the tabs listing so the agent can pick one.\n  help[] funnels to `docs revisions`, `docs download --revision`, and `docs diff`.\n";
 export declare function docsReadCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/docs/read.js

@@ -1,9 +1,10 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname } from "node:path";
 import { AxiError } from "axi-sdk-js";
-import { docsClient, translateGoogleError } from "../../google/client.js";
+import { docsClient, driveClient, translateGoogleError, } from "../../google/client.js";
 import { field, joinBlocks, renderHelp, renderList, renderObject, } from "../../output/index.js";
 import { renderBodyAsMarkdown } from "./markdown.js";
+import { listRecentRevisions, } from "./revision-content.js";
 import { resolveOutputPath } from "../../util/paths.js";
 export const READ_HELP = `usage: gws-axi docs read <documentId> [flags]
 args[1]:
@@ -23,12 +24,18 @@ examples:
   gws-axi docs read 1BxAbc... --out ./notes.md
 output:
   A \`document{id,title,tab,revision_id}\` header, a \`tabs[N]{id,title,index,parent,active}\`
-  listing (always shown, with ✓ on the active tab if any), and — when a tab is
-  rendered — either a \`content\` block of GitHub-flavored markdown (inline,
-  truncated unless --full) or a \`saved\` path (when --out is set). Multi-tab
-  docs without --tab return only the tabs listing so the agent can pick one.
+  listing (always shown, with ✓ on the active tab if any), a \`revisions[N]{id,modified,author}\`
+  block of the 5 most recent revisions (always shown — provenance travels with the
+  content), and — when a tab is rendered — either a \`content\` block of GitHub-flavored
+  markdown (inline, truncated unless --full) or a \`saved\` path (when --out is set).
+  Multi-tab docs without --tab return only the tabs listing so the agent can pick one.
+  help[] funnels to \`docs revisions\`, \`docs download --revision\`, and \`docs diff\`.
 `;
 const DEFAULT_TRUNCATE_CHARS = 8000;
+// How many recent revisions to inline in every read. Provenance is shown by
+// default (principles.md#provenance-by-default); `docs revisions` is the full
+// listing for when more history is needed.
+const RECENT_REVISIONS_LIMIT = 5;
 function parseFlags(args) {
     let documentId;
     let tab;
@@ -183,6 +190,26 @@ export async function docsReadCommand(account, args) {
             parent: t.parent,
         })), tabSchema(activeTab?.id ?? "")));
     }
+    // Recent revisions — shown by default so the content's provenance travels
+    // with it (principles.md#provenance-by-default). Best-effort: a failed
+    // secondary fetch must never fail the content read.
+    let recentRevisions = [];
+    let revisionsFailed = false;
+    try {
+        const drive = await driveClient(account);
+        recentRevisions = await listRecentRevisions(drive, flags.documentId, RECENT_REVISIONS_LIMIT);
+    }
+    catch {
+        revisionsFailed = true;
+    }
+    if (recentRevisions.length > 0) {
+        blocks.push(renderList("revisions", recentRevisions, [field("id"), field("modified"), field("author")]));
+    }
+    else if (revisionsFailed) {
+        blocks.push(renderObject({
+            revisions: "history unavailable (revision lookup failed)",
+        }));
+    }
     const suggestions = [];
     if (contentBody) {
         const rendered = renderBodyAsMarkdown(contentBody, contentLists);
@@ -228,6 +255,19 @@ export async function docsReadCommand(account, args) {
         // Multi-tab, no --tab — steer the agent to pick one.
         suggestions.push(`This document has ${flat.length} tabs. Run \`gws-axi docs read ${flags.documentId} --tab <id>\` to read one (the id column above).`);
     }
+    // Version-history funnel — docs read is the discovery entry point for a
+    // document's revisions (principles.md#contextual-help-suggestions). Always
+    // shown; interpolates real revision ids when the listing was available.
+    suggestions.push(`View full version history: \`gws-axi docs revisions ${flags.documentId}\``);
+    if (recentRevisions.length > 0) {
+        const newest = recentRevisions[0].id;
+        const older = recentRevisions[1]?.id ?? newest;
+        suggestions.push(`Fetch a past version's content: \`gws-axi docs download ${flags.documentId} --revision ${older}\``);
+        if (recentRevisions.length > 1) {
+            suggestions.push(`Compare two versions: \`gws-axi docs diff ${flags.documentId} ${older} ${newest}\``);
+        }
+        suggestions.push("Recent revisions are a sparse sample — `docs revisions` lists the full history Drive retains; the editor's version-history UI may show more, and version names aren't exposed by the API");
+    }
     if (suggestions.length > 0)
         blocks.push(renderHelp(suggestions));
     return joinBlocks(renderObject({ account }), ...blocks);