claude-flow 3.6.30 → 3.7.0-alpha.1

package/.claude/settings.local.json

@@ -0,0 +1 @@
+{}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.6.30",
+  "version": "3.7.0-alpha.1",
   "description": "Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "dist/index.js",
   "type": "module",

package/v3/@claude-flow/cli/dist/src/mcp-tools/types.d.ts

@@ -1,37 +1,8 @@
 /**
- * MCP Tool Types for CLI
+ * MCP Tool Types — re-export shim (ADR-100, alpha.5).
  *
- * Local type definitions to avoid external imports outside package boundary.
+ * Authoritative source: @claude-flow/cli-core/mcp-tools/types. Was a 46-line
+ * byte-identical copy. Re-exports MCPTool, MCPToolInputSchema, MCPToolResult.
  */
-export interface MCPToolInputSchema {
-    type: 'object';
-    properties: Record<string, unknown>;
-    required?: string[];
-}
-export interface MCPToolResult {
-    content: Array<{
-        type: 'text' | 'image' | 'resource';
-        text?: string;
-        data?: string;
-        mimeType?: string;
-    }>;
-    isError?: boolean;
-}
-/**
- * Returns the effective project working directory.
- * Prefers CLAUDE_FLOW_CWD (set by the install script for global/MCP installs
- * where process.cwd() may resolve to '/') over the real process.cwd().
- */
-export declare function getProjectCwd(): string;
-export interface MCPTool {
-    name: string;
-    description: string;
-    inputSchema: MCPToolInputSchema;
-    category?: string;
-    tags?: string[];
-    version?: string;
-    cacheable?: boolean;
-    cacheTTL?: number;
-    handler: (input: Record<string, unknown>, context?: Record<string, unknown>) => Promise<MCPToolResult | unknown>;
-}
+export * from '@claude-flow/cli-core/mcp-tools/types';
 //# sourceMappingURL=types.d.ts.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/types.js

@@ -1,18 +1,8 @@
 /**
- * MCP Tool Types for CLI
+ * MCP Tool Types — re-export shim (ADR-100, alpha.5).
  *
- * Local type definitions to avoid external imports outside package boundary.
+ * Authoritative source: @claude-flow/cli-core/mcp-tools/types. Was a 46-line
+ * byte-identical copy. Re-exports MCPTool, MCPToolInputSchema, MCPToolResult.
  */
-/**
- * Returns the effective project working directory.
- * Prefers CLAUDE_FLOW_CWD (set by the install script for global/MCP installs
- * where process.cwd() may resolve to '/') over the real process.cwd().
- */
-export function getProjectCwd() {
-    const envCwd = process.env.CLAUDE_FLOW_CWD;
-    if (envCwd && envCwd !== '/' && envCwd !== process.env.HOME) {
-        return envCwd;
-    }
-    return process.cwd();
-}
+export * from '@claude-flow/cli-core/mcp-tools/types';
 //# sourceMappingURL=types.js.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/validate-input.d.ts

@@ -1,61 +1,9 @@
 /**
- * Input Validation for MCP Tools
+ * Input Validation for MCP Tools — re-export shim (ADR-100, alpha.5).
  *
- * Loads @claude-flow/security validators when available
- * and provides lightweight fallback validation otherwise.
- *
- * Addresses #1425: security validators were implemented but never wired to runtime.
- */
-export interface ValidationResult {
-    valid: boolean;
-    sanitized: string;
-    error?: string;
-}
-/**
- * Validate an identifier (agent ID, agent type, namespace, key, etc.)
- * Rejects shell metacharacters and path traversal.
- */
-export declare function validateIdentifier(value: unknown, label: string): ValidationResult;
-/**
- * Validate a git ref (HEAD~1, main..feature, commit hashes, etc.).
- * Allows ~, ^, and / which are standard git revision selectors.
- */
-export declare function validateGitRef(value: unknown, label: string): ValidationResult;
-/**
- * Validate an npm package name (allows @scope/name format).
- */
-export declare function validatePackageName(value: unknown, label: string): ValidationResult;
-/**
- * Validate a file path (prevents traversal and shell injection).
- */
-export declare function validatePath(value: unknown, label: string): ValidationResult;
-/**
- * Validate a free-text string (description, value, etc.)
- * Allows most characters but rejects shell metacharacters that could cause injection.
- */
-export declare function validateText(value: unknown, label: string, maxLen?: number): ValidationResult;
-export interface EnvValidationResult {
-    valid: boolean;
-    sanitized: Record<string, string>;
-    error?: string;
-}
-/**
- * Validate a Record<string,string> of environment variables: enforce POSIX
- * names, reject hijack-prone names (LD_PRELOAD, NODE_OPTIONS, …), forbid null
- * bytes in values, and cap value length so a malicious caller can't bloat the
- * stored session past reasonable bounds.
- */
-export declare function validateEnv(value: unknown, label?: string): EnvValidationResult;
-/**
- * Assert validation or throw with a structured error.
- */
-export declare function assertValid(result: ValidationResult): string;
-/**
- * Enhanced validation using @claude-flow/security Zod schemas when available.
- * Falls back to inline regex validation otherwise.
+ * Authoritative source: @claude-flow/cli-core/mcp-tools/validate-input.
+ * Was a 256-line byte-identical copy. Loads @claude-flow/security validators
+ * when available, with lightweight fallback otherwise.
  */
