Skip to content

Wikantik

Where information goes to live.

Tagged

architecture

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.

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.

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.

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.

Comprehensive enterprise system architecture blueprint of modern Wikantik showing RAG-as-a-Service, context bundle assembly, and agent integration

RAG-as-a-Service and the Modern State: Context Bundling, Derived Pages, and Grounded Truth

· Technology · 4 min read

How Wikantik evolved from a human wiki to an agentic RAG-as-a-Service platform featuring context bundling, Apache Tika ingestion, and zero answer synthesis.

Architectural diagram of Dual Model Context Protocol gateways: read-only knowledge-mcp for RAG and privileged wikantik-admin-mcp for agent orchestration

First-Class AI Citizens: Designing Dual Model Context Protocol Architectures

· Technology · 4 min read

How Wikantik partitioned its agent interface into dual MCP servers: /knowledge-mcp for lightweight RAG retrieval and /wikantik-admin-mcp for verified writes.

Architectural blueprint showing the decoupling of legacy JSP monolithic rendering into a modern React SPA and REST API gateway

Decoupling the Legacy Web Tier: The React SPA Migration and Database-Backed RBAC

· Technology · 4 min read

How Wikantik replaced server-side JSP tag libraries with a Vite + React SPA, stateless REST endpoints, PostgreSQL RBAC, and Pac4j SSO.

Enterprise Java architecture transitioning from monolithic legacy systems to modern Jakarta EE modular design

From JSPWiki to Wikantik: The Jakarta EE 10 Migration

· Technology · 4 min read

How Wikantik migrated 261 files from legacy javax.* to Jakarta EE 10, replaced Stripes test mocks with Mockito, and updated to Tomcat 10/11.