echo/ROADMAP-2.0.md

echo-memory — Roadmap to v2.0.0

Status: draft. Current shipping version: 1.5.1. Interim work tracked in TODO-1.6.md.

2.0 thesis: a packaging & structure major. Nothing here changes what the plugin does for memory — 2.0 is the release where the repo layout, artifact policy, and plugin format are cleaned up in ways that are breaking for how the plugin is distributed and installed, so the major version signals "reinstall everything, re-clone expectations." Feature work keeps landing in 1.6.x until this is ready.

This roadmap absorbs every open item from the retired MAINTENANCE.md (M5) checklist; the mapping is noted per item.

---

1. Repo-root artifact policy (from MAINTENANCE › Build artifacts)

The repo root tracks every historical build (echo-memory-0.6.0.plugin … echo-memory-1.5.1.plugin) plus the echo-memory.plugin pointer. 2.0 changes the policy — breaking for anyone who pulls artifacts straight from the repo:

• Track only echo-memory.plugin (the current installable); delete the versioned zips from the tree — done 2.0.0 (15 zips removed; history keeps them).
• Publish versioned builds as Gitea releases on git.alwisp.com/jason/echo instead (one release per tag, artifact attached) — v2.0.0 onward.
• .gitignore: *.plugin except the pointer — done 2.0.0.
• Tag releases going forward (v2.0.0, …) so the release page is the version history for artifacts, and the README table stays the narrative history.

2. Complete the skills-format migration (finishes the 1.6 work)

1.6 migrates the eight slash commands to skills/*/SKILL.md with both formats coexisting (see TODO-1.6.md). 2.0 finishes it:

• Delete the legacy commands/ directory — done 2.0.0 (1.6.0's install verification on both surfaces cleared the gate; skills had precedence anyway).
• Re-verify desktop + CoWork installs of the skills-only artifact — verified 2026-07-28 on the baked 2.0.0 build: installs cleanly, all eight skills register and work with no legacy commands/ present.
• Update SKILL.md / README / command docs that reference commands/ — done 2.0.0.

3. Codex packaging (from MAINTENANCE › Canonical source tree)

The drifted codex plugin/ tree was deleted on 2026-07-03 (operator decision: Codex usage doesn't currently justify a maintained second build; it will be regenerated after 2.0 if needed). What remains for 2.0:

• If Codex support returns: implement it as a build target generated from the canonical echo-memory.plugin.src/ tree (build.py --target codex or similar) — never as a second hand-maintained source tree (that's how the drift happened).
• Otherwise: a short "packaging for other agent runtimes" note in the README documenting what a Codex/other-runtime port needs (manifest shape, skill entry point, script invocation) — done 2.0.0 (README › after Repository layout).

4. Eval refresh — publish current-version metrics (from MAINTENANCE › Docs freshness; ROADMAP-1.0 H4 leftover) — ✅ DONE

run_eval.py was rewritten from the stale 0.6-vs-0.7 A/B into the current-version metrics harness (retrieval / dedup / write-safety / durability); numbers published in the README. Re-run it per release and refresh the README table.

• Refresh run_eval.py to measure the current version — done 2026-07-03: retrieval P@5/R@5/MRR + session/journal answerability + freshness top-1 (vs a keyword/entities-only baseline), duplicate rate gate-on/off, silent-write-failure rate under fault injection, offline-queue durability. results/latest.json.
• Publish the numbers in the README and mark the old A/B harness historical (git history) — done 2026-07-03.

5. Repo hygiene odds & ends

• Retire ROADMAP-1.0.md (fully shipped; in git history) — done 2026-07-03.
• Root README "Repository layout" section updated for the post-2.0 tree (no versioned zips, no codex tree, skills-only plugin) — done 2.0.0.
• echo-improvements-prompt.md (the 1.5.0 field report) moved to docs/history/ — done 2026-07-03.

---

MAINTENANCE.md disposition (why it was removed)

Every item from the retired checklist is either done or absorbed above:

MAINTENANCE item	Status
Canonical tree = echo-memory.plugin.src/	Done (0.x)
codex plugin/ decide regenerate-or-delete	Deleted 2026-07-03; regenerate-as-build-target tracked in §3
Prune historical .plugin zips; gitignore policy	§1
.gitignore basics	Done (1.0)
plugin.json license + version	Done (1.0)
plugin.json homepage	TODO-1.6.md §2 (URL now decided)
Register commands in manifest	Superseded by the skills migration (TODO-1.6.md §1, finished in §2 here)
run_eval.py refresh to current metrics	§4
Secret handling (M1)	Done — superseded by echo_config in 1.3/1.4; committed tree ships zero credentials
Pre-1.0 checklist	Done/obsolete (1.0 shipped; the DEFAULT_KEY line it referenced was removed in 1.3)

Build flags (--bake-key, --strip-key, --no-pointer, --outdir) are documented in build.py's docstring and the README Configuration section.