@azure-id/orc 1.8.1 → 1.9.0

package/README-id.md

@@ -7,13 +7,13 @@
 *Terima permintaan → pahami → rencanakan → beri nilai → kerjakan paralel → periksa → uji → kirim.*
 
 ![npm](https://img.shields.io/npm/v/%40azure-id%2Forc?style=for-the-badge&color=cb3837&logo=npm)
-![Version](https://img.shields.io/badge/version-1.8.0-blue.svg?style=for-the-badge)
+![Version](https://img.shields.io/badge/version-1.9.0-blue.svg?style=for-the-badge)
 ![License](https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge)
 ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg?style=for-the-badge)
 ![Claude Code](https://img.shields.io/badge/Claude_Code-Skills-purple.svg?style=for-the-badge)
 ![Dependencies](https://img.shields.io/badge/dependencies-zero-lightgrey.svg?style=for-the-badge)
 
-**Versi terbaru: v1.8.0** · diperbarui 16-09-2026 · [daftar perubahan lengkap](CHANGELOG.md)
+**Versi terbaru: v1.9.0** · diperbarui 21-09-2026 · [daftar perubahan lengkap](CHANGELOG.md)
 
 **Ada di npm: [`@azure-id/orc`](https://www.npmjs.com/package/@azure-id/orc)** — `npm i -g @azure-id/orc`
 
@@ -272,9 +272,9 @@ pemakaian 5 jam, pemakaian mingguan, dan beberapa hal lain.
 |---|---|---|
 | **`/orc`** | Alur penuh: terima → rencana → gelombang paralel bernilai → periksa → uji → kirim. Rajin menyimpan titik simpan; bisa dilanjutkan di sesi baru. | [lihat](mock-run/orc.md) |
 | **`/orc-ultra`** | Sama, ditambah penasihat Opus 5 **xhigh** dan tiga gerbang penilaian. Analisis dalam, pola kode, tes, dan keamanan dipaksa menyala. Memang mahal. | [lihat](mock-run/orc-ultra.md) |
-| **`/orc-mini`** | Satu agen Sonnet 5, satu pemeriksaan build + tes, lalu kirim. Melewati review penuh dan pengujian. Bisa pindah ke alur penuh di tengah jalan kalau diminta. | [lihat](templates/skills/orc-mini/examples/mini-run-mock.md) |
+| **`/orc-mini`** | Satu agen Sonnet 5, satu pemeriksaan build + tes, lalu kirim. Melewati review penuh dan pengujian. Satu baris **pembacaan kompleksitas** berisi angka menawarkan lane penuh kalau perubahannya lebih luas dari satu area. Bisa pindah ke alur penuh di tengah jalan kalau diminta. | [lihat](templates/skills/orc-mini/examples/mini-run-mock.md) |
 | **`/orc-fast`** | Lane tercepat. Butuh wiki yang masih segar **dan** pola kode yang sudah tersimpan; kalau ada, ia melewati tahap analis dan perencana sepenuhnya. Kalau salah satu syarat tidak ada, ia mundur ke `/orc-mini` — obrolan tidak pernah berhenti. | [lihat](mock-run/orc-fast.md) |
-| **`/orc-quick`** | Minta apa saja: perbaikan kecil, pertanyaan, mencari bug, menaikkan versi dependensi, komentar PR. Lihat → tanya sekali → kerjakan. **Selalu bertanya agen mana yang mau dipakai**, dan tidak ada pengaturan yang bisa mengubah itu. | [lihat](mock-run/orc-quick.md) |
+| **`/orc-quick`** | Minta apa saja: perbaikan kecil, pertanyaan, mencari bug, menaikkan versi dependensi, komentar PR. Lihat → tanya sekali → kerjakan. **Selalu bertanya agen mana yang mau dipakai**, dan tidak ada pengaturan yang bisa mengubah itu. Satu **defect direproduksi merah dulu sebelum diperbaiki**. | [lihat](mock-run/orc-quick.md) |
 | **`/orc-diy`** | Lane racikan Anda sendiri, disusun di terminal dengan `orc diy` lalu dikompilasi. Kalau belum disetel atau sudah basi, ia menolak jalan dan menawarkan `/orc` biasa. | [lihat](mock-run/orc-diy.md) |
 
 ### Memikirkan apa yang mau dibuat
@@ -411,30 +411,51 @@ Peta lokal tentang bagaimana kode Anda saling terhubung. **Default-nya mati.**
 ```bash
 orc config set code_graph on          # lane kode membuat dan memakai peta (gratis)
 orc config set code_graph_notes wave  # opsional: catatan satu kalimat (memakai token)
+orc graph map                         # peringkat repositori, sebelum Anda tahu nama berkasnya
 orc graph ctx OrderService.create     # kartu: pemanggil, yang dipanggil, efek SQL/HTTP/env
+orc graph ctx "GET /orders/:id"       # route juga satu simbol
 orc graph changes                     # apa yang diubah diff INI, dan seberapa berisiko
 orc graph cochange src/orders.js      # apa yang biasanya berubah bersama berkas ini
 orc graph coverage src/orders.js      # berapa banyak yang benar-benar dibaca parser
+orc graph gain                        # apa yang dimasukkan peta, dan perkiraan apa yang ditahannya
 ```
 
 - **Strukturnya gratis.** CLI mem-parse kodenya. Tanpa model, tanpa dependency.
   Fungsi, method, class dan handler route (`GET /orders/:id`); middleware yang
   dikirim lewat nama menjadi tautan `used by`.
+- **Bahasanya:** JavaScript, TypeScript, Python, Go, Java, C#, PHP, Ruby, Rust,
+  Kotlin, C / C++, dan blok `<script>` komponen Vue atau Svelte. Jika proyek
+  Anda sudah punya alatnya, ORC meminjamnya dan hasil parse-nya tepat — `ast`
+  milik Python, `node_modules/typescript` milik Anda, dan `go` di PATH. ORC
+  sendiri tetap tanpa dependency. `ORC_GRAPH_NO_BORROW=1` mematikannya.
+- **URL adalah satu tautan.** Test yang memanggil
+  `request(app).get("/orders/search")` adalah pemanggil route itu, dan kartunya
+  menyebutkannya. Begitu juga alias instance
+  (`const svc = new OrderService(); svc.run()`), method warisan (`this.ok()` →
+  `Base.ok`), dan nama yang di-re-export lewat berkas barrel.
 - **Update-nya kecil.** Git sudah menghitung hash setiap file. Hanya file yang
   hash-nya berubah yang di-parse ulang — perubahan dari teman satu tim diperbaiki
   sendiri di preflight berikutnya.
 - **Setiap tautan menyebut seberapa yakin:** `LOCAL`, `IMPORT`, `UNIQUE`,
-  `AMBIGUOUS` (semua kandidat ditulis) atau `UNRESOLVED`. Graf tidak pernah menebak.
+  `ROUTE`, `AMBIGUOUS` (semua kandidat ditulis) atau `UNRESOLVED`. Graf tidak
+  pernah menebak.
 - **Kartu punya batas token.** Kartu tidak pernah melewatinya, dan menyebut apa
-  yang disembunyikan. `--format tree` menulis nama kolom satu kali saja, bukan di
-  setiap baris, dan kembali ke bentuk biasa jika kartunya terlalu kecil.
+  yang disembunyikan. `--source [N]` menambahkan baris milik targetnya ke
+  panggilan yang sama. `--for-slice` hanya mencetak tampak LUAR satu berkas yang
+  memang akan dibaca penuh oleh agent. `--format tree` menulis nama kolom satu
+  kali saja, bukan di setiap baris.
+- **`orc graph map` menjawab "berkas mana yang penting di sini"** sebelum Anda
+  tahu nama berkasnya, di dalam satu batas token. `--focus` menyusun ulang
+  peringkat seluruh repositori di sekitar berkas atau nama yang sudah disebut
+  permintaan Anda. **Peringkat adalah petunjuk tentang di mana harus melihat
+  lebih dulu**, bukan bukti bahwa satu berkas penting untuk perubahan ini.
 - **Graf menunjukkan letak kode. Graf tidak menggantikan membaca kode.** Agent
   tetap membaca rentang barisnya sebelum bertindak. Kepala kartu menulis
   `coverage partial 327-466` jika parser tidak selesai membaca satu berkas —
   **tidak adanya celah yang tercatat bukan bukti bahwa semuanya lengkap.** Kartu
-  juga hanya menulis pemanggil yang MENYEBUT nama simbolnya: pemanggil yang
-  sampai lewat route HTTP atau dispatch lewat string bukan tautan, jadi
-  **diamnya satu kartu bukan bukti bahwa tidak ada apa-apa.**
+  menulis pemanggil yang MENYEBUT nama simbolnya atau yang sampai lewat URL:
+  pemanggil yang sampai lewat job runner atau dispatch lewat string bukan
+  tautan, jadi **diamnya satu kartu bukan bukti bahwa tidak ada apa-apa.**
 - **Setiap jawaban membawa `generation`** — angka yang naik setiap kali peta
   berubah. Kartu yang dikutip lagi nanti tetap bisa ditempatkan pada waktunya.
 - **Peta tetap segar lewat tiga jalan, dan hanya satu yang perlu diingat orang.**
@@ -444,9 +465,19 @@ orc graph coverage src/orders.js      # berapa banyak yang benar-benar dibaca pa
   membangunnya di preflight dan memperbaruinya setelah setiap perubahan. Lane
   lain tidak pernah memanggilnya. **Tidak ada yang berjalan dengan pewaktu dan
   tidak ada yang berjalan di latar belakang.**
-- **Hook itu juga memberi pekerja titik acuan yang tadinya harus dicari sendiri**,
-  dan semua yang diberikannya ditandai sebagai data repositori, bukan perintah.
-  Matikan dengan `orc config set code_graph_hooks off`; petanya tetap bekerja.
+- **Setiap lane hanya boleh menanyakan pertanyaan yang disebut katalognya
+  sendiri** (`orc lane calls <lane>`), dan v1.9.0 melebarkan itu untuk dua lane
+  ramping. `/orc-quick` sekarang boleh menanyakan `map`, `changes` dan
+  `coverage`, jadi ia bisa menyebut apa yang tersentuh satu perubahan dan
+  menjalankan test yang terdampak lebih dulu; `/orc-mini` boleh menanyakan
+  `map`, `impact`, `changes` dan `cochange`, yang menjadi angka di balik baris
+  kompleksitasnya. Sebelum ini keduanya hanya boleh menanyakan di mana satu
+  simbol berada.
+- **Hook itu juga memberi pekerja titik acuan yang tadinya harus dicari sendiri**
+  — untuk Grep, Glob, dan pencarian lewat shell (`grep`, `rg`, `git grep`,
+  `findstr`) — dan semua yang diberikannya ditandai sebagai data repositori,
+  bukan perintah. Matikan dengan `orc config set code_graph_hooks off`; petanya
+  tetap bekerja.
 
 Kontraknya: `templates/skills/_shared/code-graph.md`. Hook-nya:
 `templates/hooks/README.md`.
@@ -457,7 +488,11 @@ Kontraknya: `templates/skills/_shared/code-graph.md`. Hook-nya:
 > Pencari sempurna — setiap pembacaan berkas penuh menjadi pembacaan rentang —
 > akan menghemat **0,1% dari satu sesi**. Nyalakan peta ini karena Anda ingin
 > kartunya: apa memanggil apa, apa yang akan tersentuh oleh satu perubahan, di
-> mana parser tidak selesai. Bukan demi angka.
+> mana parser tidak selesai. Bukan demi angka. `orc graph gain` memakai kejujuran
+> yang sama: apa yang DIMASUKKAN peta itu tercatat, apa yang ditahannya adalah
+> **perkiraan** yang dicetak sebagai rentang, dan angka terukur baru muncul jika
+> proyek Anda sendiri sudah punya tiga run dengan peta menyala dan tiga dengan
+> peta mati.
 
 ## `orc ui` — panel kendali
 
@@ -656,7 +691,8 @@ templates/
 bin/cli.js        pemasang, penyunting pengaturan, penyusun alur, pembaca status
                   pekerjaan, dan separuh pasti dari setiap lane. Setiap pembacaan
                   bisa menjawab --json
-bin/graph*.js     graf kode: penyimpanan, ekstraksi, resolusi saat dibaca, catatan
+bin/graph*.js     graf kode: penyimpanan, ekstraksi, resolusi + cache dan shard-nya,
+                  sinyal, catatan, peta berperingkat, pengukur gain
 bin/webui/        `orc ui` — panel kendali lokal: css/ + js/ + i18n/<bahasa>/ +
                   fixtures/, satu berkas per lapisan dan per panel. Nol dependensi
 bin/mockrun-catalog.js   katalog contoh jalannya (diturunkan dari berkas di disk)
@@ -732,67 +768,68 @@ Bacalah sebagai catatan putaran itu, bukan sebagai audit terkini:
 **Riwayat lengkap: [CHANGELOG.md](CHANGELOG.md)** — atau `orc changelog`, yang
 hanya mencetak yang lebih baru dari versi yang Anda punya.
 
-### v1.8.0 - graf kode: peta kode yang selalu baru _(16-09-2026)_
-
-Lane ORC menghabiskan sebagian besar tokennya untuk mencari: Grep, baca file,
-Grep lagi. Agent berikutnya di wave berikutnya mencari hal yang sama lagi.
-
-**`orc graph` adalah peta lokal tentang bagaimana kode saling terhubung.**
-Default-nya mati: `orc config set code_graph on`.
-
-- **Strukturnya gratis.** CLI mem-parse JavaScript, TypeScript, Python, Go,
-  Java, C# dan PHP — tanpa model. Python memakai parser `ast` miliknya sendiri
-  jika Python 3.8+ terpasang.
-- **Update-nya kecil.** Hanya file yang hash git-nya berubah yang di-parse ulang.
-  Di django/django (3.040 file sumber) build pertama 12 detik, update satu file
-  2,7 detik, dan satu kartu 0,46 detik.
-- **`orc graph ctx | impact | path`** menjawab dengan batas token dan kata status
-  di setiap tautan. Handler route menjadi simbol, dan middleware yang dikirim
-  lewat nama menjadi tautan `used by`. `--format tree` menulis nama kolom satu
-  kali saja — 17–21% lebih sedikit token pada kartu berkas.
-- **Bagian yang mahal kini ditulis sekali.** Mencari siapa yang memanggil satu
-  simbol memakan 437 ms di django/django, setiap kali dibaca. Sekarang dihitung
-  saat peta di-update lalu dibaca kembali: kartu berkas 727 ms → 458 ms, dan
-  `orc graph impact` 631 ms → 397 ms. Simpanan itu TURUNAN — hanya dipakai jika
-  menyebut versi peta yang sekarang, dan menghapusnya hanya menghilangkan
-  kecepatan.
-- **Setiap jawaban membawa `generation`**, dan setiap berkas menyebut berapa
-  banyak yang benar-benar dibaca parser — `full`, `partial` dengan rentang
-  barisnya, atau `skipped`. `orc graph coverage <berkas>` menanyakannya sekaligus.
-- **Tiga jawaban baca-saja yang baru, semuanya gratis:** `orc graph changes`
-  (simbol yang benar-benar disentuh diff ini, dengan pemanggil, test, dan kata
-  risiko yang membawa alasannya sendiri), `orc graph cochange <berkas>` (apa yang
-  biasanya berubah BERSAMA berkas itu, dari riwayat git — bukan ketergantungan),
-  dan `orc graph coverage`.
-- **Catatan bersifat opsional** (`code_graph_notes: wave | end`). Satu agent
-  Sonnet 4.6 menulis satu kalimat per fungsi yang berubah. Catatan hanya
-  ditampilkan selama isi fungsinya tidak berubah.
-- **Peta tetap segar lewat tiga jalan, dan hanya satu yang perlu diingat orang.**
-  Satu pembacaan memperbaiki berkas yang akan dijawabnya. Hook yang terpasang
-  memperbarui peta saat satu pekerja selesai, dan memberi pekerja titik acuan
-  yang tadinya harus dicari sendiri. Dan setiap lane kode tetap membangunnya di
-  preflight. `/orc-quick` tetap hanya membaca `log_dir`. **Tidak ada yang
-  berjalan dengan pewaktu dan tidak ada yang berjalan di latar belakang.**
-- **Semua yang diterima pekerja dari graf ditandai sebagai data repositori, bukan
-  perintah.** Nama simbol berasal dari repositori Anda, jadi ORC memperlakukannya
-  sebagai teks. Isi berkas tidak pernah dikirimkan — hanya nama, path dan
-  rentang baris.
-- **Juga:** delapan kunci pengaturan, dua temuan `orc doctor`, kartu graf kode di
-  `orc ui`, dan komponen status line `graph`.
-
-**Batas yang kami tahu.** TypeScript dibaca dengan pencocokan pola, bukan dengan
-compiler TypeScript. `x = new Service(); x.run()` tampil sebagai `AMBIGUOUS`.
-Pemanggil yang tidak pernah menyebut nama simbolnya — tes route HTTP, penjalan
-job — bukan tautan, jadi baca kartu sebagai titik awal, bukan sebagai daftar
-lengkap yang akan terdampak.
-**Ini bukan optimasi token, dan itu sudah diukur.** Pencarian hanya 0,06% dari
-yang ditambahkan satu sesi ke konteksnya; pencari sempurna pun hanya menghemat
-0,1% dari satu run. Peta ini tidak memakai token model untuk dibangun dan waktu
-baca di atas nyata — nyalakan demi kartunya, bukan demi penghematan.
+### v1.9.0 - lane ramping belajar melihat dulu sebelum melompat _(21-09-2026)_
+
+`/orc-quick` dan `/orc-mini` adalah dua lane yang paling sering dipakai orang,
+dan keduanya bekerja setengah buta. Graf kode bisa memberi tahu mereka DI MANA
+satu simbol berada, dan dilarang memberi tahu APA YANG RUSAK. Perbaikan bug
+tidak pernah ditunjukkan gagal lebih dulu. Pekerjaan baca-saja dikirim lewat
+nama model, jadi tidak ada satu pun bagian ORC yang bisa melihatnya.
+
+**Sekarang bug ditunjukkan MERAH dulu sebelum diperbaiki.** Permintaan seperti
+*"halaman orders mengembalikan 500, cari dan perbaiki"* digolongkan sebagai
+**defect**, dan agen eksekutor menulis reproduksinya LEBIH DULU — satu test yang
+gagal dalam framework Anda sendiri, atau satu perintah — menjalankannya sampai
+merah, memperbaikinya, lalu menjalankannya lagi sampai hijau. Kedua jalannya
+dicetak dan keduanya masuk ke jejak. Reproduksi yang tidak bisa ditulis menjadi
+`repro: none` beserta alasannya, dan catatannya berbunyi **tidak tereproduksi** —
+diulang lagi saat penawaran commit. Itu tidak pernah dikarang. Tanpa jalan merah,
+perbaikan hanya terbukti terhadap test suite Anda, yang sudah hijau sebelum dan
+sesudahnya; dengan jalan merah, perbaikan terbukti terhadap bug yang Anda
+laporkan.
+
+**Kedua lane sekarang boleh bertanya apa yang rusak.** `/orc-quick` mendapat
+`map`, `changes` dan `coverage`; `/orc-mini` mendapat `map`, `impact`, `changes`
+dan `cochange`. **Test yang terdampak dijalankan lebih dulu** — termasuk test
+yang sampai ke perubahan lewat URL — dan setiap catatan membawa satu baris
+radius dampak, tempat kata `risk` tidak pernah muncul tanpa alasannya.
+Permintaan yang tidak menyebut satu berkas pun sekarang dimulai dengan
+`orc graph map --focus`, bukan dengan tebakan nama berkas.
+
+**Pembacaan kompleksitas `/orc-mini` membawa angka.** Dulu itu satu kalimat
+penilaian; sekarang satu baris berisi hitungan dan empat ambang yang
+masing-masing menyebut kenapa angkanya segitu: pemanggil di 4 berkas atau lebih
+di luar rencana, 8 pemanggil atau lebih, kelas risiko apa pun yang dikutip, atau
+satu berkas yang menurut riwayat selalu ikut tersentuh. Itu **tawaran, bukan
+perpindahan**, dan kalau Anda tetap lanjut, angkanya ditulis ke catatan
+keputusan supaya `/orc-retro` nanti bisa menggeser ambangnya.
+
+**Pekerjaan baca-saja sekarang agen sungguhan.** Recon adalah sepasang agen
+tetap — `orc-recon-sonnet-4-6-med` dan `orc-recon-opus-5-low` — dengan kontrak
+pengembalian, terlihat di jejak dan di `orc run inflight`. Pilihan
+`other — sebut satu model` tetap ada sebagai jalan keluar. Gerbangnya sekarang
+boleh mencetak `suggested` di samping satu baris BESERTA alasannya, dan ia tetap
+tidak pernah memilih: setiap menu berakhir dengan *pilihan Anda — tidak ada yang
+berjalan sampai Anda menjawab*.
+
+**Kedua lane lebih murah untuk dimuat.** Dua deskripsi yang dibayar setiap sesi
+turun dari 619 ke 326 dan dari 493 ke 294 karakter, dengan setiap frasa pemicu
+tetap utuh. Kartu aturan dalam potongan `/orc-quick` sekarang berbentuk ringkas —
+sekitar 1.460 token, bukan 3.469 — yang menjaga id, judul dan instruksi setiap
+aturan HARD, dan hanya melepas contoh-contohnya.
+
+**Rilis ini tidak menurunkan tagihan Anda**, dan tidak mengklaim begitu.
+Klaimnya adalah kebenaran, keterlacakan, dan lebih sedikit bolak-balik.
+**Evaluasi sesi langsung tidak dijalankan** — setengah bagian deterministiknya
+ada di test suite, tetapi tiga gate yang butuh orang menjalankan lane tidak
+tercapai, bukan lulus. CHANGELOG menyebutkan satu per satu.
 
 <details>
-<summary><strong>Rilis sebelumnya</strong> — 116 rilis, hanya judulnya. Teks lengkapnya (dalam bahasa Inggris) ada di <a href="CHANGELOG.md">CHANGELOG.md</a>.</summary>
+<summary><strong>Rilis sebelumnya</strong> — 119 rilis, hanya judulnya. Teks lengkapnya (dalam bahasa Inggris) ada di <a href="CHANGELOG.md">CHANGELOG.md</a>.</summary>
 
+- **v1.8.2** — the map that finds what a grep cannot · _2026-09-21_
+- **v1.8.1** — the guard that only failed on Windows · _2026-09-16_
+- **v1.8.0** — the code graph: a map of the code that stays fresh · _2026-09-16_
 - **v1.7.1** — the rules card now reaches the agent · _2026-09-14_
 - **v1.7.0** — the rules that keep the slop out · _2026-09-13_
 - **v1.6.0** — the rule that can finally say no · _2026-09-07_

package/README.md

@@ -7,14 +7,14 @@
 *Intake → analyze → plan → score → parallel subagents → review → verify → ship.*
 
 ![npm](https://img.shields.io/npm/v/%40azure-id%2Forc?style=for-the-badge&color=cb3837&logo=npm)
-![Version](https://img.shields.io/badge/version-1.8.1-blue.svg?style=for-the-badge)
+![Version](https://img.shields.io/badge/version-1.9.0-blue.svg?style=for-the-badge)
 ![License](https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge)
 ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg?style=for-the-badge)
 ![Claude Code](https://img.shields.io/badge/Claude_Code-Skills-purple.svg?style=for-the-badge)
 ![Dependencies](https://img.shields.io/badge/dependencies-zero-lightgrey.svg?style=for-the-badge)
 ![GitHub stars](https://img.shields.io/github/stars/azure-id/orc?style=for-the-badge&color=yellow)
 
-**Latest: v1.8.1** · updated 2026-09-16 · [full changelog](CHANGELOG.md)
+**Latest: v1.9.0** · updated 2026-09-21 · [full changelog](CHANGELOG.md)
 
 **On npm: [`@azure-id/orc`](https://www.npmjs.com/package/@azure-id/orc)** — `npm i -g @azure-id/orc`
 
@@ -251,9 +251,9 @@ ORC have terminal hook to see: Context Window %, 5 Hour usage %, Weekly usage %
 |---|---|---|
 | **`/orc`** | The full pipeline: intake → plan → scored parallel waves → review → verify → ship. Checkpoints eagerly; resumes in a fresh session. | [see it](mock-run/orc.md) |
 | **`/orc-ultra`** | The same, plus an Opus 5 **xhigh** advisor and three judgment gates. Deep analysis, patterns, tests and security forced on. Costly by design. | [see it](mock-run/orc-ultra.md) |
-| **`/orc-mini`** | One Sonnet 5 executor, a build + test smoke gate, ship. Skips full review and verify. Switches to the full flow mid-run on request. | [see it](templates/skills/orc-mini/examples/mini-run-mock.md) |
+| **`/orc-mini`** | One Sonnet 5 executor, a build + test smoke gate, ship. Skips full review and verify. A one-line **complexity read** with counts behind it offers the full lane when the change is wider than one area. Switches to the full flow mid-run on request. | [see it](templates/skills/orc-mini/examples/mini-run-mock.md) |
 | **`/orc-fast`** | The fastest lane. Needs a fresh wiki **and** a cached code pattern; then it skips the analyst and planner entirely. A missing prerequisite falls back to `/orc-mini` — the chat never stops. | [see it](mock-run/orc-fast.md) |
-| **`/orc-quick`** | Ask for anything: a fix, a question, a defect hunt, a dependency bump, PR comments. Look → ask once → do. **It always asks which agent to dispatch**, and no setting can change that. | [see it](mock-run/orc-quick.md) |
+| **`/orc-quick`** | Ask for anything: a fix, a question, a defect hunt, a dependency bump, PR comments. Look → ask once → do. **It always asks which agent to dispatch**, and no setting can change that. A defect is **reproduced red before it is fixed**. | [see it](mock-run/orc-quick.md) |
 | **`/orc-wait`** | Wall-clock pause without losing the run. You see the window is nearly full, type `/orc-wait 30`, and ORC hands the run back to disk, waits in detached hops that **cost zero tokens**, and picks up where it stopped. Three modes decide how much finishes first: `safe` · `soft` (forces the checkpoint) · `hard` (fastest, can lose an in-flight return). `/orc-wait block <reason>` tells it not to stop you at all. | — |
 | **`/orc-diy`** | Your own lane, composed in the terminal with `orc diy` and compiled. Unconfigured or stale → it refuses and offers plain `/orc`. | [see it](mock-run/orc-diy.md) |
 
@@ -388,28 +388,45 @@ A local map of how your code is connected. It is **off by default**.
 ```bash
 orc config set code_graph on          # code lanes build and use the map (free)
 orc config set code_graph_notes wave  # optional: one-sentence notes (costs tokens)
+orc graph map                         # the repository ranked, before you know a file name
 orc graph ctx OrderService.create     # a card: callers, calls, SQL/HTTP/env effects
+orc graph ctx "GET /orders/:id"       # a route is a symbol too
 orc graph changes                     # what THIS diff touched, and how risky
 orc graph cochange src/orders.js      # what usually changes with this file
 orc graph coverage src/orders.js      # how much of it the parser really saw
+orc graph gain                        # what the map put in, and an estimate of what it kept out
 ```
 
 - **Structure is free.** The CLI parses the code. No model, no dependency.
   Functions, methods, classes and route handlers (`GET /orders/:id`); a
   middleware passed by name is a `used by` link.
+- **Languages:** JavaScript, TypeScript, Python, Go, Java, C#, PHP, Ruby, Rust,
+  Kotlin, C / C++, and the `<script>` block of a Vue or Svelte component. Where
+  your project already has the tool, ORC borrows it and the parse is exact —
+  Python's `ast`, your own `node_modules/typescript`, the `go` on PATH. ORC
+  itself still has zero dependencies. `ORC_GRAPH_NO_BORROW=1` turns that off.
+- **A URL is an edge.** A test that calls `request(app).get("/orders/search")`
+  is a caller of that route, and the card says so. So is an instance alias
+  (`const svc = new OrderService(); svc.run()`), an inherited method
+  (`this.ok()` → `Base.ok`) and a name re-exported through a barrel file.
 - **Updates are small.** Git already hashes every file. Only the files whose hash
   changed are parsed again — a teammate's change heals at the next preflight.
-- **Every link says how sure it is:** `LOCAL`, `IMPORT`, `UNIQUE`, `AMBIGUOUS`
-  (every candidate listed) or `UNRESOLVED`. The graph never guesses.
+- **Every link says how sure it is:** `LOCAL`, `IMPORT`, `UNIQUE`, `ROUTE`,
+  `AMBIGUOUS` (every candidate listed) or `UNRESOLVED`. The graph never guesses.
 - **A card has a token budget.** It never goes over it, and it says what it hid.
-  `--format tree` names each column once instead of on every row, and falls back
-  to the normal shape when a card is too small to pay for the header.
+  `--source [N]` adds the target's own lines to the same call. `--for-slice`
+  prints only the OUTSIDE view of a file an agent is about to read in full.
+  `--format tree` names each column once instead of on every row.
+- **`orc graph map` answers "which files matter here"** before you know a file
+  name, inside a budget. `--focus` re-ranks the whole repository around the files
+  or names your request already mentioned. **Rank is a hint about where to look
+  first**, never proof that a file matters to a change.
 - **It shows where code is. It does not replace reading it.** Agents still read
   the line range before they act. A card header says `coverage partial 327-466`
   when the parser could not finish a file — **no recorded gap is not proof of
-  completeness**. A card also lists only the callers that NAME the symbol: one
-  that reaches it through an HTTP route or a string dispatch is not a link, so
-  **a card's silence is not proof of absence**.
+  completeness**. A card lists the callers that NAME the symbol or reach it by a
+  URL; one that reaches it through a job runner or a string dispatch is not a
+  link, so **a card's silence is not proof of absence**.
 - **Every answer carries a `generation`** — a number that goes up each time the
   map changes. A card quoted back later can be placed in time.
 - **It keeps itself current in three ways, and only one of them needs a lane to
@@ -418,8 +435,15 @@ orc graph coverage src/orders.js      # how much of it the parser really saw
   — `/orc`, `/orc-ultra`, `/orc-diy`, `/orc-mini`, `/orc-fast`, `/orc-quick` —
   still builds it at preflight and updates it after each change. Other lanes
   never call it. **Nothing runs on a timer and nothing runs in the background.**
-- **The hook also hands a worker the anchors it would otherwise search for**, and
-  everything it hands over is labelled repository data, never an instruction.
+- **Each lane may ask only the questions its own catalogue names** (`orc lane
+  calls <lane>`), and v1.9.0 widened that for the two lean lanes. `/orc-quick`
+  can now ask `map`, `changes` and `coverage`, so it can say what a change
+  touches and run the affected tests first; `/orc-mini` can ask `map`, `impact`,
+  `changes` and `cochange`, which are the counts behind its complexity line.
+  Until now both could ask only where a symbol is.
+- **The hook also hands a worker the anchors it would otherwise search for** —
+  for a Grep, a Glob and a shell search (`grep`, `rg`, `git grep`, `findstr`) —
+  and everything it hands over is labelled repository data, never an instruction.
   Switch it off with `orc config set code_graph_hooks off`; the map still works.
 
 The contract: `templates/skills/_shared/code-graph.md`. The hook:
@@ -432,6 +456,10 @@ The contract: `templates/skills/_shared/code-graph.md`. The hook:
 > a session**. Turn the map on because you want the cards: what calls what, what
 > a change would touch, where the parser could not finish. Not for a number.
 > The working is in `eval/graph-replay.js`, and it spends no tokens to re-run.
+> `orc graph gain` reports the same honesty per run: what the map PUT IN is
+> recorded, what it kept out is an **estimate** printed as a range, and a
+> measured figure appears only when your own project has three runs with the map
+> on and three with it off.
 
 ## `orc ui` — the control panel
 
@@ -613,7 +641,8 @@ templates/
 └── agents/       48 model-pinned subagents + MODEL-MAPPING.md
 bin/cli.js        installer, config editor, flow composer, run-state reader, and
                   the deterministic half of every lane. Every read speaks --json
-bin/graph*.js     the code graph: store, extraction, resolution + its cache, signals, notes
+bin/graph*.js     the code graph: store, extraction, resolution + its cache and
+                  shards, signals, notes, the ranked map, the gain meter
 bin/webui/        `orc ui` — the local control panel: css/ + js/ + i18n/<lang>/ +
                   fixtures/, one file per layer and per panel. Zero deps, no build step
 bin/mockrun-catalog.js   the mocked-run catalogue (derived from the files on disk)
@@ -683,28 +712,62 @@ a current audit: [EVAL-REPORT.md](EVAL-REPORT.md).
 **Full history: [CHANGELOG.md](CHANGELOG.md)** — or `orc changelog`, which prints
 only what is newer than the version you have.
 
-### v1.8.1 - the guard that only failed on Windows _(2026-09-16)_
-
-`npm publish` could not run on Windows. The `prepack` guard reported nine
-drifted executor agents, and `git status` reported no change at all.
-
-**The cause was a line ending, not content.** `.gitattributes` says
-`* text=auto`, so git stores the generated executor agents with LF and checks
-them out native — a Windows clone holds CRLF. The generator read the template
-as it is on disk, but injected the `effort:` frontmatter line with a hardcoded
-LF. `bin/build-agents.js` now takes its line ending from the template, and
-`--check` compares LF-normalized text, so the guard gives the same result in
-either worktree. A test in `test/payload.test.js` holds the rule.
-
-One test carried the same fault. `npm test` also runs on `prepack`, and the
-statusline graph-component test sliced a hook's source to the next `\n}\n` — a
-needle a CRLF checkout never contains. It now normalizes the source first.
-
-No shipped payload changed. The generated agent files are byte-identical.
+### v1.9.0 — the lean lanes learn to look before they leap _(2026-09-21)_
+
+`/orc-quick` and `/orc-mini` are the two lanes people reach for most, and both
+were working half blind. The code graph could tell them WHERE a symbol is and
+was forbidden from telling them WHAT BREAKS. A bug fix was never shown failing
+before it was fixed. Read-only work was dispatched by model name, so nothing in
+ORC could see it.
+
+**A bug is now shown RED before it is fixed.** A request like *"the orders page
+returns 500, find it and fix it"* is sorted as a **defect**, and the executor
+writes the reproduction FIRST — a failing test in your own framework, or a
+command — runs it red, implements, and runs it green. Both runs are printed and
+both reach the trace. A reproduction that cannot be written is `repro: none`
+with its reason, and the entry says **not reproduced** — repeated at the commit
+offer. It is never faked. Without the red run a fix is proven against your test
+suite, which was green before and after; with it, the fix is proven against the
+bug you reported.
+
+**Both lanes may now ask what breaks.** `/orc-quick` gained `map`, `changes` and
+`coverage`; `/orc-mini` gained `map`, `impact`, `changes` and `cochange`. The
+**affected tests run first** — a test that reaches the change through a URL
+included — and every entry carries a blast-radius line where a `risk` word never
+appears without its reason. A request that names no file now starts with
+`orc graph map --focus` instead of a guess at a filename.
+
+**`/orc-mini`'s complexity read carries numbers.** It was a sentence of
+judgment; it is now one line with counts and four thresholds that each state why
+that number: callers in 4 or more files outside the plan, 8 or more callers, any
+cited risk class, or a file history says is always touched alongside yours. It
+is an **offer, never a switch**, and continuing writes the numbers into the
+decision log so a later `/orc-retro` can move a threshold.
+
+**Read-only work is a real agent.** Recon is a pinned pair —
+`orc-recon-sonnet-4-6-med` and `orc-recon-opus-5-low` — with a return contract,
+visible in the trace and in `orc run inflight`. `other — name a model` stays as
+the escape hatch. The gate may now print `suggested` beside one line WITH its
+reason, and it still never chooses: every menu ends with *your choice — nothing
+runs until you answer*.
+
+**Both lanes cost less to load.** The two descriptions, which every session
+pays for, went 619 → 326 and 493 → 294 characters with every trigger phrase
+kept. The rules card in a `/orc-quick` slice is now a compact form — about 1,460
+tokens instead of 3,469 — that keeps every HARD rule's id, title and instruction
+and loses only the worked examples.
+
+**It does not lower your bill**, and this release does not claim it does. The
+claim is correctness, traceability and fewer round trips. **The live-session
+evaluation did not run** — the deterministic half is in the test suite, but the
+three gates that need a person driving a lane are unmet, not passed. The
+CHANGELOG names each one.
 
 <details>
-<summary><strong>Earlier releases</strong> — 117 of them, titles only. Full text in <a href="CHANGELOG.md">CHANGELOG.md</a>.</summary>
+<summary><strong>Earlier releases</strong> — 119 of them, titles only. Full text in <a href="CHANGELOG.md">CHANGELOG.md</a>.</summary>
 
+- **v1.8.2** — the map that finds what a grep cannot · _2026-09-21_
+- **v1.8.1** — the guard that only failed on Windows · _2026-09-16_
 - **v1.8.0** — the code graph: a map of the code that stays fresh · _2026-09-16_
 - **v1.7.1** — the rules card now reaches the agent · _2026-09-14_
 - **v1.7.0** — the rules that keep the slop out · _2026-09-13_