bun-sticky 1.0.4 → 1.0.5

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,134 +1,21 @@
1
- # bun-sticky
1
+ # bun-sticky has moved
2
2
 
3
- Fastest bun under the sum. Zero dependencies. Pure Bun.
3
+ ## This package has been renamed to [bun-sticky-faf](https://npmjs.com/package/bun-sticky-faf)
4
4
 
5
- ```bash
6
- faf score
7
- ```
8
-
9
- ```
10
- ────────────────────────────────────────────────
11
-
12
- ▄▄ ▄▀▀▀ ▀█▀ █ ▄▀▀ █▄▀ █ █
13
- ████ ▀▀█▄ █ █ █ █▀▄ █
14
- ██████ ▄▄▄▀ █ █ ▀▀▀ █ █ █
15
- ████████
16
- ████████ █▀▄ █ █ █▀▄
17
- ██████ ██▀ █ █ █ █
18
- ████ █▄▀ ▀▄▀ █ █
19
- ▀▀
20
-
21
- 🥐 Bun Sticky v1.0.4 .faf CLI
22
- Fastest bun under the sum.
23
-
24
- ────────────────────────────────────────────────
25
-
26
- Project: my-app
27
- Type: cli
28
-
29
- Project ████████████ 3/3
30
- Human ████████░░░░ 4/6
31
-
32
- 🟢 78% Green
33
- Filled: 7/9 slots
34
- ```
5
+ The `-faf` suffix aligns with the [IANA-registered FAF format](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml).
35
6
 
36
- ## Install
7
+ ### Install the new package:
37
8
 
38
9
  ```bash
39
- npm install -g bun-sticky
10
+ npm install -g bun-sticky-faf
40
11
  ```
41
12
 
42
13
  Or run directly:
43
14
 
44
15
  ```bash
45
- bunx bun-sticky score
16
+ bunx bun-sticky-faf score
46
17
  ```
47
18
 
