d54-report
In trusted mode, can start recognized Astro development server scripts for browser review of the running app.
Audits Composer dependency advisories as part of source and dependency review.
Scans public HTTPS GitHub repositories by shallow checkout and produces Markdown/JSON reports with findings, evidence, impact, and fix advice.
Provides a reusable GitHub Actions workflow to run D54 Report scans, upload report artifacts, and optionally fail on critical findings.
In trusted mode, can start recognized simple Node development server scripts for browser review of the running app.
Audits npm dependency lockfiles for security advisories and records coverage notes such as root-lockfile workspace audits.
Supports optional model review through OpenAI Chat Completions via the openai provider configuration.
Includes source-level scanning rules for Rust projects and audits Cargo dependency advisories.
Includes source-level scanning rules for Tauri projects.
Includes source-level scanning rules for Three.js projects.
In trusted mode, can start recognized Vite development server scripts for browser review of the running app.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
D54 Report
Özet
D54 Report bir proje dizinini, GitHub deposunu veya çalışan web sayfasını inceler. Her bulgu için konum, kanıt, etki ve çözüm önerisi içeren Türkçe Markdown ve JSON raporları üretir. Düzeltme komutu seçtiğiniz bulgular için incelenebilir yamalar hazırlar. Temel tarama için hesap veya API anahtarı gerekmez.
Related MCP server: Draugr
İçindekiler
Hızlı başlangıç · English quick start · Kapsam · Model bağlantısı · Düzeltme · GitHub Actions · MCP sunucusu · Derin inceleme · Ajanlar
Hızlı başlangıç
Node.js 20 veya üstü, npm ve Git kurulu olmalıdır. Klonladığınız D54 Report dizininde çalıştırın.
npm ci
npm run build
npx --no-install playwright install chromium
npm link
d54-report scan --path ./demo-app --no-llm --out ./reports/demoLinux'ta Chromium sistem kütüphaneleri eksikse
npx --no-install playwright install --with-deps chromium kullanın. Global
komut kurmadan depoda node dist/cli.js ile aynı seçenekleri kullanabilirsiniz.
Yerel demo, otomatik önizleme için kökte bir index.html içerir.
Demo kaynakları · Örnek rapor ve çıktılar
English quick start
From a clean checkout, use Node.js 20 or newer. Run npm ci and
npm run build. To enable visual review, run
npx --no-install playwright install chromium. Use npm link if you want the
d54-report executable on your PATH. The following command inspects the bundled
example, prints a JSON report and saves both Markdown and JSON to disk.
node dist/cli.js scan --path ./demo-app --no-llm --no-browser --json --out ./reports/sourceTo preview fixes for the low-severity findings in the latest report for this demo, run the following command. It checks candidates in a temporary copy and writes the preview to stderr. The JSON result identifies checks that require trusted mode.
node dist/cli.js fix --path ./demo-app --out ./reports/source \
--severity low --dry-run --no-llm --jsonUse --path for local source, --repo for a public HTTPS GitHub repository,
and --url for an already running page. A URL can accompany either source
option. Only add --trusted to a reviewed local project when you authorize its
build and validation commands. Read coverage before interpreting the health
score. Agent command contract
Coverage and fix modes
Source rules cover syntax and imports, security review signals, dependencies,
performance, logic errors, Three.js, Rust and Tauri. Browser review samples the
initial desktop, tablet and mobile layouts. It allows same-origin GET/HEAD
requests. A root index.html can be previewed locally. Trusted mode also
supports recognized Vite, Next, Astro and Node development server scripts.
Security findings use source evidence, dependency advisories and observed page
headers. A finding may need manual confirmation.
Dependency advisories support npm (package-lock.json / npm-shrinkwrap.json),
Cargo, Composer and pinned requirements.txt (pnpm-lock.yaml and yarn.lock
are not supported). npm workspace lockfiles are audited from the root lockfile,
so a member without its own lockfile receives a "kök kilidiyle denetlendi"
note in coverage. npm package aliases are audited under their real package
name, while entries with a non-npm source, invalid name/version or a skipped
parent package are individually omitted and counted in coverage. When
pip-audit is missing, coverage suggests pipx install pip-audit. On
untrusted projects, type, lint and build checks are skipped; pass --trusted on
the CLI, or have the operator set D54_MCP_TRUSTED_ROOT for MCP (reviewed
local projects only).
summary.counts records each severity and summary.health scores completed
checks. Use findings[].id to select issues. The default fix --mode patch
saves a diff. Interactive mode prompts before changing a file. PR mode requires
approval to create a branch, push it and open a draft pull request. Use the
status in results[] to distinguish verification, application and publication.
Fix statuses and exit codes
Provider configuration
The default scan runs without a model account or key. Optional model review
sends filtered structural lines and file paths from up to six source files.
Set D54_PROVIDER, D54_MODEL and D54_API_KEY in the operator environment.
When using an environment credential, set the endpoint or provider in the same
environment. Use --config to authorize a reviewed file with a custom endpoint.
For openai-compatible, set D54_BASE_URL to the Chat Completions API base.
A local server may accept requests without a key. openai, deepseek and
glm use Chat Completions. anthropic uses Messages with the
anthropic-version: 2023-06-01 header. An operator-controlled JSON file can
supply llm.provider, llm.model and llm.base_url through --config.
Anthropic Messages ·
Z.AI Chat Completion
--no-llm disables model calls. Default advisory tools may contact public
services using package names and versions from isolated, sanitized inputs. For
offline source review, use an installed CLI, a local target, --no-browser and
--no-llm in an environment with external networking disabled. Check
coverage for unavailable advisory results.
GitHub Actions setup in English
Copy templates/github-action-d54-report.yml into the target repository under
.github/workflows/d54-report.yml. Set the repository variables
D54_REPORT_REPOSITORY to the scanner's owner/repo and D54_REPORT_REF to
its reviewed, full 40-character commit SHA. Runs upload a d54-report
artifact. The critical threshold is enabled by default. Set the variable
D54_FAIL_ON_CRITICAL=false to disable it on push/PR, or use the manual
fail-on-critical input. For optional model review on push/manual runs, set
the secret D54_API_KEY and variables D54_PROVIDER, D54_MODEL and,
when applicable, D54_BASE_URL. PR scans always run with --no-llm. To
publish a numeric summary on fork PRs, add the optional companion workflow to
the default branch. Scan workflow ·
Fork summary workflow
Key scan features
False-positive reduction: Public prefixes (
NEXT_PUBLIC_,VITE_, etc.), paths, spaced strings, and dot-notation paths are skipped; recognized key formats (AWS, GitHub, Slack) stayhigh; tracked service account JSONs triggercriticalwhile gitignored copies drop tolow.Capped health score: Penalties are calculated with strict caps per severity (Critical 30, High 20, Medium 10, Low 5; worst score 35) on a 100-point scale (
puan = 100 - penalty).Suppression file (
.d54report-ignore): Findings can be excluded via<rule|*> <path-glob>[:line] # <reason>in the target root. Reasons are mandatory; suppressed counts and suppressed real credentials are explicitly tracked.Compact MCP summary:
d54_scan_projectcaps critical/high findings at 25 items and truncates evidence/impact/advice to 200 characters to conserve agent context.
Triage
Optional model triage can be enabled with scan --triage on the CLI (with a configured model) or use_llm: true, triage: true in MCP d54_scan_project. Only the first 30 critical and high findings with source context (excluding secret-value findings) are sent, using a ±15 line window where detected sensitive lines are masked as <gizli satır>; catching every secret is not guaranteed — do not use triage on repositories containing real secrets. Model verdicts are informational only: no findings are removed and the health score does not change. Enabling triage sends scanned code snippets to the configured model provider and incurs API cost.
Tarama kapsamı
Hedef | Komut veya örnek | Kanıt |
Yerel kaynak |
| Dosya, satır ve statik kural |
GitHub deposu |
| HTTPS ile geçici, sığ checkout. Değişkene tam depo URL'sini verin |
Çalışan sayfa |
| URL, viewport, CSS seçicisi ve varsa ekran görüntüsü |
Kaynak ve sayfa |
| Aynı raporda kaynak ve tarayıcı bulguları |
URL örnekleri için ayrı bir terminalde npm --prefix demo-app start çalıştırın.
Özel GitHub depoları için yerel checkout yolunu verin. Kaynak kökünde
index.html bulunuyorsa CLI geçici bir statik sunucu açar. Uygulamanız
geliştirme sunucusu veya giriş oturumu gerektiriyorsa seçtiğiniz URL'nin anonim
ilk görünümü ölçülür.
Yerel projede --trusted verilirse CLI önce desteklenen bir npm dev veya
start betiği arar. Tanınan Vite, Next, Astro ve basit Node sunucularını geçici
bir loopback portunda başlatır. Tarama sonrasında süreci kapatır. Diğer
uygulamalarda kökteki statik index.html veya sizin verdiğiniz --url
kullanılır.
Bölüm | Denetlenen örnekler |
Kod sağlığı | JS/TS ve Python sözdizimi, JSON/YAML/TOML, göreli içe aktarımlar, ortam şablonları, boş catch |
Güvenlik | Kaynakta gizli değer örüntüleri, riskli SQL ve HTML oluşturma, yetkilendirme işaretleri, bağımlılık duyuruları |
Stabilite ve hız | Döngüde G/Ç, seri bekleme, yinelenen sorgular, büyük varlıklar, kapanış ve zaman aşımı yolları |
UI/UX | Masaüstü 1440×900, tablet 768×1024 ve mobil 390×844 boyutlarında taşma, okunabilirlik, çakışma ve erişilebilirlik örnekleri |
Mantık | Async forEach, sıfır bölen, NaN karşılaştırması, boş koleksiyon ve sınır koşulları |
Uzmanlık | Three.js kaynak temizliği, RAF, bağlam kaybı, Rust panic/unsafe ve Tauri izinleri |
Güvenlik incelemesi statik kaynak sinyallerine, yayımlanmış bağımlılık duyurularına ve normal sayfa yüklemesinde görülen başlıklara dayanır. Bir kaynağın veri akışını ve erişim yetkisini uygulama bağlamında doğrulayın. Playwright her boyutta bir sayfa açar ve yalnız aynı kökenden GET/HEAD isteklerini geçirir. Dış fontlar, CDN varlıkları ve kimlik doğrulaması gerektiren içerik bu nedenle eksik görünebilir. İlk görünümde en çok 3.000 DOM öğesi ve 180 kutu örneklenir. Ölçümler tek bir laboratuvar oturumuna aittir.
Chromium sandbox varsayılan olarak açıktır. Kurulu Chromium için
D54_CHROMIUM_PATH değişkenini kullanabilirsiniz. Sandbox desteği bulunmayan
yalıtılmış bir test ortamında, yalnız kendi güvendiğiniz demo için tek komutluk
istisna tanımlayabilirsiniz.
D54_CHROMIUM_SANDBOX=0 d54-report scan --path ./demo-app --no-llmBağımlılıklar, ağ ve kapsam notları
Varsayılan bağımlılık denetimi geçici dizin ve ayrı bir ev dizini kullanır. npm
(package-lock.json / npm-shrinkwrap.json), Cargo ve Composer için
desteklenen kilit dosyasından, pip için tam sürüme sabitlenmiş
requirements.txt dosyasından temizlenmiş denetim girdisi üretir (pnpm-lock.yaml
ve yarn.lock desteklenmez). npm workspace kilitleri kök kilitten denetlenir;
kendi kilidi olmayan üye coverage içinde "kök kilidiyle denetlendi" notu
alır. npm takma adları gerçek paket adıyla denetlenir; npm dışı kaynak, geçersiz
ad/sürüm veya atlanan üst pakete bağlı girdiler ise tek tek dışarıda bırakılır
ve kapsam notunda sayılır. Paket adları ve sürümleri genel danışmanlık
hizmetlerine gönderilebilir. Araçlar sırasıyla npm, cargo-audit, composer
ve pip-audit olarak PATH üzerinden bulunur; pip-audit yoksa kurulum için
pipx install pip-audit ipucu verilir. Eksik araç, güvenle okunamayan girdi, ağ
hatası veya zaman aşımı raporun coverage alanında görünür.
--no-llm model yapılandırmasını ve model çağrılarını kapatır. Uzak depo, canlı
URL ve danışmanlık hizmetleri ayrı ağ işlemleridir. Çevrimdışı çalışırken kurulu
CLI'ı kullanın, yerel bir --path seçin ve tarayıcı gerekmiyorsa --no-browser
verin. Dış ağın kapalı olduğu ortamda danışmanlık sonuçları kısmi kalabilir.
Güvenilmeyen projede tip, lint ve derleme denetimleri atlanır; CLI'da
--trusted, MCP için ise operatör D54_MCP_TRUSTED_ROOT ayarlar (yalnız
incelenmiş yerel projede). --trusted TypeScript, mypy, PHP lint, PHPStan,
cargo check/clippy/build ve tanımlı npm build gibi proje komutlarını
etkinleştirir. Bu komutlar proje kodunu ve yapılandırmasını kullanabilir. Kaynak
toplamada sembolik bağlantılar ve derleme dizinleri atlanır. Dosya içeriği
başına 4 MiB ve toplamda 48 MiB okuma bütçesi vardır. Büyük dosyalar veya kilit
dosyaları genel kaynak taramasına yalnız boyut bilgisiyle girebilir.
Yanlış alarm azaltma
Tarama motoru, gereksiz uyarıları önlemek ve gürültüyü azaltmak için bağlamsal filtreler uygular:
Genel anahtarlar ve istemci değerleri:
NEXT_PUBLIC_,EXPO_PUBLIC_,VITE_veyaPUBLIC_önekli değişkenler ile adında "public" geçen değerler atlanır.pk.ile başlayan veya.apps.googleusercontent.comile biten istemci anahtarları yoksayılır.Yol ve metin filtreleri: yalnız küçük harfli rota biçimindeki
/ile başlayan değerler (ör./reset-password; büyük harf içeren/Xk2…gibi değerler raporlanır), boşluk içeren dizgiler ve en çok 60 karakterlik harf-nokta yolları (ör.users.verifyEmailToken) kimlik bilgisi kabul edilmez.Test ve CI ortamları: Test/fixture dosyaları ve GitHub Actions iş akışlarındaki (
.github/workflows/)services:bloklarında bulunan kimlik bilgilerilowseviyesine indirilir.Tanınan anahtarlar: AWS, GitHub, Slack anahtarları veya özel anahtar (
PRIVATE KEY) blokları gibi bilinen biçimler her zamanhighönem derecesindedir.Servis hesabı JSON dosyaları: Git tarafından izleniyorsa
critical,.gitignoreile dışlanmışsalowolarak işaretlenir.SQL sorguları: Şablon içindeki tüm
${}ifadeleri güvenli/izinli sabitlerden oluşuyor ve değerler sorguya parametre dizisiyle aktarılıyorsalow, aksi durumdahighatanır.
Bilinen ödünleşimler: Boşluk içeren parolalar ve adında "public" geçen gizli değerler bu kurallar nedeniyle atlanır.
Sağlık puanı
Sağlık puanı 100 üzerinden hesaplanır. Her önem derecesinin puan cezası tavan değerle sınırlandırılır:
$$\text{penalty} = \sum \min(\text{tavan}, \text{sayı} \times \text{ağırlık})$$ $$\text{puan} = 100 - \text{penalty}$$
Önem Seviyesi | Ağırlık (Ceza / Adet) | Tavan Ceza |
| 15 | 30 |
| 7 | 20 |
| 3 | 10 |
| 1 | 5 |
Tavanların toplamı 65 olduğundan en kötü puan 35'tir.
Bulgu bastırma (.d54report-ignore)
Hedef proje kökündeki .d54report-ignore dosyasıyla bilinen veya beklenen bulgular bastırılabilir:
Satır biçimi:
<kural|*> <yol-glob>[:<satır>] # <gerekçe>Zorunlu gerekçe: Her kuraldan sonra
#ile gerekçe belirtilmelidir; gerekçesiz satırlar yoksayılır ve rapor kapsam notlarında listelenir.Glob kuralları:
*tek bir yol segmenti içinde eşleşir.**tek başına bir segment olarak sıfır veya daha çok klasörle eşleşir (segment içinde geçen**tek*sayılır). Kural deseni en fazla 256 karakter olabilir.Dosya sınırları: Dosya boyutu en çok 256 KiB olabilir; sembolik bağlar (symlink) okunmaz.
Puan ve rapor etkisi: Bastırılan bulgular sağlık puanı cezasını etkilemez. Raporda "Bastırılan · N" ve ayrıca "Bastırılan gerçek biçimli anahtar · N" sayaçlarında gösterilir.
Uyarı: Güvenilmeyen bir depoyu tararken o depo kendi bulgularını bu dosyayla gizleyebilir; raporlanan bastırılan bulgu sayısını mutlaka inceleyin.
Kural kimliği JSON raporundaki rule alanındadır.
Örnek satırlar:
security.literal-secret tests/fixtures/** # Test senaryolarında kullanılan sahte anahtarlar
security.sql-construction src/legacy/query.ts:45 # Tablo adı allowlist doğrulamalı sabit metindir
* docs/examples/* # Belgelerdeki sözde kod örnekleriMCP özeti
Model Context Protocol (MCP) üzerinden çağrılan d54_scan_project aracı kompakt bir özet döndürür:
critical_high: Önem derecesine göre sıralı en çok 25 öğe (önem→kural→dosya→satır).critical_high_total: Kritik ve yüksek öncelikli toplam bulgu sayısı.rule_counts: Kural bazındacritical,highvemediumbulgu sayıları.Alan kırpma: Bağlam tasarrufu sağlamak için
evidence,impactveadvicealanları en fazla 200 karakterde kesilir; eksiksiz bulgu listesi rapor dosyalarında tutulur.Git deposu uyarısı: Hedef bir Git deposuysa ve
reports/dizini.gitignoreiçinde dışlanmamışsa kapsam notunda uyarı verilir.
Model bağlantısı
Sağlayıcı ayarlanmadığında deterministik kurallar kullanılabilir. Model incelemesi için sağlayıcınızdaki model kimliğini kullanın. API hesabı, model erişimi ve ücretlendirme model hizmetine aittir. Bir editör aboneliğinin API erişimi sağlayıp sağlamadığını o hizmetin hesabında kontrol edin.
| Protokol | Ayar |
| Anthropic Messages, | Model ve anahtar |
| OpenAI Chat Completions, | Model ve anahtar, sağlayıcıya göre varsayılan taban URL |
| OpenAI Chat Completions uyumlu uç nokta | Model, taban URL ve hizmet istiyorsa anahtar |
| Model çağrıları kapalı | Yerel kurallar |
d54-report.config.json çalışma dizininde aranır. --config ile operatöre ait
bir dosya seçebilirsiniz. Sağlayıcı alanları llm nesnesinde veya JSON kökünde
olabilir. Aynı dizindeki .env okunur. Öncelik süreç ortamı, .env ve JSON
ayarları sırasındadır. Anahtarı kabuk ortamında veya sürüm kontrolü dışında
tuttuğunuz .env dosyasında D54_API_KEY olarak verin. Anahtar ile sağlayıcıyı
veya uç noktayı aynı ortamda tanımlayın. Özel uç noktayı incelenmiş bir
JSON dosyasından kullanmak için o dosyayı --config ile seçin.
Ortam şablonu
Aşağıdaki örnekte model alanını yerel sunucuda yüklü modelin kimliğiyle
değiştirin. Taban URL'ye protokol yolunu CLI ekler. Uzak sunucularda HTTPS,
loopback adreslerinde HTTP de kullanılabilir.
{
"llm": {
"provider": "openai-compatible",
"base_url": "http://127.0.0.1:11434/v1",
"model": "YOUR_LOCAL_MODEL"
}
}d54-report scan --path ./demo-app --config ./d54-report.config.jsonModel incelemesi en çok altı dosyadan seçilmiş yapısal satırları ve dosya yollarını sağlayıcıya iletir. Her dosyada en çok 48 satır seçilir. Metin sabitleri ve hassas içerik örüntüleri filtrelenir. Yetkilendirme, lisans kontrolü, hız sınırı, yarış koşulu ve iş kuralı önerileri insan incelemesi gerektirir. Model destekli JS/TS düzeltmesinde ilgili satır çevresindeki maskelenmiş pencere gönderilir.
Triyaj
İsteğe bağlı model triyajı CLI'da scan --triage (yapılandırılmış model ile), MCP d54_scan_project aracında use_llm: true, triage: true ile açılır. Yalnız ilk 30 critical ve high bulgu (gizli değer bulguları hariç), ±15 satırlık kaynak bağlamıyla değerlendirilir; tespit edilen hassas satırlar <gizli satır> olarak maskelenir; tüm sırları yakalama garantisi yoktur — gizli içerikli depolarda triyajı kullanmayın. Model kararı yalnızca bilgi amaçlıdır: hiçbir bulgu silinmez ve sağlık puanı değişmez. Triyaj açıldığında taranan kod parçaları yapılandırılmış modele veri olarak gönderilir ve kullanım maliyeti oluşturur.
Düzeltme
Önce yerel projeyi tarayın. Aşağıdaki örnek son rapordaki bağlantı kuralının kimliğini okuyup yalnız o bulgunun yamasını gösterir. Komutlar Bash ve temiz checkout içindir.
mkdir -p reports/demo
d54-report scan --path demo-app --out reports/demo --no-browser --no-llm --json > reports/demo/selected.json
finding_id=$(node -p "require('./reports/demo/selected.json').findings.find(f => f.rule === 'security.target-blank').id")
d54-report fix --path demo-app --report reports/demo/selected.json --out reports/demo --ids "$finding_id" --dry-run --trusted --no-llmSeçim | Davranış |
| Varsayılan mod. Birleşik diff dosyalarını çıktı dizinindeki |
| Terminalde farkı gösterir. |
| Onaylanan doğrulanmış yamaları ayrı Git worktree içinde denetler. Dal ve commit oluşturup origin'e göndermeyi ve taslak PR açmayı dener |
| Uygulanabilir farkları stderr'de gösterir. Model düzeltmesi kapalıdır |
| Virgülle ayrılmış rapor kimlikleri veya |
| Var olan çalışma alanı değişikliklerine rağmen ilerlemeye izin verir |
| PR modunda dal, commit, push ve taslak PR için etkileşimsiz onay verir |
--report verilmezse çıktı dizininde aynı yerel köke ait en son D54 JSON raporu
seçilir. Her aday geçici kopyada uygulanıp yeniden taranır. Bildirilen kanıtın
giderilmesi ve yeni bulgu oluşmaması aranır. Projede tanımlı kontrolleri
çalıştırmak için --trusted gerekir. HTML bağlantı düzeltmesi deterministiktir.
Uygun hedeflerde yerel araç veya yapılandırılmış model aday yama üretebilir. Her
bulgunun otomatik düzeltmesi olmayabilir.
Modelin ürettiği fark önce Git denetiminden ve proje komutu çalıştırmayan bir
kaynak taramasından geçer. patch modu ve MCP bu farkı PATCH_UNVERIFIED
olarak dışa aktarır. Model yamasıyla proje kontrollerini çalıştırmak için
gerçek bir terminalde --trusted ile interactive veya pr modunu kullanın.
CLI dosyayı ve farkı gösterdikten sonra bu yamayı çalıştırmak için ayrı onay
ister. Uygulama veya PR yayımlama onayı doğrulama sonrasında geçerlidir.
Makine çıktısı için --json kullanın. Tarama JSON'u schemaVersion, target,
stack, filesScanned, coverage, summary, findings ve priority içerir.
Sağlık puanı tamamlanan denetimlerin ağırlıklı bulgularından hesaplanır.
Düzeltme çıktısında her sonuç için id, status ve varsa detail yer alır.
patchPath oluşturulan yamanın yoludur. verification her adım için
passed, failed veya skipped durumunu bildirir. Çıkış kodları ve durum
adları ajan sözleşmesinde listelenir.
Ajan sözleşmesi
GitHub Actions
Bu depodaki iş akışları D54 Report'un kendisini tarar. Başka bir projede
şablonları varsayılan daldaki .github/workflows/ dizinine kopyalayın.
Aşağıdaki komutları D54 checkout'undan çalıştırırken TARGET_REPO değişkenine
hedef yerel depo yolunu verin.
mkdir -p "$TARGET_REPO/.github/workflows"
cp templates/github-action-d54-report.yml "$TARGET_REPO/.github/workflows/d54-report.yml"
cp templates/github-action-d54-fork-comment.yml "$TARGET_REPO/.github/workflows/d54-fork-comment.yml"Hedef deponun Settings → Secrets and variables → Actions → Variables bölümüne
D54_REPORT_REPOSITORYolarak tarayıcı deposununowner/repoadını girin.D54_REPORT_REFiçin o depoda erişilebilen, incelediğiniz sürümün tam 40 karakterlik commit SHA'sını girin. Erişilebilir bir tarayıcı deposu gerekir.Push, pull request veya manuel çalıştırmada workflow sabitlenmiş tarayıcıyı kurar, hedefi varsayılan olarak
--no-llmile tarar ved54-reportartifact'ine raporları yükler. Push ve manuel çalıştırmada isteğe bağlı model içinD54_API_KEYdepo secret'ını,D54_PROVIDERveD54_MODELdepo değişkenlerini tanımlayın. Özel taban URL gerekiyorsaD54_BASE_URLdeğişkenini ekleyin. PR taramaları her zaman--no-llmkullanır. Aynı depodan gelen PR'larda sayı ve sağlık özeti yorum olarak güncellenir.İkinci şablon fork PR'larındaki özet yorumu için isteğe bağlıdır. Varsayılan daldaki ayrı
workflow_runişi yalnız sayısal iş özetini ve eşleşen PR kimliğini kullanır. CI şablonu · Fork yorum şablonuKritik bulgular varsayılan olarak CI eşiğini tetikler. Push/PR için kapatmak üzere
D54_FAIL_ON_CRITICAL=falsedepo değişkenini tanımlayın. Manuel çalıştırmadafail-on-criticalgirdisini seçin. Yerel eşdeğerid54-report scan --path demo-app --no-llm --fail-on-criticalkomutudur.
MCP sunucusu
Node.js 20+ ile D54 checkout'unda aşağıdaki komutları çalıştırın.
npm link, CLI ile birlikte d54-report-mcp yürütülebilirini de npm'in
global komut dizinine bağlar. İstemci bu komutu bir alt süreç olarak başlatır
ve MCP mesajlarını stdin/stdout üzerinden taşır. Günlükler stderr'e gider.
npm ci
npm run build
npm linkClaude Code ve JSON kullanan istemciler
Claude Code için aşağıdaki içeriği hedef projenin kökündeki .mcp.json
dosyasına ekleyin. Aynı mcpServers biçimini kabul eden diğer istemcilerin
MCP ayarlarında da bu nesne kullanılabilir. İstemcinin PATH'i global npm
komutlarını içermiyorsa command alanına yürütülebilirin mutlak yolunu verin.
Claude Code MCP belgesi
{
"mcpServers": {
"d54-report": {
"command": "d54-report-mcp",
"args": []
}
}
}Codex
Codex CLI ile kaydedip yapılandırılmış sunucuyu listeleyebilirsiniz. Codex MCP belgesi
codex mcp add d54-report -- d54-report-mcp
codex mcp listKullanıcı düzeyindeki ~/.codex/config.toml içinde eşdeğer kayıt şöyledir.
[mcp_servers.d54-report]
command = "d54-report-mcp"
args = []Codex App Server'a bağlı, başlatılmış bir istemci aynı ayarı aşağıdaki JSON
isteğiyle kullanıcı yapılandırmasına yazabilir. upsert belirtilen kayıt
alanlarını günceller. Resmi parametre şeması
{
"id": 1,
"method": "config/value/write",
"params": {
"keyPath": "mcp_servers.d54-report",
"value": { "command": "d54-report-mcp", "args": [] },
"mergeStrategy": "upsert"
}
}Araçlar ve örnek çağrılar
İlk istekte path olarak MCP sunucusunun makinesindeki proje dizinini seçin.
Sonraki isteklerde örnek rapor yollarını ilk yanıtın döndürdüğü gerçek yollarla
değiştirin. Tarama ve düzeltme sonuçları hem structuredContent hem de JSON
metni olarak gelir.
d54_scan_project yerel path ister. url isteğe bağlı çalışan sayfa,
use_llm varsayılan olarak false, modules ise isteğe bağlı kategori
listesidir. Liste verilmezse altı modül seçilir. Geçerli adlar errors,
security, performance, ui, bugs ve specialized değerleridir.
Yalnız seçili denetimler çalışır. Model incelemesi için security seçilmeli
ve use_llm açık olmalıdır.
{
"path": "/work/project",
"modules": ["errors", "bugs"],
"use_llm": false
}Yanıtta summary toplamı, önem sayıları ve sağlık puanını verir.
report_paths.markdown ve report_paths.json seçilen projenin reports/
dizinindeki dosyalardır. critical_high kritik ve yüksek bulguları,
modules seçilen modülleri, coverage kapsam notlarını,
browser_unavailable istenen tarayıcı denetiminin durumunu bildirir.
scan_incomplete istenen taramanın eksik kaldığını gösterir. Nedeni coverage alanında yer alır.
Diğer önem düzeyleri tam raporda bulunur.
d54_fix_findings için report_path yerel proje kökünü içeren D54 JSON
raporudur. mode değeri patch (varsayılan) veya pr olabilir. ids ve
severity filtreleri liste veya virgülle ayrılmış metin kabul eder.
dry_run varsayılan olarak false değerindedir. Aşağıdaki örnekte
seçtiğiniz kimlik raporda bulunmalıdır.
{
"report_path": "/work/project/reports/selected.json",
"mode": "patch",
"ids": ["ERR-001"],
"dry_run": true
}patch_paths oluşturulan yama dosyalarını, successful doğrulanan
PATCH_CREATED, PR_CREATED veya DRY_RUN sonuçlarını, rolled_back
başarısız geri alınanları listeler. Tüm durumlar results içinde bulunur.
Her kayıt id ve status içerir. Gerektiğinde detail, patchPath ve
verification eklenir. Doğrulama adımlarında stage, status
(passed, failed, skipped) ve varsa detail okunabilir.
d54_get_report yalnız report_path alır ve Markdown belgesini eksiksiz
MCP metin içeriğinde döndürür. Markdown dosyasının kendisini veya aynı adlı
Markdown dosyası yanında bulunan D54 JSON raporunu seçin.
{ "report_path": "/work/project/reports/selected.md" }Operatör ayarları
D54_MCP_TRUSTED_ROOTtek bir yerel proje kökünü yetkilendirir. Sunucu sembolik bağlantıları çözdükten sonra tam yol eşitliği arar. Bu eşleşme proje komutlarının ve düzeltme doğrulamalarının çalışmasına izin verir.D54_MCP_CONFIG, sunucu operatörüne ait model yapılandırmasının yoludur. Dosya verilmediğinde model ayarları sunucu işlem ortamından alınır.D54_MCP_FIX_LLM=1gerçek düzeltme çağrılarında isteğe bağlı model kullanımını etkinleştirir. MCP model yamalarını inceleme için dosyaya kaydeder. Dry run model düzeltmesi çağırmaz.Bir taslak PR yayımlamak için istemci, etkileşimli MCP formunda açık kullanıcı onayı alır. Operatörün tek bir proje için yayına önceden izin vermesi de mümkündür. Bu durumda tam
D54_MCP_TRUSTED_ROOTeşleşmesi veD54_MCP_ALLOW_PR=1birlikte gerekir. Yayımlama dal, commit, push ve taslak PR işlemlerini kapsar.
MCP in English
Build the checkout, run npm link and configure your stdio client to launch
d54-report-mcp. Use the Claude Code JSON or Codex TOML above. Pass a local
directory and optional modules to d54_scan_project. Read coverage and
use the returned report_paths.json for d54_fix_findings or
report_paths.markdown for d54_get_report. For a preview, supply
dry_run: true. Use the status of each result to distinguish saved patches
from completed verification. Agent contract
Derin inceleme (ajan modu)
Derin incelemenin ajan modu tamamen ücretsizdir: D54 Report dışarıya model
çağrısı yapmaz ve D54_API_KEY gerektirmez; inceleme, aracı çalıştıran
kodlama ajanının (Claude Code, Codex vb.) kendi aboneliği üzerinden yürütülür.
Hazırlama (
d54_deep_review_prepare/d54-report deep prepare): Risk puanı yüksek dosyaları (veya--since <ref>ile yalnız değişen aralıkları) seçer, fonksiyonları AST ve pencerelerle böler, gerçek sır biçimlerini<gizli satır>olarak maskeler ve satır numaralı parçaları<rapor-dizini>/deep/<oturum>/chunk-NN.txtdosyalarına yazar.İnceleme ve şüpheci doğrulama: Ajan parça dosyalarını okur, mantık ve işlevsellik adaylarını çıkarır, her adayı ayrı bir doğrulama adımıyla çürütmeye çalışır ve yalnız
confirmedolanları gönderir.Denetim ve birleştirme (
d54_deep_review_submit/d54-report deep submit): D54 Report oturum kimliğini, kaynak dosyanın SHA-256 özetini (kaynak değişti), parça satır aralığını, gizli satır yasağını, boşluk normalleştirilmiş birebirquoteeşleşmesini, metin sınırlarını ve önem tavanını (criticalyalnızauthzvebusiness-rule, diğerlerinde en çokhigh) denetler. Geçerli bulgularDerin inceleme (ajan)başlığıyla en son rapora birleştirilir ve sağlık puanı yeniden hesaplanır.
d54-report deep prepare --path ./demo-app --out ./reports/demo
d54-report deep submit --path ./demo-app --session <oturum> \
--findings ./findings.json --out ./reports/demoSınırlar: D54 Report ajanın ikinci doğrulamayı gerçekten yaptığını kanıtlayamaz (ajan doğrulamasını kanıtlayamaz); buna karşılık uydurma satır, değişmiş dosya, gizli satır ve eşleşmeyen kod alıntılarını kesin olarak reddeder.
Derin inceleme — API modu
API modu, D54 Report'un yapılandırılmış model sağlayıcısını (D54_PROVIDER,
D54_MODEL, D54_API_KEY veya --config) kullanarak riskli kod parçalarını
doğrudan incelemesini ve her adayı ayrı bir şüpheci çağrıyla doğrulamasını
sağlar.
Maliyet uyarısı:
deep runved54_deep_review_rungerçek dış model çağrıları yapar ve API kullanım maliyeti doğurur. Toplam çağrı sayısı--budget(varsayılan40, en çok200) ile sınırlanır; bulma çağrıları bütçenin yarısını geçmez, kalan bütçe doğrulamaya ayrılır.
d54-report deep run --path ./demo-app --budget 40 --out ./reports/demo
# İsteğe bağlı fark ve yapılandırma seçenekleri:
d54-report deep run --path ./demo-app --since main --files 8 --budget 20 --config ./d54-report.config.jsonMCP üzerinden aynı akış d54_deep_review_run({ path, since?, files?, budget? })
aracıyla çalıştırılır (D54_MCP_CONFIG veya sunucu ortamındaki sağlayıcı
ayarları gerekir). Kabul edilen bulgular Derin inceleme · başlığıyla en son
rapora birleştirilir ve kapsam notuna model adı, çağrı sayısı ve giriş/çıkış
jeton kullanımı eklenir. (scan --deep-review bayrağı bu aşamada yer almaz;
yalnız deep run ve d54_deep_review_run kullanılır.)
Deep review (agent mode)
Agent-mode deep review is free on the D54 Report side: D54 Report makes no external model calls and needs no API key, relying instead on the calling coding agent's own subscription (Claude Code, Codex, etc.).
Prepare (
d54_deep_review_prepare/d54-report deep prepare): Ranks risky source files (or--since <ref>diff hunks), chunks functions via AST and sliding windows, masks secret-formatted lines as<gizli satır>, and writes numberedchunk-NN.txtfiles plussession.jsonunder<out>/deep/<session>/.Agent verification: The agent inspects the chunk files, tries to refute each candidate in a separate skeptical check, and submits only
confirmeddefects.Submit (
d54_deep_review_submit/d54-report deep submit): D54 Report enforces session path safety, unchanged file SHA-256 hashes, chunk line bounds, unmasked lines, whitespace-normalizedquotematching, text/secret filters, and severity caps (criticalonly forauthzandbusiness-rule), then merges accepted findings into the latest report and recomputes health.
Limitations: D54 Report cannot prove that the agent performed an
independent verification pass ("ajan doğrulamasını kanıtlayamaz"), so it
enforces strict line, hash, and exact-quote checks and labels findings with
Derin inceleme (ajan).
Deep review — API mode
API mode lets D54 Report run the discovery and skeptical verification passes
directly against your configured LLM provider (D54_PROVIDER, D54_MODEL,
D54_API_KEY, or --config), sharing the same strict line, hash, quote, and
severity-cap checks before merging into the report.
Cost warning:
deep runandd54_deep_review_runmake external model calls and incur API cost. Total calls are capped by--budget(default40, max200), with at most half spent on discovery and the rest reserved for per-candidate skeptical verification.
d54-report deep run --path ./demo-app --budget 40 --out ./reports/demoIn MCP, call d54_deep_review_run({ path, since?, files?, budget? }) using
the server's D54_MCP_CONFIG or provider environment variables. Accepted
findings are titled Derin inceleme · <title> and the coverage note records
call and input/output token counts. (scan --deep-review is not included; use
deep run or d54_deep_review_run.)
Lisans / License
PolyForm Noncommercial 1.0.0. Lisans metni / License text
Ticari olmayan her amaçla ücretsiz kullanabilir, değiştirebilir, geliştirebilir ve paylaşabilirsiniz.
Dağıtırken lisans metnini ve
Required Notice:satırını korumanız gerekir.Lisans: Mucip ÖZ - elithost.com.tr (sm@elithost.com.tr)
Ticari kullanım ve satış izni yoktur.
Free to use, modify, improve and share for any noncommercial purpose.
When distributing, keep the license text and the
Required Notice:line.Licensor: Mucip ÖZ - elithost.com.tr (sm@elithost.com.tr)
Commercial use and selling are not permitted.
Bu depo daha önce MIT lisansıyla yayımlanıyordu; yeni lisans bu değişiklikten sonraki sürümler için geçerlidir. / This repository was previously released under MIT; the new license applies to versions after this change.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Generate SBOMs, scan vulnerabilities, and analyze dependencies from local projects or Git repos.
Security scanning for code, containers and IaC: request scans, read findings, report fixes.
Security scanner for AI-written code: SAST, secrets, dependencies, IaC, containers and DAST.
Screens public GitHub repos and PRs to generate risk maps, findings, and merge-readiness signals.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to scan code for security and quality issues and receive machine-readable reports with suggested fixes and verification criteria.80 npm2MIT

Draugrofficial
AlicenseAqualityAmaintenanceSecurity scanning for AI agents: SAST, SCA, secrets, IaC, DAST, ranked by real risk.61330Apache 2.0- AlicenseNot gradedqualityAmaintenanceEnables AI agents to submit code files for analysis and receive rule-based findings with severities, line numbers, and SARIF fingerprints, covering security, complexity, and dependency/configuration drift.7MIT
- AlicenseAqualityBmaintenanceSecurity checks for code an AI agent is about to trust. vetcode_guard checks a command before it installs packages or adds an MCP server: made-up names, look-alikes, malware advisories, brand-new releases, and the archive read without running it. vetcode_scan reads a folder for malware, supply-chain attacks, attacks on agents, leaked secrets and risky config. Local, zero dependencies.42MIT