From 157b40bd6adf958d9057bc8d62fb0d6b9dcb0bef Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Fri, 13 Nov 2026 18:09:45 +0300 Subject: [PATCH 1/8] feat: persist measurement definitions and harden visibility lifecycle --- .fusion-addin.json | 2 +- Mesora/Mesora.manifest | 2 +- Mesora/Mesora.py | 275 ++++++++++++--- Mesora/dimensions/batch.py | 1 + Mesora/dimensions/model.py | 86 ++++- Mesora/dimensions/persistence.py | 8 +- Mesora/dimensions/runtime_persistence.py | 57 +++ Mesora/dimensions/update_fingerprint.py | 101 ++++++ Mesora/renderer.py | 8 +- .../resources/visibility_off/16x16-dark.svg | 1 + Mesora/resources/visibility_off/16x16.svg | 1 + .../resources/visibility_off/32x32-dark.svg | 1 + Mesora/resources/visibility_off/32x32.svg | 1 + README.md | 68 ++-- README.ru.md | 55 ++- README_RU.md | 55 ++- docs/DEVELOPMENT.md | 23 +- docs/fusion-safety.md | 22 +- .../drawing-visibility-2026-11-13.ru.md | 55 +++ .../stability-native-2026-11-13.ru.md | 61 ++++ .../stable-release-cjm-2026-11-13.ru.md | 83 +++++ docs/visibility-and-drawing.md | 67 ++++ docs/visibility-and-drawing.ru.md | 70 ++++ tests/test_batch_apply.py | 16 +- tests/test_missing_references.py | 79 +++++ tests/test_renderer_model_plane.py | 10 + tests/test_runtime_persistence.py | 111 ++++++ tests/test_table_command.py | 19 +- tests/test_update_fingerprint.py | 61 ++++ tests/test_visibility_lifecycle.py | 326 ++++++++++++++++++ 30 files changed, 1581 insertions(+), 144 deletions(-) create mode 100644 Mesora/dimensions/runtime_persistence.py create mode 100644 Mesora/dimensions/update_fingerprint.py create mode 100644 Mesora/resources/visibility_off/16x16-dark.svg create mode 100644 Mesora/resources/visibility_off/16x16.svg create mode 100644 Mesora/resources/visibility_off/32x32-dark.svg create mode 100644 Mesora/resources/visibility_off/32x32.svg create mode 100644 docs/validation/drawing-visibility-2026-11-13.ru.md create mode 100644 docs/validation/stability-native-2026-11-13.ru.md create mode 100644 docs/validation/stable-release-cjm-2026-11-13.ru.md create mode 100644 docs/visibility-and-drawing.md create mode 100644 docs/visibility-and-drawing.ru.md create mode 100644 tests/test_missing_references.py create mode 100644 tests/test_runtime_persistence.py create mode 100644 tests/test_update_fingerprint.py create mode 100644 tests/test_visibility_lifecycle.py diff --git a/.fusion-addin.json b/.fusion-addin.json index 93c8d72..d3441ac 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": "Experimental informational 3D measurements with saved definitions; native save safety under validation.", "initialized": true } diff --git a/Mesora/Mesora.manifest b/Mesora/Mesora.manifest index e25ca84..f533055 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)." + "": "Experimental informational 3D measurements with saved definitions; native save safety under validation." }, "version": "1.0.0", "supportedOS": "windows|mac", diff --git a/Mesora/Mesora.py b/Mesora/Mesora.py index 41036cb..2e6ec5e 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -1,4 +1,4 @@ -"""Mesora: experimental session-only build.""" +"""Mesora: persistent informational measurements; native validation candidate.""" import traceback from pathlib import Path import adsk.core @@ -6,6 +6,8 @@ from .dimensions.fusion_geometry import measure, reference_for, resolve from . import renderer from .dimensions.batch import Batch, RowDraft, duplicate_rows +from .dimensions.runtime_persistence import load_state, save_state +from .dimensions.update_fingerprint import geometry_fingerprint APP = adsk.core.Application.get() UI = APP.userInterface @@ -13,6 +15,9 @@ DEFINITIONS = [] CONTROLS = [] STATES = [] +WORKSPACE_CHANGING = False +UPDATE_EVENT_ID = '4FusionLab.Mesora.GeometryUpdate' +UPDATE_PENDING = False PANEL_ID = 'InspectPanel' INSPECT_PANELS = ( ('FusionSolidEnvironment', 'InspectPanel'), @@ -44,16 +49,47 @@ 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 + + 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: @@ -80,24 +116,34 @@ def erase(self): if failed: 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)) APP.activeViewport.refresh() + self.removed_for_save = False + self.fingerprint = geometry_fingerprint(self.design, self.items, resolve, measure) 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() @@ -110,7 +156,12 @@ def current_state(create=True): for state in STATES: if state.doc == doc: return state if not create: return None - state = State(doc, design); STATES.append(state); return state + # Drop closed document state without writing to another document. + STATES[:] = [s for s in STATES if getattr(s.doc, 'isValid', True)] + state = State(doc, design) + state.load() + STATES.append(state) + return state def state_for(doc): @@ -129,6 +180,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): + 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 +213,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 +224,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 +262,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 +279,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,21 +334,33 @@ 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): @@ -291,24 +370,27 @@ def notify(self, args): try: cmd = args.command 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() + 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') @@ -332,6 +414,7 @@ def notify(self, args): bind(cmd.executePreview, Preview(context)) bind(cmd.destroy, DestroyPreview(context)) bind(cmd.execute, Execute(self.operation, context)) + context.state.editor_open = True elif self.operation == 'remove_one': state = current_state() inputs = cmd.commandInputs @@ -361,6 +444,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 +481,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 +498,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,11 +513,14 @@ 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: @@ -440,8 +537,10 @@ def notify(self, args): self.context.clear_preview() for group in self.context.state.groups: if group.isValid: - group.isVisible = self.context.state.visible + group.isVisible = self.context.state.visible and graphics_workspace() except Exception: log_error() + finally: + self.context.state.editor_open = False class Execute(adsk.core.CommandEventHandler): @@ -456,27 +555,45 @@ 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)) + state.erase() + 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.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 +601,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 +614,25 @@ 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' and (state.groups or state.preview is not None or state.live_preview): state.erase() state.removed_for_save = True + 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 +641,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) @@ -537,6 +657,54 @@ 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() + 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 definitions_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 +727,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 +744,37 @@ 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.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()) 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 + 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/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..7d82028 100644 --- a/Mesora/renderer.py +++ b/Mesora/renderer.py @@ -340,7 +340,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 +351,10 @@ 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: + # 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 d54b2f1..2dac520 100644 --- a/README.md +++ b/README.md @@ -1,35 +1,47 @@ -# Mesora - -Mesora is an experimental Autodesk Fusion add-in for informational 3D dimensions. -The experimental build is available under Design → Solid → Inspect → Mesora — Add -Dimension. Select geometry repeatedly to build a table of measurements. Two point -selections form one distance; each other supported selection forms its own row. -Each row has a session ID and a choice of compatible measurement types. Select a -row and use Remove selected to delete it; Cancel point clears an unfinished pair. -The same menu provides show/hide, refresh and clear. Use disposable documents while testing. - -The planned MVP keeps dimension definitions in memory only. Nothing is intentionally -written to `Design.attributes`; closing the document or stopping the add-in loses the -session dimensions. CustomGraphics can mark a document modified even when groups are -deleted. Fusion may serialize CustomGraphics into an inaccessible persistent artifact; -removing groups in `documentSaving` and restoring after `documentSaved` is implemented -but has not been validated by save/reopen testing. It is not a safety guarantee. Use -only disposable documents, and do not save them with the experimental build enabled. - -The source package is in `Mesora/`. Unit tests run with: +

Mesora for Autodesk Fusion

+

Informational dimensions, in the model.
Measure supported geometry and manage a table of informational 3D dimensions.

+ +

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

+ +> **Experimental validation candidate: use disposable documents only.** A stable release is withheld. Native macOS testing reproduced a persistent CustomGraphics artifact after API Save As, stopping Mesora, closing and reopening: the annotation remained visible although `customGraphicsGroups.count` was zero. Removing graphics before a save is not a safety guarantee. Do not use this candidate to save valuable designs. See [safety research](docs/fusion-safety.md), [current validation status](docs/visibility-and-drawing.md) and [native evidence](docs/validation/stability-native-2026-11-13.ru.md). + +The download above is the previously published experimental 1.0.0. The persistence, visibility and update changes described below are in the current source candidate and have not been published as a stable release. + +## Measure in context + +Open **Design → Solid → Inspect → Mesora — Add Dimension**, select geometry, and build a table of measurements. Rows have 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. Each row has an eye button; the eye beside **+**, **−** and the trash button controls the whole set while preserving individual settings. **OK** commits definitions and visibility to the design; **Cancel** discards the draft. The Mesora menu also provides visibility, refresh, and removal commands. + +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. + +## Install the published experimental build + +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. +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**. Enable **Run on Startup** in your isolated test setup; 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. + +Keep the extracted folder in place while Fusion uses it. No separate Python installation is needed for the release archive. + +## Status and limits + +- In the current source candidate, **OK** stores geometry references, measurement types, placement offsets and individual/global visibility in `Design.attributes`. Values are remeasured from geometry. Unsupported or damaged saved data is not silently overwritten. This implementation does not establish safe model saving. +- An update is queued after a Fusion model command ends, using a custom event on Fusion's permitted thread. Native acceptance of all geometry edits, Undo/Redo and recovery paths remains pending. +- The UI save handler removes tracked graphics and intentionally does not recreate them in `documentSaved` or on workspace activation. After a save, open Mesora or use **Refresh Dimensions** to restore graphics. This workaround is not the intended complete save/reopen experience; API Save As reproduced the persistent-artifact defect described above. +- macOS native tests have exercised row/global visibility and Drawing creation on synthetic designs. Full save, Save As, close/reopen and restart acceptance is incomplete. Transformed/nested occurrences and broader picking/appearance scenarios still need validation. Offline tests do not establish native Fusion acceptance. +- The manifest declares Windows and macOS. Windows native acceptance and full restart gates are outstanding. A stable release requires the artifact defect to be resolved and these gates to pass. + +## Development and support + +The add-in source is in `Mesora/`. To run offline tests or build a local archive: ```sh python3 -m unittest discover -s tests -v +python3 scripts/check_project.py +python3 scripts/build.py --version 1.0.0 ``` -Native read-only measurement and direct render/create/delete calls have been tried on -macOS Fusion. The command was exercised on a temporary macOS design using programmatic Fusion -selection events and UI confirmation. Physical picking, broader event lifecycle, safe -save/reopen, transformed occurrences, Windows, and appearance/rotation acceptance remain open. -See [research and test notes](docs/fusion-safety.md). - -## Installation - -Build `python3 scripts/build.py --version 1.0.0`, extract the ZIP into the Fusion AddIns directory so that `Mesora/Mesora.manifest` and `Mesora/Mesora.py` are directly inside the extracted folder, then start Mesora from Fusion's Add-Ins dialog. The ZIP is also intended for GitHub Releases when published. Restarting or stopping the add-in clears session measurements. +[Safety and test notes](docs/fusion-safety.md) · [Development](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. + +Mesora is an independent [4FusionLab](https://github.com/4FusionLab) project and is not affiliated with or endorsed by Autodesk. diff --git a/README.ru.md b/README.ru.md index f5d9034..8ea5616 100644 --- a/README.ru.md +++ b/README.ru.md @@ -1,28 +1,47 @@ -# Mesora +

Mesora для Autodesk Fusion

+

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

-Mesora — экспериментальный аддон Autodesk Fusion для информационных 3D-размеров. -Откройте Design → Solid → Inspect → Mesora — Add Dimension и последовательно выбирайте геометрию, чтобы заполнить таблицу измерений. Две точки образуют расстояние; для каждой строки можно выбрать совместимый тип измерения. В том же меню доступны показ, обновление и очистка размеров. Используйте только тестовые документы. +

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

-Для MVP определения размеров хранятся только в памяти. Аддон намеренно не записывает -их в `Design.attributes`: при закрытии документа или остановке аддона они теряются. -Создание и удаление CustomGraphics может пометить документ изменённым. Из-за бага -Fusion графика, присутствующая при сохранении, может стать неудаляемой. Удаление перед -сохранением и восстановление после него реализованы, но **не проверены сохранением и -повторным открытием** и не дают гарантии безопасности. Для испытаний используйте -только тестовые документы; пока не сохраняйте их при включённой сборке. +> **Экспериментальный кандидат для проверки: только тестовые документы.** Стабильный релиз отложен. При нативной проверке на macOS после API Save As, остановки Mesora, закрытия и повторного открытия обнаружен постоянный артефакт CustomGraphics: размер оставался видимым, хотя `customGraphicsGroups.count` был равен нулю. Удаление графики перед сохранением не гарантирует безопасность. Не сохраняйте ценные модели с этим кандидатом. Подробнее — в [исследовании](docs/fusion-safety.md) и [текущем статусе проверки](docs/visibility-and-drawing.ru.md), а также [нативных доказательствах](docs/validation/stability-native-2026-11-13.ru.md). -Исходники аддона находятся в `Mesora/`. Автономные тесты запускаются командой: +Ссылка выше ведёт на ранее опубликованную экспериментальную версию 1.0.0. Описанные ниже изменения сохранения определений, видимости и обновления находятся в текущих исходниках кандидата; стабильный релиз с ними не опубликован. + +## Измерения в контексте модели + +Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выбирайте геометрию и собирайте таблицу измерений. У строк есть идентификаторы, например `m1`: можно изменить геометрию, выбрать совместимый тип измерения, настроить отступ и удалить строку. Подтвердите команду, чтобы показать размеры. У каждой строки есть глазик; глазик рядом с **+**, **−** и корзиной управляет всем набором, сохраняя индивидуальные настройки. **OK** записывает определения и видимость в модель; **Cancel** отменяет черновик. В меню Mesora также доступны показ и скрытие, обновление и удаление размеров. + +В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла выбираются два совместимых объекта, для остальных типов — один поддерживаемый объект. Доступные варианты зависят от выбора; неподдерживаемые сочетания отклоняются. + +## Установка опубликованной экспериментальной версии + +1. Скачайте `Mesora-1.0.0.zip` со страницы [экспериментального релиза](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) и распакуйте архив в постоянную папку. +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**. Укажите один или два объекта для строки, проверьте совместимый тип и предпросмотр, затем подтвердите команду. + +Не перемещайте распакованную папку, пока Fusion использует аддон. Для готового архива отдельная установка Python не нужна. + +## Статус и ограничения + +- В текущих исходниках кандидата **OK** записывает ссылки на геометрию, типы измерений, смещения и индивидуальную/общую видимость в `Design.attributes`. Значения заново вычисляются по геометрии. Неподдерживаемые или повреждённые данные не перезаписываются молча. Наличие этой реализации не подтверждает безопасность сохранения модели. +- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Нативная приёмка всех изменений геометрии, Undo/Redo и восстановления пока не завершена. +- Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Это временный обходной путь, а не завершённый сценарий сохранения и повторного открытия; API Save As воспроизвёл описанный выше постоянный артефакт. +- На macOS в синтетических моделях нативно проверялись индивидуальная/общая видимость и создание Drawing. Полная приёмка сохранения, Save As, закрытия/повторного открытия и перезапуска не завершена. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. +- В манифесте заявлены Windows и macOS. Нативная приёмка Windows и проверки полного перезапуска ещё не пройдены. Для стабильного релиза нужно устранить постоянный артефакт и пройти эти проверки. + +## Разработка и поддержка + +Исходники аддона находятся в `Mesora/`. Автономные тесты и локальная сборка: ```sh python3 -m unittest discover -s tests -v +python3 scripts/check_project.py +python3 scripts/build.py --version 1.0.0 ``` -На macOS Fusion проверены отдельные измерения и прямое создание/удаление графики. -Интерактивный сценарий команд, события, сохранение, трансформации компонентов и -Windows ещё требуют проверки. Подробности — в [заметках](docs/fusion-safety.md). - -## Установка - -Соберите архив командой `python3 scripts/build.py --version 1.0.0` и распакуйте его в каталог AddIns Fusion: файлы `Mesora.manifest` и `Mesora.py` должны находиться непосредственно в папке `Mesora`. Затем запустите Mesora в диалоге Add-Ins. Остановка или перезапуск аддона удаляет сеансовые размеры. +[Безопасность и результаты проверок](docs/fusion-safety.md) · [Разработка](docs/DEVELOPMENT.md) · [Участие в разработке](CONTRIBUTING.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues) Mesora распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых лицензией случаев возможно по отдельной договорённости с правообладателем; свяжитесь с 4FusionLab. + +Mesora — независимый проект [4FusionLab](https://github.com/4FusionLab), не связанный с Autodesk и не одобренный ею. diff --git a/README_RU.md b/README_RU.md index f5d9034..8ea5616 100644 --- a/README_RU.md +++ b/README_RU.md @@ -1,28 +1,47 @@ -# Mesora +

Mesora для Autodesk Fusion

+

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

-Mesora — экспериментальный аддон Autodesk Fusion для информационных 3D-размеров. -Откройте Design → Solid → Inspect → Mesora — Add Dimension и последовательно выбирайте геометрию, чтобы заполнить таблицу измерений. Две точки образуют расстояние; для каждой строки можно выбрать совместимый тип измерения. В том же меню доступны показ, обновление и очистка размеров. Используйте только тестовые документы. +

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

