@difflab/pi 0.4.0 → 0.5.0-rc.202609231313.eaf7fa0

package/workflows/review/complete.md

@@ -0,0 +1,7 @@
+# complete
+
+1. Read the typed target, local mode, and lifecycle action from `Arguments`.
+2. Call `review_context`.
+3. In local mode, call `review_dump` to save the final immutable revision and remove the completed tuicr session.
+4. In remote mode, ask for a missing action, then call `review_complete` with `approve`, `reject`, or `abandon`.
+5. Report the dump path or remote result. Do not merge.

package/workflows/review/edit.md

@@ -0,0 +1,7 @@
+# edit
+
+1. Read `Arguments.target` and `Arguments.local`.
+2. Call `review_context`, then `review_edit`.
+3. Local mode opens the current working-tree review revision. Remote mode opens the existing PR/MR in tuicr.
+4. If no review exists, direct the user to `/review new`.
+5. Report the launch result. Do not create findings or change lifecycle state.

package/workflows/review/help.md

@@ -0,0 +1,14 @@
+# help
+
+Show these commands:
+
+- `/review auto [target] [--local] [--bg]` generates findings.
+- `/review new [title] [--intent text] [--base branch] [--local] [--bg]` starts a review.
+- `/review edit [target] [--local] [--bg]` opens an existing review.
+- `/review address [target] [--local] [--bg]` applies feedback. Local mode dumps one revision and starts the next.
+- `/review publish [target] [--comment|--approve|--request-changes|--close] [--bg]` publishes remote review work.
+- `/review complete [target] [--local|--approve|--reject|--abandon] [--bg]` finishes without merging.
+- `/review merge [target] [--bg]` merges a green remote review.
+- `/review help` shows this reference.
+
+`--local` selects the working-tree tuicr flow. Local reviews are immutable revision dumps with no replies, resolution state, or remote promotion. Remote reviews use GitHub or GitLab comments and lifecycle operations directly. `--bg` launches an Orchestrator without changing the foreground mode.

package/workflows/review/merge.md

@@ -0,0 +1,6 @@
+# merge
+
+1. Local mode is not accepted; only remote reviews can merge.
+2. Call `review_context` and confirm the PR is open, non-draft, mergeable, and green.
+3. Ask for a conventional squash subject only when it cannot be derived.
+4. Call `review_merge` and report the resulting merge.

package/workflows/review/new.md

@@ -0,0 +1,7 @@
+# new
+
+1. Read `Arguments.title`, `Arguments.intent`, `Arguments.base`, and `Arguments.local`.
+2. Call `review_context` with the selected backend.
+3. Call `review_new`. Local mode opens a working-tree review in tuicr. Remote mode creates a draft PR/MR from a clean pushed branch and opens it in tuicr.
+4. If the target exists, direct the user to `/review edit` instead.
+5. Report the created target and launch instruction. Do not generate findings or publish it.

package/workflows/review/publish.md

@@ -0,0 +1,6 @@
+# publish
+
+1. Read the typed target and status flags from `Arguments`. The default is comment.
+2. Local mode is not accepted; local reviews use immutable revision dumps and have no publish step.
+3. Call `review_context`, then `review_publish` with the selected status.
+4. Report the public review status and final PR/MR state. Publishing never merges.

package/dist/plan/annotations.d.ts

