Metadata-Version: 2.4
Name: cortexbuild-core
Version: 0.2.4
Summary: CortexBuild - agentic engineering framework for brownfield codebases.
Project-URL: Homepage, https://github.com/chiragmakvana/cortexbuild
Project-URL: Issues, https://github.com/chiragmakvana/cortexbuild/issues
Project-URL: Documentation, https://github.com/chiragmakvana/cortexbuild/tree/main/docs
Author-email: Chirag Makvana <chirag@vigilai.io>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,brownfield,llm,modernisation,orchestration,ssot
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Requires-Dist: anyio>=4.6
Requires-Dist: httpx>=0.28
Requires-Dist: platformdirs>=4.3
Requires-Dist: pydantic<3.0,>=2.9
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.9
Requires-Dist: structlog>=24.4
Requires-Dist: tenacity>=9.0
Requires-Dist: typer>=0.16
Provides-Extra: a2a
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.39; extra == 'anthropic'
Provides-Extra: api-spec
Requires-Dist: openapi-spec-validator>=0.7; extra == 'api-spec'
Provides-Extra: aws
Requires-Dist: boto3>=1.34; extra == 'aws'
Provides-Extra: connections
Requires-Dist: keyring>=25.0; extra == 'connections'
Provides-Extra: gemini
Requires-Dist: google-genai>=0.3; extra == 'gemini'
Provides-Extra: graph
Requires-Dist: networkx>=3.4; extra == 'graph'
Requires-Dist: tree-sitter-c-sharp>=0.23; extra == 'graph'
Requires-Dist: tree-sitter-dart>=0.1; extra == 'graph'
Requires-Dist: tree-sitter-go>=0.23; extra == 'graph'
Requires-Dist: tree-sitter-java>=0.23; extra == 'graph'
Requires-Dist: tree-sitter-javascript>=0.23; extra == 'graph'
Requires-Dist: tree-sitter-kotlin>=0.23; extra == 'graph'
Requires-Dist: tree-sitter-python>=0.23; extra == 'graph'
Requires-Dist: tree-sitter-swift>=0.7; extra == 'graph'
Requires-Dist: tree-sitter-typescript>=0.23; extra == 'graph'
Requires-Dist: tree-sitter>=0.23; extra == 'graph'
Provides-Extra: ide
Provides-Extra: llm
Requires-Dist: openai>=1.0; extra == 'llm'
Provides-Extra: mcp
Provides-Extra: memory
Requires-Dist: mem0ai>=0.1.0; extra == 'memory'
Provides-Extra: memory-local
Requires-Dist: mem0ai>=0.1.0; extra == 'memory-local'
Requires-Dist: sentence-transformers>=3.0; extra == 'memory-local'
Provides-Extra: otel
Requires-Dist: opentelemetry-api>=1.27; extra == 'otel'
Requires-Dist: opentelemetry-sdk>=1.27; extra == 'otel'
Provides-Extra: postgres
Requires-Dist: alembic>=1.14; extra == 'postgres'
Requires-Dist: asyncpg>=0.30; extra == 'postgres'
Requires-Dist: sqlalchemy[asyncio]>=2.0; extra == 'postgres'
Provides-Extra: publish
Provides-Extra: redis
Requires-Dist: redis[hiredis]>=5.2; extra == 'redis'
Provides-Extra: server
Requires-Dist: starlette>=0.37; extra == 'server'
Requires-Dist: uvicorn>=0.30; extra == 'server'
Provides-Extra: signing
Requires-Dist: cryptography>=43.0; extra == 'signing'
Provides-Extra: tooling
Provides-Extra: watch
Requires-Dist: watchdog>=4.0; extra == 'watch'
Description-Content-Type: text/markdown

# cortexbuild-core

The OSS engine for CortexBuild - agentic engineering framework for brownfield codebases.

> **Status:** Pre-Alpha (`0.0.1`) — API unstable, extraction in progress. Do not depend on this package in production.

## What lives here

| Subpackage | Purpose | Phase |
|---|---|---|
| `cortexbuild_core/rules/` | Foundational SSoT rule pack | P0 |
| `cortexbuild_core/agents/` | Generic agent personas | P0 |
| `cortexbuild_core/render/` | SSoT to multi-tool fanout | P0 |
| `cortexbuild_core/ledger/` | Recurrence ledger schema and CRUD | P0 |
| `cortexbuild_core/analyser/` | Brownfield codebase analyser | P0+ |
| `cortexbuild_core/providers/` | LLM provider adapters | P1 |
| `cortexbuild_core/orchestrator/` | Wave-based phase sequencer | P1 |
| `cortexbuild_core/cli/` | `cortexbuild` CLI entry points | P0+ |
| `cortexbuild_core/lint/` | Project-agnostic lint helpers | P0+ |

## Quick start

> Not published to PyPI yet. Available for local development via editable install.

When ready:

```bash
# From the cortexbuild-core/ directory
pip install -e .
cd <your-brownfield-repo>
cortexbuild init
```

## Development

Requires Python 3.11+.

```bash
# From the repo root
pip install -e ".[graph,postgres,redis]" --group dev

# Run tests
pytest

# Lint
ruff check .
ruff format --check .

# Type-check
mypy cortexbuild-core/cortexbuild_core
```

## Provenance

`cortexbuild-core` is the generic extraction of the agent governance system
proven in production at CortexVigil. See
[../docs/plan/03-TEMPLATE_EXTRACTION.md](../docs/plan/03-TEMPLATE_EXTRACTION.md)
for the source-to-target mapping.

## License

Apache 2.0. See [../LICENSE](../LICENSE).
