@orbitpanel/cli 1.2.1 → 1.3.1

package/dist/lib/context-guard.js.map

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

package/dist/lib/context-health.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Context Trust Model for @orbitpanel/cli.
+ *
+ * Evaluates the consistency and trustworthiness of the project context
+ * by comparing data from multiple sources:
+ * - manifest (.orbit/project.json)
+ * - legacy (.orbit.json)
+ * - runtime detection (URL heuristics)
+ *
+ * PRINCIPLE: "Paranoico ma utile"
+ * - Never block the user
+ * - Always show where data comes from
+ * - Warn when sources disagree
+ * - Escalate to critical when multiple warnings stack up
+ */
+import type { ProjectManifest, SiteLink, ContextHealth, AttributedContext } from '../types.js';
+export interface BuildContextInput {
+    manifest: ProjectManifest | null;
+    siteLink: SiteLink | null;
+    runtimeUrl: string | undefined;
+}
+/**
+ * Build an attributed context — every field knows its source.
+ * Priority: manifest > legacy > runtime > default
+ */
+export declare function buildAttributedContext(input: BuildContextInput): AttributedContext;
+export interface EvaluateInput {
+    manifest: ProjectManifest | null;
+    siteLink: SiteLink | null;
+    runtimeUrl: string | undefined;
+    manifestLegacy: boolean;
+}
+/**
+ * Evaluate the consistency of the project context.
+ * Returns an overall health level and a list of specific issues.
+ */
+export declare function evaluateContextHealth(input: EvaluateInput): ContextHealth;

package/dist/lib/context-health.js

