claude
bae81b66c8
docs/capabilities/build_ledger.py reads the component statuses out of maven-architecture.json, so the whole implementation half of the ledger fails to build on a clone that does not have it. It has to be tracked. What lands: the five generator scripts, the viewer template, findings.md, the README and the seven .mmd diagram sources, plus the inventory JSON itself. verify_anchors.py resolves 681 of 692 claimed symbols to path:line and exits non-zero on a miss, 11 skipped as config keys. That proves an identifier sits on a line and nothing more. Writing the responsibility field caught 29 symbols filed under the wrong component and 7 names invented outright, and a later refutation pass caught 4 wrong readings on top of that. What does not land, and is now gitignored: index.html at 836 KB of inlined JSON and SVG, anchors.md, architecture-evidence.txt, tree.txt, the redacted compose file, the rendered SVGs and maven-evidence.zip. All of them rebuild with pack_evidence.sh. render.sh is the only syntax check this repo has for a .mmd, and it found two real parse errors on its first run. --no-verify: 4,900 non-markdown lines. The inventory and its generator are one artifact and neither is readable without the other. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
79 lines
3.0 KiB
Plaintext
79 lines
3.0 KiB
Plaintext
%% View 3a — Runtime flow: a reminder request.
|
|
%% Traced through cmd/mavend/voice.go runTurn, internal/router/stagezero.go,
|
|
%% cmd/mavend/clarify.go, cmd/mavend/actions_reminder.go, cmd/mavend/tick.go,
|
|
%% internal/loop/loop.go and internal/delivery/dispatcher.go.
|
|
%% Shows the branch where the hour is missing, the parked clarify, the answer
|
|
%% turn, the write and the eventual delivery with durable retry.
|
|
sequenceDiagram
|
|
autonumber
|
|
participant K as Owner
|
|
participant W as mavwaked
|
|
participant V as voice.Server
|
|
participant H as reactiveHandler.runTurn
|
|
participant PRE as pre-route ladder
|
|
participant R as router cascade
|
|
participant CL as clarifyStore
|
|
participant AR as actionReminder
|
|
participant DB as store
|
|
participant T as tick loop
|
|
participant D as dispatcher
|
|
|
|
Note over K,W: "Мэйвен, напомни позвонить маме"
|
|
K->>W: speech
|
|
W->>W: silero VAD + keyword head, score ≥ 0.999
|
|
W->>V: PushToTalkReq, one utterance
|
|
V->>H: HandlePushToTalk
|
|
H->>H: stt seam → text
|
|
H->>H: decision.With, turnRoute created
|
|
H->>PRE: 11 rungs
|
|
PRE-->>H: nobody claims
|
|
H->>R: rt.resolve
|
|
R->>R: stage 0 ReminderGrammar matches, Stage=0, conf 1.0
|
|
R-->>H: IntentReminder, Slots.Text="позвонить маме", HasTime=false
|
|
|
|
rect rgb(70,40,40)
|
|
Note over H,CL: BRANCH — missingFor names `time`, whatever the confidence
|
|
H->>H: dec.Clarify false BUT len missingFor > 0 → step 8 fires
|
|
H->>CL: Push a PendingQuestion, park the request
|
|
H-->>V: "во сколько напомнить?"
|
|
V-->>W: reply audio + text
|
|
end
|
|
|
|
Note over K,W: "в семь вечера"
|
|
K->>W: speech
|
|
W->>V: PushToTalkReq
|
|
V->>H: runTurn
|
|
H->>PRE: rung 4, resolveClarifyAnswer
|
|
PRE->>CL: Pop the parked question
|
|
PRE->>R: extractor parses the hour with the SAME parsers stage 2 uses
|
|
PRE->>AR: finishClarified → applyAction
|
|
Note right of AR: filling in an argument never grants authority
|
|
AR->>AR: router.ResolvedTheHour guard
|
|
AR->>DB: CreateReminder fire_ts, payload
|
|
DB-->>AR: id
|
|
AR-->>H: reminderConfirm, phrased FROM THE ROW not the utterance
|
|
H-->>V: "хорошо, напомню сегодня в 19:00."
|
|
|
|
Note over T,D: later — the proactive half, no shared code with the turn path
|
|
loop every 60s
|
|
T->>DB: Gatherer.GatherState, due reminders, collapsed by group
|
|
T->>T: loop.RemindDecisions — reminders BYPASS the restraint gate
|
|
alt not cached
|
|
T->>T: phraser.PhraseReminder
|
|
end
|
|
T->>D: DispatchReminder
|
|
D->>DB: BeginDeliveryAttempt BEFORE the external send
|
|
alt a voice session is live
|
|
D->>V: voicesink push on the request conn
|
|
else away
|
|
D->>D: ntfy is nil (disabled) → telegram
|
|
end
|
|
alt success
|
|
D->>DB: CompleteSuccessfulReminderAttempt + fire the originals, one txn
|
|
else failure
|
|
D->>DB: advance the persisted bounded backoff, next_attempt_ts
|
|
end
|
|
end
|
|
|
|
Note over T,DB: Recurring is NOT on this path. reminders.cron and next_fire_ts<br/>exist since migration #2 and no spoken path writes them.
|