"""Facts from one helper invocation; process exit is not a Save result.""" from collections.abc import Sequence def recheck_failed_release(library, block, result): """Refresh resource facts after a late exit; keep the original business failure.""" if result.safe_to_continue or not result.evidence_path: return result from pathlib import Path from dataclasses import replace import json from .session_record import read_session_record, inspect_session_record from .library_lock import release_retained_library evidence = Path(result.evidence_path) try: session = Path(getattr(result, 'session_record_path', None) or evidence.with_name('session.json')) if session.is_file(): record = read_session_record(session, evidence_root=evidence.parent) if record.get('block') != block or Path(record.get('library', '')).resolve() != Path(library).resolve(): return result if inspect_session_record(session, evidence_root=evidence.parent).get('status') == 'ACTIVE': return result else: record = json.loads(evidence.read_text('utf-8')) if (record.get('name') != block or record.get('operation') not in ('add', 'update', 'remove') or Path(record.get('library', '')).resolve() != Path(library).resolve()): return result bound = [] for phase in ('before', 'remove', 'after-remove', 'add', 'after-add'): candidate = evidence.parent/phase/'session.json' if candidate.is_file(): owned = read_session_record(candidate, evidence_root=evidence.parent) if Path(owned.get('library', '')).resolve() != Path(library).resolve(): return result if inspect_session_record(candidate, evidence_root=evidence.parent).get('status') == 'ACTIVE': return result bound.append(candidate) if not bound: return result # A generic timeout without a bound owner is not an exit fact. proof = release_retained_library(library, evidence.parent/'late-release', block_name=block) if proof.get('status') != 'RELEASE_CONFIRMED' or Path(proof.get('library', '')).resolve() != Path(library).resolve(): return result evidence.with_name('late-release-result.json').write_text(json.dumps(dict( business_status=result.status, safe_to_continue=True, release_proof=proof), ensure_ascii=False, default=str, indent=2), 'utf-8') return replace(result, safe_to_continue=True, release_proof=proof) except Exception: return result def classify_save_state(markers: Sequence[str], *, helper_exited: bool | None, native_released: bool | None, forced: bool = False) -> dict: names = {line.strip().split('|', 1)[0] for line in markers} save_results = names & {'SAVE_OK', 'SAVE_REJECTED', 'SAVE_RESULT_UNKNOWN', 'CANCELLED_BEFORE_SAVE'} conflicting_save = (len(save_results) > 1 or ('CANCELLED_BEFORE_SAVE' in names and 'SAVE_START' in names)) conflicting_close = {'CLOSE_OK', 'CLOSE_FAILED'} <= names save_state = 'UNKNOWN' if not conflicting_save: for marker, state in (('SAVE_OK', 'COMMITTED'), ('SAVE_REJECTED', 'REJECTED'), ('CANCELLED_BEFORE_SAVE', 'NOT_STARTED')): if marker in names: save_state = state close_state = 'UNKNOWN' if not conflicting_close: if 'CLOSE_OK' in names: close_state = 'CLOSED' elif 'CLOSE_FAILED' in names: close_state = 'FAILED' resource_state = ('RELEASED' if native_released is True and helper_exited is True else 'RETAINED' if native_released is False or helper_exited is False else 'UNKNOWN') reasons = [] if conflicting_save or conflicting_close: reasons.append('本轮返回标记矛盾') if save_state == 'UNKNOWN': reasons.append('保存返回结果无法确认') if close_state == 'FAILED': reasons.append('原生关闭失败') if 'POST_SAVE_FAILED' in names: reasons.append('保存后核对失败') if forced: reasons.append('会话被中断,退出不代表保存完成') interrupted = (forced or conflicting_save or conflicting_close or 'SAVE_RESULT_UNKNOWN' in names or (helper_exited is True and 'SAVE_START' in names and save_state == 'UNKNOWN')) return dict(save_state=save_state, close_state=close_state, helper_state='EXITED' if helper_exited is True else 'RUNNING' if helper_exited is False else 'UNKNOWN', resource_state=resource_state, interrupted=interrupted, detail=';'.join(reasons)) def stop_disposition(*, call_started: bool | None, call_returned: bool | None, identity_confirmed: bool) -> str: if not identity_confirmed or call_started is None: return 'OBSERVE_UNCONFIRMED' if call_started is False: return 'CANCEL_BEFORE_CALL' if call_returned is False else 'OBSERVE_UNCONFIRMED' return 'CLEANUP_RETURNED' if call_returned is True else 'WAIT_FOR_RETURN'