Add CI and improve quickstart docs

Author: m3lixir

.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.11"
+          - "3.12"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install package
+        run: python -m pip install -e ".[dev]"
+
+      - name: Lint
+        run: python -m ruff check .
+
+      - name: Test
+        run: python -m unittest discover -s tests -v
+
+      - name: Compile
+        run: python -m compileall src tests

README.md

@@ -1,5 +1,8 @@
 # chumdump
 
+[![CI](https://github.com/m3lixir/chumdump/actions/workflows/ci.yml/badge.svg)](https://github.com/m3lixir/chumdump/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/m3lixir/chumdump?include_prereleases&label=release)](https://github.com/m3lixir/chumdump/releases)
+
 `chumdump` is a defensive CLI for inspecting AI-readable environments,
 detecting chum-like content, generating controlled chumbait, and
 monitoring whether AI crawlers, agents, or retrieval systems consume it.
@@ -11,9 +14,11 @@ obeyed, or leaked.
 ## Contents
 
 - [What it does](#what-it-does)
+- [Status](#status)
+- [Install](#install)
+- [Quickstart](#quickstart)
 - [Evidence model](#evidence-model)
-- [Install for development](#install-for-development)
-- [Example flow](#example-flow)
+- [Workflow](#workflow)
 - [Commands](#commands)
 - [Safety and scope](#safety-and-scope)
 
@@ -29,6 +34,81 @@ obeyed, or leaked.
 - Generates Markdown, JSON, HTML, or SARIF-style reports.
 - Cleans up deployed bait files from a marked destination.
 
+## Status
+
+Current release:
+[v0.1.0-alpha](https://github.com/m3lixir/chumdump/releases/tag/v0.1.0-alpha).
+
+`chumdump` is an early alpha. The core local workflow is usable, but
+the command surface and report schema may change before a stable
+release.
+
+## Install
+
+Install the current alpha from GitHub:
+
+```shell
+python3 -m pip install \
+  "git+https://github.com/m3lixir/chumdump.git@v0.1.0-alpha"
+```
+
+Install from a local checkout for development:
+
+```shell
+python3 -m pip install -e ".[dev]"
+```
+
+Then check the CLI:
+
+```shell
+chumdump --help
+```
+
+You can also run the CLI directly from a checkout:
+
+```shell
+PYTHONPATH=src python3 -m chumdump --help
+```
+
+## Quickstart
+
+This creates a local project, generates bait, deploys a small dump,
+simulates one crawler-style access log entry, records the bite, and
+prints a report.
+
+```shell
+chumdump init ai-crawler-test
+cd ai-crawler-test
+
+chumdump bait create --type canary --name violet-harbor
+chumdump dump build --profile website --count 1
+chumdump deploy ./public
+
+bait_file=$(basename "$(find public/bait -name '*.md' | head -n 1)")
+cat > access.log <<EOF
+203.0.113.10 - - [18/Jun/2026:12:00:00 +0000] "GET /bait/${bait_file} HTTP/1.1" 200 123 "-" "GPTBot/1.0"
+EOF
+
+chumdump watch --logs ./access.log
+chumdump bites
+chumdump report --format markdown --stdout
+```
+
+Expected bite summary:
+
+The `GPTBot/1.0` user agent above is a local fixture. No real crawler
+visits the quickstart project.
+
+![chumdump terminal demo](assets/terminal-demo.svg)
+
+```text
+Detected bites: 1
+- accessed bait-canary-violet-harbor-... via /bait/bait-canary-violet-harbor-....md (GPTBot)
+
+TYPE       TIME                  ACTOR                 BAIT
+accessed   18/Jun/2026:12:00:00 GPTBot                bait-canary-violet-harbor-...
+```
+
 ## Evidence model
 
 `chumdump` should not merely generate bait. It should preserve evidence
@@ -61,19 +141,7 @@ The bite model is the heart of the tool. Without evidence, chumdump is
 only a bait generator. With evidence, it becomes a small forensic
 record for AI ingestion and agent-behavior testing.
 
-## Install for development
-
-```shell
-python3 -m pip install -e ".[dev]"
-```
-
-You can also run the CLI directly from a checkout:
-
-```shell
-PYTHONPATH=src python3 -m chumdump --help
-```
-
-## Example flow
+## Workflow
 
 ```mermaid
 flowchart TD