@gogd-core/ggd 0.1.4 → 0.1.9

package/README.md

@@ -0,0 +1,151 @@
+# @gogd-core/ggd
+
+GoGoodDev workspace CLI — a unified command-line tool for environment management, git workflows, and Jenkins CI integration.
+
+## Install
+
+```bash
+npm install -g @gogd-core/ggd
+```
+
+Shell tab-completion is auto-installed on `npm install -g` (bash, zsh, powershell).
+
+## Requirements
+
+- Node.js 20+
+
+## Commands
+
+### `ggd env` — Environment Management
+
+```bash
+ggd env use <name>    # Switch to a named environment
+```
+
+### `ggd run` — Execute Shell Commands
+
+```bash
+ggd run <command...>  # Run any shell command via cross-platform executor
+```
+
+### `ggd rsh` — Git Reset Hard (Safe)
+
+Reset current branch to `origin/<branch>` with safety checks.
+
+```bash
+ggd rsh
+```
+
+Shows current branch name and uncommitted change count before prompting for confirmation. Prevents accidental data loss.
+
+### `ggd mt` — Merge Tool
+
+Merge current branch into a target branch with automatic branch management.
+
+```bash
+ggd mt <target-branch>
+```
+
+Switches to the target branch (re-creates from origin if it exists locally), then merges the source branch with confirmation.
+
+### `ggd jenkins` — Jenkins CI Integration
+
+Trigger and monitor Jenkins builds from the terminal.
+
+#### Setup
+
+```bash
+# Interactive setup (manual entry)
+ggd jenkins setup
+
+# Setup with a team preset file (recommended)
+ggd jenkins setup --preset <path-to-preset.json>
+```
+
+Saves config to `~/.ggd/jenkins.json`. Re-running setup preserves existing values.
+
+#### Build
+
+```bash
+# List available build targets
+ggd jenkins build
+
+# Trigger a build with defaults
+ggd jenkins build <target>
+
+# Override parameters
+ggd jenkins build <target> --KEY=value --KEY2=value2
+
+# Trigger without watching (detached mode)
+ggd jenkins build <target> --detach
+```
+
+The build command will:
+1. Trigger the Jenkins job via REST API (with CSRF crumb support)
+2. Poll the queue until the build starts
+3. Stream console output (last 5 lines) in real-time
+4. Send a desktop notification when done (Windows/macOS/Linux)
+
+Use `--help` to see all targets with their default parameters:
+
+```bash
+ggd jenkins build --help
+```
+
+#### View Config
+
+```bash
+ggd jenkins config    # Print current config as JSON
+```
+
+### `ggd completion` — Shell Completion
+
+Tab-completion is auto-installed globally. To manually output the script:
+
+```bash
+ggd completion          # Auto-detect shell
+ggd completion bash
+ggd completion zsh
+ggd completion powershell
+```
+
+## Preset Files
+
+Teams can share Jenkins configuration via preset files. These are JSON files that define environments, job paths, and build targets:
+
+```json
+{
+  "url": "http://jenkins.example.com",
+  "environments": {
+    "staging": {
+      "ui": "staging/job/frontend",
+      "api": "staging/job/api"
+    },
+    "production": {
+      "ui": "production/job/frontend",
+      "api": "production/job/api"
+    }
+  },
+  "targets": [
+    {
+      "name": "ui",
+      "displayName": "UI (Frontend)",
+      "jobPathKey": "ui",
+      "defaults": {
+        "COMMIT_HASH": "a-staging",
+        "SITE": "acc"
+      }
+    }
+  ]
+}
+```
+
+Load with: `ggd jenkins setup --preset <file>`
+
+## Configuration
+
+All config is stored at `~/.ggd/jenkins.json`. No environment variables required.
+
+## License
+
+Private

package/main.js

