Argue from what survives, now that the official CLI is conversational - #37
Closed
ivanvyd wants to merge 1 commit into
Closed
Argue from what survives, now that the official CLI is conversational#37ivanvyd wants to merge 1 commit into
ivanvyd wants to merge 1 commit into
Conversation
Databricks CLI v1.10.0 ships `databricks genie ask`: stateful across calls with -s, SQL with --include-sql, JSON with -o json. Read from the installed binary's help, not from documentation. The README's "Why this exists" argued that this project exists because the official CLI makes you manage six identifiers and a polling loop by hand. That argument is now losable, so it is gone. What replaces it is the two claims that survive: Databricks publishes SDKs for Python, Java, Go and R but not .NET, and Question Packs have no equivalent anywhere. The README now points readers at `databricks genie ask` first if a terminal answer is all they want. ROADMAP.md predicted this exact event under "things that would change the plan". It is moved to a dated statement that it happened and the plan followed, rather than deleted -- a project that predicts something, is right, and then says nothing has stopped paying attention. ADR 0001 gains a correction rather than a rewrite. Its decision stands: still no MCP server. Two of its premises do not. It claimed an MCP server would duplicate Databricks' managed endpoints, and those endpoints are stateless, so a stateful one would do the thing theirs cannot. It also used that statelessness as an argument against MCP, which confuses Databricks' implementation with the protocol. The real reason was always scope, and that is what the decision now rests on. GOVERNANCE.md and ROADMAP.md say the same thing as the ADR rather than the old version of it. NuGet version badges, so the README shows what is actually published.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stacked on #36. Base is
fix/complete-results-and-docs-contract; GitHub will retarget this tomainwhen #36 merges. Review #36 first.The fact
Databricks CLI v1.10.0 — the version
docs/compatibility.mdalready records as tested — ships:Read from
databricks genie ask --helpon the installed binary, not from documentation.ROADMAP.mdnamed this event in advance: "The official CLI becoming conversational. Thedifferentiator would narrow to Question Packs and the .NET library, and the roadmap would follow."
It happened. This PR is the roadmap following.
What changes
README.md"Why this exists" is rewritten. It argued that this project exists because theofficial CLI makes you manage six identifiers, a polling loop and a two-step download by hand. That
argument is now losable, so it is gone. What replaces it is the two claims that survive scrutiny:
Databricks publishes SDKs for Python, Java, Go and R but not .NET, and Question Packs have no
equivalent. The section now opens by pointing readers at
databricks genie askif a terminalanswer is all they want.
docs/decisions/0001gains a dated correction, not a rewrite. The decision stands — still noMCP server — but two premises do not:
stateless, so a stateful one would do the thing theirs cannot.
implementation with the protocol.
The honest reason was always scope, and that is what the decision now rests on.
GOVERNANCE.mdandROADMAP.mdare updated to say the same thing as the ADR rather than the superseded version.ROADMAP.mdmoves the prediction into a dated statement that it occurred, rather than deletingit. A project that predicts something, is right, and then says nothing has stopped paying attention.
NuGet version badges for both packages. Version only — a downloads badge on a package published
four days ago advertises a small number.
One claim I deliberately hedged
The official
askexposes no flag naming which Genie Agent answers — no space id argument, no--spaceor--agent. The README says it "exposes no flag for" targeting a named Agent ratherthan "you cannot choose the Agent", because its help text does not say how it resolves one and I
have not verified that behaviour.
Verification
223 tests pass. The docs-contract test added in #36 parses every
lakespeak …example in therewritten README against the real command tree. All 40+ relative markdown links across the
repository resolve. Documentation-only otherwise — no source changes.