rty-test-cli-package 1.0.0

package/bin/forge-app

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+const yargs = require('yargs/yargs');
+const { hideBin } = require('yargs/helpers');
+const fs = require('fs');
+const path = require('path');
+
+yargs(hideBin(process.argv))
+  .command(
+    'build-manifest',
+    'Generate a Forge manifest from a config file',
+    (yargs) => {
+      return yargs
+        .option('config', {
+          alias: 'c',
+          type: 'string',
+          description: 'Path to config file (forge.config.js or manifest.config.js)',
+        })
+        .option('output', {
+          alias: 'o',
+          type: 'string',
+          default: 'manifest.yml',
+          description: 'Output file path',
+        });
+    },
+    (args) => {
+      const { findConfigFile, generateManifest } = require('../dist/cli');
+
+      let configPath = args.config;
+
+      if (!configPath) {
+        configPath = findConfigFile(process.cwd());
+      }
+
+      if (!configPath) {
+        process.stderr.write(
+          'Warning: No config file found.\n'
+          + 'Provide --config <path> or create one of: forge.config.js, manifest.config.js\n',
+        );
+        process.exit(1);
+      }
+
+      const resolvedConfigPath = path.resolve(configPath);
+
+      if (!fs.existsSync(resolvedConfigPath)) {
+        process.stderr.write(`Error: Config file not found: ${resolvedConfigPath}\n`);
+        process.exit(1);
+      }
+
+      const config = require(resolvedConfigPath);
+      const configContent = typeof config === 'function' ? config() : config;
+
+      Promise.resolve(configContent).then((resolved) => {
+        const content = resolved.default ?? resolved;
+        const result = generateManifest(content);
+        const outPath = path.resolve(args.output);
+
+        fs.writeFileSync(outPath, result.yaml, 'utf8');
+        process.stdout.write(`Wrote manifest to ${outPath}\n`);
+      }).catch((err) => {
+        process.stderr.write(`Error: ${err.message ?? err}\n`);
+        process.exit(1);
+      });
+    },
+  )
+  .demandCommand(1, 'You need to specify a command. Use --help for usage info.')
+  .strict()
+  .help()
+  .parse();

