Give a service's held state its own field and key, so main compiles again
mesh/merge-gate pass: builds mesh-host → ace, g14, novox, shanks; no bus step; every machine composes with the change as it did without (4 of 4 compose)
mesh/repo-check pass: its merge-check.sh passed
mesh/delivery delivered

#64/#65 and #66 each added Applied.Declared: a directory's declared owner and
mode (string) and a service's held state (*FoundUnit), both under the JSON key
"declared". The directory's is already on nodes, written by d28ca95, so it
keeps the name and key; the service's becomes DeclaredUnit, "declared_unit".
#66 never deployed, so no node holds a record under the new key.
This commit is contained in:
jochen
2026-10-09 03:03:58 +02:00
parent 690966d847
commit c2bae14994
4 changed files with 67 additions and 31 deletions
+35
View File
@@ -0,0 +1,35 @@
package store
import (
"encoding/json"
"testing"
)
// A directory used as found and a service's held state are two records that both say "declared"
// (novox/hq issue 339, ADR 0269). The directory's was on nodes first, under the key "declared", and a
// record a node already holds must keep reading back; the service's has a key of its own.
func TestADirectorysDeclaredAndAUnitsDeclaredKeepTheirOwnKeys(t *testing.T) {
onDisk := []byte(`{"id":"notes.data","type":"directory","as_found":true,"declared":"root, mode 755",` +
`"declared_unit":{"unit":"a.timer","state":"stopped","boot":"disabled"}}`)
var a Applied
if err := json.Unmarshal(onDisk, &a); err != nil {
t.Fatal(err)
}
if a.Declared != "root, mode 755" {
t.Errorf("the directory's declared owner and mode read back as %q", a.Declared)
}
if a.DeclaredUnit == nil || a.DeclaredUnit.State != "stopped" || a.DeclaredUnit.Boot != "disabled" {
t.Errorf("the unit's held state read back as %+v", a.DeclaredUnit)
}
body, err := json.Marshal(a)
if err != nil {
t.Fatal(err)
}
var keys map[string]json.RawMessage
if err := json.Unmarshal(body, &keys); err != nil {
t.Fatal(err)
}
if string(keys["declared"]) != `"root, mode 755"` || keys["declared_unit"] == nil {
t.Errorf("written as %s", body)
}
}
+3 -2
View File
@@ -99,12 +99,13 @@ type Applied struct {
// when its declaration goes; one the mesh started is stopped again. Absent on a record written
// before the host kept it, and then the unit is left exactly as it is.
Found *FoundUnit `json:"found,omitempty"`
// Declared is, for a service with a state, what the mesh last held its unit to: running or stopped,
// DeclaredUnit is, for a service with a state, what the mesh last held its unit to: running or stopped,
// and enabled or disabled where the declaration said. With Found, it tells a unit the mesh's own
// declaration stopped and disabled from one somebody stopped since, so removal gives back running
// and enabled only the first (novox/hq ADR 0269). Absent on a record from before the host kept it,
// and then nothing is started on the way out.
Declared *FoundUnit `json:"declared,omitempty"`
// Its key is not "declared": that one is a directory's (AsFound, below) and was on disk first.
DeclaredUnit *FoundUnit `json:"declared_unit,omitempty"`
// Into is set for a file written into rather than over (novox/hq ADR 0102): the format, what
// each of the mesh's keys held before it set them, which of them were absent, and whether the