Skip to content

Make the packages publishable, and verify them against a real consumer - #74

Merged
74nu5 merged 1 commit into
mainfrom
release/prepare-publication
Jul 19, 2026
Merged

Make the packages publishable, and verify them against a real consumer#74
74nu5 merged 1 commit into
mainfrom
release/prepare-publication

Conversation

@74nu5

@74nu5 74nu5 commented Jul 19, 2026

Copy link
Copy Markdown
Owner

La publication était bloquée par deux vrais défauts. Ils sont corrigés ; les étapes de publication elles-mêmes sont documentées dans RELEASING.md plutôt qu'exécutées — elles demandent des identifiants et sont irréversibles.

Settex.Build ne se construisait pas du tout

Il déclarait les assemblys de tâche dans lib/netstandard2.0 via un ItemGroup simple, dont le $(OutputPath) s'évalue trop tôt — ils atterrissaient en réalité sous contentFiles/. NU5100 faisait alors échouer le build, TreatWarningsAsErrors étant actif.

Les assemblys vont maintenant dans tasks/netstandard2.0 via une cible exécutée au moment du pack. C'est leur place : tout ce qui est dans lib/ devient une référence de compilation pour chaque projet consommateur — ce que NU5100 signalait depuis le début.

Métadonnées de gabarit

PackageProjectUrl et RepositoryUrl pointaient encore vers github.com/yourusername/settex. Et Settex.Cli épinglait sa propre Version 1.0.0 pendant que le reste dérivait 0.1.0-alpha : les trois paquets seraient partis comme s'ils n'avaient aucun rapport. Une seule version pour tous, README embarqué dans chacun, et Settex.LanguageServer marqué non-packable (il vit dans les extensions).

Packer proprement ne prouve rien

Les trois paquets ont donc été testés contre un consommateur jetable sur un flux local :

Vérification Résultat
Bibliothèque neuve + PackageReference Settex.Build génère appsettings.json + delta {"App":{"Name":"Prod"}}
dotnet tool install Settex.Cli s'installe, build et import fonctionnent
import sur la sortie « verified exact »
vsce package VSIX de 2,5 Mo, serveur embarqué

RELEASING.md consigne les commandes vérifiées — dont la section packageSourceMapping indispensable au test sur flux local : sans elle la source locale est silencieusement ignorée et le test semble passer sans rien tester.

🤖 Generated with Claude Code

Publishing was blocked by a package that could not be built and metadata that had
never been filled in. Both are fixed; the publishing steps themselves are
documented in RELEASING.md rather than run, since they take credentials and cannot
be undone.

Settex.Build did not pack at all. It declared the task assemblies into
lib/netstandard2.0 with a plain ItemGroup, whose $(OutputPath) evaluates too early
— they actually landed under contentFiles/ — and NU5100 then failed the build,
because TreatWarningsAsErrors is on. The assemblies now go to tasks/netstandard2.0
through a pack-time target, which is where a task assembly belongs: anything in
lib/ becomes a compile-time reference for every consuming project, which is what
NU5100 was warning about all along. NU5100 and NU5128 are suppressed with that
reasoning written down, and the targets file loads the task from its new home.

Metadata was still the template's: PackageProjectUrl and RepositoryUrl pointed at
github.com/yourusername/settex. Settex.Cli pinned its own Version of 1.0.0 while
everything else derived 0.1.0-alpha, so the three packages would have shipped
looking unrelated; there is one version for all of them now. Every package carries
the README, so its NuGet page is not blank. Settex.LanguageServer is marked not
packable — it ships inside the editor extensions.

Packing cleanly proves nothing about whether a package works, so all three were
tested against a throwaway consumer on a local feed. A fresh class library with a
PackageReference to Settex.Build compiles appsettings.settex into appsettings.json
plus a Production delta of {"App":{"Name":"Prod"}}. The tool installs and both its
commands run, import included, reporting the round trip verified exact. The VS
Code extension packages to a 2.5 MB VSIX with the language server bundled.

RELEASING.md records the verified commands, including the packageSourceMapping
section a local-feed test needs on a machine where mapping is enabled — without it
the local source is silently ignored and the test appears to pass while testing
nothing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@74nu5
74nu5 merged commit dd70285 into main Jul 19, 2026
3 checks passed
@74nu5
74nu5 deleted the release/prepare-publication branch July 19, 2026 22:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant