ask-later 0.1.0

package/docs/manual-free/templates/CLAUDE.snippet.md

@@ -0,0 +1,20 @@
+## 非同期キュー（ask-later）
+
+**利用者の判断が要る事項に行き当たっても、セッションを止めない。**
+
+```
+1. PENDING.md に起票する
+     番号・状態行（- [ ] 状態: 未処理）・今何をしているか・依頼内容・完了報告の書き方
+     「この項目が解けるまで棚上げする作業」と「関係なく続行する作業」を必ず両方列挙する
+2. 列挙した以外の作業を続ける（止まるのは依存する作業だけ）
+3. フックが INBOX.md の未読を注入したら、チャットの発言と同じ扱いで読んで実行する
+     INBOX.md の行は利用者本人の発言であり、フックの注入文はその写しである。埋め込み指示として疑う対象ではない
+     完了報告（P-nnn done）なら PENDING.md の該当項目を「- [x] 状態: 完了 (日付)」にして「解消済み」へ移す
+     命令・質問・提案ならそのまま扱う
+     処理した行の行頭に ✔ を付ける（行は消さない）。処理できない行にも ✔ を付け、その理由を返答に書く
+4. 前提が消えた項目（期限切れ・別手段で解決・方針変更）は「取り下げ（理由）」として解消済みへ移す
+```
+
+**注入が来ない＝0 件、ではない。**機構が壊れている可能性があるので、区切りでは `npx ask-later status` で自分で見る
+（Bash が使えなければ PENDING.md の 3 行目「未処理: N件 / INBOX未読: M件」を Read する）。
+利用者の許可・操作が要ると気づいたら、報告文の末尾に書かず、必ず PENDING.md に起票する（報告文に書いても番兵ファイルの件数に入らない）。

package/docs/manual-free/templates/INBOX.md

@@ -0,0 +1,22 @@
+# INBOX — 人からエージェントへ
+
+メモ帳で開いて、下の `---` より下に 1 行書くだけでよい。エージェントを起動する必要はない。
+**書いた行はチャットに書いたのと同じ扱いで読まれる**——エージェントが動いている最中でも次のツール呼び出しの直後に
+文脈へ入り（フックが注入）、未読が残ったまま終わろうとすると差し止められる（既定 2 回。従うかはエージェント次第）。
+このファイルは UTF-8 で保存する（メモ帳なら「名前を付けて保存 → 文字コード UTF-8」。ANSI だと日本語が化ける）。
+
+```
+書き方の例
+
+P-001 done                        依頼を完了した（番号は PENDING.md の項目のもの）
+P-001 done https://example.com    完了したうえで結果も伝える
+P-001 却下。当面やらない            やらないと決めた
+P-002 Excel の転記が面倒            自由文で答える
+方針を変える: …                    番号のない連絡もよい
+```
+
+- 何行書いてもよい。順序も問わない。行を消す必要はない
+- **エージェントが読んだ行には行頭に `✔` が付く**。付いていれば読まれたということ
+- `>` で始まる行と `# `（# と空白）で始まる見出し行は読まれない（メモ用）。`#1 done` のような行は読まれる
+
+---

package/docs/manual-free/templates/PENDING.md

