FONUMA 다른 AI를 위한 개발 안내 / 2026-10-16

Fonuma 앱을 별도 프로젝트에서 개발한다. 코어 자체는 변경하지 않는다.

1. 전달받은 실행기의 `fonuma app --version`과 `fonuma app core-info`를 확인한다.
2. 해당 소스의 CORE_STATUS.md, docs/APPLICATION_CORE_0.2.md,
   docs/APPLICATION_AI_WORKFLOW_0.2.md와 기능별 GENERAL_CORE 문서를 읽는다.
3. examples/general-core에서 실제 구현 예제를 확인한다.
4. 작은 .fonuma 함수를 작성하고 app check 및 app call로 성공·실패 입력을 검증한다.
5. 다중 파일은 fonuma.project.json의 명시 소스와 검토한 lock으로 구성한다.
6. 플랫폼 기능은 별도 SDK/호스트 계약으로 구현한다. 선언만으로 IO를 허용하지 않는다.
7. 없는 문법·명령·패키지·지원 플랫폼을 가정하지 않는다.
8. 코어 오류는 최소 재현, 버전, 명령, 입력, 실제 결과와 기대 결과로 보고한다.

core dev.30은 개발 후보이며 전체 필수 검증은 진행 중이다.
공개 dev.4 설치파일에 dev.30 기능이 있다고 가정하지 않는다.
오디오/MIDI SDK·실시간 처리·브라우저 WASM ABI는 별도 구현/검증 대상이다.

공식 문서: https://fonuma.com/language/
기능 조회 스냅샷: https://fonuma.com/language/core-capabilities.json
검증 상태 스냅샷: https://fonuma.com/language/validation-status.json

소스에서 빌드(전달받은 소스 루트):
cargo build --locked --manifest-path core/tools/Cargo.toml --bin fonuma

기본 출력: core/tools/target/debug/fonuma (Windows는 fonuma.exe).
CARGO_TARGET_DIR가 있으면 그 출력 경로를 사용한다.
소스/검증된 실행기는 별도로 확보해야 하며 공개 dev.4로 대체하지 않는다.

최소 예제 hello.fonuma:
module hello;
export {greet};
fn greet(name: String) -> String effects [pure] {
    return "Hello, " + name;
}

fonuma app check hello.fonuma
fonuma app call hello.fonuma greet --args '["Fonuma"]'

예상 result: "Hello, Fonuma"
기본 CLI는 임의의 파일/네트워크/장치 grant를 주지 않는다.
app inspect와 기능별 문서에서 타입·효과·한도·JSON 표현을 확인한다.