@@ -1,25 +0,0 @@
-import type { PlanAnnotationComment, PlanAnnotationState, PlanRecord } from './types';
-export interface AnnotationProcessResult {
-    code: number;
-    stdout: string;
-    stderr: string;
-}
-export interface PlanAnnotationRuntime {
-    execute?: (command: string, args: string[], cwd: string, interactive: boolean) => Promise<AnnotationProcessResult>;
-}
-export declare function annotatePlan(record: PlanRecord, runtime?: PlanAnnotationRuntime): Promise<{
-    sessionSlug: string;
-    code: number;
-    state: PlanAnnotationState;
-}>;
-export declare function readPlanAnnotations(record: PlanRecord, options?: {
-    includeApplied?: boolean;
-    runtime?: PlanAnnotationRuntime;
-}): Promise<{
-    state?: PlanAnnotationState;
-    comments: PlanAnnotationComment[];
-    pending: PlanAnnotationComment[];
-}>;
-export declare function acknowledgePlanAnnotations(record: PlanRecord, commentIds: readonly string[], summary: string): Promise<PlanAnnotationState>;
-export declare function annotationStatePath(record: PlanRecord): string;
-//# sourceMappingURL=annotations.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/plan/annotations.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACpH;AAaD,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAyB5E;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,qBAAqB,CAAA;CAAO,GAC1E,OAAO,CAAC;IAAE,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAAC,OAAO,EAAE,qBAAqB,EAAE,CAAA;CAAE,CAAC,CAwB/G;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAuB9B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE9D"}

package/dist/plan/controller.d.ts

@@ -1,65 +0,0 @@
-import { type SubagentEscalation } from '../extensions/subagentx';
-import { acknowledgePlanAnnotations, annotatePlan, readPlanAnnotations, type PlanAnnotationRuntime } from './annotations';
-import { type PlanExecutionPacket } from './execution';
-import { type PlanStore, type PlanStoreOptions } from './store';
-import type { PlanCiStatus, PlanCommit, PlanDocument, PlanPhaseStatus, PlanRecord, PlanStatus, PlanValidationIssue, PlanValidationOptions } from './types';
-export interface PlanStatusUpdate {
-    target: {
-        type: 'plan' | 'phase' | 'task';
-        id?: string;
-    };
-    expectedStatus: PlanStatus | PlanPhaseStatus;
-    status: PlanStatus | PlanPhaseStatus;
-    actor: string;
-    message: string;
-    executionId?: string;
-    evidence?: string[];
-    blockedReason?: string;
-    attempts?: string[];
-    needsUserDecision?: boolean;
-    commit?: PlanCommit;
-}
-export interface PlanStatusUpdateResult {
-    record: PlanRecord;
-    escalation?: SubagentEscalation;
-}
-export interface PlanCiUpdate {
-    phaseId: string;
-    sha: string;
-    status: Exclude<PlanCiStatus, 'pending'>;
-    actor: string;
-    executionId: string;
-    detail: string;
-}
-export interface PlanCiRetry {
-    phaseId: string;
-    sha: string;
-    actor: string;
-    executionId: string;
-    reason: string;
-}
-export interface PlanController {
-    context: PlanStore['context'];
-    create: PlanStore['init'];
-    read: PlanStore['read'];
-    update: PlanStore['mutate'];
-    appendLog: PlanStore['log'];
-    updateStatus(cwd: string, query: string, input: PlanStatusUpdate): Promise<PlanStatusUpdateResult>;
-    updateCi(cwd: string, query: string, input: PlanCiUpdate): Promise<PlanRecord>;
-    retryCi(cwd: string, query: string, input: PlanCiRetry): Promise<PlanRecord>;
-    assertPhasePushEligible(document: PlanDocument, phaseId: string, executionId: string): void;
-    validate(document: PlanDocument, options?: PlanValidationOptions): PlanValidationIssue[];
-    countDesignWords(document: PlanDocument): number;
-    annotate(record: PlanRecord, runtime?: PlanAnnotationRuntime): ReturnType<typeof annotatePlan>;
-    annotations(record: PlanRecord, options?: {
-        includeApplied?: boolean;
-        runtime?: PlanAnnotationRuntime;
-    }): ReturnType<typeof readPlanAnnotations>;
-    acknowledgeAnnotations(record: PlanRecord, commentIds: readonly string[], summary: string): ReturnType<typeof acknowledgePlanAnnotations>;
-    executionPacket(document: PlanDocument, coordinator: PlanExecutionPacket['coordinator']): PlanExecutionPacket;
-    executionPrompt(packet: PlanExecutionPacket): string;
-    renderEscalation(escalation: SubagentEscalation): string;
-    assertStableId(value: string, label?: string): void;
-}
-export declare function createPlanController(options?: PlanStoreOptions): PlanController;
-//# sourceMappingURL=controller.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/plan/controller.ts"],"names":[],"mappings":"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"}

