Add shift-commit-time post-commit hook

Author: nikolay-e

.env.example

@@ -1,5 +1,5 @@
 # Environment
-ARBITRIUM_ENV=development
+CERTAMEN_ENV=development
 
 # LLM API Keys (for tournaments)
 # LiteLLM reads these environment variables automatically.

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,5 +1,5 @@
 name: Bug Report
-description: Report a bug in arbitrium-core
+description: Report a bug in certamen-core
 title: "[Bug]: "
 labels: ["bug"]
 body:
@@ -17,7 +17,7 @@ body:
       label: Steps to Reproduce
       description: Steps to reproduce the behavior.
       placeholder: |
-        1. Install arbitrium-core with '...'
+        1. Install certamen-core with '...'
         2. Run '...'
         3. See error
     validations:
@@ -34,7 +34,7 @@ body:
     id: version
     attributes:
       label: Version
-      description: The version of arbitrium-core you are using.
+      description: The version of certamen-core you are using.
       placeholder: "e.g., 0.1.0"
     validations:
       required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,5 +1,5 @@
 name: Feature Request
-description: Suggest a new feature for arbitrium-core
+description: Suggest a new feature for certamen-core
 title: "[Feature]: "
 labels: ["enhancement"]
 body:

.github/workflows/cd.yml

@@ -44,10 +44,10 @@ jobs:
           python -c "
           import re
           ver = '${{ github.event.inputs.version }}'
