@elmundi/ship-cli 0.15.3 → 0.15.4

package/lib/commands/run.mjs

@@ -158,7 +158,10 @@ export async function runCommand(ctx, rest) {
   if (!roleResolved) {
     die(EXIT_USAGE, `unknown agent role '${specialistSlug}' for this workspace`);
   }
-  const fsmStage = roleResolved.fsm_stage || null;
+  // Per-routine FSM stage override takes precedence over the role's
+  // default. Lets one role (``ba``) drive both ``ba_requirements`` for
+  // SDLC and ``wbs`` for decomposition without per-process role clones.
+  const fsmStage = resolved.executable?.fsm_stage || roleResolved.fsm_stage || null;
   const roleBody = roleResolved.prompt || "";
   const systemBody = systemResolved?.prompt || "";
 
@@ -484,6 +487,24 @@ function renderPrompt({ patternBody, baseBody, role, routineSpec, task, fsmStage
   out.push("");
   out.push(renderLifecycleHooks());
   if (task) {
+    // ELS-86: parent project context (Brief / WBS / Architecture /
+    // Test architecture / Tasks). The server lifts and caps it; we
+    // render it BEFORE the per-ticket block so the agent sees the
+    // surrounding plan first, then narrows to its own scope. Only
+    // present when the ticket is part of a decomposed project — the
+    // server returns ``project_context: null`` otherwise and we
+    // skip the block silently.
+    if (typeof task.project_context === "string" && task.project_context.trim()) {
+      out.push("");
+      out.push("## Project context");
+      out.push("");
+      out.push(
+        "_Excerpt of the parent project body. Read for surrounding plan;",
+        "your scope is the per-task block below, not the whole project._",
+      );
+      out.push("");
+      out.push(task.project_context.trim());
+    }
     out.push("");
     out.push("## Task");
     out.push(`- **Ticket:** \`${task.ticket_ref}\` (${task.kind})`);
@@ -637,11 +658,19 @@ as a one-shot credential for this run.
 
 function makeBranchName(routine, ticketRef) {
   const stamp = Date.now().toString(36);
+  // Sanitize ``routine`` too — for pipeline-pick runs ``runHandle`` is
+  // ``pipeline:<specialist>`` and the bare ``:`` is in git's reserved
+  // character set, which Cursor's ``/v0/agents`` validator rejects
+  // with HTTP 400 ("Invalid branch name. Branch names cannot start
+  // with '-', contain invalid characters (spaces, ~, ^, :, ?, *, [,
+  // ], \\, .., @{, //), end with '/', '.lock', or '.', or be named
+  // 'HEAD'."). Same regex as the ticketRef path.
+  const safeRoutine = String(routine).replace(/[^a-zA-Z0-9_-]/g, "-");
   if (ticketRef) {
     const safe = String(ticketRef).replace(/[^a-zA-Z0-9_-]/g, "-");
-    return `cursor/ship-${routine}-${safe}-${stamp}`;
+    return `cursor/ship-${safeRoutine}-${safe}-${stamp}`;
   }
-  return `cursor/ship-${routine}-${stamp}`;
+  return `cursor/ship-${safeRoutine}-${stamp}`;
 }
 
 

package/lib/config/schema.mjs

@@ -558,6 +558,10 @@ function validateProcessRoutines(value, errors, warnings) {
         "schedule",
         "window",
         "event",
+        // ``fsm_stage`` overrides the role's default stage so one role
+        // can drive multiple processes (BA serves both
+        // ``ba_requirements`` for SDLC and ``wbs`` for decomposition).
+        "fsm_stage",
       ]),
       prefix,
       warnings,
@@ -616,6 +620,7 @@ function validateProcessRoutines(value, errors, warnings) {
       );
     }
     validateProcessAgentProfile(routine.agent_profile, `${prefix}.agent_profile`, errors);
+    requireOptionalString(routine.fsm_stage, `${prefix}.fsm_stage`, errors, { required: false });
     validateRoutineTrigger(routine.trigger, `${prefix}.trigger`, errors);
     if (routine.schedule !== undefined && routine.schedule !== null) {
       if (typeof routine.schedule !== "string" && !isPlainObject(routine.schedule)) {

package/lib/runtime/routines.mjs

@@ -64,6 +64,11 @@ export function routineToExecutable(id, routine) {
     idempotency: routine.idempotency || null,
     prompt: stringOrNull(routine.prompt) || stringOrNull(routine.instructions),
     agent_profile: stringOrNull(routine.agent_profile) || stringOrNull(routine.specialist?.agent_profile),
+    // Per-routine FSM stage override. When set, ``shipctl run`` uses
+    // it instead of the role's default ``fsm_stage`` — that's how a
+    // single role (e.g. ``ba``) serves both SDLC (``ba_requirements``)
+    // and decomposition (``wbs``) without per-process role clones.
+    fsm_stage: stringOrNull(routine.fsm_stage),
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elmundi/ship-cli",
-  "version": "0.15.3",
+  "version": "0.15.4",
   "type": "module",
   "description": "Ship CLI: bootstrap a repo, sync the catalog, run process routines, report outcomes.",
   "license": "Apache-2.0",