deviatdd 2.5.1__tar.gz

deviatdd-2.5.1/.deviate/.gitignore

@@ -0,0 +1,6 @@
+session.json
+artifacts/
+prompts.log
+reports/
+rollback.jsonl
+logs/

deviatdd-2.5.1/.deviate/config.toml

@@ -0,0 +1,9 @@
+profile = "default"
+timeout_seconds = 300
+agent_export_mode = "local"
+
+graphite = false
+use_context = true
+use_libref = true
+[agent]
+backend = "pi"

deviatdd-2.5.1/.deviate/evaluations/deviate-flows-skill-2026-06-26.json

@@ -0,0 +1,55 @@
+{
+  "evaluation_id": "2026-06-26T000000Z",
+  "input_valid": true,
+  "target_archetype": "Multi_Step_Logic",
+  "target_path": "src/deviate/prompts/skills/deviate-flows/SKILL.md",
+  "scores": {
+    "domain_construct_definition": 8,
+    "predicate_atomicity": 10,
+    "affirmative_constraints": 10,
+    "causal_sequence": 10,
+    "output_contract": 9,
+    "lexical_specificity": 8,
+    "few_shot_icl": 4,
+    "snr_maximization": 8,
+    "edge_case_enumeration": 9,
+    "contextual_bounding": 9
+  },
+  "raw_scores": {
+    "domain_construct_definition": 8,
+    "predicate_atomicity": 9,
+    "affirmative_constraints": 9,
+    "causal_sequence": 8,
+    "output_contract": 9,
+    "lexical_specificity": 8,
+    "few_shot_icl": 4,
+    "snr_maximization": 8,
+    "edge_case_enumeration": 9,
+    "contextual_bounding": 9
+  },
+  "archetype_weights_applied": {
+    "causal_sequence": 2.0,
+    "predicate_atomicity": 1.5,
+    "affirmative_constraints": 1.5
+  },
+  "verification_passed": true,
+  "verification_notes": [
+    "Weighted causal_sequence (16.0), predicate_atomicity (13.5), and affirmative_constraints (13.5) capped at 10 per rubric bounds.",
+    "few_shot_icl adjusted from raw 5 to 4 to satisfy semantic rule: identified weakness 'no positive canonical example' must reflect in score ≤ 4.",
+    "KV-cache prefix estimated ~700 tokens; under 1024 threshold — no static-prefix bonus applied.",
+    "Top-3 lowest scores are few_shot_icl=4, then three-way tie at 8 (domain_construct, lexical_specificity, snr). Patches target few_shot_icl primarily; tied scores addressed via bounding-tag patch."
+  ],
+  "identified_weaknesses": [
+    "Few-shot ICL: edge-case table provides negative-path mappings but no positive canonical example of a complete FLOW-NN block, FLOW-01 schema-conformant file, or index row.",
+    "Lexical specificity: opening sentence 'This engine operates exclusively as an isolated, context-bounded...' carries mild narrative framing; could be tightened to declarative scope statement.",
+    "Contextual bounding: no explicit <inputs> block separates runtime user dialogue from static instructions, weakening prefix-cache reuse across invocations.",
+    "Causal sequence: workflow steps are named but lack explicit per-step precondition→action→verification loops; cross-step data flow is implied, not declared."
+  ],
+  "programmatic_patches": {
+    "inject_domain_construct": "Replace lines 15-16:\n\nOLD:\nThis engine operates exclusively as an isolated, context-bounded Product-layer\nflow authoring assistant for the DeviaTDD framework. Your objective is to\ncollaborate with the user to identify core customer flows, write them into the\nProduct-layer seed artifacts under `specs/_product/flows/`, and keep the\ncanonical flow index (`specs/_product/flows/index.md`) consistent with the\non-disk flow files.\n\nNEW:\nSCOPE: DeviaTDD Product-layer FLOW-01 (Flows) authoring.\nWRITES: `specs/_product/flows/flows-<domain>.md` files and `specs/_product/flows/index.md`.\nDOES NOT WRITE: `specs/_product/architecture.md`, `specs/_product/domain-model.md`, `specs/_product/release-next.md`.\nSEED: `specs/_product/flows/flows-product.md` is read-only; extend, never regenerate.\nGOAL: Produce FLOW-NN flow blocks that conform to the FLOW-01 section schema and remain traceable via `flow_refs:` frontmatter.",
+    "inject_few_shot_icl": "Insert after </edge_case_handling>:\n\n<canonical_example>\n## FLOW-04 Provision Developer Environment\n\n| Field | Value |\n|---|---|\n| Actor | Developer |\n| Domain | Onboarding |\n| Status | Active |\n| Source | specs/_product/flows/flows-onboarding.md |\n\n**Problem / job to be done**: As a Developer, I need a reproducible local environment so I can run the test suite without manual setup.\n**Trigger**: `deviate onboard` slash command.\n**Preconditions**: Repository cloned; `.deviate/` directory present.\n**Happy path**: 1. Run `deviate onboard`. 2. Skill provisions mise tasks. 3. Skill installs git hooks. 4. Skill reports green status.\n**Alternate / error paths**: If mise binary missing → abort with diagnostic link; offer manual fallback.\n**Success State**: `mise run check` exits 0 within 30s.\n**Metrics / Signals**: setup_time_seconds ≤ 30; references FLOW-01, FLOW-02.\n\n## index.md row appended by this flow\n\n| Flow ID | Name | Actor | Domain | Status | Source |\n|---|---|---|---|---|---|\n| FLOW-04 | Provision Developer Environment | Developer | Onboarding | Active | specs/_product/flows/flows-onboarding.md |\n</canonical_example>",
+    "inject_output_contract": "",
+    "inject_bounding_tags": "Insert immediately after the YAML frontmatter (line 11):\n\n<inputs>\n  <input name=\"user_input\" required=\"true\">Free-text user request describing actor, domain, job-to-be-done, or trigger.</input>\n  <input name=\"existing_seed_path\" required=\"false\">Absolute or repo-relative path to `specs/_product/flows/flows-product.md` if already populated.</input>\n  <input name=\"existing_index_path\" required=\"false\">Absolute or repo-relative path to `specs/_product/flows/index.md`.</input>\n</inputs>\n\n<outputs>\n  <output name=\"flow_file_path\" type=\"string\">Path to the newly authored `flows-<domain>.md`.</output>\n  <output name=\"index_rows_added\" type=\"integer\">Count of rows appended to index.md.</output>\n  <output name=\"flow_id\" type=\"string\">Assigned FLOW-NN identifier matching `^FLOW-\\d{2,}$`.</output>\n</outputs>",
+    "inject_cache_breakpoint": "Insert as the final block before </edge_case_handling> closing tag, after all static instructions:\n\n<runtime_payload>\n  <!-- Dynamic content injected per invocation lives below this line. -->\n  <!-- Static prefix above is shared across all calls; KV-cache breakpoint here. -->\n  <user_turn />\n</runtime_payload>\n\nAlso restructure line ordering: move <edge_case_handling> BEFORE <workflow> so the static rule block precedes the workflow narrative, maximizing prefix-cache hit rate."
+  }
+}

