// Shared deterministic runtime for API-authored contracts. No generated code is executed. export function conditionValue(condition, answers) { const values=condition.terms.map(term=>{ const a=answers[term.observer] if(!a||a.abstained||!a.choice||a.choice==='unknown'||a.choice==='unclear')return null return term.values.includes(a.choice) }) if(condition.operator==='any')return values.includes(true)?true:values.includes(null)?null:false return values.includes(false)?false:values.includes(null)?null:true } export function inWindow(window, minute) { if(!window)return true const toMin=s=>Number(s.slice(0,2))*60+Number(s.slice(3)) const start=toMin(window.start),end=toMin(window.end) return start<=end?minute>=start&&minute=start||minute[r.id,ruleState()]));this.seen=new Set();this.notices=[];this.traces=[];this.todo=new Set() } seedSnapshot(answers,capturedAt){ if(!this.snapshotComparison||!Number.isFinite(capturedAt))return for(const r of this.plan.rules){if(r.mode!=='change')continue;const value=conditionValue(r.condition,answers);if(value===null)continue;Object.assign(this.states[r.id],{baseline:value,lastValue:value,lastKnownAt:capturedAt})} } observe(evidence,answers,{signals={},manual=false}={}) { const {capturedAt,processedAt=capturedAt,frameId,cameraId=this.cameraId,sourceId=this.sourceId,quality='usable'}=evidence const trace={frameId,capturedAt,processedAt,rules:[],notices:[],accepted:false} const reject=reason=>{trace.reason=reason;this.traces.push(trace);return trace} if(this.plan.status!=='ready')return reject('plan_not_ready') if(this.seen.has(frameId))return reject('duplicate_frame') if(!Number.isFinite(capturedAt)||!Number.isFinite(processedAt))return reject('invalid_timestamp') if(cameraId!==this.cameraId||sourceId!==this.sourceId)return reject('source_mismatch') if(processedAt-capturedAt>this.maxAgeSeconds||capturedAt>processedAt+1)return reject('stale_evidence') if(Object.values(this.states).some(s=>s.lastAt!=null&&capturedAts.summaryDeadline&&inWindow(r.time_window,minute)){s=ruleState();this.states[r.id]=s} const step={id:r.id,mode:r.mode,value:null,status:'waiting',notified:false} trace.rules.push(step) if(!inWindow(r.time_window,minute)||(r.exclude_window&&inWindow(r.exclude_window,minute))){step.status='outside_window';continue} if(r.requires.some(key=>{const signal=signals[key];return !signal||!signal.value||!Number.isFinite(signal.observedAt)||!Number.isFinite(signal.validUntil)||signal.observedAt>capturedAt+1||signal.validUntilthis.comparisonMaxAgeSeconds){s.baseline=null;s.lastValue=null;s.candidate=null;s.candidateCount=0} if(gap>this.maxGapSeconds){s.positiveSince=null;s.thenCount=0;if(!snapshot){s.candidateCount=0;s.candidate=null}} s.lastKnownAt=capturedAt if(s.candidate===value)s.candidateCount++;else{s.candidate=value;s.candidateCount=1} if(value&&s.positiveSince==null)s.positiveSince=capturedAt if(!value)s.positiveSince=null const confirmed=s.candidateCount>=r.confirmation_frames if(r.mode==='now'){step.status='snapshot';s.lastValue=value;continue} if(r.mode==='change'&&s.baseline==null){ if(!confirmed){step.status='confirming_baseline';continue} s.baseline=value;s.lastValue=value;step.status=value?'target_at_creation':'baseline_recorded';continue } let trigger=false if(r.mode==='sequence'){ const next=conditionValue(r.then,answers) s.thenCount=next===true?s.thenCount+1:0 if(s.armedAt!=null&&capturedAt-s.armedAt>r.within_seconds)s.armedAt=null if(s.armedAt!=null&&capturedAt>s.armedAt&&s.thenCount>=r.confirmation_frames){trigger=true;s.armedAt=null;step.status='sequence_complete';s.thenCount=0} else if(value&&confirmed&&s.armedAt==null){s.armedAt=capturedAt;step.status='sequence_armed'} else step.status=s.armedAt==null?'waiting_first':'waiting_second' }else if(r.mode==='duration'){ const duration=s.positiveSince==null?0:capturedAt-s.positiveSince step.durationSeconds=duration trigger=!!(value&&confirmed&&duration>=r.duration_seconds&&!s.active) step.status=trigger?'duration_met':value?'timing':'negative' }else if(r.mode==='change'){ trigger=confirmed&&value===true&&s.lastValue===false&&(!r.recovery||!s.active) step.status=!confirmed?'confirming':trigger?'changed':'unchanged' }else{ trigger=confirmed&&value===true&&!s.active step.status=!confirmed?'confirming':trigger?'occurred':value?'same_episode':'negative' } if(confirmed){ const recovered=r.recovery?conditionValue(r.recovery,answers)===true:!value if(value&&!s.active&&(r.mode!=='duration'||trigger)){s.episodes++;s.ever=true} if(r.mode!=='duration'||trigger||!value){if(value)s.active=true;else if(recovered)s.active=false} s.lastValue=value if(recovered&&this.todo.has(r.id)){this.todo.delete(r.id);step.recovered=true} } if(trigger){ this.todo.add(r.id) if(r.notify==='realtime'&&(!manual||r.level===3)&&r.level>0&&(capturedAt-s.lastNotice>=r.cooldown_seconds||r.level>s.lastLevel)){ const notice={ruleId:r.id,title:r.title,at:capturedAt,level:r.level,status:step.status,frameId} this.notices.push(notice);trace.notices.push(notice);s.lastNotice=capturedAt;s.lastLevel=r.level;step.notified=true } } } this.traces.push(trace);return trace } finalize(at){ const reports=[] for(const r of this.plan.rules){ if(r.mode!=='window_summary')continue let s=this.states[r.id] if(s.summarySent){ const elapsed=Math.floor((at-s.summaryDeadline)/86400) if(!Number.isFinite(elapsed)||elapsed<1)continue const anchor=s.summaryDeadline+elapsed*86400-1 s=ruleState();s.windowAnchor=anchor;this.states[r.id]=s } const toMin=t=>Number(t.slice(0,2))*60+Number(t.slice(3)) const start=toMin(r.time_window.start),end=toMin(r.time_window.end),anchor=s.firstAt??s.windowAnchor??this.startedAt??at let base=Math.floor((anchor+8*3600)/86400)*86400-8*3600 if(end<=start&&shanghaiMinute(anchor)=deadline)deadline+=86400 if(at0)this.notices.push({ruleId:r.id,title:r.title,at,level:r.level,status:result.status,summary:true}) } return reports } snapshot(){return {states:this.states,notices:this.notices,todo:[...this.todo],traces:this.traces}} }