HN 日本語サマリー

← 一覧へ戻る
オープンソース

sqlite-utils 4.0rc2、主にClaude Fableによって書かれた(約149.25ドル相当)

sqlite-utils 4.0rc2, mostly written by Claude Fable (for about $149.25) (simonwillison.net)

55 pointsby ognyankulev58 コメント

要約

Simon Willison氏は、AIモデルClaude Fableの支援を受けてsqlite-utilsライブラリのバージョン4.0rc2をリリースした経緯を報告しています。Claude Fableは、バグ修正や機能改善を含む多くのコード変更に貢献し、そのコストは約149.25ドルと見積もられています。このプロセスを通じて、AIによるソフトウェア開発の可能性と、トランザクション処理などのエッジケースに関する知見が深まりました。

全文翻訳

sqlite-utils 4.0rc2、Claude Fable によって(約149.25ドルで)大部分が書かれたリリース

2026年7月5日

数週間前にsqlite-utils 4.0rc1のリリースについて書きました。MaxサブスクリプションでClaude Fableを利用できるのがあと数日しかないため、4.0の安定リリースに本当に自信を持てるように、それが役立つかどうかを確認することにしました。私はSemVerを遵守するように努めており、互換性のないメジャーバージョンはできるだけ少なくしたいと考えています。

iPhone上のClaude Code for webで、このプロンプトから始めました。

Final review before shipping a stable 4.0 release - very important to spot any last minute things that would be a breaking change if we fix them later

これが彼が作成してくれた最初のレポートです。まだ私が自分で遭遇していなかった重大な問題がいくつかありました。Fableが「リリースブロッカー」と分類したものが5つありました。その中でも最悪なのはこれです。

1. delete_where() はコミットされず、コネクションを壊す(データ損失)

Table.delete_where() (sqlite_utils/db.py:2948) は、atomic()ラッパーなしで、単純なself.db.execute()を介してDELETEを実行します。Table.delete() (db.py:2944) は正しくラップしているのと比較してください。コネクションはin_transaction=Trueのままなので、その後のすべてのatomic()呼び出しはセーブポイントブランチ(db.py:430-440)を取り、コミットもされません。

エンドツーエンドで再現可能:

db = sqlite_utils.Database("dw.db")
db["t"].insert_all([{"id": i} for i in range(3)], pk="id")
db["t"].delete_where("id = ?", [0])   # conn.in_transaction は now True
db["t"].insert({"id": 50})
db["u"].insert({"a": 1})
db.close()
# 再オープン:行は [0, 1, 2] です — delete、行50、テーブルuはすべて消えています。

これは本当にひどいバグです!それをリリースしなかったのは非常に幸運でしたが、少なくともそれは5.0に強制するような設計上の欠陥ではなく、4.0.1のポイントリリースで修正できるバグでした。

37回のプロンプト、34回のコミット、30個の別々のファイルで+1,321 -190のコード変更を経て、フィードバックの全セットを順番に処理し、その過程でいくつかの他の設計改善を行いました。

コーディングエージェントの奇妙な点は、このような難しいタスクの方が、同時に他のことを行う機会をより多く提供してくれるということです。なぜなら、エージェントは新しいタスクに取り組むのに10〜15分かかることがあるからです。私はハーフムーンベイの7月4日のパレードを楽しみに出かけ、携帯電話からFableに次のステップを指示するために時折チェックインしていました。

詳細についてはPRとこの共有トランスクリプトをご覧ください。最終レビューのためにラップトップに切り替え、GitHubのPRインターフェースを通じて実施しました。

最も重要な変更はトランザクション処理に関連しており、これは以前のRCの目玉の新機能でした。新しいRCには、新しいトランザクションモデルに関する包括的なドキュメントが含まれています。その導入部分をここに全文引用します。

このライブラリのデータベースに書き込むすべてのメソッド—insert()、upsert()、update()、delete()、delete_where()、transform()、create_table()、create_index()、enable_fts()など—は、独自のトランザクション内で実行され、戻る前にコミットされます。メソッド呼び出しが終了するとすぐに変更はディスクに保存されます。

db = Database("data.db")
db.table("news").insert({"headline": "Dog wins award"})
# 新しい行はすでに保存されています - commit() は不要です

db.execute()で実行される生のSQLについても同様です。書き込みステートメントは、実行されるとすぐにコミットされます。

