@tuzi-ince/hi-loop 0.2.2 → 0.3.1

package/src/vcs.js

@@ -0,0 +1,167 @@
+/**
+ * 브랜치·커밋 메커니즘 (FR-16) — 엔진이 소유하는 git 조작.
+ *
+ * 철학: **엔진은 메커니즘(git 실행)을, LLM 은 산문(좋은 커밋 메시지)을 소유한다.**
+ * 그래서 여기 함수들은 순수 git 이고, 메시지는 인자로 받거나(스킬이 지어 넘김) 없으면
+ * goal 기반 휴리스틱으로 만든다. checkpoint.js 의 git 패턴(실패 시 null, 비-git skip)을 따른다.
+ */
+import { execFile } from 'node:child_process';
+import { isGitRepo } from './checkpoint.js';
+
+/** `{ ok, out }`. 실패(비-0 exit)면 ok:false, out 은 stdout+stderr. */
+function git(args, cwd) {
+  return new Promise((resolve) => {
+    execFile('git', args, { cwd, maxBuffer: 1024 * 1024 }, (err, stdout, stderr) => {
+      const out = `${String(stdout ?? '')}${String(stderr ?? '')}`.trim();
+      resolve({ ok: !err, out });
+    });
+  });
+}
+
+/** 현재 브랜치명. detached/비-git 이면 null. */
+export async function currentBranch(cwd) {
+  const r = await git(['rev-parse', '--abbrev-ref', 'HEAD'], cwd);
+  if (!r.ok) return null;
+  const name = r.out.trim();
+  return name && name !== 'HEAD' ? name : null; // 'HEAD' = detached
+}
+
+/** 이 브랜치가 보호 대상인가. */
+export function isProtected(branch, protectedBranches) {
+  if (!branch) return false;
+  const list = Array.isArray(protectedBranches) ? protectedBranches : [];
+  return list.includes(branch);
+}
+
+/** goal → 브랜치 slug. 소문자 kebab, 안전 문자만, 앞부분만. 비면 'change'. */
+export function slugify(goal) {
+  const base = String(goal ?? '')
+    .toLowerCase()
+    .replace(/[^a-z0-9가-힣]+/g, '-') // 공백·기호 → 하이픈 (한글은 보존)
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 40)
+    .replace(/-+$/g, '');
+  return base || 'change';
+}
+
+/** feature 브랜치로 생성/전환. 이미 있으면 전환. 반환 `{ ok, branch, created, reason }`. */
+export async function createBranch(cwd, name) {
+  const branch = String(name ?? '').trim();
+  if (!branch) return { ok: false, reason: '브랜치 이름이 비어 있습니다.' };
+  const exists = (await git(['rev-parse', '--verify', '--quiet', `refs/heads/${branch}`], cwd)).ok;
+  const r = exists ? await git(['switch', branch], cwd) : await git(['switch', '-c', branch], cwd);
+  if (!r.ok) return { ok: false, reason: r.out || 'git switch 실패' };
+  return { ok: true, branch, created: !exists };
+}
+
+/** 워킹트리 전체를 스테이징하고 커밋. 변경 없으면 실패로 돌려준다. 반환 `{ ok, sha, reason }`. */
+export async function commitAll(cwd, message) {
+  const msg = String(message ?? '').trim();
+  if (!msg) return { ok: false, reason: '커밋 메시지가 비어 있습니다.' };
+  await git(['add', '-A'], cwd);
+  // 스테이징 후에도 변경이 없으면 커밋할 게 없다 — 조용히 실패로 신호.
+  const staged = await git(['diff', '--cached', '--quiet'], cwd);
+  if (staged.ok) return { ok: false, reason: '커밋할 변경이 없습니다.' };
+  const c = await git(['commit', '-m', msg], cwd);
+  if (!c.ok) return { ok: false, reason: c.out || 'git commit 실패' };
+  const sha = await git(['rev-parse', 'HEAD'], cwd);
+  return { ok: true, sha: sha.ok ? sha.out.trim() : null };
+}
+
+const CONVENTIONAL = /^(\w+)(\(.+\))?!?:\s/;
+
+/** 최근 커밋 제목들을 보고 Conventional Commits 관행인지 추정. 'conventional' | 'plain'. */
+export async function detectCommitStyle(cwd) {
+  const r = await git(['log', '-20', '--pretty=%s'], cwd);
+  if (!r.ok || !r.out) return 'plain'; // 커밋 이력이 없으면 평문
+  const subjects = r.out.split('\n').filter(Boolean);
+  const conv = subjects.filter((s) => CONVENTIONAL.test(s)).length;
+  return conv / subjects.length >= 0.5 ? 'conventional' : 'plain';
+}
+
+/** goal 키워드 → conventional type. 확신 없으면 chore. */
+function inferType(goal) {
+  const g = String(goal ?? '').toLowerCase();
+  if (/(추가|만들|신규|기능|feat|add|implement)/.test(g)) return 'feat';
+  if (/(고치|버그|수정|오류|fix|bug)/.test(g)) return 'fix';
+  if (/(리팩터|정리|refactor|cleanup)/.test(g)) return 'refactor';
+  if (/(문서|docs|readme)/.test(g)) return 'docs';
+  if (/(테스트|test)/.test(g)) return 'test';
+  return 'chore';
+}
+
+/** goal 첫 줄을 커밋 제목 길이로 다듬는다. */
+function firstLine(goal) {
+  const line = String(goal ?? '').split('\n')[0].trim();
+  return line.length > 72 ? `${line.slice(0, 69)}...` : line;
+}
+
+/**
+ * 메시지가 안 주어졌을 때 goal 로 커밋 메시지를 만든다.
+ * styleConfig: 'korean'=goal 그대로 | 'conventional'=type 접두 | 'match-log'=repo 관행 따름.
+ */
+export async function buildCommitMessage({ goal, styleConfig = 'match-log', cwd }) {
+  const subject = firstLine(goal) || 'update';
+  if (styleConfig === 'korean') return subject;
+  const conventional =
+    styleConfig === 'conventional' || (styleConfig === 'match-log' && (await detectCommitStyle(cwd)) === 'conventional');
+  return conventional ? `${inferType(goal)}: ${subject}` : subject;
+}
+
+/**
+ * 주입 가능한 브랜치 포트 (NFR-3). 보호 브랜치에 있을 때만 feature 로 분기한다.
+ * 반환: `{ branched, branch, reason }`.
+ */
+export function makeBrancher() {
+  return async ({ cwd, name = null, goal, protectedBranches, logger = () => {} }) => {
+    if (!(await isGitRepo(cwd))) return { branched: false, reason: 'non-git' };
+    const cur = await currentBranch(cwd);
+    if (!isProtected(cur, protectedBranches)) {
+      return { branched: false, branch: cur, reason: 'not-protected' };
+    }
+    const target = (typeof name === 'string' && name.trim()) ? name.trim() : `feature/${slugify(goal)}`;
+    const r = await createBranch(cwd, target);
+    if (!r.ok) {
+      logger(`[hi-loop] ⚠️ 브랜치 분기 실패: ${r.reason}`);
+      return { branched: false, reason: r.reason };
+    }
+    logger(`[hi-loop] 🌱 ${cur} → ${r.branch} (${r.created ? '생성' : '전환'})`);
+    return { branched: true, branch: r.branch };
+  };
+}
+
+/**
+ * 브랜치 프리스텝 (FR-16) — loop.js 를 얇게 유지하려 여기 둔다.
+ * 분기했으면 브랜치명을, 아니면 null 을 돌려준다.
+ */
+export async function branchPreStep({ brancher, cwd, branch, goal, protectedBranches, logger }) {
+  if (branch == null) return null;
+  const res = await brancher({
+    cwd,
+    name: typeof branch === 'string' ? branch : null,
+    goal,
+    protectedBranches,
+    logger,
+  });
+  return res.branched ? res.branch : null;
+}
+
+/**
+ * 주입 가능한 커밋 포트 (NFR-3). 메시지가 없으면 goal 로 만든다. 비-git·변경없음이면 조용히 skip.
+ * 반환: `{ committed, sha, message, reason }`.
+ */
+export function makeCommitter() {
+  return async ({ cwd, message = null, goal, styleConfig = 'match-log', logger = () => {} }) => {
+    if (!(await isGitRepo(cwd))) return { committed: false, reason: 'non-git' };
+    const msg = (typeof message === 'string' && message.trim())
+      ? message.trim()
+      : await buildCommitMessage({ goal, styleConfig, cwd });
+    const r = await commitAll(cwd, msg);
+    if (!r.ok) {
+      logger(`[hi-loop] · 커밋 skip — ${r.reason}`);
+      return { committed: false, message: msg, reason: r.reason };
+    }
+    logger(`[hi-loop] ✅ 커밋 ${r.sha?.slice(0, 8)} — ${msg}`);
+    return { committed: true, sha: r.sha, message: msg };
+  };
+}