convez.ai
SkillSegurançaAvançado
Appusurya

Package Sentinel

Appusurya/pkg-lock-enforcer

Bloqueio de pacotes vulneráveis e enforcement de versões seguras em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta que intercepta comandos de instalação de pacotes (npm, pip, gem) em tempo real, bloqueando versões vulneráveis e forçando a instalação das versões mais atualizadas. Funciona como uma barreira preventiva integrada ao shell, validando assinaturas criptográficas e consultando bases de CVE antes do pacote chegar ao sistema.

Instalação

$npx convez-ai Appusurya/pkg-lock-enforcer

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Prevenir instalação de dependências com CVEs conhecidas
  • Forçar uso de versões atualizadas em pipelines de CI/CD
  • Proteger supply chain contra pacotes maliciosos ou comprometidos

Veredito

Package Sentinel é uma solução sólida para hardening de segurança em supply chain, com arquitetura bem pensada e integração com sistemas de verificação descentralizados. Melhor adequado para equipes DevOps/SRE que precisam impor políticas rígidas de dependências.

README

A tradução para o português deste README ainda está na fila.

Package Sentinel: Proactive Dependency Vulnerability Prevention for Modern Development Pipelines

Download

🚀 The Future of Secure Package Management

In an era where supply chain attacks target the very foundations of your software stack, Package Sentinel emerges as your digital fortress — a proactive guardian that intercepts package installation commands at the system level, enforcing cryptographic integrity checks, blocking known vulnerable versions, and ensuring your dependency tree remains impervious to exploitation. Unlike traditional static analysis tools that scan post-installation, Package Sentinel operates in real-time, acting as a preemptive barrier between your terminal and malicious registry entries.


🛡️ Why Package Sentinel Changes the Game

Traditional dependency security solutions operate retroactively — they scan what's already installed. Package Sentinel flips this paradigm by intercepting npm install, pip install, gem install, and similar commands before they reach the registry. Think of it as a virtual airlock for your package manager: every dependency must pass through security validation, version freshness checks, and behavioral analysis before it ever touches your node_modules or vendor directory.


🎯 Core Philosophy: Prevention Over Detection

Most security tools scream after the damage is done. Package Sentinel whispers before the mistake is made. By integrating directly into your shell environment and package manager workflows, it creates an invisible safety net that:

  • Validates package signatures against decentralized trust registries
  • Cross-references version freshness against NVD and OSV databases
  • Blocks packages with known CVEs older than 48 hours
  • Prevents installation of packages with suspicious metadata patterns

📊 Architecture Overview

graph TB
    A[Developer Terminal] --> B[Package Sentinel CLI]
    B --> C{Command Interceptor}
    C -->|npm/pip/gem| D[Registry Proxy Layer]
    C -->|Other| E[Pass Through]
    D --> F[Signature Verification]
    F --> G{Trust Score > 0.85?}
    G -->|Yes| H[Version Freshness Check]
    G -->|No| I[Block + Alert]
    H --> J{Latest Version?}
    J -->|Yes| K[Allow Installation]
    J -->|No| L[Offer Upgrade + Block]
    I --> M[Security Log]
    L --> M
    K --> N[Installation Successful]
    M --> O[Sentinel Dashboard]

💻 Example Profile Configuration

Create ~/.packagesentinel/config.yaml to customize your security posture:

security_policy:
  enforcement_mode: strict
  allowed_registries:
    - npm: https://registry.npmjs.org
    - pypi: https://pypi.org/simple
  block_freshness_threshold_hours: 48
  trusted_signature_authorities:
    - sigstore.dev
    - keybase.io

notification:
  slack_webhook: https://hooks.slack.com/services/your-webhook
  email_alert: devops@team.com
  webhook_payload_template: |
    {
      "package": "$PACKAGE_NAME",
      "version": "$VERSION",
      "risk_score": $RISK_SCORE,
      "reason": "$BLOCK_REASON"
    }

exclusions:
  packages:
    - name: "internal-lib-alpha"
      reason: "Trusted internal package"
  scopes:
    - "@mycompany/*"

logging:
  level: verbose
  retention_days: 90
  output_format: json

🖥️ Example Console Invocation

# Standard installation with Sentinel protection
npm install axios

# Output:
# [Package Sentinel] Analyzing request: axios
# [Package Sentinel] Checking registry: https://registry.npmjs.org
# [Package Sentinel] Signature valid: YES (verified via sigstore)
# [Package Sentinel] Version freshness: STALE (1.6.7 vs latest 1.7.2)
# [Package Sentinel] Blocked - stale version detected (age: 6 days)
# [Package Sentinel] Suggestion: npm install axios@latest

# Bypass Sentinel for specific packages
sentinel-allow --reason "internal audit" npm install axios@1.6.7

# Check Sentinel status
sentinel status --json

💻 OS Compatibility