-Для MVP определения размеров хранятся только в памяти. Аддон намеренно не записывает -их в `Design.attributes`: при закрытии документа или остановке аддона они теряются. -Создание и удаление CustomGraphics может пометить документ изменённым. Из-за бага -Fusion графика, присутствующая при сохранении, может стать неудаляемой. Удаление перед -сохранением и восстановление после него реализованы, но **не проверены сохранением и -повторным открытием** и не дают гарантии безопасности. Для испытаний используйте -только тестовые документы; пока не сохраняйте их при включённой сборке. +> **Экспериментальный кандидат для проверки: только тестовые документы.** Стабильный релиз отложен. При нативной проверке на macOS после API Save As, остановки Mesora, закрытия и повторного открытия обнаружен постоянный артефакт CustomGraphics: размер оставался видимым, хотя `customGraphicsGroups.count` был равен нулю. Удаление графики перед сохранением не гарантирует безопасность. Не сохраняйте ценные модели с этим кандидатом. Подробнее — в [исследовании](docs/fusion-safety.md) и [текущем статусе проверки](docs/visibility-and-drawing.ru.md), а также [нативных доказательствах](docs/validation/stability-native-2026-11-13.ru.md). -Исходники аддона находятся в `Mesora/`. Автономные тесты запускаются командой: +Ссылка выше ведёт на ранее опубликованную экспериментальную версию 1.0.0. Описанные ниже изменения сохранения определений, видимости и обновления находятся в текущих исходниках кандидата; стабильный релиз с ними не опубликован. + +## Измерения в контексте модели + +Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выбирайте геометрию и собирайте таблицу измерений. У строк есть идентификаторы, например `m1`: можно изменить геометрию, выбрать совместимый тип измерения, настроить отступ и удалить строку. Подтвердите команду, чтобы показать размеры. У каждой строки есть глазик; глазик рядом с **+**, **−** и корзиной управляет всем набором, сохраняя индивидуальные настройки. **OK** записывает определения и видимость в модель; **Cancel** отменяет черновик. В меню Mesora также доступны показ и скрытие, обновление и удаление размеров. + +В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла выбираются два совместимых объекта, для остальных типов — один поддерживаемый объект. Доступные варианты зависят от выбора; неподдерживаемые сочетания отклоняются. + +## Установка опубликованной экспериментальной версии + +1. Скачайте `Mesora-1.0.0.zip` со страницы [экспериментального релиза](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) и распакуйте архив в постоянную папку. +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**. Укажите один или два объекта для строки, проверьте совместимый тип и предпросмотр, затем подтвердите команду. + +Не перемещайте распакованную папку, пока Fusion использует аддон. Для готового архива отдельная установка Python не нужна. + +## Статус и ограничения + +- В текущих исходниках кандидата **OK** записывает ссылки на геометрию, типы измерений, смещения и индивидуальную/общую видимость в `Design.attributes`. Значения заново вычисляются по геометрии. Неподдерживаемые или повреждённые данные не перезаписываются молча. Наличие этой реализации не подтверждает безопасность сохранения модели. +- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Нативная приёмка всех изменений геометрии, Undo/Redo и восстановления пока не завершена. +- Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Это временный обходной путь, а не завершённый сценарий сохранения и повторного открытия; API Save As воспроизвёл описанный выше постоянный артефакт. +- На macOS в синтетических моделях нативно проверялись индивидуальная/общая видимость и создание Drawing. Полная приёмка сохранения, Save As, закрытия/повторного открытия и перезапуска не завершена. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. +- В манифесте заявлены Windows и macOS. Нативная приёмка Windows и проверки полного перезапуска ещё не пройдены. Для стабильного релиза нужно устранить постоянный артефакт и пройти эти проверки. + +## Разработка и поддержка + +Исходники аддона находятся в `Mesora/`. Автономные тесты и локальная сборка: ```sh python3 -m unittest discover -s tests -v +python3 scripts/check_project.py +python3 scripts/build.py --version 1.0.0 ``` -На macOS Fusion проверены отдельные измерения и прямое создание/удаление графики. -Интерактивный сценарий команд, события, сохранение, трансформации компонентов и -Windows ещё требуют проверки. Подробности — в [заметках](docs/fusion-safety.md). - -## Установка - -Соберите архив командой `python3 scripts/build.py --version 1.0.0` и распакуйте его в каталог AddIns Fusion: файлы `Mesora.manifest` и `Mesora.py` должны находиться непосредственно в папке `Mesora`. Затем запустите Mesora в диалоге Add-Ins. Остановка или перезапуск аддона удаляет сеансовые размеры. +[Безопасность и результаты проверок](docs/fusion-safety.md) · [Разработка](docs/DEVELOPMENT.md) · [Участие в разработке](CONTRIBUTING.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues) Mesora распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых лицензией случаев возможно по отдельной договорённости с правообладателем; свяжитесь с 4FusionLab. + +Mesora — независимый проект [4FusionLab](https://github.com/4FusionLab), не связанный с Autodesk и не одобренный ею. diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index eee5048..e6202fe 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -12,8 +12,29 @@ python3 scripts/build.py --version 1.0.0 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. +## Candidate status and persistence + +The current source is an experimental validation candidate, not an accepted stable +release. Explicit command commits store references and settings in design +attributes through `dimensions/runtime_persistence.py`; values are recalculated. +Schema v2 supports all current measurement types and reads schema v1. Unknown, +corrupted or future data must not be silently overwritten. Automatic model updates +use `commandTerminated` and a deferred custom event; native acceptance remains +incomplete. + +A macOS API Save As test reproduced a visible persistent CustomGraphics annotation +after stopping Mesora and reopening the file, even with a zero API group count. +The UI save cleanup/manual **Refresh Dimensions** workaround does not establish +normal save/reopen safety. The stable release is withheld pending resolution, +Windows native acceptance and full restart gates. See the +[native report](validation/stability-native-2026-11-13.ru.md) and +[CJM and acceptance traceability](validation/stable-release-cjm-2026-11-13.ru.md). + ## 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). +For the Drawing save-loop regression and row/global visibility controls, follow the +checks in [Visibility and Drawing](visibility-and-drawing.md). + +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. For each save path, stop the add-in and inspect reopened files visually as well as checking group counts. CustomGraphics save/reopen safety is **not established**, and an inaccessible saved annotation has been reproduced; do not save valuable designs while the add-in is running. See [Fusion safety notes](fusion-safety.md). 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. diff --git a/docs/fusion-safety.md b/docs/fusion-safety.md index c664446..6c84309 100644 --- a/docs/fusion-safety.md +++ b/docs/fusion-safety.md @@ -11,7 +11,11 @@ not a documented guarantee. No archive modification is implemented or recommende 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 +The current [DocumentEventArgs reference](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_DocumentEventArgs.htm) +documents `isOperationCancelled` and `cancelReason` for saving. Fusion 2706.1.17 +exposes those properties and does not expose `isSaveCanceled`; the older Application +event description still mentions that obsolete name. Native fault-injection must +verify actual cancellation, beyond checking that the property exists. 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 @@ -33,7 +37,7 @@ 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. -## Current validation +## Historical validation before the stability candidate Offline unit tests exercise arithmetic, evaluator and persistence stubs, schema handling, and reference failure cases. A read-only run on the open macOS Fusion @@ -48,3 +52,17 @@ 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. + +## Stability candidate, 2026-11-13 + +Commands are now registered. The candidate stores definitions and visibility in +design attributes and implements deferred geometry updates. Native API testing +confirmed definition round trips and rebuilding on changed geometry through direct +handler invocation. Event delivery and full UI flows remain separate acceptance gates. + +Saving visible graphics through API Save As, stopping Mesora, and reopening a +synthetic design reproduced visible orphan graphics with zero API groups. Editing +and saving the geometry without Mesora left an incorrect old annotation visible. +A control path that explicitly removed graphics before saving reopened cleanly; +this does not establish safety for all save paths. See the [native evidence](validation/stability-native-2026-11-13.ru.md). +Stable publication is withheld; Windows and full restart acceptance remain pending. 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/stability-native-2026-11-13.ru.md b/docs/validation/stability-native-2026-11-13.ru.md new file mode 100644 index 0000000..af0d067 --- /dev/null +++ b/docs/validation/stability-native-2026-11-13.ru.md @@ -0,0 +1,61 @@ +# Mesora: нативная проверка стабильности, 13.11.2026 + +**Решение: stable не публиковать.** Кейс использования проекта без Mesora выявил устаревшую неуправляемую аннотацию после сохранения и reopen. Windows Fusion, полная проверка restart и штатная последовательность UI-событий финального кандидата не приняты. + +## Среда и границы доказательства + +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: модель без Mesora — 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 + +На итоговом рабочем кандидате прошли компиляция, **103 offline tests**, `scripts/check_project.py`, `git diff --check`. Проверена детерминированная сборка 54 файлов с новыми модулями и четырьмя иконками; UUID сохранён. Локальный ZIP `dist/stability-validation/Mesora-0.0.0.zip` имеет SHA-256 `fff5e84dab85c95b2eb28bd194120381ba4b8ded12af7aa0e5a2b15cba75cdfc`. `0.0.0` — только числовая заглушка для проверки упаковки, не назначенная версия релиза. Штатную версию определяет GitVersion 6.8.2. Этот ZIP не публиковать как stable. + +## Необходимая повторная проверка + +Сначала устранить попадание CustomGraphics в сохраняемое состояние либо подтвердить другой способ отображения. `isModified` не подделывать, вымышленные transient-флаги не вводить. После исправления повторить все пути Save/Save As/cancel/failure/recovery, close/reopen, restart и работу без аддина с визуальными снимками. Затем принять model edits, Undo/Redo, Drawing, несколько документов и установку финального ZIP отдельно на macOS и Windows. + +Предыдущий 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 о готовом релизе не отправляется до успешного выпуска. 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..05f4ace --- /dev/null +++ b/docs/validation/stable-release-cjm-2026-11-13.ru.md @@ -0,0 +1,83 @@ +# Mesora: CJM и приёмка стабильного релиза + +Дата: 13.11.2026. Рабочий документ приёмки; не свидетельство завершённой CAD-проверки. + +## Продуктовая цель + +Конструктор один раз создаёт информационные размеры и использует их при изменении, сохранении и передаче модели в Drawing. Он может убрать визуальный шум без потери измерений и вернуться к работе после закрытия 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 | `test_package`, validator: PASS | macOS/Windows PENDING на финальном ZIP; UI, count handlers и версия | Повторить после финальной сборки | +| S02 | Создать и применить все 7 видов: distance, edge_length, radius, diameter, angle, area, perimeter | arithmetic, geometry, renderer tests: PASS | На цилиндре, блоке, двух гранях и дуге сверить Fusion Inspect; macOS/Windows PENDING | Сверять units и нет chord вместо arc | +| S03 | Некорректный/неполный/duplicate выбор не применяется; Cancel не меняет committed | `test_measurement_batch`, `test_table_command`: PASS | Сменить тип и геометрию нескольких строк, OK/Cancel: PENDING | Нельзя потерять другую строку | +| S04 | Глазик строки сразу скрывает/показывает без удаления, OK сохраняет настройку | `test_visibility_lifecycle`, `test_batch_apply`: PASS | Preview/Cancel: переданный macOS PASS; OK→повторное открытие PENDING; Windows PENDING | Скрытая строка остаётся в таблице | +| S05 | Общий глазик скрывает весь набор и возвращает только индивидуально видимые | Те же тесты: PASS | Переданный macOS preview PASS; commit/reopen/Windows PENDING | Проверить в том числе все строки individually hidden | +| S06 | Изменить радиус/высоту/длину: число, выносные и положение обновляются автоматически | На baseline нет lifecycle-регрессии пересчёта | Native параметрический edit→закончить команду→сверить без Refresh: PENDING | D02; повторить после интеграции событий | +| S07 | Undo/Redo изменения геометрии и Mesora возвращает согласованные определения и аннотации | На baseline нет full transaction-проверки | Undo/Redo после OK, remove, visibility, parameter edit: macOS/Windows PENDING | Нельзя считать state в памяти доказательством Undo | +| S08 | Удалённая/подавленная/неоднозначная ссылка явно недоступна; остальные строки редактируются | resolver rejects missing/ambiguous: PASS | Удалить measured feature, открыть Mesora, исправить/удалить плохую строку: PENDING | D03; prefill baseline прерывается на resolve | +| S09 | Save с видимой графикой завершается один раз; нет постоянной звёздочки | `test_drawing_save_stays_clean_without_recreating_graphics`: PASS | Переданный macOS Drawing PASS; самостоятельный Save финального кода PENDING | D01/D04; считать версии и modified flag, не менять isModified | +| S10 | Save→close→reopen сохраняет 7 типов, offsets, row/global visibility; значения пересчитаны | Только отдельный persistence stub baseline PASS, runtime не подключён | macOS/Windows PENDING; reopen с аддином и без него, visual orphan check | D01; полная матрица после подключения persistence | +| S11 | Полный restart Fusion восстанавливает определения и не оставляет orphan graphics | Offline не доказывает | macOS/Windows PENDING; stop→save→exit→start→open; снимки до/после | Релизный gate, не заменяется count groups | +| S12 | Save As создаёт независимую копию набора; изменения копии не меняют исходник | Document isolation persistence stub PASS | Два файла с разными settings, закрыть/открыть оба: PENDING | D01; убедиться в сохранении refs после копии | +| S13 | Cancel/failed Save не теряет определения, не зависает, позволяет retry и продолжение | Нет native fault evidence | macOS/Windows PENDING: cancel Save As; воспроизводимый отказ записи только на фикстуре; retry | D04; documentSaved может не прийти, нельзя зависеть только от него | +| S14 | Drawing с показанными размерами создаётся; source clean; возврат в модель предсказуем | camera/workspace/save regressions PASS | Переданный macOS PASS: v162→v163; финальный код/Windows PENDING | D04; проверить с persistence и auto-update заново | +| S15 | Два документа и Drawing не смешивают definitions/visibility; закрытие не держит stale state | Persistence stub isolation PASS | Model A→B→Drawing→A, закрыть B, новый C: PENDING | Проверить events принадлежат нужному document | +| S16 | Transformed/nested occurrences, orbit, zoom, units дают корректные числа/позиции | Geometry context/renderer layout tests PASS | macOS/Windows PENDING; ненулевой transform, вложенные компоненты, mm/in | Старый zero-transform smoke недостаточен | +| S17 | Повреждённый/будущий schema не перезаписывается; ошибка понятна, остальные документы работают | `test_persistence`, schema tests PASS | Синтетические attributes fixtures: PENDING | D01; runtime должен fail closed и сохранять исходный payload | +| S19 | Использовать проект без установленной/запущенной Mesora: геометрия доступна для edit/save; reopen без orphan; после подключения Mesora определения восстановлены по актуальной геометрии | Offline persistence покрывает независимые определения, но не сериализацию CAD | **macOS FAIL (прогон root)**: без Mesora геометрия редактируется (радиус 2→2.5 cm), save/reopen успешны, API graphicsCount=0; визуально остаётся orphan с устаревшим 125.7 mm вместо актуального 157.1 mm. Доказательство: `dist/local-validation/orphan-after-model-edit.png` (root просмотрел). Windows PENDING; восстановление Mesora после этого требует отдельной проверки | Обязательный пользовательский gate; данные не должны зависеть от наличия аддина | +| 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 | OPEN на baseline; реализация делегирована отдельно | +| D02 | Blocker | Подписки baseline не запускают пересчёт при изменении геометрии; camera handler только ориентирует text | S06/S07 автоматически обновляют актуальную геометрию без ручного Refresh | OPEN на baseline | +| D03 | Major | `BatchCommand.prefill` разрешает каждую ссылку без обработки ошибки строки: одна плохая ссылка прерывает заполнение/открытие командного диалога | S08: остальные строки доступны, плохую можно удалить/исправить без потери данных | OPEN на baseline; сообщено владельцу runtime | +| D04 | Major | После save `removed_for_save` блокирует graphics до явного действия; при interrupted save нет подтверждённого recovery | S09/S13/S14 без loop, данные доступны после любого исхода save; фактический UX описан | OPEN на baseline | +| D05 | Documentation | Manifest и safety/readme говорят experimental/session-only; safety содержит устаревшие сообщения об отсутствии зарегистрированных команд | Документация соответствует фактически принятым сценариям, EN/RU parity; неподтверждённые платформы явно указаны | PENDING после приёмки | + +## Воспроизводимые 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: все обязательные сценарии приняты на заявленных платформах, blocker/major закрыты или явно согласован scope; 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 + +Владелец Fusion (root) 13.11.2026 подтвердил: использование геометрии без Mesora возможно, но старые аннотации остаются видимыми после редактирования и повторного открытия. При радиусе 2.5 cm окружность должна иметь длину около 157.1 mm; виден старый label 125.7 mm. При этом `customGraphicsGroups.count == 0`, так что удалить этот label обычным управлением группами невозможно. S19 **FAIL**, доверие к информационным размерам нарушено; stable release заблокирован до устранения и повторной визуальной приёмки. Это переданное свидетельство 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 FAIL и end-to-end gates сохранения/перезапуска. Для закрытия нужны действия через штатный UI Fusion, без ручного вызова обработчиков, с теми же визуальными проверками. diff --git a/docs/visibility-and-drawing.md b/docs/visibility-and-drawing.md new file mode 100644 index 0000000..5b37c4b --- /dev/null +++ b/docs/visibility-and-drawing.md @@ -0,0 +1,67 @@ +# Visibility, persistence and Drawing + +[Русская версия](visibility-and-drawing.ru.md) + +**Status: experimental validation candidate; stable release withheld.** Native +macOS acceptance reproduced an inaccessible persistent CustomGraphics annotation +after API Save As, stopping Mesora, closing and reopening the synthetic model. +The annotation was visible while `customGraphicsGroups.count` was zero. A zero +count is not proof that the model contains no saved graphics. Use disposable +documents only. See the [native evidence](validation/stability-native-2026-11-13.ru.md). + +Each measurement row has an eye button. Click it to hide or show that measurement +without removing its geometry references, type or offset. A crossed-out eye means +the row is hidden. Hidden rows remain editable. + +The eye next to **+**, **−** and the trash button hides or shows the whole set. +It preserves individual row settings: showing the set again keeps individually +hidden rows hidden. Visibility changes preview immediately; **OK** stores committed +geometry references, measurement types, offsets and visibility in the design's +attributes. **Cancel** discards the draft and restores committed visibility. +Measured values are recalculated from current geometry rather than stored. +Unsupported or damaged stored definitions are not silently overwritten. + +Automatic updates are implemented through `commandTerminated` followed by a custom +event on Fusion's permitted execution thread. Native acceptance of geometry edits, +Undo/Redo and full recovery is still pending; implementation and offline tests are +not evidence that every native path works. + +When the UI save event runs, Mesora removes tracked graphics before saving. It +deliberately does not recreate them inside `documentSaved`: that makes the source +design modified again and can make Drawing creation repeatedly save the source. +After a save, open Mesora or use **Refresh Dimensions** to show the dimensions +again. Document/workspace activation also leaves restoration to explicit actions, +because Drawing can activate its source during creation. The camera handler does +not update model graphics in Drawing or during workspace transitions. + +This is a temporary workaround, not complete normal save/reopen behavior. The API +Save As path reproduced a persistent annotation despite this event strategy. +Stopping the add-in does not guarantee removal of an already saved artifact. + +## Acceptance checklist + +Use a new disposable model on each supported OS. Record a result and evidence for +each step; this checklist itself does not mark any gate passed. + +1. Create two measurements. Hide one row; verify its graphic disappears and its + row, geometry, type and offset remain. Change the offset while hidden. +2. Hide and show the whole set. Verify the individually hidden row stays hidden. +3. Apply, reopen Mesora, and verify both eye states. Show the hidden row and + cancel; verify the committed visibility remains unchanged. +4. Apply with all measurements globally hidden, reopen and show them; verify + individual settings are retained. Remove a hidden row and add another row. +5. Change the referenced geometry, then Undo and Redo. Verify values and placement + update, and missing/ambiguous references do not display stale measurements. +6. Test UI Save, API save and Save As independently with dimensions shown. Verify + cleanup, document cleanliness and explicit **Refresh Dimensions** behavior. +7. Stop Mesora, close and reopen, then fully restart Fusion and reopen. Inspect + visually for persistent annotations as well as checking API group counts. + Reload Mesora and verify definitions, offsets and both visibility levels. +8. With dimensions shown, create a Drawing from the design. Verify creation reaches + the drawing sheet and Base View, with no endless source-version increments. +9. Return to the model and verify measurements and visibility. Test canceled/failed + save and close paths without discarding or overwriting definitions. + +The persistent-artifact defect, Windows native acceptance and full restart gates +remain blockers for a stable release. See [Fusion safety notes](fusion-safety.md) +and the [product acceptance matrix](validation/stable-release-cjm-2026-11-13.ru.md). diff --git a/docs/visibility-and-drawing.ru.md b/docs/visibility-and-drawing.ru.md new file mode 100644 index 0000000..1f2b3c2 --- /dev/null +++ b/docs/visibility-and-drawing.ru.md @@ -0,0 +1,70 @@ +# Видимость, сохранение определений и Drawing + +[English](visibility-and-drawing.md) + +**Статус: экспериментальный кандидат для проверки; стабильный релиз отложен.** +Нативная приёмка на macOS воспроизвела недоступный постоянный размер CustomGraphics +после API Save As, остановки Mesora, закрытия и повторного открытия синтетической +модели. Размер был виден при `customGraphicsGroups.count`, равном нулю. Нулевой +счётчик не доказывает отсутствие сохранённой графики. Используйте только тестовые +документы. См. [нативные доказательства](validation/stability-native-2026-11-13.ru.md). + +У каждой строки измерения есть глазик. Он скрывает или показывает размер, +сохраняя ссылки на геометрию, тип и смещение. Перечёркнутый глазик означает, что +строка скрыта. Скрытые измерения можно редактировать. + +Глазик рядом с **+**, **−** и корзиной скрывает или показывает весь набор. Он +сохраняет настройки отдельных строк: при повторном показе набора индивидуально +скрытые размеры остаются скрытыми. Изменения сразу видны в предпросмотре; +**OK** записывает подтверждённые ссылки на геометрию, типы измерений, смещения и +видимость в атрибуты модели. **Cancel** отменяет черновик и возвращает +подтверждённую видимость. Значения пересчитываются по актуальной геометрии, а не +сохраняются. Неподдерживаемые или повреждённые определения не перезаписываются молча. + +Автообновление реализовано через `commandTerminated` с последующим custom event +в разрешённом потоке Fusion. Нативная приёмка изменений геометрии, Undo/Redo и +полного восстановления ещё не завершена; реализация и автономные тесты не +подтверждают работу всех нативных сценариев. + +Когда срабатывает событие сохранения через UI, Mesora удаляет отслеживаемую +графику перед сохранением. Она намеренно не пересоздаётся в `documentSaved`: это +снова помечало модель изменённой и могло вызывать повторное сохранение при создании +Drawing. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, +чтобы вернуть размеры. При активации документа и смене рабочей среды восстановление +также оставлено явным действиям: Drawing может активировать исходную модель в ходе +создания. Обработчик камеры не меняет графику модели в Drawing и во время +переключения рабочих сред. + +Это временный обходной путь, а не завершённый сценарий нормального сохранения и +повторного открытия. В пути API Save As постоянный размер воспроизведён несмотря +на эту обработку событий. Остановка аддона не гарантирует удаление уже +сохранённого артефакта. + +## Проверка + +Используйте новую тестовую модель на каждой поддерживаемой ОС. Для каждого шага +фиксируйте результат и доказательство; сам список не означает прохождение проверок. + +1. Создайте два измерения. Скройте одно: графика исчезает, строка, геометрия, тип + и смещение остаются. Измените смещение скрытого измерения. +2. Скройте и покажите весь набор. Индивидуально скрытый размер остаётся скрытым. +3. Нажмите **OK**, откройте Mesora снова и проверьте оба глазика. Покажите скрытую + строку и нажмите **Cancel**: прежняя видимость должна сохраниться. +4. Примените глобальное скрытие, откройте команду и включите показ. Настройки строк + должны сохраниться. Удалите скрытую строку и добавьте новую. +5. Измените связанную геометрию, выполните Undo и Redo. Проверьте пересчёт значений + и размещения; потерянные/неоднозначные ссылки не должны показывать старые размеры. +6. Отдельно проверьте UI Save, API save и Save As с показанными размерами: + очистку, отсутствие изменений после сохранения и явный **Refresh Dimensions**. +7. Остановите Mesora, закройте и откройте модель; затем полностью перезапустите + Fusion и откройте её снова. Кроме счётчика API, визуально проверьте отсутствие + постоянных размеров. Запустите Mesora и проверьте определения, смещения и оба + уровня видимости. +8. При показанных размерах создайте Drawing. Должны открыться лист и команда + Base View, без бесконечного роста версий исходной модели. +9. Вернитесь в модель и проверьте измерения и видимость. Проверьте отмену и ошибку + сохранения/закрытия без потери или перезаписи определений. + +Постоянный артефакт, нативная приёмка Windows и полный перезапуск остаются +блокерами стабильного релиза. См. [ограничения Fusion](fusion-safety.md) и +[продуктовую матрицу приёмки](validation/stable-release-cjm-2026-11-13.ru.md). diff --git a/tests/test_batch_apply.py b/tests/test_batch_apply.py index d8b2aaf..06ebed7 100644 --- a/tests/test_batch_apply.py +++ b/tests/test_batch_apply.py @@ -9,13 +9,14 @@ 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: @@ -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,15 +37,16 @@ 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}): @@ -53,10 +55,10 @@ def test_adding_to_hidden_state_restores_all_measurements(self): state = types.SimpleNamespace(items=[('m1','radius',('old',))], groups=[], visible=False, next_id=2, erase=lambda: 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, '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_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_renderer_model_plane.py b/tests/test_renderer_model_plane.py index d9275b6..b2c4d56 100644 --- a/tests/test_renderer_model_plane.py +++ b/tests/test_renderer_model_plane.py @@ -51,6 +51,14 @@ def getEndPoints(self): return True, Point(0, 0, 0), Point(10, 0, 0) class RendererPlaneTest(unittest.TestCase): + 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 +83,8 @@ 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.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..3e68285 --- /dev/null +++ b/tests/test_visibility_lifecycle.py @@ -0,0 +1,326 @@ +"""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() + 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.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',))] + self.state.groups = [types.SimpleNamespace(isValid=True, deleteMe=Mock(return_value=True))] + 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() From f0906542cc2f69b5f21d641b4a4975d75f9cf808 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Fri, 13 Nov 2026 18:33:04 +0300 Subject: [PATCH 2/8] feat: restore stored measurements on document open and add-in start --- Mesora/Mesora.py | 88 +++++- README.md | 2 +- README.ru.md | 2 +- README_RU.md | 2 +- docs/DEVELOPMENT.md | 8 +- docs/DEVELOPMENT.ru.md | 9 +- .../stability-native-2026-11-13.ru.md | 16 +- .../stable-release-cjm-2026-11-13.ru.md | 32 ++- docs/visibility-and-drawing.md | 14 +- docs/visibility-and-drawing.ru.md | 17 +- scripts/native_acceptance_observer.py | 262 ++++++++++++++++++ tests/test_document_restore.py | 139 ++++++++++ 12 files changed, 563 insertions(+), 28 deletions(-) create mode 100644 scripts/native_acceptance_observer.py create mode 100644 tests/test_document_restore.py diff --git a/Mesora/Mesora.py b/Mesora/Mesora.py index fcbedee..637cb5c 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -78,6 +78,7 @@ def __init__(self, doc, design): self.next_id = 1 self.fingerprint = None self.editor_open = False + self.restore_requested = False def load(self): stored = load_state(self.design) @@ -132,6 +133,7 @@ def refresh(self): 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): @@ -148,24 +150,75 @@ def remove_item(self, ident): 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 - # Drop closed document state without writing to another document. - STATES[:] = [s for s in STATES if getattr(s.doc, 'isValid', True)] + 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 state_for(doc): - return next((s for s in STATES if s.doc == doc), None) +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): @@ -180,7 +233,7 @@ 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): + 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 @@ -585,6 +638,7 @@ def notify(self, args): state.next_id = self.context.batch.next_id 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 @@ -618,6 +672,7 @@ def notify(self, args): if state.groups or state.preview is not None or state.live_preview: 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: # Creating CustomGraphics dirties the document. Drawing saves its @@ -697,10 +752,12 @@ def notify(self, args): # Undo/Redo restores document attributes in Fusion's transaction. # Runtime state must follow them, including undoing the last row. state.load() + if not state.items and not definitions_changed and not state.restore_requested: + 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 definitions_changed or (state.fingerprint is not None and fingerprint != state.fingerprint): + if state.restore_requested or definitions_changed or (state.fingerprint is not None and fingerprint != state.fingerprint): state.refresh() except Exception: log_error() @@ -746,6 +803,8 @@ def run(context): bind(APP.documentSaving, DocumentEvent('saving')) bind(APP.documentSaved, DocumentEvent('saved')) 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)) @@ -755,6 +814,7 @@ def run(context): 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.') diff --git a/README.md b/README.md index 2dac520..177ede1 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ Keep the extracted folder in place while Fusion uses it. No separate Python inst ## Status and limits - In the current source candidate, **OK** stores geometry references, measurement types, placement offsets and individual/global visibility in `Design.attributes`. Values are remeasured from geometry. Unsupported or damaged saved data is not silently overwritten. This implementation does not establish safe model saving. -- An update is queued after a Fusion model command ends, using a custom event on Fusion's permitted thread. Native acceptance of all geometry edits, Undo/Redo and recovery paths remains pending. +- An update is queued after a Fusion model command ends, using a custom event on Fusion's permitted thread. Loading definitions when a document opens or Mesora starts, and deferred display in a safe Design context, are implemented with event gating. Actual native delivery and automatic display after managed restart/reopen have not been established; geometry edits, Undo/Redo and recovery acceptance remain pending. - The UI save handler removes tracked graphics and intentionally does not recreate them in `documentSaved` or on workspace activation. After a save, open Mesora or use **Refresh Dimensions** to restore graphics. This workaround is not the intended complete save/reopen experience; API Save As reproduced the persistent-artifact defect described above. - macOS native tests have exercised row/global visibility and Drawing creation on synthetic designs. Full save, Save As, close/reopen and restart acceptance is incomplete. Transformed/nested occurrences and broader picking/appearance scenarios still need validation. Offline tests do not establish native Fusion acceptance. - The manifest declares Windows and macOS. Windows native acceptance and full restart gates are outstanding. A stable release requires the artifact defect to be resolved and these gates to pass. diff --git a/README.ru.md b/README.ru.md index a845271..5a6357d 100644 --- a/README.ru.md +++ b/README.ru.md @@ -25,7 +25,7 @@ ## Статус и ограничения - В текущих исходниках кандидата **OK** записывает ссылки на геометрию, типы измерений, смещения и индивидуальную/общую видимость в `Design.attributes`. Значения заново вычисляются по геометрии. Неподдерживаемые или повреждённые данные не перезаписываются молча. Наличие этой реализации не подтверждает безопасность сохранения модели. -- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Нативная приёмка всех изменений геометрии, Undo/Redo и восстановления пока не завершена. +- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Реализованы загрузка определений при открытии документа или запуске Mesora и отложенный показ в безопасном контексте Design с проверкой событий и состояния. Фактическая нативная доставка событий и автоматический показ после штатного перезапуска аддона/повторного открытия ещё не подтверждены; приёмка изменений геометрии, Undo/Redo и восстановления не завершена. - Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Это временный обходной путь, а не завершённый сценарий сохранения и повторного открытия; API Save As воспроизвёл описанный выше постоянный артефакт. - На macOS в синтетических моделях нативно проверялись индивидуальная/общая видимость и создание Drawing. Полная приёмка сохранения, Save As, закрытия/повторного открытия и перезапуска не завершена. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. - В манифесте заявлены Windows и macOS. Нативная приёмка Windows и проверки полного перезапуска ещё не пройдены. Для стабильного релиза нужно устранить постоянный артефакт и пройти эти проверки. diff --git a/README_RU.md b/README_RU.md index a845271..5a6357d 100644 --- a/README_RU.md +++ b/README_RU.md @@ -25,7 +25,7 @@ ## Статус и ограничения - В текущих исходниках кандидата **OK** записывает ссылки на геометрию, типы измерений, смещения и индивидуальную/общую видимость в `Design.attributes`. Значения заново вычисляются по геометрии. Неподдерживаемые или повреждённые данные не перезаписываются молча. Наличие этой реализации не подтверждает безопасность сохранения модели. -- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Нативная приёмка всех изменений геометрии, Undo/Redo и восстановления пока не завершена. +- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Реализованы загрузка определений при открытии документа или запуске Mesora и отложенный показ в безопасном контексте Design с проверкой событий и состояния. Фактическая нативная доставка событий и автоматический показ после штатного перезапуска аддона/повторного открытия ещё не подтверждены; приёмка изменений геометрии, Undo/Redo и восстановления не завершена. - Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Это временный обходной путь, а не завершённый сценарий сохранения и повторного открытия; API Save As воспроизвёл описанный выше постоянный артефакт. - На macOS в синтетических моделях нативно проверялись индивидуальная/общая видимость и создание Drawing. Полная приёмка сохранения, Save As, закрытия/повторного открытия и перезапуска не завершена. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. - В манифесте заявлены Windows и macOS. Нативная приёмка Windows и проверки полного перезапуска ещё не пройдены. Для стабильного релиза нужно устранить постоянный артефакт и пройти эти проверки. diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index 09b044d..4c9fb6c 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -22,7 +22,13 @@ attributes through `dimensions/runtime_persistence.py`; values are recalculated. Schema v2 supports all current measurement types and reads schema v1. Unknown, corrupted or future data must not be silently overwritten. Automatic model updates use `commandTerminated` and a deferred custom event; native acceptance remains -incomplete. +incomplete. Definition loading on document open and add-in startup now requests +an event-gated deferred restore; document activation only resumes an existing +request, and saving clears it. Actual native callback delivery and automatic +rendering after managed add-in restart/reopen remain unconfirmed. See the latest +rerun in the native report below; full Fusion restart acceptance is still pending. +The independent `scripts/native_acceptance_observer.py` is development tooling, +not part of the shipped add-in. A macOS API Save As test reproduced a visible persistent CustomGraphics annotation after stopping Mesora and reopening the file, even with a zero API group count. diff --git a/docs/DEVELOPMENT.ru.md b/docs/DEVELOPMENT.ru.md index 7805962..208da30 100644 --- a/docs/DEVELOPMENT.ru.md +++ b/docs/DEVELOPMENT.ru.md @@ -22,7 +22,14 @@ python3 scripts/build.py --version 1.0.0 пересчитываются. Схема v2 поддерживает все текущие типы измерений и читает схему v1. Неизвестные, повреждённые или будущие данные нельзя молча перезаписывать. Автоматическое обновление модели использует `commandTerminated` и отложенный -custom event; нативная приёмка ещё не завершена. +custom event; нативная приёмка ещё не завершена. Загрузка определений при открытии +документа и запуске аддона теперь запрашивает отложенное восстановление с проверкой +событий и состояния; активация документа лишь продолжает существующий запрос, +а сохранение снимает его. Фактическая нативная доставка callback и автоматический +показ после штатного перезапуска аддона/повторного открытия ещё не подтверждены. +См. последний повторный прогон в нативном отчёте ниже; приёмка полного перезапуска +Fusion остаётся открытой. Независимый `scripts/native_acceptance_observer.py` — +инструмент разработки, не часть поставляемого аддона. Проверка API Save As на macOS воспроизвела видимый постоянный размер CustomGraphics после остановки Mesora и повторного открытия файла даже при нулевом счётчике групп diff --git a/docs/validation/stability-native-2026-11-13.ru.md b/docs/validation/stability-native-2026-11-13.ru.md index 1229b7f..590eafb 100644 --- a/docs/validation/stability-native-2026-11-13.ru.md +++ b/docs/validation/stability-native-2026-11-13.ru.md @@ -42,9 +42,21 @@ SHA-256 `orphan-after-model-edit.png`: `47c07c3a99df266aa8c1e12a354f6dccb5c89631 SHA-256 контрольного `prepared-save-without-mesora.png`: `098843b277603d26619d798adfa1661b5a66e4e8ed763b6585408446b3d226fe`. -## Локальные quality gates +## Локальные quality gates первоначального этапа -На итоговом рабочем кандидате прошли компиляция, **103 offline tests**, `scripts/check_project.py`, `git diff --check`. Проверена детерминированная сборка 54 файлов с новыми модулями и четырьмя иконками; UUID сохранён. Локальный ZIP `dist/stability-validation/Mesora-0.0.0.zip` имеет SHA-256 `fcf1dce909048810f39033c400e67d46351eee138d083e3099a30afe49214381`. `0.0.0` — только числовая заглушка для проверки упаковки, не назначенная версия релиза. Штатную версию определяет GitVersion 6.8.2. Этот ZIP не публиковать как stable. +На кандидате первоначального этапа (`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. ## Необходимая повторная проверка diff --git a/docs/validation/stable-release-cjm-2026-11-13.ru.md b/docs/validation/stable-release-cjm-2026-11-13.ru.md index 05f4ace..86b27ba 100644 --- a/docs/validation/stable-release-cjm-2026-11-13.ru.md +++ b/docs/validation/stable-release-cjm-2026-11-13.ru.md @@ -4,7 +4,7 @@ ## Продуктовая цель -Конструктор один раз создаёт информационные размеры и использует их при изменении, сохранении и передаче модели в Drawing. Он может убрать визуальный шум без потери измерений и вернуться к работе после закрытия Fusion. Размеры соответствуют актуальной геометрии; недоступная ссылка явно обозначена, старое число не выдаётся за актуальное. Mesora не создаёт повторные сохранения и не оставляет неуправляемую графику в файле. +Конструктор один раз создаёт информационные размеры и использует их при изменении, сохранении и передаче модели в Drawing. По уточнению пользователя графика существует только при работающей Mesora; в проекте сохраняются определения измерений и настройки, а не отображаемые аннотации. Он может убрать визуальный шум без потери измерений и вернуться к работе после закрытия Fusion. Размеры соответствуют актуальной геометрии; недоступная ссылка явно обозначена, старое число не выдаётся за актуальное. Mesora не создаёт повторные сохранения и не оставляет неуправляемую графику в файле. ## CJM @@ -47,7 +47,7 @@ | S15 | Два документа и Drawing не смешивают definitions/visibility; закрытие не держит stale state | Persistence stub isolation PASS | Model A→B→Drawing→A, закрыть B, новый C: PENDING | Проверить events принадлежат нужному document | | S16 | Transformed/nested occurrences, orbit, zoom, units дают корректные числа/позиции | Geometry context/renderer layout tests PASS | macOS/Windows PENDING; ненулевой transform, вложенные компоненты, mm/in | Старый zero-transform smoke недостаточен | | S17 | Повреждённый/будущий schema не перезаписывается; ошибка понятна, остальные документы работают | `test_persistence`, schema tests PASS | Синтетические attributes fixtures: PENDING | D01; runtime должен fail closed и сохранять исходный payload | -| S19 | Использовать проект без установленной/запущенной Mesora: геометрия доступна для edit/save; reopen без orphan; после подключения Mesora определения восстановлены по актуальной геометрии | Offline persistence покрывает независимые определения, но не сериализацию CAD | **macOS FAIL (прогон root)**: без Mesora геометрия редактируется (радиус 2→2.5 cm), save/reopen успешны, API graphicsCount=0; визуально остаётся orphan с устаревшим 125.7 mm вместо актуального 157.1 mm. Доказательство: `dist/local-validation/orphan-after-model-edit.png` (root просмотрел). Windows PENDING; восстановление Mesora после этого требует отдельной проверки | Обязательный пользовательский gate; данные не должны зависеть от наличия аддина | +| S19 | Использовать проект без установленной/запущенной Mesora: аннотаций Mesora НЕТ, геометрия доступна для edit/save, definitions сохранены; после подключения Mesora набор автоматически восстановлен и отрисован по актуальной геометрии | Offline persistence покрывает независимые определения, но не сериализацию CAD | **macOS FAIL (прогон root)**: без Mesora геометрия редактируется (радиус 2→2.5 cm), save/reopen успешны, API graphicsCount=0; визуально остаётся orphan с устаревшим 125.7 mm вместо актуального 157.1 mm. Доказательство: `dist/local-validation/orphan-after-model-edit.png` (root просмотрел). Windows PENDING; восстановление Mesora после этого требует отдельной проверки | Обязательный пользовательский gate; данные не должны зависеть от наличия аддина | | S18 | Финальный release ZIP устанавливается, версия/notes/checksum совпадают, CI зелёный | `test_reproducible_zip_and_checksum`: PASS baseline | Финальный ZIP и GitHub Release PENDING | GitVersion 6.8.2; штатный immutable publish после gates | ## Дефекты исходного состояния и повторная проверка @@ -81,3 +81,31 @@ D01/D02/D03 имеют реализацию и офлайн-регрессии; На последнем рабочем коде **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 FAIL и 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 или приватные пути в коммитах. diff --git a/docs/visibility-and-drawing.md b/docs/visibility-and-drawing.md index 5b37c4b..edafe9c 100644 --- a/docs/visibility-and-drawing.md +++ b/docs/visibility-and-drawing.md @@ -26,12 +26,22 @@ event on Fusion's permitted execution thread. Native acceptance of geometry edit Undo/Redo and full recovery is still pending; implementation and offline tests are not evidence that every native path works. +The candidate also implements definition loading on document open and Mesora +startup. Display is requested through a deferred custom event; activation may +resume an existing open/startup request, while workspace, active-document and +active-command checks gate rendering. Saving clears the pending restore request. +This code is not native acceptance: actual callback delivery and automatic display +after managed add-in restart/reopen remain unconfirmed. See the latest rerun in +[native evidence](validation/stability-native-2026-11-13.ru.md); no full Fusion +restart acceptance has been completed. + When the UI save event runs, Mesora removes tracked graphics before saving. It deliberately does not recreate them inside `documentSaved`: that makes the source design modified again and can make Drawing creation repeatedly save the source. After a save, open Mesora or use **Refresh Dimensions** to show the dimensions -again. Document/workspace activation also leaves restoration to explicit actions, -because Drawing can activate its source during creation. The camera handler does +again. Document activation alone does not create a new restore request, because +Drawing can activate its source during creation; it may only resume an existing +open/startup request. Workspace activation does not recreate graphics. The camera handler does not update model graphics in Drawing or during workspace transitions. This is a temporary workaround, not complete normal save/reopen behavior. The API diff --git a/docs/visibility-and-drawing.ru.md b/docs/visibility-and-drawing.ru.md index 1f2b3c2..8db386b 100644 --- a/docs/visibility-and-drawing.ru.md +++ b/docs/visibility-and-drawing.ru.md @@ -26,13 +26,24 @@ полного восстановления ещё не завершена; реализация и автономные тесты не подтверждают работу всех нативных сценариев. +Кандидат также реализует загрузку определений при открытии документа и запуске +Mesora. Показ запрашивается через отложенный custom event; активация может +продолжить уже существующий запрос от открытия/запуска, а проверки рабочей среды, +активного документа и команды ограничивают создание графики. Сохранение снимает +ожидающий запрос восстановления. Этот код не является нативной приёмкой: +фактическая доставка callback и автоматический показ после штатного перезапуска +аддона/повторного открытия не подтверждены. См. последний повторный прогон в +[нативных доказательствах](validation/stability-native-2026-11-13.ru.md); приёмка +полного перезапуска Fusion не выполнена. + Когда срабатывает событие сохранения через UI, Mesora удаляет отслеживаемую графику перед сохранением. Она намеренно не пересоздаётся в `documentSaved`: это снова помечало модель изменённой и могло вызывать повторное сохранение при создании Drawing. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, -чтобы вернуть размеры. При активации документа и смене рабочей среды восстановление -также оставлено явным действиям: Drawing может активировать исходную модель в ходе -создания. Обработчик камеры не меняет графику модели в Drawing и во время +чтобы вернуть размеры. Сама активация документа не создаёт нового запроса +восстановления: Drawing может активировать исходную модель в ходе создания. Она +может лишь продолжить существующий запрос от открытия/запуска. Активация рабочей +среды не пересоздаёт графику. Обработчик камеры не меняет графику модели в Drawing и во время переключения рабочих сред. Это временный обходной путь, а не завершённый сценарий нормального сохранения и diff --git a/scripts/native_acceptance_observer.py b/scripts/native_acceptance_observer.py new file mode 100644 index 0000000..5dd85ce --- /dev/null +++ b/scripts/native_acceptance_observer.py @@ -0,0 +1,262 @@ +"""Read-only Fusion event observer for synthetic Mesora acceptance documents. + +Import inside Fusion, then call start('/absolute/path/trace.jsonl'), probe(), +snapshot('label') and stop(). Keep this module imported until stop completes. +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} + 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/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'}) From 6f223e3eb50da6d79427a69656923b1fa011b4ad Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Fri, 13 Nov 2026 19:14:04 +0300 Subject: [PATCH 3/8] fix: reconcile graphics restored by Fusion Undo Fusion revives deleted custom graphics with new wrappers. Tag owned groups and reconcile the real collection before refresh, save and stop while preserving staged and foreign groups. Native metadata Undo passed but the observer exposed two actual groups for one tracked group; offline regressions reproduce that pattern. Native tag preservation and full lifecycle reacceptance remain pending. --- Mesora/Mesora.py | 17 ++- Mesora/renderer.py | 32 +++++ README.md | 10 +- README.ru.md | 10 +- README_RU.md | 10 +- docs/DEVELOPMENT.md | 45 ++++--- docs/DEVELOPMENT.ru.md | 46 +++++--- docs/fusion-safety.md | 40 +++++-- docs/fusion-safety.ru.md | 46 ++++++-- .../observer-and-ax-recovery-2026-11-13.ru.md | 65 ++++++++++ .../stability-native-2026-11-13.ru.md | 69 ++++++++++- .../stable-release-cjm-2026-11-13.ru.md | 54 +++++++-- docs/visibility-and-drawing.md | 47 +++++--- docs/visibility-and-drawing.ru.md | 52 +++++--- scripts/native_acceptance_observer.py | 8 +- scripts/prepare_native_observer.py | 59 ++++++++++ tests/test_batch_apply.py | 2 +- tests/test_owned_lifecycle.py | 111 ++++++++++++++++++ tests/test_renderer_model_plane.py | 39 ++++++ tests/test_visibility_lifecycle.py | 5 + 20 files changed, 639 insertions(+), 128 deletions(-) create mode 100644 docs/validation/observer-and-ax-recovery-2026-11-13.ru.md create mode 100644 scripts/prepare_native_observer.py create mode 100644 tests/test_owned_lifecycle.py diff --git a/Mesora/Mesora.py b/Mesora/Mesora.py index 637cb5c..42d9347 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -99,7 +99,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(): @@ -113,8 +113,14 @@ 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(): @@ -615,7 +621,7 @@ def notify(self, args): 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)) - state.erase() + 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)}, @@ -669,8 +675,7 @@ def notify(self, args): if not state: return try: if self.mode == 'saving': - if state.groups or state.preview is not None or state.live_preview: - state.erase() + state.erase() state.removed_for_save = True state.restore_requested = False state.fingerprint = geometry_fingerprint(state.design, state.items, resolve, measure) diff --git a/Mesora/renderer.py b/Mesora/renderer.py index 7d82028..414465e 100644 --- a/Mesora/renderer.py +++ b/Mesora/renderer.py @@ -1,5 +1,6 @@ """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 @@ -7,6 +8,7 @@ _LABELS = {} _ANGLES = {} +OWNERSHIP_PREFIX = '4FusionLab.Mesora.89072f8c-cdca-48bf-8a2a-440c9ae898e6.graphics.v1:' def xyz(p): return (p.x, p.y, p.z) @@ -18,6 +20,33 @@ def forget(group): _ANGLES.pop(id(group), None) +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): """Keep the projected arc large enough for its caption, even on short edges.""" steps = max(16, int(math.ceil(value / (math.pi / 48)))) @@ -351,6 +380,9 @@ 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 diff --git a/README.md b/README.md index 177ede1..4947117 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@

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

