AGENTS.md

1## Engineering Workflow
2- Install: `task install` (config: `Taskfile.yml`).
3- Test: `task test` (config: `Taskfile.yml`).
4 
5## Dependency Guide
6- **Overview**: Full dependency descriptions are maintained in `dependencies_overview.md`.
7- **Usage**: Keep this section concise and treat `dependencies_overview.md` as the source-of-truth dependency catalog.
8 
9## Business Logic Domain
10- **Domain overview:** This codebase models a “code confluence” platform that ingests git repositories and codebases, stores structural signatures of source files, and detects framework-specific features using configurable queries and metadata. It also tracks workflow runs for repository and codebase processing, including statuses, errors, events, and agent output snapshots, alongside package manager and language metadata. Supporting models handle credentials, feature flags, and PR publication metadata for automated documentation or agent output updates.
11- **Core model groups:**
12  - Structural signatures and positioning primitives: `python_structural_signature.py`, `typescript_structural_signature.py`, `data_model_position.py`.
13  - Framework feature definitions, imports, and query matching: `framework_models.py`.
14  - Repository/codebase persistence, file inventories, and relational mappings: `relational_models/unoplat_code_confluence.py`, `repo_models.py`, `engine_models.py`.
15  - Workflow execution tracking (runs, statuses, errors, snapshots): `workflow_models.py`, `workflow_envelopes.py`.
16  - Configuration and operational metadata (credentials, flags, metadata, PR publication): `configuration_models.py`, `credentials.py`, `flags.py`, `programming_language_metadata.py`, `pr_metadata_model.py`.
17- **References:** See `business_logic_references.md` for a file-by-file map of business logic models.
18 
19## App Interfaces
20- **Overview:** No app interface constructs have been documented for this codebase yet.
21- **Inbound interfaces:** None documented.
22- **Outbound interfaces:** None documented.
23- **Internal interfaces:** None documented.
24- **References:** See `app_interfaces.md` for the tracked interface inventory.
25 
26## Backlog Workflow
27 
28This project uses Backlog.md MCP for all task and project management. Before creating tasks or tracking work, read [`backlog_instructions.md`](./backlog_instructions.md) for the complete workflow guidance.
29 
30<!-- UNOPLAT_CODE_CONFLUENCE_CONTEXT:BEGIN -->
31<CRITICAL_INSTRUCTION>
32 
33> Generated from branch `dev` at commit `5ecdba39d57f50c5188a8e32b9dd4f52d01611fe` (2026-07-18). Content may become stale as new commits land.
34 
35</CRITICAL_INSTRUCTION>
36 
37## Engineering Workflow
38### Install
39- `uv sync` (config: `pyproject.toml`, `Taskfile.yml`)
40### Build
41- `uv build` (config: `pyproject.toml`)
42### Dev
43- Not detected
44### Test
45- `uv run pytest -v tests/` (config: `pyproject.toml`, `Taskfile.yml`)
46### Lint
47- Not detected
48### Type Check
49- `uv run --group dev pyrefly check src/` (config: `pyproject.toml`, `Taskfile.yml`)
50 
51## Dependency Guide
52See [`dependencies_overview.md`](./dependencies_overview.md) for the full dependency catalog and usage notes.
53 
54## Business Domain
55### Description
56 
57This package supports Code Confluence, a repository ingestion and code-intelligence platform. Its models track Git repositories, codebases, workflow runs, credentials, and agent progress while storing structural signatures, framework features, and detected source-code spans across Python and TypeScript. It also carries metadata for AGENTS.md publication and repository-level status/event tracking.
58 
59### References
60 
61See [`business_domain_references.md`](./business_domain_references.md) for the supporting source references used to derive this domain summary.
62 
63## App Interfaces
64See [`app_interfaces.md`](./app_interfaces.md) for the canonical interface and endpoint reference.
65 
66## Architecture
67See [`architecture.md`](./architecture.md) for the canonical system architecture diagram.
68 
69<!-- UNOPLAT_CODE_CONFLUENCE_CONTEXT:END -->
70