feat: establish the Target architecture as a graph before code
Design is now approved before any infrastructure code is written (ADR-0005). A new target-architect Specialist produces one graph of Elements, Relationships and Checks; the diagram is rendered from it, deployment guidance must account for every Check, and validation gives a verdict per Check. Requirements, components, products and recommendations carry ids in data files, and a submission with a gap in the Requirements chain is refused. Also in this commit: - Customer cases group Executions, with an intent history per case - lesson candidates are captured when an Execution ends - evaluation gains chain, verdict, judged and interactive checks, and per-case thresholds - Terraform providers are cached between checks - the requirements analyst proposes defaults instead of asking - the legacy-baseline case and the checks that only read it are removed - ADR-0006 (Change requests) accepted; ADR-0004 and ADR-0007 proposed - plans for iterations 4 to 7 under .agents/plans/ Unproven with a real model: no evaluation run has completed on this design. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -3,12 +3,58 @@
|
||||
from __future__ import annotations
|
||||
|
||||
import operator
|
||||
import re
|
||||
from pathlib import Path
|
||||
from typing import Annotated, Any, TypedDict
|
||||
|
||||
# A Customer case id becomes a directory name, so it is a short lowercase slug.
|
||||
CUSTOMER_CASE = re.compile(r"^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$")
|
||||
# Executions started without a Customer case are grouped here, so every Execution's
|
||||
# files sit under a case.
|
||||
UNASSIGNED_CASE = "unassigned"
|
||||
|
||||
|
||||
def check_customer_case(customer_case: object) -> str:
|
||||
"""The Customer case id, defaulting to UNASSIGNED_CASE; a ValueError when it is
|
||||
not a safe slug."""
|
||||
if customer_case is None:
|
||||
return UNASSIGNED_CASE
|
||||
if not isinstance(customer_case, str) or not CUSTOMER_CASE.match(customer_case):
|
||||
raise ValueError(
|
||||
"customer_case must be 1 to 64 lowercase letters, digits or hyphens, "
|
||||
f"starting and ending with a letter or digit; got {customer_case!r}"
|
||||
)
|
||||
return customer_case
|
||||
|
||||
|
||||
def case_dir(output_root: Path, customer_case: str) -> Path:
|
||||
"""Everything generated for one Customer case."""
|
||||
return output_root / "deliverables" / "cases" / customer_case
|
||||
|
||||
|
||||
def execution_dir(output_root: Path, execution_id: str, customer_case: str) -> Path:
|
||||
"""Where one Execution's files go, under its Customer case."""
|
||||
return case_dir(output_root, customer_case) / "executions" / execution_id
|
||||
|
||||
|
||||
def lessons_file(output_root: Path, execution_id: str, customer_case: str) -> Path:
|
||||
return (
|
||||
output_root / "lessons" / "candidates" / customer_case / f"{execution_id}.json"
|
||||
)
|
||||
|
||||
|
||||
def merge_by_key(
|
||||
current: dict[str, dict[str, Any]] | None, update: dict[str, dict[str, Any]] | None
|
||||
) -> dict[str, dict[str, Any]]:
|
||||
"""Parallel Specialist tasks each write their own Deliverable's entry."""
|
||||
return {**(current or {}), **(update or {})}
|
||||
|
||||
|
||||
class ExecutionState(TypedDict, total=False):
|
||||
execution_id: str
|
||||
session_id: str
|
||||
customer_case: str # the Customer case this Execution belongs to
|
||||
intent_version: int # which statement of the case's intent started this Execution
|
||||
workflow_request: str
|
||||
pre_approved: bool
|
||||
allow_cloud_read: bool | None
|
||||
@@ -21,6 +67,11 @@ class ExecutionState(TypedDict, total=False):
|
||||
pending_questions: list[dict[str, Any]] # {kind, questions} not yet asked
|
||||
awaiting_questions: list[dict[str, Any]] # {kind, questions} asked, not answered
|
||||
answers: dict[str, list[dict[str, Any]]] # kind -> [{questions, reply}]
|
||||
drafts: dict[
|
||||
str, dict[str, Any]
|
||||
] # kind -> {content, attachments} awaiting the user
|
||||
# kind -> working memory its tools keep across attempts (e.g. pillar advice)
|
||||
working: Annotated[dict[str, dict[str, Any]], merge_by_key]
|
||||
pending_permission: dict[str, Any] | None # {tier, requested_by}
|
||||
prompt: dict[str, Any] | None # what the user is being asked
|
||||
|
||||
@@ -28,6 +79,7 @@ class ExecutionState(TypedDict, total=False):
|
||||
# applied to the Ledger by the next Orchestrator turn.
|
||||
outcomes: Annotated[list[dict[str, Any]], operator.add]
|
||||
outcomes_applied: int
|
||||
refusals: list[dict[str, Any]] # the Orchestrator's refused tool calls
|
||||
events_recorded: int
|
||||
|
||||
turns: int
|
||||
|
||||
Reference in New Issue
Block a user