Implemented v1 step1

tests/artifacts/transcriptions/Book_Two_-_page_02.jpg.txt

@@ -11,11 +11,11 @@ BOOK 1 had 54 pages; 14 chapters. BOOK 2 has 70 pages; 18 chapters. BOOK 1 con-
 sisted largely of first generation family history. BOOK 2 throws more light on
 the second generation. Sidney promises a BOOK 3 and that may begin to do justice
 to the third generation. We suggest that Sidney get the help of Louis Shinn
-who has a chapter in this book (Chapter 16 - The Last 25 Years on the Doumeeq
+who has a chapter in this book (Chapter 16 - The Last 25 Years on the Doumecq
 Plains. Louis has the gift of seeing, recalling and telling. One sentence in
-his chapter gives a great tribute to the Doumeeqers--so far as he knows no one
-on the Doumeeq Plains went on relief during the depression. That in a nutshell
-shows the sturdy character of the residents of the Doumeeq Plains.
+his chapter gives a great tribute to the Doumecqers--so far as he knows no one
+on the Doumecq Plains went on relief during the depression. That in a nutshell
+shows the sturdy character of the residents of the Doumecq Plains.
 
 We promised in BOOK 1 that in BOOK 2 we would give the story of the trip of
 John E. Cochran and wife to Tennessee, Cuba and the Panama Canal. You will see
@@ -24,7 +24,7 @@ trips. Those chapters are worth reading and re-reading. Mr. Cochran has eyes
 to see and a pen to tell. We think the people in Tennessee will read with
 great pleasure the comments he makes on conditions today.
 
-بعضome who get this book will consider the group picture the best thing in the
+Some who get this book will consider the group picture the best thing in the
 book. It took a lot of preliminary photographing to reduce some pictures, enlarge
 others and bring out the tin types. We wish that instead of 44 faces we could
 have given 88. Do not blame Ethel Cochran-Shinn for the selection. She furnished
@@ -32,10 +32,11 @@ enough pictures but we had to take only part of them. We think there are great
 possibilities in reproducing old pictures. We wish we had a Pickard group. Some
 Pickard descendant may wish to make a collection.
 
-We are much impressed with the future possibilities of getting a complete geneal-
+We are much impressed with the future possibilities of getting a complete geneol-
 ogy of the Pickard family. Mr. Cochran has a fine chapter on the Pickards but
 to date we have not had the pleasure of finding all of the family dates. We had
 intended to give more family data in this book but it takes time to get the
 correct dates. Often times it requires trips to cemeteries to get dates on the
 tombstones. Winter is no time to collect dates on tombstones.
+
 -2-

tests/artifacts/transcriptions/Omie_Writes_Home.pdf.txt

@@ -5,14 +5,17 @@ model: google/gemini-2.5-flash
 JOHN E. COCHRAN
 FAMILY ASSOCIATION
 Family Only
-Home | Sibling's Stories | 1st Cousins [sic] | Ancestor's Stories | Reunion History | Next Reunion | JECMEF
+Home | Sibling's Stories | 1st Cousins | Ancestor's Stories | Reunion History | Next Reunion | JECMEF
+
 OMIE WRITES HOME
+
 Ed. Note: The following letter was written by Omie Cochran in Nome, Alaska and sent to her
 sister, Ethel Shinn, in Canfield, Idaho in 1923. It has been stored away these 63 years in the
 original envelope with its 2 cent stamp. The letter has a number of references to the Shinn
 children. Peter was Louis; Polly was Edith; and the 'little black rascal' referred to Maurice.
 Miss Saville was the nurse at the Nome Hospital that was mentioned in the article by Inez in
 the family newsletter two years ago.
+
 Nome Alaska August 26, 1923
 My Dear Ethel et al.
 I don't know when I did write or when you did
@@ -23,10 +26,9 @@ and Polly sit up and listen and that little black
 rascal of yours would fairly sparkle with
 listening. Can't I see him listening now to all the
 yarns we told last summer?
-[photo of people with dogsleds and ice]
 You see, we-Miss Saville and I, took a trip north
 on the Buford and it was very interesting. We
-went north thru [sic] the Bering Strait into the Arctic and as far as the Ice Pack. There the captain
+went north thru the Bering Strait into the Arctic and as far as the Ice Pack. There the captain
 of our craft and some other mighty hunters went out first in kayaks and later in row boats and
 shot seven walrus. When they also took a movie man and camera, so you will likely see all
 this in the movies before I get to tell you. They came back on board and the ship went up
@@ -34,16 +36,16 @@ along the icebergs and the walrus were 'heisted' on board by the use of the cran
 tons of freight and the beasts were so huge that they made the pulleys just creak. They were
 over 12 feet long, as big around as three cows, had no feet but toenails on their flippers or
 flappers, no head but their body just suddenly ended with a hole for a mouth and big bristles
-
 all around it similar to a currycomb in coarseness; no ears but huge tusks of ivory. They are
-the most repulsive looking animals imaginable and tho [sic] I have always read about them I never
+the most repulsive looking animals imaginable and tho I have always read about them I never
 expect such disagreeable looking creatures. They had a rough brown hairy skin and some of
-them looked warty. They must have weighed two ton at least. Ere we got them back to Nome
+them looked warty. It must have weighed two ton at least. Ere we got them back to Nome
 to the natives they were getting extremely odiferous—in fact, you could scarcely stay on the
 ship with any degree of comfort unless you had per chance lost your sense of smell.
-Then we went north to a few minutes beyond the 70th degree of latitude and thot [sic] for awhile
-we would go to Wrangell Island where some men from Steffonsons [sic] ship were supposed to be
-stranded but we didn't get there and instead stopped at a small native village at Cape Serdz [sic] in
+
+Then we went north to a few minutes beyond the 70th degree of latitude and thot for awhile
+we would go to Wrangell Island where some men from Steffonsons ship were supposed to be
+stranded but we didn't get there and instead stopped at a small native village at Cape Serdz in
 Siberia. These Eskimo were very primitive. One white squaw man lived there and had for 23
 years. He was a Swede--who else could. Their houses were circular and built up with dirt 2 or
 3 feet and then skins were stretched over it and weighted down with rocks. Inside, the room
@@ -55,32 +57,35 @@ comfortable. The babies were in fur skins with the fur inside and they looked li
 bears with faces. I guess they had never seen white women, not so many at one time anyway.
 We went ashore in 2 life boats and a launch pulling them. On the launch was a six piece band
 playing and the rear of the last life boat was the movie man. 'Twas very thrilling.
+
 The other place we stopped was at Whalen, a trading post in Siberia. There these 'towerists'
 went wild. They rushed helter-skelter, hither and thither, here and there, trying to find
-something to buy. Prices raised right before your eyes. One would but [sic] something for $1.00
+something to buy. Prices raised right before your eyes. One would but something for $1.00
 and the next might have to pay $2.00, $4.00 or $10.00. That made no difference. They had to
-have it. One man I was sort of taking care of, tho [sic] he had his son along for the purpose,
+have it. One man I was sort of taking care of, tho he had his son along for the purpose,
 bought 2 ivory tusks, 1 pup, 2 moccasins, 3 or 4 billikens, 6 or 8 ivory and silver rings, one
 fishing line, hooks, floats, etc. and two bird slings. The slings have rocks at the end and the
 little natives throw them at the flocks of geese and ducks which fly close over the village and
 the slings entangle their wings and legs, sometimes more than one, and they can't fly. They
-come down and the natives capture them. There was more junk brot [sic] aboard than baggage, I
+come down and the natives capture them. There was more junk brot aboard than baggage, I
 do believe. And they say that at the first stop it was worse than here. The red flag was flying
 over Whalen and the Russian soldiers were there—a few, one or two or three, I forget the
 number.
+
 We got home yesterday morning at 5 a.m. but missed the first lighter in so had to stay out
 until 2:30. The girls had prepared a big meal for us and invited up the Hartfords and then let
 us talk. Miss Saville talked quite a bit. Any how if you folks don't like this I don't care, it is
-all I had to write about and I know Buster'ud [sic] listen anyway and I'd soak ole Peter's head if he
+all I had to write about and I know Buster'ud listen anyway and I'd soak ole Peter's head if he
 didn't and Polly would in my lap and I don't know much about the youngest one of yours so
 likely he would be squawling. But we did surely enjoy our trip and were gone just long enuf.
-
 I expect there were 150 passengers on board and almost or more of the crew and helpers. We
-had a stateroom down next to the kitchen and 'twas pretty fierce for odor at times.
+had a stateroom down next to the kitchen and 'twas plenty fierce for odor at times.
+
 I have had jobs nearly all summer but not very much in them. Next week, September 4,
 school opens. I wish they would wait for a week but you know these school men. Wouldn't
 make any special difference I suppose for I would just fritter away the time but still one likes
 to postpone the inevitable.
+
 I just now stopped and re-read your letter and it sure was a bird. I don't especially blame Ray
 for reading over your shoulder. It would seem, then that you have bright children. Maybe
 they do know something about Geography. But it is ridiculous to speak of Louis finishing the
@@ -89,12 +94,17 @@ am rather afraid he doesn't know much. I quite remember your little timid Mauric
 he shifted his affection from his Aunt Om and yelled and howled and screamed steadily for a
 week while his mother went to S.S. Ask him is he recalls this little interview. Do you suppose
 he does?
-Ever hear from Zen? or Inez? They don't seem to be very writing inclined tho [sic] Zen has done
+
+Ever hear from Zen? or Inez? They don't seem to be very writing inclined tho Zen has done
 well this year. Even sent me a telegram a few weeks ago. Well, if anything else ever happens,
-I'll write again. Don't suppose it ever will, tho [sic].
+I'll write again. Don't suppose it ever will, tho.
+
 Lots of love to all,
 Ome
+
 Reprinted from Cochran Chronicles, Volume 9, Number 1, November 1986
+
 © JECFA 1986
+
 Up
 jecochranclan.org ~ Contact webmaster

tests/artifacts/transcriptions/Rod_Moser_Letter_-_p1.jpg.txt

@@ -3,30 +3,28 @@ provider: openrouter
 model: google/gemini-2.5-flash
 ---
 JOHN ISBILL
-
+R. T. MOSER
 ISBILL & MOSER
 DEALERS IN
 GENERAL MERCHANDISE
 
-R. T. MOSER
-
-Vonore, Tenn. January 27- 1913
-Dear [Aunt?] Louisa
-I was not home a
-few nights ago & I received a
-letter from your folks, so
-I decided to write you
-a few lines myself &
-I am contemplating a
+Vonore, Tenn., Jany 27 – 1913
+Dear Uncle Aunt [Living?]
+Was at home a
+few nights ago & saw a
+letter from you folks, So
+I desired to write you
+a few lines myself ok
+I am contemplateing a
 trip out west next summer
-& I want some of others to go
-when I am [there?]
-I am getting
-up in years & unmarried
-so you see the object of
-my trip, is to get a wife
-& there is a lot of old maid
-& widows out there. I
-want you to kiss them
-at my [hand?] for me at [their?]
+& I want some of Elders to go
+when I am [them?] .
+Am getting
+up in years & remarried,
+So you see the object of
+my trip, is to get a wife.
+If there is any old maids
+or widows out there, I
+want you to have them
+at my farm my at they
 as soon as I get there

tests/test_app.py

@@ -26,7 +26,13 @@ class TestAppLifespan:
         calls = []
 
         monkeypatch.setattr("transcription.app.setup_logging", lambda: calls.append("logging"))
-        monkeypatch.setattr("transcription.app.create_all", lambda: calls.append("schema"))
+        monkeypatch.setattr("transcription.app.create_all", lambda **_kwargs: calls.append("schema"))
+        monkeypatch.setattr(
+            "transcription.app.initialize_database_runtime",
+            lambda **_kwargs: type("_Runtime", (), {"engine": object()})(),
+        )
+        monkeypatch.setattr("transcription.app.dispose_database_runtime", lambda: calls.append("dispose_db"))
+        monkeypatch.setattr("transcription.app.should_bootstrap_schema", lambda _settings: True)
         monkeypatch.setattr("transcription.app._start_worker", lambda _app: calls.append("start_worker"))
         monkeypatch.setattr("transcription.app._stop_worker", lambda _app: calls.append("stop_worker"))
 
@@ -48,13 +54,20 @@ class TestAppLifespan:
         assert "schema" in calls
         assert "mkdir" in calls
         assert "start_worker" in calls
+        assert "dispose_db" in calls
 
     def test_shutdown_stops_worker_resources(self, monkeypatch):
         """Shutdown signals and stops worker resources cleanly."""
         calls = []
 
         monkeypatch.setattr("transcription.app.setup_logging", lambda: None)
-        monkeypatch.setattr("transcription.app.create_all", lambda: None)
+        monkeypatch.setattr("transcription.app.create_all", lambda **_kwargs: None)
+        monkeypatch.setattr(
+            "transcription.app.initialize_database_runtime",
+            lambda **_kwargs: type("_Runtime", (), {"engine": object()})(),
+        )
+        monkeypatch.setattr("transcription.app.dispose_database_runtime", lambda: calls.append("dispose_db"))
+        monkeypatch.setattr("transcription.app.should_bootstrap_schema", lambda _settings: True)
         monkeypatch.setattr("transcription.app._start_worker", lambda _app: calls.append("start_worker"))
         monkeypatch.setattr("transcription.app._stop_worker", lambda _app: calls.append("stop_worker"))
 
@@ -72,4 +85,4 @@ class TestAppLifespan:
         with TestClient(app):
             pass
 
-        assert calls == ["start_worker", "stop_worker"]
+        assert calls == ["start_worker", "stop_worker", "dispose_db"]

tests/test_db.py

@@ -1,7 +1,5 @@
 """Tests for transcription.db — schema bootstrap and session factory."""
 
-from unittest.mock import patch
-
 from sqlalchemy import inspect, text
 from sqlmodel import Session, SQLModel, create_engine
 from sqlmodel.pool import StaticPool
@@ -25,7 +23,9 @@ class TestSchemaBootstrap:
         # Ensure models are imported so metadata is populated
         from transcription.models import Document, Job, Transcript  # noqa: F401
 
-        SQLModel.metadata.create_all(engine)
+        import transcription.db as db_module
+
+        db_module.create_all(engine=engine)
 
         inspector = inspect(engine)
         table_names = set(inspector.get_table_names())
@@ -37,41 +37,60 @@ class TestSchemaBootstrap:
 class TestSessionFactory:
     """Verify get_session yields and cleans up sessions."""
 
-    def test_get_session_yields_session(self, monkeypatch):
+    def test_get_session_yields_session(self):
         """get_session() yields a usable Session object."""
-        monkeypatch.setenv("OPENROUTER_API_KEY", "test-key-for-db")
-        # Clear the lru_cache so Settings is re-created with our env var
-        from transcription.config import get_settings
-        get_settings.cache_clear()
-
         engine = _in_memory_engine()
         SQLModel.metadata.create_all(engine)
 
         import transcription.db as db_module
-        with patch.object(db_module, "engine", engine):
-            with db_module.get_session() as session:
-                assert isinstance(session, Session)
 
-        get_settings.cache_clear()
+        with db_module.get_session(engine=engine) as session:
+            assert isinstance(session, Session)
 
-    def test_session_is_closed_after_generator_exit(self, monkeypatch):
+    def test_session_is_closed_after_generator_exit(self):
         """After the context manager exits, the session is closed."""
-        monkeypatch.setenv("OPENROUTER_API_KEY", "test-key-for-db")
-        from transcription.config import get_settings
-        get_settings.cache_clear()
-
         engine = _in_memory_engine()
         SQLModel.metadata.create_all(engine)
 
         import transcription.db as db_module
-        with patch.object(db_module, "engine", engine):
-            with db_module.get_session() as session:
-                # Session is usable inside the context
-                session.execute(text("SELECT 1"))
-                captured = session
+
+        with db_module.get_session(engine=engine) as session:
+            # Session is usable inside the context
+            session.execute(text("SELECT 1"))
+            captured = session
 
         # After exiting, the session's internal connection is released
         # (no active transaction bound to the session)
         assert captured._transaction is None
 
-        get_settings.cache_clear()
+
+class TestBootstrapPolicy:
+    """Verify schema bootstrap policy defaults and overrides."""
+
+    def test_production_defaults_to_no_bootstrap(self):
+        """Production defaults to explicit non-bootstrap startup behavior."""
+        from transcription.config import Settings
+        from transcription.db import should_bootstrap_schema
+
+        settings = Settings(openrouter_api_key="test-key", environment="production")
+        assert should_bootstrap_schema(settings) is False
+
+    def test_development_defaults_to_bootstrap(self):
+        """Development defaults to schema bootstrap for local workflows."""
+        from transcription.config import Settings
+        from transcription.db import should_bootstrap_schema
+
+        settings = Settings(openrouter_api_key="test-key", environment="development")
+        assert should_bootstrap_schema(settings) is True
+
+    def test_explicit_override_wins(self):
+        """Explicit bootstrap_schema_on_startup overrides environment default."""
+        from transcription.config import Settings
+        from transcription.db import should_bootstrap_schema
+
+        settings = Settings(
+            openrouter_api_key="test-key",
+            environment="production",
+            bootstrap_schema_on_startup=True,
+        )
+        assert should_bootstrap_schema(settings) is True