48
- ## Commands
49
-
50
- ```bash
51
- faf score # Show FAF score + tier
52
- faf init myapp # Create project.faf
53
- faf sync # Sync to CLAUDE.md
54
- faf help # Show commands
55
- ```
56
-
57
- ## What is FAF?
58
-
59
- **FAF** (Foundational AI-context Format) is project DNA for AI assistants. A `project.faf` file tells Claude, Cursor, Copilot, and other AI tools what your project is about.
60
-
61
- **bun-sticky** scores your project's AI-readiness using the Wolfejam slot-based system.
62
-
63
- ## Scoring
64
-
65
- 21 slots across 5 categories. Type-aware scoring:
66
-
67
- | Type | Slots | Categories |
68
- |------|-------|------------|
69
- | CLI | 9 | project + human |
70
- | Library | 9 | project + human |
71
- | API | 17 | project + backend + universal + human |
72
- | Webapp | 16 | project + frontend + universal + human |
73
- | Fullstack | 21 | all |
74
-
75
- **Score = Filled Slots / Applicable Slots × 100**
76
-
77
- ## Tiers
78
-
79
- | Score | Tier |
80
- |-------|------|
81
- | 100% | 🏆 Trophy |
82
- | 99%+ | 🥇 Gold |
83
- | 95%+ | 🥈 Silver |
84
- | 85%+ | 🥉 Bronze |
85
- | 70%+ | 🟢 Green |
86
- | 55%+ | 🟡 Yellow |
87
- | <55% | 🔴 Red |
88
-
89
- ## Speed
90
-
91
- Built for Bun's speed:
92
-
93
- - **Cold start**: <50ms
94
- - **Score command**: <100ms
95
- - **Zero dependencies**: Pure Bun APIs
96
- - **TypeScript native**: No build step
97
-
98
- ## Testing
99
-
100
- 328 tests. Championship-grade WJTTC test suite.
101
-
102
- ```bash
103
- bun test
104
- ```
105
-
106
- Full Bun test API coverage: `test.each`, `mock`, `spyOn`, `snapshots`, custom matchers.
107
-
108
- ## FAF Ecosystem
109
-
110
- | Package | Runtime | Downloads |
111
- |---------|---------|-----------|
112
- | [faf-cli](https://npmjs.com/package/faf-cli) | Node.js | 15,000+ |
113
- | **bun-sticky** | Bun | you are here |
114
- | xai-faf-zig | Zig | ultra-fast |
115
- | xai-faf-rust | Rust | WASM |
116
-
117
- ## Philosophy
118
-
119
- Built the Anthropic way:
120
-
121
- - First principles
122
- - Zero dependencies
123
- - Native Bun APIs
124
- - TypeScript native
125
-
126
- Wolfejam slot-based scoring. Not Elon weights.
127
-
128
- ## License
129
-
130
- MIT
131
-
132
19
  ---
133
20
 
134
- *Part of the FAF ecosystem. Made for Claude Code.*
21
+ **[bun-sticky-faf on npm](https://npmjs.com/package/bun-sticky-faf)** | **[GitHub](https://github.com/Wolfe-Jam/bun-sticky-faf)**
package/index.js ADDED
@@ -0,0 +1,8 @@
1
+ console.log('\n');
2
+ console.log(' bun-sticky has moved to bun-sticky-faf');
3
+ console.log(' ');
4
+ console.log(' Install: npm install -g bun-sticky-faf');
5
+ console.log(' Run: bunx bun-sticky-faf score');
6
+ console.log(' ');
7
+ console.log(' https://npmjs.com/package/bun-sticky-faf');
8
+ console.log('\n');
package/package.json CHANGED
@@ -1,35 +1,15 @@
1
1
  {
2
2
  "name": "bun-sticky",
3
- "version": "1.0.4",
4
- "description": "Fastest bun under the sum. FAF scoring CLI for Bun.",
5
- "main": "index.ts",
6
- "type": "module",
7
- "bin": {
8
- "faf": "./index.ts"
9
- },
10
- "scripts": {
11
- "start": "bun run index.ts",
12
- "score": "bun run index.ts score",
13
- "test": "bun test"
14
- },
15
- "keywords": [
16
- "faf",
17
- "bun",
18
- "cli",
19
- "scoring",
20
- "wolfejam",
21
- "ai-context"
22
- ],
3
+ "version": "1.0.5",
4
+ "description": "MOVED to bun-sticky-faf - see https://npmjs.com/package/bun-sticky-faf",
5
+ "main": "index.js",
6
+ "scripts": {},
7
+ "keywords": ["faf", "bun", "deprecated", "moved"],
23
8
  "author": "wolfejam",
24
9
  "license": "MIT",
25
10
  "repository": {
26
11
  "type": "git",
27
- "url": "https://github.com/Wolfe-Jam/bun-sticky.git"
28
- },
29
- "homepage": "https://github.com/Wolfe-Jam/bun-sticky",
30
- "engines": {
31
- "bun": ">=1.0.0"
12
+ "url": "https://github.com/Wolfe-Jam/bun-sticky-faf"
32
13
  },
33
- "dependencies": {},
34
- "devDependencies": {}
14
+ "homepage": "https://npmjs.com/package/bun-sticky-faf"
35
15
  }
@@ -1,12 +0,0 @@
1
- # Score Current Project
2
-
3
- Run bun-sticky on the current directory to check FAF score.
4
-
5
- ```bash
6
- bun run index.ts score
7
- ```
8
-
9
- Review the output:
10
- - Check which slots are missing
11
- - Suggest improvements to reach next tier
12
- - Target: 85%+ Bronze for production-ready
@@ -1,15 +0,0 @@
1
- # Run WJTTC Test Suite
2
-
3
- Run the championship-grade test suite and report results.
4
-
5
- ```bash
6
- bun test --summary all
7
- ```
8
-
9
- Expected: All tests pass (328+)
10
-
11
- If any tests fail:
12
- 1. Identify the failing test
13
- 2. Check the assertion message
14
- 3. Fix the code or test
15
- 4. Re-run until all green
@@ -1,5 +0,0 @@
1
- # GitHub Sponsors
2
- # Free for devs. Teams and enterprise contact us.
3
-
4
- github: wolfejam
5
- custom: ['mailto:team@faf.one']
@@ -1,26 +0,0 @@
1
- name: CI
2
-
3
- on:
4
- push:
5
- branches: [main]
6
- pull_request:
7
- branches: [main]
8
-
9
- jobs:
10
- test:
11
- runs-on: ubuntu-latest
12
- name: Bun Tests
13
-
14
- steps:
15
- - uses: actions/checkout@v4
16
-
17
- - name: Setup Bun
18
- uses: oven-sh/setup-bun@v2
19
- with:
20
- bun-version: latest
21
-
22
- - name: Install dependencies
23
- run: bun install
24
-
25
- - name: Run tests
26
- run: bun test
@@ -1,36 +0,0 @@
1
- name: Release
2
-
3
- on:
4
- push:
5
- tags:
6
- - 'v*'
7
-
8
- jobs:
9
- publish:
10
- runs-on: ubuntu-latest
11
- name: Publish to npm
12
-
13
- steps:
14
- - uses: actions/checkout@v4
15
-
16
- - name: Setup Bun
17
- uses: oven-sh/setup-bun@v2
18
- with:
19
- bun-version: latest
20
-
21
- - name: Install dependencies
22
- run: bun install
23
-
24
- - name: Run tests
25
- run: bun test
26
-
27
- - name: Setup Node for npm publish
28
- uses: actions/setup-node@v4
29
- with:
30
- node-version: '20'
31
- registry-url: 'https://registry.npmjs.org'
32
-
33
- - name: Publish
34
- run: npm publish
35
- env:
36
- NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
package/CLAUDE.md DELETED
@@ -1,98 +0,0 @@
1
- # bun-sticky
2
-
3
- Fastest bun under the sum. Bun-native .faf CLI with Wolfejam slot-based scoring.
4
-
5
- **🏆 100% Trophy** - 9/9 slots filled
6
-
7
- ## Quick Commands
8
-
9
- ```bash
10
- bun test # Run WJTTC test suite (328 tests)
11
- bun run index.ts score # Score current project
12
- bun run index.ts help # Show commands
13
- bun publish # Publish to npm (see PUBLISH-PROTOCOL.md)
14
- ```
15
-
16
- ## Architecture
17
-
18
- ```
19
- bun-sticky/
20
- ├── index.ts # CLI entry + ASCII banner
21
- ├── lib/
22
- │ ├── parser.ts # Zero-dep YAML parser
23
- │ ├── scorer.ts # Wolfejam 21-slot scoring
24
- │ └── tier.ts # 7-tier ranking system
25
- └── tests/
26
- ├── sticky.test.ts # Core unit tests
27
- └── wjttc.test.ts # Championship test suite
28
- ```
29
-
30
- ## Scoring System
31
-
32
- **Wolfejam Slot-Based Scoring** (NOT Elon weights):
33
-
34
- - 21 total slots across 5 categories
35
- - Type-aware: CLI=9, Fullstack=21, etc.
36
- - Formula: `Score = (Filled / Applicable) × 100`
37
-
38
- | Category | Slots | Fields |
39
- |----------|-------|--------|
40
- | Project | 3 | name, goal, main_language |
41
- | Frontend | 4 | frontend, css_framework, ui_library, state_management |
42
- | Backend | 5 | backend, api_type, runtime, database, connection |
43
- | Universal | 3 | hosting, build, cicd |
44
- | Human | 6 | who, what, why, where, when, how |
45
-
46
- ## Tier System
47
-
48
- | Score | Tier | Emoji |
49
- |-------|------|-------|
50
- | 100% | Trophy | 🏆 |
51
- | 99%+ | Gold | 🥇 |
52
- | 95%+ | Silver | 🥈 |
53
- | 85%+ | Bronze | 🥉 |
54
- | 70%+ | Green | 🟢 |
55
- | 55%+ | Yellow | 🟡 |
56
- | <55% | Red | 🔴 |
57
-
58
- ## Key Files
59
-
60
- | File | Purpose |
61
- |------|---------|
62
- | `lib/scorer.ts:16` | SLOTS definition (21 slots) |
63
- | `lib/scorer.ts:68` | TYPE_CATEGORIES mapping |
64
- | `lib/scorer.ts:173` | calculateScore() function |
65
- | `lib/tier.ts:22` | getTier() function |
66
- | `lib/parser.ts:1` | parseYaml() zero-dep parser |
67
-
68
- ## Testing
69
-
70
- Championship-grade WJTTC test suite with full Bun test API coverage:
71
-
72
- - `test.each` - Parametrized tests
73
- - `test.concurrent` - Parallel execution
74
- - `mock`, `spyOn` - Mocking
75
- - Lifecycle hooks - beforeAll, afterEach, etc.
76
- - Full matcher suite
77
-
78
- ```bash
79
- bun test --coverage # With coverage
80
- bun test --watch # Watch mode
81
- CLAUDECODE=1 bun test # AI-friendly output
82
- ```
83
-
84
- ## Development Rules
85
-
86
- 1. **Zero Dependencies** - Only Bun native APIs
87
- 2. **No npm repeats** - Follow PUBLISH-PROTOCOL.md exactly
88
- 3. **Tests first** - All changes need tests
89
- 4. **Wolfejam slots only** - Never use Elon weights
90
-
91
- ## Publishing
92
-
93
- **NEVER publish without explicit GO! approval.**
94
-
95
- See `PUBLISH-PROTOCOL.md` for the complete ceremony.
96
-
97
- ---
98
- *Part of FAF ecosystem. Built for Claude Code.*
package/LICENSE DELETED
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2024-2025 wolfejam
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
package/PRODUCT-SHEET.md DELETED
@@ -1,124 +0,0 @@
1
- # bun-sticky
2
-
3
- ## Fastest bun under the sum
4
-
5
- **Bun-native FAF scoring CLI with Wolfejam slot-based scoring**
6
-
7
- ---
8
-
9
- ## Features
10
-
11
- ### Zero Dependencies
12
- Pure Bun APIs only. No node_modules bloat. No supply chain risk.
13
-
14
- ### TypeScript Native
15
- No build step. No transpilation. Bun runs TypeScript directly.
16
-
17
- ### Wolfejam Slot-Based Scoring
18
- 21 slots across 5 categories. Type-aware scoring that knows CLI differs from fullstack.
19
-
20
- ### Instant Feedback
21
- Cold start <50ms. Score command <100ms. Fast enough you'll actually use it.
22
-
23
- ### Bi-Sync
24
- Keep project.faf and CLAUDE.md in sync. Non-destructive - preserves your content.
25
-
26
- ### Championship Testing
27
- 328 tests. WJTTC certified. Full Bun test API coverage.
28
-
29
- ---
30
-
31
- ## Commands
32
-
33
- ```bash
34
- faf score # Show FAF score + tier
35
- faf init myapp # Create project.faf
36
- faf sync # Sync to CLAUDE.md
37
- faf help # Show commands
38
- ```
39
-
40
- ---
41
-
42
- ## Tier System
43
-
44
- | Score | Tier | Status |
45
- |-------|------|--------|
46
- | 100% | Trophy | Perfect |
47
- | 99%+ | Gold | Exceptional |
48
- | 95%+ | Silver | Excellent |
49
- | 85%+ | Bronze | Production ready |
50
- | 70%+ | Green | Solid |
51
- | 55%+ | Yellow | Needs work |
52
- | <55% | Red | Critical |
53
-
54
- ---
55
-
56
- # Specifications
57
-
58
- ## Scoring Categories
59
-
60
- | Category | Slots | Fields |
61
- |----------|-------|--------|
62
- | Project | 3 | name, goal, main_language |
63
- | Frontend | 4 | frontend, css_framework, ui_library, state_management |
64
- | Backend | 5 | backend, api_type, runtime, database, connection |
65
- | Universal | 3 | hosting, build, cicd |
66
- | Human | 6 | who, what, why, where, when, how |
67
-
68
- ## Type-Aware Slot Counts
69
-
70
- | Project Type | Applicable Slots |
71
- |--------------|------------------|
72
- | CLI | 9 |
73
- | Library | 9 |
74
- | API | 17 |
75
- | Webapp | 16 |
76
- | Fullstack | 21 |
77
-
78
- ## Formula
79
-
80
- ```
81
- Score = (Filled Slots / Applicable Slots) × 100
82
- ```
83
-
84
- ## Performance
85
-
86
- | Metric | Target | Actual |
87
- |--------|--------|--------|
88
- | Cold start | <50ms | <50ms |
89
- | Score command | <100ms | <100ms |
90
- | Dependencies | 0 | 0 |
91
-
92
- ## Technical
93
-
94
- | Spec | Value |
95
- |------|-------|
96
- | Runtime | Bun >=1.0.0 |
97
- | Language | TypeScript (native) |
98
- | Tests | 328 |
99
- | License | MIT |
100
- | Package Size | 24.4 kB |
101
-
102
- ## Installation
103
-
104
- ```bash
105
- # npm
106
- npm install -g bun-sticky
107
-
108
- # bunx (run directly)
109
- bunx bun-sticky score
110
- ```
111
-
112
- ## Links
113
-
114
- | Resource | URL |
115
- |----------|-----|
116
- | npm | https://npmjs.com/package/bun-sticky |
117
- | GitHub | https://github.com/Wolfe-Jam/bun-sticky |
118
- | FAF Ecosystem | https://faf.one |
119
-
120
- ---
121
-
122
- *Part of the FAF ecosystem. Built for Bun. Made for Claude Code.*
123
-
124
- **v1.0.3** | MIT License | Zero Dependencies
@@ -1,64 +0,0 @@
1
- # Bun Sticky - Publish Protocol
2
-
3
- ## Pre-Publish Checklist
4
-
5
- ### 1. Code Quality
6
- - [x] All 328 tests passing (`bun test`)
7
- - [x] Zero TypeScript errors
8
- - [x] Zero runtime dependencies
9
- - [x] Pure Bun APIs only
10
-
11
- ### 2. Version Bump
12
- ```bash
13
- # Update version in:
14
- # - package.json
15
- # - index.ts (VERSION constant)
16
- ```
17
-
18
- ### 3. Test Suite
19
- ```bash
20
- bun test
21
- # Expect: 328 pass, 0 fail
22
- ```
23
-
24
- ### 4. Manual Verification
25
- ```bash
26
- bunx bun-sticky --version # ✓
27
- bunx bun-sticky help # ✓
28
- bunx bun-sticky init test # ✓
29
- bunx bun-sticky score # ✓
30
- ```
31
-
32
- ## Publish Commands
33
-
34
- ### npm Registry
35
- ```bash
36
- npm publish --access public
37
- ```
38
-
39
- ### Verify
40
- ```bash
41
- npm view bun-sticky
42
- bunx bun-sticky help
43
- ```
44
-
45
- ## Post-Publish
46
-
47
- 1. [x] Tag release in git
48
- 2. [ ] Update ZIG-n-RUST.md benchmarks
49
- 3. [ ] Announce in faf-cli ecosystem
50
-
51
- ## Version History
52
-
53
- | Version | Date | Notes |
54
- |---------|------|-------|
55
- | 1.0.0 | 2024-12-22 | Initial release - Wolfejam slot-based scoring, 177 tests |
56
- | 1.0.1 | 2024-12-22 | Proper publish ceremony, version consistency |
57
- | 1.0.2 | 2025-12-22 | Test fixes (rounding, TIERS export, Empty tier) |
58
- | 1.0.3 | 2025-12-22 | Fix sync command overwriting CLAUDE.md |
59
- | 1.0.4 | 2025-12-22 | Binary renamed to `faf` for ecosystem consistency |
60
-
61
- ---
62
-
63
- *Fastest bun under the sum.*
64
- *Zero dependencies. Pure Bun.*