deviatdd-2.5.1/.env.example

@@ -0,0 +1,8 @@
+# PyPI API token for `mise run publish`.
+#
+# Generate at https://pypi.org/manage/account/token/
+#   - Scope the token to the `deviatdd` project only (not account-wide)
+#   - Copy this file to `.env` and paste your real token
+#   - `.env` is gitignored; never commit secrets
+
+PYPI_API_TOKEN=

deviatdd-2.5.1/.gitattributes

@@ -0,0 +1,5 @@
+# DeviaTDD append-only JSONL ledgers: union-merge so concurrent
+# appends never conflict at branch-merge time.
+# See specs/constitution.md §1 Append-Only Ledger Protocol.
+specs/issues.jsonl merge=union
+specs/**/tasks.jsonl merge=union

deviatdd-2.5.1/.githooks/pre-commit

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# Pre-commit: lint + format-check only the Python files touched by this commit.
+# Tests stay in pre-push — even filtered, pytest on every commit is too slow.
+#
+# Portable to bash 3.2 (macOS /bin/bash): no `mapfile`, no `declare -A`, etc.
+set -e
+set -o pipefail
+
+# Unset git env inherited from the hook context. Tests in this repo invoke
+# git subprocesses with cwd for isolation; GIT_DIR overrides cwd.
+GIT_DIR_SAVED="${GIT_DIR-}"
+unset GIT_DIR
+
+trap '[ -n "$GIT_DIR_SAVED" ] && export GIT_DIR="$GIT_DIR_SAVED" || unset GIT_DIR' EXIT
+
+# Collect staged + unstaged Python files (Added/Copied/Modified/Renamed).
+# Untracked and Deleted files are skipped — no content to check.
+changed=()
+while IFS= read -r f; do
+  [ -n "$f" ] && changed+=("$f")
+done < <(
+  {
+    git diff --cached --name-only --diff-filter=ACMR HEAD -- '*.py' 2>/dev/null
+    git diff          --name-only --diff-filter=ACMR      -- '*.py' 2>/dev/null
+  } | sort -u
+)
+
+if [ "${#changed[@]}" -eq 0 ]; then
+  exit 0
+fi
+
+uv run ruff check "${changed[@]}"
+uv run ruff format --check "${changed[@]}"

