@aion0/forge 0.1.1 → 0.1.3

package/README.md

@@ -31,6 +31,12 @@ No API keys required. Forge runs on your existing Claude Code subscription.
 
 ```bash
 npm install -g @aion0/forge
+
+# Start the server
+forge-server
+
+# Or in development mode
+forge-server --dev
 ```
 
 ### From source
@@ -39,38 +45,12 @@ npm install -g @aion0/forge
 git clone https://github.com/aiwatching/forge.git
 cd forge
 pnpm install
-pnpm build
+pnpm dev
 ```
 
 ## Quick Start
 
-### 1. Create config
-
-Create `.env.local` in the project root:
-
-```env
-# Auth (generate a random string, e.g. openssl rand -hex 32)
-AUTH_SECRET=<random-string>
-AUTH_TRUST_HOST=true
-
-# Optional: Google OAuth for production
-# GOOGLE_CLIENT_ID=...
-# GOOGLE_CLIENT_SECRET=...
-```
-
-> **API keys are not required.** Forge uses your local Claude Code CLI, which runs on your Anthropic subscription. If you want to use the built-in multi-model chat feature, you can optionally add provider keys (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY`, `XAI_API_KEY`) later.
-
-### 2. Start the server
-
-```bash
-# Development
-pnpm dev
-
-# Production
-pnpm build && pnpm start
-```
-
-### 3. Log in
+### 1. Log in
 
 Open `http://localhost:3000`. A login password is auto-generated and printed in the console:
 
@@ -141,10 +121,10 @@ forge retry <task-id>
 
 ## YAML Workflows
 
-Define multi-step flows in `~/.my-workflow/flows/`:
+Define multi-step flows in `~/.forge/flows/`:
 
 ```yaml
-# ~/.my-workflow/flows/daily-review.yaml
+# ~/.forge/flows/daily-review.yaml
 name: daily-review
 steps:
   - project: my-app
@@ -182,10 +162,10 @@ Password-protected commands auto-delete your message to keep credentials safe.
 
 ## Configuration
 
-All config lives in `~/.my-workflow/`:
+All config lives in `~/.forge/`:
 
 ```
-~/.my-workflow/
+~/.forge/
   settings.yaml       # Main configuration
   password.json        # Daily auto-generated login password
   data.db              # SQLite database (tasks, sessions)

