assurgent 0.1.0 → 0.2.0

package/cli.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env bun
 // Entry point for `bunx assurgent`
 
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
+import { copyFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 
 const args = process.argv.slice(2);
 
@@ -11,15 +11,16 @@ if (args.includes("--help") || args.includes("-h")) {
 assurgent - Telegram bot bridge to Claude Code CLI
 
 Usage:
-  assurgent [options]
-
-Options:
-  --help, -h       Show this help message
-  --version, -v    Print the version number
+  assurgent          Start the bot
+  assurgent init     Scaffold config.json into ASSURGENT_HOME
+  assurgent --help   Show this help message
+  assurgent --version  Print the version number
 
 Configuration:
-  Requires config.json and .env in the working directory.
-  See config.example.json for the expected structure.
+  Config is loaded from $ASSURGENT_HOME/config.json.
+  ASSURGENT_HOME defaults to ~/.assurgent/ if not set.
+
+  Run "assurgent init" to create the config file, then edit it with your settings.
 `);
   process.exit(0);
 }
@@ -31,4 +32,22 @@ if (args.includes("--version") || args.includes("-v")) {
   process.exit(0);
 }
 
+if (args[0] === "init") {
+  const { getAssurgentHome } = await import("./src/config.ts");
+  const target = join(getAssurgentHome(), "config.json");
+
+  if (existsSync(target)) {
+    console.error(
+      `Config already exists at ${target}. Edit it directly or delete it to re-initialize.`,
+    );
+    process.exit(1);
+  }
+
+  mkdirSync(dirname(target), { recursive: true });
+  const source = join(import.meta.dirname, "config.example.json");
+  copyFileSync(source, target);
+  console.log(`Created config at ${target}. Edit it with your settings, then run "assurgent".`);
+  process.exit(0);
+}
+
 await import("./src/index.ts");

package/config.example.json

@@ -0,0 +1,26 @@
+{
+  "chat": {
+    "adapter": "telegram",
+    "telegram": {
+      "botToken": "123456:ABC-DEF...",
+      "allowedUserIds": ["YOUR_TELEGRAM_USER_ID"],
+      "placeholder": {
+        "enabled": true,
+        "text": "thinking..."
+      }
+    }
+  },
+  "agent": {
+    "adapter": "claude-code",
+    "claude-code": {
+      "model": "sonnet",
+      "maxTurns": 10,
+      "flags": ["--dangerously-skip-permissions"],
+      "claudePath": "claude"
+    }
+  },
+  "session": {
+    "turnLimit": 20
+  },
+  "workspacePath": "/path/to/your/workspace"
+}

package/package.json

@@ -1,15 +1,11 @@
 {
   "name": "assurgent",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "bin": {
     "assurgent": "./cli.ts"
   },
-  "files": [
-    "cli.ts",
-    "src",
-    "README.md"
-  ],
+  "files": ["cli.ts", "src", "config.example.json", "README.md"],
   "publishConfig": {
     "access": "public"
   },

package/src/config.test.ts

@@ -1,5 +1,8 @@
-import { describe, expect, test } from "bun:test";
-import { validateConfig } from "./config";
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { getAssurgentHome, loadConfig, validateConfig } from "./config";
 import type { Config } from "./config";
 
 function validConfig(): Config {
@@ -26,6 +29,82 @@ function validConfig(): Config {
   };
 }
 
+describe("getAssurgentHome", () => {
+  const originalEnv = process.env.ASSURGENT_HOME;
+
+  afterEach(() => {
+    if (originalEnv === undefined) {
+      process.env.ASSURGENT_HOME = undefined;
+    } else {
+      process.env.ASSURGENT_HOME = originalEnv;
+    }
+  });
+
+  test("returns ~/.assurgent when ASSURGENT_HOME is not set", () => {
+    process.env.ASSURGENT_HOME = undefined;
+    const expected = path.join(os.homedir(), ".assurgent");
+    expect(getAssurgentHome()).toBe(expected);
+  });
+
+  test("returns ASSURGENT_HOME env var value when set", () => {
+    process.env.ASSURGENT_HOME = "/custom/assurgent/home";
+    expect(getAssurgentHome()).toBe("/custom/assurgent/home");
+  });
+});
+
+describe("loadConfig", () => {
+  let tempDir: string;
+
+  beforeEach(() => {
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "assurgent-test-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+    process.env.ASSURGENT_HOME = undefined;
+  });
+
+  function writeConfig(dir: string, config: Config): string {
+    const configPath = path.join(dir, "config.json");
+    fs.writeFileSync(configPath, JSON.stringify(config), "utf-8");
+    return configPath;
+  }
+
+  test("reads config from explicit path", () => {
+    const configPath = writeConfig(tempDir, validConfig());
+    const config = loadConfig(configPath);
+    expect(config.chat.adapter).toBe("telegram");
+    expect(config.session.turnLimit).toBe(20);
+  });
+
+  test("reads config from $ASSURGENT_HOME/config.json when no explicit path", () => {
+    process.env.ASSURGENT_HOME = tempDir;
+    writeConfig(tempDir, validConfig());
+    const config = loadConfig();
+    expect(config.chat.adapter).toBe("telegram");
+  });
+
+  test("throws with helpful error when config is missing and explicit path given", () => {
+    const missingPath = path.join(tempDir, "nonexistent.json");
+    expect(() => loadConfig(missingPath)).toThrow("Config file not found");
+  });
+
+  test("throws mentioning 'assurgent init' when config is missing", () => {
+    const missingPath = path.join(tempDir, "nonexistent.json");
+    expect(() => loadConfig(missingPath)).toThrow("assurgent init");
+  });
+
+  test("throws mentioning 'ASSURGENT_HOME' when config is missing", () => {
+    const missingPath = path.join(tempDir, "nonexistent.json");
+    expect(() => loadConfig(missingPath)).toThrow("ASSURGENT_HOME");
+  });
+
+  test("throws with config path in error message when config is missing", () => {
+    process.env.ASSURGENT_HOME = tempDir;
+    expect(() => loadConfig()).toThrow(path.join(tempDir, "config.json"));
+  });
+});
+
 describe("validateConfig", () => {
   test("accepts valid config", () => {
     expect(() => validateConfig(validConfig())).not.toThrow();

package/src/config.ts

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 
 /** Runtime configuration for the bot. */
@@ -31,6 +32,11 @@ export interface Config {
   workspacePath: string;
 }
 
+/** Returns the resolved ASSURGENT_HOME path. */
+export function getAssurgentHome(): string {
+  return process.env.ASSURGENT_HOME ?? path.join(os.homedir(), ".assurgent");
+}
+
 /** Fail fast with clear errors if required config fields are missing or invalid. */
 export function validateConfig(config: Config): void {
   const errors: string[] = [];
@@ -71,10 +77,12 @@ export function validateConfig(config: Config): void {
 
 /** Load and validate config from a JSON file. */
 export function loadConfig(configPath?: string): Config {
-  const resolved = configPath ?? path.resolve(import.meta.dir, "..", "config.json");
+  const resolved = configPath ?? path.join(getAssurgentHome(), "config.json");
 
   if (!fs.existsSync(resolved)) {
-    throw new Error(`Config file not found: ${resolved}`);
+    throw new Error(
+      `Config file not found: ${resolved}\nRun "assurgent init" to create one, or set ASSURGENT_HOME to point to an existing config directory.`,
+    );
   }
 
   const raw = JSON.parse(fs.readFileSync(resolved, "utf-8"));

package/src/index.ts

@@ -2,7 +2,7 @@ import path from "node:path";
 import { ClaudeCodeAdapter } from "./agent/claude-code";
 import { TelegramAdapter } from "./chat/telegram";
 import type { Config } from "./config";
-import { loadConfig } from "./config";
+import { getAssurgentHome, loadConfig } from "./config";
 import { SessionManager } from "./core/session-manager";
 import { Wrapper } from "./core/wrapper";
 import type { AgentAdapter } from "./interfaces/agent-adapter";
@@ -33,7 +33,7 @@ function createAgentAdapter(cfg: Config): AgentAdapter {
 const chat = createChatAdapter(config);
 const agent = createAgentAdapter(config);
 const sessions = new SessionManager({
-  statePath: path.join(config.workspacePath, "state"),
+  statePath: path.join(getAssurgentHome(), "state"),
 });
 
 const wrapper = new Wrapper(