@dcyfr/ai 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.0.3
+
+### Patch Changes
+
+- [`1d6f12e`](https://github.com/dcyfr/dcyfr-ai/commit/1d6f12ed981054fcb0b26beac4be452926ba793f) Thanks [@dcyfr](https://github.com/dcyfr)! - Automated release management and CI improvements
+
+  - Added automated release workflows with changesets
+  - Fixed glob TypeScript compatibility issues
+  - Improved integration test handling for CI environments
+  - Added canary release workflow for pre-release testing
+  - Comprehensive CI pipeline with type checking, linting, and tests
+
 All notable changes to @dcyfr/ai will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
@@ -10,6 +22,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 #### Core Framework
+
 - Configuration system with three-layer merge (defaults → project → env)
 - Support for YAML, JSON, and package.json configuration formats
 - Environment variable overrides for all configuration options
@@ -20,6 +33,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Validation framework with parallel/serial execution modes
 
 #### Plugin System
+
 - Plugin manifest validation
 - Lifecycle hooks (onLoad, onValidate, onComplete, onUnload)
 - Error isolation and recovery
@@ -27,6 +41,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Plugin timeout support
 
 #### Telemetry
+
 - Session management with context tracking
 - Metric recording (compliance, test pass rate, costs)
 - Agent statistics aggregation
@@ -35,6 +50,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Memory storage adapter for testing
 
 #### Provider Support
+
 - Claude (Anthropic)
 - Groq
 - Ollama
@@ -43,6 +59,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Generic provider interface
 
 #### CLI Tools
+
 - `init` - Initialize new project
 - `config:init` - Create configuration file
 - `config:validate` - Validate configuration
@@ -50,6 +67,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `plugin:create` - Generate plugin template
 
 #### Documentation
+
 - Comprehensive getting started guide
 - Complete API reference
 - Plugin development guide
@@ -57,6 +75,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Migration documentation
 
 #### Configuration Templates
+
 - Default YAML configuration
 - Default JSON configuration
 - Minimal configuration templates
@@ -70,6 +89,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Zero breaking changes in API surface
 
 ### Developer Experience
+
 - Type-safe configuration with Zod
 - ESM modules with .d.ts declarations
 - Comprehensive error messages
@@ -79,6 +99,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Planned
+
 - Redis storage adapter for telemetry
 - Database storage adapter
 - Additional validation gates

package/README.md

@@ -187,31 +187,28 @@ See [examples/](./examples/) directory:
 - [Configuration Guide](./docs/configuration.md)
 - [Plugin Development](./docs/plugins.md)
 - [API Reference](./docs/api.md)
+- [Release Management](./docs/RELEASE_MANAGEMENT.md) - Publishing and versioning
+- [Quick Release Guide](./docs/RELEASE_QUICK_START.md) - TL;DR for releases
 
-## Architecture
+## Contributing
 
-```
-@dcyfr/ai (Public Framework)
-├── Core
-│   ├── TelemetryEngine - Usage tracking
-│   └── ProviderRegistry - Multi-provider AI
-├── Plugins
-│   ├── PluginLoader - Dynamic loading
-│   └── ValidationFramework - Quality gates
-├── Config
-│   ├── Schema (Zod) - Validation
-│   └── Loader - Three-layer merge
-└── CLI
-    └── Config tools
-
-@dcyfr/agents (Private Agents)
-└── Specialized validators for DCYFR projects
-```
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.
 
-## License
+### Release Process
 
-MIT © DCYFR Labs
+We use [Changesets](https://github.com/changesets/changesets) for automated versioning and publishing.
 
-## Contributing
+**For contributors:**
+```bash
+# Add a changeset describing your changes
+npm run changeset
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.
+# Commit the changeset with your PR
+git add .changeset/*.md
+git commit -m "feat: your feature"
+```
+
+**For maintainers:**
+- Changesets automatically creates Release PRs
+- Merging a Release PR publishes to npm
+- See [Release Management](./docs/RELEASE_MANAGEMENT.md) for full details

package/bin/cli.js

@@ -176,6 +176,8 @@ Commands:
   config:validate         Validate configuration file
   config:init             Initialize new configuration file
   config:schema           Show configuration schema
+  tui:dashboard           Interactive validation dashboard (OpenTUI)
+  tui:wizard              Interactive configuration wizard (OpenTUI)
   help                    Show this help message
 
 Options:
@@ -230,6 +232,16 @@ async function main() {
       await showSchema();
       break;
 
+    case 'tui:dashboard':
+    case 'tui:wizard':
+    case 'tui':
+      // Delegate to TUI CLI
+      console.log('🎨 Launching interactive TUI...\n');
+      console.log('Use: npx @dcyfr/ai-tui ' + options.command.replace('tui:', ''));
+      console.log('Or run: node bin/tui.js ' + options.command.replace('tui:', ''));
+      process.exit(0);
+      break;
+
     case 'help':
     case '--help':
     case '-h':

package/bin/tui/config-wizard.js

@@ -0,0 +1,107 @@
+/**
+ * Interactive Configuration Wizard
+ * Uses inquirer for interactive prompts
+ */
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+
+/**
+ * Run configuration wizard
+ */
+export async function runConfigWizard() {
+  console.log(chalk.cyan.bold('\n⚙️  DCYFR Configuration Wizard\n'));
+  console.log(chalk.gray('Configure your AI agent framework\n'));
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'projectName',
+      message: 'Project name:',
+      default: 'my-project',
+    },
+    {
+      type: 'list',
+      name: 'format',
+      message: 'Config format:',
+      choices: [
+        { name: 'YAML (Recommended)', value: 'yaml' },
+        { name: 'JSON', value: 'json' },
+      ],
+      default: 'yaml',
+    },
+    {
+      type: 'confirm',
+      name: 'telemetryEnabled',
+      message: 'Enable telemetry?',
+      default: true,
+    },
+    {
+      type: 'confirm',
+      name: 'validationEnabled',
+      message: 'Enable validation?',
+      default: true,
+    },
+    {
+      type: 'confirm',
+      name: 'parallelExecution',
+      message: 'Enable parallel execution?',
+      default: true,
+    },
+    {
+      type: 'number',
+      name: 'designTokenCompliance',
+      message: 'Design token compliance threshold (%):',
+      default: 90,
+      when: (answers) => answers.validationEnabled,
+    },
+    {
+      type: 'number',
+      name: 'pageLayoutUsage',
+      message: 'PageLayout usage threshold (%):',
+      default: 90,
+      when: (answers) => answers.validationEnabled,
+    },
+    {
+      type: 'checkbox',
+      name: 'agents',
+      message: 'Select agents to enable:',
+      choices: [
+        { name: 'Design Tokens', value: 'designTokens', checked: true },
+        { name: 'Barrel Exports', value: 'barrelExports', checked: true },
+        { name: 'Page Layout', value: 'pageLayout', checked: true },
+        { name: 'Test Data', value: 'testData', checked: true },
+        { name: 'API Pattern', value: 'apiPattern', checked: false },
+      ],
+    },
+  ]);
+
+  return {
+    projectName: answers.projectName,
+    format: answers.format,
+    telemetryEnabled: answers.telemetryEnabled,
+    validationEnabled: answers.validationEnabled,
+    parallelExecution: answers.parallelExecution,
+    designTokenCompliance: answers.designTokenCompliance || 90,
+    pageLayoutUsage: answers.pageLayoutUsage || 90,
+    agents: {
+      designTokens: {
+        enabled: answers.agents.includes('designTokens'),
+        compliance: (answers.designTokenCompliance || 90) / 100,
+      },
+      barrelExports: {
+        enabled: answers.agents.includes('barrelExports'),
+      },
+      pageLayout: {
+        enabled: answers.agents.includes('pageLayout'),
+        targetUsage: (answers.pageLayoutUsage || 90) / 100,
+      },
+      testData: {
+        enabled: answers.agents.includes('testData'),
+      },
+      apiPattern: {
+        enabled: answers.agents.includes('apiPattern'),
+      },
+    },
+  };
+}

