ya-git-jira 2.0.0 → 2.1.0

package/.dockerignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+.git
+*.tsbuildinfo
+tests
+# Exclude .opencode except skills/ (needed by install-skills)
+.opencode/*
+!.opencode/skills

package/.opencode/skills/git-confluence/SKILL.md

@@ -5,7 +5,7 @@ description: Using git-confluence commands to search, read, and update Confluenc
 
 ## Overview
 
-`git-confluence` interacts with Confluence Cloud via its REST API v2.
+`gitj confluence` interacts with Confluence Cloud via its REST API v2.
 Authentication uses git config values with fallback to `jira.*` equivalents:
 
 ```sh
@@ -17,11 +17,11 @@ git config --global confluence.token your-api-token            # falls back to j
 ## Commands
 
 ```
-git-confluence whoami              Show current authenticated user
-git-confluence space list          List all spaces
-git-confluence page search <q>     Search pages (fuzzy title, --exact, or --full-text)
-git-confluence page show <id>      Show page metadata (add --body-format for content)
-git-confluence page update <id>    Update page content (from stdin or --file)
+gitj confluence whoami              Show current authenticated user
+gitj confluence space list          List all spaces
+gitj confluence page search <q>     Search pages (fuzzy title, --exact, or --full-text)
+gitj confluence page show <id>      Show page metadata (add --body-format for content)
+gitj confluence page update <id>    Update page content (from stdin or --file)
 ```
 
 Use `--help` on any command for options.
@@ -41,42 +41,42 @@ Use `--help` on any command for options.
 
 ```sh
 # 1. Find the page
-git-confluence page search "My Page Title"
+gitj confluence page search "My Page Title"
 
 # 2. Read content (outputs raw storage-format XHTML)
-git-confluence page show <id> --body-format storage --body-only > page.html
+gitj confluence page show <id> --body-format storage --body-only > page.html
 
 # 3. Edit page.html as needed (must remain valid storage format)
 
 # 4. Push the update
-git-confluence page update <id> --file page.html --message "Updated content"
+gitj confluence page update <id> --file page.html --message "Updated content"
 ```
 
 Content can also be piped via stdin:
 
 ```sh
-cat page.html | git-confluence page update <id>
+cat page.html | gitj confluence page update <id>
 ```
 
 ## Arbitrary Confluence API Access
 
-For operations not covered by the dedicated commands, use `git-api confluence`:
+For operations not covered by the dedicated commands, use `gitj api confluence`:
 
 ```sh
 # GET (default) -- path is relative to /wiki/api/v2
-git-api confluence /spaces
-git-api confluence /pages/12345
+gitj api confluence /spaces
+gitj api confluence /pages/12345
 
 # POST (auto-promoted when --data is provided)
-git-api confluence /pages -d '{"spaceId":"123","title":"New Page","body":{"representation":"storage","value":"<p>content</p>"},"status":"current"}'
+gitj api confluence /pages -d '{"spaceId":"123","title":"New Page","body":{"representation":"storage","value":"<p>content</p>"},"status":"current"}'
 
 # Paginated listing
-git-api confluence /spaces --paginate
+gitj api confluence /spaces --paginate
 
 # Skip /wiki/api/v2 prefix for v1 API access
-git-api confluence /wiki/rest/api/content/12345 --raw
+gitj api confluence /wiki/rest/api/content/12345 --raw
 ```
 
-`git-api` handles authentication and base URL automatically. It also supports
+`gitj api` handles authentication and base URL automatically. It also supports
 `-v` (status/headers to stderr), and exits with code 1 on HTTP 4xx/5xx.
-Run `git-api -h` for all options.
+Run `gitj api -h` for all options.

package/.opencode/skills/git-jira/SKILL.md

@@ -5,7 +5,7 @@ description: Using git-jira commands to work with Jira issues and branches
 
 ## Overview
 
-`git-jira` interacts with Jira Cloud via its REST API v3. Authentication uses
+`gitj jira` interacts with Jira Cloud via its REST API v3. Authentication uses
 git config values:
 
 ```sh
@@ -17,11 +17,11 @@ git config --global jira.token your-api-token
 ## Commands
 
 ```
-git-jira whoami              Show current Jira user
-git-jira issue list          List your unresolved issues (shortcut: git-jira list)
-git-jira issue show <key>    Show a single issue
-git-jira start <key>         Create a branch from an issue key + summary
-git-bump                     Increment the branch version suffix
+gitj jira whoami              Show current Jira user
+gitj jira issue list          List your unresolved issues (shortcut: gitj jira list)
+gitj jira issue show <key>    Show a single issue
+gitj jira start <key>         Create a branch from an issue key + summary
+gitj bump                     Increment the branch version suffix
 ```
 
 All dedicated commands are **read-only**. Use `--help` on any command for options.
@@ -29,9 +29,9 @@ All dedicated commands are **read-only**. Use `--help` on any command for option
 ## Workflow: Start Working on a Jira Issue
 
 ```sh
-git-jira issue list          # find your unresolved issues
-git-jira start PROJ-123      # creates and checks out a descriptive branch
-git-bump                     # re-branch with incremented suffix if needed
+gitj jira issue list          # find your unresolved issues
+gitj jira start PROJ-123      # creates and checks out a descriptive branch
+gitj bump                     # re-branch with incremented suffix if needed
 ```
 
 The `start` command only creates a local branch -- it does not push or
@@ -40,24 +40,24 @@ transition the Jira issue.
 ## Arbitrary Jira API Access
 
 The dedicated commands are read-only. For write operations (creating issues,
-transitions, comments, etc.), use `git-api jira`:
+transitions, comments, etc.), use `gitj api jira`:
 
 ```sh
 # GET (default) -- path is relative to /rest/api/3
-git-api jira /myself
-git-api jira /issue/PROJ-123
+gitj api jira /myself
+gitj api jira /issue/PROJ-123
 
 # POST (auto-promoted when --data is provided)
-git-api jira /issue -d '{"fields":{"project":{"key":"PROJ"},"summary":"New issue","issuetype":{"name":"Task"}}}'
+gitj api jira /issue -d '{"fields":{"project":{"key":"PROJ"},"summary":"New issue","issuetype":{"name":"Task"}}}'
 
 # Explicit method
-git-api jira /issue/PROJ-123 -X PUT -d '{"fields":{"summary":"Updated title"}}'
-git-api jira /issue/PROJ-123/transitions -d '{"transition":{"id":"31"}}'
+gitj api jira /issue/PROJ-123 -X PUT -d '{"fields":{"summary":"Updated title"}}'
+gitj api jira /issue/PROJ-123/transitions -d '{"transition":{"id":"31"}}'
 
 # Skip /rest/api/3 prefix for full URL control
-git-api jira /rest/api/2/myself --raw
+gitj api jira /rest/api/2/myself --raw
 ```
 
-`git-api` handles authentication and base URL automatically. It also supports
+`gitj api` handles authentication and base URL automatically. It also supports
 `--paginate`, `-v` (status/headers to stderr), and exits with code 1 on HTTP
-4xx/5xx. Run `git-api -h` for all options.
+4xx/5xx. Run `gitj api -h` for all options.

package/.opencode/skills/git-lab/SKILL.md

@@ -5,7 +5,7 @@ description: Using git-lab commands to work with GitLab projects, merge requests
 
 ## Overview
 
-`git-lab` interacts with GitLab via its REST API v4. Authentication uses git
+`gitj lab` interacts with GitLab via its REST API v4. Authentication uses git
 config values:
 
 ```sh
@@ -19,20 +19,20 @@ The token is sent as a `Private-Token` header. User identity is resolved from
 ## Commands
 
 ```
-git-lab whoami                     Show current GitLab user
-git-lab group list                 List groups
-git-lab namespace list             List namespaces
-git-lab project list [--match]     List projects (server + client-side filter)
-git-lab project whereami           Identify project from current git remote
-git-lab project mr list            List MRs for a project/branch (defaults to current)
-git-lab merge active               My open merge requests (across all projects)
-git-lab merge todo                 MRs where I'm assigned as reviewer
-git-lab merge train list           Merge trains for the current project
-git-lab project pipeline list      Recent pipelines (scoped to current user)
-git-lab project pipeline latest    Jobs for latest pipeline on current branch
-git-lab project pipeline jobs      Jobs for a specific pipeline
-git-lab project pipeline log       Download a job's log output (plain text)
-git-bump                           Increment branch version suffix
+gitj lab whoami                     Show current GitLab user
+gitj lab group list                 List groups
+gitj lab namespace list             List namespaces
+gitj lab project list [--match]     List projects (server + client-side filter)
+gitj lab project whereami           Identify project from current git remote
+gitj lab project mr list            List MRs for a project/branch (defaults to current)
+gitj lab merge active               My open merge requests (across all projects)
+gitj lab merge todo                 MRs where I'm assigned as reviewer
+gitj lab merge train list           Merge trains for the current project
+gitj lab project pipeline list      Recent pipelines (scoped to current user)
+gitj lab project pipeline latest    Jobs for latest pipeline on current branch
+gitj lab project pipeline jobs      Jobs for a specific pipeline
+gitj lab project pipeline log       Download a job's log output (plain text)
+gitj bump                           Increment branch version suffix
 ```
 
 All dedicated commands are **read-only**. Use `--help` on any command for
@@ -53,7 +53,7 @@ options and defaults.
 ### Find the MR for the current branch
 
 ```sh
-git-lab project mr list
+gitj lab project mr list
 ```
 
 Defaults to the current directory's project and current branch. Use
@@ -62,41 +62,41 @@ Defaults to the current directory's project and current branch. Use
 ### Debug a CI failure
 
 ```sh
-git-lab project pipeline latest              # see jobs for current branch
-git-lab project pipeline log --job <id>      # download the log
-git-lab project pipeline log --job <id> --tail 200   # last 200 lines
+gitj lab project pipeline latest              # see jobs for current branch
+gitj lab project pipeline log --job <id>      # download the log
+gitj lab project pipeline log --job <id> --tail 200   # last 200 lines
 ```
 
 ### Review merge requests
 
 ```sh
-git-lab merge todo       # MRs needing my review
-git-lab merge active     # my own open MRs
+gitj lab merge todo       # MRs needing my review
+gitj lab merge active     # my own open MRs
 ```
 
 ## Arbitrary GitLab API Access
 
 The dedicated commands are read-only. For write operations (approving MRs,
-posting comments, triggering pipelines, etc.), use `git-api gitlab`:
+posting comments, triggering pipelines, etc.), use `gitj api gitlab`:
 
 ```sh
 # GET (default) -- path is relative to /api/v4
-git-api gitlab /user
-git-api gitlab /projects/123/merge_requests
+gitj api gitlab /user
+gitj api gitlab /projects/123/merge_requests
 
 # POST (auto-promoted when --data is provided)
-git-api gitlab /projects/123/merge_requests/456/notes -d '{"body":"LGTM"}'
+gitj api gitlab /projects/123/merge_requests/456/notes -d '{"body":"LGTM"}'
 
 # Explicit method
-git-api gitlab /projects/123/merge_requests/456/approve -X POST
+gitj api gitlab /projects/123/merge_requests/456/approve -X POST
 
 # Paginated listing
-git-api gitlab /projects --paginate
+gitj api gitlab /projects --paginate
 
 # Skip /api/v4 prefix for full URL control
-git-api gitlab /api/v4/version --raw
+gitj api gitlab /api/v4/version --raw
 ```
 
-`git-api` handles authentication and base URL automatically. It also supports
+`gitj api` handles authentication and base URL automatically. It also supports
 `-v` (status/headers to stderr), and exits with code 1 on HTTP 4xx/5xx.
-Run `git-api -h` for all options.
+Run `gitj api -h` for all options.

package/Dockerfile

@@ -0,0 +1,58 @@
+# ya-git-jira Docker image
+# Provides gitj/git-jira/git-lab/git-confluence/git-bump commands
+# without requiring bun installed on the host.
+#
+# Build:
+#   docker build -t gitj .
+#
+# Usage:
+#   docker run --rm \
+#     --user "$(id -u):$(id -g)" \
+#     -e HOME="$HOME" \
+#     -v "$HOME:$HOME" \
+#     -v "$(pwd):$(pwd)" -w "$(pwd)" \
+#     gitj <command> [args...]
+#
+# Examples:
+#   docker run --rm --user "$(id -u):$(id -g)" -e HOME="$HOME" -v "$HOME:$HOME" -v "$(pwd):$(pwd)" -w "$(pwd)" gitj jira start
+#   docker run --rm --user "$(id -u):$(id -g)" -e HOME="$HOME" -v "$HOME:$HOME" -v "$(pwd):$(pwd)" -w "$(pwd)" gitj lab merge active
+
+FROM oven/bun:1 AS builder
+
+WORKDIR /build
+
+# Install dependencies first (cache layer)
+COPY package.json bun.lockb ./
+RUN bun install --frozen-lockfile --production --ignore-scripts
+
+# Copy source and build
+COPY build.ts index.ts tsconfig.json ./
+COPY bin/ bin/
+COPY lib/ lib/
+RUN bun run build.ts
+
+# --- Runtime stage ---
+FROM oven/bun:1-slim
+
+# git is required - the tool reads config from git and operates on repos
+RUN apt-get update && apt-get install -y --no-install-recommends git ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Copy built artifacts and dependencies
+COPY --from=builder /build/dist/ dist/
+COPY --from=builder /build/node_modules/ node_modules/
+COPY package.json ./
+
+# Include skill files so install-skills can copy them into projects
+COPY .opencode/skills/ .opencode/skills/
+
+# Symlink all bin entries onto PATH
+RUN mkdir -p /usr/local/bin && \
+    for f in dist/bin/*.js; do \
+        name=$(basename "$f" .js); \
+        ln -s /app/"$f" /usr/local/bin/"$name"; \
+    done
+
+ENTRYPOINT ["gitj"]

package/README.md

@@ -5,20 +5,39 @@ executable that `git` discovers automatically (e.g. `git jira start`, `git lab
 merge active`, `git confluence page search`). A unified `gitj` wrapper is also
 provided.
 
-## Requirements
+## Install
+
+There are three ways to install. Options 1 and 2 require
+[Bun](https://bun.sh). Option 3 requires only Docker.
 
-[Bun](https://bun.sh) (not Node.js):
+### Option 1: npm install (requires Bun)
 
 ```
-curl -fsSL https://bun.sh/install | bash
+curl -fsSL https://bun.sh/install | bash   # install Bun first
+npm install -g ya-git-jira                  # or bun / yarn / pnpm
 ```
 
-## Install
+### Option 2: Clone and build (requires Bun)
+
+```
+git clone https://github.com/jimlloyd/ya-git-jira.git
+cd ya-git-jira
+bun install
+bun link
+```
+
+### Option 3: Clone and Docker (no Bun needed)
 
 ```
-npm install -g ya-git-jira   # or bun / yarn / pnpm
+git clone https://github.com/jimlloyd/ya-git-jira.git
+cd ya-git-jira
+./install-docker-gitj.sh
 ```
 
+This builds a Docker image and installs a `gitj` wrapper script into a bin
+directory on your PATH (e.g. `~/.local/bin`). The wrapper transparently runs
+commands inside Docker, so usage is identical to a native install.
+
 ## Configuration
 
 All configuration is via `git config`. Use `--global` if the same settings apply
@@ -142,16 +161,16 @@ one-off queries and scripting.
 ### gitj install-skills
 
 ```
-gitj install-skills opencode       # symlinks to ~/.config/opencode/skills/
-gitj install-skills copilot        # symlinks to ~/.copilot/skills/
-gitj install-skills claude         # symlinks to .claude/skills/ (project-level)
-gitj install-skills opencode --copy   # copy instead of symlink
+gitj install-skills opencode       # copies to .opencode/skills/
+gitj install-skills copilot        # copies to .github/skills/
+gitj install-skills claude         # copies to .claude/skills/
 gitj install-skills opencode --force  # overwrite existing directories
 ```
 
-Installs AI agent skill files (`git-jira`, `git-lab`, `git-confluence`) so that
-coding assistants (OpenCode, GitHub Copilot, Claude Code) know how to use these
-tools.
+Skills are installed into the current project directory. Run this from your
+project root so that your AI coding assistant discovers the skill files. When
+running via Docker, files are always copied (symlinks would point into the
+container).
 
 ## AI agent skills
 

package/bin/gitj-install-skills.ts

@@ -6,7 +6,6 @@ import { findPackageJson } from '../lib/package'
 import { isMain } from '../lib/is_main'
 import fs from 'node:fs'
 import path from 'node:path'
-import os from 'node:os'
 
 const version = await getPackageVersion()
 
@@ -29,14 +28,14 @@ function getSkillsSourceDir(): string {
 }
 
 function getTargetDir(framework: Framework): string {
-    const home = os.homedir()
+    const cwd = process.cwd()
     switch (framework) {
         case 'opencode':
-            return path.join(home, '.config', 'opencode', 'skills')
+            return path.join(cwd, '.opencode', 'skills')
         case 'copilot':
-            return path.join(home, '.copilot', 'skills')
+            return path.join(cwd, '.github', 'skills')
         case 'claude':
-            return path.join(process.cwd(), '.claude', 'skills')
+            return path.join(cwd, '.claude', 'skills')
     }
 }
 
@@ -101,7 +100,7 @@ export function create(): Command {
         .name('install-skills')
         .description('Install AI agent skills for a coding framework')
         .argument('<framework>', `framework to install for (${frameworks.join(', ')})`)
-        .option('--copy', 'copy files instead of creating symlinks')
+        .option('--copy', 'copy files instead of creating symlinks (automatic in Docker)')
         .option('--force', 'overwrite existing skill directories')
         .action(async (framework: string, options: { copy?: boolean; force?: boolean }) => {
             if (!frameworks.includes(framework as Framework)) {
@@ -110,10 +109,16 @@ export function create(): Command {
                 process.exit(1)
             }
 
+            // When running in Docker, source files live inside the container
+            // so symlinks would be broken on the host. Force copy mode.
+            const sourceDir = getSkillsSourceDir()
+            const inDocker = sourceDir.startsWith('/app/')
+            const copy = !!(options.copy || inDocker)
+
             if (options.force) {
-                forceInstallSkills(framework as Framework, !!options.copy)
+                forceInstallSkills(framework as Framework, copy)
             } else {
-                installSkills(framework as Framework, !!options.copy)
+                installSkills(framework as Framework, copy)
             }
         })
     return program

package/install-docker-gitj.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+IMAGE_NAME="gitj"
+WRAPPER_NAME="gitj"
+
+# --- Find a writable bin directory on PATH under $HOME ---
+
+find_bin_dir() {
+    # Prefer ~/.local/bin if it exists and is on PATH
+    if [ -d "$HOME/.local/bin" ]; then
+        case ":$PATH:" in
+            *":$HOME/.local/bin:"*) echo "$HOME/.local/bin"; return 0 ;;
+        esac
+    fi
+
+    # Search PATH for any directory under $HOME
+    IFS=: read -ra path_dirs <<< "$PATH"
+    for dir in "${path_dirs[@]}"; do
+        case "$dir" in
+            "$HOME"/*)
+                if [ -d "$dir" ] && [ -w "$dir" ]; then
+                    echo "$dir"
+                    return 0
+                fi
+                ;;
+        esac
+    done
+
+    # Fall back to creating ~/.local/bin
+    echo ""
+    return 1
+}
+
+# --- Main ---
+
+echo "Building Docker image '$IMAGE_NAME'..."
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+docker build -t "$IMAGE_NAME" "$SCRIPT_DIR"
+echo ""
+
+BIN_DIR=$(find_bin_dir) || true
+
+if [ -z "$BIN_DIR" ]; then
+    BIN_DIR="$HOME/.local/bin"
+    echo "No bin directory found under \$HOME on your PATH."
+    echo "Creating $BIN_DIR ..."
+    mkdir -p "$BIN_DIR"
+    echo ""
+    echo "WARNING: $BIN_DIR is not on your PATH."
+    echo "Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.):"
+    echo ""
+    echo "    export PATH=\"\$HOME/.local/bin:\$PATH\""
+    echo ""
+fi
+
+WRAPPER="$BIN_DIR/$WRAPPER_NAME"
+
+cat > "$WRAPPER" << 'SCRIPT'
+#!/usr/bin/env bash
+exec docker run --rm \
+  --user "$(id -u):$(id -g)" \
+  -e HOME="$HOME" \
+  -v "$HOME:$HOME" \
+  -v "$(pwd):$(pwd)" -w "$(pwd)" \
+  gitj "$@"
+SCRIPT
+
+chmod +x "$WRAPPER"
+
+echo "Installed $WRAPPER"
+echo ""
+echo "Usage:"
+echo "  gitj --version"
+echo "  gitj jira start BUG-42"
+echo "  gitj lab merge active"
+echo "  gitj --help-all"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ya-git-jira",
   "description": "git extensions for Jira integration. Assumes bun is installed.",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "module": "dist/index.js",
   "type": "module",
   "bin": {