@walwal-harness/cli 7.1.26 → 7.1.28

package/apps/harness-dashboard/package.json

@@ -20,6 +20,8 @@
     "next": "^15.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
     "three": "^0.184.0"
   },
   "devDependencies": {

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 |
@@ -145,10 +148,11 @@ Note: A docmeta skip decision on harness documents (ceo.md, cto.md, cqo.md, work
 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. **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.
-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.
+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/todos-state.json.template

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

package/bin/init.js

@@ -562,6 +562,7 @@ function scaffoldHarness() {
   // Copy templates as initial files
   const templateMap = {
     'progress.json.template': path.join(HARNESS_DIR, 'progress.json'),
+    'todos-state.json.template': path.join(HARNESS_DIR, 'todos', 'state.json'),
   };
 
   const templatesDir = path.join(PKG_ROOT, 'assets', 'templates');
@@ -569,13 +570,22 @@ function scaffoldHarness() {
     for (const [template, dest] of Object.entries(templateMap)) {
       const src = path.join(templatesDir, template);
       if (fs.existsSync(src) && (!fileExists(dest) || isForce)) {
+        ensureDir(path.dirname(dest));
         let content = fs.readFileSync(src, 'utf8');
         content = content.replace(/\{\{DATE\}\}/g, new Date().toISOString().split('T')[0]);
+        content = content.replace(/\{\{DATE_ISO\}\}/g, new Date().toISOString());
         fs.writeFileSync(dest, content);
       }
     }
   }
 
+  ensureDir(path.join(HARNESS_DIR, 'todos'));
+  for (const rel of ['events.jsonl', path.join('todos', 'events.jsonl')]) {
+    const p = path.join(HARNESS_DIR, rel);
+    if (!fileExists(p) || isForce) fs.writeFileSync(p, '');
+  }
+  ensureStructuredRuntimeFiles();
+
   // Migrate progress.json v1 → v2 (add mode + team_state fields)
   const progressPath = path.join(HARNESS_DIR, 'progress.json');
   if (fileExists(progressPath)) {
@@ -711,6 +721,38 @@ function ensureHarnessEnv() {
   log('.env: HARNESS_BASE_PORT placeholder added — set value with Owner approval before starting services');
 }
 
+function ensureStructuredRuntimeFiles({ dryRun = false } = {}) {
+  const todosDir = path.join(HARNESS_DIR, 'todos');
+  const statePath = path.join(todosDir, 'state.json');
+  const eventsPath = path.join(HARNESS_DIR, 'events.jsonl');
+  const todoEventsPath = path.join(todosDir, 'events.jsonl');
+  const todoTplPath = path.join(PKG_ROOT, 'assets', 'templates', 'todos-state.json.template');
+
+  const missing = [eventsPath, statePath, todoEventsPath].filter((p) => !fileExists(p));
+  if (!missing.length) return false;
+
+  log(`  structured runtime: ${missing.map((p) => path.relative(HARNESS_DIR, p)).join(', ')} 생성`);
+  if (dryRun) return true;
+
+  ensureDir(todosDir);
+  if (!fileExists(eventsPath)) fs.writeFileSync(eventsPath, '');
+  if (!fileExists(todoEventsPath)) fs.writeFileSync(todoEventsPath, '');
+  if (!fileExists(statePath)) {
+    let content;
+    if (fileExists(todoTplPath)) {
+      content = fs.readFileSync(todoTplPath, 'utf8').replace(/\{\{DATE_ISO\}\}/g, new Date().toISOString());
+    } else {
+      content = JSON.stringify({
+        version: 1,
+        updated_at: new Date().toISOString(),
+        owners: { ceo: [], coo: [], cdo: [], cto: [], cqo: [], ops: [] },
+      }, null, 2) + '\n';
+    }
+    fs.writeFileSync(statePath, content);
+  }
+  return true;
+}
+
 // ─────────────────────────────────────────
 // 2. Skills → .claude/skills/
 // ─────────────────────────────────────────
@@ -1742,6 +1784,7 @@ function runMigrate(opts = {}) {
   const ts = new Date().toISOString().replace(/[:.]/g, '-');
   const backupDir = path.join(HARNESS_DIR, 'archive', `migration-${ts}`);
   if (!dryRun) ensureDir(backupDir);
+  ensureStructuredRuntimeFiles({ dryRun });
 
   // Runtime scripts are package-owned. Migrate must refresh them so existing
   // projects receive wake/meeting/OPS fixes without requiring a full init.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "7.1.26",
+  "version": "7.1.28",
   "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"

package/scripts/harness-user-prompt-submit.sh

@@ -10,6 +10,8 @@ if [ -z "$CWD" ]; then CWD="$PWD"; fi
 # 조건 1: 하네스 초기화 확인
 if [ ! -f "$CWD/.harness/config.json" ]; then exit 0; fi
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+STRUCTURED_LIB="$SCRIPT_DIR/lib/harness-structured-log.sh"
+[ -f "$STRUCTURED_LIB" ] && source "$STRUCTURED_LIB"
 
 # 조건 2: opt-out 플래그 확인
 AUTO_ROUTE="true"
@@ -71,7 +73,47 @@ if [ -n "$PROMPT" ] && [ -d "$CWD/.harness" ]; then
       COMMAND_TYPE="hot-fix"
     fi
     echo "$(date +"%Y-%m-%d %H:%M") | user-prompt | ${COMMAND_TYPE} | ${PROMPT_SHORT}" >> "$PROGRESS_LOG"
+    if declare -f harness_emit_event >/dev/null 2>&1; then
+      NOW_ISO_EVENT=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+      EVENT_JSON=$(jq -nc \
+        --arg ts "$NOW_ISO_EVENT" \
+        --arg command "$COMMAND_TYPE" \
+        --arg summary "$PROMPT_SHORT" \
+        '{ts:$ts,type:"user_prompt",command:$command,summary:$summary,source:"UserPromptSubmit"}')
+      harness_emit_event "$CWD" "$EVENT_JSON"
+    fi
     if [ "$COMMAND_TYPE" = "goal" ] || [ "$COMMAND_TYPE" = "submission" ] || [ "$COMMAND_TYPE" = "hot-fix" ]; then
+      if declare -f harness_todo_upsert >/dev/null 2>&1; then
+        NOW_ISO_TODO=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+        PRIORITY=50
+        KIND="$COMMAND_TYPE"
+        [ "$COMMAND_TYPE" = "hot-fix" ] && PRIORITY=100 && KIND="hotfix"
+        TODO_ID="ceo-${COMMAND_TYPE}-$(date -u +%Y%m%dT%H%M%SZ)"
+        TODO_JSON=$(jq -nc \
+          --arg id "$TODO_ID" \
+          --arg owner "ceo" \
+          --arg kind "$KIND" \
+          --arg title "$PROMPT_SHORT" \
+          --arg status "active" \
+          --arg now "$NOW_ISO_TODO" \
+          --argjson priority "$PRIORITY" \
+          '{
+            id:$id,
+            owner:$owner,
+            kind:$kind,
+            title:$title,
+            status:$status,
+            priority:$priority,
+            command:$kind,
+            mission_path:null,
+            required_artifacts:[],
+            created_at:$now,
+            updated_at:$now,
+            last_heartbeat_at:$now,
+            blocked_reason:null
+          }')
+        harness_todo_upsert "$CWD" "$TODO_JSON"
+      fi
       if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
         TMP_PROGRESS="${CWD}/.harness/progress.json.tmp.$$"
         NOW_ISO=$(date -u +"%Y-%m-%dT%H:%M:%SZ")

package/scripts/lib/harness-structured-log.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# Structured runtime helpers for events.jsonl and todos/state.json.
+
+harness_json_escape() {
+  jq -Rs . 2>/dev/null
+}
+
+harness_ensure_structured_runtime() {
+  local project_root="${1:-.}"
+  local harness_dir="$project_root/.harness"
+  [ -d "$harness_dir" ] || return 0
+  mkdir -p "$harness_dir/todos"
+  [ -f "$harness_dir/events.jsonl" ] || : > "$harness_dir/events.jsonl"
+  [ -f "$harness_dir/todos/events.jsonl" ] || : > "$harness_dir/todos/events.jsonl"
+  if [ ! -f "$harness_dir/todos/state.json" ]; then
+    jq -n --arg now "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '{
+      version: 1,
+      updated_at: $now,
+      owners: {ceo: [], coo: [], cdo: [], cto: [], cqo: [], ops: []}
+    }' > "$harness_dir/todos/state.json"
+  fi
+}
+
+harness_emit_event() {
+  local project_root="$1"
+  local event_json="$2"
+  harness_ensure_structured_runtime "$project_root"
+  local path="$project_root/.harness/events.jsonl"
+  jq -c --arg now "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '
+    . + {ts: (.ts // $now)}
+  ' <<<"$event_json" >> "$path" 2>/dev/null || true
+}
+
+harness_todo_upsert() {
+  local project_root="$1"
+  local todo_json="$2"
+  harness_ensure_structured_runtime "$project_root"
+  local state="$project_root/.harness/todos/state.json"
+  local events="$project_root/.harness/todos/events.jsonl"
+  local tmp="$state.tmp.$$"
+  local now
+  now="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+
+  jq -c --arg now "$now" '. + {ts: (.ts // $now), type: (.type // "todo_upsert")}' <<<"$todo_json" >> "$events" 2>/dev/null || true
+  if jq --argjson todo "$todo_json" --arg now "$now" '
+    .version = (.version // 1) |
+    .updated_at = $now |
+    .owners = (.owners // {ceo: [], coo: [], cdo: [], cto: [], cqo: [], ops: []}) |
+    ($todo.owner // "ceo") as $owner |
+    .owners[$owner] = (.owners[$owner] // []) |
+    .owners[$owner] = ((.owners[$owner] | map(select(.id != $todo.id))) + [
+      ($todo + {updated_at: ($todo.updated_at // $now), created_at: ($todo.created_at // $now)})
+    ] | sort_by(-(.priority // 0), .created_at))
+  ' "$state" > "$tmp" 2>/dev/null; then
+    mv "$tmp" "$state"
+  else
+    rm -f "$tmp"
+  fi
+}