@difflab/pi 0.2.0 → 0.3.0-rc.202609201609.21ba1d2

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';
+export type PlanToolRuntime = Pick<ExtensionAPI, '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,EAAoB,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAQtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAiBL,KAAK,SAAS,EAGf,MAAM,SAAS,CAAC;AAgCjB,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AAEjH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,eAAe,EACnB,KAAK,EAAE,cAAc,EACrB,KAAK,GAAE,SAA6B,GACnC,SAAS,cAAc,EAAE,CAkgB3B"}

package/dist/tools/review.d.ts

@@ -0,0 +1,7 @@
+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 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[]>;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +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;AAwEnB,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"}

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

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAgBlF,eAAO,MAAM,eAAe,EAAE,cA2B5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,cAuB/B,CAAC"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAyBlF,eAAO,MAAM,eAAe,EAAE,cA8B5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,cA0B/B,CAAC"}

package/dist/tools/templates.d.ts

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

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

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

package/dist/vcs/forge-backend.d.ts

@@ -0,0 +1,7 @@
+import type { VcsInfo } from '../environment';
+import type { VcsBackend } from './types';
+export declare function createForgeBackend(vcs: VcsInfo): VcsBackend;
+/** Compatibility names retained for consumers of the former forge API. */
+export declare const createVcsBackend: typeof createForgeBackend;
+export declare const createForge: typeof createForgeBackend;
+//# sourceMappingURL=forge-backend.d.ts.map

package/dist/vcs/forge-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-backend.d.ts","sourceRoot":"","sources":["../../src/vcs/forge-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAI3D;AAED,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,2BAAqB,CAAC;AACnD,eAAO,MAAM,WAAW,2BAAqB,CAAC"}

package/dist/vcs/github.d.ts

@@ -0,0 +1,5 @@
+import type { VcsInfo } from '../environment';
+import type { VcsBackend } from './types';
+export declare function GitHubVcsBackend(vcs: VcsInfo): VcsBackend;
+export declare function assertGitHubMergeReady(input: string): void;
+//# sourceMappingURL=github.d.ts.map

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

@@ -0,0 +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"}

package/dist/vcs/gitlab.d.ts

@@ -0,0 +1,4 @@
+import type { VcsInfo } from '../environment';
+import type { VcsBackend } from './types';
+export declare function GitLabVcsBackend(vcs: VcsInfo): VcsBackend;
+//# sourceMappingURL=gitlab.d.ts.map

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

@@ -0,0 +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"}

package/dist/vcs/helpers.d.ts

@@ -0,0 +1,7 @@
+import type { ForgeProvider } from '../environment';
+import type { CommandResult } from '../extensions/processx';
+export declare function isConfirmedMissingChange(provider: ForgeProvider, output: string): boolean;
+export declare function parseJson<T>(value: string, name: string): T;
+export declare function commandFailure(command: string, args: string[], result: CommandResult): Error;
+export declare function requireBranchName(output: string, provider: string): string;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/vcs/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAUzF;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAM3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,KAAK,CAI5F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1E"}

package/dist/vcs/index.d.ts

@@ -0,0 +1,6 @@
+export { createForge, createForgeBackend, createVcsBackend } from './forge-backend';
+export { GitHubVcsBackend, assertGitHubMergeReady } from './github';
+export { GitLabVcsBackend } from './gitlab';
+export { isConfirmedMissingChange } from './helpers';
+export type { Forge, OpenPrOptions, PrRef, VcsBackend } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vcs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/vcs/types.d.ts

@@ -0,0 +1,32 @@
+import type { ForgeProvider } from '../environment';
+export interface PrRef {
+    number: number;
+    title: string;
+    url: string;
+    isDraft: boolean;
+    baseRef: string;
+    headRef: string;
+    headSha?: string;
+}
+export interface OpenPrOptions {
+    title: string;
+    body: string;
+    base: string;
+    head: string;
+    draft?: boolean;
+}
+/** Hosted VCS lifecycle operations. CLI execution is isolated in extensions/*x. */
+export interface VcsBackend {
+    readonly provider: Exclude<ForgeProvider, 'none'>;
+    createDraftPr(options: OpenPrOptions): Promise<PrRef>;
+    viewPr(idOrBranch: string): Promise<PrRef | undefined>;
+    defaultBranch(): Promise<string>;
+    prDiff(id: number): Promise<string>;
+    prChecks(id: number): Promise<string>;
+    markReady(id: number): Promise<void>;
+    closePr(id: number, comment?: string): Promise<void>;
+    mergePr(id: number, subject: string): Promise<void>;
+}
+/** Compatibility name retained for consumers of the former forge API. */
+export type Forge = VcsBackend;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@difflab/pi",
-  "version": "0.2.0",
+  "version": "0.3.0-rc.202609201609.21ba1d2",
   "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",
@@ -30,7 +33,8 @@
   "files": [
     "agents/",
     "dist/",
-    "skills/"
+    "skills/",
+    "templates/"
   ],
   "pi": {
     "extensions": [
@@ -53,6 +57,7 @@
   },
   "dependencies": {
     "@juicesharp/rpiv-ask-user-question": "^2.10.1",
+    "commander": "^14.0.0",
     "pi-mcp-adapter": "^2.33.0",
     "zod": "^4.6.5"
   },

package/skills/diffpi-setup/SKILL.md

@@ -43,6 +43,8 @@ ask_user_question({
 });
 ```
 
-Map `None`, `Linear`, and `Jira` to `none`, `linear`, and `jira`. If the user selects `Skip` or declines the questionnaire, stop without calling `diffpi_setup`. After successful setup, call `diffpi_reload` when the setup result says pi must restart.
+Map `None`, `Linear`, and `Jira` to `none`, `linear`, and `jira`. Infer the review forge from the current repository remote; do not ask about tuicr or a single forge during ordinary setup. Only when the user explicitly asks to install hosted VCS MCP integrations, ask a multi-select question for GitHub and GitLab and pass the selected values as `forges`; zero selections means no VCS MCP installation. If the user selects `Skip` or declines the questionnaire, stop without calling `diffpi_setup`. After successful setup, call `diffpi_reload` when the setup result says pi must restart.
+
+When the user is using Zed, ask separately whether to bind `cmd-alt-r` to the `diffpi: tuicr review` task. Only pass `bindZedKey: true` when the user opts in; otherwise pass `false`.
 
 Setup installs Diffpi's bundled agent Markdown into Pi's standard global agent directory. Explain that each default can run through the subagent plugin or as the current inline prompt. `/skill:mode` opens the structured picker. It also accepts `--include-skills`, one agent id, a qualified `skill:agent` id, or `clear`.

package/skills/plan/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: plan
+description: Create, annotate, validate, update, and execute durable Diffpi plans. Use for /plan workflows, implementation planning, plan annotations, and resumable plan execution.
+allowed-tools: ask_user_question plan_context plan_init plan_update_overview plan_add_phase plan_remove_phase plan_update_phase plan_validate plan_annotate plan_annotations plan_ack_annotations plan_update_status plan_start_execution diffpi_modes_set diffpi_modes_unset
+---
+
+# plan
+
+Parse the first argument as `init`, `new`, `update`, `annotate`, `finalize`, `go`, or `help`. An empty or unknown verb uses [help](references/workflows/help.md). Read and follow `references/workflows/<verb>.md`.
+
+`--bg` is handled and removed by the `/plan` extension command. Background workflows never ask questions. They record safe assumptions and return an actionable blocker for unresolved decisions. Foreground workflows use `ask_user_question` for every choice that cannot be derived from the request; never ask in plain chat.
+
+Use plan tools for every `PLAN.md`, status, log, gate, and annotation mutation. Do not edit managed plan files directly. Validate after authoring. Preserve stable IDs, user prose, completed evidence, and annotation acknowledgement order.

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

@@ -0,0 +1,6 @@
+# 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

@@ -0,0 +1,7 @@
+# finalize
+
+1. Call `plan_context`, then `plan_annotations`. Apply pending comments through the update workflow before finalization.
+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. Otherwise call `plan_start_execution` with the selected mode and policy.

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

@@ -0,0 +1,7 @@
+# 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. Call `plan_start_execution` with inline/background mode and commit-per-phase/no-commit policy. Report the execution ID and whether the foreground mode changed.

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

@@ -0,0 +1,13 @@
+# help
+
+Use these commands:
+
+- `/plan init <short-slug> [--branch <name>]` creates a phase-less draft.
+- `/plan new <short-slug> [--branch <name>] [--bg] [prompt...]` creates and populates a plan.
+- `/plan update [short-slug] [--branch <name>] [--bg] [instructions...]` applies pending annotations before other instructions.
+- `/plan annotate [short-slug]` opens `PLAN.md` with `tuicr --file`.
+- `/plan finalize [short-slug]` validates and marks a plan ready.
+- `/plan go <short-slug> [--commit|--no-commit] [--bg]` starts execution.
+- `/plan help` shows this reference.
+
+`--branch` records or filters a branch. It does not create or switch branches. Background workflows do not ask questions.

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

@@ -0,0 +1,6 @@
+# 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

@@ -0,0 +1,7 @@
+# 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 current conversation or the bounded context packet supplied by the command.
+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`. Give every phase and task a stable ID, dependencies, file scopes, steps, and acceptance criteria. Do not leave research tasks.
+5. 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

@@ -0,0 +1,7 @@
+# update
+
+1. Call `plan_context`. Omit the slug only when exactly one candidate is selected.
+2. Call `plan_annotations` before interpreting prompt instructions.
+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/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: review
+description: Code review workflows over GitHub, GitLab, or the local tuicr backend. Use for auto reviews, review opening and editing, addressing, publishing, completing, merging, or local review requests.
+allowed-tools: ask_user_question review_context review_new review_edit review_diff review_gates review_submit review_add_comment review_comments review_respond review_publish review_complete review_merge review_launch_ui diffpi_template
+---
+
+# review
+
+Treat `--local` as a backend selector. It always uses the local `tuicr` working-tree backend; without it, the detected GitHub or GitLab forge owns the remote target. Treat `--bg` as an execution selector handled by the `/review` command; it is removed before workflow parsing. Target selection, storage, provenance, templates, comment staging, replies, publication, and forge calls belong to the tools.
+
+Parse the first non-flag argument as VERB and preserve remaining flags. Normalize `open`, `create`, and `draft` to `new`; normalize `launch` to `auto`, `ready` to `publish`, `close` to `complete`, and `land` to `merge`. An empty or unknown verb uses `references/workflows/help.md`.
+
+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.
+
+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/workflows/address.md

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

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

@@ -0,0 +1,18 @@
+# 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

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

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

@@ -0,0 +1,30 @@
+# 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

@@ -0,0 +1,6 @@
+# merge
+
+1. Call `review_context` and confirm the PR/MR is approved and ready.
+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

@@ -0,0 +1,19 @@
+# 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

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

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

@@ -0,0 +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.
+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.

package/templates/plan/PLAN.md

@@ -0,0 +1,38 @@
+<!-- diffpi-plan: {"schemaVersion":1,"id":"{{id}}","revision":0,"branch":"{{branch}}","status":"draft","createdAt":"{{created_at}}","updatedAt":"{{updated_at}}"} -->
+
+# {{title}}
+
+- **Plan ID:** {{id}}
+- **Branch:** {{branch}}
+- **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/review/draft-pr.md

@@ -0,0 +1,25 @@
+## Intent
+
+{{intent}}
+
+## Changes
+
+<!-- List the user-visible or architectural changes. -->
+
+## Validation
+
+<!-- List the checks that were run. -->
+
+- [ ] Existing tests pass
+
+## References
+
+<!-- Link the issue that defines this task. Add related project, epic, and public documentation links when available. -->
+
+- Issue: {{issue_url}}
+
+## Further Work
+
+<!-- Optional: list intentionally deferred follow-up work as bullets, or remove this section. -->
+
+-

package/dist/mise.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mise.d.ts","sourceRoot":"","sources":["../src/mise.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,eAAO,MAAM,IAAI;oCACuB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;sBAI1C,kBAAkB,GAAQ,OAAO,CAAC,MAAM,CAAC;2BAcnC,MAAM,YAAW,eAAe,GAAQ,OAAO,CAAC,cAAc,CAAC;gCAc1D,MAAM,QAAQ,MAAM,mBAAmB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;kCAK9D,MAAM,iBAAiB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;+BAIhD,MAAM,QAAQ,MAAM,iBAAwB,OAAO,CAAC,OAAO,CAAC;iCAK1D,MAAM,iBAAiB,MAAM,iBAAwB,OAAO,CAAC,IAAI,CAAC;oCAI/D,MAAM,qBAAwB,OAAO,CAAC,IAAI,CAAC;CAGlF,CAAC"}

package/dist/process.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAsB9E;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBzG;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAMxB"}