@walwal-harness/cli 7.1.25 → 7.1.27

package/bin/init.js

@@ -527,7 +527,6 @@ function scaffoldHarness() {
       copyFile(srcPath, destPath);
     }
   }
-
   // Copy conventions — mirror gotchas preservation: never overwrite files with
   // accumulated `### [C-NNN]` entries.
   const conventionsSrc = path.join(PKG_ROOT, 'conventions');
@@ -550,7 +549,6 @@ function scaffoldHarness() {
       copyFile(srcPath, destPath);
     }
   }
-
   // First-install migration: extract Convention/Gotcha-shaped sections from
   // existing CLAUDE.md / AGENTS.md and copy into the hierarchical stores.
   if (isFirstInstall) {
@@ -564,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');
@@ -571,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)) {
@@ -713,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/
 // ─────────────────────────────────────────
@@ -1265,6 +1305,7 @@ function detectMigrationNeeded() {
     memoryMissingSystemEntries: [],
     gotchaMissingEntries: {},   // { "<filename>": [G-IDs...] }
     conventionMissingEntries: {}, // { "<filename>": [C-IDs...] }
+    ruleRegistryLinks: [],
     bundleVersionStale: null,    // { current, installed }
   };
 
@@ -1418,6 +1459,7 @@ function detectMigrationNeeded() {
       flags.memoryMissingSystemEntries = tplEntryIds.filter((id) => !userEntryIds.has(id));
     } catch {}
   }
+  flags.ruleRegistryLinks = detectRuleRegistryLinks();
   return flags;
 }
 
@@ -1479,6 +1521,136 @@ function extractConventionEntryBlock(md, id) {
   return m ? m[1].trimEnd() : null;
 }
 
