@clubs.place/cli 0.1.25 → 0.1.26

package/src/hermes-cron.live.test.mjs

@@ -0,0 +1,97 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { spawnSync, execSync } from "node:child_process";
+import {
+  HERMES_CRON_JOB_NAME,
+  HERMES_CRON_SCHEDULE,
+  cronScriptPath,
+  markerPath,
+  installHermesCron,
+  removeHermesCron,
+  statusHermesCron,
+} from "./hermes-cron.mjs";
+
+/* 実 `hermes cron` API を隔離 HERMES_HOME で一度だけ通す。実運用の
+ * ~/.hermes には触らない（HERMES_HOME を temp に向けた実バイナリ呼び出し）。
+ * ジョブ格納（jobs.json）だけを使い、実スケジューラの起動は要らない。
+ * install→install（冪等・1件）→status→remove→読み返し、を実 API で確認する。
+ * hermes バイナリが無ければ skip（壊さない）。 */
+
+const hermesBin = () => process.env.HERMES_BIN || "hermes";
+
+const haveHermes = (() => {
+  try {
+    execSync(`command -v ${hermesBin()} 2>/dev/null`);
+    return true;
+  } catch {
+    return false;
+  }
+})();
+
+const realRunner = (hhome) => (args) => {
+  try {
+    const r = spawnSync(hermesBin(), args, {
+      env: { ...process.env, HERMES_HOME: hhome },
+      encoding: "utf8",
+      timeout: 180_000,
+    });
+    return { status: r.status ?? 1, stdout: r.stdout ?? "", stderr: r.stderr ?? "" };
+  } catch (e) {
+    return { status: 1, stdout: "", stderr: e.message };
+  }
+};
+
+const sameNameJobs = (hhome) => {
+  const d = JSON.parse(readFileSync(join(hhome, "cron", "jobs.json"), "utf8"));
+  return (d.jobs ?? []).filter((j) => j?.name === HERMES_CRON_JOB_NAME);
+};
+
+test("実 cron API: install→二度目→status→remove（隔離 HERMES_HOME）", { skip: !haveHermes }, () => {
+  const home = mkdtempSync(join(tmpdir(), "nippo-live-home-"));
+  writeFileSync(join(home, ".env"), "SOURCE=hermes\n");
+  const hhome = mkdtempSync(join(tmpdir(), "nippo-live-hermes-"));
+  const runner = realRunner(hhome);
+
+  const r1 = installHermesCron({
+    home,
+    hermesHome: hhome,
+    npxPath: "/usr/bin/npx",
+    hermesBinDir: "/usr/bin",
+    runner,
+  });
+  assert.equal(r1.ok, true, `初回 install: ${r1.reason ?? ""}`);
+  assert.equal(r1.created, true);
+  let jobs = sameNameJobs(hhome);
+  assert.equal(jobs.length, 1, "同名ジョブは1件");
+  assert.equal(jobs[0].no_agent, true);
+  assert.equal(jobs[0].script, "clubs-nippo-hermes-tick.sh");
+  assert.equal(jobs[0].deliver, "local");
+  assert.equal(jobs[0].enabled, true);
+  assert.equal(jobs[0].schedule?.expr, HERMES_CRON_SCHEDULE);
+  assert.ok(existsSync(cronScriptPath(hhome)), "script が実 HERMES_HOME に書かれる");
+  assert.match(readFileSync(cronScriptPath(hhome), "utf8"), /tick --only=hermes/);
+
+  const r2 = installHermesCron({
+    home,
+    hermesHome: hhome,
+    npxPath: "/usr/bin/npx",
+    hermesBinDir: "/usr/bin",
+    runner,
+  });
+  assert.equal(r2.ok, true, `二度目 install: ${r2.reason ?? ""}`);
+  assert.equal(r2.created, false);
+  jobs = sameNameJobs(hhome);
+  assert.equal(jobs.length, 1, "二度目も1件のまま（重複なし）");
+
+  const st = statusHermesCron({ home, hermesHome: hhome });
+  assert.equal(st.state, "ok", `status: ${st.hint ?? ""}`);
+
+  const rm = removeHermesCron({ home, hermesHome: hhome, runner });
+  assert.equal(rm.ok, true, `remove: ${rm.reason ?? ""}`);
+  assert.equal(sameNameJobs(hhome).length, 0, "読み返して消えている");
+  assert.equal(existsSync(markerPath(home)), false, "印も消える");
+  assert.equal(statusHermesCron({ home, hermesHome: hhome }).state, "unmanaged");
+});

