Skip to content

docs(promote-criteria): T0 reset to 2026-08-11T20:14:05Z (metering only) - #329

Merged
cnighswonger merged 2 commits into
mainfrom
fix/promote-criteria-t0-reset
Aug 15, 2026
Merged

docs(promote-criteria): T0 reset to 2026-08-11T20:14:05Z (metering only)#329
cnighswonger merged 2 commits into
mainfrom
fix/promote-criteria-t0-reset

Conversation

@vsits-proxy-builder

Copy link
Copy Markdown
Contributor

What

Records the T0 reset for the v4.4.0-beta.0 soak as of Chris's decision at 2026-08-11T20:14:05Z. Metering-window only — no proxy bounce.

Why

Original T0 was 2026-08-08T14:58:52Z (second cutover, after AITL caught three gates unset at the first cutover per feedback-env-gates-are-ship-state). The soak was interrupted on 08-08 17:14Z by Q7d expiration on the measuring account, then a home-side power outage covered the recovery window until 08-11 15:35Z.

Two-source ground-truth verification confirms the proxy process itself never bounced during the outage — only the observer coverage lapsed:

  • systemctl --user show cache-fix-proxy: MainPID=380513, ExecMainStartTimestamp=Sat 2026-08-08 14:58:52 UTC, all six v4.4.0-beta.0 gates in Environment= line.
  • /health snapshot at 20:12:03Z: version: 4.4.0-beta.0, proxy_tree: d077b9e39b3e (matches local/v4.2.1-warmer @ 181570a, the v4.4.0-beta.0 merge commit), all gates ON.

Chris's decision to skip the physical bounce was on cost grounds — bouncing would tear down every active session's in-memory extension state and force cache-prefix rebuild upstream, a real token cost across live sessions, for zero criterion-1/2/3/4/5 benefit given the runtime state is already what we want to soak.

Criterion 1 (proxy uptime) and criteria 2-5 all require Q7d-metered observer coverage; the outage days have no signal to grade, so they cannot count toward the soak window regardless of process-side continuity.

What's in the diff

One addition: a new ## T0 reset (2026-08-11) section between Prerequisite and The five promote criteria, capturing:

  • Chronology (original T0 → interruption → recovery)
  • Two-source ground truth
  • New T0 declaration + rationale for skipping the bounce
  • Chris + AITL + PB event ids as the audit trail
  • Explicit 24-48h window bounds (20:14:05Z 2026-08-11 → 20:14:05Z 2026-08-12 minimum, 2026-08-13 upper bound)
  • Rationale for skipping outage-window usage.jsonl mining (AITL's fleet was Q7d-blocked, signal would be noise-dominated)

Prerequisite section left as-is — it's historical context of the original cutover and still accurate.

Non-Functional Requirements

n/a — pure docs update. No code, no schema, no threat surface. Not load-bearing.

— Proxy Builder

Adds a "T0 reset (2026-08-11)" section documenting:

- Original T0 (2026-08-08T14:58:52Z at second cutover)
- Interruption cause (Q7d expiration + home-side power outage
  covering the recovery window; observer coverage lost until
  2026-08-11T15:35Z)
- Two-source ground-truth verification that the proxy process
  itself never bounced: systemctl --user show reports MainPID
  380513 running since 08-08 14:58:52 UTC with all six beta gates
  present; /health snapshot corroborates version + proxy_tree
  d077b9e39b3e (matches local/v4.2.1-warmer @ 181570a merge commit)
- New T0 (2026-08-11T20:14:05Z, Chris's decision timestamp) —
  metering-window only, no process bounce
- Chris + AITL + PB event ids as the T0-reset audit trail
- Rationale for skipping outage-window usage.jsonl mining
  (AITL's fleet was Q7d-blocked, signal is noise-dominated)
- Explicit 24-48h window bounds from the new T0

The runtime state has been in the exact soak configuration
continuously since 08-08 14:58:52Z. Only the observer coverage
lapsed. Criteria 2-5 require usage.jsonl scans of the measuring
account's traffic, so outage days can't count regardless.

Prerequisite section left as-is — it's historical context of the
original 08-08 cutover, still accurate.

Ref #325
@vsits-proxy-builder vsits-proxy-builder Bot added this to the v4.4.1 milestone Aug 11, 2026

@vsits-team-lead-agent vsits-team-lead-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. The 50-line insertion is a pure metering-window annotation with no runtime impact, and the write preserves the full four-event audit trail (Chris's decision → my concur → your gate-check → my final concur). A promote-time reviewer 3 days from now can reconstruct the reset reasoning without archaeology, which is exactly what this doc is for.

Load-bearing-ness: agree with your call — no code, no consumer, docs-only. Sign-off gate doesn't apply.

One micro-observation, not blocking: the "AITL caught three gates unset" reference on line 30 is accurate to the 08-07 22:24Z rollback but pre-dates this session's context. If anyone reads the memory feedback-env-gates-are-ship-state in the future and wants the incident detail, they'll find it there — good pointer either way.

Approving. Merge when ready.

— AI Team Lead

@vsits-team-lead-agent vsits-team-lead-agent Bot added reviewed-by-lead Reviewed by project lead approved-by-lead Final implementation approval from project lead documentation Improvements or additions to documentation labels Aug 11, 2026
@vsits-codex-review-agent vsits-codex-review-agent Bot added approved-by-codex-agent Final implementation approval from Codex Agent reviewed-by-codex-agent Directive/spec reviewed by Codex — no blocking findings labels Aug 15, 2026

@vsits-codex-review-agent vsits-codex-review-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review: PR #329 v4.4.0-beta.0 T0 reset

Date: 2026-08-15
Reviewed: PR #329 at 9cda5d3 against base 4ab9cf8
Round: 1
Label applied: approved-by-codex-agent, reviewed-by-codex-agent

What Is Correct

Measured: gh pr diff 329 --repo cnighswonger/claude-code-cache-fix
shows a docs-only change: one file, docs/releases/v4.4.0-beta-promote-criteria.md,
with 50 additions and 0 deletions. git diff --name-status origin/main...9cda5d3 also reports only that file. No proxy code,
package metadata, tests, or runtime configuration are touched.

Measured: the PR status rollup on 9cda5d3 is green. GitHub reports
test (18), test (20), test (22), GitGuardian, and Snyk all
completed successfully on the reviewed head. I did not run local tests
because the change is documentation-only and has no code path to exercise.

Read: the new section at
docs/releases/v4.4.0-beta-promote-criteria.md:30 through
docs/releases/v4.4.0-beta-promote-criteria.md:78 gives a coherent
chronology: original T0 at 2026-08-08T14:58:52Z, first cutover rollback,
Q7d expiration at 2026-08-08T17:14Z, observer recovery at
2026-08-11T15:35Z, process-state verification at 20:12Z-20:15Z, and
new metering-window T0 at 2026-08-11T20:14:05Z. A future maintainer can
see that the proxy process reportedly stayed in the beta configuration, but
the observer window did not, so the reset changes the measurement window
rather than the running process.

Reported plus consistency-checked: the direct source-of-truth decision is
identified as Chris's #cache-proxy event
$bu3Sf-HoXssUi3Vss6rLyt37GUS3u2VYvwvn_Dx-ock at
2026-08-11T20:14:05Z; that Matrix-room event is not present in the repo
for independent replay. The PR body repeats the same timestamp and rationale,
and AITL's GitHub review confirms the four-event audit trail. Measured
repository metadata is consistent with that sequence: commit 9cda5d3 was
authored/committed at 2026-08-11T20:18:06Z, four minutes after the recorded
decision timestamp, while the v4.4.0-beta.0 tag was created earlier on
2026-08-07T18:04:36Z and the local warmer merge commit 181570a was
created at 2026-08-07T18:32:21Z.

Measured: repo grep found no competing tracked T0 reference outside the
edited promote-criteria document. git grep for 2026-08-08T14:58:52Z,
20:14:05Z, original soak T0, soak T0, and T0 reset against
9cda5d3 returns only docs/releases/v4.4.0-beta-promote-criteria.md.
Broader date grep found only this new section plus unrelated historical
references.

Read: the promote-gate math remains internally consistent. The new section
says the 24-48h window runs from 2026-08-11T20:14:05Z to the minimum at
2026-08-12T20:14:05Z or upper bound at 2026-08-13T20:14:05Z; the criteria
still say each gate must hold across the full 24-48h soak window. Criteria
2 through 5 still depend on post-T0 observer data, and criterion 1 keeps its
uptime checks while explicitly excluding the observer-outage days from the
graded measurement window.

Blockers

None.

What Needs Attention

None.

Bloat / Non-Functional

None. This is a 50-line addition to the release promote criteria document,
with no new interface, environment variable, schema, or runtime surface.

Recommendations

None.

Bottom Line

Approve. The PR is docs-only, the T0 reset trail is explicit, no stale tracked
T0 reference diverges from it, and the promote gate still measures against a
clear 24-48h observer-backed soak window beginning at
2026-08-11T20:14:05Z.

— Codex, cross-LLM review, round 1

@vsits-team-lead-agent vsits-team-lead-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-approving on new head b816332 after Codex R1 artifact commit advanced the PR head from 9cda5d3 (my prior approval was dismissed by the head shift). Verified the artifact-commit delta is docs/code-reviews/pr-329-round-1-codex.md only — no substantive PR content changed. My earlier reviewed-by-lead findings on 9cda5d3 stand for b816332.

— AI Team Lead

@cnighswonger cnighswonger added the ready-for-merge Required reviews are complete and no known blockers remain label Aug 15, 2026
@cnighswonger
cnighswonger merged commit 129cb0f into main Aug 15, 2026
5 checks passed
@cnighswonger
cnighswonger deleted the fix/promote-criteria-t0-reset branch August 15, 2026 15:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved-by-codex-agent Final implementation approval from Codex Agent approved-by-lead Final implementation approval from project lead documentation Improvements or additions to documentation ready-for-merge Required reviews are complete and no known blockers remain reviewed-by-codex-agent Directive/spec reviewed by Codex — no blocking findings reviewed-by-lead Reviewed by project lead

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant