diff --git a/.fusion-addin.json b/.fusion-addin.json index 93c8d72..da17141 100644 --- a/.fusion-addin.json +++ b/.fusion-addin.json @@ -1,6 +1,6 @@ { "name": "Mesora", "display_name": "Mesora", - "description": "Experimental informational 3D dimensions (session-only safe mode).", + "description": "Informational 3D measurements with saved definitions and per-document visibility.", "initialized": true } diff --git a/Mesora/Mesora.manifest b/Mesora/Mesora.manifest index e25ca84..aff4cf2 100644 --- a/Mesora/Mesora.manifest +++ b/Mesora/Mesora.manifest @@ -3,7 +3,7 @@ "type": "addin", "author": "4FusionLab", "description": { - "": "Experimental informational 3D dimensions (session-only safe mode)." + "": "Informational 3D measurements with saved definitions and per-document visibility." }, "version": "1.0.0", "supportedOS": "windows|mac", diff --git a/Mesora/Mesora.py b/Mesora/Mesora.py index 41036cb..e4d888d 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -1,4 +1,4 @@ -"""Mesora: experimental session-only build.""" +"""Mesora: persistent informational 3D measurements.""" import traceback from pathlib import Path import adsk.core @@ -6,13 +6,20 @@ from .dimensions.fusion_geometry import measure, reference_for, resolve from . import renderer from .dimensions.batch import Batch, RowDraft, duplicate_rows +from .dimensions.event_scope import EventScope +from .dimensions.runtime_persistence import load_state, save_state +from .dimensions.update_fingerprint import geometry_fingerprint APP = adsk.core.Application.get() UI = APP.userInterface HANDLERS = [] +COMMAND_SCOPES = [] DEFINITIONS = [] CONTROLS = [] STATES = [] +WORKSPACE_CHANGING = False +UPDATE_EVENT_ID = '4FusionLab.Mesora.GeometryUpdate' +UPDATE_PENDING = False PANEL_ID = 'InspectPanel' INSPECT_PANELS = ( ('FusionSolidEnvironment', 'InspectPanel'), @@ -44,16 +51,48 @@ def bind(event, handler): HANDLERS.append((event, handler)) +def graphics_workspace(): + """Do not update design graphics during a workspace transition or in Drawing.""" + if WORKSPACE_CHANGING: + return False + try: + workspace = UI.activeWorkspace + return bool(workspace and workspace.id in {entry[0] for entry in INSPECT_PANELS}) + except RuntimeError: + return False # No active session (Home or an intermediate workspace). + + +def visibility_button(button, visible, subject): + button.resourceFolder = icon('visibility' if visible else 'visibility_off') + button.tooltip = ('Hide ' if visible else 'Show ') + subject + + class State: def __init__(self, doc, design): self.doc, self.design = doc, design self.items, self.groups = [], [] self.offsets = {} self.visible = True + self.hidden_ids = set() self.removed_for_save = False self.preview = None self.live_preview = [] self.next_id = 1 + self.fingerprint = None + self.editor_open = False + self.restore_requested = False + + def load(self): + stored = load_state(self.design) + self.items = stored.items + self.offsets = stored.offsets + self.hidden_ids = stored.hidden_ids + self.visible = stored.visible + self.next_id = stored.next_id + + def persist(self): + return save_state(self.design, self.items, self.offsets, + self.hidden_ids, self.visible) def erase_preview(self): if self.preview is not None: @@ -62,7 +101,7 @@ def erase_preview(self): renderer.forget(self.preview) self.preview = None - def erase(self): + def erase(self, keep=()): self.erase_preview() for group in list(self.live_preview): if group.isValid and not group.deleteMe(): @@ -76,47 +115,124 @@ def erase(self): else: renderer.forget(group) except Exception: failed.append(group) - self.groups = failed - if failed: raise RuntimeError('Could not remove every dimensions graphics group') + # Fusion Undo can revive a deleted group using a different API wrapper. + # Reconcile by our own persistent group IDs, never by clearing another + # add-in's graphics. New command groups awaiting adoption must survive. + for group in renderer.erase_owned(self.design, keep=keep): + if group not in failed: + failed.append(group) + self.groups = [group for group in failed if group.isValid] + if self.groups: raise RuntimeError('Could not remove every dimensions graphics group') def refresh(self): + if not graphics_workspace(): + return [] self.erase() errors = [] if self.visible: for ident, kind, refs in self.items: + if ident in self.hidden_ids: + continue try: entities = [resolve(self.design, ref) for ref in refs] self.groups.append(renderer.render(self.design, kind, entities, APP.activeViewport.camera, ident, offset=self.offsets.get(ident, 0.0))) except Exception as ex: errors.append(str(ex)) + try: + renderer.arrange_labels(self.groups, APP.activeViewport.camera, APP.activeViewport) + except Exception as ex: + errors.append('Caption layout: ' + str(ex)) APP.activeViewport.refresh() + self.removed_for_save = False + self.fingerprint = geometry_fingerprint(self.design, self.items, resolve, measure) + self.restore_requested = False return errors def remove_item(self, ident): if not any(item[0] == ident for item in self.items): raise ValueError('Measurement not found') self.erase() + save_state(self.design, [item for item in self.items if item[0] != ident], + {key: value for key, value in self.offsets.items() if key != ident}, + self.hidden_ids - {ident}, self.visible) self.items = [item for item in self.items if item[0] != ident] self.offsets.pop(ident, None) + self.hidden_ids.discard(ident) return self.refresh() def current_state(create=True): - doc = APP.activeDocument - design = adsk.fusion.Design.cast(APP.activeProduct) - if not design and doc: - design = adsk.fusion.Design.cast(doc.products.itemByProductType('DesignProductType')) - if not doc or not design: raise RuntimeError('Open a Fusion design first') - for state in STATES: - if state.doc == doc: return state - if not create: return None - state = State(doc, design); STATES.append(state); return state + state = state_for_document(APP.activeDocument, create) + if state is None and create: + raise RuntimeError('Open a Fusion design first') + return state def state_for(doc): return next((s for s in STATES if s.doc == doc), None) +def state_for_document(doc, create=True): + """Load definitions from this document, including when it is not active. + + Loading is read-only; drawing graphics is deferred to the custom event. + """ + if not doc or not getattr(doc, 'isValid', True): + return None + existing = state_for(doc) + if existing is not None or not create: + return existing + design = adsk.fusion.Design.cast(doc.products.itemByProductType('DesignProductType')) + if design is None: + return None + state = State(doc, design) + state.load() + state.restore_requested = bool(state.items) + STATES[:] = [entry for entry in STATES if getattr(entry.doc, 'isValid', True)] + STATES.append(state) + return state + + +def request_document_restore(doc): + """Queue at most one deferred restore; never create graphics in open events.""" + global UPDATE_PENDING + state = state_for_document(doc) + if (state is not None and getattr(state, 'restore_requested', False) + and APP.activeDocument == doc and not UPDATE_PENDING): + UPDATE_PENDING = APP.fireCustomEvent(UPDATE_EVENT_ID) + return state + + +def restore_open_documents(): + """Read definitions at startup; one corrupt document cannot block the others.""" + for doc in APP.documents: + try: + request_document_restore(doc) + except Exception: + log_error() + + +class DocumentOpened(adsk.core.DocumentEventHandler): + def notify(self, args): + try: + request_document_restore(args.document) + except Exception: + log_error() + + +class DocumentActivated(adsk.core.DocumentEventHandler): + def notify(self, args): + # Activation also occurs while Drawing saves its source. Only restore a + # request created by opening/startup, never manufacture a fresh one here. + state = state_for(args.document) + if state is None or not getattr(state, 'restore_requested', False): + return + try: + request_document_restore(args.document) + except Exception: + log_error() + + def format_value(design, kind, value): units = design.unitsManager unit = 'deg' if kind == 'angle' else units.defaultLengthUnits + '^2' if kind == 'area' else units.defaultLengthUnits @@ -129,6 +245,9 @@ def __init__(self): self.batch.next_id = current_state().next_id self.busy = False self.state = current_state() + if getattr(self.state, 'removed_for_save', False) or getattr(self.state, 'restore_requested', False): + self.state.refresh() + self.visible = getattr(self.state, 'visible', True) self.preview_groups = self.state.live_preview self.row_inputs = {} self.layout_cache = {} @@ -159,6 +278,8 @@ def add_row(self, inputs, draft=None, activate=True): table = self.table index = table.rowCount label = inputs.addTextBoxCommandInput('id_' + ident, '', ident, 1, True) + visibility = inputs.addBoolValueInput('visible_' + ident, '', True, icon('visibility'), draft.visible) + visibility_button(visibility, draft.visible, ident) geometry = inputs.addBoolValueInput('geometry_' + ident, '', False, icon('geometry'), False) geometry.tooltip = 'Edit geometry for ' + ident dropdown = inputs.addDropDownCommandInput('kind_' + ident, '', adsk.core.DropDownStyles.TextListDropDownStyle) @@ -168,11 +289,11 @@ def add_row(self, inputs, draft=None, activate=True): offset.tooltip = 'Offset from automatic placement for ' + ident clear = inputs.addBoolValueInput('clear_' + ident, '', False, icon('clear'), False) clear.tooltip = 'Clear geometry in this measurement' - for column, item in enumerate((label, geometry, dropdown, value, offset, clear)): + for column, item in enumerate((label, visibility, geometry, dropdown, value, offset, clear)): if not table.addCommandInput(item, index, column): raise RuntimeError('Cannot add measurement row') self.row_inputs[ident] = (draft, dropdown, value) - if draft.first is not None: + if draft.first is not None or getattr(draft, 'unresolved_refs', None): self.refresh_row(ident) if activate: self.start_selection(ident, 1) @@ -206,8 +327,10 @@ def accept_selection(self): for entity in entities: reference_for(entity) draft = self.row_inputs[ident][0] - if tuple(entities) == tuple(draft.entities): + if tuple(entities) == tuple(draft.entities) and not getattr(draft, 'unresolved_refs', None): return + draft.unresolved_refs = None + draft.reference_error = None draft.set_second(None) draft.set_first(entities[0] if entities else None) if len(entities) == 2: @@ -221,6 +344,15 @@ def accept_selection(self): def refresh_row(self, ident): draft, dropdown, value = self.row_inputs[ident] dropdown.listItems.clear() + if getattr(draft, 'unresolved_refs', None): + if draft.kind is not None: + dropdown.listItems.add(NAMES.get(draft.kind, draft.kind), True, '') + value.text = 'Reference unavailable — edit or clear geometry' + value.tooltip = str(getattr(draft, 'reference_error', 'Reference unavailable')) + return + # Explicit Clear resets kind through RowDraft.set_first(None). + draft.unresolved_refs = None + draft.reference_error = None if draft.options: selected = None for kind in draft.options: @@ -267,48 +399,68 @@ def clear_all(self): def load_existing(self): for ident, kind, refs in self.state.items: - entities = [resolve(self.state.design, ref) for ref in refs] draft = RowDraft(ident) - draft.set_first(entities[0]) - if len(entities) == 2: - draft.set_second(entities[1]) - draft.set_kind('distance') - draft.set_kind(kind) + try: + entities = [resolve(self.state.design, ref) for ref in refs] + draft.set_first(entities[0]) + if len(entities) == 2: + draft.set_second(entities[1]) + draft.set_kind('distance') + draft.set_kind(kind) + measure(kind, draft.entities) + except Exception as ex: + # Retain the definition without displaying a stale measured value. + # Another row's broken token must not prevent editing this document. + draft = RowDraft(ident) + draft.kind = kind + draft.unresolved_refs = tuple(refs) + draft.reference_error = str(ex) draft.offset = self.state.offsets.get(ident, 0.0) + draft.visible = ident not in self.state.hidden_ids self.add_row(self.inputs, draft, activate=False) def sync_batch(self): drafts = [item[0] for item in self.row_inputs.values()] - self.batch.rows = [draft for draft in drafts if draft.complete] - incomplete = [draft.id for draft in drafts if (draft.first is not None or draft.second is not None) and not draft.complete] - return incomplete, duplicate_rows(self.batch.rows) + self.batch.rows = [draft for draft in drafts if draft.complete or getattr(draft, 'unresolved_refs', None)] + complete = [draft for draft in self.batch.rows if not getattr(draft, 'unresolved_refs', None)] + incomplete = [draft.id for draft in drafts if not getattr(draft, 'unresolved_refs', None) + and (draft.first is not None or draft.second is not None) and not draft.complete] + return incomplete, duplicate_rows(complete) class Created(adsk.core.CommandCreatedEventHandler): def __init__(self, operation): super().__init__(); self.operation = operation def notify(self, args): + scope = EventScope() + COMMAND_SCOPES.append(scope) + destroyed = DestroyPreview(None, scope) try: cmd = args.command + scope.bind(cmd.destroy, destroyed) if self.operation == 'add': - cmd.setDialogInitialSize(570, 400) - cmd.setDialogMinimumSize(500, 300) + cmd.setDialogInitialSize(620, 400) + cmd.setDialogMinimumSize(550, 300) inputs = cmd.commandInputs context = BatchCommand() + destroyed.context = context + context.command = cmd context.inputs = inputs context.active_selection = None context.active_row = None - table = inputs.addTableCommandInput('measurements', 'Measurements', 6, '2:1:4:3:3:1') + table = inputs.addTableCommandInput('measurements', 'Measurements', 7, '2:1:1:4:3:3:1') table.minimumVisibleRows = 3 table.maximumVisibleRows = 8 context.table = table add = inputs.addBoolValueInput('add_row', '', False, icon('add'), False) remove = inputs.addBoolValueInput('remove_row', '', False, icon('remove'), False) clear_all = inputs.addBoolValueInput('clear_all', '', False, icon('delete_all'), False) + visibility = inputs.addBoolValueInput('visible_all', '', True, icon('visibility'), context.visible) + visibility_button(visibility, context.visible, 'all measurements') add.tooltip = 'Add measurement' remove.tooltip = 'Remove selected measurement' clear_all.tooltip = 'Remove all measurements' - if not table.addToolbarCommandInput(add) or not table.addToolbarCommandInput(remove) or not table.addToolbarCommandInput(clear_all): + if not all(table.addToolbarCommandInput(item) for item in (add, remove, clear_all, visibility)): raise RuntimeError('Cannot create measurement toolbar') context.editor_heading = inputs.addTextBoxCommandInput('editor_heading', '', 'Select a measurement.', 1, True) picker = inputs.addSelectionInput('picker', 'Objects', 'Select one or two objects') @@ -327,11 +479,11 @@ def notify(self, args): for group in context.state.groups: if group.isValid: group.isVisible = False - bind(cmd.inputChanged, Changed(context)) - bind(cmd.validateInputs, Validate(context)) - bind(cmd.executePreview, Preview(context)) - bind(cmd.destroy, DestroyPreview(context)) - bind(cmd.execute, Execute(self.operation, context)) + scope.bind(cmd.inputChanged, Changed(context)) + scope.bind(cmd.validateInputs, Validate(context)) + scope.bind(cmd.executePreview, Preview(context)) + scope.bind(cmd.execute, Execute(self.operation, context)) + context.state.editor_open = True elif self.operation == 'remove_one': state = current_state() inputs = cmd.commandInputs @@ -339,10 +491,11 @@ def notify(self, args): for i, (ident, kind, refs) in enumerate(state.items): dropdown.listItems.add(ident + ' — ' + NAMES.get(kind, kind), i == 0, '') inputs.addTextBoxCommandInput('remove_hint', '', 'Choose a measurement to remove.', 2, True) - bind(cmd.execute, Execute(self.operation)) + scope.bind(cmd.execute, Execute(self.operation)) else: - bind(cmd.execute, Execute(self.operation)) + scope.bind(cmd.execute, Execute(self.operation)) except Exception: + destroyed.finish() log_error(); UI.messageBox('Mesora: failed to open command. See Text Commands log.') @@ -361,6 +514,13 @@ def notify(self, args): c.remove_selected() elif ident == 'clear_all': c.clear_all() + elif ident == 'visible_all': + c.visible = args.input.value + visibility_button(args.input, c.visible, 'all measurements') + elif ident.startswith('visible_'): + draft = c.row_inputs[ident[8:]][0] + draft.visible = args.input.value + visibility_button(args.input, draft.visible, draft.id) elif ident.startswith('geometry_'): c.open_editor(ident[9:]) elif ident == 'picker': @@ -391,6 +551,8 @@ def notify(self, args): c.update_status(inputs, 'Complete or clear: ' + ', '.join(incomplete)) else: c.update_status(inputs) + if ident.startswith('visible_'): + c.command.doExecutePreview() except Exception as ex: log_error() c.update_status(c.inputs, str(ex)) @@ -406,6 +568,8 @@ def notify(self, args): incomplete, duplicates = self.context.sync_batch() args.areInputsValid = not incomplete and not duplicates and (bool(batch.rows) or bool(self.context.state.items)) for row in batch.rows: + if getattr(row, 'unresolved_refs', None): + continue measure(row.kind, row.entities) for entity in row.entities: reference_for(entity) except Exception: @@ -419,29 +583,56 @@ def notify(self, args): try: c.clear_preview() state = current_state() + if not graphics_workspace() or not c.visible: + args.isValidResult = False + return errors = [] _, duplicates = c.sync_batch() obstacles = renderer.obstacle_signature(state.design.rootComponent) if c.batch.rows else None for row in c.batch.rows: - if row.id in duplicates: continue + if getattr(row, 'unresolved_refs', None) or row.id in duplicates or not row.visible: continue try: c.preview_groups.append(renderer.render(state.design, row.kind, row.entities, APP.activeViewport.camera, row.id, offset=getattr(row, 'offset', 0.0), layout_cache=c.layout_cache, obstacles=obstacles)) except Exception as ex: errors.append(row.id + ': ' + str(ex)) + try: + renderer.arrange_labels(c.preview_groups, APP.activeViewport.camera, APP.activeViewport) + except Exception as ex: + errors.append('Caption layout: ' + str(ex)) if errors: c.update_status(args.command.commandInputs, '; '.join(errors)) args.isValidResult = False except Exception: log_error() class DestroyPreview(adsk.core.CommandEventHandler): - def __init__(self, context): super().__init__(); self.context = context + def __init__(self, context, scope=None): + super().__init__(); self.context = context; self.scope = scope def notify(self, args): + self.finish() + + def finish(self): + # Locals retain this callback and context until destruction cleanup ends. + context, scope = self.context, self.scope try: - self.context.clear_preview() - for group in self.context.state.groups: - if group.isValid: - group.isVisible = self.context.state.visible + if context is not None: + try: + context.clear_preview() + finally: + for group in context.state.groups: + if group.isValid: + group.isVisible = context.state.visible and graphics_workspace() + if (graphics_workspace() and context.state.doc == APP.activeDocument + and not context.state.removed_for_save): + renderer.arrange_labels(context.state.groups, APP.activeViewport.camera, APP.activeViewport) except Exception: log_error() + finally: + if context is not None: + context.state.editor_open = False + if scope is not None: + scope.close(destroyed=True) + if scope in COMMAND_SCOPES: + COMMAND_SCOPES.remove(scope) + self.context = self.scope = None class Execute(adsk.core.CommandEventHandler): @@ -456,27 +647,50 @@ def notify(self, args): try: obstacles = renderer.obstacle_signature(state.design.rootComponent) if getattr(self.context, 'layout_cache', None) is not None and self.context.batch.rows else None for row in self.context.batch.rows: - refs = tuple(reference_for(e) for e in row.entities) - entities = [resolve(state.design, ref) for ref in refs] - group = renderer.render(state.design, row.kind, entities, APP.activeViewport.camera, row.id, offset=getattr(row, 'offset', 0.0), layout_cache=getattr(self.context, 'layout_cache', None), obstacles=obstacles) + unresolved = getattr(row, 'unresolved_refs', None) + refs = unresolved or tuple(reference_for(e) for e in row.entities) + entities = [] if unresolved else [resolve(state.design, ref) for ref in refs] + group = None + if not unresolved and getattr(self.context, 'visible', True) and getattr(row, 'visible', True): + group = renderer.render(state.design, row.kind, entities, APP.activeViewport.camera, row.id, offset=getattr(row, 'offset', 0.0), layout_cache=getattr(self.context, 'layout_cache', None), obstacles=obstacles) staged.append((row.id, row.kind, refs, group)) + # Arrange the whole new set before touching committed graphics + # or definitions, so placement failure can roll back the draft. + renderer.arrange_labels([entry[3] for entry in staged if entry[3] is not None], + APP.activeViewport.camera, APP.activeViewport) + state.erase(keep=[entry[3] for entry in staged if entry[3] is not None]) + save_state(state.design, [(i, k, r) for i, k, r, _ in staged], + {r.id: getattr(r, 'offset', 0.0) for r in self.context.batch.rows}, + {r.id for r in self.context.batch.rows if not getattr(r, 'visible', True)}, + getattr(self.context, 'visible', True)) except Exception: - for group in [entry[3] for entry in staged]: - group.deleteMe(); renderer.forget(group) + for group in [entry[3] for entry in staged if entry[3] is not None]: + try: + if group.isValid and not group.deleteMe(): + state.live_preview.append(group) + else: + renderer.forget(group) + except Exception: + state.live_preview.append(group) raise - state.erase() state.items = [(ident, kind, refs) for ident, kind, refs, _ in staged] - state.groups = [group for _, _, _, group in staged] + state.groups = [group for _, _, _, group in staged if group is not None] + state.hidden_ids = {row.id for row in self.context.batch.rows if not getattr(row, 'visible', True)} if hasattr(state, 'offsets'): state.offsets = {row.id: getattr(row, 'offset', 0.0) for row in self.context.batch.rows} state.next_id = self.context.batch.next_id - state.visible = True + state.visible = getattr(self.context, 'visible', True) + state.removed_for_save = False + state.restore_requested = False + state.fingerprint = geometry_fingerprint(state.design, state.items, resolve, measure) elif self.operation == 'remove_one': item = args.command.commandInputs.itemById('remove_id').selectedItem if item is None: raise ValueError('No measurement selected') errors = state.remove_item(item.name.split(' — ', 1)[0]) if errors: UI.messageBox('Some dimensions cannot be resolved:\n' + '\n'.join(errors[:5])) elif self.operation == 'toggle': + state.erase() + save_state(state.design, state.items, state.offsets, state.hidden_ids, not state.visible) state.visible = not state.visible errors = state.refresh() if errors: UI.messageBox('Some dimensions cannot be resolved:\n' + '\n'.join(errors[:5])) @@ -484,7 +698,9 @@ def notify(self, args): errors = state.refresh() if errors: UI.messageBox('Some dimensions cannot be resolved:\n' + '\n'.join(errors[:5])) else: - state.erase(); state.items.clear(); state.offsets.clear(); APP.activeViewport.refresh() + state.erase() + save_state(state.design, [], {}, set(), state.visible) + state.items.clear(); state.offsets.clear(); state.hidden_ids.clear(); APP.activeViewport.refresh() except Exception as ex: log_error(); UI.messageBox('Mesora: ' + str(ex)) @@ -495,24 +711,26 @@ def notify(self, args): state = state_for(args.document) if not state: return try: - if self.mode == 'saving' and (state.groups or state.preview is not None): + if self.mode == 'saving': state.erase() state.removed_for_save = True + state.restore_requested = False + state.fingerprint = geometry_fingerprint(state.design, state.items, resolve, measure) elif self.mode == 'saved' and state.removed_for_save: - state.removed_for_save = False - if state.doc == APP.activeDocument: - errors = state.refresh() - if errors: APP.log('Dimensions could not be restored: ' + '; '.join(errors)) - elif self.mode == 'activated' and state.removed_for_save: - state.removed_for_save = False - state.refresh() + # Creating CustomGraphics dirties the document. Drawing saves its + # source until clean, so rendering here causes an endless save loop. + # Restore only on an explicit Mesora action. Drawing may also + # activate the source document as part of its save workflow. + pass elif self.mode == 'closing': state.erase() # Closing may be canceled; retain definitions until document invalidation. except Exception: - if self.mode in ('saving', 'closing'): args.isSaveCanceled = True + if self.mode == 'saving': + args.isOperationCancelled = True + args.cancelReason = 'Mesora could not remove informational graphics safely.' log_error() - UI.messageBox('Mesora could not remove graphics. The operation was canceled; do not save until the add-in can remove them.') + UI.messageBox('Mesora could not remove graphics. Do not save until the add-in can remove them.') class CameraChanged(adsk.core.CameraEventHandler): @@ -521,7 +739,7 @@ def __init__(self): self.busy = False def notify(self, args): - if self.busy: + if self.busy or not graphics_workspace(): return try: state = state_for(APP.activeDocument) @@ -529,7 +747,13 @@ def notify(self, args): return self.busy = True camera = args.viewport.camera - for group in (list(state.groups) if state.visible else []) + list(state.live_preview) + ([state.preview] if state.preview is not None else []): + groups = (list(state.groups) if state.visible else []) + list(state.live_preview) + ([state.preview] if state.preview is not None else []) + groups = [group for group in groups + if getattr(group, 'isValid', True) and getattr(group, 'isVisible', True)] + # Orbit changes readability only. Keep caption anchors and leader + # geometry fixed even if this view projects them onto each other. + # Explicit preview/apply/refresh actions may arrange the whole set. + for group in groups: renderer.orient_text(group, camera) except Exception: log_error() @@ -537,6 +761,61 @@ def notify(self, args): self.busy = False +class WorkspaceChanged(adsk.core.WorkspaceEventHandler): + def __init__(self, changing): + super().__init__() + self.changing = changing + + def notify(self, args): + global WORKSPACE_CHANGING + WORKSPACE_CHANGING = self.changing + + +class ModelCommandEnded(adsk.core.ApplicationCommandEventHandler): + """Queue work after Fusion has committed the model command's transaction.""" + def notify(self, args): + global UPDATE_PENDING + if UPDATE_PENDING or args.commandId.startswith('Mesora'): + return + state = state_for(APP.activeDocument) + if state is None or state.editor_open: + return + UPDATE_PENDING = APP.fireCustomEvent(UPDATE_EVENT_ID) + + +class UpdateDimensions(adsk.core.CustomEventHandler): + def notify(self, args): + global UPDATE_PENDING + UPDATE_PENDING = False + try: + if not graphics_workspace() or UI.activeCommand != 'SelectCommand': + return + state = state_for(APP.activeDocument) + if state is None or state.editor_open: + return + stored = load_state(state.design) + definitions_changed = (stored.items != state.items or stored.offsets != state.offsets or + stored.hidden_ids != state.hidden_ids or stored.visible != state.visible) + if definitions_changed: + # Undo/Redo restores document attributes in Fusion's transaction. + # Runtime state must follow them, including undoing the last row. + state.load() + owned = renderer.owned_groups(state.design) + valid_tracked = [group for group in state.groups if group.isValid] + graphics_changed = (len(owned) != len(state.groups) or + len(valid_tracked) != len(state.groups) or + {group.id for group in owned} != {group.id for group in valid_tracked}) + if not state.items and not definitions_changed and not state.restore_requested and not graphics_changed: + return + fingerprint = geometry_fingerprint(state.design, state.items, resolve, measure) + # Saving itself, camera motion, and workspace activation must never + # recreate graphics and restart the Drawing source-save loop. + if state.restore_requested or definitions_changed or graphics_changed or (state.fingerprint is not None and fingerprint != state.fingerprint): + state.refresh() + except Exception: + log_error() + + def install_inspect_controls(definitions): for workspace_id, panel_id in INSPECT_PANELS: workspace = UI.workspaces.itemById(workspace_id) @@ -559,11 +838,11 @@ def run(context): panel = workspace.toolbarPanels.itemById(PANEL_ID) if workspace else None if not panel: raise RuntimeError('Solid toolbar panel unavailable') for suffix, title, description in [ - ('Add','Mesora — Add Dimension','Create a session-only informational 3D dimension'), + ('Add','Mesora — Add Dimension','Create and manage informational 3D measurements'), ('Toggle','Show/Hide Dimensions','Toggle dimensions in this document'), ('Refresh','Refresh Dimensions','Recalculate dimensions in this document'), - ('Remove','Remove Dimension','Remove one session dimension by ID'), - ('Clear','Clear Dimensions','Remove session dimensions in this document')]: + ('Remove','Remove Dimension','Remove one measurement by ID'), + ('Clear','Clear Dimensions','Remove measurements in this document')]: ident = 'Mesora' + suffix definition = UI.commandDefinitions.itemById(ident) if definition: definition.deleteMe() @@ -576,22 +855,43 @@ def run(context): install_inspect_controls(DEFINITIONS) bind(APP.documentSaving, DocumentEvent('saving')) bind(APP.documentSaved, DocumentEvent('saved')) - bind(APP.documentActivated, DocumentEvent('activated')) bind(APP.documentClosing, DocumentEvent('closing')) + bind(APP.documentOpened, DocumentOpened()) + bind(APP.documentActivated, DocumentActivated()) bind(APP.cameraChanged, CameraChanged()) + bind(UI.workspacePreDeactivate, WorkspaceChanged(True)) + bind(UI.workspacePreActivate, WorkspaceChanged(True)) + bind(UI.workspaceActivated, WorkspaceChanged(False)) + update_event = APP.registerCustomEvent(UPDATE_EVENT_ID) + if not update_event: + raise RuntimeError('Could not register Mesora geometry update event') + bind(update_event, UpdateDimensions()) + bind(UI.commandTerminated, ModelCommandEnded()) + restore_open_documents() except Exception: log_error(); stop(context); UI.messageBox('Mesora failed to start. See Text Commands log.') def stop(context): + global WORKSPACE_CHANGING, UPDATE_PENDING + WORKSPACE_CHANGING = False + UPDATE_PENDING = False + for scope in list(COMMAND_SCOPES): + if scope.close(): + COMMAND_SCOPES.remove(scope) + failed_states = [] for state in STATES: try: state.erase() - except Exception: log_error() - STATES.clear() + except Exception: + failed_states.append(state) + log_error() + STATES[:] = failed_states for event, handler in reversed(HANDLERS): try: event.remove(handler) except Exception: pass HANDLERS.clear() + try: APP.unregisterCustomEvent(UPDATE_EVENT_ID) + except Exception: log_error() for control in reversed(CONTROLS): try: control.deleteMe() except Exception: pass diff --git a/Mesora/dimensions/batch.py b/Mesora/dimensions/batch.py index 0015d73..dc085e6 100644 --- a/Mesora/dimensions/batch.py +++ b/Mesora/dimensions/batch.py @@ -50,6 +50,7 @@ def __init__(self, ident): self.options = [] self.kind = None self.offset = 0.0 + self.visible = True @property def needs_second(self): diff --git a/Mesora/dimensions/event_scope.py b/Mesora/dimensions/event_scope.py new file mode 100644 index 0000000..fab420f --- /dev/null +++ b/Mesora/dimensions/event_scope.py @@ -0,0 +1,29 @@ +"""Own event-handler references for one active command, without importing adsk.""" + + +class EventScope: + def __init__(self): + self.bindings = [] + + def bind(self, event, handler): + if not event.add(handler): + raise RuntimeError('Failed to attach Fusion command event') + self.bindings.append((event, handler)) + + def close(self, destroyed=False): + """Detach active events, or release references after command destruction. + + Destroyed command event wrappers may already be invalid. Keeping them + then would retain deleted inputs and the document through their handlers. + During add-in stop, failures on still-active commands remain retryable. + """ + failed = [] + for event, handler in reversed(self.bindings): + try: + if not event.remove(handler) and not destroyed: + failed.append((event, handler)) + except Exception: + if not destroyed: + failed.append((event, handler)) + self.bindings[:] = reversed(failed) + return not self.bindings diff --git a/Mesora/dimensions/label_layout.py b/Mesora/dimensions/label_layout.py new file mode 100644 index 0000000..cfa4dbe --- /dev/null +++ b/Mesora/dimensions/label_layout.py @@ -0,0 +1,56 @@ +"""Screen-space caption packing, independent of Fusion and model geometry.""" +import math + + +def projection_scale(width, height, target): + """Normalize projection pixels to viewport points on high-DPI displays. + + The camera look-at target projects to the viewport centre. Fusion can report + that projection in backing pixels while width/height use logical points. + Snap only coherent positive ratios; ordinary/fake viewports default to 1. + """ + if not width or not height or target is None: + return 1.0 + sx, sy = 2*target[0]/width, 2*target[1]/height + if not all(math.isfinite(v) and .5 <= v <= 4 for v in (sx, sy)): + return 1.0 + scale = (sx+sy)/2 + if abs(sx-sy) > .05: + return 1.0 + snapped = round(scale*4)/4 + return snapped if abs(snapped-scale) <= .03 else scale + + +def projected_caption_size(width, height, xdirection, ydirection): + """Conservative AABB of an oriented text rectangle in screen pixels.""" + def direction(value, fallback): + length = math.hypot(*value) + return tuple(v/length for v in value) if length > 1e-8 else fallback + # At grazing angles a projected axis can collapse. Reserve a conservative + # full-size perpendicular extent instead of accepting a zero-height box. + known_y = direction(ydirection, (0, 1)) + x = direction(xdirection, (-known_y[1], known_y[0])) + y = direction(ydirection, (-x[1], x[0])) + return abs(x[0])*width+abs(y[0])*height, abs(x[1])*width+abs(y[1])*height + + +def choose_caption(width, height, occupied, candidates, padding=5, bounds=None): + """Select the first actual projected candidate with clear padded bounds. + + Candidates yield ((screen_x, screen_y), payload). The adapter supplies + projected positions reachable in the caption's model plane. + """ + if not all(math.isfinite(v) and v > 0 for v in (width, height)): + raise ValueError('Invalid caption size') + for (x, y), payload in candidates: + if not math.isfinite(x) or not math.isfinite(y): + continue + rect = (x-width/2-padding, y-height/2-padding, + x+width/2+padding, y+height/2+padding) + if bounds is not None and not (bounds[0] <= rect[0] and bounds[1] <= rect[1] + and rect[2] <= bounds[2] and rect[3] <= bounds[3]): + continue + if all(rect[2] <= other[0] or other[2] <= rect[0] or + rect[3] <= other[1] or other[3] <= rect[1] for other in occupied): + return payload, rect + raise ValueError('Cannot find a clear caption position in this view') diff --git a/Mesora/dimensions/model.py b/Mesora/dimensions/model.py index f730ffb..9fe37eb 100644 --- a/Mesora/dimensions/model.py +++ b/Mesora/dimensions/model.py @@ -1,24 +1,45 @@ -"""Versioned, deliberately strict dimension definitions. - -No measured value is persisted: geometry is the source of truth. -""" +"""Versioned dimension definitions. Geometry, never cached values, is persisted.""" from dataclasses import dataclass, field import json +import math +import re import uuid -SCHEMA_VERSION = 1 -KINDS = {"distance": 2, "edge_length": 1, "radius": 1, "diameter": 1} +SCHEMA_VERSION = 2 +KINDS = {"distance": 2, "angle": 2, "edge_length": 1, "radius": 1, + "diameter": 1, "area": 1, "perimeter": 1} +LEGACY_KINDS = {"distance", "edge_length", "radius", "diameter"} class SchemaError(ValueError): pass +def _valid_id(ident, legacy=False): + if not isinstance(ident, str): + return False + if not legacy and re.fullmatch(r"m[1-9][0-9]*", ident): + return True + try: + uuid.UUID(ident) + return True + except (ValueError, TypeError, AttributeError): + return False + + +def _json_object(value): + if not isinstance(value, dict): + raise SchemaError("Placement and display must be objects") + try: + json.dumps(value, allow_nan=False) + except (TypeError, ValueError) as exc: + raise SchemaError("Invalid JSON data") from exc + + @dataclass(frozen=True) class EntityReference: token: str - # An occurrence is stored separately: never identify geometry by comparing tokens. occurrence_token: str | None = None def __post_init__(self): @@ -42,16 +63,19 @@ class Dimension: display: dict = field(default_factory=dict) def __post_init__(self): - try: - uuid.UUID(self.id) - except (ValueError, TypeError, AttributeError) as exc: - raise SchemaError("Invalid dimension ID") from exc + if not _valid_id(self.id): + raise SchemaError("Invalid dimension ID") if self.kind not in KINDS or len(self.references) != KINDS[self.kind]: raise SchemaError("Invalid dimension kind or reference count") if not all(isinstance(ref, EntityReference) for ref in self.references): raise SchemaError("Invalid entity reference") - if not isinstance(self.placement, dict) or not isinstance(self.display, dict): - raise SchemaError("Placement and display must be objects") + _json_object(self.placement) + _json_object(self.display) + offset = self.placement.get('offset', 0.0) + if isinstance(offset, bool) or not isinstance(offset, (int, float)) or not math.isfinite(offset): + raise SchemaError("Offset must be a finite number") + if not isinstance(self.display.get('visible', True), bool): + raise SchemaError("Row visibility must be a boolean") @classmethod def create(cls, kind, references, placement=None, display=None): @@ -67,6 +91,8 @@ def serialize(dimensions, visible=True): dimensions = list(dimensions) if not isinstance(visible, bool): raise SchemaError("visible must be a boolean") + if not all(isinstance(d, Dimension) for d in dimensions): + raise SchemaError("Invalid dimension") if len({d.id for d in dimensions}) != len(dimensions): raise SchemaError("Duplicate dimension IDs") try: @@ -77,18 +103,42 @@ def serialize(dimensions, visible=True): raise SchemaError("Invalid JSON data") from exc +def _unique_object(pairs): + result = {} + for key, value in pairs: + if key in result: + raise SchemaError("Duplicate JSON object key") + result[key] = value + return result + + def deserialize(payload): try: - data = json.loads(payload, parse_constant=lambda x: (_ for _ in ()).throw(ValueError(x))) - if not isinstance(data, dict) or data.get("schema_version") != SCHEMA_VERSION: + data = json.loads(payload, object_pairs_hook=_unique_object, + parse_constant=lambda x: (_ for _ in ()).throw(ValueError(x))) + if not isinstance(data, dict): + raise SchemaError("Invalid document payload") + version = data.get("schema_version") + if type(version) is not int or version not in (1, SCHEMA_VERSION): raise SchemaError("Unsupported schema version") + if set(data) != {'schema_version', 'visible', 'dimensions'}: + raise SchemaError("Unrecognized document fields") if not isinstance(data.get("visible"), bool) or not isinstance(data.get("dimensions"), list): raise SchemaError("Invalid document payload") dimensions = [] for item in data["dimensions"]: - refs = tuple(EntityReference(ref["token"], ref.get("occurrence_token")) - for ref in item["references"]) - dimensions.append(Dimension(item["id"], item["type"], refs, + if set(item) != {'id', 'type', 'references', 'placement', 'display'}: + raise SchemaError("Unrecognized dimension fields") + if not isinstance(item['references'], list): + raise SchemaError("References must be an array") + if version == 1 and (not _valid_id(item['id'], legacy=True) or item['type'] not in LEGACY_KINDS): + raise SchemaError("Invalid legacy dimension") + refs = [] + for ref in item['references']: + if not isinstance(ref, dict) or not {'token'} <= set(ref) <= {'token', 'occurrence_token'}: + raise SchemaError("Invalid reference fields") + refs.append(EntityReference(ref['token'], ref.get('occurrence_token'))) + dimensions.append(Dimension(item["id"], item["type"], tuple(refs), item["placement"], item["display"])) if len({d.id for d in dimensions}) != len(dimensions): raise SchemaError("Duplicate dimension IDs") diff --git a/Mesora/dimensions/persistence.py b/Mesora/dimensions/persistence.py index 6326ec8..4255294 100644 --- a/Mesora/dimensions/persistence.py +++ b/Mesora/dimensions/persistence.py @@ -16,7 +16,10 @@ def load(design): if not attribute: return [], True # Refuse to interpret or overwrite corrupt and future schemas. - return deserialize(attribute.value) + payload = attribute.value + if not isinstance(payload, str) or len(payload.encode('utf-8')) > MAX_BYTES: + raise PersistenceError('Dimension definitions exceed Fusion attribute limit') + return deserialize(payload) def save(design, dimensions, visible): @@ -25,6 +28,9 @@ def save(design, dimensions, visible): payload = serialize(dimensions, visible) if len(payload.encode('utf-8')) > MAX_BYTES: raise PersistenceError('Dimension definitions exceed Fusion attribute limit') + current = design.attributes.itemByName(GROUP, NAME) + if current and current.value == payload: + return attribute = design.attributes.add(GROUP, NAME, payload) if not attribute or attribute.value != payload: raise PersistenceError('Fusion did not store the dimension definitions') diff --git a/Mesora/dimensions/runtime_persistence.py b/Mesora/dimensions/runtime_persistence.py new file mode 100644 index 0000000..38ecc65 --- /dev/null +++ b/Mesora/dimensions/runtime_persistence.py @@ -0,0 +1,57 @@ +"""Translate committed runtime definitions to document storage, without adsk. + +Loading restores references only. Callers resolve and remeasure them against the +current model, retaining unresolved definitions for later repair/removal. +""" +from dataclasses import dataclass +import re + +from .model import Dimension, SchemaError, serialize +from .persistence import GROUP, NAME, load, save + + +@dataclass +class RuntimeDefinitions: + items: list + offsets: dict + hidden_ids: set + visible: bool + next_id: int + + +def load_state(design): + dimensions, visible = load(design) + numeric_ids = [int(d.id[1:]) for d in dimensions if re.fullmatch(r'm[1-9][0-9]*', d.id)] + return RuntimeDefinitions( + [(d.id, d.kind, d.references) for d in dimensions], + {d.id: d.placement.get('offset', 0.0) for d in dimensions}, + {d.id for d in dimensions if not d.display.get('visible', True)}, + visible, max(numeric_ids, default=0) + 1) + + +def save_state(design, items, offsets, hidden_ids, visible): + """Persist an explicit command commit; return whether an attribute was written. + + Validate existing data first, and do not replace extension fields that this + runtime does not understand. This is safer than silently losing user data. + """ + previous, _ = load(design) + for dimension in previous: + if set(dimension.placement) - {'offset'} or set(dimension.display) - {'visible'}: + raise SchemaError('Stored dimension settings are not supported by this Mesora version') + items = list(items) + ids = {item[0] for item in items} + if set(offsets) - ids or set(hidden_ids) - ids: + raise SchemaError('Settings reference an unknown measurement') + dimensions = [Dimension(ident, kind, tuple(refs), + {'offset': offsets.get(ident, 0.0)}, + {'visible': ident not in hidden_ids}) + for ident, kind, refs in items] + payload = serialize(dimensions, visible) + attribute = design.attributes.itemByName(GROUP, NAME) + if attribute and attribute.value == payload: + return False + if attribute is None and not dimensions and visible: + return False + save(design, dimensions, visible) + return True diff --git a/Mesora/dimensions/update_fingerprint.py b/Mesora/dimensions/update_fingerprint.py new file mode 100644 index 0000000..11beb49 --- /dev/null +++ b/Mesora/dimensions/update_fingerprint.py @@ -0,0 +1,101 @@ +"""Read-only invalidation snapshots; no Fusion objects or tokens in equality. + +Call on Fusion's main thread. Snapshots are session-local and never persisted. +""" +import math + + +def _get(obj, name): + try: + return getattr(obj, name, None) + except (RuntimeError, AttributeError): + return None + + +def _number(value): + if isinstance(value, (float, int)): + return value if math.isfinite(value) else ('nonfinite', str(value)) + return None + + +def _point(value): + if value is None: + return None + coordinates = tuple(_number(_get(value, axis)) for axis in ('x', 'y', 'z')) + return coordinates if all(v is not None for v in coordinates) else None + + +def _matrix(value): + if value is None: + return None + try: + return tuple(_number(v) for v in value.asArray()) + except (RuntimeError, AttributeError, TypeError): + return ('unavailable',) + + +def _bounds(value): + return (_point(_get(value, 'minPoint')), _point(_get(value, 'maxPoint'))) + + +def _geometry(value): + if value is None: + return None + return (_get(value, 'objectType'), _point(value), + tuple((name, _point(_get(value, name))) for name in + ('center', 'origin', 'startPoint', 'endPoint', 'normal', + 'direction', 'axis', 'majorAxis', 'minorAxis')), + tuple((name, _number(_get(value, name))) for name in + ('radius', 'majorRadius', 'minorRadius', 'startAngle', 'endAngle'))) + + +def _body(body): + return (_get(body, 'revisionId'), _get(body, 'isVisible'), + _bounds(_get(body, 'boundingBox'))) + + +def _entity(entity): + if entity is None or _get(entity, 'isValid') is False: + return ('missing',) + occurrence = _get(entity, 'assemblyContext') + return (_get(entity, 'objectType'), _bounds(_get(entity, 'boundingBox')), + _geometry(_get(entity, 'worldGeometry')), + _geometry(_get(entity, 'geometry')), + _point(_get(entity, 'pointOnFace')), + _body(_get(entity, 'body')), + _matrix(_get(occurrence, 'transform2'))) + + +def geometry_fingerprint(design, items, resolve_fn, measure_fn): + """Snapshot measurements plus placement dependencies, retaining missing rows. + + Runtime items have the shape ``(id, kind, references)``. Token strings are + deliberately excluded: Fusion can issue different tokens for one entity. + Changes to hidden bodies also invalidate placement and measurements. + """ + root = design.rootComponent + bodies = tuple(_body(body) for body in root.bRepBodies) + occurrences = tuple((_get(occurrence, 'isVisible'), + _matrix(_get(occurrence, 'transform2')), + tuple(_body(body) for body in occurrence.bRepBodies)) + for occurrence in root.allOccurrences) + rows = [] + for ident, kind, references in items: + entities, snapshots = [], [] + missing = False + for reference in references: + try: + entity = resolve_fn(design, reference) + snapshot = _entity(entity) + entities.append(entity) + missing = missing or snapshot == ('missing',) + snapshots.append(snapshot) + except (ValueError, RuntimeError, AttributeError): + missing = True + snapshots.append(('missing',)) + try: + value = ('missing',) if missing else _number(measure_fn(kind, entities)) + except (ValueError, RuntimeError, AttributeError): + value = ('unmeasurable',) + rows.append((ident, kind, tuple(snapshots), value)) + return (design.unitsManager.defaultLengthUnits, bodies, occurrences, tuple(rows)) diff --git a/Mesora/renderer.py b/Mesora/renderer.py index 6130730..b1f6f32 100644 --- a/Mesora/renderer.py +++ b/Mesora/renderer.py @@ -1,12 +1,16 @@ """Session graphics. All groups belong to the manager, never to a command.""" import math +import uuid import adsk.core import adsk.fusion from .dimensions.fusion_geometry import measure, point, minimum_distance, angle_geometry from .dimensions.layout import add, sub, mul, dot, cross, unit, basis, readable_axes, find_clear_placement, clear_intervals, face_axis +from .dimensions.label_layout import choose_caption, projected_caption_size, projection_scale _LABELS = {} _ANGLES = {} +_CAPTIONS = {} +OWNERSHIP_PREFIX = '4FusionLab.Mesora.89072f8c-cdca-48bf-8a2a-440c9ae898e6.graphics.v1:' def xyz(p): return (p.x, p.y, p.z) @@ -16,6 +20,138 @@ def p3(p): return adsk.core.Point3D.create(*p) def forget(group): _LABELS.pop(id(group), None) _ANGLES.pop(id(group), None) + _CAPTIONS.pop(id(group), None) + + +def arrange_labels(groups, camera, viewport): + """Pack one visible batch of captions in screen space without moving dimensions. + + Each caption remains in its own model plane. Extra leader lines connect a + displaced caption to its original anchor. Keep the previous world position + while its text bounds remain clear. When reflow is required, search from + the original attachment so repeated orbit cannot accumulate displacement. + """ + occupied = [] + viewport_width, viewport_height = getattr(viewport, 'width', None), getattr(viewport, 'height', None) + bounds = (0, 0, viewport_width, viewport_height) if viewport_width and viewport_height else None + target = getattr(camera, 'target', None) + projected_target = viewport.modelToViewSpace(target) if target is not None else None + pixel_scale = projection_scale(viewport_width, viewport_height, + (projected_target.x, projected_target.y) if projected_target is not None else None) + def project(value): + point = viewport.modelToViewSpace(p3(value)) + return point.x/pixel_scale, point.y/pixel_scale + for group in groups: + key = id(group) + if not group.isValid or not getattr(group, 'isVisible', True) or key not in _LABELS: + continue + saved = _CAPTIONS.get(key) + base = saved['base'] if saved else _LABELS[key][1] + if saved is None: + saved = {'base': base, 'leader': None} + _CAPTIONS[key] = saved + saved['base'] = base + text, _, xaxis, yaxis, size, previous, face_camera = _LABELS[key] + orient_text(group, camera) + signature = _LABELS[key][5] + text_x, text_y = signature[:3], signature[3:6] + origin = project(base) + tx, ty = project(add(base, text_x)), project(add(base, text_y)) + width, height = projected_caption_size(max(float(text.width)*16/size, 16), 20, + (tx[0]-origin[0], tx[1]-origin[1]), (ty[0]-origin[0], ty[1]-origin[1])) + px, py = project(add(base, xaxis)), project(add(base, yaxis)) + dx, dy = (px[0]-origin[0], px[1]-origin[1]), (py[0]-origin[0], py[1]-origin[1]) + determinant = dx[0]*dy[1]-dx[1]*dy[0] + scale_product = math.hypot(*dx)*math.hypot(*dy) + well_conditioned = scale_product > 1e-12 and abs(determinant)/scale_product >= .08 + + def candidates(): + yield origin, base + # Lazy candidates keep ordinary, non-overlapping orbit inexpensive. + for ring in range(1, 49): + if well_conditioned: + displacements = ((0, -ring*(height+12)), (0, ring*(height+12)), + (-ring*(width+12), 0), (ring*(width+12), 0), + (-ring*(width+12), -ring*(height+12)), + (ring*(width+12), -ring*(height+12)), + (-ring*(width+12), ring*(height+12)), + (ring*(width+12), ring*(height+12))) + for sx, sy in displacements: + a = (sx*dy[1]-sy*dy[0])/determinant + b = (dx[0]*sy-dx[1]*sx)/determinant + candidate = add(base, add(mul(xaxis, a), mul(yaxis, b))) + yield project(candidate), candidate + else: + # An edge-on plane still permits travel on its visible axis. + axis, screen = (xaxis, dx) if math.hypot(*dx) >= math.hypot(*dy) else (yaxis, dy) + length = math.hypot(*screen) + if length < 1e-8: + break + step = ring*(width+height+16)/length + for sign in (-1, 1): + candidate = add(base, mul(axis, sign*step)) + yield project(candidate), candidate + + placed = saved.get('placed') + if placed is not None: + try: + # Preserve world placement while the actual text bounds remain + # clear. Removing only the extra packing padding is hysteresis: + # a small camera motion must not chase the 5px reserve margin. + anchor, rect = choose_caption(width, height, occupied, + [(project(placed), placed)], padding=0, bounds=bounds) + except ValueError: + anchor, rect = choose_caption(width, height, occupied, candidates(), bounds=bounds) + else: + anchor, rect = choose_caption(width, height, occupied, candidates(), bounds=bounds) + saved['placed'] = anchor + occupied.append(rect) + _LABELS[key] = (text, anchor, xaxis, yaxis, size, signature, face_camera) + orient_text(group, camera) + moved = math.dist(base, anchor) > 1e-9 + leader = saved['leader'] + if moved: + coordinates = adsk.fusion.CustomGraphicsCoordinates.create([v for point in (base, anchor) for v in point]) + if leader is None: + leader = group.addLines(coordinates, [], False) + if not leader: + raise RuntimeError('Failed to connect displaced caption') + leader.color = text.color + leader.weight = 1 + leader.isSelectable = False + saved['leader'] = leader + else: + leader.coordinates = coordinates + leader.isVisible = True + elif leader is not None: + leader.isVisible = False + + +def owned_groups(design, keep=()): + """Find tagged graphics, including fresh wrappers restored by Fusion Undo. + + All Mesora graphics are root groups. Do not inspect/delete another add-in's + groups or infer ownership from text, selection names, or empty IDs. + """ + groups = design.rootComponent.customGraphicsGroups + snapshot = [groups.item(index) for index in range(groups.count)] + return [group for group in snapshot + if group.isValid and group.id.startswith(OWNERSHIP_PREFIX) + and not any(group == retained for retained in keep)] + + +def erase_owned(design, keep=()): + """Delete owned groups; return failed groups so the caller retains ownership.""" + failed = [] + for group in owned_groups(design, keep): + try: + if group.deleteMe(): + forget(group) + else: + failed.append(group) + except Exception: + failed.append(group) + return failed def angle_layout(apex, x, y, value, offset, camera, viewport=None): @@ -46,18 +182,14 @@ def project(p): def orient_text(group, camera): - angular = _ANGLES.get(id(group)) - if angular is not None and group.isValid: - lines, apex, x, y, value, offset = angular - segments, anchor = angle_layout(apex, x, y, value, offset, camera, adsk.core.Application.get().activeViewport) - lines.coordinates = adsk.fusion.CustomGraphicsCoordinates.create([v for pair in segments for p in pair for v in p]) - old = _LABELS[id(group)] - _LABELS[id(group)] = (old[0], anchor, *old[2:]) data = _LABELS.get(id(group)) if data is None or not group.isValid: return text, anchor, axis_x, axis_y, size, previous, face_camera = data - eye_direction = sub(xyz(camera.eye), anchor) + # Readability belongs to the model attachment, not an automatic caption shift. + # Orbit/zoom must not resize angular geometry or move its attachment point. + base = _CAPTIONS.get(id(group), {}).get('base', anchor) + eye_direction = sub(xyz(camera.eye), base) if face_camera: z = unit(eye_direction) x = unit(cross(mul(z, -1), xyz(camera.upVector))) @@ -340,7 +472,9 @@ def cached_layout(cache, ident, signature, calculate): def obstacle_signature(root): - return tuple((body, xyz(body.boundingBox.minPoint), xyz(body.boundingBox.maxPoint)) + # Internal cuts can change clearance without changing a body's bounds. + return tuple((body, getattr(body, 'revisionId', None), + xyz(body.boundingBox.minPoint), xyz(body.boundingBox.maxPoint)) for body in visible_solids(root)) @@ -349,6 +483,13 @@ def render(design, kind, entities, camera, ident=None, offset=0, layout_cache=No group = design.rootComponent.customGraphicsGroups.add() if group is None: raise RuntimeError('Failed to create graphics group') try: + # Fusion Undo can recreate groups with wrappers the State never saw. + # A product-specific ID lets refresh/save/stop reclaim only our groups. + group.id = OWNERSHIP_PREFIX + uuid.uuid4().hex + # Informational annotations must never mask selectable model geometry. + # Disable selection at the group level, including its line children. + group.isChildrenSelectable = False + group.isSelectable = False segments = [] face_camera = False if kind == 'angle': diff --git a/Mesora/resources/visibility_off/16x16-dark.svg b/Mesora/resources/visibility_off/16x16-dark.svg new file mode 100644 index 0000000..b2ecb60 --- /dev/null +++ b/Mesora/resources/visibility_off/16x16-dark.svg @@ -0,0 +1 @@ + diff --git a/Mesora/resources/visibility_off/16x16.svg b/Mesora/resources/visibility_off/16x16.svg new file mode 100644 index 0000000..4c905f1 --- /dev/null +++ b/Mesora/resources/visibility_off/16x16.svg @@ -0,0 +1 @@ + diff --git a/Mesora/resources/visibility_off/32x32-dark.svg b/Mesora/resources/visibility_off/32x32-dark.svg new file mode 100644 index 0000000..b2ecb60 --- /dev/null +++ b/Mesora/resources/visibility_off/32x32-dark.svg @@ -0,0 +1 @@ + diff --git a/Mesora/resources/visibility_off/32x32.svg b/Mesora/resources/visibility_off/32x32.svg new file mode 100644 index 0000000..4c905f1 --- /dev/null +++ b/Mesora/resources/visibility_off/32x32.svg @@ -0,0 +1 @@ + diff --git a/README.md b/README.md index ac7ccaf..9c2b311 100644 --- a/README.md +++ b/README.md @@ -1,43 +1,47 @@

Mesora for Autodesk Fusion

-

Informational dimensions, in the model.
Measure supported geometry and keep a table of 3D dimensions for the current session.

+

Informational dimensions, in the model.
Measure geometry, save your measurement definitions, and control each dimension's visibility.

-

Download experimental 1.0.0 · Русский · Report a problem

- -> **Experimental: use disposable documents only.** Save and reopen safety has not been established. Do not save documents while this build is enabled: Fusion CustomGraphics may leave an inaccessible persistent artifact even after graphics are removed. The implemented remove-before-save and restore-after-save behavior is unverified and is not a safety guarantee. See [safety research](docs/fusion-safety.md). +

Download · Русский · Report a problem

## Measure in context -Open **Design → Solid → Inspect → Mesora — Add Dimension**, select geometry, and build a table of measurements. Rows have session IDs such as `m1`; edit their geometry, choose a compatible measurement type, adjust the placement offset, or remove rows. Confirm the command to display the dimensions. The Mesora menu also provides visibility, refresh, and removal commands. +Open **Design → Solid → Inspect → Mesora — Add Dimension**, select geometry, and build a table of measurements. Edit a row's geometry, choose a compatible type, adjust its placement offset, or remove it. **OK** saves the definitions and visibility settings in the design; **Cancel** discards the draft. + +Depending on the selected geometry, the table offers **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area**, or **Perimeter**. Distance and angle use two compatible objects; the other types use one supported object. Values are recalculated from the current geometry after model commands. + +Each row has an eye button. The eye beside **+**, **−** and the trash button hides or shows the whole set while preserving individual settings. Mesora spaces labels apart when dimensions are added or edited. Rotating or zooming keeps their positions and leader lines fixed in the model; only text orientation changes for readability. Use **Refresh Dimensions** to arrange labels for a new view. -Depending on the selected geometry, the table offers **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area**, or **Perimeter**. Distance and angle use two compatible objects; other types use one supported object. The choices depend on the selection, and unsupported combinations are rejected. +## Save and return -## Install and try +Definitions, geometry references, offsets and visibility settings are stored with the model. Saving clears the displayed graphics so they do not become part of the saved model. After saving, open Mesora or use **Refresh Dimensions** to display them again. Opening the document or starting Mesora restores the saved set. -1. Download `Mesora-1.0.0.zip` from the [experimental release](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) and extract it to a permanent folder. +Without Mesora running, the model remains editable and the dimensions are not displayed. The measurements are informational; they do not create driving constraints. See [visibility, saving and Drawing](docs/visibility-and-drawing.md). + +## Install + +1. Download the ZIP from [GitHub Releases](https://github.com/4FusionLab/Mesora/releases) and extract it to a permanent folder. 2. In Fusion, open **Utilities → Scripts and Add-Ins → Add-Ins**. Use **+ → Script or add-in from device** and select the `Mesora` folder containing `Mesora.py` and `Mesora.manifest`. -3. Select **Mesora → Run**. If desired, enable **Run on Startup**; observe the safety warning above whenever the add-in is enabled. -4. Open a disposable design and use **Design → Solid → Inspect → Mesora — Add Dimension**. Select one or two objects for a row, review the compatible type and preview, then confirm. +3. Select **Mesora → Run** and enable **Run on Startup**. +4. Open a design and use **Design → Solid → Inspect → Mesora — Add Dimension**. Keep the extracted folder in place while Fusion uses it. No separate Python installation is needed for the release archive. -## Status and limits +## Compatibility + +Native macOS acceptance covered measurement types and real selection/type changes, visibility, Undo/Redo, model updates, saving and reopening, Save As, Drawing transition, normal Fusion restart, operation without the add-in, and installation from the package ZIP. The reproduced label-overlap and orbit-jump cases passed retesting. See the [acceptance evidence](docs/validation/stability-native-2026-11-13.ru.md). -- Measurements are **session-only**. Definitions are kept in memory, not intentionally written to `Design.attributes`; closing the document or stopping the add-in loses them. -- Creating or deleting CustomGraphics can mark a document as modified. Save/reopen behavior remains unverified; the warning above applies even when graphics have been cleared. -- Read-only measurements and direct graphic creation/deletion were tried in macOS Fusion. The command was exercised on a temporary macOS design using programmatic selection events and UI confirmation. Physical picking, broader event lifecycle, appearance and rotation, transformed or nested occurrences, and Windows remain to be validated. Offline tests do not establish native Fusion acceptance. -- The manifest declares Windows and macOS; that declaration is not evidence of native testing on both systems. +The manifest supports Windows and macOS. **Windows Fusion has not been natively tested.** A completed production drawing and every cloud-save failure/recovery path are outside the accepted scope; the detailed [coverage notes](docs/fusion-safety.md) distinguish those limits from verified behavior. ## Development and support -The add-in source is in `Mesora/`. To run offline tests or build a local archive: +The add-in source is in `Mesora/`. Offline checks: ```sh python3 -m unittest discover -s tests -v python3 scripts/check_project.py -python3 scripts/build.py --version 1.0.0 ``` -[Safety and test notes](docs/fusion-safety.md) · [Development](docs/DEVELOPMENT.md) · [Contributing](CONTRIBUTING.md) · [Report a problem](https://github.com/4FusionLab/Mesora/issues) +[Development and packaging](docs/DEVELOPMENT.md) · [Contributing](CONTRIBUTING.md) · [Report a problem](https://github.com/4FusionLab/Mesora/issues) Mesora is available under the [PolyForm Noncommercial License 1.0.0](LICENSE). Commercial use outside its permitted purposes requires a separate agreement with the copyright holder; contact 4FusionLab. diff --git a/README.ru.md b/README.ru.md index 163ec7e..cf6b4f9 100644 --- a/README.ru.md +++ b/README.ru.md @@ -1,43 +1,47 @@

Mesora для Autodesk Fusion

-

Информационные размеры прямо в модели.
Измеряйте поддерживаемую геометрию и собирайте таблицу 3D-размеров на время сеанса.

+

Информационные размеры прямо в модели.
Измеряйте геометрию, сохраняйте определения измерений и управляйте видимостью каждого размера.

-

Скачать экспериментальную версию 1.0.0 · English · Сообщить о проблеме

- -> **Экспериментальная версия: используйте только тестовые документы.** Безопасность сохранения и повторного открытия не подтверждена. Не сохраняйте документы при включённой сборке: CustomGraphics в Fusion может оставить недоступный постоянный артефакт даже после удаления графики. Реализованное удаление перед сохранением и восстановление после него не проверены и не гарантируют безопасность. Подробнее — в [исследовании](docs/fusion-safety.ru.md). +

Скачать · English · Сообщить о проблеме

## Измерения в контексте модели -Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выбирайте геометрию и собирайте таблицу измерений. У строк есть сеансовые идентификаторы, например `m1`: можно изменить геометрию, выбрать совместимый тип измерения, настроить отступ и удалить строку. Подтвердите команду, чтобы показать размеры. В меню Mesora также доступны показ и скрытие, обновление и удаление размеров. +Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выберите геометрию и соберите таблицу измерений. Можно заменить геометрию строки, выбрать совместимый тип, настроить смещение или удалить строку. **OK** сохраняет определения и видимость в модели; **Cancel** отменяет черновик. + +В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла нужны два совместимых объекта, для остальных типов — один поддерживаемый объект. Значения пересчитываются по актуальной геометрии после команд изменения модели. + +У каждой строки есть глазик. Глазик рядом с **+**, **−** и корзиной скрывает или показывает весь набор, сохраняя индивидуальные настройки. Mesora разносит подписи при добавлении или изменении размеров. При вращении и масштабировании их положение и выносные линии остаются на месте в модели; меняется только ориентация текста для чтения. **Refresh Dimensions** размещает подписи для нового ракурса. -В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла выбираются два совместимых объекта, для остальных типов — один поддерживаемый объект. Доступные варианты зависят от выбора; неподдерживаемые сочетания отклоняются. +## Сохранение и возврат к модели -## Установка и первый запуск +Определения, ссылки на геометрию, смещения и видимость хранятся вместе с моделью. Сохранение убирает отображаемую графику, чтобы она не попала в сохранённую модель. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы снова показать размеры. Открытие документа или запуск Mesora восстанавливают сохранённый набор. -1. Скачайте `Mesora-1.0.0.zip` со страницы [экспериментального релиза](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) и распакуйте архив в постоянную папку. +Без работающей Mesora модель остаётся доступной для редактирования, а размеры не показываются. Измерения информационные и не создают управляющих ограничений. См. [видимость, сохранение и Drawing](docs/visibility-and-drawing.ru.md). + +## Установка + +1. Скачайте ZIP со страницы [GitHub Releases](https://github.com/4FusionLab/Mesora/releases) и распакуйте его в постоянную папку. 2. В Fusion откройте **Utilities → Scripts and Add-Ins → Add-Ins**. Нажмите **+ → Script or add-in from device** и выберите папку `Mesora` с файлами `Mesora.py` и `Mesora.manifest`. -3. Выберите **Mesora → Run**. При желании включите **Run on Startup**; пока аддон включён, учитывайте предупреждение выше. -4. Откройте тестовую модель и выберите **Design → Solid → Inspect → Mesora — Add Dimension**. Укажите один или два объекта для строки, проверьте совместимый тип и предпросмотр, затем подтвердите команду. +3. Выберите **Mesora → Run** и включите **Run on Startup**. +4. Откройте модель и выберите **Design → Solid → Inspect → Mesora — Add Dimension**. Не перемещайте распакованную папку, пока Fusion использует аддон. Для готового архива отдельная установка Python не нужна. -## Статус и ограничения +## Совместимость + +Нативная приёмка macOS охватила типы измерений и реальный выбор/переключение типов, видимость, Undo/Redo, обновление модели, сохранение и повторное открытие, Save As, переход в Drawing, обычный перезапуск Fusion, работу без аддона и установку ZIP. Воспроизведённые случаи наложения и скачков подписей прошли повторную проверку. См. [доказательства приёмки](docs/validation/stability-native-2026-11-13.ru.md). -- Измерения существуют **только в текущем сеансе**. Определения хранятся в памяти и намеренно не записываются в `Design.attributes`; при закрытии документа или остановке аддона они теряются. -- Создание или удаление CustomGraphics может пометить документ изменённым. Сохранение и повторное открытие не проверены; предупреждение выше действует и после очистки графики. -- На macOS Fusion опробованы измерения без записи и прямое создание и удаление графики. Команда проверялась на временной модели с программными событиями выбора и подтверждением в интерфейсе. Физический выбор мышью, другие события, внешний вид и поворот, трансформированные и вложенные экземпляры, а также Windows ещё требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. -- В манифесте заявлены Windows и macOS; это не подтверждает нативную проверку на обеих системах. +Манифест поддерживает Windows и macOS. **Нативная проверка Windows Fusion не проводилась.** Завершённый рабочий чертёж и все возможные ошибки/восстановление облачного сохранения не входят в принятую область; подробные [границы проверки](docs/fusion-safety.ru.md) отделяют эти ограничения от подтверждённого поведения. ## Разработка и поддержка -Исходники аддона находятся в `Mesora/`. Автономные тесты и локальная сборка: +Исходники аддона находятся в `Mesora/`. Автономные проверки: ```sh python3 -m unittest discover -s tests -v python3 scripts/check_project.py -python3 scripts/build.py --version 1.0.0 ``` -[Безопасность и результаты проверок](docs/fusion-safety.ru.md) · [Разработка](docs/DEVELOPMENT.ru.md) · [Участие в разработке](CONTRIBUTING.ru.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues) +[Разработка и сборка](docs/DEVELOPMENT.ru.md) · [Участие в разработке](CONTRIBUTING.ru.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues) Mesora распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых лицензией случаев возможно по отдельной договорённости с правообладателем; свяжитесь с 4FusionLab. diff --git a/README_RU.md b/README_RU.md index 163ec7e..cf6b4f9 100644 --- a/README_RU.md +++ b/README_RU.md @@ -1,43 +1,47 @@

Mesora для Autodesk Fusion

-

Информационные размеры прямо в модели.
Измеряйте поддерживаемую геометрию и собирайте таблицу 3D-размеров на время сеанса.

+

Информационные размеры прямо в модели.
Измеряйте геометрию, сохраняйте определения измерений и управляйте видимостью каждого размера.

-

Скачать экспериментальную версию 1.0.0 · English · Сообщить о проблеме

- -> **Экспериментальная версия: используйте только тестовые документы.** Безопасность сохранения и повторного открытия не подтверждена. Не сохраняйте документы при включённой сборке: CustomGraphics в Fusion может оставить недоступный постоянный артефакт даже после удаления графики. Реализованное удаление перед сохранением и восстановление после него не проверены и не гарантируют безопасность. Подробнее — в [исследовании](docs/fusion-safety.ru.md). +

Скачать · English · Сообщить о проблеме

## Измерения в контексте модели -Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выбирайте геометрию и собирайте таблицу измерений. У строк есть сеансовые идентификаторы, например `m1`: можно изменить геометрию, выбрать совместимый тип измерения, настроить отступ и удалить строку. Подтвердите команду, чтобы показать размеры. В меню Mesora также доступны показ и скрытие, обновление и удаление размеров. +Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выберите геометрию и соберите таблицу измерений. Можно заменить геометрию строки, выбрать совместимый тип, настроить смещение или удалить строку. **OK** сохраняет определения и видимость в модели; **Cancel** отменяет черновик. + +В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла нужны два совместимых объекта, для остальных типов — один поддерживаемый объект. Значения пересчитываются по актуальной геометрии после команд изменения модели. + +У каждой строки есть глазик. Глазик рядом с **+**, **−** и корзиной скрывает или показывает весь набор, сохраняя индивидуальные настройки. Mesora разносит подписи при добавлении или изменении размеров. При вращении и масштабировании их положение и выносные линии остаются на месте в модели; меняется только ориентация текста для чтения. **Refresh Dimensions** размещает подписи для нового ракурса. -В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла выбираются два совместимых объекта, для остальных типов — один поддерживаемый объект. Доступные варианты зависят от выбора; неподдерживаемые сочетания отклоняются. +## Сохранение и возврат к модели -## Установка и первый запуск +Определения, ссылки на геометрию, смещения и видимость хранятся вместе с моделью. Сохранение убирает отображаемую графику, чтобы она не попала в сохранённую модель. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы снова показать размеры. Открытие документа или запуск Mesora восстанавливают сохранённый набор. -1. Скачайте `Mesora-1.0.0.zip` со страницы [экспериментального релиза](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) и распакуйте архив в постоянную папку. +Без работающей Mesora модель остаётся доступной для редактирования, а размеры не показываются. Измерения информационные и не создают управляющих ограничений. См. [видимость, сохранение и Drawing](docs/visibility-and-drawing.ru.md). + +## Установка + +1. Скачайте ZIP со страницы [GitHub Releases](https://github.com/4FusionLab/Mesora/releases) и распакуйте его в постоянную папку. 2. В Fusion откройте **Utilities → Scripts and Add-Ins → Add-Ins**. Нажмите **+ → Script or add-in from device** и выберите папку `Mesora` с файлами `Mesora.py` и `Mesora.manifest`. -3. Выберите **Mesora → Run**. При желании включите **Run on Startup**; пока аддон включён, учитывайте предупреждение выше. -4. Откройте тестовую модель и выберите **Design → Solid → Inspect → Mesora — Add Dimension**. Укажите один или два объекта для строки, проверьте совместимый тип и предпросмотр, затем подтвердите команду. +3. Выберите **Mesora → Run** и включите **Run on Startup**. +4. Откройте модель и выберите **Design → Solid → Inspect → Mesora — Add Dimension**. Не перемещайте распакованную папку, пока Fusion использует аддон. Для готового архива отдельная установка Python не нужна. -## Статус и ограничения +## Совместимость + +Нативная приёмка macOS охватила типы измерений и реальный выбор/переключение типов, видимость, Undo/Redo, обновление модели, сохранение и повторное открытие, Save As, переход в Drawing, обычный перезапуск Fusion, работу без аддона и установку ZIP. Воспроизведённые случаи наложения и скачков подписей прошли повторную проверку. См. [доказательства приёмки](docs/validation/stability-native-2026-11-13.ru.md). -- Измерения существуют **только в текущем сеансе**. Определения хранятся в памяти и намеренно не записываются в `Design.attributes`; при закрытии документа или остановке аддона они теряются. -- Создание или удаление CustomGraphics может пометить документ изменённым. Сохранение и повторное открытие не проверены; предупреждение выше действует и после очистки графики. -- На macOS Fusion опробованы измерения без записи и прямое создание и удаление графики. Команда проверялась на временной модели с программными событиями выбора и подтверждением в интерфейсе. Физический выбор мышью, другие события, внешний вид и поворот, трансформированные и вложенные экземпляры, а также Windows ещё требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. -- В манифесте заявлены Windows и macOS; это не подтверждает нативную проверку на обеих системах. +Манифест поддерживает Windows и macOS. **Нативная проверка Windows Fusion не проводилась.** Завершённый рабочий чертёж и все возможные ошибки/восстановление облачного сохранения не входят в принятую область; подробные [границы проверки](docs/fusion-safety.ru.md) отделяют эти ограничения от подтверждённого поведения. ## Разработка и поддержка -Исходники аддона находятся в `Mesora/`. Автономные тесты и локальная сборка: +Исходники аддона находятся в `Mesora/`. Автономные проверки: ```sh python3 -m unittest discover -s tests -v python3 scripts/check_project.py -python3 scripts/build.py --version 1.0.0 ``` -[Безопасность и результаты проверок](docs/fusion-safety.ru.md) · [Разработка](docs/DEVELOPMENT.ru.md) · [Участие в разработке](CONTRIBUTING.ru.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues) +[Разработка и сборка](docs/DEVELOPMENT.ru.md) · [Участие в разработке](CONTRIBUTING.ru.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues) Mesora распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых лицензией случаев возможно по отдельной договорённости с правообладателем; свяжитесь с 4FusionLab. diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index c20bd2e..30b14ab 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -2,20 +2,73 @@ [Русская версия](DEVELOPMENT.ru.md) -`Mesora/Mesora.py` contains the Fusion command and event lifecycle; `Mesora/renderer.py` handles graphics, and `Mesora/dimensions/` contains measurement and layout logic. The top-level `dimensions/` directory is retained as historical offline code; the shipped package is `Mesora/`. +`Mesora/Mesora.py` owns commands and events, `Mesora/renderer.py` owns graphics, +and `Mesora/dimensions/` contains measurement, persistence and layout logic. The +top-level `dimensions/` directory is historical offline code; the shipped package +is `Mesora/`. -## Offline checks and package +## Checks and packaging ```sh -python3 scripts/check_project.py python3 -m unittest discover -s tests -v -python3 scripts/build.py --version 1.0.0 +python3 scripts/check_project.py +``` + +Build with the numeric version resolved by GitVersion 6.8.2, for example after +setting `MESORA_PACKAGE_VERSION` to that result: + +```sh +python3 scripts/build.py --version "$MESORA_PACKAGE_VERSION" ``` -The builder writes a deterministic ZIP and SHA-256 in `dist/`. The manifest version in the archive is stamped without changing the checkout. CI checks Linux, macOS and Windows; it does not run Fusion. +The builder writes a deterministic ZIP and SHA-256 in `dist/` and stamps the archive +manifest without changing the checkout. Check the manifest, archive contents, +checksum and release notes together. CI checks Linux, macOS and Windows; it does +not run Fusion. The accepted runtime passed 144 offline tests and +[CI run 15](https://github.com/4FusionLab/Mesora/actions/runs/43475119273). +The 56-file package was installed and exercised in macOS Fusion. + +## Runtime contracts + +- Explicit commits store references, types, offsets and visibility through + `dimensions/runtime_persistence.py`. Schema v2 reads v1; unknown, damaged and + future payloads must not be silently overwritten. Recalculate values from geometry. +- Model commands queue updates through `commandTerminated` and a custom event. + Opening/startup loads definitions; activation resumes an existing restore request. + Render only in the permitted Fusion context. +- Refresh/save/stop reconcile owned graphics by their IDs, including fresh wrappers + revived by Undo. Preserve other add-ins' groups and staged command graphics. +- Arrange captions for explicit preview, commit, model refresh and restoration. + Camera events only orient text: do not repack captions or rebuild angular arcs. +- Saving removes graphics and clears the restore request. Do not recreate them in + `documentSaved`; explicit Mesora/Refresh restores display after a save. +- Retain active handlers and detach command scopes on destruction. Cancel must + restore the committed set without applying draft visibility or offsets. ## Native acceptance -Use disposable designs. Check installation and command lifecycle, picking and cancellation, measurement types, units and camera movement, transformed and nested occurrences, and multiple documents. Test save, Save As, cancellation, failed save, close and reopen in both macOS and Windows, including a full Fusion restart. CustomGraphics save/reopen safety is **not established**; do not save valuable designs while the add-in is running. See [Fusion safety notes](fusion-safety.md). +The final independent review found no open Blocker or Major in the authorized +macOS release scope. Native type probing confirmed 13 actual UI events; Inspect +on the same cylindrical face reported Loop Length 339.292 mm, Area 5089.38 mm², +Radius 27 mm and Diameter 54 mm, matching Mesora. Previous evidence also covers +Undo/Redo ownership, model update/Undo/Redo, save/reopen, Save As, Drawing transition, +normal restart, nested/transformed reference measurements and operation without +Mesora. The reproduced caption-overlap/orbit case passed user acceptance. + +Keep scope precise: the parameter-change transaction test is not manual Change +Parameters UI acceptance, and the Drawing check canceled Base View placement. +Windows Fusion, real failed-cloud-save recovery and exhaustive geometry/picking +combinations remain unverified. Windows unavailability is not a separate release +blocker under the accepted macOS scope. See [coverage](fusion-safety.md), +[native evidence](validation/stability-native-2026-11-13.ru.md) and +[traceability](validation/stable-release-cjm-2026-11-13.ru.md). + +For new regressions use synthetic documents. Saved acceptance fixtures were removed; +follow the user's current no-CAD-save constraint rather than creating new cloud files. +Event evidence requires an observer run as a managed Fusion add-in. Direct MCP +import did not deliver observer callbacks and cannot prove their absence in the +managed product. Development observer/driver scripts are excluded from the ZIP. -Release automation and immutable tags follow [release policy](../.github/RELEASE_POLICY.md). Mesora is distributed under PolyForm Noncommercial 1.0.0; commercial use outside its permitted purposes requires a separate agreement. +Publishing and immutable tags follow [release policy](../.github/RELEASE_POLICY.md). +Mesora uses [PolyForm Noncommercial 1.0.0](../LICENSE); commercial use outside its +permitted purposes requires a separate agreement. diff --git a/docs/DEVELOPMENT.ru.md b/docs/DEVELOPMENT.ru.md index b983bcd..6b62b83 100644 --- a/docs/DEVELOPMENT.ru.md +++ b/docs/DEVELOPMENT.ru.md @@ -2,20 +2,75 @@ [English](DEVELOPMENT.md) -`Mesora/Mesora.py` содержит команду Fusion и обработку жизненного цикла событий; `Mesora/renderer.py` отвечает за графику, а `Mesora/dimensions/` — за логику измерений и размещения. Каталог `dimensions/` в корне сохранён как исторический автономный код; поставляемый пакет — `Mesora/`. +`Mesora/Mesora.py` отвечает за команды и события, `Mesora/renderer.py` — за графику, +а `Mesora/dimensions/` содержит логику измерений, сохранения и размещения. Корневой +каталог `dimensions/` — исторический автономный код; поставляемый пакет — `Mesora/`. -## Автономные проверки и пакет +## Проверки и сборка ```sh -python3 scripts/check_project.py python3 -m unittest discover -s tests -v -python3 scripts/build.py --version 1.0.0 +python3 scripts/check_project.py +``` + +Собирайте с числовой версией, рассчитанной GitVersion 6.8.2, например после +записи этого результата в `MESORA_PACKAGE_VERSION`: + +```sh +python3 scripts/build.py --version "$MESORA_PACKAGE_VERSION" ``` -Сборщик создаёт детерминированный ZIP и SHA-256 в `dist/`. Версия манифеста записывается в архив без изменения файлов рабочего каталога. CI проверяет Linux, macOS и Windows, но не запускает Fusion. +Сборщик создаёт детерминированный ZIP и SHA-256 в `dist/`, записывая версию +манифеста в архив без изменения checkout. Проверяйте манифест, содержимое архива, +checksum и release notes вместе. CI проверяет Linux, macOS и Windows, но не +запускает Fusion. Принятый runtime прошёл 144 автономных теста и +[CI run 15](https://github.com/4FusionLab/Mesora/actions/runs/43475119273). +Пакет из 56 файлов установлен и проверен в macOS Fusion. + +## Контракты runtime + +- Явное подтверждение сохраняет ссылки, типы, смещения и видимость через + `dimensions/runtime_persistence.py`. Схема v2 читает v1; неизвестные, повреждённые + и будущие данные нельзя молча перезаписывать. Значения пересчитываются по геометрии. +- Команды модели ставят обновление в очередь через `commandTerminated` и custom + event. Открытие/запуск загружают определения; активация продолжает существующий + запрос восстановления. Рендер разрешён только в подходящем контексте Fusion. +- Refresh/save/stop сверяют собственную графику по ID, включая новые wrappers, + восстановленные Undo. Сохраняйте группы других аддонов и staged-графику команды. +- Размещайте подписи при явном предпросмотре, подтверждении, обновлении модели и + восстановлении. События камеры лишь ориентируют текст: не переразмещают подписи + и не перестраивают угловые дуги. +- Сохранение удаляет графику и снимает запрос восстановления. Не создавайте её + заново в `documentSaved`; явные Mesora/Refresh возвращают показ после сохранения. +- Удерживайте активные обработчики и отключайте command scopes при уничтожении. + Cancel возвращает подтверждённый набор без применения черновых глазиков или смещений. + +## Нативная приёмка + +Финальный независимый review не нашёл открытых Blocker или Major в согласованной +macOS-области выпуска. Нативная проверка типов подтвердила 13 настоящих UI-событий; +Inspect той же цилиндрической грани показал Loop Length 339,292 mm, Area 5089,38 mm², +Radius 27 mm и Diameter 54 mm — значения совпали с Mesora. Прежние доказательства +также охватывают владение графикой Undo/Redo, обновление модели/Undo/Redo, +сохранение/повторное открытие, Save As, переход в Drawing, обычный перезапуск, +измерения вложенных/трансформированных ссылок и работу без Mesora. Воспроизведённый +случай наложений/скачков подписей прошёл приёмку пользователя. -## Приёмка в Fusion +Соблюдайте границы: проверка транзакции изменения параметра не является приёмкой +ручного Change Parameters UI, а проверка Drawing отменяла размещение Base View. +Windows Fusion, восстановление после реального сбоя облачного сохранения и +исчерпывающие сочетания геометрии/выбора остаются непроверенными. Недоступность +Windows не является отдельным блокером выпуска в принятой macOS-области. См. +[границы проверки](fusion-safety.ru.md), [нативные доказательства](validation/stability-native-2026-11-13.ru.md) +и [трассировку](validation/stable-release-cjm-2026-11-13.ru.md). -Используйте тестовые модели. Проверьте установку и жизненный цикл команды, выбор и отмену, типы измерений, единицы и перемещение камеры, трансформированные и вложенные экземпляры и работу с несколькими документами. На macOS и Windows проверьте сохранение, Save As, отмену, неудачное сохранение, закрытие и повторное открытие, включая полный перезапуск Fusion. Безопасность сохранения и повторного открытия с CustomGraphics **не подтверждена**; не сохраняйте ценные модели при работающем аддоне. См. [заметки о безопасности Fusion](fusion-safety.ru.md). +Для новых регрессий используйте синтетические документы. Сохранённые приёмочные +фикстуры удалены; соблюдайте действующее указание пользователя не сохранять CAD, +а не создавайте новые облачные файлы. Доказательство событий требует observer, +запущенного штатным аддоном Fusion. Прямой импорт через MCP не дал callback +observer и не доказывает их отсутствие у штатного продукта. Скрипты development +observer/driver исключены из ZIP. -Автоматизация релизов и неизменяемые теги описаны в [правилах выпуска](../.github/RELEASE_POLICY.ru.md). Mesora распространяется на условиях PolyForm Noncommercial 1.0.0; коммерческое использование за пределами разрешённых случаев требует отдельного соглашения. +Публикация и неизменяемые теги описаны в [правилах выпуска](../.github/RELEASE_POLICY.ru.md). +Mesora использует [PolyForm Noncommercial 1.0.0](../LICENSE); коммерческое использование +за пределами разрешённых случаев требует отдельного соглашения. diff --git a/docs/fusion-safety.md b/docs/fusion-safety.md index c7005ef..caddab7 100644 --- a/docs/fusion-safety.md +++ b/docs/fusion-safety.md @@ -1,54 +1,80 @@ -# Fusion API safety research +# Fusion lifecycle and acceptance coverage [Русская версия](fusion-safety.ru.md) -## CustomGraphics persistence +## Accepted macOS scope -An [Autodesk forum report](https://forums.autodesk.com/t5/fusion-support-forum/bug-report-custom-graphics-serialized-into-a-document-are/td-p/14142906) -describes custom graphics present during a save remaining visible after reopening -while becoming unavailable through the API. A forum reply describes removing -graphics before save and recreating them afterward; this is an anecdotal workaround, -not a documented guarantee. No archive modification is implemented or recommended. +The independent final product review found no open Blocker or Major in the agreed +macOS release scope. Evidence covers all seven measurement types, actual selection +and type-change events, visibility, Undo/Redo, model updates, save/reopen, Save As, +Drawing transition, normal restart, reference measurements in transformed/nested +occurrences, multi-document isolation and installing the package ZIP. Windows +Fusion remains natively unverified; it is not a separate release blocker under +the accepted macOS scope. -The official [Application API](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Application.htm) -documents `documentSaving` at the start of saving, `documentSaved` after completion, -`documentOpened` at the end of opening, `documentActivated` and `documentClosing`. -Saving can be canceled through `DocumentEventArgs.isSaveCanceled`. Documentation -does not establish that deleting every custom graphic in `documentSaving` prevents -all cached-scene serialization paths, nor that a canceled or failed save always -delivers `documentSaved`. Treat those as open questions. Do not claim persistence -is safe or restore graphics blindly after an interrupted save. +The final native type probe confirmed 13 actual UI events. For the same cylindrical +face, Fusion Inspect and Mesora agreed on Loop Length 339.292 mm, Area 5089.38 mm², +Radius 27 mm and Diameter 54 mm. Do not confuse that perimeter with the length of +one circular edge. The [Measure reference](https://help.autodesk.com/cloudhelp/ENU/Fusion-Model/files/GUID-D070A3CB-729F-410F-9DA4-D9DF7F4D55B5.htm) +lists the face measurements available in Inspect. -Before enabling graphics, exercise save, Save As, cancel, failed save, close, -reopen, multiple open documents, shutdown and add-in stop on disposable designs, -with both macOS and Windows. Verify actual event order, deletion outcomes and -absence of orphaned graphics after a full Fusion restart. An experiment cannot -prove all possible crash and save paths safe; document the remaining risk. +The reproduced caption overlap and duplicate-graphics Undo defects passed retests. +Camera changes now preserve model-space caption anchors, leaders and angular arcs; +the user confirmed that normal orbit no longer jumps. A new view can still project +labels together; **Refresh Dimensions** arranges them for that view. -## Measurements and references +See [native evidence](validation/stability-native-2026-11-13.ru.md) and +[acceptance traceability](validation/stable-release-cjm-2026-11-13.ru.md). +Historical entries in those reports retain their original failures and subsequent +retests; they are not the current product status. -[Edge evaluator](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/fusion_BRepEdge_evaluator.htm) +## Saving and CustomGraphics + +Definitions and settings persist in design attributes. Graphics are display state: +Mesora removes them before saving and does not recreate them in `documentSaved`. +Open Mesora or use **Refresh Dimensions** after saving to display them again. +Opening a saved document or starting the add-in restores the definitions and +requests display. Stop/reopen checks found no labels without Mesora, and the +model remained editable and savable without the add-in. + +This strategy avoids the repeated source-save loop during Drawing creation. +The accepted Drawing test reached the sheet and canceled Base View placement; +it does not claim completed drawing detailing. An [Autodesk forum report](https://forums.autodesk.com/t5/fusion-support-forum/bug-report-custom-graphics-serialized-into-a-document-are/td-p/14142906) +describes inaccessible graphics serialized into a file. Earlier local observations +using a different Python loading/API path are historical and are not attributed +to the accepted managed GUI lifecycle. No CAD archive modification is used. + +The [Application API](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Application.htm) +documents document lifecycle events. Current [DocumentEventArgs](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_DocumentEventArgs.htm) +uses `isOperationCancelled` and `cancelReason`. A failed cleanup must retain owned +groups for retry and cancel saving. A zero graphics count alone is not proof of +an annotation-free saved file: native acceptance also used visual inspection. + +## Geometry and event contracts + +Use the [BRep edge evaluator](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/fusion_BRepEdge_evaluator.htm) and [getLengthAtParameter](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_CurveEvaluator3D_getLengthAtParameter.htm) -provide the curve length between parameters rather than a chord measurement. -[SketchPoint.worldGeometry](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/fusion_SketchPoint_worldGeometry.htm) -is documented in root-component space including assembly context. Other object -types and token resolution need their own context tests. Token strings must not be -compared as identity; unresolved or ambiguous references must not render old data. - -## Initial validation (historical) - -The observations below document an earlier investigation. For later command checks and remaining limitations, see the [README](../README.md). - -Offline unit tests exercise arithmetic, evaluator and persistence stubs, schema -handling, and reference failure cases. A read-only run on the open macOS Fusion -design measured one full circular edge (radius 0.51 cm, length 3.2044245067 cm), -one cylindrical face (diameter 1.02 cm), two vertices, sketch arcs and circles, -and resolved an edge and a vertex in an occurrence. The inspected occurrence had -zero translation; this does not validate transformed or nested occurrences. The -document's modified flag was false both before and after. There has been no live -attribute write, save/reopen test or Windows test. A direct native renderer smoke -test created and deleted groups for distance, circular edge length, radius and -cylindrical diameter; the group count returned to zero. This did not test the -interactive command or establish visual quality. Fusion marked the open design -modified, and it was not saved. Attempts to enable the add-in through the manager -did not produce registered commands; the cause has not yet been established. +for curve length, not chord length. Restore entity and occurrence references in +their proper context; do not compare token strings as object identity. Missing or +ambiguous references must not display stale values, and unsupported/corrupt stored +definitions must not be silently overwritten. + +Deferred work runs through Fusion's custom event queue in its permitted thread. +Independent event evidence came from an observer started as a managed add-in. +Importing the observer directly through MCP did not deliver callbacks and cannot +prove that callbacks are absent from the managed product. Development helpers +are excluded from the ZIP. + +## Limits and future regression work + +The radius update/Undo/Redo test used a native acceptance command with its own +Fusion transaction, not manual Change Parameters UI. The earlier UI attempt was +interrupted during AX/Qt accessibility inspection; its cause was not established +as Mesora. Real failed-cloud-save recovery, every API save route and exhaustive +geometry/picking combinations are not covered by the release acceptance. Nested +reference measurements do not claim a separate complete annotation auto-update +workflow for every assembly edit. + +Use synthetic documents for future regressions and preserve user CAD data. The +saved acceptance fixtures were deleted. Current testing follows the user's +no-CAD-save instruction; do not recreate cloud fixtures without authorization. diff --git a/docs/fusion-safety.ru.md b/docs/fusion-safety.ru.md index 87e81da..d69e099 100644 --- a/docs/fusion-safety.ru.md +++ b/docs/fusion-safety.ru.md @@ -1,21 +1,81 @@ -# Исследование безопасности Fusion API +# Жизненный цикл Fusion и границы приёмки [English](fusion-safety.md) -## Сохранение CustomGraphics +## Принятая область macOS -В [сообщении на форуме Autodesk](https://forums.autodesk.com/t5/fusion-support-forum/bug-report-custom-graphics-serialized-into-a-document-are/td-p/14142906) описано, что пользовательская графика, присутствовавшая при сохранении, может оставаться видимой после повторного открытия, но становиться недоступной через API. В ответе на форуме предложено удалить графику перед сохранением и создать заново после него; это частный опыт, а не документированная гарантия. Изменение архивов не реализовано и не рекомендуется. +Независимый финальный продуктовый review не нашёл открытых Blocker или Major в +согласованной macOS-области выпуска. Доказательства охватывают семь типов измерений, +настоящие события выбора и изменения типа, видимость, Undo/Redo, обновление модели, +сохранение/повторное открытие, Save As, переход в Drawing, обычный перезапуск, +измерения ссылок трансформированных/вложенных экземпляров, изоляцию документов и +установку ZIP. Windows Fusion остаётся нативно непроверенной и не является +отдельным релизным блокером в принятой macOS-области. -Официальная документация [Application API](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Application.htm) описывает `documentSaving` в начале сохранения, `documentSaved` после завершения, `documentOpened` в конце открытия, а также `documentActivated` и `documentClosing`. Сохранение можно отменить через `DocumentEventArgs.isSaveCanceled`. Документация не подтверждает, что удаление всей пользовательской графики в `documentSaving` предотвращает все пути сериализации кешированной сцены, или что после отменённого либо неудачного сохранения всегда приходит `documentSaved`. Это открытые вопросы. Не утверждайте, что сохранение безопасно, и не восстанавливайте графику без проверки после прерванного сохранения. +Финальная нативная проверка типов подтвердила 13 настоящих UI-событий. Для той же +цилиндрической грани Fusion Inspect и Mesora совпали по Loop Length 339,292 mm, +Area 5089,38 mm², Radius 27 mm и Diameter 54 mm. Не путайте этот периметр с длиной +одного кругового ребра. [Справка Measure](https://help.autodesk.com/cloudhelp/ENU/Fusion-Model/files/GUID-D070A3CB-729F-410F-9DA4-D9DF7F4D55B5.htm) +перечисляет доступные в Inspect измерения граней. -Перед включением графики проверьте сохранение, Save As, отмену, неудачное сохранение, закрытие, повторное открытие, несколько открытых документов, завершение Fusion и остановку аддона на тестовых моделях в macOS и Windows. Проверьте фактический порядок событий, результат удаления и отсутствие оставшейся графики после полного перезапуска Fusion. Эксперимент не может доказать безопасность всех возможных сбоев и вариантов сохранения; документируйте оставшийся риск. +Воспроизведённые наложения подписей и дубликаты графики при Undo прошли повторную +проверку. Камера теперь сохраняет модельные точки подписей, выносные линии и +угловые дуги; пользователь подтвердил отсутствие скачков при обычном вращении. +Новый ракурс всё ещё может спроецировать подписи друг на друга; **Refresh Dimensions** +размещает их для этого вида. -## Измерения и ссылки +См. [нативные доказательства](validation/stability-native-2026-11-13.ru.md) и +[трассировку приёмки](validation/stable-release-cjm-2026-11-13.ru.md). Исторические +записи этих отчётов сохраняют исходные ошибки и последующие перепроверки; это +не текущий статус продукта. -[Edge evaluator](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/fusion_BRepEdge_evaluator.htm) и [getLengthAtParameter](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_CurveEvaluator3D_getLengthAtParameter.htm) возвращают длину кривой между параметрами, а не длину хорды. [SketchPoint.worldGeometry](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/fusion_SketchPoint_worldGeometry.htm) документирован в пространстве корневого компонента с учётом контекста сборки. Другие типы объектов и разрешение токенов требуют отдельных проверок контекста. Строки токенов нельзя сравнивать как идентификаторы объектов; при неразрешённых или неоднозначных ссылках старые данные отображать нельзя. +## Сохранение и CustomGraphics -## Первоначальные проверки (исторические сведения) +Определения и настройки сохраняются в атрибутах модели. Графика — состояние +отображения: Mesora удаляет её перед сохранением и не пересоздаёт в `documentSaved`. +После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть +показ. Открытие сохранённого документа или запуск аддона восстанавливают определения +и запрашивают отображение. Проверки остановки/повторного открытия не обнаружили +подписей без Mesora; модель оставалась доступной для изменения и сохранения без аддона. -Наблюдения ниже относятся к более раннему исследованию. Последующие проверки команды и оставшиеся ограничения описаны в [README](../README.ru.md). +Это предотвращает повторное сохранение исходника при создании Drawing. Принятая +проверка Drawing достигла листа и отменила размещение Base View; завершённое +оформление чертежа не заявляется. [Сообщение на форуме Autodesk](https://forums.autodesk.com/t5/fusion-support-forum/bug-report-custom-graphics-serialized-into-a-document-are/td-p/14142906) +описывает недоступную графику, сериализованную в файл. Прежние локальные наблюдения +из другого пути загрузки Python/API — исторические и не приписываются принятому +штатному GUI-жизненному циклу. Изменение CAD-архивов не используется. -Автономные модульные тесты проверяют вычисления, заглушки evaluator и хранения, обработку схем и ошибки ссылок. При проверке без записи открытой модели Fusion на macOS измерены одно полное круговое ребро (радиус 0,51 см, длина 3,2044245067 см), одна цилиндрическая грань (диаметр 1,02 см), две вершины, дуги и окружности эскиза; также разрешены ссылки на ребро и вершину в экземпляре. У проверенного экземпляра было нулевое смещение; это не подтверждает работу с трансформированными и вложенными экземплярами. Признак изменения документа до и после оставался ложным. Реальной записи атрибутов, проверки сохранения и повторного открытия и тестирования Windows не было. В прямой дымовой проверке нативного рендерера были созданы и удалены группы для расстояния, длины кругового ребра, радиуса и диаметра цилиндра; число групп вернулось к нулю. Интерактивная команда и качество отображения при этом не проверялись. Fusion пометил открытую модель изменённой, и она не сохранялась. Попытки включить аддон через менеджер не привели к регистрации команд; причина на тот момент не была установлена. +[Application API](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Application.htm) +описывает события жизненного цикла документа. Актуальный [DocumentEventArgs](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_DocumentEventArgs.htm) +использует `isOperationCancelled` и `cancelReason`. При отказе очистки нужно удержать +собственные группы для повторной попытки и отменить сохранение. Одного нулевого +счётчика графики недостаточно для доказательства отсутствия аннотаций в файле: +нативная приёмка включала визуальную проверку. + +## Контракты геометрии и событий + +Используйте [BRep edge evaluator](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/fusion_BRepEdge_evaluator.htm) +и [getLengthAtParameter](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_CurveEvaluator3D_getLengthAtParameter.htm) +для длины кривой, а не хорды. Восстанавливайте ссылки сущностей и экземпляров в +правильном контексте; не сравнивайте строки токенов как идентичность объектов. +Потерянные или неоднозначные ссылки не должны показывать старые значения, а +неподдерживаемые/повреждённые определения нельзя молча перезаписывать. + +Отложенная работа выполняется через очередь custom event в разрешённом потоке +Fusion. Независимое доказательство событий дал observer, запущенный штатным +аддоном. Прямой импорт observer через MCP не дал callback и не доказывает их +отсутствие у штатного продукта. Development helpers исключены из ZIP. + +## Ограничения и будущие регрессии + +Проверка обновления радиуса/Undo/Redo использовала нативную приёмочную команду с +собственной транзакцией Fusion, а не ручной Change Parameters UI. Прежняя UI-попытка +прервалась при чтении AX/Qt accessibility; её причина не установлена как Mesora. +Восстановление после реального сбоя облачного сохранения, каждый API-путь сохранения +и исчерпывающие сочетания геометрии/выбора не входят в релизную приёмку. Измерения +вложенных ссылок не означают отдельный полный сценарий автообновления аннотаций +при любом изменении сборки. + +Для будущих регрессий используйте синтетические документы и сохраняйте пользовательские +CAD-данные. Сохранённые приёмочные фикстуры удалены. Текущие проверки соблюдают +указание пользователя не сохранять CAD; не создавайте облачные фикстуры заново без разрешения. diff --git a/docs/releases/1.1.0.md b/docs/releases/1.1.0.md new file mode 100644 index 0000000..04f1c3a --- /dev/null +++ b/docs/releases/1.1.0.md @@ -0,0 +1,19 @@ +# Mesora 1.1.0 + +[Русская версия](1.1.0.ru.md) + +Measurement definitions now stay with the Fusion design. Mesora restores references, offsets and row/global visibility, and calculates values from the current geometry. A design saved with this version can be opened and edited without Mesora; its Mesora annotations are not displayed while the add-in is absent. + +- Saved definitions for Distance, Angle, Edge Length, Radius, Diameter, Area and Perimeter. +- Automatic updates after model commands, including geometry Undo/Redo. +- Separate caption placement for the visible set; positions and angular geometry stay fixed while orbiting and zooming. +- Ownership-based cleanup prevents duplicate graphics after Undo. Closing a command releases its temporary handlers and document references. +- Missing references remain editable instead of blocking the entire measurement table. Unsupported or damaged metadata is not silently overwritten. + +Saving removes session graphics to keep the saved model clean. Open Mesora or run **Refresh Dimensions** to show them again. The definitions remain in the design. + +Validated with 144 offline tests, packaging checks on Linux/macOS/Windows, and native macOS Fusion acceptance. Native Windows Fusion has not been tested. The native checks include seven measurement types, actual picker/type-change events, nested transformed references, Drawing creation, restart and use without the add-in. See the [acceptance matrix](../validation/stable-release-cjm-2026-11-13.ru.md) for the exact scope and limits. + +Extract the versioned ZIP, add its `Mesora` folder in **Scripts and Add-Ins**, run the add-in and enable **Run on Startup**. + +Licensed under PolyForm Noncommercial 1.0.0. Commercial use outside the permitted purposes requires a separate agreement with 4FusionLab. diff --git a/docs/releases/1.1.0.ru.md b/docs/releases/1.1.0.ru.md new file mode 100644 index 0000000..563ea22 --- /dev/null +++ b/docs/releases/1.1.0.ru.md @@ -0,0 +1,19 @@ +# Mesora 1.1.0 + +[English](1.1.0.md) + +Определения измерений теперь остаются в модели Fusion. Mesora восстанавливает ссылки, смещения и индивидуальную/общую видимость, а значения вычисляет по актуальной геометрии. Модель, сохранённую этой версией, можно открывать и редактировать без Mesora; при отсутствии аддина его размеры не отображаются. + +- Сохранение определений Distance, Angle, Edge Length, Radius, Diameter, Area и Perimeter. +- Автоматическое обновление после команд моделирования, включая Undo/Redo геометрии. +- Раздельное размещение подписей видимого набора; позиции подписей и геометрия угла остаются неподвижными при вращении и масштабировании. +- Очистка собственной графики предотвращает дубликаты после Undo. Закрытие команды освобождает её временные обработчики и ссылки на документ. +- Недоступные ссылки остаются редактируемыми и не блокируют всю таблицу. Неподдерживаемые или повреждённые данные не перезаписываются молча. + +При сохранении сессионная графика удаляется, чтобы сохранённая модель оставалась чистой. Для повторного отображения откройте Mesora или выполните **Refresh Dimensions**. Определения остаются в модели. + +Пройдены 144 автономных теста, проверки упаковки на Linux/macOS/Windows и нативная приёмка в macOS Fusion. Нативная Windows Fusion не проверялась. Нативные проверки включают семь типов измерений, настоящие события выбора и изменения типа, вложенные трансформированные ссылки, создание Drawing, перезапуск и работу без аддина. Точные границы и ограничения приведены в [матрице приёмки](../validation/stable-release-cjm-2026-11-13.ru.md). + +Распакуйте версионный ZIP, подключите папку `Mesora` через **Scripts and Add-Ins**, запустите аддин и включите **Run on Startup**. + +Лицензия — PolyForm Noncommercial 1.0.0. Коммерческое использование за пределами разрешённых целей требует отдельного соглашения с 4FusionLab. diff --git a/docs/validation/drawing-visibility-2026-11-13.ru.md b/docs/validation/drawing-visibility-2026-11-13.ru.md new file mode 100644 index 0000000..e1689a9 --- /dev/null +++ b/docs/validation/drawing-visibility-2026-11-13.ru.md @@ -0,0 +1,55 @@ +# Рабочий отчёт: Drawing и видимость размеров, 13.11.2026 + +## Причина сбоя + +На исходном коде воспроизведено повторное сохранение тестового цилиндра при +создании Drawing. Обработчик `documentSaved` вызывал `State.refresh()`, создание +CustomGraphics снова помечало модель изменённой. Команда +`NewFusionDrawingDocumentCommand` повторяла сохранение; версии тестового файла +росли, интерфейс зависал. На промежуточном исправлении обнаружен риск такого же +восстановления при активации исходного документа, поэтому автоматическое +восстановление удалено и из этой точки. Пользовательские модели не открывались. + +## Итоговое поведение + +- Перед сохранением удаляется графика, включая живой предпросмотр. +- В `documentSaved`, при активации документа и рабочей среды графика не создаётся. +- После сохранения размеры возвращаются явным действием: открытием команды Mesora + или `Refresh Dimensions`. Настройки измерений остаются в памяти текущей сессии. +- Обработчик камеры пропускает Drawing и переходы между рабочими средами. +- Глазик строки меняет только видимость; общий глазик сохраняет настройки строк. +- Глазики используют BoolValueCommandInput с постоянным состоянием и явный + `doExecutePreview()`, чтобы результат сразу отображался. + +## Проверено на финальном коде в macOS Fusion + +- Штатная загрузка после перезапуска; установлены 12 обработчиков уровня аддина. +- Окно с двумя измерениями: Edge Length и Radius; глазики у строк и на панели. +- Настоящее нажатие глазика первой строки: `m1.visible=False`, `m2.visible=True`, + одна валидная группа предпросмотра; обе строки сохранены. +- Общий глазик: `visible=False`, ноль групп предпросмотра, две строки. +- Повторный общий показ: `visible=True`, одна группа; первая строка скрыта, + вторая видима. Индивидуальное скрытие не сброшено. +- Cancel: исходное состояние восстановлено, hidden_ids пуст, две группы. +- Создание Drawing с показанными размерами: исходник v162 -> v163 за одно + сохранение; активны `FusionDocumentationEnvironment`, `adsk::drawing::Drawing` + и `FusionDrawingViewBaseCommand`. Исходная модель чистая, групп Mesora нет. +- Возврат в модель: `FusionSolidEnvironment`, до явного обновления документ чистый; + `State.refresh()` без ошибок восстановил две группы. Зависания нет. +- Тестовые окна закрыты без сохранения чертежа; синтетический исходный файл + сохранён для воспроизведения. На ранних неудачных прогонах он накопил версии. + +## Автоматическая проверка + +74 теста проходят, `scripts/check_project.py` проходит, `git diff --check` чистый. +Регрессионные тесты проверяют запрет пересоздания графики после сохранения и +активации, пропуск Drawing обработчиком камеры, скрытие без потери определений, +применение и отмену видимости, глобальное скрытие и восстановление. +Локальный ZIP 1.1.0 проверен по манифесту, исходникам, четырём иконкам скрытого +глазика и SHA-256. Это локальный кандидат, не опубликованный релиз. + +Windows Fusion не проверялся. Применение скрытия через OK и повторное открытие +проверены офлайн; нативный прогон видимости покрывает предпросмотр и Cancel. +Полная матрица save/reopen, сбой сохранения и Undo/Redo остаётся вне этой проверки. +В Drawing наблюдались диагностические ошибки установленного Paramood NO_DESIGN; +его код не изменялся и успешным результатом Mesora они не считаются. diff --git a/docs/validation/observer-and-ax-recovery-2026-11-13.ru.md b/docs/validation/observer-and-ax-recovery-2026-11-13.ru.md new file mode 100644 index 0000000..b4cb8b5 --- /dev/null +++ b/docs/validation/observer-and-ax-recovery-2026-11-13.ru.md @@ -0,0 +1,65 @@ +# Managed observer и восстановление нативной приёмки + +Рабочая заметка от 2026-11-13. Нативные результаты сообщил root — единственный +владелец Fusion в этой приёмке; автор заметки не обращался к нативной сессии. + +## Подтверждённые границы доказательств + +- Observer, запущенный штатным Script Manager, получил собственный + `customEvent.callback`. Это подтверждает доставку его callback, в отличие от + предыдущего наблюдателя, зарегистрированного из MCP script. +- В сообщённой трассе UI Save As присутствуют `PLM360SaveAs`, `documentSaving` + и `documentSaved` с нулём групп; завершение save не восстановило графику. + Это не заменяет визуальную проверку повторного открытия без Mesora. +- Следующий этап прерван зависанием Fusion при обращении к дереву accessibility + окна Parameters. В сообщённом sample основной поток проходит через + `_AXXMIGCopyHierarchy` и `QMacAccessibilityElement::accessibilitySelectedChildren`. + Стек не содержит Python/Mesora. Это свидетельство места остановки потока; + первопричина и отсутствие иных факторов этим sample не установлены. +- CUA и MCP перестали отвечать. Нативные сценарии, прерванные этим состоянием, + остаются незавершёнными. Несохранённый пользовательский документ нельзя + закрывать или принудительно завершать Fusion ради продолжения приёмки. + +## После восстановления отзывчивости + +1. Сначала убедиться, что пользовательская работа сохранена доступным штатным + способом. Не выполнять массовые закрытия документов. +2. Для Parameters использовать снимок экрана и ограниченные клавиатурные + действия. Не запрашивать полное AX-дерево Qt Parameters, особенно после + раскрытия дерева параметров. Каждое изменение подтверждать изображением или + узким чтением Fusion API на разрешённом основном потоке. +3. Если observer ещё работает, остановить **MesoraAcceptanceObserver** через + Script Manager. Проверить `isRunning=False` и финальную запись + `observer.stopped` с `remaining_handlers=0`; `observer.detach_failed` означает, + что очистка не подтверждена. Остановка не должна менять CAD. +4. Если Fusion уже перезапущена, прежние callback не живут в новой сессии. + Сохранить прежний JSONL как доказательство и начать новую сессию observer. + +## Повторяемый запуск observer + +Из корня checkout выполнить: + +```sh +python3 scripts/prepare_native_observer.py +``` + +Генератор создаёт исключённый из Git и продукта каталог +`dist/native-acceptance/MesoraAcceptanceObserver`. Он копирует актуальный +`scripts/native_acceptance_observer.py` как относительный подмодуль и создаёт +manifest и entrypoint. В исходниках генератора нет абсолютных пользовательских +путей. Существующий `events.jsonl` сохраняется, новые сессии дописываются. +Не регенерировать файлы работающего observer: сначала штатно остановить его. + +Через `Application.scripts.itemByPath(folder)` получить зарегистрированный +observer; только при его отсутствии использовать `addExisting(folder)`. +Для observer оставить `isRunOnStartup=False` и вызвать `run(False)`, затем вернуть +управление Fusion. Для Mesora сохранить пользовательский `Run on Startup=True`. + +Проверить новую запись `customEvent.callback`, прежде чем интерпретировать +отсутствие других событий. `observer.started`, `customEvent.queued` и +`isRunning=True` сами по себе доставку callback не доказывают. + +Не вызывать `start()` наблюдателя через импорт из MCP script и не заменять +штатный запуск Mesora вызовом `exec` её исходника. После managed stop/run проверить +фактическое открытие команды Mesora; затем выполнять save/reopen/restart и +отдельно визуально проверять отсутствие размеров при остановленной Mesora. diff --git a/docs/validation/stability-native-2026-11-13.ru.md b/docs/validation/stability-native-2026-11-13.ru.md new file mode 100644 index 0000000..0147157 --- /dev/null +++ b/docs/validation/stability-native-2026-11-13.ru.md @@ -0,0 +1,212 @@ +# Mesora: нативная проверка стабильности, 13.11.2026 + +**Текущий итог: macOS-приёмка принята; публикационный gate выполняется.** На `a77502e` закрыты D06 (graphics ownership после Undo/Redo) и D07 (наложения и скачки при orbit). После возвращения Fusion из Planara дополнительно прошли 13 реальных UI-переходов типов и сверка цилиндрического периметра с native Measure. Нативная установка ZIP, фактический выбор мышью, семь типов, вложенные трансформированные ссылки, Drawing, штатный restart и работа без Mesora подтверждены в указанном ниже scope. 144 offline tests и CI run15 прошли. Windows Fusion нативно не проверялась и по решению пользователя не блокирует выпуск. Маркировка экспериментального продукта снимается; финальные метаданные, документация и опубликованные артефакты проходят отдельные технические проверки. Ниже сохранена история прежних ревизий, а не текущие открытые дефекты. + +## Начальный прогон: среда и границы доказательства (история) + +macOS, Autodesk Fusion `2706.1.17`. Проверял основной агент, единственный владелец общей Fusion-сессии. База checkout: `a28bedb`, с текущими изменениями кандидата. Все изменения геометрии и сохранения выполнялись только на двух новых синтетических цилиндрах в тестовой области `_Preferences`. Открытую пользовательскую модель не редактировали, не сохраняли и не закрывали. Полный restart Fusion не выполняли из-за открытого изменённого пользовательского документа. + +Вызовы Fusion API проходили через MCP script. Запуск команды через `CommandDefinition.execute()` не оставлял открытый Mesora-диалог; прямые UI-действия не дали подтверждённого изменения интерфейса. Поэтому данные ниже **не являются** приёмкой реального OK/Cancel или порядка UI save/commandTerminated events. Прямой вызов `notify` отмечен отдельно; он проверяет обработчик на настоящей CAD-геометрии, но не доставку события. + +## Исторический S19 через прежний способ запуска — FAIL + +Фикстура `Mesora stable acceptance 2026-11-13`: + +1. Создан цилиндр радиусом 2 cm и высотой 4 cm. Через рабочий `Execute('add')` записаны две строки: скрытый `m1` Radius и видимый `m2` Edge Length; одна graphics group. В attributes — schema v2, references, offsets и индивидуальная видимость. +2. `Document.saveAs(...)` вернул `True`. После возврата и повторной проверки: `isModified=False`, одна tracked group, `removed_for_save=False`. Предсохранительная очистка при этом пути не выполнилась. Точную причину отсутствия очистки/доставки события в MCP-контексте считать открытой; не переносить этот результат на непроверенный UI Save. +3. Mesora остановлена, документ закрыт без дополнительных изменений, сохранённая версия открыта снова. Mesora controls отсутствуют, одно BRep body, `customGraphicsGroups.count=0`, документ чистый. **Визуально размер m2 всё ещё виден.** +4. Без Mesora радиус изменён с 2 до 2.5 cm. Сохранение вернуло `True`, close/reopen успешны, радиус остаётся 2.5 cm, одно body, API graphics count по-прежнему 0, документ чистый. +5. Визуально по-прежнему видна старая подпись `m2 L=125.7 mm`, хотя актуальная окружность имеет длину около 157.1 mm. Модель геометрически доступна для работы без аддина, но полная совместимость **не принята** из-за ложной аннотации. + +Снимки только синтетического viewport сохранены локально, не включены в пакет: + +- `dist/local-validation/orphan-without-mesora.png` — после reopen с остановленным Mesora; +- `dist/local-validation/orphan-after-model-edit.png` — устаревшая подпись после изменения радиуса и save/reopen. + +Оба снимка просмотрены. CAD-архивы не изменялись для обхода дефекта; пользовательские файлы и версии не удалялись. + +SHA-256 `orphan-after-model-edit.png`: `47c07c3a99df266aa8c1e12a354f6dccb5c8963172855bb3e61238e891f02c27`. + +## Контрольный путь с явной очисткой — частичный PASS + +Фикстура `Mesora safe UI acceptance 2026-11-13`: + +1. Сначала сохранён чистый цилиндр без графики. Затем через рабочий `Execute('add')` применены два измерения: `m1` hidden, offset 0.2 cm; `m2` visible, offset 0.3 cm. В памяти и storage две строки, одна graphics group. +2. Радиус sketch circle изменён с 1.5 до 2 cm. **Прямо вызван** `UpdateDimensions.notify`. Fingerprint изменился, graphics group перестроилась, измеренная длина актуальной edge составила `12.566370614359172 cm`. Это подтверждает работу обработчика с настоящей геометрией; автоматический event-trigger остаётся PENDING. +3. **Прямо вызван** `DocumentEvent('saving').notify` перед API save. После обработчика groups=0, removed_for_save=True. Save=True, документ чистый. +4. Mesora остановлена, close/reopen без Mesora: groups=0, body=1, документ чистый. Снимок `dist/local-validation/prepared-save-without-mesora.png` просмотрен — остаточных размеров нет. +5. Mesora снова запущена. `current_state` загрузил две строки, hidden_ids=`m1`, offsets=`0.2/0.3`, next_id=3. Ссылка m2 разрешена, актуальная длина `12.566370614359172 cm`; явный Refresh без ошибок создал одну группу. +6. Тестовый документ закрыт; пользовательский документ оставлен открытым. Mesora запущена. Run on Startup ранее был включён, настройку в этом прогоне не меняли. + +Этот путь доказывает сохранение определений и полезность очистки. Он **не закрывает** требования нормального Save/Save As/restart без ручной подготовки и не заменяет S19 FAIL. + +SHA-256 контрольного `prepared-save-without-mesora.png`: `098843b277603d26619d798adfa1661b5a66e4e8ed763b6585408446b3d226fe`. + +## Локальные quality gates первоначального этапа + +На кандидате первоначального этапа (`271d25e`) прошли компиляция, **103 offline tests**, `scripts/check_project.py`, `git diff --check` и CI Linux/macOS/Windows. Проверена детерминированная сборка 54 файлов с новыми модулями и четырьмя иконками; UUID сохранён. Локальный ZIP `dist/stability-validation/Mesora-0.0.0.zip` имеет SHA-256 `fcf1dce909048810f39033c400e67d46351eee138d083e3099a30afe49214381`. `0.0.0` — только числовая заглушка для проверки упаковки, не назначенная версия релиза. Штатную версию определяет GitVersion 6.8.2. Этот ZIP не публиковать как stable. + +## Продолжение: проверка способа запуска и автоматическое восстановление + +Пользователь уточнил контракт: **без Mesora размеры не показываются вообще**. В документе сохраняются только определения; отображение создаёт запущенная Mesora. Геометрия должна оставаться доступна без аддина. + +При продолжении CUA явно сообщил, что Mac заблокирован и автоматическая разблокировка не удалась. Запрошена ручная разблокировка. Это ограничивает предыдущие попытки UI: они не подтверждают ни открытие команды, ни штатные события сохранения. До повторного прогона точная причина отсутствия предсохранительной очистки остаётся открытой; нельзя приписывать её только Autodesk или только Mesora. + +Выполнен штатный перезапуск через `Application.scripts.itemByPath(...).stop()` и, отдельным вызовом, `Script.run(False)`, без ручного `exec` entrypoint. Подтверждены `isRunning=True`, `isRunOnStartup=True`, один загруженный entrypoint и 14 обработчиков до новых изменений. Независимый custom-event probe пока не подтвердил доставку callback. Такой probe не является проверкой Save и не закрывает событийну́ю приёмку. + +Добавлен отдельный development observer `scripts/native_acceptance_observer.py`. Он регистрирует реальные document/command events и собственный custom event, пишет JSONL с порядком, активной командой/средой, состоянием tracked graphics и SHA-256 definitions. Он не вызывает продуктовые обработчики и не меняет CAD. Пользовательские документы исключены из инспекции, tokens/payload не записываются. Наблюдатель не входит в ZIP. + +В коде кандидата добавлена загрузка definitions по владельцу документа при `documentOpened` и запуске аддина. Отрисовка запрашивается отложенно и блокируется Drawing/native-командой. Активация документа возвращает только уже существующий запрос восстановления; Save сбрасывает его, чтобы queued startup/open не перезапустил source-save loop. Ошибка schema одного документа не блокирует загрузку остальных. Автономно прошли **113 тестов**, включая 10 новых регрессий; нативная доставка и отображение этого этапа пока PENDING до разблокировки Mac. + +## Необходимая повторная проверка + +Продолжить проверку через штатный Script Manager, с независимо подтверждённой доставкой событий. Отдельно повторить API Save/Save As, чтобы отличить ограничение прежней ручной перезагрузки Python от продуктовой ошибки. Штатный GUI Save и отсутствие размеров без аддина в последнем прогоне проходят; это не закрывает все save/recovery пути. `isModified` не подделывать, вымышленные transient-флаги не вводить. Принять model edits, Undo/Redo, Drawing, несколько документов, restart и установку финального ZIP отдельно на macOS и Windows. + +## Актуальный прогон после разблокировки: штатный lifecycle + +Источник: `f090654`, Fusion 2706.1.17. Основной агент выполнил GUI-действия; продуктовые `notify` напрямую не вызывались. + +### S09 / S10 / S19: сохранение и работа без аддина + +- Штатные `Script.stop()` и `Script.run(False)` выполнены отдельными вызовами. При открытии `Mesora safe UI acceptance 2026-11-13 v2` Mesora автоматически загрузила две записи, скрытый m1, offsets 0.2/0.3 cm, и создала одну группу m2. +- Настоящие Cmd+S и OK в Save дали ровно v3: документ чистый, groups=0, removed_for_save=True, restore_requested=False. Постсохранительного пересоздания не было. +- После остановки аддина и close/reopen v3: isRunning=False, body=1, groups=0, документ чистый. Снимок `dist/local-validation/unlocked-ui-save-no-addon.png` просмотрен: размеров нет. SHA-256 `098843b277603d26619d798adfa1661b5a66e4e8ed763b6585408446b3d226fe`. +- С остановленным аддином radius изменён с 2 до 2.3 cm. Настоящий GUI Save дал v4; close/reopen без аддина сохранил radius=2.3, body=1, groups=0, чистый документ. Снимок `dist/local-validation/unlocked-no-addon-edited.png` просмотрен: размеров нет. SHA-256 `fac1e56fbaae1a61825fbf55faba0783219a10eeeed282daa5cf3b826e58cdf4`. +- Запуск Mesora восстановил две записи, одну группу, hidden_ids=m1, прежние offsets. Ссылка разрешилась по новой геометрии: длина `14.451326206513047 cm`, на экране `144.5 mm`. + +Таким образом, **S19 macOS PASS для проверенного GUI-пути**, включая изменение и сохранение без аддина и последующее восстановление. Это не полный Fusion restart и не Windows-проверка. + +### S12 / S13: Save As и отмена + +Отмена GUI Save As сохранила две записи, одну группу и hidden_ids=m1. Настоящий Save As создал `Mesora Save As acceptance 2026-11-13 v1`: документ чистый, groups=0, removed_for_save=True, две сохранённые записи. Независимость дальнейших изменений копии и reopen копии без аддина требуют завершения. + +Для создания копии исчерпан лимит editable документов: **только ранее созданная нами** фикстура `Mesora stable acceptance 2026-11-13` переведена в Read-Only штатным UI. Пользовательские документы не переводились в другой режим и не удалялись. + +### Независимое подтверждение событий + +Observer, импортированный напрямую через MCP, не получал callback и непригоден как доказательство. Генератор `scripts/prepare_native_observer.py` создаёт отдельный development add-in в `dist/native-acceptance/MesoraAcceptanceObserver`; он запущен штатным менеджером, startup=False. В его `events.jsonl` подтверждены: + +```text +4 customEvent.callback +14 commandStarting PLM360SaveAsCommand groups=1 +20 commandStarting PLM360SaveCommand groups=1 +22 documentSaving groups=0 removed_for_save=True +23 documentSaved groups=0 removed_for_save=True +24 commandTerminated PLM360SaveCommand groups=0 +``` + +Definitions SHA-256 в сохранении не изменился. Это реальная доставка событий и очистка перед сохранением; отсутствие callback в прежнем MCP-observer не доказывало отсутствия продуктового события. + +### S04 / S05 / S07: применение глазиков и Undo/Redo + +На копии настоящий Mesora-диалог показал m1 Radius=23.0 mm hidden/offset=2 mm и m2 Edge Length=144.5 mm visible/offset=3 mm. Общий глазик выключил preview (0 групп), повторное включение сохранило скрытие m1. Глазик m2 скрывал строку без удаления: обе строки остались. OK записал hidden_ids=m1,m2 в память и attributes, groups=0. GUI Undo восстановил hidden_ids=m1, GUI Redo снова дал hidden_ids=m1,m2. Состояние editor_open=False после применения. **Это PASS метаданных, но не графики Undo:** первоначальная оценка только по `len(state.groups)` была недостаточной и отозвана. + +Последующее чтение того же managed trace обнаружило D06: + +```text +29–31 после Commit: tracked=0 actual groups=0 +34–37 во время/после Undo: tracked=0 actual groups=1 +38–39 перед Redo (после refresh): tracked=1 actual groups=2 +40–43 во время/после Redo: tracked=1 actual groups=0 +46–49 следующий Undo: tracked=0 actual groups=1 +``` + +Fusion самостоятельно восстановила удалённую графику Undo-транзакцией. Прежний refresh создавал ещё одну группу, поскольку не знал о восстановленном API-объекте. **S07 graphics FAIL, D06 Major**, блокирует stable. Прежний PASS на основании tracked-state не переносится. + +Исправление кандидата: каждая новая группа получает `CustomGraphicsGroup.id` со стабильным UUID-префиксом Mesora и уникальным suffix. `renderer.owned_groups/erase_owned` перечисляют реальные root groups и удаляют только помеченные Mesora-группы, включая восстановленные wrappers; чужие и старые группы без метки не присваиваются. `State.erase(keep=staged)` сохраняет новые staged-группы до commit и проверяет реальную коллекцию при refresh/save/stop, даже если tracked-state пуст. Ошибка удаления сохраняет ссылки и отменяет Save. Writable string `id` подтверждён [официальной документацией](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/fusion_CustomGraphicsGroup_id.htm). + +После интеграции **119 offline tests PASS**, включая воспроизведение нового wrapper с сохранённым ownership ID, пустого tracked-state, чужих groups, staged groups и retry после отказа удаления. Нативно ещё требуется подтвердить, что Fusion сохраняет `id` при настоящем Undo, и повторить Undo/Redo→Save→stop→reopen с визуальным снимком. Это исправление не объявлено нативно принятым. + +Позднее этот несохранённый этап копии закрыт через Don't Save; исходная сохранённая копия v1 не переписана этими настройками. Это проверка транзакций текущей сессии, не сохранённой изоляции двух файлов. + +### Незавершённое параметрическое изменение и внешний сбой + +На повторно открытой синтетической копии добавлен radial constraint d3=23 mm. Открыт нативный Change Parameters, раскрыт Sketch1. Изменение значения не завершено: после клавиатурного перехода и чтения AX-дерева CUA вернул noWindowsAvailable/timeoutReached, MCP перестал отвечать. Снятый без завершения процесса sample показывает основной поток в цепочке AX hierarchy → QMacAccessibilityElement.accessibilitySelectedChildren → обработчик сигнала libcer → read. Python/Mesora-фреймов на этом стеке нет; причинность за пределами этих наблюдений не установлена. + +Нативный S06 **INCONCLUSIVE**, не PASS. Процесс не завершался принудительно, поскольку открыт несохранённый пользовательский документ. Запрошена ручная проверка Fusion. См. [наблюдатель и восстановление](observer-and-ax-recovery-2026-11-13.ru.md). До восстановления отзывчивости невозможно штатно остановить managed observer; его логи находятся только в ignored dist и не входят в продуктовый ZIP. + +Предыдущий Drawing/visibility прогон находится в [отдельном отчёте](drawing-visibility-2026-11-13.ru.md). Его PASS не переносится автоматически на текущие persistence/update изменения. Полная [матрица CJM](stable-release-cjm-2026-11-13.ru.md) сохраняет PENDING и FAIL. + +## API-основания + +- [DocumentEventArgs](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_DocumentEventArgs.htm): установленный API имеет `isOperationCancelled` и `cancelReason`; `isSaveCanceled` отсутствует. Исправлен используемый символ. Реальная отмена сохранения при fault-injection ещё не принята. +- [Custom event queue](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Application_fireCustomEvent.htm): работа выполняется в основном потоке при idle; перед refresh дополнительно исключается активная native-команда. +- [CustomGraphics persistence report](https://forums.autodesk.com/t5/fusion-support-forum/bug-report-custom-graphics-serialized-into-a-document-are/td-p/14142906): внешнее описание похожего дефекта; решение о блокировке основано на нашем воспроизведении выше. + +Релиз не опубликован; сообщение пользователю Telegram о готовом релизе не отправляется до успешного выпуска. + +## Итог повторной приёмки fe68881 + +### Ownership и Undo/Redo + +В Fusion подтверждено сохранение ownership `CustomGraphicsGroup.id` при настоящем Undo. Дополнительная регрессия неизменных definitions/fingerprint потребовала сверять реальные owned IDs с валидными tracked wrappers; исправление вошло в `fe68881`. No-op OK → UI Undo/Redo сохраняет tracked=valid=actual=owned=1. Скрытие второй строки даёт 0/0; Undo возвращает 1/1, Redo — 0/0, повторный Undo — 1/1. GUI Save копии v1→v2, managed stop, close/reopen без аддина: clean, actual=0, визуально нет размеров (`ownership-undo-save-no-addon.png`). **D06 RETEST PASS в этом macOS scope.** + +### Параметрическое изменение + +После сбоя Parameters Fusion показала Crash Reporter. Он закрыт без отправки отчёта; процесс завершился самостоятельно. После запуска recovery list закрыт без открытия или удаления файлов. Это не доказательство восстановления пользовательского документа. Qt Accessibility stack не устанавливает причину сбоя Mesora. + +Вместо повторного чтения проблемной AX-таблицы использован отдельный managed development command `FourFusionLabAcceptanceRadius`: меняет только d3 в указанной синтетической копии, в собственной Fusion-транзакции; не вызывает Mesora handlers. Радиус 23→27 mm автоматически изменил label 144.5→169.6 mm без Refresh. Фактическая длина 16.964600329384883 cm, fingerprint актуален, tracked=valid=actual=owned=1. GUI Edit → Undo Multiple → Undo Acceptance Radius вернул 144.5 mm; GUI Redo без промежуточных MCP-вызовов вернул 169.6 mm. Оба состояния проверены визуально. Это native SDK-command acceptance; ручное редактирование в Parameters остаётся INCONCLUSIVE. + +### Drawing + +`NewFusionDrawingDocumentCommand` запущена при видимой графике. В managed observer session `622f1b9a-2259-4479-a9d5-9dc7fb1b7e2b`: saving108 видит group1, saved109 — group0, clean. Source копия v2→v3 ровно один раз. Открыт `FusionDocumentationEnvironment` с настоящим листом и Drawing View. Размещение base view отменено, несохранённый тестовый Drawing закрыт через Don't Save. Возврат в source: v3, isModified=False, tracked=actual=0, radius2.7 cm. Сценарий создания листа и source-save loop принят; размещение/оформление видов не заявляется. + +### Штатный полный restart и работа без Mesora + +Оба development add-ins остановлены. Единственная открытая модель — синтетическая чистая копия v3. Выполнен Cmd+Q; отсутствие процесса Fusion подтверждено до нового запуска. Обычный launch прошёл через Preparing your experience в Home, без Crash Reporter. Открытие копии v3 при автоматически запущенной Mesora: isRunning=True, isRunOnStartup=True, 2 definitions, hidden m1, tracked=actual=1, radius2.7 cm; визуально label169.6 mm. + +Затем Mesora остановлена, копия закрыта через Don't Save (отбрасывается только отрисованная сессионная графика), v3 открыта вновь: isModified=False, actual=0, radius2.7 cm, Mesora isRunning=False. Визуально размеров нет. Исходный файл v4 и копия v3 затем открыты одновременно без аддина: исходник radius2.3 cm, копия radius2.7 cm, оба clean и actual0. Подтверждена независимость геометрии Save As; отдельный цикл редактирования definitions в копии не заявляется. В конце штатный запуск Mesora восстановлен; Run on Startup сохранён. + +### Проверки и оставшиеся gates + +Повторно **122 offline tests PASS**, project validator PASS. CI для runtime `fe68881`: [run12 success](https://github.com/4FusionLab/Mesora/actions/runs/43462948414), Linux/macOS/Windows — код и ZIP, не Fusion. + +Финальная локальная проверочная сборка: `Mesora-0.0.0.zip`, SHA-256 `157c00aa5726d097d837c17b635cdfaf81e316241158bc63bfbc7130ed4f19c0`. Числовая заглушка 0.0.0 не является версией для публикации. Development observer/driver не входят в ZIP. + +Пользователь подтвердил отсутствие доступной Windows с Fusion и уточнил publication scope: успешные обязательные gates macOS достаточны для выпуска и снятия experimental. Windows остаётся отдельно UNVERIFIED и сама по себе не блокирует выпуск. PR остаётся draft, main не изменяется, релиз и Telegram-анонс не выполнены. + +## Уточнения пользователя и текущий открытый дефект + +После указания не сохранять тестовые файлы все дальнейшие сохранения CAD/экспорты тестовых моделей остановлены. Запрос перевода тестового файла в Read-Only отменён. По явному запросу пользователя root закрыл без сохранения два открытых saved fixtures и удалил четыре ранее созданных синтетических облачных файла: Mesora safe UI acceptance 2026-11-13, Mesora stable acceptance 2026-11-13, Mesora Save As acceptance 2026-11-13 и Mesora visibility acceptance. `DataFile.deleteMe()` вернул True для каждого; повторный поиск Mesora в `_Preferences` вернул 0. Пользовательские модели не затронуты. Открыт один несохранённый synthetic all-types fixture для визуального исправления. + +На нём управляемый независимый SDK harness подтвердил все семь численных типов и roundtrip settings в attributes, real deleted reference retention и отказ перезаписывать corrupt/future schema. Настоящая Mesora GUI показала восемь строк (семь типов плюс недоступная ссылка), Enter сохранил восемь definitions в несохранённой модели. Изменение типа edge_length→radius показало 27.0 mm; Escape отменил эту правку и изменение глазика. GUI очистка недоступной геометрии и удаление только этой строки оставили все семь остальных типов. Это не приёмка создания каждого типа мышью и не файловый roundtrip. + +Обнаружено неограниченное удержание command handlers. Исправление `6a0663e` освобождает command scopes при destroy. **128 offline tests PASS**. Нативно: Add open appHANDLERS16/scopes1/bindings5, Escape appHANDLERS16/scopes0/editorFalse; второй Add с изменением глазика и OK оставил appHANDLERS16/scopes0 и valid=tracked=actual=6. Прежний pipeline PASS относится к fe68881, не этому новому commit. + +**D07 Major OPEN:** при одновременном отображении шести размеров на текущей геометрии подписи перекрываются и плохо читаются. Это реальный провал визуальной приёмки, независимо от численного PASS. Снимок до исправления: `dist/local-validation/caption-overlap-before.png`. Исправление совместного размещения подписей и повторная визуальная проверка в работе. Experimental пока не снимается. + +## Исправление наложений и окончательное решение для orbit + +Первая версия совместного размещения устранила статические наложения, но пользователь подтвердил скачки при вращении. Предпочтение предыдущей позиции на `8129f2f` дало нулевое смещение на отдельных 2°/14° samples, однако обычное пользовательское вращение всё ещё прыгало. Эти samples не закрывали дефект. + +В `a77502e` CameraChanged **только ориентирует текст**: размещение подписей не пересчитывается вообще, геометрия угловой дуги заморожена после рендера. Раскладка выполняется при явном добавлении/изменении набора, Refresh и восстановлении набора. Удалён промежуточный перенос текста к base и обратно. В почти реберном ракурсе первоначальное размещение использует устойчивую видимую ось; Retina-проекция нормализуется. + +После managed reload проверено фактически загруженное code object: cameraRepack=False, angleRebuild=False. Настоящие изменения Camera на 45°, 90° и возврат 0° дали на каждом шаге WORLD anchorDeltas=[0,0,0,0,0,0], неизменный массив координат дуги, tracked=actual=6. Пользователь повторил обычное вращение и сообщил: **«Теперь не скачут»**. D07 закрыт для воспроизведённого macOS набора; это не гарантия отсутствия любых проекционных перекрытий на произвольном реберном ракурсе. + +**144 offline tests PASS**, compilation/validator/diff check PASS. [CI run15 success](https://github.com/4FusionLab/Mesora/actions/runs/43475119273) относится к `a77502e`, не переносится с прежнего commit. + +## Установка ZIP и заключительный несохранённый полигон + +Проверочный ZIP из `a77502e`: 56 файлов, stable UUID сохранён, `label_layout.py` и `event_scope.py` внутри, helper-аддины отсутствуют. Placeholder version 0.0.0 не для публикации. SHA-256 `eb0395fd9b876def94d91599e8bd20105010e80398342b14135c80da29e6bc65`. + +ZIP распакован и реально подключён через managed Scripts API. Подтверждены модуль из распакованной папки, 16 app handlers, command scopes0, 5 definitions, 7 measurement definitions, tracked=valid=actual=6, orbit reflow отсутствует, angle rebuild отсутствует. После испытаний пакет остановлен и отвязан; штатная рабочая папка Mesora снова подключена, isRunning=True, Run on Startup=True. + +В отдельном временном **несохранённом** документе повторно прошёл seven-type SDK suite. Затем выполнен native assembly-context suite: parent и child имеют по Rz90 и ненулевые translations. Три мировые точки совпали с независимым расчётом: (8,21,30), (5,21,35), (2,17,35). Семь измерений root/top/nested и circle radius/diameter/length совпали с аналитикой; явное форматирование дало 27.0 mm и 1.0 in. После перемещения parent по X на 1 cm расстояние root→nested стало sqrt(1702)=41.255302689472536 cm. Это приёмка reference resolution/measure после движения, не отдельный end-to-end auto-update аннотации сборки. Исходные definitions context suite не менял; его графика очищена. + +Проверка реального выбора: public selection setters сами не доставили picker inputChanged, поэтому их success не использован как доказательство пользовательского выбора. Пользователь кликнул грани; независимый managed observer получил **четыре настоящих picker inputChanged**: area с одной BRepFace → distance с двумя → area → distance. Esc отменил draft, editor=False/scopes0, исходные 8 definitions временного документа сохранены. Никаких искусственных событий или ручных вызовов product handlers. + +Временный документ закрыт через close(False), оба helpers остановлены/отвязаны. Возврат в исходный несохранённый документ: ровно 7 типов m1…m7, hidden m4, прежние offsets 0…0.3 cm, global=True, tracked=actual=6, handlers16/scopes0. Изоляция A→B→A подтверждена. Никаких новых облачных сохранений или CAD-экспортов не выполнялось. + +По прямому поручению пользователя организовано последовательное владение общей Fusion-сессией с Planara через общий журнал FUSION_SESSION.md; передача только после явного подтверждения, не по таймауту. Оставшаяся проверка UI-переходов типов подготовлена локально, до возврата слота Fusion не вызывается. + +## Заключительный пакет UI-типов и native Measure + +После явного возврата слота Planara root сверил SelectCommand, creationId `2835aa87-f636-4741-a54f-a6476e579ba2`, один исходный несохранённый документ и startup=True. Managed TypeProbe выполнил 13 переключений публичных dropdown inputs: получены 13 **настоящих kind inputChanged**, совпали draft kind, выбранный пункт и значения по аналитике. Все исходные типы восстановлены, definitions неизменны. Это нативные UI-события, не заявление о физическом нажатии мышью на каждый тип. + +Для цилиндрической боковой грани r=27 mm/h=30 mm проверено: edges2, loops2, coEdges1+1; сумма длин edges, coEdges и результат адаптера одинаковы — 33.929200658769766 cm. Нативная команда **MeasureCommand** с той же выбранной гранью показала **Loop Length 339.292 mm**, Area5089.38 mm², Radius27 mm и Diameter54 mm. Root просмотрел настоящий Measure palette screenshot. Таким образом, предварительная неоднозначность учёта шва для этой фикстуры снята — seam edge в её loops нет. + +Measure закрыт, selection очищен; TypeProbe остановлен/отвязан. Финальный checkpoint: SelectCommand, одна исходная несохранённая модель, editor=False/scopes0, 7 definitions/6 groups, Run on Startup=True. После этого слот явно предложен Planara и принят её координатором; никакие Fusion вызовы со стороны Mesora до нового согласования не выполняются. QA-helper RuEnProbe существовал отдельно и не изменялся. + +## Preflight стабильного пакета 1.1.0 + +GitVersion 6.8.2 в PR CI определил MajorMinorPatch=1.1.0. После снятия текущего experimental-обозначения прошли 144 tests, validator, compileall и diff check; RU README alias совпадает. Две независимые сборки `Mesora-1.1.0.zip` побайтно одинаковы, SHA-256 `4790d87dbfad91834c9ba3863943a9e23974130cd58c3f87dc38418ed9938c2b`. Сравнение с нативно установленным проверочным ZIP подтвердило одинаковые 56 файлов и идентичный runtime: отличаются только первая строка docstring Mesora.py и description/version манифеста. Stable UUID и прочие поля манифеста сохранены. Финальная публикация и проверка скачанных assets выполняются штатным pipeline, без ручных tags. diff --git a/docs/validation/stable-release-cjm-2026-11-13.ru.md b/docs/validation/stable-release-cjm-2026-11-13.ru.md new file mode 100644 index 0000000..0f0505e --- /dev/null +++ b/docs/validation/stable-release-cjm-2026-11-13.ru.md @@ -0,0 +1,322 @@ +# Mesora: CJM и приёмка стабильного релиза + +> **Актуальный итог: macOS-приёмка ПРИНЯТА; нативных блокирующих gates не осталось в авторизованном scope.** Root принял независимый verdict; условие пользователя для снятия experimental выполнено. Техническая публикация ещё ожидается: финальная EN/RU документация/metadata, зелёная CI публикуемого commit, штатный GitVersion ZIP/checksum/notes и immutable Release. Новых Fusion API/UI или CAD-save действий не требуется и не выполняется. Исторические OPEN/FAIL ниже показывают развитие и не отменяют заключение последнего раздела; подробные границы покрытия сохранены. + + +Дата: 13.11.2026. Рабочий документ приёмки; не свидетельство завершённой CAD-проверки. + +## Продуктовая цель + +Конструктор один раз создаёт информационные размеры и использует их при изменении, сохранении и передаче модели в Drawing. По уточнению пользователя графика существует только при работающей Mesora; в проекте сохраняются определения измерений и настройки, а не отображаемые аннотации. Он может убрать визуальный шум без потери измерений и вернуться к работе после закрытия Fusion. Размеры соответствуют актуальной геометрии; недоступная ссылка явно обозначена, старое число не выдаётся за актуальное. Mesora не создаёт повторные сохранения и не оставляет неуправляемую графику в файле. + +## CJM + +| Этап | Намерение и действие | Ожидаемый результат | Риск / момент доверия | +| --- | --- | --- | --- | +| Установка | Распаковать ZIP, подключить аддин, включить Run on Startup | Одна команда Mesora в поддерживаемых средах, запуск после перезапуска | Версия пакета совпадает с релизом, стабильный UUID | +| Первое измерение | Открыть модель, выбрать геометрию, выбрать тип | Понятный preview и значение в единицах документа | Неподдерживаемый выбор не меняет модель | +| Набор | Добавить несколько строк, заменить выбор, настроить положение | Независимые строки и предсказуемый OK/Cancel | Preview не становится постоянным после Cancel | +| Фокус | Скрыть строку, затем скрыть весь набор | Определения остаются; общий показ учитывает личные глазики | Пользователь не вынужден удалять измерения | +| Изменение | Изменить параметр, переместить компонент, Undo/Redo | Числа и геометрия аннотаций обновляются | Старая геометрия не выглядит актуальной | +| Сохранение | Save / Save As, закрыть и открыть модель | Определения и настройки восстановлены; файл сохраняется штатно | Нет потерь и orphan graphics | +| Чертёж | Создать Drawing с видимыми размерами | Одно штатное сохранение исходника, Drawing открывается | Нет дрожания звёздочки и save loop | +| Продолжение | Перезапустить Fusion, открыть файл | Сохранённый набор доступен и разрешён по текущим tokens | Отсутствующая ссылка не ломает весь набор | +| Завершение | Отключить аддин | UI/handlers удалены; графика исчезла, модель доступна | Нет неуправляемой графики после reopen | + +## Правила доказательств + +Нативные проверки выполняются одним владельцем Fusion на отдельных синтетических документах. Пользовательские модели не используются. Для каждого прогона фиксировать ревизию исходников, версию Fusion и ОС, имя фикстуры, операции, значения до/после, фактический результат и ссылку на снимок/лог. Повторная проверка после исправления относится к новой ревизии; старый PASS не переносится автоматически. `customGraphicsGroups.count == 0` не доказывает отсутствие видимых orphan graphics: требуются снимки после reopen/restart с отключённым Mesora. + +Обозначения: **AUTO PASS (baseline)** — воспроизведено офлайн в начале этой работы; **переданный macOS PASS** — доказательства предыдущего прогона в [отчёте Drawing](drawing-visibility-2026-11-13.ru.md), не новая приёмка; **PENDING** — необходим реальный прогон. Windows Fusion оценивается отдельно от Windows CI. + +## Трассировка сценариев + +| ID | Сценарий и критерий приёмки | Автоматическая проверка / доказательство baseline | Нативная проверка и текущий статус | Дефект / повторная проверка | +| --- | --- | --- | --- | --- | +| S01 | Установка/старт/стоп дважды без дублей UI и handlers; Run on Startup | package/validator/offline проверки отдельно | **macOS PARTIAL (root)**: извлечённый ZIP fe68881 с placeholder0.0.0 зарегистрирован, stop удалил commands, run дал16 handlers без дублей. На6a0663e: dialog scope5bindings при16 apphandlers; Escape→16/0/editorFalse; повторный Add+OK→16/0. Финальный назначенный GitVersion ZIP/install/CI ещё PENDING | Placeholder ZIP не опубликованная версия; окончательная упаковка нужна после последнего runtime | +| S02 | Все7 видов корректно измеряются; UI позволяет выбрать соответствующий kind | Native analytic7suite PASS; current144tests PASS; CI15PASS | **macOS authorized pipeline PASS**:4 genuine user picker changes покрыли1/2Face selection;13 genuine kind inputChanged TypeProbe совпали с analytic formatted values, вернули исходные7 types без изменения definitions. Настоящий Fusion Measure той же cylindricalface подтвердил perimeter339.292mm/area5089.38mm²/R27/D54 | Не заявлен отдельный physical mouse-pick каждого вида; общий picker+native7+actual13UIbranches составляют evidence pipeline | +| S03 | Некорректный/неполный/duplicate выбор не применяется; Cancel не меняет committed | Meaningful batch/table/duplicate/validation regressions PASS | **macOS accepted scoped evidence**: настоящие1/2Face picker changes,13kindUIbranches, UIEnter retained8, type/eye edits+Escape preserved definitions, broken-row clear/remove left7. Invalid/incomplete/duplicate guard cases доказаны offline, не объявляются отдельно native | Дополняющие native/offline проверки покрывают текущий pipeline без искусственного повторения каждой комбинации | +| S04 | Глазик строки сразу скрывает/показывает без удаления, OK сохраняет настройку | `test_visibility_lifecycle`, `test_batch_apply`: PASS | **macOS GUI PASS для текущей сессии (root f090654)**: глазики и OK применили hidden m1,m2, groups=0; reopening stored state покрыт S19 на m1. Windows PENDING | Скрытая строка остаётся в таблице | +| S05 | Общий глазик скрывает весь набор и возвращает только индивидуально видимые | Те же тесты: PASS | **macOS GUI PASS для текущей сессии (root f090654)**: global off→0 preview, on сохраняет hidden m1; row m2 hide→0; OK сохранил обе скрытые. Windows PENDING | Проверить в том числе все строки individually hidden | +| S06 | Изменить радиус/высоту/длину: число, выносные и положение обновляются автоматически | Geometry/fingerprint/lifecycle regressions покрывают автоматическое обновление | **macOS PARTIAL PASS (root fe68881)**: штатная SDK-команда FourFusionLabAcceptanceRadius в собственной транзакции изменила d3 23→27 mm; без вызовов Mesora handlers авто-label144.5→169.6 mm. Настоящий GUI Undo Acceptance Radius→144.5 и GUI Redo без MCP между ними→169.6; при27 mm tracked/valid/actual/owned=1. Windows PENDING | Это native command lifecycle, а не завершённый manual Change Parameters: тот Qt AX прогон остаётся INCONCLUSIVE | +| S07 | Undo/Redo изменения геометрии и Mesora возвращает согласованные определения и аннотации | Lifecycle regressions включают same-definition Undo wrapper и empty-definition ownership, очистку чужой графики не выполняют | **macOS fixture RETEST PASS (root fe68881)**: no-op OK→UI Undo/Redo tracked=valid=actual=owned=1; commit hidden обоих→0/0, Undo→1/1, Redo→0/0, Undo→1/1; затем GUI Save→reopen без аддина визуально 0. Дополнительно геометрический GUI Undo/Redo Acceptance Radius принят на этой фикстуре (S06); remove/остальные geometry Undo и Windows PENDING | D06 закрыт для проверенной macOS фикстуры; прежний FAIL сохранён в истории ниже, не все Undo-сценарии приняты | +| S08 | Удалённая/подавленная/неоднозначная ссылка явно недоступна; остальные строки редактируются | resolver и broken-row offline PASS | **macOS PARTIAL PASS (root)**: SDK fixture удалил extra SketchCircle; строка8 retained refs; настоящая Mesora UI показала missing label и7 здоровых; Enter сохранил8; clear_m8+remove toolbar+Return оставил7 без потери других. Repair новым picking/подавление/ambiguous native не заявлены | D03 основной broken-row доступ/retention/explicit removal принят; остаток repair/поддерживаемого выбора требует результата | +| S09 | Save с видимой графикой завершается один раз; нет постоянной звёздочки | `test_drawing_save_stays_clean_without_recreating_graphics`: PASS | **macOS GUI Save PASS (root, f090654)**: Cmd+S и OK штатного диалога, v2→v3 один раз, clean=True, groups=0, removed_for_save=True, restore_requested=False; Windows PENDING | D01/D04; считать версии и modified flag, не менять isModified | +| S10 | Save→close→reopen сохраняет 7 типов, offsets, row/global visibility; значения пересчитаны | Native adapter attribute save/load7 root PASS, offsets0..0.3cm, hiddenm1,m4, globalFalse; offline schema/runtime round trips PASS | **macOS PARTIAL**: прежний сохранённый2-def fixture roundtrip принят. Новый7-type fixture не сохраняется по последующему прямому запрету пользователя. Save→reopen7 НЕ проверен и исключён из дальнейшего исполнения до нового указания; прежние2-def file proofs сохраняются. Сохранение7 в attributes проверено отдельно | Attribute save/load в открытом документе НЕ равен model save/close/reopen7 | +| S11 | Полный restart Fusion восстанавливает определения и не оставляет orphan graphics | Offline не доказывает | **macOS graceful fixture PASS (root fe68881)**: Cmd+Q завершил процесс; launch Home, Mesora startup/runningTrue; opencopyv3 авто2defs hiddenm1 tracked/actual1 label169.6 mm (снимок); stop→close Don't Save→reopenv3 clean actual0 и снимок БЕЗ labels. Windows PENDING, доступа нет, подтверждено пользователем | Принят штатный полный цикл для этой macOS фикстуры; отдельные platform gates сохраняются | +| S12 | Save As создаёт независимую копию набора; изменения копии не меняют исходник | Document isolation persistence offline PASS | **macOS PARTIAL PASS (root fe68881)**: после GUI Save As исходникv4 radius2.3 cm и copyv3 radius2.7 cm открыты одновременно без аддина: оба clean/graphics0, геометрия независима. Предыдущий Save As observer trace сохранён. Windows PENDING | Независимость последующего редактирования definitions между файлами отдельно заново не проверена; полного S12 PASS нет | +| S13 | Cancel/failed Save не теряет определения, не зависает, позволяет retry и продолжение | Нет native fault evidence | **macOS PARTIAL (root f090654)**: настоящий UI Cancel Save As сохранил 2 definitions, 1 group, hidden m1. Реальный failed-save/retry и Windows PENDING | D04; documentSaved может не прийти, нельзя зависеть только от него | +| S14 | Drawing с показанными размерами создаётся; source clean; возврат в модель предсказуем | camera/workspace/save regressions PASS | **macOS latest fixture PASS (root fe68881)**: до NewFusionDrawingDocumentCommand visiblegroup1; observer108Saving group1→109Saved group0 clean; sourcecopyv2→v3 ОДНА версия, Drawing workspace открылся. Base view Cancel, Drawing закрыт Don't Save; source clean tracked/actual0. Windows PENDING | Старое доказательство v162→163 заменено актуальным на persistence/auto-update реализации | +| S15 | Два документа не смешивают definitions/visibility; закрытие не держит stale state | Persistence isolation offline PASS | **macOS A→B→A PASS (root a77502e)**: несохранённыйB с SDK7suite и context suite, затем close(False); исходныйA сохранил7 kinds m1..m7, hiddenm4, offsets0..0.3, globalTrue и6 групп. Helpers остановлены/отвязаны | Drawing routing опирается на предыдущий принятый S14; новых CAD-save нет | +| S16 | Transformed/nested occurrences, orbit, zoom, units дают корректные числа/позиции | Geometry context/renderer offline PASS | **macOS native adapter context PARTIAL PASS (root a77502e)**:7 независимых analytic context tests; top(8,21,30), nested(5,21,35), parentX+1 дал distance√1702=41.255302689472536 черезmeasure/refresolver. Render auto-update этого assembly-пути не заявлен. Normal orbit D07 user PASS | Отдельно native Inspect perimeter cylindricalface может требовать разрешить неоднозначный oracle; units evidence по исходным сценариям | +| S17 | Повреждённый/будущий schema не перезаписывается; ошибка понятна, остальные документы работают | schema/runtime persistence tests PASS | **macOS PARTIAL PASS (root)**: managed all-types native suite проверил corrupt/future payload и отказ overwrite; cleanup0 и suite.pass. Полный UI сценарий отдельного повреждённого saved doc не заявлен | Нативная проверка адаптера подтверждена, не выдумывать UI error acceptance | +| S19 | Использовать проект без установленной/запущенной Mesora: аннотаций Mesora НЕТ, геометрия доступна для edit/save, definitions сохранены; после подключения Mesora набор автоматически восстановлен и отрисован по актуальной геометрии | Offline persistence покрывает независимые определения, но не сериализацию CAD | **macOS GUI fixture PASS (root, f090654)**: без аддина radius 2→2.3 cm, GUI Save v3→v4; close/reopen clean, groups0 и визуально НЕТ размеров (`unlocked-no-addon-edited.png`, просмотрен root). Managed start автоматически восстановил 2 definitions, 1 group, hidden m1, offsets .2/.3; length=14.451326206513047 cm, label144.5 mm. Windows PENDING | Не включает полный restart Fusion (S11), Save As copy isolation (S12) и авто-update при edit с аддином (S06) | +| S18 | Финальный release ZIP устанавливается, версия/notes/checksum совпадают, CI зелёный | `test_reproducible_zip_and_checksum`: PASS baseline | Финальный ZIP и GitHub Release PENDING | GitVersion 6.8.2; штатный immutable publish после gates | + +## Дефекты исходного состояния и повторная проверка + +| ID | Приоритет | Наблюдение и доказательство | Критерий закрытия | Статус | +| --- | --- | --- | --- | --- | +| D01 | Blocker | `State` создаёт пустые items и не вызывает persistence; definitions исчезают при завершении сессии. `model.py` schema v1 не покрывает angle/area/perimeter и runtime IDs mN | Runtime round trip всех типов, visibility/offset; native S10–S12/S17 | CLOSED в текущем разрешённом scope: runtime persistence7types/settings + native attribute roundtrip7 и исторический model roundtrip2; новый CAD-save7 запрещён пользователем, не PASS и не blocker | +| D02 | Blocker | Подписки baseline не запускают пересчёт при изменении геометрии; camera handler только ориентирует text | S06/S07 автоматически обновляют актуальную геометрию без ручного Refresh | CLOSED для проверенного native command path:23→27mm auto-update и GUIUndo/Redo; manual Parameters AX path остаётся INCONCLUSIVE без установленной связи с Mesora | +| D03 | Major | `BatchCommand.prefill` разрешает каждую ссылку без обработки ошибки строки: одна плохая ссылка прерывает заполнение/открытие командного диалога | S08: остальные строки доступны, плохую можно удалить/исправить без потери данных | CLOSED scoped: native UI retained missing row/доступ к здоровым/explicit clear-remove + meaningful offline repair-selection/regressions; не заявлены все suppression/ambiguity native варианты | +| D04 | Major | После save `removed_for_save` блокирует graphics до явного действия; при interrupted save нет подтверждённого recovery | S09/S13/S14 без loop, данные доступны после любого исхода save; фактический UX описан | CLOSED для owning defect: реальный Save/Drawing без loop, nativeCancel сохранён, current fault-path regressions PASS. Реальный failed cloud save не выполнялся и дальнейшие CAD-save запрещены; ограничение evidence сохранено | +| D05 | Documentation | Manifest и safety/readme говорят experimental/session-only; safety содержит устаревшие сообщения об отсутствии зарегистрированных команд | Документация соответствует фактически принятым сценариям, EN/RU parity; неподтверждённые платформы явно указаны | PENDING после приёмки | +| D06 | Major, release blocker до retest | S07 trace38–39 f090654: tracked1/actual2; позднее 6f223 подтвердил preserved ownership tag с новым wrapper даже при неизменных attributes/fingerprint | Нет лишних owned групп после no-op/settings Undo/Redo; stop/save/reopen без аддина без аннотаций, foreign preserved | **macOS fixture RETEST PASS fe68881 (root)**: no-op и visibility cycles validtracked=actualowned, save/reopen чисты; Windows и иные геометрические Undo PENDING; геометрический Acceptance Radius Undo/Redo позднее принят (S06) | +| D07 | Major, воспроизведённый macOS дефект закрыт |6 labels перекрывались, затем при orbit наблюдались скачки | Читаемый набор и отсутствие скачков при обычном orbit; совместное размещение при render, camera orientation-only | **RETEST PASS a77502e / macOS 6-label case**: static readability подтверждена root, реальные45°/90°/return0° далиanchor deltas0/arcunchanged/count6; пользователь подтвердил «Теперь не скачут». Иные произвольные ракурсы не превращаются в новый blocker | + +## Воспроизводимые baseline gates + +В этом checkout 13.11.2026 выполнены `python3 -m unittest discover -s tests -v`: **74 tests, OK**; `python3 scripts/check_project.py`: **Validated Mesora; initialized=True**; `git diff --check`: **PASS**. Команда `python` в окружении отсутствует, используется `python3`. Эти результаты относятся к исходному незакоммиченному состоянию передачи и не заменяют повторный прогон финального кода. + +Публикационный gate (уточнён пользователем): все обязательные сценарии приняты на доступной macOS, blocker/major закрыты; отсутствие Windows Fusion само по себе не блокирует выпуск и не требует experimental-маркировки после успешных Mac gates; CI Linux/macOS/Windows зелёный; ZIP/install, embedded version, SHA-256 и release notes проверены; license PolyForm Noncommercial сохранена. Не публиковать доказанный stable при PENDING критических save/reopen/restart/geometry/Drawing проверках. Push в main меняет runtime и запускает релиз; его выполнять после приёмки. + +## Повторная офлайн-проверка после доработок + +13.11.2026 на текущем рабочем коде: **97 tests, OK**. Добавлены проверки сохранения всех типов и настроек runtime schema, invalidation геометрии и placement dependencies, восстановления строки с недоступной ссылкой, отмены save при ошибке cleanup через `isOperationCancelled`, объединения событий, исключения Drawing/редактора и отсутствия перерисовки при неизменившемся snapshot после Save. Undo последней удалённой строки проверен через реальный обработчик событий и `State.load`; Undo создания до пустого набора — через реальный `State.refresh` и удаление graphics group. Это офлайн-объекты событий, а не нативный transaction/event-order gate. + +D01/D02/D03 имеют реализацию и офлайн-регрессии; закрытие для stable требует указанных нативных сценариев на финальном коде. Новый S19 обязателен по прямому уточнению пользователя: проект должен нормально использоваться без Mesora. + +## Историческое наблюдение S19 в раннем harness + +Владелец Fusion (root) 13.11.2026 подтвердил: использование геометрии без Mesora возможно, но старые аннотации остаются видимыми после редактирования и повторного открытия. При радиусе 2.5 cm окружность должна иметь длину около 157.1 mm; виден старый label 125.7 mm. При этом `customGraphicsGroups.count == 0`, так что удалить этот label обычным управлением группами невозможно. В том прогоне S19 **FAIL**. Это историческое наблюдение результата раннего harness; оно не доказывает причину и не заменяет повторную проверку штатно запущенного аддина. Текущий статус S19 указан в матрице и в новом evidence ниже. Это переданное свидетельство root, субагент не управлял Fusion. + +## Проверка обработчиков и cleanup после обнаружения orphan + +На последнем рабочем коде **103 offline tests, OK**. Дополнительные регрессии проверяют: при отказе удаления старой графики новые definitions не записываются; не удалённые staged graphics сохраняют управляемые ссылки для повторной очистки; exception при staged cleanup также сохраняет ссылку; ошибка unregister custom event не мешает удалению UI и handlers, состояние с неочищенной графикой остаётся доступным для повторной очистки. + +Root отдельно проверил нативные операции с **явным программным вызовом** обработчика `DocumentEvent('saving')` перед API save: после reopen orphan отсутствовал, definitions восстановились. Прямой нативный вызов обработчика auto-update также обновил результат. Это подтверждает локальные операции обработчиков на реальной геометрии, но **не** доказывает, что обычный пользовательский Save/Save As/команда редактирования доставляет нужные события в нужном порядке. Эти прямые вызовы сами по себе не закрывают S19 и end-to-end gates сохранения/перезапуска. Для закрытия нужны действия через штатный UI Fusion, без ручного вызова обработчиков, с теми же визуальными проверками. + +## Уточнённый контракт при отсутствии Mesora + +Пользователь подтвердил: без Mesora размеры **не должны отображаться**. Проект содержит только definitions (тип, ссылки на геометрию, offsets и видимость); отображаемую графику строит работающий аддин. После изменения модели без Mesora и последующего запуска аддина значения вычисляются заново, видимые размеры отрисовываются автоматически. Не требуется и недопустимо оставлять «замороженные» размеры для просмотра без аддина. Поэтому ранее наблюдавшийся старый label — нарушение именно отсутствия аннотаций, независимо от значения label. + +Причина прошлых orphan-наблюдений на уровне конкретного дефекта Autodesk или жизненного цикла обработчиков **не установлена**. Root проверяет штатный запуск/остановку через менеджер Scripts and Add-ins. Прямой `exec` модуля и прямые вызовы обработчиков нельзя считать доказательством нормального жизненного цикла аддина. Предыдущие фактические снимки остаются доказательством результата своего прогона; переносить их на новую установленную ревизию без повторения нельзя. + +## План проверки загрузки, автоматической отрисовки и времени жизни событий + +| ID | Внешний сценарий / ожидаемое поведение | Независимое доказательство | Что проверяет offline regression | +| --- | --- | --- | --- | +| L01 | Менеджер запускает Mesora при уже открытом сохранённом проекте: набор восстанавливается автоматически | После штатного запуска без открытия команды Mesora видны ожидаемые размеры; лог содержит старт экземпляра и факт восстановления файла | `run` подключает lifetime events и ставит восстановление текущего документа в безопасный callback; definitions загружены из фикстуры, не создаются тестом через `State.items` | +| L02 | При работающей Mesora пользователь открывает сохранённый проект: видимые строки появляются автоматически, скрытые остаются скрыты | Снимок и независимый Fusion Inspect; definitions до/после совпадают | Event открытия/активации→load→разрешение refs→render; неподдерживаемый продукт не создаёт State | +| L03 | Home/пустой сеанс→открытие; модель A→B→A; Drawing→модель | Наборы не смешаны; возвращается правильный набор, нет фоновых изменений Drawing | Очередь привязана к нужному документу или повторно проверяет активный doc; закрытые documents не удерживаются | +| L04 | Save/Drawing временно убирает графику: callback восстановления не перезапускает save loop | Source vN→vN+1, title остаётся чистым, Drawing открывается без ожидания | Повторные activation/commandEnded без изменения definitions/geometry не рисуют заново; save barrier учитывается в deferred load | +| L05 | Полная остановка/повторный запуск через менеджер дважды, затем штатный Save | Встроенный менеджер показывает один запущенный аддин; по одному callback на событие Save; UI без дублей | Подписки сбрасываются при stop; новый run не накапливает прежние handlers/custom event; отказ startup выполняет cleanup | +| L06 | Запуск Mesora без геометрии/с повреждённой schema/с удалённой ссылкой | Нет crash; valid документы доступны; плохая строка обозначена, файл не переписан | Ошибка одного документа/строки не блокирует остальные; никаких cached values при ошибке resolve | +| L07 | Без Mesora открыть, изменить, сохранить, переоткрыть; затем штатно запустить Mesora | До запуска нет аннотаций; после запуска только актуальные значения, сохранены row/global visibility | Сохранённые определения не содержат measured value; fingerprint первоначально вычислен для загруженного состояния, не подавляет initial render | + +Эти offline-проверки следует добавлять вокруг внешнего lifecycle и observable state, а не проверять конкретное число внутренних вызовов как самоцель. Реальная доставка Fusion events, время сохранения графики и отсутствие orphan остаются нативными gates. + +## Минимальный сборщик доказательств для нативного прогона + +Помощник должен **наблюдать** штатные события, а не вызывать `DocumentEvent.notify`, `State.refresh` или `Execute.notify` вместо действий пользователя. Допустимы read-only снимки состояния, временные observer handlers и запись JSONL локально вне публичного пакета. Он не должен изменять attributes, геометрию, признаки modified или CAD-архивы. Для тестовой геометрии сохраняются независимые ожидаемые величины (например, длина окружности `2*pi*r`) и Fusion Inspect. + +Для каждого события нужны: sequence, monotonic timestamp, имя штатного события, process/session/addin-instance ID, ревизия пакета и версия Fusion, синтетическое имя документа, активный workspace/command, `isModified`, API graphics count, runtime managed count и removed-for-save/editor flags, безопасный digest definitions (без entity tokens/доступных URL). Снимки: перед Save; после завершения Save; после stop; reopen с отключённой Mesora; после изменения и второго reopen; после штатного запуска Mesora. Счётчик API не заменяет снимок. Лог и screenshots связываются одним case/run ID. + +Проверка evidence должна отвечать на продуктовые вопросы: получен ли Saving обычным сохранением; исчезли ли managed graphics до записи; был ли Saved; не начался ли второй Save; исчезли ли **визуально** все аннотации без Mesora; сохранилась ли геометрия и definitions; появились ли после запуска актуальные значения. Отсутствующее событие или снимок означает INCONCLUSIVE, не PASS и не доказанную причину дефекта. Сборщик не должен содержать пользовательские модели, credentials, tokens или приватные пути в коммитах. + +## Штатный нативный прогон f090654: Save и повторное открытие без аддина + +Новые переданные root доказательства получены со штатно управляемой Mesora (Scripts and Add-ins), а не прямым `exec` продукта: + +1. Открытие безопасной синтетической фикстуры v2 автоматически загрузило два определения и отрисовало одну группу: m1 скрыт. +2. Реальный GUI Cmd+S с OK в диалоге сохранил v3 **один раз**. После сохранения документ clean, managed groups=0, removed_for_save=True, restore_requested=False. +3. Штатный `addon.stop`, закрытие фикстуры и повторное открытие v3 при `addon.isRunning=False`: одно тело, API groups=0, clean=True. +4. Root просмотрел `dist/local-validation/unlocked-ui-save-no-addon.png`: аннотаций Mesora визуально нет. Это доказательство отсутствия orphan для данного штатного пути сохранения и reopen, в дополнение к счётчику API. + +S09 macOS GUI Save принят для этой фикстуры/ревизии; S10/S19 только PARTIAL. Ещё нужны изменение и сохранение без аддина, последующий запуск и восстановление актуальных размеров, а также Save As и остальные gates. Ранние orphan-снимки остаются историей прежнего harness; ни библиотечный дефект Autodesk, ни ошибка lifetime как их первопричина не доказаны. + +Внешние observer handlers, импортированные из MCP-контекста и не получившие callbacks, **не дают** evidence product event lifecycle. Отсутствие callbacks у такого observer не доказывает отсутствие событий внутри штатного аддина. Для принятия используются фактические действия GUI, product state, версии файла и просмотренные снимки; event trace годится только после контрольного подтверждения, что observer действительно получает события в той же управляемой сессии. Пустой лог — INCONCLUSIVE. + +## Дополнительная штатная приёмка f090654 + +S19 принят на macOS для синтетической фикстуры: после предыдущего clean reopen без Mesora root изменил radius 2→2.3 cm при остановленном аддине. GUI Cmd+S с OK сохранил v4; close/reopen без аддина оставил radius2.3, clean=True, groups=0. Снимок `dist/local-validation/unlocked-no-addon-edited.png` просмотрен root: размеров нет. Штатный запуск Mesora автоматически восстановил 2 definitions, одну видимую группу, hidden m1, offsets .2/.3; измеренная окружность 14.451326206513047 cm, видимый label144.5 mm. Это не полный restart Fusion. + +Save As: настоящий Cancel сохранил исходный набор из 2 definitions, 1 group и hidden m1. Штатный Save As создал синтетическую копию `Mesora Save As acceptance 2026-11-13` v1: clean, groups0, removed_for_save=True, два определения в attributes. В этом прогоне observer действительно получил контрольные callbacks (4), затем зарегистрировал команду PLM360SaveAs (14), Saving (22, groups0), Saved (23, groups0), Terminated (24) без восстановления графики. Это валидный event trace конкретной управляемой сессии; он не легализует прежние пустые логи. Reopen копии без аддина и независимость копии от исходника ещё PENDING. + +Настоящий UI таблицы: общий глазик off дал 0 preview groups, on сохранил hidden m1; скрытие m2 дало 0 preview. OK сохранил hidden m1,m2 и groups0. Настоящий UI Undo восстановил stored hidden m1 и runtime groups1; Redo вернул stored hidden m1,m2 и runtime groups0. **Эта первоначальная metadata/runtime-проверка недостаточна: последующий разбор реального design count выявил D06, поэтому S07 FAIL.** После этого дополнительные несохранённые изменения синтетической копии отброшены; её сохранённая v1 содержит исходные настройки, а не результат этой последующей сессионной проверки. + +## Прерванная проверка изменения параметров + +После открытия синтетической копии root добавил радиальное ограничение d3 и открыл Change Parameters. Параметрическое изменение для S06 **не завершено**. Во время запроса accessibility tree через CUA после выбора параметров появился crash handler; наблюдаемая трасса указывала на Qt accessibility `SelectedChildren` и `libcer` read main thread. Затем CUA не получил окна/истёк timeout, MCP read-only запрос завис. Эти наблюдения **не доказывают Mesora как причину**. S06 остаётся PENDING/INCONCLUSIVE, а не FAIL Mesora по причине crash. Пользовательский несохранённый документ не изменялся; root не выполнял force-kill и запросил пользователю проверить состояние Fusion. Полный restart, Windows, geometry auto-update и остальные незакрытые gates не маркируются PASS. + +## История оценки S07 на f090654: Undo graphics FAIL, D06 + +Субагент прочитал реальный локальный observer trace `dist/native-acceptance/MesoraAcceptanceObserver/events.jsonl` (counters26–49). После OK hide-both (29–31) и runtime, и design имеют 0 групп. При Undo (34–37) design уже содержит одну группу, runtime отслеживает 0; definitions digest вернулся к варианту hidden m1. После deferred update (38–39) runtime отслеживает одну валидную группу, **design содержит две**. Это подтверждает неучтённую восстановленную группу вместе с новой группой аддина. При Redo (40–43) runtime держит одну уже невалидную ссылку, actual design=0; после update (44–45) оба счётчика снова 0. Следующий Undo (46–49) повторяет actual1/tracked0. + +Итог этого исторического прогона: восстановление метаданных подтверждено, но S07 **FAIL**, Major D06 был открыт. Текущий повторный результат fe68881 приведён ниже и в матрице. Прежние утверждения о groups1 на Undo относились только к `len(state.groups)` и не доказывали отсутствие дубликатов. Ownership/reconciliation fix разрабатывается отдельно; до нового нативного прогона успешное закрытие не заявляется. Повторная приёмка должна сравнивать runtime tracked/valid и реальные Mesora-owned groups на каждом шаге, проверить видимость, stop и save/reopen. Нельзя удалять все CustomGraphics документа: чужая графика должна сохраняться. Этот дефект не отменяет отдельные S19 доказательства штатного save/reopen без Undo, но блокирует стабильный релиз до исправления и повторной проверки. + +## Повторная нативная приёмка D06 на fe68881 + +Root штатно остановил/запустил Mesora и открыл синтетическую копию. На реальном Undo сохранён префикс ownership ID группы (тот же ID `81d9…` на новом wrapper); это нативное подтверждение идентификации восстановленной графики, а не предположение по API. + +- No-op OK Mesora без изменения settings → настоящий UI Undo: tracked1, validTracked1, actual1, owned1; UI Redo: все счётчики 1. +- Настоящий глазик m2 переключён false, draft false и preview0; Return/commit сохранил hidden m1,m2, tracked0/actual0. +- UI Undo восстановил stored hidden m1, validTracked1/actual1/owned1; Redo вернул обе скрытые, tracked0/actual0; повторный Undo снова дал 1/1. +- Затем настоящий GUI Cmd+S с OK сохранил копию v1→v2: clean, tracked0/actual0. После stop аддина закрытие последнего документа через API вернуло `pCurrentSession`, но UI Home подтвердил фактическое закрытие. Этот возврат API не объявляется успешным API close. +- Повторное открытие сохранённой v2 без Mesora: addonFalse, clean, actual0. Root просмотрел `dist/local-validation/ownership-undo-save-no-addon.png`: labels отсутствуют. +- Штатный запуск Mesora автоматически восстановил 2 definitions и одну валидную группу. + +D06 **RETEST PASS на macOS для указанной фикстуры и ревизии**: no-op Undo, metadata visibility Undo/Redo, ownership counts и save/reopen после Undo. Ранний FAIL f090654 был реальным и описывает старый код; он не является текущим результатом fe68881. Другие геометрические Undo, Windows и остальная матрица остаются отдельными gates. + +## Перезапуск после crash: ограниченное доказательство S11 + +Fusion запущен заново после закрытия Crash Reporter без отправки отчёта. Появился Home с нулём открытых документов; recovery list закрыт без открытия или удаления пользовательских файлов. На запуске source6f223 Mesora имела isStartup=True, isRunning=True и 16 handlers; затем штатно перезагружена fe68881. Это подтверждает автозапуск аддина в данной сессии после crash, но не полный **graceful exit→restart→reopen** сохранённой фикстуры. Поэтому S11 остаётся PARTIAL/PENDING для нормального полного цикла. Причина crash не приписывается Mesora. + +## Актуальное расширение нативной приёмки fe68881 + +**S06 / геометрические Undo/Redo — macOS PARTIAL PASS.** Root выполнил нативную управляемую SDK-команду `FourFusionLabAcceptanceRadius`: в собственной Fusion-транзакции она изменила параметр d3 23→27 mm. Mesora handlers вручную не вызывались; автоматическое обновление изменило label144.5→169.6 mm. Затем настоящий GUI Edit → Undo Multiple → Undo Acceptance Radius вернул144.5 mm; настоящий GUI Redo, без MCP-запроса между Undo и Redo, вернул169.6 mm. При радиусе27 mm tracked=valid=actual=owned=1. Это подтверждает auto-update через нативный command lifecycle и геометрический Undo/Redo для этой фикстуры. Ручной диалог Change Parameters не объявляется принятым: прежний Qt AX crash оставляет его прогон INCONCLUSIVE. + +**S14 / Drawing — macOS latest fixture PASS.** При visiblegroup1 root запустил настоящую `NewFusionDrawingDocumentCommand`. Доставленный observer trace:108 Saving с group1 →109 Saved с group0 и clean. Source-копия сохранилась v2→v3 ровно одной версией; настоящая Drawing workspace открылась. Base view отменён, Drawing закрыт Don't Save; источник остался clean, tracked/actual0. Тем самым повторно принят Drawing на актуальной реализации persistence/автообновления, а не только на старом промежуточном коде. + +**S11 / полный штатный перезапуск — macOS fixture PASS.** Настоящий Cmd+Q завершил процесс Fusion; повторный запуск открыл Home, Mesora startup/running=True. Открытие сохранённой copyv3 автоматически восстановило 2 definitions, hiddenm1 и одну tracked/actual группу с label169.6 mm; root снял/проверил изображение. После stop аддина, close Don't Save и reopenv3: clean, actual0; отдельное изображение подтверждает ноль labels. Это заменяет прежнее ограниченное свидетельство только crash-relaunch для этого сценария. Точные пути снимков фиксируются root в нативном отчёте. + +**S12 / независимость Save As — PARTIAL PASS.** Без аддина root одновременно открыл исходникv4 (radius2.3 cm) и copyv3 (radius2.7 cm). Оба clean, graphics0; копирование и последующее геометрическое изменение не изменили исходник. Независимость редактирования definitions/settings между файлами отдельно заново не проверена, поэтому весь S12 не закрыт. + +Пользователь подтвердил отсутствие доступного Windows Fusion. Windows остаётся **PENDING**, это не PASS по офлайн Windows CI и, по последующему прямому решению пользователя, не самостоятельный блокер публикации. Перечисленные macOS результаты не означают, что вся обязательная Mac-матрица закрыта: общий stable gate пока не пройден. + +## Актуальный publication scope по решению пользователя + +Пользователь явно уточнил: **«Если мы на этой ОС все проверим и пройдем квалитигейты — убирай упоминания, что это экспериментальный аддин»**. Для текущего выпуска обязательна подтверждённая приёмка на доступной **macOS**. Недоступность Windows Fusion сама по себе больше не блокирует релиз или снятие experimental-формулировок. В продуктовой документации следует честно указать, что нативная Windows-приёмка не выполнялась; это не замена Mac gates и не повод объявить Windows проверенной. Offline CI на всех трёх ОС остаётся обязательным техническим gate. + +Снятие experimental не выполнено этой записью: сначала должны закрыться оставшиеся обязательные Mac проверки ниже и финальные технические gates. Нельзя снять требование к данным/сохранению или сузить поддерживаемые виды измерений только ради публикации. Ранее принятые сценарии действительны в указанном объёме ревизии; runtime-изменения после них требуют затронутого retest, а не механического повтора всей истории. + +## Оставшиеся обязательные Mac gates: исполнимые пакеты + +Все пункты ниже **PENDING**, пока root не приложит фактический результат. Это короткая последовательность завершающей приёмки; никакой новый PASS здесь не выставлен. + +| Очерёдность | Gate / что выполнить на отдельных синтетических данных | Условие закрытия и доказательство | Трассировка | +| --- | --- | --- | --- | +| P0-1 | Базовая текущая команда: через настоящий UI создать и применить **все 7 видов** (distance, edge_length, radius, diameter, angle, area, perimeter). На дуге проверить длину дуги, на face с отверстием perimeter; один раз заменить геометрию/тип, добавить и удалить строку, clear, неполный и duplicate выбор, OK/Cancel | Числа сверены с Fusion Inspect/независимой формулой; единицы и preview корректны; неправильный выбор не применяется; Cancel сохраняет committed, clear/remove удаляют только выбранное. Снимки UI и таблица expected/actual для 7 типов | S02/S03/S04/S05; закрывает исходные UI/types, не только renderer smoke | +| P0-2 — STOP по указанию пользователя | До изменения указания НЕ выполнять file save. Исходный план: на наборе из 7 видов сохранить offsets и индивидуально скрытую строку; общий off/on; Save→close/reopen→штатный запуск с восстановлением; затем stop→reopen без Mesora | Определения/настройки всех 7 типов совпали, актуальные значения восстановились; managed/actualowned согласованы, без Mesora **визуально нет** аннотаций. Текущий lifecycle был принят на 2 definitions, его нельзя выдавать за 7-type round trip | S10/S19; S11 уже graceful fixture PASS, повторить только если затронут runtime | +| P0-3 | Удалить feature измеренной геометрии при наличии второй здоровой строки; открыть таблицу, исправить плохую строку выбором новой geometry, повторить удаление и явно очистить/удалить broken row; Undo/Redo удаления последней Mesora-строки | Нет stale label и блокировки всей таблицы, valid row доступна, definitions не теряются молча; repair/clear/remove предсказуемы, owned counts после Undo/Redo согласованы. Снимки и trace | S08, оставшаяся часть S07/D03/D06 | +| P0-4 — file operations STOP по указанию пользователя | До изменения указания НЕ выполнять save/Save As/fault-save. Исторический план: завершить Save As: в копии поменять definition/visibility/offset, сохранить; исходник и копию открыть поочерёдно с Mesora; stop и reopen сохранённой копии без аддина. Выполнить воспроизводимый контролируемый **failed save→retry** и canceled-save recovery на disposable fixture; отдельно API save, если продукт заявляет его поддержку | Definitions/settings файлов независимы; без аддина нет labels. Неудачное сохранение не теряет набор, не вызывает loop, повторное сохранение и продолжение работают. Реальная ошибка доставки/записи фиксируется отдельно от Cancel; один не заменяет другой. Нельзя ломать пользовательские файлы/сеть/сессию ради fault injection | S12/S13/D04; геометрическая независимость и Save As Cancel уже приняты | +| P1-1 | С Mesora открыть два model-документа с разными наборами, переключить A→B→Drawing→A, закрыть B и создать C; camera orbit/zoom; изменить единицы mm/in. Применить один штатный интерактивный model edit через безопасный UI путь | Наборы/видимость не смешиваются, закрытый doc не используется, camera/units дают актуальный текст и placement; UI edit завершён без ручных вызовов Mesora handlers и auto-update соответствует геометрии. SDK command/GUI Undo уже приняты; конкретный crash-прерванный Change Parameters не требуется повторять небезопасным AX способом для этого gate | S06/S15/S16; manual Parameters остаётся отдельно INCONCLUSIVE, без ложного PASS | +| P1-2 | На ненулевом transform и вложенном occurrence создать поддерживаемые измерения, переместить occurrence и проверить пересчёт; unsupported geometry; на отдельной disposable fixture future/corrupt metadata попытаться открыть и изменить Mesora | Прокси/числа/placement корректны в assembly context; unsupported выбор отклонён; неизвестный payload не перезаписан, остальные документы доступны. Нативные missing/invalid cases + offline ambiguous/schema regressions дополняют друг друга | S16/S17; старый zero-transform smoke недостаточен | +| P1-3 | После последней runtime-правки пройти затронутые critical retests: Drawing source Save once; ownership no-op+visibility Undo/Redo и save/reopen; startup/stop twice | Не переносить старый PASS на изменённый путь. Нужны только действительно затронутые regressions; уже принятые fe68881 результаты не повторяются без основания. Event lifetime и отсутствие labels проверены продуктовым managed lifecycle, а не прямым exec/notify | S01/S07/S09/S11/S14/S19, D06 | +| P2 | Финальный выпускной кандидат: unit/integration suite, compile, validator, diff check, CI Linux/macOS/Windows; воспроизводимый ZIP/version/SHA/notes/licenses; установка именно ZIP на Mac, Run on Startup, smoke по строке и stop/restart; EN/RU docs согласованы с принятым поведением | Все checks зелёные; версия из GitVersion, ZIP ставится как add-in, стабильные UUID/IDs сохранены; ссылки на CI/ZIP/доказательства. После этого снять experimental и выпустить штатно, проверить опубликованные checksum/version/notes | S01/S18/D05 и release policy | + +Разделение объёма: P0-1 — обязательная **базовая приёмка текущего UI и всех заявленных типов**, а не произвольное расширение аудита. P0-2–P1-2 закрывают уже зафиксированные требования к сохранению, отказам, ссылкам и заявленной assembly/units функциональности. Не требуется исчерпывающий перебор каждой геометрии × всех камер × каждого типа × всех операций, произвольные новые workspace/сложные сборки или глобальный security/UX аудит. Новая случайная гипотеза не создаёт gate сама по себе; обнаруженный воспроизводимый blocker/major в поддерживаемом сценарии должен быть исправлен и проверен. Недоступный Windows остаётся ограничением доказательств, не препятствием после выполненных обязательных Mac gates. + +## Дополнительная приёмка all-types и GUI; scope handlers на6a0663e + +Root зарегистрировал и запустил пакет, извлечённый из ZIP fe68881 с числовой тестовой версией0.0.0: UUID корректен, stop удалил commands, run создал16 apphandlers без дублей. Это установка тестового артефакта; placeholder не является релизной версией, назначенной GitVersion. + +Управляемая синтетическая нативная команда `FourFusionLabAcceptanceAllTypes` выполнила7 измерений на реальной геометрии; лог содержит `measurement.pass` для всех видов и `suite.pass`. Expected/actual в внутренних единицах Fusion (cm; angle в rad; area в cm²): distance3; angleπ/2; edge_length16.9646; radius2.7; diameter5.4; area22.902210444669596; perimeter16.9646. Созданы valid owned groups. Adapter attribute save/load сохранил7 definitions, offsets0..0.3cm, hiddenm1/m4, globalFalse. Дополнительный SketchCircle удалён, его reference retained в строке8; corrupt/future payload отказал в overwrite; suite cleanup вернул0 групп. Это нативное измерение/рендер/хранение attributes, а **не** завершённый GUI picking или cloud file save/reopen7. + +Настоящая UI Mesora загрузила8 строк, включая missing-reference label, и показала значения. Enter применил набор, сохранив broken row. Во втором открытии root изменил eye m2 и kind m3 edge_length→radius, увидел27mm, затем Escape: committed kinds/hidden/global остались исходными. В третьем открытии root прокрутил к низу, нажал clear_m8, затем remove toolbar и Return: осталось7 остальных строк без потери их kinds. Настоящая Toggle-команда globalTrue дала5 групп при hiddenm1/m4. + +Затем обнаружено удержание command handlers без ограничения; root исправил scope на6a0663e. Передано128 offline tests PASS. Нативно: при открытии таблицы16 apphandlers и один command scope с5bindings; Escape оставил16 apphandlers,0 scopes, editorFalse и5 групп. Второе открытие, UI eye m1 и Return:16 apphandlers,0 scopes, hiddenm4 и6 valid tracked/actual групп. Это доказательство изолированного lifecycle исправления. Финальная CI/упаковка/затронутые retests последней runtime-ревизии ещё не объявлены пройденными. + +Реальный Save нового all-types проекта не завершён. Последующее прямое указание пользователя: **НЕ СОХРАНЯТЬ тестовые файлы**. Прежний запрос перевода фикстурыv4 в Read Only отменён; ответа/освобождения cloud slot больше не ожидают. Новые cloud/local save-тесты не выполняются. Save/reopen7 остаётся НЕ ПРОВЕРЕНО и исключён из дальнейшего исполнения без нового разрешения; это не PASS и не автоматически выявленный дефект продукта. Исторические сохранённые2-def fixtures доказательства не теряются. Picking и оставшиеся проверки без сохранения продолжаются; визуальная читаемость стала приоритетным дефектом D07. Windows не самостоятельный blocker по решению пользователя. Эта запись изменяет только журнал приёмки и не снимает experimental автоматически. + +## Новое прямое ограничение: не сохранять тестовые файлы + +Пользователь запретил сохранение тестовых файлов и поручил удалить ранее сохранённые тестовые фикстуры. Root подтвердил очистку:4 созданные облачные тестовые фикстуры удалены (`deleted=True`), контрольный поиск дал0. Пользовательские модели не заявлены удалёнными. Запрос Read Only для освобождения cloud slot **отменён**, пользовательского действия по нему не ожидают. До нового прямого указания не выполнять ни cloud Save/Save As, ни local/export round trip с записью тестового CAD-файла. Нельзя обходить запрет сменой формата или места сохранения. Несохраняемые синтетические документы, read-only evidence и обратимые операции в текущей тестовой сессии остаются рабочим способом проверки. + +Все строки матрицы с pending file operations описывают неполученные доказательства, а не текущую команду их выполнить. P0-2/P0-4 помечены STOP. Уже полученные исторические save/reopen доказательства сохраняются с указанием ревизии и объёма; дополнительный save/reopen7 **НЕ ПРОВЕРЕН**, не выдаётся за PASS и не преследуется дальше вопреки пользователю. Экспериментальная маркировка не снимается автоматически: сейчас прежде всего открыт воспроизводимый Major D07. + +## D07: совместная читаемость измерений — обязательный текущий gate + +На фактическом all-types UI пользователь сообщил явное перекрытие6 аннотаций. Это подтверждённая пользовательская проблема текущего визуального результата; нативные `measurement.pass` подтверждают значения, но **не** читаемость. В актуальном renderer до исправления размещение рассчитывается для отдельных измерений и препятствий модели, общего распределения текстовых областей набора нет. Точная архитектура исправления остаётся за renderer-agent/root, этот read-only обзор не меняет runtime. + +Ожидаемые проверки post-patch: + +1. На той же несохранённой плотной all-types фикстуре показать все6 видимых измерений в исходной камере; значения и соответствие геометрии сохранены, тексты не перекрываются, выноски позволяют понять принадлежность каждой аннотации. Снимок полного viewport и увеличенного участка до/после; root действительно просматривает их. +2. Тот же набор в command preview, после OK и после Cancel: результат согласован, Cancel возвращает исходные настройки; нет остаточных/дублированных owned groups. Числа сверяются отдельно от layout. +3. Hide одной строки и global off/on сохраняют individual visibility, не оставляют occupied slots от скрытого текста, не создают резких беспричинных перемещений оставшихся. Проверить повторный refresh без изменения input: layout стабилен. +4. Orbit минимум в двух отличающихся направлениях и zoom ближе/дальше: labels читаемы, размеры текста приемлемы, решение не держится только на одном скриншоте. Не требуется полный перебор камер. +5. Изменить разрешённым нативным command способом геометрию в несохранённой фикстуре: актуальные значения и leader attachment сохранены, joint placement пересчитан, ownership counts согласованы. Один ручной offset должен оставаться применимым и предсказуемым. +6. Offline regression моделирует плотные соседние текстовые boxes и проверяет отсутствие пересечений/ограниченное число шагов/детерминизм; отдельная проверка сохраняет числа и привязку leader к геометрии. Простое утверждение «добавлен offset по номеру строки» не доказывает читаемость. Нативный screenshot не заменяется тестом координат. + +D07 закрывается только после доработки и фактического визуального повторного прогона root. Новых PASS этой записью не выставлено. Остальные разрешённые Mac gates не отменяются; все новые CAD-save проверки остановлены по явному указанию пользователя. Windows остаётся ограничением доказательств, не самостоятельным publication blocker. + +## D07: предварительный нативный retest после Retina-исправления + +Root проверил текущую **несохранённую** all-types фикстуру после исправления плотности Retina. В той же front camera кластеры area/perimeter и edge_length/diameter визуально разделены. После Viewport.fit/zoom разделение сохранилось. При настоящем переключении камеры IsoTopRight и fit отработал штатный cameraChanged, без прямого вызова Mesora handlers: все6 labels видны и читаемы, overlap не наблюдается, angle90° расположен отдельно. Paramood временно скрыт только для обзора полного viewport; root планирует восстановить его видимость. + +Состояние прогона:7 definitions, hiddenm4; tracked/valid/owned/actual=6, captions=6, дополнительные leaders=3; offsets сохранились .0/.05/.1/.15/.2/.25/.3 cm;16 apphandlers,0 command scopes; isSaved=False. Файлы не сохранялись. Передано140 offline tests PASS. Это предварительный визуальный PASS для указанных камер, а **не полное закрытие D07**. + +Остаются обязательные части D07: настоящий UI preview→OK/Cancel, row/global hide/show с сохранением индивидуальных настроек, orbit/возврат камеры без дрожания и новых перекрытий; проверка привязки leader после перемещения labels и согласованности counts после каждого цикла. Ранее планировавшиеся ручной offset и геометрическое изменение в несохранённой фикстуре должны иметь отдельный actual результат либо явно указанный остаток. Нельзя закрывать D07 только по сравнению bounding boxes офлайн или одному front-view скриншоту. Сохранение CAD-файла для этих проверок не требуется и по-прежнему запрещено пользователем. + +Очистка cloud fixtures по сообщению root завершена:4 тестовые фикстуры `deleted=True`; контрольный поиск0. Отменённый Read Only запрос не возобновляется, новые cloud/local тестовые CAD-файлы не создаются сохранением. + +## D07: статическая читаемость и временная стабильность — разные результаты + +После предварительного статического retest пользователь наблюдал **реальные скачки аннотаций при orbit**. D07 остаётся **OPEN / Major**: исправление статического overlap не означает исправления поведения во времени. Предыдущие front/fit/isometric снимки подтверждают только конкретные статические состояния, а не непрерывное движение или повторяемость возврата камеры. Итогового «исправлено» пока нет. + +Renderer-agent подготовил новый patch: previous world anchor рассматривается первым кандидатом, hysteresis удерживает допустимое положение, геометрия angle сохраняется при orbit/zoom, edge-on conditioning использует относительный критерий. Root уточняет применение transforms, чтобы избежать промежуточных GPU-перерисовок и jitter. Передано142 offline tests PASS; это **не PASS нативной стабильности**. Root перезагружает код и выполняет повторную проверку; результата этой записью не предвосхищаем. + +Для retest нужно непрерывно пройти orbit→zoom→исходная камера на том же несохранённом наборе (7 definitions/6 visible), увидеть отсутствие ненужных jumps, затем выполнить UI preview/OK/Cancel и hide/show. Движение, необходимое при реальном конфликте/невидимости, должно оставаться понятным и ограниченным; требование — не абсолютная неподвижность при любом изменении модели, а отсутствие скачков при сохранении допустимого placement. Контрольные статические снимки дополняются наблюдением движения/видео либо последовательностью кадров с одинаковыми camera checkpoints и anchor positions. Результат должен включать привязки leaders, неизменность пользовательских offsets и согласованные owned counts. + +Все4 созданные cloud-фикстуры удалены, search0 подтверждён root. Нативные acceptance helpers остановлены и отвязаны. Текущая модель несохранённая; запрет новых CAD-save остаётся действующим. Отсутствие Windows по-прежнему не самостоятельный publication blocker; открытый macOS D07 — блокер. + +## D07: ограниченный нативный retest 8129f2f + +Commit8129f2f опубликован в репозиторий с142 offline tests PASS; root загрузил финальный renderer, включая отказ от промежуточного применения transforms. На текущем **несохранённом** наборе root выполнил реальные изменения камеры через SDK: yaw2°, затем ещё12° (всего14°). Отработал настоящий cameraChanged; Mesora handlers вручную не вызывались. + +В обеих контрольных точках world-anchor deltas всех6 labels составили `[0,0,0,0,0,0]`. Плоский массив координат angle arc остался побайтно тем же; tracked/actual=6. После14° root просмотрел CUA viewport: все6 labels читаемы, overlap не наблюдается, включая отдельный90° angle. Paramood снова видим; модель не сохранялась. + +Это **scoped native PASS для двух указанных camera samples**, а не полное закрытие D07. Широкий непрерывный orbit, крайние ракурсы, zoom/возврат и remaining UI preview/OK/Cancel/hide/show не приняты этим результатом. Root запросил необязательную пользовательскую оценку привычного orbit и ожидает ответ, не вмешиваясь больше в камеру во время проверки пользователем. Отсутствие ответа не считается PASS. Ни публикация commit, ни offline tests не закрывают оставшиеся native gates автоматически. + +## Текущая policy a77502e: камера не меняет размещение + +8129f2f limited2°/14° PASS остаётся историческим свидетельством тех samples, но **не решил пользовательское восприятие скачков** и не является окончательным исправлением. Новый commit **a77502e** меняет policy: `CameraChanged` выполняет только ориентацию текста, **никогда не запускает arrange/repack**; геометрия angle фиксируется при render и не перестраивается от движения камеры. Joint placement применяется при построении/изменении набора, а не в orbit. Передано144 offline tests PASS, validator и diff check PASS. Публикация commit сама по себе не закрывает D07. + +Root штатно перезагрузил исходники без CAD-save; нативная проверка загруженного кода подтвердила `cameraRepack=False`, `angleRebuild=False`. Затем root изменил настоящую камеру через SDK на45°,90° и вернул0°. В **каждой** контрольной точке все6 world-anchor deltas равны0, плоские координаты angle arc неизменны, tracked/actual=6. Отработали реальные camera events, без прямых вызовов Mesora handlers. Это ограниченный нативный PASS **инварианта геометрии при указанных camera samples**, а не подтверждение непрерывного пользовательского UX или всех ракурсов. + +D07 остаётся **OPEN**. Root запросил новую оценку привычного orbit у пользователя; ответа пока нет, молчание не считается приёмкой. Нужно сохранить отдельную проверку читаемости, отсутствия зрительных скачков text orientation и leader attachment при непрерывном orbit/zoom/возврате, а также remaining UI preview/OK/Cancel/hide/show. Нулевая world-anchor delta подтверждает неподвижность расположения, но сама по себе не доказывает, что пользователь больше не видит проблемы. Новые CAD-файлы не сохранялись, запрет test saves действует. + +## Актуальное закрытие D07 по пользователю + +После загрузки **a77502e** пользователь проверил свой обычный orbit и прямо подтвердил: **«Теперь не скачут»**. D07 **RETEST PASS / CLOSED для воспроизведённого macOS набора из6 labels**. Основания вместе: root ранее визуально подтвердил разделение6 labels; текущие реальные camera45°/90°/return0° дали нулевые world-anchor deltas и неизменную angle arc при tracked/actual6; пользователь подтвердил отсутствие исходного симптома своим привычным взаимодействием. + +Сохраняются границы доказательств: не выполнен исчерпывающий перебор всех возможных ракурсов и моделей. Это **не основание держать исправленный дефект открытым** или придумывать новые extreme-camera gates. Обычная3D-проекция может скрыть геометрию/текст за моделью или привести направления в одну экранную точку; это отличается от самопроизвольного reposition/jump исправленного дефекта. Новый воспроизводимый дефект поддерживаемого сценария должен оцениваться отдельно, а не предполагаться заранее. + +Предыдущие секции OPEN описывают последовательность разработки до пользовательского подтверждения; текущие статусы определяются этой записью и таблицей D07. Preview→Escape с восстановлением6 групп и cleanup16 apphandlers/0 scopes, а также no-op Enter→Select с6 группами были проверены до последней camera-only правки; a77502e не меняет эти apply/cancel пути. Исторические file-save/Drawing/ownership proofs остаются на своих ревизиях: перенос на текущую основан на том, что camera-only policy не добавляет рендер/attribute/save hooks и непосредственно исключает camera repack, а не на вымышленном новом Save. Если изменятся соответствующие пути, потребуется затронутый retest, но **без запрещённого CAD-save**. + +## Критический остаток Mac-приёмки после закрытия D07 + +Этот список заменяет прежние открытые планы как **текущее действие**. Новые CAD-save/Save As/export/fault-save не выполняются по прямому запрету пользователя. Нет ожидания Read Only, cloud slot или ответа по сохранению. Исторические Save/reopen/Drawing/graceful restart доказательства сохраняются; новые7-type file roundtrip и реальный failed cloud save честно остаются непроверенными ограничениями, а не задачами вопреки пользователю. + +1. **Завершить фактический выбор в текущем UI без сохранения.** Нативный all-types API suite принял все7 чисел и renderer; actual UI уже принял загрузку, type change, глазики, OK/Cancel и broken-row removal. Неполученная часть — UI geometry picker: выбрать/заменить реальную геометрию для7 поддерживаемых kinds в одном несохранённом наборе; для distance/angle проверить second object, для unsupported/incomplete/duplicate — отказ применения. Проверить отсутствие утечки command scope после завершения. Это базовая работа заявленной команды, не большой cross-product. +2. **Один целевой context smoke, если заявлена assembly поддержка.** В несохранённой синтетической сборке с ненулевым transform (можно одновременно вложенный occurrence) создать измерение через UI, переместить occurrence нативной командой и сравнить актуальное значение/leader с Fusion Inspect. Один проход A→B→A на двух несохранённых docs с разными наборами удостоверяет routing, без Drawing/file-save повторов. Если такой фактический путь уже принят root, приложить evidence и не повторять его. Это ограниченный owning-adapter/UI boundary, не перебор каждой сборки/камеры/типа. +3. **Финальные технические gates и документация текущего кода.** Прогнать актуальные offline suite/validator/compile/diff; дождаться зелёной CI Linux/macOS/Windows, проверить финальный ZIP, version/SHA/notes/license/stableIDs и Mac install/start/stop со scoped handlers. Согласовать EN/RU README/manifest с принятыми возможностями; после закрытия оставшихся обязательных Mac gates убрать experimental согласно прямому решению пользователя. Нативный Windows указать как untested, не превращая его в самостоятельный blocker. Только затем штатная публикация с проверкой артефактов. + +Не требуется снова сохранять CAD, повторять уже принятые untouched apply/cancel/save пути, раскрывать весь произвольный test matrix, провоцировать Qt AX crash тем же способом или ожидать недоступный Windows. При обнаружении конкретного blocker/major на оставшихся поддерживаемых UI/context путях он исправляется и повторно проверяется; без такого факта произвольные расширения не задерживают завершение авторизованной задачи. + +## Новая приёмка a77502e перед временной передачей общей Fusion-сессии + +Root установил извлечённый финальный код a77502e из ZIP с placeholder0.0.0: нативный путь модуля соответствует пакету, стабильный UUID сохранён,56 файлов;7 definitions,6 tracked/valid/actual групп,16 apphandlers,0 command scopes. Пакет остановлен/отвязан, каноническая установка восстановлена с startup=True. Это доказательство установки кода, а не опубликованной GitVersion-версии. CI run15 наa77502e успешно завершён,144 теста PASS. + +Несохранённый временный документB выполнил native SDK7suite и7 независимых аналитических context tests: точка top occurrence (8,21,30), nested occurrence (5,21,35); после parentX+1 resolver/measure вернули distance√1702=41.255302689472536. Это native adapter/reference-context PASS; автоматический renderer update для перемещения сборки этим результатом не доказывается. B закрыт через close(False), helpers остановлены/отвязаны. Переход A→B→A сохранил в исходномA7 kinds m1..m7, hiddenm4, offsets0..0.3cm, globalTrue и6 групп. + +Настоящий пользовательский click-probe зарегистрировал4 genuine picker `inputChanged`: один Face→AREA, два Faces→DISTANCE, затем AREA и DISTANCE. Escape сохранил definitions, editorFalse,0 scopes. Общая ветка выбора1/2 геометрий принята этим взаимодействием; не требуется физически повторять один и тот же mouse gesture для каждого математического kind при уже принятом native измерении и общем picker. Подготовлена **TypeProbe matrix из13 настоящих dropdown transitions**, но она **ещё не выполнена**. Следующая оставшаяся базовая UI-проверка — доступные type choices, resulting value и lifecycle по этой matrix, а не новый exhaustive picking cross-product. Oracle для perimeter периодической cylindrical face остаётся неоднозначным до уточнения: native adapter suite не превращается в independent Inspect PASS без однозначного expected value. + +Общая Fusion-сессия временно передана Planara QA с явным подтверждением. До возврата lease Mesora root/агенты **не выполняют API/UI**; подготовленный probe ожидает возврата. Это координационное ограничение, не дефект и не PASS ожидающего сценария. Новые CAD-save по-прежнему запрещены. + +Уточнение текущего остатка: ранее предложенная проверка shared picker реализована фактическими переходами1/2Face; native context resolver/measure и A→B→A тоже получили доказательства. Не расширять их до непроверенного assembly auto-render или ambiguous Inspect. После возврата lease завершить только type-branch matrix/уточнение действительного oracle и финальные product/docs/release gates; не повторять уже подтверждённые shared gestures или cloud-save. + +## Финальное независимое заключение по разрешённой Mac-приёмке + +После явного возврата lease root выполнил ожидавшую TypeProbe matrix: **13 настоящих dropdown/inputChanged переходов**, каждый kind и formatted value совпал с аналитическим expected, после возврата исходных7 types definitions не изменились. Probe остановлен/отвязан, Escape оставил Select. Это дополняет4 genuine user picker перехода1/2Faces и нативный7-type analytic suite. Совместно они покрывают pipeline selection→kind→value→render→commit/cancel; отдельный mouse-pick каждого математического типа не заявляется и не нужен как дублирующий gate общей ветки. + +Неоднозначность cylindricalm4 perimeter разрешена независимым штатным **Fusion MeasureCommand** на той же заранее выбранной face: screenshot показал Loop Length339.292mm, Area5089.38mm², Radius27mm, Diameter54mm. Нативная face Cylinder имела2 edges/2 loops, по1 coedge; суммы edge/coedge и адаптер совпали:33.929200658769766cm. Поэтому perimeter339.3mm не ошибка и теперь имеет independent native oracle PASS. + +Субагент независимо повторил на текущем checkout: `python3 -m unittest discover -s tests -v` — **144 tests OK**; `python3 scripts/check_project.py` — **Validated Mesora; initialized=True**; `git diff --check` — PASS. В suite есть реальные owning-path проверки: save cleanup failure выставляет `isOperationCancelled`; staged/old cleanup failure не записывает definitions, сохраняет refs для retry; retry удаляет revived owned graphics; неизменные metadata/fingerprint не обходят ownership reconciliation; save barrier не пересоздаёт графику; command scopes удаляются при destroy/stop, включая failure; corrupt/future data не перезаписываются. Это meaningful offline failure regressions, **не утверждение**, что фактический failed cloud save выполнен. + +**Вердикт: конкретного открытого blocker/major в текущем авторизованном macOS scope по имеющимся доказательствам нет. Продуктовая Mac-приёмка достаточна для снятия experimental после финализации документации и технического release gate.** Основание — не сокращение требований ради выпуска, а доказанный основной пользовательский путь, исправленные и повторно принятые D06/D07, полноценные owning-module regressions и прямые ограничения пользователя: Windows недоступен и не самостоятельный blocker; новые тестовые CAD-save запрещены. Ранние save/reopen/startup/Drawing доказательства сохраняются с их ревизиями. Поздние изменения text-child/layout/camera policy и command-scope lifetime не меняют owning definitions persistence или documentSaving/documentSaved callbacks; current regressions проверяют их границы совместно. Поэтому повторять неизменившийся cloud-save путь, вопреки запрету, не является оставшимся gate. + +Не заявляются: все возможные комбинации geometry×camera×kind, отдельный mouse-pick каждого из7 типов, native Windows, новый сохранённый7-type model roundtrip, реальный failed cloud save, native renderer auto-update при каждом assembly transform, успешный manual Change Parameters после AX crash. Это честные границы покрытия, а не обнаруженные дефекты. Нельзя писать, что они все PASS; также нельзя держать завершённую задачу открытой только из-за произвольного исчерпывающего matrix. + +**Что ещё необходимо до фактической публикации:** согласовать EN/RU user docs/manifest с принятым стабильным поведением и указанными limits; прогнать требуемую актуальную CI на публикуемом commit; штатно получить GitVersion-версию, собрать/проверить release ZIP/version/SHA/notes/license и immutable публикацию; проверить опубликованные артефакты. Эти этапы — техническое завершение релиза, а не новые CAD-сценарии. Native install текущего ZIP кода (56 файлов, UUID, handlers/scopes) уже принят; placeholder0.0.0 не выдаётся за опубликованную версию. + +## Финальный принятый статус и граница публикации + +Root принял независимое macOS-заключение. Пользовательское условие выполнено: проверены разрешённые основные сценарии на доступной ОС и пройдены соответствующие quality gates; **experimental-маркировка снимается в актуальной документации/метаданных**. В авторизованном native scope нет открытого блокирующего gate. Это не превращает непроверенный Windows, запрещённый новый7-type CAD-save или любые произвольные cross-products в PASS: ограничения выше сохраняются как ограничения evidence. + +По текущему просмотру рабочего дерева HEAD runtime **a77502e**, новые незакоммиченные изменения касаются README и документации. Последующая согласованная правка product description/branding в manifest/project metadata не меняет Python runtime semantics или стабильные UUID/command IDs и сама по себе **не требует повторной CAD-приёмки**. Финальный root review должен удостовериться, что в релизный commit действительно входят лишь эти branding/docs изменения сверх принятого runtime; если появится behavioral diff, оценить только затронутые regressions. + +Технический релиз **PENDING** до фактической публикации и проверки результатов. Root завершает работу через существующий PR и последнюю CI, штатные GitVersion/publishing workflows, без ручных tags или перезаписи assets. Проверяются final version, installable ZIP, embedded manifest, SHA-256, release notes и ссылка на опубликованный артефакт. Эта запись не утверждает наличие опубликованного Release до того, как workflow завершён. + +Fusion-сессия возвращена Planara QA с подтверждением. Mesora root/агенты не обращаются к живой Fusion через GUI/API; принятую CAD-приёмку не повторяют ради branding. Новые тестовые CAD-файлы не сохраняются; очистка созданных4 cloud fixtures уже подтверждена root. diff --git a/docs/visibility-and-drawing.md b/docs/visibility-and-drawing.md new file mode 100644 index 0000000..c8353e5 --- /dev/null +++ b/docs/visibility-and-drawing.md @@ -0,0 +1,48 @@ +# Visibility, saving and Drawing + +[Русская версия](visibility-and-drawing.ru.md) + +## Show or hide dimensions + +Each measurement row has an eye button. It hides or shows the dimension without +removing its geometry references, type or offset. Hidden rows remain editable. +The eye beside **+**, **−** and the trash button controls the whole set. Showing +the set again preserves individually hidden rows. + +Visibility changes preview immediately. **OK** stores definitions, offsets and +visibility in the design; **Cancel** discards the draft. Values are recalculated +from the geometry rather than saved as cached numbers. Missing references remain +available for repair or removal instead of displaying an old value. + +## Place labels and rotate the model + +Mesora spaces labels apart when dimensions are added or edited. Rotating or zooming +keeps their positions and leader lines fixed in the model; only text orientation +changes for readability. Angular arcs also stay fixed. A new view can project +labels onto each other; use **Refresh Dimensions** to arrange them for that view. +Model, geometry, offset and visibility changes can arrange the whole set again. + +## Save and reopen + +Definitions and settings are saved with the model. Mesora removes its displayed +graphics before saving and does not redraw them in `documentSaved`. This keeps +the source clean when Drawing needs to save it. After a save, open Mesora or use +**Refresh Dimensions** to show dimensions again. + +Opening a document or starting Mesora loads the saved definitions and requests +display in a suitable Design context. Without Mesora running, the model is editable +and the dimensions are not displayed. A canceled Save As preserves the current set. + +## Drawing and verification + +macOS acceptance confirmed a Drawing transition with visible dimensions and one +source save, followed by a clean return to the model. Base View placement was +canceled; completed drawing creation and detailing were not part of that check. + +The accepted macOS scope also includes visibility, Undo/Redo without duplicate +graphics, geometry updates, save/reopen, Save As, normal Fusion restart and the +absence of labels when Mesora is stopped. The user confirmed that normal orbit +no longer makes labels jump. Windows remains natively unverified. See the +[native evidence](validation/stability-native-2026-11-13.ru.md), +[acceptance matrix](validation/stable-release-cjm-2026-11-13.ru.md) and +[coverage notes](fusion-safety.md). diff --git a/docs/visibility-and-drawing.ru.md b/docs/visibility-and-drawing.ru.md new file mode 100644 index 0000000..e6d5e37 --- /dev/null +++ b/docs/visibility-and-drawing.ru.md @@ -0,0 +1,50 @@ +# Видимость, сохранение и Drawing + +[English](visibility-and-drawing.md) + +## Показ и скрытие размеров + +У каждой строки измерения есть глазик. Он скрывает или показывает размер, сохраняя +ссылки на геометрию, тип и смещение. Скрытые строки можно редактировать. Глазик +рядом с **+**, **−** и корзиной управляет всем набором. Повторный показ набора +сохраняет индивидуально скрытые строки. + +Изменения видимости сразу отображаются в предпросмотре. **OK** записывает +определения, смещения и видимость в модель; **Cancel** отменяет черновик. Значения +пересчитываются по геометрии, а не сохраняются как кешированные числа. Потерянные +ссылки остаются доступны для исправления или удаления вместо показа старого значения. + +## Размещение подписей и вращение модели + +Mesora разносит подписи при добавлении или изменении размеров. При вращении и +масштабировании их положение и выносные линии остаются на месте в модели; меняется +только ориентация текста для чтения. Угловые дуги также неподвижны. В новом ракурсе +подписи могут спроецироваться друг на друга; нажмите **Refresh Dimensions**, чтобы +разместить их для этого вида. Изменение модели, геометрии, смещений и видимости +может заново разместить весь набор. + +## Сохранение и повторное открытие + +Определения и настройки сохраняются вместе с моделью. Mesora удаляет отображаемую +графику перед сохранением и не пересоздаёт её в `documentSaved`. Это оставляет +исходник чистым, когда Drawing требуется его сохранить. После сохранения откройте +Mesora или нажмите **Refresh Dimensions**, чтобы снова показать размеры. + +Открытие документа или запуск Mesora загружают сохранённые определения и +запрашивают показ в подходящем контексте Design. Без работающей Mesora модель +доступна для редактирования, а размеры не показываются. Отмена Save As сохраняет +текущий набор. + +## Drawing и проверка + +Нативная приёмка macOS подтвердила переход в Drawing при показанных размерах, +одно сохранение исходника и чистое состояние после возврата в модель. Размещение +Base View отменено; создание и оформление завершённого чертежа в эту проверку не входили. + +Принятая область macOS также охватывает видимость, Undo/Redo без дубликатов +графики, обновление геометрии, сохранение/повторное открытие, Save As, обычный +перезапуск Fusion и отсутствие подписей при остановленной Mesora. Пользователь +подтвердил, что при обычном вращении подписи больше не скачут. Windows остаётся +нативно непроверенной. См. [нативные доказательства](validation/stability-native-2026-11-13.ru.md), +[матрицу приёмки](validation/stable-release-cjm-2026-11-13.ru.md) и +[границы проверки](fusion-safety.ru.md). diff --git a/scripts/native_acceptance_observer.py b/scripts/native_acceptance_observer.py new file mode 100644 index 0000000..8b80b50 --- /dev/null +++ b/scripts/native_acceptance_observer.py @@ -0,0 +1,269 @@ +"""Read-only Fusion event observer for synthetic Mesora acceptance documents. + +Generate a disposable managed add-in with scripts/prepare_native_observer.py, +then load/run it through Fusion's Script Manager. The generated run entrypoint +calls start and probe automatically. Importing and starting this module through +an MCP script does not establish trustworthy native callback ownership. +Only a recorded customEvent.callback proves that queued events were delivered; +successful registration or fireCustomEvent alone is insufficient evidence. +It never calls Mesora handlers, changes event cancellation, measures geometry, +creates graphics, or edits/saves/closes documents. Only documents whose names +start with 'Mesora' contribute document or product state. Other names are redacted. +Attribute contents and entity tokens are never written; only a SHA-256 is emitted. + +The observer is development tooling and is not included in the add-in ZIP. +API references: +https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Application.htm +https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_UserInterface_commandStarting.htm +https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Application_fireCustomEvent.htm +""" +import hashlib +import json +from pathlib import Path +import sys +import time +import uuid +from datetime import datetime, timezone + +import adsk.core +import adsk.fusion + + +# Retain every callback until its event has actually detached. +HANDLERS = [] +_SESSION = None +_ATTRIBUTE_GROUP = '4FusionLab.Dimensions' +_ATTRIBUTE_NAME = 'definitions' + + +def _get(obj, name, fallback=None): + try: + return getattr(obj, name) if obj is not None else fallback + except Exception: + return fallback + + +def _same(left, right): + try: + return left is not None and right is not None and left == right + except Exception: + return False + + +def _document(doc): + if doc is None: + return {'present': False} + name = _get(doc, 'name') + if not isinstance(name, str) or not name.startswith('Mesora'): + return {'present': True, 'included': False} + return {'present': True, 'included': True, 'name': name, + 'is_modified': _get(doc, 'isModified'), 'is_valid': _get(doc, 'isValid')} + + +def _product_module(): + # Inspect already-loaded modules only; importing Mesora could itself run code. + for module in tuple(sys.modules.values()): + namespace = _get(module, '__dict__', {}) + filename = namespace.get('__file__') + if (isinstance(filename, str) and Path(filename).name == 'Mesora.py' + and isinstance(namespace.get('STATES'), list)): + return module + return None + + +def _state_for(doc): + module = _product_module() + for state in _get(module, 'STATES', []): + if _same(_get(state, 'doc'), doc): + groups = _get(state, 'groups', []) + live = _get(state, 'live_preview', []) + return {'matched': True, 'tracked_groups': len(groups), + 'valid_tracked_groups': sum(bool(_get(g, 'isValid', False)) for g in groups), + 'live_preview_groups': len(live), + 'has_preview': _get(state, 'preview') is not None, + 'removed_for_save': _get(state, 'removed_for_save'), + 'editor_open': _get(state, 'editor_open'), + 'measurement_count': len(_get(state, 'items', [])), + 'visible': _get(state, 'visible'), + 'hidden_count': len(_get(state, 'hidden_ids', set()))} + return {'matched': False, 'module_loaded': module is not None} + + +def _design_info(doc): + try: + product = doc.products.itemByProductType('DesignProductType') + design = adsk.fusion.Design.cast(product) + if not design: + return {'present': False} + attribute = design.attributes.itemByName(_ATTRIBUTE_GROUP, _ATTRIBUTE_NAME) + result = {'present': True, 'definitions_present': bool(attribute), + 'custom_graphics_group_count': design.rootComponent.customGraphicsGroups.count} + groups = design.rootComponent.customGraphicsGroups + result['mesora_graphics_ids'] = [groups.item(i).id for i in range(groups.count) + if groups.item(i).id.startswith('4FusionLab.Mesora.')] + if attribute: + result['definitions_sha256'] = hashlib.sha256(attribute.value.encode('utf-8')).hexdigest() + return result + except Exception as exc: + # Exception messages can contain paths or values; persist the class only. + return {'inspection_error': type(exc).__name__} + + +def _context(event_doc=None): + app = adsk.core.Application.get() + ui = app.userInterface + active = _get(app, 'activeDocument') + target = event_doc if event_doc is not None else active + active_info, target_info = _document(active), _document(target) + data = {'active_command': _get(ui, 'activeCommand'), + 'active_workspace': _get(_get(ui, 'activeWorkspace'), 'id'), + 'active_document': active_info, 'event_document': target_info, + 'event_document_matches_active': _same(target, active)} + if target_info.get('included'): + data['mesora_state'] = _state_for(target) + data['design'] = _design_info(target) + return data + + +def _trace(event, event_doc=None, **extra): + session = _SESSION + if session is None: + return None + # Timestamp callback entry before any document or product-state inspection. + entered = time.monotonic_ns() + session['counter'] += 1 + record = {'session': session['id'], 'counter': session['counter'], + 'monotonic_ns': entered, 'elapsed_ns': entered - session['started_ns'], + 'utc': datetime.now(timezone.utc).isoformat(), + 'event': event, 'phase': 'entry'} + record.update(extra) + try: + record.update(_context(event_doc)) + except Exception as exc: + record['context_error'] = type(exc).__name__ + session['stream'].write(json.dumps(record, ensure_ascii=False, allow_nan=False) + '\n') + session['stream'].flush() + return record['counter'] + + +class _DocumentHandler(adsk.core.DocumentEventHandler): + def __init__(self, name): + super().__init__() + self.name = name + + def notify(self, args): + _trace(self.name, _get(args, 'document')) + + +class _CommandHandler(adsk.core.ApplicationCommandEventHandler): + def __init__(self, name): + super().__init__() + self.name = name + + def notify(self, args): + _trace(self.name, command_id=_get(args, 'commandId')) + + +class _ProbeHandler(adsk.core.CustomEventHandler): + def notify(self, args): + # additionalInfo is our generated UUID, never an arbitrary caller payload. + session = _SESSION + if session is not None: + session['probe_callbacks'] += 1 + _trace('customEvent.callback', probe_id=_get(args, 'additionalInfo'), + delivered_callbacks=session['probe_callbacks'] if session else 0) + + +def _bind(event, handler): + if not event.add(handler): + raise RuntimeError('Could not attach acceptance observer handler') + HANDLERS.append((event, handler)) + + +def start(output_path): + """Attach independent observers and return a unique session ID. + + The caller must invoke this on Fusion's permitted main thread. Existing JSONL + is appended, not overwritten. Starting while already active is rejected. + """ + global _SESSION + if _SESSION is not None: + raise RuntimeError('Acceptance observer is already active; call stop first') + path = Path(output_path).expanduser() + if not path.is_absolute(): + raise ValueError('Observer output_path must be absolute') + path.parent.mkdir(parents=True, exist_ok=True) + session_id = str(uuid.uuid4()) + _SESSION = {'id': session_id, 'counter': 0, 'started_ns': time.monotonic_ns(), + 'stream': path.open('a', encoding='utf-8', buffering=1), + 'custom_id': 'MesoraAcceptanceObserver.' + session_id, + 'custom_registered': False, 'probe_callbacks': 0} + app = adsk.core.Application.get() + try: + for name in ('documentSaving', 'documentSaved', 'documentOpened', + 'documentClosing', 'documentCreated', 'documentActivated'): + _bind(getattr(app, name), _DocumentHandler(name)) + for name in ('commandStarting', 'commandTerminated'): + _bind(getattr(app.userInterface, name), _CommandHandler(name)) + event = app.registerCustomEvent(_SESSION['custom_id']) + if not event: + raise RuntimeError('Could not register acceptance probe') + _SESSION['custom_registered'] = True + _bind(event, _ProbeHandler()) + _trace('observer.started', fusion_version=_get(app, 'version'), + attached_handlers=len(HANDLERS)) + return session_id + except Exception: + stop() + raise + + +def snapshot(label): + """Record current read-only state. Labels must contain no confidential data.""" + if _SESSION is None: + raise RuntimeError('Acceptance observer is not running') + return _trace('observer.snapshot', label=str(label)) + + +def probe(): + """Queue the observer's own probe; only callback records prove delivery.""" + if _SESSION is None: + raise RuntimeError('Acceptance observer is not running') + ident = str(uuid.uuid4()) + _trace('customEvent.request', probe_id=ident) + queued = adsk.core.Application.get().fireCustomEvent(_SESSION['custom_id'], ident) + _trace('customEvent.queued', probe_id=ident, queued=bool(queued)) + return {'session': _SESSION['id'], 'probe_id': ident, 'queued': bool(queued)} + + +def stop(): + """Detach all observers and unregister the probe, retaining failures for retry.""" + global _SESSION + if _SESSION is None: + return {'running': False, 'remaining_handlers': len(HANDLERS)} + failed = [] + for event, handler in reversed(HANDLERS): + try: + if event.remove(handler): + HANDLERS.remove((event, handler)) + else: + failed.append(type(handler).__name__) + except Exception as exc: + failed.append(type(exc).__name__) + if not HANDLERS and _SESSION['custom_registered']: + try: + if adsk.core.Application.get().unregisterCustomEvent(_SESSION['custom_id']): + _SESSION['custom_registered'] = False + else: + failed.append('CustomEventUnregisterFailed') + except Exception as exc: + failed.append(type(exc).__name__) + complete = not HANDLERS and not _SESSION['custom_registered'] + _trace('observer.stopped' if complete else 'observer.detach_failed', + remaining_handlers=len(HANDLERS), detach_errors=failed) + result = {'session': _SESSION['id'], 'running': not complete, + 'remaining_handlers': len(HANDLERS), 'errors': failed} + if complete: + _SESSION['stream'].close() + _SESSION = None + return result diff --git a/scripts/prepare_native_observer.py b/scripts/prepare_native_observer.py new file mode 100644 index 0000000..13117b1 --- /dev/null +++ b/scripts/prepare_native_observer.py @@ -0,0 +1,59 @@ +"""Build an unshipped managed Fusion observer add-in for native acceptance. + +Load the generated folder through Application.scripts.addExisting, then run(False). +Do not import/start the observer through an MCP script: that callback ownership +does not reproduce the Fusion-managed add-in lifecycle. +""" +import argparse +import json +from pathlib import Path +import shutil + + +NAME = 'MesoraAcceptanceObserver' +ROOT = Path(__file__).resolve().parents[1] +ENTRYPOINT = '''"""Disposable read-only acceptance observer, loaded by Fusion Script Manager.""" +from pathlib import Path +from . import observer + + +def run(context): + observer.start(str(Path(__file__).parent / 'events.jsonl')) + observer.probe() + + +def stop(context): + result = observer.stop() + if result.get('running'): + raise RuntimeError('Observer could not detach all handlers') +''' + + +def prepare(output): + folder = Path(output).resolve() + if folder.name != NAME: + raise ValueError('Output folder must be named ' + NAME) + folder.mkdir(parents=True, exist_ok=True) + # Never overwrite the event log: each managed run appends its session. + shutil.copyfile(ROOT / 'scripts' / 'native_acceptance_observer.py', folder / 'observer.py') + (folder / '__init__.py').write_text('', encoding='utf-8') + (folder / (NAME + '.py')).write_text(ENTRYPOINT, encoding='utf-8') + manifest = {'autodeskProduct': 'Fusion360', 'type': 'addin', + 'id': '2197dba9-6c78-48e0-bf24-652dbdf91570', + 'author': '4FusionLab', 'version': '0.0.1', + 'description': {'': 'Read-only native acceptance observer (development only).'}, + 'supportedOS': 'windows|mac', 'editEnabled': True} + (folder / (NAME + '.manifest')).write_text(json.dumps(manifest, indent=2) + '\n', encoding='utf-8') + return folder + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--output', type=Path, + default=ROOT / 'dist' / 'native-acceptance' / NAME) + args = parser.parse_args() + print(prepare(args.output)) + + +if __name__ == '__main__': + main() diff --git a/tests/test_batch_apply.py b/tests/test_batch_apply.py index d8b2aaf..31a9713 100644 --- a/tests/test_batch_apply.py +++ b/tests/test_batch_apply.py @@ -9,16 +9,17 @@ class ApplyTest(unittest.TestCase): def test_camera_change_updates_preview_when_committed_dimensions_hidden(self): core = types.ModuleType('adsk.core'); fusion = types.ModuleType('adsk.fusion') core.Application = types.SimpleNamespace(get=lambda: types.SimpleNamespace(userInterface=None)) - for name in ('CommandCreatedEventHandler', 'InputChangedEventHandler', 'ValidateInputsEventHandler', 'CommandEventHandler', 'DocumentEventHandler', 'CameraEventHandler'): + for name in ('CommandCreatedEventHandler', 'InputChangedEventHandler', 'ValidateInputsEventHandler', 'CommandEventHandler', 'DocumentEventHandler', 'CameraEventHandler', 'WorkspaceEventHandler', 'ApplicationCommandEventHandler', 'CustomEventHandler'): setattr(core, name, type(name, (), {})) adsk = types.ModuleType('adsk'); adsk.core = core; adsk.fusion = fusion with patch.dict(sys.modules, {'adsk': adsk, 'adsk.core': core, 'adsk.fusion': fusion}): sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) mod = importlib.import_module('Mesora.Mesora') mod.APP = types.SimpleNamespace(activeDocument=object()) + mod.UI = types.SimpleNamespace(activeWorkspace=types.SimpleNamespace(id='FusionSolidEnvironment')) state = types.SimpleNamespace(removed_for_save=False, visible=False, groups=['hidden'], live_preview=['preview'], preview=None) camera = object() - with patch.object(mod, 'state_for', return_value=state), patch.object(mod.renderer, 'orient_text') as orient: + with patch.object(mod, 'state_for', return_value=state), patch.object(mod.renderer, 'arrange_labels'), patch.object(mod.renderer, 'orient_text') as orient: mod.CameraChanged().notify(types.SimpleNamespace(viewport=types.SimpleNamespace(camera=camera))) orient.assert_called_once_with('preview', camera) sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) @@ -26,7 +27,7 @@ def test_camera_change_updates_preview_when_committed_dimensions_hidden(self): def test_delete_committed_measurement_keeps_others(self): core = types.ModuleType('adsk.core'); fusion = types.ModuleType('adsk.fusion') core.Application = types.SimpleNamespace(get=lambda: types.SimpleNamespace(userInterface=None)) - for name in ('CommandCreatedEventHandler', 'InputChangedEventHandler', 'ValidateInputsEventHandler', 'CommandEventHandler', 'DocumentEventHandler', 'CameraEventHandler'): + for name in ('CommandCreatedEventHandler', 'InputChangedEventHandler', 'ValidateInputsEventHandler', 'CommandEventHandler', 'DocumentEventHandler', 'CameraEventHandler', 'WorkspaceEventHandler', 'ApplicationCommandEventHandler', 'CustomEventHandler'): setattr(core, name, type(name, (), {})) adsk = types.ModuleType('adsk'); adsk.core = core; adsk.fusion = fusion with patch.dict(sys.modules, {'adsk': adsk, 'adsk.core': core, 'adsk.fusion': fusion}): @@ -36,27 +37,28 @@ def test_delete_committed_measurement_keeps_others(self): state.items = [('m1', 'area', ('a',)), ('m2', 'radius', ('b',))] state.erase = lambda: None state.refresh = lambda: [] - state.remove_item('m1') + with patch.object(mod, 'save_state'): + state.remove_item('m1') self.assertEqual([row[0] for row in state.items], ['m2']) with self.assertRaises(ValueError): state.remove_item('missing') sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) - def test_adding_to_hidden_state_restores_all_measurements(self): + def test_explicitly_showing_hidden_state_restores_all_measurements(self): core = types.ModuleType('adsk.core'); fusion = types.ModuleType('adsk.fusion') core.Application = types.SimpleNamespace(get=lambda: types.SimpleNamespace(userInterface=types.SimpleNamespace())) - for name in ('CommandCreatedEventHandler', 'InputChangedEventHandler', 'ValidateInputsEventHandler', 'CommandEventHandler', 'DocumentEventHandler', 'CameraEventHandler'): + for name in ('CommandCreatedEventHandler', 'InputChangedEventHandler', 'ValidateInputsEventHandler', 'CommandEventHandler', 'DocumentEventHandler', 'CameraEventHandler', 'WorkspaceEventHandler', 'ApplicationCommandEventHandler', 'CustomEventHandler'): setattr(core, name, type(name, (), {})) adsk = types.ModuleType('adsk'); adsk.core = core; adsk.fusion = fusion with patch.dict(sys.modules, {'adsk': adsk, 'adsk.core': core, 'adsk.fusion': fusion}): sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) mod = importlib.import_module('Mesora.Mesora') - state = types.SimpleNamespace(items=[('m1','radius',('old',))], groups=[], visible=False, next_id=2, erase=lambda: None) + state = types.SimpleNamespace(items=[('m1','radius',('old',))], groups=[], visible=False, next_id=2, erase=lambda keep=(): None) old_row = types.SimpleNamespace(id='m1', kind='radius', entities=('old',)) row = types.SimpleNamespace(id='m2', kind='radius', entities=('new',)) - ctx = types.SimpleNamespace(batch=types.SimpleNamespace(rows=[old_row, row], next_id=3), clear_preview=lambda: None) + ctx = types.SimpleNamespace(batch=types.SimpleNamespace(rows=[old_row, row], next_id=3), clear_preview=lambda: None, visible=True) mod.APP = types.SimpleNamespace(activeViewport=types.SimpleNamespace(camera=None)) state.design = object() - with patch.object(mod, 'current_state', return_value=state), patch.object(mod, 'reference_for', side_effect=lambda e:e), patch.object(mod, 'resolve', side_effect=lambda d,r:r), patch.object(mod.renderer, 'render', side_effect=['old group','new group']): + with patch.object(mod.renderer, 'arrange_labels'), patch.object(mod, 'geometry_fingerprint', return_value=('snapshot',)), patch.object(mod, 'save_state'), patch.object(mod, 'current_state', return_value=state), patch.object(mod, 'reference_for', side_effect=lambda e:e), patch.object(mod, 'resolve', side_effect=lambda d,r:r), patch.object(mod.renderer, 'render', side_effect=['old group','new group']): mod.Execute('add', ctx).notify(None) self.assertTrue(state.visible) self.assertEqual(state.groups, ['old group','new group']) diff --git a/tests/test_caption_integration.py b/tests/test_caption_integration.py new file mode 100644 index 0000000..0a7ca0e --- /dev/null +++ b/tests/test_caption_integration.py @@ -0,0 +1,187 @@ +"""Exercise batch placement through actual command/document lifecycle handlers.""" +import types +import unittest +from unittest.mock import Mock, patch + +import test_visibility_lifecycle as lifecycle +from test_renderer_model_plane import Matrix, Point + + +class Group: + def __init__(self, ident): + self.id = ident + self.isValid = self.isVisible = True + self.deleted = False + + def addLines(self, coordinates, indices, strip): + return types.SimpleNamespace(coordinates=coordinates) + + def deleteMe(self): + self.deleted = True + self.isValid = False + return True + + +class CaptionIntegrationTest(unittest.TestCase): + tearDown = lifecycle.LifecycleTest.tearDown + + def setUp(self): + lifecycle.LifecycleTest.setUp(self) + self.arrangement_patch.stop() # Exercise the actual screen-space arranger. + # Other suites reload adsk stubs; bind both adapters to this fixture's API. + renderer_api = patch.object(self.m.renderer, 'adsk', self.m.adsk) + renderer_api.start() + self.addCleanup(renderer_api.stop) + core, fusion = self.m.adsk.core, self.m.adsk.fusion + core.Point3D = types.SimpleNamespace(create=Point) + core.Vector3D = types.SimpleNamespace(create=Point) + core.Matrix3D = types.SimpleNamespace(create=Matrix) + fusion.CustomGraphicsCoordinates = types.SimpleNamespace(create=lambda value: tuple(value)) + self.m.APP.activeViewport.camera = types.SimpleNamespace(eye=Point(0, 0, 10), upVector=Point(0, 1, 0)) + self.m.APP.activeViewport.modelToViewSpace = lambda p: Point(p.x * 100, p.y * 100, 0) + self.m.UI.messageBox = Mock() + self.state.design = types.SimpleNamespace(rootComponent=object()) + self.created = [] + + def render(self, design, kind, entities, camera, ident, **kwargs): + group = Group(ident) + self.created.append(group) + # Real placement data, deliberately coincident for every measurement. + self.m.renderer._LABELS[id(group)] = ( + types.SimpleNamespace(width=10, color=(0, 0, 0, 255)), + (0, 0, 0), (1, 0, 0), (0, 1, 0), 1, None, False) + return group + + def assert_separated(self, groups): + boxes = [] + for group in groups: + anchor = self.m.renderer._LABELS[id(group)][1] + p = self.m.APP.activeViewport.modelToViewSpace(Point(*anchor)) + rect = (p.x - 85, p.y - 15, p.x + 85, p.y + 15) + self.assertTrue(all(rect[2] <= other[0] or other[2] <= rect[0] or + rect[3] <= other[1] or other[3] <= rect[1] + for other in boxes), 'Captions from the same batch overlap') + boxes.append(rect) + + def rows(self, count): + return [types.SimpleNamespace(id='m' + str(i), kind='radius', + entities=('edge' + str(i),), visible=True, offset=.25) + for i in range(1, count + 1)] + + def test_refresh_and_preview_pack_six_simultaneous_captions_without_changing_offsets(self): + self.state.items = [(r.id, r.kind, r.entities) for r in self.rows(6)] + self.state.offsets = {row[0]: .25 for row in self.state.items} + with patch.object(self.m, 'resolve', side_effect=lambda d, r: r), \ + patch.object(self.m, 'geometry_fingerprint', return_value=('current',)), \ + patch.object(self.m.renderer, 'render', side_effect=self.render): + self.assertEqual(self.state.refresh(), []) + self.assertEqual(len(self.state.groups), 6) + self.assert_separated(self.state.groups) + self.assertEqual(set(self.state.offsets.values()), {.25}) + context = types.SimpleNamespace(visible=True, batch=types.SimpleNamespace(rows=self.rows(6)), + layout_cache={}, preview_groups=[], sync_batch=lambda: ([], set()), + update_status=Mock()) + context.clear_preview = lambda: context.preview_groups.clear() + args = types.SimpleNamespace(command=types.SimpleNamespace(commandInputs=object()), isValidResult=True) + with patch.object(self.m.renderer, 'render', side_effect=self.render), \ + patch.object(self.m.renderer, 'obstacle_signature', return_value=()): + self.m.Preview(context).notify(args) + self.assertEqual(len(context.preview_groups), 6) + self.assert_separated(context.preview_groups) + # Hidden rows must not keep occupying a previous preview's rectangle. + context.batch.rows[0].visible = False + self.m.Preview(context).notify(args) + self.assertEqual(len(context.preview_groups), 5) + self.assertEqual(self.m.renderer._LABELS[id(context.preview_groups[0])][1], (0, 0, 0)) + self.assert_separated(context.preview_groups) + self.assertEqual([r.offset for r in context.batch.rows], [.25] * 6) + self.assertFalse(args.isValidResult) + + def test_execute_packs_new_set_before_persisting_and_keeps_offsets_as_user_values(self): + context = types.SimpleNamespace(clear_preview=Mock(), visible=True, + batch=types.SimpleNamespace(rows=self.rows(6), next_id=7)) + def persist(design, items, offsets, hidden, visible): + self.assert_separated(self.created) + self.assertEqual(offsets, {'m' + str(i): .25 for i in range(1, 7)}) + with patch.object(self.m, 'reference_for', side_effect=lambda e: e), \ + patch.object(self.m, 'resolve', side_effect=lambda d, r: r), \ + patch.object(self.m, 'geometry_fingerprint', return_value=('new',)), \ + patch.object(self.m, 'save_state', side_effect=persist), \ + patch.object(self.m.renderer, 'render', side_effect=self.render): + self.m.Execute('add', context).notify(None) + self.assertEqual(len(self.state.groups), 6) + self.assert_separated(self.state.groups) + self.assertEqual(set(self.state.offsets.values()), {.25}) + self.m.UI.messageBox.assert_not_called() + + def test_execute_placement_failure_preserves_committed_graphics_and_definitions(self): + old = self.render(None, None, None, None, 'old') + self.state.groups = [old] + self.state.items = [('m9', 'radius', ('committed',))] + self.created.clear() + context = types.SimpleNamespace(clear_preview=Mock(), visible=True, + batch=types.SimpleNamespace(rows=self.rows(2), next_id=3)) + with patch.object(self.m, 'reference_for', side_effect=lambda e: e), \ + patch.object(self.m, 'resolve', side_effect=lambda d, r: r), \ + patch.object(self.m.renderer, 'render', side_effect=self.render), \ + patch.object(self.m.renderer, 'arrange_labels', side_effect=ValueError('No caption space')): + self.m.Execute('add', context).notify(None) + self.assertTrue(old.isValid) + self.assertEqual(self.state.groups, [old]) + self.assertEqual(self.state.items, [('m9', 'radius', ('committed',))]) + self.m.save_state.assert_not_called() + self.assertTrue(all(g.deleted for g in self.created)) + self.m.UI.messageBox.assert_called_once() + + def test_orbit_preserves_preview_placement_and_cancel_reflows_restored_committed_set(self): + committed = [self.render(None, None, None, None, 'committed' + str(i)) for i in range(2)] + for group in committed: + group.isVisible = False + preview = [self.render(None, None, None, None, 'preview' + str(i)) for i in range(2)] + self.state.groups, self.state.live_preview = committed, preview + self.m.renderer.arrange_labels(preview, self.m.APP.activeViewport.camera, self.m.APP.activeViewport) + context = types.SimpleNamespace(state=self.state) + def clear(): + for group in preview: + group.deleteMe() + self.m.renderer.forget(group) + preview.clear() + context.clear_preview = clear + self.m.CameraChanged().notify(types.SimpleNamespace(viewport=self.m.APP.activeViewport)) + self.assert_separated(preview) + self.assertEqual(self.m.renderer._LABELS[id(preview[0])][1], (0, 0, 0)) + self.m.DestroyPreview(context).notify(None) + self.assertTrue(all(g.isVisible for g in committed)) + self.assert_separated(committed) + self.assertFalse(self.state.editor_open) + self.assertEqual(self.state.live_preview, []) + + def test_camera_collision_does_not_reposition_world_captions_or_leaders(self): + groups = [self.render(None, None, None, None, 'm' + str(i)) for i in range(2)] + self.state.live_preview = groups + viewport = self.m.APP.activeViewport + self.m.renderer.arrange_labels(groups, viewport.camera, viewport) + self.assert_separated(groups) + anchors = [self.m.renderer._LABELS[id(group)][1] for group in groups] + leader = self.m.renderer._CAPTIONS[id(groups[1])]['leader'] + leader_coordinates = leader.coordinates + arc = types.SimpleNamespace(coordinates=('unchanged dimension arc',)) + self.m.renderer._ANGLES[id(groups[0])] = (arc, (0, 0, 0), (1, 0, 0), (0, 1, 0), 1.57, 0) + # An edge-on projection makes the previously separated captions overlap. + # Camera movement must not silently choose new world positions to fix it. + viewport.modelToViewSpace = lambda p: Point(p.x * 100, 0, 0) + self.assertEqual(viewport.modelToViewSpace(Point(*anchors[0])).y, + viewport.modelToViewSpace(Point(*anchors[1])).y) + for eye_x in (.01, .1, .5): + viewport.camera.eye.x = eye_x + self.m.CameraChanged().notify(types.SimpleNamespace(viewport=viewport)) + self.assertEqual([self.m.renderer._LABELS[id(g)][1] for g in groups], anchors) + self.assertEqual(leader.coordinates, leader_coordinates) + self.assertEqual(arc.coordinates, ('unchanged dimension arc',)) + self.assertEqual(self.state.live_preview, groups) + self.assertTrue(all(g.isValid for g in groups)) + self.m.APP.log.assert_not_called() + + +if __name__ == '__main__': + unittest.main() diff --git a/tests/test_command_handler_lifetime.py b/tests/test_command_handler_lifetime.py new file mode 100644 index 0000000..84c5711 --- /dev/null +++ b/tests/test_command_handler_lifetime.py @@ -0,0 +1,69 @@ +"""Command destruction must release temporary handlers without stopping Mesora.""" +import gc +import types +import unittest +import weakref + +import test_visibility_lifecycle as lifecycle + + +class Event: + def __init__(self): self.handlers = [] + def add(self, handler): self.handlers.append(handler); return True + def remove(self, handler): self.handlers.remove(handler); return True + + +class CommandHandlerLifetimeTest(unittest.TestCase): + def setUp(self): + self.fixture = lifecycle.LifecycleTest(methodName='runTest') + self.fixture.setUp() + self.m = self.fixture.m + + def tearDown(self): + self.fixture.tearDown() + + def test_repeated_native_command_lifetimes_keep_app_handlers_bounded(self): + app_event, app_handler = Event(), object() + self.m.bind(app_event, app_handler) + for _ in range(3): + command = types.SimpleNamespace(execute=Event(), destroy=Event()) + self.m.Created('toggle').notify(types.SimpleNamespace(command=command)) + self.assertEqual(len(self.m.HANDLERS), 1) + self.assertEqual(len(self.m.COMMAND_SCOPES), 1) + self.assertEqual(len(command.execute.handlers), 1) + command.destroy.handlers[0].notify(None) + self.assertEqual(command.execute.handlers, []) + self.assertEqual(command.destroy.handlers, []) + self.assertEqual(self.m.COMMAND_SCOPES, []) + self.assertEqual(self.m.HANDLERS, [(app_event, app_handler)]) + + def test_destroy_cleanup_failure_drops_document_context_and_scope(self): + scope = self.m.EventScope() + self.m.COMMAND_SCOPES.append(scope) + class Context: + def clear_preview(self): raise RuntimeError('Preview removal failed') + context = Context() + context.state = self.fixture.state + context.state.editor_open = True + group = types.SimpleNamespace(isValid=True, isVisible=False) + context.state.groups = [group] + destroyed = self.m.DestroyPreview(context, scope) + scope.bind(Event(), self.m.Preview(context)) + scope.bind(Event(), destroyed) + ref = weakref.ref(context) + del context + destroyed.notify(None) + gc.collect() + self.assertIsNone(ref()) + self.assertTrue(group.isVisible) + self.assertFalse(self.fixture.state.editor_open) + self.assertEqual(self.m.COMMAND_SCOPES, []) + + def test_addin_stop_detaches_still_active_command_scope(self): + command = types.SimpleNamespace(execute=Event(), destroy=Event()) + self.m.Created('toggle').notify(types.SimpleNamespace(command=command)) + self.m.APP.unregisterCustomEvent = lambda ident: True + self.m.stop(None) + self.assertEqual(command.execute.handlers, []) + self.assertEqual(command.destroy.handlers, []) + self.assertEqual(self.m.COMMAND_SCOPES, []) diff --git a/tests/test_document_restore.py b/tests/test_document_restore.py new file mode 100644 index 0000000..b089c66 --- /dev/null +++ b/tests/test_document_restore.py @@ -0,0 +1,139 @@ +"""Deferred restore from document attributes, never from the active product.""" +import types +from unittest.mock import Mock, patch +import unittest +import test_visibility_lifecycle as lifecycle + + +class DocumentRestoreTest(unittest.TestCase): + tearDown = lifecycle.LifecycleTest.tearDown + def setUp(self): + lifecycle.LifecycleTest.setUp(self) + self.m.STATES.clear() + self.design = object() + self.doc.isValid = True + self.doc.products = types.SimpleNamespace(itemByProductType=Mock(return_value=self.design)) + self.m.adsk.fusion.Design = types.SimpleNamespace(cast=lambda product: product) + self.m.APP.fireCustomEvent = Mock(return_value=True) + self.m.APP.documents = [self.doc] + self.stored = types.SimpleNamespace(items=[('m1', 'radius', ('edge',))], offsets={'m1': 2}, + hidden_ids={'m1'}, visible=True, next_id=2) + + def test_open_loads_from_document_and_defers_graphics(self): + with patch.object(self.m, 'load_state', return_value=self.stored), \ + patch.object(self.m.State, 'refresh') as render: + self.m.DocumentOpened().notify(types.SimpleNamespace(document=self.doc)) + state = self.m.state_for(self.doc) + self.assertEqual(state.items, self.stored.items) + self.assertEqual(state.offsets, self.stored.offsets) + self.assertEqual(state.hidden_ids, {'m1'}) + self.assertTrue(state.restore_requested) + self.assertIsNone(state.fingerprint) + self.assertIs(state.design, self.design) + self.m.APP.fireCustomEvent.assert_called_once_with(self.m.UPDATE_EVENT_ID) + render.assert_not_called() + + def test_startup_reads_existing_documents_and_coalesces_restore(self): + with patch.object(self.m, 'load_state', return_value=self.stored), \ + patch.object(self.m.State, 'refresh') as render: + self.m.restore_open_documents() + self.m.restore_open_documents() + self.assertEqual(len(self.m.STATES), 1) + self.assertTrue(self.m.state_for(self.doc).restore_requested) + self.m.APP.fireCustomEvent.assert_called_once() + render.assert_not_called() + + def test_non_design_does_not_create_or_queue_state(self): + self.doc.products.itemByProductType.return_value = None + self.m.DocumentOpened().notify(types.SimpleNamespace(document=self.doc)) + self.assertEqual(self.m.STATES, []) + self.m.APP.fireCustomEvent.assert_not_called() + + def test_background_document_loaded_without_queue_for_wrong_active_document(self): + self.m.APP.activeDocument = object() + with patch.object(self.m, 'load_state', return_value=self.stored): + self.m.DocumentOpened().notify(types.SimpleNamespace(document=self.doc)) + self.assertTrue(self.m.state_for(self.doc).restore_requested) + self.m.APP.fireCustomEvent.assert_not_called() + + def test_saved_or_activated_never_requests_new_restore(self): + self.state.restore_requested = False + self.state.removed_for_save = True + self.m.STATES.append(self.state) + self.state.refresh = Mock() + for mode in ('saved', 'activated'): + self.m.DocumentEvent(mode).notify(types.SimpleNamespace(document=self.doc)) + self.assertFalse(self.state.restore_requested) + self.m.APP.fireCustomEvent.assert_not_called() + self.state.refresh.assert_not_called() + + def test_drawing_open_retains_pending_definition_without_direct_render(self): + self.m.UI.activeWorkspace.id = 'FusionDocumentationEnvironment' + with patch.object(self.m, 'load_state', return_value=self.stored), \ + patch.object(self.m.State, 'refresh') as render: + self.m.DocumentOpened().notify(types.SimpleNamespace(document=self.doc)) + self.assertTrue(self.m.state_for(self.doc).restore_requested) + render.assert_not_called() + + def test_activation_only_queues_existing_restore_request(self): + self.m.DocumentActivated().notify(types.SimpleNamespace(document=self.doc)) + self.assertEqual(self.m.STATES, []) + self.m.APP.fireCustomEvent.assert_not_called() + with patch.object(self.m, 'load_state', return_value=self.stored): + self.m.state_for_document(self.doc) + self.m.DocumentActivated().notify(types.SimpleNamespace(document=self.doc)) + self.m.APP.fireCustomEvent.assert_called_once() + self.m.UPDATE_PENDING = False + self.m.APP.fireCustomEvent.reset_mock() + self.m.state_for(self.doc).restore_requested = False + self.m.DocumentActivated().notify(types.SimpleNamespace(document=self.doc)) + self.m.APP.fireCustomEvent.assert_not_called() + + def test_startup_corrupt_document_cannot_block_valid_document(self): + corrupt_design = object() + corrupt = types.SimpleNamespace(isValid=True, products=types.SimpleNamespace( + itemByProductType=lambda _: corrupt_design)) + self.m.APP.documents = [corrupt, self.doc] + def load(design): + if design is corrupt_design: + raise ValueError('Future schema') + return self.stored + with patch.object(self.m, 'load_state', side_effect=load): + self.m.restore_open_documents() + self.assertIsNone(self.m.state_for(corrupt)) + self.assertEqual(self.m.state_for(self.doc).items, self.stored.items) + self.m.APP.fireCustomEvent.assert_called_once() + self.m.APP.log.assert_called_once() + + def test_saved_state_blocks_queued_initial_restore(self): + with patch.object(self.m, 'load_state', return_value=self.stored): + state = self.m.state_for_document(self.doc) + self.assertTrue(state.restore_requested) + state.groups = [types.SimpleNamespace(isValid=True, deleteMe=Mock(return_value=True))] + with patch.object(self.m, 'geometry_fingerprint', return_value=('saved',)): + self.m.DocumentEvent('saving').notify(types.SimpleNamespace(document=self.doc)) + self.assertFalse(state.restore_requested) + self.m.DocumentActivated().notify(types.SimpleNamespace(document=self.doc)) + self.m.APP.fireCustomEvent.assert_not_called() + + def test_initial_restore_waits_out_drawing_then_renders_current_model(self): + self.stored.items.append(('m2', 'radius', ('another-edge',))) + self.stored.next_id = 3 + with patch.object(self.m, 'load_state', return_value=self.stored): + self.m.DocumentOpened().notify(types.SimpleNamespace(document=self.doc)) + state = self.m.state_for(self.doc) + self.m.UI.activeWorkspace.id = 'FusionDocumentationEnvironment' + with patch.object(self.m, 'geometry_fingerprint', return_value=('initial',)), \ + patch.object(self.m, 'resolve', return_value=object()), \ + patch.object(self.m.renderer, 'render', return_value=object()) as render, \ + patch.object(self.m, 'load_state', return_value=self.stored): + self.m.UpdateDimensions().notify(None) + render.assert_not_called() + self.assertTrue(state.restore_requested) + self.m.UI.activeWorkspace.id = 'FusionSolidEnvironment' + self.m.DocumentActivated().notify(types.SimpleNamespace(document=self.doc)) + self.m.UpdateDimensions().notify(None) + render.assert_called_once() # Hidden m1 is retained; visible m2 renders. + self.assertFalse(state.restore_requested) + self.assertEqual(state.fingerprint, ('initial',)) + self.assertEqual(state.hidden_ids, {'m1'}) diff --git a/tests/test_event_scope.py b/tests/test_event_scope.py new file mode 100644 index 0000000..01877cb --- /dev/null +++ b/tests/test_event_scope.py @@ -0,0 +1,55 @@ +import gc +import unittest +import weakref + +from Mesora.dimensions.event_scope import EventScope + + +class Event: + def __init__(self): self.handlers = [] + def add(self, handler): self.handlers.append(handler); return True + def remove(self, handler): self.handlers.remove(handler); return True + + +class Handler: + def __init__(self, context): self.context = context + + +class Context: + pass + + +class EventScopeTest(unittest.TestCase): + def test_destroyed_command_releases_context_without_touching_other_command(self): + first, second = EventScope(), EventScope() + context = Context() + ref = weakref.ref(context) + event, other = Event(), Event() + first.bind(event, Handler(context)) + second.bind(other, Handler(Context())) + del context + first.close(destroyed=True) + gc.collect() + self.assertIsNone(ref()) + self.assertEqual(event.handlers, []) + self.assertEqual(len(other.handlers), 1) + second.close() + + def test_active_detach_failure_is_retained_for_retry(self): + scope, event = EventScope(), Event() + handler = Handler(Context()) + scope.bind(event, handler) + remove = event.remove + event.remove = lambda handler: False + self.assertFalse(scope.close()) + self.assertEqual(len(scope.bindings), 1) + event.remove = remove + self.assertTrue(scope.close()) + + def test_destroyed_invalid_event_does_not_keep_deleted_context(self): + scope, event = EventScope(), Event() + scope.bind(event, Handler(Context())) + def invalid(handler): raise RuntimeError('Deleted Fusion event') + event.remove = invalid + self.assertTrue(scope.close(destroyed=True)) + self.assertEqual(scope.bindings, []) diff --git a/tests/test_label_layout.py b/tests/test_label_layout.py new file mode 100644 index 0000000..13eda39 --- /dev/null +++ b/tests/test_label_layout.py @@ -0,0 +1,33 @@ +import unittest +from Mesora.dimensions.label_layout import choose_caption, projected_caption_size, projection_scale + + +class CaptionLayoutTest(unittest.TestCase): + def test_retina_projection_uses_logical_viewport_coordinate_scale(self): + self.assertEqual(projection_scale(1710, 692, (1709, 692)), 2) + self.assertEqual(projection_scale(1710, 692, (855, 346)), 1) + self.assertEqual(projection_scale(1000, 600, (0, 0)), 1) + + def test_rotated_caption_bounds_cover_full_baseline_height(self): + width, height = projected_caption_size(200, 20, (1, 1), (-1, 1)) + self.assertAlmostEqual(width, 220/2**.5) + self.assertAlmostEqual(height, 220/2**.5) + + def test_layout_keeps_caption_inside_viewport(self): + selected, _ = choose_caption(100, 20, [], + [((10, 50), 'clipped'), ((60, 50), 'inside')], bounds=(0, 0, 200, 200)) + self.assertEqual(selected, 'inside') + def test_coincident_captions_move_to_distinct_rectangles(self): + occupied = [] + first, rect = choose_caption(100, 20, occupied, [((0, 0), 'original')]) + occupied.append(rect) + second, other = choose_caption(100, 20, occupied, + [((0, 0), 'overlap'), ((0, 35), 'clear')]) + self.assertEqual((first, second), ('original', 'clear')) + self.assertGreater(other[1], rect[3]) + + def test_long_captions_do_not_accept_small_horizontal_displacement(self): + _, rect = choose_caption(200, 20, [], [((0, 0), None)]) + selected, _ = choose_caption(200, 20, [rect], + [((50, 0), 'still-overlaps'), ((220, 0), 'clear')]) + self.assertEqual(selected, 'clear') diff --git a/tests/test_missing_references.py b/tests/test_missing_references.py new file mode 100644 index 0000000..fda0575 --- /dev/null +++ b/tests/test_missing_references.py @@ -0,0 +1,79 @@ +"""An unavailable reference stays editable without blocking other measurements.""" +import importlib +import sys +import types +import unittest +from unittest.mock import patch + +from test_table_command import Input, Inputs, Table + + +class MissingReferencesTest(unittest.TestCase): + def setUp(self): + core = types.ModuleType('adsk.core') + core.Application = types.SimpleNamespace(get=lambda: types.SimpleNamespace(userInterface=None)) + core.DropDownStyles = types.SimpleNamespace(TextListDropDownStyle=1) + core.ValueInput = types.SimpleNamespace(createByReal=lambda value: value) + for name in ('CommandCreatedEventHandler', 'InputChangedEventHandler', 'ValidateInputsEventHandler', + 'CommandEventHandler', 'DocumentEventHandler', 'CameraEventHandler', 'WorkspaceEventHandler', 'ApplicationCommandEventHandler', 'CustomEventHandler'): + setattr(core, name, type(name, (), {})) + adsk = types.ModuleType('adsk'); adsk.core = core; adsk.fusion = types.ModuleType('adsk.fusion') + self.modules = patch.dict(sys.modules, {'adsk': adsk, 'adsk.core': core, 'adsk.fusion': adsk.fusion}) + self.modules.start() + sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) + self.m = importlib.import_module('Mesora.Mesora') + self.face = types.SimpleNamespace(objectType='adsk::fusion::BRepFace', area=5, edges=[]) + self.state = types.SimpleNamespace(next_id=3, live_preview=[], items=[('m1', 'area', ('missing',)), ('m2', 'area', ('good',))], + hidden_ids={'m1'}, offsets={'m1': 2.5}, design=types.SimpleNamespace(unitsManager=types.SimpleNamespace(defaultLengthUnits='mm'))) + def resolve(design, ref): + if ref == 'missing': raise ValueError('Deleted face') + return self.face + self.patches = [patch.object(self.m, 'current_state', return_value=self.state), + patch.object(self.m, 'resolve', side_effect=resolve), + patch.object(self.m, 'reference_for', side_effect=lambda e: e), + patch.object(self.m, 'measure', return_value=5), + patch.object(self.m, 'format_value', return_value='5 mm²')] + for item in self.patches: item.start() + self.c = self.m.BatchCommand() + self.c.inputs = Inputs(); self.c.table = Table(); self.c.picker = Input() + self.c.editor_heading = Input(); self.c.active_row = self.c.active_selection = None + self.c.load_existing() + + def tearDown(self): + for item in reversed(self.patches): item.stop() + sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) + self.modules.stop() + + def test_broken_row_is_retained_and_healthy_row_loads(self): + broken, _, text = self.c.row_inputs['m1'] + self.assertEqual(broken.unresolved_refs, ('missing',)) + self.assertEqual(broken.kind, 'area') + self.assertFalse(broken.visible) + self.assertEqual(broken.offset, 2.5) + self.assertIn('Reference unavailable', text.text) + self.assertTrue(self.c.row_inputs['m2'][0].complete) + self.assertEqual(self.c.sync_batch(), ([], set())) + self.assertEqual([r.id for r in self.c.batch.rows], ['m1', 'm2']) + args = types.SimpleNamespace(areInputsValid=False) + self.m.Validate(self.c).notify(args) + self.assertTrue(args.areInputsValid) + + def test_replace_geometry_recovers_broken_row(self): + self.c.open_editor('m1') + self.c.picker.addSelection(self.face) + self.c.accept_selection() + draft, _, text = self.c.row_inputs['m1'] + self.assertIsNone(draft.unresolved_refs) + self.assertTrue(draft.complete) + self.assertEqual(text.text, '5 mm²') + + def test_clear_and_remove_are_explicit_deletion(self): + draft = self.c.row_inputs['m1'][0] + draft.set_first(None); draft.set_second(None) + self.c.refresh_row('m1') + self.assertIsNone(draft.unresolved_refs) + self.c.sync_batch() + self.assertEqual([r.id for r in self.c.batch.rows], ['m2']) + self.c.table.selectedRow = 1 + self.c.remove_selected() + self.assertNotIn('m2', self.c.row_inputs) diff --git a/tests/test_owned_lifecycle.py b/tests/test_owned_lifecycle.py new file mode 100644 index 0000000..d321efb --- /dev/null +++ b/tests/test_owned_lifecycle.py @@ -0,0 +1,165 @@ +"""Reproduce Undo's actual-group/tracked-group mismatch through real cleanup.""" +import types +import unittest +from unittest.mock import Mock, patch +import test_visibility_lifecycle as lifecycle + + +class Groups: + def __init__(self): self.values = [] + @property + def count(self): return len(self.values) + def item(self, index): return self.values[index] + + +class Group: + def __init__(self, collection, ident, deletes=True): + self.collection, self.id, self.deletes = collection, ident, deletes + self.isValid = True + collection.values.append(self) + def deleteMe(self): + if not self.deletes: return False + self.collection.values.remove(self) + self.isValid = False + return True + + +class OwnedLifecycleTest(unittest.TestCase): + tearDown = lifecycle.LifecycleTest.tearDown + + def setUp(self): + lifecycle.LifecycleTest.setUp(self) + self.ownership_patch.stop() # Exercise the actual renderer ownership API. + self.owned_collection_patch.stop() + self.groups = Groups() + self.state.design = types.SimpleNamespace(rootComponent=types.SimpleNamespace(customGraphicsGroups=self.groups)) + self.m.UI.messageBox = Mock() + self.prefix = self.m.renderer.OWNERSHIP_PREFIX + + def test_refresh_reconciles_undo_revived_group_before_render_preserving_foreign(self): + old_wrapper = Group(self.groups, self.prefix + 'm1') + old_wrapper.deleteMe() + revived = Group(self.groups, old_wrapper.id) # Fusion returns a fresh wrapper. + self.assertIsNot(old_wrapper, revived) + foreign = Group(self.groups, 'other.addin.graphics') + self.state.groups = [] + self.state.items = [('m1', 'radius', ('edge',))] + def render(*args, **kwargs): + self.assertFalse(revived.isValid, 'Undo-restored group must be removed before adding its replacement') + return Group(self.groups, self.prefix + 'new') + with patch.object(self.m, 'resolve', return_value=object()), \ + patch.object(self.m.renderer, 'render', side_effect=render), \ + patch.object(self.m, 'geometry_fingerprint', return_value=('current',)): + self.assertEqual(self.state.refresh(), []) + self.assertEqual(len(self.state.groups), 1) + self.assertEqual(len(self.m.renderer.owned_groups(self.state.design)), 1) + self.assertEqual(self.groups.count, 2) + self.assertTrue(foreign.isValid) + self.assertIn(self.state.groups[0], self.groups.values) + + def test_execute_preserves_staged_groups_and_foreign_but_removes_revived(self): + revived = Group(self.groups, self.prefix + 'undo-restored') + foreign = Group(self.groups, 'foreign') + row = types.SimpleNamespace(id='m1', kind='radius', entities=('edge',), visible=True) + context = types.SimpleNamespace(clear_preview=Mock(), visible=True, + batch=types.SimpleNamespace(rows=[row], next_id=2)) + created = [] + def render(*args, **kwargs): + group = Group(self.groups, self.prefix + 'staged') + created.append(group) + return group + with patch.object(self.m, 'current_state', return_value=self.state), \ + patch.object(self.m, 'reference_for', side_effect=lambda entity: entity), \ + patch.object(self.m, 'resolve', side_effect=lambda design, ref: ref), \ + patch.object(self.m.renderer, 'render', side_effect=render), \ + patch.object(self.m, 'geometry_fingerprint', return_value=('current',)): + self.m.Execute('add', context).notify(None) + self.assertFalse(revived.isValid) + self.assertTrue(foreign.isValid) + self.assertEqual(self.state.groups, created) + self.assertTrue(created[0].isValid) + self.assertEqual(self.groups.count, 2) + self.assertEqual(len(self.m.renderer.owned_groups(self.state.design)), 1) + + def test_save_cleans_revived_owned_group_even_when_runtime_tracks_none(self): + revived = Group(self.groups, self.prefix + 'revived') + foreign = Group(self.groups, 'foreign') + self.assertEqual(self.state.groups, []) + args = types.SimpleNamespace(document=self.doc, isOperationCancelled=False) + with patch.object(self.m, 'geometry_fingerprint', return_value=('saved',)): + self.m.DocumentEvent('saving').notify(args) + self.assertFalse(args.isOperationCancelled) + self.assertFalse(revived.isValid) + self.assertTrue(foreign.isValid) + self.assertEqual(self.groups.values, [foreign]) + self.assertTrue(self.state.removed_for_save) + + def test_save_cleanup_failure_retains_revived_group_cancels_then_retry_succeeds(self): + revived = Group(self.groups, self.prefix + 'revived', deletes=False) + foreign = Group(self.groups, 'foreign') + args = types.SimpleNamespace(document=self.doc, isOperationCancelled=False) + self.m.DocumentEvent('saving').notify(args) + self.assertTrue(args.isOperationCancelled) + self.assertEqual(self.state.groups, [revived]) + self.assertTrue(revived.isValid) + revived.deletes = True + retry = types.SimpleNamespace(document=self.doc, isOperationCancelled=False) + with patch.object(self.m, 'geometry_fingerprint', return_value=('saved',)): + self.m.DocumentEvent('saving').notify(retry) + self.assertFalse(retry.isOperationCancelled) + self.assertEqual(self.state.groups, []) + self.assertEqual(self.groups.values, [foreign]) + self.assertTrue(self.state.removed_for_save) + + def test_unchanged_metadata_and_geometry_reconcile_undo_restored_wrapper(self): + previous = Group(self.groups, self.prefix + 'before-no-op-edit') + previous.deleteMe() + revived = Group(self.groups, previous.id) + foreign = Group(self.groups, 'foreign') + invalid_tracked = types.SimpleNamespace(id=self.prefix + 'after-no-op-edit', isValid=False) + self.state.items = [('m1', 'radius', ('edge',))] + self.state.groups = [invalid_tracked] + self.state.fingerprint = ('unchanged',) + self.state.restore_requested = False + def render(*args, **kwargs): + self.assertFalse(revived.isValid) + return Group(self.groups, self.prefix + 'reconciled') + with patch.object(self.m, 'resolve', return_value=object()), \ + patch.object(self.m, 'geometry_fingerprint', return_value=('unchanged',)), \ + patch.object(self.m.renderer, 'render', side_effect=render): + self.m.UpdateDimensions().notify(None) + self.assertFalse(revived.isValid, 'Unchanged metadata must not bypass restored-group reconciliation') + self.assertEqual(len(self.state.groups), 1) + self.assertTrue(self.state.groups[0].isValid) + self.assertEqual(self.m.renderer.owned_groups(self.state.design), self.state.groups) + self.assertTrue(foreign.isValid) + self.assertEqual(self.groups.count, 2) + + def test_after_save_equal_empty_owned_and_tracked_sets_do_not_redraw(self): + foreign = Group(self.groups, 'foreign') + self.state.items = [('m1', 'radius', ('edge',))] + self.state.groups = [] + self.state.fingerprint = ('saved',) + self.state.removed_for_save = True + self.state.restore_requested = False + with patch.object(self.m, 'geometry_fingerprint', return_value=('saved',)), \ + patch.object(self.m.renderer, 'render') as render: + self.m.UpdateDimensions().notify(None) + render.assert_not_called() + self.assertEqual(self.state.groups, []) + self.assertEqual(self.groups.values, [foreign]) + self.assertTrue(self.state.removed_for_save) + + def test_empty_definitions_still_remove_untracked_owned_group(self): + revived = Group(self.groups, self.prefix + 'revived-with-empty-definitions') + foreign = Group(self.groups, 'foreign') + self.state.items = [] + self.state.groups = [] + self.state.restore_requested = False + self.state.fingerprint = ('empty',) + with patch.object(self.m, 'geometry_fingerprint', return_value=('empty',)), \ + patch.object(self.m.renderer, 'render') as render: + self.m.UpdateDimensions().notify(None) + self.assertFalse(revived.isValid) + self.assertEqual(self.groups.values, [foreign]) + render.assert_not_called() diff --git a/tests/test_renderer_model_plane.py b/tests/test_renderer_model_plane.py index d9275b6..740cb32 100644 --- a/tests/test_renderer_model_plane.py +++ b/tests/test_renderer_model_plane.py @@ -51,6 +51,155 @@ def getEndPoints(self): return True, Point(0, 0, 0), Point(10, 0, 0) class RendererPlaneTest(unittest.TestCase): + def test_wide_orbit_readability_rotates_about_exact_caption_world_anchor(self): + group = Group() + anchor = (4, 5, 6) + text = types.SimpleNamespace(width=10) + with FakeAPI() as renderer: + renderer._LABELS[id(group)] = (text, anchor, (1,0,0), (0,1,0), 1, None, False) + renderer._CAPTIONS[id(group)] = {'base': (0,0,0), 'placed': anchor, 'leader': None} + arc = types.SimpleNamespace(coordinates=('model-fixed angle arc',)) + renderer._ANGLES[id(group)] = (arc, (0,0,0), (1,0,0), (0,1,0), 1.57, 0) + for eye in ((0,0,10), (10,0,.01), (-10,0,-.01), (0,-10,.01), (0,0,-10)): + camera = types.SimpleNamespace(eye=Point(*eye), upVector=Point(0,1,0)) + renderer.orient_text(group, camera) + matrix = text.transform + x, y, _ = matrix.axes + # The actual CustomGraphicsViewScale pivot is (width/2,-size*.25,0). + pivot = tuple(getattr(matrix.origin, axis) + getattr(x, axis)*5 - getattr(y, axis)*.25 + for axis in ('x', 'y', 'z')) + for actual, expected in zip(pivot, anchor): + self.assertAlmostEqual(actual, expected) + self.assertEqual(renderer._LABELS[id(group)][1], anchor) + self.assertEqual(arc.coordinates, ('model-fixed angle arc',)) + + def test_smooth_view_change_keeps_clear_previous_world_caption(self): + groups = [Group(), Group()] + camera = types.SimpleNamespace(eye=Point(0,0,10), upVector=Point(0,1,0)) + scale = [100] + viewport = types.SimpleNamespace(modelToViewSpace=lambda p: Point(p.x*scale[0], p.y*scale[0], 0)) + with FakeAPI() as renderer: + for group in groups: + renderer._LABELS[id(group)] = (types.SimpleNamespace(width=10, color=(0,0,0,255)), + (0,0,0), (1,0,0), (0,1,0), 1, None, False) + renderer.arrange_labels(groups, camera, viewport) + previous = renderer._LABELS[id(groups[1])][1] + scale[0] = 101 # Smooth orbit-like projection change, no new collision. + camera.eye.x = .01 + renderer.arrange_labels(groups, camera, viewport) + self.assertEqual(renderer._LABELS[id(groups[1])][1], previous) + scale[0] = 40 # Actual projected captions now collide, so reflow is required. + renderer.arrange_labels(groups, camera, viewport) + self.assertNotEqual(renderer._LABELS[id(groups[1])][1], previous) + + def test_orienting_angle_does_not_resize_arc_or_move_anchor(self): + group = Group() + camera = types.SimpleNamespace(eye=Point(0,0,10), upVector=Point(0,1,0)) + with FakeAPI() as renderer: + renderer._LABELS[id(group)] = (types.SimpleNamespace(width=1), (1,1,0), + (1,0,0), (0,1,0), 1, None, False) + lines = types.SimpleNamespace(coordinates=('original arc',)) + renderer._ANGLES[id(group)] = (lines, (0,0,0), (1,0,0), (0,1,0), 1.57, 0) + renderer.orient_text(group, camera) + camera.eye.x = 1 + renderer.orient_text(group, camera) + self.assertEqual(lines.coordinates, ('original arc',)) + self.assertEqual(renderer._LABELS[id(group)][1], (1,1,0)) + + def test_retina_batch_projects_backing_pixels_into_logical_caption_bounds(self): + groups = [Group(), Group()] + camera = types.SimpleNamespace(eye=Point(0,0,10), target=Point(0,0,0), upVector=Point(0,1,0)) + viewport = types.SimpleNamespace(width=1000, height=600, + modelToViewSpace=lambda p: Point(1000+p.x*200, 600+p.y*200, 0)) + with FakeAPI() as renderer: + for group in groups: + renderer._LABELS[id(group)] = (types.SimpleNamespace(width=10, color=(0,0,0,255)), + (0,0,0), (1,0,0), (0,1,0), 1, None, False) + renderer.arrange_labels(groups, camera, viewport) + anchors = [renderer._LABELS[id(group)][1] for group in groups] + self.assertEqual(anchors[0], (0,0,0)) + self.assertAlmostEqual(abs(anchors[1][1]), .32) + + def test_batch_captions_separate_and_relayout_does_not_accumulate_drift(self): + groups = [Group(), Group(), Group()] + camera = types.SimpleNamespace(eye=Point(0,0,10), upVector=Point(0,1,0)) + viewport = types.SimpleNamespace(modelToViewSpace=lambda p: Point(p.x*100, p.y*100, 0)) + with FakeAPI() as renderer: + for group in groups: + text = types.SimpleNamespace(width=10, color=(0,0,0,255)) + renderer._LABELS[id(group)] = (text, (0,0,0), (1,0,0), (0,1,0), 1, None, False) + renderer.arrange_labels(groups, camera, viewport) + anchors = [renderer._LABELS[id(group)][1] for group in groups] + self.assertEqual(anchors[0], (0,0,0)) + self.assertGreaterEqual(abs(anchors[1][1])*100, 30) + self.assertNotEqual(anchors[1], anchors[2]) + self.assertTrue(renderer._CAPTIONS[id(groups[1])]['leader'].isVisible) + renderer.arrange_labels(groups, camera, viewport) + self.assertEqual(anchors, [renderer._LABELS[id(group)][1] for group in groups]) + groups[0].isVisible = False + renderer.arrange_labels(groups, camera, viewport) + self.assertEqual(renderer._LABELS[id(groups[1])][1], anchors[1]) + self.assertTrue(renderer._CAPTIONS[id(groups[1])]['leader'].isVisible) + + def test_edge_on_caption_plane_uses_reachable_direction_without_leaving_plane(self): + groups = [Group(), Group()] + camera = types.SimpleNamespace(eye=Point(10,0,1), upVector=Point(0,0,1)) + viewport = types.SimpleNamespace(modelToViewSpace=lambda p: Point(p.y*100, p.z*100, 0)) + with FakeAPI() as renderer: + for group in groups: + renderer._LABELS[id(group)] = (types.SimpleNamespace(width=10, color=(0,0,0,255)), + (0,0,0), (1,0,0), (0,1,0), 1, None, False) + renderer.arrange_labels(groups, camera, viewport) + first, second = [renderer._LABELS[id(group)][1] for group in groups] + self.assertEqual(second[2], 0) # The XY dimension plane is preserved. + self.assertGreaterEqual(abs(second[1]-first[1])*100, 170) + + def test_owned_cleanup_retains_staged_groups_and_reports_failed_deletion(self): + with FakeAPI() as renderer: + staged, failed, successful, unrelated = (Group() for _ in range(4)) + for group in (staged, failed, successful): + group.id = renderer.OWNERSHIP_PREFIX + str(id(group)) + unrelated.id = '' + deleted = [] + staged.deleteMe = lambda: self.fail('Staged group must survive cleanup') + unrelated.deleteMe = lambda: self.fail('Untagged group belongs to another owner') + failed.deleteMe = lambda: False + successful.deleteMe = lambda: deleted.append(successful) or True + groups = [staged, failed, successful, unrelated] + collection = types.SimpleNamespace(count=len(groups), item=lambda i: groups[i]) + design = types.SimpleNamespace(rootComponent=types.SimpleNamespace(customGraphicsGroups=collection)) + renderer._LABELS[id(failed)] = 'retained failure bookkeeping' + renderer._LABELS[id(successful)] = 'removed success bookkeeping' + self.assertEqual(renderer.erase_owned(design, keep=[staged]), [failed]) + self.assertEqual(deleted, [successful]) + self.assertIn(id(failed), renderer._LABELS) + self.assertNotIn(id(successful), renderer._LABELS) + + def test_undo_restored_owned_groups_are_cleaned_without_other_addins(self): + owned = Group() + owned.id = '4FusionLab.Mesora.89072f8c-cdca-48bf-8a2a-440c9ae898e6.graphics.v1:restored' + other = Group() + other.id = 'AnotherAddon.graphics' + groups = [owned, other] + def delete_owned(): + groups.remove(owned) + owned.isValid = False + return True + owned.deleteMe = delete_owned + collection = types.SimpleNamespace(count=2, item=lambda i: groups[i]) + design = types.SimpleNamespace(rootComponent=types.SimpleNamespace(customGraphicsGroups=collection)) + with FakeAPI() as renderer: + self.assertEqual(renderer.erase_owned(design), []) + self.assertEqual(groups, [other]) + + def test_clearance_signature_invalidates_internal_body_changes(self): + body = types.SimpleNamespace(revisionId='before', + boundingBox=types.SimpleNamespace(minPoint=Point(0,0,0), maxPoint=Point(1,1,1))) + with FakeAPI() as renderer, patch.object(renderer, 'visible_solids', return_value=[body]): + before = renderer.obstacle_signature(object()) + body.revisionId = 'after' # A hole changes without changing bounds. + self.assertNotEqual(before, renderer.obstacle_signature(object())) + def test_angle_layout_tracks_screen_scale_and_extends_short_sides(self): import math with FakeAPI() as renderer: @@ -75,6 +224,9 @@ def test_angle_draws_arc_with_degree_units(self): self.assertFalse(renderer._LABELS[id(group)][-1]) self.assertAlmostEqual(abs(renderer.dot(renderer._LABELS[id(group)][2], (-2**-.5, 2**-.5, 0))), 1) self.assertEqual(group.text.caption, 'm1: deg') + self.assertTrue(group.id.startswith(renderer.OWNERSHIP_PREFIX)) + self.assertFalse(group.isChildrenSelectable) + self.assertFalse(group.isSelectable) self.assertGreater(len(group.lines.coords), 24) self.assertEqual(group.lines.coords[:3], (0,0,0)) diff --git a/tests/test_runtime_persistence.py b/tests/test_runtime_persistence.py new file mode 100644 index 0000000..db1eddc --- /dev/null +++ b/tests/test_runtime_persistence.py @@ -0,0 +1,111 @@ +import json +import unittest +from types import SimpleNamespace + +from Mesora.dimensions.model import Dimension, EntityReference, KINDS, SchemaError, serialize +from Mesora.dimensions.persistence import GROUP, NAME, MAX_BYTES, PersistenceError, save +from Mesora.dimensions.runtime_persistence import load_state, save_state +class Attributes: + def __init__(self): + self.data = {} + self.writes = 0 + + def itemByName(self, group, name): + return self.data.get((group, name)) + + def add(self, group, name, value): + self.writes += 1 + self.data[group, name] = SimpleNamespace(value=value) + return self.data[group, name] + + +class RuntimePersistenceTest(unittest.TestCase): + def setUp(self): + self.design = SimpleNamespace(attributes=Attributes()) + + def test_all_runtime_types_restore_references_settings_and_next_id(self): + refs = (EntityReference('native', 'occurrence'), EntityReference('second')) + items = [('m' + str(i), kind, refs[:count]) + for i, (kind, count) in enumerate(KINDS.items(), 1)] + offsets = {ident: i * .2 for i, (ident, _, _) in enumerate(items)} + self.assertTrue(save_state(self.design, items, offsets, {'m2'}, False)) + restored = load_state(self.design) + self.assertEqual(restored.items, items) + self.assertEqual(restored.offsets, offsets) + self.assertEqual(restored.hidden_ids, {'m2'}) + self.assertFalse(restored.visible) + self.assertEqual(restored.next_id, 8) + payload = self.design.attributes.itemByName(GROUP, NAME).value + self.assertNotIn('value', json.loads(payload)['dimensions'][0]) + writes = self.design.attributes.writes + self.assertFalse(save_state(self.design, items, offsets, {'m2'}, False)) + self.assertEqual(self.design.attributes.writes, writes) + + def test_legacy_uuid_references_migrate_without_geometry_or_data_loss(self): + dimension = Dimension.create('distance', [EntityReference('a'), EntityReference('b', 'occ')]) + data = json.loads(serialize([dimension])) + data['schema_version'] = 1 + self.design.attributes.add(GROUP, NAME, json.dumps(data)) + restored = load_state(self.design) + self.assertEqual(restored.items, [(dimension.id, dimension.kind, dimension.references)]) + self.assertEqual(restored.next_id, 1) + save_state(self.design, restored.items, restored.offsets, restored.hidden_ids, restored.visible) + self.assertEqual(json.loads(self.design.attributes.itemByName(GROUP, NAME).value)['schema_version'], 2) + + def test_clear_round_trip_and_new_empty_document_is_not_modified(self): + self.assertFalse(save_state(self.design, [], {}, set(), True)) + save_state(self.design, [('m12', 'radius', (EntityReference('a'),))], {}, set(), True) + self.assertTrue(save_state(self.design, [], {}, set(), True)) + self.assertEqual(load_state(self.design).items, []) + + def test_unrecognized_settings_are_not_silently_destroyed(self): + dimension = Dimension.create('radius', [EntityReference('a')], {'future_setting': 12}) + save(self.design, [dimension], True) + payload = self.design.attributes.itemByName(GROUP, NAME).value + with self.assertRaises(SchemaError): + save_state(self.design, [], {}, set(), True) + self.assertEqual(self.design.attributes.itemByName(GROUP, NAME).value, payload) + + def test_malformed_future_and_unknown_data_are_never_overwritten(self): + valid = json.loads(serialize([Dimension('m1', 'radius', (EntityReference('a'),))])) + variants = ['{broken', '{"schema_version":99}', + '{"schema_version":2,"schema_version":1}', + json.dumps(dict(valid, future_data=True))] + for location, invalid in [('placement', {'offset': float('nan')}), + ('placement', {'offset': True}), + ('display', {'visible': 'yes'})]: + candidate = json.loads(json.dumps(valid)) + candidate['dimensions'][0][location] = invalid + variants.append(json.dumps(candidate)) + for payload in variants: + with self.subTest(payload=payload): + self.design.attributes.add(GROUP, NAME, payload) + with self.assertRaises(SchemaError): + save_state(self.design, [], {}, set(), True) + self.assertEqual(self.design.attributes.itemByName(GROUP, NAME).value, payload) + + def test_oversized_existing_data_is_preserved_and_other_document_is_isolated(self): + payload = 'x' * (MAX_BYTES + 1) + self.design.attributes.add(GROUP, NAME, payload) + with self.assertRaises(PersistenceError): + load_state(self.design) + with self.assertRaises(PersistenceError): + save_state(self.design, [], {}, set(), True) + self.assertEqual(self.design.attributes.itemByName(GROUP, NAME).value, payload) + self.assertEqual(load_state(SimpleNamespace(attributes=Attributes())).items, []) + + def test_duplicate_or_unknown_runtime_ids_and_invalid_settings_fail_closed(self): + item = ('m1', 'radius', (EntityReference('a'),)) + for items, offsets, hidden in [([item, item], {}, set()), + ([item], {'m2': 0}, set()), + ([item], {}, {'m2'}), + ([('m0', 'radius', item[2])], {}, set()), + ([item], {'m1': float('inf')}, set())]: + with self.subTest(items=items, offsets=offsets, hidden=hidden): + with self.assertRaises(SchemaError): + save_state(self.design, items, offsets, hidden, True) + self.assertIsNone(self.design.attributes.itemByName(GROUP, NAME)) + + +if __name__ == '__main__': + unittest.main() diff --git a/tests/test_table_command.py b/tests/test_table_command.py index 2dfe1bf..fd27e23 100644 --- a/tests/test_table_command.py +++ b/tests/test_table_command.py @@ -3,7 +3,7 @@ import sys import types import unittest -from unittest.mock import patch +from unittest.mock import Mock, patch class ListItems: @@ -53,7 +53,7 @@ def test_add_focus_select_and_clear_are_independent_per_row(self): core.Application=types.SimpleNamespace(get=lambda:types.SimpleNamespace(userInterface=None)) core.DropDownStyles=types.SimpleNamespace(TextListDropDownStyle=1) core.ValueInput=types.SimpleNamespace(createByReal=lambda value:value) - for n in ('CommandCreatedEventHandler','InputChangedEventHandler','ValidateInputsEventHandler','CommandEventHandler','DocumentEventHandler','CameraEventHandler'): + for n in ('CommandCreatedEventHandler','InputChangedEventHandler','ValidateInputsEventHandler','CommandEventHandler','DocumentEventHandler','CameraEventHandler','WorkspaceEventHandler', 'ApplicationCommandEventHandler', 'CustomEventHandler'): setattr(core,n,type(n,(),{})) adsk=types.ModuleType('adsk'); adsk.core=core; adsk.fusion=fusion with patch.dict(sys.modules,{'adsk':adsk,'adsk.core':core,'adsk.fusion':fusion}): @@ -88,6 +88,21 @@ def test_add_focus_select_and_clear_are_independent_per_row(self): c.open_editor('m1') self.assertEqual(first.offset, 1.25) self.assertEqual(second.offset, 0) + c.command=Mock() + eye=c.inputs.itemById('visible_m1'); eye.id='visible_m1'; eye.value=False + m.Changed(c).notify(types.SimpleNamespace(input=eye)) + self.assertFalse(first.visible) + self.assertTrue(second.visible) + self.assertEqual(first.entities, (face, other)) + global_eye=Input(); global_eye.id='visible_all'; global_eye.value=False + m.Changed(c).notify(types.SimpleNamespace(input=global_eye)) + self.assertFalse(c.visible) + global_eye.value=True + m.Changed(c).notify(types.SimpleNamespace(input=global_eye)) + self.assertTrue(c.visible) + self.assertFalse(first.visible) + self.assertTrue(second.visible) + self.assertEqual(c.command.doExecutePreview.call_count, 3) self.assertEqual(c.picker.entities, [face, other]) c.picker.entities.pop(1); c.accept_selection() self.assertIs(first.first, face); self.assertIsNone(first.second) diff --git a/tests/test_update_fingerprint.py b/tests/test_update_fingerprint.py new file mode 100644 index 0000000..9156807 --- /dev/null +++ b/tests/test_update_fingerprint.py @@ -0,0 +1,61 @@ +import unittest +from types import SimpleNamespace as NS + +from Mesora.dimensions.update_fingerprint import geometry_fingerprint + + +def point(x=0, y=0, z=0): + return NS(x=x, y=y, z=z) + + +class FingerprintTest(unittest.TestCase): + def setUp(self): + self.body = NS(revisionId='v1', isVisible=False, + boundingBox=NS(minPoint=point(), maxPoint=point(5, 5, 5))) + self.entity = NS(isValid=True, objectType='SketchCircle', + worldGeometry=NS(objectType='Circle3D', center=point(), radius=1), + body=self.body) + self.design = NS(rootComponent=NS(bRepBodies=[self.body], allOccurrences=[]), + unitsManager=NS(defaultLengthUnits='mm')) + self.items = [('m1', 'radius', ['token'])] + self.resolve = lambda design, ref: self.entity + + def fingerprint(self): + return geometry_fingerprint(self.design, self.items, self.resolve, lambda kind, entities: 1) + + def test_same_value_sketch_translation_invalidates(self): + before = self.fingerprint() + self.entity.worldGeometry.center.x = 8 + self.assertNotEqual(before, self.fingerprint()) + + def test_hidden_body_internal_change_invalidates_without_bounds_change(self): + before = self.fingerprint() + self.body.revisionId = 'v2' + self.assertNotEqual(before, self.fingerprint()) + + def test_missing_reference_and_restoration_invalidate(self): + before = self.fingerprint() + self.entity.isValid = False + missing = self.fingerprint() + self.assertNotEqual(before, missing) + self.assertEqual(missing, self.fingerprint()) + self.entity.isValid = True + self.assertEqual(before, self.fingerprint()) + + def test_occurrence_move_with_same_value_invalidates(self): + values = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1] + occurrence = NS(isVisible=True, transform2=NS(asArray=lambda: values), bRepBodies=[]) + self.design.rootComponent.allOccurrences = [occurrence] + before = self.fingerprint() + values[3] = 2 + self.assertNotEqual(before, self.fingerprint()) + + def test_reissued_token_does_not_invalidate(self): + before = self.fingerprint() + self.items[0] = ('m1', 'radius', ['another token for same entity']) + self.assertEqual(before, self.fingerprint()) + + def test_units_change_invalidates_caption(self): + before = self.fingerprint() + self.design.unitsManager.defaultLengthUnits = 'in' + self.assertNotEqual(before, self.fingerprint()) diff --git a/tests/test_visibility_lifecycle.py b/tests/test_visibility_lifecycle.py new file mode 100644 index 0000000..54a3e38 --- /dev/null +++ b/tests/test_visibility_lifecycle.py @@ -0,0 +1,352 @@ +"""Command and document lifecycle regressions using the real add-in handlers.""" +import importlib +import sys +import types +import unittest +from unittest.mock import Mock, patch + + +class LifecycleTest(unittest.TestCase): + def setUp(self): + core = types.ModuleType('adsk.core') + fusion = types.ModuleType('adsk.fusion') + core.Application = types.SimpleNamespace(get=lambda: types.SimpleNamespace(userInterface=None)) + for name in ('CommandCreatedEventHandler', 'InputChangedEventHandler', + 'ValidateInputsEventHandler', 'CommandEventHandler', + 'DocumentEventHandler', 'CameraEventHandler', 'WorkspaceEventHandler', 'ApplicationCommandEventHandler', 'CustomEventHandler'): + setattr(core, name, type(name, (), {})) + adsk = types.ModuleType('adsk'); adsk.core = core; adsk.fusion = fusion + self.modules = patch.dict(sys.modules, {'adsk': adsk, 'adsk.core': core, 'adsk.fusion': fusion}) + self.modules.start() + sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) + self.m = importlib.import_module('Mesora.Mesora') + self.storage_patch = patch.object(self.m, 'save_state', return_value=True) + self.storage_patch.start() + # Most lifecycle stubs have no viewport projection/text geometry. + # The caption integration suite supplies behaviorful arrangement separately. + self.arrangement_patch = patch.object(self.m.renderer, 'arrange_labels', return_value=None) + self.arrangement_patch.start() + # These older lifecycle fixtures have no Fusion graphics collection. + # Real tagged ownership reconciliation is covered in test_owned_lifecycle. + self.ownership_patch = patch.object(self.m.renderer, 'erase_owned', return_value=[]) + self.ownership_patch.start() + def fake_owned_groups(design, keep=()): + state = next((entry for entry in self.m.STATES if entry.design is design), None) + result = [] + for group in state.groups if state else []: + if getattr(group, 'isValid', True): + if not hasattr(group, 'id'): + group.id = 'unit-fixture-' + str(id(group)) + result.append(group) + return result + self.owned_collection_patch = patch.object(self.m.renderer, 'owned_groups', side_effect=fake_owned_groups) + self.owned_collection_patch.start() + self.doc = types.SimpleNamespace(isModified=False) + self.m.APP = types.SimpleNamespace(activeDocument=self.doc, + activeViewport=types.SimpleNamespace(camera=object(), refresh=Mock()), log=Mock()) + self.m.UI = types.SimpleNamespace(activeCommand='SelectCommand', activeWorkspace=types.SimpleNamespace(id='FusionSolidEnvironment')) + self.state = self.m.State(self.doc, object()) + self.m.STATES.append(self.state) + self.load_patch = patch.object(self.m, 'load_state', side_effect=lambda design: types.SimpleNamespace( + items=list(self.state.items), offsets=dict(self.state.offsets), hidden_ids=set(self.state.hidden_ids), + visible=self.state.visible, next_id=self.state.next_id)) + self.load_patch.start() + + def tearDown(self): + self.storage_patch.stop() + self.arrangement_patch.stop() + self.ownership_patch.stop() + self.owned_collection_patch.stop() + self.load_patch.stop() + self.modules.stop() + sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) + + def test_drawing_save_stays_clean_without_recreating_graphics(self): + self.state.items = [('m1', 'radius', ('edge',))] + self.state.groups = [types.SimpleNamespace(isValid=True, deleteMe=lambda: True)] + def refresh(): + self.doc.isModified = True + self.state.refresh = Mock(side_effect=refresh) + args = types.SimpleNamespace(document=self.doc) + with patch.object(self.m, 'geometry_fingerprint', return_value=('at-save',)): + self.m.DocumentEvent('saving').notify(args) + self.doc.isModified = False # Fusion has just saved the source for Drawing. + self.m.DocumentEvent('saved').notify(args) + self.assertFalse(self.doc.isModified, 'Post-save rendering restarts the Drawing save loop') + self.state.refresh.assert_not_called() + self.assertTrue(self.state.removed_for_save) + + def test_camera_does_not_touch_graphics_in_drawing(self): + self.m.UI.activeWorkspace.id = 'FusionDrawingEnvironment' + self.state.groups = ['design graphics'] + with patch.object(self.m.renderer, 'orient_text') as orient: + self.m.CameraChanged().notify(types.SimpleNamespace(viewport=self.m.APP.activeViewport)) + orient.assert_not_called() + + def test_refresh_skips_hidden_rows_without_resolving_them(self): + self.state.items = [('m1', 'radius', ('hidden',)), ('m2', 'radius', ('shown',))] + self.state.hidden_ids = {'m1'} + with patch.object(self.m, 'geometry_fingerprint', return_value=('snapshot',)), \ + patch.object(self.m, 'resolve', side_effect=lambda d, r: r) as resolve, \ + patch.object(self.m.renderer, 'render', return_value='graphics'): + self.assertEqual(self.state.refresh(), []) + self.assertEqual(resolve.call_args_list[0].args[1], 'shown') + self.assertEqual(resolve.call_count, 1) + self.assertEqual(len(self.state.items), 2) + + def test_apply_preserves_hidden_definitions_and_global_visibility(self): + rows = [types.SimpleNamespace(id='m1', kind='radius', entities=('a',), visible=False), + types.SimpleNamespace(id='m2', kind='radius', entities=('b',), visible=True)] + ctx = types.SimpleNamespace(batch=types.SimpleNamespace(rows=rows, next_id=3), + clear_preview=Mock(), visible=True) + with patch.object(self.m, 'geometry_fingerprint', return_value=('snapshot',)), \ + patch.object(self.m, 'current_state', return_value=self.state), \ + patch.object(self.m, 'reference_for', side_effect=lambda e: e), \ + patch.object(self.m, 'resolve', side_effect=lambda d, r: r), \ + patch.object(self.m.renderer, 'render', return_value=types.SimpleNamespace( + isValid=True, deleteMe=lambda: True)) as render: + self.m.Execute('add', ctx).notify(None) + self.assertEqual(self.state.hidden_ids, {'m1'}) + self.assertEqual(len(self.state.items), 2) + self.assertEqual(len(self.state.groups), 1) + self.assertEqual(render.call_count, 1) + ctx.visible = False + render.reset_mock() + self.m.Execute('add', ctx).notify(None) + render.assert_not_called() + self.assertFalse(self.state.visible) + self.assertEqual(self.state.hidden_ids, {'m1'}) + self.assertEqual(len(self.state.items), 2) + + def test_hidden_preview_does_not_render_but_keeps_rows(self): + ctx = types.SimpleNamespace(clear_preview=Mock(), visible=False) + args = types.SimpleNamespace(isValidResult=True) + with patch.object(self.m, 'current_state', return_value=self.state), \ + patch.object(self.m.renderer, 'render') as render: + self.m.Preview(ctx).notify(args) + ctx.clear_preview.assert_called_once() + render.assert_not_called() + self.assertFalse(args.isValidResult) + + def test_cancel_restores_committed_visibility_without_applying_draft(self): + group = types.SimpleNamespace(isValid=True, isVisible=False) + self.state.groups = [group] + self.state.hidden_ids = {'m2'} + ctx = types.SimpleNamespace(clear_preview=Mock(), state=self.state, visible=False) + self.m.DestroyPreview(ctx).notify(None) + self.assertTrue(group.isVisible) + self.assertTrue(self.state.visible) + self.assertEqual(self.state.hidden_ids, {'m2'}) + + def test_workspace_and_document_activation_never_restart_the_save_loop(self): + self.state.removed_for_save = True + self.state.refresh = Mock() + self.m.WorkspaceChanged(True).notify(None) + self.assertFalse(self.m.graphics_workspace()) + self.m.UI.activeWorkspace.id = 'FusionDrawingEnvironment' + self.m.WorkspaceChanged(False).notify(None) + self.state.refresh.assert_not_called() + self.m.UI.activeWorkspace.id = 'FusionSolidEnvironment' + self.m.WorkspaceChanged(False).notify(None) + self.m.DocumentEvent('activated').notify(types.SimpleNamespace(document=self.doc)) + self.state.refresh.assert_not_called() + self.assertTrue(self.m.graphics_workspace()) + + + def test_save_cleanup_failure_cancels_document_operation(self): + self.m.UI.messageBox = Mock() + self.state.groups = [types.SimpleNamespace(isValid=True, deleteMe=lambda: False)] + args = types.SimpleNamespace(document=self.doc, isOperationCancelled=False, cancelReason='') + self.m.DocumentEvent('saving').notify(args) + self.assertTrue(args.isOperationCancelled) + self.assertIn('Mesora', args.cancelReason) + self.assertFalse(hasattr(args, 'isSaveCanceled')) + self.assertEqual(len(self.state.groups), 1) + self.assertFalse(self.state.removed_for_save) + + def test_model_end_coalesces_and_excludes_editor_and_mesora(self): + self.state.items = [('m1', 'radius', ('edge',))] + self.m.APP.fireCustomEvent = Mock(return_value=True) + event = self.m.ModelCommandEnded() + self.state.editor_open = True + event.notify(types.SimpleNamespace(commandId='Extrude')) + self.state.editor_open = False + event.notify(types.SimpleNamespace(commandId='MesoraAdd')) + self.m.APP.fireCustomEvent.assert_not_called() + event.notify(types.SimpleNamespace(commandId='Extrude')) + event.notify(types.SimpleNamespace(commandId='Move')) + self.m.APP.fireCustomEvent.assert_called_once_with(self.m.UPDATE_EVENT_ID) + self.assertTrue(self.m.UPDATE_PENDING) + + def test_updates_only_changed_geometry_and_save_never_recreates_same(self): + self.state.items = [('m1', 'radius', ('edge',))] + self.state.fingerprint = ('before',) + self.state.removed_for_save = True + self.state.refresh = Mock() + event = self.m.UpdateDimensions() + with patch.object(self.m, 'geometry_fingerprint', return_value=('before',)): + self.m.UPDATE_PENDING = True + event.notify(None) + self.assertFalse(self.m.UPDATE_PENDING) + self.state.refresh.assert_not_called() + with patch.object(self.m, 'geometry_fingerprint', return_value=('after',)): + event.notify(None) + self.state.refresh.assert_called_once() + + def test_execute_old_cleanup_failure_does_not_persist_and_tracks_staged_failures(self): + self.m.UI.messageBox = Mock() + old = types.SimpleNamespace(isValid=True, deleteMe=Mock(return_value=False)) + self.state.items = [('m1', 'radius', ('old-ref',))] + self.state.groups = [old] + staged = types.SimpleNamespace(isValid=True, deleteMe=Mock(return_value=False)) + row = types.SimpleNamespace(id='m2', kind='radius', entities=('new',), visible=True) + context = types.SimpleNamespace(clear_preview=Mock(), visible=True, + batch=types.SimpleNamespace(rows=[row], next_id=3)) + with patch.object(self.m, 'current_state', return_value=self.state), \ + patch.object(self.m, 'reference_for', side_effect=lambda e: e), \ + patch.object(self.m, 'resolve', side_effect=lambda d, r: r), \ + patch.object(self.m.renderer, 'render', return_value=staged), \ + patch.object(self.m, 'save_state') as save: + self.m.Execute('add', context).notify(None) + save.assert_not_called() + old.deleteMe.assert_called_once() + staged.deleteMe.assert_called_once() + self.assertEqual(self.state.items, [('m1', 'radius', ('old-ref',))]) + self.assertIs(self.state.groups[0], old) + self.assertIs(self.state.live_preview[0], staged) + # Retained references remain reachable by the next save cleanup attempt. + args = types.SimpleNamespace(document=self.doc, isOperationCancelled=False) + self.m.DocumentEvent('saving').notify(args) + self.assertTrue(args.isOperationCancelled) + self.assertEqual(staged.deleteMe.call_count, 2) + + def test_staged_cleanup_exception_retains_reference_for_retry(self): + self.m.UI.messageBox = Mock() + self.state.erase = Mock(side_effect=RuntimeError('old cleanup failed')) + staged = types.SimpleNamespace(isValid=True, deleteMe=Mock(side_effect=RuntimeError('new cleanup failed'))) + context = types.SimpleNamespace(clear_preview=Mock(), visible=True, + batch=types.SimpleNamespace(rows=[types.SimpleNamespace(id='m2', kind='radius', entities=('new',))], next_id=3)) + with patch.object(self.m, 'current_state', return_value=self.state), \ + patch.object(self.m, 'reference_for', side_effect=lambda e: e), \ + patch.object(self.m, 'resolve', side_effect=lambda d, r: r), \ + patch.object(self.m.renderer, 'render', return_value=staged), \ + patch.object(self.m, 'save_state') as save: + self.m.Execute('add', context).notify(None) + save.assert_not_called() + self.assertIs(self.state.live_preview[0], staged) + + def test_stop_unregister_failure_still_cleans_ui_and_retains_failed_state(self): + self.state.erase = Mock(side_effect=RuntimeError('graphics remain')) + healthy = types.SimpleNamespace(erase=Mock()) + self.m.STATES.append(healthy) + event = types.SimpleNamespace(remove=Mock()) + handler = object() + self.m.HANDLERS.append((event, handler)) + control = types.SimpleNamespace(deleteMe=Mock(return_value=True)) + definition = types.SimpleNamespace(deleteMe=Mock(return_value=True)) + self.m.CONTROLS.append(control); self.m.DEFINITIONS.append(definition) + self.m.APP.unregisterCustomEvent = Mock(side_effect=RuntimeError('unregister failed')) + self.m.stop(None) + event.remove.assert_called_once_with(handler) + control.deleteMe.assert_called_once() + definition.deleteMe.assert_called_once() + self.assertEqual(self.m.HANDLERS, []) + self.assertEqual(self.m.CONTROLS, []) + self.assertEqual(self.m.DEFINITIONS, []) + self.assertEqual(self.m.STATES, [self.state]) + self.state.erase = Mock() + self.m.stop(None) + self.assertEqual(self.m.STATES, []) + + def test_active_native_command_excludes_metadata_and_graphics_mutation(self): + self.state.items = [('m1', 'radius', ('edge',))] + self.state.refresh = Mock() + with patch.object(self.m, 'load_state') as load, \ + patch.object(self.m, 'geometry_fingerprint') as fingerprint: + for active in ('Extrude', 'FusionDrawingViewBaseCommand', 'SketchCircle'): + self.m.UI.activeCommand = active + self.m.UPDATE_PENDING = True + self.m.UpdateDimensions().notify(None) + self.assertFalse(self.m.UPDATE_PENDING) + load.assert_not_called() + fingerprint.assert_not_called() + self.state.refresh.assert_not_called() + + def test_save_barrier_uses_geometry_at_save_not_old_runtime_snapshot(self): + self.state.items = [('m1', 'radius', ('edge',))] + # Also cover another save while the previous save has already removed + # graphics: a queued update must not restore them after that save. + for groups in ([types.SimpleNamespace(isValid=True, deleteMe=Mock(return_value=True))], []): + with self.subTest(graphics_present=bool(groups)): + self.state.groups = groups + self.state.fingerprint = ('old',) + self.state.refresh = Mock() + args = types.SimpleNamespace(document=self.doc) + with patch.object(self.m, 'geometry_fingerprint', return_value=('current-at-save',)): + self.m.DocumentEvent('saving').notify(args) + self.assertEqual(self.state.fingerprint, ('current-at-save',)) + self.assertEqual(self.state.groups, []) + self.m.DocumentEvent('saved').notify(args) + self.m.UpdateDimensions().notify(None) + self.state.refresh.assert_not_called() + self.assertTrue(self.state.removed_for_save) + + def test_destroy_clears_editor_exclusion_even_on_preview_cleanup_failure(self): + self.state.editor_open = True + context = types.SimpleNamespace(state=self.state, clear_preview=Mock(side_effect=RuntimeError('delete failed'))) + self.m.DestroyPreview(context).notify(None) + self.assertFalse(self.state.editor_open) + + def test_undo_last_deleted_row_reloads_saved_metadata(self): + self.state.items = [] # Clear / remove committed earlier in this session. + self.state.fingerprint = ('empty',) + restored = types.SimpleNamespace(items=[('m1', 'radius', ('edge',))], offsets={'m1': 2.5}, + hidden_ids={'m1'}, visible=False, next_id=2) + self.m.APP.fireCustomEvent = Mock(return_value=True) + self.m.ModelCommandEnded().notify(types.SimpleNamespace(commandId='UndoCommand')) + self.m.APP.fireCustomEvent.assert_called_once_with(self.m.UPDATE_EVENT_ID) + self.state.refresh = Mock() + with patch.object(self.m, 'load_state', return_value=restored), \ + patch.object(self.m, 'geometry_fingerprint', return_value=('restored',)): + self.m.UpdateDimensions().notify(None) + self.assertEqual(self.state.items, restored.items) + self.assertEqual(self.state.offsets, {'m1': 2.5}) + self.assertEqual(self.state.hidden_ids, {'m1'}) + self.assertFalse(self.state.visible) + self.assertEqual(self.state.next_id, 2) + self.state.refresh.assert_called_once() + self.assertFalse(self.m.UPDATE_PENDING) + + def test_undo_creation_to_empty_definitions_erases_previous_graphics(self): + self.state.items = [('m1', 'radius', ('edge',))] + self.state.fingerprint = ('old',) + self.state.groups = [types.SimpleNamespace(isValid=True, deleteMe=Mock(return_value=True))] + old = self.state.groups[0] + empty = types.SimpleNamespace(items=[], offsets={}, hidden_ids=set(), visible=True, next_id=1) + with patch.object(self.m, 'load_state', return_value=empty), \ + patch.object(self.m, 'geometry_fingerprint', return_value=('empty',)): + self.m.UpdateDimensions().notify(None) + old.deleteMe.assert_called_once() + self.assertEqual(self.state.items, []) + self.assertEqual(self.state.groups, []) + self.assertEqual(self.state.fingerprint, ('empty',)) + + def test_update_work_is_dropped_in_workspace_transition_drawing_and_editor(self): + self.state.items = [('m1', 'radius', ('edge',))] + self.state.fingerprint = ('before',) + self.state.refresh = Mock() + with patch.object(self.m, 'geometry_fingerprint') as fingerprint: + self.m.WORKSPACE_CHANGING = True + self.m.UpdateDimensions().notify(None) + self.m.WORKSPACE_CHANGING = False + self.m.UI.activeWorkspace.id = 'FusionDocumentationEnvironment' + self.m.UpdateDimensions().notify(None) + self.m.UI.activeWorkspace.id = 'FusionSolidEnvironment' + self.state.editor_open = True + self.m.UpdateDimensions().notify(None) + fingerprint.assert_not_called() + self.state.refresh.assert_not_called() + + +if __name__ == '__main__': + unittest.main()