gina 0.5.10 → 0.5.11

package/framework/v0.5.11/lib/cmd/image/help.js

@@ -0,0 +1,46 @@
+var fs        = require('fs');
+
+var CmdHelper = require('./../helper');
+var console   = lib.logger;
+
+/**
+ * @module gina/lib/cmd/image/help
+ */
+/**
+ * Displays the image command group help text.
+ *
+ * Usage:
+ *  gina image:help
+ *
+ * @class Help
+ * @constructor
+ * @param {object} opt - Parsed command-line options
+ * @param {object} opt.client - Socket client for terminal output
+ * @param {string[]} opt.argv - Full argv array
+ * @param {number} [opt.debugPort] - Node.js inspector port
+ * @param {boolean} [opt.debugBrkEnabled] - True when --inspect-brk is active
+ * @param {object} cmd - The cmd dispatcher object (lib/cmd/index.js)
+ */
+function Help(opt, cmd) {
+    var self = {};
+
+    /**
+     * Loads CMD helpers and prints the image group help text, then exits.
+     *
+     * @inner
+     * @private
+     */
+    var init = function () {
+
+        new CmdHelper(self, opt.client, { port: opt.debugPort, brkEnabled: opt.debugBrkEnabled });
+
+        if ( !isCmdConfigured() ) return false;
+
+        getHelp();
+        process.exit(0);
+    };
+
+    init();
+}
+
+module.exports = Help;

package/framework/v0.5.11/lib/cmd/image/help.txt

@@ -0,0 +1,72 @@
+
+Usage: gina image:<action> [<bundle>] @<project> [options]
+
+Actions:
+
+    build       Package a project bundle as a standard OCI image.
+                Synthesizes a Containerfile + build context from the project's
+                registered state (bundles, ports, env model, node floor) and
+                executes the build with buildah — natively on Linux, or on a
+                container host reached over ssh.
+
+    help        Show this help.
+    man         Show the image group manual.
+
+Options (image:build):
+
+    --env=<env>              Target env baked into the image (default: the
+                             project's single non-dev env, e.g. prod).
+                             A non-dev env ships the release tree, built
+                             in-image by `gina bundle:build` (dev/prod parity).
+    --scope=<scope>          Target scope (default: the project's production
+                             scope for a non-dev env, else its default scope).
+    --tag=<ref>              Image reference (default: <project>/<bundle>:<env>).
+    --platform=<os/arch>     linux/arm64 or linux/amd64 (default: build-host
+                             native). Cross-arch builds need qemu/binfmt on the
+                             build host.
+    --start-port-from=<n>    First in-container port (default: 3100). The
+                             EXPOSEd port is computed deterministically from
+                             the gina-init allocator.
+    --gina-version=<v>       Framework version installed in the image
+                             (default: the project's registered version).
+    --emit                   Print the synthesized Containerfile, entrypoint
+                             and context manifest — build nothing.
+    --format=json            Machine-readable output. One-shot result:
+                             { project, bundle, image, tag, imageId?,
+                               durationMs, host, exposedPort }
+    --stream                 NDJSON progress frames (one JSON object per line):
+                             start -> step -> log* -> done | error.
+                             `done` carries the one-shot shape.
+
+Container host:
+
+    Where the build executes, in precedence order:
+      1. GINA_CONTAINER_HOST=ssh://[user@]host[:port]   (env override)
+      2. native buildah                                 (Linux + buildah on PATH)
+      3. container.host in ~/.gina/<shortVersion>/settings.json
+    With none of the three available the command fails (exit 1) naming the
+    descriptor surfaces. The remote path streams the build context as a tar
+    over ssh stdin — no listening socket is ever opened.
+
+Secrets:
+
+    ${secret:KEY} placeholders in the project's config ride VERBATIM into the
+    image and resolve from the container's environment at runtime. No secret
+    value is ever read, resolved or baked at build time.
+
+Examples:
+
+    # Inspect the synthesized artifact without building
+    gina image:build @myproject --emit
+
+    # Production image for a single-bundle project
+    gina image:build @myproject
+
+    # Explicit bundle + env, machine-readable result
+    gina image:build demo @myproject --env=prod --format=json
+
+    # Stream progress as NDJSON (CI / GUI consumers)
+    gina image:build demo @myproject --stream
+
+    # Build on a remote Linux box
+    GINA_CONTAINER_HOST=ssh://build@lin gina image:build @myproject

package/framework/v0.5.11/lib/cmd/image/man.js

@@ -0,0 +1,6 @@
+/**
+ * @module gina/lib/cmd/image/man
+ * @description Renders the image group man page (falls back to the group
+ * help.txt while no `gina-image.1.md` exists). Shared engine: `../man-render`.
+ */
+module.exports = require('../man-render');

package/framework/v0.5.11/lib/image-build/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "gina-lib-image-build",
+  "version": "1.0.0",
+  "description": "Pure OCI packaging primitives for the image:build CLI command — Containerfile synthesis, build-context staging, deterministic port computation (bin/gina-init allocator replica) and container-host descriptor resolution.",
+  "authors": [
+    {
+      "name": "Martin-Luther ETOUMAN",
+      "email": "contact@gina.io"
+    }
+  ],
+  "copyright": "Copyright (c) 2009-2026 Rhinostone <contact@gina.io>",
+  "engines": {
+    "node": ">=0.10.22"
+  },
+  "main": "src/main",
+  "license": "MIT"
+}