@orbitpanel/cli 1.6.0 → 1.7.0

package/dist/lib/info-engine.d.ts

@@ -1,13 +1,20 @@
 /**
- * Info engine for @orbitpanel/cli.
+ * SOURCE OF TRUTH — User guidance layer
  *
  * Computes the "what should I do now?" logic:
- * - Next step recommendation
- * - Workflow checklist with visual status
- * - Contextual suggestions (max 2, with reasons)
- * - Onboarding steps for first-time users
+ * - setup level (unconfigured → configured)
+ * - onboarding steps for first-time users
+ * - next step recommendation
+ * - workflow checklist with visual status
+ * - contextual suggestions (max 2, with reasons)
+ * - welcome message
  *
- * PRINCIPLE: Every output answers "cosa fare adesso e perche'"
+ * PRINCIPLE: Every output answers "cosa fare adesso e perché"
+ *
+ * NON mettere qui:
+ * - logica di esecuzione comandi → command-router.ts
+ * - policy di sicurezza / guard → context-guard.ts
+ * - hint per comandi sconosciuti → shell-hints.ts
  */
 import type { ContextHealthLevel } from '../types.js';
 export interface InfoState {

package/dist/lib/info-engine.js

@@ -1,13 +1,20 @@
 /**
- * Info engine for @orbitpanel/cli.
+ * SOURCE OF TRUTH — User guidance layer
  *
  * Computes the "what should I do now?" logic:
- * - Next step recommendation
- * - Workflow checklist with visual status
- * - Contextual suggestions (max 2, with reasons)
- * - Onboarding steps for first-time users
+ * - setup level (unconfigured → configured)
+ * - onboarding steps for first-time users
+ * - next step recommendation
+ * - workflow checklist with visual status
+ * - contextual suggestions (max 2, with reasons)
+ * - welcome message
  *
- * PRINCIPLE: Every output answers "cosa fare adesso e perche'"
+ * PRINCIPLE: Every output answers "cosa fare adesso e perché"
+ *
+ * NON mettere qui:
+ * - logica di esecuzione comandi → command-router.ts
+ * - policy di sicurezza / guard → context-guard.ts
+ * - hint per comandi sconosciuti → shell-hints.ts
  */
 // ─── Setup Level ──────────────────────────────────────────────────
 /**

package/dist/lib/info-engine.js.map

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

package/dist/lib/report-builder.d.ts

@@ -1,8 +1,10 @@
 /**
  * Report builder for @orbitpanel/cli.
  * Assembles intervention payload from session data + git info.
+ *
+ * v2: reads source/kind from SessionNote for structured reports.
  */
-import type { SessionState } from '../types.js';
+import type { SessionState, SessionNote } from '../types.js';
 export interface ReportOptions {
     session: SessionState;
     title?: string;
@@ -13,5 +15,25 @@ export interface ReportOptions {
     files_changed?: number;
     environment?: string;
 }
+/** Grouped notes by source and kind */
+export interface GroupedNotes {
+    /** Notes from source='user' or legacy (no source) */
+    userNotes: SessionNote[];
+    /** Notes from source='mcp' or 'ai' */
+    agentNotes: SessionNote[];
+    /** Notes from source='system' */
+    systemNotes: SessionNote[];
+    /** Tasks grouped by status */
+    tasks: {
+        open: SessionNote[];
+        done: SessionNote[];
+    };
+    /** Decision entries */
+    decisions: SessionNote[];
+    /** Warning entries */
+    warnings: SessionNote[];
+}
+/** Group notes by source and kind. Exported for testability. */
+export declare function groupNotes(notes: SessionNote[]): GroupedNotes;
 /** Build a complete intervention payload ready for POST /api/v1/maintenance/ */
 export declare function buildReportPayload(opts: ReportOptions): Record<string, unknown>;

package/dist/lib/report-builder.js

@@ -1,21 +1,78 @@
 /**
  * Report builder for @orbitpanel/cli.
  * Assembles intervention payload from session data + git info.
+ *
+ * v2: reads source/kind from SessionNote for structured reports.
  */
+/** Group notes by source and kind. Exported for testability. */
+export function groupNotes(notes) {
+    const result = {
+        userNotes: [],
+        agentNotes: [],
+        systemNotes: [],
+        tasks: { open: [], done: [] },
+        decisions: [],
+        warnings: [],
+    };
+    for (const note of notes) {
+        const source = note.source ?? 'user';
+        const kind = note.kind ?? 'note';
+        // Group by kind (cross-source)
+        if (kind === 'task') {
+            if (note.taskStatus === 'done') {
+                result.tasks.done.push(note);
+            }
+            else {
+                result.tasks.open.push(note);
+            }
+        }
+        else if (kind === 'decision') {
+            result.decisions.push(note);
+        }
+        else if (kind === 'warning') {
+            result.warnings.push(note);
+        }
+        // Group by source (only generic notes — tasks/decisions/warnings already categorised)
+        if (kind === 'note') {
+            if (source === 'mcp' || source === 'ai') {
+                result.agentNotes.push(note);
+            }
+            else if (source === 'system') {
+                result.systemNotes.push(note);
+            }
+            else {
+                result.userNotes.push(note);
+            }
+        }
+    }
+    return result;
+}
+/** Map note source to actions_taken tool_used value */
+function mapToolUsed(source) {
+    switch (source) {
+        case 'mcp': return 'mcp-agent';
+        case 'ai': return 'ai-agent';
+        case 'system': return 'system-auto';
+        default: return 'manual';
+    }
+}
 /** Build a complete intervention payload ready for POST /api/v1/maintenance/ */
 export function buildReportPayload(opts) {
     const { session } = opts;
     // Auto-generate title from session if not provided
     const title = opts.title ?? generateTitle(session);
-    // Convert notes to actions_taken format
+    const grouped = groupNotes(session.notes);
+    // Convert notes to actions_taken format (v2: source → tool_used)
     const actions_taken = session.notes.map(note => ({
         action: note.text,
-        tool_used: 'manual',
+        tool_used: mapToolUsed(note.source),
         result: 'success',
         timestamp: note.timestamp,
     }));
     // Auto-generate description from notes if not provided
-    const description = opts.description ?? generateDescription(session);
+    const description = opts.description ?? generateDescription(session, grouped);
+    // Build notes_summary (additive, optional field)
+    const notes_summary = buildNotesSummary(session.notes, grouped);
     // Build report_data matching backend schema v1.0
     const report_data = {
         findings: [],
@@ -30,6 +87,7 @@ export function buildReportPayload(opts) {
             git_commit_end: opts.git_commit_end,
             files_changed: opts.files_changed ?? 0,
             environment: opts.environment ?? 'local-dev',
+            notes_summary,
         },
     };
     return {
@@ -50,7 +108,8 @@ function generateTitle(session) {
     }
     return parts.join(' ');
 }
-function generateDescription(session) {
+/** v2: structured description with sections based on source/kind */
+function generateDescription(session, grouped) {
     const lines = [];
     lines.push('## Sessione locale');
     lines.push('');
@@ -60,14 +119,82 @@ function generateDescription(session) {
     if (session.git_commit_start) {
         lines.push(`- Commit inizio: ${session.git_commit_start}`);
     }
-    if (session.notes.length > 0) {
+    // Section: Attività svolte (user notes, kind='note')
+    if (grouped.userNotes.length > 0) {
         lines.push('');
-        lines.push('## Note');
+        lines.push('## Attività svolte');
         lines.push('');
-        for (const note of session.notes) {
+        for (const note of grouped.userNotes) {
             lines.push(`- ${note.text}`);
         }
     }
+    // Section: Task (open + done)
+    const hasTasks = grouped.tasks.done.length > 0 || grouped.tasks.open.length > 0;
+    if (hasTasks) {
+        lines.push('');
+        lines.push('## Task');
+        lines.push('');
+        for (const t of grouped.tasks.done) {
+            lines.push(`- [x] ${t.text}`);
+        }
+        for (const t of grouped.tasks.open) {
+            lines.push(`- [ ] ${t.text}`);
+        }
+    }
+    // Section: Decisioni
+    if (grouped.decisions.length > 0) {
+        lines.push('');
+        lines.push('## Decisioni');
+        lines.push('');
+        for (const d of grouped.decisions) {
+            lines.push(`- ${d.text}`);
+        }
+    }
+    // Section: Note automatiche (agent = mcp + ai)
+    if (grouped.agentNotes.length > 0) {
+        lines.push('');
+        lines.push('## Note automatiche');
+        lines.push('');
+        for (const n of grouped.agentNotes) {
+            lines.push(`- ${n.text}`);
+        }
+    }
+    // Section: Avvisi (warnings + system notes)
+    const warningsAndSystem = [...grouped.warnings, ...grouped.systemNotes];
+    if (warningsAndSystem.length > 0) {
+        lines.push('');
+        lines.push('## Avvisi');
+        lines.push('');
+        for (const w of warningsAndSystem) {
+            lines.push(`- ${w.text}`);
+        }
+    }
     return lines.join('\n');
 }
+/** Build additive notes_summary for report_data.session */
+function buildNotesSummary(notes, grouped) {
+    let userCount = 0;
+    let agentCount = 0;
+    let systemCount = 0;
+    for (const note of notes) {
+        const source = note.source ?? 'user';
+        if (source === 'mcp' || source === 'ai') {
+            agentCount++;
+        }
+        else if (source === 'system') {
+            systemCount++;
+        }
+        else {
+            userCount++;
+        }
+    }
+    return {
+        total: notes.length,
+        by_source: { user: userCount, agent: agentCount, system: systemCount },
+        tasks_open: grouped.tasks.open.length,
+        tasks_done: grouped.tasks.done.length,
+        decisions: grouped.decisions.length,
+        warnings: grouped.warnings.length,
+    };
+}
 //# sourceMappingURL=report-builder.js.map

package/dist/lib/report-builder.js.map

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

package/dist/lib/session-engine.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SOURCE OF TRUTH — Session lifecycle orchestration
+ *
+ * Cuore operativo locale della CLI. Gestisce:
+ * - avvio e chiusura sessioni (con cattura git automatica)
+ * - aggiunta entry (note, task, decisioni, warning) con source/kind
+ * - summary e metriche sessione
+ * - storico sessioni completate
+ *
+ * Usato da:
+ * - comandi CLI (shell-commands.ts)
+ * - MCP tools (mcp/server.ts)
+ *
+ * NON dipende da:
+ * - UI (chalk, ink, react, shell-render)
+ * - backend API (client.ts)
+ * - comandi specifici (shell-commands.ts)
+ */
+import type { SessionState, SessionNote, SessionSummary, NoteSource, NoteKind } from '../types.js';
+import { type SessionIO } from './session.js';
+import { type GitRunner } from './git.js';
+/** Dependencies — injectable for testing */
+export interface SessionEngineDeps {
+    io: SessionIO;
+    git: GitRunner;
+}
+/** Input for adding an entry to the active session */
+export interface AddEntryInput {
+    text: string;
+    source: NoteSource;
+    kind: NoteKind;
+    priority?: SessionNote['priority'];
+}
+/**
+ * Session Engine v2 — orchestrates session lifecycle for a single site.
+ *
+ * Stateless: every method reads from disk. No in-memory cache.
+ * This means multiple consumers (CLI + MCP) can operate concurrently.
+ */
+export declare class SessionEngine {
+    private readonly siteId;
+    private readonly io;
+    private readonly git;
+    constructor(siteId: string, deps?: SessionEngineDeps);
+    /** Start a new session. Captures git branch and commit automatically. */
+    startSession(initialNote?: string): Promise<SessionState>;
+    /** End the active session. Captures final git commit automatically. */
+    endSession(summary?: string): Promise<SessionState>;
+    /**
+     * Add an entry (note, task, decision, warning) to the active session.
+     * Always populates id, source, kind, and timestamp.
+     */
+    addEntry(input: AddEntryInput): Promise<SessionState>;
+    /**
+     * Mark a task entry as done.
+     * No-op if already done. Throws if entry not found or not a task.
+     */
+    completeTask(entryId: string): Promise<SessionState>;
+    /** Get the active session, or null if none. */
+    getActive(): Promise<SessionState | null>;
+    /** Compute summary metrics for the active session. Returns null if no active session. */
+    getSummary(): Promise<SessionSummary | null>;
+    /** List completed sessions, newest first. */
+    listHistory(limit?: number): Promise<SessionState[]>;
+}

package/dist/lib/session-engine.js

@@ -0,0 +1,143 @@
+/**
+ * SOURCE OF TRUTH — Session lifecycle orchestration
+ *
+ * Cuore operativo locale della CLI. Gestisce:
+ * - avvio e chiusura sessioni (con cattura git automatica)
+ * - aggiunta entry (note, task, decisioni, warning) con source/kind
+ * - summary e metriche sessione
+ * - storico sessioni completate
+ *
+ * Usato da:
+ * - comandi CLI (shell-commands.ts)
+ * - MCP tools (mcp/server.ts)
+ *
+ * NON dipende da:
+ * - UI (chalk, ink, react, shell-render)
+ * - backend API (client.ts)
+ * - comandi specifici (shell-commands.ts)
+ */
+import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
+import { createSession, loadActiveSession, endSession, listCompletedSessions, SESSIONS_DIR, defaultIO, } from './session.js';
+import { getGitBranch, getGitCommitHead, defaultRunner } from './git.js';
+/**
+ * Session Engine v2 — orchestrates session lifecycle for a single site.
+ *
+ * Stateless: every method reads from disk. No in-memory cache.
+ * This means multiple consumers (CLI + MCP) can operate concurrently.
+ */
+export class SessionEngine {
+    siteId;
+    io;
+    git;
+    constructor(siteId, deps) {
+        this.siteId = siteId;
+        this.io = deps?.io ?? defaultIO;
+        this.git = deps?.git ?? defaultRunner;
+    }
+    /** Start a new session. Captures git branch and commit automatically. */
+    async startSession(initialNote) {
+        const existing = await loadActiveSession(this.siteId, this.io);
+        if (existing) {
+            throw new Error(`Sessione gia' attiva: ${existing.id}. Chiudila prima con /session end.`);
+        }
+        const branch = await getGitBranch(this.git);
+        const commit = await getGitCommitHead(this.git);
+        return createSession(this.siteId, {
+            git_branch: branch ?? undefined,
+            git_commit: commit ?? undefined,
+            note: initialNote,
+        }, this.io);
+    }
+    /** End the active session. Captures final git commit automatically. */
+    async endSession(summary) {
+        const active = await loadActiveSession(this.siteId, this.io);
+        if (!active) {
+            throw new Error('Nessuna sessione attiva da chiudere.');
+        }
+        const commit = await getGitCommitHead(this.git);
+        return endSession(active.id, {
+            git_commit_end: commit ?? undefined,
+            summary,
+        }, this.io);
+    }
+    /**
+     * Add an entry (note, task, decision, warning) to the active session.
+     * Always populates id, source, kind, and timestamp.
+     */
+    async addEntry(input) {
+        const active = await loadActiveSession(this.siteId, this.io);
+        if (!active) {
+            throw new Error('Nessuna sessione attiva. Avviala con /session start.');
+        }
+        const entry = {
+            id: randomUUID().replace(/-/g, '').slice(0, 12),
+            text: input.text,
+            timestamp: new Date().toISOString(),
+            priority: input.priority ?? 'medium',
+            source: input.source,
+            kind: input.kind,
+            taskStatus: input.kind === 'task' ? 'open' : undefined,
+        };
+        active.notes.push(entry);
+        await this.io.write(join(SESSIONS_DIR, `${active.id}.json`), JSON.stringify(active, null, 2));
+        return active;
+    }
+    /**
+     * Mark a task entry as done.
+     * No-op if already done. Throws if entry not found or not a task.
+     */
+    async completeTask(entryId) {
+        const active = await loadActiveSession(this.siteId, this.io);
+        if (!active) {
+            throw new Error('Nessuna sessione attiva.');
+        }
+        const entry = active.notes.find(n => n.id === entryId);
+        if (!entry) {
+            throw new Error(`Entry non trovato: ${entryId}`);
+        }
+        if (entry.kind !== 'task') {
+            throw new Error(`Entry "${entryId}" non e' un task (kind: ${entry.kind}).`);
+        }
+        // No-op if already done
+        if (entry.taskStatus === 'done') {
+            return active;
+        }
+        entry.taskStatus = 'done';
+        await this.io.write(join(SESSIONS_DIR, `${active.id}.json`), JSON.stringify(active, null, 2));
+        return active;
+    }
+    /** Get the active session, or null if none. */
+    async getActive() {
+        return loadActiveSession(this.siteId, this.io);
+    }
+    /** Compute summary metrics for the active session. Returns null if no active session. */
+    async getSummary() {
+        const active = await loadActiveSession(this.siteId, this.io);
+        if (!active)
+            return null;
+        const tasks = active.notes.filter(n => n.kind === 'task');
+        const lastNote = active.notes.length > 0
+            ? active.notes[active.notes.length - 1]
+            : null;
+        const startMs = new Date(active.started_at).getTime();
+        const endMs = active.ended_at
+            ? new Date(active.ended_at).getTime()
+            : Date.now();
+        return {
+            sessionId: active.id,
+            status: active.status,
+            notesCount: active.notes.length,
+            tasksTotal: tasks.length,
+            tasksOpen: tasks.filter(t => t.taskStatus === 'open').length,
+            tasksDone: tasks.filter(t => t.taskStatus === 'done').length,
+            latestActivityAt: lastNote?.timestamp ?? null,
+            durationMs: endMs - startMs,
+        };
+    }
+    /** List completed sessions, newest first. */
+    async listHistory(limit = 10) {
+        return listCompletedSessions(this.siteId, limit, this.io);
+    }
+}
+//# sourceMappingURL=session-engine.js.map

package/dist/lib/session-engine.js.map

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

package/dist/lib/session-summary-format.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Session summary formatting — pure functions.
+ *
+ * Computes display-ready stats from SessionState using groupNotes().
+ * No IO, no side effects. Used by shell commands and CLI status.
+ */
+import type { SessionState, SessionNote } from '../types.js';
+export interface SessionStats {
+    notesTotal: number;
+    notesUser: number;
+    notesAgent: number;
+    tasksOpen: number;
+    tasksDone: number;
+    decisions: number;
+    warnings: number;
+}
+/** Compute flat stats from session notes using groupNotes(). */
+export declare function computeSessionStats(session: SessionState): SessionStats;
+/**
+ * Format 0–3 summary lines for cmdStatus / cmdSessionInfo.
+ * Each line is pre-indented (5 spaces). Only non-trivial lines are included.
+ * Returns empty array if nothing interesting to show (e.g. all-user, no tasks).
+ */
+export declare function formatSummaryLines(stats: SessionStats): string[];
+/**
+ * Format a one-liner for /info. Returns null if nothing to show.
+ * Example: "12 note · 3 task aperti"
+ */
+export declare function formatSummaryOneLiner(stats: SessionStats): string | null;
+/**
+ * Format a list of open tasks with abbreviated IDs.
+ * Returns empty array if no actionable tasks exist.
+ * Used by cmdSessionInfo to make tasks discoverable.
+ */
+export declare function formatOpenTaskList(notes: SessionNote[]): string[];