+const CANONICAL_RULE_SCOPES = new Set([
+  'README.md',
+  'shared.md',
+  'ceo.md',
+  'coo.md',
+  'cdo.md',
+  'cto.md',
+  'cqo.md',
+  'ops.md',
+  'hiring.md',
+  'resource-manager.md',
+  'brick-office.md',
+]);
+
+const CXX_RULE_LINK_MARKER = '<!-- walwal-harness:related-rule-links -->';
+
+function collectKnownWorkerNames() {
+  const names = new Set();
+  const hrRoot = path.join(HARNESS_DIR, 'shared', 'HR-Resource');
+  if (fs.existsSync(hrRoot)) {
+    for (const entry of fs.readdirSync(hrRoot, { withFileTypes: true })) {
+      if (entry.isDirectory()) names.add(entry.name);
+    }
+  }
+  const rosterPath = path.join(HARNESS_DIR, 'shared', 'hr-roster.json');
+  if (fs.existsSync(rosterPath)) {
+    try {
+      const roster = JSON.parse(fs.readFileSync(rosterPath, 'utf8'));
+      for (const entry of Array.isArray(roster.hired) ? roster.hired : []) {
+        if (entry?.worker) names.add(entry.worker);
+      }
+    } catch {}
+  }
+  return names;
+}
+
+function classifyRuleRegistryFile(file, kind, knownWorkers, body = '') {
+  const base = path.basename(file, '.md');
+  const ext = path.extname(file);
+  if (ext !== '.md') return null;
+  if (LEGACY_V7_FILE_OWNER[file]) {
+    return { targets: [path.basename(LEGACY_V7_FILE_OWNER[file], '.md')], reason: 'legacy-role' };
+  }
+  const haystack = `${base}\n${body}`.toLowerCase();
+  const targets = new Set();
+
+  if (/\b(i18n|intl|locale|localization|translation|translate|multilingual|language|aria|rtl|l10n)\b/.test(haystack)) {
+    targets.add('cto');
+    targets.add('cqo');
+  }
+  if (/\b(ui|ux|design|brand|visual|layout|accessibility|a11y|responsive|color|typography)\b/.test(haystack)) {
+    targets.add('cdo');
+    targets.add('cqo');
+  }
+  if (/\b(api|backend|frontend|database|schema|auth|flutter|react|next|build|deploy|port|integration|migration)\b/.test(haystack)) {
+    targets.add('cto');
+  }
+  if (/\b(test|qa|quality|regression|e2e|playwright|bug|hotfix|incident|failure|risk)\b/.test(haystack)) {
+    targets.add('cqo');
+  }
+  if (/\b(ops|runtime|server|log|monitor|health|production|docker|port)\b/.test(haystack)) {
+    targets.add('ops');
+  }
+  if (/\b(plan|research|market|hypothesis|requirement|product|scope)\b/.test(haystack)) {
+    targets.add('coo');
+  }
+  if (knownWorkers.has(base)) {
+    return { targets: ['coo', 'cto', 'cqo', 'ops'].filter(Boolean), reason: 'worker-topic' };
+  }
+  if (!targets.size) targets.add('shared');
+  return { targets: [...targets], reason: targets.has('shared') ? 'unclassified-topic' : 'topic-keywords' };
+}
+
+function detectRuleRegistryLinks() {
+  const links = [];
+  const knownWorkers = collectKnownWorkerNames();
+  for (const kind of ['conventions', 'gotchas']) {
+    const root = path.join(HARNESS_DIR, kind);
+    if (!fs.existsSync(root)) continue;
+    for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+      if (entry.isDirectory()) continue;
+      if (!entry.isFile() || !entry.name.endsWith('.md')) continue;
+      if (CANONICAL_RULE_SCOPES.has(entry.name)) continue;
+      const sourcePath = path.join(root, entry.name);
+      const body = fs.existsSync(sourcePath) ? fs.readFileSync(sourcePath, 'utf8') : '';
+      const classification = classifyRuleRegistryFile(entry.name, kind, knownWorkers, body);
+      if (!classification) continue;
+      links.push({
+        kind,
+        sourceRel: entry.name,
+        targets: classification.targets,
+        reason: classification.reason,
+      });
+    }
+  }
+  return links.filter((item) => item.targets.some((target) => !ruleRegistryLinkExists(item.kind, target, item.sourceRel)));
+}
+
+function ruleRegistryLinkExists(kind, target, sourceRel) {
+  const targetPath = path.join(HARNESS_DIR, kind, `${target}.md`);
+  if (!fs.existsSync(targetPath)) return false;
+  return fs.readFileSync(targetPath, 'utf8').includes(`](${sourceRel})`);
+}
+
+function updateRuleRegistryLinks(links, { dryRun, backupDir }) {
+  if (!links.length) return;
+  for (const item of links) {
+    const root = path.join(HARNESS_DIR, item.kind);
+    const sourcePath = path.join(root, item.sourceRel);
+    if (!fs.existsSync(sourcePath)) continue;
+    for (const target of item.targets) {
+      const targetPath = path.join(root, `${target}.md`);
+      if (path.resolve(sourcePath) === path.resolve(targetPath) || ruleRegistryLinkExists(item.kind, target, item.sourceRel)) continue;
+      log(`  ${item.kind}/${target}.md: link ${item.sourceRel} (${item.reason})`);
+      if (dryRun) continue;
+      ensureDir(path.dirname(targetPath));
+      const existing = fs.existsSync(targetPath) ? fs.readFileSync(targetPath, 'utf8').trimEnd() : `# ${target.toUpperCase()} ${item.kind === 'gotchas' ? 'Gotchas' : 'Conventions'}`;
+      if (fs.existsSync(targetPath)) {
+        const backupTarget = path.join(backupDir, `${item.kind}-${target}.md`);
+        fs.copyFileSync(targetPath, backupTarget);
+      }
+      const header = existing.includes(CXX_RULE_LINK_MARKER)
+        ? ''
+        : `\n\n## Related ${item.kind === 'gotchas' ? 'Gotcha' : 'Convention'} Links\n${CXX_RULE_LINK_MARKER}\n`;
+      const line = `- [${item.sourceRel}](${item.sourceRel}) — ${item.reason}`;
+      fs.writeFileSync(targetPath, `${existing}${header}${header ? '' : '\n'}${line}\n`);
+    }
+  }
+}
+
 function showMigrationProposal(flags) {
   console.log('');
   console.log('╔══════════════════════════════════════════════════════════╗');
@@ -1544,6 +1716,12 @@ function showMigrationProposal(flags) {
       console.log(`    ${file}: [${ids.join(', ')}]`);
     }
   }
