@walwal-harness/cli 6.0.1 → 6.0.2

package/CHANGELOG.md

@@ -29,6 +29,27 @@ docmeta:
 
 # Changelog
 
+## 6.0.2 — `migrate` 가 memory 시스템 entry 까지 자동 처리 (2026-05-07)
+
+v6.0.1 patch 적용을 위해 사용자가 memory.md 의 [M-NEXUS-P3] 를 수동 추가해야 했던 불편을 제거. `npx walwal-harness migrate` 한 줄로 모두 처리됩니다.
+
+### Changed
+- `bin/init.js` 의 `detectMigrationNeeded()` 가 memory.md 의 시스템 entry (M-NEXUS-*, M-SYS-*) 누락도 감지.
+- `runMigrate()` 가 누락된 시스템 entry 를 template 에서 발췌해 사용자 memory.md 끝에 append. **사용자 [M-NNN] entry 는 무손상**.
+- postinstall 안내 banner 가 누락된 memory entry 목록도 함께 표시.
+
+### Migration (one-liner)
+```bash
+npm install @walwal-harness/cli@latest
+npx walwal-harness migrate          # progress + config + memory 한 번에
+```
+
+`migrate` 가 처리하는 것:
+- progress.json v3 → v4 (mode → "auto" + mode_decision)
+- config.json mode_selection 자동 주입
+- **(신규)** memory.md 시스템 entry append (M-NEXUS-P3 등)
+- 변경 전 .harness/archive/migration-<ts>/ 에 progress / config / memory 자동 백업.
+
 ## 6.0.1 — Owner ↔ CEO 정체성 + 자율 실행 룰 강화 (2026-05-07)
 
 v6.0.0 publish 직후 Owner 의 명시적 교정으로 발견된 두 가지 inviolable 룰 위반 패턴을 패키지에 정식 등재한 patch.

package/bin/init.js

