@okrapdf/cli 0.2.10 → 0.2.12

package/dist/lib/sinks/file.d.ts

@@ -0,0 +1,8 @@
+import type { DomOp, DomOpSink } from '../dom-ops.js';
+export declare class FileSink implements DomOpSink {
+    private stream;
+    constructor(filePath: string);
+    emit(ops: DomOp[]): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/lib/sinks/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/lib/sinks/file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEtD,qBAAa,QAAS,YAAW,SAAS;IACxC,OAAO,CAAC,MAAM,CAAc;gBAEhB,QAAQ,EAAE,MAAM;IAItB,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/dist/lib/sinks/file.js

@@ -0,0 +1,30 @@
+import { createWriteStream } from 'fs';
+export class FileSink {
+    stream;
+    constructor(filePath) {
+        this.stream = createWriteStream(filePath, { flags: 'a' });
+    }
+    async emit(ops) {
+        for (const op of ops) {
+            await new Promise((resolve, reject) => {
+                this.stream.write(JSON.stringify(op) + '\n', (err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        }
+    }
+    async close() {
+        await new Promise((resolve, reject) => {
+            this.stream.end((err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/lib/sinks/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/lib/sinks/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,IAAI,CAAC;AAGzD,MAAM,OAAO,QAAQ;IACX,MAAM,CAAc;IAE5B,YAAY,QAAgB;QAC1B,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAY;QACrB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;oBACnD,IAAI,GAAG;wBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;wBAChB,OAAO,EAAE,CAAC;gBACjB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAA6B,EAAE,EAAE;gBAChD,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAChB,OAAO,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/lib/sinks/index.d.ts

@@ -0,0 +1,6 @@
+import type { DomOpSink } from '../dom-ops.js';
+export { PartyKitSink } from './partykit.js';
+export { StdoutSink } from './stdout.js';
+export { FileSink } from './file.js';
+export declare function parseSinkUrl(url: string): DomOpSink;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/sinks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/sinks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK/C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CA2BnD"}

package/dist/lib/sinks/index.js

@@ -0,0 +1,30 @@
+import { PartyKitSink } from './partykit.js';
+import { StdoutSink } from './stdout.js';
+import { FileSink } from './file.js';
+export { PartyKitSink } from './partykit.js';
+export { StdoutSink } from './stdout.js';
+export { FileSink } from './file.js';
+const DEFAULT_PARTYKIT_HOST = 'document-tree-party.steventsao.partykit.dev';
+export function parseSinkUrl(url) {
+    if (url === 'stdout' || url === '-') {
+        return new StdoutSink();
+    }
+    if (url.startsWith('partykit://')) {
+        const parsed = new URL(url);
+        const host = parsed.host || DEFAULT_PARTYKIT_HOST;
+        const roomId = parsed.pathname.replace(/^\//, '');
+        if (!roomId) {
+            throw new Error('PartyKit URL must include room ID: partykit://host/room-id');
+        }
+        return new PartyKitSink(host, roomId);
+    }
+    if (url.startsWith('file://')) {
+        const filePath = url.replace('file://', '');
+        return new FileSink(filePath);
+    }
+    if (url.endsWith('.ndjson') || url.endsWith('.jsonl')) {
+        return new FileSink(url);
+    }
+    throw new Error(`Unknown sink URL format: ${url}. Use partykit://, file://, stdout, or a .ndjson file path`);
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/sinks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/sinks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,qBAAqB,GAAG,6CAA6C,CAAC;AAE5E,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QACpC,OAAO,IAAI,UAAU,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,qBAAqB,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,4DAA4D,CAAC,CAAC;AAC/G,CAAC"}

package/dist/lib/sinks/partykit.d.ts

@@ -0,0 +1,14 @@
+import type { DomOp, DomOpSink } from '../dom-ops.js';
+export declare class PartyKitSink implements DomOpSink {
+    private host;
+    private roomId;
+    private nodePathCache;
+    constructor(host: string, roomId: string);
+    emit(ops: DomOp[]): Promise<void>;
+    close(): Promise<void>;
+    private toJdomPatches;
+    private resolvePath;
+    private toJdom;
+    private typeToTag;
+}
+//# sourceMappingURL=partykit.d.ts.map

package/dist/lib/sinks/partykit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partykit.d.ts","sourceRoot":"","sources":["../../../src/lib/sinks/partykit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAa,MAAM,eAAe,CAAC;AAEjE,qBAAa,YAAa,YAAW,SAAS;IAI1C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,aAAa,CAA0C;gBAGrD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;IAGlB,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,aAAa;IAkErB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,SAAS;CAelB"}

package/dist/lib/sinks/partykit.js

@@ -0,0 +1,124 @@
+export class PartyKitSink {
+    host;
+    roomId;
+    nodePathCache = new Map();
+    constructor(host, roomId) {
+        this.host = host;
+        this.roomId = roomId;
+    }
+    async emit(ops) {
+        const patches = ops.flatMap(op => this.toJdomPatches(op));
+        if (patches.length === 0)
+            return;
+        const url = `https://${this.host}/parties/document/${this.roomId}/tree`;
+        const response = await fetch(url, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                patches,
+                reason: 'cli-extraction',
+                mutatedBy: 'cli',
+                mutatedByName: 'OkraPDF CLI'
+            })
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`PartyKit PATCH failed: ${response.status} ${text}`);
+        }
+    }
+    async close() {
+        this.nodePathCache.clear();
+    }
+    toJdomPatches(op) {
+        switch (op.op) {
+            case 'ADD_NODE': {
+                const parentPath = this.resolvePath(op.parentId);
+                const childPath = [...parentPath, 'children', op.index ?? -1];
+                this.nodePathCache.set(op.node.id, [...parentPath, 'children', op.index ?? this.nodePathCache.size]);
+                return [{
+                        op: 'add',
+                        path: childPath,
+                        value: this.toJdom(op.node),
+                    }];
+            }
+            case 'REMOVE_NODE': {
+                const nodePath = this.resolvePath(op.nodeId);
+                this.nodePathCache.delete(op.nodeId);
+                return [{
+                        op: 'remove',
+                        path: nodePath,
+                    }];
+            }
+            case 'UPDATE_NODE': {
+                const patches = [];
+                const nodePath = this.resolvePath(op.nodeId);
+                if (op.patch.text !== undefined) {
+                    patches.push({
+                        op: 'replace',
+                        path: [...nodePath, 'textContent'],
+                        value: op.patch.text,
+                    });
+                }
+                if (op.patch.attrs) {
+                    for (const [key, value] of Object.entries(op.patch.attrs)) {
+                        patches.push({
+                            op: 'replace',
+                            path: [...nodePath, 'attributes', key],
+                            value,
+                        });
+                    }
+                }
+                return patches;
+            }
+            case 'SET_TEXT':
+                return [{
+                        op: 'replace',
+                        path: [...this.resolvePath(op.nodeId), 'textContent'],
+                        value: op.text,
+                    }];
+            case 'SET_ATTR':
+                return [{
+                        op: 'replace',
+                        path: [...this.resolvePath(op.nodeId), 'attributes', op.key],
+                        value: op.value,
+                    }];
+            default:
+                return [];
+        }
+    }
+    resolvePath(nodeId) {
+        if (!nodeId || nodeId === '')
+            return [];
+        const cached = this.nodePathCache.get(nodeId);
+        if (cached)
+            return cached;
+        return [nodeId];
+    }
+    toJdom(node) {
+        return {
+            id: node.id,
+            type: node.type,
+            tagName: this.typeToTag(node.type),
+            page: node.attrs?.page ?? node.attrs?.num ?? 0,
+            textContent: node.text ?? null,
+            attributes: node.attrs ?? {},
+            children: [],
+        };
+    }
+    typeToTag(type) {
+        const map = {
+            document: 'article',
+            page: 'section',
+            table: 'table',
+            figure: 'figure',
+            paragraph: 'p',
+            heading: 'h1',
+            footnote: 'aside',
+            list: 'ul',
+            'list-item': 'li',
+            'ocr-block': 'div',
+        };
+        return map[type] ?? 'div';
+    }
+}
+//# sourceMappingURL=partykit.js.map

package/dist/lib/sinks/partykit.js.map

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

package/dist/lib/sinks/stdout.d.ts

@@ -0,0 +1,6 @@
+import type { DomOp, DomOpSink } from '../dom-ops.js';
+export declare class StdoutSink implements DomOpSink {
+    emit(ops: DomOp[]): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=stdout.d.ts.map

package/dist/lib/sinks/stdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.d.ts","sourceRoot":"","sources":["../../../src/lib/sinks/stdout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEtD,qBAAa,UAAW,YAAW,SAAS;IACpC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B"}

package/dist/lib/sinks/stdout.js

@@ -0,0 +1,9 @@
+export class StdoutSink {
+    async emit(ops) {
+        for (const op of ops) {
+            console.log(JSON.stringify(op));
+        }
+    }
+    async close() { }
+}
+//# sourceMappingURL=stdout.js.map

package/dist/lib/sinks/stdout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.js","sourceRoot":"","sources":["../../../src/lib/sinks/stdout.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAU;IACrB,KAAK,CAAC,IAAI,CAAC,GAAY;QACrB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,KAAmB,CAAC;CAChC"}

package/dist/lib/validator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Dependency validator with gh-style error messages
+ *
+ * Validates job existence and status before running commands
+ * Pattern: Similar to gh CLI (checks git repo), npm run (checks package.json)
+ */
+import { CacheManager } from './cache.js';
+import type { Job, JobStatus } from '../types.js';
+/**
+ * Validation error with helpful suggestions
+ */
+export declare class ValidationError extends Error {
+    readonly suggestions: string[];
+    constructor(message: string, suggestions: string[]);
+    toString(): string;
+}
+/**
+ * Job validation result
+ */
+export interface JobValidation {
+    exists: boolean;
+    status?: JobStatus;
+    job?: Job;
+    error?: ValidationError;
+}
+/**
+ * Validate job ID format
+ */
+export declare function isValidJobId(jobId: string): boolean;
+/**
+ * Check if job exists (cache OR API)
+ */
+export declare function validateJobExists(jobId: string, cache?: CacheManager): Promise<JobValidation>;
+/**
+ * Validate job is complete (not pending/running)
+ */
+export declare function validateJobComplete(validation: JobValidation): ValidationError | null;
+/**
+ * Validate job is ready for query (exists AND complete)
+ *
+ * This is the main validation function used by query commands
+ */
+export declare function validateJobReady(jobId: string, cache?: CacheManager): Promise<{
+    valid: true;
+    job: Job;
+} | {
+    valid: false;
+    error: ValidationError;
+}>;
+/**
+ * Format validation error for display
+ */
+export declare function formatValidationError(error: ValidationError): string;
+/**
+ * Throw validation error with formatted message
+ */
+export declare function throwValidationError(error: ValidationError): never;
+//# sourceMappingURL=validator.d.ts.map

package/dist/lib/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/lib/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGlD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,WAAW,EAAE,MAAM,EAAE;gBADrC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM,EAAE;IAMvC,QAAQ,IAAI,MAAM;CAQnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CA4DxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI,CAgErF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC,CAgB/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAGlE"}

package/dist/lib/validator.js

@@ -0,0 +1,181 @@
+/**
+ * Dependency validator with gh-style error messages
+ *
+ * Validates job existence and status before running commands
+ * Pattern: Similar to gh CLI (checks git repo), npm run (checks package.json)
+ */
+import { get, OkraApiError } from './client.js';
+import { CacheManager } from './cache.js';
+import chalk from 'chalk';
+/**
+ * Validation error with helpful suggestions
+ */
+export class ValidationError extends Error {
+    suggestions;
+    constructor(message, suggestions) {
+        super(message);
+        this.suggestions = suggestions;
+        this.name = 'ValidationError';
+    }
+    toString() {
+        const lines = [
+            chalk.red(`❌ Error: ${this.message}`),
+            '',
+            ...this.suggestions.map(s => `  ${s}`),
+        ];
+        return lines.join('\n');
+    }
+}
+/**
+ * Validate job ID format
+ */
+export function isValidJobId(jobId) {
+    // Job IDs are typically UUIDs or similar alphanumeric strings
+    return /^[a-zA-Z0-9_-]+$/.test(jobId) && jobId.length > 0;
+}
+/**
+ * Check if job exists (cache OR API)
+ */
+export async function validateJobExists(jobId, cache) {
+    // 1. Validate format
+    if (!isValidJobId(jobId)) {
+        return {
+            exists: false,
+            error: new ValidationError(`Invalid job ID format: '${jobId}'`, [
+                'Job IDs should be alphanumeric strings (UUIDs or similar)',
+                '',
+                'Examples:',
+                '  okra query abc123def456 ".table"',
+                '  okra query job_2024_01_15_xyz ".currency"',
+            ]),
+        };
+    }
+    // 2. Check cache first (fast path)
+    const cacheManager = cache || new CacheManager();
+    if (cacheManager.hasJob(jobId)) {
+        // Job exists in cache
+        const cachedJob = cacheManager.getJob(jobId);
+        if (cachedJob) {
+            return {
+                exists: true,
+                status: 'completed', // Cached jobs are always completed
+                job: cachedJob,
+            };
+        }
+    }
+    // 3. Check API (slow path)
+    try {
+        const job = await get(`api/v1/jobs/${jobId}`);
+        return {
+            exists: true,
+            status: job.status,
+            job,
+        };
+    }
+    catch (error) {
+        if (error instanceof OkraApiError && error.statusCode === 404) {
+            return {
+                exists: false,
+                error: new ValidationError(`Job '${jobId}' not found`, [
+                    'Run one of:',
+                    '  okra extract myfile.pdf          # Create new job',
+                    '  okra jobs list                   # List available jobs',
+                ]),
+            };
+        }
+        // Re-throw other errors
+        throw error;
+    }
+}
+/**
+ * Validate job is complete (not pending/running)
+ */
+export function validateJobComplete(validation) {
+    if (!validation.exists || !validation.job) {
+        return new ValidationError('Job validation failed', ['Please run validateJobExists first']);
+    }
+    const status = validation.status || validation.job.status;
+    if (status === 'completed') {
+        return null; // All good
+    }
+    // Job exists but not complete
+    const statusMessages = {
+        queued: {
+            message: `Job '${validation.job.job_id || validation.job.id}' is queued (status: queued)`,
+            suggestions: [
+                'Try:',
+                `  okra jobs get ${validation.job.job_id || validation.job.id}          # Check status`,
+                `  okra jobs wait ${validation.job.job_id || validation.job.id}         # Wait for completion`,
+            ],
+        },
+        pending: {
+            message: `Job '${validation.job.job_id || validation.job.id}' is pending (status: pending)`,
+            suggestions: [
+                'Try:',
+                `  okra jobs get ${validation.job.job_id || validation.job.id}          # Check status`,
+                `  okra jobs wait ${validation.job.job_id || validation.job.id}         # Wait for completion`,
+            ],
+        },
+        running: {
+            message: `Job '${validation.job.job_id || validation.job.id}' is still processing (status: running)`,
+            suggestions: [
+                'Try:',
+                `  okra jobs get ${validation.job.job_id || validation.job.id}          # Check status`,
+                `  okra jobs wait ${validation.job.job_id || validation.job.id}         # Wait for completion`,
+            ],
+        },
+        failed: {
+            message: `Job '${validation.job.job_id || validation.job.id}' failed`,
+            suggestions: [
+                `Error: ${validation.job.error || 'Unknown error'}`,
+                '',
+                'Try:',
+                '  okra extract myfile.pdf          # Create new job',
+            ],
+        },
+        cancelled: {
+            message: `Job '${validation.job.job_id || validation.job.id}' was cancelled`,
+            suggestions: [
+                'Try:',
+                '  okra extract myfile.pdf          # Create new job',
+            ],
+        },
+    };
+    const { message, suggestions } = statusMessages[status] || {
+        message: `Job has unexpected status: ${status}`,
+        suggestions: ['Please contact support'],
+    };
+    return new ValidationError(message, suggestions);
+}
+/**
+ * Validate job is ready for query (exists AND complete)
+ *
+ * This is the main validation function used by query commands
+ */
+export async function validateJobReady(jobId, cache) {
+    // Check if job exists
+    const validation = await validateJobExists(jobId, cache);
+    if (!validation.exists || validation.error) {
+        return { valid: false, error: validation.error };
+    }
+    // Check if job is complete
+    const completeError = validateJobComplete(validation);
+    if (completeError) {
+        return { valid: false, error: completeError };
+    }
+    return { valid: true, job: validation.job };
+}
+/**
+ * Format validation error for display
+ */
+export function formatValidationError(error) {
+    return error.toString();
+}
+/**
+ * Throw validation error with formatted message
+ */
+export function throwValidationError(error) {
+    console.error('\n' + formatValidationError(error) + '\n');
+    process.exit(1);
+}
+//# sourceMappingURL=validator.js.map

package/dist/lib/validator.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okrapdf/cli",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "OkraPDF command-line interface for PDF extraction and document chat",
   "type": "module",
   "main": "dist/index.js",
@@ -55,6 +55,7 @@
     "form-data": "^4.0.0",
     "got": "^14.4.2",
     "ora": "^8.0.1",
+    "pdfquery": "workspace:*",
     "ws": "^8.18.0"
   },
   "optionalDependencies": {