xgem-cli 2.0.0-alpha.12 → 2.0.0-alpha.14

package/README.md

@@ -62,6 +62,14 @@ xgem git init                 Setup local repo, attach remote tracker shortcuts
 xgem git branch               Pick, create, or switch branches; remembers your choice
 xgem git rm-remote            Drop a configured remote
 xgem git rm-branch            Safely drop local and/or remote branch
+xgem git pr                   Push current branch and open a GitHub PR (gh-backed)
+xgem git sync                 Rebase current branch onto the repo's base branch
+xgem git clean-branches       Delete local branches already merged into the base branch
+xgem git hooks <install|uninstall> Manage a pre-commit lint/test hook
+xgem release [major|minor|patch] Bump version, update CHANGELOG.md, tag, push
+xgem status                   Dashboard across every xgem-tracked project
+xgem bootstrap                Clone-to-running: detect framework, install, .env, migrate, launch
+xgem ci                       Run lint/test/build for every configured framework, summarized
 xgem --version                Print xgem's version
 
 Flags (any command): --yes (skip confirmations), --dry-run (show, don't apply), --verbose

package/bin/xgem

@@ -35,6 +35,16 @@ source "$XGEM_HOME/lib/flutter.sh"
 source "$XGEM_HOME/lib/scaffold.sh"
 # shellcheck source=lib/create.sh
 source "$XGEM_HOME/lib/create.sh"
+# shellcheck source=lib/release.sh
+source "$XGEM_HOME/lib/release.sh"
+# shellcheck source=lib/registry.sh
+source "$XGEM_HOME/lib/registry.sh"
+# shellcheck source=lib/status.sh
+source "$XGEM_HOME/lib/status.sh"
+# shellcheck source=lib/bootstrap.sh
+source "$XGEM_HOME/lib/bootstrap.sh"
+# shellcheck source=lib/ci.sh
+source "$XGEM_HOME/lib/ci.sh"
 
 CONFIG_DIR=".xgem-automate"
 
@@ -75,6 +85,14 @@ print_usage() {
     echo "  xgem git branch               - Pick, create, or switch branches; remembers your choice"
     echo "  xgem git rm-remote            - Drop specified target remote tracing rules"
     echo "  xgem git rm-branch            - Safely drop local and remote workspace branch states"
+    echo "  xgem git pr                   - Push current branch and open a GitHub PR (gh-backed)"
+    echo "  xgem git sync                 - Rebase current branch onto the repo's base branch"
+    echo "  xgem git clean-branches       - Delete local branches already merged into the base branch"
+    echo "  xgem git hooks <install|uninstall> - Manage a pre-commit lint/test hook"
+    echo "  xgem release [major|minor|patch] - Bump version, update CHANGELOG.md, tag, push"
+    echo "  xgem status                   - Dashboard across every xgem-tracked project"
+    echo "  xgem bootstrap                - Clone-to-running: detect framework, install, .env, migrate, launch"
+    echo "  xgem ci                       - Run lint/test/build for every configured framework, summarized"
     echo "  xgem --version                - Print xgem's version"
     echo ""
     echo "Flags (any command): --yes (skip confirmations), --dry-run (show, don't apply), --verbose"
@@ -161,7 +179,7 @@ case "${1:-}" in
         else
             scaffold_run_script "$FRAMEWORK" "$SCRIPT_NAME" "$CONFIG_DIR"
         fi
-        exit 0
+        exit $?
         ;;
 
     terminate)
@@ -178,6 +196,7 @@ case "${1:-}" in
             rm -rf "${CONFIG_DIR:?}/$fw"
         done
         rm -rf "$CONFIG_DIR"
+        registry_remove "$(pwd)"
 
         if [ -f .gitignore ]; then
             grep -v "^$CONFIG_DIR/" .gitignore > tmp_gitignore && mv tmp_gitignore .gitignore
@@ -189,7 +208,7 @@ case "${1:-}" in
         ;;
 
     git)
