Slice 1 (1/4): core engine, workflow ABC, free-form seed + CI by tildesrc · Pull Request #1 · Unsupervisedcom/panopticon

tildesrc · 2026-06-12T17:29:30Z

First of four stacked PRs implementing Slice 1 — Contracts + walking skeleton (docs/ROADMAP.md). Lands the core contracts + CI.

panopticon.core.models — domain types (Task, Repo, HistoryEntry, Ball, Mode, Verdict, DoDItem); pure data, no clock/I/O.
panopticon.core.workflow — the Workflow ABC (the workflow interface, ADR 0004).
panopticon.core.engine — deterministic lifecycle engine (state machine + ball + DoD gating).
panopticon.workflows.FreeFormWorkflow — the seed workflow.
Golden tests + a determinism test (no LLM imports in control-plane pkgs) + GitHub Actions CI (uv, mypy, pytest).

Stack: #1→main, #2→#1, #3→#2, #4→#3. Merge bottom-up.

🤖 Generated with Claude Code

… seed + CI Slice 1, PR 1 of 4 — the core contracts the rest of the slice builds on. - panopticon.core.models: domain types (Task, Repo[+git_url], HistoryEntry[+trigger], Turn, Status, Advance, Responsibility) — pure data, no clock, no I/O. - panopticon.core.state: states as classes — State (non-terminal, inherits a DROPPED transition) / TerminalState, with built-in Complete/Dropped. Each declares two orthogonal facts: turn_on_enter (who acts on entry) and advance (MANUAL: the user transitions out / AUTOMATIC: the agent does when satisfied). - panopticon.core.workflow: the Workflow interface owns the whole state machine — nested State classes discovered and their string/class transitions resolved + validated at instantiation; queries (transitions, turn_on_enter, advance, …); and task lifecycle (start_task, apply_transition). Dropping is the universal escape hatch. - panopticon.workflows.Spike: the minimal seed workflow. - Golden tests for resolution / turn / advance / responsibility gating. - GitHub Actions CI: uv sync, mypy, pytest. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

tildesrc force-pushed the slice1/01-core branch 5 times, most recently from 84c25b9 to 0658a01 Compare June 12, 2026 21:17

tildesrc commented Jun 12, 2026

View reviewed changes

tildesrc force-pushed the slice1/01-core branch from 0658a01 to 6720afe Compare June 12, 2026 22:08