package/dist/plan/execution.d.ts

@@ -1,13 +0,0 @@
-import type { PlanDocument, PlanExecutionPolicy } from './types';
-export interface PlanExecutionPacket {
-    version: 1;
-    planId: string;
-    executionId: string;
-    policy: PlanExecutionPolicy;
-    cwd: string;
-    branch: string;
-    coordinator: 'worker' | 'orchestrator';
-}
-export declare function createExecutionPacket(plan: PlanDocument, coordinator: PlanExecutionPacket['coordinator']): PlanExecutionPacket;
-export declare function renderExecutionPrompt(packet: PlanExecutionPacket): string;
-//# sourceMappingURL=execution.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/plan/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,QAAQ,GAAG,cAAc,CAAC;CACxC;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,mBAAmB,CAAC,aAAa,CAAC,GAC9C,mBAAmB,CAWrB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CASzE"}

package/dist/plan/ids.d.ts

@@ -1,5 +0,0 @@
-export declare const STABLE_ID: RegExp;
-export declare function isStableId(value: string): boolean;
-export declare function assertStableId(value: string, label?: string): void;
-export declare function assertUniqueIds(ids: readonly string[], label: string): void;
-//# sourceMappingURL=ids.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/plan/ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,QAA+B,CAAC;AAEtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAe,GAAG,IAAI,CAExE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAO3E"}

package/dist/plan/lock.d.ts

@@ -1,11 +0,0 @@
-export interface PlanLockOptions {
-    waitMs?: number;
-    pollMs?: number;
-    operation?: string;
-}
-/**
- * Serialize one plan's read-modify-write cycle. Worktrees still share the project
- * `.diffpi` store, so branch isolation does not prevent concurrent plan writes.
- */
-export declare function withPlanLock<T>(planDir: string, operation: () => Promise<T>, options?: PlanLockOptions): Promise<T>;
-//# sourceMappingURL=lock.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/plan/lock.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,CAAC,CA4CZ"}

package/dist/plan/log.d.ts

@@ -1,6 +0,0 @@
-import { type DiffpiLogEntry, type NewLogEntry } from '../log';
-import type { PlanLogEntry } from './types';
-export type NewPlanLogEntry = NewLogEntry<PlanLogEntry & DiffpiLogEntry>;
-export declare function appendPlanLog(logPath: string, event: NewPlanLogEntry): Promise<PlanLogEntry>;
-export declare function readPlanLog(logPath: string): Promise<PlanLogEntry[]>;
-//# sourceMappingURL=log.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/plan/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,YAAY,GAAG,cAAc,CAAC,CAAC;AAEzE,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAElG;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAE1E"}

package/dist/plan/parser.d.ts

@@ -1,18 +0,0 @@
-type AuthorVerb = 'init' | 'new' | 'update' | 'annotate' | 'finalize' | 'help';
-export type PlanCommandRequest = {
-    verb: AuthorVerb;
-    plan?: string;
-    branch?: string;
-    background: boolean;
-    instructions: string;
-} | {
-    verb: 'go';
-    plan: string;
-    background: boolean;
-    policy?: 'commit-per-phase' | 'no-commit';
-    instructions: '';
-};
-export declare function parsePlanArgs(raw: string): PlanCommandRequest;
-export declare function tokenizePlanArgs(raw: string): string[];
-export {};
-//# sourceMappingURL=parser.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/plan/parser.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAC/E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAAC;IAAC,YAAY,EAAE,EAAE,CAAA;CAAE,CAAC;AAEnH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAgD7D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBtD"}

package/dist/review/local-review-backend.d.ts

@@ -1,3 +0,0 @@
-import type { LocalReviewBackendOptions, ReviewBackend } from './types';
-export declare function LocalReviewBackend(options: LocalReviewBackendOptions): ReviewBackend;
-//# sourceMappingURL=local-review-backend.d.ts.map