-        [ -n "${2:-}" ] || die "Usage: xgem git <cmt|init|branch|rm-remote|rm-branch>"
+        [ -n "${2:-}" ] || die "Usage: xgem git <cmt|init|branch|rm-remote|rm-branch|pr|sync|clean-branches|hooks>"
         cmd_git "$2" "${3:-}"
         exit 0
         ;;
@@ -199,6 +218,26 @@ case "${1:-}" in
         exit 0
         ;;
 
+    release)
+        cmd_release "${2:-}"
+        exit 0
+        ;;
+
+    status)
+        cmd_status
+        exit 0
+        ;;
+
+    bootstrap)
+        cmd_bootstrap
+        exit 0
+        ;;
+
+    ci)
+        cmd_ci
+        exit $?
+        ;;
+
     --version|-V|version)
         print_version
         exit 0

package/bin/xgem.js

@@ -21,6 +21,11 @@ const { cmdDoctor } = require('../lib-win/doctor');
 const { cmdGit } = require('../lib-win/git');
 const { cmdFlutter } = require('../lib-win/flutter');
 const scaffold = require('../lib-win/scaffold');
+const { cmdRelease } = require('../lib-win/release');
+const { registryAdd, registryRemove } = require('../lib-win/registry');
+const { cmdStatus } = require('../lib-win/status');
+const { cmdBootstrap } = require('../lib-win/bootstrap');
+const { cmdCi } = require('../lib-win/ci');
 
 const CONFIG_DIR = '.xgem-automate';
 