commit()を呼び出す必要はなく、変更を永続化するためにデータベースを閉じる必要もありません。トランザクションについて考慮する必要があるのは、正確に2つの状況です。

  1. 複数の書き込み操作をグループ化したい場合、それらはすべて成功するか、すべて失敗するかのどちらかです—db.atomic()を使用します。

  2. 自分でトランザクションを管理している場合、db.begin()を使用します。この場合、コミットするまで何もコミットされません—ライブラリは、開いたトランザクションをコミットすることはありません。

Fableのドキュメントを確認していると—ドキュメントの編集内容を最初に確認するのは、何が変更されたかを初期的に理解するための優れた方法だとわかります—この詳細に気づきました。

db.atomic()と自動的なメソッドごとのトランザクションは、Pythonのデフォルトのトランザクション処理モードのコネクション向けに設計されています。Python 3.12+のsqlite3.connect(..., autocommit=True)またはautocommit=Falseオプションで作成されたコネクションはサポートされていません。なぜなら、それらのコネクションではcommit()とrollback()の動作が異なるからです。

私は、sqlite-utilsが、Python 3.12で追加された、より最近のautocommit設定にどのように反応するかを考えていませんでした。「それらのコネクションでは動作が異なる」ということは、ほぼすべてのテストスイートが失敗することを意味しました。そこで、私はモデルと協力して、この違いがライブラリの動作を壊さないようにしました。

そしてGPT-5.5による最終レビュー

あるモデルが別のモデルの作業をレビューするという考えは、ある程度ばかげていると思っていました。それは奇妙に迷信的だと感じられました。問題は、それが実際に機能するということです。私は、Anthropicの最良モデルにOpenAIの作業をレビューさせ、その逆も行うことを習慣にし始めています。なぜなら、それが価値があるほど頻繁に興味深い結果をもたらすことがあったからです。

Codex DesktopとGPT-5.5 xhighに次のようなプロンプトを与えました。

Review changes since the last RC. Also confirm that the changelog is up-to-date.

これにより、調査する価値のある2つの問題が見つかりました。

発見事項

  • [P1] sqlite_utils/db.py:663 db.query() は、db.execute() を呼び出した後でのみ、非行ステートメントを拒否するようになりました。そしてsqlite_utils/db.py:705 は、それらの書き込みを自動的にコミットします。そのため、db.query("update ...") は ValueError を発生させますが、更新はすでにコミットされています。これは、「行を返すSQLのみに使用できる」と文書化されているメソッドにとって、驚くべき副作用です。
  • [P1] sqlite_utils/db.py:672 INSERT ... RETURNING を db.query() 経由で行う場合、コミットは返されたジェネレータが完全に消費されるまで行われません。イテレーションなしのdb.query("insert ... returning ...")、または一般的なnext(db.query(...))の使用は、トランザクションを開いたままにし、クローズ時に書き込みがロールバックされる可能性があります。これはdocs/changelog.rst:15およびdocs/python-api.rst:232と矛盾しており、それらはイテレーションなしで効果があると述べています。

それを新しいFableセッションに貼り付けたところ、問題を確認する実験を実行しました。

両方の発見事項が確認されました。db.query()は最初にself.execute()を呼び出し、書き込みを自動コミットしてからcursor.descriptionをチェックしました。そのため、db.query("update ...")はValueErrorを発生させる前に更新をコミットしました。また、INSERT ... RETURNINGのコミットは返されたジェネレータの末尾にあり、イテレータを完全に消費しない限り決して実行されませんでした。next(db.query(...))またはイテレーションされない呼び出しはトランザクションを開いたままにし、変更履歴とドキュメントが約束していることと矛盾していました。

これが修正を含むPRと、完全なClaude Codeトランスクリプトです。このコードをレビューすることで、SQLiteトランザクションセマンティクスのエッジケースについてのより良いメンタルモデルを構築することができました!

推定(非補助金)コスト149.25ドルで

Fablepocalypse 7月7日までの残りの期間、Fableの利用枠を増やすためにClaude Maxの月額200ドルプラン(以前は月額100ドル)にアップグレードしました。この日以降、Claude Max加入者でさえモデルの全APIコストを支払う必要があります。

