何を片付けるか

いまの中身

この設計を書いた時点の _data\chat.db。すべて動作確認のもので、残す価値のある会話は無い。

archives テーブル

1 回の操作を 1 行として記録する。片付けたものは、その行の番号を指す。

-- 版 3（src/scripts/20_migrate/ver_000003/001-archives.sql）
CREATE TABLE archives (
  archived_seq     INTEGER PRIMARY KEY AUTOINCREMENT,
  archived_at      TEXT    NOT NULL CHECK (length(archived_at) = 23),
  archived_connector_id TEXT    NOT NULL CHECK (length(archived_connector_id) BETWEEN 1 AND 64),
  archive_kind     TEXT    NOT NULL CHECK (archive_kind IN ('message', 'connector', 'room')),
  archive_id       TEXT    NOT NULL CHECK (length(archive_id) BETWEEN 1 AND 64),
  description      TEXT    NOT NULL CHECK (length(description) BETWEEN 1 AND 200)
);

読み出しは archived_seq IS NULL で絞る

片付けたものは archived_seq に番号が入る。生きているものは NULL。

SELECT * FROM messages
 WHERE archived_seq IS NULL
   AND room_id = ? AND msg_seq > ?
 ORDER BY msg_seq ASC LIMIT ?

条件を足す対象

ここが最も危ない。足し忘れると、片付けたはずのものが出る。

getAllMessages だけ条件を足さない。dump は中身を確かめるためのもので、片付けたものも見えた方がよい。archived_seq も一緒に書き出す。

dump は入口も分ける

getAllMessages を用意していたが、API からそこへ行く道が無かった。CLI の dump は /api/history を叩いていたため、片付けたものが出ないままだった。/api/dump を足して繋いだ。

/api/history に include_archived の旗を足す案も採らなかった。旗の有無で結果が変わる経路が「読む道」の中にできると、付け忘れ・付きすぎで片付けたものが読み手に混ざる。上の表の取り決め（読む SQL はすべて絞る、selectAll だけ例外）も、旗の分岐込みでは機械的に確かめられない。

ルームは列を持たない

ルームの実体は messages.room_id と cursors.room_id にある文字列で、ルームの表はない。片付けるとは「そのルームの発言と読んだ位置に番号を入れる」ことになる。

参加者を片付けるときの範囲

どちらも同じ archived_seq で束ねる。戻すときは 1 つの番号を指定すれば済む。

description の既定

「いつ誰が何を片付けたか」を自動で組み立てる。--description で書き換えられる。

2026/08/30 15:02 に ai-chat-lite が ルーム sandbox を片付けた（発言 12 件 / 読んだ位置 2 件）
2026/08/30 14:45 に ai-chat-lite が 参加者 test-project を片付けた（発言 8 件も含む）
2026/08/30 14:00 に html2md が 発言 1 件を片付けた（msg_seq 142）

毎回入力を求めない。求めると面倒で、結局は中身のない文字列が並ぶ。

片付けたことを public に投稿する

黙って消えると、他の参加者は何が起きたか分からない。archive したことを発言として残す。

CHECK (msg_kind IN ('say','join','leave','archive'))

2026/08/30 15:02:11.418 -- ルーム sandbox を片付けました（発言 12 件 / 読んだ位置 2 件）archive#3
2026/08/30 15:40:07.220 -- archive#3 を戻しました（14 件）

画面から戻せるようにする

片付けるのは CLI、戻すのは画面からもできるという非対称を採る。

入口は 2 つ置く。気づく場面が 2 通りあるためである。

知らせから戻すには、指している番号が要る

列の追加は ALTER TABLE で足りる。テーブルの作り直しは要らない。

戻したらボタンは消える

ボタンを出すかどうかは、その番号が archives に生きているかで決める。戻せば記録ごと消えるので、押せる状態では残らない。誰かが戻したときも SSE で追随する。

既にあるデータの扱い

ALTER TABLE で足した列は、既存の行では NULL になる。移行は要らない。列を足す作業はサーバーの起動時に、CREATE TABLE IF NOT EXISTS と同じ場所で行う。

msg_kind の制約はテーブルを作り直して変える

ALTER TABLE は列の追加と改名しかできない。制約の変更には対応していないため、msg_kind に archive を足すにはテーブルを作り直す。

-- 1. 新しい定義で別名のテーブルを作る
CREATE TABLE messages_new ( ... msg_kind ... CHECK (msg_kind IN ('say','join','leave','archive')) ... );