-> **Experimental validation candidate: use disposable documents only.** A stable release is withheld. Native macOS testing reproduced a persistent CustomGraphics artifact after API Save As, stopping Mesora, closing and reopening: the annotation remained visible although `customGraphicsGroups.count` was zero. Removing graphics before a save is not a safety guarantee. Do not use this candidate to save valuable designs. See [safety research](docs/fusion-safety.md), [current validation status](docs/visibility-and-drawing.md) and [native evidence](docs/validation/stability-native-2026-11-13.ru.md). +> **Experimental validation candidate: use disposable documents only.** A stable release is withheld: managed Undo reproduced duplicate graphics; cleanup needs correction and native retesting. Managed macOS GUI testing passed save cleanup, reopening and editing without Mesora, and restoration after starting Mesora. Earlier orphan graphics came from a different Python loading/API test path and do not establish a failure of the current managed GUI save path. API save paths, full Fusion restart, current Drawing, parametric updates and Windows remain to be accepted. See [safety research](docs/fusion-safety.md), [current validation status](docs/visibility-and-drawing.md) and [native evidence](docs/validation/stability-native-2026-11-13.ru.md). The download above is the previously published experimental 1.0.0. The persistence, visibility and update changes described below are in the current source candidate and have not been published as a stable release. @@ -25,10 +25,10 @@ Keep the extracted folder in place while Fusion uses it. No separate Python inst ## Status and limits - In the current source candidate, **OK** stores geometry references, measurement types, placement offsets and individual/global visibility in `Design.attributes`. Values are remeasured from geometry. Unsupported or damaged saved data is not silently overwritten. This implementation does not establish safe model saving. -- An update is queued after a Fusion model command ends, using a custom event on Fusion's permitted thread. Loading definitions when a document opens or Mesora starts, and deferred display in a safe Design context, are implemented with event gating. Actual native delivery and automatic display after managed restart/reopen have not been established; geometry edits, Undo/Redo and recovery acceptance remain pending. -- The UI save handler removes tracked graphics and intentionally does not recreate them in `documentSaved` or on workspace activation. After a save, open Mesora or use **Refresh Dimensions** to restore graphics. This workaround is not the intended complete save/reopen experience; API Save As reproduced the persistent-artifact defect described above. -- macOS native tests have exercised row/global visibility and Drawing creation on synthetic designs. Full save, Save As, close/reopen and restart acceptance is incomplete. Transformed/nested occurrences and broader picking/appearance scenarios still need validation. Offline tests do not establish native Fusion acceptance. -- The manifest declares Windows and macOS. Windows native acceptance and full restart gates are outstanding. A stable release requires the artifact defect to be resolved and these gates to pass. +- An update is queued after a Fusion model command ends, using a custom event on Fusion's permitted thread. Definitions load when a document opens or Mesora starts; deferred display is gated by document, workspace and command state. Managed macOS startup restored visibility, offsets and values after geometry was edited and saved without Mesora. Full parametric update acceptance remains incomplete. +- The UI save handler removes tracked graphics and intentionally does not recreate them in `documentSaved` or on workspace activation. After a save, open Mesora or use **Refresh Dimensions** to restore graphics. Managed GUI Save and Save As confirmed cleanup; Save As cancellation preserved the current dimensions. Copy isolation and all save/recovery paths remain to be accepted. +- macOS GUI tests passed individual/global visibility, applying eye settings, and the checked save/reopen path without the add-in: no dimensions were visible with Mesora stopped. Undo/Redo restored visibility metadata, but Undo revived an untracked graphics group and the deferred redraw added a duplicate: graphics Undo acceptance failed. Cleanup and native retesting are required. An earlier orphan from a different loading/API test path requires a separate rerun. Prior Drawing evidence does not accept Drawing on the latest persistence/update candidate. Transformed/nested occurrences and broader picking/appearance scenarios also need validation. Offline tests do not establish native Fusion acceptance. +- The manifest declares Windows and macOS. Undo graphics cleanup and native retesting, Windows native acceptance, full Fusion restart, current Drawing, parametric changes and remaining save/recovery gates are outstanding. The candidate remains experimental until these gates pass. ## Development and support diff --git a/README.ru.md b/README.ru.md index 5a6357d..eafa5cb 100644 --- a/README.ru.md +++ b/README.ru.md @@ -3,7 +3,7 @@

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

