refactor: conform standards docs to doc-forge wiki/lib layout; generic build.py; static kind links

standards/templates/app/tests/integration/test_item_routes.py

@@ -0,0 +1,21 @@
+import importlib
+
+import interfaces.openapi as routes_module
+
+from openapi_first.app import OpenAPIFirstApp
+
+
+def test_openapi_app_builds():
+    """The spec-first app must build and plant each route handler."""
+    module = importlib.import_module(routes_module.__name__)
+    for operation in ("create_item", "get_item", "list_items", "delete_item",
+                      "create_job", "get_job", "list_jobs"):
+        assert hasattr(module, operation)
+
+    app = OpenAPIFirstApp(
+        openapi_path="openapi.yaml",
+        routes_module=module,
+        title="Item API",
+        version="0.1.0",
+    )
+    assert app is not None

standards/templates/app/tests/unit/test_item_models.py

@@ -0,0 +1,22 @@
+from domain.item.models import Item
+from domain.job.models import Job
+
+
+def test_item_defaults():
+    item = Item(name="widget")
+    assert item.quantity == 1
+
+
+def test_job_defaults():
+    job = Job(name="sync")
+    assert job.status == "pending"
+    assert job.retry_count == 0
+    assert job.error_message is None
+
+
+def test_job_rejects_unknown_status():
+    try:
+        Job(name="sync", status="exploded")
+    except Exception:
+        return
+    raise AssertionError("status should be rejected")

standards/templates/app/tests/unit/test_item_sync.py

@@ -0,0 +1,28 @@
+from types import SimpleNamespace
+
+from pipelines.item_sync import run_item_sync
+
+
+class FakeItemSvc:
+    def __init__(self):
+        self.created = []
+
+    async def create(self, data: dict):
+        self.created.append(dict(data))
+
+
+async def test_run_item_sync_creates_item():
+    svc = FakeItemSvc()
+    job = SimpleNamespace(id="j1", name="widget", payload={"quantity": 4})
+    await run_item_sync(job, {"item_svc": svc})
+
+    assert len(svc.created) == 1
+    assert svc.created[0] == {"name": "widget", "quantity": 4}
+
+
+async def test_run_item_sync_uses_payload_name():
+    svc = FakeItemSvc()
+    job = SimpleNamespace(id="j1", name="ignored", payload={"name": "gadget"})
+    await run_item_sync(job, {"item_svc": svc})
+
+    assert svc.created[0]["name"] == "gadget"