@clubs.place/cli 0.1.25 → 0.1.26

package/src/hermes-cron.test.mjs

@@ -0,0 +1,430 @@
+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, homedir } from "node:os";
+import {
+  HERMES_CRON_JOB_NAME,
+  HERMES_CRON_SCHEDULE,
+  MARKER_FILE,
+  hermesHomeDir,
+  cronScriptRel,
+  cronScriptPath,
+  markerPath,
+  readMarker,
+  buildTickScript,
+  shouldSkipTick,
+  installHermesCron,
+  removeHermesCron,
+  statusHermesCron,
+} from "./hermes-cron.mjs";
+
+/* Hermes ネイティブ cron（script-only tick）の管理。公式 `hermes cron` CLI
+   だけを使い、jobs.json は読むだけ（書かない）。モデル pin なし・追加の
+   LLM 資格情報なし。テストは runner/jobsReader を差し替える（実登録しない）。 */
+
+const tmp = () => mkdtempSync(join(tmpdir(), "nippo-hcron-"));
+
+test("定数: 名前・毎時・印ファイル", () => {
+  assert.equal(HERMES_CRON_JOB_NAME, "clubs-nippo-hermes");
+  assert.equal(HERMES_CRON_SCHEDULE, "0 * * * *");
+  assert.equal(MARKER_FILE, ".hermes-cron.json");
+});
+
+test("HERMES_HOME を尊重する（未設定なら ~/.hermes）", () => {
+  const old = process.env.HERMES_HOME;
+  try {
+    process.env.HERMES_HOME = "/tmp/x-hermes-home";
+    assert.equal(hermesHomeDir(), "/tmp/x-hermes-home");
+    delete process.env.HERMES_HOME;
+    assert.equal(hermesHomeDir(), join(homedir(), ".hermes"));
+  } finally {
+    if (old === undefined) delete process.env.HERMES_HOME;
+    else process.env.HERMES_HOME = old;
+  }
+});
+
+test("スクリプトは HERMES_HOME/scripts 下の相対名", () => {
+  const h = tmp();
+  assert.equal(cronScriptRel(), "clubs-nippo-hermes-tick.sh");
+  assert.equal(cronScriptPath(h), join(h, "scripts", "clubs-nippo-hermes-tick.sh"));
+});
+
+test("buildTickScript: hermes-cron 印 + tick --only=hermes + モデル指定なし", () => {
+  const s = buildTickScript({ npxPath: "/usr/bin/npx", hermesBinDir: "/usr/bin", logPath: "/tmp/x.log" });
+  assert.match(s, /CLUBS_NIPPO_SCHEDULER=hermes-cron/);
+  assert.match(s, /tick --only=hermes/);
+  for (const flag of ["--model", "--pin", "--provider", "OPENROUTER", "GENERATOR="]) {
+    assert.ok(!s.includes(flag), `${flag} を含んではならない`);
+  }
+  assert.match(s, /\/tmp\/x\.log/);
+});
+
+test("印のある設定は OS 側 tick を飛ばす（hermes-cron の実行だけ通す）", () => {
+  const home = tmp();
+  assert.equal(shouldSkipTick(home, {}).skip, false);
+  writeFileSync(join(home, MARKER_FILE), JSON.stringify({ job: "abc" }));
+  assert.equal(shouldSkipTick(home, {}).skip, true);
+  assert.match(shouldSkipTick(home, {}).reason, /hermes-cron/);
+  assert.equal(shouldSkipTick(home, { scheduler: "hermes-cron" }).skip, false);
+});
+
+test("install: 初回は script 書込 + hermes cron create（pin なし）+ 印", () => {
+  const home = tmp();
+  writeFileSync(join(home, ".env"), "SOURCE=hermes\n");
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  writeFileSync(join(hhome, "cron", "jobs.json"), JSON.stringify({ jobs: [], updated_at: "" }));
+  const calls = [];
+  const runner = (args) => {
+    calls.push(args);
+    if (args[1] === "list") return { status: 0, stdout: "", stderr: "" };
+    if (args[1] === "create") {
+      const jobs = JSON.parse(readFileSync(join(hhome, "cron", "jobs.json"), "utf8"));
+      jobs.jobs.push({
+        id: "job1",
+        name: HERMES_CRON_JOB_NAME,
+        script: cronScriptRel(),
+        no_agent: true,
+        deliver: "local",
+        enabled: true,
+        schedule: { kind: "cron", expr: HERMES_CRON_SCHEDULE },
+        model: null,
+      });
+      writeFileSync(join(hhome, "cron", "jobs.json"), JSON.stringify(jobs));
+      return { status: 0, stdout: "created job1", stderr: "" };
+    }
+    throw new Error(`unexpected: ${args}`);
+  };
+  const r = installHermesCron({
+    home,
+    hermesHome: hhome,
+    npxPath: "/usr/bin/npx",
+    hermesBinDir: "/usr/bin",
+    runner,
+  });
+  assert.equal(r.ok, true);
+  assert.equal(r.created, true);
+  assert.equal(r.job, "job1");
+  const create = calls.find((a) => a[1] === "create");
+  assert.ok(create.includes(HERMES_CRON_SCHEDULE));
+  assert.ok(create.includes("--no-agent") && create.includes("--deliver") && create.includes("local"));
+  assert.ok(create.includes("--script") && create.includes(cronScriptRel()));
+  assert.ok(!create.includes("--model") && !create.includes("--pin") && !create.includes("--provider"));
+  assert.ok(existsSync(cronScriptPath(hhome)), "script が書かれる");
+  const script = readFileSync(cronScriptPath(hhome), "utf8");
+  assert.ok(script.includes(`CLUBS_NIPPO_HOME='${home}'`), "基底 home に束縛する");
+  assert.ok(script.includes(`CLUBS_NIPPO_SCHEDULER_HERMES_HOME='${hhome}'`), "所有者 home を束縛する");
+  assert.ok(!script.includes("export HERMES_HOME="), "収集用 home をグローバルに固定しない");
+  assert.equal(readMarker(home).job, "job1");
+});
+
+test("install: 子の home で呼んでも基底に束縛する（子に上書きしない）", async () => {
+  const { resolveBaseHome } = await import("./hermes-cron.mjs");
+  const app = tmp();
+  writeFileSync(join(app, ".env"), "SOURCE=hermes\n");
+  mkdirSync(join(app, "agents", "AG2"), { recursive: true });
+  writeFileSync(join(app, "agents", "AG2", ".env"), "SOURCE=hermes\n");
+  assert.equal(resolveBaseHome(join(app, "agents", "AG2")), app);
+  assert.equal(resolveBaseHome(app), app);
+  const lone = tmp();
+  assert.equal(resolveBaseHome(join(lone, "agents", "AG9")), join(lone, "agents", "AG9"));
+});
+
+const specJob = (id) => ({
+  id,
+  name: HERMES_CRON_JOB_NAME,
+  script: cronScriptRel(),
+  no_agent: true,
+  deliver: "local",
+  enabled: true,
+  schedule: { kind: "cron", expr: HERMES_CRON_SCHEDULE },
+});
+
+test("install: 二度目は作り直さない（冪等・重複なし）", () => {
+  const home = tmp();
+  writeFileSync(join(home, ".env"), "SOURCE=hermes\n");
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  writeFileSync(join(hhome, "cron", "jobs.json"), JSON.stringify({ jobs: [specJob("job1")] }));
+  writeFileSync(join(home, MARKER_FILE), JSON.stringify({ job: "job1" }));
+  let creates = 0;
+  const r = installHermesCron({
+    home,
+    hermesHome: hhome,
+    npxPath: "/usr/bin/npx",
+    hermesBinDir: "/usr/bin",
+    runner: (args) => {
+      if (args[1] === "create") creates += 1;
+      return { status: 0, stdout: "", stderr: "" };
+    },
+  });
+  assert.equal(r.ok, true);
+  assert.equal(r.created, false);
+  assert.equal(creates, 0);
+});
+
+test("install: 停止中の同名ジョブは edit+resume で直す（作り直さない）", () => {
+  const home = tmp();
+  writeFileSync(join(home, ".env"), "SOURCE=hermes\n");
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  writeFileSync(
+    join(hhome, "cron", "jobs.json"),
+    JSON.stringify({ jobs: [{ ...specJob("job1"), enabled: false, schedule: { kind: "cron", expr: "5 * * * *" } }] }),
+  );
+  const calls = [];
+  const r = installHermesCron({
+    home,
+    hermesHome: hhome,
+    npxPath: "/usr/bin/npx",
+    runner: (args) => {
+      calls.push(args);
+      const jobs = JSON.parse(readFileSync(join(hhome, "cron", "jobs.json"), "utf8"));
+      const j = jobs.jobs.find((x) => x.id === "job1");
+      if (args[1] === "edit") {
+        j.schedule = { kind: "cron", expr: HERMES_CRON_SCHEDULE };
+        j.script = cronScriptRel();
+        j.no_agent = true;
+        j.deliver = "local";
+      }
+      if (args[1] === "resume") j.enabled = true;
+      writeFileSync(join(hhome, "cron", "jobs.json"), JSON.stringify(jobs));
+      return { status: 0, stdout: "ok", stderr: "" };
+    },
+  });
+  assert.equal(r.ok, true);
+  assert.equal(r.repaired, true);
+  assert.equal(r.job, "job1");
+  assert.ok(calls.some((a) => a[1] === "edit" && a.includes("job1")));
+  assert.ok(calls.some((a) => a[1] === "resume" && a.includes("job1")));
+  assert.ok(!calls.some((a) => a[1] === "create"), "作り直さない");
+  assert.equal(readMarker(home).job, "job1");
+});
+
+test("install: 同名が複数・prompt 付き同名は触らず失敗（印も付けない）", () => {
+  for (const jobs of [
+    [specJob("a"), specJob("b")],
+    [{ ...specJob("c"), prompt: "利用者の仕事", no_agent: false }],
+  ]) {
+    const home = tmp();
+    writeFileSync(join(home, ".env"), "SOURCE=hermes\n");
+    const hhome = tmp();
+    mkdirSync(join(hhome, "cron"), { recursive: true });
+    writeFileSync(join(hhome, "cron", "jobs.json"), JSON.stringify({ jobs }));
+    let touched = 0;
+    const r = installHermesCron({
+      home,
+      hermesHome: hhome,
+      npxPath: "/usr/bin/npx",
+      runner: () => {
+        touched += 1;
+        return { status: 0, stdout: "", stderr: "" };
+      },
+    });
+    assert.equal(r.ok, false);
+    assert.equal(touched, 0, "直しも作り直しもしない");
+    assert.equal(existsSync(markerPath(home)), false, "印を付けない");
+  }
+});
+
+test("remove: hermes cron remove + 印を消す（読み返し確認）", () => {
+  const home = tmp();
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  const jobsFile = join(hhome, "cron", "jobs.json");
+  writeFileSync(jobsFile, JSON.stringify({ jobs: [specJob("job9")] }));
+  writeFileSync(join(home, MARKER_FILE), JSON.stringify({ job: "job9" }));
+  const calls = [];
+  const r = removeHermesCron({
+    home,
+    hermesHome: hhome,
+    runner: (args) => {
+      calls.push(args);
+      const jobs = JSON.parse(readFileSync(jobsFile, "utf8"));
+      jobs.jobs = jobs.jobs.filter((j) => j.id !== "job9");
+      writeFileSync(jobsFile, JSON.stringify(jobs));
+      return { status: 0, stdout: "", stderr: "" };
+    },
+  });
+  assert.equal(r.ok, true);
+  assert.deepEqual(calls[0].slice(0, 2), ["cron", "remove"]);
+  assert.ok(calls[0].includes("job9"));
+  assert.equal(existsSync(markerPath(home)), false);
+});
+
+test("remove: exit 0 でもジョブが残っていたら失敗（印は残す）", () => {
+  const home = tmp();
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  writeFileSync(join(hhome, "cron", "jobs.json"), JSON.stringify({ jobs: [specJob("job9")] }));
+  writeFileSync(join(home, MARKER_FILE), JSON.stringify({ job: "job9" }));
+  const r = removeHermesCron({
+    home,
+    hermesHome: hhome,
+    runner: () => ({ status: 0, stdout: "removed", stderr: "" }),
+  });
+  assert.equal(r.ok, false);
+  assert.equal(existsSync(markerPath(home)), true);
+});
+
+test("remove: 印の指すジョブが無い・同名複数は失敗（消さない）", () => {
+  const home = tmp();
+  writeFileSync(join(home, MARKER_FILE), JSON.stringify({ job: "gone" }));
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  writeFileSync(join(hhome, "cron", "jobs.json"), JSON.stringify({ jobs: [specJob("other")] }));
+  let touched = 0;
+  const r = removeHermesCron({
+    home,
+    hermesHome: hhome,
+    runner: () => {
+      touched += 1;
+      return { status: 0, stdout: "", stderr: "" };
+    },
+  });
+  assert.equal(r.ok, false);
+  assert.equal(touched, 0);
+});
+
+test("status: 正常・ drift（印はあるが job が無い）・未管理を見分ける", () => {
+  const home = tmp();
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  const jobsFile = join(hhome, "cron", "jobs.json");
+  writeFileSync(jobsFile, JSON.stringify({ jobs: [] }));
+  assert.equal(statusHermesCron({ home, hermesHome: hhome }).state, "unmanaged");
+  writeFileSync(join(home, MARKER_FILE), JSON.stringify({ job: "gone" }));
+  const drift = statusHermesCron({ home, hermesHome: hhome });
+  assert.equal(drift.state, "drift");
+  assert.match(drift.hint, /install|repair|作り直/i);
+  writeFileSync(jobsFile, JSON.stringify({ jobs: [specJob("gone")] }));
+  assert.equal(statusHermesCron({ home, hermesHome: hhome }).state, "ok");
+});
+
+test("status: 印の ID と実ジョブの ID が違う・停止中・像ちがいは drift", () => {
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  const jobsFile = join(hhome, "cron", "jobs.json");
+  writeFileSync(jobsFile, JSON.stringify({ jobs: [specJob("live")] }));
+  const home = tmp();
+  writeFileSync(join(home, MARKER_FILE), JSON.stringify({ job: "old" }));
+  assert.equal(statusHermesCron({ home, hermesHome: hhome }).state, "drift");
+  writeFileSync(join(home, MARKER_FILE), JSON.stringify({ job: "live" }));
+  assert.equal(statusHermesCron({ home, hermesHome: hhome }).state, "ok");
+  writeFileSync(jobsFile, JSON.stringify({ jobs: [{ ...specJob("live"), enabled: false }] }));
+  const paused = statusHermesCron({ home, hermesHome: hhome });
+  assert.equal(paused.state, "drift");
+  assert.match(paused.hint, /停止/);
+  writeFileSync(
+    jobsFile,
+    JSON.stringify({ jobs: [{ ...specJob("live"), schedule: { kind: "cron", expr: "5 * * * *" } }] }),
+  );
+  assert.equal(statusHermesCron({ home, hermesHome: hhome }).state, "drift");
+});
+
+test("install 失敗（create 非ゼロ）は印を残さず理由を返す", () => {
+  const home = tmp();
+  const hhome = tmp();
+  mkdirSync(join(hhome, "cron"), { recursive: true });
+  writeFileSync(join(hhome, "cron", "jobs.json"), JSON.stringify({ jobs: [] }));
+  const r = installHermesCron({
+    home,
+    hermesHome: hhome,
+    npxPath: "/usr/bin/npx",
+    hermesBinDir: "/usr/bin",
+    runner: () => ({ status: 1, stdout: "", stderr: "boom" }),
+  });
+  assert.equal(r.ok, false);
+  assert.match(r.reason, /boom/);
+  assert.equal(existsSync(markerPath(home)), false);
+});
+
+test("planScheduler: hermes だけ＋hermes 有りは hermes-cron のみ（OS 重複なし）", async () => {
+  const { planScheduler } = await import("./hermes-cron.mjs");
+  assert.deepEqual(planScheduler({ sources: ["hermes"], hermesAvailable: true }), { os: false, hermesCron: true });
+});
+
+test("planScheduler: 混成は両方・hermes 無しは OS のみ・hermes 無 CLI は OS", async () => {
+  const { planScheduler } = await import("./hermes-cron.mjs");
+  assert.deepEqual(planScheduler({ sources: ["hermes", "claude-code"], hermesAvailable: true }), { os: true, hermesCron: true });
+  assert.deepEqual(planScheduler({ sources: ["claude-code"], hermesAvailable: true }), { os: true, hermesCron: false });
+  assert.deepEqual(planScheduler({ sources: ["hermes"], hermesAvailable: false }), { os: true, hermesCron: false });
+});
+
+test("markHermesManagedHomes: hermes の設定だけに印（他 AI に触らない）", async () => {
+  const { markHermesManagedHomes } = await import("./hermes-cron.mjs");
+  const { mkdtempSync: mk, mkdirSync: md, writeFileSync: wr } = await import("node:fs");
+  const { join: j } = await import("node:path");
+  const { tmpdir: td } = await import("node:os");
+  const app = mk(j(td(), "nippo-mark-"));
+  wr(j(app, ".env"), "SOURCE=hermes\n");
+  md(j(app, "agents", "H"), { recursive: true });
+  wr(j(app, "agents", "H", ".env"), "SOURCE=hermes\n");
+  md(j(app, "agents", "C"), { recursive: true });
+  wr(j(app, "agents", "C", ".env"), "SOURCE=claude-code\n");
+  const marked = markHermesManagedHomes(app);
+  assert.deepEqual(marked.sort(), [app, j(app, "agents", "H")].sort());
+  const { existsSync: ex } = await import("node:fs");
+  assert.equal(ex(j(app, MARKER_FILE)), true);
+  assert.equal(ex(j(app, "agents", "C", MARKER_FILE)), false);
+});
+
+test("clearHermesManagedHomes: 印だけ消す（.env は触らない）", async () => {
+  const { markHermesManagedHomes, clearHermesManagedHomes } = await import("./hermes-cron.mjs");
+  const { mkdtempSync: mk, writeFileSync: wr, readFileSync: rr, existsSync: ex } = await import("node:fs");
+  const { join: j } = await import("node:path");
+  const { tmpdir: td } = await import("node:os");
+  const app = mk(j(td(), "nippo-unmark-"));
+  wr(j(app, ".env"), "SOURCE=hermes\n");
+  markHermesManagedHomes(app);
+  assert.equal(ex(j(app, MARKER_FILE)), true);
+  clearHermesManagedHomes(app);
+  assert.equal(ex(j(app, MARKER_FILE)), false);
+  assert.equal(rr(j(app, ".env"), "utf8"), "SOURCE=hermes\n");
+});
+
+test("remove: deleted-job の所有印を status drift 後に回復（空 jobs・無関係ジョブを維持）", () => {
+  for (const jobs of [[], [specJob("unrelated")]]) {
+    const home = tmp();
+    const hermesHome = tmp();
+    mkdirSync(join(hermesHome, "cron"));
+    const jobsFile = join(hermesHome, "cron", "jobs.json");
+    const original = JSON.stringify({ jobs });
+    writeFileSync(jobsFile, original);
+    writeFileSync(markerPath(home), JSON.stringify({ job: "deleted-job", script: cronScriptRel() }));
+    assert.equal(statusHermesCron({ home, hermesHome }).state, "drift");
+    assert.equal(shouldSkipTick(home).skip, true);
+    const r = removeHermesCron({
+      home, hermesHome,
+      runner: () => { assert.fail("消失済み ID で CLI は呼ばない"); },
+    });
+    assert.deepEqual(r, { ok: true, removed: false });
+    assert.equal(existsSync(markerPath(home)), false);
+    assert.equal(shouldSkipTick(home).skip, false);
+    assert.equal(statusHermesCron({ home, hermesHome }).state, "unmanaged");
+    assert.equal(readFileSync(jobsFile, "utf8"), original);
+  }
+});
+
+test("remove: wrong-owned・名前だけの重複・読めない jobs は触らず印を残す", () => {
+  for (const [marker, jobs] of [
+    [{ job: "a", script: cronScriptRel() }, [{ ...specJob("a"), name: "other-owner" }]],
+    [{ job: "a", script: cronScriptRel() }, [{ ...specJob("a"), script: "other.sh" }]],
+    [{ job: "a", script: cronScriptRel() }, [{ ...specJob("a"), prompt: "user job" }]],
+    [{ job: HERMES_CRON_JOB_NAME, script: cronScriptRel() }, [specJob("a"), specJob("b")]],
+    [null, [specJob("a"), specJob("b")]],
+    [{ job: "gone", script: cronScriptRel() }, null],
+    [{ job: "gone", script: "other.sh" }, []],
+  ]) {
+    const home = tmp();
+    const hermesHome = tmp();
+    mkdirSync(join(hermesHome, "cron"));
+    writeFileSync(join(hermesHome, "cron", "jobs.json"), jobs ? JSON.stringify({ jobs }) : "broken");
+    if (marker) writeFileSync(markerPath(home), JSON.stringify(marker));
+    assert.equal(removeHermesCron({
+      home, hermesHome, runner: () => { assert.fail("所有を確認できない job は触らない"); },
+    }).ok, false);
+    if (marker) assert.deepEqual(readMarker(home), marker);
+  }
+});