-> **Экспериментальный кандидат для проверки: только тестовые документы.** Стабильный релиз отложен. При нативной проверке на macOS после API Save As, остановки Mesora, закрытия и повторного открытия обнаружен постоянный артефакт CustomGraphics: размер оставался видимым, хотя `customGraphicsGroups.count` был равен нулю. Удаление графики перед сохранением не гарантирует безопасность. Не сохраняйте ценные модели с этим кандидатом. Подробнее — в [исследовании](docs/fusion-safety.ru.md) и [текущем статусе проверки](docs/visibility-and-drawing.ru.md), а также [нативных доказательствах](docs/validation/stability-native-2026-11-13.ru.md). +> **Экспериментальный кандидат для проверки: только тестовые документы.** Стабильный релиз отложен: штатный Undo воспроизвёл дублирование графики; нужны исправление очистки и повторная нативная проверка. Штатная GUI-проверка macOS подтвердила очистку при сохранении, повторное открытие и редактирование без Mesora, а также восстановление после запуска Mesora. Ранее постоянная графика получена в другом пути загрузки Python/API и не доказывает неисправность текущего штатного пути GUI-сохранения. Сохранение через API, полный перезапуск Fusion, актуальный Drawing, параметрические изменения и Windows ещё требуют приёмки. См. [исследование](docs/fusion-safety.ru.md), [текущий статус проверки](docs/visibility-and-drawing.ru.md) и [нативные доказательства](docs/validation/stability-native-2026-11-13.ru.md). Ссылка выше ведёт на ранее опубликованную экспериментальную версию 1.0.0. Описанные ниже изменения сохранения определений, видимости и обновления находятся в текущих исходниках кандидата; стабильный релиз с ними не опубликован. @@ -25,10 +25,10 @@ ## Статус и ограничения - В текущих исходниках кандидата **OK** записывает ссылки на геометрию, типы измерений, смещения и индивидуальную/общую видимость в `Design.attributes`. Значения заново вычисляются по геометрии. Неподдерживаемые или повреждённые данные не перезаписываются молча. Наличие этой реализации не подтверждает безопасность сохранения модели. -- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Реализованы загрузка определений при открытии документа или запуске Mesora и отложенный показ в безопасном контексте Design с проверкой событий и состояния. Фактическая нативная доставка событий и автоматический показ после штатного перезапуска аддона/повторного открытия ещё не подтверждены; приёмка изменений геометрии, Undo/Redo и восстановления не завершена. -- Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Это временный обходной путь, а не завершённый сценарий сохранения и повторного открытия; API Save As воспроизвёл описанный выше постоянный артефакт. -- На macOS в синтетических моделях нативно проверялись индивидуальная/общая видимость и создание Drawing. Полная приёмка сохранения, Save As, закрытия/повторного открытия и перезапуска не завершена. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. -- В манифесте заявлены Windows и macOS. Нативная приёмка Windows и проверки полного перезапуска ещё не пройдены. Для стабильного релиза нужно устранить постоянный артефакт и пройти эти проверки. +- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Определения загружаются при открытии документа или запуске Mesora; отложенный показ ограничивается состоянием документа, рабочей среды и команды. Штатный запуск на macOS восстановил видимость, смещения и актуальные значения после изменения и сохранения геометрии без Mesora. Полная приёмка параметрического обновления не завершена. +- Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Штатные GUI Save и Save As подтвердили очистку; отмена Save As сохранила текущие размеры. Изоляция копии и все пути сохранения/восстановления ещё требуют приёмки. +- GUI-проверки macOS подтвердили индивидуальную/общую видимость, применение глазиков и проверенный путь сохранения/повторного открытия без аддона: при остановленной Mesora размеров не было. Undo/Redo восстанавливали метаданные видимости, но Undo вернул неотслеживаемую группу графики, а отложенная перерисовка добавила дубликат: графическая приёмка Undo не пройдена. Нужны исправление очистки и повторная нативная проверка. Прежний постоянный артефакт из другого пути загрузки/API требует отдельного повторного прогона. Предыдущая проверка Drawing не подтверждает Drawing на актуальном кандидате с сохранением определений и обновлениями. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения также требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. +- В манифесте заявлены Windows и macOS. Очистка графики Undo с повторной нативной проверкой, приёмка Windows, полный перезапуск Fusion, актуальный Drawing, параметрические изменения и оставшиеся пути сохранения/восстановления ещё не пройдены. До их прохождения кандидат остаётся экспериментальным. ## Разработка и поддержка diff --git a/README_RU.md b/README_RU.md index 5a6357d..eafa5cb 100644 --- a/README_RU.md +++ b/README_RU.md @@ -3,7 +3,7 @@

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

