indraq_cli 1.5.1 → 1.5.7

package/README.md

@@ -18,7 +18,7 @@
   <img alt="Java 21" src="https://img.shields.io/badge/Java-21%20recommended-ED8B00?logo=openjdk&logoColor=white" />
   <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-strict-3178C6?logo=typescript&logoColor=white" />
   <img alt="License" src="https://img.shields.io/npm/l/indraq_cli" />
-  <img alt="Version" src="https://img.shields.io/badge/version-1.5.1-264B63" />
+  <img alt="Version" src="https://img.shields.io/badge/version-1.5.7-264B63" />
 </p>
 
 > [!IMPORTANT]
@@ -30,7 +30,7 @@
 
 1. [What is IndraQ CLI?](#what-is-indraq-cli)
 2. [Explain it like I am new](#explain-it-like-i-am-new)
-3. [What changed in v1.5.1?](#what-changed-in-v151)
+3. [What changed in v1.5.7?](#what-changed-in-v155)
 4. [Requirements](#requirements)
 5. [Install Java 21](#install-java-21)
 6. [Install IndraQ CLI](#install-indraq-cli)
@@ -59,6 +59,14 @@
 
 ---
 
+## v1.5.7 — GHCR credential safety
+
+Docker deployments now use the GHCR login already stored by Docker. IndraQ **never runs `docker login ghcr.io` during deploy** and never substitutes a Git/Git Credential Manager token for Docker's registry credential.
+
+This distinction matters: a credential that can clone/push a GitHub repository does not automatically have GHCR `write:packages` permission. If `docker push ghcr.io/...` works manually, `indraq deploy:dev` / `indraq deploy:prod` now uses that same Docker credential state.
+
+---
+
 ## What is IndraQ CLI?
 
 IndraQ CLI is a program you install once on a developer computer and then use from **any project folder**.
@@ -145,16 +153,30 @@ You do **not** need to give Jenkins a Git URL, Git branch, app subdirectory, or
 
 ---
 
-## What changed in v1.5.1?
+## What changed in v1.5.7?
 
-v1.5.1 keeps the Android versioning introduced in v1.5 and hardens the Jenkins/Git workflow around it.
+v1.5.7 keeps the Android versioning and Jenkins/Git workflow from v1.5.x and hardens Android builds created from Windows source snapshots.
 
 This patch fixes the mobile Jenkinsfile Groovy escaping error, makes the mobile Jenkins job name deterministic, makes project configuration Git-shareable, keeps Jenkins login credentials machine-local, and makes Docker deployments send the exact manual deployment parameters expected by the Jenkins pipeline.
 
-### Jenkins/Git behavior hardened in v1.5.1
+
+### Jenkins-console-quality logs and server Gradle reuse in v1.5.7
+
+- The terminal log streamer now reads Jenkins **`logText/progressiveHtml`**, the same progressive endpoint used by the classic Jenkins web console. Jenkins therefore removes/renders hidden `ConsoleNote` annotations before the CLI displays the text, so internal `ha:////...` payloads no longer pollute VS Code output.
+- HTML markup is converted back to plain terminal text while preserving usernames, timestamps, Pipeline lines, errors, and normal line spacing. `progressiveText` remains only as a compatibility fallback with explicit ConsoleNote filtering.
+- Failed mobile builds now end with a short **Key Jenkins error lines** summary plus the direct Jenkins build URL.
+- The mobile Jenkinsfile still normalizes Windows CRLF in `android/gradlew`, but v1.5.7 also restores the Jenkins server's shared Gradle cache at `$HOME/.gradle` instead of creating an empty per-project Gradle cache.
+- Gradle execution prefers the exact cached project-wrapper distribution. If no exact wrapper distribution is cached, an installed Jenkins-server Gradle from the same major version can be reused. The project wrapper remains the final fallback.
+- If a wrapper download is genuinely necessary, the temporary Jenkins copy of `gradle-wrapper.properties` gets `networkTimeout=120000` (120 seconds) instead of failing at Gradle's short default timeout.
+- `FULL_RESET` no longer deletes Jenkins' shared Gradle cache. It clears project-local npm/Expo caches and generated Android state only.
+- Jenkins queue updates are printed as normal lines instead of carriage-return cursor updates.
+
+### Jenkins/Git behavior hardened in v1.5.x
 
 - Mobile always targets the Jenkins job **`Mobile app Cli build`**. The job name is no longer configurable per project.
 - The mobile Jenkinsfile no longer contains the Groovy-invalid escaped-dot expression that caused `unexpected char: '\'` during pipeline compilation.
+- Mobile Jenkins HTTP uploads now preserve the Jenkins web-session cookie together with the CSRF crumb, fixing HTTP 403 responses when Jenkins is configured with username/password authentication. API-token authentication remains supported.
+- Mobile build output now says explicitly that `.env` is excluded only from the source archive and is uploaded separately to Jenkins.
 - `.indraq/mobile.json`, `.indraq/docker.json`, and `.indraq/jenkins.json` are intended to be committed to Git.
 - `.indraq/jenkins.local.json`, Jenkins username/token/password, `.env`, and `jenkins-cli.jar` are machine-local and never meant to be committed.
 - Docker CLI deployments now start Jenkins with `ACTION=DEPLOY`, `IMAGE_TAG`, optional `IMAGE_DIGEST`, and `DEPLOYMENT_SOURCE=INDRAQ_CLI`.
@@ -246,14 +268,15 @@ Existing `.indraq/mobile.json` files are upgraded automatically. Project type, a
 |---|---|---|
 | **Node.js 22+** | Runs IndraQ CLI | `node --version` |
 | **npm** | Installs / updates the CLI | `npm --version` |
-| **Git** | Docker/GHCR authentication and optional source revision metadata | `git --version` |
+| **Git** | GitHub identity/org discovery and optional source revision metadata | `git --version` |
+| **Docker GHCR login** | Registry authentication used for image push | `docker login ghcr.io` (one-time, when needed) |
 | **Docker** | Docker deployment module | `docker --version` |
 | **Java** | Runs Jenkins CLI | `java -version` |
 | **tar** | Packages the local mobile source snapshot | `tar --version` |
 | **Jenkins account** | Starts Jenkins jobs | Jenkins username + API token |
 
 > [!TIP]
-> Node.js **24** is recommended for IndraQ developer machines, but v1.5.1 supports Node.js **22 and newer**.
+> Node.js **24** is recommended for IndraQ developer machines, but v1.5.7 supports Node.js **22 and newer**.
 
 ### Jenkins mobile build machine
 
@@ -267,7 +290,9 @@ The provided mobile Jenkinsfile expects the Jenkins agent to have:
 - `tar` / `sha256sum`;
 - Jenkins **File Parameter** plugin;
 - writable `/opt/mobile-builder`;
-- Android SDK at `/opt/android-sdk` unless you edit the Jenkinsfile.
+- Android SDK at `/opt/android-sdk` unless you edit the Jenkinsfile;
+- the Jenkins account should have a writable `$HOME/.gradle` cache (normally `/var/jenkins_home/.gradle`);
+- optionally, a system `gradle` executable may be installed. IndraQ uses it only when its major version matches the project wrapper.
 
 ---
 
@@ -331,7 +356,7 @@ indraq --version
 Expected for this release:
 
 ```text
-1.5.1
+1.5.3
 ```
 
 Update later:
@@ -598,9 +623,9 @@ Profiles:
 
 | Profile | Meaning |
 |---|---|
-| **FAST** | Fresh source snapshot, reuse project-scoped npm/Gradle caches |
+| **FAST** | Fresh source snapshot; reuse project npm cache plus the Jenkins server shared Gradle cache |
 | **CLEAN** | Clean generated project build state before building |
-| **FULL_RESET** | Clear this project's Jenkins build caches before rebuilding |
+| **FULL_RESET** | Clear project npm/Expo/generated Android state while preserving the Jenkins server shared Gradle cache |
 
 After saving one environment you return to the Mobile App menu, so you can configure another environment without rerunning the command.
 
@@ -841,7 +866,7 @@ indraq build mobile:prod --output aab --profile clean --verbose --yes
 
 ## Android versioning and artifact names
 
-IndraQ v1.5.1 currently manages **Android** versioning only. iOS version/build-number management is intentionally out of scope for now.
+IndraQ v1.5.7 currently manages **Android** versioning only. iOS version/build-number management is intentionally out of scope for now.
 
 ### What value does a build use?
 
@@ -1072,9 +1097,9 @@ The CLI checks this exact job on Production Jenkins before every mobile build.
 
 ### Live logs
 
-Mobile source upload is triggered through Jenkins HTTP `buildWithParameters`, then IndraQ follows the queue item, discovers the build number, and streams progressive Jenkins console output into VS Code.
+Mobile source upload is triggered through Jenkins HTTP `buildWithParameters`, then IndraQ follows the queue item, discovers the build number, and streams Jenkins **`logText/progressiveHtml`** into VS Code. This is the same progressive console endpoint used by the classic Jenkins browser console, so Jenkins' hidden `ConsoleNote` metadata is rendered/removed before IndraQ converts the remaining HTML to readable terminal text.
 
-If Jenkins fails, the CLI exits with failure and leaves the Jenkins error visible in the terminal.
+If Jenkins fails, the CLI exits with failure, prints a short **Key Jenkins error lines** summary, and prints the direct Jenkins build URL. The complete live output remains above it.
 
 ---
 
@@ -1094,7 +1119,7 @@ Project-local configuration:
 The generated `.indraq/.gitignore` ignores **only machine-local files** such as `jenkins.local.json`. Shared project configuration is intentionally visible to Git.
 
 > [!IMPORTANT]
-> Older IndraQ setups often ignored the whole `.indraq/` directory. v1.5.1 automatically appends safe re-include rules to the project root `.gitignore` so `jenkins.json`, `docker.json`, and `mobile.json` can be committed while `jenkins.local.json` remains ignored. Run `git status` after configuration and commit the three shared JSON files.
+> Older IndraQ setups often ignored the whole `.indraq/` directory. v1.5.7 automatically appends safe re-include rules to the project root `.gitignore` so `jenkins.json`, `docker.json`, and `mobile.json` can be committed while `jenkins.local.json` remains ignored. Run `git status` after configuration and commit the three shared JSON files.
 
 ### `jenkins.json`
 
@@ -1177,10 +1202,10 @@ indraq --version
 Expected for this release:
 
 ```text
-1.5.1
+1.5.3
 ```
 
-v1.5.1 automatically migrates older `.indraq/mobile.json` and Jenkins config layouts. Existing mobile environment/version settings are preserved. Older Jenkins username/server binding fields are split so only non-secret server metadata remains in tracked `jenkins.json`; the current machine binding is written to ignored `jenkins.local.json`.
+v1.5.7 automatically migrates older `.indraq/mobile.json` and Jenkins config layouts. Existing mobile environment/version settings are preserved. Older Jenkins username/server binding fields are split so only non-secret server metadata remains in tracked `jenkins.json`; the current machine binding is written to ignored `jenkins.local.json`.
 
 For projects coming from pre-versioning releases, Android version settings initialize as:
 
@@ -1207,16 +1232,47 @@ Docker/GHCR and Jenkins configuration remain compatible.
 
 ## Command reference
 
+The CLI now has a complete built-in help system, so developers do not need to open this README just to remember syntax.
+
+```bash
+indraq --help
+indraq help
+indraq help configure
+indraq help docker
+indraq help mobile
+indraq help doctor
+```
+
+### Core commands
+
 | Command | Purpose |
 |---|---|
 | `indraq --version` | Show installed CLI version |
-| `indraq --help` | Show commands |
+| `indraq --help` | Show the complete command catalog, aliases, flags, mappings and examples |
+| `indraq help` | Same complete command catalog |
+| `indraq help <topic>` | Focused help for `configure`, `docker`, `mobile`, or `doctor` |
 | `indraq doctor` | Diagnose runtime / PATH prerequisites |
 | `indraq configure` | Open configuration home |
-| `indraq deploy:dev` | Docker Development deployment |
+
+### Docker commands
+
+| Command | Purpose |
+|---|---|
+| `indraq deploy:dev` | Docker Development build/push/deploy |
 | `indraq deploy:development` | Alias of `deploy:dev` |
-| `indraq deploy:prod` | Docker Production deployment |
+| `indraq deploy:prod` | Docker Production build/push/deploy |
 | `indraq deploy:production` | Alias of `deploy:prod` |
+| `indraq deploy build --env dev` | Long-form Development command |
+| `indraq deploy build --env development` | Long-form Development alias |
+| `indraq deploy build --env prod` | Long-form Production command |
+| `indraq deploy build --env production` | Long-form Production alias |
+| `indraq deploy configure` | Open configuration home |
+| `indraq deploy:configure` | Alias for `indraq configure` |
+
+### Mobile commands
+
+| Command | Purpose |
+|---|---|
 | `indraq build mobile:dev` | Mobile Development build |
 | `indraq build mobile:development` | Alias of `mobile:dev` |
 | `indraq build mobile:staging` | Mobile Staging build |
@@ -1226,13 +1282,23 @@ Docker/GHCR and Jenkins configuration remain compatible.
 Mobile flags:
 
 ```text
---output <dev-client|debug-apk|apk|aab>
+--output <dev-client|development-client|client|debug|debug-apk|apk|release-apk|aab|release-aab>
 --profile <fast|clean|full-reset>
 --verbose
 --dry-run
 -y, --yes
 ```
 
+### Jenkins routing reminder
+
+```text
+Docker Development → Development Jenkins
+Docker Production  → Production Jenkins
+Mobile Development → Production Jenkins
+Mobile Staging     → Production Jenkins
+Mobile Production  → Production Jenkins
+```
+
 ---
 
 ## Troubleshooting
@@ -1325,7 +1391,7 @@ Do not paste it into Jenkins.
 Make sure:
 
 1. Jenkins **File Parameter** plugin is installed;
-2. the job uses `templates/jenkins/Jenkinsfile-Mobile-App` from v1.5.1;
+2. the job uses `templates/jenkins/Jenkinsfile-Mobile-App` from v1.5.7;
 3. Jenkins has registered the parameters;
 4. the Jenkins job is named exactly `Mobile app Cli build`.
 
@@ -1372,6 +1438,39 @@ npm install -g indraq_cli
 
 ---
 
+
+### `./gradlew: cannot execute: required file not found`
+
+This normally means the mobile source snapshot came from Windows and `android/gradlew` contains CRLF line endings. IndraQ normalizes the wrapper automatically on Jenkins before the build and invokes it through Bash.
+
+The Jenkins server provides the Android toolchain:
+
+```text
+Java                 → Jenkins server
+ANDROID_HOME          → /opt/android-sdk
+Android NDKs          → /opt/android-sdk/ndk/*
+Shared Gradle cache   → $HOME/.gradle (normally /var/jenkins_home/.gradle)
+Preferred Gradle      → exact cached wrapper distribution
+Server fallback       → installed Gradle when it is the same major version
+Final fallback        → project wrapper with 120-second download timeout
+```
+
+This restores the shared Gradle-cache behavior used by the earlier Git-checkout mobile pipeline. `FULL_RESET` deliberately preserves the server's `$HOME/.gradle` cache.
+
+### Gradle wrapper tries to download and times out
+
+v1.5.7 first checks the Jenkins server's shared wrapper cache. If the requested distribution is already cached, the wrapper uses it without internet access. If there is no exact cached wrapper but Jenkins has a system Gradle from the same major version, IndraQ reuses the server Gradle. Only when neither option exists does the project wrapper attempt a download, with `networkTimeout=120000` applied to the temporary Jenkins copy of `gradle-wrapper.properties`.
+
+If the Jenkins machine has neither a compatible installed Gradle nor the requested wrapper cached and it has no outbound access to Gradle distributions, install/cache the required Gradle version on that Jenkins machine once.
+
+### Jenkins logs contain `ha:////...`, look diagonal, or are unreadable in VS Code
+
+The `ha:////...` strings are Jenkins `ConsoleNote` annotations embedded in raw `progressiveText`. The Jenkins browser UI renders/hides those annotations. v1.5.7 now consumes Jenkins `logText/progressiveHtml`—the same progressive endpoint used by the classic web console—and converts the rendered output back to plain terminal text.
+
+The CLI also normalizes line endings and strips terminal control sequences. Upgrade to v1.5.7 or newer if you see raw `ha:////...` payloads or staircase/right-shifted output.
+
+---
+
 ## Frequently asked questions
 
 ### Do I install IndraQ CLI in every project?
@@ -1537,7 +1636,7 @@ indraq diagnostics ...
 - [ ] command is run from package.json root
 - [ ] Production Jenkins connection configured (`indraq configure → Jenkins → Production`)
 - [ ] Jenkins File Parameter plugin installed
-- [ ] Jenkins job uses the v1.5.1 mobile Jenkinsfile
+- [ ] Jenkins job uses the v1.5.7 mobile Jenkinsfile
 - [ ] Mobile project type configured
 - [ ] Jenkins job is named exactly `Mobile app Cli build` and exists on Production Jenkins
 - [ ] Development / Staging / Production defaults configured as needed
@@ -1558,3 +1657,10 @@ MIT License. See [`LICENSE`](LICENSE).
 <p align="center">
   <strong>Built and maintained by IndraQ Innovations.</strong>
 </p>
+
+
+### Jenkins mobile upload returns HTTP 403
+
+IndraQ CLI v1.5.7 preserves the Jenkins web-session cookie together with the CSRF crumb when a Jenkins username/password is used. Jenkins ties crumbs to the session that created them, so both values must travel together. API-token authentication is exempt from the crumb requirement.
+
+If a mobile build still returns HTTP 403, v1.5.7 prints Jenkins' own response message. A permission error means the configured Jenkins user needs **Job/Read** and **Job/Build** on the `Mobile app Cli build` job. A CSRF error means the Jenkins controller or reverse proxy is rejecting the crumb/session and the printed Jenkins message should be used for diagnosis.

package/dist/cli/create-program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-program.d.ts","sourceRoot":"","sources":["../../src/cli/create-program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,aAAa,QAAO,OAsBhC,CAAC"}
+{"version":3,"file":"create-program.d.ts","sourceRoot":"","sources":["../../src/cli/create-program.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,eAAO,MAAM,aAAa,QAAO,OA6ChC,CAAC"}

package/dist/cli/create-program.js

@@ -1,17 +1,56 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProgram = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
 const deploy_1 = require("../modules/deploy");
 const mobile_1 = require("../modules/mobile");
 const configure_command_1 = require("../modules/configure/configure.command");
 const doctor_command_1 = require("./doctor.command");
+const help_content_1 = require("./help-content");
+const readCliVersion = () => {
+    try {
+        const packageJsonPath = node_path_1.default.resolve(__dirname, '../../package.json');
+        const packageJson = JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, 'utf8'));
+        if (typeof packageJson.version === 'string' && packageJson.version.trim()) {
+            return packageJson.version.trim();
+        }
+    }
+    catch {
+        // Fall through to a safe value if package metadata is unexpectedly unavailable.
+    }
+    return '0.0.0';
+};
 const createProgram = () => {
     const program = new commander_1.Command();
     program
         .name('indraq')
         .description('IndraQ internal engineering CLI.')
-        .version('1.5.1');
+        .version(readCliVersion())
+        .showSuggestionAfterError()
+        .showHelpAfterError('\nRun `indraq --help` to see the complete command reference.');
+    // Commander normally adds a very small `help [command]` command. IndraQ replaces
+    // it with a useful topic-aware help command while keeping normal `--help` support
+    // on every command/subcommand.
+    program.addHelpCommand(false);
+    program
+        .command('help [topic]')
+        .description('Show complete help or focused help for configure, docker, mobile, or doctor.')
+        .action((topic) => {
+        const parsed = (0, help_content_1.parseHelpTopic)(topic);
+        if (!parsed) {
+            console.error(chalk_1.default.red(`\n✗ Unknown help topic: ${topic ?? ''}`));
+            console.log(chalk_1.default.gray('Available topics: configure, docker, mobile, doctor\n'));
+            process.exitCode = 1;
+            return;
+        }
+        console.log((0, help_content_1.helpForTopic)(parsed));
+    });
     program
         .command('doctor')
         .description('Diagnose Node and command-resolution problems.')
@@ -22,6 +61,7 @@ const createProgram = () => {
         .action(async () => (0, configure_command_1.configure)());
     (0, deploy_1.registerDeployModule)(program);
     (0, mobile_1.registerMobileModule)(program);
+    program.addHelpText('after', (0, help_content_1.fullCommandReference)());
     return program;
 };
 exports.createProgram = createProgram;

package/dist/cli/create-program.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-program.js","sourceRoot":"","sources":["../../src/cli/create-program.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AACpC,8CAAyD;AACzD,8CAAyD;AACzD,8EAAmE;AACnE,qDAA0C;AAEnC,MAAM,aAAa,GAAG,GAAY,EAAE;IACzC,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,kCAAkC,CAAC;SAC/C,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,uBAAM,GAAE,CAAC,CAAC;IAE1B,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,kFAAkF,CAAC;SAC/F,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,IAAA,6BAAS,GAAE,CAAC,CAAC;IAEnC,IAAA,6BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,6BAAoB,EAAC,OAAO,CAAC,CAAC;IAE9B,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAtBW,QAAA,aAAa,iBAsBxB"}
+{"version":3,"file":"create-program.js","sourceRoot":"","sources":["../../src/cli/create-program.ts"],"names":[],"mappings":";;;;;;AAAA,qCAAuC;AACvC,0DAA6B;AAC7B,kDAA0B;AAC1B,yCAAoC;AACpC,8CAAyD;AACzD,8CAAyD;AACzD,8EAAmE;AACnE,qDAA0C;AAC1C,iDAAoF;AAIpF,MAAM,cAAc,GAAG,GAAW,EAAE;IAClC,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,eAAe,EAAE,MAAM,CAAC,CAA0B,CAAC;QAE/F,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1E,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;IAClF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEK,MAAM,aAAa,GAAG,GAAY,EAAE;IACzC,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,kCAAkC,CAAC;SAC/C,OAAO,CAAC,cAAc,EAAE,CAAC;SACzB,wBAAwB,EAAE;SAC1B,kBAAkB,CAAC,8DAA8D,CAAC,CAAC;IAEtF,iFAAiF;IACjF,kFAAkF;IAClF,+BAA+B;IAC/B,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAE9B,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,8EAA8E,CAAC;SAC3F,MAAM,CAAC,CAAC,KAAc,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,IAAA,6BAAc,EAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,2BAA2B,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC,CAAC;YACjF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAA,2BAAY,EAAC,MAAM,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,uBAAM,GAAE,CAAC,CAAC;IAE1B,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,kFAAkF,CAAC;SAC/F,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,IAAA,6BAAS,GAAE,CAAC,CAAC;IAEnC,IAAA,6BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,6BAAoB,EAAC,OAAO,CAAC,CAAC;IAE9B,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,IAAA,mCAAoB,GAAE,CAAC,CAAC;IAErD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AA7CW,QAAA,aAAa,iBA6CxB"}

package/dist/cli/help-content.d.ts

@@ -0,0 +1,5 @@
+export type HelpTopic = 'all' | 'configure' | 'docker' | 'mobile' | 'doctor';
+export declare const fullCommandReference: () => string;
+export declare const helpForTopic: (topic: HelpTopic) => string;
+export declare const parseHelpTopic: (value?: string) => HelpTopic | undefined;
+//# sourceMappingURL=help-content.d.ts.map

package/dist/cli/help-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-content.d.ts","sourceRoot":"","sources":["../../src/cli/help-content.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAM7E,eAAO,MAAM,oBAAoB,QAAO,MAgFvC,CAAC;AA2GF,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,KAAG,MAM/C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,SAAS,GAAG,SAS3D,CAAC"}

package/dist/cli/help-content.js

@@ -0,0 +1,223 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseHelpTopic = exports.helpForTopic = exports.fullCommandReference = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const heading = (value) => chalk_1.default.bold(value);
+const command = (value) => chalk_1.default.cyan(value);
+const note = (value) => chalk_1.default.gray(value);
+const fullCommandReference = () => `
+${heading('Complete command reference')}
+
+${heading('Core')}
+  ${command('indraq --version')}                         Show installed CLI version
+  ${command('indraq --help')}                            Show this complete help screen
+  ${command('indraq help')}                              Show this complete help screen
+  ${command('indraq help <topic>')}                      Help topic: configure, docker, mobile, doctor
+  ${command('indraq doctor')}                            Diagnose Node, Java, Git, tar and PATH issues
+  ${command('indraq configure')}                         Open the project configuration home
+
+${heading('Docker / GHCR deployment')}
+  ${command('indraq deploy:dev')}                        Build, push and deploy Development
+  ${command('indraq deploy:development')}                Alias for deploy:dev
+  ${command('indraq deploy:prod')}                       Build, push and deploy Production
+  ${command('indraq deploy:production')}                 Alias for deploy:prod
+  ${command('indraq deploy build --env dev')}            Long-form Development deployment
+  ${command('indraq deploy build --env development')}    Long-form Development alias
+  ${command('indraq deploy build --env prod')}           Long-form Production deployment
+  ${command('indraq deploy build --env production')}     Long-form Production alias
+  ${command('indraq deploy configure')}                  Open the main configuration home
+  ${command('indraq deploy:configure')}                  Alias for indraq configure
+
+${heading('Mobile Android builds')}
+  ${command('indraq build mobile:dev')}                  Mobile Development build
+  ${command('indraq build mobile:development')}          Alias for mobile:dev
+  ${command('indraq build mobile:staging')}              Mobile Staging build
+  ${command('indraq build mobile:prod')}                 Mobile Production build
+  ${command('indraq build mobile:production')}           Alias for mobile:prod
+
+${heading('Mobile build flags')}
+  ${command('--output <output>')}                        One-build output override
+      dev-client | development-client | client
+      debug | debug-apk
+      apk | release-apk
+      aab | release-aab
+
+  ${command('--profile <profile>')}                      One-build profile override
+      fast | clean | full-reset
+
+  ${command('--verbose')}                                Verbose Gradle/Jenkins output
+  ${command('--dry-run')}                                Validate and print plan; do not start Jenkins
+  ${command('-y, --yes')}                                Skip final build confirmation
+
+${heading('Configuration home')}
+  ${command('indraq configure')}
+      Jenkins
+        Development  → Docker Development deployments
+        Production   → Docker Production + ALL mobile builds
+
+      Docker / GHCR
+        Development
+        Production
+
+      Mobile App
+        Project settings
+        Version & versionCode
+        Development
+        Staging
+        Production
+
+      Review current project configuration
+      Exit
+
+${heading('Environment routing')}
+  Docker Development   → Development Jenkins
+  Docker Production    → Production Jenkins
+  Mobile Development   → Production Jenkins
+  Mobile Staging       → Production Jenkins
+  Mobile Production    → Production Jenkins
+
+${heading('Examples')}
+  ${command('indraq configure')}
+  ${command('indraq deploy:dev')}
+  ${command('indraq deploy:prod')}
+  ${command('indraq build mobile:dev --dry-run')}
+  ${command('indraq build mobile:staging --output apk')}
+  ${command('indraq build mobile:prod --output aab --profile clean --verbose')}
+
+${note('Tip: use `indraq help mobile` or `indraq help docker` for focused help.')}
+`;
+exports.fullCommandReference = fullCommandReference;
+const configureHelp = () => `
+${heading('IndraQ configuration')}
+
+  ${command('indraq configure')}
+
+The configuration home lets you change only the section you need and always returns to the home screen after a change.
+
+${heading('Sections')}
+  Jenkins
+    Development  → Docker Development deployments
+    Production   → Docker Production + ALL mobile builds
+
+  Docker / GHCR
+    Development image + Dockerfile
+    Production image + Dockerfile
+    GitHub personal/organization GHCR owner
+
+  Mobile App
+    App name + project type
+    Android Version + versionCode + auto-increment switches
+    Development output/profile
+    Staging output/profile
+    Production output/profile
+
+  Review current project configuration
+  Exit
+
+${note('Jenkins credentials are local-only. Safe project configuration is stored under .indraq/ and can survive Git.')}
+`;
+const dockerHelp = () => `
+${heading('Docker / GHCR deployment')}
+
+${heading('Commands')}
+  ${command('indraq deploy:dev')}                        Development
+  ${command('indraq deploy:development')}                Development alias
+  ${command('indraq deploy:prod')}                       Production
+  ${command('indraq deploy:production')}                 Production alias
+  ${command('indraq deploy build --env dev')}            Long form
+  ${command('indraq deploy build --env prod')}           Long form
+
+${heading('Flow')}
+  Docker build → existing Docker GHCR credentials → GHCR push → Jenkins deployment
+
+${heading('Jenkins mapping')}
+  Development → Development Jenkins
+  Production  → Production Jenkins
+
+${heading('Important')}
+  IndraQ does not run docker login during deployment. It preserves Docker's existing GHCR credential store.
+`;
+const mobileHelp = () => `
+${heading('Mobile Android builds')}
+
+${heading('Commands')}
+  ${command('indraq build mobile:dev')}                  Development
+  ${command('indraq build mobile:development')}          Development alias
+  ${command('indraq build mobile:staging')}              Staging
+  ${command('indraq build mobile:prod')}                 Production
+  ${command('indraq build mobile:production')}           Production alias
+
+${heading('Flags')}
+  ${command('--output <output>')}                        dev-client | debug-apk | apk | aab
+  ${command('--profile <profile>')}                      fast | clean | full-reset
+  ${command('--verbose')}                                Verbose Gradle/Jenkins output
+  ${command('--dry-run')}                                Validate only; do not upload/build
+  ${command('-y, --yes')}                                Skip final confirmation
+
+${heading('Allowed build matrix')}
+  Expo / Development          → Development Client
+  Expo / Staging              → Release APK or Release AAB
+  Expo / Production           → Release APK or Release AAB
+  React Native / Development  → Debug APK
+  React Native / Staging      → Release APK or Release AAB
+  React Native / Production   → Release APK or Release AAB
+
+${heading('Jenkins')}
+  ALL mobile environments use Production Jenkins.
+  Jenkins job: Mobile app Cli build
+
+${heading('Versioning')}
+  Android Version and versionCode are configured through:
+  ${command('indraq configure')} → Mobile App → Version & versionCode
+
+${heading('Examples')}
+  ${command('indraq build mobile:dev --dry-run')}
+  ${command('indraq build mobile:staging --output apk')}
+  ${command('indraq build mobile:prod --output aab --profile clean --verbose --yes')}
+`;
+const doctorHelp = () => `
+${heading('IndraQ doctor')}
+
+  ${command('indraq doctor')}
+
+Checks:
+  • Node.js version
+  • Java availability
+  • Git availability
+  • tar availability
+  • Windows command-resolution order
+  • whether another file/app is shadowing the indraq command
+`;
+const helpForTopic = (topic) => {
+    if (topic === 'configure')
+        return configureHelp();
+    if (topic === 'docker')
+        return dockerHelp();
+    if (topic === 'mobile')
+        return mobileHelp();
+    if (topic === 'doctor')
+        return doctorHelp();
+    return (0, exports.fullCommandReference)();
+};
+exports.helpForTopic = helpForTopic;
+const parseHelpTopic = (value) => {
+    if (!value)
+        return 'all';
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'all')
+        return 'all';
+    if (normalized === 'configure' || normalized === 'config')
+        return 'configure';
+    if (normalized === 'docker' || normalized === 'deploy' || normalized === 'ghcr')
+        return 'docker';
+    if (normalized === 'mobile' || normalized === 'android' || normalized === 'build')
+        return 'mobile';
+    if (normalized === 'doctor' || normalized === 'diagnostics' || normalized === 'diagnostic')
+        return 'doctor';
+    return undefined;
+};
+exports.parseHelpTopic = parseHelpTopic;
+//# sourceMappingURL=help-content.js.map

package/dist/cli/help-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-content.js","sourceRoot":"","sources":["../../src/cli/help-content.ts"],"names":[],"mappings":"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"}

package/dist/modules/deploy/commands/build.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.command.d.ts","sourceRoot":"","sources":["../../../../src/modules/deploy/commands/build.command.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAsBjC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,qBAAqB,CAAC;CAC5B;AA2BD,eAAO,MAAM,KAAK,GAAU,SAAS,YAAY,KAAG,OAAO,CAAC,IAAI,CAmK/D,CAAC"}
+{"version":3,"file":"build.command.d.ts","sourceRoot":"","sources":["../../../../src/modules/deploy/commands/build.command.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAiBjC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,qBAAqB,CAAC;CAC5B;AA2BD,eAAO,MAAM,KAAK,GAAU,SAAS,YAAY,KAAG,OAAO,CAAC,IAAI,CAyJ/D,CAAC"}