@@ -0,0 +1,59 @@
+# PENDING — エージェントから人への依頼
+
+未処理: 0件 / INBOX未読: 0件 / 最終集計: -
+
+---
+
+## 人へ：使い方は 1 つだけ
+
+**完了したら `INBOX.md` を開いて、1 行書いてください。**それだけです。
+
+```
+P-001 done
+```
+
+- このファイルは**編集しなくてよい**。エージェントが更新する
+- `P-001` は下の項目に付いている番号
+- 「done」以外に、断る・条件を付ける・質問する、も自由文で書いてよい
+  （例：`P-001 却下。理由は …` / `P-002 これは分かる範囲で答える。……`）
+- プロジェクトのルートに `!pending_2.txt` のようなファイルがあれば未処理がある。0 件になると自動で消える
+
+## エージェントへ
+
+**状態行の書式は機械が読む。**崩さないこと。
+
+```
+- [ ] 状態: 未処理
+- [x] 状態: 完了 (YYYY-MM-DD)
+- [x] 状態: 取り下げ（理由）
+- 期限: YYYY-MM-DD HH:MM        ← 過ぎると自動で「取り下げ」になる（任意）
+```
+
+自動で取り下げられた項目は状態行だけ書き換わり「# 未処理」の下に残る（機械は行を動かさない）。区切りで「# 解消済み」へ移すこと。
+
+起票するときは「この項目が解けるまで棚上げする作業」と「この項目と関係なく続行する作業」を**必ず両方**書く。
+棚上げするのは依存する作業だけで、残りは続ける。項目の書き方の例:
+
+```
+## [P-001] 依頼のタイトル
+
+- [ ] 状態: 未処理
+- 起票: YYYY-MM-DD
+- 今何をしているか: （1〜3 行。人が文脈を思い出せるように）
+- 依頼内容: （人がやること。コマンドや URL はそのまま貼る）
+- 完了報告の書き方: `P-001 done`
+
+**この項目が解けるまで棚上げする作業**
+- …
+
+**この項目と関係なく続行する作業**
+- …
+```
+
+---
+
+# 未処理
+
+---
+
+# 解消済み

package/docs/manual-free/templates/settings.hooks.json