-> **Экспериментальный кандидат для проверки: только тестовые документы.** Стабильный релиз отложен. При нативной проверке на macOS после API Save As, остановки Mesora, закрытия и повторного открытия обнаружен постоянный артефакт CustomGraphics: размер оставался видимым, хотя `customGraphicsGroups.count` был равен нулю. Удаление графики перед сохранением не гарантирует безопасность. Не сохраняйте ценные модели с этим кандидатом. Подробнее — в [исследовании](docs/fusion-safety.ru.md) и [текущем статусе проверки](docs/visibility-and-drawing.ru.md), а также [нативных доказательствах](docs/validation/stability-native-2026-11-13.ru.md). +> **Экспериментальный кандидат для проверки: только тестовые документы.** Стабильный релиз отложен: штатный Undo воспроизвёл дублирование графики; нужны исправление очистки и повторная нативная проверка. Штатная GUI-проверка macOS подтвердила очистку при сохранении, повторное открытие и редактирование без Mesora, а также восстановление после запуска Mesora. Ранее постоянная графика получена в другом пути загрузки Python/API и не доказывает неисправность текущего штатного пути GUI-сохранения. Сохранение через API, полный перезапуск Fusion, актуальный Drawing, параметрические изменения и Windows ещё требуют приёмки. См. [исследование](docs/fusion-safety.ru.md), [текущий статус проверки](docs/visibility-and-drawing.ru.md) и [нативные доказательства](docs/validation/stability-native-2026-11-13.ru.md). Ссылка выше ведёт на ранее опубликованную экспериментальную версию 1.0.0. Описанные ниже изменения сохранения определений, видимости и обновления находятся в текущих исходниках кандидата; стабильный релиз с ними не опубликован. @@ -25,10 +25,10 @@ ## Статус и ограничения - В текущих исходниках кандидата **OK** записывает ссылки на геометрию, типы измерений, смещения и индивидуальную/общую видимость в `Design.attributes`. Значения заново вычисляются по геометрии. Неподдерживаемые или повреждённые данные не перезаписываются молча. Наличие этой реализации не подтверждает безопасность сохранения модели. -- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Реализованы загрузка определений при открытии документа или запуске Mesora и отложенный показ в безопасном контексте Design с проверкой событий и состояния. Фактическая нативная доставка событий и автоматический показ после штатного перезапуска аддона/повторного открытия ещё не подтверждены; приёмка изменений геометрии, Undo/Redo и восстановления не завершена. -- Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Это временный обходной путь, а не завершённый сценарий сохранения и повторного открытия; API Save As воспроизвёл описанный выше постоянный артефакт. -- На macOS в синтетических моделях нативно проверялись индивидуальная/общая видимость и создание Drawing. Полная приёмка сохранения, Save As, закрытия/повторного открытия и перезапуска не завершена. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. -- В манифесте заявлены Windows и macOS. Нативная приёмка Windows и проверки полного перезапуска ещё не пройдены. Для стабильного релиза нужно устранить постоянный артефакт и пройти эти проверки. +- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Определения загружаются при открытии документа или запуске Mesora; отложенный показ ограничивается состоянием документа, рабочей среды и команды. Штатный запуск на macOS восстановил видимость, смещения и актуальные значения после изменения и сохранения геометрии без Mesora. Полная приёмка параметрического обновления не завершена. +- Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Штатные GUI Save и Save As подтвердили очистку; отмена Save As сохранила текущие размеры. Изоляция копии и все пути сохранения/восстановления ещё требуют приёмки. +- GUI-проверки macOS подтвердили индивидуальную/общую видимость, применение глазиков и проверенный путь сохранения/повторного открытия без аддона: при остановленной Mesora размеров не было. Undo/Redo восстанавливали метаданные видимости, но Undo вернул неотслеживаемую группу графики, а отложенная перерисовка добавила дубликат: графическая приёмка Undo не пройдена. Нужны исправление очистки и повторная нативная проверка. Прежний постоянный артефакт из другого пути загрузки/API требует отдельного повторного прогона. Предыдущая проверка Drawing не подтверждает Drawing на актуальном кандидате с сохранением определений и обновлениями. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения также требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. +- В манифесте заявлены Windows и macOS. Очистка графики Undo с повторной нативной проверкой, приёмка Windows, полный перезапуск Fusion, актуальный Drawing, параметрические изменения и оставшиеся пути сохранения/восстановления ещё не пройдены. До их прохождения кандидат остаётся экспериментальным. ## Разработка и поддержка diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index 4c9fb6c..a0837e9 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -21,21 +21,34 @@ release. Explicit command commits store references and settings in design attributes through `dimensions/runtime_persistence.py`; values are recalculated. Schema v2 supports all current measurement types and reads schema v1. Unknown, corrupted or future data must not be silently overwritten. Automatic model updates -use `commandTerminated` and a deferred custom event; native acceptance remains -incomplete. Definition loading on document open and add-in startup now requests -an event-gated deferred restore; document activation only resumes an existing -request, and saving clears it. Actual native callback delivery and automatic -rendering after managed add-in restart/reopen remain unconfirmed. See the latest -rerun in the native report below; full Fusion restart acceptance is still pending. -The independent `scripts/native_acceptance_observer.py` is development tooling, -not part of the shipped add-in. - -A macOS API Save As test reproduced a visible persistent CustomGraphics annotation -after stopping Mesora and reopening the file, even with a zero API group count. -The UI save cleanup/manual **Refresh Dimensions** workaround does not establish -normal save/reopen safety. The stable release is withheld pending resolution, -Windows native acceptance and full restart gates. See the -[native report](validation/stability-native-2026-11-13.ru.md) and +use `commandTerminated` and a deferred custom event. Loading on document open and +startup requests a restore; activation resumes an existing request and saving +clears it. Managed macOS GUI testing confirmed startup/reopen restoration, +visibility application, Save/Save As cleanup and Save As cancellation. Undo/Redo +restored visibility metadata, but graphics Undo failed: a revived untracked group +plus deferred rendering produced two actual groups while State tracked one. +Cleanup correction and native retesting remain required. +The checked model reopened without dimensions while Mesora was stopped, remained +editable/savable, and restored current measurements when Mesora started. + +Earlier orphan findings came from a different Python loading/API path and do not +establish a failure of the current managed GUI save path. Separately rerun API +Save/Save As with managed startup. Manual **Refresh Dimensions** after save remains +a workaround, and full save/recovery acceptance is incomplete. + +For independent event evidence, run the development observer through Fusion's +managed add-in lifecycle, using `scripts/prepare_native_observer.py`. A direct +MCP import did not deliver observer callbacks and cannot establish their absence +in the managed product. Neither observer script is part of the shipped add-in. + +Parametric acceptance was interrupted during CUA accessibility inspection of +Change Parameters; the observed AX/Qt stack does not establish Mesora causality. +Manual recovery was requested without force terminating an unsaved user document. +This scenario remains inconclusive. Stable publication is withheld pending +Undo graphics cleanup/retesting, parametric changes, latest-candidate Drawing, full Fusion restart, Windows and +remaining save/recovery gates. See the +[native report](validation/stability-native-2026-11-13.ru.md), +[observer/recovery notes](validation/observer-and-ax-recovery-2026-11-13.ru.md) and [CJM and acceptance traceability](validation/stable-release-cjm-2026-11-13.ru.md). ## Native acceptance @@ -43,6 +56,6 @@ Windows native acceptance and full restart gates. See the For the Drawing save-loop regression and row/global visibility controls, follow the checks in [Visibility and Drawing](visibility-and-drawing.md). -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. For each save path, stop the add-in and inspect reopened files visually as well as checking group counts. CustomGraphics save/reopen safety is **not established**, and an inaccessible saved annotation has been reproduced; do not save valuable designs while the add-in is running. See [Fusion safety notes](fusion-safety.md). +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. For each save path, stop the add-in and inspect reopened files visually as well as checking group counts. Acceptance of all CustomGraphics save/reopen paths is **not complete**; do not save valuable designs while the add-in is running. See [Fusion safety notes](fusion-safety.md). 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. diff --git a/docs/DEVELOPMENT.ru.md b/docs/DEVELOPMENT.ru.md index 208da30..e761e60 100644 --- a/docs/DEVELOPMENT.ru.md +++ b/docs/DEVELOPMENT.ru.md @@ -22,21 +22,35 @@ python3 scripts/build.py --version 1.0.0 пересчитываются. Схема v2 поддерживает все текущие типы измерений и читает схему v1. Неизвестные, повреждённые или будущие данные нельзя молча перезаписывать. Автоматическое обновление модели использует `commandTerminated` и отложенный -custom event; нативная приёмка ещё не завершена. Загрузка определений при открытии -документа и запуске аддона теперь запрашивает отложенное восстановление с проверкой -событий и состояния; активация документа лишь продолжает существующий запрос, -а сохранение снимает его. Фактическая нативная доставка callback и автоматический -показ после штатного перезапуска аддона/повторного открытия ещё не подтверждены. -См. последний повторный прогон в нативном отчёте ниже; приёмка полного перезапуска -Fusion остаётся открытой. Независимый `scripts/native_acceptance_observer.py` — -инструмент разработки, не часть поставляемого аддона. - -Проверка API Save As на macOS воспроизвела видимый постоянный размер CustomGraphics -после остановки Mesora и повторного открытия файла даже при нулевом счётчике групп -API. Очистка при UI save и ручной **Refresh Dimensions** не подтверждают -безопасность нормального сохранения и повторного открытия. Стабильный релиз -отложен до устранения дефекта, нативной приёмки Windows и проверки полного -перезапуска. См. [нативный отчёт](validation/stability-native-2026-11-13.ru.md) и +custom event. Загрузка при открытии документа и запуске запрашивает восстановление; +активация продолжает существующий запрос, а сохранение снимает его. Штатная +GUI-проверка macOS подтвердила восстановление при запуске/повторном открытии, +применение видимости, очистку в Save/Save As и отмену Save As. Undo/Redo +восстанавливали метаданные видимости, но графическая приёмка Undo провалена: +возвращённая неотслеживаемая группа и отложенная перерисовка дали две реальные +группы при одной в State. Нужны исправление очистки и нативная перепроверка. +Проверенная модель открывалась без размеров при остановленной Mesora, оставалась +доступна для изменения/сохранения и восстанавливала актуальные измерения после +запуска Mesora. + +Прежний постоянный артефакт получен в другом пути загрузки Python/API и не +доказывает неисправность текущего штатного пути GUI-сохранения. API Save/Save As +нужно отдельно повторить со штатным запуском. Ручной **Refresh Dimensions** после +сохранения остаётся обходным путём; полная приёмка сохранения/восстановления не завершена. + +Для независимого доказательства событий запускайте development observer через +штатный жизненный цикл аддона Fusion с помощью `scripts/prepare_native_observer.py`. +Прямой импорт через MCP не дал callback наблюдателя и не доказывает их отсутствие +у штатного продукта. Оба скрипта observer не входят в поставляемый аддон. + +Параметрическая приёмка прервалась при чтении CUA дерева доступности Change +Parameters; наблюдаемый AX/Qt-стек не устанавливает причинность Mesora. Запрошено +ручное восстановление без принудительного завершения несохранённого пользовательского +документа. Сценарий остаётся неопределённым. Стабильная публикация отложена до +исправления и перепроверки очистки графики Undo, параметрических изменений, Drawing на актуальном кандидате, полного перезапуска +Fusion, Windows и остальных проверок сохранения/восстановления. См. +[нативный отчёт](validation/stability-native-2026-11-13.ru.md), +[заметки observer/восстановления](validation/observer-and-ax-recovery-2026-11-13.ru.md) и [CJM и трассировку приёмки](validation/stable-release-cjm-2026-11-13.ru.md). ## Приёмка в Fusion @@ -45,6 +59,6 @@ API. Очистка при UI save и ручной **Refresh Dimensions** не индивидуальной/общей видимостью выполните проверки из [Видимость, сохранение определений и Drawing](visibility-and-drawing.ru.md). -Используйте тестовые модели. Проверьте установку и жизненный цикл команды, выбор и отмену, типы измерений, единицы и перемещение камеры, трансформированные и вложенные экземпляры и работу с несколькими документами. На macOS и Windows проверьте сохранение, Save As, отмену, неудачное сохранение, закрытие и повторное открытие, включая полный перезапуск Fusion. Для каждого пути сохранения остановите аддон и проверьте повторно открытые файлы визуально, а также по счётчикам групп. Безопасность сохранения и повторного открытия с CustomGraphics **не подтверждена**, и недоступный сохранённый размер уже воспроизведён; не сохраняйте ценные модели при работающем аддоне. См. [заметки о безопасности Fusion](fusion-safety.ru.md). +Используйте тестовые модели. Проверьте установку и жизненный цикл команды, выбор и отмену, типы измерений, единицы и перемещение камеры, трансформированные и вложенные экземпляры и работу с несколькими документами. На macOS и Windows проверьте сохранение, Save As, отмену, неудачное сохранение, закрытие и повторное открытие, включая полный перезапуск Fusion. Для каждого пути сохранения остановите аддон и проверьте повторно открытые файлы визуально, а также по счётчикам групп. Приёмка всех путей сохранения и повторного открытия с CustomGraphics **не завершена**; не сохраняйте ценные модели при работающем аддоне. См. [заметки о безопасности Fusion](fusion-safety.ru.md). Автоматизация релизов и неизменяемые теги описаны в [правилах выпуска](../.github/RELEASE_POLICY.ru.md). Mesora распространяется на условиях PolyForm Noncommercial 1.0.0; коммерческое использование за пределами разрешённых случаев требует отдельного соглашения. diff --git a/docs/fusion-safety.md b/docs/fusion-safety.md index 887a89d..cac55da 100644 --- a/docs/fusion-safety.md +++ b/docs/fusion-safety.md @@ -60,13 +60,35 @@ did not produce registered commands; the cause had not been established at that ## Stability candidate, 2026-11-13 Commands are now registered. The candidate stores definitions and visibility in -design attributes and implements deferred geometry updates. Native API testing -confirmed definition round trips and rebuilding on changed geometry through direct -handler invocation. Event delivery and full UI flows remain separate acceptance gates. +design attributes and implements deferred geometry updates and startup/open +restoration. Earlier direct-handler tests establish handler behavior, not event +delivery. -Saving visible graphics through API Save As, stopping Mesora, and reopening a -synthetic design reproduced visible orphan graphics with zero API groups. Editing -and saving the geometry without Mesora left an incorrect old annotation visible. -A control path that explicitly removed graphics before saving reopened cleanly; -this does not establish safety for all save paths. See the [native evidence](validation/stability-native-2026-11-13.ru.md). -Stable publication is withheld; Windows and full restart acceptance remain pending. +A historical Python loading/API Save As path reproduced an orphan annotation with +zero API groups. That result must not be attributed to the current managed GUI +save path. The latest managed macOS GUI run (`f090654`) confirmed actual Save and +Save As cleanup, cancellation preserving state, and no dimensions after stopping +Mesora and reopening the checked fixture. Editing and saving its circle without +Mesora also reopened without dimensions. Starting Mesora restored references, +hidden-row settings, offsets and the updated edge length. GUI eye settings and visibility metadata +Undo/Redo passed on the synthetic fixture. Graphics Undo failed: Undo revived a +group missing from State, then deferred rendering added a duplicate (two actual +groups, one tracked). Cleanup correction and native retesting are required. Copy isolation and API save paths under +the managed lifecycle remain to be accepted. + +Event evidence came from an independent development observer run as a managed +Fusion add-in: its custom callback and documentSaving/documentSaved callbacks were +observed. An observer imported directly through MCP did not receive callbacks; +that absence is not evidence of absent managed product events. The observer is +development tooling and is excluded from the shipped ZIP. + +The parametric update scenario was interrupted by an unresponsive Fusion session +after CUA accessibility inspection of Change Parameters. The sampled main thread +showed an AX/Qt accessibility and signal-handler stack, without Python/Mesora +frames; causality is unestablished. No force termination was used with an unsaved +user document open; manual recovery was requested. This is INCONCLUSIVE, not a +passed update or restart test. See [native evidence](validation/stability-native-2026-11-13.ru.md) +and [observer/recovery notes](validation/observer-and-ax-recovery-2026-11-13.ru.md). +Stable publication remains withheld pending Undo graphics cleanup/retesting, +parametric changes, current Drawing, +full Fusion restart, Windows and remaining save/recovery acceptance. diff --git a/docs/fusion-safety.ru.md b/docs/fusion-safety.ru.md index 3cbde1b..e65aff0 100644 --- a/docs/fusion-safety.ru.md +++ b/docs/fusion-safety.ru.md @@ -23,15 +23,37 @@ ## Кандидат стабильности, 2026-11-13 Команды теперь зарегистрированы. Кандидат сохраняет определения и видимость в -атрибутах модели и реализует отложенное обновление по геометрии. Нативная проверка -API подтвердила запись и загрузку определений, а также перестроение после изменения -геометрии через прямой вызов обработчика. Доставка событий и полные сценарии UI -остаются отдельными проверками приёмки. - -Сохранение видимой графики через API Save As, остановка Mesora и повторное открытие -синтетической модели воспроизвели видимую недоступную графику при нулевом числе групп -API. Изменение и сохранение геометрии без Mesora оставило видимым неверный старый -размер. Контрольный путь с явным удалением графики перед сохранением открылся без -артефакта; это не подтверждает безопасность всех путей сохранения. См. -[нативные доказательства](validation/stability-native-2026-11-13.ru.md). -Стабильная публикация отложена; приёмка Windows и полного перезапуска ещё не пройдена. +атрибутах модели, реализует отложенное обновление геометрии и восстановление при +запуске/открытии. Прежние прямые вызовы обработчиков подтверждают их работу, но +не доставку событий. + +Исторический путь загрузки Python/API Save As воспроизвёл постоянный размер при +нулевом числе групп API. Этот результат нельзя приписывать текущему штатному +пути GUI-сохранения. Последний штатный GUI-прогон macOS (`f090654`) подтвердил +реальную очистку в Save и Save As, сохранность состояния при отмене и отсутствие +размеров после остановки Mesora и повторного открытия проверенной фикстуры. +Изменение и сохранение её окружности без Mesora также дало повторное открытие без +размеров. Запуск Mesora восстановил ссылки, скрытие строки, смещения и актуальную +длину ребра. Глазики через GUI и Undo/Redo метаданных видимости прошли проверку +на синтетической фикстуре. Графическая приёмка Undo провалена: Undo вернул группу, +отсутствующую в State, а отложенная перерисовка добавила дубликат (две реальные +группы при одной отслеживаемой). Нужны исправление очистки и нативная перепроверка. Изоляция копии и пути API-сохранения со штатным жизненным циклом ещё +требуют приёмки. + +Доказательство событий получено независимым development observer, запущенным как +штатный аддон Fusion: подтверждены собственный custom callback и callback +documentSaving/documentSaved. Observer, импортированный напрямую через MCP, не +получал callback; это не доказывает отсутствие событий у штатного продукта. +Observer — инструмент разработки, не входящий в поставляемый ZIP. + +Параметрический сценарий прерван потерей отзывчивости Fusion после чтения CUA +дерева доступности Change Parameters. В sample основного потока видна цепочка +AX/Qt accessibility и обработчика сигнала без Python/Mesora-фреймов; причинность +не установлена. При открытом несохранённом пользовательском документе принудительное +завершение не выполнялось; запрошено ручное восстановление. Результат INCONCLUSIVE, +а не пройденная проверка обновления или перезапуска. См. +[нативные доказательства](validation/stability-native-2026-11-13.ru.md) и +[заметки observer/восстановления](validation/observer-and-ax-recovery-2026-11-13.ru.md). +Стабильная публикация отложена до исправления и перепроверки очистки графики Undo, +приёмки параметрических изменений, актуального +Drawing, полного перезапуска Fusion, Windows и остальных путей сохранения/восстановления. 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 index 590eafb..7b6c200 100644 --- a/docs/validation/stability-native-2026-11-13.ru.md +++ b/docs/validation/stability-native-2026-11-13.ru.md @@ -1,6 +1,6 @@ # Mesora: нативная проверка стабильности, 13.11.2026 -**Решение: stable не публиковать.** Кейс использования проекта без Mesora выявил устаревшую неуправляемую аннотацию после сохранения и reopen. Windows Fusion, полная проверка restart и штатная последовательность UI-событий финального кандидата не приняты. +**Решение: stable пока не публиковать.** В прогоне с управляемым запуском Fusion (`f090654`) штатный GUI Save и использование модели без Mesora приняты на macOS для синтетической фикстуры, но подробный trace выявил дублирование графики после Undo (D06). Для D06 реализовано исправление ownership с офлайн-регрессиями; нативный повтор ещё не выполнен. Первоначальный orphan получен другим способом перезагрузки Python и не является доказательством неисправности нынешнего штатного GUI-пути. Параметрическое изменение, полный restart, актуальный Drawing и Windows Fusion ещё не приняты. ## Среда и границы доказательства @@ -8,7 +8,7 @@ macOS, Autodesk Fusion `2706.1.17`. Проверял основной агент Вызовы Fusion API проходили через MCP script. Запуск команды через `CommandDefinition.execute()` не оставлял открытый Mesora-диалог; прямые UI-действия не дали подтверждённого изменения интерфейса. Поэтому данные ниже **не являются** приёмкой реального OK/Cancel или порядка UI save/commandTerminated events. Прямой вызов `notify` отмечен отдельно; он проверяет обработчик на настоящей CAD-геометрии, но не доставку события. -## S19: модель без Mesora — FAIL +## Исторический S19 через прежний способ запуска — FAIL Фикстура `Mesora stable acceptance 2026-11-13`: @@ -60,7 +60,70 @@ SHA-256 контрольного `prepared-save-without-mesora.png`: `098843b277 ## Необходимая повторная проверка -Сначала устранить попадание CustomGraphics в сохраняемое состояние либо подтвердить другой способ отображения. `isModified` не подделывать, вымышленные transient-флаги не вводить. После исправления повторить все пути Save/Save As/cancel/failure/recovery, close/reopen, restart и работу без аддина с визуальными снимками. Затем принять model edits, Undo/Redo, Drawing, несколько документов и установку финального ZIP отдельно на macOS и Windows. +Продолжить проверку через штатный 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. diff --git a/docs/validation/stable-release-cjm-2026-11-13.ru.md b/docs/validation/stable-release-cjm-2026-11-13.ru.md index 86b27ba..6576c2b 100644 --- a/docs/validation/stable-release-cjm-2026-11-13.ru.md +++ b/docs/validation/stable-release-cjm-2026-11-13.ru.md @@ -33,21 +33,21 @@ | S01 | Установка/старт/стоп дважды без дублей UI и handlers; Run on Startup | `test_package`, validator: PASS | macOS/Windows PENDING на финальном ZIP; UI, count handlers и версия | Повторить после финальной сборки | | S02 | Создать и применить все 7 видов: distance, edge_length, radius, diameter, angle, area, perimeter | arithmetic, geometry, renderer tests: PASS | На цилиндре, блоке, двух гранях и дуге сверить Fusion Inspect; macOS/Windows PENDING | Сверять units и нет chord вместо arc | | S03 | Некорректный/неполный/duplicate выбор не применяется; Cancel не меняет committed | `test_measurement_batch`, `test_table_command`: PASS | Сменить тип и геометрию нескольких строк, OK/Cancel: PENDING | Нельзя потерять другую строку | -| S04 | Глазик строки сразу скрывает/показывает без удаления, OK сохраняет настройку | `test_visibility_lifecycle`, `test_batch_apply`: PASS | Preview/Cancel: переданный macOS PASS; OK→повторное открытие PENDING; Windows PENDING | Скрытая строка остаётся в таблице | -| S05 | Общий глазик скрывает весь набор и возвращает только индивидуально видимые | Те же тесты: PASS | Переданный macOS preview PASS; commit/reopen/Windows PENDING | Проверить в том числе все строки individually hidden | +| 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 | Изменить радиус/высоту/длину: число, выносные и положение обновляются автоматически | На baseline нет lifecycle-регрессии пересчёта | Native параметрический edit→закончить команду→сверить без Refresh: PENDING | D02; повторить после интеграции событий | -| S07 | Undo/Redo изменения геометрии и Mesora возвращает согласованные определения и аннотации | На baseline нет full transaction-проверки | Undo/Redo после OK, remove, visibility, parameter edit: macOS/Windows PENDING | Нельзя считать state в памяти доказательством Undo | +| S07 | Undo/Redo изменения геометрии и Mesora возвращает согласованные определения и аннотации | На baseline нет full transaction-проверки | **macOS FAIL (f090654, trace counters26–49)**: metadata hidden восстановилась, но после Undo runtime tracked1 при design actual2 (38–39), то есть восстановленная графика не учтена и дополнительно отрисована новая. Redo затем удаляет actual groups; повторы Undo воспроизводят mismatch. Metadata-only PASS не является графическим PASS; Windows PENDING | Нельзя считать state в памяти доказательством Undo | | S08 | Удалённая/подавленная/неоднозначная ссылка явно недоступна; остальные строки редактируются | resolver rejects missing/ambiguous: PASS | Удалить measured feature, открыть Mesora, исправить/удалить плохую строку: PENDING | D03; prefill baseline прерывается на resolve | -| S09 | Save с видимой графикой завершается один раз; нет постоянной звёздочки | `test_drawing_save_stays_clean_without_recreating_graphics`: PASS | Переданный macOS Drawing PASS; самостоятельный Save финального кода PENDING | D01/D04; считать версии и modified flag, не менять isModified | -| S10 | Save→close→reopen сохраняет 7 типов, offsets, row/global visibility; значения пересчитаны | Только отдельный persistence stub baseline PASS, runtime не подключён | macOS/Windows PENDING; reopen с аддином и без него, visual orphan check | D01; полная матрица после подключения persistence | +| 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; значения пересчитаны | Только отдельный persistence stub baseline PASS, runtime не подключён | **macOS PARTIAL (root, f090654)**: open v2 автоматически восстановил 2 definitions, 1 group при скрытом m1; GUI Save v3→managed stop→reopen v3 без Mesora: body=1, groups=0, clean=True, визуально размеров нет. Все 7 типов/Windows PENDING | D01; полная матрица после подключения persistence | | S11 | Полный restart Fusion восстанавливает определения и не оставляет orphan graphics | Offline не доказывает | macOS/Windows PENDING; stop→save→exit→start→open; снимки до/после | Релизный gate, не заменяется count groups | -| S12 | Save As создаёт независимую копию набора; изменения копии не меняют исходник | Document isolation persistence stub PASS | Два файла с разными settings, закрыть/открыть оба: PENDING | D01; убедиться в сохранении refs после копии | -| S13 | Cancel/failed Save не теряет определения, не зависает, позволяет retry и продолжение | Нет native fault evidence | macOS/Windows PENDING: cancel Save As; воспроизводимый отказ записи только на фикстуре; retry | D04; documentSaved может не прийти, нельзя зависеть только от него | +| S12 | Save As создаёт независимую копию набора; изменения копии не меняют исходник | Document isolation persistence stub PASS | **macOS PARTIAL (root f090654)**: UI Save As создал отдельную копию v1, clean, groups=0, removed_for_save=True, 2 definitions. Observer подтверждён контрольными callbacks: PLM360SaveAs14→Saving22 groups0→Saved23 groups0→Terminated24 без recreate. Copy reopen без Mesora и независимость исходника PENDING; Windows PENDING | D01; убедиться в сохранении refs после копии | +| 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 PASS: v162→v163; финальный код/Windows PENDING | D04; проверить с persistence и auto-update заново | | S15 | Два документа и Drawing не смешивают definitions/visibility; закрытие не держит stale state | Persistence stub isolation PASS | Model A→B→Drawing→A, закрыть B, новый C: PENDING | Проверить events принадлежат нужному document | | S16 | Transformed/nested occurrences, orbit, zoom, units дают корректные числа/позиции | Geometry context/renderer layout tests PASS | macOS/Windows PENDING; ненулевой transform, вложенные компоненты, mm/in | Старый zero-transform smoke недостаточен | | S17 | Повреждённый/будущий schema не перезаписывается; ошибка понятна, остальные документы работают | `test_persistence`, schema tests PASS | Синтетические attributes fixtures: PENDING | D01; runtime должен fail closed и сохранять исходный payload | -| S19 | Использовать проект без установленной/запущенной Mesora: аннотаций Mesora НЕТ, геометрия доступна для edit/save, definitions сохранены; после подключения Mesora набор автоматически восстановлен и отрисован по актуальной геометрии | Offline persistence покрывает независимые определения, но не сериализацию CAD | **macOS FAIL (прогон root)**: без Mesora геометрия редактируется (радиус 2→2.5 cm), save/reopen успешны, API graphicsCount=0; визуально остаётся orphan с устаревшим 125.7 mm вместо актуального 157.1 mm. Доказательство: `dist/local-validation/orphan-after-model-edit.png` (root просмотрел). Windows PENDING; восстановление Mesora после этого требует отдельной проверки | Обязательный пользовательский gate; данные не должны зависеть от наличия аддина | +| 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 | ## Дефекты исходного состояния и повторная проверка @@ -59,6 +59,7 @@ | D03 | Major | `BatchCommand.prefill` разрешает каждую ссылку без обработки ошибки строки: одна плохая ссылка прерывает заполнение/открытие командного диалога | S08: остальные строки доступны, плохую можно удалить/исправить без потери данных | OPEN на baseline; сообщено владельцу runtime | | D04 | Major | После save `removed_for_save` блокирует graphics до явного действия; при interrupted save нет подтверждённого recovery | S09/S13/S14 без loop, данные доступны после любого исхода save; фактический UX описан | OPEN на baseline | | D05 | Documentation | Manifest и safety/readme говорят experimental/session-only; safety содержит устаревшие сообщения об отсутствии зарегистрированных команд | Документация соответствует фактически принятым сценариям, EN/RU parity; неподтверждённые платформы явно указаны | PENDING после приёмки | +| D06 | Major, release blocker | S07 Undo: штатный observer trace38–39 показывает tracked_groups=1, valid_tracked_groups=1, actual custom_graphics_group_count=2 после восстановления definition. При Undo34–37/46–49 actual1 уже присутствует при tracked0; deferred render добавляет ещё одну группу | Повторный UI Undo/Redo без лишних Mesora groups, все owned groups учтены; после stop/save/reopen без аддина аннотаций нет; чужая графика не удаляется | OPEN; lifecycle ownership fix в работе, нативный retest обязателен | ## Воспроизводимые baseline gates @@ -72,15 +73,15 @@ D01/D02/D03 имеют реализацию и офлайн-регрессии; закрытие для stable требует указанных нативных сценариев на финальном коде. Новый S19 обязателен по прямому уточнению пользователя: проект должен нормально использоваться без Mesora. -## Блокирующее нативное доказательство S19 +## Историческое наблюдение S19 в раннем harness -Владелец Fusion (root) 13.11.2026 подтвердил: использование геометрии без Mesora возможно, но старые аннотации остаются видимыми после редактирования и повторного открытия. При радиусе 2.5 cm окружность должна иметь длину около 157.1 mm; виден старый label 125.7 mm. При этом `customGraphicsGroups.count == 0`, так что удалить этот label обычным управлением группами невозможно. S19 **FAIL**, доверие к информационным размерам нарушено; stable release заблокирован до устранения и повторной визуальной приёмки. Это переданное свидетельство root, субагент не управлял Fusion. +Владелец 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 FAIL и end-to-end gates сохранения/перезапуска. Для закрытия нужны действия через штатный UI Fusion, без ручного вызова обработчиков, с теми же визуальными проверками. +Root отдельно проверил нативные операции с **явным программным вызовом** обработчика `DocumentEvent('saving')` перед API save: после reopen orphan отсутствовал, definitions восстановились. Прямой нативный вызов обработчика auto-update также обновил результат. Это подтверждает локальные операции обработчиков на реальной геометрии, но **не** доказывает, что обычный пользовательский Save/Save As/команда редактирования доставляет нужные события в нужном порядке. Эти прямые вызовы сами по себе не закрывают S19 и end-to-end gates сохранения/перезапуска. Для закрытия нужны действия через штатный UI Fusion, без ручного вызова обработчиков, с теми же визуальными проверками. ## Уточнённый контракт при отсутствии Mesora @@ -109,3 +110,34 @@ Root отдельно проверил нативные операции с **я Для каждого события нужны: 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: 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 открыт. Прежние утверждения о groups1 на Undo относились только к `len(state.groups)` и не доказывали отсутствие дубликатов. Ownership/reconciliation fix разрабатывается отдельно; до нового нативного прогона успешное закрытие не заявляется. Повторная приёмка должна сравнивать runtime tracked/valid и реальные Mesora-owned groups на каждом шаге, проверить видимость, stop и save/reopen. Нельзя удалять все CustomGraphics документа: чужая графика должна сохраняться. Этот дефект не отменяет отдельные S19 доказательства штатного save/reopen без Undo, но блокирует стабильный релиз до исправления и повторной проверки. diff --git a/docs/visibility-and-drawing.md b/docs/visibility-and-drawing.md index edafe9c..a762b36 100644 --- a/docs/visibility-and-drawing.md +++ b/docs/visibility-and-drawing.md @@ -2,12 +2,14 @@ [Русская версия](visibility-and-drawing.ru.md) -**Status: experimental validation candidate; stable release withheld.** Native -macOS acceptance reproduced an inaccessible persistent CustomGraphics annotation -after API Save As, stopping Mesora, closing and reopening the synthetic model. -The annotation was visible while `customGraphicsGroups.count` was zero. A zero -count is not proof that the model contains no saved graphics. Use disposable -documents only. See the [native evidence](validation/stability-native-2026-11-13.ru.md). +**Status: experimental validation candidate; stable release withheld.** Undo +reproduced duplicate graphics; cleanup correction and native retesting are required. Managed +macOS GUI testing passed save cleanup and the checked save/reopen/edit path without +Mesora: no dimensions were visible while the add-in was stopped. Starting Mesora +restored definitions, visibility, offsets and current values. Earlier orphan +observations came from a different Python loading/API path and do not establish a +failure of the current managed GUI save path. Use disposable documents while the +remaining gates are open. See [native evidence](validation/stability-native-2026-11-13.ru.md). Each measurement row has an eye button. Click it to hide or show that measurement without removing its geometry references, type or offset. A crossed-out eye means @@ -22,18 +24,22 @@ Measured values are recalculated from current geometry rather than stored. Unsupported or damaged stored definitions are not silently overwritten. Automatic updates are implemented through `commandTerminated` followed by a custom -event on Fusion's permitted execution thread. Native acceptance of geometry edits, -Undo/Redo and full recovery is still pending; implementation and offline tests are -not evidence that every native path works. +event on Fusion's permitted execution thread. GUI eye application passed on the +macOS fixture. Undo/Redo restored visibility metadata, but Undo revived an untracked +graphics group and deferred rendering added another: actual groups reached two +while State tracked one. Graphics Undo acceptance failed; cleanup needs correction +and native retesting. Parametric edits and full recovery also need acceptance; implementation and offline tests do not establish every native path. The candidate also implements definition loading on document open and Mesora startup. Display is requested through a deferred custom event; activation may resume an existing open/startup request, while workspace, active-document and active-command checks gate rendering. Saving clears the pending restore request. -This code is not native acceptance: actual callback delivery and automatic display -after managed add-in restart/reopen remain unconfirmed. See the latest rerun in -[native evidence](validation/stability-native-2026-11-13.ru.md); no full Fusion -restart acceptance has been completed. +Managed macOS startup/reopen restored two definitions, a hidden row, offsets and +the current edge length after geometry was edited without Mesora. An independently +managed observer confirmed custom-event delivery and real save callbacks. Direct +MCP import of an observer did not confirm callbacks and cannot establish their +absence in the managed add-in. See [native evidence](validation/stability-native-2026-11-13.ru.md); +no full Fusion restart acceptance has been completed. When the UI save event runs, Mesora removes tracked graphics before saving. It deliberately does not recreate them inside `documentSaved`: that makes the source @@ -44,9 +50,13 @@ Drawing can activate its source during creation; it may only resume an existing open/startup request. Workspace activation does not recreate graphics. The camera handler does not update model graphics in Drawing or during workspace transitions. -This is a temporary workaround, not complete normal save/reopen behavior. The API -Save As path reproduced a persistent annotation despite this event strategy. -Stopping the add-in does not guarantee removal of an already saved artifact. +Managed GUI Save and Save As confirmed cleanup; cancellation preserved dimensions. +The checked file reopened without dimensions while Mesora was stopped, remained +editable and savable, and restored current measurements when Mesora started. +Manual refresh after save remains a workaround. API Save/Save As with the managed +lifecycle, copy isolation and remaining recovery paths need separate acceptance. +The earlier orphan file is historical evidence from a different loading/API path; +a zero API group count alone is still insufficient to prove an annotation-free file. ## Acceptance checklist @@ -72,6 +82,7 @@ each step; this checklist itself does not mark any gate passed. 9. Return to the model and verify measurements and visibility. Test canceled/failed save and close paths without discarding or overwriting definitions. -The persistent-artifact defect, Windows native acceptance and full restart gates -remain blockers for a stable release. See [Fusion safety notes](fusion-safety.md) +Undo graphics cleanup/retesting, parametric changes, latest-candidate Drawing, +Windows, full Fusion restart and +remaining API save/recovery gates still prevent a stable release. See [Fusion safety notes](fusion-safety.md) and the [product acceptance matrix](validation/stable-release-cjm-2026-11-13.ru.md). diff --git a/docs/visibility-and-drawing.ru.md b/docs/visibility-and-drawing.ru.md index 8db386b..11cb2c7 100644 --- a/docs/visibility-and-drawing.ru.md +++ b/docs/visibility-and-drawing.ru.md @@ -3,11 +3,14 @@ [English](visibility-and-drawing.md) **Статус: экспериментальный кандидат для проверки; стабильный релиз отложен.** -Нативная приёмка на macOS воспроизвела недоступный постоянный размер CustomGraphics -после API Save As, остановки Mesora, закрытия и повторного открытия синтетической -модели. Размер был виден при `customGraphicsGroups.count`, равном нулю. Нулевой -счётчик не доказывает отсутствие сохранённой графики. Используйте только тестовые -документы. См. [нативные доказательства](validation/stability-native-2026-11-13.ru.md). +Undo воспроизвёл дублирование графики; нужны исправление очистки и нативная перепроверка. +Штатная GUI-проверка macOS подтвердила очистку и проверенный путь сохранения, +повторного открытия и редактирования без Mesora: при остановленном аддоне размеров +не было. Запуск Mesora восстановил определения, видимость, смещения и актуальные +значения. Прежний постоянный артефакт получен в другом пути загрузки Python/API и +не доказывает неисправность текущего штатного пути GUI-сохранения. Пока остаются +непройденные проверки, используйте тестовые документы. См. +[нативные доказательства](validation/stability-native-2026-11-13.ru.md). У каждой строки измерения есть глазик. Он скрывает или показывает размер, сохраняя ссылки на геометрию, тип и смещение. Перечёркнутый глазик означает, что @@ -22,19 +25,24 @@ сохраняются. Неподдерживаемые или повреждённые определения не перезаписываются молча. Автообновление реализовано через `commandTerminated` с последующим custom event -в разрешённом потоке Fusion. Нативная приёмка изменений геометрии, Undo/Redo и -полного восстановления ещё не завершена; реализация и автономные тесты не -подтверждают работу всех нативных сценариев. +в разрешённом потоке Fusion. Применение глазиков через GUI прошло проверку на +macOS-фикстуре. Undo/Redo восстанавливали метаданные видимости, но Undo вернул +неотслеживаемую группу графики, а отложенная перерисовка добавила вторую: реально +две группы при одной в State. Графическая приёмка Undo не пройдена; нужны +исправление очистки и повторная нативная проверка. Параметрические изменения и +полное восстановление также требуют приёмки; реализация и автономные тесты не подтверждают все нативные пути. Кандидат также реализует загрузку определений при открытии документа и запуске Mesora. Показ запрашивается через отложенный custom event; активация может продолжить уже существующий запрос от открытия/запуска, а проверки рабочей среды, активного документа и команды ограничивают создание графики. Сохранение снимает -ожидающий запрос восстановления. Этот код не является нативной приёмкой: -фактическая доставка callback и автоматический показ после штатного перезапуска -аддона/повторного открытия не подтверждены. См. последний повторный прогон в -[нативных доказательствах](validation/stability-native-2026-11-13.ru.md); приёмка -полного перезапуска Fusion не выполнена. +ожидающий запрос восстановления. Штатный запуск/повторное открытие на macOS +восстановили два определения, скрытую строку, смещения и актуальную длину ребра +после изменения геометрии без Mesora. Независимый штатно запущенный observer +подтвердил доставку custom event и реальные callback сохранения. Прямой импорт +observer через MCP не подтвердил callback и не доказывает их отсутствие у штатного +аддона. См. [нативные доказательства](validation/stability-native-2026-11-13.ru.md); +приёмка полного перезапуска Fusion не выполнена. Когда срабатывает событие сохранения через UI, Mesora удаляет отслеживаемую графику перед сохранением. Она намеренно не пересоздаётся в `documentSaved`: это @@ -46,10 +54,14 @@ Drawing. После сохранения откройте Mesora или нажм среды не пересоздаёт графику. Обработчик камеры не меняет графику модели в Drawing и во время переключения рабочих сред. -Это временный обходной путь, а не завершённый сценарий нормального сохранения и -повторного открытия. В пути API Save As постоянный размер воспроизведён несмотря -на эту обработку событий. Остановка аддона не гарантирует удаление уже -сохранённого артефакта. +Штатные GUI Save и Save As подтвердили очистку; отмена сохранила размеры. +Проверенный файл открывался без размеров при остановленной Mesora, оставался +доступен для изменения и сохранения и восстанавливал актуальные измерения после +запуска Mesora. Ручное обновление после сохранения остаётся обходным путём. +API Save/Save As со штатным жизненным циклом, изоляция копии и остальные пути +восстановления требуют отдельной приёмки. Прежний файл с постоянным артефактом — +историческое доказательство из другого пути загрузки/API; одного нулевого счётчика +групп API по-прежнему недостаточно для подтверждения отсутствия размеров в файле. ## Проверка @@ -76,6 +88,8 @@ Drawing. После сохранения откройте Mesora или нажм 9. Вернитесь в модель и проверьте измерения и видимость. Проверьте отмену и ошибку сохранения/закрытия без потери или перезаписи определений. -Постоянный артефакт, нативная приёмка Windows и полный перезапуск остаются -блокерами стабильного релиза. См. [ограничения Fusion](fusion-safety.md) и +Очистка графики Undo с перепроверкой, параметрические изменения, Drawing на +актуальном кандидате, Windows, полный +перезапуск Fusion и оставшиеся пути API-сохранения/восстановления пока препятствуют +стабильному релизу. См. [ограничения Fusion](fusion-safety.md) и [продуктовую матрицу приёмки](validation/stable-release-cjm-2026-11-13.ru.md). diff --git a/scripts/native_acceptance_observer.py b/scripts/native_acceptance_observer.py index 5dd85ce..d3a18d5 100644 --- a/scripts/native_acceptance_observer.py +++ b/scripts/native_acceptance_observer.py @@ -1,7 +1,11 @@ """Read-only Fusion event observer for synthetic Mesora acceptance documents. -Import inside Fusion, then call start('/absolute/path/trace.jsonl'), probe(), -snapshot('label') and stop(). Keep this module imported until stop completes. +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. 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 06ebed7..891169a 100644 --- a/tests/test_batch_apply.py +++ b/tests/test_batch_apply.py @@ -52,7 +52,7 @@ def test_explicitly_showing_hidden_state_restores_all_measurements(self): 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, visible=True) diff --git a/tests/test_owned_lifecycle.py b/tests/test_owned_lifecycle.py new file mode 100644 index 0000000..bf688b0 --- /dev/null +++ b/tests/test_owned_lifecycle.py @@ -0,0 +1,111 @@ +"""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.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) diff --git a/tests/test_renderer_model_plane.py b/tests/test_renderer_model_plane.py index b2c4d56..e561a41 100644 --- a/tests/test_renderer_model_plane.py +++ b/tests/test_renderer_model_plane.py @@ -51,6 +51,44 @@ def getEndPoints(self): return True, Point(0, 0, 0), Point(10, 0, 0) class RendererPlaneTest(unittest.TestCase): + 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))) @@ -83,6 +121,7 @@ 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) diff --git a/tests/test_visibility_lifecycle.py b/tests/test_visibility_lifecycle.py index 4d89a5b..1c3512c 100644 --- a/tests/test_visibility_lifecycle.py +++ b/tests/test_visibility_lifecycle.py @@ -22,6 +22,10 @@ def setUp(self): self.m = importlib.import_module('Mesora.Mesora') self.storage_patch = patch.object(self.m, 'save_state', return_value=True) self.storage_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() self.doc = types.SimpleNamespace(isModified=False) self.m.APP = types.SimpleNamespace(activeDocument=self.doc, activeViewport=types.SimpleNamespace(camera=object(), refresh=Mock()), log=Mock()) @@ -35,6 +39,7 @@ def setUp(self): def tearDown(self): self.storage_patch.stop() + self.ownership_patch.stop() self.load_patch.stop() self.modules.stop() sys.modules.pop('Mesora.Mesora', None); sys.modules.pop('Mesora.renderer', None) From fe68881fc4cf9c4d3b45abc91570fe037f018dd2 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Fri, 13 Nov 2026 19:27:31 +0300 Subject: [PATCH 4/8] fix: detect restored graphics after unchanged measurement commands --- Mesora/Mesora.py | 9 ++++- scripts/native_acceptance_observer.py | 3 ++ tests/test_owned_lifecycle.py | 54 +++++++++++++++++++++++++++ tests/test_visibility_lifecycle.py | 12 ++++++ 4 files changed, 76 insertions(+), 2 deletions(-) diff --git a/Mesora/Mesora.py b/Mesora/Mesora.py index 42d9347..e283a3b 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -757,12 +757,17 @@ def notify(self, args): # Undo/Redo restores document attributes in Fusion's transaction. # Runtime state must follow them, including undoing the last row. state.load() - if not state.items and not definitions_changed and not state.restore_requested: + 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 (state.fingerprint is not None and fingerprint != state.fingerprint): + 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() diff --git a/scripts/native_acceptance_observer.py b/scripts/native_acceptance_observer.py index d3a18d5..8b80b50 100644 --- a/scripts/native_acceptance_observer.py +++ b/scripts/native_acceptance_observer.py @@ -98,6 +98,9 @@ def _design_info(doc): 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 diff --git a/tests/test_owned_lifecycle.py b/tests/test_owned_lifecycle.py index bf688b0..d321efb 100644 --- a/tests/test_owned_lifecycle.py +++ b/tests/test_owned_lifecycle.py @@ -30,6 +30,7 @@ class OwnedLifecycleTest(unittest.TestCase): 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() @@ -109,3 +110,56 @@ def test_save_cleanup_failure_retains_revived_group_cancels_then_retry_succeeds( 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_visibility_lifecycle.py b/tests/test_visibility_lifecycle.py index 1c3512c..749c156 100644 --- a/tests/test_visibility_lifecycle.py +++ b/tests/test_visibility_lifecycle.py @@ -26,6 +26,17 @@ def setUp(self): # 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()) @@ -40,6 +51,7 @@ def setUp(self): def tearDown(self): self.storage_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) From 6a0663e9c7c18c8e03b7245df284204331f35196 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Fri, 13 Nov 2026 20:10:06 +0300 Subject: [PATCH 5/8] fix: release command handlers when Fusion commands close --- Mesora/Mesora.py | 51 ++++++++++++++----- Mesora/dimensions/event_scope.py | 29 +++++++++++ tests/test_command_handler_lifetime.py | 69 ++++++++++++++++++++++++++ tests/test_event_scope.py | 55 ++++++++++++++++++++ 4 files changed, 191 insertions(+), 13 deletions(-) create mode 100644 Mesora/dimensions/event_scope.py create mode 100644 tests/test_command_handler_lifetime.py create mode 100644 tests/test_event_scope.py diff --git a/Mesora/Mesora.py b/Mesora/Mesora.py index e283a3b..1a33d14 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -6,12 +6,14 @@ 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 = [] @@ -426,13 +428,18 @@ 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(620, 400) cmd.setDialogMinimumSize(550, 300) inputs = cmd.commandInputs context = BatchCommand() + destroyed.context = context context.command = cmd context.inputs = inputs context.active_selection = None @@ -468,11 +475,10 @@ 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() @@ -481,10 +487,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.') @@ -590,16 +597,31 @@ def notify(self, args): 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 and graphics_workspace() + 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() except Exception: log_error() finally: - self.context.state.editor_open = False + 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): @@ -833,6 +855,9 @@ 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() 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/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_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, []) From 8129f2fae895b285ae122e63f96b5cb67ea27086 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Fri, 13 Nov 2026 20:33:01 +0300 Subject: [PATCH 6/8] fix: separate dimension captions and stabilize camera rotation --- Mesora/Mesora.py | 21 +++- Mesora/dimensions/label_layout.py | 56 ++++++++++ Mesora/renderer.py | 119 +++++++++++++++++++-- tests/test_batch_apply.py | 4 +- tests/test_caption_integration.py | 160 +++++++++++++++++++++++++++++ tests/test_label_layout.py | 33 ++++++ tests/test_renderer_model_plane.py | 81 +++++++++++++++ tests/test_visibility_lifecycle.py | 5 + 8 files changed, 468 insertions(+), 11 deletions(-) create mode 100644 Mesora/dimensions/label_layout.py create mode 100644 tests/test_caption_integration.py create mode 100644 tests/test_label_layout.py diff --git a/Mesora/Mesora.py b/Mesora/Mesora.py index 1a33d14..8e48795 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -138,6 +138,10 @@ def refresh(self): 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) @@ -591,6 +595,10 @@ def notify(self, args): 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() @@ -613,6 +621,9 @@ def finish(self): 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: @@ -643,6 +654,10 @@ def notify(self, args): 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}, @@ -732,8 +747,12 @@ 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)] + for group in groups: renderer.orient_text(group, camera) + renderer.arrange_labels(groups, camera, args.viewport) except Exception: log_error() finally: 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/renderer.py b/Mesora/renderer.py index 414465e..b1f6f32 100644 --- a/Mesora/renderer.py +++ b/Mesora/renderer.py @@ -5,9 +5,11 @@ 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:' @@ -18,6 +20,111 @@ 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=()): @@ -75,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))) diff --git a/tests/test_batch_apply.py b/tests/test_batch_apply.py index 891169a..31a9713 100644 --- a/tests/test_batch_apply.py +++ b/tests/test_batch_apply.py @@ -19,7 +19,7 @@ def test_camera_change_updates_preview_when_committed_dimensions_hidden(self): 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) @@ -58,7 +58,7 @@ def test_explicitly_showing_hidden_state_restores_all_measurements(self): 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, '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']): + 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..8b572db --- /dev/null +++ b/tests/test_caption_integration.py @@ -0,0 +1,160 @@ +"""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_packs_visible_preview_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 + 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, []) + + +if __name__ == '__main__': + unittest.main() 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_renderer_model_plane.py b/tests/test_renderer_model_plane.py index e561a41..8de50b1 100644 --- a/tests/test_renderer_model_plane.py +++ b/tests/test_renderer_model_plane.py @@ -51,6 +51,87 @@ def getEndPoints(self): return True, Point(0, 0, 0), Point(10, 0, 0) class RendererPlaneTest(unittest.TestCase): + 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)) diff --git a/tests/test_visibility_lifecycle.py b/tests/test_visibility_lifecycle.py index 749c156..54a3e38 100644 --- a/tests/test_visibility_lifecycle.py +++ b/tests/test_visibility_lifecycle.py @@ -22,6 +22,10 @@ def setUp(self): 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=[]) @@ -50,6 +54,7 @@ def fake_owned_groups(design, keep=()): def tearDown(self): self.storage_patch.stop() + self.arrangement_patch.stop() self.ownership_patch.stop() self.owned_collection_patch.stop() self.load_patch.stop() From a77502e0809514f34b5ac6b16803b6053551e269 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Fri, 13 Nov 2026 20:40:23 +0300 Subject: [PATCH 7/8] fix: keep dimension positions fixed while orbiting --- Mesora/Mesora.py | 4 +++- tests/test_caption_integration.py | 29 ++++++++++++++++++++++++++++- tests/test_renderer_model_plane.py | 22 ++++++++++++++++++++++ 3 files changed, 53 insertions(+), 2 deletions(-) diff --git a/Mesora/Mesora.py b/Mesora/Mesora.py index 8e48795..6087bc8 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -750,9 +750,11 @@ def notify(self, args): 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) - renderer.arrange_labels(groups, camera, args.viewport) except Exception: log_error() finally: diff --git a/tests/test_caption_integration.py b/tests/test_caption_integration.py index 8b572db..0a7ca0e 100644 --- a/tests/test_caption_integration.py +++ b/tests/test_caption_integration.py @@ -133,12 +133,13 @@ def test_execute_placement_failure_preserves_committed_graphics_and_definitions( self.assertTrue(all(g.deleted for g in self.created)) self.m.UI.messageBox.assert_called_once() - def test_orbit_packs_visible_preview_and_cancel_reflows_restored_committed_set(self): + 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: @@ -155,6 +156,32 @@ def clear(): 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_renderer_model_plane.py b/tests/test_renderer_model_plane.py index 8de50b1..740cb32 100644 --- a/tests/test_renderer_model_plane.py +++ b/tests/test_renderer_model_plane.py @@ -51,6 +51,28 @@ 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)) From 011e9bc550abdfad4a859132b3581756e0f75415 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Fri, 13 Nov 2026 21:17:44 +0300 Subject: [PATCH 8/8] chore: prepare accepted macOS release --- .fusion-addin.json | 2 +- Mesora/Mesora.manifest | 2 +- Mesora/Mesora.py | 2 +- README.md | 41 ++-- README.ru.md | 41 ++-- README_RU.md | 41 ++-- docs/DEVELOPMENT.md | 105 +++++---- docs/DEVELOPMENT.ru.md | 102 ++++---- docs/fusion-safety.md | 166 ++++++------- docs/fusion-safety.ru.md | 108 +++++---- docs/releases/1.1.0.md | 19 ++ docs/releases/1.1.0.ru.md | 19 ++ .../stability-native-2026-11-13.ru.md | 80 ++++++- .../stable-release-cjm-2026-11-13.ru.md | 221 ++++++++++++++++-- docs/visibility-and-drawing.md | 110 +++------ docs/visibility-and-drawing.ru.md | 119 +++------- 16 files changed, 711 insertions(+), 467 deletions(-) create mode 100644 docs/releases/1.1.0.md create mode 100644 docs/releases/1.1.0.ru.md diff --git a/.fusion-addin.json b/.fusion-addin.json index d3441ac..da17141 100644 --- a/.fusion-addin.json +++ b/.fusion-addin.json @@ -1,6 +1,6 @@ { "name": "Mesora", "display_name": "Mesora", - "description": "Experimental informational 3D measurements with saved definitions; native save safety under validation.", + "description": "Informational 3D measurements with saved definitions and per-document visibility.", "initialized": true } diff --git a/Mesora/Mesora.manifest b/Mesora/Mesora.manifest index f533055..aff4cf2 100644 --- a/Mesora/Mesora.manifest +++ b/Mesora/Mesora.manifest @@ -3,7 +3,7 @@ "type": "addin", "author": "4FusionLab", "description": { - "": "Experimental informational 3D measurements with saved definitions; native save safety under validation." + "": "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 6087bc8..e4d888d 100644 --- a/Mesora/Mesora.py +++ b/Mesora/Mesora.py @@ -1,4 +1,4 @@ -"""Mesora: persistent informational measurements; native validation candidate.""" +"""Mesora: persistent informational 3D measurements.""" import traceback from pathlib import Path import adsk.core diff --git a/README.md b/README.md index 4947117..9c2b311 100644 --- a/README.md +++ b/README.md @@ -1,46 +1,47 @@

