diff --git a/docs/release-control/v6/internal/subsystems/ai-runtime.md b/docs/release-control/v6/internal/subsystems/ai-runtime.md index 862e8af50..485e43c71 100644 --- a/docs/release-control/v6/internal/subsystems/ai-runtime.md +++ b/docs/release-control/v6/internal/subsystems/ai-runtime.md @@ -5728,6 +5728,12 @@ reports it immediately and does not spend logs, discovery, Docker-service, or other root-cause tool calls after confirmation; causal analysis belongs to the separate Pro investigation track. Quiet triage is not a deterministic replacement for model-owned assessment. +Model-authored structured findings remain concise for continuous operation: +description uses at most three short sentences, impact one sentence, evidence +three concrete facts, and recommendation two short sentences, without +repeating the same state or caveat across fields. Concision must preserve the +exact evidence needed to verify the finding rather than replacing it with a +generic summary. Provider-facing `pulse_docker` calls are host-scoped: every advertised action requires a Docker host name or ID in the structured schema, matching the executor contract and preventing invalid hostless Swarm-state calls. diff --git a/internal/ai/patrol_ai.go b/internal/ai/patrol_ai.go index 4db10fb46..80d9668af 100644 --- a/internal/ai/patrol_ai.go +++ b/internal/ai/patrol_ai.go @@ -1257,6 +1257,10 @@ Every finding must include the ` + "`evidence`" + ` field in patrol_report_findi - If you used pulse_metrics, pulse_storage, pulse_read, or any investigation tool, reference the key data points from those calls. - The operator should be able to look at your evidence and confirm: yes, this is real, I can see the same thing. +## Finding Concision + +Keep structured findings dense enough to scan and cheap enough to run continuously. Use at most three short sentences for ` + "`description`" + `, one sentence for ` + "`impact`" + `, three concrete facts for ` + "`evidence`" + `, and two short sentences for ` + "`recommendation`" + `. Do not repeat the same state, metric, or caveat across fields. Preserve the exact evidence needed to verify the conclusion; remove narration and speculative background. + ## Final Summary Format After completing your investigation, write a concise summary using this structure: diff --git a/internal/ai/patrol_ai_more_test.go b/internal/ai/patrol_ai_more_test.go index c7c9dc669..9a8593267 100644 --- a/internal/ai/patrol_ai_more_test.go +++ b/internal/ai/patrol_ai_more_test.go @@ -326,6 +326,8 @@ func TestGetPatrolSystemPrompt_IncludesTrustScaffoldingGuidance(t *testing.T) { required := []string{ "Authoring Impact", "Authoring Evidence", + "Finding Concision", + "at most three short sentences", "trust anchor", "Call patrol_get_findings exactly once", }