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.
• Publish versioned builds as Gitea releases on git.alwisp.com/jason/echo instead (one release per tag, artifact attached).
• .gitignore: *.plugin except the pointer.
• 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 — the packaging break that partly motivates the major bump.
• Re-verify desktop + CoWork installs of the skills-only artifact.
• Update SKILL.md / README / command docs that reference commands/.

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).

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

eval/run_eval.py still benchmarks 0.6 vs 0.7. The current-version suites (test_features et al.) prove correctness but publish no metrics.

• Refresh run_eval.py to measure the current version: retrieval precision/recall (BM25 + freshness/status fusion vs keyword baseline), duplicate rate with the gate on/off, offline-queue durability, silent-write-failure rate.
• Publish the numbers in the README (replacing the 0.6-vs-0.7 claims) and archive the old A/B harness docs as historical.

5. Repo hygiene odds & ends

• Retire ROADMAP-1.0.md (fully shipped; keep in git history, drop from the tree) once this roadmap and the README version table carry the story.
• Root README "Repository layout" section updated for the post-2.0 tree (no versioned zips, no codex tree, skills-only plugin).
• Confirm echo-improvements-prompt.md (the 1.5.0 field report) either moves to a docs/history/ folder or is deleted — its content is preserved in CHANGELOG 1.5.0 and the git history.

---

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.