Mesora for Autodesk Fusion

-

Informational dimensions, in the model.
Measure supported geometry and manage a table of informational 3D dimensions.

+

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

+

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

-> **Experimental validation candidate: use disposable documents only.** A stable release is withheld: managed Undo reproduced duplicate graphics; cleanup needs correction and native retesting. Managed macOS GUI testing passed save cleanup, reopening and editing without Mesora, and restoration after starting Mesora. Earlier orphan graphics came from a different Python loading/API test path and do not establish a failure of the current managed GUI save path. API save paths, full Fusion restart, current Drawing, parametric updates and Windows remain to be accepted. See [safety research](docs/fusion-safety.md), [current validation status](docs/visibility-and-drawing.md) and [native evidence](docs/validation/stability-native-2026-11-13.ru.md). +## Measure in context -The download above is the previously published experimental 1.0.0. The persistence, visibility and update changes described below are in the current source candidate and have not been published as a stable release. +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. -## Measure in context +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. -Open **Design → Solid → Inspect → Mesora — Add Dimension**, select geometry, and build a table of measurements. Rows have 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. Each row has an eye button; the eye beside **+**, **−** and the trash button controls the whole set while preserving individual settings. **OK** commits definitions and visibility to the design; **Cancel** discards the draft. The Mesora menu also provides visibility, refresh, and removal commands. +## Save and return -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. +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. -## Install the published experimental build +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). -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. +## 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**. Enable **Run on Startup** in your isolated test setup; 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). -- In the current source candidate, **OK** stores geometry references, measurement types, placement offsets and individual/global visibility in `Design.attributes`. Values are remeasured from geometry. Unsupported or damaged saved data is not silently overwritten. This implementation does not establish safe model saving. -- An update is queued after a Fusion model command ends, using a custom event on Fusion's permitted thread. Definitions load when a document opens or Mesora starts; deferred display is gated by document, workspace and command state. Managed macOS startup restored visibility, offsets and values after geometry was edited and saved without Mesora. Full parametric update acceptance remains incomplete. -- The UI save handler removes tracked graphics and intentionally does not recreate them in `documentSaved` or on workspace activation. After a save, open Mesora or use **Refresh Dimensions** to restore graphics. Managed GUI Save and Save As confirmed cleanup; Save As cancellation preserved the current dimensions. Copy isolation and all save/recovery paths remain to be accepted. -- macOS GUI tests passed individual/global visibility, applying eye settings, and the checked save/reopen path without the add-in: no dimensions were visible with Mesora stopped. Undo/Redo restored visibility metadata, but Undo revived an untracked graphics group and the deferred redraw added a duplicate: graphics Undo acceptance failed. Cleanup and native retesting are required. An earlier orphan from a different loading/API test path requires a separate rerun. Prior Drawing evidence does not accept Drawing on the latest persistence/update candidate. Transformed/nested occurrences and broader picking/appearance scenarios also need validation. Offline tests do not establish native Fusion acceptance. -- The manifest declares Windows and macOS. Undo graphics cleanup and native retesting, Windows native acceptance, full Fusion restart, current Drawing, parametric changes and remaining save/recovery gates are outstanding. The candidate remains experimental until these gates pass. +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 eafa5cb..cf6b4f9 100644 --- a/README.ru.md +++ b/README.ru.md @@ -1,46 +1,47 @@

Mesora для Autodesk Fusion

-

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

+

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

-

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

+

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

