Jason Stedwell
919e411136
- TODO-1.6.md: skills-format migration of the eight slash commands (allowed-tools, disable-model-invocation, de-duped $ECHO block), plugin.json homepage, vault link repoints, and an open section for findings from 1.5.x live testing. - ROADMAP-2.0.md: packaging & structure major — repo artifact policy (Gitea releases, prune versioned zips), delete legacy commands/ dir, codex-as-build-target if ever needed, eval refresh to current metrics. Includes a disposition table absorbing every open MAINTENANCE.md item, so that checklist is removed. - Delete "codex plugin/": drifted derived tree; operator decision to regenerate from the canonical source after 2.0 if Codex use returns. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.
|