fix(v0.1.10): resolve open review comments from PRs #147/#149 + release prep

[db-tycoon-stephen]

Summary

Addresses every unresolved review comment from PR #147 (my review) and PR #149 (Gemini), plus the v0.1.10 release-prep machinery, targeting the release branch.

Review fixes (PR #147)

• Stale AI-agent hints removed from live paths — ai_hint() (printed tycoon ask chat … on every failed ingestion / dbt test) deleted along with its 6 call sites; data observability scaffold no longer suggests tycoon ask sync; dead nao_dir config property, scaffolded .gitignore nao entries, and stale Nao comments/docstrings dropped
• Stale-string sentinel updated — _STALE_SUBSTRINGS now guards tycoon ask / register llm / nao / Nao, so this class of drift fails tests from now on
• pandas resolved empirically — removing it broke tests/test_e2e_demo_arc.py: dlt's on-demand filesystem source needs it for CSV reads. Kept, pinned ==3.0.3 to match the exact-pin convention, with a comment naming the real consumer (extra treatment stays tracked in feat: make pandas an optional extra with proper CI matrix #148)
• Coverage floor corrected 55 → 68 — real coverage after the deletion is ~73% (up from ~65%), so the floor moves up, keeping the same 5-point drift headroom as the old 65/60 split
• tycoon start shutdown catches (OSError, subprocess.TimeoutExpired) instead of blanket Exception (PR fix(v0.1.9): address PR #59 review feedback (robustness polish) #69 convention)
• quack asserted in the PORTS-keys test

Review fixes (PR #149)

• ingestion-architecture.md command names aligned to the tycoon data sources namespace (upgrade, catalog) per Gemini's consistency comments

Release prep

• Version bumped to 0.1.10 (pyproject.toml + __init__.py; tycoon --version verified)
• CHANGELOG [0.1.10] - UNRELEASED section + docs/releases/v0.1.10.md (_Released: TBD_ — date flips at ship time per the release procedure)
• Full docs sweep: docs/commands/ask/ and the LM Studio recipe deleted; ~22 pages + README updated to the actual surface (4-step wizard, rill+quack servers, [docs]-only extras), verified against src; mkdocs nav updated
• docs/proposals/v0.1.10-scope.md gets a dated status note: the cycle pivoted to the rewrite track; security items [security] ${VAR} interpolation in tycoon.yml is an env-var exfiltration vector (Medium) #62–[security] Add secret-scanning + SAST, pin runtime dlt installs, add SECURITY.md (Low) #68 all remain open (scope decision pending)

Test plan

• uv run pytest → 611 passed, 2 skipped (includes new sentinel entries)
• uv run pytest --cov → 73.3% ≥ new 68% floor
• uvx ruff check src tests → clean
• uv run --extra docs mkdocs build --strict → clean
• uv run tycoon --version → 0.1.10
• grep -rniE 'tycoon ask|register llm|dagster|nao' README.md docs/ (excl. releases/proposals) → only generic-English hits

🤖 Generated with Claude Code

---

^{Need help on this PR? Tag /codesmith with what you need. Autofix is disabled.}

[db-tycoon-stephen]

/gemini review

[gemini-code-assist]

Code Review

This pull request transitions the database-tycoon CLI to version 0.1.10, focusing on streamlining the codebase by completely removing the FastAPI web UI, Dagster orchestration, and Nao/ask AI agent integrations. It introduces a typed MetadataBackend protocol with a DuckDB file backend for run history, pins pandas as a core dependency, and re-baselines the test coverage floor to 68%. The review feedback correctly suggests adding 'dagster' and 'Dagster' to the stale substring sentinel checks in tests to prevent accidental re-introduction of these terms.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

Since the Dagster integration has been completely removed in this release (along with the [dagster] extra and its associated commands), we should also add "dagster" and "Dagster" to the _STALE_SUBSTRINGS sentinel. This will ensure that any accidental re-introduction of Dagster-related user-facing strings or commands in the codebase will be caught by the tests.

Suggested change

	("nao",
	"removed in v0.1.10 — the Nao agent integration was dropped"),
	("Nao",
	"removed in v0.1.10 — the Nao agent integration was dropped"),
	("nao",
	"removed in v0.1.10 — the Nao agent integration was dropped"),
	("Nao",
	"removed in v0.1.10 — the Nao agent integration was dropped"),
	("dagster",
	"removed in v0.1.10 — the Dagster integration was dropped entirely"),
	("Dagster",
	"removed in v0.1.10 — the Dagster integration was dropped entirely"),

[gemini-code-assist]

Code Review

This pull request implements a major cleanup and refocusing of the codebase for version 0.1.10, referred to as "the great slimming." It removes the FastAPI web UI, Dagster orchestration, and Nao/ask AI agent integrations entirely, along with their respective optional dependency groups ([server], [dagster], and [ask]). Concurrently, it introduces the first milestone of the ingestion rewrite, adding a typed MetadataBackend protocol and a DuckDB file backend to handle run history. It also pins pandas as a core dependency, updates the test coverage floor to 68%, and cleans up all related documentation, CLI commands, and helper utilities. I have no feedback to provide as there are no review comments.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[db-tycoon-stephen]

Split per review feedback: docs-only sweep → #151, code fixes + release prep → #152. Branch kept for reference until both land.