@orbitpanel/cli 1.8.0 → 1.10.0

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;

package/dist/lib/intelligence/chat-enrichment.js

@@ -0,0 +1,130 @@
+/**
+ * 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 { buildContextPacket } from './context-packet.js';
+import { computeSessionStats } from '../session-summary-format.js';
+import { getSetupLevel, getNextStep } from '../info-engine.js';
+/**
+ * Costruisce un ContextPacketInput dai dati già presenti in OrbitState.
+ * Pure function — nessun I/O, nessun side effect.
+ */
+export function buildContextInputFromState(state, cwd) {
+    // Derive InfoState (same logic as /info command in command-router.ts)
+    let tasksOpen = 0;
+    let tasksDone = 0;
+    let notesTotal = 0;
+    let notesAgent = 0;
+    let decisions = 0;
+    let sessionLong = false;
+    if (state.session) {
+        const stats = computeSessionStats(state.session);
+        tasksOpen = stats.tasksOpen;
+        tasksDone = stats.tasksDone;
+        notesTotal = stats.notesTotal;
+        notesAgent = stats.notesAgent;
+        decisions = stats.decisions;
+        const startMs = new Date(state.session.started_at).getTime();
+        sessionLong = (Date.now() - startMs) > 2 * 60 * 60 * 1000;
+    }
+    const infoState = {
+        hasToken: !!state.tokenEntry,
+        hasSite: !!state.siteLink,
+        hasSession: !!state.session,
+        hasManifest: !!state.manifest,
+        projectName: state.manifest?.name ?? state.siteLink?.name ?? null,
+        environment: state.manifest?.environment ?? state.siteLink?.environment ?? null,
+        healthLevel: state.contextHealth.level,
+        tasksOpen,
+        sessionLong,
+        tasksDone,
+        notesTotal,
+        notesAgent,
+        decisions,
+    };
+    return {
+        hasToken: !!state.tokenEntry,
+        hasSite: !!state.siteLink,
+        hasManifest: !!state.manifest,
+        projectName: infoState.projectName,
+        platform: state.manifest?.platform ?? state.siteLink?.platform ?? null,
+        environment: infoState.environment,
+        healthLevel: state.contextHealth.level,
+        healthIssues: state.contextHealth.issues.map(i => i.message),
+        setupLevel: getSetupLevel(infoState),
+        nextStep: getNextStep(infoState),
+        session: state.session ? {
+            id: state.session.id,
+            started_at: state.session.started_at,
+            notes: state.session.notes,
+        } : null,
+        gitBranch: state.gitBranch,
+        gitDirty: null, // Not available without I/O
+        cwd,
+        lastError: state.lastError,
+        backendReachable: null, // Not verified yet
+        mcpServerActive: false,
+    };
+}
+/**
+ * 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 function formatContextPrefix(state, cwd) {
+    const input = buildContextInputFromState(state, cwd);
+    const packet = buildContextPacket(input);
+    const lines = [];
+    lines.push('<cli-context>');
+    // Project
+    const p = packet.project;
+    if (p.name) {
+        lines.push(`Progetto: ${p.name} (${p.platform ?? '?'}, ${p.environment ?? '?'})`);
+    }
+    lines.push(`Setup: ${p.setupLevel} | Contesto: ${p.healthLevel}`);
+    // Session
+    const s = packet.session;
+    if (s.active) {
+        lines.push(`Sessione attiva: ${s.durationMinutes ?? '?'}min, ${s.counts.notesTotal} note, ${s.counts.tasksOpen} task aperti, ${s.counts.decisions} decisioni`);
+        if (s.recentEntries.length > 0) {
+            const latest = s.recentEntries[s.recentEntries.length - 1];
+            lines.push(`Ultima entry: [${latest.kind}] ${latest.text}`);
+        }
+    }
+    else {
+        lines.push('Nessuna sessione attiva');
+    }
+    // Tech
+    if (packet.tech.gitBranch) {
+        lines.push(`Branch: ${packet.tech.gitBranch}`);
+    }
+    // Next step
+    lines.push(`Suggerimento: ${p.nextStep.cmd} — ${p.nextStep.reason}`);
+    lines.push('</cli-context>');
+    return lines.join('\n');
+}
+/**
+ * Arricchisce il messaggio utente con il contesto CLI.
+ * Se il contesto non è disponibile, ritorna il messaggio originale (fallback).
+ */
+export function enrichMessageWithContext(userMessage, state, cwd) {
+    try {
+        const prefix = formatContextPrefix(state, cwd);
+        return `${prefix}\n\n${userMessage}`;
+    }
+    catch {
+        // Fallback: ritorna il messaggio originale senza contesto
+        return userMessage;
+    }
+}
+//# sourceMappingURL=chat-enrichment.js.map

package/dist/lib/intelligence/chat-enrichment.js.map

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

package/dist/lib/intelligence/context-packet.d.ts

