Add GitHub Actions CI and README badges

Made-with: Cursor

Author: codethor0

.github/workflows/ci.yml

@@ -0,0 +1,55 @@
+# CI - Quality gate for creativity-exploit-engine
+# Runs on push and pull_request to main
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Upgrade pip
+        run: python -m pip install --upgrade pip
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install project and dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run ruff
+        run: ruff check src/creativity_engine tests
+
+      - name: Run mypy
+        run: mypy src/creativity_engine tests
+
+      - name: Run pytest
+        run: pytest
+
+      - name: CLI smoke test
+        env:
+          CRE_ENGINE_DUMMY: "1"
+        run: python -m creativity_engine.cli seeds-demo

README.md

@@ -1,5 +1,9 @@
 # creativity-exploit-engine
 
+[![CI](https://github.com/codethor0/creativity-exploit-engine/actions/workflows/ci.yml/badge.svg)](https://github.com/codethor0/creativity-exploit-engine/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/codethor0/creativity-exploit-engine/blob/main/LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+
 ## Code Signature
 
 Author: Thor Thor
@@ -12,27 +16,48 @@ Project: creativity-exploit-engine
 This PoC implements the framework described in:
 
 **"The Creativity Exploit: Toward an Algorithmic Framework for Security Imagination"**  
-(Substack link / canonical URL here)
+(Canonical URL to be added when published.)
 
-## What It Does
+## Overview
 
 The Creativity Engine scores threat scenarios by **novelty** and **value** using embeddings and approximate nearest neighbor search. It can generate creative variations for threat modeling and red teaming via a simple evolutionary search over artifact combinations.
 
 - **Novelty**: How different a scenario is from known ones (cosine distance in embedding space)
 - **Value**: Domain heuristic for security relevance (critical assets, risky entry points, advanced techniques)
 - **Surprise**: Optional hook for generative models (default disabled)
 
-## Quickstart
-
-### Install
+## Installation
 
 ```bash
-pip install -e .
-# With dev dependencies (pytest, mypy, ruff):
+# Local development (with dev dependencies: pytest, mypy, ruff)
 pip install -e ".[dev]"
+
+# Or install from GitHub
+pip install "creativity-exploit-engine @ git+https://github.com/codethor0/creativity-exploit-engine.git"
+```
+
+## Usage
+
+### Minimal code example
+
+```python
+from creativity_engine import Artifact, CreativityEngine, SentenceTransformerEmbedder
+
+# For offline/testing: use DummyEmbedder instead (set CRE_ENGINE_DUMMY=1)
+embedder = SentenceTransformerEmbedder()
+engine = CreativityEngine(embedder=embedder)
+
+artifact = Artifact(
+    asset="domain controller",
+    entry_point="VPN gateway",
+    technique="password spraying",
+    constraint="assume EDR present",
+)
+scores = engine.score(artifact)
+print(scores)  # {"novelty": ..., "value": ..., "surprise": ..., "creativity": ...}
 ```
 
-### Run seeds-demo
+### CLI: seeds-demo
 
 Runs a short evolutionary search with hard-coded seed artifacts: