205 lines
12 KiB
Markdown
205 lines
12 KiB
Markdown
```
|
|
# Step-01A Worker Report
|
|
|
|
## Status
|
|
|
|
**COMPLETE** — implementation, full solution/native builds, regression tests and
|
|
Windows native smoke verification are complete. Manual orchestrator acceptance
|
|
remains pending. Step-02 was not started.
|
|
|
|
## Implemented functionality
|
|
|
|
- Added one Windows-first .NET 10 MAUI Blazor Hybrid executable, `AutoForge.Client`,
|
|
hosting the entire routed application through `BlazorWebView`.
|
|
- Added `AutoForge.UI` and `AutoForge.Components` .NET 10 Razor Component
|
|
Libraries. UI owns the home, target-selection and not-found routes, layout and
|
|
navigation. Components owns the accessible, text-safe, reusable `StatusNotice`.
|
|
- Moved the existing Application target-selection implementation under
|
|
`Features/ExecutionTargets/SelectExecutionTarget` without changing its public
|
|
namespace, explicit-kind validation, typed failures, registration snapshot or
|
|
no-fallback behavior.
|
|
- Composed the existing application registration in Client with an intentionally
|
|
empty production metadata registry. The UI displays `ProviderNotRegistered`;
|
|
it does not fabricate a provider or claim connection, capability or
|
|
authorization.
|
|
- Added headless rendered component/UI tests and actual project-graph assertions.
|
|
The original 35 unit and 19 integration tests remain; the expanded suites have
|
|
39 unit and 26 integration tests (65 total).
|
|
- No vehicle feature, hardware operation, simulation/diagnostics engine, backend,
|
|
database, cloud service, browser/server host or additional application
|
|
executable was introduced.
|
|
|
|
## Projects, files and architectural changes
|
|
|
|
The solution now has seven projects: Core, Application, Components, UI, Client,
|
|
UnitTests and IntegrationTests. The actual production references are:
|
|
|
|
- Client -> UI and Application.
|
|
- UI -> Components and Application.
|
|
- Application -> Core.
|
|
- Components -> no AutoForge project.
|
|
- Core -> no AutoForge project.
|
|
- Tests -> portable production projects as needed; neither test project references
|
|
or launches Client.
|
|
|
|
Client is the only application executable. Application target selection is
|
|
feature-organized at
|
|
`src/AutoForge.Application/Features/ExecutionTargets/SelectExecutionTarget/`.
|
|
Routes and feature presentation are in UI; the reusable status control is in
|
|
Components. The UI calls the real resolver through DI. The design adds no
|
|
mediator, generic repository/manager layer, empty future feature slice or
|
|
speculative service.
|
|
|
|
Added the three projects and Windows platform bootstrap under `src`; updated
|
|
`src/AutoForge.slnx`; added UI routes, pages, view model, layout and RCL styles;
|
|
added the Components status control and its styles; and added component,
|
|
UI/application and project-graph test coverage to the existing test projects.
|
|
The host page now explicitly loads `_content/AutoForge.UI/app.css`, in addition
|
|
to the generated scoped-style bundle. Application source files were moved into
|
|
the feature slice while preserving their namespace and behavior.
|
|
|
|
Removed unused template sample pages/components/JavaScript and non-Windows
|
|
platform scaffolding. Kept the legitimate MAUI/Windows startup, manifest,
|
|
resources and Windows platform entry point. No useful Step-01 application
|
|
behavior or tests were removed.
|
|
|
|
Updated the root README, `docs/README.md`, `docs/architecture.md` and
|
|
`docs/build-and-test.md`. Updated ADR-0001 to retain its historical foundation
|
|
decisions and explicitly supersede only its dual-shell/deferred-host decision.
|
|
Added `docs/adr-0002-single-shell-vsa.md` for the corrected single-shell/RCL/VSA
|
|
decision.
|
|
|
|
## Tests and verification
|
|
|
|
Environment inspection:
|
|
|
|
- Windows `10.0.26200.0`; .NET SDK `10.0.402`; .NET and ASP.NET Core runtime
|
|
`10.0.13`.
|
|
- Windows SDK target `10.0.26100.0`; `maui-windows` workload manifest `10.0.110`
|
|
(`10.0.110/10.0.100` as listed); WebView2 Runtime `155.0.4283.62`.
|
|
- After the workload-restore incident below, `dotnet workload list` reported
|
|
workload version `10.0.403`; installed Android/iOS/MacCatalyst workloads were
|
|
not used as Client targets.
|
|
- Central package versions include MAUI Controls and BlazorWebView.Maui
|
|
`10.0.110`, Components.Web `10.0.13`, DI abstractions `10.0.14`, Test SDK
|
|
`18.11.0`, xUnit `2.9.3` and Visual Studio xUnit runner `4.0.1`. Tests use the
|
|
existing VSTest/xUnit runner.
|
|
|
|
Successful restore/build commands:
|
|
|
|
- `dotnet restore .\src\AutoForge.Client\AutoForge.Client.csproj --runtime win-x64`
|
|
— exit 0; restored the Windows runtime pack.
|
|
- `dotnet restore .\src\AutoForge.slnx` — exit 0; all projects up to date.
|
|
- `dotnet build .\src\AutoForge.slnx --configuration Release --no-restore` —
|
|
exit 0; all seven projects built, 0 warnings, 0 errors.
|
|
- `dotnet build .\src\AutoForge.Client\AutoForge.Client.csproj --configuration Release --framework net10.0-windows10.0.26100.0 --no-restore`
|
|
— exit 0; actual `net10.0-windows10.0.26100.0` / `win-x64` native target,
|
|
0 warnings, 0 errors.
|
|
|
|
Successful test commands and results:
|
|
|
|
- `dotnet test .\src\tests\AutoForge.UnitTests\AutoForge.UnitTests.csproj --configuration Release --no-build`
|
|
— 39 passed, 0 failed, 0 skipped.
|
|
- `dotnet test .\src\tests\AutoForge.IntegrationTests\AutoForge.IntegrationTests.csproj --configuration Release --no-build`
|
|
— 26 passed, 0 failed, 0 skipped.
|
|
- `dotnet test .\src\AutoForge.slnx --configuration Release --no-build`
|
|
— full solution regression command; both test projects ran, 65 passed, 0 failed,
|
|
0 skipped.
|
|
|
|
Unit coverage includes descriptor/resolver regressions and actual rendered status
|
|
component tones and safe text encoding. Integration coverage renders the real
|
|
UI routes with the real Application resolver, including registered synthetic
|
|
metadata, empty/unknown providers, invalid inputs, kind mismatch and unknown
|
|
routes. Project graph tests inspect actual project references. These headless
|
|
tests do not substitute for the following native smoke checks.
|
|
|
|
## Native Windows smoke evidence
|
|
|
|
Launched the built native Client executable from
|
|
`src\AutoForge.Client\bin\Release\net10.0-windows10.0.26100.0\win-x64\AutoForge.Client.exe`
|
|
with an isolated WebView2 profile and temporary local DevTools port. The native
|
|
window title was `AutoForge`; WebView2 exposed the app page at `https://0.0.0.1/`.
|
|
Observed:
|
|
|
|
- The home route rendered the foundation content and navigation. The unhandled
|
|
error banner was hidden (`display: none`).
|
|
- Navigation to `/execution-targets` rendered the explicit empty-provider notice,
|
|
input fields and all three target kinds.
|
|
- Submitting provider identifier `native-smoke-unregistered` with
|
|
`PhysicalHardware` rendered “Provider ... is not registered” with error tone.
|
|
No connection or operation was performed.
|
|
- An unmatched `/native-smoke-unknown` path rendered the explicit “Page not found”
|
|
presentation and navigation.
|
|
- Host `app.css` returned HTTP 200. The generated `AutoForge.UI` and
|
|
`AutoForge.Components` scoped CSS assets both returned HTTP 200 and contained
|
|
their expected UI/status-notice styles.
|
|
- No unhandled error banner appeared during navigation or form submission.
|
|
|
|
The initial native inspection found that the host HTML did not link the UI RCL's
|
|
global `app.css`, which left the template error element visible despite healthy
|
|
startup. Added the explicit RCL static-asset link, rebuilt and repeated the
|
|
native checks above successfully. The native process was stopped and both exact
|
|
temporary WebView2 smoke profiles were removed.
|
|
|
|
## Acceptance criteria evidence
|
|
|
|
| Criterion | Status | Evidence |
|
|
|---|---|---|
|
|
| AC-01 | PASSED | Existing Core/Application behavior, public namespace and all 54 accepted Step-01 test cases retained; expanded suites pass 65 tests. |
|
|
| AC-02 | PASSED | Seven-project solution; only application executable is Windows-first MAUI Blazor Hybrid Client; native Windows TFM build succeeds. |
|
|
| AC-03 | PASSED | BlazorWebView root is UI `Routes`; pages/layout/navigation are in UI, generic status component in Components; native home, selection and not-found routes verified. |
|
|
| AC-04 | PASSED | `ProjectGraphTests` and actual project manifests verify allowed references, no forbidden reverse edges/cycles, no extra application host. |
|
|
| AC-05 | PASSED | Target resolver moved into feature slice; public namespace, typed failures, validation, exact selection and no-fallback regressions pass. |
|
|
| AC-06 | PASSED | 39 headless unit tests and 26 integration tests render real components/routes and exercise actual Application DI; no Client reference required. |
|
|
| AC-07 | PASSED | Full Release solution build and direct Windows Client build: 0 warnings/errors; both test projects and full-solution test command pass. |
|
|
| AC-08 | PASSED | Native app loads both RCL style assets and routes; empty-provider notice and explicit unregistered selection observed without backend/model/vehicle. |
|
|
| AC-09 | PASSED | README, documentation index, architecture, build/test guide, ADR-0001 supersession and ADR-0002 match actual architecture and limitations. |
|
|
| AC-10 | PASSED | This report created; protected assignments/orchestration files preserved; no Step-02, stage, commit or push. |
|
|
|
|
## Failures, deviations and environment side effect
|
|
|
|
- The first Windows solution build needed the runtime-specific `win-x64` restore
|
|
to obtain its MAUI runtime pack (`NETSDK1112`); the explicit restore above
|
|
resolved it.
|
|
- An initial integration restore identified a redundant explicit
|
|
`Microsoft.Extensions.DependencyInjection` package (`NU1510`) because the
|
|
project already uses the ASP.NET Core framework reference. The redundant direct
|
|
package was removed from the integration-test project; restore and tests then
|
|
succeeded. No test assertion was removed.
|
|
- Native smoke identified and fixed the missing global UI stylesheet link as
|
|
described above. All final checks were rerun after the fix.
|
|
- **Unintended environment-level workload action:** during prerequisite
|
|
inspection, `dotnet workload restore .\src\AutoForge.slnx --skip-manifest-update`
|
|
was mistakenly invoked. It began updating workload manifests and was stopped.
|
|
Subsequent `dotnet workload list` output reports workload version `10.0.403`
|
|
and newer iOS/MacCatalyst manifest versions; the required `maui-windows`
|
|
manifest remains `10.0.110`. No rollback was attempted. This changed the local
|
|
tool environment, not repository source/configuration.
|
|
- A first DevTools form probe dispatched only an `input` event and therefore did
|
|
not trigger Blazor's `change` binding. The smoke probe was corrected to dispatch
|
|
the bound change event; explicit submission then produced the expected
|
|
`ProviderNotRegistered` result. No product-code change was needed for that
|
|
harness correction.
|
|
- No required build, test or native check remains blocked or unexecuted.
|
|
|
|
## Documentation, preservation and handoff
|
|
|
|
ADR-0002 records one native shell, two purposeful RCLs and feature-oriented
|
|
application slices. ADR-0001 retains the valid platform-neutral foundation,
|
|
explicit-target and no-fallback decisions; only the former dual-shell and
|
|
deferred-host decision is superseded. README/docs distinguish implemented
|
|
metadata selection from planned vehicle, simulation, diagnostics, AI and
|
|
hardware capabilities.
|
|
|
|
The worktree was already dirty with accepted Step-01 implementation and
|
|
orchestration files. Those changes were preserved; no destructive Git operation,
|
|
staging, commit or push was performed. `prompts/ROADMAP.md`, `prompts/STATE.md`,
|
|
the Step-01 assignment/report, Step-01A assignment, Step-02 assignment and
|
|
instruction files were not edited by this correction. No unrelated dirty files
|
|
were reverted.
|
|
|
|
Implementation and verification are complete for orchestrator review. The
|
|
orchestrator must perform manual acceptance; Step-02 remains held and was not
|
|
executed.
|
|
```
|