AOCI-CODE

AOCI-CODE

Tüm kod tabanınızın kalıcı, Git ile sürümlenmiş haritası — kodlama ajanınız tarafından yazılır, yerel bir MCP sunucusu tarafından yönetilir. Ajanlar onu bir kez okur ve sistemi bilir; her görevde depoyu yeniden okumak yerine.

🇺🇸 English | 🇨🇳 简体中文

Ne yapar

Konuyu kaybetmeden büyük sistemler kurun. Codex, Claude Code, Cursor, OpenCode ve benzeri ajanlarda, ajanınız her göreve tüm sistemi zaten bilerek başlar: her dosyanın ne için olduğunu, neye bağlı olduğunu ve neyin bozulmaması gerektiğini bilir. Her istek için kod tabanını aramayı ve yeniden okumayı bırakır. Profesyonel geliştirici olmayan kişiler kendi sistemleri üzerinde yinelemeye devam edebilir; profesyonel geliştiriciler tüm sistemi bir ajana devredip dikkatlerini mimari ve tasarıma verebilir.

Mevcut bir sistemi tek adımda devralın. Ajanı yaklaşık 500.000 satıra kadar mevcut bir kod tabanına yönlendirin ve dizini oluşturmasını isteyin. Her alanı ne kadar iyi bildiğini bildirir, ardından geliştirmeye oradan devam eder. Pratik sınır satır sayısı değil, dizinin boyutudur: 700.000 satırlık ticari bir sistem bugün bu şekilde, yaklaşık 300K token'lık bir dizinle geliştirilmektedir.

Sıfırdan başlamadan kişileri, ajanları veya konuşmaları değiştirin. Dizin, kodun yanında depoda yaşar ve Git tarafından sürümlenir. Bir proje el değiştirdiğinde, ajan değiştirdiğinde veya yeni bir konuşma açıldığında, dizinin bir kez okunması kaldığı yerden devam eder.

İlk dizinden sonra bakım otomatiktir. MCP sunucusu kod değişikliklerini algılar ve güncellenmesi gereken girdileri bildirir. Ajan her görevi bitirirken bunları doldurur, böylece dizin güncel kodla eşleşir ve bakım için hiç durmazsınız.

Nasıl görünür

Dosya başına bir satır, model tarafından gerçek kaynaktan yazılır. Bu, bu deponun kendi dizininden gerçek bir girdidir:

atomic.go[CG9L]: F:Provides durable replace CAS, create CAS, atomic writes, and no-clobber recovery moves | R:code:internal/fs/atomic_exchange_linux.go,code:internal/fs/atomic_exchange_windows.go,code:internal/fs/lock.go | A:AtomicWrite,AtomicWriteCAS,AtomicCreateCAS,AtomicMoveCAS | S:Native publication never degrades to an overwriting rename; on a race, unsafe type, or unverifiable bytes, preserve third-party state

F dosyanın neyden sorumlu olduğudur, R onunla birlikte okumanız gereken şeydir, A çağıranların bağlı olduğu şeydir ve S koddan çıkaramayacağınız ama yanlış yapmamanız gereken şeydir. [CG9L] etiketi dosyayı katman, alan, önem ve boyuta göre yerleştirir. Bunun gibi birkaç yüz satır tüm bir sistemi kapsar ve bir ajan bunları tek geçişte okuyabilir. Girdi biçimi her alanı açıklar.

CodeGraph'tan farkı nedir?

• CodeGraph kodunuzu semboller ve çağrılardan oluşan bir grafiğe ayrıştırır. Ajan bir soru sorduğunda, tam kaynağı ve çağrı yollarını döndürür. Eldeki görev için hassas bir arama aracıdır.
• AOCI-CODE modelin dosya ve tablo başına bir satır yazmasını sağlar: ne için olduğu, neye bağlandığı ve neyin bozulmaması gerektiği. Ajan önce tüm dizini okur, böylece görev başlamadan önce sistemi bilir. Dizin Git'te yaşar ve kodla adım adım güncel tutulur.
• İkisini birlikte kullanın: sistemi bilmek için dizin, çalışırken tam kodu almak için CodeGraph.

Tam karşılaştırma RAG, LSP ve depo haritalarını da kapsar.

Ne beklemelisiniz

İlk dizin biraz zaman alır. Ajan yönetilen her dosyayı okur ve dosya başına bir girdi yazar: model ve ajanın hızına bağlı olarak 200.000 satır kod başına yaklaşık bir saat. Toplu olarak çalışır ve kesintiye uğrarsa kaldığı yerden devam eder.

Veritabanınız var mı? Onu da dizinleyin. MySQL ve PostgreSQL desteklenir, kısıtlamalarla birlikte openGauss 6.0.5 de. MySQL, 5.7.6 ve sonrası anlamına gelir; MariaDB desteklenmez. Önce kod dizinini, sonra veritabanı dizinini oluşturun. Kod ve tablo düzeyinde bilgi birlikte sunulduğunda, ajan sistemi daha eksiksiz anlar.

Yalnızca yerel: sisteminizde salt okunur, İnternet yok, saklanan kimlik bilgisi yok. AOCI-CODE kaynak kodunuzu ve veritabanı tablo yapılarını okur, asla iş verilerini okumaz. Dizin dosyalarını ve kendi durumunu proje dizini içinde, ayrıca durum sayfasının kaydını kullanıcı önbellek dizininizde yazar. Asla İnternet'e erişmez ve hiçbir şey yüklemez: açtığı tek bağlantılar, katalog meta verileri için bildirdiğiniz veritabanına ve kendi geri döngü durum sayfasınadır. Veritabanı kimlik bilgileri ortam değişkeni adıyla başvurulur ve asla saklanmaz. Dizin metni, zaten kullandığınız model kanalı aracılığıyla kendi ajanınız tarafından yerel olarak yazılır; AOCI-CODE yeni bir veri çıkışı eklemez.

Hızlı başlangıç

Ajanınıza AOCI-CODE'u indirmesi ve bağlaması için aşağıdaki talimatı verin. Ajanı yeniden başlattıktan sonra dizini oluşturmak için ikinci talimatı gönderin.

AOCI-CODE project: https://github.com/aoci-spec/aoci-code

Download the latest release package for this operating system and CPU architecture from
https://github.com/aoci-spec/aoci-code/releases, and follow the installation instructions
on the Release page to verify it. If no compatible release package exists, or if I
explicitly request the latest source, build it from the official repository.

After extracting the package, place aoci (aoci.exe on Windows) at a stable absolute path.
Then use that absolute path to do the following for my project:

1. Run init to initialize AOCI and integrate MCP for the current host; if this host does
   not write project configuration (Cursor, for example), give me the configuration I
   need to paste myself
2. Run scan

   scan takes its file inventory from Git, so do not add the cognition assets
   init writes (aoci.txt, aoci.meta.txt, aoci.code.txt, AGENTS.md) to .gitignore
   or .git/info/exclude — an ignored asset is silently skipped and the index
   cannot be built. Leave the host-config ignore init writes for itself as it is.

3. Tell me to restart the agent so the newly written MCP server takes effect

Stop after those three steps and do not build the index yet — I will tell you to continue
after the restart.

Ajanı yeniden başlattıktan sonra şunu gönderin:

First confirm the AOCI MCP server is connected, then build the AOCI index for this project. When it is complete, give me the AOCI panel link.

Ajan paneli arka planda aoci ui --detach --json ile başlatır ve size bağlantıyı verir. AOCI paneli ne gösterdiğini ve diğer komutlarını açıklar.

Neden yeniden başlatma: dizin AOCI'nin MCP araçları aracılığıyla yazılır ve init komutunu çalıştıran oturum, init'nin az önce yazdığı MCP sunucusunu yüklememiştir. MCP sunucularını dinamik olarak yükleyen bir ana makine yeniden başlatmaya ihtiyaç duymayabilir; Ana makine entegrasyonu nasıl anlaşılacağını açıklar.

Projenizde bir veritabanı varsa (PostgreSQL ve MySQL desteklenir, ayrıca kısıtlı openGauss 6.0.5), onu da dizinleyin. Kaynağı Veritabanı Bilişi altında açıklandığı gibi bildirin, bağlantı dizesi ortam değişkenini ana makine ortamında sağlayın (AOCI hiçbir kimlik bilgisi saklamaz), ardından şunu gönderin:

Build the AOCI database index for this project.

Bağlam sıkıştırıldıysa veya ajanın sistem hakkındaki resmini yeniden oluşturmasını istiyorsanız şunu gönderin:

Using only AOCI, establish whole-framework cognition of this project, tell me your mastery of each area as a percentage, and whether you can take over development.

Nasıl çalışır

AOCI (AI-Oriented Cognition Infrastructure), yöntem ve protokoldür: kodlama ajanları ile yazılım sistemleri arasında bir katman. Modeller akıl yürütür, ajanlar planlar ve yürütür, AOCI ise ajanların harekete geçmeden önce okuması için kod, yapılandırma, testler ve veritabanı yapısını kapsayan güncel bir sistem tanımını tutar. AOCI-CODE bu projedir: aoci CLI, MCP sunucusu ve bunların sürdürdüğü dizin.

