Skip to content

fix(cli): report unresolved model references cleanly#1680

Merged
Aaronontheweb merged 1 commit into
devfrom
fix/1676-model-reference-diagnostics
Jul 16, 2026
Merged

fix(cli): report unresolved model references cleanly#1680
Aaronontheweb merged 1 commit into
devfrom
fix/1676-model-reference-diagnostics

Conversation

@Aaronontheweb

Copy link
Copy Markdown
Collaborator

Summary

  • promote the existing model-configuration exception into Netclaw.Configuration so resolver and migration failures share one expected error contract
  • surface unresolved named-role references from netclaw model list with manual repair guidance instead of a generic parse error and incorrect autofix direction
  • convert context-window resolution failures into doctor error results so doctor, JSON output, and doctor --fix exit cleanly instead of aborting
  • add unit and native real-binary regression coverage, and synchronize the CLI contract plus netclaw-operations guidance

Closes #1676.

Verification

  • dotnet test src/Netclaw.Configuration.Tests/Netclaw.Configuration.Tests.csproj --no-restore --filter FullyQualifiedName~NamedModelConfigurationTests
  • dotnet test src/Netclaw.Cli.Tests/Netclaw.Cli.Tests.csproj --no-restore --filter "FullyQualifiedName~ModelCommandTests|FullyQualifiedName~ContextWindowDoctorCheckTests"
  • dotnet test Netclaw.slnx --no-restore
  • ./scripts/smoke/run-smoke.sh doctor — 7 passed, 0 failed
  • dotnet slopwatch analyze — 0 issues
  • pwsh ./scripts/Add-FileHeaders.ps1 -Verify
  • bash -n tests/smoke/scenarios/doctor.sh
  • git diff --check

Environment limitations

  • ./evals/run-evals.sh was attempted, but this environment does not provide NETCLAW_EVAL_PROVIDER_TYPE, NETCLAW_EVAL_PROVIDER_ENDPOINT, or NETCLAW_EVAL_MODEL_ID.
  • CRAP reporting was reviewed but cannot run because this repository has no coverage.runsettings or ReportGenerator tool configured.

@Aaronontheweb Aaronontheweb added tui Terminal UI (Termina) issues config Configuration issues, netclaw doctor, schema validation. bug Something isn't working labels Jul 16, 2026
@Aaronontheweb
Aaronontheweb marked this pull request as ready for review July 16, 2026 17:09

@Aaronontheweb Aaronontheweb left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Aaronontheweb
Aaronontheweb enabled auto-merge (squash) July 16, 2026 17:10
@Aaronontheweb
Aaronontheweb merged commit 9618fbc into dev Jul 16, 2026
21 checks passed
@Aaronontheweb
Aaronontheweb deleted the fix/1676-model-reference-diagnostics branch July 16, 2026 17:22
Aaronontheweb added a commit that referenced this pull request Jul 18, 2026
….0-alpha.onnx.8 (#1695)

* release: prepare 0.25.0-beta.5 (#1666)

* fix(daemon): bound the daemon-stop session drain and give CLI stop kill headroom (#1673)

Two related shutdown-race defects:

1. The SIGTERM/daemon-stop CoordinatedShutdown drain task called
   SessionDrainHelper.DrainAsync with CancellationToken.None for the
   operation token, so a session parked on interactive tool approval
   (which can never ack) hung the call for the full 200s Akka
   before-service-unbind phase timeout, leaking the abandoned drain
   task. Fixed by bounding the drain with a TimeProvider-driven CTS
   sized to DaemonConfig.BoundedDrainTimeout (GracefulShutdownBudget
   minus a 10s safety margin), so it always finishes before the phase
   timeout fires. The drain's existing timeout logging now also lists
   which sessions didn't drain.

2. `netclaw daemon stop` waited only 10s before force-killing, and
   even after fixing that to match the daemon's own 200s phase
   timeout, the CLI and daemon would race exactly at the boundary
   (production evidence: a daemon force-killed ~100ms from a clean
   exit). Fixed by giving the CLI a 15s grace window to poll for exit
   after its budget elapses before escalating to SIGKILL, and adding
   TimeoutStopSec= to the generated systemd unit so systemd itself
   can't SIGKILL the cgroup out from under a still-waiting
   `netclaw daemon stop` (ExecStop=).

All the shutdown-timing constants now live in one place
(DaemonConfig.GracefulShutdownBudget and friends) so the layering
(bounded drain < Akka phase timeout < CLI budget+grace <
systemd TimeoutStopSec) can't drift out of lockstep again.

Fixes #1664, #1665

* fix(cli): reject numeric model modalities (#1677)

* fix(cli): handle model migration errors without crashing (#1678)

* fix(cli): handle model migration validation errors

* test(configuration): use non-resetting path joins

* fix(cli): report unresolved model references cleanly (#1680)

* chore(deps): bump actions/setup-dotnet from 5 to 6 (#1684)

Bumps [actions/setup-dotnet](https://github.com/actions/setup-dotnet) from 5 to 6.
- [Release notes](https://github.com/actions/setup-dotnet/releases)
- [Commits](actions/setup-dotnet@v5...v6)

---
updated-dependencies:
- dependency-name: actions/setup-dotnet
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* test(tools): remove obsolete shell timeout race (#1688)

* Fix authoritative attachment path guidance (#1686)

* fix(channels): clarify authoritative attachment paths

* chore: remove unnecessary openspec artifacts

* test(evals): cover authoritative attachment paths

* test(evals): stage attachment path fixture

* test(sessions): register session pipeline in shared fixture (#1690)

* test(sessions): make tool result assertion deterministic

* test(sessions): restore tool result regression coverage

* fix(approvals): show MCP arguments in prompts (#1689)

* fix(approvals): show MCP arguments in prompts

* fix(approvals): harden MCP invocation previews

* feat(install): automate shell PATH integration (#1687)

* feat(install): automate shell PATH integration for Unix installers

Replace manual PATH instructions with automatic shell profile modification.
The installer now detects the user's shell and writes a self-guarding env
script (~/.netclaw/env) that is sourced from the appropriate RC file.

Key changes:
- Add --skip-shell flag to opt out of automatic shell modification
- Detect shell via $SHELL (bash, zsh, fish supported; others get manual instructions)
- Write ~/.netclaw/env with colon-affixed case guard (rustup/fzf pattern)
- Append source line to correct RC: ~/.bashrc (Linux), ~/.profile (macOS bash),
  ~/.zshrc (zsh with ZDOTDIR support), ~/.config/fish/conf.d/netclaw.fish (fish)
- Duplicate prevention: grep -xF guard before appending to RC
- RC file validated with bash -n after modification

Smoke tests (section 9):
- Separate tests for bash-linux, zsh, and fish RC modification
- --skip-shell flag: verify no RC/env file created
- Unknown shell: verify graceful fallback message
- ZDOTDIR: verify zsh respects ZDOTDIR for RC location
- Duplicate prevention: second install adds no extra source lines

* feat(install): automate PATH modification for Windows installer

Replace manual PATH instructions with automatic User-scope PATH modification.
The installer now prepends the install dir to the User PATH and broadcasts
WM_SETTINGCHANGE to Explorer so new terminal windows pick up the change.

Key changes:
- Add -SkipShell switch to opt out of automatic PATH modification
- Read User-scope PATH (not merged $env:PATH) to avoid Machine entry corruption
- Prepend install dir to User PATH (highest priority)
- Update current session's $env:PATH
- Broadcast WM_SETTINGCHANGE via P/Invoke SendMessageTimeout
- Guard against duplicates: normalize trailing backslash before comparison
- Check 32K character limit before writing, warn if near limit

Smoke tests:
- PATH automation logic: duplicate detection with fake PATH strings
- Trailing backslash normalization
- Null User PATH handled as empty
- -SkipShell flag: verify install completes with skipped message

* fix(smoke): isolate real install test to temp HOME

The real install test now uses a temp HOME directory so shell integration
writes to the temp dir instead of the CI runner's real profile. This also
lets us verify the env script was created and the RC file was modified.

Adds 2 new assertions: env script exists, RC file sources env script.

* fix(smoke): cross-platform install smoke test fixes

- bash test: select .profile on macOS (login shell) vs .bashrc on Linux
- fish test: unset XDG_CONFIG_HOME so config path stays within temp HOME
- fish test: add duplicate prevention and re-install assertions
- Windows: remove false-positive regex check on success message

* fix(smoke): use @() array coercion for empty PATH entries count

$entries4 is a 0-element array which PowerShell can coerce to $null in
some contexts, causing '$entries4.Count' to throw ParentContainsErrorRecordException.
$(@entries4).Count forces array coercion so .Count always works.

* fix(install): validate PATH integration through real shells

* fix(install): make manifest fallback portable

* Harden installer PATH mutations

* fix(smoke): compare persisted physical paths

* fix(installer): harden shell path mutation

* test(installer): support Windows PowerShell path joins

* test(installer): normalize manifest fixture encoding

* test(installer): capture expected PowerShell failures

* release: prepare 0.25.0 stable (#1692)

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working config Configuration issues, netclaw doctor, schema validation. tui Terminal UI (Termina) issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Unresolved Models.Roles reference crashes netclaw doctor (exit 134); model list misdiagnoses it and directs operators there

1 participant