Wikantik Platform Hub: Knowledge Systems, Hybrid Search, and AI Agent Integrations

Part of the Simple Agility Stack. Wikantik is the stack's semantic knowledge and content engine—an agent-grade wiki serving software architecture, operational runbooks, and domain research while doubling as the external memory and contract registry (SA-13) for autonomous coding and publishing agents. It optimizes its own corpus through Closed-Loop Content Intelligence (following Simple Agility Feedback Loop Pattern) and emits Elastic Common Schema (ECS) JSON telemetry to jakemon per Simple Agility Telemetry Contract.

New to Wikantik? Start with the About Wikantik: Manifesto & System Blueprint for the core design philosophy and three end-to-end engineering and publishing workflows.

Wikantik bridges human technical authoring and machine reasoning. Every page is stored as human-readable CommonMark Markdown with validated YAML frontmatter (FrontmatterSchema), indexed into a dual Apache Lucene BM25 + PostgreSQL 18 pgvector HNSW retrieval pipeline, mapped across Three Graphs (Page Graph, Knowledge Graph, Citation Graph) plus an Apache Jena TDB2 RDF/OWL ontology, and exposed through 51 Model Context Protocol (MCP) tools.

1. Platform Topology & Subsystem Map

flowchart TB
    subgraph Manifesto["1. Vision, Architecture & Evolution"]
        About["[[About]]<br/>Manifesto, 5 Commitments &<br/>3 Flagship Workflows"]
        Arch["[[WikantikArchitecture]]<br/>24-Module Java 25 Monolith,<br/>Three Stores & Security"]
        Evol["[[WikantikEvolutionFromJSPWiki]]<br/>March–October 2026 Evolution<br/>Through Release 2.4.56"]
        Crit["[[WikantikCritiqueAndMarketPosition]]<br/>Strengths, Trade-Offs &<br/>Competitive Matrix"]
    end

    subgraph Retrieval["2. Hybrid Search & RAG Context Bundles"]
        Search["[[WikantikSearchAndRetrieval]]<br/>Heading-Faithful Chunking,<br/>Contextual Embeddings & RRF Math"]
        Bundle["[[WikantikRagContextBundle]]<br/>GET /api/bundle & assemble_bundle<br/>Version-Pinned Citations"]
        AgentCtx["[[WikantikAgentContextGuide]]<br/>Session Briefings (get_briefing)<br/>& Coverage Escalation Ladder"]
    end

    subgraph Graphs["3. Graphs, Ontology & Closed-Loop Intelligence"]
        PGvKG["[[PageGraphVsKnowledgeGraph]]<br/>Page Graph vs. Knowledge Graph<br/>vs. Citations vs. RDF"]
        KG["[[WikantikKnowledgeGraph]]<br/>9 Classes, 21 Predicates,<br/>Mention-Centroids & SHACL Gate"]
        CI["[[ContentIntelligenceDesign]]<br/>GSC + Bing + Agent Query Logs<br/>& 28-Day DiD EffectEvaluator"]
    end

    subgraph Roadmap["4. RAG-as-a-Service Roadmap"]
        RagHub["[[RagServiceRoadmapHub]]<br/>Target Architecture, Connectors,<br/>Composable Reranking & SDKs"]
    end

    Manifesto --> Retrieval --> Graphs --> Roadmap

2. Quick-Reference: Core Platform Capabilities

3. Core Platform Articles & Architecture Guides

I. Manifesto, System Architecture & Market Position

• About Wikantik: Manifesto and Architecture of the Agent-Grade Knowledge Platform — The flagship manifesto, five architectural commitments, mathematical retrieval foundations, 51-tool MCP inventory, and three end-to-end workflows (cross-repo SA-13 briefings, self-healing runbooks, and ontology-driven publishing).
• Wikantik System Architecture — Deep reference for the 24-module Java 25 reactor, three-store persistence model (filesystem + PostgreSQL 18 + Jena TDB2), rendering pipeline, security model, and architectural critique.
• History and Evolution: From Apache JSPWiki to Wikantik 2.4.56 — How the March–October 2026 modernization transformed Apache JSPWiki across four engineering phases.
• Wikantik: Critique and Market Position — Candid assessment of strengths, operational trade-offs, and feature comparison against BookStack, Outline, Wiki.js, MediaWiki, Confluence, and Notion.

II. Hybrid Retrieval, Context Bundles & Knowledge Graph

• Wikantik Hybrid Search Architecture — Heading-faithful chunking (ContentChunker), contextual document embeddings (EmbeddingTextBuilder), BM25 + pgvector RRF equations, and retrieval mode selection.
• The Wikantik Knowledge Graph — The 9 entity classes, 21 relationship predicates, mention-centroid vector math, human/judge proposal workflow, write-time SHACL gate, and SPARQL projection.
• Page Graph vs. Knowledge Graph — Canonical boundary between editorial wikilinks (page_links), semantic entities (kg_*), section-pinned citations (citations), and the RDF ontology.
• Graph Rerank Step (Historical) — Why page-level co-mention BFS reranking measured zero net recall lift in the 2026-06-16 ceiling experiment and was deleted in 2026-07.

III. Architectural Governance & Normative Contracts

• Simple Agility Stack Hub (simple-agility) — Ecosystem architecture and cross-repo coordination.
• Simple Agility Architectural Decision Log — Normative architectural decisions (SA-1 through SA-13) governing Wikantik APIs, storage, and cross-repo boundaries.
• Simple Agility Telemetry Adoption Matrix — Stack-wide observability, OpenTelemetry, and structured JSON logging contracts.

III. Companion Hubs & RAG-as-a-Service Roadmap

• Wikantik Platform Development Hub (wikantik-development) — Developer internals, MCP protocol specifications (MCP Integration), operator runbooks (Wikantik Operations), and feature design records.
• Agent Cookbook (agent-cookbook) — Scenario-keyed runbooks for coding and curation agents working with Wikantik MCP tools and the codebase.
• RAG-as-a-Service Roadmap Hub — Target architecture (Target Architecture) and capability briefs covering Agentic Retrieval, Composable Reranking, Connector Framework, External ACL Inheritance, Multimodal Ingestion, Retrieval Evaluation & Observability, Client SDK & DX, Multi-Tenancy Posture, Compliance Posture, and Open-Core Packaging & Pricing.