@armstrongnate/april 0.0.1 → 0.0.2

package/README.md

@@ -8,6 +8,7 @@ april watches for GitHub issues assigned to you with a specific label, then spin
 
 - [Node.js](https://nodejs.org/) >= 22
 - [gh](https://cli.github.com/) (authenticated)
+- The `gh-webhook` extension: `gh extension install cli/gh-webhook`
 - [tmux](https://github.com/tmux/tmux)
 - [Claude Code](https://claude.ai/claude-code) CLI
 
@@ -21,12 +22,14 @@ npm i -g @armstrongnate/april
 Then:
 
 ```bash
-april init                         # writes ~/.config/april/config.yaml + installs the issue-worker skill
+april init                         # writes ~/.config/april/config.yaml + skill + env file; checks prereqs
 $EDITOR ~/.config/april/config.yaml
 april install                      # registers the user service and starts it
 april logs -f
 ```
 
+`april init` and the daemon both verify that the `cli/gh-webhook` extension is installed and refuse to proceed without it.
+
 ## Commands
 
 | Command | What it does |
@@ -39,6 +42,22 @@ april logs -f
 | `april logs -f [-n N]` | Streams logs. `-n` sets line count (default 100). |
 | `april daemon` | Runs the worker in the foreground (for debugging; the service uses `dist/index.js` directly). |
 
+## Environment variables
+
+The daemon reads extra env vars from `~/.config/april/env`. One `KEY=VALUE` per line, `#` for comments, optional double-quotes around values:
+
+```sh
+# ~/.config/april/env
+SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...
+APRIL_DEBUG=1
+GREETING="hello world"
+```
+
+This file is seeded by `april install` (and `april init`) and is **never overwritten by reinstalls** — safe to put long-lived secrets here. After editing, `april restart`.
+
+- On Linux, the systemd unit references it via `EnvironmentFile=-`. Changes take effect on the next restart.
+- On macOS, launchd has no equivalent directive, so values are read at install time and inlined into the plist. After editing the env file, run `april install` to regenerate the plist, then `april restart`.
+
 ## Service backend
 
 - **Linux** uses systemd user services at `~/.config/systemd/user/april.service`. Logs go to the journal (`journalctl --user -u april`).

package/dist/commands/init.js

@@ -2,6 +2,8 @@ import { fileURLToPath } from "node:url";
 import { dirname, join, resolve } from "node:path";
 import { copyFileSync, existsSync, mkdirSync } from "node:fs";
 import { homedir } from "node:os";
+import { ensureEnvFile, envFilePath } from "../service/envfile.js";
+import { isGhWebhookExtensionInstalled, GH_EXTENSION_INSTALL_CMD } from "../precheck.js";
 // Resolve the bundled package root from this file's installed location.
 // dist/commands/init.js -> dist/.. (the package root, where config.example.yaml + skills/ live)
 function packageRoot() {
@@ -37,6 +39,18 @@ export function run(args) {
         return 1;
     }
     copyIfMissing(skillSrc, skillDst, "skill", force);
+    const envState = ensureEnvFile();
+    console.log(`  env:    ${envState === "created" ? "wrote" : "already exists"} ${envFilePath()}`);
+    console.log("");
+    console.log("Checks:");
+    if (isGhWebhookExtensionInstalled()) {
+        console.log("  ✓ gh extension cli/gh-webhook installed");
+    }
+    else {
+        console.log("  ✗ gh extension cli/gh-webhook NOT installed");
+        console.log(`    Install with:  ${GH_EXTENSION_INSTALL_CMD}`);
+        console.log("    (april will refuse to start without it.)");
+    }
     console.log("");
     if (configResult === "wrote") {
         console.log(`Next: edit ${configDst}, then run \`april install\`.`);

package/dist/config.js

@@ -4,6 +4,7 @@ import { resolve, join } from "node:path";
 import { homedir } from "node:os";
 import { parse as parseYaml } from "yaml";
 import { createLogger } from "./logger.js";
+import { isGhWebhookExtensionInstalled, GH_EXTENSION_INSTALL_CMD } from "./precheck.js";
 const log = createLogger("config");
 function findConfigPath() {
     const envPath = process.env.APRIL_CONFIG;
@@ -37,6 +38,10 @@ function validateTools() {
             throw new Error(`Required tool "${tool}" not found on PATH. Install it before running april.`);
         }
     }
+    if (!isGhWebhookExtensionInstalled()) {
+        throw new Error(`Required gh extension not installed: cli/gh-webhook.\n` +
+            `Install it with:\n  ${GH_EXTENSION_INSTALL_CMD}`);
+    }
 }
 function validateString(obj, key, context) {
     const val = obj[key];

package/dist/precheck.js

@@ -0,0 +1,18 @@
+import { execFileSync } from "node:child_process";
+export const REQUIRED_GH_EXTENSION = "cli/gh-webhook";
+export const GH_EXTENSION_INSTALL_CMD = `gh extension install ${REQUIRED_GH_EXTENSION}`;
+export function isGhWebhookExtensionInstalled() {
+    try {
+        const out = execFileSync("gh", ["extension", "list"], {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "pipe"],
+            timeout: 10_000,
+        });
+        // `gh extension list` output includes the extension repo (e.g. cli/gh-webhook)
+        // somewhere in each row; substring match is sufficient.
+        return out.includes(REQUIRED_GH_EXTENSION);
+    }
+    catch {
+        return false;
+    }
+}

package/dist/service/envfile.js

@@ -0,0 +1,48 @@
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+export function envFilePath() {
+    return join(homedir(), ".config", "april", "env");
+}
+const DEFAULT_HEADER = `# april daemon environment variables
+# One KEY=VALUE per line. Lines starting with # are ignored.
+# Values may be wrapped in double quotes if they contain spaces or special chars.
+# After editing, run: april restart
+`;
+/** Create the env file with a friendly header if it doesn't exist. Never overwrites. */
+export function ensureEnvFile() {
+    const path = envFilePath();
+    if (existsSync(path))
+        return "exists";
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, DEFAULT_HEADER, "utf-8");
+    return "created";
+}
+/**
+ * Parse the env file and return key/value pairs. Used by launchd, which has
+ * no native EnvironmentFile= equivalent — values must be inlined into the plist.
+ *
+ * Format: KEY=VALUE per line. # for comments. Optional double-quotes around the value.
+ */
+export function parseEnvFile() {
+    const path = envFilePath();
+    if (!existsSync(path))
+        return {};
+    const result = {};
+    const raw = readFileSync(path, "utf-8");
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eq = trimmed.indexOf("=");
+        if (eq < 1)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        let value = trimmed.slice(eq + 1).trim();
+        if (value.startsWith('"') && value.endsWith('"') && value.length >= 2) {
+            value = value.slice(1, -1);
+        }
+        result[key] = value;
+    }
+    return result;
+}

package/dist/service/launchd.js

@@ -3,6 +3,7 @@ import { execFileSync, spawnSync } from "node:child_process";
 import { dirname } from "node:path";
 import { homedir, userInfo } from "node:os";
 import { daemonEntryPath, nodeBinaryPath, launchdPlistPath, launchdLogPath, launchdLogDir, LAUNCHD_LABEL, } from "./paths.js";
+import { parseEnvFile, ensureEnvFile } from "./envfile.js";
 function escapeXml(s) {
     return s
         .replace(/&/g, "&")
@@ -15,6 +16,16 @@ export function plistContents() {
     const entry = daemonEntryPath();
     const path = process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin";
     const log = launchdLogPath();
+    // Built-ins always set; user file overrides on conflict.
+    const env = {
+        PATH: path,
+        NODE_ENV: "production",
+        HOME: homedir(),
+        ...parseEnvFile(),
+    };
+    const envEntries = Object.entries(env)
+        .map(([k, v]) => `        <key>${escapeXml(k)}</key>\n        <string>${escapeXml(v)}</string>`)
+        .join("\n");
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -39,12 +50,7 @@ export function plistContents() {
     <string>${escapeXml(homedir())}</string>
     <key>EnvironmentVariables</key>
     <dict>
-        <key>PATH</key>
-        <string>${escapeXml(path)}</string>
-        <key>NODE_ENV</key>
-        <string>production</string>
-        <key>HOME</key>
-        <string>${escapeXml(homedir())}</string>
+${envEntries}
     </dict>
     <key>StandardOutPath</key>
     <string>${escapeXml(log)}</string>
@@ -75,6 +81,8 @@ function serviceTarget() {
 }
 export function install() {
     ensureLaunchctl();
+    // Seed env file so it's discoverable; values are parsed and inlined into the plist below.
+    ensureEnvFile();
     mkdirSync(launchdLogDir(), { recursive: true });
     const path = launchdPlistPath();
     mkdirSync(dirname(path), { recursive: true });

package/dist/service/systemd.js

@@ -3,6 +3,7 @@ import { execFileSync, spawnSync } from "node:child_process";
 import { dirname } from "node:path";
 import { homedir } from "node:os";
 import { daemonEntryPath, nodeBinaryPath, systemdUnitPath, SERVICE_NAME, } from "./paths.js";
+import { envFilePath, ensureEnvFile } from "./envfile.js";
 function runSystemctl(args) {
     const res = spawnSync("systemctl", ["--user", ...args], { encoding: "utf-8" });
     return {
@@ -28,6 +29,7 @@ RestartSec=5s
 WorkingDirectory=${homedir()}
 Environment=PATH=${path}
 Environment=NODE_ENV=production
+EnvironmentFile=-${envFilePath()}
 StandardOutput=journal
 StandardError=journal
 
@@ -57,6 +59,8 @@ function lingerEnabled() {
 }
 export function install() {
     ensureSystemctlPresent();
+    // Seed env file so EnvironmentFile=- has something to find on first install.
+    ensureEnvFile();
     const path = systemdUnitPath();
     mkdirSync(dirname(path), { recursive: true });
     writeFileSync(path, unitContents(), "utf-8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armstrongnate/april",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "She does all the work so you don't have to. Watches GitHub issues and spawns Claude Code sessions to work them.",
   "type": "module",
   "bin": {