bugyo-prjmeta 1.0.0

Project metadata plugin for Daimyo - provides .project-metadata.yml content for templates

bugyo-prjmeta

Project metadata plugin for Daimyo - provides .project-metadata.yml content for Jinja2 templates.

Installation

pip install bugyo-prjmeta

Requirements

• Python >= 3.11
• daimyo >= 1.4.0
• pyyaml ~= 6.0

Features

Context Variables

The prjmeta.context plugin provides the following template variable:

Variable	Type	Description
project_metadata	dict	Full contents of .project-metadata.yml in the project root

Configuration

Enable the plugin in your .daimyo/config/settings.toml:

# Enable all project metadata plugins
enabled_plugins = ["prjmeta.*"]

# Or enable the specific context plugin
enabled_plugins = ["prjmeta.context"]

Usage

Template Examples

Conditional Rules Based on Project Metadata

project.language:
  when: Language-specific guidelines
  ruleset:
    - "{% if project_metadata.get('language') == 'python' %}Use uv for dependency management{% endif %}"
    - "{% if project_metadata.get('language') == 'javascript' %}Use npm or yarn for dependency management{% endif %}"

Using Daimyo Scope

The .project-metadata.yml file is used by Claude Code to determine the daimyo rule scope. Its full contents are also available in templates:

project.info:
  when: Project information rules
  ruleset:
    - "{% if project_metadata.get('daimyo', {}).get('scope') %}Rules scope: {{ project_metadata.daimyo.scope }}{% endif %}"
    - "{% if project_metadata.get('team') %}Team: {{ project_metadata.team }}{% endif %}"

Accessing Nested Metadata

project.team:
  when: Team-specific guidelines
  ruleset:
    - "{% set team = project_metadata.get('team', {}) %}"
    - "{% if team.get('timezone') %}Team timezone: {{ team.timezone }}{% endif %}"
    - "{% if team.get('lead') %}Technical lead: {{ team.lead }}{% endif %}"

Availability

The plugin is always available, even when .project-metadata.yml does not exist in the project root. In that case, project_metadata is an empty dict {}.

Security

This plugin reads only .project-metadata.yml from the current working directory. No path traversal is possible - the file path is fixed and cannot be influenced by template authors.

License

MIT License - see LICENSE file for details.

Support

For issues and questions, please visit the Daimyo issue tracker.