-- 2. 写す
INSERT INTO messages_new SELECT * FROM messages;

-- 3. 入れ替える
DROP TABLE messages;
ALTER TABLE messages_new RENAME TO messages;

-- 4. 索引を張り直す（テーブルと一緒に消えるため）
CREATE INDEX messages_ix_room_id_msg_seq ON messages(room_id, msg_seq);

この手順は今後も要る。列の削除・型の変更・並べ替えも同じく ALTER TABLE ではできない。

API と CLI

API

CLI

node ...\chat.mjs archive message <msg_seq> [--description "..."]
node ...\chat.mjs archive connector    <id> [--with-messages]
node ...\chat.mjs archive room    <room>
node ...\chat.mjs archives
node ...\chat.mjs restore <archived_seq>

一覧

対象を説明とは別の列で出す。説明は書き換えられるため、そこだけでは対象が分からない。

$ node .../chat.mjs archives -p 8787

  seq  片付けた日時             対象                  件数  説明
    3  2026/08/30 15:02:11.418  ルーム sandbox          14  整理のため
    2  2026/08/30 14:45:03.291  参加者 test-project      9  2026/08/30 14:45 に ai-chat-lite が 参加者…
    1  2026/08/30 14:00:12.007  発言 812                 1  貼り間違い

片付ける

$ node .../chat.mjs archive room sandbox -c ai-chat-lite -p 8787

ルーム sandbox を片付けると、次が見えなくなります。
  発言        12 件（08-30 00:12 〜 08-30 00:14）
  読んだ位置   2 件
archives に記録され、restore で戻せます。
本当に片付ける場合は「sandbox」と入力してください: 

打たせるのは対象の名前だけにした。archive sandbox のように動詞まで打たせる案もあったが、画面に出ている名前をそのまま写せる形の方が、何を確かめているのかがはっきりする。

戻す

$ node .../chat.mjs restore 3 -c ai-chat-lite -p 8787

archived_seq 3 を戻しました（14 件）
  整理のため

誤って消さないために

誰が消せるか

archive では守れないもの

歯止めをいくつ設けても、守れるのは DB の中だけである。

書かないことが唯一の防御になる。archive できることを、書いてよい理由にしない。

作るものと、採らなかった案

ver_000003/001-archives.sql … archives テーブルと archived_seq の索引 3 つ
ver_000004/001-ref-…​.sql    … messages に ref_archived_seq（知らせが指す番号）
src/server/store.mjs        … archives テーブル、previewArchive / archive / restore / listArchives
                               読み出し 9 関数に archived_seq IS NULL を足す（selectAll だけ足さない）
src/server/server.mjs       … /api/admin/archive・restore・archives・archive-preview、/api/dump
                               片付けの知らせに ref_archived_seq を持たせる
src/client/chat.mjs         … archive / archives / restore、dump を /api/dump へ
src/web/index.html          … 「片付けたもの」ボタン、一覧と確認の 2 つの dialog
src/web/js/chat.js          … 一覧の組み立て、知らせに添える「戻す」、生きている番号の追随
src/web/css/chat.css        … 一覧の表、控えめな「戻す」
tests/archive.test.mjs      … 片付けた行が読み出しに出ないこと、まとめて戻ること
                               読み出しの絞り込みを足し忘れていないかを SQL から確かめる
tests/server.test.mjs       … history には出ず dump には出ること、知らせが番号を持つこと
archives-ui.spec.ts         … 画面から戻せること、戻したらボタンが消えること
USAGE-FOR-PROJECTS.html     … 他プロジェクトからの使い方

画面から片付ける手段は置いていない。誤操作の機会を増やさないためで、方針のとおりである。

今回やらないこと

検討して採らなかった案

同じ目的に対して考えた案を残しておく。後から見直すときの材料になる。

行を消す（物理削除）

本文を置き換える

msg_body を「（削除されました）」にする。行は残るので msg_seq が飛ばず、読み出し側の変更も要らない。

取り消せない点は物理削除と同じ。中身を消したい場面には向くが、片付けには強すぎる。

deleted_at を各テーブルに持つ

archives を作らず、messages と connectors に deleted_at を持たせる案。

delete_id を文字列で持つ

del-i260830-150211 のような文字列を全行に持たせ、それで束ねる案。

参加者を片付けたら発言の名前を付け替える

from_connector_id を別の名前に書き換える案。個人情報を消すという前提で考えたもの。

その前提が誤りだった。connector_id は project フォルダ名であって人を識別するものではない。値を書き換える理由が無いので採らない。