feat(agent): scaffold Python package for the accounting agent worker

.gitignore

@@ -1,2 +1,6 @@
 .env
 *.log
+.venv/
+__pycache__/
+*.egg-info/
+.pytest_cache/

agent/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "firefly-agent"
+version = "0.1.0"
+description = "Personal accounting agent worker for the Firefly III stack"
+requires-python = ">=3.12"
+dependencies = [
+    "apscheduler>=3.10,<4",
+    "httpx>=0.27",
+    "psycopg[binary]>=3.1",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "testcontainers[postgres]>=4",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agent"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

agent/src/agent/__init__.py

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

agent/tests/test_smoke.py

@@ -0,0 +1,4 @@
+def test_package_imports():
+    import agent
+
+    assert agent.__version__ == "0.1.0"