package/bin/tui/validation-dashboard.js

@@ -0,0 +1,123 @@
+/**
+ * Terminal Validation Dashboard
+ * Interactive terminal UI for displaying validation results using chalk and cli-table3
+ */
+
+import chalk from 'chalk';
+import Table from 'cli-table3';
+
+/**
+ * Status icon helper
+ */
+export function getStatusIcon(status) {
+  const icons = {
+    pass: chalk.green.bold('✓'),
+    fail: chalk.red.bold('✗'),
+    warn: chalk.yellow.bold('⚠'),
+    pending: chalk.gray.bold('○'),
+  };
+
+  return icons[status] || icons.pending;
+}
+
+/**
+ * Progress bar helper
+ */
+export function renderProgressBar(value, max = 100, width = 30) {
+  const percentage = Math.min(100, (value / max) * 100);
+  const filledWidth = Math.floor((percentage / 100) * width);
+  const emptyWidth = width - filledWidth;
+
+  const filled = '█'.repeat(filledWidth);
+  const empty = '░'.repeat(emptyWidth);
+
+  let colorFn = chalk.green;
+  if (percentage < 50) colorFn = chalk.red;
+  else if (percentage < 90) colorFn = chalk.yellow;
+
+  return `${colorFn(filled)}${chalk.gray(empty)} ${chalk.cyan(percentage.toFixed(1) + '%')}`;
+}
+
+/**
+ * Render gate status row
+ */
+export function renderGateRow(gate) {
+  const status = gate.passed ? 'pass' : 'fail';
+  const compliance = gate.compliance || 0;
+  const icon = getStatusIcon(status);
+  const progressBar = renderProgressBar(compliance, 100, 20);
+  const issues = gate.violations > 0 ? chalk.red(`${gate.violations} issues`) : chalk.gray('0 issues');
+  
+  const name = gate.name.padEnd(20);
+  
+  return `${icon} ${name} ${progressBar} ${issues}`;
+}
+
+/**
+ * Render agent summary
+ */
+export function renderAgentSummary(agents) {
+  const lines = [chalk.cyan.bold('🤖 Agents'), ''];
+  
+  Object.entries(agents).forEach(([name, config]) => {
+    const enabled = 'enabled' in config ? config.enabled : true;
+    const icon = enabled ? chalk.green('✓') : chalk.gray('✗');
+    const agentName = enabled ? chalk.white(name) : chalk.gray(name);
+    lines.push(`  ${icon} ${agentName}`);
+  });
+  
+  return lines.join('\n');
+}
+
+/**
+ * Main validation dashboard
+ */
+export function renderValidationDashboard(config, report) {
+  const hasReport = report && report.gates;
+  const passed = report?.valid || false;
+  
+  const lines = [];
+  
+  // Header
+  const status = passed ? chalk.green.bold('PASS') : chalk.red.bold('FAIL');
+  lines.push('');
+  lines.push(chalk.cyan.bold('🔍 DCYFR Validation Dashboard') + '                    ' + status);
+  lines.push('─'.repeat(80));
+  lines.push('');
+  
+  // Project info
+  lines.push(`${chalk.gray('📂 Project:')} ${chalk.white(config.projectName || '(unnamed)')}`);
+  lines.push(`${chalk.gray('📊 Version:')} ${chalk.white(config.version)}`);
+  lines.push('');
+  
+  // Validation gates
+  if (hasReport) {
+    lines.push(chalk.cyan.bold('🎯 Validation Gates'));
+    lines.push('');
+    report.gates.forEach((gate) => {
+      lines.push(renderGateRow(gate));
+    });
+    lines.push('');
+    
+    // Overall metrics
+    lines.push('─'.repeat(80));
+    const gatesPassed = report.gates.filter((g) => g.passed).length;
+    const totalViolations = report.gates.reduce((sum, g) => sum + (g.violations || 0), 0);
+    const avgCompliance = (report.gates.reduce((sum, g) => sum + (g.compliance || 0), 0) / report.gates.length).toFixed(1);
+    
+    lines.push('');
+    lines.push(`${chalk.gray('Gates Passed:')} ${chalk.green.bold(gatesPassed)}/${report.gates.length}    ${chalk.gray('Total Violations:')} ${chalk.red.bold(totalViolations)}    ${chalk.gray('Avg Compliance:')} ${chalk.cyan.bold(avgCompliance + '%')}`);
+    lines.push('');
+  }
+  
+  // Agent summary
+  lines.push(renderAgentSummary(config.agents));
+  lines.push('');
+  
+  // Footer
+  lines.push('─'.repeat(80));
+  lines.push(chalk.gray.italic('Press Q to quit, R to refresh, V for verbose mode'));
+  lines.push('');
+  
+  return lines.join('\n');
+}