deviatdd-2.5.1/.githooks/pre-push

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# Pre-push: lint + format-check + selective pytest on the Python files
+# changed since the upstream branch (or HEAD~1 if no upstream yet).
+# `mise run test` stays the canonical full-suite command for CI / pre-release.
+#
+# Portable to bash 3.2 (macOS /bin/bash): no `mapfile`, no `declare -A`, etc.
+set -e
+set -o pipefail
+
+# Unset git env inherited from the hook context. Tests in this repo invoke
+# git subprocesses with cwd for isolation; GIT_DIR overrides cwd.
+GIT_DIR_SAVED="${GIT_DIR-}"
+unset GIT_DIR
+
+trap '[ -n "$GIT_DIR_SAVED" ] && export GIT_DIR="$GIT_DIR_SAVED" || unset GIT_DIR' EXIT
+
+# Pick a base: upstream if we have one, else the previous commit.
+if upstream=$(git rev-parse --verify --quiet '@{u}' 2>/dev/null); then
+  base=$(git merge-base "$upstream" HEAD)
+elif base=$(git rev-parse --verify --quiet 'HEAD~1' 2>/dev/null); then
+  :
+else
+  # No upstream, no parent — nothing to compare against.
+  exit 0
+fi
+
+changed=()
+while IFS= read -r f; do
+  [ -n "$f" ] && changed+=("$f")
+done < <(git diff --name-only --diff-filter=ACMR "$base...HEAD" -- '*.py' | sort -u)
+
+if [ "${#changed[@]}" -eq 0 ]; then
+  exit 0
+fi
+
+uv run ruff check "${changed[@]}"
+uv run ruff format --check "${changed[@]}"
+
+# testmon forceselect requires a warm .testmondata from a prior full-suite
+# run. Without it, testmon selects zero tests and passes silently — defeating
+# the purpose of the pre-push gate. Fall back to the full suite when the
+# data file is missing or empty.
+if [ -s .testmondata ]; then
+  mise run test-affected
+else
+  echo "pre-push: .testmondata missing or empty — running full suite"
+  mise run test
+fi

deviatdd-2.5.1/.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,47 @@
+---
+name: Bug report
+about: Report incorrect behavior, a regression, or an error message
+title: "[Bug] "
+labels: ["bug"]
+---
+
+## Summary
+
+<!-- One or two sentences. What broke? What did you observe? -->
+
+## Reproduction
+
+<!-- Minimal sequence to reproduce. Include the exact command(s). -->
+
+```bash
+# e.g.
+deviate explore pre "test problem"
+```
+
+## Expected behavior
+
+<!-- What should have happened? -->
+
+## Actual behavior
+
+<!-- What actually happened? Paste the exact error / output. -->
+
+```text
+<!-- error / output here -->
+```
+
+## Environment
+
+- DeviaTDD version: `deviate --version`
+- Python version: `python --version`
+- OS:
+- Agent backend (opencode / claude / droid / pi):
+
+## Logs / Context
+
+<!-- Paste relevant output, stack traces, or attach `prompts.log` if relevant. -->
+<!-- If the bug is in a CLI subcommand, include the full command and its output. -->
+
+## Acceptance criteria
+
+<!-- Optional: what would "fixed" look like? Behavior, error message, exit code. -->

deviatdd-2.5.1/.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,45 @@
+---
+name: Feature request
+about: Propose a new capability for the DeviaTDD framework
+title: "[Feature] "
+labels: ["enhancement"]
+---
+
+## Problem
+
+<!-- What user pain or framework gap does this address? -->
+
+## Proposal
+
+<!-- High-level shape of the solution. Be concrete enough that the next person
+     can shard it into issues without re-deriving intent. -->
+
+## Layer(s) affected
+
+<!-- Tick all that apply. -->
+
+- [ ] Macro (Explore / Research / PRD / Shard)
+- [ ] Meso (Specify / Plan / Tasks)
+- [ ] Micro (RED / GREEN / YELLOW / JUDGE / REFACTOR / Execute)
+- [ ] CLI surface (`deviate <subcommand>`)
+
+- [ ] Other: ____
+
+## Alternatives considered
+
+<!-- What else did you weigh, and why is this preferred? -->
+
+## Acceptance criteria
+
+<!-- Concrete, verifiable outcomes that mean "done". Numbered so they can be
+     referenced from a follow-up issue. -->
+
+- [ ] AC-1:
+- [ ] AC-2:
+- [ ] AC-3:
+
+## Spec alignment
+
+<!-- If the change touches CLI shape or phase workflow, the corresponding
+     section in `specs/DeviaTDD-api.md` or `specs/DeviaTDD-architecture.md`
+     must be updated in the same commit. -->

deviatdd-2.5.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,42 @@
+## Summary
+
+<!-- 1–3 bullets. What changed and why. -->
+
+-
+
+## Related
+
+<!-- Issue(s), spec file(s), task ID(s). Use "Fixes #N" / "Refs #N" syntax. -->
+
+-
+
+## Phase
+
+<!-- Tick the TDD phase this PR resolves (or "non-TDD" for chores/docs). -->
+
+- [ ] RED — failing test added
+- [ ] GREEN — minimum implementation
+- [ ] REFACTOR — cleanup (no behavior change)
+- [ ] Non-TDD: chore / docs / ci
+
+## Validation
+
+<!-- Run these locally before requesting review. CI runs the same gates. -->
+
+- [ ] `mise run check` (lint + format-check) passes locally
+- [ ] `mise run test` (pytest) passes locally
+- [ ] `mise run test-e2e` (bats) passes locally (if CLI behavior changed)
+- [ ] New tests added for behavior changes
+
+## Spec alignment
+
+<!-- Confirm spec docs were updated in the same commit, if applicable. -->
+
+- [ ] `specs/DeviaTDD-api.md` reflects the change (CLI surface)
+- [ ] `specs/DeviaTDD-architecture.md` reflects the change (phase workflow, routing)
+- [ ] `specs/constitution.md` reflects the change (governance / invariants)
+- [ ] `CHANGELOG.md` updated under `[Unreleased]`
+
+## Risk & rollback
+
+<!-- One or two sentences. How reversible is this? Any breaking changes? -->

deviatdd-2.5.1/.github/workflows/ci.yml

@@ -0,0 +1,80 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Cancel in-progress runs for the same ref when a new commit lands.
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  # Lint + format-check + pytest on a single Python 3.13 runner.
+  # Sequential rather than matrix because `uv sync` + cache restore dominate
+  # setup cost; matrix fan-out would multiply that without meaningful speedup.
+  quality:
+    name: Lint / Format / Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.13"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Sync dev dependencies
+        run: uv sync --extra dev
+
+      - name: Lint (ruff check)
+        run: uv run ruff check
+
+      - name: Format check (ruff format --check)
+        run: uv run ruff format --check
+
+      - name: Test (pytest)
+        # --testmon-noselect pins full-suite behavior so testmon selection never silently narrows CI.
+        run: uv run pytest --testmon-noselect tests/
+
+  # Bats end-to-end smoke suite. Installs the package as a real CLI tool
+  # (`uv tool install --editable`) so the smoke suite exercises the installed
+  # binary, not the in-repo module — closer to what users actually run.
+  e2e:
+    name: E2E (bats)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.13"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Sync dev dependencies
+        run: uv sync --extra dev
+
+      - name: Install bats + jq
+        run: sudo apt-get update && sudo apt-get install -y --no-install-recommends bats jq
+
+      - name: Install deviate CLI (editable)
+        run: uv tool install --editable .
+
+      - name: Run bats smoke suite
+        # Force `deviate` onto PATH for this step; `uv tool install` puts it in
+        # a uv-managed directory that GitHub Actions does not expose by default.
+        run: |
+          set -euo pipefail
+          export PATH="$(uv tool dir --bin):$PATH"
+          which deviate
+          deviate --version
+          bats tests/e2e/

deviatdd-2.5.1/.gitignore

@@ -0,0 +1,38 @@
+node_modules
+package.json
+package-lock.json
+bun.lock
+.worktrees/
+
+graphify-out/
+__pycache__/
+
+# Tooling
+.rgr
+.tdd-session.json
+.deviate/session.json
+.opencode/index/
+.opencode/codebase-index.json
+node_modules/
+
+.deviate/artifacts/
+.deviate/logs/
+.deviate/review/
+*/commands/deviate-*.md
+
+*/prompts/deviate-*.md
+
+# Allow OMP slash commands — installed to .omp/prompts/ by deviate setup
+!/.omp/prompts/deviate-*.md
+
+# Internal launch prep notes
+.launch/
+
+# pytest-testmon selection data + SQLite WAL sidecars (regenerated by `mise run test` / `mise run test-affected`)
+.testmondata*
+
+# Local secrets — used by `mise run publish` for PYPI_API_TOKEN.
+# `.env.example` is committed as a template; never commit the real `.env`.
+.env
+.env.*
+!.env.example

deviatdd-2.5.1/.opencode/.gitignore

@@ -0,0 +1,5 @@
+node_modules
+package.json
+package-lock.json
+bun.lock
+.gitignore

deviatdd-2.5.1/.opencode/opencode.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": []
+}

deviatdd-2.5.1/AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md