Skip to content

feat: establish Phase 1 workflow domain contracts - #324

Open
eshulman2 wants to merge 3 commits into
mainfrom
phase1/domain-contracts
Open

feat: establish Phase 1 workflow domain contracts#324
eshulman2 wants to merge 3 commits into
mainfrom
phase1/domain-contracts

Conversation

@eshulman2

@eshulman2 eshulman2 commented Aug 27, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • define strict, immutable, versioned Forge domain contracts
  • convert source-control NormalizedEvent into deterministic webhook/poller Observation objects
  • project broad checkpoint/provider facts into a scoped implementation-input request
  • run implementation resolution as a provider- and LangGraph-independent station
  • validate station outcomes through an allowlisted reducer owning four checkpoint fields
  • provide a serialized local station runner and architecture/conformance tests
  • document Phase 1 delivery, implications, and coupling measurements

Stack

This PR is intentionally stacked on PR #318 and remains separate from PRs #320, #317 and #318. All downstream branches were rebased after the latest PR #320 update.

Compatibility

  • existing BaseState checkpoints remain valid
  • graph topology and routes are unchanged
  • the existing resolve_implementation_input(state, jira) call shape is preserved
  • effects remain inline until Phase 3

Verification

  • make lint
  • uv run pytest -q tests/unit — 2396 passed
  • uv run pytest tests/workflow tests/contracts tests/flows -q --strict-markers — 412 passed

@eshulman2
eshulman2 force-pushed the prototype/layered-planning-state branch from d8af4ee to 4a58200 Compare August 27, 2026 12:51
@eshulman2
eshulman2 force-pushed the phase1/domain-contracts branch from 9fbeaad to 9007db2 Compare August 27, 2026 12:51
@eshulman2
eshulman2 marked this pull request as ready for review August 27, 2026 12:56
@eshulman2
eshulman2 force-pushed the phase1/domain-contracts branch from 19b0cc8 to 3204b88 Compare August 27, 2026 12:57
@eshulman2
eshulman2 force-pushed the phase1/domain-contracts branch from 3204b88 to f947084 Compare August 27, 2026 17:20
@eshulman2
eshulman2 changed the base branch from prototype/layered-planning-state to main August 27, 2026 17:20
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