📘 TECHNICAL SPECIFICATION & MANUAL

Dokumentasi aliffLang v8.2

Spesifikasi rasmi bahasa pengaturcaraan ejen AI deklaratif bertaip ketat, piawaian EBNF RFC-001, dan seni bina sistem perusahaan.

📜

1. Tatabahasa Formal EBNF (RFC-001)

aliffLang mematuhi tatabahasa formal yang deterministik bagi membolehkan pengimbas leksikal (lexer) dan penghurai (parser) membina pepohon sintaks abstrak (AST) tanpa kekaburan.

Program         ::= ( Directive | Comment | EmptyLine )* ;
Directive       ::= Tag ':' Whitespace Value ;
Tag             ::= '@' Identifier ;
Identifier      ::= [A-Z_][A-Za-z0-9_]* ;

Value           ::= StringLiteral | ArrayLiteral | ObjectLiteral | Expression ;
StringLiteral   ::= '"' [^"]* '"' | [^\n]+ ;
ArrayLiteral    ::= '[' ( Value ( ',' Value )* )? ']' ;
ObjectLiteral   ::= ' KeyValuePair )* )? ' ;
KeyValuePair    ::= Identifier ':' Value ;

Comment         ::= '#' [^\n]* ;

🏛️

2. Taksonomi 7 Lapisan Fungsian

Struktur sintaks dibahagikan kepada 7 lapisan bagi memastikan pengasingan tanggungjawab (*Separation of Concerns*) dan ketahanan keselamatan:

LAPISAN 1: Teras & Identiti

Menentukan nama sistem, peranan utama, laluan fail tempatan, polisi dwi-bahasa dan format output.

@B: @P: @WK: @L: @F:

LAPISAN 2: Keselamatan & Guardrails

Sekatan ketat anti-jailbreak, pematuhan mandat statutori (LHDN/PDPA), dan ujian evaluasi sebelum deploy.

@X: @COMPLIANCE: @EMPIRICAL: @TEST: @E:

LAPISAN 3: Logik & Aktuari

Formula matematik, susut nilai masa (0.05%/h), skema bertaip ketat dan urutan langkah keputusan.

@K: @ACTUARY: @FLOW: @SCHEMA: @SIMULATE:

LAPISAN 4: Alatan, MCP & Dispatch

Integrasi API, pelayan MCP (Notion, Cloudflare), pautan saluran mesej, dan kunci idempotency.

@T: @MCP: @PLUGIN: @DISPATCH: @STATE_LOCK:

LAPISAN 5: Data & Memori

Pangkalan data SQLite/D1, simpanan tepi Cloudflare KV/R2, katalog produk dan ingatan semantik.

@DB: @KV: @M: @MEMORY:

LAPISAN 6 & 7: UI & Swarm

Penyesuai persona antaramuka, dek pembentangan slaid, sasaran stack dan konsensus swarm berbilang ejen.

@PERSONA_UI: @SLIDE_DECK: @STACK: @SWARM:

🧬

3. Sembilan Kemahiran Lanjutan (Extension Skills)

Direktif lanjutan untuk memperkukuh keupayaan logik bersyarat, perakaunan kos token, dan pengauditan keselamatan:

@CONDITION:

Pelaksanaan bersyarat berasaskan keadaan semasa (*Runtime Decision Logic*).

@ROLLBACK:

Pemulihan automatik jika tindakan operasi kritikal gagal dilaksanakan.

@FEEDBACK_LOOP:

Sistem pemerhatian corak aktiviti untuk menjana kemahiran baharu secara autonomi.

@COST_MODEL:

Perakaunan kos komputasi dan had bajet token untuk setiap panggilan swarm.

@PERMISSION:

Autorisasi berasaskan peranan (RBAC) dan laluan eskalasi kelulusan.

@TIMEOUT:

Penguatkuasaan had masa keputusan dengan tindakan kecemasan (*default-deny*).

@TELEMETRY:

Pemantauan metrik anomali, kaunter tindakan, dan penggera prestasi sistem.

@CACHE:

Simpanan sementara keputusan untuk mengelakkan pengiraan semula berulang.

@AUDIT_TRAIL:

Log jejak tindakan kriptografik SHA-256 yang mematuhi statutori SOC2 & PDPA.

🛠️

4. Toolchain Pembangun Rasmi (`aliff` CLI)

Toolchain rasmi aliffLang menyediakan kit pembangun lengkap untuk kompilasi, semakan kualiti, dan format:

aliff build <file.aliff>

Mengkompilasi kod deklaratif terus kepada fail XML Baku Enterprise.

aliff lint <file.aliff>

Penganalisis statik AST untuk mengesan ralat skema & keselamatan.

aliff fmt <file.aliff>

Memformat kod dengan enjin GONE (Zero Token Waste).

aliff test <file.aliff>

Menjalankan ujian unit evaluasi @TEST: dan anti-jailbreak.