implement server mvp: fastapi app, org formatter, sqlite store, tests, dockerfile

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

server/tests/test_api.py

@@ -0,0 +1,118 @@
+import os
+import tempfile
+import pytest
+from fastapi.testclient import TestClient
+
+# Set env vars before importing app so store/paths are overridden in tests
+TOKEN = "test-token-abc"
+
+
+@pytest.fixture(autouse=True)
+def env_setup(tmp_path, monkeypatch):
+    db = str(tmp_path / "capture.sqlite3")
+    org = str(tmp_path / "synq.org")
+    monkeypatch.setenv("PHONE_CAPTURE_TOKEN", TOKEN)
+    monkeypatch.setenv("PHONE_CAPTURE_DB_PATH", db)
+    monkeypatch.setenv("PHONE_CAPTURE_ORG_PATH", org)
+    # reset singleton store so each test gets a fresh db
+    import app.main as m
+    m._store = None
+    yield
+    m._store = None
+
+
+@pytest.fixture()
+def client():
+    from app.main import app
+    return TestClient(app)
+
+
+def auth_headers():
+    return {"Authorization": f"Bearer {TOKEN}"}
+
+
+VALID_PAYLOAD = {
+    "id": "phone-20260517-143122-a8f2",
+    "created_at": "2026-05-17T14:31:22-04:00",
+    "kind": "todo",
+    "body": "buy printer paper",
+    "tags": ["home", "errands"],
+    "device": "android",
+}
+
+
+class TestHealth:
+    def test_health_returns_200(self, client):
+        r = client.get("/health")
+        assert r.status_code == 200
+        data = r.json()
+        assert data["ok"] is True
+        assert data["service"] == "synq"
+        assert data["version"] == "0.1.0"
+
+    def test_health_no_auth_required(self, client):
+        r = client.get("/health")
+        assert r.status_code == 200
+
+
+class TestCapture:
+    def test_valid_capture_accepted(self, client, tmp_path):
+        r = client.post("/capture", json=VALID_PAYLOAD, headers=auth_headers())
+        assert r.status_code == 200
+        data = r.json()
+        assert data["ok"] is True
+        assert data["status"] == "accepted"
+        assert data["id"] == VALID_PAYLOAD["id"]
+
+    def test_valid_capture_appended_to_org(self, client, monkeypatch, tmp_path):
+        org = str(tmp_path / "synq.org")
+        monkeypatch.setenv("PHONE_CAPTURE_ORG_PATH", org)
+        client.post("/capture", json=VALID_PAYLOAD, headers=auth_headers())
+        content = open(org, encoding="utf-8").read()
+        assert "buy printer paper" in content
+        assert ":ID: phone-20260517-143122-a8f2" in content
+
+    def test_duplicate_capture_returns_already_seen(self, client):
+        client.post("/capture", json=VALID_PAYLOAD, headers=auth_headers())
+        r = client.post("/capture", json=VALID_PAYLOAD, headers=auth_headers())
+        assert r.status_code == 200
+        assert r.json()["status"] == "already_seen"
+
+    def test_duplicate_not_appended_twice(self, client, monkeypatch, tmp_path):
+        org = str(tmp_path / "synq.org")
+        monkeypatch.setenv("PHONE_CAPTURE_ORG_PATH", org)
+        client.post("/capture", json=VALID_PAYLOAD, headers=auth_headers())
+        client.post("/capture", json=VALID_PAYLOAD, headers=auth_headers())
+        content = open(org, encoding="utf-8").read()
+        assert content.count(VALID_PAYLOAD["id"]) == 1
+
+    def test_missing_token_rejected(self, client):
+        r = client.post("/capture", json=VALID_PAYLOAD)
+        assert r.status_code == 401
+        assert r.json()["detail"] == "unauthorized"
+
+    def test_wrong_token_rejected(self, client):
+        r = client.post("/capture", json=VALID_PAYLOAD, headers={"Authorization": "Bearer wrong"})
+        assert r.status_code == 401
+
+    def test_empty_body_rejected(self, client):
+        payload = {**VALID_PAYLOAD, "body": "   "}
+        r = client.post("/capture", json=payload, headers=auth_headers())
+        assert r.status_code == 400
+        assert "body" in r.json()["detail"].lower()
+
+    def test_missing_body_field_rejected(self, client):
+        payload = {k: v for k, v in VALID_PAYLOAD.items() if k != "body"}
+        r = client.post("/capture", json=payload, headers=auth_headers())
+        assert r.status_code in (400, 422)
+
+    def test_invalid_kind_rejected(self, client):
+        payload = {**VALID_PAYLOAD, "kind": "journal"}
+        r = client.post("/capture", json=payload, headers=auth_headers())
+        assert r.status_code in (400, 422)
+
+    def test_note_kind_accepted(self, client):
+        payload = {**VALID_PAYLOAD, "id": "phone-20260517-143200-note1", "kind": "note"}
+        r = client.post("/capture", json=payload, headers=auth_headers())
+        assert r.status_code == 200
+        assert r.json()["status"] == "accepted"