AOCI-CODE, bir sistemi anlamak ve değiştirmek için gerçekten önemli olanı, sembolleri ve anlamı birleştiren yoğun, düz metin bir dizine damıtır. Model bağlamı sınırlı olduğunda, bir ajan önce dizini okur, projenin temel bilgilerinin çoğunu tek geçişte alır ve ardından göreve başlar. Bu, tekrarlanan aramayı ve yeniden öğrenmeyi azaltır ve anlayışı görevler ve oturumlar arasında taşır.

• Tek seferlik bir özet değildir. Dizin sistemle birlikte evrilir ve projede kalır; burada Git ile farkını alabilir, inceleyebilir, sürümleyebilir ve geri alabilirsiniz.
• "Dosyalar nerede"den fazlasıdır. Sorumlulukları, güçlü ilişkileri, genel sözleşmeleri, işlem sınırlarını, uyumluluk kısıtlamalarını ve kod yapısından çıkarılması zor diğer şeyleri kaydeder.
• Taşınabilir. Dizin projeyle birlikte saklanır, bir modele, bir ajana veya bir oturuma bağlı değildir. Kodla hizalı olduğu sürece, herhangi bir ajan ve herhangi bir sonraki oturum, anlayışını sıfırdan yeniden oluşturmadan aynı dizini yeniden kullanabilir.
• Kod ve veritabanları birlikte. Model, veritabanı tabloları için ayrı bir tablo düzeyinde dizin oluşturabilir. Birlikte sunulduğunda, ikisi ajana sistemin daha eksiksiz bir resmini verir.

Dizin, projeyle birlikte saklanan bir dizi yönetilen düz metin dosyasıdır:

• Kök (aoci.txt) mevcut dizini neyin oluşturduğunu bildirir ve etkinleştirme giriş noktasıdır.
• Meta (aoci.meta.txt) etiket sözlüğünü, FRAS kurallarını ve yazım kısıtlamalarını tutar.
• Kod (aoci.code.txt) kod ve diğer depo varlıkları için model tarafından yazılan girdileri tutar.
• Veritabanı (aoci.database.txt) Veritabanı Bilişi etkinleştirildiğinde isteğe bağlı tablo düzeyinde girdileri tutar.

Kök, Meta ve katılan nesne Ciltleri birlikte Tüm-Dizini oluşturur. Bunların üzerindeki iş akışının üç aşaması vardır:

1. Dizini yönetim altında oluşturun. Model kaynak kodu ve kabul edilen kanıtları okur. AOCI-CODE, Yönetilen Kapsamı ve modelin index rolüyle her yönetilen nesne için yazdığı girdileri yönetir.
2. Harekete geçmeden önce okuyun. Ajan proje kurallarını, canlı kılavuzu ve mevcut Tüm-Dizini okur, ardından eldeki görev için kaynağı ve diğer kanıtları kontrol eder.
3. Doğrulanmış değişiklikten sonra bakım yapın. Kod ve testler kararlı olduğunda, proje kuralları ve MCP iş akışı ajanın etkilenen girdileri güncellemesini ve dizini aligned durumuna geri getirmesini sağlar.

Bu dosyalar depoda düz metin olduğundan, Git onları sürümler. Dizin mevcut sistem sürümüyle hizalı kaldığı sürece, herhangi bir ajan ve herhangi bir sonraki oturum aynı Tüm-Dizini okuyabilir ve yeniden kullanabilir.

Manuel entegrasyon

AOCI-CODE'u kanonik kaynaktan alın veya GitHub Releases'ten imzalı bir paket kullanın. Önceden derlenmiş bir ikili dosyayı kullanmadan önce, kurulum kılavuzundaki temel, önerilen veya tam doğrulama düzeyini izleyin ve hangi düzeyin tamamlandığını bildirin. Bu README'yi ve doğrulanmış ikili dosyanın kararlı mutlak yolunu güvendiğiniz bir kodlama ajanına, örneğin Codex, Claude Code, Cursor veya OpenCode'a verin. Ajan, AOCI'yi başlatmak, MCP'yi entegre etmek ve ilk dizini oluşturmak için proje içi talimatları izleyebilir.

İlk dizinin ne kadar süreceği depo boyutuna bağlıdır. Normal bir entegrasyon dört adımdır: ikili dosyayı hazırlayın, ajanın veya kendinizin hedef depoyu başlatmasını sağlayın, ana makineden "dizini oluştur" isteyin ve hizalamayı doğrulayın. Bundan sonra her isteği "dizini koru" ile bitirmeniz gerekmez. Proje kuralları ve MCP iş akışı, yönetilen nesneler her değiştiğinde ajanın dizini artımlı olarak korumasını sağlar.

Gereksinimler

• Doğrulanmış bir sürüm paketi veya kanonik AOCI-CODE kaynak deposunun bir kopyası.
• Yalnızca kaynaktan derlemeler için: go.mod, make ve deponun gerektirdiği diğer araçlar tarafından bildirilen Go araç zinciri.
• Codex, Claude Code, Cursor veya OpenCode gibi desteklenen bir MCP ana makinesi.
• Hedef depoya normal okuma ve yazma erişimi.

AOCI-CODE, bir model sağlayıcı API'siyle değil, MCP ana makinesiyle entegre olur. DeepSeek ve diğer modeller, onları çalıştıran ajan veya ana makine standart stdio MCP'yi desteklediğinde ve araç sözleşmesini izleyebildiğinde AOCI-CODE'u kullanabilir; tek başına bir model adı uyumluluğu kanıtlamaz.

İmzalı paket yolu ve çalıştırılabilir doğrulama komutları kurulum kılavuzundadır. Kaynaktan derleme yolu aşağıdadır.

Mevcut RC: doğrulanmış bir paket kullanın veya kaynaktan derleyin

[!IMPORTANT] AOCI-CODE v0.1.0-rc22 mevcut sürüm adayıdır. FSL-1.1-MIT kapsamında Fair Source/kaynağı açık yazılımdır; bkz. LICENSE. Kanonik kaynaktan derleyin veya sürüm doğrulama prosedürünü izledikten sonra v0.1.0-rc22 GitHub Sürümünden imzalı bir paket kullanın.

İmzalı Sürüm ikili dosyası kendini aoci version 0.1.0-rc22 olarak tanımlar. Kaynaktan derleme ise tam kopyayı tanımlar ve v0.1.0-rc22-1-g<short-commit> gibi bir geliştirme sürümü (uygun olduğunda -dirty ile birlikte) ve Git commit'ini bildirebilir. Bunlar farklı derleme girdileridir, bir sürüm çakışması değildir.

GitHub CLI ile indirmek için önce kimlik doğrulayın, ardından etiketli Sürüm varlıklarını indirin:

gh auth login
gh release download v0.1.0-rc22 --repo aoci-spec/aoci-code

Anonim bir indirme için, bir tarayıcıda v0.1.0-rc22 Sürüm sayfasını açın ve ihtiyacınız olan arşivi ve doğrulama varlıklarını indirin.

Kaynaktan derlemek için kanonik depoyu klonlayın, ikili dosyayı derleyin ve elde edilen yolu kararlı tutun:

git clone https://github.com/aoci-spec/aoci-code.git
cd aoci-code
mkdir -p build
make build
./build/aoci --version

Windows'ta aynı kaynağı PowerShell'de derleyin:

git clone https://github.com/aoci-spec/aoci-code.git
Set-Location .\aoci-code
New-Item -ItemType Directory -Force .\build | Out-Null
make build
.\build\aoci.exe --version

Ardından bu README'yi projeye zaten güvendiğiniz bir ajana verin ve şunu isteyin:

Read this AOCI-CODE README and use the built aoci binary at its stable absolute path
to initialize AOCI for the current project, integrate MCP, and run scan. Stop there and
tell me to restart the agent; I will ask you to build the index afterwards.

Ajan proje kökünü belirlemeli, derlenmiş ikili dosyaya giden kararlı bir mutlak yol kullanmalı, mevcut ana makineye uygun başlatmayı çalıştırmalı ve bir ana makine yeniden başlatmasının veya gerçek insan onayının ne zaman gerektiğini size açıkça söylemelidir. İkili dosya AOCI-CODE çalışma kopyasında kalabilir veya paylaşılan bir araçlar dizinine taşınabilir; yeter ki MCP yapılandırması doğru mutlak yolu göstersin.

Manuel başlatma

AOCI'yi kendiniz başlatmak için hedef depo kökünden aşağıdakini çalıştırın veya --repo aracılığıyla açık bir yol belirtin:

AOCI=/absolute/path/to/aoci-code/build/aoci
"$AOCI" --repo . init --locale en-US --agent codex
"$AOCI" --repo . scan

init yerel ayar yapılandırmasını, yönetilen AGENTS.md kural bloğunu, Git sınırlarını ve boş bir dizin iskeletini yazar. Yapılandırma ve istem oluşturma ana makineye göre değişir; bkz. Ana makine entegrasyonu. Dosya adlarından, dizinlerden veya bir AST'den iş anlamı uydurmaz.

Yeni bir depo için ilk scan yönetilen Baseline'ı oluşturur. Zaten yönetilen bir Baseline'a sahip bir proje için yönetilen kapsamı eklemek, kaldırmak veya değiştirmek resmi Kapsam Değişikliği iş akışından geçer; scan --force yönetişim olgularını yeniden tanımlamanın kısa yolu değildir. --force ayrıca çözülmemiş sapmaları, makbuzları veya kurtarma sınırlarını silemez.

