Novolis Docs
novolis-governance / completed-plans/platform_slnx_root_45730897.plan.md

Fix Novolis.Platform.slnx root vs governance/build

Policies that keep the org coherent

dotnetgovernancenovolis

name: Platform slnx root overview: Make d:\novolis\Novolis.Platform.slnx the canonical open/build entry point (paths already assume workspace root), rewrite the checked-in governance copy so it also resolves, and retarget docs/scripts that still point at the broken build-folder path. todos:

  • id: gen-rewrite-copy

content: Update Generate-Platform-Slnx.ps1 to rewrite ..\..\ paths when copying to governance/build status: completed

  • id: coverage-prefer-root

content: Prefer root slnx in Coverage.ps1; resolve paths relative to slnx directory status: completed

  • id: docs-rules-skill

content: Retarget nuget-only rule, project-ref skill, platform-project-ref-mode.md, README-Platform-Solution.md to root path status: completed

  • id: regen-verify

content: Regenerate both slnx files and verify project paths resolve from root and build copy status: completed isProject: false

Diagnosis

There are two identical files (same SHA256):

`Generate-Platform-Slnx.ps1` writes project paths relative to the workspace root (novolis-agent\src\...), then copies that file unchanged into novolis-governance\build\. Dotnet/VS resolve those paths against the solution directory, so from build\ they look for d:\novolis\novolis-governance\build\novolis-agent\... (missing). Confirmed: that path does not exist; the root-relative path does.

SolutionName == Novolis.Platform (ProjectReference mode) still works from either filename; location is the bug, not mode.

The root file is outside any git repo; the governance copy is the checked-in inventory (git ls-files build/Novolis.Platform.slnx). Docs/skills still tell people to open/build the governance path (`nuget-only-dependencies.mdc`, `novolis-project-ref-mode` skill, `platform-project-ref-mode.md`, `README-Platform-Solution.md`).

flowchart LR
  gen[Generate-Platform-Slnx.ps1]
  root["d:/novolis/Novolis.Platform.slnx"]
  gov["governance/build/Novolis.Platform.slnx"]
  gen -->|"paths: novolis-*/..."| root
  gen -->|"identical copy today"| gov
  root -->|"resolves"| projects[Sibling repos]
  gov -->|"broken resolve"| missing["build/novolis-*/..."]

Chosen approach

  1. Canonical daily path: d:\novolis\Novolis.Platform.slnx (matches your “want it in root” preference; generator already defaults here).
  2. Keep a checked-in copy under governance for regen commits, but when copying, rewrite each Project Path= to ..\..\... so that file is also buildable from build\.
  3. Retarget agent rules, skill, coverage resolver, and platform docs to prefer/document the root path.

Implementation

Generator

In `Generate-Platform-Slnx.ps1` (copy block ~279–284):

  • Write root file unchanged (workspace-relative paths).
  • When copying to $scriptDir\Novolis.Platform.slnx, transform every project path to be relative to novolis-governance\build (prefix ..\..\).
  • Keep PackageToProject map generation as today (unaffected).

Coverage / scripts

In `Coverage.ps1` Get-NovolisPlatformSlnxPath:

  • Prefer root Novolis.Platform.slnx, fall back to governance copy.
  • Resolve project paths with [IO.Path]::GetFullPath((Join-Path $slnxDir $rel)) so both path styles work; drop the special-case “always join to workspace root” hack once the build copy uses ..\..\.

Update `get-coverage-report.ps1` help text default from “governance/build copy” to workspace root.

Docs / agent surfaces (high-signal only)

Point open/build commands at d:\novolis\Novolis.Platform.slnx:

Light touch on READMEs that hardcode the wrong absolute path (e.g. civics / GeoPolity / ChannelLab) if encountered while editing; no mass dogfooding README sweep.

Verify (after implementation)

dotnet sln d:\novolis\Novolis.Platform.slnx list
# spot-check a project resolves from both locations after regen:
Test-Path d:\novolis\novolis-agent\src\Novolis.Agent.Core\Novolis.Agent.Core.csproj
pwsh -File d:\novolis\novolis-governance\build\Generate-Platform-Slnx.ps1
# then confirm governance paths start with ..\..\
dotnet build d:\novolis\Novolis.Platform.slnx --no-restore  # or restore+build smoke if needed

Full platform build may still fail for unrelated project issues; success criterion is solution load / project path resolution from root (and from the rewritten governance copy).