The undo substrate. The agent is going to act freely — "empty the garlic bed and plant cucumbers" runs without a confirmation prompt — and that is only a defensible default if the result is easy to roll back. So undo lands before the agent write path, not after it. The unit of undo is the OPERATION, not the row. A change set groups the row-level revisions it produced; revert replays their inverses. Emptying a bed and replanting it touches one object and many plantings, and undoing half of that is worse than useless. Two properties shape the rest: Revert is itself a change set (reverts_id names its target), so history is append-only and an undo can be undone. git revert, not git reset. Revert is version-guarded per entity. Every snapshot carries the row's version; if something edited that row after the change set being reverted, restoring the old snapshot would silently discard the newer edit, so it is reported as a conflict and left alone while the rest of the change set still reverts. The auto-scope is what keeps this invasive but shallow. Service mutations call record(), which joins the change set on the context if one is open and otherwise opens a single-op one on the spot. REST handlers needed no edits at all and every UI mutation lands in history for free; only the agent wraps a whole turn. Multi-row operations (FillRegion, ClearObject) pass all their changes in one record call, so a 12-plop fill is one change set with 12 revisions and one undo. Revisions are buffered and written with their change set in a single transaction, so an operation that fails partway leaves no half-recorded history. Recording is best-effort after the fact: the row is already written, so failing the caller there would report a failure that didn't happen and invite a duplicate retry. A gap is logged loudly instead. Two sharp edges handled explicitly rather than by luck: Deleting an object cascades its plantings away at the FK level, where the service never sees them. deleteObjectRecording snapshots them first, or the delete would be listed in history and not actually be undoable. Restoring deleted rows reuses their ids, and a restored plop needs its object back first. planRevert runs three explicit passes — restore parents then children, then updates, then delete created children before their parents — instead of trusting reverse-seq ordering to happen to be right. Garden deletion stays out of scope, as designed: the cascade is invisible to the service and ON DELETE CASCADE would take the history with it. The history UI will say so rather than pretend otherwise. Closes #48 Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]> Claude-Session: https://claude.ai/code/session_01H3zbym8Doka2d7D48maSgZ
157 lines
5.9 KiB
Go
157 lines
5.9 KiB
Go
package api
|
|
|
|
import (
|
|
"net/http"
|
|
"strconv"
|
|
"testing"
|
|
)
|
|
|
|
func historyPath(gardenID int64) string {
|
|
return "/api/v1/gardens/" + strconv.FormatInt(gardenID, 10) + "/history"
|
|
}
|
|
|
|
func revertPath(changeSetID int64) string {
|
|
return "/api/v1/change-sets/" + strconv.FormatInt(changeSetID, 10) + "/revert"
|
|
}
|
|
|
|
// TestHistoryAndRevertAPI walks the whole loop over HTTP: a mutation shows up in
|
|
// history without anyone asking for it, reverting it answers 201 with the new
|
|
// change set, and the change is actually gone from /full.
|
|
func TestHistoryAndRevertAPI(t *testing.T) {
|
|
r := authEngine(t, localCfg())
|
|
cookie := registerAndCookie(t, r, "[email protected]")
|
|
gid := createGardenAPI(t, r, cookie, "G")
|
|
|
|
w := doJSON(t, r, http.MethodPost, objectsPath(gid), map[string]any{
|
|
"kind": "bed", "name": "North Bed", "xCm": 100, "yCm": 100, "widthCm": 100, "heightCm": 100,
|
|
}, cookie)
|
|
if w.Code != http.StatusCreated {
|
|
t.Fatalf("create object: status %d, body %s", w.Code, w.Body.String())
|
|
}
|
|
objectID := int64(decodeMap(t, w.Body.Bytes())["id"].(float64))
|
|
|
|
// The create landed in history with no explicit change set anywhere.
|
|
w = doJSON(t, r, http.MethodGet, historyPath(gid), nil, cookie)
|
|
if w.Code != http.StatusOK {
|
|
t.Fatalf("history: status %d, body %s", w.Code, w.Body.String())
|
|
}
|
|
body := decodeMap(t, w.Body.Bytes())
|
|
sets, _ := body["changeSets"].([]any)
|
|
if len(sets) != 1 {
|
|
t.Fatalf("got %d change sets, want 1: %s", len(sets), w.Body.String())
|
|
}
|
|
if body["hasMore"].(bool) {
|
|
t.Error("hasMore should be false for a single-entry history")
|
|
}
|
|
entry := sets[0].(map[string]any)
|
|
if entry["summary"] != "Added North Bed" {
|
|
t.Errorf("summary = %v", entry["summary"])
|
|
}
|
|
if entry["source"] != "ui" || entry["actorName"] == "" {
|
|
t.Errorf("unexpected entry: %+v", entry)
|
|
}
|
|
counts, _ := entry["counts"].([]any)
|
|
if len(counts) != 1 {
|
|
t.Fatalf("counts = %+v", entry["counts"])
|
|
}
|
|
|
|
// Revert it: 201, and the new change set points back at the original.
|
|
csID := int64(entry["id"].(float64))
|
|
w = doJSON(t, r, http.MethodPost, revertPath(csID), nil, cookie)
|
|
if w.Code != http.StatusCreated {
|
|
t.Fatalf("revert: status %d, body %s", w.Code, w.Body.String())
|
|
}
|
|
rev := decodeMap(t, w.Body.Bytes())
|
|
cs := rev["changeSet"].(map[string]any)
|
|
if int64(cs["revertsId"].(float64)) != csID {
|
|
t.Errorf("revertsId = %v, want %d", cs["revertsId"], csID)
|
|
}
|
|
if conflicts, _ := rev["conflicts"].([]any); len(conflicts) != 0 {
|
|
t.Errorf("unexpected conflicts: %+v", conflicts)
|
|
}
|
|
|
|
// The object is gone from the editor payload.
|
|
w = doJSON(t, r, http.MethodGet, fullPath(gid), nil, cookie)
|
|
full := decodeMap(t, w.Body.Bytes())
|
|
if objects, _ := full["objects"].([]any); len(objects) != 0 {
|
|
t.Errorf("%d objects survived the revert", len(objects))
|
|
}
|
|
_ = objectID
|
|
}
|
|
|
|
// TestRevertConflictAPI: a partial revert answers 409 and names what it skipped,
|
|
// because "2 of 3 undone, the north bed was edited since" is the only useful
|
|
// thing to say — a bare failure would be a lie about what happened.
|
|
func TestRevertConflictAPI(t *testing.T) {
|
|
r := authEngine(t, localCfg())
|
|
cookie := registerAndCookie(t, r, "[email protected]")
|
|
gid := createGardenAPI(t, r, cookie, "G")
|
|
|
|
w := doJSON(t, r, http.MethodPost, objectsPath(gid), map[string]any{
|
|
"kind": "bed", "name": "Bed", "xCm": 100, "yCm": 100, "widthCm": 100, "heightCm": 100,
|
|
}, cookie)
|
|
obj := decodeMap(t, w.Body.Bytes())
|
|
objectID := int64(obj["id"].(float64))
|
|
version := int64(obj["version"].(float64))
|
|
|
|
// Move it (change set #2), then edit it again (change set #3).
|
|
w = doJSON(t, r, http.MethodPatch, objectPath(objectID), map[string]any{
|
|
"xCm": 300, "version": version,
|
|
}, cookie)
|
|
if w.Code != http.StatusOK {
|
|
t.Fatalf("move: status %d, body %s", w.Code, w.Body.String())
|
|
}
|
|
version = int64(decodeMap(t, w.Body.Bytes())["version"].(float64))
|
|
w = doJSON(t, r, http.MethodPatch, objectPath(objectID), map[string]any{
|
|
"name": "Renamed", "version": version,
|
|
}, cookie)
|
|
if w.Code != http.StatusOK {
|
|
t.Fatalf("rename: status %d, body %s", w.Code, w.Body.String())
|
|
}
|
|
|
|
// Undoing the move now conflicts: the row changed after it.
|
|
w = doJSON(t, r, http.MethodGet, historyPath(gid), nil, cookie)
|
|
sets := decodeMap(t, w.Body.Bytes())["changeSets"].([]any)
|
|
moveID := int64(sets[1].(map[string]any)["id"].(float64)) // newest first: rename, move, create
|
|
|
|
w = doJSON(t, r, http.MethodPost, revertPath(moveID), nil, cookie)
|
|
if w.Code != http.StatusConflict {
|
|
t.Fatalf("revert: status %d, want 409, body %s", w.Code, w.Body.String())
|
|
}
|
|
conflicts := decodeMap(t, w.Body.Bytes())["conflicts"].([]any)
|
|
if len(conflicts) != 1 {
|
|
t.Fatalf("conflicts = %+v", conflicts)
|
|
}
|
|
c := conflicts[0].(map[string]any)
|
|
if c["reason"] != "changed" || c["name"] != "Renamed" {
|
|
t.Errorf("conflict = %+v", c)
|
|
}
|
|
|
|
// The object was left exactly alone.
|
|
w = doJSON(t, r, http.MethodGet, fullPath(gid), nil, cookie)
|
|
objects := decodeMap(t, w.Body.Bytes())["objects"].([]any)
|
|
o := objects[0].(map[string]any)
|
|
if o["xCm"].(float64) != 300 || o["name"] != "Renamed" {
|
|
t.Errorf("conflicted object was modified: %+v", o)
|
|
}
|
|
}
|
|
|
|
// TestHistoryRequiresAccess — an unauthenticated caller can't read history, and a
|
|
// stranger gets 404 rather than a hint that the garden exists.
|
|
func TestHistoryRequiresAccess(t *testing.T) {
|
|
r := authEngine(t, localCfg())
|
|
owner := registerAndCookie(t, r, "[email protected]")
|
|
gid := createGardenAPI(t, r, owner, "G")
|
|
stranger := registerAndCookie(t, r, "[email protected]")
|
|
|
|
if w := doJSON(t, r, http.MethodGet, historyPath(gid), nil, nil); w.Code != http.StatusUnauthorized {
|
|
t.Errorf("anonymous history status = %d, want 401", w.Code)
|
|
}
|
|
if w := doJSON(t, r, http.MethodGet, historyPath(gid), nil, stranger); w.Code != http.StatusNotFound {
|
|
t.Errorf("stranger history status = %d, want 404", w.Code)
|
|
}
|
|
if w := doJSON(t, r, http.MethodPost, revertPath(1), nil, stranger); w.Code != http.StatusNotFound {
|
|
t.Errorf("stranger revert status = %d, want 404", w.Code)
|
|
}
|
|
}
|