Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
246ffc0
feat(sdl): add authored participant episode policies to behavior spec…
doublewhy Oct 9, 2026
86840a9
fix(sdl): resolve episode reset authorities and keep truncation disti…
doublewhy Oct 10, 2026
a621809
test: republish research evidence for issue #307
doublewhy Oct 10, 2026
94113b7
Merge remote-tracking branch 'origin/dev' into 307-participant-episod…
doublewhy Oct 25, 2026
ec51ed9
fix(sdl): reject an imported episode reset authority that its own uni…
doublewhy Oct 25, 2026
a671d75
ci(proof): fetch the locked isabelle archive from the official releas…
doublewhy Oct 25, 2026
0126d25
chore(policy): give DSL-120 its own phase and issue scope so governan…
doublewhy Oct 25, 2026
a26d244
test: record research captures for issue #307 on the merged source
doublewhy Oct 25, 2026
08740e4
chore(governance): assign the issue #307 research captures to DSL-120
doublewhy Oct 25, 2026
834d35c
test: expect the compile controls' digest-only deviations in the curr…
doublewhy Oct 25, 2026
2c96be8
Merge remote-tracking branch 'origin/dev' into 307-participant-episod…
doublewhy Oct 25, 2026
e7b36f5
test: drop the issue #307 captures recorded for the pre-merge source
doublewhy Oct 25, 2026
674a353
test: record research captures for issue #307 on the merged source
doublewhy Oct 25, 2026
3999704
chore(governance): assign the issue #307 research captures to DSL-120
doublewhy Oct 25, 2026
7397ded
Merge remote-tracking branch 'origin/dev' into 307-participant-episod…
doublewhy Oct 25, 2026
370cac2
test: drop the issue #307 captures recorded for the pre-merge source
doublewhy Oct 25, 2026
a4a52b1
test: record research captures for issue #307 on the merged source
doublewhy Oct 25, 2026
c039318
chore(governance): assign the issue #307 research captures to DSL-120
doublewhy Oct 25, 2026
fcda94e
Merge remote-tracking branch 'origin/dev' into 307-participant-episod…
doublewhy Oct 26, 2026
3d2cfc4
test: drop the issue #307 captures recorded for the pre-merge source
doublewhy Oct 26, 2026
dd118f2
test: record research captures for issue #307 on the merged source
doublewhy Oct 26, 2026
8474efc
chore(governance): assign the issue #307 research captures to DSL-120
doublewhy Oct 26, 2026
5b719f5
Merge remote-tracking branch 'refs/remotes/origin/dev' into 307-parti…
Brad-Edwards Nov 11, 2026
f48daa1
fix(sdl): admit standalone episode policies and reject empty schema p…
Brad-Edwards Nov 11, 2026
4d0653d
fix(sdl): compose episode validation and preserve absent-policy finge…
Brad-Edwards Nov 11, 2026
8604f32
fix(sdl): align episode test imports with the CI project context
Brad-Edwards Nov 11, 2026
f88f736
test(sdl): account for absent episode intent in retained fingerprints
Brad-Edwards Nov 11, 2026
f6a6bfa
test(sdl): scope diagnostic guards to validator ancestors
Brad-Edwards Nov 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .vale.ini
Original file line number Diff line number Diff line change
Expand Up @@ -295,6 +295,9 @@ RAES.ReadingLevel = NO
RAES.ReadingLevel = NO

# Preserve fixed requirement terms and artifact labels; review wording separately.
[**/docs/requirements/DSL-120/requirement.md]
RAES.ReadingLevel = NO

[**/docs/requirements/DSL-435/requirement.md]
RAES.ReadingLevel = NO

Expand Down
19 changes: 19 additions & 0 deletions contracts/fixtures/sdl/participant-episode-policy-v1/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Participant episode policy fixtures

These fixtures check `behavior_specifications.*.episode_policy` for DSL-120.

The [valid fixture](valid/analyst-shift-episode.yaml) uses a participant that is not autonomous.
Its policy has start checks, decision-epoch turns, completion, timeout, truncation, and reset intent.
It must pass strict source decoding.
It must also pass semantic validation.
The compiler emits `participant.episode-policy.analyst-triage`.
This record uses the participant's `participant.behavior.analyst` episode address.

The [invalid fixture](invalid/realized-episode-state.yaml) uses the same scenario.
Its policy asserts lifecycle status, initialization time, decision epoch, and terminal reason.
Source decoding must reject it.
An authored policy declares intent only.
Realized episode state stays with the ADR-013 participant episode contracts.

