speci 0.3.0 → 0.4.0

package/README.md

@@ -7,7 +7,6 @@ AI-powered implementation loop orchestrator for GitHub Copilot.
 - **Automated Implementation Loops** - Orchestrates Copilot-driven development workflows
 - **Gate Validation** - Runs lint, typecheck, and test commands before committing
 - **Progress Tracking** - Maintains state in PROGRESS.md with task completion tracking
-- **Real-time Monitoring** - TUI-based log viewer with live updates
 - **Beautiful CLI** - Ice Blue styling with unicode glyphs and ANSI colors
 
 ## Quick Start
@@ -267,41 +266,6 @@ speci run --dry-run
 
 **Note:** This command intentionally has no short alias for safety.
 
-### `speci monitor` (alias: `m`)
-
-Real-time TUI log viewer with live updates.
-
-**Usage:**
-
-```bash
-speci monitor [options]
-```
-
-**Options:**
-
-- `-l, --log-file <path>` - Custom log file to monitor
-- `--poll-interval <ms>` - Polling interval in milliseconds
-- `--max-lines <n>` - Maximum lines to display
-- `-v, --verbose` - Show detailed output
-
-**Examples:**
-
-```bash
-# Monitor default log file
-speci monitor
-
-# Short alias version
-speci m
-
-# Limit display buffer
-speci monitor --max-lines 1000
-```
-
-**Controls:**
-
-- Arrow keys / Page Up/Down - Scroll through log
-- `q` or `Ctrl+C` - Exit monitor
-
 ## Configuration
 
 ### speci.config.json

package/bin/speci.ts

@@ -15,12 +15,20 @@ import { task } from '../lib/commands/task.js';
 import { refactor } from '../lib/commands/refactor.js';
 import { run } from '../lib/commands/run.js';
 import { status } from '../lib/commands/status.js';
