114 lines
6.0 KiB
Markdown
114 lines
6.0 KiB
Markdown
# Build and test
|
|
|
|
## Prerequisites
|
|
|
|
- Windows x64, .NET SDK 10.0.402 with its approved .NET 10 patch roll-forward.
|
|
- Windows SDK target 10.0.26100.0 and MAUI Windows workload manifest 10.0.110.
|
|
- Microsoft Edge WebView2 Runtime to launch the native Blazor Hybrid Client.
|
|
|
|
Step-02/Step-02A verification used .NET runtime 10.0.13, workload version
|
|
10.0.403 as listed by the installed SDK, and WebView2 Runtime 155.0.4283.62. The Client
|
|
targets `net10.0-windows10.0.26100.0` and `win-x64`. Core, Application, UI,
|
|
Components and both test projects target portable `net10.0`; unit/integration
|
|
tests do not require MAUI or WebView2.
|
|
|
|
## Restore, build and launch
|
|
|
|
From the repository root in PowerShell:
|
|
|
|
```powershell
|
|
dotnet restore .\src\AutoForge.slnx
|
|
dotnet build .\src\AutoForge.slnx --configuration Release --no-restore
|
|
dotnet test .\src\AutoForge.slnx --configuration Release --no-build
|
|
dotnet run --project .\src\AutoForge.Client\AutoForge.Client.csproj --configuration Release --framework net10.0-windows10.0.26100.0
|
|
```
|
|
|
|
For an explicit Windows runtime pack restore or a direct native build:
|
|
|
|
```powershell
|
|
dotnet restore .\src\AutoForge.Client\AutoForge.Client.csproj --runtime win-x64
|
|
dotnet build .\src\AutoForge.Client\AutoForge.Client.csproj --configuration Release --framework net10.0-windows10.0.26100.0 --no-restore
|
|
```
|
|
|
|
The Client is a native MAUI window containing the actual `AutoForge.UI` routes in
|
|
a BlazorWebView. Profiles are imported explicitly into an in-memory catalog for
|
|
the current Client process. No automotive driver, actual vehicle, database,
|
|
backend, model or cloud account is required.
|
|
|
|
## Automated verification
|
|
|
|
Run focused suites while developing:
|
|
|
|
```powershell
|
|
dotnet test .\src\tests\AutoForge.UnitTests\AutoForge.UnitTests.csproj --configuration Release
|
|
dotnet test .\src\tests\AutoForge.IntegrationTests\AutoForge.IntegrationTests.csproj --configuration Release
|
|
```
|
|
|
|
The unit suite covers existing Core/Application behavior, rendered generic
|
|
components, profile invariants and strict codec behavior. The integration suite
|
|
loads source-controlled synthetic fixtures through the real DI service/catalog,
|
|
selects exact revisions, verifies semantic JSON round-trip and atomic failure,
|
|
retains target-selection behavior, and renders the real profile UI. The
|
|
project-graph test continues to enforce the seven-project reference boundaries.
|
|
Fixtures are copied from `src/tests/AutoForge.IntegrationTests/Fixtures` and are
|
|
never treated as real vehicle definitions.
|
|
|
|
Step-02 worker verification covered 59 unit and 34 integration cases (93 total).
|
|
Those historical runs did not include the two defects later assigned to Step-02A.
|
|
Step-02A added focused pre-fix reproductions, then verified the corrected
|
|
timestamp and applicability paths along with the full regression suites: 103
|
|
unit and 37 integration tests passed (140 total, zero failed/skipped). The
|
|
seven-project Release build completed with zero warnings/errors. See the
|
|
[Step-02 report](../prompts/Step-02-Report.md) for the original evidence and the
|
|
[Step-02A report](../prompts/Step-02A-Report.md) for exact corrective commands
|
|
and separate native observations. Manual orchestrator acceptance remains pending.
|
|
|
|
## Native profile smoke procedure
|
|
|
|
Run the actual Windows Client and open `/vehicle-profiles`:
|
|
|
|
1. Paste `synthetic-truck-baseline.json` from the integration-test `Fixtures`
|
|
folder and import it. Confirm the revision appears but is not auto-selected.
|
|
2. Select revision 1. Inspect module identities, the five declared capability
|
|
states, `null`/unknown values, SYNTHETIC provenance and limitations. Export
|
|
the selected revision and verify schema version/identity remain intact.
|
|
3. Paste/import `synthetic-truck-variant.json`; select revision 2 explicitly and
|
|
verify its calibration identity differs while revision 1 remains unchanged.
|
|
4. Attempt duplicate import and malformed JSON; observe an error, unchanged
|
|
catalog and unchanged selected profile.
|
|
5. Verify the alternate vehicle/custom role fixture can be imported and selected.
|
|
6. Confirm `/`, `/execution-targets` and an unmatched route still work, and that
|
|
profile import/selection did not create or alter execution-target providers.
|
|
7. Verify a complete timestamp with `Z` or a signed offset imports and round-trips;
|
|
a time-only timestamp shows its exact evidence JSON path and is not registered.
|
|
8. Verify module-scoped evidence with null hardware/software/firmware/calibration
|
|
constraints stays null after export even when the module identities are known.
|
|
A supplied conflicting identity must show an error without replacing the
|
|
catalog entry or selected profile.
|
|
|
|
Native route/interaction evidence is distinct from headless rendered tests.
|
|
Worker evidence records the launch method and actual observed outcomes in the
|
|
Step-02 and Step-02A reports.
|
|
|
|
## Schema and safety boundaries
|
|
|
|
See the [schema-v1 guide](vehicle-profile-schema-v1.md) for all field, identity,
|
|
unknown-value, capability, provenance and strict JSON rules. In brief:
|
|
|
|
- Every v1 field is required; unknown optional facts are explicit JSON `null`.
|
|
Unknown fields and duplicate/case-ambiguous properties are rejected.
|
|
- Catalog selection requires exact `(profileIdentifier, revision)`. Duplicate
|
|
imports do not replace entries, and failed parsing cannot partially register.
|
|
- `publishedAt`/`retrievedAt` accept null or complete
|
|
`YYYY-MM-DDTHH:mm:ss[.fraction](Z|+HH:mm|-HH:mm)` timestamps only. The exact
|
|
fractional and offset limits and no-default policy are in the schema guide.
|
|
- A null optional module identity in evidence is an absent constraint. Any
|
|
supplied identity must match a known module value; an unknown target or
|
|
mismatch is rejected without identity inference.
|
|
- Imported profiles and capability/provenance statements are immutable metadata,
|
|
not connection, compatibility, a working service or authorization.
|
|
- Data remains in memory for the process only. JSON import/export does not write
|
|
files or timestamps implicitly.
|
|
- There is no simulation engine, diagnostic transport, calibration data editor,
|
|
firmware image, operation executor, AI, persistent store or hardware adapter.
|