Metadata-Version: 2.4
Name: SRT1-CORE
Version: 2.1.0
Summary: SRT-1 — Cognitive Operating System for Software Repositories. Anti-hallucination guardrails for AI code assistants.
Author: William Darnell Jernigan IV
License: Proprietary - SCIA
Project-URL: Homepage, https://seedreflection.com
Keywords: scia,srt-1,code-indexer,anti-hallucination,seed-signature,static-analysis,ai-governance,code-assistant,context-injection
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: pro
Provides-Extra: platform
Provides-Extra: all

# SRT-1 — Cognitive Operating System for Software Repositories

**Brain Over the Repo** — Anti-hallucination guardrails for AI code assistants.

[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![License: Proprietary](https://img.shields.io/badge/license-SCIA-red.svg)](https://seedreflection.com)

---

## What Is SRT-1?

SRT-1 scans your entire codebase, understands every function's purpose, risk profile, and architectural role, then uses that knowledge to keep AI code assistants on task. It prevents hallucination, code duplication, and architectural drift.

### The SCIA Pipeline

```
Phase 1: Code Indexer    → Scans, parses, curates, signs → Code Manifest
Phase 2: Context Bundler → Task analysis + symbol search → Context Bundle
Phase 3: Execution Engine → Governed AI dispatch → Signed Result
```

## Installation

```bash
pip install SRT1-CORE
```

## Quick Start

### Index a Repository

```bash
srt1-index --repo_path /path/to/your/repo
```

This generates `srt1_code_manifest.json` — a cryptographically signed map of your entire codebase.

### Use as a Library

```python
from srt1_code_indexer import SRT1CodeIndexer

indexer = SRT1CodeIndexer("/path/to/repo")
manifest = indexer.index_repository()
```

### Build a Context Bundle (Pro)

```bash
srt1-bundle --manifest srt1_code_manifest.json --task "Add user authentication"
```

### Start the Live Middleware (Platform)

```bash
srt1-middleware --repo_path ./my_project --port 7483
```

Then integrate with any AI assistant via HTTP:

```bash
curl -X POST http://localhost:7483/task -d '{"task": "Add refund emails"}'
curl http://localhost:7483/context
```

## Tiers

| Tier | Includes | CLI Tools |
|------|----------|-----------|
| **Core** | Code Indexer, SRT Engine, Seed Signature Client | `srt1-index` |
| **Pro** | + Context Bundler, Execution Engine, Self-Heal | `srt1-bundle`, `srt1-execute`, `srt1-heal` |
| **Platform** | + Live Middleware, Seed Queue, Execution Bridge, Thread Recovery | `srt1-middleware` |

## What the Code Manifest Contains

- **File manifest** with SHA-256 content hashes
- **Symbol table** with AST-extracted metadata (classes, functions, parameters)
- **Curation report** (duplicate files, overlapping functions)
- **SRT-1 reflections** (purpose, architectural role, risk profile for every symbol)
- **Execution trace chain** and coherence history
- **Service-Backed Seed Signature** for cryptographic tamper detection

## Security

- **Zero network access** — indexing and analysis never leave your machine
- **Read-only scanning** — never modifies your source files
- **No external dependencies** — Python standard library only
- **Path-safe output** — no absolute paths in the manifest
- **Service-backed signing** — signing authority is not embedded in the public package

## Architecture

```
srt.py                      → Seed Reflection Tool (anti-hallucination guardrail)
seed_signature_client.py    → Client interface for Seed Signature service
srt1_code_indexer/          → Code Reflection & Indexing Engine
srt1_pro/                   → Intelligence Layer (bundler, executor, self-heal)
srt1_platform/              → Full Platform (middleware, seed queue, bridge)
```

> **Note (v2.1.0):** Seed Signature authority has been extracted from the public
> package. All signing and verification is now service-backed through
> `SeedSignatureClient`. Direct import of `SeedSignatureClient` is no longer
> supported.

## Requirements

- Python 3.9+
- No external dependencies (stdlib only)

## License

Proprietary — Seed-Class Intelligence Architecture (SCIA)
Author: William Darnell Jernigan IV
