mana-ciel 0.2.0__tar.gz

mana_ciel-0.2.0/LICENSE

@@ -0,0 +1 @@
+[GNU Affero General Public License v3.0](./LICENSE)

mana_ciel-0.2.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: mana-ciel
+Version: 0.2.0
+Summary: Ciel Agent Framework - Enterprise multi-agent harness, model-agnostic, deploy-agnostic
+Author: Ciel Agent Framework Authors
+License: AGPL-3.0-or-later
+Project-URL: Homepage, https://github.com/Ander-Labs/ciel-agent-framework
+Project-URL: Repository, https://github.com/Ander-Labs/ciel-agent-framework
+Project-URL: Issues, https://github.com/Ander-Labs/ciel-agent-framework/issues
+Project-URL: Changelog, https://github.com/Ander-Labs/ciel-agent-framework/blob/main/CHANGELOG.md
+Keywords: agent,harness,multi-agent,orchestration,llm,enterprise
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: aiofiles>=23.2
+Requires-Dist: httpx>=0.27
+Requires-Dist: tenacity>=9.0
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Requires-Dist: croniter>=5.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: uv>=0.5
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material; extra == "docs"
+Requires-Dist: mkdocstrings[python]; extra == "docs"
+Provides-Extra: acp
+Requires-Dist: fastapi>=0.112; extra == "acp"
+Requires-Dist: uvicorn>=0.30; extra == "acp"
+Provides-Extra: gateway
+Requires-Dist: fastapi>=0.112; extra == "gateway"
+Requires-Dist: uvicorn>=0.30; extra == "gateway"
+Requires-Dist: mcp>=1.2; extra == "gateway"
+Provides-Extra: security
+Requires-Dist: python-dotenv>=1.0; extra == "security"
+Provides-Extra: observability
+Requires-Dist: opentelemetry-api>=1.20; extra == "observability"
+Requires-Dist: opentelemetry-sdk>=1.20; extra == "observability"
+Requires-Dist: prometheus-client>=0.20; extra == "observability"
+Provides-Extra: messaging
+Requires-Dist: slack-sdk>=3.27; extra == "messaging"
+Provides-Extra: board
+Requires-Dist: sqlalchemy>=2.0; extra == "board"
+Dynamic: license-file
+
+# Ciel Agent Framework
+
+Enterprise-grade framework to build model-agnostic, deploy-agnostic autonomous agents and multi-agent systems with harness-first principles.
+
+## Packages
+
+| Package | Purpose |
+|---|---|
+| `ciel` | Public SDK, CLI entrypoint |
+| `ciel.providers` | Model provider interface + adapters |
+| `ciel.runtime` | Agent runtime, tooling, memory, skills |
+| `ciel.orchestration` | Multi-agent orchestration, durable state, supervisor |
+| `ciel.gateway` | Platform adapters, messaging gateway |
+| `ciel.security` | Approvals, secret redaction, PII scrubber, sandbox |
+| `ciel.observability` | Traces, logs, metrics, audit |
+| `ciel.entorno` | Execution backends: local, docker, ssh, processpool |
+| `ciel.acp` | ACP server for IDE integrations |
+
+## Installation
+
+```bash
+pip install mana-ciel        # PyPI distribution name
+# or, with uv:
+uv pip install mana-ciel
+```
+
+The import name stays `ciel`; the CLI command is `ciel`:
+
+```bash
+ciel --help
+```
+
+> Note: the PyPI package is named **mana-ciel** (the name `ciel` was already taken
+> on PyPI). You still `import ciel` and run `ciel` — only the install name differs.
+
+## Requirements
+
+- Python >= 3.11
+- Package manager/distribution: **uv** (recommended) or pip
+
+## Example
+
+End-to-end offline demo: `examples/end_to_end.py`
+
+```bash
+uv run examples/end_to_end.py
+```
+
+Covers:
+- wiring 3 tools through `ciel.runtime.tools`
+- running `DefaultAgentRuntime`
+- persisting state with `MemoryStore`
+- checkpoint/restore with `CheckpointStore`
+
+## Status
+
+### Fase 1 — Runtime básico: ✅ Cerrada
+- `ciel.providers` OpenAI-compatible y Anthropic
+- runtime agent loop con tool_calls
+- tool registry/schema/dispatcher
+- memoria SQLite + FTS5
+- skills markdown + frontmatter
+- checkpoint store
+- project context discovery y render
+- context compression head/tail/rewrite
+- CLI: `ciel run`, `ciel chat -q`, `ciel compression`, `ciel checkpoints` y `ciel info`
+
+### Fase 2 — Gobierno enterprise: ✅ Cerrada
+- políticas de approval (manual / smart / yolo) y redacción integradas al runtime
+- redacción de secretos + PII scrubber
+- auditoría JSONL por session/tenant, traces por tool call
+- multi-tenancy en providers/sinks y validación explícita de `tenant_id`
+- credential pools, rotación, sandbox de ejecución
+
+### Fase 3 — Multiagente durable: ✅ Cerrada
+- orquestación durable por spec YAML (`AgentSpec`/`AgentStep`), supervisor con budget/rate-limit y topologías pipeline/fan-out/debate
+- `KanbanBoard` con filtros por status, assignee y tenant; métricas e índices
+- `DurableQueue` SQLite WAL
+- CLI: `ciel swarm run`, `ciel board add/list/show/assign`
+
+### Fase 4 — Superficies y despliegue: ✅ Cerrada
+- `ciel serve` (FastAPI compuesta: control gateway + host MCP `/mcp` + router webhook), offline-safe con echo provider
+- `ciel.gateway.mcp` (cliente/servidor), `ciel.acp` (IDE)
+- Dockerfile multi-stage (uv), `docker-compose.yml`, Helm chart `deploy/helm/ciel`
+- `deploy/example-enterprise`, docs SDK públicas
+- release v0.1.0 (wheels + CHANGELOG)
+
+### Fase 5 — Orquestación best-of-breed: ✅ Cerrada (`graph`, `flows`, `chat`, `root`, `session` entregados)
+ADK.sub_agents + LangGraph + AutoGen.GroupChat + CrewAI.Flows.
+
+Entregado en esta sesión:
+- `ciel.orchestration.graph`: grafo de estado explícito (nodes/edges/estado) con checkpoint + reanudación/time-travel estilo LangGraph, montado sobre el `Supervisor` existente (hereda retry/timeout/budget).
+- `ciel.orchestration.flows` (CrewAI.Flows): flows event-driven con `add_start`/`add_listen`/`add_router`/`add_branch`, estado mutable compartido y `resume` de long-running tras interrupción, sobre `Supervisor`.
+- `ciel.orchestration.chat` (AutoGen.GroupChat): `GroupChat` + `GroupChatManager` multi-agente conversable, modelo-agnóstico y OFFLINE-SAFE (participantes = funciones locales sobre el transcripto; soporta `max_rounds`, `selector`, `terminate_keyword`, `terminate_if`).
+- `ciel.orchestration.root` (ADK.sub_agents): `RootAgent` con ROUTING a `Specialist` agents sobre `Supervisor` (`router(prompt) -> nombre | None`, con `root_handler` de respaldo).
+- `ciel.cli.graph`: `ciel graph demo|run|resume` (offline-safe).
+- `ciel.cli.flow`: `ciel flow run|resume` (offline-safe, checkpointer opcional).
+- `ciel.cli.chat`: `ciel chat group` (demo offline de 3 agentes que converge con TERMINATE).
+- Checkpoint stores (`Graph`/`Flow`/`GroupChat`/`Root`) persisten sobre `MemoryStore` (multitenancy nativo).
+- `ciel.orchestration.session` (ADK.session_state): `SessionStore` — session state persistente por tenant entre turnos, sobre `MemoryStore` (keys namespaced `session:`), con `append_turn`/`history`, `save_state`/`load_state`, `link_board_task`/`board_links` (integración board+session) y `list_sessions`.
+- `ciel.RootRunner.route(prompt, *, session_id, session_store, tenant_id)` mantiene el historial de turnos entre invocaciones (rehidrata `RootState.history`).
+- `ciel.cli.root`: `ciel root route <prompt>` (offline-safe, demo con 2 specialists + root handler; opciones `--db`/`--session-id`/`--tenant` para session state persistente).
+- Tests de Fase 5: 37 tests verdes (graph 6, flows 6, chat 7, root 7, session 6, root+session 5).
+
+Verificación actual: `uv run pytest tests/` → 153 passed, 1 skipped. `uv run ciel graph demo`, `uv run ciel flow run`, `uv run ciel chat group` y `uv run ciel root route` ejecutan offline.
+
+### Fase 6 — Agencia autónoma en bucle: ✅ Cerrada (`agent` entregado)
+AutoGen/ADK: `EventLoop` durable + `AutonomousAgent` sobre `Supervisor` y `SessionStore`.
+
+Entregado en esta sesión:
+- `ciel.orchestration.agent` (AutoGen/ADK): agencia autónoma en bucle montada SOBRE `Supervisor` (cada intento de tarea hereda retry/timeout/budget) y SOBRE `SessionStore` (estado por tenant).
+  - `Task`: unidad de trabajo durable (`goal`, `payload`, `status`, `attempts`, `result`, `error`) con `snapshot()`/`from_snapshot()` y `mark_running()`/`mark_succeeded()`/`mark_failed()`.
+  - `EventLoop`: bucle durable con reintentos exponenciales (backoff `base_delay_s * 2^(n-1)` capped). `run(task, handler, *, run_id)` ejecuta con reintentos y persiste checkpoint tras cada intento; `resume(run_id, handler)` rehidrata desde `MemoryStore` y continúa, completando la tarea tras reinicio (criterio Fase 6). Idempotente si el checkpoint ya está `succeeded`/`failed`.
+  - `EventLoopCheckpointStore`: persistencia del estado del loop sobre `MemoryStore` (clave `loop:<run_id>`, multitenancy nativo).
+  - `AutonomousAgent`: orquestador de nivel superior; `run_goal(goal, handler, *, plan=None)` descompone el objetivo en tareas y las ejecuta vía `EventLoop`, persistiendo turnos de session por tenant.
+- `ciel.cli.loop`: `ciel loop run <goal>` (offline-safe, handler echo local; `--run-id`/`--db`/`--tenant`/`--session-id`) y `ciel loop resume --run-id <id> --db <db>` (reanuda tras reinicio).
+- Tests de Fase 6: batería verde en `tests/test_agent_fase6_test.py`.
+
+Verificación actual: `uv run pytest tests/` → 153 + N passed, 1 skipped. `uv run ciel loop run "..." --db /tmp/l.sqlite3 --tenant t1` y `uv run ciel loop resume --run-id <id> --db /tmp/l.sqlite3` ejecutan offline.
+
+### Fase 7 — Enterprise duro: ✅ Cerrada (`enterprise` entregado)
+RBAC/OIDC, audit inmutable, cost governance, secrets, rate-limit transversal.
+
+Entregado en esta sesión:
+- `ciel.enterprise` (OFFLINE-SAFE, sin dependencias duras): paquete de enterprise duro.
+  - `ciel.enterprise.rbac`: `RBACEngine` (roles admin/operator/viewer; permisos con comodín `category:*`; orden tenant>global>denegado) + `OIDCVerifier` (JWT local, `OIDC_AVAILABLE` por detección de PyJWT). Excepciones `RBACError`, `FeatureUnavailable`.
+  - `ciel.enterprise.audit`: `HashChainAuditSink(JsonlAuditSink)` — audit INMUTABLE (append-only hash-chained SHA-256); `verify()` detecta alteración; `last_hash()` para encadenar.
+  - `ciel.enterprise.cost`: `CostGovernor` (presupuesto por modelo/tenant, alertas y corte) — `estimate`/`record`/`spent`/`budget_of`/`remaining`/`allowed`/`check_budget` (lanza `BudgetExceededError`) / `alerted`. Capa transversal (no acopla al `Supervisor`).
+  - `ciel.enterprise.secrets`: `SecretStore` con backends pluggable por prioridad — `EnvSecretBackend`, `KubernetesSecretBackend` (OFFLINE-SAFE), `VaultSecretBackend` (requiere `hvac`; degrada a `FeatureUnavailable` si falta). `get`/`require` (lanza `SecretError`).
+  - `ciel.enterprise.ratelimit`: `TenantRateLimiter` — cuotas transversales por tenant/usuario con ventana deslizante en memoria; `check`/`consume` (lanza `RateLimitError`) / `reset` / `remaining`.
+- `ciel rbac` / `ciel cost`: CLI offline-safe (Typer + Rich). `ciel rbac check|assign|list-roles`; `ciel cost record|status|check`.
+- Tests de Fase 7: 29 tests verdes (rbac 7, audit 5, cost 6, secrets 5, ratelimit 6).
+
+Verificación actual: `uv run pytest tests/` → 194 passed, 1 skipped. `uv run ciel rbac list-roles` y `uv run ciel cost status --tenant t1` ejecutan offline.
+
+### Fase 8 — Deploy HA + observabilidad + madurez: 🔄 EN PROGRESO
+Helm HA, OTel centralizado, adapters de canal y HIL en grafo ya entregados y verificados por smoke test; tests formales, runbooks y release v0.2.0 en curso.
+
+Entregado en esta sesión:
+- **Helm HA**: chart `deploy/helm/ciel` con `replicaCount: 2`, `PodDisruptionBudget` (minAvailable 1), `HorizontalPodAutoscaler` (2–10 réplicas), `podAntiAffinity` y `topologySpreadConstraints`.
+- **OTel centralizado** (`ciel.observability.otel`): `init_tracing(*, otlp_endpoint)` (OTLP o in-memory offline-safe), `current_tracer()`, `span_count()` (corregido para opentelemetry-sdk 1.x). Comando `ciel observe` y flag `--otel`/`--otel-endpoint` en `ciel serve`.
+- **Adapters de canal** (`ciel.adapters`): `TeamsAdapter`, `DiscordAdapter`, `WebUIAdapter` + `FakeAdapter` (offline-safe).
+- **Routers de gateway** (`ciel.gateway.messaging`): `create_teams_webhook_router`, `create_discord_webhook_router`, `create_webui_router`, montados en `ciel serve`.
+- **Human-in-the-loop (HIL)** en `ciel.orchestration.graph`: `GraphNode.require_approval`, `GraphRunner.approve()`/`deny()` con chequeo RBAC (`approve:*`). Pausa y reanuda tras aprobación de rol autorizado.
+- **Runbooks** (`docs/runbooks/`): deploy, incidente, rollback, backup de audit/board, escalado HPA.
+
+Verificación actual (smoke): `ciel observe` confirma exporter; grafo con `require_approval` pausa y reanuda tras `approve:*`; tests formales de Fase 8 en curso (`test_fase8_hil_otel_test.py`, `test_fase8_adapters_test.py`).
+
+## License
+
+- Core framework: **AGPL-3.0-or-later**
+- Commercial dual license available for regulated deployments.

