Skip to content

🧹 Janitor: Refactor YAML frontmatter delimiter to use FRONTMATTER_DELIMITER constant - #294

Open
matta wants to merge 1 commit into
mainfrom
janitor-frontmatter-delimiter-8273171995898991543
Open

🧹 Janitor: Refactor YAML frontmatter delimiter to use FRONTMATTER_DELIMITER constant#294
matta wants to merge 1 commit into
mainfrom
janitor-frontmatter-delimiter-8273171995898991543

Conversation

@matta

@matta matta commented Mar 15, 2026

Copy link
Copy Markdown
Owner

🧹 Janitor: Refactor YAML frontmatter delimiter to use new FRONTMATTER_DELIMITER constant

📉 Diff: +8 lines, -8 lines
🎯 Goal: Extract constants for semantically identical literals.
💡 Before: The magic string "---" was hardcoded in graph.rs, models.rs, and parser.rs for both generating and parsing Markdown files with YAML frontmatter.
✨ After: Added pub const FRONTMATTER_DELIMITER: &str = "---"; to models.rs. Replaced hardcoded usages with the single source of truth, removing duplication and reducing potential bugs in future refactors.
✅ Verification: Ran just check and just test. Tests pass and behavior remains identical.


PR created automatically by Jules for task 8273171995898991543 started by @matta

Extract the YAML frontmatter delimiter magic string ("---") into a shared `FRONTMATTER_DELIMITER` constant in `models.rs` and apply it to `graph.rs`, `models.rs`, and `parser.rs`.

This acts as a single source of truth for generating and parsing task files.

Co-authored-by: matta <37314+matta@users.noreply.github.com>
@google-labs-jules

Copy link
Copy Markdown
Contributor

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@trunk-io

trunk-io Bot commented Mar 15, 2026

Copy link
Copy Markdown
Contributor

Merging to main in this repository is managed by Trunk.

  • To merge this pull request, check the box to the left or comment /trunk merge below.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request refactors the codebase to improve maintainability and reduce the risk of errors by replacing a hardcoded string literal with a dedicated constant. The change centralizes the definition of the YAML frontmatter delimiter, ensuring consistency across different parts of the application that interact with task file parsing and generation.

Highlights

  • Introduced FRONTMATTER_DELIMITER constant: Replaced the hardcoded "---" string with a new FRONTMATTER_DELIMITER constant in graph.rs, models.rs, and parser.rs to centralize the definition of the YAML frontmatter delimiter.
  • Improved code maintainability: This refactoring eliminates magic strings, reduces duplication, and minimizes potential bugs during future modifications by establishing a single source of truth for the delimiter.
Changelog
  • crates/pebble/src/graph.rs
    • Imported FRONTMATTER_DELIMITER from crate::models.
    • Updated the content.starts_with check to use FRONTMATTER_DELIMITER instead of the literal "---".
  • crates/pebble/src/models.rs
    • Added a new public constant FRONTMATTER_DELIMITER with the value "---".
    • Modified TaskNode::to_string to use FRONTMATTER_DELIMITER when stripping prefixes and formatting the output string.
  • crates/pebble/src/parser.rs
    • Imported FRONTMATTER_DELIMITER from crate::models.
    • Updated parse_task_file to use FRONTMATTER_DELIMITER for checking the start and end of YAML frontmatter and in error messages.
Activity
  • PR was automatically created by Jules for task 8273171995898991543, initiated by @matta.
  • Verification steps included running just check and just test, both of which passed, confirming identical behavior.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request is a good refactoring that replaces the hardcoded YAML frontmatter delimiter "---" with a shared constant, FRONTMATTER_DELIMITER. This improves maintainability and consistency across the codebase. The changes are applied correctly across parsing, generation, and file checking logic. I have one suggestion to improve performance by avoiding an unnecessary string allocation.

Comment on lines +334 to 336
if let Some(stripped) = yaml_payload.strip_prefix(&format!("{}\n", FRONTMATTER_DELIMITER)) {
yaml_payload = stripped.to_string();
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Using format! here creates a new String on the heap for every call, which is an unnecessary allocation. You can achieve the same result more efficiently by chaining strip_prefix calls using and_then to avoid this allocation.

Suggested change
if let Some(stripped) = yaml_payload.strip_prefix(&format!("{}\n", FRONTMATTER_DELIMITER)) {
yaml_payload = stripped.to_string();
}
if let Some(stripped) = yaml_payload.strip_prefix(FRONTMATTER_DELIMITER).and_then(|s| s.strip_prefix("\n")) {
yaml_payload = stripped.to_string();
}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant