@capstone-nomos/cli 0.1.13 → 0.1.15

package/dist/bridge/briefing-notes.js

@@ -3,29 +3,48 @@ import path from 'node:path';
 // 브리핑으로 프롬프트에 넣은 인계 노트의 id. 제출할 때 "이미 받은 노트"로 서버에 함께 보낸다.
 // 서버는 관련 노트를 전부 확인해야 제출을 받는다(NOTES_UNACKNOWLEDGED). 프롬프트로 전달된 노트는 확인한 것이므로
 // 모델이 id를 옮겨 적게 하지 않고 브릿지가 넣는다 — 모델이 직접 넣는 건 반려 뒤 새로 받은 노트뿐이다.
+// 질문으로 정해진 결정(decisions)도 같다 — 브리핑으로 받은 결정 id를 함께 남기고 제출 때 보낸다(DECISIONS_UNACKNOWLEDGED).
 // Executor가 작업공간에 쓰고(브리핑 직후), MCP 서버의 submit_artifact가 읽는다. 둘은 다른 프로세스다.
 export const BRIEFING_NOTES_FILE = '.nomos-briefing.json';
-export function writeBriefingNotes(workspaceDir, taskId, noteIds) {
-    writeFileSync(path.join(workspaceDir, BRIEFING_NOTES_FILE), `${JSON.stringify({ taskId, noteIds }, null, 2)}\n`);
+export function writeBriefingNotes(workspaceDir, taskId, noteIds, decisionIds = []) {
+    writeFileSync(path.join(workspaceDir, BRIEFING_NOTES_FILE), `${JSON.stringify({ taskId, noteIds, decisionIds }, null, 2)}\n`);
 }
-// 다른 태스크의 파일이거나 없으면 빈 목록 — 엉뚱한 태스크의 노트를 확인한 것으로 보내지 않는다.
-export function readBriefingNoteIds(workspaceDir, taskId) {
+// 다른 태스크의 파일이거나 없으면 빈 목록 — 엉뚱한 태스크의 노트·결정을 확인한 것으로 보내지 않는다.
+function readBriefingIds(workspaceDir, taskId, key) {
     const file = path.join(workspaceDir, BRIEFING_NOTES_FILE);
     if (!existsSync(file))
         return [];
     try {
         const parsed = JSON.parse(readFileSync(file, 'utf-8'));
-        if (parsed.taskId !== taskId || !Array.isArray(parsed.noteIds))
+        const ids = parsed[key];
+        if (parsed.taskId !== taskId || !Array.isArray(ids))
             return [];
-        return parsed.noteIds.filter((id) => typeof id === 'string');
+        return ids.filter((id) => typeof id === 'string');
     }
     catch {
         return [];
     }
 }
+export function readBriefingNoteIds(workspaceDir, taskId) {
+    return readBriefingIds(workspaceDir, taskId, 'noteIds');
+}
+export function readBriefingDecisionIds(workspaceDir, taskId) {
+    return readBriefingIds(workspaceDir, taskId, 'decisionIds');
+}
 export function mergeAcknowledged(briefed, fromModel) {
     return [...new Set([...briefed, ...(fromModel ?? [])])].sort();
 }
+// submit_artifact가 서버에 보내는 본문. 브리핑으로 받은 노트·결정과 모델이 반려 뒤 확인한 것을 합친다.
+// acknowledgedDecisionIds는 비어 있어도 **항상** 보낸다 — 서버는 이 필드가 없으면 옛 CLI(0.1.14 이하)로 보고 결정 확인을 건너뛴다.
+export function buildSubmitBody(input) {
+    const acknowledgedNoteIds = mergeAcknowledged(readBriefingNoteIds(input.workspaceDir, input.taskId), input.acknowledgedNoteIds);
+    return {
+        commitSha: input.commitSha,
+        changedPaths: input.changedPaths,
+        ...(acknowledgedNoteIds.length === 0 ? {} : { acknowledgedNoteIds }),
+        acknowledgedDecisionIds: mergeAcknowledged(readBriefingDecisionIds(input.workspaceDir, input.taskId), input.acknowledgedDecisionIds),
+    };
+}
 // 지금 작업공간의 태스크 id — 권한 도구가 AskUserQuestion을 어느 태스크의 질문으로 올릴지 정한다. 없으면 null.
 export function readBriefingTaskId(workspaceDir) {
     const file = path.join(workspaceDir, BRIEFING_NOTES_FILE);

package/dist/bridge/mcp-server.js

@@ -7,7 +7,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { z } from 'zod';
 import { readCredentials, updateAccessToken } from './credentials.js';
 import { NomosClient, PolicyStaleLoopError } from './nomos-client.js';
-import { mergeAcknowledged, readBriefingNoteIds, readBriefingTaskId } from './briefing-notes.js';
+import { buildSubmitBody, readBriefingTaskId } from './briefing-notes.js';
 import { PERMISSION_TOOL } from './claude-args.js';
 import { DENY_OTHER, denyUnanswered, handleAskUserQuestion, isHandled } from './permission.js';
 import { pushTaskBranch } from './push.js';
@@ -72,7 +72,7 @@ server.registerTool('claim_task', {
 const workspaceDir = process.env.NOMOS_WORKSPACE_DIR ?? process.cwd();
 server.registerTool('submit_artifact', {
     title: 'Submit an artifact',
-    description: 'Submit finished work for a task you have claimed. Commit your work on the task branch first, then provide the latest commit sha and every path changed on the task branch (including commits from earlier attempts on this branch). This tool pushes the task branch before submitting; if the push is refused (wrong branch, commit not on the task branch, remote has diverged) nothing is submitted and you get the reason. The server re-checks the paths against the ownership rules, so listing paths you did not change (or omitting ones you did) will be rejected or will fail verification later. If handover notes related to your task were published after you started, the submission is rejected with NOTES_UNACKNOWLEDGED and the notes are returned: read them, change and commit your work if they affect it, then submit again with their ids in acknowledged_note_ids. Notes that were already in your instructions are acknowledged automatically.',
+    description: 'Submit finished work for a task you have claimed. Commit your work on the task branch first, then provide the latest commit sha and every path changed on the task branch (including commits from earlier attempts on this branch). This tool pushes the task branch before submitting; if the push is refused (wrong branch, commit not on the task branch, remote has diverged) nothing is submitted and you get the reason. The server re-checks the paths against the ownership rules, so listing paths you did not change (or omitting ones you did) will be rejected or will fail verification later. If handover notes related to your task were published after you started, the submission is rejected with NOTES_UNACKNOWLEDGED and the notes are returned: read them, change and commit your work if they affect it, then submit again with their ids in acknowledged_note_ids. Notes that were already in your instructions are acknowledged automatically. Likewise, if decisions were made by answering other tasks\' questions after you started, the submission is rejected with DECISIONS_UNACKNOWLEDGED and the decisions are returned (with any new related notes): follow them, change and commit your work if it differs, then submit again with their ids in acknowledged_decision_ids (and the notes\' ids in acknowledged_note_ids). Decisions already in your instructions are acknowledged automatically.',
     inputSchema: {
         task_id: z.string().describe('The claimed task id'),
         commit_sha: z.string().describe('Commit sha containing the work'),
@@ -81,8 +81,12 @@ server.registerTool('submit_artifact', {
             .array(z.string())
             .optional()
             .describe('Ids of handover notes you read after a NOTES_UNACKNOWLEDGED rejection'),
+        acknowledged_decision_ids: z
+            .array(z.string())
+            .optional()
+            .describe('Ids of decisions you read after a DECISIONS_UNACKNOWLEDGED rejection'),
     },
-}, async ({ task_id, commit_sha, changed_paths, acknowledged_note_ids }) => run(async () => {
+}, async ({ task_id, commit_sha, changed_paths, acknowledged_note_ids, acknowledged_decision_ids }) => run(async () => {
     // push할 브랜치와 막을 브랜치는 서버가 정한다. 모델이 넘긴 값으로 고르지 않는다.
     const briefing = (await client.getBriefing(task_id));
     const push = await pushTaskBranch({
@@ -95,13 +99,15 @@ server.registerTool('submit_artifact', {
         process.stderr.write('[nomos-mcp] origin 없음 — push 건너뜀(서버가 mirror 모드로 로컬에서 읽는다)\n');
     }
     // push가 실패하면(PushRefused) 여기까지 오지 않는다 — 제출하지 않고 run()이 모델에게 사유를 돌려준다.
-    // 브리핑으로 프롬프트에 들어간 노트는 이미 받은 것이다 — Executor가 작업공간에 남긴 id를 함께 보낸다.
-    const acknowledgedNoteIds = mergeAcknowledged(readBriefingNoteIds(workspaceDir, task_id), acknowledged_note_ids);
-    const artifact = await client.submitArtifact(task_id, {
+    // 브리핑으로 프롬프트에 들어간 노트·결정은 이미 받은 것이다 — Executor가 작업공간에 남긴 id를 함께 보낸다.
+    const artifact = await client.submitArtifact(task_id, buildSubmitBody({
+        workspaceDir,
+        taskId: task_id,
         commitSha: commit_sha,
         changedPaths: changed_paths,
-        ...(acknowledgedNoteIds.length === 0 ? {} : { acknowledgedNoteIds }),
-    });
+        ...(acknowledged_note_ids === undefined ? {} : { acknowledgedNoteIds: acknowledged_note_ids }),
+        ...(acknowledged_decision_ids === undefined ? {} : { acknowledgedDecisionIds: acknowledged_decision_ids }),
+    }));
     return { ...artifact, push };
 }, 'submit_artifact'));
 server.registerTool('publish_note', {

package/dist/bridge/nomos-client.js

@@ -44,7 +44,9 @@ export class NomosClient {
     async claimTask(taskId) {
         return (await this.request('POST', `/api/tasks/${taskId}/claim`));
     }
-    async submitArtifact(taskId, input) {
+    async submitArtifact(taskId, 
+    // acknowledgedDecisionIds: MCP submit_artifact는 비어 있어도 항상 보낸다(없으면 서버가 옛 CLI로 보고 결정 확인을 건너뛴다).
+    input) {
         return (await this.request('POST', `/api/tasks/${taskId}/artifacts`, input));
     }
     // 브릿지 단계(V2·V4) 보고. 서버가 판정하는 V1A·V1B·V3는 여기로 보낼 수 없다 — 403이 돌아온다.

package/dist/executor/background.js

@@ -0,0 +1,91 @@
+import { spawn } from 'node:child_process';
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { nomosHome } from '../bridge/credentials.js';
+export function daemonFile() {
+    return path.join(nomosHome(), 'daemon.json');
+}
+export function logDir() {
+    return path.join(nomosHome(), 'logs');
+}
+export function readDaemon() {
+    try {
+        return JSON.parse(readFileSync(daemonFile(), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+// 그 pid의 프로세스가 살아 있는가(신호 0은 확인만 한다).
+export function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+// 살아 있는 백그라운드 connect. 죽었는데 파일만 남았으면 지우고 null.
+export function runningDaemon() {
+    const info = readDaemon();
+    if (!info)
+        return null;
+    if (isAlive(info.pid))
+        return info;
+    rmSync(daemonFile(), { force: true });
+    return null;
+}
+// --background를 뺀 같은 인자로 connect를 분리된 자식으로 띄운다. 이 프로세스는 바로 끝나도 자식은 계속 돈다.
+export function startDaemon(input) {
+    const existing = runningDaemon();
+    if (existing)
+        throw new Error(`이미 백그라운드에서 돌고 있다(pid ${existing.pid}, 서버 ${existing.server}). 끄려면 nomos stop`);
+    mkdirSync(logDir(), { recursive: true });
+    const logFile = path.join(logDir(), 'connect.log');
+    const fd = openSync(logFile, 'a');
+    const args = input.args.filter((a) => a !== '--background');
+    const child = spawn(process.execPath, [input.cliPath, 'connect', ...args], {
+        detached: true,
+        stdio: ['ignore', fd, fd],
+        windowsHide: true,
+        env: { ...process.env, NOMOS_BACKGROUND: '1' },
+    });
+    closeSync(fd);
+    if (child.pid === undefined)
+        throw new Error('백그라운드 프로세스를 띄우지 못했다');
+    child.unref();
+    const info = { pid: child.pid, startedAt: new Date().toISOString(), server: input.server, logFile, args };
+    mkdirSync(nomosHome(), { recursive: true });
+    writeFileSync(daemonFile(), JSON.stringify(info, null, 2), { mode: 0o600 });
+    return info;
+}
+export function stopDaemon() {
+    const info = runningDaemon();
+    if (!info)
+        return null;
+    try {
+        process.kill(info.pid);
+    }
+    catch {
+        // 이미 끝났다.
+    }
+    rmSync(daemonFile(), { force: true });
+    return info;
+}
+// 로그 끝부분(최대 n줄). 파일이 크면 끝 64KB만 읽는다.
+export function tailLog(file, lines = 15) {
+    if (!existsSync(file))
+        return [];
+    const size = statSync(file).size;
+    const start = Math.max(0, size - 64 * 1024);
+    const fd = openSync(file, 'r');
+    try {
+        const buf = Buffer.alloc(size - start);
+        readSync(fd, buf, 0, buf.length, start);
+        return buf.toString('utf-8').split(/\r?\n/).filter(Boolean).slice(-lines);
+    }
+    finally {
+        closeSync(fd);
+    }
+}

package/dist/executor/cli.js

@@ -27,6 +27,7 @@ import { credentialsPath, readCredentials, updateAccessToken, writeCredentials,
 import { NomosApiError, NomosClient } from '../bridge/nomos-client.js';
 import { ActivityReporter, ActivityTracker, RunObserver } from './activity.js';
 import { accountLine, connect, DEFAULT_SERVER, serverCalls } from './connect.js';
+import { runningDaemon, startDaemon, stopDaemon, tailLog } from './background.js';
 import { deviceLogin } from './device-login.js';
 import { cliVersion, mcpServerPath } from './paths.js';
 import { checkTools } from './preflight.js';
@@ -189,8 +190,8 @@ async function handleTask(client, projectId, task) {
     });
     log(`작업공간 ${workspace.dir} (브랜치 ${workspace.branch})`);
     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));
+    // 프롬프트에 넣는 노트·결정 = 제출 때 "받은 것"으로 함께 보낼 노트·결정. MCP 서버(submit_artifact)가 읽는다.
+    writeBriefingNotes(workspace.dir, task.id, (briefing.notes ?? []).map((n) => n.id), (briefing.decisions ?? []).map((d) => d.id));
     if (workspace.createdBranch) {
         await client.reportBranch(task.id, workspace.branch);
     }
@@ -400,7 +401,7 @@ async function postJson(url, body) {
     return json.data;
 }
 function parseArgs(argv) {
-    const out = { positional: undefined, server: undefined, name: undefined, code: undefined, connectKey: false, json: false };
+    const out = { positional: undefined, server: undefined, name: undefined, code: undefined, connectKey: false, json: false, background: false };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
         if (arg === '--name')
@@ -411,6 +412,8 @@ function parseArgs(argv) {
             out.connectKey = true;
         else if (arg === '--code')
             out.code = argv[(i += 1)];
+        else if (arg === '--background')
+            out.background = true;
         else if (arg === '--json')
             out.json = true;
         else
@@ -490,6 +493,19 @@ async function connectCommand(argv) {
             log(`${t.name}을 실행할 수 없다: ${t.detail}\n        → ${t.hint}`);
         throw new Error('필요한 도구가 없어 시작하지 않는다');
     }
+    // 백그라운드(창 없이) — 같은 인자로 connect를 분리된 자식으로 띄우고 여기서 끝난다. 브라우저 승인 로그인은 화면이 필요하므로
+    // 이 서버의 자격 증명이 없으면 --code(1회용 연결 코드)와 함께만 받는다.
+    if (args.background) {
+        const saved = readCredentials();
+        if (!args.code && (!saved || saved.baseUrl !== server)) {
+            throw new Error('백그라운드로 띄우려면 먼저 한 번 connect로 로그인하거나, 웹의 연결 명령(--code)에 --background를 붙여라');
+        }
+        const info = startDaemon({ cliPath: process.argv[1], args: argv, server });
+        log(`백그라운드에서 실행한다 — pid ${info.pid}. 창을 닫아도 계속 돈다`);
+        log(`로그: ${info.logFile}`);
+        log('상태: nomos status · 끄기: nomos stop · 진행 상황은 웹의 룸에서 본다');
+        return;
+    }
     // 배정이 풀리면(해제·프로젝트 중단) 창을 닫지 않고 다시 배정을 기다린다. 연결 해제면 멈춘다.
     // 1회용 코드는 처음 한 번만 쓴다 — 그 뒤로는 그 코드로 받은 자격 증명이 저장돼 있다.
     let code = args.code?.trim() || undefined;
@@ -575,6 +591,17 @@ async function pmWorker() {
         await new Promise((resolve) => setTimeout(resolve, PM_POLL_INTERVAL_MS));
     }
 }
+function daemonStatus() {
+    const info = runningDaemon();
+    if (!info) {
+        log('백그라운드에서 돌고 있는 connect가 없다 (켜려면 connect --background)');
+        return;
+    }
+    log(`실행 중 — pid ${info.pid}, ${info.startedAt}부터, 서버 ${info.server}`);
+    log(`로그: ${info.logFile}`);
+    for (const line of tailLog(info.logFile))
+        process.stdout.write(`  ${line}\n`);
+}
 async function main() {
     const command = process.argv[2];
     if (command === 'connect')
@@ -587,6 +614,13 @@ async function main() {
     }
     if (command === 'login')
         return login(process.argv.slice(3));
+    if (command === 'status')
+        return daemonStatus();
+    if (command === 'stop') {
+        const stopped = stopDaemon();
+        log(stopped ? `백그라운드 connect를 껐다(pid ${stopped.pid})` : '백그라운드에서 돌고 있는 connect가 없다');
+        return;
+    }
     if (command === 'refresh')
         return refresh();
     if (command === 'once')
@@ -604,7 +638,8 @@ async function main() {
     }
     process.stderr.write([
         '사용법: nomos <명령>',
-        '  connect [--code 코드] [--server 주소] [--name 이름]  로그인 → 배정 대기 → 작업 시작 (--code: 웹이 준 1회용 코드, 그 계정으로 연결)',
+        '  connect [--code 코드] [--server 주소] [--name 이름] [--background]  로그인 → 배정 대기 → 작업 시작 (--code: 웹이 준 1회용 코드, --background: 창 없이)',
+        '  status | stop                                백그라운드 connect 상태 보기 · 끄기',
         '  doctor                                       설치 상태 점검',
         '  login [주소] [--name 이름] [--connect-key]   로그인만',
         '  refresh | once | start | clean | --version',

package/dist/executor/prompt.js

@@ -42,6 +42,24 @@ export function buildTaskPrompt(briefing, branch, environment) {
             '이 브랜치에 이전 작업이 남아 있으면 이어서 진행한다. 같은 질문을 다시 묻지 않는다.',
         ].join('\n'));
     }
+    // 다른 역할·PM이 질문에 답해 확정한 결정 — 이 태스크가 물은 것이 아니어도 프로젝트 전체가 따른다.
+    // 실행 중에는 끼워 넣지 않는다. 작업 중에 새로 정해진 결정은 제출 때 DECISIONS_UNACKNOWLEDGED로 온다.
+    if (briefing.decisions && briefing.decisions.length > 0) {
+        sections.push([
+            '# 질문으로 정해진 결정',
+            '다른 역할·PM이 질문에 답해 확정한 결정이다. 구현이 이 결정과 다르면 결정을 따른다.',
+            '결정 자체가 틀렸거나 바꿔야 한다고 보면 임의로 바꾸지 말고 AskUserQuestion으로 그 역할에 다시 묻는다.',
+            ...briefing.decisions.map((d) => `- [물은 쪽 ${d.askerRole} · 정한 쪽 ${d.targetRole}${d.decidedByName ? ` ${d.decidedByName}` : ''}] Q: ${d.question}\n  A: ${d.answer ?? ''}`),
+        ].join('\n'));
+    }
+    // 사람(그 역할 담당·대표)이 룸에서 보낸 메시지 — 이번 실행이 시작되기 전에 온 것만 들어온다(실행 중에는 끼워 넣지 않는다).
+    if (briefing.humanMessages && briefing.humanMessages.length > 0) {
+        sections.push([
+            '# 담당자가 보낸 메시지 (팀의 사람이 이 역할 에이전트에게 남긴 지시 — 오래된 것부터)',
+            ...briefing.humanMessages.map((m) => `- ${m.fromNickname ?? '팀원'}${m.fromRepresentative ? '(대표)' : ''}: ${m.text}`),
+            '태스크 범위 안에서 반영한다. 수정할 수 있는 경로·금지 규칙은 메시지와 상관없이 그대로다 — 따를 수 없으면 이유를 마지막 메시지에 적는다.',
+        ].join('\n'));
+    }
     if (briefing.notesBlock) {
         sections.push(briefing.notesBlock);
     }
@@ -59,6 +77,7 @@ export function buildTaskPrompt(briefing, branch, environment) {
         '  바꾸지 않은 경로를 적거나 sha를 지어내지 않는다 — 서버가 제출 시점에 다시 검증한다.',
         '- 제출이 NOTES_UNACKNOWLEDGED로 반려되면, 작업 중에 새로 올라온 인계 노트가 함께 온다. 읽고, 작업에 영향이 있으면 고쳐서 커밋한 뒤',
         '  submit_artifact를 다시 부르며 그 노트 id를 acknowledged_note_ids에 넣는다. 위 [인계 노트]의 노트는 따로 넣지 않아도 된다.',
+        '- 제출이 DECISIONS_UNACKNOWLEDGED로 반려되면, 작업 중에 새로 정해진 결정이 함께 온다. 반영하고 그 id를 acknowledged_decision_ids에 넣어 다시 제출하라(함께 온 노트가 있으면 그 id는 acknowledged_note_ids에).',
         '- 다음 사람이 알아야 할 결정이나 함정이 있으면 publish_note로 남긴다. 다른 사람도 따라야 할 결정(계약·형식)은 DECIDED로 남긴다 — 프로젝트 전체에 전달된다.',
         // 실험(E6): 이 줄이 없으면 FE 에이전트가 명세에 없는 BE 계약을 스스로 정해 DECIDED로 발행했다 — 그 노트가 BE 브리핑에 "결정"으로 들어간다.
         `- 단, 다른 역할이 정해야 하는 계약(그 역할이 만드는 API의 응답 형식·상태 코드·필드 이름 등)은 DECIDED로 남기지 않는다 — 네 역할(${task.teamRole ?? '제한 없음'})이 정할 수 있는 것이 아니다.`,

package/package.json

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