Give every condition a headline, an explanation and a resolved line in plain words

The operator could not read the desktop notifications: they carried plan ids,
commits, keys and verb syntax. The words the operator reads now travel with the
condition, so every channel says them (hq ADR 0253).

cmd/mesh-controller/sayable_test.go

@@ -29,7 +29,20 @@ func TestMain(m *testing.M) {
 	conditions.Unsayable = func(o conditions.Observation, field string, r outward.Refusal) {
 		unsaid.note(o, field, r)
 	}
+	conditions.Unworded = func(o conditions.Observation, why string) {
+		if o.Source != "test" { // a kind a test makes up to exercise the keeper
+			unworded.add(o, why)
+		}
+	}
 	code := m.Run()
+	if said := unworded.all(); len(said) > 0 {
+		fmt.Fprintf(os.Stderr, "FAIL: %d condition(s) raised in these tests have no plain words of their own, or "+
+			"words that are not plain (novox/hq ADR 0253: a headline, an explanation and a resolved line the operator "+
+			"reads at a glance — plain_words.go):\n  %s\n", len(said), strings.Join(said, "\n  "))
+		if code == 0 {
+			code = 1
+		}
+	}
 	if said := unsaid.all(); len(said) > 0 {
 		fmt.Fprintf(os.Stderr, "FAIL: %d condition(s) raised in these tests say what the operator's channel withholds "+
 			"(an address, a domain, a path or a secret's shape belongs in the evidence, not the summary):\n  %s\n",
@@ -74,6 +87,34 @@ func (u *unsayable) all() []string {
 	return out
 }
 
+// unworded collects, across the suite, every finding said in borrowed words (ADR 0253).
+var unworded wordless
+
+type wordless struct {
+	mu   sync.Mutex
+	seen map[string]bool
+}
+
+func (u *wordless) add(o conditions.Observation, why string) {
+	u.mu.Lock()
+	defer u.mu.Unlock()
+	if u.seen == nil {
+		u.seen = map[string]bool{}
+	}
+	u.seen[fmt.Sprintf("kind %s (scope %s, source %s): %s", o.Kind, o.Scope, o.Source, why)] = true
+}
+
+func (u *wordless) all() []string {
+	u.mu.Lock()
+	defer u.mu.Unlock()
+	var out []string
+	for s := range u.seen {
+		out = append(out, s)
+	}
+	sort.Strings(out)
+	return out
+}
+
 // linted is a producer's findings, held to the content rule as a keeper would hold them: for a test
 // that reads a producer's findings without raising them.
 func linted(obs []conditions.Observation) []conditions.Observation {
@@ -85,6 +126,18 @@ func linted(obs []conditions.Observation) []conditions.Observation {
 		if r, ok := outward.Check(o.Summary, machines...); !ok {
 			unsaid.note(o, "summary", r)
 		}
+		switch {
+		case o.Headline != "":
+			w := conditions.Words{Headline: o.Headline, Explanation: o.Explanation, Resolved: o.Resolved}
+			if w.Resolved == "" {
+				w.Resolved = "Resolved"
+			}
+			if why, ok := conditions.PlainWords(w, machines...); !ok {
+				unworded.add(o, "its source's words are not plain: "+why)
+			}
+		case o.Kind != "" && !conditions.Worded(o.Kind):
+			unworded.add(o, "the kind "+o.Kind+" has no plain words")
+		}
 	}
 	return obs
 }