feat(glua_doc_cli): add --gmod-annotations flag for parity with glua_check

[AmyJeanes]

Motivation

glua_check already accepts --gmod-annotations <dir> to load the GMod annotation set as a library workspace, independent of workspace.library. glua_doc_cli had no equivalent, so the only way to feed it the annotations was to list them on workspace.library — which double-loads them (the LSP reads gmod.annotationsPath too) and orders them against a project's own .luatypes overrides.

Without the annotations loaded this way, a return inherited from a GMod global (e.g. a method returning Vector) resolves to unknown in the generated type model.

Change

Add --gmod-annotations <path> to glua_doc_cli, mirroring glua_check:

• New gmod_annotations: Option<PathBuf> field on CmdArgs.
• load_workspace gains the same parameter and the same load block — add_library_workspace(path) + WorkspaceFolder::new(path, true) — registering the directory as a library workspace exactly as glua_check does. The block is copied verbatim from glua_check's init.rs.
• run_doc_cli threads cmd_args.gmod_annotations through.

When the flag is absent it is a complete no-op, so existing callers are unaffected.

Testing

Verified against a real GMod addon workspace: with the flag, glua_doc_cli's JSON type model resolves the same returns glua_check does (previously unknown), and the output is byte-identical to loading the annotations via workspace.library. cargo fmt / clippy -p glua_doc_cli clean.

🤖 Generated with Claude Code

Greptile Summary

The PR adds a --gmod-annotations option and prioritizes the selected directory through the shared Emmy configuration helper.

• Adds the annotation-directory CLI argument.
• Threads it into workspace initialization.
• Validates that the supplied path is a directory and prioritizes it among configured libraries.

Confidence Score: 4/5

The PR should not merge until equivalent annotation-directory paths preserve the existing library configuration and its ignore rules.

The new prioritization path can insert an unrestricted duplicate ahead of a configured annotation library when the same directory has different textual path spellings, causing ignored files to enter the generated documentation model.

Files Needing Attention: crates/glua_doc_cli/src/init.rs

Important Files Changed

Filename	Overview
crates/glua_doc_cli/src/cmd_args.rs	Adds the optional path-valued --gmod-annotations argument.
crates/glua_doc_cli/src/init.rs	Validates and prioritizes the annotation directory, but alternate spellings of an already configured directory can discard its ignore configuration through load priority.
crates/glua_doc_cli/src/lib.rs	Passes the parsed annotation path into workspace initialization.

_{Reviews (2): Last reviewed commit: "refactor(glua_doc_cli): mirror glua_chec..." | Re-trigger Greptile}

Greptile also left 1 inline comment on this PR.

[Pollux12]

Thanks for the PR!