<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xsl" href="atom.xsl"?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>https://artk0de.github.io/TeaRAGs-MCP/blog</id>
    <title>TeaRAGs Blog</title>
    <updated>2026-08-19T00:00:00.000Z</updated>
    <generator>https://github.com/jpmonette/feed</generator>
    <link rel="alternate" href="https://artk0de.github.io/TeaRAGs-MCP/blog"/>
    <subtitle>Engineering notes on trajectory-enriched code retrieval</subtitle>
    <icon>https://artk0de.github.io/TeaRAGs-MCP/img/favicon.ico</icon>
    <rights>Copyright © 2026 TeaRAGs contributors.</rights>
    <entry>
        <title type="html"><![CDATA[Why this blog exists]]></title>
        <id>https://artk0de.github.io/TeaRAGs-MCP/blog/why-this-blog-exists</id>
        <link href="https://artk0de.github.io/TeaRAGs-MCP/blog/why-this-blog-exists"/>
        <updated>2026-08-19T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[The changelog tells you what shipped. It does not tell you why a]]></summary>
        <content type="html"><![CDATA[<p>The <a class="" href="https://artk0de.github.io/TeaRAGs-MCP/changelog">changelog</a> tells you what shipped. It does not tell you why a
ranking signal was added, which three hypotheses died before the fourth one
held, or what the numbers looked like before and after. That is what this blog
is for.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="what-goes-here">What goes here<a href="https://artk0de.github.io/TeaRAGs-MCP/blog/why-this-blog-exists#what-goes-here" class="hash-link" aria-label="Direct link to What goes here" title="Direct link to What goes here" translate="no">​</a></h2>
<p>TeaRAGs is an MCP server for code search that enriches every retrieved chunk
with git history — authorship, churn, bug-fix rate, ownership — so an agent
ranks stable, owned code above whatever merely looks similar. Most of the
interesting work behind that sentence is invisible in a release note:</p>
<ul>
<li class=""><strong>Retrieval</strong> — why a rerank preset weights the signals it does, and what
happens to result quality when the weights are wrong.</li>
<li class=""><strong>Codegraph</strong> — symbol resolution against real corpora, where the resolver
chain gives up, and what the residual gap actually consists of.</li>
<li class=""><strong>Performance</strong> — indexing throughput, profiling runs, measured wins and the
optimizations that turned out to be noise.</li>
<li class=""><strong>Agents</strong> — how a coding agent consumes this data, and where the tooling
still hands it the wrong thing.</li>
</ul>
<p>Posts here are measurement-first. A claim about ranking or throughput arrives
with the corpus it was measured on and the number it moved.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="where-the-rest-lives">Where the rest lives<a href="https://artk0de.github.io/TeaRAGs-MCP/blog/why-this-blog-exists#where-the-rest-lives" class="hash-link" aria-label="Direct link to Where the rest lives" title="Direct link to Where the rest lives" translate="no">​</a></h2>
<ul>
<li class=""><a class="" href="https://artk0de.github.io/TeaRAGs-MCP/">Documentation</a> — installation, tools, configuration, architecture.</li>
<li class=""><a class="" href="https://artk0de.github.io/TeaRAGs-MCP/changelog">Changelog</a> — every released version, generated from commits.</li>
<li class=""><a href="https://github.com/artk0de/TeaRAGs-MCP" target="_blank" rel="noopener noreferrer" class="">GitHub</a> — source, issues, releases.</li>
</ul>
<p>The blog has an <a href="https://artk0de.github.io/TeaRAGs-MCP/blog/rss.xml" target="_blank" rel="noopener noreferrer" class="">RSS feed</a>
and an <a href="https://artk0de.github.io/TeaRAGs-MCP/blog/atom.xml" target="_blank" rel="noopener noreferrer" class="">Atom feed</a> if you
would rather not check back.</p>]]></content>
        <author>
            <name>artk0de</name>
            <uri>https://github.com/artk0de</uri>
        </author>
        <category label="Retrieval" term="Retrieval"/>
        <category label="Agents" term="Agents"/>
    </entry>
</feed>