-import monitor from '../lib/commands/monitor.js';
 import { findSimilarCommands } from '../lib/utils/suggest.js';
 import { setVerbose, debug } from '../lib/utils/logger.js';
 
 /**
- * Display the application banner
+ * Display the static (non-animated) banner
+ *
+ * @param options - Optional configuration for banner display
+ */
+function displayStaticBanner(): void {
+  console.log('\n' + renderBanner({ showVersion: true }) + '\n');
+}
+
+/**
+ * Display the application banner with animation when appropriate
  *
  * Conditionally animates the banner when appropriate conditions are met.
  * Returns a Promise when animation is enabled, or void when displaying static banner.
@@ -32,7 +40,7 @@ function displayBanner(options?: { color?: boolean }): Promise<void> | void {
     console.log();
     return animateBanner().then(() => console.log());
   } else {
-    console.log('\n' + renderBanner({ showVersion: true }) + '\n');
+    displayStaticBanner();
   }
 }
 
@@ -56,14 +64,16 @@ program
       debug('Arguments', process.argv);
     }
 
-    // Display banner before any command, except for --help and --version
+    // Display banner before any command, except for --help, --version, --json output, or status command
     const args = process.argv;
     const isHelpOrVersion =
       args.includes('--help') ||
       args.includes('-h') ||
       args.includes('--version') ||
       args.includes('-V');
-    if (!isHelpOrVersion) {
+    const isJsonOutput = args.includes('--json');
+    const isStatusCommand = args.includes('status') || args.includes('s');
+    if (!isHelpOrVersion && !isJsonOutput && !isStatusCommand) {
       const result = displayBanner({ color: opts.color });
       if (result instanceof Promise) {
         await result;
@@ -179,50 +189,26 @@ Examples:
 program
   .command('status')
   .alias('s')
-  .description('Show current loop state and task statistics')
-  .option('--json', 'Output status as JSON')
+  .description(
+    'Show current loop state and task statistics (live fullscreen dashboard)'
+  )
+  .option('--json', 'Output status as JSON and exit')
+  .option('--once', 'Show status once and exit (non-interactive)')
   .option('-v, --verbose', 'Show detailed status')
   .addHelpText(
     'after',
     `
 Examples:
-  $ speci status                       Show current status
+  $ speci status                       Live fullscreen dashboard (press q to quit)
+  $ speci s --once                     Show status once and exit
   $ speci s --json                     Output as JSON for scripts
   $ speci status --verbose             Detailed status information
 `
   )
   .action(status);
 
-// Monitor Command (alias: m)
-program
-  .command('monitor')
-  .alias('m')
-  .description('Real-time log viewer with TUI')
-  .option('-l, --log-file <path>', 'Custom log file to monitor')
-  .option('--poll-interval <ms>', 'Polling interval in milliseconds', parseInt)
-  .option('--max-lines <n>', 'Maximum lines to display', parseInt)
-  .option('-v, --verbose', 'Show detailed output')
-  .addHelpText(
-    'after',
-    `
-Examples:
-  $ speci monitor                      Monitor default log file
-  $ speci m                            Short alias version
-  $ speci monitor --max-lines 1000     Limit display buffer
-`
-  )
-  .action(monitor);
-
 // List of all available commands (for unknown command handling)
-const availableCommands = [
-  'init',
-  'plan',
-  'task',
-  'refactor',
-  'run',
-  'status',
-  'monitor',
-];
+const availableCommands = ['init', 'plan', 'task', 'refactor', 'run', 'status'];
 
 // Unknown command handler
 program.on('command:*', (operands) => {
@@ -241,8 +227,14 @@ program.on('command:*', (operands) => {
   process.exit(2);
 });
 
-// Show banner and help when no arguments provided
+// Check if help or version is being requested
+const args = process.argv.slice(2);
+const isHelpRequest =
+  args.includes('-h') || args.includes('--help') || args[0] === 'help';
+const isVersionRequest = args.includes('-V') || args.includes('--version');
+
 if (process.argv.length <= 2) {
+  // No arguments: show animated banner + help
   (async () => {
     const result = displayBanner({ color: program.opts().color });
     if (result instanceof Promise) {
@@ -250,7 +242,14 @@ if (process.argv.length <= 2) {
     }
     program.help();
   })();
+} else if (isHelpRequest) {
+  // Help request: show static banner + help
+  displayStaticBanner();
+  program.parse(process.argv);
+} else if (isVersionRequest) {
+  // Version request: just show version (no banner)
+  program.parse(process.argv);
 } else {
-  // Parse command line arguments (only when a command is provided)
+  // Regular command: parse normally (preAction hook handles banner)
   program.parse(process.argv);
 }

package/lib/commands/init.ts

@@ -14,15 +14,15 @@ import {
   statSync,
 } from 'node:fs';
 import { join, relative } from 'node:path';
-import { log } from '../utils/logger.js';
-import { renderBanner } from '../ui/banner.js';
-import { colorize } from '../ui/colors.js';
+import { log } from '@/utils/logger.js';
+import { renderBanner } from '@/ui/banner.js';
+import { colorize } from '@/ui/colors.js';
 import {
   getDefaults,
   getAgentsTemplatePath,
   GITHUB_AGENTS_DIR,
   type SpeciConfig,
-} from '../config.js';
+} from '@/config.js';
 
 /**
  * Options for the init command

package/lib/commands/plan.ts

@@ -8,13 +8,13 @@
 
 import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { loadConfig, resolveAgentPath } from '../config.js';
-import { buildCopilotArgs, spawnCopilot } from '../copilot.js';
-import { preflight } from '../utils/preflight.js';
-import { renderBanner } from '../ui/banner.js';
-import { log } from '../utils/logger.js';
-import { drawBox } from '../ui/box.js';
-import { colorize } from '../ui/colors.js';
+import { loadConfig, resolveAgentPath } from '@/config.js';
+import { buildCopilotArgs, spawnCopilot } from '@/copilot.js';
+import { preflight } from '@/utils/preflight.js';
+import { renderBanner } from '@/ui/banner.js';
+import { log } from '@/utils/logger.js';
+import { drawBox } from '@/ui/box.js';
+import { colorize } from '@/ui/colors.js';
 
 /**
  * Options for the plan command

package/lib/commands/refactor.ts

@@ -8,12 +8,12 @@
 
 import { existsSync, statSync } from 'node:fs';
 import { isAbsolute, resolve } from 'node:path';
-import { loadConfig, resolveAgentPath } from '../config.js';
-import { buildCopilotArgs, spawnCopilot } from '../copilot.js';
-import { preflight } from '../utils/preflight.js';
-import { renderBanner } from '../ui/banner.js';
-import { log } from '../utils/logger.js';
-import { infoBox } from '../ui/box.js';
+import { loadConfig, resolveAgentPath } from '@/config.js';
+import { buildCopilotArgs, spawnCopilot } from '@/copilot.js';
+import { preflight } from '@/utils/preflight.js';
+import { renderBanner } from '@/ui/banner.js';
+import { log } from '@/utils/logger.js';
+import { infoBox } from '@/ui/box.js';
 
 /**
  * Options for the refactor command

package/lib/commands/run.ts

@@ -11,24 +11,24 @@ import { mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
 import { Writable } from 'node:stream';
-import { loadConfig, type SpeciConfig } from '../config.js';
-import { getState, STATE } from '../state.js';
+import { loadConfig, type SpeciConfig } from '@/config.js';
+import { getState, STATE } from '@/state.js';
 import {
   acquireLock,
   releaseLock,
   isLocked,
   getLockInfo,
-} from '../utils/lock.js';
-import { preflight } from '../utils/preflight.js';
-import { runGate, resetGateAttempts } from '../utils/gate.js';
-import { runAgent } from '../copilot.js';
-import { renderBanner } from '../ui/banner.js';
-import { log } from '../utils/logger.js';
+} from '@/utils/lock.js';
+import { preflight } from '@/utils/preflight.js';
+import { runGate, resetGateAttempts } from '@/utils/gate.js';
+import { runAgent } from '@/copilot.js';
+import { renderBanner } from '@/ui/banner.js';
+import { log } from '@/utils/logger.js';
 import {
   installSignalHandlers,
   registerCleanup,
   removeSignalHandlers,
-} from '../utils/signals.js';
+} from '@/utils/signals.js';
 
 /**
  * Options for the run command