@interactive-inc/claude-funnel 0.66.0 → 0.68.0

package/README.md

@@ -97,7 +97,7 @@ profiles は起動レシピ。各プロファイルは一意な `name` を持ち
 
 `funnel.json` に書けないものが 2 つある。delivery モード（fanout / exclusive）は CLI で設定する（`funnel.json` のチャネルは fanout 固定）。schedule の cron エントリも CLI で足す（`funnel.json` には schedule コネクタの存在だけ宣言できる）。
 
-セッション再開には `resume` の明示が要る。`funnel.json` の `resume` はデフォルト値を持たず、書かないと再開されない（未指定が false 扱いになる）。前回の claude セッションを引き継ぎたいなら必ず `"resume": true` を書く。再開のための session id は funnel が `~/.funnel/projects/<id>/settings.json` に自動で保存・読み出しするので、`funnel.json` には書かない。
+セッション再開には `resume` の明示が要る。`funnel.json` の `resume` はデフォルト値を持たず、書かないと再開されない（未指定が false 扱いになる）。前回の claude セッションを引き継ぎたいなら必ず `"resume": true` を書く。再開のための session id は funnel が `~/.funnel/projects/<id>/claude/local-sessions.json` に自動で保存・読み出しするので、`funnel.json` には書かない。
 
 ### 使い方
 
@@ -116,9 +116,13 @@ cron 起動を足す（schedule コネクタを宣言したうえで、エント
 bunx fnl channels ops connectors add daily --type=schedule
 bunx fnl channels ops connectors daily schedules add morning \
     --cron="0 9 * * *" --prompt="morning standup"
+bunx fnl channels ops connectors daily schedules add release \
+    --run-at="2026-08-01T09:00:00+09:00" --prompt="release check"
 ```
 
-tick ごとにプロンプトがチャネルへ発火する。9 時にデーモンが落ちていても、次回起動時に逃した枠を catch-up する（`meta.catchup = "true"`、最大 24 時間）。
+cron は一致する tick ごと、一回実行は `run-at` 以降の最初の tick でプロンプトを発火する。発火済みの一回実行は state に記録されるため、設定削除の hook が失敗しても再発火しない。デーモン停止中に逃した枠は次回起動時に catch-up する（`meta.catchup = "true"`。cron の探索は最大 24 時間）。
+
+cron は標準の 5 フィールド規則に従う。day-of-month と day-of-week を両方限定した場合は OR、日曜は `0` と `7` の両方を受け付ける。不正な式は登録時に拒否される。
 
 `funnel.json` を持つリポジトリは自分自身にスコープされる。初回起動時に funnel は `funnel.json` の先頭へ不変の `id`(uuid) を書き戻し、以降このリポジトリの funnel state を `~/.funnel/projects/<id>/` 配下に隔離する。グローバルの `~/.funnel` には一切触らない（イベントログと一時ファイルだけが `/tmp/funnel/` で共有）。このスコープはリポジトリ内で実行する全 CLI コマンドに効く。
 
@@ -300,7 +304,8 @@ Settings   = { channels[], profiles[] }                 → ~/.funnel/settings.j
 ├── gateway.pid                                         デーモン PID
 ├── gateway.token                                       デーモン HTTP / WS の Bearer token
 ├── claude/
-│   └── <profile-id>.pid                                同一プロファイルの二重起動を防ぐ（profile id がキー）
+│   ├── <profile-id>.pid                                同一プロファイルの二重起動を防ぐ（profile id がキー）
+│   └── local-sessions.json                             funnel.json profile の再開用 session id
 └── channels/
     └── <channel-id>/
         └── connectors/
@@ -308,7 +313,7 @@ Settings   = { channels[], profiles[] }                 → ~/.funnel/settings.j
                 └── state.json                          コネクタごとの永続 state（例: schedule の lastFiredAt）
 
 /tmp/funnel/
-├── events.db                                           offset 再生付きの SQLite イベントログ
+├── events/<scope>.db                                   dir + port ごとに分離した offset 再生ログ
 ├── funnel.log                                          診断ログ（デーモンの起動、listener boot、接続）
 └── gateway.log                                         デーモンの stdout/stderr
 ```
@@ -400,7 +405,7 @@ const base = gatewayLoopbackUrl(9743) // → http://127.0.0.1:9743
 ```
 
 - 非ループバック bind（`gatewayServer({ hostname: "0.0.0.0" })`）は token 無しだと `start()` が throw する。前段で自前認証する場合のみ `allowInsecureHost: true`
-- コネクタの token は `botToken` か `botTokenEnv` の片方だけ（両方同時はコンパイルエラー）、event store は `dbPath` か `eventLog` の片方だけ、launch の `resume` は `profileId` がある時だけ指定できる
+- コネクタの token は `botToken` か `botTokenEnv` の片方だけ（両方同時はコンパイルエラー）、event store は `dbPath` か `eventLog` の片方だけ、launch の `resume` は stable な `profileId` がある時だけ指定できる
 
 ### サブエントリ
 
@@ -418,9 +423,29 @@ import { FunnelLocalConfig } from "@interactive-inc/claude-funnel/local-config"
 
 // コネクタの descriptor とスキーマ（Slack / Discord / GitHub / Schedule）
 // descriptor（slackConnector 等）を new Funnel({ connectors: [...] }) に渡す
-import { slackConnector, slackConnectorSchema } from "@interactive-inc/claude-funnel/connectors/slack"
+import {
+  slackConnector,
+  slackConnectorSchema,
+} from "@interactive-inc/claude-funnel/connectors/slack"
+
+// Channel manifest（flume sources を broadcaster に流す宣言的 channel。ConnectorDescriptor 系とは独立）
+import {
+  FunnelChannelSupervisor,
+  timeChannel,
+  defineChannel,
+} from "@interactive-inc/claude-funnel/channel"
 ```
 
+汎用のstructured event logは製品APIから独立したサブエントリです。
+新しいコードではこちらを使います。
+
+```ts
+import { EventLog, MemoryEventLog } from "@interactive-inc/claude-funnel/event-log"
+```
+
+既存の `@interactive-inc/claude-funnel/logger` と `FunnelLog` 系は互換性のため
+維持しています。text diagnostic logも引き続きloggerサブエントリにあります。
+
 ### テスト用のサンドボックス
 
 `Funnel.inMemory()` は全 IO 境界（ディスク / プロセス / clock / UUID）を Memory 実装で配線済みの Funnel を返す。`props` の任意の部分集合で個々の seam を上書きできるので、実 FS や spawn に触れずにテストを書ける。