@dcyfr/ai 1.0.2 → 1.0.4

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/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Drew
+Copyright (c) 2025-2026 DCYFR Labs (https://www.dcyfr.ai)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -19,3 +19,29 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+---
+
+## Commercial Use
+
+This software is dual-licensed:
+
+- **MIT License** applies to personal, educational, and non-commercial use
+- **Commercial License** required for business and revenue-generating use
+
+### Commercial use includes:
+- Using @dcyfr/ai in a product or service that generates revenue
+- Deploying in a business environment (>5 employees)
+- Providing consulting/services using @dcyfr/ai for profit
+- Distributing as part of a commercial offering
+
+### To obtain a commercial license:
+- View tiers: https://github.com/dcyfr/workspace/blob/main/SPONSORSHIP.md
+- Contact: licensing@dcyfr.ai
+- GitHub Sponsors: https://github.com/sponsors/dcyfr
+
+For questions about whether your use requires a commercial license, contact licensing@dcyfr.ai.
+
+## Trademark
+
+"DCYFR" is a trademark of DCYFR Labs. See TRADEMARK.md for usage guidelines.

package/README.md

@@ -2,13 +2,47 @@
 
 > Portable AI agent framework with plugin architecture for multi-provider integration, telemetry tracking, and quality validation.
 
-[![npm version](https://badge.fury.io/js/%40dcyfr%2Fai.svg)](https://www.npmjs.com/package/@dcyfr/ai)
-[![npm downloads](https://img.shields.io/npm/dm/@dcyfr/ai.svg)](https://www.npmjs.com/package/@dcyfr/ai)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
+[![npm](https://img.shields.io/npm/v/@dcyfr/ai?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@dcyfr/ai)
+[![Downloads](https://img.shields.io/npm/dm/@dcyfr/ai?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@dcyfr/ai)
+[![License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Strict-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Bundle Size](https://img.shields.io/badge/Bundle%20Size-~200KB%20gzipped-28a745?style=flat-square&logo=webpack)](https://bundlephobia.com/package/@dcyfr/ai)
 
 Portable AI agent framework with plugin architecture for managing multiple AI providers, tracking telemetry, and ensuring quality compliance.
 
+## Table of Contents
+
+<details>
+<summary>📑 Table of Contents</summary>
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Configuration](#configuration)
+  - [File Formats](#file-formats)
+  - [Three-Layer Merge](#three-layer-merge)
+  - [Environment Overrides](#environment-overrides)
+- [Architecture](#architecture)
+- [Plugin System](#plugin-system)
+  - [Built-in Agents](#built-in-agents)
+  - [Custom Plugins](#custom-plugins)
+- [CLI Commands](#cli-commands)
+- [Examples](#examples)
+- [Documentation](#documentation)
+- [Contributing](#contributing)
+- [Troubleshooting](#-troubleshooting)
+  - [Installation Issues](#installation-issues)
+  - [Configuration Issues](#configuration-issues)
+  - [Plugin Issues](#plugin-issues)
+  - [CLI Issues](#cli-issues)
+- [FAQ](#-faq)
+- [Performance Benchmarks](#-performance-benchmarks)
+- [Security](#-security)
+- [Known Limitations](#️-known-limitations)
+- [License & Sponsorship](#-license--sponsorship)
+
+</details>
+
 ## Features
 
 - 🔌 **Plugin Architecture** - Extensible validation system with custom agents
@@ -88,6 +122,42 @@ npx @dcyfr/ai config:validate
 npx @dcyfr/ai config:validate --verbose
 ```
 
+## Architecture
+
+The DCYFR AI framework follows a layered architecture with clear separation of concerns:
+
+```mermaid
+graph TB
+    A[Configuration Files] -->|Load & Merge| B[Config Loader]
+    B -->|Initialize| C[Plugin Registry]
+    C -->|Register| D[Validation Engine]
+    C -->|Register| E[Telemetry Engine]
+    D -->|Execute| F[Quality Gates]
+    E -->|Track| G[Storage Adapters]
+    B -->|Configure| H[CLI Interface]
+    H -->|Commands| I[User]
+
+    style A fill:#e1f5ff
+    style B fill:#fff3cd
+    style C fill:#d4edda
+    style D fill:#d4edda
+    style E fill:#d4edda
+    style H fill:#cfe2ff
+    style I fill:#f8d7da
+```
+
+### Key Components
+
+- **Config Loader**: Three-layer merge system (defaults → project config → env vars)
+- **Plugin Registry**: Manages custom and built-in validation agents
+- **Validation Engine**: Executes quality gates in parallel or serial mode
+- **Telemetry Engine**: Tracks usage, costs, quality metrics with pluggable storage
+- **CLI Interface**: User-facing commands for config management and validation
+
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
 ## Configuration
 
 ### File Formats
@@ -154,6 +224,10 @@ const loader = new PluginLoader();
 await loader.loadPlugin(customPlugin);
 ```
 
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
 ## CLI Commands
 
 ```bash
@@ -174,6 +248,10 @@ npx @dcyfr/ai config:schema
 npx @dcyfr/ai help
 ```
 
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
 ## Examples
 
 See [examples/](./examples/) directory:
@@ -187,31 +265,289 @@ 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
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.
 
+### Release Process
+
+We use [Changesets](https://github.com/changesets/changesets) for automated versioning and publishing.
+
+**For contributors:**
+```bash
+# Add a changeset describing your changes
+npm run changeset
+
+# Commit the changeset with your PR
+git add .changeset/*.md
+git commit -m "feat: your feature"
 ```
-@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
+**For maintainers:**
+- Changesets automatically creates Release PRs
+- Merging a Release PR publishes to npm
+- See [Release Management](./docs/RELEASE_MANAGEMENT.md) for full details
+
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
+## 🔧 Troubleshooting
+
+### Installation Issues
+
+**Issue: `npm install @dcyfr/ai` fails with 404**
+- **Cause:** Package may not be published yet or npm registry issue
+- **Solution:** Verify package exists: `npm view @dcyfr/ai`, or install from GitHub: `npm install git+https://github.com/dcyfr/dcyfr-ai.git`
+- **Check:** Visit https://www.npmjs.com/package/@dcyfr/ai to confirm publication status
+
+**Issue: "Cannot find module '@dcyfr/ai'"**
+- **Cause:** Package not in `node_modules` or incorrect import path
+- **Solution:** Run `npm install`, verify import: `import { loadConfig } from '@dcyfr/ai'`
+- **TypeScript:** Ensure `moduleResolution: "bundler"` or `"node16"` in tsconfig.json
+
+### Configuration Issues
+
+**Issue: `.dcyfr.yaml` not detected**
+- **Cause:** File in wrong location or invalid YAML syntax
+- **Solution:**
+  1. Place `.dcyfr.yaml` in project root (same directory as package.json)
+  2. Validate YAML syntax with `npx @dcyfr/ai config:validate`
+  3. Check for tabs (use spaces), missing colons, incorrect indentation
+- **Alternative:** Use `.dcyfr.json` or add `dcyfr` key to `package.json`
+
+**Issue: "Invalid configuration schema"**
+- **Cause:** Missing required fields or incorrect types
+- **Solution:**
+  1. Run `npx @dcyfr/ai config:schema` to see full schema
+  2. Ensure required fields present: `version`, `projectName`
+  3. Check types match (strings in quotes, booleans without quotes, arrays with brackets)
+- **Example:** Valid config minimum:
+```yaml
+version: '1.0.0'
+projectName: my-app
 ```
 
-## License
+**Issue: Environment variables not overriding config**
+- **Cause:** Incorrect env var naming or precedence
+- **Solution:** Use `DCYFR_` prefix with nested path: `DCYFR_AGENTS_DESIGNTOKENS_COMPLIANCE=0.95`
+- **Format:** `DCYFR_<SECTION>_<SUBSECTION>_<KEY>=<value>` (uppercase, underscores)
+- **Debug:** Log final config to see what values are being used
+
+### Plugin Issues
+
+**Issue: Custom plugin not loading**
+- **Cause:** Plugin doesn't implement required interface or missing manifest
+- **Solution:** Ensure plugin exports:
+  1. `manifest` object with `name`, `version`, `description`
+  2. `onValidate` method (async function)
+  3. Proper TypeScript types if using TypeScript
+- **Example:** See [examples/plugin-system.ts](./examples/plugin-system.ts)
+
+**Issue: Validation fails with "No plugins loaded"**
+- **Cause:** Plugins not registered with PluginLoader before validation
+- **Solution:**
+```typescript
+import { PluginLoader } from '@dcyfr/ai';
+const loader = new PluginLoader();
+await loader.loadPlugin(myPlugin);
+await loader.runValidation();
+```
 
-MIT © DCYFR Labs
+### CLI Issues
 
-## Contributing
+**Issue: `npx @dcyfr/ai` command not found**
+- **Cause:** Package not installed or PATH issue
+- **Solution:**
+  - Local: Add to devDependencies: `npm install --save-dev @dcyfr/ai`
+  - Global: `npm install -g @dcyfr/ai`
+  - npx: Use full package name: `npx @dcyfr/ai@latest`
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.
+**Issue: CLI commands hang or timeout**
+- **Cause:** Large project or slow file system operations
+- **Solution:**
+  1. Use `--files` flag to target specific files: `npx @dcyfr/ai validate --files "src/**/*.ts"`
+  2. Increase timeout in config: `timeout: 60000` (60 seconds)
+  3. Check for infinite loops in custom plugins
+
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
+## 📚 FAQ
+
+**Q: Is @dcyfr/ai published to npm?**
+
+A: Yes, it's published as a public package on npm. Install with `npm install @dcyfr/ai`. Check https://www.npmjs.com/package/@dcyfr/ai for latest version and stats.
+
+**Q: Can I use @dcyfr/ai with JavaScript (no TypeScript)?**
+
+A: Yes, but TypeScript is strongly recommended for better type safety and IDE support. The framework provides full TypeScript support with Zod validation for runtime type checking. If using JavaScript, you'll miss compile-time type checking but runtime validation still works.
+
+**Q: How do I create a custom validation plugin?**
+
+A: Implement the `Plugin` interface with `manifest` and `onValidate` method:
+```typescript
+export const myPlugin = {
+  manifest: {
+    name: 'my-plugin',
+    version: '1.0.0',
+    description: 'My custom validation'
+  },
+  async onValidate(context) {
+    // Your validation logic here
+    return { passed: true, issues: [] };
+  }
+};
+```
+See [docs/plugins.md](./docs/plugins.md) and [examples/plugin-system.ts](./examples/plugin-system.ts) for complete guide.
+
+**Q: What's the difference between @dcyfr/ai and @dcyfr/agents?**
+
+A: `@dcyfr/ai` is the **public framework** (plugin architecture, config management, telemetry engine, validation framework). `@dcyfr/agents` is a **private package** with DCYFR-specific validation agents (design tokens, barrel exports, PageLayout enforcement). Think of @dcyfr/ai as the engine, @dcyfr/agents as pre-built plugins.
+
+**Q: Can I use this with other AI providers (non-Claude)?**
+
+A: Yes! The framework supports multi-provider integration including Claude, GitHub Copilot, Groq, Ollama, OpenAI, Anthropic. Configure providers in `.dcyfr.yaml`:
+```yaml
+providers:
+  - name: openai
+    apiKey: ${OPENAI_API_KEY}
+  - name: anthropic
+    apiKey: ${ANTHROPIC_API_KEY}
+```
+
+**Q: How do I track telemetry and costs?**
+
+A: Use the `TelemetryEngine` with storage adapters:
+```typescript
+import { TelemetryEngine, FileStorageAdapter } from '@dcyfr/ai';
+const telemetry = new TelemetryEngine({
+  storage: new FileStorageAdapter('./telemetry')
+});
+```
+Telemetry tracks: API calls, token usage, costs, latency, quality scores. See [docs/configuration.md](./docs/configuration.md#telemetry) for full guide.
+
+**Q: Is this framework production-ready?**
+
+A: Yes! @dcyfr/ai is used in production at dcyfr-labs and other projects. It has comprehensive test coverage, semantic versioning, automated releases via Changesets, and follows best practices for package publishing.
+
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
+## 📊 Performance Benchmarks
+
+### Framework Performance
+- **Config Loading:** ~10ms (cached), ~50ms (first load with file I/O)
+- **Validation Framework:** Parallel execution 2-5x faster than serial (depends on plugin count)
+- **Plugin System:** Minimal overhead ~5ms per plugin registration
+- **Bundle Size:** ~200KB gzipped (includes Zod validation library)
+
+### Recommended Usage Patterns
+- **Use parallel validation** for independent checks (faster): `mode: 'parallel'`
+- **Cache config loading** (use singleton pattern): Load once, reuse across app
+- **Batch telemetry writes** (reduce I/O overhead): Buffer writes, flush periodically
+- **Lazy load plugins** (faster startup): Only load plugins you need for current validation
+
+### Comparison with Alternatives
+- **vs. Custom Scripts:** 10-20x faster due to optimized plugin execution
+- **vs. Serial Validation:** 2-5x faster with parallel execution mode
+- **vs. LangChain:** ~10x smaller bundle size (~200KB vs 2MB+)
+
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
+## 🔒 Security
+
+### Reporting Vulnerabilities
+Found a security issue? Report it privately:
+- **GitHub Security Advisories:** [dcyfr-ai/security](https://github.com/dcyfr/dcyfr-ai/security/advisories/new)
+- **Expected Response:** Within 48 hours
+
+### Security Considerations
+- **No API keys stored:** Use environment variables for sensitive data (Zod validates but doesn't store)
+- **Zod validation:** All inputs validated with schemas before processing
+- **No remote code execution:** Plugins run in local environment only (no sandboxing yet - see limitations)
+- **Telemetry privacy:** Optional, disable with `DCYFR_TELEMETRY_ENABLED=false`
+- **Dependencies:** Regular Dependabot updates, npm audit on CI
+
+### Best Practices
+- Never commit `.env` files (use `.env.example`)
+- Use environment variables for API keys: `${OPENAI_API_KEY}`
+- Review plugin code before loading (plugins have full access to filesystem)
+- Keep dependencies updated: `npm outdated`, `npm update`
+- Enable GitHub security scanning in your repository
+
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
+## ⚙️ Known Limitations
+
+### Current Constraints
+- **Plugin isolation:** Plugins run in same process (no sandboxing yet) - trust plugin code before loading
+- **File-based telemetry only:** No database storage adapter yet (planned for v2.0)
+- **Config caching:** Requires manual cache invalidation on config changes (no hot-reload yet)
+- **Provider-specific features:** Some providers may have limited support (e.g., streaming not supported for all)
+- **TypeScript required for development:** JavaScript works at runtime but TypeScript recommended for development
+
+### Platform-Specific Issues
+- **Windows:** Path separators handled automatically but some plugins may have issues
+- **Node.js version:** Requires ≥18.0.0 (uses native fetch, modern APIs)
+- **ESM-only:** Package is ESM (ECMAScript Modules) - CommonJS require() not supported
+
+### Planned Improvements
+- [ ] Database storage adapter for telemetry (PostgreSQL, SQLite)
+- [ ] Plugin sandboxing for security (worker threads or VM isolation)
+- [ ] Hot-reload config watching (auto-reload on file changes)
+- [ ] Web UI for telemetry dashboard (view costs, usage, quality over time)
+- [ ] Enhanced provider feature parity (streaming, function calling, vision)
+- [ ] CommonJS compatibility mode (for legacy projects)
+
+See [GitHub Issues](https://github.com/dcyfr/dcyfr-ai/issues) for tracked feature requests and bugs.
+
+[⬆️ Back to top](#dcyfr-ai)
+
+---
+
+## 📄 License & Sponsorship
+
+**License:** MIT for personal/non-commercial use. Commercial use requires a paid tier.
+
+### Commercial Use
+
+This package is dual-licensed:
+- **MIT License** for personal, educational, and non-commercial use (free)
+- **Commercial License** for business and revenue-generating use (paid)
+
+**Commercial use includes:**
+- Using @dcyfr/ai in SaaS products or revenue-generating services
+- Deploying in companies with >5 employees
+- Providing paid consulting/services using @dcyfr/ai
+- Distributing as part of commercial products
+
+### Sponsorship Tiers
+
+- 🌍 **Community** ($5/mo) - Signal community access (DCYFR.NET, Quantum Flux)
+- 💚 **Sponsors** ($10/mo) - Bio on dcyfr.ai website + private channels
+- 👨‍💻 **Developer** ($20/mo) - Limited commercial license + pre-release builds + portfolio support
+- 🚀 **Founder** ($2,400/yr) - Full commercial license + 1hr consultation/mo
+- 💼 **Executive** ($4,800/yr) - Business license + 2hr consultation/mo + 50 employees
+- 🏢 **Enterprise** ($9,600/yr) - Enterprise license + 4hr consultation/mo + unlimited scale
+
+**Learn more:** [SPONSORSHIP.md](https://github.com/dcyfr/workspace/blob/main/SPONSORSHIP.md)
+**Join:** [GitHub Sponsors](https://github.com/sponsors/dcyfr)
+**Contact:** licensing@dcyfr.ai
+
+### Trademark
+
+"DCYFR" is a trademark of DCYFR Labs. See [TRADEMARK.md](https://github.com/dcyfr/workspace/blob/main/TRADEMARK.md) for usage guidelines.
+
+---
+
+**Made with ❤️ by [DCYFR Labs](https://dcyfr.ai)**

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'),
+      },
+    },
+  };
+}