@orbitpanel/cli 1.2.1 → 1.3.0

package/dist/lib/environment.js

@@ -0,0 +1,75 @@
+/**
+ * Environment detection and mismatch checking for @orbitpanel/cli.
+ *
+ * Detects environment from URLs using conservative heuristics.
+ * Reports mismatches between manifest-declared and detected environments.
+ *
+ * PRINCIPLE: Never assume production. If detection is ambiguous, return null.
+ */
+/**
+ * Detect environment from a URL using conservative heuristics.
+ * Returns null if detection is ambiguous (no false positives).
+ */
+export function detectEnvironmentFromUrl(url) {
+    if (!url || url.trim() === '')
+        return null;
+    let hostname;
+    try {
+        // Handle URLs without protocol
+        const normalized = url.includes('://') ? url : `http://${url}`;
+        hostname = new URL(normalized).hostname.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+    // Local indicators
+    if (hostname === 'localhost' ||
+        hostname === '127.0.0.1' ||
+        hostname === '0.0.0.0' ||
+        hostname === '::1' ||
+        hostname.endsWith('.local') ||
+        hostname.endsWith('.test') ||
+        hostname.endsWith('.localhost')) {
+        return 'local';
+    }
+    // Staging indicators
+    if (hostname.startsWith('staging.') ||
+        hostname.startsWith('staging-') ||
+        hostname.includes('.staging.')) {
+        return 'staging';
+    }
+    // Dev indicators
+    if (hostname.startsWith('dev.') ||
+        hostname.startsWith('dev-') ||
+        hostname.includes('.dev.')) {
+        return 'dev';
+    }
+    // Ambiguous — do NOT assume production
+    return null;
+}
+/**
+ * Check for environment mismatch between manifest and detected environment.
+ * Only reports mismatch when detection is confident (non-null).
+ */
+export function checkEnvironmentMismatch(manifest, url) {
+    const detectedEnv = detectEnvironmentFromUrl(url);
+    // No detection → no mismatch (we can't be sure)
+    if (detectedEnv === null) {
+        return {
+            manifestEnv: manifest.environment,
+            detectedEnv: null,
+            mismatch: false,
+            warning: null,
+        };
+    }
+    const mismatch = detectedEnv !== manifest.environment;
+    return {
+        manifestEnv: manifest.environment,
+        detectedEnv,
+        mismatch,
+        warning: mismatch
+            ? `Ambiente incoerente: manifest=${manifest.environment}, rilevato=${detectedEnv}`
+            : null,
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/lib/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/lib/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAA8B;IACrE,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAE3C,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,+BAA+B;QAC/B,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC;QAC/D,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mBAAmB;IACnB,IACE,QAAQ,KAAK,WAAW;QACxB,QAAQ,KAAK,WAAW;QACxB,QAAQ,KAAK,SAAS;QACtB,QAAQ,KAAK,KAAK;QAClB,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1B,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC/B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,qBAAqB;IACrB,IACE,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC;QAC/B,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC;QAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC9B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,iBAAiB;IACjB,IACE,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uCAAuC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAyB,EACzB,GAAY;IAEZ,MAAM,WAAW,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAElD,gDAAgD;IAChD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO;YACL,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,KAAK,QAAQ,CAAC,WAAW,CAAC;IAEtD,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW;QACX,QAAQ;QACR,OAAO,EAAE,QAAQ;YACf,CAAC,CAAC,iCAAiC,QAAQ,CAAC,WAAW,cAAc,WAAW,EAAE;YAClF,CAAC,CAAC,IAAI;KACT,CAAC;AACJ,CAAC"}

package/dist/lib/init-logic.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Init command logic for @orbitpanel/cli.
+ *
+ * Separated from the oclif command class for testability.
+ * The oclif command handles CLI parsing, this handles the logic.
+ */
+import type { ProjectManifest, PlatformType, EnvironmentType } from '../types.js';
+import { type ManifestIO } from './manifest.js';
+export interface InitOptions {
+    cwd: string;
+    name: string;
+    platform: PlatformType;
+    environment: EnvironmentType;
+    force?: boolean;
+    io?: ManifestIO;
+    log: (message: string) => void;
+}
+export interface InitResult {
+    created: boolean;
+    alreadyExists: boolean;
+    manifest: ProjectManifest | null;
+}
+/**
+ * Core init logic — creates .orbit/project.json.
+ * Does NOT auto-link to backend. That's `orbit link`.
+ */
+export declare function runInit(opts: InitOptions): Promise<InitResult>;

package/dist/lib/init-logic.js

@@ -0,0 +1,34 @@
+/**
+ * Init command logic for @orbitpanel/cli.
+ *
+ * Separated from the oclif command class for testability.
+ * The oclif command handles CLI parsing, this handles the logic.
+ */
+import { join } from 'node:path';
+import { MANIFEST_DIR, MANIFEST_FILENAME, saveManifest } from './manifest.js';
+/**
+ * Core init logic — creates .orbit/project.json.
+ * Does NOT auto-link to backend. That's `orbit link`.
+ */
+export async function runInit(opts) {
+    const { cwd, name, platform, environment, force, log } = opts;
+    // Use provided IO or import default
+    const io = opts.io ?? (await import('./manifest.js')).defaultManifestIO;
+    // Check if already exists
+    const manifestPath = join(cwd, MANIFEST_DIR, MANIFEST_FILENAME);
+    if (!force && await io.exists(manifestPath)) {
+        log(`Progetto gia inizializzato: ${manifestPath}`);
+        log('Usa --force per sovrascrivere.');
+        return { created: false, alreadyExists: true, manifest: null };
+    }
+    const manifest = {
+        version: 1,
+        name,
+        platform,
+        environment,
+    };
+    await saveManifest(cwd, manifest, io);
+    log(`Progetto inizializzato: ${cwd}/.orbit/project.json`);
+    return { created: true, alreadyExists: false, manifest };
+}
+//# sourceMappingURL=init-logic.js.map

package/dist/lib/init-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-logic.js","sourceRoot":"","sources":["../../src/lib/init-logic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAmB,MAAM,eAAe,CAAC;AAkB/F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE9D,oCAAoC;IACpC,MAAM,EAAE,GAAe,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEpF,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;QACnD,GAAG,CAAC,gCAAgC,CAAC,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;IAED,MAAM,QAAQ,GAAoB;QAChC,OAAO,EAAE,CAAC;QACV,IAAI;QACJ,QAAQ;QACR,WAAW;KACZ,CAAC;IAEF,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEtC,GAAG,CAAC,2BAA2B,GAAG,sBAAsB,CAAC,CAAC;IAE1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC3D,CAAC"}

package/dist/lib/instructions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Project instructions loader for @orbitpanel/cli.
+ *
+ * Loads optional .orbit/instructions.md files that provide
+ * AI/UX context for the project. NOT a source of truth —
+ * only supplementary information.
+ */
+export declare const INSTRUCTIONS_FILENAME = "instructions.md";
+/** File I/O interface — overridable for testing. */
+export interface InstructionsIO {
+    read(path: string): Promise<string>;
+    exists(path: string): Promise<boolean>;
+}
+/**
+ * Load instructions.md from the .orbit/ directory.
+ * Returns the content as a string, or null if not found.
+ */
+export declare function loadInstructions(manifestDir: string, io?: InstructionsIO): Promise<string | null>;

package/dist/lib/instructions.js

@@ -0,0 +1,37 @@
+/**
+ * Project instructions loader for @orbitpanel/cli.
+ *
+ * Loads optional .orbit/instructions.md files that provide
+ * AI/UX context for the project. NOT a source of truth —
+ * only supplementary information.
+ */
+import { join } from 'node:path';
+import { readFile, access } from 'node:fs/promises';
+import { MANIFEST_DIR } from './manifest.js';
+export const INSTRUCTIONS_FILENAME = 'instructions.md';
+const defaultIO = {
+    read: (path) => readFile(path, 'utf-8'),
+    exists: async (path) => {
+        try {
+            await access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+};
+/**
+ * Load instructions.md from the .orbit/ directory.
+ * Returns the content as a string, or null if not found.
+ */
+export async function loadInstructions(manifestDir, io = defaultIO) {
+    try {
+        const path = join(manifestDir, MANIFEST_DIR, INSTRUCTIONS_FILENAME);
+        return await io.read(path);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=instructions.js.map

package/dist/lib/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAQvD,MAAM,SAAS,GAAmB;IAChC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,CAAC;YAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;IAClE,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,KAAqB,SAAS;IAE9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,qBAAqB,CAAC,CAAC;QACpE,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/manifest.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Project manifest management for @orbitpanel/cli.
+ *
+ * Handles .orbit/project.json discovery, validation, and persistence.
+ * Supports backward compatibility with legacy .orbit.json format.
+ *
+ * SEPARATION OF CONCERNS:
+ * - This module handles ONLY project identity (manifest)
+ * - Instructions (AI/UX context) are in instructions.ts
+ * - Environment detection is in environment.ts
+ */
+import type { ProjectManifest, ManifestValidationResult, SiteLink } from '../types.js';
+export declare const MANIFEST_DIR = ".orbit";
+export declare const MANIFEST_FILENAME = "project.json";
+export declare const MANIFEST_PATH = ".orbit/project.json";
+export declare const LEGACY_FILENAME = ".orbit.json";
+export declare const MAX_TRAVERSAL_DEPTH = 10;
+/** File I/O interface — overridable for testing. */
+export interface ManifestIO {
+    read(path: string): Promise<string>;
+    write(path: string, data: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    mkdir(path: string): Promise<void>;
+}
+export declare const defaultManifestIO: ManifestIO;
+/** Validate a parsed manifest object. Returns validation result. */
+export declare function validateManifest(data: unknown): Omit<ManifestValidationResult, 'manifestDir' | 'legacy'>;
+/**
+ * Find a project manifest by walking up the directory tree.
+ * Checks for .orbit/project.json first, then .orbit.json (legacy).
+ */
+export declare function findManifest(startDir: string, io?: ManifestIO): Promise<ManifestValidationResult>;
+/** Load manifest from a specific directory (no parent traversal). */
+export declare function loadManifest(dir: string, io?: ManifestIO): Promise<ManifestValidationResult>;
+/** Save manifest to .orbit/project.json. Creates .orbit/ directory if needed. */
+export declare function saveManifest(dir: string, manifest: ProjectManifest, io?: ManifestIO): Promise<void>;
+/** Convert a legacy SiteLink to a ProjectManifest. */
+export declare function migrateFromLegacy(legacy: SiteLink): ProjectManifest;

package/dist/lib/manifest.js

@@ -0,0 +1,237 @@
+/**
+ * Project manifest management for @orbitpanel/cli.
+ *
+ * Handles .orbit/project.json discovery, validation, and persistence.
+ * Supports backward compatibility with legacy .orbit.json format.
+ *
+ * SEPARATION OF CONCERNS:
+ * - This module handles ONLY project identity (manifest)
+ * - Instructions (AI/UX context) are in instructions.ts
+ * - Environment detection is in environment.ts
+ */
+import { join, dirname, resolve } from 'node:path';
+import { readFile, writeFile, mkdir, access } from 'node:fs/promises';
+// ─── Constants ────────────────────────────────────────────────────
+export const MANIFEST_DIR = '.orbit';
+export const MANIFEST_FILENAME = 'project.json';
+export const MANIFEST_PATH = `${MANIFEST_DIR}/${MANIFEST_FILENAME}`;
+export const LEGACY_FILENAME = '.orbit.json';
+export const MAX_TRAVERSAL_DEPTH = 10;
+const VALID_VERSIONS = [1];
+const VALID_PLATFORMS = ['wordpress', 'prestashop', 'custom'];
+const VALID_ENVIRONMENTS = ['local', 'dev', 'staging', 'production'];
+const KNOWN_FIELDS = new Set([
+    'version', 'name', 'platform', 'environment', 'linkedSiteId', 'root',
+]);
+export const defaultManifestIO = {
+    read: (path) => readFile(path, 'utf-8'),
+    write: (path, data) => writeFile(path, data, { encoding: 'utf-8', mode: 0o644 }),
+    exists: async (path) => {
+        try {
+            await access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    mkdir: async (path) => { await mkdir(path, { recursive: true }); },
+};
+// ─── Validation ───────────────────────────────────────────────────
+/** Validate a parsed manifest object. Returns validation result. */
+export function validateManifest(data) {
+    const errors = [];
+    const warnings = [];
+    if (data === null || data === undefined || typeof data !== 'object') {
+        return { valid: false, manifest: null, errors: ['Manifest deve essere un oggetto JSON'], warnings };
+    }
+    const obj = data;
+    // version (required, must be supported)
+    if (obj.version === undefined || obj.version === null) {
+        errors.push('Campo "version" obbligatorio');
+    }
+    else if (!VALID_VERSIONS.includes(obj.version)) {
+        errors.push(`Campo "version" non supportato: ${obj.version}. Valori: ${VALID_VERSIONS.join(', ')}`);
+    }
+    // name (required, non-empty string)
+    if (obj.name === undefined || obj.name === null) {
+        errors.push('Campo "name" obbligatorio');
+    }
+    else if (typeof obj.name !== 'string' || obj.name.trim() === '') {
+        errors.push('Campo "name" deve essere una stringa non vuota');
+    }
+    // platform (required, must be valid)
+    if (obj.platform === undefined || obj.platform === null) {
+        errors.push('Campo "platform" obbligatorio');
+    }
+    else if (!VALID_PLATFORMS.includes(obj.platform)) {
+        errors.push(`Campo "platform" non valido: ${obj.platform}. Valori: ${VALID_PLATFORMS.join(', ')}`);
+    }
+    // environment (required, must be valid)
+    if (obj.environment === undefined || obj.environment === null) {
+        errors.push('Campo "environment" obbligatorio');
+    }
+    else if (!VALID_ENVIRONMENTS.includes(obj.environment)) {
+        errors.push(`Campo "environment" non valido: ${obj.environment}. Valori: ${VALID_ENVIRONMENTS.join(', ')}`);
+    }
+    // Warn on unknown fields
+    for (const key of Object.keys(obj)) {
+        if (!KNOWN_FIELDS.has(key)) {
+            warnings.push(`Campo sconosciuto "${key}" — verra ignorato`);
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, manifest: null, errors, warnings };
+    }
+    const manifest = {
+        version: obj.version,
+        name: obj.name.trim(),
+        platform: obj.platform,
+        environment: obj.environment,
+        ...(obj.linkedSiteId !== undefined && { linkedSiteId: String(obj.linkedSiteId) }),
+        ...(obj.root !== undefined && { root: String(obj.root) }),
+    };
+    return { valid: true, manifest, errors: [], warnings };
+}
+// ─── Find Manifest (walk-up) ──────────────────────────────────────
+/**
+ * Find a project manifest by walking up the directory tree.
+ * Checks for .orbit/project.json first, then .orbit.json (legacy).
+ */
+export async function findManifest(startDir, io = defaultManifestIO) {
+    const notFound = {
+        valid: false,
+        manifest: null,
+        errors: [],
+        warnings: [],
+        manifestDir: null,
+        legacy: false,
+    };
+    let currentDir = resolve(startDir);
+    let depth = 0;
+    while (depth < MAX_TRAVERSAL_DEPTH) {
+        // 1. Check .orbit/project.json (preferred)
+        const manifestPath = join(currentDir, MANIFEST_DIR, MANIFEST_FILENAME);
+        if (await io.exists(manifestPath)) {
+            return readAndValidateManifest(manifestPath, currentDir, false, io);
+        }
+        // 2. Check .orbit.json (legacy fallback) — only in current dir, not parents
+        if (depth === 0) {
+            // Also check parents for legacy
+        }
+        const legacyPath = join(currentDir, LEGACY_FILENAME);
+        if (await io.exists(legacyPath)) {
+            return readAndValidateLegacy(legacyPath, currentDir, io);
+        }
+        // Go up one level
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            // Reached root
+            break;
+        }
+        currentDir = parentDir;
+        depth++;
+    }
+    return notFound;
+}
+/** Read and validate a .orbit/project.json file. */
+async function readAndValidateManifest(filePath, dir, legacy, io) {
+    try {
+        const raw = await io.read(filePath);
+        const parsed = JSON.parse(raw);
+        const validation = validateManifest(parsed);
+        return {
+            ...validation,
+            manifestDir: dir,
+            legacy,
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            manifest: null,
+            errors: [`Errore lettura manifest: ${error instanceof Error ? error.message : String(error)}`],
+            warnings: [],
+            manifestDir: dir,
+            legacy,
+        };
+    }
+}
+/** Read a legacy .orbit.json and convert to manifest format. */
+async function readAndValidateLegacy(filePath, dir, io) {
+    try {
+        const raw = await io.read(filePath);
+        const parsed = JSON.parse(raw);
+        const manifest = migrateFromLegacy(parsed);
+        const validation = validateManifest(manifest);
+        return {
+            ...validation,
+            manifestDir: dir,
+            legacy: true,
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            manifest: null,
+            errors: [`Errore lettura .orbit.json legacy: ${error instanceof Error ? error.message : String(error)}`],
+            warnings: [],
+            manifestDir: dir,
+            legacy: true,
+        };
+    }
+}
+// ─── Load Manifest (no walk-up) ───────────────────────────────────
+/** Load manifest from a specific directory (no parent traversal). */
+export async function loadManifest(dir, io = defaultManifestIO) {
+    const manifestPath = join(dir, MANIFEST_DIR, MANIFEST_FILENAME);
+    if (await io.exists(manifestPath)) {
+        return readAndValidateManifest(manifestPath, dir, false, io);
+    }
+    return {
+        valid: false,
+        manifest: null,
+        errors: [],
+        warnings: [],
+        manifestDir: null,
+        legacy: false,
+    };
+}
+// ─── Save Manifest ────────────────────────────────────────────────
+/** Save manifest to .orbit/project.json. Creates .orbit/ directory if needed. */
+export async function saveManifest(dir, manifest, io = defaultManifestIO) {
+    const orbitDir = join(dir, MANIFEST_DIR);
+    await io.mkdir(orbitDir);
+    await io.write(join(orbitDir, MANIFEST_FILENAME), JSON.stringify(manifest, null, 2) + '\n');
+}
+// ─── Legacy Migration ─────────────────────────────────────────────
+/** Map a legacy environment string to a valid EnvironmentType. */
+function mapLegacyEnvironment(env) {
+    if (!env)
+        return 'local';
+    const lower = env.toLowerCase();
+    if (lower.includes('local') || lower.includes('dev-local'))
+        return 'local';
+    if (lower === 'dev' || lower === 'development')
+        return 'dev';
+    if (lower.includes('staging') || lower.includes('stage'))
+        return 'staging';
+    if (lower.includes('prod') || lower.includes('live'))
+        return 'production';
+    // If the string is exactly a valid value, use it
+    if (VALID_ENVIRONMENTS.includes(lower))
+        return lower;
+    return 'local';
+}
+/** Convert a legacy SiteLink to a ProjectManifest. */
+export function migrateFromLegacy(legacy) {
+    return {
+        version: 1,
+        name: legacy.name || legacy.orbit_site_id,
+        platform: legacy.platform,
+        environment: mapLegacyEnvironment(legacy.environment),
+        linkedSiteId: legacy.orbit_site_id,
+        ...(legacy.final_url !== undefined && { root: '.' }),
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/lib/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/lib/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAUtE,qEAAqE;AAErE,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,YAAY,IAAI,iBAAiB,EAAE,CAAC;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,MAAM,cAAc,GAAsB,CAAC,CAAC,CAAC,CAAC;AAC9C,MAAM,eAAe,GAAmB,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAC9E,MAAM,kBAAkB,GAAsB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AACxF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM;CACrE,CAAC,CAAC;AAYH,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,CAAC;YAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;IAClE,CAAC;IACD,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;CACnE,CAAC;AAEF,qEAAqE;AAErE,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,sCAAsC,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtG,CAAC;IAED,MAAM,GAAG,GAAG,IAA+B,CAAC;IAE5C,wCAAwC;IACxC,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,OAA0B,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,mCAAmC,GAAG,CAAC,OAAO,aAAa,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,oCAAoC;IACpC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC;IAED,qCAAqC;IACrC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;SAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAwB,CAAC,EAAE,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,gCAAgC,GAAG,CAAC,QAAQ,aAAa,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,wCAAwC;IACxC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC;SAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,WAA8B,CAAC,EAAE,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC,mCAAmC,GAAG,CAAC,WAAW,aAAa,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9G,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,sBAAsB,GAAG,oBAAoB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAoB;QAChC,OAAO,EAAE,GAAG,CAAC,OAA0B;QACvC,IAAI,EAAG,GAAG,CAAC,IAAe,CAAC,IAAI,EAAE;QACjC,QAAQ,EAAE,GAAG,CAAC,QAAwB;QACtC,WAAW,EAAE,GAAG,CAAC,WAA8B;QAC/C,GAAG,CAAC,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;KAC1D,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;AACzD,CAAC;AAED,qEAAqE;AAErE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,KAAiB,iBAAiB;IAElC,MAAM,QAAQ,GAA6B;QACzC,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,KAAK;KACd,CAAC;IAEF,IAAI,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACnC,2CAA2C;QAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;QACvE,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,OAAO,uBAAuB,CAAC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,4EAA4E;QAC5E,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,gCAAgC;QAClC,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,OAAO,qBAAqB,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,kBAAkB;QAClB,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,eAAe;YACf,MAAM;QACR,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;QACvB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oDAAoD;AACpD,KAAK,UAAU,uBAAuB,CACpC,QAAgB,EAChB,GAAW,EACX,MAAe,EACf,EAAc;IAEd,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO;YACL,GAAG,UAAU;YACb,WAAW,EAAE,GAAG;YAChB,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,CAAC,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9F,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,GAAG;YAChB,MAAM;SACP,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,KAAK,UAAU,qBAAqB,CAClC,QAAgB,EAChB,GAAW,EACX,EAAc;IAEd,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;QAC3C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO;YACL,GAAG,UAAU;YACb,WAAW,EAAE,GAAG;YAChB,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,CAAC,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxG,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,GAAG;YAChB,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;AACH,CAAC;AAED,qEAAqE;AAErE,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,KAAiB,iBAAiB;IAElC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAChE,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,OAAO,uBAAuB,CAAC,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED,qEAAqE;AAErE,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,QAAyB,EACzB,KAAiB,iBAAiB;IAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,KAAK,CACZ,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EACjC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACzC,CAAC;AACJ,CAAC;AAED,qEAAqE;AAErE,kEAAkE;AAClE,SAAS,oBAAoB,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,OAAO,CAAC;IACzB,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3E,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3E,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IAC1E,iDAAiD;IACjD,IAAI,kBAAkB,CAAC,QAAQ,CAAC,KAAwB,CAAC;QAAE,OAAO,KAAwB,CAAC;IAC3F,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,iBAAiB,CAAC,MAAgB;IAChD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,aAAa;QACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC;QACrD,YAAY,EAAE,MAAM,CAAC,aAAa;QAClC,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/lib/shell-hints.d.ts

@@ -1,17 +1,33 @@
 /**
  * Contextual UX hints for the Orbit CLI shell.
  * Shows the right hint at the right time — not spam, not silence.
+ *
+ * The hints adapt to the user's current state:
+ * - Not authenticated → explain what Orbit CLI does + how to connect
+ * - Authenticated, no site → guide to link a site
+ * - Fully configured → show operational commands
+ * - Session active → show session commands
  */
 export interface ShellState {
     hasToken: boolean;
     hasSite: boolean;
     hasSession: boolean;
+    hasManifest: boolean;
+}
+export interface QuickTip {
+    cmd: string;
+    text: string;
 }
 /**
  * Get a contextual welcome hint based on current shell state.
  * Returns different messages depending on what's configured.
  */
 export declare function getWelcomeHint(state: ShellState): string;
+/**
+ * Get contextual quick tips for the info box.
+ * Returns an array of {cmd, text} tuples adapted to the user's state.
+ */
+export declare function getQuickTips(state: ShellState): QuickTip[];
 /**
  * Get a helpful hint when user types an unknown slash command.
  * Uses prefix matching and basic edit-distance to suggest close matches.

package/dist/lib/shell-hints.js

@@ -1,6 +1,12 @@
 /**
  * Contextual UX hints for the Orbit CLI shell.
  * Shows the right hint at the right time — not spam, not silence.
+ *
+ * The hints adapt to the user's current state:
+ * - Not authenticated → explain what Orbit CLI does + how to connect
+ * - Authenticated, no site → guide to link a site
+ * - Fully configured → show operational commands
+ * - Session active → show session commands
  */
 import { SLASH_COMMANDS } from './shell-render.js';
 /**
@@ -9,16 +15,68 @@ import { SLASH_COMMANDS } from './shell-render.js';
  */
 export function getWelcomeHint(state) {
     if (!state.hasToken) {
-        return 'Non sei autenticato. Esegui /auth per accedere con il browser, oppure /login <token>.';
+        return 'Orbit CLI gestisce i tuoi siti da terminale. Esegui /auth per collegare il tuo account Orbit.';
     }
-    if (!state.hasSite) {
-        return 'Nessun sito collegato. Esegui /sites per vedere i siti disponibili.';
+    if (!state.hasSite && !state.hasManifest) {
+        return 'Autenticato. Collega un sito con /sites oppure inizializza il progetto locale con orbit init.';
     }
     if (state.hasSession) {
         return 'Sessione attiva — usa /note per annotare, o scrivi in linguaggio naturale per parlare con Orbit AI.';
     }
+    if (state.hasManifest) {
+        return 'Progetto rilevato — /context per i dettagli, /session start per lavorare, o premi Tab per completare.';
+    }
     return 'Digita /help per i comandi, /session start per iniziare a lavorare, o premi Tab per completare.';
 }
+/**
+ * Get contextual quick tips for the info box.
+ * Returns an array of {cmd, text} tuples adapted to the user's state.
+ */
+export function getQuickTips(state) {
+    // State 1: Not authenticated — explain what Orbit CLI does
+    if (!state.hasToken) {
+        return [
+            { cmd: 'Orbit CLI', text: 'gestisci siti, sessioni e interventi da terminale' },
+            { cmd: '/auth', text: 'collegare il tuo account Orbit (apre il browser)' },
+            { cmd: '/login <token>', text: 'oppure incolla un token MCP direttamente' },
+            { cmd: '/help', text: 'lista completa dei comandi' },
+        ];
+    }
+    // State 2: Authenticated but no site linked
+    if (!state.hasSite && !state.hasManifest) {
+        return [
+            { cmd: '/sites', text: 'seleziona un sito da gestire' },
+            { cmd: '/link <id>', text: 'collega questa directory a un sito Orbit' },
+            { cmd: 'orbit init', text: 'inizializza un progetto locale (.orbit/project.json)' },
+            { cmd: '/doctor', text: 'verifica connessione e configurazione' },
+        ];
+    }
+    // State 3: Session active — show session commands
+    if (state.hasSession) {
+        return [
+            { cmd: '/note <testo>', text: 'annota cosa stai facendo' },
+            { cmd: '/report', text: 'invia un report a Orbit' },
+            { cmd: '/session end', text: 'chiudi la sessione di lavoro' },
+            { cmd: 'testo libero', text: 'scrivi in linguaggio naturale per parlare con AI' },
+        ];
+    }
+    // State 4: Fully configured, with manifest
+    if (state.hasManifest) {
+        return [
+            { cmd: '/context', text: 'mostra contesto progetto e ambiente' },
+            { cmd: '/session start', text: 'inizia una sessione di lavoro' },
+            { cmd: '/status', text: 'panoramica completa' },
+            { cmd: 'testo libero', text: 'scrivi in linguaggio naturale per parlare con AI' },
+        ];
+    }
+    // State 5: Fully configured, no manifest
+    return [
+        { cmd: '/session start', text: 'inizia una sessione di lavoro' },
+        { cmd: '/status', text: 'panoramica completa' },
+        { cmd: '/doctor', text: 'verifica connessione e configurazione' },
+        { cmd: 'testo libero', text: 'scrivi in linguaggio naturale per parlare con AI' },
+    ];
+}
 /**
  * Get a helpful hint when user types an unknown slash command.
  * Uses prefix matching and basic edit-distance to suggest close matches.

package/dist/lib/shell-hints.js.map

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

package/dist/lib/shell-ink.js

@@ -39,12 +39,13 @@ export async function startInkShell(version) {
     const cwd = process.cwd();
     const store = new OrbitStore(defaultStoreIO);
     await store.init(cwd);
-    const { tokenEntry, siteLink, session } = store.getState();
+    const { tokenEntry, siteLink, session, manifest } = store.getState();
     // Welcome hint
     const welcomeHint = getWelcomeHint({
         hasToken: !!tokenEntry,
         hasSite: !!siteLink,
         hasSession: !!session,
+        hasManifest: !!manifest,
     });
     console.log(`  ${DIM(welcomeHint)}`);
     console.log('');