@@ -48,6 +53,14 @@ function printUsage() {
     console.log('  xgem git branch               - Pick, create, or switch branches; remembers your choice');
     console.log('  xgem git rm-remote            - Drop specified target remote tracing rules');
     console.log('  xgem git rm-branch            - Safely drop local and remote workspace branch states');
+    console.log('  xgem git pr                   - Push current branch and open a GitHub PR (gh-backed)');
+    console.log('  xgem git sync                 - Rebase current branch onto the repo\'s base branch');
+    console.log('  xgem git clean-branches       - Delete local branches already merged into the base branch');
+    console.log('  xgem git hooks <install|uninstall> - Manage a pre-commit lint/test hook');
+    console.log('  xgem release [major|minor|patch] - Bump version, update CHANGELOG.md, tag, push');
+    console.log('  xgem status                   - Dashboard across every xgem-tracked project');
+    console.log('  xgem bootstrap                - Clone-to-running: detect framework, install, .env, migrate, launch');
+    console.log('  xgem ci                       - Run lint/test/build for every configured framework, summarized');
     console.log('  xgem --version                - Print xgem\'s version');
     console.log('');
     console.log('Flags (any command): --yes (skip confirmations), --dry-run (show, don\'t apply), --verbose');
@@ -61,35 +74,6 @@ async function selectFramework(options) {
     return options[idx];
 }
 
-// Some teams want the generated scripts checked in so collaborators get the
-// same automation; others want them private/local-only. Ask instead of
-// always gitignoring.
-async function updateGitignore() {
-    const gitignorePath = '.gitignore';
-    const ignoreChoice = ((await prompt(`Should ${CONFIG_DIR}/ be ignored by git (private to you), or tracked so collaborators get the same scripts? [ignore/track]`, 'ignore'))).toLowerCase();
-
-    if (ignoreChoice.startsWith('t')) {
-        if (fs.existsSync(gitignorePath)) {
-            const lines = fs.readFileSync(gitignorePath, 'utf8').split(/\r?\n/).filter((l) => l !== `${CONFIG_DIR}/`);
-            fs.writeFileSync(gitignorePath, lines.join('\n'));
-            logInfo(`Removed existing ${CONFIG_DIR}/ entry from .gitignore since you chose to track it.`);
-        }
-        logSuccess(`${CONFIG_DIR}/ will be tracked in git.`);
-        return;
-    }
-
-    if (fs.existsSync(gitignorePath)) {
-        const content = fs.readFileSync(gitignorePath, 'utf8');
-        if (!content.includes(`${CONFIG_DIR}/`)) {
-            fs.appendFileSync(gitignorePath, `\n${CONFIG_DIR}/\n`);
-            logSuccess('Added automation tracking to .gitignore');
-        }
-    } else {
-        fs.writeFileSync(gitignorePath, `${CONFIG_DIR}/\n`);
-        logSuccess('Created .gitignore and hidden tracking layer folder references.');
-    }
-}
-
 async function cmdInit() {
     printBanner();
     if (fs.existsSync(CONFIG_DIR)) {
@@ -97,14 +81,12 @@ async function cmdInit() {
         return;
     }
     fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    registryAdd(process.cwd());
 
     console.log('Select your starting framework architecture:');
     const fw = await selectFramework(scaffold.ALL_FRAMEWORKS);
     if (!fw) die('Invalid selection.');
-    scaffold.injectTemplates(fw, CONFIG_DIR);
-    logSuccess(`Successfully appended standard scripts for: ${CONFIG_DIR}/${fw}`);
-
-    await updateGitignore();
+    await scaffold.bookkeeping(fw, CONFIG_DIR);
 }
 
 async function cmdAdd() {
@@ -154,6 +136,7 @@ async function cmdTerminate() {
         fs.rmSync(path.join(CONFIG_DIR, fw), { recursive: true, force: true });
     }
     fs.rmSync(CONFIG_DIR, { recursive: true, force: true });
+    registryRemove(process.cwd());
 
     if (fs.existsSync('.gitignore')) {
         const lines = fs.readFileSync('.gitignore', 'utf8').split(/\r?\n/).filter((l) => l !== `${CONFIG_DIR}/`);
@@ -203,9 +186,13 @@ async function main() {
         case 'run': return cmdRun(a2, a3);
         case 'terminate': return cmdTerminate();
         case 'git':
-            if (!a2) die('Usage: xgem git <cmt|init|branch|rm-remote|rm-branch>');
-            return cmdGit(a2, a3);
+            if (!a2) die('Usage: xgem git <cmt|init|branch|rm-remote|rm-branch|pr|sync|clean-branches|hooks>');
+            return cmdGit(a2, a3, CONFIG_DIR);
         case 'doctor': return cmdDoctor(a2);
+        case 'release': return cmdRelease(a2);
+        case 'status': return cmdStatus(CONFIG_DIR);
+        case 'bootstrap': return cmdBootstrap(CONFIG_DIR);
+        case 'ci': return cmdCi(CONFIG_DIR);
         case '--version':
         case '-V':
         case 'version': {

package/lib/bootstrap.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+# xgem bootstrap: clone-to-running in one command, for a project you just
+# checked out (not creating a new one — that's `xgem init`'s job).
+# Depends on lib/logger.sh, lib/utils.sh, lib/scaffold.sh, lib/create.sh.
+
+# _detect_framework -> a name from ALL_FRAMEWORKS, or empty if nothing
+# recognizable was found. Never assumes; probes for marker files the same
+# way lib/doctor.sh probes for tools instead of guessing.
+_detect_framework() {
+    [ -f pubspec.yaml ] && { echo flutter; return 0; }
+    [ -f go.mod ] && { echo go; return 0; }
+    [ -f Cargo.toml ] && { echo rust; return 0; }
+    { [ -f pyproject.toml ] || [ -f requirements.txt ] || [ -f setup.py ]; } && { echo python; return 0; }
+    [ -f Package.swift ] && { echo swift; return 0; }
+    if [ -f package.json ]; then
+        if grep -q '"next"' package.json; then echo next
+        elif grep -q '"@angular/core"' package.json; then echo angular
+        elif grep -q '"vue"' package.json; then echo vue
+        elif grep -q '"react"' package.json; then echo react
+        else echo node
+        fi
+        return 0
+    fi
+    [ -f Dockerfile ] && { echo docker; return 0; }
+    return 1
+}
+
+_bootstrap_env_file() {
+    [ -f .env ] && { log_debug ".env already exists, leaving it as-is."; return 0; }
+    local example
+    for example in .env.example .env.sample; do
+        [ -f "$example" ] || continue
+        cp "$example" .env
+        log_success "Created .env from $example."
+        local missing
+        missing=$(grep -E '^[A-Za-z_][A-Za-z0-9_]*=[[:space:]]*$' .env | cut -d= -f1)
+        if [ -n "$missing" ]; then
+            log_warn "These .env keys are empty — fill them in:"
+            echo "$missing" | sed 's/^/  - /'
+        fi
+        return 0
+    done
+}
+
+_bootstrap_node_pm() {
+    if [ -f pnpm-lock.yaml ]; then echo pnpm
+    elif [ -f yarn.lock ]; then echo yarn
+    elif [ -f bun.lockb ] || [ -f bun.lock ]; then echo bun
+    else echo npm
+    fi
+}
+
+_bootstrap_install() {
+    local fw=$1
+    case "$fw" in
+        node|react|vue|angular|next)
+            local pm
+            pm=$(_bootstrap_node_pm)
+            log_info "Installing dependencies with $pm..."
+            case "$pm" in
+                yarn) yarn ;;
+                pnpm) pnpm install ;;
+                bun)  bun install ;;
+                *)    npm install ;;
+            esac
+            ;;
+        flutter)
+            has_cmd flutter || { log_warn "flutter not found — skipping 'flutter pub get'."; return 0; }
+            log_info "Running flutter pub get..."
+            flutter pub get
+            ;;
+        python)
+            if [ -f pyproject.toml ] && has_cmd poetry; then
+                log_info "Installing dependencies with poetry..."
+                poetry install
+            elif [ -f requirements.txt ]; then
+                has_cmd python3 || { log_warn "python3 not found — skipping install."; return 0; }
+                [ -d .venv ] || python3 -m venv .venv
+                log_info "Installing dependencies into .venv..."
+                .venv/bin/pip install -r requirements.txt
+            fi
+            ;;
+        go)
+            has_cmd go || { log_warn "go not found — skipping 'go mod download'."; return 0; }
+            log_info "Running go mod download..."
+            go mod download
+            ;;
+        rust)
+            has_cmd cargo || { log_warn "cargo not found — skipping 'cargo fetch'."; return 0; }
+            log_info "Running cargo fetch..."
+            cargo fetch
+            ;;
+        swift)
+            has_cmd swift || { log_warn "swift not found — skipping 'swift package resolve'."; return 0; }
+            log_info "Running swift package resolve..."
+            swift package resolve
+            ;;
+        docker)
+            log_debug "Docker project — nothing to install locally."
+            ;;
+    esac
+}
+
+_bootstrap_migrations() {
+    local fw=$1
+    if [ "$fw" = "node" ] || [ "$fw" = "react" ] || [ "$fw" = "vue" ] || [ "$fw" = "angular" ] || [ "$fw" = "next" ]; then
+        if _package_json_has_script migrate; then
+            local pm
+            pm=$(_bootstrap_node_pm)
+            confirm "Run the project's 'migrate' script (via $pm)?" || return 0
+            case "$pm" in
+                yarn) yarn migrate ;;
+                pnpm) pnpm run migrate ;;
+                bun)  bun run migrate ;;
+                *)    npm run migrate ;;
+            esac
+            return 0
+        fi
+    fi
+    if [ -f prisma/schema.prisma ]; then
+        confirm "Run 'npx prisma migrate dev'?" && npx prisma migrate dev
+    elif [ -f manage.py ]; then
+        has_cmd python3 && confirm "Run 'python3 manage.py migrate'?" && python3 manage.py migrate
+    fi
+}
+
+_bootstrap_offer_dev_server() {
+    local fw=$1
+    local script=""
+    case "$fw" in
+        node) script=start ;;
+        react|vue|angular|next) script=dev ;;
+        *) return 0 ;;
+    esac
+    [ -f "$CONFIG_DIR/$fw/$script.sh" ] || return 0
+    confirm "Launch the dev server now ('xgem run $fw $script')?" && scaffold_run_script "$fw" "$script" "$CONFIG_DIR"
+}
+
+cmd_bootstrap() {
+    log_info "Detecting project framework..."
+    local fw
+    fw=$(_detect_framework)
+    if [ -z "$fw" ]; then
+        log_warn "Could not auto-detect the framework from any known marker file."
+        echo "Pick one:"
+        PS3="Enter target selection number: "
+        select fw in "${ALL_FRAMEWORKS[@]}"; do
+            [ -n "$fw" ] && break
+            echo "Invalid selection."
+        done
+    else
+        log_success "Detected: $fw"
+    fi
+
+    _bootstrap_env_file
+    _bootstrap_install "$fw"
+    _bootstrap_migrations "$fw"
+
+    if [ ! -d "$CONFIG_DIR" ]; then
+        confirm "Scaffold xgem automation scripts (.xgem-automate) for $fw too?" && _xgem_bookkeeping "$fw"
+    fi
+
+    _bootstrap_offer_dev_server "$fw"
+    log_success "Bootstrap complete."
+}