package/dist/review/local-review-backend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-review-backend.d.ts","sourceRoot":"","sources":["../../src/review/local-review-backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,aAAa,CAqCpF"}

package/dist/review/review-state.d.ts

@@ -1,20 +0,0 @@
-import type { VcsInfo } from '../environment';
-import type { ReviewComment } from './types';
-export interface ReviewPublicationState {
-    target: string;
-    bodies: string[];
-    comments: string[];
-    stagedComments: string[];
-    replies: string[];
-    overlayPath?: string;
-}
-export declare function reviewBodyFingerprint(body: string): string;
-export declare function reviewCommentFingerprint(comment: ReviewComment): string;
-export declare function reviewReplyFingerprint(threadId: string, body: string): string;
-export declare function unpublishedReviewComments(comments: readonly ReviewComment[], knownFingerprints: ReadonlySet<string>): ReviewComment[];
-export declare function loadReviewPublicationState(cwd: string, vcs: VcsInfo, number: number, homeDir?: string): Promise<{
-    path: string;
-    state: ReviewPublicationState;
-}>;
-export declare function saveReviewPublicationState(path: string, state: ReviewPublicationState): Promise<void>;
-//# sourceMappingURL=review-state.d.ts.map

package/dist/review/review-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"review-state.d.ts","sourceRoot":"","sources":["../../src/review/review-state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAY7C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEvE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,aAAa,EAAE,CAEjB;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,CAAC,CAe1D;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3G"}

package/skills/plan/references/workflows/annotate.md

@@ -1,6 +0,0 @@
-# annotate
-
-1. Call `plan_context` and require an exact selection.
-2. Call `plan_annotate`; it uses `tuicr --file PLAN.md`, never `-p` or `--path`.
-3. Report the selected plan, session slug, launch result, and copyable fallback command.
-4. Tell the user to run `/plan update <plan-id>` when comments are ready.

package/skills/plan/references/workflows/finalize.md

@@ -1,7 +0,0 @@
-# finalize
-
-1. Call `plan_context` and use the current persisted plan, including changes authored through chat. Call `plan_annotations` only to check for optional annotation feedback. If `pending` is non-empty, run the update workflow to apply and acknowledge those comments. If no annotation session exists or no comments are pending, skip update and continue directly.
-2. Call `plan_validate` with `strict: true`. Stop on errors, pending annotations, or Design above 800 words.
-3. Mark the draft ready with `plan_update_status`.
-4. Use one `ask_user_question` call to choose the next action and, when executing now, commit policy. Choices are inline execution, background execution, execute later, or continue planning; commit policy is commit per phase or no commits.
-5. For execute later or continue planning, do not ask for or apply a commit policy. Call `diffpi_modes_unset` before returning so finalization exits to the default inline mode. Otherwise call `plan_start_execution` with the selected mode and policy.

package/skills/plan/references/workflows/go.md

@@ -1,8 +0,0 @@
-# go
-
-1. Require a plan slug and call `plan_context`.
-2. Read explicit `--bg`, `--commit`, and `--no-commit` choices already parsed by the command.
-3. If mode or commit policy is missing in foreground mode, use one `ask_user_question` call for only the missing choices. Never silently default.
-4. Background mode never asks. If a required preference is missing, return a blocker with the exact complete command.
-5. Foreground execution runs in `WORKER` mode. Background execution uses Orchestrator and must preserve the foreground mode.
-6. Call `plan_start_execution` with inline/background mode and commit-per-phase/no-commit policy. For `/plan go --bg`, the already-spawned orchestrator must pass `coordinator: current`; normal callers omit it (default `spawn`). Commit-per-phase execution pushes each phase commit, records pending CI, and launches a bounded background Worker to call `plan_watch_ci` 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. When an inline execution marks the plan completed, `plan_update_status` exits to the default mode automatically. Report the execution ID and whether the foreground mode changed.

package/skills/plan/references/workflows/init.md

