{"record":{"id":"326a45ee2e79052a","repo":"vectordotdev/vector","slug":"invalid-fragment-contents-for-filename-author-names-should","errorCode":null,"errorMessage":"invalid fragment contents for '{filename}': author names should not be prefixed with '@'.","messagePattern":"invalid fragment contents for '(.+?)': author names should not be prefixed with '@'\\.","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"vdev/src/commands/check/changelog_fragments.rs","lineNumber":210,"sourceCode":"    filename: &str,\n    fragment_type: &FragmentType,\n) -> Result<()> {\n    let content = std::fs::read_to_string(path)?;\n    // Match generate_cue.rs, which reads `lines().last()` verbatim: the authors\n    // line must be the last line, no trailing blank lines allowed.\n    let last_line = content.lines().last().unwrap_or(\"\");\n\n    let Some(names) = last_line.strip_prefix(\"authors: \") else {\n        bail!(\n            \"invalid fragment contents for '{filename}': last line must be 'authors: <name> [<name> ...]' (no trailing blank lines).\"\n        );\n    };\n    let names = names.trim();\n    if names.is_empty() {\n        bail!(\"invalid fragment contents for '{filename}': authors line has no names.\");\n    }\n    if names.contains('@') {\n        bail!(\n            \"invalid fragment contents for '{filename}': author names should not be prefixed with '@'.\"\n        );\n    }\n    if names.contains(',') {\n        bail!(\n            \"invalid fragment contents for '{filename}': authors should be space delimited, not comma delimited.\"\n        );\n    }\n    if names.split_whitespace().any(|n| n == TODO_HANDLE) {\n        bail!(\n            \"invalid fragment contents for '{filename}': the scaffolder placeholder '{TODO_HANDLE}' must be replaced with a real GitHub handle.\"\n        );\n    }\n\n    // Reject any scaffolded body placeholder that the author forgot to fill in.\n    // All templates start their placeholder lines with a literal `TODO ` at column 0,\n    // which is rare in real fragment text.\n    if let Some(bad) = content.lines().find(|l| l.starts_with(\"TODO \")) {","sourceCodeStart":192,"sourceCodeEnd":228,"githubUrl":"https://github.com/vectordotdev/vector/blob/bdb87aeaa4c4ff27c0ba643c1c77b21bf2ef4013/vdev/src/commands/check/changelog_fragments.rs#L192-L228","documentation":"Raised by validate_contents while parsing the 'authors:' line, which must be the last line of the fragment. If any author name carries an '@' handle prefix (e.g. '@alice'), the checker rejects it: authors must be plain names, since the release-generation tooling copies them verbatim and '@' characters break downstream formatting.","triggerScenarios":"Running `vdev check changelog-fragments` when the last line is like `authors: @jdoe` — any space-delimited token on the authors line contains '@'.","commonSituations":"Copy-pasting a GitHub mention from an issue or PR into the authors line; habitual social-handle formatting.","solutions":["Strip the `@` prefix from each handle on the authors line.","Use plain handles separated by spaces: `authors: jdoe asmith`.","Search the fragment for '@' before committing."],"exampleFix":"// before\nauthors: @jdoe\n// after\nauthors: jdoe","handlingStrategy":"validation","validationCode":"let names = last.strip_prefix(\"authors: \").unwrap_or(\"\").trim();\nassert!(!names.contains('@'), \"strip '@' from author handles\");","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Write handles without the '@' prefix (use `jdoe`, not `@jdoe`).","Don't paste GitHub mentions directly into the authors line.","Search fragments for '@' before committing."],"tags":["rust","changelog","validation","ci"],"backgroundTag":"invalid-argument-value","analyzedSha":"bdb87aeaa4c4ff27c0ba643c1c77b21bf2ef4013","analyzedAt":"2026-09-16T02:53:35.741Z","contentChangedAt":"2026-09-16T02:53:35.741Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}