This commit is contained in:
@@ -1,4 +1,4 @@
|
||||
# 𝄐 dirigent_fermata
|
||||
# 𝄐 fermata
|
||||
|
||||
**A fast, harness-agnostic policy gate for AI coding agents.**
|
||||
|
||||
@@ -44,14 +44,14 @@ Out of scope for v0.1: Codex / Gemini hook adapters, MCP server mode, audit log,
|
||||
|
||||
## Install
|
||||
|
||||
From source (this monorepo):
|
||||
|
||||
```bash
|
||||
cargo install --path crates/dirigent_fermata --features cli
|
||||
cargo install --git https://git.g4b.org/dirigence/fermata --features cli
|
||||
```
|
||||
|
||||
This installs the `fermata` binary into `~/.cargo/bin/`.
|
||||
|
||||
Requires a working [Rust toolchain](https://rustup.rs).
|
||||
|
||||
---
|
||||
|
||||
## Usage
|
||||
@@ -197,18 +197,31 @@ Decision: BLOCK — matched bash deny rule "cat .env*"
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
## Harness support
|
||||
|
||||
Three concentric layers; nothing inner imports from anything outer:
|
||||
|
||||
- **`core/`** — harness-unaware, sync. Types, `.botignore` walker, `botignore.toml` parser, `Policy::check` / `check_command`, path extraction.
|
||||
- **`harness/`** — `HarnessAdapter` trait over a normalized `ToolCall`. Each adapter lives in its own submodule, feature-gated.
|
||||
- **`bin/fermata.rs`** — the only place `clap`, stdio, and exit codes appear.
|
||||
| Harness | v0.1 |
|
||||
|---------|------|
|
||||
| Claude Code (PreToolUse) | Supported — native JSON adapter |
|
||||
| Codex CLI | Planned |
|
||||
| Gemini CLI | Planned (via MCP server mode) |
|
||||
| Any shell-based hook | Supported — CLI exit codes |
|
||||
|
||||
---
|
||||
|
||||
## See also
|
||||
## About this repository
|
||||
|
||||
- `docs/tools/fermata.md` — Dirigent integration plan
|
||||
- `docs/workpad/brainstorm/fermata.md` — full product spec and field notes
|
||||
- `docs/architecture/crates.md` — crate dependency map
|
||||
This is a downstream mirror. Fermata is developed inside the upstream
|
||||
[Dirigent](https://git.g4b.org/dirigence/dirigent) monorepo and exported here
|
||||
for standalone distribution. Issues and pull requests are accepted on the
|
||||
`develop` branch, but the canonical development happens upstream.
|
||||
|
||||
---
|
||||
|
||||
## License
|
||||
|
||||
Licensed under either of
|
||||
|
||||
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE))
|
||||
- MIT License ([LICENSE-MIT](LICENSE-MIT))
|
||||
|
||||
at your option.
|
||||
|
||||
Reference in New Issue
Block a user