@omfalos/mokosh 0.1.0 → 0.1.3

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 (2) hide show
  1. package/README.md +29 -22
  2. package/package.json +8 -10
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Mokosh 🌊
2
2
 
3
- > **Not yet published to npm.** This package is under active development. Install directly from the repository for now.
3
+ > Available on npm as [`@omfalos/mokosh`](https://www.npmjs.com/package/@omfalos/mokosh).
4
4
 
5
5
  Mokosh is a lightweight, AST-powered dependency graph generator for modern web and script projects. It extracts import maps from JavaScript, TypeScript, Python, Go, CSS, SCSS, Less, Stylus, CoffeeScript, LiveScript, Lua, and Gherkin files to help AI models and developers understand code relationships efficiently.
6
6
 
@@ -49,7 +49,7 @@ When working with large codebases, providing the entire dependency graph to an A
49
49
 
50
50
  Example of a focused query:
51
51
  ```bash
52
- npx mokosh --query "type:typescript,category:logic" src/index.ts
52
+ npx @omfalos/mokosh --query "type:typescript,category:logic" src/index.ts
53
53
  ```
54
54
 
55
55
  ## Supported Languages & Tags
@@ -71,19 +71,26 @@ Mokosh automatically detects file types and uses the appropriate parser. You can
71
71
 
72
72
  ## Installation
73
73
 
74
- > **This package is not yet published to npm.** To use it, clone the repository and build locally:
75
- >
76
- > ```bash
77
- > git clone https://github.com/Omfalos/mokosh.git
78
- > cd mokosh
79
- > npm install
80
- > npm run build
81
- > ```
82
- >
83
- > Once published, installation will be:
84
- > ```bash
85
- > npm install mokosh
86
- > ```
74
+ Install from npm:
75
+
76
+ ```bash
77
+ npm install @omfalos/mokosh
78
+ ```
79
+
80
+ Or run it without installing via `npx`:
81
+
82
+ ```bash
83
+ npx @omfalos/mokosh src/index.ts
84
+ ```
85
+
86
+ To work on Mokosh itself, clone and build locally:
87
+
88
+ ```bash
89
+ git clone https://github.com/Omfalos/mokosh.git
90
+ cd mokosh
91
+ npm install
92
+ npm run build
93
+ ```
87
94
 
88
95
  ## Quick Start
89
96
 
@@ -91,39 +98,39 @@ Mokosh automatically detects file types and uses the appropriate parser. You can
91
98
 
92
99
  Generate a dependency graph as JSON:
93
100
  ```bash
94
- npx mokosh src/index.ts
101
+ npx @omfalos/mokosh src/index.ts
95
102
  ```
96
103
 
97
104
  Generate a Mermaid diagram:
98
105
  ```bash
99
- npx mokosh --mermaid src/index.ts > graph.mmd
106
+ npx @omfalos/mokosh --mermaid src/index.ts > graph.mmd
100
107
  ```
101
108
 
102
109
  Propose test tags for changed files:
103
110
  ```bash
104
- npx mokosh --propose-tags src/index.ts
111
+ npx @omfalos/mokosh --propose-tags src/index.ts
105
112
  ```
106
113
 
107
114
  Detect feature hub files (high out-degree orchestrators):
108
115
  ```bash
109
- npx mokosh --detect-features src/index.ts
116
+ npx @omfalos/mokosh --detect-features src/index.ts
110
117
  ```
111
118
 
112
119
  Find unused files:
113
120
  ```bash
114
- npx mokosh --find-unused src/index.ts
121
+ npx @omfalos/mokosh --find-unused src/index.ts
115
122
  ```
116
123
 
117
124
  Use caching to speed up subsequent runs:
118
125
  ```bash
119
- npx mokosh --cache mokosh-cache/graph.json src/index.ts
126
+ npx @omfalos/mokosh --cache mokosh-cache/graph.json src/index.ts
120
127
  ```
121
128
 
122
129
  > **Note:** Add `mokosh-cache/` to your `.gitignore` to avoid committing the cache directory.
123
130
 
124
131
  Filter graph by category and tag:
125
132
  ```bash
126
- npx mokosh --query "category:logic,tag:auth" src/index.ts
133
+ npx @omfalos/mokosh --query "category:logic,tag:auth" src/index.ts
127
134
  ```
128
135
 
129
136
  ### Options
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@omfalos/mokosh",
3
- "version": "0.1.0",
3
+ "version": "0.1.3",
4
4
  "description": "A high-performance, AST-powered dependency graph generator for frontend projects, optimized for AI context and smart test selection.",
5
5
  "main": "./dist/index.js",
6
6
  "module": "./dist/index.mjs",
@@ -21,8 +21,8 @@
21
21
  },
22
22
  "homepage": "https://github.com/Omfalos/mokosh#readme",
23
23
  "bin": {
24
- "mokosh": "./dist/cli.js",
25
- "mokosh-mcp": "./dist/mcp.js"
24
+ "mokosh": "dist/cli.js",
25
+ "mokosh-mcp": "dist/mcp.js"
26
26
  },
27
27
  "files": [
28
28
  "dist"
@@ -70,34 +70,32 @@
70
70
  "@commitlint/config-conventional": "^21.2.0",
71
71
  "@types/coffeescript": "^2.5.7",
72
72
  "@types/js-yaml": "^4.0.9",
73
+ "@types/luaparse": "^0.2.13",
73
74
  "@types/node": "^25.6.0",
74
75
  "@vitest/coverage-v8": "^4.1.4",
75
- "coffeescript": "^2.7.0",
76
76
  "conventional-changelog": "^8.0.1",
77
77
  "conventional-changelog-conventionalcommits": "^10.2.1",
78
78
  "husky": "^9.1.7",
79
79
  "lint-staged": "^16.4.0",
80
- "livescript": "^1.6.0",
81
80
  "ts-node": "^10.9.2",
82
81
  "tsup": "^8.5.1",
83
82
  "tsx": "^4.21.0",
84
- "typescript": "^6.0.2",
85
83
  "vitest": "^4.1.4"
86
84
  },
87
85
  "dependencies": {
88
86
  "@cucumber/gherkin": "^39.0.0",
89
- "@cucumber/gherkin-streams": "^6.0.0",
90
- "@cucumber/gherkin-utils": "^11.0.0",
91
87
  "@cucumber/messages": "^32.2.0",
92
88
  "@lezer/go": "^1.0.1",
93
89
  "@lezer/python": "^1.1.18",
94
90
  "@modelcontextprotocol/sdk": "^1.29.0",
95
- "@types/luaparse": "^0.2.13",
91
+ "coffeescript": "^2.7.0",
96
92
  "js-yaml": "^4.1.1",
93
+ "livescript": "^1.6.0",
97
94
  "luaparse": "^0.3.1",
98
95
  "postcss": "^8.5.12",
99
96
  "postcss-less": "^6.0.0",
100
97
  "postcss-scss": "^4.0.9",
101
- "stylus": "^0.64.0"
98
+ "stylus": "^0.64.0",
99
+ "typescript": "^6.0.2"
102
100
  }
103
101
  }