d9ef2f0d5b
Some checks failed
Build and Test / Validate Setup (push) Has been cancelled
Build and Test / Build (darwin-amd64) (push) Has been cancelled
Build and Test / Build (darwin-arm64) (push) Has been cancelled
Build and Test / Build (linux-amd64) (push) Has been cancelled
Build and Test / Build (windows-amd64) (push) Has been cancelled
Build and Test / Build (linux-arm64) (push) Has been cancelled
Build and Test / Security Audit (push) Has been cancelled
Build and Test / Package Results (push) Has been cancelled
Build and Test / Quality Gate (push) Has been cancelled
Nightly Build / Check for Changes (push) Has been cancelled
Nightly Build / Validate Setup (push) Has been cancelled
Nightly Build / Nightly Build (darwin-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (darwin-arm64) (push) Has been cancelled
Nightly Build / Nightly Build (linux-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (windows-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (linux-arm64) (push) Has been cancelled
Nightly Build / Create Nightly Pre-release (push) Has been cancelled
Nightly Build / Notify Build Status (push) Has been cancelled
Nightly Build / Nightly Maintenance (push) Has been cancelled
- Bump all 18 plugins from 0.110.0 to 0.111.0
- Update rust-toolchain.toml channel to 1.93.1 (nu 0.111.0 requires ≥1.91.1)
Fixes:
- interprocess pin =2.2.x → ^2.3.1 in nu_plugin_mcp, nu_plugin_nats, nu_plugin_typedialog
(required by nu-plugin-core 0.111.0)
- nu_plugin_typedialog: BackendType::Web initializer — add open_browser: false field
- nu_plugin_auth: implement missing user_info_to_value helper referenced in tests
Scripts:
- update_all_plugins.nu: fix [package].version update on minor bumps; add [dev-dependencies]
pass; add nu-plugin-test-support to managed crates
- download_nushell.nu: rustup override unset before rm -rf on nushell dir replace;
fix unclosed ) in string interpolation
1 line
6.9 KiB
Markdown
1 line
6.9 KiB
Markdown
# Quick Start Guide - Nushell 0.108.0 Update\n\n**Fast track to updating Nushell and creating distributions**\n\n---\n\n## ⚡ ONE-LINER UPDATE\n\nUpdate everything (Nushell + all plugins + distributions) in one command:\n\n```bash\n# Update to specific version (recommended)\n./scripts/complete_update.nu 0.108.0\n\n# Or use justfile\njust complete-update 0.108.0\n```\n\n**What it does:**\n\n1. ✅ Downloads Nushell 0.108.0\n2. ✅ Builds with MCP + all features (~3 minutes)\n3. ✅ Updates all plugin dependencies\n4. ✅ Builds all plugins\n5. ✅ Creates full distribution packages\n6. ✅ Creates bin archives\n7. ✅ Validates everything\n\n**Total time**: ~20-30 minutes (mostly build time)\n\n---\n\n## 🎯 ANSWER: "How do I update everything in one go?"\n\n**YES!** We have a complete automation system:\n\n### Option 1: All-in-One Script (Fastest)\n\n```bash\n# Update to 0.108.0 and create everything\n./scripts/complete_update.nu 0.108.0\n\n# Update to latest release\n./scripts/complete_update.nu --latest\n\n# Auto-approve (no prompts)\n./scripts/complete_update.nu 0.108.0 --auto-approve\n```\n\n### Option 2: Using Justfile (Easier to remember)\n\n```bash\n# Complete update\njust complete-update 0.108.0\n\n# Or update to latest\njust update-latest\n\n# Show all version update commands\njust update-help\n```\n\n### Option 3: Step-by-Step (More control)\n\n```bash\n# Step 1: Update Nushell core\njust update-nushell 0.108.0\n\n# Step 2: Update all plugins\njust update-plugins 0.108.0\n\n# Step 3: Create distributions\njust create-distribution\n\n# Step 4: Create bin archives\njust create-bin-archives\n```\n\n---\n\n## 📦 ANSWER: "How do I create distributions and bin_archives?"\n\n### Quick Method\n\n```bash\n# Create everything (full distributions + bin archives)\njust create-distribution\n\n# Create for all platforms\njust create-distribution-all\n\n# Create only bin archives\njust create-bin-archives\n\n# Rebuild and redistribute\njust rebuild-all\n```\n\n### What Gets Created\n\n**Full Distributions** (in `distribution/packages/`):\n\n```plaintext\nnushell-full-darwin-arm64-0.108.0.tar.gz # macOS ARM (120 MB)\nnushell-full-linux-x86_64-0.108.0.tar.gz # Linux x64 (110 MB)\nnushell-full-windows-x86_64-0.108.0.zip # Windows (115 MB)\nchecksums.txt # SHA256 checksums\n```\n\n**Bin Archives** (in `bin_archives/`):\n\n```plaintext\nnu_plugin_clipboard-0.108.0-darwin-arm64.tar.gz # Individual plugins\nnu_plugin_image-0.108.0-darwin-arm64.tar.gz # (~2-8 MB each)\nnu_plugin_hashes-0.108.0-darwin-arm64.tar.gz\n... (one for each custom plugin)\n```\n\n---\n\n## 🚀 Common Workflows\n\n### Workflow 1: Fresh Update to New Version\n\n```bash\n# All-in-one command\njust complete-update 0.109.0\n\n# That's it! Everything is done.\n```\n\n### Workflow 2: Update Only Plugins\n\n```bash\n# Update plugin dependencies to match nushell\njust sync-plugins\n\n# Or specify version\njust update-plugins 0.108.0\n\n# Check for version mismatches\njust check-versions\n```\n\n### Workflow 3: Create Distributions Only\n\n```bash\n# Build if needed\njust build-nushell\njust build\n\n# Create distributions\njust create-distribution\n\n# Verify\njust dist-status\n```\n\n### Workflow 4: Quick Development Iteration\n\n```bash\n# Make changes to plugins...\n\n# Rebuild and redistribute\njust rebuild-all\n\n# This rebuilds nushell + plugins + creates fresh distributions\n```\n\n---\n\n## 📊 Status Commands\n\nCheck what's happening at any time:\n\n```bash\n# Overall update status\njust update-status\n\n# Distribution status\njust dist-status\n\n# Plugin versions\njust list-versions\n\n# Check for version mismatches\njust check-versions\n\n# Dependency audit\njust audit-deps\n```\n\n---\n\n## 🔍 Analysis & Validation\n\n### Before Update\n\n```bash\n# Detect breaking changes\njust detect-breaking\n\n# Analyze available features\njust analyze-features\n\n# Show dependency tree for a feature\njust feature-tree mcp\n\n# Audit current dependencies\njust audit-deps\n```\n\n### After Update\n\n```bash\n# Validate installation\njust validate-code\n\n# Run quality checks\njust quality-flow\n\n# Test plugin registration\njust verify-plugins\n```\n\n---\n\n## 🆘 Troubleshooting\n\n### "My update failed halfway through"\n\n```bash\n# Check status\njust update-status\n\n# Clean up and retry\njust clean-update\njust complete-update 0.108.0\n```\n\n### "Plugins have version mismatches"\n\n```bash\n# Auto-sync to nushell submodule version\njust sync-plugins\n\n# Or check what's wrong\njust check-versions\njust audit-deps\n```\n\n### "Distribution packages are missing"\n\n```bash\n# Check status\njust dist-status\n\n# Rebuild distributions\njust rebuild-all\n```\n\n### "Need to rollback"\n\n```bash\n# Git rollback\ngit stash save "backup current state"\n\n# Or reset to previous commit\ngit reset --hard HEAD~1\n\n# Rebuild old version\njust clean\njust build\n```\n\n---\n\n## 📚 Complete Documentation\n\nFor detailed information, see:\n\n| Document | Purpose |\n|----------|---------|\n| `guides/COMPLETE_VERSION_UPDATE_GUIDE.md` | Complete step-by-step guide |\n| `updates/108/NUSHELL_0.108_UPDATE_SUMMARY.md` | What changed in 0.108.0 |\n| `updates/108/MIGRATION_0.108.0.md` | Migration guide |\n| `updates/108/NUSHELL_UPDATE_AUTOMATION.md` | Automation details |\n| `CHANGELOG.md` | All changes |\n| `README.md` | Repository overview |\n\n---\n\n## 🎯 Quick Reference Card\n\n```bash\n# UPDATE EVERYTHING\njust complete-update 0.108.0 # All-in-one update\n\n# STEP-BY-STEP\njust download-nushell 0.108.0 # 1. Download source\njust build-nu # 2. Build nushell\njust update-plugins 0.108.0 # 3. Update plugins\njust build # 4. Build plugins\njust create-distribution # 5. Create packages\n\n# STATUS & VALIDATION\njust update-status # Update system status\njust dist-status # Distribution status\njust check-versions # Version consistency\njust audit-deps # Dependency audit\n\n# DISTRIBUTIONS\njust create-distribution # Current platform\njust create-distribution-all # All platforms\njust create-bin-archives # Plugins only\njust rebuild-all # Rebuild everything\n\n# HELP\njust update-help # Quick command reference\njust update-docs # Documentation paths\n```\n\n---\n\n## ✅ Success Checklist\n\nAfter running `just complete-update 0.108.0`, verify:\n\n- [ ] Nushell binary built: `./nushell/target/release/nu --version`\n- [ ] Plugins built: `ls nu_plugin_*/target/release/nu_plugin_*`\n- [ ] Distribution packages created: `ls distribution/packages/`\n- [ ] Bin archives created: `ls bin_archives/`\n- [ ] Version is correct: `just check-versions`\n- [ ] No dependency issues: `just audit-deps`\n\n---\n\n**Last Updated**: 2025-10-18\n**Nushell Version**: 0.108.0\n**Status**: ✅ Complete automation system ready |