Build / validate (pull_request) Successful in 5m33s

Details

docs: task-sweep end state — wiki-links explanation + changelog fragments

Docs-first commit for the feature/task-sweep branch, which addresses the
bulk of the outstanding Hephaestus-project tasks in one sweep. The
fragments describe the intended end state; code follows.

Also delivers the "understand heph link wiki semantics" task outright:
the new [[wiki-links]] explanation card documents body-vs-links-table
layering, the manual-wiki-link reconciliation footgun, resolution tiers,
and per-client surfaces.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-06-09 10:33:59 -07:00

690 B

Raw Blame History

title

modified

Explanation

Background context and design decisions.

design — Hephaestus design document: vision, data model, architecture, sync, and roadmap
task-lifecycle — the two-axis task model (lifecycle state × attention), drop vs delete, and where each task shows up
hub-spoke-data-evolution — why op-based sync lets most new features skip migrations, and when a coordinated SQLite migration is actually required
wiki-links — wiki-link semantics: body text vs the links table, heph link add … wiki caveats, resolution tiers, expand/collapse projection, and per-client surfaces

690 B Raw Blame History Unescape Escape

Explanation

690 B

Raw Blame History