From 87c76da6593e88e9474759b5e848ffdd73f825e5 Mon Sep 17 00:00:00 2001 From: Erich Blume Date: Mon, 1 Jun 2026 19:07:03 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20refresh=20resume=20state=20for=20next?= =?UTF-8?q?=20session=20(AGENTS=20structure=20+=20=C2=A714=20order)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Backend is feature-complete; point the trackers at heph.nvim as the next slice so a cold-start session resumes correctly. - AGENTS.md: update the (always-in-context) project-structure block — all three daemon modes + sync + auth are done; CLI gained search/journal/auth; heph.nvim is the next slice. Point at tech-spec §14 as the live tracker. - tech-spec §14: reorder "not yet done" so heph.nvim is #1 (the remaining build slice), with adoption refinement and the dependency-refresh sweep as non-blocking follow-ups. Co-Authored-By: Claude Opus 4.8 (1M context) --- AGENTS.md | 10 +++++----- docs/reference/tech-spec.md | 7 +++++-- 2 files changed, 10 insertions(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 687a2eb..caec98b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -41,15 +41,15 @@ See [[agent-change-process]] for the full methodology. ## Project Structure -A Cargo workspace (`Cargo.toml` at the root) plus the Neovim plugin and repo tooling. The build follows the tech-spec §11.1 slice order; crates are added to the workspace as their slice begins, so not every crate below exists yet. +A Cargo workspace (`Cargo.toml` at the root) plus the Neovim plugin and repo tooling. The build follows the tech-spec §11.1 slice order; the **Rust backend is feature-complete** (all three runtime modes + sync + OIDC auth) — the remaining v1 work is `heph.nvim`. The live progress tracker is **[[tech-spec]] §14**. ``` ./Cargo.toml # workspace manifest (shared deps + members) ./crates/heph-core/ # core lib: data model, Store trait + SQLite store, extraction, - # recurrence, "what is next?" ranking, op-log/HLC/CRDT sync -./crates/hephd/ # daemon: local mode done (JSON-RPC over unix socket + file lock); server/client modes planned -./crates/heph/ # CLI: next/task/doc/get/export (thin client of hephd); `heph conflicts` planned -./heph.nvim/ # Neovim plugin (planned): primary surface; replaces obsidian.nvim + # recurrence, "what is next?" ranking, op-log/HLC/CRDT (yrs) sync +./crates/hephd/ # daemon: local/server/client modes — unix-socket RPC + HTTP sync/rpc + OIDC auth +./crates/heph/ # CLI (thin client of hephd): next/task/doc/get/export/search/journal/auth +./heph.nvim/ # Neovim plugin (planned, next slice): primary surface; replaces obsidian.nvim ./docs/ # Diataxis docs (incl. [[design]] + [[tech-spec]]), Quartz config, release content ./docs/changelog.d/ # towncrier fragments for noteworthy changes ./.dagger/ # Dagger module (src/hephaestus_ci/) backing docs builds and releases diff --git a/docs/reference/tech-spec.md b/docs/reference/tech-spec.md index 9deae82..82f064d 100644 --- a/docs/reference/tech-spec.md +++ b/docs/reference/tech-spec.md @@ -348,8 +348,11 @@ See [[design]] §5–§7 for the constraints later phases impose on present choi **Not yet done (resume order)** -1. ⏳ **Adoption refinement + multi-tenant (§13):** local→authed **adoption** currently rewrites `owner_id` (`adopt_owner`) but not yet the owner-embedded deterministic ids (journal/tag) + their links; and the hub is single-tenant (one owner per store) — owner-per-token storage is a future extension. -2. ⏳ **`heph.nvim` (§8):** obsidian.nvim parity + task views; headless-nvim e2e (needs `neovim` + `plenary.nvim` on the CI runner). +> The Rust backend is feature-complete; `heph.nvim` is the one remaining build slice. The rest are non-blocking polish + an end-of-v1 sweep (§11). + +1. ⏳ **`heph.nvim` (§8) — the next slice, the primary surface:** obsidian.nvim parity + task/agenda views over the `hephd` unix socket; headless-nvim e2e (needs `neovim` + `plenary.nvim` on the CI runner). First non-Rust slice — likely wants its own short design pass (Lua layout, RPC client, CI runner setup) before coding. +2. ⏳ **Adoption refinement + multi-tenant (§13) — non-blocking:** local→authed **adoption** currently rewrites `owner_id` (`adopt_owner`) but not yet the owner-embedded deterministic ids (journal/tag) + their links; and the hub is single-tenant (one owner per store) — owner-per-token storage is a future extension. +3. ⏳ **Dependency-refresh pass (§11) — before declaring v1 done:** sweep all external deps to latest stable (e.g. `keyring` 3→4, which restructured to `keyring_core`), re-run the full suite. ## Related