@dcyfr/ai 3.5.3 → 3.7.0

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.
Files changed (77) hide show
  1. package/CHANGELOG.md +110 -0
  2. package/LICENSE +0 -7
  3. package/README.md +8 -39
  4. package/bin/dcyfr-ai.js +24 -6
  5. package/dist/.tsbuildinfo +1 -1
  6. package/dist/ai/agents/agent-loader.d.ts +1 -1
  7. package/dist/ai/agents/agent-registry.d.ts +1 -1
  8. package/dist/ai/agents/agent-router.d.ts +4 -4
  9. package/dist/ai/agents/index.d.ts +9 -9
  10. package/dist/ai/agents/instruction-template.d.ts +1 -1
  11. package/dist/ai/agents/persona-resolver.d.ts +1 -1
  12. package/dist/ai/agents/types.d.ts +1 -1
  13. package/dist/ai/agents-builtin/architecture/architecture-reviewer.d.ts +1 -1
  14. package/dist/ai/agents-builtin/architecture/cloud-architect.d.ts +1 -1
  15. package/dist/ai/agents-builtin/architecture/database-architect.d.ts +1 -1
  16. package/dist/ai/agents-builtin/architecture/index.d.ts +3 -3
  17. package/dist/ai/agents-builtin/content/index.d.ts +1 -1
  18. package/dist/ai/agents-builtin/content/technical-writer.d.ts +1 -1
  19. package/dist/ai/agents-builtin/data/data-scientist.d.ts +1 -1
  20. package/dist/ai/agents-builtin/data/index.d.ts +1 -1
  21. package/dist/ai/agents-builtin/development/backend-architect.d.ts +1 -1
  22. package/dist/ai/agents-builtin/development/frontend-developer.d.ts +1 -1
  23. package/dist/ai/agents-builtin/development/fullstack-developer.d.ts +1 -1
  24. package/dist/ai/agents-builtin/development/index.d.ts +4 -4
  25. package/dist/ai/agents-builtin/development/typescript-pro.d.ts +1 -1
  26. package/dist/ai/agents-builtin/devops/devops-engineer.d.ts +1 -1
  27. package/dist/ai/agents-builtin/devops/index.d.ts +1 -1
  28. package/dist/ai/agents-builtin/index.d.ts +10 -10
  29. package/dist/ai/agents-builtin/performance/index.d.ts +1 -1
  30. package/dist/ai/agents-builtin/performance/performance-profiler.d.ts +1 -1
  31. package/dist/ai/agents-builtin/research/index.d.ts +1 -1
  32. package/dist/ai/agents-builtin/research/research-orchestrator.d.ts +1 -1
  33. package/dist/ai/agents-builtin/security/index.d.ts +1 -1
  34. package/dist/ai/agents-builtin/security/security-engineer.d.ts +1 -1
  35. package/dist/ai/agents-builtin/testing/debugger.d.ts +1 -1
  36. package/dist/ai/agents-builtin/testing/index.d.ts +2 -2
  37. package/dist/ai/agents-builtin/testing/test-engineer.d.ts +1 -1
  38. package/dist/ai/core/provider-registry.d.ts +1 -1
  39. package/dist/ai/core/telemetry-engine.d.ts +2 -2
  40. package/dist/ai/delegation/chain-tracker.d.ts +1 -1
  41. package/dist/ai/generated/version.d.ts +1 -1
  42. package/dist/ai/generated/version.js +1 -1
  43. package/dist/ai/index.d.ts +39 -39
  44. package/dist/ai/mcp/mcp-registry.d.ts +1 -1
  45. package/dist/ai/mcp/servers/shared/utils.d.ts +1 -1
  46. package/dist/ai/metacognition/types.d.ts +1 -1
  47. package/dist/ai/permissions/attenuation-engine.d.ts +1 -1
  48. package/dist/ai/plugins/plugin-loader.d.ts +1 -1
  49. package/dist/ai/src/capability-manifest-generator.d.ts +1 -1
  50. package/dist/ai/src/capability-registry.d.ts +1 -1
  51. package/dist/ai/src/cli/telemetry-dashboard.d.ts +7 -1
  52. package/dist/ai/src/cli/telemetry-dashboard.d.ts.map +1 -1
  53. package/dist/ai/src/cli/telemetry-dashboard.js +14 -4
  54. package/dist/ai/src/cli/telemetry-dashboard.js.map +1 -1
  55. package/dist/ai/src/personas/hooks/before-llm-call.d.ts +1 -1
  56. package/dist/ai/src/personas/index.d.ts +4 -4
  57. package/dist/ai/src/personas/persona-loader.d.ts +1 -1
  58. package/dist/ai/src/personas/voice-resolver.d.ts +1 -1
  59. package/dist/ai/src/runtime/agent-runtime.d.ts +5 -5
  60. package/dist/ai/src/telemetry/delegation-telemetry.d.ts +2 -2
  61. package/dist/ai/src/telemetry/index.d.ts +6 -6
  62. package/dist/ai/src/telemetry/runtime-telemetry-integration.d.ts +3 -3
  63. package/dist/ai/src/telemetry/telemetry-utils.d.ts +1 -1
  64. package/dist/ai/src/types/delegation-contracts.d.ts +1 -1
  65. package/dist/ai/src/verification/multi-modal-formatters.d.ts +3 -3
  66. package/dist/ai/src/verification/output-formatter.d.ts +2 -2
  67. package/dist/ai/src/verification/parser-integration.d.ts +3 -3
  68. package/dist/ai/types/delegation-contracts.d.ts +2 -2
  69. package/dist/ai/types/index.d.ts +4 -4
  70. package/dist/ai/types/telemetry.d.ts +1 -1
  71. package/dist/ai/utils/storage.d.ts +1 -1
  72. package/dist/ai/validation/validation-framework.d.ts +9 -2
  73. package/dist/ai/validation/validation-framework.d.ts.map +1 -1
  74. package/dist/ai/validation/validation-framework.js +32 -1
  75. package/dist/ai/validation/validation-framework.js.map +1 -1
  76. package/dist/ai/verification/policy-framework.d.ts +1 -1
  77. package/package.json +12 -12
