Skip to content

PolicyVault/templates

Repository files navigation

PolicyVault Policy Templates

A collection of reusable policy templates for PolicyVault. These templates provide a starting point for defining work-item–based policies that can be imported directly into PolicyVault.

Overview

Policies in this repository are based on work item queries — they use the native query language of the underlying issue-tracking platform to select a set of work items, and then enforce conditions (thresholds, field checks, SLA rules, etc.) against those items.

Currently supported platforms

Platform Type Folder
Azure DevOps Work Item Query Language (WIQL) azure-devops/

Planned future platforms

  • GitHub Issues — filter-based policies using GitHub's issue search syntax
  • Atlassian Jira — JQL (Jira Query Language) based policies

Each template is designed to be copied, customised, and then imported into a PolicyVault instance.

YAML schema and IntelliSense

This repository includes a local JSON schema for template entries:

  • Schema file: schemas/template-catalog-entry.schema.json
  • VS Code workspace mapping: .vscode/settings.json (yaml.schemas)

For tools that use yaml-language-server outside VS Code workspace settings, templates include a file-level schema directive:

# yaml-language-server: $schema=../schemas/template-catalog-entry.schema.json

Usage

  1. Browse the platform folder that matches your issue-tracking tool.
  2. Copy the template that best matches your use-case.
  3. Customise the query, thresholds, and metadata fields to fit your requirements.
  4. Import the customised template into PolicyVault.

Release automation

GitHub Actions lints YAML files with yamllint and validates template schema/WIQL rules on every pull request and push to main. Pushes to main also calculate a release version with GitVersion, derive the release tag from GitVersion's majorMinorPatch output so the patch number advances on each new release, create a GitHub release for the tagged repository state, and upload each template YAML file as an explicit release asset for direct programmatic download.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before opening a pull request.

Security

For responsible disclosure of security vulnerabilities, please refer to SECURITY.md.

License

This project is licensed under the MIT License.

About

No description, website, or topics provided.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors