feat: scaffold circuitforge-core package

.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+.env
+*.egg-info/
+dist/
+.pytest_cache/

README.md

@@ -0,0 +1,23 @@
+# circuitforge-core
+
+Shared scaffold for CircuitForge products.
+
+## Modules
+
+- `circuitforge_core.db` — SQLite connection factory and migration runner
+- `circuitforge_core.llm` — LLM router with fallback chain
+- `circuitforge_core.tiers` — Tier system with BYOK and local vision unlocks
+- `circuitforge_core.config` — Env validation and .env loader
+- `circuitforge_core.vision` — Vision router stub (v0.2+)
+- `circuitforge_core.wizard` — First-run wizard base class stub
+- `circuitforge_core.pipeline` — Staging queue stub (v0.2+)
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## License
+
+BSL 1.1 — see LICENSE

circuitforge_core/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "circuitforge-core"
+version = "0.1.0"
+description = "Shared scaffold for CircuitForge products"
+requires-python = ">=3.11"
+dependencies = [
+    "pyyaml>=6.0",
+    "requests>=2.31",
+    "openai>=1.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["circuitforge_core*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]