Found at 2.2.0 deploy: the Connect flow attempts Dynamic Client Registration and
offers no custom-header option. Minimal single-user OAuth layer queued as 2.2.x
backlog next to the nightly vault backup. Claude Code / desktop / CoWork header
auth unaffected.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
ECHO as 14 typed MCP tools (streamable HTTP, stateless JSON, bearer auth, open
/health) wrapping the 2.1.1 *_op cores in-process:
- mcp-server/app.py: FastMCP app; duplicate gate + offline queueing surface as
DATA (merge_into/force are parameters, never blind retries); recall packs
excerpts into budget_chars by score; get_note is traversal-guarded with
section/max_chars; patch_note enriches invalid-target errors with the note's
actual headings; log_session wraps the session-end bundle (heartbeat-last);
ECHO_MCP_TOOLS=core exposes only the six daily drivers; all MCP writes
serialize in-process; startup fails fast on missing env.
- Dockerfile (legacy format — no BuildKit on the CI runner), python:3.12-slim,
healthcheck probes 127.0.0.1; .dockerignore keeps the context lean.
- .gitea/workflows/docker-build.yml: standard image build; PORT redeploy
trigger targets the echo-mcp container explicitly (repo name is echo).
- deploy.unraid.yml: br0/auto-IP, /data volume, vault adjacency
(ECHO_BASE=http://10.2.0.35:27123), secrets as SECRET: refs.
- SKILL.md: prefer the echo_* tools when the connector is present; CLI recipes
stay as the fallback. Spec header marked BUILT (tool count corrected to 14).
- eval/test_mcp_server.py: e2e over real streamable HTTP (health/auth/
initialize/tools-list + capture->gate->merge->recall->log_session); skips
cleanly when the SDK is absent. All seven suites green.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Internal refactor per docs/MCP-SERVER-SPEC.md §4; CLI output and exit codes
unchanged (wrappers reproduce them from the envelopes):
- echo_ops: capture_op/resolve_op/link_op — duplicate gate and offline queueing
are data (action: duplicate-gate + candidates; queued: true); the --json
stdout-swallow hack is deleted (helper chatter -> stderr inside the cores);
capture_op takes body_text= directly (the MCP path, no temp file).
- echo_recall.recall_op — one structured result backs prose and --json.
- echo_triage.list_op/route_op, echo_reflect.apply_op,
echo_session.session_end_op — call capture_op internally, count gate outcomes
from envelopes.
- echo.scope_show_op/scope_set_op/load_op (+ shared _load_gather), and
echo_doctor.run_op (checks as data).
New eval/test_ops_api.py asserts the contract for every core: envelope shape
AND stdout purity (a stray print would corrupt an MCP response stream). All six
suites green. The 2.2 server build now starts directly at the app layer.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Three independently useful changes (IMPROVEMENT-PLANS #1/#3/#7), no schema changes:
- load --brief: token-budgeted cold-start digest (facts full, last-10 observations,
scope+freshness, last session's key sections, agent-log lines, inbox count;
ECHO_LOAD_BUDGET ~8000 chars, lowest-priority-first trimming). SessionStart hook
injects the brief form; /echo-load keeps the full dump. All load reads (+ the
sessions listing, which also feeds the heartbeat fallback) fetched in parallel.
- Offline capture durability: a fully-offline capture queues the WHOLE op as one
semantic record; flush replays it through capture so routing/gate/aliasing re-run
against the current index; a gate stop on replay is kept + flagged
(needs_attention, surfaced by flush and load), never landed blind; update-path
and ensure_daily_log writes ride safe_request; same-args captures dedupe.
- session-end: one call, one lock — session log -> agent-log line -> reflect
proposals (gate-aware) -> optional scope set -> heartbeat LAST as the commit
marker; dry-run default; ECHO_NOW pins HHMM; validation runs before any write.
Stop hook nudge names the command and recognizes it as reflected.
- Fix: main() now catches the __main__ twin-module EchoError (via RuntimeError +
.code) so helper-module errors exit with their intended codes, not tracebacks.
+19 e2e checks; all suites green. Plans renumbered: MCP container is 2.2.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- 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>
Jason Stedwell