@cesarandreslopez/occ 0.3.0 → 0.4.0

package/dist/src/doc/inspect-docx.js

@@ -0,0 +1,188 @@
+import JSZip from 'jszip';
+import mammoth from 'mammoth';
+import { countWords } from '../utils.js';
+import { asOptionalString, formatDateLike } from '../inspect/shared.js';
+function parseXmlText(xml, tag) {
+    const regex = new RegExp(`<${tag}[^>]*>([^<]*)</${tag}>`, 'i');
+    const match = xml.match(regex);
+    return match?.[1]?.trim() || undefined;
+}
+export async function extractDocxProperties(zip) {
+    const props = {};
+    const coreXml = await zip.file('docProps/core.xml')?.async('text');
+    if (coreXml) {
+        props.title = asOptionalString(parseXmlText(coreXml, 'dc:title'));
+        props.subject = asOptionalString(parseXmlText(coreXml, 'dc:subject'));
+        props.author = asOptionalString(parseXmlText(coreXml, 'dc:creator'));
+        props.keywords = asOptionalString(parseXmlText(coreXml, 'cp:keywords'));
+        props.lastModifiedBy = asOptionalString(parseXmlText(coreXml, 'cp:lastModifiedBy'));
+        props.createdDate = formatDateLike(parseXmlText(coreXml, 'dcterms:created'));
+        props.modifiedDate = formatDateLike(parseXmlText(coreXml, 'dcterms:modified'));
+    }
+    const appXml = await zip.file('docProps/app.xml')?.async('text');
+    if (appXml) {
+        props.company = asOptionalString(parseXmlText(appXml, 'Company'));
+    }
+    return props;
+}
+export async function extractDocxRiskFlags(zip) {
+    const flags = {
+        comments: false,
+        trackedChanges: false,
+        hyperlinks: false,
+        embeddedObjects: false,
+        footnotes: false,
+        endnotes: false,
+        macros: false,
+        headerFooter: false,
+        tables: false,
+        encrypted: false,
+    };
+    // Check comments
+    const commentsXml = await zip.file('word/comments.xml')?.async('text');
+    if (commentsXml && /<w:comment\b/.test(commentsXml)) {
+        flags.comments = true;
+    }
+    // Check document.xml for tracked changes, tables, hyperlinks
+    const docXml = await zip.file('word/document.xml')?.async('text');
+    if (docXml) {
+        if (/<w:ins\b/.test(docXml) || /<w:del\b/.test(docXml))
+            flags.trackedChanges = true;
+        if (/<w:tbl\b/.test(docXml))
+            flags.tables = true;
+        if (/<w:hyperlink\b/.test(docXml))
+            flags.hyperlinks = true;
+    }
+    // Check for macros
+    if (zip.file('word/vbaProject.bin'))
+        flags.macros = true;
+    // Check for images
+    const mediaFiles = Object.keys(zip.files).filter(name => name.startsWith('word/media/'));
+    if (mediaFiles.length > 0)
+        flags.embeddedObjects = true;
+    // Check footnotes/endnotes
+    const footnotesXml = await zip.file('word/footnotes.xml')?.async('text');
+    if (footnotesXml && /<w:footnote\b/.test(footnotesXml)) {
+        // Word always has footnotes.xml with separator/continuationSeparator; check for actual footnotes
+        const realFootnotes = (footnotesXml.match(/<w:footnote\b/g) || []).length;
+        if (realFootnotes > 2)
+            flags.footnotes = true; // skip the 2 built-in
+    }
+    const endnotesXml = await zip.file('word/endnotes.xml')?.async('text');
+    if (endnotesXml && /<w:endnote\b/.test(endnotesXml)) {
+        const realEndnotes = (endnotesXml.match(/<w:endnote\b/g) || []).length;
+        if (realEndnotes > 2)
+            flags.endnotes = true;
+    }
+    // Check headers/footers
+    const headerFiles = Object.keys(zip.files).filter(name => /^word\/(header|footer)\d*\.xml$/.test(name));
+    if (headerFiles.length > 0)
+        flags.headerFooter = true;
+    return flags;
+}
+export async function extractDocxContentStats(filePath, zip) {
+    const result = await mammoth.extractRawText({ path: filePath });
+    const text = result.value || '';
+    const words = countWords(text);
+    const paragraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0).length;
+    const characters = text.length;
+    // Pages from app.xml if available
+    const appXml = await zip.file('docProps/app.xml')?.async('text');
+    let pages = 0;
+    let pagesEstimated = true;
+    if (appXml) {
+        const pagesStr = parseXmlText(appXml, 'Pages');
+        if (pagesStr) {
+            const parsed = parseInt(pagesStr, 10);
+            if (parsed > 0) {
+                pages = parsed;
+                pagesEstimated = false;
+            }
+        }
+    }
+    if (pages === 0) {
+        pages = Math.max(1, Math.ceil(words / 250));
+        pagesEstimated = true;
+    }
+    // Count tables from HTML conversion
+    let tables = 0;
+    try {
+        const htmlResult = await mammoth.convertToHtml({ path: filePath });
+        const html = htmlResult.value || '';
+        tables = (html.match(/<table\b/gi) || []).length;
+    }
+    catch { /* ignore */ }
+    // Count images
+    const mediaFiles = Object.keys(zip.files).filter(name => name.startsWith('word/media/'));
+    const images = mediaFiles.length;
+    return { words, pages, pagesEstimated, paragraphs, characters, tables, images };
+}
+export async function extractDocxPreview(filePath, sampleParagraphs) {
+    const result = await mammoth.convertToHtml({ path: filePath });
+    const html = result.value || '';
+    if (!html.trim()) {
+        return { truncated: false, paragraphs: [] };
+    }
+    // Use turndown to convert to markdown for heading detection
+    const TurndownService = (await import('turndown')).default;
+    const turndown = new TurndownService({ headingStyle: 'atx' });
+    const markdown = turndown.turndown(html);
+    return buildPreviewFromMarkdown(markdown, sampleParagraphs);
+}
+export function buildPreviewFromMarkdown(markdown, sampleParagraphs) {
+    const lines = markdown.split('\n');
+    const previews = [];
+    let paragraphIndex = 0;
+    let i = 0;
+    while (i < lines.length && previews.length < sampleParagraphs) {
+        const line = lines[i].trim();
+        if (!line) {
+            i++;
+            continue;
+        }
+        const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+        if (headingMatch) {
+            previews.push({
+                index: paragraphIndex,
+                text: headingMatch[2],
+                isHeading: true,
+                headingLevel: headingMatch[1].length,
+            });
+        }
+        else {
+            // Collect contiguous non-empty lines as one paragraph
+            let text = line;
+            while (i + 1 < lines.length && lines[i + 1].trim() && !lines[i + 1].trim().match(/^#{1,6}\s/)) {
+                i++;
+                text += ' ' + lines[i].trim();
+            }
+            previews.push({
+                index: paragraphIndex,
+                text,
+                isHeading: false,
+            });
+        }
+        paragraphIndex++;
+        i++;
+    }
+    // Check for remaining content
+    let hasMore = false;
+    for (let j = i; j < lines.length; j++) {
+        if (lines[j].trim()) {
+            hasMore = true;
+            break;
+        }
+    }
+    return { truncated: hasMore, paragraphs: previews };
+}
+export async function inspectDocx(filePath, buffer, sampleParagraphs) {
+    const zip = await JSZip.loadAsync(buffer);
+    const [properties, riskFlags, contentStats, preview] = await Promise.all([
+        extractDocxProperties(zip),
+        extractDocxRiskFlags(zip),
+        extractDocxContentStats(filePath, zip),
+        extractDocxPreview(filePath, sampleParagraphs),
+    ]);
+    return { properties, riskFlags, contentStats, preview };
+}
+//# sourceMappingURL=inspect-docx.js.map

package/dist/src/doc/inspect-docx.js.map

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

package/dist/src/doc/inspect-odt.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentProperties } from '../inspect/shared.js';
+import type { DocRiskFlags, DocContentStats, ContentPreview } from './types.js';
+export declare function inspectOdt(filePath: string, buffer: Buffer, sampleParagraphs: number): Promise<{
+    properties: DocumentProperties;
+    riskFlags: DocRiskFlags;
+    contentStats: DocContentStats;
+    preview: ContentPreview;
+}>;

