@difflab/pi 0.1.0 → 0.2.0-rc.202609170958.44c1e9f

package/dist/tools/modes.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from '@earendil-works/pi-coding-agent';
+import type { ModeController } from '../modes';
+export declare function createModeTools(controller: ModeController): readonly ToolDefinition[];
+//# sourceMappingURL=modes.d.ts.map

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

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

package/dist/tools/review.d.ts

@@ -0,0 +1,7 @@
+import { type ToolDefinition } from '@earendil-works/pi-coding-agent';
+import { type GateResult } from '../gates';
+export declare function conventionalMergeGuard(subject: string): GateResult;
+export declare function workingTreeDiff(cwd: string): Promise<string>;
+export { assertGitHubMergeReady } from '../forge';
+export declare function createReviewTools(): readonly ToolDefinition[];
+//# 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;AAIzG,OAAO,EAAkD,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAoG3F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAElE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAalE;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAIlD,wBAAgB,iBAAiB,IAAI,SAAS,cAAc,EAAE,CA+X7D"}

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,cA0B5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,cAsB/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;AAqBlF,eAAO,MAAM,eAAe,EAAE,cA6B5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,cAyB/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/tuicr.d.ts

@@ -0,0 +1,55 @@
+import { type LaunchResult } from './environment';
+import type { ReviewComment } from './review-types';
+export interface SessionSummary {
+    slug: string;
+    kind: string;
+    path: string;
+    updatedAt: string;
+    commentCount: number;
+    anchor: string;
+    active: boolean;
+}
+interface SessionCommentJson {
+    content: string;
+    side?: 'old' | 'new' | null;
+    username?: string;
+    author?: string;
+}
+interface SessionFileJson {
+    file_comments?: SessionCommentJson[];
+    line_comments?: Record<string, SessionCommentJson[]>;
+}
+export interface SessionJson {
+    branch_name?: string;
+    repo_path?: string;
+    review_comments?: SessionCommentJson[];
+    files?: Record<string, SessionFileJson>;
+}
+export declare function tuicrAvailable(): Promise<boolean>;
+export declare function listSessions(repo?: string): Promise<SessionSummary[]>;
+export declare function resolveSession(cwd: string, branch: string): Promise<SessionSummary | undefined>;
+export declare function resolveReviewSession(cwd: string, target: {
+    branch: string;
+    workingTree?: boolean;
+    owner?: string;
+    repo?: string;
+    number?: number;
+}): Promise<SessionSummary | undefined>;
+export declare function resolvePrSession(cwd: string, owner: string, repo: string, number: number): Promise<SessionSummary | undefined>;
+export declare function findMatchingSession(sessions: readonly SessionSummary[], cwd: string, branch: string): Promise<SessionSummary | undefined>;
+export declare function readSession(path: string): Promise<SessionJson>;
+export declare function addComment(session: string, body: string, opts?: {
+    targetFile?: string;
+    line?: number;
+    side?: 'old' | 'new';
+    username?: string;
+}): Promise<void>;
+export declare function launch(cwd: string, pr?: number | string): Promise<LaunchResult>;
+export declare function toFindings(session: SessionJson, options?: {
+    agentOnly?: boolean;
+}): {
+    comments: ReviewComment[];
+    body: string;
+};
+export {};
+//# sourceMappingURL=tuicr.d.ts.map

package/dist/tuicr.d.ts.map

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

package/dist/zed.d.ts

@@ -0,0 +1,11 @@
+export declare const ZED_REVIEW_TASK_NAME = "diffpi: tuicr review";
+export interface ZedEnsureResult {
+    path: string;
+    changed: boolean;
+    existed: boolean;
+}
+export declare function zedTasksPath(homeDir?: string): string;
+export declare function zedKeymapPath(homeDir?: string): string;
+export declare function ensureZedReviewTask(homeDir?: string): Promise<ZedEnsureResult>;
+export declare function ensureZedReviewKeybinding(homeDir?: string): Promise<ZedEnsureResult>;
+//# sourceMappingURL=zed.d.ts.map

package/dist/zed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zed.d.ts","sourceRoot":"","sources":["../src/zed.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAmB3D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAWD,wBAAgB,YAAY,CAAC,OAAO,SAAY,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,OAAO,SAAY,GAAG,MAAM,CAEzD;AAED,wBAAsB,mBAAmB,CAAC,OAAO,SAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAWvF;AAED,wBAAsB,yBAAyB,CAAC,OAAO,SAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAgB7F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@difflab/pi",
-  "version": "0.1.0",
+  "version": "0.2.0-rc.202609170958.44c1e9f",
   "description": "Tools and skills for the pi coding agent",
   "repository": {
     "type": "git",
@@ -28,8 +28,10 @@
     }
   },
   "files": [
+    "agents/",
     "dist/",
-    "skills/"
+    "skills/",
+    "templates/"
   ],
   "pi": {
     "extensions": [

package/skills/diffpi-setup/SKILL.md

@@ -23,6 +23,16 @@ ask_user_question({
       ],
       multiSelect: false,
     },
+    {
+      question: 'Which forge should diffpi configure for /review?',
+      header: 'Forge',
+      options: [
+        { label: 'None', description: 'Use local tuicr review without a forge CLI or MCP server.' },
+        { label: 'GitHub', description: 'Install gh and register the GitHub MCP server with OAuth.' },
+        { label: 'GitLab', description: 'Install glab and register the GitLab MCP server with OAuth.' },
+      ],
+      multiSelect: false,
+    },
     {
       question:
         'Allow diffpi to install mise, add its activation hook to your shell configuration, and install required development tools if they are missing?',
@@ -43,4 +53,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`. Map the forge answer `None`, `GitHub`, or `GitLab` to `forge: none`, `github`, or `gitlab`. Keep the forge at `none` unless the user selects one. 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/mode/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: mode
+description: List, select, or clear an inline agent profile. Use when the user invokes /skill:mode or asks to change the current Diffpi mode.
+allowed-tools: ask_user_question diffpi_modes_list diffpi_modes_set diffpi_modes_unset
+---
+
+# Mode
+
+Pi appends `/skill:mode` arguments as `User: <arguments>`. Route those arguments without manual command parsing in the extension.
+
+## Direct requests
+
+- If the argument is `help`, `-h`, or `--help`, print the usage and examples below. Do not call a tool.
+- If the argument is `clear`, call `diffpi_modes_unset` and stop.
+- If the argument is one agent id, call `diffpi_modes_set` with that exact id and stop.
+- A qualified id such as `spec:planner` is one agent id. The tool enables skill-agent discovery for it.
+- If the request contains multiple agent ids or an unsupported flag, print the usage and stop.
+
+```text
+/skill:mode [--include-skills] [agent|clear]
+/skill:mode
+/skill:mode --include-skills
+/skill:mode worker
+/skill:mode spec:planner
+/skill:mode clear
+```
+
+## Picker
+
+Use the picker when there are no arguments or when the only argument is `--include-skills`.
+
+1. Call `diffpi_modes_list`. Set `includeSkills` to true only for `--include-skills`.
+2. Call `ask_user_question` with one single-select question. Do not ask as plain chat text.
+3. Put the complete list of valid ids in the question text. Offer Default plus at most three relevant agents as structured options. The custom-answer row lets the user enter any other valid id.
+4. If the user selects Default or enters `clear`, call `diffpi_modes_unset`.
+5. Otherwise, call `diffpi_modes_set` with the selected or entered id.
+
+Do not perform unrelated work. Explain that the selected prompt, preferred available model, thinking level, and tool set start on the next turn. Mode selection is not a security boundary.

package/skills/review/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: review
+description: Code review workflows over GitHub, GitLab, or the local tuicr backend. Use for review open, new, edit, address, publish, merge, or local review requests.
+allowed-tools: ask_user_question review_context review_open review_edit review_diff review_gates review_submit review_add_comment review_comments review_respond review_publish review_merge review_launch diffpi_template
+---
+
+# review
+
+Treat `--local` as a backend selector. The local backend is `tuicr`; the remote backend is the detected GitHub or GitLab forge. 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 `create` and `draft` to `open`, `ready` to `publish`, and `land` to `merge`. An empty or unknown verb uses `references/workflows/help.md`. The removed `complete` verb is not an alias.
+
+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.
+
+Workflow index: `open` creates a draft PR/MR or opens a local target; `new` generates a review and leaves remote comments pending; `edit` opens an existing target in tuicr without generating comments; `address` fixes comments and records or posts replies; `publish` promotes local drafts and publishes with a status; `merge` is the separate GitHub-only merge action; `help` prints the reference.

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

@@ -0,0 +1,10 @@
+# address
+
+1. Parse an optional PR/MR id or URL and `--local`.
+2. Call `review_context` with the target and backend selection.
+3. Call `review_comments`. With `--local`, the tool pulls remote threads or the exact matching tuicr session into `.diffpi/reviews/YYMMDD-<short-head-sha>.md` or `.diffpi/reviews/YYMMDD-local.md`. This Markdown file is the local reply overlay for remote threads.
+4. For each comment, inspect the referenced code. Apply a justified fix when the comment requests a change. Answer every question even when no code change is needed.
+5. Call `review_respond` for each thread. With `--local`, replies stay in the local overlay until `publish --local`. Without `--local`, replies post to the forge immediately.
+6. Pass `question: true` for a question. Question threads remain open after the reply. A non-question remote thread resolves only after its requested change is applied; otherwise pass `resolve: false`.
+7. With `--local`, call `review_edit` after replies are recorded so the user can inspect the PR and local draft in tuicr.
+8. Report fixed, answered, unresolved, and deferred counts. Do not publish pending comments or replies in this workflow.

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

@@ -0,0 +1,9 @@
+# edit
+
+This workflow is local-only. It opens a review target in tuicr without generating findings or changing existing comments.
+
+1. Parse an optional PR/MR id or URL and `--working-tree`.
+2. Call `review_context` with `local: true` and the supplied target.
+3. Call `review_edit`. With no target, the tool opens the current branch PR/MR when one exists and otherwise opens working-tree changes.
+4. If an id or URL names a PR/MR on another branch, the tool requires a clean worktree, fetches that branch, and switches the current worktree before it opens tuicr.
+5. Report whether tuicr opened in a mux, prepared a Zed task, or returned a command for the user to run.

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

@@ -0,0 +1,12 @@
+# help
+
+```text
+/review open [--local] [--base branch]
+/review new [target] [--local] [--working-tree]
+/review edit [target] [--working-tree]
+/review address [target] [--local]
+/review publish [target] [--local] [--comment|--approve|--request-changes|--close]
+/review merge [target]
+```
+
+`--local` selects tuicr as the review backend. `new` generates findings; `edit` only opens an existing target. Local records and reply overlays are stored under `.diffpi/reviews/`. Publish makes pending work public with a status but never merges. Merge remains a separate GitHub-only workflow.

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,9 @@
+# new
+
+1. Parse an optional PR/MR id or URL, `--local`, and `--working-tree`.
+2. Call `review_context` with the same target and backend selection.
+3. Call `review_diff` and `review_gates`. With `--local`, the default target is the current branch PR/MR when one exists; otherwise it is the working tree. `--working-tree` always selects staged and unstaged local changes.
+4. Review the diff for intent, correctness, slop, and adversarial risk. Build findings as `{ file, line, severity, body, reference }`. Collect unanchorable blocking issues separately.
+5. For `--local`, call `review_launch` before `review_submit` so tuicr creates the target session. Call `review_submit` with `local: true`. The tool records the exact active provider/model as the tuicr author and writes `.diffpi/reviews/YYMMDD-<short-head-sha>.md` or `.diffpi/reviews/YYMMDD-local.md`.
+6. For a remote review, call `review_submit` without `local`. The tool adds the provider/model disclaimer to every comment and leaves the review pending. Do not publish it in this workflow.
+7. Report the artifact path, comment count, backend, and whether the user must run a printed tuicr command.

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

@@ -0,0 +1,7 @@
+# open
+
+1. Parse an optional title, intent, base branch, and `--local`.
+2. Call `review_context`.
+3. With `--local`, call `review_open` with `local: true`. The tool auto-detects the current branch PR/MR and opens it in tuicr; when no PR/MR exists, it opens working-tree changes.
+4. Without `--local`, derive a concise title and intent from the branch and change context, then call `review_open`. The tool loads `review/draft-pr.md` from the generic template registry, preferring `~/.difflab/diffpi/templates/review/draft-pr.md` over the bundled default, renders it, and creates a draft PR/MR against the requested or repository default branch.
+5. Report the PR/MR URL or the tuicr launch instruction. Do not publish or merge.

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/review/draft-pr.md

@@ -0,0 +1,18 @@
+## Intent
+
+{{intent}}
+
+## Changes
+
+<!-- List the user-visible or architectural changes. -->
+
+## Validation
+
+<!-- List the checks that were run. -->
+
+- [ ] Existing tests pass
+
+## Review context
+
+- Source branch: `{{head}}`
+- Target branch: `{{base}}`