tycono-server 0.1.0-beta.0

package/src/api/src/routes/operations.ts

@@ -0,0 +1,309 @@
+import { Router, Request, Response, NextFunction } from 'express';
+import { readFile, listFiles, fileExists, COMPANY_ROOT } from '../services/file-reader.js';
+import { extractBoldKeyValues } from '../services/markdown-parser.js';
+import { ActivityStream } from '../services/activity-stream.js';
+import path from 'node:path';
+import fs from 'node:fs';
+import { type MessageStatus, isMessageActive } from '../../../shared/types.js';
+
+export const operationsRouter = Router();
+
+// --- Standups ---
+operationsRouter.get('/standups', (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    const files = listFiles('.tycono/standup');
+    const standups = files
+      .filter(f => f.endsWith('.md'))
+      .map(f => {
+        const date = path.basename(f, '.md');
+        const content = readFile(`.tycono/standup/${f}`);
+        return { date, content };
+      })
+      .sort((a, b) => b.date.localeCompare(a.date));
+
+    res.json(standups);
+  } catch (err) {
+    next(err);
+  }
+});
+
+operationsRouter.get('/standups/:date', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { date } = req.params;
+    const filePath = `.tycono/standup/${date}.md`;
+    if (!fileExists(filePath)) {
+      res.status(404).json({ error: `Standup not found: ${date}` });
+      return;
+    }
+    const content = readFile(filePath);
+    res.json({ date, content });
+  } catch (err) {
+    next(err);
+  }
+});
+
+// --- Waves (JSON-only) ---
+operationsRouter.get('/waves', (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    const files = listFiles('.tycono/waves', '*.json');
+    const waves = files
+      .map(f => {
+        const id = path.basename(f, '.json');
+        try {
+          const data = JSON.parse(readFile(`.tycono/waves/${f}`));
+          const roles = data.roles ?? [];
+          const hasRunning = roles.some((r: { status?: string }) => r.status && isMessageActive(r.status as MessageStatus));
+          return {
+            id,
+            timestamp: id,
+            directive: data.directive ?? '',
+            rolesCount: roles.length,
+            startedAt: data.startedAt ?? '',
+            ...(data.commit ? { commit: data.commit } : {}),
+            ...(hasRunning ? { hasRunning: true } : {}),
+            ...(data.sessionIds && data.sessionIds.length > 0 ? { sessionIds: data.sessionIds } : {}),
+          };
+        } catch {
+          return { id, timestamp: id, directive: '', rolesCount: 0, startedAt: '' };
+        }
+      })
+      .sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+
+    res.json(waves);
+  } catch (err) {
+    next(err);
+  }
+});
+
+operationsRouter.get('/waves/:id', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { id } = req.params;
+    const jsonPath = `.tycono/waves/${id}.json`;
+
+    if (!fileExists(jsonPath)) {
+      res.status(404).json({ error: `Wave not found: ${id}` });
+      return;
+    }
+
+    const data = JSON.parse(readFile(jsonPath));
+    res.json({ id, timestamp: id, replay: data });
+  } catch (err) {
+    next(err);
+  }
+});
+
+// PATCH /waves/:id — update wave metadata (e.g. commit info)
+operationsRouter.patch('/waves/:id', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { id } = req.params;
+    const jsonPath = `.tycono/waves/${id}.json`;
+
+    if (!fileExists(jsonPath)) {
+      res.status(404).json({ error: `Wave not found: ${id}` });
+      return;
+    }
+
+    const data = JSON.parse(readFile(jsonPath));
+    const { commitSha, commitMessage, committedAt } = req.body ?? {};
+    if (commitSha) {
+      data.commit = { sha: commitSha, message: commitMessage ?? '', committedAt: committedAt ?? new Date().toISOString() };
+    }
+    const absPath = path.resolve(COMPANY_ROOT, jsonPath);
+    fs.writeFileSync(absPath, JSON.stringify(data, null, 2), 'utf-8');
+    res.json({ ok: true });
+  } catch (err) {
+    next(err);
+  }
+});
+
+// --- Decisions ---
+operationsRouter.get('/decisions', (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    const files = listFiles('knowledge/decisions');
+    const decisions = files
+      .filter(f => f.endsWith('.md'))
+      .map(f => {
+        const id = path.basename(f, '.md');
+        const content = readFile(`knowledge/decisions/${f}`);
+        const firstLine = content.split('\n').find(l => l.startsWith('# '));
+        const title = firstLine ? firstLine.replace(/^#\s+/, '') : id;
+        const kv = extractBoldKeyValues(content);
+        const date = kv['날짜'] ?? kv['date'] ?? '';
+        return { id, title, date, content };
+      });
+
+    res.json(decisions);
+  } catch (err) {
+    next(err);
+  }
+});
+
+operationsRouter.put('/decisions/:id', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { id } = req.params;
+    const { content } = req.body ?? {};
+    if (typeof content !== 'string') {
+      res.status(400).json({ error: 'content (string) is required' });
+      return;
+    }
+    const filePath = `knowledge/decisions/${id}.md`;
+    const absPath = path.resolve(COMPANY_ROOT, filePath);
+    // Ensure parent directory exists
+    fs.mkdirSync(path.dirname(absPath), { recursive: true });
+    fs.writeFileSync(absPath, content, 'utf-8');
+    // Re-parse for response
+    const firstLine = content.split('\n').find(l => l.startsWith('# '));
+    const title = firstLine ? firstLine.replace(/^#\s+/, '') : id;
+    const kv = extractBoldKeyValues(content);
+    const date = kv['날짜'] ?? kv['date'] ?? '';
+    res.json({ id, title, date, content });
+  } catch (err) {
+    next(err);
+  }
+});
+
+operationsRouter.delete('/decisions/:id', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { id } = req.params;
+    const filePath = `knowledge/decisions/${id}.md`;
+    const absPath = path.resolve(COMPANY_ROOT, filePath);
+    if (!fs.existsSync(absPath)) {
+      res.status(404).json({ error: `Decision not found: ${id}` });
+      return;
+    }
+    fs.unlinkSync(absPath);
+    res.json({ ok: true });
+  } catch (err) {
+    next(err);
+  }
+});
+
+// --- Traces (AI-readable agent conversation debugging) ---
+
+/**
+ * GET /api/ops/traces/:jobId — Dump full trace for a job
+ * Returns all events including full prompt/response for the job
+ * and all child jobs in the trace chain.
+ *
+ * Query params:
+ *   ?chain=true  — include all jobs in the same trace (default: true)
+ *   ?type=trace  — filter to trace:response events (use ?type=prompt for prompt:assembled)
+ */
+operationsRouter.get('/traces/:jobId', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const jobId = String(req.params.jobId);
+    const includeChain = String(req.query.chain ?? 'true') !== 'false';
+    const typeFilter = String(req.query.type ?? '') || undefined;
+
+    // Read the target job's events
+    const events = ActivityStream.readAll(jobId);
+    if (events.length === 0) {
+      res.status(404).json({ error: `No activity stream found for job: ${jobId}` });
+      return;
+    }
+
+    // Extract traceId from the first event
+    const traceId = events[0]?.traceId ?? events.find(e => e.data?.traceId)?.data?.traceId as string ?? jobId;
+
+    if (!includeChain) {
+      const filtered = typeFilter
+        ? events.filter(e => e.type.startsWith(typeFilter))
+        : events;
+      res.json({ traceId, jobs: [{ jobId, events: filtered }] });
+      return;
+    }
+
+    // Find all jobs in the same trace
+    const allJobIds = ActivityStream.listAll();
+    const traceJobs: Array<{ jobId: string; roleId: string; events: typeof events }> = [];
+
+    for (const jid of allJobIds) {
+      const jobEvents = ActivityStream.readAll(jid);
+      const startEvent = jobEvents.find(e => e.type === 'msg:start' || (e.type as string) === 'job:start');
+      const jobTraceId = jobEvents[0]?.traceId ?? startEvent?.data?.traceId;
+
+      if (jobTraceId === traceId || jid === jobId) {
+        const filtered = typeFilter
+          ? jobEvents.filter(e => e.type.startsWith(typeFilter))
+          : jobEvents;
+        traceJobs.push({
+          jobId: jid,
+          roleId: startEvent?.roleId ?? 'unknown',
+          events: filtered,
+        });
+      }
+    }
+
+    // Sort by timestamp of first event
+    traceJobs.sort((a, b) => {
+      const aTs = a.events[0]?.ts ?? '';
+      const bTs = b.events[0]?.ts ?? '';
+      return aTs.localeCompare(bTs);
+    });
+
+    res.json({ traceId, jobCount: traceJobs.length, jobs: traceJobs });
+  } catch (err) {
+    next(err);
+  }
+});
+
+/**
+ * GET /api/ops/traces — List recent traces (grouped by traceId)
+ * Query params:
+ *   ?limit=20    — max traces to return
+ *   ?roleId=cto  — filter by role
+ */
+operationsRouter.get('/traces', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const limit = parseInt(String(req.query.limit ?? '20')) || 20;
+    const roleFilter = req.query.roleId ? String(req.query.roleId) : undefined;
+
+    const allJobIds = ActivityStream.listAll();
+    const traces = new Map<string, {
+      traceId: string;
+      startedAt: string;
+      rootRole: string;
+      rootTask: string;
+      jobCount: number;
+      status: string;
+    }>();
+
+    for (const jid of allJobIds) {
+      const events = ActivityStream.readAll(jid);
+      const startEvent = events.find(e => e.type === 'msg:start' || (e.type as string) === 'job:start');
+      if (!startEvent) continue;
+
+      const traceId = events[0]?.traceId ?? startEvent?.data?.traceId as string ?? jid;
+      if (roleFilter && startEvent.roleId !== roleFilter) continue;
+
+      if (!traces.has(traceId)) {
+        const doneEvent = events.find(e => e.type === 'msg:done' || (e.type as string) === 'job:done');
+        const errorEvent = events.find(e => e.type === 'msg:error' || (e.type as string) === 'job:error');
+        const awaitingEvent = events.find(e => e.type === 'msg:awaiting_input' || (e.type as string) === 'job:awaiting_input');
+        const status = awaitingEvent ? 'awaiting_input'
+          : doneEvent ? 'done'
+          : errorEvent ? 'error'
+          : 'running';
+
+        traces.set(traceId, {
+          traceId,
+          startedAt: startEvent.ts,
+          rootRole: startEvent.roleId,
+          rootTask: (startEvent.data.task as string ?? '').slice(0, 200),
+          jobCount: 1,
+          status,
+        });
+      } else {
+        traces.get(traceId)!.jobCount++;
+      }
+    }
+
+    const sorted = [...traces.values()]
+      .sort((a, b) => b.startedAt.localeCompare(a.startedAt))
+      .slice(0, limit);
+
+    res.json(sorted);
+  } catch (err) {
+    next(err);
+  }
+});

