greprag 5.18.0 → 5.19.0

package/dist/commands/corpus/search.js

@@ -0,0 +1,110 @@
+"use strict";
+/** greprag corpus search — single-store and multistore lexical retrieval.
+ *
+ *  Single-store: positional <store> + query. Multistore (--all / --store / --kind):
+ *  RRF-fused via /v1/search, hits labeled by store. The agent owns query
+ *  formulation (websearch_to_tsquery syntax); no server-side LLM. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchCmd = searchCmd;
+const client_1 = require("./client");
+const SEARCH_VALUE_FLAGS = new Set(['--limit', '--section', '--shape', '--store', '--kind']);
+async function searchCmd(args) {
+    const cfg = (0, client_1.getConfig)();
+    if (!cfg.apiKey)
+        (0, client_1.abortNotConfigured)();
+    const all = args.includes('--all');
+    const storeFlags = (0, client_1.getFlags)(args, '--store');
+    const kind = (0, client_1.getFlag)(args, '--kind');
+    const multistore = all || storeFlags.length > 0 || !!kind;
+    const limit = parseInt((0, client_1.getFlag)(args, '--limit') || (multistore ? '8' : '5'), 10);
+    const section = (0, client_1.getFlag)(args, '--section');
+    const shape = (0, client_1.getFlag)(args, '--shape');
+    const positionals = (0, client_1.extractPositionals)(args, SEARCH_VALUE_FLAGS);
+    // Multistore: --all (every tenant store) or one/more --store <ref>. The lone
+    // positional is the query (no positional store in this mode).
+    if (multistore) {
+        const queryText = positionals[0];
+        if (!queryText) {
+            console.error('Usage: greprag corpus search "<lexical query>" (--all | --store <ref> [--store <ref>]...) [--kind K] [--limit 8] [--section "<heading>"]');
+            process.exit(1);
+        }
+        let storeIds;
+        if (storeFlags.length > 0) {
+            storeIds = [];
+            for (const ref of storeFlags)
+                storeIds.push((await (0, client_1.resolveStore)(ref, cfg.apiUrl, cfg.apiKey)).id);
+        }
+        else if (kind) {
+            const list = await (0, client_1.apiGet)(`${cfg.apiUrl}/v1/stores?kind=${encodeURIComponent(kind)}`, cfg.apiKey);
+            storeIds = list.stores.map(s => s.id);
+            if (storeIds.length === 0) {
+                console.error(`No stores with kind="${kind}".`);
+                process.exit(1);
+            }
+        }
+        // else: storeIds undefined → search every store under the tenant.
+        await runMultiSearch(cfg, queryText, storeIds, limit, section);
+        return;
+    }
+    // Single-store: positional store + query.
+    const storeRef = positionals[0];
+    const queryText = positionals[1];
+    if (!storeRef || !queryText) {
+        console.error('Usage: greprag corpus search <storeIdOrName> "<lexical query>" [--limit 5] [--section "<heading>"] [--shape dialogue]\n   or: greprag corpus search "<query>" --all | --store <ref>...    (multistore)');
+        process.exit(1);
+    }
+    const store = await (0, client_1.resolveStore)(storeRef, cfg.apiUrl, cfg.apiKey);
+    const filters = {};
+    if (section)
+        filters.section = section;
+    if (shape)
+        filters.shape = shape;
+    const t0 = Date.now();
+    const result = await (0, client_1.apiCall)(`${cfg.apiUrl}/v1/stores/${store.id}/query`, cfg.apiKey, {
+        query: queryText, limit,
+        ...(Object.keys(filters).length > 0 ? { filters } : {}),
+    });
+    if (!result.ok || !result.nodes)
+        throw new Error(result.error || 'query failed');
+    const ms = Date.now() - t0;
+    console.log(`\n${store.name} (${store.kind}, ${store.nodeCount} nodes) ← "${queryText}"`);
+    console.log(`  ${result.nodes.length} hits in ${ms}ms (server ${result.latencyMs ?? '?'}ms)\n`);
+    for (const n of result.nodes) {
+        const heading = n.headingPath?.length ? ` · ${n.headingPath.join(' / ')}` : '';
+        const snippet = n.content.length > 280 ? n.content.slice(0, 277) + '...' : n.content;
+        console.log(`  [${n.nodeId}] score=${n.score.toFixed(3)} pos=${n.position}${heading}`);
+        console.log(`    ${snippet.replace(/\n/g, ' ')}\n`);
+    }
+    if (result.nodes[0]) {
+        console.log(`Walk: greprag corpus walk ${JSON.stringify(store.name)} ${result.nodes[0].nodeId}`);
+    }
+}
+/** Cross-store search via POST /v1/search. storeIds omitted = all tenant stores;
+ *  RRF fuses across (store × query). Hits are labeled with their store name. */
+async function runMultiSearch(cfg, queryText, storeIds, limit, section) {
+    const list = await (0, client_1.apiGet)(`${cfg.apiUrl}/v1/stores`, cfg.apiKey);
+    const nameById = new Map(list.stores.map(s => [s.id, s.name]));
+    const body = {
+        queries: [queryText], limit, adjacencyWindow: 3, adjacencyAlpha: 0.3,
+    };
+    if (storeIds)
+        body.storeIds = storeIds;
+    if (section)
+        body.filters = { section };
+    const t0 = Date.now();
+    const result = await (0, client_1.apiCall)(`${cfg.apiUrl}/v1/search`, cfg.apiKey, body);
+    if (!result.ok || !result.nodes)
+        throw new Error(result.error || 'search failed');
+    const ms = Date.now() - t0;
+    const scope = storeIds ? `${storeIds.length} store${storeIds.length === 1 ? '' : 's'}` : 'all stores';
+    console.log(`\nMultistore search (${scope}) ← "${queryText}"`);
+    console.log(`  ${result.nodes.length} hits in ${ms}ms\n`);
+    for (const n of result.nodes) {
+        const store = nameById.get(n.storeId) || n.storeId.slice(0, 8);
+        const heading = n.headingPath?.length ? ` · ${n.headingPath.join(' / ')}` : '';
+        const snippet = n.content.length > 240 ? n.content.slice(0, 237) + '...' : n.content;
+        console.log(`  [${store} · ${n.nodeId}] score=${n.score.toFixed(3)}${heading}`);
+        console.log(`    ${snippet.replace(/\n/g, ' ')}\n`);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/corpus/search.js.map

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

package/dist/commands/corpus/section.d.ts

@@ -0,0 +1,5 @@
+/** greprag corpus section — every node under a heading prefix.
+ *
+ *  Forgiving match: any depth, case-/dash-insensitive, leaf prefix. Resolved
+ *  server-side against the heading path stored on each node. */
+export declare function sectionCmd(args: string[]): Promise<void>;

package/dist/commands/corpus/section.js

@@ -0,0 +1,35 @@
+"use strict";
+/** greprag corpus section — every node under a heading prefix.
+ *
+ *  Forgiving match: any depth, case-/dash-insensitive, leaf prefix. Resolved
+ *  server-side against the heading path stored on each node. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sectionCmd = sectionCmd;
+const client_1 = require("./client");
+async function sectionCmd(args) {
+    const cfg = (0, client_1.getConfig)();
+    if (!cfg.apiKey)
+        (0, client_1.abortNotConfigured)();
+    const storeRef = args[0];
+    const headingPath = args[1];
+    if (!storeRef || !headingPath) {
+        console.error('Usage: greprag corpus section <storeIdOrName> "<heading>"\n  e.g. greprag corpus section "Scientific Advertising" "Chapter 7"\n  Forgiving match: any depth, case-/dash-insensitive, leaf prefix.');
+        process.exit(1);
+    }
+    const store = await (0, client_1.resolveStore)(storeRef, cfg.apiUrl, cfg.apiKey);
+    const url = `${cfg.apiUrl}/v1/stores/${store.id}/section?path=${encodeURIComponent(headingPath)}`;
+    const res = await (0, client_1.apiGet)(url, cfg.apiKey);
+    if (!res.ok || !res.nodes)
+        throw new Error(res.error || 'section failed');
+    console.log(`\n${store.name} · section "${headingPath}" — ${res.nodes.length} node${res.nodes.length === 1 ? '' : 's'}\n`);
+    for (const n of res.nodes) {
+        const heading = n.headingPath?.length ? ` · ${n.headingPath.join(' / ')}` : '';
+        const snippet = n.content.length > 200 ? n.content.slice(0, 197) + '...' : n.content;
+        console.log(`  [${n.nodeId}] pos=${n.position}${heading}`);
+        console.log(`    ${snippet.replace(/\n/g, ' ')}\n`);
+    }
+    if (res.nodes.length === 0) {
+        console.log('No nodes under that heading. Check a hit\'s headingPath from `corpus search`, or broaden the heading.');
+    }
+}
+//# sourceMappingURL=section.js.map

package/dist/commands/corpus/section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.js","sourceRoot":"","sources":["../../../src/commands/corpus/section.ts"],"names":[],"mappings":";AAAA;;;gEAGgE;;AAOhE,gCA0BC;AA/BD,qCAGkB;AAEX,KAAK,UAAU,UAAU,CAAC,IAAc;IAC7C,MAAM,GAAG,GAAG,IAAA,kBAAS,GAAE,CAAC;IACxB,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,IAAA,2BAAkB,GAAE,CAAC;IAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,mMAAmM,CAAC,CAAC;QACnN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,IAAA,qBAAY,EAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnE,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,cAAc,KAAK,CAAC,EAAE,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IAClG,MAAM,GAAG,GAAG,MAAM,IAAA,eAAM,EAAgF,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC;IAE1E,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,eAAe,WAAW,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3H,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACrF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,QAAQ,GAAG,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,uGAAuG,CAAC,CAAC;IACvH,CAAC;AACH,CAAC"}

package/dist/commands/corpus/source.d.ts

@@ -0,0 +1,15 @@
+/** greprag corpus — source loading + format routing.
+ *
+ *  Decides whether a file/URL passes through as Markdown/text or ships raw bytes
+ *  for the Worker to convert server-side. The extension sets here MIRROR
+ *  packages/api/src/lib/convert.ts — keep the three sets in sync. */
+export interface LoadedSource {
+    mode: 'markdown' | 'convert';
+    text?: string;
+    base64?: string;
+    format: string;
+    filename: string;
+    defaultName: string;
+    byteLength: number;
+}
+export declare function readSource(source: string): Promise<LoadedSource>;

package/dist/commands/corpus/source.js

@@ -0,0 +1,119 @@
+"use strict";
+/** greprag corpus — source loading + format routing.
+ *
+ *  Decides whether a file/URL passes through as Markdown/text or ships raw bytes
+ *  for the Worker to convert server-side. The extension sets here MIRROR
+ *  packages/api/src/lib/convert.ts — keep the three sets in sync. */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSource = readSource;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const client_1 = require("./client");
+// Formats the Worker converts server-side (sent as base64 bytes). Everything
+// else — markdown, plain text, source code, unknown/extensionless — ships as
+// UTF-8 text and passes through unchanged. Deferred formats fail loud here.
+// MIRRORS packages/api/src/lib/convert.ts — keep the three sets in sync.
+const CONVERT_EXT = new Set([
+    'html', 'htm', 'pdf', 'docx', 'xlsx', 'xls', 'xlsm', 'xlsb', 'csv', 'ods', 'odt',
+]);
+// pptx / ppt / odp convert server-side via officeparser (## Slide N + notes).
+const OFFICEPARSER_EXT = new Set(['pptx', 'ppt', 'odp']);
+const DEFERRED_EXT = new Set(['png', 'jpg', 'jpeg', 'webp', 'svg', 'gif']);
+const MIME_TO_EXT = {
+    'text/html': 'html',
+    'text/csv': 'csv',
+    'text/plain': 'txt',
+    'text/markdown': 'md',
+    'application/pdf': 'pdf',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation': 'pptx',
+    'application/vnd.oasis.opendocument.presentation': 'odp',
+};
+function extOf(name) {
+    const m = name.toLowerCase().match(/\.([a-z0-9]+)$/);
+    return m ? m[1] : '';
+}
+async function readSource(source) {
+    let bytes;
+    let filename;
+    let ext;
+    if ((0, client_1.isUrl)(source)) {
+        const res = await fetch(source);
+        if (!res.ok)
+            throw new Error(`fetch ${source}: HTTP ${res.status}`);
+        bytes = new Uint8Array(await res.arrayBuffer());
+        const u = new URL(source);
+        filename = path.basename(u.pathname) || u.hostname;
+        ext = extOf(u.pathname)
+            || MIME_TO_EXT[(res.headers.get('content-type') || '').split(';')[0].trim()]
+            || 'html';
+    }
+    else {
+        const abs = path.resolve(source);
+        if (!fs.existsSync(abs))
+            throw new Error(`file not found: ${abs}`);
+        bytes = new Uint8Array(fs.readFileSync(abs));
+        filename = path.basename(abs);
+        ext = extOf(abs);
+    }
+    const defaultName = filename.replace(/\.[a-z0-9]+$/i, '') || filename;
+    if (DEFERRED_EXT.has(ext)) {
+        throw new Error(`"${ext}" files aren't supported yet. Supported: text / markdown / code, and ` +
+            `${[...CONVERT_EXT, ...OFFICEPARSER_EXT].sort().join(', ')}. ` +
+            `Images need OCR (gated) — see docs/corpus-converter-completion.md.`);
+    }
+    if (CONVERT_EXT.has(ext) || OFFICEPARSER_EXT.has(ext)) {
+        return {
+            mode: 'convert',
+            base64: Buffer.from(bytes).toString('base64'),
+            format: ext,
+            filename: extOf(filename) ? filename : `${filename}.${ext}`,
+            defaultName,
+            byteLength: bytes.length,
+        };
+    }
+    // Passthrough: markdown, plain text, source code, unknown/extensionless.
+    return {
+        mode: 'markdown',
+        text: new TextDecoder().decode(bytes),
+        format: ext || 'txt',
+        filename,
+        defaultName,
+        byteLength: bytes.length,
+    };
+}
+//# sourceMappingURL=source.js.map

package/dist/commands/corpus/source.js.map

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

package/dist/commands/corpus/status.d.ts

@@ -0,0 +1,5 @@
+/** greprag corpus status — write-side enrichment progress for a store.
+ *
+ *  Renders the per-node vocabulary-bridge drainer state (completed / pending /
+ *  in-progress / failed) as a progress bar. The drainer runs every 2 minutes. */
+export declare function statusCmd(args: string[]): Promise<void>;

package/dist/commands/corpus/status.js

@@ -0,0 +1,47 @@
+"use strict";
+/** greprag corpus status — write-side enrichment progress for a store.
+ *
+ *  Renders the per-node vocabulary-bridge drainer state (completed / pending /
+ *  in-progress / failed) as a progress bar. The drainer runs every 2 minutes. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusCmd = statusCmd;
+const client_1 = require("./client");
+async function statusCmd(args) {
+    const cfg = (0, client_1.getConfig)();
+    if (!cfg.apiKey)
+        (0, client_1.abortNotConfigured)();
+    const ref = args[0];
+    if (!ref) {
+        console.error('Usage: greprag corpus status <storeIdOrName>');
+        process.exit(1);
+    }
+    const store = await (0, client_1.resolveStore)(ref, cfg.apiUrl, cfg.apiKey);
+    const res = await (0, client_1.apiGet)(`${cfg.apiUrl}/v1/stores/${store.id}/enrichment`, cfg.apiKey);
+    if (!res.ok || !res.status)
+        throw new Error(res.error || 'status failed');
+    const s = res.status;
+    const pct = s.total > 0 ? Math.round((s.completed / s.total) * 100) : 0;
+    const barWidth = 30;
+    const filled = Math.round((pct / 100) * barWidth);
+    const bar = '█'.repeat(filled) + '░'.repeat(barWidth - filled);
+    console.log(`\n${store.name} · ${store.nodeCount} nodes · ${store.kind}`);
+    console.log(`\n  Enrichment:  [${bar}] ${pct}%`);
+    console.log(`  Completed:   ${s.completed.toLocaleString().padStart(6)} / ${s.total.toLocaleString()}`);
+    if (s.pending > 0)
+        console.log(`  Pending:     ${s.pending.toLocaleString().padStart(6)}`);
+    if (s.in_progress > 0)
+        console.log(`  In progress: ${s.in_progress.toLocaleString().padStart(6)}`);
+    if (s.failed > 0)
+        console.log(`  Failed:      ${s.failed.toLocaleString().padStart(6)}  (after ${5} attempts — won't retry)`);
+    if (res.enrichmentNotifiedAt) {
+        console.log(`  Last notify: ${res.enrichmentNotifiedAt}`);
+    }
+    console.log('');
+    if (s.pending > 0 || s.in_progress > 0) {
+        console.log('Drainer runs every 2 minutes. Re-run this command to watch progress.\n');
+    }
+    else if (s.completed > 0) {
+        console.log(`Ready. Try: greprag corpus search ${JSON.stringify(store.name)} "<your question>"\n`);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/corpus/status.js.map

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

package/dist/commands/corpus/upload.d.ts

@@ -0,0 +1,7 @@
+/** greprag corpus upload — create a store and ingest a source.
+ *
+ *  Text/markdown/code pass through; html/pdf/docx/xlsx/csv/pptx convert
+ *  server-side. A source URL can register for the freshness loop via --refresh;
+ *  the server persists the StoreRefreshState and the cron / `corpus refresh`
+ *  re-fetch it. Local files are not refreshable. */
+export declare function uploadCmd(args: string[]): Promise<void>;

package/dist/commands/corpus/upload.js

@@ -0,0 +1,101 @@
+"use strict";
+/** greprag corpus upload — create a store and ingest a source.
+ *
+ *  Text/markdown/code pass through; html/pdf/docx/xlsx/csv/pptx convert
+ *  server-side. A source URL can register for the freshness loop via --refresh;
+ *  the server persists the StoreRefreshState and the cron / `corpus refresh`
+ *  re-fetch it. Local files are not refreshable. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadCmd = uploadCmd;
+const client_1 = require("./client");
+const source_1 = require("./source");
+// Valid --refresh values. MIRRORS REFRESH_POLICIES / DEFAULT_REFRESH_POLICY in
+// packages/core/src/corpus-refresh.ts — the CLI ships zero runtime deps so it
+// can't import the constant; keep in sync. 'manual' = only on explicit
+// `corpus refresh`; 'off' (default) = a one-shot ingest, no background work.
+const REFRESH_POLICIES = ['hourly', 'daily', 'manual', 'off'];
+const DEFAULT_REFRESH_POLICY = 'off';
+async function uploadCmd(args) {
+    const cfg = (0, client_1.getConfig)();
+    if (!cfg.apiKey)
+        (0, client_1.abortNotConfigured)();
+    const source = args[0];
+    if (!source) {
+        console.error('Usage: greprag corpus upload <file|url> (--enriched | --raw) [--name N] [--kind K] [--refresh hourly|daily|manual|off]\n  Formats: text / markdown / code pass through; html, pdf, docx, xlsx, csv, pptx convert server-side.');
+        process.exit(1);
+    }
+    const kindFlag = ((0, client_1.getFlag)(args, '--kind') || 'book');
+    if (!client_1.VALID_KINDS.includes(kindFlag)) {
+        console.error(`--kind must be one of: ${client_1.VALID_KINDS.join(', ')}`);
+        process.exit(1);
+    }
+    // Required, no default: the caller must declare the processing mode.
+    // Enrichment (per-node LLM vocabulary bridge) earns its cost only when
+    // there's a semantic gap between how someone asks and how the text is
+    // written — a judgment about the content that can't be inferred. Force it.
+    const wantsEnriched = args.includes('--enriched');
+    const wantsRaw = args.includes('--raw');
+    if (wantsEnriched === wantsRaw) { // neither, or both
+        console.error('Specify exactly one mode:\n' +
+            '  --enriched   per-node LLM vocabulary bridge — prose, voice, memory (query wording differs from the text)\n' +
+            '  --raw        chunk + lexical index only — docs, code, references (search terms already match the text)');
+        process.exit(1);
+    }
+    const enriched = wantsEnriched;
+    // Freshness registration (B7). --refresh validates against the policy set; the
+    // server persists where to re-fetch + how often. Only URLs are refreshable —
+    // a local file has no canonical source to poll, so warn and skip.
+    const refreshFlag = (0, client_1.getFlag)(args, '--refresh');
+    if (refreshFlag !== undefined && !REFRESH_POLICIES.includes(refreshFlag)) {
+        console.error(`--refresh must be one of: ${REFRESH_POLICIES.join(', ')}`);
+        process.exit(1);
+    }
+    const sourceIsUrl = (0, client_1.isUrl)(source);
+    if (refreshFlag !== undefined && !sourceIsUrl) {
+        console.warn(`Note: --refresh only applies to URLs — "${source}" is a local file, ingesting once (no refresh tracking).`);
+    }
+    const refreshPolicy = refreshFlag ?? DEFAULT_REFRESH_POLICY;
+    const loaded = await (0, source_1.readSource)(source);
+    const name = (0, client_1.getFlag)(args, '--name') || loaded.defaultName;
+    const sizeBit = loaded.mode === 'convert'
+        ? `${loaded.format}, ${(loaded.byteLength / 1024).toFixed(1)} KB → converting server-side`
+        : `${loaded.text.trim().split(/\s+/).length.toLocaleString()} words`;
+    console.log(`Uploading "${name}" (${kindFlag}, ${enriched ? 'enriched' : 'raw'}, ${sizeBit})...`);
+    // A URL source registers for refresh (policy defaults to 'off' = source
+    // recorded but not auto-refreshed). Local files don't.
+    const createBody = { name, kind: kindFlag, enriched, metadata: { source } };
+    if (sourceIsUrl)
+        createBody.refresh = { url: source, policy: refreshPolicy };
+    const create = await (0, client_1.apiCall)(`${cfg.apiUrl}/v1/stores`, cfg.apiKey, createBody);
+    if (!create.ok || !create.store)
+        throw new Error(create.error || 'create failed');
+    const store = create.store;
+    // Markdown/text passes through; convertible formats ship raw bytes for the
+    // Worker to turn into clean Markdown via env.AI.toMarkdown().
+    const ingestBody = loaded.mode === 'convert'
+        ? { source: { data: loaded.base64, format: loaded.format, filename: loaded.filename } }
+        : { markdown: loaded.text };
+    const ingest = await (0, client_1.apiCall)(`${cfg.apiUrl}/v1/stores/${store.id}/nodes`, cfg.apiKey, ingestBody);
+    if (!ingest.ok)
+        throw new Error(ingest.error || 'ingest failed');
+    console.log(`\n  Store ID:  ${store.id}`);
+    console.log(`  Name:      ${store.name}`);
+    console.log(`  Kind:      ${store.kind}`);
+    const insBits = [`${ingest.inserted ?? 0} nodes`];
+    if (ingest.fresh)
+        insBits.push(`${ingest.fresh} fresh`);
+    if (ingest.preserved)
+        insBits.push(`${ingest.preserved} preserved`);
+    if (ingest.removed?.length)
+        insBits.push(`${ingest.removed.length} removed`);
+    console.log(`  Ingested:  ${insBits.join(', ')}`);
+    console.log(`  Words:     ${ingest.totalWords?.toLocaleString() ?? '?'}`);
+    if (ingest.enrichmentQueued) {
+        console.log(`  Enrich:    ${ingest.enrichmentQueued} queued (GR5 phrase-aware)`);
+    }
+    if (sourceIsUrl && refreshPolicy !== 'off') {
+        console.log(`  Refresh:   ${refreshPolicy} — source tracked; check state with 'greprag corpus sources ${JSON.stringify(store.name)}'`);
+    }
+    console.log(`\nTry: greprag corpus search ${JSON.stringify(store.name)} "<lexical query>"`);
+}
+//# sourceMappingURL=upload.js.map

package/dist/commands/corpus/upload.js.map

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

package/dist/commands/corpus/walk.d.ts

@@ -0,0 +1,5 @@
+/** greprag corpus walk — show a node and its positional neighbors.
+ *
+ *  Two hops: resolve the anchor node by stable ID to learn its position, then
+ *  expand a window around that position. The anchor is marked with a star. */
+export declare function walkCmd(args: string[]): Promise<void>;

package/dist/commands/corpus/walk.js

@@ -0,0 +1,41 @@
+"use strict";
+/** greprag corpus walk — show a node and its positional neighbors.
+ *
+ *  Two hops: resolve the anchor node by stable ID to learn its position, then
+ *  expand a window around that position. The anchor is marked with a star. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walkCmd = walkCmd;
+const client_1 = require("./client");
+async function walkCmd(args) {
+    const cfg = (0, client_1.getConfig)();
+    if (!cfg.apiKey)
+        (0, client_1.abortNotConfigured)();
+    const storeRef = args[0];
+    const nodeId = args[1];
+    if (!storeRef || !nodeId) {
+        console.error('Usage: greprag corpus walk <storeIdOrName> <nodeId> [--before 2 --after 2]');
+        process.exit(1);
+    }
+    const before = parseInt((0, client_1.getFlag)(args, '--before') || '2', 10);
+    const after = parseInt((0, client_1.getFlag)(args, '--after') || '2', 10);
+    const store = await (0, client_1.resolveStore)(storeRef, cfg.apiUrl, cfg.apiKey);
+    // Step 1: fetch the anchor node to learn its position.
+    const anchorRes = await (0, client_1.apiGet)(`${cfg.apiUrl}/v1/stores/${store.id}/by-node-id/${nodeId}`, cfg.apiKey);
+    if (!anchorRes.ok || !anchorRes.node)
+        throw new Error(anchorRes.error || 'node not found');
+    const anchor = anchorRes.node;
+    // Step 2: expand around its position.
+    const win = await (0, client_1.apiGet)(`${cfg.apiUrl}/v1/stores/${store.id}/expand?center=${anchor.position}&before=${before}&after=${after}`, cfg.apiKey);
+    if (!win.ok || !win.nodes)
+        throw new Error(win.error || 'expand failed');
+    console.log(`\n${store.name} · walking ${nodeId} (pos ${anchor.position}, ±${before}/${after}):\n`);
+    for (const n of win.nodes) {
+        const isAnchor = n.nodeId === nodeId;
+        const marker = isAnchor ? '★' : ' ';
+        const heading = n.headingPath?.length ? ` · ${n.headingPath.join(' / ')}` : '';
+        const snippet = n.content.length > 320 ? n.content.slice(0, 317) + '...' : n.content;
+        console.log(`  ${marker} [${n.nodeId}] pos=${n.position}${heading}`);
+        console.log(`    ${snippet.replace(/\n/g, ' ')}\n`);
+    }
+}
+//# sourceMappingURL=walk.js.map

package/dist/commands/corpus/walk.js.map

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

package/dist/commands/session.d.ts

@@ -0,0 +1,8 @@
+/** greprag session — session registry operations.
+ *
+ *  retitle <session-8hex> "<title>" — force-set a session's registry title,
+ *  overriding the gpt-5.4-nano auto-title. Used by the multi-chip /chip-leader
+ *  convention: a chip stamps its own label-aligned title ("Chip A — …") in
+ *  Block 1 so the FleetView watcher list / Discord /switch line up with the
+ *  leader's chip labels. Thin HTTP client over POST /v1/memory/title. */
+export declare function runSession(args: string[]): Promise<void>;