karajan-code 4.2.0 → 4.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",

package/packages/hu-board/src/routes/api.js

@@ -1026,7 +1026,18 @@ router.post('/hus/:huId/run', (req, res) => {
     const extraIds = Array.isArray(req.body?.extraHuIds) ? req.body.extraHuIds.map((x) => (x.includes('::') ? x.split('::').pop() : x)) : [];
     const huIds = [planLocalHuId, ...extraIds];
 
-    const result = runPlan({ planId: row.plan_id, projectId: row.project_id, huIds });
+    // Read the HU title from the plan JSON so kj run receives a
+    // meaningful task description instead of the generic plan.task.
+    let taskOverride;
+    try {
+      const planPath = path.join(getHuBoardPlansDir(), row.project_id, `${row.plan_id}.json`);
+      const planRaw = fs.readFileSync(planPath, 'utf8');
+      const planData = JSON.parse(planRaw);
+      const hu = (planData.hus || []).find((h) => h.id === planLocalHuId);
+      if (hu?.title) taskOverride = hu.title;
+    } catch { /* fall through — runPlan will use plan.task */ }
+
+    const result = runPlan({ planId: row.plan_id, projectId: row.project_id, huIds, taskOverride });
     if (!result.ok) return res.status(400).json({ error: result.error });
 
     // Move the launched HU(s) to "coding" in BOTH the SQLite mirror and the

package/src/environment/playbook.js

@@ -55,7 +55,9 @@ Invariants (the git gates enforce these — they are not suggestions):
 - Security findings are never overridable — not even by arbitration. You
   absorb the security role: \`kj brief security\` states what must be true.
 - Branch first: never commit on the base branch — every change reaches it
-  through an atomic PR (~150 net lines, Conventional Commits).
+  through an atomic PR (~150 net lines, Conventional Commits). Working on
+  more than one task, or the user needs the base tree untouched? One
+  \`git worktree\` per task — the gates travel with the repo and work there.
 
 Commands: \`kj rag query\` · \`kj brief <role>\` (triage, planner, researcher,
 architect, tester, security, audit, board) · \`kj hu add|move|list\` · \`kj adr add|list\` ·