$Aoci = (Resolve-Path "C:\path\to\aoci-code\build\aoci.exe").Path
& $Aoci --repo . init --locale en-US --agent codex
& $Aoci --repo . scan

Ajana ilk dizini oluşturtun (önemli)

Başlatma ve scan tamamlandıktan sonra, ajan oturumunun AOCI araçlarını zaten sunup sunmadığını kontrol edin; sunmuyorsa yenileyin veya yeniden başlatın. Ardından hedef proje için ajana aşağıdakini girin:

First confirm the AOCI MCP server is connected, then build the AOCI index for this project. When it is complete, give me the AOCI panel link.

Ajan paneli arka planda aoci ui --detach --json ile başlatır ve size bağlantıyı verir. AOCI paneli neler gösterdiğini ve diğer komutlarını ele alır.

Ana makine projenin AOCI kurallarını ve canlı kılavuzunu okur, kaynak kodunu, testleri, yapılandırmayı ve ilgili kanıtları inceler ve ardından rolü index olan her yönetilen nesne için FRAS adayları yazar. Plan, Stage, Check, Diff, CAS veya Apply adımlarını kendiniz düzenlemek zorunda değilsiniz.

İlk dizin tamamlandığında, sıradan geliştirme isteklerini her zamanki gibi gönderin, örneğin:

Add priorities to tasks, including the frontend, backend, database, and test changes.

"Sonda AOCI dizinini koru" ifadesini eklemeniz gerekmez. Proje kuralları ve MCP, ajanın kod ve testler kararlı olduğunda dizin değişikliklerini kontrol etmesini ve etkilenen girdileri resmi iş akışı aracılığıyla güncellemesini sağlar. Proje automation.mode=auto kullandığında, AOCI-CODE sizi yalnızca gerçek insan onayı gerektiğinde, harici bir eylem gerçekleştirilmesi gerektiğinde, kurtarma kanıtlanamadığında, bir güvenlik kontrolü başarısız olduğunda veya üçüncü taraf bir eşzamanlılık çakışması bulunduğunda keser. Diğer otomasyon modları kendi çalışma zamanı sözleşmelerini izler.

Hizalamayı doğrulayın

Katılım tamamlandıktan sonra şunu çalıştırın:

"$AOCI" --repo . verify
"$AOCI" --repo . check

Dizin ve mevcut yönetilen kaynak aligned durumuna geri yakınsamalıdır. Yakınsamıyorsa önce canlı kılavuza başvurun; iç durum makinesini bir sarmalayıcı betikte çoğaltmayın:

"$AOCI" --repo . index agent guide --agent codex --json

Temel tanılamayı çalıştırın

"$AOCI" --repo . capabilities
"$AOCI" --repo . doctor

Ana makinenin gerçekte hangi AOCI'ye bağlı olduğunu doğrulamak için diskte olanı değil, sunucunun kendisi hakkında bildirdiklerini okuyun. Herhangi bir aoci_overview check_only yanıtında veya herhangi bir aoci_maintain yanıtında, cognition_receipt.mcp_service_version çalışan sürümdür ve runtime_repository_root yönettiği depodur. Eşleşen ikili dosya yolu, projenin .mcp.json dosyasındaki veya eşdeğer ana makine yapılandırmasındaki command değeridir: .codex/config.toml, opencode.json veya .cursor/mcp.json. Diskteki baytları değiştirmek çalışan bir MCP sürecini değiştirmez; bu nedenle bir yükseltme veya geri alma sonrasında bu olgulara karşı yeniden kontrol edin.

Tek seferlik bir adım adım kılavuz için depoda examples/minimal-repository kullanın.

make fast

make full
./build/aoci --version

mkdir -p build
CGO_ENABLED=0 go build -o build/aoci ./cmd/aoci

Başlatmadan sonra ne görünür

Tipik bir depo şu dizin dosyalarını içerir:

aoci.txt                    Root: declares the current CognitionSet and participating Volumes
aoci.meta.txt               Meta: tag dictionary, FRAS rules, and authoring constraints
aoci.code.txt               Code: model-authored entries for code and repository assets
aoci.database.txt           Database: optional table-level entries; absent by default
.aoci/
├── config.json             Team policy, Locale, Scope, and budgets
├── baseline.json           Governed Baseline for source, index, and database bindings
├── curation.json           Optional file-level include/exclude decisions
└── ...                     Drafts, Ledger, transactions, and recovery evidence; normally not committed to Git

Yeni bir projeyi başlatmak Root, Meta ve boş bir Code Volume oluşturur; Database varsayılan olarak yoktur. AOCI-CODE depo veya veritabanı için kendi başına iş anlamı üretmez.

aoci init --agent <name> ayrıca ana makine entegrasyon yapılandırmasını (.mcp.json, .claude/settings.json, .codex/config.toml veya opencode.json) yazar; bunların komut ve depo yolları makineye bağlı mutlak yollardır. Bu dosyaları deponun .gitignore dosyasına ekleyin ve commit etmeyin: commit edilmiş bir kopya diğer her makinede bozulur ve yükleyiciler mevcut bir girdiyi anahtar varlığına göre algıladığından, orada init komutunu yeniden çalıştırmak bozuk yolları sessizce korur.

Bir geliştirme görevi nasıl yürür

Aşağıdaki iki diyagram, iş akışını sizin deneyimlediğiniz şekilde gösterir, AOCI'nin iç uygulamasını değil.

Yeni proje: önce basit bir sistem kurun, sonra AOCI'yi devreye alın

flowchart TD
    I["The user proposes a product idea and requirements"] --> S["Use the agent's existing capabilities to build a simple new system"]
    S --> Q["Integrate AOCI MCP"]
    Q --> V["The agent builds the Whole-Index and verifies aligned"]
    V --> N["The user continues with ordinary development requests"]
    N --> M["The agent completes code, tests, and incremental index maintenance"]
    M --> N

Yeni bir sistem, kodun ilk satırından itibaren AOCI-CODE'a ihtiyaç duymaz. Önce ajanın mevcut yetenekleriyle bir prototip oluşturun; yaklaşık 10.000–30.000 satır, devreye almak için iyi bir noktadır (kesin bir eşik değil). Oturumlar arası sürekliliği daha erken isteyen ekipler daha erken entegre edebilir.

Mevcut proje: depoyu dizinleyin, sonra yineleyin

flowchart TD
    R["Existing repository, tests, configuration, and optional Schema"] --> B["Build AOCI-CODE from canonical source<br/>Request index generation"]
    B --> E["The agent inspects the existing system and writes the first index"]
    E --> V["Verify, Check, and Guide converge to aligned"]
    V --> T["The user submits an ordinary development task"]
    T --> C["The agent modifies code and runs quality checks"]
    C --> U["MCP guides the agent through index maintenance"]
    U --> G["The index and the current system return to aligned"]
    G --> T

İlk dizin tamamlandıktan sonra, her iki akış da günlük olarak aynı şekilde çalışır: iş veya mühendislik gereksinimini tanımlarsınız; ajan Tüm-Dizini mevcut kanıtlarla birleştirir, geliştirmeyi ve doğrulamayı yapar ve görevi kapatırken değişen nesneleri MCP aracılığıyla günceller. Dahili Plan, Stage, Diff, CAS veya Baseline komutlarını öğrenmeniz veya bakım gereksinimini her istemde tekrarlamanız gerekmez.

Tam bir toplu işlem, herhangi bir resmi yazma başlamadan önce reddedilirse dizin değişmez. İş akışı resmi yazmalar başladıktan sonra kesintiye uğrarsa, sistem değişmez niyeti, yazma kanıtını ve kurtarma durumunu korur, ardından ya kanıtlanabilir bir sonraki görüntüden devam eder ya da tam önceki görüntüye geri döner. Üçüncü taraf bir bayt çakışması kapalı şekilde başarısız olur; AOCI-CODE "yazmayı bitirmek" için harici bir değişikliğin üzerine asla yazmaz.

Son durum her zaman applied, repair_required veya stopped durumlarından biridir. stopped başarı değildir ve mutlaka hiçbir şeyin yazılmadığı anlamına da gelmez; failed_step öğesini, resmi yazma kanıtını ve kılavuzun döndürdüğü kurtarma eylemini inceleyin.

Kim ne yapar: model ve AOCI-CODE

Anlam modelin sorumluluğundadır

Ana makine modeli kaynak kodunu, testleri, yapılandırmayı, belgeleri ve ihtiyaç duyduğu her türlü kanıtı okur, ardından şunlara karar verir:

• bir nesnenin gerçekte neyden sorumlu olduğu;
• hangi dosyaların, modüllerin veya veritabanı nesnelerinin, onu güvenli şekilde değiştirmek için dikkate alınması gereken güçlü ilişkiler olduğu;
• hangi API'leri, komutları, biçimleri veya gözlemlenebilir sözleşmeleri sunduğu;
• hangi işlem, yetkilendirme, eşzamanlılık, önbellekleme, dağıtım, uyumluluk veya geçmiş kısıtlarının yalnızca sıradan yapıdan çıkarılamayacağı.

AOCI-CODE FRAS'ı dosya adlarından, yollardan, uzantılardan, AST'lerden veya şablonlardan bir araya getirmez ve modelin yazdıklarını sessizce yeniden yazmaz.

