@aiready/consistency 0.6.4 → 0.6.6

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.
@@ -1,6 +1,6 @@
1
1
 
2
2
  
3
- > @aiready/consistency@0.6.4 build /Users/pengcao/projects/aiready/packages/consistency
3
+ > @aiready/consistency@0.6.6 build /Users/pengcao/projects/aiready/packages/consistency
4
4
  > tsup src/index.ts src/cli.ts --format cjs,esm --dts
5
5
 
6
6
  CLI Building entry: src/cli.ts, src/index.ts
@@ -10,15 +10,15 @@
10
10
  CJS Build start
11
11
  ESM Build start
12
12
  ESM dist/cli.mjs 8.55 KB
13
- ESM dist/index.mjs 14.04 KB
14
- ESM dist/chunk-ON73WHHU.mjs 34.85 KB
15
- ESM ⚡️ Build success in 16ms
16
- CJS dist/cli.js 45.11 KB
17
- CJS dist/index.js 50.15 KB
18
- CJS ⚡️ Build success in 16ms
13
+ ESM dist/chunk-WTBDNCEN.mjs 36.20 KB
14
+ ESM dist/index.mjs 9.73 KB
15
+ ESM ⚡️ Build success in 17ms
16
+ CJS dist/cli.js 45.90 KB
17
+ CJS dist/index.js 46.99 KB
18
+ CJS ⚡️ Build success in 17ms
19
19
  DTS Build start
20
- DTS ⚡️ Build success in 999ms
20
+ DTS ⚡️ Build success in 977ms
21
21
  DTS dist/cli.d.ts 20.00 B
22
- DTS dist/index.d.ts 2.73 KB
22
+ DTS dist/index.d.ts 2.77 KB
23
23
  DTS dist/cli.d.mts 20.00 B
24
- DTS dist/index.d.mts 2.73 KB
24
+ DTS dist/index.d.mts 2.77 KB
@@ -1,6 +1,6 @@
1
1
 
2
2
  
3
- > @aiready/consistency@0.6.4 test /Users/pengcao/projects/aiready/packages/consistency
3
+ > @aiready/consistency@0.6.6 test /Users/pengcao/projects/aiready/packages/consistency
4
4
  > vitest run
5
5
 
6
6
 
@@ -25,7 +25,7 @@
25
25
  · should generate relevant recommendations
26
26
  · should suggest standardizing error handling
27
27
  · should suggest using async/await consistently
28
- [?25l[?25l[?25l[?25l[?25l[?25l[?25l[?25l ✓ should detect single letter variables
28
+ [?25l[?25l[?25l[?25l[?25l[?25l[?25l ✓ should detect single letter variables
29
29
  ✓ should NOT flag acceptable abbreviations
30
30
  ✓ should NOT flag common short English words
31
31
  ✓ should detect snake_case in TypeScript files
@@ -71,7 +71,7 @@
71
71
 
72
72
   Test Files  1 passed (1)
73
73
   Tests  18 passed (18)
74
-  Start at  17:32:18
75
-  Duration  741ms (transform 120ms, setup 0ms, collect 301ms, tests 146ms, environment 0ms, prepare 83ms)
74
+  Start at  01:47:48
75
+  Duration  566ms (transform 56ms, setup 0ms, collect 203ms, tests 128ms, environment 0ms, prepare 44ms)
76
76
 
77
77
  [?25h[?25h
package/README.md CHANGED
@@ -6,20 +6,50 @@ Helps teams maintain consistent coding practices across their codebase, making i
6
6
 
7
7
  ## 🚀 Quick Start
8
8
 
9
- **Recommended: Use the unified CLI** (includes consistency checking + more tools):
9
+ **Zero config, works out of the box:**
10
10
 
11
11
  ```bash
12
- npm install -g @aiready/cli
13
- aiready consistency ./src
12
+ # Run without installation (recommended)
13
+ npx @aiready/consistency ./src
14
+
15
+ # Or use the unified CLI (includes all AIReady tools)
16
+ npx @aiready/cli scan ./src
17
+
18
+ # Or install globally for faster runs
19
+ npm install -g @aiready/consistency
20
+ aiready-consistency ./src
14
21
  ```
15
22
 
16
- **Or use this package directly:**
23
+ ### 🎯 Input & Output
17
24
 
25
+ **Input:** Path to your source code directory
18
26
  ```bash
19
- npm install -g @aiready/consistency
20
27
  aiready-consistency ./src
21
28
  ```
22
29
 
30
+ **Output:** Terminal report + optional JSON file (saved to `.aiready/` directory)
31
+ ```
32
+ 📊 Consistency Analysis
33
+ ━━━━━━━━━━━━━━━━━━━━━━━━
34
+ 📁 Files analyzed: 47
35
+ ⚠️ Issues found: 15 naming + 8 pattern issues
36
+
37
+ CRITICAL (2 files)
38
+ src/utils/helpers.ts:12 - poor-naming: x
39
+ src/api/users.ts:45 - convention-mix: user_name
40
+ ```
41
+
42
+ ### ✨ Smart Defaults (Zero Config)
43
+
44
+ - ✅ **Auto-excludes** test files (`**/*.test.*`, `**/*.spec.*`, `**/__tests__/**`)
45
+ - ✅ **Auto-excludes** build outputs (`dist/`, `build/`, `.next/`)
46
+ - ✅ **Auto-excludes** dependencies (`node_modules/`)
47
+ - ✅ **Context-aware**: Skips common iterators (i, j, k) in loops
48
+ - ✅ **100+ built-in** acceptable abbreviations (env, api, url, ctx, etc.)
49
+ - ✅ **Smart detection**: Recognizes arrow functions, factory patterns, callbacks
50
+
51
+ > Override defaults with `--include-tests` or `--exclude <patterns>` as needed
52
+
23
53
  ## 🎯 What It Does
24
54
 
25
55
  Inconsistent code patterns confuse AI models and reduce their effectiveness. This tool analyzes: