@quadnix/octo-build 0.0.16 → 0.1.0

package/dist/utilities/definition/yaml/yaml-definition.utility.js

@@ -1,13 +1,22 @@
 import { existsSync, readFileSync } from 'fs';
+import { createRequire } from 'module';
 import { dirname, join, resolve } from 'path';
-import { fileURLToPath } from 'url';
-import { LocalEncryptionStateProvider, LocalStateProvider, TestStateProvider } from '@quadnix/octo';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { LocalEncryptionStateProvider, LocalStateProvider, TestStateProvider, } from '@quadnix/octo';
 import { Ajv2020 as Ajv } from 'ajv/dist/2020.js';
 import { load } from 'js-yaml';
 const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Reads `octo.yml` and turns each section into the values {@link Octo} is booted with.
+ */
 export class YamlDefinitionUtility {
+    /**
+     * @param definitionFilePath Path to the definition file.
+     * @throws If the file is unreadable, or fails schema validation.
+     */
     constructor(definitionFilePath) {
         definitionFilePath = resolve(process.cwd(), definitionFilePath);
+        this.definitionDir = dirname(definitionFilePath);
         if (!existsSync(definitionFilePath)) {
             throw new Error('Cannot find definition file: ' + definitionFilePath);
         }
@@ -20,32 +29,20 @@ export class YamlDefinitionUtility {
         }
         this.validateDefinition();
     }
+    /**
+     * Substitutes `${env.KEY}` references in a value with what the definition's `env` block declares.
+     *
+     * Arrays and objects are walked, because a module input is as nested as its schema: a reference
+     * can sit inside a list of images, or a key of an object, as readily as at the top level.
+     *
+     * @throws If a value holds one of its own ancestors, which no substitution over it terminates on.
+     */
     resolveEnvironmentValue(value) {
-        if (typeof value !== 'string') {
-            return value;
-        }
-        const pattern = value.match(/^\$\{env\.(.+)}$/);
-        if (!pattern || pattern.length < 2) {
-            return value;
-        }
-        const environmentKey = this.definition.env.find((e) => e.key === pattern[1]);
-        if (!environmentKey) {
-            throw new Error(`Key "${pattern[1]}" not found under "env"!`);
-        }
-        let resolvedValue = process.env[pattern[1]] || environmentKey.value;
-        const { kind } = environmentKey;
-        switch (kind) {
-            case 'boolean': {
-                return Boolean(resolvedValue);
-            }
-            case 'number': {
-                return Number(resolvedValue);
-            }
-            default: {
-                return String(resolvedValue);
-            }
-        }
+        return this.resolveNestedEnvironmentValue(value, new Set());
     }
+    /**
+     * Imports the hook callbacks the definition names, in the shape {@link Octo.registerHooks} takes.
+     */
     async resolveHooks() {
         const hooks = {
             postCommitHooks: [],
@@ -60,8 +57,8 @@ export class YamlDefinitionUtility {
         }
         for (const hookDef of this.definition.hooks) {
             const { importPath, method } = hookDef;
-            const resolvedImport = importPath.startsWith('.') || importPath.startsWith('/') ? resolve(process.cwd(), importPath) : importPath;
             try {
+                const resolvedImport = this.resolveImportPath(importPath);
                 const imported = await import(resolvedImport);
                 if (!imported[method]) {
                     throw new Error(`Unable to find export "${method}" in path "${resolvedImport}"!`);
@@ -77,11 +74,14 @@ export class YamlDefinitionUtility {
                 }
             }
             catch (error) {
-                throw new Error(`Failed to import path "${resolvedImport}": ${error?.message || String(error)}`);
+                throw new Error(`Failed to import path "${importPath}": ${error?.message || String(error)}`);
             }
         }
         return hooks;
     }
+    /**
+     * Imports every module class the definition's `imports` block names.
+     */
     async resolveImports() {
         const imports = [];
         if (!this.definition.imports?.length) {
@@ -89,8 +89,8 @@ export class YamlDefinitionUtility {
         }
         for (const importDef of this.definition.imports) {
             const { className, importPath } = importDef;
-            const resolvedImport = importPath.startsWith('.') || importPath.startsWith('/') ? resolve(process.cwd(), importPath) : importPath;
             try {
+                const resolvedImport = this.resolveImportPath(importPath);
                 const imported = await import(resolvedImport);
                 if (!imported[className]) {
                     throw new Error(`Unable to find export "${className}" in path "${resolvedImport}"!`);
@@ -100,32 +100,51 @@ export class YamlDefinitionUtility {
                 }
             }
             catch (error) {
-                throw new Error(`Failed to import path "${resolvedImport}": ${error?.message || String(error)}`);
+                throw new Error(`Failed to import path "${importPath}": ${error?.message || String(error)}`);
             }
         }
         return imports;
     }
-    async resolveListeners() {
+    /**
+     * @param logDestination Where the logging listener writes. `run-action` passes `stderr`, because
+     * terraform's `data "external"` protocol requires that command's stdout to carry only the response
+     * JSON.
+     */
+    async resolveListeners({ logDestination = 'stdout' } = {}) {
         const listeners = [];
         if (!this.definition.settings?.listeners?.length) {
             return listeners;
         }
         for (const listenerDef of this.definition.settings.listeners) {
             if (listenerDef.type === 'HtmlReportEventListener') {
-                if (process.env.OCTO_DISABLE_HTML_REPORT_EVENT_LISTENER?.toLowerCase() !== 'true') {
-                    const imported = await import('@quadnix/octo-event-listeners/html-report');
-                    listeners.push({ type: imported.HtmlReportEventListener });
-                }
+                const imported = await import('@quadnix/octo-event-listeners/html-report');
+                listeners.push({
+                    args: [{ reportDir: listenerDef.reportDir }],
+                    type: imported.HtmlReportEventListener,
+                });
             }
             else if (listenerDef.type === 'LoggingEventListener') {
-                if (process.env.OCTO_DISABLE_LOGGING_EVENT_LISTENER?.toLowerCase() !== 'true') {
-                    const imported = await import('@quadnix/octo-event-listeners/logging');
-                    listeners.push({ type: imported.LoggingEventListener });
-                }
+                const imported = await import('@quadnix/octo-event-listeners/logging');
+                // Default to whether the destination is a terminal, so a redirected log carries no escape
+                // codes. An explicit `colorize:` in the definition still wins.
+                const destinationStream = logDestination === 'stderr' ? process.stderr : process.stdout;
+                listeners.push({
+                    args: [
+                        {
+                            colorize: listenerDef.colorize ?? Boolean(destinationStream.isTTY),
+                            destination: logDestination,
+                            level: listenerDef.level ?? 'info',
+                        },
+                    ],
+                    type: imported.LoggingEventListener,
+                });
             }
         }
         return listeners;
     }
+    /**
+     * Pairs each `modules` entry with its imported class, and resolves its inputs.
+     */
     resolveModules(imports) {
         const modules = [];
         if (!this.definition.modules?.length) {
@@ -145,16 +164,22 @@ export class YamlDefinitionUtility {
         }
         return modules;
     }
+    /**
+     * Builds the {@link IStateProvider} the definition asks for.
+     */
     resolveStateProvider() {
         const stateProvider = this.definition.settings.stateProvider;
+        // Anchored to the definition file for the same reason imports are: `run-action` runs with
+        // terragrunt's cache directory as its cwd, and a state path resolved from there would point at
+        // an empty directory - the action would read no prior state and write its result nowhere useful.
         if (stateProvider.type === 'LocalEncryptionStateProvider') {
             return {
-                type: new LocalEncryptionStateProvider(stateProvider.statePath, stateProvider.encryptionKey),
+                type: new LocalEncryptionStateProvider(resolve(this.definitionDir, stateProvider.statePath), stateProvider.encryptionKey),
             };
         }
         else if (stateProvider.type === 'LocalStateProvider') {
             return {
-                type: new LocalStateProvider(stateProvider.statePath),
+                type: new LocalStateProvider(resolve(this.definitionDir, stateProvider.statePath)),
             };
         }
         else if (stateProvider.type === 'TestStateProvider') {
@@ -166,40 +191,146 @@ export class YamlDefinitionUtility {
             throw new Error(`Invalid state provider!`);
         }
     }
-    resolveTransactionOptions() {
-        const tx = this.definition.settings.transactionOptions || {};
-        const options = {
-            appLockId: undefined,
-            enableResourceCapture: false,
-            enableResourceValidation: false,
-            yieldModelDiffs: tx.yieldModelDiffs || false,
-            yieldModelTransaction: tx.yieldModelTransaction || false,
-            yieldResourceDiffs: tx.yieldResourceDiffs || false,
-            yieldResourceTransaction: tx.yieldResourceTransaction || false,
+    /**
+     * The tag registrations the definition declares, in the shape {@link Octo.registerTags} takes.
+     *
+     * A `scope` naming a `moduleId` reaches that module's resources; an absent or empty one reaches
+     * every resource of the run.
+     */
+    resolveTags() {
+        const tags = [];
+        if (!this.definition.tags?.length) {
+            return tags;
+        }
+        for (const tagDefinition of this.definition.tags) {
+            const resolvedTags = {};
+            for (const [key, value] of Object.entries(tagDefinition.tags)) {
+                // A tag value is always a string, so an `${env.KEY}` declared as a number or a boolean is
+                // rendered rather than handed to the resource as the kind it was declared with.
+                resolvedTags[key] = String(this.resolveEnvironmentValue(value));
+            }
+            tags.push({ scope: tagDefinition.scope || {}, tags: resolvedTags });
+        }
+        return tags;
+    }
+    /**
+     * The terraform version, required providers, and provider blocks the definition declares.
+     */
+    resolveTerraformOptions() {
+        const terraform = this.definition.terraform;
+        const providers = terraform.providers.map((p) => {
+            const spec = {};
+            for (const [key, value] of Object.entries(p.spec || {})) {
+                spec[key] = this.resolveEnvironmentValue(value);
+            }
+            return {
+                accountId: this.resolveEnvironmentValue(p.accountId),
+                accountName: p.accountName ? this.resolveEnvironmentValue(p.accountName) : undefined,
+                providerType: p.providerType,
+                regionId: this.resolveEnvironmentValue(p.regionId),
+                // Passed through as-is: undefined lets octo apply its per-provider-type default.
+                setRegionAttribute: p.setRegionAttribute,
+                spec,
+            };
+        });
+        return {
+            providers,
+            requiredProviders: terraform.requiredProviders,
+            requiredVersion: this.resolveEnvironmentValue(terraform.requiredVersion),
         };
-        if (process.env.OCTO_APP_LOCK_ID) {
-            options.appLockId = process.env.OCTO_APP_LOCK_ID;
+    }
+    /**
+     * Substitutes one `${env.KEY}` reference with what the definition's `env` block declares for that
+     * key, read in the kind the block gives it. Anything holding no reference is returned as it came.
+     */
+    resolveEnvironmentReference(value) {
+        if (typeof value !== 'string') {
+            return value;
         }
-        if (process.env.OCTO_ENABLE_RESOURCE_CAPTURE) {
-            options.enableResourceCapture = process.env.OCTO_ENABLE_RESOURCE_CAPTURE.toLowerCase() === 'true';
+        const pattern = value.match(/^\$\{env\.(.+)}$/);
+        if (!pattern || pattern.length < 2) {
+            return value;
         }
-        if (process.env.OCTO_ENABLE_RESOURCE_VALIDATION) {
-            options.enableResourceValidation = process.env.OCTO_ENABLE_RESOURCE_VALIDATION.toLowerCase() === 'true';
+        // `env` is optional in the schema, so a definition can reference `${env.X}` without declaring
+        // one. Treat that as an empty block and let the "not found" error below report it.
+        const environmentKey = (this.definition.env ?? []).find((e) => e.key === pattern[1]);
+        if (!environmentKey) {
+            throw new Error(`Key "${pattern[1]}" not found under "env"!`);
         }
-        if (process.env.OCTO_YIELD_MODEL_DIFFS) {
-            options.yieldModelDiffs = process.env.OCTO_YIELD_MODEL_DIFFS.toLowerCase() === 'true';
+        let resolvedValue = process.env[pattern[1]] || environmentKey.value;
+        const { kind } = environmentKey;
+        switch (kind) {
+            case 'boolean': {
+                // A shell always supplies a string, and `Boolean("false")` is `true`. Parse the string form
+                // rather than coercing it, and reject anything that is not plainly a boolean.
+                if (typeof resolvedValue === 'boolean') {
+                    return resolvedValue;
+                }
+                const normalizedValue = String(resolvedValue).trim().toLowerCase();
+                if (normalizedValue === 'true') {
+                    return true;
+                }
+                else if (normalizedValue === 'false') {
+                    return false;
+                }
+                else {
+                    throw new Error(`Value "${resolvedValue}" for key "${pattern[1]}" is not a boolean!`);
+                }
+            }
+            case 'number': {
+                return Number(resolvedValue);
+            }
+            default: {
+                return String(resolvedValue);
+            }
         }
-        if (process.env.OCTO_YIELD_MODEL_TRANSACTION) {
-            options.yieldModelTransaction = process.env.OCTO_YIELD_MODEL_TRANSACTION.toLowerCase() === 'true';
+    }
+    /**
+     * Resolves a definition-file import specifier to something `import()` can load.
+     *
+     * A relative path resolves against the **definition file's own directory**. It cannot resolve
+     * against the current working directory: terraform invokes `octo run-action` from inside a
+     * terragrunt cache directory, so a definition saying `./dist/index.js` - which is what every
+     * generated app says - would be looked for under the cache and never found.
+     *
+     * A bare specifier resolves against the **user's project root**, not octo-build's own install
+     * directory - node would otherwise resolve it from wherever octo-build happens to live. A flat
+     * `node_modules` hides that; a linked store does not, and there the user's own dependencies are
+     * invisible.
+     */
+    resolveImportPath(importPath) {
+        if (importPath.startsWith('.') || importPath.startsWith('/')) {
+            return resolve(this.definitionDir, importPath);
         }
-        if (process.env.OCTO_YIELD_RESOURCE_DIFFS) {
-            options.yieldResourceDiffs = process.env.OCTO_YIELD_RESOURCE_DIFFS.toLowerCase() === 'true';
+        const requireFromProject = createRequire(join(this.definitionDir, 'package.json'));
+        return pathToFileURL(requireFromProject.resolve(importPath)).href;
+    }
+    /**
+     * Walks a value, substituting every `${env.KEY}` reference it holds at any depth.
+     *
+     * `ancestors` is the chain currently being walked rather than everything already seen. A YAML
+     * anchor used in two places points one node at two parents, which resolves twice and is no cycle;
+     * a node reappearing beneath itself is one, and walking it never ends.
+     *
+     * @throws If a value holds one of its own ancestors.
+     */
+    resolveNestedEnvironmentValue(value, ancestors) {
+        if (value === null || typeof value !== 'object') {
+            return this.resolveEnvironmentReference(value);
         }
-        if (process.env.OCTO_YIELD_RESOURCE_TRANSACTION) {
-            options.yieldResourceTransaction = process.env.OCTO_YIELD_RESOURCE_TRANSACTION.toLowerCase() === 'true';
+        if (ancestors.has(value)) {
+            throw new Error('Definition holds a value that contains itself!');
         }
-        return options;
+        ancestors.add(value);
+        const resolvedValue = Array.isArray(value)
+            ? value.map((v) => this.resolveNestedEnvironmentValue(v, ancestors))
+            : Object.fromEntries(Object.entries(value).map(([key, v]) => [key, this.resolveNestedEnvironmentValue(v, ancestors)]));
+        ancestors.delete(value);
+        return resolvedValue;
     }
+    /**
+     * Checks the definition against `octo-v1.schema.json`.
+     */
     validateDefinition() {
         if (!this.definition?.version || typeof this.definition?.version !== 'number') {
             throw new Error(`Definition version "${this.definition?.version}" must be a number!`);

package/dist/utilities/definition/yaml/yaml-definition.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"yaml-definition.utility.js","sourceRoot":"","sources":["../../../../src/utilities/definition/yaml/yaml-definition.utility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"yaml-definition.utility.js","sourceRoot":"","sources":["../../../../src/utilities/definition/yaml/yaml-definition.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACnD,OAAO,EAEL,4BAA4B,EAC5B,kBAAkB,EAElB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAqD1D;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAUhC;;;OAGG;IACH,YAAY,kBAA0B;QACpC,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAChE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAEjD,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,kBAAkB,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAoB,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACH,uBAAuB,CAAI,KAAc;QACvC,OAAO,IAAI,CAAC,6BAA6B,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAQhB,MAAM,KAAK,GAA+D;YACxE,eAAe,EAAE,EAAE;YACnB,oBAAoB,EAAE,EAAE;YACxB,uBAAuB,EAAE,EAAE;YAC3B,cAAc,EAAE,EAAE;YAClB,mBAAmB,EAAE,EAAE;YACvB,sBAAsB,EAAE,EAAE;SAC3B,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAC5C,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;YAEvC,IAAI,CAAC;gBACH,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;gBAC1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC9C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,cAAc,cAAc,IAAI,CAAC,CAAC;gBACpF,CAAC;qBAAM,CAAC;oBACN,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzC,KAAK,CAAC,eAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC;oBACtE,KAAK,CAAC,oBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAAC;oBAChF,KAAK,CAAC,uBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC;oBACtF,KAAK,CAAC,cAAe,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;oBACpE,KAAK,CAAC,mBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,CAAC;oBAC9E,KAAK,CAAC,sBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,MAAM,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,OAAO,GAAiE,EAAE,CAAC;QAEjF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAChD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;YAE5C,IAAI,CAAC;gBACH,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;gBAC1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC9C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CAAC,0BAA0B,SAAS,cAAc,cAAc,IAAI,CAAC,CAAC;gBACvF,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,MAAM,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,EAAE,cAAc,GAAG,QAAQ,KAA+C,EAAE;QAOjG,MAAM,SAAS,GAAmE,EAAE,CAAC;QAErF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;YACjD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC7D,IAAI,WAAW,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;gBACnD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;gBAC3E,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC;oBAC5C,IAAI,EAAE,QAAQ,CAAC,uBAAuB;iBACvC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,WAAW,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBACvD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;gBACvE,0FAA0F;gBAC1F,+DAA+D;gBAC/D,MAAM,iBAAiB,GAAG,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;gBACxF,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE;wBACJ;4BACE,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC;4BAClE,WAAW,EAAE,cAAc;4BAC3B,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,MAAM;yBACnC;qBACF;oBACD,IAAI,EAAE,QAAQ,CAAC,oBAAoB;iBACpC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,OAAqE;QAErE,MAAM,OAAO,GAAwD,EAAE,CAAC;QAExE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAChD,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;YAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;YAC7E,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,OAAO,WAAW,2BAA2B,CACjG,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,EAAE,WAAW,EAAE,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;YAEjF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;gBACrE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,oBAAoB;QAIlB,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC7D,0FAA0F;QAC1F,+FAA+F;QAC/F,iGAAiG;QACjG,IAAI,aAAa,CAAC,IAAI,KAAK,8BAA8B,EAAE,CAAC;YAC1D,OAAO;gBACL,IAAI,EAAE,IAAI,4BAA4B,CACpC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,SAAS,CAAC,EACpD,aAAa,CAAC,aAAa,CAC5B;aACF,CAAC;QACJ,CAAC;aAAM,IAAI,aAAa,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;YACvD,OAAO;gBACL,IAAI,EAAE,IAAI,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;aACnF,CAAC;QACJ,CAAC;aAAM,IAAI,aAAa,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACtD,OAAO;gBACL,IAAI,EAAE,IAAI,iBAAiB,EAAE;aAC9B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,WAAW;QACT,MAAM,IAAI,GAAqD,EAAE,CAAC;QAElE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,MAAM,aAAa,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACjD,MAAM,YAAY,GAA8B,EAAE,CAAC;YACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9D,0FAA0F;gBAC1F,gFAAgF;gBAChF,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,uBAAuB;QAYrB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAE5C,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9C,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,uBAAuB,CAAS,CAAC,CAAC,SAAS,CAAC;gBAC5D,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAS,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC5F,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,QAAQ,EAAE,IAAI,CAAC,uBAAuB,CAAS,CAAC,CAAC,QAAQ,CAAC;gBAC1D,iFAAiF;gBACjF,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;gBACxC,IAAI;aACL,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,SAAS;YACT,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;YAC9C,eAAe,EAAE,IAAI,CAAC,uBAAuB,CAAS,SAAS,CAAC,eAAe,CAAC;SACjF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,2BAA2B,CAAI,KAAc;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAU,CAAC;QACpB,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,KAAU,CAAC;QACpB,CAAC;QAED,8FAA8F;QAC9F,mFAAmF;QACnF,MAAM,cAAc,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC;QAEpE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC;QAChC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,4FAA4F;gBAC5F,8EAA8E;gBAC9E,IAAI,OAAO,aAAa,KAAK,SAAS,EAAE,CAAC;oBACvC,OAAO,aAAkB,CAAC;gBAC5B,CAAC;gBACD,MAAM,eAAe,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACnE,IAAI,eAAe,KAAK,MAAM,EAAE,CAAC;oBAC/B,OAAO,IAAS,CAAC;gBACnB,CAAC;qBAAM,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;oBACvC,OAAO,KAAU,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CAAC,UAAU,aAAa,cAAc,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;gBACxF,CAAC;YACH,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,OAAO,MAAM,CAAC,aAAa,CAAM,CAAC;YACpC,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO,MAAM,CAAC,aAAa,CAAM,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,iBAAiB,CAAC,UAAkB;QAC1C,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7D,OAAO,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;QACnF,OAAO,aAAa,CAAC,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;IAED;;;;;;;;OAQG;IACK,6BAA6B,CAAI,KAAc,EAAE,SAAsB;QAC7E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAErB,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACxC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACpE,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,6BAA6B,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CACjG,CAAC;QAEN,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,aAAkB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,kBAAkB;QACxB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,IAAI,OAAO,IAAI,CAAC,UAAU,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,UAAU,EAAE,OAAO,qBAAqB,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,UAAU,GACd,IAAI,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC;YAC3B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC;YAChF,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QACrF,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YAE7E,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,YAAY,IAAI,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,KAAK,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;YAE7B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/utilities/octo/octo.utility.d.ts

@@ -0,0 +1,48 @@
+import { type App, Octo } from '@quadnix/octo';
+/**
+ * Boots only the state provider the definition names, without loading a single module.
+ *
+ * `apply` is a terraform action rather than an octo mode, so it has no reason to compose a model
+ * graph - but terraform state is checked out of the state provider and back into it around every
+ * terraform command, so the provider still has to be there.
+ */
+export declare function bootStateProvider(): Promise<void>;
+/**
+ * @param quietStdout Keeps **stdout** free of everything but the command's own output. Set by
+ * `run-action`, whose stdout is consumed by terraform's `data "external"` as JSON.
+ *
+ * It does not disable listeners — it routes them to stderr, so that the SDK resource-action path,
+ * the only place resource actions actually execute, stays observable.
+ */
+export declare function bootOcto({ quietStdout }?: {
+    quietStdout?: boolean;
+}): Promise<{
+    app: App;
+    octo: Octo;
+}>;
+/**
+ * Makes the environment survive the trip into terraform's `local-exec`.
+ *
+ * An external resource shells back out to `octo` from the terraform that terragrunt runs -
+ * `run-action` from its `local-exec` provisioner, `get-response` from its `data "external"` - and
+ * those commands inherit this process's environment. Two things about it are wrong by default, and
+ * both fail only after real infrastructure exists:
+ *
+ * - **`octo` is a bare binary name**, resolved through `PATH`. Invoking a binary by path -
+ *   `node_modules/.bin/octo apply` - does not put its directory on `PATH` for child processes, so
+ *   the callback dies with `octo: command not found`. The generated app runs the flow through
+ *   package scripts, and `npm run` does put that directory on `PATH`, but running the binary
+ *   directly is still supported and has to work the same. The project's bin directory is prepended
+ *   here, and the directory this CLI is running from after it, so a globally installed or linked
+ *   octo still wins over nothing at all.
+ * - **`OCTO_DEFINITION_FILE_PATH` is usually relative** (`octo.yaml` - the package scripts set
+ *   exactly that), and terraform runs `local-exec` with a terragrunt cache directory as its cwd,
+ *   where that resolves to nothing. It is made absolute here, against the cwd the user actually
+ *   invoked from.
+ */
+export declare function prepareCallbackEnvironment(): void;
+/**
+ * Prints an octo error to stderr, including the properties it carries - the diff that matched no
+ * action, most of all - which a bare stack trace would hide.
+ */
+export declare function reportError(error: any): void;

package/dist/utilities/octo/octo.utility.js

@@ -0,0 +1,144 @@
+import { existsSync } from 'fs';
+import { delimiter, dirname, resolve } from 'path';
+import { Container, Octo, StateManagementService } from '@quadnix/octo';
+import chalk from 'chalk';
+import { YamlDefinitionUtility } from '../definition/yaml/yaml-definition.utility.js';
+/**
+ * The absolute path of the definition file, from `OCTO_DEFINITION_FILE_PATH`.
+ *
+ * @throws If the variable is unset, or names a file that does not exist.
+ */
+function resolveDefinitionFilePath() {
+    const fromEnv = process.env.OCTO_DEFINITION_FILE_PATH;
+    if (!fromEnv) {
+        throw new Error(`Environment variable "OCTO_DEFINITION_FILE_PATH" is not set! Set it to the path of your Octo definition YAML file.`);
+    }
+    const definitionFilePath = resolve(process.cwd(), fromEnv);
+    if (!existsSync(definitionFilePath)) {
+        throw new Error(`Octo definition file not found at "${definitionFilePath}"!`);
+    }
+    return definitionFilePath;
+}
+/**
+ * Boots only the state provider the definition names, without loading a single module.
+ *
+ * `apply` is a terraform action rather than an octo mode, so it has no reason to compose a model
+ * graph - but terraform state is checked out of the state provider and back into it around every
+ * terraform command, so the provider still has to be there.
+ */
+export async function bootStateProvider() {
+    const definition = new YamlDefinitionUtility(resolveDefinitionFilePath());
+    const stateProvider = definition.resolveStateProvider();
+    await Container.getInstance().get(StateManagementService, {
+        args: [stateProvider.type],
+    });
+}
+/**
+ * @param quietStdout Keeps **stdout** free of everything but the command's own output. Set by
+ * `run-action`, whose stdout is consumed by terraform's `data "external"` as JSON.
+ *
+ * It does not disable listeners — it routes them to stderr, so that the SDK resource-action path,
+ * the only place resource actions actually execute, stays observable.
+ */
+export async function bootOcto({ quietStdout = false } = {}) {
+    const definition = new YamlDefinitionUtility(resolveDefinitionFilePath());
+    const hooks = await definition.resolveHooks();
+    const imports = await definition.resolveImports();
+    const listeners = await definition.resolveListeners({ logDestination: quietStdout ? 'stderr' : 'stdout' });
+    const modules = definition.resolveModules(imports);
+    const stateProvider = definition.resolveStateProvider();
+    const tags = definition.resolveTags();
+    const terraformOptions = definition.resolveTerraformOptions();
+    if (!quietStdout) {
+        console.log(chalk.green('Definition file is valid and all modules were successfully imported.'));
+    }
+    // Initialize.
+    const octo = new Octo();
+    await octo.initialize(stateProvider.type, listeners.map((l) => ({
+        options: {
+            args: l.args,
+            metadata: l.metadata,
+        },
+        type: l.type,
+    })));
+    // Register hooks.
+    octo.registerHooks(hooks);
+    // Register terraform config + providers.
+    octo.registerTerraformConfig({
+        minTerraformVersion: terraformOptions.requiredVersion,
+        providers: terraformOptions.requiredProviders,
+    });
+    for (const provider of terraformOptions.providers) {
+        octo.registerTerraformProvider(provider.providerType, provider.accountId, provider.regionId, provider.spec, {
+            accountName: provider.accountName,
+            setRegionAttribute: provider.setRegionAttribute,
+        });
+    }
+    // Load modules.
+    for (const moduleDefinition of modules) {
+        octo.loadModule(moduleDefinition.moduleClass, moduleDefinition.moduleId, moduleDefinition.moduleInputs);
+    }
+    octo.orderModules(modules.map((m) => m.moduleClass));
+    // Compose.
+    await octo.compose();
+    const app = octo.getRootModel();
+    // Register tags. A module-scoped tag names a module that only exists once compose has run it.
+    octo.registerTags(tags);
+    return { app, octo };
+}
+/**
+ * Makes the environment survive the trip into terraform's `local-exec`.
+ *
+ * An external resource shells back out to `octo` from the terraform that terragrunt runs -
+ * `run-action` from its `local-exec` provisioner, `get-response` from its `data "external"` - and
+ * those commands inherit this process's environment. Two things about it are wrong by default, and
+ * both fail only after real infrastructure exists:
+ *
+ * - **`octo` is a bare binary name**, resolved through `PATH`. Invoking a binary by path -
+ *   `node_modules/.bin/octo apply` - does not put its directory on `PATH` for child processes, so
+ *   the callback dies with `octo: command not found`. The generated app runs the flow through
+ *   package scripts, and `npm run` does put that directory on `PATH`, but running the binary
+ *   directly is still supported and has to work the same. The project's bin directory is prepended
+ *   here, and the directory this CLI is running from after it, so a globally installed or linked
+ *   octo still wins over nothing at all.
+ * - **`OCTO_DEFINITION_FILE_PATH` is usually relative** (`octo.yaml` - the package scripts set
+ *   exactly that), and terraform runs `local-exec` with a terragrunt cache directory as its cwd,
+ *   where that resolves to nothing. It is made absolute here, against the cwd the user actually
+ *   invoked from.
+ */
+export function prepareCallbackEnvironment() {
+    const definitionFilePath = process.env.OCTO_DEFINITION_FILE_PATH;
+    if (definitionFilePath) {
+        process.env.OCTO_DEFINITION_FILE_PATH = resolve(process.cwd(), definitionFilePath);
+    }
+    const binDirectories = [resolve(process.cwd(), 'node_modules', '.bin'), dirname(process.argv[1] ?? '')].filter((directory) => directory && existsSync(directory));
+    const pathEntries = (process.env.PATH ?? '').split(delimiter).filter(Boolean);
+    process.env.PATH = [...binDirectories.filter((d) => !pathEntries.includes(d)), ...pathEntries].join(delimiter);
+}
+/**
+ * Prints an octo error to stderr, including the properties it carries - the diff that matched no
+ * action, most of all - which a bare stack trace would hide.
+ */
+export function reportError(error) {
+    console.error(chalk.red(error.stack));
+    for (const errorProperty of Object.getOwnPropertyNames(error) || []) {
+        if (errorProperty !== 'message' && errorProperty !== 'stack') {
+            // Serialized rather than interpolated: the properties worth attaching to an octo error are
+            // objects - the diff that matched no action, most of all - and `${}` renders those as
+            // "[object Object]", which hides the only thing that would identify the node and field.
+            const value = error[errorProperty];
+            const renderedValue = value !== null && typeof value === 'object' ? JSON.stringify(value, undefined, 2) : String(value);
+            console.error(chalk.red(`${errorProperty}: ${renderedValue}`));
+        }
+    }
+    const failures = error.failures || [];
+    if (failures.length > 0) {
+        console.error('\n');
+        console.error(chalk.red('FAILURES'));
+        console.error(chalk.red('========'));
+    }
+    for (let i = 0; i < failures.length; i++) {
+        console.error(chalk.red(`${i + 1}. ${failures[i]}`));
+    }
+}
+//# sourceMappingURL=octo.utility.js.map

package/dist/utilities/octo/octo.utility.js.map

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

package/dist/utilities/process/process.utility.d.ts

@@ -1,4 +1,12 @@
 import { type ChildProcessWithoutNullStreams, type SpawnOptionsWithoutStdio } from 'child_process';
+/**
+ * Spawns the child processes a build job runs.
+ */
 export declare class ProcessUtility {
+    /**
+     * Runs a shell command detached, with its output piped to `outputWriter`.
+     *
+     * @returns The child process, so the caller can watch or kill it.
+     */
     static runDetachedProcess(command: string, options: SpawnOptionsWithoutStdio, outputWriter: any): ChildProcessWithoutNullStreams;
 }

package/dist/utilities/process/process.utility.js

@@ -1,5 +1,13 @@
 import { spawn } from 'child_process';
+/**
+ * Spawns the child processes a build job runs.
+ */
 export class ProcessUtility {
+    /**
+     * Runs a shell command detached, with its output piped to `outputWriter`.
+     *
+     * @returns The child process, so the caller can watch or kill it.
+     */
     static runDetachedProcess(command, options, outputWriter) {
         options = options || {};
         options.detached = true;