claude-flow 3.0.0-alpha.1 → 3.0.0-alpha.10

package/src/types.ts

@@ -0,0 +1,287 @@
+/**
+ * V3 CLI Type Definitions
+ * Modernized type system for the Claude Flow V3 CLI
+ */
+
+// ============================================
+// Core Command Types
+// ============================================
+
+export interface CommandContext {
+  args: string[];
+  flags: ParsedFlags;
+  config?: V3Config;
+  cwd: string;
+  interactive: boolean;
+}
+
+export interface ParsedFlags {
+  [key: string]: string | boolean | number | string[];
+  _: string[];
+}
+
+export interface Command {
+  name: string;
+  description: string;
+  aliases?: string[];
+  subcommands?: Command[];
+  options?: CommandOption[];
+  examples?: CommandExample[];
+  action?: CommandAction;
+  hidden?: boolean;
+}
+
+export interface CommandOption {
+  name: string;
+  short?: string;
+  description: string;
+  type: 'string' | 'boolean' | 'number' | 'array';
+  default?: unknown;
+  required?: boolean;
+  choices?: string[];
+  validate?: (value: unknown) => boolean | string;
+}
+
+export interface CommandExample {
+  command: string;
+  description: string;
+}
+
+export type CommandAction = (ctx: CommandContext) => Promise<CommandResult | void>;
+
+export interface CommandResult {
+  success: boolean;
+  message?: string;
+  data?: unknown;
+  exitCode?: number;
+}
+
+// ============================================
+// Configuration Types
+// ============================================
+
+export interface V3Config {
+  version: string;
+  projectRoot: string;
+
+  // Agent configuration
+  agents: AgentConfig;
+
+  // Swarm configuration
+  swarm: SwarmConfig;
+
+  // Memory configuration
+  memory: MemoryConfig;
+
+  // MCP configuration
+  mcp: MCPConfig;
+
+  // CLI preferences
+  cli: CLIPreferences;
+
+  // Hooks configuration
+  hooks: HooksConfig;
+}
+
+export interface AgentConfig {
+  defaultType: string;
+  autoSpawn: boolean;
+  maxConcurrent: number;
+  timeout: number;
+  providers: ProviderConfig[];
+}
+
+export interface ProviderConfig {
+  name: string;
+  apiKey?: string;
+  baseUrl?: string;
+  model?: string;
+  priority: number;
+  enabled: boolean;
+}
+
+export interface SwarmConfig {
+  topology: 'hierarchical' | 'mesh' | 'ring' | 'star' | 'hybrid';
+  maxAgents: number;
+  autoScale: boolean;
+  coordinationStrategy: 'consensus' | 'leader' | 'distributed';
+  healthCheckInterval: number;
+}
+
+export interface MemoryConfig {
+  backend: 'agentdb' | 'sqlite' | 'memory' | 'hybrid';
+  persistPath: string;
+  cacheSize: number;
+  enableHNSW: boolean;
+  vectorDimension: number;
+}
+
+export interface MCPConfig {
+  serverHost: string;
+  serverPort: number;
+  autoStart: boolean;
+  transportType: 'stdio' | 'http' | 'websocket';
+  tools: string[];
+}
+
+export interface CLIPreferences {
+  colorOutput: boolean;
+  interactive: boolean;
+  verbosity: 'quiet' | 'normal' | 'verbose' | 'debug';
+  outputFormat: 'text' | 'json' | 'table';
+  progressStyle: 'bar' | 'spinner' | 'dots' | 'none';
+}
+
+export interface HooksConfig {
+  enabled: boolean;
+  autoExecute: boolean;
+  hooks: HookDefinition[];
+}
+
+export interface HookDefinition {
+  name: string;
+  event: string;
+  handler: string;
+  priority: number;
+  enabled: boolean;
+}
+
+// ============================================
+// Output Types
+// ============================================
+
+export interface TableColumn {
+  key: string;
+  header: string;
+  width?: number;
+  align?: 'left' | 'center' | 'right';
+  format?: (value: unknown) => string;
+}
+
+export interface TableOptions {
+  columns: TableColumn[];
+  data: Record<string, unknown>[];
+  border?: boolean;
+  header?: boolean;
+  padding?: number;
+  maxWidth?: number;
+}
+
+export interface ProgressOptions {
+  total: number;
+  current?: number;
+  width?: number;
+  format?: string;
+  showPercentage?: boolean;
+  showETA?: boolean;
+  showSpeed?: boolean;
+}
+
+export interface SpinnerOptions {
+  text: string;
+  spinner?: 'dots' | 'line' | 'arc' | 'circle' | 'arrows';
+  color?: string;
+}
+
+// ============================================
+// Prompt Types
+// ============================================
+
+export interface SelectOption<T = string> {
+  value: T;
+  label: string;
+  hint?: string;
+  disabled?: boolean;
+  /** For multiselect: whether this option is selected by default */
+  selected?: boolean;
+}
+
+export interface SelectPromptOptions<T = string> {
+  message: string;
+  options: SelectOption<T>[];
+  default?: T;
+  searchable?: boolean;
+  pageSize?: number;
+}
+
+export interface ConfirmPromptOptions {
+  message: string;
+  default?: boolean;
+  active?: string;
+  inactive?: string;
+}
+
+export interface InputPromptOptions {
+  message: string;
+  default?: string;
+  placeholder?: string;
+  validate?: (value: string) => boolean | string;
+  mask?: boolean;
+}
+
+export interface MultiSelectPromptOptions<T = string> {
+  message: string;
+  options: SelectOption<T>[];
+  default?: T[];
+  required?: boolean;
+  min?: number;
+  max?: number;
+}
+
+// ============================================
+// Event Types
+// ============================================
+
+export type CLIEventType =
+  | 'command:start'
+  | 'command:end'
+  | 'command:error'
+  | 'prompt:start'
+  | 'prompt:complete'
+  | 'output:write'
+  | 'progress:update'
+  | 'spinner:start'
+  | 'spinner:stop';
+
+export interface CLIEvent {
+  type: CLIEventType;
+  timestamp: number;
+  data?: unknown;
+}
+
+// ============================================
+// Error Types
+// ============================================
+
+export class CLIError extends Error {
+  constructor(
+    message: string,
+    public code: string,
+    public exitCode: number = 1,
+    public details?: unknown
+  ) {
+    super(message);
+    this.name = 'CLIError';
+  }
+}
+
+export class ValidationError extends CLIError {
+  constructor(message: string, details?: unknown) {
+    super(message, 'VALIDATION_ERROR', 1, details);
+    this.name = 'ValidationError';
+  }
+}
+
+export class ConfigError extends CLIError {
+  constructor(message: string, details?: unknown) {
+    super(message, 'CONFIG_ERROR', 1, details);
+    this.name = 'ConfigError';
+  }
+}
+
+export class CommandNotFoundError extends CLIError {
+  constructor(commandName: string) {
+    super(`Unknown command: ${commandName}`, 'COMMAND_NOT_FOUND', 127);
+    this.name = 'CommandNotFoundError';
+  }
+}

