--- title: Changelog & Release History description: Comprehensive release history, feature additions, fixes, and architectural upgrades for VertiWiki. tags: [vertiwiki, changelog, releases, history, updates] --- # Changelog > For the complete documentation index and agent navigation, see [llms.txt](/llms.txt). ## VertiWiki 0.10.0 "Γ‰pure" (September 2026) :badge[Latest]{type=success} ### πŸ›οΈ Complete Engine Stabilization, Security Hardening & Zero-Conflict Clean Architecture * **Landmark Milestone Codename ("Γ‰pure")**: Named in the French architectural and Enlightenment tradition of *l'Γ©pure*β€”a master drawing where all superfluous decoration and impurities are stripped away to reveal essential, crystal-clear structure and uncompromising elegance. * **100% Unambiguous MIT Licensing**: Completely eliminated conflicting legacy GPLv3 files (`LICENSE.txt`, `GPLv3.txt`) and outdated badges, establishing 100% clean, unencumbered MIT open-source licensing across the engine, scripts, and distribution packages. * **Strict TypeScript Type Safety (`package.json`, `src/`)**: Resolved all dormant compiler type errors in `parser.ts` and `layout.ts`, added `rawMarkdown?: string` to `PluginContext`, aligned `RenderContext` to `VertiWikiConfig`, and integrated `"typecheck": "tsc --noEmit"` into development scripts. * **Native Cross-Platform Single-File Build (`vite.config.ts`)**: Upgraded Vite bundle completion lifecycle to natively write both `dist/index.html` and `dist/vertiwiki.html` directly during `closeBundle()`, removing OS-dependent shell copy commands (`cp`) and guaranteeing seamless builds across Windows, macOS, and Linux. * **Production Zero-404 Favicon Fallback (`src/core/favicon.ts`)**: Reordered candidate resolution to prioritize production paths (`assets/favicon.ico`, `assets/favicon.svg`, `favicon.ico`) before demo development fallbacks, eliminating spurious 404 console errors on clean deployments. * **Iframe Sandboxing & Presentation Protocol (`src/core/parser.ts`)**: Hardened raw iframe Markdown embedding by enforcing a secure default sandbox (`sandbox="allow-scripts allow-same-origin allow-popups allow-forms allow-presentation"`) while preventing top-window hijacking/frame busting and allowing user custom sandboxes. * **Dangerous URI Scheme Neutralization (`src/core/router.ts`)**: Neutralized dangerous `javascript:` and `vbscript:` schemes on anchor tags to prevent DOM execution. * **Lightbox Anchor Protection (`src/plugins/lightbox.ts`)**: Updated image zoom handler to skip images inside anchor links (`:not(a img)`), preserving intended navigation on linked banners and badges. * **Dynamic i18n & Parsing Refinements**: Enabled dynamic locale detection in Schema.org JSON-LD AEO graphs (`inLanguage`), expanded wikilink relative path traversal with configured locales, tightened KaTeX inline math delimiters (`$`) to avoid capturing currency values, and prevented code-fence wrapper collisions with math blocks. * **Automated Unit Test Suite (`tests/security.test.ts`)**: Added comprehensive tests for iframe sandboxing, URI neutralization, and type verification, expanding the test suite to 19 test files and 110 passed unit tests. --- ## VertiWiki 0.9.3 (September 2026) ### πŸ› Deterministic Subfolder Resource Resolution & Deployment Trailing Slash Hardening - **Deterministic Subfolder Resource Resolution (`src/core/router.ts`)**: Introduced `getBaseDirectory()` and `resolveResourceUrl()`, guaranteeing that all relative resource requests (`config.json`, `navigation.md`, page Markdown, themes, custom CSS, favicon, and Markdown images) resolve accurately against the subfolder base directory (e.g. `/docs/`) regardless of whether the URL was opened with or without a trailing slash (`/docs#/guide.md` vs `/docs/#/guide.md`). - **Universal Lifecycle Integration (`src/main.ts`, `src/core/config.ts`, `src/ui/layout.ts`, `src/plugins/search.ts`, `src/plugins/sitemap.ts`, `src/core/favicon.ts`)**: Bound `resolveResourceUrl` across all resource fetching layers, eliminating soft 404s and broken Markdown requests on subfolder instances. - **Vercel Trailing Slash Enforcement (`deploy/vercel/vercel.json`, `deploy/README.md`)**: Configured `"trailingSlash": true` to prevent edge CDN 308 redirects from stripping directory slashes and corrupting browser address bars. - **Unit Test Coverage (`tests/router-i18n.test.ts`)**: Added automated test coverage for `getBaseDirectory()` and `resolveResourceUrl()`, expanding the test suite to 19 files and 108 passed unit tests. --- ## VertiWiki 0.9.2 (September 2026) ### πŸ› Mermaid Diagram Labels & Agent-Friendly Docs (AFDocs) Modernization - **Mermaid `` Label Preservation (`src/plugins/mermaid.ts`)**: Upgraded DOMPurify sanitization profile in `mermaidPlugin` to explicitly allow `foreignObject`, `style`, and HTML integration points, resolving an issue where diagram node texts and labels were stripped out during sanitization while preserving complete zero-XSS security. - **AI Agent Directive UI Suppression (`src/ui/styles/main.css`)**: Implemented modern CSS `:has(a[href*="llms.txt"])` rule to automatically hide in-markdown `llms.txt` directives from human browser viewports while keeping them 100% visible to autonomous AI coding agents and `afdocs` crawlers. - **AFDocs Universal Config (`agent-docs.config.yml`)**: Added standard Agent-Friendly Documentation Specification config with `urlPathPattern: md` for seamless native Markdown auditing. - **Vercel Content Negotiation Matching (`deploy/vercel/vercel.json`)**: Corrected regex escaping on `Accept: text/markdown` headers to guarantee instant Markdown content negotiation delivery on root `/docs` and subfolder hits. - **Automated Testing (`tests/mermaid.test.ts`)**: Added unit test coverage verifying `foreignObject` and HTML label preservation in Mermaid SVGs, bringing the test suite to 19 files and 106 passed tests. --- ## VertiWiki 0.9.1 (September 2026) ### πŸ› Subfolder & Localized Wikilink Relative Path Resolution - **Relative Path Resolution (`src/plugins/wikilinks.ts`)**: Enhanced `wikilinksPlugin` to compute relative directory traversal paths (`../`) based on `context.filePath`, resolving target files accurately when wikilinks are invoked from subdirectories (`configuration/`, `concepts/`, `guides/`, `reference/`). - **Locale Preservation**: Automatically preserves language context (`ro/`, `fr/`) so that wikilinks within localized subfolders resolve strictly within their active language directory. - **Unit Test Coverage (`tests/plugins-markup.test.ts`)**: Added automated Vitest coverage verifying subfolder and localized wikilink transformations, expanding the suite to 19 test files and 105 passed tests. --- ## VertiWiki 0.9.0 "Ichi" (September 2026) ### πŸ›οΈ Modular Layout Engine, Decoupled Presets & Standalone Pro Themes - **Extensible Layout Engine (`data-layout`)**: Introduced modular layout modes (`default`, `book`, `handbook`, `api`, `hub`) toggled declaratively via `config.json` or per-page Frontmatter (`layout: book`, `layout: api`), fully powered by modern CSS Grid and Flexbox with zero runtime JavaScript bloat. - **Reading Ergonomics for Non-Technical Docs (`contentWidth: "readable"`)**: Added an editorial reading mode limiting prose width to 68ch with relaxed line-height (1.8), optimized for employee handbooks, onboarding guides, academic essays, and digital books. - **Developer UI Toggles (`enableAiCopy: false`)**: Enabled clean suppression of developer-specific UI actions (such as "Copy for AI") for non-technical audiences (HR, company wikis, customer support manuals). - **Header Navigation Links (`headerLinks`)**: Added configuration support for custom links and call-to-action buttons in the top navbar (`.verti-header-right`), facilitating seamless white-labeling and integration with SaaS platforms. - **Synchronized Code & Content Tabs**: Switching a tab (e.g. `cURL`, `Python`, or OS platforms) now automatically synchronizes all matching tabs across the page and saves user preferences to `localStorage`. - **Core Theme Decoupling**: Streamlined the bundled theme engine to a single canonical **`default` (Modern Monochrome & Slate)** preset, and decoupled former presets (`terracotta`, `emerald`, `nord`, `dracula`, `amethyst`, `editorial`) into standalone, auto-resolving JSON files in `themes/`. - **Standalone Commercial Pro Themes (`pro-themes/`)**: - `company-handbook`: Tailored for employee onboarding, company policies, and SOPs with pastel callouts and checklist styling. - `minimal-book`: Literary, distraction-free reading theme with Lora serif typography and book chapter dividers. - `api-pro`: 3-column sticky split layout with HTTP method badges and compact parameter tables. - `developer-hub`: Enterprise developer portal layout with Bento-grid card sections and glassmorphism navbar. --- ## VertiWiki 0.8.4 (September 2026) ### πŸ”„ Universal Human Reader Redirection & Content Negotiation Engine - **Defensive Engine Fetching (`src/main.ts`)**: Enforced explicit `Accept: text/markdown, text/plain, */*` headers across all internal engine fetch operations (`fetchMarkdownResource`, localized navigation manifest loader, and 404 handler). Completely shields the single-file application against browser document navigation header pollution, eliminating server redirect loops. - **Production-Ready Vercel Recipe (`deploy/vercel/vercel.json`)**: Added human browser redirection (`Accept: text/html`) routing direct `.md` hits and clean URLs into VertiWiki hash routes (`/#/...`), while preserving raw Markdown content delivery for AI agents (`Accept: text/markdown`) and genuine HTTP 404 status codes. Set `trailingSlash: false` for strict documentation path stability. - **Universal Multi-Cloud Modernization (`deploy/`)**: Upgraded deployment recipes across Netlify (`netlify.toml`), Cloudflare Pages (`worker-snippet.js`), Nginx (`vertiwiki.conf`), Apache (`.htaccess`), and AWS CloudFront Function (`cloudfront-function.js`) to provide simultaneous human reader redirection and autonomous AI agent Content Negotiation. - **Documentation & Deployment Recipes (`deploy/README.md`, `sitemap-seo.md`)**: Expanded official deployment guides with detailed Root (Scenario A) and Subfolder `/docs/` (Scenario B) configurations, and updated the SEO/AEO sitemap guide with Vercel deployment instructions. --- ## VertiWiki 0.8.3 (September 2026) ### 🎨 Theme-Harmonized Code Cards & UI Background Fixes - **Theme-Adaptive Code Block Cards**: Eliminated legacy hardcoded `#2d2d2d` background on code wrappers. Code cards now dynamically inherit `--verti-code-bg` (`--muted`), rendering crisp, light-themed cards on Light Mode and tailored dark-tinted cards on Dark Mode matching the active theme. - **High-Contrast Syntax Highlighting Tokens**: Introduced dual-mode Prism syntax highlighting tokens offering >7:1 WCAG AAA contrast ratios on Light Mode and vibrant pastel palettes on Dark Mode. - **Critical CSS Body Background Remediation**: Scoped critical skeleton styles strictly to `.verti-loading-shell` and removed global `html, body` background overrides. Explicitly declared `background-color: var(--verti-bg-base)` across `body`, `.verti-main-container`, `.verti-content-wrapper`, and `.verti-toc-sidebar` to ensure 100% full-screen theme consistency on all presets. --- ## VertiWiki 0.8.2 (September 2026) ### πŸ€– AgentDocsSpec (AFDocs) Compliance & AI Agent Directives - **In-Page AI Agent Discovery Directive**: Updated static (`index.html`) and runtime (`src/plugins/aeo.ts`) agent discovery directives (`.verti-agent-directive`) to strictly conform with AgentDocsSpec regex requirements (`/llms.txt`), guaranteeing instantaneous index discovery by AI crawlers and automated scoring tools. - **Deployment Templates Content Negotiation**: Enhanced server deployment configurations (`deploy/vercel/vercel.json`, `deploy/cloudflare/worker-snippet.js`) with explicit directory handling for `/docs` and `/docs/` when clients request `Accept: text/markdown`, routing directly to `/docs/index.md`. - **AEO Unit Test Suite**: Added automated test coverage in `tests/aeo.test.ts` validating HTML directive compliance against AgentDocsSpec `LINK_PATTERN` and `TEXT_PATTERN` regexes. --- ## VertiWiki 0.8.0 (September 2026) ### 🌳 Static Bot Crawl Tree & Search Engine Indexing Architecture - **Static Bot Crawl Tree Engine (`src/core/crawl-tree.ts`)**: Built-in semantic HTML tree generator (`