feat(Makefile): add makefile targets for idp-cli publish, deploy, and delete-stack

Author: rstrahan

Makefile

@@ -21,6 +21,10 @@ else
   PIP := $(CURDIR)/$(VENV_DIR)/bin/pip
 endif
 
+# idp-cli invocation — uses `python -m idp_cli.cli` so it works whether or not
+# the virtualenv is activated (picks up $(PYTHON) which prefers .venv).
+IDP_CLI := $(PYTHON) -m idp_cli.cli
+
 ##@ General
 .PHONY: help
 help: ## Show this help message
@@ -393,3 +397,74 @@ dsr-scan: ## Run DSR security scan
 dsr-fix: ## Run DSR interactive fix
 	@echo "Running DSR interactive fix..."
 	$(PYTHON) scripts/dsr/fix.py
+
+##@ Deploy
+# Thin wrappers around `idp-cli publish` / `deploy` / `delete` for the common
+# 80% case. Uncommon flags can still be passed via EXTRA_ARGS="--foo --bar".
+# See 'docs/idp-cli.md' (or 'idp-cli <cmd> --help') for the full option list.
+
+.PHONY: publish deploy delete-stack
+
+# Usage examples:
+#   make publish REGION=us-east-1
+#   make publish REGION=us-east-1 BUCKET_BASENAME=my-idp-artifacts PREFIX=v1
+#   make publish REGION=us-gov-west-1 HEADLESS=1
+#   make publish REGION=us-east-1 PUBLIC=1 EXTRA_ARGS="--clean-build --verbose"
+publish: ## Build & publish IDP artifacts to S3 (Usage: make publish REGION=... [BUCKET_BASENAME=...] [PREFIX=...] [HEADLESS=1] [PUBLIC=1] [EXTRA_ARGS=...])
+ifndef REGION
+	$(error REGION is not set. Usage: make publish REGION=us-east-1 [BUCKET_BASENAME=...] [PREFIX=...] [HEADLESS=1] [PUBLIC=1] [EXTRA_ARGS=...])
+endif
+	@echo -e "$(CYAN)Running idp-cli publish (region=$(REGION))...$(NC)"
+	$(IDP_CLI) publish \
+		--source-dir . \
+		--region $(REGION) \
+		$(if $(BUCKET_BASENAME),--bucket-basename $(BUCKET_BASENAME)) \
+		$(if $(PREFIX),--prefix $(PREFIX)) \
+		$(if $(HEADLESS),--headless) \
+		$(if $(PUBLIC),--public) \
+		$(EXTRA_ARGS)
+
+# Usage examples:
+#   make deploy STACK_NAME=my-idp ADMIN_EMAIL=me@example.com                 # create new stack
+#   make deploy STACK_NAME=my-idp                                             # update existing stack
+#   make deploy STACK_NAME=my-idp-dev ADMIN_EMAIL=me@example.com FROM_CODE=1  # build & deploy from local source
+#   make deploy STACK_NAME=my-idp ADMIN_EMAIL=me@example.com HEADLESS=1       # headless (no UI)
+#   make deploy STACK_NAME=my-idp CUSTOM_CONFIG=./my-config.yaml              # update config on existing stack
+#   make deploy STACK_NAME=my-idp NO_WAIT=1                                   # fire-and-forget (default is --wait)
+#   make deploy STACK_NAME=my-idp EXTRA_ARGS="--max-concurrent 200 --log-level DEBUG"
+deploy: ## Deploy/update IDP CloudFormation stack (Usage: make deploy STACK_NAME=... [ADMIN_EMAIL=...] [REGION=...] [FROM_CODE=1] [HEADLESS=1] [CUSTOM_CONFIG=...] [TEMPLATE_URL=...] [TEMPLATE_FILE=...] [NO_WAIT=1] [EXTRA_ARGS=...])
+ifndef STACK_NAME
+	$(error STACK_NAME is not set. Usage: make deploy STACK_NAME=my-stack [ADMIN_EMAIL=...] [REGION=...] [FROM_CODE=1] [HEADLESS=1] [CUSTOM_CONFIG=...] [NO_WAIT=1] [EXTRA_ARGS=...])
+endif
+	@echo -e "$(CYAN)Running idp-cli deploy (stack=$(STACK_NAME))...$(NC)"
+	$(IDP_CLI) deploy \
+		--stack-name $(STACK_NAME) \
+		$(if $(ADMIN_EMAIL),--admin-email $(ADMIN_EMAIL)) \
+		$(if $(REGION),--region $(REGION)) \
+		$(if $(FROM_CODE),--from-code .) \
+		$(if $(HEADLESS),--headless) \
+		$(if $(CUSTOM_CONFIG),--custom-config $(CUSTOM_CONFIG)) \
+		$(if $(TEMPLATE_URL),--template-url $(TEMPLATE_URL)) \
+		$(if $(TEMPLATE_FILE),--template-file $(TEMPLATE_FILE)) \
+		$(if $(NO_WAIT),,--wait) \
+		$(EXTRA_ARGS)
+
+# Usage examples:
+#   make delete-stack STACK_NAME=test-stack                                   # interactive
+#   make delete-stack STACK_NAME=test-stack FORCE=1                            # skip confirmation
+#   make delete-stack STACK_NAME=test-stack FORCE=1 EMPTY_BUCKETS=1            # empty buckets first
+#   make delete-stack STACK_NAME=test-stack FORCE=1 FORCE_DELETE_ALL=1         # comprehensive cleanup
+delete-stack: ## Delete an IDP CloudFormation stack (Usage: make delete-stack STACK_NAME=... [FORCE=1] [EMPTY_BUCKETS=1] [FORCE_DELETE_ALL=1] [REGION=...] [NO_WAIT=1] [EXTRA_ARGS=...])
+ifndef STACK_NAME
+	$(error STACK_NAME is not set. Usage: make delete-stack STACK_NAME=my-stack [FORCE=1] [EMPTY_BUCKETS=1] [FORCE_DELETE_ALL=1])
+endif
+	@echo -e "$(YELLOW)Running idp-cli delete (stack=$(STACK_NAME))...$(NC)"
+	$(IDP_CLI) delete \
+		--stack-name $(STACK_NAME) \
+		$(if $(FORCE),--force) \
+		$(if $(EMPTY_BUCKETS),--empty-buckets) \
+		$(if $(FORCE_DELETE_ALL),--force-delete-all) \
+		$(if $(REGION),--region $(REGION)) \
+		$(if $(NO_WAIT),,--wait) \
+		$(EXTRA_ARGS)
+