@@ -1,6 +0,0 @@
-# init
-
-1. Require one short slug and accept an optional `--branch`.
-2. Call `plan_init` with the explicit intent and title when supplied. The tool creates only `PLAN.md` and `logs.txt`.
-3. Call `plan_annotate` when the annotation launcher is available. Otherwise show its exact fallback command.
-4. Report the plan ID and explain that `/plan update <id>` imports annotations and populates the draft.

package/skills/plan/references/workflows/new.md

@@ -1,8 +0,0 @@
-# new
-
-1. Require a short slug. Call `plan_context`, then `plan_init` if the plan does not exist.
-2. Ground the plan in repository files and the explicit prompt. If no prompt was supplied, use the inherited conversation context supplied by the named Planner RPC dispatch.
-3. In foreground mode, use `ask_user_question` only for decisions that materially change scope. In background mode, never ask; record safe assumptions and stop with a blocker if ambiguity cannot be resolved.
-4. Use `plan_update_overview`, `plan_add_phase`, and `plan_update_phase` to create the plan. Use the planning tools to enforce the declared requirements, references, phase dependencies, file scopes, steps, and acceptance criteria; do not write PLAN.md by hand when a tool can make the change.
-5. Create one implementation file per phase at `.diffpi/plan/<plan-id>/implementation/phase-<phase-id>.md`. Fill in the implementation template with the phase summary, file tree, public APIs and data contracts, required libraries or algorithms, and implementation constraints. Keep each phase focused on one or two modules or libraries unless it is scaffolding.
-6. Keep Design near 300 words and call `plan_validate`. Leave the result as a draft for annotation or finalization.

package/skills/plan/references/workflows/update.md

@@ -1,7 +0,0 @@
-# update
-
-1. Call `plan_context`. Omit the slug only when exactly one candidate is selected.
-2. Call `plan_annotations` before interpreting prompt instructions. A missing annotation session means there is no annotation work.
-3. Apply each unambiguous pending comment, then the explicit instructions, through `plan_update_overview`, `plan_add_phase`, `plan_remove_phase`, or `plan_update_phase`. Preserve stable IDs and completed evidence.
-4. In foreground mode, use `ask_user_question` for unresolved product decisions. In background mode, do not ask; persist and return a blocker.
-5. Call `plan_validate`. Only after successful application, call `plan_ack_annotations` with exactly the applied comment IDs and a concise summary. Failed or partial updates leave unhandled IDs pending.

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

