jschoubben
0dc0cf9c9a
The window opens while a counted node-engine reads, of some kind, none of the newest form sdk/forms knows, and closes when none does: said once as version.old-form-closed, and a node holding it seven days is old-form-held about it. It steps on a statement's change, the placement, a hand drop and each build key written, never on a timer. A retired node dropped by hand leaves the count of the forms a build key keeps (design 51). internal/versions' own Forms goes: which forms a key keeps is sdk/forms'. Claude-Session: https://claude.ai/code/session_01JG73KJNrH5EgFXMKKYSrig
188 lines
8.1 KiB
Go
188 lines
8.1 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"errors"
|
|
"fmt"
|
|
"strings"
|
|
"time"
|
|
|
|
"git.novox.be/novox/mesh-sdk/go/buscompose"
|
|
"git.novox.be/novox/mesh-sdk/go/delivery"
|
|
"git.novox.be/novox/mesh-sdk/go/process"
|
|
"github.com/nats-io/nats.go"
|
|
"github.com/nats-io/nats.go/jetstream"
|
|
|
|
"mesh-delivery-builder/internal/build"
|
|
"mesh-delivery-builder/internal/versions"
|
|
)
|
|
|
|
// askAgainer is the part of the builder a reasks value asks through.
|
|
type askAgainer interface {
|
|
AskAgain(key, why string) []string
|
|
BuildAgain(ctx context.Context, module, fp, why, by string, bound time.Duration) build.BuildAgainResult
|
|
AnnounceAgain(ctx context.Context, module, fp, why, by string) build.BuildAgainResult
|
|
}
|
|
|
|
// buildAgainBound is how long the builder waits for the claim and the asks of a key built again by hand; the tool waits
|
|
// longer for the builder's answer.
|
|
const buildAgainBound = 15 * time.Second
|
|
|
|
// reAsked answers one value of the reasks state (the tool builder_ask_again, issue 1945): a value not yet answered asks the
|
|
// key's waiting lanes again and is written back, by compare-and-set at its revision, with what the builder did. A value
|
|
// answered already (this builder's own write) or deleted is left.
|
|
func reAsked(ctx context.Context, b askAgainer, acts versions.Acts, kv jetstream.KeyValue, e jetstream.KeyValueEntry, logf func(string, ...any)) {
|
|
if e.Operation() != jetstream.KeyValuePut {
|
|
return
|
|
}
|
|
r, err := build.DecodeReAsk(e.Value())
|
|
if err != nil {
|
|
logf("%s.%s holds what is not an ask to ask again, left: %v", build.ReAsksState, e.Key(), err)
|
|
return
|
|
}
|
|
if r.Answer != "" {
|
|
return
|
|
}
|
|
if r.Mode == build.ModeBuild {
|
|
// The answer comes when the claim and the asks are written, so it is made beside the watch, not in it.
|
|
go builtAgain(ctx, b, kv, e, r, logf)
|
|
return
|
|
}
|
|
if r.Mode == build.ModeAnnounce {
|
|
announcedAgain(ctx, b, kv, e, r, logf)
|
|
return
|
|
}
|
|
if r.Mode == build.ModePublishAgain || r.Mode == build.ModeFloorAgain || r.Mode == build.ModeOldFormDrop {
|
|
// A version's hand act (design 51 *Tools of the builder*) may build again, so it is answered beside the watch.
|
|
go versionActed(ctx, acts, kv, e, r, logf)
|
|
return
|
|
}
|
|
asked := b.AskAgain(e.Key(), r.Why)
|
|
if len(asked) == 0 {
|
|
r.Answer = "no ask of this key waits in this builder now (it is not building, or its build has not reached its ask yet): nothing was asked; builder_stuck shows where it stands"
|
|
} else {
|
|
r.Answer = "asked again: the " + strings.Join(asked, ", ") + " ask, under a new id the key names"
|
|
}
|
|
r.Answered = time.Now().UTC()
|
|
logf("%s: asked again by %s (%s): %s", e.Key(), r.By, r.Why, r.Answer)
|
|
data, err := json.Marshal(r)
|
|
if err != nil {
|
|
return
|
|
}
|
|
if _, err := kv.Update(ctx, e.Key(), data, e.Revision()); err != nil && !errors.Is(err, jetstream.ErrKeyExists) && !errors.Is(err, jetstream.ErrKeyRevisionMismatch) {
|
|
logf("%s.%s: the answer could not be written: %v", build.ReAsksState, e.Key(), err)
|
|
}
|
|
}
|
|
|
|
// emitAskedAgain says the builder's event build.asked-again (issue 1945): mesh.mod.<module>.event.build.asked-again,
|
|
// with the SDK's envelope headers and the new ask's id as the bus's dedup id.
|
|
func emitAskedAgain(ctx context.Context, js jetstream.JetStream, cred process.Account, e build.AskedAgain) error {
|
|
if err := emitEvent(ctx, js, cred, build.AskedAgainEvent, "asked-again-"+e.New, e); err != nil {
|
|
return fmt.Errorf("saying %s for %s: %w", build.AskedAgainEvent, e.Key, err)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// builtAgain answers a reasks value of mode build (the tool builder_build_again, issue 1126 note 72): the failed key is
|
|
// built again as a new revision, and the value is written back with the revision and the asks put, or why nothing was done.
|
|
func builtAgain(ctx context.Context, b askAgainer, kv jetstream.KeyValue, e jetstream.KeyValueEntry, r build.ReAsk, logf func(string, ...any)) {
|
|
res := b.BuildAgain(ctx, r.Module, r.FP, r.Why, r.By, buildAgainBound)
|
|
switch {
|
|
case res.Refused != "":
|
|
r.Answer, r.Refused = res.Refused, true
|
|
case res.Failed != "":
|
|
r.Answer, r.Revision, r.Failed = fmt.Sprintf("the key is written building as revision %d, and the build failed before any ask was put: %s", res.Revision, res.Failed), res.Revision, res.Failed
|
|
default:
|
|
r.Pending = res.Revision == 0
|
|
r.Answer, r.Revision, r.Asks = "built again: the key is written building as revision "+fmt.Sprint(res.Revision)+" and its asks are put", res.Revision, res.Asks
|
|
if res.Pending != "" {
|
|
r.Answer = res.Pending
|
|
if res.Revision != 0 {
|
|
r.Answer = "built again: the key is written building as revision " + fmt.Sprint(res.Revision) + "; " + res.Pending
|
|
}
|
|
}
|
|
}
|
|
r.Answered = time.Now().UTC()
|
|
logf("%s: build again asked by %s (%s): %s", e.Key(), r.By, r.Why, r.Answer)
|
|
data, err := json.Marshal(r)
|
|
if err != nil {
|
|
return
|
|
}
|
|
if _, err := kv.Update(ctx, e.Key(), data, e.Revision()); err != nil && !errors.Is(err, jetstream.ErrKeyExists) && !errors.Is(err, jetstream.ErrKeyRevisionMismatch) {
|
|
logf("%s.%s: the answer could not be written: %v", build.ReAsksState, e.Key(), err)
|
|
}
|
|
}
|
|
|
|
// announcedAgain answers a reasks value of mode announce (the tool builder_announce_again): the done key is written again
|
|
// unchanged, and the value is written back with the new revision, or why nothing was done.
|
|
func announcedAgain(ctx context.Context, b askAgainer, kv jetstream.KeyValue, e jetstream.KeyValueEntry, r build.ReAsk, logf func(string, ...any)) {
|
|
res := b.AnnounceAgain(ctx, r.Module, r.FP, r.Why, r.By)
|
|
if res.Refused != "" {
|
|
r.Answer, r.Refused = res.Refused, true
|
|
} else {
|
|
r.Revision, r.Answer = res.Revision, fmt.Sprintf("announced again: the done key is written again, unchanged, as revision %d", res.Revision)
|
|
}
|
|
r.Answered = time.Now().UTC()
|
|
data, err := json.Marshal(r)
|
|
if err != nil {
|
|
return
|
|
}
|
|
if _, err := kv.Update(ctx, e.Key(), data, e.Revision()); err != nil && !errors.Is(err, jetstream.ErrKeyExists) && !errors.Is(err, jetstream.ErrKeyRevisionMismatch) {
|
|
logf("%s.%s: the answer could not be written: %v", build.ReAsksState, e.Key(), err)
|
|
}
|
|
}
|
|
|
|
// appendLog appends one entry to the builder's module log `build-log` (ADR 0297, ADR 0571 §1) under the module's key
|
|
// (delivery.BuildLogKey), on the log's own subject: a module's program appends to the logs it keeps on its own credential.
|
|
// The id makes a repeated append of one entry one entry.
|
|
func appendLog(ctx context.Context, js jetstream.JetStream, cred process.Account, e delivery.BuildLogEntry) error {
|
|
data, err := delivery.EncodeBuildLogEntry(e)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
key, err := delivery.BuildLogKey(e.Module)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
msg := nats.NewMsg(buscompose.LogSubject(cred.Module, delivery.BuilderLog) + "." + key)
|
|
msg.Data = data
|
|
id := e.Event + "." + e.Module + "." + e.FP + "." + e.At.Format(time.RFC3339Nano)
|
|
pub, cancel := context.WithTimeout(ctx, 10*time.Second)
|
|
defer cancel()
|
|
if _, err := js.PublishMsg(pub, msg, jetstream.WithMsgID(id)); err != nil {
|
|
return fmt.Errorf("logging %s of %s at %s: %w", e.Event, e.Module, e.FP, err)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// versionActed answers a reasks value of builder_publish_again, builder_floor_again or builder_old_form's drop, a hand act said in the log.
|
|
func versionActed(ctx context.Context, acts versions.Acts, kv jetstream.KeyValue, e jetstream.KeyValueEntry, r build.ReAsk, logf func(string, ...any)) {
|
|
var err error
|
|
if r.Mode == build.ModePublishAgain {
|
|
var ag versions.Again
|
|
ag, r.Answer, err = acts.PublishAgain(ctx, r.Name, r.FP, r.Why, r.By, r.At)
|
|
r.Do, r.Version = ag.Do, ag.Entry.Version
|
|
} else if r.Mode == build.ModeOldFormDrop {
|
|
if acts.DropOldForm == nil {
|
|
err = errors.New("this builder keeps no old-form window")
|
|
} else {
|
|
r.Answer, err = acts.DropOldForm(ctx, r.Name, r.By, r.Why, r.At)
|
|
}
|
|
} else {
|
|
r.Answer, err = acts.FloorAgain(ctx, r.Name)
|
|
}
|
|
if err != nil {
|
|
r.Answer, r.Refused = err.Error(), true
|
|
}
|
|
r.Answered = time.Now().UTC()
|
|
logf("%s: %s of %s by %s (%s): %s", e.Key(), r.Mode, r.Name, r.By, r.Why, r.Answer)
|
|
data, err := json.Marshal(r)
|
|
if err != nil {
|
|
return
|
|
}
|
|
if _, err := kv.Update(ctx, e.Key(), data, e.Revision()); err != nil && !errors.Is(err, jetstream.ErrKeyExists) && !errors.Is(err, jetstream.ErrKeyRevisionMismatch) {
|
|
logf("%s.%s: the answer could not be written: %v", build.ReAsksState, e.Key(), err)
|
|
}
|
|
}
|