@wirecat/drive-cli 0.1.0 → 0.3.0

package/dist/model.d.ts

@@ -1,5 +1,6 @@
 export declare const FOLDER = "application/vnd.google-apps.folder";
 export declare const DOC = "application/vnd.google-apps.document";
+export declare const SHEET = "application/vnd.google-apps.spreadsheet";
 export interface GoogleUser {
     id?: string;
     email?: string;
@@ -15,6 +16,7 @@ export interface FileMetadata {
     url: string;
     trashed: boolean;
     canDownload: boolean;
+    size?: number;
     createdAt?: string;
     description?: string;
     driveId?: string;
@@ -47,7 +49,7 @@ export interface GoogleSource {
         items: Change[];
         cursor: string;
     }>;
-    content(id: string): Promise<DocumentContent>;
+    content(id: string, maxChars?: number): Promise<DocumentContent>;
 }
 export interface IndexedDocument {
     metadata: FileMetadata;
@@ -60,6 +62,13 @@ export interface WorkItem {
     kind: "save" | "remove";
     file?: FileMetadata;
 }
+export interface Skip {
+    id: string;
+    reason: string;
+    file?: FileMetadata;
+    textLimit?: number;
+    storeRefusedIn?: string;
+}
 export interface SyncState {
     version: 1;
     principal: string;
@@ -67,21 +76,13 @@ export interface SyncState {
     cursor?: string;
     folders: Record<string, FileMetadata>;
     documents: Record<string, IndexedDocument>;
-    skipped: {
-        id: string;
-        reason: string;
-        file?: FileMetadata;
-    }[];
+    skipped: Skip[];
     pending?: {
         cursor: string;
         scope: string;
         folders: Record<string, FileMetadata>;
         jobs: WorkItem[];
-        skipped: {
-            id: string;
-            reason: string;
-            file?: FileMetadata;
-        }[];
+        skipped: Skip[];
     };
     lastSync?: string;
 }

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -1,3 +1,4 @@
 export const FOLDER = "application/vnd.google-apps.folder";
 export const DOC = "application/vnd.google-apps.document";
+export const SHEET = "application/vnd.google-apps.spreadsheet";
 //# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,oCAAoC,CAAA;AAC1D,MAAM,CAAC,MAAM,GAAG,GAAG,sCAAsC,CAAA"}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,oCAAoC,CAAA;AAC1D,MAAM,CAAC,MAAM,GAAG,GAAG,sCAAsC,CAAA;AACzD,MAAM,CAAC,MAAM,KAAK,GAAG,yCAAyC,CAAA"}

package/dist/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AACD,eAAO,MAAM,cAAc,QAAS,MAAM,CAAC,UAAU,WAAW,MAAM,UAAS,WAAW;;;CASzF,CAAA;AAID,eAAO,MAAM,gBAAgB,WAAY,MAAM,aAa9C,CAAA;AACD,eAAO,MAAM,WAAW,QACjB,MAAM,CAAC,UAAU,WACb,MAAM,OACV,MAAM,WACF,OAAO,UACT,WAAW,QACZ,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,kBAkBxC,CAAA;AACD,eAAO,MAAM,kBAAkB,GAAU,CAAC,OACnC,MAAM,CAAC,UAAU,WACb,MAAM,OACV,MAAM,OACN,MAAM,OAAO,CAAC,CAAC,CAAC,UACd,WAAW,QACZ,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KACtC,OAAO,CAAC,CAAC,CAiBX,CAAA"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AACD,eAAO,MAAM,cAAc,QAAS,MAAM,CAAC,UAAU,WAAW,MAAM,UAAS,WAAW;;;CASzF,CAAA;AAID,eAAO,MAAM,gBAAgB,WAAY,MAAM,aAa9C,CAAA;AACD,eAAO,MAAM,WAAW,QACjB,MAAM,CAAC,UAAU,WACb,MAAM,OACV,MAAM,WACF,OAAO,UACT,WAAW,QACZ,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,kBAkBxC,CAAA;AACD,eAAO,MAAM,kBAAkB,GAAU,CAAC,OACnC,MAAM,CAAC,UAAU,WACb,MAAM,OACV,MAAM,OACN,MAAM,OAAO,CAAC,CAAC,CAAC,UACd,WAAW,QACZ,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KACtC,OAAO,CAAC,CAAC,CAoBX,CAAA"}

package/dist/policy.js

@@ -1,8 +1,9 @@
 import { join } from "node:path";
-import { CliError } from "@wirecat/cli-core";
+import { CliError } from "@wirecat/cli-base";
 import { guardedWrite, layerPermissions, levelFor, newOperationId, permissionOverrides, RecipientList, SendJournal, sendGuard, } from "@wirecat/cli-messaging/sends";
 import { operations } from "./api-contract.js";
 import { paths, readConfig } from "./config.js";
+import { VERSION } from "./version.js";
 export const policySettings = (env, profile, flags = {}) => {
     const config = readConfig(env);
     const own = config.profiles[profile];
@@ -56,7 +57,10 @@ export const guardedGoogleWrite = async (env, profile, key, act, flags = {}, ask
         permissionDefaults: defaults,
         ask: async (permission) => checkPolicy(env, profile, permission, true, flags, ask),
         sendsPerHour: Number.MAX_SAFE_INTEGER,
-        journal: new SendJournal(join(paths(env).state, "sends", `${profile}.jsonl`)),
+        journal: new SendJournal(join(paths(env).state, "sends", `${profile}.jsonl`), {
+            service: "drive",
+            version: VERSION,
+        }),
         recipients: new RecipientList(join(paths(env).state, "recipients", `${profile}.json`), "drive"),
         warn: () => { },
     });

package/dist/policy.js.map

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

package/dist/profile-lock.js

@@ -1,4 +1,4 @@
-import { CliError } from "@wirecat/cli-core";
+import { CliError } from "@wirecat/cli-base";
 import lockfile from "proper-lockfile";
 import { ensureProfileDir, profileDir } from "./state.js";
 export const lockProfile = async (env, name) => {

package/dist/program.d.ts

@@ -1,4 +1,4 @@
-import { type KeyringStore, type Streams } from "@wirecat/cli-core";
+import { type KeyringStore, type Streams } from "@wirecat/cli-base";
 import { Command } from "commander";
 import { type Complete } from "./extraction.js";
 import { type GoogleApi } from "./google-api.js";

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,YAAY,EAEjB,KAAK,OAAO,EAEb,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAAE,OAAO,EAAsC,MAAM,WAAW,CAAA;AAIvE,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,iBAAiB,CAAA;AAE5D,OAAO,EAAa,KAAK,SAAS,EAAa,MAAM,iBAAiB,CAAA;AAGtE,OAAO,EAAE,KAAK,aAAa,EAAU,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAY1E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IACnD,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAA;CAC7C;AAWD,eAAO,MAAM,aAAa,aAAa,cAAc,KAAQ,OA+mB5D,CAAA"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,YAAY,EAEjB,KAAK,OAAO,EAEb,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAAE,OAAO,EAAsC,MAAM,WAAW,CAAA;AAIvE,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,iBAAiB,CAAA;AAE5D,OAAO,EAAa,KAAK,SAAS,EAAa,MAAM,iBAAiB,CAAA;AAGtE,OAAO,EAAE,KAAK,aAAa,EAAU,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAW1E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IACnD,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAA;CAC7C;AAWD,eAAO,MAAM,aAAa,aAAa,cAAc,KAAQ,OAooB5D,CAAA"}

package/dist/program.js

@@ -1,11 +1,11 @@
 import { readFileSync, writeFileSync } from "node:fs";
-import { CliError, createDeadline, createOutputBuffer, createRenderer, processStreams, visibleControls, } from "@wirecat/cli-core";
-import { annotate, describeOptions, flatten, metaOf } from "@wirecat/cli-core/commands";
-import { formatSuggestions, suggest } from "@wirecat/cli-core/completion";
+import { CliError, createDeadline, createOutputBuffer, createRenderer, processStreams, visibleControls, } from "@wirecat/cli-base";
+import { annotate, describeOptions, flatten, metaOf } from "@wirecat/cli-base/commands";
+import { formatSuggestions, suggest } from "@wirecat/cli-base/completion";
 import { commandWords, liftProfile, parseDuration, refuseCommandName } from "@wirecat/cli-messaging/cli";
 import { Command, Help, InvalidArgumentError, Option } from "commander";
-import { operationOf, validateRequest } from "./api-contract.js";
-import { activeProfile, application, fileId, profileName, readConfig, writeConfig } from "./config.js";
+import { validateRequest } from "./api-contract.js";
+import { activeProfile, application, checkTextLimit, fileId, profileName, readConfig, writeConfig } from "./config.js";
 import { googleError } from "./errors.js";
 import { memoryModel } from "./extraction.js";
 import { googleSource } from "./google.js";
@@ -15,9 +15,8 @@ import { login } from "./login.js";
 import { FOLDER } from "./model.js";
 import { checkPolicy, guardedGoogleWrite, methodPolicyKeys } from "./policy.js";
 import { lockProfile } from "./profile-lock.js";
-import { ACCOUNT_FREE_COMMANDS, describeDriveProgram } from "./registry.js";
+import { ACCOUNT_FREE_COMMANDS, commandsDocument, describeDriveProgram, examples } from "./registry.js";
 import { installRemoteCommands } from "./remote-commands.js";
-import { requestSchema } from "./schema.js";
 import { readSnapshot, readState } from "./state.js";
 import { openIndex } from "./store.js";
 import { sync } from "./sync.js";
@@ -39,7 +38,7 @@ export const createProgram = (options = {}) => {
     const env = options.env ?? process.env;
     const streams = options.streams ?? processStreams;
     const program = new Command("drive")
-        .description("Manage Google Drive and Docs, local Markdown, shared knowledge and search")
+        .description("manage Google Drive and Docs, local Markdown, shared knowledge and search")
         .version(VERSION)
         .usage("<profile> [options] <command>")
         .option("--profile <name>", "explicit Google account profile (alternative to the first word)")
@@ -48,7 +47,7 @@ export const createProgram = (options = {}) => {
         .option("--agent-json", "show control and direction characters visibly in machine output")
         .option("--quiet", "suppress optional diagnostics")
         .option("--timeout <duration>", "whole-command deadline, e.g. 30s", (raw) => parseDuration(raw, "--timeout"))
-        .option("--max-output-bytes <n>", "bound buffered result output", offset, 4 * 1024 * 1024)
+        .option("--max-output-bytes <n>", "largest result to print, in bytes; 0 for no limit", offset, 4 * 1024 * 1024)
         .option("--read-only", "refuse local and remote mutations")
         .option("--offline", "answer only operations that use local cached data")
         .option("--dry-run", "validate command/policy and preview without acting")
@@ -129,16 +128,14 @@ export const createProgram = (options = {}) => {
             await index.close();
         }
     };
-    const session = program.command("session").description("Google browser sign-in and local account profiles");
-    session
-        .command("start")
-        .description("Approve Google access in your browser; read-only unless --write is requested")
-        .option("--client-file <file>", "use your own Desktop OAuth application JSON instead of WireCat's app")
-        .option("--credential-storage <storage>", "keyring or explicit private-file storage", "keyring")
-        .option("--no-browser", "print the sign-in URL without opening a browser")
-        .option("--write", "request remote Drive/Docs mutation permissions")
-        .option("--activity", "also request Drive Activity history permissions")
-        .option("--apps", "also request the installed Drive applications permission")
+    const session = program.command("session").description("sign in to Google and manage local profiles");
+    examples(session.command("start").description("sign in to Google in the browser; read-only unless you pass --write"), ["drive personal session start", "drive work session start --write --activity"])
+        .option("--client-file <file>", "path to your own Desktop OAuth client JSON, used instead of WireCat's")
+        .option("--credential-storage <storage>", "where the sign-in is kept: keyring, or file for a private file", "keyring")
+        .option("--no-browser", "print the sign-in URL instead of opening a browser")
+        .option("--write", "also ask for permission to change Drive files and Docs")
+        .option("--activity", "also ask for permission to read Drive Activity history")
+        .option("--apps", "also ask for permission to see installed Drive apps")
         .action(async (args) => {
         if (args.credentialStorage !== "keyring" && args.credentialStorage !== "file")
             throw new CliError("validation_error", "credential storage is keyring or file");
@@ -156,10 +153,9 @@ export const createProgram = (options = {}) => {
             showUrl: (url) => streams.diagnostic(`Open Google sign-in: ${url}\n`),
         }));
     });
-    session
-        .command("list")
-        .description("Configured account profiles; no credentials are printed")
-        .action(() => output({
+    examples(session.command("list").description("list the configured profiles; credentials are never printed"), [
+        "drive personal session list",
+    ]).action(() => output({
         scope: "all-configured-profiles",
         items: Object.entries(readConfig(env).profiles).map(([name, p]) => ({
             profile: name,
@@ -167,10 +163,9 @@ export const createProgram = (options = {}) => {
             storage: p.storage,
         })),
     }));
-    session
-        .command("end")
-        .description("Remove this profile's local sign-in; cached data is retained")
-        .action(() => {
+    examples(session.command("end").description("sign this profile out; imported documents stay"), [
+        "drive personal session end",
+    ]).action(() => {
         const name = selected();
         const config = readConfig(env);
         const profile = activeProfile(env, name);
@@ -179,12 +174,12 @@ export const createProgram = (options = {}) => {
         writeConfig(env, config);
         output({ profile: name, signedOut: true, cachedData: "retained" });
     });
-    const folders = program.command("folders").description("Select Google folders for local ingestion");
-    folders
+    const folders = program.command("folders").description("choose the Google Drive folders that sync imports");
+    const folderArgument = "folder id or Google Drive URL";
+    examples(folders
         .command("add")
-        .argument("<url-or-id>")
-        .description("Include a folder and its descendants")
-        .action(async (input) => {
+        .argument("<folder>", folderArgument)
+        .description("import a folder and everything under it on the next sync"), ["drive personal folders add FOLDER_ID"]).action(async (input) => {
         const id = fileId(input);
         const config = readConfig(env);
         const name = selected();
@@ -198,15 +193,13 @@ export const createProgram = (options = {}) => {
         writeConfig(env, config);
         output({ id: metadata.id, name: metadata.name, added: true });
     });
-    folders
-        .command("list")
-        .description("Selected folder IDs")
-        .action(() => output({ items: activeProfile(env, selected()).roots.map((id) => ({ id })) }));
-    folders
+    examples(folders.command("list").description("list the folder ids sync imports"), [
+        "drive personal folders list",
+    ]).action(() => output({ items: activeProfile(env, selected()).roots.map((id) => ({ id })) }));
+    examples(folders
         .command("remove")
-        .argument("<url-or-id>")
-        .description("Stop importing a folder; sync removes sources outside the remaining scope")
-        .action((input) => {
+        .argument("<folder>", folderArgument)
+        .description("stop importing a folder; the next sync drops its documents"), ["drive personal folders remove FOLDER_ID"]).action((input) => {
         const id = fileId(input);
         const config = readConfig(env);
         const name = selected();
@@ -216,16 +209,14 @@ export const createProgram = (options = {}) => {
         writeConfig(env, config);
         output({ id, removed: true, next: `run drive ${name} sync to reconcile cached sources` });
     });
-    program
-        .command("sync")
-        .description("Fetch selected sources and resume a durable pending batch")
-        .option("--max <n>", "maximum source operations this run", positive, 200)
-        .option("--rescan", "reconcile selected folders from a fresh change token")
-        .option("--embed", "embed pending shared note chunks using an already-downloaded model")
+    examples(program.command("sync").description("import what changed in the chosen folders, and finish an unfinished sync"), ["drive personal sync", "drive personal sync --rescan --limit 500"])
+        .option("--limit <n>", "how many documents to read from Google in this run", positive, 200)
+        .option("--rescan", "read every chosen folder again instead of only what changed")
+        .option("--embed", "also index pending text for meaning search, with a model already downloaded")
         .action(async (args) => {
         const remote = activeProfile(env, selected()).roots.length ? await source() : undefined;
         const result = await withIndex(async (index) => ({
-            ...(await sync(remote, index, env, selected(), args.max, activeSignal, args.rescan)),
+            ...(await sync(remote, index, env, selected(), args.limit, activeSignal, args.rescan)),
             ...(args.embed ? { embeddings: await index.embed(600) } : {}),
         }));
         output(result);
@@ -234,10 +225,9 @@ export const createProgram = (options = {}) => {
         if (result.errors.length)
             throw new CliError("provider_error", "sync completed partially; failed operations remain pending");
     });
-    program
-        .command("status")
-        .description("Local sync checkpoint, cached sources and pending work")
-        .action(() => {
+    examples(program.command("status").description("show the last sync, imported documents and pending work"), [
+        "drive personal status",
+    ]).action(() => {
         const name = selected();
         const profile = activeProfile(env, name);
         const state = readState(env, name, profile.principal);
@@ -252,12 +242,14 @@ export const createProgram = (options = {}) => {
             remoteChecked: false,
         });
     });
-    const documents = program.command("documents").description("Locally imported sources and exports");
-    documents
-        .command("list")
-        .description("Imported sources with original Google URLs")
-        .option("--tag <tag>", "filter by a local shared tag")
-        .option("--person <reference>", "filter by a linked shared person reference")
+    const documents = program.command("documents").description("read imported documents and Google Docs");
+    const documentArgument = "document id or Google Docs URL";
+    examples(documents.command("list").description("list imported documents with their Google URLs"), [
+        "drive personal documents list",
+        "drive personal documents list --tag budget",
+    ])
+        .option("--tag <tag>", "only documents with this tag")
+        .option("--person <reference>", "only documents linked to this person:<uid> reference")
         .action(async (args) => {
         const profile = activeProfile(env, selected());
         const state = readState(env, selected(), profile.principal);
@@ -289,31 +281,30 @@ export const createProgram = (options = {}) => {
         const doc = state.documents[id];
         return { id, ref: doc.reference, hash: doc.hash, snapshot: readSnapshot(env, selected(), id) };
     };
-    documents
+    examples(documents
         .command("show")
-        .argument("<url-or-id>")
-        .description("Imported text with tab and source metadata")
-        .action((input) => {
+        .argument("<document>", documentArgument)
+        .description("show an imported document's text, tabs and metadata"), ["drive personal documents show DOC_ID"]).action((input) => {
         const { snapshot } = imported(input);
         output({ metadata: snapshot.metadata, text: snapshot.text, tabs: snapshot.tabs });
     });
-    documents
+    examples(documents
         .command("export")
-        .argument("<url-or-id>")
-        .requiredOption("--out <file>", "destination Markdown file")
-        .description("Write the native Markdown snapshot; existing files are refused")
+        .argument("<document>", documentArgument)
+        .description("write an imported document to a new Markdown file"), ["drive personal documents export DOC_ID --out notes.md"])
+        .requiredOption("--out <file>", "path of the Markdown file to write; an existing file is refused")
         .action((input, args) => {
         const { id, snapshot } = imported(input);
         writeFileSync(args.out, snapshot.markdown, { flag: "wx", mode: 0o600 });
         output({ id, path: args.out, format: "markdown" });
     });
-    program
+    examples(program
         .command("search")
-        .argument("<query>")
-        .description("Shared keyword and optional semantic search over imported Google sources")
-        .option("--limit <n>", "maximum results", positive, 20)
-        .option("--offset <n>", "results to skip", offset, 0)
-        .option("--exact", "keyword search only, without stemming or meaning")
+        .argument("<query>", "words to look for")
+        .description("search imported documents by words, and by meaning when indexed"), ["drive personal search budget", `drive personal search "quarterly plan" --exact --limit 5`])
+        .option("--limit <n>", "how many results to return", positive, 20)
+        .option("--offset <n>", "how many results to skip", offset, 0)
+        .option("--exact", "match the words exactly: no word forms, no meaning")
         .action(async (query, args) => output(await withIndex((index) => index.search(activeProfile(env, selected()).principal, query, { ...args, exact: args.exact ?? false }))));
     installKnowledgeCommands(program, {
         document: imported,
@@ -374,15 +365,17 @@ export const createProgram = (options = {}) => {
             return descriptor.mutates ? guardedGoogleWrite(env, selected(), `api.${method}`, act, flags, askOnce) : act();
         },
     });
-    const config = program
-        .command("config")
-        .description("Shared-style defaults/profile settings; credentials are separate");
-    config.command("show").action(() => output(readConfig(env)));
-    config
-        .command("set")
-        .argument("<key>")
-        .argument("<json-value>")
-        .option("--defaults", "change defaults rather than the selected profile")
+    const config = program.command("config").description("read and change settings; credentials are kept apart");
+    examples(config.command("show").description("show the defaults and every profile's settings"), [
+        "drive personal config show",
+    ]).action(() => output(readConfig(env)));
+    examples(config.command("set").description("set one setting of this profile, or of the defaults"), [
+        "drive personal config set readOnly true",
+        `drive personal config set permissions.files '"readonly"' --defaults`,
+    ])
+        .argument("<key>", "readOnly, maxTextChars, permissions.<key> or models.<purpose>.<field>")
+        .argument("<json-value>", "the new value, as JSON")
+        .option("--defaults", "change the defaults instead of this profile")
         .action((key, raw, args) => {
         const value = readConfig(env);
         if (args.defaults)
@@ -393,9 +386,9 @@ export const createProgram = (options = {}) => {
         if (!args.defaults)
             value.profiles[selected()] = target;
         const [head, ...parts] = key.split(".");
-        if (!["readOnly", "permissions", "models"].includes(head ?? "") ||
+        if (!["readOnly", "permissions", "models", "maxTextChars"].includes(head ?? "") ||
             parts.some((part) => ["__proto__", "prototype", "constructor"].includes(part)))
-            throw new CliError("validation_error", "config set accepts readOnly, permissions or models");
+            throw new CliError("validation_error", "config set accepts readOnly, permissions, models or maxTextChars");
         let parsed;
         try {
             parsed = JSON.parse(raw);
@@ -403,7 +396,9 @@ export const createProgram = (options = {}) => {
         catch {
             throw new CliError("validation_error", "setting value must be JSON");
         }
-        if (!parts.length)
+        if (head === "maxTextChars" && !parts.length)
+            target.maxTextChars = checkTextLimit(parsed);
+        else if (!parts.length)
             Object.assign(target, { [key]: parsed });
         else if (head === "permissions") {
             target.permissions ??= {};
@@ -419,10 +414,10 @@ export const createProgram = (options = {}) => {
         writeConfig(env, value);
         output({ key, updated: true, scope: args.defaults ? "defaults" : selected() });
     });
-    program
-        .command("complete")
-        .description("Shell completion from the shared command registry")
-        .argument("[words...]")
+    examples(program.command("complete").description("print a shell completion script, or complete words"), [
+        "drive complete zsh",
+    ])
+        .argument("[words...]", "a shell name, or after -- the words typed so far")
         .allowUnknownOption()
         .helpOption(false)
         .action(async (words) => {
@@ -435,25 +430,17 @@ export const createProgram = (options = {}) => {
         else
             streams.data(formatSuggestions(suggest({ commands: describeDriveProgram(program), globalOptions: describeOptions(program), words })));
     });
-    program
-        .command("schema")
-        .argument("<method>")
-        .description("Generated request schema and operation contract without Google access")
-        .action((method) => {
-        const operation = operationOf(method);
-        output({
-            operation,
-            requestSchema: requestSchema(method),
-        });
-    });
-    program
+    examples(program
         .command("models")
-        .description("Configure the shared model gateway; keys stay outside config")
-        .command("configure")
-        .option("--purpose <purpose>", "shared model purpose", "memories")
-        .addOption(new Option("--provider <provider>").choices(["openai", "anthropic", "off"]).makeOptionMandatory())
-        .option("--model <model>", "model identifier for the selected provider")
-        .option("--base-url <url>", "optional HTTP/S model endpoint without URL credentials")
+        .description("choose the model that proposes memories; keys stay out of config")
+        .command("set")
+        .description("set the provider and model for one use"), ["drive personal models set --provider openai --model MODEL_ID", "drive personal models set --provider off"])
+        .option("--purpose <purpose>", "what the model is used for", "memories")
+        .addOption(new Option("--provider <provider>", "who runs the model, or off to use none")
+        .choices(["openai", "anthropic", "off"])
+        .makeOptionMandatory())
+        .option("--model <model>", "model id at the provider")
+        .option("--base-url <url>", "HTTP or HTTPS address of the model API, without credentials in it")
         .action((args) => {
         const config = readConfig(env);
         config.defaults ??= {};
@@ -466,8 +453,13 @@ export const createProgram = (options = {}) => {
         writeConfig(env, config);
         output({ purpose: args.purpose, configured: true });
     });
-    const mcp = program.command("mcp").description("Expose guarded commands over MCP stdio");
-    mcp.option("--tools", "list offered tools without starting a server").action(async (args) => {
+    const mcp = examples(program.command("mcp").description("serve drive's commands to an agent over MCP on stdio"), [
+        "drive personal mcp",
+        "drive personal mcp --tools",
+    ]);
+    mcp
+        .option("--tools", "list the tools offered instead of starting the server")
+        .action(async (args) => {
         const { mcpTools, serveMcp } = await import("./mcp.js");
         if (args.tools)
             output({
@@ -480,20 +472,12 @@ export const createProgram = (options = {}) => {
         else
             await serveMcp({ ...options, env, ...(activeSignal ? { signal: activeSignal } : {}) }, selected(), policyFlags());
     });
-    program
-        .command("commands")
-        .argument("[path...]")
-        .description("Discover the command tree and options as shared registry data")
-        .action((path) => {
-        const commands = describeDriveProgram(program);
-        const found = path.length ? flatten(commands).filter((item) => item.path.join(" ") === path.join(" ")) : commands;
-        if (path.length && !found.length)
-            throw new CliError("not_found", "command path was not found");
-        output({
-            items: found,
-            ...(path.length ? {} : { cli: "drive", commands, globalOptions: describeOptions(program) }),
-        });
-    });
+    examples(program.command("commands").description("print the command tree and its options as data"), [
+        "drive commands --json",
+        "drive commands files copy --json",
+    ])
+        .argument("[path...]", "only this command or group, as words")
+        .action((path) => output(commandsDocument(program, path)));
     for (const info of flatten(describeDriveProgram(program))) {
         let command = program;
         for (const part of info.path)
@@ -507,8 +491,8 @@ export const createProgram = (options = {}) => {
             "documents export",
             "tags add",
             "tags remove",
-            "links add",
-            "links remove",
+            "relationships add",
+            "relationships remove",
             "notes add",
             "notes edit",
             "notes remove",
@@ -516,8 +500,10 @@ export const createProgram = (options = {}) => {
             "memories confirm",
             "memories stale",
             "memories extract",
-            "people link",
-            "models configure",
+            "facts add",
+            "facts confirm",
+            "identities link",
+            "models set",
             "config set",
         ];
         const remoteWrites = [
@@ -562,7 +548,7 @@ export const createProgram = (options = {}) => {
         if (ACCOUNT_FREE_COMMANDS.has(words))
             return;
         selected();
-        if (["commands", "complete", "schema", "config show", "config set", "session list"].includes(words))
+        if (["commands", "complete", "config show", "config set", "session list"].includes(words))
             return;
         const flags = policyFlags();
         const metadata = metaOf(action);