pullfrog 0.0.204 → 0.0.205

package/README.md

@@ -72,16 +72,14 @@ on:
         description: 'Agent prompt'
 
 permissions:
-  id-token: write
-  contents: write
-  pull-requests: write
-  issues: write
-  actions: read
-  checks: read
+  contents: read
 
 jobs:
   pullfrog:
     runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
@@ -130,11 +128,7 @@ jobs:
 
     permissions:
       id-token: write
-      contents: write
-      issues: write
-      pull-requests: write
-      actions: read
-      checks: read
+      contents: read
     uses: ./.github/workflows/pullfrog.yml
     with:
       # pass the full event payload as the prompt

package/dist/agents/postRun.d.ts

@@ -15,13 +15,24 @@ import { type AgentResult, type AgentUsage, type PostRunIssues, type StopHookFai
  */
 export declare function executeStopHook(script: string): Promise<StopHookFailure | null>;
 export declare function buildStopHookPrompt(failure: StopHookFailure): string;
+export declare function buildSummaryStalePrompt(filePath: string): string;
 /**
- * check the two post-run gates: did the stop hook pass and is the working
- * tree clean? returns everything that still needs fixing so the caller can
+ * check the post-run gates: did the stop hook pass, is the working tree
+ * clean, and (when applicable) did the agent touch the rolling PR summary
+ * snapshot? returns everything that still needs nudging so the caller can
  * render a single combined resume prompt.
+ *
+ * the summary-stale check is skipped when `summaryFilePath` / `summarySeed`
+ * are not provided; this is the common case (non-PR runs, runs where the
+ * dispatcher didn't request snapshot generation, runs where the seed step
+ * failed). loop callers also pass these as undefined after the agent has
+ * already been nudged once, to avoid burning the retry budget on a soft
+ * non-blocking gate.
  */
 export declare function collectPostRunIssues(params: {
     stopScript: string | null | undefined;
+    summaryFilePath?: string | undefined;
+    summarySeed?: string | undefined;
 }): Promise<PostRunIssues>;
 export declare function buildPostRunPrompt(issues: PostRunIssues): string;
 /**
@@ -57,6 +68,14 @@ export declare function runPostRunRetryLoop<R extends AgentResult>(params: {
     initialResult: R;
     initialUsage: AgentUsage | undefined;
     stopScript: string | null | undefined;
+    /** absolute path to the seeded PR summary file. when set together with
+     * `summarySeed`, the loop checks after each agent attempt whether the
+     * file has been edited; if not, it nudges the agent ONCE via a resume
+     * turn (subsequent iterations skip the check so we don't keep burning
+     * retries on a soft gate when the agent has decided no edit is warranted). */
+    summaryFilePath?: string | undefined;
+    /** exact bytes of the seeded summary file used for the unchanged-check. */
+    summarySeed?: string | undefined;
     resume: (context: {
         prompt: string;
         previousResult: R;

package/dist/agents/shared.d.ts

@@ -14,9 +14,17 @@ export interface StopHookFailure {
     exitCode: number;
     output: string;
 }
+export interface SummaryStale {
+    /** absolute path to the seeded snapshot file the agent was meant to edit. */
+    filePath: string;
+}
 export interface PostRunIssues {
     stopHook?: StopHookFailure;
     dirtyTree?: string;
+    /** populated when the rolling PR summary file is byte-identical to its
+     * seed, i.e. the agent never touched it. soft gate — nudges once via a
+     * resume turn but never fails the run, parallel to dirtyTree semantics. */
+    summaryStale?: SummaryStale;
 }
 export declare function hasPostRunIssues(issues: PostRunIssues): boolean;
 /**
@@ -71,6 +79,20 @@ export interface AgentRunContext {
      * guidance. null when the repo has no stop hook configured.
      */
     stopScript?: string | null | undefined;
+    /**
+     * absolute path to the rolling PR summary tmpfile, when one was seeded
+     * for this run (Review / IncrementalReview / pr-summary Task). enables
+     * a post-run sanity nudge that prompts the agent if the file is still
+     * byte-identical to its seed.
+     */
+    summaryFilePath?: string | undefined;
+    /**
+     * exact bytes of the seeded summary file. compared against the current
+     * file content after each agent attempt to detect "agent forgot to edit
+     * the summary" — particularly common with smaller models that lose
+     * track of multi-step instructions.
+     */
+    summarySeed?: string | undefined;
     /**
      * called synchronously when the agent subprocess is killed for inner
      * activity timeout. lets main.ts tear down shared resources (MCP HTTP