Yönetişim AOCI-CODE'un sorumluluğundadır

AOCI-CODE şunlardan sorumludur:

1. Güvenli Envanter, Yönetilen Kapsam ve mevcut Baseline'ı oluşturmak;
2. mevcut Tüm-Dizini sunmak ve kimliğini doğrulamak;
3. belirlenimci bir plan, hedef kümesi ve kaynak SHA-256 değerleri üretmek;
4. aday yapısını, etiket sözlüğünü, ilişki kimliklerini, kapsamı, sahipliği, bütçeleri ve etkilenen aralığı doğrulamak;
5. kontrol, fark ve inceleme içeriği arasındaki bağı korumak;
6. süreçler arası kilitler, CAS ve atomik yazmalarla tam bir toplu işlem gerçekleştirmek;
7. Baseline'ı ilerletmek, deftere ekleme yapmak ve yazma sonrası bir hatadan sonra kurtarma kanıtını korumak;
8. mevcut yönetişim durumunu Verify, Check ve kılavuz aracılığıyla yeniden kanıtlamak;
9. ikinci bir doğruluk kaynağı oluşturmadan yetkili varlıklardan Lineage, Relations, Impact, Snapshot ve Evolution gözlemlerini türetmek.

Tamamen yeşil makine sonuçları yalnızca kodlanmış yapısal ve yönetişim sözleşmelerinin geçerli olduğu anlamına gelir; modelin yazdığı her ifadenin doğru olduğu anlamına gelmez.

Dizin nasıl düzenlenir

Bir AOCI dizininin iki katmanı vardır: dizin kuralları ve dizin girdileri. Ürün iki fiziksel düzen destekler ve bunlar tek bir dosya biçimi değildir.

Volumes v1 düzeni

Bir Volumes projesi sorumlulukları ayırır:

• aoci.txt yalnızca Root'tur. Mevcut CognitionSet'te yer alan Volumes'ları bildirir.
• aoci.meta.txt Meta'yı tutar: etiket sözlüğü, FRAS kuralları, bütçeler ve yazarlık sözleşmesi.
• aoci.code.txt kod nesnelerinin girdilerini tutar.
• aoci.database.txt Database Cognition etkinleştirildiğinde veritabanı nesnelerinin girdilerini tutar.

Code ve Database Volumes'ları aynı FRAS satır yapısını paylaşır, ancak bağımsız nesne kimliklerine, kanıt bağlamalarına, sahipliğe ve yaşam döngülerine sahiptir. Root, Meta ve nesne Volumes'ları birlikte Tüm-Dizini oluşturur; yalnızca aoci.txt Root'u okumak tüm sistemi okuduğunuzu iddia etmek için yeterli değildir.

Bunu bir harita olarak düşünün:

• Dizin kuralları haritanın açıklama anahtarı ve koordinat sistemidir.
• Dizin girdileri her konumu tanımlayan işaretlerdir.
• Root, mevcut harita kümesi için katalog ve sürüm giriş noktasıdır.
• Bir Volume, aynı protokolle yönetilen ancak kendi kanıt kaynağına ve yaşam döngüsüne sahip ayrı bir sayfadır.

Dizin başlığı nasıl görünür

Root ve Meta, makine tarafından okunan başlık satırlarıyla açılır. aoci init öğesinin my-service adlı yeni bir en-US projesi için yazdığı şey budur; etkinleştirme giriş noktası olan Root ile başlar:

#AOCI-ROOT-MANIFEST: 1
#Format-Version: cognition-volumes/v1
#Locale: en-US
#Project: my-service
#Global-Invariants: -
#Volume: id=meta kind=meta path=aoci.meta.txt format=meta-v1 depends=- state=enabled
#Volume: id=code kind=code path=aoci.code.txt format=object-fras-v2 depends=meta state=enabled

Her #Volume: satırı, kimliği, türü, yolu, biçimi, bağımlılığı ve etkinleştirme durumuyla birlikte katılan bir Volume'u bildirir. Burada bildirilmeyen bir Volume, çalışma ağacında başka ne olursa olsun, mevcut CognitionSet'in parçası değildir. Database Cognition'u etkinleştirmek bir satır daha ekler: #Volume: id=database kind=database path=aoci.database.txt format=table-fras-v2 depends=meta state=enabled.

Meta ardından her girdiyi yöneten kurallarla açılır:

#AOCI-META-VOLUME: 1
#Object-Protocol: repository-cognition-object/v2
#FRAS-Discipline: 2
#FRAS-v2-Limits-Authority: machine-contract
#S-Admission: non-inferable-and-error-preventing
#S quota: C9-8≤600 C7-4≤200 C3-1≤50
#Object-Kinds: code=file database=table

#FRAS-v2-Limits-Authority: machine-contract yük taşıyan satırdır: alan sınırları bu metne değil ikili dosyaya aittir, bu nedenle bir proje kendi Meta'sını düzenleyerek bunları genişletemez. #S-Admission ve #S quota özellikle S alanını yönetir: orada neyin kaydedilebileceğini ve her önem bandının kaç karakter harcayabileceğini. Etiket sözlüğü bu satırların hemen ardından gelir; aşağıda tam olarak gösterilmiştir.

Code Volume tek bir satırla, #AOCI-CODE-VOLUME: 1 ile açılır ve sonrasındaki her şey dizin bölümleri ve girdilerdir.

Bunlar yeni bir projenin başladığı değerlerdir, sabit protokol sabitleri değildir. Sonrasında her deponun kendi Root ve Meta'sı yetkilidir: daha eski bir proje özel bir etiket sözlüğü taşıyabilir ve --locale zh-CN ile başlatılan bir proje #Locale: zh-CN yazar ve #S quota: anahtarını buna göre yerelleştirir.

Dizin kuralları neyi tanımlar

v1 Ciltlerinde, projenin Meta Cilt'i bu kuralları saklar; Legacy düzeninde ise bunlar tek parçalı başlıkta bulunur. Projeler farklı etiket sözlükleri kullanabilir, ancak temel FRAS yapısı aynı kalır.

Bu README yalnızca bu kuralların nasıl okunacağını açıklar. Somut, yürütülebilir kurallar için mevcut projenin Meta veya Legacy başlığına, AOCI kılavuzuna ve resmi spesifikasyona başvurun.

Bir girdinin kaydettikleri (FRAS)

Kurallar yerleştikten sonra model, index rolüne sahip her yönetilen nesne için bir girdi yazar. observe rolü yalnızca değişiklik gözlemine katılır ve exclude rolü kasıtlı olarak dışarıda bırakılanları işaretler; hiçbiri resmi bir girdiye sahip değildir. AOCI, bir girdide en çok önem taşıyan dört bilgi türünü düzenlemek için FRAS kullanır:

• F — İşlev: nesnenin neyden sorumlu olduğu.
• R — İlişkiler: onu anlamak veya güvenle değiştirmek için birlikte dikkate almanız gereken diğer nesneler.
• A — API: sunduğu arayüzler, komutlar, biçimler veya gözlemlenebilir sözleşmeler.
• S — Belirgin olmayan kısıtlar: F, R ve A'nın kapsamadığı ancak nesneyi anlamak veya güvenle değiştirmek için ihtiyaç duyduğunuz önemli bilgiler; örneğin temel kısıtlar, istisnalar, sınırlar ve özel anlambilim. S, ilk üç alanı tekrarlamamalıdır.

Örneğin, ===.../internal/fs/=== dizin bölümü içinde bir girdi temel adı kullanır:

atomic.go[CG9L]: F:Provides durable replace CAS, create CAS, atomic writes, and no-clobber recovery moves | R:code:internal/fs/atomic_exchange_linux.go,code:internal/fs/atomic_exchange_windows.go,code:internal/fs/lock.go | A:AtomicWrite,AtomicWriteCAS,AtomicCreateCAS,AtomicMoveCAS | S:Native publication never degrades to an overwriting rename; on a race, unsafe type, or unverifiable bytes, preserve third-party state 

Dizin bölümü ve temel ad bir kod nesnesi kimliğine çözümlenir. Ciltler arası veya sistem projeksiyonları için code:internal/fs/atomic.go gibi kanonik bir kimliğe genişler. Bir veritabanı nesnesi database://primary/public/orders gibi kendi kanonik kimliğini kullanır.

Girdinin iki bölümü vardır:

atomic.go [CG9L]
└─ object ─┘ └ tags ┘

F: Core responsibility
R: Strong relationships that must be understood together
A: External interface or contract
S: Important additional information beyond F, R, and A

Kısa etiketler her nesneye mimari katman, işlevsel alan, önem, isteğe bağlı teknik özellikler ve boyut için koordinatlar verir. Etiket sözlüğü projenin Meta Cilt'i veya Legacy başlığı tarafından tanımlanır. Program sözlüğü ve yapıyı doğrular; iş anlamına karar vermez.

S bir özet, sıradan bir özet veya F, R ve A'nın tekrarı değildir. İlk üç alanın kapsamadığı ve anlamayı veya mühendislik doğruluğunu etkileyen önemli bilgileri ekler, örneğin:

• bir Redis erişim hatası veritabanına geri dönmelidir;
• belirli bir tablo AutoMigrate'e girmemelidir;
• eski bir uyumluluk dalı sıradan temizlikle kaldırılmamalıdır;
• bir yazma hatasından sonra orijinal dosya korunmalıdır.

