@amenophis1er/foreman 0.1.3 → 0.1.4

package/README.md

@@ -60,6 +60,19 @@ which account pays, the Claude Code install, Ollama and Codex if present, the
 browser missions will use, the port, Tailscale, the data directory — and
 exits. Nothing blocks unless it says so.
 
+**Environment.** Everything the CLI reads; `foreman --help` prints the same list.
+
+| Variable | Meaning | Default |
+|---|---|---|
+| `PORT` | listen port | `4177` |
+| `FOREMAN_HOME` | state directory: runs, settings, logs | `~/.foreman` |
+| `FOREMAN_BIND` | `auto` (loopback + Tailscale when present), `local`, or `all` | `auto` |
+| `FOREMAN_BROWSER` | browser for missions: `chrome`, `chromium`, `msedge`, `firefox` | `chrome` |
+| `FOREMAN_CLAUDE_CONFIG_DIR` | the Claude Code install missions run under | inherited |
+| `FOREMAN_CLAUDE_EXECUTABLE` | the Claude Code executable | bundled |
+| `FOREMAN_AUTH_MODE` | assert `api-key` or `subscription`; fail at start on mismatch | unset |
+| `FOREMAN_NO_TELEGRAM` | `1` to start without the Telegram bot: for a second server beside the main one, since Telegram allows one poller per bot | unset |
+
 ## A mission, start to finish
 
 1. **Fleet.** The board: what needs you (answerable right there), what is
@@ -213,6 +226,16 @@ npm run dev                  # API + Vite together
 scripts/dev-restart.sh       # restarts the server only when nothing would be lost
 ```
 
+To run a checkout beside an installed Foreman on the same machine, give it its
+own port and leave the bot to the installed one:
+
+```sh
+PORT=4178 FOREMAN_BIND=local FOREMAN_NO_TELEGRAM=1 npm start
+```
+
+Both read `~/.foreman`; look from the second, drive from the first — two
+servers running missions against one store is the one case nothing guards.
+
 Releases: `npm version <patch|minor|major> && git push --follow-tags` — CI
 tests, publishes to npm with provenance, and creates the GitHub release.
 

package/bin/foreman.mjs

@@ -43,6 +43,7 @@ Environment:
   FOREMAN_CLAUDE_CONFIG_DIR   Claude Code install missions run under
   FOREMAN_CLAUDE_EXECUTABLE   Claude Code executable (default: bundled)
   FOREMAN_AUTH_MODE           Assert 'api-key' or 'subscription'; fail on mismatch
+  FOREMAN_NO_TELEGRAM=1       Do not attach the Telegram bot (a second server beside the main one)
 `;
 
 const [command = 'start', ...rest] = process.argv.slice(2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amenophis1er/foreman",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Autonomous mission runner on the Claude Agent SDK: a director plans, delegates to workers, verifies, and reports — from one dashboard, your phone, or the CLI.",
   "keywords": [
     "claude",

package/src/cli.ts

@@ -13,7 +13,7 @@
  *           be up when the laptop lid is closed; this is that.
  */
 import { execFile, spawn } from 'node:child_process';
-import { chmod, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { access, chmod, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 import { openSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
@@ -170,8 +170,12 @@ async function serviceUninstall(): Promise<number> {
 /** Is the service registered, and is it running? Null pid when registered but idle. */
 async function serviceState(): Promise<{ installed: boolean; running: boolean; pid?: number }> {
   if (process.platform === 'darwin') {
+    // Installed means the plist is on disk; a stopped service (booted out
+    // by `service stop`) is still installed, and `service start` brings it
+    // back. launchctl only knows about loaded jobs, so it answers "running".
+    const installed = await access(path.join(os.homedir(), 'Library', 'LaunchAgents', `${LABEL}.plist`)).then(() => true, () => false);
     const r = await sh('launchctl', ['print', `gui/${os.userInfo().uid}/${LABEL}`]);
-    if (r.code !== 0) return { installed: false, running: false };
+    if (r.code !== 0) return { installed, running: false };
     const pid = Number(/pid = (\d+)/.exec(r.out)?.[1]);
     return { installed: true, running: Number.isFinite(pid) && pid > 0, ...(pid ? { pid } : {}) };
   }
@@ -230,7 +234,11 @@ async function serviceRestart(): Promise<number> {
 async function serviceStatus(): Promise<number> {
   if (process.platform === 'darwin') {
     const r = await sh('launchctl', ['print', `gui/${os.userInfo().uid}/${LABEL}`]);
-    if (r.code !== 0) { console.log('Not installed. `foreman service install` keeps Foreman running.'); return 1; }
+    if (r.code !== 0) {
+      const st = await serviceState();
+      console.log(st.installed ? 'Installed · stopped — `foreman service start` starts it (it also comes back at next login).' : 'Not installed. `foreman service install` keeps Foreman running.');
+      return 1;
+    }
     const state = /state = (\w+)/.exec(r.out)?.[1] ?? 'unknown';
     const pid = /pid = (\d+)/.exec(r.out)?.[1];
     console.log(`Installed · ${state}${pid ? ` · pid ${pid}` : ''} · http://localhost:${PORT}`);

package/src/server.ts

@@ -608,6 +608,11 @@ let telegramBot: TelegramBot | null = null;
 /** (Re)build the Telegram side from the stored token and linked chat. */
 async function reattachTelegram(): Promise<boolean> {
   notifyHub.detach('telegram');
+  // A second server beside the installed one (a dev checkout on another
+  // port) must not start a second poller: Telegram allows one per bot, and
+  // two fight over getUpdates. FOREMAN_NO_TELEGRAM=1 leaves the channel to
+  // whichever server does not set it.
+  if (process.env.FOREMAN_NO_TELEGRAM === '1') return false;
   const s = await notifySettings();
   const token = await getSecret(store.root, 'telegram');
   if (!token) { void telegramBot?.stop(); telegramBot = null; return false; }
@@ -1348,6 +1353,7 @@ const server = http.createServer(async (req, res) => {
           providerHasKey: await providerHasKeyOf(p),
           activeRun: run ? { ...run.meta } : null,
           lastRun: lastRun && {
+            id: lastRun.id,
             mission: lastRun.mission, title: lastRun.title, status: lastRun.status,
             createdAt: lastRun.createdAt, costUsd: lastRun.costUsd,
             // The card may print a dollar only where the dollar was real.