Mod Bash komutunu shell'siz okur ve kurduğu paketleri bulur:

• npm: npm i|install|add, pnpm add, yarn add, bun add|install;
• PyPI: pip install, pip3 install, python -m pip install, uv pip install, uv add, poetry add;
• Go: go get, go install;
• crates.io: cargo add;
• Packagist: composer require.

Local bir path, bir URL, bir git kaynağı, bir requirements dosyası (-r) ve editable kurulum (-e) kontrol edilmez. Komut başına en fazla 10 paket kontrol edilir.

Her paket için registry'ye sorar: registry.npmjs.org, pypi.org, proxy.golang.org, crates.io ya da repo.packagist.org. Bir Go paket path'i, proxy'nin bildiği en yakın üst path olan module'ü üzerinden aranır.

OSV.dev'e, kurulacak version'ın bilinen açıklarını sorar: sabitlenmiş version, yoksa en günceli.

Kurulum şu durumlarda durdurulur:

• hiçbir registry paketi tanımıyorsa;
• ad, popüler bir paket adından bir ya da iki edit uzaktaysa (7 karakterin altında bir edit, 4 karakterin altında hiç), paket bir yıldan eski ve 10 ya da daha fazla version'a sahip değilse;
• paket ilk kez 7 günden kısa süre önce yayınlandıysa; eski bir paketin yeni bir version'ı durdurulmaz;
• tam sabitlenmiş bir version (lodash@4.17.15, requests==2.25.0, tokio@=1.38.0, go get x@v1.9.0, vendor/pkg:2.0.0) en güncel değilse; sebep en günceli adlandırır, farklıysa aynı major içindeki en günceli de;
• OSV.dev o version için bilinen bir açık listeliyorsa; sebep id'leri ve onları düzelten version'ları adlandırır.

Model sebepleri komutun hatası olarak okur, en güncel version'ı ya da doğru adı kurma talimatıyla. Kullanıcının tam olarak o pakete ihtiyacı varsa model kullanıcıya sebebini söyler ve komutu DEP_SENTINEL_SKIP=1 ön eki ile tekrar çalıştırır. Mod böyle bir atlamayı log'lar.

Bir registry'ye ya da OSV.dev'e ulaşılamadığında kurulum çalışır ve model hangi paketin kontrolsüz çalıştığını ve neden çalıştığını okur. Aynı anda transcript'e bir satır yazılır, böylece siz de görürsünüz:

dep-sentinel: the install ran unchecked for: lodash (api.osv.dev answered HTTP 503)

Not ve satır ayrı iki kanaldır: model satırı hiç okumaz, siz notu hiç okumazsınız.

sidebar açıkken kontrolsüz kalan ve atlanan paketler oraya gider, paket başına bir satır, stream'in içinde kayıtlar olarak; transcript temiz kalır. Bir kayıt, yenileri onu pane'in dışına itene kadar durur. Sidebar kapalıyken ya da o mod kurulu değilken yukarıdaki transcript satırları yazılır.

Kontrolsüz kalmış bir bulgu asla hatırlanan bir cevap değildir: borçlu olduğu kontrol tekrar çalıştırılır, yani iki yoldan kapanır. Paketin sonraki bir kurulumu onu kontrol eder ve guarded bir git komutu kontrolü kendisi çalıştırır, iki modda da. Kayıt temizlenir ve yerine yenisi gelir:

dep-sentinel: a later install checked the packages that stayed unchecked: lodash
dep-sentinel: the registry and OSV.dev answered for the packages that stayed unchecked: lodash

Geç gelen cevabın söyledikleri kendi kırmızı kaydı olarak yazılır, çünkü ait olduğu kurulum çoktan çalışmıştır:

dep-sentinel: the check that was owed says: lodash@4.17.21 has 1 known vulnerability(ies) on OSV.dev: GHSA-29mw-wpgm-hmr9; fixed in 4.17.22

Sidebar kapalıyken aynı metinler transcript satırlarıdır. Model bunların hiçbirini okumaz.

Aynı kontrol her main-loop turn sonunda çalışır ve hâlâ açık olan paketler bir sonraki prompt ile modele tek not olarak ulaşır:

dep-sentinel: 1 package(s) are still installed unchecked: lodash. Run the install again so the registry and OSV.dev answer, or take the package out.

Turn başına bir not, prompt başına değil. Bu olmasa bulgu bir kere, kurulum anında söylenir ve model onu unutmuşken pane'de dururdu. Siz yeni bir şey okumazsınız: pane zaten aynı bulguyu taşır.

