@difflab/pi 0.3.0 → 0.4.0-rc.202609231122.7b4400b

package/dist/tools/log.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from '@earendil-works/pi-coding-agent';
+export declare const diffpiLogTool: ToolDefinition;
+//# sourceMappingURL=log.d.ts.map

package/dist/tools/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/tools/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAoBlF,eAAO,MAAM,aAAa,EAAE,cA0B1B,CAAC"}

package/dist/tools/modes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/tools/modes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAElF,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,UAAU,CAAC;AAiB5D,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,CAiErF"}
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/tools/modes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGlF,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,UAAU,CAAC;AAiB5D,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,CAiErF"}

package/dist/tools/plan-schema.d.ts

@@ -0,0 +1,211 @@
+import { z } from 'zod';
+declare const planTaskDraftSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fileScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+declare const planPhaseDraftSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    objective: z.ZodString;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fileScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const planContextParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        draft: "draft";
+        ready: "ready";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        completed: "completed";
+    }>>>;
+}, z.core.$strict>;
+export declare const planInitParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    shortSlug: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    intent: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    issueUrl: z.ZodOptional<z.ZodString>;
+    open: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const planUpdateOverviewParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    expectedPlanRevision: z.ZodNumber;
+    intent: z.ZodOptional<z.ZodString>;
+    requirements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    design: z.ZodOptional<z.ZodObject<{
+        bigIdeas: z.ZodString;
+        keyApiUpdates: z.ZodString;
+        consequences: z.ZodString;
+    }, z.core.$strict>>;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const planAddPhaseParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    expectedPlanRevision: z.ZodNumber;
+    afterPhaseId: z.ZodOptional<z.ZodString>;
+    phase: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        objective: z.ZodString;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        tasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            fileScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const planRemovePhaseParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    expectedPlanRevision: z.ZodNumber;
+    phaseId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export declare const planUpdatePhaseParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    expectedPlanRevision: z.ZodNumber;
+    phaseId: z.ZodString;
+    patch: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        objective: z.ZodOptional<z.ZodString>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        tasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            fileScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const planValidateParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    strict: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const planLogProgressParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    actor: z.ZodString;
+    message: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    phaseId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const planRunGatesParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    phaseId: z.ZodString;
+    expectedPhaseRevision: z.ZodNumber;
+    executionId: z.ZodString;
+    actor: z.ZodString;
+}, z.core.$strict>;
+export declare const planRecordCiParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    phaseId: z.ZodString;
+    sha: z.ZodString;
+    executionId: z.ZodString;
+    actor: z.ZodString;
+    status: z.ZodEnum<{
+        skipped: "skipped";
+        passed: "passed";
+        failed: "failed";
+    }>;
+    detail: z.ZodString;
+    retryReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const planLookupParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const planStartExecutionParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    commitMode: z.ZodEnum<{
+        push: "push";
+        "no-commit": "no-commit";
+        commit: "commit";
+    }>;
+    actor: z.ZodString;
+}, z.core.$strict>;
+export declare const planUpdateStatusParametersSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    plan: z.ZodString;
+    target: z.ZodObject<{
+        type: z.ZodEnum<{
+            phase: "phase";
+            task: "task";
+            plan: "plan";
+        }>;
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    expectedStatus: z.ZodEnum<{
+        draft: "draft";
+        ready: "ready";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        completed: "completed";
+        pending: "pending";
+        skipped: "skipped";
+    }>;
+    status: z.ZodEnum<{
+        draft: "draft";
+        ready: "ready";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        completed: "completed";
+        pending: "pending";
+        skipped: "skipped";
+    }>;
+    actor: z.ZodString;
+    message: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    blockedReason: z.ZodOptional<z.ZodString>;
+    attempts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    needsUserDecision: z.ZodOptional<z.ZodBoolean>;
+    commit: z.ZodOptional<z.ZodObject<{
+        sha: z.ZodString;
+        subject: z.ZodString;
+        completedAt: z.ZodString;
+        pushedAt: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            status: z.ZodLiteral<"pending">;
+            startedAt: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type PlanTaskDraft = z.infer<typeof planTaskDraftSchema>;
+export type PlanPhaseDraft = z.infer<typeof planPhaseDraftSchema>;
+export {};
+//# sourceMappingURL=plan-schema.d.ts.map

package/dist/tools/plan-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-schema.d.ts","sourceRoot":"","sources":["../../src/tools/plan-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,QAAA,MAAM,mBAAmB;;;;;;;kBASd,CAAC;AAEZ,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;kBAQf,CAAC;AAYZ,eAAO,MAAM,2BAA2B;;;;;;;;;;;kBAO7B,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;kBAW1B,CAAC;AAEZ,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;kBAa3C,CAAC;AAEL,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;kBAQ9B,CAAC;AAEZ,eAAO,MAAM,+BAA+B;;;;;;kBAQjC,CAAC;AAEZ,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;kBAejC,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;kBAE9B,CAAC;AAEZ,eAAO,MAAM,+BAA+B;;;;;;;;;;kBAYjC,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;kBAS9B,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;kBAY9B,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;kBAAkE,CAAC;AAE1G,eAAO,MAAM,kCAAkC;;;;;;;;;kBAOpC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+BlC,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/tools/plan.d.ts

@@ -0,0 +1,6 @@
+import type { ExtensionAPI, ToolDefinition } from '@earendil-works/pi-coding-agent';
+import type { ModeController } from '../modes';
+import { type PlanStore } from '../plan/store';
+export type PlanToolRuntime = Pick<ExtensionAPI, 'events' | 'sendUserMessage'> & Partial<Pick<ExtensionAPI, 'sendMessage'>>;
+export declare function createPlanTools(_pi: PlanToolRuntime, _modes: ModeController, store?: PlanStore): readonly ToolDefinition[];
+//# sourceMappingURL=plan.d.ts.map

package/dist/tools/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAQpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM/C,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAmBhE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,iBAAiB,CAAC,GAC5E,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AAE7C,wBAAgB,eAAe,CAC7B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,cAAc,EACtB,KAAK,GAAE,SAA6B,GACnC,SAAS,cAAc,EAAE,CA6W3B"}

package/dist/tools/review.d.ts

@@ -1,6 +1,33 @@
 import { type ToolDefinition } from '@earendil-works/pi-coding-agent';
 import { type ReviewComment, type ReviewThreadRecord } from '../review';
 export declare function hasReviewDraft(comments: readonly ReviewComment[], body: string): boolean;
+export declare function partitionReviewComments(comments: readonly ReviewComment[], knownFingerprints: ReadonlySet<string>, model: string): {
+    checkpointed: {
+        source: ReviewComment;
+        published: {
+            body: string;
+            file: string;
+            line?: number;
+            side?: import("..").ReviewSide;
+            author?: string;
+            sourceCommentId?: string;
+        };
+        fingerprint: string;
+    }[];
+    candidates: {
+        source: ReviewComment;
+        published: {
+            body: string;
+            file: string;
+            line?: number;
+            side?: import("..").ReviewSide;
+            author?: string;
+            sourceCommentId?: string;
+        };
+        fingerprint: string;
+    }[];
+};
+export declare function resolveReviewThread(comment: ReviewComment, threads: readonly ReviewThreadRecord[]): ReviewThreadRecord | undefined;
 export declare function workingTreeDiff(cwd: string): Promise<string>;
 export declare function createReviewTools(): readonly ToolDefinition[];
 export declare function syncLocalThreadArtifact(path: string, title: string, sessionSlug: string, threads: readonly ReviewThreadRecord[]): Promise<ReviewThreadRecord[]>;

package/dist/tools/review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAMzG,OAAO,EAuBL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAiEnB,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAExF;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAalE;AAID,wBAAgB,iBAAiB,IAAI,SAAS,cAAc,EAAE,CAyb7D;AAID,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwB/B"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAMzG,OAAO,EAwBL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAwEnB,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAExF;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,EACtC,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;EAUd;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,kBAAkB,GAAG,SAAS,CAmBhC;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAalE;AAID,wBAAgB,iBAAiB,IAAI,SAAS,cAAc,EAAE,CAyc7D;AAID,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwB/B"}

package/dist/vcs/github.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/vcs/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,SAAS,CAAC;AAYjD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAuGzD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CA6B1D"}
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/vcs/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,SAAS,CAAC;AAYjD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CA2IzD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CA4B1D"}

package/dist/vcs/gitlab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitlab.d.ts","sourceRoot":"","sources":["../../src/vcs/gitlab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,SAAS,CAAC;AAajD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAgFzD"}
+{"version":3,"file":"gitlab.d.ts","sourceRoot":"","sources":["../../src/vcs/gitlab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,SAAS,CAAC;AAajD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CA4GzD"}

package/dist/vcs/types.d.ts

@@ -8,6 +8,11 @@ export interface PrRef {
     headRef: string;
     headSha?: string;
 }
+export type HostedCiStatus = 'passed' | 'failed' | 'pending' | 'skipped';
+export interface HostedCiResult {
+    status: HostedCiStatus;
+    detail: string;
+}
 export interface OpenPrOptions {
     title: string;
     body: string;
@@ -22,7 +27,11 @@ export interface VcsBackend {
     viewPr(idOrBranch: string): Promise<PrRef | undefined>;
     defaultBranch(): Promise<string>;
     prDiff(id: number): Promise<string>;
-    prChecks(id: number): Promise<string>;
+    prChecks(id: number): Promise<HostedCiResult>;
+    watchCommitCi(sha: string, options: {
+        intervalSeconds: number;
+        signal?: AbortSignal;
+    }): Promise<HostedCiResult>;
     markReady(id: number): Promise<void>;
     closePr(id: number, comment?: string): Promise<void>;
     mergePr(id: number, subject: string): Promise<void>;

package/dist/vcs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vcs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAClD,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACvD,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,yEAAyE;AACzE,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vcs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAClD,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACvD,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9C,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAChH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,yEAAyE;AACzE,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC"}

package/dist/workflow.d.ts

@@ -0,0 +1,33 @@
+export type PlanWorkflowName = 'init' | 'new' | 'update' | 'annotate' | 'finalize' | 'go' | 'help';
+export type PlanWorkflowArguments = {
+    init: {
+        plan: string;
+        branch?: string;
+    };
+    new: {
+        plan: string;
+        branch?: string;
+        background: boolean;
+        prompt?: string;
+    };
+    update: {
+        plan?: string;
+        branch?: string;
+        background: boolean;
+        instructions?: string;
+    };
+    annotate: {
+        plan?: string;
+    };
+    finalize: {
+        plan?: string;
+    };
+    go: {
+        plan: string;
+        commitMode: 'no-commit' | 'commit' | 'push';
+        background: boolean;
+    };
+    help: Record<string, never>;
+};
+export declare function loadPlanWorkflow<Name extends PlanWorkflowName>(name: Name, args: PlanWorkflowArguments[Name]): Promise<string>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;AAEnG,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,QAAQ,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,QAAQ,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IACvF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC7B,CAAC;AAIF,wBAAsB,gBAAgB,CAAC,IAAI,SAAS,gBAAgB,EAClE,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@difflab/pi",
-  "version": "0.3.0",
+  "version": "0.4.0-rc.202609231122.7b4400b",
   "description": "Tools and skills for the pi coding agent",
   "repository": {
     "type": "git",
@@ -17,6 +17,9 @@
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "diffpi": "./dist/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -31,7 +34,8 @@
     "agents/",
     "dist/",
     "skills/",
-    "templates/"
+    "templates/",
+    "workflows/"
   ],
   "pi": {
     "extensions": [
@@ -54,7 +58,12 @@
   },
   "dependencies": {
     "@juicesharp/rpiv-ask-user-question": "^2.10.1",
+    "cmd-ts": "^0.15.0",
+    "commander": "^14.0.0",
+    "mdast-builder": "1.1.1",
     "pi-mcp-adapter": "^2.33.0",
+    "remark-stringify": "11.0.0",
+    "unified": "11.0.5",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/skills/plan/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: plan
+description: Route natural-language planning requests to Diffpi's /plan commands. Use when a user wants to create, revise, annotate, finalize, or execute a durable plan, or asks which /plan command to run.
+allowed-tools: ask_user_question
+---
+
+# Plan Command Guide
+
+Use `/plan` commands as the execution boundary. Do not reproduce their workflows, call `plan_*` tools directly, or edit managed plan files.
+
+## Natural-language routing
+
+Map the user's intent to one command:
+
+- Create an empty plan shell: `/plan init <short-slug> [--branch <name>]`
+- Research and author a complete plan: `/plan new <short-slug> [--branch <name>] [--bg] [prompt...]`
+- Revise a plan from chat instructions or its current plan review: `/plan update [short-slug] [--branch <name>] [--bg] [instructions...]`
+- Review a plan in tuicr and save the result: `/plan annotate [short-slug]`
+- Validate and mark a plan ready: `/plan finalize [short-slug]`
+- Execute a plan: `/plan go <short-slug> [--mode <no-commit|commit|push>] [--bg]`
+- Show command help: `/plan help`
+
+Infer the command, slug, branch, and free-text arguments from recent conversation when they are clear. If a required value cannot be inferred, use `ask_user_question`; do not ask in plain chat. Then give the user one exact, copyable `/plan` command. Explain defaults only when relevant: `go` uses `--mode no-commit` when `--mode` is omitted.

package/skills/review/SKILL.md

@@ -12,6 +12,6 @@ Parse the first non-flag argument as VERB and preserve remaining flags. Normaliz
 
 Read and follow `references/workflows/{VERB}.md`. Call `review_context` first in every workflow. Use `ask_user_question` for choices that cannot be derived from the request. Never ask those questions as plain chat text.
 
-For inline execution, `/review auto` and `/review address` activate the reviewer profile on Sol; lifecycle verbs activate the orchestrator profile on Luna. The reviewer coordinates `address`, classifies every thread, and delegates bounded implementation to lightweight worker agents. With `--bg`, the command leaves the current chat mode unchanged and launches a tracked background orchestrator, which routes `auto` and `address` through the reviewer.
+For inline execution, `/review auto` and `/review address` activate the reviewer profile on Sol; lifecycle verbs activate the orchestrator profile on Luna. The reviewer coordinates `address`, classifies every thread, and delegates bounded implementation to lightweight worker agents. With `--bg`, the command leaves the current chat mode unchanged and launches one named background orchestrator through the pi-subagents cross-extension RPC. Do not add an extra model turn or use recursive Pi or `/bg --agent` for this dispatch. For further delegation, use `Agent`, `get_subagent_result`, and `steer_subagent`; use `SubagentWorkflow` for deterministic multi-stage orchestration. Reserve pi-background-tasks for ordinary long-running shell commands, tests, builds, and servers.
 
 Workflow index: `auto` generates findings and leaves remote comments pending; `new` creates a local review or remote draft PR/MR; `edit` opens an existing local or remote review for the user; `address` fixes local or remote comments, commits remote fixes through `/git`, and records or posts replies; `publish` promotes pending review work; `complete` approves, rejects, abandons, or archives a review without merging; `merge` is the separate GitHub-only merge action; `help` prints the reference.

package/skills/review/references/review-standards.md

@@ -0,0 +1,23 @@
+# Review standards
+
+Use these rules for review and address workflows.
+
+## Intent
+
+Check that the change serves the stated PR intent. Treat a missing required behavior as blocking.
+
+## Correctness
+
+Trace the main path and important failure paths. Check validation, persistence, retries, permissions, and user-visible errors.
+
+## Scope
+
+Reject unrelated churn, duplicate abstractions, speculative follow-ups, and generated code that does not reduce complexity. If a requested change is relevant, apply it in the current workflow. Defer only when the user explicitly defers it or a required decision is blocked.
+
+## Design
+
+Prefer existing package APIs and small public surfaces. Add a dependency when it is a maintained fit for the problem. Do not recreate a general-purpose parser, scheduler, or subagent system without checking installed packages first.
+
+## Responses
+
+Respond to every addressed thread. State what changed and include verification evidence. Keep every thread open for the user to resolve. Address workflows must never resolve or delete threads.

package/skills/review/references/workflows/address.md

@@ -4,8 +4,8 @@
 2. Run this workflow as the reviewer coordinator. Call `review_context` with the target and backend selection.
 3. Call `review_comments`. With `--local`, it synchronizes every comment in the selected tuicr session to `.diffpi/review/<session-slug>.md`. Existing replies and statuses remain; source comments removed by the user become resolved ledger entries.
 4. Classify every thread, group justified code changes into bounded non-overlapping tasks, and delegate those tasks to lightweight worker agents. Keep questions, outcome decisions, integration, and response text in the reviewer coordinator. With `--local`, workers modify the current working tree without committing. Without `--local`, apply a fix only when the comment requests a change.
-5. Respond to every thread with its outcome. Answer questions and leave them open. For substantive requests, state what changed and whether it is resolved, but leave the thread open for reviewer confirmation. For a trivial request, reply `Resolved`; remote threads may close, while the user must delete the local tuicr source comment before the next sync marks it resolved.
+5. Respond to every thread with its outcome. Answer questions and leave them open. For substantive requests, state what changed and whether it is resolved, but leave every thread open for the user to resolve. Do not resolve remote threads or delete local source comments in this workflow, including for trivial requests.
 6. When a remote address flow changes code, invoke the upstream `/git commit --no-push` workflow after checks pass and before drafting responses. Use `--atomic` when the fixes form separate logical commits.
-7. Call `review_respond` for each thread. With `--local`, every response is posted to tuicr and recorded in the session ledger. Without `--local`, replies post to the forge immediately.
+7. Call `review_respond` for each thread with `resolve: false`. With `--local`, every response is posted to tuicr and recorded in the session ledger. Without `--local`, replies post to the forge immediately. The user owns thread resolution.
 8. With `--local`, call `review_launch_ui` with `local: true` after replies are recorded so the user can inspect the working-tree review in tuicr.
-9. Report fixed, committed, answered, addressed, resolved, and unresolved counts. Do not publish, complete, or merge in this workflow.
+9. Report fixed, committed, answered, addressed, unresolved, and skipped counts. Resolved must always be zero in this workflow. Do not publish, complete, or merge.

package/skills/review/references/workflows/complete.md

@@ -1,6 +1,6 @@
 # complete
 
-1. Parse an optional PR/MR id or URL, `--local`, and exactly one remote action: `--approve`, `--reject`, or `--abandon`. `close` is an alias for this workflow.
+1. Parse an optional PR/MR id or URL, `--local`, and exactly one remote action: `--approve`, `--reject`, or `--abandon`. `close` is an alias for this workflow. If the action is omitted, ask the user with `header: "Action"`; all question headers must be 16 characters or fewer.
 2. Call `review_context` with the same target and backend selection.
 3. With `--local`, call `review_complete` with `local: true`. It archives the reply overlay to `.diffpi/reviews/<session-slug>.md`, then deletes the exact persisted tuicr session. This is destructive and prevents its comments from appearing in future tuicr sessions.
 4. Without `--local`, map `--approve`, `--reject`, or `--abandon` to the `review_complete` action `approve`, `reject`, or `abandon`. The tool applies the remote lifecycle action but does not merge.

package/skills/review/references/workflows/merge.md

@@ -1,6 +1,6 @@
 # merge
 
-1. Call `review_context` and confirm the PR/MR is approved and ready.
+1. Call `review_context` and confirm the GitHub PR is open, non-draft, clean, and its checks are settled. Do not require an approval from the current user; authors cannot approve their own PRs. GitHub branch protection remains authoritative.
 2. If a conventional squash subject is required and the subject is unclear, use `ask_user_question`.
 3. Call `review_merge` with the chosen subject.
 4. Report the merge result.

package/skills/review/references/workflows/publish.md

@@ -1,8 +1,8 @@
 # publish
 
 1. Parse an optional PR/MR id or URL, `--local`, and one status: `--comment`, `--approve`, `--request-changes`, or `--close`. The default is comment.
-2. Call `review_context` with the target and backend selection.
-3. For `--local`, call `review_publish` with `local: true`. The tool reads the exact tuicr session, promotes its unpublished line comments to a pending forge review, follows the stored local overlay path, posts unpublished replies to their remote threads, and then publishes the selected status. Question replies remain open. The tool does not post an overall review comment.
-4. For a remote review, call `review_publish` without `local`. The existing pending forge comments already contain provenance, so the tool only publishes them with the selected status and no overall comment.
+2. Call `review_context` with the target and `local: true` so the exact tuicr PR session can be inspected. If that session exists and has drafts, publish through the local promotion path even when the user omitted `--local`. Use `local: false` only when no matching tuicr session exists or when the target has forge-native pending review work.
+3. The local promotion path reads the exact tuicr session. A local line comment on the same file and line as an existing remote thread is treated as a response, not a new comment. A leading `[REOPEN]`, `[RESOLVE]`, or `[DELETE]` changes the thread state; the marker is removed from the response body. `[DELETE]` deletes the matched remote thread when the forge supports it. Other unpublished line comments become new review comments. The tool follows the stored local overlay path, posts unpublished replies to their remote threads, and then publishes the selected status. Question replies remain open. The tool does not post an overall review comment.
+4. For a forge-native review without a matching tuicr session, call `review_publish` without `local`. Existing pending forge comments already contain provenance, so the tool only publishes them with the selected status and no overall comment.
 5. Comment, approve, and request-changes mark a draft PR/MR ready before publication. Close publishes pending work as comment status and then closes the PR/MR. GitLab rejects request-changes because it has no equivalent review state.
-6. Report promoted comment and reply counts, the public status, and the final PR/MR state. Publishing never merges.
+6. Report promoted comment and reply counts, the public status, and the final PR/MR state. Publishing never merges. If a response cannot be matched by file and line, report it as a new comment rather than silently attaching it to the wrong thread.

package/templates/plan/PLAN.md

@@ -0,0 +1,40 @@
+<!-- diffpi-plan: {"schemaVersion":1,"id":"{{id}}","revision":0,"branch":"{{branch}}","status":"draft","createdAt":"{{created_at}}","updatedAt":"{{updated_at}}"} -->
+
+# {{title}}
+
+- **Plan ID:** {{id}}
+- **Branch:** {{branch}}
+- **Issue:** {{issue_id}}
+- **Issue URL:** {{issue_url}}
+- **Status:** draft
+- **Revision:** 0
+
+## Intent
+
+{{intent}}
+
+## Requirements
+
+<!-- Add requirements. -->
+
+## Design
+
+### Big Ideas
+
+<!-- Describe the main approach. -->
+
+### Key API Addition/Updates
+
+<!-- Describe public API changes. -->
+
+### Consequences
+
+<!-- Describe trade-offs and limitations. -->
+
+## Implementation
+
+<!-- Add phases with plan_add_phase. -->
+
+## References
+
+<!-- Add references. -->

package/templates/plan/implementation.md

@@ -0,0 +1,24 @@
+# Phase {{phase_id}}: {{phase_title}}
+
+## Summary
+
+<!-- State the change delivered by this phase in one short paragraph or up to three bullets. -->
+
+## Scope
+
+**Objective:** {{phase_objective}}
+
+**Tasks:**
+{{phase_tasks}}
+
+## Files Changed
+
+<!-- Show the directory tree. Annotate files added, removed, and updated. -->
+
+## API Changes
+
+<!-- Document each public app, library, module, class, or function. Include behavior, data contracts, and imperative or declarative APIs. -->
+
+## Implementation Constraints
+
+<!-- State required libraries, algorithms, patterns, restrictions, and important implementation details. -->

package/workflows/plan/annotate.md

@@ -0,0 +1,13 @@
+# annotate
+
+## Arguments
+
+- **Invocation:** `/plan annotate [short-slug]`
+- `[short-slug]` (optional): Plan to annotate. Omit it only when context resolves exactly one plan.
+
+## Instructions
+
+1. Call `plan_context` and infer planId from the provided short slug/conversation context. Fall back to looking at available active plan candidates, and ask user which to annotate listing available options.
+2. Call `plan_annotate`; it uses `tuicr --file .diffpi/plan/{planId}`, never `-p` or `--path`.
+3. Report the selected plan, launch result, and copyable fallback command. Closing tuicr saves one immutable plan review for the current plan revision.
+4. Tell the user to run `/plan update <plan-id>` after closing tuicr.

package/workflows/plan/finalize.md

@@ -0,0 +1,15 @@
+# finalize
+
+## Arguments
+
+- **Invocation:** `/plan finalize [short-slug]`
+- `[short-slug]` (optional): Plan to validate and mark ready. Omit it only when context resolves exactly one plan.
+
+## Instructions
+
+1. Call `plan_context` and use the current persisted plan, including changes authored through chat.
+2. Call `plan_review` once. If a review exists for the current plan revision, apply its feedback using the update workflow's mutation rules. If no review exists, continue directly.
+3. Call `plan_validate` with `strict: true`. Address validation issues and stop on unresolved errors or Design above 800 words.
+4. Mark the draft ready with `plan_update_status`.
+5. Use one `ask_user_question` call to choose the next action. Choices are foreground execution, background execution, execute later, or continue planning. When execution is selected, also ask for `no-commit`, `commit`, or `push` mode.
+6. Call `diffpi_modes_unset` before returning so finalization exits to the default inline mode. For execution, return the exact `/plan go <short-slug> --mode <mode>` command, adding `--bg` for background execution. Do not call `plan_start_execution`; `/plan go` routes execution to Orchestrator.

package/workflows/plan/go.md

@@ -0,0 +1,20 @@
+# go
+
+## Arguments
+
+- **Invocation:** `/plan go <short-slug> [--mode <no-commit|commit|push>] [--bg]`
+- `<short-slug>` (required): Plan to execute.
+- `--mode no-commit` (optional, default): Execute without creating commits.
+- `--mode commit` (optional): Create one local commit after each completed phase. Do not push or monitor remote CI.
+- `--mode push` (optional): Create and push one commit after each completed phase, then monitor remote CI before completion.
+- `--bg` (optional): Launch the execution Orchestrator in the background and preserve the current foreground mode.
+
+## Instructions
+
+1. Call `plan_context` with the supplied slug.
+2. Read the requested commit mode from `--mode`. Use `no-commit` when the flag is omitted. Do not ask the user to select a commit mode.
+3. Reject values other than `no-commit`, `commit`, or `push`. The command parser normally performs this validation before invoking the workflow.
+4. The command has already selected the foreground Orchestrator or launched the background Orchestrator. Continue as the current Orchestrator and launch implementation Workers as needed.
+5. Call `plan_start_execution` with the selected commit mode. This tool initializes durable execution state and returns the execution packet. It does not select a mode, send another turn, or launch an agent.
+6. In `no-commit` mode, do not create or push commits. In `commit` mode, create one local commit after each phase passes its gates, but do not push or monitor remote CI. In `push` mode, commit and push each phase, record pending CI, and launch a bounded background Worker to call `watch_ci` for the exact commit and then `plan_record_ci` for the phase while the next phase executes. Collect that monitor before the next push and collect all monitors before completion; failed or timed-out CI blocks execution.
+7. For foreground execution, call `diffpi_modes_unset` after the plan is completed. Background execution must not change the foreground mode. Report the execution ID and selected commit mode.