@@ -603,7 +603,41 @@ function createJenkinsCommand() {
   jenkins.command("setup").description("Configure Jenkins connection and environment").option("-p, --preset <path>", "Load configuration from a preset JSON file").action(async (opts) => {
     await runSetup(opts.preset);
   });
-  jenkins.command("build").description("Trigger a Jenkins build").argument("[target]", "Build target name").option("-d, --detach", "Run in detached mode (don't watch build)").allowUnknownOption(true).action(async (targetName, opts, cmd) => {
+  const buildCmd = new import_commander5.Command("build").description("Trigger a Jenkins build").argument("[target]", "Build target name").option("-d, --detach", "Run in detached mode (don't watch build)").allowUnknownOption(true);
+  buildCmd.addHelpText("after", () => {
+    const config = readConfig();
+    if (!config || config.targets.length === 0) {
+      return "\nNo build targets configured. Run: ggd jenkins setup --preset <file>";
+    }
+    const buildIdx = process.argv.indexOf("build");
+    const targetArg = buildIdx !== -1 ? process.argv.slice(buildIdx + 1).find((a) => !a.startsWith("-")) : void 0;
+    const specificTarget = targetArg ? findTarget(targetArg, config.targets) : void 0;
+    if (specificTarget) {
+      let text2 = `
+${specificTarget.displayName} (${specificTarget.name}) parameters:
+`;
+      for (const [k, v] of Object.entries(specificTarget.defaults)) {
+        text2 += `  --${k.padEnd(42)} [default: ${v || "<empty>"}]
+`;
+      }
+      text2 += `
+Override: ggd jenkins build ${specificTarget.name} --KEY=value`;
+      return text2;
+    }
+    let text = "\nAvailable build targets:\n";
+    for (const t of config.targets) {
+      text += `
+  ${t.name.padEnd(20)} ${t.displayName}
+`;
+      for (const [k, v] of Object.entries(t.defaults)) {
+        text += `    --${k.padEnd(42)} [default: ${v || "<empty>"}]
+`;
+      }
+    }
+    text += "\nOverride any default: ggd jenkins build <target> --KEY=value";
+    return text;
+  });
+  buildCmd.action(async (targetName, opts, cmd) => {
     const config = await ensureConfig();
     if (!config)
       return;
@@ -667,6 +701,7 @@ Usage: ggd jenkins build <target> [--KEY=value ...]`);
       process.exitCode = 1;
     }
   });
+  jenkins.addCommand(buildCmd);
   jenkins.command("config").description("Show current Jenkins configuration").action(async () => {
     const config = await ensureConfig();
     if (!config)
@@ -771,6 +806,16 @@ program.addCommand(createRshCommand());
 program.addCommand(createMtCommand());
 program.addCommand(createJenkinsCommand());
 program.addCommand(createCompletionCommand());
+var ALIASES = {
+  jb: ["jenkins", "build"]
+};
+var cmdIdx = process.argv.findIndex((_, i) => i >= 2 && !process.argv[i]?.startsWith("-"));
+if (cmdIdx !== -1) {
+  const expansion = ALIASES[process.argv[cmdIdx]];
+  if (expansion) {
+    process.argv.splice(cmdIdx, 1, ...expansion);
+  }
+}
 if (process.argv.includes("--get-completions")) {
   const args = process.argv.slice(process.argv.indexOf("--get-completions") + 1);
   const suggestions = getCompletions(program, args);

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@gogd-core/ggd",
-  "version": "0.1.4",
+  "version": "0.1.9",
+  "description": "GoGoodDev workspace CLI",
+  "bin": {
+    "ggd": "./main.js"
+  },
+  "license": "MIT",
   "dependencies": {
     "commander": "12.1.0",
     "execa": "5.1.1"
   },
   "main": "./main.js",
   "type": "commonjs",
-  "bin": {
-    "ggd": "./main.js"
-  },
-  "scripts": {
-    "postinstall": "node ./postinstall.js"
-  },
-  "description": "GoGoodDev workspace CLI",
   "repository": {
     "type": "git",
     "url": "https://github.com/andaman-nr/gogooddev.workspace.git"
   },
-  "license": "MIT"
+  "scripts": {
+    "postinstall": "node ./postinstall.js"
+  }
 }

package/src/index.d.ts

@@ -1,2 +1,10 @@
 export { createEnvCommand, createRunCommand, createCompletionCommand } from './commands';
 export { exec, isWindows, defaultShell } from './core';
+export { getCurrentBranch, getUncommittedChangeCount, resetHard } from './commands/git/rsh';
+export { localBranchExists, deleteLocalBranch, switchBranch, mergeBranch, pushBranch } from './commands/git/mt';
+export { readConfig, writeConfig, getConfigPath, maskToken } from './commands/jenkins/jenkins';
+export type { JenkinsConfig, JenkinsJobPaths } from './commands/jenkins/jenkins';
+export { findTarget, listTargetNames, parseOverrides, mergeParams, resolveJobPath, triggerBuild, waitForBuild, watchBuild, } from './commands/jenkins/jenkins-build';
+export type { BuildTarget } from './commands/jenkins/jenkins-build';
+export { loadPresetFile } from './commands/jenkins/jenkins-presets';
+export type { JenkinsPreset } from './commands/jenkins/jenkins-presets';