# مسح الدليل الحالي والمحفوظات
keyguard scan .

# تدقيق مشاريع GCP الحية
keyguard audit

# مسح منصات CI
keyguard ci

# مسح دليل (ملفات + كامل المحفوظات)
keyguard scan .

# الملفات فقط، تخطي المحفوظات
keyguard scan . --no-git-history

# تصدير إلى JSON و SARIF
keyguard scan . --output json --output sarif --out-file report

# عرض قيم المفاتيح الفعلية (غير محجوبة)
keyguard scan . --no-redact

# استخدام ملف تكوين مخصص
keyguard scan . --config /path/to/.keyguard.toml

# تدقيق جميع مشاريع GCP القابلة للوصول
keyguard audit

# تدقيق مشروع/مشاريع محددة
keyguard audit --project my-project-id --project another-project

# استخدام ملف مفتاح حساب الخدمة
keyguard audit --gcp-credentials /path/to/key.json

# تصدير نتائج JSON
keyguard audit --output json --out-file gcp-findings.json

# مسح جميع المنصات المكونة
keyguard ci

# مسح منصة واحدة فقط
keyguard ci --platform github

# تضييق النطاق إلى مستودع معين
keyguard ci --repo my-org/api-service

# تصدير نتائج JSON
keyguard ci --output json --out-file ci-findings.json

keyguard watch .

keyguard rules list

keyguard config check
keyguard config check --config /path/to/.keyguard.toml

[scan]
paths = ["."]
exclude = ["tests/fixtures/", "**/*.example"]
scan_git_history = true

[output]
format = ["terminal", "json"]
redact = true

[notify]
slack_webhook = "https://hooks.slack.com/services/..."

[rules]
disabled = []

# مصادقة ونطاق منصة CI
[ci]
github_token    = "ghp_xxxxxxxxxxxxxxxxxxxx"
circleci_token  = "CCIPAT_xxxxxxxxxxxxxxxx"
gitlab_token    = "glpat-xxxxxxxxxxxxxxxxxxxx"
gitlab_url      = "https://gitlab.com"   # تجاوز لـ GitLab ذاتي الاستضافة
max_runs        = 10                     # عدد مرات التشغيل/الأنابيب الأخيرة لكل مستودع

[ci.github]
orgs  = ["my-org"]
repos = ["my-org/specific-repo"]         # اختياري: مسح مستودعات محددة فقط

[ci.circleci]
orgs = ["my-org"]

[ci.gitlab]
groups = ["my-group"]

[[rules.extra]]
id = "my-internal-token"
description = "رمز الخدمة الداخلي"
pattern = "tok-[0-9a-f]{32}"
entropy_min = 3.5
severity = "high"
tags = ["internal"]

name: keyguard scan

on: [push, pull_request]

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0          # المحفوظات الكاملة لفحص git
      - run: pip install keyguard-scan
      - run: keyguard scan .

# .pre-commit-config.yaml
repos:
  - repo: local
    hooks:
      - id: keyguard
        name: keyguard credential scan
        entry: keyguard scan --no-git-history
        language: system
        pass_filenames: false

docker run --rm -v $(pwd):/repo ghcr.io/arzaan789/keyguard scan /repo

keyguard scan . --output json --out-file findings.json

keyguard scan . --output sarif --out-file findings.sarif

[notify]
slack_webhook = "https://hooks.slack.com/services/..."

git clone https://github.com/arzaan789/keyguard.git
cd keyguard
pip install -e ".[dev]"
pytest

keyguard/
  scanner/      # ماسحات الملفات + المحفوظات
  engine/       # كشف التعابير المنتظمة + العشوائية (قواعد، مطابق)
  output/       # إخراج طرفي، JSON/SARIF، webhook
  auditor/      # عميل GCP API + منطق التدقيق
  ci/           # ماسحات GitHub Actions وCircleCI وGitLab CI
  cli.py        # نقطة دخول Click CLI
  config.py     # محمّل .keyguard.toml