🚢 Release: 1.0.0-beta.1 (stabilize and ship)

[jongalloway]

This umbrella issue tracks the work to cut a solid 1.0.0-beta.1. Scope is to stabilize and package what we have—no new providers or advanced features—just a clean, verifiable beta.

Goals

• Produce a reliable NuGet package and runnable demo container.
• Verify basic protocol coverage (List, Summarize, Generate) and MCP integration.
• Polish docs and changelog for a public beta release.

Acceptance Criteria

• All unit tests pass in CI.
• Demo app runs locally and in Docker without restore/build issues.
• Minimal smoke suite covers List/Summarize/Generate happy paths.
• README and docs updated for install, config, and quickstart.
• CHANGELOG has a clear 1.0.0-beta.1 entry.
• Git tag and GitHub Release created with artifacts and notes.

Checklist

• CI/CD: Ensure build/test/pack pipelines are green and repeatable.
• Container: Resolve Docker restore/build and publish demo image.
• Packaging: Pack NLWebNet NuGet(s) with pinned versions and symbols.
• Docs: Quickstart, config examples, troubleshooting, MCP note.
• Versioning: Bump to 1.0.0-beta.1 and create tag/release.

Sub-Issues (to be created)

• CI/CD workflow for release (build/test/pack/publish)
• Docker build stabilization (restore feeds/props, smoke-test container)
• Docs & Changelog polish (README, docs, CHANGELOG)
• Versioning & tagging plan (version bump, release notes)

Out of Scope

• Adding new providers or advanced features (e.g., 🐛 Enhanced Debug and Development Experience #38, 📋 Implement Configurable Response Headers #39, 🗄️ Advanced Backend Support #40/Backend: Qdrant integration (formalize from PoC) #72-Backend: Snowflake Cortex integration (vector search) #75, ⚡ Streaming and Performance Enhancements #42). These stay open for post-beta.

References

• June 2025 epic (closed): Epic: NLWeb June 2025 Updates and Enhancements #43
• Backend epic (ongoing): 🗄️ Advanced Backend Support #40
• Streaming/Debug/Headers: ⚡ Streaming and Performance Enhancements #42, 🐛 Enhanced Debug and Development Experience #38, 📋 Implement Configurable Response Headers #39

[jongalloway]

Created sub-issues for the beta release:

• CI/CD workflow: 🤖 Release: CI/CD workflow for 1.0.0-beta.1 #77
• Docker build stabilization: 🐳 Release: Docker build stabilization for beta #78
• Docs & Changelog polish: 📝 Release: Docs and Changelog polish #79
• Versioning, tagging, and notes: 🏷️ Release: Versioning, tagging, and notes #80

We’ll keep scope tight to ensure a clean 1.0.0-beta.1.