Function createServer

packages/server/src/server-factory.ts:226–2516

(options: ServerOptions)

}

export function createServer(options: ServerOptions): ServerInstance {
  const {
    contentDir,
    projectDir = contentDir,
    quiet = true,
    debounce = 2000,
    maxDebounce = 10000,
    gitEnabled = true,
    commitDebounceMs = 30_000,
    wipRef = 'refs/wip/main',
    configHomedirOverride,
    enableTestRoutes = false,
    shadowRepo,
    contentRoot,
    destroyTimeoutMs = 10_000,
    localOpCliArgs,
    skipStateManifestCheck = false,
    singleDocRelPath,
    ephemeral = false,
  } = options;

  const log = getLogger('server');

  function readProjectAttachmentFolderPath(): string {
    const project = readConfigSafely({
      absPath: resolveConfigPath('project', projectDir),
      sideline: false,
      warn: (message) => log.warn({ message }, '[config] could not read project config'),
    });
    if (!project.valid) {
      const attachmentIssues =
        isKnownConfigError(project.error) && project.error.code === 'SCHEMA_INVALID'
          ? (project.error.issues as ConfigIssue[]).filter(
              (issue) => issue.path.map(String).join('.') === 'content.attachmentFolderPath',
            )
          : [];
      if (attachmentIssues.length > 0) {
        const details = attachmentIssues.map((issue) => issue.message).join('; ');
        throw new Error(`Invalid content.attachmentFolderPath in project config: ${details}`);
      }
      log.warn(
        {},
        '[config] committed content.attachmentFolderPath unavailable (project config invalid) — using default attachment placement',
      );
    }
    return project.value.content.attachmentFolderPath ?? DEFAULT_ATTACHMENT_FOLDER_PATH;
  }

  function readProjectAutoSyncEnabled(): boolean {
    const local = readConfigSafely({
      absPath: resolveConfigPath('project-local', projectDir),
      sideline: false,
      warn: (message) => log.warn({ message }, '[config] could not read project-local config'),
    });
    const localEnabled = local.value.autoSync?.enabled;
    if (localEnabled !== null && localEnabled !== undefined) {
      return localEnabled === true;
    }