Files
gcp_solution_architecture_a…/app/baseline.py
Jonathan Boniface 5ef434d00e 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>
2026-10-09 11:38:15 +01:00

96 lines
3.9 KiB
Python

"""The Baseline of a Change request (ADR-0006).
A Change request is an Execution that starts from the Deliverables of a completed
Execution of the same Customer case. That Execution is its Baseline. It is read from
its files under the Customer case, through its manifest, so it does not depend on a
checkpoint and survives a restart. It is only ever read: a Baseline is never modified.
"""
from __future__ import annotations
import json
import re
from pathlib import Path
from typing import Any
from app.states.execution_state import UNASSIGNED_CASE, case_dir, execution_dir
MANIFEST_FILENAME = "execution.json"
COMPLETED = "completed"
_EXECUTION_ID = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$")
class BaselineError(ValueError):
"""The Execution named as a Baseline cannot be one; the message says why."""
def load_baseline(
output_root: Path, customer_case: str, execution_id: str
) -> dict[str, Any]:
"""The Baseline as plain data: its id, its request and every Deliverable.
Raises BaselineError when the Execution does not exist, belongs to another
Customer case, or did not complete.
"""
if not isinstance(execution_id, str) or not _EXECUTION_ID.match(execution_id):
raise BaselineError(f"baseline {execution_id!r} is not an Execution id")
if customer_case == UNASSIGNED_CASE:
raise BaselineError(
"a Change request needs a customer_case: a Baseline is a completed "
"Execution of the same Customer case"
)
folder = execution_dir(output_root, execution_id, customer_case)
manifest_path = folder / MANIFEST_FILENAME
if not manifest_path.is_file():
elsewhere = [
path.parent.parent.parent.name
for path in case_dir(output_root, "x").parent.glob(
f"*/executions/{execution_id}/{MANIFEST_FILENAME}"
)
]
if elsewhere:
# Never say which: one case must learn nothing about another.
raise BaselineError(
f"baseline {execution_id} belongs to another Customer case"
)
raise BaselineError(
f"baseline {execution_id} is not an Execution of Customer case "
f"{customer_case} with files on record"
)
try:
manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
except ValueError as exc:
raise BaselineError(f"baseline {execution_id} has no readable record") from exc
if manifest.get("customer_case") not in (None, customer_case):
raise BaselineError(f"baseline {execution_id} belongs to another Customer case")
if manifest.get("status", COMPLETED) != COMPLETED:
raise BaselineError(
f"baseline {execution_id} did not complete ({manifest.get('status')}); "
"a Change request starts from a completed Execution"
)
deliverables: dict[str, dict[str, Any]] = {}
for kind, entry in (manifest.get("deliverables") or {}).items():
document = folder / str(entry.get("document", ""))
if not document.is_file():
raise BaselineError(f"baseline {execution_id} is missing its {kind} file")
attachments = {}
for name in entry.get("attachments") or ():
path = folder / name
if not path.is_file():
raise BaselineError(f"baseline {execution_id} is missing {name}")
attachments[name] = path.read_text(encoding="utf-8")
deliverables[kind] = {
"content": document.read_text(encoding="utf-8"),
"attachments": attachments,
}
if not deliverables:
raise BaselineError(f"baseline {execution_id} holds no Deliverables")
return {
"execution_id": execution_id,
"customer_case": customer_case,
"workflow_request": manifest.get("workflow_request", ""),
"baseline": manifest.get("baseline"), # what it was itself changed from
"deliverables": deliverables,
}