Function loadWorkspaceFromDirectory

packages/foam-cli/src/support/filesystem.ts:128–196

(
  workspaceDir: string,
  options: LoadWorkspaceOptions & {
    /**
     * Optional watcher to keep the in-memory graph in sync with on-disk
     * changes. Used by long-running consumers (e.g. the MCP server). One-shot
     * commands (most CLI subcommands) leave this undefined and read a snapshot.
     */
    watcher?: IWatcher;
  } = {}
)

}

export async function loadWorkspaceFromDirectory(
  workspaceDir: string,
  options: LoadWorkspaceOptions & {
    /**
     * Optional watcher to keep the in-memory graph in sync with on-disk
     * changes. Used by long-running consumers (e.g. the MCP server). One-shot
     * commands (most CLI subcommands) leave this undefined and read a snapshot.
     */
    watcher?: IWatcher;
  } = {}
) {
  const rootDir = path.resolve(workspaceDir);
  const rootUri = URI.file(rootDir);

  // Cascade: workspace settings beat built-in defaults. The fallback must be
  // a fully-resolved config so every getter has a final answer. User-level
  // and env-level cascade layers don't exist today; the only env-driven
  // config is the telemetry opt-out, which is read directly in resolveCliReporter.
  const workspaceSource = readFoamConfig(rootDir);
  const foamConfig = cascadeFoamConfig(
    [workspaceSource],
    new DefaultFoamConfig()
  );
  Config.setDefaultConfig(foamConfig);

  const matcher = new GlobMatcher(
    Config.getFilesInclude(),
    Config.getFilesExclude(),
    rootUri
  );

  const dataStore = new NodeFileDataStore(
    rootDir,
    [
      ...new Set(
        (options.excludedPaths ?? []).map(excludedPath =>
          path.resolve(excludedPath)
        )
      ),
    ],
    matcher
  );

  const noteExtensions = options.noteExtensions ?? Config.getNotesExtensions();
  const parser = createMarkdownParser();
  const providers = [
    new MarkdownResourceProvider(dataStore, parser, noteExtensions),
    new AttachmentResourceProvider(Config.getAttachmentExtensions()),
  ];

  const foam = await bootstrap(
    [rootUri],
    matcher,
    options.watcher,
    dataStore,
    parser,
    providers,
    Config.getDefaultNoteExtension(),