@salesforce/afv-skills 1.28.0 → 1.30.0

package/skills/external-diagram-visual-generate/scripts/check-prerequisites.sh

@@ -1,101 +0,0 @@
-#!/bin/bash
-# check-prerequisites.sh - Verify external-diagram-visual-generate requirements before use
-# Returns 0 if all required checks pass, 1 if any required fail
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-GRAY='\033[0;90m'
-NC='\033[0m'
-
-ERRORS=0
-WARNINGS=0
-
-echo ""
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo -e "${BLUE}  📸 SF-IMAGEN PREREQUISITES CHECK${NC}"
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo ""
-echo -e "${GRAY}  REQUIRED:${NC}"
-
-# Check 1: macOS (required for Preview app)
-echo -n "  Checking macOS (for Preview app)... "
-if [[ "$OSTYPE" == "darwin"* ]]; then
-    echo -e "${GREEN}✓ macOS detected${NC}"
-else
-    echo -e "${RED}✗ Not macOS${NC}"
-    echo -e "    ${YELLOW}→ external-diagram-visual-generate uses macOS Preview app for image display${NC}"
-    echo -e "    ${YELLOW}→ Current OS: $OSTYPE${NC}"
-    ERRORS=$((ERRORS + 1))
-fi
-
-# Check 2: Gemini API Key
-echo -n "  Checking GEMINI_API_KEY... "
-if [[ -n "$GEMINI_API_KEY" ]]; then
-    # Mask the key for display
-    MASKED_KEY="${GEMINI_API_KEY:0:10}...${GEMINI_API_KEY: -4}"
-    echo -e "${GREEN}✓ Set ($MASKED_KEY)${NC}"
-else
-    echo -e "${RED}✗ Not set${NC}"
-    echo -e "    ${YELLOW}→ Nano Banana Pro requires a personal API key${NC}"
-    echo -e "    ${YELLOW}→ Get one at: https://aistudio.google.com/apikey${NC}"
-    echo -e "    ${YELLOW}→ Add to ~/.zshrc: export GEMINI_API_KEY=\"your-key\"${NC}"
-    ERRORS=$((ERRORS + 1))
-fi
-
-# Check 3: Gemini CLI
-echo -n "  Checking Gemini CLI... "
-if command -v gemini &> /dev/null; then
-    GEMINI_VERSION=$(gemini --version 2>/dev/null | head -1 || echo "installed")
-    echo -e "${GREEN}✓ $GEMINI_VERSION${NC}"
-else
-    echo -e "${RED}✗ Not installed${NC}"
-    echo -e "    ${YELLOW}→ Install: npm install -g @google/gemini-cli${NC}"
-    ERRORS=$((ERRORS + 1))
-fi
-
-# Check 4: Nano Banana Extension
-echo -n "  Checking Nano Banana extension... "
-if gemini extensions list 2>/dev/null | grep -q "nanobanana"; then
-    echo -e "${GREEN}✓ Installed${NC}"
-else
-    echo -e "${RED}✗ Not installed${NC}"
-    echo -e "    ${YELLOW}→ Install: gemini extensions install nanobanana${NC}"
-    ERRORS=$((ERRORS + 1))
-fi
-
-echo ""
-echo -e "${GRAY}  OPTIONAL (for 4K/editing via Python script):${NC}"
-
-# Check 5: uv (optional, for Python script)
-echo -n "  Checking uv (Python runner)... "
-if command -v uv &> /dev/null; then
-    UV_VERSION=$(uv --version 2>&1 | head -1)
-    echo -e "${GREEN}✓ $UV_VERSION${NC}"
-else
-    echo -e "${YELLOW}○ Not installed (optional)${NC}"
-    echo -e "    ${GRAY}→ For 4K resolution/editing: curl -LsSf https://astral.sh/uv/install.sh | sh${NC}"
-    WARNINGS=$((WARNINGS + 1))
-fi
-
-echo ""
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-
-if [[ $ERRORS -eq 0 ]]; then
-    if [[ $WARNINGS -gt 0 ]]; then
-        echo -e "  ${GREEN}✅ All required prerequisites met!${NC}"
-        echo -e "  ${YELLOW}⚠️  $WARNINGS optional feature(s) unavailable${NC}"
-    else
-        echo -e "  ${GREEN}✅ All prerequisites met! external-diagram-visual-generate is ready to use.${NC}"
-    fi
-    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-    echo ""
-    exit 0
-else
-    echo -e "  ${RED}❌ $ERRORS required prerequisite(s) missing.${NC}"
-    echo -e "  ${RED}   Please fix before using external-diagram-visual-generate.${NC}"
-    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-    echo ""
-    exit 1
-fi