package/dist/src/doc/inspect-odt.js

@@ -0,0 +1,91 @@
+import JSZip from 'jszip';
+import officeparser from 'officeparser';
+import { countWords } from '../utils.js';
+import { asOptionalString, formatDateLike } from '../inspect/shared.js';
+function parseXmlText(xml, tag) {
+    const regex = new RegExp(`<${tag}[^>]*>([^<]*)</${tag}>`, 'i');
+    const match = xml.match(regex);
+    return match?.[1]?.trim() || undefined;
+}
+export async function inspectOdt(filePath, buffer, sampleParagraphs) {
+    const zip = await JSZip.loadAsync(buffer);
+    // Parse metadata from meta.xml
+    const properties = {};
+    const metaXml = await zip.file('meta.xml')?.async('text');
+    if (metaXml) {
+        properties.title = asOptionalString(parseXmlText(metaXml, 'dc:title'));
+        properties.subject = asOptionalString(parseXmlText(metaXml, 'dc:subject'));
+        properties.author = asOptionalString(parseXmlText(metaXml, 'dc:creator') ?? parseXmlText(metaXml, 'meta:initial-creator'));
+        properties.keywords = asOptionalString(parseXmlText(metaXml, 'meta:keyword'));
+        properties.createdDate = formatDateLike(parseXmlText(metaXml, 'meta:creation-date'));
+        properties.modifiedDate = formatDateLike(parseXmlText(metaXml, 'dc:date'));
+    }
+    // Parse risk flags from content.xml
+    const riskFlags = {
+        comments: false,
+        trackedChanges: false,
+        hyperlinks: false,
+        embeddedObjects: false,
+        footnotes: false,
+        endnotes: false,
+        macros: false,
+        headerFooter: false,
+        tables: false,
+        encrypted: false,
+    };
+    const contentXml = await zip.file('content.xml')?.async('text');
+    if (contentXml) {
+        if (/<office:annotation\b/.test(contentXml))
+            riskFlags.comments = true;
+        if (/<text:tracked-changes\b/.test(contentXml))
+            riskFlags.trackedChanges = true;
+        if (/<text:a\b[^>]*xlink:href=/.test(contentXml))
+            riskFlags.hyperlinks = true;
+        if (/<draw:frame\b/.test(contentXml))
+            riskFlags.embeddedObjects = true;
+        if (/<text:note\b/.test(contentXml))
+            riskFlags.footnotes = true;
+        if (/<table:table\b/.test(contentXml))
+            riskFlags.tables = true;
+    }
+    // Check for macros
+    if (zip.file('Basic/') || zip.file('Scripts/'))
+        riskFlags.macros = true;
+    // Extract text via officeparser
+    const text = await officeparser.parseOffice(buffer);
+    const words = countWords(text);
+    const paragraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0).length;
+    // Count images and tables from content.xml
+    let images = 0;
+    let tables = 0;
+    if (contentXml) {
+        images = (contentXml.match(/<draw:image\b/g) || []).length;
+        tables = (contentXml.match(/<table:table\b/g) || []).length;
+    }
+    const contentStats = {
+        words,
+        pages: Math.max(1, Math.ceil(words / 250)),
+        pagesEstimated: true,
+        paragraphs,
+        characters: text.length,
+        tables,
+        images,
+    };
+    // Build preview
+    const textParagraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0);
+    const previewParagraphs = [];
+    const limit = Math.min(sampleParagraphs, textParagraphs.length);
+    for (let i = 0; i < limit; i++) {
+        previewParagraphs.push({
+            index: i,
+            text: textParagraphs[i].trim().replace(/\s+/g, ' '),
+            isHeading: false,
+        });
+    }
+    const preview = {
+        truncated: textParagraphs.length > sampleParagraphs,
+        paragraphs: previewParagraphs,
+    };
+    return { properties, riskFlags, contentStats, preview };
+}
+//# sourceMappingURL=inspect-odt.js.map

