ct-toolkit 0.3.9__tar.gz → 0.3.10__tar.gz

{ct_toolkit-0.3.9 → ct_toolkit-0.3.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ct-toolkit
-Version: 0.3.9
+Version: 0.3.10
 Summary: Computational Theseus Toolkit — Identity Continuity Guardrails for Agentic Systems
 Author: Hakan Damar
 License: Apache-2.0
@@ -49,6 +49,7 @@ Dynamic: license-file
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 [![PyPI version](https://img.shields.io/pypi/v/ct-toolkit.svg)](https://pypi.org/project/ct-toolkit/)
 [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue.svg)](https://hakandamar.github.io/ct-toolkit/)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/ct-toolkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=MAGENTA&left_text=downloads)](https://pepy.tech/projects/ct-toolkit)
 
 CT Toolkit is an open-source security layer designed to preserve the **identity continuity** of AI agents over time. It implements the **Nested Agency Architecture (NAA)** framework to prevent **Sequential Self-Compression (SSC)** in multi-agent hierarchies.
 
@@ -119,8 +120,9 @@ ct-toolkit list-templates
 
 | Metric           | Status                                                  |
 | :--------------- | :------------------------------------------------------ |
-| **Tests**        | ✅ 293/296 passing (89% coverage)                       |
-| **Last Phase**   | ✅ Phase 6: Auditor Mode (v0.3.9: Cooldown Integrated)  |
+| **Tests**        | ✅ 293 passed, 3 skipped, 13 warnings (93% coverage)                       |
+| **Downloads**    | [![PyPI Downloads](https://static.pepy.tech/personalized-badge/ct-toolkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=MAGENTA&left_text=downloads)](https://pepy.tech/projects/ct-toolkit) |
+| **Last Phase**   | ✅ Phase 6: Auditor Mode (v0.3.10: n8n Guardrail Node)  |
 | **Current Goal** | 🔶 Phase 7: Multi-Agent Synchronization (Integration)   |
 
 For a detailed breakdown of the 8-phase roadmap, see [**PROJECT_STATUS.md**](docs/PROJECT_STATUS.md).

{ct_toolkit-0.3.9 → ct_toolkit-0.3.10}/README.md

@@ -6,6 +6,7 @@
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 [![PyPI version](https://img.shields.io/pypi/v/ct-toolkit.svg)](https://pypi.org/project/ct-toolkit/)
 [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue.svg)](https://hakandamar.github.io/ct-toolkit/)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/ct-toolkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=MAGENTA&left_text=downloads)](https://pepy.tech/projects/ct-toolkit)
 
 CT Toolkit is an open-source security layer designed to preserve the **identity continuity** of AI agents over time. It implements the **Nested Agency Architecture (NAA)** framework to prevent **Sequential Self-Compression (SSC)** in multi-agent hierarchies.
 
@@ -76,8 +77,9 @@ ct-toolkit list-templates
 
 | Metric           | Status                                                  |
 | :--------------- | :------------------------------------------------------ |
-| **Tests**        | ✅ 293/296 passing (89% coverage)                       |
-| **Last Phase**   | ✅ Phase 6: Auditor Mode (v0.3.9: Cooldown Integrated)  |
+| **Tests**        | ✅ 293 passed, 3 skipped, 13 warnings (93% coverage)                       |
+| **Downloads**    | [![PyPI Downloads](https://static.pepy.tech/personalized-badge/ct-toolkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=MAGENTA&left_text=downloads)](https://pepy.tech/projects/ct-toolkit) |
+| **Last Phase**   | ✅ Phase 6: Auditor Mode (v0.3.10: n8n Guardrail Node)  |
 | **Current Goal** | 🔶 Phase 7: Multi-Agent Synchronization (Integration)   |
 
 For a detailed breakdown of the 8-phase roadmap, see [**PROJECT_STATUS.md**](docs/PROJECT_STATUS.md).

{ct_toolkit-0.3.9 → ct_toolkit-0.3.10}/ct_toolkit/cli.py

@@ -167,6 +167,53 @@ def serve(
         console.print(f"[bold red]Failed to start server:[/bold red] {e}")
         raise typer.Exit(code=1)
 
+@app.command()
+def setup(
+    profile: str = typer.Argument("personal_kernel", help="Name of the profile to download (e.g., personal_kernel)"),
+    repo_branch: str = typer.Option("main", "--branch", help="GitHub repo branch"),
+    dest_dir: str = typer.Option("./config", "--dest", help="Destination folder (default: ./config)")
+):
+    """Download a CT-Toolkit profile (kernel, identity, probes) from the official GitHub repository."""
+    import urllib.request
+    
+    base_url = f"https://raw.githubusercontent.com/hakandamar/ct-toolkit/{repo_branch}/examples/agent_dna_config"
+    target_dir = Path(dest_dir)
+    target_dir.mkdir(parents=True, exist_ok=True)
+    
+    base_name = profile.replace("_kernel", "") if profile.endswith("_kernel") else profile
+    if base_name == profile:
+        kernel_file = f"{profile}_kernel.yaml"
+    else:
+        kernel_file = f"{profile}.yaml"
+        
+    identity_file = f"{base_name}_identity.yaml"
+    probes_file = f"{base_name}_probes.json"
+    
+    files_to_download = [kernel_file, identity_file, probes_file]
+    
+    with console.status(f"[bold green]Downloading '{profile}' profile from GitHub...[/bold green]"):
+        has_errors = False
+        for filename in files_to_download:
+            url = f"{base_url}/{filename}"
+            dest_path = target_dir / filename
+            try:
+                # Use a custom user agent to avoid 403s on some raw github requests occasionally
+                req = urllib.request.Request(url, headers={'User-Agent': 'Mozilla/5.0'})
+                with urllib.request.urlopen(req) as response:
+                    content = response.read()
+                    with open(dest_path, "wb") as f:
+                        f.write(content)
+                console.print(f"[green]✓ Saved {filename} to {dest_path}[/green]")
+            except Exception as e:
+                console.print(f"[red]✗ Failed to download {filename} from {url}:[/red] {e}")
+                has_errors = True
+                
+    if not has_errors:
+        console.print(f"\n[bold blue]Profile '{profile}' setup complete![/bold blue]")
+        console.print(f"You can now use this kernel by setting [bold]kernel_name='{kernel_file.replace('.yaml','')}'[/bold] in TheseusWrapper")
+    else:
+        console.print(f"\n[bold yellow]Profile '{profile}' setup finished with some errors.[/bold yellow]")
+
 @app.command()
 def list_kernels():
     """List available Constitutional Kernels."""

{ct_toolkit-0.3.9 → ct_toolkit-0.3.10}/ct_toolkit/divergence/analysis.py

@@ -42,6 +42,7 @@ class PolicyDriftAnalyzer:
 
     def __init__(self, log: ProvenanceLog) -> None:
         self._log = log
+        self._ssc_calc = SSCSeverityCalculator()
 
     def analyze_drift(
         self, 
@@ -87,8 +88,7 @@ class PolicyDriftAnalyzer:
         slope, _ = np.polyfit(x, scores, 1)
         
         # SSC Severity calculation (Risk-adjusted)
-        calc = SSCSeverityCalculator()
-        ssc_score, struct_risk = calc.calculate(
+        ssc_score, struct_risk = self._ssc_calc.calculate(
             mean_divergence=mean_div,
             velocity=slope,
             variance=var_div,

{ct_toolkit-0.3.9 → ct_toolkit-0.3.10}/ct_toolkit/divergence/engine.py

@@ -9,7 +9,7 @@ Wrapper uses this class. On every API call:
   L3 (ICM)   — triggered when L2 returns a problematic finding
                OR triggered by a periodic schedule
 
-In Enterprise mode, all tiers run all the time and
+In Rigorous mode, all tiers run all the time and
 action is taken based on the total score.
 """
 from __future__ import annotations

{ct_toolkit-0.3.9 → ct_toolkit-0.3.10}/ct_toolkit/endorsement/reflective.py

@@ -271,12 +271,12 @@ class StagedUpdateManager:
     """
 
     def __init__(self) -> None:
-        self._staged: list[EndorsementRecord] = []
+        self._staged: dict[str, EndorsementRecord] = {}
 
     def register(self, record: EndorsementRecord) -> None:
         """Registers a STAGED record for tracking."""
         if record.is_staged:
-            self._staged.append(record)
+            self._staged[record.id] = record
             logger.info(
                 f"StagedUpdateManager: registered staged endorsement "
                 f"id={record.id[:8]}... cooldown_until={record.cooldown_until}"
@@ -284,16 +284,16 @@ class StagedUpdateManager:
 
     def get_active(self) -> list[EndorsementRecord]:
         """Returns all staged endorsements still in their cooldown window."""
-        return [r for r in self._staged if not r.is_cooldown_expired]
+        return [r for r in self._staged.values() if not r.is_cooldown_expired]
 
     def get_promotable(self) -> list[EndorsementRecord]:
         """
         Returns staged endorsements whose cooldown has expired without
         being rejected. Removes them from the tracking list.
         """
-        promotable = [r for r in self._staged if r.is_cooldown_expired]
+        promotable = [r for r in self._staged.values() if r.is_cooldown_expired]
         for r in promotable:
-            self._staged.remove(r)
+            del self._staged[r.id]
         return promotable
 
     def reject_staged(self, record_id: str, reason: str = "") -> bool:
@@ -301,9 +301,8 @@ class StagedUpdateManager:
         Rejects and removes a staged endorsement (e.g. on CriticalDivergenceError).
         Returns True if found and removed.
         """
-        for r in self._staged:
-            if r.id == record_id:
-                self._staged.remove(r)
+        if record_id in self._staged:
+                del self._staged[record_id]
                 logger.warning(
                     f"StagedUpdateManager: staged endorsement REJECTED "
                     f"id={record_id[:8]}... reason={reason!r}"

{ct_toolkit-0.3.9 → ct_toolkit-0.3.10}/ct_toolkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ct-toolkit
-Version: 0.3.9
+Version: 0.3.10
 Summary: Computational Theseus Toolkit — Identity Continuity Guardrails for Agentic Systems
 Author: Hakan Damar
 License: Apache-2.0
@@ -49,6 +49,7 @@ Dynamic: license-file
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 [![PyPI version](https://img.shields.io/pypi/v/ct-toolkit.svg)](https://pypi.org/project/ct-toolkit/)
 [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue.svg)](https://hakandamar.github.io/ct-toolkit/)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/ct-toolkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=MAGENTA&left_text=downloads)](https://pepy.tech/projects/ct-toolkit)
 
 CT Toolkit is an open-source security layer designed to preserve the **identity continuity** of AI agents over time. It implements the **Nested Agency Architecture (NAA)** framework to prevent **Sequential Self-Compression (SSC)** in multi-agent hierarchies.
 
@@ -119,8 +120,9 @@ ct-toolkit list-templates
 
 | Metric           | Status                                                  |
 | :--------------- | :------------------------------------------------------ |
-| **Tests**        | ✅ 293/296 passing (89% coverage)                       |
-| **Last Phase**   | ✅ Phase 6: Auditor Mode (v0.3.9: Cooldown Integrated)  |
+| **Tests**        | ✅ 293 passed, 3 skipped, 13 warnings (93% coverage)                       |
+| **Downloads**    | [![PyPI Downloads](https://static.pepy.tech/personalized-badge/ct-toolkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=MAGENTA&left_text=downloads)](https://pepy.tech/projects/ct-toolkit) |
+| **Last Phase**   | ✅ Phase 6: Auditor Mode (v0.3.10: n8n Guardrail Node)  |
 | **Current Goal** | 🔶 Phase 7: Multi-Agent Synchronization (Integration)   |
 
 For a detailed breakdown of the 8-phase roadmap, see [**PROJECT_STATUS.md**](docs/PROJECT_STATUS.md).

{ct_toolkit-0.3.9 → ct_toolkit-0.3.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ct-toolkit"
-version = "0.3.9"
+version = "0.3.10"
 description = "Computational Theseus Toolkit — Identity Continuity Guardrails for Agentic Systems"
 readme = "README.md"
 requires-python = ">=3.11"