Model bunu gerçek kaynak koddan ve kanıtlardan yazar. AOCI-CODE girdinin yapısını doğrular, onu kaynak dosyaya bağlar ve resmi dizine nasıl gireceğini yönetir.

Başlangıç etiket sözlüğünü okumak

Aşağıdaki alıntı, mevcut en-US Cilt Meta şablonundan (textassets/en-US/templates/volume-meta.txt.tmpl) birebir kopyalanmıştır. Bu bir başlangıç sözlüğüdür, evrensel bir sözlük değildir: her deponun resmi Meta'sı yetkili olmaya devam eder. Başlangıç hiçbir D sözlüğü bildirmez; D isteğe bağlı bir eksen olarak kalır ve yalnızca mevcut resmi Meta onu bildirdiğinde kullanılabilir.

#Canonical-Tag-Authoring: compact A+B+C+[D]+E; dotted form is read compatibility only
#Code canonical identity example: code:path/to/file.go
#Code Entry example: file.go[EG7T]: F:Runs the example application | R:code:config/load.go | A:main | S:Exits non-zero when the config file is missing; it never falls back to built-in defaults
#[Tag dictionary: code]
#A Layer: C-SharedFoundation E-EntryBoundary A-ApplicationOrchestration D-DomainLogic K-AlgorithmComputation M-Middleware P-Persistence I-IntegrationAdapter R-RuntimeFoundation L-LibrarySDK F-DeclarativeConfiguration O-OperationsDelivery T-TestValidation S-DocumentationSpecification X-DevelopmentTooling Z-Other
#B Module: G-CrossDomain U-UserInteraction B-CoreBusiness D-DataState I-IdentityAccess N-NetworkProtocol M-MessageEvent S-SecurityPrivacy C-ConfigurationPolicy O-Observability R-ReliabilityRecovery P-PerformanceResource W-WorkflowScheduling A-AnalyticsIntelligence H-HardwareDevice L-Localization V-BuildRelease Q-QualityAssurance E-ExtensionPlugin Z-Other
#C Importance: 9-highest 8-very-high 7-high 6-above-average 5-medium 4-below-average 3-low 2-very-low 1-lowest
#E Scale: L-large>400 M-medium200-400 S-small100-200 T-tiny<100
#[Tag dictionary: database]
#A Layer: E-EntityMaster T-TransactionFact R-RelationMapping M-DetailDependent C-ReferenceDictionary S-StateStorage H-HistoryVersion L-LogAudit Q-QueueOutbox A-AggregateProjection K-KeyValueConfiguration B-DocumentLargeObject Z-Other
#B Module: G-CrossDomain B-CoreBusiness I-IdentityAccess T-OrganizationTenant U-UserExperience F-FinanceBilling K-ContentKnowledge C-ConfigurationPolicy W-WorkflowTask M-MessageEvent N-ExternalIntegration S-SecurityPrivacy O-ObservabilityAudit R-ReliabilityRecovery P-PerformanceResource A-AnalyticsIntelligence H-HardwareDevice L-Localization V-BuildRelease Q-QualityTesting E-ExtensionPlugin Z-Other
#C Importance: 9-highest 8-very-high 7-high 6-above-average 5-medium 4-below-average 3-low 2-very-low 1-lowest
#E Scale: L-large>400 M-medium200-400 S-small100-200 T-tiny<100

Başlangıç kod sözlüğü altında, [CG9L] şu anlama gelir: C SharedFoundation, G CrossDomain, 9 en yüksek önem ve L büyük ölçek; hiçbir D değeri yoktur. Bu, mevcut girdinin nasıl okunacağını açıklar, modelin etiketleri nasıl ataması gerektiğini değil. Model yine de etiketleri mevcut proje Meta'sından, kaynağa ve kabul edilmiş kanıtlara dayanarak seçer.

Biliş Ciltleri

AOCI-CODE tek bir mantıksal Bütün-Dizin'i korur, ancak her dizin türünün kendi dosyası, sahipliği ve yaşam döngüsü vardır.

Her nesnenin tam olarak bir geçerli sahibi vardır. Bir nesneyi yanlış Cilt'e yerleştirmek bir sahiplik çakışması yaratır. AOCI-CODE bunu yalnızca makine yanlış sahibi, doğru sahibi ve mevcut nesne gerçeklerini kanıtlayabildiğinde onarır; sahipliği benzer adlardan tahmin etmez.

Kod Cilt'i, Veritabanı Cilt'i ve kapsam birlikte evrilebilir, ancak tek bir yönetilen işleme sınırını paylaşırlar. Bir alanın uygulanması başka bir alanın mevcut Baseline projeksiyonunu atmamalıdır. Bir Cilt uygulaması, Baseline güncellemesi ve ilgili kapsam projeksiyonları tek bir tutarlı işlem sonucu olarak yayımlanır veya kanıtlanabilir kurtarmaya girer. Asla "dosya başarılı oldu ama başka bir Cilt'in baseline'ı yok" şeklinde yarım kalmış bir durum bırakmazlar.

Ana bilgisayar entegrasyonu

aoci init her zaman yönetilen ajan kurallarını yazar, ancak ana bilgisayar entegrasyonu farklıdır:

• Codex proje düzeyinde MCP yapılandırması ve --hooks ile birlikte bir bağlam sıkıştırma istemi ve SessionStart(compact) alır. Yine de hiçbir dosya düzenleme kancası kurmaz.
• Claude Code bir PreToolUse kancası kurabilir.
• OpenCode V1 katı bir proje düzeyinde opencode.json alır.
• Cursor yalnızca bir referans yapılandırma parçacığı döndürür; projeye hiçbir şey yazılmaz.

Yapılandırmadan sonra, mevcut ana bilgisayar oturumunun AOCI araçlarını zaten sunup sunmadığını kontrol edin. Yeni sunucuyu yüklemediyse yalnızca o proje oturumunu yenileyin veya yeniden açın. Yeni bir oturum normalde kuralları ve Bütün-Dizin'i bir kez okur. Dizin kimliği geçerli kaldığı ve bilinen bir ana bilgisayar sıkıştırması gerçekleşmediği sürece, sonraki görevler modelin zaten sahip olduklarını yeniden kullanır; tüm dizin mekanik olarak yeniden enjekte edilmez.

aoci --repo /absolute/path/to/repository init --agent codex
aoci --repo /absolute/path/to/repository init --agent codex --hooks
aoci --repo /absolute/path/to/repository init --agent claude --hooks
aoci --repo /absolute/path/to/repository init --agent opencode
aoci --repo /absolute/path/to/repository init --agent cursor

Codex --hooks, bir sıkıştırma devrini makbuz kimliği, bitmemiş yazma veya kurtarma durumu ve hemen yeniden yükleme talimatıyla sınırlar; Bütün-Dizin veya Genel Bakış/Onaylama gövdelerini saklamamalı veya özetlememelidir. Bir PreCompact kancası ana bilgisayar sıkıştırma girdisine enjekte edemez veya geçmişi silemez, bu yüzden bunu tek başına uygulayamaz. Güvenmeden önce kurulu proje kancasını Codex /hooks aracılığıyla inceleyin ve güvenin.

Legacy çıktı, mevcut ana bilgisayarlar ve raporlarla uyumluluk için Seviye 0–4'ü korur. Mevcut cognition-state/v2, modelin sistem resminin ne kadar kullanılabilir olduğunu Seviye 0–3 olarak ifade eder ve katı kanıt ve yönetişim gerçeklerini bağımsız boyutlara ayırır:

Bu boyutlar birbirinin yerine geçmez. Onaylama yalnızca mevcut malzeme için teslim kapsamını ve kimlik tutarlılığını kanıtlar; ajanın olası her gelecek görevi tamamen anladığı anlamına gelmez. Yalnızca current_system_cognition_reliable=true, tam mevcut sistem anlayışının niteliksiz bir iddiasına izin verir.

AOCI paneli

aoci ui, bu makinede salt okunur bir panel sunar, böylece bir ajana sormadan dizinin durumunu görebilirsiniz:

• dizin başlığı ve Kod / Veritabanı Ciltleri birebir (=== bölüm satırları olduğu gibi korunur, filtrelenebilir, bir bütün olarak kopyalanabilir); "Tümü" sekmesi, bir ajanın Genel Bakış aracılığıyla aldığı tam dizindir
• bütçeye karşı dizin belirteçleri ve Genel Bakış parça planı
• dizinin ne kadar kodu kapsadığı: dosyalar, satırlar, belirteçler ve sıkıştırma oranı; kaç veritabanı tablosu
• yönetişim durumu ve sapma, Yönetilen Kapsam, ana bilgisayar entegrasyonları ve çalışan aoci mcp süreçleri
• ajana sonra verilecek komutlar ve istemler, kopyalama düğmeleriyle

Sayfa Çince ve İngilizce arasında geçiş yapar; yenileme aralığı seçilebilir (varsayılan 30 sn).