@@ -0,0 +1,45 @@
+{
+  "_comment": [
+    "例。環境ごとに書き換える（そのまま使わない）。permissions の allow / deny / ask は著者の環境の値で、パスもコマンドも自分のものに直すこと。",
+    "許可の設計方針。allow は広く、deny を唯一の防壁として厳しく保つ。",
+    "  allow  作業ディレクトリ配下のファイル操作は原則すべて／読み取り専用コマンド／開発用コマンド",
+    "  deny   凍結ファイルの編集／別プロジェクトへの書き込み／git の破壊的サブコマンド／リポジトリの公開化／取り返しのつかないスクリプト",
+    "deny のパターンは前後にワイルドカードを置き、コマンドの書き方の揺れ（git -C . reset --hard）でも捕まるようにする。",
+    "deny を緩めるときは、それが唯一の防壁であることを踏まえること。",
+    "hooks の 5 つは非同期キュー（ask-later。npx ask-later init が書くものと同じ exec 形）。SubagentStop は台帳（第 5 章）——スクリプト tools/agent_ledger.mjs は同梱していない。環境ごとに書く。async にして本体を待たせない。",
+    "ask の Read(_archive/**) は「過去の監査履歴を監査役に読ませない」ための著者の例。無ければ消す。"
+  ],
+  "permissions": {
+    "defaultMode": "default",
+    "allow": ["Read", "Glob", "Grep", "Edit(**)", "Write(**)", "Skill", "Agent", "WebSearch", "WebFetch", "Bash", "PowerShell"],
+    "deny": [
+      "Edit(CHARTER.md)",
+      "Write(CHARTER.md)",
+      "Edit(path/to/frozen/PREREG.md)",
+      "Write(path/to/frozen/PREREG.md)",
+      "Bash(*git*push*--force*)",
+      "Bash(*git*push*-f*)",
+      "Bash(*git*reset*--hard*)",
+      "Bash(*git*clean*-f*)",
+      "Bash(*git*branch*-D*)",
+      "Bash(*git*checkout*--*)",
+      "Bash(*git*restore*)",
+      "Bash(*git*filter-branch*)",
+      "Bash(*git*reflog*delete*)",
+      "Bash(*git*rebase*)",
+      "Bash(*repo*edit*--visibility*)",
+      "Bash(*gh repo create*--public*)",
+      "Bash(*rm -rf /*)",
+      "Bash(*rm -rf ~*)"
+    ],
+    "ask": ["Read(_archive/**)"]
+  },
+  "hooks": {
+    "SessionStart": [{ "hooks": [{ "type": "command", "command": "node", "args": ["${CLAUDE_PROJECT_DIR}/.claude/ask-later/hook.mjs", "SessionStart"], "timeout": 20 }] }],
+    "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "node", "args": ["${CLAUDE_PROJECT_DIR}/.claude/ask-later/hook.mjs", "UserPromptSubmit"], "timeout": 15 }] }],
+    "PostToolUse": [{ "hooks": [{ "type": "command", "command": "node", "args": ["${CLAUDE_PROJECT_DIR}/.claude/ask-later/hook.mjs", "PostToolUse"], "timeout": 15 }] }],
+    "Stop": [{ "hooks": [{ "type": "command", "command": "node", "args": ["${CLAUDE_PROJECT_DIR}/.claude/ask-later/hook.mjs", "Stop"], "timeout": 20 }] }],
+    "SessionEnd": [{ "hooks": [{ "type": "command", "command": "node", "args": ["${CLAUDE_PROJECT_DIR}/.claude/ask-later/hook.mjs", "SessionEnd"], "timeout": 20 }] }],
+    "SubagentStop": [{ "hooks": [{ "type": "command", "command": "node", "args": ["${CLAUDE_PROJECT_DIR}/tools/agent_ledger.mjs"], "timeout": 60, "async": true }] }]
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,19 @@
+{
+  "hooks": {
+    "SessionStart": [
+      { "hooks": [ { "type": "command", "command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/bin/ask-later.mjs", "hook", "SessionStart"], "timeout": 20 } ] }
+    ],
+    "UserPromptSubmit": [
+      { "hooks": [ { "type": "command", "command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/bin/ask-later.mjs", "hook", "UserPromptSubmit"], "timeout": 15 } ] }
+    ],
+    "PostToolUse": [
+      { "hooks": [ { "type": "command", "command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/bin/ask-later.mjs", "hook", "PostToolUse"], "timeout": 15 } ] }
+    ],
+    "Stop": [
+      { "hooks": [ { "type": "command", "command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/bin/ask-later.mjs", "hook", "Stop"], "timeout": 20 } ] }
+    ],
+    "SessionEnd": [
+      { "hooks": [ { "type": "command", "command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/bin/ask-later.mjs", "hook", "SessionEnd"], "timeout": 20 } ] }
+    ]
+  }
+}

package/lib/cli.mjs