-export declare function validateAgentSpawn(input: Record<string, unknown>): Promise<{
-    valid: boolean;
-    errors: string[];
-}>;
+export * from '@claude-flow/cli-core/mcp-tools/validate-input';
 //# sourceMappingURL=validate-input.d.ts.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/validate-input.js

@@ -1,237 +1,9 @@
 /**
- * Input Validation for MCP Tools
+ * Input Validation for MCP Tools — re-export shim (ADR-100, alpha.5).
  *
- * Loads @claude-flow/security validators when available
- * and provides lightweight fallback validation otherwise.
- *
- * Addresses #1425: security validators were implemented but never wired to runtime.
- */
-// Patterns for input sanitization (inline — no external dependency required)
-const SHELL_META = /[;&|`$(){}[\]<>!#\\]/;
-const PATH_TRAVERSAL = /\.\.[/\\]/;
-const IDENTIFIER_RE = /^[a-zA-Z0-9_][a-zA-Z0-9_\-.:]{0,127}$/;
-const GIT_REF_RE = /^[a-zA-Z0-9_][a-zA-Z0-9_\-.:~^/]{0,255}$/;
-const NPM_PACKAGE_RE = /^(@[a-zA-Z0-9_\-]+\/)?[a-zA-Z0-9_\-][a-zA-Z0-9_\-.]{0,213}$/;
-/**
- * Validate an identifier (agent ID, agent type, namespace, key, etc.)
- * Rejects shell metacharacters and path traversal.
- */
-export function validateIdentifier(value, label) {
-    if (typeof value !== 'string' || value.length === 0) {
-        return { valid: false, sanitized: '', error: `${label} must be a non-empty string` };
-    }
-    if (value.length > 128) {
-        return { valid: false, sanitized: '', error: `${label} exceeds 128 characters` };
-    }
-    if (SHELL_META.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains disallowed characters` };
-    }
-    if (PATH_TRAVERSAL.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains path traversal` };
-    }
-    if (!IDENTIFIER_RE.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains invalid characters (allowed: alphanumeric, _, -, ., :)` };
-    }
-    return { valid: true, sanitized: value };
-}
-/**
- * Validate a git ref (HEAD~1, main..feature, commit hashes, etc.).
- * Allows ~, ^, and / which are standard git revision selectors.
- */
-export function validateGitRef(value, label) {
-    if (typeof value !== 'string' || value.length === 0) {
-        return { valid: false, sanitized: '', error: `${label} must be a non-empty string` };
-    }
-    if (value.length > 256) {
-        return { valid: false, sanitized: '', error: `${label} exceeds 256 characters` };
-    }
-    if (SHELL_META.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains disallowed characters` };
-    }
-    if (!GIT_REF_RE.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains invalid characters (allowed: alphanumeric, _, -, ., :, ~, ^, /)` };
-    }
-    return { valid: true, sanitized: value };
-}
-/**
- * Validate an npm package name (allows @scope/name format).
- */
-export function validatePackageName(value, label) {
-    if (typeof value !== 'string' || value.length === 0) {
-        return { valid: false, sanitized: '', error: `${label} must be a non-empty string` };
-    }
-    if (value.length > 214) {
-        return { valid: false, sanitized: '', error: `${label} exceeds 214 characters` };
-    }
-    if (SHELL_META.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains disallowed characters` };
-    }
-    if (!NPM_PACKAGE_RE.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains invalid characters (expected npm package name, e.g. @scope/name)` };
-    }
-    return { valid: true, sanitized: value };
-}
-/**
- * Validate a file path (prevents traversal and shell injection).
- */
-export function validatePath(value, label) {
-    if (typeof value !== 'string' || value.length === 0) {
-        return { valid: false, sanitized: '', error: `${label} must be a non-empty string` };
-    }
-    if (value.length > 4096) {
-        return { valid: false, sanitized: '', error: `${label} exceeds 4096 characters` };
-    }
-    if (PATH_TRAVERSAL.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains path traversal (..)` };
-    }
-    if (SHELL_META.test(value)) {
-        return { valid: false, sanitized: '', error: `${label} contains shell metacharacters` };
-    }
-    return { valid: true, sanitized: value };
-}
-/**
- * Validate a free-text string (description, value, etc.)
- * Allows most characters but rejects shell metacharacters that could cause injection.
- */
-export function validateText(value, label, maxLen = 10_000) {
-    if (typeof value !== 'string') {
-        return { valid: false, sanitized: '', error: `${label} must be a string` };
-    }
-    if (value.length > maxLen) {
-        return { valid: false, sanitized: '', error: `${label} exceeds ${maxLen} characters` };
-    }
-    // Strip null bytes
-    const sanitized = value.replace(/\0/g, '');
-    return { valid: true, sanitized };
-}
-/**
- * Names that let an attacker pivot a child process before any user code runs:
- * shared-library injection on Linux/macOS, Node hooks, and command resolution.
- *
- * audit_1776853149979: terminal_create previously merged caller-supplied env
- * straight into execSync's environment for every subsequent command in the
- * session. Setting LD_PRELOAD or NODE_OPTIONS via that path is functionally
- * equivalent to remote code execution, so the env input needs an allowlist
- * shape and a denylist on these specific names.
- */
-const DENYLISTED_ENV_NAMES = new Set([
-    'LD_PRELOAD',
-    'LD_LIBRARY_PATH',
-    'LD_AUDIT',
-    'DYLD_INSERT_LIBRARIES',
-    'DYLD_LIBRARY_PATH',
-    'DYLD_FALLBACK_LIBRARY_PATH',
-    'DYLD_FORCE_FLAT_NAMESPACE',
-    'NODE_OPTIONS',
-    'NODE_PATH',
-]);
-const ENV_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]{0,127}$/;
-/**
- * Validate a Record<string,string> of environment variables: enforce POSIX
- * names, reject hijack-prone names (LD_PRELOAD, NODE_OPTIONS, …), forbid null
- * bytes in values, and cap value length so a malicious caller can't bloat the
- * stored session past reasonable bounds.
- */
-export function validateEnv(value, label = 'env') {
-    if (value === undefined || value === null) {
-        return { valid: true, sanitized: {} };
-    }
-    if (typeof value !== 'object' || Array.isArray(value)) {
-        return { valid: false, sanitized: {}, error: `${label} must be an object of string→string` };
-    }
-    const out = {};
-    for (const [name, rawVal] of Object.entries(value)) {
-        if (!ENV_NAME_RE.test(name)) {
-            return { valid: false, sanitized: {}, error: `${label} key "${name}" is not a valid POSIX env name` };
-        }
-        if (DENYLISTED_ENV_NAMES.has(name)) {
-            return { valid: false, sanitized: {}, error: `${label} key "${name}" is denylisted (loader/runtime hijack)` };
-        }
-        if (typeof rawVal !== 'string') {
-            return { valid: false, sanitized: {}, error: `${label}["${name}"] must be a string` };
-        }
-        if (rawVal.length > 32_768) {
-            return { valid: false, sanitized: {}, error: `${label}["${name}"] exceeds 32768 characters` };
-        }
-        if (rawVal.includes('\0')) {
-            return { valid: false, sanitized: {}, error: `${label}["${name}"] contains a null byte` };
-        }
-        out[name] = rawVal;
-    }
-    return { valid: true, sanitized: out };
-}
-/**
- * Assert validation or throw with a structured error.
- */
-export function assertValid(result) {
-    if (!result.valid) {
-        throw new Error(`Validation failed: ${result.error}`);
-    }
-    return result.sanitized;
-}
-// Try to load the full @claude-flow/security module for enhanced validation
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-let _securityModule = null;
-let _securityLoaded = false;
-async function getSecurityModule() {
-    if (_securityLoaded)
-        return _securityModule;
-    _securityLoaded = true;
-    try {
-        // Dynamic import — @claude-flow/security is an optional dependency
-        _securityModule = await Function('return import("@claude-flow/security")')();
-    }
-    catch {
-        // @claude-flow/security is optional — fallback to inline validation above
-    }
-    return _securityModule;
-}
-/**
- * Enhanced validation using @claude-flow/security Zod schemas when available.
- * Falls back to inline regex validation otherwise.
+ * Authoritative source: @claude-flow/cli-core/mcp-tools/validate-input.
+ * Was a 256-line byte-identical copy. Loads @claude-flow/security validators
+ * when available, with lightweight fallback otherwise.
  */
-export async function validateAgentSpawn(input) {
-    const errors = [];
-    // Always run inline validation
-    if (input.agentType) {
-        const r = validateIdentifier(input.agentType, 'agentType');
-        if (!r.valid)
-            errors.push(r.error);
-    }
-    if (input.agentId) {
-        const r = validateIdentifier(input.agentId, 'agentId');
-        if (!r.valid)
-            errors.push(r.error);
-    }
-    if (input.domain) {
-        const r = validateIdentifier(input.domain, 'domain');
-        if (!r.valid)
-            errors.push(r.error);
-    }
-    // Try enhanced Zod validation if available.
-    // Fix for #1567: @claude-flow/security's SpawnAgentSchema expects `type` and
-    // `id` (not `agentType`/`name`), so the previous call always failed with
-    // "type: Required". Also swallow `invalid_enum_value` errors because the
-    // schema enumerates only 15 built-in agent types — we support custom types
-    // (the inline validator already checked the identifier is safe).
-    const sec = await getSecurityModule();
-    if (sec?.SpawnAgentSchema) {
-        try {
-            sec.SpawnAgentSchema.parse({
-                type: input.agentType,
-                id: input.agentId,
-            });
-        }
-        catch (zodErr) {
-            if (zodErr.issues) {
-                for (const issue of zodErr.issues) {
-                    if (issue.code === 'invalid_enum_value')
-                        continue;
-                    errors.push(`${issue.path.join('.')}: ${issue.message}`);
-                }
-            }
-        }
-    }
-    return { valid: errors.length === 0, errors };
-}
+export * from '@claude-flow/cli-core/mcp-tools/validate-input';
 //# sourceMappingURL=validate-input.js.map

package/v3/@claude-flow/cli/dist/src/output.d.ts

@@ -1,133 +1,9 @@
 /**
- * V3 CLI Output Formatter
- * Advanced output formatting with tables, progress bars, and colors
+ * V3 CLI Output Formatter — re-export shim (ADR-100, alpha.5).
+ *
+ * Authoritative source: @claude-flow/cli-core/output. Was a byte-identical
+ * 640-line copy. The OutputFormatter class and `output` instance plus all
+ * helper exports flow through unchanged. Edit cli-core for behavior changes.
  */
-import type { TableOptions, ProgressOptions, SpinnerOptions } from './types.js';
-declare const COLORS: {
-    readonly reset: "\u001B[0m";
-    readonly bold: "\u001B[1m";
-    readonly dim: "\u001B[2m";
-    readonly italic: "\u001B[3m";
-    readonly underline: "\u001B[4m";
-    readonly black: "\u001B[30m";
-    readonly red: "\u001B[31m";
-    readonly green: "\u001B[32m";
-    readonly yellow: "\u001B[33m";
-    readonly blue: "\u001B[34m";
-    readonly magenta: "\u001B[35m";
-    readonly cyan: "\u001B[36m";
-    readonly white: "\u001B[37m";
-    readonly gray: "\u001B[90m";
-    readonly brightRed: "\u001B[91m";
-    readonly brightGreen: "\u001B[92m";
-    readonly brightYellow: "\u001B[93m";
-    readonly brightBlue: "\u001B[94m";
-    readonly brightMagenta: "\u001B[95m";
-    readonly brightCyan: "\u001B[96m";
-    readonly brightWhite: "\u001B[97m";
-    readonly bgBlack: "\u001B[40m";
-    readonly bgRed: "\u001B[41m";
-    readonly bgGreen: "\u001B[42m";
-    readonly bgYellow: "\u001B[43m";
-    readonly bgBlue: "\u001B[44m";
-    readonly bgMagenta: "\u001B[45m";
-    readonly bgCyan: "\u001B[46m";
-    readonly bgWhite: "\u001B[47m";
-};
-type ColorName = keyof typeof COLORS;
-export type VerbosityLevel = 'quiet' | 'normal' | 'verbose' | 'debug';
-export declare class OutputFormatter {
-    private colorEnabled;
-    private outputStream;
-    private errorStream;
-    private verbosity;
-    constructor(options?: {
-        color?: boolean;
-        verbosity?: VerbosityLevel;
-    });
-    /**
-     * Set verbosity level
-     * - quiet: Only errors and direct results
-     * - normal: Errors, warnings, info, and results
-     * - verbose: All of normal + debug messages
-     * - debug: All output including trace
-     */
-    setVerbosity(level: VerbosityLevel): void;
-    getVerbosity(): VerbosityLevel;
-    isQuiet(): boolean;
-    isVerbose(): boolean;
-    isDebug(): boolean;
-    private supportsColor;
-    color(text: string, ...colors: ColorName[]): string;
-    bold(text: string): string;
-    dim(text: string): string;
-    success(text: string): string;
-    error(text: string): string;
-    warning(text: string): string;
-    info(text: string): string;
-    highlight(text: string): string;
-    write(text: string): void;
-    writeln(text?: string): void;
-    writeError(text: string): void;
-    writeErrorln(text?: string): void;
-    printSuccess(message: string): void;
-    printError(message: string, details?: string): void;
-    printWarning(message: string): void;
-    printInfo(message: string): void;
-    printDebug(message: string): void;
-    printTrace(message: string): void;
-    table(options: TableOptions): string;
-    printTable(options: TableOptions): void;
-    private calculateColumnWidths;
-    private createBorderLine;
-    private alignText;
-    private truncate;
-    private stripAnsi;
-    createProgress(options: ProgressOptions): Progress;
-    progressBar(current: number, total: number, width?: number): string;
-    createSpinner(options: SpinnerOptions): Spinner;
-    json(data: unknown, pretty?: boolean): string;
-    printJson(data: unknown, pretty?: boolean): void;
-    list(items: string[], bullet?: string): string;
-    printList(items: string[], bullet?: string): void;
-    numberedList(items: string[]): string;
-    printNumberedList(items: string[]): void;
-    box(content: string, title?: string): string;
-    printBox(content: string, title?: string): void;
-    setColorEnabled(enabled: boolean): void;
-    isColorEnabled(): boolean;
-}
-export declare class Progress {
-    private current;
-    private total;
-    private width;
-    private startTime;
-    private formatter;
-    private showPercentage;
-    private showETA;
-    private lastRender;
-    constructor(formatter: OutputFormatter, options: ProgressOptions);
-    update(current: number): void;
-    increment(amount?: number): void;
-    render(): void;
-    finish(): void;
-    private formatTime;
-}
-export declare class Spinner {
-    private formatter;
-    private text;
-    private frames;
-    private interval;
-    private frameIndex;
-    private static readonly SPINNERS;
-    constructor(formatter: OutputFormatter, options: SpinnerOptions);
-    start(): void;
-    stop(message?: string): void;
-    succeed(message?: string): void;
-    fail(message?: string): void;
-    private render;
-    setText(text: string): void;
-}
-export declare const output: OutputFormatter;
-export {};
+export * from '@claude-flow/cli-core/output';
 //# sourceMappingURL=output.d.ts.map

package/v3/@claude-flow/cli/dist/src/output.js

@@ -1,514 +1,9 @@
 /**
- * V3 CLI Output Formatter
- * Advanced output formatting with tables, progress bars, and colors
+ * V3 CLI Output Formatter — re-export shim (ADR-100, alpha.5).
+ *
+ * Authoritative source: @claude-flow/cli-core/output. Was a byte-identical
+ * 640-line copy. The OutputFormatter class and `output` instance plus all
+ * helper exports flow through unchanged. Edit cli-core for behavior changes.
  */
-// ============================================
-// Color Support
-// ============================================
-const COLORS = {
-    // Standard colors
-    reset: '\x1b[0m',
-    bold: '\x1b[1m',
-    dim: '\x1b[2m',
-    italic: '\x1b[3m',
-    underline: '\x1b[4m',
-    // Foreground colors
-    black: '\x1b[30m',
-    red: '\x1b[31m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    blue: '\x1b[34m',
-    magenta: '\x1b[35m',
-    cyan: '\x1b[36m',
-    white: '\x1b[37m',
-    gray: '\x1b[90m',
-    // Bright foreground colors
-    brightRed: '\x1b[91m',
-    brightGreen: '\x1b[92m',
-    brightYellow: '\x1b[93m',
-    brightBlue: '\x1b[94m',
-    brightMagenta: '\x1b[95m',
-    brightCyan: '\x1b[96m',
-    brightWhite: '\x1b[97m',
-    // Background colors
-    bgBlack: '\x1b[40m',
-    bgRed: '\x1b[41m',
-    bgGreen: '\x1b[42m',
-    bgYellow: '\x1b[43m',
-    bgBlue: '\x1b[44m',
-    bgMagenta: '\x1b[45m',
-    bgCyan: '\x1b[46m',
-    bgWhite: '\x1b[47m'
-};
-export class OutputFormatter {
-    colorEnabled;
-    outputStream;
-    errorStream;
-    verbosity;
-    constructor(options = {}) {
-        this.colorEnabled = options.color ?? this.supportsColor();
-        this.outputStream = process.stdout;
-        this.errorStream = process.stderr;
-        this.verbosity = options.verbosity ?? 'normal';
-    }
-    /**
-     * Set verbosity level
-     * - quiet: Only errors and direct results
-     * - normal: Errors, warnings, info, and results
-     * - verbose: All of normal + debug messages
-     * - debug: All output including trace
-     */
-    setVerbosity(level) {
-        this.verbosity = level;
-    }
-    getVerbosity() {
-        return this.verbosity;
-    }
-    isQuiet() {
-        return this.verbosity === 'quiet';
-    }
-    isVerbose() {
-        return this.verbosity === 'verbose' || this.verbosity === 'debug';
-    }
-    isDebug() {
-        return this.verbosity === 'debug';
-    }
-    supportsColor() {
-        // Check for NO_COLOR environment variable
-        if (process.env.NO_COLOR !== undefined)
-            return false;
-        // Check for FORCE_COLOR environment variable
-        if (process.env.FORCE_COLOR !== undefined)
-            return true;
-        // Check if stdout is a TTY
-        return process.stdout.isTTY ?? false;
-    }
-    // ============================================
-    // Color Methods
-    // ============================================
-    color(text, ...colors) {
-        if (!this.colorEnabled)
-            return text;
-        const codes = colors.map(c => COLORS[c]).join('');
-        return `${codes}${text}${COLORS.reset}`;
-    }
-    bold(text) {
-        return this.color(text, 'bold');
-    }
-    dim(text) {
-        return this.color(text, 'dim');
-    }
-    success(text) {
-        return this.color(text, 'green');
-    }
-    error(text) {
-        return this.color(text, 'red');
-    }
-    warning(text) {
-        return this.color(text, 'yellow');
-    }
-    info(text) {
-        return this.color(text, 'blue');
-    }
-    highlight(text) {
-        return this.color(text, 'cyan', 'bold');
-    }
-    // ============================================
-    // Output Methods
-    // ============================================
-    write(text) {
-        this.outputStream.write(text);
-    }
-    writeln(text = '') {
-        this.outputStream.write(text + '\n');
-    }
-    writeError(text) {
-        this.errorStream.write(text);
-    }
-    writeErrorln(text = '') {
-        this.errorStream.write(text + '\n');
-    }
-    // ============================================
-    // Formatted Output Methods
-    // ============================================
-    printSuccess(message) {
-        // Success always shows (result output)
-        const icon = this.color('[OK]', 'green', 'bold');
-        this.writeln(`${icon} ${message}`);
-    }
-    printError(message, details) {
-        // Errors always show
-        const icon = this.color('[ERROR]', 'red', 'bold');
-        this.writeErrorln(`${icon} ${message}`);
-        if (details) {
-            this.writeErrorln(this.dim(`  ${details}`));
-        }
-    }
-    printWarning(message) {
-        // Warnings suppressed in quiet mode
-        if (this.verbosity === 'quiet')
-            return;
-        const icon = this.color('[WARN]', 'yellow', 'bold');
-        this.writeln(`${icon} ${message}`);
-    }
-    printInfo(message) {
-        // Info suppressed in quiet mode
-        if (this.verbosity === 'quiet')
-            return;
-        const icon = this.color('[INFO]', 'blue', 'bold');
-        this.writeln(`${icon} ${message}`);
-    }
-    printDebug(message) {
-        // Debug only shows in verbose/debug mode
-        if (this.verbosity !== 'verbose' && this.verbosity !== 'debug')
-            return;
-        const icon = this.color('[DEBUG]', 'gray');
-        this.writeln(`${icon} ${this.dim(message)}`);
-    }
-    printTrace(message) {
-        // Trace only shows in debug mode
-        if (this.verbosity !== 'debug')
-            return;
-        const icon = this.color('[TRACE]', 'gray', 'dim');
-        this.writeln(`${icon} ${this.dim(message)}`);
-    }
-    // ============================================
-    // Table Formatting
-    // ============================================
-    table(options) {
-        const { columns, data, border = true, header = true, padding = 1, maxWidth } = options;
-        // Calculate column widths
-        const widths = this.calculateColumnWidths(columns, data, maxWidth);
-        const lines = [];
-        const pad = ' '.repeat(padding);
-        // Border characters
-        const borderChars = border ? {
-            topLeft: '+', topRight: '+', bottomLeft: '+', bottomRight: '+',
-            horizontal: '-', vertical: '|',
-            leftT: '+', rightT: '+', topT: '+', bottomT: '+', cross: '+'
-        } : {
-            topLeft: '', topRight: '', bottomLeft: '', bottomRight: '',
-            horizontal: '', vertical: ' ',
-            leftT: '', rightT: '', topT: '', bottomT: '', cross: ''
-        };
-        // Top border
-        if (border) {
-            lines.push(this.createBorderLine(widths, borderChars, 'top', padding));
-        }
-        // Header row
-        if (header) {
-            const headerRow = columns.map((col, i) => {
-                const text = this.truncate(col.header, widths[i]);
-                return pad + this.alignText(this.bold(text), widths[i], col.align) + pad;
-            }).join(borderChars.vertical);
-            lines.push(`${borderChars.vertical}${headerRow}${borderChars.vertical}`);
-            // Header separator
-            if (border) {
-                lines.push(this.createBorderLine(widths, borderChars, 'middle', padding));
-            }
-        }
-        // Data rows
-        for (const row of data) {
-            const rowCells = columns.map((col, i) => {
-                let value = row[col.key];
-                // Apply formatter if provided
-                if (col.format) {
-                    value = col.format(value);
-                }
-                else {
-                    value = String(value ?? '');
-                }
-                const text = this.truncate(String(value), widths[i]);
-                return pad + this.alignText(text, widths[i], col.align) + pad;
-            }).join(borderChars.vertical);
-            lines.push(`${borderChars.vertical}${rowCells}${borderChars.vertical}`);
-        }
-        // Bottom border
-        if (border) {
-            lines.push(this.createBorderLine(widths, borderChars, 'bottom', padding));
-        }
-        return lines.join('\n');
-    }
-    printTable(options) {
-        this.writeln(this.table(options));
-    }
-    calculateColumnWidths(columns, data, maxWidth) {
-        const widths = columns.map((col, i) => {
-            // Start with header width
-            let width = col.header.length;
-            // Check all data values
-            for (const row of data) {
-                let value = row[col.key];
-                if (col.format) {
-                    value = col.format(value);
-                }
-                const len = this.stripAnsi(String(value ?? '')).length;
-                width = Math.max(width, len);
-            }
-            // Apply column-specific width limit
-            if (col.width) {
-                width = Math.min(width, col.width);
-            }
-            return width;
-        });
-        // Apply max width constraint
-        if (maxWidth) {
-            const totalWidth = widths.reduce((a, b) => a + b, 0) + (columns.length * 3) + 1;
-            if (totalWidth > maxWidth) {
-                const reduction = (totalWidth - maxWidth) / columns.length;
-                return widths.map(w => Math.max(3, Math.floor(w - reduction)));
-            }
-        }
-        return widths;
-    }
-    createBorderLine(widths, chars, position, padding) {
-        const cellWidth = (w) => chars.horizontal.repeat(w + (padding * 2));
-        const cells = widths.map(cellWidth).join(position === 'top' ? chars.topT :
-            position === 'bottom' ? chars.bottomT :
-                chars.cross);
-        const left = position === 'top' ? chars.topLeft : position === 'bottom' ? chars.bottomLeft : chars.leftT;
-        const right = position === 'top' ? chars.topRight : position === 'bottom' ? chars.bottomRight : chars.rightT;
-        return `${left}${cells}${right}`;
-    }
-    alignText(text, width, align = 'left') {
-        const len = this.stripAnsi(text).length;
-        const padding = width - len;
-        if (padding <= 0)
-            return text;
-        switch (align) {
-            case 'right':
-                return ' '.repeat(padding) + text;
-            case 'center':
-                const left = Math.floor(padding / 2);
-                const right = padding - left;
-                return ' '.repeat(left) + text + ' '.repeat(right);
-            default:
-                return text + ' '.repeat(padding);
-        }
-    }
-    truncate(text, maxLength) {
-        const stripped = this.stripAnsi(text);
-        if (stripped.length <= maxLength)
-            return text;
-        return stripped.slice(0, maxLength - 3) + '...';
-    }
-    stripAnsi(text) {
-        return text.replace(/\x1b\[[0-9;]*m/g, '');
-    }
-    // ============================================
-    // Progress Bar
-    // ============================================
-    createProgress(options) {
-        return new Progress(this, options);
-    }
-    progressBar(current, total, width = 40) {
-        const percent = Math.min(100, Math.max(0, (current / total) * 100));
-        const filled = Math.round((width * percent) / 100);
-        const empty = width - filled;
-        const bar = this.color('#'.repeat(filled), 'green') +
-            this.dim('-'.repeat(empty));
-        return `[${bar}] ${percent.toFixed(1)}%`;
-    }
-    // ============================================
-    // Spinner
-    // ============================================
-    createSpinner(options) {
-        return new Spinner(this, options);
-    }
-    // ============================================
-    // JSON Output
-    // ============================================
-    json(data, pretty = true) {
-        return pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
-    }
-    printJson(data, pretty = true) {
-        this.writeln(this.json(data, pretty));
-    }
-    // ============================================
-    // List Output
-    // ============================================
-    list(items, bullet = '-') {
-        return items.map(item => `  ${bullet} ${item}`).join('\n');
-    }
-    printList(items, bullet = '-') {
-        this.writeln(this.list(items, bullet));
-    }
-    numberedList(items) {
-        return items.map((item, i) => `  ${i + 1}. ${item}`).join('\n');
-    }
-    printNumberedList(items) {
-        this.writeln(this.numberedList(items));
-    }
-    // ============================================
-    // Box Output
-    // ============================================
-    box(content, title) {
-        const lines = content.split('\n');
-        const maxLen = Math.max(...lines.map(l => this.stripAnsi(l).length), title?.length ?? 0);
-        const width = maxLen + 4;
-        const border = {
-            topLeft: '+', topRight: '+',
-            bottomLeft: '+', bottomRight: '+',
-            horizontal: '-', vertical: '|'
-        };
-        const result = [];
-        // Top border with optional title
-        if (title) {
-            const titleText = ` ${title} `;
-            const leftPad = Math.floor((width - titleText.length - 2) / 2);
-            const rightPad = width - titleText.length - leftPad - 2;
-            result.push(border.topLeft +
-                border.horizontal.repeat(leftPad) +
-                this.bold(titleText) +
-                border.horizontal.repeat(rightPad) +
-                border.topRight);
-        }
-        else {
-            result.push(border.topLeft + border.horizontal.repeat(width - 2) + border.topRight);
-        }
-        // Content lines
-        for (const line of lines) {
-            const stripped = this.stripAnsi(line);
-            const padding = maxLen - stripped.length;
-            result.push(`${border.vertical} ${line}${' '.repeat(padding)} ${border.vertical}`);
-        }
-        // Bottom border
-        result.push(border.bottomLeft + border.horizontal.repeat(width - 2) + border.bottomRight);
-        return result.join('\n');
-    }
-    printBox(content, title) {
-        this.writeln(this.box(content, title));
-    }
-    setColorEnabled(enabled) {
-        this.colorEnabled = enabled;
-    }
-    isColorEnabled() {
-        return this.colorEnabled;
-    }
-}
-// ============================================
-// Progress Class
-// ============================================
-export class Progress {
-    current;
-    total;
-    width;
-    startTime;
-    formatter;
-    showPercentage;
-    showETA;
-    lastRender = '';
-    constructor(formatter, options) {
-        this.formatter = formatter;
-        this.current = options.current ?? 0;
-        this.total = options.total;
-        this.width = options.width ?? 40;
-        this.showPercentage = options.showPercentage ?? true;
-        this.showETA = options.showETA ?? true;
-        this.startTime = Date.now();
-    }
-    update(current) {
-        this.current = current;
-        this.render();
-    }
-    increment(amount = 1) {
-        this.update(this.current + amount);
-    }
-    render() {
-        const bar = this.formatter.progressBar(this.current, this.total, this.width);
-        let output = bar;
-        if (this.showETA && this.current > 0) {
-            const elapsed = Date.now() - this.startTime;
-            const rate = this.current / elapsed;
-            const remaining = this.total - this.current;
-            const eta = remaining / rate;
-            if (isFinite(eta)) {
-                output += ` ETA: ${this.formatTime(eta)}`;
-            }
-        }
-        // Clear previous line and write new
-        if (this.lastRender) {
-            process.stdout.write('\r' + ' '.repeat(this.lastRender.length) + '\r');
-        }
-        process.stdout.write(output);
-        this.lastRender = output;
-    }
-    finish() {
-        this.current = this.total;
-        this.render();
-        process.stdout.write('\n');
-    }
-    formatTime(ms) {
-        const seconds = Math.floor(ms / 1000);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        if (hours > 0) {
-            return `${hours}h ${minutes % 60}m`;
-        }
-        else if (minutes > 0) {
-            return `${minutes}m ${seconds % 60}s`;
-        }
-        else {
-            return `${seconds}s`;
-        }
-    }
-}
-// ============================================
-// Spinner Class
-// ============================================
-export class Spinner {
-    formatter;
-    text;
-    frames;
-    interval = null;
-    frameIndex = 0;
-    static SPINNERS = {
-        dots: ['...', '..:', '.::', ':::', '::.', ':..',],
-        line: ['-', '\\', '|', '/'],
-        arc: ['◜', '◠', '◝', '◞', '◡', '◟'],
-        circle: ['◐', '◓', '◑', '◒'],
-        arrows: ['←', '↖', '↑', '↗', '→', '↘', '↓', '↙']
-    };
-    constructor(formatter, options) {
-        this.formatter = formatter;
-        this.text = options.text;
-        this.frames = Spinner.SPINNERS[options.spinner ?? 'dots'];
-    }
-    start() {
-        if (this.interval)
-            return;
-        this.interval = setInterval(() => {
-            this.render();
-            this.frameIndex = (this.frameIndex + 1) % this.frames.length;
-        }, 100);
-        this.interval.unref();
-        this.render();
-    }
-    stop(message) {
-        if (this.interval) {
-            clearInterval(this.interval);
-            this.interval = null;
-        }
-        // Clear the line
-        process.stdout.write('\r' + ' '.repeat(this.text.length + 10) + '\r');
-        if (message) {
-            this.formatter.writeln(message);
-        }
-    }
-    succeed(message) {
-        this.stop(this.formatter.success(message ?? this.text));
-    }
-    fail(message) {
-        this.stop(this.formatter.error(message ?? this.text));
-    }
-    render() {
-        const frame = this.formatter.info(this.frames[this.frameIndex]);
-        process.stdout.write(`\r${frame} ${this.text}`);
-    }
-    setText(text) {
-        this.text = text;
-    }
-}
-// Export singleton instance
-export const output = new OutputFormatter();
+export * from '@claude-flow/cli-core/output';
 //# sourceMappingURL=output.js.map

package/v3/@claude-flow/cli/dist/src/types.d.ts

@@ -1,198 +1,13 @@
 /**
- * V3 CLI Type Definitions
- * Modernized type system for the RuFlo V3 CLI
+ * V3 CLI Type Definitions — re-export shim (ADR-100, alpha.5).
+ *
+ * Authoritative source: @claude-flow/cli-core/types. Was a byte-identical
+ * 287-line copy until alpha.5 published the cli-core subpath. The 60+
+ * `import './types.js'` call sites inside cli keep working unchanged
+ * because the file path is preserved.
+ *
+ * To extend the type system, edit v3/@claude-flow/cli-core/src/types.ts
+ * — changes flow through here automatically.
  */
-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;
-}
-export interface V3Config {
-    version: string;
-    projectRoot: string;
-    agents: AgentConfig;
-    swarm: SwarmConfig;
-    memory: MemoryConfig;
-    mcp: MCPConfig;
-    cli: CLIPreferences;
-    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' | 'hierarchical-mesh';
-    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;
-}
-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;
-}
-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;
-}
-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;
-}
-export declare class CLIError extends Error {
-    code: string;
-    exitCode: number;
-    details?: unknown | undefined;
-    constructor(message: string, code: string, exitCode?: number, details?: unknown | undefined);
-}
-export declare class ValidationError extends CLIError {
-    constructor(message: string, details?: unknown);
-}
-export declare class ConfigError extends CLIError {
-    constructor(message: string, details?: unknown);
-}
-export declare class CommandNotFoundError extends CLIError {
-    constructor(commandName: string);
-}
+export * from '@claude-flow/cli-core/types';
 //# sourceMappingURL=types.d.ts.map

package/v3/@claude-flow/cli/dist/src/types.js

@@ -1,38 +1,13 @@
 /**
- * V3 CLI Type Definitions
- * Modernized type system for the RuFlo V3 CLI
+ * V3 CLI Type Definitions — re-export shim (ADR-100, alpha.5).
+ *
+ * Authoritative source: @claude-flow/cli-core/types. Was a byte-identical
+ * 287-line copy until alpha.5 published the cli-core subpath. The 60+
+ * `import './types.js'` call sites inside cli keep working unchanged
+ * because the file path is preserved.
+ *
+ * To extend the type system, edit v3/@claude-flow/cli-core/src/types.ts
+ * — changes flow through here automatically.
  */
-// ============================================
-// Error Types
-// ============================================
-export class CLIError extends Error {
-    code;
-    exitCode;
-    details;
-    constructor(message, code, exitCode = 1, details) {
-        super(message);
-        this.code = code;
-        this.exitCode = exitCode;
-        this.details = details;
-        this.name = 'CLIError';
-    }
-}
-export class ValidationError extends CLIError {
-    constructor(message, details) {
-        super(message, 'VALIDATION_ERROR', 1, details);
-        this.name = 'ValidationError';
-    }
-}
-export class ConfigError extends CLIError {
-    constructor(message, details) {
-        super(message, 'CONFIG_ERROR', 1, details);
-        this.name = 'ConfigError';
-    }
-}
-export class CommandNotFoundError extends CLIError {
-    constructor(commandName) {
-        super(`Unknown command: ${commandName}`, 'COMMAND_NOT_FOUND', 127);
-        this.name = 'CommandNotFoundError';
-    }
-}
+export * from '@claude-flow/cli-core/types';
 //# sourceMappingURL=types.js.map

package/v3/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.6.30",
+  "version": "3.7.0-alpha.1",
   "type": "module",
   "description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",
@@ -95,6 +95,7 @@
     "vitest": "^4.0.16"
   },
   "dependencies": {
+    "@claude-flow/cli-core": "^3.7.0-alpha.5",
     "@claude-flow/mcp": "^3.0.0-alpha.8",
     "@claude-flow/shared": "^3.0.0-alpha.7",
     "@noble/ed25519": "^2.1.0",

package/.claude/scheduled_tasks.lock

@@ -1 +0,0 @@
-{"sessionId":"1dba3b8c-1f1f-4718-bab4-9ffba5f49578","pid":20633,"procStart":"Mon May  4 17:00:40 2026","acquiredAt":1777938041240}