151 lines
11 KiB
Markdown
151 lines
11 KiB
Markdown
---
|
|
gsd_state_version: 1.0
|
|
milestone: v1.1
|
|
milestone_name: Hardening & Validation
|
|
current_plan: 3
|
|
status: verifying
|
|
stopped_at: Completed 12-i18n-bugfixes/12-02-PLAN.md
|
|
last_updated: "2026-04-15T14:16:32.471Z"
|
|
last_activity: 2026-04-15
|
|
progress:
|
|
total_phases: 5
|
|
completed_phases: 5
|
|
total_plans: 20
|
|
completed_plans: 20
|
|
---
|
|
|
|
---
|
|
gsd_state_version: 1.0
|
|
milestone: v1.1
|
|
milestone_name: Hardening & Validation
|
|
current_plan: 3
|
|
status: Phase complete — ready for verification
|
|
stopped_at: Completed 11-ui-enhancements/11-04-PLAN.md
|
|
last_updated: "2026-04-15T13:08:42.940Z"
|
|
last_activity: 2026-04-15
|
|
progress:
|
|
total_phases: 4
|
|
completed_phases: 4
|
|
total_plans: 18
|
|
completed_plans: 18
|
|
---
|
|
|
|
---
|
|
gsd_state_version: 1.0
|
|
milestone: v1.1
|
|
milestone_name: Hardening & Validation
|
|
current_plan: 3
|
|
status: Phase complete — ready for verification
|
|
stopped_at: Completed 11-ui-enhancements/11-01-PLAN.md
|
|
last_updated: "2026-04-15T09:04:38.757Z"
|
|
last_activity: 2026-04-15
|
|
progress:
|
|
total_phases: 4
|
|
completed_phases: 3
|
|
total_plans: 18
|
|
completed_plans: 15
|
|
---
|
|
|
|
# Project State
|
|
|
|
## Project Reference
|
|
|
|
See: .planning/PROJECT.md (updated 2026-04-13 after v1.0 milestone)
|
|
|
|
**Core value:** Generate a complete, working printer deployment package (script + drivers + icon) in minutes instead of manually scripting each printer setup.
|
|
**Current focus:** v1.1 Hardening & Validation — Phase 9 (UX Tech Debt Closure)
|
|
|
|
## Current Position
|
|
|
|
Milestone: v1.1 Hardening & Validation
|
|
Phase: 09 — UX Tech Debt Closure — ACTIVE (1/3 plans complete)
|
|
Current Plan: 3
|
|
Total Plans in Phase: 3
|
|
Status: Phase 09 active — 09-01 complete (UX-01: driver upload 500 fixed + HTMX OOB refresh wired)
|
|
Decision: 09-01 delivered caller-aware upload handler, driver_upload_with_oob.html template, inline upload form in printer_form.html, and 5 new integration tests (500 regression x2, OOB contract x3).
|
|
Last activity: 2026-04-15
|
|
|
|
## Milestone History
|
|
|
|
- **v1.0** — ImpTune MVP (shipped 2026-04-13) — see [MILESTONES.md](MILESTONES.md)
|
|
|
|
## Accumulated Context
|
|
|
|
### v1.1 Phase Structure
|
|
|
|
- Phase 8: Nyquist Validation Track (NYQ-01..03) — parallelizable audit track
|
|
- Phase 9: UX Tech Debt Closure (UX-01..03) — must land before rollout
|
|
- Phase 10: Real-World Runtime Validation (RTVAL-01..05) — must pass before rollout
|
|
- Phase 11: UI Enhancements (UIE-01..05) — printer edit, separated form/list, client nav, theme toggle, i18n FR/EN
|
|
- Phase 12: i18n bugfixes — full translation coverage + browser language auto-detection
|
|
|
|
### Roadmap Evolution
|
|
|
|
- Phase 12 added: i18n bugfixes — untranslated buttons/labels found post-Phase 11; browser language setting not honoured
|
|
|
|
### Open Concerns (now owned by v1.1 phases)
|
|
|
|
- Real-world Intune tenant .intunewin acceptance → Phase 10 (RTVAL-01)
|
|
- `pnputil` + `$PSScriptRoot` under SYSTEM → Phase 10 (RTVAL-02..04)
|
|
- Driver dropdown refresh after upload → Phase 9 (UX-01)
|
|
- PRNT-03 Alpine.js port auto-derivation live verification → Phase 9 (UX-02)
|
|
- Individual script download links on printer detail page → Phase 9 (UX-03)
|
|
- Nyquist-compliant VALIDATION.md across v1.0 phases → Phase 8 (NYQ-01..03)
|
|
|
|
### Decisions
|
|
|
|
- **Phase ordering:** RTVAL before RWR (cannot deploy unvalidated runtime); UX before RWR (deployed build must be polished); NYQ parallel to all (pure audit, no code dependency) — placed first so v1.0 validation evidence is fresh before runtime work begins.
|
|
- **RTVAL grouping:** RTVAL-01..05 combined into single Phase 10 because they share setup (same tenant, same test endpoint, same RUNTIME-VALIDATION.md report).
|
|
- **NYQ as dedicated phase:** Kept standalone (not absorbed) because it audits all 7 v1.0 phases and its evidence feeds defect triage into Phases 9/10.
|
|
|
|
Full decision log in PROJECT.md Key Decisions table. Milestone v1.0 decisions archived in `milestones/v1.0-ROADMAP.md`.
|
|
- [Phase 09-ux-tech-debt-closure]: 09-03: .ps1 routes added as aliases (not renames) to preserve backward compatibility
|
|
- [Phase 09-ux-tech-debt-closure]: 09-03: Shared _*_response() helper pattern used for route aliases
|
|
- [Phase 09]: Sentinel field (caller=printer_form) for OOB branching: chosen over HX-Target header for clarity and testability
|
|
- [Phase 09]: HTMX OOB template includes primary fragment + OOB select sibling in driver_upload_with_oob.html
|
|
- [Phase 09-ux-tech-debt-closure]: 09-02: /printers route used for e2e test (full-page with Alpine.js) — no new /printers/new route needed
|
|
- [Phase 09-ux-tech-debt-closure]: 09-02: conftest.py adapted — imptune.config uses string paths, init_db() takes no args
|
|
- [Phase 10-real-world-runtime-validation]: 10-01: Package under test is Ricoh PCL6 Universal Print (Copieur_2eme.intunewin), ImpTune commit 1c3f458, committed to evidence/ for traceability
|
|
- [Phase 10-real-world-runtime-validation]: 10-01: Commit SHA locked before runtime testing — all RTVAL results reference this exact build
|
|
- [Phase 10-real-world-runtime-validation]: 10-02: RTVAL-01 FAIL — Stop plan 10-02; surface .intunewin structure defect as gap; use /gsd:debug on generator or /gsd:plan-phase 10 --gaps before retesting
|
|
- [Phase 10-real-world-runtime-validation]: 10-02: RTVAL-01 PASS on re-test (2026-04-13) — ISSUE-01 resolved by commits 74535ea (HMAC over IV+ciphertext) and 7716246 (Detection.xml alignment with IntuneWinAppUtil.exe reference format); plan resumed at Task 2
|
|
- [Phase 10-real-world-runtime-validation]: 10-02: RTVAL-02 accepted as attestation-only PASS (2026-04-13) — technician verbally confirmed install succeeded on ARES-5CG5220YTM but did NOT provide IntuneManagementExtension.log excerpt or portal screenshot; user explicitly approved "Pass without evidence"; audit trail weakened for this check and flagged in RUNTIME-VALIDATION.md Notes
|
|
- [Phase 10-real-world-runtime-validation]: 10-02: RTVAL-03 accepted as attestation-only PASS (2026-04-13) — second consecutive attestation-only check; no rtval-03-detection.png and no rtval-03-detect-manual.txt captured; user was explicitly warned that a second consecutive attestation-only check further weakens the audit trail and still chose to proceed; flagged in RUNTIME-VALIDATION.md Notes as soft PASS requiring re-run with full artifact capture before phase sign-off
|
|
- [Phase 10-real-world-runtime-validation]: 10-02: RTVAL-04 accepted as attestation-only PASS (2026-04-13) — **third consecutive attestation-only check**; no rtval-04-uninstall-log.txt and no rtval-04-uninstall-status.png captured; user was warned a SECOND time about cumulative audit trail damage and still chose to proceed. Together, RTVAL-02/03/04 constitute an attestation-only runtime half for Phase 10: only RTVAL-01 (tenant ingestion) is artifact-backed. Plan 10-03 sign-off must explicitly address whether to re-run RTVAL-02/03/04 with full evidence before closing the phase.
|
|
- [Phase 10-real-world-runtime-validation]: 10-02: Plan 10-02 COMPLETE (2026-04-13) — SUMMARY.md created with prominent "Attestation-Only Audit Trail Damage" section for the wave-3 verifier and phase verifier
|
|
- [Phase 10-real-world-runtime-validation]: 10-03: Plan 10-03 COMPLETE (2026-04-13) — RUNTIME-VALIDATION.md signed off by Sébastien QUEROL with explicit attestation-gap acknowledgement; REQUIREMENTS.md RTVAL-01..05 ticked (idempotent, already landed in 10-02 commit 206648c); ROADMAP.md Phase 10 flipped to 3/3 Complete 2026-04-13. Phase 10 officially closed.
|
|
- [Phase 08-nyquist-validation-track]: 08-01: Phase 1 Nyquist Record complete with 14/14 pass rows; row 14 (upload-to-real-Intune spike) resolved PASS citing Phase 10 RTVAL-01 sign-off rather than fail-fix-v1.1
|
|
- [Phase 08-nyquist-validation-track]: 08-02: Phase 2 Nyquist Record complete with 6/6 pass rows; POST /drivers/upload 500 historical gap (row 6) closed as pass citing Phase 9 UX-01 fixing commits d1de839 + 10ee09a + 72c6a98
|
|
- [Phase 08-nyquist-validation-track]: 08-03: Phase 3 Nyquist Record complete with 10/10 pass rows; PRNT-03 Alpine.js IP->port historical gap (row 3) closed as pass citing Phase 9 UX-02 Playwright fixing commits 322fc20 + 37a06da
|
|
- [Phase 08-nyquist-validation-track]: 08-04: Phase 4 Nyquist Record complete with 5/5 pass rows; SYSTEM-context rows (SCRPT-01/02/03/04/05) cite Phase 10 RTVAL-02/03/04 with explicit attestation-only caveat per STATE.md 2026-04-13 faithfully recorded in Notes
|
|
- [Phase 08-nyquist-validation-track]: 08-05: Phase 5 Nyquist Record complete with 5/5 pass rows; PKG-02 row is the ONLY artifact-backed live-tenant runtime row in the 7-phase audit track (cites RTVAL-01 PASS on rubis.fr + fix commits 74535ea/7716246); PKG-04 icon-embedding historical gap closed in place via Phase 6 TestIntunewinIconInclusion
|
|
- [Phase 08-nyquist-validation-track]: 08-06: Phase 6 Nyquist Record complete with 1/1 pass row (PKG-04 icon embedding); shortest audit in track reflecting single-criterion gap-closure structure; bidirectional citation loop with 05-VALIDATION row 4; RTVAL-01 cited as supporting transitive runtime evidence
|
|
- [Phase 08-nyquist-validation-track]: 08-07: Phase 7 Nyquist Record complete with 4/4 pass (3 in-scope rows anchored to 07-VERIFICATION.md truths since Phase 7 has zero REQUIREMENTS.md IDs, plus 1 UX-03 carry-over row closed via Phase 9 / 09-03); per-phase NYQ-01 coverage complete across all 7 v1.0 phases (45 audit rows total, 0 roll-forward)
|
|
- [Phase 08-nyquist-validation-track]: 08-08: v1.0-VALIDATION-INDEX.md signed off 2026-04-13 by Sébastien QUEROL; 45/45 pass across 7 phases, 0 fail-fix-v1.1; NYQ-01/02/03 Complete; Phase 4 attestation-only runtime gap recorded as residual risk owned by Phase 11 rollout (not reopened)
|
|
- [Phase 09-ux-tech-debt-closure]: 09-02: /printers route used for e2e test (full-page with Alpine.js) — no new /printers/new route needed
|
|
- [Phase 09-ux-tech-debt-closure]: 09-02: conftest.py adapted — imptune.config uses string paths, init_db() takes no args
|
|
- [Phase 11-ui-enhancements]: 11-01: Plain HTML form in printers_new.html (Option A) — no hx-post, uses action=/printers method=post so browser follows 303 redirect naturally
|
|
- [Phase 11-ui-enhancements]: 11-01: driver_data context kept in GET /printers handler for future Plan 02 edit modal
|
|
- [Phase 11-ui-enhancements]: 11-04: client_id extracted from printers[0].client_id in Jinja2 — no grouped structure change needed
|
|
- [Phase 11-ui-enhancements]: 11-04: Unassigned group header plain text — group_client_id is None when client_id absent; no dead anchor
|
|
- [Phase 12-i18n-bugfixes]: IIFE pattern chosen for Alpine store lang init — evaluates at store creation time (inside alpine:init), before any hydration
|
|
- [Phase 12-i18n-bugfixes]: playwright browser.new_context(locale=...) used for navigator.language tests — isolates locale per test without global fixture contamination
|
|
- [Phase 12-i18n-bugfixes]: Span-wrapper pattern for label text: <label><span x-text>Label</span><input></label> since x-text replaces all child nodes
|
|
- [Phase 12-i18n-bugfixes]: Span-wrapper pattern for label text: <label><span x-text>Label</span><input></label> since x-text replaces all child nodes
|
|
|
|
### Active Blockers
|
|
|
|
None. BLOCKER-01 resolved 2026-04-13 via commits 74535ea (HMAC over IV+ciphertext) and 7716246 (Detection.xml aligned with IntuneWinAppUtil.exe reference format); RTVAL-01 re-tested PASS on fixed build.
|
|
|
|
### Pending Todos
|
|
|
|
- Run `/gsd:plan-phase 8` to draft plans for Nyquist Validation Track
|
|
- Schedule real Intune tenant + test endpoint access for Phase 10
|
|
- Run `/gsd:plan-phase 11` to draft plans for UI Enhancements (printer edit, form/list separation, client nav, theme, i18n)
|
|
|
|
## Session Continuity
|
|
|
|
Last session: 2026-04-15T14:13:39.425Z
|
|
Stopped at: Completed 12-i18n-bugfixes/12-02-PLAN.md
|
|
Resume file: None
|