@walwal-harness/cli 7.1.27 → 7.1.29

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

@@ -88,7 +88,7 @@ The Owner is the final acceptance reviewer, not a tester, QA worker, debugger, o
 4. CEO aggregates CXX outputs, routes to next CXX or reports to Owner.
 5. If the mission uses a runnable local, preview, Docker, or production-like environment, OPS watches the runtime while CQO evaluator workers run Playwright/E2E/API/visual/performance/regression checks.
 
-**Complete when:** `.harness/documents/goal-{index}-{name}/ceo.md` contains a final Owner report.
+**Complete when:** `.harness/documents/goal-{index}-{name}/ceo.md` contains a final Owner report and `mission-state.json` is terminal (`complete`, `closed`, `cancelled`, or `superseded`) with `active:false`.
 
 ### Submission
 
@@ -98,7 +98,7 @@ The Owner is the final acceptance reviewer, not a tester, QA worker, debugger, o
 4. Relevant CXX update `.harness/conventions/` when the new requirement changes durable project rules.
 5. Workers report under `{owning-cxx}/workers/`; CXX summarize choices in `{cxx}.md`.
 
-**Complete when:** the submission child directory has CEO/CXX records, required worker evidence, and any convention updates required by the new requirement.
+**Complete when:** the submission child directory has CEO/CXX records, required worker evidence, any convention updates required by the new requirement, and terminal `mission-state.json`.
 
 ### Hot Fix
 
@@ -150,9 +150,10 @@ Note: A docmeta skip decision on harness documents (ceo.md, cto.md, cqo.md, work
 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.
+14. **Mission lifecycle is explicit** — Every goal, submission, and hot-fix directory must contain `mission-state.json` with `lifecycle` and `active`. Only one child mission under a goal may be active. Starting a newer submission/hot-fix closes, cancels, or supersedes the previous active child unless CEO records a deliberate TODO/resume plan.
+15. **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.
+16. **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.
+17. **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/bin/init.js

@@ -112,6 +112,22 @@ function chmodShellScripts(dir) {
   }
 }
 
+function readJsonFileSafe(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function readTextFileSafe(filePath) {
+  try {
+    return fs.readFileSync(filePath, 'utf8');
+  } catch {
+    return null;
+  }
+}
+
 function fileExists(p) {
   return fs.existsSync(p);
 }
@@ -451,6 +467,99 @@ function migrateExistingDocs() {
   log(`Migration report: ${reportPath}`);
 }
 
+function missionTypeFromDirName(name) {
+  if (/^goal[-_]/i.test(name)) return 'goal';
+  if (/^submission[-_]/i.test(name)) return 'submission';
+  if (/^hot[-_]?fix[-_]/i.test(name) || /^hotfix[-_]/i.test(name)) return 'hotfix';
+  return 'unknown';
+}
+
+function isTerminalMissionLifecycle(value) {
+  return ['closed', 'cancelled', 'superseded', 'complete', 'blocked'].includes(String(value || '').toLowerCase());
+}
+
+function collectMissionDirs(docsDir) {
+  const cxxDocs = new Set(['ceo.md', 'coo.md', 'cdo.md', 'cto.md', 'cqo.md', 'ops.md']);
+  const result = [];
+  const walk = (dir, rel = '') => {
+    if (!fs.existsSync(dir)) return;
+    let entries = [];
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    const hasMissionDoc = entries.some((entry) => entry.isFile() && cxxDocs.has(entry.name));
+    if (rel && hasMissionDoc) {
+      let mtime = 0;
+      try { mtime = fs.statSync(dir).mtimeMs; } catch {}
+      const name = path.basename(rel);
+      result.push({ abs: dir, rel, name, type: missionTypeFromDirName(name), mtime });
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory() || entry.name.startsWith('.')) continue;
+      if (['workers', 'coo', 'cdo', 'cto', 'cqo', 'ops'].includes(entry.name)) continue;
+      walk(path.join(dir, entry.name), rel ? `${rel}/${entry.name}` : entry.name);
+    }
+  };
+  walk(docsDir);
+  return result;
+}
+
+function ensureMissionLifecycleStates(opts = {}) {
+  const dryRun = opts.dryRun || false;
+  const backupDir = opts.backupDir || null;
+  const docsDir = path.join(HARNESS_DIR, 'documents');
+  if (!fs.existsSync(docsDir)) return { missing: 0, written: 0 };
+
+  const missions = collectMissionDirs(docsDir);
+  if (!missions.length) return { missing: 0, written: 0 };
+
+  const byGoal = new Map();
+  for (const mission of missions) {
+    const goalKey = mission.rel.split('/')[0];
+    if (!byGoal.has(goalKey)) byGoal.set(goalKey, []);
+    byGoal.get(goalKey).push(mission);
+  }
+
+  const writes = [];
+  for (const group of byGoal.values()) {
+    const children = group.filter((m) => m.rel.includes('/') && (m.type === 'submission' || m.type === 'hotfix'));
+    children.sort((a, b) => b.mtime - a.mtime);
+    const existingActiveChild = children.find((m) => {
+      const state = readJsonFileSafe(path.join(m.abs, 'mission-state.json'));
+      return state?.active === true && !isTerminalMissionLifecycle(state.lifecycle || state.status);
+    });
+    const activeChild = existingActiveChild || children[0] || null;
+
+    for (const mission of group) {
+      const statePath = path.join(mission.abs, 'mission-state.json');
+      if (fs.existsSync(statePath)) continue;
+      const isChild = mission.rel.includes('/');
+      const isActive = isChild
+        ? activeChild?.rel === mission.rel
+        : true;
+      writes.push({
+        path: statePath,
+        state: {
+          lifecycle: isActive ? 'active' : 'closed',
+          active: isActive,
+        },
+      });
+    }
+  }
+
+  if (dryRun) return { missing: writes.length, written: 0 };
+
+  for (const item of writes) {
+    if (backupDir) {
+      const rel = path.relative(HARNESS_DIR, item.path).replace(/[\\/]/g, '__');
+      if (fs.existsSync(item.path)) fs.writeFileSync(path.join(backupDir, rel), fs.readFileSync(item.path, 'utf8'));
+    }
+    fs.writeFileSync(item.path, JSON.stringify(item.state, null, 2) + '\n');
+  }
+  if (writes.length) {
+    log(`mission-state.json: ${writes.length}개 기존 mission에 lifecycle 보강`);
+  }
+  return { missing: writes.length, written: writes.length };
+}
+
 // ─────────────────────────────────────────
 // 1. .harness/ scaffolding
 // ─────────────────────────────────────────
