Tagged
architecture
The Wikantik Reader's Field Guide: How Storage, Hybrid Search, and Dual MCP Fit Together
A guided tour through Wikantik's 19 engineering posts—connecting POSIX Markdown storage, BM25 + pgvector hybrid search, and dual MCP servers.
The Agentic Dogfood Loop: How Requirements Enter Through Wikantik and Exit in Code Across the Ecosystem
How Wikantik serves as the living requirements and governance engine for Pressroom, Stockroom, and Jakemon through agent briefings and architectural ADRs.
Why We Clobbered the Knowledge Graph: Search Ranking Realities and Architecture Simplification in Wikantik
Why Wikantik deleted 70,500 lines of Knowledge Graph code: empirical search ranking failure, operational latency, and the power of dense vector retrieval.
The Evolution of Wikantik 2.5: Tiered Agent Briefings, Sandboxed Visual Architecture, and Markdown Ingestion
From storage lifecycle invariants in v2.4.63 to tiered project-context briefings (ADR-0011), sandboxed PlantUML/Mermaid visual modeling, and rich Markdown ingestion.
The Unfinished Roadmap: Horizontal Scale, PgBouncer, and What Wikantik Still Needs
Architectural analysis of Wikantik's single-host operating boundaries, the prerequisites for horizontal scaling with PgBouncer, and section-level Knowledge Graph reranking.
The Operational Reality of Agents in Production: MCP Protocol Edge Cases
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.
Decomposing the God Module: Package Extraction and the Complexity Ratchet
Decomposing the monolithic WikiEngine core: reducing CBO coupling from 143 to 86, extracting sub-modules, and enforcing the CI complexity ratchet.
Beyond the Fork: Settling the Architecture of an Agent-Grade Knowledge Base
An engineering analysis of Wikantik's tri-tier storage architecture, dual MCP protocol gateways, and post-fork stabilization objectives.
RAG-as-a-Service and the Modern State: Context Bundling, Derived Pages, and Grounded Truth
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.
First-Class AI Citizens: Designing Dual Model Context Protocol Architectures
How Wikantik partitioned its agent interface into dual MCP servers: /knowledge-mcp for lightweight RAG retrieval and /wikantik-admin-mcp for verified writes.
Decoupling the Legacy Web Tier: The React SPA Migration and Database-Backed RBAC
How Wikantik replaced server-side JSP tag libraries with a Vite + React SPA, stateless REST endpoints, PostgreSQL RBAC, and Pac4j SSO.
From JSPWiki to Wikantik: The Jakarta EE 10 Migration
How Wikantik migrated 261 files from legacy javax.* to Jakarta EE 10, replaced Stripes test mocks with Mockito, and updated to Tomcat 10/11.