Operating SystemCompatibilityNotes
🐧 Ubuntu 22.04+✅ FullNative eBPF support for kernel-level interception
🐧 Debian 12+✅ FullRequires kernel 5.15+
🐧 Fedora 38+✅ FullAutomatic selinux integration
🍎 macOS Ventura+✅ FullInterception via kernel extension
🍎 macOS Sonoma✅ FullSIP-compatible mode
🪟 Windows 11✅ BetaWSL2 integration required
🪟 Windows Server 2022✅ BetaPowerShell module available
🐧 Alpine Linux✅ FullMinimal image for Docker
🐧 CentOS Stream 9⚠️ PartialRequires manual kernel module loading

⚡ Feature List

  • Real-Time Command Interception — hooks into shell startup scripts and package manager entry points
  • Cryptographic Signature Verification — validates package signatures against decentralized trust networks
  • Automated Version Freshness Enforcement — blocks packages older than configurable thresholds
  • Multi-Cloud Dashboard Integration — push security events to AWS CloudWatch, Azure Monitor, GCP Logging
  • Zero-Friction Rollback — one-command uninstall reverts all Sentinel changes to shell environment
  • Comprehensive Audit Trail — JSON-formatted logs with full stack traces for compliance
  • Intelligent Whitelisting — smart pattern matching for trusted internal packages
  • Multi-Language Support — intercepts npm, pip, gem, cargo, nuget, and apk commands
  • Custom Rule Engine — write complex policies using Lua scripts for edge cases
  • Team Collaboration — share exclusion lists and security policies across repositories

🤖 AI-Powered Threat Intelligence Integration

OpenAI API Integration

Package Sentinel leverages OpenAI's GPT-4o to analyze package manifest files for contextual risks that static analysis misses:

ai_integration:
  provider: openai
  model: gpt-4o
  api_key_env_var: OPENAI_API_KEY
  analysis_types:
    - manifest_contextual_risk
    - dependency_graph_anomaly
    - version_migration_advice

The AI layer examines package descriptions, recent commit messages, and maintainer activity patterns to surface risks that no CVE database can predict. For example, a legitimate package that suddenly changes its domain registration pattern triggers a behavioral risk score adjustment.

Claude API Integration

Anthropic's Claude 3.5 Sonnet provides adversarial reasoning capabilities:

ai_integration:
  provider: anthropic
  model: claude-3-sonnet-20241022
  api_key_env_var: ANTHROPIC_API_KEY
  analysis_types:
    - adversarial_package_behavior
    - typosquatting_detection
    - malicious_code_patterns

Claude's constitutional AI framework makes it uniquely suited for identifying sophisticated supply chain attacks where packages mimic legitimate ones but contain obfuscated payloads. The model analyzes minified code patterns and encoded strings that traditional signature-based tools miss.


🌐 Responsive UI Dashboard

The Package Sentinel dashboard adapts to every screen size — from 4K monitors to mobile phones, allowing DevOps engineers to review security alerts during commute or from a tablet in server rooms:

  • Desktop (1920+) — full security event timeline with graph visualization
  • Tablet (768-1024) — collapsed sidebar with priority alerts visible
  • Mobile (< 768) — card-based layout with push notifications

🌍 Multilingual Support

Package Sentinel speaks your team's language:

LanguageInterfaceDocumentation
English (US)✅✅
简体中文 (Chinese)✅✅
日本語 (Japanese)✅✅
한국어 (Korean)✅✅
Español (Spanish)✅✅
Français (French)✅✅
Deutsch (German)✅✅
Português (Brazilian)✅✅
العربية (Arabic)⚠️ PartialRTL support in beta

📞 24/7 Enterprise Support

Package Sentinel Enterprise includes round-the-clock support with guaranteed response times:

  • Critical severity — 15-minute response, 1-hour resolution
  • High severity — 30-minute response, 4-hour resolution
  • Medium severity — 2-hour response, 24-hour resolution
  • Low severity — 8-hour response, 48-hour resolution

Support channels include dedicated Slack workspace, email ticketing, and scheduled screen-sharing sessions for complex policy configuration.


📋 Disclaimer

Package Sentinel is a security tool intended to reduce risk — it cannot eliminate it entirely. No software can guarantee 100% protection against all zero-day vulnerabilities or supply chain attacks. Users should:

  1. Maintain regular backups of their dependency lock files
  2. Periodically review exclusion lists for potential abuse
  3. Understand that blocking legitimate packages may cause build failures
  4. Test Sentinel policies in staging environments before production deployment

The developers of Package Sentinel assume no liability for data loss, service disruption, or security breaches that may occur despite the tool's preventive measures. Use at your own risk. Always consult with your organization's security team before implementing new security tooling.


🎯 SEO-Optimized Keywords

  • dependency security tool
  • package vulnerability prevention
  • real-time dependency scanner
  • supply chain attack prevention
  • npm security tool
  • pip security tool
  • package manager security
  • version freshness enforcement
  • cryptographic package verification
  • open source dependency security 2026
  • AI-powered package analysis
  • prevent dependency confusion attacks
  • secure npm install
  • lockfile integrity checker
  • CI/CD security integration

📄 License

This project is licensed under the MIT License — see the full license text here for details.

Copyright (c) 2026 Package Sentinel Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Download

Package Sentinel — because your dependency tree deserves a bodyguard in 2026

Ver o original no GitHub

Bom para

Relacionados