patchy-cli 0.0.2-pr.115.296bb27

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Richard Gill
+
+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.

package/README.md

@@ -0,0 +1,152 @@
+# patchy
+
+An opinionated command-line tool for managing Git patch workflows.
+
+**patchy** helps you maintain a curated set of patches—both added files and diffs—against an upstream Git repository.
+
+## Quick Start
+
+Run this command to initialize a new patch project:
+
+```sh
+patchy init
+```
+
+This will set up the necessary directory structure and configuration file for your patch workflow.
+
+## Directory Structure
+
+```
+my-patch-repo/
+├── patches/
+│   ├── path/in/repo/newFile.ts          # new file
+│   ├── path/in/repo/oldFile.ts.diff     # diff file
+├── patchy.json                          # optional config
+
+repo-dir/
+├── path/in/repo/newFile.ts              # will be copied from patches/
+├── path/in/repo/oldFile.ts              # original file, to be patched
+```
+
+File layout must mirror the structure of `repo_dir`.
+
+## Installation
+
+**Install script (recommended):**
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/richardgill/patchy/main/install | bash
+```
+
+**Via npm:**
+
+```sh
+npm install -g patchy-cli
+```
+
+Or use directly without installing:
+
+```sh
+npx patchy-cli --version
+```
+
+## Shared Flags
+
+These flags are accepted by **all commands**:
+
+| CLI Flag          | Env Variable           | Description                                      |
+| ----------------- | ---------------------- | ------------------------------------------------ |
+| `--repo-dir`      | `PATCHY_REPO_DIR`      | Path to the Git repo you're patching             |
+| `--repo-base-dir` | `PATCHY_REPO_BASE_DIR` | Parent directory where upstream repos are cloned |
+| `--patches-dir`   | `PATCHY_PATCHES_DIR`   | Path to your patch files (default: `./patches/`) |
+| `--config`        | `PATCHY_CONFIG`        | JSON config file (default: `patchy.json`)        |
+| `--verbose`       | `PATCHY_VERBOSE`       | Enable verbose log output                        |
+| `--dry-run`       | `PATCHY_DRY_RUN`       | Simulate the command without writing files       |
+
+> CLI flags override all values in `patchy.json`.
+
+## Commands
+
+### `patchy apply`
+
+Apply patch files from `patches/` into `repo_dir`.
+
+```sh
+patchy apply [--repo-dir] [--patches-dir] [--dry-run]
+```
+
+### `patchy generate`
+
+Generate `.diff` files and new full files into `./patches/` based on current `git diff` in `repo_dir`.
+
+```sh
+patchy generate [--repo-dir] [--patches-dir] [--dry-run]
+```
+
+### `patchy repo reset`
+
+Hard reset the Git working tree of `repo_dir`. Discards local changes.
+
+```sh
+patchy repo reset [--repo-dir]
+```
+
+### `patchy repo checkout --ref <git-ref>`
+
+Check out a specific Git ref (branch, tag, or SHA) in `repo_dir`.
+
+```sh
+patchy repo checkout --ref main [--repo-dir]
+```
+
+### `patchy repo clone --url <git-url>`
+
+Clone a repository into a subdirectory of `repo_base_dir`. The target directory is derived from the repo name.
+
+```sh
+patchy repo clone [--repo-base-dir] [--ref] [--repo-url] 
+```
+
+## Configuration (`patchy.json`)
+
+Optional file to set default values:
+
+```json
+{
+  "repo_url": "https://github.com/richardgill/upstream.git",
+  "repo_dir": "upstream-repo",
+  "repo_base_dir": "../clones",
+  "patches_dir": "patches/",
+  "ref": "main"
+}
+```
+
+All options may be set with environment variables as well e.g. `PATCHY_REPO_URL`.
+
+### Precedence Order
+
+1. CLI flags
+2. Environment variables
+3. `--config` (defaults to `./patchy.json`)
+
+## Example Workflow
+
+```sh
+# Clone the upstream repo
+patchy repo clone --repo-url https://github.com/richardgill/upstream.git --repo-base-dir ../clones
+
+# Check out upstream repo at a specific version
+patchy repo checkout --ref v1.2.3 --repo-dir ../clones/upstream
+
+# Generate patches from current state of repo_dir
+patchy generate --repo-dir ../clones/upstream
+
+# Later, apply patches cleanly to fresh repo
+patchy repo reset --repo-dir ../clones/upstream
+patchy repo checkout --ref main --repo-dir upstream
+patchy apply --repo-dir ../clones/upstream
+```
+
+## License
+
+MIT

package/bin/patchy.cjs

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+const childProcess = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const run = (target) => {
+  const result = childProcess.spawnSync(target, process.argv.slice(2), {
+    stdio: "inherit",
+  });
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+  const code = typeof result.status === "number" ? result.status : 0;
+  process.exit(code);
+};
+
+const envPath = process.env.PATCHY_BIN_PATH;
+if (envPath) {
+  run(envPath);
+}
+
+const scriptPath = fs.realpathSync(__filename);
+const scriptDir = path.dirname(scriptPath);
+
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+};
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+};
+
+let platform = platformMap[os.platform()];
+if (!platform) {
+  platform = os.platform();
+}
+let arch = archMap[os.arch()];
+if (!arch) {
+  arch = os.arch();
+}
+
+const base = "patchy-cli-" + platform + "-" + arch;
+const binary = platform === "windows" ? "patchy.exe" : "patchy";
+
+const findBinary = (startDir) => {
+  let current = startDir;
+  for (;;) {
+    const modules = path.join(current, "node_modules");
+    if (fs.existsSync(modules)) {
+      const entries = fs.readdirSync(modules);
+      for (const entry of entries) {
+        if (!entry.startsWith(base)) {
+          continue;
+        }
+        const candidate = path.join(modules, entry, "bin", binary);
+        if (fs.existsSync(candidate)) {
+          return candidate;
+        }
+      }
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      return;
+    }
+    current = parent;
+  }
+};
+
+const resolved = findBinary(scriptDir);
+if (!resolved) {
+  console.error(
+    'Could not find the patchy binary for your platform. Try manually installing "' +
+      base +
+      '"',
+  );
+  process.exit(1);
+}
+
+run(resolved);

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "patchy-cli",
+  "version": "0.0.2-pr.115.296bb27",
+  "description": "A CLI tool for managing Git patch workflows.",
+  "type": "module",
+  "bin": {
+    "patchy": "./bin/patchy.cjs"
+  },
+  "files": [
+    "bin"
+  ],
+  "scripts": {
+    "build": "bun run ./scripts/build.ts",
+    "build-single": "bun run ./scripts/build.ts --single",
+    "check": "biome check --error-on-warnings --diagnostic-level=warn",
+    "check-fix": "biome check --write --error-on-warnings --diagnostic-level=warn",
+    "changeset": "changeset",
+    "changeset-version": "changeset version",
+    "dev": "bun run src/cli.ts",
+    "local-ci": "concurrently --group -p none -n 'check,typecheck,test' 'bun run check-fix' 'bun run typecheck' 'bun run test'",
+    "prepare": "[ -n \"$CI\" ] || lefthook install",
+    "typecheck": "tsgo --noEmit",
+    "test": "bun run scripts/test.ts",
+    "test-watch": "bun test --watch",
+    "test-coverage": "bun test --coverage"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.1.1",
+    "@changesets/changelog-github": "^0.5.1",
+    "@changesets/cli": "^2.29.5",
+    "@types/node": "^24.0.13",
+    "@typescript/native-preview": "7.0.0-dev.20250712.1",
+    "bun-types": "^1.3.4",
+    "concurrently": "^9.2.0",
+    "lefthook": "^1.12.2",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "@stricli/core": "^1.2.0",
+    "chalk": "^5.4.1",
+    "diff": "^8.0.2",
+    "es-toolkit": "^1.39.8",
+    "jsonc-parser": "^3.3.1",
+    "simple-git": "^3.30.0",
+    "ts-essentials": "^10.1.1",
+    "zod": "^4.0.13"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.4"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "url": "https://github.com/richardgill/patchy"
+  },
+  "optionalDependencies": {
+    "patchy-cli-linux-x64": "0.0.2-pr.115.296bb27",
+    "patchy-cli-linux-arm64": "0.0.2-pr.115.296bb27",
+    "patchy-cli-darwin-x64": "0.0.2-pr.115.296bb27",
+    "patchy-cli-darwin-arm64": "0.0.2-pr.115.296bb27",
+    "patchy-cli-windows-x64": "0.0.2-pr.115.296bb27"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "bun@1.3.4"
+}