fixpm 0.1.0__tar.gz

fixpm-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Lint (ruff)
+        run: ruff check .
+      - name: Test (pytest)
+        run: pytest -q

fixpm-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.idea/
+.vscode/

fixpm-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fixpm contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fixpm-0.1.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.5
+Name: fixpm
+Version: 0.1.0
+Summary: Interactive fixer for broken npm / npx / pnpm / yarn commands.
+Author: fixpm contributors
+License: MIT License
+        
+        Copyright (c) 2026 fixpm contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: cli,did-you-mean,npm,npx,pnpm,typo,yarn
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: questionary>=2.0
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# fixpm
+
+<!-- TODO(badges): CI status, PyPI version, Python versions, license -->
+
+**Interactive command fixer for npm / npx / pnpm / yarn typos.**
+
+You typed `npm isntall react`. Your terminal yelled at you. `fixpm` knows what you meant — pick the fix with arrow keys, press Enter, done.
+
+## Why
+
+Package-manager CLIs fail in very predictable ways: a mistyped subcommand (`isntall`), a missing flag prefix (`save-dev` instead of `--save-dev`), or a mistyped package name (`loadash`). Generic "did you mean" tools don't understand that `add` is valid for `yarn` but means `install` on `npm`, or that `--frozen-lockfile` belongs to `pnpm install`.
+
+`fixpm` ships a declarative rule table per package manager plus live npm-registry lookups, so suggestions are syntax-aware, not just string-similar.
+
+## Features
+
+- **Automatic detection** — a tiny zsh/bash hook notices when an `npm`-family command exits non-zero and nudges you.
+- **Five error classes**: subcommand typo, flag typo, missing flag prefix (`--`), missing required argument, package-name typo.
+- **Registry-backed package fixes** — candidates ranked by edit distance *and* weekly download count (typos like `loadash` → `lodash`, never a dead lookalike package).
+- **Interactive or one-shot** — arrow-key selection, or `--dry-run` to print fixes.
+- **Extensible rule tables** — adding a manager or command is editing a data table, not writing code.
+
+## Install
+
+```bash
+pipx install fixpm      # recommended
+# or
+pip install --user fixpm
+```
+
+> Note: verify the `fixpm` name is free on PyPI before your first release; if taken, rename the distribution in `pyproject.toml` (`name = ...`) — the console command can stay `fixpm`.
+
+## Setup
+
+Enable automatic failure detection (zsh):
+
+```bash
+echo 'eval "$(fixpm --init zsh)"' >> ~/.zshrc
+```
+
+or bash:
+
+```bash
+echo 'eval "$(fixpm --init bash)"' >> ~/.bashrc
+```
+
+No hook? Works manually too:
+
+```bash
+fixpm "npm isntall react"     # quote multi-token commands
+```
+
+## Demo
+
+Text walkthrough of the interaction:
+
+```console
+$ npm isntall react --save-dev
+npm ERR! Unknown command: "isntall"
+
+  ↯ fix available — run fixpm        ← printed automatically by the hook
+
+$ fixpm
+? Apply a fix: (↑/↓ move · enter select · ctrl+c cancel)
+❯ npm install react --save-dev   · command fix · 95%
+  Skip — do nothing
+
+→ npm install react --save-dev   ← executed after Enter
+added 42 packages in 3s
+```
+
+<!-- TODO(demo): replace with an asciinema recording / GIF once published.
+![demo](docs/assets/demo.gif) -->
+
+### What it catches
+
+| You type | fixpm suggests | Class |
+| --- | --- | --- |
+| `npm isntall react` | `npm install react` | subcommand typo |
+| `npm i loadash` | `npm i lodash` | package typo (registry-checked) |
+| `npm install express save-dev` | `npm install express --save-dev` | missing flag prefix |
+| `npm run` | `npm run <script>` | missing argument (not auto-executed) |
+| `pnpm ad left-pad` | `pnpm add left-pad` | subcommand typo |
+| `yarn globla add vite` | `yarn global add vite` | subcommand typo |
+| `npx creat-react-app web` | `npx create-react-app web` | package typo |
+
+## How it works
+
+1. The shell hook exports `$FIXPM_LAST_COMMAND` / `$FIXPM_LAST_EXIT_CODE`; `fixpm` reads them (or takes the command as arguments).
+2. `detector.py` tokenizes the line, finds the manager binary, and classifies each issue against that manager's rule table.
+3. `corrector.py` turns issues into concrete commands; package typos go through `packages.py`, which queries the npm registry search API and ranks by `0.62 × edit-distance similarity + 0.38 × log(weekly downloads)` (clamped). Network failures degrade gracefully to a small curated typo map — the tool never crashes offline.
+
+## Troubleshooting
+
+**The hook never prints a hint after a failed npm command.**
+
+1. Make sure the probe itself finds suggestions:
+   ```bash
+   fixpm --dry-run "npm isntall react"   # must exit 0 and print fixes
+   ```
+   If it prints `No fix found`, the typo simply isn't covered yet — the hook stays silent by design. PRs adding rules are welcome.
+2. Make sure `fixpm` is actually on PATH *in that shell* (`command -v fixpm`). `pip install --user` puts it in Python's `Scripts` directory, which is often not on PATH — prefer `pipx`, or add the directory manually.
+3. Still stuck? Re-run the failing command with `FIXPM_DEBUG=1` exported — the hook then shows why its probe failed instead of swallowing errors.
+
+## Contributing
+
+Contributions welcome — especially **rule tables** for pnpm/yarn coverage.
+
+```bash
+git clone https://github.com/Max-code7997/fixpm && cd fixpm
+pip install -e ".[dev]"
+ruff check . && pytest
+```
+
+### Adding a rule
+
+Rules are data, not code. To teach `fixpm` a new command, alias, flag, or common misspelling, edit the relevant table in `src/fixpm/rules/`:
+
+```python
+# src/fixpm/rules/npm.py
+NPM = register(
+    ManagerSpec(
+        name="npm",
+        binaries=("npm",),
+        commands=("install", "run", "publish", ...),   # canonical top-level commands
+        aliases={"i": "install", "innit": "init"},      # alt spelling -> canonical
+        flags={"install": ("--save-dev", "-D", ...)},   # validated flags per command
+        typo_hints={"isntall": "install"},              # deterministic overrides
+    )
+)
+```
+
+Guidelines:
+
+- One PR per logical change (a new manager, a batch of flags, …).
+- Add a pytest case in `tests/test_corrections.py` for every new behavior.
+- Flag lists may be partial — unknown flags on unlisted commands are simply not validated (conservative by design).
+
+See [CONTRIBUTING notes above](#contributing); open an issue first for new package managers.
+
+## Roadmap
+
+- [ ] Deeper pnpm / yarn (Berry) flag coverage
+- [ ] fish & PowerShell hooks
+- [ ] Validate `npm run <script>` against local `package.json`
+- [ ] On-disk registry cache with TTL
+- [ ] `fixpm --explain` (why this suggestion)
+
+## License
+
+[MIT](LICENSE)

fixpm-0.1.0/README.md

@@ -0,0 +1,151 @@
+# fixpm
+
+<!-- TODO(badges): CI status, PyPI version, Python versions, license -->
+
+**Interactive command fixer for npm / npx / pnpm / yarn typos.**
+
+You typed `npm isntall react`. Your terminal yelled at you. `fixpm` knows what you meant — pick the fix with arrow keys, press Enter, done.
+
+## Why
+
+Package-manager CLIs fail in very predictable ways: a mistyped subcommand (`isntall`), a missing flag prefix (`save-dev` instead of `--save-dev`), or a mistyped package name (`loadash`). Generic "did you mean" tools don't understand that `add` is valid for `yarn` but means `install` on `npm`, or that `--frozen-lockfile` belongs to `pnpm install`.
+
+`fixpm` ships a declarative rule table per package manager plus live npm-registry lookups, so suggestions are syntax-aware, not just string-similar.
+
+## Features
+
+- **Automatic detection** — a tiny zsh/bash hook notices when an `npm`-family command exits non-zero and nudges you.
+- **Five error classes**: subcommand typo, flag typo, missing flag prefix (`--`), missing required argument, package-name typo.
+- **Registry-backed package fixes** — candidates ranked by edit distance *and* weekly download count (typos like `loadash` → `lodash`, never a dead lookalike package).
+- **Interactive or one-shot** — arrow-key selection, or `--dry-run` to print fixes.
+- **Extensible rule tables** — adding a manager or command is editing a data table, not writing code.
+
+## Install
+
+```bash
+pipx install fixpm      # recommended
+# or
+pip install --user fixpm
+```
+
+> Note: verify the `fixpm` name is free on PyPI before your first release; if taken, rename the distribution in `pyproject.toml` (`name = ...`) — the console command can stay `fixpm`.
+
+## Setup
+
+Enable automatic failure detection (zsh):
+
+```bash
+echo 'eval "$(fixpm --init zsh)"' >> ~/.zshrc
+```
+
+or bash:
+
+```bash
+echo 'eval "$(fixpm --init bash)"' >> ~/.bashrc
+```
+
+No hook? Works manually too:
+
+```bash
+fixpm "npm isntall react"     # quote multi-token commands
+```
+
+## Demo
+
+Text walkthrough of the interaction:
+
+```console
+$ npm isntall react --save-dev
+npm ERR! Unknown command: "isntall"
+
+  ↯ fix available — run fixpm        ← printed automatically by the hook
+
+$ fixpm
+? Apply a fix: (↑/↓ move · enter select · ctrl+c cancel)
+❯ npm install react --save-dev   · command fix · 95%
+  Skip — do nothing
+
+→ npm install react --save-dev   ← executed after Enter
+added 42 packages in 3s
+```
+
+<!-- TODO(demo): replace with an asciinema recording / GIF once published.
+![demo](docs/assets/demo.gif) -->
+
+### What it catches
+
+| You type | fixpm suggests | Class |
+| --- | --- | --- |
+| `npm isntall react` | `npm install react` | subcommand typo |
+| `npm i loadash` | `npm i lodash` | package typo (registry-checked) |
+| `npm install express save-dev` | `npm install express --save-dev` | missing flag prefix |
+| `npm run` | `npm run <script>` | missing argument (not auto-executed) |
+| `pnpm ad left-pad` | `pnpm add left-pad` | subcommand typo |
+| `yarn globla add vite` | `yarn global add vite` | subcommand typo |
+| `npx creat-react-app web` | `npx create-react-app web` | package typo |
+
+## How it works
+
+1. The shell hook exports `$FIXPM_LAST_COMMAND` / `$FIXPM_LAST_EXIT_CODE`; `fixpm` reads them (or takes the command as arguments).
+2. `detector.py` tokenizes the line, finds the manager binary, and classifies each issue against that manager's rule table.
+3. `corrector.py` turns issues into concrete commands; package typos go through `packages.py`, which queries the npm registry search API and ranks by `0.62 × edit-distance similarity + 0.38 × log(weekly downloads)` (clamped). Network failures degrade gracefully to a small curated typo map — the tool never crashes offline.
+
+## Troubleshooting
+
+**The hook never prints a hint after a failed npm command.**
+
+1. Make sure the probe itself finds suggestions:
+   ```bash
+   fixpm --dry-run "npm isntall react"   # must exit 0 and print fixes
+   ```
+   If it prints `No fix found`, the typo simply isn't covered yet — the hook stays silent by design. PRs adding rules are welcome.
+2. Make sure `fixpm` is actually on PATH *in that shell* (`command -v fixpm`). `pip install --user` puts it in Python's `Scripts` directory, which is often not on PATH — prefer `pipx`, or add the directory manually.
+3. Still stuck? Re-run the failing command with `FIXPM_DEBUG=1` exported — the hook then shows why its probe failed instead of swallowing errors.
+
+## Contributing
+
+Contributions welcome — especially **rule tables** for pnpm/yarn coverage.
+
+```bash
+git clone https://github.com/Max-code7997/fixpm && cd fixpm
+pip install -e ".[dev]"
+ruff check . && pytest
+```
+
+### Adding a rule
+
+Rules are data, not code. To teach `fixpm` a new command, alias, flag, or common misspelling, edit the relevant table in `src/fixpm/rules/`:
+
+```python
+# src/fixpm/rules/npm.py
+NPM = register(
+    ManagerSpec(
+        name="npm",
+        binaries=("npm",),
+        commands=("install", "run", "publish", ...),   # canonical top-level commands
+        aliases={"i": "install", "innit": "init"},      # alt spelling -> canonical
+        flags={"install": ("--save-dev", "-D", ...)},   # validated flags per command
+        typo_hints={"isntall": "install"},              # deterministic overrides
+    )
+)
+```
+
+Guidelines:
+
+- One PR per logical change (a new manager, a batch of flags, …).
+- Add a pytest case in `tests/test_corrections.py` for every new behavior.
+- Flag lists may be partial — unknown flags on unlisted commands are simply not validated (conservative by design).
+
+See [CONTRIBUTING notes above](#contributing); open an issue first for new package managers.
+
+## Roadmap
+
+- [ ] Deeper pnpm / yarn (Berry) flag coverage
+- [ ] fish & PowerShell hooks
+- [ ] Validate `npm run <script>` against local `package.json`
+- [ ] On-disk registry cache with TTL
+- [ ] `fixpm --explain` (why this suggestion)
+
+## License
+
+[MIT](LICENSE)

fixpm-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "fixpm"
+version = "0.1.0"
+description = "Interactive fixer for broken npm / npx / pnpm / yarn commands."
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "fixpm contributors" }]
+requires-python = ">=3.10"
+keywords = ["npm", "npx", "pnpm", "yarn", "cli", "typo", "did-you-mean"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.12",
+    "questionary>=2.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "ruff>=0.4"]
+
+[project.scripts]
+fixpm = "fixpm.cli:app"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fixpm"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+ignore = ["E501", "B008"]  # B008: typer uses function calls in defaults by design
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

fixpm-0.1.0/src/fixpm/__init__.py

@@ -0,0 +1,3 @@
+"""fixpm — interactive command fixer for npm / npx / pnpm / yarn."""
+
+__version__ = "0.1.0"

fixpm-0.1.0/src/fixpm/__main__.py

@@ -0,0 +1,3 @@
+from fixpm.cli import app
+
+app()

fixpm-0.1.0/src/fixpm/cli.py

@@ -0,0 +1,132 @@
+"""CLI entry point.
+
+Modes:
+  fixpm                       fix $FIXPM_LAST_COMMAND (set by shell hook)
+  fixpm <command words...>    fix an explicit command line
+  fixpm --dry-run <cmd>       print fixes without prompting/executing
+  fixpm --init zsh|bash       emit the hook script for eval "$(...)"
+"""
+
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+from importlib import resources
+
+import typer
+
+from . import __version__
+from .corrector import get_corrections
+from .interactive import choose
+from .rules import all_specs, spec_for_binary
+from .rules.base import KIND_LABEL
+
+app = typer.Typer(
+    add_completion=False,
+    context_settings={"help_option_names": ["-h", "--help"]},
+    help="Fix broken npm / npx / pnpm / yarn commands.",
+)
+
+ENV_COMMAND = "FIXPM_LAST_COMMAND"
+ENV_EXIT_CODE = "FIXPM_LAST_EXIT_CODE"
+
+_HOOKS = {"bash": "fixpm.bash", "zsh": "fixpm.zsh"}
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"fixpm {__version__}")
+        raise typer.Exit()
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    command: list[str] | None = typer.Argument(
+        None, help="Failed command to fix. Reads $FIXPM_LAST_COMMAND when omitted."
+    ),
+    manager: str | None = typer.Option(
+        None, "--manager", "-m",
+        help="Force a package manager instead of auto-detecting.",
+    ),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help="Print fixes without prompting or executing."
+    ),
+    version: bool = typer.Option(
+        False, "--version", "-V", callback=_version_callback, is_eager=True,
+        help="Show version and exit.",
+    ),
+    init_shell: str | None = typer.Option(
+        None, "--init",
+        help='Emit a hook script for the given shell ("bash" or "zsh"). '
+             'Use inside eval: eval "$(fixpm --init zsh)".',
+    ),
+) -> None:
+    if init_shell is not None:
+        _emit_hook(init_shell)
+        return
+    if ctx.invoked_subcommand is not None:
+        return
+
+    text = " ".join(command).strip() if command \
+        else os.environ.get(ENV_COMMAND, "").strip()
+    if not text:
+        typer.secho("No command provided.", fg="red")
+        typer.echo(
+            'Run `fixpm <failed command>` or install a shell hook first: '
+            '`fixpm --init zsh`.'
+        )
+        raise typer.Exit(code=1)
+
+    spec = None
+    if manager:
+        spec = spec_for_binary(manager)
+        if spec is None:
+            names = ", ".join(sorted({s.binaries[0] for s in all_specs()}))
+            raise typer.BadParameter(f"unknown manager {manager!r}; pick one of: {names}")
+
+    corrections = get_corrections(text, spec=spec)
+    if not corrections:
+        typer.secho(f"No fix found for: {text}", fg="yellow")
+        raise typer.Exit(code=1)
+
+    if dry_run:
+        for c in corrections:
+            typer.echo(f"  [{KIND_LABEL[c.kind]}] {c.command}")
+        return
+
+    choice = choose(corrections)
+    if choice is None:
+        typer.echo("Cancelled.")
+        raise typer.Exit(code=1)
+
+    typer.secho(f"-> {choice.command}", fg="cyan", bold=True)
+    if not choice.executable:
+        typer.echo("This fix needs manual arguments — copy it and fill them in.")
+        raise typer.Exit(code=0)
+
+    raise typer.Exit(code=subprocess.run(choice.command, shell=True).returncode)
+
+
+def _emit_hook(shell: str) -> None:
+    filename = _HOOKS.get(shell)
+    if filename is None:
+        supported = ", ".join(sorted(_HOOKS))
+        typer.secho(f"Unsupported shell {shell!r}. Supported: {supported}",
+                    fg="red", err=True)
+        raise typer.Exit(code=1)
+    script = (resources.files("fixpm.shell") / filename).read_text(encoding="utf-8")
+    # Write LF-only bytes directly: Windows pipes translate "\n" to "\r\n",
+    # and a unix shell sourcing CRLF text ends up with broken hook definitions
+    # (functions named "...{\r"). Git Bash/MSYS silently tolerates CRLF, WSL
+    # and native Linux do not — so the raw byte stream must be LF.
+    sys.stdout.buffer.write(script.replace("\r\n", "\n").encode("utf-8"))
+    sys.stdout.buffer.flush()
+    rc_file = "~/.zshrc" if shell == "zsh" else "~/.bashrc"
+    typer.secho(f"# Add this line to your {rc_file}: "
+                f'eval "$(fixpm --init {shell})"', dim=True, err=True)
+
+
+if __name__ == "__main__":
+    app()