VERSION

@@ -1 +1 @@
-0.5.8.rc2
+0.5.8.rc3

docs/idp-cli.md

@@ -91,6 +91,56 @@ cd lib/idp_cli_pkg
 pip install -e ".[test]"
 ```
 
+## Makefile Shortcuts
+
+The root `Makefile` provides convenience wrappers for the most common `idp-cli` commands. These use the project's `.venv` Python automatically — no need to `source .venv/bin/activate` first.
+
+```bash
+# Publish artifacts to S3
+make publish REGION=us-east-1
+make publish REGION=us-east-1 BUCKET_BASENAME=my-artifacts PREFIX=v1
+make publish REGION=us-gov-west-1 HEADLESS=1
+
+# Deploy / update a stack (--wait is the default)
+make deploy STACK_NAME=my-idp ADMIN_EMAIL=me@example.com
+make deploy STACK_NAME=my-idp-dev ADMIN_EMAIL=me@example.com FROM_CODE=1
+make deploy STACK_NAME=my-idp CUSTOM_CONFIG=./my-config.yaml
+
+# Delete a stack
+make delete-stack STACK_NAME=test-stack FORCE=1 FORCE_DELETE_ALL=1
+```
+
+**First-class Make variables** (common flags):
+
+| Variable | Target(s) | Maps to CLI flag |
+|---|---|---|
+| `REGION` | publish, deploy, delete-stack | `--region` |
+| `STACK_NAME` | deploy, delete-stack | `--stack-name` |
+| `ADMIN_EMAIL` | deploy | `--admin-email` |
+| `FROM_CODE=1` | deploy | `--from-code .` |
+| `HEADLESS=1` | publish, deploy | `--headless` |
+| `PUBLIC=1` | publish | `--public` |
+| `BUCKET_BASENAME` | publish | `--bucket-basename` |
+| `PREFIX` | publish | `--prefix` |
+| `CUSTOM_CONFIG` | deploy | `--custom-config` |
+| `TEMPLATE_URL` | deploy | `--template-url` |
+| `TEMPLATE_FILE` | deploy | `--template-file` |
+| `NO_WAIT=1` | deploy, delete-stack | omits `--wait` |
+| `FORCE=1` | delete-stack | `--force` |
+| `EMPTY_BUCKETS=1` | delete-stack | `--empty-buckets` |
+| `FORCE_DELETE_ALL=1` | delete-stack | `--force-delete-all` |
+
+**Uncommon flags** — pass anything else via `EXTRA_ARGS`:
+
+```bash
+make deploy STACK_NAME=my-idp EXTRA_ARGS="--role-arn arn:aws:iam::123:role/Foo --no-rollback"
+make publish REGION=us-east-1 EXTRA_ARGS="--clean-build --verbose"
+```
+
+Run `make help` to see all available targets, or `idp-cli <command> --help` for the full option reference.
+
+---
+
 ## Quick Start
 
 ### Global Options

lib/idp_cli_pkg/idp_cli/cli.py

@@ -237,7 +237,7 @@ def _display_deployment_failure(client, stack_name: str, result):
 
 
 @click.group()
-@click.version_option(version="0.5.7")
+@click.version_option(version="0.5.8.rc3")
 def cli():
     """
     IDP CLI - Batch document processing for IDP Accelerator

lib/idp_cli_pkg/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "idp-cli"
-version = "0.5.7"
+version = "0.5.8.rc3"
 description = "Command-line interface for IDP Accelerator batch document processing"
 authors = [{name = "AWS"}]
 license = {text = "MIT-0"}

lib/idp_common_pkg/pyproject.toml

@@ -21,7 +21,7 @@ exclude = [
 
 [project]
 name = "idp_common"
-version = "0.5.7"
+version = "0.5.8.rc3"
 description = "Common utilities for GenAI IDP Accelerator patterns"
 authors = [{ name = "AWS", email = "noreply@amazon.com" }]
 requires-python = ">=3.12,<3.14"

lib/idp_common_pkg/setup.py

@@ -117,7 +117,7 @@
 
 setup(
     name="idp_common",
-    version="0.5.7",
+    version="0.5.8.rc3",
     packages=find_packages(
         exclude=[
             "build",

lib/idp_mcp_connector_pkg/idp_mcp_connector/__init__.py

@@ -8,7 +8,7 @@
 IDP Accelerator's remote MCP Server on Amazon Bedrock AgentCore Gateway.
 """
 
-__version__ = "0.5.7"
+__version__ = "0.5.8.rc3"
 __all__ = ["CognitoAuth", "IDPMCPConnector", "run_connector"]
 
 from .auth import CognitoAuth

lib/idp_mcp_connector_pkg/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "idp_mcp_connector"
-version = "0.5.7"
+version = "0.5.8.rc3"
 description = "Local MCP connector that bridges IDE tools (Cline, Kiro) to the IDP Accelerator MCP Server on AWS Bedrock AgentCore Gateway"
 readme = "README.md"
 requires-python = ">=3.11"

lib/idp_sdk/idp_sdk/__init__.py

@@ -109,7 +109,7 @@
     TemplateTransformResult,
 )
 
-__version__ = "0.5.7"
+__version__ = "0.5.8.rc3"
 
 __all__ = [
     # Client