package/dist/src/doc/inspect-odt.js.map

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

package/dist/src/doc/inspect-pdf.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentProperties } from '../inspect/shared.js';
+import type { DocRiskFlags, DocContentStats, ContentPreview } from './types.js';
+export declare function inspectPdf(filePath: string, buffer: Buffer, sampleParagraphs: number): Promise<{
+    properties: DocumentProperties;
+    riskFlags: DocRiskFlags;
+    contentStats: DocContentStats;
+    preview: ContentPreview;
+}>;

package/dist/src/doc/inspect-pdf.js

@@ -0,0 +1,82 @@
+import pdf from 'pdf-parse';
+import { countWords } from '../utils.js';
+import { asOptionalString, formatDateLike } from '../inspect/shared.js';
+function parsePdfDate(value) {
+    if (!value)
+        return undefined;
+    const str = String(value);
+    // PDF dates: D:YYYYMMDDHHmmSS or plain ISO strings
+    const match = str.match(/^D:(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/);
+    if (match) {
+        return `${match[1]}-${match[2]}-${match[3]}T${match[4]}:${match[5]}:${match[6]}Z`;
+    }
+    return formatDateLike(str);
+}
+export async function inspectPdf(filePath, buffer, sampleParagraphs) {
+    // Suppress pdf.js warnings
+    const originalLog = console.log;
+    console.log = (...args) => {
+        if (typeof args[0] === 'string' && (args[0].startsWith('Warning: ') || args[0].startsWith('Info: ') || args[0].startsWith('Deprecated API usage: '))) {
+            return;
+        }
+        originalLog.apply(console, args);
+    };
+    let data;
+    try {
+        data = await pdf(buffer);
+    }
+    finally {
+        console.log = originalLog;
+    }
+    const info = data.info || {};
+    const properties = {
+        title: asOptionalString(info.Title),
+        subject: asOptionalString(info.Subject),
+        author: asOptionalString(info.Author),
+        keywords: asOptionalString(info.Keywords),
+        createdDate: parsePdfDate(info.CreationDate),
+        modifiedDate: parsePdfDate(info.ModDate),
+    };
+    // PDFs have limited risk flag detection
+    const riskFlags = {
+        comments: false,
+        trackedChanges: false,
+        hyperlinks: false,
+        embeddedObjects: false,
+        footnotes: false,
+        endnotes: false,
+        macros: false,
+        headerFooter: false,
+        tables: false,
+        encrypted: !!info.IsAcroFormPresent || info.Encrypted === true,
+    };
+    const text = data.text || '';
+    const words = countWords(text);
+    const paragraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0).length;
+    const contentStats = {
+        words,
+        pages: data.numpages,
+        pagesEstimated: false,
+        paragraphs,
+        characters: text.length,
+        tables: 0,
+        images: 0,
+    };
+    // Build preview from text
+    const textParagraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0);
+    const previewParagraphs = [];
+    const limit = Math.min(sampleParagraphs, textParagraphs.length);
+    for (let i = 0; i < limit; i++) {
+        previewParagraphs.push({
+            index: i,
+            text: textParagraphs[i].trim().replace(/\s+/g, ' '),
+            isHeading: false,
+        });
+    }
+    const preview = {
+        truncated: textParagraphs.length > sampleParagraphs,
+        paragraphs: previewParagraphs,
+    };
+    return { properties, riskFlags, contentStats, preview };
+}
+//# sourceMappingURL=inspect-pdf.js.map

