Harden Doghouse trust, correctness, and character

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+on:
+  push:
+    branches: [ tui ]
+  pull_request:
+    branches: [ tui ]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .[dev]
+      - name: Run tests
+        run: |
+          pytest -q

.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish to PyPI
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Build
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@v1.10.3
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

Makefile

@@ -0,0 +1,35 @@
+.PHONY: dev-venv test snapshot history playback clean
+
+VENV = .venv
+PYTHON = $(VENV)/bin/python3
+PIP = $(VENV)/bin/pip
+
+dev-venv:
+	python3 -m venv $(VENV)
+	$(PIP) install --upgrade pip
+	$(PIP) install -e .[dev]
+
+test:
+	PYTHONPATH=src $(PYTHON) -m pytest tests/doghouse
+
+snapshot:
+	PYTHONPATH=src $(PYTHON) -m doghouse.cli.main snapshot
+
+history:
+	PYTHONPATH=src $(PYTHON) -m doghouse.cli.main history
+
+playback:
+	@if [ -z "$(NAME)" ]; then echo "Usage: make playback NAME=pb1_push_delta"; exit 1; fi
+	PYTHONPATH=src $(PYTHON) -m doghouse.cli.main playback $(NAME)
+
+watch:
+	@if [ -z "$(PR)" ]; then PYTHONPATH=src $(PYTHON) -m doghouse.cli.main watch; \
+	else PYTHONPATH=src $(PYTHON) -m doghouse.cli.main watch --pr $(PR); fi
+
+export:
+	@if [ -z "$(PR)" ]; then PYTHONPATH=src $(PYTHON) -m doghouse.cli.main export; \
+	else PYTHONPATH=src $(PYTHON) -m doghouse.cli.main export --pr $(PR); fi
+
+clean:
+	rm -rf build/ dist/ *.egg-info
+	find . -type d -name "__pycache__" -exec rm -rf {} +

PRODUCTION_LOG.mg

@@ -0,0 +1,61 @@
+# Draft Punks — Production Log
+
+Guideline: Append an entry for any unexpected/unanticipated work, dependency, requirement, or risk we discover during implementation and testing.
+
+Template
+
+````markdown
+## Incident: <title>
+
+Timestamp: <YYYY-MM-DD HH:MM:SS local>
+
+Task: <current task id>
+
+### Problem
+
+<problem description>
+
+### Resolution
+
+<resolution>
+
+### What could we have done differently
+
+<how could this have been anticipated? how should we have planned for this? what can we do better next time to avoid this sort of issue again?>
+````
+
+Initial Entries
+
+- (none yet)
+
+## Incident: Product Pivot to CLI-Only (Git-backed State)
+
+Timestamp: 2025-11-07 19:07:32
+
+Task: DP-F-20 / Sprint 0 planning
+
+### Problem
+TUI cannot be driven programmatically in our harness and is slower to iterate for both humans and LLMs.
+
+### Resolution
+Pivot to a CLI-only experience with a Git-backed state repo and JSONL stdio server. Update SPRINTS.md, add CLI-STATE.md, and refocus FEATURES/TASKLIST over time.
+
+### What could we have done differently
+Call out environment constraints earlier and consider dual-mode from day one. Favor CLI-first for automation-heavy tools; treat TUI as an optional skin over the same state engine.
+
+## Incident: Local test runner missing (pytest not installed)
+
+Timestamp: 2025-11-08 00:00:00
+
+Task: DP-F-30 / Thread verbs + Debug LLM (tests-first)
+
+### Problem
+The environment lacks `pytest`, so tests could not be executed immediately after adding failing tests.
+
+### Resolution
+Committed failing tests first, then implemented the features. Left tests in place for local/CI execution. Next dev step is `make dev-venv && . .venv/bin/activate && pip install -e .[dev] && pytest`.
+
+### What could we have done differently
+Include a lightweight script or Makefile target that ensures a dev venv with pytest is provisioned before test steps, or run tests inside CI where the toolchain is guaranteed.
+\n## 2026-03-27: Doghouse Reboot (The Great Pivot)\n- Deleted legacy Draft Punks TUI and GATOS/git-mind kernel.\n- Pivot to DOGHOUSE: The PR Flight Recorder.\n- Implemented core Doghouse engine (Snapshot, Sortie, Delta).\n- Implemented GitHub adapter using 'gh' CLI + GraphQL for review threads.\n- Implemented CLI 'doghouse snapshot' and 'doghouse history'.\n- Verified on real PR (flyingrobots/draft-punks PR #3).\n- Added unit tests for DeltaEngine.
+\n## 2026-03-27: Soul Restored\n- Restored PhiedBach / BunBun narrative to README.md.\n- Unified Draft Punks (Conductor) and Doghouse (Recorder) vision.\n- Finalized engine for feat/doghouse-reboot.