package/bin/forge-server.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * forge-server — Start the Forge web platform.
+ *
+ * Usage:
+ *   forge-server                Start in foreground (production mode)
+ *   forge-server --dev          Start in foreground (development mode)
+ *   forge-server --background   Start in background (production mode), logs to ~/.forge/forge.log
+ *   forge-server --stop         Stop background server
+ */
+
+import { execSync, spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync, openSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+const DATA_DIR = join(homedir(), '.forge');
+const PID_FILE = join(DATA_DIR, 'forge.pid');
+const LOG_FILE = join(DATA_DIR, 'forge.log');
+
+const isDev = process.argv.includes('--dev');
+const isBackground = process.argv.includes('--background');
+const isStop = process.argv.includes('--stop');
+
+process.chdir(ROOT);
+mkdirSync(DATA_DIR, { recursive: true });
+
+// ── Stop ──
+if (isStop) {
+  try {
+    const pid = parseInt(readFileSync(PID_FILE, 'utf-8').trim());
+    process.kill(pid, 'SIGTERM');
+    unlinkSync(PID_FILE);
+    console.log(`[forge] Stopped (pid ${pid})`);
+  } catch {
+    console.log('[forge] No running server found');
+  }
+  process.exit(0);
+}
+
+// ── Background ──
+if (isBackground) {
+  // Build if needed
+  if (!existsSync(join(ROOT, '.next'))) {
+    console.log('[forge] Building...');
+    execSync('npx next build', { cwd: ROOT, stdio: 'inherit' });
+  }
+
+  const logFd = openSync(LOG_FILE, 'a');
+  const child = spawn('npx', ['next', 'start'], {
+    cwd: ROOT,
+    stdio: ['ignore', logFd, logFd],
+    env: { ...process.env },
+    detached: true,
+  });
+
+  writeFileSync(PID_FILE, String(child.pid));
+  child.unref();
+  console.log(`[forge] Started in background (pid ${child.pid})`);
+  console.log(`[forge] Log: ${LOG_FILE}`);
+  console.log(`[forge] Stop: forge-server --stop`);
+  process.exit(0);
+}
+
+// ── Foreground ──
+if (isDev) {
+  console.log('[forge] Starting in development mode...');
+  const child = spawn('npx', ['next', 'dev', '--turbopack'], {
+    cwd: ROOT,
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+  child.on('exit', (code) => process.exit(code || 0));
+} else {
+  if (!existsSync(join(ROOT, '.next'))) {
+    console.log('[forge] Building...');
+    execSync('npx next build', { cwd: ROOT, stdio: 'inherit' });
+  }
+  console.log('[forge] Starting server...');
+  const child = spawn('npx', ['next', 'start'], {
+    cwd: ROOT,
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+  child.on('exit', (code) => process.exit(code || 0));
+}

package/cli/mw.ts

@@ -229,7 +229,7 @@ async function main() {
       const flows = await api('/api/flows');
       if (flows.length === 0) {
         console.log('No flows defined.');
-        console.log(`Create flows in ~/.my-workflow/flows/*.yaml`);
+        console.log(`Create flows in ~/.forge/flows/*.yaml`);
         break;
       }
       for (const f of flows) {
@@ -313,7 +313,7 @@ async function main() {
       const { readFileSync } = await import('node:fs');
       const { homedir } = await import('node:os');
       const { join } = await import('node:path');
-      const pwFile = join(homedir(), '.my-workflow', 'password.json');
+      const pwFile = join(homedir(), '.forge', 'password.json');
       try {
         const data = JSON.parse(readFileSync(pwFile, 'utf-8'));
         const today = new Date().toISOString().slice(0, 10);

package/components/WebTerminal.tsx

@@ -836,7 +836,7 @@ const MemoTerminalPane = memo(function TerminalPane({
       fontSize: 13,
       fontFamily: 'Menlo, Monaco, "Courier New", monospace',
       scrollback: 10000,
-      logger: { debug: () => {}, info: () => {}, warn: () => {}, error: () => {} },
+      logger: { trace: () => {}, debug: () => {}, info: () => {}, warn: () => {}, error: () => {} },
       theme: {
         background: '#1a1a2e',
         foreground: '#e0e0e0',

package/lib/auth.ts

@@ -3,6 +3,7 @@ import Google from 'next-auth/providers/google';
 import Credentials from 'next-auth/providers/credentials';
 
 export const { handlers, signIn, signOut, auth } = NextAuth({
+  trustHost: true,
   providers: [
     // Google OAuth — for production use
     Google({
@@ -20,7 +21,7 @@ export const { handlers, signIn, signOut, auth } = NextAuth({
         const { getPassword } = await import('./password');
         const localPassword = getPassword();
         if (credentials?.password === localPassword) {
-          return { id: 'local', name: 'zliu', email: 'local@my-workflow' };
+          return { id: 'local', name: 'zliu', email: 'local@forge' };
         }
         return null;
       },

package/lib/cloudflared.ts

@@ -10,7 +10,7 @@ import { join } from 'node:path';
 import https from 'node:https';
 import http from 'node:http';
 
-const BIN_DIR = join(homedir(), '.my-workflow', 'bin');
+const BIN_DIR = join(homedir(), '.forge', 'bin');
 const BIN_NAME = platform() === 'win32' ? 'cloudflared.exe' : 'cloudflared';
 const BIN_PATH = join(BIN_DIR, BIN_NAME);
 
@@ -40,7 +40,7 @@ function getDownloadUrl(): string {
 function followRedirects(url: string, dest: string): Promise<void> {
   return new Promise((resolve, reject) => {
     const client = url.startsWith('https') ? https : http;
-    client.get(url, { headers: { 'User-Agent': 'my-workflow' } }, (res) => {
+    client.get(url, { headers: { 'User-Agent': 'forge' } }, (res) => {
       if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
         followRedirects(res.headers.location, dest).then(resolve, reject);
         return;

package/lib/flows.ts

@@ -1,7 +1,7 @@
 /**
  * Workflow (Flow) engine — loads YAML flow definitions and executes them.
  *
- * Flow files live in ~/.my-workflow/flows/*.yaml
+ * Flow files live in ~/.forge/flows/*.yaml
  */
 
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
@@ -12,7 +12,7 @@ import { createTask } from './task-manager';
 import { getProjectInfo } from './projects';
 import type { Task } from '@/src/types';
 
-const FLOWS_DIR = join(homedir(), '.my-workflow', 'flows');
+const FLOWS_DIR = join(homedir(), '.forge', 'flows');
 
 export interface FlowStep {
   project: string;

package/lib/init.ts

@@ -19,6 +19,12 @@ export function ensureInitialized() {
   if (gInit[initKey]) return;
   gInit[initKey] = true;
 
+  // Ensure AUTH_SECRET is set (NextAuth requires it)
+  if (!process.env.AUTH_SECRET) {
+    const { randomBytes } = require('node:crypto');
+    process.env.AUTH_SECRET = randomBytes(32).toString('hex');
+  }
+
   // Display login password (auto-generated, rotates daily)
   const password = getPassword();
   console.log(`[init] Login password: ${password} (valid today)`);

package/lib/password.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated login password.
- * Rotates daily. Saved to ~/.my-workflow/password.json with date.
+ * Rotates daily. Saved to ~/.forge/password.json with date.
  * CLI can read it via `mw password`.
  */
 
@@ -9,7 +9,7 @@ import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 import { randomBytes } from 'node:crypto';
 
-const PASSWORD_FILE = join(homedir(), '.my-workflow', 'password.json');
+const PASSWORD_FILE = join(homedir(), '.forge', 'password.json');
 
 function generatePassword(): string {
   // 8-char alphanumeric, easy to type

package/lib/session-watcher.ts

@@ -19,7 +19,7 @@ import {
 import { scanProjects } from './projects';
 import { loadSettings } from './settings';
 
-const DB_PATH = join(homedir(), '.my-workflow', 'data.db');
+const DB_PATH = join(homedir(), '.forge', 'data.db');
 
 // ─── Types ───────────────────────────────────────────────────
 

package/lib/settings.ts

@@ -3,7 +3,7 @@ import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 import YAML from 'yaml';
 
-const SETTINGS_FILE = join(homedir(), '.my-workflow', 'settings.yaml');
+const SETTINGS_FILE = join(homedir(), '.forge', 'settings.yaml');
 
 export interface Settings {
   projectRoots: string[];       // Multiple project directories

package/lib/task-manager.ts

@@ -222,8 +222,7 @@ function executeTask(task: Task): Promise<void> {
 
     // Resolve the actual claude CLI script path (claude is a symlink to a .js file)
     const resolvedClaude = resolveClaudePath(claudePath);
-    console.log(`[task-runner] Spawning: ${resolvedClaude.cmd} ${resolvedClaude.prefix.concat(args).join(' ')}`);
-    console.log(`[task-runner] CWD: ${task.projectPath}`);
+    console.log(`[task] ${task.projectName}: "${task.prompt.slice(0, 60)}..."`);
 
     const child = spawn(resolvedClaude.cmd, [...resolvedClaude.prefix, ...args], {
       cwd: task.projectPath,
@@ -243,7 +242,7 @@ function executeTask(task: Task): Promise<void> {
     });
 
     child.stdout?.on('data', (data: Buffer) => {
-      console.log(`[task-runner] stdout chunk: ${data.toString().slice(0, 200)}`);
+      // stdout chunk processing (silent)
 
       // Check if cancelled
       if (getTask(task.id)?.status === 'cancelled') {
@@ -275,14 +274,14 @@ function executeTask(task: Task): Promise<void> {
 
     child.stderr?.on('data', (data: Buffer) => {
       const text = data.toString().trim();
-      console.error(`[task-runner] stderr: ${text.slice(0, 300)}`);
+      // stderr logged to task log only
       if (text) {
         appendLog(task.id, { type: 'system', subtype: 'error', content: text, timestamp: new Date().toISOString() });
       }
     });
 
     child.on('exit', (code, signal) => {
-      console.log(`[task-runner] Process exited: code=${code}, signal=${signal}`);
+      // Process exit handled below
       // Process remaining buffer
       if (buffer.trim()) {
         try {
@@ -511,7 +510,7 @@ function startMonitorTask(task: Task) {
   const stopTail = tailSessionFile(fp, (newEntries) => {
     lastActivityTime = Date.now();
     lastEntryCount += newEntries.length;
-    console.log(`[monitor] ${task.id}: +${newEntries.length} entries (${lastEntryCount} total)`);
+    // Monitor entries tracked in task log only
 
     appendLog(task.id, {
       type: 'system', subtype: 'text',

package/lib/telegram-bot.ts

@@ -105,7 +105,7 @@ async function poll() {
 
 async function handleMessage(msg: any) {
   const chatId = msg.chat.id;
-  console.log(`[telegram] Message from chat ID: ${chatId}, user: ${msg.from?.username || msg.from?.first_name || 'unknown'}`);
+  // Message received (logged silently)
   const text: string = msg.text.trim();
   const replyTo = msg.reply_to_message?.message_id;
 

package/lib/terminal-standalone.ts

@@ -39,7 +39,7 @@ delete process.env.CLAUDECODE;
 
 // ─── Shared state persistence ─────────────────────────────────
 
-const STATE_DIR = join(homedir(), '.my-workflow');
+const STATE_DIR = join(homedir(), '.forge');
 const STATE_FILE = join(STATE_DIR, 'terminal-state.json');
 
 function loadTerminalState(): unknown {
@@ -245,7 +245,7 @@ wss.on('connection', (ws: WebSocket) => {
       } as Record<string, string>,
     });
 
-    console.log(`[terminal] Attached to tmux session "${name}" (pid: ${term.pid})`);
+    // Attached to tmux session (silent)
     ws.send(JSON.stringify({ type: 'connected', sessionName: name }));
 
     term.onData((data: string) => {
@@ -344,7 +344,7 @@ wss.on('connection', (ws: WebSocket) => {
     // Only kill the pty attach process, NOT the tmux session — it persists
     if (term) {
       term.kill();
-      console.log(`[terminal] Detached from tmux session "${sessionName}"`);
+      // Detached from tmux session (silent)
     }
 
     // Untrack this client

package/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/dev/types/routes.d.ts";
+import "./.next/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aion0/forge",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Unified AI workflow platform — multi-model task orchestration, persistent sessions, web terminal, remote access",
   "type": "module",
   "scripts": {
@@ -11,6 +11,7 @@
   },
   "bin": {
     "forge": "./cli/mw.ts",
+    "forge-server": "./bin/forge-server.mjs",
     "mw": "./cli/mw.ts"
   },
   "keywords": [

package/src/config/index.ts

@@ -4,7 +4,7 @@ import { join } from 'node:path';
 import YAML from 'yaml';
 import type { AppConfig, ProviderName, SessionTemplate } from '@/src/types';
 
-const CONFIG_DIR = join(homedir(), '.my-workflow');
+const CONFIG_DIR = join(homedir(), '.forge');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.yaml');
 const TEMPLATES_DIR = join(CONFIG_DIR, 'templates');