chore: publish from main

2026-07-19 03:59:17 +00:00 · 2026-07-01 01:10:23 +00:00
parent fa007c62f7
commit 5075e262b5
25 changed files with 3124 additions and 0 deletions
@@ -0,0 +1,21 @@
+# Reply: declined with rationale
+
+Use when triage decided `decline`. The reply must explain WHY
+declining is the right call — not just that you considered it. Always
+resolve the thread after replying; an open thread with no reply
+signals avoidance.
+
+```
+Considered this, but declining: <concrete reason rooted in code or
+design>. <Optional: the interleaving / scenario you ruled out, or
+the alternative cost>. Happy to revisit if <specific trigger>.
+```
+
+Example (domain-neutral):
+
+> Considered extending the lock into the initialization path, but
+> declining: initialization runs to completion before any concurrent
+> caller can reach this code, so the race window only opens after
+> the init callback has returned. Sharing the lock across modules
+> costs more in coupling than the actual exposure justifies. Happy
+> to revisit if telemetry shows a real interleaving.
@@ -0,0 +1,8 @@
+# Reply: documentation / test-plan drift
+
+Use when Copilot points out the PR description, a comment, or the
+test plan no longer matches the code.
+
+```
+Good catch — updated the <PR description | comment in `<file>` | test plan> to match the implemented behavior: <one-line summary of the now-correct statement>.
+```
@@ -0,0 +1,25 @@
+# Reply: accepted fix
+
+Use after the loop has committed and pushed a fix for the finding. Cite
+the pushed commit SHA from step 7.
+
+```
+<one sentence acknowledging the finding>.
+<one or two sentences describing the fix>.
+Fixed in <commit-sha>.
+```
+
+Example (language-neutral):
+
+> The lock did not cover the install side of the path, so two
+> parallel writers could read the same baseline and clobber each
+> other. Promoted the per-instance lock to a process-wide
+> function-local static so all read-modify-write paths share it.
+> Fixed in abc1234.
+
+When the fix is in a tested area, add a one-line test confirmation:
+
+> Replaced the platform UUID dependency with a PID + monotonic-clock
+> + atomic counter so the test target no longer pulls in the
+> platform UUID library. All 42 tests in the affected suite still
+> pass. Fixed in abc1234.
@@ -0,0 +1,9 @@
+# Reply: partial fix with deferred follow-up
+
+Use when the finding has both an immediate fix and a deeper
+structural concern — address the immediate part now and acknowledge
+the rest.
+
+```
+Fixed the immediate <X> in <commit-sha>. The broader <Y> would benefit from <larger change>, which I'd prefer to land separately because <reason>. Tracking as <issue-link-or-todo>.
+```