@walwal-harness/cli 7.1.20 → 7.1.21

package/CHANGELOG.md

@@ -34,6 +34,8 @@ docmeta:
 ### Changed
 - Dashboard Org Tree now positions only hired HR-Resource workers from `hr-roster.json`, requiring a backing `.harness/shared/HR-Resource/{worker}/SKILL.md`.
 - Running hired workers are highlighted under their owning CXX instead of showing queue jobs as worker seats.
+- Dashboard SSE now watches mission documents, hired-worker roster, and HR-Resource changes so worker updates appear without browser refresh.
+- Dashboard worker cards now prefer mission/report task labels and mark recently updated unfinished worker reports as active when runtime active-worker state is absent.
 
 ### Added
 - Hourly wake can now run either `claude -p` or `codex exec` via `HARNESS_WAKE_EXECUTOR=claude|codex`.

package/apps/harness-dashboard/components/OrgTree.tsx

@@ -273,11 +273,15 @@ export function OrgTree({ snapshot, activeNodeId, onNodeClick }: OrgTreeProps) {
       <div className="flex gap-3 justify-center">
         {cxxNodes.map((node) => {
           const nodeWorkers = workers.filter((w) => w.owner === node.role);
+          const hasActiveWorker = nodeWorkers.some((w) => w.active);
+          const displayNode = hasActiveWorker
+            ? { ...node, status: "typing" as const, activity: "Worker active" }
+            : node;
 
           return (
             <div key={node.id} className="flex flex-col items-center gap-2">
               <OrgCard
-                node={node}
+                node={displayNode}
                 size="md"
                 active={activeNodeId === node.id}
                 onClick={onNodeClick}
@@ -298,8 +302,8 @@ export function OrgTree({ snapshot, activeNodeId, onNodeClick }: OrgTreeProps) {
                           onNodeClick({
                             id: workerNodeId,
                             role: node.role,
-                            label: w.name,
-                            sublabel: w.active ? "running" : w.status,
+                            label: w.displayName,
+                            sublabel: w.active ? `running · ${w.name}` : `${w.status} · ${w.name}`,
                             status: w.active ? "typing" : w.status === "COMPLETE" ? "idle" : "queued",
                             activity: w.sourcePath ?? null,
                             agentIds: [],
@@ -318,7 +322,7 @@ export function OrgTree({ snapshot, activeNodeId, onNodeClick }: OrgTreeProps) {
                           hired worker
                         </div>
                         <div className="text-[11px] font-medium text-gray-200 truncate pr-3">
-                          {w.name}
+                          {w.displayName}
                         </div>
                         <div
                           className={`text-[9px] font-mono mt-0.5 ${

package/apps/harness-dashboard/components/Scene.tsx

@@ -77,7 +77,7 @@ export function Scene({ snapshot: initial, lang = "ko" }: SceneProps) {
     selectedAgent?.id ?? "",
   ].join(":");
   const selectedWorkerName = selectedNode?.id.startsWith("worker-")
-    ? selectedNode.label
+    ? selectedNode.id.replace(/^worker-[^-]+-/, "")
     : undefined;
   const selectedDocumentRole = selectedWorkerName
     ? "worker"

package/apps/harness-dashboard/lib/__tests__/watcher.test.ts

@@ -11,7 +11,10 @@ describe("watchHarness", () => {
     dir = mkdtempSync(path.join(tmpdir(), "watch-"));
     mkdirSync(path.join(dir, ".harness", "actions"), { recursive: true });
     mkdirSync(path.join(dir, ".harness", "archive"), { recursive: true });
+    mkdirSync(path.join(dir, ".harness", "documents"), { recursive: true });
+    mkdirSync(path.join(dir, ".harness", "shared", "HR-Resource"), { recursive: true });
     writeFileSync(path.join(dir, ".harness", "progress.json"), "{}");
+    writeFileSync(path.join(dir, ".harness", "shared", "hr-roster.json"), "{\"hired\":[]}");
   });
 
   afterEach(() => {
@@ -45,4 +48,43 @@ describe("watchHarness", () => {
     await handle.close();
     // No assertion — test passes if close() resolves without throwing.
   });
+
+  it("fires onChange when hired workers or mission documents change", async () => {
+    const events: string[] = [];
+    const handle = watchHarness(dir, (p) => events.push(p), { debounceMs: 30 });
+
+    await new Promise((r) => setTimeout(r, 250));
+
+    writeFileSync(
+      path.join(dir, ".harness", "shared", "hr-roster.json"),
+      JSON.stringify({ hired: [{ worker: "react-ui-worker", owner: "cto" }] })
+    );
+    await new Promise((r) => setTimeout(r, 300));
+
+    mkdirSync(
+      path.join(dir, ".harness", "shared", "HR-Resource", "react-ui-worker"),
+      { recursive: true }
+    );
+    writeFileSync(
+      path.join(dir, ".harness", "shared", "HR-Resource", "react-ui-worker", "SKILL.md"),
+      "# React UI Worker\n"
+    );
+    await new Promise((r) => setTimeout(r, 300));
+
+    mkdirSync(
+      path.join(dir, ".harness", "documents", "goal-1", "cto", "workers"),
+      { recursive: true }
+    );
+    writeFileSync(
+      path.join(dir, ".harness", "documents", "goal-1", "cto", "workers", "react-ui-worker.md"),
+      "## Status\nIN_PROGRESS\n"
+    );
+
+    await new Promise((r) => setTimeout(r, 500));
+
+    await handle.close();
+    expect(events.some((e) => e.endsWith("hr-roster.json"))).toBe(true);
+    expect(events.some((e) => e.endsWith("SKILL.md"))).toBe(true);
+    expect(events.some((e) => e.endsWith("react-ui-worker.md"))).toBe(true);
+  });
 });

package/apps/harness-dashboard/lib/harness-state.ts

@@ -41,6 +41,7 @@ import type {
 
 const SNAPSHOT_VERSION = "1.2.0";
 const GOAL_DESC_TRUNCATE = 200;
+const RECENT_WORKER_ACTIVE_MS = 10 * 60 * 1000;
 
 interface RawProgress {
   goals?: {
@@ -781,6 +782,9 @@ interface HiredWorkerEntry {
   name: string;
   owner: Exclude<WorkerOwner, "unknown">;
   sourcePath: string | null;
+  mission: string | null;
+  task: string | null;
+  capability: string | null;
 }
 
 function deriveWorkerProgress(worker: RawWorker): number | null {
@@ -868,6 +872,9 @@ function readHiredWorkers(rootDir: string): HiredWorkerEntry[] {
       name?: string;
       owner?: string;
       owningCxx?: string;
+      mission?: string;
+      task?: string;
+      capability?: string;
       skillPath?: string;
       skillPaths?: { source?: string };
     }>;
@@ -888,11 +895,45 @@ function readHiredWorkers(rootDir: string): HiredWorkerEntry[] {
     const key = `${owner}:${name}`;
     if (seen.has(key)) continue;
     seen.add(key);
-    hired.push({ name, owner, sourcePath });
+    hired.push({
+      name,
+      owner,
+      sourcePath,
+      mission: entry.mission ?? null,
+      task: entry.task ?? null,
+      capability: entry.capability ?? null,
+    });
   }
   return hired;
 }
 
+function hiredForMission(
+  hiredWorkers: HiredWorkerEntry[],
+  name: string,
+  owner: WorkerOwner,
+  missionId: string,
+): HiredWorkerEntry | undefined {
+  const candidates = hiredWorkers.filter(
+    (w) => w.name === name && (w.owner === owner || owner === "unknown")
+  );
+  return candidates.find((w) => w.mission === missionId) ?? candidates[0];
+}
+
+function workerDisplayName(content: string, hired: HiredWorkerEntry | undefined, fallback: string): string {
+  const title = content.match(/^\s*title:\s*["']?(.+?)["']?\s*$/m)?.[1]?.trim();
+  if (title) return truncateText(title.replace(/\s+—\s+Worker Report$/i, ""), 42);
+
+  const heading = content.match(/^#\s+(.+)$/m)?.[1]?.trim();
+  if (heading) return truncateText(heading.replace(/\s+—\s+.*$/i, ""), 42);
+
+  if (hired?.task) {
+    const capability = hired.capability ? ` · ${hired.capability}` : "";
+    return truncateText(`${hired.task}${capability}`, 42);
+  }
+
+  return fallback;
+}
+
 function activeWorkerNames(progress: RawProgress | null): Set<string> {
   const active = new Set<string>();
   const workers = [
@@ -1117,19 +1158,30 @@ function readMissions(rootDir: string, progress: RawProgress | null = null, limi
         try {
           for (const f of readdirSync(workersDir)) {
             if (!f.endsWith(".md")) continue;
+            const reportAbs = path.join(missionPath, relDir, f);
             const content = readMd(`${relDir}/${f}`) ?? "";
             const statusMatch = content.match(/##\s*Status\s*\n+([A-Z_]+)/);
+            const status = (statusMatch?.[1] as WorkerDocEntry["status"]) ?? "unknown";
             const name = normalizeWorkerName(f);
-            const hired = hiredWorkers.find((w) => w.name === name && (w.owner === owner || owner === "unknown"));
+            const hired = hiredForMission(hiredWorkers, name, owner, rel);
+            let updatedAt: string | null = null;
+            let recentlyTouched = false;
+            try {
+              const mtime = statSync(reportAbs).mtime;
+              updatedAt = mtime.toISOString();
+              recentlyTouched = Date.now() - mtime.getTime() < RECENT_WORKER_ACTIVE_MS;
+            } catch { /* ignore */ }
             const entry: WorkerDocEntry = {
               name,
+              displayName: workerDisplayName(content, hired, name),
               content,
-              status: (statusMatch?.[1] as WorkerDocEntry["status"]) ?? "unknown",
+              status,
               owner: hired?.owner ?? owner,
               hired: !!hired,
-              active: activeWorkers.has(name),
+              active: activeWorkers.has(name) || (recentlyTouched && status !== "COMPLETE"),
               sourcePath: hired?.sourcePath ?? null,
-              reportPath: path.relative(rootDir, path.join(missionPath, relDir, f)),
+              reportPath: path.relative(rootDir, reportAbs),
+              updatedAt,
             };
             workersByKey.set(`${entry.owner}:${entry.name}`, entry);
           }
@@ -1148,6 +1200,7 @@ function readMissions(rootDir: string, progress: RawProgress | null = null, limi
         if (workersByKey.has(key)) continue;
         workersByKey.set(key, {
           name: hired.name,
+          displayName: workerDisplayName("", hired, hired.name),
           content: "",
           status: activeWorkers.has(hired.name) ? "IN_PROGRESS" : "unknown",
           owner: hired.owner,
@@ -1155,6 +1208,7 @@ function readMissions(rootDir: string, progress: RawProgress | null = null, limi
           active: activeWorkers.has(hired.name),
           sourcePath: hired.sourcePath,
           reportPath: null,
+          updatedAt: null,
         });
       }
 

package/apps/harness-dashboard/lib/types.ts

@@ -297,6 +297,7 @@ export interface HarnessSnapshot {
 // Real harness mission documents
 export interface WorkerDocEntry {
   name: string;
+  displayName: string;
   content: string;
   status: "COMPLETE" | "IN_PROGRESS" | "unknown";
   owner: "cto" | "cqo" | "coo" | "cdo" | "ops" | "unknown";
@@ -304,6 +305,7 @@ export interface WorkerDocEntry {
   active: boolean;
   sourcePath?: string | null;
   reportPath?: string | null;
+  updatedAt?: string | null;
 }
 
 export interface MissionDoc {

package/apps/harness-dashboard/lib/watcher.ts

@@ -10,9 +10,8 @@ export interface WatchOptions {
   debounceMs?: number;
 }
 
-// Watches the .harness/ directory for changes that affect the dashboard
-// snapshot — progress.json (state), progress.log (activity), actions/* (sprint
-// artifacts), archive/* (sprint history).
+// Watches .harness paths that affect the dashboard snapshot: runtime progress,
+// actions, mission documents, hired-worker roster/resources, and archive state.
 export function watchHarness(
   rootDir: string,
   onChange: (changedPath: string) => void,
@@ -25,6 +24,9 @@ export function watchHarness(
       path.join(harnessDir, "progress.json"),
       path.join(harnessDir, "progress.log"),
       path.join(harnessDir, "actions"),
+      path.join(harnessDir, "documents"),
+      path.join(harnessDir, "shared", "hr-roster.json"),
+      path.join(harnessDir, "shared", "HR-Resource"),
       path.join(harnessDir, "archive"),
     ],
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "7.1.20",
+  "version": "7.1.21",
   "description": "Company-style AI agent harness for Claude and Codex. Installs commands, CXX agents, skills, HR-Resource hiring pool, and project-local .harness runtime state.",
   "bin": {
     "walwal-harness": "bin/init.js"