@semiont/core 0.5.4 → 0.5.5

package/dist/config/node-config-loader.d.ts

@@ -1,5 +1,615 @@
-import type { EnvironmentConfig } from './config.types.js';
-export { SemiontProject } from '../project.js';
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "PlatformType".
+ */
+type PlatformType = 'posix' | 'container' | 'aws' | 'external';
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "GraphDatabaseType".
+ */
+type GraphDatabaseType = 'neo4j' | 'janusgraph' | 'neptune' | 'memory';
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "GraphServiceConfig".
+ */
+type GraphServiceConfig = {
+    [k: string]: unknown;
+} & {
+    platform: ServicePlatformConfig;
+    type: GraphDatabaseType;
+    name?: string;
+    uri?: string;
+    url?: string;
+    username?: string;
+    password?: string;
+    database?: string;
+    host?: string;
+    port?: number;
+    storage?: string;
+    index?: string;
+    endpoint?: string;
+    region?: string;
+    command?: string;
+    image?: string;
+    janusgraphVersion?: string;
+    javaOptions?: string;
+    heapSize?: string;
+    pageCacheSize?: string;
+    noAuth?: boolean;
+    dataPath?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+};
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "ServicePlatformConfig".
+ */
+interface ServicePlatformConfig {
+    type: PlatformType;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "ResourceRequirements".
+ */
+interface ResourceRequirements {
+    cpu?: string;
+    memory?: string;
+    gpu?: number;
+    gpus?: number;
+    replicas?: number;
+    ephemeralStorage?: string;
+    memoryReservation?: string;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "SecurityRequirements".
+ */
+interface SecurityRequirements {
+    readOnlyRootFilesystem?: boolean;
+    runAsNonRoot?: boolean;
+    runAsUser?: number;
+    runAsGroup?: number;
+    capabilities?: string[] | {
+        add?: string[];
+        drop?: string[];
+        [k: string]: unknown;
+    };
+    privileged?: boolean;
+    allowPrivilegeEscalation?: boolean;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "BuildRequirements".
+ */
+interface BuildRequirements {
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "BackendServiceConfig".
+ */
+interface BackendServiceConfig {
+    platform: ServicePlatformConfig;
+    devMode?: boolean;
+    command?: string;
+    port: number;
+    publicURL: string;
+    corsOrigin: string;
+    image?: string;
+    cpu?: string;
+    memory?: string;
+    databaseUrl?: string;
+    projectRoot?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    redisUrl?: string;
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "FrontendServiceConfig".
+ */
+interface FrontendServiceConfig {
+    platform: ServicePlatformConfig;
+    devMode?: boolean;
+    command?: string;
+    port: number;
+    siteName: string;
+    image?: string;
+    projectRoot?: string;
+    databaseUrl?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+    publicURL?: string;
+    allowedOrigins?: string[];
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "VectorsServiceConfig".
+ */
+interface VectorsServiceConfig {
+    platform?: ServicePlatformConfig;
+    type: 'qdrant' | 'memory';
+    host?: string;
+    port?: number;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "EmbeddingServiceConfig".
+ */
+interface EmbeddingServiceConfig {
+    platform?: ServicePlatformConfig;
+    type: 'voyage' | 'ollama';
+    model: string;
+    apiKey?: string;
+    baseURL?: string;
+    endpoint?: string;
+    chunking?: {
+        chunkSize?: number;
+        overlap?: number;
+        [k: string]: unknown;
+    };
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "DatabaseServiceConfig".
+ */
+interface DatabaseServiceConfig {
+    platform: ServicePlatformConfig;
+    type: string;
+    name?: string;
+    host: string;
+    port: number;
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+    description?: string;
+    command?: string;
+    image?: string;
+    user?: string;
+    username?: string;
+    password?: string;
+    database?: string;
+    /**
+     * Override the default data storage directory ($XDG_DATA_HOME/semiont/{name}/database/{service})
+     */
+    dataDir?: string;
+    storageSize?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "OllamaProviderConfig".
+ */
+interface OllamaProviderConfig {
+    platform: ServicePlatformConfig;
+    baseURL?: string;
+    port?: number;
+    image?: string;
+    command?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "AnthropicProviderConfig".
+ */
+interface AnthropicProviderConfig {
+    platform: 'external';
+    endpoint: string;
+    apiKey: string;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "InferenceProvidersConfig".
+ */
+interface InferenceProvidersConfig {
+    ollama?: OllamaProviderConfig;
+    anthropic?: AnthropicProviderConfig;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "McpServiceConfig".
+ */
+interface McpServiceConfig {
+    platform: ServicePlatformConfig;
+    command?: string;
+    image?: string;
+    port?: number;
+    dependsOn?: string[];
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "ServicesConfig".
+ */
+interface ServicesConfig {
+    backend?: BackendServiceConfig;
+    frontend?: FrontendServiceConfig;
+    database?: DatabaseServiceConfig;
+    graph?: GraphServiceConfig;
+    mcp?: McpServiceConfig;
+    vectors?: VectorsServiceConfig;
+    embedding?: EmbeddingServiceConfig;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "SiteConfig".
+ */
+interface SiteConfig {
+    /**
+     * Display name for the site
+     */
+    siteName?: string;
+    /**
+     * Primary domain for the site
+     */
+    domain: string;
+    /**
+     * Administrator email address
+     */
+    adminEmail?: string;
+    /**
+     * Support email address (optional)
+     */
+    supportEmail?: string;
+    /**
+     * Email domains allowed for OAuth authentication
+     *
+     * @minItems 1
+     */
+    oauthAllowedDomains?: [string, ...string[]];
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "AppConfig".
+ */
+interface AppConfig {
+    features?: {
+        enableAnalytics?: boolean;
+        enableMaintenanceMode?: boolean;
+        enableDebugLogging?: boolean;
+    };
+    security?: {
+        /**
+         * Session timeout in seconds
+         */
+        sessionTimeout?: number;
+        /**
+         * Maximum failed login attempts before lockout
+         */
+        maxLoginAttempts?: number;
+        corsAllowedOrigins?: string[];
+        /**
+         * Enable local username/password authentication
+         */
+        enableLocalAuth?: boolean;
+        /**
+         * JWT signing secret (base64 encoded, 32+ bytes)
+         */
+        jwtSecret?: string;
+    };
+    performance?: {
+        enableCaching?: boolean;
+        /**
+         * Cache timeout in seconds
+         */
+        cacheTimeout?: number;
+        /**
+         * Maximum request size (e.g., '10mb')
+         */
+        maxRequestSize?: string;
+    };
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "EnvironmentConfig".
+ */
+interface EnvironmentConfig {
+    /**
+     * Optional comment for documentation
+     */
+    _comment?: string;
+    _metadata?: {
+        environment: string;
+        projectRoot: string | null;
+        [k: string]: unknown;
+    };
+    /**
+     * Environment name
+     */
+    name?: string;
+    platform?: {
+        default?: PlatformType;
+        [k: string]: unknown;
+    };
+    services: ServicesConfig;
+    inference?: InferenceProvidersConfig;
+    workers?: {
+        [k: string]: {
+            inference?: {
+                type?: string;
+                model?: string;
+                [k: string]: unknown;
+            };
+            [k: string]: unknown;
+        };
+    };
+    actors?: {
+        [k: string]: {
+            inference?: {
+                type?: string;
+                model?: string;
+                [k: string]: unknown;
+            };
+            [k: string]: unknown;
+        };
+    };
+    site?: SiteConfig;
+    app?: AppConfig;
+    env?: {
+        NODE_ENV?: 'development' | 'production' | 'test';
+        [k: string]: unknown;
+    };
+    /**
+     * Logging verbosity level
+     */
+    logLevel?: 'error' | 'warn' | 'info' | 'http' | 'debug';
+    deployment?: {
+        imageTagStrategy?: 'mutable' | 'immutable' | 'git-hash';
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+
+/**
+ * Represents a Semiont project rooted at a given directory.
+ *
+ * Computes all paths — durable and ephemeral — once at construction time.
+ * XDG environment variables are read here and nowhere else.
+ *
+ * Durable paths (inside the project root, committed or repo-local):
+ *   eventsDir          — .semiont/events/      (system of record, committed)
+ *   representationsDir — representations/      (content store, committed)
+ *
+ * Ephemeral paths (outside the project root, never committed):
+ *   configDir      — $XDG_CONFIG_HOME/semiont/{name}/  (generated config for managed processes)
+ *   dataHome       — $XDG_DATA_HOME/semiont/{name}/   (persistent user data, e.g. database files)
+ *   stateDir        — $XDG_STATE_HOME/semiont/{name}/
+ *   embeddingsDir   — stateDir/embeddings/
+ *   projectionsDir  — stateDir/projections/
+ *   jobsDir         — stateDir/jobs/
+ *   backendLogsDir      — stateDir/backend/
+ *   backendAppLogFile   — backendLogsDir/app.log
+ *   backendErrorLogFile — backendLogsDir/error.log
+ *   runtimeDir      — $XDG_RUNTIME_DIR/semiont/{name}/  (or $TMPDIR fallback)
+ *   backendPidFile  — runtimeDir/backend.pid
+ *
+ * Note: frontend paths are NOT project-scoped. The frontend service is bundled
+ * with the CLI and uses fixed XDG paths keyed by "frontend", not project name.
+ * See apps/cli/src/platforms/posix/handlers/frontend-paths.ts.
+ */
+declare class SemiontProject {
+    readonly root: string;
+    readonly name: string;
+    /** True if [git] sync = true in .semiont/config. When true, semiont stages
+     *  working-tree and event-log changes in the git index automatically. */
+    readonly gitSync: boolean;
+    readonly eventsDir: string;
+    readonly representationsDir: string;
+    readonly configDir: string;
+    readonly dataHome: string;
+    readonly stateDir: string;
+    readonly embeddingsDir: string;
+    readonly projectionsDir: string;
+    readonly jobsDir: string;
+    readonly backendLogsDir: string;
+    readonly backendAppLogFile: string;
+    readonly backendErrorLogFile: string;
+    readonly runtimeDir: string;
+    readonly backendPidFile: string;
+    constructor(projectRoot: string, name?: string);
+    /**
+     * Read the current git branch for the project root.
+     * Returns null if the project is not a git repo or git is not available.
+     */
+    gitBranch(): string | null;
+    /**
+     * Delete all ephemeral state for this project (stateDir + runtimeDir).
+     * Does not touch eventsDir or dataDir.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Read [git] sync from .semiont/config.
+     * Defaults to false if the section or key is absent.
+     */
+    private static readGitSync;
+    /**
+     * Read the project name from .semiont/config [project] name = "..."
+     * Falls back to the directory basename if the config is absent or has no name.
+     */
+    private static readName;
+}
+
 /**
  * Load semiont environment config for a Node.js process.
  *
@@ -9,5 +619,6 @@ export { SemiontProject } from '../project.js';
  * This is the canonical config loader for any Node.js process. SEMIONT_ENV
  * should be read once at the process entry point and passed as `environment`.
  */
-export declare function loadEnvironmentConfig(projectRoot: string, environment: string): EnvironmentConfig;
-//# sourceMappingURL=node-config-loader.d.ts.map
+declare function loadEnvironmentConfig(projectRoot: string, environment: string): EnvironmentConfig;
+
+export { SemiontProject, loadEnvironmentConfig };