OB-244: SQL_DEFAULT_BACKEND env var + README rewrite#2
Merged
Oblio-Falootin merged 4 commits intomainfrom Apr 20, 2026
Merged
Conversation
added 4 commits
April 15, 2026 19:06
…ocal' Default backend should be 'local' (10.0.0.110) matching .env configuration.
SQL_DEFAULT_BACKEND ENV VAR:
Problem: default 'local' breaks external ClawHub users (no local server)
Solution: SQL_DEFAULT_BACKEND env var controls default
- Not set (external users): defaults to 'cloud' (safe)
- SQL_DEFAULT_BACKEND=local (Oblio .env): defaults to 'local'
Applies to: get_connector(), SQLConnector.__init__(), from_env()
No code change for callers — just .env config
README:
Complete rewrite as ClawHub-publishable documentation
- Multi-backend quick start (external + local setup)
- Default backend table explaining the env var logic
- Mandatory parameterized query guidance
- Repository subclass extension pattern
- Error handling examples
- ClawHub publish intent documented
.env.example:
Added SQL_DEFAULT_BACKEND documentation and commented example
PROBLEM: test-on-pr.yml ran Node.js matrix (18.x/20.x/22.x) clawbot-sql-connector is a Python library — no package-lock.json Every CI run failed with 'lock file not found' Pre-existing issue, not caused by this PR FIX: Replace Node.js matrix with Python 3.11 syntax + smoke test - python -m py_compile (syntax validation) - Smoke test: import + _DEFAULT_BACKEND check (no DB required) - pymssql mocked in CI (no real DB connection) - Secret scanning preserved
Collaborator
Author
|
OB-244 changes ready for review and merge. What's in this PR:
CI status: All passing (syntax check + secret scan) Requires VeX approval to merge (repo policy: 1 review required, can't self-approve) |
Oblio-Falootin
added a commit
that referenced
this pull request
Apr 20, 2026
* fix: add missing ping() method to SQLConnector base class * docs: rewrite SKILL.md — replace markdown tables with bullet lists, fix env var format, add ping() to API docs * revert: restore sql_connector.py to pre-Oblio state * revert: restore SKILL.md to pre-Oblio state * housekeeping: add __pycache__ and *.pyc to gitignore * OB-244: SQL_DEFAULT_BACKEND env var + README rewrite (#2) * OB-CLAWBOT: Complete sql-connector update - set default backend to 'local' Default backend should be 'local' (10.0.0.110) matching .env configuration. * OB-129: Add secret scanning, .env.example, and pre-commit hooks * OB-244: SQL_DEFAULT_BACKEND env var + README rewrite SQL_DEFAULT_BACKEND ENV VAR: Problem: default 'local' breaks external ClawHub users (no local server) Solution: SQL_DEFAULT_BACKEND env var controls default - Not set (external users): defaults to 'cloud' (safe) - SQL_DEFAULT_BACKEND=local (Oblio .env): defaults to 'local' Applies to: get_connector(), SQLConnector.__init__(), from_env() No code change for callers — just .env config README: Complete rewrite as ClawHub-publishable documentation - Multi-backend quick start (external + local setup) - Default backend table explaining the env var logic - Mandatory parameterized query guidance - Repository subclass extension pattern - Error handling examples - ClawHub publish intent documented .env.example: Added SQL_DEFAULT_BACKEND documentation and commented example * OB-244: Fix CI workflow — Python syntax check, not Node.js PROBLEM: test-on-pr.yml ran Node.js matrix (18.x/20.x/22.x) clawbot-sql-connector is a Python library — no package-lock.json Every CI run failed with 'lock file not found' Pre-existing issue, not caused by this PR FIX: Replace Node.js matrix with Python 3.11 syntax + smoke test - python -m py_compile (syntax validation) - Smoke test: import + _DEFAULT_BACKEND check (no DB required) - pymssql mocked in CI (no real DB connection) - Secret scanning preserved --------- Co-authored-by: Oblio <oblio@falootin.com> --------- Co-authored-by: Oblio <oblio@falootin.com>
Oblio-Falootin
added a commit
that referenced
this pull request
Apr 20, 2026
* fix: add missing ping() method to SQLConnector base class * docs: rewrite SKILL.md — replace markdown tables with bullet lists, fix env var format, add ping() to API docs * revert: restore sql_connector.py to pre-Oblio state * revert: restore SKILL.md to pre-Oblio state * housekeeping: add __pycache__ and *.pyc to gitignore * OB-244: SQL_DEFAULT_BACKEND env var + README rewrite (#2) * OB-CLAWBOT: Complete sql-connector update - set default backend to 'local' Default backend should be 'local' (10.0.0.110) matching .env configuration. * OB-129: Add secret scanning, .env.example, and pre-commit hooks * OB-244: SQL_DEFAULT_BACKEND env var + README rewrite SQL_DEFAULT_BACKEND ENV VAR: Problem: default 'local' breaks external ClawHub users (no local server) Solution: SQL_DEFAULT_BACKEND env var controls default - Not set (external users): defaults to 'cloud' (safe) - SQL_DEFAULT_BACKEND=local (Oblio .env): defaults to 'local' Applies to: get_connector(), SQLConnector.__init__(), from_env() No code change for callers — just .env config README: Complete rewrite as ClawHub-publishable documentation - Multi-backend quick start (external + local setup) - Default backend table explaining the env var logic - Mandatory parameterized query guidance - Repository subclass extension pattern - Error handling examples - ClawHub publish intent documented .env.example: Added SQL_DEFAULT_BACKEND documentation and commented example * OB-244: Fix CI workflow — Python syntax check, not Node.js PROBLEM: test-on-pr.yml ran Node.js matrix (18.x/20.x/22.x) clawbot-sql-connector is a Python library — no package-lock.json Every CI run failed with 'lock file not found' Pre-existing issue, not caused by this PR FIX: Replace Node.js matrix with Python 3.11 syntax + smoke test - python -m py_compile (syntax validation) - Smoke test: import + _DEFAULT_BACKEND check (no DB required) - pymssql mocked in CI (no real DB connection) - Secret scanning preserved --------- Co-authored-by: Oblio <oblio@falootin.com> --------- Co-authored-by: Oblio <oblio@falootin.com>
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
1 participant
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.
Fixes default backend for ClawHub external users while keeping Oblio on local.
SQL_DEFAULT_BACKEND env var: unset=cloud (external safe), =local (Oblio).
Full README rewrite with ClawHub publish documentation.