karajan-code 2.1.0 → 2.2.0

package/package.json

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

package/src/commands/board.js

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
+import net from "node:net";
 import { spawn } from "node:child_process";
 import { getKarajanHome } from "../utils/paths.js";
 
@@ -24,10 +25,44 @@ function isProcessAlive(pid) {
   }
 }
 
-export async function startBoard(port = 4000) {
+/**
+ * Check if a TCP port is available on localhost.
+ * Returns true when we can successfully bind (port is free).
+ */
+function isPortAvailable(port) {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.once("error", () => resolve(false));
+    server.once("listening", () => {
+      server.close(() => resolve(true));
+    });
+    server.listen(port, "127.0.0.1");
+  });
+}
+
+/**
+ * Starting from `desiredPort`, return the first free port within `maxTries`.
+ * Returns null if none available.
+ */
+async function findAvailablePort(desiredPort, maxTries = 10) {
+  for (let i = 0; i < maxTries; i++) {
+    const port = desiredPort + i;
+    if (await isPortAvailable(port)) return port;
+  }
+  return null;
+}
+
+export async function startBoard(desiredPort = 4000) {
   const existingPid = readPid();
   if (existingPid && isProcessAlive(existingPid)) {
-    return { ok: true, alreadyRunning: true, pid: existingPid, url: `http://localhost:${port}` };
+    // Trust the saved PID — port info comes from the PID file if present
+    return { ok: true, alreadyRunning: true, pid: existingPid, url: `http://localhost:${desiredPort}` };
+  }
+
+  // Find a free port starting from desiredPort
+  const port = await findAvailablePort(desiredPort, 10);
+  if (port === null) {
+    throw new Error(`No free port in range ${desiredPort}-${desiredPort + 9}`);
   }
 
   const serverPath = path.join(BOARD_DIR, "src/server.js");
@@ -50,7 +85,7 @@ export async function startBoard(port = 4000) {
     throw new Error("Failed to spawn HU Board server");
   }
   fs.writeFileSync(PID_FILE, String(child.pid));
-  return { ok: true, alreadyRunning: false, pid: child.pid, url: `http://localhost:${port}` };
+  return { ok: true, alreadyRunning: false, pid: child.pid, url: `http://localhost:${port}`, port };
 }
 
 export async function stopBoard() {

package/src/hu/auto-generator.js

@@ -7,6 +7,34 @@
  *         and a dependency graph (setup blocks everything; remaining linear by default).
  */
 
+/**
+ * Derive a human-readable project name from a task prompt.
+ * Strips common action verbs + stopwords, takes up to 6 meaningful words,
+ * and title-cases the result. Max 60 chars.
+ */
+export function deriveProjectName(originalTask) {
+  if (!originalTask || typeof originalTask !== "string") return "Untitled Project";
+  const STOPWORDS = new Set([
+    "a", "an", "the", "and", "or", "with", "for", "to", "of", "in", "on",
+    "build", "create", "implement", "make", "develop", "add", "set", "up",
+    "setup", "write", "code", "new", "complete", "that", "from", "scratch",
+    "application", "app", "tool", "system", "project", "using", "use"
+  ]);
+  const words = originalTask
+    .toLowerCase()
+    .replace(/[^\p{L}\p{N}\s-]/gu, " ")
+    .split(/\s+/)
+    .filter(w => w && !STOPWORDS.has(w));
+  const meaningful = words.slice(0, 6);
+  if (meaningful.length === 0) {
+    return originalTask.slice(0, 60).trim() || "Untitled Project";
+  }
+  const titled = meaningful
+    .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+    .join(" ");
+  return titled.length > 60 ? titled.slice(0, 57) + "..." : titled;
+}
+
 /**
  * Classify a subtask into a Karajan task_type.
  * Maps free-text subtask descriptions to {infra|sw|add-tests|doc|refactor|nocode}.
@@ -157,6 +185,7 @@ export function generateHuBatch({
     stories,
     total: stories.length,
     certified: stories.length,
+    projectName: deriveProjectName(originalTask),
     generated: true,
     source: { triage_subtasks: subtasks.length, researcher: Boolean(researcherContext), architect: Boolean(architectContext) }
   };

package/src/orchestrator.js

@@ -771,10 +771,12 @@ async function maybeGenerateAutoHuBatch({ flags, stageResults, task, plannedTask
     const fs = await import("node:fs/promises");
     const path = await import("node:path");
     const { getKarajanHome } = await import("./utils/paths.js");
-    const huDir = path.join(getKarajanHome(), "hu", batchSessionId);
+    const huDir = path.join(getKarajanHome(), "hu-stories", batchSessionId);
     await fs.mkdir(huDir, { recursive: true });
     const persistBatch = {
       session_id: batchSessionId,
+      project_id: batchSessionId,
+      project_name: batch.projectName,
       created_at: new Date().toISOString(),
       updated_at: new Date().toISOString(),
       stories: batch.stories
@@ -798,8 +800,32 @@ async function maybeGenerateAutoHuBatch({ flags, stageResults, task, plannedTask
   logger.info(`Auto-HU: generated ${batch.total} stories (${batch.source.triage_subtasks} subtasks${isNewProject ? ", new project" : ""}${stackHints.length ? `, stack: ${stackHints.join(",")}` : ""})`);
   emitProgress(emitter, makeEvent("hu:auto-generated", { ...eventBase, stage: "hu-auto-gen" }, {
     message: `Auto-generated ${batch.total} HU(s) from triage decomposition`,
-    detail: { total: batch.total, subtasks: batch.source.triage_subtasks, isNewProject, stackHints }
+    detail: { total: batch.total, subtasks: batch.source.triage_subtasks, isNewProject, stackHints, projectName: batch.projectName }
   }));
+
+  // Auto-start the board so the user can see the generated HUs.
+  // Always fires when auto-HU runs, independent of hu_board.auto_start flag.
+  try {
+    const { startBoard } = await import("./commands/board.js");
+    const desiredPort = session.config_snapshot?.hu_board?.port ?? 4000;
+    const boardResult = await startBoard(desiredPort);
+    const url = boardResult.url;
+    const status = boardResult.alreadyRunning ? "already running" : "started";
+    // Highlighted URL box — visible regardless of log level
+    const title = batch.projectName || "Auto-generated HUs";
+    const box = [
+      "",
+      "\u001b[36m\u256d\u2500 HU Board \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e",
+      `\u001b[36m\u2502\u001b[0m  \u001b[1m${status}\u001b[0m  \u001b[4m${url}\u001b[0m`,
+      `\u001b[36m\u2502\u001b[0m  Project: \u001b[1m${title}\u001b[0m`,
+      "\u001b[36m\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\u001b[0m",
+      ""
+    ].join("\n");
+    console.log(box);
+    logger.info(`HU Board ${status} at ${url} (project: ${title})`);
+  } catch (err) {
+    logger.warn(`HU Board auto-start failed (non-blocking): ${err.message}`);
+  }
 }
 
 async function runCoderAndRefactorerStages({ coderRoleInstance, coderRole, refactorerRole, pipelineFlags, config, logger, emitter, eventBase, session, plannedTask, trackBudget, i, brainCtx }) {