linkedin-apply-assistant 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -6,6 +6,15 @@ This file follows the spirit of Keep a Changelog and uses semantic version label
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-06-13
+
+### Changed
+
+- Simplified README and npm package-page install instructions to one npm
+  command plus one direct PowerShell installer command.
+- Kept extended Python, Playwright, source checkout, and troubleshooting details
+  in the canonical install guide instead of duplicating them in the README.
+
 ## [0.1.1] - 2026-06-13
 
 ### Added

package/README.md

@@ -7,7 +7,7 @@ LinkedIn-apply-assistant is an experimental local browser automation assistant f
 
 The package is local-first. It does not require credentials in config, copied browser profiles, private documents, or generated reports to import, inspect, or run its deterministic tests.
 
-Current package metadata version: `0.1.1`.
+Current package metadata version: `0.1.2`.
 
 ## Safety Boundary
 
@@ -28,56 +28,30 @@ Read [SAFETY.md](SAFETY.md) before using visible-browser workflows. Read [LEGAL.
 
 ## Install
 
-NPM global launcher:
+NPM:
 
-```powershell
+```bash
 npm install -g linkedin-apply-assistant
-linkedin-apply-assistant --help
 ```
 
-The npm package is a Node launcher plus bundled Python source. If the launcher
-reports missing Python imports, install the bundled Python package from the
-global npm package directory:
+Windows PowerShell:
 
 ```powershell
-$pkg = Join-Path (npm root -g) 'linkedin-apply-assistant'
-py -3 -m pip install $pkg
+powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://raw.githubusercontent.com/MohammedGhazal09/linkedin-apply-assistant/main/install.ps1 -OutFile $env:TEMP\linkedin-apply-assistant-install.ps1; & $env:TEMP\linkedin-apply-assistant-install.ps1"
 ```
 
-PowerShell no-admin installer:
+Verify:
 
 ```powershell
-$script = Join-Path $env:TEMP 'install-linkedin-apply-assistant.ps1'
-Invoke-WebRequest -UseBasicParsing https://raw.githubusercontent.com/MohammedGhazal09/linkedin-apply-assistant/main/install.ps1 -OutFile $script
-powershell -ExecutionPolicy Bypass -File $script
-```
-
-From the package directory:
-
-```powershell
-python -m pip install -e ".[dev]"
-linkedin-apply-assistant --help
-```
-
-For Bash/macOS/Linux:
-
-```bash
-python -m pip install -e ".[dev]"
 linkedin-apply-assistant --help
 ```
 
-For editable local development, this module fallback is available from the package root:
-
-```powershell
-$env:PYTHONPATH=(Resolve-Path 'src').Path
-python -m linkedin_apply_assistant.cli --help
-```
-
-Use Python 3.11 or newer. Install Playwright Chromium before visible-browser workflows such as `search`, `assist`, or browser-dependent `apply` preparation. Browser-free `dry-run` and `report` do not require Chromium.
-
-The package also includes a local npm launcher shape for package dry-run validation. It delegates to the Python CLI and still requires Python 3.11+ and the package dependencies to be installed or importable.
-
-Source checkout is available at <https://github.com/MohammedGhazal09/linkedin-apply-assistant>. See [docs/install-and-configuration.md](docs/install-and-configuration.md) for the full npm, PowerShell, source, Python, and Playwright install matrix. PyPI remains a future package channel; the package-channel decision is documented in the [registry publication strategy](docs/registry-publication-strategy.md).
+Use Python 3.11 or newer. The npm package is the current public registry path;
+the PowerShell command downloads the installer from GitHub and runs it locally.
+See [docs/install-and-configuration.md](docs/install-and-configuration.md) for
+source, Python, Playwright, and troubleshooting details. PyPI remains a future
+package channel; the package-channel decision is documented in the
+[registry publication strategy](docs/registry-publication-strategy.md).
 
 ## Quick Start
 

package/RELEASE_CHECKLIST.md

@@ -354,6 +354,47 @@ Distribution safety boundary:
 - PyPI and TestPyPI uploads stay out of this release.
 - `v0.1.0` remains source-only and is not backfilled to any registry.
 
+## v0.1.2 Install Documentation Simplification Release
+
+This patch refreshes the npm package page, README, and GitHub Release wording so
+the default install path matches common open-source README conventions: one npm command, one direct PowerShell installer command, and a link to detailed setup docs.
+
+Scope:
+
+- Package version: `0.1.2`
+- npm package: `linkedin-apply-assistant`
+- npm dist-tag: `latest`
+- GitHub Release: `v0.1.2`
+- Repository: `MohammedGhazal09/linkedin-apply-assistant`
+- Runtime behavior, browser safety posture, and public CLI contract are unchanged.
+- PyPI and TestPyPI remain future channels.
+
+Required local evidence before public sync:
+
+```powershell
+python -m pytest tests\test_distribution_metadata.py tests\test_docs_smoke.py tests\test_registry_publication_strategy.py tests\test_release_readiness.py tests\test_npm_launcher.py tests\test_distribution_smoke.py tests\test_release_manifest.py -q
+python scripts\release.py clean
+python scripts\release.py manifest --check
+python scripts\release.py verify
+npm pack --dry-run --json
+```
+
+Post-publish verification:
+
+```powershell
+npm view linkedin-apply-assistant version --json
+npm view linkedin-apply-assistant dist-tags --json
+gh release view v0.1.2 --repo MohammedGhazal09/linkedin-apply-assistant --json tagName,name,url,isDraft,isPrerelease,targetCommitish
+```
+
+Distribution safety boundary:
+
+- this is a docs-only package refresh to update the immutable npm README for the
+  latest package version
+- no lifecycle install, publish, or token scripts are added to `package.json`
+- `install.ps1` continues to avoid `Invoke-Expression` pipe-install behavior
+- PyPI and TestPyPI uploads stay out of this release
+
 ## Required Public Metadata
 
 `package.json` must include exactly these public project fields:
@@ -407,7 +448,7 @@ Do not publish while any hard blocker remains unresolved.
 - `LEGAL.md` and `SAFETY.md` remain linked from README.
 - `MIGRATION.md` explains extraction scope and excluded root surfaces.
 - `CONTRIBUTING.md` and `SECURITY.md` are standalone-scoped.
-- Changelog has `Unreleased`, `0.1.1`, and `0.1.0`.
+- Changelog has `Unreleased`, `0.1.2`, `0.1.1`, and `0.1.0`.
 - Source, Python, npm launcher, and PowerShell installer docs are current and tested.
 - Phase 21 terminal UX docs and help stay current: `docs\commands.md`, `tests\test_cli_help.py`, and `tests\test_config_diagnostics.py`.
 - Public package metadata points to the canonical GitHub repository and issue tracker.

package/SECURITY.md

@@ -34,4 +34,4 @@ Never attach browser profiles, cookies, credentials, screenshots, private docume
 
 ## Supported Versions
 
-The initial standalone GitHub source release is `0.1.0`. Current package metadata is `0.1.1`. Security guidance applies to the current unreleased, `0.1.1`, and `0.1.0` package-local surfaces.
+The initial standalone GitHub source release is `0.1.0`. Current package metadata is `0.1.2`. Security guidance applies to the current unreleased, `0.1.2`, `0.1.1`, and `0.1.0` package-local surfaces.

package/docs/install-and-configuration.md

@@ -4,13 +4,32 @@ This package runs locally. You install the Python package, choose a local worksp
 
 This file is the canonical install matrix. The README keeps only a short quick start.
 
-Current package metadata version: `0.1.1`.
+Current package metadata version: `0.1.2`.
 
-The npm launcher and PowerShell installer are the current quick-install paths.
+The npm launcher and PowerShell no-admin installer are the current quick-install paths.
 PyPI remains a future package channel. The package-channel decision, approval
 gates, and `v0.1.0` no-backfill policy are documented in the
 [registry publication strategy](registry-publication-strategy.md).
 
+## Fast Install
+
+NPM:
+
+```bash
+npm install -g linkedin-apply-assistant
+linkedin-apply-assistant --help
+```
+
+Windows PowerShell without npm:
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://raw.githubusercontent.com/MohammedGhazal09/linkedin-apply-assistant/main/install.ps1 -OutFile $env:TEMP\linkedin-apply-assistant-install.ps1; & $env:TEMP\linkedin-apply-assistant-install.ps1"
+```
+
+The PowerShell command downloads [install.ps1](../install.ps1) from GitHub raw
+content to your temporary directory, then runs that local file. It does not use
+an `Invoke-Expression` pipe-install pattern.
+
 ## Prerequisites
 
 - Python 3.11 or newer.
@@ -53,15 +72,13 @@ local virtual environment, installs the Python package, and writes
 does not require admin rights.
 
 ```powershell
-$script = Join-Path $env:TEMP 'install-linkedin-apply-assistant.ps1'
-Invoke-WebRequest -UseBasicParsing https://raw.githubusercontent.com/MohammedGhazal09/linkedin-apply-assistant/main/install.ps1 -OutFile $script
-powershell -ExecutionPolicy Bypass -File $script
+powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://raw.githubusercontent.com/MohammedGhazal09/linkedin-apply-assistant/main/install.ps1 -OutFile $env:TEMP\linkedin-apply-assistant-install.ps1; & $env:TEMP\linkedin-apply-assistant-install.ps1"
 ```
 
 Optional visible-browser setup during install:
 
 ```powershell
-powershell -ExecutionPolicy Bypass -File $script -InstallBrowser
+powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://raw.githubusercontent.com/MohammedGhazal09/linkedin-apply-assistant/main/install.ps1 -OutFile $env:TEMP\linkedin-apply-assistant-install.ps1; & $env:TEMP\linkedin-apply-assistant-install.ps1 -InstallBrowser"
 ```
 
 ## Current Source Checkout

package/docs/registry-publication-strategy.md

@@ -6,18 +6,19 @@ registry token, log in to a registry, create a tag, upload a GitHub Release
 asset, or grant publish-capable workflow permissions.
 
 The first GitHub source release, `v0.1.0`, remains source-only and is not a
-registry backfill candidate. The npm launcher release starts at `0.1.1`; PyPI
-and TestPyPI remain future channels.
+registry backfill candidate. The npm launcher release starts at `0.1.1`; the
+current docs-only npm package page refresh is `0.1.2`. PyPI and TestPyPI remain
+future channels.
 
 ## Current Boundary
 
-- Current package metadata version: `0.1.1`.
+- Current package metadata version: `0.1.2`.
 - Current install path: npm global launcher, PowerShell installer, source
   checkout, local Python install, local editable install, and local npm launcher
   dry-run validation.
 - Current public channel: GitHub repository source checkout and GitHub source
-  release archives; npm launcher package for `0.1.1` after the approved npm
-  publish step verifies successfully.
+  release archives; npm launcher package for `0.1.2` after the approved npm
+  patch publish step verifies successfully.
 - Not current: PyPI package, TestPyPI package, GitHub Packages package, PyPI
   trusted-publisher setup, npm trusted-publisher setup, registry automation,
   release asset uploads, artifact attestations, provenance, or signing.
@@ -33,14 +34,14 @@ action, and exact mutation.
 | GitHub Releases | Current source-only channel for `v0.1.0`. No wheel, sdist, npm tarball, or other release asset is attached. | Keep as the source-of-truth release record. Future assets require explicit approval. | Users can inspect and install from source without introducing registry auth or package-name ownership. | Clean local verification, changelog, release checklist, source manifest, approved tag or release mutation. | Explicit GitHub Release approval naming repo, tag, target commit, release state, and assets, if any. | `gh release view`, `gh release list`, source archive inspection, release manifest verification. | Remove mistaken assets from the release, correct the release notes, or delete a draft. Source tags need separate explicit remediation because asset removal does not undo a tag. |
 | PyPI | Not published and not reserved. | Primary future Python registry for direct package publication. | The project is a Python CLI with Playwright-driven browser automation, so PyPI is the natural long-term install path. | Maintainer or maintainer-controlled organization ownership, account 2FA where supported, PyPI Trusted Publishing with GitHub Actions OIDC, protected `pypi` environment, clean build and metadata gates. | Explicit PyPI approval naming repository, version, PyPI project, workflow or manual action, and exact upload mutation. | Read-only JSON API check, `python -m build`, `twine check dist/*`, local wheel install smoke, release scan, manifest verification. | Prefer yanking a broken release where appropriate. Deletion is disruptive and permanent; never rely on deleting and reusing the same version. |
 | TestPyPI | Not published and not reserved. | Required preflight for the first registry release and for publish-workflow changes. Routine patch preflights can become optional only after a proven release cycle. | It exercises package metadata, artifacts, and installer behavior before the real PyPI release. | Same artifact gates as PyPI, protected `testpypi` environment, explicit preflight approval, no production token. | Explicit TestPyPI approval naming repository, version, TestPyPI project, workflow or manual action, and exact upload mutation. | TestPyPI JSON API check, metadata validation, test-index install smoke, package contents review. | Clean up mistaken TestPyPI releases where possible and move forward with a new version if needed. Do not treat TestPyPI cleanup as production rollback proof. |
-| npm | Public thin-launcher channel for `0.1.1`. | Keep as the JavaScript ecosystem convenience launcher; use PyPI later for direct Python package installs. | npm provides a familiar global command on systems that already have Node.js, but the launcher delegates to the Python CLI and cannot install Python itself. | Maintainer or maintainer-controlled ownership, account 2FA where supported, first-publish token bootstrap if trusted publishing cannot create the package, exact package contents review. | Explicit npm approval naming repository, version, npm package, workflow or manual action, and exact registry mutation. | `npm pack --dry-run --json`, package contents inspection, no lifecycle install/publish scripts, npm read-only registry check after publication. | Prefer deprecation for bad packages when unpublish criteria are not met. A used npm `package@version` cannot be reused, even after unpublish. |
+| npm | Public thin-launcher channel for `0.1.2`; `0.1.1` was the first npm and PowerShell distribution release. | Keep as the JavaScript ecosystem convenience launcher; use PyPI later for direct Python package installs. | npm provides a familiar global command on systems that already have Node.js, but the launcher delegates to the Python CLI and cannot install Python itself. | Maintainer or maintainer-controlled ownership, account 2FA where supported, first-publish token bootstrap if trusted publishing cannot create the package, exact package contents review. | Explicit npm approval naming repository, version, npm package, workflow or manual action, and exact registry mutation. | `npm pack --dry-run --json`, package contents inspection, no lifecycle install/publish scripts, npm read-only registry check after publication. | Prefer deprecation for bad packages when unpublish criteria are not met. A used npm `package@version` cannot be reused, even after unpublish. |
 | PowerShell installer | Current GitHub-hosted installer script at `install.ps1`. | Keep as the no-admin Windows convenience path for users who prefer a single script. | It can create a local virtual environment, install dependencies from the public source archive, create command shims, and optionally install Chromium. | Public GitHub source archive availability, Python 3.11+, script syntax validation, no `Invoke-Expression` pipe-install pattern, and local install smoke. | Push the verified installer to the public repository; no registry mutation is required. | PowerShell parser check, temp-directory install smoke, command shim help smoke, and docs link checks. | Fix forward in `main`; users can reinstall from the corrected script or pin `-Ref` to a known tag. |
 | GitHub Packages | Not used. | Deferred. | It adds `packages: write` and authenticated consumption friction without improving the primary Python install path. | A future reason to publish a package to GitHub Packages, explicit package type, permission model, and install documentation. | Separate approval naming package type, repository, version, and exact mutation. | GitHub Packages read-only checks and package permission review. | Delete or deprecate only according to the package type's GitHub Packages support. This is not a substitute for PyPI/npm remediation. |
 
 ## Package Names
 
 The target package name for PyPI, TestPyPI, and npm publication is
-`linkedin-apply-assistant`. The current npm launcher version is `0.1.1`.
+`linkedin-apply-assistant`. The current npm launcher version is `0.1.2`.
 
 If the unscoped npm name becomes unavailable or ownership changes later, the
 fallback is a future scoped npm package under a maintainer-controlled scope.
@@ -53,6 +54,8 @@ fallback is a future scoped npm package under a maintainer-controlled scope.
 - The npm launcher release uses `0.1.1` because it changes distribution
   metadata, includes the Python source in the npm tarball, and adds the
   PowerShell installer without changing the browser workflow contract.
+- The docs-only npm package page refresh uses `0.1.2` because published npm
+  README content is immutable for an existing package version.
 - If user-visible behavior changes before registry publication, the default
   future version example is `0.2.0`.
 - Future behavior changes remain SemVer decisions at the publish phase.
@@ -124,7 +127,7 @@ Use these templates verbatim before any future registry or release mutation.
 ### npm Launcher Release
 
 - Repository: `MohammedGhazal09/linkedin-apply-assistant`
-- Version: `0.1.1`
+- Version: `<version>`
 - Channel: npm
 - Workflow or manual action: `<workflow filename or manual command owner>`
 - Exact mutation: publish the verified npm launcher package for `<version>` to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkedin-apply-assistant",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Thin npm launcher for the Python LinkedIn apply assistant package",
   "license": "MIT",
   "repository": {

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "linkedin-apply-assistant"
-version = "0.1.1"
+version = "0.1.2"
 description = "Local LinkedIn application assistant with user-visible browser workflows"
 readme = "README.md"
 requires-python = ">=3.11"

package/src/linkedin_apply_assistant/__init__.py

@@ -1,6 +1,6 @@
 """Package identity for the standalone LinkedIn application assistant."""
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"
 
 APP_DISPLAY_NAME = "LinkedIn-apply-assistant"
 APP_PACKAGE_NAME = "linkedin-apply-assistant"