@walwal-harness/cli 7.1.26 → 7.1.28

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

@@ -18,12 +18,14 @@ import type {
   FeatureSummary,
   GoalCard,
   HarnessSnapshot,
+  HarnessEvent,
   HypothesisEntry,
   IncidentEntry,
   MeetingCadence,
   MeetingRecord,
   MeetingsState,
   GotchaEntry,
+  ConventionEntry,
   MissionDoc,
   OperationsDashboard,
   OpsServiceHealth,
@@ -37,6 +39,7 @@ import type {
   TrackStatus,
   WorkerDocEntry,
   WorkerSnapshot,
+  CxxTodo,
 } from "./types";
 
 const SNAPSHOT_VERSION = "1.2.0";
@@ -224,6 +227,9 @@ function emptySnapshot(banner: ErrorBanner | null = null, rootDir?: string): Har
     missions: [],
     ownerHistory: [],
     gotchas: [],
+    conventions: [],
+    todos: [],
+    events: [],
   };
 }
 
@@ -1161,7 +1167,15 @@ function readMissions(rootDir: string, progress: RawProgress | null = null, limi
             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";
+            // Worker docs sometimes omit the "## Status" block but always carry a
+            // docmeta frontmatter when the worker submitted its output. Treat the
+            // presence of a docmeta block (or a non-empty body) as COMPLETE.
+            const hasDocmeta = /^---[\s\S]*?docmeta:[\s\S]*?---/.test(content);
+            const status: WorkerDocEntry["status"] = statusMatch
+              ? (statusMatch[1] as WorkerDocEntry["status"])
+              : hasDocmeta
+              ? "COMPLETE"
+              : "unknown";
             const name = normalizeWorkerName(f);
             const hired = hiredForMission(hiredWorkers, name, owner, rel);
             let updatedAt: string | null = null;
@@ -1289,32 +1303,134 @@ function readOwnerHistory(rootDir: string, limit = 30): OwnerPromptEntry[] {
   return entries.reverse().slice(0, limit);
 }
 
-function readGotchas(rootDir: string): GotchaEntry[] {
-  const gotchasDir = path.join(rootDir, ".harness", "gotchas");
-  if (!existsSync(gotchasDir)) return [];
+function readKnowledgeDir<T extends GotchaEntry | ConventionEntry>(
+  rootDir: string,
+  relDir: string
+): T[] {
+  const dir = path.join(rootDir, ".harness", relDir);
+  if (!existsSync(dir)) return [];
   let entries: Dirent[];
-  try { entries = readdirSync(gotchasDir, { withFileTypes: true }); } catch { return []; }
-  const results: GotchaEntry[] = [];
+  try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return []; }
+  const results: T[] = [];
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
     if (entry.name === "README.md") continue;
     const id = entry.name.replace(/\.md$/, "");
+    const abs = path.join(dir, entry.name);
     let content: string;
-    try { content = readFileSync(path.join(gotchasDir, entry.name), "utf8"); } catch { continue; }
-    // Extract title from first H1 after optional frontmatter
+    try { content = readFileSync(abs, "utf8"); } catch { continue; }
     const body = content.replace(/^---[\s\S]*?---\n+/, "");
     const h1 = body.match(/^#\s+(.+)/m);
     const title = h1 ? h1[1].trim() : id;
-    // Extract tags from docmeta frontmatter
     const tagsMatch = content.match(/^\s*tags:\s*\[([^\]]*)\]/m);
     const tags = tagsMatch
       ? tagsMatch[1].split(",").map((t) => t.trim().replace(/^['"]|['"]$/g, "")).filter(Boolean)
       : [];
-    results.push({ id, title, content, tags });
+    let updatedAt: string | null = null;
+    try { updatedAt = statSync(abs).mtime.toISOString(); } catch { /* ignore */ }
+    results.push({
+      id,
+      title,
+      content,
+      tags,
+      sourcePath: path.relative(rootDir, abs),
+      updatedAt,
+    } as T);
   }
   return results.sort((a, b) => a.id.localeCompare(b.id));
 }
 
+function readGotchas(rootDir: string): GotchaEntry[] {
+  return readKnowledgeDir<GotchaEntry>(rootDir, "gotchas");
+}
+
+function readConventions(rootDir: string): ConventionEntry[] {
+  return readKnowledgeDir<ConventionEntry>(rootDir, "conventions");
+}
+
+function normalizeTodoStatus(raw: unknown): CxxTodo["status"] {
+  const value = String(raw ?? "pending").toLowerCase();
+  if (["pending", "active", "paused", "blocked", "done"].includes(value)) return value;
+  return value;
+}
+
+function readTodos(rootDir: string): CxxTodo[] {
+  const todoPath = path.join(rootDir, ".harness", "todos", "state.json");
+  const result = readJsonSafe<{
+    owners?: Record<string, Array<{
+      id?: string;
+      owner?: string;
+      title?: string;
+      status?: string;
+      priority?: number;
+      kind?: string;
+      mission_path?: string | null;
+      missionPath?: string | null;
+      required_artifacts?: string[];
+      requiredArtifacts?: string[];
+      created_at?: string | null;
+      createdAt?: string | null;
+      updated_at?: string | null;
+      updatedAt?: string | null;
+      last_heartbeat_at?: string | null;
+      lastHeartbeatAt?: string | null;
+      blocked_reason?: string | null;
+      blockedReason?: string | null;
+    }>>;
+  }>(todoPath);
+  if (!result.ok) return [];
+  const todos: CxxTodo[] = [];
+  for (const [owner, list] of Object.entries(result.value.owners ?? {})) {
+    for (const item of list ?? []) {
+      const id = item.id ?? `${owner}-${todos.length + 1}`;
+      todos.push({
+        id,
+        owner: item.owner ?? owner,
+        title: item.title ?? id,
+        status: normalizeTodoStatus(item.status),
+        priority: item.priority ?? 0,
+        kind: item.kind ?? "task",
+        missionPath: item.mission_path ?? item.missionPath ?? null,
+        requiredArtifacts: item.required_artifacts ?? item.requiredArtifacts ?? [],
+        createdAt: item.created_at ?? item.createdAt ?? null,
+        updatedAt: item.updated_at ?? item.updatedAt ?? null,
+        lastHeartbeatAt: item.last_heartbeat_at ?? item.lastHeartbeatAt ?? null,
+        blockedReason: item.blocked_reason ?? item.blockedReason ?? null,
+      });
+    }
+  }
+  return todos.sort((a, b) => (b.priority - a.priority) || ((b.updatedAt ?? "").localeCompare(a.updatedAt ?? "")));
+}
+
+function readJsonlTail<T extends Record<string, unknown>>(filePath: string, limit: number): T[] {
+  if (!existsSync(filePath)) return [];
+  let raw = "";
+  try { raw = readFileSync(filePath, "utf8"); } catch { return []; }
+  const rows: T[] = [];
+  for (const line of raw.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      rows.push(JSON.parse(trimmed) as T);
+    } catch {
+      // Ignore malformed legacy/manual lines in append-only logs.
+    }
+  }
+  return rows.slice(-limit).reverse();
+}
+
+function readEvents(rootDir: string, limit = 40): HarnessEvent[] {
+  return readJsonlTail<Record<string, unknown>>(path.join(rootDir, ".harness", "events.jsonl"), limit).map((e) => ({
+    ts: typeof e.ts === "string" ? e.ts : null,
+    type: typeof e.type === "string" ? e.type : "event",
+    owner: typeof e.owner === "string" ? e.owner : null,
+    command: typeof e.command === "string" ? e.command : null,
+    summary: typeof e.summary === "string" ? e.summary : null,
+    title: typeof e.title === "string" ? e.title : null,
+    status: typeof e.status === "string" ? e.status : null,
+  }));
+}
+
 export function readHarnessState(rootDir: string): HarnessSnapshot {
   const harnessDir = path.join(rootDir, ".harness");
   if (!existsSync(harnessDir)) {
@@ -1344,6 +1460,9 @@ export function readHarnessState(rootDir: string): HarnessSnapshot {
     snapshot.missions = readMissions(rootDir, null);
     snapshot.ownerHistory = readOwnerHistory(rootDir);
     snapshot.gotchas = readGotchas(rootDir);
+    snapshot.conventions = readConventions(rootDir);
+    snapshot.todos = readTodos(rootDir);
+    snapshot.events = readEvents(rootDir);
     return snapshot;
   }
 
@@ -1396,6 +1515,9 @@ export function readHarnessState(rootDir: string): HarnessSnapshot {
     missions: readMissions(rootDir, progress),
     ownerHistory: readOwnerHistory(rootDir),
     gotchas: readGotchas(rootDir),
+    conventions: readConventions(rootDir),
+    todos: readTodos(rootDir),
+    events: readEvents(rootDir),
   };
 }
 

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

@@ -292,6 +292,34 @@ export interface HarnessSnapshot {
   missions: MissionDoc[];
   ownerHistory: OwnerPromptEntry[];
   gotchas: GotchaEntry[];
+  conventions: ConventionEntry[];
+  todos: CxxTodo[];
+  events: HarnessEvent[];
+}
+
+export interface CxxTodo {
+  id: string;
+  owner: "ceo" | "coo" | "cdo" | "cto" | "cqo" | "ops" | string;
+  title: string;
+  status: "pending" | "active" | "paused" | "blocked" | "done" | string;
+  priority: number;
+  kind: string;
+  missionPath?: string | null;
+  requiredArtifacts: string[];
+  createdAt: string | null;
+  updatedAt: string | null;
+  lastHeartbeatAt?: string | null;
+  blockedReason?: string | null;
+}
+
+export interface HarnessEvent {
+  ts: string | null;
+  type: string;
+  owner?: string | null;
+  command?: string | null;
+  summary?: string | null;
+  title?: string | null;
+  status?: string | null;
 }
 
 // Real harness mission documents
@@ -335,6 +363,17 @@ export interface GotchaEntry {
   title: string;
   content: string;
   tags: string[];
+  sourcePath?: string | null;
+  updatedAt?: string | null;
+}
+
+export interface ConventionEntry {
+  id: string;
+  title: string;
+  content: string;
+  tags: string[];
+  sourcePath?: string | null;
+  updatedAt?: string | null;
 }
 
 export type OrgRole = "owner" | "ceo" | "coo" | "cdo" | "cto" | "cqo" | "ops";