-> **Экспериментальный кандидат для проверки: только тестовые документы.** Стабильный релиз отложен: штатный Undo воспроизвёл дублирование графики; нужны исправление очистки и повторная нативная проверка. Штатная GUI-проверка macOS подтвердила очистку при сохранении, повторное открытие и редактирование без Mesora, а также восстановление после запуска Mesora. Ранее постоянная графика получена в другом пути загрузки Python/API и не доказывает неисправность текущего штатного пути GUI-сохранения. Сохранение через API, полный перезапуск Fusion, актуальный Drawing, параметрические изменения и Windows ещё требуют приёмки. См. [исследование](docs/fusion-safety.ru.md), [текущий статус проверки](docs/visibility-and-drawing.ru.md) и [нативные доказательства](docs/validation/stability-native-2026-11-13.ru.md). +## Измерения в контексте модели -Ссылка выше ведёт на ранее опубликованную экспериментальную версию 1.0.0. Описанные ниже изменения сохранения определений, видимости и обновления находятся в текущих исходниках кандидата; стабильный релиз с ними не опубликован. +Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выберите геометрию и соберите таблицу измерений. Можно заменить геометрию строки, выбрать совместимый тип, настроить смещение или удалить строку. **OK** сохраняет определения и видимость в модели; **Cancel** отменяет черновик. -## Измерения в контексте модели +В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла нужны два совместимых объекта, для остальных типов — один поддерживаемый объект. Значения пересчитываются по актуальной геометрии после команд изменения модели. + +У каждой строки есть глазик. Глазик рядом с **+**, **−** и корзиной скрывает или показывает весь набор, сохраняя индивидуальные настройки. Mesora разносит подписи при добавлении или изменении размеров. При вращении и масштабировании их положение и выносные линии остаются на месте в модели; меняется только ориентация текста для чтения. **Refresh Dimensions** размещает подписи для нового ракурса. -Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выбирайте геометрию и собирайте таблицу измерений. У строк есть идентификаторы, например `m1`: можно изменить геометрию, выбрать совместимый тип измерения, настроить отступ и удалить строку. Подтвердите команду, чтобы показать размеры. У каждой строки есть глазик; глазик рядом с **+**, **−** и корзиной управляет всем набором, сохраняя индивидуальные настройки. **OK** записывает определения и видимость в модель; **Cancel** отменяет черновик. В меню Mesora также доступны показ и скрытие, обновление и удаление размеров. +## Сохранение и возврат к модели -В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла выбираются два совместимых объекта, для остальных типов — один поддерживаемый объект. Доступные варианты зависят от выбора; неподдерживаемые сочетания отклоняются. +Определения, ссылки на геометрию, смещения и видимость хранятся вместе с моделью. Сохранение убирает отображаемую графику, чтобы она не попала в сохранённую модель. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы снова показать размеры. Открытие документа или запуск Mesora восстанавливают сохранённый набор. -## Установка опубликованной экспериментальной версии +Без работающей Mesora модель остаётся доступной для редактирования, а размеры не показываются. Измерения информационные и не создают управляющих ограничений. См. [видимость, сохранение и Drawing](docs/visibility-and-drawing.ru.md). -1. Скачайте `Mesora-1.0.0.zip` со страницы [экспериментального релиза](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) и распакуйте архив в постоянную папку. +## Установка + +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). -- В текущих исходниках кандидата **OK** записывает ссылки на геометрию, типы измерений, смещения и индивидуальную/общую видимость в `Design.attributes`. Значения заново вычисляются по геометрии. Неподдерживаемые или повреждённые данные не перезаписываются молча. Наличие этой реализации не подтверждает безопасность сохранения модели. -- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Определения загружаются при открытии документа или запуске Mesora; отложенный показ ограничивается состоянием документа, рабочей среды и команды. Штатный запуск на macOS восстановил видимость, смещения и актуальные значения после изменения и сохранения геометрии без Mesora. Полная приёмка параметрического обновления не завершена. -- Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Штатные GUI Save и Save As подтвердили очистку; отмена Save As сохранила текущие размеры. Изоляция копии и все пути сохранения/восстановления ещё требуют приёмки. -- GUI-проверки macOS подтвердили индивидуальную/общую видимость, применение глазиков и проверенный путь сохранения/повторного открытия без аддона: при остановленной Mesora размеров не было. Undo/Redo восстанавливали метаданные видимости, но Undo вернул неотслеживаемую группу графики, а отложенная перерисовка добавила дубликат: графическая приёмка Undo не пройдена. Нужны исправление очистки и повторная нативная проверка. Прежний постоянный артефакт из другого пути загрузки/API требует отдельного повторного прогона. Предыдущая проверка Drawing не подтверждает Drawing на актуальном кандидате с сохранением определений и обновлениями. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения также требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. -- В манифесте заявлены Windows и macOS. Очистка графики Undo с повторной нативной проверкой, приёмка Windows, полный перезапуск Fusion, актуальный Drawing, параметрические изменения и оставшиеся пути сохранения/восстановления ещё не пройдены. До их прохождения кандидат остаётся экспериментальным. +Манифест поддерживает 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 eafa5cb..cf6b4f9 100644 --- a/README_RU.md +++ b/README_RU.md @@ -1,46 +1,47 @@

Mesora для Autodesk Fusion

-

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

+

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

-

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

+

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

