seif-cli 0.1.2__tar.gz → 0.2.0__tar.gz

seif_cli-0.2.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: seif-cli
+Version: 0.2.0
+Summary: Measure AI output quality, protect sensitive data, and build multi-AI consensus. Works with any LLM.
+Author: André Cunha Antero de Carvalho
+License: CC-BY-NC-SA-4.0
+Project-URL: Homepage, https://github.com/and2carvalho/seif
+Project-URL: Documentation, https://github.com/and2carvalho/seif
+Project-URL: Repository, https://github.com/and2carvalho/seif
+Project-URL: Live Demo, https://seif-framework.streamlit.app
+Keywords: ai-quality,llm-guardrails,ai-consensus,data-classification,context-management,ai-safety,multi-ai,quality-gate,prompt-evaluation,ai-grounding
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Security
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=2.0
+Requires-Dist: scipy>=1.14
+Provides-Extra: consensus
+Requires-Dist: anthropic>=0.80; extra == "consensus"
+Provides-Extra: generators
+Requires-Dist: matplotlib>=3.9; extra == "generators"
+Requires-Dist: Pillow>=10.0; extra == "generators"
+Requires-Dist: opencv-python-headless>=4.8; extra == "generators"
+Requires-Dist: svgwrite>=1.4; extra == "generators"
+Provides-Extra: web
+Requires-Dist: streamlit>=1.28; extra == "web"
+Provides-Extra: telegram
+Requires-Dist: python-telegram-bot>=21.0; extra == "telegram"
+Provides-Extra: qr
+Requires-Dist: qrcode[pil]>=7.4; extra == "qr"
+Requires-Dist: Pillow>=10.0; extra == "qr"
+Requires-Dist: pyzbar>=0.1.9; extra == "qr"
+Provides-Extra: all
+Requires-Dist: seif-cli[consensus,generators,qr,telegram,web]; extra == "all"
+Dynamic: license-file
+
+# SEIF — Measure, Protect, and Triangulate AI Output
+
+> One question. Multiple AIs debate it. You get the answer they all agree on — graded for accuracy, with your data protected.
+
+[![PyPI](https://img.shields.io/pypi/v/seif-cli)](https://pypi.org/project/seif-cli/)
+[![Tests](https://img.shields.io/badge/tests-626%20passing-brightgreen)]()
+[![License](https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-blue)]()
+
+---
+
+## The Problem
+
+1. **You don't know when AI is making things up.** There's no standard way to measure if a response is grounded in facts or drifting into speculation.
+2. **Sensitive data leaks to AI APIs.** No guardrail prevents your code, credentials, or internal docs from being sent to external services.
+3. **One AI can be wrong.** A single model has blind spots. There's no easy way to get multiple AIs to debate and converge on an answer.
+
+## The Solution
+
+```bash
+pip install seif-cli
+```
+
+### 1. Quality Gate — Is the AI making things up?
+
+```bash
+seif --quality-gate "The framework uses quantum entanglement for data transfer" --role ai
+# Grade: D | Stance: DRIFT | Verifiable: 12%
+# Flags: [UNGROUNDED_CLAIMS]
+
+seif --quality-gate "Python 3.11 added the tomllib module for TOML parsing" --role ai
+# Grade: A | Stance: GROUNDED | Verifiable: 100%
+```
+
+Every response gets a grade (A-F) and a stance (GROUNDED, MIXED, or DRIFT). Verifiable claims are counted separately from speculation.
+
+### 2. Classification Gate — Is sensitive data leaking?
+
+```bash
+seif --init                    # scan your project
+seif --export --classification PUBLIC   # only export public content
+```
+
+Content is automatically classified as PUBLIC, INTERNAL, or CONFIDENTIAL. Keywords like `password`, `api_key`, `CVE` auto-escalate to CONFIDENTIAL. The classification gate blocks sensitive data from leaving your environment.
+
+Works as a [Claude Code hook](#claude-code-plugin) — blocks writes containing credentials or classified markers in real-time.
+
+### 3. Multi-AI Consensus — Let them debate
+
+```bash
+seif --consensus "Should we use microservices or a monolith for a 3-person team?" \
+     --backends claude,grok
+# Claude: monolith (velocity, simplicity)
+# Grok: monolith (team size, operational cost)
+# Consensus: CONVERGED — monolith for teams < 5
+
+seif --adversarial "Is our auth middleware secure?"
+# Compares response WITH protocol context vs WITHOUT
+# Delta report shows what context changes
+```
+
+One question goes to multiple AIs. They analyze independently, compare results, and converge. You get the answer they all agree on.
+
+---
+
+## Quick Start
+
+```bash
+pip install seif-cli
+cd my-project
+seif --init                    # scan project, extract git context, generate .seif/
+seif --sync                    # re-sync after code changes
+seif --quality-gate "text"     # grade AI output (A-F)
+```
+
+That's it. Your project now has persistent, classified, quality-measured context.
+
+## Claude Code Plugin
+
+SEIF works as a plugin for [Claude Code](https://github.com/anthropics/claude-code):
+
+```bash
+# Copy skills to your project
+cp -r plugins/claude-code/skills/* .claude/skills/
+
+# Add hooks to .claude/settings.json (see plugins/claude-code/README.md)
+```
+
+**What it does:**
+- **Session start**: loads your `.seif/` context automatically
+- **Pre-write**: blocks classified data from being written outside `.seif/`
+- **Slash commands**: `/gate`, `/sync`, `/status`
+
+## CLI Commands
+
+```bash
+# === Core (pip install seif-cli) ===
+seif --init                          # initialize .seif context
+seif --sync                          # re-sync git context
+seif --quality-gate "text"           # measure quality (Grade A-F)
+seif --compress                      # compress project into .seif (93% reduction)
+seif --export                        # export context as markdown
+
+# === Classification ===
+seif --export --classification PUBLIC        # only public modules
+seif --autonomous enable                     # AI persists knowledge autonomously
+
+# === Multi-AI (pip install seif-cli[consensus]) ===
+seif --consult "question"                    # auto-route to best AI
+seif --consensus "q" --backends claude,grok  # cross-AI consensus
+seif --adversarial "question"                # WITH vs WITHOUT comparison
+
+# === Workspace ===
+seif --workspace                     # multi-project discovery + sync
+seif --scan "git"                    # auto-generate CLI knowledge from --help
+```
+
+## How Quality Gate Works
+
+The quality gate measures two things:
+
+| Component | Weight | What it measures |
+|-----------|--------|-----------------|
+| **Stance Detector** | Primary | Counts verifiable vs interpretive claims. GROUNDED (≥80% verifiable), MIXED (40-80%), DRIFT (<40%) |
+| **Resonance Gate** | Secondary | Structural coherence (experimental) |
+
+Grades: **A** (≥0.85) → **B** (≥0.70) → **C** (≥0.55) → **D** (≥0.40) → **F** (<0.40)
+
+## Context Persistence
+
+SEIF also gives AI persistent memory across sessions — but so does ChatGPT Memory. The difference:
+
+| | ChatGPT Memory | SEIF |
+|-|---------------|------|
+| Who controls it | OpenAI | You (local files) |
+| Works with other AIs | No | Yes (any LLM) |
+| Exportable | No | Yes (.seif → markdown) |
+| Quality measured | No | Yes (stance A-F) |
+| Data classified | No | Yes (PUBLIC/INTERNAL/CONFIDENTIAL) |
+| Auditable | No | Yes (hash-chained provenance) |
+
+## Project Stats
+
+```
+59 modules  |  626 tests (33 suites)  |  93% context compression
+Classification: PUBLIC / INTERNAL / CONFIDENTIAL with auto-detection
+Quality Gate: Stance detector + resonance gate → Grade A-F
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+CC BY-NC-SA 4.0 — [André Cunha Antero de Carvalho](https://github.com/and2carvalho)

seif_cli-0.2.0/README.md

@@ -0,0 +1,155 @@
+# SEIF — Measure, Protect, and Triangulate AI Output
+
+> One question. Multiple AIs debate it. You get the answer they all agree on — graded for accuracy, with your data protected.
+
+[![PyPI](https://img.shields.io/pypi/v/seif-cli)](https://pypi.org/project/seif-cli/)
+[![Tests](https://img.shields.io/badge/tests-626%20passing-brightgreen)]()
+[![License](https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-blue)]()
+
+---
+
+## The Problem
+
+1. **You don't know when AI is making things up.** There's no standard way to measure if a response is grounded in facts or drifting into speculation.
+2. **Sensitive data leaks to AI APIs.** No guardrail prevents your code, credentials, or internal docs from being sent to external services.
+3. **One AI can be wrong.** A single model has blind spots. There's no easy way to get multiple AIs to debate and converge on an answer.
+
+## The Solution
+
+```bash
+pip install seif-cli
+```
+
+### 1. Quality Gate — Is the AI making things up?
+
+```bash
+seif --quality-gate "The framework uses quantum entanglement for data transfer" --role ai
+# Grade: D | Stance: DRIFT | Verifiable: 12%
+# Flags: [UNGROUNDED_CLAIMS]
+
+seif --quality-gate "Python 3.11 added the tomllib module for TOML parsing" --role ai
+# Grade: A | Stance: GROUNDED | Verifiable: 100%
+```
+
+Every response gets a grade (A-F) and a stance (GROUNDED, MIXED, or DRIFT). Verifiable claims are counted separately from speculation.
+
+### 2. Classification Gate — Is sensitive data leaking?
+
+```bash
+seif --init                    # scan your project
+seif --export --classification PUBLIC   # only export public content
+```
+
+Content is automatically classified as PUBLIC, INTERNAL, or CONFIDENTIAL. Keywords like `password`, `api_key`, `CVE` auto-escalate to CONFIDENTIAL. The classification gate blocks sensitive data from leaving your environment.
+
+Works as a [Claude Code hook](#claude-code-plugin) — blocks writes containing credentials or classified markers in real-time.
+
+### 3. Multi-AI Consensus — Let them debate
+
+```bash
+seif --consensus "Should we use microservices or a monolith for a 3-person team?" \
+     --backends claude,grok
+# Claude: monolith (velocity, simplicity)
+# Grok: monolith (team size, operational cost)
+# Consensus: CONVERGED — monolith for teams < 5
+
+seif --adversarial "Is our auth middleware secure?"
+# Compares response WITH protocol context vs WITHOUT
+# Delta report shows what context changes
+```
+
+One question goes to multiple AIs. They analyze independently, compare results, and converge. You get the answer they all agree on.
+
+---
+
+## Quick Start
+
+```bash
+pip install seif-cli
+cd my-project
+seif --init                    # scan project, extract git context, generate .seif/
+seif --sync                    # re-sync after code changes
+seif --quality-gate "text"     # grade AI output (A-F)
+```
+
+That's it. Your project now has persistent, classified, quality-measured context.
+
+## Claude Code Plugin
+
+SEIF works as a plugin for [Claude Code](https://github.com/anthropics/claude-code):
+
+```bash
+# Copy skills to your project
+cp -r plugins/claude-code/skills/* .claude/skills/
+
+# Add hooks to .claude/settings.json (see plugins/claude-code/README.md)
+```
+
+**What it does:**
+- **Session start**: loads your `.seif/` context automatically
+- **Pre-write**: blocks classified data from being written outside `.seif/`
+- **Slash commands**: `/gate`, `/sync`, `/status`
+
+## CLI Commands
+
+```bash
+# === Core (pip install seif-cli) ===
+seif --init                          # initialize .seif context
+seif --sync                          # re-sync git context
+seif --quality-gate "text"           # measure quality (Grade A-F)
+seif --compress                      # compress project into .seif (93% reduction)
+seif --export                        # export context as markdown
+
+# === Classification ===
+seif --export --classification PUBLIC        # only public modules
+seif --autonomous enable                     # AI persists knowledge autonomously
+
+# === Multi-AI (pip install seif-cli[consensus]) ===
+seif --consult "question"                    # auto-route to best AI
+seif --consensus "q" --backends claude,grok  # cross-AI consensus
+seif --adversarial "question"                # WITH vs WITHOUT comparison
+
+# === Workspace ===
+seif --workspace                     # multi-project discovery + sync
+seif --scan "git"                    # auto-generate CLI knowledge from --help
+```
+
+## How Quality Gate Works
+
+The quality gate measures two things:
+
+| Component | Weight | What it measures |
+|-----------|--------|-----------------|
+| **Stance Detector** | Primary | Counts verifiable vs interpretive claims. GROUNDED (≥80% verifiable), MIXED (40-80%), DRIFT (<40%) |
+| **Resonance Gate** | Secondary | Structural coherence (experimental) |
+
+Grades: **A** (≥0.85) → **B** (≥0.70) → **C** (≥0.55) → **D** (≥0.40) → **F** (<0.40)
+
+## Context Persistence
+
+SEIF also gives AI persistent memory across sessions — but so does ChatGPT Memory. The difference:
+
+| | ChatGPT Memory | SEIF |
+|-|---------------|------|
+| Who controls it | OpenAI | You (local files) |
+| Works with other AIs | No | Yes (any LLM) |
+| Exportable | No | Yes (.seif → markdown) |
+| Quality measured | No | Yes (stance A-F) |
+| Data classified | No | Yes (PUBLIC/INTERNAL/CONFIDENTIAL) |
+| Auditable | No | Yes (hash-chained provenance) |
+
+## Project Stats
+
+```
+59 modules  |  626 tests (33 suites)  |  93% context compression
+Classification: PUBLIC / INTERNAL / CONFIDENTIAL with auto-detection
+Quality Gate: Stance detector + resonance gate → Grade A-F
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+CC BY-NC-SA 4.0 — [André Cunha Antero de Carvalho](https://github.com/and2carvalho)

{seif_cli-0.1.2 → seif_cli-0.2.0}/pyproject.toml

@@ -4,45 +4,52 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "seif-cli"
-version = "0.1.2"
-description = "S.E.I.F. — Your AI never starts from zero. Compressed, verified, collaborative context for any LLM."
+version = "0.2.0"
+description = "Measure AI output quality, protect sensitive data, and build multi-AI consensus. Works with any LLM."
 readme = "README.md"
 license = {text = "CC-BY-NC-SA-4.0"}
 requires-python = ">=3.11"
 authors = [
-    {name = "André Cunha Antero de Carvalho", email = "and2carvalho@gmail.com"},
+    {name = "André Cunha Antero de Carvalho"},
 ]
 keywords = [
-    "ai-context", "llm-memory", "context-compression", "team-collaboration",
-    "resonance", "sacred-geometry", "3-6-9", "golden-ratio",
-    "prompt-engineering", "ai-communication",
+    "ai-quality", "llm-guardrails", "ai-consensus", "data-classification",
+    "context-management", "ai-safety", "multi-ai", "quality-gate",
+    "prompt-evaluation", "ai-grounding",
 ]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Intended Audience :: Science/Research",
-    "Topic :: Scientific/Engineering",
-    "Topic :: Software Development :: Libraries",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Security",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
 ]
 
-# Core dependencies — minimal for CLI usage
+# Core: quality gate + context + classification (no heavy deps)
 dependencies = [
     "numpy>=2.0",
     "scipy>=1.14",
 ]
 
 [project.optional-dependencies]
-# Full installation (web interface + all generators)
-full = [
+# Inter-AI consensus (needs API client)
+consensus = [
+    "anthropic>=0.80",
+]
+# Visual generators (fractal QR, glyphs, circuits, audio)
+generators = [
     "matplotlib>=3.9",
     "Pillow>=10.0",
     "opencv-python-headless>=4.8",
     "svgwrite>=1.4",
+]
+# Web interface (Streamlit dashboard)
+web = [
     "streamlit>=1.28",
-    "anthropic>=0.80",
 ]
 # Telegram bot bridge
 telegram = [
@@ -56,7 +63,7 @@ qr = [
 ]
 # Everything
 all = [
-    "seif-cli[full,telegram,qr]",
+    "seif-cli[consensus,generators,web,telegram,qr]",
 ]
 
 [project.urls]
@@ -66,8 +73,8 @@ Repository = "https://github.com/and2carvalho/seif"
 "Live Demo" = "https://seif-framework.streamlit.app"
 
 [project.scripts]
-seif-cli = "seif.cli.cli:main"
 seif = "seif.cli.wrapper:main"
+seif-cli = "seif.cli.wrapper:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]