-          with open('src/arbitrium_core/__about__.py', 'r') as f:
+          with open('src/certamen_core/__about__.py', 'r') as f:
               content = f.read()
           content = re.sub(r'__version__\s*=\s*[\"'\''].*?[\"'\'']', f'__version__ = \"{ver}\"', content, count=1)
-          with open('src/arbitrium_core/__about__.py', 'w') as f:
+          with open('src/certamen_core/__about__.py', 'w') as f:
               f.write(content)
           "
 
@@ -65,7 +65,7 @@ jobs:
           if [ "$LAST_COMMIT_MSG" = "$COMMIT_MSG" ]; then
             echo "Version bump commit already exists, skipping"
           else
-            git add src/arbitrium_core/__about__.py
+            git add src/certamen_core/__about__.py
             if ! git diff --staged --quiet; then
               git commit -m "$COMMIT_MSG"
             fi
@@ -132,7 +132,7 @@ jobs:
         run: uv pip install -e ".[dev]" --system
 
       - name: Run tests
-        run: pytest tests/ -v --cov=src/arbitrium_core --cov-report=term-missing
+        run: pytest tests/ -v --cov=src/certamen_core --cov-report=term-missing
 
   build:
     name: Build Distributions
@@ -170,7 +170,7 @@ jobs:
     timeout-minutes: 10
     environment:
       name: pypi
-      url: https://pypi.org/p/arbitrium-core
+      url: https://pypi.org/p/certamen-core
     permissions:
       id-token: write
     steps:

.github/workflows/ci.yml

@@ -74,7 +74,7 @@ jobs:
         shell: bash
         run: |
           pytest tests/ -v \
-            --cov=src/arbitrium_core \
+            --cov=src/certamen_core \
             --cov-report=xml \
             --cov-report=term-missing \
             --cov-branch \
@@ -152,16 +152,16 @@ jobs:
       - name: Check cyclomatic complexity
         run: |
           echo "=== Cyclomatic Complexity Report ==="
-          radon cc src/arbitrium_core/ --min B --show-complexity --total-average
+          radon cc src/certamen_core/ --min B --show-complexity --total-average
 
       - name: Check maintainability index
         run: |
           echo "=== Maintainability Index Report ==="
-          radon mi src/arbitrium_core/ --min B --show
+          radon mi src/certamen_core/ --min B --show
 
       - name: Fail on high complexity
         run: |
-          radon cc src/arbitrium_core/ --min C --total-average || \
+          radon cc src/certamen_core/ --min C --total-average || \
             (echo "::warning::High complexity detected (grade C or worse)" && exit 0)
 
   architecture-checks:

.gitignore

@@ -136,18 +136,18 @@ reports/*.csv
 reports/*.json
 reports/*.parquet
 
-# --- Arbitrium Framework Specific ---
+# --- Certamen Framework Specific ---
 # Runtime logs and outputs
-arbitrium_*_logs.log
-arbitrium_champion_*.md
-arbitrium_provenance*.md
-arbitrium_provenance*.json
-arbitrium_*_provenance.json
-arbitrium_*_champion_solution*.md
-arbitrium_*_complete_history.json
+certamen_*_logs.log
+certamen_champion_*.md
+certamen_provenance*.md
+certamen_provenance*.json
+certamen_*_provenance.json
+certamen_*_champion_solution*.md
+certamen_*_complete_history.json
 
 # Response cache database (including SQLite WAL/SHM files)
-arbitrium_cache.db
+certamen_cache.db
 *.cache.db
 *.db-wal
 *.db-shm
@@ -158,7 +158,7 @@ outputs/
 results/
 
 # Demo notebook outputs
-arbitrium_demo_outputs/
+certamen_demo_outputs/
 
 # Coverage reports
 coverage.xml

.pre-commit-config.yaml

@@ -7,6 +7,12 @@ default_language_version:
 fail_fast: false
 
 repos:
+  - repo: https://github.com/nikolay-e/pre-commit-hooks
+    rev: v2.1.0
+    hooks:
+      - id: shift-commit-time
+        stages: [post-commit]
+
   # ============================================================================
   # BASIC FILE QUALITY CHECKS (baseline hygiene)
   # ============================================================================

CHANGELOG.md

@@ -15,8 +15,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Knowledge Bank for preserving insights from eliminated models
 - Rubric-based scoring with configurable weights
 - YAML workflow system for custom AI pipelines
-- CLI interface with `arbitrium` command (tournament and workflow modes)
-- Python API via `Arbitrium.from_settings()`
+- CLI interface with `certamen` command (tournament and workflow modes)
+- Python API via `Certamen.from_settings()`
 - Support for 19 LLM providers via LiteLLM (OpenAI, Anthropic, Google, Ollama, etc.)
 - Provenance tracking and cost accounting
 - Auto-discovery of Ollama local models
@@ -27,5 +27,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Mutation testing on domain layer
 - PEP 561 type stubs (`py.typed` marker)
 
-[Unreleased]: https://github.com/nikolay-e/arbitrium-core/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/nikolay-e/arbitrium-core/releases/tag/v0.1.0
+[Unreleased]: https://github.com/nikolay-e/certamen-core/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/nikolay-e/certamen-core/releases/tag/v0.1.0

CITATION.cff

@@ -2,7 +2,7 @@
 # Visit https://bit.ly/cffinit to generate yours today!
 
 cff-version: 1.2.0
-title: Arbitrium Framework
+title: Certamen Framework
 message: >-
   If you use this software, please cite it using the
   metadata from this file.
@@ -11,13 +11,13 @@ authors:
   - given-names: Nikolay
     family-names: Eremeev
     email: nikolay.eremeev@outlook.com
-repository-code: 'https://github.com/nikolay-e/arbitrium-core'
-url: 'https://github.com/nikolay-e/arbitrium-core'
+repository-code: 'https://github.com/nikolay-e/certamen-core'
+url: 'https://github.com/nikolay-e/certamen-core'
 abstract: >-
-  Arbitrium Framework is an open-source Python framework for
+  Certamen Framework is an open-source Python framework for
   high-stakes AI decision-making via tournament-based model
   synthesis. Unlike general-purpose agent frameworks,
-  Arbitrium uses competitive elimination tournaments where AI
+  Certamen uses competitive elimination tournaments where AI
   agents generate independent solutions, critique each other,
   compete in evaluation rounds, and progressively refine
   until a champion emerges. The Knowledge Bank innovation
@@ -39,12 +39,12 @@ date-released: '2026-02-21'
 preferred-citation:
   type: software
   title: >-
-    Arbitrium Framework: Tournament-Based Synthesis for
+    Certamen Framework: Tournament-Based Synthesis for
     High-Stakes AI Decisions
   authors:
     - given-names: Nikolay
       family-names: Eremeev
       email: nikolay.eremeev@outlook.com
   year: 2025
-  url: 'https://github.com/nikolay-e/arbitrium-core'
-  repository-code: 'https://github.com/nikolay-e/arbitrium-core'
+  url: 'https://github.com/nikolay-e/certamen-core'
+  repository-code: 'https://github.com/nikolay-e/certamen-core'

CLAUDE.md

@@ -1,4 +1,4 @@
-# Arbitrium Core
+# Certamen Core
 
 > Extends [../CLAUDE.md](../CLAUDE.md)
 
@@ -10,7 +10,7 @@ but remains inaccessible through ordinary interaction.
 
 AI models contain vastly more knowledge than any single prompt can
 unlock. They hedge, simplify, omit, and hold back. The ultimate
-goal of Arbitrium is to close that gap completely: leave nothing
+goal of Certamen is to close that gap completely: leave nothing
 on the table. Every technique, every architecture, every method
 that can squeeze more signal out of AI should be pursued and
 integrated here.
@@ -32,10 +32,10 @@ Everything in this project serves this goal.
 make discover-ollama
 
 # Run tournament
-arbitrium --config config.yml
+certamen --config config.yml
 
 # Run YAML workflow
-arbitrium workflow execute examples/workflow.yml
+certamen workflow execute examples/workflow.yml
 
 # Development
 source venv/bin/activate
@@ -49,10 +49,10 @@ pre-commit run -a     # all quality checks
 ### Python API
 
 ```python
-from arbitrium_core import Arbitrium
+from certamen_core import Certamen
 
 async def main():
-    arb = await Arbitrium.from_settings({
+    arb = await Certamen.from_settings({
         "models": {
             "gpt": {"provider": "openai", "name": "gpt-4o"},
             "claude": {"provider": "anthropic", "name": "claude-3-5-sonnet-20241022"},
@@ -66,10 +66,10 @@ async def main():
 
 ```text
 ┌─────────────────────────────────┐
-│  arbitrium --config config.yml  │
+│  certamen --config config.yml  │
 │  ┌───────────────────────────┐  │
 │  │  Tournament Engine        │  │
-│  │  (src/arbitrium/core/)    │  │
+│  │  (src/certamen/core/)    │  │
 │  │  ├─ Competitors (LLMs)    │  │
 │  │  ├─ Judges (LLMs)         │  │
 │  │  ├─ Rubrics & Scoring     │  │
@@ -83,7 +83,7 @@ async def main():
 ### Core Components
 
 ```text
-src/arbitrium/
+src/certamen/
 ├── core/
 │   ├── tournament.py      # Tournament orchestration
 │   ├── scorer.py          # Rubric-based scoring
@@ -149,7 +149,7 @@ outputs: [llm]
 Available node types:
 
 ```bash
-arbitrium workflow list-nodes
+certamen workflow list-nodes
 ```
 
 ## Testing
@@ -182,26 +182,26 @@ LITELLM_LOG=INFO
 
 ```bash
 # Run tournament with config file
-arbitrium --config config.yml
+certamen --config config.yml
 
 # Run with specific models only
-arbitrium --config config.yml --models gpt,claude
+certamen --config config.yml --models gpt,claude
 
 # Interactive mode
-arbitrium --config config.yml --interactive
+certamen --config config.yml --interactive
 
 # Execute YAML workflow
-arbitrium workflow execute workflow.yml
+certamen workflow execute workflow.yml
 
 # Validate workflow
-arbitrium workflow validate workflow.yml
+certamen workflow validate workflow.yml
 
 # List available node types
-arbitrium workflow list-nodes
+certamen workflow list-nodes
 ```
 
 ## PyPI Installation
 
 ```bash
-pip install arbitrium-core
+pip install certamen-core
 ```