feat: Change requests against a Baseline (ADR-0006)

A caller restates a request to say how requirements have changed, naming a
completed Execution of the same Customer case as the Baseline.

- app/baseline.py reads a Baseline from its files and refuses one that
  does not exist, did not complete or belongs to another case, before
  anything runs or is recorded. A Baseline is never modified.
- Requirements carry a change (unchanged, added, changed, removed) and a
  reason. Submission is refused when a Baseline requirement disappears, an
  id is reused, or an unchanged requirement's text differs. A removed
  requirement stays on record and asks nothing downstream.
- Each Specialist starts from its delivered version; the graph and the code
  are its working copy, and the description is carried over when the
  design's shape is the same.
- app/workflows/changes.py compares versions by id and traces what each
  changed requirement reaches; anything else that changed is listed as
  unrequested. Approvals show the change for their Phase, and changes.json
  is written with the full Deliverables.
- Intake no longer starts a message read as a change: it names the
  Execution to give as the Baseline.
- A fifth evaluation case runs a request and then a change to it, with
  four checks that the change is recorded, reaches Checks, stays contained
  and costs less than its Baseline.

Tested with scripted agents only; no Change request has run with real
models.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-09 11:38:15 +01:00
parent db28d02f56
commit 5ef434d00e
32 changed files with 1824 additions and 40 deletions

View File

@@ -49,8 +49,13 @@ def record_intent(
execution_id: str,
session_id: str,
workflow_request: str,
baseline: str | None = None,
) -> int:
"""Record a new statement of the customer's intent and return its version."""
"""Record a new statement of the customer's intent and return its version.
`baseline` is the Execution a Change request starts from; with it the history
shows the case's line of versions.
"""
folder = intent_dir(output_root, customer_case)
folder.mkdir(parents=True, exist_ok=True)
history = read_history(output_root, customer_case)
@@ -60,7 +65,9 @@ def record_intent(
(folder / statement).write_text(
f"# Intent {version}: {customer_case}\n\n"
f"- Recorded: {recorded_at}\n"
f"- Execution: `{execution_id}`\n\n"
f"- Execution: `{execution_id}`\n"
+ (f"- Changes: `{baseline}`\n" if baseline else "")
+ "\n"
f"## What the customer wants\n\n{workflow_request.strip()}\n",
encoding="utf-8",
)
@@ -74,6 +81,7 @@ def record_intent(
"session_id": session_id,
"status": IN_PROGRESS,
"execution": None,
"baseline": baseline,
}
)
_write_history(folder, history)