package/dist/ManifestBuilder.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+declare const forgeManifestSchema: z.ZodObject<{
+    app: z.ZodObject<{
+        id: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    modules: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+    permissions: z.ZodUnknown;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    app: z.ZodObject<{
+        id: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    modules: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+    permissions: z.ZodUnknown;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    app: z.ZodObject<{
+        id: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    modules: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+    permissions: z.ZodUnknown;
+}, z.ZodTypeAny, "passthrough">>;
+export type ForgeManifest = z.infer<typeof forgeManifestSchema>;
+export interface BuildContext {
+    command: 'build-manifest';
+    mode: string;
+    env: Record<string, string>;
+}
+export default class ManifestBuilder {
+    static findConfigFile(cwd?: string): string | null;
+    static resolveConfigFromFile(configPath: string, context: BuildContext): Promise<Record<string, unknown>>;
+    static resolveConfigFromTemplate(templatePath: string, env: Record<string, string>): Record<string, unknown>;
+    static generateManifest(config: Record<string, unknown>): {
+        yaml: string;
+        object: ForgeManifest;
+    };
+    static validateManifest(manifest: unknown): ForgeManifest;
+    private static getAllowedEnv;
+    private static interpolateString;
+    private static interpolateValue;
+}
+export {};

package/dist/ManifestBuilder.js

@@ -0,0 +1,174 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const module_1 = require("module");
+const path = __importStar(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+const zod_1 = require("zod");
+const CONFIG_NAMES = [
+    'forge.config.js',
+    'forge.config.cjs',
+    'forge.config.mjs',
+    'forge.config.ts',
+    'manifest.config.js',
+    'manifest.config.cjs',
+    'manifest.config.mjs',
+    'manifest.config.ts',
+];
+const PLACEHOLDER_REGEX = /\$\{([^}]+)\}/g;
+const FORGE_APP_PREFIX = 'FORGE_APP_';
+const forgeManifestSchema = zod_1.z
+    .object({
+    app: zod_1.z.object({
+        id: zod_1.z.string(),
+    }).passthrough(),
+    modules: zod_1.z.record(zod_1.z.unknown()).refine((m) => Object.keys(m).length > 0, {
+        message: 'modules cannot be empty',
+    }),
+    permissions: zod_1.z.unknown(),
+})
+    .passthrough();
+class ManifestBuilder {
+    static findConfigFile(cwd = process.cwd()) {
+        const name = CONFIG_NAMES.find((n) => fs.existsSync(path.join(cwd, n)));
+        return name ? path.join(cwd, name) : null;
+    }
+    static async resolveConfigFromFile(configPath, context) {
+        const resolvedPath = path.resolve(configPath);
+        const ext = path.extname(resolvedPath).toLowerCase();
+        const localRequire = (0, module_1.createRequire)(path.join(process.cwd(), '_resolve.js'));
+        if (ext === '.ts') {
+            try {
+                localRequire('ts-node/register');
+            }
+            catch {
+                throw new Error('TypeScript config requires ts-node. Install it: npm i -D ts-node');
+            }
+        }
+        const absPath = path.isAbsolute(resolvedPath)
+            ? resolvedPath
+            : path.resolve(process.cwd(), resolvedPath);
+        const mod = localRequire(absPath);
+        const exported = mod.default ?? mod;
+        if (typeof exported === 'function') {
+            const result = await exported(context);
+            return result != null && typeof result === 'object' ? result : {};
+        }
+        if (typeof exported === 'object' && exported !== null) {
+            return exported;
+        }
+        return {};
+    }
+    static resolveConfigFromTemplate(templatePath, env) {
+        const resolvedPath = path.resolve(templatePath);
+        const raw = fs.readFileSync(resolvedPath, 'utf8');
+        const ext = path.extname(resolvedPath).toLowerCase();
+        let parsed;
+        if (ext === '.json') {
+            parsed = JSON.parse(raw);
+        }
+        else if (ext === '.yml' || ext === '.yaml') {
+            parsed = yaml_1.default.parse(raw);
+        }
+        else {
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                parsed = yaml_1.default.parse(raw);
+            }
+        }
+        const allowed = ManifestBuilder.getAllowedEnv(env);
+        return ManifestBuilder.interpolateValue(parsed, allowed);
+    }
+    static generateManifest(config) {
+        const validated = ManifestBuilder.validateManifest(config);
+        const yaml = yaml_1.default.stringify(validated);
+        return { yaml, object: validated };
+    }
+    static validateManifest(manifest) {
+        const result = forgeManifestSchema.safeParse(manifest);
+        if (!result.success) {
+            const formatted = result.error.format();
+            const message = JSON.stringify(formatted, null, 2);
+            throw new Error(`Manifest validation failed:\n${message}`);
+        }
+        return result.data;
+    }
+    static getAllowedEnv(env) {
+        return Object.entries(env).reduce((acc, [key, value]) => {
+            if (key.startsWith(FORGE_APP_PREFIX) && value !== undefined && value !== null) {
+                acc[key] = String(value);
+            }
+            return acc;
+        }, {});
+    }
+    static interpolateString(str, allowed) {
+        const unknownPlaceholders = [];
+        const result = str.replace(PLACEHOLDER_REGEX, (_, varName) => {
+            const trimmed = varName.trim();
+            if (trimmed in allowed) {
+                return allowed[trimmed];
+            }
+            unknownPlaceholders.push(trimmed);
+            return `\${${trimmed}}`;
+        });
+        if (unknownPlaceholders.length > 0) {
+            process.stderr.write(`[forge-app] Warning: unknown placeholders (not in FORGE_APP_* env): ${unknownPlaceholders.join(', ')}\n`);
+        }
+        return result;
+    }
+    static interpolateValue(value, allowed) {
+        if (typeof value === 'string') {
+            return ManifestBuilder.interpolateString(value, allowed);
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => ManifestBuilder.interpolateValue(item, allowed));
+        }
+        if (value !== null && typeof value === 'object') {
+            return Object.entries(value).reduce((acc, [k, v]) => {
+                acc[k] = ManifestBuilder.interpolateValue(v, allowed);
+                return acc;
+            }, {});
+        }
+        return value;
+    }
+}
+exports.default = ManifestBuilder;
+//# sourceMappingURL=ManifestBuilder.js.map

package/dist/ManifestBuilder.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ManifestBuilder } from './ManifestBuilder';
+export type { ForgeManifest, BuildContext } from './ManifestBuilder';

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManifestBuilder = void 0;
+var ManifestBuilder_1 = require("./ManifestBuilder");
+Object.defineProperty(exports, "ManifestBuilder", { enumerable: true, get: function () { return __importDefault(ManifestBuilder_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,qDAA+D;AAAtD,mIAAA,OAAO,OAAmB"}

package/forge.config.js

@@ -0,0 +1,667 @@
+module.exports = ({ mode, env }) => {
+    const generateName = (name) => {
+        let prefix = '';
+
+        if (process.env.ENV_NAME !== 'production') {
+            prefix = ADDON_PREFIX || '';
+        }
+
+        return `${prefix} ${name}`.trim();
+    };
+
+
+    const FORGE_APP_ID = process.env.TF_VAR_forge_app_id || process.env.FORGE_APP_ID;
+    const BASE_URL = process.env.TF_VAR_base_url || process.env.BASE_URL;
+    const ADDON_KEY = process.env.TF_VAR_addon_key || process.env.ADDON_KEY;
+    const ADDON_PREFIX = process.env.TF_VAR_addon_name || process.env.ADDON_PREFIX;
+    const LICENSE_DISABLED = process.env.TF_VAR_license_disable || process.env.LICENSE_DISABLED;
+    const ANALYTICS_GTM_ENABLED = process.env.ANALYTICS_GTM_ENABLED;
+    const ANALYTICS_ACCOIL_ENABLED = process.env.ANALYTICS_ACCOIL_ENABLED;
+    const PAGE_ICON = 'resource:global-page;assets/images/tis-color.svg';
+
+    return {
+        app: {
+            id: `ari:cloud:ecosystem::app/${FORGE_APP_ID}`,
+            connect: {
+                key: ADDON_KEY,
+                remote: 'connect',
+                authentication: 'jwt'
+            },
+            runtime: {
+                name: 'nodejs20.x'
+            },
+            licensing: {
+                enabled: LICENSE_DISABLED !== 'true',
+                editionsEnabled: LICENSE_DISABLED !== 'true'
+            },
+            "storage": {
+                "entities": [
+                    {
+                        "name": "work-schedules",
+                        "attributes": {
+                            "id": { "type": "string" },
+                            "name": { "type": "string" },
+                            "createdBy": { "type": "string" },
+                            "updatedBy": { "type": "string" },
+                            "createdAt": { "type": "string" },
+                            "updatedAt": { "type": "string" },
+                            "schedule": { "type": "any" },
+                        },
+                        "indexes": [
+                            "name"
+                        ]
+                    },
+                    {
+                        "name": "custom-fields",
+                        "attributes": {
+                            "fieldId": {
+                                "type": "string"
+                            },
+                            "boardId": {
+                                "type": "integer"
+                            },
+                            "workScheduleId": {
+                                "type": "string"
+                            },
+                            "statusIds": {
+                                "type": "any"
+                            },
+                            "trashed": {
+                                "type": "boolean"
+                            },
+                            "createdAt": {
+                                "type": "string"
+                            },
+                            "createdBy": {
+                                "type": "string"
+                            },
+                            "version": {
+                                "type": "integer"
+                            }
+                        },
+                        "indexes": [
+                            "fieldId",
+                            "boardId",
+                            "trashed"
+                        ]
+                    },
+                    {
+                        "name": "presets",
+                        "attributes": {
+                            "id": {
+                                "type": "string"
+                            },
+                            "name": {
+                                "type": "string"
+                            },
+                            "reportConfig": {
+                                "type": "any"
+                            },
+                            "createdBy": {
+                                "type": "string"
+                            },
+                            "updatedAt": {
+                                "type": "string"
+                            },
+                            "createdAt": {
+                                "type": "string"
+                            },
+                            "isPublic": {
+                                "type": "boolean"
+                            }
+                        },
+                        "indexes": [
+                            "createdBy",
+                            "isPublic",
+                            "name"
+                        ]
+                    },
+                    {
+                        "name": "shared-reports",
+                        "attributes": {
+                            "id": {
+                                "type": "string"
+                            },
+                            "reportConfig": {
+                                "type": "any"
+                            },
+                            "createdBy": {
+                                "type": "string"
+                            },
+                            "createdAt": {
+                                "type": "string"
+                            },
+                            "lastVisit": {
+                                "type": "string"
+                            }
+                        }
+                    },
+                    {
+                        "name": "permissions",
+                        "attributes": {
+                            "key": {
+                                "type": "string"
+                            },
+                            "operator": {
+                                "type": "string"
+                            },
+                            "groups": {
+                                "type": "any"
+                            },
+                            "updatedAt": {
+                                "type": "string"
+                            },
+                            "updatedBy": {
+                                "type": "string"
+                            }
+                        },
+                        "indexes": [
+                            "key",
+                            "operator",
+                            "updatedBy"
+                        ]
+                    }
+                ]
+            }
+        },
+        remotes: [
+            {
+                key: 'connect',
+                baseUrl: BASE_URL,
+                operations: [
+                    'storage',
+                    'compute'
+                ],
+                auth: {
+                    appSystemToken: {
+                        enabled: true
+                    },
+                    appUserToken: {
+                        enabled: true
+                    }
+                },
+                storage: {
+                    inScopeEUD: true
+                }
+            }
+        ],
+        modules: {
+            "trigger": [
+                {
+                    "key": "app-lifecycle",
+                    "function": "lifecycle",
+                    "events": [
+                        "avi:forge:installed:app",
+                        "avi:forge:upgraded:app"
+                    ],
+                },
+                {
+                    "key": "custom-field-triggers",
+                    "function": "cf-triggers",
+                    "events": [
+                        "avi:jira:deleted:field",
+                        "avi:jira:restored:field",
+                        "avi:jira:trashed:field",
+                        "avi:jira-software:deleted:board"
+                    ],
+                    "filter": {
+                        "ignoreSelf": true,
+                        "onError": "RECEIVE_AND_LOG"
+                    }
+                },
+                // Commented out: issue update trigger temporarily disabled
+                // {
+                //   "key": "cf-issue-updated",
+                //   "function": "cf-triggers",
+                //   "events": [
+                //     "avi:jira:updated:issue"
+                //   ],
+                //   "filter": {
+                //     "ignoreSelf": true,
+                //     "expression": "!!event.associatedStatuses\n",
+                //     "onError": "RECEIVE_AND_LOG"
+                //   }
+                // }
+            ],
+            "scheduledTrigger": [
+                {
+                    "key": "cf-hourly-trigger",
+                    "function": "cf-recompute",
+                    "interval": "hour"
+                }
+            ],
+            "consumer": [
+                {
+                    "key": "cf-queue",
+                    "queue": "cf-process-queue",
+                    "function": "cf-compute"
+                }
+            ],
+            "jira:customFieldType": [
+                {
+                    "key": "tis-custom-field-type",
+                    "name": "Time in status field type",
+                    "description": "A custom field that shows a time in status.",
+                    "icon": "resource:custom-fields;assets/tis-color.svg",
+                    "type": "number",
+                    "readOnly": true,
+                    "view": {
+                        "experience": [
+                            "issue-view"
+                        ],
+                        "value": {
+                            "function": "cf-issue-opened"
+                        },
+                        "formatter": {
+                            "expression": "let days  = (value - value % 86400) / 86400;\nlet hours = ((value % 86400) - value % 3600) / 3600;\n\ndays > 0 && hours > 0\n  ? `${days}d ${hours}h`\n  : days > 0\n    ? `${days}d`\n    : `${hours}h`\n"
+                        }
+                    },
+                    "edit": {
+                        "parser": {
+                            "expression": "let dMatch = value.match(\"([0-9]+)\\s*d\");\nlet hMatch = value.match(\"([0-9]+)\\s*h\");\n\nlet days  = dMatch ? Number(dMatch[1]) : 0;\nlet hours = hMatch ? Number(hMatch[1]) : 0;\n\ndays * 86400 + hours * 3600\n"
+                        }
+                    }
+                }
+            ],
+            'jira:dashboardGadget': [
+                {
+                    key: 'status-distribution-gadget',
+                    resource: 'project-burnup',
+                    resolver: {
+                        function: 'resolver'
+                    },
+                    title: generateName('Burndown Status Tracker'),
+                    description: 'Keep work flowing. Visualize status trends over time and jump straight to the matching work items.',
+                    thumbnail: 'resource:project-burnup;assets/images/dashboard-thumbnail.svg',
+                },
+            ],
+            'jira:boardAction': [
+                {
+                    key: 'custom-fields',
+                    resource: 'custom-fields',
+                    viewportSize: 'medium',
+                    resolver: {
+                        function: 'resolver'
+                    },
+                    title: `${ADDON_PREFIX} Agile Board`,
+                    tooltip: `${ADDON_PREFIX} Agile Board`,
+                    icon: 'resource:custom-fields;assets/tis-color.svg',
+                    displayConditions: {
+                        canAdministerJira: true,
+                        jiraExpression: 'project.style != \'next-gen\'',
+                    }
+                },
+            ],
+            "jira:projectPage": [
+                {
+                    key: "sprint-report-project-page",
+                    resource: "sprint-report",
+                    resolver: {
+                        function: 'resolver'
+                    },
+                    title: `${`${ADDON_PREFIX} `}Sprint Performance Report`,
+                    layout: "blank",
+                    icon: 'resource:sprint-report;assets/tis-color.svg',
+                }
+            ],
+            'jira:adminPage': [
+                {
+                    key: 'tis-get-started',
+                    resource: 'get-started',
+                    title: generateName('Get started'),
+                    useAsGetStarted: true,
+                    layout: 'blank',
+                    resolver: {
+                        function: 'resolver'
+                    },
+                    conditions: [
+                        'user_is_logged_in'
+                    ]
+                }
+            ],
+            'jira:globalPage': [
+                {
+                    key: 'global-page',
+                    resource: 'global-page',
+                    title: ADDON_PREFIX,
+                    layout: 'blank',
+                    icon: PAGE_ICON,
+                    pages: [
+                        {
+                            title: 'Main page',
+                            route: '/main',
+                            icon: PAGE_ICON,
+                        },
+                        {
+                            title: 'Work Schedule',
+                            route: '/work-schedule',
+                            icon: PAGE_ICON,
+                        },
+                        {
+                            title: 'Permissions',
+                            route: '/permissions',
+                            icon: PAGE_ICON,
+                        }
+                    ],
+                    resolver: {
+                        function: 'resolver'
+                    },
+                    conditions: [
+                        'user_is_logged_in'
+                    ]
+                }
+            ],
+            'jira:issueActivity': [
+                {
+                    key: 'activity-tab',
+                    title: ADDON_PREFIX,
+                    resource: 'activity-tab',
+                    resolver: {
+                        function: 'resolver'
+                    },
+                    displayConditions: {
+                        isLoggedIn: true,
+                    },
+                }
+            ],
+            function: [
+                {
+                    key: 'resolver',
+                    handler: 'index.handler'
+                },
+                {
+                    "key": "cf-triggers",
+                    "handler": "index.customFieldTriggers"
+                },
+                {
+                    "key": "cf-issue-opened",
+                    "handler": "index.issueOpened"
+                },
+                {
+                    "key": "cf-recompute",
+                    "handler": "index.recomputeCustomField"
+                },
+                {
+                    "key": "cf-compute",
+                    "handler": "index.computeCustomField",
+                    "timeoutSeconds": 900
+                },
+                {
+                    "key": "calc-flagged-tis-fn",
+                    "handler": "index.calculateFlaggedStatusTime"
+                },
+                {
+                    "key": "lifecycle",
+                    "handler": "index.lifecycle"
+                }
+            ],
+            action: [
+                {
+                    "key": "calc-flagged-tis",
+                    "name": "Calculate Flagged Status Time",
+                    "function": "calc-flagged-tis-fn",
+                    "actionVerb": "GET",
+                    "description": "Calculate the time work items spent in each status while flagged",
+                    "inputs": {
+                        "jql": {
+                            "title": "JQL Query",
+                            "type": "string",
+                            "required": false,
+                            "description": "JQL query to filter work items"
+                        },
+                        "filterId": {
+                            "title": "Filter Id",
+                            "type": "string",
+                            "required": false,
+                            "description": "Filter Id to filter work items"
+                        },
+                        "filterName": {
+                            "title": "Filter Name",
+                            "type": "string",
+                            "required": false,
+                            "description": "Filter Name to filter work items"
+                        },
+                        "from": {
+                            "title": "From Date",
+                            "type": "string",
+                            "required": false,
+                            "description": "Start date (ISO 8601)"
+                        },
+                        "to": {
+                            "title": "To Date",
+                            "type": "string",
+                            "required": false,
+                            "description": "End date (ISO 8601)"
+                        },
+                        "timezone": {
+                            "title": "Timezone",
+                            "type": "string",
+                            "required": false,
+                            "description": "IANA timezone (e.g., America/New_York)"
+                        },
+                        "excludedStatuses": {
+                            "title": "Excluded Statuses (CSV)",
+                            "type": "string",
+                            "required": false,
+                            "description": "Comma-separated list of statuses to exclude"
+                        },
+                        "targetStatuses": {
+                            "title": "Target Statuses (CSV)",
+                            "type": "string",
+                            "required": false,
+                            "description": "Comma-separated list of statuses to include"
+                        },
+                        "maxResults": {
+                            "title": "Max Results",
+                            "type": "integer",
+                            "required": false,
+                            "description": "Maximum number of issues to process"
+                        }
+                    }
+                }
+            ],
+            "rovo:agent": [
+                {
+                    key: "time-in-status-agent",
+                    name: `FlagFocus by ${ADDON_PREFIX}`,
+                    icon: "resource:forge-static;rovo-agent-logo.svg",
+                    description:
+                        "From overview to action: totals, breakdowns, and takeaways that help teams unstick flagged work quickly.",
+                    prompt: `resource:rovoPrompts;flaggedAgent/prompt.txt`,
+                    conversationStarters: [
+                        "Tell me about yourself",
+                        "Count flagged work items for the last 30 days",
+                        "What’s the flagged time for today?"
+                    ],
+                    actions: ["calc-flagged-tis"]
+                }
+            ]
+        },
+        resources: [
+            {
+                key: 'custom-fields',
+                path: '../custom-fields/dist',
+                tunnel: {
+                    port: 3002
+                }
+            },
+            {
+                key: 'forge-static',
+                path: 'static',
+            },
+            {
+                key: 'global-page',
+                path: '../global-page/dist',
+                tunnel: {
+                    port: 3003
+                }
+            },
+            {
+                key: 'get-started',
+                path: '../get-started/dist',
+                tunnel: {
+                    port: 3001
+                }
+            },
+            {
+                key: "sprint-report",
+                path: '../sprint-report/dist',
+                tunnel: {
+                    port: 5173
+                }
+            },
+            {
+                key: "rovoPrompts",
+                path: './rovo',
+            },
+            {
+                key: 'activity-tab',
+                path: '../activity-tab/dist',
+                tunnel: {
+                    port: 3005
+                }
+            },
+            {
+                key: 'project-burnup',
+                path: '../dashboard-project-burnup/dist',
+                tunnel: {
+                    port: 3004
+                }
+            },
+        ],
+        connectModules: {
+            'jira:lifecycle': [
+                {
+                    key: 'lifecycle-events',
+                    installed: '/installed?v=3.32.0',
+                    uninstalled: '/uninstalled'
+                }
+            ],
+            'jira:jiraDashboardItems': [
+                {
+                    name: {
+                        value: generateName('Accurate Time in Status'),
+                    },
+                    url: '/dashboard-gadget-tis?dashboard={dashboard.id}&dashboardItem={dashboardItem.id}',
+                    cacheable: true,
+                    key: 'dashboard-gadget-tis',
+                    description: {
+                        value: 'Track time issues spend in each status. Identify delays with charts and lists. Boost efficiency now.'
+                    },
+                    thumbnailUrl: '/images/dashboard-thumbnail.svg',
+                    configurable: true,
+                    conditions: [
+                        {
+                            condition: 'user_is_logged_in'
+                        }
+                    ]
+                }
+            ],
+            'jira:webhooks': [
+                {
+                    event: 'board_deleted',
+                    url: '/webhooks',
+                    key: 'webhook-1'
+                },
+                {
+                    event: 'sprint_closed',
+                    url: '/webhooks',
+                    key: 'webhook-2'
+                },
+                {
+                    event: 'board_configuration_changed',
+                    url: '/webhooks',
+                    key: 'webhook-3'
+                }
+            ],
+            'jira:generalPages': [
+                {
+                    key: 'tis-access-settings',
+                    location: 'admin_plugins_menu/example-menu-section',
+                    name: {
+                        value: generateName('Time in Status Permissions'),
+                    },
+                    url: '/configuration-access',
+                    conditions: [
+                        {
+                            condition: 'user_is_logged_in'
+                        }
+                    ]
+                },
+                {
+                    key: 'tis-calendar-settings',
+                    location: 'admin_plugins_menu/example-menu-section',
+                    name: {
+                        value: generateName('Time in Status Work Calendars'),
+                    },
+                    url: '/configuration-calendar',
+                    conditions: [
+                        {
+                            condition: 'user_is_logged_in'
+                        }
+                    ]
+                },
+                {
+                    key: 'get-started',
+                    location: 'admin_plugins_menu/example-menu-section',
+                    name: {
+                        value: generateName('Get started'),
+                    },
+                    url: '/pages/get-started',
+                    conditions: [
+                        {
+                            condition: 'user_is_logged_in'
+                        }
+                    ]
+                }
+            ],
+            'jira:webSections': [
+                {
+                    key: 'example-menu-section',
+                    location: 'admin_plugins_menu',
+                    name: {
+                        value: ADDON_PREFIX
+                    }
+                },
+            ]
+        },
+        permissions: {
+            scopes: {
+                "read:board-scope.admin:jira-software": {
+                    "allowImpersonation": true
+                },
+                "read:project:jira": {
+                    "allowImpersonation": true
+                },
+                "read:board-scope:jira-software": {
+                    "allowImpersonation": true
+                },
+                "read:issue-details:jira": {
+                    "allowImpersonation": true
+                },
+                "manage:jira-configuration": {},
+                "read:app-system-token": {},
+                "read:app-user-token": {},
+                "read:jira-user": {},
+                "read:jira-work": {},
+                "read:chat:rovo": {},
+                "read:sprint:jira-software": {},
+                "storage:app": {},
+                "write:app-data:jira": {},
+                "write:board-scope:jira-software": {},
+                "write:jira-work": {},
+                "write:project:jira": {},
+                "write:sprint:jira-software": {},
+
+                "read:connect-jira": {},
+                "act-as-user:connect-jira": {},
+                "write:connect-jira": {},
+            },
+            content: {
+                styles: [
+                    'unsafe-inline'
+                ]
+            },
+        }
+    };
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "rty-test-cli-package",
+  "version": "1.0.0",
+  "description": "A TypeScript CLI package",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TymchukRoman/-rty-test-cli-package"
+  },
+  "bin": {
+    "forge-app": "bin/forge-app"
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "author": "Roman Tymchuk <roman.t@saasjet.com>",
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/yargs": "^17.0.33",
+    "@typescript-eslint/eslint-plugin": "^8.41.0",
+    "@typescript-eslint/parser": "^8.41.0",
+    "eslint-plugin-import-x": "^4.16.1",
+    "eslint": "^9.34.0",
+    "eslint-plugin-jest": "^29.0.1",
+    "jest": "^29.7.0",
+    "rimraf": "^5.0.10",
+    "ts-jest": "^29.2.6",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "yaml": "^2.7.0",
+    "yargs": "^17.7.2",
+    "zod": "^3.24.2"
+  },
+  "keywords": []
+}

package/src/ManifestBuilder.ts

@@ -0,0 +1,175 @@
+import * as fs from 'fs';
+import { createRequire } from 'module';
+import * as path from 'path';
+
+import YAML from 'yaml';
+import { z } from 'zod';
+
+const CONFIG_NAMES = [
+  'forge.config.js',
+  'forge.config.cjs',
+  'forge.config.mjs',
+  'forge.config.ts',
+  'manifest.config.js',
+  'manifest.config.cjs',
+  'manifest.config.mjs',
+  'manifest.config.ts',
+];
+
+const PLACEHOLDER_REGEX = /\$\{([^}]+)\}/g;
+const FORGE_APP_PREFIX = 'FORGE_APP_';
+
+const forgeManifestSchema = z
+  .object({
+    app: z.object({
+      id: z.string(),
+    }).passthrough(),
+    modules: z.record(z.unknown()).refine((m) => Object.keys(m).length > 0, {
+      message: 'modules cannot be empty',
+    }),
+    permissions: z.unknown(),
+  })
+  .passthrough();
+
+export type ForgeManifest = z.infer<typeof forgeManifestSchema>;
+
+export interface BuildContext {
+  command: 'build-manifest';
+  mode: string;
+  env: Record<string, string>;
+}
+
+export default class ManifestBuilder {
+  static findConfigFile(cwd: string = process.cwd()): string | null {
+    const name = CONFIG_NAMES.find((n) => fs.existsSync(path.join(cwd, n)));
+    return name ? path.join(cwd, name) : null;
+  }
+
+  static async resolveConfigFromFile(
+    configPath: string,
+    context: BuildContext,
+  ): Promise<Record<string, unknown>> {
+    const resolvedPath = path.resolve(configPath);
+    const ext = path.extname(resolvedPath).toLowerCase();
+    const localRequire = createRequire(path.join(process.cwd(), '_resolve.js'));
+
+    if (ext === '.ts') {
+      try {
+        localRequire('ts-node/register');
+      } catch {
+        throw new Error(
+          'TypeScript config requires ts-node. Install it: npm i -D ts-node',
+        );
+      }
+    }
+
+    const absPath = path.isAbsolute(resolvedPath)
+      ? resolvedPath
+      : path.resolve(process.cwd(), resolvedPath);
+
+    const mod = localRequire(absPath);
+    const exported = mod.default ?? mod;
+
+    if (typeof exported === 'function') {
+      const result = await exported(context);
+      return result != null && typeof result === 'object' ? result : {};
+    }
+
+    if (typeof exported === 'object' && exported !== null) {
+      return exported as Record<string, unknown>;
+    }
+
+    return {};
+  }
+
+  static resolveConfigFromTemplate(
+    templatePath: string,
+    env: Record<string, string>,
+  ): Record<string, unknown> {
+    const resolvedPath = path.resolve(templatePath);
+    const raw = fs.readFileSync(resolvedPath, 'utf8');
+    const ext = path.extname(resolvedPath).toLowerCase();
+
+    let parsed: unknown;
+    if (ext === '.json') {
+      parsed = JSON.parse(raw);
+    } else if (ext === '.yml' || ext === '.yaml') {
+      parsed = YAML.parse(raw);
+    } else {
+      try {
+        parsed = JSON.parse(raw);
+      } catch {
+        parsed = YAML.parse(raw);
+      }
+    }
+
+    const allowed = ManifestBuilder.getAllowedEnv(env);
+    return ManifestBuilder.interpolateValue(parsed, allowed) as Record<string, unknown>;
+  }
+
+  static generateManifest(
+    config: Record<string, unknown>,
+  ): { yaml: string; object: ForgeManifest } {
+    const validated = ManifestBuilder.validateManifest(config);
+    const yaml = YAML.stringify(validated);
+    return { yaml, object: validated };
+  }
+
+  static validateManifest(manifest: unknown): ForgeManifest {
+    const result = forgeManifestSchema.safeParse(manifest);
+    if (!result.success) {
+      const formatted = result.error.format();
+      const message = JSON.stringify(formatted, null, 2);
+      throw new Error(`Manifest validation failed:\n${message}`);
+    }
+    return result.data;
+  }
+
+  private static getAllowedEnv(env: Record<string, string>): Record<string, string> {
+    return Object.entries(env).reduce<Record<string, string>>((acc, [key, value]) => {
+      if (key.startsWith(FORGE_APP_PREFIX) && value !== undefined && value !== null) {
+        acc[key] = String(value);
+      }
+      return acc;
+    }, {});
+  }
+
+  private static interpolateString(str: string, allowed: Record<string, string>): string {
+    const unknownPlaceholders: string[] = [];
+    const result = str.replace(PLACEHOLDER_REGEX, (_, varName: string) => {
+      const trimmed = varName.trim();
+      if (trimmed in allowed) {
+        return allowed[trimmed];
+      }
+      unknownPlaceholders.push(trimmed);
+      return `\${${trimmed}}`;
+    });
+
+    if (unknownPlaceholders.length > 0) {
+      process.stderr.write(
+        `[forge-app] Warning: unknown placeholders (not in FORGE_APP_* env): ${unknownPlaceholders.join(', ')}\n`,
+      );
+    }
+
+    return result;
+  }
+
+  private static interpolateValue(value: unknown, allowed: Record<string, string>): unknown {
+    if (typeof value === 'string') {
+      return ManifestBuilder.interpolateString(value, allowed);
+    }
+    if (Array.isArray(value)) {
+      return value.map((item) => ManifestBuilder.interpolateValue(item, allowed));
+    }
+    if (value !== null && typeof value === 'object') {
+      return Object.entries(value as Record<string, unknown>).reduce<Record<string, unknown>>(
+        (acc, [k, v]) => {
+          acc[k] = ManifestBuilder.interpolateValue(v, allowed);
+          return acc;
+        },
+        {},
+      );
+    }
+    return value;
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { default as ManifestBuilder } from './ManifestBuilder';
+export type { ForgeManifest, BuildContext } from './ManifestBuilder';

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "allowSyntheticDefaultImports": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "target": "es2021",
+    "declaration": true,
+    "sourceMap": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "jsx": "react",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+  },
+  "exclude": [
+    "node_modules",
+    "../../node_modules",
+    "dist"
+  ],
+  "include": [
+    "src/**/*",
+    ".d.ts",
+  ]
+}