AGENTS.md

1<!-- UNOPLAT_CODE_CONFLUENCE_CONTEXT:BEGIN -->
2<CRITICAL_INSTRUCTION>
3 
4> Generated from branch `dev` at commit `5ecdba39d57f50c5188a8e32b9dd4f52d01611fe` (2026-07-18). Content may become stale as new commits land.
5 
6</CRITICAL_INSTRUCTION>
7 
8## Engineering Workflow
9### Install
10- `uv sync --group dev --group test` — run from the repository root using `Taskfile.yml`.
11 
12### Build
13- `uv build` — run from the repository root using `pyproject.toml`.
14 
15### Dev
16- Not detected.
17 
18### Test
19- `uv run --group test pytest -v tests/` — run from the repository root using `Taskfile.yml`.
20 
21### Lint
22- `uv run --group dev ruff check src/` — run from the repository root using `Taskfile.yml`.
23 
24### Type Check
25- `uv run --group dev pyrefly check src/` — run from the repository root using `Taskfile.yml`.
26 
27## Dependency Guide
28See [`dependencies_overview.md`](./dependencies_overview.md) for the full dependency catalog and usage notes.
29 
30## Business Domain
31### Description
32 
33This project is an OpenMetadata ingestion connector for Code Confluence, a repository-analysis system that turns query-engine snapshots into catalog assets. It publishes a developer-tooling domain and data product, then maps each codebase into API services, collections, and route-level endpoints enriched with engineering workflow, dependency, business-logic, and interface metadata. The core business focus is capturing deterministic source-code context and evidence so developers and AI agents can navigate repository behavior inside OpenMetadata.
34 
35### References
36 
37See [`business_domain_references.md`](./business_domain_references.md) for the supporting source references used to derive this domain summary.
38 
39## App Interfaces
40See [`app_interfaces.md`](./app_interfaces.md) for the canonical interface and endpoint reference.
41 
42## Architecture
43See [`architecture.md`](./architecture.md) for the canonical system architecture diagram.
44 
45<!-- UNOPLAT_CODE_CONFLUENCE_CONTEXT:END -->
46