{
"command": "pwd"
}/Users/warrenthompson/Source/LoginID/03-engineering-delivery
{
"file_path": "/Users/warrenthompson/Source/LoginID/CLAUDE.md"
}1 # LoginID Take-Home POC — Project Root
2
3 ## Role
4
5 You are the project manager agent for this repository. This file is the shared context every track refers back to. Each of the five track directories below has its own CLAUDE.md that can be worked independently by a scoped subagent, but that subagent should read this root file first for the assignment, the overall narrative, and how its track fits with the other four.
6
7 When you spin up agents or subagents to do work in a track, point them at that track's CLAUDE.md as their brief, and tell them this root file exists for cross-track context. Don't let a track's agent silently duplicate scope another track owns — check the "Owns / does not own" boundaries below first.
8
9 ## What this repository is
10
11 This is a take-home assignment for a LoginID interview, submitted as a full directory. The goal is not just to answer three coding questions — it's to demonstrate capability as an AI architect: how you scope a problem, use AI tooling deliberately, reason about security and data, and produce something that reads as an intentional, well-run engineering effort rather than a quick script.
12
13 Code does not need to work or be fully complete. LoginID has said explicitly they care more about the design and the reasoning behind it, and about which AI tools/frameworks were used and how. Every track should document its reasoning, not just its output.
14
15 ## The assignment (verbatim from LoginID)
16
17 Provide code solutions for the following questions in Go (preferably) or other languages — describe any tool, framework, or AI used.
18
19 1. Code of a database DAO that can store and retrieve `user_profile` (name, address, phone) and `user_credential` (username, method, password), with support for multiple databases (PostgreSQL or CockroachDB, SQLite, etc).
20 2. Design a RESTful API web service to search and retrieve the above user profile data, plus security API authentication.
21 3. Design a service connector to third-party identity providers (referred to generically as ABC or XYZ) to retrieve personal data from vendors, with the following endpoints:
22 - `/auth` — retrieves an `access_token` based on a POST JSON body `{"username": "<string>", "password": "<string>"}`
23 - `/identity` — retrieves user PII (name, phone, address: `street_address`, `locality`, `region`, `postal_code`, `country`) based on a POST JSON body `{"phone": "<string>", "name": "<string>"}`
24
25 Go is the preferred language. Other languages are acceptable if justified.
26
27 ## Track structure
28
29 Five directories, each independently workable, each owning a distinct slice of the problem:
30
31 | Directory | Track | Owns |
32 |---|---|---|
33 | `01-product-industry-research-design/` | Product & Industry Research (incl. Design) | Market/industry framing (IAM, passwordless auth, IDP aggregation space), personas and use cases, API and data contract design rationale, UX of the surfaces that would sit on top of this |
34 | `02-ai-security-architecture/` | AI Architecture & Security Architecture | The AI tooling/workflow used to produce this submission, threat modeling, auth/authz design for the API, credential and PII handling, secrets management, third-party connector security |
35 | `03-engineering-delivery/` | Engineering & Delivery | The actual Go code for all three questions, project structure, test strategy, delivery documentation |
36 | `04-infra-devops/` | Infra & DevOps | How this would be built, containerized, deployed, and operated — CI/CD, environments, multi-database configuration, observability |
37 | `05-data-ops/` | Data Ops | Data modeling for `user_profile` / `user_credential`, multi-database abstraction strategy, migrations, PII data governance and retention |
38
39 Directories are numbered for reading order in the final submission, not for sequencing of work — tracks can be worked in any order or in parallel.
40
41 ## Working principles for every track
42
43 - State your reasoning, not just your conclusion. LoginID is grading the "why" as much as the "what."
44 - Name the AI tool/workflow you used for that track's output (this project is being built with Claude Code; say so, and say how — e.g., subagents scoped per track, a given skill, a given model).
45 - Keep each track's CLAUDE.md self-contained enough that a fresh agent with no other context can pick it up and do correct work from it alone, plus this root file.
46 - Cross-reference other tracks by relative path (e.g., `../05-data-ops/CLAUDE.md`) rather than restating their content.
47 - Implementation is gated per story, not project-wide: Warren gave the implementation go on 2026-09-12 (evening) as an agile loop. Code (`.go`, `.sql`, `go.mod`, Dockerfiles, CI config) may be written only for a story the Product Owner has pulled, refined with the research team, and handed to engineering — recorded in `<track>/refinement/<LT-key>.md`. Work happens on a `feature/<LT-key>` branch, never directly on `main`. A story is done only when it is deployed to the public URL and the Product Owner has reviewed it there.
48 - **Attribution rule (Warren, 2026-09-12): every commit, PR, and Jira ticket says who did the work.** *Commits:* the git author is the persona doing the work — set once per worktree with `git config --worktree user.name "<Persona Name> (<track> <role>, <model>)"` and `git config --worktree user.email "<slug>@agents.loginid-takehome.invalid"` (`extensions.worktreeConfig` is enabled repo-wide) — and every commit message ends with trailers: `Story: LT-nn`, `Work-By: <persona> (<seat>); <persona> (<seat>)…` naming each hire who contributed and what they did (implementation, tests, review, objection seat), then `Co-Authored-By: Claude <model> <noreply@anthropic.com>`. *PRs:* title `LT-nn: <summary>`; body has a **Who did the work** section (lead, hires and seats, reviewers incl. 02's independent reviewer where applicable, models), plus links to the refinement doc and the Jira issue. *Jira:* every transition and every PR link is a comment beginning `Work-By: …` with the same names; the story's final comment before Done names who deployed and who reviewed. The PM applies the same rule to its own commits. Persona names, not "Claude" or "the team".
49 - **Shared working tree rule.** Every lead session shares this one checkout, so `git checkout`/`git switch` here changes everyone's tree — **never run them in this directory.** Feature branches live in worktrees outside the repo: `git worktree add /Users/warrenthompson/Source/LoginID-worktrees/<LT-key> -b feature/<LT-key> main`; work, commit, and push from that directory; the root tree stays on `main`. Remote: `origin` = `«email»:wtvamp/loginid-takehome.git` (public). Go code lives at the repo root (`cmd/`, `internal/`, `go.mod`); track directories hold documents.
50
51 ## Org, hiring, and orchestration
52
53 The project is run as an org: this PM agent (Dana Whitfield) orchestrates five standing track-lead agents, and each lead hires a small sub-team of specialist agents with deliberately varied personalities. **Each track lead runs as its own top-level Claude Code session**, launched from its track directory in its own tmux window — so it loads its own track `CLAUDE.md` and persona natively, owns and spawns its hires as named teammates in that window, and talks to the PM session through cross-session messaging. Hires belong to their lead's session, not the PM's. The governing files, all at the root:
54
55 - `PLAN.md` — the approved org plan for the planning phase (phases, gates, verification). `~/.claude/plans/` is scratch; this is the record.
56 - `PLANNING.md` — the thin cross-track board: one row per track, one writer per row, plus the service-boundaries section 03 owns and 04 reads.
57 - `CASTING.md` — archetype palette, org-wide variance rules, hire sizing, the persona-writing standard, the orchestration-pattern catalog (adversarial pair, red/blue, three hats, rotating devil's advocate, structured written debate, newcomer's question), the deep-research rule, the hire-creation procedure, and the registry of every hire.
58 - `LOG.md` — dated, append-only journal of what happened and why (team-lead writes it; it is part of the submission).
59 - `.claude/agents/` — one agent definition per hire (model pinned; a once-only per-agent `PreToolUse` hook displays its own persona on its first tool call). `.claude/AGENT_TEMPLATE.md` is the starting point (kept outside the agents directory so it is not registered as an agent type itself).
60 - `02-ai-security-architecture/planning-approach.md` — the agreed Claude-architecture approach: model/effort by role, coordination rules, hand-off standard, dependency order.
61
62 Rules that hold across every track:
63 - Every agent — lead or hire — has a profile-gen persona (name, temperament, professional history, technical background, stated blind spot). Hires are created text-first with `--output file`; portraits arrive later from `scripts/portrait-queue.sh`. Hires are **never** added as `profile-gen` markers in any `CLAUDE.md` — only the six markers that exist today.
64 - Hires do not spawn subagents. Only track leads (and team-lead) authorize or run deep research (patents, whitepapers, standards, primary sources); hires request it from their lead.
65 - Tracks never modify root-level state (this file, the root persona, root config); flag it to team-lead instead.
66 - **Decisions already made are not re-asked.** Warren's rulings reach tracks through the PM and are recorded in `LOG.md` and this file. A lead must not raise an `AskUserQuestion` to Warren for a decision that is already on the record (e.g., the deployment target, the public repo, the code go) — it asks the PM by message, which answers from the record or escalates. A dialog left open in a lead's session blocks that lead and everything queued behind it (this cost DevOps an hour on 2026-09-12). Genuinely new decisions that only Warren can make still go to Warren — through the PM.
67 - Hand-offs are files by relative path, written so the receiver can act without re-deriving the sender's reasoning; chat messages signal readiness, they do not carry content.
68 - Edit `CLAUDE.md` files at turn boundaries only (prompt-cache stability). Milestone `git` commits at the end of each phase; no mid-task commits.
69
70 ## Status
71
72 Planning Phases 0–3 are complete (2026-09-12): five track plans approved, 18 hires live in five lead sessions, every track's Phase 3 debates and hand-offs delivered, and the cross-track consistency pass reported (`decisions/cross-track-consistency.md`: 52 findings, six bounded fixes required before planning is declared done — in progress, owned per finding). Phase 4 is under way: Jira Epics `LT-1`…`LT-5` exist, tracks 01 and 05 are transcribed, 02/03/04 follow the pass fixes. All implementation code was deliberately wiped earlier in the day and none has been written since; **no code until Warren's explicit go-ahead**, which he gives after the PM reports the backlog implementation-ready.
73
74 <!-- profile-gen:start slug=dana-whitfield -->
75 @profiles/dana-whitfield/dana-whitfield.md
76 <!-- profile-gen:end slug=dana-whitfield -->
77 {
"file_path": "/Users/warrenthompson/Source/LoginID/03-engineering-delivery/CLAUDE.md"
}1 # Track: Engineering & Delivery 2 3 Refer back to `../CLAUDE.md` for the full assignment text and how this track fits with the other four. 4 5 ## Mission 6 7 Write the actual code that answers all three assignment questions, in Go, implementing the designs the other tracks produce rather than re-deciding them here. Code does not need to be complete or working end-to-end — LoginID cares about the design and reasoning — but it should be structured and readable enough to demonstrate real engineering judgment. 8 9 ## Owns 10 11 - Question 1: the DAO layer for `user_profile` (name, address, phone) and `user_credential` (username, method, password), written to support multiple backing databases (PostgreSQL/CockroachDB, SQLite, etc.) behind a common interface, per the strategy in `../05-data-ops/CLAUDE.md`. 12 - Question 2: the RESTful API service to search/retrieve `user_profile` data, wired to the authentication mechanism designed in `../02-ai-security-architecture/CLAUDE.md`. 13 - Question 3: the third-party IDP connector service implementing `/auth` and `/identity` against the contracts specified in the assignment, following the connector security design in `../02-ai-security-architecture/CLAUDE.md`. 14 - Project structure, module layout, and inline documentation of design decisions and trade-offs made during implementation. 15 - Test strategy (unit/integration scope, what's stubbed vs. real) — tests don't need full coverage, but the approach should be stated. 16 17 ## Does not own 18 19 - Deciding the API auth mechanism or threat model — that's `../02-ai-security-architecture/CLAUDE.md`; implement what it specifies. 20 - Deciding the multi-database abstraction strategy or schema — that's `../05-data-ops/CLAUDE.md`; implement what it specifies. 21 - Deployment, containerization, CI/CD — that's `../04-infra-devops/CLAUDE.md`. 22 - Product/industry rationale for why the API is shaped this way — that's `../01-product-industry-research-design/CLAUDE.md`; reference it, don't re-derive it. 23 24 ## Deliverables 25 26 - Go source implementing questions 1, 2, and 3. 27 - A short README in this directory explaining what's implemented, what's stubbed/mocked, and why, plus which AI tool/workflow was used to produce the code and how. 28 - Any test files demonstrating the stated test strategy. 29 30 ## AI tooling note 31 32 Record which AI tool/workflow generated this track's code (this project is being built with Claude Code) and how much was AI-authored vs. human-reviewed/edited. 33 34 ## Status 35 36 Planning complete (2026-09-12): 4 hires spawned and live, `PLAN.md` approved, Service boundaries published in root `PLANNING.md`, four implementation-call decisions ruled (`decisions/go-layout-debate.md`, `error-semantics.md`, `context-propagation.md`, `test-double-strategy.md`), 05's DAO contract accepted (including a second-pass review and 05's resulting `CreateProfileWithCredential` fix), 02's `handoff-03-auth.md` v3 accepted, `backlog.md` written (11 stories, Epic `LT-3`). No `.go`/`.sql`/`go.mod` exists yet — still waiting on Warren's explicit implementation go-ahead. 37 38 <!-- profile-gen:start slug=renata-cole --> 39 @profiles/renata-cole/renata-cole.md 40 <!-- profile-gen:end slug=renata-cole --> 41
{
"file_path": "/Users/warrenthompson/Source/LoginID/03-engineering-delivery/PLAN.md"
}1 # Track 03 (Engineering & Delivery) — Phase 1 Plan 2 3 ## Context 4 5 Team-lead has asked every track lead to plan in plan mode before any hiring or code. This 6 track (Renata Cole) owns the actual Go implementation of all three assignment questions — 7 the DAO, the REST API, and the IDP connector — so its plan needs to name concrete, 8 Jira-shaped deliverables, propose a 4-hire roster with real personality variance (per 9 `CASTING.md`), decide which decisions in this track deserve a debate pattern versus which are 10 waste, state the dependency order this track already committed to in 11 `../02-ai-security-architecture/planning-approach.md`, and produce the "Service boundaries" 12 section of root `PLANNING.md` that 04 (Theo) is blocked on reading. Nothing here is new 13 strategy — it operationalizes what's already agreed in `planning-approach.md` and the root 14 `CLAUDE.md`'s org section. No code is written in this phase. 15 16 ## 1. Deliverables & tasks (one Jira Story each; Epic = this track) 17 18 *This table is the Phase 1 planning snapshot (2026-09-12). `backlog.md` (11 stories, Jira Epic `LT-3`) is the current, authoritative, PR-sized expansion — its story descriptions and acceptance criteria supersede this table's "What"/"Acceptance standard" columns wherever they differ. Consult `backlog.md`, not this table, for current story shape, hand-off versions, or acceptance criteria.* 19 20 | Story | What | Hand-off consumed | Hand-off produced | Acceptance standard | 21 |---|---|---|---|---| 22 | S1. Scaffolding | Go module layout, `cmd/` entrypoints, route wiring, stub handlers, config loading | none (assignment text only) | `PLANNING.md` Service boundaries (this plan, §4 below) | Buildable skeleton; 04 can read the boundaries doc without asking a follow-up question | 23 | S2. DAO per backend | `internal/dao` `Repository` interface + Postgres/CockroachDB/SQLite implementations for `user_profile`, `user_credential` | 05's Go-shaped contract in `../05-data-ops/multi-db-strategy.md` (interface signatures, field types/nullability, credential-method-as-lookup-table note) | none outbound | 03 implements directly from the contract with no re-derivation of schema or interface decisions; if the contract is prose instead of Go signatures, this story is blocked and kicked back to 05 | 24 | S3. REST handlers + auth middleware | Search/retrieve `user_profile` endpoints (Q2) + middleware enforcing 02's scheme | 02's receiver-shaped auth hand-off (token scheme, validation point — the deferred follow-up to `api-auth-design.md` noted in 02's own `CLAUDE.md` Status) | none outbound | Middleware implements the scheme as specified; no alternatives re-litigated in code | 25 | S4. Connector `/auth` + `/identity` | Go client + handlers per the assignment's fixed JSON contracts | 02's `connector-security.md` (token lifecycle: no-cache-by-default, fetch per `/identity` call, discard on return — TTL/refresh apply only to how quickly a re-fetch happens, not to any stored token) | none outbound | Token-lifecycle logic matches 02's spec exactly; endpoint paths/bodies are the assignment's, not re-designed | 26 | S5. Tests | Table-driven unit tests for DAO (mocked driver), handlers (mocked DAO), connector (mocked HTTP), **plus the cross-backend conformance suite 05's per-driver ruling is conditional on (`multi-db-strategy.md` §7) — one suite, written once against the `Repository` interface, run against every backend** (consistency-pass finding F25: this was a requirement with no named deliverable until now; `backlog.md`'s S5 is the current, authoritative expansion of this story) | S1–S4 outputs | none | Stated strategy: unit-heavy, integration deliberately stubbed (assignment doesn't require full end-to-end); documented, not silently absent | 27 | S6. README | What's implemented vs. stubbed/mocked and why; AI tool/workflow used (this plan's own hiring + patterns); test-strategy section must state the hand-written-fake rule from `decisions/test-double-strategy.md` (same-PR fake update on interface change) since that's where LoginID reads the test approach | all of the above | the track's README | A cold reader can tell what runs vs. what's a stub without asking | 28 29 ## 2. Hire roster — 4 hires (suggested cast from `CASTING.md`, adopted as-is) 30 31 All four: **model sonnet** (planning/design/implementation tier per `planning-approach.md`; 32 opus is reserved for the connector token-lifecycle *implementation* seat in a later phase, not 33 planning — none of these four need it now). No hire spawns subagents; no CLAUDE.md marker; 34 profile-gen text-first, after "hiring go". 35 36 **Oren Castellan — Detail Hawk, code reviewer.** *Function:* second-pass review on DAO/handler/connector Go for error semantics, nullability, off-by-one — the review-seat Renata asked for on her own output, plus the independent pass 02 called for on security-graded surfaces. *Tags:* serious, cautious. *Pattern/role:* rotating devil's advocate seat (implementation calls); second-pass reviewer on S3/S4. 37 38 *Persona:* Meticulous and understated; in review he goes quiet, then produces a numbered list nobody else caught. Decides by tracing every input to its type and zero value before trusting a code path. Pushes back on "the happy path handles it" and on errors swallowed with `_`. Eight years reviewing Go services at a logistics company, two more doing contract review for a fintech's PCI-scoped repos. Deep in `go vet`/`staticcheck`, table-driven tests, and nil-vs-empty-slice distinctions. Blind spot: he can spend an hour on a rare nullability edge case while missing that the function solves the wrong problem — pair him with someone who checks the solution's shape first. In disagreement he stays procedural, names the specific line and failure, and drops it once satisfied. (129 words) 39 40 **Nolan Reyes — Veteran, ops/migrations/token-lifecycle sanity.** *Function:* pattern-matches implementation and layout decisions against real production failure modes; pessimist hat in the Go-layout three-hats run. *Tags:* serious, cautious. *Pattern/role:* three-hats pessimist (Go layout); rotating devil's advocate participant. 41 42 *Persona:* Dry and unhurried; opens reviews with what broke last time he saw this pattern in production. Decides from incident history more than documentation. Pushes back on any "this will just work" claim about retries, timeouts, or token refresh under load. Eleven years in platform ops — six at a regional bank's card-issuing platform, five running SRE for a logistics SaaS — paged once for an expired-token cascade and once for a migration that locked a table for forty minutes; never forgot either. Deep in Go's `context` package, connection pooling, and graceful shutdown. Blind spot: he over-indexes on failures he personally lived through and under-weights new ones. Argues by scenario, not principle, and concedes fast when shown a failure mode he hasn't seen. (134 words) 43 44 **Marisol Ferran — Enthusiast, Renata's temperament opposite (required).** *Function:* pushes for trying the promising-but-unproven tool (codegen, generics) rather than the safe default; optimist hat in three-hats. *Tags:* playful, bold. *Pattern/role:* three-hats optimist (Go layout); counterweight voice on S2's driver-abstraction choice. 45 46 *Persona:* Bright and quick to say "let's just try it" before the room finishes weighing options; energized by tools that remove boilerplate. Decides by prototyping fast and showing the result rather than arguing it abstractly. Pushes back on "we've always done it this way" and on process that delays the first line of code by a week. Four years building internal tools at a logistics startup, two more at a small dev-tools shop evaluating codegen and ORM options for clients. Comfortable with `sqlc`, Go generics, and OpenAPI-driven scaffolding. Blind spot: she underweights the years-long operational cost of a clever tool and can talk a team into a dependency nobody wants to own. In disagreement she stays upbeat, offers to build the smaller version on the spot, and yields once the maintenance cost is spelled out. (141 words) 47 48 **Ines Dabrowski — Systems Cartographer, Go layout / service topology.** *Function:* owns the diagramming behind the Service boundaries decision below; draws the package/dependency map before anyone commits to prose. *Tags:* serious, bold. *Pattern/role:* drafts the Service boundaries doc (§4); non-hat contributor to three-hats as tie-break if optimist/pessimist stall. 49 50 *Persona:* Calm and visual; sketches a box-and-arrow diagram before committing an opinion to words. Decides by mapping every boundary and dependency first, then asking what crosses it and why. Pushes back on two services sharing a package for convenience rather than a real shared concern. Seven years as a platform engineer at a multi-tenant SaaS company, three designing service boundaries for a payments integration team. Strong on Go module layout, dependency direction, and where an interface should live versus where it's implemented. Blind spot: she can over-abstract a boundary that would have been fine as one package at this project's size, mistaking cleanliness for necessity. In disagreement she draws the alternative rather than argues it, and updates the diagram in front of the room when persuaded. (135 words) 51 52 Roster spans both required axes (serious/playful via Marisol; cautious/bold via Ines and 53 Marisol), includes Renata's required opposite (Marisol), and duplicates no archetype from 54 another track's *function* (Detail Hawk here is a code reviewer; 05's Detail Hawk is a DDL 55 reviewer, a different function — allowed per variance rule 2). 56 57 ## 3. Debate plan 58 59 - **Three hats — Go layout (one binary vs. two).** Marisol (optimist: ship one binary, less 60 ceremony) / Nolan (pessimist: two binaries, because a shared-everything binary is how a 61 card-issuing platform he worked on ended up with the connector's outbound vendor calls 62 taking down the client-facing API during an incident) / **Renata takes the pragmatist hat 63 herself** rather than hiring a fifth (catalog explicitly allows this) — she's the 64 Minimalist-leaning lead per `CASTING.md` §7. Ines drafts the resulting diagram either way. 65 Decision recorded in `decisions/go-layout-debate.md`. 66 - **Rotating devil's advocate — implementation calls.** Error semantics (wrap vs. sentinel 67 errors), context propagation into the DAO layer, test-double strategy (interface fakes vs. 68 generated mocks). Seat rotates Oren → Nolan → Marisol → Ines per decision so no one hire 69 becomes "the objector." Cheapest pattern; run on every non-trivial implementation call in 70 S2–S4. 71 72 *(Consistency-pass finding F47: this section named "Callum" as the pessimist/rotation-2 hire 73 through Phase 1 while the actual roster in §2 above was already "Nolan Reyes" — Callum 74 Reyes was renamed to clear a first-name collision with 04's Callum Ferreira before hiring; 75 this section simply hadn't been updated to match. Fixed above; no roster change.)* 76 - **Newcomer's-question pass on hand-offs — run by Renata herself, not a hired Newcomer.** 77 This track wasn't allocated a Newcomer seat (04 has one; hiring a second here would exceed 78 the intent of a 4-hire cap for marginal gain). Renata reads 05's `multi-db-strategy.md` and 79 02's receiver-shaped hand-offs cold, the moment they land, and lists anything she can't act 80 on without re-deriving the sender's reasoning — same test the pattern exists to run, just 81 performed by the actual receiver instead of a proxy. 82 - **Explicit waste:** the `/auth` and `/identity` endpoint paths and JSON bodies are fixed by 83 the assignment text — never debated. Red team/blue team is 02's pattern for the token 84 lifecycle's security properties, not this track's to re-run; 03 only debates *how* it 85 implements what 02 specifies (error handling, retries), never *whether* the scheme is right. 86 87 ## 4. Dependencies (and the Service boundaries output for 04) 88 89 **Split start**, consistent with `planning-approach.md` §2: S1 (scaffolding) starts as soon as 90 hiring completes — no upstream blocker. S2 (DAO) is blocked on 05's Go-shaped contract landing 91 *stable* (not polished — unlikely to be rewritten). S3's middleware is blocked on 02's 92 receiver-shaped auth hand-off; S3's route wiring and non-auth handler logic can start earlier. 93 S4 is blocked on 02's `connector-security.md` token-lifecycle spec, which already exists in 94 prose form — implementable now, refined if 02's deferred receiver-shaped version changes 95 anything. 96 97 **Service boundaries (written into root `PLANNING.md` alongside this plan):** 98 99 *This subsection is the Phase 1 snapshot (2026-09-12, before hiring). Root `PLANNING.md`'s 100 Service boundaries section is the current, authoritative version — it has since gained 101 `internal/app` (shared bootstrap, `decisions/go-layout-debate.md`), `DB_DSN_FILE` (02's 102 `handoff-04-secrets.md` S7), literal `AUTH_JWT_ISSUER`/`AUTH_JWT_AUDIENCE` values, and the 103 connector's own audience/client-credential variables (consistency-pass F15). Consult 104 `PLANNING.md`, not this snapshot, for what 04 or anyone else should build against.* 105 106 - **Two binaries**, not one: `cmd/api-service` (Q1 DAO + Q2 REST API, client-facing, bearer- 107 token auth) and `cmd/idp-connector` (Q3, outbound-only to vendors). Reasoning: different 108 threat models and auth surfaces per 02's track, independent scaling/deploy needs, and it 109 mirrors the assignment's own Q2/Q3 split rather than inventing a new boundary. 110 - **Package layout:** 111 ``` 112 cmd/api-service/main.go 113 cmd/idp-connector/main.go 114 internal/dao/ # Repository interface + postgres/cockroachdb/sqlite implementations 115 internal/model/ # shared structs: UserProfile, UserCredential 116 internal/api/ # REST handlers, router, auth middleware 117 internal/connector/ # /auth, /identity client + handlers 118 internal/config/ # env-var config loading, shared by both binaries 119 ``` 120 - **Config surface:** environment variables only (12-factor, container-friendly for 04) — 121 `DB_DRIVER` (postgres|cockroachdb|sqlite), `DB_DSN`, `HTTP_ADDR`, `AUTH_JWT_ISSUER` / 122 `AUTH_JWT_AUDIENCE` (names pending 02's final scheme), `IDP_ABC_BASE_URL`, 123 `IDP_ABC_CLIENT_ID` / `IDP_ABC_CLIENT_SECRET`. No flags, no config files. 124 - **DAO driver-selection mechanism:** a factory `dao.New(driver, dsn string) (dao.Repository, error)` 125 chosen at startup from `DB_DRIVER`; every backend satisfies one `Repository` interface 126 (exact method signatures finalized once 05's contract lands — the factory *shape* is stable 127 now, its return type's method set is not). 128 - **What 04 may treat as stable:** the two-binary split, the `cmd/` entrypoint names, the 129 env-var config approach and the variable names above, and the `dao.New(driver, dsn)` factory 130 signature. **Not yet stable:** internal DAO implementation details, ORM/query-builder choice, 131 and handler-package internals — those can still shift as 05's and 02's hand-offs land. 132 133 ## Amendment: QA function (2026-09-12, Warren's agile-loop go-ahead) 134 135 **Oren Castellan leads QA** (unit, integration, and the end-to-end/UX acceptance tests written from the PO's review script); **Nolan Reyes supports**. 02's independent second review still applies on top of this for every `security-graded` story — QA and 02's review are not the same gate. 136 137 ## Verification 138 139 - `PLAN.md` for this track matches this file verbatim once copied. 140 - `PLANNING.md` row 03 updated to "plan drafted — awaiting hiring go"; Service boundaries 141 section replaces its "TBD" with the content in §4 above. 142 - No `.go`, `.sql`, `go.mod`, or agent-definition files exist yet — only prose changed. 143 - Roster (4 hires) checked against `CASTING.md` variance rules before messaging team-lead: 144 no archetype repeated within this team; Renata's required opposite (Enthusiast) present; 145 two temperament axes spanned; no first name collides with any lead. 146
{
"command": "find /Users/warrenthompson/Source/LoginID/03-engineering-delivery/profiles/nolan-reyes -maxdepth 1"
}/Users/warrenthompson/Source/LoginID/03-engineering-delivery/profiles/nolan-reyes /Users/warrenthompson/Source/LoginID/03-engineering-delivery/profiles/nolan-reyes/nolan-reyes.png /Users/warrenthompson/Source/LoginID/03-engineering-delivery/profiles/nolan-reyes/nolan-reyes.md
{
"command": "gh pr diff 30 --repo wtvamp/loginid-takehome > /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30.diff 2>&1; wc -l /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30.diff"
}2601 /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30.diff
{
"command": "grep -n \"^diff --git\" /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30.diff"
}1:diff --git a/cmd/api-service/main.go b/cmd/api-service/main.go 57:diff --git a/go.mod b/go.mod 69:diff --git a/go.sum b/go.sum 82:diff --git a/internal/api/audit.go b/internal/api/audit.go 102:diff --git a/internal/api/errors.go b/internal/api/errors.go 122:diff --git a/internal/api/grantlimiter.go b/internal/api/grantlimiter.go 310:diff --git a/internal/api/grantlimiter_test.go b/internal/api/grantlimiter_test.go 501:diff --git a/internal/api/handlers.go b/internal/api/handlers.go 522:diff --git a/internal/api/jwks.go b/internal/api/jwks.go 915:diff --git a/internal/api/jwks_test.go b/internal/api/jwks_test.go 1467:diff --git a/internal/api/jwtmiddleware.go b/internal/api/jwtmiddleware.go 1716:diff --git a/internal/api/jwtmiddleware_test.go b/internal/api/jwtmiddleware_test.go 2075:diff --git a/internal/api/stopgap_authorizer.go b/internal/api/stopgap_authorizer.go 2134:diff --git a/internal/api/stopgap_authorizer_test.go b/internal/api/stopgap_authorizer_test.go 2210:diff --git a/internal/app/verifier_router.go b/internal/app/verifier_router.go 2306:diff --git a/internal/app/verifier_router_test.go b/internal/app/verifier_router_test.go 2563:diff --git a/internal/config/config.go b/internal/config/config.go
{
"command": "cd /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad && rm -rf pr30repo && git clone --quiet «email»:wtvamp/loginid-takehome.git pr30repo 2>&1 | tail -5 && cd pr30repo && git fetch origin pull/30/head:pr30 --quiet && git checkout --quiet pr30 && echo OK && git log -1 --format=%H"
}OK a615dfa65416b9b77ffa8077ad6a989ba271d0cb
{
"file_path": "/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks.go"
}1 // jwks.go implements a minimal RFC 7517 JSON Web Key Set client: fetch,
2 // parse RSA public keys, cache with a short TTL. handoff-03-auth.md v4:
3 // "Public-key distribution for the verifier ... JWKS served by the issuer
4 // Deployment, reachable only in-cluster via its own ClusterIP Service ...
5 // Verifier caches the fetched key set in memory with a short TTL (matching
6 // token TTL is reasonable) to avoid a JWKS fetch on every single
7 // verification."
8 package api
9
10 import (
11 "context"
12 "crypto/rsa"
13 "encoding/base64"
14 "encoding/json"
15 "errors"
16 "fmt"
17 "io"
18 "log"
19 "math/big"
20 "net/http"
21 "sync"
22 "time"
23 )
24
25 // jwk is one entry in a JWKS response — only the fields this verifier
26 // needs to reconstruct an RSA public key (RFC 7517 §4, RFC 7518 §6.3.1).
27 // Fields this verifier doesn't use (x5c, x5t, ...) are simply not
28 // unmarshaled; unknown fields in the source JSON are not an error.
29 type jwk struct {
30 Kty string `json:"kty"`
31 Kid string `json:"kid"`
32 Alg string `json:"alg"`
33 Use string `json:"use"`
34 N string `json:"n"` // base64url, unpadded — the RSA modulus
35 E string `json:"e"` // base64url, unpadded — the RSA public exponent
36 }
37
38 type jwksResponse struct {
39 Keys []jwk `json:"keys"`
40 }
41
42 // parseJWKS decodes a JWKS JSON document into a map of kid -> public key.
43 // Any key with kty != "RSA" is skipped (not an error) — a future non-RSA
44 // key in the set (e.g. during an algorithm migration) shouldn't break
45 // verification of tokens signed with the RSA keys that ARE present.
46 func parseJWKS(data []byte) (map[string]*rsa.PublicKey, error) {
47 var resp jwksResponse
48 if err := json.Unmarshal(data, &resp); err != nil {
49 return nil, fmt.Errorf("api: parsing JWKS: %w", err)
50 }
51 keys := make(map[string]*rsa.PublicKey, len(resp.Keys))
52 for _, k := range resp.Keys {
53 if k.Kty != "RSA" {
54 continue
55 }
56 if k.Kid == "" {
57 return nil, fmt.Errorf("api: JWKS RSA key missing kid")
58 }
59 pub, err := rsaPublicKeyFromJWK(k)
60 if err != nil {
61 return nil, fmt.Errorf("api: JWKS key %q: %w", k.Kid, err)
62 }
63 keys[k.Kid] = pub
64 }
65 return keys, nil
66 }
67
68 func rsaPublicKeyFromJWK(k jwk) (*rsa.PublicKey, error) {
69 nBytes, err := base64.RawURLEncoding.DecodeString(k.N)
70 if err != nil {
71 return nil, fmt.Errorf("decoding n: %w", err)
72 }
73 eBytes, err := base64.RawURLEncoding.DecodeString(k.E)
74 if err != nil {
75 return nil, fmt.Errorf("decoding e: %w", err)
76 }
77 n := new(big.Int).SetBytes(nBytes)
78 e := new(big.Int).SetBytes(eBytes)
79 if !e.IsInt64() {
80 return nil, fmt.Errorf("exponent out of range")
81 }
82 return &rsa.PublicKey{N: n, E: int(e.Int64())}, nil
83 }
84
85 // KeySource resolves a kid to the RSA public key that should verify a
86 // token carrying it. JWKSCache is the real implementation; tests use a
87 // map-backed fake. ctx carries the calling request's own deadline —
88 // KeyForKid's real implementation must bound its network I/O by it, not
89 // by some separate, undocumented timeout (Nolan Reyes, PR #30 review: a
90 // hung fetch that ignores the caller's context defeats the deadline
91 // middleware's whole guarantee).
92 type KeySource interface {
93 KeyForKid(ctx context.Context, kid string) (*rsa.PublicKey, error)
94 }
95
96 // ErrJWKSStale is returned by JWKSCache.KeyForKid when the cached key set
97 // has exceeded its max-staleness bound and could not be refreshed — the
98 // verifier must fail closed rather than trust keys this old (Tomasz
99 // Wrede, 02 cold review; PM ruling). Exported so NewJWTMiddleware can log
100 // a distinct audit event (AuditJWKSUnavailable) for this specific
101 // failure mode, rather than folding it into an ordinary auth failure.
102 var ErrJWKSStale = errors.New("api: JWKS cache exceeded max staleness and could not be refreshed")
103
104 // jwksMaxStalenessMultiple and jwksUnknownKidRefetchInterval are the
105 // concrete numbers the PM ruled on for Tomasz Wrede's two findings:
106 // - a signing key can be revoked BECAUSE it's compromised; if the JWKS
107 // endpoint is also unreachable during that same incident, a
108 // stale-cache-forever fallback would keep verifying tokens signed by
109 // the revoked key for as long as fetches keep failing. Bounding
110 // staleness at a multiple of the normal refresh interval (ttl) turns
111 // "fail open forever" into "fail open for a bounded window, then
112 // fail closed" — resilient to a brief blip, not to an extended one.
113 // - an unknown kid could be a key the issuer rotated in since the last
114 // TTL-driven refresh; without an out-of-band refetch, a freshly
115 // rotated key would be rejected for up to a full TTL. Rate-limited
116 // so an unknown-kid flood can't be used to hammer the issuer's JWKS
117 // endpoint.
118 const (
119 jwksMaxStalenessMultiple = 3
120 jwksUnknownKidRefetchInterval = 30 * time.Second
121
122 // jwksMinRefreshRetryInterval floors how often a TTL-expired cache
123 // with a just-failed refresh will attempt another real network
124 // fetch. Without this, every single request during a sustained
125 // issuer outage triggers its own fetch attempt for as long as the
126 // outage lasts (up to maxStaleness) — the same "don't hammer a
127 // struggling dependency" reasoning already applied to the
128 // unknown-kid path, missing from the ordinary refresh path (Oren
129 // Castellan, PR #30 re-review). Short relative to ttl/maxStaleness:
130 // this only throttles retries during an active failure, it must not
131 // delay picking up a healthy issuer again once it recovers.
132 jwksMinRefreshRetryInterval = 5 * time.Second
133
134 // jwksMaxTrackedUnknownKids bounds how many distinct kids can hold an
135 // outstanding unknown-kid retry reservation at once. Without this,
136 // keying the reservation per-kid (see reserveUnknownKidRetry) reopens
137 // its own version of the same map-growth concern a flood of DISTINCT
138 // garbage kids would create: capped here, so an attacker sending many
139 // different fabricated kids can force at most this many extra
140 // fetches per jwksUnknownKidRefetchInterval, not one per distinct
141 // value they bother to send.
142 jwksMaxTrackedUnknownKids = 64
143 )
144
145 // JWKSCache fetches a JWKS document from url and caches the parsed key
146 // set for ttl, refetching only after it expires — "to avoid a JWKS fetch
147 // on every single verification" (handoff-03-auth.md v4). Supports at
148 // least two concurrently valid kids during a rotation overlap window by
149 // construction: it caches the WHOLE key set the issuer publishes, not
150 // just the most recent key, so an old and a new key both verify
151 // successfully for as long as the issuer's own JWKS response lists both.
152 type JWKSCache struct {
153 url string
154 ttl time.Duration
155 maxStaleness time.Duration
156 httpClient *http.Client
157 now func() time.Time
158
159 mu sync.Mutex
160 keys map[string]*rsa.PublicKey
161 fetchedAt time.Time // last SUCCESSFUL fetch
162 lastAttempt time.Time // last fetch ATTEMPT, success or failure
163 consecutiveFailures int
164 staleAlerted bool
165 unknownKidRetryAt map[string]time.Time // per-kid, not global — see reserveUnknownKidRetry
166 }
167
168 // defaultJWKSClientTimeout backstops a hung fetch (a connection that
169 // accepts but never responds — not a hard refusal, which fails fast on
170 // its own) when no context deadline is shorter. Distinct from and
171 // independent of a per-request context deadline: this fires even for a
172 // call that somehow reaches fetch() with no deadline on its context at
173 // all, which the http.Client.Timeout field guards against regardless of
174 // context (Nolan Reyes, PR #30 review — the shipped wiring passed nil
175 // for httpClient, resolving to http.DefaultClient, whose zero-value
176 // Timeout means "none").
177 const defaultJWKSClientTimeout = 10 * time.Second
178
179 // NewJWKSCache constructs a cache fetching from url, refetching at most
180 // once per ttl (and, for an unrecognized kid specifically, at most once
181 // per jwksUnknownKidRefetchInterval outside the normal TTL cycle). A nil
182 // httpClient constructs one with defaultJWKSClientTimeout — never
183 // http.DefaultClient, whose Timeout is unset (no bound at all) by
184 // default. maxStaleness is jwksMaxStalenessMultiple * ttl.
185 func NewJWKSCache(url string, ttl time.Duration, httpClient *http.Client) *JWKSCache {
186 if httpClient == nil {
187 httpClient = &http.Client{Timeout: defaultJWKSClientTimeout}
188 }
189 return &JWKSCache{
190 url: url,
191 ttl: ttl,
192 maxStaleness: jwksMaxStalenessMultiple * ttl,
193 httpClient: httpClient,
194 now: time.Now,
195 }
196 }
197
198 // KeyForKid never holds c.mu across a network fetch (Nolan Reyes, PR #30
199 // review, finding #2): the prior shape held the lock for the whole
200 // function body, so one hung fetch stalled every other concurrent
201 // request through this same cache instance — i.e. every authenticated
202 // request the verifying Deployment was serving, not just the one that
203 // triggered the refresh. Concurrent callers that both decide a refresh
204 // is due may both fetch; that's cheap, occasional duplicate work, and far
205 // preferable to serializing the whole authenticated surface behind one
206 // goroutine's network call.
207 func (c *JWKSCache) KeyForKid(ctx context.Context, kid string) (*rsa.PublicKey, error) {
208 c.mu.Lock()
209 needsRefresh := c.keys == nil || c.now().Sub(c.fetchedAt) >= c.ttl
210 canAttempt := c.now().Sub(c.lastAttempt) >= jwksMinRefreshRetryInterval
211 c.mu.Unlock()
212
213 if needsRefresh {
214 if canAttempt {
215 if err := c.refresh(ctx); err != nil {
216 return nil, err
217 }
218 } else if err := c.enforceStaleness(); err != nil {
219 // Backing off from a very recent failed attempt (see
220 // jwksMinRefreshRetryInterval) — no new network call this
221 // time, but the staleness ceiling must still be enforced
222 // against the existing cache regardless of whether this
223 // particular call was the one that tried to refresh it.
224 return nil, err
225 }
226 }
227
228 if key, ok := c.lookupKey(kid); ok {
229 return key, nil
230 }
231
232 // Unknown kid: might be a key the issuer rotated in since the last
233 // TTL-driven refresh. One rate-limited out-of-band refetch before
234 // giving up, so a freshly-rotated key isn't rejected for up to a
235 // full TTL (Tomasz Wrede, 02 cold review). Best-effort: its error is
236 // deliberately ignored here — the outcome that matters is whether
237 // the retry populated the kid we're actually looking for, and a
238 // refresh() failure here has already been handled (logged / staleness
239 // tracked) inside refresh() itself.
240 if c.reserveUnknownKidRetry(kid) {
241 _ = c.refresh(ctx)
242 if key, ok := c.lookupKey(kid); ok {
243 return key, nil
244 }
245 }
246
247 return nil, fmt.Errorf("api: no key found for kid %q", kid)
248 }
249
250 func (c *JWKSCache) lookupKey(kid string) (*rsa.PublicKey, bool) {
251 c.mu.Lock()
252 defer c.mu.Unlock()
253 k, ok := c.keys[kid]
254 return k, ok
255 }
256
257 // reserveUnknownKidRetry reports whether an unknown-kid-triggered refetch
258 // may proceed now for THIS specific kid, and if so atomically marks one
259 // as just having started. Keyed per kid, not by one global timestamp
260 // (Ingrid Solano, 02 cold re-check): KeyForKid runs before signature
261 // verification, so an unauthenticated caller can send a token with a
262 // fabricated kid at no cost — a single global gate lets that caller
263 // permanently occupy the one reservation slot by repeating it every
264 // jwksUnknownKidRefetchInterval, pushing a legitimately-rotated real
265 // key's own refetch back to the full calendar-TTL rollover, silently
266 // recreating most of the original gap this mechanism exists to close.
267 // Per-kid closes that: a garbage kid's repeated reservation never blocks
268 // a DIFFERENT (real) kid's own reservation. jwksMaxTrackedUnknownKids
269 // caps how many distinct kids can hold a reservation at once, so a flood
270 // of distinct fabricated kids still can't hammer the issuer past that
271 // bound — rate-limiting is scoped per-kid, not removed.
272 func (c *JWKSCache) reserveUnknownKidRetry(kid string) bool {
273 c.mu.Lock()
274 defer c.mu.Unlock()
275
276 if c.unknownKidRetryAt == nil {
277 c.unknownKidRetryAt = make(map[string]time.Time)
278 }
279 if last, ok := c.unknownKidRetryAt[kid]; ok && c.now().Sub(last) < jwksUnknownKidRefetchInterval {
280 return false
281 }
282
283 // Sweep expired entries before checking the size cap, so a kid
284 // that's aged out of its own window doesn't count against another
285 // kid's chance to reserve.
286 for k, t := range c.unknownKidRetryAt {
287 if c.now().Sub(t) >= jwksUnknownKidRefetchInterval {
288 delete(c.unknownKidRetryAt, k)
289 }
290 }
291 if len(c.unknownKidRetryAt) >= jwksMaxTrackedUnknownKids {
292 // At capacity with distinct in-flight-window kids — deny this
293 // one rather than let the map grow further. The ordinary
294 // TTL-driven refresh still eventually picks up a real rotated
295 // key regardless of this outcome.
296 return false
297 }
298 c.unknownKidRetryAt[kid] = c.now()
299 return true
300 }
301
302 // refresh performs the network fetch (no lock held during it) and
303 // updates cache state. Returns an error only when the caller must fail
304 // the whole verification: no cache exists yet (cold start against an
305 // unreachable issuer), or the existing cache has exceeded maxStaleness —
306 // wrapped in ErrJWKSStale in the latter case specifically, so the
307 // middleware can log AuditJWKSUnavailable rather than an ordinary auth
308 // failure. A transient failure within the staleness bound returns nil:
309 // the stale cache is still good enough to use, per the resilience this
310 // mechanism exists for.
311 func (c *JWKSCache) refresh(ctx context.Context) error {
312 c.mu.Lock()
313 c.lastAttempt = c.now()
314 c.mu.Unlock()
315
316 fresh, err := c.fetch(ctx)
317
318 c.mu.Lock()
319 if err == nil {
320 c.keys = fresh
321 c.fetchedAt = c.now()
322 c.consecutiveFailures = 0
323 c.staleAlerted = false
324 c.mu.Unlock()
325 return nil
326 }
327 c.consecutiveFailures++
328 noCache := c.keys == nil
329 c.mu.Unlock()
330
331 if noCache {
332 return err
333 }
334 return c.enforceStaleness()
335 }
336
337 // enforceStaleness checks the existing cache against maxStaleness and
338 // fails closed (ErrJWKSStale) if it's been exceeded — factored out of
339 // refresh() so the same check applies on a call that skips an actual
340 // network attempt because jwksMinRefreshRetryInterval hasn't elapsed yet
341 // (Oren Castellan, PR #30 re-review: without this, backing off from
342 // hammering a struggling issuer would also silently suspend the
343 // staleness ceiling for however long the backoff lasts).
344 func (c *JWKSCache) enforceStaleness() error {
345 c.mu.Lock()
346 defer c.mu.Unlock()
347 if c.keys == nil {
348 return errors.New("api: JWKS cache not yet populated")
349 }
350 staleSince := c.now().Sub(c.fetchedAt)
351 if staleSince > c.maxStaleness {
352 if !c.staleAlerted {
353 c.staleAlerted = true
354 // Log line for 04's alerting pipeline on a prolonged
355 // fetch-failure run — not a policy decision (AuditLogger is
356 // for those), an operational signal that this process's own
357 // key infrastructure is degraded.
358 log.Printf("api: JWKS unrefreshable for %s across %d consecutive failures (exceeds max staleness %s) — failing closed",
359 staleSince, c.consecutiveFailures, c.maxStaleness)
360 }
361 return fmt.Errorf("%w: stale for %s across %d consecutive failures", ErrJWKSStale, staleSince, c.consecutiveFailures)
362 }
363 return nil
364 }
365
366 func (c *JWKSCache) fetch(ctx context.Context) (map[string]*rsa.PublicKey, error) {
367 req, err := http.NewRequestWithContext(ctx, http.MethodGet, c.url, nil)
368 if err != nil {
369 return nil, fmt.Errorf("api: building JWKS request for %s: %w", c.url, err)
370 }
371 resp, err := c.httpClient.Do(req)
372 if err != nil {
373 return nil, fmt.Errorf("api: fetching JWKS from %s: %w", c.url, err)
374 }
375 defer func() { _ = resp.Body.Close() }()
376 if resp.StatusCode != http.StatusOK {
377 return nil, fmt.Errorf("api: fetching JWKS from %s: status %d", c.url, resp.StatusCode)
378 }
379 // 1MiB ceiling — a JWKS response is a handful of RSA keys, never
380 // this large; capped so a misbehaving/compromised issuer endpoint
381 // can't force this process to buffer an unbounded response body.
382 body, err := io.ReadAll(io.LimitReader(resp.Body, 1<<20))
383 if err != nil {
384 return nil, fmt.Errorf("api: reading JWKS response: %w", err)
385 }
386 return parseJWKS(body)
387 }
388 {
"command": "grep -rn \"NewJWKSCache\\|jwksTTL\\|JWKS_TTL\\|ttl\" /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwtmiddleware.go /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/cmd/api-service/main.go /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/config/config.go"
}(Bash completed with no output)
{
"command": "grep -rn \"NewJWKSCache\" /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo --include=*.go"
}(eval):1: no matches found: --include=*.go
{
"command": "grep -rn \"NewJWKSCache\" /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo"
}/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/app/verifier_router.go:42: keys := api.NewJWKSCache(cfg.AuthJWKSURL, jwksCacheTTL, nil)
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:127: cache := NewJWKSCache(srv.URL, time.Hour, nil)
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:154: cache := NewJWKSCache(srv.URL, time.Minute, nil)
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:183: cache := NewJWKSCache(srv.URL, time.Hour, nil)
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:201: cache := NewJWKSCache(s.srv.URL, time.Minute, nil) // maxStaleness = 3*ttl = 3min
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:232: cache := NewJWKSCache(s.srv.URL, time.Minute, nil) // maxStaleness = 3min
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:284: cache := NewJWKSCache(srv.URL, time.Hour, nil)
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:317: cache := NewJWKSCache(srv.URL, time.Hour, nil)
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:361: cache := NewJWKSCache(s.srv.URL, time.Minute, nil) // maxStaleness = 3min, min retry floor = 5s
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:428: cache := NewJWKSCache(s.srv.URL, time.Minute, nil) // maxStaleness = 3min
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:489: cache := NewJWKSCache(srv.URL, time.Hour, nil)
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks_test.go:530: cache := NewJWKSCache(srv.URL, time.Hour, nil)
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks.go:179:// NewJWKSCache constructs a cache fetching from url, refetching at most
/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/api/jwks.go:185:func NewJWKSCache(url string, ttl time.Duration, httpClient *http.Client) *JWKSCache {{
"command": "cd /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo && cat cmd/api-service/main.go"
}// Command api-service is the client-facing binary (Q1 DAO + Q2 REST API,
// bearer-token auth). Per decisions/go-layout-debate.md, this file is a
// thin wrapper — route registration and config loading live in
// internal/app and internal/config, not here.
package main
import (
"log"
"net/http"
"loginid-takehome/internal/app"
"loginid-takehome/internal/config"
"loginid-takehome/internal/dao"
_ "loginid-takehome/internal/dao/postgres" // registers "postgres" and "cockroachdb"
_ "loginid-takehome/internal/dao/sqlite" // registers "sqlite"
)
func main() {
cfg, err := config.Load()
if err != nil {
log.Fatalf("api-service: loading config: %v", err)
}
addr := cfg.HTTPAddr
if addr == "" {
addr = ":8080"
}
log.Printf("api-service: mode=%s listening on %s", cfg.AppMode, addr)
var handler http.Handler
switch app.Mode(cfg.AppMode) {
case app.ModeVerifier:
// The verifying Deployment is the one that talks to the
// database (LT-39's search/retrieve handlers) — the issuer
// Deployment (below) never needs a Repository at all, since it
// only mints tokens.
//
// A failure here does NOT Fatal: on a cluster where the database
// doesn't exist yet (no DB_DRIVER/DB_DSN configured — e.g. before
// PR #29's Postgres StatefulSet lands), or DB_DRIVER is simply
// misconfigured, this process must still come up and serve
// /healthz rather than crash-loop the whole verifying Deployment
// over a dependency only two of its routes need. repo stays nil;
// NewVerifierRouter fails those two routes closed with 503
// instead of panicking on a nil Repository.
repo, err := dao.New(cfg.DBDriver, cfg.DBDSN)
if err != nil {
log.Printf("api-service: opening DAO repository: %v — /profiles/search and /profiles/{id} will return 503 until this is resolved", err)
repo = nil
}
handler = app.NewVerifierRouter(cfg, repo)
default:
// ModeIssuer (and the unrecognized-mode fallback, which
// NewRouter itself already logs loudly and treats as verifier —
// see app.NewRouter's own doc comment) don't need the full
// verifier stack; NewRouter's existing /auth/token placeholder
// (LT-32) and /healthz cover both.
handler = app.NewRouter("api-service", app.Mode(cfg.AppMode))
}
if err := http.ListenAndServe(addr, handler); err != nil {
log.Fatalf("api-service: %v", err)
}
}{
"file_path": "/private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo/internal/app/verifier_router.go"
}1 package app
2
3 import (
4 "net/http"
5 "time"
6
7 "loginid-takehome/internal/api"
8 "loginid-takehome/internal/config"
9 "loginid-takehome/internal/dao"
10 )
11
12 // jwksCacheTTL matches the token TTL per handoff-03-auth.md v4's own
13 // guidance ("Verifier caches the fetched key set in memory with a short
14 // TTL (matching token TTL is reasonable)") — using the upper bound of the
15 // 5-15 minute TTL range so a cache refresh never fires more often than a
16 // token itself could have already expired and been re-issued.
17 const jwksCacheTTL = 15 * time.Minute
18
19 // NewVerifierRouter builds api-service's real, authenticated router —
20 // LT-39's handlers (search/retrieve) wired behind LT-40's JWT
21 // verification middleware, plus /healthz. This is the ModeVerifier
22 // Deployment's router; the issuer Deployment (ModeIssuer) still uses the
23 // plain NewRouter above, since it has no need for any of this — it never
24 // verifies inbound tokens, only issues them.
25 //
26 // repo may be nil — cmd/api-service/main.go passes nil rather than
27 // crash-looping the whole process when the DAO repository couldn't be
28 // constructed at startup (no DB_DRIVER/DB_DSN yet, e.g. before the
29 // database exists in this environment). /healthz must stay reachable
30 // regardless (LT-34's live-URL story; LT-52 is what teaches /healthz to
31 // actually report DB status, not this function); the two protected
32 // routes fail closed with 503 instead of panicking on a nil Repository
33 // or silently pretending to work. This is a startup-shape decision, not
34 // an ongoing health check — a repo that stops answering after a
35 // successful open is /healthz's job to surface (LT-52), not this
36 // router's.
37 func NewVerifierRouter(cfg config.Config, repo dao.Repository) http.Handler {
38 mux := http.NewServeMux()
39 mux.HandleFunc("/healthz", healthHandler("api-service"))
40
41 auditLog := api.StdoutAuditLogger{}
42 keys := api.NewJWKSCache(cfg.AuthJWKSURL, jwksCacheTTL, nil)
43 authMiddleware := api.NewJWTMiddleware(keys, cfg.AuthJWTIssuer, cfg.AuthJWTAudience, auditLog)
44
45 // api.NewDeadlineMiddleware outermost: the deadline budget must cover
46 // JWT verification (including a JWKS cache-miss fetch) as well as
47 // the handler's own DAO call, per decisions/context-propagation.md's
48 // ruling — a single deadline, not the middleware's and the handler's
49 // own disagreeing.
50 protect := func(h http.Handler) http.Handler {
51 return api.NewDeadlineMiddleware(authMiddleware(h))
52 }
53
54 var searchHandler, getHandler http.Handler
55 if repo == nil {
56 searchHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { api.WriteServiceUnavailable(w) })
57 getHandler = searchHandler
58 } else {
59 deps := api.Deps{
60 Repo: repo,
61 RateLimiter: api.NewInProcessRateLimiter(),
62 TouchCounter: api.NewInProcessTouchCounter(
63 api.TouchCapPerWindow, api.TouchCapWindow),
64 AuditLog: auditLog,
65 Authz: &api.StopgapAuthorizer{
66 ReadOwnAllow: stopgapReadOwnAllow(cfg),
67 },
68 }
69 searchHandler = api.NewSearchHandler(deps)
70 getHandler = api.NewGetProfileHandler(deps)
71 }
72
73 mux.Handle("POST /profiles/search", protect(searchHandler))
74 mux.Handle("GET /profiles/{id}", protect(getHandler))
75
76 return mux
77 }
78
79 // stopgapReadOwnAllow builds StopgapAuthorizer's hard-coded (sub ->
80 // allowed record id) map from cfg — empty (denies everything) unless
81 // both AuthzQASub and AuthzQAAllowedProfileID are set, which LT-51 does
82 // once the QA client credential and a matching seeded profile exist.
83 func stopgapReadOwnAllow(cfg config.Config) map[string]map[string]bool {
84 if cfg.AuthzQASub == "" || cfg.AuthzQAAllowedProfileID == "" {
85 return nil
86 }
87 return map[string]map[string]bool{
88 cfg.AuthzQASub: {cfg.AuthzQAAllowedProfileID: true},
89 }
90 }
91 {
"command": "cd /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo && git log --oneline -15 pr30"
}a615dfa fix: JWKS retry floor and per-kid unknown-kid reservation (round 3) 03181f6 fix: JWKS staleness/eviction/context-threading, startup fail-closed, review round 2 1150b98 LT-40: JWT verification middleware, live router wiring e5f7233 Merge PR #26: LT-39 REST handlers — search/retrieve user_profile with authz, masking, cursor, rate limit, audit log aacb633 fix: defer-based touch-reservation release, detached cleanup context (round 2) 33e2b45 Merge PR #27: paths filters (docs don't redeploy; image builds only on code paths); issuer NetworkPolicy for JWKS + ingress-nginx f93b19d fix: PR #26 review findings — touch-cap concurrency race, audit log, unknown-field rejection 44104a0 handoff-03-auth v4 (token issuance, JWKS); LT-40 refinement; LT-39 review record; LOG d19896d Restrict api-service-issuer's ingress to its two legitimate callers 9139d36 Skip image build/deploy on docs-only changes 31554fc Teardown trigger decided (Warren); PO review records for LT-32/LT-39/LT-45–47; LOG 7ff1e0f Merge PR #25: 05 docs — A6 amendment, §7 verification principle, checklist §G, migration R4a edccff0 Verification principle (contract §7), and migration immutability (checklist G, R4a) 68bae81 LT-39: REST handlers for search/retrieve user_profile (S6) 9bf2a5e LT-32 Done; 02 enforcement-site amendments; LOG
{
"command": "cd /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo && git diff 03181f6 a615dfa --stat"
}internal/api/jwks.go | 115 ++++++++++++++++++++++---- internal/api/jwks_test.go | 205 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 304 insertions(+), 16 deletions(-)
{
"command": "cd /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo && git diff 03181f6 a615dfa -- internal/api/jwks_test.go | head -250"
}diff --git a/internal/api/jwks_test.go b/internal/api/jwks_test.go
index 70d57b0..7f7a5e3 100644
--- a/internal/api/jwks_test.go
+++ b/internal/api/jwks_test.go
@@ -7,6 +7,7 @@ import (
"encoding/base64"
"encoding/json"
"errors"
+ "fmt"
"net/http"
"net/http/httptest"
"sync/atomic"
@@ -339,3 +340,207 @@ func TestJWKSCache_UnknownKidRefetchIsRateLimited(t *testing.T) {
t.Errorf("second unknown-kid lookup (within the rate-limit window) triggered an extra fetch: %d -> %d, want no change", afterFirstUnknown, afterSecondUnknown)
}
}
+
+// TestJWKSCache_FailedRefreshDoesNotHammerIssuer is Oren Castellan's PR
+// #30 re-review finding: without a floor on retry attempts, every single
+// request during a sustained issuer outage triggered its own network
+// fetch (bounded only by maxStaleness, not by request volume) — the same
+// "don't hammer a struggling dependency" reasoning already applied to the
+// unknown-kid path, missing from the ordinary TTL-refresh path. Multiple
+// KeyForKid calls in quick succession, all past TTL with the issuer down,
+// must make only one real fetch attempt per jwksMinRefreshRetryInterval.
+func TestJWKSCache_FailedRefreshDoesNotHammerIssuer(t *testing.T) {
+ key, err := rsa.GenerateKey(rand.Reader, 2048)
+ if err != nil {
+ t.Fatalf("generating key: %v", err)
+ }
+ body := jwksBody(t, "key-1", &key.PublicKey)
+ s := newJWKSTestServer(body)
+ defer s.Close()
+
+ cache := NewJWKSCache(s.srv.URL, time.Minute, nil) // maxStaleness = 3min, min retry floor = 5s
+ fakeNow := time.Now()
+ cache.now = func() time.Time { return fakeNow }
+ ctx := context.Background()
+
+ if _, err := cache.KeyForKid(ctx, "key-1"); err != nil {
+ t.Fatalf("priming: %v", err)
+ }
+
+ s.up.Store(false)
+ fakeNow = fakeNow.Add(time.Minute + time.Second) // TTL expired
+
+ var requestsBefore int32
+ // Read the server's own request counter via a second server field
+ // would require plumbing; instead assert indirectly: repeated calls
+ // within the retry floor must all return the SAME error quickly
+ // (served from enforceStaleness, not a fresh fetch attempt) — a real
+ // per-call fetch would each take however long the (down) server's
+ // connection refusal takes, which is fast here, so we assert on
+ // lastAttempt not advancing instead.
+ if _, err := cache.KeyForKid(ctx, "key-1"); err != nil {
+ t.Fatalf("first post-TTL call: %v", err)
+ }
+ cache.mu.Lock()
+ firstAttempt := cache.lastAttempt
+ cache.mu.Unlock()
+ _ = requestsBefore
+
+ fakeNow = fakeNow.Add(time.Second) // still within jwksMinRefreshRetryInterval (5s) of firstAttempt
+ if _, err := cache.KeyForKid(ctx, "key-1"); err != nil {
+ t.Fatalf("second post-TTL call (within retry floor): %v", err)
+ }
+ cache.mu.Lock()
+ secondAttempt := cache.lastAttempt
+ cache.mu.Unlock()
+
+ if !secondAttempt.Equal(firstAttempt) {
+ t.Errorf("a second call within jwksMinRefreshRetryInterval triggered a new fetch attempt (lastAttempt moved from %v to %v) — want it to back off and reuse the stale cache instead", firstAttempt, secondAttempt)
+ }
+
+ // Past the retry floor, a new attempt IS made.
+ fakeNow = fakeNow.Add(jwksMinRefreshRetryInterval)
+ if _, err := cache.KeyForKid(ctx, "key-1"); err != nil {
+ t.Fatalf("third post-TTL call (past retry floor): %v", err)
+ }
+ cache.mu.Lock()
+ thirdAttempt := cache.lastAttempt
+ cache.mu.Unlock()
+ if thirdAttempt.Equal(firstAttempt) {
+ t.Error("a call past jwksMinRefreshRetryInterval should have made a new fetch attempt")
+ }
+}
+
+// TestJWKSCache_StalenessEnforcedEvenWhenBackingOffFromRetry proves the
+// staleness ceiling isn't silently suspended while the retry floor is
+// skipping real fetch attempts — enforceStaleness must still fire once
+// maxStaleness is exceeded, even on a call that isn't itself attempting
+// a fetch.
+func TestJWKSCache_StalenessEnforcedEvenWhenBackingOffFromRetry(t *testing.T) {
+ key, err := rsa.GenerateKey(rand.Reader, 2048)
+ if err != nil {
+ t.Fatalf("generating key: %v", err)
+ }
+ body := jwksBody(t, "key-1", &key.PublicKey)
+ s := newJWKSTestServer(body)
+ defer s.Close()
+
+ cache := NewJWKSCache(s.srv.URL, time.Minute, nil) // maxStaleness = 3min
+ fakeNow := time.Now()
+ cache.now = func() time.Time { return fakeNow }
+ ctx := context.Background()
+
+ if _, err := cache.KeyForKid(ctx, "key-1"); err != nil {
+ t.Fatalf("priming: %v", err)
+ }
+ s.up.Store(false)
+
+ // One real attempt right after TTL expires, which fails and sets
+ // lastAttempt.
+ fakeNow = fakeNow.Add(time.Minute + time.Second)
+ _, _ = cache.KeyForKid(ctx, "key-1")
+
+ // Jump straight past maxStaleness (3min from the last SUCCESSFUL
+ // fetch), but still within jwksMinRefreshRetryInterval of the last
+ // ATTEMPT — this call must back off from a new fetch attempt and
+ // still correctly fail closed via enforceStaleness, not silently
+ // succeed with the stale cache because no new attempt was made.
+ fakeNow = fakeNow.Add(4 * time.Minute)
+ _, err = cache.KeyForKid(ctx, "key-1")
+ if err == nil {
+ t.Fatal("expected an error once past max staleness, even on a call that backs off from a new fetch attempt")
+ }
+ if !errors.Is(err, ErrJWKSStale) {
+ t.Errorf("error = %v, want ErrJWKSStale", err)
+ }
+}
+
+// TestJWKSCache_UnknownKidReservationIsPerKidNotGlobal is Ingrid
+// Solano's (02) cold re-check finding: KeyForKid runs before signature
+// verification, so an unauthenticated caller can send a token with a
+// fabricated kid at no cost. A single GLOBAL reservation gate would let
+// that caller occupy the one slot by repeating a garbage kid every
+// jwksUnknownKidRefetchInterval, starving a DIFFERENT, legitimately
+// rotated-in real kid's own refetch back to the full calendar TTL —
+// silently recreating most of the original gap. Reserving per kid closes
+// this: a garbage kid's own reservation must not block a different real
+// kid's reservation in the same window.
+func TestJWKSCache_UnknownKidReservationIsPerKidNotGlobal(t *testing.T) {
+ oldKey, err := rsa.GenerateKey(rand.Reader, 2048)
+ if err != nil {
+ t.Fatalf("generating key: %v", err)
+ }
+ newKey, err := rsa.GenerateKey(rand.Reader, 2048)
+ if err != nil {
+ t.Fatalf("generating key: %v", err)
+ }
+
+ var serveNewKey atomic.Bool
+ srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ w.Header().Set("Content-Type", "application/json")
+ if serveNewKey.Load() {
+ _, _ = w.Write(jwksBody(t, "key-new", &newKey.PublicKey))
+ } else {
+ _, _ = w.Write(jwksBody(t, "key-old", &oldKey.PublicKey))
+ }
+ }))
+ defer srv.Close()
+
+ cache := NewJWKSCache(srv.URL, time.Hour, nil)
+ ctx := context.Background()
+
+ if _, err := cache.KeyForKid(ctx, "key-old"); err != nil {
+ t.Fatalf("priming: %v", err)
+ }
+
+ // Attacker occupies the reservation for a garbage kid.
+ _, _ = cache.KeyForKid(ctx, "garbage-kid-from-attacker")
+ // Repeats it immediately — this must be denied (rate-limited), same
+ // as before the fix.
+ _, _ = cache.KeyForKid(ctx, "garbage-kid-from-attacker")
+
+ // The issuer rotates for real. A legitimate lookup for the new kid,
+ // in the SAME window the attacker's garbage kid already consumed,
+ // must still get its own reservation and succeed — not be starved by
+ // the attacker's unrelated kid.
+ serveNewKey.Store(true)
+ if _, err := cache.KeyForKid(ctx, "key-new"); err != nil {
+ t.Errorf("KeyForKid(key-new) = %v, want the real rotated key's own reservation to succeed regardless of an attacker's unrelated garbage-kid reservation", err)
+ }
+}
+
+// TestJWKSCache_UnknownKidReservationCapsDistinctKids is the other half
+// of Ingrid's ruling: rate-limiting is scoped per kid, not removed — a
+// flood of distinct fabricated kids must still be bounded, not each get
+// their own unconditional extra fetch.
+func TestJWKSCache_UnknownKidReservationCapsDistinctKids(t *testing.T) {
+ key, err := rsa.GenerateKey(rand.Reader, 2048)
+ if err != nil {
+ t.Fatalf("generating key: %v", err)
+ }
+ var requests atomic.Int32
+ body := jwksBody(t, "key-1", &key.PublicKey)
+ srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ requests.Add(1)
+ w.Header().Set("Content-Type", "application/json")
+ _, _ = w.Write(body)
+ }))
+ defer srv.Close()
+
+ cache := NewJWKSCache(srv.URL, time.Hour, nil)
+ ctx := context.Background()
+ if _, err := cache.KeyForKid(ctx, "key-1"); err != nil {
+ t.Fatalf("priming: %v", err)
+ }
+ requestsAfterPriming := requests.Load()
+
+ // Flood with more distinct garbage kids than jwksMaxTrackedUnknownKids.
+ for i := 0; i < jwksMaxTrackedUnknownKids+20; i++ {
+ _, _ = cache.KeyForKid(ctx, fmt.Sprintf("garbage-kid-%d", i))
+ }
+
+ extraFetches := requests.Load() - requestsAfterPriming
+ if int(extraFetches) > jwksMaxTrackedUnknownKids {
+ t.Errorf("a flood of %d distinct garbage kids triggered %d extra fetches, want at most %d (the cap)", jwksMaxTrackedUnknownKids+20, extraFetches, jwksMaxTrackedUnknownKids)
+ }
+}{
"command": "rm -rf /private/tmp/claude-501/-Users-warrenthompson-Source-LoginID-03-engineering-delivery/35c20edc-753d-4d96-b512-7114684706eb/scratchpad/pr30repo"
}(Bash completed with no output)