@aion0/forge 0.1.9 → 0.2.0

package/CLAUDE.md

@@ -1,3 +1,47 @@
+## Project: Forge (@aion0/forge)
+
+### Dev Commands
+```bash
+# Development (hot-reload)
+pnpm dev
+
+# Production (local)
+pnpm build && pnpm start
+
+# Publish to npm (bump version in package.json first)
+npm login
+npm publish --access public --otp=<code>
+
+# Install globally from local source (for testing)
+npm install -g /Users/zliu/IdeaProjects/my-workflow
+
+# Install from npm
+npm install -g @aion0/forge
+
+# Run via npm global install
+forge-server              # foreground (auto-builds if needed)
+forge-server --dev        # dev mode
+forge-server --background # background, logs to ~/.forge/forge.log
+forge-server --stop       # stop background server
+forge-server --rebuild    # force rebuild
+
+# CLI
+forge                     # help
+forge password            # show today's login password
+forge tasks               # list tasks
+forge task <project> "prompt"  # submit task
+
+# Terminal server runs on port 3001 (auto-started by Next.js)
+# Data directory: ~/.forge/
+# Config: ~/.forge/settings.yaml
+# Env: ~/.forge/.env.local
+```
+
+### Key Paths
+- Data: `~/.forge/` (settings, db, password, terminal-state, flows, bin)
+- npm package: `@aion0/forge`
+- GitHub: `github.com/aiwatching/forge`
+
 ## Obsidian Vault
 Location: /Users/zliu/MyDocuments/obsidian-project/Projects/Bastion
 When I ask about my notes, use bash to search and read files from this directory.

package/app/api/code/route.ts

