@orbitpanel/cli 1.9.0 → 1.11.0

package/dist/lib/intelligence/agent-prompt.js

@@ -0,0 +1,179 @@
+/**
+ * CLI Agent Prompt — System prompt per il CLI Intelligence Layer.
+ *
+ * Questo prompt viene inviato al modello LLM insieme al Context Packet.
+ * È tecnico, disciplinato e operativo — non marketing.
+ *
+ * TONO: assistente di bordo di un aereo, non chatbot.
+ * Conciso, pratico, diretto. Parla italiano.
+ */
+import { getAvailableCapabilities } from './capability-map.js';
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// SYSTEM PROMPT TEMPLATE
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+const IDENTITY = `Sei il copilota operativo della CLI di OrbitPanel.
+OrbitPanel è una piattaforma di gestione hosting (WordPress, PrestaShop, cPanel).
+La CLI (@orbitpanel/cli) è uno strumento locale per tracciare sessioni di lavoro, annotare decisioni, e inviare report a Orbit.
+
+NON sei l'agente web di Orbit. NON sei il backend. Sei il copilota locale.`;
+const KNOWLEDGE_BOUNDARIES = `CONFINI DI CONOSCENZA:
+- STATO LOCALE: lo conosci dal Context Packet allegato. È la verità.
+- CONOSCENZA ORBIT: sai cos'è Orbit, come funziona la CLI, quali comandi ci sono.
+- STATO BACKEND: NON lo conosci. Non inventare dati su interventi, siti, o memoria remota.
+- Se il Context Packet non contiene un dato, rispondi "non ho questa informazione nel contesto locale".`;
+const PRIMARY_TASKS = `COMPITI PRINCIPALI:
+1. SPIEGARE: cos'è Orbit, come funziona la CLI, cosa significano gli stati
+2. ORIENTARE: guidare l'utente nel workflow (auth → link → session → work → report)
+3. DIAGNOSTICARE: leggere lo stato e identificare problemi
+4. TRASFORMARE: problemi in task, osservazioni in note, scelte in decisioni
+5. SUGGERIRE: il comando giusto al momento giusto
+6. AGIRE: solo azioni consentite dalla capability map`;
+const BEHAVIORAL_RULES = `REGOLE DI COMPORTAMENTO:
+- MAI inventare stato che non è nel Context Packet
+- MAI bypassare conferme su azioni sensibili (report, diagnostiche remote)
+- MAI trattare la sessione locale come memoria backend
+- MAI suggerire azioni remote ad alto rischio come default
+- MAI dire "dovresti aggiornare la memoria" — la CLI non scrive nella memoria backend
+- Quando suggerisci un comando, scrivi il comando esatto (es: /task add "Fixare CSS header")
+- Quando proponi più opzioni, numerale
+- Sii conciso: max 3-4 frasi per risposta, a meno che non sia una spiegazione richiesta
+- Parla italiano
+- Non usare emoji`;
+const STRUCTURED_ACTIONS = `AZIONI STRUTTURATE:
+Quando ritieni utile proporre un'azione locale (nota, task, decisione, completamento task),
+aggiungi un blocco alla fine della tua risposta con questo formato esatto:
+
+<orbit-action>
+{"action":"create_task","params":{"text":"Descrizione del task"}}
+</orbit-action>
+
+Azioni disponibili:
+- create_note: {"action":"create_note","params":{"text":"testo della nota"}}
+- create_task: {"action":"create_task","params":{"text":"testo del task"}}
+- create_decision: {"action":"create_decision","params":{"text":"testo della decisione"}}
+- complete_task: {"action":"complete_task","params":{"taskId":"id del task"}}
+- suggest_command: {"action":"suggest_command","params":{"command":"/comando"}}
+- none: {"action":"none","params":{}}
+
+REGOLE sulle azioni:
+- Includi il blocco SOLO se l'azione e chiaramente utile e richiesta dall'utente
+- NON includere il blocco per semplici spiegazioni o risposte informative
+- L'utente vedra una richiesta di conferma prima dell'esecuzione
+- Scrivi PRIMA il testo di risposta, POI il blocco azione alla fine
+- Se non serve un'azione, NON includere il blocco`;
+const TONE = `TONO:
+Sei un assistente di bordo. Diretto, pratico, informato.
+Non sei un chatbot allegro. Non sei un consulente che spiega troppo.
+Rispondi come un collega esperto che ha il cruscotto davanti.
+Frasi brevi. Informazione utile. Azione chiara.`;
+/**
+ * Costruisce il system prompt per il CLI Intelligence Layer.
+ * Pure function — nessun side effect.
+ */
+export function buildAgentSystemPrompt(input) {
+    const { contextPacket, phase } = input;
+    const capabilities = getAvailableCapabilities(contextPacket.capabilities.capabilityLevel, phase);
+    const capabilitySection = formatCapabilitySection(capabilities);
+    const contextSection = formatContextSection(contextPacket);
+    return [
+        IDENTITY,
+        '',
+        KNOWLEDGE_BOUNDARIES,
+        '',
+        PRIMARY_TASKS,
+        '',
+        capabilitySection,
+        '',
+        BEHAVIORAL_RULES,
+        '',
+        phase >= 2 ? STRUCTURED_ACTIONS : '',
+        phase >= 2 ? '' : '',
+        TONE,
+        '',
+        '━━━ CONTESTO CORRENTE ━━━',
+        contextSection,
+    ].join('\n');
+}
+/** Formatta la sezione capabilities per il prompt */
+function formatCapabilitySection(capabilities) {
+    const byTier = {};
+    for (const cap of capabilities) {
+        if (!byTier[cap.tier])
+            byTier[cap.tier] = [];
+        const confirm = cap.requiresConfirmation ? ' [richiede conferma]' : '';
+        const scope = cap.scope === 'local_only' ? '' : ` [${cap.scope}]`;
+        byTier[cap.tier].push(`- ${cap.description}${scope}${confirm}`);
+    }
+    const sections = ['CAPABILITY ATTIVE:'];
+    const tierLabels = {
+        explain: 'EXPLAIN (spiegare)',
+        inspect: 'INSPECT (leggere)',
+        suggest: 'SUGGEST (suggerire)',
+        act: 'ACT (agire)',
+    };
+    for (const [tier, label] of Object.entries(tierLabels)) {
+        if (byTier[tier]?.length) {
+            sections.push(`\n${label}:`);
+            sections.push(...byTier[tier]);
+        }
+    }
+    sections.push('\nNON PUOI:');
+    sections.push('- Scrivere nella memoria backend di Orbit');
+    sections.push('- Eseguire tool MCP multi-step autonomamente');
+    sections.push('- Inviare report senza conferma utente');
+    sections.push('- Modificare file di progetto silenziosamente');
+    return sections.join('\n');
+}
+/** Formatta il Context Packet come sezione leggibile nel prompt */
+function formatContextSection(packet) {
+    const lines = [];
+    // Project
+    const p = packet.project;
+    lines.push(`Progetto: ${p.name ?? '(non configurato)'} | ${p.platform ?? '?'} | ${p.environment ?? '?'}`);
+    lines.push(`Setup: ${p.setupLevel} | Salute: ${p.healthLevel}`);
+    if (p.healthIssues.length > 0) {
+        lines.push(`Problemi: ${p.healthIssues.join('; ')}`);
+    }
+    lines.push(`Prossimo passo: ${p.nextStep.cmd} — ${p.nextStep.reason}`);
+    // Session
+    const s = packet.session;
+    if (s.active) {
+        lines.push('');
+        lines.push(`Sessione: attiva (${s.durationMinutes ?? '?'}min) | ID: ${s.id}`);
+        lines.push(`Note: ${s.counts.notesTotal} (${s.counts.notesUser} utente, ${s.counts.notesAgent} agente)`);
+        lines.push(`Task: ${s.counts.tasksOpen} aperti, ${s.counts.tasksDone} completati`);
+        lines.push(`Decisioni: ${s.counts.decisions} | Warning: ${s.counts.warnings}`);
+        if (s.isLong) {
+            lines.push('⚠ Sessione lunga (>2h)');
+        }
+        if (s.recentEntries.length > 0) {
+            lines.push('Ultime entry:');
+            for (const e of s.recentEntries) {
+                lines.push(`  [${e.kind}/${e.source}] ${e.text} (${e.minutesAgo}min fa)`);
+            }
+        }
+    }
+    else {
+        lines.push('');
+        lines.push('Sessione: nessuna attiva');
+    }
+    // Capabilities
+    const c = packet.capabilities;
+    lines.push('');
+    lines.push(`Auth: ${c.authenticated ? 'ok' : 'no'} | Backend: ${c.backendReachable === null ? 'non verificato' : c.backendReachable ? 'ok' : 'non raggiungibile'} | Livello: ${c.capabilityLevel}`);
+    // Tech
+    const t = packet.tech;
+    lines.push(`Dir: ${t.cwd} | Branch: ${t.gitBranch ?? 'n/a'} | Dirty: ${t.gitDirty === null ? 'n/v' : t.gitDirty ? 'si' : 'no'}`);
+    if (t.lastError) {
+        lines.push(`Ultimo errore: ${t.lastError}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Stima approssimativa dei token del system prompt (per budgeting).
+ * Conta ~4 char per token (approssimazione standard).
+ */
+export function estimatePromptTokens(prompt) {
+    return Math.ceil(prompt.length / 4);
+}
+//# sourceMappingURL=agent-prompt.js.map

package/dist/lib/intelligence/agent-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-prompt.js","sourceRoot":"","sources":["../../../src/lib/intelligence/agent-prompt.ts"],"names":[],"mappings":"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"}

package/dist/lib/intelligence/capability-map.d.ts

@@ -0,0 +1,53 @@
+/**
+ * CLI Capability Map — Definisce cosa il CLI Intelligence Layer può fare.
+ *
+ * Ogni capability ha:
+ * - livello (explain, inspect, suggest, act)
+ * - se è attivabile nella fase corrente
+ * - se richiede conferma utente
+ * - se è locale-only o usa backend
+ * - se è sicura, sensibile o da posticipare
+ *
+ * PRINCIPI:
+ * - Conservativo: phase 1 = solo lettura e suggerimenti
+ * - Esplicito: ogni capability ha un risk assessment
+ * - Grounded: mappa direttamente a comandi esistenti nella CLI
+ */
+import type { CapabilityLevel } from './context-packet.js';
+/** I 4 livelli operativi del CLI Intelligence Layer */
+export type CapabilityTier = 'explain' | 'inspect' | 'suggest' | 'act';
+/** Dove viene eseguita l'operazione */
+export type ExecutionScope = 'local_only' | 'backend_read' | 'backend_write';
+/** Rischio dell'operazione */
+export type RiskLevel = 'safe' | 'sensitive' | 'deferred';
+/** Fase di implementazione in cui la capability diventa disponibile */
+export type ImplementationPhase = 1 | 2 | 3;
+/** Singola capability del CLI Intelligence Layer */
+export interface Capability {
+    /** Identificatore unico */
+    id: string;
+    /** Livello operativo */
+    tier: CapabilityTier;
+    /** Descrizione concisa (per il modello) */
+    description: string;
+    /** Dove viene eseguita */
+    scope: ExecutionScope;
+    /** Rischio */
+    risk: RiskLevel;
+    /** Richiede conferma utente? */
+    requiresConfirmation: boolean;
+    /** Fase di implementazione */
+    phase: ImplementationPhase;
+    /** Capability level minimo richiesto */
+    minCapabilityLevel: CapabilityLevel;
+    /** Comando CLI corrispondente (se esiste) */
+    mappedCommand: string | null;
+}
+export declare const CAPABILITY_REGISTRY: readonly Capability[];
+/** Ritorna capabilities disponibili per un dato livello e fase */
+export declare function getAvailableCapabilities(capabilityLevel: CapabilityLevel, phase: ImplementationPhase): Capability[];
+/** Ritorna capabilities raggruppate per tier */
+export declare function getCapabilitiesByTier(capabilityLevel: CapabilityLevel, phase: ImplementationPhase): Record<CapabilityTier, Capability[]>;
+/** Verifica se una capability specifica è abilitata */
+export declare function isCapabilityEnabled(id: string, capabilityLevel: CapabilityLevel, phase: ImplementationPhase): boolean;
+export declare const PHASE_1_EXCLUSIONS: readonly ["high_risk_remote_write", "automatic_memory_sync", "automatic_report_without_confirmation", "autonomous_multi_step_tool_loop", "silent_project_modifications", "backend_memory_write", "session_bidirectional_sync"];

package/dist/lib/intelligence/capability-map.js

@@ -0,0 +1,266 @@
+/**
+ * CLI Capability Map — Definisce cosa il CLI Intelligence Layer può fare.
+ *
+ * Ogni capability ha:
+ * - livello (explain, inspect, suggest, act)
+ * - se è attivabile nella fase corrente
+ * - se richiede conferma utente
+ * - se è locale-only o usa backend
+ * - se è sicura, sensibile o da posticipare
+ *
+ * PRINCIPI:
+ * - Conservativo: phase 1 = solo lettura e suggerimenti
+ * - Esplicito: ogni capability ha un risk assessment
+ * - Grounded: mappa direttamente a comandi esistenti nella CLI
+ */
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// CAPABILITY REGISTRY
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+export const CAPABILITY_REGISTRY = [
+    // ─── TIER: EXPLAIN ────────────────────────────────────────────
+    {
+        id: 'explain_orbit',
+        tier: 'explain',
+        description: 'Spiega cos\'è Orbit, come funziona, quali componenti ha',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: null,
+    },
+    {
+        id: 'explain_cli',
+        tier: 'explain',
+        description: 'Spiega i comandi della CLI, il workflow, come usarla',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: '/help',
+    },
+    {
+        id: 'explain_state',
+        tier: 'explain',
+        description: 'Spiega lo stato locale corrente (sessione, progetto, contesto)',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: '/info',
+    },
+    {
+        id: 'explain_error',
+        tier: 'explain',
+        description: 'Spiega un errore recente e suggerisci come risolverlo',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: null,
+    },
+    // ─── TIER: INSPECT ────────────────────────────────────────────
+    {
+        id: 'inspect_session',
+        tier: 'inspect',
+        description: 'Leggi il summary della sessione attiva, task, decisioni',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: '/session info',
+    },
+    {
+        id: 'inspect_context',
+        tier: 'inspect',
+        description: 'Leggi il contesto progetto, health, attributed sources',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: '/context',
+    },
+    {
+        id: 'inspect_interventions',
+        tier: 'inspect',
+        description: 'Lista interventi recenti dal backend Orbit',
+        scope: 'backend_read',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'readonly',
+        mappedCommand: '/list',
+    },
+    {
+        id: 'inspect_doctor',
+        tier: 'inspect',
+        description: 'Esegui diagnostica locale (token, API, git, sito)',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: '/doctor',
+    },
+    // ─── TIER: SUGGEST ────────────────────────────────────────────
+    {
+        id: 'suggest_next_step',
+        tier: 'suggest',
+        description: 'Suggerisci il prossimo comando basato sullo stato',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: null,
+    },
+    {
+        id: 'suggest_task_creation',
+        tier: 'suggest',
+        description: 'Suggerisci task da creare basato sulla conversazione',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: null,
+    },
+    {
+        id: 'suggest_report',
+        tier: 'suggest',
+        description: 'Suggerisci se è il momento di inviare un /report',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: null,
+    },
+    {
+        id: 'suggest_recovery',
+        tier: 'suggest',
+        description: 'Suggerisci passi di recovery per errori o problemi',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 1,
+        minCapabilityLevel: 'offline',
+        mappedCommand: null,
+    },
+    // ─── TIER: ACT ────────────────────────────────────────────────
+    {
+        id: 'act_create_note',
+        tier: 'act',
+        description: 'Crea una nota nella sessione locale',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 2,
+        minCapabilityLevel: 'local_write',
+        mappedCommand: '/note',
+    },
+    {
+        id: 'act_create_task',
+        tier: 'act',
+        description: 'Crea un task nella sessione locale',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 2,
+        minCapabilityLevel: 'local_write',
+        mappedCommand: '/task add',
+    },
+    {
+        id: 'act_create_decision',
+        tier: 'act',
+        description: 'Registra una decisione nella sessione locale',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 2,
+        minCapabilityLevel: 'local_write',
+        mappedCommand: '/decision',
+    },
+    {
+        id: 'act_complete_task',
+        tier: 'act',
+        description: 'Marca un task come completato',
+        scope: 'local_only',
+        risk: 'safe',
+        requiresConfirmation: false,
+        phase: 2,
+        minCapabilityLevel: 'local_write',
+        mappedCommand: '/task done',
+    },
+    {
+        id: 'act_run_diagnose',
+        tier: 'act',
+        description: 'Esegui diagnostica aggregata /diagnose',
+        scope: 'backend_read',
+        risk: 'sensitive',
+        requiresConfirmation: true,
+        phase: 3,
+        minCapabilityLevel: 'readonly',
+        mappedCommand: '/diagnose',
+    },
+    {
+        id: 'act_send_report',
+        tier: 'act',
+        description: 'Invia report a Orbit (crea intervento)',
+        scope: 'backend_write',
+        risk: 'sensitive',
+        requiresConfirmation: true,
+        phase: 3,
+        minCapabilityLevel: 'full',
+        mappedCommand: '/report',
+    },
+];
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// QUERY FUNCTIONS
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/** Ritorna capabilities disponibili per un dato livello e fase */
+export function getAvailableCapabilities(capabilityLevel, phase) {
+    const levelOrder = {
+        offline: 0,
+        readonly: 1,
+        local_write: 2,
+        full: 3,
+    };
+    const currentLevel = levelOrder[capabilityLevel];
+    return CAPABILITY_REGISTRY.filter(cap => {
+        const requiredLevel = levelOrder[cap.minCapabilityLevel];
+        return cap.phase <= phase && requiredLevel <= currentLevel;
+    });
+}
+/** Ritorna capabilities raggruppate per tier */
+export function getCapabilitiesByTier(capabilityLevel, phase) {
+    const available = getAvailableCapabilities(capabilityLevel, phase);
+    return {
+        explain: available.filter(c => c.tier === 'explain'),
+        inspect: available.filter(c => c.tier === 'inspect'),
+        suggest: available.filter(c => c.tier === 'suggest'),
+        act: available.filter(c => c.tier === 'act'),
+    };
+}
+/** Verifica se una capability specifica è abilitata */
+export function isCapabilityEnabled(id, capabilityLevel, phase) {
+    return getAvailableCapabilities(capabilityLevel, phase).some(c => c.id === id);
+}
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// EXCLUSION LIST — cosa NON fare nella prima fase
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+export const PHASE_1_EXCLUSIONS = [
+    'high_risk_remote_write',
+    'automatic_memory_sync',
+    'automatic_report_without_confirmation',
+    'autonomous_multi_step_tool_loop',
+    'silent_project_modifications',
+    'backend_memory_write',
+    'session_bidirectional_sync',
+];
+//# sourceMappingURL=capability-map.js.map

package/dist/lib/intelligence/capability-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-map.js","sourceRoot":"","sources":["../../../src/lib/intelligence/capability-map.ts"],"names":[],"mappings":"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"}

package/dist/lib/intelligence/chat-enrichment.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Chat enrichment — Arricchisce il messaggio utente con contesto CLI.
+ *
+ * Questo modulo è il punto di integrazione tra il CLI Intelligence Layer
+ * e il flusso AI chat esistente. Arricchisce il messaggio inviato al backend
+ * con informazioni sul contesto locale che il backend non conosce.
+ *
+ * NON modifica il system prompt del backend (non ne ha controllo).
+ * NON aggiunge dipendenze nuove.
+ * NON fa I/O — usa solo dati già disponibili in OrbitStore.
+ *
+ * Approccio: prefissa il messaggio utente con un blocco di contesto leggero
+ * racchiuso in tag XML-like che il backend LLM può leggere ma che non
+ * interferiscono con il messaggio dell'utente.
+ */
+import { type ContextPacketInput } from './context-packet.js';
+import type { OrbitState } from '../../state/types.js';
+/**
+ * Costruisce un ContextPacketInput dai dati già presenti in OrbitState.
+ * Pure function — nessun I/O, nessun side effect.
+ */
+export declare function buildContextInputFromState(state: OrbitState, cwd: string): ContextPacketInput;
+/**
+ * Formatta un contesto compatto (~150-200 token) da anteporre al messaggio utente.
+ * Il formato è un blocco racchiuso in tag che il LLM può leggere.
+ */
+export declare function formatContextPrefix(state: OrbitState, cwd: string): string;
+/**
+ * Arricchisce il messaggio utente con il contesto CLI.
+ * Se il contesto non è disponibile, ritorna il messaggio originale (fallback).
+ */
+export declare function enrichMessageWithContext(userMessage: string, state: OrbitState, cwd: string): string;