cfa-kernel 0.1.0__tar.gz → 0.1.2__tar.gz

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/CFA_IMPLEMENTATION_PLAN.md

@@ -461,7 +461,7 @@ MCP Server CFA — Tools expostas:
 - `pyproject.toml` — `[project.scripts] cfa-mcp = "cfa.mcp:main"`
 - `mcp.json` — configuração exemplo para Claude Desktop, Cursor, etc.
 
-**Dependências:** `mcp` package (extras_require: `pip install cfa[mcp]`)
+**Dependências:** `mcp` package (extras_require: `pip install cfa-kernel[mcp]`)
 
 ---
 
@@ -548,7 +548,7 @@ enable_otel(OTELConfig(
 
 **Arquivos:**
 - `src/cfa/otel.py` — `enable_otel()`, `OTELConfig`, instrumentação do pipeline
-- Dependência: `opentelemetry-api` + `opentelemetry-sdk` (extras_require: `pip install cfa[otel]`)
+- Dependência: `opentelemetry-api` + `opentelemetry-sdk` (extras_require: `pip install cfa-kernel[otel]`)
 
 ---
 
@@ -697,12 +697,12 @@ cfa_lifecycle_index{pipeline="fiscal_monthly", index="idi"} 0.88
 #### Sprint 13: PyPI Release + Community Setup (Dias 81-90)
 
 **Release v0.1.0:**
-- `pip install cfa` (core)
-- `pip install cfa[cli]` (CLI)
-- `pip install cfa[mcp]` (MCP server)
-- `pip install cfa[otel]` (OpenTelemetry)
-- `pip install cfa[langgraph]` (LangGraph adapter)
-- `pip install cfa[all]` (tudo)
+- `pip install cfa-kernel` (core)
+- `pip install cfa-kernel[cli]` (CLI)
+- `pip install cfa-kernel[mcp]` (MCP server)
+- `pip install cfa-kernel[otel]` (OpenTelemetry)
+- `pip install cfa-kernel[langgraph]` (LangGraph adapter)
+- `pip install cfa-kernel[all]` (tudo)
 
 **Community:**
 - `cfa` package no PyPI

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cfa-kernel
-Version: 0.1.0
+Version: 0.1.2
 Summary: CFA — Governed execution for AI agents and data systems
 Project-URL: Homepage, https://marquesantero.github.io/cfa/
 Project-URL: Repository, https://github.com/marquesantero/cfa

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/README.md

@@ -3,6 +3,7 @@
 [![CI](https://github.com/marquesantero/cfa/actions/workflows/ci.yml/badge.svg)](https://github.com/marquesantero/cfa/actions/workflows/ci.yml)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 [![Tests](https://img.shields.io/badge/tests-536%20passed-brightgreen)](https://github.com/marquesantero/cfa/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/cfa-kernel)](https://pypi.org/project/cfa-kernel/)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 [![Docs](https://img.shields.io/badge/docs-docusaurus-blue.svg)](https://marquesantero.github.io/cfa/)
@@ -14,7 +15,7 @@ Instead of asking _"which agent or skill should act?"_, CFA asks _"which state t
 ## Quick Start
 
 ```bash
-pip install cfa
+pip install cfa-kernel
 # or: pip install git+https://github.com/marquesantero/cfa.git
 cfa init
 cfa evaluate "Join NFe with Clientes and persist to Silver" --catalog .cfa/catalog.json

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cfa-kernel"
-version = "0.1.0"
+version = "0.1.2"
 description = "CFA — Governed execution for AI agents and data systems"
 requires-python = ">=3.11"
 license = { text = "MIT" }

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/src/cfa/__init__.py

@@ -6,7 +6,7 @@ Governed execution for AI agents and data systems.
 
 from cfa._lazy import LazyLoader
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 
 __getattr__ = LazyLoader({
     "KernelOrchestrator": ("cfa.core.kernel", "KernelOrchestrator"),

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/src/cfa/cli/formatters.py

@@ -17,7 +17,7 @@ _ANSI_RE = re.compile(r"\x1b\[[0-9;]*m")
 # Force UTF-8 on Windows if possible
 if sys.platform == "win32":
     try:
-        sys.stdout.reconfigure(encoding="utf-8")  # type: ignore[attr-defined]
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
     except Exception:
         pass
 

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/src/cfa/cli/governance/audit.py

@@ -50,16 +50,16 @@ def cmd_audit_verify(args) -> int:
         events = trail.get_events_for_intent(args.id)
         chain_ok = trail.verify_chain()
         if chain_ok:
-            print(f"\u2713 Chain INTACT for intent {args.id} ({len(events)} events)")
+            print(f"[OK] Chain INTACT for intent {args.id} ({len(events)} events)")
             return 0
         else:
-            print(f"\u2717 Chain BROKEN for intent {args.id}", file=sys.stderr)
+            print(f"[FAIL] Chain BROKEN for intent {args.id}", file=sys.stderr)
             return 1
     else:
         all_ok = trail.verify_chain()
         if all_ok:
-            print(f"\u2713 Chain INTACT ({trail.event_count} events total)")
+            print(f"[OK] Chain INTACT ({trail.event_count} events total)")
             return 0
         else:
-            print("\u2717 Chain BROKEN", file=sys.stderr)
+            print("[FAIL] Chain BROKEN", file=sys.stderr)
             return 1

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/src/cfa/cli/project/status.py

@@ -5,12 +5,24 @@ from __future__ import annotations
 from datetime import UTC
 
 
+def _load_config(config_path: str | None):
+    from cfa.config import CfaConfig
+    if config_path:
+        try:
+            return CfaConfig.from_yaml(config_path)
+        except ImportError:
+            try:
+                return CfaConfig.from_json(config_path)
+            except Exception:
+                return None
+    return CfaConfig.discover()
+
+
 def cmd_status(args) -> int:
     from cfa.cli.formatters import format_json
-    from cfa.config import CfaConfig
     from cfa.storage import SqliteStorage, _sqlite_storage_stats
 
-    config = CfaConfig.discover() if args.config is None else CfaConfig.from_yaml(args.config)
+    config = _load_config(args.config)
 
     output = {
         "config_found": config is not None,

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/src/cfa/observability/promotion.py

@@ -26,13 +26,25 @@ Every promoted skill carries generation_metadata for traceability.
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from datetime import datetime
+from datetime import datetime, timezone
 from enum import StrEnum
-from typing import Any
 
 from cfa.observability.indices import ExecutionRecord, IndexCalculator, IndexScores
 from cfa.types import _utcnow
 
+
+def _parse_storage_timestamp(ts: str) -> datetime | None:
+    """Parse a storage timestamp string to timezone-aware datetime."""
+    if not ts:
+        return None
+    try:
+        dt = datetime.fromisoformat(ts)
+        if dt.tzinfo is None:
+            dt = dt.replace(tzinfo=timezone.utc)
+        return dt
+    except (ValueError, TypeError):
+        return None
+
 # ── Lifecycle States ────────────────────────────────────────────────────────
 
 
@@ -140,7 +152,7 @@ class PromotionEngine:
         for rec_dict in self._storage.execution_load_all():
             self._records.append(ExecutionRecord(
                 signature_hash=rec_dict["signature_hash"],
-                timestamp=datetime.fromisoformat(rec_dict["timestamp"]) if rec_dict.get("timestamp") else _utcnow(),
+                timestamp=_parse_storage_timestamp(rec_dict.get("timestamp", "")) or _utcnow(),
                 success=rec_dict.get("success", True),
                 replanned=rec_dict.get("replanned", False),
                 cost_dbu=rec_dict.get("cost_dbu", 0.0),

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/src/cfa/testing/fixtures.py

@@ -15,12 +15,17 @@ from __future__ import annotations
 
 from typing import Any
 
-import pytest
+try:
+    import pytest
+except ImportError:
+    pytest = None  # type: ignore[assignment]
 
 from cfa.core.kernel import KernelConfig, KernelOrchestrator
 
 from ..sandbox.mock import MockSandboxBackend
 
+_fixture = pytest.fixture if pytest else (lambda f: f)
+
 DEFAULT_CATALOG = {
     "datasets": {
         "nfe": {
@@ -44,13 +49,13 @@ DEFAULT_CATALOG = {
 }
 
 
-@pytest.fixture
+@_fixture
 def cfa_catalog() -> dict[str, Any]:
     """Default data catalog for governance tests."""
     return DEFAULT_CATALOG
 
 
-@pytest.fixture
+@_fixture
 def cfa_kernel(cfa_catalog: dict[str, Any]) -> KernelOrchestrator:
     """Pre-configured KernelOrchestrator for testing.
 
@@ -64,7 +69,7 @@ def cfa_kernel(cfa_catalog: dict[str, Any]) -> KernelOrchestrator:
     )
 
 
-@pytest.fixture
+@_fixture
 def cfa_strict_kernel(cfa_catalog: dict[str, Any]) -> KernelOrchestrator:
     """KernelOrchestrator with warnings treated as blocking."""
     return KernelOrchestrator(
@@ -74,7 +79,7 @@ def cfa_strict_kernel(cfa_catalog: dict[str, Any]) -> KernelOrchestrator:
     )
 
 
-@pytest.fixture
+@_fixture
 def cfa_noexec_kernel(cfa_catalog: dict[str, Any]) -> KernelOrchestrator:
     """KernelOrchestrator with execution disabled (policy-only gate)."""
     return KernelOrchestrator(

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/tests/test_user_journeys.py

@@ -34,7 +34,7 @@ class TestJourney1_FirstTimeUser:
     def test_01_install_and_version(self):
         """User: pip install cfa && python -c 'import cfa; print(cfa.__version__)'"""
         import cfa
-        assert cfa.__version__ == "0.1.0"
+        assert cfa.__version__.startswith("0.1.")
 
     def test_02_first_evaluate(self):
         """User: cfa evaluate 'my first governance check'"""

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/website/docs/getting-started.md

@@ -14,7 +14,7 @@ Install CFA and run your first governance check in under 5 minutes.
 ## Installation
 
 ```bash
-pip install cfa
+pip install cfa-kernel
 # or directly from GitHub:
 # pip install git+https://github.com/marquesantero/cfa.git
 ```
@@ -22,11 +22,11 @@ pip install cfa
 Optional features:
 
 ```bash
-pip install cfa[yaml]       # YAML policy bundles
-pip install cfa[llm]        # LLM-powered intent normalization (OpenAI)
-pip install cfa[otel]       # OpenTelemetry tracing
-pip install cfa[mcp]        # MCP server protocol
-pip install cfa[all]        # Everything
+pip install cfa-kernel[yaml]       # YAML policy bundles
+pip install cfa-kernel[llm]        # LLM-powered intent normalization (OpenAI)
+pip install cfa-kernel[otel]       # OpenTelemetry tracing
+pip install cfa-kernel[mcp]        # MCP server protocol
+pip install cfa-kernel[all]        # Everything
 ```
 
 ## Initialize a project

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/website/docs/intro.md

@@ -21,7 +21,7 @@ CFA is a governance layer that validates state transitions before they execute.
 ## Quick Install
 
 ```bash
-pip install cfa
+pip install cfa-kernel
 # or: pip install git+https://github.com/marquesantero/cfa.git
 cfa init
 cfa evaluate "Join NFe with Clientes and persist to Silver" --catalog .cfa/catalog.json

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/website/docs/mcp-server.md

@@ -9,7 +9,7 @@ CFA exposes its governance tools via the **Model Context Protocol** (MCP), allow
 ## Quick Start
 
 ```bash
-pip install cfa[mcp]
+pip install cfa-kernel[mcp]
 cfa-mcp
 ```
 

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/website/docusaurus.config.ts

@@ -97,7 +97,7 @@ const config: Config = {
           items: [
             { label: 'Blog', to: '/blog' },
             { label: 'GitHub', href: 'https://github.com/marquesantero/cfa' },
-            { label: 'PyPI', href: 'https://pypi.org/project/cfa/' },
+            { label: 'PyPI', href: 'https://pypi.org/project/cfa-kernel/' },
           ],
         },
       ],

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/getting-started.md

@@ -14,7 +14,7 @@ Instale o CFA e execute sua primeira verificação de governança em menos de 5
 ## Instalação
 
 ```bash
-pip install cfa
+pip install cfa-kernel
 # ou diretamente do GitHub:
 # pip install git+https://github.com/marquesantero/cfa.git
 ```
@@ -22,11 +22,11 @@ pip install cfa
 Funcionalidades opcionais:
 
 ```bash
-pip install cfa[yaml]       # Policy bundles YAML
-pip install cfa[llm]        # Normalização de intenção com LLM (OpenAI)
-pip install cfa[otel]       # Tracing OpenTelemetry
-pip install cfa[mcp]        # Protocolo servidor MCP
-pip install cfa[all]        # Tudo
+pip install cfa-kernel[yaml]       # Policy bundles YAML
+pip install cfa-kernel[llm]        # Normalização de intenção com LLM (OpenAI)
+pip install cfa-kernel[otel]       # Tracing OpenTelemetry
+pip install cfa-kernel[mcp]        # Protocolo servidor MCP
+pip install cfa-kernel[all]        # Tudo
 ```
 
 ## Inicializar um projeto

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/intro.md

@@ -21,7 +21,7 @@ CFA é uma camada de governança que valida transições de estado antes da exec
 ## Instalação Rápida
 
 ```bash
-pip install cfa
+pip install cfa-kernel
 cfa init
 cfa evaluate "Juntar NFe com Clientes e persistir na Silver" --catalog .cfa/catalog.json
 ```

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/mcp-server.md

@@ -9,7 +9,7 @@ CFA expõe suas ferramentas de governança via **Model Context Protocol** (MCP),
 ## Início Rápido
 
 ```bash
-pip install cfa[mcp]
+pip install cfa-kernel[mcp]
 cfa-mcp
 ```
 

{cfa_kernel-0.1.0 → cfa_kernel-0.1.2}/website/src/pages/index.tsx

@@ -92,7 +92,7 @@ export default function Home(): JSX.Element {
             background: 'rgba(0,0,0,0.3)', padding: '0.75rem 1.5rem',
             borderRadius: 8, fontSize: '0.95rem', color: '#3dffa0',
           }}>
-            pip install cfa && cfa evaluate "Join NFe with Clientes persist Silver"
+            pip install cfa-kernel && cfa evaluate "Join NFe with Clientes persist Silver"
           </code>
           <p style={{ color: '#8892a4', marginTop: '1rem', fontSize: '0.85rem' }}>
             343 tests &middot; MIT License &middot; Python 3.11+