4 Commits

Author SHA1 Message Date
Jason Stedwell 446cd9a0ff 2.1.0 — quick-wins train: brief load, offline-durable capture, session-end verb
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>
2026-07-28 22:34:42 -05:00
Jason Stedwell e7d86e14da Add post-1.5.1 planning docs: 9 improvement plans + containerized MCP server spec
docs/IMPROVEMENT-PLANS.md — nine improvements from the 2026-07-28 full-code
review (brief load, offline capture durability, session-end verb, local-first
recall index, incremental sweep, lifecycle decay, supersession, stemming +
alias expansion, resolve-miss learning), sequenced with TODO-1.6 and
ROADMAP-2.0 into one release train (1.6.0 -> 1.6.x -> 2.0 -> 2.1 -> 2.2 -> 2.3).

docs/MCP-SERVER-SPEC.md — build spec for the 2.1 flagship: echo-mcp as a
Docker container on ALPHA (FastMCP, streamable HTTP, bearer auth, published
as echomcp.alwisp.com), talking to Obsidian directly at http://10.2.0.35:27123.
13 v1 tools with result budgets + tool profiles; v1.1 dividends (nightly vault
backup, shadow write history/undo, background sweeps, ops alerting, rollup
data). Prereqs: session-end verb + return-not-print refactor (Phase 0).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-28 21:49:53 -05:00
Jason Stedwell d27db4ae34 Add docs/USAGE.md — operator usage guide for returning users (0.7 -> 1.5.1)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-15 15:56:28 -05:00
Jason Stedwell 46e4b18a00 Move field report to docs/history; refresh README repository layout
- 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>
2026-07-03 13:32:07 -05:00