cckeep 0.1.0 → 0.1.1

package/README.ja.md

@@ -28,18 +28,23 @@
 ## クイックスタート
 
 ```sh
-npx cckeep install
+npm install -g cckeep
+cckeep install
 ```
 
 バックグラウンドジョブを登録します(macOS は launchd、Linux は systemd user timer)。15秒ごとに確認し、死んでいるものを繋ぎ直します。
 
-条件が一つあります。**Claude Code が tmux の中で動いていること。** 素のターミナルで起動したセッションには別プロセスから入力を送る手段がなく、どんなツールでも手が出せません。→ [tmux で Claude Code を動かす](#tmux-で-claude-code-を動かす)
+`npx cckeep install` ではなくグローバルに入れてください。登録されたジョブはインストール先の cckeep を実行しますが、npx のキャッシュは使い捨てです。そこを指すジョブはキャッシュが消された瞬間に、黙って動かなくなります — 監視ツールが持ってはいけない唯一の壊れ方です。そのため `cckeep install` は npx のパスからの登録を拒否します。
+
+入れる前に様子を見るだけなら `npx` で構いません。以下の2つは何も変更しません。
 
 ```sh
-npx cckeep            # いま何が見えているか(何も変更しません)
+npx cckeep            # いま何が見えているか
 npx cckeep doctor     # tmux・ペイン・スケジューラの確認
 ```
 
+条件が一つあります。**Claude Code が tmux の中で動いていること。** 素のターミナルで起動したセッションには別プロセスから入力を送る手段がなく、どんなツールでも手が出せません。→ [tmux で Claude Code を動かす](#tmux-で-claude-code-を動かす)
+
 > 机に戻る手間が省けたなら、⭐ が同じ問題を抱えている人に届く助けになります。
 
 ## 作業中のセッションには打ち込みません

package/README.md

@@ -28,18 +28,23 @@ Either way you find out the same way: you reach for your phone, and the session
 ## Quick start
 
 ```sh
-npx cckeep install
+npm install -g cckeep
+cckeep install
 ```
 
 That registers a background job — launchd on macOS, a systemd user timer on Linux — that checks every 15 seconds and re-arms whatever went dead.
 
-One requirement: **Claude Code has to be running inside tmux.** A session started in a bare terminal cannot be reached from another process, so there is nothing any tool can do for it. See [Running Claude Code in tmux](#running-claude-code-in-tmux).
+Install it globally rather than running `npx cckeep install`. The scheduled job runs cckeep from wherever it was installed, and npx's cache is throwaway: a job pointing into it keeps working until the cache is cleared and then stops, silently — the one failure a watchdog must not have. `cckeep install` refuses to schedule from an npx path for that reason.
+
+To look before installing anything, `npx` is fine — neither of these changes a thing:
 
 ```sh
-npx cckeep            # what it sees right now — changes nothing
+npx cckeep            # what it sees right now
 npx cckeep doctor     # check tmux, panes, and the scheduler
 ```
 
+One requirement: **Claude Code has to be running inside tmux.** A session started in a bare terminal cannot be reached from another process, so there is nothing any tool can do for it. See [Running Claude Code in tmux](#running-claude-code-in-tmux).
+
 > If cckeep saved you a walk back to your desk, a ⭐ helps other Remote Control users find it.
 
 ## It will not type into a session that is working

package/bin/cckeep.js

@@ -130,6 +130,10 @@ async function main() {
     }
     case 'install': {
       const res = scheduler.install({ interval: config.interval });
+      if (res.kind === 'ephemeral') {
+        console.error(t.ephemeral(res.path));
+        process.exit(1);
+      }
       if (res.kind === 'unsupported') {
         console.log(t.unsupported);
         process.exit(1);
@@ -155,6 +159,11 @@ async function main() {
         ['tmux server', bin && tmux.hasServer() ? t.doctorOk : t.doctorFail],
         ['claude panes', String(claudePanes.length)],
         ['scheduler', scheduler.isInstalled() ? t.doctorOk : t.doctorFail],
+        [t.scheduledPath, (() => {
+          const cli = scheduler.scheduledCli();
+          if (!cli) return '—';
+          return existsSync(cli) ? cli : `${cli}  ${t.scheduledMissing}`;
+        })()],
         ['home', homeDir()],
         ['config', existsSync(configPath()) ? configPath() : `${configPath()} (defaults)`],
         ['state', statePath()],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cckeep",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Keeps Claude Code Remote Control from silently going dead. Re-arms the sessions its 31-second retry budget gives up on — local, tmux-native, zero dependencies.",
   "type": "module",
   "bin": {

package/src/i18n.js

@@ -21,6 +21,9 @@ const en = {
   installFailed: (kind) => `Wrote the ${kind} unit, but could not load it. Load it manually, or run \`cckeep watch\` in a terminal.`,
   uninstalled: (kind) => `Removed the ${kind} job.`,
   unsupported: 'Automatic scheduling supports macOS (launchd) and Linux (systemd user timers). Elsewhere, run `cckeep watch` under your own supervisor.',
+  ephemeral: (p) => `Refusing to schedule: this copy of cckeep lives in npm's throwaway npx cache\n  ${p}\nA scheduled job pointing there stops working the moment the cache is cleared — silently. Install it properly first:\n\n  npm install -g cckeep && cckeep install\n`,
+  scheduledPath: 'scheduled cmd',
+  scheduledMissing: 'MISSING — run `cckeep install` again',
   noLog: 'No log yet.',
   doctorOk: 'ok',
   doctorFail: 'missing',
@@ -49,6 +52,9 @@ const ja = {
   installFailed: (kind) => `${kind} の定義は書きましたが、読み込みに失敗しました。手動で読み込むか、ターミナルで \`cckeep watch\` を実行してください。`,
   uninstalled: (kind) => `${kind} のジョブを削除しました。`,
   unsupported: '自動スケジュール登録は macOS (launchd) と Linux (systemd user timer) に対応しています。それ以外では `cckeep watch` を任意の常駐手段で動かしてください。',
+  ephemeral: (p) => `登録を中止しました: この cckeep は npm の使い捨て npx キャッシュ内にあります\n  ${p}\nここを指すジョブは、キャッシュが消された瞬間に黙って動かなくなります。先に正式にインストールしてください:\n\n  npm install -g cckeep && cckeep install\n`,
+  scheduledPath: '登録先',
+  scheduledMissing: '見つかりません — `cckeep install` を再実行してください',
   noLog: 'ログはまだありません。',
   doctorOk: 'ok',
   doctorFail: '未検出',

package/src/scheduler.js

@@ -1,5 +1,5 @@
 import { execFileSync } from 'node:child_process';
-import { mkdirSync, writeFileSync, existsSync, unlinkSync } from 'node:fs';
+import { mkdirSync, writeFileSync, readFileSync, existsSync, unlinkSync } from 'node:fs';
 import { homedir, platform } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -10,6 +10,16 @@ function cliPath() {
   return fileURLToPath(new URL('../bin/cckeep.js', import.meta.url));
 }
 
+/**
+ * `npx cckeep` runs out of npm's throwaway cache. Baking that path into a
+ * launchd job or systemd unit produces a scheduler that works today and stops
+ * forever the first time the cache is evicted — silently, which is the one
+ * failure this tool must not have. Refuse instead, and ask for a real install.
+ */
+export function isEphemeralPath(p) {
+  return /[\\/]_npx[\\/]/.test(p) || /[\\/]\.npm[\\/]_cacache[\\/]/.test(p);
+}
+
 function nodePath() {
   return process.execPath;
 }
@@ -83,6 +93,9 @@ function run(cmd, args) {
 }
 
 export function install({ interval }) {
+  const cli = cliPath();
+  if (isEphemeralPath(cli)) return { kind: 'ephemeral', path: cli, ok: false };
+
   const os = platform();
   if (os === 'darwin') {
     const p = plistPath();
@@ -132,3 +145,29 @@ export function isInstalled() {
   if (os === 'linux') return existsSync(join(systemdDir(), 'cckeep.timer'));
   return false;
 }
+
+/**
+ * The cckeep path the installed scheduler will actually run. Read back from the
+ * unit rather than recomputed, so `doctor` can catch a job left pointing at a
+ * copy that has since been moved or deleted.
+ */
+export function scheduledCli() {
+  try {
+    const os = platform();
+    if (os === 'darwin') {
+      const p = plistPath();
+      if (!existsSync(p)) return null;
+      const xml = readFileSync(p, 'utf8');
+      const args = [...xml.matchAll(/<string>([^<]*)<\/string>/g)].map((m) => m[1]);
+      return args.find((a) => a.endsWith('cckeep.js')) ?? null;
+    }
+    if (os === 'linux') {
+      const p = join(systemdDir(), 'cckeep.service');
+      if (!existsSync(p)) return null;
+      const unit = readFileSync(p, 'utf8');
+      const line = unit.match(/^ExecStart=(.*)$/m)?.[1] ?? '';
+      return line.split(/\s+/).find((a) => a.endsWith('cckeep.js')) ?? null;
+    }
+  } catch {}
+  return null;
+}