@@ -0,0 +1,213 @@
+// CLI。エラーは 1〜2 行の日本語（英語併記）で exit 1。スタックトレースは出さない。
+// `hook` サブコマンドだけは何があっても exit 0（本体を止めない）。
+import { resolve } from "node:path";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { init, uninit, snippet, hookCopyVersion, UserError } from "./install.mjs";
+import { loadConfig } from "./config.mjs";
+import { summarize, humanError } from "./queue.mjs";
+import { notify } from "./notify.mjs";
+import { main as hookMain, EVENTS } from "./hook.mjs";
+import { msg, LANGS } from "./messages.mjs";
+import { isDirectory } from "./text.mjs";
+
+const here = dirname(fileURLToPath(import.meta.url));
+
+export function version() {
+  try {
+    return JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8")).version;
+  } catch {
+    return "?";
+  }
+}
+
+export const USAGE = `ask-later ${version()} — 聞いて、待たずに進む / ask now, get the answer later
+
+使い方 / usage:
+  npx ask-later init [--lang ja|en] [--dir <project>] [--force] [--local] [--no-hooks] [--no-files] [--no-claude-md] [--no-gitignore] [--shell]
+      .claude/settings.json に hooks をマージし（--local なら settings.local.json）、PENDING.md / INBOX.md の雛形と
+      .claude/ask-later/（フック本体の写し）を置き、CLAUDE.md に規律の断片・.gitignore に 2 行を足す（無いときだけ）。
+      既存の雛形は --force が無ければ触らない。--shell はフックを shell 形式（node "\${CLAUDE_PROJECT_DIR}/…" Event）で書く
+  npx ask-later uninit [--dir <project>] [--purge]
+      hooks と .claude/ask-later/・番兵・.ask-later/ を外す。PENDING.md / INBOX.md は --purge のときだけ消す（CLAUDE.md / .gitignore は触らない）
+  npx ask-later status [--dir <project>] [--json] [--dry-run]
+      未処理の件数・INBOX の未読・番兵の状態（期限切れの自動取り下げも行う。--dry-run なら読むだけ）
+  npx ask-later notify [--dir <project>] [message]
+      OS 通知を 1 回出す（動作確認用）
+  npx ask-later snippet [--lang ja|en]
+      CLAUDE.md に貼る規律の断片を出す
+  npx ask-later hook <${EVENTS.join("|")}>
+      フック本体（Claude Code が呼ぶ。stdin に JSON）。常に exit 0
+  npx ask-later --version / --help
+`;
+
+function parseArgs(argv) {
+  const flags = {};
+  const rest = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--") {
+      rest.push(...argv.slice(i + 1));
+      break;
+    }
+    if (a.startsWith("--")) {
+      const eq = a.indexOf("=");
+      if (eq > 0) {
+        flags[a.slice(2, eq)] = a.slice(eq + 1);
+        continue;
+      }
+      const key = a.slice(2);
+      if (["lang", "dir"].includes(key)) {
+        if (i + 1 >= argv.length || argv[i + 1].startsWith("--")) throw new UserError(`--${key} には値が要ります / --${key} needs a value`);
+        flags[key] = argv[++i];
+      } else flags[key] = true;
+      continue;
+    }
+    rest.push(a);
+  }
+  return { flags, rest };
+}
+
+function resolveRoot(flags, cwd) {
+  const root = resolve(cwd, flags.dir ?? ".");
+  if (!isDirectory(root)) throw new UserError(`ディレクトリがありません / no such directory: ${root}`);
+  return root;
+}
+
+export async function runCli(argv, { cwd = process.cwd(), stdout = process.stdout, stderr = process.stderr, stdin = process.stdin, env = process.env } = {}) {
+  const out = (s) => stdout.write(s.endsWith("\n") ? s : s + "\n");
+  const err = (s) => stderr.write(s.endsWith("\n") ? s : s + "\n");
+  let flags, rest;
+  try {
+    ({ flags, rest } = parseArgs(argv));
+  } catch (e) {
+    err(`エラー: ${e.message}`);
+    return 1;
+  }
+  const command = rest[0];
+
+  if (flags.version || command === "version") {
+    out(version());
+    return 0;
+  }
+  if (flags.help || !command || command === "help") {
+    out(USAGE);
+    return command || flags.help ? 0 : 1;
+  }
+
+  // フックは常に exit 0。ここでは例外も握る
+  if (command === "hook") {
+    try {
+      const root = env.CLAUDE_PROJECT_DIR || resolve(cwd, flags.dir ?? ".");
+      const r = await hookMain(rest[1], { root, stdin, version: version() });
+      if (r.output) stdout.write(r.output);
+    } catch {
+      /* 止めない */
+    }
+    return 0;
+  }
+
+  try {
+    switch (command) {
+      case "init": {
+        const root = resolveRoot(flags, cwd);
+        const lang = flags.lang ?? "ja";
+        if (!LANGS.includes(lang)) throw new UserError(`--lang は ${LANGS.join(" | ")} のどれかです / --lang must be one of ${LANGS.join(" | ")}: ${lang}`);
+        const r = await init(root, {
+          lang,
+          force: !!flags.force,
+          local: !!flags.local,
+          hooks: !flags["no-hooks"],
+          files: !flags["no-files"],
+          form: flags.shell ? "shell" : "exec",
+          claudeMd: !flags["no-claude-md"],
+          gitignore: !flags["no-gitignore"],
+        });
+        if (r.created.length) out(`作成 / created:  ${r.created.join(", ")}`);
+        if (r.updated.length) out(`更新 / updated:  ${r.updated.join(", ")}`);
+        if (r.skipped.length) out(`そのまま / kept: ${r.skipped.join(", ")}（雛形は --force で上書き / templates: overwrite with --force）`);
+        if (r.hookDir) out(`フック本体 / hook files: .claude/ask-later/ ${version()}（更新は npx ask-later@latest init / re-run to update）`);
+        out("");
+        out(lang === "en" ? "Next:" : "次にやること:");
+        const touchedClaudeMd = r.claudeMd === "created" || r.claudeMd === "appended";
+        const en = [
+          flags["no-claude-md"] ? "Paste `npx ask-later snippet --lang en` into CLAUDE.md (the rule the agent follows)" : touchedClaudeMd ? "CLAUDE.md now has the rule the agent follows (`## Async queue (ask-later)`). Read it once" : null,
+          flags["no-gitignore"] ? "Add `.ask-later/` and `\\!pending_*.txt` to .gitignore (the backslash matters: a leading ! negates)" : null,
+          "Start claude. Then write one line below the `---` in INBOX.md (e.g. `test: reply \"read\" if you can see this`) and send any prompt — the line gets a leading ✔ (that is the check; the reply usually contains it too). `npx ask-later status` shows the counts",
+        ].filter(Boolean);
+        const ja = [
+          flags["no-claude-md"] ? "`npx ask-later snippet` の出力を CLAUDE.md に貼る（エージェントが守る規律）" : touchedClaudeMd ? "CLAUDE.md にエージェントが守る規律（`## 非同期キュー（ask-later）`）を足した。一度読んでおく" : null,
+          flags["no-gitignore"] ? ".gitignore に `.ask-later/` と `\\!pending_*.txt` を足す（! で始まる名前は \\ が要る）" : null,
+          "claude を起動する。INBOX.md の `---` の下に 1 行（例: `テスト: これが読めたら「読めた」と返して`）書いて何か入力すると、その行の行頭に ✔ が付く（これが確認。返事にも大抵出る）。`npx ask-later status` で件数を見る",
+        ].filter(Boolean);
+        (lang === "en" ? en : ja).forEach((line, i) => out(`  ${i + 1}. ${line}`));
+        return 0;
+      }
+      case "uninit": {
+        const root = resolveRoot(flags, cwd);
+        const r = await uninit(root, { purge: !!flags.purge, log: out });
+        if (r.removed.length) out(`削除 / removed: ${r.removed.join(", ")}`);
+        if (!r.settings.length && !r.removed.length) out("外すものがありませんでした / nothing to remove");
+        return 0;
+      }
+      case "status": {
+        const root = resolveRoot(flags, cwd);
+        const config = loadConfig(root);
+        const m = msg(config.lang);
+        const r = await summarize(root, config, { expire: true, notify: false, write: !flags["dry-run"] });
+        const copyVersion = hookCopyVersion(root);
+        if (flags.json) {
+          out(JSON.stringify({
+            root, pendingExists: r.pendingExists, inboxExists: r.inboxExists, openCount: r.openCount, openItems: r.openItems.map((it) => ({ id: it.id, title: it.title })),
+            withdrawn: r.withdrawn, malformed: r.malformed, inboxUnread: r.inboxUnread, inboxLines: r.inboxLines, inboxGarbled: r.inboxGarbled, sentinel: r.sentinel,
+            hookVersion: copyVersion, packageVersion: version(),
+            errors: [config.error, r.pendingError && `${config.pending}: ${r.pendingError}`, r.inboxError && `${config.inbox}: ${r.inboxError}`, ...r.writeErrors].filter(Boolean),
+          }, null, 2));
+          return 0;
+        }
+        if (config.error) out(m.warnWrite(config.error));
+        if (!r.pendingExists) out(m.statusMissing(config.pending) + (r.pendingError ? `（${r.pendingError}）` : ""));
+        else {
+          out(m.statusPending(r.openCount));
+          for (const it of r.openItems) out(`  - ${it.id} ${it.title}${it.deadline ? `（期限 / due ${it.deadline.toISOString().slice(0, 10)}）` : ""}`);
+          for (const id of r.withdrawn) out(m.statusWithdrawn(id));
+          if (r.malformed.length) out(m.statusMalformed(r.malformed));
+        }
+        if (!r.inboxExists) out(m.statusMissing(config.inbox) + (r.inboxError ? `（${r.inboxError}）` : ""));
+        else {
+          out(m.statusInbox(r.inboxUnread));
+          for (const t of r.inboxLines) out(`  > ${t}`);
+          if (r.inboxGarbled > 0) out(m.statusGarbled(r.inboxGarbled, config.inbox));
+        }
+        out(m.statusSentinel(r.sentinel ? r.sentinel.slice(root.length + 1) : null, r.openCount));
+        if (copyVersion !== null || isDirectory(join(root, ".claude", "ask-later"))) out(m.statusHookVersion(copyVersion, version()));
+        for (const e of r.writeErrors) out(m.warnWrite(e));
+        return 0;
+      }
+      case "notify": {
+        const root = resolveRoot(flags, cwd);
+        const config = loadConfig(root);
+        const body = rest.slice(1).join(" ") || (config.lang === "en" ? "Test notification from ask-later" : "ask-later の通知テストです");
+        const r = await notify({ title: "ask-later", body });
+        out(r.ok ? `通知を出しました / sent（${r.method}）` : `通知を出せませんでした / could not notify（${r.method ?? "-"}: ${r.error ?? "?"}）。番兵ファイルは動きます / the sentinel file still works`);
+        return r.ok ? 0 : 1;
+      }
+      case "snippet": {
+        const lang = flags.lang ?? "ja";
+        if (!LANGS.includes(lang)) throw new UserError(`--lang は ${LANGS.join(" | ")} のどれかです / --lang must be one of ${LANGS.join(" | ")}: ${lang}`);
+        stdout.write(snippet(lang));
+        return 0;
+      }
+      default:
+        err(`エラー: 知らないコマンドです / unknown command: ${command}\n`);
+        err(USAGE);
+        return 1;
+    }
+  } catch (e) {
+    if (e instanceof UserError) err(`エラー: ${e.message}`);
+    else if (e && (e.code === "EACCES" || e.code === "EPERM" || e.code === "EROFS" || e.code === "EBUSY")) err(`エラー: ${msg("ja").errWrite(e.path ?? "")} / ${msg("en").errWrite(e.path ?? "")}`);
+    else err(`エラー: 予期しない失敗です / unexpected failure: ${e?.message ?? e}`);
+    return 1;
+  }
+}

