01. AI 인과율 메모리 레이어 (Causal Smart Skipping)
대규모 모노레포에서 영향받지 않은 수십만 줄의 컴파일을 0.00초 만에 완벽히 스킵하는 원리
📌 Git Porcelain -uall 실시간 작업 트리 추적
Synapse Kit은 git status --porcelain -uall을 통해 변경된 파일 목록을 실시간 감지합니다. -uall 안전성 가드를 통해 새로 생성된 하위 폴더의 미추적 파일도 디렉터리 단위로 축약되지 않고 100% 개별 파일 단위로 정밀 열거됩니다.
⚡ 양방향 인과 분기 매핑 규칙
수정된 파일의 경로와 각 플러그인의 triggers를 교차 분석하여 불필요한 도구를 0.00초 만에 건너뜁니다:
// 인과율 트리거 매핑 규칙 예시
• src-tauri/, crates/ ➜ Rust 백엔드 검사기만 가동 (나머지 6개 언어 0초 스킵)
• src/, components/ ➜ Svelte 5 / TypeScript 검사기만 가동
• *.cpp, *.hpp ➜ C/C++ g++ DSP 커널 검사기만 가동
• services/bridge/ ➜ C# .NET dotnet build 검사기만 가동
• services/gateway/ ➜ Java javac 바이트코드 검사기만 가동
• *.json, tauri.conf ➜ Schema 및 설정 무결성 검사기만 가동
⏱️ 인메모리 일시정지 핫픽스 루프 (check -i)
컴파일 에러가 발생하면 프로세스를 강제 종료하지 않고 동결합니다. 코드 오타나 타입을 수정한 뒤 파일을 저장하면, 프로세스 재부팅 없이 인메모리에서 0.05초 만에 즉시 핫 재검증하여 피드백 루프를 극적으로 단축합니다.
02. 5대 핵심 엔지니어링 CLI 파이프라인
검증부터 증분 빌드, 초고속 번들링, 암호 서명까지 단일 프레임워크로 완결
1. bunx synapse-kit check
Git 작업 트리를 분석하여 변경된 영역만 선별 검증합니다.
# 일상 개발용 인과율 스마트 검증 (기본 0.3s)
bunx synapse-kit check
# 배포/커밋 전 전방위 강제 전체 검사
bunx synapse-kit check --all
# 실시간 핫픽스 모드 (에러 시 일시정지 후 저장 즉시 0.05s 재검증)
bunx synapse-kit check -i
# AI 에이전트 연동용 99.8% 토큰 압축 모드 (단 11 토큰 JSON)
bunx synapse-kit check --compact
2. bunx synapse-kit build
등록된 buildTracks의 소스 파일 변경 여부(mtime)와 산출물 해시를 교차 검사하여, 미변경 트랙은 0.00초 스킵하고 변경된 트랙만 멀티코어 병렬 빌드합니다. (콜드 16s ➔ 웜 0.22s, 73배 단축)
bunx synapse-kit build
# 캐시 무시하고 강제 전체 재빌드: bunx synapse-kit build --force
3. bunx synapse-kit package
Tauri 데스크톱 앱 패키징 시 불필요한 WiX MSI 중복 빌드를 차단하고, 단일 NSIS 타겟 + zlib 고속 스트리밍 압축을 적용하여 번들링 속도를 5배 이상 가속합니다.
4. bunx synapse-kit sign
산출된 인스톨러 바이너리의 SHA-256 해시를 검사하여 변경 시에만 Minisign / Ed25519 암호화 서명을 생성합니다. 해시 불변 시 0.00초 스킵합니다.
5. bunx synapse-kit init
현재 프로젝트 구조를 분석하여 최적화된 synapse.config.ts 설정 템플릿을 자동 생성합니다.
03. 7대 표준 언어 플러그인 생태계
Rust, C++, C#, Java, TypeScript, Go, Python 등 폴리글랏 모노레포 완벽 지원
🦀 Rust 플러그인 (rustChecker)
cargo check --workspace 및 cargo clippy를 워커 스레드에서 병렬 구동하여 타입 안정성과 코드 품질을 보장합니다.
⚡ TypeScript Rust 플러그인 (tsrs)
기존 구형 Node.js 단일스레드 컴파일러 대비 17.5배 빠른 Rust Oxc 엔진(tsrs)을 결합하여, 100만 줄 코드베이스를 0.35초 만에 초고속 검증합니다.
🧩 엔터프라이즈 멀티 언어 체커
• Java (javaChecker) : javac 대규모 바이트코드 무결성 병렬 컴파일
• C# .NET (csharpChecker) : dotnet build -c Release -v q 무결성 검증
• C/C++ (cppChecker) : g++ -fsyntax-only 초고속 구문 무결성 분석
• Go (goChecker) : go vet 동시성 루틴 및 패키지 정적 검사
• Python (pythonChecker) : py_compile 정적 바이트코드 및 타입 검증
• Native (nativeChecker) : PE 헤더 파싱을 통한 x64/ARM64 바이너리 아키텍처 일치 검증
• NSIS (nsisChecker) : Windows 인스톨러 스크립트 구문 및 매크로 정적 검사
04. AI 에이전트 연동 & 토큰 다이어트
Claude Code, Cursor, Antigravity 등 차세대 코딩 에이전트 컨텍스트 최적화
📉 99.8% 극단적 토큰 절감 (--compact)
기존 컴파일러의 수천 줄 난잡한 ANSI 터미널 로그(~3,400 Tokens) 대신, AI 에이전트가 즉시 해석할 수 있는 초소형 JSON(11 Tokens)만 방출합니다:
// 성공 시 출력 (단 11 토큰):
{"ok":true,"duration":"0.31s"}
// 오류 발생 시 출력 (오직 에러 발생 플러그인과 진단 정보만 선별 전달):
{"ok":false,"duration":"0.42s","errors":[{"plugin":"rust","message":"expected `u32`, found `&str` at lib.rs:42"}]}
📝 AI 에이전트 설정 파일 권장 룰
.cursorrules 또는 CLAUDE.md에 다음 규칙을 등록하여 사용하세요:
# Verification Rule
When validating or checking code after modifications, DO NOT run cargo check or tsc directly.
Always run: `bunx synapse-kit check --compact` (Runs in 0.3s and uses only 11 tokens).
If errors occur, fix them iteratively based on the minimal error payload.
05. synapse.config.ts API 명세서
타입스크립트로 안전하게 구성하는 프로젝트 설정 레퍼런스
import {
defineConfig,
rustChecker,
javaChecker,
schemaChecker,
nativeChecker,
} from 'synapse-kit';
export default defineConfig({
// 1. AI 인과율 메모리 레이어 설정
aiMemory: {
enabled: true, // 인과율 캐시 활성화
smartSkipping: true, // 미수정 파일 0.00초 스킵 활성화
},
// 2. 검증 플러그인 파이프라인
plugins: [
rustChecker({ workspaceDir: './src-tauri' }),
javaChecker({ sourceDir: './services/gateway' }),
nativeChecker({
targets: [
{ path: './resources/kernel.dll', expectedArchitecture: 'x64' },
],
}),
schemaChecker({
targets: [{ path: './tauri.conf.json' }],
}),
],
// 3. 인과율 증분 빌드 트랙 (소스 변경 시에만 병렬 빌드)
buildTracks: [
{
name: 'Rust Core DLL',
command: ['cargo', 'build', '--release'],
sources: ['src-tauri/src/', 'Cargo.toml'],
artifacts: ['target/release/core.dll'],
},
],
// 4. 고속 패키징 및 암호화 서명 설정
package: {
framework: 'tauri',
targets: ['nsis'],
compression: 'zlib', // zlib 고속 압축 스트리밍
},
sign: {
algorithm: 'ed25519',
keyFile: './keys/release.key',
},
});