@capstone-nomos/cli 0.1.19 → 0.1.20

package/dist/bridge/credentials.js

@@ -1,4 +1,4 @@
-import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 // NOMOS의 로컬 상태(자격 증명·작업공간·레포)를 두는 곳. 기본 ~/.nomos.
@@ -26,7 +26,18 @@ export function readCredentials() {
 export function writeCredentials(credentials) {
     mkdirSync(credentialsDir(), { recursive: true, mode: 0o700 });
     const file = credentialsPath();
-    writeFileSync(file, `${JSON.stringify(credentials, null, 2)}\n`, { mode: 0o600 });
+    // 임시 파일에 다 쓴 뒤 이름을 바꾼다 — 읽는 쪽이 반쯤 쓰인 파일을 보지 않게(토큰 재발급마다 쓴다).
+    // 같은 NOMOS_HOME을 두 프로세스가 쓰다 "Unexpected end of JSON input"으로 죽은 일이 있었다(운영 실험) — 공유 자체는 executor/home-lock.ts가 막는다.
+    const tmp = `${file}.${process.pid}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify(credentials, null, 2)}\n`, { mode: 0o600 });
+    try {
+        renameSync(tmp, file);
+    }
+    catch {
+        // Windows에서 다른 프로세스가 그 순간 파일을 열고 있으면 바꾸기가 거부될 수 있다 — 직접 쓴다.
+        writeFileSync(file, readFileSync(tmp), { mode: 0o600 });
+        rmSync(tmp, { force: true });
+    }
     try {
         chmodSync(file, 0o600);
     }

package/dist/executor/cli.js

@@ -33,6 +33,7 @@ import { deviceLogin } from './device-login.js';
 import { cliVersion, mcpServerPath } from './paths.js';
 import { checkTools } from './preflight.js';
 import { handleNextPmJob } from './pm-worker.js';
+import { acquireHomeLock } from './home-lock.js';
 import { buildTaskPrompt } from './prompt.js';
 import { DEFAULT_IDLE_MS, runClaude } from './runner.js';
 import { streamTaskSource } from './stream-source.js';
@@ -41,7 +42,7 @@ import { runLint, runSpecTests } from './verify.js';
 import { ensureRepo } from './repo-checkout.js';
 import { runConsult } from './consult.js';
 import { runContractBatch, runContractDraft } from './contract.js';
-import { cleanWorkspaces, headSha, prepareWorkspace } from './workspace.js';
+import { cleanWorkspaces, fetchCommit, headSha, mergePredecessors, prepareWorkspace } from './workspace.js';
 // 푸시가 오지 않아도 이 간격으로 한 번씩 다시 본다(끊겼을 때는 이 간격으로 폴링한다).
 const POLL_INTERVAL_MS = 10_000;
 function log(line) {
@@ -209,17 +210,35 @@ async function handleTask(client, projectId, task) {
     const briefing = (await client.getBriefing(task.id));
     // cloneUrl이 없는 옛 서버(브리핑에 필드 자체가 없음)도 github.com/{fullName}으로 받는다.
     const checkout = ensureRepo({ fullName: briefing.repo.fullName, cloneUrl: briefing.repo.cloneUrl ?? null }, { log });
+    // 서버가 만든 시작 기준점이 있으면 거기서 분기한다(선행 코드가 이미 합쳐져 있다). 받지 못하면 기본 브랜치에서 따고 선행을 직접 합친다.
+    const serverBase = briefing.base && fetchCommit(checkout.path, briefing.base.branchName, briefing.base.commitSha) ? briefing.base : null;
+    if (briefing.base && !serverBase)
+        log(`서버 기준점 ${briefing.base.branchName}을 받지 못했다 — 선행을 직접 합친다`);
     const workspace = prepareWorkspace({
         repoPath: checkout.path,
         projectId,
         taskId: task.id,
         branchName: briefing.task.branchName,
-        // CLI가 관리하는 클론은 방금 fetch한 origin/<기본 브랜치>에서 분기한다.
-        baseBranch: checkout.baseRef(briefing.repo.defaultBranch),
+        // CLI가 관리하는 클론은 방금 fetch한 origin/<기본 브랜치>에서 분기한다. 서버 기준점이 있으면 그 커밋에서.
+        baseBranch: serverBase?.commitSha ?? checkout.baseRef(briefing.repo.defaultBranch),
         settings: briefing.claudeSettings,
         policyHash: briefing.policyHash,
     });
     log(`작업공간 ${workspace.dir} (브랜치 ${workspace.branch})`);
+    // 선행 작업 위에서 시작한다 — 새로 딴 브랜치일 때만(이어 가는 브랜치에는 이미 들어 있다).
+    let predecessorMerge;
+    if (workspace.startedFresh && serverBase && (briefing.predecessors?.length ?? 0) > 0) {
+        // 서버가 이미 합쳤다 — 프롬프트에 "선행 코드가 들어 있다"만 알린다.
+        predecessorMerge = { merged: briefing.predecessors, failed: [] };
+        log(`  서버 기준점에서 시작: ${serverBase.branchName} (${serverBase.commitSha.slice(0, 12)}) — 선행 ${briefing.predecessors.length}개 포함`);
+    }
+    else if (workspace.startedFresh && (briefing.predecessors?.length ?? 0) > 0) {
+        predecessorMerge = mergePredecessors(workspace.dir, briefing.predecessors);
+        for (const p of predecessorMerge.merged)
+            log(`  선행 합침: ${p.title} (${p.commitSha.slice(0, 12)})`);
+        for (const f of predecessorMerge.failed)
+            log(`  선행 합치지 못함: ${f.predecessor.title} — ${f.reason}`);
+    }
     activeWorkspaces.set(task.id, { dir: workspace.dir, repo: briefing.repo.fullName });
     // 프롬프트에 넣는 노트·결정 = 제출 때 "받은 것"으로 함께 보낼 노트·결정. MCP 서버(submit_artifact)가 읽는다.
     writeBriefingNotes(workspace.dir, task.id, (briefing.notes ?? []).map((n) => n.id), (briefing.decisions ?? []).map((d) => d.id));
@@ -250,7 +269,7 @@ async function handleTask(client, projectId, task) {
     const before = headSha(workspace.dir);
     const result = await runClaude({
         workspaceDir: workspace.dir,
-        prompt: buildTaskPrompt(briefing, workspace.branch, { allowedCommands: ALLOWED_BASH_PREFIXES, setup: setup.steps }),
+        prompt: buildTaskPrompt({ ...briefing, predecessorMerge }, workspace.branch, { allowedCommands: ALLOWED_BASH_PREFIXES, setup: setup.steps }),
         mcpConfigPath,
         pathPrepend: setup.venvBin,
         // 질문 중계가 꺼진 프로젝트(또는 옛 서버)면 권한 도구를 붙이지 않는다 — AskUserQuestion이 없어진다.
@@ -337,6 +356,7 @@ async function reportBridgeStages(client, taskId, workspaceDir, specTests) {
     }
 }
 async function once() {
+    acquireHomeLock('once');
     const client = createClient();
     const self = await client.describeSelf();
     const source = pollingTaskSource(client);
@@ -349,6 +369,7 @@ async function once() {
 }
 // 멈춘 이유를 돌려준다 — connect는 배정이 풀린 경우(해제·프로젝트 중단) 다시 배정을 기다린다.
 async function start() {
+    acquireHomeLock('start');
     const client = createClient();
     const self = await client.describeSelf();
     // 서버 푸시(웹소켓)로 받는다. 끊겨 있는 동안은 같은 목록을 HTTP로 읽는다.
@@ -524,6 +545,8 @@ async function loginWithCode(baseUrl, agentName, code) {
     log(`${credentialsPath()}에 저장했다. 내 계정이 아니면 바로 Ctrl+C로 멈추고 웹에서 이 에이전트를 연결 해제하라.`);
 }
 async function login(argv) {
+    // 돌고 있는 에이전트의 자격 증명을 덮어쓰지 않게 — 같은 폴더를 쓰는 프로세스가 있으면 멈춘다.
+    acquireHomeLock('login');
     const args = parseArgs(argv);
     const baseUrl = normalizeBaseUrl(args.positional ?? args.server);
     const previous = readCredentials();
@@ -557,6 +580,8 @@ async function connectCommand(argv) {
         log('상태: nomos status · 끄기: nomos stop · 진행 상황은 웹의 룸에서 본다');
         return;
     }
+    // 한 NOMOS_HOME = 한 에이전트(home-lock.ts). 백그라운드를 띄우는 부모는 바로 끝나므로 잡지 않고, 실제로 도는 자식이 여기서 잡는다.
+    acquireHomeLock('connect');
     // 배정이 풀리면(해제·프로젝트 중단) 창을 닫지 않고 다시 배정을 기다린다. 연결 해제면 멈춘다.
     // 1회용 코드는 처음 한 번만 쓴다 — 그 뒤로는 그 코드로 받은 자격 증명이 저장돼 있다.
     let code = args.code?.trim() || undefined;
@@ -627,6 +652,7 @@ async function refresh() {
 }
 const PM_POLL_INTERVAL_MS = 3_000;
 async function pmWorker() {
+    acquireHomeLock('pm-worker');
     const client = createClient();
     log('pm-worker 시작 — 대표가 PM에 계획을 요청하면 여기서 claude가 돈다 (Ctrl+C로 종료)');
     for (;;) {

package/dist/executor/home-lock.js

@@ -0,0 +1,39 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { nomosHome } from '../bridge/credentials.js';
+export function homeLockPath() {
+    return path.join(nomosHome(), 'agent.lock');
+}
+function alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // 권한이 없을 뿐 살아 있다.
+        return err.code === 'EPERM';
+    }
+}
+export function readHomeLock() {
+    try {
+        return JSON.parse(readFileSync(homeLockPath(), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+// 잡지 못하면 이유를 담아 던진다. 끝날 때 자동으로 놓는다.
+export function acquireHomeLock(command) {
+    const file = homeLockPath();
+    const held = existsSync(file) ? readHomeLock() : null;
+    if (held && held.pid !== process.pid && alive(held.pid)) {
+        throw new Error(`이 폴더(${nomosHome()})는 다른 nomos 프로세스(pid ${held.pid}, ${held.command}, ${held.startedAt}부터)가 쓰고 있다. ` +
+            '한 노트북에서 에이전트를 여럿 돌리려면 창마다 NOMOS_HOME을 다르게 지정한다 — cmd: set NOMOS_HOME=%USERPROFILE%\.nomos-fe / PowerShell: $env:NOMOS_HOME="$HOME\.nomos-fe"');
+    }
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, `${JSON.stringify({ pid: process.pid, command, startedAt: new Date().toISOString() })}\n`);
+    process.once('exit', () => {
+        if (readHomeLock()?.pid === process.pid)
+            rmSync(file, { force: true });
+    });
+}

package/dist/executor/prompt.js

@@ -53,6 +53,24 @@ export function buildTaskPrompt(briefing, branch, environment) {
         ].join('\n'));
     }
     // 사람(그 역할 담당·대표)이 룸에서 보낸 메시지 — 이번 실행이 시작되기 전에 온 것만 들어온다(실행 중에는 끼워 넣지 않는다).
+    // 선행 작업 위에서 시작했다 — 선행이 만든 코드가 이미 이 브랜치에 있다. 못 합친 선행은 다시 만들지 말고 멈추게 한다
+    // (남의 작업을 지어내면 V3·리뷰에서 엉뚱한 diff가 된다 — 운영 실험의 BE도 그래서 멈췄다).
+    const pm = briefing.predecessorMerge;
+    if (pm && (pm.merged.length > 0 || pm.failed.length > 0)) {
+        sections.push([
+            '# 선행 작업 위에서 시작한다',
+            ...(pm.merged.length > 0
+                ? ['이 브랜치에 선행 태스크의 코드가 이미 합쳐져 있다 — 그 위에 이어서 구현한다(다시 만들지 않는다):', ...pm.merged.map((m) => `- ${m.title} (${m.commitSha.slice(0, 12)})`)]
+                : []),
+            ...(pm.failed.length > 0
+                ? [
+                    '합치지 못한 선행 태스크가 있다 — 그 코드는 이 브랜치에 없다:',
+                    ...pm.failed.map((f) => `- ${f.predecessor.title}: ${f.reason}`),
+                    '그 코드가 꼭 필요하면 직접 다시 만들지 말고, 커밋하지 말고 멈춘 뒤 마지막 메시지에 무엇이 없어서 막혔는지 적는다.',
+                ]
+                : []),
+        ].join('\n'));
+    }
     if (briefing.humanMessages && briefing.humanMessages.length > 0) {
         sections.push([
             '# 담당자가 보낸 메시지 (팀의 사람이 이 역할 에이전트에게 남긴 지시 — 오래된 것부터)',

package/dist/executor/workspace.js

@@ -46,6 +46,7 @@ export function prepareWorkspace(input) {
     const dir = workspaceDir(input.projectId, input.taskId);
     const branch = input.branchName ?? `task/${input.taskId}`;
     const existed = branchExists(input.repoPath, branch);
+    let startedFresh = false;
     excludeNomosFiles(input.repoPath);
     if (!existsSync(dir)) {
         mkdirSync(path.dirname(dir), { recursive: true });
@@ -57,6 +58,7 @@ export function prepareWorkspace(input) {
             : refExists(input.repoPath, remote)
                 ? ['worktree', 'add', '-b', branch, dir, `origin/${branch}`]
                 : ['worktree', 'add', '-b', branch, dir, input.baseBranch];
+        startedFresh = args.at(-1) === input.baseBranch;
         git(input.repoPath, args);
     }
     const claudeDir = path.join(dir, '.claude');
@@ -64,7 +66,58 @@ export function prepareWorkspace(input) {
     const settingsPath = path.join(claudeDir, 'settings.json');
     writeFileSync(settingsPath, `${JSON.stringify(input.settings, null, 2)}\n`);
     writeFileSync(path.join(claudeDir, '.nomos-policy.json'), `${JSON.stringify({ policyHash: input.policyHash, taskId: input.taskId, generatedAt: new Date().toISOString() }, null, 2)}\n`);
-    return { dir, branch, createdBranch: !existed, settingsPath };
+    return { dir, branch, createdBranch: !existed, startedFresh, settingsPath };
+}
+const SHA = /^[0-9a-f]{7,64}$/i;
+const BRANCH = /^[A-Za-z0-9._/-]+$/;
+// 원격 브랜치의 커밋을 이 레포로 받아 둔다(서버가 만든 시작 기준점, 선행 브랜치). 이미 있거나 받았으면 true.
+export function fetchCommit(repoPath, branchName, commitSha) {
+    if (!SHA.test(commitSha))
+        return false;
+    if (refExists(repoPath, `${commitSha}^{commit}`))
+        return true;
+    if (branchName && BRANCH.test(branchName) && !branchName.startsWith('-')) {
+        try {
+            execFileSync('git', ['fetch', '--quiet', 'origin', `refs/heads/${branchName}`], { cwd: repoPath, stdio: 'ignore' });
+        }
+        catch {
+            // origin이 없거나(로컬 레포) 브랜치가 없다.
+        }
+    }
+    return refExists(repoPath, `${commitSha}^{commit}`);
+}
+// 새로 딴 태스크 브랜치에 선행 커밋을 오래된 것부터 합친다(앞서면 빨리 감기, 아니면 병합 커밋). 모델이 아니라 Executor가 한다 —
+// 모델의 git은 merge·cherry-pick이 막혀 있다. 커밋이 없으면 선행 브랜치를 받아 온다. 충돌이나 실패는 되돌리고 건너뛴다 —
+// 실행을 막으면 태스크가 READY로 남아 같은 실패를 되풀이하므로, 프롬프트에 "합치지 못했다"를 적고 모델이 멈출지 판단하게 한다.
+// 서버의 V3는 같은 커밋들을 비교 기준으로 써서 선행의 파일을 이 태스크의 변경으로 세지 않는다.
+export function mergePredecessors(dir, predecessors) {
+    const result = { merged: [], failed: [] };
+    for (const p of predecessors) {
+        if (!SHA.test(p.commitSha)) {
+            result.failed.push({ predecessor: p, reason: '커밋 형식이 아니다' });
+            continue;
+        }
+        if (!fetchCommit(dir, p.branchName, p.commitSha)) {
+            result.failed.push({ predecessor: p, reason: `커밋 ${p.commitSha.slice(0, 12)}을 찾지 못했다(선행 브랜치 ${p.branchName ?? '?'}가 push되지 않았거나 지워졌다)` });
+            continue;
+        }
+        try {
+            execFileSync('git', ['merge', '--no-edit', '-m', `nomos: 선행 태스크 합침 — ${p.title.slice(0, 120)}`, p.commitSha], { cwd: dir, stdio: 'pipe' });
+            result.merged.push(p);
+        }
+        catch (err) {
+            try {
+                execFileSync('git', ['merge', '--abort'], { cwd: dir, stdio: 'ignore' });
+            }
+            catch {
+                // 병합이 시작되지도 않았다(신원 미설정 등) — 되돌릴 것이 없다.
+            }
+            // 충돌 안내(CONFLICT ...)는 stdout으로, 그 밖의 실패는 stderr로 나온다.
+            const stderr = `${String(err.stdout ?? '')}\n${String(err.stderr ?? '')}`.trim();
+            result.failed.push({ predecessor: p, reason: /conflict/i.test(stderr) ? '병합 충돌' : `병합 실패: ${stderr.split('\n')[0]?.slice(0, 200) ?? ''}` });
+        }
+    }
+    return result;
 }
 // Executor가 작업공간에 쓰는 파일(MCP 설정·실행 로그·브리핑 노트·정책 표시·settings.json)이 모델의 `git add`에 섞이지 않게 한다.
 // 커밋에 섞이면 신고 경로와 실제 diff가 어긋나 V3가 FAIL을 낸다. info/exclude는 레포 공통이라 모든 worktree에 걸린다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capstone-nomos/cli",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "NOMOS 에이전트 CLI — 노트북의 Claude Code를 NOMOS 서버에 연결하고 배정된 태스크를 실행한다",
   "type": "module",
   "bin": {