agileflow 3.4.3 → 4.0.0-alpha.2

package/lib/protocol/driver.ts

@@ -1,354 +0,0 @@
-/**
- * CLI Driver Interface
- *
- * This module defines the abstract interface that all CLI drivers must implement.
- * Each driver translates its native CLI protocol into the unified IR format.
- */
-
-import { IREnvelope, IRSource } from './ir';
-
-// ============================================================================
-// Capability Types
-// ============================================================================
-
-/**
- * Named capabilities that drivers can support
- */
-export type CapabilityName =
-  | 'file.read'
-  | 'file.write'
-  | 'file.edit'
-  | 'shell.exec'
-  | 'web.search'
-  | 'web.fetch'
-  | 'session.resume'
-  | 'session.fork' // Codex only
-  | 'session.rollback' // Codex only
-  | 'agent.spawn' // Claude only
-  | 'todo.manage'
-  | 'checkpoint' // Gemini only
-  | 'conductor' // Gemini only
-  | 'mcp.support'
-  | 'image.vision';
-
-/**
- * Capability descriptor
- */
-export interface Capability {
-  name: CapabilityName;
-  available: boolean;
-  viaMcp?: boolean; // True if available via MCP extension
-  details?: string;
-}
-
-// ============================================================================
-// Driver Configuration
-// ============================================================================
-
-/**
- * Configuration for starting a driver
- */
-export interface DriverConfig {
-  /** Working directory for the CLI */
-  cwd: string;
-
-  /** Environment variables to pass to CLI */
-  env?: Record<string, string>;
-
-  /** API key (if required) */
-  apiKey?: string;
-
-  /** Model to use (e.g., "claude-3-opus", "gpt-4", "gemini-pro") */
-  model?: string;
-
-  /** Maximum context tokens */
-  maxTokens?: number;
-
-  /** Additional CLI-specific options */
-  options?: Record<string, unknown>;
-}
-
-/**
- * Driver status information
- */
-export interface DriverStatus {
-  state: 'starting' | 'ready' | 'busy' | 'error' | 'stopped';
-  provider: IRSource;
-  version?: string;
-  model?: string;
-  contextUsed?: number;
-  contextMax?: number;
-  error?: string;
-  lastActivity?: number;
-}
-
-// ============================================================================
-// CLI Commands (Dashboard -> Driver)
-// ============================================================================
-
-/**
- * Command types that can be sent to a driver
- */
-export type CLICommandType = 'message' | 'cancel' | 'refresh' | 'git' | 'terminal' | 'image';
-
-/**
- * Base command interface
- */
-export interface CLICommandBase {
-  type: CLICommandType;
-  id?: string; // Optional correlation ID
-}
-
-/**
- * Send a message to the AI
- */
-export interface CLIMessageCommand extends CLICommandBase {
-  type: 'message';
-  content: string;
-  images?: Array<{
-    base64: string;
-    mimeType: string;
-  }>;
-}
-
-/**
- * Cancel current operation
- */
-export interface CLICancelCommand extends CLICommandBase {
-  type: 'cancel';
-}
-
-/**
- * Request data refresh
- */
-export interface CLIRefreshCommand extends CLICommandBase {
-  type: 'refresh';
-  what: 'tasks' | 'status' | 'files' | 'git' | 'automations' | 'inbox';
-}
-
-/**
- * Git operation
- */
-export interface CLIGitCommand extends CLICommandBase {
-  type: 'git';
-  action: 'stage' | 'unstage' | 'revert' | 'commit' | 'push' | 'pr' | 'diff' | 'status';
-  path?: string;
-  message?: string;
-  push?: boolean;
-  title?: string;
-  body?: string;
-}
-
-/**
- * Terminal operation
- */
-export interface CLITerminalCommand extends CLICommandBase {
-  type: 'terminal';
-  action: 'spawn' | 'input' | 'resize' | 'close';
-  terminalId?: string;
-  data?: string;
-  cols?: number;
-  rows?: number;
-}
-
-/**
- * Union of all command types
- */
-export type CLICommand =
-  | CLIMessageCommand
-  | CLICancelCommand
-  | CLIRefreshCommand
-  | CLIGitCommand
-  | CLITerminalCommand;
-
-// ============================================================================
-// Driver Interface
-// ============================================================================
-
-/**
- * Event handler for IR messages
- */
-export type IREventHandler = (envelope: IREnvelope) => void;
-
-/**
- * Abstract driver interface that all CLI drivers must implement
- */
-export interface Driver {
-  /** Unique driver identifier */
-  readonly id: IRSource;
-
-  /** Human-readable driver name */
-  readonly name: string;
-
-  /** Current driver status */
-  readonly status: DriverStatus;
-
-  // -------------------------------------------------------------------------
-  // Lifecycle
-  // -------------------------------------------------------------------------
-
-  /**
-   * Start the driver for a session
-   */
-  start(sessionId: string, config: DriverConfig): Promise<void>;
-
-  /**
-   * Stop the driver for a session
-   */
-  stop(sessionId: string): Promise<void>;
-
-  /**
-   * Check if driver is available/installed
-   */
-  isAvailable(): Promise<boolean>;
-
-  // -------------------------------------------------------------------------
-  // Capabilities
-  // -------------------------------------------------------------------------
-
-  /**
-   * Get list of capabilities this driver supports
-   */
-  capabilities(): Capability[];
-
-  /**
-   * Check if a specific capability is available
-   */
-  hasCapability(name: CapabilityName): boolean;
-
-  // -------------------------------------------------------------------------
-  // Communication
-  // -------------------------------------------------------------------------
-
-  /**
-   * Send a command to the CLI
-   */
-  send(sessionId: string, command: CLICommand): Promise<void>;
-
-  // -------------------------------------------------------------------------
-  // Events
-  // -------------------------------------------------------------------------
-
-  /**
-   * Register handler for IR events
-   */
-  onEvent(handler: IREventHandler): void;
-
-  /**
-   * Remove event handler
-   */
-  offEvent(handler: IREventHandler): void;
-}
-
-// ============================================================================
-// Driver Manager
-// ============================================================================
-
-/**
- * Manages multiple CLI drivers
- */
-export interface DriverManager {
-  /**
-   * Register a driver
-   */
-  register(driver: Driver): void;
-
-  /**
-   * Get driver by ID
-   */
-  get(id: IRSource): Driver | undefined;
-
-  /**
-   * Get all registered drivers
-   */
-  all(): Driver[];
-
-  /**
-   * Get available (installed) drivers
-   */
-  available(): Promise<Driver[]>;
-
-  /**
-   * Get the default/preferred driver
-   */
-  default(): Driver | undefined;
-
-  /**
-   * Set the default driver
-   */
-  setDefault(id: IRSource): void;
-}
-
-// ============================================================================
-// Default Capabilities by Provider
-// ============================================================================
-
-export const CLAUDE_CAPABILITIES: Capability[] = [
-  { name: 'file.read', available: true },
-  { name: 'file.write', available: true },
-  { name: 'file.edit', available: true },
-  { name: 'shell.exec', available: true },
-  { name: 'web.search', available: true },
-  { name: 'web.fetch', available: true },
-  { name: 'session.resume', available: true },
-  { name: 'session.fork', available: false },
-  { name: 'session.rollback', available: false },
-  { name: 'agent.spawn', available: true },
-  { name: 'todo.manage', available: true },
-  { name: 'checkpoint', available: false },
-  { name: 'conductor', available: false },
-  { name: 'mcp.support', available: true },
-  { name: 'image.vision', available: true },
-];
-
-export const CODEX_CAPABILITIES: Capability[] = [
-  { name: 'file.read', available: true },
-  { name: 'file.write', available: true },
-  { name: 'file.edit', available: true },
-  { name: 'shell.exec', available: true },
-  { name: 'web.search', available: true },
-  { name: 'web.fetch', available: true },
-  { name: 'session.resume', available: true },
-  { name: 'session.fork', available: true },
-  { name: 'session.rollback', available: true },
-  { name: 'agent.spawn', available: false },
-  { name: 'todo.manage', available: false },
-  { name: 'checkpoint', available: false },
-  { name: 'conductor', available: false },
-  { name: 'mcp.support', available: true },
-  { name: 'image.vision', available: true },
-];
-
-export const GEMINI_CAPABILITIES: Capability[] = [
-  { name: 'file.read', available: true },
-  { name: 'file.write', available: true },
-  { name: 'file.edit', available: true },
-  { name: 'shell.exec', available: true },
-  { name: 'web.search', available: true },
-  { name: 'web.fetch', available: true },
-  { name: 'session.resume', available: true },
-  { name: 'session.fork', available: false },
-  { name: 'session.rollback', available: false },
-  { name: 'agent.spawn', available: false },
-  { name: 'todo.manage', available: true },
-  { name: 'checkpoint', available: true },
-  { name: 'conductor', available: true },
-  { name: 'mcp.support', available: true },
-  { name: 'image.vision', available: true },
-];
-
-/**
- * Get default capabilities for a provider
- */
-export function getDefaultCapabilities(source: IRSource): Capability[] {
-  switch (source) {
-    case 'claude':
-      return CLAUDE_CAPABILITIES;
-    case 'codex':
-      return CODEX_CAPABILITIES;
-    case 'gemini':
-      return GEMINI_CAPABILITIES;
-    default:
-      return [];
-  }
-}

package/lib/protocol/index.ts

@@ -1,12 +0,0 @@
-/**
- * Multi-CLI Protocol Module
- *
- * This module exports the unified IR types and Driver interface
- * for supporting multiple CLI providers (Claude, Codex, Gemini).
- */
-
-// IR Types
-export * from './ir';
-
-// Driver Interface
-export * from './driver';

package/lib/protocol/ir.ts

@@ -1,271 +0,0 @@
-/**
- * Intermediate Representation (IR) Types
- *
- * This module defines the unified message format that all CLI drivers
- * translate their native formats into. The dashboard consumes IR messages
- * regardless of which CLI provider is being used.
- */
-
-// ============================================================================
-// IR Message Types
-// ============================================================================
-
-/**
- * All possible IR message kinds
- */
-export type IRKind =
-  | 'init' // Session initialization complete
-  | 'text' // Text content (non-streaming)
-  | 'text_delta' // Streaming text delta
-  | 'tool_start' // Tool execution started
-  | 'tool_result' // Tool execution completed
-  | 'file_op' // File operation (read/write/edit)
-  | 'shell' // Shell command execution
-  | 'task' // Task management (create/update/list)
-  | 'session' // Session state change
-  | 'status' // Status update (stories, epics)
-  | 'git' // Git operation
-  | 'terminal' // Terminal output
-  | 'notification' // Notification
-  | 'error' // Error occurred
-  | 'done'; // Response complete
-
-/**
- * Source CLI provider identifier
- */
-export type IRSource = 'claude' | 'codex' | 'gemini';
-
-/**
- * Envelope wrapping all IR messages
- */
-export interface IREnvelope<T = unknown> {
-  kind: IRKind;
-  ts: number; // Unix timestamp (Date.now())
-  seq: number; // Monotonic sequence number per session
-  sessionId: string; // Session identifier
-  source: IRSource; // Which CLI produced this
-  payload: T;
-}
-
-// ============================================================================
-// IR Payload Types
-// ============================================================================
-
-/**
- * Session initialization payload
- */
-export interface IRInit {
-  provider: IRSource;
-  version: string;
-  capabilities: string[];
-  maxContext: number;
-}
-
-/**
- * Text content payload
- */
-export interface IRText {
-  text: string;
-  role: 'assistant' | 'system';
-}
-
-/**
- * Streaming text delta payload
- */
-export interface IRTextDelta {
-  text: string;
-  done: boolean;
-}
-
-/**
- * Tool execution started payload
- */
-export interface IRToolStart {
-  id: string;
-  name: string; // Normalized tool name (e.g., "file_read")
-  nativeName: string; // Original CLI tool name (e.g., "Read")
-  input: Record<string, unknown>;
-}
-
-/**
- * Tool execution result payload
- */
-export interface IRToolResult {
-  id: string;
-  ok: boolean;
-  output?: unknown;
-  error?: string;
-  durationMs?: number;
-}
-
-/**
- * File operation payload
- */
-export interface IRFileOp {
-  action: 'read' | 'write' | 'edit';
-  path: string;
-  content?: string;
-  diff?: {
-    before: string;
-    after: string;
-    hunks?: Array<{
-      oldStart: number;
-      oldLines: number;
-      newStart: number;
-      newLines: number;
-      content: string;
-    }>;
-  };
-  language?: string;
-}
-
-/**
- * Shell command payload
- */
-export interface IRShell {
-  command: string;
-  output: string;
-  exitCode: number;
-  cwd?: string;
-  durationMs?: number;
-}
-
-/**
- * Task operation payload
- */
-export interface IRTask {
-  action: 'create' | 'update' | 'delete' | 'list';
-  task?: {
-    id: string;
-    subject: string;
-    description?: string;
-    status: 'pending' | 'in_progress' | 'completed';
-    activeForm?: string;
-  };
-  tasks?: Array<{
-    id: string;
-    subject: string;
-    status: 'pending' | 'in_progress' | 'completed';
-  }>;
-}
-
-/**
- * Session state change payload
- */
-export interface IRSession {
-  state: 'connected' | 'thinking' | 'idle' | 'error' | 'disconnected';
-  message?: string;
-}
-
-/**
- * Git operation payload
- */
-export interface IRGit {
-  action: 'status' | 'commit' | 'push' | 'stage' | 'unstage' | 'diff';
-  branch?: string;
-  staged?: Array<{ path: string; status: string; additions?: number; deletions?: number }>;
-  unstaged?: Array<{ path: string; status: string; additions?: number; deletions?: number }>;
-  commitHash?: string;
-  diff?: string;
-}
-
-/**
- * Terminal output payload
- */
-export interface IRTerminal {
-  terminalId: string;
-  data: string;
-  type: 'stdout' | 'stderr' | 'exit';
-  exitCode?: number;
-}
-
-/**
- * Notification payload
- */
-export interface IRNotification {
-  level: 'info' | 'success' | 'warning' | 'error';
-  title: string;
-  message: string;
-}
-
-/**
- * Error payload
- */
-export interface IRError {
-  code: string;
-  message: string;
-  details?: unknown;
-  recoverable: boolean;
-}
-
-// ============================================================================
-// Factory Functions
-// ============================================================================
-
-let _seq = 0;
-
-/**
- * Create an IR envelope with auto-incrementing sequence number
- */
-export function createIREnvelope<T>(
-  kind: IRKind,
-  sessionId: string,
-  source: IRSource,
-  payload: T
-): IREnvelope<T> {
-  return {
-    kind,
-    ts: Date.now(),
-    seq: ++_seq,
-    sessionId,
-    source,
-    payload,
-  };
-}
-
-/**
- * Reset sequence counter (for testing)
- */
-export function resetIRSequence(): void {
-  _seq = 0;
-}
-
-// ============================================================================
-// Type Guards
-// ============================================================================
-
-export function isIRTextDelta(env: IREnvelope): env is IREnvelope<IRTextDelta> {
-  return env.kind === 'text_delta';
-}
-
-export function isIRToolStart(env: IREnvelope): env is IREnvelope<IRToolStart> {
-  return env.kind === 'tool_start';
-}
-
-export function isIRToolResult(env: IREnvelope): env is IREnvelope<IRToolResult> {
-  return env.kind === 'tool_result';
-}
-
-export function isIRFileOp(env: IREnvelope): env is IREnvelope<IRFileOp> {
-  return env.kind === 'file_op';
-}
-
-export function isIRShell(env: IREnvelope): env is IREnvelope<IRShell> {
-  return env.kind === 'shell';
-}
-
-export function isIRTask(env: IREnvelope): env is IREnvelope<IRTask> {
-  return env.kind === 'task';
-}
-
-export function isIRSession(env: IREnvelope): env is IREnvelope<IRSession> {
-  return env.kind === 'session';
-}
-
-export function isIRGit(env: IREnvelope): env is IREnvelope<IRGit> {
-  return env.kind === 'git';
-}
-
-export function isIRError(env: IREnvelope): env is IREnvelope<IRError> {
-  return env.kind === 'error';
-}

