@ramon-sg/issue-flow 0.2.3 → 0.2.5

package/README.md

@@ -14,7 +14,7 @@ Flujo de trabajo de issue a PR para cualquier repo, en local y en las sesiones d
 - **`issue-flow adapter setup|issue|archive`:** lo que corren Orca y Paseo al crear o borrar un worktree.
 - **`issue-flow session`:** el hook `SessionStart`; en la nube llama a [`claude-cloud`](https://github.com/ramon-sg/claude-cloud).
 - **`issue-flow hook worktree-create|worktree-remove`:** los hooks `WorktreeCreate` y `WorktreeRemove` de Claude Code, para `claude --worktree`.
-- **Skills:** `github-issues`, `start-issue`, `close-pr`, `pr-review-comments` y `pr-worktree`.
+- **Skills:** `github-issues`, `start-issue`, `finish-pr`, `close-pr`, `pr-review-comments` y `pr-worktree`.
 
 ## Nombre de la rama
 
@@ -44,6 +44,8 @@ La rama se arma con la plantilla del repo y el slug sale, en este orden:
 
 ## Empezar una issue
 
+Las cuatro formas de empezar una issue (terminal, la skill en una sesión, la nube de Claude, Orca y Paseo), paso a paso: [docs/flujos.md](docs/flujos.md).
+
 ```sh
 issue-flow issue start 42              # worktree en .claude/worktrees/, PR en draft y Claude
 issue-flow issue start 42 --dry-run    # el resumen, sin cambiar nada (solo hace git fetch)
@@ -220,11 +222,12 @@ Viven en `skills/` y `skills-catalog.json` las lista. Se instalan con [`skills-m
 |---|---|---|---|
 | `github-issues` | Issues | Una issue corta con cabecera de tres líneas, criterios comprobables y el slug de su rama; comprueba duplicados y el tope de palabras | — |
 | `start-issue` | Issues | Empieza una issue desde una sesión con `issue-flow issue start`, en local, en un worktree o en la nube | — |
-| `close-pr` | PRs | Auditoría, documentos al día, ready, revisión y CI, y merge con merge commit solo con un review aprobado | `pr-review-comments` |
+| `finish-pr` | PRs | Auditoría, documentos al día, ready, revisión y CI, y el chequeo de que se puede mergear; se detiene antes del merge con un reporte de qué falta y cómo limpiar | `pr-review-comments` |
+| `close-pr` | PRs | Corre `finish-pr` y, si quedó listo, mergea con merge commit y limpia la rama y el worktree | `finish-pr` |
 | `pr-review-comments` | PRs | Verifica cada comentario y check contra el código, propone un plan, aplica lo aprobado y responde los hilos | `github-issues` |
 | `pr-worktree` | PRs | Revisa un PR en su worktree con `issue-flow pr worktree`, sin tocar el checkout principal | `close-pr` |
 
-`agent-kitchen` las instala con el catálogo en la tag de la versión del flujo y las mueve con él. `close-pr` y `pr-worktree` usan `code-audit`, del catálogo [`agent-skills`](https://github.com/ramon-sg/agent-skills): `agent-kitchen` ofrece los dos.
+`agent-kitchen` las instala con el catálogo en la tag de la versión del flujo y las mueve con él. `finish-pr` (y con ella `close-pr`) y `pr-worktree` usan `code-audit`, del catálogo [`agent-skills`](https://github.com/ramon-sg/agent-skills): `agent-kitchen` ofrece los dos.
 
 **Lo propio de cada repo va en `project.md`**, que cada skill (salvo `pr-worktree`) crea desde su plantilla al instalarse: los labels y el assignee, qué flujo sigue cada issue, qué corre sin preguntar al cerrar, qué bots revisan y qué cuenta como review aprobado. Ese archivo es del repo: `check` no lo marca y las actualizaciones lo conservan.
 
@@ -261,7 +264,7 @@ Todo es opcional; sin el archivo valen los valores por defecto. Una clave descon
 | `worktrees.ports` | Apagado | `true` para bloques de 10 desde 20000, o `{ start, blockSize, blocks }` |
 | `worktrees.dockerProjects` | Ninguno | Prefijos de los proyectos de Compose de los worktrees |
 | `start.commitMessage` | `chore: empieza el trabajo en la issue #{number} [skip ci]` | Commit vacío inicial |
-| `start.prBody` | `{keyword} #{number}` y "En progreso." | Cuerpo del PR en draft |
+| `start.prBody` | `{keyword} #{number}`, la URL de la issue (`{url}`) y "En progreso." | Cuerpo del PR en draft |
 | `start.prompt`, `start.resumePrompt` | Resumir la issue y seguir `start-issue`, o retomar desde `{plan}` | Pedido con que se abre Claude |
 | `start.summaryPrompt`, `start.summaryPlanPrompt` | Resumir y esperar | Pedido de `--plan` |
 | `start.cloudPrompt` | `/start-issue {number} --yes{flags}` | Lo que `--cloud` le pide a la sesión; `{flags}` es `--new` o `--resume <rama>` |

package/dist/config.js

@@ -34,7 +34,7 @@ export const DEFAULT_CONFIG = {
     worktrees: { dir: ".claude/worktrees", setup: [], teardown: [], ports: null, dockerProjects: [] },
     start: {
         commitMessage: "chore: empieza el trabajo en la issue #{number} [skip ci]",
-        prBody: "{keyword} #{number}\n\nEn progreso.",
+        prBody: "{keyword} #{number}\n\nIssue: {url}\n\nEn progreso.",
         prompt: "Issue #{number}. Lee la issue con `npx @ramon-sg/github-rest issue view {number}`, resúmela en lenguaje llano y sigue la skill start-issue para elegir el flujo.",
         resumePrompt: "Issue #{number}. Lee la issue con `npx @ramon-sg/github-rest issue view {number}`, resúmela en lenguaje llano y retoma el trabajo según {plan}: revisa qué tareas quedan.",
         summaryPrompt: "Issue #{number}. Lee la issue con `npx @ramon-sg/github-rest issue view {number}` y resúmela en lenguaje llano. No empieces a trabajar ni a planificar: espera mi pedido.",

package/dist/issue-text.d.ts

@@ -69,13 +69,14 @@ export declare function nextBranch(proposed: string, used: string[]): string;
 export declare function fill(template: string, values: Record<string, string>): string;
 /**
  * The draft PR's body from the config's template.
- * @param template - The template, with `{keyword}` and `{number}`.
+ * @param template - The template, with `{keyword}`, `{number}` and `{url}`.
  * @param number - The issue.
  * @param kind - Whether the PR closes the issue or is part of it.
+ * @param url - The issue's URL.
  * @returns The body.
- * @example prBody("{keyword} #{number}", 4, "part") // "Part of #4"
+ * @example prBody("{keyword} #{number}", 4, "part", url) // "Part of #4"
  */
-export declare function prBody(template: string, number: number, kind: PrKind): string;
+export declare function prBody(template: string, number: number, kind: PrKind, url: string): string;
 /**
  * The body of a PR with the words that close the issue (`Closes`, `Fixes`, `Resolves` and
  * their forms, with or without `:`) changed to `Part of`, because the issue now has more

package/dist/issue-text.js

@@ -121,14 +121,15 @@ export function fill(template, values) {
 }
 /**
  * The draft PR's body from the config's template.
- * @param template - The template, with `{keyword}` and `{number}`.
+ * @param template - The template, with `{keyword}`, `{number}` and `{url}`.
  * @param number - The issue.
  * @param kind - Whether the PR closes the issue or is part of it.
+ * @param url - The issue's URL.
  * @returns The body.
- * @example prBody("{keyword} #{number}", 4, "part") // "Part of #4"
+ * @example prBody("{keyword} #{number}", 4, "part", url) // "Part of #4"
  */
-export function prBody(template, number, kind) {
-    return fill(template, { keyword: kind === "part" ? "Part of" : "Closes", number: String(number) });
+export function prBody(template, number, kind, url) {
+    return fill(template, { keyword: kind === "part" ? "Part of" : "Closes", number: String(number), url });
 }
 /**
  * The body of a PR with the words that close the issue (`Closes`, `Fixes`, `Resolves` and

package/dist/start-place.js

@@ -142,7 +142,7 @@ export async function publish(state) {
             head: branch,
             base: state.base,
             title: state.issue.title,
-            body: prBody(options.config.start.prBody, options.number, state.kind),
+            body: prBody(options.config.start.prBody, options.number, state.kind, state.issue.url),
             draft: true,
         });
         state.out.stdout(`${created.url}\n`);

package/dist/start-summary.js

@@ -67,7 +67,7 @@ export function plannedActions(state) {
     if (commit || !onOrigin(mainRoot, branch))
         actions.push("push -u");
     if (state.pr === null) {
-        const first = prBody(state.options.config.start.prBody, number, state.kind).split("\n")[0];
+        const first = prBody(state.options.config.start.prBody, number, state.kind, state.issue.url).split("\n")[0];
         actions.push(`draft PR (${first})`);
         const others = openPrsElsewhere(state.work.prs, branch);
         if (state.kind === "part" && others.length > 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramon-sg/issue-flow",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Issue-to-PR workflow for any repo: names each issue's branch, creates its worktree, opens the draft PR and launches Claude Code, locally and in Claude's cloud.",
   "license": "MIT",
   "type": "module",

package/schema.json

@@ -188,10 +188,10 @@
           "default": "chore: empieza el trabajo en la issue #{number} [skip ci]"
         },
         "prBody": {
-          "description": "Body of the draft PR; {keyword} is Closes, or Part of when the issue has another live branch.",
+          "description": "Body of the draft PR; {keyword} is Closes, or Part of when the issue has another live branch; {number} and {url} are the issue's. The session that starts the issue changes \"En progreso.\" for a short summary.",
           "type": "string",
           "minLength": 1,
-          "default": "{keyword} #{number}\n\nEn progreso."
+          "default": "{keyword} #{number}\n\nIssue: {url}\n\nEn progreso."
         },
         "prompt": {
           "description": "Prompt Claude opens with on a new branch; {number}, {title} (text anyone can write in the issue: better left out).",