tycono 0.1.92 → 0.1.93-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tycono",
-  "version": "0.1.92",
+  "version": "0.1.93-beta.0",
   "description": "Build an AI company. Watch them work.",
   "type": "module",
   "bin": {

package/src/api/src/create-server.ts

@@ -20,8 +20,7 @@ import { handleExecRequest } from './routes/execute.js';
 import { engineRouter } from './routes/engine.js';
 import { sessionsRouter } from './routes/sessions.js';
 import { setupRouter } from './routes/setup.js';
-import { getAllActivities, completeActivity } from './services/activity-tracker.js';
-import { type RoleStatus, isRoleActive } from '../../shared/types.js';
+// activity-tracker removed — executionManager resets on restart
 import { knowledgeRouter } from './routes/knowledge.js';
 import { preferencesRouter } from './routes/preferences.js';
 import { saveRouter } from './routes/save.js';
@@ -43,21 +42,6 @@ const __dirname = path.dirname(__filename);
 const isProd = process.env.NODE_ENV === 'production';
 const corsOrigin = isProd ? true : /^http:\/\/localhost:\d+$/;
 
-/**
- * 서버 시작 시 stale "working" activity 파일을 정리한다.
- * tsx watch 모드에서 재시작 시 in-memory 상태가 초기화되어도
- * 파일이 "working"으로 남는 버그를 방지한다.
- */
-function cleanupStaleActivities(): void {
-  const activities = getAllActivities();
-  for (const activity of activities) {
-    if (isRoleActive(activity.status as RoleStatus)) {
-      completeActivity(activity.roleId);
-      console.log(`[STARTUP] Cleaned stale activity: ${activity.roleId} (was working on "${activity.currentTask}")`);
-    }
-  }
-}
-
 /* ─── Raw HTTP handler for import-knowledge SSE ─── */
 
 function handleImportKnowledge(req: http.IncomingMessage, res: http.ServerResponse): void {
@@ -109,7 +93,6 @@ function handleImportKnowledge(req: http.IncomingMessage, res: http.ServerRespon
 export function createHttpServer(): http.Server {
   // Only cleanup/ensure if a company is already initialized (avoid creating dirs in CWD)
   if (COMPANY_ROOT && fs.existsSync(path.join(COMPANY_ROOT, 'CLAUDE.md'))) {
-    cleanupStaleActivities();
     ensureClaudeMd(COMPANY_ROOT);
   }
 
@@ -133,6 +116,16 @@ export function createHttpServer(): http.Server {
       return;
     }
 
+    // D-014: POST /api/sessions/:id/message — delegate to execute handler for SSE streaming
+    const sessionMessageMatch = url.match(/^\/api\/sessions\/([^/]+)\/message$/);
+    if (sessionMessageMatch && method === 'POST') {
+      setExecCors(req, res);
+      // Rewrite URL to legacy format for handleExecRequest
+      req.url = `/api/exec/session/${sessionMessageMatch[1]}/message`;
+      handleExecRequest(req, res);
+      return;
+    }
+
     // SSE 엔드포인트: Express 우회하여 raw HTTP로 처리
     if ((url.startsWith('/api/exec/') || url.startsWith('/api/jobs') || url === '/api/waves/save' || url === '/api/setup/import-knowledge') && method === 'POST') {
       setExecCors(req, res);
@@ -144,8 +137,8 @@ export function createHttpServer(): http.Server {
       return;
     }
 
-    // CORS preflight for exec/jobs endpoints
-    if ((url.startsWith('/api/exec/') || url.startsWith('/api/jobs')) && method === 'OPTIONS') {
+    // CORS preflight for exec/jobs/sessions endpoints
+    if ((url.startsWith('/api/exec/') || url.startsWith('/api/jobs') || url.match(/^\/api\/sessions\/[^/]+\/message$/)) && method === 'OPTIONS') {
       setExecCors(req, res);
       res.setHeader('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
       res.setHeader('Access-Control-Allow-Headers', 'Content-Type');

package/src/api/src/engine/agent-loop.ts

@@ -24,7 +24,7 @@ export interface AgentConfig {
   visitedRoles?: Set<string>; // Circular dispatch detection
   abortSignal?: AbortSignal;  // Abort signal for cancellation
   teamStatus?: TeamStatus;    // Current team member statuses
-  jobId?: string;             // Job ID for token tracking
+  sessionId: string;          // D-014: Session ID for token tracking (required)
   model?: string;             // LLM model name for cost tracking
   tokenLedger?: TokenLedger;  // Token usage ledger (optional)
   attachments?: ImageAttachment[];  // Image attachments for vision
@@ -169,7 +169,7 @@ export async function runAgentLoop(config: AgentConfig): Promise<AgentResult> {
         depth: depth + 1,
         visitedRoles: new Set(visitedRoles), // Copy for parallel dispatch support
         abortSignal,
-        jobId: config.jobId,
+        sessionId: config.sessionId,
         model: config.model,
         tokenLedger: config.tokenLedger,
         onText: (text) => onText?.(`[${targetRoleId}] ${text}`),
@@ -210,7 +210,7 @@ export async function runAgentLoop(config: AgentConfig): Promise<AgentResult> {
         depth: depth + 1,
         visitedRoles: new Set(visitedRoles),
         abortSignal,
-        jobId: config.jobId,
+        sessionId: config.sessionId,
         model: config.model,
         tokenLedger: config.tokenLedger,
         onText: (text) => onText?.(`[consult:${targetRoleId}] ${text}`),
@@ -288,7 +288,7 @@ export async function runAgentLoop(config: AgentConfig): Promise<AgentResult> {
     // Record token usage
     config.tokenLedger?.record({
       ts: new Date().toISOString(),
-      jobId: config.jobId ?? 'unknown',
+      sessionId: config.sessionId,
       roleId,
       model: config.model ?? 'unknown',
       inputTokens: response.usage.inputTokens,
@@ -452,7 +452,7 @@ export async function runAgentLoop(config: AgentConfig): Promise<AgentResult> {
         totalOutput += supResponse.usage.outputTokens;
         config.tokenLedger?.record({
           ts: new Date().toISOString(),
-          jobId: config.jobId ?? 'unknown',
+          sessionId: config.sessionId,
           roleId,
           model: config.model ?? 'unknown',
           inputTokens: supResponse.usage.inputTokens,
@@ -532,7 +532,7 @@ export async function runAgentLoop(config: AgentConfig): Promise<AgentResult> {
           totalOutput += verifyResponse.usage.outputTokens;
           config.tokenLedger?.record({
             ts: new Date().toISOString(),
-            jobId: config.jobId ?? 'unknown',
+            sessionId: config.sessionId,
             roleId,
             model: config.model ?? 'unknown',
             inputTokens: verifyResponse.usage.inputTokens,
@@ -578,7 +578,7 @@ export async function runAgentLoop(config: AgentConfig): Promise<AgentResult> {
               totalOutput += summaryResponse.usage.outputTokens;
               config.tokenLedger?.record({
                 ts: new Date().toISOString(),
-                jobId: config.jobId ?? 'unknown',
+                sessionId: config.sessionId,
                 roleId,
                 model: config.model ?? 'unknown',
                 inputTokens: summaryResponse.usage.inputTokens,

package/src/api/src/engine/knowledge-gate.ts

@@ -26,7 +26,9 @@ export interface PostKnowledgingResult {
 export interface DecayReport {
   health: number;
   orphanDocs: string[];
+  staleDocs: string[];
   brokenLinks: Array<{ file: string; link: string }>;
+  suggestions: string[];
   totalDocs: number;
   linkedDocs: number;
 }
@@ -257,6 +259,7 @@ export function postKnowledgingCheck(
 export function detectDecay(companyRoot: string): DecayReport {
   const searchDirs = ['knowledge', 'architecture'];
   const orphanDocs: string[] = [];
+  const staleDocs: string[] = [];
   const brokenLinks: Array<{ file: string; link: string }> = [];
   let totalDocs = 0;
   let linkedDocs = 0;
@@ -282,10 +285,20 @@ export function detectDecay(companyRoot: string): DecayReport {
         linkedDocs++;
       }
 
-      // Check for broken links in the file
+      // Check for broken links and stale status in the file
       const filePath = path.join(dirPath, file);
       try {
         const content = fs.readFileSync(filePath, 'utf-8');
+
+        // Check for deprecated/stale status in frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (frontmatterMatch) {
+          const frontmatter = frontmatterMatch[1];
+          if (/status:\s*(deprecated|stale)/i.test(frontmatter)) {
+            staleDocs.push(path.join(dir, file));
+          }
+        }
+
         const linkRegex = /\[.*?\]\(\.\/(.*?\.md)\)/g;
         let match;
         while ((match = linkRegex.exec(content)) !== null) {
@@ -322,13 +335,30 @@ export function detectDecay(companyRoot: string): DecayReport {
   }
 
   const health = totalDocs > 0
-    ? Math.round(((totalDocs - orphanDocs.length - brokenLinks.length) / totalDocs) * 100)
+    ? Math.round(((totalDocs - orphanDocs.length - staleDocs.length - brokenLinks.length) / totalDocs) * 100)
     : 100;
 
+  // Build suggestions
+  const suggestions: string[] = [];
+  if (orphanDocs.length > 0) {
+    suggestions.push(`${orphanDocs.length}개의 고아 문서를 Hub에 등록하세요`);
+  }
+  if (staleDocs.length > 0) {
+    suggestions.push(`${staleDocs.length}개의 오래된 문서를 업데이트하거나 삭제하세요`);
+  }
+  if (brokenLinks.length > 0) {
+    suggestions.push(`${brokenLinks.length}개의 깨진 링크를 수정하세요`);
+  }
+  if (orphanDocs.length === 0 && staleDocs.length === 0 && brokenLinks.length === 0) {
+    suggestions.push('모든 문서가 건강합니다! 🎉');
+  }
+
   return {
     health: Math.max(0, Math.min(100, health)),
     orphanDocs,
+    staleDocs,
     brokenLinks,
+    suggestions,
     totalDocs,
     linkedDocs,
   };

package/src/api/src/engine/runners/claude-cli.ts

@@ -20,7 +20,8 @@ const DISPATCH_SCRIPT = `#!/usr/bin/env python3
 
 환경변수:
   DISPATCH_API_URL    — API 서버 URL (default: http://localhost:3001)
-  DISPATCH_PARENT_JOB — 부모 Job ID (자동 설정)
+  DISPATCH_PARENT_SESSION — 부모 Session ID (자동 설정)
+  DISPATCH_PARENT_JOB — (deprecated) 부모 Job ID, DISPATCH_PARENT_SESSION 사용
   DISPATCH_SOURCE_ROLE — 현재 Role ID (자동 설정)
 """
 import sys, os, json, time, urllib.request, urllib.error
@@ -40,7 +41,7 @@ def get_result(job_id, retries=3):
             for e in events:
                 if e['type'] == 'text':
                     text_parts.append(e['data'].get('text', ''))
-                elif e['type'] == 'job:error':
+                elif e['type'] in ('msg:error', 'job:error'):
                     text_parts.append('\\nERROR: ' + e['data'].get('message', ''))
             result = ''.join(text_parts)
             if result:
@@ -62,15 +63,15 @@ def get_status(job_id):
     return get_job_info(job_id).get('status', 'unknown')
 
 def start_job(role_id, task):
-    parent_job = os.environ.get('DISPATCH_PARENT_JOB', '')
+    parent_session = os.environ.get('DISPATCH_PARENT_SESSION', os.environ.get('DISPATCH_PARENT_JOB', ''))
     source_role = os.environ.get('DISPATCH_SOURCE_ROLE', 'ceo')
     body = json.dumps({
         'type': 'assign',
         'roleId': role_id,
         'task': task,
         'sourceRole': source_role,
-        'parentJobId': parent_job if parent_job else None,
-    }).encode()
+        'parentSessionId': parent_session if parent_session else None,
+        }).encode()
     req = urllib.request.Request(f'{api}/api/jobs', body, {'Content-Type': 'application/json'})
     resp = json.loads(urllib.request.urlopen(req, timeout=10).read())
     return resp['jobId']
@@ -164,7 +165,7 @@ def get_result(job_id, retries=3):
             for e in events:
                 if e['type'] == 'text':
                     text_parts.append(e['data'].get('text', ''))
-                elif e['type'] == 'job:error':
+                elif e['type'] in ('msg:error', 'job:error'):
                     text_parts.append('\\nERROR: ' + e['data'].get('message', ''))
             result = ''.join(text_parts)
             if result:
@@ -211,7 +212,7 @@ if len(sys.argv) < 3:
 
 role_id = sys.argv[1]
 question = ' '.join(sys.argv[2:])
-parent_job = os.environ.get('CONSULT_PARENT_JOB', os.environ.get('DISPATCH_PARENT_JOB', ''))
+parent_session = os.environ.get('CONSULT_PARENT_SESSION', os.environ.get('DISPATCH_PARENT_SESSION', os.environ.get('DISPATCH_PARENT_JOB', '')))
 source_role = os.environ.get('CONSULT_SOURCE_ROLE', os.environ.get('DISPATCH_SOURCE_ROLE', 'ceo'))
 
 # Start job (readOnly + consult type)
@@ -222,7 +223,7 @@ body = json.dumps({
     'task': task,
     'sourceRole': source_role,
     'readOnly': True,
-    'parentJobId': parent_job if parent_job else None,
+    'parentSessionId': parent_session if parent_session else None,
 }).encode()
 
 try:
@@ -344,9 +345,8 @@ export class ClaudeCliRunner implements ExecutionRunner {
     cleanEnv.DISPATCH_API_URL = `http://localhost:${apiPort}`;
     cleanEnv.DISPATCH_SOURCE_ROLE = roleId;
     cleanEnv.DISPATCH_SUBORDINATES = subordinates.join(', ');
-    if (config.jobId) {
-      cleanEnv.DISPATCH_PARENT_JOB = config.jobId;
-    }
+    cleanEnv.DISPATCH_PARENT_SESSION = config.sessionId;
+    cleanEnv.DISPATCH_PARENT_JOB = config.sessionId; // deprecated, kept for backward compat
     // dispatch 명령어 경로를 PATH에 추가하지 않고 절대 경로로 사용
     cleanEnv.DISPATCH_CMD = dispatchScript;
     cleanEnv.CONSULT_CMD = consultScript;
@@ -360,7 +360,7 @@ export class ClaudeCliRunner implements ExecutionRunner {
     // Inject repo paths so agents never confuse repos
     cleanEnv.TYCONO_CODE_ROOT = codeRoot;
     cleanEnv.TYCONO_AKB_ROOT = companyRoot;
-    console.log(`[Runner] Spawning claude -p: role=${roleId}, model=${modelName}, maxTurns=${maxTurns}, jobId=${config.jobId ?? 'none'}, cwd=${cwd}, subordinates=[${subordinates.join(',')}]`);
+    console.log(`[Runner] Spawning claude -p: role=${roleId}, model=${modelName}, maxTurns=${maxTurns}, sessionId=${config.sessionId}, cwd=${cwd}, subordinates=[${subordinates.join(',')}]`);
 
     const proc = spawn('claude', args, {
       cwd,
@@ -422,7 +422,7 @@ export class ClaudeCliRunner implements ExecutionRunner {
               addToolCall: (name, input) => {
                 toolCalls.push({ name, input });
                 // Dispatch detection removed — child jobs created by the Python
-                // dispatch bridge script via POST /api/jobs with parentJobId.
+                // dispatch bridge script via POST /api/jobs with parentSessionId.
                 // JobManager.startJob() now auto-emits dispatch:start on parent stream.
               },
               incrementTurn: () => { turnCount++; callbacks.onTurnComplete?.(turnCount); },
@@ -431,7 +431,7 @@ export class ClaudeCliRunner implements ExecutionRunner {
                 totalOutput += out;
                 tokenLedger.record({
                   ts: new Date().toISOString(),
-                  jobId: config.jobId ?? 'unknown',
+                  sessionId: config.sessionId,
                   roleId,
                   model: modelName,
                   inputTokens: input,
@@ -471,7 +471,7 @@ export class ClaudeCliRunner implements ExecutionRunner {
                 totalOutput += out;
                 tokenLedger.record({
                   ts: new Date().toISOString(),
-                  jobId: config.jobId ?? 'unknown',
+                  sessionId: config.sessionId,
                   roleId,
                   model: modelName,
                   inputTokens: input,

package/src/api/src/engine/runners/direct-api.ts

@@ -38,7 +38,7 @@ export class DirectApiRunner implements ExecutionRunner {
       codeRoot: config.codeRoot,
       llm: this.llm,
       abortSignal: abortController.signal,
-      jobId: config.jobId,
+      sessionId: config.sessionId,
       model: config.model,
       tokenLedger,
       attachments: config.attachments,

package/src/api/src/engine/runners/types.ts

@@ -35,7 +35,8 @@ export interface RunnerConfig {
   readOnly?: boolean;
   maxTurns?: number;
   model?: string;
-  jobId?: string;
+  /** D-014: Session ID for tracking (required — primary identifier for token ledger). */
+  sessionId: string;
   teamStatus?: TeamStatus;
   attachments?: ImageAttachment[];
   /** Selective dispatch scope — only these roles can be dispatched to */

package/src/api/src/routes/active-sessions.ts

@@ -2,29 +2,25 @@
  * active-sessions.ts — Active session visibility API
  *
  * Exposes session + port + worktree state for both UI and AI agents.
- * All sessions sharing the same tycono server origin can query this.
  */
 import { Router } from 'express';
 import { portRegistry } from '../services/port-registry.js';
-import { jobManager } from '../services/job-manager.js';
+import { executionManager } from '../services/execution-manager.js';
 
 export const activeSessionsRouter = Router();
 
 /**
  * GET /api/active-sessions
- * Returns all active sessions with port + worktree info.
- * Used by both the web UI and AI agents (curl).
  */
 activeSessionsRouter.get('/', (_req, res) => {
   const sessions = portRegistry.getAll();
 
-  // Enrich with job info where available
   const enriched = sessions.map(s => {
-    const job = jobManager.getJobInfo(s.sessionId);
+    const exec = executionManager.getActiveExecution(s.sessionId);
     return {
       ...s,
-      jobStatus: job?.status ?? null,
-      roleName: job?.roleId ?? s.roleId,
+      messageStatus: exec?.status ?? null,
+      roleName: exec?.roleId ?? s.roleId,
       alive: s.pid ? isAlive(s.pid) : null,
     };
   });
@@ -37,7 +33,6 @@ activeSessionsRouter.get('/', (_req, res) => {
 
 /**
  * GET /api/active-sessions/:id
- * Get detailed info for a specific session.
  */
 activeSessionsRouter.get('/:id', (req, res) => {
   const session = portRegistry.get(req.params.id);
@@ -46,20 +41,19 @@ activeSessionsRouter.get('/:id', (req, res) => {
     return;
   }
 
-  const job = jobManager.getJobInfo(session.sessionId);
+  const exec = executionManager.getActiveExecution(session.sessionId);
 
   res.json({
     ...session,
-    jobStatus: job?.status ?? null,
-    roleName: job?.roleId ?? session.roleId,
+    messageStatus: exec?.status ?? null,
+    roleName: exec?.roleId ?? session.roleId,
     alive: session.pid ? isAlive(session.pid) : null,
-    job: job ?? null,
+    execution: exec ? { id: exec.id, status: exec.status, roleId: exec.roleId, task: exec.task } : null,
   });
 });
 
 /**
  * DELETE /api/active-sessions/:id
- * Stop a session — release ports + clean up.
  */
 activeSessionsRouter.delete('/:id', (req, res) => {
   const sessionId = req.params.id;
@@ -70,10 +64,7 @@ activeSessionsRouter.delete('/:id', (req, res) => {
     return;
   }
 
-  // Try to abort the job if running
-  jobManager.abortJob(sessionId);
-
-  // Release ports
+  executionManager.abortSession(sessionId);
   portRegistry.release(sessionId);
 
   res.json({ ok: true, released: session.ports });
@@ -81,7 +72,6 @@ activeSessionsRouter.delete('/:id', (req, res) => {
 
 /**
  * POST /api/active-sessions/cleanup
- * Clean up all dead sessions (PID gone).
  */
 activeSessionsRouter.post('/cleanup', (_req, res) => {
   const result = portRegistry.cleanup();
@@ -98,7 +88,6 @@ activeSessionsRouter.post('/cleanup', (_req, res) => {
 
 /**
  * POST /api/active-sessions/register
- * Manually register a session (for external Claude Code sessions).
  */
 activeSessionsRouter.post('/register', async (req, res) => {
   const { sessionId, roleId, task, pid, worktreePath } = req.body;
@@ -108,7 +97,6 @@ activeSessionsRouter.post('/register', async (req, res) => {
     return;
   }
 
-  // Check if already registered
   const existing = portRegistry.get(sessionId);
   if (existing) {
     res.json({ ok: true, ports: existing.ports, existing: true });

package/src/api/src/routes/cost.ts

@@ -61,6 +61,7 @@ costRouter.get('/summary', (req: Request, res: Response, next: NextFunction) =>
 });
 
 /* ── W-T602: GET /api/cost/jobs/:jobId ───── */
+/* @deprecated D-014: use /api/cost/sessions/:sessionId */
 
 costRouter.get('/jobs/:jobId', (req: Request, res: Response, next: NextFunction) => {
   try {
@@ -96,3 +97,45 @@ costRouter.get('/jobs/:jobId', (req: Request, res: Response, next: NextFunction)
     next(err);
   }
 });
+
+/* ── D-014: GET /api/cost/sessions/:sessionId ───── */
+
+costRouter.get('/sessions/:sessionId', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const sessionId = req.params.sessionId as string;
+    const ledger = getTokenLedger(COMPANY_ROOT);
+
+    // D-014: Try sessionId field first, fall back to jobId for legacy entries
+    let summary = ledger.query({ sessionId });
+    if (summary.entries.length === 0) {
+      summary = ledger.query({ jobId: sessionId });
+    }
+
+    if (summary.entries.length === 0) {
+      res.status(404).json({ error: `No cost data found for session ${sessionId}` });
+      return;
+    }
+
+    let totalCostUsd = 0;
+    for (const entry of summary.entries) {
+      totalCostUsd += estimateCost(entry.inputTokens, entry.outputTokens, entry.model);
+    }
+
+    res.json({
+      sessionId,
+      totalInputTokens: summary.totalInput,
+      totalOutputTokens: summary.totalOutput,
+      totalCostUsd,
+      entries: summary.entries.map((e) => ({
+        ts: e.ts,
+        roleId: e.roleId,
+        model: e.model,
+        inputTokens: e.inputTokens,
+        outputTokens: e.outputTokens,
+        costUsd: estimateCost(e.inputTokens, e.outputTokens, e.model),
+      })),
+    });
+  } catch (err) {
+    next(err);
+  }
+});

package/src/api/src/routes/engine.ts

@@ -200,6 +200,7 @@ engineRouter.post('/ask/:roleId', async (req: Request, res: Response, next: Next
         orgTree,
         readOnly: true,
         maxTurns: 5,
+        sessionId: `ask-${Date.now()}`,
       },
       {},
     );