Skip to content

feat(pipeline): refresh state, cache bootstrapping, rework triggers, branch discipline (v10.1.0)#191

Merged
nullhack merged 1 commit into
mainfrom
feat/v10.1.0-pipeline-improvements
Jul 8, 2026
Merged

feat(pipeline): refresh state, cache bootstrapping, rework triggers, branch discipline (v10.1.0)#191
nullhack merged 1 commit into
mainfrom
feat/v10.1.0-pipeline-improvements

Conversation

@nullhack

@nullhack nullhack commented Jul 8, 2026

Copy link
Copy Markdown
Owner

Summary

Bundles the pipeline-flow improvements (Topics A/B/C), branch-discipline mechanization, AGENTS.md constraint sharpening, and a minor version bump 10.0.0 → 10.1.0.

Cycle-close refresh state (deliver-flow 1.4 → 1.5)

  • New refresh state after publish: regenerate docs/state.md living spec from current tests, summarize carry-over cache files to ~1000 words, regenerate docstrings across the whole source surface then strip all .py.
  • Optional publish on stakeholder approval (approved → publish, declined → refresh); refresh always closes the cycle.

Cache bootstrapping (lazy, per-state)

  • New .templates/cache/interview-notes.md.template (funnel skeleton); interview-general bootstraps .cache/<session_id>/interview-notes.md from it if absent.

Interview-implied rework (second trigger source)

  • interview-building-blocks flags findings that modify existing blocks; author-test-stubs + write-test-py read both trigger sources (journal build-escalation + interview flags) → @pytest.mark.pending.

Branch discipline (mechanized end-to-end)

  • Contract surface committed to dev at plan (simulate-contracts); build cuts feature/<session_id> off dev at entry (select-build-target); deliver squash-merges + deletes the branch (merge-to-dev). One feature branch per build cycle.

AGENTS.md

  • Dispatched agent never transitions / skips / holds the todo; todo-first as a hard constraint; two-hats model documented.

Verification

  • task validate-flows — 6/6 flows valid
  • task lint (ruff check .) — clean

…branch discipline

Cycle-close refresh state (deliver-flow 1.4 -> 1.5):
- new `refresh` state after publish: regenerate docs/state.md living spec
  from the current tests, summarize carry-over cache files to ~1000 words,
  regenerate docstrings across the whole source surface then strip all .py
- optional publish on stakeholder approval (approved -> publish,
  declined -> refresh); refresh always closes the cycle

Cache bootstrapping (lazy, per-state):
- new .templates/cache/interview-notes.md.template (funnel skeleton)
- interview-general bootstraps .cache/<session_id>/interview-notes.md from
  the template if absent, mirroring the model-data-schema journal precedent

Interview-implied rework as a second trigger source:
- interview-building-blocks flags findings that modify existing blocks
- author-test-stubs and write-test-py read both trigger sources (journal
  build-escalation + interview flags) -> @pytest.mark.pending

Branch discipline mechanized end-to-end:
- contract surface committed to dev at plan (simulate-contracts)
- build cuts feature/<session_id> off dev at entry (select-build-target)
- deliver squash-merges + deletes the branch (merge-to-dev); no dangling
- feature/<session_id> threads the existing session id; one per build cycle

AGENTS.md binding constraints sharpened:
- dispatched agent never transitions / skips / holds the todo
- todo-first as a hard constraint; two-hats model documented

Docstring lifecycle simplified to conceptual bullets (script is the
mechanical substitute; PYI021 covers stubs in lint).

Bumps version 10.0.0 -> 10.1.0.
@nullhack nullhack merged commit 296ce25 into main Jul 8, 2026
7 checks passed
@nullhack nullhack deleted the feat/v10.1.0-pipeline-improvements branch July 8, 2026 08:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant