fix(codex): auto-submit mention and restore prompt draft (#8)

Reviewed-on: https://codeberg.org/yaadata/codex.nvim/pulls/8
Co-authored-by: Yadi Abdalhalim <abdalhalim.yaadata@gmail.com>
Co-committed-by: Yadi Abdalhalim <abdalhalim.yaadata@gmail.com>

Author: yaadata

README.md

@@ -37,6 +37,7 @@ require("codex").setup({
   args = {},
   env = {},
   auto_start = false,
+  log_level = "warn",
   terminal = {
     provider = "auto", -- auto | snacks | native
     window = "vsplit", -- vsplit | hsplit | float
@@ -113,11 +114,14 @@ require("codex").setup({
   - paths are normalized to be relative to the current working directory
   - paths are auto-quoted/escaped when they contain whitespace or
     shell-significant characters
-  - payload is inserted via bracketed paste and is not auto-submitted
+  - command is auto-submitted immediately
+  - codex.nvim clears the current prompt line, inserts `/mention`, submits it,
+    then re-applies previously typed prompt text (best effort)
+  - if prompt text cannot be captured from the terminal buffer, mention still
+    submits and prior input is not restored
   - if the terminal is still starting, payloads are queued and retried until
     ready (or until `terminal.startup.timeout_ms` elapses)
-  - after sending, codex.nvim focuses the Codex terminal in insert mode; press
-    Enter to submit
+  - after sending, codex.nvim focuses the Codex terminal in insert mode
 - `:CodexResume[!]` resumes a session
   - with an active Codex session, sends `/resume` in-process
   - without an active session, launches `codex resume` (or `codex resume --last`

docs/contributing.md

@@ -200,6 +200,17 @@ Use EmmyLua annotations for all public functions and types:
 function M.example(name, count) end
 ```
 
+Document every function (public and private) with a one-line summary placed
+before `---@param`/`---@return` tags:
+
+```lua
+---Returns whether the active session is alive.
+---@param session codex.Session|nil
+---@param provider codex.Provider
+---@return boolean
+local function session_is_alive(session, provider) end
+```
+
 Define shared types with `---@class` and `---@alias` in `lua/codex/types.lua`.
 Module-local types (like `codex.SelectionSpec`) can be defined in the module
 that owns them.
@@ -337,8 +348,9 @@ When cutting a new release tag:
 
 ## Adding a New Command
 
-1. **API function** -- Add the public method in `lua/codex/init.lua` with
-   `---@param`/`---@return` annotations and an `ensure_setup()` guard.
+1. **API function** -- Add the public method in `lua/codex/init.lua` with a
+   one-line LuaDoc summary (description first), `---@param`/`---@return`
+   annotations, and an `ensure_setup()` guard.
 2. **User command** -- Register the `:Codex*` command in
    `lua/codex/nvim/commands.lua`, delegating to the API function.
 3. **Unit tests** -- Add test cases in `tests/unit/init_spec.lua` covering the