deny modunda mod ayrıca, bir paket kontrolsüz kaldığı sürece git commit, git push ve git merge komutlarını durdurur. Gate önce borçlu olunan kontrolü çalıştırır, yani yalnız network kapalı olduğu için başarısız olan paket gate'i kendisi açar; registry'nin hâlâ cevap vermediği bir paket komutu durdurur. Kaçış yolu yoktur; gate'i yalnız kişi /dep-sentinel mode note ile kapatır. note varsayılandır ve hiçbir git komutunu durdurmaz, ama aynı kontrolü bir git komutunda çalıştırır, böylece çözülmüş bir bulgu pane'de kalmaz. Bir kurulum iki modda da durdurulur, yukarıdaki gibi.

The mod reads the Bash command without a shell and finds the packages it installs:

• npm: npm i|install|add, pnpm add, yarn add, bun add|install;
• PyPI: pip install, pip3 install, python -m pip install, uv pip install, uv add, poetry add;
• Go: go get, go install;
• crates.io: cargo add;
• Packagist: composer require.

A local path, a URL, a git source, a requirements file (-r) and an editable install (-e) are not checked. At most 10 packages per command are checked.

For each package it asks the registry: registry.npmjs.org, pypi.org, proxy.golang.org, crates.io or repo.packagist.org. A Go package path is looked up at its module, the nearest parent path the proxy knows.

It asks OSV.dev for known vulnerabilities of the version that would be installed: the pinned version, else the latest.

The install is stopped when:

• no registry knows the package;
• the name is one or two edits from a popular package name (one edit under 7 characters, none under 4), unless the package is over a year old with 10 or more versions;
• the package was first published less than 7 days ago; a new version of an older package is not stopped;
• an exact pin (lodash@4.17.15, requests==2.25.0, tokio@=1.38.0, go get x@v1.9.0, vendor/pkg:2.0.0) is not the latest version; the reason names the latest, and the latest in the same major version when that differs;
• OSV.dev lists a known vulnerability for that version; the reason names the ids and the versions that fix them.

The model reads the reasons as the command's error, with the instruction to install the latest version or the right name. When the user needs exactly that package, the model tells the user why and runs the command again with the DEP_SENTINEL_SKIP=1 prefix. The mod logs such a skip.

When a registry or OSV.dev cannot be reached, the install runs, and the model reads which package ran unchecked and why. The same moment writes one line to the transcript, so you see it too:

dep-sentinel: the install ran unchecked for: lodash (api.osv.dev answered HTTP 503)

The note and the line are separate channels: the model never reads the line, and you never read the note.

While the sidebar is open, the unchecked packages and the skipped ones go there instead, one line per package, as entries in its stream, and the transcript stays clean. An entry stays until newer ones push it off the pane. With the sidebar closed, or without that mod installed, the transcript lines are written as above.

An unchecked finding is never a remembered answer: the check it is owed is run again, so it closes two ways. A later install of the package checks it, and a guarded git command runs the check itself, in both modes. The entry is cleared and a new one takes its place:

dep-sentinel: a later install checked the packages that stayed unchecked: lodash
dep-sentinel: the registry and OSV.dev answered for the packages that stayed unchecked: lodash

What a late answer has to say is written as its own red entry, because the install it belongs to already ran:

dep-sentinel: the check that was owed says: lodash@4.17.21 has 1 known vulnerability(ies) on OSV.dev: GHSA-29mw-wpgm-hmr9; fixed in 4.17.22

With the sidebar closed the same texts are transcript lines. The model reads nothing of this.

The same check runs at the end of each main-loop turn, and the packages that are still open reach the model as one note with its next prompt:

dep-sentinel: 1 package(s) are still installed unchecked: lodash. Run the install again so the registry and OSV.dev answer, or take the package out.

One note per turn, not one per prompt. Without this the finding would be said once, at the install, and then stand in the pane while the model forgot it. You read nothing new: the pane already carries the same finding.

In deny mode the mod also stops git commit, git push and git merge while a package stayed unchecked. The gate runs the owed check first, so the package that only failed because the network was down opens the gate by itself; a package the registry still does not answer for stops the command. There is no bypass; only the person turns the gate off with /dep-sentinel mode note. note mode is the default and stops no git command, but it runs the same check at a git command, so a settled finding does not stay in the pane. An install is stopped in both modes, as above.