> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirevow.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Install and configure

> In .gitvow/policy.json of the repository, or ~/.gitvow/policy.json:

```sh theme={"dark"}
pip install gitvow-provider-facts
gitvow-provider-facts --store facts.db --service orders ask route_callers /v1/orders
```

## Options

| Option             | Default                                  | Meaning                                                                    |
| ------------------ | ---------------------------------------- | -------------------------------------------------------------------------- |
| `--store PATH`     | required                                 | the SQLite fact store                                                      |
| `--repo NAME`      | basename of the repository gitvow passes | the `repo` value used in `fact` rows for this repository                   |
| `--service NAME`   | same as `--repo`                         | the `dst_service` value used in `edge` rows for calls into this repository |
| `--gate-file GLOB` | none                                     | repeatable; files that answer `gate_bearing` with `yes`                    |
| `--max-age-days N` | 14                                       | above this, answers add a staleness warning to the evidence                |

## Wire into gitvow

```json theme={"dark"}
{
  "providers": [
    {
      "name": "topology",
      "command": "gitvow-provider-facts --store /var/lib/topology/facts.db --repo amnic-orders --service orders --gate-file auth/AuthorizeWhitelistedPaths.java",
      "questions": ["route_gate", "route_callers", "gate_bearing"],
      "timeout": 10
    }
  ]
}
```

Then test from the repository:

```sh theme={"dark"}
gitvow ask route_gate /export --path src/api/OrdersResource.java
gitvow ask route_callers /v1/orders/{id}
```

## Running the provider by hand

`gitvow-provider-facts ... ask <question> <subject> [--path FILE]` prints the JSON answer. Without `ask` it reads a gitvow request on stdin, which is how gitvow calls it.