@difflab/pi 0.1.0 → 0.2.0-rc.202609170717.9cb91d1

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 assertGitHubMergeReady(input: string): void;
+export declare function reviewSubmissionBody(body: string): string;
+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,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAIlF,OAAO,EAAkD,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAiD3F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAElE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CA0C1D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,iBAAiB,IAAI,SAAS,cAAc,EAAE,CA+V7D"}

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/tuicr.d.ts

@@ -0,0 +1,43 @@
+import type { ForgeProvider } from './environment';
+import { type LaunchResult } from './environment';
+import type { ReviewComment } from './forge';
+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;
+}
+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 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;
+    username?: string;
+}): Promise<void>;
+export declare function launch(cwd: string): Promise<LaunchResult>;
+export declare function toFindings(session: SessionJson): {
+    comments: ReviewComment[];
+    body: string;
+};
+export type { ForgeProvider };
+//# 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":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;CAC7B;AAED,UAAU,eAAe;IACvB,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACzC;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvD;AAED,wBAAsB,YAAY,CAAC,IAAI,SAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA0BxE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAErG;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAarC;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAOpE;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAE/D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkB5F;AAUD,YAAY,EAAE,aAAa,EAAE,CAAC"}

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.202609170717.9cb91d1",
   "description": "Tools and skills for the pi coding agent",
   "repository": {
     "type": "git",
@@ -28,6 +28,7 @@
     }
   },
   "files": [
+    "agents/",
     "dist/",
     "skills/"
   ],

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,13 @@
+---
+name: review
+description: Code review workflows over GitHub, GitLab, or the local tuicr TUI. Use for review open, new, address, publish, complete, merge, or local review requests.
+allowed-tools: ask_user_question review_context review_open review_diff review_gates review_submit review_comments review_respond review_publish review_complete review_merge review_launch
+---
+
+# review
+
+Parse the first non-flag argument as VERB and preserve remaining flags. Normalize `create`/`draft` to `open`, `ready` to `publish`, 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.
+
+Workflow index: `open` creates a draft or local session; `new` reviews a diff; `address` handles unresolved comments; `publish` submits pending work; `complete` approves, rejects, closes, or archives; `merge` squash-merges; `help` prints the reference.

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

@@ -0,0 +1,6 @@
+# address
+
+1. Call `review_context` and `review_comments`.
+2. Read each target file around its referenced line and propose a concrete fix.
+3. In local mode, write proposals for the user. Otherwise apply approved fixes, then use the forge MCP or `review_respond` to reply and resolve each addressed thread.
+4. Report applied, skipped, and failed counts; remind the user to commit with the git workflow.

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

@@ -0,0 +1,6 @@
+# complete
+
+1. Call `review_context`.
+2. Map `--accept` to `accept`, `--reject` to `reject`, `--close` to `close`, and `--local` to `local`.
+3. Call `review_complete` with the action and optional comment.
+4. Remind the user that accept does not merge; use `/review merge` separately.

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

@@ -0,0 +1,12 @@
+# help
+
+```text
+/review open [--local]       create a draft PR/MR or tuicr session
+/review new [--local]        generate an inline review
+/review address [--local]    address unresolved review comments
+/review publish [--local]    publish pending review work
+/review complete [--accept|--reject|--close|--local]
+/review merge                squash-merge an approved PR/MR
+```
+
+Use `--local` for file-based tuicr review. Local artifacts are stored under `.pi/diffpi/`.

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,6 @@
+# new
+
+1. Call `review_context`, `review_diff`, and `review_gates`.
+2. Review the diff for intent, correctness, slop, and adversarial risk. Build findings `{ file, line, severity, body, reference }` and collect un-anchorable BLOCKING issues separately.
+3. Call `review_submit` with findings, overallIssues, and notVerified; pass `local: true` for the local flow.
+4. Report the artifact path and comment count.

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

@@ -0,0 +1,6 @@
+# open
+
+1. Call `review_context`.
+2. With `--local` or no forge, call `review_open` with `local: true`; report the record and printed command when no tab opened.
+3. Otherwise call `review_open` and report the draft PR/MR URL.
+4. Tell the user to fill the body, then run `/review new`.

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

@@ -0,0 +1,5 @@
+# publish
+
+1. Call `review_context`.
+2. Call `review_publish`; pass `local: true` to publish a tuicr session first, and pass the requested event when supplied.
+3. Report submission and draft-ready state.