docs: Record agent learnings in AGENTS.md #8

Closed
hijynx wants to merge 1 commit from docs/retro-agents-notes into main
Collaborator

Summary

Three learnings from the pubDate fix + edit-feature session, recorded as guidance:

  • Test seam: on :memory: (MaxOpenConns(1)), issuing a second query while rows from the first are still open is a hard deadlock, not a slow query
  • Test seam: DATETIME columns don't scan as SQLite text — the driver returns time.Time, which database/sql renders as RFC 3339 in a string; parse stored timestamps with feed.PubDate's layouts and assert rendered dates against the row's value (the root cause of PR #6's constant pubDate)
  • Git: PRs merge as squash, so local branches always look unmerged after merge; git branch -d refusing is expected, delete with -D without re-verifying the diff

Why

Session retro; each item cost real debugging or cleanup time and is a gotcha no config or command output confesses.

## Summary Three learnings from the pubDate fix + edit-feature session, recorded as guidance: - Test seam: on `:memory:` (MaxOpenConns(1)), issuing a second query while rows from the first are still open is a hard deadlock, not a slow query - Test seam: DATETIME columns don't scan as SQLite text — the driver returns `time.Time`, which `database/sql` renders as RFC 3339 in a string; parse stored timestamps with `feed.PubDate`'s layouts and assert rendered dates against the row's value (the root cause of PR #6's constant pubDate) - Git: PRs merge as squash, so local branches always look unmerged after merge; `git branch -d` refusing is expected, delete with `-D` without re-verifying the diff ## Why Session retro; each item cost real debugging or cleanup time and is a gotcha no config or command output confesses.
docs: record driver timestamp shape, :memory: deadlock, squash-merge cleanup in AGENTS
All checks were successful
ci / check (pull_request) Successful in 4m4s
76ad78065a
w33ble closed this pull request 2026-09-06 22:34:47 -06:00
All checks were successful
ci / check (pull_request) Successful in 4m4s
Required
Details

Pull request closed

Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
w33ble/mediacast!8
No description provided.