+  if (flags.ruleRegistryLinks && flags.ruleRegistryLinks.length) {
+    console.log('  • conventions/gotchas: topic 파일을 CXX index 에 link 하여 lazy-load 가능하게 보강');
+    for (const item of flags.ruleRegistryLinks) {
+      console.log(`    ${item.kind}/${item.sourceRel} → ${item.targets.map((t) => `${item.kind}/${t}.md`).join(', ')} (${item.reason})`);
+    }
+  }
   if (flags.bundleVersionStale) {
     const { current, installed } = flags.bundleVersionStale;
     console.log(`  • bundle: ${installed ?? '(없음)'} → ${current} 스탬프 갱신 필요`);
@@ -1572,6 +1750,7 @@ function runMigrate(opts = {}) {
   const runtimeScriptsAlwaysRefresh = true;
   const gotchaMissingTotal = Object.values(flags.gotchaMissingEntries || {}).reduce((n, a) => n + a.length, 0);
   const conventionMissingTotal = Object.values(flags.conventionMissingEntries || {}).reduce((n, a) => n + a.length, 0);
+  const ruleRegistryLinkTotal = (flags.ruleRegistryLinks || []).length;
   if (
     !flags.progressV3toV4 &&
     !flags.progressLegacyRouting &&
@@ -1588,6 +1767,7 @@ function runMigrate(opts = {}) {
     (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0) &&
     gotchaMissingTotal === 0 &&
     conventionMissingTotal === 0 &&
+    ruleRegistryLinkTotal === 0 &&
     !flags.bundleVersionStale &&
     !runtimeScriptsAlwaysRefresh
   ) {
@@ -1604,10 +1784,12 @@ 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.
   refreshScriptsForMigrate({ dryRun, backupDir });
+  updateRuleRegistryLinks(flags.ruleRegistryLinks || [], { dryRun, backupDir });
 
   // 1. progress.json
   const progressPath = path.join(HARNESS_DIR, 'progress.json');

package/conventions/README.md

@@ -15,4 +15,6 @@ Only company-level roles are provided by default:
 - `resource-manager.md`
 - `brick-office.md`
 
-Specialist worker conventions are not bundled here. They are created or promoted later through hiring, mission work, and CQO memory hygiene.
+Topic-specific convention files may use descriptive names such as `i18n-locale.md`.
+
+CXX files such as `cto.md` and `cqo.md` act as lazy-loading indexes. Add links there when a topic file applies to that CXX.

package/conventions/coo.md

@@ -2,5 +2,6 @@
 
 - COO owns planning, research, service direction, reference models, and hypothesis validation.
 - COO records decisions in `.harness/documents/{mission_name}/coo.md`.
-- COO hires researchers, product planners, junior experiment developers, and documentation workers before delegating specialist work.
+- COO hires researchers, product planners, MCP registry stewards/capability scanners, junior experiment developers, and documentation workers before delegating specialist work.
+- COO planning must include an MCP Capability Inventory: available/applicable MCPs, required setup, read/write risk, recommended mission use, or explicit `None` when discovery is unavailable or no MCP applies.
 - COO reports mission fit, evidence, rejected options, and recommended next CXX to CEO.

package/gotchas/README.md

@@ -15,4 +15,6 @@ Only company-level roles are provided by default:
 - `resource-manager.md`
 - `brick-office.md`
 
-Specialist worker gotchas are not bundled. CQO promotes recurring verified failures into this store as the company learns.
+Topic-specific gotcha files may use descriptive names such as `i18n-locale-hotfix.md`.
+
+CXX files such as `cto.md` and `cqo.md` act as lazy-loading indexes. Add links there when a topic file applies to that CXX.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "7.1.25",
+  "version": "7.1.27",
   "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-gotcha-register.sh

@@ -70,6 +70,7 @@ TODAY="$(date +%Y-%m-%d)"
 register_one() {
   local target="$1" rule_id="$2" title="$3" wrong="$4" right="$5" why="$6" scope="$7" source="$8"
   local file="$GOTCHAS_DIR/${target}.md"
+  mkdir -p "$(dirname "$file")"
 
   # Ensure file exists with header
   if [ ! -f "$file" ]; then
@@ -184,6 +185,7 @@ register_convention_one() {
   local scope="$1" rule_id="$2" title="$3" rule="$4" why="$5" source="$6"
   mkdir -p "$CONVENTIONS_DIR"
   local file="$CONVENTIONS_DIR/${scope}.md"
+  mkdir -p "$(dirname "$file")"
 
   if [ ! -f "$file" ]; then
     cat > "$file" <<EOF

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
+}