@henryqw/pi-pr 3.1.1 → 3.1.2

package/README.md

@@ -34,11 +34,13 @@ write files.
 
 ## Use
 
-Run `/pr` without arguments in a GitHub checkout. It reads the current branch pull request and local state, then runs one route. The PR hostname selects its GitHub API host, and the extension works outside Herdr.
+Run `/pr` in a GitHub checkout. It reads the current branch pull request and local state, then runs one route. The PR hostname selects its GitHub API host, and the extension works outside Herdr.
+
+Add optional instructions to guide a creation, branch-update, CI-fix, or feedback workflow. For example, run `/pr keep the title under 50 characters`. Direct routes, such as linking or merging, reject instructions instead of ignoring them.
 
 | Surface | Type | Purpose |
 | --- | --- | --- |
-| `/pr` | command | Run the current pull request's next safe route. |
+| `/pr [instructions]` | command | Run the current pull request's next safe route. |
 | Footer | ui | Show a linked `PR #number` and one plain-language status. |
 | Widget | ui | Show one actionable icon-prefixed `Run /pr to …` hint. |
 

package/extensions/pr-command.ts

@@ -34,7 +34,12 @@ type PrCommandDependencies = {
 	linkInferredPullRequest?: typeof linkInferredPullRequest;
 };
 
-function dispatchWorkflow(pi: PrCommandPi, ctx: ExtensionCommandContext, commandName: string): void {
+function dispatchWorkflow(
+	pi: PrCommandPi,
+	ctx: ExtensionCommandContext,
+	commandName: string,
+	instructions: string,
+): void {
 	const command = pi.getCommands().find((candidate) =>
 		candidate.name === commandName &&
 		candidate.source === "skill" &&
@@ -45,7 +50,7 @@ function dispatchWorkflow(pi: PrCommandPi, ctx: ExtensionCommandContext, command
 	const options = ctx.isIdle()
 		? { expandPromptTemplates: true }
 		: { deliverAs: "followUp" as const, expandPromptTemplates: true };
-	pi.sendUserMessage(`/${command.name}`, options);
+	pi.sendUserMessage(`/${command.name}${instructions ? ` ${instructions}` : ""}`, options);
 }
 
 function noActionNotification(pullRequest: CurrentPullRequest): { message: string; type: "info" | "warning" } {
@@ -171,10 +176,12 @@ export function createPrCommandHandler(
 	const load = dependencies.loadCurrentPullRequest ?? loadCurrentPullRequest;
 	const link = dependencies.linkInferredPullRequest ?? linkInferredPullRequest;
 	return async (args, ctx) => {
-		if (args.trim()) throw new Error("/pr does not accept arguments");
-
+		const instructions = args.trim();
 		const discovery = await load(pi, ctx);
 		const nextStep = deriveNextStep(discovery);
+		if (instructions && !(nextStep in WORKFLOWS)) {
+			throw new Error("The current /pr route does not accept instructions");
+		}
 		if (discovery.kind === "inactive") return nextStep;
 		if (discovery.kind === "blocked") {
 			return nextStep;
@@ -197,7 +204,7 @@ export function createPrCommandHandler(
 		}
 
 		if (!(nextStep in WORKFLOWS)) throw new Error(`/pr cannot dispatch route ${nextStep}`);
-		dispatchWorkflow(pi, ctx, WORKFLOWS[nextStep as WorkflowNextStep]);
+		dispatchWorkflow(pi, ctx, WORKFLOWS[nextStep as WorkflowNextStep], instructions);
 		return nextStep;
 	};
 }

package/extensions/pr.ts

@@ -320,7 +320,7 @@ export default function pullRequestExtension(
 
 	const commandHandler = createCommandHandler(pi);
 	pi.registerCommand("pr", {
-		description: "Run the current branch pull request next step",
+		description: "[instructions] — Run the current branch pull request next step",
 		handler: async (args, ctx) => {
 			if (!ctx.hasUI || !context) return;
 			const generation = sessionGeneration;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-pr",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "Run /pr to safely discover or link the current pull request, then create, update, address feedback, fix CI, or merge when ready.",
   "keywords": [
     "pi-package",