@semiont/core 0.3.3 → 0.3.5

package/README.md

@@ -15,6 +15,20 @@ Core types and domain logic for the Semiont semantic knowledge platform. This pa
 - ✅ **Backend** (`apps/backend`) - Server implementation, imports types from core
 - ✅ **Packages** - Other monorepo packages that need OpenAPI types or EventBus
 - ✅ **Internal Utilities** - Type generation, validation, domain logic
+- ✅ **Frontend / Browser** - Types and pure utilities (main barrel is browser-safe)
+
+## Who Should Use `@semiont/core/node` Instead
+
+Node.js-specific exports live in the `/node` subpath:
+
+```typescript
+import { SemiontProject, loadEnvironmentConfig } from '@semiont/core/node';
+```
+
+- **`SemiontProject`** — represents a project on the filesystem; resolves XDG directories, reads/writes files. Not usable in a browser.
+- **`loadEnvironmentConfig`** — loads `~/.semiontconfig` + `.semiont/config` using `fs`/`os`/`path`. Not usable in a browser.
+
+**Rule**: If your code runs in a browser or edge runtime, use `@semiont/core`. If it runs in Node.js and needs filesystem access, use `@semiont/core/node`.
 
 ## Who Should Use `@semiont/api-client` Instead
 

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

@@ -0,0 +1,56 @@
+import { E as EnvironmentConfig } from '../config.types-Cas714K0.js';
+
+/**
+ * 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)
+ *   dataDir    — projectRoot/         (representations store root; representations/ is 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}/
+ *   projectionsDir — stateDir/projections/
+ *   jobsDir        — stateDir/jobs/
+ *   runtimeDir     — $XDG_RUNTIME_DIR/semiont/{name}/  (or $TMPDIR fallback)
+ */
+declare class SemiontProject {
+    readonly root: string;
+    readonly name: string;
+    readonly eventsDir: string;
+    readonly dataDir: string;
+    readonly configDir: string;
+    readonly dataHome: string;
+    readonly stateDir: string;
+    readonly projectionsDir: string;
+    readonly jobsDir: string;
+    readonly runtimeDir: string;
+    constructor(projectRoot: string, name?: string);
+    /**
+     * Delete all ephemeral state for this project (stateDir + runtimeDir).
+     * Does not touch eventsDir or dataDir.
+     */
+    destroy(): Promise<void>;
+    /**
+     * 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.
+ *
+ * Reads ~/.semiontconfig (global) merged with .semiont/config (project-local),
+ * then selects the given environment overlay.
+ *
+ * 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`.
+ */
+declare function loadEnvironmentConfig(projectRoot: string, environment: string): EnvironmentConfig;
+
+export { SemiontProject, loadEnvironmentConfig };

package/dist/config/node-config-loader.js

@@ -0,0 +1,300 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { parse } from 'smol-toml';
+
+// src/config/node-config-loader.ts
+function deepMerge(base, override) {
+  const result = { ...base };
+  for (const key of Object.keys(override)) {
+    const b = base[key];
+    const o = override[key];
+    if (o !== void 0 && o !== null && typeof o === "object" && !Array.isArray(o) && b !== void 0 && b !== null && typeof b === "object" && !Array.isArray(b)) {
+      result[key] = deepMerge(b, o);
+    } else if (o !== void 0) {
+      result[key] = o;
+    }
+  }
+  return result;
+}
+function resolveEnvVars(obj, env) {
+  if (typeof obj === "string") {
+    return obj.replace(/\$\{([^}]+)\}/g, (match, varName) => {
+      if (env[varName] === void 0) {
+        throw new Error(`Environment variable ${varName} is not set (referenced in config as ${match})`);
+      }
+      return env[varName];
+    });
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => resolveEnvVars(item, env));
+  }
+  if (obj !== null && typeof obj === "object") {
+    const resolved = {};
+    for (const key in obj) {
+      resolved[key] = resolveEnvVars(obj[key], env);
+    }
+    return resolved;
+  }
+  return obj;
+}
+function requirePlatform(value, serviceName) {
+  if (!value) {
+    throw new Error(`platform is required for service '${serviceName}' \u2014 add 'platform = "posix"|"container"|"external"' to its config section`);
+  }
+  return value;
+}
+function loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env) {
+  const projectConfigContent = reader.readIfExists(`${projectRoot}/.semiont/config`);
+  let projectName = "semiont-project";
+  let projectSite;
+  let projectEnvSection = {};
+  if (projectConfigContent) {
+    const projectConfig = parse(projectConfigContent);
+    projectName = projectConfig.project?.name ?? projectName;
+    projectSite = projectConfig.site;
+    projectEnvSection = projectConfig.environments?.[environment] ?? {};
+  }
+  const globalContent = reader.readIfExists(globalConfigPath);
+  const raw = globalContent ? parse(globalContent) : {};
+  const userEnvSection = raw.environments?.[environment] ?? {};
+  const envSection = deepMerge(
+    projectEnvSection,
+    userEnvSection
+  );
+  const resolved = resolveEnvVars(envSection, env);
+  const flatInference = resolved.inference;
+  const makeMeaningSection = resolved["make-meaning"];
+  const workersSection = resolved.workers ?? {};
+  const actorsSection = resolved.actors ?? {};
+  const defaultWorkerInference = workersSection["default"]?.inference;
+  const defaultMakeMeaningInference = makeMeaningSection?.default?.inference;
+  function mergeWithFlatInference(specific) {
+    if (!flatInference) return specific;
+    return {
+      apiKey: flatInference.apiKey,
+      maxTokens: flatInference.maxTokens,
+      endpoint: flatInference.endpoint,
+      baseURL: flatInference.baseURL,
+      ...specific
+    };
+  }
+  function resolveActorInference(fromMakeMeaning, fromActors) {
+    const base = fromMakeMeaning ?? fromActors ?? defaultMakeMeaningInference;
+    if (!base) return void 0;
+    return mergeWithFlatInference(base);
+  }
+  const actors = {};
+  const gathererInference = resolveActorInference(
+    makeMeaningSection?.actors?.gatherer?.inference,
+    actorsSection["gatherer"]?.inference
+  );
+  if (gathererInference) actors.gatherer = gathererInference;
+  const matcherInference = resolveActorInference(
+    makeMeaningSection?.actors?.matcher?.inference,
+    actorsSection["matcher"]?.inference
+  );
+  if (matcherInference) actors.matcher = matcherInference;
+  const workers = {};
+  const workerTypes = ["reference-annotation", "highlight-annotation", "assessment-annotation", "comment-annotation", "tag-annotation", "generation"];
+  if (defaultWorkerInference) {
+    workers.default = mergeWithFlatInference(defaultWorkerInference);
+  }
+  for (const wt of workerTypes) {
+    const specific = workersSection[wt]?.inference;
+    if (specific) {
+      workers[wt] = mergeWithFlatInference(specific);
+    }
+  }
+  const backend = resolved.backend;
+  const site = resolved.site ?? projectSite;
+  const inferenceSection = resolved.inference;
+  let inferenceProviders;
+  if (inferenceSection) {
+    inferenceProviders = {};
+    if (inferenceSection.type === "anthropic") {
+      inferenceProviders.anthropic = {
+        platform: requirePlatform(inferenceSection.platform, "inference"),
+        endpoint: inferenceSection.endpoint ?? "https://api.anthropic.com",
+        apiKey: inferenceSection.apiKey ?? ""
+      };
+    } else if (inferenceSection.type === "ollama") {
+      inferenceProviders.ollama = {
+        platform: { type: requirePlatform(inferenceSection.platform, "inference") },
+        baseURL: inferenceSection.baseURL,
+        port: inferenceSection.baseURL ? void 0 : 11434
+      };
+    }
+  }
+  const topLevelWorkers = {};
+  for (const [name, w] of Object.entries(workersSection)) {
+    if (w.inference) {
+      topLevelWorkers[name] = { inference: { type: w.inference.type, model: w.inference.model } };
+    }
+  }
+  const topLevelActors = {};
+  for (const [name, a] of Object.entries(actorsSection)) {
+    if (a.inference) {
+      topLevelActors[name] = { inference: { type: a.inference.type, model: a.inference.model } };
+    }
+  }
+  if (makeMeaningSection?.actors?.gatherer?.inference) {
+    topLevelActors["gatherer"] = { inference: { type: makeMeaningSection.actors.gatherer.inference.type, model: makeMeaningSection.actors.gatherer.inference.model } };
+  }
+  if (makeMeaningSection?.actors?.matcher?.inference) {
+    topLevelActors["matcher"] = { inference: { type: makeMeaningSection.actors.matcher.inference.type, model: makeMeaningSection.actors.matcher.inference.model } };
+  }
+  const frontend = resolved.frontend;
+  const proxy = resolved.proxy;
+  const config = {
+    services: {
+      backend: backend ? {
+        platform: { type: requirePlatform(backend.platform, "backend") },
+        port: backend.port ?? 4e3,
+        publicURL: backend.publicURL ?? `http://localhost:${backend.port ?? 4e3}`,
+        corsOrigin: backend.corsOrigin ?? backend.frontendURL ?? "http://localhost:3000"
+      } : void 0,
+      frontend: frontend ? {
+        platform: { type: requirePlatform(frontend.platform, "frontend") },
+        port: frontend.port ?? 3e3,
+        siteName: site?.siteName ?? "Semiont",
+        publicURL: frontend.publicURL
+      } : void 0,
+      proxy: proxy ? {
+        platform: { type: requirePlatform(proxy.platform, "proxy") },
+        type: "envoy",
+        port: proxy.port ?? 8080,
+        adminPort: proxy.adminPort ?? 9901,
+        backendPort: backend?.port ?? 4e3,
+        frontendPort: frontend?.port ?? 3e3
+      } : void 0,
+      graph: resolved.graph ? {
+        ...resolved.graph,
+        platform: { type: requirePlatform(resolved.graph.platform, "graph") },
+        type: resolved.graph.type ?? "neo4j"
+      } : makeMeaningSection?.graph,
+      database: resolved.database ? {
+        platform: { type: requirePlatform(resolved.database.platform, "database") },
+        type: "postgres",
+        image: resolved.database.image,
+        host: resolved.database.host ?? "localhost",
+        port: resolved.database.port ?? 5432,
+        name: resolved.database.name,
+        user: resolved.database.user,
+        password: resolved.database.password
+      } : void 0
+    },
+    ...inferenceProviders ? { inference: inferenceProviders } : {},
+    ...Object.keys(topLevelWorkers).length > 0 ? { workers: topLevelWorkers } : {},
+    ...Object.keys(topLevelActors).length > 0 ? { actors: topLevelActors } : {},
+    site: site ? {
+      domain: site.domain ?? "localhost",
+      siteName: site.siteName,
+      adminEmail: site.adminEmail,
+      oauthAllowedDomains: site.oauthAllowedDomains
+    } : void 0,
+    logLevel: resolved.logLevel,
+    _metadata: {
+      environment,
+      projectRoot,
+      projectName,
+      ...Object.keys(actors).length > 0 ? { actors } : {},
+      ...Object.keys(workers).length > 0 ? { workers } : {}
+    }
+  };
+  return config;
+}
+function createTomlConfigLoader(reader, globalConfigPath, env) {
+  return (projectRoot, environment) => {
+    return loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env);
+  };
+}
+var SemiontProject = class _SemiontProject {
+  root;
+  name;
+  // Durable
+  eventsDir;
+  dataDir;
+  // Ephemeral — config (generated config files for managed processes)
+  configDir;
+  // Ephemeral — data (persistent user data managed by semiont)
+  dataHome;
+  // Ephemeral — state
+  stateDir;
+  projectionsDir;
+  jobsDir;
+  // Ephemeral — runtime
+  runtimeDir;
+  constructor(projectRoot, name) {
+    this.root = projectRoot;
+    if (name !== void 0) {
+      const configPath = path.join(projectRoot, ".semiont", "config");
+      if (!fs.existsSync(configPath)) {
+        fs.mkdirSync(path.join(projectRoot, ".semiont"), { recursive: true });
+        fs.writeFileSync(configPath, `[project]
+name = "${name}"
+`);
+      }
+    }
+    this.name = _SemiontProject.readName(projectRoot);
+    this.eventsDir = path.join(projectRoot, ".semiont", "events");
+    this.dataDir = projectRoot;
+    const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
+    this.configDir = path.join(xdgConfig, "semiont", this.name);
+    const xdgData = process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share");
+    this.dataHome = path.join(xdgData, "semiont", this.name);
+    const xdgState = process.env.XDG_STATE_HOME || path.join(os.homedir(), ".local", "state");
+    this.stateDir = path.join(xdgState, "semiont", this.name);
+    this.projectionsDir = path.join(this.stateDir, "projections");
+    this.jobsDir = path.join(this.stateDir, "jobs");
+    const xdgRuntime = process.env.XDG_RUNTIME_DIR;
+    const runtimeBase = xdgRuntime ?? process.env.TMPDIR ?? "/tmp";
+    this.runtimeDir = path.join(runtimeBase, "semiont", this.name);
+  }
+  /**
+   * Delete all ephemeral state for this project (stateDir + runtimeDir).
+   * Does not touch eventsDir or dataDir.
+   */
+  async destroy() {
+    await Promise.all([
+      fs.promises.rm(this.configDir, { recursive: true, force: true }),
+      fs.promises.rm(this.stateDir, { recursive: true, force: true }),
+      fs.promises.rm(this.runtimeDir, { recursive: true, force: true })
+    ]);
+  }
+  /**
+   * Read the project name from .semiont/config [project] name = "..."
+   * Falls back to the directory basename if the config is absent or has no name.
+   */
+  static readName(projectRoot) {
+    const configPath = path.join(projectRoot, ".semiont", "config");
+    if (fs.existsSync(configPath)) {
+      const content = fs.readFileSync(configPath, "utf-8");
+      for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("name") && trimmed.includes("=")) {
+          const [, ...rest] = trimmed.split("=");
+          return rest.join("=").trim().replace(/^"(.*)"$/, "$1");
+        }
+      }
+    }
+    return path.basename(projectRoot);
+  }
+};
+
+// src/config/node-config-loader.ts
+var nodeTomlFileReader = {
+  readIfExists: (filePath) => fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : null
+};
+function loadEnvironmentConfig(projectRoot, environment) {
+  const globalConfigPath = path.join(os.homedir(), ".semiontconfig");
+  return createTomlConfigLoader(
+    nodeTomlFileReader,
+    globalConfigPath,
+    process.env
+  )(projectRoot, environment);
+}
+
+export { SemiontProject, loadEnvironmentConfig };
+//# sourceMappingURL=node-config-loader.js.map
+//# sourceMappingURL=node-config-loader.js.map

