# Canvas Pilot persistence audit Audited against the editor, project loader, application settings, capture controls, layer tree, format properties, import/export controls and device transfer state. Implemented with [project version 12](canvas-pilot.md). This is an ownership audit: not every control should become document data. | Parameters | Owner and decision | | --- | --- | | Output resolution / aspect | Project: exact width/height. The output aspect preset is derived from them, not stored twice. | | Layer position, dimensions, stacking order | Project: full-precision bounds and array order; display/export rounding never changes the saved values. | | Input format, native dimensions, custom input crop, shared input slot | Project: `inputs` and layer `source_id`, already saved. | | Layer format, dynamic crop, zoom and offset | Project: final bounds and advanced crop, already saved. Zoom/offset/aspect are derived from these authoritative values. | | Names, stable IDs, next ID, folder membership, visibility, lock, pivot | Project, already saved. Folder visibility/locking acts on members, so there is no separate state to save. Explicit folder names are saved separately in project v12 and may have no members. | | Device screen/layer mapping | Project, already saved per layer. Physical source routing is separate and is not silently changed by a geometry send. | | Reference images, order, visibility, opacity, fit/native sizing, offset | Project, already embedded. Focused reference row is temporary. | | Selected layers, viewport zoom/pan, positioning origins | Project, already saved. Selection is validated against visible/unlocked IDs. | | Backdrop title, source guide pattern, outline mode, aspect-ratio lock, icon captions | Project, already saved. Pattern/ratio lock/captions also have application defaults. | | Magnet, pixel/edge snapping, overlay visibility/divisions, overlay snapping | **Added to project**. Application settings remain the defaults for a new workspace; opening a project restores its setup. | | 10/100-pixel tool grid, group resize mode | **Added to project**. They determine editing behavior and now follow the saved workspace rather than the previously opened document. | | Collapsed folder rows | **Added to project**. Keeps larger memory collections manageable; stale folder names are filtered out. | | Preview input, device-address binding, editor-source binding, enable flag | **Added to project** per stable layer ID. Preselected-but-not-yet-captured inputs are saved too. | | Last captured still, guide opacity | **Added to project**. Original image bytes are embedded for offline reuse, subject to the shared 64 MiB image budget. | | Auto-refresh choice, refresh interval, show no-signal inputs | **Added to project**. Auto-refresh restores paused; no fetch or connection is initiated by loading. Resume/capture is explicit. | | Theme/recent themes, connection address/history, startup connection, allow Program | Application settings only. These belong to the workstation/operator; opening a document must not switch connections or global permissions. Capture host strings are bindings, not connection instructions. | | All/selected/folder transfer scope, target bank, export sizing strategy | Session choices. Links and folders are persistent; the current transfer action and destination bank are not document content. Existing behavior is retained. | | Advanced shared-device input edit checkbox and staged edits | Session-only by design. These are pending changes to external shared input settings; only explicit edits are sent. Local source/crop geometry is saved separately. | | Import mapping, size/position/zoom toggles, ignored items/pages | Temporary import review. Applied results are saved; unfinished operations and their external payloads are not. | | Geometry export codec, selection scope, background/placeholders options | Temporary export choices. No destination files are reopened or overwritten by project loading. | | Alignment reference, prepared numeric ratio, active navigation/pivot/grid gesture, crop-edit mode, open tab/menu/dialog | Temporary editing context. No partial interaction is replayed; the resize mode and grid spacing themselves are saved as above. | | Undo/redo, text drafts, drag snapshots, selection marquee, errors/progress, cached device capabilities, network jobs/timers | Transient runtime state. Loading starts a fresh document history and discards late capture results. | | Named project path and last manual-save time | Recovery envelope only, not the portable project. Recovery uses the same project representation and image validation. | The [application settings contract](canvas-pilot-settings.md) is unchanged (v8). The [recovery envelope](canvas-pilot-recovery.md) is unchanged (v1); its nested project migrates to v12. Geometry export representations are unchanged and omit capture images/settings; optional fixed-reference backgrounds retain their existing behavior. Regression coverage includes current-schema round trips, versions 1–11 migration, invalid assignments/settings and unknown/missing fields, embedded-still decoding, atomic failure on malformed images, cleared stale previews, restore-without-fetch, manual resumption eligibility and saved resize setup. The guide and example JSON are updated with the schema.