Skip to content

docs(ledger): record product decisions on upstream overlaps - #658

Merged
incognitojam merged 1 commit into
mainfrom
docs/ledger-product-decisions
Oct 7, 2026
Merged

incognitojam merged 1 commit into
mainfrom
docs/ledger-product-decisions

Conversation

@incognitojam

Copy link
Copy Markdown
Owner

Records the maintainer's decisions for four fork features where upstream now behaves differently, so the next intake and any agent touching these areas knows which way to go and why. Only .github/fork-features.yml changes.

Entry Decision
pull-request-linked-extras retiring. Take upstream's badge button and pull request tooltip (pingdotgg#13211 and the new orchestrator, pingdotgg#2829) and drop the fork's #102 +1 label and hover-card-only list.
server-restart-continuation-note Keep. The new orchestrator continues a restarted thread with a visible "Continue where you left off." message that starts a new response. The fork keeps its small note inside the interrupted response, and at that intake web and mobile draw the new message as the note.
server-update-guidance Keep waking threads whose background work was running when an in-app update restarted the server. pingdotgg#15604 leaves them asleep. A thread the user settles has nothing to wake, because settling stops its provider session.
workspace-thread-organization Keep worktree as the default (the current checkout when the repository has no commit). Once pingdotgg#12954 is taken in, this becomes styal's built-in last step after t3.json and project settings.

Each decision goes into the entry's rationale or retire_when, where intake reads it when resolving a conflict. The three kept entries return to maintained.

Verification

vp run --filter @t3tools/scripts ledger:check validates all 89 entries, and the file is formatted.


Written by an agent (Claude Code, claude-opus-5-5).

Record the maintainer's choices for four features where upstream now
behaves differently, so later intakes and agents know which way to go
and why.

- pull-request-linked-extras is retiring in favour of upstream's badge.
- server-restart-continuation-note keeps the fork's note and says how to
  draw the new orchestrator's continuation message.
- server-update-guidance keeps waking threads whose background work was
  running when an update restarted the server, and says why.
- workspace-thread-organization keeps the worktree default and records
  where it goes once upstream's workspace mode order is taken in.
@github-actions github-actions Bot added the size:S label Oct 7, 2026
@incognitojam
incognitojam merged commit c59d583 into main Oct 7, 2026
17 checks passed
@incognitojam
incognitojam deleted the docs/ledger-product-decisions branch October 7, 2026 15:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant