ppkarwasz opened a new pull request, #37: URL: https://github.com/apache/comdev/pull/37
## Summary - Add a `mode` parameter (`'emails' | 'threads'`) to `search_list`. In threads mode the tool renders one entry per thread (top-level `thread_struct` nodes joined against the email summaries by `mid`), showing the root message's subject, sender, date, ID, and total reply count. This lets consumers such as Apache Magpie retrieve only thread heads when triaging security reports. - Thread starters whose subject begins with `Re:` or whose root carries `In-Reply-To` are annotated as possible continuations of an earlier thread: threading only spans the queried timespan, so replies to older messages appear as thread starters. The annotation is a hint, never a filter, as neither signal is reliable. - Extract a `Mail` class into `mail.js` owning the email record schema and its Markdown formatting, with unit tests in `mail.test.js`. The class exposes `mid` alone: the API's `id` field is a response-time alias of `mid` and is ignored. - Deprecate the `emails_only` parameter (accepted but ignored): it never changed the rendered output apart from a misleading `Threads: 0` header. The backend optimization it toggled (`emailsOnly=1`) is now applied automatically whenever threads mode is not requested. - Clarify the `id` parameter descriptions (a mid/permalink or a Message-ID) and share the pagination footer between the email and thread listings. - Bump the version to 1.1.0 (semver: new `mode` parameter, `emails_only` deprecated as a no-op) and read the MCP server version from `package.json` instead of a second hardcoded copy. ## Test plan - `npm test`: 63/63 pass (new `mail.test.js` covers schema extraction, date fallback, continuation heuristics, formatting, thread descendant counting). - Verified live against lists.apache.org (`[email protected]`, 2026-07): 35 rendered thread heads match the reported thread count, continuation hints fire on `Re:` heads and on subject-edited replies via `In-Reply-To`, `emails_only: true` renders identically to the default listing, and `mode: "threads"` overrides `quick`. 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
