Neorg dirman: Auto‑creation of missing workspace directories during setup

Direct answers

1. No, Neorg does not automatically create missing workspace directories or index.norg files during neorg.setup(). The dirman module validates that configured paths exist but performs no filesystem creation.
2. There is no configuration flag or setting in dirman (as of Neorg v8/v9) that enables automatic creation of missing workspace directories or index files during setup.
3. Recommended recovery sequence after an upgrade that leaves workspace mappings pointing to non‑existent paths:
   1. Run :Neorg dirman workspaces to list configured workspaces and confirm which ones show as missing.
   2. If the upgrade changed the expected workspace root location, update the dirman.workspaces table in your Neorg config to point to the new paths before creating anything.
   3. For each missing workspace, run :Neorg dirman create-workspace <name> (where <name> matches the key in dirman.workspaces exactly, case‑sensitive). This creates the directory and an empty index.norg file.
   4. Run :Neorg dirman index <workspace> to rebuild the workspace index.

Why this happens

The dirman module treats workspace paths as user‑managed locations. During setup() it only registers the mappings; it never calls vim.fn.mkdir() or writes index.norg. If an upgrade (or a config change) leaves a mapping pointing to a path that doesn’t exist, dirman emits an error but continues loading. Subsequent commands like :Neorg dirman index fail because the directory and/or index file are absent.

Verification steps (run in Neovim with your config loaded)

1. :Neorg dirman workspaces – shows each workspace, its path, and whether the directory exists.
2. :Neorg dirman index <missing-workspace> – confirms the “directory or index.norg missing” error.
3. :Neorg dirman create-workspace <missing-workspace> – creates the directory and index.norg at the configured path.
4. Repeat step 3 for every missing workspace, then run :Neorg dirman index <workspace> again to verify.

Cautions

• create-workspace on an already‑valid workspace will error; verify the path is truly missing first.
• Manually creating the directory without an index.norg file still causes index to fail; the file must exist (can be empty initially).
• There is no bulk‑create command; each missing workspace must be addressed individually.
• Workspace names are case‑sensitive and must match the key in dirman.workspaces exactly.

One diagnostic detail that could change the recommendation

Did the upgrade also change the root directory where workspaces are expected to live (e.g., ~/neorg → ~/.local/share/neorg)? If yes, update dirman.workspaces in your config before running create-workspace; otherwise the command will recreate the old (wrong) paths.