timsquad 3.3.0 → 3.5.0

package/README.md

@@ -4,262 +4,269 @@
 
 <p align="center">
   <strong>Vibe Development Framework</strong><br>
-  SSOT 기반 문서 체계, 최적화된 에이전트 롤, 회고적 학습을 통해 Claude Code에서 지속적으로 개선되는 고품질 소프트웨어 생성 프레임워크
+  A high-quality software development framework powered by SSOT-based documentation, optimized agent roles, and retrospective learning — continuously improving within Claude Code.
+</p>
+
+<p align="center">
+  <strong>English</strong> | <a href="README.ko.md">한국어</a>
 </p>
 
 ```
-최적화된 롤 정의 + 고도화된 스킬 + 회고적 학습 = 지속적으로 개선되는 고품질 결과물
+Optimized Role Definitions + Advanced Skills + Retrospective Learning = Continuously Improving High-Quality Output
 ```
 
 ---
 
 ## Why TimSquad?
 
-| | 일반적 접근 | **TimSquad** |
+| | Typical Approach | **TimSquad** |
 |---|---------|------------|
-| 철학 | "Zero learning curve" | **"체계를 세우면 더 잘 된다"** |
-| 의사결정 | LLM이 알아서 | **개발자가 컨트롤** |
-| 우선순위 | 속도 | **품질 + 일관성** |
-| 반복 작업 | LLM이 처리 (토큰 소비) | **프로그램이 처리 (토큰 0)** |
-| 학습 | 없음 | **회고적 학습으로 지속 개선** |
+| Philosophy | "Zero learning curve" | **"Structure leads to better results"** |
+| Decision Making | LLM decides everything | **Developer stays in control** |
+| Priority | Speed | **Quality + Consistency** |
+| Repetitive Tasks | LLM handles (token cost) | **Program handles (zero tokens)** |
+| Learning | None | **Retrospective learning for continuous improvement** |
 
 **For developers who want structure, not magic.**
 
-### 타겟 사용자
+### Target Users
 
-- 체계적인 프로세스를 원하는 시니어 개발자
-- 1인 CTO / 테크 리드 (혼자서 팀 수준의 품질 필요)
-- 문서화와 일관성을 중시하는 개발자
+- Senior developers who value structured processes
+- Solo CTOs / Tech Leads (need team-level quality working alone)
+- Developers who prioritize documentation and consistency
 
 ---
 
-## 설치
+## Installation
 
 ```bash
-# 전역 설치
+# Global install
 npm install -g timsquad
 
-# 또는 npx로 직접 실행
+# Or run directly with npx
 npx timsquad init
 ```
 
-**요구사항:**
+**Requirements:**
 - Node.js >= 18.0.0
-- [Claude Code](https://claude.ai/claude-code) (에이전트 실행 환경)
+- [Claude Code](https://claude.ai/claude-code) (agent execution environment)
 
 ---
 
-## 빠른 시작
+## Quick Start
 
-### 1. 프로젝트 초기화
+### 1. Initialize a Project
 
 ```bash
-tsq init                                      # 대화형 초기화
-tsq init -n my-app -t web-service -l 2 -y     # 비대화형
+tsq init                                      # Interactive setup
+tsq init -n my-app -t web-service -l 2 -y     # Non-interactive
 ```
 
-### 2. 생성되는 구조
+### 2. Generated Structure
 
 ```
 my-app/
-├── CLAUDE.md                      # PM 역할 정의 (에이전트 지시사항)
+├── CLAUDE.md                      # PM role definition (agent instructions)
 ├── .claude/
-│   ├── settings.json              # Claude Code 설정
-│   ├── rules/                     # 메인 세션 전용 규칙
-│   ├── agents/                    # 6개 전문 에이전트
-│   │   ├── tsq-architect.md       # 아키텍처 설계 (Sonnet)
-│   │   ├── tsq-developer.md       # 코드 구현 (Sonnet)
-│   │   ├── tsq-qa.md              # 검증/리뷰 (Sonnet)
-│   │   ├── tsq-security.md        # 보안 검토 (Sonnet)
-│   │   ├── tsq-dba.md             # DB 설계 (Sonnet)
-│   │   └── tsq-designer.md        # UI/UX 설계 (Sonnet)
-│   ├── skills/                    # 도메인별 스킬셋
-│   │   ├── tsq-protocol/          # 에이전트 공통 프로토콜
-│   │   ├── coding/                # 코딩 규칙 + rules/
-│   │   ├── testing/               # 테스트 전략 + references/
-│   │   ├── typescript/            # TypeScript 패턴 + rules/
-│   │   ├── frontend/(react|nextjs)/ # 프론트엔드 + Vercel 22개 룰
-│   │   ├── backend/node/          # Node.js 백엔드 + rules/
+│   ├── settings.json              # Claude Code settings
+│   ├── rules/                     # Main session rules
+│   ├── agents/                    # 6 specialized agents
+│   │   ├── tsq-architect.md       # Architecture design (Sonnet)
+│   │   ├── tsq-developer.md       # Code implementation (Sonnet)
+│   │   ├── tsq-qa.md              # Verification/review (Sonnet)
+│   │   ├── tsq-security.md        # Security audit (Sonnet)
+│   │   ├── tsq-dba.md             # DB design (Sonnet)
+│   │   └── tsq-designer.md        # UI/UX design (Sonnet)
+│   ├── skills/                    # Domain-specific skillsets
+│   │   ├── tsq-protocol/          # Shared agent protocol
+│   │   ├── coding/                # Coding rules + rules/
+│   │   ├── testing/               # Test strategies + references/
+│   │   ├── typescript/            # TypeScript patterns + rules/
+│   │   ├── frontend/(react|nextjs)/ # Frontend + 22 Vercel rules
+│   │   ├── backend/node/          # Node.js backend + rules/
 │   │   ├── database/prisma/       # Prisma ORM + rules/
+│   │   ├── mobile/dart/             # Dart language + rules/
+│   │   ├── mobile/flutter/          # Flutter dev + rules/ + refs/
+│   │   │   └── push-notifications/  # FCM + local + background
 │   │   ├── methodology/(tdd|bdd|ddd|debugging)/
 │   │   └── ...
-│   └── knowledge/                 # 에이전트 참조 지식
-│       ├── checklists/            # 보안, 접근성, SSOT 검증
-│       └── templates/             # 출력 형식 (task-result 등)
+│   └── knowledge/                 # Agent reference knowledge
+│       ├── checklists/            # Security, accessibility, SSOT validation
+│       └── templates/             # Output formats (task-result, etc.)
 └── .timsquad/
-    ├── config.yaml                # 프로젝트 설정
-    ├── ssot/                      # SSOT 문서 (레벨별 5~14개)
-    ├── process/                   # 워크플로우 정의
-    ├── state/                     # 상태 관리 + Meta Index
-    ├── feedback/                  # 피드백 저장소
-    ├── logs/                      # 3계층 로그 (L1→L2→L3)
-    └── retrospective/             # 회고 데이터
+    ├── config.yaml                # Project configuration
+    ├── ssot/                      # SSOT documents (5–14 per level)
+    ├── process/                   # Workflow definitions
+    ├── state/                     # State management + Meta Index
+    ├── feedback/                  # Feedback store
+    ├── logs/                      # 3-tier logs (L1→L2→L3)
+    └── retrospective/             # Retrospective data
 ```
 
-### 3. Claude Code에서 작업
+### 3. Work in Claude Code
 
 ```bash
-claude                                    # Claude Code 실행
+claude                                    # Launch Claude Code
 
-# PM(CLAUDE.md)이 자동으로 작업을 분류하고 에이전트에 위임
-@tsq-architect "시스템 아키텍처 설계해줘"
-@tsq-developer "로그인 API 구현해줘"
-@tsq-qa "코드 리뷰해줘"
+# PM (CLAUDE.md) automatically classifies tasks and delegates to agents
+@tsq-architect "Design the system architecture"
+@tsq-developer "Implement the login API"
+@tsq-qa "Review the code"
 ```
 
-### 4. CLI로 작업 관리
+### 4. Manage Tasks via CLI
 
 ```bash
-tsq status                        # 현재 상태 확인
-tsq q "버튼 색상 변경"              # Quick 모드 (간단한 작업)
-tsq f "결제 기능 추가"              # Full 모드 (SSOT 검증)
-tsq retro auto                    # 회고 자동 실행
+tsq status                        # Check current status
+tsq q "change button color"       # Quick mode (simple tasks)
+tsq f "add payment feature"       # Full mode (SSOT validation)
+tsq retro auto                    # Run retrospective automatically
 ```
 
 ---
 
-## 핵심 기능
+## Key Features
 
-### SSOT 문서 체계
+### SSOT Document System
 
-프로젝트 레벨에 따라 필수 문서가 자동 결정됩니다:
+Required documents are automatically determined by project level:
 
-| 레벨 | 필수 문서 | 대상 |
-|------|----------|------|
-| **Level 1** (MVP) | PRD, Planning, Requirements, Service Spec, Data Design (5개) | 사이드 프로젝트, PoC |
-| **Level 2** (Standard) | Level 1 + 6개 추가 (11개) | 일반 프로젝트, 스타트업 |
-| **Level 3** (Enterprise) | Level 2 + 3개 추가 (14개) | 엔터프라이즈, fintech |
+| Level | Required Documents | Target |
+|-------|-------------------|--------|
+| **Level 1** (MVP) | PRD, Planning, Requirements, Service Spec, Data Design (5) | Side projects, PoC |
+| **Level 2** (Standard) | Level 1 + 6 more (11) | General projects, Startups |
+| **Level 3** (Enterprise) | Level 2 + 3 more (14) | Enterprise, Fintech |
 
-### 에이전트 시스템
+### Agent System
 
-PM(CLAUDE.md)이 총괄하며 6개 전문 에이전트에 위임합니다. 각 에이전트는 XML 구조화된 프롬프트, 필수 스킬 주입, 3단계 피드백 라우팅을 갖추고 있습니다.
+The PM (CLAUDE.md) orchestrates and delegates to 6 specialized agents. Each agent features XML-structured prompts, mandatory skill injection, and 3-tier feedback routing.
 
-| 에이전트 | 역할 |
-|----------|------|
-| `@tsq-architect` | 아키텍처 설계, ADR, 코드 구조 리뷰 |
-| `@tsq-developer` | SSOT 기반 코드 구현, TDD |
-| `@tsq-qa` | 코드 리뷰, 테스트 검증, SSOT 적합성 |
-| `@tsq-security` | 보안 검증, OWASP, 취약점 분석 |
-| `@tsq-dba` | DB 설계, 쿼리 최적화, 마이그레이션 |
-| `@tsq-designer` | UI/UX 설계, 접근성, 디자인 토큰 |
+| Agent | Role |
+|-------|------|
+| `@tsq-architect` | Architecture design, ADR, code structure review |
+| `@tsq-developer` | SSOT-driven code implementation, TDD |
+| `@tsq-qa` | Code review, test verification, SSOT compliance |
+| `@tsq-security` | Security audit, OWASP, vulnerability analysis |
+| `@tsq-dba` | DB design, query optimization, migrations |
+| `@tsq-designer` | UI/UX design, accessibility, design tokens |
 
-### 피드백 라우팅 (L1/L2/L3)
+### Feedback Routing (L1/L2/L3)
 
-피드백을 3단계로 자동 분류하고 적절한 액션을 실행합니다:
+Feedback is automatically classified into 3 tiers with appropriate actions:
 
 ```
-L1 (구현 수정) → Developer 자동 처리      → 승인 불필요
-L2 (설계 수정) → in_review 상태로 전환     → Phase Gate 차단
-L3 (기획 수정) → 사용자 승인 대기          → approve/reject 필수
+L1 (Implementation fix) → Developer auto-handles     → No approval needed
+L2 (Design change)      → Transitions to in_review   → Phase Gate blocks
+L3 (Planning change)    → Awaits user approval        → approve/reject required
 ```
 
-→ 상세: [docs/feedback-and-retrospective.md](docs/feedback-and-retrospective.md)
+> Details: [docs/feedback-and-retrospective.en.md](docs/feedback-and-retrospective.en.md)
 
-### 회고적 학습
+### Retrospective Learning
 
-작업 로그 → 패턴 분석 → 개선 제안 → 프롬프트/템플릿 업데이트. LLM 파인튜닝 대신 프롬프트/템플릿 개선으로 실용화합니다.
+Task logs → Pattern analysis → Improvement suggestions → Prompt/template updates. Instead of LLM fine-tuning, we improve through prompt/template refinement.
 
 ```bash
-tsq retro auto              # 수집 → 분석 → 리포트 → 적용 (원클릭)
-tsq improve analyze          # 패턴 분석 + 개선 제안
+tsq retro auto              # Collect → Analyze → Report → Apply (one-click)
+tsq improve analyze          # Pattern analysis + improvement suggestions
 ```
 
-→ 상세: [docs/feedback-and-retrospective.md](docs/feedback-and-retrospective.md)
+> Details: [docs/feedback-and-retrospective.en.md](docs/feedback-and-retrospective.en.md)
 
-### 데몬 기반 자동화 파이프라인
+### Daemon-Based Automation Pipeline
 
-**모든 오케스트레이션은 토큰 비용 0** — 프로그램이 판단합니다:
+**All orchestration at zero token cost** — the program decides:
 
 ```
-Claude Code 세션 → 데몬이 JSONL 실시간 감시
-  → L1 태스크 로그 자동 기록
-  → L2 시퀀스 로그 자동 집계
-  → L3 Phase 로그 자동 생성
-  → Phase Gate 자동 확인
-  → 메트릭 인메모리 누적 → 세션 끝 flush
-  → Meta Index 자동 업데이트
+Claude Code session → Daemon watches JSONL in real-time
+  → L1 task logs recorded automatically
+  → L2 sequence logs aggregated automatically
+  → L3 phase logs generated automatically
+  → Phase Gate checked automatically
+  → Metrics accumulated in-memory → flushed at session end
+  → Meta Index updated automatically
 ```
 
-→ 상세: [docs/token-efficiency.md](docs/token-efficiency.md)
+> Details: [docs/token-efficiency.en.md](docs/token-efficiency.en.md)
 
-### Meta Index (코드 구조 인덱스)
+### Meta Index (Code Structure Index)
 
-AST 기반 코드/UI 구조 자동 인덱싱 + 에이전트 semantic 데이터 병합:
+AST-based code/UI structure auto-indexing + agent semantic data merging:
 
 ```bash
-tsq mi rebuild              # 전체 코드+UI 인덱스 구축
+tsq mi rebuild              # Build full code+UI index
 tsq mi stats                # Health Score + UI Health
 ```
 
-→ 상세: [docs/meta-index-architecture.md](docs/meta-index-architecture.md)
+> Details: [docs/meta-index-architecture.en.md](docs/meta-index-architecture.en.md)
 
 ---
 
-## CLI 명령어 요약
-
-| 명령어 | 설명 |
-|--------|------|
-| `tsq init` | 프로젝트 초기화 (대화형/비대화형) |
-| `tsq status` | 프로젝트 상태 확인 |
-| `tsq q "작업"` | Quick 모드 (간단한 작업) |
-| `tsq f "작업"` | Full 모드 (SSOT 검증) |
-| `tsq log` | 3계층 작업 로그 관리 (L1/L2/L3) |
-| `tsq feedback` | 피드백 분류 + 자동 액션 |
-| `tsq retro` | 회고 실행 (수동/자동) |
-| `tsq metrics` | 메트릭 수집/트렌드 |
-| `tsq mi` | Meta Index 관리 (rebuild/stats) |
-| `tsq knowledge` | Knowledge 파일 관리 |
-| `tsq wf` | 워크플로우 자동화 |
-| `tsq daemon` | 백그라운드 데몬 관리 |
-
-→ 전체 CLI 레퍼런스: [docs/cli.md](docs/cli.md)
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `tsq init` | Initialize project (interactive/non-interactive) |
+| `tsq status` | Check project status |
+| `tsq q "task"` | Quick mode (simple tasks) |
+| `tsq f "task"` | Full mode (SSOT validation) |
+| `tsq log` | 3-tier task log management (L1/L2/L3) |
+| `tsq feedback` | Feedback classification + auto actions |
+| `tsq retro` | Run retrospective (manual/auto) |
+| `tsq metrics` | Metrics collection/trends |
+| `tsq mi` | Meta Index management (rebuild/stats) |
+| `tsq knowledge` | Knowledge file management |
+| `tsq wf` | Workflow automation |
+| `tsq daemon` | Background daemon management |
+
+> Full CLI reference: [docs/cli.en.md](docs/cli.en.md)
 
 ---
 
-## 프로젝트 타입
+## Project Types
 
-| 타입 | 설명 |
-|------|------|
-| `web-service` | SaaS, 풀스택 웹 서비스 |
-| `web-app` | BaaS 기반 (Supabase/Firebase) |
-| `api-backend` | API 서버, 마이크로서비스 |
-| `platform` | 프레임워크, SDK |
-| `fintech` | 거래소, 결제 (Level 3 강제) |
-| `infra` | DevOps, 자동화 |
+| Type | Description |
+|------|-------------|
+| `web-service` | SaaS, full-stack web services |
+| `web-app` | BaaS-based (Supabase/Firebase) |
+| `api-backend` | API servers, microservices |
+| `platform` | Frameworks, SDKs |
+| `fintech` | Exchanges, payments (Level 3 enforced) |
+| `infra` | DevOps, automation |
 
 ---
 
-## 문서
-
-| 문서 | 설명 |
-|------|------|
-| [PRD](docs/PRD.md) | 프레임워크 전체 기획 |
-| [Core Concepts](docs/core-concepts.md) | 분수 모델, SSOT, 에이전트/스킬 구조 |
-| [CLI Reference](docs/cli.md) | 전체 CLI 명령어 레퍼런스 |
-| [Authoring Guide](docs/authoring-guide.md) | 에이전트/스킬/Knowledge 작성 가이드 |
-| [Log Architecture](docs/log-architecture.md) | 3계층 로그 체계 (L1→L2→L3) |
-| [Feedback & Retrospective](docs/feedback-and-retrospective.md) | 피드백 라우팅 + 회고적 학습 |
-| [Token Efficiency](docs/token-efficiency.md) | 토큰 효율성 설계 |
-| [Knowledge Architecture](docs/knowledge-architecture.md) | Knowledge 시스템 |
-| [Meta Index Architecture](docs/meta-index-architecture.md) | 코드/UI 구조 인덱스 |
-| [File Structure](docs/file-structure.md) | 템플릿 + 초기화 후 구조 |
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [PRD](docs/PRD.en.md) | Full framework specification |
+| [Core Concepts](docs/core-concepts.en.md) | Fountain model, SSOT, agent/skill architecture |
+| [CLI Reference](docs/cli.en.md) | Complete CLI command reference |
+| [Authoring Guide](docs/authoring-guide.en.md) | Agent/skill/knowledge authoring guide |
+| [Log Architecture](docs/log-architecture.en.md) | 3-tier log system (L1→L2→L3) |
+| [Feedback & Retrospective](docs/feedback-and-retrospective.en.md) | Feedback routing + retrospective learning |
+| [Token Efficiency](docs/token-efficiency.en.md) | Token efficiency design |
+| [Knowledge Architecture](docs/knowledge-architecture.en.md) | Knowledge system |
+| [Meta Index Architecture](docs/meta-index-architecture.en.md) | Code/UI structure index |
+| [File Structure](docs/file-structure.en.md) | Templates + post-init structure |
 
 ---
 
 ## Theoretical Background
 
-| 이론/논문 | 핵심 개념 | TimSquad 적용 |
-|---------|---------|--------------|
-| **Agentsway** (2025) | Prompting Agent, Retrospective Learning | 프롬프트 최적화, 회고적 학습 |
-| **ACM TOSEM** (2025) | Competency Mapping | 역량 프레임워크, 성과 지표 |
-| **Agentic SE** (2025) | AGENT.md, Meta-Prompt Files | 계층화된 메타-프롬프트 구조 |
-| **FRAME** (2025) | Feedback-Driven Refinement | 레벨별 피드백 라우팅 |
+| Theory/Paper | Key Concept | TimSquad Application |
+|-------------|-------------|---------------------|
+| **Agentsway** (2025) | Prompting Agent, Retrospective Learning | Prompt optimization, retrospective learning |
+| **ACM TOSEM** (2025) | Competency Mapping | Competency framework, performance metrics |
+| **Agentic SE** (2025) | AGENT.md, Meta-Prompt Files | Layered meta-prompt architecture |
+| **FRAME** (2025) | Feedback-Driven Refinement | Tiered feedback routing |
 
 ---
 
 ## Contributing
 
-기여를 환영합니다!
+Contributions are welcome!
 
 1. Fork the repository
 2. Create your feature branch (`git checkout -b feature/amazing-feature`)

package/dist/commands/compile.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerCompileCommand(program: Command): void;
+//# sourceMappingURL=compile.d.ts.map

package/dist/commands/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/commands/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqD7D"}

package/dist/commands/compile.js

@@ -0,0 +1,170 @@
+import path from 'path';
+import { colors, printHeader, printError, printSuccess, printWarning, printInfo, printStep, } from '../utils/colors.js';
+import { findProjectRoot } from '../lib/project.js';
+import { exists } from '../utils/fs.js';
+import { compileAll, checkStale, validateDependencyGraph, } from '../lib/compiler.js';
+export function registerCompileCommand(program) {
+    const compileCmd = program
+        .command('compile')
+        .description('Compile SSOT documents into agent-facing specs (Context DI)');
+    compileCmd
+        .command('build')
+        .description('Compile all SSOT documents into controller specs')
+        .alias('b')
+        .action(async () => {
+        try {
+            await runCompile();
+        }
+        catch (err) {
+            printError(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    compileCmd
+        .command('validate')
+        .description('Validate SSOT completeness and dependency graph')
+        .alias('v')
+        .action(async () => {
+        try {
+            await runValidate();
+        }
+        catch (err) {
+            printError(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    compileCmd
+        .command('status')
+        .description('Check for stale specs (SSOT changed since last compile)')
+        .alias('s')
+        .action(async () => {
+        try {
+            await runStatus();
+        }
+        catch (err) {
+            printError(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    // Default action (no subcommand) → build
+    compileCmd.action(async () => {
+        try {
+            await runCompile();
+        }
+        catch (err) {
+            printError(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+async function resolveProject() {
+    const projectRoot = await findProjectRoot();
+    if (!projectRoot) {
+        throw new Error('TimSquad 프로젝트를 찾을 수 없습니다. tsq init을 먼저 실행하세요.');
+    }
+    const controllerDir = path.join(projectRoot, '.claude', 'skills', 'controller');
+    return { projectRoot, controllerDir };
+}
+// ─── tsq compile (build) ─────────────────────────────────────────
+async function runCompile() {
+    printHeader('SSOT Compile');
+    const { projectRoot, controllerDir } = await resolveProject();
+    // Verify SSOT directory exists
+    const ssotDir = path.join(projectRoot, '.timsquad', 'ssot');
+    if (!await exists(ssotDir)) {
+        printError('.timsquad/ssot/ 디렉토리가 없습니다.');
+        return;
+    }
+    printStep(1, 3, 'SSOT 문서 파싱 및 컴파일...');
+    const result = await compileAll(projectRoot, controllerDir);
+    printStep(2, 3, '검증 결과 확인...');
+    printCompileResult(result);
+    printStep(3, 3, '의존성 그래프 검증...');
+    const unresolved = await validateDependencyGraph(projectRoot, controllerDir);
+    printDependencyResult(unresolved);
+    if (result.success && unresolved.length === 0) {
+        printSuccess(`컴파일 완료 — ${result.compiled.length}개 문서, ${countOutputFiles(result)}개 spec 생성`);
+    }
+    else if (result.success) {
+        printWarning(`컴파일 완료 (의존성 미해결 ${unresolved.length}건)`);
+    }
+    else {
+        printError(`컴파일 실패 — ${result.errors.length}건 오류`);
+    }
+}
+// ─── tsq compile validate ────────────────────────────────────────
+async function runValidate() {
+    printHeader('SSOT Validate');
+    const { projectRoot, controllerDir } = await resolveProject();
+    // Check stale first
+    const stale = await checkStale(projectRoot, controllerDir);
+    if (stale.length > 0) {
+        printWarning('Stale spec 감지:');
+        for (const s of stale) {
+            console.log(`  ${colors.warning('⚠')} ${colors.path(s.source)} — ${s.reason}`);
+        }
+        console.log();
+    }
+    // Dependency graph
+    const unresolved = await validateDependencyGraph(projectRoot, controllerDir);
+    printDependencyResult(unresolved);
+    if (stale.length === 0 && unresolved.length === 0) {
+        printSuccess('모든 검증 통과');
+    }
+}
+// ─── tsq compile status ──────────────────────────────────────────
+async function runStatus() {
+    printHeader('Compile Status');
+    const { projectRoot, controllerDir } = await resolveProject();
+    const stale = await checkStale(projectRoot, controllerDir);
+    if (stale.length === 0) {
+        printSuccess('모든 spec이 최신 상태입니다.');
+    }
+    else {
+        printWarning(`${stale.length}개 SSOT 변경 감지 — tsq compile 실행 필요:`);
+        for (const s of stale) {
+            console.log(`  ${colors.warning('⚠')} ${colors.path(s.source)} — ${s.reason}`);
+        }
+    }
+}
+// ─── Output Helpers ──────────────────────────────────────────────
+function printCompileResult(result) {
+    // Compiled documents
+    for (const c of result.compiled) {
+        const validation = result.validations.find((v) => v.source === c.source);
+        const score = validation ? `${validation.score}%` : '-';
+        const icon = validation && validation.score === 100 ? '✅' : validation && validation.score >= 50 ? '⚠️' : '❌';
+        console.log(`  ${icon} ${colors.path(c.source)} → ${c.outputFiles.length}개 spec (완성도: ${score})`);
+        // Show missing fields
+        if (validation && validation.missingFields.length > 0) {
+            for (const mf of validation.missingFields) {
+                console.log(`     ${colors.dim(`└ ${mf.section}: 누락 필드 [${mf.fields.join(', ')}]`)}`);
+            }
+        }
+    }
+    // Skipped (too small / template)
+    if (result.skipped.length > 0) {
+        console.log(`  ${colors.dim(`⏭ 건너뜀 (미작성): ${result.skipped.join(', ')}`)}`);
+    }
+    // Errors
+    for (const err of result.errors) {
+        printError(err);
+    }
+    console.log();
+}
+function printDependencyResult(unresolved) {
+    if (unresolved.length === 0) {
+        printInfo('의존성 그래프: 모든 agent prerequisites 해결됨');
+    }
+    else {
+        printWarning('미해결 의존성:');
+        for (const u of unresolved) {
+            console.log(`  ${colors.agent(u.agent)} → 누락: ${u.missing.map((m) => colors.path(m)).join(', ')}`);
+        }
+    }
+    console.log();
+}
+function countOutputFiles(result) {
+    return result.compiled.reduce((sum, c) => sum + c.outputFiles.length, 0);
+}
+//# sourceMappingURL=compile.js.map

package/dist/commands/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/commands/compile.ts"],"names":[],"mappings":"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"}

package/dist/commands/daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/commands/daemon.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4C5D"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/commands/daemon.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwF5D"}