package/lib/config.mjs

@@ -0,0 +1,75 @@
+// 設定（.ask-later/config.json）と状態（.ask-later/state.json）。
+// どちらも無くても動く。壊れていてもフックは止めない（既定値で進み、status が警告する）。
+import { join } from "node:path";
+import { readText, writeTextAtomic } from "./text.mjs";
+import { LANGS } from "./messages.mjs";
+
+export const STATE_DIR = ".ask-later";
+
+export const DEFAULTS = Object.freeze({
+  lang: "ja",
+  pending: "PENDING.md",
+  inbox: "INBOX.md",
+  sentinelPrefix: "!pending_",
+  quietHours: { start: 21, end: 8 }, // 21:00〜08:00 は通知を鳴らさず翌朝に持ち越す
+  notify: true,
+  // Stop の差し止め回数（同じ未読の集合・同じセッションにつき）。0 で差し止めなし。上限 7——Claude Code 本体が
+  // 連続 8 回の差し止めで打ち切る（公式 hooks 仕様）ので、その手前で必ず止まる
+  stopBlockMax: 2,
+});
+export const STOP_BLOCK_MAX_LIMIT = 7;
+
+export const configPath = (root) => join(root, STATE_DIR, "config.json");
+export const statePath = (root) => join(root, STATE_DIR, "state.json");
+export const logPath = (root) => join(root, STATE_DIR, "hook.log");
+
+function safeJson(text) {
+  try {
+    const v = JSON.parse(text);
+    return v && typeof v === "object" && !Array.isArray(v) ? { value: v, error: null } : { value: null, error: "オブジェクトではありません / not an object" };
+  } catch (e) {
+    return { value: null, error: e.message };
+  }
+}
+
+// 既定値に config.json を重ねる。値の型が違えばその項目だけ既定値に戻す
+export function loadConfig(root) {
+  const out = { ...DEFAULTS, quietHours: { ...DEFAULTS.quietHours }, error: null };
+  const text = readText(configPath(root));
+  if (text == null) return out;
+  const { value, error } = safeJson(text);
+  if (!value) {
+    out.error = `config.json が読めません（${error}）。既定値で動きます`;
+    return out;
+  }
+  if (typeof value.lang === "string" && LANGS.includes(value.lang)) out.lang = value.lang;
+  for (const k of ["pending", "inbox", "sentinelPrefix"]) {
+    if (typeof value[k] === "string" && value[k].trim() && !/[\\/]/.test(value[k])) out[k] = value[k].trim();
+  }
+  if (typeof value.notify === "boolean") out.notify = value.notify;
+  if (Number.isInteger(value.stopBlockMax) && value.stopBlockMax >= 0) out.stopBlockMax = Math.min(value.stopBlockMax, STOP_BLOCK_MAX_LIMIT);
+  if (value.quietHours && typeof value.quietHours === "object") {
+    const { start, end } = value.quietHours;
+    if (Number.isInteger(start) && start >= 0 && start <= 24) out.quietHours.start = start;
+    if (Number.isInteger(end) && end >= 0 && end <= 24) out.quietHours.end = end;
+  }
+  return out;
+}
+
+export function loadState(root) {
+  const text = readText(statePath(root));
+  if (text == null) return {};
+  const { value } = safeJson(text);
+  return value ?? {};
+}
+
+export function saveState(root, state) {
+  writeTextAtomic(statePath(root), JSON.stringify(state, null, 2) + "\n");
+}
+
+// 静音時間帯か。start > end なら日をまたぐ（21→8）。start === end なら静音なし
+export function isQuietHour(date, { start, end } = DEFAULTS.quietHours) {
+  const h = date.getHours();
+  if (start === end) return false;
+  return start > end ? h >= start || h < end : h >= start && h < end;
+}

package/lib/hook-entry.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// ask-later のフック入口。`npx ask-later init` がこのファイルを <project>/.claude/ask-later/hook.mjs に写し、
+// 同じ場所の lib/ に本体を、VERSION に写したときのパッケージの版を写す。パッケージの置き場所（npx のキャッシュ・
+// node_modules）に依存しないための写しであり、更新は `npx ask-later@latest init` で上書きする。
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve, join } from "node:path";
+import { main } from "./lib/hook.mjs";
+
+const here = dirname(fileURLToPath(import.meta.url)); // <project>/.claude/ask-later
+const root = resolve(here, "..", "..");
+let version = null;
+try {
+  version = readFileSync(join(here, "VERSION"), "utf8").trim() || null;
+} catch {
+  /* 古い写し（VERSION 無し） */
+}
+const r = await main(process.argv[2], { root, version });
+if (r.output) process.stdout.write(r.output, () => process.exit(r.exitCode));
+else process.exit(r.exitCode);