Tata bahasa URI dan inventaris format-string
Entitas Aggrega saling merujuk melalui string URI yang muncul di beberapa posisi penulisan yang berbeda. Bentuk URI yang sama (core/postgres:1.0.0) muncul dalam lima konteks jenis entitas atau lebih, dengan compiler menyimpulkan jenis entitas dari posisi skema, bukan dari sigil atau prefiks. Penulis yang membaca atau memelihara file YAML harus mengingat aturan interpretasi berbasis posisi untuk mengetahui apakah core/postgres:1.0.0 merujuk ke tipe Component, modul Aggregate, Recipe, FeatureRecipe, atau plugin Wasm.
Halaman ini menghimpun tata bahasa URI di semua posisi, aturan prioritas untuk kunci type: yang berversi dan tidak berversi pada tingkatan pemetaan Manifest, aturan inferensi singkatan URI OCI, serta inventaris format-string yang lebih luas di seluruh korpus (sintaks templat Go, fungsi Sprig, deklarasi JSON Schema 2020-12, JSONPath, pola glob, regex SemVer). Penulis yang perlu mengetahui “apa yang dilakukan Aggrega dengan string ini?” seharusnya menemukan jawabannya di sini.
Inferensi jenis entitas berdasarkan posisi
String URI yang sama membawa makna jenis entitas yang berbeda bergantung pada tempat kemunculannya dalam skema. Tabel di bawah ini mencantumkan setiap posisi tempat Aggrega mengharapkan URI referensi entitas, beserta jenis entitas yang diinferensikan:
| Position | Jenis entitas yang diinferensikan | Ekspansi jalur OCI |
|---|---|---|
Aggregate.spec.components.<id>.type | Component | /component/{publisher}/{category}/{name} |
Aggregate.spec.subsystems.<name>.components.<id>.type | Component (sama seperti components — subsistem adalah pengelompokan komponen) | /component/{publisher}/{category}/{name} |
Aggregate.spec.aggregates.<id>.type | Aggregate (modul sub-aggregate) | /aggregate/{publisher}/{name} |
Aggregate.spec.components.<id>.features.<id>.type | Feature | /feature/{publisher}/{name} |
Aggregate.spec.components.<id>.features.<id>.type | Feature (kredensial — berlabel feature.aggrega.ai/kind: secret) | /feature/{publisher}/{name} |
Manifest.spec.mappings.components.type.<key> | Component (URI yang digunakan sebagai kunci pencarian); nilainya adalah URI Recipe | kunci: /component/; nilai: /recipe/{provider}/{name} |
Manifest.spec.mappings.components.name.<id> | Recipe (pengikatan override granular) | /recipe/{provider}/{name} |
Manifest.spec.mappings.features.type.<key> | Feature (kunci pencarian); nilainya adalah URI FeatureRecipe | kunci: /feature/; nilai: /featurerecipe/{provider}/{name} |
Manifest.spec.mappings.features.name.<id> | FeatureRecipe (pengikatan override granular) | /featurerecipe/{provider}/{name} |
Manifest.spec.mappings.features.annotations.<key>.feature | Feature (terikat anotasi) | /feature/{publisher}/{name} |
Recipe.spec.implements | Component (kontrak antarmuka) | /component/{publisher}/{category}/{name} |
FeatureRecipe.spec.implements | Feature (kontrak antarmuka) | /feature/{publisher}/{name} |
Component.spec.extends / Feature.spec.extends | Component / Feature (induk dalam rantai pewarisan) | /component/{publisher}/{category}/{name} atau /feature/{publisher}/{name} |
Manifest.spec.extends | Manifest (induk dalam rantai pewarisan pemetaan) | bukan posisi URI — jalur relatif, atau metadata.name polos dari Manifest yang berada di samping Release |
Release.spec.extends | Release (induk dalam rantai pewarisan) | bukan posisi URI — jalur relatif ke file Release, dan tidak ada bentuk lain |
Release.spec.aggregate | Aggregate (target deployment Release) | /aggregate/{publisher}/{name} |
Release.spec.manifest | Manifest (lockfile pemetaan Release) | bukan posisi URI — jalur relatif, atau metadata.name polos dari Manifest yang berada di samping Release |
FeatureRecipe.spec.pipeline.<step>.plugin | Plugin Wasm | /plugin/{pluginType}/{name} |
Tiga posisi dicantumkan karena penulis menggunakannya dengan mengharapkan sebuah URI, padahal ketiganya bukan posisi URI. Manifest dan Release adalah dokumen sisi deployment yang ditulis berdampingan, bukan entitas yang diindeks katalog, sehingga baik extends: pada keduanya maupun manifest: pada Release mana pun tidak di-resolve terhadap katalog atau registry. manifest: milik Release menyebut sebuah file, atau metadata.name polos dari Manifest yang berada di samping Release. Pada kedua posisi extends:, nilainya menyebut sebuah file, dan koordinat registry yang ditulis pada salah satunya ditolak dengan bentuk yang diterima disebutkan dalam diagnostik. Kedua posisi extends: juga tidak ditulis dengan cara yang sama — Manifest juga menerima metadata.name polos dari Manifest yang berada di samping Release, sedangkan Release hanya menerima jalur relatif. Lihat entities/release.md untuk bentuk Release dan errors/fatal-halts.md untuk isi setiap penolakan.
Aturan inferensinya: posisi dalam skema YAML menentukan jenis entitas. Tidak ada penanda permukaan (sigil, prefiks, anotasi tingkat skema) yang memberi tahu penulis jenis entitas mana yang dirujuk oleh suatu field type:. Penulis mengingat aturan berbasis posisi ini saat membaca YAML; perkakas (pelengkapan di editor, aggrega inspect) membaca aturan yang sama untuk menampilkan saran yang spesifik untuk jenis entitas.
Dua bentuk URI — plugin dengan koordinat turunan vs entitas katalog dengan jenis di metadata
URI entitas katalog tidak membawa sigil jenis (bagian sebelumnya). URI Plugin adalah kebalikannya yang disengaja: URI plugin memang menuliskan segmen pengklasifikasi — jenis soketnya — langsung di dalam path. Kedua keluarga referensi ini sengaja dibaca secara berbeda, dan dengan mengetahui keluarga mana yang memiliki suatu URI, Anda tahu di mana harus mencari klasifikasinya.
Koordinat plugin diturunkan dari tipe plugin. Referensi plugin berbentuk oci://hub.aggrega.ai/plugin/<pluginType>/<name>. Koordinat ini diturunkan: segmen <pluginType> dan <name> polos berasal dari blok pengalamatan plugin — metadata.pluginType dan metadata.name — yang disusun menjadi jalur. Soket tidak dikodekan ke dalam nama sebagai jalur; metadata.name bersifat polos. Koordinat turunan ITULAH kunci registry (dan kunci set plugin tertanam), sehingga registry mengorganisasi plugin berdasarkan soket. Plugin inti di-resolve ke koordinat seperti plugin/provider/helm, plugin/linter/publishing, dan plugin/parser/yaml — masing-masing merupakan gabungan metadata.name polos (helm, publishing, yaml) dengan metadata.pluginType-nya (provider, linter, parser). Segmen <pluginType> tepat merupakan tipe soket plugin: <name> polos yang sama di bawah pluginType yang berbeda adalah plugin yang berbeda, karena koordinat turunannya — dan karenanya identitasnya — berbeda. Untuk taksonomi soket lengkap yang menjadi acuan klasifikasi segmen <pluginType>, lihat entities/plugin.md.
Entitas katalog membawa jenisnya di metadata. Referensi yang ditulis berbentuk <publisher>/<category>/<name> (misalnya, core/datastore/postgres). kind: entitas berada di dalam file; jenis entitas URI disimpulkan dari posisi skema, sesuai Inferensi jenis entitas berdasarkan posisi di atas. Jalur diorganisasi berdasarkan kategori, bukan berdasarkan jenis: sebuah Component membawa segmen kategori (core/datastore/postgres); sebuah Recipe atau FeatureRecipe membawa kapabilitas render-nya sebagai segmen pertama (helm/postgres); jenis lainnya berbentuk datar <publisher>/<name>. Tidak ada bagian jalur yang menuliskan jenis entitas.
Mengapa kedua bentuk berbeda. Plugin diorganisasi di registry berdasarkan soket, sehingga segmen soket adalah kunci registry yang alami dan ada di setiap URI plugin. Entitas katalog diorganisasi di registry berdasarkan kategori, sehingga kategorilah — bukan jenisnya — yang dituliskan oleh jalur. Karena itu, sebuah URI memberi tahu Anda soket sebuah plugin hanya dari jalurnya, tetapi memberi tahu jenis sebuah entitas katalog hanya setelah Anda membaca file-nya (jenis berada di metadata, dan posisi menyediakannya di tempat referensi). Asimetri ini disengaja: jalur setiap keluarga mencerminkan cara keluarga tersebut diorganisasi di registry, bukan satu tata bahasa seragam yang dipaksakan pada keduanya.
Bentuk URI — berversi vs tanpa versi
Setiap posisi URI di atas menerima referensi dalam salah satu dari tiga bentuk — tanpa versi, atau dipatok setelah titik dua dengan versi persis atau rentang caret:
| Bentuk | Contoh | Semantik |
|---|---|---|
| Tanpa versi | core/postgres | Diselesaikan menjadi “versi apa pun” atau “terdaftar terbaru”, bergantung pada semantik resolusi posisi tersebut |
| Patokan persis | core/postgres:1.0.0 | Mematok ke satu versi tertentu. Versinya adalah versi semantik, bentuk yang diambil oleh metadata.version setiap entitas |
| Patokan caret | core/postgres:^1.0.0 | Memilih versi tertinggi yang kompatibel dengan versi yang disebut — untuk ^1.0.0, pada atau di atas 1.0.0 dan di bawah 2.0.0 |
Patokan adalah teks setelah titik dua terakhir pada referensi, dan hanya jika teks tersebut tidak mengandung /. Karena itu, referensi ke host registry dengan port — localhost:5000/core/postgres — tidak membawa patokan: teks setelah titik dua port melanjutkan referensi.
Patokan yang bukan salah satu dari bentuk ini — caret yang teksnya tidak terbaca sebagai rentang versi (core/postgres:^garbage), atau patokan persis yang bukan versi semantik (core/postgres:1.x, core/postgres:1.0, core/postgres:v1.0.0) — sama sekali tidak menyebut versi. Ketika sebuah perintah menyelesaikan referensi semacam itu dan referensi tersebut tidak terselesaikan, penolakannya menyebut referensi, patokan, dan ketiga bentuk di atas, alih-alih melaporkan entitas atau versi yang tidak dimiliki katalog; diagnostik ini dijelaskan di errors/fatal-halts.md pada “A version pin is none of the forms a pin takes (Patokan versi bukan salah satu dari bentuk yang diambil patokan)”. Patokan hanya dinilai di sana, sehingga patokan yang salah bentuk tidak pernah mengubah referensi mana yang terselesaikan, dan patokan yang benar bentuknya tetapi tidak dipenuhi versi mana pun yang tersedia dilaporkan sebagai demikian. Tidak ada skema yang menyatakan tata bahasa patokan, sehingga patokan yang salah bentuk dilaporkan ketika sesuatu menyelesaikan referensi — aggrega validate, aggrega pull, aggrega build — bukan ketika file dimuat.
Bentuk-bentuk ini hidup berdampingan dalam posisi yang sama. Penulis memilih berdasarkan apakah mereka memerlukan pematokan versi atau fleksibilitas versi. Tingkat mappings.{components,features}.type pada Manifest mendukung kedua varian sebagai kunci kamus yang berbeda dengan prioritas berversi-mengalahkan-tanpa-versi — kunci berversi (core/api-server:1.0.0) didahulukan atas kunci tanpa versi (core/api-server) ketika keduanya cocok dengan pencarian yang sama. Kedua varian tidak saling eksklusif; keduanya dapat berada dalam peta type: yang sama dan resolver memilih yang paling spesifik. Dispatch Provider mengalir dari bidang spec.capability milik Recipe yang telah diselesaikan, sehingga Manifest hanya memetakan sebuah tipe ke sebuah Recipe, tidak lebih.
Untuk rezim konsumsi versi per entitas (entitas mana yang bidang versinya benar-benar dikonsumsi oleh dispatch resolusi vs provenans deskriptif), lihat vocabulary/inheritance-and-interface.md “Konsumsi versi lintas entitas”.
Referensi ke Component, Feature, Aggregate, atau Plugin juga menerima rentang caret (core/postgres:^1.0.0), dan bentuk apa pun yang diambilnya, referensi tersebut memilih versi tertinggi yang memenuhi di antara versi yang dimiliki katalog, dengan satu aturan yang diterapkan setiap perintah — lihat version-resolution.md. Untuk pencocokan implements: tiga bentuk, yang merupakan pemeriksaan konsistensi pada pemetaan alih-alih pemilihan, lihat 10-status.md “Pencocokan versi”.
Identitas, bukan lokasi
Referensi entitas kanonis — termasuk referensi plugin — adalah sebuah identitas, bukan lokasi: referensi tersebut menyebutkan apa entitas itu, tidak pernah di mana entitas itu saat ini berada.
Identitas tersebut polos dan bebas host. Identitas tidak memuat host registry; host adalah koordinat resolusi yang disediakan oleh konfigurasi melalui default_registry dan diikat pada saat resolusi. Memindahkan registry, atau mencerminkan entitas yang sama di tempat lain, merupakan perubahan konfigurasi — referensi yang menyebutkan entitas tersebut tidak tersentuh.
Identitas tersebut juga bebas versi. Sebuah referensi dapat memuat pin versi opsional (:<version> atau :^<version>) untuk membatasi versi mana yang memenuhinya, dan setiap Release mencatat versi hasil resolusi yang tepat sebagai pin dalam lockfile-nya, tetapi versi disediakan di samping identitas, bukan ditanamkan ke dalamnya.
Pada saat resolusi, compiler menggabungkan identitas polos dengan host yang dikonfigurasi dan versi yang di-pin untuk mencapai byte konkret. Karena keduanya disediakan secara terpisah, referensi yang sama dapat di-resolve terhadap registry lain atau versi pin lain tanpa mengubah sumber yang menyebutkannya.
Inferensi singkatan URI OCI
Penulis tidak harus menuliskan setiap URI sebagai URI OCI yang sepenuhnya memenuhi syarat. Kompiler menerapkan empat aturan inferensi ortogonal untuk memperluas bentuk penulisan singkat menjadi URI OCI kanonis pada saat resolusi. Aturannya:
Aturan 1 — Domain bawaan
Setiap URI yang tidak memiliki domain diberi awalan default_registry yang dikonfigurasi dalam .aggrega-config.yaml (bawaan: hub.aggrega.ai/).
# Shorthandtype: core/postgres:1.0.0
# Equivalent canonical formtype: hub.aggrega.ai/component/core/postgres:1.0.0Aturan 2 — Ekspansi entitas kontekstual
Kompiler menambahkan segmen jenis entitas yang benar berdasarkan posisi skema. Pemetaannya sama dengan tabel inferensi posisi di atas (/component/, /aggregate/, /recipe/, /featurerecipe/, /feature/, /plugin/).
# Same string, two positions, two expansionsAggregate.spec.components.foo.type: core/postgres:1.0.0# → hub.aggrega.ai/component/core/postgres:1.0.0
Manifest.spec.mappings.components.type."core/postgres:1.0.0": helm/postgres:1.0.0# Key: hub.aggrega.ai/component/core/postgres:1.0.0# Value: hub.aggrega.ai/recipe/helm/postgres:1.0.0Aturan 3 — Presedensi tiga tingkat
Sebelum menerapkan inferensi OCI, kompiler meresolusi URI melalui Model Resolusi Entitas Tiga Tingkat yang didokumentasikan di architecture/13-catalog-and-registry.md:
- Jalur lokal — untuk dokumen yang disebut oleh Release dan Manifest-nya.
aggregate,manifest, atauextendsmilik Release, atauextendsmilik Manifest, yang ditulis dengan prefiks./atau../dibaca sebagai file relatif terhadap direktori Release itu sendiri; inferensi OCI tidak dijalankan. Tidak ada posisi lain yang menerima jalur:type, kunci atau nilai mapping Manifest,implements, ataupluginpipeline yang ditulis sebagai./…tidak menyebut entitas apa pun dan menghentikan build. Entitas yang ditulis secara lokal ditempatkan di bawahcatalog/di root workspace atau di direktori yang dicantumkanworkspace.catalog_dirs, dan di-resolve berdasarkan namanya melalui tingkat workspace dan cache. - Workspace dan cache — Tumpukan pencarian katalog workspace, lalu cache. Direktori
catalog_dirs:milik workspace.aggrega-config.yaml— atau, untuk Release yang oleh konfigurasi diberi direktorinya sendiri di bawahworkspace.releases, direktori milik Release tersebut — dicari sesuai urutan penulisannya, dan direktoricatalog/di root workspace dicari terakhir — setelah setiap entri yang terdaftar, dan hanya jika direktori itu ada. Kecocokan di mana pun dalam tumpukan memotong inferensi OCI. Jika tidak ditemukan,artifact_cache_dirkemudian diperiksa, yang menyimpan hasil penarikan dari registry sebelumnya. - Registry. Ketika tingkat workspace dan cache tidak menemukan kecocokan, aturan inferensi OCI diterapkan dan referensi diambil dari registry jarak jauh oleh
aggrega pull, atau oleh build yang dijalankan dengan--auto-pullatau pengaturanauto_pullmilik workspace; build tanpa keduanya hanya membaca apa yang dipatok oleh lockfile-nya.
Kaskade ini memungkinkan sebuah proyek memadukan dokumen yang disebut Release melalui jalur (tingkat jalur lokal) dengan konten katalog hasil vendoring dan konten katalog lokal workspace (tingkat workspace dan cache) serta konten registry yang diambil dari jarak jauh (tingkat registry), dan referensi entitas ditulis dengan cara yang sama, tingkat mana pun dari dua yang terakhir yang memuat entitas tersebut.
Jika catalog_dirs: mencantumkan lebih dari satu direktori, daftar tersebut merupakan tumpukan presedensi yang pertama menang yang berurutan: identitas entitas yang ada di lebih dari satu direktori terdaftar diresolusi ke direktori yang paling awal dicantumkan, dan kemunculan berikutnya dibayangi (ditimpa, bukan error) — sehingga sebuah proyek dapat menempatkan direktori katalognya sendiri di depan direktori bersama dan menimpa entitas berdasarkan identitas, sementara sisanya diteruskan. Penimpaan ini dilaporkan dalam detail resolusi. Dua file yang mengklaim identitas yang sama di dalam satu direktori tetap merupakan kesalahan penulisan yang menghentikan pemuatan.
Direktori catalog/ di root workspace berada di akhir tumpukan tersebut, bukan di awalnya, sehingga apa pun yang dicantumkan proyek akan menang atasnya saat terjadi tabrakan, dan mencantumkan satu direktori yang tidak terkait tidak pernah menghentikan pembacaannya. Direktori ini dilewati jika entri yang terdaftar sudah mencakupnya — penelusuran direktori terdaftar bersifat rekursif, sehingga tumpukan yang menyebut root workspace sudah membacanya. Menghilangkan catalog_dirs: dan menuliskannya sebagai daftar kosong adalah pernyataan yang berbeda: jika dihilangkan, workspace tetap membaca catalog/; jika ditulis sebagai [], workspace tidak membaca katalog lokal sama sekali, dan begitulah cara workspace menyatakan bahwa ia tidak memilikinya.
Aturan 4 — Penanganan versi
URI dapat menyertakan atau menghilangkan segmen versi. Penanganan versi bergantung pada posisi resolusi (resolusi tingkat Manifest, pencocokan implements:, impor sub-aggregate) sesuai aturan konsumsi versi milik posisi tersebut. Lihat inheritance-and-interface.md “Cross-entity version consumption” untuk semantik versi per entitas.
Inventaris format-string
Selain string URI, permukaan penulisan Aggrega memuat beberapa konvensi format-string yang berbeda. Penulis yang menulis atau membaca berkas YAML menjumpai format berikut di berbagai posisi:
| Format | Tempat penulisan | Divalidasi oleh |
|---|---|---|
Templat Go ({{ .field }}) | Recipe valuesMapping: / workload: / artifacts: / provides: / locals: / source:; FeatureRecipe injectMapping: / pipeline with:; interpolasi Aggregate parameters:; Release directory: / subDirectory: | Parser templat Go pada waktu evaluasi; aturan ketersediaan per situs di templates/expansion-matrix.md |
Referensi fungsi Sprig ({{ default 1 .v }} dll.) | Permukaan yang sama dengan templat Go | FuncMap Sprig v3 didaftarkan saat inisialisasi mesin templat; daftar lengkap helper di templates/sprig-functions.md |
| JSON Schema 2020-12 (bentuk ringkas atau lengkap) | Konten schema: pada Component / Feature (atau $ref: ke entri SchemaLibrary) | Validator JSON Schema saat entitas dimuat selama resolusi |
| JSON Pointer (RFC 6901) | Kunci Recipe locals.<*_path>: (volumes_path, containers_path, dll.); rujukan keluaran langkah FeatureRecipe pipeline:; payload JSONPatch plugin Wasm | Dasar RFC 6901 sesuai kontrak plugin Wasm; dideklarasikan di plugins/plugin-contract.md |
| Regex SemVer | Bidang metadata.version pada setiap entitas | Regex JSON Schema ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-...)?$ per skema entitas |
Pin versi (:<version>, :^<version>) | Segmen versi dari rujukan entitas, pada setiap posisi URI di atas | Compiler, saat meresolusi rujukan: pin eksak adalah versi semantik dan rentang pin caret dapat diurai, dan pin yang salah bentuk ditolak dengan kondisinya sendiri — lihat bentuk URI di atas |
| Path sistem berkas | Path relatif katalog (mis., entri catalog_dirs: pada .aggrega-config.yaml); path berkas Recipe $import: di workload: / artifacts: / valuesMapping: | Dibaca sebagaimana ditulis saat resolusi — entri catalog_dirs: relatif terhadap file konfigurasi yang mendeklarasikannya, path $import: relatif terhadap direktori entitas itu sendiri; tidak ada glob yang diekspansi, sehingga * menyebut file atau direktori dengan nama tersebut |
| Ekspresi pemilih label | Component.spec.usesSchema.<socket>.selector; Feature appliesTo: / appliesToAnyOf: | Parser pemilih Aggrega di tempat pemilih dievaluasi; tata bahasa pemilih didokumentasikan di vocabulary/modifier-system.md |
Bentuk kunci anotasi (<namespace>/<name>) | Kunci metadata.annotations; kunci Manifest features.annotations; kaskade anotasi batas | Regex JSON Schema per entitas; disiplin prefiks cadangan di vocabulary/labels-and-annotations.md |
Nama Provider, opsional dengan versi yang dipatok (helm, helm:^1.0.0) | Recipe.spec.capability; FeatureRecipe.spec.capability | Pencarian dispatch Provider; pin yang tidak dipenuhi versi plugin mana pun menghentikan build |
Kunci pengiriman inject (env.<KEY>, file.<path>, arg.<flag>) | Blok Aggregate inject:; keluaran FeatureRecipe injectMapping: | Skema inject di vocabulary/topology-triad.md |
Setiap format memiliki tata bahasanya sendiri, validatornya sendiri, dan bentuk pelaporan galatnya sendiri. Penulis yang mengalami galat penguraian format-string membaca referensi per format untuk aturan sintaksisnya.
Editor melaporkan galat-galat ini selagi Anda menulis: aggrega serve memvalidasi setiap dokumen yang dikirim kepadanya terhadap skema jenisnya dan mengembalikan putusan yang sama dengan yang akan diberikan build (lihat cli/aggrega-serve.md “Validasi langsung”), dan aggrega scaffold membuat draf dokumen awal dari jenis apa pun.
Rujukan silang
entities/manifest.md— resolusi tingkat pemetaan Manifest + bagian URI singkat yang peka konteks.entities/plugin.md— taksonomi soket Plugin + bentuk URIplugin/<socket>/<name>yang mengodekan soket.architecture/13-catalog-and-registry.md— model resolusi entitas tiga tingkat + taksonomi OCI kanonis untuk distribusi katalog.vocabulary/inheritance-and-interface.md— pengikatan antarmukaimplements:+ konsumsi versi lintas entitas.templates/expansion-matrix.md— aturan ketersediaan per lokasi templat untuk string format templat Go.templates/sprig-functions.md— inventaris helper Sprig v3 yang terhubung ke mesin templat.vocabulary/topology-triad.md— konvensi kunci pengiriman inject; tata bahasa ekspresi selektor ada divocabulary/modifier-system.md.vocabulary/labels-and-annotations.md— bentuk kunci anotasi dan disiplin prefiks yang dicadangkan.10-status.md— status kesiapan untuk pencocokan tiga bentukimplements:dan untuk perintah CLI yang me-resolve referensi.