@walwal-harness/cli 7.1.25 → 7.1.27

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

@@ -96,7 +96,11 @@ export function Scene({ snapshot: initial, lang = "ko" }: SceneProps) {
       {snapshot.escalations.length > 0 && (
         <EscalationStrip escalations={snapshot.escalations} />
       )}
-      <div className="grid min-h-0 flex-1 min-w-0 gap-4 lg:grid-cols-2">
+      <div className="mb-4 grid gap-3 xl:grid-cols-[1.25fr_1fr]">
+        <CommandDeck snapshot={snapshot} connectionState={connectionState} />
+        <ProcessPulse snapshot={snapshot} />
+      </div>
+      <div className="grid min-h-0 flex-1 min-w-0 gap-4 lg:grid-cols-[1.12fr_0.88fr]">
         <div className="scrollbar-hidden min-h-0 min-w-0 overflow-y-auto pr-1">
           <section className="min-w-0">
             <div className="mb-3 flex flex-wrap items-end justify-between gap-3">
@@ -112,9 +116,9 @@ export function Scene({ snapshot: initial, lang = "ko" }: SceneProps) {
             </div>
             <div
               data-testid="brick-office-stage"
-              className="w-full overflow-x-auto rounded-md border border-gray-700/80 bg-[#12151b] shadow-2xl"
+              className="glass-panel w-full overflow-x-auto rounded-lg"
             >
-              <div className="pointer-events-none flex items-center justify-between gap-3 border-b border-white/10 bg-black/30 px-4 py-2 font-mono text-[10px] text-gray-300 backdrop-blur">
+              <div className="pointer-events-none flex items-center justify-between gap-3 border-b border-white/10 bg-white/5 px-4 py-2 font-mono text-[10px] text-gray-300 backdrop-blur">
                 <span>Owner → CEO → CXX → Workers</span>
                 <span className="truncate">
                   {snapshot.missions?.[0]?.missionId ?? "no active mission"}
@@ -239,6 +243,133 @@ export function Scene({ snapshot: initial, lang = "ko" }: SceneProps) {
   );
 }
 
+function CommandDeck({
+  snapshot,
+  connectionState,
+}: {
+  snapshot: HarnessSnapshot;
+  connectionState: ConnectionState;
+}) {
+  const activeMission = snapshot.missions?.[0];
+  const cxxCount = activeMission?.cxxPresent.length ?? 0;
+  const activeWorkers = activeMission?.workers.filter((w) => w.active).length ?? 0;
+  const activeTodos = snapshot.todos.filter((t) => t.status === "active").length;
+  const blockedSignals =
+    snapshot.escalations.length +
+    snapshot.incidents.length +
+    snapshot.dashboard.features.filter((f) => f.status === "blocked" || f.status === "failed").length;
+  const stateLabel = blockedSignals > 0 ? "Needs Attention" : activeWorkers > 0 ? "In Motion" : "Observing";
+
+  return (
+    <section className="glass-panel relative overflow-hidden rounded-lg px-5 py-4">
+      <div className="aurora-line absolute inset-x-0 top-0 h-1" />
+      <div className="relative flex flex-wrap items-start justify-between gap-4">
+        <div className="min-w-0">
+          <p className="font-mono text-[10px] uppercase tracking-[0.28em] text-cyan-200/80">
+            Company Harness Observatory
+          </p>
+          <h1 className="mt-1 text-2xl font-semibold tracking-tight text-white sm:text-3xl">
+            {snapshot.projectName || "walwal-harness"}
+          </h1>
+          <p className="mt-2 max-w-2xl text-sm leading-6 text-slate-300">
+            {activeMission?.missionId ?? snapshot.goal?.title ?? "No active mission detected"}
+          </p>
+        </div>
+        <div className="brutal-tile min-w-[170px] rounded-md px-3 py-2">
+          <div className="font-mono text-[9px] uppercase tracking-[0.2em] text-slate-500">state</div>
+          <div className="mt-1 text-lg font-semibold text-white">{stateLabel}</div>
+          <div className="mt-1 font-mono text-[10px] text-slate-400">
+            {connectionState} · {snapshot.runtime.currentAgent ?? snapshot.runtime.nextAgent ?? "idle"}
+          </div>
+        </div>
+      </div>
+      <div className="relative mt-4 grid gap-2 sm:grid-cols-4">
+        <MetricTile label="CXX Present" value={String(cxxCount)} tone="cyan" />
+        <MetricTile label="Active Todos" value={String(activeTodos)} tone="green" />
+        <MetricTile label="Open Incidents" value={String(snapshot.incidents.length)} tone="rose" />
+        <MetricTile label="Missions" value={String(snapshot.missions.length)} tone="violet" />
+      </div>
+    </section>
+  );
+}
+
+function MetricTile({ label, value, tone }: { label: string; value: string; tone: "cyan" | "green" | "rose" | "violet" }) {
+  const toneClass = {
+    cyan: "text-cyan-200 border-cyan-300/35",
+    green: "text-emerald-200 border-emerald-300/35",
+    rose: "text-rose-200 border-rose-300/35",
+    violet: "text-violet-200 border-violet-300/35",
+  }[tone];
+  return (
+    <div className={`brutal-tile rounded-md px-3 py-2 ${toneClass}`}>
+      <div className="font-mono text-[9px] uppercase tracking-[0.18em] text-slate-500">{label}</div>
+      <div className="mt-1 text-2xl font-semibold">{value}</div>
+    </div>
+  );
+}
+
+function ProcessPulse({ snapshot }: { snapshot: HarnessSnapshot }) {
+  const roles = ["ceo", "coo", "cdo", "cto", "cqo", "ops"] as const;
+  const activeMission = snapshot.missions?.[0];
+  const activeRoles = new Set(activeMission?.cxxPresent ?? []);
+  const roleStatus = roles.map((role) => {
+    const todos = snapshot.todos.filter((t) => t.owner === role);
+    const activeTodos = todos.filter((t) => t.status === "active").length;
+    const blockedTodos = todos.filter((t) => t.status === "blocked").length;
+    const workerCount = activeMission?.workers.filter((w) => w.owner === role).length ?? 0;
+    const activeCount = activeMission?.workers.filter((w) => w.owner === role && w.active).length ?? 0;
+    return { role, workerCount, activeCount, activeTodos, blockedTodos, present: activeRoles.has(role) || todos.length > 0 };
+  });
+  return (
+    <section className="glass-panel rounded-lg px-4 py-4">
+      <div className="flex items-center justify-between gap-3">
+        <div>
+          <p className="font-mono text-[10px] uppercase tracking-[0.24em] text-fuchsia-200/75">
+            Process Monitor
+          </p>
+          <h2 className="mt-1 text-base font-semibold text-white">CXX queue readiness</h2>
+        </div>
+        <div className="rounded-full border border-white/15 bg-white/8 px-3 py-1 font-mono text-[10px] text-slate-300">
+          {snapshot.runtime.agentStatus}
+        </div>
+      </div>
+      <div className="mt-3 grid grid-cols-2 gap-2 sm:grid-cols-3">
+        {roleStatus.map((item) => (
+          <div key={item.role} className="brutal-tile rounded-md px-3 py-2">
+            <div className="flex items-center justify-between gap-2">
+              <span className="font-mono text-[10px] uppercase tracking-[0.18em] text-slate-400">{item.role}</span>
+              <span
+                className={`h-2 w-2 rounded-full ${
+                  item.blockedTodos > 0
+                    ? "bg-rose-400"
+                    : item.activeTodos > 0 || item.activeCount > 0
+                    ? "bg-cyan-300 animate-pulse"
+                    : item.present
+                    ? "bg-emerald-300"
+                    : "bg-slate-600"
+                }`}
+              />
+            </div>
+            <div className="mt-2 text-xs text-slate-300">
+              {item.blockedTodos > 0
+                ? `${item.blockedTodos} blocked`
+                : item.activeTodos > 0
+                ? `${item.activeTodos} todo`
+                : item.activeCount > 0
+                ? `${item.activeCount} active`
+                : item.workerCount > 0
+                ? `${item.workerCount} workers`
+                : item.present
+                ? "documented"
+                : "waiting"}
+            </div>
+          </div>
+        ))}
+      </div>
+    </section>
+  );
+}
+
 function ActivityIndicator({
   snapshot,
   connectionState,

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

@@ -18,6 +18,7 @@ import type {
   FeatureSummary,
   GoalCard,
   HarnessSnapshot,
+  HarnessEvent,
   HypothesisEntry,
   IncidentEntry,
   MeetingCadence,
@@ -37,6 +38,7 @@ import type {
   TrackStatus,
   WorkerDocEntry,
   WorkerSnapshot,
+  CxxTodo,
 } from "./types";
 
 const SNAPSHOT_VERSION = "1.2.0";
@@ -224,6 +226,8 @@ function emptySnapshot(banner: ErrorBanner | null = null, rootDir?: string): Har
     missions: [],
     ownerHistory: [],
     gotchas: [],
+    todos: [],
+    events: [],
   };
 }
 
@@ -1315,6 +1319,89 @@ function readGotchas(rootDir: string): GotchaEntry[] {
   return results.sort((a, b) => a.id.localeCompare(b.id));
 }
 
+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 +1431,8 @@ export function readHarnessState(rootDir: string): HarnessSnapshot {
     snapshot.missions = readMissions(rootDir, null);
     snapshot.ownerHistory = readOwnerHistory(rootDir);
     snapshot.gotchas = readGotchas(rootDir);
+    snapshot.todos = readTodos(rootDir);
+    snapshot.events = readEvents(rootDir);
     return snapshot;
   }
 
@@ -1396,6 +1485,8 @@ export function readHarnessState(rootDir: string): HarnessSnapshot {
     missions: readMissions(rootDir, progress),
     ownerHistory: readOwnerHistory(rootDir),
     gotchas: readGotchas(rootDir),
+    todos: readTodos(rootDir),
+    events: readEvents(rootDir),
   };
 }
 

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

@@ -292,6 +292,33 @@ export interface HarnessSnapshot {
   missions: MissionDoc[];
   ownerHistory: OwnerPromptEntry[];
   gotchas: GotchaEntry[];
+  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

package/assets/templates/AGENTS.md.template

@@ -121,6 +121,9 @@ Note: A docmeta skip decision on harness documents (ceo.md, cto.md, cqo.md, work
 | `.harness/documents/goal-{index}-{name}/` | Goal-level CXX decisions and worker reports |
 | `.harness/documents/goal-{index}-{name}/submission-{index}-{name}/` | Additional requirement under the active goal |
 | `.harness/documents/goal-{index}-{name}/hotfix-{index}-{name}/` | Emergency fix under the active goal |
+| `.harness/events.jsonl` | Structured append-only runtime event stream |
+| `.harness/todos/state.json` | Machine-readable CXX todo queues |
+| `.harness/todos/events.jsonl` | Structured todo transition history |
 | `.harness/conventions/` | Durable rules (CQO writes, survives missions) |
 | `.harness/gotchas/` | Recurrence-prevention records (CQO writes per hot-fix) |
 | `.harness/memories/` | Long-term shared context |
@@ -144,10 +147,12 @@ Note: A docmeta skip decision on harness documents (ceo.md, cto.md, cqo.md, work
 8. **No CXX self-execution** — CXX agents coordinate and manage only. A CXX that produces deliverables without matching worker records has violated its scope. CEO must reject such reports.
 9. **No verdict without worker evidence** — CQO cannot issue ACCEPTED/REJECTED without a Worker Evidence Manifest referencing at least one evaluator worker. Self-inspection by CQO is not valid evidence.
 10. **Hierarchical worker ownership** — Hired workers are installed under `.claude/skills/{owning-cxx}/{worker}/` and `.codex/skills/{owning-cxx}/{worker}/`; mission worker reports live under `.harness/documents/{goal-or-child-mission}/{owning-cxx}/workers/`. Flat `{mission}/workers/` reports are legacy and signal an ownership violation unless explicitly migrated.
-11. **Implementation Notes required** — `ceo.md`, every `{cxx}.md`, and every worker report must end with one English `## Implementation Notes` section containing `Design Decisions`, `Deviations`, `Tradeoffs`, and `Open Questions`. Use `None` for empty subsections. Do not create a separate sidecar notes file; the notes belong at the bottom of the same role or worker report that produced the decision/evidence.
-12. **Owner is final acceptance only** — Owner is not a tester or QA substitute. CEO/CXX must not report "done, please check" until worker-backed verification proves the goal can be completed. Use unit tests, E2E, Playwright, test accounts, seeded data, build/run checks, logs, and CQO evidence before requesting Owner acceptance.
-13. **OPS watches CQO verification** — For runnable products, CQO PASS is invalid unless OPS has monitored the verification runtime or documented why OPS watch is not applicable. Open OPS incidents, missing runtime mapping, required log gaps, service down, health mismatch, or an unmonitored tested service block Owner acceptance.
-14. **Production incidents are company events** — After launch, user-impacting OPS signals route through CEO to CTO/CQO/OPS. CTO owns recovery, CQO owns regression confirmation, and OPS owns evidence plus close criteria.
+11. **Lazy convention/gotcha loading** — CXX roles read `.harness/conventions/shared.md`, `.harness/conventions/{cxx}.md`, `.harness/gotchas/shared.md`, and `.harness/gotchas/{cxx}.md`, then follow only the related topic links listed in those CXX files. Workers read only the related links supplied by their owning CXX.
+12. **Implementation Notes required** — `ceo.md`, every `{cxx}.md`, and every worker report must end with one English `## Implementation Notes` section containing `Design Decisions`, `Deviations`, `Tradeoffs`, and `Open Questions`. Use `None` for empty subsections. Do not create a separate sidecar notes file; the notes belong at the bottom of the same role or worker report that produced the decision/evidence.
+13. **Structured runtime state** — If the harness must parse it, record it in JSON or JSONL. CXX todo queues, event history, heartbeat timestamps, preemption/resume state, and completion evidence belong in `.harness/todos/*.json*` or `.harness/events.jsonl`, not in free-form Markdown tables. Markdown remains for instructions, conventions, gotchas, skills, and human-readable mission narrative.
+14. **Owner is final acceptance only** — Owner is not a tester or QA substitute. CEO/CXX must not report "done, please check" until worker-backed verification proves the goal can be completed. Use unit tests, E2E, Playwright, test accounts, seeded data, build/run checks, logs, and CQO evidence before requesting Owner acceptance.
+15. **OPS watches CQO verification** — For runnable products, CQO PASS is invalid unless OPS has monitored the verification runtime or documented why OPS watch is not applicable. Open OPS incidents, missing runtime mapping, required log gaps, service down, health mismatch, or an unmonitored tested service block Owner acceptance.
+16. **Production incidents are company events** — After launch, user-impacting OPS signals route through CEO to CTO/CQO/OPS. CTO owns recovery, CQO owns regression confirmation, and OPS owns evidence plus close criteria.
 
 ---
 

package/assets/templates/HARNESS.md

@@ -51,11 +51,16 @@ Owner is the final acceptance reviewer, not a tester, QA substitute, debugger, o
 | `.harness/shared/HR-Resource/` | Hireable worker skill pool |
 | `.harness/shared/hr-roster.json` | Hired worker roster |
 | `.harness/archive/` | CQO-approved completed mission records |
-| `.harness/progress.log` | Append-only command and status history |
+| `.harness/events.jsonl` | Structured append-only runtime event stream |
+| `.harness/todos/state.json` | Machine-readable CXX todo queues |
+| `.harness/todos/events.jsonl` | Structured todo transition history |
+| `.harness/progress.log` | Legacy human-readable command and status history |
 | `.harness/progress.json` | Machine-readable current runtime state |
 
 Flat `.harness/documents/{mission}/workers/` reports are legacy. New worker evidence must be under `{owning-cxx}/workers/`.
 
+Runtime state that the harness must parse belongs in JSON or JSONL, not Markdown. Markdown remains valid for instructions, skills, conventions, gotchas, and human-facing mission narrative, but queues, events, heartbeats, preemption/resume state, and completion evidence must be machine-readable.
+
 ## Required Flow
 
 ### Goal

package/assets/templates/config.json

@@ -262,7 +262,7 @@
     "actions": ".harness/actions",
     "archive": ".harness/archive",
     "gotchas": ".harness/gotchas",
-    "conventions": "CONVENTIONS.md",
+    "conventions": ".harness/conventions",
     "progress_state": ".harness/progress.json",
     "progress_log": ".harness/progress.log"
   },
@@ -284,16 +284,18 @@
     "statuses": ["start", "complete", "fail", "pass", "skip", "warn"]
   },
   "conventions": {
-    "comment": "House-style registry. 루트 CONVENTIONS.md(사용자 자유 기술) + .harness/conventions/<scope>.md(Dispatcher 자동 누적). 모든 에이전트가 세션 시작 시 읽고 적용한다. Gotcha 의 긍정 대칭판.",
+    "comment": "House-style registry. CXX files act as lazy-loading indexes that link to topic-specific convention/gotcha documents.",
     "root_file": "CONVENTIONS.md",
     "scoped_dir": ".harness/conventions/",
-    "scopes": ["shared", "planner", "generator-backend", "generator-frontend", "evaluator-code-quality", "evaluator-functional", "evaluator-visual"],
+    "gotcha_scoped_dir": ".harness/gotchas/",
+    "cxx_scopes": ["ceo", "coo", "cdo", "cto", "cqo", "ops", "hiring", "resource-manager", "brick-office"],
     "entry_id_prefix": "C",
-    "read_by": "all_agents",
-    "read_order": ["CONVENTIONS.md", ".harness/conventions/shared.md", ".harness/conventions/<self>.md", ".harness/gotchas/<self>.md", ".harness/memory.md"],
-    "conflict_priority": "self > shared > root",
-    "write_by": "dispatcher (auto-append C-NNN) or user_only (manual edit)",
-    "read_timing": "session_start",
+    "read_by": "CEO, CXX, and hired workers",
+    "cxx_read_order": [".harness/conventions/shared.md", ".harness/conventions/<cxx>.md", "follow relevant links in <cxx>.md", ".harness/gotchas/shared.md", ".harness/gotchas/<cxx>.md", "follow relevant links in <cxx>.md", ".harness/memory.md"],
+    "worker_read_order": ["links explicitly provided by owning CXX in the worker brief"],
+    "conflict_priority": "linked topic > owning-cxx > shared > memory > root",
+    "write_by": "CQO/gotcha-register, CXX, or Owner-approved manual edit",
+    "read_timing": "before each role or worker starts mission work",
     "preserve_on_postinstall": true
   },
   "recommended_skills": {

package/assets/templates/todos-state.json.template

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "updated_at": "{{DATE_ISO}}",
+  "owners": {
+    "ceo": [],
+    "coo": [],
+    "cdo": [],
+    "cto": [],
+    "cqo": [],
+    "ops": []
+  }
+}