Skip to content

Spec: add dotnet tool packaging plan (mdv pattern), file v0.5 four-terminal checklist - #24

Merged
tig merged 2 commits into
mainfrom
dotnet-tool-spec
May 5, 2026
Merged

Spec: add dotnet tool packaging plan (mdv pattern), file v0.5 four-terminal checklist#24
tig merged 2 commits into
mainfrom
dotnet-tool-spec

Conversation

@tig

@tig tig commented May 5, 2026

Copy link
Copy Markdown
Member

Doc-only PR. Two threads:

1. Four-terminal manual matrix release-checklist issue

Filed as #23 — tracks the first v0.5 pass through the §6.5 matrix (macOS Terminal, iTerm2, Windows Terminal, GNOME Terminal × text/pick-file/md/theme/mouse/inline-restore). Spec §6.5 now points at it.

2. dotnet tool packaging plan

Adopts the mdv pattern: single csproj, PackAsTool=true, PackageId=Terminal.Gui.clet, ToolCommandName=clet. No separate Clet.Tool project (the spec previously hand-waved at one that was never created).

  • §5.4 rewritten with concrete packaging steps and exact dotnet pack / dotnet tool install commands.
  • §7 v0.5 row gains dotnet tool install -g Terminal.Gui.clet packs and installs locally as an exit criterion.
  • §10 Implementation Order picks it up as step 10 — the next work item, before publish channels.
  • D-019 records the decision and the mdv reference.
  • README install snippet and FAQ updated to Terminal.Gui.clet.

Doc-update gate

  • Spec §5.4, §6.5, §7, §10 — all updated in this PR.
  • D-019 — added; spec §5.4 + README synced as required by the gate.
  • README install commands match the spec's package id.
  • No runbook impact.
  • No bar-raise items resolved (this opens a new work item rather than closing a queued critique).

Test plan

  • git diff reviewed; doc-only, no code changes
  • D-019 references match §5.4 wording (package id, tool command, mdv reference)
  • README install commands match spec §5.4
  • Issue Release checklist: v0.5 four-terminal manual matrix #23 created and linked from §6.5
  • Reviewer sanity-check: confirm Terminal.Gui.clet is the desired NuGet package id (the alternative is plain clet — but Terminal.Gui.clet namespaces it under gui-cs, matching mdv's Terminal.Gui.mdv).

🤖 Generated with Claude Code

tig and others added 2 commits May 5, 2026 14:59
§5.4 ".NET tool (NuGet)" now describes the concrete packaging steps:
single-csproj `PackAsTool` with `PackageId=Terminal.Gui.clet` and
`ToolCommandName=clet`, exact `dotnet pack` / `dotnet tool install`
commands, and the relationship to the AOT artifact (separate, same csproj).

§7 v0.5 row gains "dotnet tool install -g Terminal.Gui.clet packs and
installs locally" as an exit criterion. §10 Implementation Order picks
this up as the next work item (step 10), before the publish channels.

D-019 records the decision and explains why a separate `Clet.Tool`
project is unnecessary — mdv has already proven single-csproj works.

README install snippet updated to `dotnet tool install -g Terminal.Gui.clet`
to match the spec; FAQ ".NET required?" line updated likewise.

§6.5 four-terminal matrix now references release-checklist issue #23,
which captures the first v0.5 pass.

No code changes; this PR is doc-only and queues the implementation.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@tig
tig merged commit f47b171 into main May 5, 2026
2 checks passed
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