scrumrun 4.2.1 → 4.2.2

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes follow Semantic Versioning.
 
 ## Unreleased
 
+## 4.2.2 - 2026-09-22
+
+### Changed
+
+- **`scrumrun view` picks a random free port by default.** Running `scrumrun view` without `--port` now asks the OS for any ephemeral port instead of always trying `8080` first (a common conflict with Vite, Django, and other dev servers). Pass `--port <n>` explicitly if you need a stable URL; sequential retry only fires when the port was explicitly requested. The bound URL is always printed on stdout and the browser is auto-launched at the correct port.
+- **Kanban card width capped.** Columns are constrained to `280–320 px` and align to the left of the grid, so a single populated column no longer stretches its cards to full viewport width. The `Compact` view mode was removed — `Kanban` and `List` cover the two real use-cases.
+- **Guardrail rows truncate the title at 150 characters.** Long rules no longer produce a linha extensa e ilegível; the row shows the id, a truncated title with `…`, and clicking the row opens the detail drawer with the **full rule body rendered as Markdown** (fields, prose, YAML enforcement block).
+
 ## 4.2.1 - 2026-09-22
 
 ### Changed

package/README.md

@@ -4,7 +4,7 @@
 
 ScrumRun gives an agent a small command surface and a precise project memory: what should be done, how each attempt happened, which decisions constrain the code, and why the architecture exists in its current form.
 
-**Package:** `4.2.1` · **Method target:** `2.0.0` · **Runtime:** Node.js `>=22.13.0` · **License:** MIT
+**Package:** `4.2.2` · **Method target:** `2.0.0` · **Runtime:** Node.js `>=22.13.0` · **License:** MIT
 
 **New here?** Read the [Quickstart](docs/QUICKSTART.md) — first Run in under 10 minutes, no `SPEC.md` reading required. Full docs map in [`docs/INDEX.md`](docs/INDEX.md).
 

package/bin/scrumrun.js

@@ -64,7 +64,7 @@ Usage:
   scrumrun update  [all|codex|opencode|claude] [--project] [--seal-policy] [--migrate] [--repair-legacy] [--verbose]
   scrumrun init [--local|--shared] [--lean] [--no-agent-hint] [--force]
   scrumrun status
-  scrumrun view [--port 8080] [--host 127.0.0.1] [--no-open]
+  scrumrun view [--port <n>] [--host 127.0.0.1] [--no-open]        # port defaults to random ephemeral
   scrumrun sync [--repair] [--apply]
   scrumrun lock <acquire|release|status|reap> [ARTIFACT-ID] [--note "..."] [--ttl <minutes>] [--force]
   scrumrun core [--path|--prompt]
@@ -2805,7 +2805,7 @@ if (!command || command === "--help" || command === "-h") {
       const { view } = require(path.join(root, "lib", "view", "server"));
       const portArg = args.indexOf("--port");
       const hostArg = args.indexOf("--host");
-      const port = portArg !== -1 && args[portArg + 1] ? Number(args[portArg + 1]) : 8080;
+      const port = portArg !== -1 && args[portArg + 1] ? Number(args[portArg + 1]) : 0;
       const host = hostArg !== -1 && args[hostArg + 1] ? args[hostArg + 1] : "127.0.0.1";
       const autoOpen = !args.includes("--no-open");
       const { server } = await view(process.cwd(), { port, host, autoOpen });

package/lib/view/server.js

@@ -59,13 +59,15 @@ function requestHandler(root) {
   };
 }
 
-function listen(root, { host = "127.0.0.1", port = 8080 } = {}) {
+function listen(root, { host = "127.0.0.1", port = 0 } = {}) {
   return new Promise((resolve, reject) => {
     const server = http.createServer(requestHandler(root));
     let attempts = 0;
     const tryPort = (p) => {
       server.once("error", (err) => {
-        if (err.code === "EADDRINUSE" && attempts < 20) {
+        // Only retry sequentially when the user asked for a specific port; port 0
+        // means "let the OS pick", so a collision there is genuinely fatal.
+        if (err.code === "EADDRINUSE" && p !== 0 && attempts < 20) {
           attempts += 1;
           setImmediate(() => tryPort(p + 1));
         } else {
@@ -88,7 +90,7 @@ function openInBrowser(url) {
   return spawn("xdg-open", [url], { stdio: "ignore", detached: true }).unref();
 }
 
-async function view(projectRoot, { port = 8080, host = "127.0.0.1", autoOpen = true, logger = console } = {}) {
+async function view(projectRoot, { port = 0, host = "127.0.0.1", autoOpen = true, logger = console } = {}) {
   const root = path.join(projectRoot, ".scrumrun");
   if (!fs.existsSync(root) || !fs.statSync(root).isDirectory()) {
     throw new Error(`ScrumRun project not found at ${root}. Run \`scrumrun init\` first.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrumrun",
-  "version": "4.2.1",
+  "version": "4.2.2",
   "description": "Markdown-first Agile memory and guardrails for AI coding agents.",
   "bin": {
     "scrumrun": "bin/scrumrun.js",

package/templates/shared/view.html

@@ -34,8 +34,7 @@
   .toolbar button { background: transparent; border: 0; color: var(--muted); padding: 5px 10px; font: inherit; font-size: 12px; cursor: pointer; }
   .toolbar button.active { background: var(--border); color: var(--fg); }
   .toolbar button:hover { color: var(--fg); }
-  .kanban { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 14px; align-items: start; }
-  .kanban.compact { grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 10px; }
+  .kanban { display: grid; grid-template-columns: repeat(auto-fill, minmax(280px, 320px)); gap: 14px; align-items: start; justify-content: start; }
   .col { min-width: 0; }
   .col h3 { margin: 0 0 10px; font-size: 11px; text-transform: uppercase; color: var(--muted); letter-spacing: .06em; display: flex; align-items: center; gap: 6px; }
   .col h3 .count { background: var(--border); color: var(--fg); padding: 1px 6px; border-radius: 10px; font-family: var(--mono); font-size: 10px; }
@@ -47,9 +46,6 @@
   .card .id { font-family: var(--mono); font-size: 10px; color: var(--muted); letter-spacing: .04em; }
   .card .title { font-size: 13.5px; font-weight: 500; margin-top: 3px; line-height: 1.35; color: var(--fg); }
   .card .meta { font-size: 11px; color: var(--muted); margin-top: 8px; display: flex; gap: 5px; flex-wrap: wrap; }
-  .kanban.compact .card { padding: 7px 9px; }
-  .kanban.compact .card .title { font-size: 12.5px; }
-  .kanban.compact .card .meta { display: none; }
   body.list-mode .kanban { display: block; }
   body.list-mode .col { margin-bottom: 20px; }
   body.list-mode .col-body { max-height: none; }
@@ -120,7 +116,6 @@
     <div class="toolbar">
       <div class="group" role="tablist" aria-label="View mode">
         <button data-mode="kanban" class="active">Kanban</button>
-        <button data-mode="compact">Compact</button>
         <button data-mode="list">List</button>
       </div>
     </div>
@@ -275,16 +270,40 @@
     }
   }
 
+  function truncate(text, max = 150) {
+    const t = String(text || "").replace(/\s+/g, " ").trim();
+    return t.length > max ? t.slice(0, max - 1).trimEnd() + "…" : t;
+  }
+
   function renderGuardrailsFromText(text) {
     const el = document.getElementById("guardrails");
     if (!text) { el.innerHTML = '<div class="empty">guardrails.md not found</div>'; return; }
     const rules = [];
-    for (const match of text.matchAll(/^##\s+(GR-\d+)\s+-\s+(.+)$/gm)) {
-      rules.push({ id: match[1], title: match[2] });
+    // Parse each ## GR-XXX block: capture id, title, and body until next ## or EOF
+    const blockRe = /^##\s+(GR-\d+)\s+-\s+(.+?)\r?\n([\s\S]*?)(?=^##\s+GR-|\Z)/gm;
+    let match;
+    while ((match = blockRe.exec(text)) !== null) {
+      rules.push({ id: match[1], title: match[2].trim(), body: match[3].trim() });
+    }
+    el.innerHTML = "";
+    if (!rules.length) { el.innerHTML = '<div class="empty">no guardrails declared</div>'; return; }
+    for (const rule of rules) {
+      const row = document.createElement("div");
+      row.className = "list-item";
+      row.innerHTML = `<span class="row-id">${rule.id}</span><span class="row-text">${escape(truncate(rule.title, 150))}</span>`;
+      row.addEventListener("click", () => openGuardrailDetail(rule));
+      el.appendChild(row);
     }
-    el.innerHTML = rules.length
-      ? rules.map((r) => `<div class="list-item"><span class="row-id">${r.id}</span><span class="row-text">${escape(r.title)}</span></div>`).join("")
-      : '<div class="empty">no guardrails declared</div>';
+  }
+
+  function openGuardrailDetail(rule) {
+    const body = document.getElementById("detail-body");
+    body.innerHTML = `
+      <h2 style="margin-top:0;font-size:15px">${escape(rule.id)}</h2>
+      <div class="sub" style="margin-bottom:12px">${escape(rule.title)}</div>
+      <div class="md">${renderMarkdown(rule.body)}</div>`;
+    document.getElementById("detail").classList.add("open");
+    document.getElementById("detail").setAttribute("aria-hidden", "false");
   }
 
   function escape(s) { return String(s).replace(/[&<>]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;" }[c])); }
@@ -425,9 +444,9 @@
   document.getElementById("search").addEventListener("input", applyFilters);
 
   const kanbanEl = document.getElementById("kanban");
-  const savedMode = localStorage.getItem("scrumrun.view.mode") || "kanban";
+  const savedMode = localStorage.getItem("scrumrun.view.mode") === "list" ? "list" : "kanban";
   function setMode(mode) {
-    kanbanEl.classList.toggle("compact", mode === "compact");
+    if (mode !== "list") mode = "kanban";
     document.body.classList.toggle("list-mode", mode === "list");
     for (const button of document.querySelectorAll(".toolbar button")) {
       button.classList.toggle("active", button.dataset.mode === mode);