Skip to content

docs(adr): add A-11 — context-threading freeze and reduction plan#3423

Open
dimension-zero wants to merge 1 commit intogopasspw:masterfrom
dimension-zero:docs/adr-context-threading
Open

docs(adr): add A-11 — context-threading freeze and reduction plan#3423
dimension-zero wants to merge 1 commit intogopasspw:masterfrom
dimension-zero:docs/adr-context-threading

Conversation

@dimension-zero
Copy link
Copy Markdown
Contributor

Summary

pkg/ctxutil/ has grown to 30+ context keys threading config, terminal state, and credentials through the call stack. ARCHITECTURE.md acknowledges this as non-idiomatic. No architectural decision records what the project intends to do about it, so the pattern continues to expand without a policy boundary.

This PR adds docs/adr/A-11-context-threading.md which:

  • Documents the three risks: silent failures on wrong key type, credentials in context, and unchecked scope creep
  • Recommends a freeze (no new context keys after this ADR) as a zero-effort first step
  • Proposes a phased reduction plan (freeze → extract display-config struct → credential audit) that can be worked incrementally without a flag day

No code change. The ADR is a decision record, not an implementation.

Related issue: #3417

Test plan

  • Markdown renders correctly
  • ADR number A-11 does not conflict with existing docs/adr/ files (highest existing is A-10)

@dominikschulz
Copy link
Copy Markdown
Member

I think I have a pending branch somewhere that removes most of the context (ab)use already. I simply need to get it into shape and get it merged. I would leave this PR open as a reminder to finally do that, but I'm most likely not going to merge it.

Records the three risks from the pkg/ctxutil pattern (silent failures,
credentials-in-context, scope creep) and proposes a phased reduction:
freeze new keys first, then extract display-config struct, then audit
credential-adjacent keys. No code change.

Signed-off-by: dimension-zero <zero@ditech.ai>
@dimension-zero dimension-zero force-pushed the docs/adr-context-threading branch from 1522ab6 to 3c1f108 Compare May 5, 2026 08:50
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.

2 participants