diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..d83f832 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,68 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our +community a harassment-free experience for everyone, regardless of age, body +size, visible or invisible disability, ethnicity, sex characteristics, gender +identity and expression, level of experience, education, socio-economic status, +nationality, personal appearance, race, religion, or sexual identity and +orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, +diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our +community include: + +- Demonstrating empathy and kindness toward other people +- Being respectful of differing opinions, viewpoints, and experiences +- Giving and gracefully accepting constructive feedback +- Accepting responsibility and apologizing to those affected by our mistakes, + and learning from the experience +- Focusing on what is best not just for us as individuals, but for the overall + community + +Examples of unacceptable behavior include: + +- The use of sexualized language or imagery, and sexual attention or advances of + any kind +- Trolling, insulting or derogatory comments, and personal or political attacks +- Public or private harassment +- Publishing others' private information, such as a physical or email address, + without their explicit permission +- Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of +acceptable behavior and will take appropriate and fair corrective action in +response to any behavior that they deem inappropriate, threatening, offensive, +or harmful. + +## Scope + +This Code of Conduct applies within all community spaces, and also applies when +an individual is officially representing the community in public spaces. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported to the maintainers via +[GitHub private vulnerability reporting](https://github.com/bkd-dotcom/umbra-precommit/security/advisories/new) +or by opening a confidential issue. All complaints will be reviewed and +investigated promptly and fairly. + +All community leaders are obligated to respect the privacy and security of the +reporter of any incident. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], +version 2.1, available at +. + +[homepage]: https://www.contributor-covenant.org diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..43cae44 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,24 @@ +# Contributing to umbra-precommit + +Thanks for contributing! This is an **integration** for the Umbra platform — a thin +adapter that governs a coding agent through the [`umbra-core`](https://github.com/bkd-dotcom/umbra-core) +admission pipeline. It never reimplements governance policy. + +## Good contributions + +- Fixes / improvements to the guard, hook, MCP wiring, or setup docs for this + integration. +- Better install ergonomics, examples, or troubleshooting. + +## Ground rules + +- **Governance logic stays in `umbra-core`** — this repo adapts an agent to it, + nothing more. Depend on a pinned `umbra-core` (`>=0.5.0`). +- **Never auto-merge.** `auto_merge` is always false; a human merges. +- Fail closed on the hard gate; a soft guard may fail open only with a loud + `INACTIVE`. +- Be kind — see [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). Report security issues via + [private advisory](https://github.com/bkd-dotcom/umbra-precommit/security/advisories/new), not a + public issue. + +New to Umbra? Start at the [umbrella overview](https://github.com/bkd-dotcom/umbra-umbrella). diff --git a/README.md b/README.md index 8022f62..94b0f6d 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,7 @@ **Govern coding-agent changes at the git boundary — pre-commit, pre-push, or CI.** +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) The universal, editor-agnostic guard for [umbra-core](https://github.com/bkd-dotcom/umbra-core): a deterministic pre-action check that blocks changes falling outside your repo's `.umbra/admission.yaml` scope, before they're committed or pushed.