File Manager Rewrite: Python to TypeScript with Markit SDK

Decision

Complete rewrite of files.arjtech.in from Python/aiohttp to TypeScript/Node 22 + Hono + Markit SDK (markit-ai@0.3.0) with Gemini 2.5 Pro for AI image description and audio/video transcription. Every uploaded file auto-converts to markdown.

Rationale

Current Python extractor handled only 4 formats (XLSX, DOCX, PPTX, ZIP) with basic quality. Markit SDK provides 20+ format support with table detection, column detection, heading hierarchy. Full TypeScript rewrite chosen over sidecar or CLI approach for zero impedance mismatch and maximum integration quality.

Alternatives Rejected

A) Sidecar Node container calling Markit via HTTP — rejected: added network complexity. B) Shell out to markit CLI from Python — rejected: mixed runtimes, subprocess overhead. C) Full rewrite (chosen) — single runtime, native SDK, maximum quality.

Outcome

Pending