136 lines
8.0 KiB
Markdown
136 lines
8.0 KiB
Markdown
# Conversation handoff — 2026-11-16
|
|
|
|
Read this when resuming work in the standalone Canvas Pilot repository. This is a
|
|
snapshot of conversation context, not a replacement for the current code, Git status,
|
|
[plan](../canvas-pilot/plan.md), [contracts](../interfaces/README.md) or
|
|
[AGENTS.md](../../AGENTS.md). Recheck status before acting on dated information.
|
|
|
|
## Where work stands
|
|
|
|
The migration and README redesign are complete. The user is reopening the
|
|
conversation in this project; no additional feature implementation is currently
|
|
underway. Application behavior was preserved during extraction.
|
|
|
|
- Local project: `/home/beffroi/Documents/Git/canvas-pilot`.
|
|
- Original project: sibling `../beffroi-tools`.
|
|
- Gitea: https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot
|
|
- Public book: https://books.dandaedre.com/manuals/canvas-pilot/
|
|
- All 165 project-owned files were audited against the pre-migration source commit.
|
|
See [migration provenance and inventory](migration.md).
|
|
- `AGENTS.md` contains repository conventions and a project/documentation map.
|
|
[The documentation index](../README.md) links the advanced guide, task/test lists,
|
|
stretch goals, engineer questions, adapter research and demonstration script.
|
|
|
|
## Git and publication state at handoff
|
|
|
|
The migration commit `4eef1bc` was pushed and verified on Gitea. Follow-up commits
|
|
`a595838` (audit/agent guidance) and `b2fcab4` (README redesign) were committed locally
|
|
but not pushed. This handoff is another local commit. Check
|
|
`git log origin/main..HEAD` and fetch when appropriate rather than assuming this
|
|
snapshot is still current. Do not push without a user request.
|
|
|
|
The original repository's extraction/link commit is `7b91ede`, committed locally
|
|
and not pushed. Its working tree was clean at the last check.
|
|
|
|
The Gitea repository description and avatar were updated through the API and
|
|
verified. The avatar is `crates/canvas-pilot/assets/app-icon.png`. The description
|
|
explains desktop layout editing, offline work and Midra/Aquilon geometry transfers.
|
|
These settings are server-side; they do not require a Git commit.
|
|
|
|
The new Jenkins job hookup has not been performed in this conversation. Setup is
|
|
in [CI](ci.md). The three new badge URLs returned HTTP 404 at the last check;
|
|
the README initially kept them in a collapsed Build status section pending the
|
|
first publication. The user subsequently requested moving them back to the top,
|
|
which has been done. See [release readiness](releases.md) for the later no-build audit. No new book deployment was performed during migration.
|
|
Canvas Pilot publishes only its own book and badges; beffroi-tools retains ownership
|
|
of the shared manuals landing page. Never synchronize/delete that shared root.
|
|
|
|
A user-provided Gitea token remains at `../gitea-token.txt` on this workstation,
|
|
outside both repositories. It was successfully used for repository settings and
|
|
avatar upload. Do not copy or display it. Repository API operations worked; querying
|
|
`/api/v1/user` returned 403, so account-profile access must not be assumed. Gitea's
|
|
own `/swagger.v1.json` documents the API, including base64 repository-avatar upload.
|
|
|
|
## Decisions and preferences to retain
|
|
|
|
- The name is **Canvas Pilot**. It is independent software, not affiliated with
|
|
Analog Way. Keep existing settings paths and serialized Midra identifiers compatible.
|
|
- Adapters should be first-class and practical, with a shared intermediate geometry
|
|
representation and isolated family-specific behavior. Avoid abstraction for its
|
|
own sake. Preserve targeted reads and partial writes for performance.
|
|
- Aquilon support is completed for the documented standalone AQL Cmax 6.2.x profile;
|
|
do not reopen the completed task or extend its claim to untested configurations.
|
|
- Multiple editor screens are a distant stretch goal: a dropdown selects one screen
|
|
at a time. Other adapters need protocol documentation and a usable emulator before
|
|
development. Their ranking is research, not a promised release schedule.
|
|
- Export cleanup was explicitly marked solved. Saving a captured input as a separate
|
|
image was removed from the backlog at the user's request; do not restore that task.
|
|
- The operator cannot perform exact pixel/subpixel measurements. Keep precision and
|
|
mask-rasterization questions in the engineer-facing stretch goal; do not make those
|
|
measurements a prerequisite for ordinary operator acceptance.
|
|
- Explicit layer aspect modes take precedence over shared input fill. Crop is applied
|
|
first; 1:1 uses centered native pixels, Fullscreen stretches, Centered fits inside,
|
|
and Cropped fills/clips. Advanced fit stays behind an opt-in control. Existing
|
|
helpers support the intended crop/move interactions, and masking uses a separate
|
|
magenta box. Consult the code and guide before altering their behavior.
|
|
|
|
## Pending input-ratio scope
|
|
|
|
The user described correcting a stretched/deformed input, usually left on Native,
|
|
with preset or custom ratios. Manual research established the distinction between
|
|
**Content ratio** and **Transform to**; the result is already recorded in
|
|
[Formats and crop](../canvas-pilot/guide/formats-and-crop.md#content-ratio-versus-transform-to).
|
|
Advanced device controls already exist. A follow-up question about adding a **local
|
|
editor correction/preview model** was not answered before the migration.
|
|
Do not treat this as an implemented feature or a finalized new schema. Resume from
|
|
the documented distinction and clarify the desired local behavior when that work
|
|
is taken up; preserve the input-agnostic editing workflow and opt-in shared writes.
|
|
|
|
## Video plans
|
|
|
|
The user plans a **showcase video** and a **video manual**, and asked whether videos
|
|
also belong in the book. No videos, hosting choice or embed implementation exist yet.
|
|
The [feature demonstration checklist](../canvas-pilot/feature-demo-checklist.md)
|
|
already supplies an ordered recording script.
|
|
|
|
The user approved the following approach and asked to put it in the stretch goals:
|
|
|
|
- Showcase near the top of the README and book introduction.
|
|
- A walkthrough linked from quick start, with chapter timestamps.
|
|
- Optional short demonstrations beside difficult interactions: crop, 1:1 movement,
|
|
masks and device mapping/transfers. Start with the two main videos first.
|
|
- Written instructions remain the searchable reference; captions, no autoplay, and
|
|
the application version help viewers. Host large video files outside Git and link
|
|
or embed them once a host is chosen.
|
|
|
|
The existing screenshots are real captures from before the Canvas Pilot rename;
|
|
the redesigned README explicitly labels them. Their recipes and provenance are in
|
|
[the screenshot guide](../canvas-pilot/images/capture.md). Do not edit old screenshots
|
|
to imply a new capture; recapture the application if updating them.
|
|
|
|
## Device testing context
|
|
|
|
The user explicitly authorized testing and writes on the emulator at
|
|
`192.168.10.146:3000` and later said it was online again. At the last recorded work
|
|
it was an Aquilon emulator; AWJ TCP 10606 was also needed. This is historical scope,
|
|
not evidence that the endpoint is online or unchanged today. Discover identity
|
|
before writing, preserve/restore the baseline, and keep emulator results distinct
|
|
from physical-output acceptance.
|
|
|
|
The physical Midra at `192.168.10.143:80` was used read-only in the recent work;
|
|
the emulator authorization does not extend to that device. No device connection
|
|
is needed for repository, documentation or routine automated tests.
|
|
|
|
## Last validation evidence
|
|
|
|
The extraction passed formatting, both Clippy feature configurations, rustdoc,
|
|
Python tests and Rust tests. Canvas Pilot had 395 passing default-feature tests and
|
|
390 in each restricted configuration; the remaining workspace had 149 Rust tests.
|
|
Measured line coverage was 91.03% for Canvas Pilot and 89.83% for beffroi-tools
|
|
against a 75% floor. These are historical measurements, not live CI badges.
|
|
|
|
The expanded book built with pinned mdBook 0.5.4 and validated 41 pages and 1,826
|
|
local links/assets. The README was rendered locally and visually inspected;
|
|
local links and badge tests passed. Subsequent documentation edits should rebuild
|
|
the book; code changes need the relevant checks in [CI](ci.md).
|