@forge/cli-shared 8.22.1-next.1 → 8.23.0-next.11

package/CHANGELOG.md

@@ -1,5 +1,92 @@
 # @forge/cli-shared
 
+## 8.23.0-next.11
+
+### Minor Changes
+
+- 369bc9b: `ForgeCliAttribution.agentHint()` now delegates agent detection to [`@vercel/detect-agent`](https://www.npmjs.com/package/@vercel/detect-agent), expanding coverage and replacing the previous brittle PATH-based heuristic. The set of recognised agents is defined by the upstream library. Rovo Dev and Windsurf are still detected directly within `ForgeCliAttribution` and take precedence over the library's result. `agentHint()` and `build()` are now `async` and must be `await`ed by callers.
+
+### Patch Changes
+
+- Updated dependencies [e5b5031]
+  - @forge/manifest@12.8.0-next.9
+
+## 8.23.0-next.10
+
+### Minor Changes
+
+- 3bbb9da: Extend `ForgeCliAttribution` to emit additional fields on the `atl-attribution` GraphQL header and GASv3 analytics events: `skillName`, `agentHint` (auto-detects rovo-dev, claude-code, cursor, codex, antigravity, opencode, windsurf, gemini, github-copilot), and `isStudio`. All three are sourced from reserved `ATL_FORGE_ATTRIBUTION_*` env vars with input validation. Adds a generic `ATL_FORGE_ATTRIBUTION_<KEY>` wildcard pass-through so additional attribution fields can be supplied via environment variables (with key/value validation and reserved-field protection)
+
+### Patch Changes
+
+- Updated dependencies [bf76c3c]
+  - @forge/manifest@12.8.0-next.8
+
+## 8.23.0-next.9
+
+### Minor Changes
+
+- 30060eb: Emit `isAgent`/`isCI` on GASv3 analytics events via a new shared `ForgeCliAttribution` class, used by both the `atl-attribution` GraphQL header and analytics client.
+
+## 8.23.0-next.8
+
+### Patch Changes
+
+- Updated dependencies [f7c39e1]
+  - @forge/manifest@12.8.0-next.7
+
+## 8.23.0-next.7
+
+### Patch Changes
+
+- Updated dependencies [e7b0684]
+  - @forge/manifest@12.8.0-next.6
+
+## 8.23.0-next.6
+
+### Patch Changes
+
+- ef0434d: Added support for multi-entry resources in UI Kit applications, enabling developers to define multiple entry points within a single resource.
+- Updated dependencies [ef0434d]
+  - @forge/manifest@12.8.0-next.5
+
+## 8.23.0-next.5
+
+### Patch Changes
+
+- Updated dependencies [1eded6e]
+- Updated dependencies [cf7000f]
+- Updated dependencies [d660fb0]
+  - @forge/manifest@12.8.0-next.4
+
+## 8.23.0-next.4
+
+### Minor Changes
+
+- a885062: Support a limit parameter in the version bulk-upgrade start command
+
+### Patch Changes
+
+- 84d9930: adding option to include installation-id for uninstall flow
+
+## 8.23.0-next.3
+
+### Patch Changes
+
+- Updated dependencies [8d90f4f]
+  - @forge/manifest@12.8.0-next.3
+
+## 8.23.0-next.2
+
+### Minor Changes
+
+- 808adbd: Grouped commands in CLI help and commander.js version bump
+
+### Patch Changes
+
+- Updated dependencies [55991a3]
+  - @forge/manifest@12.8.0-next.2
+
 ## 8.22.1-next.1
 
 ### Patch Changes

package/out/ari/ari.d.ts

@@ -1,6 +1,7 @@
 import { Ari, AnyAri, JiraWorkspaceAri, ConfluenceWorkspaceAri, CompassWorkspaceAri, GraphWorkspaceAri } from '@forge/util/packages/ari';
 export declare const SITE_RESOURCE_TYPE = "site";
 export declare const WORKSPACE_RESOURCE_TYPE = "workspace";
+export declare const INSTALLATION_RESOURCE_TYPE = "installation";
 export declare const TRELLO_RESOURCE_OWNER = "trello";
 export declare const BITBUCKET_RESOURCE_OWNER = "bitbucket";
 export declare function appIdToAriString(appId: string): string;
@@ -13,6 +14,9 @@ export declare class UnknownSiteWithoutResourceIdError extends Error {
 export declare class UnknownWorkspaceWithoutResourceIdError extends Error {
     constructor();
 }
+export declare class UnknownInstallationWithoutResourceIdError extends Error {
+    constructor();
+}
 export declare function parseInstallationContext(installationContext: string): AnyAri;
 export declare const createWorkspaceAriByProduct: {
     jira: (siteId: string, activationId: string) => JiraWorkspaceAri;

package/out/ari/ari.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ari.d.ts","sourceRoot":"","sources":["../../src/ari/ari.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,MAAM,EACN,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAIlC,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,uBAAuB,cAAc,CAAC;AACnD,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,wBAAwB,cAAc,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAMrE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,GAAG,CAMhG;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM,CAKlE;AACD,qBAAa,iCAAkC,SAAQ,KAAK;;CAI3D;AACD,qBAAa,sCAAuC,SAAQ,KAAK;;CAIhE;AASD,wBAAgB,wBAAwB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAoB5E;AAGD,eAAO,MAAM,2BAA2B;mBACvB,MAAM,gBAAgB,MAAM;yBACtB,MAAM,gBAAgB,MAAM;sBAC/B,MAAM,eAAe,MAAM;qBAC5B,MAAM,gBAAgB,MAAM;CAC9C,CAAC"}
+{"version":3,"file":"ari.d.ts","sourceRoot":"","sources":["../../src/ari/ari.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,MAAM,EACN,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAIlC,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,uBAAuB,cAAc,CAAC;AACnD,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AACzD,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,wBAAwB,cAAc,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAMrE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,GAAG,CAMhG;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM,CAKlE;AACD,qBAAa,iCAAkC,SAAQ,KAAK;;CAI3D;AACD,qBAAa,sCAAuC,SAAQ,KAAK;;CAIhE;AACD,qBAAa,yCAA0C,SAAQ,KAAK;;CAInE;AASD,wBAAgB,wBAAwB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CA0B5E;AAGD,eAAO,MAAM,2BAA2B;mBACvB,MAAM,gBAAgB,MAAM;yBACtB,MAAM,gBAAgB,MAAM;sBAC/B,MAAM,eAAe,MAAM;qBAC5B,MAAM,gBAAgB,MAAM;CAC9C,CAAC"}

package/out/ari/ari.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWorkspaceAriByProduct = exports.parseInstallationContext = exports.UnknownWorkspaceWithoutResourceIdError = exports.UnknownSiteWithoutResourceIdError = exports.encodeContext = exports.buildExtensionAri = exports.buildContextAri = exports.appIdToAriString = exports.BITBUCKET_RESOURCE_OWNER = exports.TRELLO_RESOURCE_OWNER = exports.WORKSPACE_RESOURCE_TYPE = exports.SITE_RESOURCE_TYPE = void 0;
+exports.createWorkspaceAriByProduct = exports.parseInstallationContext = exports.UnknownInstallationWithoutResourceIdError = exports.UnknownWorkspaceWithoutResourceIdError = exports.UnknownSiteWithoutResourceIdError = exports.encodeContext = exports.buildExtensionAri = exports.buildContextAri = exports.appIdToAriString = exports.BITBUCKET_RESOURCE_OWNER = exports.TRELLO_RESOURCE_OWNER = exports.INSTALLATION_RESOURCE_TYPE = exports.WORKSPACE_RESOURCE_TYPE = exports.SITE_RESOURCE_TYPE = void 0;
 const ari_1 = require("@forge/util/packages/ari");
 const shared_1 = require("../shared");
 const ui_1 = require("../ui");
 exports.SITE_RESOURCE_TYPE = 'site';
 exports.WORKSPACE_RESOURCE_TYPE = 'workspace';
+exports.INSTALLATION_RESOURCE_TYPE = 'installation';
 exports.TRELLO_RESOURCE_OWNER = 'trello';
 exports.BITBUCKET_RESOURCE_OWNER = 'bitbucket';
 function appIdToAriString(appId) {
@@ -45,6 +46,12 @@ class UnknownWorkspaceWithoutResourceIdError extends Error {
     }
 }
 exports.UnknownWorkspaceWithoutResourceIdError = UnknownWorkspaceWithoutResourceIdError;
+class UnknownInstallationWithoutResourceIdError extends Error {
+    constructor() {
+        super(ui_1.Text.installList.noResourceIdInInstallation);
+    }
+}
+exports.UnknownInstallationWithoutResourceIdError = UnknownInstallationWithoutResourceIdError;
 function parseInstallationContext(installationContext) {
     const context = ari_1.AnyAri.parse(installationContext);
     switch (context.resourceType) {
@@ -58,6 +65,11 @@ function parseInstallationContext(installationContext) {
                 throw new UnknownWorkspaceWithoutResourceIdError();
             }
             break;
+        case exports.INSTALLATION_RESOURCE_TYPE:
+            if (!context.resourceId) {
+                throw new UnknownInstallationWithoutResourceIdError();
+            }
+            break;
         default:
             throw new Error('Unknown resource type');
     }

package/out/config/config-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-file.d.ts","sourceRoot":"","sources":["../../src/config/config-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,IAAI,CAAC;AAGlE,OAAO,EACL,OAAO,EACP,cAAc,EACd,SAAS,EAMV,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAQ,MAAM,WAAW,CAAC;AAE7D,qBAAa,oBAAqB,SAAQ,eAAe;;CAIxD;AAED,qBAAa,8BAA+B,SAAQ,SAAS;gBAC/C,SAAS,EAAE,MAAM,EAAE;CAGhC;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3C;AAED,oBAAY,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AACpC,oBAAY,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AACjE,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C,YAAY,EAAE,cAAc,CAAC;CAC9B;AAgBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CA6D5D;AAED,qBAAa,UAAW,YAAW,YAAY,EAAE,YAAY,EAAE,gBAAgB;IAG3E,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAE7B,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,gBAAgB;IAKlC,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAiBzC,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAYrC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKvD,OAAO,CAAC,kBAAkB;IAoBb,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajE,OAAO,CAAC,aAAa;IAIR,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1G,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,6BAA6B;IAkBrC,OAAO,CAAC,gBAAgB;IAIX,oBAAoB,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IAqClF,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAe1E,YAAY,CAAC,aAAa,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAsB1E,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKzD,OAAO,CAAC,eAAe;CA0BxB"}
+{"version":3,"file":"config-file.d.ts","sourceRoot":"","sources":["../../src/config/config-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,IAAI,CAAC;AAGlE,OAAO,EACL,OAAO,EACP,cAAc,EACd,SAAS,EAOV,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAQ,MAAM,WAAW,CAAC;AAE7D,qBAAa,oBAAqB,SAAQ,eAAe;;CAIxD;AAED,qBAAa,8BAA+B,SAAQ,SAAS;gBAC/C,SAAS,EAAE,MAAM,EAAE;CAGhC;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3C;AAED,oBAAY,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AACpC,oBAAY,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AACjE,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C,YAAY,EAAE,cAAc,CAAC;CAC9B;AAgBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CA6D5D;AAED,qBAAa,UAAW,YAAW,YAAY,EAAE,YAAY,EAAE,gBAAgB;IAG3E,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAE7B,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,gBAAgB;IAKlC,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAiBzC,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAYrC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKvD,OAAO,CAAC,kBAAkB;IAoBb,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajE,OAAO,CAAC,aAAa;IAIR,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1G,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,wBAAwB;IAkBhC,OAAO,CAAC,6BAA6B;IAkBrC,OAAO,CAAC,gBAAgB;IAIX,oBAAoB,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IAqClF,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAe1E,YAAY,CAAC,aAAa,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAsB1E,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKzD,OAAO,CAAC,eAAe;CAkCxB"}

package/out/config/config-file.js

@@ -182,7 +182,10 @@ class ConfigFile {
             return [module.resource, ...config_1.ModuleEntryPoints.map((entryPoint) => module[entryPoint]?.resource || '')];
         })
             .filter(Boolean);
-        const missingModuleResourcesKeys = modulesResourcesKeys.filter((key) => !resources.some((resource) => resource.key === key));
+        const missingModuleResourcesKeys = modulesResourcesKeys.filter((resourceReference) => {
+            const { resourceKey } = (0, manifest_1.parseResourceReference)(resourceReference);
+            return !resources.some((resource) => resource.key === resourceKey);
+        });
         if (missingModuleResourcesKeys.length > 0) {
             throw new ResourceDefinitionMissingError(missingModuleResourcesKeys);
         }
@@ -267,7 +270,12 @@ class ConfigFile {
         return app.connect?.key;
     }
     getResourceType({ key: resourceKey }, allModules) {
-        const linkedModule = allModules.find((m) => m.resource === resourceKey) ??
+        const linkedModule = allModules.find((m) => {
+            if (!m.resource)
+                return false;
+            const { resourceKey: moduleResourceKey } = (0, manifest_1.parseResourceReference)(m.resource);
+            return moduleResourceKey === resourceKey;
+        }) ??
             allModules
                 .reduce((acc, m) => {
                 config_1.ModuleEntryPoints.forEach((entryPoint) => {
@@ -278,7 +286,12 @@ class ConfigFile {
                 });
                 return acc;
             }, [])
-                .find(({ resource }) => resource === resourceKey);
+                .find(({ resource }) => {
+                if (!resource)
+                    return false;
+                const { resourceKey: moduleResourceKey } = (0, manifest_1.parseResourceReference)(resource);
+                return moduleResourceKey === resourceKey;
+            });
         if (!linkedModule) {
             return 'default';
         }