package/CHANGELOG.md CHANGED
@@ -1,5 +1,115 @@
1
1
  # Changelog
2
2
 
3
+ ## [3.7.0](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.6.0...v3.7.0) (2026-10-12)
4
+
5
+
6
+ ### Features
7
+
8
+ * **validation:** a run that executes nothing no longer passes ([#500](https://github.com/dcyfr-labs/dcyfr-ai/issues/500)) ([ab61534](https://github.com/dcyfr-labs/dcyfr-ai/commit/ab61534dbf7a63ec013be1318139fe0e18fb46f1))
9
+
10
+
11
+ ### Bug Fixes
12
+
13
+ * **build:** add ESM extensions to the shipped .d.ts files too ([#495](https://github.com/dcyfr-labs/dcyfr-ai/issues/495)) ([4979c65](https://github.com/dcyfr-labs/dcyfr-ai/commit/4979c65db3462748a5b1eaa8e68cab49ef19a9ae))
14
+
15
+
16
+ ### Dependencies
17
+
18
+ * drop gray-matter, which nothing imports ([#497](https://github.com/dcyfr-labs/dcyfr-ai/issues/497)) ([4d76270](https://github.com/dcyfr-labs/dcyfr-ai/commit/4d762703223833448d3a9453190928387a839333))
19
+
20
+ ## [3.6.0](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.5.4...v3.6.0) (2026-10-12)
21
+
22
+
23
+ ### Features
24
+
25
+ * **cli:** add version command and --version/-v flags ([#464](https://github.com/dcyfr-labs/dcyfr-ai/issues/464)) ([25e4583](https://github.com/dcyfr-labs/dcyfr-ai/commit/25e45836f494b8f87ca2ab0004e65b735170e8de))
26
+
27
+
28
+ ### Bug Fixes
29
+
30
+ * **deps:** bump brace-expansion, fast-uri and hono to clear open alerts ([#480](https://github.com/dcyfr-labs/dcyfr-ai/issues/480)) ([1241264](https://github.com/dcyfr-labs/dcyfr-ai/commit/1241264d0d68fceac0257a4bc588e8c5196de11d))
31
+ * **deps:** bump js-yaml to 4.3.2 (GHSA-2883-xcg3-v3hh) ([#466](https://github.com/dcyfr-labs/dcyfr-ai/issues/466)) ([e2e4965](https://github.com/dcyfr-labs/dcyfr-ai/commit/e2e4965d04aeababb275a64cf5682ad68e26456d))
32
+ * **license:** let GitHub detect MIT ([#482](https://github.com/dcyfr-labs/dcyfr-ai/issues/482)) ([16caef4](https://github.com/dcyfr-labs/dcyfr-ai/commit/16caef425133b44009ebb6bf1559192e7aabb14e))
33
+ * **security:** neutralize CSV formula sigils in telemetry export (CWE-1236) ([#463](https://github.com/dcyfr-labs/dcyfr-ai/issues/463)) ([afcfabf](https://github.com/dcyfr-labs/dcyfr-ai/commit/afcfabfb7b5d9a5aaa42f7a2845d56ed03f781a8))
34
+
35
+
36
+ ### Dependencies
37
+
38
+ * bump @azure/identity from 4.13.1 to 4.13.2 ([#443](https://github.com/dcyfr-labs/dcyfr-ai/issues/443)) ([5091d6f](https://github.com/dcyfr-labs/dcyfr-ai/commit/5091d6f67471365d9d44caa4d4c193c12e396448))
39
+ * bump @azure/identity from 4.13.2 to 4.13.3 ([#467](https://github.com/dcyfr-labs/dcyfr-ai/issues/467)) ([bfca783](https://github.com/dcyfr-labs/dcyfr-ai/commit/bfca783979d3056611f467fff657ffe5e65d2509))
40
+ * bump @google/genai from 2.15.0 to 2.21.0 ([#428](https://github.com/dcyfr-labs/dcyfr-ai/issues/428)) ([da24a4c](https://github.com/dcyfr-labs/dcyfr-ai/commit/da24a4c6ab5839c42cabdc58bed4f7f401be29cf))
41
+ * bump @google/genai from 2.21.0 to 2.22.0 ([#446](https://github.com/dcyfr-labs/dcyfr-ai/issues/446)) ([4d1a8f0](https://github.com/dcyfr-labs/dcyfr-ai/commit/4d1a8f08960ae2fd5e9673f918cb99b400c36c80))
42
+ * bump @google/genai from 2.22.0 to 2.23.0 ([#457](https://github.com/dcyfr-labs/dcyfr-ai/issues/457)) ([43458e5](https://github.com/dcyfr-labs/dcyfr-ai/commit/43458e5c510b16c33010e9f349adbbb8034997ba))
43
+ * bump @google/genai from 2.23.0 to 2.24.0 ([#468](https://github.com/dcyfr-labs/dcyfr-ai/issues/468)) ([b7875e7](https://github.com/dcyfr-labs/dcyfr-ai/commit/b7875e7b4c2c8db1e6307c385b25ab7b3a38abdc))
44
+ * bump @qdrant/js-client-rest from 1.18.0 to 1.19.0 ([#430](https://github.com/dcyfr-labs/dcyfr-ai/issues/430)) ([5e55232](https://github.com/dcyfr-labs/dcyfr-ai/commit/5e55232e6bebd23213f92d411de7ae049d976052))
45
+ * bump @supabase/supabase-js from 2.110.8 to 2.116.0 ([#450](https://github.com/dcyfr-labs/dcyfr-ai/issues/450)) ([c250efd](https://github.com/dcyfr-labs/dcyfr-ai/commit/c250efdc93577145a800e269015de749ab11b24a))
46
+ * bump @supabase/supabase-js from 2.116.0 to 2.117.1 ([#471](https://github.com/dcyfr-labs/dcyfr-ai/issues/471)) ([ad6ba49](https://github.com/dcyfr-labs/dcyfr-ai/commit/ad6ba4937055ed4199deb68537987317c1e1ea0f))
47
+ * bump @types/better-sqlite3 from 7.6.13 to 9.6.0 ([#444](https://github.com/dcyfr-labs/dcyfr-ai/issues/444)) ([f89046a](https://github.com/dcyfr-labs/dcyfr-ai/commit/f89046ade89d38392dc9f8dd90ff29630e5fab91))
48
+ * bump @types/node from 26.1.2 to 26.6.2 ([#473](https://github.com/dcyfr-labs/dcyfr-ai/issues/473)) ([e5e59f9](https://github.com/dcyfr-labs/dcyfr-ai/commit/e5e59f9781f7722190b1924d4c7ffc30458af052))
49
+ * bump @upstash/redis from 1.38.0 to 1.38.3 ([#434](https://github.com/dcyfr-labs/dcyfr-ai/issues/434)) ([4642603](https://github.com/dcyfr-labs/dcyfr-ai/commit/464260346cf13b48bb5e23ed7b3ff89a5786dc5c))
50
+ * bump @upstash/redis from 1.38.3 to 1.38.4 ([#452](https://github.com/dcyfr-labs/dcyfr-ai/issues/452)) ([a0bb2bd](https://github.com/dcyfr-labs/dcyfr-ai/commit/a0bb2bdbfadf79214a263bb428ce92d31cea039c))
51
+ * bump @vitest/coverage-v8 from 5.0.0 to 5.0.1 ([#454](https://github.com/dcyfr-labs/dcyfr-ai/issues/454)) ([6e18d8f](https://github.com/dcyfr-labs/dcyfr-ai/commit/6e18d8f72ac45b6730e75e0965fc73f661d05129))
52
+ * bump axios from 1.19.0 to 1.20.0 ([#429](https://github.com/dcyfr-labs/dcyfr-ai/issues/429)) ([a5101d2](https://github.com/dcyfr-labs/dcyfr-ai/commit/a5101d2ba369abd73bb704091d286647cfe8e275))
53
+ * bump cloudflare from 7.0.0 to 7.1.0 ([#449](https://github.com/dcyfr-labs/dcyfr-ai/issues/449)) ([60279cc](https://github.com/dcyfr-labs/dcyfr-ai/commit/60279ccff49f3793a97e5e1536a37647ef40018a))
54
+ * bump eslint from 10.10.0 to 10.11.0 ([#470](https://github.com/dcyfr-labs/dcyfr-ai/issues/470)) ([f3e536f](https://github.com/dcyfr-labs/dcyfr-ai/commit/f3e536ffe44b914ce7be634bde9daaefc974e0dd))
55
+ * bump eslint from 10.8.0 to 10.10.0 ([#440](https://github.com/dcyfr-labs/dcyfr-ai/issues/440)) ([b7ebbc5](https://github.com/dcyfr-labs/dcyfr-ai/commit/b7ebbc51593a883911a318ab3d12d25c8d393135))
56
+ * bump fastmcp from 4.12.1 to 4.20.0 ([#431](https://github.com/dcyfr-labs/dcyfr-ai/issues/431)) ([98d3cbc](https://github.com/dcyfr-labs/dcyfr-ai/commit/98d3cbcf36a0406e0e707112f70d9e72bad7179b))
57
+ * bump fastmcp from 4.20.0 to 4.20.10 ([#442](https://github.com/dcyfr-labs/dcyfr-ai/issues/442)) ([bba6594](https://github.com/dcyfr-labs/dcyfr-ai/commit/bba6594b8011afd8f29fcce259425cab2b720eb2))
58
+ * bump fastmcp from 4.20.10 to 4.20.14 ([#455](https://github.com/dcyfr-labs/dcyfr-ai/issues/455)) ([01ce679](https://github.com/dcyfr-labs/dcyfr-ai/commit/01ce679adb1272b16ee8175cc6fde6f45603a103))
59
+ * bump globals from 17.8.0 to 17.12.0 ([#453](https://github.com/dcyfr-labs/dcyfr-ai/issues/453)) ([9a8174e](https://github.com/dcyfr-labs/dcyfr-ai/commit/9a8174ee28230e90faea603e37343932feb2ac6e))
60
+ * bump groq-sdk from 1.4.1 to 1.6.0 ([#448](https://github.com/dcyfr-labs/dcyfr-ai/issues/448)) ([b3a0451](https://github.com/dcyfr-labs/dcyfr-ai/commit/b3a0451fa60fa2e7bcd03263853231e8b11dbd80))
61
+ * bump inquirer from 14.0.2 to 14.2.2 ([#474](https://github.com/dcyfr-labs/dcyfr-ai/issues/474)) ([8eead79](https://github.com/dcyfr-labs/dcyfr-ai/commit/8eead79219e6d614b988a0ea7681b944139b88e2))
62
+ * bump mem0ai from 3.1.2 to 3.1.8 ([#427](https://github.com/dcyfr-labs/dcyfr-ai/issues/427)) ([964d004](https://github.com/dcyfr-labs/dcyfr-ai/commit/964d0040cdb59f5d9e95389c5e93139a0206d201))
63
+ * bump mem0ai from 3.1.8 to 3.3.0 ([#472](https://github.com/dcyfr-labs/dcyfr-ai/issues/472)) ([c59f876](https://github.com/dcyfr-labs/dcyfr-ai/commit/c59f8766650540b49f5fdbdc0df8abc1a283dad5))
64
+ * bump pg from 8.22.0 to 8.23.0 ([#426](https://github.com/dcyfr-labs/dcyfr-ai/issues/426)) ([adf98ef](https://github.com/dcyfr-labs/dcyfr-ai/commit/adf98ef5d7e6a3d9457eff0b3663eca6fac79fc0))
65
+ * bump proxy-addr from 2.0.7 to 2.0.8 ([#487](https://github.com/dcyfr-labs/dcyfr-ai/issues/487)) ([961a333](https://github.com/dcyfr-labs/dcyfr-ai/commit/961a33326c0f7de9e77d83874e9379478a8c853d))
66
+ * bump redis from 6.1.0 to 6.2.1 ([#425](https://github.com/dcyfr-labs/dcyfr-ai/issues/425)) ([2bbfd70](https://github.com/dcyfr-labs/dcyfr-ai/commit/2bbfd7036772566c2a881349733e25abb24ab91b))
67
+ * bump source-map-js from 1.2.1 to 1.2.2 ([#486](https://github.com/dcyfr-labs/dcyfr-ai/issues/486)) ([a5d13f8](https://github.com/dcyfr-labs/dcyfr-ai/commit/a5d13f8f0d312a0bc421c19428adf104e16d022e))
68
+ * bump the npm_and_yarn group across 1 directory with 2 updates ([#477](https://github.com/dcyfr-labs/dcyfr-ai/issues/477)) ([efdce5f](https://github.com/dcyfr-labs/dcyfr-ai/commit/efdce5f6f9f2307fa7413a23b1559ce95eebcec4))
69
+ * bump the npm_and_yarn group across 1 directory with 3 updates ([#435](https://github.com/dcyfr-labs/dcyfr-ai/issues/435)) ([6a16d89](https://github.com/dcyfr-labs/dcyfr-ai/commit/6a16d8989ca8688190e09d955ed7e98467493282))
70
+ * bump typescript-eslint from 8.65.0 to 8.70.0 ([#456](https://github.com/dcyfr-labs/dcyfr-ai/issues/456)) ([342ad1c](https://github.com/dcyfr-labs/dcyfr-ai/commit/342ad1ceb51b46be5464b8940aa3641403139ae9))
71
+ * bump vite from 8.2.2 to 8.3.0 ([#445](https://github.com/dcyfr-labs/dcyfr-ai/issues/445)) ([33d70a9](https://github.com/dcyfr-labs/dcyfr-ai/commit/33d70a9ebe7466b532cb67bbf4746b3a137a9cc2))
72
+ * bump vitest from 5.0.0 to 5.0.1 ([#458](https://github.com/dcyfr-labs/dcyfr-ai/issues/458)) ([7b3c93a](https://github.com/dcyfr-labs/dcyfr-ai/commit/7b3c93aad4541b19f302df4f6cf84bfab7a74e60))
73
+ * bump zod from 4.4.3 to 4.6.2 ([#447](https://github.com/dcyfr-labs/dcyfr-ai/issues/447)) ([aa08587](https://github.com/dcyfr-labs/dcyfr-ai/commit/aa08587f7b70a817cc8ce0f6e50b7553560e093d))
74
+ * bump zod from 4.6.2 to 4.6.5 ([#469](https://github.com/dcyfr-labs/dcyfr-ai/issues/469)) ([2b903c7](https://github.com/dcyfr-labs/dcyfr-ai/commit/2b903c7e0e0cae4d3ae750fe656984241e92aea4))
75
+
76
+ ## [3.5.4](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.5.3...v3.5.4) (2026-09-05)
77
+
78
+
79
+ ### Bug Fixes
80
+
81
+ * **ci:** scope the weekly Semgrep sweep to Code so it stops OOMing ([5021eac](https://github.com/dcyfr-labs/dcyfr-ai/commit/5021eac82e699dc05e0ee1dc91e85ad8013d4545))
82
+ * **ci:** scope the weekly Semgrep sweep to Code so it stops OOMing ([77163a5](https://github.com/dcyfr-labs/dcyfr-ai/commit/77163a59f697298b5f6d69471910036f0f51bf32))
83
+ * **ci:** unblock bot PRs on security-review ([#413](https://github.com/dcyfr-labs/dcyfr-ai/issues/413)) ([cfad789](https://github.com/dcyfr-labs/dcyfr-ai/commit/cfad7898e53a634bafde5fe388f0e56629a1db24))
84
+ * **deps:** clear all 17 open high Dependabot alerts ([9759a1e](https://github.com/dcyfr-labs/dcyfr-ai/commit/9759a1ea1671ef863a095616eb2b0b4ad98e0c9e))
85
+ * **deps:** clear all 17 open high Dependabot alerts (lockfile bumps) ([a1eb387](https://github.com/dcyfr-labs/dcyfr-ai/commit/a1eb3874fd8dcb13180ca43ec0bcf5cabd4e4285))
86
+ * **deps:** make the axios override track the direct dep ([56f4945](https://github.com/dcyfr-labs/dcyfr-ai/commit/56f4945ddcb1e531d440dffcdcde0a3bc1ad3ac8))
87
+ * **deps:** make the axios override track the direct dep ([ea58eb6](https://github.com/dcyfr-labs/dcyfr-ai/commit/ea58eb60973bbd238dc9f2ab7cc4c8b5afc82004))
88
+ * **deps:** patch fast-uri advisories in the lockfile ([#414](https://github.com/dcyfr-labs/dcyfr-ai/issues/414)) ([286bcb9](https://github.com/dcyfr-labs/dcyfr-ai/commit/286bcb92c77e40d65fabe2ad222d976a4e9cc2bf))
89
+ * **deps:** patch fast-uri advisories in the nested example lockfile ([#418](https://github.com/dcyfr-labs/dcyfr-ai/issues/418)) ([1c09e4d](https://github.com/dcyfr-labs/dcyfr-ai/commit/1c09e4d9f86bc9db85c727a57b1a41a55c048b48))
90
+
91
+
92
+ ### Dependencies
93
+
94
+ * Bump @anthropic-ai/sdk from 0.112.3 to 0.115.0 ([#390](https://github.com/dcyfr-labs/dcyfr-ai/issues/390)) ([64f1dec](https://github.com/dcyfr-labs/dcyfr-ai/commit/64f1dec22b678c5049fee4e51b8bb46f6311e5d4))
95
+ * Bump @google/genai from 2.12.0 to 2.13.0 ([#388](https://github.com/dcyfr-labs/dcyfr-ai/issues/388)) ([cd2b543](https://github.com/dcyfr-labs/dcyfr-ai/commit/cd2b543917913fb6808807adbbbc7bd83d99b672))
96
+ * Bump @google/genai from 2.13.0 to 2.15.0 ([#407](https://github.com/dcyfr-labs/dcyfr-ai/issues/407)) ([bbf4c02](https://github.com/dcyfr-labs/dcyfr-ai/commit/bbf4c023db4ee40a37d1d65c2208c7a1670d6f40))
97
+ * bump @hono/node-server ([#398](https://github.com/dcyfr-labs/dcyfr-ai/issues/398)) ([7a586ea](https://github.com/dcyfr-labs/dcyfr-ai/commit/7a586ea303ec7ca4492ed83f2c4ddf0fb4246373))
98
+ * Bump @langchain/core from 1.2.3 to 1.2.4 ([#404](https://github.com/dcyfr-labs/dcyfr-ai/issues/404)) ([3c2b8da](https://github.com/dcyfr-labs/dcyfr-ai/commit/3c2b8da9f34226b4165663c1058121c7629becce))
99
+ * Bump @supabase/supabase-js from 2.110.7 to 2.110.8 ([#396](https://github.com/dcyfr-labs/dcyfr-ai/issues/396)) ([3a4d3b8](https://github.com/dcyfr-labs/dcyfr-ai/commit/3a4d3b89b8030f5b0331def46429cb5eec713ceb))
100
+ * Bump @types/node from 26.1.1 to 26.1.2 ([#405](https://github.com/dcyfr-labs/dcyfr-ai/issues/405)) ([8250f42](https://github.com/dcyfr-labs/dcyfr-ai/commit/8250f42a7e66fd1af709365a4f3f7dfb1eaff760))
101
+ * Bump axios from 1.18.1 to 1.19.0 ([#401](https://github.com/dcyfr-labs/dcyfr-ai/issues/401)) ([f5d2245](https://github.com/dcyfr-labs/dcyfr-ai/commit/f5d2245ce8224593b8bc6aae70aa849d1c5ced02))
102
+ * bump better-sqlite3 from 12.11.1 to 13.0.3 ([#402](https://github.com/dcyfr-labs/dcyfr-ai/issues/402)) ([1a78396](https://github.com/dcyfr-labs/dcyfr-ai/commit/1a783966d4c9a8318ef5889b1b7fdf77736f85da))
103
+ * Bump eslint from 10.7.0 to 10.8.0 ([#392](https://github.com/dcyfr-labs/dcyfr-ai/issues/392)) ([9dd9f41](https://github.com/dcyfr-labs/dcyfr-ai/commit/9dd9f413d7fc8768ea02633abeeab3eaac2be724))
104
+ * Bump fastmcp from 4.12.0 to 4.12.1 ([#400](https://github.com/dcyfr-labs/dcyfr-ai/issues/400)) ([773ca0d](https://github.com/dcyfr-labs/dcyfr-ai/commit/773ca0d3515f7ce4d85b3e1a71046c010076e0fa))
105
+ * Bump fastmcp from 4.7.2 to 4.12.0 ([#395](https://github.com/dcyfr-labs/dcyfr-ai/issues/395)) ([93ec0be](https://github.com/dcyfr-labs/dcyfr-ai/commit/93ec0be5952f34ce763d8aaa97b88342ff3c192e))
106
+ * Bump globals from 17.7.0 to 17.8.0 ([#403](https://github.com/dcyfr-labs/dcyfr-ai/issues/403)) ([d803d4d](https://github.com/dcyfr-labs/dcyfr-ai/commit/d803d4dd901a293d00cf3777710111bd62a203e8))
107
+ * Bump groq-sdk from 1.3.0 to 1.4.1 ([#406](https://github.com/dcyfr-labs/dcyfr-ai/issues/406)) ([52cc1ee](https://github.com/dcyfr-labs/dcyfr-ai/commit/52cc1ee116c38d7e17b2bdcacb6f0d34cb017106))
108
+ * Bump mem0ai from 3.1.0 to 3.1.2 ([#394](https://github.com/dcyfr-labs/dcyfr-ai/issues/394)) ([aef6427](https://github.com/dcyfr-labs/dcyfr-ai/commit/aef6427d254f9849191501e56fb3952b7ae1dedc))
109
+ * Bump openai from 6.48.0 to 6.49.0 ([#387](https://github.com/dcyfr-labs/dcyfr-ai/issues/387)) ([c1d75cd](https://github.com/dcyfr-labs/dcyfr-ai/commit/c1d75cd9fb9a7696448d5f7f8d86a8589deacd68))
110
+ * Bump postcss in the npm_and_yarn group across 1 directory ([#397](https://github.com/dcyfr-labs/dcyfr-ai/issues/397)) ([7a559bf](https://github.com/dcyfr-labs/dcyfr-ai/commit/7a559bffd6115e906659811e2fab7be93e27337c))
111
+ * Bump typescript-eslint from 8.64.0 to 8.65.0 ([#389](https://github.com/dcyfr-labs/dcyfr-ai/issues/389)) ([56ea9b4](https://github.com/dcyfr-labs/dcyfr-ai/commit/56ea9b454e72a1e2f11ab8c3420979b07e1c46cd))
112
+
3
113
  ## [3.5.3](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.5.2...v3.5.3) (2026-07-24)
4
114
 
5
115
 
package/LICENSE CHANGED
@@ -1,5 +1,3 @@
1
- SPDX-License-Identifier: MIT
2
-
3
1
  # MIT License
4
2
 
5
3
  Copyright © 2025-2026 DCYFR Labs
@@ -21,8 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21
19
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23
21
  SOFTWARE.
24
-
25
- ## Trademark Notice
26
-
27
- DCYFR is a trademark of DCYFR Labs. When using DCYFR in titles, product names,
28
- or branding, proper trademark notation should be used (DCYFR™, DCYFR Labs®).
package/README.md CHANGED
@@ -27,41 +27,11 @@ Portable AI agent harness with plugin architecture for managing multiple AI prov
27
27
 
28
28
  `@dcyfr/ai` is maintained by **DCYFR Labs** as part of the DCYFR AI tooling portfolio.
29
29
 
30
- - **DCYFR** is a registered trademark of DCYFR Labs.
30
+ - **DCYFR** is a trademark of Drew Gowan.
31
31
  - Primary domain: [www.dcyfr.ai](https://www.dcyfr.ai)
32
32
  - Licensing details: [LICENSE](./LICENSE)
33
33
  - Peerlist project: [peerlist.io/dcyfr/project/dcyfr-ai](https://peerlist.io/dcyfr/project/dcyfr-ai)
34
34
 
35
- ## 🔍 @dcyfr/ai vs. Alternatives
36
-
37
- | Feature | @dcyfr/ai | LangChain | Vercel AI SDK | AutoGPT |
38
- | -------------- | ------------------------------ | ---------- | ------------- | ------- |
39
- | Multi-Provider | ✅ | ✅ | ✅ | ❌ |
40
- | Plugin System | ✅ Custom | ✅ Complex | ❌ | ❌ |
41
- | Telemetry | ✅ Built-in | ❌ | ❌ | ❌ |
42
- | Zero Config | ✅ | ❌ | ✅ | ❌ |
43
- | Bundle Size | [![Bundle size](https://img.shields.io/bundlephobia/minzip/@dcyfr/ai)](https://bundlephobia.com/package/@dcyfr/ai) | ~2.3MB | ~450KB | N/A |
44
- | TypeScript | ✅ Strict | Partial | ✅ | ❌ |
45
- | Quality Gates | ✅ | ❌ | ❌ | ❌ |
46
- | Config System | YAML/JSON/package | Code-only | Code-only | JSON |
47
- | Learning Curve | Low | High | Low | High |
48
-
49
- ---
50
-
51
- ## 📊 npm Statistics
52
-
53
- [![npm](https://img.shields.io/npm/v/@dcyfr/ai?logo=npm&logoColor=white)](https://www.npmjs.com/package/@dcyfr/ai)
54
- [![Downloads](https://img.shields.io/npm/dm/@dcyfr/ai?logo=npm&logoColor=white)](https://www.npmjs.com/package/@dcyfr/ai)
55
- [![Bundle Size](https://img.shields.io/bundlephobia/minzip/@dcyfr/ai?logo=webpack)](https://bundlephobia.com/package/@dcyfr/ai)
56
-
57
- - **Weekly Downloads:** Check [npm stats](https://www.npmjs.com/package/@dcyfr/ai)
58
- - **Dependencies:** 27 production dependencies
59
- - **Bundle Size:** See badge above ([![minzip](https://img.shields.io/bundlephobia/minzip/@dcyfr/ai)](https://bundlephobia.com/package/@dcyfr/ai))
60
- - **TypeScript:** Full type definitions included
61
- - **ESM Support:** ✅ Full ESM modules with tree shaking
62
-
63
- ---
64
-
65
35
  ## Table of Contents
66
36
 
67
37
  <details>
@@ -163,6 +133,8 @@ const report = await framework.validate({
163
133
  console.log(`Validation: ${report.valid ? "PASS" : "FAIL"}`);
164
134
  ```
165
135
 
136
+ Each gate runs the plugins named in its `plugins` list, which you load with `framework.loadPlugins([...])` (see [docs/PLUGINS.md](docs/PLUGINS.md)). A gate whose plugins aren't loaded runs nothing and is reported with `skipped: true`. If that gate is `required`, it fails with a `gate-skipped` violation naming the missing plugins. A report where no gate ran anything is never `valid`. Until you load plugins for the default gates, this script prints `FAIL`.
137
+
166
138
  ### 3. Validate Configuration
167
139
 
168
140
  ```bash
@@ -699,6 +671,9 @@ npx dcyfr-ai config:validate --config custom.yaml
699
671
  # Show schema
700
672
  npx dcyfr-ai config:schema
701
673
 
674
+ # Version
675
+ npx dcyfr-ai --version
676
+
702
677
  # Help
703
678
  npx dcyfr-ai help
704
679
  ```
@@ -937,12 +912,6 @@ A: Yes! @dcyfr/ai is used in production at dcyfr-labs and other projects. It has
937
912
  - **Batch telemetry writes** (reduce I/O overhead): Buffer writes, flush periodically
938
913
  - **Lazy load plugins** (faster startup): Only load plugins you need for current validation
939
914
 
940
- ### Comparison with Alternatives
941
-
942
- - **vs. Custom Scripts:** 10-20x faster due to optimized plugin execution
943
- - **vs. Serial Validation:** 2-5x faster with parallel execution mode
944
- - **vs. LangChain:** Smaller bundle footprint ([bundlephobia](https://bundlephobia.com/package/@dcyfr/ai))
945
-
946
915
  [⬆️ Back to top](#dcyfr-ai)
947
916
 
948
917
  ---
@@ -1016,11 +985,11 @@ See [GitHub Issues](https://github.com/dcyfr-labs/dcyfr-ai/issues) for tracked f
1016
985
  Development is supported through sponsorship — if @dcyfr/ai is useful to you or your business, consider sponsoring.
1017
986
 
1018
987
  **Join:** [GitHub Sponsors](https://github.com/sponsors/dcyfr)
1019
- **Contact:** licensing@dcyfr.ai
988
+ **Contact:** [hello@dcyfr.ai](mailto:hello@dcyfr.ai)
1020
989
 
1021
990
  ### Trademark
1022
991
 
1023
- "DCYFR" is a trademark of DCYFR Labs.
992
+ "DCYFR" is a trademark of Drew Gowan.
1024
993
 
1025
994
  ---
1026
995
 
package/bin/dcyfr-ai.js CHANGED
@@ -5,9 +5,10 @@
5
5
  * Extended tool for initialization, validation, and management
6
6
  */
7
7
 
8
- import { ConfigLoader } from '../dist/ai/config/loader.js';
9
- import { FrameworkConfigSchema, DEFAULT_CONFIG } from '../dist/ai/config/schema.js';
10
- import { existsSync, writeFileSync, mkdirSync } from 'fs';
8
+ // dist/ imports stay lazy (inside the commands that need them) so that
9
+ // version/help keep working on a broken or partially-installed package —
10
+ // exactly the support-triage flow where `dcyfr-ai --version` matters (#253).
11
+ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
11
12
  import { join, dirname } from 'path';
12
13
  import { fileURLToPath } from 'url';
13
14
 
@@ -120,7 +121,6 @@ async function initConfig(options) {
120
121
  const templatePath = join(templateDir, templateFile);
121
122
 
122
123
  try {
123
- const { readFileSync } = await import('fs');
124
124
  const template = readFileSync(templatePath, 'utf-8');
125
125
  writeFileSync(outputPath, template);
126
126
  console.log(`✅ Created ${outputPath}`);
@@ -140,6 +140,9 @@ async function validateConfig(options) {
140
140
  const configFile = options.flags.config;
141
141
 
142
142
  try {
143
+ const { ConfigLoader } = await import('../dist/ai/config/loader.js');
144
+ const { FrameworkConfigSchema } = await import('../dist/ai/config/schema.js');
145
+
143
146
  const loader = new ConfigLoader({
144
147
  projectRoot,
145
148
  configFile,
@@ -179,7 +182,8 @@ async function validateConfig(options) {
179
182
  /**
180
183
  * Show configuration schema
181
184
  */
182
- function showSchema() {
185
+ async function showSchema() {
186
+ const { DEFAULT_CONFIG } = await import('../dist/ai/config/schema.js');
183
187
  console.log('📋 DCYFR Configuration Schema\n');
184
188
  console.log(JSON.stringify(DEFAULT_CONFIG, null, 2));
185
189
  }
@@ -260,6 +264,14 @@ export const ${toCamelCase(name)}: Plugin = {
260
264
  console.log(' 2. Import and load the plugin in your validation script\n');
261
265
  }
262
266
 
267
+ /**
268
+ * Print the package version (read from the package's own package.json)
269
+ */
270
+ function showVersion() {
271
+ const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
272
+ console.log(pkg.version);
273
+ }
274
+
263
275
  /**
264
276
  * Show help
265
277
  */
@@ -281,6 +293,7 @@ COMMANDS:
281
293
  report Generate telemetry report
282
294
  telemetry View telemetry data, costs, and model usage
283
295
  validate-runtime Validate runtime environment and provider config
296
+ version Print the CLI version (also: --version, -v)
284
297
  help Show this help message
285
298
 
286
299
  INIT OPTIONS:
@@ -351,7 +364,7 @@ async function main() {
351
364
  await validateConfig(options);
352
365
  break;
353
366
  case 'config:schema':
354
- showSchema();
367
+ await showSchema();
355
368
  break;
356
369
  case 'plugin:create':
357
370
  await createPlugin(options);
@@ -376,6 +389,11 @@ async function main() {
376
389
  await runTelemetryCli();
377
390
  break;
378
391
  }
392
+ case 'version':
393
+ case '--version':
394
+ case '-v':
395
+ showVersion();
396
+ break;
379
397
  case 'help':
380
398
  case '--help':
381
399
  case '-h':