These fixtures do not show episode execution, reset, or an observed terminal condition.
The [episode policy reference](../../../../docs/explain/sdl/participant-episode-policies.md) explains the fields and their limits.
Original file line number Diff line number Diff line change
@@ -0,0 +1,175 @@
name: dsl-120
nodes:
siem:
type: compute
resources: {ram: 1 gib, cpu: 1}
services: [{port: 443, name: console}]
entities:
blue-team:
role: blue
propositions:
console-ready:
description: The SIEM console is reachable before the analyst episode starts.
subjects: [nodes.siem.services.console]
basis: declared_state
predicate:
kind: boolean
property: console-reachable
semantic_ref: urn:raes:observable:console-reachable
expected: true
ticket-closed:
description: The analyst closed the escalated incident ticket.
subjects: [nodes.siem.services.console]
basis: observed_state
predicate:
kind: boolean
property: incident-ticket-closed
semantic_ref: urn:raes:observable:incident-ticket-closed
expected: true
evidence_requirements: [ticket-evidence]
queue-stalled:
description: The alert queue stopped producing new work for the analyst.
subjects: [nodes.siem.services.console]
basis: observed_state
predicate:
kind: boolean
property: alert-queue-stalled
semantic_ref: urn:raes:observable:alert-queue-stalled
expected: true
evidence_requirements: [queue-evidence]
assertions:
console-ready:
proposition: console-ready
role: precondition
ticket-closed:
proposition: ticket-closed
role: postcondition
queue-stalled:
proposition: queue-stalled
role: postcondition
time_domains:
shift-time:
kind: logical
tick_period_seconds: {numerator: 60, denominator: 1}
epoch: scenario_start
visibility: participant_visible
description: analyst shift logical time
clocks:
shift-clock:
time_domain_ref: shift-time
authority_kind: runtime
authority_ref: runtime.scheduler
monotonicity: non_decreasing
description: analyst shift clock
temporal_constraints:
shift-deadline:
constraint_kind: deadline
clock_ref: shift-clock
subject_refs: [behavior_specifications.analyst-triage]
end: {tick: 480}
description: the analyst episode must close within one shift
evidence_requirements:
ticket-evidence:
description: capture the ticket closure record
source_refs: [nodes.siem.services.console]
scope_refs: [siem]
window: analyst episode close
channel: log
artifact_role: episode_terminal_evidence
sensitivity: plain
redaction: none
integrity: checksum
retention: study_lifetime
loss_disclosure: required
queue-evidence:
description: capture the alert queue telemetry
source_refs: [nodes.siem.services.console]
scope_refs: [siem]
window: analyst episode close
channel: log
artifact_role: episode_truncation_evidence
sensitivity: plain
redaction: none
integrity: checksum
retention: study_lifetime
loss_disclosure: required
shift-clock-evidence:
description: capture the shift clock reading at episode close
source_refs: [behavior_specifications.analyst-triage]
scope_refs: [siem]
window: analyst episode close
channel: log
artifact_role: episode_timeout_evidence
sensitivity: plain
redaction: none
integrity: checksum
retention: study_lifetime
loss_disclosure: required
reset-evidence:
description: capture the episode reset or restart record
source_refs: [behavior_specifications.analyst-triage]
scope_refs: [siem]
window: analyst episode reset
channel: log
artifact_role: episode_reset_evidence
sensitivity: plain
redaction: none
integrity: checksum
retention: study_lifetime
loss_disclosure: required
action_contracts:
triage-alert:
semantic_version: 1.0.0
behavioral_granularity: atomic
procedure_basis: analyst reviews one SIEM alert and records a disposition
realization_profile: backend-declared
fidelity_claim: records the analyst disposition and the terminal console observation
preconditions:
- precondition_id: console-in-scope
precondition_class: target
description: the SIEM console is in the analyst's action scope
support_refs: [nodes.siem.services.console]
effects:
- effect_id: alert-disposition-recorded
effect_class: intended_effect
description: the analyst records a disposition for the alert
target_refs: [nodes.siem.services.console]
failure_classes: [target_unavailable, unknown]
agents:
analyst:
affiliations: [blue-team]
actions: [triage-alert]
behavior_specifications:
analyst-triage:
semantic_version: 1.0.0
participant_refs: [analyst]
action_contract_refs: [triage-alert]
behavior_mode: human-supervised
episode_policy:
profile: participant-episode-policy/v1
status: terminated
initialized_at: '2026-10-09T00:00:00Z'
decision_epoch: 3
terminal_reason: completed
initialization:
assertion_refs: [console-ready]
interaction_structure:
order_basis: decision-epoch
action_contract_refs: [triage-alert]
terminal_conditions:
ticket-closed:
terminal_reason: completed
assertion_refs: [ticket-closed]
evidence_requirement_refs: [ticket-evidence]
shift-ended:
terminal_reason: timed_out
temporal_constraint_ref: shift-deadline
evidence_requirement_refs: [shift-clock-evidence]
truncation_conditions:
queue-stalled:
assertion_refs: [queue-stalled]
evidence_requirement_refs: [queue-evidence]
reset_policy:
control_actions: [reset, restart]
participant_memory_scope: persistent_across_episodes
evidence_requirement_refs: [reset-evidence]
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
name: dsl-120
nodes:
siem:
type: compute
resources: {ram: 1 gib, cpu: 1}
services: [{port: 443, name: console}]
entities:
blue-team:
role: blue
propositions:
console-ready:
description: The SIEM console is reachable before the analyst episode starts.
subjects: [nodes.siem.services.console]
basis: declared_state
predicate:
kind: boolean
property: console-reachable
semantic_ref: urn:raes:observable:console-reachable
expected: true
ticket-closed:
description: The analyst closed the escalated incident ticket.
subjects: [nodes.siem.services.console]
basis: observed_state
predicate:
kind: boolean
property: incident-ticket-closed
semantic_ref: urn:raes:observable:incident-ticket-closed
expected: true
evidence_requirements: [ticket-evidence]
queue-stalled:
description: The alert queue stopped producing new work for the analyst.
subjects: [nodes.siem.services.console]
basis: observed_state
predicate:
kind: boolean
property: alert-queue-stalled
semantic_ref: urn:raes:observable:alert-queue-stalled
expected: true
evidence_requirements: [queue-evidence]
assertions:
console-ready:
proposition: console-ready
role: precondition
ticket-closed:
proposition: ticket-closed
role: postcondition
queue-stalled:
proposition: queue-stalled
role: postcondition
time_domains:
shift-time:
kind: logical
tick_period_seconds: {numerator: 60, denominator: 1}
epoch: scenario_start
visibility: participant_visible
description: analyst shift logical time
clocks:
shift-clock:
time_domain_ref: shift-time
authority_kind: runtime
authority_ref: runtime.scheduler
monotonicity: non_decreasing
description: analyst shift clock
temporal_constraints:
shift-deadline:
constraint_kind: deadline
clock_ref: shift-clock
subject_refs: [behavior_specifications.analyst-triage]
end: {tick: 480}
description: the analyst episode must close within one shift
evidence_requirements:
ticket-evidence:
description: capture the ticket closure record
source_refs: [nodes.siem.services.console]
scope_refs: [siem]
window: analyst episode close
channel: log
artifact_role: episode_terminal_evidence
sensitivity: plain
redaction: none
integrity: checksum
retention: study_lifetime
loss_disclosure: required
queue-evidence:
description: capture the alert queue telemetry
source_refs: [nodes.siem.services.console]
scope_refs: [siem]
window: analyst episode close
channel: log
artifact_role: episode_truncation_evidence
sensitivity: plain
redaction: none
integrity: checksum
retention: study_lifetime
loss_disclosure: required
shift-clock-evidence:
description: capture the shift clock reading at episode close
source_refs: [behavior_specifications.analyst-triage]
scope_refs: [siem]
window: analyst episode close
channel: log
artifact_role: episode_timeout_evidence
sensitivity: plain
redaction: none
integrity: checksum
retention: study_lifetime
loss_disclosure: required
reset-evidence:
description: capture the episode reset or restart record
source_refs: [behavior_specifications.analyst-triage]
scope_refs: [siem]
window: analyst episode reset
channel: log
artifact_role: episode_reset_evidence
sensitivity: plain
redaction: none
integrity: checksum
retention: study_lifetime
loss_disclosure: required
action_contracts:
triage-alert:
semantic_version: 1.0.0
behavioral_granularity: atomic
procedure_basis: analyst reviews one SIEM alert and records a disposition
realization_profile: backend-declared
fidelity_claim: records the analyst disposition and the terminal console observation
preconditions:
- precondition_id: console-in-scope
precondition_class: target
description: the SIEM console is in the analyst's action scope
support_refs: [nodes.siem.services.console]
effects:
- effect_id: alert-disposition-recorded
effect_class: intended_effect
description: the analyst records a disposition for the alert
target_refs: [nodes.siem.services.console]
failure_classes: [target_unavailable, unknown]
agents:
analyst:
affiliations: [blue-team]
actions: [triage-alert]
behavior_specifications:
analyst-triage:
semantic_version: 1.0.0
participant_refs: [analyst]
action_contract_refs: [triage-alert]
behavior_mode: human-supervised
episode_policy:
profile: participant-episode-policy/v1
initialization:
assertion_refs: [console-ready]
interaction_structure:
order_basis: decision-epoch
action_contract_refs: [triage-alert]
terminal_conditions:
ticket-closed:
terminal_reason: completed
assertion_refs: [ticket-closed]
evidence_requirement_refs: [ticket-evidence]
shift-ended:
terminal_reason: timed_out
temporal_constraint_ref: shift-deadline
evidence_requirement_refs: [shift-clock-evidence]
truncation_conditions:
queue-stalled:
assertion_refs: [queue-stalled]
evidence_requirement_refs: [queue-evidence]
reset_policy:
control_actions: [reset, restart]
participant_memory_scope: persistent_across_episodes
evidence_requirement_refs: [reset-evidence]
Loading
Loading