package/lib/registry-cache.js

@@ -1,80 +0,0 @@
-'use strict';
-
-const { MtimeCache } = require('./cache-provider');
-
-/**
- * Registry scanning cache
- * Caches directory scan results keyed by path + mtime.
- * TTL-based expiration (default 60s).
- *
- * Uses MtimeCache from cache-provider for unified caching with
- * automatic mtime invalidation.
- */
-
-const DEFAULT_TTL_MS = 60 * 1000;
-
-const _cache = new MtimeCache({ maxSize: 50, ttlMs: DEFAULT_TTL_MS });
-
-/**
- * Get cached scan result for a directory
- * @param {string} dirPath - Directory path
- * @param {Object} [options]
- * @param {boolean} [options.noCache] - Bypass cache entirely
- * @returns {*|null} Cached result or null if miss/expired
- */
-function getCached(dirPath, options = {}) {
-  if (options.noCache) return null;
-  return _cache.get(dirPath) ?? null;
-}
-
-/**
- * Store scan result in cache
- * @param {string} dirPath - Directory path
- * @param {*} data - Data to cache
- */
-function setCached(dirPath, data) {
-  _cache.set(dirPath, data);
-}
-
-/**
- * Clear all cached entries
- */
-function clearCache() {
-  _cache.clear();
-}
-
-/**
- * Get cache stats
- * @returns {{ size: number, hits: number, misses: number, hitRate: string }}
- */
-function getCacheStats() {
-  return _cache.getStats();
-}
-
-/**
- * Wrap a scan function with caching
- * @param {Function} scanFn - Function that takes (dirPath, ...args) and returns results
- * @param {Object} [options]
- * @param {boolean} [options.noCache] - Bypass cache
- * @returns {Function} Cached version of scanFn
- */
-function withCache(scanFn, options = {}) {
-  return function cachedScan(dirPath, ...args) {
-    const noCache = process.argv.includes('--no-cache') || options.noCache;
-    const cached = getCached(dirPath, { noCache });
-    if (cached !== null) return cached;
-
-    const result = scanFn(dirPath, ...args);
-    setCached(dirPath, result);
-    return result;
-  };
-}
-
-module.exports = {
-  getCached,
-  setCached,
-  clearCache,
-  getCacheStats,
-  withCache,
-  DEFAULT_TTL_MS,
-};