package/dist/src/doc/inspect-pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-pdf.js","sourceRoot":"","sources":["../../../src/doc/inspect-pdf.ts"],"names":[],"mappings":"AACA,OAAO,GAAG,MAAM,WAAW,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAIxE,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,mDAAmD;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACzE,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IACpF,CAAC;IACD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,MAAc,EACd,gBAAwB;IAOxB,2BAA2B;IAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAChC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;QACnC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC;YACrJ,OAAO;QACT,CAAC;QACD,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,IAAI,IAAuE,CAAC;IAC5E,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,GAAG,WAAW,CAAC;IAC5B,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAE7B,MAAM,UAAU,GAAuB;QACrC,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC;QACnC,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC;QACvC,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC;QACrC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACzC,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC;QAC5C,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;KACzC,CAAC;IAEF,wCAAwC;IACxC,MAAM,SAAS,GAAiB;QAC9B,QAAQ,EAAE,KAAK;QACf,cAAc,EAAE,KAAK;QACrB,UAAU,EAAE,KAAK;QACjB,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,KAAK;QACb,YAAY,EAAE,KAAK;QACnB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,IAAK,IAAgC,CAAC,SAAS,KAAK,IAAI;KAC5F,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAE/E,MAAM,YAAY,GAAoB;QACpC,KAAK;QACL,KAAK,EAAE,IAAI,CAAC,QAAQ;QACpB,cAAc,EAAE,KAAK;QACrB,UAAU;QACV,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;KACV,CAAC;IAEF,0BAA0B;IAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5E,MAAM,iBAAiB,GAAiC,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAChE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,iBAAiB,CAAC,IAAI,CAAC;YACrB,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;YACnD,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAmB;QAC9B,SAAS,EAAE,cAAc,CAAC,MAAM,GAAG,gBAAgB;QACnD,UAAU,EAAE,iBAAiB;KAC9B,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AAC1D,CAAC"}

