# memoryleaderboard

Entry for demarkus in the Agent Memory Leaderboard: a Go adapter exposing the benchmark's Add/Search HTTP contract over a per-user demarkus world, with agentic search as the submission.

## Status

PR #2 merged agentic search and PR #3 merged submission readiness. The submission route is now Academic Methods, Coding Memory, hosted Add/Search API. Public-readiness work is active on `academic-submission-readiness`: Apache-2.0 licensing, full method disclosure, public Demarkus image verification, Compose-pinned OpenAI `gpt-4o-mini`, and safe explicit-endpoint credential routing. Race tests, vet, shell checks, Compose validation, Linux image build, contract smoke, local conformance, synthetic quality, 16-worker load, and secret scans pass. Live distillation and navigation are blocked on an OpenAI API key.

## Plan

Authoritative plan: [Agent Memory Leaderboard entry](/plans/agent-memory-leaderboard.md). Search uses a scoped nib navigation agent over Demarkus lookup/list/fetch; Add uses `gpt-4o-mini` distillation while retaining raw evidence. Production is a single encrypted Linux host with Caddy TLS, adapter, private Demarkus storage, and explicit 30-day data/backup deletion. The source repository will be public and the submitted commit fixed.

Echo v5 is the Go HTTP framework used by the adapter, not an LLM provider.

## Phases

| # | Work | Output |
|---|------|--------|
| 0 | Recon: challenge repo, limits, cycle dates, route | Academic hosted API route selected |
| 1 | Adapter skeleton: Add/Search against local Demarkus | merged |
| 2 | Agentic search; catalog fallback | merged via PR #2 |
| 3 | Ingestion tuning: distillation, temporal metadata, idempotency | merged via PR #3 |
| 4 | Conformance, synthetic retrieval quality, Top-K load evaluation | local gates pass; live provider run pending |
| 5 | Public readiness, provider validation, host deploy, Smoke, Full | active; OpenAI API key needed |

## Repo

`/Users/fritz/latebit/memoryleaderboard` (github: latebit-io, branch `academic-submission-readiness`)

## Workspace

- [Agent Memory Leaderboard](/memoryleaderboard/agent-memory-leaderboard.md) official benchmark bookmark and entry links
- [Agent Memory Leaderboard entry plan](/plans/agent-memory-leaderboard.md) active roadmap
- [journal/](/memoryleaderboard/journal/) session notes
- [debugging.md](/memoryleaderboard/debugging.md) investigation lessons and portability gotchas
- Add architecture.md and patterns.md as they earn content.