From f4584e0b7dae92f38693c78e0169a032853cefd2 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Mon, 16 Nov 2026 11:44:17 +0100 Subject: [PATCH] Use manual-review wording in documentation and acceptance records --- docs/canvas-pilot/aquilon-compatibility.md | 4 ++-- docs/canvas-pilot/changelog.md | 11 +++++++---- docs/canvas-pilot/device-check.md | 2 +- docs/canvas-pilot/guide/files.md | 12 ++++++------ docs/canvas-pilot/guide/format-matrix.md | 3 +-- docs/canvas-pilot/plan.md | 16 ++++++++-------- docs/canvas-pilot/resolutions.md | 4 ++-- docs/interfaces/canvas-pilot-exchange.md | 10 +++++----- docs/templates/canvas-pilot/catalog.md | 2 +- 9 files changed, 33 insertions(+), 31 deletions(-) diff --git a/docs/canvas-pilot/aquilon-compatibility.md b/docs/canvas-pilot/aquilon-compatibility.md index 1d7de1a..3f82222 100644 --- a/docs/canvas-pilot/aquilon-compatibility.md +++ b/docs/canvas-pilot/aquilon-compatibility.md @@ -4,7 +4,7 @@ Implemented and tested 2026-11-15. **Aquilon is a first-class supported adapter** for standalone AQL Cmax firmware 6.2.x; the tested emulator is **6.2.79** at the -user-provided custom port. See the [current adapter contract](../interfaces/device-adapters.md). +configured custom port. See the [current adapter contract](../interfaces/device-adapters.md). The supported profile is complete for its documented scope. Physical-output acceptance remains outstanding; other models, linked units and unsupported @@ -71,7 +71,7 @@ probe on 2026-11-15 confirmed the transport details below; no settings were chan ## Emulator response-size diagnosis -Read-only GETs at the user-supplied emulator confirmed `/api/tpp/v1/system` +Read-only GETs at the test emulator confirmed `/api/tpp/v1/system` returns `type: "AQL Cmax"`, firmware **6.2.79**, and `/api/stores/device` returns **124,076,981 bytes** (about 118 MiB). This exceeds the current Midra 32 MiB state limit. Raising that limit alone would still fail at the unsupported-family check. diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md index ea21687..ff2eae5 100644 --- a/docs/canvas-pilot/changelog.md +++ b/docs/canvas-pilot/changelog.md @@ -4,6 +4,9 @@ ## Unreleased +- Reworded conversational test attributions as manual reviews across the catalog, + guides and acceptance records, preserving dates and validation boundaries. + - Made the template catalog’s format-choice link more visible with a compact callout and bold introduction, shared by the Markdown page and book. @@ -149,20 +152,20 @@ - Split the backlog into a to-do list (including stretch goals) and a test list. Move Inkscape clipboard acceptance to testing and remove standalone captured - input image saving from planned work at the user's request. + input image saving from planned work following scope review. - Register standalone Aquilon AQL Cmax 6.2.x as first-class supported, based on the recorded 6.2.79 emulator acceptance. Replace the stale implementation handoff with completed milestones and explicit scope boundaries; physical output, other models/firmware and unsupported modes remain unverified. -- Record user-confirmed working clipboard workflows for Illustrator, draw.io and +- Record manually reviewed clipboard workflows for Illustrator, draw.io and Figma. Narrow remaining clipboard acceptance to Inkscape; QCAD and PowerPoint remain file-exchange workflows for this scope. - Validate the supplied Illustrator SVG clipboard sample with regression coverage for fractional coordinates and optional centered-stroke bounds. Record QCAD as - a file-exchange workflow based on user feedback; no clipboard adapter is planned. + a file-exchange workflow following workflow review; no clipboard adapter is planned. Existing SVG parsing handles the sample; live clipboard delivery remains unverified. - Mark export/workflow cleanup solved following user confirmation; move it from @@ -292,7 +295,7 @@ release. Current project schema: **v13**; application settings: **v8**. - Add direct links to the published mdBook manual from the project README, tool guide and documentation indexes. -- Mark PPTX, draw.io and SVG format acceptance as solved following the user's confirmation that all three work (2026-11-14). +- Mark PPTX, draw.io and SVG format acceptance as solved following manual review confirming all three work (2026-11-14). - Replace the incomplete DXF skeleton with the official shared Craft DXF document writer/reader; add optional Craft DWG exchange with the same pixel geometry and canvas limits. Refresh CAD starter files and cover document structure, binary DXF and DWG round trips. Add a byte-preserving ZIP of the AI templates to bypass Gitea/browser PDF preview downloads. diff --git a/docs/canvas-pilot/device-check.md b/docs/canvas-pilot/device-check.md index c00d565..55f2217 100644 --- a/docs/canvas-pilot/device-check.md +++ b/docs/canvas-pilot/device-check.md @@ -92,7 +92,7 @@ sanitize before sharing. Its exchange contract is documented in ## Reviewed send and cropped-layer round trip -The user's later authorization permits Program changes and accepts the physical-bank +The later test authorization permits Program changes and accepts the physical-bank TAKE race. This supersedes the earlier Preview-only restriction above. **Export → Configure Midra export…** now supports diff --git a/docs/canvas-pilot/guide/files.md b/docs/canvas-pilot/guide/files.md index 465937a..e87b4d7 100644 --- a/docs/canvas-pilot/guide/files.md +++ b/docs/canvas-pilot/guide/files.md @@ -79,7 +79,7 @@ The supplied [Figma SVG sample](../../../crates/canvas-pilot/tests/fixtures/figm works through the existing SVG/value paste parser: two 640 × 360 rectangular paths at (0, 0) and (1040, 0), including their matrix translations and order. Paste SVG text and review the detected shapes in the mapping dialog. -The user confirmed actual Figma copy/paste working on 2026-11-15. This validates +Figma copy/paste was manually reviewed on 2026-11-15. This validates the tested SVG workflow, not every native binary/HTML clipboard format. ### Illustrator SVG clipboard text @@ -89,11 +89,11 @@ works through the existing SVG/value paste parser. Its two 1814.174 × 1020.473 rectangles retain fractional positions (0.354, 0.354) and (395.791, 461.357). Enabling outline inclusion adds the centered 0.709-unit stroke to their bounds, producing 1814.883 × 1021.182 boxes. Stroke colors are not imported as artwork -through this geometry workflow. The user confirmed actual Illustrator copy/paste -working on 2026-11-15; other native clipboard formats are outside this validation. +through this geometry workflow. Illustrator copy/paste was manually reviewed +on 2026-11-15; other native clipboard formats are outside this validation. For QCAD and PowerPoint, use file exchange; no clipboard-export integration is -planned for the user's reported workflows. +planned for these workflows. ### draw.io clipboard @@ -136,8 +136,8 @@ These are application limits, not verified Eikos limits. Draw.io also exposes raw page XML through **Extras → Edit Diagram**, as described in its [source-editing documentation](https://www.drawio.com/docs/manual/advanced/diagram-source-edit/). -Support is covered by the supplied clipboard data and regression fixtures. The -user confirmed actual draw.io copy/paste working on 2026-11-15. +Support is covered by the supplied clipboard data and regression fixtures. Draw.io +copy/paste was manually reviewed on 2026-11-15. ## Save, open and export diff --git a/docs/canvas-pilot/guide/format-matrix.md b/docs/canvas-pilot/guide/format-matrix.md index bdca023..2769029 100644 --- a/docs/canvas-pilot/guide/format-matrix.md +++ b/docs/canvas-pilot/guide/format-matrix.md @@ -79,8 +79,7 @@ applies to Illustrator and draw.io. “Paste” below means **into Canvas Pilot* | PowerPoint native clipboard | ❌ | ❌ | ❌ | ❌ | ❌ | | QCAD native clipboard | ❌ | ❌ | ❌ | ❌ | ❌ | -Figma SVG, Illustrator SVG and draw.io XML clipboard paths have been confirmed in -user testing. This does not imply support for every application's native binary +Figma SVG, Illustrator SVG and draw.io XML clipboard paths have been manually reviewed. This does not imply support for every application's native binary or HTML clipboard payload. Use the corresponding file path if no supported text is available. PowerPoint and QCAD use file exchange in this workflow. diff --git a/docs/canvas-pilot/plan.md b/docs/canvas-pilot/plan.md index bd44980..307c09b 100644 --- a/docs/canvas-pilot/plan.md +++ b/docs/canvas-pilot/plan.md @@ -55,7 +55,7 @@ device readback and physical-screen acceptance. - [x] Multiple editor layers may share one Midra destination. Mapping warns with other linked layer names/folders; sends reject overlaps only within the chosen scope. This replaces the earlier extra-links-per-layer proposal. Nested folders - and additional file codecs have been removed from scope at the user's request. + and additional file codecs have been removed from scope following scope review. - [x] Both device sizing strategies, Centered-crop imports, required preset apply pulse, rounding/reconstruction checks and readback. Preview/Program protocol checks on Eikos 3.3.10 are recorded; Program availability is a user preference. @@ -65,7 +65,7 @@ device readback and physical-screen acceptance. - [x] Geometry/import/UI/mock-device regression tests, workspace CI, coverage, documentation and release build configuration integration. - [x] **Export/workflow cleanup.** Shared transfer scopes, mapping review and - direct linked send/load are implemented. Marked solved by the user on 2026-11-15. + direct linked send/load are implemented. Manually reviewed and marked solved on 2026-11-15. - [x] **Aquilon / LivePremier: first-class supported (standalone AQL Cmax 6.2.x).** Device-neutral snapshots, family-aware v13 links, bounded targeted AWJ reads, geometry/crop import, mapped Preview/Program sends and pooled input previews. See [adapter contract](../interfaces/device-adapters.md) and [emulator acceptance](aquilon-compatibility.md). Linked units, other models/firmware, shared input corrections and non-centered/masked import remain explicitly unsupported. @@ -97,7 +97,7 @@ device readback and physical-screen acceptance. Keep written instructions as the searchable reference. Include captions and the recorded application version, avoid autoplay, and host large video files outside Git. Link or embed them in the book once a host is chosen. This approach is - user-approved; recording, hosting choice and implementation remain future work. + approved; recording, hosting choice and implementation remain future work. - [ ] **Confirm Midra fit precision with a manufacturer/firmware engineer.** Obtain crop quantization, subpixel centering and rasterization rules, plus @@ -123,20 +123,20 @@ device readback and physical-screen acceptance. ### Completed acceptance -User-confirmed working on 2026-11-14; these format issues are solved: +Manually reviewed on 2026-11-14; these format issues are solved: - [x] **PPTX** — working flawlessly. - [x] **draw.io** — working. - [x] **SVG** — working. -User-confirmed import/export working on 2026-11-15; these format issues are solved: +Import/export manually reviewed on 2026-11-15; these format issues are solved: - [x] **Figma FIG** — import/export validated. - [x] **FigCraft FIGCRAFT** — import/export validated. - [x] **DXF** — import/export validated. - [x] **DWG** — import/export validated. -User-confirmed clipboard workflows on 2026-11-15: +Clipboard workflows manually reviewed on 2026-11-15: - [x] **Illustrator, draw.io and Figma** — actual copy/paste working; supplied samples also have regression coverage. @@ -278,7 +278,7 @@ not part of this desktop tool. The [Analog Way Midra 4K V3.2 manual, July 2024, pp. 83–85](https://www.bhphotovideo.com/lit_files/1168243.pdf#page=83) documents layer alignment, snapping, position and size controls. This supports the workflow research; it does not establish the precise coordinate convention -or current firmware behavior for the user's installation. Avoid portraying all +or current firmware behavior for the target installation. Avoid portraying all WebRCS versions as lacking alignment. The proposed improvement is more explicit corner-based positioning and reference-image inspection. @@ -293,6 +293,6 @@ WebRCS version. The installed firmware is recorded as Eikos 3.3.10. Primary operator OS/display scale and broader platform acceptance remain to verify. Concept A is approved; -the user-supplied draw.io clipboard rectangle is retained as a regression fixture. +the supplied draw.io clipboard rectangle is retained as a regression fixture. The implementation and backlog at the top of this document supersede the original mockup assumptions. diff --git a/docs/canvas-pilot/resolutions.md b/docs/canvas-pilot/resolutions.md index 8222e44..77b22c3 100644 --- a/docs/canvas-pilot/resolutions.md +++ b/docs/canvas-pilot/resolutions.md @@ -221,7 +221,7 @@ device recipe. Unsupported results must not be approximated with masking. Quantize only at the device boundary. Check the reconstructed visible rectangle and sampled source region after quantization. Show the requested and achievable values and residual error; block a supposedly exact recipe when its error exceeds -the verified device precision. Never silently alter the user's final box. +the verified device precision. Never silently alter the final layer box. ## Interaction and changes to the inspector @@ -243,7 +243,7 @@ Pointer-wheel zoom remains camera zoom; content zoom uses its own control to avoid accidental geometry edits. Each drag/edit is one undoable operation. Cropping requires a content illustration: a source-coordinate test pattern can -show framing without live video. A user-provided source still may optionally be +show framing without live video. An imported source still may optionally be added later and must remain distinct from the screen-wide reference image. Do not suggest the screen reference picture is the layer's source content. diff --git a/docs/interfaces/canvas-pilot-exchange.md b/docs/interfaces/canvas-pilot-exchange.md index 24ce821..6952c03 100644 --- a/docs/interfaces/canvas-pilot-exchange.md +++ b/docs/interfaces/canvas-pilot-exchange.md @@ -146,7 +146,7 @@ the fixed unit convention; importing never silently resizes the Midra output. ### Figma FIG -User-validated import/export on 2026-11-15. +Import/export manually reviewed on 2026-11-15. FigCraft writes a native `.fig` ZIP containing the Kiwi-encoded canvas and embedded image assets. Export creates a `Canvas Pilot` frame with screen dimensions and @@ -165,7 +165,7 @@ they do not constitute validation against every Figma service version. ### FigCraft FIGCRAFT -User-validated import/export on 2026-11-15. +Import/export manually reviewed on 2026-11-15. The separate `.figcraft` option uses the pinned `figcraft-format` crate's native version 1 reader/writer, not a renamed `.fig`. Its ZIP contains `document.json` @@ -291,7 +291,7 @@ data or placeholder pictures. ## CAD: DXF and DWG profiles -Both DXF and DWG import/export were user-validated on 2026-11-15. +Both DXF and DWG import/export were manually reviewed on 2026-11-15. DXF uses the official shared `craft-dxf` document model and serializer, pinned to Craft libraries revision `79e97b6febcb62de406e5bcf5a724bd3f7333065` (MIT OR Apache-2.0). @@ -338,8 +338,8 @@ layout. The file contains no script or external resource. ## Limits, import and round trips -**Operator acceptance (2026-11-14):** the user confirmed PPTX working flawlessly, -and draw.io and SVG working. Their reported format issues are marked solved in +**Manual review (2026-11-14):** PPTX, draw.io and SVG workflows were confirmed +working. Their reported format issues are marked solved in the [task list](../canvas-pilot/plan.md#completed-acceptance). Import files and clipboard text, and generated exports, are capped at **16 MiB** diff --git a/docs/templates/canvas-pilot/catalog.md b/docs/templates/canvas-pilot/catalog.md index c0b3653..9c2d5eb 100644 --- a/docs/templates/canvas-pilot/catalog.md +++ b/docs/templates/canvas-pilot/catalog.md @@ -41,7 +41,7 @@ Review the detected rectangles and their destination layers before applying. | FigCraft | [Download .figcraft](canvas-pilot-1080p-2-layers.figcraft) | [Download .figcraft](canvas-pilot-4k-2-layers.figcraft) | FigCraft | | Illustrator AI (optional) | [Download .ai](canvas-pilot-1080p-2-layers.ai) | [Download .ai](canvas-pilot-4k-2-layers.ai) | Requires VectorCraft CLI for Midra import/export; prefer SVG | -FIG, FIGCRAFT, DXF and DWG import/export were confirmed working by the user on +FIG, FIGCRAFT, DXF and DWG import/export were manually reviewed on 2026-11-15. PPTX, draw.io and SVG were previously confirmed; see the [format acceptance list](../../canvas-pilot/plan.md#completed-acceptance).