Skip to content

docs: runbook covers all 4 timers + July windows (S6-003)#102

Merged
lwalden merged 2 commits into
mainfrom
docs/s6-003-runbook-adr031-timers
Jun 11, 2026
Merged

docs: runbook covers all 4 timers + July windows (S6-003)#102
lwalden merged 2 commits into
mainfrom
docs/s6-003-runbook-adr031-timers

Conversation

@lwalden

@lwalden lwalden commented Jun 11, 2026

Copy link
Copy Markdown
Owner

What

Docs-only update reconciling docs/paper-validation-runbook.md and DECISIONS.md (ADR-031) with the merged S6 timer set:

  • Runbook now documents all 4 timers (pre-market, EOD, monthly reinvest, quarterly audit) including July expected-behavior windows: the 2026-07-01 recommendation-only reinvest firing and the Jul 1-7 quarterly-audit not-implemented window.
  • Silence-cases list covers the IncomeSleeve_QuarterlyAudit not-implemented case (Warning log line, no Discord message).
  • Flag-flip preconditions for IncomeSleeve:OrderPlacementEnabled use concrete verification criteria (tickers match income-sleeve holdings, non-zero quantities, cost within available-cash estimate) instead of "look sane".
  • ADR-031 amendment recorded in DECISIONS.md.

Why

The paper-validation Run Log is the system of record for the 12-week run starting 2026-06-11; operators need exact expected behavior for every timer firing, including expected silences, so non-events are not mis-triaged as incidents.

Verification

  • All cron expressions and log/message strings verified verbatim against merged source.
  • A1 lens claim adjudicated wrong by judge: the broker-connect alert exists in IncomeReinvestService.cs:96-102.
  • Judge: PASS with 3 fix-now items, applied in c1b7983 (silence-case bullet, log-path pointer, concrete flip criteria).
  • Docs-only change: git diff main --name-only shows only docs/paper-validation-runbook.md and DECISIONS.md; build/host-boot-smoke CI jobs skip via paths filter.

Sprint item: S6-003

🤖 Generated with Claude Code

lwalden and others added 2 commits June 10, 2026 19:59
…003)

Reconcile the paper-validation runbook and ADR-031 with the merged income-sleeve
state before the 2026-07-01 reinvest firing:

- Timer table covers all 4 functions with crons verified against source
  (IncomeSleeveFunction.cs / DailyOrchestrator.cs) and UTC/PDT/PST columns per
  the doc's existing DST convention; footnote explains the first-week multi-fire
  crons and the authoritative in-code gates (do not 'fix' the crons).
- New expected-behavior subsections: 2026-07-01 reinvest (recommendation-only,
  IncomeSleeve:OrderPlacementEnabled=false, NO orders in TWS paper, empty-plan
  honesty, PDR-004 first-trade clock) and Jul 1-7 quarterly-audit window (one
  Warning line, Discord silence is correct). Includes the S6-001 judge-deferred
  flag-flip preconditions (prior report arrived, TWS paper mode, LIVE account
  not active).
- Preflight step 5 asserts all 4 function names; host-boot-smoke.sh cross-ref.
- Section 4 gains the Income Reinvest Plan row and the two Monthly Reinvest
  alert titles (verbatim from the merged S6-001 embeds/alerts).
- Section 5 triage points at the actual local sinks (worker console +
  %LOCALAPPDATA%\TradingSystem\logs) with one deliberate KD-005/KD-006
  parenthetical; App Insights no longer cited as a primary sink.
- ADR-031: two-timers wording amended to four (ADR-029-style update markers);
  consequences extended for tolerated missed reinvest firings and the audit
  no-op. No decision content rewritten.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@lwalden lwalden changed the title docs: runbook covers all 4 timers + July expected-behavior windows (S6-003) docs: runbook covers all 4 timers + July windows (S6-003) Jun 11, 2026
@lwalden lwalden merged commit 62f6047 into main Jun 11, 2026
5 checks passed
@lwalden lwalden deleted the docs/s6-003-runbook-adr031-timers branch June 11, 2026 03:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant