feat(compiler): auto-generate Lexicon from MEL ActionSpec

[eggplantiny]

Summary

MEL 컴파일러가 ActionSpec.input.fields에서 Lexicon(θ-role 매핑 테이블)을 자동 생성하도록 한다.

Motivation

현재 Intent IR 파이프라인에서 Lexicon은 수작업으로 작성해야 한다:

// apps/taskflow/src/lib/lexicon.ts — 이걸 사람이 써야 함
create → createTask (THEME→title, BENEFICIARY→assignee)
move → moveTask (TARGET→taskTitle, DEST→newStatus)

MEL에 이미 모든 정보가 있다. compileMelDomain()의 결과에서:

• action name → lemma 변환 (createTask → create)
• field name → θ-role 매핑 (assignee → BENEFICIARY, dueDate → time)

이 매핑이 자동화되면 "MEL만 주면 에이전트가 작동하는" 루프가 완성된다.

Proposed Approach

1. Action name → lemma (접미사 strip)

createTask → create
updateTask → update
softDeleteTask → delete
moveTask → move

2. Field name → θ-role (naming convention)

id, *Id        → TARGET
title, name    → THEME
assignee, owner → BENEFICIARY
*Date, deadline → TimeSpec
status, *Status → DEST
description    → INSTRUMENT
tags, labels   → SOURCE

3. API

import { compileMelDomain, generateLexicon } from '@manifesto-ai/compiler';

const { schema } = compileMelDomain(melText);
const lexicon = generateLexicon(schema);
// → { create: { intentKind: 'createTask', roleMap: { THEME: 'title', ... }, timeField: 'dueDate' }, ... }

Impact

• TaskFlow의 수작업 lexicon.ts 삭제 가능
• 새 도메인에서 MEL만 작성하면 Intent IR 파이프라인 자동 작동
• Manifesto의 비전 ("AI가 도메인을 생성/수정/발전") 달성의 핵심 조각

References

• Intent IR SPEC v0.2.0 (archived at docs/archive/intent-ir/SPEC-v0.2.0.md)
• Translator SPEC v1.0.3 (archived at docs/archive/translator/translator-SPEC-v1.0.3.md)
• TaskFlow Intent IR MVP: apps/taskflow/src/lib/lexicon.ts, resolver.ts, lower.ts

[eggplantiny]

Package Boundary: generateLexicon은 compiler에 속하지 않는다

제안된 API:

import { compileMelDomain, generateLexicon } from '@manifesto-ai/compiler';

이것은 ADR-001 (Layer Separation)과 compiler의 기존 책임 범위에 맞지 않습니다.

Compiler의 책임은 "MEL → DomainSchema" 변환뿐입니다. DomainSchema를 소비해서 파생물을 만드는 도구는 전부 compiler 바깥에 있어야 합니다. 이미 이 원칙이 적용된 선례가 있습니다:

도구	입력	출력	패키지
compiler	MEL → DomainSchema	IR	@manifesto-ai/compiler
codegen	DomainSchema → TypeScript/Zod	코드 파일	@manifesto-ai/codegen
lexicon-gen	DomainSchema → θ-role 매핑	Lexicon	@manifesto-ai/lexicon-gen (또는 codegen 플러그인)

codegen이 compiler에 내장되지 않고 별도 패키지인 이유와 동일합니다. compiler에 lexicon 생성을 넣으면, compiler가 "자연어 의미론"에 대한 의견을 갖게 됩니다. assignee → BENEFICIARY 매핑은 언어학적 판단이지 MEL 컴파일의 관심사가 아닙니다.

제안하는 구조:

// compiler는 기존 역할만
import { compileMelDomain } from '@manifesto-ai/compiler';
const { schema } = compileMelDomain(melText);
// lexicon 생성은 별도 소비자 도구

import { generateLexicon } from '@manifesto-ai/lexicon-gen';

const lexicon = generateLexicon(schema);

또는 codegen의 플러그인 모델을 활용:

import { generate } from '@manifesto-ai/codegen';
import { lexiconPlugin } from '@manifesto-ai/codegen-plugin-lexicon';
const result = await generate(schema, { plugins: [lexiconPlugin()] });

---

더 근본적인 질문: Lexicon이 최선의 경로인가?

Lexicon-gen은 "DomainSchema → 자연어 매핑 테이블"을 자동화합니다. 이것은 유용하지만, 한 발 물러서 보면 중간 매핑 테이블 자체가 불필요해질 수 있는 경로가 있습니다.

현재 파이프라인:

사용자 자연어 → [Lexicon으로 θ-role 매핑] → Intent IR → dispatch

LSP가 있으면 가능한 파이프라인:

사용자 자연어 → LLM이 MEL action을 직접 읽고 Intent JSON 생성 → dispatch

MEL LSP (Language Server Protocol)가 있으면 LLM(Claude Code, Cursor 등)이:

• 자동완성으로 존재하는 action/field만 사용
• 저장할 때마다 Diagnostic 피드백으로 자기 수정
• hover로 action 시그니처를 확인하면서 올바른 Intent 생성

이 경우 LLM이 MEL을 직접 이해하고 Intent를 생성하므로, θ-role이라는 중간 추상화 없이도 자연어 → Intent 변환이 가능합니다. TaskFlow Phase 3에서 이미 검증된 패턴입니다 — LLM이 DomainSchema의 action 목록을 읽고 Intent JSON을 직접 생성했고, friction 0건이었습니다.

Lexicon-gen과 LSP는 상호 배타적이 아닙니다. 하지만 우선순위를 판단할 때:

• LSP는 MEL 작성 DX 전체를 개선하면서, LLM의 MEL 직접 활용도 가능하게 함
• Lexicon-gen은 Intent IR 파이프라인 한 경로만 자동화

LSP가 더 넓은 문제를 해결합니다. Lexicon-gen은 LSP가 불가능한 환경(LLM 없이 규칙 기반으로 Intent를 생성해야 하는 경우)에서 여전히 가치가 있지만, Manifesto의 "AI-native" 비전에서는 LSP가 더 근본적인 투자입니다.

[eggplantiny]

리뷰 반영

1. 패키지 경계 — 동의

generateLexicon을 compiler에 넣는 것은 ADR-001 위반. compiler는 "MEL → DomainSchema" 변환만 담당하고, DomainSchema 소비자 도구는 별도 패키지여야 합니다.

수정된 제안:

// compiler는 기존 역할만
import { compileMelDomain } from '@manifesto-ai/compiler';
const { schema } = compileMelDomain(melText);

// lexicon 생성은 별도 패키지 또는 codegen 플러그인
import { generateLexicon } from '@manifesto-ai/lexicon-gen';
const lexicon = generateLexicon(schema);

2. Lexicon vs LSP — 우선순위 재고

LSP가 더 넓은 문제를 해결합니다.

동의합니다. MEL LSP가 있으면:

• LLM이 MEL action을 직접 읽고 Intent 생성 (θ-role 중간 추상화 불필요)
• 자동완성 + 진단 피드백으로 자기 수정 루프
• MEL 작성 DX 전체 개선

다만 TaskFlow에서 검증된 것 중 Lexicon과 무관하게 필요한 부분이 있습니다:

• Resolver (날짜 계산, "그 작업" 참조 해석) — LSP와 독립적으로 필요
• Lower (IR → IntentResult 변환) — LLM이 MEL action을 직접 출력하면 불필요해질 수 있음

결론: 이 이슈의 범위를 @manifesto-ai/lexicon-gen 별도 패키지로 조정하되, MEL LSP 이슈를 별도로 생성하여 두 경로를 병렬로 검토하는 것이 맞다고 봅니다.