@@ -973,10 +973,22 @@ function runTeamStudio() {
 // ─────────────────────────────────────────
 const TARGET_PROGRESS_VERSION = 4;
 
+// System memory entries that must exist in every install. ID prefix convention:
+//   M-NEXUS-*  : Foundational NEXUS doctrine rules
+//   M-SYS-*    : Cross-agent system-level rules
+// User-added [M-NNN] entries are NEVER touched.
+const SYSTEM_MEMORY_ENTRY_PATTERN = /^### \[M-(NEXUS|SYS)-[A-Z0-9_-]+\]/m;
+
 function detectMigrationNeeded() {
   const progressPath = path.join(HARNESS_DIR, 'progress.json');
   const configPath = path.join(HARNESS_DIR, 'config.json');
-  const flags = { progressV3toV4: false, configMissingModeSelection: false };
+  const memoryPath = path.join(HARNESS_DIR, 'memory.md');
+  const memoryTplPath = path.join(PKG_ROOT, 'assets', 'templates', 'memory.md');
+  const flags = {
+    progressV3toV4: false,
+    configMissingModeSelection: false,
+    memoryMissingSystemEntries: [],
+  };
   if (fs.existsSync(progressPath)) {
     try {
       const p = JSON.parse(fs.readFileSync(progressPath, 'utf8'));
@@ -989,9 +1001,35 @@ function detectMigrationNeeded() {
       if (!c.mode_selection) flags.configMissingModeSelection = true;
     } catch {}
   }
+  if (fs.existsSync(memoryPath) && fs.existsSync(memoryTplPath)) {
+    try {
+      const userMem = fs.readFileSync(memoryPath, 'utf8');
+      const tplMem = fs.readFileSync(memoryTplPath, 'utf8');
+      const tplEntryIds = extractEntryIds(tplMem).filter((id) => /^M-(NEXUS|SYS)-/.test(id));
+      const userEntryIds = new Set(extractEntryIds(userMem));
+      flags.memoryMissingSystemEntries = tplEntryIds.filter((id) => !userEntryIds.has(id));
+    } catch {}
+  }
   return flags;
 }
 
+// Returns the list of memory entry IDs found in the markdown body, e.g. ["M-001", "M-NEXUS-P3"].
+function extractEntryIds(md) {
+  const re = /^### \[(M-[A-Z0-9_-]+)\]/gm;
+  const ids = [];
+  let m;
+  while ((m = re.exec(md)) !== null) ids.push(m[1]);
+  return ids;
+}
+
+// Extracts a single entry block (heading + body until next ### or EOF) from the template.
+function extractEntryBlock(md, id) {
+  const escId = id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const re = new RegExp(`(^### \\[${escId}\\][\\s\\S]*?)(?=^### \\[|\\Z)`, 'm');
+  const m = md.match(re);
+  return m ? m[1].trimEnd() : null;
+}
+
 function showMigrationProposal(flags) {
   console.log('');
   console.log('╔══════════════════════════════════════════════════════════╗');
@@ -1005,6 +1043,11 @@ function showMigrationProposal(flags) {
     console.log('  • config.json: mode_selection 섹션 누락 — 자동 주입 가능');
     console.log('    Conductor 가 ready≥3 + features≥6 + depth≤2 로 자동 모드 결정.');
   }
+  if (flags.memoryMissingSystemEntries && flags.memoryMissingSystemEntries.length) {
+    console.log('  • memory.md: 시스템 entry 누락 — append 가능');
+    console.log('    [' + flags.memoryMissingSystemEntries.join(', ') + ']');
+    console.log('    사용자 [M-NNN] entry 는 보존, 시스템 entry 만 끝에 추가.');
+  }
   console.log('');
   console.log('  적용:  npx walwal-harness migrate');
   console.log('  미리보기:  npx walwal-harness migrate --dry-run');
@@ -1017,9 +1060,13 @@ function showMigrationProposal(flags) {
 function runMigrate(opts = {}) {
   const dryRun = opts.dryRun || false;
   const flags = detectMigrationNeeded();
-  if (!flags.progressV3toV4 && !flags.configMissingModeSelection) {
+  if (
+    !flags.progressV3toV4 &&
+    !flags.configMissingModeSelection &&
+    (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0)
+  ) {
     console.log('');
-    log('이미 최신 버전입니다 (progress.json v' + TARGET_PROGRESS_VERSION + ' + config.json mode_selection 존재).');
+    log('이미 최신 버전입니다 (progress v' + TARGET_PROGRESS_VERSION + ' + config.mode_selection + memory 시스템 entry 모두 존재).');
     return;
   }
 
@@ -1071,6 +1118,29 @@ function runMigrate(opts = {}) {
     }
   }
 
+  // 3. memory.md — append missing system entries (M-NEXUS-*, M-SYS-*) only.
+  //    User-added [M-NNN] entries are NEVER touched.
+  const memoryPath = path.join(HARNESS_DIR, 'memory.md');
+  const memoryTplPath = path.join(PKG_ROOT, 'assets', 'templates', 'memory.md');
+  const missingMemEntries = flags.memoryMissingSystemEntries || [];
+  if (missingMemEntries.length && fs.existsSync(memoryPath) && fs.existsSync(memoryTplPath)) {
+    const original = fs.readFileSync(memoryPath, 'utf8');
+    const tpl = fs.readFileSync(memoryTplPath, 'utf8');
+    const blocks = [];
+    for (const id of missingMemEntries) {
+      const block = extractEntryBlock(tpl, id);
+      if (block) blocks.push(block);
+    }
+    if (blocks.length) {
+      log(`  memory.md: 시스템 entry ${blocks.length}개 append (${missingMemEntries.join(', ')})`);
+      if (!dryRun) {
+        fs.writeFileSync(path.join(backupDir, 'memory.md'), original);
+        const sep = original.endsWith('\n') ? '\n' : '\n\n';
+        fs.writeFileSync(memoryPath, original + sep + blocks.join('\n\n') + '\n');
+      }
+    }
+  }
+
   console.log('');
   if (dryRun) {
     log('Dry-run 완료 — 실제 변경 적용하려면 `npx walwal-harness migrate` 실행');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "6.0.1",
+  "version": "6.0.2",
   "description": "Production harness for AI agent engineering — NEXUS-adapted company metaphor (Dispatcher/CEO + Conductor + Meeting-Manager + COO/Planner + CTO + CQO + Service-Ops). Solo/Team mode, Brainstormer, Planner, Generator(BE/FE/Designer/DevOps), Evaluator chain (Code-Quality → Functional → Visual + Architecture/Security). Supports React, Next.js, and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"