Jason Stedwell
46e4b18a00
- docs/history/echo-improvements-prompt.md (ROADMAP-2.0 §5 box ticked) - README repository layout brought to 1.5.1 reality: root docs (CHANGELOG/TODO-1.6/ROADMAP-2.0/docs/history), build.py + dist/ (gitignored, secret-bearing), current eval harness contents, hooks/, and the full scripts/ roster (recall/reflect/triage/queue/ concurrency/quality/output/doctor/hook modules) with the legacy commands/ dir annotated as the TODO-1.6 migration target. Also restores the eval-descriptor fix lost in the prior commit (edit was applied in memory but never written back). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
96 lines
4.9 KiB
Markdown
96 lines
4.9 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) — ✅ 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.
|
||
|
||
- [x] 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`.
|
||
- [x] 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
|
||
|
||
- [x] 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).
|
||
- [x] `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.
|