⚙️ DKP DEVELOPER DOCUMENTATION v2.5

DKP CLI & Local Automation

La guida definitiva per sviluppatori e DevOps. Impara a sincronizzare il tuo ecosistema locale, configurare pipeline di Continuous Integration e gestire la sicurezza direttamente dalla riga di comando.

🛠️ 1. Prerequisiti & Installazione Globale

Il DKP CLI Toolkit v2.5-BETA è stato progettato per Node.js (richiesta versione 18.17.0+ o 20.x+). Ti permette di avere il controllo totale sull'ecosistema Pulse Nexus senza dover mai aprire il browser.

Installa il pacchetto in modo globale tramite NPM o Yarn per rendere il comando dkp disponibile ovunque nel tuo sistema:

# Usa NPM npm install -g @devkernelpulse/cli@beta # Oppure con Yarn yarn global add @devkernelpulse/cli@beta

✅ Verifica: Digita dkp --version per confermare che l'installazione sia andata a buon fine.

🌐 2. Autenticazione & Environment Sync

Prima di interagire con il tuo cluster o lanciare scansioni AI, la CLI deve essere autenticata e sincronizzata con l'ambiente DKP attivo.

Login Interattivo

dkp auth login

Questo comando aprirà automaticamente il browser puntando al tuo Main Portal (https://devkernelpulse.org/) per la procedura di OAuth2 e scaricherà in locale il token sicuro.

Endpoint di Riferimento del tuo Workspace

Il toolkit dialogherà con le seguenti infrastrutture cloud in tempo reale:

API Gateway (Gestione Modelli & Sync): https://api.devkernelpulse.org/
Sistema Notifiche Mail Server: https://mail.devkernelpulse.org/

⚡ 3. Gestione Ecosistema e Comandi Core

Di seguito i comandi più utilizzati per automatizzare i tuoi processi di sviluppo quotidiani.

dkp scan [repo-url]AI Powered

Invia un repository remoto o una directory locale all'AI Repository Scanner. La CLI restituirà in stdout il tuo score S-Tier, un'analisi dello stack e eventuali raccomandazioni di refactoring.

dkp scan ./mio-progetto --format=json

dkp keys:create [nome]Security

Genera dinamicamente una nuova API Key Nitro Enterprise per i tuoi script o pipeline CI.

dkp keys:create "GitHub Actions Prod" --ttl=30d

dkp vault:push [file]Data

Invia un file Markdown o uno snippet di codice al Code Vault per la notarizzazione crittografica. Ottimo per versionare gli articoli del blog.

dkp vault:push architecture-docs.md

🔒 4. Continuous Integration & Monitoraggio

Automazione dei Test E2E

Integra DKP CLI all'interno dei tuoi file YAML di GitHub Actions o GitLab CI per bloccare i deployment se i test E2E Playwright falliscono.

dkp ci run-tests --framework=playwright --fail-fast

Monitoraggio Firewall SSE

Per i Sysadmin: puoi agganciare il tuo terminale al flusso eventi in diretta del DKP Cyber Firewall, leggendo lo streaming Server-Sent Events senza ritardi.

dkp firewall:monitor --level=critical,warning

⚠️ Usa Ctrl+C per sganciare la CLI dallo stream live.

Need Help?

Se incontri problemi con la CLI o ricevi errori 401, verifica che il demone locale sia in esecuzione (dkp daemon status) e che il token JWT non sia scaduto.

Per la reference completa di tutti i flag disponibili, esegui sempre: dkp --help.