package/dist/src/doc/inspect.d.ts

@@ -0,0 +1,2 @@
+import type { DocumentInspection, InspectDocOptions } from './types.js';
+export declare function inspectDocument(filePath: string, options: InspectDocOptions): Promise<DocumentInspection>;

package/dist/src/doc/inspect.js

@@ -0,0 +1,70 @@
+import path from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { getExtension } from '../utils.js';
+import { estimateTokens } from '../inspect/shared.js';
+import { documentToMarkdown } from '../markdown/convert.js';
+import { extractFromMarkdown } from '../structure/index.js';
+import { inspectDocx } from './inspect-docx.js';
+import { inspectPdf } from './inspect-pdf.js';
+import { inspectOdt } from './inspect-odt.js';
+const SUPPORTED_EXTENSIONS = new Set(['docx', 'pdf', 'odt']);
+export async function inspectDocument(filePath, options) {
+    const resolvedPath = path.resolve(filePath);
+    const ext = getExtension(resolvedPath);
+    if (!SUPPORTED_EXTENSIONS.has(ext)) {
+        throw new Error(`Unsupported document format: .${ext || '(none)'} (expected .docx, .pdf, or .odt)`);
+    }
+    const buffer = await readFile(resolvedPath);
+    const format = ext;
+    let result;
+    switch (format) {
+        case 'docx':
+            result = await inspectDocx(resolvedPath, buffer, options.sampleParagraphs);
+            break;
+        case 'pdf':
+            result = await inspectPdf(resolvedPath, buffer, options.sampleParagraphs);
+            break;
+        case 'odt':
+            result = await inspectOdt(resolvedPath, buffer, options.sampleParagraphs);
+            break;
+    }
+    // Structure extraction
+    let structure = null;
+    if (options.includeStructure) {
+        try {
+            const markdown = await documentToMarkdown(resolvedPath);
+            if (markdown) {
+                const docStructure = extractFromMarkdown(markdown);
+                if (docStructure.totalNodes > 0) {
+                    const topLevelSections = docStructure.rootNodes.map(n => n.title);
+                    structure = {
+                        headingCount: docStructure.totalNodes,
+                        maxDepth: docStructure.maxDepth,
+                        topLevelSections,
+                        tree: docStructure.rootNodes,
+                    };
+                }
+            }
+        }
+        catch { /* structure extraction is best-effort */ }
+    }
+    // Token estimates
+    const fullText = [
+        result.preview.paragraphs.map(p => p.text).join(' '),
+    ].join(' ');
+    const fullTokenEstimate = estimateTokens(result.contentStats.characters);
+    const previewTokenEstimate = estimateTokens(result.preview.paragraphs.reduce((sum, p) => sum + p.text.length, 0));
+    return {
+        file: resolvedPath,
+        format,
+        size: buffer.length,
+        properties: result.properties,
+        riskFlags: result.riskFlags,
+        contentStats: result.contentStats,
+        structure,
+        contentPreview: result.preview,
+        fullTokenEstimate,
+        previewTokenEstimate,
+    };
+}
+//# sourceMappingURL=inspect.js.map

