feat: v2.2.173-193 — 4인 팀 운영 슬래시 13개 + ASTRA 검증 엔진 6종

4인 팀 운영 슬래시 (v2.2.173~189): - 일과 리듬: /morning, /evening, /weekly, /standup - 트래커 (event-sourced .astra/*.jsonl): /runway, /customers, /hire - 작업·결정: /task, /blocked, /onesie, /decisions - 외부 출력: /draft, /feedback - 분석: /cohort (MoM 추세) ASTRA 추론·검색 엔진 (v2.2.183~192): - v2.2.183 Conflict Surface — scoring.conflictSeverity 를 [CONFLICT WARNINGS] 블록으로 서피스 + 교차-문서 발산(Jaccard) 감지 - v2.2.184 Chain-of-Verification — [VERIFICATION CHECKLIST] 답변 작성 전 그라운딩 자기 점검 (instructional, strictMode 옵션) - v2.2.185 Actionability Scoring — 최근 슬래시 명령 + 열린 파일 신호로 검색 결과 재가중 - v2.2.186 Temporal Markers + Distillation Loop — LongTerm/Episodic 만료 필터 + 30일+ stale episode → LongTerm 'episode-digest' 승급 (수동 /memory distill + 세션 종료 자동) - v2.2.187 Hierarchical Context Window + LLM Semantic Re-rank — 3-level 추상도 매칭 + 토큰 예산 통과 후 LLM 1회로 의도-부합 재정렬 (opt-in) - v2.2.190 Intent Clarification + Citation Trace — 모호 차원 감지 시 역질문 우선 + 답변 끝 사용 출처 한 줄 정리 - v2.2.191 Post-hoc Self-Check — 답변 완료 후 별도 LLM 호출 1회로 답함/그라운딩/모순 평가, footer 한 줄로 표시 (opt-in, semantic re-rank 와 같은 안전 fallback 패턴) - v2.2.192 Terminology Dictionary — .astra/glossary.md 사용자 편집 파일 + Term Check 지침 통합 + /glossary init/path/reload - v2.2.193 /help — 카테고리별 명령 목록 + 6종 verification 블록 현재 on/off 신규 모듈: - src/retrieval/{conflictBlock,coveBlock,actionabilityScoring,hierarchicalLevel, semanticRerank,intentClarification,citationTrace,terminologyBlock}.ts - src/memory/distillation.ts + types.ts 에 expiresAt/promoted/episode-digest 추가 - src/agent/postHocSelfCheck.ts - src/features/{customers,feedback,hire,runway}/*.ts (event-sourced stores) ASTRA 검증 5종 자동 주입 (buildAstraModeSystemPrompt, casual 모드 제외): [INTENT CLARIFICATION GUIDANCE] (답변 시작 전) → [TERMINOLOGY DICTIONARY] + [CONFLICT WARNINGS] + [VERIFICATION CHECKLIST] (작성 중) → [CITATION TRACE] (끝) + 6번째: Post-hoc Self-Check footer (답변 완료 후, opt-in) Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-29 16:05:30 +09:00
parent f3439ddad5
commit 990ea0ae5f
46 changed files with 7172 additions and 136 deletions
@@ -0,0 +1,173 @@
+/**
+ * Runway / Cash 누적 저장소.
+ *
+ * 4인 기업 운영의 가장 중요한 숫자 — 현금 잔고 / 월 소진율 / 남은 개월수 — 를
+ * 한 명령 (`/runway`) 로 본다. 회계 시스템은 아니고, 대표가 머리에 가지고 있는
+ * "지금 통장에 얼마, 한 달에 얼마 나감" 을 코드 옆에서 잡는 가벼운 트래커.
+ *
+ * 저장 형식: JSON Lines (.jsonl) — 한 줄 = 한 entry. 외부 회계 SaaS 연동 안 함.
+ * 위치: `<workspace>/.astra/runway.jsonl`. 사람이 직접 편집 가능, grep / 백업 친화.
+ *
+ * 민감 정보(현금 잔고) 포함되므로 외부로 안 보냄 — 로컬 only.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import * as vscode from 'vscode';
+
+const STORE_REL_PATH = '.astra/runway.jsonl';
+
+export type RunwayEntryType = 'snapshot' | 'expense' | 'revenue' | 'burn';
+
+export interface RunwayEntry {
+    /** unique id — timestamp 기반. */
+    id: string;
+    /** ISO timestamp. */
+    timestamp: string;
+    /** 항목 종류 — snapshot(잔고) / expense(지출) / revenue(수입) / burn(월 소진율 수동 설정). */
+    type: RunwayEntryType;
+    /** 금액 — KRW 기본 단위, 소수점 허용. */
+    amount: number;
+    /** 통화 — 기본 'KRW'. 추후 'USD' 등 확장 가능. */
+    currency?: string;
+    /** 카테고리 — expense 의 경우 'salary' / 'rent' / 'saas' / 'misc' 등. */
+    category?: string;
+    /** 자유 메모. */
+    memo?: string;
+}
+
+export function getRunwayFilePath(): string | null {
+    const folders = vscode.workspace.workspaceFolders;
+    if (!folders || folders.length === 0) return null;
+    return path.join(folders[0].uri.fsPath, STORE_REL_PATH);
+}
+
+export function readRunway(): RunwayEntry[] {
+    const filePath = getRunwayFilePath();
+    if (!filePath || !fs.existsSync(filePath)) return [];
+    const out: RunwayEntry[] = [];
+    let content = '';
+    try { content = fs.readFileSync(filePath, 'utf-8'); } catch { return []; }
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed) continue;
+        try {
+            const entry = JSON.parse(trimmed);
+            if (entry && typeof entry.id === 'string' && typeof entry.amount === 'number' && typeof entry.type === 'string') {
+                out.push(entry as RunwayEntry);
+            }
+        } catch { /* skip malformed line */ }
+    }
+    return out;
+}
+
+export function appendRunway(entry: RunwayEntry): { ok: true; filePath: string } | { ok: false; error: string } {
+    const filePath = getRunwayFilePath();
+    if (!filePath) return { ok: false, error: '워크스페이스 폴더가 없어 저장 불가. VS Code 에서 폴더를 열어 주세요.' };
+    try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.appendFileSync(filePath, JSON.stringify(entry) + '\n', 'utf-8');
+        return { ok: true, filePath };
+    } catch (e: any) {
+        return { ok: false, error: e?.message || String(e) };
+    }
+}
+
+/**
+ * 현재 상태 계산 — 최신 snapshot, 최근 30일 net burn, 명시적 burn 설정 중 우선순위.
+ *
+ * - latestCash: 가장 최근 'snapshot' entry 의 amount (없으면 null).
+ * - explicitBurn: 가장 최근 'burn' entry — 사용자가 수동 설정한 월 소진율.
+ * - computedBurn: 최근 30일 expense - revenue, 30일 미만이면 일 평균 × 30 으로 보정.
+ * - effectiveBurn: explicitBurn 우선, 없으면 computedBurn.
+ * - runwayMonths: latestCash / effectiveBurn — burn 이 0 이하면 Infinity.
+ */
+export interface RunwayStatus {
+    latestCash: number | null;
+    latestCashAt: string | null;
+    explicitBurn: number | null;
+    computedBurn: number | null;
+    effectiveBurn: number | null;
+    runwayMonths: number | null;
+    last30Expense: number;
+    last30Revenue: number;
+    last30Days: number;
+    totalEntries: number;
+}
+
+export function computeRunwayStatus(now: Date = new Date()): RunwayStatus {
+    const entries = readRunway();
+    const nowMs = now.getTime();
+    const thirtyDaysMs = 30 * 24 * 60 * 60 * 1000;
+
+    let latestCash: number | null = null;
+    let latestCashAt: string | null = null;
+    let explicitBurn: number | null = null;
+    let last30Expense = 0;
+    let last30Revenue = 0;
+    let oldestRecentMs = nowMs;
+    let hasRecent = false;
+
+    for (const e of entries) {
+        const t = Date.parse(e.timestamp);
+        if (e.type === 'snapshot') {
+            if (!latestCashAt || (Date.parse(e.timestamp) >= Date.parse(latestCashAt))) {
+                latestCash = e.amount;
+                latestCashAt = e.timestamp;
+            }
+        } else if (e.type === 'burn') {
+            if (!explicitBurn || t >= (entries.find(x => x.type === 'burn' && x.amount === explicitBurn)?.timestamp ? Date.parse(e.timestamp) : 0)) {
+                explicitBurn = e.amount;
+            }
+        } else if (e.type === 'expense' && nowMs - t <= thirtyDaysMs) {
+            last30Expense += e.amount;
+            if (t < oldestRecentMs) oldestRecentMs = t;
+            hasRecent = true;
+        } else if (e.type === 'revenue' && nowMs - t <= thirtyDaysMs) {
+            last30Revenue += e.amount;
+            if (t < oldestRecentMs) oldestRecentMs = t;
+            hasRecent = true;
+        }
+    }
+
+    // 최신 burn 정확히 다시 — 위 로직이 꼬여서 단순화.
+    explicitBurn = null;
+    let burnAt = 0;
+    for (const e of entries) {
+        if (e.type !== 'burn') continue;
+        const t = Date.parse(e.timestamp);
+        if (t >= burnAt) { explicitBurn = e.amount; burnAt = t; }
+    }
+
+    const netBurn30 = last30Expense - last30Revenue;
+    let computedBurn: number | null = null;
+    let last30Days = 0;
+    if (hasRecent) {
+        const span = Math.max(1, Math.ceil((nowMs - oldestRecentMs) / (24 * 60 * 60 * 1000)));
+        last30Days = Math.min(30, span);
+        // 30일 미만이면 일 평균 × 30 으로 환산.
+        if (last30Days < 30) computedBurn = (netBurn30 / last30Days) * 30;
+        else computedBurn = netBurn30;
+    }
+
+    const effectiveBurn = explicitBurn ?? computedBurn;
+    let runwayMonths: number | null = null;
+    if (latestCash !== null && effectiveBurn !== null && effectiveBurn > 0) {
+        runwayMonths = latestCash / effectiveBurn;
+    } else if (latestCash !== null && effectiveBurn !== null && effectiveBurn <= 0) {
+        runwayMonths = Infinity;
+    }
+
+    return {
+        latestCash,
+        latestCashAt,
+        explicitBurn,
+        computedBurn,
+        effectiveBurn,
+        runwayMonths,
+        last30Expense,
+        last30Revenue,
+        last30Days,
+        totalEntries: entries.length,
+    };
+}