@dcyfr/ai 3.2.1 → 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 +30 -0
- package/README.md +34 -32
- package/bin/cli.js +8 -8
- package/bin/dcyfr-ai.js +15 -0
- package/bin/tui.js +6 -6
- package/dist/.tsbuildinfo +1 -1
- package/dist/ai/src/cli/telemetry-dashboard.d.ts +7 -10
- package/dist/ai/src/cli/telemetry-dashboard.d.ts.map +1 -1
- package/dist/ai/src/cli/telemetry-dashboard.js +39 -77
- package/dist/ai/src/cli/telemetry-dashboard.js.map +1 -1
- package/package.json +8 -8
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,35 @@
|
|
|
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
|
+
|
|
3
33
|
## [3.2.1](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.2.0...v3.2.1) (2026-06-01)
|
|
4
34
|
|
|
5
35
|
|
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
|
|
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
|
|
171
|
+
npx dcyfr-ai config:validate
|
|
170
172
|
|
|
171
173
|
# Show full configuration
|
|
172
|
-
npx
|
|
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
|
|
428
|
+
# View telemetry dashboard (cost summary + recent activity)
|
|
429
|
+
npx dcyfr-ai telemetry
|
|
428
430
|
|
|
429
|
-
#
|
|
430
|
-
npx
|
|
431
|
+
# Filter by agent
|
|
432
|
+
npx dcyfr-ai telemetry --agent claude
|
|
431
433
|
|
|
432
|
-
#
|
|
433
|
-
npx
|
|
434
|
+
# Scope to a time period (today, yesterday, week, month)
|
|
435
|
+
npx dcyfr-ai telemetry --period today
|
|
434
436
|
|
|
435
|
-
#
|
|
436
|
-
npx
|
|
437
|
+
# Model usage breakdown
|
|
438
|
+
npx dcyfr-ai telemetry --breakdown models
|
|
437
439
|
|
|
438
|
-
# Runtime validation
|
|
439
|
-
npx
|
|
440
|
+
# Runtime / provider validation
|
|
441
|
+
npx dcyfr-ai validate-runtime
|
|
440
442
|
|
|
441
|
-
# Export data
|
|
442
|
-
npx
|
|
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
|
|
703
|
-
npx
|
|
704
|
-
npx
|
|
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
|
|
708
|
-
npx
|
|
709
|
-
npx
|
|
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
|
|
714
|
+
npx dcyfr-ai config:schema
|
|
713
715
|
|
|
714
716
|
# Help
|
|
715
|
-
npx
|
|
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
|
|
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
|
|
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`
|
|
854
|
+
**Issue: `npx @dcyfr/ai config:init` fails with "could not determine executable to run"**
|
|
853
855
|
|
|
854
|
-
- **Cause:**
|
|
855
|
-
- **Solution:**
|
|
856
|
-
-
|
|
857
|
-
-
|
|
858
|
-
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
193
|
+
npx dcyfr-ai config:validate
|
|
194
194
|
|
|
195
195
|
# Validate with custom config file
|
|
196
|
-
npx
|
|
196
|
+
npx dcyfr-ai config:validate --config custom.yaml
|
|
197
197
|
|
|
198
198
|
# Initialize new YAML configuration
|
|
199
|
-
npx
|
|
199
|
+
npx dcyfr-ai config:init
|
|
200
200
|
|
|
201
201
|
# Initialize minimal JSON configuration
|
|
202
|
-
npx
|
|
202
|
+
npx dcyfr-ai config:init --format json --minimal
|
|
203
203
|
|
|
204
204
|
# Show full configuration with validation
|
|
205
|
-
npx
|
|
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
|
|
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
|
|
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
|
|
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
|
|
181
|
+
npx dcyfr-ai-tui dashboard
|
|
182
182
|
|
|
183
183
|
# Run configuration wizard
|
|
184
|
-
npx
|
|
184
|
+
npx dcyfr-ai-tui wizard
|
|
185
185
|
|
|
186
186
|
# Dashboard with custom config
|
|
187
|
-
npx
|
|
187
|
+
npx dcyfr-ai-tui dashboard --config custom.yaml
|
|
188
188
|
|
|
189
189
|
Keyboard Shortcuts:
|
|
190
190
|
Q Quit
|