File size: 8,978 Bytes
90d354b 133b124 90d354b 133b124 90d354b 133b124 90d354b 133b124 90d354b 133b124 90d354b 133b124 90d354b 133b124 90d354b 133b124 90d354b | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 | // 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<end:minute>=start||minute<end
}
export function shanghaiMinute(seconds) {
const d=new Date(seconds*1000)
const parts=new Intl.DateTimeFormat('en-GB',{timeZone:'Asia/Shanghai',hour:'2-digit',minute:'2-digit',hourCycle:'h23'}).format(d).split(':')
return Number(parts[0])*60+Number(parts[1])
}
function ruleState() {
return {firstAt:null,lastAt:null,lastValue:null,baseline:null,candidate:null,candidateCount:0,thenCount:0,positiveSince:null,armedAt:null,active:false,ever:false,episodes:0,unknown:0,valid:0,observations:0,lastNotice:-Infinity,lastLevel:0,summarySent:false}
}
export class ContractEngine {
constructor(plan,{cameraId='camera',sourceId='source',maxGapSeconds=8,maxAgeSeconds=120,startedAt=null,snapshotComparison=false,comparisonMaxAgeSeconds=86400}={}) {
this.plan=plan;this.cameraId=cameraId;this.sourceId=sourceId;this.maxGapSeconds=maxGapSeconds;this.maxAgeSeconds=maxAgeSeconds
this.startedAt=startedAt
this.snapshotComparison=snapshotComparison;this.comparisonMaxAgeSeconds=comparisonMaxAgeSeconds
this.states=Object.fromEntries(plan.rules.map(r=>[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&&capturedAt<s.lastAt))return reject('out_of_order')
this.seen.add(frameId);trace.accepted=true
for(const r of this.plan.rules){
let s=this.states[r.id];const minute=shanghaiMinute(capturedAt)
if(r.mode==='window_summary'&&s.summarySent&&capturedAt>s.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.validUntil<capturedAt||typeof signal.source!=='string'||!signal.source.length})){step.status='external_gate';continue}
s.observations++
const gap=s.lastAt==null?0:capturedAt-s.lastAt
s.lastAt=capturedAt
if(s.firstAt==null)s.firstAt=capturedAt
const value=quality==='usable'?conditionValue(r.condition,answers):null
step.value=value
if(value==null){s.unknown++;s.candidate=null;s.candidateCount=0;s.thenCount=0;s.positiveSince=null;step.status='unknown';continue}
s.valid++
const snapshot=this.snapshotComparison&&['change','occurrence','now'].includes(r.mode)
if(snapshot&&s.lastKnownAt!=null&&capturedAt-s.lastKnownAt>this.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)<end)base-=86400
let deadline=base+end*60+(end<=start?86400:0)
if(s.firstAt==null&&this.startedAt!=null&&this.startedAt>=deadline)deadline+=86400
if(at<deadline)continue
const result={ruleId:r.id,at,observed:s.ever,episodes:s.episodes,valid:s.valid,unknown:s.unknown,status:s.ever?'observed':s.valid?'not_observed':'insufficient_evidence'}
reports.push(result);s.summarySent=true;s.summaryDeadline=deadline
if(r.notify==='summary'&&r.level>0)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}}
}
|