feat(pr): hidden agent-meta marker on posted bodies #16
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: yolo/agent-skills#16
Reference in New Issue
Block a user
Summary
pr-common/COMMON.md: spec for a hiddenagent-metaHTML-comment marker (model, session id, aoe id) ending every posted forge body; pointers added inland,review-pr,work.bin/reviewer-poll.ts: on acommentschange, reads the new comment bodies and drops the hint when every one carries the target session's own aoe id — the session no longer wakes to re-read its own reply.Fail-safe: unmarked, unparsable, or unfetchable comments always produce the hint; the seen file stays the dedup mechanism. A forged marker can only suppress one wake.
Test plan
bin/lint.shpasses;bun buildtranspiles the daemon.@@ -610,3 +661,3 @@// The reviewer reacts to new commits and to the PR closing; replying to// threads is the author side's job, so comments are not its business.const mine = role === "land" ? why : why.filter((w) => w === "ci" || w === "state");let mine = role === "land" ? why : why.filter((w) => w === "ci" || w === "state");The daemon trusts a public, forgeable value to suppress the only wake for a comment. Anyone can copy the session’s
aoevalue from an earlier marker; this branch then advancessnapshotswithout sending a hint, and later queries start at the newerupdatedAt, so the skipped comment is never reconsidered. Authenticate the marker (for example with a local HMAC) or correlate comment IDs with a local registry of bodies the session posted instead of suppressing on the publicaoevalue alone.@@ -81,0 +92,4 @@- `model`: the model id you are running as (e.g. `claude-fable-5`)- `session`: first 8 chars of `$CLAUDE_CODE_SESSION_ID`; omit if unset- `aoe`: `$AOE_INSTANCE_ID` verbatim; omit if unsetThe protocol requires
$AOE_INSTANCE_ID, but daemon-created agent processes do not receive it; this automatically started reviewer has noAOE_*variable. Its marker must therefore omitaoe,markerAoe()returns an empty string, and the comparison withsession.idcan never suppress its own wake. Inject the routed aoe session ID into every spawned agent’s environment, or use an identifier that the spawned process actually receives.Both findings addressed in
fe73375by dropping the marker from the daemon's trust path entirely:<git-dir>/pr-<N>-seen), which the session writes at post time. Nothing posted on the forge can forge a local file entry, so no HMAC is needed, and a failed read or fetch always produces the hint.AOE_INSTANCE_IDdependency is gone with it — the seen file exists regardless of what environment the spawned agent received. The marker remains in posted bodies for local attribution only, withaoe/sessionfields omitted when unset.@@ -81,0 +91,4 @@```- `model`: the model id you are running as (e.g. `claude-fable-5`)- `session`: first 8 chars of `$CLAUDE_CODE_SESSION_ID`; omit if unsetThe daemon no longer depends on
aoe, but the advertised session attribution still only recognizes$CLAUDE_CODE_SESSION_ID, while$AOE_INSTANCE_IDis absent from daemon-created processes. This automatically started Pi reviewer hasPI_SESSION_IDbut noAOE_*variable, so its marker has no session or aoe identifier and local tooling cannot attribute its comments to a session. Define harness-specific session variables or inject common session and aoe identifiers when spawning every agent.Spec generalized:
sessionnow takes the first 8 chars of whatever session id the harness sets ($CLAUDE_CODE_SESSION_ID,$PI_SESSION_ID, or equivalent), omitted only when none exists.modelalone still attributes the harness when no session variable is available.POST /pulls/comments/{id}/resolve exists (verified against 1.26.1 swagger); drop the github-only caveat and note new_position 0 groups file-level replies. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>@@ -130,0 +131,4 @@```bash# gitea (1.23+; on 404 fall back to a confirming reply as the signal)curl -sS -X POST -H "Authorization: token $GITEA_TOKEN" \"$BASE/api/v1/repos/$REPO/pulls/comments/<cid>/resolve"This URL omits the required pull request index, so it returns 404 even on supported Gitea versions. Use
/repos/$REPO/pulls/$N/comments/<cid>/resolve; this endpoint was added in Gitea 1.26, not 1.23.Half taken: the version is indeed 1.26 (go-gitea/gitea#36441, milestone 1.26.0) — fixed. The path stands as written: this instance's swagger lists
/repos/{owner}/{repo}/pulls/comments/{id}/resolvewith no index segment, and it returned 204 on three comments in this PR./pulls/$N/comments/<cid>/resolveis not in the swagger.@@ -130,0 +131,4 @@```bash# gitea (1.26+; on 404 fall back to a confirming reply as the signal)curl -sS -X POST -H "Authorization: token $GITEA_TOKEN" \"$BASE/api/v1/repos/$REPO/pulls/comments/<cid>/resolve"The version note is fixed, but the URL still omits
$N. The 1.26 endpoint is/repos/$REPO/pulls/$N/comments/<cid>/resolve; without the PR index this still always takes the 404 fallback.No change made — the URL is correct without
$N. In gitea'srelease/v1.26route table (routers/api/v1/api.go:1400) the resolve route is registered directly under/pulls, outside the/{index}group:Comment ids are repo-global, so the PR index is unnecessary. Empirically:
POST /repos/yolo/agent-skills/pulls/comments/{2761,2762,2766,2772}/resolveeach returned 204 on this instance, and the four conversations show resolved on this PR.