Tek bir WSL'de birkaç aoci mcp sunucusu mu var? Linux ve WSL'de panel, mevcut kullanıcının her aoci mcp sürecini ve deposunu keşfeder, üstteki sekmelerle aralarında geçiş yapar ve ikili dosyası diskte değiştirilmiş bir sunucuyu işaretler. Sınırlar: yalnızca loopback adreslerine bağlanır (başka herhangi bir bağlama reddedilir), yalnızca GET ve HEAD yanıtlar, kilit almaz, deftere hiçbir şey eklemez ve deponun hiçbir baytını değiştirmez. aoci mcp ile ilgisiz ayrı bir süreçtir; MCP sunucusu hâlâ hiçbir soket açmaz. Arka plan panelinin kaydı kullanıcının önbellek dizininde yaşar, asla depoda değil.

Yaygın CLI komutları

Yaygın kombinasyonlar:

# Initialization and first Baseline
aoci --repo . init --locale en-US --agent codex
aoci --repo . scan

# Verification and governance gates for Cognition Volumes
aoci --repo . verify --json
aoci --repo . check --json

# Live Guide; do not duplicate the state machine in a wrapper
aoci --repo . index agent guide --agent codex --json

# Capabilities and diagnostics
aoci --repo . capabilities
aoci --repo . doctor

# Database Evidence, Access, and Cognition lifecycle
aoci --repo . database --help
aoci --repo . database source access --source primary --json
aoci --repo . database cognition status
aoci --repo . cognition plan --help

# Derived System Cognition observations
aoci --repo . cognition system lineage
aoci --repo . cognition system relations

# MCP stdio Server
aoci --repo . mcp

Plan, Stage, Check, Diff, Apply, Curation, Scope Change, Bootstrap, Migration ve kurtarma komutları hâlâ mevcuttur. Çalışan ikilinin döndürdüğü kılavuzu izleyin; iç durum makinesini betiklere kopyalamayın.

"Salt okunur" komutlar hakkında

verify, check, index score ve index inventory için "salt okunur", biçimsel dizinin ve Baseline'ın değiştirilmediği anlamına gelir; kesinlikle sıfır dosya sistemi yazımı anlamına gelmez. Ledger etkinleştirildiğinde, dört komutun tümü yerel Ledger'a ekleme yapabilir ve verify ayrıca Verify History yazmayı dener. Bir denetim yazımı hatası mevcut çıkış kodlarını veya yönetişim ölçütlerini değiştirmez.

Kesinlikle sıfır dosya yazımı gereken bir işlem gerekiyorsa, yalıtılmış bir kopya kullanın; mevcut genel CLI, her Ledger ve Verify History yazımını devre dışı bırakan genel bir anahtar sunmaz. System Cognition komutları ikinci bir biçimsel durum oluşturmaz, ancak sıradan CLI çağrıları yine de geçerli sürümün Ledger ve yerel geçmiş kayıtları için çalışma zamanı sözleşmesini izler.

MCP sunucusu

aoci mcp yerleşik bir daemon gerektirmez ve stdio üzerinden tam olarak dokuz araç sunar:

MCP modunda stdout JSON-RPC için ayrılmıştır; günlükler ve tanılamalar stderr'e gider. Çalışan ikilinin sağladığı araç açıklamaları, JSON şemaları ve makine durumu değerleri yetkilidir; bu README yalnızca bir başlangıç noktasıdır.

Geçerli sürüm, System Cognition yeteneklerini mevcut CLI ve yönetişim çekirdeği aracılığıyla sağlar. Bunlar onuncu bir MCP aracı eklemez veya mevcut dokuzun adlarını, amaçlarını ya da stdio sözleşmesini değiştirmez.

Uzun süreli oturumlar ve Whole-Index teslimi

Yeni bir konuşmanın başında, bir ajan normalde geçerli depoyla, dizin sürümüyle ve AOCI hizmet kimliğiyle eşleşen sistemin bir resmini edinmek için bir tam Overview yükler. Model hâlâ bu resme güvenebildiği sürece, her görevden veya araç çağrısından önce yeniden yüklemesi gerekmez.

Aynı konuşma içinde, model kendi durumuna göre yeniden yükleyip yüklemeyeceğine karar verir; bilinen bir host bağlam sıkıştırması sonrası hariç. Sıkıştırılmış bir devir yalnızca makbuz kimliğini, tamamlanmamış yazma veya kurtarma durumunu ve acil yeniden yükleme talimatını koruyabilir; Whole-Index veya Overview başlık, giriş, chunk, meydan okuma veya onay gövdelerini saklamamalı ya da özetlememelidir. O devire kopyalanan dizin içeriği veya makbuz, modelin geçerli resminin güvenilir olduğunu kanıtlayamaz.

Bilinen sıkıştırmadan sonra iş çalışmasına devam etmeden önce, ajan kurallar artık güvenilir biçimde mevcut değilse bunları yeniden yükler, yeni bir olay kimliğiyle context_compaction bildirir ve bir sıradan tam Overview imleç, onay ve attestation dizisini tamamlar. check_only ve cognition probe bunların yerini tutmaz. Taze tam taşımadan sonra, mevcut kısmi veya başarısız attestation kuralı yine de ikinci bir otomatik Overview olmadan kaynağa bağlı devam etmeye izin verir. Bilinen sıkıştırma olmadan anlamsal bir değişiklik veya büyük bir aşama sınırı için AOCI yenileme eşikleri, kontrol noktaları ve kimlik olguları sağlar ve model görev için sistem düzeyindeki resmini geri yüklemesi gerekip gerekmediğine karar verir.

Her tam Overview'ın gövdesi bir başlangıç işareti, geçerli biçimsel dizinin tam içeriği ve bir bitiş işaretinden oluşur.

Bir Overview projenin chunk bütçesini aştığında:

1. teslim hemen chunk 1 ile başlar;
2. ajan son chunk'a kadar otomatik olarak next_cursor izlemelidir;
3. ajan teslim edilen Whole-Index'i kullanarak tek bir attestation gönderir;
4. yerel arama, eski bellek, ek kaynak okuma veya doğrudan dosya okuma tam teslim olarak sunulmamalıdır;
5. bekleyen kurtarma veya tutarsız bir anlık görüntü, içeriği karıştırmadan kapalı başarısız olur.

overview_delivery.chunk_tokens tek teslim boyutu ayarıdır. Varsayılanı 7000 olup geçerli aralık 4000 ile 24000 arasındadır. check_only=true chunk zinciri olmayan kompakt bir kontrol noktasıdır.

AOCI, aoci_overview üzerinde araç başına bir sonuç boyutu izni bildirir. Aksi takdirde büyük bir araç sonucunu diske kalıcı yazacak ve modelin bağlamına yalnızca bir önizleme koyacak bir host (dizin teslimi için sessiz bir başarısızlık), bu eşiği yalnızca bu araç için yükseltir. Claude Code'da bu, tam 24000 kullanılabilir kılar ve 480 nesneli bir dizini beş yerine üç chunk'ta teslim eder. Hiçbir şey yoklanmaz: bildirim statiktir ve onu tanımayan bir host, MCP belirtiminin gerektirdiği gibi onu yok sayar.

Yenileme eşiği varsayılan olarak 30 farklı anlamsal yoldur ve proje başına da yapılandırılabilir. Kesin sayım kuralları için Cognition Refresh belgelerine ve çalışma zamanı sözleşmesine başvurun.

Database Cognition

AOCI-CODE, veritabanı yapısını aynı dizin ve aynı yönetişim altına getirebilir; erişim sınırı açık ve dardır:

Explicit database command
  → Read-only PostgreSQL/MySQL/openGauss system catalogs
  → Canonical schema evidence
  → Human acceptance of the evidence hash
  → The host model writes table-level FRAS from complete evidence
  → Entries are bound to the evidence and enter governed apply

• Hiçbir veritabanı yapılandırılmadığında veya açık bir veritabanı komutu çalıştırılmadığında hiçbir veritabanı ağ erişimi gerçekleşmez.
• Yalnızca temel tablolar için şema üst verisi okunur, iş satırları değil; görünümler, rutinler ve yorumlar mevcut toplama kapsamı dışındadır.
• Hiçbir DDL veya DML yürütülmez.
• Ana bilgisayar adları, kullanıcı adları, DSN'ler ve kimlik bilgisi değerleri asla dizin dosyalarına yazılmaz.
• Database Cognition apply çevrimdışı çalışır ve yazma sırasında veritabanına yeniden bağlanmaz.
• Program yapısal kanıtı korur ve karşılaştırır, ancak tablo sorumluluklarını, ilişkileri ve yüksek değerli kısıtları yine model yazar.

MySQL desteği 5.7.6 ve sonrasını kapsar. Toplayıcı sunucu sürümünü okur ve yalnızca o sürümün yanıtlayabileceği katalog sorgularını çalıştırır: CHECK kısıtları 8.0.16'dan, dizin ifadeleri 8.0.13'ten, dizin görünürlüğü 8.0.0'dan. Bir 5.7 sunucusu boş bir check listesi kaydeder, çünkü 5.7 CHECK sözdizimini ayrıştırır ve hiçbir şey saklamaz; kanıt desteklenen her sürümde aynı biçime sahiptir. MariaDB desteklenmez ve MySQL olarak okunmak yerine reddedilir.

İlk openGauss profili kasıtlı olarak openGauss 6.0.5 LTS ile A/PG uyumluluk modunda ve sıradan bölümlenmemiş temel tablolarla sınırlıdır. Desteklenmeyen katalog özellikleri sessizce PostgreSQL olgularına indirgenmek yerine kapalı başarısız olur; bu, MogDB, GaussDB, Dolphin/B/MySQL modu, bölümler veya alt bölümler, sütun deposu, MOT, yabancı veya geçici tablolar, görünümler, rutinler veya tetikleyiciler için destek iddiası taşımaz.