package/src/api/src/routes/preferences.ts

@@ -0,0 +1,63 @@
+import crypto from 'node:crypto';
+import { Router, Request, Response, NextFunction } from 'express';
+import { COMPANY_ROOT } from '../services/file-reader.js';
+import { readPreferences, writePreferences, mergePreferences } from '../services/preferences.js';
+
+export const preferencesRouter = Router();
+
+// GET /api/preferences
+preferencesRouter.get('/', (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    res.json(readPreferences(COMPANY_ROOT));
+  } catch (err) {
+    next(err);
+  }
+});
+
+// PUT /api/preferences — full overwrite
+preferencesRouter.put('/', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const prefs = req.body;
+    if (!prefs || typeof prefs !== 'object') {
+      res.status(400).json({ error: 'Invalid preferences body' });
+      return;
+    }
+    const existing = readPreferences(COMPANY_ROOT);
+    writePreferences(COMPANY_ROOT, {
+      instanceId: existing.instanceId, // preserve — never overwrite from client
+      appearances: prefs.appearances ?? {},
+      theme: prefs.theme ?? 'default',
+    });
+    res.json({ ok: true, ...readPreferences(COMPANY_ROOT) });
+  } catch (err) {
+    next(err);
+  }
+});
+
+// POST /api/preferences/regenerate-token — regenerate instanceId
+preferencesRouter.post('/regenerate-token', (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    const current = readPreferences(COMPANY_ROOT);
+    const oldId = current.instanceId;
+    current.instanceId = crypto.randomUUID();
+    writePreferences(COMPANY_ROOT, current);
+    res.json({ ok: true, oldInstanceId: oldId, newInstanceId: current.instanceId });
+  } catch (err) {
+    next(err);
+  }
+});
+
+// PATCH /api/preferences — partial merge
+preferencesRouter.patch('/', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const partial = req.body;
+    if (!partial || typeof partial !== 'object') {
+      res.status(400).json({ error: 'Invalid preferences body' });
+      return;
+    }
+    const merged = mergePreferences(COMPANY_ROOT, partial);
+    res.json({ ok: true, ...merged });
+  } catch (err) {
+    next(err);
+  }
+});