package/src/init.pipeline.test.mjs

@@ -0,0 +1,130 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, existsSync, chmodSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { spawn } from "node:child_process";
+import http from "node:http";
+
+/* init の実エントリポイント（bin/clubs.mjs）を、スタブの CLUBS サーバ＋
+ * スタブ crontab で動かす。実 crontab・実 Hermes・実 CLUBS には触らない。
+ *  - root の init は .env を書いて OS 登録（crontab 行）まで進む
+ *  - あとから別の AI（Claude）を足すと子の .env が作られ、hermes だけの家に
+ *    OS 登録が無くても OS 側の登録に進む（既存登録がある決め打ちをしない）
+ * 非対話（パイプ）のため確認は既定 Yes で進む。hermes CLI は PATH に置かない
+ * （hermes-cron 経路に入らず OS 経路の振る舞いを見る）。 */
+
+const REPO = new URL("../", import.meta.url).pathname;
+const BIN = join(REPO, "bin", "clubs.mjs");
+
+/* spawnSync は親のイベントループを止めてスタブサーバが応答できなくなるため、
+ * 必ず非同期 spawn。 */
+const runInit = (home, { args, serverUrl, stubs }) =>
+  new Promise((resolve, reject) => {
+    const env = { ...process.env };
+    env.CLUBS_NIPPO_HOME = home;
+    env.PATH = `${stubs}:/usr/bin:/bin`;
+    for (const k of ["GENERATOR", "SOURCE", "CLUBS_NIPPO_CHILD", "CLUBS_NIPPO_SCHEDULER", "HERMES_BIN"]) {
+      delete env[k];
+    }
+    void serverUrl;
+    const child = spawn(process.execPath, [BIN, ...args], { env, stdio: ["ignore", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (d) => (stdout += d));
+    child.stderr.on("data", (d) => (stderr += d));
+    const timer = setTimeout(() => {
+      child.kill("SIGKILL");
+      reject(new Error(`init が終わらない: ${stdout}${stderr}`.slice(0, 500)));
+    }, 60_000);
+    child.on("error", (e) => {
+      clearTimeout(timer);
+      reject(e);
+    });
+    child.on("close", (status) => {
+      clearTimeout(timer);
+      resolve({ status, stdout, stderr });
+    });
+  });
+
+/** crontab -l（空）と crontab -（入力を保存）のスタブ。 */
+const stubBin = () => {
+  const dir = mkdtempSync(join(tmpdir(), "nippo-init-bin-"));
+  const capture = join(dir, "crontab.txt");
+  writeFileSync(
+    join(dir, "crontab"),
+    `#!/bin/sh\nif [ "$1" = "-l" ]; then exit 0; fi\ncat > ${capture}\n`,
+    "utf8",
+  );
+  chmodSync(join(dir, "crontab"), 0o755);
+  return { dir, capture };
+};
+
+test("root の init は .env を書いて OS 登録（crontab 行）まで進む", async () => {
+  const home = mkdtempSync(join(tmpdir(), "nippo-init-"));
+  const { dir, capture } = stubBin();
+  const r = await runInit(home, {
+    stubs: dir,
+    args: ["init", "--url=http://127.0.0.1:9/api/nippo/ingest", "--token=test-token", "--source=hermes"],
+  });
+  assert.equal(r.status, 0, `exit 0 のはず: ${r.stderr}${r.stdout}`);
+  const env = readFileSync(join(home, ".env"), "utf8");
+  assert.match(env, /SOURCE=hermes/);
+  assert.match(env, /NIPPO_INGEST_TOKEN=test-token/);
+  assert.ok(existsSync(capture), "crontab に登録しに行く");
+  const line = readFileSync(capture, "utf8");
+  assert.match(line, /@clubs\.place\/cli/);
+  assert.match(line, /\btick\b/);
+});
+
+test("あとから Claude を足すと子の設定が作られ OS 登録に進む（既存決め打ちなし）", async () => {
+  const home = mkdtempSync(join(tmpdir(), "nippo-init-"));
+  mkdirSync(join(home, "out"), { recursive: true });
+  const hits = { redeem: 0 };
+  const server = http.createServer((req, res) => {
+    let body = "";
+    req.on("data", (d) => (body += d));
+    req.on("end", () => {
+      res.writeHead(200, { "content-type": "application/json" });
+      if (req.url.endsWith("/agents/redeem")) {
+        hits.redeem += 1;
+        res.end(JSON.stringify({ token: "new-token", agentId: "AG2" }));
+      } else if (req.url.endsWith("/collector-config")) {
+        const auth = req.headers.authorization ?? "";
+        if (auth.includes("new-token")) {
+          res.end(JSON.stringify({ schedule: { enabled: true }, agentId: "AG2", sources: ["claude-code"] }));
+        } else {
+          res.end(JSON.stringify({ schedule: { enabled: true }, agentId: "AG1", sources: ["hermes"] }));
+        }
+      } else {
+        res.end("{}");
+      }
+    });
+  });
+  await new Promise((r) => server.listen(0, "127.0.0.1", r));
+  const url = `http://127.0.0.1:${server.address().port}`;
+  writeFileSync(
+    join(home, ".env"),
+    `NIPPO_INGEST_URL=${url}/api/nippo/ingest\nNIPPO_INGEST_TOKEN=old-token\nAGENT_ID=AG1\nSOURCE=hermes\n`,
+    "utf8",
+  );
+  const { dir, capture } = stubBin();
+  try {
+    const r = await runInit(home, { stubs: dir, args: ["init", `--url=${url}/api/nippo/ingest`, "--code=CODE123"] });
+    assert.equal(r.status, 0, `exit 0 のはず: ${r.stderr}${r.stdout}`);
+    assert.equal(hits.redeem, 1);
+    assert.equal(
+      readFileSync(join(home, ".env"), "utf8").includes("AGENT_ID=AG2"),
+      false,
+      "root の鍵を上書きしない",
+    );
+    const childEnv = join(home, "agents", "AG2", ".env");
+    assert.ok(existsSync(childEnv), "子の設定が作られる");
+    assert.match(readFileSync(childEnv, "utf8"), /AGENT_ID=AG2/);
+    assert.ok(existsSync(capture), "OS 登録に進む（hermes だけの家に OS 登録は無いため）");
+    assert.match(readFileSync(capture, "utf8"), /tick/);
+    assert.match(readFileSync(capture, "utf8"), /place/);
+  } finally {
+    server.close();
+  }
+});

package/src/narrative.hermes.test.mjs

@@ -0,0 +1,74 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, writeFileSync, chmodSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { generateNarrative, fallbackNarrative } from "./narrative.mjs";
+
+/* hermes 生成器の結線。Hermes 既定モデルで書かせ、落ちたら理由つき fallback。 */
+
+const activity = {
+  date: "2026-10-28",
+  agentName: "test's Hermes",
+  source: "hermes",
+  aggregates: {
+    totalCalls: 3,
+    failedCalls: 0,
+    successRate: 100,
+    activeHours: 1.2,
+    projects: ["clubsx"],
+  },
+  events: [
+    { time: "09:00", name: "terminal.exec", summary: "テスト実行", project: "clubsx", ok: true },
+    { time: "10:00", name: "file.read", summary: "設定確認", project: "clubsx", ok: true },
+    { time: "11:00", name: "terminal.exec", summary: "再実行", project: "clubsx", ok: true },
+  ],
+  prompts: [],
+};
+
+const stubBin = (script) => {
+  const dir = mkdtempSync(join(tmpdir(), "nippo-narr-"));
+  const p = join(dir, "hermes-stub.sh");
+  writeFileSync(p, `#!/bin/sh\n${script}\n`, "utf8");
+  chmodSync(p, 0o755);
+  return p;
+};
+
+const withHermesBin = (p) => {
+  const old = process.env.HERMES_BIN;
+  process.env.HERMES_BIN = p;
+  return () => (old === undefined ? delete process.env.HERMES_BIN : (process.env.HERMES_BIN = old));
+};
+
+test("GENERATOR=hermes で hermes 生成器が動く（stdout の JSON を採用）", async () => {
+  const restore = withHermesBin(
+    stubBin(`cat >/dev/null\nprintf '{"workBlocks":[{"title":"clubsx","text":"本文","metric":"実行 3回"}],"handoff":{"title":"t","text":"x"},"insights":[],"selfNote":"s"}'`),
+  );
+  try {
+    const n = await generateNarrative(activity, { generator: "hermes", useLlm: true });
+    assert.equal(n.generator, "hermes");
+    assert.equal(n.workBlocks.length, 1);
+    assert.equal(n.workBlocks[0].title, "clubsx");
+    assert.ok(!("repos" in (n.workBlocks[0] ?? {})), "repos は行に残さない（blockRepos に移す）");
+  } finally {
+    restore();
+  }
+});
+
+test("hermes が落ちたら理由つき fallback（黙って集計値だけにしない）", async () => {
+  const restore = withHermesBin(stubBin(`echo boom >&2\nexit 1`));
+  try {
+    const n = await generateNarrative(activity, { generator: "hermes", useLlm: true });
+    assert.match(n.generator, /fallback/);
+    assert.match(n.generator, /hermes/);
+    assert.match(n.selfNote, /自動生成ができませんでした/);
+  } finally {
+    restore();
+  }
+});
+
+test("hermes の直し方は API キー不要（hermes model・既定設定の確認）", () => {
+  const n = fallbackNarrative(activity, "hermes での生成に失敗（boom）", "hermes");
+  assert.match(n.selfNote, /hermes model/);
+  assert.match(n.selfNote, /API キーは要りません/);
+});