wjttc 1.0.0 → 1.0.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/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # WJTTC MCP Certification
1
+ # WJTTC/🍊
2
2
 
3
3
  **The FAF Foundation Testing Standard for MCP Servers**
4
4
 
@@ -7,22 +7,25 @@
7
7
 
8
8
  > *"When brakes must work flawlessly, so must our MCP servers"*
9
9
 
10
- > *"TEST the TESTING"* — wolfejam
11
-
12
10
  ---
13
11
 
14
- ## What is WJTTC?
12
+ ## What is Big Orange?
13
+
14
+ The 🍊 **Big Orange** is a super-score - recognition that an MCP server is above and beyond the standard.
15
+
16
+ - **100%** = Pass all 46 tests across ALL 7 tiers
17
+ - **+5%** = Awarded for documentation and professional polish
15
18
 
16
- WJTTC is a comprehensive 7-tier certification system for [Model Context Protocol](https://modelcontextprotocol.io) (MCP) servers. It validates implementations against the official specification with F1-inspired engineering rigor.
19
+ The 🍊, much like a Michelin Star for a restaurant, is awarded for excellence and well-deserved for Best-of-Class MCP servers.
17
20
 
18
- **46 tests across 7 tiers:** Protocol Compliance, Capability Negotiation, Tool Integrity, Resource Management, Security Validation, Performance Benchmarks, and Integration Readiness.
21
+ **Did you know?** Most MCP servers on the registry score Silver or below. Only 3 servers have achieved 🍊 Big Orange certification.
22
+
23
+ *Full leaderboard coming soon.*
19
24
 
20
25
  ---
21
26
 
22
27
  ## Certification Tiers
23
28
 
24
- **FAF-Aligned Scoring - The Michelin Star for Repos**
25
-
26
29
  | Tier | Score | Badge | Meaning |
27
30
  |------|-------|-------|---------|
28
31
  | Big Orange | 105% | 🍊 | *The Michelin Star - Perfection + Excellence* |
@@ -33,7 +36,6 @@ WJTTC is a comprehensive 7-tier certification system for [Model Context Protocol
33
36
  | Green | 70%+ | 🟢 | Good - Solid foundation |
34
37
  | Yellow | 55%+ | 🟡 | Caution - Needs improvement |
35
38
  | Red | <55% | 🔴 | Critical - Major work needed |
36
- | White | 0% | 🤍 | Empty - No context |
37
39
 
38
40
  ---
39
41
 
@@ -51,28 +53,29 @@ npx wjttc certify --mcp "npx your-mcp-server"
51
53
 
52
54
  ---
53
55
 
54
- ## Current Standings
56
+ ## Current 🍊 Big Orange Holders
55
57
 
56
- | Server | Score | Tier |
57
- |--------|-------|------|
58
- | claude-faf-mcp | 105% | 🍊 Big Orange |
59
- | @upstash/context7-mcp | 95% | 🥈 Silver |
60
- | @modelcontextprotocol/server-memory | 91% | 🥉 Bronze |
61
- | @modelcontextprotocol/server-filesystem | 86% | 🥉 Bronze |
62
-
63
- See [WJTTC-CERTIFIED.md](./WJTTC-CERTIFIED.md) for full certification records.
58
+ | Server | Score | Status |
59
+ |--------|-------|--------|
60
+ | claude-faf-mcp 🍊 | 105% | Certified |
61
+ | faf-mcp 🍊 | 105% | Certified |
62
+ | grok-faf-mcp 🍊 | 105% | Certified |
64
63
 
65
64
  ---
66
65
 
67
- ## Documentation
66
+ ## Test System
68
67
 
69
- **[SPECIFICATION.md](./SPECIFICATION.md)** Complete specification including:
68
+ **46 tests across 7 tiers:**
70
69
 
71
- - All 46 tests documented
72
- - CLI reference
73
- - GitHub Action usage
74
- - Scoring algorithm
75
- - FAQ
70
+ | Tier | Name | Weight | Tests |
71
+ |------|------|--------|-------|
72
+ | 1 | Protocol Compliance | 20% | 12 |
73
+ | 2 | Capability Negotiation | 10% | 8 |
74
+ | 3 | Tool Integrity | 20% | 6 |
75
+ | 4 | Resource Management | 10% | 6 |
76
+ | 5 | Security Validation | 15% | 3 |
77
+ | 6 | Performance Benchmarks | 15% | 6 |
78
+ | 7 | Integration Readiness | 10% | 5 |
76
79
 
77
80
  ---
78
81
 
@@ -96,11 +99,6 @@ See [WJTTC-CERTIFIED.md](./WJTTC-CERTIFIED.md) for full certification records.
96
99
 
97
100
  ---
98
101
 
99
- ## License
100
-
101
- MIT
102
-
103
- ---
104
-
105
- *WJTTC - WolfeJam Technical & Testing Center*
102
+ *WJTTC/🍊 - WolfeJam Technical & Testing Center*
106
103
  *FAF Foundation Testing Standard*
104
+ *F1-Inspired Software Engineering*
package/dist/cli.js CHANGED
File without changes
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "wjttc",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
+ "mcpName": "io.github.Wolfe-Jam/wjttc",
4
5
  "description": "FAF Foundation Testing Standard - Zero-error, multi-tier, most stringent MCP test suite. How IANA-registered formats, MCPs, and CLIs get certified. Big Orange (105%) = Excellence.",
5
6
  "main": "dist/index.js",
6
7
  "bin": {
package/project.faf CHANGED
@@ -1,123 +1,228 @@
1
1
  faf_version: 2.5.0
2
2
  ai_scoring_system: 2025-09-20
3
- ai_score: 89%
4
- ai_confidence: HIGH
3
+ ai_score: 98%
4
+ ai_confidence: VERY_HIGH
5
5
  ai_value: 30_seconds_replaces_20_minutes_of_questions
6
6
  ai_tldr:
7
- project: WJTTC MCP Certification - "FAF Foundation Testing Standard -
8
- Zero-error, multi-tier, most stringent MCP test suite. How IANA-registered
9
- formats, MCPs, and CLIs get certified. Big Orange (105%) = Excellence."
10
- stack: CLI/TypeScript/TypeScript (tsc)/npm registry/Node.js
11
- quality_bar: ZERO_ERRORS_F1_STANDARDS
12
- current_focus: Production deployment preparation
13
- your_role: Build features with perfect context
7
+ project: WJTTC (WolfeJam Technical & Testing Center) - F1-Inspired MCP Certification
8
+ stack: TypeScript/Node.js/CLI/MCP Protocol/npm registry
9
+ quality_bar: CHAMPIONSHIP_GRADE_ZERO_ERRORS
10
+ current_focus: MCP Server Certification & Testing
11
+ your_role: Certify MCP servers with F1-grade precision
12
+
14
13
  instant_context:
15
- what_building: FAF Foundation Testing Standard - Zero-error, multi-tier, most
16
- stringent MCP test suite. How IANA-registered formats, MCPs, and CLIs get
17
- certified. Big Orange (105%) = Excellence.
18
- tech_stack: CLI/TypeScript/TypeScript (tsc)/npm registry/Node.js
14
+ what_building: F1-Inspired MCP Server Certification System with 46 tests across 7 tiers
15
+ tech_stack: TypeScript/Node.js/MCP SDK/Commander CLI
19
16
  main_language: TypeScript
20
- deployment: npm registry
17
+ deployment: npm registry (wjttc)
18
+ philosophy: "When brakes must work flawlessly, so must our MCP servers"
21
19
  key_files:
22
- - package.json
23
- - tsconfig.json
20
+ - src/certifier.ts - Core 46-test certification engine
21
+ - src/cli.ts - CLI interface (check, certify, badge)
22
+ - src/types.ts - Type definitions
23
+ - SPECIFICATION.md - Full test documentation
24
+ - WJTTC-CERTIFIED.md - Official certification records
25
+
24
26
  context_quality:
25
- slots_filled: 17/21 (81%)
26
- ai_confidence: HIGH
27
+ slots_filled: 21/21 (100%)
28
+ ai_confidence: VERY_HIGH
27
29
  handoff_ready: true
28
- missing_context:
29
- - Database
30
+ missing_context: []
31
+
30
32
  project:
31
- name: WJTTC MCP Certification
32
- goal: FAF Foundation Testing Standard - Zero-error, multi-tier, most stringent
33
- MCP test suite. How IANA-registered formats, MCPs, and CLIs get certified.
34
- Big Orange (105%) = Excellence.
33
+ name: WJTTC (WolfeJam Technical & Testing Center)
34
+ tagline: "When brakes must work flawlessly, so must our MCP servers"
35
+ goal: F1-Inspired Technical Testing for MCP Servers - The Michelin Star for Repos
35
36
  main_language: TypeScript
36
37
  type: cli-ts
37
- generated: 2025-12-02T03:48:38.104Z
38
- mission: 🚀 Make Your AI Happy! 🧡 Trust-Driven 🤖
39
- revolution: 30 seconds replaces 20 minutes of questions
40
- brand: F1-Inspired Software Engineering - Championship AI Context
38
+ generated: 2025-12-02T04:43:58.695Z
39
+ mission: TEST the TESTING - Championship-grade MCP certification
40
+ revolution: Most stringent MCP test suite in existence
41
+ brand: F1-Inspired Software Engineering
42
+
43
+ certification_system:
44
+ total_tests: 46
45
+ tiers:
46
+ - tier: 1
47
+ name: Protocol Compliance
48
+ weight: 20%
49
+ tests: 12
50
+ - tier: 2
51
+ name: Capability Negotiation
52
+ weight: 10%
53
+ tests: 8
54
+ - tier: 3
55
+ name: Tool Integrity
56
+ weight: 20%
57
+ tests: 6
58
+ - tier: 4
59
+ name: Resource Management
60
+ weight: 10%
61
+ tests: 6
62
+ - tier: 5
63
+ name: Security Validation
64
+ weight: 15%
65
+ tests: 3
66
+ - tier: 6
67
+ name: Performance Benchmarks
68
+ weight: 15%
69
+ tests: 6
70
+ - tier: 7
71
+ name: Integration Readiness
72
+ weight: 10%
73
+ tests: 5
74
+
75
+ scoring_tiers:
76
+ big_orange:
77
+ score: 105%
78
+ emoji: "🍊"
79
+ meaning: "The Michelin Star - Perfection + Excellence"
80
+ holders: 1
81
+ trophy:
82
+ score: 100%
83
+ emoji: "🏆"
84
+ meaning: "Perfect MCP compliance"
85
+ gold:
86
+ score: 99%+
87
+ emoji: "🥇"
88
+ meaning: "Exceptional"
89
+ silver:
90
+ score: 95%+
91
+ emoji: "🥈"
92
+ meaning: "Top tier - Excellent"
93
+ bronze:
94
+ score: 85%+
95
+ emoji: "🥉"
96
+ meaning: "Strong - Production ready"
97
+ green:
98
+ score: 70%+
99
+ emoji: "🟢"
100
+ meaning: "Good - Solid foundation"
101
+ yellow:
102
+ score: 55%+
103
+ emoji: "🟡"
104
+ meaning: "Caution - Needs improvement"
105
+ red:
106
+ score: "<55%"
107
+ emoji: "🔴"
108
+ meaning: "Critical - Major work needed"
109
+
110
+ current_certifications:
111
+ - server: claude-faf-mcp
112
+ score: 105%
113
+ tier: "🍊 Big Orange"
114
+ - server: "@upstash/context7-mcp"
115
+ score: 95%
116
+ tier: "🥈 Silver"
117
+ - server: "@modelcontextprotocol/server-memory"
118
+ score: 91%
119
+ tier: "🥉 Bronze"
120
+ - server: "@modelcontextprotocol/server-filesystem"
121
+ score: 86%
122
+ tier: "🥉 Bronze"
123
+
124
+ business_model:
125
+ free: "Test your MCP server (score + tier)"
126
+ paid: "Know WHY you failed and HOW to fix it"
127
+ hook: "Most servers fail. Even Anthropic's."
128
+
41
129
  ai_instructions:
42
130
  priority_order:
43
- - 1. Read THIS .faf file first
44
- - 2. Check CLAUDE.md for session context
45
- - 3. Review package.json for dependencies
131
+ - 1. Read THIS .faf file first for complete context
132
+ - 2. Check CLAUDE.md for session-specific updates
133
+ - 3. Review SPECIFICATION.md for test details
134
+ - 4. Check WJTTC-CERTIFIED.md for certification records
46
135
  working_style:
47
136
  code_first: true
48
137
  explanations: minimal
49
- quality_bar: zero_errors
50
- testing: required
138
+ quality_bar: championship_zero_errors
139
+ testing: f1_grade_required
51
140
  warnings:
52
- - Never modify dial components without approval
53
- - All TypeScript must pass strict mode
54
- - Test coverage required for new features
141
+ - All tests must pass before certification
142
+ - Big Orange (105%) requires excellence beyond perfection
143
+ - Never certify without running full 46-test suite
144
+
55
145
  stack:
56
- frontend: CLI
57
- css_framework: chalk (terminal colors)
58
- ui_library: None
59
- state_management: None
146
+ frontend: CLI (Commander.js)
60
147
  backend: Node.js
61
148
  runtime: Node.js >=18.0.0
62
- database: None
149
+ mcp_sdk: "@modelcontextprotocol/sdk"
63
150
  build: TypeScript (tsc)
64
151
  package_manager: npm
65
- api_type: CLI
152
+ testing: Jest
66
153
  hosting: npm registry
67
154
  cicd: GitHub Actions
155
+
156
+ cli_commands:
157
+ check:
158
+ usage: "npx wjttc check ./dist/index.js"
159
+ description: "Quick health check (Tiers 1-2)"
160
+ certify:
161
+ usage: "npx wjttc certify --mcp \"npx your-server\""
162
+ description: "Full 46-test certification"
163
+ badge:
164
+ usage: "npx wjttc badge --score 95 --tier silver"
165
+ description: "Generate certification badge"
166
+
68
167
  preferences:
69
- quality_bar: zero_errors
168
+ quality_bar: championship_grade
70
169
  commit_style: conventional_emoji
71
170
  response_style: concise_code_first
72
171
  explanation_level: minimal
73
172
  communication: direct
74
- testing: required
75
- documentation: as_needed
173
+ testing: f1_mandatory
174
+ documentation: specification_driven
175
+
76
176
  state:
77
- phase: development
177
+ phase: production
78
178
  version: 1.0.0
79
- focus: production_deployment
179
+ focus: mcp_registry_publication
80
180
  status: green_flag
81
- next_milestone: npm_publication
181
+ next_milestone: mcp_registry_listing
82
182
  blockers: null
183
+
83
184
  tags:
84
185
  auto_generated:
85
- - wjttc-mcp-certification
186
+ - wjttc
187
+ - mcp-certification
188
+ - mcp-testing
189
+ - f1-inspired
86
190
  - cli
87
191
  - typescript
88
- - typescript-(tsc)
89
- - npm-registry
90
- - node.js
91
192
  smart_defaults:
92
193
  - .faf
93
194
  - ai-ready
94
195
  - "2025"
95
- - software
196
+ - championship
96
197
  - open-source
97
- user_defined: null
198
+ user_defined:
199
+ - big-orange
200
+ - michelin-star
201
+ - zero-error
202
+
98
203
  human_context:
99
- who: Development teams
100
- what: FAF Foundation Testing Standard - Zero-error, multi-tier, most stringent
101
- MCP test suite. How IANA-registered formats, MCPs, and CLIs get certified.
102
- Big Orange (105%) = Excellence.
103
- why: Improve development efficiency
104
- where: Vercel platform
105
- when: Production/Stable
106
- how: Test-driven development
107
- additional_context: null
108
- context_score: 0
109
- total_prd_score: 89
110
- success_rate: 50%
204
+ who: MCP Server Developers
205
+ what: Certify MCP servers meet protocol standards with F1-grade precision
206
+ why: Ensure MCP servers work flawlessly in production
207
+ where: npm registry, MCP Registry
208
+ when: Production-ready
209
+ how: 46-test suite across 7 weighted tiers
210
+ additional_context: "TEST the TESTING philosophy"
211
+ context_score: 100
212
+ total_prd_score: 98
213
+ success_rate: 95%
214
+
111
215
  ai_scoring_details:
112
216
  system_date: 2025-09-20
113
- slot_based_percentage: 81
114
- ai_score: 89
217
+ slot_based_percentage: 100
218
+ ai_score: 98
115
219
  total_slots: 21
116
- filled_slots: 17
220
+ filled_slots: 21
117
221
  scoring_method: Honest percentage - no fake minimums
118
222
  trust_embedded: COUNT ONCE architecture - trust MY embedded scores
223
+
119
224
  faf_dna:
120
225
  birth_dna: 22
121
- birth_certificate: FAF-2025-WJTTC-YMB4
122
- birth_date: 2025-12-02T03:48:38.186Z
123
- current_score: 83
226
+ birth_certificate: FAF-2025-WJTTC-1NFY
227
+ birth_date: 2025-12-02T04:43:58.713Z
228
+ current_score: 98