Skip to content

Prepare 0.17.0.1 release#5

Merged
adsharma merged 3 commits into
mainfrom
docs/stable-versioning-maintainer-guide
Jun 1, 2026
Merged

Prepare 0.17.0.1 release#5
adsharma merged 3 commits into
mainfrom
docs/stable-versioning-maintainer-guide

Conversation

@sergey-v9

Copy link
Copy Markdown
Collaborator

Stabilize package versioning and maintainer docs

Summary

  • Moves the package family default from 0.17.0-alpha.1 to stable 0.17.0.1.
  • Updates Cake and the release workflow so the native engine release is derived from the first three package-version segments (0.17.0.1 -> v0.17.0).
  • Replaces the development-era .agents/notes/ files with MAINTAINING.md.
  • Refreshes README.md, AGENTS.md, and example package-version defaults to match the stable fourth-segment versioning policy.

Test plan

  • dotnet build LadybugDB.slnx -c Release
  • dotnet run --project cake/LadybugDB.Build.csproj -- --target Pack --engine-version v0.17.0
  • Stale-string search for old alpha/living-notes references

Notes

  • This branch was created from the examples branch. If the examples PR has not merged yet, open this PR with base examples/database-usage-samples; otherwise retarget it to main.
  • All seven packages should be released with the same 0.17.0.1 version.

sergey-v9 added 2 commits May 31, 2026 18:24
Add runnable C# examples for quickstart queries, CSV graph loading, prepared statements, and result materialization so consumers can exercise the published package API.
Move the package family to the stable 0.17.0.1 revision scheme, derive engine releases from the first three package segments, and replace the development note files with a maintained repository guide.
@adsharma

Copy link
Copy Markdown
Contributor

LGTM except for a question about the versioning scheme.

Nuget packages seem to follow semver, which suggests 0.17.0-1 instead of 0.17.0.1. Is this something you considered?

Base automatically changed from examples/database-usage-samples to main May 31, 2026 18:33
@sergey-v9

sergey-v9 commented May 31, 2026

Copy link
Copy Markdown
Collaborator Author

LGTM except for a question about the versioning scheme.

Nuget packages seem to follow semver, which suggests 0.17.0-1 instead of 0.17.0.1. Is this something you considered?

I considered 0.17.0-1, but a hyphen suffix is a prerelease in both SemVer and NuGet. Also considered build metadata (0.17.0+dotnet.1), but NuGet ignores build metadata for package identity. Since the first three numeric segments intentionally mirror the engine's SemVer, I use NuGet's documented fourth Revision segment to represent the binding/package revision.

@adsharma adsharma merged commit 4cdf8ee into main Jun 1, 2026
3 checks passed
@adsharma adsharma deleted the docs/stable-versioning-maintainer-guide branch June 1, 2026 00:00
sergey-v9 added a commit to sergey-v9/ladybug-dotnet that referenced this pull request Jun 29, 2026
…hiti wishes LadybugDB#3, LadybugDB#5)

Wish LadybugDB#5: add a structured `consumer_impact=` one-liner to upstream-engine.pin
for the current pin (interop/fts_scoring/new_ddl/fixes/note), and make it a
REQUIRED field on every bump in docs/upstream-sync.md — a new numbered
pin-advance step plus the field format and per-field guidance, so consumers
read the impact off the pin instead of re-deriving it each cycle.

Wish LadybugDB#3: add a "D) Engine-feature backlog (needs upstream)" section to
docs/upstream-sync.md recording the fixed-size FLOAT[N] parameter-binding ask:
the binding cannot do it alone because lbug.h has no fixed-ARRAY value
constructor (only lbug_value_create_list) and the header is byte-identical
v0.17.1..main, so 0.18.0 adds none either; it needs an upstream
lbug_value_create_array-style addition plus a typed binding helper. Until
then the List<float> + CAST($v AS FLOAT[N]) path (pinned by
Vector_InlineCosineSimilarity) is the supported route.

Also append a "Response — 2026-06-29 (binding maintainers)" section to
GRAPHITI_SEARCH_EXTENSIONS_FEEDBACK.md addressing all six wishes by number:
LadybugDB#1 Linux from-source native build fixed (validated by next dev push),
LadybugDB#2 version-tolerant DROP_FTS_INDEX round-trip, LadybugDB#3 engine-gated/backlogged,
LadybugDB#4 Connection.ExecuteMany shipped, LadybugDB#5 consumer_impact added+required,
#6 FTS ranking assertions hardened to a score-tweak-resilient cross-check.

Docs-only; build clean (0 warnings, both TFMs), suite green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

2 participants