@capstone-nomos/cli 0.1.12 → 0.1.14

package/dist/bridge/mcp-server.js

@@ -125,6 +125,19 @@ server.registerTool('publish_note', {
     affects: affects ?? [],
     ...(supersedes === undefined ? {} : { supersedes }),
 }), 'publish_note'));
+server.registerTool('read_contracts', {
+    title: 'Read confirmed API contracts',
+    description: 'Read the confirmed API contracts (OpenAPI fragments) of the project — the backend owner confirmed these, and frontend and backend must follow them exactly. ' +
+        "The contract for your own task's feature is already in your prompt; use this when you need another feature's API (paths, request/response fields, error status codes).",
+    inputSchema: {
+        project_id: z.string().describe('Project id'),
+        feature_key: z.string().optional().describe('Only this feature (e.g. F-02)'),
+    },
+}, async ({ project_id, feature_key }) => run(async () => {
+    const { contracts } = await client.readContracts(project_id);
+    const picked = feature_key === undefined ? contracts : contracts.filter((c) => c.featureKey === feature_key);
+    return { contracts: picked.map((c) => ({ featureKey: c.featureKey, title: c.specTitle, summary: c.summary, openapiYaml: c.schemaYaml })) };
+}, 'read_contracts'));
 server.registerTool('read_notes', {
     title: 'Read handover notes',
     description: 'Read handover notes for the project. Notes relevant to your task are already in your prompt, so use this only when you need more — older notes, or notes for a different feature.',

package/dist/bridge/nomos-client.js

@@ -90,6 +90,10 @@ export class NomosClient {
     async submitDraft(questionId, draft) {
         return (await this.request('POST', `/api/questions/${questionId}/draft`, draft));
     }
+    // 확정한 API 계약(에이전트 — MCP read_contracts). FE가 연동할 API를 기능을 가리지 않고 찾는다.
+    async readContracts(projectId) {
+        return (await this.request('GET', `/api/projects/${projectId}/contracts`));
+    }
     // 계약 작성(Executor, 023): BACKEND 에이전트가 쓸 계약 작업·확정한 계약·읽을 레포, 그리고 초안 제출·실패 보고.
     async listContractJobs() {
         return (await this.request('GET', '/api/agents/me/contract-jobs'));

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';
@@ -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

@@ -15,12 +15,15 @@ export function buildTaskPrompt(briefing, branch, environment) {
     // 확정한 API 계약 — BE 담당이 확정했고 FE·BE가 같은 것을 받는다. 다르게 만들면 서로 붙지 않는다.
     if (briefing.contract) {
         sections.push([
-            `# 확정한 API 계약 (${briefing.contract.featureKey}) — 백엔드 담당이 확정했다. 경로·메서드·필드·상태 코드를 이대로 구현하거나 이대로 호출한다`,
+            task.teamRole === 'FRONTEND'
+                ? `# 확정한 API 계약 (${briefing.contract.featureKey}) — 백엔드 담당이 확정했다. 화면에서 이 경로·메서드로 호출하고, 응답 필드·에러 상태 코드를 이대로 처리한다(API 연동)`
+                : `# 확정한 API 계약 (${briefing.contract.featureKey}) — 백엔드 담당이 확정했다. 경로·메서드·필드·상태 코드를 이대로 구현한다`,
             briefing.contract.summary,
             '```yaml',
             briefing.contract.schemaYaml.trimEnd(),
             '```',
             '계약을 바꿔야 할 이유가 생기면 계약과 다르게 구현하지 말고, 그 사실을 GOTCHA 노트로 남긴다.',
+            '다른 기능의 API가 필요하면 read_contracts 도구로 확정한 계약을 찾는다.',
         ].join('\n'));
     }
     // 직전 제출이 반려됐다 — 같은 태스크 브랜치에 이전 작업이 남아 있으니 이어서 고친다.
@@ -39,6 +42,14 @@ export function buildTaskPrompt(briefing, branch, environment) {
             '이 브랜치에 이전 작업이 남아 있으면 이어서 진행한다. 같은 질문을 다시 묻지 않는다.',
         ].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);
     }

package/package.json

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