Skip to content

Wikantik

Where information goes to live.

Architecture diagram of zero-downtime PostgreSQL and pgvector HNSW dual-index migration pipeline

Zero-Downtime Schema and pgvector Index Migrations on Live PostgreSQL

· Technology · 8 min read

How to evolve PostgreSQL tables and pgvector HNSW indexes in production without tripping lock queues, starving connection pools, or spilling graph builds to disk.

Feedback loop diagram showing Google Search Console and Umami feeding JakeMon telemetry into Wikantik and Pressroom updates

Closing the Reader Feedback Loop: Search Console, Cookieless Umami, and JakeMon

· Technology · 5 min read

How Wikantik, Pressroom, and JakeMon combine Google Search Console diagnostics with cookieless Umami telemetry to prioritize content improvements.

Diagram linking POSIX Markdown storage, BM25 plus pgvector hybrid retrieval, and dual read/admin MCP servers

The Wikantik Reader's Field Guide: How Storage, Hybrid Search, and Dual MCP Fit Together

· Technology · 4 min read

A guided tour through Wikantik's 19 engineering posts—connecting POSIX Markdown storage, BM25 + pgvector hybrid search, and dual MCP servers.

System architecture diagram illustrating structural spines and semantic triples for agent retrieval

The Anatomy of Agent-Grade Content: Semantic Triples and RAG Invariants

· Technology · 5 min read

Explore how structural spines, deterministic triples, and RAG invariants transform messy wiki prose into high-precision agentic retrieval context.

Engineering workbench with an open illuminated technical notebook connected via fiber-optic traces to modular server units

The Agentic Dogfood Loop: How Requirements Enter Through Wikantik and Exit in Code Across the Ecosystem

· Technology · 9 min read

How Wikantik serves as the living requirements and governance engine for Pressroom, Stockroom, and Jakemon through agent briefings and architectural ADRs.

Systems architecture blueprint illustrating the removal of an extracted entity knowledge graph in favor of high-density vector embeddings and a deterministic page link graph

Why We Clobbered the Knowledge Graph: Search Ranking Realities and Architecture Simplification in Wikantik

· Technology · 7 min read

Why Wikantik deleted 70,500 lines of Knowledge Graph code: empirical search ranking failure, operational latency, and the power of dense vector retrieval.

System architecture blueprint showing an AI Agent interacting via MCP Protocol through a REST API Gateway with media ingestion, responsive WebP pipelines, and CDN delivery

Designing an Agent-First Publishing Engine: Pictures by Default, Scoped API Tokens, and Native MCP in Pressroom

· Technology · 4 min read

For more than two decades, content management systems and blogging engines have been designed around a singular assumption: a human operator sits in front of a rich-text WYSIWYG editor, manually uploading photographs from a local filesystem, cropping thumbnails, and fiddling with taxonomy…

Architectural blueprint illustrating Wikantik 2.5 tiered context briefings, sandboxed diagram rendering, and markdown AST ingestion

The Evolution of Wikantik 2.5: Tiered Agent Briefings, Sandboxed Visual Architecture, and Markdown Ingestion

· Technology · 6 min read

From storage lifecycle invariants in v2.4.63 to tiered project-context briefings (ADR-0011), sandboxed PlantUML/Mermaid visual modeling, and rich Markdown ingestion.

Systems architectural roadmap schematic contrasting single-host Docker limits with a future distributed architecture featuring PgBouncer and horizontal clustering

The Unfinished Roadmap: Horizontal Scale, PgBouncer, and What Wikantik Still Needs

· Technology · 4 min read

Architectural analysis of Wikantik's single-host operating boundaries, the prerequisites for horizontal scaling with PgBouncer, and section-level Knowledge Graph reranking.

Observability dashboard illustrating MCP session sweeper thread deadlocks and token optimization in Wikantik

The Operational Reality of Agents in Production: MCP Protocol Edge Cases

· Technology · 4 min read

Production realities of Model Context Protocol: resolving non-daemon thread shutdown deadlocks in the MCP SDK, AST parsing overhead in citation generation, and frontmatter curation.

Systems engineering blueprint contrasting torn in-place file writes against hardened POSIX atomic file lifecycles

Silent Data Loss and Destructive Admin Tools: Fixing Storage Invariants

· Technology · 4 min read

Postmortem on storage durability invariants: fixing in-place file truncation, PrintWriter exception suppression, and destructive index rebuild cascades in Wikantik 2.4.62.

Database profiling dashboard contrasting cascading N+1 query waterfalls against batched constant SQL statements

Surviving the N+1 Storm: Database Profiling and Statement Pruning

· Technology · 4 min read

Tracing N+1 statement amplification in Wikantik's JDBC layer and the refactoring that collapsed thousands of round-trips into constant-time queries.

Systems postmortem telemetry dashboard illustrating the 79.7 GB Jena TDB2 storage leak and B+tree compaction fix

The 79 GB Disk Leak: Jena TDB2 B+Trees and Storage Subsystem Hardening

· Technology · 4 min read

Postmortem of an Apache Jena TDB2 disk leak: B+tree copy-on-write allocation, scheduler timer limitations, and storage subsystem repairs in Wikantik 2.4.62.

Technical diagram illustrating the modular decomposition of wikantik-main and the CI complexity ratchet

Decomposing the God Module: Package Extraction and the Complexity Ratchet

· Technology · 4 min read

Decomposing the monolithic WikiEngine core: reducing CBO coupling from 143 to 86, extracting sub-modules, and enforcing the CI complexity ratchet.

Technical architectural blueprint of Wikantik post-fork showing the tri-tier storage engine, dual MCP gateways, and React interface

Beyond the Fork: Settling the Architecture of an Agent-Grade Knowledge Base

· Technology · 4 min read

An engineering analysis of Wikantik's tri-tier storage architecture, dual MCP protocol gateways, and post-fork stabilization objectives.