package/dist/config/node-config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/toml-loader.ts","../../src/project.ts","../../src/config/node-config-loader.ts"],"names":["parseToml","fs2","path2","os2"],"mappings":"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","file":"node-config-loader.js","sourcesContent":["/**\n * TOML Config Loader\n *\n * Reads ~/.semiontconfig (TOML) and .semiont/config (TOML) and produces\n * an EnvironmentConfig for the requested environment.\n *\n * File format: see TOML-XDG-CONFIG.md\n *\n * Loading sequence:\n *   1. Read .semiont/config  → projectName, site, environments.<env>.* (project base)\n *   2. Read ~/.semiontconfig → defaults, environments.<env>.* (user overrides)\n *   3. Deep-merge: project base ← user overrides (user wins on conflicts)\n *      Any environment name is valid (local, staging, production, custom, ...)\n *   4. Resolve ${VAR} references from process.env\n *   5. Apply inheritance: workers.<name> → workers.default → error\n *   6. Map to EnvironmentConfig shape\n */\n\nimport { parse as parseToml } from 'smol-toml';\nimport type { EnvironmentConfig, OllamaProviderConfig, AnthropicProviderConfig } from './config.types';\nimport type { PlatformType } from './config.types';\n\n/**\n * Deep merge two plain objects. Arrays and primitives in `override` replace those in `base`.\n * Nested objects are merged recursively. `override` takes precedence on conflicts.\n */\nfunction deepMerge<T extends Record<string, unknown>>(base: T, override: Partial<T>): T {\n  const result = { ...base } as Record<string, unknown>;\n  for (const key of Object.keys(override)) {\n    const b = base[key];\n    const o = override[key];\n    if (o !== undefined && o !== null && typeof o === 'object' && !Array.isArray(o) &&\n        b !== undefined && b !== null && typeof b === 'object' && !Array.isArray(b)) {\n      result[key] = deepMerge(b as Record<string, unknown>, o as Record<string, unknown>);\n    } else if (o !== undefined) {\n      result[key] = o;\n    }\n  }\n  return result as T;\n}\n\nfunction resolveEnvVars(obj: unknown, env: Record<string, string | undefined>): unknown {\n  if (typeof obj === 'string') {\n    return obj.replace(/\\$\\{([^}]+)\\}/g, (match, varName) => {\n      if (env[varName] === undefined) {\n        throw new Error(`Environment variable ${varName} is not set (referenced in config as ${match})`);\n      }\n      return env[varName] as string;\n    });\n  }\n  if (Array.isArray(obj)) {\n    return obj.map(item => resolveEnvVars(item, env));\n  }\n  if (obj !== null && typeof obj === 'object') {\n    const resolved: Record<string, unknown> = {};\n    for (const key in obj as Record<string, unknown>) {\n      resolved[key] = resolveEnvVars((obj as Record<string, unknown>)[key], env);\n    }\n    return resolved;\n  }\n  return obj;\n}\n\n// ── Inference config types (mirrored from packages/make-meaning/src/config.ts) ─\n// Kept here to avoid a circular dependency: core cannot import make-meaning.\n\nexport interface InferenceConfig {\n  type: 'anthropic' | 'ollama';\n  model: string;\n  maxTokens?: number;\n  apiKey?: string;\n  endpoint?: string;\n  baseURL?: string;\n}\n\nexport interface ActorInferenceConfig {\n  gatherer?: InferenceConfig;\n  matcher?: InferenceConfig;\n}\n\nexport interface WorkerInferenceConfig {\n  default?: InferenceConfig;\n  'reference-annotation'?: InferenceConfig;\n  'highlight-annotation'?: InferenceConfig;\n  'assessment-annotation'?: InferenceConfig;\n  'comment-annotation'?: InferenceConfig;\n  'tag-annotation'?: InferenceConfig;\n  'generation'?: InferenceConfig;\n}\n\n// ── Types for ~/.semiontconfig ────────────────────────────────────────────────\n\ninterface SemiontConfigFile {\n  user?: {\n    name?: string;\n    email?: string;\n  };\n  defaults?: {\n    environment?: string;\n    platform?: string;\n  };\n  environments?: Record<string, EnvironmentSection>;\n}\n\ninterface GraphSection {\n  platform?: string;\n  type?: string;\n  name?: string;\n  uri?: string;\n  username?: string;\n  password?: string;\n  database?: string;\n  [key: string]: unknown;\n}\n\ninterface InferenceFlatSection {\n  type?: 'anthropic' | 'ollama';\n  platform?: string;\n  model?: string;\n  maxTokens?: number;\n  apiKey?: string;\n  endpoint?: string;\n  baseURL?: string;\n}\n\ninterface EnvironmentSection {\n  backend?: {\n    platform?: string;\n    port?: number;\n    publicURL?: string;\n    frontendURL?: string;\n    corsOrigin?: string;\n  };\n  frontend?: {\n    platform?: string;\n    port?: number;\n    publicURL?: string;\n  };\n  proxy?: {\n    platform?: string;\n    port?: number;\n    adminPort?: number;\n    publicURL?: string;\n  };\n  site?: {\n    domain?: string;\n    siteName?: string;\n    adminEmail?: string;\n    oauthAllowedDomains?: string[];\n    enableLocalAuth?: boolean;\n  };\n  database?: {\n    platform?: string;\n    image?: string;\n    host?: string;\n    port?: number;\n    name?: string;\n    user?: string;\n    password?: string;\n  };\n  graph?: GraphSection;\n  inference?: InferenceFlatSection;\n  'make-meaning'?: {\n    graph?: Record<string, unknown>;\n    actors?: {\n      gatherer?: { inference?: InferenceConfig };\n      matcher?: { inference?: InferenceConfig };\n    };\n    default?: { inference?: InferenceConfig };\n  };\n  workers?: Record<string, { inference?: InferenceConfig }>;\n  actors?: Record<string, { inference?: InferenceConfig }>;\n  logLevel?: 'error' | 'warn' | 'info' | 'http' | 'debug';\n}\n\n// ── File reader abstraction (same pattern as createConfigLoader) ──────────────\n\nexport type TomlFileReader = {\n  readIfExists: (path: string) => string | null;\n};\n\nfunction requirePlatform(value: string | undefined, serviceName: string): PlatformType {\n  if (!value) {\n    throw new Error(`platform is required for service '${serviceName}' — add 'platform = \"posix\"|\"container\"|\"external\"' to its config section`);\n  }\n  return value as PlatformType;\n}\n\n// ── Main loader function ──────────────────────────────────────────────────────\n\n/**\n * Parse ~/.semiontconfig and .semiont/config and return EnvironmentConfig.\n *\n * @param projectRoot - Path to the project root (contains .semiont/config)\n * @param environment - Environment name (e.g. 'local', 'production')\n * @param globalConfigPath - Path to ~/.semiontconfig (caller resolves ~ expansion)\n * @param reader - File reader abstraction\n * @param env - Environment variables for ${VAR} resolution\n */\nexport function loadTomlConfig(\n  projectRoot: string,\n  environment: string,\n  globalConfigPath: string,\n  reader: TomlFileReader,\n  env: Record<string, string | undefined>\n): EnvironmentConfig {\n  // 1. Read project config from .semiont/config\n  const projectConfigContent = reader.readIfExists(`${projectRoot}/.semiont/config`);\n  let projectName = 'semiont-project';\n  let projectSite: EnvironmentSection['site'] | undefined;\n  let projectEnvSection: EnvironmentSection = {};\n  if (projectConfigContent) {\n    const projectConfig = parseToml(projectConfigContent) as {\n      project?: { name?: string };\n      site?: EnvironmentSection['site'];\n      environments?: Record<string, EnvironmentSection>;\n    };\n    projectName = projectConfig.project?.name ?? projectName;\n    projectSite = projectConfig.site;\n    projectEnvSection = projectConfig.environments?.[environment] ?? {};\n  }\n\n  // 2. Read global config (optional — missing config yields empty environments)\n  const globalContent = reader.readIfExists(globalConfigPath);\n  const raw = globalContent ? (parseToml(globalContent) as SemiontConfigFile) : ({} as SemiontConfigFile);\n\n  // 3. Deep-merge: project base + user overrides (user wins on conflicts)\n  const userEnvSection: EnvironmentSection = raw.environments?.[environment] ?? {};\n  const envSection: EnvironmentSection = deepMerge(\n    projectEnvSection as Record<string, unknown>,\n    userEnvSection as Record<string, unknown>\n  ) as EnvironmentSection;\n\n  // 4. Resolve ${VAR} references\n  const resolved = resolveEnvVars(envSection, env) as EnvironmentSection;\n\n  // 5. Build make-meaning actor/worker inference config with inheritance\n  // The flat [inference] section provides defaults (apiKey, maxTokens, endpoint/baseURL).\n  // Actor/worker sections only need to specify type and model; missing fields fall back\n  // to the flat inference section.\n  const flatInference = resolved.inference;\n  const makeMeaningSection = resolved['make-meaning'];\n  const workersSection = resolved.workers ?? {};\n  const actorsSection = resolved.actors ?? {};\n  const defaultWorkerInference = workersSection['default']?.inference;\n  const defaultMakeMeaningInference = makeMeaningSection?.default?.inference;\n\n  function mergeWithFlatInference(specific: InferenceConfig): InferenceConfig {\n    if (!flatInference) return specific;\n    return {\n      apiKey: flatInference.apiKey,\n      maxTokens: flatInference.maxTokens,\n      endpoint: flatInference.endpoint,\n      baseURL: flatInference.baseURL,\n      ...specific,\n    };\n  }\n\n  function resolveActorInference(fromMakeMeaning?: InferenceConfig, fromActors?: InferenceConfig): InferenceConfig | undefined {\n    const base = fromMakeMeaning ?? fromActors ?? defaultMakeMeaningInference;\n    if (!base) return undefined;\n    return mergeWithFlatInference(base);\n  }\n\n  const actors: ActorInferenceConfig = {};\n  const gathererInference = resolveActorInference(\n    makeMeaningSection?.actors?.gatherer?.inference,\n    actorsSection['gatherer']?.inference\n  );\n  if (gathererInference) actors.gatherer = gathererInference;\n\n  const matcherInference = resolveActorInference(\n    makeMeaningSection?.actors?.matcher?.inference,\n    actorsSection['matcher']?.inference\n  );\n  if (matcherInference) actors.matcher = matcherInference;\n\n  const workers: WorkerInferenceConfig = {};\n  const workerTypes = ['reference-annotation', 'highlight-annotation', 'assessment-annotation', 'comment-annotation', 'tag-annotation', 'generation'] as const;\n  if (defaultWorkerInference) {\n    workers.default = mergeWithFlatInference(defaultWorkerInference);\n  }\n  for (const wt of workerTypes) {\n    const specific = workersSection[wt]?.inference;\n    if (specific) {\n      (workers as Record<string, InferenceConfig>)[wt] = mergeWithFlatInference(specific);\n    }\n  }\n\n  // 6. Map to EnvironmentConfig\n  const backend = resolved.backend;\n  const site = resolved.site ?? projectSite;\n  const inferenceSection = resolved.inference;\n\n  // Build inference providers config\n  // Supports flat format: [environments.local.inference] with type = \"anthropic\"|\"ollama\"\n  let inferenceProviders: EnvironmentConfig['inference'] | undefined;\n  if (inferenceSection) {\n    inferenceProviders = {};\n    if (inferenceSection.type === 'anthropic') {\n      inferenceProviders.anthropic = {\n        platform: requirePlatform(inferenceSection.platform, 'inference'),\n        endpoint: inferenceSection.endpoint ?? 'https://api.anthropic.com',\n        apiKey: inferenceSection.apiKey ?? '',\n      } as AnthropicProviderConfig;\n    } else if (inferenceSection.type === 'ollama') {\n      inferenceProviders.ollama = {\n        platform: { type: requirePlatform(inferenceSection.platform, 'inference') },\n        baseURL: inferenceSection.baseURL,\n        port: inferenceSection.baseURL ? undefined : 11434,\n      } as OllamaProviderConfig;\n    }\n  }\n\n  // Build top-level workers/actors maps for EnvironmentConfig\n  const topLevelWorkers: EnvironmentConfig['workers'] = {};\n  for (const [name, w] of Object.entries(workersSection)) {\n    if (w.inference) {\n      topLevelWorkers[name] = { inference: { type: w.inference.type, model: w.inference.model } };\n    }\n  }\n  const topLevelActors: EnvironmentConfig['actors'] = {};\n  for (const [name, a] of Object.entries(actorsSection)) {\n    if (a.inference) {\n      topLevelActors[name] = { inference: { type: a.inference.type, model: a.inference.model } };\n    }\n  }\n  // Also include make-meaning actors\n  if (makeMeaningSection?.actors?.gatherer?.inference) {\n    topLevelActors['gatherer'] = { inference: { type: makeMeaningSection.actors.gatherer.inference.type, model: makeMeaningSection.actors.gatherer.inference.model } };\n  }\n  if (makeMeaningSection?.actors?.matcher?.inference) {\n    topLevelActors['matcher'] = { inference: { type: makeMeaningSection.actors.matcher.inference.type, model: makeMeaningSection.actors.matcher.inference.model } };\n  }\n\n  const frontend = resolved.frontend;\n  const proxy = resolved.proxy;\n\n  const config: EnvironmentConfig = {\n    services: {\n      backend: backend ? {\n        platform: { type: requirePlatform(backend.platform, 'backend') },\n        port: backend.port ?? 4000,\n        publicURL: backend.publicURL ?? `http://localhost:${backend.port ?? 4000}`,\n        corsOrigin: backend.corsOrigin ?? backend.frontendURL ?? 'http://localhost:3000',\n      } : undefined,\n      frontend: frontend ? {\n        platform: { type: requirePlatform(frontend.platform, 'frontend') },\n        port: frontend.port ?? 3000,\n        siteName: site?.siteName ?? 'Semiont',\n        publicURL: frontend.publicURL,\n      } : undefined,\n      proxy: proxy ? {\n        platform: { type: requirePlatform(proxy.platform, 'proxy') },\n        type: 'envoy',\n        port: proxy.port ?? 8080,\n        adminPort: proxy.adminPort ?? 9901,\n        backendPort: backend?.port ?? 4000,\n        frontendPort: frontend?.port ?? 3000,\n      } : undefined,\n      graph: resolved.graph ? {\n        ...resolved.graph,\n        platform: { type: requirePlatform(resolved.graph.platform as string | undefined, 'graph') },\n        type: (resolved.graph.type ?? 'neo4j') as import('./config.types').GraphDatabaseType,\n      } as EnvironmentConfig['services']['graph'] : (makeMeaningSection?.graph as EnvironmentConfig['services']['graph']),\n      database: resolved.database ? {\n        platform: { type: requirePlatform(resolved.database.platform, 'database') },\n        type: 'postgres',\n        image: resolved.database.image,\n        host: resolved.database.host ?? 'localhost',\n        port: resolved.database.port ?? 5432,\n        name: resolved.database.name,\n        user: resolved.database.user,\n        password: resolved.database.password,\n      } as EnvironmentConfig['services']['database'] : undefined,\n    },\n    ...(inferenceProviders ? { inference: inferenceProviders } : {}),\n    ...(Object.keys(topLevelWorkers).length > 0 ? { workers: topLevelWorkers } : {}),\n    ...(Object.keys(topLevelActors).length > 0 ? { actors: topLevelActors } : {}),\n    site: site ? {\n      domain: site.domain ?? 'localhost',\n      siteName: site.siteName,\n      adminEmail: site.adminEmail,\n      oauthAllowedDomains: site.oauthAllowedDomains as [string, ...string[]] | undefined,\n    } : undefined,\n    logLevel: resolved.logLevel,\n    _metadata: {\n      environment,\n      projectRoot,\n      projectName,\n      ...(Object.keys(actors).length > 0 ? { actors } : {}),\n      ...(Object.keys(workers).length > 0 ? { workers } : {}),\n    },\n  };\n\n  return config;\n}\n\n/**\n * Create a TOML config loader backed by a file reader.\n * Drop-in replacement for createConfigLoader that reads TOML instead of JSON.\n * The caller must resolve globalConfigPath (e.g. expand '~' using process.env.HOME).\n */\nexport function createTomlConfigLoader(\n  reader: TomlFileReader,\n  globalConfigPath: string,\n  env: Record<string, string | undefined>\n) {\n  return (projectRoot: string, environment: string): EnvironmentConfig => {\n    return loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env);\n  };\n}\n","import * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\n\n/**\n * Represents a Semiont project rooted at a given directory.\n *\n * Computes all paths — durable and ephemeral — once at construction time.\n * XDG environment variables are read here and nowhere else.\n *\n * Durable paths (inside the project root, committed or repo-local):\n *   eventsDir  — .semiont/events/     (system of record, committed)\n *   dataDir    — projectRoot/         (representations store root; representations/ is committed)\n *\n * Ephemeral paths (outside the project root, never committed):\n *   configDir      — $XDG_CONFIG_HOME/semiont/{name}/  (generated config for managed processes)\n *   dataHome       — $XDG_DATA_HOME/semiont/{name}/   (persistent user data, e.g. database files)\n *   stateDir       — $XDG_STATE_HOME/semiont/{name}/\n *   projectionsDir — stateDir/projections/\n *   jobsDir        — stateDir/jobs/\n *   runtimeDir     — $XDG_RUNTIME_DIR/semiont/{name}/  (or $TMPDIR fallback)\n */\nexport class SemiontProject {\n  readonly root: string;\n  readonly name: string;\n\n  // Durable\n  readonly eventsDir: string;\n  readonly dataDir: string;\n\n  // Ephemeral — config (generated config files for managed processes)\n  readonly configDir: string;\n\n  // Ephemeral — data (persistent user data managed by semiont)\n  readonly dataHome: string;\n\n  // Ephemeral — state\n  readonly stateDir: string;\n  readonly projectionsDir: string;\n  readonly jobsDir: string;\n\n  // Ephemeral — runtime\n  readonly runtimeDir: string;\n\n  constructor(projectRoot: string, name?: string) {\n    this.root = projectRoot;\n    if (name !== undefined) {\n      const configPath = path.join(projectRoot, '.semiont', 'config');\n      if (!fs.existsSync(configPath)) {\n        fs.mkdirSync(path.join(projectRoot, '.semiont'), { recursive: true });\n        fs.writeFileSync(configPath, `[project]\\nname = \"${name}\"\\n`);\n      }\n    }\n    this.name = SemiontProject.readName(projectRoot);\n\n    this.eventsDir = path.join(projectRoot, '.semiont', 'events');\n    this.dataDir = projectRoot;\n\n    const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');\n    this.configDir = path.join(xdgConfig, 'semiont', this.name);\n\n    const xdgData = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');\n    this.dataHome = path.join(xdgData, 'semiont', this.name);\n\n    const xdgState = process.env.XDG_STATE_HOME || path.join(os.homedir(), '.local', 'state');\n    this.stateDir = path.join(xdgState, 'semiont', this.name);\n    this.projectionsDir = path.join(this.stateDir, 'projections');\n    this.jobsDir = path.join(this.stateDir, 'jobs');\n\n    const xdgRuntime = process.env.XDG_RUNTIME_DIR;\n    const runtimeBase = xdgRuntime ?? process.env.TMPDIR ?? '/tmp';\n    this.runtimeDir = path.join(runtimeBase, 'semiont', this.name);\n  }\n\n  /**\n   * Delete all ephemeral state for this project (stateDir + runtimeDir).\n   * Does not touch eventsDir or dataDir.\n   */\n  async destroy(): Promise<void> {\n    await Promise.all([\n      fs.promises.rm(this.configDir, { recursive: true, force: true }),\n      fs.promises.rm(this.stateDir, { recursive: true, force: true }),\n      fs.promises.rm(this.runtimeDir, { recursive: true, force: true }),\n    ]);\n  }\n\n  /**\n   * Read the project name from .semiont/config [project] name = \"...\"\n   * Falls back to the directory basename if the config is absent or has no name.\n   */\n  private static readName(projectRoot: string): string {\n    const configPath = path.join(projectRoot, '.semiont', 'config');\n    if (fs.existsSync(configPath)) {\n      const content = fs.readFileSync(configPath, 'utf-8');\n      for (const line of content.split('\\n')) {\n        const trimmed = line.trim();\n        if (trimmed.startsWith('name') && trimmed.includes('=')) {\n          const [, ...rest] = trimmed.split('=');\n          return rest.join('=').trim().replace(/^\"(.*)\"$/, '$1');\n        }\n      }\n    }\n    return path.basename(projectRoot);\n  }\n}\n","import * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\nimport { createTomlConfigLoader } from './toml-loader.js';\nimport type { EnvironmentConfig } from './config.types.js';\n\nexport { SemiontProject } from '../project.js';\n\nconst nodeTomlFileReader = {\n  readIfExists: (filePath: string): string | null =>\n    fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf-8') : null,\n};\n\n/**\n * Load semiont environment config for a Node.js process.\n *\n * Reads ~/.semiontconfig (global) merged with .semiont/config (project-local),\n * then selects the given environment overlay.\n *\n * This is the canonical config loader for any Node.js process. SEMIONT_ENV\n * should be read once at the process entry point and passed as `environment`.\n */\nexport function loadEnvironmentConfig(\n  projectRoot: string,\n  environment: string\n): EnvironmentConfig {\n  const globalConfigPath = path.join(os.homedir(), '.semiontconfig');\n  return createTomlConfigLoader(\n    nodeTomlFileReader,\n    globalConfigPath,\n    process.env\n  )(projectRoot, environment);\n}\n"]}