package/src/api/src/routes/presets.ts

@@ -0,0 +1,123 @@
+/**
+ * presets.ts — Preset API routes
+ *
+ * GET  /api/presets          — list all preset summaries
+ * GET  /api/presets/:id      — get full preset detail
+ * POST /api/presets/install  — install preset from data
+ * DELETE /api/presets/:id    — remove installed preset
+ */
+import { Router } from 'express';
+import fs from 'node:fs';
+import path from 'node:path';
+import YAML from 'yaml';
+import { COMPANY_ROOT } from '../services/file-reader.js';
+import { getPresetSummaries, getPresetById, loadPresets } from '../services/preset-loader.js';
+
+export const presetsRouter = Router();
+
+/** GET /api/presets — list preset summaries */
+presetsRouter.get('/', (_req, res) => {
+  try {
+    const summaries = getPresetSummaries(COMPANY_ROOT);
+    res.json(summaries);
+  } catch (err) {
+    res.status(500).json({ error: 'Failed to load presets' });
+  }
+});
+
+/** GET /api/presets/:id — get full preset detail */
+presetsRouter.get('/:id', (req, res) => {
+  try {
+    const preset = getPresetById(COMPANY_ROOT, req.params.id);
+    if (!preset) {
+      res.status(404).json({ error: `Preset not found: ${req.params.id}` });
+      return;
+    }
+    res.json(preset.definition);
+  } catch (err) {
+    res.status(500).json({ error: 'Failed to load preset' });
+  }
+});
+
+/** POST /api/presets/install — install a preset from provided data */
+presetsRouter.post('/install', (req, res) => {
+  try {
+    const { id, preset } = req.body as { id: string; preset: Record<string, unknown> };
+    if (!id || !preset) {
+      res.status(400).json({ error: 'id and preset are required' });
+      return;
+    }
+
+    // Validate preset has required fields
+    if (!preset.name || !preset.roles || !Array.isArray(preset.roles)) {
+      res.status(400).json({ error: 'preset must have name and roles array' });
+      return;
+    }
+
+    // Check for conflict with existing preset
+    const existing = getPresetById(COMPANY_ROOT, id);
+    if (existing && !existing.isDefault) {
+      res.status(409).json({ error: `Preset already installed: ${id}` });
+      return;
+    }
+
+    // Create preset directory and write preset.yaml
+    const presetDir = path.join(COMPANY_ROOT, 'knowledge', 'presets', id);
+    fs.mkdirSync(presetDir, { recursive: true });
+
+    // Write preset.yaml
+    const yamlContent = YAML.stringify(preset);
+    fs.writeFileSync(path.join(presetDir, 'preset.yaml'), yamlContent);
+
+    // Create subdirectories for roles/knowledge/skills
+    fs.mkdirSync(path.join(presetDir, 'roles'), { recursive: true });
+    fs.mkdirSync(path.join(presetDir, 'knowledge'), { recursive: true });
+    fs.mkdirSync(path.join(presetDir, 'skills'), { recursive: true });
+
+    // Write knowledge docs if provided
+    const knowledge = req.body.knowledge as Array<{ filename: string; content: string }> | undefined;
+    if (knowledge) {
+      for (const doc of knowledge) {
+        fs.writeFileSync(path.join(presetDir, 'knowledge', doc.filename), doc.content);
+      }
+    }
+
+    // Write role yamls if provided
+    const roleDefinitions = req.body.roleDefinitions as Array<{ id: string; yaml: string }> | undefined;
+    if (roleDefinitions) {
+      for (const role of roleDefinitions) {
+        const roleDir = path.join(presetDir, 'roles', role.id);
+        fs.mkdirSync(roleDir, { recursive: true });
+        fs.writeFileSync(path.join(roleDir, 'role.yaml'), role.yaml);
+      }
+    }
+
+    res.json({ ok: true, id, path: `knowledge/presets/${id}` });
+  } catch (err) {
+    res.status(500).json({ error: `Install failed: ${err instanceof Error ? err.message : 'unknown'}` });
+  }
+});
+
+/** DELETE /api/presets/:id — remove installed preset */
+presetsRouter.delete('/:id', (req, res) => {
+  try {
+    const { id } = req.params;
+    if (id === 'default' || id === '_default') {
+      res.status(400).json({ error: 'Cannot remove default preset' });
+      return;
+    }
+
+    const presetDir = path.join(COMPANY_ROOT, 'knowledge', 'presets', id);
+    if (!fs.existsSync(presetDir)) {
+      res.status(404).json({ error: `Preset not found: ${id}` });
+      return;
+    }
+
+    // Remove preset directory recursively
+    fs.rmSync(presetDir, { recursive: true, force: true });
+
+    res.json({ ok: true, id });
+  } catch (err) {
+    res.status(500).json({ error: `Remove failed: ${err instanceof Error ? err.message : 'unknown'}` });
+  }
+});