直接コストを支払っていた場合、いくらになったのか気になりました。最初は、Web版Claude Codeを使用してリモートで作業していたため、その数値は利用できないと思っていました。しかし、既存のセッション内でAgentsViewを実行して、そのコスト見積もりを取得できることに気づきました!

Run "uvx agentsview --help"​ and then use that tool to calculate the cost of this session

Claudeはsession list --include-childrenコマンドの使い方を理解し、以下の結果を出しました。

トランスクリプトモデルコスト
メインセッションclaude-fable-5$141.02
APIサーフェススイープエージェントclaude-fable-5$2.40
トランザクション/アトミックレビューエージェントclaude-fable-5$2.39
rc1コミット後レビューエージェントclaude-fable-5$1.72
マイグレーションレビューエージェントclaude-fable-5$1.40
プロンプトカウントエージェントclaude-opus-4-8$0.32
合計$149.25

そのサブスクリプションに加入していて本当に良かったです!私は自分のアドバイスに従い、より安価なモデルのサブエージェントにもっと頼るべきでした。

現在、claude.ai/settings/usageに表示されているのは次のとおりです。

[画像: Claudeプラン使用量制限パネルのスクリーンショット:「プラン使用量制限 Max (20x)」;「現在のセッション」で「3時間52分後にリセット」と表示され、進捗バーが「7%使用済み」;「週間制限」の見出しに「使用制限についてさらに詳しく」リンク;「全モデル」で「水曜日 12:00 PMにリセット」と表示され、進捗バーが「32%使用済み」;「Fable」で「水曜日 12:00 PMにリセット」と表示され、進捗バーが「63%使用済み」。]

現在、他にもいくつかの主要なFable主導のプロジェクトを進めており、価格上昇のタイミングでFableバーを100%にすることを目標としています。

sqlite-utils 4.0rc2 の完全なリリースノート

これがRCの完全なリリースノートです。変更が加えられるたびに、Fableに変更履歴の「未リリース」セクションに追加させ、レビューさせました。これにより、変更履歴のコミット履歴がリリースに含まれた各変更の簡潔な要約として機能するという、便利な副作用がありました。

過去にはリリースノートを手書きするという方針でしたが、正直なところ、これらは自分で作成したものよりも優れています。リリースノートは、退屈で予測可能で正確である必要があるため、エージェントにアウトソースすることに抵抗がない執筆の良い例です。

破壊的変更:

  • db.execute() で実行された書き込みステートメントは、トランザクションが既に開いている場合を除き、自動的にコミットされるようになりました。以前は、コミットされるまで開いたままになる暗黙的なトランザクションを開いていましたが、同じコネクションで読み取ると書き込みは機能するように見えましたが、コネクションが閉じられるとサイレントにロールバックされていました。コミットされていないdb.execute()書き込みをロールバックすることに依存していたコードは、最初に明示的なトランザクションを開くために新しいdb.begin()メソッドを使用する必要があります。トランザクションモデルはトランザクションと変更の保存で完全に文書化されています。
  • db.query() は、返されたジェネレータが最初にイテレートされるのを待つのではなく、呼び出されたときにすぐにSQLを実行するようになりました。行はイテレーション中に遅延してフェッチされます。SQLエラーは呼び出しサイトで発生するようになり、INSERT ... RETURNINGのようなステートメントは結果をイテレートする必要なくすぐに実行およびコミットされ、行を返さないステートメント(以前はサイレントな no-op)は、代わりにdb.execute()を推奨するValueErrorを発生させるようになりました。この方法で拒否されたステートメントは、エラーが発生する前にロールバックされるため、データベースに影響を与えません。
  • Python APIの検証エラーは、AssertionErrorの代わりにValueErrorを発生させるようになりました。以前は、無効な引数(例:列のないcreate_table()、存在しないテーブルでのtransform()、またはignore=Trueとreplace=Trueの両方を渡すこと)は、Pythonが-Oフラグで実行されたときにサイレントにスキップされる生のassertステートメントを使用して拒否されていました。これらのケースでAssertionErrorをキャッチしていたコードは、代わりにValueErrorをキャッチする必要があります。
  • table.upsert()およびtable.upsert_all()は、レコードがプライマリキー列の値を持っていない場合、またはそのいずれかの値がNoneである場合に、PrimaryKeyRequiredを発生させるようになりました。以前は、そのようなレコード(既存の行と一致することが決してない)は、サイレントに新しい行として挿入されるか、挿入が既に発生した後に混乱を招くKeyErrorを引き起こしていました。
  • db.enable_wal()およびdb.disable_wal()は、トランザクションが開いている間に呼び出された場合、sqlite_utils.db.TransactionErrorを発生させるようになりました。以前は、ジャーナルモードを変更する副作用として開いているトランザクションをサイレントにコミットしていましたが、db.atomic()およびユーザー管理トランザクションのロールバック保証を壊していました。
  • Viewクラスにはenable_fts()メソッドがなくなりました。これは、ビューではフルテキスト検索がサポートされていないため、NotImplementedErrorを発生させるためだけに存在していました。それを呼び出すと、代わりにAttributeErrorが発生し、メソッドはAPIリファレンスに表示されなくなりました。sqlite-utils enable-ftsコマンドは、ビューを指した場合にクリーンなエラーを表示します。
  • insertおよびupsertコマンドから、機能しない-d/--detect-typesフラグが削除されました。タイプ検出は、4.0a1以降CSV/TSVデータではデフォルトであったため、フラグは何も行いませんでした。それを使用する呼び出しは、単にそれを削除すべきです。--no-detect-typesは引き続き検出を無効にするために利用可能です。
  • Database()は、Python 3.12+のsqlite3.connect(..., autocommit=True)またはautocommit=Falseオプションで作成されたコネクションが渡された場合、sqlite_utils.db.TransactionErrorを発生させるようになりました。それらのコネクションではcommit()とrollback()の動作が異なるため、以前はライブラリによって行われたすべての書き込みがコネクションが閉じられたときにサイレントに破棄されていました。

