wiggum-cli 0.6.0 → 0.7.2

package/src/repl/repl-loop.ts

@@ -9,6 +9,8 @@ import { logger } from '../utils/logger.js';
 import { simpson } from '../utils/colors.js';
 import { runCommand } from '../commands/run.js';
 import { monitorCommand } from '../commands/monitor.js';
+import { runInitWorkflow } from '../commands/init.js';
+import { hasConfig } from '../utils/config.js';
 import type { SessionState } from './session-state.js';
 import { updateSessionState } from './session-state.js';
 import {
@@ -21,13 +23,64 @@ import {
 const PROMPT = `${simpson.yellow('wiggum')}${simpson.brown('>')} `;
 
 /**
- * Handler for the /new command - will be enhanced in Phase 3
+ * Handler for the /init command
+ */
+async function handleInitCommand(
+  _args: string[],
+  state: SessionState,
+  rl: readline.Interface
+): Promise<SessionState> {
+  // Check if already initialized
+  if (state.initialized && hasConfig(state.projectRoot)) {
+    logger.warn('Project is already initialized. Re-running init will update configuration.');
+    console.log('');
+  }
+
+  // Pause REPL readline to avoid conflicts with subcommand's stdin usage
+  rl.pause();
+
+  try {
+    const result = await runInitWorkflow(state.projectRoot, {
+      yes: false, // Always interactive in REPL
+    });
+
+    if (result) {
+      // Update state with init result
+      return updateSessionState(state, {
+        provider: result.provider,
+        model: result.model,
+        scanResult: result.scanResult,
+        config: result.config,
+        initialized: true,
+      });
+    }
+
+    // User cancelled
+    return state;
+  } catch (error) {
+    logger.error(`Init failed: ${error instanceof Error ? error.message : String(error)}`);
+    return state;
+  } finally {
+    // Resume REPL readline after subcommand completes
+    rl.resume();
+  }
+}
+
+/**
+ * Handler for the /new command
+ * Always uses AI interview mode in REPL (falls back to template if no API key)
  */
 async function handleNewCommand(
   args: string[],
   state: SessionState,
   rl: readline.Interface
 ): Promise<SessionState> {
+  // Check if initialized
+  if (!state.initialized && !hasConfig(state.projectRoot)) {
+    logger.warn('Project not initialized. Run /init first.');
+    return state;
+  }
+
   if (args.length === 0) {
     logger.error('Feature name required. Usage: /new <feature-name>');
     return state;
@@ -40,12 +93,14 @@ async function handleNewCommand(
 
   try {
     // Delegate to the existing new command behavior
+    // Always use AI mode in REPL (the command handles fallback to template if no API key)
     const { newCommand } = await import('../commands/new.js');
     await newCommand(featureName, {
       yes: false,
       scanResult: state.scanResult,
-      provider: state.provider,
+      provider: state.provider ?? undefined,
       model: state.model,
+      ai: true, // Always use AI interview in REPL
     });
   } finally {
     // Resume REPL readline after subcommand completes
@@ -63,6 +118,12 @@ async function handleRunCommand(
   state: SessionState,
   rl: readline.Interface
 ): Promise<SessionState> {
+  // Check if initialized
+  if (!state.initialized && !hasConfig(state.projectRoot)) {
+    logger.warn('Project not initialized. Run /init first.');
+    return state;
+  }
+
   if (args.length === 0) {
     logger.error('Feature name required. Usage: /run <feature-name>');
     return state;
@@ -128,6 +189,9 @@ async function executeCommand(
   rl: readline.Interface
 ): Promise<{ state: SessionState; shouldExit: boolean }> {
   switch (commandName) {
+    case 'init':
+      return { state: await handleInitCommand(args, state, rl), shouldExit: false };
+
     case 'new':
       return { state: await handleNewCommand(args, state, rl), shouldExit: false };
 
@@ -218,7 +282,13 @@ export async function startRepl(initialState: SessionState): Promise<void> {
 
   console.log('');
   console.log(simpson.yellow('Wiggum Interactive Mode'));
-  console.log(pc.dim('Type /help for commands, /exit to quit'));
+
+  // Show context-aware welcome message
+  if (!state.initialized && !hasConfig(state.projectRoot)) {
+    console.log(pc.dim('Not initialized. Run /init to set up this project.'));
+  } else {
+    console.log(pc.dim('Type /help for commands, /exit to quit'));
+  }
   console.log('');
 
   const rl = readline.createInterface({

package/src/repl/session-state.ts

@@ -16,7 +16,7 @@ export interface SessionState {
   /** Loaded Ralph configuration */
   config: RalphConfig | null;
   /** AI provider being used */
-  provider: AIProvider;
+  provider: AIProvider | null;
   /** Model to use for AI operations */
   model: string;
   /** Cached scan result from init */
@@ -25,6 +25,8 @@ export interface SessionState {
   conversationMode: boolean;
   /** Current conversation context (e.g., 'spec-generation') */
   conversationContext?: string;
+  /** Whether /init has been run in this session */
+  initialized: boolean;
 }
 
 /**
@@ -32,10 +34,11 @@ export interface SessionState {
  */
 export function createSessionState(
   projectRoot: string,
-  provider: AIProvider,
+  provider: AIProvider | null,
   model: string,
   scanResult?: ScanResult,
-  config?: RalphConfig | null
+  config?: RalphConfig | null,
+  initialized?: boolean
 ): SessionState {
   return {
     projectRoot,
@@ -45,6 +48,7 @@ export function createSessionState(
     scanResult,
     conversationMode: false,
     conversationContext: undefined,
+    initialized: initialized ?? false,
   };
 }
 

package/src/templates/config/ralph.config.cjs.tmpl

@@ -0,0 +1,38 @@
+module.exports = {
+  name: '{{projectName}}',
+  stack: {
+    framework: {
+      name: '{{framework}}',
+      version: '{{frameworkVersion}}',
+      variant: '{{frameworkVariant}}',
+    },
+    packageManager: '{{packageManager}}',
+    testing: {
+      unit: '{{unitTest}}',
+      e2e: '{{e2eTest}}',
+    },
+    styling: '{{styling}}',
+  },
+  commands: {
+    dev: '{{devCommand}}',
+    build: '{{buildCommand}}',
+    test: '{{testCommand}}',
+    lint: '{{lintCommand}}',
+    typecheck: '{{typecheckCommand}}',
+  },
+  paths: {
+    root: '.ralph',
+    prompts: '.ralph/prompts',
+    guides: '.ralph/guides',
+    specs: '.ralph/specs',
+    scripts: '.ralph/scripts',
+    learnings: '.ralph/LEARNINGS.md',
+    agents: '.ralph/AGENTS.md',
+  },
+  loop: {
+    maxIterations: 10,
+    maxE2eAttempts: 5,
+    defaultModel: 'sonnet',
+    planningModel: 'opus',
+  },
+};

package/src/templates/root/README.md.tmpl

@@ -58,4 +58,4 @@ Add new feature specs to `.ralph/specs/`:
 
 ## Configuration
 
-See `ralph.config.js` in project root for full configuration.
+See `ralph.config.cjs` in project root for full configuration.

package/src/templates/scripts/feature-loop.sh.tmpl

@@ -14,23 +14,23 @@ set -o pipefail
 # Get script directory
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
-# Load config from ralph.config.js if available
-if [ -f "$SCRIPT_DIR/../ralph.config.js" ]; then
-    RALPH_ROOT=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').paths?.root || '.ralph')" 2>/dev/null || echo ".ralph")
-    SPEC_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').paths?.specs || '.ralph/specs')" 2>/dev/null || echo ".ralph/specs")
-    PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
-    DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
-    PLANNING_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').loop?.planningModel || 'opus')" 2>/dev/null || echo "opus")
-    DEFAULT_MAX_ITERATIONS=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').loop?.maxIterations || 10)" 2>/dev/null || echo "10")
-    DEFAULT_MAX_E2E=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').loop?.maxE2eAttempts || 5)" 2>/dev/null || echo "5")
-elif [ -f "$SCRIPT_DIR/../../ralph.config.js" ]; then
-    RALPH_ROOT=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').paths?.root || '.ralph')" 2>/dev/null || echo ".ralph")
-    SPEC_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').paths?.specs || '.ralph/specs')" 2>/dev/null || echo ".ralph/specs")
-    PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
-    DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
-    PLANNING_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').loop?.planningModel || 'opus')" 2>/dev/null || echo "opus")
-    DEFAULT_MAX_ITERATIONS=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').loop?.maxIterations || 10)" 2>/dev/null || echo "10")
-    DEFAULT_MAX_E2E=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').loop?.maxE2eAttempts || 5)" 2>/dev/null || echo "5")
+# Load config from ralph.config.cjs if available
+if [ -f "$SCRIPT_DIR/../ralph.config.cjs" ]; then
+    RALPH_ROOT=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').paths?.root || '.ralph')" 2>/dev/null || echo ".ralph")
+    SPEC_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').paths?.specs || '.ralph/specs')" 2>/dev/null || echo ".ralph/specs")
+    PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
+    DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
+    PLANNING_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').loop?.planningModel || 'opus')" 2>/dev/null || echo "opus")
+    DEFAULT_MAX_ITERATIONS=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').loop?.maxIterations || 10)" 2>/dev/null || echo "10")
+    DEFAULT_MAX_E2E=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').loop?.maxE2eAttempts || 5)" 2>/dev/null || echo "5")
+elif [ -f "$SCRIPT_DIR/../../ralph.config.cjs" ]; then
+    RALPH_ROOT=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').paths?.root || '.ralph')" 2>/dev/null || echo ".ralph")
+    SPEC_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').paths?.specs || '.ralph/specs')" 2>/dev/null || echo ".ralph/specs")
+    PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
+    DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
+    PLANNING_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').loop?.planningModel || 'opus')" 2>/dev/null || echo "opus")
+    DEFAULT_MAX_ITERATIONS=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').loop?.maxIterations || 10)" 2>/dev/null || echo "10")
+    DEFAULT_MAX_E2E=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').loop?.maxE2eAttempts || 5)" 2>/dev/null || echo "5")
 else
     # Default paths
     RALPH_ROOT=".ralph"

package/src/templates/scripts/loop.sh.tmpl

@@ -8,13 +8,13 @@ set -e
 # Get script directory
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
-# Load config from ralph.config.js if available
-if [ -f "$SCRIPT_DIR/../ralph.config.js" ]; then
-    PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
-    DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
-elif [ -f "$SCRIPT_DIR/../../ralph.config.js" ]; then
-    PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
-    DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
+# Load config from ralph.config.cjs if available
+if [ -f "$SCRIPT_DIR/../ralph.config.cjs" ]; then
+    PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
+    DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
+elif [ -f "$SCRIPT_DIR/../../ralph.config.cjs" ]; then
+    PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
+    DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
 else
     PROMPTS_DIR=".ralph/prompts"
     DEFAULT_MODEL="sonnet"

package/src/templates/scripts/ralph-monitor.sh.tmpl

@@ -6,11 +6,11 @@
 FEATURE="${1:?Usage: ./ralph-monitor.sh <feature-name>}"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
-# Load config from ralph.config.js if available
-if [ -f "$SCRIPT_DIR/../ralph.config.js" ]; then
-    SPEC_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.js').paths?.specs || '.ralph/specs')" 2>/dev/null || echo ".ralph/specs")
-elif [ -f "$SCRIPT_DIR/../../ralph.config.js" ]; then
-    SPEC_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.js').paths?.specs || '.ralph/specs')" 2>/dev/null || echo ".ralph/specs")
+# Load config from ralph.config.cjs if available
+if [ -f "$SCRIPT_DIR/../ralph.config.cjs" ]; then
+    SPEC_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').paths?.specs || '.ralph/specs')" 2>/dev/null || echo ".ralph/specs")
+elif [ -f "$SCRIPT_DIR/../../ralph.config.cjs" ]; then
+    SPEC_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').paths?.specs || '.ralph/specs')" 2>/dev/null || echo ".ralph/specs")
 else
     SPEC_DIR=".ralph/specs"
 fi

package/src/utils/config.ts

@@ -1,6 +1,6 @@
 /**
  * Configuration Utilities
- * Load and parse ralph.config.js files
+ * Load and parse ralph.config.cjs files
  */
 
 import { existsSync } from 'node:fs';
@@ -9,7 +9,7 @@ import { pathToFileURL } from 'node:url';
 import { logger } from './logger.js';
 
 /**
- * Stack configuration in ralph.config.js
+ * Stack configuration in ralph.config.cjs
  */
 export interface StackConfig {
   framework: {
@@ -26,7 +26,7 @@ export interface StackConfig {
 }
 
 /**
- * Commands configuration in ralph.config.js
+ * Commands configuration in ralph.config.cjs
  */
 export interface CommandsConfig {
   dev: string;
@@ -37,7 +37,7 @@ export interface CommandsConfig {
 }
 
 /**
- * Paths configuration in ralph.config.js
+ * Paths configuration in ralph.config.cjs
  */
 export interface PathsConfig {
   root: string;
@@ -50,7 +50,7 @@ export interface PathsConfig {
 }
 
 /**
- * Loop configuration in ralph.config.js
+ * Loop configuration in ralph.config.cjs
  */
 export interface LoopConfig {
   maxIterations: number;
@@ -60,7 +60,7 @@ export interface LoopConfig {
 }
 
 /**
- * Full ralph.config.js structure
+ * Full ralph.config.cjs structure
  */
 export interface RalphConfig {
   name: string;
@@ -113,11 +113,11 @@ export const DEFAULT_CONFIG: RalphConfig = {
 };
 
 /**
- * Load ralph.config.js from a project directory
+ * Load ralph.config.cjs from a project directory
  * Returns null if config file doesn't exist
  */
 export async function loadConfig(projectRoot: string): Promise<RalphConfig | null> {
-  const configPath = join(projectRoot, 'ralph.config.js');
+  const configPath = join(projectRoot, 'ralph.config.cjs');
 
   if (!existsSync(configPath)) {
     return null;
@@ -179,7 +179,7 @@ export async function loadConfigWithDefaults(projectRoot: string): Promise<Ralph
  * Check if a ralph config exists in the project
  */
 export function hasConfig(projectRoot: string): boolean {
-  const configPath = join(projectRoot, 'ralph.config.js');
+  const configPath = join(projectRoot, 'ralph.config.cjs');
   return existsSync(configPath);
 }
 

package/src/utils/update-check.ts

@@ -0,0 +1,182 @@
+/**
+ * Update Check Utility
+ * Checks npm registry for newer versions and notifies user
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import pc from 'picocolors';
+
+const PACKAGE_NAME = 'wiggum-cli';
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const CACHE_FILE = path.join(os.homedir(), '.wiggum-update-check.json');
+
+interface UpdateCheckCache {
+  lastCheck: number;
+  latestVersion: string | null;
+}
+
+interface UpdateInfo {
+  currentVersion: string;
+  latestVersion: string;
+  updateAvailable: boolean;
+}
+
+/**
+ * Get current package version
+ */
+function getCurrentVersion(): string {
+  try {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    // Go up from utils/ to package root
+    const packageJsonPath = path.join(__dirname, '..', '..', 'package.json');
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version;
+  } catch {
+    return '0.0.0';
+  }
+}
+
+/**
+ * Read cache file
+ */
+function readCache(): UpdateCheckCache | null {
+  try {
+    if (fs.existsSync(CACHE_FILE)) {
+      return JSON.parse(fs.readFileSync(CACHE_FILE, 'utf-8'));
+    }
+  } catch {
+    // Ignore cache read errors
+  }
+  return null;
+}
+
+/**
+ * Write cache file
+ */
+function writeCache(cache: UpdateCheckCache): void {
+  try {
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache), 'utf-8');
+  } catch {
+    // Ignore cache write errors
+  }
+}
+
+/**
+ * Fetch latest version from npm registry
+ */
+async function fetchLatestVersion(): Promise<string | null> {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3000); // 3s timeout
+
+    const response = await fetch(
+      `https://registry.npmjs.org/${PACKAGE_NAME}/latest`,
+      { signal: controller.signal }
+    );
+
+    clearTimeout(timeout);
+
+    if (!response.ok) {
+      return null;
+    }
+
+    const data = await response.json();
+    return data.version || null;
+  } catch {
+    // Network error or timeout - fail silently
+    return null;
+  }
+}
+
+/**
+ * Compare semantic versions
+ * Returns true if v2 is newer than v1
+ */
+function isNewer(v1: string, v2: string): boolean {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    const p1 = parts1[i] || 0;
+    const p2 = parts2[i] || 0;
+    if (p2 > p1) return true;
+    if (p2 < p1) return false;
+  }
+  return false;
+}
+
+/**
+ * Check for updates (with caching)
+ * Returns update info if check was performed, null if skipped/failed
+ */
+export async function checkForUpdates(): Promise<UpdateInfo | null> {
+  const currentVersion = getCurrentVersion();
+  const cache = readCache();
+  const now = Date.now();
+
+  // Use cached result if recent enough
+  if (cache && (now - cache.lastCheck) < CHECK_INTERVAL_MS && cache.latestVersion) {
+    return {
+      currentVersion,
+      latestVersion: cache.latestVersion,
+      updateAvailable: isNewer(currentVersion, cache.latestVersion),
+    };
+  }
+
+  // Fetch latest version
+  const latestVersion = await fetchLatestVersion();
+
+  if (latestVersion) {
+    writeCache({ lastCheck: now, latestVersion });
+    return {
+      currentVersion,
+      latestVersion,
+      updateAvailable: isNewer(currentVersion, latestVersion),
+    };
+  }
+
+  return null;
+}
+
+/**
+ * Display update notification if available
+ * Call this at startup - it's non-blocking and fails silently
+ */
+export async function notifyIfUpdateAvailable(): Promise<void> {
+  try {
+    const info = await checkForUpdates();
+
+    if (info?.updateAvailable) {
+      console.log('');
+      console.log(
+        pc.yellow('╭─────────────────────────────────────────────────────────╮')
+      );
+      console.log(
+        pc.yellow('│') +
+          pc.bold('  Update available: ') +
+          pc.dim(info.currentVersion) +
+          pc.bold(' → ') +
+          pc.green(info.latestVersion) +
+          '                    ' +
+          pc.yellow('│')
+      );
+      console.log(
+        pc.yellow('│') +
+          '  Run ' +
+          pc.cyan('npm i -g wiggum-cli') +
+          ' to update                  ' +
+          pc.yellow('│')
+      );
+      console.log(
+        pc.yellow('╰─────────────────────────────────────────────────────────╯')
+      );
+      console.log('');
+    }
+  } catch {
+    // Fail silently - don't interrupt user workflow
+  }
+}