@@ -0,0 +1,157 @@
+/**
+ * CLI Context Packet — Snapshot del contesto locale per il CLI Intelligence Layer.
+ *
+ * Questo è il payload che viene passato al modello LLM ogni volta che
+ * il CLI Intelligence Layer deve ragionare sullo stato corrente.
+ *
+ * PRINCIPI:
+ * - Proiezione da OrbitState + SessionSummary + InfoState (nessuna fonte nuova)
+ * - Minimale ma sufficiente (~1.5-2K token serializzato)
+ * - Stabile: i campi cambiano poco tra invocazioni successive
+ * - Nessun dato sensibile (token, credenziali, path assoluti)
+ *
+ * NON contiene:
+ * - Token o credenziali
+ * - Testi completi di note/decisioni (solo conteggi e ultime 3)
+ * - Stato backend (memory, RAG, audit) — quello è responsabilità del backend
+ */
+import type { ContextHealthLevel, NoteKind, NoteSource } from '../../types.js';
+import type { SetupLevel } from '../info-engine.js';
+/** Stato del progetto locale */
+export interface ProjectContext {
+    /** Nome del progetto (da manifest o legacy site link) */
+    name: string | null;
+    /** Piattaforma: wordpress, prestashop, custom */
+    platform: string | null;
+    /** Ambiente: local, dev, staging, production */
+    environment: string | null;
+    /** Se il manifest .orbit/project.json è presente */
+    hasManifest: boolean;
+    /** Livello di maturità configurazione */
+    setupLevel: SetupLevel;
+    /** Salute del contesto (ok, info, warning, critical) */
+    healthLevel: ContextHealthLevel;
+    /** Sommario dei problemi di contesto (max 3) */
+    healthIssues: string[];
+    /** Prossimo passo suggerito dall'info engine */
+    nextStep: {
+        cmd: string;
+        reason: string;
+    };
+}
+/** Stato della sessione locale attiva */
+export interface SessionContext {
+    /** Se c'è una sessione attiva */
+    active: boolean;
+    /** ID sessione (abbreviato a 8 char per leggibilità) */
+    id: string | null;
+    /** Durata in minuti */
+    durationMinutes: number | null;
+    /** Branch git corrente */
+    gitBranch: string | null;
+    /** Conteggi */
+    counts: {
+        notesTotal: number;
+        notesUser: number;
+        notesAgent: number;
+        tasksOpen: number;
+        tasksDone: number;
+        decisions: number;
+        warnings: number;
+    };
+    /** Ultime 3 entry (testo troncato a 80 char) */
+    recentEntries: RecentEntry[];
+    /** Se la sessione è lunga (>2h) */
+    isLong: boolean;
+}
+/** Entry recente nel diario sessione (leggera) */
+export interface RecentEntry {
+    kind: NoteKind;
+    source: NoteSource;
+    text: string;
+    minutesAgo: number;
+}
+/** Capacità disponibili al momento */
+export interface CapabilitiesContext {
+    /** Comandi slash disponibili */
+    availableCommands: string[];
+    /** Se autenticato con token valido */
+    authenticated: boolean;
+    /** Se il backend è raggiungibile (null = non verificato) */
+    backendReachable: boolean | null;
+    /** Se il MCP server locale è attivo (solo per info) */
+    mcpServerActive: boolean;
+    /** Livello di capability corrente */
+    capabilityLevel: CapabilityLevel;
+}
+/** Livello di capability basato sullo stato */
+export type CapabilityLevel = 'offline' | 'readonly' | 'local_write' | 'full';
+/** Stato tecnico dell'ambiente */
+export interface TechContext {
+    /** Working directory (basename solo, non path completo) */
+    cwd: string;
+    /** Branch git */
+    gitBranch: string | null;
+    /** Se ci sono modifiche non committate (null = non verificato) */
+    gitDirty: boolean | null;
+    /** Ultimo errore transiente (null se nessuno) */
+    lastError: string | null;
+}
+/** Context Packet completo */
+export interface ContextPacket {
+    /** Versione dello schema (per compatibilità futura) */
+    version: 1;
+    /** Timestamp di generazione ISO 8601 */
+    generatedAt: string;
+    /** Stato progetto */
+    project: ProjectContext;
+    /** Stato sessione */
+    session: SessionContext;
+    /** Capacità disponibili */
+    capabilities: CapabilitiesContext;
+    /** Stato tecnico */
+    tech: TechContext;
+}
+/** Input per il builder — usa solo strutture già esistenti nella CLI */
+export interface ContextPacketInput {
+    /** OrbitState.* fields selezionati */
+    hasToken: boolean;
+    hasSite: boolean;
+    hasManifest: boolean;
+    projectName: string | null;
+    platform: string | null;
+    environment: string | null;
+    healthLevel: ContextHealthLevel;
+    healthIssues: string[];
+    setupLevel: SetupLevel;
+    nextStep: {
+        cmd: string;
+        reason: string;
+    };
+    /** SessionState o null */
+    session: {
+        id: string;
+        started_at: string;
+        notes: Array<{
+            text: string;
+            timestamp: string;
+            kind?: NoteKind;
+            source?: NoteSource;
+            taskStatus?: 'open' | 'done';
+        }>;
+    } | null;
+    /** Git */
+    gitBranch: string | null;
+    gitDirty: boolean | null;
+    /** Tech */
+    cwd: string;
+    lastError: string | null;
+    /** Capabilities */
+    backendReachable: boolean | null;
+    mcpServerActive: boolean;
+}
+/**
+ * Assembla un ContextPacket da input già disponibili nella CLI.
+ * Pure function — nessun side effect, nessuna chiamata I/O.
+ */
+export declare function buildContextPacket(input: ContextPacketInput): ContextPacket;