@@ -585,6 +694,7 @@ function scaffoldHarness() {
     if (!fileExists(p) || isForce) fs.writeFileSync(p, '');
   }
   ensureStructuredRuntimeFiles();
+  ensureMissionLifecycleStates();
 
   // Migrate progress.json v1 → v2 (add mode + team_state fields)
   const progressPath = path.join(HARNESS_DIR, 'progress.json');
@@ -1094,55 +1204,129 @@ function installAgentTeamsEnv() {
   }
 }
 
-function setupAgentsMd() {
+const HARNESS_HEADER_MARKER = '<!-- walwal-harness:managed-header -->';
+const HARNESS_SECTION_START = '<!-- walwal-harness:agents:start -->';
+const HARNESS_SECTION_END = '<!-- walwal-harness:agents:end -->';
+const PRESERVED_CLAUDE_START = '<!-- walwal-harness:preserved-claude:start -->';
+const PRESERVED_CLAUDE_END = '<!-- walwal-harness:preserved-claude:end -->';
+
+function backupDocPath(filePath, backupDir, label) {
+  if (!filePath || !fs.existsSync(filePath)) return;
+  ensureDir(backupDir);
+  const safe = label.replace(/[^A-Za-z0-9_.-]/g, '_');
+  const ts = new Date().toISOString().replace(/[:.]/g, '-');
+  try {
+    fs.copyFileSync(filePath, path.join(backupDir, `${safe}.${ts}.bak`));
+  } catch {}
+}
+
+function renderHarnessAgentsSection() {
+  const templateSrc = path.join(PKG_ROOT, 'assets', 'templates', 'AGENTS.md.template');
+  let content = fs.existsSync(templateSrc)
+    ? fs.readFileSync(templateSrc, 'utf8')
+    : '# walwal-harness\n\nUse `/goal`, `/submission`, and `/hot-fix` for CEO/CXX/worker flow.\n';
+  content = content.replace(/\{\{DATE\}\}/g, new Date().toISOString().split('T')[0]);
+  content = content.replace(/\{\{DATE_ISO\}\}/g, new Date().toISOString());
+  return [
+    HARNESS_SECTION_START,
+    '',
+    content.trim(),
+    '',
+    HARNESS_SECTION_END,
+    ''
+  ].join('\n');
+}
+
+function ensureTopHarnessHeader(body) {
+  if (body.includes(HARNESS_HEADER_MARKER)) return body;
+  const header = [
+    HARNESS_HEADER_MARKER,
+    '> This project is walwal-harness enabled. Harness operating rules live in the marked walwal-harness section below.',
+    ''
+  ].join('\n');
+  return header + body.replace(/^\s+/, '');
+}
+
+function upsertMarkedBlock(body, start, end, block) {
+  const startIdx = body.indexOf(start);
+  const endIdx = body.indexOf(end);
+  if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+    const afterEnd = endIdx + end.length;
+    return body.slice(0, startIdx).replace(/\s*$/, '\n\n') + block.trim() + '\n' + body.slice(afterEnd).replace(/^\s*/, '\n');
+  }
+  const sep = body.trim() ? '\n\n' : '';
+  return body.replace(/\s*$/, '') + sep + block.trim() + '\n';
+}
+
+function normalizeDocBody(body) {
+  return String(body || '').replace(/\r\n/g, '\n').trim();
+}
+
+function ensureProjectAgentDocs(opts = {}) {
+  const dryRun = opts.dryRun || false;
+  const backupDir = opts.backupDir || path.join(HARNESS_DIR, 'archive', 'pre-harness-backup');
   const agentsMd = path.join(PROJECT_ROOT, 'AGENTS.md');
   const claudeMd = path.join(PROJECT_ROOT, 'CLAUDE.md');
 
-  // Run scan if no AGENTS.md
-  if (!fileExists(agentsMd) || isForce) {
-    log('Running project scan...');
-    try {
-      execSync(`bash "${path.join(PKG_ROOT, 'scripts', 'scan-project.sh')}" "${PROJECT_ROOT}"`, {
-        stdio: 'inherit'
-      });
-      execSync(`bash "${path.join(PKG_ROOT, 'scripts', 'init-agents-md.sh')}" "${PROJECT_ROOT}"`, {
-        stdio: 'inherit'
-      });
-    } catch (e) {
-      log('WARNING: Auto-scan failed. Run manually: bash scripts/scan-project.sh .');
-      // Create minimal AGENTS.md
-      const templateSrc = path.join(PKG_ROOT, 'assets', 'templates', 'AGENTS.md.template');
-      if (fs.existsSync(templateSrc)) {
-        let content = fs.readFileSync(templateSrc, 'utf8');
-        content = content.replace(/\{\{DATE\}\}/g, new Date().toISOString().split('T')[0]);
-        fs.writeFileSync(agentsMd, content);
-      }
-    }
+  const agentsTarget = fs.existsSync(agentsMd) ? fs.realpathSync(agentsMd) : agentsMd;
+  const existingAgents = readTextFileSafe(agentsMd) || '';
+  const claudeExists = fs.existsSync(claudeMd) || fs.existsSync(claudeMd);
+  const claudeIsSymlink = fs.existsSync(claudeMd) && fs.lstatSync(claudeMd).isSymbolicLink();
+  const claudeTarget = claudeExists ? fs.realpathSync(claudeMd) : null;
+  const claudeBody = claudeExists ? (readTextFileSafe(claudeMd) || '') : '';
+
+  let nextAgents = existingAgents;
+  nextAgents = ensureTopHarnessHeader(nextAgents);
+  nextAgents = upsertMarkedBlock(nextAgents, HARNESS_SECTION_START, HARNESS_SECTION_END, renderHarnessAgentsSection());
+
+  const normalizedClaude = normalizeDocBody(claudeBody);
+  const claudePointsAtAgents = claudeIsSymlink && claudeTarget === agentsTarget;
+  if (normalizedClaude && !claudePointsAtAgents) {
+    const preservedBlock = [
+      PRESERVED_CLAUDE_START,
+      '',
+      '## Preserved CLAUDE.md',
+      '',
+      normalizedClaude,
+      '',
+      PRESERVED_CLAUDE_END,
+      ''
+    ].join('\n');
+    nextAgents = upsertMarkedBlock(nextAgents, PRESERVED_CLAUDE_START, PRESERVED_CLAUDE_END, preservedBlock);
   }
 
-  // Ensure CLAUDE.md symlink
-  if (fileExists(agentsMd)) {
-    try {
-      const stat = fs.lstatSync(claudeMd);
-      if (!stat.isSymbolicLink()) {
-        // Backup existing CLAUDE.md
-        const backupDir = path.join(HARNESS_DIR, 'archive', 'pre-harness-backup');
-        ensureDir(backupDir);
-        fs.copyFileSync(claudeMd, path.join(backupDir, `CLAUDE.md.${Date.now()}.bak`));
-        fs.unlinkSync(claudeMd);
-        fs.symlinkSync('AGENTS.md', claudeMd);
-        log('CLAUDE.md backed up and replaced with symlink → AGENTS.md');
-      }
-    } catch (e) {
-      // CLAUDE.md doesn't exist
-      try {
-        fs.symlinkSync('AGENTS.md', claudeMd);
-        log('Created symlink: CLAUDE.md → AGENTS.md');
-      } catch (e2) {}
-    }
+  if (dryRun) {
+    log('  (dry-run) AGENTS.md: walwal-harness marked section merge 예정');
+    if (!claudePointsAtAgents) log('  (dry-run) CLAUDE.md: content preserved then symlink → AGENTS.md 예정');
+    return;
+  }
+
+  if (fs.existsSync(agentsTarget)) backupDocPath(agentsTarget, backupDir, 'AGENTS.md');
+  if (claudeExists && claudeTarget && claudeTarget !== agentsTarget) {
+    backupDocPath(claudeTarget, backupDir, 'CLAUDE.md');
+  }
+
+  ensureDir(path.dirname(agentsMd));
+  fs.writeFileSync(agentsMd, nextAgents.replace(/\s*$/, '\n'));
+  log(fs.existsSync(agentsTarget) ? 'AGENTS.md merged with walwal-harness marked section' : 'AGENTS.md created from walwal-harness template');
+
+  try {
+    if (fs.existsSync(claudeMd) || fs.lstatSync(claudeMd)) fs.unlinkSync(claudeMd);
+  } catch {}
+  try {
+    fs.symlinkSync('AGENTS.md', claudeMd);
+    log('CLAUDE.md replaced with symlink → AGENTS.md');
+  } catch (e) {
+    log(`WARNING: Could not create CLAUDE.md symlink (${e.message})`);
   }
 }
 
+function setupAgentsMd() {
+  const agentsMd = path.join(PROJECT_ROOT, 'AGENTS.md');
+  const claudeMd = path.join(PROJECT_ROOT, 'CLAUDE.md');
+  ensureProjectAgentDocs({ backupDir: path.join(HARNESS_DIR, 'archive', 'pre-harness-backup') });
+}
+
 // ─────────────────────────────────────────
 // 5. Playwright MCP check
 // ─────────────────────────────────────────
@@ -1300,6 +1484,8 @@ function detectMigrationNeeded() {
     harnessMdStale: false,
     agentsMissingOpsVerificationRules: false,
     agentsMissingCodexAdapterRules: false,
+    agentsMissingMissionLifecycleRules: false,
+    missionLifecycleMissing: false,
     rosterCodexPathsMissing: false,
     resourceIndexCodexWordingMissing: false,
     memoryMissingSystemEntries: [],
@@ -1427,8 +1613,19 @@ function detectMigrationNeeded() {
       ) {
         flags.agentsMissingCodexAdapterRules = true;
       }
+      if (
+        !agentsBody.includes('Mission Lifecycle Rules') &&
+        !agentsBody.includes('mission-state.json')
+      ) {
+        flags.agentsMissingMissionLifecycleRules = true;
+      }
     } catch {}
   }
+  const docsDir = path.join(HARNESS_DIR, 'documents');
+  if (fs.existsSync(docsDir)) {
+    flags.missionLifecycleMissing = collectMissionDirs(docsDir)
+      .some((mission) => !fs.existsSync(path.join(mission.abs, 'mission-state.json')));
+  }
   if (fs.existsSync(rosterPath)) {
     try {
       const roster = JSON.parse(fs.readFileSync(rosterPath, 'utf8'));
@@ -1764,6 +1961,8 @@ function runMigrate(opts = {}) {
     !flags.agentsMissingOpsVerificationRules &&
     !flags.rosterCodexPathsMissing &&
     !flags.resourceIndexCodexWordingMissing &&
+    !flags.agentsMissingMissionLifecycleRules &&
+    !flags.missionLifecycleMissing &&
     (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0) &&
     gotchaMissingTotal === 0 &&
     conventionMissingTotal === 0 &&
@@ -1785,6 +1984,14 @@ function runMigrate(opts = {}) {
   const backupDir = path.join(HARNESS_DIR, 'archive', `migration-${ts}`);
   if (!dryRun) ensureDir(backupDir);
   ensureStructuredRuntimeFiles({ dryRun });
+  ensureProjectAgentDocs({ dryRun, backupDir });
+  flags.agentsMissingOpsVerificationRules = false;
+  flags.agentsMissingCodexAdapterRules = false;
+  flags.agentsMissingMissionLifecycleRules = false;
+  const missionStateResult = ensureMissionLifecycleStates({ dryRun, backupDir });
+  if (dryRun && missionStateResult.missing > 0) {
+    log(`  (dry-run) mission-state.json: ${missionStateResult.missing}개 기존 mission에 lifecycle 보강 예정`);
+  }
 
   // Runtime scripts are package-owned. Migrate must refresh them so existing
   // projects receive wake/meeting/OPS fixes without requiring a full init.
@@ -2099,6 +2306,31 @@ function runMigrate(opts = {}) {
     }
   }
 
+  if (flags.agentsMissingMissionLifecycleRules) {
+    const agentsPath = path.join(PROJECT_ROOT, 'AGENTS.md');
+    if (fs.existsSync(agentsPath)) {
+      const original = fs.readFileSync(agentsPath, 'utf8');
+      const block = [
+        '',
+        '---',
+        '',
+        '## walwal-harness Mission Lifecycle Rules — v7.1.28',
+        '',
+        '- Every goal, submission, and hot-fix directory must contain `mission-state.json` with `lifecycle` and `active`.',
+        '- Only one child mission under a goal may be active. Starting a newer submission/hot-fix closes, cancels, or supersedes the previous active child unless CEO records a deliberate TODO/resume plan.',
+        '- CXX completion requires a Worker Evidence Manifest plus worker report paths under `{owning-cxx}/workers/`. A CXX report without hired worker evidence is a protocol violation.',
+        '- Worker execution should be shown as worker activity; CXX activity is coordination only.',
+        ''
+      ].join('\n');
+      log('  AGENTS.md: mission lifecycle / CXX hire-only rules append');
+      if (!dryRun) {
+        fs.writeFileSync(path.join(backupDir, 'AGENTS.mission-lifecycle.md'), original);
+        const sep = original.endsWith('\n') ? '' : '\n';
+        fs.writeFileSync(agentsPath, original + sep + block);
+      }
+    }
+  }
+
   // 7. Bundle version stamp — record which package version was last applied.
   if (flags.bundleVersionStale) {
     const { current, installed } = flags.bundleVersionStale;

package/commands/goal.md

@@ -14,14 +14,16 @@ Codex adapter:
 
 Required flow:
 1. Create or update a goal under `.harness/documents/goal-{goal_index}-{goal_name}/`.
-2. Record CEO decisions in `.harness/documents/goal-{goal_index}-{goal_name}/ceo.md`.
-3. CEO decides whether brainstorming is needed or whether CXX questions can be issued immediately.
-4. CEO asks COO, CDO, CTO, and CQO only the questions needed for this goal.
-5. CXX roles must start in a fresh session context. Do not let the default model impersonate a missing worker.
-6. CXX roles must not directly execute specialist deliverables. They must use hired workers for research, planning, design, implementation, QA, ops checks, and documentation.
-7. If a required CXX or worker skill is missing, CEO must invoke the installed `harness-hiring` skill before assigning the work.
-8. CEO must require worker report paths under `.harness/documents/goal-{goal_index}-{goal_name}/{owning-cxx}/workers/` before accepting CXX completion.
-9. Do not invoke internal roles through slash commands; commands are Owner entrypoints only.
+2. Write `.harness/documents/goal-{goal_index}-{goal_name}/mission-state.json` with `{"lifecycle":"active","active":true}` before routing CXX.
+3. Record CEO decisions in `.harness/documents/goal-{goal_index}-{goal_name}/ceo.md`.
+4. CEO decides whether brainstorming is needed or whether CXX questions can be issued immediately.
+5. CEO asks COO, CDO, CTO, and CQO only the questions needed for this goal.
+6. CXX roles must start in a fresh session context. Do not let the default model impersonate a missing worker.
+7. CXX roles must not directly execute specialist deliverables. They must use hired workers for research, planning, design, implementation, QA, ops checks, and documentation.
+8. If a required CXX or worker skill is missing, CEO must invoke the installed `harness-hiring` skill before assigning the work.
+9. CEO must require a Worker Evidence Manifest and worker report paths under `.harness/documents/goal-{goal_index}-{goal_name}/{owning-cxx}/workers/` before accepting CXX completion.
+10. When the goal is accepted, cancelled, superseded, blocked, or closed, update `mission-state.json` to `complete`, `cancelled`, `superseded`, `blocked`, or `closed` and set `active:false`.
+11. Do not invoke internal roles through slash commands; commands are Owner entrypoints only.
 
 Note: A goal is the company's objective. Submissions and hot-fixes that happen while pursuing it should be recorded under that goal directory.
 

package/commands/hot-fix.md

@@ -14,16 +14,18 @@ Codex adapter:
 
 Required flow:
 1. Locate the active goal document root under `.harness/documents/{goal_name}/`. If no active goal exists, CEO must create/select one before proceeding.
-2. Create `.harness/documents/{goal_name}/hotfix-{hotfix_index}-{hotfix_name}/ceo.md`.
-3. CEO summons CTO and CQO first; summon COO/CDO only when planning or UX decisions are involved.
-4. CTO applies the smallest correct patch path through hired implementation skills.
-5. CXX roles must start in a fresh session context. Do not let the default model impersonate a missing CXX or worker.
-6. CXX roles must not directly execute specialist deliverables. They must use hired workers for implementation, QA, ops checks, and documentation even when the fix is small.
-7. If a required worker is missing, CEO or the responsible CXX must invoke the installed `harness-hiring` skill before assigning the work.
-8. CEO must require worker report paths under `.harness/documents/{goal_name}/hotfix-{hotfix_index}-{hotfix_name}/{owning-cxx}/workers/` before accepting CXX completion.
-9. CQO must register durable lessons in `.harness/gotchas/`, `.harness/conventions/`, or `.harness/memories/`. This step is mandatory, not optional, even for small fixes.
-10. Archive only after CQO has accepted the fix.
-11. Do not invoke internal roles through slash commands; commands are Owner entrypoints only.
+2. If another child mission under the goal is active, update its `mission-state.json` to `closed`, `cancelled`, or `superseded` with `active:false` before starting the hot-fix.
+3. Create `.harness/documents/{goal_name}/hotfix-{hotfix_index}-{hotfix_name}/ceo.md`.
+4. Write `.harness/documents/{goal_name}/hotfix-{hotfix_index}-{hotfix_name}/mission-state.json` with `{"lifecycle":"active","active":true}`.
+5. CEO summons CTO and CQO first; summon COO/CDO only when planning or UX decisions are involved.
+6. CTO applies the smallest correct patch path through hired implementation skills.
+7. CXX roles must start in a fresh session context. Do not let the default model impersonate a missing CXX or worker.
+8. CXX roles must not directly execute specialist deliverables. They must use hired workers for implementation, QA, ops checks, and documentation even when the fix is small.
+9. If a required worker is missing, CEO or the responsible CXX must invoke the installed `harness-hiring` skill before assigning the work.
+10. CEO must require a Worker Evidence Manifest and worker report paths under `.harness/documents/{goal_name}/hotfix-{hotfix_index}-{hotfix_name}/{owning-cxx}/workers/` before accepting CXX completion.
+11. CQO must register durable lessons in `.harness/gotchas/`, `.harness/conventions/`, or `.harness/memories/`. This step is mandatory, not optional, even for small fixes.
+12. Archive only after CQO has accepted the fix, then update `mission-state.json` to `complete` with `active:false`.
+13. Do not invoke internal roles through slash commands; commands are Owner entrypoints only.
 
 Note: `/hot-fix` is a problem-fix flow while pursuing the active goal. It belongs under that goal in history.
 

package/commands/submission.md

@@ -14,15 +14,18 @@ Codex adapter:
 
 Required flow:
 1. Locate the active goal document root under `.harness/documents/{goal_name}/`. If no active goal exists, CEO must ask the Owner to create or select one with `/goal` before proceeding.
-2. Create a submission record under `.harness/documents/{goal_name}/submission-{submission_index}-{submission_name}/`.
-3. Record CEO decisions in `.harness/documents/{goal_name}/submission-{submission_index}-{submission_name}/ceo.md`.
-4. CEO routes only to the CXX agents needed for this additional requirement.
-5. CXX roles must start in a fresh session context. Do not let the default model impersonate a missing CXX or worker.
-6. CXX roles must not directly execute specialist deliverables. They must use hired workers for research, planning, design, implementation, QA, ops checks, and documentation.
-7. If a required worker is missing, the responsible CXX must invoke the installed `harness-hiring` skill before assigning the work.
-8. CXX must manage conventions for new requirements. Durable changes in behavior, architecture, UI, process, or policy must be reflected in `.harness/conventions/` when accepted.
-9. CEO must require worker report paths under `.harness/documents/{goal_name}/submission-{submission_index}-{submission_name}/{owning-cxx}/workers/` before accepting CXX completion.
-10. Do not invoke internal roles through slash commands; commands are Owner entrypoints only.
+2. If another child mission under the goal is active, update its `mission-state.json` to `closed`, `cancelled`, or `superseded` with `active:false` before starting this submission.
+3. Create a submission record under `.harness/documents/{goal_name}/submission-{submission_index}-{submission_name}/`.
+4. Write `.harness/documents/{goal_name}/submission-{submission_index}-{submission_name}/mission-state.json` with `{"lifecycle":"active","active":true}`.
+5. Record CEO decisions in `.harness/documents/{goal_name}/submission-{submission_index}-{submission_name}/ceo.md`.
+6. CEO routes only to the CXX agents needed for this additional requirement.
+7. CXX roles must start in a fresh session context. Do not let the default model impersonate a missing CXX or worker.
+8. CXX roles must not directly execute specialist deliverables. They must use hired workers for research, planning, design, implementation, QA, ops checks, and documentation.
+9. If a required worker is missing, the responsible CXX must invoke the installed `harness-hiring` skill before assigning the work.
+10. CXX must manage conventions for new requirements. Durable changes in behavior, architecture, UI, process, or policy must be reflected in `.harness/conventions/` when accepted.
+11. CEO must require a Worker Evidence Manifest and worker report paths under `.harness/documents/{goal_name}/submission-{submission_index}-{submission_name}/{owning-cxx}/workers/` before accepting CXX completion.
+12. When the submission is accepted, cancelled, superseded, blocked, or closed, update `mission-state.json` to `complete`, `cancelled`, `superseded`, `blocked`, or `closed` and set `active:false`.
+13. Do not invoke internal roles through slash commands; commands are Owner entrypoints only.
 
 Note: `/submission` is not a new company goal and not an emergency fix. It is an additional requirement while pursuing the active goal. It belongs under that goal in history.
 

package/package.json

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

@@ -15,6 +15,7 @@ PROJECT_ROOT="${1:-.}"
 REASON="${2:-mission-complete}"
 
 PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+TODOS="$PROJECT_ROOT/.harness/todos/state.json"
 [ -f "$PROGRESS" ] || {
   echo "[company-complete] not found: $PROGRESS" >&2
   exit 1
@@ -40,4 +41,33 @@ bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" \
    .owner_prompt.status = "completed" |
    .owner_prompt.completed_at = (now | todate)'
 
+if [ -f "$TODOS" ]; then
+  tmp="$(mktemp)"
+  jq '
+    .owners |= with_entries(
+      .value |= map(
+        if (.status == "active" or .status == "pending" or .status == "paused")
+        then .status = "done" | .updated_at = (now | todate)
+        else .
+        end
+      )
+    )
+  ' "$TODOS" > "$tmp" && mv "$tmp" "$TODOS"
+fi
+
+DOCS="$PROJECT_ROOT/.harness/documents"
+if [ -d "$DOCS" ]; then
+  find "$DOCS" -name mission-state.json -type f -print0 | while IFS= read -r -d '' state; do
+    active="$(jq -r '.active // false' "$state" 2>/dev/null || echo false)"
+    lifecycle="$(jq -r '.lifecycle // .status // "unknown"' "$state" 2>/dev/null || echo unknown)"
+    case "$lifecycle" in
+      closed|cancelled|superseded|complete|blocked) continue ;;
+    esac
+    if [ "$active" = "true" ]; then
+      tmp="$(mktemp)"
+      jq '.lifecycle = "complete" | .active = false | .completed_at = (now | todate)' "$state" > "$tmp" && mv "$tmp" "$state"
+    fi
+  done
+fi
+
 echo "[company-complete] marked complete: $REASON"