package/skills/external-diagram-visual-generate/scripts/generate_image.py

@@ -1,243 +0,0 @@
-#!/usr/bin/env python3
-# /// script
-# requires-python = ">=3.10"
-# dependencies = ["google-genai>=1.0.0", "pillow>=10.0.0"]
-# ///
-"""
-Direct Gemini API image generation with resolution control.
-
-This script complements the CLI extension for power features:
-- Resolution control: 1K (draft), 2K (medium), 4K (production)
-- Image editing: Modify existing images with natural language
-- Timestamp filenames: Automatic versioning for iteration tracking
-
-Usage:
-  # Generate new image at 1K (draft)
-  uv run scripts/generate_image.py -p "Salesforce ERD diagram..." -f "account-erd.png"
-
-  # Generate at 4K (production)
-  uv run scripts/generate_image.py -p "Salesforce ERD diagram..." -f "account-erd.png" -r 4K
-
-  # Edit existing image
-  uv run scripts/generate_image.py -p "Add a legend in bottom right" -i input.png -f "output.png"
-
-Workflow: Draft → Iterate → Final
-  1. Generate at 1K for quick feedback (~3s)
-  2. Refine prompt until layout/content is correct
-  3. Generate final at 4K for production quality (~10s)
-
-License: MIT
-"""
-
-import argparse
-import os
-import subprocess
-import sys
-from datetime import datetime
-from io import BytesIO
-from pathlib import Path
-
-try:
-    from google import genai
-    from google.genai import types
-    from PIL import Image
-except ImportError as e:
-    print(f"Error: Missing dependency - {e}")
-    print("Run with: uv run scripts/generate_image.py ...")
-    sys.exit(1)
-
-
-# Resolution mapping (uppercase K required by API!)
-RESOLUTIONS = {
-    "1K": "1K",   # ~1024px - drafts, fast iteration
-    "2K": "2K",   # ~2048px - medium quality
-    "4K": "4K",   # ~4096px - production quality
-}
-
-# Default output directory (matches CLI extension)
-OUTPUT_DIR = Path.home() / "nanobanana-output"
-
-
-def get_auto_resolution(image_path: str) -> str:
-    """Auto-detect resolution based on input image dimensions."""
-    try:
-        with Image.open(image_path) as img:
-            max_dim = max(img.width, img.height)
-            if max_dim < 1500:
-                return "1K"
-            elif max_dim < 3000:
-                return "2K"
-            else:
-                return "4K"
-    except Exception:
-        return "1K"
-
-
-def generate_image(
-    prompt: str,
-    filename: str,
-    resolution: str = "1K",
-    input_image: str | None = None,
-    api_key: str | None = None,
-    aspect_ratio: str | None = None,
-) -> str:
-    """Generate or edit an image using Gemini 3 Pro Image API.
-
-    Args:
-        prompt: Text description for generation or editing instruction
-        filename: Output filename (timestamp will be prepended)
-        resolution: Output resolution - 1K, 2K, or 4K (uppercase required!)
-        input_image: Path to existing image for editing (optional)
-        api_key: Gemini API key (falls back to GEMINI_API_KEY env var)
-        aspect_ratio: Aspect ratio like "16:9", "1:1", "4:3" (optional)
-
-    Returns:
-        Path to saved image file
-    """
-    # Get API key
-    api_key = api_key or os.environ.get("GEMINI_API_KEY")
-    if not api_key:
-        raise ValueError(
-            "GEMINI_API_KEY not found. Set it in ~/.zshrc or pass via --api-key"
-        )
-
-    # Initialize client
-    client = genai.Client(api_key=api_key)
-
-    # Build contents (image first if editing, then prompt)
-    contents = []
-    if input_image:
-        img = Image.open(input_image)
-        # Convert RGBA to RGB if needed
-        if img.mode == "RGBA":
-            background = Image.new("RGB", img.size, (255, 255, 255))
-            background.paste(img, mask=img.split()[3])
-            img = background
-        contents.append(img)
-
-        # Auto-detect resolution for editing if not specified
-        if resolution == "1K":
-            resolution = get_auto_resolution(input_image)
-            print(f"Auto-detected resolution: {resolution}")
-
-    contents.append(prompt)
-
-    # Build image config
-    image_config_kwargs = {"image_size": RESOLUTIONS[resolution]}
-    if aspect_ratio:
-        image_config_kwargs["aspect_ratio"] = aspect_ratio
-
-    # Generate with resolution config
-    print(f"Generating at {resolution} resolution...")
-    response = client.models.generate_content(
-        model="gemini-3-pro-image-preview",
-        contents=contents,
-        config=types.GenerateContentConfig(
-            response_modalities=["IMAGE", "TEXT"],
-            image_config=types.ImageConfig(**image_config_kwargs),
-        ),
-    )
-
-    # Save output with timestamp filename
-    OUTPUT_DIR.mkdir(exist_ok=True)
-    timestamp = datetime.now().strftime("%Y-%m-%d-%H-%M-%S")
-
-    # Clean filename (remove extension if present, we'll add .png)
-    clean_name = Path(filename).stem
-    output_filename = f"{timestamp}-{clean_name}.png"
-    output_path = OUTPUT_DIR / output_filename
-
-    # Extract and save image from response
-    for part in response.candidates[0].content.parts:
-        if hasattr(part, "inline_data") and part.inline_data:
-            img = Image.open(BytesIO(part.inline_data.data))
-            # Convert to RGB if needed
-            if img.mode == "RGBA":
-                background = Image.new("RGB", img.size, (255, 255, 255))
-                background.paste(img, mask=img.split()[3])
-                img = background
-            img.save(output_path, "PNG")
-            return str(output_path)
-
-    raise RuntimeError("No image data in response")
-
-
-def main():
-    parser = argparse.ArgumentParser(
-        description="Generate images with Gemini 3 Pro Image API",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Examples:
-  # Draft (fast, cheap)
-  uv run generate_image.py -p "Account ERD diagram" -f "account-erd.png"
-
-  # Production (4K)
-  uv run generate_image.py -p "Account ERD diagram" -f "account-erd.png" -r 4K
-
-  # Edit existing image
-  uv run generate_image.py -p "Add legend" -i prev.png -f "updated.png"
-
-  # With aspect ratio
-  uv run generate_image.py -p "Dashboard mockup" -f "dash.png" -a "16:9"
-        """,
-    )
-    parser.add_argument(
-        "-p", "--prompt",
-        required=True,
-        help="Image description or editing instruction",
-    )
-    parser.add_argument(
-        "-f", "--filename",
-        required=True,
-        help="Output filename (timestamp auto-prepended)",
-    )
-    parser.add_argument(
-        "-r", "--resolution",
-        choices=["1K", "2K", "4K"],
-        default="1K",
-        help="Output resolution (default: 1K for drafts)",
-    )
-    parser.add_argument(
-        "-i", "--input-image",
-        help="Path to existing image for editing",
-    )
-    parser.add_argument(
-        "-k", "--api-key",
-        help="Gemini API key (defaults to GEMINI_API_KEY env var)",
-    )
-    parser.add_argument(
-        "-a", "--aspect-ratio",
-        help="Aspect ratio (e.g., '16:9', '1:1', '4:3')",
-    )
-    parser.add_argument(
-        "--no-open",
-        action="store_true",
-        help="Don't auto-open the image in Preview after generation",
-    )
-
-    args = parser.parse_args()
-
-    try:
-        output_path = generate_image(
-            prompt=args.prompt,
-            filename=args.filename,
-            resolution=args.resolution,
-            input_image=args.input_image,
-            api_key=args.api_key,
-            aspect_ratio=args.aspect_ratio,
-        )
-        print(f"✅ Saved: {output_path}")
-
-        # Auto-open in macOS Preview unless --no-open is specified
-        if not args.no_open:
-            subprocess.run(["open", output_path], check=False)
-            print(f"   📸 Opened in Preview")
-        else:
-            print(f"   Open with: open {output_path}")
-    except Exception as e:
-        print(f"❌ Error: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

package/skills/integration-connectivity-connected-app-configure/CREDITS.md

@@ -1,3 +0,0 @@
-# Credits & Acknowledgments
-
-This skill is built on established Salesforce OAuth and identity platform patterns, incorporating security best practices and architectural guidance from the Salesforce platform ecosystem.

package/skills/integration-connectivity-generate/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill is built on Salesforce integration platform patterns, incorporating security best practices and architectural guidance from the Salesforce platform ecosystem.
-
----

package/skills/omnistudio-callable-apex-generate/CREDITS.md

@@ -1,9 +0,0 @@
-# Credits
-
-This skill draws on established Salesforce Industries patterns for callable Apex implementations,
-including the `System.Callable` interface, `VlocityOpenInterface`, and `VlocityOpenInterface2`
-extension points used in OmniStudio and Industries integrations.
-
-The guidance, migration patterns, and bundled examples reflect best practices for secure,
-deterministic callable implementations across Industries extension points such as OmniScripts,
-Integration Procedures, and DataRaptors.

package/skills/omnistudio-datamapper-generate/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill reflects the collective knowledge and conventions of the Salesforce OmniStudio ecosystem.
-
----

package/skills/omnistudio-datapacks-deploy/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill is based on practical OmniStudio/Vlocity DataPack deployment workflows and the Vlocity Build command model.
-
----

package/skills/omnistudio-dependencies-analyze/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill draws on established patterns and platform knowledge from the broader OmniStudio ecosystem.
-
----

package/skills/omnistudio-epc-catalog-generate/CREDITS.md

@@ -1,14 +0,0 @@
-# Credits & Acknowledgments
-
-This skill was created from practical Salesforce Industries CME EPC implementation patterns and DataPack examples in this repository.
-
-## Repository Example Sources
-
-The example packs in this skill are curated, reusable sample payloads for documentation and template authoring.
-
-- `assets/` (canonical EPC bundle template set)
-- `assets/examples/samsung-galaxy-s22-bundle/` (bundle offer example)
-- `assets/examples/business-internet-premium-fttc-simple-offer/` (simple offer example)
-- `assets/examples/business-internet-pro-vpl-simple-offer/` (simple offer example)
-- `assets/examples/static-ip-simple-offer/` (simple offer example)
-- `examples/business-internet-plus-bundle/` (generated example with transcript)

package/skills/omnistudio-flexcard-generate/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits
-
-Official Salesforce OmniStudio tooling for FlexCard metadata authoring and validation. Primary inspiration for the skill's data source binding patterns and definition structure.
-
----

package/skills/omnistudio-integration-procedure-generate/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill was built upon the collective wisdom of the Salesforce OmniStudio community. We gratefully acknowledge the following resources whose ideas, patterns, and best practices have shaped this skill.
-
----

package/skills/omnistudio-omniscript-generate/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill reflects patterns and conventions established within the Salesforce OmniStudio platform and its practitioner community.
-
----

package/skills/platform-apex-generate/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill is built on established Salesforce Apex development patterns and the collective knowledge of the Salesforce developer community.
-
----

package/skills/platform-apex-logs-debug/CREDITS.md

@@ -1,22 +0,0 @@
-# Credits & Acknowledgments
-
-This skill is built on Salesforce's official Apex debugging documentation and established Apex performance patterns. The benchmarking techniques, governor limit patterns, and optimization approaches incorporated here reflect current Apex development best practices.
-
----
-
-## Key Patterns
-
-### Governor Limit Awareness
-Governor limit values, debug log event types, and the Apex execution model are defined by the Salesforce platform and reflected in `references/debug-log-reference.md`.
-
-### Debug Log Specifications
-Log event specifications, log level definitions, and format documentation are based on official Apex debug log behavior and integrated into `references/debug-log-reference.md`.
-
-### Benchmarking Patterns
-String-building performance characteristics, loop iteration comparisons, and data structure lookup benchmarks reflect well-established Apex optimization techniques adapted into the reusable templates in this skill.
-
----
-
-## License
-
-MIT licensed. See the LICENSE file for complete terms.

package/skills/platform-apex-test-generate/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill is built on established Salesforce Apex development patterns and the collective knowledge of the Salesforce developer community.
-
----

package/skills/platform-apex-test-run/CREDITS.md

@@ -1,22 +0,0 @@
-# Credits & Acknowledgments
-
-This skill integrates concepts and patterns from Salesforce documentation and the broader Salesforce developer community. The goal is to move beyond minimum coverage targets toward true unit testing with proper isolation, mocking, and disciplined test-fix workflows.
-
----
-
-## Key Patterns Integrated
-
-| Pattern | Integration |
-|---------|-------------|
-| DML Mocking | `assets/dml-mock.cls` |
-| Mocking vs Stubbing | `references/mocking-patterns.md` |
-| Test Data Factory | `assets/test-data-factory.cls` |
-| HttpCalloutMock | `assets/mock-callout-test.cls` |
-| StubProvider | `assets/stub-provider-example.cls` |
-| Performant Tests | `references/performance-optimization.md` |
-
----
-
-## Philosophy
-
-This skill teaches Apex developers how to write fast, reliable, maintainable tests using vanilla Apex patterns — no external packages or libraries required. All patterns work in any Salesforce org out of the box.

package/skills/platform-data-manage/CREDITS.md

@@ -1,5 +0,0 @@
-# Credits & Acknowledgments
-
-This skill is built on established Salesforce data, SOQL, and bulk operation patterns from the Salesforce platform ecosystem.
-
----

package/skills/platform-metadata-deploy/CREDITS.md

@@ -1,25 +0,0 @@
-# Credits & Acknowledgments
-
-This skill is built on established Salesforce DevOps practices, official platform tooling, and the collective knowledge embedded in Salesforce's documentation and developer ecosystem.
-
----
-
-## Key Concepts
-
-### Two-Phase Deployment Pattern
-The `--dry-run` validation before actual deployment is a community-established best practice to prevent production failures, widely promoted across official Salesforce documentation.
-
-### Quick Deploy Strategy
-The workflow of validating with tests, then using quick deploy for actual deployment, originates from Salesforce release management best practices.
-
-### Test Level Recommendations
-The guidance on appropriate test levels (RunLocalTests vs RunAllTests vs RunSpecifiedTests) comes from official Salesforce deployment documentation.
-
-### Incremental Deployment Strategy
-The recommendation for small, frequent deployments over large batches is a DevOps industry best practice adapted for Salesforce.
-
----
-
-## Special Thanks
-
-To the entire Salesforce DevOps community — release managers, architects, developers, and CI/CD engineers — for continuously improving deployment practices and making Salesforce deployments more reliable.

package/skills/platform-soql-query/CREDITS.md

@@ -1,21 +0,0 @@
-# Credits & Acknowledgments
-
-This skill integrates concepts and patterns from the Salesforce developer community and official Salesforce documentation. The goal is to teach Apex developers how to write efficient, maintainable SOQL using vanilla Apex patterns that don't require external package installation.
-
----
-
-## Key Patterns Integrated
-
-| Pattern | Integration |
-|---------|-------------|
-| Selector Layer architecture | `references/selector-patterns.md` |
-| Bulkification and Map-based lookup | `assets/bulkified-query-pattern.cls` |
-| SOQL anti-patterns catalog | `references/anti-patterns.md` |
-| Query Plan analysis | `SKILL.md`, `assets/optimization-patterns.soql` |
-| Field coverage validation | `references/field-coverage-rules.md` |
-
----
-
-## Philosophy
-
-This skill integrates **concepts and patterns** from community resources, not specific libraries as dependencies. All patterns produce vanilla Apex code that works in any Salesforce org without additional package installation.