package/lib/ci.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# xgem ci: run lint -> test -> build for every configured framework before
+# you push, so a CI failure gets caught locally first.
+# Depends on lib/logger.sh.
+
+cmd_ci() {
+    [ -d "$CONFIG_DIR" ] || die "No $CONFIG_DIR found — run 'xgem init' or 'xgem add' first."
+
+    local -a steps=(lint test build)
+    local -a results=()
+    local overall_status=0
+    local fw_dir fw step
+
+    for fw_dir in "$CONFIG_DIR"/*/; do
+        [ -d "$fw_dir" ] || continue
+        fw=$(basename "$fw_dir")
+        for step in "${steps[@]}"; do
+            [ -f "$CONFIG_DIR/$fw/$step.sh" ] || continue
+            log_info "Running $fw $step..."
+            if bash "$CONFIG_DIR/$fw/$step.sh"; then
+                results+=("PASS  $fw $step")
+            else
+                results+=("FAIL  $fw $step")
+                overall_status=1
+            fi
+        done
+    done
+
+    if [ ${#results[@]} -eq 0 ]; then
+        log_warn "No lint/test/build scripts found under $CONFIG_DIR to run."
+        return 0
+    fi
+
+    echo ""
+    echo "=== xgem ci summary ==="
+    printf '%s\n' "${results[@]}"
+
+    if [ "$overall_status" -eq 0 ]; then
+        log_success "All checks passed."
+    else
+        log_error "Some checks failed."
+    fi
+    return "$overall_status"
+}

package/lib/create.sh

@@ -42,6 +42,7 @@ XGEM_CREATED_NEW_FOLDER=""
 _xgem_bookkeeping() {
     local fw=$1
     mkdir -p "$CONFIG_DIR"
+    registry_add "$(pwd)"
     scaffold_inject_templates "$fw" "$CONFIG_DIR"
     log_success "Successfully appended standard scripts for: $CONFIG_DIR/$fw"
 
@@ -98,15 +99,6 @@ _enter_project_dir() {
     mkdir -p "$project_dir" && cd "$project_dir" || die "Could not enter $project_dir"
 }
 
-_open_url() {
-    local url=$1
-    case "$(detect_os)" in
-        darwin) open "$url" 2>/dev/null ;;
-        linux)  xdg-open "$url" 2>/dev/null ;;
-        *) log_debug "Don't know how to open a browser on this OS — visit $url manually." ;;
-    esac
-}
-
 # _launch_dev_server_and_open_browser <cmd...>
 # Starts the dev server in the background, tails its log for the first
 # http://localhost URL it prints — this works across Vite/CRA/Next/Angular