hakorune/docs/design/aot-plan-v1.md

AOT-Plan v1 Schema (Phase 15.1)

Status: draft-frozen for Phase 15.1 (extensions via extensions only)

• version: string, must be "1"
• name: optional plan/module name
• functions: array of PlanFunction
• externs: optional array (reserved; not required in 15.1)
• exports: optional array (reserved)
• units: optional array (reserved)
• extensions: optional object for forward-compatible keys

PlanFunction

• name: string
• params: array of { name: string, type?: string } (informational in 15.1)
• return_type: optional string; one of: integer, float, bool, string, void (or omitted → Unknown)
• body: optional tagged object
  • kind = "const_return": { value: any-json (int/bool/float/string) }
  • kind = "empty": returns default 0 with Unknown type (15.1 importer behavior)

Notes

• 15.1 importer does not emit object code; it constructs MIR13 skeletons only.
• If return_type is omitted, importer uses Unknown to keep VM dynamic display.
• extensions is a free-form map; the importer ignores unknown keys.

Example

{
  "version": "1",
  "name": "mini_project",
  "functions": [
    { "name": "main", "return_type": "integer", "body": { "kind": "const_return", "value": 42 }},
    { "name": "greet", "return_type": "string",  "body": { "kind": "const_return", "value": "hi" }}
  ]
}