package/dist/index.d.ts

@@ -1,30 +0,0 @@
-/**
- * claude-flow - Multi-agent AI orchestration for Claude Code
- */
-
-// Re-export all modules for convenient access
-export * from '@claude-flow/swarm';
-export * from '@claude-flow/memory';
-export * from '@claude-flow/hooks';
-export * from '@claude-flow/neural';
-export * from '@claude-flow/security';
-export * from '@claude-flow/plugins';
-export * from '@claude-flow/providers';
-export * from '@claude-flow/embeddings';
-export * from '@claude-flow/shared';
-
-// Re-export CLI for programmatic use
-export { CLI } from '@claude-flow/cli';
-
-// Version info
-export declare const VERSION = "3.0.0-alpha.1";
-export declare const V3_FEATURES: {
-  readonly swarmCoordination: true;
-  readonly selfLearning: true;
-  readonly hnswMemory: true;
-  readonly multiProviderLLM: true;
-  readonly backgroundWorkers: true;
-  readonly securityHardened: true;
-  readonly consensusAlgorithms: readonly ["raft", "byzantine", "gossip", "crdt", "quorum"];
-  readonly supportedTopologies: readonly ["hierarchical", "mesh", "ring", "star", "adaptive"];
-};

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAGvC,eAAO,MAAM,OAAO,kBAAkB,CAAC;AACvC,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC"}

package/dist/index.js

@@ -1,30 +0,0 @@
-/**
- * claude-flow - Multi-agent AI orchestration for Claude Code
- */
-
-// Re-export all modules for convenient access
-export * from '@claude-flow/swarm';
-export * from '@claude-flow/memory';
-export * from '@claude-flow/hooks';
-export * from '@claude-flow/neural';
-export * from '@claude-flow/security';
-export * from '@claude-flow/plugins';
-export * from '@claude-flow/providers';
-export * from '@claude-flow/embeddings';
-export * from '@claude-flow/shared';
-
-// Re-export CLI for programmatic use
-export { CLI } from '@claude-flow/cli';
-
-// Version info
-export const VERSION = '3.0.0-alpha.1';
-export const V3_FEATURES = {
-  swarmCoordination: true,
-  selfLearning: true,
-  hnswMemory: true,
-  multiProviderLLM: true,
-  backgroundWorkers: true,
-  securityHardened: true,
-  consensusAlgorithms: ['raft', 'byzantine', 'gossip', 'crdt', 'quorum'],
-  supportedTopologies: ['hierarchical', 'mesh', 'ring', 'star', 'adaptive'],
-};

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,8CAA8C;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAEpC,qCAAqC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,eAAe;AACf,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;IAChB,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,mBAAmB,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;IACtE,mBAAmB,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;CACjE,CAAC"}