forgemap 0.5.0 → 0.6.0

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 (4) hide show
  1. package/README.md +8 -7
  2. package/dist/bin/forgemap.mjs +1161 -453
  3. package/dist/bin/forgemap.mjs.map +1 -1
  4. package/package.json +4 -3
package/README.md CHANGED
@@ -27,7 +27,7 @@ That's it. Every repo lands at a predictable `<root>/<forge.dir>/<owner>/<repo>`
27
27
 
28
28
  - **🗂️ Predictable layout** — every clone goes to `<root>/<forge.dir>/<owner>/<repo>`, configured once.
29
29
  - **🚪 Flexible slug syntax** — `owner/repo`, `forge:owner/repo`, full HTTPS URLs, or SSH (`git@…:…`).
30
- - **🔍 Fuzzy search** — `forgemap search <term>` finds local repos by owner or repo name (powered by [Fuse.js](https://www.fusejs.io/)); `cd`, `path` and `open` take the same fuzzy terms.
30
+ - **🔍 List & fuzzy search** — `forgemap list` shows every local repo, `forgemap list <term>` filters by owner or repo name (powered by [Fuse.js](https://www.fusejs.io/)); `cd`, `path` and `open` take the same fuzzy terms.
31
31
  - **🤖 Forge-aware** — `type: 'github'` shells out to `gh`; `type: 'git'` uses plain `git clone` with no extra dependencies.
32
32
  - **🔁 Mass sync + status** — `forgemap sync` fetches every clone in parallel, `forgemap status` shows branch / dirty / ahead / behind per repo — narrow either to given owners or forges with a repeatable `--filter`.
33
33
  - **📥 Import existing trees** — `forgemap import <path>` adopts a folder already laid out as `<server>/<owner>/<repo>`, reconciles each repo against its git remote (spotting moved or deleted remotes), and derives a config.
@@ -56,7 +56,7 @@ forgemap cd laravel # fuzzy match → jump in; bare `forgem
56
56
  `forgemap cd` resolves the slug, walks/picks across your cloned repos, and actually changes directory because the shell wrapper from `shell-init` intercepts it before the binary runs. Every other subcommand falls through to the real binary unchanged. Hacking on forgemap itself? See [CONTRIBUTING.md → Trying the CLI locally](CONTRIBUTING.md#trying-the-cli-locally) — covers `pnpm setup`, `pnpm link --global .` and the shell-wrapper source.
57
57
 
58
58
  <details>
59
- <summary><strong>All commands</strong> — clone, cd, path, search, pick, open, sync/status, import, cleanup, delete, validate, shell-init, config</summary>
59
+ <summary><strong>All commands</strong> — clone, cd, path, list, pick, open, sync/status, import, cleanup, delete, validate, shell-init, config</summary>
60
60
 
61
61
  ### Clone & jump
62
62
 
@@ -82,11 +82,12 @@ code "$(forgemap path forgemap)" # feed any tool that takes a directory
82
82
 
83
83
  Prints where a repo lives — or *would* live, if it isn't cloned yet, which makes it useful for scripting a clone target. An exact `owner/repo` never touches the disk, so a strict slug always wins over a fuzzy match; ambiguous fuzzy terms error with the candidate list rather than guessing.
84
84
 
85
- ### Search and pick on demand
85
+ ### List, search and pick on demand
86
86
 
87
87
  ```bash
88
- forgemap search forgemap # pretty tree (one line per match)
89
- forgemap search forgemap | fzf # pipe-friendly path output
88
+ forgemap list # every repo as a pretty tree
89
+ forgemap list forgemap # pretty tree (one line per match)
90
+ forgemap list forgemap | fzf # pipe-friendly path output
90
91
  forgemap pick # interactive picker (consola prompt)
91
92
  forgemap pick kirch # picker pre-filtered by fuzzy query
92
93
  ```
@@ -118,11 +119,11 @@ forgemap status --format json --filter kirchDev --filter TitusKirch
118
119
  forgemap status --no-cache # rescan the disk instead of using the cached tree
119
120
  ```
120
121
 
121
- `--filter` works on `status`, `sync` and `search`. It matches an **owner** or a **forge name** exactly (case-insensitive) — unlike `--query`, which is fuzzy.
122
+ `--filter` works on `status`, `sync` and `list`. It matches an **owner** or a **forge name** exactly (case-insensitive) — unlike `--query`, which is fuzzy.
122
123
 
123
124
  `status`, `sync` and `cleanup` read a cached repo tree so repeated runs stay fast. Pass `--no-cache` to skip it and walk the disk again — the cache refreshes on its own, so you only need this right after cloning or moving repos by hand.
124
125
 
125
- All tree output (`status`, `search`, `import`) groups as `forge → owner → repo`. Network operations (`sync`, `import`, `cleanup`) run with a hard timeout and non-interactive SSH, so an unreachable host can never wedge a run.
126
+ All tree output (`status`, `list`, `import`) groups as `forge → owner → repo`. Network operations (`sync`, `import`, `cleanup`) run with a hard timeout and non-interactive SSH, so an unreachable host can never wedge a run.
126
127
 
127
128
  ### Adopt an existing layout — `import`
128
129