sentix 2.1.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sentix",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Autonomous multi-agent DevSecOps pipeline CLI",
   "type": "module",
   "bin": {

package/src/commands/init.js

@@ -504,8 +504,16 @@ function generateGovernorDirective() {
 # Sentix Governor — 필수 준수 사항
 
 > **이 프로젝트는 Sentix 프레임워크로 관리된다.**
-> **아래 규칙은 어떤 역할(/frontend, /backend 등)에서든 반드시 따라야 한다.**
-> 상세 설계: FRAMEWORK.md, 세부 규칙: docs/
+> **아래 규칙은 어떤 역할(/frontend, /backend 등)에서든, 어떤 worktree에서든 반드시 따라야 한다.**
+
+## 세션 시작 시 필수 읽기 (순서대로)
+
+\`\`\`
+1. CLAUDE.md (이 파일)
+2. FRAMEWORK.md — 5-Layer 아키텍처, 에이전트 정의
+3. docs/agent-methods.md — 에이전트별 메서드 순서 (필수 준수)
+4. .sentix/rules/hard-rules.md — 파괴 방지 6개 규칙
+\`\`\`
 
 ## 코드 수정 전 필수 절차
 
@@ -517,6 +525,22 @@ function generateGovernorDirective() {
 4. 티켓 없이 코드 수정 금지 — sentix ticket create 또는 sentix feature add 사용
 \`\`\`
 
+## 에이전트 메서드 순서 (docs/agent-methods.md 필수 참조)
+
+\`\`\`
+planner: analyze() → research() → scope() → estimate() → emit()
+  → WHAT/WHERE만 정의. HOW(구현 방법) 금지.
+
+dev: snapshot() → implement() → test() → verify() → report()
+  → 구현 방법은 dev가 결정. 품질 판단은 pr-review에 위임.
+
+pr-review: diff() → validate() → grade() → calibrate() → verdict()
+  → 회의적 판정. 의심스러우면 REJECTED.
+
+dev-fix: diagnose() → fix() → test() → learn() → report()
+  → LESSON_LEARNED 필수.
+\`\`\`
+
 ## 파괴 방지 하드 룰 6개
 
 1. 작업 전 테스트 스냅샷 필수
@@ -549,7 +573,7 @@ sentix ticket create "설명"    # 버그 티켓 생성
 sentix feature add "설명"      # 기능 티켓 생성
 sentix status                  # 상태 확인
 sentix doctor                  # 설치 진단
-sentix update                  # 프레임워크 최신화
+sentix update                  # 프레임워크 최신화 (worktree도 root 포함)
 \`\`\`
 `;
 }

package/src/commands/update.js

@@ -11,8 +11,9 @@
 
 import { registerCommand } from '../registry.js';
 import { VERSION } from '../version.js';
-import { readFileSync, existsSync } from 'node:fs';
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -45,6 +46,104 @@ const SYNC_FILES = [
   { src: '.claude/agents/security.md',           dst: '.claude/agents/security.md' },
 ];
 
+// ── Worktree 감지: 현재 위치 + main working tree ────────
+
+function getUpdateTargets(ctx) {
+  const cwd = resolve(ctx.cwd);
+  const targets = [cwd];
+
+  try {
+    // git worktree인지 확인
+    const gitCommonDir = execSync('git rev-parse --git-common-dir', {
+      cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+
+    const mainGitDir = resolve(cwd, gitCommonDir);
+
+    // main working tree 경로 찾기
+    const worktreeList = execSync('git worktree list --porcelain', {
+      cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    const mainMatch = worktreeList.match(/^worktree (.+)$/m);
+    if (mainMatch) {
+      const mainRoot = mainMatch[1].trim();
+      const resolvedMain = resolve(mainRoot);
+      if (resolvedMain !== cwd && existsSync(resolvedMain)) {
+        targets.push(resolvedMain);
+        ctx.log(`Worktree detected → also updating main: ${resolvedMain}`);
+      }
+    }
+  } catch {
+    // git 없거나 worktree 아님 — 현재 디렉토리만
+  }
+
+  return targets;
+}
+
+// ── 파일 동기화 실행 ─────────────────────────────────────
+
+async function syncFiles(targetDir, dryRun, ctx) {
+  const results = { updated: [], created: [], skipped: [], unchanged: [] };
+
+  for (const { src, dst } of SYNC_FILES) {
+    const srcPath = resolve(sentixRoot, src);
+    const dstPath = resolve(targetDir, dst);
+
+    if (!existsSync(srcPath)) {
+      results.skipped.push({ file: dst, reason: 'source not found' });
+      continue;
+    }
+
+    const srcContent = readFileSync(srcPath, 'utf-8');
+
+    if (existsSync(dstPath)) {
+      const dstContent = readFileSync(dstPath, 'utf-8');
+
+      if (srcContent === dstContent) {
+        results.unchanged.push(dst);
+        continue;
+      }
+
+      const srcLines = srcContent.split('\n');
+      const dstLines = dstContent.split('\n');
+      const added = srcLines.length - dstLines.length;
+
+      ctx.log(`${dryRun ? '[DRY] ' : ''}Updating: ${dst}`);
+      ctx.log(`  ${dstLines.length} lines → ${srcLines.length} lines (${added >= 0 ? '+' : ''}${added})`);
+
+      if (!dryRun) {
+        mkdirSync(dirname(dstPath), { recursive: true });
+        writeFileSync(dstPath, srcContent);
+        ctx.success(`Updated: ${dst}`);
+      }
+      results.updated.push(dst);
+    } else {
+      ctx.log(`${dryRun ? '[DRY] ' : ''}Creating: ${dst}`);
+      if (!dryRun) {
+        mkdirSync(dirname(dstPath), { recursive: true });
+        writeFileSync(dstPath, srcContent);
+        ctx.success(`Created: ${dst}`);
+      }
+      results.created.push(dst);
+    }
+  }
+
+  // 요약
+  const totalChanges = results.updated.length + results.created.length;
+  if (results.updated.length > 0) {
+    ctx.log(`Updated: ${results.updated.length} — ${results.updated.join(', ')}`);
+  }
+  if (results.created.length > 0) {
+    ctx.log(`Created: ${results.created.length} — ${results.created.join(', ')}`);
+  }
+  if (totalChanges === 0) {
+    ctx.success('Already up to date.');
+  } else if (!dryRun) {
+    ctx.success(`${totalChanges} file(s) updated to sentix v${VERSION}.`);
+  }
+}
+
 registerCommand('update', {
   description: 'Update framework files to the latest sentix version',
   usage: 'sentix update [--dry]',
@@ -54,9 +153,6 @@ registerCommand('update', {
 
     ctx.log(`sentix update v${VERSION}`);
     ctx.log(`source: ${sentixRoot}`);
-    ctx.log(`target: ${ctx.cwd}`);
-    if (dryRun) ctx.warn('DRY RUN — no files will be changed\n');
-    else ctx.log('');
 
     // sentix 원본에서 실행 중인지 확인
     if (resolve(ctx.cwd) === resolve(sentixRoot)) {
@@ -64,95 +160,22 @@ registerCommand('update', {
       return;
     }
 
-    // sentix가 초기화된 프로젝트인지 확인
-    if (!ctx.exists('.sentix/config.toml') && !ctx.exists('CLAUDE.md')) {
-      ctx.error('This project has not been initialized with sentix.');
-      ctx.log('Run: sentix init');
-      return;
-    }
-
-    const results = { updated: [], created: [], skipped: [], unchanged: [] };
+    // 업데이트 대상 디렉토리 수집 (현재 + worktree면 root도)
+    const targets = getUpdateTargets(ctx);
 
-    for (const { src, dst } of SYNC_FILES) {
-      const srcPath = resolve(sentixRoot, src);
+    for (const target of targets) {
+      ctx.log(`\n--- target: ${target} ---`);
+      if (dryRun) ctx.warn('DRY RUN\n');
 
-      // 원본 파일이 없으면 스킵
-      if (!existsSync(srcPath)) {
-        results.skipped.push({ file: dst, reason: 'source not found' });
+      // sentix가 초기화된 프로젝트인지 확인
+      const hasConfig = existsSync(resolve(target, '.sentix/config.toml'));
+      const hasClaude = existsSync(resolve(target, 'CLAUDE.md'));
+      if (!hasConfig && !hasClaude) {
+        ctx.warn(`Not a sentix project: ${target} — skipping`);
         continue;
       }
 
-      const srcContent = readFileSync(srcPath, 'utf-8');
-
-      if (ctx.exists(dst)) {
-        const dstContent = await ctx.readFile(dst);
-
-        if (srcContent === dstContent) {
-          results.unchanged.push(dst);
-          continue;
-        }
-
-        // diff 요약 생성
-        const srcLines = srcContent.split('\n');
-        const dstLines = dstContent.split('\n');
-        const added = srcLines.length - dstLines.length;
-
-        ctx.log(`${dryRun ? '[DRY] ' : ''}Updating: ${dst}`);
-        ctx.log(`  ${dstLines.length} lines → ${srcLines.length} lines (${added >= 0 ? '+' : ''}${added})`);
-
-        // 주요 변경 내용 표시 (새로 추가된 라인 중 의미 있는 것)
-        const dstSet = new Set(dstLines.map(l => l.trim()));
-        const newLines = srcLines
-          .filter(l => l.trim() && !l.trim().startsWith('#') && !dstSet.has(l.trim()))
-          .slice(0, 5);
-        if (newLines.length > 0) {
-          ctx.log('  New:');
-          for (const line of newLines) {
-            ctx.log(`    + ${line.trim().substring(0, 80)}`);
-          }
-        }
-
-        if (!dryRun) {
-          await ctx.writeFile(dst, srcContent);
-          ctx.success(`Updated: ${dst}`);
-        }
-        results.updated.push(dst);
-      } else {
-        ctx.log(`${dryRun ? '[DRY] ' : ''}Creating: ${dst}`);
-        if (!dryRun) {
-          await ctx.writeFile(dst, srcContent);
-          ctx.success(`Created: ${dst}`);
-        }
-        results.created.push(dst);
-      }
-    }
-
-    // 요약
-    ctx.log('\n=== Update Summary ===');
-    if (results.updated.length > 0) {
-      ctx.log(`Updated:   ${results.updated.length} file(s)`);
-      for (const f of results.updated) ctx.log(`  ${f}`);
-    }
-    if (results.created.length > 0) {
-      ctx.log(`Created:   ${results.created.length} file(s)`);
-      for (const f of results.created) ctx.log(`  ${f}`);
-    }
-    if (results.unchanged.length > 0) {
-      ctx.log(`Unchanged: ${results.unchanged.length} file(s)`);
-    }
-    if (results.skipped.length > 0) {
-      ctx.warn(`Skipped:   ${results.skipped.length} file(s)`);
-      for (const s of results.skipped) ctx.log(`  ${s.file} (${s.reason})`);
-    }
-
-    const totalChanges = results.updated.length + results.created.length;
-    if (totalChanges === 0) {
-      ctx.success('\nAlready up to date.');
-    } else if (dryRun) {
-      ctx.warn(`\n${totalChanges} file(s) would be changed. Run without --dry to apply.`);
-    } else {
-      ctx.success(`\n${totalChanges} file(s) updated to sentix v${VERSION}.`);
-      ctx.log('Run: sentix doctor  — to verify project health');
+      await syncFiles(target, dryRun, ctx);
     }
   },
 });