impact-compass 0.2.0 → 0.2.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.
Files changed (3) hide show
  1. package/README.md +23 -18
  2. package/package.json +33 -3
  3. package/assets/top-banner-readme.png +0 -0
package/README.md CHANGED
@@ -1,9 +1,5 @@
1
1
  # Impact Compass
2
2
 
3
- <p align="center">
4
- <img src="assets/top-banner-readme.png" alt="Impact Compass CLI hero banner" width="100%" />
5
- </p>
6
-
7
3
  *grab a compass before you sail soldier*
8
4
 
9
5
  A purely statistical, deterministic project idea validator and market research CLI.
@@ -26,25 +22,34 @@ Why? Because you didn't measure the noise. High demand means nothing if the mark
26
22
 
27
23
  Impact Compass takes your idea and compiles a query bundle (problems, solutions, target audiences, and competitors). It then pulls live data from seven pillars of public evidence and runs an advanced logarithmic scoring algorithm.
28
24
 
25
+ ```mermaid
26
+ flowchart TD
27
+ A["Idea brief JSON"] --> B["Query bundle compiler"]
28
+ B --> C["35 source adapters"]
29
+ C --> D["Public APIs: GitHub, Reddit, npm, Hacker News, Stack Exchange, Wikipedia, App Store"]
30
+ D --> E["Evidence normalizer"]
31
+ E --> F["Relevance filter: weak keyword match loses 60% signal"]
32
+ F --> G["Pillar scorers: demand, pain, momentum, activity, competition, channel fit, evidence quality"]
33
+ G --> H["Weighted score engine"]
34
+ H --> I["Red ocean saturation penalty"]
35
+ I --> J["Final score, confidence, interpretation, JSON report"]
36
+ ```
37
+
29
38
  It measures:
30
39
  - **Demand & Pain:** Are people actually complaining about this, or is the problem minor?
31
40
  - **Momentum & Activity:** Are developers and founders actively building in this space right now?
32
41
  - **Competition Fit:** If the tool finds 10,000 competitors, your score tanks. Red oceans get penalized heavily.
33
42
 
34
- ```math
35
- \text{Score} =
36
- \operatorname{clamp}_{0}^{100}
37
- \left(
38
- \frac{\sum_i w_i p_i}{\sum_i w_i}
39
- -
40
- \begin{cases}
41
- 0.5(30 - C), & D > 70 \land C < 30 \\
42
- 0, & \text{otherwise}
43
- \end{cases}
44
- \right)
45
- ```
43
+ The score is intentionally simple to read:
44
+
45
+ 1. Score each pillar from 0 to 100.
46
+ 2. Multiply every pillar by its weight.
47
+ 3. Add those weighted pillar scores together.
48
+ 4. Divide by the total weight.
49
+ 5. Clamp the result between 0 and 100.
50
+ 6. If demand is above 70 but competition fit is below 30, subtract an extra red-ocean penalty.
46
51
 
47
- Where `p_i` are the pillar scores, `w_i` are the pillar weights, `D` is demand, and `C` is competition fit. Translation: big demand is good, but big demand plus a crushed competition score means you are sailing into a red ocean with a paper boat.
52
+ Translation: big demand is good, but big demand plus a crushed competition score means you are sailing into a red ocean with a paper boat.
48
53
 
49
54
  The engine spits out a final score out of 100, along with a brutally honest interpretation of whether you should build it, pivot, or drop the idea entirely.
50
55
 
@@ -83,7 +88,7 @@ Give Impact Compass an idea brief and a locked query bundle. The CLI does the di
83
88
  }
84
89
  ```
85
90
 
86
- ## The Math Behind the Score
91
+ ## Scoring Logic
87
92
 
88
93
  We stripped out the generic averages. The engine uses logarithmic scaling, so a GitHub repo with 5,000 stars is weighted accurately against one with 5 stars. It applies relevance penalties. If a search result does not contain your target keywords, it loses 60% of its value instantly.
89
94
 
package/package.json CHANGED
@@ -1,15 +1,45 @@
1
1
  {
2
2
  "name": "impact-compass",
3
- "version": "0.2.0",
4
- "description": "Purely statistical, deterministic project idea validator and market research CLI.",
3
+ "version": "0.2.2",
4
+ "description": "Deterministic market research CLI for startup idea validation, demand scoring, and competitive analysis.",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
8
8
  "url": "git+https://github.com/adityachauhan0/impact-compass.git"
9
9
  },
10
+ "homepage": "https://github.com/adityachauhan0/impact-compass#readme",
11
+ "bugs": {
12
+ "url": "https://github.com/adityachauhan0/impact-compass/issues"
13
+ },
10
14
  "private": false,
15
+ "keywords": [
16
+ "market-research",
17
+ "idea-validation",
18
+ "startup-validation",
19
+ "product-validation",
20
+ "market-validation",
21
+ "competitive-analysis",
22
+ "product-market-fit",
23
+ "demand-validation",
24
+ "demand-analysis",
25
+ "market-analysis",
26
+ "startup",
27
+ "founder-tools",
28
+ "indie-hacker",
29
+ "mvp",
30
+ "cli",
31
+ "analytics",
32
+ "developer-tools",
33
+ "scoring",
34
+ "deterministic",
35
+ "no-ai",
36
+ "github",
37
+ "npm",
38
+ "reddit",
39
+ "hacker-news",
40
+ "stackexchange"
41
+ ],
11
42
  "files": [
12
- "assets/",
13
43
  "src/",
14
44
  "DOCUMENTATION.md",
15
45
  "SKILLS.md",
package/assets/top-banner-readme.png DELETED
Binary file