@gkoreli/ghx 2.1.13 → 2.1.19

package/README.md

@@ -41,10 +41,10 @@ brew install gkoreli/tap/ghx
 npm install -g @gkoreli/ghx
 
 # Go
-go install github.com/gkoreli/ghx/v2@latest
+go install github.com/gkoreli/ghx/v2/cmd/ghx@latest
 
 # Build from source
-cd v2 && go build -o ghx .
+go build -o ghx ./cmd/ghx
 ```
 
 Requires: [gh CLI](https://cli.github.com/) authenticated (`gh auth login`).
@@ -72,7 +72,10 @@ ghx explore <owner/repo> <path>             # Subdirectory listing
 ghx read <owner/repo> <f1> [f2] [f3]       # Read 1-10 files (GraphQL batching)
 ghx read <owner/repo> <dir>                 # Directory path → returns file listing
 ghx read <owner/repo> "src/**/*.ts" --map   # Glob patterns with structural map
-ghx read <owner/repo> --map <f1> [f2]       # Signatures, imports, types (~92% token reduction)
+ghx read <owner/repo> --map <f1> [f2]       # Parser-backed structural map (~92% token reduction)
+ghx read <owner/repo> --map --kind func <f> # Map only functions/methods
+ghx read <owner/repo> --map --kind type <f> # Map only types/structs/interfaces
+ghx read <owner/repo> --map --level minimal <f> # Symbol names only (e.g. UserService.GetUser)
 ghx read <owner/repo> --grep "pat" <f>      # Matching lines only (ERE regex, 2 lines context)
 ghx read <owner/repo> --lines 42-80 <f>     # Specific line range
 ghx search "<query>"                        # Code search with matching lines
@@ -135,28 +138,24 @@ Designed for eager context injection via spawn hooks — the agent always has th
 
 Wraps `gh` CLI with GraphQL batching. `repos` and `explore` batch search + metadata + README into 1 call. `read` uses GraphQL aliases to fetch up to 10 files in 1 call — and if a path is a directory, returns its file listing instead of "not found" (via `... on Tree` inline fragments in the same query, zero extra API calls). Glob patterns (`src/**/*.ts`) auto-expand via tree fetch + [doublestar](https://github.com/bmatcuk/doublestar) matching in 2 API calls. `--grep` uses ERE regex with BRE normalization (agents trained on `grep` write `\|` for alternation — both styles work). `search` hits REST `/search/code` with `text_matches` for matching context and 200-char token protection.
 
+`--map` runs a dedicated parser engine on the fetched content — no extra API calls. Engine selection is automatic: **Go** uses `go/ast` (top-level declarations only, full multi-line signatures, generics preserved), **TypeScript, JavaScript, Python, Rust** use [gotreesitter](https://github.com/odvcencio/gotreesitter) (captures class/impl methods that regex cannot reach), everything else falls back to regex. Methods carry a parent reference (`UserService.GetUser`) visible at `--level minimal`. `--map-engine regex` forces the fallback for any file.
+
 Codemode runs JS in a [goja](https://github.com/nicholasgasior/goja) sandbox with esbuild TypeScript transpilation. Tools are injected as synchronous functions on a `codemode` global object. Max 20 tool calls per execution, 64KB code size limit.
 
 ## Architecture
 
 ```
-v2/
-├── pkg/ghx/       — core library (Explore, Read, Search, Repos, Tree, Glob)
-├── pkg/codemode/  — JS executor (goja sandbox, TS transpilation, type generation)
-└── cmd/           — CLI frontend (cobra) + MCP server (mcp-go)
+cmd/ghx/             — binary entrypoint
+internal/cli/        — CLI frontend (cobra) + MCP server commands
+internal/ghx/        — core library (Explore, Read, Search, Repos, Tree, Glob)
+internal/codemode/   — JS executor (goja sandbox, TS transpilation, type generation)
+internal/mapengine/  — parser-backed map engine (GoAST, TreeSitter, Regex, engine routing)
+internal/sidecar/    — sidecar runtime, sessions, reports, and ACP integration
+internal/skilldoc/   — embedded CLI and MCP agent skill markdown
 ```
 
 See [docs/adr/](docs/adr/) for architectural decisions.
 
-## v1 (bash)
-
-The original bash implementation is in [`v1/`](v1/). Zero dependencies beyond `gh` and `jq` — useful if you just want a shell script you can drop anywhere without compiling Go.
-
-```bash
-npm install -g @gkoreli/ghx    # npm
-cp v1/ghx /usr/local/bin/ghx   # manual
-```
-
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gkoreli/ghx",
-  "version": "2.1.13",
+  "version": "2.1.19",
   "description": "Agent-first GitHub code exploration. GraphQL batching, code maps, codemode TypeScript sandbox, MCP server.",
   "bin": {
     "ghx": "npm/bin/ghx"
@@ -18,6 +18,10 @@
     "type": "git",
     "url": "git+https://github.com/gkoreli/ghx.git"
   },
+  "packageManager": "pnpm@10.22.0",
+  "workspaces": [
+    "packages/*"
+  ],
   "files": [
     "npm/bin/ghx",
     "README.md",
@@ -27,11 +31,11 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@gkoreli/ghx-darwin-arm64": "2.1.13",
-    "@gkoreli/ghx-darwin-x64": "2.1.13",
-    "@gkoreli/ghx-linux-arm64": "2.1.13",
-    "@gkoreli/ghx-linux-x64": "2.1.13",
-    "@gkoreli/ghx-win32-arm64": "2.1.13",
-    "@gkoreli/ghx-win32-x64": "2.1.13"
+    "@gkoreli/ghx-darwin-arm64": "2.1.19",
+    "@gkoreli/ghx-darwin-x64": "2.1.19",
+    "@gkoreli/ghx-linux-arm64": "2.1.19",
+    "@gkoreli/ghx-linux-x64": "2.1.19",
+    "@gkoreli/ghx-win32-arm64": "2.1.19",
+    "@gkoreli/ghx-win32-x64": "2.1.19"
   }
 }