server/tests/test_org_writer.py

@@ -0,0 +1,106 @@
+import pytest
+from app.models import CaptureRequest
+from app.org_writer import format_capture, normalize_tags
+
+
+def make_capture(**kwargs) -> CaptureRequest:
+    defaults = dict(
+        id="phone-20260517-143122-a8f2",
+        created_at="2026-05-17T14:31:22-04:00",
+        kind="note",
+        body="hello world",
+        tags=[],
+        device="android",
+    )
+    defaults.update(kwargs)
+    return CaptureRequest(**defaults)
+
+
+class TestNormalizeTags:
+    def test_lowercase(self):
+        assert normalize_tags(["Home", "ERRANDS"]) == ["home", "errands"]
+
+    def test_strips_hash(self):
+        assert normalize_tags(["#home"]) == ["home"]
+
+    def test_replaces_spaces(self):
+        assert normalize_tags(["my tag"]) == ["my_tag"]
+
+    def test_removes_invalid_chars(self):
+        assert normalize_tags(["tag!"]) == ["tag"]
+
+    def test_deduplicates(self):
+        assert normalize_tags(["home", "home"]) == ["home"]
+
+    def test_omits_empty(self):
+        assert normalize_tags(["", "  "]) == []
+
+    def test_empty_list(self):
+        assert normalize_tags([]) == []
+
+
+class TestFormatCapture:
+    def test_todo_with_tags(self):
+        c = make_capture(kind="todo", body="buy printer paper", tags=["home", "errands"])
+        result = format_capture(c)
+        assert result.startswith("* TODO buy printer paper :home:errands:\n")
+        assert ":CREATED:" in result
+        assert ":SOURCE: android" in result
+        assert ":ID: phone-20260517-143122-a8f2" in result
+
+    def test_todo_no_tags(self):
+        c = make_capture(kind="todo", body="do the thing", tags=[])
+        result = format_capture(c)
+        assert result.startswith("* TODO do the thing\n")
+
+    def test_note_single_line(self):
+        c = make_capture(kind="note", body="mobile capture should stay dumb and append-only.", tags=["retcon"])
+        result = format_capture(c)
+        assert result.startswith("* note :retcon:\n")
+        assert "mobile capture should stay dumb and append-only." in result
+        assert ":PROPERTIES:" in result
+
+    def test_note_no_tags(self):
+        c = make_capture(kind="note", body="simple note", tags=[])
+        result = format_capture(c)
+        assert result.startswith("* note\n")
+        assert "simple note" in result
+
+    def test_note_multiline(self):
+        body = "retcon capture idea\n\nphone should produce records, not edit org files."
+        c = make_capture(kind="note", body=body, tags=["retcon"])
+        result = format_capture(c)
+        assert result.startswith("* note: retcon capture idea :retcon:\n")
+        assert "retcon capture idea" in result
+        assert "phone should produce records, not edit org files." in result
+        assert ":PROPERTIES:" in result
+
+    def test_created_timestamp_format(self):
+        c = make_capture(created_at="2026-05-17T14:31:22-04:00")
+        result = format_capture(c)
+        assert ":CREATED: [2026-05-17 sun 14:31]" in result
+
+    def test_property_drawer_complete(self):
+        c = make_capture()
+        result = format_capture(c)
+        assert ":PROPERTIES:" in result
+        assert ":END:" in result
+
+    def test_todo_body_below_drawer_absent(self):
+        c = make_capture(kind="todo", body="simple todo")
+        result = format_capture(c)
+        lines = result.strip().split("\n")
+        # heading, drawer block — no extra body section
+        assert lines[0].startswith("* TODO")
+        assert ":END:" in result
+        # body should not appear after :END:
+        end_idx = result.index(":END:")
+        after_end = result[end_idx + len(":END:"):].strip()
+        assert after_end == ""
+
+    def test_note_body_appears_after_drawer(self):
+        c = make_capture(kind="note", body="my note body")
+        result = format_capture(c)
+        end_idx = result.index(":END:")
+        after_end = result[end_idx + len(":END:"):].strip()
+        assert "my note body" in after_end