package/src/api/src/routes/projects.ts

@@ -0,0 +1,82 @@
+import { Router, Request, Response, NextFunction } from 'express';
+import { readFile, fileExists } from '../services/file-reader.js';
+import { parseMarkdownTable } from '../services/markdown-parser.js';
+
+export const projectsRouter = Router();
+
+// GET /api/projects — 프로젝트 목록
+projectsRouter.get('/', (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    const content = readFile('knowledge/projects/projects.md');
+    const rows = parseMarkdownTable(content);
+
+    const projects = rows.map(row => {
+      const name = row.project ?? '';
+      const id = name.toLowerCase().replace(/\s+/g, '-');
+      return {
+        id,
+        name,
+        status: row.status ?? '',
+        created: row.created ?? '',
+      };
+    });
+
+    res.json(projects);
+  } catch (err) {
+    next(err);
+  }
+});
+
+// GET /api/projects/:id — 프로젝트 상세
+projectsRouter.get('/:id', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { id } = req.params;
+
+    // 기본 정보
+    const listContent = readFile('knowledge/projects/projects.md');
+    const rows = parseMarkdownTable(listContent);
+    const projectRow = rows.find(r => {
+      const name = r.project ?? '';
+      return name.toLowerCase().replace(/\s+/g, '-') === id;
+    });
+
+    if (!projectRow) {
+      res.status(404).json({ error: `Project not found: ${id}` });
+      return;
+    }
+
+    const name = projectRow.project ?? '';
+    const project: Record<string, unknown> = {
+      id,
+      name,
+      status: projectRow.status ?? '',
+      created: projectRow.created ?? '',
+      prd: '',
+      tasks: [],
+    };
+
+    // PRD 읽기
+    const prdPath = `knowledge/projects/${id}/prd.md`;
+    if (fileExists(prdPath)) {
+      project.prd = readFile(prdPath);
+    }
+
+    // Tasks 읽기
+    const tasksPath = `knowledge/projects/${id}/tasks.md`;
+    if (fileExists(tasksPath)) {
+      const tasksContent = readFile(tasksPath);
+      const taskRows = parseMarkdownTable(tasksContent);
+      project.tasks = taskRows.map(row => ({
+        id: row.id ?? '',
+        title: row.task ?? row.title ?? '',
+        role: row.role ?? '',
+        status: row.status ?? '',
+        description: row.설명 ?? row.description ?? '',
+      }));
+    }
+
+    res.json(project);
+  } catch (err) {
+    next(err);
+  }
+});

