@dcyfr/ai 3.5.3 → 3.6.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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,98 @@
1
1
  # Changelog
2
2
 
3
+ ## [3.6.0](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.5.4...v3.6.0) (2026-10-12)
4
+
5
+
6
+ ### Features
7
+
8
+ * **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))
9
+
10
+
11
+ ### Bug Fixes
12
+
13
+ * **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))
14
+ * **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))
15
+ * **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))
16
+ * **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))
17
+
18
+
19
+ ### Dependencies
20
+
21
+ * 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))
22
+ * 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))
23
+ * 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))
24
+ * 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))
25
+ * 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))
26
+ * 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))
27
+ * 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))
28
+ * 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))
29
+ * 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))
30
+ * 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))
31
+ * 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))
32
+ * 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))
33
+ * 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))
34
+ * 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))
35
+ * 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))
36
+ * 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))
37
+ * 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))
38
+ * 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))
39
+ * 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))
40
+ * 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))
41
+ * 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))
42
+ * 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))
43
+ * 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))
44
+ * 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))
45
+ * 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))
46
+ * 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))
47
+ * 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))
48
+ * 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))
49
+ * 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))
50
+ * 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))
51
+ * 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))
52
+ * 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))
53
+ * 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))
54
+ * 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))
55
+ * 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))
56
+ * 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))
57
+ * 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))
58
+
59
+ ## [3.5.4](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.5.3...v3.5.4) (2026-09-05)
60
+
61
+
62
+ ### Bug Fixes
63
+
64
+ * **ci:** scope the weekly Semgrep sweep to Code so it stops OOMing ([5021eac](https://github.com/dcyfr-labs/dcyfr-ai/commit/5021eac82e699dc05e0ee1dc91e85ad8013d4545))
65
+ * **ci:** scope the weekly Semgrep sweep to Code so it stops OOMing ([77163a5](https://github.com/dcyfr-labs/dcyfr-ai/commit/77163a59f697298b5f6d69471910036f0f51bf32))
66
+ * **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))
67
+ * **deps:** clear all 17 open high Dependabot alerts ([9759a1e](https://github.com/dcyfr-labs/dcyfr-ai/commit/9759a1ea1671ef863a095616eb2b0b4ad98e0c9e))
68
+ * **deps:** clear all 17 open high Dependabot alerts (lockfile bumps) ([a1eb387](https://github.com/dcyfr-labs/dcyfr-ai/commit/a1eb3874fd8dcb13180ca43ec0bcf5cabd4e4285))
69
+ * **deps:** make the axios override track the direct dep ([56f4945](https://github.com/dcyfr-labs/dcyfr-ai/commit/56f4945ddcb1e531d440dffcdcde0a3bc1ad3ac8))
70
+ * **deps:** make the axios override track the direct dep ([ea58eb6](https://github.com/dcyfr-labs/dcyfr-ai/commit/ea58eb60973bbd238dc9f2ab7cc4c8b5afc82004))
71
+ * **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))
72
+ * **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))
73
+
74
+
75
+ ### Dependencies
76
+
77
+ * 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))
78
+ * 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))
79
+ * 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))
80
+ * bump @hono/node-server ([#398](https://github.com/dcyfr-labs/dcyfr-ai/issues/398)) ([7a586ea](https://github.com/dcyfr-labs/dcyfr-ai/commit/7a586ea303ec7ca4492ed83f2c4ddf0fb4246373))
81
+ * 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))
82
+ * 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))
83
+ * 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))
84
+ * 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))
85
+ * 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))
86
+ * 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))
87
+ * 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))
88
+ * 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))
89
+ * 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))
90
+ * 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))
91
+ * 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))
92
+ * 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))
93
+ * 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))
94
+ * 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))
95
+
3
96
  ## [3.5.3](https://github.com/dcyfr-labs/dcyfr-ai/compare/v3.5.2...v3.5.3) (2026-07-24)
4
97
 
5
98
 
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>
@@ -699,6 +669,9 @@ npx dcyfr-ai config:validate --config custom.yaml
699
669
  # Show schema
700
670
  npx dcyfr-ai config:schema
701
671
 
672
+ # Version
673
+ npx dcyfr-ai --version
674
+
702
675
  # Help
703
676
  npx dcyfr-ai help
704
677
  ```
@@ -937,12 +910,6 @@ A: Yes! @dcyfr/ai is used in production at dcyfr-labs and other projects. It has
937
910
  - **Batch telemetry writes** (reduce I/O overhead): Buffer writes, flush periodically
938
911
  - **Lazy load plugins** (faster startup): Only load plugins you need for current validation
939
912
 
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
913
  [⬆️ Back to top](#dcyfr-ai)
947
914
 
948
915
  ---
@@ -1016,11 +983,11 @@ See [GitHub Issues](https://github.com/dcyfr-labs/dcyfr-ai/issues) for tracked f
1016
983
  Development is supported through sponsorship — if @dcyfr/ai is useful to you or your business, consider sponsoring.
1017
984
 
1018
985
  **Join:** [GitHub Sponsors](https://github.com/sponsors/dcyfr)
1019
- **Contact:** licensing@dcyfr.ai
986
+ **Contact:** [hello@dcyfr.ai](mailto:hello@dcyfr.ai)
1020
987
 
1021
988
  ### Trademark
1022
989
 
1023
- "DCYFR" is a trademark of DCYFR Labs.
990
+ "DCYFR" is a trademark of Drew Gowan.
1024
991
 
1025
992
  ---
1026
993
 
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':