その他すべて:

  • table.delete_where()、table.optimize()、table.rebuild_fts()が変更をコミットせず、コネクションをオープンなトランザクション内に残していたバグを修正しました。それらの作業(およびその後のすべての書き込み)は、コネクションが閉じられたときにサイレントにロールバックされる可能性がありました。これら3つはすべて、他の書き込みメソッドと一貫してdb.atomic()を使用するようになりました。
  • sqlite-utils drop-tableコマンドは、ビューをドロップすることを拒否するようになり、drop-viewはテーブルをドロップすることを拒否するようになりました。以前は、名前が一致した場合、それぞれがサイレントに間違ったタイプのオブジェクトをドロップしていました。どちらも現在、正しいコマンドを使用するように促すエラーで終了します。
  • 新しいマイグレーションシステムによって適用されるマイグレーションは、マイグレーションが適用された記録とともに、トランザクション内で実行されるようになりました。マイグレーションが例外を発生させた場合、その変更はロールバックされ、保留中のままになります。そのため、エラーが修正された後に安全に再適用できます。トランザクション内で実行できないマイグレーション(例:VACUUMを実行するもの)は、@migrations(transactional=False)を使用してオプトアウトできます。マイグレーションとトランザクションを参照してください。
  • table.upsert()およびtable.upsert_all()は、既存テーブルのプライマリキーまたは複合プライマリキーを検出するようになったため、プライマリキーを持つテーブルにupsertする場合、pk=引数はもはや必要ありません。
  • db.table(table_name).insert({})を使用して、既存のテーブルにデフォルト値のみで構成される行を、INSERT INTO ... DEFAULT VALUESを使用して挿入できるようになりました。(#759)
  • sqlite-utils migrateコマンドの改善:--stop-beforeの値で既知のマイグレーションに一致しないものは、サイレントに無視されるのではなくエラーになりました。--stop-beforeは、古いsqlite_migrate.Migrationsクラスを使用しているマイグレーションファイルでも正しく機能するようになりました。--listは読み取り専用操作になり、データベースファイルやマイグレーション追跡テーブルを作成しなくなりました。migrations.applied()は、適用された順序でマイグレーションを返すようになりました。
  • db.begin()、db.commit()、db.rollback()の新しいメソッドにより、db.atomic()コンテキストマネージャの代替として、トランザクションを手動で制御できるようになりました。
  • 新しいドキュメント:トランザクションと変更の保存は、トランザクションの仕組みと変更がいつコミットされるかを説明しており、新しいアップグレードページでは、メジャーバージョン間の移行に必要な変更を詳述しています。