package/dist/src/doc/inspect.js.map

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

package/dist/src/doc/output.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentInspection, DocInspectPayload } from './types.js';
+export declare function formatDocPayloadJson(payload: DocInspectPayload): string;
+export declare function formatDocInspection(result: DocumentInspection, ci?: boolean): string;

package/dist/src/doc/output.js

@@ -0,0 +1,82 @@
+import chalk from 'chalk';
+import { formatBytes, formatNumber } from '../utils.js';
+import { sectionHeader, stripAnsi } from '../output/tabular.js';
+const colors = {
+    header: (value) => chalk.bold(value),
+    key: (value) => chalk.cyan(value),
+    value: (value) => value,
+    dim: (value) => chalk.dim(value),
+    ok: (value) => chalk.green(value),
+    warn: (value) => chalk.yellow(value),
+};
+const noColor = Object.fromEntries(Object.keys(colors).map(key => [key, (value) => value]));
+function palette(ci = false) {
+    return ci ? noColor : colors;
+}
+export function formatDocPayloadJson(payload) {
+    return JSON.stringify(payload, null, 2);
+}
+export function formatDocInspection(result, ci = false) {
+    const c = palette(ci);
+    const sections = [];
+    // Overview
+    const overviewLines = [
+        `${c.key('File')}: ${c.value(result.file)}`,
+        `${c.key('Format')}: ${c.value(result.format.toUpperCase())}`,
+        `${c.key('Size')}: ${c.value(formatBytes(result.size))}`,
+    ];
+    const propEntries = Object.entries(result.properties).filter(([, value]) => value);
+    if (propEntries.length > 0) {
+        overviewLines.push(`${c.key('Properties')}: ${propEntries.map(([key, value]) => `${key}=${value}`).join(' | ')}`);
+    }
+    const riskFlags = Object.entries(result.riskFlags).filter(([, enabled]) => enabled).map(([key]) => key);
+    overviewLines.push(`${c.key('Risk Flags')}: ${riskFlags.length > 0 ? c.warn(riskFlags.join(', ')) : c.ok('none')}`);
+    sections.push(overviewLines.join('\n'));
+    // Content Stats
+    const pagesLabel = result.contentStats.pagesEstimated ? ' (estimated)' : '';
+    const statsLines = [
+        `  ${c.key('Words')}: ${formatNumber(result.contentStats.words)}        ${c.key('Pages')}: ${formatNumber(result.contentStats.pages)}${pagesLabel}`,
+        `  ${c.key('Paragraphs')}: ${formatNumber(result.contentStats.paragraphs)}     ${c.key('Characters')}: ${formatNumber(result.contentStats.characters)}`,
+        `  ${c.key('Tables')}: ${formatNumber(result.contentStats.tables)}           ${c.key('Images')}: ${formatNumber(result.contentStats.images)}`,
+        `  ${c.key('Token Estimate')}: preview=${formatNumber(result.previewTokenEstimate)} | full=${formatNumber(result.fullTokenEstimate)}`,
+    ];
+    const statsWidth = Math.max(...statsLines.map(line => stripAnsi(line).length), 56);
+    sections.push(`${c.header(sectionHeader('Content Stats', statsWidth, ci))}\n${statsLines.join('\n')}`);
+    // Structure
+    if (result.structure) {
+        const structLines = [];
+        for (const node of result.structure.tree) {
+            formatTreeNode(node, structLines, '');
+        }
+        const structTitle = `Structure (${result.structure.headingCount} headings, depth ${result.structure.maxDepth})`;
+        const structWidth = Math.max(...structLines.map(line => line.length), structTitle.length + 6, 56);
+        sections.push(`${c.header(sectionHeader(structTitle, structWidth, ci))}\n${structLines.join('\n')}`);
+    }
+    // Content Preview
+    if (result.contentPreview.paragraphs.length > 0) {
+        const previewLines = [];
+        for (const p of result.contentPreview.paragraphs) {
+            if (p.isHeading) {
+                previewLines.push(`  ${c.key(`[H${p.headingLevel}]`)} ${p.text}`);
+            }
+            else {
+                previewLines.push(`  ${p.text.length > 120 ? p.text.slice(0, 120) + '...' : p.text}`);
+            }
+        }
+        if (result.contentPreview.truncated) {
+            const remainingWords = result.contentStats.words - result.contentPreview.paragraphs.reduce((sum, p) => sum + p.text.split(/\s+/).length, 0);
+            const remainingParas = result.contentStats.paragraphs - result.contentPreview.paragraphs.length;
+            previewLines.push(c.dim(`  (${remainingParas} more paragraphs, ~${formatNumber(remainingWords)} remaining words)`));
+        }
+        const previewWidth = Math.max(...previewLines.map(line => stripAnsi(line).length), 56);
+        sections.push(`${c.header(sectionHeader('Content Preview', previewWidth, ci))}\n${previewLines.join('\n')}`);
+    }
+    return sections.join('\n\n') + '\n';
+}
+function formatTreeNode(node, lines, indent) {
+    lines.push(`  ${indent}${node.structureCode ?? ''}   ${node.title}`);
+    for (const child of node.children) {
+        formatTreeNode(child, lines, indent + '  ');
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/src/doc/output.js.map

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

package/dist/src/doc/types.d.ts

@@ -0,0 +1,59 @@
+import type { DocumentProperties } from '../inspect/shared.js';
+import type { StructureNode } from '../structure/types.js';
+export interface DocRiskFlags {
+    comments: boolean;
+    trackedChanges: boolean;
+    hyperlinks: boolean;
+    embeddedObjects: boolean;
+    footnotes: boolean;
+    endnotes: boolean;
+    macros: boolean;
+    headerFooter: boolean;
+    tables: boolean;
+    encrypted: boolean;
+}
+export interface DocContentStats {
+    words: number;
+    pages: number;
+    pagesEstimated: boolean;
+    paragraphs: number;
+    characters: number;
+    tables: number;
+    images: number;
+}
+export interface StructureSummary {
+    headingCount: number;
+    maxDepth: number;
+    topLevelSections: string[];
+    tree: StructureNode[];
+}
+export interface ContentPreview {
+    truncated: boolean;
+    paragraphs: Array<{
+        index: number;
+        text: string;
+        isHeading: boolean;
+        headingLevel?: number;
+    }>;
+}
+export interface DocumentInspection {
+    file: string;
+    format: 'docx' | 'pdf' | 'odt';
+    size: number;
+    properties: DocumentProperties;
+    riskFlags: DocRiskFlags;
+    contentStats: DocContentStats;
+    structure: StructureSummary | null;
+    contentPreview: ContentPreview;
+    fullTokenEstimate: number;
+    previewTokenEstimate: number;
+}
+export interface DocInspectPayload {
+    file: string;
+    query: Record<string, unknown>;
+    results: DocumentInspection;
+}
+export interface InspectDocOptions {
+    sampleParagraphs: number;
+    includeStructure: boolean;
+}