@@ -0,0 +1,160 @@
+import { NextResponse } from 'next/server';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, extname } from 'node:path';
+import { homedir } from 'node:os';
+import { execSync } from 'node:child_process';
+import { loadSettings } from '@/lib/settings';
+
+interface FileNode {
+  name: string;
+  path: string;
+  type: 'file' | 'dir';
+  children?: FileNode[];
+}
+
+const IGNORE = new Set([
+  'node_modules', '.git', '.next', 'dist', 'build', '.idea', '.vscode',
+  '.DS_Store', 'coverage', '__pycache__', '.cache', '.output', 'target',
+]);
+
+const CODE_EXTS = new Set([
+  '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+  '.py', '.go', '.rs', '.java', '.kt', '.swift', '.c', '.cpp', '.h',
+  '.css', '.scss', '.html', '.json', '.yaml', '.yml', '.toml',
+  '.md', '.txt', '.sh', '.bash', '.zsh', '.fish',
+  '.sql', '.graphql', '.proto', '.env', '.gitignore',
+  '.xml', '.csv', '.lock',
+]);
+
+function isCodeFile(name: string): boolean {
+  if (name.startsWith('.') && !name.startsWith('.env') && !name.startsWith('.git')) return false;
+  const ext = extname(name);
+  if (!ext) return !name.includes('.'); // files like Makefile, Dockerfile
+  return CODE_EXTS.has(ext);
+}
+
+function scanDir(dir: string, base: string, depth: number = 0): FileNode[] {
+  if (depth > 5) return [];
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const nodes: FileNode[] = [];
+
+    const sorted = entries
+      .filter(e => !IGNORE.has(e.name) && !e.name.startsWith('.'))
+      .sort((a, b) => {
+        if (a.isDirectory() && !b.isDirectory()) return -1;
+        if (!a.isDirectory() && b.isDirectory()) return 1;
+        return a.name.localeCompare(b.name);
+      });
+
+    for (const entry of sorted) {
+      const fullPath = join(dir, entry.name);
+      const relPath = relative(base, fullPath);
+
+      if (entry.isDirectory()) {
+        const children = scanDir(fullPath, base, depth + 1);
+        if (children.length > 0) {
+          nodes.push({ name: entry.name, path: relPath, type: 'dir', children });
+        }
+      } else if (isCodeFile(entry.name)) {
+        nodes.push({ name: entry.name, path: relPath, type: 'file' });
+      }
+    }
+    return nodes;
+  } catch {
+    return [];
+  }
+}
+
+// GET /api/code?dir=<absolute-path>&file=<relative-path>
+//   dir mode: returns file tree for the given directory
+//   file mode: returns file content
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url);
+  const dir = searchParams.get('dir');
+  const filePath = searchParams.get('file');
+
+  if (!dir) {
+    return NextResponse.json({ tree: [], dirName: '' });
+  }
+
+  const resolvedDir = dir.replace(/^~/, homedir());
+
+  // Security: dir must be under a projectRoot
+  const settings = loadSettings();
+  const projectRoots = (settings.projectRoots || []).map(r => r.replace(/^~/, homedir()));
+  const allowed = projectRoots.some(root => resolvedDir.startsWith(root) || resolvedDir === root);
+  if (!allowed) {
+    return NextResponse.json({ error: 'Directory not under any project root' }, { status: 403 });
+  }
+
+  // Git diff for a specific file
+  const diffFile = searchParams.get('diff');
+  if (diffFile) {
+    const fullPath = join(resolvedDir, diffFile);
+    if (!fullPath.startsWith(resolvedDir)) {
+      return NextResponse.json({ error: 'Invalid path' }, { status: 400 });
+    }
+    try {
+      // Try staged + unstaged diff
+      let diff = '';
+      try { diff = execSync(`git diff -- "${diffFile}"`, { cwd: resolvedDir, encoding: 'utf-8', timeout: 5000 }); } catch {}
+      if (!diff) {
+        try { diff = execSync(`git diff HEAD -- "${diffFile}"`, { cwd: resolvedDir, encoding: 'utf-8', timeout: 5000 }); } catch {}
+      }
+      if (!diff) {
+        // Untracked file — show entire content as added
+        try {
+          const content = readFileSync(fullPath, 'utf-8');
+          diff = content.split('\n').map(l => `+${l}`).join('\n');
+        } catch {}
+      }
+      return NextResponse.json({ diff: diff || 'No changes' });
+    } catch {
+      return NextResponse.json({ diff: 'Failed to get diff' });
+    }
+  }
+
+  // Read file content
+  if (filePath) {
+    const fullPath = join(resolvedDir, filePath);
+    if (!fullPath.startsWith(resolvedDir)) {
+      return NextResponse.json({ error: 'Invalid path' }, { status: 400 });
+    }
+    try {
+      const stat = statSync(fullPath);
+      if (stat.size > 500_000) {
+        return NextResponse.json({ content: '// File too large to display', language: 'text' });
+      }
+      const content = readFileSync(fullPath, 'utf-8');
+      const ext = extname(fullPath).replace('.', '') || 'text';
+      return NextResponse.json({ content, language: ext });
+    } catch {
+      return NextResponse.json({ error: 'File not found' }, { status: 404 });
+    }
+  }
+
+  // Return file tree
+  const tree = scanDir(resolvedDir, resolvedDir);
+  const dirName = resolvedDir.split('/').pop() || resolvedDir;
+
+  // Git status: changed files
+  let gitChanges: { path: string; status: string }[] = [];
+  let gitBranch = '';
+  try {
+    gitBranch = execSync('git rev-parse --abbrev-ref HEAD', { cwd: resolvedDir, encoding: 'utf-8', timeout: 3000 }).trim();
+    const statusOut = execSync('git status --porcelain -u', { cwd: resolvedDir, encoding: 'utf-8', timeout: 5000 });
+    gitChanges = statusOut.replace(/\n$/, '').split('\n').filter(Boolean)
+      .map(line => {
+        // Format: XY<space>path — first 2 chars are status, char 3 is space, rest is path
+        if (line.length < 4) return null;
+        return {
+          status: line.substring(0, 2).trim() || 'M',
+          path: line.substring(3).replace(/\/$/, ''),
+        };
+      })
+      .filter((g): g is { status: string; path: string } => g !== null && !!g.path && !g.path.includes(' -> '));
+  } catch {}
+
+  return NextResponse.json({ tree, dirName, dirPath: resolvedDir, gitBranch, gitChanges });
+}

package/app/api/docs/route.ts

@@ -0,0 +1,85 @@
+import { NextResponse } from 'next/server';
+import { readdirSync, statSync, readFileSync } from 'node:fs';
+import { join, relative, extname } from 'node:path';
+import { homedir } from 'node:os';
+import { loadSettings } from '@/lib/settings';
+
+interface FileNode {
+  name: string;
+  path: string;      // relative to docRoot
+  type: 'file' | 'dir';
+  children?: FileNode[];
+}
+
+function scanDir(dir: string, base: string, depth: number = 0): FileNode[] {
+  if (depth > 6) return [];
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const nodes: FileNode[] = [];
+
+    // Sort: dirs first, then files, alphabetical
+    const sorted = entries
+      .filter(e => !e.name.startsWith('.') && e.name !== 'node_modules')
+      .sort((a, b) => {
+        if (a.isDirectory() && !b.isDirectory()) return -1;
+        if (!a.isDirectory() && b.isDirectory()) return 1;
+        return a.name.localeCompare(b.name);
+      });
+
+    for (const entry of sorted) {
+      const fullPath = join(dir, entry.name);
+      const relPath = relative(base, fullPath);
+
+      if (entry.isDirectory()) {
+        const children = scanDir(fullPath, base, depth + 1);
+        if (children.length > 0) {
+          nodes.push({ name: entry.name, path: relPath, type: 'dir', children });
+        }
+      } else if (extname(entry.name) === '.md') {
+        nodes.push({ name: entry.name, path: relPath, type: 'file' });
+      }
+    }
+    return nodes;
+  } catch {
+    return [];
+  }
+}
+
+// GET /api/docs — list doc roots and their file trees
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url);
+  const filePath = searchParams.get('file');
+  const rootIdx = parseInt(searchParams.get('root') || '0');
+
+  const settings = loadSettings();
+  const docRoots = (settings.docRoots || []).map(r => r.replace(/^~/, homedir()));
+
+  if (docRoots.length === 0) {
+    return NextResponse.json({ roots: [], tree: [], content: null });
+  }
+
+  const rootNames = docRoots.map(r => r.split('/').pop() || r);
+
+  // Read file content
+  if (filePath && rootIdx < docRoots.length) {
+    const root = docRoots[rootIdx];
+    const fullPath = join(root, filePath);
+    // Security: ensure path doesn't escape root
+    if (!fullPath.startsWith(root)) {
+      return NextResponse.json({ error: 'Invalid path' }, { status: 400 });
+    }
+    try {
+      const content = readFileSync(fullPath, 'utf-8');
+      return NextResponse.json({ content });
+    } catch {
+      return NextResponse.json({ error: 'File not found' }, { status: 404 });
+    }
+  }
+
+  // Return tree for selected root
+  const idx = Math.min(rootIdx, docRoots.length - 1);
+  const root = docRoots[idx];
+  const tree = scanDir(root, root);
+
+  return NextResponse.json({ roots: rootNames, rootPaths: docRoots, tree });
+}

package/app/api/docs/sessions/route.ts

@@ -0,0 +1,54 @@
+import { NextResponse } from 'next/server';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url);
+  const dir = searchParams.get('dir');
+  if (!dir) return NextResponse.json({ sessions: [] });
+
+  // Claude stores sessions at ~/.claude/projects/<path-with-dashes>/
+  const hash = dir.replace(/\//g, '-');
+  const claudeDir = join(homedir(), '.claude', 'projects', hash);
+
+  if (!existsSync(claudeDir)) {
+    return NextResponse.json({ sessions: [] });
+  }
+
+  try {
+    const files = readdirSync(claudeDir).filter(f => f.endsWith('.jsonl'));
+    const sessions = files.map(f => {
+      const sessionId = f.replace('.jsonl', '');
+      const filePath = join(claudeDir, f);
+      const stat = statSync(filePath);
+
+      // Read first line to get first prompt
+      let firstPrompt = '';
+      try {
+        const content = readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').filter(Boolean);
+        for (const line of lines) {
+          try {
+            const entry = JSON.parse(line);
+            if (entry.type === 'human' || entry.role === 'user') {
+              const text = typeof entry.message === 'string' ? entry.message
+                : entry.message?.content?.[0]?.text || '';
+              if (text) { firstPrompt = text.slice(0, 80); break; }
+            }
+          } catch {}
+        }
+      } catch {}
+
+      return {
+        sessionId,
+        firstPrompt,
+        modified: stat.mtime.toISOString(),
+      };
+    }).sort((a, b) => b.modified.localeCompare(a.modified));
+
+    return NextResponse.json({ sessions });
+  } catch {
+    return NextResponse.json({ sessions: [] });
+  }
+}

package/app/api/terminal-cwd/route.ts

@@ -0,0 +1,19 @@
+import { NextResponse } from 'next/server';
+import { execSync } from 'node:child_process';
+
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url);
+  const session = searchParams.get('session');
+  if (!session || !session.startsWith('mw-')) {
+    return NextResponse.json({ path: null });
+  }
+  try {
+    const cwd = execSync(`tmux display-message -p -t ${session} '#{pane_current_path}'`, {
+      encoding: 'utf-8',
+      timeout: 3000,
+    }).trim();
+    return NextResponse.json({ path: cwd || null });
+  } catch {
+    return NextResponse.json({ path: null });
+  }
+}