Burada kapalı başarısız algılama, desteklenmeyen anlamlara sahip seçilmiş görünür tablo benzeri nesneler için geçerlidir. Rutinler ve tetikleyiciler v1 tablo-nesnesi alanının dışında kalır ve asla tablo olguları olarak temsil edilmez.

openGauss yolu, resmi Connector v1.0.8 kaynağı üzerinde AOCI'nin incelenmiş yerel yamasını kullanır. Katı ayrıştırıcısı yalnızca incelenmiş bağlantı parametrelerini kabul eder ve ortamdaki PG*, hizmet, parola dosyası, ana dizin veya günlükleyici yapılandırmasını tüketmez. Sayısal bir loopback adresi dışındaki bir TCP bağlantısı açıkça sslmode=verify-full kullanmalıdır (ve sağlandığında sslrootcert içinde mutlak bir güvenilir kök yolu), minimum TLS 1.2 ile; TLS düşürme modları reddedilir. sslmode=disable yalnızca yerel/test sınırı olarak kullanılan açık bir Unix soketi veya sayısal loopback adresi için kabul edilir. Veritabanı yöneticileri bu DSN'i konuşma dışında sağlamaktan ve en az ayrıcalıklı hesabı hazırlamaktan sorumlu olmaya devam eder.

Database Volume varsayılan olarak yoktur. Whole-Index'e yalnızca proje Database Cognition'ı açıkça etkinleştirdikten ve kanıt, bağlama ve yaşam döngüsü yönetişimini tamamladıktan sonra girer.

Veritabanı erişimi katılımı: DSN ayrıntılarını anlamanız gerekmez

Bir veritabanı kaynağı için yalnızca hassas olmayan bir kimlik bildirirsiniz. --credential-env atlanırsa, AOCI kaynak kimliğinden kararlı bir ortam değişkeni referansı türetir; örneğin, primary şuna eşlenir: AOCI_DB_PRIMARY_DSN:

aoci --repo . database source add \
  --source-id primary \
  --engine postgresql \
  --database-name app \
  --namespace public

Ardından, dış ortamın bu referansı sağlayıp sağlamadığını görmek için salt okunur erişim ön kontrolünü kullanın:

aoci --repo . database source access --source primary --json

Bu komut veritabanına bağlanmaz, bir kimlik bilgisi değeri döndürmez veya sizden bir DSN'i konuşmaya yapıştırmanızı istemez. Bir veritabanı veya altyapı yöneticisi ortam değişkenini AOCI süreci dışında sağlar ve sistem kataloglarına salt okunur, en az ayrıcalıklı erişim verir. Kaynak yapılandırması yalnızca kimlik bilgisi referans adını saklar, sırrı değil.

Geçerli sürüm adayı yalnızca ortam kimlik bilgisi sağlayıcısını sunar. Vault, Kubernetes Secret ve AWS/GCP/Azure gibi bulut sır yöneticileri gelecek sürümlerde aynı sağlayıcı sınırı aracılığıyla entegre edilebilir; bugün mevcut değildir ve bu README aksini ima etmez. Bu ayrım, hesap biçimlerini, DSN kodlamasını ve gizli bilgi yaşam döngüsü yönetimini sıradan kullanıcılardan uzak tutarken yetkilendirmeyi açık tutar: AOCI kimlik bilgilerini otomatik olarak keşfetmez, .env taramaz, gizli dosyaları okumaz veya bir veritabanı yöneticisinin yetkilendirme sınırını atlamaz.

Sistem Bilişi Temeli

Kod ve veritabanı indekslerinin üzerine AOCI-CODE bir dizi türetilmiş Sistem Bilişi gözlemi sunar. Bunlar "bu nesne nereden geldi?", "bir veritabanı değişikliği hangi kod nesnelerini etkileyebilir?" ve "tarihsel bir gözlem ile şimdiki arasında ne değişti?" gibi soruları yanıtlar. Yeni bir yetkili olgular katmanı oluşturmazlar.

# Where an index object came from, with its evidence and receipt bindings
aoci --repo . cognition system lineage

# Volume containment and dependencies plus resolved model-authored R relationships
aoci --repo . cognition system relations

# Find code impact from a database object along formal R relationships
aoci --repo . cognition system impact \
  --object database://primary/public/orders

# Save a historical observation on the caller side
aoci --repo . cognition system snapshot --json > previous.json

# Compare a caller-supplied historical observation with the current derived projection
aoci --repo . cognition system evolution \
  --snapshot-file previous.json

Yetki sınırı

Her Sistem Bilişi sonucu derived=true bildirir; ilişki projeksiyonu ayrıca authoritative=false bildirir. Biliş Volume'ları, şema kanıt bağlamaları, Baseline parmak izleri ve makbuza bağlı kimlikler altta yatan yetkili kaynaklar olarak kalır. Çözümlenmemiş R ilişkileri eksik bir sonuç veya tanılama üretir; program tahmin edip bunları doldurmaz.

AOCI-CODE bir bilgi grafiği sistemi değildir. Dar ilişki projeksiyonu kullanışlı bir ilişki görünümüdür, ancak ikinci bir durum yönetimi sistemi, bağımsız bir yazma yolu veya yeni bir olgu deposu sahiplenmez. Türetilmiş çıktı silinebilir ve güncel yetkili varlıklardan yeniden hesaplanabilir. Bir projeksiyon yetkili varlıklarla çelişirse, varlıklar kazanır.

Yürütme modları, gizlilik ve veri sınırları

• AOCI-CODE varsayılan olarak yerel-önceliklidir; varsayılan bir bulut uç noktası, barındırılan bir kaynak yükleme hizmeti ve zorunlu bir arka plan sunucusu yoktur.
• Aracı-yerel modda veri işleme, seçtiğiniz ana makineye ve onun ürün politikalarına bağlıdır; AOCI-CODE verileri ana makine adına yüklemez.
• Veritabanı ağ erişimi açıkça tetiklenmelidir ve yalnızca salt okunur şema meta verileriyle sınırlıdır.
• Defter, taslaklar, işlemler ve kurtarma kanıtları varsayılan olarak .aoci/ altında saklanır ve normalde Git tarafından yok sayılır; indeks dosyaları ve ekip yönetişim varlıkları Git'e işlenebilir.
• Sistem Bilişi projeksiyonları mevcut yetkili varlıklardan yerel olarak hesaplanır ve grafik veritabanı, vektör veritabanı veya uzak grafik hizmeti gerektirmez.

Bir depo haritası, RAG, LSP veya kod grafiğinden farkı

Arama, AST'ler, LSP, kod grafikleri ve RAG yapısal ve getirme sorularında iyidir. AOCI-CODE farklı bir iş yapar: yönetilen kapsamı kapsayan ve yazılımla birlikte artımlı olarak evrilen, sürümlenmiş bir sistem tanımı sürdürür. Elde ettikleriniz:

• Bütünsel İndeks. Her görev için anında bir araya getirilen parçalar değil, güncel yönetilen kapsamı kapsayan tek bir sistem haritası.
• FRAS girdileri. index rolüne sahip her nesne için sorumluluklar, güçlü ilişkiler, genel sözleşmeler ve yüksek değerli kısıtlar.
• Oturumlar arası kalıcılık. İndeks dosyaları depoyla birlikte yaşar, böylece sonraki oturumlar ve diğer aracılar aynı sürümü yeniden kullanır.
• Yönetilen Kapsam. Hangi nesnelerin indekse girdiğinin, hangilerinin yalnızca değişiklik için gözlemlendiğinin ve hangilerinin kasıtlı olarak dışarıda bırakıldığının açık kaydı.
• Sapma tespiti. Missing, Orphan, Stale, Unbaselined, satır sonu değişiklikleri, küratörlük farklılıkları ve yazımdan uzak tutulan kaynakları (boş, ikili, aşırı boyutlu) ayırt eder.
• Yönetişimli güncellemeler. Adaylar resmi dosyalara kaynak bağlama, plan, doğrulama, inceleme, CAS, atomik yazmalar, Baseline ve kurtarma iş akışları yoluyla girer.
• Teslimat kanıtı. Chunk, imleç, makbuz ve meydan okuma, Bütünsel İndeks'in tam olarak teslim edildiğini kanıtlar.
• Veritabanı Bilişi. Açıkça kabul edilen PostgreSQL/MySQL/openGauss şema kanıtlarından oluşturulan ve yönetilen tablo düzeyinde girdiler.
• Sistem projeksiyonları. Yetkili indeksten ve bağlamalarından türetilen, yetkili durumu çoğaltmadan Sozkütük, dar İlişkiler, veritabanından koda Etki, Anlık Görüntü ve Evrim gözlemleri; Etki yalnızca model tarafından açıkça yazılmış R ilişkilerini dolaşır.

AOCI-CODE mevcut araçları değiştirmek yerine tamamlar.

