@dleangen/cage-git 0.0.1

package/README.md

@@ -0,0 +1,360 @@
+# @dleangen/cage-git
+
+Git workflow mechanics for CAGE projects.
+
+<!-- commands -->
+* [`cage-git help [COMMAND]`](#cage-git-help-command)
+* [`cage-git land`](#cage-git-land)
+* [`cage-git plugins`](#cage-git-plugins)
+* [`cage-git plugins add PLUGIN`](#cage-git-plugins-add-plugin)
+* [`cage-git plugins:inspect PLUGIN...`](#cage-git-pluginsinspect-plugin)
+* [`cage-git plugins install PLUGIN`](#cage-git-plugins-install-plugin)
+* [`cage-git plugins link PATH`](#cage-git-plugins-link-path)
+* [`cage-git plugins remove [PLUGIN]`](#cage-git-plugins-remove-plugin)
+* [`cage-git plugins reset`](#cage-git-plugins-reset)
+* [`cage-git plugins uninstall [PLUGIN]`](#cage-git-plugins-uninstall-plugin)
+* [`cage-git plugins unlink [PLUGIN]`](#cage-git-plugins-unlink-plugin)
+* [`cage-git plugins update`](#cage-git-plugins-update)
+
+## `cage-git help [COMMAND]`
+
+Display help for cage-git.
+
+```
+USAGE
+  $ cage-git help [COMMAND...] [-n]
+
+ARGUMENTS
+  [COMMAND...]  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
+
+DESCRIPTION
+  Display help for cage-git.
+```
+
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.50/src/commands/help.ts)_
+
+## `cage-git land`
+
+Safe, inspect-before-merge branch landing
+
+```
+USAGE
+  $ cage-git land --from <value> --into <value> [--accept | --analyze | --preview | --reject | --cleanup]
+    [--force]
+
+FLAGS
+  --accept        Merge landing branch into target
+  --analyze       Preflight analysis (read-only)
+  --cleanup       Delete backup branch if present
+  --force         Bypass pushed-branch guard (--preview only)
+  --from=<value>  (required) Branch to land
+  --into=<value>  (required) Target branch to land into
+  --preview       Create landing branch with cherry-picked commits
+  --reject        Discard landing branch; leave original untouched
+
+DESCRIPTION
+  Safe, inspect-before-merge branch landing
+
+EXAMPLES
+  $ cage-git land --from feat/foo --into main --analyze
+
+  $ cage-git land --from feat/foo --into main --preview
+
+  $ cage-git land --from feat/foo --into main --accept
+```
+
+_See code: [src/commands/land.ts](https://github.com/dleangen/cage-git/blob/v0.0.1/src/commands/land.ts)_
+
+## `cage-git plugins`
+
+List installed plugins.
+
+```
+USAGE
+  $ cage-git plugins [--json] [--core]
+
+FLAGS
+  --core  Show core plugins.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List installed plugins.
+
+EXAMPLES
+  $ cage-git plugins
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/index.ts)_
+
+## `cage-git plugins add PLUGIN`
+
+Installs a plugin into cage-git.
+
+```
+USAGE
+  $ cage-git plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into cage-git.
+
+  Uses npm to install plugins.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the CAGE_GIT_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the CAGE_GIT_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ cage-git plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ cage-git plugins add myplugin
+
+  Install a plugin from a github url.
+
+    $ cage-git plugins add https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ cage-git plugins add someuser/someplugin
+```
+
+## `cage-git plugins:inspect PLUGIN...`
+
+Displays installation properties of a plugin.
+
+```
+USAGE
+  $ cage-git plugins inspect PLUGIN...
+
+ARGUMENTS
+  PLUGIN...  [default: .] Plugin to inspect.
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Displays installation properties of a plugin.
+
+EXAMPLES
+  $ cage-git plugins inspect myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/inspect.ts)_
+
+## `cage-git plugins install PLUGIN`
+
+Installs a plugin into cage-git.
+
+```
+USAGE
+  $ cage-git plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into cage-git.
+
+  Uses npm to install plugins.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the CAGE_GIT_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the CAGE_GIT_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ cage-git plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ cage-git plugins install myplugin
+
+  Install a plugin from a github url.
+
+    $ cage-git plugins install https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ cage-git plugins install someuser/someplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/install.ts)_
+
+## `cage-git plugins link PATH`
+
+Links a plugin into the CLI for development.
+
+```
+USAGE
+  $ cage-git plugins link PATH [-h] [--install] [-v]
+
+ARGUMENTS
+  PATH  [default: .] path to plugin
+
+FLAGS
+  -h, --help          Show CLI help.
+  -v, --verbose
+      --[no-]install  Install dependencies after linking the plugin.
+
+DESCRIPTION
+  Links a plugin into the CLI for development.
+
+  Installation of a linked plugin will override a user-installed or core plugin.
+
+  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
+  command will override the user-installed or core plugin implementation. This is useful for development work.
+
+
+EXAMPLES
+  $ cage-git plugins link myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/link.ts)_
+
+## `cage-git plugins remove [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ cage-git plugins remove [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  [PLUGIN...]  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ cage-git plugins unlink
+  $ cage-git plugins remove
+
+EXAMPLES
+  $ cage-git plugins remove myplugin
+```
+
+## `cage-git plugins reset`
+
+Remove all user-installed and linked plugins.
+
+```
+USAGE
+  $ cage-git plugins reset [--hard] [--reinstall]
+
+FLAGS
+  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
+  --reinstall  Reinstall all plugins after uninstalling.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/reset.ts)_
+
+## `cage-git plugins uninstall [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ cage-git plugins uninstall [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  [PLUGIN...]  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ cage-git plugins unlink
+  $ cage-git plugins remove
+
+EXAMPLES
+  $ cage-git plugins uninstall myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/uninstall.ts)_
+
+## `cage-git plugins unlink [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ cage-git plugins unlink [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  [PLUGIN...]  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ cage-git plugins unlink
+  $ cage-git plugins remove
+
+EXAMPLES
+  $ cage-git plugins unlink myplugin
+```
+
+## `cage-git plugins update`
+
+Update installed plugins.
+
+```
+USAGE
+  $ cage-git plugins update [-h] [-v]
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Update installed plugins.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.74/src/commands/plugins/update.ts)_
+<!-- commandsstop -->

package/bin/dev.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node_modules/.bin/ts-node
+
+// eslint-disable-next-line unicorn/prefer-top-level-await
+;(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({development: true, dir: __dirname})
+})()

package/bin/run.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+// eslint-disable-next-line unicorn/prefer-top-level-await
+(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({dir: __dirname})
+})()

package/dist/commands/land.d.ts

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+export default class Land extends Command {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        accept: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        analyze: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        cleanup: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        from: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        into: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        preview: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        reject: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private runAccept;
+    private runAnalyze;
+    private runCleanup;
+    private runPreview;
+    private runReject;
+}

package/dist/commands/land.js

@@ -0,0 +1,250 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+function git(args, cwd = process.cwd()) {
+    return (0, node_child_process_1.execSync)(`git ${args}`, { cwd, encoding: 'utf8' }).trim();
+}
+function gitSafe(args, cwd = process.cwd()) {
+    try {
+        return git(args, cwd);
+    }
+    catch {
+        return null;
+    }
+}
+function isDirty(cwd = process.cwd()) {
+    return git('status --porcelain --untracked-files=no', cwd) !== '';
+}
+function branchExists(branch, cwd = process.cwd()) {
+    return gitSafe(`rev-parse --verify ${branch}`, cwd) !== null;
+}
+function mergeBase(from, into, cwd = process.cwd()) {
+    return git(`merge-base ${from} ${into}`, cwd);
+}
+function anchorDir(cwd = process.cwd()) {
+    return node_path_1.default.join(cwd, '.cage', 'land');
+}
+function anchorPath(from, cwd = process.cwd()) {
+    return node_path_1.default.join(anchorDir(cwd), `${from}.preview-base`);
+}
+function ensureAnchorDir(cwd = process.cwd()) {
+    fs.mkdirSync(anchorDir(cwd), { recursive: true });
+}
+class Land extends core_1.Command {
+    static args = {};
+    static description = 'Safe, inspect-before-merge branch landing';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --from feat/foo --into main --analyze',
+        '<%= config.bin %> <%= command.id %> --from feat/foo --into main --preview',
+        '<%= config.bin %> <%= command.id %> --from feat/foo --into main --accept',
+    ];
+    static flags = {
+        accept: core_1.Flags.boolean({ description: 'Merge landing branch into target', exclusive: ['analyze', 'preview', 'reject', 'cleanup'] }),
+        analyze: core_1.Flags.boolean({ description: 'Preflight analysis (read-only)', exclusive: ['preview', 'accept', 'reject', 'cleanup'] }),
+        cleanup: core_1.Flags.boolean({ description: 'Delete backup branch if present', exclusive: ['analyze', 'preview', 'accept', 'reject'] }),
+        force: core_1.Flags.boolean({ description: 'Bypass pushed-branch guard (--preview only)' }),
+        from: core_1.Flags.string({ description: 'Branch to land', required: true }),
+        into: core_1.Flags.string({ description: 'Target branch to land into', required: true }),
+        preview: core_1.Flags.boolean({ description: 'Create landing branch with cherry-picked commits', exclusive: ['analyze', 'accept', 'reject', 'cleanup'] }),
+        reject: core_1.Flags.boolean({ description: 'Discard landing branch; leave original untouched', exclusive: ['analyze', 'preview', 'accept', 'cleanup'] }),
+    };
+    async run() {
+        const { flags } = await this.parse(Land);
+        const { force, from, into } = flags;
+        const modeCount = [flags.analyze, flags.preview, flags.accept, flags.reject, flags.cleanup].filter(Boolean).length;
+        if (modeCount === 0) {
+            this.error('Exactly one mode is required: --analyze, --preview, --accept, --reject, or --cleanup');
+        }
+        const cwd = process.cwd();
+        if (flags.analyze)
+            return this.runAnalyze(from, into, cwd);
+        if (flags.preview)
+            return this.runPreview(from, into, force, cwd);
+        if (flags.accept)
+            return this.runAccept(from, into, cwd);
+        if (flags.reject)
+            return this.runReject(from, cwd);
+        if (flags.cleanup)
+            return this.runCleanup(from, cwd);
+    }
+    runAccept(from, into, cwd) {
+        // Dirty-tree gate
+        if (isDirty(cwd)) {
+            this.error('Working tree is dirty. Commit or stash changes before running --accept.');
+        }
+        const landingBranch = `${from}-landing`;
+        // Landing branch must exist
+        if (!branchExists(landingBranch, cwd)) {
+            this.error(`Landing branch '${landingBranch}' does not exist. Run --preview first.`);
+        }
+        // Drift guard
+        const anchor = anchorPath(from, cwd);
+        if (fs.existsSync(anchor)) {
+            const previewBase = fs.readFileSync(anchor, 'utf8').trim();
+            const currentTip = git(`rev-parse ${into}`, cwd);
+            if (previewBase !== currentTip) {
+                this.error(`Target '${into}' has moved since --preview. Run --reject then --preview again.`);
+            }
+        }
+        // Merge
+        git(`checkout ${into}`, cwd);
+        git(`merge --no-ff ${landingBranch} -m "Merge branch '${from}' into ${into}"`, cwd);
+        // Clean up
+        git(`branch -D ${landingBranch}`, cwd);
+        if (fs.existsSync(anchor))
+            fs.unlinkSync(anchor);
+        const tip = git(`rev-parse --short HEAD`, cwd);
+        this.log(`Branch '${from}' landed into '${into}'. Tip: ${tip}`);
+    }
+    runAnalyze(from, into, cwd) {
+        const base = mergeBase(from, into, cwd);
+        // Commits to land
+        const commits = gitSafe(`log --oneline ${into}..${from}`, cwd) ?? '';
+        this.log('\nCommits to land:');
+        this.log(commits || '  (none)');
+        // Drift distance
+        const driftCount = Number(git(`rev-list --count ${base}..${into}`, cwd));
+        this.log(`\nDrift distance: ${driftCount} commit(s) on ${into} since fork`);
+        if (driftCount > 0) {
+            this.log(`  Warning: ${into} has advanced ${driftCount} commit(s) since the fork point.`);
+        }
+        // File overlap
+        const targetFiles = new Set(git(`diff --name-only ${base} ${into}`, cwd).split('\n').filter(Boolean));
+        const branchFiles = new Set(git(`diff --name-only ${base} ${from}`, cwd).split('\n').filter(Boolean));
+        const overlap = [...targetFiles].filter((f) => branchFiles.has(f));
+        if (overlap.length > 0) {
+            this.log('\nFile overlap (potential conflicts):');
+            for (const f of overlap)
+                this.log(`  ${f}`);
+        }
+        else {
+            this.log('\nNo file overlap detected.');
+        }
+        // Remote status
+        const fromRemote = gitSafe(`rev-parse --verify origin/${from}`, cwd) !== null;
+        const intoRemote = gitSafe(`rev-parse --verify origin/${into}`, cwd) !== null;
+        this.log(`\nRemote tracking: ${from}=${fromRemote ? 'yes' : 'no'}, ${into}=${intoRemote ? 'yes' : 'no'}`);
+    }
+    runCleanup(from, cwd) {
+        const backupBranch = `${from}-backup`;
+        let cleaned = false;
+        if (branchExists(backupBranch, cwd)) {
+            git(`branch -D ${backupBranch}`, cwd);
+            this.log(`Deleted backup branch '${backupBranch}'.`);
+            cleaned = true;
+        }
+        const anchor = anchorPath(from, cwd);
+        if (fs.existsSync(anchor)) {
+            fs.unlinkSync(anchor);
+            this.log(`Removed stale drift anchor for '${from}'.`);
+            cleaned = true;
+        }
+        if (!cleaned) {
+            this.log('Nothing to clean up.');
+        }
+    }
+    runPreview(from, into, force, cwd) {
+        // Dirty-tree gate
+        if (isDirty(cwd)) {
+            this.error('Working tree is dirty. Commit or stash changes before running --preview.');
+        }
+        // Pushed-branch guard
+        if (!force && gitSafe(`rev-parse --verify origin/${from}`, cwd) !== null) {
+            this.error(`Branch '${from}' has a remote-tracking ref (origin/${from}). ` +
+                `Use --force to bypass this guard.`);
+        }
+        const landingBranch = `${from}-landing`;
+        // Abort if landing branch already exists
+        if (branchExists(landingBranch, cwd)) {
+            this.error(`Landing branch '${landingBranch}' already exists. Run --reject first.`);
+        }
+        const base = mergeBase(from, into, cwd);
+        // Record drift anchor
+        ensureAnchorDir(cwd);
+        const gitignorePath = node_path_1.default.join(cwd, '.gitignore');
+        const gitignored = fs.existsSync(gitignorePath) &&
+            fs.readFileSync(gitignorePath, 'utf8').split('\n').some((line) => line.trim() === '.cage' || line.trim() === '.cage/');
+        if (!gitignored) {
+            this.warn('`.cage/` is not in .gitignore — drift anchors may be accidentally committed.');
+        }
+        const targetTip = git(`rev-parse ${into}`, cwd);
+        fs.writeFileSync(anchorPath(from, cwd), targetTip);
+        // Create landing branch
+        git(`checkout -b ${landingBranch} ${into}`, cwd);
+        // Cherry-pick
+        try {
+            git(`cherry-pick ${base}..${from}`, cwd);
+        }
+        catch {
+            this.log(`Cherry-pick conflict on '${landingBranch}'.\n` +
+                `Resolve conflicts, then:\n` +
+                `  git cherry-pick --continue\n` +
+                `Or abort with:\n` +
+                `  git cherry-pick --abort && cage land --from ${from} --into ${into} --reject`);
+            this.exit(1);
+        }
+        // Return to target branch — leaves repo in a predictable state for --reject/--accept
+        git(`checkout ${into}`, cwd);
+        this.log(`Landing branch '${landingBranch}' created.`);
+        this.log(`Inspect with: git diff ${into}..${landingBranch}`);
+    }
+    runReject(from, cwd) {
+        const landingBranch = `${from}-landing`;
+        let cleaned = false;
+        if (branchExists(landingBranch, cwd)) {
+            git(`branch -D ${landingBranch}`, cwd);
+            cleaned = true;
+        }
+        const anchor = anchorPath(from, cwd);
+        if (fs.existsSync(anchor)) {
+            fs.unlinkSync(anchor);
+            cleaned = true;
+        }
+        if (cleaned) {
+            this.log(`Landing branch '${landingBranch}' discarded. '${from}' is untouched.`);
+        }
+        else {
+            this.log(`Nothing to reject — '${landingBranch}' did not exist.`);
+        }
+    }
+}
+exports.default = Land;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var core_1 = require("@oclif/core");
+Object.defineProperty(exports, "run", { enumerable: true, get: function () { return core_1.run; } });

package/oclif.manifest.json

@@ -0,0 +1,113 @@
+{
+  "commands": {
+    "land": {
+      "aliases": [],
+      "args": {},
+      "description": "Safe, inspect-before-merge branch landing",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --from feat/foo --into main --analyze",
+        "<%= config.bin %> <%= command.id %> --from feat/foo --into main --preview",
+        "<%= config.bin %> <%= command.id %> --from feat/foo --into main --accept"
+      ],
+      "flags": {
+        "accept": {
+          "description": "Merge landing branch into target",
+          "exclusive": [
+            "analyze",
+            "preview",
+            "reject",
+            "cleanup"
+          ],
+          "name": "accept",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "analyze": {
+          "description": "Preflight analysis (read-only)",
+          "exclusive": [
+            "preview",
+            "accept",
+            "reject",
+            "cleanup"
+          ],
+          "name": "analyze",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cleanup": {
+          "description": "Delete backup branch if present",
+          "exclusive": [
+            "analyze",
+            "preview",
+            "accept",
+            "reject"
+          ],
+          "name": "cleanup",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Bypass pushed-branch guard (--preview only)",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "from": {
+          "description": "Branch to land",
+          "name": "from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "into": {
+          "description": "Target branch to land into",
+          "name": "into",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "preview": {
+          "description": "Create landing branch with cherry-picked commits",
+          "exclusive": [
+            "analyze",
+            "accept",
+            "reject",
+            "cleanup"
+          ],
+          "name": "preview",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "reject": {
+          "description": "Discard landing branch; leave original untouched",
+          "exclusive": [
+            "analyze",
+            "preview",
+            "accept",
+            "cleanup"
+          ],
+          "name": "reject",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "land",
+      "pluginAlias": "@dleangen/cage-git",
+      "pluginName": "@dleangen/cage-git",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "land.js"
+      ]
+    }
+  },
+  "version": "0.0.1"
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@dleangen/cage-git",
+  "description": "Git workflow mechanics for CAGE projects.",
+  "version": "0.0.1",
+  "author": "dleangen",
+  "bin": {
+    "cage-git": "bin/run.js"
+  },
+  "bugs": "https://github.com/dleangen/cage-git/issues",
+  "dependencies": {
+    "@oclif/core": "^4",
+    "@oclif/plugin-help": "^6",
+    "@oclif/plugin-plugins": "^5"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1",
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@types/chai": "^4",
+    "@types/mocha": "^10",
+    "@types/node": "^18",
+    "chai": "^4",
+    "eslint": "^9",
+    "eslint-config-oclif": "^6",
+    "eslint-config-prettier": "^10",
+    "mocha": "^11",
+    "oclif": "^4",
+    "shx": "^0.3.3",
+    "ts-node": "^10",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "./bin",
+    "./dist",
+    "./oclif.manifest.json"
+  ],
+  "homepage": "https://github.com/dleangen/cage-git",
+  "keywords": [
+    "oclif",
+    "cage",
+    "git"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "oclif": {
+    "bin": "cage-git",
+    "dirname": "cage-git",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-plugins"
+    ],
+    "topicSeparator": " "
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dleangen/cage-git.git"
+  },
+  "scripts": {
+    "build": "shx rm -rf dist && tsc -b",
+    "lint": "eslint",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "npm run lint",
+    "prepack": "oclif manifest && oclif readme",
+    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
+    "version": "oclif readme && git add README.md"
+  },
+  "types": "dist/index.d.ts"
+}