mana_ciel-0.2.0/README.md

@@ -0,0 +1,152 @@
+# Ciel Agent Framework
+
+Enterprise-grade framework to build model-agnostic, deploy-agnostic autonomous agents and multi-agent systems with harness-first principles.
+
+## Packages
+
+| Package | Purpose |
+|---|---|
+| `ciel` | Public SDK, CLI entrypoint |
+| `ciel.providers` | Model provider interface + adapters |
+| `ciel.runtime` | Agent runtime, tooling, memory, skills |
+| `ciel.orchestration` | Multi-agent orchestration, durable state, supervisor |
+| `ciel.gateway` | Platform adapters, messaging gateway |
+| `ciel.security` | Approvals, secret redaction, PII scrubber, sandbox |
+| `ciel.observability` | Traces, logs, metrics, audit |
+| `ciel.entorno` | Execution backends: local, docker, ssh, processpool |
+| `ciel.acp` | ACP server for IDE integrations |
+
+## Installation
+
+```bash
+pip install mana-ciel        # PyPI distribution name
+# or, with uv:
+uv pip install mana-ciel
+```
+
+The import name stays `ciel`; the CLI command is `ciel`:
+
+```bash
+ciel --help
+```
+
+> Note: the PyPI package is named **mana-ciel** (the name `ciel` was already taken
+> on PyPI). You still `import ciel` and run `ciel` — only the install name differs.
+
+## Requirements
+
+- Python >= 3.11
+- Package manager/distribution: **uv** (recommended) or pip
+
+## Example
+
+End-to-end offline demo: `examples/end_to_end.py`
+
+```bash
+uv run examples/end_to_end.py
+```
+
+Covers:
+- wiring 3 tools through `ciel.runtime.tools`
+- running `DefaultAgentRuntime`
+- persisting state with `MemoryStore`
+- checkpoint/restore with `CheckpointStore`
+
+## Status
+
+### Fase 1 — Runtime básico: ✅ Cerrada
+- `ciel.providers` OpenAI-compatible y Anthropic
+- runtime agent loop con tool_calls
+- tool registry/schema/dispatcher
+- memoria SQLite + FTS5
+- skills markdown + frontmatter
+- checkpoint store
+- project context discovery y render
+- context compression head/tail/rewrite
+- CLI: `ciel run`, `ciel chat -q`, `ciel compression`, `ciel checkpoints` y `ciel info`
+
+### Fase 2 — Gobierno enterprise: ✅ Cerrada
+- políticas de approval (manual / smart / yolo) y redacción integradas al runtime
+- redacción de secretos + PII scrubber
+- auditoría JSONL por session/tenant, traces por tool call
+- multi-tenancy en providers/sinks y validación explícita de `tenant_id`
+- credential pools, rotación, sandbox de ejecución
+
+### Fase 3 — Multiagente durable: ✅ Cerrada
+- orquestación durable por spec YAML (`AgentSpec`/`AgentStep`), supervisor con budget/rate-limit y topologías pipeline/fan-out/debate
+- `KanbanBoard` con filtros por status, assignee y tenant; métricas e índices
+- `DurableQueue` SQLite WAL
+- CLI: `ciel swarm run`, `ciel board add/list/show/assign`
+
+### Fase 4 — Superficies y despliegue: ✅ Cerrada
+- `ciel serve` (FastAPI compuesta: control gateway + host MCP `/mcp` + router webhook), offline-safe con echo provider
+- `ciel.gateway.mcp` (cliente/servidor), `ciel.acp` (IDE)
+- Dockerfile multi-stage (uv), `docker-compose.yml`, Helm chart `deploy/helm/ciel`
+- `deploy/example-enterprise`, docs SDK públicas
+- release v0.1.0 (wheels + CHANGELOG)
+
+### Fase 5 — Orquestación best-of-breed: ✅ Cerrada (`graph`, `flows`, `chat`, `root`, `session` entregados)
+ADK.sub_agents + LangGraph + AutoGen.GroupChat + CrewAI.Flows.
+
+Entregado en esta sesión:
+- `ciel.orchestration.graph`: grafo de estado explícito (nodes/edges/estado) con checkpoint + reanudación/time-travel estilo LangGraph, montado sobre el `Supervisor` existente (hereda retry/timeout/budget).
+- `ciel.orchestration.flows` (CrewAI.Flows): flows event-driven con `add_start`/`add_listen`/`add_router`/`add_branch`, estado mutable compartido y `resume` de long-running tras interrupción, sobre `Supervisor`.
+- `ciel.orchestration.chat` (AutoGen.GroupChat): `GroupChat` + `GroupChatManager` multi-agente conversable, modelo-agnóstico y OFFLINE-SAFE (participantes = funciones locales sobre el transcripto; soporta `max_rounds`, `selector`, `terminate_keyword`, `terminate_if`).
+- `ciel.orchestration.root` (ADK.sub_agents): `RootAgent` con ROUTING a `Specialist` agents sobre `Supervisor` (`router(prompt) -> nombre | None`, con `root_handler` de respaldo).
+- `ciel.cli.graph`: `ciel graph demo|run|resume` (offline-safe).
+- `ciel.cli.flow`: `ciel flow run|resume` (offline-safe, checkpointer opcional).
+- `ciel.cli.chat`: `ciel chat group` (demo offline de 3 agentes que converge con TERMINATE).
+- Checkpoint stores (`Graph`/`Flow`/`GroupChat`/`Root`) persisten sobre `MemoryStore` (multitenancy nativo).
+- `ciel.orchestration.session` (ADK.session_state): `SessionStore` — session state persistente por tenant entre turnos, sobre `MemoryStore` (keys namespaced `session:`), con `append_turn`/`history`, `save_state`/`load_state`, `link_board_task`/`board_links` (integración board+session) y `list_sessions`.
+- `ciel.RootRunner.route(prompt, *, session_id, session_store, tenant_id)` mantiene el historial de turnos entre invocaciones (rehidrata `RootState.history`).
+- `ciel.cli.root`: `ciel root route <prompt>` (offline-safe, demo con 2 specialists + root handler; opciones `--db`/`--session-id`/`--tenant` para session state persistente).
+- Tests de Fase 5: 37 tests verdes (graph 6, flows 6, chat 7, root 7, session 6, root+session 5).
+
+Verificación actual: `uv run pytest tests/` → 153 passed, 1 skipped. `uv run ciel graph demo`, `uv run ciel flow run`, `uv run ciel chat group` y `uv run ciel root route` ejecutan offline.
+
+### Fase 6 — Agencia autónoma en bucle: ✅ Cerrada (`agent` entregado)
+AutoGen/ADK: `EventLoop` durable + `AutonomousAgent` sobre `Supervisor` y `SessionStore`.
+
+Entregado en esta sesión:
+- `ciel.orchestration.agent` (AutoGen/ADK): agencia autónoma en bucle montada SOBRE `Supervisor` (cada intento de tarea hereda retry/timeout/budget) y SOBRE `SessionStore` (estado por tenant).
+  - `Task`: unidad de trabajo durable (`goal`, `payload`, `status`, `attempts`, `result`, `error`) con `snapshot()`/`from_snapshot()` y `mark_running()`/`mark_succeeded()`/`mark_failed()`.
+  - `EventLoop`: bucle durable con reintentos exponenciales (backoff `base_delay_s * 2^(n-1)` capped). `run(task, handler, *, run_id)` ejecuta con reintentos y persiste checkpoint tras cada intento; `resume(run_id, handler)` rehidrata desde `MemoryStore` y continúa, completando la tarea tras reinicio (criterio Fase 6). Idempotente si el checkpoint ya está `succeeded`/`failed`.
+  - `EventLoopCheckpointStore`: persistencia del estado del loop sobre `MemoryStore` (clave `loop:<run_id>`, multitenancy nativo).
+  - `AutonomousAgent`: orquestador de nivel superior; `run_goal(goal, handler, *, plan=None)` descompone el objetivo en tareas y las ejecuta vía `EventLoop`, persistiendo turnos de session por tenant.
+- `ciel.cli.loop`: `ciel loop run <goal>` (offline-safe, handler echo local; `--run-id`/`--db`/`--tenant`/`--session-id`) y `ciel loop resume --run-id <id> --db <db>` (reanuda tras reinicio).
+- Tests de Fase 6: batería verde en `tests/test_agent_fase6_test.py`.
+
+Verificación actual: `uv run pytest tests/` → 153 + N passed, 1 skipped. `uv run ciel loop run "..." --db /tmp/l.sqlite3 --tenant t1` y `uv run ciel loop resume --run-id <id> --db /tmp/l.sqlite3` ejecutan offline.
+
+### Fase 7 — Enterprise duro: ✅ Cerrada (`enterprise` entregado)
+RBAC/OIDC, audit inmutable, cost governance, secrets, rate-limit transversal.
+
+Entregado en esta sesión:
+- `ciel.enterprise` (OFFLINE-SAFE, sin dependencias duras): paquete de enterprise duro.
+  - `ciel.enterprise.rbac`: `RBACEngine` (roles admin/operator/viewer; permisos con comodín `category:*`; orden tenant>global>denegado) + `OIDCVerifier` (JWT local, `OIDC_AVAILABLE` por detección de PyJWT). Excepciones `RBACError`, `FeatureUnavailable`.
+  - `ciel.enterprise.audit`: `HashChainAuditSink(JsonlAuditSink)` — audit INMUTABLE (append-only hash-chained SHA-256); `verify()` detecta alteración; `last_hash()` para encadenar.
+  - `ciel.enterprise.cost`: `CostGovernor` (presupuesto por modelo/tenant, alertas y corte) — `estimate`/`record`/`spent`/`budget_of`/`remaining`/`allowed`/`check_budget` (lanza `BudgetExceededError`) / `alerted`. Capa transversal (no acopla al `Supervisor`).
+  - `ciel.enterprise.secrets`: `SecretStore` con backends pluggable por prioridad — `EnvSecretBackend`, `KubernetesSecretBackend` (OFFLINE-SAFE), `VaultSecretBackend` (requiere `hvac`; degrada a `FeatureUnavailable` si falta). `get`/`require` (lanza `SecretError`).
+  - `ciel.enterprise.ratelimit`: `TenantRateLimiter` — cuotas transversales por tenant/usuario con ventana deslizante en memoria; `check`/`consume` (lanza `RateLimitError`) / `reset` / `remaining`.
+- `ciel rbac` / `ciel cost`: CLI offline-safe (Typer + Rich). `ciel rbac check|assign|list-roles`; `ciel cost record|status|check`.
+- Tests de Fase 7: 29 tests verdes (rbac 7, audit 5, cost 6, secrets 5, ratelimit 6).
+
+Verificación actual: `uv run pytest tests/` → 194 passed, 1 skipped. `uv run ciel rbac list-roles` y `uv run ciel cost status --tenant t1` ejecutan offline.
+
+### Fase 8 — Deploy HA + observabilidad + madurez: 🔄 EN PROGRESO
+Helm HA, OTel centralizado, adapters de canal y HIL en grafo ya entregados y verificados por smoke test; tests formales, runbooks y release v0.2.0 en curso.
+
+Entregado en esta sesión:
+- **Helm HA**: chart `deploy/helm/ciel` con `replicaCount: 2`, `PodDisruptionBudget` (minAvailable 1), `HorizontalPodAutoscaler` (2–10 réplicas), `podAntiAffinity` y `topologySpreadConstraints`.
+- **OTel centralizado** (`ciel.observability.otel`): `init_tracing(*, otlp_endpoint)` (OTLP o in-memory offline-safe), `current_tracer()`, `span_count()` (corregido para opentelemetry-sdk 1.x). Comando `ciel observe` y flag `--otel`/`--otel-endpoint` en `ciel serve`.
+- **Adapters de canal** (`ciel.adapters`): `TeamsAdapter`, `DiscordAdapter`, `WebUIAdapter` + `FakeAdapter` (offline-safe).
+- **Routers de gateway** (`ciel.gateway.messaging`): `create_teams_webhook_router`, `create_discord_webhook_router`, `create_webui_router`, montados en `ciel serve`.
+- **Human-in-the-loop (HIL)** en `ciel.orchestration.graph`: `GraphNode.require_approval`, `GraphRunner.approve()`/`deny()` con chequeo RBAC (`approve:*`). Pausa y reanuda tras aprobación de rol autorizado.
+- **Runbooks** (`docs/runbooks/`): deploy, incidente, rollback, backup de audit/board, escalado HPA.
+
+Verificación actual (smoke): `ciel observe` confirma exporter; grafo con `require_approval` pausa y reanuda tras `approve:*`; tests formales de Fase 8 en curso (`test_fase8_hil_otel_test.py`, `test_fase8_adapters_test.py`).
+
+## License
+
+- Core framework: **AGPL-3.0-or-later**
+- Commercial dual license available for regulated deployments.

mana_ciel-0.2.0/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mana-ciel"
+version = "0.2.0"
+description = "Ciel Agent Framework - Enterprise multi-agent harness, model-agnostic, deploy-agnostic"
+readme = "README.md"
+license = { text = "AGPL-3.0-or-later" }
+requires-python = ">=3.11"
+authors = [
+    { name = "Ciel Agent Framework Authors" }
+]
+keywords = ["agent", "harness", "multi-agent", "orchestration", "llm", "enterprise"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+]
+
+dependencies = [
+    "pydantic>=2.6",
+    "pyyaml>=6.0",
+    "sqlalchemy>=2.0",
+    "aiofiles>=23.2",
+    "httpx>=0.27",
+    "tenacity>=9.0",
+    "rich>=13.7",
+    "typer>=0.12",
+    "croniter>=5.0",
+    "python-dotenv>=1.0",
+    "uv>=0.5",
+]
+
+[project.urls]
+Homepage = "https://github.com/Ander-Labs/ciel-agent-framework"
+Repository = "https://github.com/Ander-Labs/ciel-agent-framework"
+Issues = "https://github.com/Ander-Labs/ciel-agent-framework/issues"
+Changelog = "https://github.com/Ander-Labs/ciel-agent-framework/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-asyncio>=0.24"]
+docs = ["mkdocs-material", "mkdocstrings[python]"]
+acp = ["fastapi>=0.112", "uvicorn>=0.30"]
+gateway = ["fastapi>=0.112", "uvicorn>=0.30", "mcp>=1.2"]
+security = ["python-dotenv>=1.0"]
+observability = ["opentelemetry-api>=1.20", "opentelemetry-sdk>=1.20", "prometheus-client>=0.20"]
+messaging = ["slack-sdk>=3.27"]
+board = ["sqlalchemy>=2.0"]
+
+[project.scripts]
+ciel = "ciel.cli.main:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.ruff]
+target-version = "py314"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+ignore = ["E501", "B008"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

mana_ciel-0.2.0/setup.cfg

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

mana_ciel-0.2.0/src/ciel/__init__.py

@@ -0,0 +1,10 @@
+from importlib.metadata import version as _pkg_version, PackageNotFoundError
+
+try:
+    __version__ = _pkg_version("ciel")
+except PackageNotFoundError:  # pragma: no cover
+    __version__ = "0.1.0"
+
+from ciel.security import ApprovalPolicy
+
+__all__ = ["__version__", "ApprovalPolicy"]