package/src/api/src/routes/quests.ts

@@ -0,0 +1,41 @@
+import { Router, Request, Response, NextFunction } from 'express';
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { COMPANY_ROOT } from '../services/file-reader.js';
+
+export const questsRouter = Router();
+
+const QUEST_FILE = () => join(COMPANY_ROOT, '.tycono', 'quest-progress.json');
+
+function readProgress(): Record<string, unknown> {
+  try {
+    return JSON.parse(readFileSync(QUEST_FILE(), 'utf-8'));
+  } catch {
+    return { completedQuests: [], activeChapter: 1, sideQuestsCompleted: [] };
+  }
+}
+
+function writeProgress(data: Record<string, unknown>) {
+  mkdirSync(join(COMPANY_ROOT, '.tycono'), { recursive: true });
+  writeFileSync(QUEST_FILE(), JSON.stringify(data, null, 2));
+}
+
+// GET /api/quests/progress
+questsRouter.get('/progress', (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    res.json(readProgress());
+  } catch (err) { next(err); }
+});
+
+// PUT /api/quests/progress
+questsRouter.put('/progress', (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const body = req.body;
+    if (!body || typeof body !== 'object') {
+      res.status(400).json({ error: 'Invalid body' });
+      return;
+    }
+    writeProgress(body);
+    res.json({ ok: true, ...body });
+  } catch (err) { next(err); }
+});