-> **Экспериментальный кандидат для проверки: только тестовые документы.** Стабильный релиз отложен: штатный Undo воспроизвёл дублирование графики; нужны исправление очистки и повторная нативная проверка. Штатная GUI-проверка macOS подтвердила очистку при сохранении, повторное открытие и редактирование без Mesora, а также восстановление после запуска Mesora. Ранее постоянная графика получена в другом пути загрузки Python/API и не доказывает неисправность текущего штатного пути GUI-сохранения. Сохранение через API, полный перезапуск Fusion, актуальный Drawing, параметрические изменения и Windows ещё требуют приёмки. См. [исследование](docs/fusion-safety.ru.md), [текущий статус проверки](docs/visibility-and-drawing.ru.md) и [нативные доказательства](docs/validation/stability-native-2026-11-13.ru.md). +## Измерения в контексте модели -Ссылка выше ведёт на ранее опубликованную экспериментальную версию 1.0.0. Описанные ниже изменения сохранения определений, видимости и обновления находятся в текущих исходниках кандидата; стабильный релиз с ними не опубликован. +Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выберите геометрию и соберите таблицу измерений. Можно заменить геометрию строки, выбрать совместимый тип, настроить смещение или удалить строку. **OK** сохраняет определения и видимость в модели; **Cancel** отменяет черновик. -## Измерения в контексте модели +В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла нужны два совместимых объекта, для остальных типов — один поддерживаемый объект. Значения пересчитываются по актуальной геометрии после команд изменения модели. + +У каждой строки есть глазик. Глазик рядом с **+**, **−** и корзиной скрывает или показывает весь набор, сохраняя индивидуальные настройки. Mesora разносит подписи при добавлении или изменении размеров. При вращении и масштабировании их положение и выносные линии остаются на месте в модели; меняется только ориентация текста для чтения. **Refresh Dimensions** размещает подписи для нового ракурса. -Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выбирайте геометрию и собирайте таблицу измерений. У строк есть идентификаторы, например `m1`: можно изменить геометрию, выбрать совместимый тип измерения, настроить отступ и удалить строку. Подтвердите команду, чтобы показать размеры. У каждой строки есть глазик; глазик рядом с **+**, **−** и корзиной управляет всем набором, сохраняя индивидуальные настройки. **OK** записывает определения и видимость в модель; **Cancel** отменяет черновик. В меню Mesora также доступны показ и скрытие, обновление и удаление размеров. +## Сохранение и возврат к модели -В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла выбираются два совместимых объекта, для остальных типов — один поддерживаемый объект. Доступные варианты зависят от выбора; неподдерживаемые сочетания отклоняются. +Определения, ссылки на геометрию, смещения и видимость хранятся вместе с моделью. Сохранение убирает отображаемую графику, чтобы она не попала в сохранённую модель. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы снова показать размеры. Открытие документа или запуск Mesora восстанавливают сохранённый набор. -## Установка опубликованной экспериментальной версии +Без работающей Mesora модель остаётся доступной для редактирования, а размеры не показываются. Измерения информационные и не создают управляющих ограничений. См. [видимость, сохранение и Drawing](docs/visibility-and-drawing.ru.md). -1. Скачайте `Mesora-1.0.0.zip` со страницы [экспериментального релиза](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) и распакуйте архив в постоянную папку. +## Установка + +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). -- В текущих исходниках кандидата **OK** записывает ссылки на геометрию, типы измерений, смещения и индивидуальную/общую видимость в `Design.attributes`. Значения заново вычисляются по геометрии. Неподдерживаемые или повреждённые данные не перезаписываются молча. Наличие этой реализации не подтверждает безопасность сохранения модели. -- После завершения команды Fusion обновление ставится в очередь через custom event в разрешённом потоке Fusion. Определения загружаются при открытии документа или запуске Mesora; отложенный показ ограничивается состоянием документа, рабочей среды и команды. Штатный запуск на macOS восстановил видимость, смещения и актуальные значения после изменения и сохранения геометрии без Mesora. Полная приёмка параметрического обновления не завершена. -- Обработчик сохранения через UI удаляет отслеживаемую графику и намеренно не пересоздаёт её в `documentSaved` или при активации рабочей среды. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, чтобы вернуть размеры. Штатные GUI Save и Save As подтвердили очистку; отмена Save As сохранила текущие размеры. Изоляция копии и все пути сохранения/восстановления ещё требуют приёмки. -- GUI-проверки macOS подтвердили индивидуальную/общую видимость, применение глазиков и проверенный путь сохранения/повторного открытия без аддона: при остановленной Mesora размеров не было. Undo/Redo восстанавливали метаданные видимости, но Undo вернул неотслеживаемую группу графики, а отложенная перерисовка добавила дубликат: графическая приёмка Undo не пройдена. Нужны исправление очистки и повторная нативная проверка. Прежний постоянный артефакт из другого пути загрузки/API требует отдельного повторного прогона. Предыдущая проверка Drawing не подтверждает Drawing на актуальном кандидате с сохранением определений и обновлениями. Трансформированные/вложенные экземпляры и более широкие сценарии выбора и отображения также требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. -- В манифесте заявлены Windows и macOS. Очистка графики Undo с повторной нативной проверкой, приёмка Windows, полный перезапуск Fusion, актуальный Drawing, параметрические изменения и оставшиеся пути сохранения/восстановления ещё не пройдены. До их прохождения кандидат остаётся экспериментальным. +Манифест поддерживает 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 a0837e9..30b14ab 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -2,60 +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 ``` -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. - -## Candidate status and persistence - -The current source is an experimental validation candidate, not an accepted stable -release. Explicit command commits store references and settings in design -attributes through `dimensions/runtime_persistence.py`; values are recalculated. -Schema v2 supports all current measurement types and reads schema v1. Unknown, -corrupted or future data must not be silently overwritten. Automatic model updates -use `commandTerminated` and a deferred custom event. Loading on document open and -startup requests a restore; activation resumes an existing request and saving -clears it. Managed macOS GUI testing confirmed startup/reopen restoration, -visibility application, Save/Save As cleanup and Save As cancellation. Undo/Redo -restored visibility metadata, but graphics Undo failed: a revived untracked group -plus deferred rendering produced two actual groups while State tracked one. -Cleanup correction and native retesting remain required. -The checked model reopened without dimensions while Mesora was stopped, remained -editable/savable, and restored current measurements when Mesora started. - -Earlier orphan findings came from a different Python loading/API path and do not -establish a failure of the current managed GUI save path. Separately rerun API -Save/Save As with managed startup. Manual **Refresh Dimensions** after save remains -a workaround, and full save/recovery acceptance is incomplete. - -For independent event evidence, run the development observer through Fusion's -managed add-in lifecycle, using `scripts/prepare_native_observer.py`. A direct -MCP import did not deliver observer callbacks and cannot establish their absence -in the managed product. Neither observer script is part of the shipped add-in. - -Parametric acceptance was interrupted during CUA accessibility inspection of -Change Parameters; the observed AX/Qt stack does not establish Mesora causality. -Manual recovery was requested without force terminating an unsaved user document. -This scenario remains inconclusive. Stable publication is withheld pending -Undo graphics cleanup/retesting, parametric changes, latest-candidate Drawing, full Fusion restart, Windows and -remaining save/recovery gates. See the -[native report](validation/stability-native-2026-11-13.ru.md), -[observer/recovery notes](validation/observer-and-ax-recovery-2026-11-13.ru.md) and -[CJM and acceptance traceability](validation/stable-release-cjm-2026-11-13.ru.md). +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/` 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 -For the Drawing save-loop regression and row/global visibility controls, follow the -checks in [Visibility and Drawing](visibility-and-drawing.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). -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. For each save path, stop the add-in and inspect reopened files visually as well as checking group counts. Acceptance of all CustomGraphics save/reopen paths is **not complete**; do not save valuable designs while the add-in is running. See [Fusion safety notes](fusion-safety.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 e761e60..6b62b83 100644 --- a/docs/DEVELOPMENT.ru.md +++ b/docs/DEVELOPMENT.ru.md @@ -2,63 +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 ``` -Сборщик создаёт детерминированный ZIP и SHA-256 в `dist/`. Версия манифеста записывается в архив без изменения файлов рабочего каталога. CI проверяет Linux, macOS и Windows, но не запускает Fusion. +Собирайте с числовой версией, рассчитанной GitVersion 6.8.2, например после +записи этого результата в `MESORA_PACKAGE_VERSION`: -## Статус кандидата и сохранение определений +```sh +python3 scripts/build.py --version "$MESORA_PACKAGE_VERSION" +``` -Текущие исходники — экспериментальный кандидат для проверки, а не принятый -стабильный релиз. Явное подтверждение команды сохраняет ссылки и настройки в -атрибутах модели через `dimensions/runtime_persistence.py`; значения -пересчитываются. Схема v2 поддерживает все текущие типы измерений и читает схему -v1. Неизвестные, повреждённые или будущие данные нельзя молча перезаписывать. -Автоматическое обновление модели использует `commandTerminated` и отложенный -custom event. Загрузка при открытии документа и запуске запрашивает восстановление; -активация продолжает существующий запрос, а сохранение снимает его. Штатная -GUI-проверка macOS подтвердила восстановление при запуске/повторном открытии, -применение видимости, очистку в Save/Save As и отмену Save As. Undo/Redo -восстанавливали метаданные видимости, но графическая приёмка Undo провалена: -возвращённая неотслеживаемая группа и отложенная перерисовка дали две реальные -группы при одной в State. Нужны исправление очистки и нативная перепроверка. -Проверенная модель открывалась без размеров при остановленной Mesora, оставалась -доступна для изменения/сохранения и восстанавливала актуальные измерения после -запуска Mesora. +Сборщик создаёт детерминированный 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. -Прежний постоянный артефакт получен в другом пути загрузки Python/API и не -доказывает неисправность текущего штатного пути GUI-сохранения. API Save/Save As -нужно отдельно повторить со штатным запуском. Ручной **Refresh Dimensions** после -сохранения остаётся обходным путём; полная приёмка сохранения/восстановления не завершена. +## Контракты runtime -Для независимого доказательства событий запускайте development observer через -штатный жизненный цикл аддона Fusion с помощью `scripts/prepare_native_observer.py`. -Прямой импорт через MCP не дал callback наблюдателя и не доказывает их отсутствие -у штатного продукта. Оба скрипта observer не входят в поставляемый аддон. +- Явное подтверждение сохраняет ссылки, типы, смещения и видимость через + `dimensions/runtime_persistence.py`. Схема v2 читает v1; неизвестные, повреждённые + и будущие данные нельзя молча перезаписывать. Значения пересчитываются по геометрии. +- Команды модели ставят обновление в очередь через `commandTerminated` и custom + event. Открытие/запуск загружают определения; активация продолжает существующий + запрос восстановления. Рендер разрешён только в подходящем контексте Fusion. +- Refresh/save/stop сверяют собственную графику по ID, включая новые wrappers, + восстановленные Undo. Сохраняйте группы других аддонов и staged-графику команды. +- Размещайте подписи при явном предпросмотре, подтверждении, обновлении модели и + восстановлении. События камеры лишь ориентируют текст: не переразмещают подписи + и не перестраивают угловые дуги. +- Сохранение удаляет графику и снимает запрос восстановления. Не создавайте её + заново в `documentSaved`; явные Mesora/Refresh возвращают показ после сохранения. +- Удерживайте активные обработчики и отключайте command scopes при уничтожении. + Cancel возвращает подтверждённый набор без применения черновых глазиков или смещений. -Параметрическая приёмка прервалась при чтении CUA дерева доступности Change -Parameters; наблюдаемый AX/Qt-стек не устанавливает причинность Mesora. Запрошено -ручное восстановление без принудительного завершения несохранённого пользовательского -документа. Сценарий остаётся неопределённым. Стабильная публикация отложена до -исправления и перепроверки очистки графики Undo, параметрических изменений, Drawing на актуальном кандидате, полного перезапуска -Fusion, Windows и остальных проверок сохранения/восстановления. См. -[нативный отчёт](validation/stability-native-2026-11-13.ru.md), -[заметки observer/восстановления](validation/observer-and-ax-recovery-2026-11-13.ru.md) и -[CJM и трассировку приёмки](validation/stable-release-cjm-2026-11-13.ru.md). +## Нативная приёмка -## Приёмка в Fusion +Финальный независимый 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. Воспроизведённый +случай наложений/скачков подписей прошёл приёмку пользователя. -Для регрессии повторного сохранения при создании Drawing и управления -индивидуальной/общей видимостью выполните проверки из -[Видимость, сохранение определений и Drawing](visibility-and-drawing.ru.md). +Соблюдайте границы: проверка транзакции изменения параметра не является приёмкой +ручного 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 cac55da..caddab7 100644 --- a/docs/fusion-safety.md +++ b/docs/fusion-safety.md @@ -1,94 +1,80 @@ -# Fusion API safety research +# Fusion lifecycle and acceptance coverage [Русская версия](fusion-safety.ru.md) -## CustomGraphics persistence - -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 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`. -The current [DocumentEventArgs reference](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_DocumentEventArgs.htm) -documents `isOperationCancelled` and `cancelReason` for saving. Fusion 2706.1.17 -exposes those properties and does not expose `isSaveCanceled`; the older Application -event description still mentions that obsolete name. Native fault-injection must -verify actual cancellation, beyond checking that the property exists. 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. - -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. - -## Measurements and references - -[Edge evaluator](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/fusion_BRepEdge_evaluator.htm) +## Accepted macOS scope + +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 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. + +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. + +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. + +## 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. - -## Historical validation before the stability candidate - -The observations below document an earlier investigation. For later command checks and remaining limitations, see the [README](../README.md) and the stability candidate section below. - -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. At that stage there had 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 had not been established at that stage. - -## Stability candidate, 2026-11-13 - -Commands are now registered. The candidate stores definitions and visibility in -design attributes and implements deferred geometry updates and startup/open -restoration. Earlier direct-handler tests establish handler behavior, not event -delivery. - -A historical Python loading/API Save As path reproduced an orphan annotation with -zero API groups. That result must not be attributed to the current managed GUI -save path. The latest managed macOS GUI run (`f090654`) confirmed actual Save and -Save As cleanup, cancellation preserving state, and no dimensions after stopping -Mesora and reopening the checked fixture. Editing and saving its circle without -Mesora also reopened without dimensions. Starting Mesora restored references, -hidden-row settings, offsets and the updated edge length. GUI eye settings and visibility metadata -Undo/Redo passed on the synthetic fixture. Graphics Undo failed: Undo revived a -group missing from State, then deferred rendering added a duplicate (two actual -groups, one tracked). Cleanup correction and native retesting are required. Copy isolation and API save paths under -the managed lifecycle remain to be accepted. - -Event evidence came from an independent development observer run as a managed -Fusion add-in: its custom callback and documentSaving/documentSaved callbacks were -observed. An observer imported directly through MCP did not receive callbacks; -that absence is not evidence of absent managed product events. The observer is -development tooling and is excluded from the shipped ZIP. - -The parametric update scenario was interrupted by an unresponsive Fusion session -after CUA accessibility inspection of Change Parameters. The sampled main thread -showed an AX/Qt accessibility and signal-handler stack, without Python/Mesora -frames; causality is unestablished. No force termination was used with an unsaved -user document open; manual recovery was requested. This is INCONCLUSIVE, not a -passed update or restart test. See [native evidence](validation/stability-native-2026-11-13.ru.md) -and [observer/recovery notes](validation/observer-and-ax-recovery-2026-11-13.ru.md). -Stable publication remains withheld pending Undo graphics cleanup/retesting, -parametric changes, current Drawing, -full Fusion restart, Windows and remaining save/recovery acceptance. +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 e65aff0..d69e099 100644 --- a/docs/fusion-safety.ru.md +++ b/docs/fusion-safety.ru.md @@ -1,59 +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](https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_DocumentEventArgs.htm) описывает `isOperationCancelled` и `cancelReason` для сохранения. Fusion 2706.1.17 предоставляет эти свойства, но не `isSaveCanceled`; старое описание события Application всё ещё упоминает это устаревшее имя. Нативная проверка с искусственной ошибкой должна подтвердить фактическую отмену: одного наличия свойства недостаточно. Документация не подтверждает, что удаление всей пользовательской графики в `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`. При отказе очистки нужно удержать +собственные группы для повторной попытки и отменить сохранение. Одного нулевого +счётчика графики недостаточно для доказательства отсутствия аннотаций в файле: +нативная приёмка включала визуальную проверку. -## Кандидат стабильности, 2026-11-13 +## Контракты геометрии и событий -Команды теперь зарегистрированы. Кандидат сохраняет определения и видимость в -атрибутах модели, реализует отложенное обновление геометрии и восстановление при -запуске/открытии. Прежние прямые вызовы обработчиков подтверждают их работу, но -не доставку событий. +Используйте [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) +для длины кривой, а не хорды. Восстанавливайте ссылки сущностей и экземпляров в +правильном контексте; не сравнивайте строки токенов как идентичность объектов. +Потерянные или неоднозначные ссылки не должны показывать старые значения, а +неподдерживаемые/повреждённые определения нельзя молча перезаписывать. -Исторический путь загрузки Python/API Save As воспроизвёл постоянный размер при -нулевом числе групп API. Этот результат нельзя приписывать текущему штатному -пути GUI-сохранения. Последний штатный GUI-прогон macOS (`f090654`) подтвердил -реальную очистку в Save и Save As, сохранность состояния при отмене и отсутствие -размеров после остановки Mesora и повторного открытия проверенной фикстуры. -Изменение и сохранение её окружности без Mesora также дало повторное открытие без -размеров. Запуск Mesora восстановил ссылки, скрытие строки, смещения и актуальную -длину ребра. Глазики через GUI и Undo/Redo метаданных видимости прошли проверку -на синтетической фикстуре. Графическая приёмка Undo провалена: Undo вернул группу, -отсутствующую в State, а отложенная перерисовка добавила дубликат (две реальные -группы при одной отслеживаемой). Нужны исправление очистки и нативная перепроверка. Изоляция копии и пути API-сохранения со штатным жизненным циклом ещё -требуют приёмки. +Отложенная работа выполняется через очередь custom event в разрешённом потоке +Fusion. Независимое доказательство событий дал observer, запущенный штатным +аддоном. Прямой импорт observer через MCP не дал callback и не доказывает их +отсутствие у штатного продукта. Development helpers исключены из ZIP. -Доказательство событий получено независимым development observer, запущенным как -штатный аддон Fusion: подтверждены собственный custom callback и callback -documentSaving/documentSaved. Observer, импортированный напрямую через MCP, не -получал callback; это не доказывает отсутствие событий у штатного продукта. -Observer — инструмент разработки, не входящий в поставляемый ZIP. +## Ограничения и будущие регрессии -Параметрический сценарий прерван потерей отзывчивости Fusion после чтения CUA -дерева доступности Change Parameters. В sample основного потока видна цепочка -AX/Qt accessibility и обработчика сигнала без Python/Mesora-фреймов; причинность -не установлена. При открытом несохранённом пользовательском документе принудительное -завершение не выполнялось; запрошено ручное восстановление. Результат INCONCLUSIVE, -а не пройденная проверка обновления или перезапуска. См. -[нативные доказательства](validation/stability-native-2026-11-13.ru.md) и -[заметки observer/восстановления](validation/observer-and-ax-recovery-2026-11-13.ru.md). -Стабильная публикация отложена до исправления и перепроверки очистки графики Undo, -приёмки параметрических изменений, актуального -Drawing, полного перезапуска Fusion, Windows и остальных путей сохранения/восстановления. +Проверка обновления радиуса/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/stability-native-2026-11-13.ru.md b/docs/validation/stability-native-2026-11-13.ru.md index 7b6c200..0147157 100644 --- a/docs/validation/stability-native-2026-11-13.ru.md +++ b/docs/validation/stability-native-2026-11-13.ru.md @@ -1,8 +1,8 @@ # Mesora: нативная проверка стабильности, 13.11.2026 -**Решение: stable пока не публиковать.** В прогоне с управляемым запуском Fusion (`f090654`) штатный GUI Save и использование модели без Mesora приняты на macOS для синтетической фикстуры, но подробный trace выявил дублирование графики после Undo (D06). Для D06 реализовано исправление ownership с офлайн-регрессиями; нативный повтор ещё не выполнен. Первоначальный orphan получен другим способом перезагрузки Python и не является доказательством неисправности нынешнего штатного GUI-пути. Параметрическое изменение, полный restart, актуальный Drawing и Windows Fusion ещё не приняты. +**Текущий итог: 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 не выполняли из-за открытого изменённого пользовательского документа. @@ -134,3 +134,79 @@ Fusion самостоятельно восстановила удалённую - [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 index 6576c2b..0f0505e 100644 --- a/docs/validation/stable-release-cjm-2026-11-13.ru.md +++ b/docs/validation/stable-release-cjm-2026-11-13.ru.md @@ -1,5 +1,8 @@ # 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-проверки. ## Продуктовая цель @@ -30,23 +33,23 @@ | ID | Сценарий и критерий приёмки | Автоматическая проверка / доказательство baseline | Нативная проверка и текущий статус | Дефект / повторная проверка | | --- | --- | --- | --- | --- | -| S01 | Установка/старт/стоп дважды без дублей UI и handlers; Run on Startup | `test_package`, validator: PASS | macOS/Windows PENDING на финальном ZIP; UI, count handlers и версия | Повторить после финальной сборки | -| S02 | Создать и применить все 7 видов: distance, edge_length, radius, diameter, angle, area, perimeter | arithmetic, geometry, renderer tests: PASS | На цилиндре, блоке, двух гранях и дуге сверить Fusion Inspect; macOS/Windows PENDING | Сверять units и нет chord вместо arc | -| S03 | Некорректный/неполный/duplicate выбор не применяется; Cancel не меняет committed | `test_measurement_batch`, `test_table_command`: PASS | Сменить тип и геометрию нескольких строк, OK/Cancel: PENDING | Нельзя потерять другую строку | +| 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 | Изменить радиус/высоту/длину: число, выносные и положение обновляются автоматически | На baseline нет lifecycle-регрессии пересчёта | Native параметрический edit→закончить команду→сверить без Refresh: PENDING | D02; повторить после интеграции событий | -| S07 | Undo/Redo изменения геометрии и Mesora возвращает согласованные определения и аннотации | На baseline нет full transaction-проверки | **macOS FAIL (f090654, trace counters26–49)**: metadata hidden восстановилась, но после Undo runtime tracked1 при design actual2 (38–39), то есть восстановленная графика не учтена и дополнительно отрисована новая. Redo затем удаляет actual groups; повторы Undo воспроизводят mismatch. Metadata-only PASS не является графическим PASS; Windows PENDING | Нельзя считать state в памяти доказательством Undo | -| S08 | Удалённая/подавленная/неоднозначная ссылка явно недоступна; остальные строки редактируются | resolver rejects missing/ambiguous: PASS | Удалить measured feature, открыть Mesora, исправить/удалить плохую строку: PENDING | D03; prefill baseline прерывается на resolve | +| 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; значения пересчитаны | Только отдельный persistence stub baseline PASS, runtime не подключён | **macOS PARTIAL (root, f090654)**: open v2 автоматически восстановил 2 definitions, 1 group при скрытом m1; GUI Save v3→managed stop→reopen v3 без Mesora: body=1, groups=0, clean=True, визуально размеров нет. Все 7 типов/Windows PENDING | D01; полная матрица после подключения persistence | -| S11 | Полный restart Fusion восстанавливает определения и не оставляет orphan graphics | Offline не доказывает | macOS/Windows PENDING; stop→save→exit→start→open; снимки до/после | Релизный gate, не заменяется count groups | -| S12 | Save As создаёт независимую копию набора; изменения копии не меняют исходник | Document isolation persistence stub PASS | **macOS PARTIAL (root f090654)**: UI Save As создал отдельную копию v1, clean, groups=0, removed_for_save=True, 2 definitions. Observer подтверждён контрольными callbacks: PLM360SaveAs14→Saving22 groups0→Saved23 groups0→Terminated24 без recreate. Copy reopen без Mesora и независимость исходника PENDING; Windows PENDING | D01; убедиться в сохранении refs после копии | +| 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 PASS: v162→v163; финальный код/Windows PENDING | D04; проверить с persistence и auto-update заново | -| S15 | Два документа и Drawing не смешивают definitions/visibility; закрытие не держит stale state | Persistence stub isolation PASS | Model A→B→Drawing→A, закрыть B, новый C: PENDING | Проверить events принадлежат нужному document | -| S16 | Transformed/nested occurrences, orbit, zoom, units дают корректные числа/позиции | Geometry context/renderer layout tests PASS | macOS/Windows PENDING; ненулевой transform, вложенные компоненты, mm/in | Старый zero-transform smoke недостаточен | -| S17 | Повреждённый/будущий schema не перезаписывается; ошибка понятна, остальные документы работают | `test_persistence`, schema tests PASS | Синтетические attributes fixtures: PENDING | D01; runtime должен fail closed и сохранять исходный payload | +| 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 | @@ -54,18 +57,19 @@ | 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 | OPEN на baseline; реализация делегирована отдельно | -| D02 | Blocker | Подписки baseline не запускают пересчёт при изменении геометрии; camera handler только ориентирует text | S06/S07 автоматически обновляют актуальную геометрию без ручного Refresh | OPEN на baseline | -| D03 | Major | `BatchCommand.prefill` разрешает каждую ссылку без обработки ошибки строки: одна плохая ссылка прерывает заполнение/открытие командного диалога | S08: остальные строки доступны, плохую можно удалить/исправить без потери данных | OPEN на baseline; сообщено владельцу runtime | -| D04 | Major | После save `removed_for_save` блокирует graphics до явного действия; при interrupted save нет подтверждённого recovery | S09/S13/S14 без loop, данные доступны после любого исхода save; фактический UX описан | OPEN на baseline | +| 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 | S07 Undo: штатный observer trace38–39 показывает tracked_groups=1, valid_tracked_groups=1, actual custom_graphics_group_count=2 после восстановления definition. При Undo34–37/46–49 actual1 уже присутствует при tracked0; deferred render добавляет ещё одну группу | Повторный UI Undo/Redo без лишних Mesora groups, все owned groups учтены; после stop/save/reopen без аддина аннотаций нет; чужая графика не удаляется | OPEN; lifecycle ownership fix в работе, нативный retest обязателен | +| 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: все обязательные сценарии приняты на заявленных платформах, blocker/major закрыты или явно согласован scope; 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 и запускает релиз; его выполнять после приёмки. +Публикационный 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 и запускает релиз; его выполнять после приёмки. ## Повторная офлайн-проверка после доработок @@ -136,8 +140,183 @@ Save As: настоящий Cancel сохранил исходный набор После открытия синтетической копии 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: Undo graphics FAIL, D06 +## История оценки 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 открыт. Прежние утверждения о groups1 на Undo относились только к `len(state.groups)` и не доказывали отсутствие дубликатов. Ownership/reconciliation fix разрабатывается отдельно; до нового нативного прогона успешное закрытие не заявляется. Повторная приёмка должна сравнивать runtime tracked/valid и реальные Mesora-owned groups на каждом шаге, проверить видимость, stop и save/reopen. Нельзя удалять все CustomGraphics документа: чужая графика должна сохраняться. Этот дефект не отменяет отдельные S19 доказательства штатного save/reopen без Undo, но блокирует стабильный релиз до исправления и повторной проверки. +Итог этого исторического прогона: восстановление метаданных подтверждено, но 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 index a762b36..c8353e5 100644 --- a/docs/visibility-and-drawing.md +++ b/docs/visibility-and-drawing.md @@ -1,88 +1,48 @@ -# Visibility, persistence and Drawing +# Visibility, saving and Drawing [Русская версия](visibility-and-drawing.ru.md) -**Status: experimental validation candidate; stable release withheld.** Undo -reproduced duplicate graphics; cleanup correction and native retesting are required. Managed -macOS GUI testing passed save cleanup and the checked save/reopen/edit path without -Mesora: no dimensions were visible while the add-in was stopped. Starting Mesora -restored definitions, visibility, offsets and current values. Earlier orphan -observations came from a different Python loading/API path and do not establish a -failure of the current managed GUI save path. Use disposable documents while the -remaining gates are open. See [native evidence](validation/stability-native-2026-11-13.ru.md). +## Show or hide dimensions -Each measurement row has an eye button. Click it to hide or show that measurement -without removing its geometry references, type or offset. A crossed-out eye means -the row is hidden. Hidden rows remain editable. +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. -The eye next to **+**, **−** and the trash button hides or shows the whole set. -It preserves individual row settings: showing the set again keeps individually -hidden rows hidden. Visibility changes preview immediately; **OK** stores committed -geometry references, measurement types, offsets and visibility in the design's -attributes. **Cancel** discards the draft and restores committed visibility. -Measured values are recalculated from current geometry rather than stored. -Unsupported or damaged stored definitions are not silently overwritten. +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. -Automatic updates are implemented through `commandTerminated` followed by a custom -event on Fusion's permitted execution thread. GUI eye application passed on the -macOS fixture. Undo/Redo restored visibility metadata, but Undo revived an untracked -graphics group and deferred rendering added another: actual groups reached two -while State tracked one. Graphics Undo acceptance failed; cleanup needs correction -and native retesting. Parametric edits and full recovery also need acceptance; implementation and offline tests do not establish every native path. +## Place labels and rotate the model -The candidate also implements definition loading on document open and Mesora -startup. Display is requested through a deferred custom event; activation may -resume an existing open/startup request, while workspace, active-document and -active-command checks gate rendering. Saving clears the pending restore request. -Managed macOS startup/reopen restored two definitions, a hidden row, offsets and -the current edge length after geometry was edited without Mesora. An independently -managed observer confirmed custom-event delivery and real save callbacks. Direct -MCP import of an observer did not confirm callbacks and cannot establish their -absence in the managed add-in. See [native evidence](validation/stability-native-2026-11-13.ru.md); -no full Fusion restart acceptance has been completed. +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. -When the UI save event runs, Mesora removes tracked graphics before saving. It -deliberately does not recreate them inside `documentSaved`: that makes the source -design modified again and can make Drawing creation repeatedly save the source. -After a save, open Mesora or use **Refresh Dimensions** to show the dimensions -again. Document activation alone does not create a new restore request, because -Drawing can activate its source during creation; it may only resume an existing -open/startup request. Workspace activation does not recreate graphics. The camera handler does -not update model graphics in Drawing or during workspace transitions. +## Save and reopen -Managed GUI Save and Save As confirmed cleanup; cancellation preserved dimensions. -The checked file reopened without dimensions while Mesora was stopped, remained -editable and savable, and restored current measurements when Mesora started. -Manual refresh after save remains a workaround. API Save/Save As with the managed -lifecycle, copy isolation and remaining recovery paths need separate acceptance. -The earlier orphan file is historical evidence from a different loading/API path; -a zero API group count alone is still insufficient to prove an annotation-free file. +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. -## Acceptance checklist +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. -Use a new disposable model on each supported OS. Record a result and evidence for -each step; this checklist itself does not mark any gate passed. +## Drawing and verification -1. Create two measurements. Hide one row; verify its graphic disappears and its - row, geometry, type and offset remain. Change the offset while hidden. -2. Hide and show the whole set. Verify the individually hidden row stays hidden. -3. Apply, reopen Mesora, and verify both eye states. Show the hidden row and - cancel; verify the committed visibility remains unchanged. -4. Apply with all measurements globally hidden, reopen and show them; verify - individual settings are retained. Remove a hidden row and add another row. -5. Change the referenced geometry, then Undo and Redo. Verify values and placement - update, and missing/ambiguous references do not display stale measurements. -6. Test UI Save, API save and Save As independently with dimensions shown. Verify - cleanup, document cleanliness and explicit **Refresh Dimensions** behavior. -7. Stop Mesora, close and reopen, then fully restart Fusion and reopen. Inspect - visually for persistent annotations as well as checking API group counts. - Reload Mesora and verify definitions, offsets and both visibility levels. -8. With dimensions shown, create a Drawing from the design. Verify creation reaches - the drawing sheet and Base View, with no endless source-version increments. -9. Return to the model and verify measurements and visibility. Test canceled/failed - save and close paths without discarding or overwriting definitions. +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. -Undo graphics cleanup/retesting, parametric changes, latest-candidate Drawing, -Windows, full Fusion restart and -remaining API save/recovery gates still prevent a stable release. See [Fusion safety notes](fusion-safety.md) -and the [product acceptance matrix](validation/stable-release-cjm-2026-11-13.ru.md). +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 index 11cb2c7..e6d5e37 100644 --- a/docs/visibility-and-drawing.ru.md +++ b/docs/visibility-and-drawing.ru.md @@ -1,95 +1,50 @@ -# Видимость, сохранение определений и Drawing +# Видимость, сохранение и Drawing [English](visibility-and-drawing.md) -**Статус: экспериментальный кандидат для проверки; стабильный релиз отложен.** -Undo воспроизвёл дублирование графики; нужны исправление очистки и нативная перепроверка. -Штатная GUI-проверка macOS подтвердила очистку и проверенный путь сохранения, -повторного открытия и редактирования без Mesora: при остановленном аддоне размеров -не было. Запуск Mesora восстановил определения, видимость, смещения и актуальные -значения. Прежний постоянный артефакт получен в другом пути загрузки Python/API и -не доказывает неисправность текущего штатного пути GUI-сохранения. Пока остаются -непройденные проверки, используйте тестовые документы. См. -[нативные доказательства](validation/stability-native-2026-11-13.ru.md). +## Показ и скрытие размеров -У каждой строки измерения есть глазик. Он скрывает или показывает размер, -сохраняя ссылки на геометрию, тип и смещение. Перечёркнутый глазик означает, что -строка скрыта. Скрытые измерения можно редактировать. +У каждой строки измерения есть глазик. Он скрывает или показывает размер, сохраняя +ссылки на геометрию, тип и смещение. Скрытые строки можно редактировать. Глазик +рядом с **+**, **−** и корзиной управляет всем набором. Повторный показ набора +сохраняет индивидуально скрытые строки. -Глазик рядом с **+**, **−** и корзиной скрывает или показывает весь набор. Он -сохраняет настройки отдельных строк: при повторном показе набора индивидуально -скрытые размеры остаются скрытыми. Изменения сразу видны в предпросмотре; -**OK** записывает подтверждённые ссылки на геометрию, типы измерений, смещения и -видимость в атрибуты модели. **Cancel** отменяет черновик и возвращает -подтверждённую видимость. Значения пересчитываются по актуальной геометрии, а не -сохраняются. Неподдерживаемые или повреждённые определения не перезаписываются молча. +Изменения видимости сразу отображаются в предпросмотре. **OK** записывает +определения, смещения и видимость в модель; **Cancel** отменяет черновик. Значения +пересчитываются по геометрии, а не сохраняются как кешированные числа. Потерянные +ссылки остаются доступны для исправления или удаления вместо показа старого значения. -Автообновление реализовано через `commandTerminated` с последующим custom event -в разрешённом потоке Fusion. Применение глазиков через GUI прошло проверку на -macOS-фикстуре. Undo/Redo восстанавливали метаданные видимости, но Undo вернул -неотслеживаемую группу графики, а отложенная перерисовка добавила вторую: реально -две группы при одной в State. Графическая приёмка Undo не пройдена; нужны -исправление очистки и повторная нативная проверка. Параметрические изменения и -полное восстановление также требуют приёмки; реализация и автономные тесты не подтверждают все нативные пути. +## Размещение подписей и вращение модели -Кандидат также реализует загрузку определений при открытии документа и запуске -Mesora. Показ запрашивается через отложенный custom event; активация может -продолжить уже существующий запрос от открытия/запуска, а проверки рабочей среды, -активного документа и команды ограничивают создание графики. Сохранение снимает -ожидающий запрос восстановления. Штатный запуск/повторное открытие на macOS -восстановили два определения, скрытую строку, смещения и актуальную длину ребра -после изменения геометрии без Mesora. Независимый штатно запущенный observer -подтвердил доставку custom event и реальные callback сохранения. Прямой импорт -observer через MCP не подтвердил callback и не доказывает их отсутствие у штатного -аддона. См. [нативные доказательства](validation/stability-native-2026-11-13.ru.md); -приёмка полного перезапуска Fusion не выполнена. +Mesora разносит подписи при добавлении или изменении размеров. При вращении и +масштабировании их положение и выносные линии остаются на месте в модели; меняется +только ориентация текста для чтения. Угловые дуги также неподвижны. В новом ракурсе +подписи могут спроецироваться друг на друга; нажмите **Refresh Dimensions**, чтобы +разместить их для этого вида. Изменение модели, геометрии, смещений и видимости +может заново разместить весь набор. -Когда срабатывает событие сохранения через UI, Mesora удаляет отслеживаемую -графику перед сохранением. Она намеренно не пересоздаётся в `documentSaved`: это -снова помечало модель изменённой и могло вызывать повторное сохранение при создании -Drawing. После сохранения откройте Mesora или нажмите **Refresh Dimensions**, -чтобы вернуть размеры. Сама активация документа не создаёт нового запроса -восстановления: Drawing может активировать исходную модель в ходе создания. Она -может лишь продолжить существующий запрос от открытия/запуска. Активация рабочей -среды не пересоздаёт графику. Обработчик камеры не меняет графику модели в Drawing и во время -переключения рабочих сред. +## Сохранение и повторное открытие -Штатные GUI Save и Save As подтвердили очистку; отмена сохранила размеры. -Проверенный файл открывался без размеров при остановленной Mesora, оставался -доступен для изменения и сохранения и восстанавливал актуальные измерения после -запуска Mesora. Ручное обновление после сохранения остаётся обходным путём. -API Save/Save As со штатным жизненным циклом, изоляция копии и остальные пути -восстановления требуют отдельной приёмки. Прежний файл с постоянным артефактом — -историческое доказательство из другого пути загрузки/API; одного нулевого счётчика -групп API по-прежнему недостаточно для подтверждения отсутствия размеров в файле. +Определения и настройки сохраняются вместе с моделью. Mesora удаляет отображаемую +графику перед сохранением и не пересоздаёт её в `documentSaved`. Это оставляет +исходник чистым, когда Drawing требуется его сохранить. После сохранения откройте +Mesora или нажмите **Refresh Dimensions**, чтобы снова показать размеры. -## Проверка +Открытие документа или запуск Mesora загружают сохранённые определения и +запрашивают показ в подходящем контексте Design. Без работающей Mesora модель +доступна для редактирования, а размеры не показываются. Отмена Save As сохраняет +текущий набор. -Используйте новую тестовую модель на каждой поддерживаемой ОС. Для каждого шага -фиксируйте результат и доказательство; сам список не означает прохождение проверок. +## Drawing и проверка -1. Создайте два измерения. Скройте одно: графика исчезает, строка, геометрия, тип - и смещение остаются. Измените смещение скрытого измерения. -2. Скройте и покажите весь набор. Индивидуально скрытый размер остаётся скрытым. -3. Нажмите **OK**, откройте Mesora снова и проверьте оба глазика. Покажите скрытую - строку и нажмите **Cancel**: прежняя видимость должна сохраниться. -4. Примените глобальное скрытие, откройте команду и включите показ. Настройки строк - должны сохраниться. Удалите скрытую строку и добавьте новую. -5. Измените связанную геометрию, выполните Undo и Redo. Проверьте пересчёт значений - и размещения; потерянные/неоднозначные ссылки не должны показывать старые размеры. -6. Отдельно проверьте UI Save, API save и Save As с показанными размерами: - очистку, отсутствие изменений после сохранения и явный **Refresh Dimensions**. -7. Остановите Mesora, закройте и откройте модель; затем полностью перезапустите - Fusion и откройте её снова. Кроме счётчика API, визуально проверьте отсутствие - постоянных размеров. Запустите Mesora и проверьте определения, смещения и оба - уровня видимости. -8. При показанных размерах создайте Drawing. Должны открыться лист и команда - Base View, без бесконечного роста версий исходной модели. -9. Вернитесь в модель и проверьте измерения и видимость. Проверьте отмену и ошибку - сохранения/закрытия без потери или перезаписи определений. +Нативная приёмка macOS подтвердила переход в Drawing при показанных размерах, +одно сохранение исходника и чистое состояние после возврата в модель. Размещение +Base View отменено; создание и оформление завершённого чертежа в эту проверку не входили. -Очистка графики Undo с перепроверкой, параметрические изменения, Drawing на -актуальном кандидате, Windows, полный -перезапуск Fusion и оставшиеся пути API-сохранения/восстановления пока препятствуют -стабильному релизу. См. [ограничения Fusion](fusion-safety.md) и -[продуктовую матрицу приёмки](validation/stable-release-cjm-2026-11-13.ru.md). +Принятая область 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).