@lonca/baron-recipes 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -7,14 +7,17 @@ import { KnowledgeLoop } from '@lonca/baron-knowledge-loop';
  */
 declare const RECIPE_OPS: {
     readonly issueCreate: "issue.create";
+    readonly issueGet: "issue.get";
     readonly issueTransition: "issue.transition";
     readonly issueComment: "issue.comment";
     readonly issueLink: "issue.link";
+    readonly issueAssign: "issue.assign";
     readonly issueQuery: "issue.query";
     readonly scmBranchCreate: "scm.branch.create";
     readonly scmPrCreate: "scm.pr.create";
     readonly scmPrThread: "scm.pr.thread";
     readonly scmPrStatus: "scm.pr.status";
+    readonly scmPrFind: "scm.pr.find";
     readonly ciRunTrigger: "ci.run.trigger";
     readonly ciRunCancel: "ci.run.cancel";
     readonly deployDeployments: "deploy.deployments";
@@ -130,7 +133,7 @@ interface RunRecipeResult {
 declare function runRecipe(recipe: Recipe, options: RunRecipeOptions): Promise<RunRecipeResult>;
 
 /** The recipes Baron ships out of the box, runnable by name (no file path). */
-declare const BUILTIN_RECIPE_NAMES: readonly ["task-start", "task-finish", "ship"];
+declare const BUILTIN_RECIPE_NAMES: readonly ["task-new", "task-start", "task-finish", "ship"];
 type BuiltinRecipeName = (typeof BUILTIN_RECIPE_NAMES)[number];
 declare function isBuiltinRecipe(name: string): name is BuiltinRecipeName;
 /** Raw YAML of a built-in recipe (the canonical file — no inlined copy, so it can never drift). */

package/dist/index.js

@@ -3,14 +3,17 @@ import { BaronError } from "@lonca/baron-core";
 import { parse as parseYaml } from "yaml";
 var RECIPE_OPS = {
   issueCreate: "issue.create",
+  issueGet: "issue.get",
   issueTransition: "issue.transition",
   issueComment: "issue.comment",
   issueLink: "issue.link",
+  issueAssign: "issue.assign",
   issueQuery: "issue.query",
   scmBranchCreate: "scm.branch.create",
   scmPrCreate: "scm.pr.create",
   scmPrThread: "scm.pr.thread",
   scmPrStatus: "scm.pr.status",
+  scmPrFind: "scm.pr.find",
   ciRunTrigger: "ci.run.trigger",
   ciRunCancel: "ci.run.cancel",
   deployDeployments: "deploy.deployments",
@@ -336,10 +339,14 @@ async function dispatchOp(ports, op, params) {
         ...optStrArray(params, "labels", op) !== void 0 ? { labels: optStrArray(params, "labels", op) } : {},
         ...optStr(params, "initialRole", op) !== void 0 ? { initialRole: reqRole(params, "initialRole", op) } : {}
       });
+    case RECIPE_OPS.issueGet:
+      return issues(ports, op).get(reqStr(params, "id", op));
     case RECIPE_OPS.issueTransition:
       return issues(ports, op).transition(reqStr(params, "id", op), reqRole(params, "role", op));
     case RECIPE_OPS.issueComment:
       return issues(ports, op).comment(reqStr(params, "id", op), reqStr(params, "body", op));
+    case RECIPE_OPS.issueAssign:
+      return issues(ports, op).assign(reqStr(params, "id", op), reqStr(params, "assignee", op));
     case RECIPE_OPS.issueLink:
       return issues(ports, op).link(
         reqStr(params, "fromId", op),
@@ -375,6 +382,10 @@ async function dispatchOp(ports, op, params) {
       );
     case RECIPE_OPS.scmPrStatus:
       return scm(ports, op).prStatus(reqStr(params, "pullRequestId", op));
+    case RECIPE_OPS.scmPrFind: {
+      const found = await scm(ports, op).prForBranch(reqStr(params, "sourceBranch", op));
+      return found ?? null;
+    }
     case RECIPE_OPS.ciRunTrigger: {
       const ref = optStr(params, "ref", op);
       const variables = optStrRecord(params, "variables", op);
@@ -478,7 +489,7 @@ async function runRecipe(recipe, options) {
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
 var RECIPES_DIR = fileURLToPath(new URL("../recipes/", import.meta.url));
-var BUILTIN_RECIPE_NAMES = ["task-start", "task-finish", "ship"];
+var BUILTIN_RECIPE_NAMES = ["task-new", "task-start", "task-finish", "ship"];
 function isBuiltinRecipe(name) {
   return BUILTIN_RECIPE_NAMES.includes(name);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lonca/baron-recipes",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
@@ -17,13 +17,13 @@
   ],
   "dependencies": {
     "yaml": "^2.6.0",
-    "@lonca/baron-core": "0.1.0",
-    "@lonca/baron-knowledge-loop": "0.1.0"
+    "@lonca/baron-core": "0.2.0",
+    "@lonca/baron-knowledge-loop": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@lonca/baron-conformance": "0.1.0",
-    "@lonca/baron-adapter-github": "0.1.0"
+    "@lonca/baron-adapter-github": "0.2.0",
+    "@lonca/baron-conformance": "0.2.0"
   },
   "description": "Baron recipe engine: run declarative YAML workflows over Baron primitives, deterministically.",
   "keywords": [

package/recipes/task-finish.yaml

@@ -1,5 +1,5 @@
 name: task-finish
-description: Open a pull request for a branch and move its issue to review.
+description: Open a draft pull request for a work-item branch and post the PR link back on the item. Deliberately does NOT move the item's role — review/testing state changes when the PR actually merges, not when it opens.
 steps:
   - ask: { as: issueId, type: text, message: "Issue id?" }
   - ask: { as: branch, type: text, message: "Source branch?" }
@@ -11,12 +11,13 @@ steps:
       title: ${title}
       sourceBranch: ${branch}
       draft: true
-  - do: issue.transition
-    with:
-      id: ${issueId}
-      role: in_review
   - do: scm.pr.thread
     with:
       pullRequestId: ${pr.id}
       body: "Opened for issue ${issueId}."
-  - message: "Opened PR ${pr.url}; moved ${issueId} to review."
+  # Give the card full context: reviewers/QA opening the work item see the PR without digging.
+  - do: issue.comment
+    with:
+      id: ${issueId}
+      body: "PR opened: ${pr.url} (from ${branch}). Role unchanged — moves to in_review on merge."
+  - message: "Opened PR ${pr.url} for ${issueId}. Role unchanged; transition on merge (task-move)."

package/recipes/task-new.yaml

@@ -0,0 +1,15 @@
+name: task-new
+description: Create a NEW work item (type + optional parent + optional starting role). Starting work on it afterwards is `task-start`.
+steps:
+  - ask: { as: title, type: text, message: "Work item title?" }
+  - ask: { as: typeRole, type: choice, message: "Type role?", choices: [task, bug, story] }
+  - ask: { as: parentId, type: text, message: "Parent id (empty for none)?", optional: true }
+  - do: issue.create
+    as: issue
+    with:
+      title: ${title}
+      typeRole: ${typeRole}
+      # Exactly-one-reference interpolation: an unanswered optional ask stays truly unset,
+      # so hierarchy/gap negotiation only runs when a parent was actually given.
+      parentId: ${parentId}
+  - message: "Created ${issue.key} (${issue.nativeType}): ${issue.title}"

package/recipes/task-start.yaml

@@ -1,18 +1,19 @@
 name: task-start
-description: Create a task, branch for it, and move it into progress.
+description: Start work on an EXISTING work item — load it, cut its canonical branch, move it to in_progress, and note the branch on the item. (Creating a new item is `task-new`.)
 steps:
-  - ask: { as: title, type: text, message: "Task title?" }
-  - do: issue.create
+  - ask: { as: issueId, type: text, message: "Work item id?" }
+  - do: issue.get
     as: issue
     with:
-      title: ${title}
-      typeRole: task
+      id: ${issueId}
+  # ${issue.branchName} is the core-derived canonical name (<prefix>/<id>-<slug>) — every agent and
+  # recipe derives the SAME name for the same item. It is unset for container types (epic/initiative),
+  # which makes this step fail loudly rather than branch on an epic.
   - do: scm.branch.create
     as: branch
     with:
-      # fromBranch omitted on purpose — defaults to the repo's default branch (main/release/master),
-      # so this recipe is portable across repos instead of assuming 'main'.
-      name: feature/${issue.id}
+      # fromBranch omitted on purpose — defaults to the repo's default branch (main/release/master).
+      name: ${issue.branchName}
   - do: issue.transition
     as: issue
     with:
@@ -21,5 +22,5 @@ steps:
   - do: issue.comment
     with:
       id: ${issue.id}
-      body: "Started on branch ${branch.name}."
-  - message: "Task ${issue.key} is in progress on ${branch.name}."
+      body: "Branch created: ${branch.name}."
+  - message: "${issue.key} is in progress on ${branch.name}."