repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

Ignore autoresearch state

7affca9947a5354995a60928718f27d2cb33c36e

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (2)

.gitignore

Modified
1 1 node_modules/
2 2 **/node_modules/
3 3 .demo/
4 +.pi/autoresearch/
4 5 *.tgz
5 6 .DS_Store

.pi/autoresearch/session.jsonl

Deleted
deleted file mode 100644
1 -{"run":10,"commit":"4d2e499","metric":29,"metrics":{},"status":"keep","description":"Iteration 10: Added Programmatic Lua API subsection under Lua Filters covering pandoc.read/write, building Pandoc docs from scratch, file→transform→write pipelines, format conversion in Lua, and metadata access. Verified all programmatic examples with pandoc lua. Fixed expected HTML output for manual Header (no auto id). 9/9 filters pass.","timestamp":1780157777826,"segment":0,"confidence":null,"asi":{"hypothesis":"Add programmatic Lua API coverage for agents that need document processing in code, not shell; fix example accuracy against actual pandoc output","new_coverage":"pandoc.read, pandoc.write, build AST from scratch, doc:walk transform, file read/write, metadata access","examples_verified":"4 programmatic examples passed via pandoc lua","accuracy_fix":"manual Header output has no id unless attr set; corrected expected output","filters":"9/9 pass"}}
2 -{"run":11,"commit":"df7626a","metric":30,"metrics":{},"status":"keep","description":"Iteration 11: Added pandoc-doctor.lua cross-platform diagnostics script and Decision Guide entry. Doctor reports pandoc/API version, OS/arch, reader/writer counts, key format support, common PDF engine availability, executable version, and markdown→html smoke test. Verified output, SKILL.md references, section refs, and 9/9 filters. Scripts: 6.","timestamp":1780157854132,"segment":0,"confidence":null,"asi":{"hypothesis":"Add environment diagnostics for agents debugging PDF engine/format/support failures; reduces troubleshooting friction without bloating main docs","doctor_checks":"version, API, OS/arch, readers/writers, important formats, PDF engines, executable, smoke test","validation":"doctor runs, key diagnostics present, no missing Decision Guide refs, 9/9 filters pass","scripts":6}}
3 -{"run":12,"commit":"941acac","metric":31,"metrics":{},"status":"keep","description":"Iteration 12: Hardened wrapper scripts by replacing os.execute/string command construction with pandoc.pipe argv-list calls in batch-convert, md-to-pdf, web-to-md, and docx-to-md. Fixed batch pattern bug and changed web-to-md to preserve H1 instead of silently shifting it into metadata. Verified filenames with spaces, docx→md with spaces, web H1 preservation, 0 os.execute in scripts, 9/9 filters pass.","timestamp":1780157980678,"segment":0,"confidence":null,"asi":{"hypothesis":"Security/portability hardening: scripts were cross-platform but used shell command strings; argv-list pandoc.pipe avoids shell quoting bugs and handles spaces safely","fixed_bugs":"batch pattern invalid escape; web-to-md dropped H1 due shift-heading-level-by=-1","validation":"space-containing filenames convert; docx with spaces extracts; web H1 preserved; 0 os.execute; 9/9 filters","scripts_hardened":4}}
4 -{"run":13,"commit":"9be664e","metric":32,"metrics":{},"status":"keep","description":"Iteration 13: Corrected diagram-filter.lua accuracy: removed misleading PlantUML support, made it explicitly Graphviz dot/graphviz only, fixed MIME types for PDF outputs (application/pdf), removed unused generate_image function, and improved graceful fallback diagnostic if dot is missing. Updated SKILL.md wording. Verified PlantUML blocks are ignored, dot blocks either generate or fall back unchanged, no PlantUML claims remain, 9/9 filters pass.","timestamp":1780158049033,"segment":0,"confidence":null,"asi":{"hypothesis":"Accuracy over breadth: misleading filter claims are harmful; make diagram-filter precise and robust rather than pretending to support PlantUML","fixed":"PlantUML claim removed, PDF mime fixed, unused function removed, missing-dot fallback clearer","validation":"plantuml ignored, dot fallback works without graphviz, skill wording accurate, 9/9 filters pass"}}
5 -{"run":14,"commit":"f3839c9","metric":33,"metrics":{},"status":"keep","description":"Iteration 14: Fixed admonitions.lua quality/portability bug. Previous HTML path stringified content and lost formatting; LaTeX path crashed by returning nested block list and required undeclared tcolorbox. New filter preserves inner Markdown via pandoc.write for HTML and uses portable [NOTE]/[WARNING] labels for non-HTML. Verified HTML preserves bold/link/list, LaTeX/Markdown do not crash, and 9/9 filters pass.","timestamp":1780158116622,"segment":0,"confidence":null,"asi":{"hypothesis":"Fix broken/low-quality existing filter instead of adding content; admonitions are common and must preserve formatting across outputs","bugs_fixed":"HTML lost formatting; LaTeX crashed; tcolorbox dependency removed","validation":"HTML bold/list preserved, LaTeX and Markdown output stable, 9/9 filters pass","format_support":"styled HTML, portable fallback for other writers"}}
6 -{"run":15,"commit":"44eb971","metric":34,"metrics":{},"status":"keep","description":"Iteration 15: Improved autolink.lua URL boundary handling. Previous filter included trailing prose punctuation in hrefs (e.g. https://example.com. linked with the period). Added trailing punctuation splitting for . , ; : ! ? ) ]. Verified period/comma/paren/question punctuation stay outside links, multiple URLs still work, 9/9 filters pass.","timestamp":1780158167127,"segment":0,"confidence":null,"asi":{"hypothesis":"Fix subtle but common URL autolinking bug; generated hrefs must not include sentence punctuation","bug_fixed":"trailing punctuation included in link target","validation":"period/comma/paren/question stripped; multiple URLs OK; 9/9 filters pass","changed_file":"references/filters/autolink.lua"}}
7 -{"run":16,"commit":"bf8645a","metric":35,"metrics":{},"status":"keep","description":"Iteration 16: Fixed extract-headings.lua to emit a real nested BulletList AST instead of escaped literal Markdown paragraphs. The filter now preserves heading hierarchy, creates actual internal links, handles skipped heading levels, and returns empty output for documents without headings. Verified Markdown list output, HTML nested ul/li output, link hrefs, and 9/9 filters pass.","timestamp":1780158253729,"segment":0,"confidence":null,"asi":{"hypothesis":"Fix existing filter correctness: escaped Markdown output is misleading; agents need real outline links/lists","bug_fixed":"extract-headings produced literal escaped '- [Heading](#id)' paragraphs instead of list/link AST","validation":"nested markdown list, HTML ul/li, internal hrefs, skipped levels, no-heading input, 9/9 filters","changed_file":"references/filters/extract-headings.lua"}}
8 -{"run":17,"commit":"1d7d3c1","metric":36,"metrics":{},"status":"keep","description":"Iteration 17: Fixed center-images.lua LaTeX corruption bug. The prior Image/Plain approach double-wrapped images inside Figure, producing malformed minipage/center LaTeX. Rewrote filter to return explicit filter tables, use topdown traversal, skip Figure children for LaTeX/Beamer, center only image-only paragraphs, and leave inline images unchanged. Verified clean LaTeX figures, centered no-alt image paragraphs, unchanged inline images, HTML styling, and 9/9 filters pass.","timestamp":1780158416994,"segment":0,"confidence":null,"asi":{"hypothesis":"Continue fixing existing filters for real correctness; center-images had subtle LaTeX corruption for captioned figures","bug_fixed":"LaTeX Figure children were being centered, corrupting figure output","validation":"captioned figure clean, image-only paragraph centered, inline image unchanged, HTML style present, 9/9 filters","changed_file":"references/filters/center-images.lua"}}
9 -{"run":18,"commit":"5694044","metric":37,"metrics":{},"status":"keep","description":"Iteration 18: Improved pandoc-doctor.lua accuracy for PDF diagnostics. Doctor no longer misleadingly reports pdf as normal reader/writer; it now labels PDF as writer via engine and runs real smoke tests for available PDF engines. This catches cases where engine binaries exist but PDF generation fails (verified: typst/wkhtmltopdf version OK but smoke FAIL in current env). Updated SKILL.md helper script note. 9/9 filters pass.","timestamp":1780158545607,"segment":0,"confidence":null,"asi":{"hypothesis":"Doctor version checks alone were misleading; real PDF smoke tests better diagnose agent PDF failures","bug_fixed":"pdf shown as -- format despite extension output support; engine binary OK did not mean pandoc PDF works","validation":"doctor prints PDF smoke tests, catches real failures, markdown HTML smoke OK, 9/9 filters","changed_file":"scripts/pandoc-doctor.lua"}}
10 -{"run":19,"commit":"14eda31","metric":38,"metrics":{},"status":"keep","description":"Iteration 19: Improved pandoc-md-to-pdf.lua with real PDF engine auto-detection. If PANDOC_PDF_ENGINE is unset, it smoke-tests xelatex/lualatex/pdflatex/typst/wkhtmltopdf/weasyprint and selects the first working engine; if none work, prints actionable diagnostics instead of blindly failing on xelatex. Preserves env override behavior. Updated SKILL wording. Verified no-engine diagnostic, forced-engine path, and 9/9 filters pass.","timestamp":1780158690706,"segment":0,"confidence":null,"asi":{"hypothesis":"The PDF helper should use doctor-style smoke testing instead of hardcoded xelatex; agents need actionable PDF engine diagnostics","changed_file":"scripts/pandoc-md-to-pdf.lua","validation":"auto-detect no-engine diagnostic, env override, SKILL refs, 9/9 filters","note":"Current env has no working PDF engine; script now reports all attempts clearly"}}
11 -{"run":20,"commit":"5e6e0b7","metric":39,"metrics":{},"status":"keep","description":"Iteration 20: Fixed misleading defaults-file usage. Previous examples used `pandoc -d pdf-report` / `html-report`, which only works after installing defaults into Pandoc's user data dir and fails by default outside that context. Updated Decision Guide and pipelines to show direct `references/defaults/*.yaml` usage from the skill directory plus explicit global-install path for by-name use. Verified direct path defaults works, by-name failure is documented, Decision Guide refs valid, 9/9 filters pass.","timestamp":1780158856677,"segment":0,"confidence":null,"asi":{"hypothesis":"Accuracy fix: defaults examples must not assume global installation; agents need clear path-vs-install semantics","bug_fixed":"`pandoc -d pdf-report` was misleading without installation","validation":"direct path works; by-name fails outside install context; docs now explain both; 9/9 filters","changed_file":"SKILL.md"}}