@adobe/aio-cli-plugin-app 12.2.4 → 13.1.0

package/README.md

@@ -72,7 +72,7 @@ DESCRIPTION
   Create, run, test, and deploy Adobe I/O Apps
 ```
 
-_See code: [src/commands/app/index.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/index.js)_
+_See code: [src/commands/app/index.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/index.js)_
 
 ## `aio app add`
 
@@ -90,7 +90,7 @@ DESCRIPTION
   Add a new component to an existing Adobe I/O App
 ```
 
-_See code: [src/commands/app/add/index.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/add/index.js)_
+_See code: [src/commands/app/add/index.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/add/index.js)_
 
 ## `aio app add action`
 
@@ -115,7 +115,7 @@ ALIASES
   $ aio app add actions
 ```
 
-_See code: [src/commands/app/add/action.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/add/action.js)_
+_See code: [src/commands/app/add/action.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/add/action.js)_
 
 ## `aio app add ci`
 
@@ -133,7 +133,7 @@ DESCRIPTION
   Add CI files
 ```
 
-_See code: [src/commands/app/add/ci.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/add/ci.js)_
+_See code: [src/commands/app/add/ci.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/add/ci.js)_
 
 ## `aio app add event`
 
@@ -158,7 +158,7 @@ ALIASES
   $ aio app add events
 ```
 
-_See code: [src/commands/app/add/event.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/add/event.js)_
+_See code: [src/commands/app/add/event.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/add/event.js)_
 
 ## `aio app add extension`
 
@@ -184,7 +184,7 @@ ALIASES
   $ aio app add extensions
 ```
 
-_See code: [src/commands/app/add/extension.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/add/extension.js)_
+_See code: [src/commands/app/add/extension.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/add/extension.js)_
 
 ## `aio app add service`
 
@@ -208,7 +208,7 @@ ALIASES
   $ aio app add services
 ```
 
-_See code: [src/commands/app/add/service.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/add/service.js)_
+_See code: [src/commands/app/add/service.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/add/service.js)_
 
 ## `aio app add web-assets`
 
@@ -229,7 +229,7 @@ DESCRIPTION
   Add web assets support
 ```
 
-_See code: [src/commands/app/add/web-assets.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/add/web-assets.js)_
+_See code: [src/commands/app/add/web-assets.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/add/web-assets.js)_
 
 ## `aio app build`
 
@@ -247,7 +247,7 @@ FLAGS
   -v, --verbose               Verbose output
   --[no-]actions              [default: true] Build actions if any
   --[no-]content-hash         [default: true] Enable content hashing in browser code
-  --[no-]force-build          [default: true] Force a build even if one already exists
+  --[no-]force-build          [default: false] Force a build even if one already exists
   --version                   Show version
   --[no-]web-assets           [default: true] Build web-assets if any
   --web-optimize              [default: false] Enable optimization (minification) of js/css/html
@@ -255,10 +255,11 @@ FLAGS
 DESCRIPTION
   Build an Adobe I/O App
 
-  This will always force a rebuild unless --no-force-build is set.
+  Build the actions and web assets for an Adobe I/O App. Build is optimized to only build what is necessary.
+  Use the --force-build flag to force a build even if one already exists.
 ```
 
-_See code: [src/commands/app/build.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/build.js)_
+_See code: [src/commands/app/build.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/build.js)_
 
 ## `aio app create [PATH]`
 
@@ -280,7 +281,7 @@ DESCRIPTION
   Create a new Adobe I/O App with default parameters
 ```
 
-_See code: [src/commands/app/create.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/create.js)_
+_See code: [src/commands/app/create.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/create.js)_
 
 ## `aio app delete`
 
@@ -298,7 +299,7 @@ DESCRIPTION
   Delete a component from an existing Adobe I/O App
 ```
 
-_See code: [src/commands/app/delete/index.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/delete/index.js)_
+_See code: [src/commands/app/delete/index.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/delete/index.js)_
 
 ## `aio app delete action [ACTION-NAME]`
 
@@ -324,7 +325,7 @@ ALIASES
   $ aio app delete actions
 ```
 
-_See code: [src/commands/app/delete/action.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/delete/action.js)_
+_See code: [src/commands/app/delete/action.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/delete/action.js)_
 
 ## `aio app delete ci`
 
@@ -343,7 +344,7 @@ DESCRIPTION
   Delete existing CI files
 ```
 
-_See code: [src/commands/app/delete/ci.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/delete/ci.js)_
+_See code: [src/commands/app/delete/ci.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/delete/ci.js)_
 
 ## `aio app delete extension`
 
@@ -369,7 +370,7 @@ ALIASES
   $ aio app delete extensions
 ```
 
-_See code: [src/commands/app/delete/extension.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/delete/extension.js)_
+_See code: [src/commands/app/delete/extension.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/delete/extension.js)_
 
 ## `aio app delete service`
 
@@ -393,7 +394,7 @@ ALIASES
   $ aio app delete services
 ```
 
-_See code: [src/commands/app/delete/service.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/delete/service.js)_
+_See code: [src/commands/app/delete/service.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/delete/service.js)_
 
 ## `aio app delete web-assets`
 
@@ -412,11 +413,11 @@ DESCRIPTION
   Delete existing web assets
 ```
 
-_See code: [src/commands/app/delete/web-assets.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/delete/web-assets.js)_
+_See code: [src/commands/app/delete/web-assets.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/delete/web-assets.js)_
 
 ## `aio app deploy`
 
-Build and deploy an Adobe I/O App
+Deploy an Adobe I/O App
 
 ```
 USAGE
@@ -448,12 +449,17 @@ FLAGS
   --web-optimize                [default: false] Enable optimization (minification) of web js/css/html
 
 DESCRIPTION
-  Build and deploy an Adobe I/O App
+  Deploy an Adobe I/O App
 
-  This will always force a rebuild unless --no-force-build is set.
+  Deploys the actions and web assets for an Adobe I/O App.
+  This will also build any changed actions or web assets before deploying.
+  Use the --force-build flag to force a build even if one already exists.
+  Deploy is optimized to only deploy what is necessary. Be aware that deploying actions will overwrite any previous
+  deployments.
+  Use the --force-deploy flag to force deploy changes, regardless of production Workspace being published in Exchange.
 ```
 
-_See code: [src/commands/app/deploy.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/deploy.js)_
+_See code: [src/commands/app/deploy.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/deploy.js)_
 
 ## `aio app get-url [ACTION]`
 
@@ -476,7 +482,7 @@ DESCRIPTION
   Get action URLs
 ```
 
-_See code: [src/commands/app/get-url.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/get-url.js)_
+_See code: [src/commands/app/get-url.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/get-url.js)_
 
 ## `aio app info`
 
@@ -498,7 +504,7 @@ DESCRIPTION
   Display settings/configuration in use by an Adobe I/O App
 ```
 
-_See code: [src/commands/app/info.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/info.js)_
+_See code: [src/commands/app/info.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/info.js)_
 
 ## `aio app init [PATH]`
 
@@ -537,7 +543,7 @@ DESCRIPTION
   Create a new Adobe I/O App
 ```
 
-_See code: [src/commands/app/init.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/init.js)_
+_See code: [src/commands/app/init.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/init.js)_
 
 ## `aio app install PATH`
 
@@ -560,7 +566,7 @@ DESCRIPTION
   This command will support installing apps packaged by 'aio app pack'.
 ```
 
-_See code: [src/commands/app/install.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/install.js)_
+_See code: [src/commands/app/install.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/install.js)_
 
 ## `aio app list`
 
@@ -578,7 +584,7 @@ DESCRIPTION
   List components for Adobe I/O App
 ```
 
-_See code: [src/commands/app/list/index.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/list/index.js)_
+_See code: [src/commands/app/list/index.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/list/index.js)_
 
 ## `aio app list extension`
 
@@ -603,7 +609,7 @@ ALIASES
   $ aio app list extensions
 ```
 
-_See code: [src/commands/app/list/extension.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/list/extension.js)_
+_See code: [src/commands/app/list/extension.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/list/extension.js)_
 
 ## `aio app logs`
 
@@ -627,7 +633,7 @@ DESCRIPTION
   Fetch logs for an Adobe I/O App
 ```
 
-_See code: [src/commands/app/logs.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/logs.js)_
+_See code: [src/commands/app/logs.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/logs.js)_
 
 ## `aio app pack [PATH]`
 
@@ -649,7 +655,7 @@ DESCRIPTION
   This command will support packaging apps for redistribution.
 ```
 
-_See code: [src/commands/app/pack.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/pack.js)_
+_See code: [src/commands/app/pack.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/pack.js)_
 
 ## `aio app run`
 
@@ -673,7 +679,7 @@ DESCRIPTION
   Run an Adobe I/O App
 ```
 
-_See code: [src/commands/app/run.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/run.js)_
+_See code: [src/commands/app/run.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/run.js)_
 
 ## `aio app test`
 
@@ -701,7 +707,7 @@ DESCRIPTION
   If the extension has a hook called 'test' in its 'ext.config.yaml', the script specified will be run instead.
 ```
 