@@ -1,11 +0,0 @@
-# address
-
-1. Parse an optional PR/MR id or URL and `--local`. The `/review` command has already removed `--bg`.
-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 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 `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, unresolved, and skipped counts. Resolved must always be zero in this workflow. Do not publish, complete, or merge.

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

@@ -1,18 +0,0 @@
-# auto
-
-1. Parse an optional PR/MR id or URL and `--local`. The `/review` command has already removed `--bg`. `launch` is an alias for this workflow.
-2. Call `review_context` with the same target and backend selection.
-3. Call `review_new` to create the local tuicr review or remote draft PR/MR and open its tuicr UI. A remote branch must be clean and pushed. If the review already exists, use `review_edit` to open it.
-4. Before reviewing, run `review_gates` so the project's discovered format-check and lint tasks run first, followed by its other gates. Preserve and report failures; do not substitute visual inspection for failed or skipped checks.
-5. Run review judgment as the reviewer agent. Inline, the reviewer performs the workflow tool calls directly. In background execution, the orchestrator delegates judgment to the reviewer and retains lifecycle calls. The reviewer fetches the diff with `review_diff` and may launch parallel lightweight subagents for independent areas when useful.
-6. Review the change for:
-   - whether it accomplishes the stated intent;
-   - whether the technical approach is the best practical way to accomplish that intent;
-   - correctness, including failure paths and edge cases;
-   - code quality, readability, and maintainability;
-   - minimality and conciseness, including unnecessary agent-generated changes;
-   - documentation accuracy and completeness; and
-   - reviewer coordination, including keeping lifecycle ownership clear and avoiding duplicate or conflicting findings.
-     Use parallel lightweight workers for independent review areas when useful, then reconcile their results before submission.
-7. Produce only grounded findings, then call `review_submit`. Pass `local: true` for local findings; remote findings remain pending for `publish` or `complete`.
-8. Report the artifact or pending-review state, finding count, gate results, backend, and any launch instruction. Do not complete or merge the review.

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

@@ -1,7 +0,0 @@
-# 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. 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.
-5. Report the archive path or remote result. Do not call `review_merge`.

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

@@ -1,7 +0,0 @@
-# edit
-
-1. Parse an optional PR/MR number, URL, or branch target and `--local`.
-2. Call `review_context` with the same target and backend selection.
-3. Call `review_edit`. With `--local`, it opens an existing local tuicr session. Without `--local`, it opens an existing PR/MR in tuicr, including a non-draft PR/MR for continued work on its comments.
-4. If no matching local session or remote PR/MR exists, report the error and direct the user to `new`. Do not create a review, generate findings, publish, complete, or merge.
-5. Report whether tuicr opened in a mux, prepared a Zed task, or returned a command.

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

@@ -1,30 +0,0 @@
-# help
-
-Print the following help text:
-
-```text
-Workflows for PRs and local review. Use:
-
-Create a review and generate findings:
-  /review auto [pr-or-branch] [--local] [--bg]
-
-Create a local review or remote draft PR/MR:
-  /review new [title] [--intent text] [--base branch] [--local] [--bg]
-
-Open an existing review without generating findings:
-  /review edit [pr-number|pr-url|branch] [--local] [--bg]
-
-Address review comments:
-  /review address [pr-number|pr-url|branch] [--local] [--bg]
-
-Publish comments and a review status:
-  /review publish [pr-number|pr-url|branch] [--local] [--comment|--approve|--request-changes|--close] [--bg]
-
-Complete a review without merging:
-  /review complete [pr-number|pr-url|branch] [--local|--approve|--reject|--abandon] [--bg]
-
-Merge an approved remote review:
-  /review merge [pr-number|pr-url|branch] [--bg]
-```
-
-`--local` selects the working-tree tuicr backend. Otherwise, a target is a PR/MR number, URL, or branch; no target means the current branch. `--bg` launches a tracked background Orchestrator and leaves the current chat mode unchanged. `new` creates a review. `edit` only opens an existing local session or remote PR/MR. `auto` creates a review, then delegates findings to the reviewer agent. `open`, `create`, and `draft` alias `new`; `launch` aliases `auto`; `close` aliases `complete`. `publish` publishes remote draft PR/MR review comments and status or promotes local comments. `complete` makes a lifecycle decision without merging, or archives the local overlay and deletes its tuicr session.

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

@@ -1,6 +0,0 @@
-# merge
-
-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/new.md

@@ -1,19 +0,0 @@
-# new
-
-## Arguments
-
-```text
-/review new [title] [--intent text] [--base branch] [--local]
-```
-
-- `title` is the optional first positional argument; quote a title containing spaces.
-- `--intent` and `--base` each consume the following value. `--local` is a boolean flag.
-- Flags may appear in any order. Reject unknown or duplicate flags, missing flag values, and extra positional arguments. Stating this grammar before the procedure is intentional: an explicit argument contract is the best practice for making workflow behavior predictable and preventing ambiguous execution.
-
-## Workflow
-
-1. Parse the arguments using the grammar above. A remote target is the current branch; `new` creates a new review rather than opening an existing one.
-2. Call `review_context` with the same backend selection.
-3. Call `review_new` with the parsed title, intent, base branch, and backend selection. With `--local`, it creates and opens a local tuicr working-tree review. Without `--local`, it requires a clean, pushed branch, creates a draft PR/MR, and opens that PR/MR in tuicr.
-4. If a local session or remote PR/MR already exists, direct the user to `edit` instead.
-5. Report the PR/MR URL and whether tuicr opened in a mux, prepared a Zed task, or returned a command. Do not generate findings, publish, complete, or merge.

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

@@ -1,3 +0,0 @@
-# open
-
-`open` is an alias for `new`. Follow `new.md`.

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

@@ -1,8 +0,0 @@
-# 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 `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. 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.