Metis-agent: Instructions file for Codex

This project implements the Metis code agent application, which is written in the Cangjie programming language.

The default working language for this project is Cangjie. New runtime code, tests, examples, and project-local automation should use Cangjie unless the user explicitly asks for another language or an existing non-Cangjie subsystem requires matching its language.

Project directories must keep a clear boundary: production source code belongs under src/, documentation belongs under docs/, and automated tests, fixtures, and fake services belong under test/ or the repository's established test directory. Do not mix production code, documentation, and test fixtures in the repository root.

Use context7 query Cangjie Syntax by /websites/cangjie-lang_cn_1_0_0 /dyingchinese/cangjie-stdx libraryId.

Introduction of Cangjie

Cangjie is a recently introduced programming language. We briefly describe the syntax of Cangjie below.

Function definition

Use func to define a function, input parameter and return value may have type annotations. Some parameters may be named (indicated with ! sign). E.g.

func foo(a: Int64, b!: Int 64 = 0)

Function call

In function call, the positional parameters are passed in first, without specifying the parameters name. The named parameters follow in any order, where the parameter name must be specified. Parameter with default values need not be specified. E.g.

foo(3)
foo(3, b: 2)

Variable declaration

Variable declarations use either let or var. Variables declared using let are immutable (cannot be assigned after initialization). Variables declared using var can be assigner again within the function.

Number types

The primitive types for numbers include:

• Signed integers: Int8, Int16, Int32, Int64, IntNative
• Unsigned integers: UInt8, UInt16, UInt32, UInt64, UIntNative
• Floating points: Float16, Float32, Float64(Float literals must have a ., e.g. 4 should be written as 4.0 to be Float type.)