-_See code: [src/commands/app/test.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/test.js)_
+_See code: [src/commands/app/test.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/test.js)_
 
 ## `aio app undeploy`
 
@@ -726,7 +732,7 @@ DESCRIPTION
   Undeploys an Adobe I/O App
 ```
 
-_See code: [src/commands/app/undeploy.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/undeploy.js)_
+_See code: [src/commands/app/undeploy.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/undeploy.js)_
 
 ## `aio app use [CONFIG_FILE_PATH]`
 
@@ -773,5 +779,5 @@ DESCRIPTION
   page in https://developer.adobe.com/console/
 ```
 
-_See code: [src/commands/app/use.js](https://github.com/adobe/aio-cli-plugin-app/blob/12.2.4/src/commands/app/use.js)_
+_See code: [src/commands/app/use.js](https://github.com/adobe/aio-cli-plugin-app/blob/13.1.0/src/commands/app/use.js)_
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -1,9 +1,9 @@
 {
-  "version": "12.2.4",
+  "version": "13.1.0",
   "commands": {
     "app:build": {
       "id": "app:build",
-      "description": "Build an Adobe I/O App\n\nThis will always force a rebuild unless --no-force-build is set.\n",
+      "description": "Build an Adobe I/O App\n\nBuild the actions and web assets for an Adobe I/O App. Build is optimized to only build what is necessary.\nUse the --force-build flag to force a build even if one already exists.\n",
       "strict": true,
       "pluginName": "@adobe/aio-cli-plugin-app",
       "pluginAlias": "@adobe/aio-cli-plugin-app",
@@ -52,7 +52,7 @@
         "force-build": {
           "name": "force-build",
           "type": "boolean",
-          "description": "[default: true] Force a build even if one already exists",
+          "description": "[default: false] Force a build even if one already exists",
           "allowNo": true
         },
         "content-hash": {
@@ -121,7 +121,7 @@
     },
     "app:deploy": {
       "id": "app:deploy",
-      "description": "Build and deploy an Adobe I/O App\n\nThis will always force a rebuild unless --no-force-build is set.\n",
+      "description": "Deploy an Adobe I/O App\n\nDeploys the actions and web assets for an Adobe I/O App.\nThis will also build any changed actions or web assets before deploying.\nUse the --force-build flag to force a build even if one already exists.\nDeploy is optimized to only deploy what is necessary. Be aware that deploying actions will overwrite any previous deployments.\nUse the --force-deploy flag to force deploy changes, regardless of production Workspace being published in Exchange.\n",
       "strict": true,
       "pluginName": "@adobe/aio-cli-plugin-app",
       "pluginAlias": "@adobe/aio-cli-plugin-app",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adobe/aio-cli-plugin-app",
   "description": "Create, Build and Deploy Adobe I/O Applications",
-  "version": "12.2.4",
+  "version": "13.1.0",
   "author": "Adobe Inc.",
   "bugs": "https://github.com/adobe/aio-cli-plugin-app/issues",
   "dependencies": {
@@ -12,7 +12,7 @@
     "@adobe/aio-lib-core-networking": "^5",
     "@adobe/aio-lib-env": "^3",
     "@adobe/aio-lib-ims": "^7",
-    "@adobe/aio-lib-runtime": "^6",
+    "@adobe/aio-lib-runtime": "^7.0.0",
     "@adobe/aio-lib-templates": "^3",
     "@adobe/aio-lib-web": "^7",
     "@adobe/generator-aio-app": "^7",

package/src/BaseCommand.js

@@ -42,6 +42,13 @@ class BaseCommand extends Command {
     await super.init()
     // setup a prompt that outputs to stderr
     this.prompt = inquirer.createPromptModule({ output: process.stderr })
+
+    // set User-Agent for runtime calls
+    // ex. aio-cli-plugin-app/@adobe/aio-cli/10.3.1 (darwin-arm64; node-v18.20.4; zsh)
+    const vs = this.config.versionDetails
+    // some tests might not have this set, so we use ? nullish coalescing
+    process.env.__OW_USER_AGENT =
+      `aio-cli-plugin-app/${vs?.cliVersion} (${vs?.architecture}; ${vs?.nodeVersion}; ${vs?.shell})`
   }
 
   async getLibConsoleCLI () {

package/src/commands/app/build.js

@@ -70,14 +70,16 @@ class Build extends BaseCommand {
     }
 
     if (flags.actions) {
-      if (config.app.hasBackend && (flags['force-build'] || !fs.existsSync(config.actions.dist))) {
+      // removed flags['force-build'] || as it is always forced at this point, we need to check to decide what to build
+      // if no backend, we skip the build
+      if (config.app.hasBackend) {
         try {
           let builtList = []
           const script = await runInProcess(config.hooks['build-actions'], config)
           aioLogger.debug(`run hook for 'build-actions' for actions in '${name}' returned ${script}`)
           spinner.start(`Building actions for '${name}'`)
           if (!script) {
-            builtList = await RuntimeLib.buildActions(config, filterActions, true)
+            builtList = await RuntimeLib.buildActions(config, filterActions, flags['force-build']) // skipCheck is false
           }
           if (builtList.length > 0) {
             spinner.succeed(chalk.green(`Built ${builtList.length} action(s) for '${name}'`))
@@ -85,7 +87,7 @@ class Build extends BaseCommand {
             if (script) {
               spinner.fail(chalk.green(`build-action skipped by hook '${name}'`))
             } else {
-              spinner.fail(chalk.green(`No actions built for '${name}'`))
+              spinner.info(chalk.green(`No actions built for '${name}'`))
             }
           }
           aioLogger.debug(`RuntimeLib.buildActions returned ${builtList}`)
@@ -94,7 +96,7 @@ class Build extends BaseCommand {
           throw err
         }
       } else {
-        spinner.info(`no backend or a build already exists, skipping action build for '${name}'`)
+        spinner.info(`no backend, skipping action build for '${name}'`)
       }
     }
     if (flags['web-assets']) {
@@ -127,7 +129,8 @@ class Build extends BaseCommand {
           throw err
         }
       } else {
-        spinner.info(`no frontend or a build already exists, skipping frontend build for '${name}'`)
+        // TODO: specify which ... keep this useful
+        spinner.info(chalk.green(`No frontend or a build already exists, skipping frontend build for '${name}'`))
       }
     }
     try {
@@ -140,7 +143,8 @@ class Build extends BaseCommand {
 
 Build.description = `Build an Adobe I/O App
 
-This will always force a rebuild unless --no-force-build is set.
+Build the actions and web assets for an Adobe I/O App. Build is optimized to only build what is necessary.
+Use the --force-build flag to force a build even if one already exists.
 `
 
 Build.flags = {
@@ -163,8 +167,8 @@ Build.flags = {
     allowNo: true
   }),
   'force-build': Flags.boolean({
-    description: '[default: true] Force a build even if one already exists',
-    default: true,
+    description: '[default: false] Force a build even if one already exists',
+    default: false,
     allowNo: true
   }),
   'content-hash': Flags.boolean({

package/src/commands/app/deploy.js

@@ -18,9 +18,10 @@ const BaseCommand = require('../../BaseCommand')
 const BuildCommand = require('./build')
 const webLib = require('@adobe/aio-lib-web')
 const { Flags } = require('@oclif/core')
-const { createWebExportFilter, runInProcess, buildExtensionPointPayloadWoMetadata, buildExcShellViewExtensionMetadata } = require('../../lib/app-helper')
+const { createWebExportFilter, runInProcess, buildExtensionPointPayloadWoMetadata, buildExcShellViewExtensionMetadata, getCliInfo } = require('../../lib/app-helper')
 const rtLib = require('@adobe/aio-lib-runtime')
 const LogForwarding = require('../../lib/log-forwarding')
+const { sendAuditLogs, getAuditLogEvent, getFilesCountWithExtension } = require('../../lib/audit-logger')
 
 const PRE_DEPLOY_EVENT_REG = 'pre-deploy-event-reg'
 const POST_DEPLOY_EVENT_REG = 'post-deploy-event-reg'
@@ -32,6 +33,7 @@ class Deploy extends BuildCommand {
 
     // flags
     flags['web-assets'] = flags['web-assets'] && !flags.action
+    // Deploy only a specific action, the flags can be specified multiple times, this will set --no-publish
     flags.publish = flags.publish && !flags.action
 
     const deployConfigs = await this.getAppExtConfigs(flags)
@@ -51,12 +53,11 @@ class Deploy extends BuildCommand {
 
     try {
       const aioConfig = (await this.getFullConfig()).aio
+      const cliDetails = await getCliInfo()
 
       // 1. update log forwarding configuration
       // note: it is possible that .aio file does not exist, which means there is no local lg config
-      if (aioConfig?.project?.workspace &&
-          flags['log-forwarding-update'] &&
-          flags.actions) {
+      if (aioConfig?.project?.workspace && flags['log-forwarding-update'] && flags.actions) {
         spinner.start('Updating log forwarding configuration')
         try {
           const lf = await LogForwarding.init(aioConfig)
@@ -80,7 +81,8 @@ class Deploy extends BuildCommand {
       }
 
       // 2. If workspace is prod and has extensions, check if the app is published
-      if (!isStandaloneApp && aioConfig?.project?.workspace?.name === 'Production') {
+      // if --no-publish, we skip this check
+      if (flags.publish && aioConfig?.project?.workspace?.name === 'Production') {
         const extension = await this.getApplicationExtension(aioConfig)
         if (extension && extension.status === 'PUBLISHED') {
           flags.publish = false // if the app is production and published, then skip publish later on
@@ -92,7 +94,15 @@ class Deploy extends BuildCommand {
         }
       }
 
-      // 3. deploy actions and web assets for each extension
+      // 3. send deploy log event
+      const logEvent = getAuditLogEvent(flags, aioConfig.project, 'AB_APP_DEPLOY')
+      if (logEvent) {
+        await sendAuditLogs(cliDetails.accessToken, logEvent, cliDetails.env)
+      } else {
+        this.log(chalk.red(chalk.bold('Warning: No valid config data found to send audit log event for deployment.')))
+      }
+
+      // 4. deploy actions and web assets for each extension
       // Possible improvements:
       // - parallelize
       // - break into smaller pieces deploy, allowing to first deploy all actions then all web assets
@@ -100,6 +110,14 @@ class Deploy extends BuildCommand {
         const k = keys[i]
         const v = values[i]
         await this.deploySingleConfig(k, v, flags, spinner)
+        if (v.app.hasFrontend && flags['web-assets']) {
+          const opItems = getFilesCountWithExtension(v.web.distProd)
+          const assetDeployedLogEvent = getAuditLogEvent(flags, aioConfig.project, 'AB_APP_ASSETS_DEPLOYED')
+          if (assetDeployedLogEvent) {
+            assetDeployedLogEvent.data.opItems = opItems
+            await sendAuditLogs(cliDetails.accessToken, assetDeployedLogEvent, cliDetails.env)
+          }
+        }
       }
 
       // 4. deploy extension manifest
@@ -172,7 +190,7 @@ class Deploy extends BuildCommand {
               // output should be "Error : <plugin-name> : <error-message>\n" for each failure
               this.error(hookResults.failures.map(f => `${f.plugin.name} : ${f.error.message}`).join('\nError: '), { exit: 1 })
             }
-            deployedRuntimeEntities = await rtLib.deployActions(config, { filterEntities }, onProgress)
+            deployedRuntimeEntities = await rtLib.deployActions(config, { filterEntities, useForce: flags['force-deploy'] }, onProgress)
           }
 
           if (deployedRuntimeEntities.actions && deployedRuntimeEntities.actions.length > 0) {
@@ -181,7 +199,7 @@ class Deploy extends BuildCommand {
             if (script) {
               spinner.fail(chalk.green(`deploy-actions skipped by hook '${name}'`))
             } else {
-              spinner.fail(chalk.green(`No actions deployed for '${name}'`))
+              spinner.info(chalk.green(`No actions deployed for '${name}'`))
             }
           }
         } catch (err) {
@@ -204,6 +222,11 @@ class Deploy extends BuildCommand {
           } else {
             deployedFrontendUrl = await webLib.deployWeb(config, onProgress)
             spinner.succeed(chalk.green(message))
+            const filesLogCount = getFilesCountWithExtension(config.web.distProd)
+            const filesDeployedMessage = `All static assets for the App Builder application in workspace: ${name} were successfully deployed to the CDN. Files deployed :`
+            const filesLogFormatted = filesLogCount?.map(file => `  • ${file}`).join('')
+            const finalMessage = chalk.green(`${filesDeployedMessage}\n${filesLogFormatted}`)
+            spinner.succeed(chalk.green(finalMessage))
           }
         } catch (err) {
           spinner.fail(chalk.green(message))
@@ -287,9 +310,13 @@ class Deploy extends BuildCommand {
   }
 }
 
-Deploy.description = `Build and deploy an Adobe I/O App
+Deploy.description = `Deploy an Adobe I/O App
 
-This will always force a rebuild unless --no-force-build is set.
+Deploys the actions and web assets for an Adobe I/O App.
+This will also build any changed actions or web assets before deploying.
+Use the --force-build flag to force a build even if one already exists.
+Deploy is optimized to only deploy what is necessary. Be aware that deploying actions will overwrite any previous deployments.
+Use the --force-deploy flag to force deploy changes, regardless of production Workspace being published in Exchange.
 `
 
 Deploy.flags = {
@@ -319,7 +346,7 @@ Deploy.flags = {
   'force-build': Flags.boolean({
     description: '[default: true] Force a build even if one already exists',
     exclusive: ['no-build'], // no-build
-    default: true,
+    default: false,
     allowNo: true
   }),
   'content-hash': Flags.boolean({

package/src/commands/app/run.js

@@ -108,6 +108,9 @@ class Run extends BaseCommand {
     }
 
     const verboseOutput = flags.verbose || flags.local || headlessApp
+    // we should evaluate this, a lot of output just disappears in the spinner text and
+    // using verbose dumps ALL of parcel's output, so this become unreadable
+    // we need a middle ground. -jm
     const onProgress = !verboseOutput
       ? info => {
         spinner.text = info

package/src/commands/app/undeploy.js

@@ -17,8 +17,9 @@ const { Flags } = require('@oclif/core')
 
 const BaseCommand = require('../../BaseCommand')
 const webLib = require('@adobe/aio-lib-web')
-const { runInProcess, buildExtensionPointPayloadWoMetadata } = require('../../lib/app-helper')
+const { runInProcess, buildExtensionPointPayloadWoMetadata, getCliInfo } = require('../../lib/app-helper')
 const rtLib = require('@adobe/aio-lib-runtime')
+const { sendAuditLogs, getAuditLogEvent } = require('../../lib/audit-logger')
 
 class Undeploy extends BaseCommand {
   async run () {
@@ -44,14 +45,29 @@ class Undeploy extends BaseCommand {
 
     const spinner = ora()
     try {
+      const aioConfig = (await this.getFullConfig()).aio
+      const cliDetails = await getCliInfo()
+      const logEvent = getAuditLogEvent(flags, aioConfig.project, 'AB_APP_UNDEPLOY')
+
+      // 1.1. send audit log event for successful undeploy
+      if (logEvent) {
+        await sendAuditLogs(cliDetails.accessToken, logEvent, cliDetails.env)
+      } else {
+        this.log(chalk.red(chalk.bold('Warning: No valid config data found to send audit log event for deployment.')))
+      }
+
       for (let i = 0; i < keys.length; ++i) {
         const k = keys[i]
         const v = values[i]
         await this.undeployOneExt(k, v, flags, spinner)
+        const assetUndeployLogEvent = getAuditLogEvent(flags, aioConfig.project, 'AB_APP_ASSETS_UNDEPLOYED')
+        if (assetUndeployLogEvent) {
+          await sendAuditLogs(cliDetails.accessToken, assetUndeployLogEvent, cliDetails.env)
+        }
       }
-      // 2. unpublish extension manifest
+
+      // 1.2. unpublish extension manifest
       if (flags.unpublish && !(keys.length === 1 && keys[0] === 'application')) {
-        const aioConfig = (await this.getFullConfig()).aio
         const payload = await this.unpublishExtensionPoints(libConsoleCLI, undeployConfigs, aioConfig, flags['force-unpublish'])
         this.log(chalk.blue(chalk.bold(`New Extension Point(s) in Workspace '${aioConfig.project.workspace.name}': '${Object.keys(payload.endpoints)}'`)))
       } else {
@@ -110,6 +126,7 @@ class Undeploy extends BaseCommand {
           if (!script) {
             await webLib.undeployWeb(config, onProgress)
           }
+
           spinner.succeed(chalk.green(`Un-Deploying web assets for ${extName}`))
         } catch (err) {
           spinner.fail(chalk.green(`Un-Deploying web assets for ${extName}`))

package/src/lib/actions-watcher.js

@@ -38,7 +38,7 @@ const deployActions = require('./deploy-actions')
 module.exports = async (watcherOptions) => {
   const { config, log } = watcherOptions
 
-  log(`watching action files at ${config.actions.src}...`)
+  log(`watching action files at ${config.actions.src} ...`)
   const watcher = chokidar.watch(config.actions.src)
 
   watcher.on('change', createChangeHandler({ ...watcherOptions, watcher }))
@@ -91,6 +91,8 @@ function createChangeHandler (watcherOptions) {
     try {
       aioLogger.debug(`${filePath} has changed. Redeploying actions.`)
       const filterActions = getActionNameFromPath(filePath, watcherOptions)
+      // this is happening, but its not showing up because verbose is usually off
+      // this might be more important and worthy of signalling to the user
       if (!filterActions.length) {
         log('  -> A non-action file was changed, restart is required to deploy...')
       } else {
@@ -119,6 +121,13 @@ function createChangeHandler (watcherOptions) {
  * @returns {Array<string>}  All of the actions which match the modified path
  */
 function getActionNameFromPath (filePath, watcherOptions) {
+  // note: this check only happens during aio app run
+  // before the watcher is started, all actions are built and deployed and hashes updated
+  // this code is missing 2 cases:
+  // 1. if the action is a folder with a package.json and the changed file is in the folder
+  // 2. if the changed file is in the folder with the action, but not the action file itself
+  // we need to be careful with these cases, because we could cause a recursive loop
+  // for now we continue to error on the cautious side, and output a message suggesting a restart
   const actionNames = []
   const unixFilePath = upath.toUnix(filePath)
   const { config } = watcherOptions
@@ -126,7 +135,10 @@ function getActionNameFromPath (filePath, watcherOptions) {
     if (pkg.actions) {
       Object.entries(pkg.actions).forEach(([actionName, action]) => {
         const unixActionFunction = upath.toUnix(action.function)
-        if (unixActionFunction.includes(unixFilePath)) {
+        // since action could be a folder, and changed file could be in the folder
+        // we need to compare both ways
+        // there are 2 additional cases listed above
+        if (unixActionFunction.includes(unixFilePath) || unixFilePath.includes(unixActionFunction)) {
           actionNames.push(actionName)
         }
       })

package/src/lib/audit-logger.js

@@ -0,0 +1,156 @@
+/*
+Copyright 2024 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+const fetch = require('node-fetch')
+const fs = require('fs')
+const path = require('path')
+const chalk = require('chalk')
+const { getCliEnv, PROD_ENV } = require('@adobe/aio-lib-env')
+const aioLogger = require('@adobe/aio-lib-core-logging')('@adobe/aio-cli-plugin-app:lib-audit-logger', { provider: 'debug' })
+
+const OPERATIONS = {
+  AB_APP_DEPLOY: 'ab_app_deploy',
+  AB_APP_UNDEPLOY: 'ab_app_undeploy',
+  AB_APP_TEST: 'ab_app_test', // todo : remove after testing
+  AB_APP_ASSETS_DEPLOYED: 'ab_app_assets_deployed',
+  AB_APP_ASSETS_UNDEPLOYED: 'ab_app_assets_undeployed'
+}
+
+const AUDIT_SERVICE_ENPOINTS = {
+  stage: 'https://adp-auditlog-service-stage.adobeioruntime.net/api/v1/web/audit-log-api/event-post',
+  prod: 'https://adp-auditlog-service-prod.adobeioruntime.net/api/v1/web/audit-log-api/event-post'
+}
+
+/**
+ * Send audit log events to audit service
+ * @param {string} accessToken valid access token
+ * @param {object} logEvent logEvent details
+ * @param {string} env valid env stage|prod
+ */
+async function sendAuditLogs (accessToken, logEvent, env = 'prod') {
+  // TODO: this is blocked by the audit service only being available in stage
+  // remove this check once the service is available in prod
+  if (env !== 'stage') {
+    return
+  }
+  const url = AUDIT_SERVICE_ENPOINTS[env]
+  const payload = {
+    event: logEvent
+  }
+  const options = {
+    method: 'POST',
+    headers: {
+      Authorization: 'Bearer ' + accessToken,
+      'Content-type': 'application/json'
+    },
+    body: JSON.stringify(payload)
+  }
+  const response = await fetch(url, options)
+  if (response.status !== 200) {
+    const err = await response.text()
+    throw new Error('Failed to send audit log - ' + response.status + ' ' + err)
+  }
+}
+
+/**
+ *
+ * @param {object} flags cli flags
+ * @param {object} project details
+ * @param {string} event log name
+ * @returns {object} logEvent
+ */
+function getAuditLogEvent (flags, project, event) {
+  if (getCliEnv() === PROD_ENV) {
+    aioLogger.debug('Audit logging is currently disabled in production environment')
+    return null
+  }
+
+  let logEvent, logStrMsg
+  if (project && project.org && project.workspace) {
+    if (event === 'AB_APP_DEPLOY') {
+      logStrMsg = `Starting deployment for the App Builder application in workspace ${project.workspace.name}`
+    } else if (event === 'AB_APP_UNDEPLOY') {
+      logStrMsg = `Starting undeployment for the App Builder application in workspace ${project.workspace.name}`
+    } else if (event === 'AB_APP_ASSETS_UNDEPLOYED') {
+      logStrMsg = `All static assets for the App Builder application in workspace: ${project.workspace.name} were successfully undeployed from the CDN`
+    } else if (event === 'AB_APP_ASSETS_DEPLOYED') {
+      logStrMsg = `All static assets for the App Builder application in workspace: ${project.workspace.name} were successfully deployed to the CDN.\n Files deployed - `
+    }
+
+    logEvent = {
+      orgId: project.org.id,
+      projectId: project.id,
+      workspaceId: project.workspace.id,
+      workspaceName: project.workspace.name,
+      operation: event in OPERATIONS ? OPERATIONS[event] : OPERATIONS.AB_APP_TEST,
+      timestamp: new Date().valueOf(),
+      data: {
+        cliCommandFlags: flags,
+        opDetailsStr: logStrMsg
+      }
+    }
+  }
+  return logEvent
+}
+
+/**
+ *
+ * @param {string} directory | path to assets directory
+ * @returns {Array} log | array of log messages
+ */
+function getFilesCountWithExtension (directory) {
+  const log = []
+
+  if (!fs.existsSync(directory)) {
+    this.log(chalk.red(chalk.bold(`Error: Directory ${directory} does not exist.`)))
+    return log
+  }
+
+  const files = fs.readdirSync(directory)
+
+  if (files.length === 0) {
+    this.log(chalk.red(chalk.bold(`Error: No files found in directory ${directory}.`)))
+    return log
+  }
+
+  const fileTypeCounts = {}
+
+  files.forEach(file => {
+    const ext = path.extname(file).toLowerCase() || 'no extension'
+    if (fileTypeCounts[ext]) {
+      fileTypeCounts[ext]++
+    } else {
+      fileTypeCounts[ext] = 1
+    }
+  })
+
+  Object.keys(fileTypeCounts).forEach(ext => {
+    const count = fileTypeCounts[ext]
+    let description
+
+    if (ext === '.js') description = 'Javascript file(s)'
+    else if (ext === '.css') description = 'CSS file(s)'
+    else if (ext === '.html') description = 'HTML page(s)'
+    else if (['.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp'].includes(ext)) description = 'image(s)'
+    else if (ext === 'no extension') description = 'file(s) without extension'
+    else description = `${ext} file(s)`
+
+    log.push(`${count} ${description}\n`)
+  })
+
+  return log
+}
+
+module.exports = {
+  sendAuditLogs,
+  getAuditLogEvent,
+  AUDIT_SERVICE_ENPOINTS,
+  getFilesCountWithExtension
+}

package/src/lib/run-dev.js

@@ -82,8 +82,7 @@ async function runDev (config, dataDir, options = {}, log = () => {}, inprocHook
 
       // build and deploy actions
       log('building actions..')
-      await buildActions(devConfig, null, true /* force build */)
-
+      await buildActions(devConfig, null, false /* force build */)
       const { cleanup: watcherCleanup } = await actionsWatcher({ config: devConfig, isLocal, log, inprocHook })
       cleanup.add(() => watcherCleanup(), 'stopping action watcher...')
     }
@@ -152,10 +151,16 @@ async function runDev (config, dataDir, options = {}, log = () => {}, inprocHook
       devConfig.app.hasFrontend = false
     }
 
-    log('setting up vscode debug configuration files...')
-    const vscodeConfig = vscode(devConfig)
-    await vscodeConfig.update({ frontEndUrl })
-    cleanup.add(() => vscodeConfig.cleanup(), 'cleaning up vscode debug configuration files...')
+    // todo: remove vscode config swapping, dev command uses a persistent file so we don't need this.
+    // also there was a latent issue with projects that defined an action src as a folder with an index.js file.
+    // it looks explicitly for package.json and fails if it does not find it.
+    // regarless, we don't need it, and when we actually remove --local we can be rid of this.
+    if (isLocal) {
+      log('setting up vscode debug configuration files...')
+      const vscodeConfig = vscode(devConfig)
+      await vscodeConfig.update({ frontEndUrl })
+      cleanup.add(() => vscodeConfig.cleanup(), 'cleaning up vscode debug configuration files...')
+    }
 
     // automatically fetch logs if there are actions
     if (config.app.hasBackend && fetchLogs) {