@omfalos/mokosh 0.3.0 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omfalos/mokosh",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "A high-performance, AST-powered dependency graph generator for frontend projects, optimized for AI context and smart test selection.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -72,17 +72,17 @@
     "@types/coffeescript": "^2.5.7",
     "@types/js-yaml": "^4.0.9",
     "@types/luaparse": "^0.2.13",
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.2.0",
     "@types/postcss-less": "^4.0.7",
     "@vitest/coverage-v8": "^4.1.4",
-    "conventional-changelog": "^8.0.1",
-    "conventional-changelog-conventionalcommits": "^10.2.1",
-    "esbuild": "^0.28.1",
+    "conventional-changelog": "^8.1.2",
+    "conventional-changelog-conventionalcommits": "^10.3.0",
+    "esbuild": "^0.28.2",
     "husky": "^9.1.7",
     "lint-staged": "^17.0.8",
     "ts-node": "^10.9.2",
     "tsup": "^8.5.1",
-    "tsx": "^4.21.0",
+    "tsx": "^4.23.12",
     "vitest": "^4.1.4"
   },
   "dependencies": {
@@ -96,7 +96,7 @@
     "livescript": "^1.6.0",
     "luaparse": "^0.3.1",
     "piscina": "^5.2.0",
-    "postcss": "^8.5.12",
+    "postcss": "^8.5.26",
     "postcss-less": "^6.0.0",
     "postcss-scss": "^4.0.9",
     "remark-parse": "^11.0.0",

package/templates/skill/SKILL.md

@@ -16,7 +16,7 @@ Prefer MCP over the CLI whenever both are available — it's cheaper in tokens a
 
 ## MCP: tool call order
 
-`analyze` must be called once per session before any other tool (except `find_unused` and `query` with explicit `entryPoints`, which can build their own graph). It builds and caches the graph, keyed by `root`.
+`analyze` must be called once per session before any other tool (except `find_unused` and `query`, which reuse the cached graph when `entryPoints` is omitted, or can build their own graph when it's supplied). It builds and caches the graph, keyed by `root`.
 
 ```
 analyze({ root: "<abs-path>", entryPoints: ["src/index.ts"] })
@@ -44,8 +44,9 @@ If source files are edited mid-session, call `clear_cache({ root })` before re-q
 | Who **calls into** X at runtime? | `get_callers({ root, file, depth: 1, withEdgeDetail: true })` | `mokosh --callers <file>` |
 | Callers/callees of a named function | `get_call_graph({ root, function: "name" })` | TS/JS only |
 | Which file exports symbol X? | `find_symbol({ root, name: "X" })` | `mokosh <entry> --find-symbol --function X` |
-| Unused files | `find_unused({ root, entryPoints: [...] })` | `mokosh --find-unused <entry>` |
+| Unused files | `find_unused({ root })` (reuses cache) or `find_unused({ root, entryPoints: [...] })` | `mokosh --find-unused <entry>` |
 | Circular dependencies | — | `mokosh <entry> --check-cycles` |
+| What tags exist? | `list_tags({ root })` | `mokosh <entry> --list-tags` |
 
 ### Quality signals
 
@@ -110,7 +111,7 @@ Use with `query({ root, filter: "..." })` via MCP or `--query "..."` via CLI. Al
 
 `category` values: `logic` · `ui` · `test` · `config` · `barrel` · `type-only` · `other`.
 
-`query` (MCP) defaults to `slim: true` — compact nodes with flat `importsFiles`, export names, and meaningful tags only. Pass `slim: false` only when full edge metadata is needed.
+`query` (MCP) defaults to `slim: true` — compact nodes with flat `importsFiles`, export names, and meaningful tags only. Tags are filtered to kinds `comment-marker` and `import`; `function`/`class`/`variable`/`type`/`library` tags are dropped in slim output. Call `list_tags` for the full tag inventory, or pass `slim: false` when full edge metadata is needed.
 
 Run `mokosh --query-help` (CLI) for the full reference at any time.
 

package/templates/skill/mokosh.md

@@ -11,7 +11,7 @@ Prefer MCP over the CLI whenever both are available — it's cheaper in tokens a
 
 ## MCP: tool call order
 
-`analyze` must be called once per session before any other tool (except `find_unused` and `query` with explicit `entryPoints`, which can build their own graph). It builds and caches the graph, keyed by `root`.
+`analyze` must be called once per session before any other tool (except `find_unused` and `query`, which reuse the cached graph when `entryPoints` is omitted, or can build their own graph when it's supplied). It builds and caches the graph, keyed by `root`.
 
 ```
 analyze({ root: "<abs-path>", entryPoints: ["src/index.ts"] })
@@ -38,8 +38,9 @@ If source files are edited mid-session, call `clear_cache({ root })` before re-q
 | Tests affected by X | `get_affected({ root, file, testsOnly: true })` | `mokosh --affected-tests <file>` |
 | Who **calls into** X at runtime? | `get_callers({ root, file, depth: 1, withEdgeDetail: true })` | `mokosh --callers <file>` |
 | Callers/callees of a named function | `get_call_graph({ root, function: "name" })` | TS/JS only |
-| Unused files | `find_unused({ root, entryPoints: [...] })` | `mokosh --find-unused <entry>` |
+| Unused files | `find_unused({ root })` (reuses cache) or `find_unused({ root, entryPoints: [...] })` | `mokosh --find-unused <entry>` |
 | Circular dependencies | — | `mokosh <entry> --check-cycles` |
+| What tags exist? | `list_tags({ root })` | `mokosh <entry> --list-tags` |
 
 ### Quality signals
 
@@ -104,7 +105,7 @@ Use with `query({ root, filter: "..." })` via MCP or `--query "..."` via CLI. Al
 
 `category` values: `logic` · `ui` · `test` · `config` · `barrel` · `type-only` · `other`.
 
-`query` (MCP) defaults to `slim: true` — compact nodes with flat `importsFiles`, export names, and meaningful tags only. Pass `slim: false` only when full edge metadata is needed.
+`query` (MCP) defaults to `slim: true` — compact nodes with flat `importsFiles`, export names, and meaningful tags only. Tags are filtered to kinds `comment-marker` and `import`; `function`/`class`/`variable`/`type`/`library` tags are dropped in slim output. Call `list_tags` for the full tag inventory, or pass `slim: false` when full edge metadata is needed.
 
 Run `mokosh --query-help` (CLI) for the full reference at any time.