hermes-half 1.0.0__tar.gz

hermes_half-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Turin Tech Solutions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hermes_half-1.0.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: hermes-half
+Version: 1.0.0
+Summary: Hermes Agentic Lifecycle Framework — transform concepts into production software
+Author-email: Hermes Agent / Turin Tech Solutions <josh@turintechsolutions.com>
+License: MIT
+Project-URL: Homepage, https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework
+Project-URL: Documentation, https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework#readme
+Project-URL: Repository, https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework
+Project-URL: Changelog, https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework/blob/master/CHANGELOG.md
+Project-URL: Issues, https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework/issues
+Keywords: half,lifecycle,sdlc,agentic-se,automation,ci-cd
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: langgraph>=0.4
+Requires-Dist: langgraph-checkpoint-sqlite>=2.0
+Requires-Dist: mcp>=1.0
+Dynamic: license-file
+
+<div align="center">
+
+# ⚡ HALF — Hermes Agentic Lifecycle Framework
+
+**Transform high-level business concepts into production-ready software through autonomous, multi-agent orchestration.**
+
+[![CI](https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework/actions/workflows/ci.yml/badge.svg)](https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](pyproject.toml)
+[![mypy](https://img.shields.io/badge/mypy-strict-green.svg)](https://mypy-lang.org/)
+[![Ruff](https://img.shields.io/badge/code%20style-ruff-purple.svg)](https://docs.astral.sh/ruff/)
+[![Tests](https://img.shields.io/badge/tests-62%20passing-brightgreen.svg)](tests/)
+
+</div>
+
+---
+
+## What is HALF?
+
+**HALF** is a modular, open-source framework that enables AI agents to autonomously execute the full software development lifecycle. It implements a **5-phase structured SDLC** with built-in quality gates, fail-safe protocols, and explicit human checkpoints.
+
+```mermaid
+graph LR
+    A[Concept] --> B[Phase 1<br/>Discovery & Strategy]
+    B -->|Gate G1| C[Phase 2<br/>Development & Coding]
+    C -->|Gate G2| D[Phase 3<br/>Quality Assurance]
+    D -->|Gate G3| E[Phase 4<br/>Polish & Deployment]
+    E -->|Finality Gate| F[Phase 5<br/>Iteration]
+    F --> B
+```
+
+### Core Principles
+
+- **Agent executes, human directs** — Agents handle implementation; humans set intent, review checkpoints, own decisions
+- **Gates before progress** — Every phase has mandatory quality gates
+- **Fail-safe by design** — 3-level escalation: step retry → phase retry → human gap report
+- **TDD is mandatory** — Harness-first: write failing tests before any implementation
+- **Codification Imperative** — Every manual fix becomes a durable improvement to the agent system
+
+---
+
+## Quick Start
+
+```bash
+# 1. Clone
+git clone https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework.git
+cd Hermes-Agentic-Lifecycle-Framework
+
+# 2. Install
+pip install uv
+uv sync --group dev
+
+# 3. Verify
+make test
+
+# 4. Bootstrap a project
+./scripts/genesis.sh --project my-app --mode full
+
+# 5. Use in Hermes Agent
+skill_view(name="half")
+```
+
+---
+
+## The 5 Phases
+
+| Phase | Objective | Agent Skills | Human Checkpoint |
+|-------|-----------|-------------|------------------|
+| **1: Discovery & Strategy** | Requirements → Spec → Architecture | Discovery, Specification, Architect | **Review spec + arch** |
+| **2: Development & Coding** | TDD implementation with Tri-Phasic Loop | Scaffold, Research, Plan, Implement, Simplify | — |
+| **3: Quality Assurance** | Test completeness + security red-teaming | Testing, Security, Integration | **Review test + security report** |
+| **4: Polish & Deployment** | IaC + CI/CD + production readiness | Infrastructure, CICD, Launch | **Finality Gate sign-off** |
+| **5: Iteration** | Monitoring + triage + codification | Observe, Iterate, Codify | — |
+
+### Three Human Checkpoints (non-negotiable)
+
+1. **After Phase 1** — Review spec and architecture before code is written
+2. **After Phase 3** — Review test results, security findings, merge confidence
+3. **After Phase 4** — Review launch readiness via Finality Gate (cryptographic sign-off)
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│              Command Center (Tauri Desktop GUI)              │
+│  ┌──────────────┐  ┌───────────────┐  ┌──────────────────┐  │
+│  │ Focalboard   │  │ Agent Mail    │  │ Grafana/Laminar  │  │
+│  │ (Kanban)     │  │ (Messages)    │  │ (Observability)  │  │
+│  └──────┬───────┘  └──────┬────────┘  └────────┬─────────┘  │
+└─────────┼──────────────────┼────────────────────┼────────────┘
+          │                  │                    │
+          ▼                  ▼                    ▼
+┌─────────────────────────────────────────────────────────────┐
+│                 LangGraph State Machine                      │
+│    Phase 1 → Phase 2 → Phase 3 → Phase 4 → Phase 5         │
+│                    ↕ (iteration cycle)                       │
+│        16 Agent Skills + Code-Simplifier + Gates            │
+└─────────────────────────────────────────────────────────────┘
+          │                  │                    │
+          ▼                  ▼                    ▼
+┌──────────────┐  ┌──────────────────┐  ┌────────────────────┐
+│ Observability│  │ Execution        │  │ CI/CD (GitHub      │
+│ (LangWatch,  │  │ Sandbox (Docker/ │  │ Actions → Deploy)  │
+│  Laminar,    │  │ Podman)          │  │ with per-stage     │
+│  Prometheus) │  │ Read-only Vault  │  │ quality gates      │
+└──────────────┘  └──────────────────┘  └────────────────────┘
+```
+
+---
+
+## Repository Structure
+
+```
+src/
+├── half/               # Package root + CLI entrypoint
+├── agents/             # 16 agent skill implementations
+├── core/               # Orchestrator, gates, fail-safe, error budget
+├── runtime/            # LangGraph graph, checkpointer, nodes
+├── state/              # LangGraph security (CVE mitigations)
+├── agent_mail/         # Decentralized agent coordination
+├── half_voice/         # Speech-to-text and text-to-speech
+├── half_focalboard/    # Kanban API client
+└── half_sidecar.py     # Tauri Python sidecar
+
+scripts/                # Bootstrap, genesis, deploy, install-foss
+templates/              # fail-safes.yaml, gap-report.md
+references/             # quickstart-execution.md
+docker/                 # Dockerfile + docker-compose (app + FOSS stack)
+vault_root/             # Obsidian RAG vault structure
+```
+
+---
+
+## Fail-Safe Protocol
+
+```yaml
+escalation:
+  level_1: "Step retry (×3) — auto-analyze failure, adjust, retry"
+  level_2: "Phase retry (×2) — re-run phase with expanded context"
+  level_3: "Human escalation — generate Gap Report, pause pipeline"
+circuit_breakers:
+  - ">5 test failures → halt phase 2"
+  - "CRITICAL security finding → halt phase 3"
+  - "coverage drops >5% → warn before proceeding"
+error_budget:
+  total: "100 points / 30 days"
+  thresholds: {warning: "<40%", critical: "<20%", exhausted: "0%"}
+```
+
+---
+
+## Security
+
+| CVE | Component | Mitigation |
+|-----|-----------|------------|
+| CVE-2025-67644 | LangGraph SQLite | Metadata allowlist validates all filter keys |
+| CVE-2026-28277 | LangGraph msgpack | JSON-safe serialization prevents RCE |
+
+- Execution sandbox (read-only vault mount, network-isolated)
+- Dangerous command denylist (rm -rf, dd, mkfs, format)
+- Path traversal protection via pre-execution hooks
+- Secrets detection in CI (trufflehog)
+- Weekly dependency scans via Dependabot
+
+---
+
+## Development
+
+```bash
+make install       # Install dependencies
+make lint          # Run ruff linter
+make typecheck     # Run mypy type checker
+make test          # Run test suite (62 tests)
+make ready         # Full CI pipeline
+make ship          # Release build (Tauri + Python)
+```
+
+---
+
+## License
+
+MIT — See [LICENSE](LICENSE).
+
+Built by [Turin Tech Solutions](mailto:josh@turintechsolutions.com) with Hermes Agent.
+
+---
+
+<div align="center">
+<a href="docs/getting-started/installation.md">Installation</a> •
+<a href="docs/getting-started/quickstart.md">Quick Start</a> •
+<a href="docs/guide/overview.md">User Guide</a> •
+<a href="CONTRIBUTING.md">Contributing</a> •
+<a href="CHANGELOG.md">Changelog</a>
+</div>

hermes_half-1.0.0/README.md

@@ -0,0 +1,196 @@
+<div align="center">
+
+# ⚡ HALF — Hermes Agentic Lifecycle Framework
+
+**Transform high-level business concepts into production-ready software through autonomous, multi-agent orchestration.**
+
+[![CI](https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework/actions/workflows/ci.yml/badge.svg)](https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](pyproject.toml)
+[![mypy](https://img.shields.io/badge/mypy-strict-green.svg)](https://mypy-lang.org/)
+[![Ruff](https://img.shields.io/badge/code%20style-ruff-purple.svg)](https://docs.astral.sh/ruff/)
+[![Tests](https://img.shields.io/badge/tests-62%20passing-brightgreen.svg)](tests/)
+
+</div>
+
+---
+
+## What is HALF?
+
+**HALF** is a modular, open-source framework that enables AI agents to autonomously execute the full software development lifecycle. It implements a **5-phase structured SDLC** with built-in quality gates, fail-safe protocols, and explicit human checkpoints.
+
+```mermaid
+graph LR
+    A[Concept] --> B[Phase 1<br/>Discovery & Strategy]
+    B -->|Gate G1| C[Phase 2<br/>Development & Coding]
+    C -->|Gate G2| D[Phase 3<br/>Quality Assurance]
+    D -->|Gate G3| E[Phase 4<br/>Polish & Deployment]
+    E -->|Finality Gate| F[Phase 5<br/>Iteration]
+    F --> B
+```
+
+### Core Principles
+
+- **Agent executes, human directs** — Agents handle implementation; humans set intent, review checkpoints, own decisions
+- **Gates before progress** — Every phase has mandatory quality gates
+- **Fail-safe by design** — 3-level escalation: step retry → phase retry → human gap report
+- **TDD is mandatory** — Harness-first: write failing tests before any implementation
+- **Codification Imperative** — Every manual fix becomes a durable improvement to the agent system
+
+---
+
+## Quick Start
+
+```bash
+# 1. Clone
+git clone https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework.git
+cd Hermes-Agentic-Lifecycle-Framework
+
+# 2. Install
+pip install uv
+uv sync --group dev
+
+# 3. Verify
+make test
+
+# 4. Bootstrap a project
+./scripts/genesis.sh --project my-app --mode full
+
+# 5. Use in Hermes Agent
+skill_view(name="half")
+```
+
+---
+
+## The 5 Phases
+
+| Phase | Objective | Agent Skills | Human Checkpoint |
+|-------|-----------|-------------|------------------|
+| **1: Discovery & Strategy** | Requirements → Spec → Architecture | Discovery, Specification, Architect | **Review spec + arch** |
+| **2: Development & Coding** | TDD implementation with Tri-Phasic Loop | Scaffold, Research, Plan, Implement, Simplify | — |
+| **3: Quality Assurance** | Test completeness + security red-teaming | Testing, Security, Integration | **Review test + security report** |
+| **4: Polish & Deployment** | IaC + CI/CD + production readiness | Infrastructure, CICD, Launch | **Finality Gate sign-off** |
+| **5: Iteration** | Monitoring + triage + codification | Observe, Iterate, Codify | — |
+
+### Three Human Checkpoints (non-negotiable)
+
+1. **After Phase 1** — Review spec and architecture before code is written
+2. **After Phase 3** — Review test results, security findings, merge confidence
+3. **After Phase 4** — Review launch readiness via Finality Gate (cryptographic sign-off)
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│              Command Center (Tauri Desktop GUI)              │
+│  ┌──────────────┐  ┌───────────────┐  ┌──────────────────┐  │
+│  │ Focalboard   │  │ Agent Mail    │  │ Grafana/Laminar  │  │
+│  │ (Kanban)     │  │ (Messages)    │  │ (Observability)  │  │
+│  └──────┬───────┘  └──────┬────────┘  └────────┬─────────┘  │
+└─────────┼──────────────────┼────────────────────┼────────────┘
+          │                  │                    │
+          ▼                  ▼                    ▼
+┌─────────────────────────────────────────────────────────────┐
+│                 LangGraph State Machine                      │
+│    Phase 1 → Phase 2 → Phase 3 → Phase 4 → Phase 5         │
+│                    ↕ (iteration cycle)                       │
+│        16 Agent Skills + Code-Simplifier + Gates            │
+└─────────────────────────────────────────────────────────────┘
+          │                  │                    │
+          ▼                  ▼                    ▼
+┌──────────────┐  ┌──────────────────┐  ┌────────────────────┐
+│ Observability│  │ Execution        │  │ CI/CD (GitHub      │
+│ (LangWatch,  │  │ Sandbox (Docker/ │  │ Actions → Deploy)  │
+│  Laminar,    │  │ Podman)          │  │ with per-stage     │
+│  Prometheus) │  │ Read-only Vault  │  │ quality gates      │
+└──────────────┘  └──────────────────┘  └────────────────────┘
+```
+
+---
+
+## Repository Structure
+
+```
+src/
+├── half/               # Package root + CLI entrypoint
+├── agents/             # 16 agent skill implementations
+├── core/               # Orchestrator, gates, fail-safe, error budget
+├── runtime/            # LangGraph graph, checkpointer, nodes
+├── state/              # LangGraph security (CVE mitigations)
+├── agent_mail/         # Decentralized agent coordination
+├── half_voice/         # Speech-to-text and text-to-speech
+├── half_focalboard/    # Kanban API client
+└── half_sidecar.py     # Tauri Python sidecar
+
+scripts/                # Bootstrap, genesis, deploy, install-foss
+templates/              # fail-safes.yaml, gap-report.md
+references/             # quickstart-execution.md
+docker/                 # Dockerfile + docker-compose (app + FOSS stack)
+vault_root/             # Obsidian RAG vault structure
+```
+
+---
+
+## Fail-Safe Protocol
+
+```yaml
+escalation:
+  level_1: "Step retry (×3) — auto-analyze failure, adjust, retry"
+  level_2: "Phase retry (×2) — re-run phase with expanded context"
+  level_3: "Human escalation — generate Gap Report, pause pipeline"
+circuit_breakers:
+  - ">5 test failures → halt phase 2"
+  - "CRITICAL security finding → halt phase 3"
+  - "coverage drops >5% → warn before proceeding"
+error_budget:
+  total: "100 points / 30 days"
+  thresholds: {warning: "<40%", critical: "<20%", exhausted: "0%"}
+```
+
+---
+
+## Security
+
+| CVE | Component | Mitigation |
+|-----|-----------|------------|
+| CVE-2025-67644 | LangGraph SQLite | Metadata allowlist validates all filter keys |
+| CVE-2026-28277 | LangGraph msgpack | JSON-safe serialization prevents RCE |
+
+- Execution sandbox (read-only vault mount, network-isolated)
+- Dangerous command denylist (rm -rf, dd, mkfs, format)
+- Path traversal protection via pre-execution hooks
+- Secrets detection in CI (trufflehog)
+- Weekly dependency scans via Dependabot
+
+---
+
+## Development
+
+```bash
+make install       # Install dependencies
+make lint          # Run ruff linter
+make typecheck     # Run mypy type checker
+make test          # Run test suite (62 tests)
+make ready         # Full CI pipeline
+make ship          # Release build (Tauri + Python)
+```
+
+---
+
+## License
+
+MIT — See [LICENSE](LICENSE).
+
+Built by [Turin Tech Solutions](mailto:josh@turintechsolutions.com) with Hermes Agent.
+
+---
+
+<div align="center">
+<a href="docs/getting-started/installation.md">Installation</a> •
+<a href="docs/getting-started/quickstart.md">Quick Start</a> •
+<a href="docs/guide/overview.md">User Guide</a> •
+<a href="CONTRIBUTING.md">Contributing</a> •
+<a href="CHANGELOG.md">Changelog</a>
+</div>

hermes_half-1.0.0/pyproject.toml

@@ -0,0 +1,124 @@
+[build-system]
+requires = ["setuptools>=75.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hermes-half"
+version = "1.0.0"
+description = "Hermes Agentic Lifecycle Framework — transform concepts into production software"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Hermes Agent / Turin Tech Solutions", email = "josh@turintechsolutions.com"}
+]
+requires-python = ">=3.13"
+keywords = ["half", "lifecycle", "sdlc", "agentic-se", "automation", "ci-cd"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Testing",
+]
+
+dependencies = [
+    "pydantic>=2.0",
+    "pyyaml>=6.0",
+    "langgraph>=0.4",
+    "langgraph-checkpoint-sqlite>=2.0",
+    "mcp>=1.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework"
+"Documentation" = "https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework#readme"
+"Repository" = "https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework"
+"Changelog" = "https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework/blob/master/CHANGELOG.md"
+"Issues" = "https://github.com/iknowkungfubar/Hermes-Agentic-Lifecycle-Framework/issues"
+
+[project.scripts]
+half = "half.__main__:main"
+
+[dependency-groups]
+dev = [
+    "ruff>=0.9",
+    "mypy>=1.14",
+    "pytest>=8.0",
+    "pytest-cov>=6.0",
+    "pytest-asyncio>=0.25",
+    "pre-commit>=4.0",
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["half*"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py313"
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D",         # docstring rules
+    "ANN",       # annotation rules
+    "COM812",    # trailing comma
+    "INP001",    # implicit namespace package
+    "FBT001",    # boolean positional args
+    "FBT002",
+    "S101",      # allow assert in tests
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101", "PLR2004", "ARG001", "ARG002"]
+"scripts/**" = ["T201", "INP001"]
+"src/half_voice/engine.py" = ["S603"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.mypy]
+strict = true
+ignore_missing_imports = true
+allow_untyped_defs = false
+disallow_untyped_decorators = false
+exclude = [
+    "src-tauri/",
+    ".venv/",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+addopts = "-v --cov=src --cov-report=term-missing --tb=short"
+filterwarnings = [
+    "ignore::ResourceWarning",
+]
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "network: marks tests that need network access",
+    "integration: marks integration tests",
+    "unit: marks unit tests",
+]
+
+[tool.coverage.run]
+source = ["src"]
+omit = [
+    "tests/*",
+    "scripts/*",
+    "src-tauri/*",
+    "src/half_voice/engine.py",
+]
+
+[tool.coverage.report]
+fail_under = 10
+show_missing = true
+skip_covered = true
+
+[tool.coverage.html]
+directory = "htmlcov"

hermes_half-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

hermes_half-1.0.0/src/half/__init__.py

@@ -0,0 +1,19 @@
+"""HALF — Hermes Agentic Lifecycle Framework.
+
+A modular, template-driven framework that transforms high-level business
+concepts into production-ready software through autonomous, multi-agent
+orchestration.
+"""
+
+from __future__ import annotations
+
+__version__ = "1.0.0"
+__author__ = "Hermes Agent / Turin Tech Solutions"
+__license__ = "MIT"
+__description__ = (
+    "Hermes Agentic Lifecycle Framework — transform concepts into production software"
+)
+
+import sys as _sys
+
+# Check Python version