sentix 2.0.1 → 2.0.21

package/src/commands/init.js

@@ -19,7 +19,15 @@ registerCommand('init', {
 
     // ── 1. CLAUDE.md ────────────────────────────────
     if (ctx.exists('CLAUDE.md')) {
-      ctx.warn('CLAUDE.md already exists — skipping');
+      // CLAUDE.md가 이미 있지만 Sentix Governor 지시문이 없으면 주입
+      const existing = await ctx.readFile('CLAUDE.md');
+      if (!existing.includes('Sentix Governor') && !existing.includes('sentix') && !existing.includes('SENTIX')) {
+        const directive = generateGovernorDirective();
+        await ctx.writeFile('CLAUDE.md', existing + '\n' + directive);
+        ctx.success('CLAUDE.md updated — Sentix Governor directive injected');
+      } else {
+        ctx.warn('CLAUDE.md already has Sentix directives — skipping');
+      }
     } else {
       const claudeTemplate = `# CLAUDE.md — Sentix Governor 실행 지침
 
@@ -294,18 +302,39 @@ type: # api | library | framework | service
     }
 
     // ── Done ────────────────────────────────────────
+    // init 완료 후 자동으로 update 실행 (FRAMEWORK.md 등 동기화)
+    ctx.log('\n--- Syncing framework files ---\n');
+    try {
+      const { getCommand } = await import('../registry.js');
+      const updateCmd = getCommand('update');
+      if (updateCmd) {
+        await updateCmd.run([], ctx);
+      }
+    } catch {
+      ctx.warn('Auto-update skipped (run manually: sentix update)');
+    }
+
     ctx.log('\n=== Sentix initialized ===');
     ctx.log('');
     if (techStack.detected) {
       ctx.success(`Detected: ${techStack.runtime} / ${techStack.packageManager}${techStack.framework !== '# 프로젝트에 맞게 설정' ? ' / ' + techStack.framework : ''}`);
     }
-    ctx.log('Next steps:');
-    ctx.log('  1. Edit CLAUDE.md → 기술 스택을 프로젝트에 맞게 확인');
+
+    // init 끝에 자동으로 doctor 실행
+    ctx.log('\n--- Health Check ---\n');
+    try {
+      const { getCommand } = await import('../registry.js');
+      const doctorCmd = getCommand('doctor');
+      if (doctorCmd) {
+        await doctorCmd.run([], ctx);
+      }
+    } catch {
+      ctx.warn('Auto-check skipped (run manually: sentix doctor)');
+    }
+
     if (!hasSafety) {
-      ctx.log('  2. Run: sentix safety set <안전어>');
-      ctx.log('  3. Run: sentix doctor');
-    } else {
-      ctx.log('  2. Run: sentix doctor');
+      ctx.log('');
+      ctx.log('Optional: sentix safety set <안전어>  (LLM 인젝션 방지)');
     }
     ctx.log('');
   },
@@ -465,3 +494,62 @@ exit $?
 
   ctx.success('Installed git pre-commit hook (verification gates)');
 }
+
+// ── Governor 강제 지시문 (기존 CLAUDE.md에 주입) ─────────
+
+function generateGovernorDirective() {
+  return `
+---
+
+# Sentix Governor — 필수 준수 사항
+
+> **이 프로젝트는 Sentix 프레임워크로 관리된다.**
+> **아래 규칙은 어떤 역할(/frontend, /backend 등)에서든 반드시 따라야 한다.**
+> 상세 설계: FRAMEWORK.md, 세부 규칙: docs/
+
+## 코드 수정 전 필수 절차
+
+\`\`\`
+1. 코드 수정 요청을 받으면 → 반드시 Governor 파이프라인으로 진입
+2. 직접 코드를 수정하지 않는다 — 항상 아래 순서를 따른다:
+   → planner (티켓 생성) → dev (구현) → pr-review (검증) → security → roadmap
+3. 테스트 스냅샷 필수: 작업 전 npm test 또는 프로젝트 테스트 실행
+4. 티켓 없이 코드 수정 금지 — sentix ticket create 또는 sentix feature add 사용
+\`\`\`
+
+## 파괴 방지 하드 룰 6개
+
+1. 작업 전 테스트 스냅샷 필수
+2. 티켓 SCOPE 밖 파일 수정 금지
+3. 기존 export/API 삭제 금지
+4. 기존 테스트 삭제/약화 금지
+5. 순삭제 50줄 제한
+6. 기존 기능/핸들러 삭제 금지
+
+> 상세: .sentix/rules/hard-rules.md
+> 에이전트 범위: docs/agent-scopes.md
+> Severity 분기: docs/severity.md
+
+## 작업 완료 체크리스트
+
+\`\`\`
+□ 하드 룰 6개 위반 없음
+□ 검증 게이트 통과 (sentix run 시 자동 — scope, export, test, deletion)
+□ 테스트 통과
+□ 티켓 생성됨
+□ README.md 업데이트됨 (변경된 기능이 있다면)
+□ lessons.md 업데이트됨 (실패 패턴이 있었다면)
+\`\`\`
+
+## Sentix CLI
+
+\`\`\`bash
+sentix run "요청"              # Governor 파이프라인 실행
+sentix ticket create "설명"    # 버그 티켓 생성
+sentix feature add "설명"      # 기능 티켓 생성
+sentix status                  # 상태 확인
+sentix doctor                  # 설치 진단
+sentix update                  # 프레임워크 최신화
+\`\`\`
+`;
+}

package/src/lib/pipeline.js

@@ -29,13 +29,20 @@ export async function runChainedPipeline(request, cycleId, state, ctx, options =
   const phases = [];
   const startTime = Date.now();
 
-  // lessons.md, patterns.md 로드 (있으면)
+  // lessons.md, patterns.md, agent-methods.md 로드 (있으면)
   const lessons = ctx.exists('tasks/lessons.md')
     ? await ctx.readFile('tasks/lessons.md')
     : '';
   const patterns = ctx.exists('tasks/patterns.md')
     ? await ctx.readFile('tasks/patterns.md')
     : '';
+  const agentMethods = ctx.exists('docs/agent-methods.md')
+    ? await ctx.readFile('docs/agent-methods.md')
+    : '';
+
+  const methodsDirective = agentMethods.trim()
+    ? `\n--- agent-methods.md (MANDATORY — follow method order strictly) ---\n${agentMethods}`
+    : '';
 
   const learningContext = [
     lessons.trim() ? `\n--- lessons.md ---\n${lessons.slice(0, 2000)}` : '',
@@ -56,6 +63,8 @@ export async function runChainedPipeline(request, cycleId, state, ctx, options =
     '3. List the specific files that need to be changed (SCOPE)',
     '4. Estimate complexity (low/medium/high)',
     '5. DO NOT write any code. ONLY plan.',
+    '6. Define WHAT and WHERE only. DO NOT specify HOW (implementation details, function names, algorithms, library choices).',
+    methodsDirective,
     learningContext,
   ].filter(Boolean).join('\n'), ctx);
 
@@ -78,11 +87,14 @@ export async function runChainedPipeline(request, cycleId, state, ctx, options =
     'You are the DEV agent. Your job:',
     latestTicket ? `Ticket:\n${latestTicket}` : `Request: "${request}"`,
     '',
-    '1. Implement the changes described in the ticket',
-    '2. Write or update tests',
-    '3. Run: npm test — ensure all tests pass',
-    '4. Self-verify: check hard rules (no export deletion, no test deletion, scope compliance, <50 net deletions)',
-    '5. DO NOT update version, README, or CHANGELOG — that is the FINALIZE phase',
+    '1. Follow dev methods: snapshot() → implement() → test() → verify() → report()',
+    '2. Implement the changes described in the ticket — you decide HOW',
+    '3. Write or update tests',
+    '4. Run: npm test — ensure all tests pass',
+    '5. Self-verify: hard rules ONLY (no export deletion, no test deletion, scope compliance, <50 net deletions)',
+    '6. DO NOT judge code quality — that is pr-review\'s job',
+    '7. DO NOT update version, README, or CHANGELOG — that is the FINALIZE phase',
+    methodsDirective,
     learningContext,
   ].filter(Boolean).join('\n'), ctx);
 
@@ -135,12 +147,18 @@ export async function runChainedPipeline(request, cycleId, state, ctx, options =
     `Test results: ${testResult.status === 0 ? 'ALL PASSED' : 'SOME FAILED — fix them'}`,
     `Verification gates: ${midGateInfo}`,
     '',
-    '1. Review the git diff (run: git diff)',
-    '2. If tests failed, fix the failing tests (fix code, not tests)',
-    '3. If gate violations exist, fix them',
-    '4. Ensure code quality and hard rule compliance',
-    '5. Run: npm test — confirm all pass after fixes',
-  ].join('\n'), ctx);
+    '1. Follow pr-review methods: diff() → validate() → grade() → calibrate() → verdict()',
+    '2. Review the git diff (run: git diff)',
+    '3. Validate hard rules first — any violation = immediate REJECTED',
+    '4. Grade on 4 criteria: Correctness, Consistency, Simplicity, Test Coverage',
+    '   (skip grade() for low complexity — hard rule pass is sufficient)',
+    '5. Calibrate: check tasks/lessons.md for past missed issues — be skeptical, not generous',
+    '6. If tests failed, fix the failing tests (fix code, not tests)',
+    '7. If gate violations exist, fix them',
+    '8. Run: npm test — confirm all pass after fixes',
+    methodsDirective,
+    learningContext,
+  ].filter(Boolean).join('\n'), ctx);
 
   phases.push({ name: 'review', ...reviewResult });