autoworkflow 3.9.1 → 3.11.0

package/CLAUDE.md

@@ -124,6 +124,41 @@ All state stored in `.claude/.autoworkflow/`:
 
 ---
 
+## Logging System
+
+Real-time visibility into hook execution, gates, and workflow events.
+
+**Log Location:** `.claude/.autoworkflow/logs/aw.log`
+
+**CLI Commands:**
+```bash
+npx autoworkflow logs          # Watch logs in real-time
+npx autoworkflow logs --recent # Show last 50 entries
+npx autoworkflow logs --all    # Show all logs
+npx autoworkflow logs --clear  # Clear logs
+npx autoworkflow logs --stats  # Show statistics
+```
+
+**Or use tail directly:**
+```bash
+tail -f .claude/.autoworkflow/logs/aw.log
+```
+
+**Log Categories:**
+| Category | Events |
+|----------|--------|
+| HOOK | Hook start/complete |
+| PHASE | Phase transitions |
+| GATE | Gate checks (pass/block) |
+| VERIFY | Verification iterations |
+| MEMORY | Memory update prompts |
+| COMMIT | Commit events |
+| ERROR | Errors and failures |
+
+**Debug Mode:** Set `AUTOWORKFLOW_DEBUG=1` to see logs in terminal.
+
+---
+
 ## Memory System (Serena-inspired)
 
 Persistent context that survives across sessions. **Claude edits files directly** + hooks prompt at key moments.
@@ -246,6 +281,7 @@ npm run format        # Prettier
 | `phase-transition.sh` | Manual call | State management |
 | `audit-runner.sh` | Manual call | Run UI + cycle audits |
 | `blueprint-generator.sh` | Manual call | Enhanced project discovery (8 scans) |
+| `logger.sh` | Sourced by hooks | Centralized logging system |
 
 ---
 

package/bin/cli.js

@@ -72,6 +72,12 @@ Commands:
   ${colors.cyan('update')}            Smart update - core files only, preserve user files
   ${colors.cyan('status')}            Show installed version and what would change
 
+  ${colors.cyan('logs')}              View AutoWorkflow logs (real-time)
+  ${colors.cyan('logs --recent')}     Show last 50 log entries
+  ${colors.cyan('logs --all')}        Show all logs
+  ${colors.cyan('logs --clear')}      Clear all logs
+  ${colors.cyan('logs --stats')}      Show log statistics
+
   ${colors.cyan('help')}              Show this help message
 
 Options:
@@ -82,7 +88,7 @@ Examples:
   npx autoworkflow init          # Fresh install
   npx autoworkflow update        # Update core files only
   npx autoworkflow status        # Check what would change
-  npx autoworkflow init --force  # Full reinstall
+  npx autoworkflow logs          # Watch logs in real-time
 `);
 }
 
@@ -453,6 +459,62 @@ function init(options = {}) {
   console.log(`${colors.dim('Optional: Edit instructions/AI_RULES.md to customize coding standards')}\n`);
 }
 
+// Logs command
+import { spawn } from 'child_process';
+
+function logs() {
+  const cwd = process.cwd();
+  const loggerScript = join(cwd, '.claude', 'hooks', 'logger.sh');
+
+  // Check if logger exists
+  if (!existsSync(loggerScript)) {
+    console.log(`${colors.yellow('⚠')} AutoWorkflow not initialized in this directory.`);
+    console.log(`  Run: npx autoworkflow init`);
+    process.exit(1);
+  }
+
+  // Determine subcommand
+  const subCommand = args[1] || 'live';
+
+  let loggerArg;
+  switch (subCommand) {
+    case '--recent':
+    case '-r':
+      loggerArg = 'recent';
+      break;
+    case '--all':
+    case '-a':
+      loggerArg = 'all';
+      break;
+    case '--clear':
+    case '-c':
+      loggerArg = 'clear';
+      break;
+    case '--stats':
+    case '-s':
+      loggerArg = 'stats';
+      break;
+    default:
+      loggerArg = 'live';
+  }
+
+  // Run the logger script
+  const child = spawn('bash', [loggerScript, loggerArg], {
+    cwd: cwd,
+    stdio: 'inherit',
+    env: { ...process.env, CLAUDE_PROJECT_DIR: cwd }
+  });
+
+  child.on('error', (err) => {
+    console.error(`${colors.red('Error:')} ${err.message}`);
+    process.exit(1);
+  });
+
+  child.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+}
+
 // Main
 switch (command) {
   case 'init':
@@ -464,6 +526,10 @@ switch (command) {
   case 'status':
     status();
     break;
+  case 'logs':
+  case 'log':
+    logs();
+    break;
   case 'help':
   case '--help':
   case '-h':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoworkflow",
-  "version": "3.9.1",
+  "version": "3.11.0",
   "description": "Automated workflow enforcement for Claude Code via hooks and system prompts",
   "type": "module",
   "bin": {