forked from jason/echo
Phase 5: group-voice docs, onboarding runbook, CHORUS icon — v2.0.0-rc.1
The final phase of CHORUS-PLAN.md. Code- and doc-complete for group use; rc pends live deployment at chorusapi.mpm.to. - Repo README rewritten for CHORUS: group model (schema 5), concurrency posture, configuration, baked-build onboarding, layout, testing, 2.0 version history (ECHO history referenced at the fork tag). - Operator→member voice sweep across SKILL.md (incl. the trigger description, now group-aware), all references, 8 command docs, plugin README; member preferences / semantic layer / triage guidance describe the group model. - docs/ONBOARDING.md: member runbook — vault stand-up, per-member config, bake, deliver, self-onboarding first load, norms, offboarding. - docs/USAGE.md rewritten as the member usage guide. - New icon: chorus-icon.svg + 1024/512/64 PNGs (three voices, one center). - Removed ECHO-era assets (icons, spec PDF, perf briefs); ECHO planning docs retired to docs/history/. All preserved at echo-fork-point. - eval/README documents test_multimember.py. Manifest -> 2.0.0-rc.1; rebuilt chorus-memory.plugin. Verified: routing-sync, 25/25 unit, scaffold, 5 mock e2e suites, run_eval metrics green. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,95 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user