@@ -0,0 +1,162 @@
+/**
+ * Context Trust Model for @orbitpanel/cli.
+ *
+ * Evaluates the consistency and trustworthiness of the project context
+ * by comparing data from multiple sources:
+ * - manifest (.orbit/project.json)
+ * - legacy (.orbit.json)
+ * - runtime detection (URL heuristics)
+ *
+ * PRINCIPLE: "Paranoico ma utile"
+ * - Never block the user
+ * - Always show where data comes from
+ * - Warn when sources disagree
+ * - Escalate to critical when multiple warnings stack up
+ */
+import { detectEnvironmentFromUrl } from './environment.js';
+// ─── Constants ────────────────────────────────────────────────────
+const LEVEL_ORDER = {
+    ok: 0,
+    info: 1,
+    warning: 2,
+    critical: 3,
+};
+/** Number of warnings that escalate to critical */
+const CRITICAL_WARNING_THRESHOLD = 2;
+/**
+ * Build an attributed context — every field knows its source.
+ * Priority: manifest > legacy > runtime > default
+ */
+export function buildAttributedContext(input) {
+    const { manifest, siteLink } = input;
+    // Project name
+    let projectName = null;
+    if (manifest?.name) {
+        projectName = { value: manifest.name, source: 'manifest' };
+    }
+    else if (siteLink?.name) {
+        projectName = { value: siteLink.name, source: 'legacy' };
+    }
+    // Environment
+    let environment = null;
+    if (manifest?.environment) {
+        environment = { value: manifest.environment, source: 'manifest' };
+    }
+    else if (siteLink?.environment) {
+        environment = { value: siteLink.environment, source: 'legacy' };
+    }
+    // Site ID
+    let siteId = null;
+    if (manifest?.linkedSiteId) {
+        siteId = { value: manifest.linkedSiteId, source: 'manifest' };
+    }
+    else if (siteLink?.orbit_site_id) {
+        siteId = { value: siteLink.orbit_site_id, source: 'legacy' };
+    }
+    // Platform
+    let platform = null;
+    if (manifest?.platform) {
+        platform = { value: manifest.platform, source: 'manifest' };
+    }
+    else if (siteLink?.platform) {
+        platform = { value: siteLink.platform, source: 'legacy' };
+    }
+    return { projectName, environment, siteId, platform };
+}
+/**
+ * Evaluate the consistency of the project context.
+ * Returns an overall health level and a list of specific issues.
+ */
+export function evaluateContextHealth(input) {
+    const { manifest, siteLink, runtimeUrl, manifestLegacy } = input;
+    const issues = [];
+    // ── Rule 1: Legacy format in use ──
+    if (manifestLegacy && manifest) {
+        issues.push({
+            level: 'info',
+            field: 'format',
+            message: 'Manifest caricato da formato legacy .orbit.json — esegui `orbit init` per aggiornare',
+        });
+    }
+    // ── Rule 2: Legacy present but no manifest ──
+    if (!manifest && siteLink) {
+        issues.push({
+            level: 'info',
+            field: 'format',
+            message: 'Solo .orbit.json legacy presente — considera `orbit init` per il nuovo formato',
+        });
+    }
+    // ── Rule 3: Environment mismatch (manifest vs runtime URL) ──
+    if (manifest && runtimeUrl) {
+        const detected = detectEnvironmentFromUrl(runtimeUrl);
+        if (detected !== null && detected !== manifest.environment) {
+            issues.push({
+                level: 'warning',
+                field: 'environment',
+                message: `Ambiente incoerente: manifest=${manifest.environment}, rilevato=${detected}`,
+                detail: {
+                    sources: [
+                        { source: 'manifest', value: manifest.environment },
+                        { source: 'runtime', value: detected },
+                    ],
+                },
+            });
+        }
+    }
+    // ── Rule 4: Site ID mismatch (manifest vs legacy) ──
+    if (manifest?.linkedSiteId && siteLink?.orbit_site_id) {
+        if (manifest.linkedSiteId !== siteLink.orbit_site_id) {
+            issues.push({
+                level: 'warning',
+                field: 'siteId',
+                message: `Site ID divergente: manifest=${manifest.linkedSiteId}, legacy=${siteLink.orbit_site_id}`,
+                detail: {
+                    sources: [
+                        { source: 'manifest', value: manifest.linkedSiteId },
+                        { source: 'legacy', value: siteLink.orbit_site_id },
+                    ],
+                },
+            });
+        }
+    }
+    // ── Rule 5: Platform mismatch (manifest vs legacy) ──
+    if (manifest?.platform && siteLink?.platform) {
+        if (manifest.platform !== siteLink.platform) {
+            issues.push({
+                level: 'warning',
+                field: 'platform',
+                message: `Piattaforma divergente: manifest=${manifest.platform}, legacy=${siteLink.platform}`,
+                detail: {
+                    sources: [
+                        { source: 'manifest', value: manifest.platform },
+                        { source: 'legacy', value: siteLink.platform },
+                    ],
+                },
+            });
+        }
+    }
+    // ── Compute overall level ──
+    const level = computeOverallLevel(issues);
+    return { level, issues };
+}
+/**
+ * Compute the overall health level from a list of issues.
+ * Multiple warnings escalate to critical.
+ */
+function computeOverallLevel(issues) {
+    if (issues.length === 0)
+        return 'ok';
+    const warningCount = issues.filter(i => i.level === 'warning').length;
+    // Multiple warnings → critical
+    if (warningCount >= CRITICAL_WARNING_THRESHOLD)
+        return 'critical';
+    // Otherwise, worst individual level
+    let worst = 'ok';
+    for (const issue of issues) {
+        if (LEVEL_ORDER[issue.level] > LEVEL_ORDER[worst]) {
+            worst = issue.level;
+        }
+    }
+    return worst;
+}
+//# sourceMappingURL=context-health.js.map

package/dist/lib/context-health.js.map

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

package/dist/lib/environment.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+import type { ProjectManifest, EnvironmentType, EnvironmentCheck } from '../types.js';
+/**
+ * Detect environment from a URL using conservative heuristics.
+ * Returns null if detection is ambiguous (no false positives).
+ */
+export declare function detectEnvironmentFromUrl(url: string | undefined | null): EnvironmentType | null;
+/**
+ * Check for environment mismatch between manifest and detected environment.
+ * Only reports mismatch when detection is confident (non-null).
+ */
+export declare function checkEnvironmentMismatch(manifest: ProjectManifest, url?: string): EnvironmentCheck;

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;