Önerilen kombinasyon: AOCI-CODE genel anlamsal ön bilgiyi sağlar; kod grafikleri, LSP, arama ve kaynak kesin kanıt sağlar; testler ve çalışma zamanı sonuçları nihai kabulü sağlar. AOCI'nin İlişkiler projeksiyonu kesin bir çağrı grafiğinin yerini almaz: yapısal Volume kapsamasını ve Root bağımlılık kenarlarını açığa çıkarırken anlamsal kenarları modelin açıkça yazdığı güçlü ilişkilerle sınırlıdır.

Teknoloji yığını

AOCI-CODE Neo4j, bir vektör veritabanı, uzun süre çalışan bir arka plan süreci veya bir AOCI bulut hizmeti gerektirmez. Veritabanı Bilişi etkinleştirildiğinde, hedef veritabanı yalnızca açık, salt okunur bir şema kanıtı kaynağıdır; AOCI'nin kendi durum deposu değildir.

SSS

Legacy status --deep neden hâlâ sapma gösteriyor?

status --deep, index score ve index agent plan yalnızca Legacy'ye özgüdür. Bir Cognition Volumes deposu için canlı kılavuzu çalıştırın ve ana makinenin sıradan argümansız aoci_maintain kullanmasına izin verin, tam güncel toplu işi aoci_update_entry aracılığıyla gönderin ve Verify, Check ve kılavuzla kapatın. Baseline'ı doğrudan değiştirmeyin veya kaynak bağlama ve kurtarma adımlarını atlamayın.

Legacy düzeninin kendisi kullanımdan kaldırılmıştır. Volumes v1, yeni ve taşınmış depolar için desteklenen yoldur ve yalnızca Legacy'ye özgü komutların v0.2.0'da kaldırılması planlanmıştır; bir Legacy deposunu o zamandan önce aoci cognition migration ile taşıyın.

aoci --repo . index agent guide --agent codex --json

Ana makine neden yanlış AOCI'yi başlattı?

Proje düzeyindeki MCP yapılandırmasındaki çalıştırılabilir dosya yolunu inceleyin ve kararlı bir mutlak yol olduğundan emin olun, ardından şunu çalıştırın:

/absolute/path/to/aoci --version
/absolute/path/to/aoci --repo . doctor

Yalnızca diskteki dosyayı değil, yüklenen stdio sunucusunu doğrulamak için ana makine sürecinin gerçek çalıştırılabilir dosyasını, komut satırı --repo değerini ve yeniden başlatma sonrası süreç kimliğini de inceleyin.

Bir veritabanı hesabı oluşturup DSN'i kendim sağlamak zorunda mıyım?

DSN sözdizimini anlamanız gerekmez ve gizli bilgileri sohbette göndermemelisiniz. Hassas olmayan bir kaynak kimliği bildirdikten sonra AOCI kararlı bir ortam değişkeni referansı sağlar. Bir veritabanı yöneticisinin yine de salt okunur sistem kataloğu erişimine sahip, en az ayrıcalıklı harici bir hesap oluşturması ve bu referansı çalışma zamanı ortamına sağlaması gerekir. Güncel sürüm bir kuruluş adına veritabanı hesabı oluşturmaz veya bir gizli bilgi deposunu otomatik olarak okumaz.

CI'da çalışabilir mi?

Evet. Tarama, doğrulama, yönetişim kapıları ve deterministik kontroller yeni girdiler yazmadan çalışır. Kesin komutlar, denetim yazmaları ve çıkış kodları için güncel ikilinin --help belgesine, JSON şemalarına ve projenin CI belgelerine başvurun.

Tamamen yeşil bir AOCI sonucu anlamların doğru olduğunu kanıtlar mı?

Hayır. Yeşil bir sonuç, kodlanmış yapısal ve yönetişim koşullarının sağlandığını kanıtlar. Modelin yazdıkları yine de kaynak koda, şemaya, testlere, çalışma zamanı sonuçlarına ve insan incelemesine karşı kontrol edilmelidir.

Sistem Bilişi grafiği yeni bir doğruluk kaynağı mı?

Hayır. Güncel yetenek bağımsız bir grafik platformu değil, dar bir ilişki projeksiyonudur. Sonuçları yalnızca resmi indeksten, kanıttan, makbuzlardan ve Baseline'dan hesaplar ve yeni yetkili olguları kalıcılaştırmaz. Program ayrıca anlamsal ilişkileri içe aktarımlardan, SQL'den, dosya adlarından veya benzerlikten otomatik olarak üretmez.

Belgeler

Belgeler ve genel sözleşme bağlantıları v0.1.0-rc22 adresine sabitlenmiştir; böylece bu README bir ikili Sürüm arşivinden okunduğunda da geçerli kalırlar; bu arşiv, deponun docs/ veya spec/public/ dizinlerini içermez.

Kara kutu doğrulama paketleri

Depo, derlenmiş bir aoci ikilisini kesinlikle süreç dışından, yalnızca genel stdio MCP protokolü ve CLI üzerinden çalıştıran, scripts/blackbox/ altında dört bağımsız kara kutu paketi sunar:

• Protokol uygunluğu — MCP tel yüzeyinin 53 salt okunur kontrolü; yerel ayara bağlı cümleler zh-CN altında yinelenir;
• Hata enjeksiyonu senaryoları — imleç kurcalama, çökme kurtarma, yarışan yazıcılar ve tek kullanımlık fikstür depolarında yazma öncesi kancayı kapsayan 75 senaryo;
• Dondurulmuş gerçek projeler üzerinde yaşam döngüsü — üç işlenmiş fikstür projesi: repo-a (TypeScript) ve repo-b (Python + MySQL) tam init-yeniden hizalama yaşam döngüsünü çalıştırır ve repo-c (453 dosyalık katmanlı bir hizmet) ayrıca makine toplu iş sınırında çoklu toplu yazımı yürütür. İsteğe bağlı bir model izi, gerçek bir yapay zeka ajanını — OpenCode kurulumunuzun sunduğu herhangi bir modeli — iki küçük depo üzerinden geçirir ve son durumu genel yüzeylerden puanlar.
• Yükseltme ekseni — yayımlanmış her sürüm için, on depo şekli üzerinde 80 kontrol: yayımlanmış her sürüm kendi ikilisiyle bir depo derler ve yazar, ardından test edilen ikili bir kimliği taşımadan, Kapsam Değişikliği talep etmeden veya resmi bir varlığı yeniden yazmadan onu yönetmelidir ve ardından yazdıkları, başka bir yoldaki bir kopyayı hizalı tutmalıdır; onuncu şekilde roller tersine döner ve yayımlanmış her sürüm, test edilen ikilinin yazdığı bir depoyu çökmeden veya yeniden yazmadan okumalıdır. Diğer üç paket her fikstürü test edilen ikiliyle üretir, bu nedenle sürümler arasında değişen bir ön görüntü yapıları gereği onlar için görünmezdir.

Yalnızca derlenmiş bir ikilinin üzerine Python 3 ve git'e ihtiyaç duyarlar (MySQL paketi için Docker; model izi için OpenCode ve kendi model aboneliğiniz), böylece bir depo kopyası kendi derlemesini, bir platform bağlantı noktasını veya bir çatalı doğrulayabilir — ve AOCI_BIN, uygunluk ve senaryo paketlerini spec/public/ içindeki genel sözleşmeleri talep eden herhangi bir alternatif ikiliye yönlendirebilir. Bu paketler depo kopyasında bulunur; ikili Sürüm arşivleri bunları içermez. Komutlar ve sonuç yorumlaması için scripts/blackbox/README.md bölümüne bakın.

Araştırma, fikri mülkiyet ve lisans

AOCI-CODE araştırma makaleleri ve eserleri, yayımlanmış yöntemleri, deneysel protokolleri ve sonuçları kamuya açık şekilde tanımlayabilir. Patent başvuruları, verilen kapsam, hukuki durum, sahipler ve bölgesel etki hukuki olgulardır ve bunlar bir iç README'ye, geçmiş bir sürüm numarasına veya doğrulanmamış bir aktarıma dayanarak ürün açıklamalarına eklenmemelidir.

Gelecekte belirli bir patent numarası, verilme tarihi veya kapsamının açıklanması gerekirse, hak sahibi ve hukuk müşaviri bunu resmi kamu kayıtlarına karşı doğrulamalı ve özel bir IP, NOTICE veya hukuki belgeye yerleştirmelidir. Bu README yalnızca o yetkili dosyaya bağlantı vermelidir; patent kapsamını kendisi genişletmemeli ve patent durumunu bir yazılım lisansı olarak sunmamalıdır.

Topluluk

AOCI proje grubuna katılmak ve bakımcılarla ve diğer kullanıcılarla konuşmak için kodu WeChat veya WeCom (企业微信) ile tarayın. Hata raporlarını ve özellik isteklerini aranabilir kalmaları için GitHub issues olarak gönderin ve şüpheli güvenlik açıklarını SECURITY.md dosyasının açıkladığı şekilde özel olarak bildirin, asla grupta değil.

AOCI-CODE, bir ajanın daha fazla kod görmesini sağlamakla ilgili değildir. Ajana her eylemden önce sistem hakkında güncel, yapılandırılmış, izlenebilir ve yönetişimli bir anlayış kazandırır. Git kodunuzu sürümler, veritabanı geçişleri veri yapılarınızı sürümler ve AOCI-CODE, ajanların sistem hakkında bildiklerini, bu bilginin evrimindeki izlenebilirlik, yönetişim tutarlılığı ve kurtarma sınırlarıyla birlikte sürümler.