forked from jason/echo
96 lines
4.8 KiB
Markdown
96 lines
4.8 KiB
Markdown
|
# 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.
|