package/bin/tui.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+
+/**
+ * DCYFR AI Framework TUI (Terminal UI)
+ * Interactive dashboard using chalk and inquirer
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import readline from 'readline';
+import { ConfigLoader } from '../dist/ai/config/loader.js';
+import { ValidationFramework } from '../dist/ai/validation/framework.js';
+import { renderValidationDashboard } from './tui/validation-dashboard.js';
+import { runConfigWizard } from './tui/config-wizard.js';
+import { existsSync } from 'fs';
+import { writeFile } from 'fs/promises';
+import { join } from 'path';
+
+/**
+ * Run interactive validation dashboard
+ */
+async function runDashboard(options) {
+  const projectRoot = options.root || process.cwd();
+  const configFile = options.config;
+
+  try {
+    // Load configuration
+    const spinner = ora('Loading configuration...').start();
+    
+    const loader = new ConfigLoader({
+      projectRoot,
+      configFile,
+      validate: true,
+    });
+
+    const config = await loader.load();
+    spinner.succeed('Configuration loaded');
+
+    // Run validation
+    spinner.start('Running validation...');
+    
+    const framework = new ValidationFramework({
+      gates: config.validation.gates,
+      parallel: config.validation.parallel,
+    });
+
+    const report = await framework.validate({
+      projectRoot: config.project.root,
+      files: config.project.include,
+      config: config.agents,
+    });
+    
+    spinner.succeed('Validation complete');
+
+    // Display dashboard
+    console.clear();
+    console.log(renderValidationDashboard(config, report));
+
+    // Setup keyboard input for interactive mode
+    readline.emitKeypressEvents(process.stdin);
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+
+    console.log(chalk.gray('\nPress Q to quit, R to refresh...\n'));
+
+    process.stdin.on('keypress', async (str, key) => {
+      if (key.name === 'q' || (key.ctrl && key.name === 'c')) {
+        console.log(chalk.yellow('\n👋 Exiting dashboard...\n'));
+        process.exit(0);
+      } else if (key.name === 'r') {
+        // Refresh
+        console.clear();
+        const spinner = ora('Refreshing validation...').start();
+        const newReport = await framework.validate({
+          projectRoot: config.project.root,
+          files: config.project.include,
+          config: config.agents,
+        });
+        spinner.succeed('Validation refreshed');
+        console.log(renderValidationDashboard(config, newReport));
+        console.log(chalk.gray('\nPress Q to quit, R to refresh...\n'));
+      }
+    });
+  } catch (error) {
+    console.error(chalk.red('❌ Failed to run dashboard:'), error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Run interactive configuration wizard
+ */
+async function runWizard(options) {
+  const projectRoot = options.root || process.cwd();
+
+  try {
+    const config = await runConfigWizard();
+    
+    // Create config file
+    await createConfigFile(config, projectRoot);
+  } catch (error) {
+    if (error.isTTYError) {
+      console.error(chalk.red('❌ Prompt couldn\'t be rendered in the current environment'));
+    } else {
+      console.error(chalk.red('❌ Failed to run wizard:'), error.message);
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Create configuration file from wizard state
+ */
+async function createConfigFile(state, projectRoot) {
+  const configFile = state.format === 'json' ? '.dcyfr.json' : '.dcyfr.yaml';
+  const configPath = join(projectRoot, configFile);
+
+  if (existsSync(configPath)) {
+    console.error(chalk.red(`\n❌ Config file already exists: ${configPath}`));
+    console.error(chalk.yellow('Delete it first or use --force flag'));
+    process.exit(1);
+  }
+
+  // Build config object
+  const config = {
+    version: '1.0.0',
+    projectName: state.projectName || 'my-project',
+    telemetry: {
+      enabled: state.telemetryEnabled,
+    },
+    validation: {
+      enabled: state.validationEnabled,
+      parallel: state.parallelExecution,
+      gates: Object.entries(state.agents)
+        .filter(([_, cfg]) => cfg.enabled)
+        .map(([name]) => name),
+    },
+    agents: state.agents,
+  };
+
+  // Write file
+  const content =
+    state.format === 'json'
+      ? JSON.stringify(config, null, 2)
+      : Object.entries(config)
+          .map(([key, val]) => `${key}: ${JSON.stringify(val)}`)
+          .join('\n');
+
+  await writeFile(configPath, content, 'utf-8');
+
+  console.log(chalk.green(`\n✅ Created ${configPath}`));
+  console.log(chalk.cyan('\nNext steps:'));
+  console.log('  1. Review and customize the configuration');
+  console.log('  2. Run ' + chalk.bold('npx @dcyfr/ai tui:dashboard') + ' to test');
+  console.log('  3. Integrate into your CI/CD pipeline\n');
+}
+
+/**
+ * Show TUI help
+ */
+function showHelp() {
+  console.log(`
+DCYFR AI Framework - Interactive TUI
+
+Usage:
+  npx @dcyfr/ai tui:<command> [options]
+
+Commands:
+  tui:dashboard           Interactive validation dashboard
+  tui:wizard              Interactive configuration wizard
+  tui:help                Show this help message
+
+Options:
+  --root <path>           Project root directory (default: current directory)
+  --config <file>         Custom config file path (dashboard only)
+  --format <json|yaml>    Config format for wizard (default: yaml)
+
+Examples:
+  # Run interactive validation dashboard
+  npx @dcyfr/ai tui:dashboard
+
+  # Run configuration wizard
+  npx @dcyfr/ai tui:wizard
+
+  # Dashboard with custom config
+  npx @dcyfr/ai tui:dashboard --config custom.yaml
+
+Keyboard Shortcuts:
+  Q           Quit
+  R           Refresh (dashboard)
+  V           Verbose mode
+  Ctrl+C      Exit
+
+Documentation:
+  https://github.com/dcyfr/dcyfr-ai/blob/main/docs/TUI.md
+`);
+  process.exit(0);
+}
+
+/**
+ * Parse command line arguments
+ */
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const command = args[0] || 'help';
+  const flags = {};
+
+  for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg.startsWith('--')) {
+      const [key, value] = arg.substring(2).split('=');
+      if (value !== undefined) {
+        flags[key] = value;
+      } else {
+        flags[key] = args[i + 1]?.startsWith('--') ? true : args[++i] || true;
+      }
+    }
+  }
+
+  return { command, flags };
+}
+
+/**
+ * Main CLI entry point
+ */
+async function main() {
+  const { command, flags } = parseArgs();
+
+  switch (command) {
+    case 'tui:dashboard':
+    case 'dashboard':
+      await runDashboard(flags);
+      break;
+
+    case 'tui:wizard':
+    case 'wizard':
+      await runWizard(flags);
+      break;
+
+    case 'tui:help':
+    case 'help':
+    case '--help':
+    case '-h':
+      showHelp();
+      break;
+
+    default:
+      console.error(`❌ Unknown command: ${command}\n`);
+      showHelp();
+  }
+}
+
+// Run CLI
+main().catch((error) => {
+  console.error('❌ Unexpected error:', error);
+  process.exit(1);
+});