package/src/hermes-cron.mjs

@@ -0,0 +1,421 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync, unlinkSync } from "node:fs";
+import { join, dirname, basename } from "node:path";
+import { homedir } from "node:os";
+import { listProfiles, readEnvFile } from "./profiles.mjs";
+
+/**
+ * Hermes ネイティブ cron（script-only tick）の管理。
+ *
+ * 考え方: Hermes cron のジョブは LLM 抜き（--no-agent）で毎時スクリプトを
+ * 走らせるだけ。スクリプトが `clubs-nippo tick --only=hermes` を呼び、tick
+ * の中で `hermes chat`（既定モデル・pin なし）が本文を書く。LLM 呼び出しは
+ * 生成の1回だけ——エージェント実行と生成の二重 LLM は無い。
+ *
+ * 使うモデルは発火時の Hermes main 設定。中で呼ぶ `hermes chat` に -m/--model
+ * を付けないので、cron 側の model pin（per-job pin・cron.model）は中の生成
+ * には効かない。main の既定に追従する。冪等の正は CLUBS サーバ側の
+ * due/reportDate/delivered（collector-config）が持つ。
+ *
+ * 変更は公式 `hermes cron` CLI 経由だけ。jobs.json には書かない（読むだけ）。
+ * `hermes cron` の終了符号は信用しない（失敗でも exit 0 のことがある）ので、
+ * jobs.json を読み返して確認する。
+ * hermes CLI が無い環境では {ok:false} を返す（黙って Claude に落とさない）。
+ *
+ * ジョブ名・スクリプト名は HERMES_HOME ごとに1つ（シングルトン）。複数の
+ * CLUBS 設定（root＋並べた分）は tick 側の fanout（--only と子プロセス）で
+ * 担い、スクリプトはつねに基底 home（agents/ を含む側）に束縛する。子の
+ * home で install しても子の home には束縛しない（resolveBaseHome）。
+ */
+
+export const HERMES_CRON_JOB_NAME = "clubs-nippo-hermes";
+export const HERMES_CRON_SCHEDULE = "0 * * * *";
+export const HERMES_CRON_DELIVER = "local";
+export const MARKER_FILE = ".hermes-cron.json";
+export const SCRIPT_REL = "clubs-nippo-hermes-tick.sh";
+export const SCHEDULER_ENV = "CLUBS_NIPPO_SCHEDULER";
+export const SCHEDULER_HERMES_CRON = "hermes-cron";
+export const CLUBS_HOME_ENV = "CLUBS_NIPPO_HOME";
+export const HERMES_HOME_ENV = "HERMES_HOME";
+
+export const hermesHomeDir = (env = process.env) => env.HERMES_HOME || join(homedir(), ".hermes");
+export const cronScriptRel = () => SCRIPT_REL;
+export const cronScriptPath = (hermesHome) => join(hermesHome, "scripts", SCRIPT_REL);
+export const markerPath = (home) => join(home, MARKER_FILE);
+
+export const readMarker = (home) => {
+  try {
+    return JSON.parse(readFileSync(markerPath(home), "utf8"));
+  } catch {
+    return null;
+  }
+};
+
+/** シェル1語を一重引用符で固める（空白・'・$・`・改行も無害化）。 */
+export const shQuote = (s) => `'${String(s ?? "").replace(/'/g, `'\\''`)}'`;
+
+const homeSources = (dir) => {
+  const raw = readEnvFile(join(dir, ".env")).SOURCE ?? "claude-code,cowork";
+  return String(raw).split(",").map((s) => s.trim()).filter(Boolean);
+};
+
+const writeMarker = (dir, job = "hermes-cron") => {
+  writeFileSync(markerPath(dir), JSON.stringify({ job, script: SCRIPT_REL, installedAt: new Date().toISOString() }) + "\n", "utf8");
+};
+
+/**
+ * 子の home（<base>/agents/<id>/.env のある階層）で呼ばれたら基底 home に
+ * 戻す。基底に .env が無い形では何もしない（独自 home の明示指定を壊さない）。
+ * スクリプトの束縛も印もつねに基底だけ——子に束縛すると基底の hermes が
+ * 動かなくなる。
+ */
+export const resolveBaseHome = (home) => {
+  if (basename(dirname(home)) === "agents") {
+    const base = dirname(dirname(home));
+    if (existsSync(join(base, ".env"))) return base;
+  }
+  return home;
+};
+
+/**
+ * OS 側 tick（crontab/launchd）がこの設定を飛ばすべきか。印（hermes-cron
+ * 管理）があり、かつ今回の実行が hermes-cron 経由でないときだけ飛ばす。
+ * 同じ設定への二重 tick（OS + Hermes）を避けるためのもの。
+ */
+export const shouldSkipTick = (home, { scheduler } = {}) => {
+  if (!existsSync(markerPath(home))) return { skip: false };
+  if (scheduler === SCHEDULER_HERMES_CRON) return { skip: false };
+  return {
+    skip: true,
+    reason: `hermes-cron 管理のため OS 側 tick では飛ばします（${markerPath(home)}）`,
+  };
+};
+
+/**
+ * Hermes cron が毎時走らせるスクリプト。tick の出力を日誌に残し、
+ *   - 失敗（tick 非ゼロ）→ 出して非ゼロ終了（Hermes が失敗として記録）
+ *   - 発火（配信した）→ 出してゼロ終了（配信として届く）
+ *   - それ以外（発火せず）→ 黙ってゼロ終了（--no-agent は空出力＝静寂）
+ *
+ * home とスケジューラ所有者の hermesHome を束縛する。収集・生成では .env が優先。
+ * tickCmd 以外の埋め込みはすべて一重引用符で固める。
+ */
+export const buildTickScript = ({
+  home,
+  hermesHome,
+  npxPath,
+  tickCmd = npxPath ? defaultTickCmd(npxPath) : "",
+  hermesBinDir = "",
+  logPath,
+}) => `#!/usr/bin/env bash
+# CLUBS 日報 tick（Hermes ネイティブ cron 用・${HERMES_CRON_JOB_NAME} が毎時実行）。
+# 生成は中の \`hermes chat\`（既定モデル・pin なし）が1回だけ行う。
+set -u
+export ${SCHEDULER_ENV}=${SCHEDULER_HERMES_CRON}
+${home ? `export ${CLUBS_HOME_ENV}=${shQuote(home)}\n` : ""}${hermesHome ? `export CLUBS_NIPPO_SCHEDULER_HERMES_HOME=${shQuote(hermesHome)}\nunset HERMES_HOME\n` : ""}${hermesBinDir ? `export PATH=${shQuote(hermesBinDir)}:"$PATH"\n` : ""}OUT=$(${tickCmd} 2>&1)
+CODE=$?
+mkdir -p "$(dirname ${shQuote(logPath)})" 2>/dev/null || true
+printf '%s\\n' "$OUT" >> ${shQuote(logPath)} 2>/dev/null || true
+if [ "$CODE" -ne 0 ]; then
+  printf '%s\\n' "$OUT" | tail -n 20
+  exit "$CODE"
+fi
+if printf '%s\\n' "$OUT" | grep -q '\\[tick\\] 発火:'; then
+  printf '%s\\n' "$OUT"
+fi
+exit 0
+`;
+
+const defaultRunner = (hermesBin) => (args) => {
+  try {
+    const r = spawnSync(hermesBin, args, { encoding: "utf8", timeout: 30_000 });
+    return { status: r.status ?? 1, stdout: r.stdout ?? "", stderr: r.stderr ?? "" };
+  } catch (e) {
+    return { status: 1, stdout: "", stderr: e.message };
+  }
+};
+
+const readJobs = (hermesHome) => {
+  try {
+    const d = JSON.parse(readFileSync(join(hermesHome, "cron", "jobs.json"), "utf8"));
+    return Array.isArray(d?.jobs) ? d.jobs : [];
+  } catch {
+    return [];
+  }
+};
+
+const findJobById = (hermesHome, id) => readJobs(hermesHome).find((j) => j?.id === id) ?? null;
+
+const findJobsByName = (hermesHome, name = HERMES_CRON_JOB_NAME) =>
+  readJobs(hermesHome).filter((j) => j?.name === name);
+
+/**
+ * 望むジョブ像: 同名・script-only（--no-agent）・毎時・deliver local・有効。
+ * 名前だけの一致では受け入れない（停止中・別スクリプト・agent 付きの同名
+ * ジョブに印を付けて OS 側を止めると、日報が黙って止まる）。
+ */
+export const jobSpecMatches = (job) => {
+  if (!job || job.name !== HERMES_CRON_JOB_NAME) return false;
+  if (job.no_agent !== true) return false;
+  if (job.script !== SCRIPT_REL) return false;
+  if (job.deliver !== HERMES_CRON_DELIVER) return false;
+  if (job.enabled !== true) return false;
+  const expr = job.schedule?.expr ?? (typeof job.schedule === "string" ? job.schedule : "");
+  if (expr !== HERMES_CRON_SCHEDULE) return false;
+  return true;
+};
+
+/** 印（marker.job＝ジョブ ID）が今の実ジョブを指しているか。 */
+export const resolveMarkedJob = (hermesHome, marker) => {
+  if (!marker?.job) return null;
+  const byId = findJobById(hermesHome, marker.job);
+  if (byId) return byId;
+  // 旧い印（名前だけ）: 同名が1つだけならそれとみなす。複数・不一致は drift。
+  if (marker.job === HERMES_CRON_JOB_NAME) {
+    const same = findJobsByName(hermesHome);
+    if (same.length === 1) return same[0];
+  }
+  return null;
+};
+
+const defaultTickCmd = (npxPath) => `${shQuote(npxPath)} -y @clubs.place/cli@latest tick --only=hermes`;
+const defaultLogPath = (home) => join(home, "out", "hermes-cron.log");
+
+const REPAIR_HINT = "`clubs-nippo hermes-cron install` で直すか、`remove` で印を消してください。";
+
+/**
+ * Hermes ネイティブ cron を入れる（冪等）。同名ジョブの扱い:
+ *   - 無い → 公式 create → 読み返して像を確認（exit 0 だけでは信じない）
+ *   - 1つ＋像どおり → 作り直さない
+ *   - 1つ＋像ちがい（停止中・別スケジュール等）→ 公式 edit/resume で直して読み返し確認。
+ *     prompt 付き（利用者の agent ジョブが同名）は触らず失敗にする
+ *   - 複数 → どれが自分のものか分からないので触らず失敗にする
+ * 失敗したら印は付けない（OS 側を止めない）。
+ * hermes CLI が無い環境では失敗を返す（OS cron への黙った切替はしない）。
+ */
+export const installHermesCron = ({
+  home,
+  hermesHome = hermesHomeDir(),
+  hermesBin = process.env.HERMES_BIN || "hermes",
+  npxPath,
+  hermesBinDir = "",
+  runner = defaultRunner(hermesBin),
+  tickCmd,
+  logPath,
+} = {}) => {
+  if (!home) return { ok: false, reason: "home（CLUBS_NIPPO_HOME）が必要です" };
+  home = resolveBaseHome(home);
+  if (!logPath) logPath = defaultLogPath(home);
+  if (!npxPath) return { ok: false, reason: "npx のフルパスが必要です（cron の細い PATH 対策）" };
+  const scriptFile = cronScriptPath(hermesHome);
+  mkdirSync(dirname(scriptFile), { recursive: true });
+  writeFileSync(
+    scriptFile,
+    buildTickScript({ home, hermesHome, npxPath, tickCmd, hermesBinDir, logPath }),
+    "utf8",
+  );
+  chmodSync(scriptFile, 0o755);
+
+  const same = findJobsByName(hermesHome);
+  let jobId;
+  let created = false;
+  let repaired = false;
+  if (same.length === 0) {
+    const made = runner([
+      "cron",
+      "create",
+      HERMES_CRON_SCHEDULE,
+      "--name",
+      HERMES_CRON_JOB_NAME,
+      "--deliver",
+      HERMES_CRON_DELIVER,
+      "--script",
+      SCRIPT_REL,
+      "--no-agent",
+    ]);
+    if (made.status !== 0) {
+      return { ok: false, reason: `hermes cron create に失敗しました（${(made.stderr || made.stdout || "").trim().slice(0, 300)}）` };
+    }
+    const job = findJobsByName(hermesHome)[0] ?? null;
+    if (!job || !jobSpecMatches(job)) {
+      return { ok: false, reason: "hermes cron create は終わりましたが望むジョブ像を確認できません（jobs.json を読み返しました）" };
+    }
+    jobId = job.id;
+    created = true;
+  } else if (same.length === 1 && jobSpecMatches(same[0])) {
+    jobId = same[0].id;
+  } else if (same.length === 1) {
+    const target = same[0];
+    if (target.prompt) {
+      return {
+        ok: false,
+        reason: `同名のジョブ（${target.id}）は利用者の agent ジョブの疑いがあるため触りません（prompt 付き）。名前を変えるか手で直してください。`,
+      };
+    }
+    const edit = runner([
+      "cron",
+      "edit",
+      target.id,
+      "--schedule",
+      HERMES_CRON_SCHEDULE,
+      "--script",
+      SCRIPT_REL,
+      "--no-agent",
+      "--deliver",
+      HERMES_CRON_DELIVER,
+    ]);
+    if (edit.status !== 0) {
+      return { ok: false, reason: `hermes cron edit に失敗しました（${(edit.stderr || edit.stdout || "").trim().slice(0, 300)}）` };
+    }
+    if (!target.enabled) {
+      const resumed = runner(["cron", "resume", target.id]);
+      if (resumed.status !== 0) {
+        return { ok: false, reason: `hermes cron resume に失敗しました（${(resumed.stderr || resumed.stdout || "").trim().slice(0, 300)}）` };
+      }
+    }
+    const job = findJobById(hermesHome, target.id);
+    if (!job || !jobSpecMatches(job)) {
+      return { ok: false, reason: "hermes cron edit は終わりましたが望むジョブ像を確認できません（jobs.json を読み返しました）" };
+    }
+    jobId = job.id;
+    repaired = true;
+  } else {
+    return {
+      ok: false,
+      reason: `同名のジョブが ${same.length} 件あります（${same.map((j) => j.id).join(", ")}）。どれとも決められないので触りません。不要なものを手で消してから入れ直してください。`,
+    };
+  }
+
+  // 印は hermes 収集元の家だけに付ける（他 AI の OS 実行を止めない）。
+  if (homeSources(home).includes("hermes")) writeMarker(home, jobId);
+  return { ok: true, created, ...(repaired ? { repaired: true } : {}), job: jobId };
+};
+
+/** Hermes ネイティブ cron を外す（印を消す・script は残す＝入れ直しが冪等）。 */
+export const removeHermesCron = ({
+  home,
+  hermesHome = hermesHomeDir(),
+  hermesBin = process.env.HERMES_BIN || "hermes",
+  runner = defaultRunner(hermesBin),
+} = {}) => {
+  const marker = readMarker(home);
+  let targetId = null;
+  if (marker?.job) {
+    const job = resolveMarkedJob(hermesHome, marker);
+    if (!job) {
+      // 正確な ID と script を持つ所有印だけ回復する。読めない jobs.json は
+      // 「削除済み」の証拠にならない。旧い名前だけの印も曖昧なので残す。
+      let jobs;
+      try {
+        const data = JSON.parse(readFileSync(join(hermesHome, "cron", "jobs.json"), "utf8"));
+        jobs = Array.isArray(data) ? data : data.jobs;
+      } catch { /* 確認不能 */ }
+      if (marker.script === SCRIPT_REL && typeof marker.job === "string" &&
+          marker.job !== HERMES_CRON_JOB_NAME &&
+          Array.isArray(jobs) && !jobs.some((j) => j?.id === marker.job)) {
+        unlinkSync(markerPath(home));
+        return { ok: true, removed: false };
+      }
+      return {
+        ok: false,
+        reason: `印のジョブ（${marker.job}）が Hermes 側にありません。${REPAIR_HINT}`,
+      };
+    }
+    targetId = job.id;
+  } else {
+    const same = findJobsByName(hermesHome);
+    if (same.length === 0) return { ok: true, removed: false };
+    if (same.length > 1) {
+      return {
+        ok: false,
+        reason: `印が無く同名のジョブが ${same.length} 件あります（${same.map((j) => j.id).join(", ")}）。手で消してください。`,
+      };
+    }
+    targetId = same[0].id;
+  }
+  const target = findJobById(hermesHome, targetId);
+  if (!target || target.name !== HERMES_CRON_JOB_NAME ||
+      target.script !== SCRIPT_REL || target.no_agent !== true || target.prompt) {
+    return { ok: false, reason: "所有する script-only ジョブと確認できないため触りません。" };
+  }
+  const removed = runner(["cron", "remove", targetId]);
+  if (removed.status !== 0) {
+    return { ok: false, reason: `hermes cron remove に失敗しました（${(removed.stderr || removed.stdout || "").trim().slice(0, 300)}）` };
+  }
+  if (findJobById(hermesHome, targetId)) {
+    return { ok: false, reason: `hermes cron remove は終わりましたがジョブ（${targetId}）が残っています（jobs.json を読み返しました）` };
+  }
+  try {
+    unlinkSync(markerPath(home));
+  } catch {
+    /* 印が無いのは正常 */
+  }
+  return { ok: true, removed: true };
+};
+
+/** ok（管理中・job 在り・像どおり）/ drift（印はあるが job が無い・像ちがい）/ unmanaged。 */
+export const statusHermesCron = ({ home, hermesHome = hermesHomeDir() } = {}) => {
+  const marker = readMarker(home);
+  if (!marker) return { state: "unmanaged" };
+  const job = resolveMarkedJob(hermesHome, marker);
+  if (!job) {
+    return {
+      state: "drift",
+      hint: `印のジョブ（${marker.job}）が Hermes 側にありません。${REPAIR_HINT}`,
+    };
+  }
+  if (!jobSpecMatches(job)) {
+    const why = !job.enabled
+      ? "停止中（paused）"
+      : job.no_agent !== true
+        ? "agent 付き（--no-agent ではない）"
+        : job.script !== SCRIPT_REL
+          ? `別スクリプト（${job.script}）`
+          : `別スケジュール・配信先（${job.schedule?.expr ?? job.schedule}・${job.deliver}）`;
+    return {
+      state: "drift",
+      job: job.id,
+      hint: `ジョブ（${job.id}）は${why}です。${REPAIR_HINT}`,
+    };
+  }
+  return { state: "ok", job: job.id };
+};
+
+/**
+ * init 時のスケジューラ割り振り。hermes だけの設定は hermes-cron に一本化し
+ * OS 側と重ねない。混成は両方（OS が全体・hermes-cron が --only=hermes を担い、
+ * 印で OS 側の二重実行を止める）。hermes CLI が無ければ OS に倒して警告する
+ * （黙って Claude に落とさない＝生成器の既定は hermes のまま）。
+ */
+export const planScheduler = ({ sources = [], hermesAvailable = false } = {}) => {
+  const list = sources.map((s) => String(s).trim()).filter(Boolean);
+  const hasHermes = list.includes("hermes");
+  const onlyHermes = hasHermes && list.every((s) => s === "hermes");
+  if (onlyHermes && hermesAvailable) return { os: false, hermesCron: true };
+  return { os: true, hermesCron: hasHermes && hermesAvailable };
+};
+
+/**
+ * APP_HOME 配下の hermes 収集元の設定すべてに印を付ける（root＋並べた分）。
+ * 他 AI の設定には触らない。戻り値は印を付けた home の一覧。
+ */
+export const markHermesManagedHomes = (appHome, job = "hermes-cron") => {
+  const marked = [];
+  for (const dir of [appHome, ...listProfiles(appHome)]) {
+    if (!homeSources(dir).includes("hermes")) continue;
+    writeMarker(dir, job);
+    marked.push(dir);
+  }
+  return marked;
+};
+
+/** APP_HOME 配下の印をすべて消す（.env には触らない）。 */
+export const clearHermesManagedHomes = (appHome) => {
+  for (const dir of [appHome, ...listProfiles(appHome)]) {
+    try {
+      unlinkSync(markerPath(dir));
+    } catch {
+      /* 印が無いのは正常 */
+    }
+  }
+};