@dcyfr/ai 3.2.0 → 3.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,42 @@
1
1
  # Changelog
2
2
 
3
+ ## [3.2.2](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.2.1...v3.2.2) (2026-06-11)
4
+
5
+
6
+ ### Bug Fixes
7
+
8
+ * **cli:** repair published bin layout, fold telemetry into dcyfr-ai ([#256](https://github.com/dcyfr-labs/dcyfr-ai/issues/256)) ([166001e](https://github.com/dcyfr-labs/dcyfr-ai/commit/166001e28948a1eb149edb75028109790baae504))
9
+
10
+
11
+ ### Dependencies
12
+
13
+ * bump @anthropic-ai/sdk from 0.98.0 to 0.102.0 ([#251](https://github.com/dcyfr-labs/dcyfr-ai/issues/251)) ([973cbfb](https://github.com/dcyfr-labs/dcyfr-ai/commit/973cbfb2a52c80d48af04fd8534f3e96cfdb3753))
14
+ * bump @google/genai from 2.6.0 to 2.7.0 ([#239](https://github.com/dcyfr-labs/dcyfr-ai/issues/239)) ([07049bf](https://github.com/dcyfr-labs/dcyfr-ai/commit/07049bf7d726c44081406fac1ef5ef63aedc2fa8))
15
+ * bump @google/genai from 2.7.0 to 2.8.0 ([#247](https://github.com/dcyfr-labs/dcyfr-ai/issues/247)) ([fa36a9f](https://github.com/dcyfr-labs/dcyfr-ai/commit/fa36a9f00d0cb9e957e8b8fcc6732730f3bff3aa))
16
+ * bump @supabase/supabase-js from 2.106.1 to 2.106.2 ([#232](https://github.com/dcyfr-labs/dcyfr-ai/issues/232)) ([43d3039](https://github.com/dcyfr-labs/dcyfr-ai/commit/43d303902894f8c72134fd62d9bccc5bea90d4d6))
17
+ * bump @supabase/supabase-js from 2.106.2 to 2.107.0 ([#249](https://github.com/dcyfr-labs/dcyfr-ai/issues/249)) ([577597a](https://github.com/dcyfr-labs/dcyfr-ai/commit/577597ae52f2e45d26b2ca2c9a1979d1fc4b02bb))
18
+ * bump @types/node from 25.8.0 to 25.9.1 ([#235](https://github.com/dcyfr-labs/dcyfr-ai/issues/235)) ([41be444](https://github.com/dcyfr-labs/dcyfr-ai/commit/41be444c7c32c27891ad2e6d5e0b830dd7bee17b))
19
+ * bump @types/node from 25.9.1 to 25.9.2 ([#250](https://github.com/dcyfr-labs/dcyfr-ai/issues/250)) ([76979dd](https://github.com/dcyfr-labs/dcyfr-ai/commit/76979dd8582f3cd927b49f0da2085ba431cd4947))
20
+ * bump axios from 1.16.1 to 1.17.0 ([#246](https://github.com/dcyfr-labs/dcyfr-ai/issues/246)) ([857b65b](https://github.com/dcyfr-labs/dcyfr-ai/commit/857b65b13f9c337aee0ff6dd0ebe097654a4c143))
21
+ * bump commander from 12.1.0 to 15.0.0 ([#233](https://github.com/dcyfr-labs/dcyfr-ai/issues/233)) ([037bc89](https://github.com/dcyfr-labs/dcyfr-ai/commit/037bc896ae95d7b324f1dac98e186c5376be6c80))
22
+ * bump eslint from 10.4.0 to 10.4.1 ([#237](https://github.com/dcyfr-labs/dcyfr-ai/issues/237)) ([08b4515](https://github.com/dcyfr-labs/dcyfr-ai/commit/08b4515608beb0240efce7e6937c286c50930a19))
23
+ * bump fastmcp from 4.0.1 to 4.0.2 (security: OAuthProxy credential leak fix) ([03efc7c](https://github.com/dcyfr-labs/dcyfr-ai/commit/03efc7cfe5ddb83e10b389e5e1b3423b62702cb7))
24
+ * bump hono in the npm_and_yarn group across 1 directory ([#241](https://github.com/dcyfr-labs/dcyfr-ai/issues/241)) ([4eca502](https://github.com/dcyfr-labs/dcyfr-ai/commit/4eca502a13e9c05f3da8f18808c2e41b2ed6eec4))
25
+ * bump inquirer from 13.4.3 to 14.0.2 ([#230](https://github.com/dcyfr-labs/dcyfr-ai/issues/230)) ([8638e62](https://github.com/dcyfr-labs/dcyfr-ai/commit/8638e62e93179e37db96b41bd082e9ba861de9ec))
26
+ * bump mem0ai from 3.0.3 to 3.0.5 ([#234](https://github.com/dcyfr-labs/dcyfr-ai/issues/234)) ([e757f53](https://github.com/dcyfr-labs/dcyfr-ai/commit/e757f53a0b599be4f0855e8008a6d6cc49d80135))
27
+ * bump mem0ai from 3.0.5 to 3.0.6 ([#248](https://github.com/dcyfr-labs/dcyfr-ai/issues/248)) ([6be4cdc](https://github.com/dcyfr-labs/dcyfr-ai/commit/6be4cdc096b9b9a928c4a0ee2b21c5531cc8c787))
28
+ * bump openai from 6.39.0 to 6.39.1 ([#238](https://github.com/dcyfr-labs/dcyfr-ai/issues/238)) ([d87127b](https://github.com/dcyfr-labs/dcyfr-ai/commit/d87127bf4b2f9ecfeaf2935d1de79d83636926e4))
29
+ * bump typescript-eslint from 8.59.4 to 8.60.0 ([#236](https://github.com/dcyfr-labs/dcyfr-ai/issues/236)) ([a468195](https://github.com/dcyfr-labs/dcyfr-ai/commit/a46819565e677bb88cf1d533905ef4be458580f1))
30
+ * bump typescript-eslint from 8.60.0 to 8.60.1 ([#243](https://github.com/dcyfr-labs/dcyfr-ai/issues/243)) ([790a818](https://github.com/dcyfr-labs/dcyfr-ai/commit/790a818900ae575d39504d592f78b6abb0c8e69f))
31
+ * bump vitest from 4.1.6 to 4.1.8 ([#231](https://github.com/dcyfr-labs/dcyfr-ai/issues/231)) ([a52a822](https://github.com/dcyfr-labs/dcyfr-ai/commit/a52a82254edc2930de0fa44012f001ecef8bd070))
32
+
33
+ ## [3.2.1](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.2.0...v3.2.1) (2026-06-01)
34
+
35
+
36
+ ### Refactoring
37
+
38
+ * clear 4 CodeQL warnings (dead stores + stale test ctor) ([#224](https://github.com/dcyfr-labs/dcyfr-ai/issues/224)) ([a0c6b1c](https://github.com/dcyfr-labs/dcyfr-ai/commit/a0c6b1c60e5b500b0cda2f26237ac11818cf1032))
39
+
3
40
  ## [3.2.0](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.1.0...v3.2.0) (2026-06-01)
4
41
 
5
42
 
package/README.md CHANGED
@@ -111,12 +111,14 @@ Portable AI agent harness with plugin architecture for managing multiple AI prov
111
111
  npm install @dcyfr/ai
112
112
  ```
113
113
 
114
+ > **CLI command name:** the package is `@dcyfr/ai`, but its command-line tool is invoked as **`dcyfr-ai`** — not `@dcyfr/ai`. After installing, run `npx dcyfr-ai <command>` (or, without installing first, `npx -p @dcyfr/ai dcyfr-ai <command>`). Running `npx @dcyfr/ai …` fails with *"could not determine executable to run"* because the package ships several binaries.
115
+
114
116
  ## Quick Start
115
117
 
116
118
  ### 1. Initialize Configuration
117
119
 
118
120
  ```bash
119
- npx @dcyfr/ai config:init
121
+ npx dcyfr-ai config:init
120
122
  ```
121
123
 
122
124
  This creates a `.dcyfr.yaml` configuration file:
@@ -166,10 +168,10 @@ console.log(`Validation: ${report.valid ? "PASS" : "FAIL"}`);
166
168
 
167
169
  ```bash
168
170
  # Validate current project config
169
- npx @dcyfr/ai config:validate
171
+ npx dcyfr-ai config:validate
170
172
 
171
173
  # Show full configuration
172
- npx @dcyfr/ai config:validate --verbose
174
+ npx dcyfr-ai config:validate --verbose
173
175
  ```
174
176
 
175
177
  ---
@@ -423,23 +425,23 @@ console.log(`Memory hit rate: ${(hitRate * 100).toFixed(1)}%`);
423
425
  ### 8. CLI Dashboard Commands
424
426
 
425
427
  ```bash
426
- # View telemetry dashboard
427
- npx @dcyfr/ai telemetry
428
+ # View telemetry dashboard (cost summary + recent activity)
429
+ npx dcyfr-ai telemetry
428
430
 
429
- # Show recent activity
430
- npx @dcyfr/ai telemetry --recent 20
431
+ # Filter by agent
432
+ npx dcyfr-ai telemetry --agent claude
431
433
 
432
- # Cost analysis
433
- npx @dcyfr/ai telemetry --costs
434
+ # Scope to a time period (today, yesterday, week, month)
435
+ npx dcyfr-ai telemetry --period today
434
436
 
435
- # Provider summary
436
- npx @dcyfr/ai telemetry --providers
437
+ # Model usage breakdown
438
+ npx dcyfr-ai telemetry --breakdown models
437
439
 
438
- # Runtime validation
439
- npx @dcyfr/ai validate-runtime
440
+ # Runtime / provider validation
441
+ npx dcyfr-ai validate-runtime
440
442
 
441
- # Export data
442
- npx @dcyfr/ai telemetry --export usage_data.csv
443
+ # Export data to CSV
444
+ npx dcyfr-ai telemetry --export usage_data.csv
443
445
  ```
444
446
 
445
447
  ### 9. Provider Setup
@@ -699,20 +701,20 @@ await loader.loadPlugin(customPlugin);
699
701
 
700
702
  ```bash
701
703
  # Initialize configuration
702
- npx @dcyfr/ai config:init
703
- npx @dcyfr/ai config:init --format json
704
- npx @dcyfr/ai config:init --minimal
704
+ npx dcyfr-ai config:init
705
+ npx dcyfr-ai config:init --format json
706
+ npx dcyfr-ai config:init --minimal
705
707
 
706
708
  # Validate configuration
707
- npx @dcyfr/ai config:validate
708
- npx @dcyfr/ai config:validate --verbose
709
- npx @dcyfr/ai config:validate --config custom.yaml
709
+ npx dcyfr-ai config:validate
710
+ npx dcyfr-ai config:validate --verbose
711
+ npx dcyfr-ai config:validate --config custom.yaml
710
712
 
711
713
  # Show schema
712
- npx @dcyfr/ai config:schema
714
+ npx dcyfr-ai config:schema
713
715
 
714
716
  # Help
715
- npx @dcyfr/ai help
717
+ npx dcyfr-ai help
716
718
  ```
717
719
 
718
720
  [⬆️ Back to top](#dcyfr-ai)
@@ -799,7 +801,7 @@ deps: bump @anthropic-ai/sdk to 0.95.2
799
801
  - **Cause:** File in wrong location or invalid YAML syntax
800
802
  - **Solution:**
801
803
  1. Place `.dcyfr.yaml` in project root (same directory as package.json)
802
- 2. Validate YAML syntax with `npx @dcyfr/ai config:validate`
804
+ 2. Validate YAML syntax with `npx dcyfr-ai config:validate`
803
805
  3. Check for tabs (use spaces), missing colons, incorrect indentation
804
806
  - **Alternative:** Use `.dcyfr.json` or add `dcyfr` key to `package.json`
805
807
 
@@ -807,7 +809,7 @@ deps: bump @anthropic-ai/sdk to 0.95.2
807
809
 
808
810
  - **Cause:** Missing required fields or incorrect types
809
811
  - **Solution:**
810
- 1. Run `npx @dcyfr/ai config:schema` to see full schema
812
+ 1. Run `npx dcyfr-ai config:schema` to see full schema
811
813
  2. Ensure required fields present: `version`, `projectName`
812
814
  3. Check types match (strings in quotes, booleans without quotes, arrays with brackets)
813
815
  - **Example:** Valid config minimum:
@@ -849,19 +851,19 @@ await loader.runValidation();
849
851
 
850
852
  ### CLI Issues
851
853
 
852
- **Issue: `npx @dcyfr/ai` command not found**
854
+ **Issue: `npx @dcyfr/ai config:init` fails with "could not determine executable to run"**
853
855
 
854
- - **Cause:** Package not installed or PATH issue
855
- - **Solution:**
856
- - Local: Add to devDependencies: `npm install --save-dev @dcyfr/ai`
857
- - Global: `npm install -g @dcyfr/ai`
858
- - npx: Use full package name: `npx @dcyfr/ai@latest`
856
+ - **Cause:** The CLI binary is named `dcyfr-ai`, not `@dcyfr/ai`. The package ships two binaries (`dcyfr-ai`, `dcyfr-ai-tui`), so `npx` cannot infer which one `npx @dcyfr/ai …` should run.
857
+ - **Solution:** Invoke the binary by name:
858
+ - After `npm install @dcyfr/ai`: `npx dcyfr-ai config:init`
859
+ - Without installing first: `npx -p @dcyfr/ai dcyfr-ai config:init`
860
+ - Global: `npm install -g @dcyfr/ai`, then `dcyfr-ai config:init`
859
861
 
860
862
  **Issue: CLI commands hang or timeout**
861
863
 
862
864
  - **Cause:** Large project or slow file system operations
863
865
  - **Solution:**
864
- 1. Use `--files` flag to target specific files: `npx @dcyfr/ai validate --files "src/**/*.ts"`
866
+ 1. Use `--files` flag to target specific files: `npx dcyfr-ai validate --files "src/**/*.ts"`
865
867
  2. Increase timeout in config: `timeout: 60000` (60 seconds)
866
868
  3. Check for infinite loops in custom plugins
867
869
 
package/bin/cli.js CHANGED
@@ -156,7 +156,7 @@ async function initConfig(options) {
156
156
  console.log(`✅ Created ${configPath}`);
157
157
  console.log('\nNext steps:');
158
158
  console.log(' 1. Edit the configuration file to match your project');
159
- console.log(' 2. Run `npx @dcyfr/ai config:validate` to verify');
159
+ console.log(' 2. Run `npx dcyfr-ai config:validate` to verify');
160
160
  console.log(' 3. Start using DCYFR AI Framework in your project\n');
161
161
 
162
162
  process.exit(0);
@@ -170,7 +170,7 @@ function showHelp() {
170
170
  DCYFR AI Framework CLI
171
171
 
172
172
  Usage:
173
- npx @dcyfr/ai <command> [options]
173
+ npx dcyfr-ai <command> [options]
174
174
 
175
175
  Commands:
176
176
  config:validate Validate configuration file
@@ -190,19 +190,19 @@ Options:
190
190
 
191
191
  Examples:
192
192
  # Validate current project configuration
193
- npx @dcyfr/ai config:validate
193
+ npx dcyfr-ai config:validate
194
194
 
195
195
  # Validate with custom config file
196
- npx @dcyfr/ai config:validate --config custom.yaml
196
+ npx dcyfr-ai config:validate --config custom.yaml
197
197
 
198
198
  # Initialize new YAML configuration
199
- npx @dcyfr/ai config:init
199
+ npx dcyfr-ai config:init
200
200
 
201
201
  # Initialize minimal JSON configuration
202
- npx @dcyfr/ai config:init --format json --minimal
202
+ npx dcyfr-ai config:init --format json --minimal
203
203
 
204
204
  # Show full configuration with validation
205
- npx @dcyfr/ai config:validate --verbose
205
+ npx dcyfr-ai config:validate --verbose
206
206
 
207
207
  Documentation:
208
208
  https://github.com/dcyfr/dcyfr-ai
@@ -237,7 +237,7 @@ async function main() {
237
237
  case 'tui':
238
238
  // Delegate to TUI CLI
239
239
  console.log('🎨 Launching interactive TUI...\n');
240
- console.log('Use: npx @dcyfr/ai-tui ' + options.command.replace('tui:', ''));
240
+ console.log('Use: npx dcyfr-ai-tui ' + options.command.replace('tui:', ''));
241
241
  console.log('Or run: node bin/tui.js ' + options.command.replace('tui:', ''));
242
242
  process.exit(0);
243
243
  break;
package/bin/dcyfr-ai.js CHANGED
@@ -274,6 +274,8 @@ COMMANDS:
274
274
  validate Run validation checks
275
275
  test Alias for validate
276
276
  report Generate telemetry report
277
+ telemetry View telemetry data, costs, and model usage
278
+ validate-runtime Validate runtime environment and provider config
277
279
  help Show this help message
278
280
 
279
281
  INIT OPTIONS:
@@ -309,6 +311,10 @@ EXAMPLES:
309
311
  dcyfr-ai plugin:create --name my-validator
310
312
  dcyfr-ai validate --files "src/**/*.{ts,tsx}"
311
313
  dcyfr-ai report --period 7d --agent claude
314
+ dcyfr-ai telemetry --period week --agent claude
315
+ dcyfr-ai telemetry --breakdown models
316
+ dcyfr-ai validate-runtime
317
+ dcyfr-ai telemetry --help # full telemetry / validate-runtime options
312
318
 
313
319
  For more information, visit: https://github.com/dcyfr/dcyfr-ai
314
320
  `);
@@ -356,6 +362,15 @@ async function main() {
356
362
  console.log('ℹ️ Use TelemetryEngine API to generate reports');
357
363
  console.log('See: https://github.com/dcyfr/dcyfr-ai/blob/main/examples/standalone-nextjs/scripts/telemetry-report.js\n');
358
364
  break;
365
+ case 'telemetry':
366
+ case 'validate-runtime': {
367
+ // Folded-in telemetry CLI (commander-based). Delegate by importing the
368
+ // built module and letting it re-parse process.argv, where argv[2] is
369
+ // already the subcommand name ('telemetry' | 'validate-runtime').
370
+ const { main: runTelemetryCli } = await import('../dist/ai/src/cli/telemetry-dashboard.js');
371
+ await runTelemetryCli();
372
+ break;
373
+ }
359
374
  case 'help':
360
375
  case '--help':
361
376
  case '-h':
package/bin/tui.js CHANGED
@@ -9,7 +9,7 @@ import chalk from 'chalk';
9
9
  import ora from 'ora';
10
10
  import readline from 'readline';
11
11
  import { ConfigLoader } from '../dist/ai/config/loader.js';
12
- import { ValidationFramework } from '../dist/ai/validation/framework.js';
12
+ import { ValidationFramework } from '../dist/ai/validation/validation-framework.js';
13
13
  import { renderValidationDashboard } from './tui/validation-dashboard.js';
14
14
  import { runConfigWizard } from './tui/config-wizard.js';
15
15
  import { existsSync } from 'fs';
@@ -152,7 +152,7 @@ async function createConfigFile(state, projectRoot) {
152
152
  console.log(chalk.green(`\n✅ Created ${configPath}`));
153
153
  console.log(chalk.cyan('\nNext steps:'));
154
154
  console.log(' 1. Review and customize the configuration');
155
- console.log(' 2. Run ' + chalk.bold('npx @dcyfr/ai tui:dashboard') + ' to test');
155
+ console.log(' 2. Run ' + chalk.bold('npx dcyfr-ai-tui dashboard') + ' to test');
156
156
  console.log(' 3. Integrate into your CI/CD pipeline\n');
157
157
  }
158
158
 
@@ -164,7 +164,7 @@ function showHelp() {
164
164
  DCYFR AI Framework - Interactive TUI
165
165
 
166
166
  Usage:
167
- npx @dcyfr/ai tui:<command> [options]
167
+ npx dcyfr-ai-tui <command> [options]
168
168
 
169
169
  Commands:
170
170
  tui:dashboard Interactive validation dashboard
@@ -178,13 +178,13 @@ Options:
178
178
 
179
179
  Examples:
180
180
  # Run interactive validation dashboard
181
- npx @dcyfr/ai tui:dashboard
181
+ npx dcyfr-ai-tui dashboard
182
182
 
183
183
  # Run configuration wizard
184
- npx @dcyfr/ai tui:wizard
184
+ npx dcyfr-ai-tui wizard
185
185
 
186
186
  # Dashboard with custom config
187
- npx @dcyfr/ai tui:dashboard --config custom.yaml
187
+ npx dcyfr-ai-tui dashboard --config custom.yaml
188
188
 
189
189
  Keyboard Shortcuts:
190
190
  Q Quit