gronodandDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
1d78957d7a
Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
55 lines
3.1 KiB
Markdown
55 lines
3.1 KiB
Markdown
# 06 — Wizard, artefact gating, resume
|
||
|
||
## Stages
|
||
|
||
| # | DOM | Unlocked when |
|
||
|---|-----|----------------|
|
||
| 0 | `#stage-cal` | Always (optional, not in stepper) |
|
||
| 1 | `#stage-1` | Always |
|
||
| 2 | `#stage-2` | `{basename}.ti1` exists |
|
||
| 3 | `#stage-3` | `.ti1` **and** `.ti2` |
|
||
| 4 | `#stage-4` | `.ti3` exists (imported datasets may skip 1–2) |
|
||
| 5 | `#stage-5` | `.ti3` **and** `.icc`/`.icm` |
|
||
|
||
`verify_stage_artefacts(cwd, basename)` returns `{ stage1_complete, stage2_complete, stage3_complete, stage4_complete, profile_path }`.
|
||
|
||
Stage 4 is **not** unlocked by `.ti2`. Multi-pass averaging **deletes** the canonical `.ti3` after each snapshot (`snapshot_ti3`) so Stage 4 stays locked until Finish (#109, #110).
|
||
|
||
## `wizardState` fields
|
||
|
||
| Field | Role |
|
||
|-------|------|
|
||
| `currentStage` | 0–5 |
|
||
| `basename` | run name without extension |
|
||
| `cwd` | working directory |
|
||
| `printerName` | last spooled printer (drift history) |
|
||
| `sessionMode` | `"profile"` (extensible) |
|
||
| `profileBasename` | may differ after import |
|
||
| `noticeTimer` | banner auto-hide |
|
||
|
||
`setTarget(basename, cwd)` updates gating. `navigateToStage(n)` refuses locked stages with a warning banner. Window `focus` re-runs `updateGating` (user may have deleted files in Finder/Explorer) (#151).
|
||
|
||
## Resume from existing target (#140)
|
||
|
||
Stage 1 **Open Existing** (`select_existing_target`) filters `.ti1`/`.ti2`. `parse_ti2_header` reads `TARGET_INSTRUMENT`, `NUMBER_OF_SETS`, `NUMBER_OF_PAGES`, sibling `.ti1` presence. If `.ti2` exists, Stage 3 banner shows "Resumed from .ti2".
|
||
|
||
CGATS import (#94, #211) can jump to Stage 4/5 with a synthesised `.ti3` — must use an **open** dialog, never save (#211).
|
||
|
||
## Empty cwd (#59)
|
||
|
||
Never spawn with `cwd: ""`. Initialize from `get_default_working_dir` (Documents → Home → app data). Disable Generate until basename **and** directory are set. Display path in `#selectedPathDisplay`.
|
||
|
||
## Profile extension (#69)
|
||
|
||
`resolve_profile_extension`: if only `.icm` exists, use it; else if `.icc` exists, use it; else default `.icm` on Windows, `.icc` elsewhere. `profcheck` and `iccgamut` also swap extension if the requested path is missing.
|
||
|
||
## No `"test_target"` fallbacks (#60)
|
||
|
||
A rewrite must not invent default basenames. Later stages stay inert until `wizardState.basename` is set from a real artefact.
|
||
|
||
## Project file (#149)
|
||
|
||
A `.icceryproj` is a JSON **index** (`schema_version` 1) over `basename` + `cwd` + optional `media_recipe_id`/`preset_id`/`calibration_url`/`printer_*` + a `last_verification` ΔE₀₀ snapshot. It is never a second source of truth: opening one writes `WizardState` and re-runs the same artefact probe window focus uses — if JSON claims Stage 5 but disk stops at `.ti2`, the stepper follows the disk and the sidebar chip shows `projectChipStale` with an info banner.
|
||
|
||
`wizard_state.json` remains the crash-resume file; there is no auto-save. Recents live in `appDataDir/recent_projects.json` (cap 20, bookmark + path, corrupt → `[]` + keep bytes). `Save Report…` writes `{basename}-report.md` in cwd atomically. A live `CAL_` basename is never persisted — Save resolves the persisted `calibrationOriginalBasename` or refuses with a banner.
|